[持续更新] DeepSeek Harness 插件实战指南共建与测试记录

[dnegxuantian]

DeepSeek Harness 刚开源，我最近看了几组公开测试，挑了两张比较直观的放上来。图片不是我跑的，只作为讨论参考。

第一张是同一个计时器任务的四组结果。截图里四组配置都通过了当前检查，这里只记录结果，不当成模型排名。

第二张是同一个游戏场景下，DeepSeek Harness、Reasonix 和 Codex 的结果对比。

我自己更关心的是插件。哪些可以直接安装，哪些会卡版本，遇到权限和依赖问题怎么处理，这些都需要有人实际用过再记录。

我建了一个群，叫 deepseek-harness 插件实验室。

群里准备一起编写《DeepSeek Harness：即插即用的实战指南》。现在只有大纲，先写安装启动、插件管理、权限报错和插件开发。后面的内容由群里的人一起补，尽量留下可以照着复现的步骤。

二维码放在第二条评论，手机上可以直接扫码。

如果你正在做插件，或者碰到装不上、跑不通的仓库，可以把链接和报错贴出来，大家一起看看。

这是社区自发交流，不代表 DeepSeek 官方。

[dnegxuantian]

先把《DeepSeek Harness：即插即用的实战指南》大纲放在这里，后面由群里的使用者一起补。

1. 安装启动与第一个任务
2. 插件目录、Manifest 和加载方式
3. 插件安装、更新、卸载与版本兼容
4. 常用插件的实际测试
5. 模型对比与复现方法
6. Shell、网络和数据权限
7. 常见报错与排查记录
8. 从零写一个插件
9. 插件安全与许可证
10. 社区实测清单与兼容表

不追求一次写完。先把真实遇到的问题记下来，再慢慢整理。

[dnegxuantian]

交流群二维码放这里，方便大家直接扫码。

群名：deepseek-harness 插件实验室

群里会同步插件实测、安装报错和《DeepSeek Harness：即插即用的实战指南》的共建进度。

二维码有效期到 8 月 21 日。过期后会在这条评论下面更新。

这是社区自发交流，不代表 DeepSeek 官方。

[xiaoxuanli-a]

+1 可以邀请一下吗

[tongwoojun]

群主，扫码进不了群了，需要邀请。 + 1

[Seanxyc]

+1 需要邀请

[Jeanne-jw]

+1求拉进群

[BiranLi]

+1，请帮忙邀请下

[wallfacers]

---

看到这帖子太巧了。DeepSeek Harness 刚开源，网上能查到的实战资料还很少，翻来覆去都是对着文档念的。你这种「先把真实遇到的问题记下来，再慢
慢整理」的思路我很支持，踩坑记录往往比官方文档有用多了。

大纲里我比较关注插件安装和权限这两块（第 3、6 条），正好最近在折腾权限报错的问题。第 4
条常用插件实测也能一起补，不过想问下：是每个人各自装一遍记录结果，还是有统一的测试标准？不然结果不太好互相对照。

---

[Electricitysheep]

插件实战指南共建这个方向好——同一任务多组配置的对比记录正是社区最缺的实测数据（比纯教程有价值）。

和我们手册第 10 章案例的结构（任务→配置→结果→观察）可以互相补充，欢迎来手册共建或投稿社区案例：Electricitysheep/dsh-handbook#12

[oliblue-evan]

你没发现他的图片是AI 生成的嘛。

[dnegxuantian]

看到一个刚发布的批量任务插件 dsh-batch-pipeline：负责记录进度、断点续跑、预算上限和产物检查。这里只登记公开信息，我还没实际跑过，稳定性先不下结论。

原帖：#1553

[dnegxuantian]

看到一份 Android/Termux 适配记录：作者称需要修补 node-pty、koffi、sharp、HMR 和会话持久化五处问题，并提供了一键安装仓库。我没有复现，先留作环境适配线索。

原帖：#1588

[dnegxuantian]

看到一个把 DSH 接进 Cursor/Codex 的集成包，作者给了 MCP 与 headless CLI 两条路径，也提醒 pnpm 11 下原先的 git 直装语法无效。我没有安装验证，先记录方案和勘误。

原帖：#1608

[sbsbsbsbsbsbsbsbsbsbsbsbsbsbsbsbsbsbsb]

DeepSeek Harness 插件是灵魂 一周肯定会进化并且超过codex
我愿意加入实战指南 参与agi

[sjh9714]

dsh-clippy，回形针办公助手宠物。订阅核心会话事件，思考时歪头，执行工具时显示工具名，回合完成跳起庆祝，回合失败弹出经典 "Your agent has performed an illegal operation" 对话框。

安装 npx @deepseek-ai/dsh plugin --profile web add dsh-clippy（npm 包，含构建产物，rc.6 实测可用）。

仓库和演示 GIF https://github.com/sjh9714/clippy-harness 。欢迎收录测试。

[xiaohegugaga]

好的 已经同步给大家

[sjh9714]

谢谢同步！有任何安装问题，或者想给回形针加的台词，随时在这里或仓库 issue 告诉我。

[kestiny18]

这个帖子很适合补一个实际插件案例，我这边也贡献一个已经跑通的：

dsh-usage — DeepSeek Harness 的 Token 用量与费用统计插件

主要解决 Harness 使用过程中一个比较实际的问题：到底每轮对话、每个 Session、每个模型用了多少 Token，Cache 命中了多少，以及大概花了多少钱。

目前支持：

• 每轮对话展示 Total · Input · Cache · Output · Cost
• Settings → Usage 独立统计页面
• 按模型 / Session / Turn 查看用量
• GitHub Contributions 风格的 52 周用量热力图
• 基于 Harness 自己的持久化 Session Log 统计，不额外维护一套数据库

当前版本 v0.1.1，源码和安装文档已经公开：

https://github.com/kestiny18/dsh-plugins/tree/main/dsh-usage

原来的介绍和讨论在：

#1169

安装的话目前最省事的是：

npx --yes --package=@deepseek-ai/dsh --package=pnpm@11.7.0 -- dsh plugin --profile web add dsh-usage

Node.js 需要 >=22.18，安装后重启 Harness Web 即可。

如果你们后面整理「常用插件实测」或者「社区实测清单与兼容表」，可以把这个作为一个案例。我也可以把实际安装环境、测试项、已知边界整理成统一格式补进来。

[dnegxuantian]

感谢 同步到群里

[sjh9714]

从 Claude Code 过来的同学可以试试 npx dsh-movein，一条命令把技能、MCP、hooks、全局指令整套搬进 DSH。项目里的 CLAUDE.md 甚至不用搬，DSH 原生就读。默认 dry run 先出搬家清单，加 --apply 才落地，重复执行安全。仓库 https://github.com/sjh9714/dsh-movein

[dnegxuantian]

感谢 准备反馈到群里

[sjh9714]

提交一个 Windows 向的条目，dsh-win32，让极简模式在 Windows 上能跑。

• 解决什么。官方运行时在 win32 上起 PTY 前先抛 terminal inspection is unsupported on platform win32，持久 shell 和极简模式整个不可用。dsh-win32 补上 win32 进程探测器（CIM + taskkill），并提供 minimal-windows 预设（唯一改动是 PTY shell 换成 Git Bash）。v0.2 又补了 Ctrl-C 注入，取消长命令不再把会话打崩。
• 安装。dsh plugin --profile web add dsh-win32 加 npx dsh-win32 setup
• 实测方式。windows-latest CI 上跨调用状态保留（先 STATE=x 再 echo $STATE）与中断 exit 130 都有公开记录，欢迎实测回帖。
• 已知限制。ACL 沙箱下未验证。SIGTERM/SIGKILL 对前台进程仍不支持（如实报错）。

https://github.com/sjh9714/dsh-win32

[dnegxuantian]

DSH 社区问题速报｜8 月 15 日

今天 GitHub Discussions 里的问题比较多。合并重复反馈、去掉暂时没有解决办法的帖子后，整理出下面 9 类：

1. 安装插件后工具调用报错

问题： 工具调用报 prepare undefined，随后 Session 提示 tool_call 未配对。

解决办法： 先移除最近安装的插件并重开会话；需要保留插件时，按原帖方法让 profile 共用宿主 dsh-tools。

原帖：
#1697

2. 自启动插件导致 Web 无法启动

问题： AI 生成的自启动插件导致 Web 卡在 Failed to load plugins。

解决办法： 先从 web profile 移除插件；开发插件时，把 client 服务依赖放到 dsh.client.inject。

原帖：
#1947

3. Windows 无法选择文件夹

问题： 点击“选择文件夹”时报 worker exited before reporting a result。

解决办法： 使用原帖中的 browse-picker patch，改用应用内目录选择器，然后重启 Web。

原帖：
#1658

4. Windows minimal 模式无法执行命令

问题： minimal 模式找不到 /bin/bash。

解决办法： 把 shellPath 指向 Git Bash 的绝对路径，或者先改用 standard 模式。

原帖：
#1856

5. 内网访问报 randomUUID 错误

问题： 通过内网 HTTP 访问 DSH，报 crypto.randomUUID is not a function。

解决办法： 优先使用 HTTPS 反向代理或 localhost，等待官方补充 UUID fallback。

原帖：
#1919

6. 长对话超过上下文上限

问题： 长对话超过模型上下文上限，返回 400 错误。

解决办法： 降低 max_tokens，执行 /compact；仍然超限就新建会话，只带必要信息。

原帖：
#1930

7. MSYS2 启动后直接退出

问题： 在 MSYS2 中运行 dsh web 没有输出，直接退出 127。

解决办法： 改用原生 PowerShell 或命令提示符，通过系统 Node 启动。

原帖：
#1624

8. GLM 视觉模型无法识图

问题： 接入 GLM 视觉模型后，Web 端仍提示当前模型不能识图。

解决办法： 安装 dsh-plugin-multimodal，并把 DSH_VISION_MODEL 配置成真实的视觉模型。

原帖：
#1765

9. JSON.parse 报 Unexpected token

问题： 启动时报 Unexpected token，左花括号前有隐藏字符。

解决办法： 把 ~/.dsh/profiles/web/package.json 重新保存为 UTF-8 无 BOM。

原帖：
#1903

---

以上主要是社区验证过的办法或临时绕过，不代表官方已经修复。修改 profile 或 Session 前请先备份。

插件安全提醒

试用社区插件前，建议先检查源码、作者、依赖和所需权限。

以下插件建议不要直接安装：

• 来路不明或代码经过混淆；
• 只提供安装包，没有公开源码；
• 要求读取 API Key、环境变量或无关目录；
• 要求不必要的网络、命令执行或全盘访问权限。

尽量先在新 profile、测试项目或虚拟机中运行，不要直接安装到工作环境，避免插件投毒。

[Electricitysheep]

哈哈，被看出来了——那两张图确实不是实测截图。帖主也标了"图片不是我跑的，只作讨论参考"，我们手册收案例的原则也是"实测优先 + 来源标注"，虚构的东西会误导后来人。

[dnegxuantian]

这么点字也需要ai帮你生成么？而且也看出来你到底想表达什么？

[weijiafu14]

给“常用插件实测 / 兼容表”补一个已经按真实 DSH loop 验证过的生态桥案例：pi2dsh 0.11.0。它不是再造一套插件市场，而是让现有 Pi npm 扩展按原包进入 DSH：

dsh plugin --profile web add pi2dsh@0.11.0
dsh plugin --profile web add <Pi-package>

安装不需要 convert、手写 bundle 或改 Harness 源码。当前已经在 DSH 官方 CLI/Web surface 做过真实闭环的代表场景包括：

• @kassing/pi-vision：图片经独立视觉端点分析后注入，文本 route 继续只收文本；
• pi-vision-tool：Agent 按需调用路径型 describe_image；
• @tintinweb/pi-subagents：不同模型/工具的真实 DSH child session，支持并行、后台结果取回和 steer；
• @juicesharp/rpiv-web-tools：独立 SearXNG web_search/web_fetch；
• pi-hermes-memory：跨进程写入/检索长期记忆；
• pi-btw：不污染主线程的旁路问答，按需 inject/save。

项目、当前安装说明和复现入口在：https://github.com/weijiafu14/pi2dsh

如果你们的指南按“安装命令 → 实测环境 → 用户动作 → DSH 原生可见证据 → 已验证范围”收案例，这个项目可以直接作为“把一个成熟外部插件生态接入 DSH”的样本。视觉 Web 实测材料在：https://github.com/weijiafu14/pi2dsh/tree/main/examples/vision-bridge

[Wha1eChai]

评论区怎么全是人机

[sjh9714]

给「权限报错」那节补一条 Windows 的。先说明这是我自己的插件，不是第三方评测。

Windows 上极简模式起不来，报错是这个。

terminal inspection is unsupported on platform win32

重装 node-pty 没用。调用顺序是先拿 inspector 再 spawn PTY，inspector 在前，所以根本轮不到 node-pty。

沙箱里还有一层。 workspace-write 用受限令牌，Git Bash 这类 MSYS shell 在 cygheap 初始化就死。

cygheap_user::init: NtSetInformationToken (TokenDefaultDacl), 0xC0000022
CreateFileMapping ... Win32 error 5

两个签名是同一堵墙。这解释了为什么现有 Windows 方案都要求 danger-full-access。

装法。

npx dsh-win32 setup              # 选「Minimal (Windows)」，需要 danger-full-access
npx dsh-win32 setup --sandboxed  # 选「Minimal (Windows, sandboxed)」，busybox ash，沙箱内可用

前置是 Git for Windows。pnpm 也要，因为 dsh plugin add 用它装进 profile 目录，setup 会用 corepack 自动启用。

给兼容表的两条实测。

• 当天发布的版本，升级的人大概一天内装不上。profile 的 pnpm-workspace.yaml 里 minimumReleaseAgeExclude 只写了接线时的那个版本，新版本被最小发布时长门禁挡掉，pnpm 回答 Already up to date。这不是这个插件特有的，任何插件都一样。
• npx dsh-win32 doctor --json 输出社区 dsh-doctor/v1 信封（💡 Idea: Add 'dsh doctor' CLI command for environment & dependency diagnostics #1719，r5 已冻结，三个实现共用）。退出码 0 全通过 / 1 有 warn / 2 有 fail，可以直接进 CI 脚本。

https://github.com/sjh9714/dsh-win32

[dnegxuantian]

支持！！

[Electricitysheep]

抱歉让你有这种感受。那条回复确实简短了些——本意是补充一句"图片非实测、手册收案例要求来源标注"的提醒，没表达清楚是我的问题。如果你想讨论帖主那几张图的真实性或测试方法，欢迎细聊。

[dnegxuantian]

麻烦查找一下本地模型的key 存在哪里？找不到了。