feat: docs update

2026-07-20 21:57:14 +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/en/intro/architecture.mdx
+++ b/docs/en/intro/architecture.mdx
@@ -0,0 +1,71 @@
+---
+title: Architecture
+description: CowAgent 2.0 system architecture and core design
+---
+
+CowAgent 2.0 has evolved from a simple chatbot into a super intelligent assistant with Agent architecture, featuring autonomous thinking, task planning, long-term memory, and skill extensibility.
+
+## System Architecture
+
+CowAgent's architecture consists of the following core modules:
+
+<img src="https://cdn.link-ai.tech/doc/68ef7b212c6f791e0e74314b912149f9-sz_5847990.png" alt="CowAgent Architecture" />
+
+### Core Modules
+
+| Module | Description |
+| --- | --- |
+| **Channels** | Message channel layer for receiving and sending messages. Supports Web, Feishu, DingTalk, WeCom, WeChat Official Account, and more |
+| **Agent Core** | Agent engine including task planning, memory system, and skills engine |
+| **Tools** | Tool layer for Agent to access OS resources. 10+ built-in tools |
+| **Models** | Model layer with unified access to mainstream LLMs |
+
+## Agent Mode Workflow
+
+When Agent mode is enabled, CowAgent runs as an autonomous agent with the following workflow:
+
+1. **Receive Message** — Receive user input through channels
+2. **Understand Intent** — Analyze task requirements and context
+3. **Plan Task** — Break complex tasks into multiple steps
+4. **Invoke Tools** — Select and execute appropriate tools for each step
+5. **Update Memory** — Store important information in long-term memory
+6. **Return Result** — Send execution results back to the user
+
+## Workspace Directory Structure
+
+The Agent workspace is located at `~/cow` by default and stores system prompts, memory files, and skill files:
+
+```
+~/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
+```
+
+## Core Configuration
+
+Configure Agent mode parameters in `config.json`:
+
+```json
+{
+  "agent": true,
+  "agent_workspace": "~/cow",
+  "agent_max_context_tokens": 40000,
+  "agent_max_context_turns": 30,
+  "agent_max_steps": 15
+}
+```
+
+| Parameter | Description | Default |
+| --- | --- | --- |
+| `agent` | Enable Agent mode | `true` |
+| `agent_workspace` | Workspace path | `~/cow` |
+| `agent_max_context_tokens` | Max context tokens | `40000` |
+| `agent_max_context_turns` | Max context turns | `30` |
+| `agent_max_steps` | Max decision steps per task | `15` |
--- a/docs/en/intro/features.mdx
+++ b/docs/en/intro/features.mdx
@@ -0,0 +1,105 @@
+---
+title: Features
+description: CowAgent long-term memory, task planning, and skills system in detail
+---
+
+## 1. Long-term Memory
+
+The memory system enables the Agent to remember important information over time. The Agent proactively stores information when users share preferences, decisions, or key facts, and automatically extracts summaries when conversations reach a certain length. Memory is divided into core memory and daily memory, with hybrid retrieval supporting both keyword search and vector search.
+
+On first launch, the Agent proactively asks the user for key information and records it in the workspace (default `~/cow`) — including agent settings, user identity, and memory files.
+
+In subsequent long-term conversations, the Agent intelligently stores or retrieves memory as needed, continuously updating its own settings, user preferences, and memory files, summarizing experiences and lessons learned — truly achieving autonomous thinking and continuous growth.
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260203000455.png" width="800" />
+</Frame>
+
+## 2. Task Planning and Tool Use
+
+Tools are the core of how the Agent accesses operating system resources. The Agent intelligently selects and invokes tools based on task requirements, performing file read/write, command execution, scheduled tasks, and more. Built-in tools are implemented in the project's `agent/tools/` directory.
+
+**Key tools:** file read/write/edit, Bash terminal, file send, scheduler, memory search, web search, environment config, and more.
+
+### 2.1 Terminal and File Access
+
+Access to the OS terminal and file system is the most fundamental and core capability. Many other tools and skills build on top of this. Users can interact with the Agent from a mobile device to operate resources on their personal computer or server:
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202181130.png" width="800" />
+</Frame>
+
+### 2.2 Programming Capability
+
+Combining programming and system access, the Agent can execute the complete **Vibecoding workflow** — from information search, asset generation, coding, testing, deployment, Nginx configuration, to publishing — all triggered by a single command from your phone:
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260203121008.png" width="800" />
+</Frame>
+
+### 2.3 Scheduled Tasks
+
+The `scheduler` tool enables dynamic scheduled tasks, supporting **one-time tasks, fixed intervals, and Cron expressions**. Tasks can be triggered as either a **fixed message send** or an **Agent dynamic task** execution:
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202195402.png" width="800" />
+</Frame>
+
+### 2.4 Environment Variable Management
+
+Secrets required by skills are stored in an environment variable file, managed by the `env_config` tool. You can update secrets through conversation, with built-in security protection and desensitization:
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202234939.png" width="800" />
+</Frame>
+
+## 3. Skills System
+
+The Skills system provides infinite extensibility for the Agent. Each Skill consists of a description file, execution scripts (optional), and resources (optional), describing how to complete specific types of tasks. Skills allow the Agent to follow instructions for complex workflows, invoke tools, or integrate third-party systems.
+
+- **Built-in skills:** Located in the project's `skills/` directory, including skill creator, image recognition, LinkAI agent, web fetch, and more. Built-in skills are automatically enabled based on dependency conditions (API keys, system commands, etc.).
+- **Custom skills:** Created by users through conversation, stored in the workspace (`~/cow/skills/`), capable of implementing any complex business process or third-party integration.
+
+### 3.1 Creating Skills
+
+The `skill-creator` skill enables rapid skill creation through conversation. You can ask the Agent to codify a workflow as a skill, or send any API documentation and examples for the Agent to complete the integration directly:
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202202247.png" width="800" />
+</Frame>
+
+### 3.2 Web Search and Image Recognition
+
+- **Web search:** Built-in `web_search` tool, supports multiple search engines. Configure `BOCHA_API_KEY` or `LINKAI_API_KEY` to enable.
+- **Image recognition:** Built-in `openai-image-vision` skill, supports `gpt-4.1-mini`, `gpt-4.1`, and other models. Requires `OPENAI_API_KEY`.
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202213219.png" width="800" />
+</Frame>
+
+### 3.3 Third-party Knowledge Bases and Plugins
+
+The `linkai-agent` skill makes all agents on [LinkAI](https://link-ai.tech/) available as Skills for the Agent, enabling multi-agent decision making.
+
+Configuration: set `LINKAI_API_KEY` via `env_config`, then add agent descriptions in `skills/linkai-agent/config.json`:
+
+```json
+{
+  "apps": [
+    {
+      "app_code": "G7z6vKwp",
+      "app_name": "LinkAI Customer Support",
+      "app_description": "Select only when the user needs help with LinkAI platform questions"
+    },
+    {
+      "app_code": "SFY5x7JR",
+      "app_name": "Content Creator",
+      "app_description": "Use only when the user needs to create images or videos"
+    }
+  ]
+}
+```
+
+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260202234350.png" width="750" />
+</Frame>
--- a/docs/en/intro/index.mdx
+++ b/docs/en/intro/index.mdx
@@ -0,0 +1,68 @@
+---
+title: Introduction
+description: CowAgent - AI Super Assistant powered by LLMs
+---
+
+<img src="https://cdn.link-ai.tech/doc/78c5dd674e2c828642ecc0406669fed7.png" alt="CowAgent" width="600px"/>
+
+**CowAgent** is an AI super assistant powered by LLMs with autonomous task planning, long-term memory, skills system, multimodal messages, multiple model support, and multi-platform deployment.
+
+CowAgent can proactively think and plan tasks, operate computers and external resources, create and execute Skills, and continuously grow with long-term memory. It supports flexible switching between multiple models, handles text, voice, images, files and other multimodal messages, and can be integrated into web, Feishu, DingTalk, WeCom, and WeChat Official Account. It runs 7x24 hours on your personal computer or server.
+
+<Card title="GitHub" icon="github" href="https://github.com/zhayujie/chatgpt-on-wechat">
+  github.com/zhayujie/chatgpt-on-wechat
+</Card>
+
+## Core Capabilities
+
+<CardGroup cols={2}>
+  <Card title="Autonomous Task Planning" icon="brain" href="/en/intro/architecture">
+    Understands complex tasks and autonomously plans execution, continuously thinking and invoking tools until goals are achieved. Supports accessing file systems, terminals, browsers, schedulers, and other system resources through tools.
+  </Card>
+  <Card title="Long-term Memory" icon="database" href="/en/memory">
+    Automatically persists conversation memory to local files and databases, including core memory and daily memory, with keyword and vector retrieval support.
+  </Card>
+  <Card title="Skills System" icon="puzzle-piece" href="/en/skills/index">
+    Implements a Skills creation and execution engine with built-in skills, and supports custom Skills development through natural language conversation.
+  </Card>
+  <Card title="Multimodal Messages" icon="image" href="/en/channels/web">
+    Supports parsing, processing, generating, and sending text, images, voice, files, and other message types.
+  </Card>
+  <Card title="Multiple Model Support" icon="microchip" href="/en/models/index">
+    Supports mainstream model providers including OpenAI, Claude, Gemini, DeepSeek, MiniMax, GLM, Qwen, Kimi, Doubao, and more.
+  </Card>
+  <Card title="Multi-platform Deployment" icon="server" href="/en/channels/web">
+    Runs on local computers or servers, integrable into web, Feishu, DingTalk, WeChat Official Account, and WeCom applications.
+  </Card>
+</CardGroup>
+
+## Quick Experience
+
+Run the following command in your terminal for one-click install, configuration, and startup:
+
+```bash
+bash <(curl -sS https://cdn.link-ai.tech/code/cow/run.sh)
+```
+
+By default, the Web service starts after running. Access `http://localhost:9899/chat` to chat in the web interface.
+
+<CardGroup cols={2}>
+  <Card title="Quick Start" icon="rocket" href="/en/guide/quick-start">
+    Complete installation and run guide
+  </Card>
+  <Card title="Architecture" icon="sitemap" href="/en/intro/architecture">
+    CowAgent system architecture design
+  </Card>
+</CardGroup>
+
+## Disclaimer
+
+1. This project follows the [MIT License](https://github.com/zhayujie/chatgpt-on-wechat/blob/master/LICENSE) and is intended for technical research and learning. Users must comply with local laws, regulations, policies, and corporate bylaws. Any illegal or rights-infringing use is prohibited.
+2. Agent mode consumes more tokens than normal chat mode. Choose models based on effectiveness and cost. Agent has access to the host operating system — deploy with caution.
+3. CowAgent focuses on open-source development and does not participate in, authorize, or issue any cryptocurrency.
+
+## Community
+
+Add our assistant on WeChat to join the open-source community:
+
+<img width="140" src="https://img-1317903499.cos.ap-guangzhou.myqcloud.com/docs/open-community.png" />