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

2026-06-02 00:57:41 +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/knowledge/index.mdx
+++ b/docs/knowledge/index.mdx
@@ -1,96 +1,93 @@
 ---
-title: 个人知识库
-description: CowAgent 的个人知识库系统 — 结构化知识沉淀、自动整理与知识图谱
+title: Personal Knowledge Base
+description: CowAgent personal knowledge base — structured knowledge accumulation, automatic organization, and knowledge graph
 ---

-个人知识库是 Agent 的长期结构化知识存储，保存在工作空间的 `knowledge/` 目录下。与按时间线组织的记忆不同，知识库以主题为维度，将用户分享的文章、对话中的洞察、学习材料等整理为互相关联的 Markdown 页面，形成可持续增长的知识网络。
+The personal knowledge base is the Agent's long-term structured knowledge store, saved in the `knowledge/` directory within the workspace. Unlike memory, which is organized by timeline, the knowledge base organizes content by topic — articles, conversation insights, and learning materials are structured into interlinked Markdown pages, forming a continuously growing knowledge network.

 <Frame>
  <img src="https://cdn.link-ai.tech/doc/20260413105435.png" width="800" />
 </Frame>

-## 核心概念
+## Core Concepts

-### 知识 vs 记忆
+### Knowledge vs Memory

-| 维度 | 知识库（knowledge/） | 长期记忆（memory/） |
+| Dimension | Knowledge Base (knowledge/) | Long-term Memory (memory/) |
 | --- | --- | --- |
-| 组织方式 | 按主题分类、互相关联 | 按时间线、日期文件 |
-| 写入方式 | Agent 主动整理结构化内容 | 上下文裁剪时自动摘要 |
-| 内容特点 | 提炼后的结构化知识 | 原始对话摘要 |
-| 典型用途 | 学习笔记、技术文档、项目知识 | 对话历史、事件记录 |
+| Organization | By topic, interlinked | By timeline, dated files |
+| Writing | Agent actively structures content | Auto-summarized on context trimming |
+| Content | Refined, structured knowledge | Raw conversation summaries |
+| Use cases | Study notes, tech docs, project knowledge | Conversation history, event records |

-### 目录结构
+### Directory Structure

 ```
 ~/cow/knowledge/
-├── index.md          # 知识索引，所有页面的入口
-├── log.md            # 变更日志，记录每次写入
-├── concepts/         # 概念类知识
+├── index.md          # Knowledge index, entry point for all pages
+├── log.md            # Change log, records each write
+├── concepts/         # Conceptual knowledge
 │   └── machine-learning.md
-├── entities/         # 实体类知识（人物、组织、工具）
+├── entities/         # Entity knowledge (people, orgs, tools)
 │   └── openai.md
-└── sources/          # 来源类知识（文章、论文）
+└── sources/          # Source knowledge (articles, papers)
    └── llm-wiki.md
 ```

-目录结构是灵活的 — Agent 会根据实际内容自动创建合适的分类目录。用户也可以通过对话的方式自定义目录组织方式。
+The directory structure is flexible — the Agent automatically creates appropriate category directories based on actual content. Users can also customize the organization.

+## Automatic Organization
+
+Knowledge writing is an autonomous Agent behavior, triggered in these scenarios:
+
+- **User shares an article or document** — The Agent automatically extracts key information and creates a structured knowledge page
+- **Conversation produces valuable conclusions** — The Agent organizes insights into knowledge pages and links them to existing knowledge
+- **User explicitly requests organization** — Users can guide the Agent to organize and update knowledge through conversation
+
+Each knowledge page includes cross-reference links to related pages, gradually building a knowledge graph.

 <Frame>
  <img src="https://cdn.link-ai.tech/doc/20260413110104.png" width="800" />
 </Frame>

-## 自动整理
+## Knowledge Retrieval

-知识库的写入是 Agent 的自主行为，在以下场景中触发：
+The Agent can retrieve knowledge during conversation through:

- **用户分享文章或文档** — Agent 自动提取关键信息，创建结构化知识页面
- **对话产生有价值的结论** — Agent 将洞察整理为知识页面，并与已有知识建立关联
- **用户主动要求整理** — 用户可以通过对话指导 Agent 组织和更新知识
+- **Index lookup** — Quickly locate relevant pages via `knowledge/index.md`
+- **Semantic search** — Search knowledge content via the `memory_search` tool
+- **Direct read** — Read specific knowledge files via the `memory_get` tool
+
+## Web Console
+
+The web console provides a dedicated "Knowledge" module with:
+
+- **Document browsing** — Tree-style directory structure, searchable and collapsible, click to view content
+- **Knowledge graph** — Interactive graph visualizing relationships between knowledge pages
+- **Chat integration** — Knowledge document links referenced in Agent replies are clickable for direct navigation

 <Frame>
  <img src="https://cdn.link-ai.tech/doc/17aad553d3e9e428c52ff9dc31726fda.png" width="800" />
 </Frame>

-
-每个知识页面都包含与其他页面的交叉引用链接，逐步构建起一个知识图谱。
-
-## 知识检索
-
-Agent 在对话中可以通过以下方式检索知识：
-
- **索引查阅** — 通过 `knowledge/index.md` 快速定位相关知识页面
- **语义搜索** — 通过 `memory_search` 工具对知识库内容进行语义检索
- **直接读取** — 通过 `memory_get` 工具读取特定知识文件
-
-## Web 控制台
-
-Web 控制台提供了专用的「知识」模块，支持：
-
- **文档浏览** — 树状目录结构，可搜索、可折叠，点击查看文档内容
- **知识图谱** — 可视化展示知识之间的关联关系，节点可直接跳转至文档
- **对话联动** — Agent 回复中引用的知识文档链接可直接点击跳转查看
-
 <Frame>
  <img src="https://cdn.link-ai.tech/doc/20260413105402.png" width="800" />
 </Frame>

+## CLI Commands

-## CLI 命令
+Manage the knowledge base with the `/knowledge` command:

-通过 `/knowledge` 命令管理知识库：
-
-| 命令 | 说明 |
+| Command | Description |
 | --- | --- |
-| `/knowledge` | 显示知识库统计信息 |
-| `/knowledge list` | 以树状结构显示文件目录 |
-| `/knowledge on` | 开启知识库功能 |
-| `/knowledge off` | 关闭知识库功能 |
+| `/knowledge` | Show knowledge base statistics |
+| `/knowledge list` | Display file directory as a tree |
+| `/knowledge on` | Enable the knowledge base feature |
+| `/knowledge off` | Disable the knowledge base feature |

-## 相关配置
+## Configuration

-| 参数 | 说明 | 默认值 |
+| Parameter | Description | Default |
 | --- | --- | --- |
-| `knowledge` | 是否启用个人知识库功能 | `true` |
-| `agent_workspace` | 工作空间路径，知识库存储在此目录的 `knowledge/` 子目录下 | `~/cow` |
+| `knowledge` | Whether to enable the personal knowledge base | `true` |
+| `agent_workspace` | Workspace path; knowledge is stored under the `knowledge/` subdirectory | `~/cow` |