Codex 风格编码台 yukitakasama/better-deepseek-harness-codex

更好的 deepseek harness（codex 风格）

面向 Coding 用户的 DeepSeek Harness 整合包，向 Codex 的风格与功能看齐。
基座 DSH 0.2.1-rc.2（v3.0.0 起；上一版为 0.2.0-rc.2）。

整合包标识 better-deepseek-harness-codex（仓库名 / .dspack 前缀 / profile 名）。
社区整合包，非 DeepSeek 官方产品。

⚠️ v3.0.0 是破坏性更新（预发布）

- 基座 0.2.0-rc.2 → 0.2.1-rc.2：跨小版本换宿主，所有插件的 peer 门禁都会重判，旧版插件集不能原样搬过去。
- 只挂载「上游明确声明适配 0.2.1-rc.2」的 11 个插件；另外 13 个插件随包安装但暂不挂载——它们被移出 dsh.profile.bundles，同时它们在 overrides/cordis.patch.yml 里的行被 disabled: true 关掉（patch 层独立于 bundles 生效，不关就会绕过后面的屏蔽把模块重新拉起来）。
- 建议新建 profile 安装，不要原地覆盖 v2.x：插件集只重叠一半，旧配置未必对得上。
- 重新启用某个被屏蔽插件：把它加回 package.json → dsh.profile.bundles，删掉 overrides/cordis.patch.yml 里对应条目的 disabled: true，再确认上游已把 0.2.1-rc.2 写进 peer 范围或 dsh.compatibility.dshReleases。
- 逐插件判定依据（peer 矩阵 / dshReleases / engines.dsh / README / release notes）见 docs/release-notes-v3.0.0.md。

装什么（本版实际挂载的 11 个插件）

一条命令拿到 Codex 式编码工作台的核心部分：

- Codex 风格界面 —— 工作区会话树、全局搜索、轮次跳转、会话重命名/归档/分叉（@michengai/dsh-codex-ui 1.1.47）
- 代码审查与简化 —— /review 调独立子 Agent 审代码，/simplify 按 Git 变更范围简化（1.0.1 / 1.0.1）
- 只读旁问 —— 基于当前上下文单独提问，不打断主任务（@michengai/dsh-btw 1.0.4）
- 费用与余额 —— 本会话/当日费用、模型价格、Coding Plan 额度、余额（dsh-cost-meter 1.9.30）
- 桌宠 —— dsh-pet 蓝色大肥鱼：97 段透明动画、待机呼吸、屏幕漫游、拖拽甩抛、可多开同屏，还能落到桌面做透明置顶小窗（dsh-pet 0.3.8）
- Git 图 —— 分支选择与提交图（@linxin666/dsh-client-ui-git-graph 0.4.8）
- 上下文仪表盘 —— dsh-context 上下文可视化（0.74.0）
- 多智能体协作 —— agent-teams 多 Agent 团队协作（@nanmicoder/dsh-agent-teams 0.1.26）
- 子代理选模型 —— subagent-director 为每个子代理独立指定模型（0.6.0-beta.2，上游当前 latest 就是 beta）
- WorkBuddy 模型接入 —— dsh-workbuddy-connect 复用 WorkBuddy 桌面 App 的登录态，GLM-5.3、DeepSeek-V4、Kimi-K3、MiniMax-M3、Hy3 等直接出现在模型选择器中，零配置；本机没装/没登录时该分组自动隐藏，不影响启动（0.7.9）
- 自带 50 个 skill —— 安装即落入 DSH_HOME/skills/，开箱即用（覆盖设计/前端、动效、数据分析、代码开发、办公文档、浏览器自动化（含 ego-lite 的 ego-browser）等；MCP 服务器本次未随包分发，按本机 cordis.patch.yml 单独配置）

本版暂屏蔽（随包安装、但不挂载）

这些插件的上游尚未明确声明适配 DSH 0.2.1-rc.2（或已明确不适配），为避免门禁拒装/启动崩溃，本版不加载它们；需要时按上面的步骤逐个启用并自行验证。

| 插件 | 随包版本 | 屏蔽原因 |
| dsh-ops | 0.3.0 | 上游 0.4.1 仅以 ^0.2.0-rc.2 范围覆盖，未点名 rc.2 |
| @goodandready/dsh-context-lens | 0.1.28 | 仅范围覆盖（^0.1.7-rc.2 \|\| ^0.2.0-rc.1） |
| @goodandready/dsh-key-limits | 0.2.19 | 无任何 @deepseek-ai/dsh- peer 声明 → 无法确认 |
| dsh-plugin-wallpaper-engine | 1.2.0 | 仅范围覆盖（>=0.2.0-rc.1）；且 1.4.0 已拆成 8 个包，属结构性变更 |
| @modusensus/dsh-mneme | 0.8.13 | 仅范围覆盖；0.9.4 新增 dsh-better-sidebar peer |
| @mrweicodes/dsh-loop-guard | 1.0.8 | 仅范围覆盖，上游 2026-10-09 后无更新 |
| dsh-computer-use-win | 0.2.3 | 无 @deepseek-ai/dsh- peer 声明 → 无法确认 |
| dsh-computer-use | fork 72f390a | peer 全为 通配、无 compat 声明，上游停更于 2026-09-15 |
| dsh-prompt | 0.3.0 | 仅 engines.dsh >=0.2.0-rc.2 范围覆盖，未点名 rc |
| @liustack/modlens | 3.26.6 | 无任何 peer / engines 声明 → 无法确认 |
| dsh-effort-slider | 1.3.1 | 无任何兼容声明，上游 2026-09-26 后停更 → 无法确认 |
| dsh-agent-arena | fork 25e2c55 | 上游 Tikzen 0.7.0 精确钉 0.2.0-rc.2 → 未适配 |
| @tencent-connect/dsh-qqbot | fork 7e88006 | 仅范围覆盖（>=0.1.0-rc.6），上游 0.5.2 同样未点名 rc.2 |

安装

需要 DSH 0.2.1-rc.2（本包 dshVersion 精确锁定该版本；v3.0.0 起不再声明兼容 0.2.0.x）。

dsh --profile better-deepseek-harness-codex

或由 DSH 启动器导入 .dspack。

注意（git 依赖）：本包仍有 3 个 git 依赖（dsh-computer-use、dsh-agent-arena、@tencent-connect/dsh-qqbot），安装时需能访问 GitHub。v3.0.0 起这 3 个都已暂屏蔽（不挂载），但仍留在 dependencies 里以便随时启用；若你的网络拉不动 git 依赖，可以把它们从 package.json 里一并删掉——挂载集不会受影响。

WorkBuddy 模型的前提：自 v2.7.0 起本包带 dsh-workbuddy-connect，它复用 WorkBuddy 桌面 App 的本机登录态，所以要看到 WorkBuddy 模型分组，需要先安装并登录 WorkBuddy（国内版或国际版 WorkBuddy AI 均可）。没装也不影响本包启动——对应分组直接隐藏，其余插件照旧。详见下方「WorkBuddy 模型接入」。

v2.0.0 变更说明

重大变更

- 基座升级：从 DSH 0.1.7-rc.2 升级到 0.2.0-rc.2
- 移除插件：dsh-plugin-edit-message（无 0.2.x 兼容版本）
- 全部插件更新：10 个插件全部更新到支持 0.2.0-rc.2 的最新版本

插件清单变更（10 个，全部钉死精确版本）

| 插件 | v1.1.0 版本 | v2.0.0 版本 | 变化 |
| @michengai/dsh-codex-ui | 1.1.18 | 1.1.25 | ↑ 7 个小版本 |
| @michengai/dsh-code-review | 0.1.7 | 0.1.9 | ↑ 2 个小版本 |
| @michengai/dsh-simplify | 0.1.10 | 0.1.12 | ↑ 2 个小版本 |
| @michengai/dsh-btw | 0.1.13 | 0.1.15 | ↑ 2 个小版本 |
| dsh-effort-slider | 1.2.0 | 1.3.1 | ↑ 次版本 |
| dsh-cost-meter | 1.7.37 | 1.7.47 | ↑ 10 个小版本 |
| dsh-whale-girl-pet | 0.3.4 | 0.3.7 | ↑ 3 个小版本 |
| @goodandready/dsh-context-lens | 0.1.24 | 0.1.28 | ↑ 4 个小版本 |
| @linxin666/dsh-client-ui-git-graph | 0.4.2 | 0.4.4 | ↑ 2 个小版本 |
| dsh-computer-use-win | 0.1.2 | 0.2.3 | ↑ 次版本 + 1 个小版本 |
| dsh-plugin-edit-message | 0.1.5 | 已移除 | 无 0.2.x 兼容版本 |

新增字段（manifest v5）

- dshVersions: 声明实测兼容版本集合（0.2.0-rc.2、0.2.0-rc.1）
- launchers: 声明启动器兼容性（dshl、dsh-packforge-app）

插件清单（随包 24 个；本版挂载 11 个）

已挂载（在 dsh.profile.bundles 里）

| 插件 | 版本 | 作用 | 上游声明依据 |
| @michengai/dsh-codex-ui | 1.1.47 | Codex 风格侧栏、工作区会话树、全局搜索、轮次导航 | peer 矩阵枚举 0.2.1-rc.2；README 称 1.1.42 起显式支持 |
| @michengai/dsh-code-review | 1.0.1 | /review 独立子 Agent 代码审查 | peer 矩阵枚举 + README badge「up to 0.2.1-rc.2」 |
| @michengai/dsh-simplify | 1.0.1 | /simplify Git 范围代码简化 | peer 矩阵枚举 0.2.1-rc.2 |
| @michengai/dsh-btw | 1.0.4 | 只读旁问，不打断主任务 | peer 矩阵枚举 + README 称 1.0.0 起在 rc.1/rc.2 实测 |
| dsh-cost-meter | 1.9.30 | 费用统计、模型价格、Coding Plan 额度、余额 | dsh.compatibility.dshReleases 含 rc.2；README 标注适配目标 rc.2 |
| dsh-context | 0.74.0 | 上下文可视化仪表盘 | dshReleases 显式 0.2.1-rc.2 = compatible |
| dsh-pet | 0.3.8 | 桌宠：蓝色大肥鱼，97 段透明动画、可多开、可落桌面独立小窗 | dshReleases 显式 rc.2 = compatible |
| @linxin666/dsh-client-ui-git-graph | 0.4.8 | Git 分支图 | dsh.engines.dsh >=0.2.1-rc.2 + v0.4.7 发行说明点名 rc.2 |
| @nanmicoder/dsh-agent-teams | 0.1.26 | 多智能体团队协作 | 21 个 peer 精确枚举 rc.2；README「推荐 rc.2 + 0.1.26」 |
| dsh-plugin-subagent-director | 0.6.0-beta.2 | 子代理独立选模型 | dshReleases rc.1/rc.2 = compatible；engines.dsh >=0.2.1-rc.1（beta） |
| dsh-workbuddy-connect | 0.7.9 | WorkBuddy 桌面端模型接入（未登录自动隐藏分组） | 6 个 peer 精确钉 0.2.1-rc.2 |

⚠️ dsh-workbuddy-connect 上游已停止维护（npm deprecated：「因个人精力有限，本项目已停止维护」）。
本版仍挂载它，因为 0.7.9 的 peer 精确钉 0.2.1-rc.2、属明确声明；但它今后不会再有更新，若某次宿主升级后掉队，只能本包 fork 或直接移除（移除只需从 bundles 去掉，不用动 patch 层）。

层栈顺序：@deepseek-ai/dsh-base → @deepseek-ai/dsh-web-app → 上表顺序（@michengai/dsh-codex-ui 固定在末位，由它最后接管侧栏与设置页）。

暂屏蔽的 13 个插件（随包安装但不挂载、原因与重新启用步骤）见上方「本版暂屏蔽」表格。

上游明确不适配的两个历史项

- dsh-agent-arena：上游 Tikzen 0.7.0 的 10 个 peer 精确钉 0.2.0-rc.2，在 0.2.1-rc.2 下必被门禁拒装；本包此前靠自维护 fork 放开 peer 才装得上，本版一并屏蔽。
- dsh-computer-use：peer 全为 通配，不会被门禁拦，但也不会被「拦」这件事说明任何问题；上游 2026-09-15 后无提交，本版屏蔽（连带 preset-computer-use 与它的 MCP client 行）。

Codex 风格 Computer Use（dsh-computer-use）

v3.0.0 状态：暂屏蔽（不挂载） —— 上游尚未明确声明适配 DSH 0.2.1-rc.2，本版不加载该插件。本节内容保留，供你按「本版暂屏蔽」里的步骤重新启用时参考。

上游： wushi2333/dsh-computer-use_codex-style，按提交精确钉死（#72f390a），未做任何源码修改。

它把能力拆成两个平面，本包两层都接上了：

| 平面 | 行 | 由谁提供 |
| HOST（进程级桌面 sidecar：指针、覆盖层、截图、批准、回合生命周期） | computer-use | 插件自带的 cordis.patch.yml |
| PRESET（13 个 window2 工具） | tool-computer-use | 本包的 overrides/cordis.patch.yml |

为什么整合包要补第二层：上游插件只带 HOST 那一行——它的注释写明「Tools stay in the user agent preset so standard coding sessions do not get the mouse」。
工具行必须挂在 agent preset 里才对模型可见，所以本包新增了一个 computer-use preset：

普通编码会话（standard / ptc）永远不会拿到鼠标；只有显式选「Computer Use」 preset 新建的会话才有桌面工具。

技术细节：这一层用 - insert: 新增一个 preset，而不是往 preset-standard 里塞行。
loader patch 对已存在的 preset 条目是「整体替换它的 plugins 数组」而非追加——实测只要对 preset-standard 写一次 config.plugins，标准 preset 的 32 行会被压缩成你写的那几行，等于废掉整个默认工作台。新增 preset 则完全不碰既有预设（实测四个官方 preset 行数不变）。

不要在同一会话里同时驱动桌面：dsh-computer-use-win（22 工具的 extension 方案）与本插件可以共存，工具名与挂载方式都不同，但两套指针/覆盖层同时跑会互相打架。
日常桌面操控建议只用其中一个。

随包投递 computer-use 与 computer-use-browser 两个 skill（落入 DSH_HOME/skills/）。

QQ 机器人频道（im-qqbot）

v3.0.0 状态：暂屏蔽（不挂载） —— 上游尚未明确声明适配 DSH 0.2.1-rc.2，本版不加载该插件。本节内容保留，供你按「本版暂屏蔽」里的步骤重新启用时参考。

本插件默认关闭。原因是原版在凭据缺失时会于插件加载阶段同步等待扫码，而那个 Promise 没有超时、二维码过期只会不断刷新——cordis 串行加载插件，于是整个 dsh 实例永远停在「等待就绪」（启动器表现为启动窗口一直转圈、Web 服务始终不监听）。

本包已改用 fork 版 yukitakasama/dsh-qqbot（凭据缺失时跳过而非阻塞），并默认保持关闭：需要时再打开，不必为一个没配凭据的频道付出加载成本。

启用前先准备凭据（二选一）：

1. 免扫码：在 QQ 开放平台创建机器人，拿到 AppID / AppSecret，填入启动器「实例 → 环境变量」：QQBOT_APPID、QQBOT_SECRET。
2. 扫码：在 profile 目录下跑一次 npx dsh-qqbot-bind（首次出码会同时用默认浏览器打开扫码页），凭据会自动写入 cordis.patch.yml。

然后启用并重启：启动器「插件」页把 im-qqbot 设为启用，重启实例后生效（插件开关与环境变量都只在进程启动时读取，不支持热启用）。

WorkBuddy 模型接入（dsh-workbuddy-connect）

上游：corrinehu/dsh-workbuddy-connect，钉 npm 0.7.1（当前稳定版），未做任何源码修改。

它把 WorkBuddy 桌面 App 里的模型（GLM-5.3、GLM-5.2、GLM-5.3-Flash、DeepSeek-V4-Pro/Flash、 Kimi-K3、MiniMax-M3、Hy3 等）注册成 DSH 的一个 LLM provider（llm-workbuddy），于是这些模型直接出现在模型选择器与 /model 弹窗里，不需要另外申请 API key。
- 凭据来自本机 App —— 插件复用 WorkBuddy 桌面端的登录态，不自建 OAuth 流程；你在 App 里切换账号，DSH 这边跟着切。Windows 上先查 %LOCALAPPDATA%\Programs\WorkBuddy\WorkBuddy.exe，再查卸载注册表来定位解密程序；国际版（WorkBuddy AI）只查注册表。
- 国内版 / 国际版互不混用 —— 各成一个分组（「WorkBuddy」/「WorkBuddy AI」），各看自己那版 App 的登录状态，模型、账号、积分彼此独立。
- 未登录时不打扰 —— 某版 App 从未登录、也没留下插件自留副本时，该版分组不再显示（0.7 起的行为变化：过去国内版会显示一份内置兜底列表，但那些模型选了必然报错）。因此没装 WorkBuddy 的用户装本包不会遇到任何启动报错（2026-10-07 实测：--dump-config 零 stderr、web 服务正常监听、界面无 WorkBuddy 分组）。控制台会多出一条 list slot "plugins.item" requires options.id——该报错不含本插件的基线同样存在（基线 2 条 / 含插件 3 条同类），属既有的插槽注册问题，不影响使用，详见「验证记录」。
- 能力面 —— 多数模型支持发图（GLM-5.3-Flash、GLM-5.2、DeepSeek-V4 系列等）；上游声明了档位的模型直接给出 low / high / max；模型名后显示积分倍率与促销徽章（限时免费、夜间折扣）；设置卡片可查看账号、令牌有效期、剩余积分与模型列表来源（实时 / 已保存 / 内置）。
- 计费走 WorkBuddy 积分，不是 API key 余额，因此与 dsh-cost-meter 的费用数字口径不同：cost-meter 按模型单价估算，WorkBuddy 侧实际扣的是积分倍率。

版本必须对得上：v3.0.0 用 dsh-workbuddy-connect@0.7.9，它的 6 个 @deepseek-ai/dsh- peer 精确钉 0.2.1-rc.2，与本包基座正好一致（上一版 0.7.1 钉的是 0.2.0-rc.2，换基座后会被整体跳过）。不匹配的组合会让 DSH 启动失败，上游 issue #63 即是插件被宿主跳过的案例；这也是本包把 dshVersion 精确锁在 0.2.1-rc.2 的原因之一。仍在 DSH 0.1.x 上的人需要 0.6.5。

另外，该插件是 web 平台注入（dsh.client.platform: web，客户端注入 model-selection 等六个官方包），与本包的 web 基座匹配。若你想把它单独装进 TUI profile，需要 @deepseek-harness-tui/dsh-tui ≥ 0.10.0-beta.5，更早版本装了会启动失败（报 events is not iterable）。

原生高性能工具链（dsh-ops）

v3.0.0 状态：暂屏蔽（不挂载） —— 上游尚未明确声明适配 DSH 0.2.1-rc.2，本版不加载该插件。本节内容保留，供你按「本版暂屏蔽」里的步骤重新启用时参考。

上游：T-Auto/dsh-ops，钉 npm 0.3.0（registry 最新版；上游 0.3.1 只发了 GitHub Release、未 npm publish，故取 0.3.0），未做任何源码修改。

它提供一组常驻工具，由 Rust 编写、经宿主 subprocess 执行固定 worker，不运行模型代码：

- 四个文件工具 —— ops_inspect_local_file（有界 UTF-8 文本行 / hex 视图）、ops_grep（Rust 正则搜索，多文件过滤、计数与摘要）、ops_glob（多模式找路径，支持排除）、ops_replace（跨文件字面文本批量替换，精确编辑仍用宿主 edit）
- ops_bash —— 优先的通用命令执行器；短命令用 command，长脚本（heredoc、引号、反斜杠、中文）先写文件再传 script_path，避免多层 JSON 转义
- 随包 PowerShell 7 —— Windows 原生 cmdlet / 注册表 / 服务走宿主 pwsh 工具，由插件在执行期指向自带的 7.6.6

工具以 ops_ 前缀出现，与宿主 read / edit / pwsh 等并存不冲突：文件读取与替换会登记到宿主的「先读后改」观测表，用 OPS 读过的文件可直接用宿主 edit。

组件开关（dsh-ops/shell、dsh-ops/file 默认开；dsh-ops/ptc、dsh-ops/tui 默认关）：

| 组件 | 默认 | 作用 |
| dsh-ops/shell | 开 | ops_bash + 随包 PowerShell 7 |
| dsh-ops/file | 开 | 四个 Rust 文件工具 |
| dsh-ops/ptc | 关 | 原生 PTC 批处理（ops_batch / ops_result），仅纯 PTC 会话 |
| dsh-ops/tui | 关 | dsh-TUI 只读侧栏 |
| dsh-ops/hide-official | 关 | 遮蔽官方工具（0.3.0 的 bundle patch 未插入该行） |

关于 Windows 上的 bash：受限模式（workspace-write / read-only）下 ops_bash 只运行已校验 IPC 兼容的随包 MSYS 副本；指向自己的 Git for Windows 会按设计返回 EXECUTOR_UNAVAILABLE，不会裸执行。danger-full-access 下可用 bashPath 指定执行器。

ego-lite 浏览器自动化（ego-browser skill）

上游：citrolabs/ego-lite v2.1.0。ego-lite 是给 AI 智能体用的 Chromium：智能体直接复用你已登录的浏览器状态去开网页、填表、点击、截图、取数据，不另开一个空白浏览器，也不打断你手上的操作。

为什么用技能，而不是加一条插件依赖：上游给 DSH 准备的入口是 plugins/ego（包名 @citrolabs/ego），它只做一件事——把随包的 ego-browser 技能注册成技能服务商。
但该目录里的 skills/ego-browser 在 git 里是软链（指回仓库根的 skills/ego-browser），
npm / pnpm 打包 git 依赖时会丢掉软链，装出来的包缺 SKILL.md，插件模块在 import 阶段直接
ENOENT（本机实测：pnpm add github:citrolabs/ego-lite#path:/plugins/ego 能装上 @citrolabs/ego@2.1.0，但 import('@citrolabs/ego/dsh') 抛 ENOENT ... skills/ego-browser/SKILL.md）；上游 README 自己也写明「npm omits the linked Skill when packing the source directly」，而 DSH 侧的官方分发物（@citrolabs/ego-deepseek-harness tgz）只存在于其打包脚本产物中，未上 npm。

所以本包直接把同一份 skills/ego-browser/（取自仓库 tag v2.1.0，含 references/、 scripts/、learnings/、assets/）随 home/skills/ 投递到 DSH_HOME/skills/ego-browser/ ——效果与装那个插件等价（插件本身就是一个技能服务商，没有额外 UI/工具），且不依赖 git 打包行为。等上游把 @citrolabs/ego-deepseek-harness 发上 npm 后，可改回插件依赖形态。

第一次用之前要装 ego lite 本体（ego-browser 命令由桌面 App 提供）：macOS 可用技能自带的 scripts/install.sh（步骤见 references/install.md）；Windows 没有安装脚本，需到 <https://lite.ego.app/> 下载安装包手动安装，完成一次性引导（onboarding）后才会把 ego-browser 写进 PATH，且只有引导之后新开的终端才认得这个命令。本包只投递技能文本与小图（约 90 KB），不含浏览器二进制。

Computer Use 说明

v3.0.0 状态：暂屏蔽（不挂载） —— 上游尚未明确声明适配 DSH 0.2.1-rc.2，本版不加载该插件。本节内容保留，供你按「本版暂屏蔽」里的步骤重新启用时参考。

dsh-computer-use-win 通过 DSH 内置的 @deepseek-ai/dsh-mcp-client 桥接一个 MCP stdio 服务器，工具以 mcp__wincu__windows_computer_use_ 出现：

- 看：UIA 无障碍树（control/content/raw 三视图）、窗口裁剪截图（PrintWindow → WGC → 屏幕区域三级回退）、OCR 词框
- 做：鼠标（标准/双击/拖拽/滚动）、键盘、UIA 语义动作、窗口管理
- 安全：急停 failsafe（鼠标停屏幕角落 500ms 拒所有输入）、前台校验 fail-closed、identity guard（HWND/PID 变化即拒）、Win 键组合黑名单

零运行时依赖（纯 Node 内置模块 + PowerShell/C# UIA 后端）。

本包已修正该插件的 MCP 路径 bug（见下），否则它在本整合包内无法启动。

已知上游 bug 与修正

dsh-computer-use-win@0.1.2 的 MCP 路径解析

该插件自带的 cordis.patch.yml 用 new URL('mcp/server.mjs', baseUrl) 定位自己的 MCP 服务器，注释里假设 baseUrl 是该 patch 文件所在目录。但 dsh 实际把 baseUrl 设为 profile 根目录：

// dsh-app-boot: ctx.baseUrl = pathToFileURL(dirname(absoluteConfigPath)).href + "/"

后果：单包 profile 下恰好能跑（包目录 ≈ profile 根），但在多插件 profile 里解析成 <profile>/mcp/server.mjs → MODULE_NOT_FOUND，MCP 起不来，模型看不到 mcp__wincu__ 工具。实测 boot 日志报错即为此。

本包修法：在 profile patch 层覆盖该行的 args，改用相对 profile 根（即 node_modules 所在处）的路径：

- id: mcp-dsh-computer-use-win
name: "@deepseek-ai/dsh-mcp-client"
config:
serverName: wincu
transport: stdio
command: !!js process.execPath
args:
- !!js "process.getBuiltinModule('node:url').fileURLToPath(new URL('node_modules/dsh-computer-use-win/mcp/server.mjs', baseUrl))"
toolCallTimeoutMs: 60000
failOnStartupError: false

修复后 boot 日志出现 windows-computer-use MCP server 0.1.2 ready。
若上游修好此 bug，可以删掉这条补丁。

dsh-computer-use 的 sidecar 在非 Windows 上启动即崩（v2.7.1 起已守卫）

该插件（钉上游提交 72f390a）的 Python sidecar 入口 cli.py:51 无条件 from computer_use.win_dpi import enable_dpi_awareness，而 win_dpi.py:13 在 模块顶层执行 ctypes.WinDLL("user32", …) —— 这个属性只有 Windows 的 ctypes 才有，Linux / Android（proot）等平台一 import 就报 AttributeError: module 'ctypes' has no attribute 'WinDLL'。因为 failOnStartupError: false，启动不受影响，但每次启动都刷一整段 Traceback（issue #1，Android arm64 / proot Ubuntu 实测）。

本包修法（v2.7.1）：在 profile patch 层给两处加平台守卫，非 Windows 显式 disabled，Windows 上表达式求值为 false，行为不变（与 preset-computer-use 里 tool-pwsh 的既有模式一致）：

HOST 平面（上游插件自带 patch 以 insert 创建的 sidecar 行）
- id: computer-use
name: dsh-computer-use
disabled: !!js process.platform !== 'win32'

以及 preset-computer-use 内 tool-computer-use 行同款 disabled —— HOST 与 PRESET 两平面同开同关，普通编码会话本来就拿不到这些工具，非 Windows 上从「崩溃 + 刷屏」变成「安静地不可用」。修完后该能力仍仅限 Windows（这本来就是 sidecar 的平台边界），源码级修复走上游 PR；上游修好后可删掉这两条守卫。

选型说明

兼容性判定

DSH 用 semver.satisfies(版本, peer范围, { includePrerelease: true }) 校验，所以：

- >=0.1.0-rc.5 <0.2.0 这类宽范围 匹配 rc.2；
- 钉死精确版本（如 0.1.7-rc.1）的插件在 rc.2 上会硬失败，本包一律不选。

判定口径与宿主一致：semver.satisfies(宿主版本, peer范围, { includePrerelease: true })，宿主版本自 v3.0.0 起为 0.2.1-rc.2。

docs/compat-check.cjs 现在把 24 个插件分成两组录入：

- 已挂载 11 个 → 参与门禁，实测 11/11 通过（脚本 exit code 只看这一组）；
- 暂屏蔽 13 个 → 单列统计，不计入门禁。其中 6 个根本没有 @deepseek-ai/dsh peer 声明（无法确认），其余仅靠开区间「范围覆盖」而未被上游点名——这正是本版把它们移出 bundles 的原因。

v3.0.0 起的两处判定差异：① 少数上游（dsh-prompt、dsh-plugin-subagent-director、dsh-client-ui-git-graph）改用 dsh.engines.dsh 声明下限，而 DSH 0.2.1 线的 app-boot 兼容门优先读 engines.dsh；② 精确枚举型 peer（MichengAI 三件套、agent-teams、workbuddy）写死的是「已知 RC 白名单」，宿主一旦升到 0.2.1-rc.3 就会被整行禁用，必须等上游重发。

（历史记录）v2.7.0 新增的 dsh-workbuddy-connect@0.7.1 声明 7 个 @deepseek-ai/dsh- peer， 全部精确钉 0.2.0-rc.2，与本包基座逐一对上 → 7/7 ✅。非 dsh- 的 host peer 由基座树满足：@deepseek-ai/cordis ^4.0.2（宿主带 4.0.4）、@deepseek-ai/schemastery ^3.18.2 （web-app 带 ~3.18.4）、@earendil-works/pi-ai ^0.87.1（dsh-llm-pi-ai@0.2.0-rc.2 自身的依赖范围就是 ^0.87.1，不存在上游 issue #74 提到的两代混用）、react ^18.2.0 （与已真机实测的 dsh-codex-ui 同一 peer）。

跑 node docs/compat-check.cjs 会分别输出「在装插件 N/N 通过 ✅」与「候选池（未装）…」两行，只有前者决定门禁（脚本 exit code 也只跟前者走）。自 v2.7.0 起候选条目用 installed: false 标注，已移除的历史候选（dsh-edit-resend）不再把总结行染红。

冲突排除

- @michengai/dsh-codex-ui 会接管官方 ui-sidebar 与 ui-settings-general 并自行重建；它同时重新提供 sidebar.footer.action 与 settings.section，因此 dsh-cost-meter 的余额卡片和桌宠的设置分区仍有落点。
- 桌宠走浮动浮层，不争抢侧栏插槽。
- 没有装 dsh-better-sidebar / dsh-coding-sidebar——与 codex-ui 抢同一侧栏位置。
- 没有装 dsh-prompt-history——↑↓ 召回历史输入已由 codex-ui 自带。
- 桌宠只选 1 个（候选池 10+ 个全部抢同一浮层）。
- dsh-workbuddy-connect 不争抢 UI 插槽：它只注册一行 LLM provider（llm-workbuddy）并向官方 model-selection / conversation / renderer 等六个客户端包注入内容，侧栏与设置页仍归 codex-ui 接管；层栈中它排在 codex-ui 之前，保持「codex-ui 最后接管」的既有约定。
- 层栈中 codex-ui 排在最后，确保它的插槽接管生效于其他插件注册之后。

验证记录

v2.7.0 · 2026-10-07 实测（隔离安装真 @deepseek-ai/dsh@0.2.0-rc.2 CLI + 独立 DSH_HOME）

| 测试 | 结果 |
| peer 门禁 node docs/compat-check.cjs | 在装 13/13 ✅，exit 0；候选池 1 个不兼容（未装） |
| dsh --dump-config | exit 0、stderr 0 字节、stdout 1367 行 |
| 层栈完整性 | 参与测试的 23/23 bundle 全部出现在层栈中 |
| provider 行 | llm-workbuddy 由插件自带 bundle patch 注入，位于 codex-ui 之前 ✅ |
| 真实启动 web 服务 | 成功监听 http://127.0.0.1:3987，页面标题 DeepSeek Harness 正常渲染 |
| Computer Use MCP 启动 | windows-computer-use MCP server 0.2.3 ready（profile patch 的路径修正生效） |
| 未装 WorkBuddy 时的行为 | 模型选择器中无 WorkBuddy 分组、启动与界面均不受影响（与插件 0.7 起的「无凭据即隐藏」一致） |

测试范围的两个诚实边界：

1. 本次是 23 bundle（基座 + 21 个 npm 插件）而不是全部 26 —— 三个 git 依赖插件（dsh-computer-use、dsh-agent-arena、@tencent-connect/dsh-qqbot）在 Windows 上触发 pnpm 的 store 文件锁（[EBUSY] unlink …\store\v11\tmp\_tmp_\.git\FETCH_HEAD）导致 pnpm install 失败，两次尝试（共享 store 与独立 store）均复现。这三个插件本身在 v2.4.0 / v2.6.0 已分别真机验证过。
2. WorkBuddy 登录态下的功能冒烟（选模型、发图、积分显示、卡片）没有做 —— 本机未安装 WorkBuddy 桌面 App。

另记录一条与本包无关的现象：DSH 界面控制台有 list slot "plugins.item" requires options.id 报错， 不含新插件的基线同样出现（基线 2 条 / 含插件 3 条同类），属既有的插槽注册问题，非 v2.7.0 引入。

历史（v1.1.0 时代在 0.1.x 基座上的记录，仅作对照）

| 测试 | v1.1.0 结果 |
| 规格校验（pack-structure v3 + manifest v5 硬约束） | 30/30 PASS |
| evaluatePluginCompatibility() 实测 | 11/11 无阻断 |
| dsh --dump-config | exit 0，1303 行，零 stderr |
| 插件 MCP self-test | UIA 树 + 截图均 OK（2560×1600） |

自定义

profile patch 层 overrides/cordis.patch.yml 现有 5 条：dsh-computer-use-win 的 MCP 路径修正、 im-qqbot 默认关闭、computer-use preset 注入、dsh-ops 的 file/shell 配置记录、 pwsh-sandbox 的 Windows 平台守卫。其余挂载关系仍由各插件自身的 bundle patch 表达—— dsh-workbuddy-connect 的 provider 行、dsh-ops 的四个组件行同样由它们自带 patch 注册， 不需要在这里补条目。改动后请跑：

dsh --profile better-deepseek-harness-codex --dump-config

patch 对已存在条目是逐键覆盖而非深合并：只带 config: 不会清掉 disabled，但写了 disabled: 会整体替换。

许可与致谢

本整合包仅为插件组合与配置，不含上述插件的源码。各插件版权归其作者所有：

- MichengAI（Codex UI / Code Review / Simplify / BTW）
- goodandready（Context Lens）
- linxin666（Git Graph）
- corrinehu（WorkBuddy 模型接入）
- wushi2333（Codex 风格 Computer Use）
- T-Auto（原生高性能工具链 dsh-ops）
- PC2005-cloud（桌宠 dsh-pet）
- dsh-effort-slider、dsh-cost-meter、dsh-computer-use-win 各作者
- citrolabs（ego-lite / ego-browser skill，随包投递的 Skill 文本与图标版权归其所有，MIT）
- dsh-context、@modusensus/dsh-mneme、@liustack/modlens、dsh-prompt、 @nanmicoder/dsh-agent-teams、dsh-plugin-subagent-director、@goodandready/dsh-key-limits 等各作者
- fork 依赖 dsh-agent-arena、dsh-qqbot 由本仓库维护分叉，功能版权归上游原作者

格式规范：DSH-PackForge。

更新日志

v3.0.0 (2026-10-23)（破坏性更新 · 预发布 pre-release）

- 基座升级：DSH 0.2.0-rc.2 → 0.2.1-rc.2（npm latest 与官方最新 GitHub Release 两个口径一致；npm 同日的 next 是 0.2.1-rc.3，尚无 GitHub Release，本版不跟）。manifest.dshVersions 收敛为只声明 0.2.1-rc.2。
- 插件筛选挂载：按「上游是否明确声明适配 0.2.1-rc.2」重新分组—— 挂载 11 个（peer 矩阵精确枚举 rc.2 / dsh.compatibility.dshReleases 含 rc.2 / engines.dsh 点名）： @michengai/dsh-codex-ui 1.1.47、@michengai/dsh-code-review 1.0.1、@michengai/dsh-simplify 1.0.1、@michengai/dsh-btw 1.0.4、 dsh-cost-meter 1.9.30、dsh-context 0.74.0、dsh-pet 0.3.8、@linxin666/dsh-client-ui-git-graph 0.4.8、 @nanmicoder/dsh-agent-teams 0.1.26、dsh-plugin-subagent-director 0.6.0-beta.2（上游 latest 即 beta）、dsh-workbuddy-connect 0.7.9。
暂屏蔽 13 个（随包安装、移出 bundles、并禁用其在 patch 层的行）：dsh-ops、@goodandready/dsh-context-lens、@goodandready/dsh-key-limits、 dsh-plugin-wallpaper-engine、@modusensus/dsh-mneme、@mrweicodes/dsh-loop-guard、dsh-computer-use-win、dsh-computer-use、dsh-prompt、 @liustack/modlens、dsh-effort-slider、dsh-agent-arena、@tencent-connect/dsh-qqbot。
- patch 层同步屏蔽（关键，否则一行 patch 就能把模块重新拉起来）：computer-use（HOST 行，原来是「非 Windows 才 disabled」的平台守卫，现改无条件 disabled: true）、preset-computer-use（整个 preset）、mcp-dsh-computer-use-win（它的 MCP client）、dsh-ops-file / dsh-ops-shell（dsh-ops 的两行）。
- 版本跳跃：5 个 MichengAI 插件里 3 个跨大版本（dsh-btw 0.1.15→1.0.4、dsh-code-review 0.1.9→1.0.1、dsh-simplify 0.1.12→1.0.1），dsh-context 0.63→0.74、dsh-cost-meter 1.7.47→1.9.30、dsh-agent-teams 0.1.22→0.1.26。这些都是上游为 0.2.1 线重做的版本，功能语义有变，升级后请自己过一遍常用流程。
- 计数：随包依赖 24 → 24（1 个都没删）；bundles 26 → 13（11 个插件 + 2 个官方基座）；compat-check 已挂载 11/11 通过，暂屏蔽 13 个单列（其中 6 个无任何 peer 声明）。
- 已知取舍：dsh-plugin-subagent-director@0.6.0-beta.2 是 beta 且把 persona/toolFilter 迁进 Agent Preset；它是唯一声明了 rc.2 的版本，故挂载——若你不接受 beta，可把它移出 bundles（属「暂屏蔽」的同一套操作）。
- 完整逐插件判定（当前版本 / 上游最新 / 是否声明适配 / 依据链接）见 docs/release-notes-v3.0.0.md。

v2.9.0 (2026-10-23)（预发布 pre-release，非正式版）

- 桌宠换装：dsh-whale-girl-pet@0.3.7 → dsh-pet@0.3.8 （PC2005-cloud/dsh-pet）。蓝色大肥鱼：97 段透明动画无缝衔接、待机呼吸、屏幕漫游、点击 Q 弹、拖拽甩抛反弹、右键点播动作、余额动画 + 头顶联想气泡、偶尔碎碎念与对话；可多开同屏，也能把宠物落到桌面（透明置顶小窗）。行标识 dsh-pet，设置分区由 settings.section（pet-config）承接、浮层走 position: fixed，不占侧栏槽位——与 codex-ui 的侧栏改造不冲突，overrides/cordis.patch.yml 无需新增条目（只更新了两处注释）。
- 桌面小窗是可选能力：宿主首次发现本机没有 Electron 时会自行下载一份 runtime 到 ~/.dsh/electron（只下一次、打在控制台日志里）；下载失败或不想用时只影响桌面模式， 浏览器里的宠物照常可用（设置页「显示位置」可切「仅浏览器 / 仅桌面 / 两者」）。
- 新增 ego-lite（ego-browser skill）：citrolabs/ego-lite v2.1.0 —— 让智能体复用你已登录的 Chromium 做浏览器自动化。上游的 DSH 插件入口（plugins/ego，包名 @citrolabs/ego）在 git 安装时会因软链的 Skill 目录被 npm/pnpm 打包丢弃而在 import 阶段 ENOENT（已实测），故本包改为投递同一份 skills/ego-browser/ （tag v2.1.0）。理由与安装前提见上方「ego-lite 浏览器自动化」。
- 兼容性判定：dsh-pet@0.3.8 的 9 个 @deepseek-ai/dsh- peer 全为 ^0.2.0-rc.1，宿主 0.2.0-rc.2 满足；插件自带 dsh.compatibility.dshReleases 亦声明 0.2.0-rc.2 = compatible；非 dsh- peer 的 cordis ^4.0.4（宿主 4.0.4）、 react / react-dom ^18.2.0 与既有插件同基线。docs/compat-check.cjs 新增 dsh-pet@0.3.8 条目，实测 13/13 通过。
- 计数：插件 24 → 24（1:1 换装；bundles 26 含 2 个官方基座，dependencies 24）；自带 skill 49 → 50（新增 ego-browser，目录数 50）。
- 发行口径：本次按常规推进小版本号 2.8.1 → 2.9.0，但 GitHub Release 以 pre-release 形式发布，不走正式版。CI 的 .github/workflows/release.yml 新增发布通道判定：版本出现在 docs/prerelease-versions.txt 里就打 --prerelease。
- 完整说明见 docs/release-notes-v2.9.0.md。

v2.8.1 (2026-10-10)

- 移除：dsh-inline-figures@0.1.0 —— 其 draw_figure 工具返回通道持续报 invalid output: value is not lossless JSON（用最小 spec 复现，故障与 spec 内容无关，属工具绑定层缺陷，无法配置规避）。绘图能力改由自带 skill chart-visualization 与宿主原生能力承担。
- 同步清理 6 处引用：package.json、manifest.json（含中英文 description）、 pnpm-workspace.yaml、docs/compat-check.cjs、README.md、README.en.md。
- 插件 25 → 24（bundles 27 → 26 含 2 个官方基座；dependencies 25 → 24）； compat-check 在装插件 13 → 12；49 个自带 skill 不变。
- 零版本变更：其余 24 个插件版本、基座 DSH 0.2.0-rc.2 与 v2.8.0 完全相同。
- 完整说明见 docs/release-notes-v2.8.1.md。

- 新增 dsh-ops 插件（T-Auto/dsh-ops 0.3.0，npm registry 版本， peer 已声明兼容 DSH 0.2.0-rc.2）：Rust 编写的四个文件工具（ops_inspect_local_file / ops_grep / ops_glob / ops_replace）+ ops_bash 命令执行器 + Windows 随包 PowerShell 7。
file 与 shell 两个组件默认开启；ptc（原生 PTC 批处理）与 tui（只读侧栏）保持上游默认关闭。
overrides/cordis.patch.yml 记录两个默认开启组件的配置值，并给 pwsh-sandbox 行加 disabled: !!js process.platform !== 'win32' 守卫（非 Windows 上不指向不存在的执行器）。
- 未改动任何插件源码；worker 二进制与 bash / pwsh 载荷随 npm 依赖安装，无安装期下载脚本。

v2.7.1 (2026-10-10)

- 修复（issue #1）：6 个自带 skill（agent-browser / docx / pdf / pptx / research / xlsx）目录内误嵌套了一层 home/skills/<name>/（v2.5.0 收录时把上游宿主前缀一并复制进来，引入提交 fafc9e8）。安装时 launcher 把 home/ 递归映射到 DSH_HOME 根，嵌套副本落在 $DSH_HOME/skills/<name>/home/skills/<name>/，成为 skill 加载器（只扫一层）永远读不到的死数据。本次全部清理，skill 目录数维持 49 不变。
- 构建防回归：scripts/build-dspack.py 打包期检测任何 home//home/ 形态的条目，命中即报错中断并列出污染路径（先收集校验、后写包，不留半成品），同类污染从此进不了 dspack；CI 侧同步加了同款守卫。
- dsh-computer-use 平台守卫：该插件 Python sidecar 入口 cli.py:51 无条件 from computer_use.win_dpi import …，而 win_dpi.py:13 在模块顶层执行 ctypes.WinDLL("user32", …) ——该属性仅 Windows 的 ctypes 才有，非 Windows 上 import 即 AttributeError，每次启动刷一整段 Traceback（failOnStartupError: false 保证不影响启动，但很吵，见 issue #1）。本包在 profile 层给 HOST 平面 computer-use 行（上游自带 patch insert 的那行，id 已对照钉死的上游提交核实）与 preset-computer-use 内 tool-computer-use 行都加 disabled: !!js process.platform !== 'win32' （与既有 tool-pwsh 同一模式）：非 Windows「安静地不可用」，Windows 上表达式为 false、行为不变。
逐键覆盖语义只写 disabled，不触碰其余配置键；源码级修复走上游 PR。
- 清理遗留：按 v2.7.0 更新日志的事后溯源承诺，移除 pnpm-workspace.yaml 里其实不需要的 dsh-workbuddy-connect@0.7.1 minimumReleaseAgeExclude（该版本发布于 2026-10-01，远超 1 天窗口）。
- 零依赖变更：插件数量、依赖版本、基座与 v2.7.0 完全相同。
- 完整说明见 docs/release-notes-v2.7.1.md；修复规划与本地核实见 docs/fix-plan-issue-1-v2.7.1.md。

v2.7.0 (2026-10-07)

- 新增：dsh-workbuddy-connect@0.7.1 —— WorkBuddy 桌面端模型接入。复用 WorkBuddy 桌面 App 的本机登录态，把 GLM-5.3、GLM-5.2、GLM-5.3-Flash、DeepSeek-V4-Pro/Flash、Kimi-K3、MiniMax-M3、Hy3 等注册成 DSH 的一个 LLM provider，零配置出现在模型选择器与 /model 里；国内版与国际版各成一个分组，积分互不混用。功能与限制详见上方「WorkBuddy 模型接入」。
- 不增加使用门槛：没装或未登录 WorkBuddy 时，对应模型分组直接隐藏（0.7 起无凭据不再展示内置兜底列表），不报错、不影响其余插件启动——实测 --dump-config 零 stderr、web 服务正常监听、界面无该分组（见「验证记录」）。
- 适配判定：该插件 7 个 @deepseek-ai/dsh- peer 全部精确钉 0.2.0-rc.2，与本包基座一致，peer 门禁 7/7 ✅；@earendil-works/pi-ai ^0.87.1 与基座 dsh-llm-pi-ai@0.2.0-rc.2 自身的依赖范围同源，不存在上游 issue #74 的两代混用。版本必须对得上：0.7.x 仅面向 0.2.0 内核，在 DSH 0.1.x 上需退回 0.6.5，装错会启动失败。
- 层栈位置：排在 @tencent-connect/dsh-qqbot 之后、@michengai/dsh-codex-ui 之前，维持「codex-ui 末位接管」的既有约定；overrides/cordis.patch.yml 本次未新增条目——provider 行由插件自带的 bundle patch 注册，整合包无需补层。
- pnpm-workspace.yaml 补录 dsh-workbuddy-connect@0.7.1 的 minimumReleaseAgeExclude。事后溯源（2026-10-07）：阈值不在 profile 的 pnpm-workspace.yaml 里，来自 pnpm 11 的 minimumReleaseAge（DSH 生态实测按 1440 分钟＝1 天处理，见 dsh-market 安装器的绕过逻辑）；0.7.1 发布于 2026-10-01，早已超出 1 天窗口 → 这条 exclude 其实不需要，保留至 v2.7.0 已发布资产不变，下一版移除。
- 插件总数 23 → 24（bundles 25 → 26 含 2 个官方基座；dependencies 23 → 24）；自带 skill 数量与基座均与 v2.6.0 相同。
- 验证（2026-10-07 实测，详见「验证记录」）：隔离安装真 @deepseek-ai/dsh@0.2.0-rc.2 CLI + 独立 DSH_HOME 跑通 —— dsh --dump-config exit 0、stderr 0 字节、1367 行，参与测试的 23/23 bundle 全部在层栈中，llm-workbuddy provider 行由插件自带 patch 注入在位；web 服务成功监听、界面正常，未登录时模型选择器无 WorkBuddy 分组。peer 门禁 13/13 ✅（脚本口径见「兼容性判定」）。两个边界：三个 git 依赖插件（dsh-computer-use / dsh-agent-arena / dsh-qqbot）本次 未参与同一次启动——Windows 上 pnpm 取 git 依赖稳定触发 store 文件锁（[EBUSY] unlink …\.git\FETCH_HEAD），共享/独立 store 两次尝试均复现；WorkBuddy 登录态下的功能冒烟未做（本机未装该桌面 App）。上游自述 0.7.0/0.7.1 已在 0.2.0-rc.2 web 端真机实测。

v2.6.0 (2026-10-06)

- 新增：dsh-computer-use（钉上游提交 72f390a，未改源码）—— Codex 风格 Computer Use：13 个 window2 原生工具 + batch_actions / health / experience 三个 DSH 扩展、可见合成光标与状态药丸、Esc 急停、按应用授权。
- 新增独立 computer-use preset：上游插件只带 HOST 平面那一行，13 个工具必须由 preset 挂载才对模型可见，故本包在 overrides/cordis.patch.yml 用 - insert: 新增一个 preset（不往 preset-standard 塞行——loader patch 会整体替换它的 plugins 数组，实测会把标准 preset 的 32 行压没）。普通编码会话（standard / ptc）拿不到鼠标。
- 与 dsh-computer-use-win 可共存，但不要在同一会话里同时驱动桌面（两套指针/覆盖层会打架）。
- 随包 skill 47 → 49：新增投递 computer-use、computer-use-browser。
- 插件总数 22 → 23（bundles 24 → 25；dependencies 22 → 23）。
- 完整说明见 docs/release-notes-v2.6.0.md。

v2.5.0 (2026-10-06)

- 整合包自带 49 个 skill（v2.5.0 起）：dspack 携带 home/skills/，安装时落入 DSH_HOME/skills/，开箱即用，不再依赖各 harness 本地目录。
- 49 个 skill：覆盖设计/前端、动效、数据分析、代码开发、媒体、规划效率、打包、办公文档（docx/pdf/pptx/xlsx/research）、浏览器（agent-browser）及新建的 qq-chat-style-miner（从 QQ 聊天记录提炼用户风格）。选择标准：仅通用、可广泛改善体验的 skill；项目级与纯本机自动化类已排除。
- MCP 服务器本次未随整合包分发：overrides/cordis.patch.yml 保持原有 1 条 computer-use 修正，不含任何 MCP 条目；如需扩展 MCP，请在 DSH Launcher 的 MCP 管理页单独配置。
- 基座与插件组合同 v2.4.0（DSH 0.2.0-rc.2，含 @tencent-connect/dsh-qqbot@0.5.0）；scripts/build-dspack.py 已更新，会携带 home/skills/。

v2.4.0 (2026-10-05)

- 新增：@tencent-connect/dsh-qqbot@0.5.0 —— QQ 机器人频道（腾讯官方插件）：把 QQ Bot 接入 DSH，支持私聊/群聊对话、图片与文件理解、流式回复、主动提问与操作确认、/preset 切换预设、/compact 压缩会话、/bot-ping 网络检测。

- 适配判定：peer @deepseek-ai/dsh-agent/llm/session: >=0.1.0-rc.6 与 cordis: >=4.0.1 均覆盖 0.2.0-rc.2（cordis 4.x 基线同 agent-arena fork）。npm 已发布 0.5.0，无需 fork，直接钉 npm 版本。
- 验证：docs/compat-check.cjs peer 门禁 dsh-qqbot 4/4 ✅；npm install @tencent-connect/dsh-qqbot@0.5.0 可下载、自带 cordis.patch.yml（dsh 启动自动加载）、传递依赖就位。全量 pnpm install + dsh --dump-config 真机加载因沙箱无法克隆 git fork（github.com TLS 限制）未能实跑，需在用户 0.2.0-rc.2 宿主确认（与本包既往版本同因）。
- 插件总数 21 → 22（bundles 23 → 24 含 2 个官方基座；dependencies 21 → 22）。

v2.3.0 (2026-10-05)

- 新增 7 个插件（经交互式选型器勾选，peer 门禁全过 + 真机 dsh --dump-config 零 stderr）：
- @mrweicodes/dsh-loop-guard@1.0.8 —— 思考循环守护
- @modusensus/dsh-mneme@0.8.13 —— 跨会话长期记忆
- @liustack/modlens@3.26.6 —— 视觉桥与截图理解
- dsh-inline-figures@0.1.0 —— 回答内嵌矢量图
- dsh-prompt@0.3.0 —— Prompt 模板工具箱
- dsh-plugin-wallpaper-engine@1.2.0 —— Wallpaper Engine 动态壁纸（npm 最新为 1.2.0，repo 的 1.3.0 未发布）
- @goodandready/dsh-key-limits@0.2.19 —— API key / 订阅额度上限（npm 已到 0.2.19，高于 repo 的 0.2.15）
- 移除：dsh-edit-resend@0.1.0 —— npm 发布产物声明 peer ^0.1.0-rc.6， 0.2.0-rc.2 下被 runtime 拒装（v2.1.0 时按 GitHub 源码判定「无 peer」有误，真机实测修正）
- 修复：仓库 package.json 自 v2.1.0 起落后于 manifest（缺 4 个插件），本次全量重同步； manifest 中 codex-ui 重复条目一并清理（保持层栈末位唯一）
- 插件总数 15 → 21，依赖 14 → 21；pnpm-workspace.yaml 补录新插件 minimumReleaseAgeExclude
- 真机验证：dsh --dump-config exit 0、零 stderr，23 bundle 全部加载（隔离安装 @deepseek-ai/dsh@0.2.0-rc.2 实测）

v2.2.0 (2026-10-05)

- 新增：dsh-agent-arena —— 多智能体议事厅与提示词竞技场（可调协作栏、渠道限流、自动接话控制）
- 兼容性处理：上游 Tikzen/dsh-agent-arena@0.6.0 把核心 peer 精确锁定 0.1.7-rc.2，无法在 DSH 0.2.0-rc.2 下安装；经授权采用 fork 放宽方案—— yukitakasama/dsh-agent-arena@feat/relax-peers-0.2.0-rc.2（commit 25e2c55）， 10 条核心 peer 由精确 0.1.7-rc.2 放宽为 >=0.1.7-rc.2，依赖精确钉到该 fork commit
- 注意：安装需可访问 GitHub（git fork 依赖）；上游出 0.2.0-rc.2 官方版后建议改回 npm 版本
- .gitignore 新增忽略 .workbuddy/（本地记忆目录）

v2.1.0 (2026-10-04)

- 新增 4 个社区插件（全部 peer 兼容 0.2.0-rc.2，docs/compat-check.cjs 门禁通过）：
- @nanmicoder/dsh-agent-teams@0.1.22 —— 多智能体团队协作
- dsh-context@0.63.0 —— 上下文可视化仪表盘
- dsh-plugin-subagent-director@0.5.5 —— 子代理独立选模型
- dsh-edit-resend@0.1.0 —— 消息编辑重发，补回早前移除的 edit-message 缺口
- 插件总数 12 → 16（bundles），依赖 10 → 14，全部钉死精确版本；同步更新中英文 description
- 新增 docs/：插件调研报告、交互式选型器（plugin-selector.html）、兼容性测试脚本（compat-check.cjs）与结果

v2.0.0 (2026-09-30)

- 破坏性变更：升级基座到 DSH 0.2.0-rc.2
- 移除：dsh-plugin-edit-message（无 0.2.x 兼容版本）
- 更新：全部 10 个插件更新到最新版本并验证兼容性
- 新增：manifest 增加 dshVersions 和 launchers 字段（v5 规范）
- 改名：整合包更名「更好的 deepseek harness（codex 风格）」；标识/仓库名/.dspack 前缀/profile 名统一为 better-deepseek-harness-codex

v1.1.0

- 新增 Windows Computer Use 支持

v1.0.0

- 初始发布，基于 DSH 0.1.7-rc.2