Skip to content
HytroZeroPublic

About

Let Agent takeover your Harness

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

DeepDuet

单一心智,多座工作间 · 为 DeepSeek Harness 打造的极简多会话协作模式

DeepSeek Harness Node.js Package


大多数多智能体工具把并发复杂度直接摊在界面上:开十个窗口、反复解释上下文、来回复制粘贴、紧盯进度条——人成了调度员和监工。

DeepDuet 反其道而行。 它在 DeepSeek Harness(DSH)中引入与 Standard 并列的 DeepDuet 模式,把交互还原成最自然的协作直觉:

  • 前台是唯一的默契搭档(Master):你始终只和一位连贯、记得住偏好的对话者交流。快问快答与轻量修改当场解决,绝不为了“多智能体仪式感”拖慢对话。
  • 后台是安静生长的工作间(Worker):遇到多步实现、长耗时构建测试或并行任务,Master 自动开辟独立工作间在后台推进;一切试错噪声留在工作间内,只在收工、受阻或需要拍板时,才在主对话空闲间隙递上一份高纯度简报。
  • 随时推门接管,系统无缝礼让:在 DSH 侧边栏或右侧编排面板中,后台工作间的状态一览无余。你可以随时点进任意 Worker 直接对话接管,DeepDuet 不会抢方向盘,离开后又能自然接续。

核心特性

  • 近处顺手办,远处分身跑:查资料、改几行代码等轻量请求在主对话立刻完成;多步开发、长耗时验证与多线并行任务自动交由后台 Worker 推进。
  • 静默推进,高纯度汇总:后台探索与试错过程不往主对话刷屏;多个任务的结果会在主对话空闲时合并成一条简报递出,需要你拍板的问题自动置顶。
  • 把分叉口翻译成人话:遇到目标歧义或高风险操作时,Worker 会礼貌暂停;Master 先消化来龙去脉,用清晰选项和推荐建议向你确认,你只需回一句或点一下就能恢复推进。
  • 全局余光常在,随时推门接管:通过侧边栏状态徽标、顶部导航胶囊与右侧 DeepDuet 编排面板,全局进度一眼可见;随时可以切入任意 Worker 亲自指导,退出后 Master 自动同步现场状态。
  • 独立工作树与原生安全边界:并发改动同一仓库时可按需隔离到独立的 Git Worktree,互不冲突;所有后台 Worker 严格继承主会话的沙箱与权限审批策略,同时完整保留提示词前缀缓存效率。

协作流程

DeepDuet 协作流程架构图

查看文本流程图(Mermaid)
flowchart LR
    User["你"] <-->|"自然对话 · 拍板决策"| Master["Master(安静的书房)"]
    User -.->|"随时推门接管"| Workers

    Master -->|"派发简洁简报 · 按需引导"| Workers["后台 Workers(独立工作间)"]
    Workers -.->|"完工 · 受阻 · 待决策"| Digest["空闲合并简报"]
    Digest -.->|"主对话空闲时温和汇总"| Master
    User <-->|"面板巡检 · 决策卡片"| Workers
Loading
  1. 轻量直通,重活异步派发:Master 记住你的偏好与项目背景,只把与任务相关的目标、范围和验收标准浓缩进工作间简报,不让无关闲聊干扰执行。
  2. 后台专注,不打断你的思路:多个 Worker 在各自空间(共享目录或独立 Git Worktree)并行推进,结果自动持久化到工程账本,重启也不丢失上下文。
  3. 集中决策,随手收尾:任务完成或遇卡点时统一汇报;确认无误后,归档任务或一键清理已完成的工作树,让工作台始终保持清爽。

快速开始

环境要求

  • DeepSeek Harness:>=0.2.2-rc.2 <0.3.0-0
  • Node.js:>=24.9.0

构建与安装

npm install
npm run build
npm run typecheck && npm test

打包并安装到 DSH Profile(例如 web):

npm pack
dsh plugin --profile web add "file:$PWD/dsh-plugin-deepduet-1.1.0.tgz"

在目标项目目录下启动 DSH Web,新建或切换会话模式时选择 DeepDuet 即可开始:

cd /path/to/your/project
dsh web

任务账本默认保存在 DSH 主目录 $DSH_HOME/deepduet/deepduet-ledger.json(未设置 DSH_HOME 时为 ~/.dsh),与全局会话存储放在一起,因此无论从哪个目录启动 dsh web 都能看到同一批任务。如需把账本固定在某个工程的 .dsh/deepduet-ledger.json,可在 Profile 补丁中配置:

- id: deepduet
  config:
    projectRoot: /path/to/your/project

延伸阅读

当前版本已知边界
  • 单进程账本写入:任务账本由当前宿主进程串行原子落盘,暂不协调多个独立进程同时写入同一份账本。
  • 异常重启恢复:已完成的 Worker 结果会在通知前先落盘;若宿主进程意外中断,残留的运行中任务会在重启后标记为失败,可通过面板或让 Master 重新检查后恢复。
  • 仓库内状态目录:隔离 Worktree 位于 <仓库>/.dsh/worktrees/<sessionId>,DeepDuet 会自动把 /.dsh/ 加入该仓库的 .git/info/exclude(不改动受版本控制的 .gitignore),避免误提交嵌套 Worktree。
  • 显式分支合并:清理已隔离的工作树目录时会保留对应分支,分支的最终合并或删除由你或 Master 显式决定。

About

Let Agent takeover your Harness

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages