orangeofcarl0-sys/dsh-fresh-start

README excerpt

dsh-fresh-start DSH /fresh 命令：一键总结当前对话 → 开启新对话（自动跳转）→ 归档老对话。 用途 超大会话（数十万事件）的内存/卡顿缓解。在一个超大会话里工作一段时间后，输入 /fresh 即可把历史压缩成摘要、归档（释放 live 事件树内存）、开一个继承同 cwd 与 preset 的新对话并 自动跳转 过去继续工作——避免继续在 67 万事件的会话里反复构建上下文。 行为 在对话输入框输入 /fresh ： 1. 总结 ：直接提取 dsh 上传给 LLM 的 完整上下文 （ session.requestHeader() 的 system/tools + session.deriveMessages() 的全部消息），用一条简单指令让 LLM 总结成 自然语言摘要。区别于 dsh 的 /compact （用工程 checkpoint 指令 + token 比较，普通 对话上常失败）。 2. 开新对话 ： ctx.agents.create 继承老会话的 cwd 与 agent preset，并把摘要作为 新对话的开场消息（seed）。新会话的 header.parentSession 指向老会话。 3. 归档 + 自动跳转 ： ctx.workspaceRegistry.archiveSession 归档老会话；配套的 client 插件 （ lib/client.js ）监听归档事件，找到 parentId === 归档会话 的新会话 并 ctx.sessions.open 自动跳转过去。 每步独立、失败降级不阻断后续（例如总结失败时仍会开新对话 + 归档），完整结果在命令 返回文本里。 双端结构 - host 侧 （ lib/index.js ）： /fresh 命令，总结 + 创建（带摘要 seed + parentSession 标记）+ 归档。 - client 侧 （ lib/client.js ）：监听 host/archived-sessions-changed ，归档发生时按 parentId 匹配新会话并自动 ctx.sessions.open 跳转。含时序兜底：归档广播与新会话 列表同步是两个通道，若新会话尚未同步则进 pending，等会话列表更新后补跳。 安装 重启 dsh web ，日志出现 [fresh-start] installed: /fresh command registered 即成功。 client 插件会随 dsh.client 声明自动进入浏览器清单（ /plugins/dsh-fresh-start/client.js 返回 200）。 验证 - tests/smoke test.mjs （18 断言）：命令注册 / 全流程 / 总结失败降级 / 新会话失败仍归档 / 无 …

Category