Swift Cycle for DeepSeek Harness
这是 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 "<path-to-swift-cycle-skill-directory>"
适配器加载和运行时不会访问网络，不读取凭据，也不会修改用户级 Skill 目录。通过 npm 或 GitHub 安装时，分发工具仍需要联网获取用户指定的固定版本。
同名 Skill 与证据边界
根据锁定的 DeepSeek Harness Skill Registry 规则，项目级同名条目可以覆盖本适配器的 Runtime 注册；Runtime 注册可能遮蔽同层的用户级同名条目。本适配器不会删除或改写被遮蔽的 Skill。
以下结论必须分别验证：
- Git 源码与上游锁一致；
npm pack 候选制品内容正确；- 隔离 Harness Runtime 能注册和显式调用；
- 真实用户 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 发布证据。
权威来源
