Swift Cycle for DeepSeek Harness

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

当前状态

• 适配器版本：0.1.0
• 上游版本：v1.2.0
• 上游 commit：af3c5ddafba516c304613ea69081118fc234add7
• 上游整体 SHA-256：e01de6fa081c12c7e481a219d3932e48a2e386f05202e7b8a6e51a0029fad686
• 本地源码验证：已通过
• 候选制品预检：已通过 dry-run 文件合同和临时解包后完整性验证
• 分发状态：GitHub v0.1.0 已发布；npm 未发布
• Harness Runtime 兼容性：已通过固定版本的隔离验证，并已通过 GitHub 固定 commit 隔离安装；真实用户 profile 仍未验证

以上结果证明源码、候选制品和固定版本的隔离 Harness Runtime 符合本仓库合同，不能证明真实 Harness profile 已安装、加载或生效。

包含的 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

安装约定

首版只支持固定 GitHub commit 安装，不发布 npm 包。v0.1.0 对应的不可变安装身份是完整 40 位 commit；不要使用未固定的默认分支或可移动 tag：

dsh plugin --profile web add "github:Solismuchengxue/dsh_plugin_swift_cycle#c09326cb44ab8dbda67f82535fca4efe85c0444b"

该命令已在临时隔离 DSH_HOME 中验证。后续版本仍应从对应 GitHub Release 复制完整命令；Release tag 用于版本发现，完整 commit 才是安装身份。

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

dsh --profile web --dump-config

本项目当前没有授权安装到任何真实 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 目录。通过 GitHub 安装时，分发工具仍需要联网获取用户指定的固定提交。

同名 Skill 与证据边界

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

以下结论必须分别验证：

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

当前已完成前三层；真实用户 profile 和实际消费者仍未安装、未验证。隔离验证证据见 2026-08-15 DSH 兼容性验证。

权威来源

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