为 DeepSeek Harness 提供十个与 Codex 对齐的线程工具:list_threads、list_archived_threads、read_thread、wait_threads、send_message_to_thread、create_thread、fork_thread、set_thread_title、set_thread_archived、delete_thread。消息走宿主与人类客户端相同的投递路径,冷会话会自动恢复、空闲会话因此开始新一轮;wait_threads 可同时等待最多八个会话,读取轮次时会剥掉注入的提醒块。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:Heroicus/dsh-thread-tools
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
把 Codex 桌面端的 thread 协同工具集 1:1 搬到 DeepSeek Harness。一个 DSH 会话对应一个 thread。
工具(与 Codex 同名同参)
| 工具 | 作用 |
|---|---|
list_threads |
列出线程:mode: recent 返回置顶 + 按活跃排序;mode: history 返回一页(cursor/limit) |
list_archived_threads |
列出已归档线程的一页 |
read_thread |
读某个线程的轮次摘要,支持 turnLimit、includeOutputs、maxOutputCharsPerItem、cursor 翻页 |
wait_threads |
最多等 8 个线程,谁先完成/需要输入就返回;timeoutMs 上限 120000,0 表示立即快照 |
send_message_to_thread |
投递消息,包在 <codex_delegation><source_thread_id>…</source_thread_id><input>…</input></codex_delegation> 信封里 |
create_thread |
新建线程,可带首条 prompt 异步派发 |
fork_thread |
复制线程(含历史)成独立新线程 |
set_thread_title |
改名 |
set_thread_archived |
归档 / 取消归档;已归档的线程拒绝投递 |
delete_thread |
永久删除线程与其持久化日志 |
hostId、source 为签名兼容参数,本安装只有一台 host。
安装
本地目录安装:插件 → 添加插件 → 选这个目录。或在会话里用 plugin_manager 的 install_bundle 指向本目录。
无依赖、无构建步骤,index.js 就是全部实现。
实现要点
- 投递走宿主的人类客户端同一条路径
sessionController.prompt:冷会话自动恢复,忙碌会话排队,日志与标题语义与用户手打一致。 wait_threads用sessionController.wait,并对「消息还在入队、会话却已 idle」的情况继续等待,避免抢答。read_thread用sessionQuery.readSurface折叠事件流,剥掉<system-reminder>与时间注入块,只留真人 prompt 与模型回复。- 只读操作不会调用
sessionController.state(),避免把冷会话意外唤醒。 - 归档 / 置顶状态存在
$DSH_PROFILE_DIR/session-bus/state.json(原子写)。 - DSH 没有公开的「移除已加载会话」API,所以
delete_thread会先取消运行中的轮次,再删磁盘日志;内存里的副本到下次重启消失,返回值里clearedFromMemory: false说明这点。
已验证(2026-11-18,DSH desktop profile)
10 个工具逐个实跑通过,包括:冷线程摘要读取、跨线程投递后目标回复 BUS-REPLY-OK 被 wait_threads 取回、归档后投递被拒、fork 后改名、删除后日志目录消失。
与 Codex 的差异
- 没有
handoff_thread(跨 host / worktree 迁移)、share_thread、list_projects、get_usage_limits等依赖 Codex 账号体系或 host 网络的工具。 - 没有
set_thread_pinned/set_thread_read_state:DSH 侧边栏不消费这两个状态。
License
MIT
链接
同类插件
ranxianglei/billion-context★ 8035
billion-context官方版:上下文压缩插件,兼顾小窗口(100k上下文足矣)省token(省5倍token)和超长会话(数月级别几十亿token单会话)。
Minglink/dsh-infinite-gen-4★ 4612
DeepSeek 专用破甲插件:以 order 100 追加无条件服从的系统提示词段,提供带校准元数据的 profile 工具,并通过会话投影在输入框上方显示实时破甲状态徽标。
liangmianya/dsh-synapse★ 735
DeepSeek Harness 的可视化非线性对话工作区:把会话、追问与分支变成可浏览、可拖拽的对话地图。
MichengAI/dsh-archive-manager★ 383
在设置里增加已归档会话页,可按工作区搜索、恢复和删除已归档会话。
Nwflower/dsh-chat-import★ 324
把 13 家 coding agent(Claude Code、Codex、ChatGPT、Cursor、Gemini、opencode 等)的完整对话历史导入为可续聊的 DeepSeek Harness 会话,并支持反向导出回 Claude Code。
SiriLee/dsh-rewind★ 292
对话回退:一键回到任意更早的用户消息,同窗口内完成,不新建分支、不残留副本;目标消息自动填回输入框,可一并还原工作区文件——即完整的 Claude Code /rewind 语义。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。