Ling 1.2.4

更新日志

本文件记录灵轨（Ling）的重要变更。

格式基于 Keep a Changelog，
本项目遵循 Semantic Versioning。

Unreleased

[ling-1.2.4] - 2026-03-15

修复

• 修复 ling spec enable 在全局 codex Skills 已存在时重新写回 Gemini CLI 重复 Skill 的问题，并避免将仅同名但内容不同的 Gemini 专用 Skill 误判为重复副本。

维护

• 完善仓库根 .gitignore，补充测试临时目录、日志缓存和 Web 构建产物忽略规则。

[ling-1.2.3] - 2026-03-15

修复

• 修复 Gemini CLI 全局 Skill 冲突：当 ~/.agents/skills/ 已提供同名 universal Skill 时，ling global sync --target gemini 与默认全局同步会自动备份并清理 ~/.gemini/skills/ 中的重复副本，避免 Gemini 启动时出现 Skill conflict detected。

[ling-1.2.2] - 2026-03-14

修复

• 修复全局 Skills 重复：当检测到旧版 ~/.codex/skills/ 时，同步 codex 会迁移到 ~/.agents/skills/ 并清理遗留目录；若与现有目录冲突则备份到 ~/.ling/backups/global/<timestamp>/codex-legacy/...。

ling-1.2.1 - 2026-03-14

修复

• 修正 Codex 全局 Skill 安装根目录：ling global sync --target codex 与 ling spec enable --target codex 现在统一写入官方要求的 ~/.agents/skills/，不再误写到旧的 ~/.codex/skills/。
• 兼容旧版 Spec 状态：历史 state.json 中记录的 ~/.codex/skills/... 路径会在读取时自动迁移为 ~/.agents/skills/...，避免修复后仍引用旧路径。
• 增加旧路径诊断：若用户机器上只存在旧版 ~/.codex/skills/，ling global status 会返回 broken 并提示执行 ling global sync --target codex 修复。

ling-1.2.0 - 2026-03-14

新增

• antigravity 作为独立目标进入 CLI 主链路：init/update/update-all/status/doctor/global sync/spec enable|disable 均可直接指定，不再由 gemini 隐式代管。
• 共享 .agent/ 工作区新增本地安装状态文件 .ling/install-state.json，用于准确记录 gemini / antigravity 的逻辑注册身份，即使工作区未写入全局索引也能正确识别。

变更

• 全局同步默认目标调整为 codex + gemini + antigravity；--target gemini 仅写入 ~/.gemini/skills/，--target antigravity 仅写入 ~/.gemini/antigravity/skills/。
• README、TECH、PLAN 与测试基线同步对齐新的三目标语义，并补充共享 .agent/ 的状态识别说明。
• 健康检查与维护链路统一收口到 npm，Web 子项目不再保留 bun.lock。

维护

• reference/ 清理重复官方资料：删除 reference/official-docs/ 镜像，仅保留 reference/official/ 单份受管参考。
• 根目录与 reference/.gitignore 调整为白名单模式，仅跟踪 reference/official/、reference/docs-archive/ 等保留资料。

ling-1.1.1 - 2026-03-14

新增

• Spec 项目级工作区初始化与诊断：新增 ling spec init / ling spec doctor，在工作区落盘 .ling/spec 资产与 issues.csv 校验。
• Spec Profiles 资产：全局与项目级均包含 profiles/，并纳入完整性校验与回退语义。
• Spec 资产分支拉取：ling spec init --branch <name> 支持从指定分支的 .spec/ 拉取 templates/references/profiles。

变更

• Spec 状态判定强化：ling spec status 增加文件级完整性校验，且在 state.json 缺失但检测到残留 artifacts 时返回 broken 并给出修复提示。
• CI 改为 npm：CI 矩阵不再依赖 bun，统一使用 npm ci/test/run 执行验证。

ling-1.1.0 - 2026-03-13

新增

• 已有资产冲突处理：init/update/update-all/global sync/spec enable 在交互终端逐项确认（保留 / 备份后移除 / 直接移除），并支持按资产类别复用选择。
• 预备份与回退：项目级覆盖前快照落盘到 .agent-backup/.agents-backup；全局与 Spec 维持快照备份路径。

维护

• ag-kit 更名清理：内部 CLI 入口更名为 bin/ling-cli.js，并移除 AG_KIT_* 兼容环境变量与 ~/.ag-kit 控制目录迁移逻辑。
• 托管区块标记更名为 LING MANAGED BLOCK，并兼容识别旧 AG-KIT 标记后自动迁移。

ling-1.0.2 - 2026-03-13

变更

• npm 全局命令：移除 ag-kit bin 别名，仅保留 ling。

ling-1.0.1 - 2026-03-13

修复

• 健康检查脚本：允许 ling spec status --quiet 在 missing 状态返回非 0 退出码，并继续校验输出内容。
• Web 文档站 lint：移除 useEffect 内同步 setState 的用法，改为渲染期平台判断并对快捷键提示增加 suppressHydrationWarning。

维护

• CLI 入口权限：bin/ling.js 设置为可执行，保持与 bin/ling-cli.js 一致。

ling-1.0.0 - 2026-03-13

版本与标签

• npm 包版本遵循 SemVer：1.0.0
• git tag 与 CLI 显示统一使用：ling-1.0.0

新增

• 品牌更名基础设施：
  • 主命令切换为 ling
  • 目标目录结构：gemini -> .agent/，codex -> .agents/
  • 控制目录、索引和备份默认迁移到 ~/.ling/
  • antigravity.rules 收敛为 ling.rules
• Spec Profile 全局层最小闭环：
  • ling spec status
  • ling spec enable
  • ling spec disable
  • 内置 harness-engineering 与 cybernetic-systems-engineering
  • 内置 templates / references 资产与回退能力

修复

• 分发模板与脚本文本清理装饰性字符：避免在模板文本与脚本输出中使用 Emoji 或装饰性 Unicode，提升跨平台终端显示一致性。
• Web 文档站快捷键提示对齐跨平台：搜索入口提示使用 Cmd + K（macOS）或 Ctrl + K（其他平台）。
• 安全扫描器稳定性改进：减少自扫误报、提升依赖锁文件识别准确性，并验证 Web 基础安全响应头配置。

Legacy

本项目在 Ling 重启前的 2.x/3.x 版本记录已冻结，不再维护。

Ling 1.2.1

修复

• 修正 Codex 全局 Skill 安装根目录：ling global sync --target codex 与 ling spec enable --target codex 现在统一写入 ~/.agents/skills/。
• 兼容旧版 Spec 状态：历史 state.json 中记录的 ~/.codex/skills/... 路径会自动迁移为 ~/.agents/skills/...。
• 增加旧路径诊断：若机器上仅存在旧版 ~/.codex/skills/，ling global status 会返回 broken 并提示执行修复命令。
• 修正 health-check 对 Codex 全局 Skill 根目录的检查路径。

验证

• npm test
• npm run ci:verify
• npm run health-check
• npm pack --dry-run

Ling 1.2.0

新增

• antigravity 作为独立目标进入 CLI 主链路：init/update/update-all/status/doctor/global sync/spec enable|disable 均可直接指定。
• 共享 .agent/ 工作区新增 .ling/install-state.json，无索引时也能正确识别 gemini / antigravity 的逻辑注册身份。

变更

• 全局同步默认目标调整为 codex + gemini + antigravity；gemini 与 antigravity 不再互相隐式代管。
• README、TECH、PLAN 与 CI 验证链路已对齐新目标语义；健康检查统一收口到 npm。

维护

• 清理 reference/official-docs/ 重复镜像，仅保留 reference/official/ 单份官方参考资料。
• reference 忽略规则改为白名单，仅保留受管参考资料。

v3.0.0

3.0.0 正式版

重点变化

• 仓库模板源统一收敛到 .agents/，旧 .agent/ 仅保留输入兼容
• 项目级 Codex 体系稳定到 .agents/，并支持从遗留 .codex/ 自动迁移
• 新增并稳定 ag-kit global sync/status 全局 Skills 生命周期
• 全局路径对齐真实工具消费端：
  • codex -> ~/.codex/skills/
  • gemini -> ~/.gemini/skills/ + ~/.gemini/antigravity/skills/
• status/global status --quiet 收紧为三态契约：installed / broken / missing
• update-all 已兼容历史索引 targets.full

验证

• bun run test
• bun run ci:verify
• bun run health-check
• cd web && bun run lint

升级建议

• 老用户可直接执行 ag-kit update 或 ag-kit update-all
• 如曾使用 3.0.0-beta.0，请升级到 3.0.0 正式版；beta 已废弃

Ling 1.1.1

• Spec 项目级工作区初始化与诊断：新增 ling spec init / ling spec doctor\n- Spec Profiles 资产纳入完整性校验与回退语义\n- Spec 资产分支拉取：ling spec init --branch 支持从分支 .spec/ 拉取\n- Spec status 文件级完整性校验 + orphan 检测与修复提示\n- CI 改为 npm 矩阵（macOS/Windows/Ubuntu + Node 22/24），并在分支 push 时运行

Ling 1.1.0

• 新增：已有资产冲突处理（交互逐项确认，支持按类别复用；保留/备份后移除/直接移除）\n- 新增：项目级覆盖前预备份（.agent-backup/.agents-backup）与全局/Spec 备份回退路径说明\n- 维护：ag-kit 历史命名清理（CLI 内部入口更名为 bin/ling-cli.js；移除 AG_KIT_* 环境变量与 ~./ag-kit 迁移逻辑）\n- 维护：托管区块标记更名为 LING MANAGED BLOCK，兼容旧 AG-KIT 标记自动迁移\n

ling-1.0.2

• npm 全局命令：移除 ag-kit bin 别名，仅保留 ling

ling-1.0.1

• 健康检查脚本：允许 spec status 在 missing 状态返回非 0 退出码并继续校验输出\n- Web 文档站：修复 setState-in-effect lint

ling-1.0.0

[ling-1.0.0] - 2026-03-13

版本与标签

• npm 包版本遵循 SemVer：1.0.0
• git tag 与 CLI 显示统一使用：ling-1.0.0

新增

• 品牌更名基础设施：
  • 主命令切换为 ling
  • ag-kit 保留兼容入口
  • 目标目录结构：gemini -> .agent/，codex -> .agents/
  • 控制目录、索引和备份默认迁移到 ~/.ling/
  • antigravity.rules 收敛为 ling.rules
• Spec Profile 全局层最小闭环：
  • ling spec status
  • ling spec enable
  • ling spec disable
  • 内置 harness-engineering 与 cybernetic-systems-engineering
  • 内置 templates / references 资产与回退能力

修复

• 分发模板与脚本文本清理装饰性字符：避免在模板文本与脚本输出中使用 Emoji 或装饰性 Unicode，提升跨平台终端显示一致性。
• Web 文档站快捷键提示对齐跨平台：搜索入口提示使用 Cmd + K（macOS）或 Ctrl + K（其他平台）。
• 安全扫描器稳定性改进：减少自扫误报、提升依赖锁文件识别准确性，并验证 Web 基础安全响应头配置。

[Deprecated] v3.0.0-beta.0

已废弃

该 beta 版本已被 v3.0.0 正式版取代，请不要继续使用。

• npm：请升级到 @mison/ag-kit-cn@3.0.0
• GitHub Release：请改用 v3.0.0