dsh-free-mode
DeepSeek Harness（DSH）「自在模式」自定义 Agent 预设 —— 纯 DSH 插件包，零脚本、零安装器。
安装后在 DSH 预设选择器中出现名为 自在模式 的 Agent 预设（v4 强化版政策正文 + 逐条覆盖层 + 文件操作中和块，附「自在否」自检回执口令）。
上游仓库
本项目的预设正文重新打包自上游 z91772524-ai/dsh-pojia-mode（破甲模式 v1.1）：将其安装器落盘的预设内容改为纯声明式插件 bundle（dsh.bundle.patch），不再携带任何脚本/安装器，并随 npm 包版本持续更新。
与上游并存时的注意事项：
- 上游安装器会把预设写入
$DSH_HOME/.agent-presets/pj-mode，与本插件的 preset-free 是两个独立声明，可以共存、互不覆盖；
- 但两者显示名同类（上游为「破甲模式」，本插件为「自在模式」），同时安装会在模式选择器里出现两个同类条目，且上游那份落盘后不会随本插件更新；
- 若曾安装过上游版本，建议先删除
$DSH_HOME/.agent-presets/ 下对应目录（如 pj-mode）再使用本插件，只保留一份、便于随版本升级。
环境要求
- DSH 0.2.1-rc.3 或更高（声明式 Agent 预设 + 插件 bundle 机制；
engines.dsh: >=0.2.1-rc.3 <0.3.0）。
- 无其他依赖：本包不含任何可执行代码，只有一个声明式补丁文件。
安装
# 从 Git 仓库安装（用户名/仓库名）
dsh plugin add codesensi/dsh-free-mode
# 从 npm 安装
dsh plugin add dsh-free-mode
安装完成后重启 DSH，补丁层会在启动时自动挂载；打开预设选择器即可看到「自在模式」（order: 20，排在官方 standard 预设之后）。
卸载
dsh plugin remove dsh-free-mode
卸载后重启 DSH，preset-free 声明随插件包一并移除。
版本兼容性说明
本包的 patch/free.patch.yml 逐条镜像了 DSH 0.2.1-rc.3 官方 standard 预设的插件清单（含 @deepseek-ai/dsh-agent-preset 声明与 cordis:group 分组）。DSH 升级若改变了 standard 预设的插件构成，本预设可能出现能力差异，届时需同步更新镜像并调整 engines.dsh 范围。
开发
# 校验补丁文件（YAML + !!js 标签 + preset 声明结构）
python tools/validate_patch.py patch/free.patch.yml
# 打包（npm 格式 tarball，dsh plugin add 直接可用）
pnpm pack
版本发布
本仓库通过 GitHub Actions 自动发布：推送 v 开头的 tag，即自动完成 npm 发布 + GitHub Release（附 tarball）。
日常发版
# 1. 升版本号（自动修改 package.json 并打 tag）
pnpm version patch # 1.0.0 → 1.0.1：补丁内容修订
# pnpm version minor # → 1.1.0：新增预设/功能
# pnpm version major # → 2.0.0：破坏性变更
# 2. 推送（--follow-tags 连同 tag 一起推）
git push --follow-tags
推送 tag 后 release.yml 自动执行：tag 与 package.json 版本一致性校验 → 补丁校验 → npm pack → npm publish → 创建 GitHub Release（附 tarball）。
手动发版（等价）
git tag v1.2.0 && git push origin v1.2.0
tag 必须与 package.json 的 version 一致，否则工作流直接失败。
前置配置（维护者一次性操作）
- npmjs.com 生成 Granular Access Token（仅勾选本包、Read and write；首次发布前包尚不存在时，可先手动
npm publish 一次再生成包级令牌）；
- 仓库 Settings → Secrets and variables → Actions → 新建 Secret
NPM_TOKEN；
- （可选）npm 账号绑定 GitHub 以启用
--provenance 构建来源徽章。
手动重试
发布中途失败（如 npm 校验抖动）时，修复后到仓库 Actions 页面选择 release 工作流 → Run workflow 手动重跑，跳过 tag 门禁，只重发 npm。
版本号约定
| 变更内容 | 版本动作 |
|---|
修改 patch/free.patch.yml 正文或措辞 | patch（同时可同步更新正文里的内部版本标记 版本2.0.*） |
新增 preset、放宽 engines.dsh 下界 | minor |
| 不再兼容某个 DSH 大版本 / 移除预设 | major |
License
MIT
