docs: make English the default docs language and fix link paths

2026-07-20 05:27:59 +08:00 · 2026-05-31 17:52:22 +08:00
parent 126649f70f
commit 7bf4ef3d05
231 changed files with 8999 additions and 8974 deletions
--- a/docs/zh/skills/knowledge-wiki.mdx
+++ b/docs/zh/skills/knowledge-wiki.mdx
@@ -0,0 +1,112 @@
+---
+title: knowledge-wiki - 知识库
+description: 维护本地结构化知识库，自动归档、分类和交叉引用
+---
+
+帮你把对话中产生的资料、灵感和零散笔记整理成结构化的本地知识库，自动维护索引和页面之间的交叉引用。
+
+`knowledge-wiki` 在工作空间下维护一个 `knowledge/` 目录，相当于 Agent 的「外脑」。技能设置了 `always: true`，会**常驻上下文**，不需要任何外部依赖。
+
+## 什么时候会触发
+
+- 你分享了一篇文章、一份文档或一个 URL，想要沉淀下来
+- 聊天过程中聊出了值得长期保留的结论
+- 你想查一下之前积累过的知识
+
+## 目录结构
+
+```
+knowledge/
+├── index.md           # 全局索引（必须维护）
+├── log.md             # 操作日志（只追加）
+└── <category>/        # 分类子目录（按内容自由分组）
+    └── <slug>.md      # 知识页（文件名用小写加中划线）
+```
+
+## 三个核心操作
+
+### 1. 收录（Ingest）
+
+你分享了一段资料时，Agent 会：
+
+1. 读懂原文，提取关键信息
+2. 按内容决定放到哪个分类下——先看 `index.md` 里有没有合适的分类，没有就新建一个
+3. 生成知识页 `knowledge/<category>/<slug>.md`
+4. 更新索引 `index.md` 和日志 `log.md`
+
+### 2. 综合（Synthesize）
+
+聊天中产生了新的结论或洞见时：
+
+1. 在合适的分类下创建新知识页
+2. 给相关的已有页面加上互相指向的链接
+3. 更新索引和日志
+
+### 3. 查询（Query）
+
+你问到以前积累的知识时：
+
+1. 先从 `index.md` 里找可能相关的页面
+2. 用 `read` 工具打开具体页面
+3. 需要时再用 `memory_search` 补充检索
+4. 回答里会带上知识页的链接，方便你点过去看原文
+
+## 知识页怎么写
+
+```markdown
+# 页面标题
+
+> Source: <来源 URL 或简要说明>
+
+正文内容。页面之间用相对路径链接：
+[相关页](../category/related-page.md)
+
+## 要点
+
+- ...
+
+## 相关页面
+
+- [页面 A](../category/page-a.md) — 为什么相关
+```
+
+<Note>
+- `> Source:` 用来记录这条知识的来源。有明确来源时一定要写
+- 交叉引用很重要：创建或更新某页时，记得也去关联页面里补上反向链接
+- **只链接已经存在的页面**。如果某个概念值得单独成页，先建好再加链接
+</Note>
+
+## 索引格式
+
+`knowledge/index.md` 采用扁平列表，按分类分组，每个知识页占一行：
+
+```markdown
+# Knowledge Index
+
+## 分类 A
+- [页面标题](category-a/page-slug.md) — 一句话摘要
+
+## 分类 B
+- [页面标题](category-b/page-slug.md) — 一句话摘要
+```
+
+不用表格，不加 emoji。分类怎么起名、怎么组织都可以灵活调整。
+
+## 日志格式
+
+`knowledge/log.md` 只追加、不修改，最新的写在最下面：
+
+```markdown
+## [YYYY-MM-DD] ingest | 页面标题
+## [YYYY-MM-DD] synthesize | 页面标题
+```
+
+## 写作约定
+
+- **文件名**用小写加中划线，比如 `machine-learning.md`
+- **一页只讲一件事**，需要关联的内容通过链接串起来
+- **有了就更新，不要重复建页**
+- **每次改完都要更新索引** `knowledge/index.md`
+- **写精华别抄全文**，抓住要点就行
+- **对话里引用知识页时用完整路径**，比如 `[标题](knowledge/<category>/<slug>.md)`。页面之间互相链接才用相对路径
+- **基于知识页回答问题时附上链接**，方便深入查阅