dsh-workflow-boost
把 ZCode / Cline / OpenCode / Aider / Claude Code / OpenHands / SWE-agent 在工作方式上真正赢过 DeepSeek Harness 的机制, 做成一个可安装、可开关、不破坏 DSH KV 缓存纪律的插件。
版本:1.3.2 · 适配 DSH 0.2.x(源码基线 0.2.2-rc.1)· 宿主插件 + 轻量 Web 客户端(设置页)
1. 它解决什么问题
1.0.0 的主题是从单点机制到闭环:回合安全(预算/卡死/回滚)、编辑质量(改完立刻检查)、成本与状态(缓存归因/压缩账本/跨 resume 投影)。
1.1.0 补齐工作流外环:记忆治理、可配置 hook 总线、压缩前后结构化交接、内置技能、完成前确定性复核。
1.2.0 补齐表达层:可切换的回答风格与自我呈现,静态提示词段 + 斜杠命令 + 设置页即时编辑;同时修掉两个只在真实宿主上才会暴露的接缝错误。
1.3.0 补齐设置页:15 个模块共 100 个字段可在 DSH 插件设置页即时调整,改完不用重启;此前只有 stylePack 一个段可见。
| 模块 | 借鉴来源 | 对手的机制 | 本插件的实现 | 对前缀缓存的影响 |
|---|---|---|---|---|
microcompact |
ZCode | 全量总结前先清旧工具结果 | 压力/剩余预算双阈值触发,保留首条任务上下文与最新 5 组工具结果,用 surfaceOp replace 换占位文本,写 compaction/prune 影子计价 |
从第一个被清位置起才失效,越老越先清 |
focusChain |
Cline | Focus Chain:周期重注入活清单 + n/m 进度 | 每 N 次工具调用注入 user 角色快照(含 Next 行/验收标准),压缩后强制注入一次 | 只在历史尾部追加 |
duplicateGuard |
OpenHands / OpenCode | Stuck Detector 五模式 + 连续 3 次相同调用干预 | 先提醒(3)后拦截(5):同动作同观察、连续错误、A/B 乒乓、独白、压缩死循环;恢复类工具豁免 | 不改提示词 |
turnGuard |
Claude Code Stop hook / OpenHands hooks | 回合预算 + 停止前质量检查 | agent/turn-stopping 前检查步数/耗时/token 预算,超限 steer 收尾;有 goal 无证据或 todo 未完成时 steer 一次 |
尾部追加一次,可关 |
editCheck |
Aider / SWE-agent | 编辑后 lint/test 反射(max_reflections=3) | 写类工具成功后按 glob 跑配置命令,失败输出精简后回灌,最多 3 次 | 尾部追加,默认关闭 |
checkpoint |
Cline / Gemini CLI / Claude Code | shadow-git 文件快照与回滚 | 写前备份被改文件,checkpoint_list/diff/restore 工具,恢复默认需确认 |
不影响 prompt |
goalGate |
ZCode Goal Mode | 目标完成要真实证据 | goal_verify 跑多验证命令 + git 证据;enforce 下无新鲜证据拦截 complete;失败多次写原生 goal blocker |
静态段只加一次 |
repoMap |
Aider | Repo Map:全仓形状喂给模型 | 正则抽定义 + 个性化引用排序 + 增量索引,token 预算内输出;工作区 realpath 约束 | 模型主动调用才产生 |
cacheReport |
Claude Code / Manus / ZCode | 缓存命中率与成本可见 | expected/unexpected miss 归因、压缩账本、contextBreakdown 分项、成本估算 | 只读 |
memoryLint |
Claude Code / Cline | AGENTS.md/CLAUDE.md 记忆冲突与腐化 | 只读审计(重复标题/冲突规则/超长/坏链接/TODO)+ memory_propose 提案文件,绝不自动改指令 |
只读 |
hookBus |
Claude Code hooks(跨家收敛) | 用户配置的生命周期 hook | 六个事件(Pre/PostToolUse、Stop、PreCompact、UserPromptSubmit、SessionStart)映射为 allow/deny/addContext/steer;默认关 | 尾部追加,默认零注入 |
handoffNotes |
Anthropic context engineering | 压缩前结构化笔记、压缩后回注 | 压力高时把 goal/todo/最近活动写成 .dsh 笔记,压缩后以 notice 注入一次 |
尾部追加一次 |
skillPack |
Claude Code / OpenHands skills | 内置技能按需加载 | 通过原生 skills 服务注册 4 个技能(verify/cache/checkpoint/repomap),目录只占少量 token | catalog 固定,正文按需 |
reviewGate |
OpenHands Critic / Claude Code review | 完成前复核 diff | review_diff 确定性检查:密钥/冲突标记/调试残留/异常大删除 + 人工复核清单;可配 goalGate.requireReview |
只读 |
stylePack |
当代 agent 的 output style / 指令规则 | 风格预设与自我呈现 | 一段静态系统提示词(身份行 + 可检查规则)+ /boost-* 命令;切换只在历史尾部追加一条 notice;设置页 volatile 即时编辑 |
每段会话只注册一次;切换只影响尾部 |
明确不做的:重写原生 pruner/compaction、rulesRouter(原生 dsh-agent-instructions 已覆盖)、每步动态工具集/系统提示词、并行子代理编排、pre-execute 改写参数。
2. 安装
方式 A:从 GitHub 直接安装(推荐)
插件已发布到 GitHub(SlumberMin/dsh-workflow-boost),Release 上带可直装的 tgz:
dsh plugin --profile <profile> add https://github.com/SlumberMin/dsh-workflow-boost/releases/download/v1.3.2/dsh-workflow-boost-1.3.2.tgz
也可以直接从 Git 源安装:
dsh plugin --profile <profile> add github:SlumberMin/dsh-workflow-boost
桌面版:打开 Settings → Plugins(或 Plugins 页)的安装入口,把上面 tgz URL 或 github:SlumberMin/dsh-workflow-boost 粘进去即可;装好重启 DSH 生效。
<profile>换成你的 profile 名(桌面版一般是desktop,普通dsh web是web)。 首次安装建议加一段安全配置(见 §3 配置):goalGate.mode: advisory(配置好verifyCommands后再切enforce)、editCheck.enabled: false、hookBus.enabled: false。 1.1.0 及更早版本的lib/config.js在真实宿主下可能无法加载,请升级到 1.2.0。
方式 B:手动放入 profile
把 dsh-workflow-boost/ 目录放到目标 profile 的 plugins/ 下(或任意路径并用 file: 依赖引用)。profile 的 package.json 增加:
{
"dependencies": {
"dsh-workflow-boost": "file:./plugins/dsh-workflow-boost"
}
}
在 profile 目录用 DSH 自带 runtime 的 pnpm 安装(桌面版路径形如 <DSH 安装目录>/resources/runtime/primary-runtime/dependencies/pnpm/bin/pnpm.mjs,node 用 <DSH 安装目录>/resources/runtime/bin/node.cmd):
cd <profile 目录>
node <DSH runtime pnpm.mjs 路径> install
启用插件
profile 的 cordis.patch.yml 末尾追加(若文件当前只有 [],请整体替换为下面的块):
- insert:
- id: workflow-boost
name: dsh-workflow-boost
profile 的 patchReload: live 时 HMR 自动重载;startup 时重启 DSH 生效。
3. 配置(全部可选)
- insert:
- id: workflow-boost
name: dsh-workflow-boost
config:
enabled: true
microcompact:
enabled: true
triggerRatio: 0.72
triggerTokens: 0 # 绝对压力 token 上限,0=按比例
minRemainingTokens: 0 # 0=自动:>200k 留 20k,<=200k 留 20%
keepRecentGroups: 5
keepFirstEvents: 2
minCharsPerResult: 1600
maxResultsPerPass: 24
idleMinutes: 60
placeholder: '[Old tool result content cleared]'
focusChain:
enabled: true
everySteps: 6
minItems: 1
includeProgress: true
includeNextAction: true
injectAfterCompaction: true
maxItems: 40
duplicateGuard:
enabled: true
remindAt: 3
blockAt: 5
identicalObservationAt: 4
consecutiveErrorsAt: 3
monologueAt: 3
alternatingAt: 6
whitelist: []
turnGuard:
enabled: true
mode: advisory # advisory | enforce
maxSteps: 150
maxMinutes: 60
maxTokens: 0
warnAt: 0.8
hardStop: false
finishChecks: true
editCheck:
enabled: false # 默认关闭;开启后每步可能跑命令
checks:
- name: tsc
when: ['**/*.ts', '**/*.tsx']
command: 'npx tsc --noEmit -p .'
timeoutMs: 120000
debounceMs: 15000
maxPerTurn: 3
maxReflections: 3
checkpoint:
enabled: true
maxPerTurn: 30
keepTurns: 20
maxTotalBytes: 536870912
maxFileBytes: 5242880
autoRestore: false
goalGate:
enabled: true
mode: enforce
verifyCommand: '' # 空且无 verifyCommands:goal_verify 不再 PASS,enforce 下拒绝启动
verifyCommands: [] # [{name, command, required, timeoutMs}]
verifyTimeoutMs: 600000
requireGitEvidence: true
freshWithinMs: 1800000
blockAfterFailures: 3
useGoalsService: true
requireReview: false # true 时完成前必须有新鲜 review_diff
repoMap:
enabled: true
maxFiles: 2500
maxFileBytes: 262144
tokenBudget: 1400
cacheTtlMs: 60000
timeBudgetMs: 20000
incremental: true
personalize: true
cacheReport:
enabled: true
detail: summary # summary | attribution | ledger | all
healthThreshold: 90
inputPricePerMillion: 0.28
cacheReadPricePerMillion: 0.028
outputPricePerMillion: 0.42
memoryLint:
enabled: true
maxFiles: 40
maxFileBytes: 262144
maxProposals: 100
injectPending: true
hookBus:
enabled: false # 默认关闭;开启后执行配置的 hook 命令
timeoutMs: 10000
hooks: []
# - name: no-console
# event: PreToolUse
# matcher: '^bash'
# command: 'node .dsh/hooks/no-console.mjs'
handoffNotes:
enabled: true
minPressureRatio: 0.6
maxNoteChars: 4000
refreshEveryTools: 10
injectAfterCompaction: true
skillPack:
enabled: true
exposeCatalog: true
reviewGate:
enabled: true
maxDiffChars: 12000
checks:
secrets: true
conflictMarkers: true
debugPrints: true
largeDeletion: true
stylePack:
enabled: true # 默认 default + off:宿主提示词逐字节不变
style: default # default | concise | proactive | explanatory | learning | custom
identity: off # off | deepseek-v4.1 | claude-opus-5.5 | claude-fable-5.2 | ...
customStyle: '' # style=custom 时每行一条规则
customIdentity: '' # identity=custom 时的自定义身份句
applyToSystemPrompt: true # 渲染静态系统提示词段
persist: true # 写入 <workspace>/.dsh/workflow-boost/style.json
identityScope: presentation # presentation | full
warnOnIdentity: true
每个 section 都可单独 enabled: false;插件总开关 config.enabled: false。除 4 个数组字段外,这些标量字段都可在 DSH 插件设置页即时调整,见 §3.1。
配置 schema 由
@deepseek-ai/schemastery解析,不是 zod:没有.optional()/.describe(),可选字段就是不带.default()的字段。1.2.0 修掉了 1.1.0 及更早版本误用这两个方法导致真实宿主加载失败的问题。
3.1 设置页可调(1.3.2)
设置页已经中文化,并补充了每个模块的用途说明:
- 回复风格下拉里,“简洁(对齐 Claude Code 默认,推荐)”是 Claude Code 默认体感的对应项:Claude Code 本身没有额外 output style,它的基础提示词就要求“第一句给答案、不要前奏/复述、简单问题 1-3 句”;“不追加规则(DSH 原样)”则完全不动宿主提示词。
- 模块开关每个后面都有一行中文说明(例:上下文微压缩 = 上下文快满时清掉最旧工具结果省 token)。
- 自我呈现不再只是往系统提示词末尾追加一句,而是在 @BT@system-prompt/assemble@BT@ waterfall 里替换 DSH 的 @BT@harness:identity@BT@、@BT@deployment:persona-prefix@BT@、@BT@deployment:persona-suffix@BT@ 三段,再插入选定的身份行(带“仅自我描述、不带来能力”的约束)。选“关闭”则完全保留 DSH 原样。
- 注意:被替换的只是提示词文本;API 请求里的实际模型名无法隐藏,模型自身训练出的自我认知也无法靠提示词改变。
- 切换身份会让系统提示词重建一次(一次缓存失效),之后同一身份下保持稳定。
1.3.0 的说明不完整:Host 的 settings 服务确实把 .volatile() 字段投影出来,但 DSH 自带的 Web 客户端不会自动渲染第三方插件的配置表单——它只渲染客户端 companion 注册的页面(官方 plugins 都是 host + client 成对发布,参考 dsh-client-ui-settings-shell、dsh-win-pwsh7)。1.3.0 只有宿主半边,所以设置页一直为空。
1.3.1 补上了 client.js(浏览器半边):
dsh.client(platform web)+exports["./client"];- 注册 Settings 对话框左侧导航页:
Settings → Workflow Boost(settings.sectionslot,order 15); - 注册 Plugins 页配置卡片:
插件 → dsh-workflow-boost → 配置(plugins.row.configslot); - 控件写入通过
ctx.configForms.get('workflow-boost')+form.mutate([{op:'set', path:[...], value}]),走 Host settings 服务,自动带 revision 冲突保护;保存后loader/volatile-update让所有模块立即读到新值,不需要重启。
设置页里可调:
- 插件总开关;
- 回复风格(default / concise / proactive / explanatory / learning / custom + 自定义规则);
- 自我呈现(off / DeepSeek V4.1 / Claude Opus 5.5 / Claude Fable 5.2 / Claude Sonnet 5.5 / GPT-6.1 Sol / Grok 4.7 / Kimi K3 / GLM-5.3 / MiniMax M3.1 / 自定义);
- 15 个模块各自的 enabled 开关;
- 是否注入系统提示词、是否持久化到工作区。
前提:DSH ≥ 0.2.2(本机 0.2.2-rc.3 验证)。旧版客户端如果没有
settings.section/plugins.row.configslot,客户端会安全跳过,只保留宿主功能。
Host 的插件设置页表单是 Config schema 派生的:只有声明 .volatile() 的字段会被投影(packages/settings/settings/src/schema.ts 的 volatileForm()),普通字段只能通过 profile YAML 编辑。1.2.0 只把 stylePack 一个对象标成 volatile,所以设置页里只有那一块;1.3.0 把每个模块的标量字段逐个标成 volatile(与官方 bash-local / web-deepseek-api 的写法一致)。
- 现在设置页可编辑:主开关
enabled+ 15 个模块的开关、阈值、模式、字符串等共 100 个字段(16 个顶层表单条目)。 - 保存后 Host 把新值提交到运行中的 volatile 引用并发出
loader/volatile-update。lib/live-config.js把.get()引用解包成一份普通快照,并在该事件上原地刷新(嵌套 section 对象保持同一引用),所以 15 个模块无需改动就能读到实时值,参数改动立即生效、不重启、不重挂。入口的刷新 listener 注册在所有模块之前,保证stylePack在同一事件里读到的也是新值。 - 改
enabled开关会由lib/module-lifecycle.js热挂载/卸载对应模块;其它参数改动不会重挂,也不会重建会话状态。 - 4 个数组型字段保持普通配置,仍从 profile 的 YAML 编辑:
duplicateGuard.whitelist、editCheck.checks、goalGate.verifyCommands、hookBus.hooks。自动表单无法可靠增删嵌套行,强行投影反而会破坏配置。 - 需要宿主
@deepseek-ai/schemastery >= 3.19(DSH 0.2.2-rc.1 依赖~3.19.0)。更低版本没有.volatile(),插件照常加载,但设置页不提供实时编辑,改配置后走 Loader 正常重载。 - 门禁:
node test/verify-config.mjs用真实 schemastery 复刻volatileForm()投影并断言字段覆盖。
4. 每个模块怎么用
microcompact(上下文卫生)
- 触发:每个 agent step 前;压力比 ≥
triggerRatio或剩余窗口 ≤minRemainingTokens(自动口径)或空闲 ≥idleMinutes。 - 动作:从最旧处开始,保留首
keepFirstEvents条、最新keepRecentGroups组与错误/图片/过短结果;单次最多maxResultsPerPass条;预计节省 < 256 token 时整体回滚。 - 安全:检测到未闭合
compaction/start时跳过;替换事件带sourceEventSeqs,原文仍在只追加日志可回放。
focusChain(长任务防漂移)
- 每
everySteps次工具调用把 todo 清单渲染成 user 角色 notice 注入历史;压缩后强制注入一次;同一内容 hash 不重复注入。 - 清单为空不注入;
Next:行指出下一项可执行任务。
duplicateGuard(Stuck Detector)
- 五类模式(阈值全部可配):同动作同观察 ≥4、同动作连续错误 ≥3、连续 assistant 独白 ≥3、A/B 交替 ≥6、连续压缩失败 ≥2。
- 双阶段:
remindAt次先注入提醒,blockAt次后 pre-execute 拒绝下一次相同调用;恢复/报告类工具永远豁免。
turnGuard(回合护栏)
- 预算:
maxSteps/maxMinutes/maxTokens;warnAt处注入一次提醒;超限在agent/turn-stopping里 steer 一次收尾,hardStop时再 cancel。 - 收尾门禁:有活跃 goal 但本回合无新鲜
goal_verify证据、或 todo 有 in_progress 时 steer 一次(每回合最多一次)。
editCheck(编辑后验证)
- 写类工具成功后,按
checks[].whenglob 匹配文件 → 执行command;失败输出 head/tail + 首条错误,≤maxOutputTokens回灌;最多maxReflections次。 debounceMs去抖、maxPerTurn限流、超时取消;默认关闭。
checkpoint(文件快照)
- 写/编辑/删除前把将被改文件备份到
<workspace>/.dsh/workflow-boost/checkpoints/,工具:checkpoint_list/checkpoint_diff/checkpoint_restore;恢复默认需用户确认(autoRestore: false)。 - 跳过
.git/node_modules/dist/ 大文件 / 符号链接;保留keepTurns与maxTotalBytesLRU 上限。
goalGate(目标证据闭环)
goal_verify跑verifyCommands(或旧verifyCommand)并附 git 证据;enforce 模式下没有freshWithinMs内的通过证据就拒绝 complete。verifyCommand为空且无verifyCommands时:goal_verify返回 FAIL 且不写通过记录;enforce 模式加载即报错(fail-fast,插件禁用该模块并 log)。- 失败达到
blockAfterFailures次时,若原生ctx.goals可用则记录 blocker。
repoMap(仓库形状)
repo_map(path?, maxTokens?, focus?):工作区 realpath 约束;符号抽取 + 跨文件引用排序(个性化);timeBudgetMs超时返回部分结果并注明;磁盘增量索引 + 60s 结果缓存。
cacheReport(缓存账本)
cache_report(detail?):命中率、与配置单价的估算成本、contextBreakdown 分项、expected vs unexpected miss 归因、压缩账本(prune/summary 前后 token 与估算节省)。- 投影不可用时明确说明「没有猜数字」。
memoryLint(记忆治理)
memory_audit({path?}):从项目根到 cwd 扫描 AGENTS.md/CLAUDE.md 及 local overlays,检查重复标题、冲突规则、超长、失效 @import/相对链接、空文件、TODO;输出 severity/rule/file/line 与建议。memory_propose({text, reason?}):把用户纠正或新约定追加到.dsh/workflow-boost/memory-proposals.jsonl(去重、截断),下次会话提示确认;不自动修改 AGENTS.md/CLAUDE.md。- 只读、fail-open;有 pending 提案时每 agent 注入一次提示(可关
injectPending)。
hookBus(可配置 hook 总线,默认关)
- 配置
hooks: [{name, event, matcher?, command, timeoutMs?}],事件:PreToolUse / PostToolUse / Stop / PreCompact / UserPromptSubmit / SessionStart。 - 命令从配置读取(模型输入只进 JSON stdin),stdin 含
hook_event_name/tool_name/tool_input/cwd/session_id;exit 2 = 阻断(stderr 为理由);exit 0 + stdout JSON 可返回{decision, reason, additionalContext, continue, message}。 - 映射:PreToolUse→pre-execute deny/allow;PostToolUse→block/additionalContexts;Stop→steer(每回合一次);PreCompact/UserPromptSubmit→下一次 post-execute 注入一次;SessionStart→side effect。
- 默认关闭;命令来自可信配置,不把模型输入拼进 shell。
handoffNotes(压缩交接)
- 压力 ≥
minPressureRatio且距上次刷新够久时,把活跃 goal、todo(含状态)、最近工具活动/错误、next actionable 写成.dsh/workflow-boost/handoff/<sessionId>.md,并注入一条短 notice。 - 监听
compaction/end,压缩后把渲染后的笔记注入一次(injectAfterCompaction),避免「摘要丢状态」。 - 工具
handoff_note({action: 'read'|'write'|'append', text?})可人工读写。
skillPack(内置技能)
- 通过原生 skills 服务注册 4 个内置技能:
workflow-boost-verify、workflow-boost-cache、workflow-boost-checkpoint、workflow-boost-repomap。 - 技能目录只含 name + description(按需加载正文);skills 服务缺失时仅 log debug,不影响其它模块;
exposeCatalog: false可隐藏目录。
reviewGate(完成前复核)
review_diff({base?, paths?, focus?}):在会话 cwd 跑git status/diff,对新增行做确定性检查——疑似密钥、冲突标记、调试残留、异常大删除;输出 findings + 统计 + 人工复核清单,并记录本 agent 的 review 证据。goalGate.requireReview: true时,complete 前必须有新鲜 review;有 blocker findings 也会被拦(按freshWithinMs)。- 这是确定性检查,不是完整代码审查;git 不可用时明确返回不可用,不猜。
stylePack(回答风格与自我呈现,1.2.0)
把「怎么说话」和「自称是谁」做成配置 + 命令,但只产生一段静态系统提示词;切换发生在历史尾部,不重写前缀。
静态段:
applyToSystemPrompt: true时通过原生systemPrompt.section()注册一段(身份行 + 可检查的规则列表),order: 5。style: default且identity: off时渲染为空,宿主提示词逐字节不变。风格预设:
default/concise/proactive/explanatory/learning/custom。规则是可检查的行为条目(先给答案、不寒暄不复述、path:line 引用、破坏性操作才确认、完成要有验证证据),不是形容词。custom读customStyle(每行一条)。身份预设:
off(默认)/deepseek-v4.1/claude-opus-5.5/claude-fable-5.2/claude-sonnet-5.5/gpt-6.1-sol/grok-4.7/kimi-k3/glm-5.3/minimax-m3.1/custom。custom读customIdentity。命令(通过原生
ctx.commands.register,不产生模型消息):命令 作用 /boost-style <name> [自定义规则]切换本会话风格;无参数显示当前值与目录 /boost-identity <name> [自定义身份句]切换本会话自我呈现;无参数显示当前值与目录 /boost-show显示当前选择与全部预设 /boost-reset恢复配置默认值 切换后由
tools/post-execute在下一次工具调用尾部注入一条[style switch] ...notice;此前的历史与缓存前缀保持不变。设置页即时编辑:9 个字段都是字段级 volatile(见 §3.1),表单可改
enabled / style / identity / customStyle / customIdentity / applyToSystemPrompt / persist / identityScope / warnOnIdentity。插件监听loader/volatile-update重注册静态段;入口的刷新 listener 先于模块注册,保证读到的是新值。持久化:
persist: true时把选择写到<workspace>/.dsh/workflow-boost/style.json,下个会话首次 step 前恢复;写失败只 log,不影响本次会话。只读工具
boost_settings:报告当前风格/身份与可用预设。
身份边界(重要)
- 身份行默认
off;开启后只是自我呈现,不会改变实际模型、工具或能力。identityScope: presentation(默认)会在静态段里明确写「不得声称自己不具备的能力,本会话工具是能力事实的唯一来源」。 identityScope: full把它当作模型身份陈述,仅用于个人本地实验;不得用于向终端用户误导产品身份或服务商。warnOnIdentity: true(默认)在启用非 off 身份时打一条 warn 日志。- 宿主能力缺失时模块 fail-open:没有
systemPrompt就只保留命令,没有commands就是 no-op,绝不因为风格打断一次回合。
来源与 cutoff
用户约定:只参考 2026-06 之后发布的模型/agent 资料。
lib/pure/style-core.js中SOURCES_CUTOFF = '2026-06';身份目录每个具名预设都带released月份,最早为 2026-07(Kimi K3),没有更早模型。- 发布时间参考:https://platform.claude.com/docs/en/models/opus-5-5/overview、https://www.techtimes.com/ai-timeline、https://traictory.com/timeline、https://research.aimultiple.com/llm/。
- 风格规则提炼自当代 agent 指令的可检查条目(answer-first、无寒暄/复述、path:line、反 LLM 腔、仅破坏性操作确认、完成需可验证);
_research/cl4r1t4s-survey.md这类 2026-06 之前的提示词归档只用于辨认指令文件结构,不作为规则来源。
5. 缓存纪律(为什么不破坏 DSH 最强的地方)
- 系统提示词只增加静态文本(goalGate 完成纪律 + stylePack 风格/身份段),不随状态变化。
- focusChain / turnGuard / editCheck / stylePack 的注入全部走
additionalContexts或agent.steer,追加在可复用前缀之后。 - microcompact 从最旧处替换、阈值触发,只损失第一个被清位置的缓存。
- repo_map / cache_report / goal_verify / checkpoint / boost_settings 是工具,模型不调用不产生 prompt 成本。
- 插件状态用
sessionProjections(不可用时回退内存 fold),不写系统提示词、不依赖已弃用的session.eventAt()。 - stylePack 中途切换只追加一条尾部 notice;只有设置页改动才重建一次静态段(一次缓存重建是可接受代价)。
6. 与 DSH 原生能力的分工
| 插件模块 | 原生对应 | 关系 |
|---|---|---|
| microcompact | compaction-tool-result-pruner + compaction-basic | 时机不同:插件是压缩前的早期粗清理 |
| duplicateGuard | repeat-tool-reminder(advisory 3/5/8) | 互补:插件升级为五模式 + 硬拦截 |
| focusChain | 无(只有 todo 工具) | 补位 |
| turnGuard | 无(官方明确无 turn budget) | 补位 |
| editCheck | 无 | 补位 |
| checkpoint | session-checkpoint-policy(仅崩溃恢复 flush) | 补位:文件级快照/回滚 |
| goalGate | goal + tool-goal + round-driver(无 evaluator) | 补位 |
| repoMap | 无 | 补位 |
| cacheReport | tokenMeter(只有数据) | 补位:归因/账本/成本 |
| memoryLint | 无(原生只加载 AGENTS.md/CLAUDE.md,无冲突审计与提案) | 补位 |
| hookBus | 无(0.2.2-rc.1 尚无 hooks 服务) | 补位(默认关,自带总线) |
| handoffNotes | compaction-basic(只做摘要) | 补位:摘要前的结构化笔记 |
| skillPack | dsh-skill(注册表) | 复用原生服务,只提供内置技能 |
| reviewGate | 无(官方 goal evaluator deferred) | 补位:确定性 diff 复核 |
| stylePack | 无输出风格服务;复用 systemPrompt / commands / settings 三个原生服务 | 补位 + 复用:只提供预设与命令 |
7. 验证
在包根目录执行(不依赖 @deepseek-ai/* 已安装,干净 Node 即可):
node test/check.mjs # node --check 全部源码(62 文件)
node test/unit.mjs # 280 项单测(stylePack 22 + liveConfig 7)
node test/verify-harness.mjs # 62 项接线断言(fake 宿主,15 个模块)
node test/verify-config.mjs # 真实宿主:表单投影 / 字段级引用 / 原地刷新
node test/run-case.mjs test/cases/style-pack.mjs # 单独跑 stylePack(22/22)
node test/run-case.mjs test/cases/live-config.mjs # 单独跑 liveConfig(7/7)
真实宿主兼容性自检(可选;需要本机装有 DSH 的 schemastery,或用 DSH_SCHEMASTERY 指向包根):
node test/verify-config.mjs # 用真实 schemastery 构造 Config、校验 volatile 表单投影
未安装宿主 schemastery 时会输出 SKIP 并以 0 退出,不影响正常安装。
为什么需要第二条:干净环境单测用 fake z,1.1.0 正因为 lib/config.js 写了 zod 才有的 .optional() / .describe() 而在真实宿主上构造 Config 直接抛异常,测试全绿却装不上。1.2.0 已修;1.3.0 把它扩展成表单投影门禁:本机对 schemastery 3.19.0(16 个顶层条目 / 100 个可编辑字段、字段级 .get() 引用、live-config 原地刷新)与 3.18.2(守卫降级、Config 正常加载)分别实测 PASS。
说明:本轮仍在 DSH 0.2.2-rc.1 的源码/类型层面验证(app.asar 提取 + 接缝审计),没有可用隔离 profile 做真实会话实测;dsh.verifiedAgainst 记录的是源码基线版本。安装后建议先跑 node test/verify-harness.mjs,再在会话里检查 repo_map / cache_report / goal_verify 三个工具,以及 /boost-show。
8. 已知限制
- microcompact 只在「上下文压力已知」或空闲触发时工作;刚开会话不会误清。
- 压力比口径与原生 compaction 的
min(W*0.8, W-O-headroom)口径不同,triggerTokens可用于绝对口径。 - repo_map 用正则而非 tree-sitter:非常规语法可能漏定义;给的是形状不是精确 AST。
- editCheck 默认关闭;开启后每步可能跑命令,注意去抖与超时。
- checkpoint 只覆盖插件观测到的写/编辑/删除;
bash/pwsh直接改文件不在快照范围。 - goal_verify 的命令是配置而非模型输入;配置破坏性命令仍是配置者责任。
- cacheReport 的价格是配置值不是账单;token 估算是启发式;仅有流式 attempt usage 的宿主会显示账本不可用,但
tokenUsage投影仍可用。 - duplicateGuard 的独白/交替模式在真实 loop 中触发频率较低(advisory 为主),resume 后用户边界丢失时退化为整 ring 计数。
- turnGuard 的
maxTokens是回合内压力增量近似(默认关闭,不含输出 token);hardStop的 steer+cancel 顺序需真机复核。 - hookBus 默认关闭;同一事件多 hook 时首个 block/continue 生效;PreCompact/UserPromptSubmit 的上下文入队后可能顺延到下一次工具调用才注入;事件 payload 形状按 0.2.2-rc.1 源码实现,未真机验证。
- skillPack:真实
dsh-skill的registerProvider要求同步工厂返回{name,list,get};仅提供register的服务无法隐藏 catalog;provider rank 低于 runtime 技能,同名时原生优先。 - memoryLint:ctx.fs 返回错误时视为最终结果(不绕过沙箱降级 node:fs);提案文件写在插件自有
.dsh目录。 - reviewGate:确定性检查只覆盖常见风险模式,不能替代完整代码审查;依赖 git。
- handoffNotes:笔记写入插件自有
.dsh目录;注入为一次性 notice,压缩后仅恢复要点而非完整历史。 - stylePack:身份行只是自我呈现,不改变模型/工具;默认全关,不得用于对终端用户误导产品身份。
- 设置页:实时编辑需要宿主 schemastery ≥ 3.19(DSH 0.2.2-rc.1 满足);更低版本只能改配置后重启。4 个数组字段不进表单(见 §3.1)。
- stylePack:中途切换要等下一次工具调用才对模型可见,命令本身不产生模型消息。
- stylePack:持久化文件在工作区
.dsh/workflow-boost/style.json;只读工作区下切换仍可用但不跨会话。 - 未在本机真实 DSH 会话实测(无隔离 profile);所有宿主接缝按 0.2.2-rc.1 源码实现,升级前先看 CHANGELOG。
9. 版本变更(1.3.0)
- 全插件设置页可调:15 个模块的标量字段 + 主开关共 100 个字段改为字段级
.volatile(),宿主volatileForm()会把它们投影成设置页表单(此前只有stylePack一个段可见)。 - 新增
lib/live-config.js:把 volatile 的.get()引用递归解包成普通快照,并在loader/volatile-update上原地刷新;15 个模块零改动即可读到实时值。 - 新增
lib/module-lifecycle.js:设置页改enabled开关时热挂载/卸载模块;刷新 listener 注册在所有模块之前,避免stylePack读到旧快照。 - 4 个数组字段保持普通配置(
whitelist/checks/verifyCommands/hooks);test/verify-config.mjs升级为真实宿主表单投影门禁。 - 规模:单测 273 → 280,语法检查 59 → 62 文件,接线 62 项不变,包内 70 → 73 文件。
9.1 版本变更(1.2.0)
- 新增
stylePack:6 种风格 + 带发布日期的身份预设、静态提示词段、4 个/boost-*命令、boost_settings只读工具、设置页 volatile 即时编辑与可选持久化。 - 修复 P0:真实 schemastery 下
Config构造即崩(.optional()/.describe()是 zod API)。新增test/verify-config.mjs真实宿主门禁,避免 fakez再次掩盖同类问题。 - 修复 P1:
tools/post-execute三参契约写错导致每次工具调用可能抛错;命令注册改为真实handler({agent, rawInput}) -> {kind, text}契约。 - 修正
PLUGIN_VERSION(1.1.0 误留 1.0.0)、README 拼接错误与 ARCHITECTURE 接缝描述。 - 规模:单测 251 → 273,接线 58 → 62,语法检查 55 → 59 文件,模块 14 → 15。
9.2 版本变更(1.1.0)
- 新增 5 个模块:
memoryLint、hookBus(默认关)、handoffNotes、skillPack、reviewGate。 goalGate增加requireReview:可选要求完成前有新鲜 review 证据;review 的 blocker findings 同样拦截。- 验证规模:单测 159 → 251,接线断言 43 → 58;打包内容仍保证 tgz 与 zip 一致。
9.3 版本变更(1.0.0)
- 修复 0.1.1 全部 8 项:阈值 0.72 / MIN_SAVINGS 256 / 最新 5 组 / 短占位文本 / goalGate 空命令 fail-fast / repoMap 越界与排序性能 / verify-harness 进入包内 / 单测干净环境可跑。
- 新增 turnGuard、editCheck、checkpoint 三个模块;duplicateGuard 升级为 Stuck Detector;cacheReport 升级为 cacheAudit。
- microcompact 增加首条保护与剩余预算双阈值;focusChain 增加 Next/验收标准/压缩后存活;goalGate 支持多验证命令与原生 goal blocker;repoMap 增加个性化排序与增量索引。
- 移除
session.eventAt()与process.cwd()依赖;插件状态走sessionProjections(带内存回退)。 - 打包:tgz 与 zip 内容一致,
SHA256SUMS.txt随包更新。
10. 卸载 / 回滚
- 从 profile 的
cordis.patch.yml删除workflow-boostinsert(HMR 立即卸载)。 - 彻底移除:删除插件目录与
package.json的file:依赖,重新 pnpm install。 - 模块级回滚:
config.enabled: false或单独<module>.enabled: false,无需重启;stylePack 也可直接用/boost-reset。
No comments yet. Be the first to write one.