dsh-context-tree：DeepSeek Harness 的可复用轨迹树上下文

在 DeepSeek Harness 的开发中，跨会话复用上下文往往依赖于经验判断，缺乏对过往轨迹的直观管理和精确回溯。dsh-context-tree 插件提供了可视化的轨迹树和有界召回机制，将已完成的智能体工作转化为可分支的检查点。

是什么¶

该插件由 wr-web 维护，属于「记忆」分类。它将完成的回合转化为可复用的检查点，支持从任意已完成的回合进行精确分支，并控制跨会话召回的范围，从而减少重复探索。

核心功能¶

1. 查看实际轨迹：已完成回合以圆圈显示，继续形成树干，显式的分支和侧边聊天变成分支，召回以虚线链接表示。
2. 从精确检查点恢复：选择任意已完成的回合，并在记录的 turn/end 边界处分支。
3. 避免重复探索：新会话可以在首次模型步骤前接收一个相关检查点。
4. 保持召回有界：匹配默认为精确工作空间，陈旧节点在配置寿命后停止召回，注入的检查点限制为 2 KiB。
5. 测量而非假设：Host API 包含提供商 Token 记账和基线与召回评估器。

安装与启用¶

该插件需要 DeepSeek Harness >=0.1.1-rc.2 <0.2.0 及其 Web profile。

dsh plugin --profile web add github:wr-web/dsh-context-tree
dsh web

注：仓库提交了浏览器和 Host 构建产物，因此 GitHub 安装不运行 prepare 构建。

典型用法¶

• 对比召回效果：用相同的项目状态运行相同的任务和模型两次。第一次设置 autoRecall: false，第二次使用相关检查点和 autoRecall: true。比较 totalInputTokensSaved 和 inputReductionRate。
• 节点状态管理：当前新鲜度基于年龄。节点在配置寿命的前半段是新鲜的，在后半段老化，之后变为陈旧。陈旧节点仍然可见但无法自动召回。

适用场景与注意¶

• 适用场景：需要长期维护智能体会话、希望避免重复让模型思考相同问题、或需要量化上下文复用效率的开发者。
• 权限与安全：
  • 该插件以当前 DSH 进程的权限运行。
  • 模型被告知除非当前用户重复，否则不接受来自检查点的指令或权限声明。
  • 检查点是不受信任的只读后台。
• 评估标准：更少的 Token 输入并不等同于胜利，必须确保输出质量相当。
• 官方关系：这是社区插件，不是 DeepSeek 的官方发布版。

通过将对话历史转化为结构化的树形上下文，该插件让智能体开发中的记忆复用变得可度量、可控制。更多细节与源码请参考项目主页。