前言¶
在 DeepSeek Harness（DSH）里做项目治理时，常见做法是临时写一段提示词，或把规则散落在对话里。问题是：长期共享事实难以沉淀到 Git 资产，工程、实验、质量与发布结论容易混在一起，复杂治理开始前也缺少可比较的基线。
dsh_plugin_swift_cycle 是 Swift Cycle 的 DSH 适配器。它把锁定的 Swift Cycle v1.2.0 载荷注册为只能由用户显式调用的 Harness Skill，支持版本固定与离线验证。维护者为 Solismuchengxue，SkillHub 分类为 admin-security，GitHub 仓库当前约 15 stars。
这是什么¶
一句话定位：Swift Cycle governance skill adapter for DeepSeek Harness；user-invoked，version-pinned，offline-verifiable。
适配器版本为 0.1.1，上游 Swift Cycle 为 v1.2.0（commit af3c5ddafba516c304613ea69081118fc234add7）。npm 包名为 dsh-plugin-swift-cycle，许可证 MIT。完整治理规则以锁定的上游 SKILL.md 为准，本适配器 README 不复制 Skill 正文。
核心功能¶
适配器向 Harness 注册的 Swift Cycle 能力包括：
- Knowledge Promotion：把长期共享事实从本地记录晋升到适当的 Git 管理资产。
- State Separation：拆分彼此独立的工程、实验、质量和发布结论。
- Governance Baseline：复杂治理开始前记录可比较的当前基线。
- Commit Boundary Planning：为多提交工作预先划分单一意图和验证边界。
- Source/Runtime Boundary：分别验证源码、制品、运行态和实际消费者。
调用策略如下。适配器注册 name = swift-cycle，modelInvocable = false，userInvocable = true。Swift Cycle 不进入模型可隐式选择的 Skill 目录，用户需显式输入：
/swift-cycle
安装与启用¶
日常安装使用 npm latest：
dsh plugin --profile web add dsh-plugin-swift-cycle
需要固定、可重放的安装身份时指定版本：
dsh plugin --profile web add dsh-plugin-swift-cycle@0.1.1
npm 固定版本不可变。需要直接从 GitHub 安装同一版本时，使用 v0.1.1 对应的完整 40 位 commit：
dsh plugin --profile web add "github:Solismuchengxue/dsh_plugin_swift_cycle#d44bee70c109bb1d772d26ee790d6de9aadce9cc"
安装或改动 profile 前先检查合成配置：
dsh --profile web --dump-config
GitHub v0.1.0 固定 commit 与 npm 0.1.1 均已在同一个真实 Web profile 中完成安装、加载和只读调用烟测。其他 profile 的安装仍需用户单独授权。各版本的安装身份和验证边界以对应 GitHub Release v0.1.1 为准；不要把未固定的默认分支用于可重放安装。
典型用法¶
安装完成后，在 DSH 对话中显式调用：
/swift-cycle
维护者如需本地验证适配器与上游载荷一致性，需要 Node.js 20 或更高版本。本包没有运行时依赖，也不需要执行安装生命周期脚本：
npm test
npm run verify:upstream
npm run pack:dry-run
也可显式提供一个 Swift Cycle checkout，做只读载荷比对：
node scripts/verify-upstream.mjs --source "<path-to-swift-cycle-skill-directory>"
适配器加载和运行时不会访问网络，不读取凭据，也不会修改用户级 Skill 目录。通过 npm 或 GitHub 安装时，分发工具仍需要联网获取用户指定的固定版本。
适用场景与注意¶
适合谁
- 需要在 DSH 中按 Swift Cycle 规则做项目治理、状态拆分与提交边界规划的开发者。
- 希望 Skill 版本可固定、载荷可离线验证、调用必须由用户显式触发的团队。
务必注意
- 插件以当前
dsh进程权限运行；安装前应检查源码与 MIT 许可证，并理解其治理边界。 - 根据锁定的 DeepSeek Harness Skill Registry 规则，项目级同名条目可以覆盖本适配器的 Runtime 注册；Runtime 注册可能遮蔽同层的用户级同名条目。本适配器不会删除或改写被遮蔽的 Skill。
- 仓库文档记录的验证结论覆盖源码、候选制品、隔离 Harness Runtime 与部分真实 Web consumer 烟测，不代表其他项目、写入流程或生产治理已经验证。
DSH 生态的理念是「一切皆插件」。SkillHub 是独立社区目录站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh_plugin_swift_cycle 把 Swift Cycle v1.2.0 以版本锁定、用户显式调用、离线可验证的方式接入 DSH，适合在 admin-security 场景下做结构化项目治理。
- SkillHub 目录页：https://www.skillhub.cn/plugins/Solismuchengxue/dsh_plugin_swift_cycle
- GitHub 仓库：https://github.com/Solismuchengxue/dsh_plugin_swift_cycle
