前言¶
DeepSeek Harness(DSH)把智能体能力拆成可组合的插件与预设。若你希望在官方 standard 预设之外,使用一套更强调政策正文覆盖、文件操作中和与自检回执的 Agent 行为,又不想在本地跑安装脚本或手动拷贝目录,就需要一种「只含声明、随包升级」的挂载方式。社区维护的 dsh-free-mode(codesensi)把上游破甲类预设重新打包为纯 DSH bundle,安装后在预设选择器里出现 自在模式,适合已经熟悉 DSH 插件命令、且能接受自行审阅补丁内容的开发者。
这是什么¶
dsh-free-mode 是 MIT 许可的 DSH 插件包:整个仓库实质只有 patch/free.patch.yml 一份声明式补丁,不含可执行代码。维护者为 codesensi,在 SkillHub 等社区目录中归类为 工作流。插件简介指向为 DSH 注入与「破甲模式」同源的 Agent 预设方案;本包在 UI 中显示为 自在模式(v4 强化版政策正文 + 逐条覆盖层 + 文件操作中和块,并附「自在否」自检回执口令)。
预设正文重新打包自上游 z91772524-ai/dsh-pojia-mode(破甲模式 v1.1):将安装器落盘的内容改为 dsh.bundle.patch 形式的纯声明式 bundle,不再携带脚本或安装器,并随 npm 包版本更新。
核心功能¶
下面介绍本插件在 DSH 里实际提供的能力,均来自仓库 README 与 package.json 声明。
- 声明式挂载:通过
package.json中的dsh.bundle.patch指向./patch/free.patch.yml,DSH 启动时自动应用补丁层。 - 预设条目:补丁声明
preset-free,在选择器中显示为「自在模式」,order: 20,排在官方 standard 预设之后。 - 镜像 standard 插件清单:
patch/free.patch.yml逐条镜像 DSH 0.2.1-rc.3 官方standard预设的插件清单(含@deepseek-ai/dsh-agent-preset与cordis:group分组)。DSH 升级若改变 standard 构成,本预设可能出现能力差异,需维护者同步更新镜像与engines.dsh范围。 - 零额外依赖:除 DSH 本体外无其他运行时依赖。
环境要求¶
engines.dsh: >=0.2.1-rc.3 <0.3.0
需要 DSH 0.2.1-rc.3 或更高,且低于 0.3.0(声明式 Agent 预设 + 插件 bundle 机制)。当前 npm 包版本为 1.2.0(以 package.json 为准)。
安装与启用¶
先做安装,再重启 DSH;补丁在启动时挂载,之后在预设选择器中选择「自在模式」。
从 Git 仓库安装(用户名/仓库名):
dsh plugin add codesensi/dsh-free-mode
从 npm 安装:
dsh plugin add dsh-free-mode
安装完成后 重启 DSH,打开预设选择器即可看到「自在模式」。
卸载:
dsh plugin remove dsh-free-mode
卸载后同样需重启 DSH,preset-free 声明随插件包移除。
与上游破甲安装器并存时的注意¶
若曾用上游 dsh-pojia-mode 的安装器,预设会写入 $DSH_HOME/.agent-presets/pj-mode,与本插件的 preset-free 是两套独立声明,可以共存、互不覆盖。但显示名同类(上游为「破甲模式」,本插件为「自在模式」),同时安装会在选择器里出现两个相近条目,且上游落盘内容不会随本插件 npm 版本更新。README 建议:若已装过上游,可先删除 $DSH_HOME/.agent-presets/ 下对应目录(如 pj-mode),只保留本插件,便于随版本升级。
典型用法¶
本插件没有单独的业务 CLI;用法即「安装 → 重启 → 在 DSH 预设选择器选用自在模式」。维护者本地校验补丁可用:
python tools/validate_patch.py patch/free.patch.yml
打包为 npm tarball(供 dsh plugin add 使用):
pnpm pack
适用场景与注意¶
适合谁:已在用 DSH 0.2.1-rc.x、需要额外 Agent 预设且偏好声明式插件包(无安装脚本)的开发者;愿意对照 GitHub 上的 patch/free.patch.yml 理解政策与工具行为差异。
不适合当作什么:这不是 DeepSeek 或幻方官方应用;SkillHub 等目录是社区生态站点。插件以当前 DSH 进程权限运行,预设会参与 Agent 与文件相关能力,安装前应阅读源码、许可证(MIT)及补丁正文,自行判断是否满足合规与安全要求。
版本兼容:engines.dsh 上界为 <0.3.0;大版本 DSH 变更时可能需要等待插件 minor/major 发版调整镜像。
链接¶
经过上面的步骤,你可以在不动本地安装脚本的前提下,用标准 dsh plugin add 流程挂载「自在模式」,并在上游与本包之间按 README 建议避免重复条目。