code-repo-wiki 0.5.0

# AGENTS.md — AI 代理导航（由 code-repo-wiki 生成，可人工编辑）

本仓库使用 code-repo-wiki 维护可持续进化的项目 Wiki，产物位于 `.code-repo-wiki/`。

## 产物布局

- `.code-repo-wiki/wiki/{lang}/` — 模块页（每模块一份，含职责/实体/依赖/使用示例）
- `.code-repo-wiki/wiki/{lang}/api.md` — API 参考（按模块分组）
- `.code-repo-wiki/wiki/{lang}/architecture.md` — 架构概览
- `.code-repo-wiki/wiki/{lang}/overview.md` — 项目概览（自底向上合成）
- `.code-repo-wiki/cards/{lang}/` — Knowledge Card（AI 代理的结构化摘要，JSON 元数据+Markdown）
- `.code-repo-wiki/assets/diagrams/` — Mermaid 调用图/依赖图

## AI 代理使用指引

1. 先读 `.code-repo-wiki/wiki/{lang}/overview.md` 与 `architecture.md` 建立全局认知，
   再按需深入模块页。
2. 查找实体（函数/结构体/类）用 `code-repo-wiki search -q "<关键词>"`（支持
   text/semantic/hybrid 三引擎，hybrid 含调用链补全）。
3. 修改代码后运行 `code-repo-wiki update` 增量更新；`code-repo-wiki sync` 以 Git 内容
   合入；`code-repo-wiki lint` 检查产物健康（孤儿页/断链/过时）。
4. 人工修改产物页面后不会被自动覆盖（保护机制），修改会反向同步到卡片
   （pending_manual_edits 节）。
5. 知识沉淀：`code-repo-wiki note "<记录>"` 追加到 `.code-repo-wiki/wiki/{lang}/_log.md`。