feat: docs update

2026-06-02 00:57:41 +08:00 · 2026-02-27 16:03:47 +08:00
parent d891312032
commit 6db22827f2
97 changed files with 2801 additions and 1354 deletions
--- a/docs/intro/architecture.mdx
+++ b/docs/intro/architecture.mdx
@@ -0,0 +1,71 @@
+---
+title: 项目架构
+description: CowAgent 2.0 的系统架构和核心设计
+---
+
+CowAgent 2.0 从简单的聊天机器人全面升级为超级智能助理，采用 Agent 架构设计，具备自主思考、规划任务、长期记忆和技能扩展等能力。
+
+## 系统架构
+
+CowAgent 的整体架构由以下核心模块组成：
+
+<img src="https://cdn.link-ai.tech/doc/68ef7b212c6f791e0e74314b912149f9-sz_5847990.png" alt="CowAgent Architecture" />
+
+### 核心模块说明
+
+| 模块 | 说明 |
+| --- | --- |
+| **Channels** | 消息通道层，负责接收和发送消息，支持 Web、飞书、钉钉、企微、公众号等 |
+| **Agent Core** | 智能体核心引擎，包括任务规划、记忆系统和技能引擎 |
+| **Tools** | 工具层，Agent 通过工具访问操作系统资源，内置 10+ 种工具 |
+| **Models** | 模型层，支持国内外主流大语言模型的统一接入 |
+
+## Agent 模式
+
+启用 Agent 模式后，CowAgent 会以自主智能体的方式运行，核心工作流如下：
+
+1. **接收消息** - 通过通道接收用户输入
+2. **理解意图** - 分析任务需求和上下文
+3. **规划任务** - 将复杂任务分解为多个步骤
+4. **调用工具** - 选择合适的工具执行每个步骤
+5. **记忆更新** - 将重要信息存入长期记忆
+6. **返回结果** - 将执行结果发送回用户
+
+## 工作空间
+
+Agent 的工作空间默认位于 `~/cow` 目录，用于存储系统提示词、记忆文件、技能文件等：
+
+```
+~/cow/
+├── system.md          # Agent system prompt
+├── user.md            # User profile
+├── memory/            # Long-term memory storage
+│   ├── core.md        # Core memory
+│   └── daily/         # Daily memory
+├── skills/            # Custom skills
+│   ├── skill-1/
+│   └── skill-2/
+└── .env               # Secret keys for skills
+```
+
+## 核心配置
+
+在 `config.json` 中配置 Agent 模式的核心参数：
+
+```json
+{
+  "agent": true,
+  "agent_workspace": "~/cow",
+  "agent_max_context_tokens": 40000,
+  "agent_max_context_turns": 30,
+  "agent_max_steps": 15
+}
+```
+
+| 参数 | 说明 | 默认值 |
+| --- | --- | --- |
+| `agent` | 是否启用 Agent 模式 | `true` |
+| `agent_workspace` | 工作空间路径 | `~/cow` |
+| `agent_max_context_tokens` | 最大上下文 token 数 | `40000` |
+| `agent_max_context_turns` | 最大上下文记忆轮次 | `30` |
+| `agent_max_steps` | 单次任务最大决策步数 | `15` |
--- a/docs/intro/features.mdx
+++ b/docs/intro/features.mdx
@@ -0,0 +1,105 @@
+---
+title: 功能介绍
+description: CowAgent 长期记忆、任务规划、技能系统详细说明
+---
+
+## 1. 长期记忆
+
+> 记忆系统让 Agent 能够长期记住重要信息。Agent 会在用户分享偏好、决策、事实等重要信息时主动存储，也会在对话达到一定长度时自动提取摘要。记忆分为核心记忆、天级记忆，支持语义搜索和向量检索的混合检索模式。
+
+第一次启动 Agent 时，Agent 会主动询问关键信息，并记录至工作空间（默认 `~/cow`）中的智能体设定、用户身份、记忆文件中。
+
+在后续的长期对话中，Agent 会在需要时智能记录或检索记忆，并对自身设定、用户偏好、记忆文件等进行不断更新，总结和记录经验和教训，真正实现自主思考和不断成长。
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260203000455.png" width="800" />
+</Frame>
+
+## 2. 任务规划和工具调用
+
+工具是 Agent 访问操作系统资源的核心，Agent 会根据任务需求智能选择和调用工具，完成文件读写、命令执行、定时任务等各类操作。内置工具的实现在项目的 `agent/tools/` 目录下。
+
+**主要工具：** 文件读写编辑、Bash 终端、文件发送、定时调度、记忆搜索、联网搜索、环境配置等。
+
+### 2.1 终端和文件访问
+
+针对操作系统的终端和文件的访问能力，是最基础和核心的工具，其他很多工具或技能都是基于此进行扩展。用户可通过手机端与 Agent 交互，操作个人电脑或服务器上的资源：
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202181130.png" width="800" />
+</Frame>
+
+### 2.2 编程能力
+
+基于编程能力和系统访问能力，Agent 可以实现从信息搜索、图片等素材生成、编码、测试、部署、Nginx 配置修改、发布的 **Vibecoding 全流程**，通过手机端简单的一句命令完成应用的快速 demo：
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260203121008.png" width="800" />
+</Frame>
+
+### 2.3 定时任务
+
+基于 `scheduler` 工具实现动态定时任务，支持**一次性任务、固定时间间隔、Cron 表达式**三种形式，任务触发可选择**固定消息发送**或 **Agent 动态任务**执行两种模式：
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202195402.png" width="800" />
+</Frame>
+
+### 2.4 环境变量管理
+
+技能所需的秘钥存储在环境变量文件中，由 `env_config` 工具进行管理，你可以通过对话的方式更新秘钥，工具内置安全保护和脱敏策略：
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202234939.png" width="800" />
+</Frame>
+
+## 3. 技能系统
+
+技能系统为 Agent 提供无限的扩展性，每个 Skill 由说明文件、运行脚本（可选）、资源（可选）组成，描述如何完成特定类型的任务。通过 Skill 可以让 Agent 遵循说明完成复杂流程、调用各类工具或对接第三方系统。
+
+- **内置技能：** 在项目的 `skills/` 目录下，包含技能创造器、图像识别、LinkAI 智能体、网页抓取等。内置 Skill 根据依赖条件（API Key、系统命令等）自动判断是否启用。
+- **自定义技能：** 由用户通过对话创建，存放在工作空间中（`~/cow/skills/`），可实现任何复杂的业务流程和第三方系统对接。
+
+### 3.1 创建技能
+
+通过 `skill-creator` 技能可以通过对话的方式快速创建技能。你可以让 Agent 将某个工作流程固化为技能，或者把任意接口文档和示例发送给 Agent，让他直接完成对接：
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202202247.png" width="800" />
+</Frame>
+
+### 3.2 搜索和图像识别
+
+- **联网搜索：** 内置 `web_search` 工具，支持多种搜索引擎，配置 `BOCHA_API_KEY` 或 `LINKAI_API_KEY` 后启用。
+- **图像识别：** 内置 `openai-image-vision` 技能，可使用 `gpt-4.1-mini`、`gpt-4.1` 等模型，依赖 `OPENAI_API_KEY`。
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202213219.png" width="800" />
+</Frame>
+
+### 3.3 三方知识库和插件
+
+`linkai-agent` 技能可以将 [LinkAI](https://link-ai.tech/) 上的所有智能体作为 Skill 交给 Agent 使用，实现多智能体决策效果。
+
+配置方式：通过 `env_config` 配置 `LINKAI_API_KEY`，并在 `skills/linkai-agent/config.json` 中添加智能体说明：
+
+```json
+{
+  "apps": [
+    {
+      "app_code": "G7z6vKwp",
+      "app_name": "LinkAI客服助手",
+      "app_description": "当用户需要了解LinkAI平台相关问题时才选择该助手"
+    },
+    {
+      "app_code": "SFY5x7JR",
+      "app_name": "内容创作助手",
+      "app_description": "当用户需要创作图片或视频时才使用该助手"
+    }
+  ]
+}
+```
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202234350.png" width="750" />
+</Frame>
--- a/docs/intro/index.mdx
+++ b/docs/intro/index.mdx
@@ -0,0 +1,62 @@
+---
+title: 项目介绍
+description: CowAgent - 基于大模型的超级AI助理
+---
+
+<img src="https://cdn.link-ai.tech/doc/78c5dd674e2c828642ecc0406669fed7.png" alt="CowAgent" width="600px"/>
+
+**CowAgent** 是基于大模型的超级AI助理，能够主动思考和任务规划、操作计算机和外部资源、创造和执行Skills、拥有长期记忆并不断成长。
+
+CowAgent 支持灵活切换多种模型，能处理文本、语音、图片、文件等多模态消息，可接入网页、飞书、钉钉、企业微信应用、微信公众号中使用，7×24小时运行于你的个人电脑或服务器中。
+
+<Card title="GitHub" icon="github" href="https://github.com/zhayujie/chatgpt-on-wechat">
+  github.com/zhayujie/chatgpt-on-wechat
+</Card>
+
+## 核心能力
+
+<CardGroup cols={2}>
+  <Card title="复杂任务规划" icon="brain" href="/intro/architecture">
+    能够理解复杂任务并自主规划执行，持续思考和调用工具直到完成目标，支持通过工具操作访问文件、终端、浏览器、定时任务等系统资源。
+  </Card>
+  <Card title="长期记忆" icon="database" href="/memory">
+    自动将对话记忆持久化至本地文件和数据库中，包括全局记忆和天级记忆，支持关键词及向量检索。
+  </Card>
+  <Card title="技能系统" icon="puzzle-piece" href="/skills/index">
+    实现了Skills创建和运行的引擎，内置多种技能，并支持通过自然语言对话完成自定义Skills开发。
+  </Card>
+  <Card title="多模态消息" icon="image" href="/channels/web">
+    支持对文本、图片、语音、文件等多类型消息进行解析、处理、生成、发送等操作。
+  </Card>
+  <Card title="多模型接入" icon="microchip" href="/models/index">
+    支持 OpenAI, Claude, Gemini, DeepSeek, MiniMax, GLM, Qwen, Kimi, Doubao 等国内外主流模型厂商。
+  </Card>
+  <Card title="多端部署" icon="server" href="/channels/web">
+    支持运行在本地计算机或服务器，可集成到网页、飞书、钉钉、微信公众号、企业微信应用中使用。
+  </Card>
+</CardGroup>
+
+## 快速体验
+
+在终端执行以下命令，即可一键安装、配置、启动 CowAgent：
+
+```bash
+bash <(curl -sS https://cdn.link-ai.tech/code/cow/run.sh)
+```
+
+运行后默认会启动 Web 服务，通过访问 `http://localhost:9899/chat` 在网页端对话。
+
+<CardGroup cols={2}>
+  <Card title="快速开始" icon="rocket" href="/guide/quick-start">
+    查看完整的安装和运行指南
+  </Card>
+  <Card title="项目架构" icon="sitemap" href="/intro/architecture">
+    了解 CowAgent 的系统架构设计
+  </Card>
+</CardGroup>
+
+## 社区
+
+添加小助手微信加入开源项目交流群：
+
+<img width="140" src="https://img-1317903499.cos.ap-guangzhou.myqcloud.com/docs/open-community.png" />