Solismuchengxue/dsh_plugin_swift_cycle

面向 DeepSeek Harness 的 Swift Cycle

这是 Swift Cycle 的 DeepSeek Harness 适配器。它把锁定到精确上游 commit 的 Swift Cycle 载荷注册为只能由用户显式调用的 Harness Skill。

当前状态

- 适配器版本：0.1.4（已发布）
- 上游 tag：v1.3.1
- 上游 commit：21de521237470bdd55f9b4b0c61e0b6246c02cb8
- 上游整体 SHA-256：7cb1bcf09afb23db310e3da01de88dda6521321dc45919b05a25f2ab9f381cf4
- 本地源码验证：0.1.4 候选已通过 18/18 自动化测试和显式上游 checkout 比对
- 候选制品预检：0.1.4 候选已通过 20 个上游载荷文件、26 个包文件的 dry-run 合同和临时解包后完整性验证
- 分发状态：GitHub v0.1.4 与 npm 0.1.4 已发布；v0.1.0 至 v0.1.3 保留为历史版本
- Harness Runtime 兼容性：历史固定版本已通过隔离验证、GitHub 固定 commit 安装验证，以及 0.1.0-rc.6 真实 Web profile 中 GitHub v0.1.0 与 npm 0.1.1 的只读显式调用烟测；0.1.4 候选未安装到任何 Harness Runtime

0.1.4 已证明源码、候选制品、GitHub 与 npm 分发身份；隔离 Runtime、真实 profile 和 consumer 仍未验证。既有 Runtime 与真实 Web consumer 结论只覆盖各自记录的 0.1.0/0.1.1 身份，不自动转移到新版本。

包含的 Swift Cycle 能力

- Knowledge Promotion：把长期共享事实从本地记录晋升到适当的 Git 管理资产。
- State Separation：拆分彼此独立的工程、实验、质量和发布结论。
- Governance Baseline：复杂治理开始前记录可比较的当前基线。
- Commit Boundary Planning：为多提交工作预先划分单一意图和验证边界。
- Source/Runtime Boundary：分别验证源码、制品、运行态和实际消费者。
- Persistent Adoption：一次显式采用后由项目 AGENTS.md 持久绑定，后续阶段判断与文档维护在后台完成。
- Background Routing：自动区分接管、普通推进、重大结构变化和里程碑关闭，不要求用户选择模式。
- Document Profiles：按需使用 minimal、standard 或 runtime_integration，并维护 profile_conformance，不强制固定目录树。
- Document Information Architecture：按可发现性决定 DESIGN、docs home、职责目录和用途/受众索引，不复制第二套真源。
- Project Intent Baseline：新项目在实质实施前建立 docs/blueprint.md，旧项目复用完整等价权威，不形成第二真源。
- Docs Naming：新建 docs Markdown 文件和多单词目录使用小写 snake_case；遗留命名只在独立 documentation-hygiene 工作包中迁移。
- Language Adaptation：普通内容服从调用者、项目和文件主语言，精确技术标识保持原文。
- Semantic Visualization：先理解读者问题与项目事实，再自主选择短文、表格或 Mermaid，并审查语义、可读性、项目语言、权限与边界。
- Freshness and Packet Lifecycle：对齐过期事实并冻结、替代或退役 Review/Closeout Packet。
- Reusable Failure Learning：只把已确认且可复用的失败防线晋升为共享规则。

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

调用策略

适配器向 Harness 注册：

name = swift-cycle
modelInvocable = false
userInvocable = true

Swift Cycle 不进入模型可隐式选择的 Skill 目录。用户需要显式输入：

/swift-cycle

安装

日常安装使用 npm latest；当前公开版本为 0.1.4：

dsh plugin --profile web add dsh-plugin-swift-cycle

需要固定、可重放的安装身份时指定版本：

dsh plugin --profile web add dsh-plugin-swift-cycle@0.1.4

npm 固定版本不可变。需要直接从 GitHub 安装同一版本时，使用 v0.1.4 对应的完整 40 位 commit：

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

npm 0.1.1 和其 GitHub 固定提交已在临时隔离 DSH_HOME 中验证。0.1.4 已完成公共分发身份校验，但尚未进行隔离或真实 profile 安装。各版本的安装身份和验证边界以对应 GitHub Release 为准；不要把未固定的默认分支用于可重放安装。

0.1.4 的不可变安装身份是 npm 固定版本、GitHub tag 及上述完整发布 commit；不要把可继续前进的 main 当作不可变安装版本。

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

dsh --profile web --dump-config

GitHub v0.1.0 固定 commit 与 npm 0.1.1 均已在同一个真实 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 ""

适配器加载和运行时不会访问网络，不读取凭据，也不会修改用户级 Skill 目录。通过 npm 或 GitHub 安装时，分发工具仍需要联网获取用户指定的固定版本。

同名 Skill 与证据边界

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

以下结论必须分别验证：

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

真实 consumer 证据覆盖 GitHub v0.1.0 在空的非 Git 工作区与本仓库中的只读调用，以及 npm 0.1.1 在本仓库中的一次只读调用。0.1.4 已完成源码、候选制品和公共分发身份验证；隔离 Runtime、真实 profile 和 consumer 保持 NOT_VERIFIED，本轮不修改部署状态。参见 2026-08-15 DSH 隔离兼容性验证、2026-08-16 真实 Web consumer 烟测、2026-08-16 非空 Git 项目治理烟测、2026-08-20 npm v0.1.1 真实 consumer 烟测、2026-08-30 npm v0.1.2 发布证据、2026-08-31 npm v0.1.3 发布证据与 2026-08-31 npm v0.1.4 发布证据。

权威来源

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