Swift Cycle for DeepSeek Harness

这是 Swift Cycle 的 DeepSeek Harness 适配器。它把锁定的 Swift Cycle v1.2.0 载荷注册为只能由用户显式调用的 Harness Skill。

当前状态

• 适配器版本：0.1.1
• 上游版本：v1.2.0
• 上游 commit：af3c5ddafba516c304613ea69081118fc234add7
• 上游整体 SHA-256：e01de6fa081c12c7e481a219d3932e48a2e386f05202e7b8a6e51a0029fad686
• 本地源码验证：已通过
• 候选制品预检：已通过 dry-run 文件合同和临时解包后完整性验证
• 分发状态：GitHub v0.1.1 与 npm 0.1.1 已发布；v0.1.0 保留为历史版本
• Harness Runtime 兼容性：已通过固定版本的隔离验证、GitHub 固定 commit 安装验证，以及 0.1.0-rc.6 真实 Web profile 中空工作区和一个非空 Git 项目的只读显式调用烟测

以上结果证明源码、候选制品、固定版本的隔离 Harness Runtime，以及两个已记录工作区中的真实 Web consumer 调用符合已验证边界；不代表其他项目、写入流程或生产治理已经验证。

包含的 Swift Cycle 能力

• Knowledge Promotion：把长期共享事实从本地记录晋升到适当的 Git 管理资产。
• State Separation：拆分彼此独立的工程、实验、质量和发布结论。
• Governance Baseline：复杂治理开始前记录可比较的当前基线。
• Commit Boundary Planning：为多提交工作预先划分单一意图和验证边界。
• Source/Runtime Boundary：分别验证源码、制品、运行态和实际消费者。

完整治理规则以锁定的上游 SKILL.md 为准；本 README 不复制 Skill 正文。

调用策略

适配器向 Harness 注册：

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"

npm 0.1.1 和 GitHub 固定提交均已在临时隔离 DSH_HOME 中验证。各版本的安装身份和验证边界以对应 GitHub Release 为准；不要把未固定的默认分支用于可重放安装。

安装或改动 profile 前先检查合成配置：

dsh --profile web --dump-config

公开发布 commit 已在一个真实 Web profile 中完成安装、加载和只读调用烟测。其他 profile 的安装仍需用户单独授权。

本地验证

需要 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 安装时，分发工具仍需要联网获取用户指定的固定版本。

同名 Skill 与证据边界

根据锁定的 DeepSeek Harness Skill Registry 规则，项目级同名条目可以覆盖本适配器的 Runtime 注册；Runtime 注册可能遮蔽同层的用户级同名条目。本适配器不会删除或改写被遮蔽的 Skill。

以下结论必须分别验证：

1. Git 源码与上游锁一致；
2. npm pack 候选制品内容正确；
3. 隔离 Harness Runtime 能注册和显式调用；
4. 真实用户 profile 已安装并由实际消费者使用。

当前四层均已有对应证据；真实 consumer 证据覆盖空的非 Git 工作区和本仓库非空 Git 工作区中的各一次只读调用，不代表其他项目、写入流程或生产治理已经验证。参见 2026-08-15 DSH 隔离兼容性验证、2026-08-16 真实 Web consumer 烟测与 2026-08-16 非空 Git 项目治理烟测。

权威来源

• Swift Cycle 行为和版本：Solismuchengxue/skill_swift_cycle
• DeepSeek Harness 插件与 Skill 语义：deepseek-ai/deepseek-harness
• 本适配器的架构和验证边界：DESIGN.md