一、任务执行协议

这是可公开复用的工程工作协议，不是模型隐藏思维链。协议注入每个会话；无论选择哪个人设（包括「不使用人设」），都始终生效。

意图路由与长会话护栏

协议会先把当前请求归类为五种行为模式，而不是默认把所有消息当成执行命令：

• 问答：直接回答，不擅自改文件或调用写入工具
• 查找：先核对来源、已知和未知，不未经授权改变外部状态
• 讨论：比较方案、取舍和风险，不把探讨中的方案提前当成决定
• 诊断：先给现象、证据、根因和验证办法，不越权修复
• 执行：确认目标和完成标准，完成后验证真实效果并检查副作用

会话达到第 6 轮后，插件才启用短版长会话护栏和“当前目标锚点”：以当前消息和最新状态为准，把旧计划、旧时间、旧事实和助手过去的自述视为候选信息；每次动作都要检查是否生效、是否留下副作用。这样不会给短聊增加固定成本，也能缓解长对话中上下文变长后“越来越笨”的问题。

协议不要求输出隐藏的逐步思考过程；对外只输出与任务复杂度匹配的结论、计划、变更和验证结果。简单问题保持简洁，复杂问题增加必要依据和边界说明。人设只影响自然语言表达，不影响代码、工具调用、结构化输出或安全判断。

协议自适应与闭环

任务协议不是一段每轮机械重复的说明，而是会根据会话状态和模型能力动态调整：

• 会话内自愈 —— 当同一用户请求连续两轮出现明确的失败、报错、超时或权限错误信号时，临时追加“先定位根因、记录已排除假设、选择不同方案”的纠偏条款；下一轮成功后自动解除。为避免误判，普通的重复提问不会单独触发该机制。
• 即时对齐纠偏 —— 用户说“不是这个意思”“你理解错了”或重复提出相近请求时，本轮立即要求先复述目标、检查上一轮是否答非所问，不沿用旧假设，也不原样重复上一轮。
• 反思回环 —— 会话结束后的协议复盘会保存在本地。最近多个会话中某一项持续低分时，下一会话只注入一条针对性提醒；表现恢复后自动淡出。反思摘要不会把完整历史日志带入上下文。
• 模型感知 —— 普通闲聊使用短版协议；复杂任务按模型能力选择协议长度。已确认具备推理能力的模型保留变更保护、验证、失败归因和结果复核，减少重复的计划说明；无法确认模型类型时使用完整协议作为安全回退。

这三层共同形成“常规协议 → 检测问题 → 临时强化 → 成功解除 → 跨会话复盘”的闭环，在需要深度处理时增加约束，在简单问题上控制 Token 消耗。

文档能力感知（与文档工具插件协作）

DSH 本身不带 Office / PDF 读写能力：附件只接受图片，工具名册里没有任何文档工具。模型面对 .docx、.xlsx 这类二进制容器时，只能在“当文本读”“现场解压 zip”“手写解析脚本”之间瞎试——慢，而且几乎必然出错。

微光不重复造这套工具，而是做能力探测与约束：注入前查询宿主的工具注册表，按工具名的能力族前缀（word_* / excel_* / ppt_* / pdf_* 等）判断当前环境具备哪些文档能力，再据此分叉——有工具时要求走工具而不是自己解析、先读后写、交付前回读验证；没有工具时要求第一轮就如实说明边界、不要静默硬解二进制，并给出替代交付方式。用户明确说「就用脚本自己试」时仍然照做，但要先说明代价。

两条都只在文档任务轮注入：闲聊、代码、排查类请求零成本，只有请求里出现文件后缀、Word / Excel / PPT / PDF 等格式名，或“写一份报告”这类产物请求时才生效；中文里“查一下官方文档”这种泛称不会被误判成文档任务。判据取自冻结的意图文本，因此在一轮之内稳定，不会像工具结果那样在轮中作废前缀缓存。探测按能力族前缀而非插件名，因此不绑定任何第三方实现——dsh-office-tools、dsh-excel-chat、dsh-ppt 装了哪个都能识别，一个都不装就退化为边界声明模式。

优化清单

• 问答、查找、讨论、诊断、执行五类请求路由
• 诊断不越权修复，讨论不提前替用户拍板
• 用户纠正和重复提问的即时对齐纠偏
• 相同请求连续失败后的归因纠偏与换方案提醒
• 第 6 轮起的长会话护栏与当前目标锚点
• 执行任务的“已完成 / 已验证 / 未验证 / 副作用”交付清单
• 上一轮执行回复缺少验证证据时的后续复核提醒
• 任务阶段状态机：回答 / 查找 / 讨论 / 归因 / 执行 / 验证 / 交付
• 真实工具证据：区分工具成功、失败和结果未知，不把工具调用本身当作目标完成
• 证据时效：引用日志/历史/旧报错前核对时间戳与因果，不用旧错误填空
• 记忆生命周期：相对时间记忆标记为临时记忆，30 天后自动失效；旧记忆无感兼容
• 反思日志跨会话反馈、旧字段迁移和模型感知协议
• 上下文压缩感知：识别宿主压缩检查点，压缩后重锚状态并提醒“摘要不是完整历史”
• 文档能力感知：探测文档工具并按需注入——有工具要求先读后写与回读验证，没工具要求如实说明边界、不硬解二进制
• 系统提示词轮内稳定：意图冻结（只认真实用户消息）+ 会变的内容走 runtime-context 通道，一轮只产生一份系统提示词
• 角色卡算法自动升级且保留记忆、风格和认可语料

为什么不接管宿主的历史压缩

压缩服务由 DSH 的 agent preset 在自己的隔离域里挂载（isolate: { compaction: true }），profile 层的插件注册的同名服务不会被 /compact 或自动压缩使用——第三方插件在标准 preset 下无法替换压缩后端，这属于宿主的架构边界，不是接口开放与否的问题。

Lume 因此选择「观察 + 重锚」：压缩发生时记录规模，在随后一轮注入提示，提醒模型摘要只保留要点、依赖早期细节时先确认；压缩产生的摘要消息带固定来源标记，Lume 用它把摘要与真实用户消息区分开，避免摘要污染当前目标与协议路由。人设契约、长期记忆与协议本身注入在 system prompt 段，不参与对话历史压缩，因此不受影响。

二、人设系统：「人设即人」

微光的人设是具名的独立个体，而非一段静态的性格描述：

• 记忆以人设为主键，跨会话、跨项目持久 —— 在绘画项目中告诉晚晴「以后叫你阿晴」，她在任何项目、任何新会话中都保持这一身份。记忆存放于 DSH 官方 storageDomain（storages/lume_persona_identity.json），完全本地
• 性格随对话演进 —— 内置风格契约是基础盘；对话中提出的语气要求（「少用 emoji」「自称改为 XX」）会固化为该人设的「习得的风格约定」，跨会话生效，与基础盘冲突时以习得层为准
• 切换带接班播报与持续纠偏 —— 切换人设时，新任人设在回复开头明确接替；此后逐轮检测回复是否残留旧人设的口头禅与称呼（零 token 的词法检测），检出即重新注入升级版纠偏播报——长对话中切换同样可靠
• 双通道记忆写入 —— 主通道为模型主动调用工具（lume_remember / lume_update_style / lume_create_persona），随对话发生、零额外调用；安全网为被动提取，经三道门（关键词正则 → 相似去重 → 冷却）过滤后仅对触发轮调用模型，绝大多数轮次零消耗
• 对话创建 —— 对当前人设说明「想建一个新的人设」，模型将通过访谈收集设定（名字、性格、说话方式、称呼）后保存，新的人设立即出现在菜单中

切换时机提醒：在新开的会话里切换人设，新任人设即刻生效；但在已经聊了一阵的会话里，仅仅点一下菜单切换往往不够——大模型有思维惯性，会沿旧人设的口吻继续说话，不会立刻「换皮」。此时要在对话里明确告诉大模型「切换到 XX 人设」（如：「现在用福尔摩斯的口吻回复」），让它在下一轮真正进入新角色。插件自带的接班播报与持续纠偏能加速这个过程，但无法替代你的一句明确指令。

菜单固定在输入栏左侧：「不使用人设」置顶，可随时回到默认风格；内置角色卡随后；底部为蒸馏与管理入口。列表异步加载完成后自动重新钳制视口，输入栏置底时菜单保持完整可见、可滚动。

内置卡与自定义卡在同一菜单中平铺：内置的噜噜（元气管家娘，口头禅「好哒哥哥～」）、晚晴（低频高载的姐姐，口头禅「……交给我」）、沈砚（儒雅管家，口头禅「这就去办，主人」）、江野（嘴硬心软的傲娇，口头禅「……切」「才不是特意帮你」）受保护不可删除；自定义的 Jade、坂田银时、福尔摩斯 等由蒸馏或对话创建，可随时编辑、删除。

三、蒸馏工具：从素材到角色卡

菜单中的「＋ Distill a character card…」提供批量生产角色卡的路径：粘贴（或导入 .txt/.md）一段小说、剧本或人物设定文档，由宿主侧管线将其蒸馏为一张与内置卡同构的角色卡。

管线分三步：

1. 对话挖掘（零 token）：抽取台词、统计说话人、保留双边情境窗口、时间间隔和可观测风格统计；归属不足时标记 mixed，由 LLM 甄别目标角色
2. 证据约束的契约合成：每条稳定特征都要求原话/情境证据、触发场景和频率，避免把单一场景脑补成固定人格
3. 语料合成：聊天记录优先使用全时段真实对话对；小说、剧本和设定文档也按“场景→行为→原声”组织示例，优先复用原句，禁止中和为通用回复

蒸馏算法与角色卡自动升级

角色卡保存蒸馏算法版本、目标角色和本地原始素材升级源。插件升级后会在后台检查旧版本角色：有升级源时自动重新蒸馏，只替换基础契约和基础语料；记忆、习得风格、用户改名和对话中沉淀的认可语料保留不动。升级失败时继续使用旧卡，不阻塞对话。

原始素材只保存在本地身份域，不注入普通对话上下文，也不会上传。旧版本且没有原始素材的卡片只能做兼容迁移，无法恢复旧算法已经丢弃的证据。

从聊天记录蒸馏一个人

粘贴微信 / QQ 导出或复制的聊天记录，蒸馏工具会自动识别时间戳锚点切分说话人（剔除 [语音] / [图片] / [表情] 等占位符），并在弹窗中列出检测到的说话人供点选——点选要蒸馏的人，对方的每一句话成为语气样本，你发出的每一句话归为用户侧，真实对话对直接作为语料，无需 LLM 改写，原汁原味保留本人的说话方式。对话量建议 50 条以上，蒸馏出的角色才足够立体。

• 预览中所有字段可编辑，保存后立即出现在人设菜单
• 素材经 RPC 以任务制交由宿主后台蒸馏（约 10~90 秒），不进入对话上下文，不影响当前会话；蒸馏过程中弹窗不可误关，关闭需二次确认并会中止任务
• 素材上限 20,000 字；素材按不可信文本处理，其中出现的任何指令不会被执行
• 蒸馏路由可通过 distillProvider / distillModel 指定专用模型档，默认跟随主对话模型

非聊天素材的统一蒸馏原则

小说、剧本和人物设定不再简单当作性格简介：按角色、场景、连续对白建立“谁在什么情境下说了什么”的证据链；分别观察平淡、冲突、亲密、拒绝等场景。设定文档只作为低置信度身份与边界线索，没有原话支持的内容不会伪装成口吻特征。所有素材最终统一为原声证据、情境行为、表达风格、身份边界和置信度。

四、管理自定义人设

「管理自定义人设…」列出全部条目：内置卡的编辑与删除按钮置灰（受保护），自定义卡支持：

• 导入人设卡 —— 从 JSON 卡片文件导入一张完整人设（含契约、语料、风格约定与记忆），同名覆盖需二次确认
• 导出 —— 任一人设（含内置）可导出为自包含 JSON 卡片文件，可选是否附带记忆，跨设备可还原
• 删除 —— 行内二次确认；删除同时清除该人设的记忆、习得风格与身份档案，不可恢复
• 记忆 —— 打开该人设的记忆星图（见下节）
• 编辑 —— 显示名、简介与风格契约全文可修改（英文键名为存储主键，创建后不可变更；语料只读展示，语气随对话继续演进）

自定义人设与内置人设能力完全一致：对话改名、记忆积累、风格演进全部支持，区别仅在于自定义人设可以删除。

五、记忆星图

管理弹窗中每个人设行内都有「记忆」按钮，点击后以力导向星空图的形式可视化该角色的全部长期记忆。

• Canvas 力导向布局 —— 记忆卡片（260×72）在 960px 宽幅遮罩层中自动排布，核心记忆紫色带 ★、普通记忆青色，语义相关者连线，背景缓慢漂移
• 日期筛选 —— 顶部支持 全部 / 最近 7 天 / 30 天 / 90 天 过滤
• 行内编辑与删除 —— 点击卡片展开详情面板，可即时修改记忆文本或删除整条记忆，经 updateMemory / deleteMemory 持久化写入存储

六、反思日志

会话结束时，插件在空闲时间跑一次小模型调用，对整段对话的任务执行协议执行情况进行复盘：上下文管理、计划与门控、验证与失败处理、结果复核，各打 0-2 分并附一句中文备注，写入 lume_reflection 域。

升级到 0.4.0 时，旧版反思日志会在域打开后自动从旧字段迁移到新字段；迁移幂等，不影响角色卡、记忆或会话。

• 零用户感知 —— 不进入对话上下文，不消耗正常请求的 token 配额
• 定性分析 —— 积攒数周后读取存储文件即可复盘对话质量，无需猜测
• 可关闭 —— 配置项 reflectionEnabled 默认 true，置为 false 即停用

七、人设卡片导出/导入

在管理弹窗中，任意人设（内置或自定义）均可导出为独立的 JSON 卡片文件，并在其他设备或他人环境中导入还原。

• 导出格式 —— 自包含 JSON（lume-persona-card v1），含契约、语料、风格约定、声音签名，可选含记忆
• 导入校验 —— 解析时校验格式、版本、键名合法性，内置人设名受保护，不可覆盖
• 跨设备迁移 —— 一张卡片即可还原人设的完整身份（记忆、风格、档案名），无需额外配置

Token 预算与优化算法

• 成熟态稳态约 1,570 tok/请求，较无优化降低 39%；缓存友好分层（静态内容前置于易变内容）叠加前缀缓存后，有效成本可再降约一个数量级
• 相比 v0.2.0（约 1,400 tok），v0.3.0 全部新功能的稳态净增仅约 170 tok/请求

配置项

存储

• 会话选择：storages/lume_persona_state.json（LRU 淘汰，200 会话上限）
• 身份、记忆、风格与自定义人设：storages/lume_persona_identity.json（记忆上限 30 条、风格上限 20 条、语料上限 12 条）
• 自定义蒸馏卡额外保存 distillVersion、distillHint 与本地 distillSource，供插件升级时后台重蒸馏；升级只替换基础契约/语料，不覆盖身份域中的记忆、风格和认可语料
• v0.1.0 旧版 persona-state.json 会在首次启动时自动导入并改名为 .migrated
• 全部数据保存在本地，不上传任何远端

安装与更新

前置条件：已安装 DSH Desktop。

从 npm 安装（推荐）

微光已发布到公共 npm 仓库（lume-dsh-plugin），无需访问 GitHub 即可安装：

dsh plugin add lume-dsh-plugin

从 GitHub 安装（备选）

若网络无法访问 npm，也可直接从仓库安装：

dsh plugin add github:cayan0x/Lume#v0.6.1

安装后需**完全重启 DSH（包含托盘进程）**方可加载；启动日志中出现 lume: 已加载（builtins=loli,senpai,butler,tsundere,none） 即表示加载成功。构建产物随仓库发布，两种路径都不需要本地构建。

从旧版本升级（已装过微光的电脑）

重新执行一次安装命令即可升到指定版本，随后完全重启 DSH（含托盘）：

dsh plugin add lume-dsh-plugin   # npm（推荐）
# 或
dsh plugin add github:cayan0x/Lume#v0.6.1   # GitHub（备选）

人设选择、记忆与风格数据存放在 storages/ 目录，升级不会丢失。

若当初是以本地源码目录方式安装的（dsh plugin add <路径>，依赖表现为 link: 指向源码目录）：更新方式为在源码目录执行 git pull && npm install --legacy-peer-deps && npm run build，然后完全重启 DSH 即可，无需重跑安装命令。

指定其他版本

dsh plugin add lume-dsh-plugin@0.6.1          # npm 指定版本
dsh plugin add lume-dsh-plugin@latest         # npm 最新
dsh plugin add github:cayan0x/Lume            # GitHub 最新 main
dsh plugin add github:cayan0x/Lume#v0.6.0     # GitHub 任意历史标签

标签与版本的对应关系见 CHANGELOG，建议始终使用最新标签。

开发

npm install --legacy-peer-deps   # DSH 生态包发布在公共 npm
npm test                         # vitest：单元测试 + 真实存储栈集成测试
npm run build                    # tsc（宿主 lib/index.js）+ tsdown（客户端 lib/client.js）
npm run watch                    # 客户端 bundle 增量构建

目录结构：

src/index.ts            宿主入口：注入 + RPC + 工具 + 事件接线
src/core/               纯逻辑：种子采样、检索打分、衰减、对话挖掘、manifest 解析、文本组装
src/host/               存储（选择/身份）、蒸馏管线、提取器、工具、协议与文档能力、RPC、注册表
src/client/             前端：人设菜单、蒸馏弹窗、管理弹窗（插槽 conversation.input.left）
lib/                    构建产物（随仓库提交，GitHub 安装路径依赖它）
test/                   vitest 单元测试 + storage 栈集成测试（含带数据重开域回归）
docs/screenshots/       README 截图

License

MIT