42 lines
2.4 KiB
Markdown
42 lines
2.4 KiB
Markdown
# 倉頡 Skill v2.5.0 发布说明
|
||
|
||
> 发布日期：2026-08-30
|
||
|
||
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`](https://github.com/kangarooking/cangjie-skill/blob/v2.5.0/docs/migrations/2026-08-25-v2.0-to-v2.1.md)。
|
||
- 官网子项目许可证已与根仓库统一为 MIT。
|
||
|
||
## 文档与社群一致性
|
||
|
||
- 英文 `README.md` 与中文 `README.zh-CN.md` 均引用同一个
|
||
`assets/wecom-cangjie-group-qr.png`。
|
||
- 二维码文件以中文 README 当前展示的版本为准，本次发布不使用本地分支中的另一张图覆盖它。
|
||
|
||
## 验证边界
|
||
|
||
本版本发布前执行 schema、Bundle、编译确定性、Registry、网站测试与构建校验。
|
||
真实 Agent 宿主上的盲测结果具有 host-specific 属性，不把静态评测误表述为所有宿主的通用效果。
|