dsh-free-mode

DeepSeek Harness（DSH）「破甲模式」自定义 Agent 预设 —— 纯 DSH 插件包，零脚本、零安装器。

安装后在 DSH 预设选择器中出现名为 破甲模式 的 Agent 预设（v4 强化版政策正文 + 逐条覆盖层 + 文件操作中和块，附「破甲自检」回执口令）。

环境要求

• 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 一致，否则工作流直接失败。

前置配置（维护者一次性操作）

1. npmjs.com 生成 Granular Access Token（仅勾选本包、Read and write；首次发布前包尚不存在时，可先手动 npm publish 一次再生成包级令牌）；
2. 仓库 Settings → Secrets and variables → Actions → 新建 Secret NPM_TOKEN；
3. （可选）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