前言¶
在 AI 编码助手(如 Codex、Claude Code、Grok、ZCode)之间切换时,工作流往往会在智能体的边界处中断。DeepSeek Harness(DSH)作为一个插件化的中心枢纽,需要一种机制来读取这些智能体的历史会话,将目标、文件、命令和未完成任务编译成上下文,并在 DSH 内部继续执行。
dsh-sessionflow 插件正是为此设计。它将 sessionFlow 的连续性层暴露为六个 sessionflow_* 工具,使 DSH 能够检索和恢复其他智能体的上下文。
插件简介¶
这是一个轻量级 DSH 插件,旨在解决跨智能体工作流的上下文断层问题。
- 名称:dsh-sessionflow
- 所有者:HarryHeYu
- 类别:工作流
- 许可证:MIT
核心功能¶
该插件通过 Voyager 核心的稳定 JSON 接口转发所有调用,不进行额外的索引或编译。主要功能包括:
- 工具暴露:将 sessionFlow 的连续性层暴露为六个
sessionflow_*工具。 - 跨智能体恢复:支持从 Codex、Claude Code、Grok 或 ZCode 中搜索、恢复上下文并继续工作。
- 上下文编译:将其他智能体的工作(目标、文件、命令、待办事项、来源)编译为上下文包。
- 核心转发:通过 Voyager 核心的 JSON 接口转发调用。
安装与依赖¶
安装前需确保满足以下条件:
- DeepSeek Harness (DSH):版本需为
0.1.5-rc.3或0.2.0-rc.2,且必须配置了可用的模型提供者。 - Node.js:版本
>= 22.19。 - sessionFlow 核心:这是一个独立的依赖项,插件本身不包含核心代码。
安装步骤¶
第一步:安装 sessionFlow 核心
由于核心未发布到 PyPI(PyPI 上的 voyager 属于无关库),必须使用 Git URL 安装特定版本。
python -m pip install "voyager[all] @ git+https://github.com/HarryHeYu/sessionFlow.git@v1.3.0"
安装完成后,构建索引并验证配置:
voyager scan # 从真实智能体历史构建索引
voyager doctor # 确认核心运行正常并报告 bridge schema 1
第二步:安装 DSH 插件
dsh plugin --profile web add github:HarryHeYu/dsh-sessionflow
安装完成后启动 DSH:
dsh --profile web
使用示例¶
使用时,指令应明确指出你要查找的内容,而不仅仅是“继续”。
- “Continue the work I was doing in Claude Code on this repo.”
- “Continue the unfinished Codex work in this project.”
- “Find the previous Claude Code work on this repository.”
示例对话:
User: Continue the work I was doing in Claude Code on this repo.
DSH: → sessionflow_current_work
→ sessionflow_continue
[Agent continues with the previous goal, files, commands and unresolved work]
隐私与限制¶
- 隐私保护:插件完全本地运行。它不涉及账号登录、遥测数据收集或网络调用。
- 原生恢复未验证:此插件专注于“跨智能体延续”,即编译上下文包并交给当前智能体。它未验证通过原生方式恢复智能体自身会话的能力(例如
claude --resume)。插件可以记录命令,但无法在当前 DSH 进程中启动其他智能体的原生会话。
资源¶
- GitHub 仓库:https://github.com/HarryHeYu/dsh-sessionflow
- 插件目录:https://www.skillhub.cn/plugins/HarryHeYu/dsh-sessionflow