仓颉：书籍与长内容转 Skill｜个人思维图谱小站

正文

docs/releases/v2.5.0.md

发布日期：2026-08-30

2026-09-13 补充优化（仍为 v2.5.0）

修复工具书误筛：三重验证改为来源充分性、可执行性、任务增益。单处讲透的流程/公式可以保留，不再强求双语境、作者独创或跨领域外推；缺依据或缺关键条件仍不能入选。
重要内容不静默丢失：增加原书关键任务覆盖审计，区分可执行、参考、待核查和淘汰。补齐流程、公式、表格字段、单位与排障的提取要求。
案例真实可追溯：书中实例、例题与合成演练分别标记，不强求作者亲历故事，也不编造实际结果。
评测更加可信：缺失输出计入计划分母，失败/未完成返回非零；增加数值/单位/容差检查，隔离不同版本的测试产物。
配套资源可交付：单 Skill 与紧凑包均支持显式声明的 UTF-8 脚本和文本模板；路径与文件类型检查防止越界或误打包。
验证：新增 26 项自动化回归（含 CLI 编译与评分），合成分流/输出样本单独标注；不把这些测试宣称为群友原书案例或所有宿主上的效果验证。

更新后的安装包

通用包解压后，安装完整的 cangjie-skill/ 目录，不要只复制 SKILL.md。Harness 用户按下方方式重新下载并安装，重新启动宿主；版本号不变时，请核对 SHA256 和包内 BUILD_INFO.json，避免误用本地旧副本。

版本说明：这是同一 v2.5.0 Release 的补充更新，不创建新版本，也不移动首次发布标签。最新代码在 main，安装附件内记录精确源码提交；GitHub 自动生成的 “Source code (zip/tar.gz)” 仍指向首次发布的标签源码，请使用上面的安装附件获取本次优化。

v2.5.0 把「从长内容中拆出很多平铺 Skill」升级为「先维护一份 Capability Bundle，再按场景编译交付形态」。这个版本的重点不是增加更多文档，而是让蒸馏结果更少、更容易安装，也更容易更新、修复和评测。

核心升级

Capability Bundle 单一事实源：能力卡、元数据、关联和去向集中在 books/<slug>/.cangjie/capabilities/，避免 single 与 pack 各自演进后产生偏差。
single / compact pack 双输出：single 用一个路由入口承载整本内容； pack 保留一个路由入口，只把通过晋级门的少数能力拆成独立 Skill。
统一 CLI：scripts/cangjie.py 提供 doctor / compile / replan-output / update / repair / rollback / eval / benchmark 等入口。
确定性与可回滚：引入内容寻址缓存、编译不变量、写锁、staging 校验、手工修改检测、发布前快照和 rollback。
增量更新与修复：支持源文档 diff、影响分析、事务性补丁、失败案例诊断和防过拟合修复。
评测与基准链路：包含触发评测、匿名输出对比、静态 A 类指标和 Naval 试点资产。
Registry v2 + 官网：新 schema 能表达输出模式、入口数和能力数；官网同步展示，原有 Registry v1 条目无需改造。
官网依赖安全升级：Astro 7.2.9、js-yaml 5.4.1，发布时 npm audit 为 0 vulnerabilities。

兼容性

不破坏现有 Registry v1 条目和 legacy pack。
新产物建议使用 Registry v2；字段迁移见 docs/migrations/2026-08-25-v2.0-to-v2.1.md。
官网子项目许可证已与根仓库统一为 MIT。

DeepSeek Harness 安装包

本 Release 已补充 DeepSeek Harness 专用 Bundle：

安装包不只是旧版适配层改版本号：它同步包含 v2.5 的 SKILL.md、Capability Bundle 方法论、统一 CLI、schemas、extractors、templates 与迁移文档。2026-09-04 首次补包时完成过临时 DSH_HOME 安装与 --dump-config 识别测试。本次 2026-09-13 补包保留适配层，重新执行包内 26 项 Python 回归、4 项 Node 注册/资源定位测试、包结构校验和 cangjie.py doctor；本机未提供 dsh 命令，未重复真实 Harness 宿主安装，不把注册测试等同于宿主实测。

mkdir -p ~/.dsh/packages
curl -fL "https://github.com/kangarooking/cangjie-skill/releases/download/v2.5.0/dsh-cangjie-skill-2.5.0.tgz" \
  -o ~/.dsh/packages/dsh-cangjie-skill-2.5.0.tgz
curl -fL "https://github.com/kangarooking/cangjie-skill/releases/download/v2.5.0/dsh-cangjie-skill-2.5.0.tgz.sha256" \
  -o ~/.dsh/packages/dsh-cangjie-skill-2.5.0.tgz.sha256
(cd ~/.dsh/packages && shasum -a 256 -c dsh-cangjie-skill-2.5.0.tgz.sha256)
dsh plugin --profile web add ~/.dsh/packages/dsh-cangjie-skill-2.5.0.tgz

文档与社群一致性

英文 README.md 与中文 README.zh-CN.md 均引用同一个 assets/wecom-cangjie-group-qr.png。
二维码文件以中文 README 当前展示的版本为准，本次发布不使用本地分支中的另一张图覆盖它。

验证边界

本版本发布前执行 schema、Bundle、编译确定性、Registry、网站测试与构建校验。真实 Agent 宿主上的盲测结果具有 host-specific 属性，不把静态评测误表述为所有宿主的通用效果。

仓颉：书籍与长内容转 Skill

正文