前言¶
DeepSeek Harness (DSH) Desktop 插件 Lume（微光）旨在为智能体开发提供结构化的约束与记忆支持。它不替代模型的思考过程，而是通过协议确保模型手边的“事实到位”。
在长对话或复杂任务中，模型容易产生需求漂移、引用未打开的代码行、或在非执行轮次错误地修改状态。Lume 通过纪律层和方法层解决这些问题，同时提供人设层以控制对话风格。插件以 MIT 协议开源，由开发者 cayan0x 维护。
核心能力¶
Lume 将能力划分为四个层级，每层承担特定的职责：
纪律层：边界与核查¶
纪律层负责判定请求类型并划定操作边界。它会在对话中注入检查项，确保模型在回答、查找、讨论、诊断或执行等不同模式下不越权行事。
- 请求类型判定：基于请求内容和最近几轮轨迹，区分问答、查找、讨论、诊断与执行轮次。问答轮不改文件，诊断轮不越权修复，只有执行轮才改变状态。
- 事实核查：检查引用的代码行是否在本次会话中打开、对未见过的符号是否下过否定断言、需求与交付物是否对齐。
- 上下文管理：当上下文占用达到 75% 或 90% 时发出预警，并导出结构化会话记忆（目标、已拍板、未决、关键定位）。
- 度量自校：对路由判定被反复纠正的情况进行检测。
方法层：可检查的产出¶
方法层将任务转化为可验证的产物，确保每一步都有据可查。
- 任务契约 (
lume_contract)：定义目标、范围、预估数量（先估后回填）、完成判据、非目标与待确认项。 - 改动台账 (
lume_change)：记录每次改动的位置、原因、验证方式及状态（自动入账）。 - 假设台账 (
lume_hypothesis)：记录假设的验证过程。下结论（confirmed/excluded）必须附带证据、裁决方式与反例检查。 - 设计决策 (
lume_design)：记录决策点、选择方案、放弃理由及影响面。 - 项目知识 (
lume_project_note)：按工作目录跨会话累积稳定事实，支持按编号删除（lume_project_forget）。
人设层：风格与记忆¶
人设层从聊天记录、小说、剧本或设定文档中蒸馏具名角色。
- 角色蒸馏：提取语气、口头禅、回复篇幅等特征。
- 长期记忆：以人设为键存储记忆，随对话演进。
- 风格纠偏：纠正自动生成的回复风格，但不介入代码执行和工具调用的结果。
仪表盘与触发器¶
- 行为触发器：通过轨迹而非措辞进行纠偏。包括
converge（撒网不收敛）、verify-as-you-go（连写不验）、contract-missing（契约缺失）等。 - 运行时度量：通过
lume_metrics查询路由判定、触发器命中、块装配及外部结果信号。
安装与启用¶
Lume 通过 npm 包管理器安装。
# 安装插件
dsh plugin add lume-dsh-plugin
安装后必须完全重启 DSH（包括托盘进程），插件在宿主启动时加载，不支持热重载。
典型用法¶
1. 定义任务契约
在开始执行前，使用 lume_contract 锚定目标、范围和判据。
lume_contract({
goal: '跑步记录新增配速列：列表展示 + 历史记录补算 + 导出可用',
scope: 'run_record 表与迁移脚本、列表页组件、CSV 导出',
expectCount: 6, // 先估：6 个改动点，探索后回填实际值
criteria: ["新记录能自动算出配速", "历史记录已补算", "导出的 CSV 里含配速列"],
nonGoals: ["不改 CSV 既有的列顺序", "不动手机端的同步逻辑"],
open: [] // 默认 0 个待确认
})
2. 查看运行时度量
在对话中随时查询触发器效能或系统健康状态。
lume_metrics
3. 管理项目知识
当需要删除特定的项目知识条目时使用。
lume_project_forget
注意事项¶
- 开销控制：闲聊轮不会背上整份工作协议的成本，协议与台账按需注入。
- 权限范围：人设只影响自然语言表达，不介入代码、命令与工具调用的结果。问答轮不改文件，诊断轮不越权修复。
- 网络请求：不主动发起网络请求，仅允许调用配置的模型档进行记忆提取、反思与人设蒸馏。
- 结论归属：插件不替用户下结论，机械判据只保证“有没有证据”，判断对错仍在模型。
生态位置¶
Lume 是 DSH 生态中的一个插件，用于增强 DSH Desktop 的任务执行能力。更多信息请访问 SkillHub 插件目录 或 GitHub 仓库。
