dsh-fresh-start
DSH（DeepSeek Harness）/fresh 命令：一键总结当前对话 → 开启新对话（自动跳转）→ 归档老对话。
为什么需要它
超大会话（数十万事件）工作一段时间后，live 事件树越滚越大，每次构建上下文都更慢、更占内存——
在一个 67 万事件的会话里继续工作，卡顿和内存压力会持续恶化。
/fresh 把这个收尾动作变成一键操作：把历史压缩成一份自然语言摘要，开一个继承当前工作环境
的新会话并把摘要作为开场消息，然后归档老会话释放内存、自动跳转到新会话继续工作。
快速开始
安装
dsh plugin --profile web add github:orangeofcarl0-sys/dsh-fresh-start
插件源为 GitHub 仓库（不走本地路径）。之后插件发新版，同步仓库后更新：
dsh plugin --profile web update dsh-fresh-start
重启 dsh web，日志出现 [fresh-start] installed: /fresh command registered 即成功。
client 插件会随 dsh.client 声明自动进入浏览器清单（/plugins/dsh-fresh-start/client.js
返回 200）。
若 profile 的 cordis.patch.yml 里已有本插件的手工挂载行，请先删除，否则会双实例。
使用
在对话输入框输入 /fresh，可选带 preset 参数：
/fresh # 继承当前会话的 preset
/fresh standard # 用指定 preset 开新会话
| 输入 | 目标 preset | 模式 |
|---|
/fresh standard | standard | 标准模式 |
/fresh ptc（或旧输入 code） | ptc | PTC 模式（Code Mode SDK） |
/fresh minimal | minimal | 极简模式 |
/fresh create / /fresh creator | cordis | 创造模式 |
dsh 0.1.2-alpha.5 把内置 code preset 更名为 ptc 且不留别名；本插件将 ptc
直接作为 preset id 使用，code 仅作旧输入兼容映射到 ptc。
指定不存在的 preset 时命令直接报错，不会静默回退到继承值。
/fresh 的完整流程
/fresh ──▶ ① 压缩（Compact-First）──▶ ② 对话式总结 ──▶ ③ 创建 seeded 新会话
│
自动跳转 ◀── ⑤ client 侧匹配 ◀── ④ 归档老会话
① 压缩（Compact-First）
若当前 preset 挂载了宿主压缩引擎（standard/code/cordis），先 compactNow 强制压缩当前
会话——deriveMessages() 跟随 surface shadow 收紧，后续总结请求体显著缩小，并直接复用
压缩摘要。引擎不可用（minimal）、agent busy、无可压缩范围或引擎抛错时安静降级为纯对话式
总结，不阻断流程（spec：docs/COMPACT_FIRST_SPEC.md）。
② 对话式总结
直接提取 dsh 上传给 LLM 的当前上下文（session.requestHeader() 的 system +
session.deriveMessages() 的全部消息，已压缩时为收紧后的上下文），用一条简单指令让 LLM
总结成自然语言摘要。
区别于 dsh 原生 /compact（用工程 checkpoint 指令 + token 比较，普通对话上常失败）：
本实现把 compact 作为前置收紧、对话总结作为最终 seed 生成器。
③ 创建 seeded 新会话
ctx.agents.create 创建新会话：继承老会话的 cwd 与 agent preset（/fresh <preset>
可覆盖），摘要作为新对话的开场消息（seed），新会话的 header.parentSession 指向老会话。
④ 归档 + ⑤ 自动跳转
ctx.workspaceRegistry.archiveSession 归档老会话（释放 live 事件树内存）；配套的
client 插件监听归档事件，按 parentId 找到新会话并 ctx.sessions.open 自动跳转过去。
每一步独立、失败降级不阻断后续——例如总结失败时仍会开新对话 + 归档（只是新对话不带
摘要），完整结果在命令返回文本里。
架构：host + client 双端
dsh-fresh-start/
├── lib/
│ ├── index.js # host 侧：/fresh 命令（总结 + 创建 + 归档）
│ └── client.js # client 侧：监听归档事件，自动跳转
├── cordis.patch.yml # dsh bundle 挂载清单
├── docs/COMPACT_FIRST_SPEC.md
└── tests/
- host 侧（
lib/index.js，经 cordis.patch.yml 挂载进 cordis bundle）：/fresh
命令本体——压缩 + 总结 + 创建（带摘要 seed 与 parentSession 标记）+ 归档。
- client 侧（
lib/client.js，随 dsh.client 声明进入浏览器）：监听
host/archived-sessions-changed，归档发生时按 parentId 匹配新会话并自动
ctx.sessions.open 跳转。含时序兜底：归档广播与新会话列表同步是两个通道，若新会话
尚未同步则进 pending，等会话列表更新后补跳。
兼容性
dsh 版本
以 0.1.5-rc.2 为准（2026-09-11 验证轮，1.3.5）。插件依赖 dsh 内部 API
（ctx.agents.create / ctx.workspaceRegistry / ctx.sessions.open /
session.deriveMessages() 等），dsh 升级可能导致兼容性问题。
0.1.5-rc.1 → 0.1.5-rc.2 验证结论：本插件用到的七个包（dsh-agent-presets /
dsh-llm / dsh-session / dsh-compaction / dsh-permission-presets /
dsh-client-modules / dsh-command-compact）发布产物逐字节比对，lib 与全部数据
目录完全一致，仅 package.json 版本号与依赖范围重指；零代码改动，仅依赖声明与
文档对齐（peers/devDeps 升 ^0.1.5-rc.2，cordis ^4.0.2 不变）。
0.1.5-alpha.1 → 0.1.5-rc.1 验证轮：结论见 CHANGELOG 1.3.4。
1.3.0 对 alpha.5 的适配点（沿袭仍有效）：
@deepseek-ai/dsh-agent-presets#resolveSessionPreset 已删除 → 内联等价实现
（agent-preset/selected 事件倒序扫描取 data.agentPreset，回退
header.agentPreset，与宿主投影语义一致）；- 内置 preset
code 更名 ptc 且不留别名 → 别名表反转（/fresh ptc 直接命中
内置 id，/fresh code 作旧输入兼容映射到 ptc）；
- compaction 变为全局服务 → Compact-First 优先
ctx.compaction（/compact 同款
seam），rc.2 的 per-preset serviceFor 形态兜底；
@deepseek-ai/dsh-client-runtime 在 alpha 线停止发布 → 移除 peer 依赖与
dsh.client.inject 引用（client 半边零宿主 import，注册方式与 alpha.5
client-modules 机制一致，不受影响）。
其余用到的宿主 API（agents.create 的 seed/meta/setup 形状、
workspaceRegistry.archiveSession / resolveByPath / attachSession、
commands.register、session.requestHeader / deriveMessages、BlockAssembler /
createUserMessage、agentPresets.resolve / mount、permission seeded 分支）逐一
核对 alpha.5 均未变。
历史：rc.7 → rc.8、rc.1 → rc.2 时代的逐包发布产物比对均为增量变更（rc.2 中
sessions.create 收窄的参数本插件从未使用）。
1.4.0 起移除了 dsh-std Community v0.15 清单（原 dsh-plugin.json / 占位入口 /
结构测试）：std 生态自 2026-08-31 后停更，其 adapter-dsh 的 peer 窗口
（>=0.1.2-alpha.2 <0.1.3）与本插件当前宿主线（0.1.5）不兼容，该轨道从未在真实
宿主中生效；待生态恢复并补齐协议后再评估接入。移除不影响 /fresh 任何功能。
开发与测试
npm install # 安装 devDependencies（@deepseek-ai/* 0.1.5-rc.2 线，来自 npm）
npm test
测试在 @deepseek-ai/* 依赖 0.1.5-rc.2 线下运行：
tests/smoke_test.mjs（57 断言）：命令注册 / 全流程 / 总结失败降级 / 新会话失败仍归档 /
无 workspaces 降级 / parentSession 标记 / 不污染 deriveMessages() 返回值 /
provider-model 不完整时回退与降级 / 取消中止 / header 异常结构化报错 —— ALL PASStests/client_test.mjs（9 断言）：归档后按 parentId 自动跳转 / pending 兜底补跳 /
不相关归档不跳 / open 异常吞掉且不无限重试 —— ALL PASS
已知局限
- 总结依赖
session.deriveMessages()（dsh 上传的完整上下文），超大会话的上下文若超出
模型窗口，总结可能失败（此时仍会开新对话 + 归档，只是新对话不带摘要）。
更新日志
见 CHANGELOG.md。
