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

This commit is contained in:
zhayujie
2026-05-31 17:52:22 +08:00
parent 126649f70f
commit 7bf4ef3d05
231 changed files with 8999 additions and 8974 deletions

View File

@@ -1,17 +1,17 @@
---
title: 常用命令
description: 查看状态、管理配置和上下文等常用命令
title: General Commands
description: View status, manage config, and control context with commonly used commands
---
以下命令支持在对话中使用 `/` 前缀,也支持在终端中使用 `cow` 前缀(部分命令仅对话可用)。
The following commands can be used in chat with the `/` prefix or in the terminal with the `cow` prefix (some are chat-only).
<Tip>
在 Web 控制台中输入 `/` 会自动弹出命令提示,支持键盘上下选择和 Tab 补全。
In the Web console, typing `/` brings up an autocomplete menu with keyboard navigation and Tab completion.
</Tip>
## help
显示所有可用命令的帮助信息。
Show help information for all available commands.
```text
/help
@@ -19,29 +19,15 @@ description: 查看状态、管理配置和上下文等常用命令
## status
查看当前会话和服务的运行状态,包括进程信息、模型配置、会话消息数量和已加载技能数量。
View current session and service status, including process info, model configuration, message count, and loaded skills.
```text
/status
```
输出示例:
```
🐮 CowAgent Status
Process: PID 12345 | Running 2h 15m
Version: 2.0.4
Channel: web
Model: MiniMax-M2.5
Mode: agent
Session: 12 messages | 8 skills loaded
```
## cancel
中止当前会话正在运行的 Agent 任务。在 Agent 执行长时间任务(例如多轮工具调用、长流式输出)时,可随时发送 `/cancel`Agent 会在下一次工具执行前停止。Web 端、微信、企业微信、飞书等各通道均可使用。
Abort the agent task currently running in this session. When the agent is busy with a long task (e.g. multi-turn tool calls or a long streaming response), send `/cancel` and the agent will stop before the next tool execution. Available across all channels — Web, WeChat, WeCom, Feishu, etc.
```text
/cancel
@@ -49,67 +35,67 @@ Session: 12 messages | 8 skills loaded
## config
查看或修改运行时配置。修改后立即生效,无需重启服务。
View or modify runtime configuration. Changes take effect immediately without restarting.
**查看所有可配置项:**
**View all configurable items:**
```text
/config
```
**查看单个配置项:**
**View a single item:**
```text
/config model
```
**修改配置项:**
**Modify a config item:**
```text
/config model deepseek-v4-flash
```
**支持修改的配置项:**
**Configurable items:**
| 配置项 | 说明 | 示例值 |
| Item | Description | Example |
| --- | --- | --- |
| `model` | AI 模型名称 | `deepseek-v4-flash` |
| `agent_max_context_tokens` | 最大上下文 tokens | `40000` |
| `agent_max_context_turns` | 最大上下文记忆轮次 | `30` |
| `agent_max_steps` | 单次任务最大决策步数 | `15` |
| `enable_thinking` | 是否启用深度思考模式 | `true` / `false` |
| `model` | AI model name | `deepseek-v4-flash` |
| `agent_max_context_tokens` | Max context tokens | `40000` |
| `agent_max_context_turns` | Max context memory turns | `30` |
| `agent_max_steps` | Max decision steps per task | `15` |
| `enable_thinking` | Enable deep thinking mode | `true` / `false` |
<Note>
修改 `model` 时,系统会自动匹配对应的模型调用方式。配置会写入 `config.json` 并持久保存。
When changing `model`, the system automatically matches the corresponding model API. Configuration is persisted to `config.json`.
</Note>
## context
查看当前会话的上下文信息,包括消息数量、内容长度等统计。
View current session context statistics, including message count and content length.
```text
/context
```
**清空当前会话上下文:**
**Clear current session context:**
```text
/context clear
```
<Tip>
清空上下文后Agent 会"忘记"之前的对话内容,适用于切换话题或释放上下文空间。
Clearing context makes the Agent "forget" previous conversation, useful for switching topics or freeing context space.
</Tip>
## logs
查看最近的服务日志,默认显示最近 20 行,最多 50 行。
View recent service logs. Shows the last 20 lines by default, up to 50.
```text
/logs
```
**指定行数:**
**Specify line count:**
```text
/logs 50
@@ -117,7 +103,7 @@ Session: 12 messages | 8 skills loaded
## version
显示当前 CowAgent 版本号。
Show the current CowAgent version.
```text
/version

View File

@@ -1,31 +1,31 @@
---
title: 命令总览
description: CowAgent 命令系统 — 终端 CLI 和对话命令
title: Commands Overview
description: CowAgent command system — Terminal CLI and chat commands
---
CowAgent 提供两种命令交互方式:
CowAgent provides two ways to interact via commands:
- **终端CLI** — 在系统终端中执行 `cow <命令>`,用于服务管理、技能管理等运维操作
- **对话命令** — 在对话中输入 `/<命令>` `cow <命令>`,用于查看状态、管理技能、调整配置等
- **Terminal CLI** — Run `cow <command>` in your system terminal for service management, skill management, and other operations
- **Chat Commands** — Type `/<command>` or `cow <command>` in any conversation to check status, manage skills, adjust configuration, etc.
## 终端命令
## Cow CLI
通过一键安装脚本部署后,`cow` 命令会自动可用。手动安装的用户需要在项目根目录下额外执行:
After deploying with the one-click install script, the `cow` command is automatically available. For manual installations, run:
```bash
pip install -e .
```
安装后即可在任意位置使用 `cow` 命令:
Then use the `cow` command from anywhere:
```bash
cow help
```
输出示例:
Example output:
```
CowAgent CLI
🐮 CowAgent CLI
Usage: cow <command>
@@ -49,35 +49,33 @@ Others:
version Show version
```
## 对话命令
## Chat Commands
在 Web 控制台或任意接入渠道的对话中,支持输入以 `/` 开头的命令:
In the Web console or any connected channel, type `/` to see command suggestions. Supported commands:
| 命令 | 说明 |
| Command | Description |
| --- | --- |
| `/help` | 显示命令帮助 |
| `/status` | 查看服务状态和配置 |
| `/cancel` | 中止当前正在运行的 Agent 任务 |
| `/config` | 查看或修改运行时配置 |
| `/skill` | 管理技能(安装、卸载、启用、禁用等) |
| `/memory dream [N]` | 手动触发记忆蒸馏(默认 3 天,最大 30 |
| `/knowledge` | 查看知识库统计信息 |
| `/knowledge list` | 查看知识库目录结构 |
| `/knowledge on\|off` | 开启或关闭知识库 |
| `/context` | 查看当前会话上下文信息 |
| `/context clear` | 清空当前会话上下文 |
| `/logs` | 查看最近日志 |
| `/version` | 显示版本号 |
| `/help` | Show command help |
| `/status` | View service status and configuration |
| `/cancel` | Abort the currently running agent task |
| `/config` | View or modify runtime configuration |
| `/skill` | Manage skills (install, uninstall, enable, disable, etc.) |
| `/memory dream [N]` | Manually trigger memory distillation (default 3 days, max 30) |
| `/knowledge` | View knowledge base statistics |
| `/knowledge list` | View knowledge base directory structure |
| `/knowledge on\|off` | Enable or disable knowledge base |
| `/context` | View current session context info |
| `/context clear` | Clear current session context |
| `/logs` | View recent logs |
| `/version` | Show version number |
<Tip>
对话命令中 `/start``/stop``/restart` 等服务管理命令会提示到终端中执行,因为它们涉及进程操作。
Service management commands like `/start`, `/stop`, `/restart` will prompt you to use them in the terminal instead, as they involve process operations.
</Tip>
## 命令对照表
## Command Availability
以下是各命令在终端和对话中的可用性:
| 命令 | 终端 (`cow`) | 对话 (`/`) |
| Command | Terminal (`cow`) | Chat (`/`) |
| --- | :---: | :---: |
| help | ✓ | ✓ |
| version | ✓ | ✓ |
@@ -86,13 +84,13 @@ Others:
| cancel | ✗ | ✓ |
| config | ✗ | ✓ |
| context | — | ✓ |
| memory (子命令) | ✗ | ✓ |
| knowledge (子命令) | ✓ | ✓ |
| skill (子命令) | ✓ | ✓ |
| memory (subcommands) | ✗ | ✓ |
| knowledge (subcommands) | ✓ | ✓ |
| skill (subcommands) | ✓ | ✓ |
| start / stop / restart | ✓ | ✗ |
| update | ✓ | ✗ |
| install-browser | ✓ | ✗ |
<Note>
`context` 在终端中仅提示到对话中使用。`config` 仅支持在对话中修改。
`context` only shows a hint in the terminal to use it in chat. `config` is only available in chat.
</Note>

View File

@@ -1,63 +1,49 @@
---
title: 记忆与知识库
description: 记忆蒸馏和知识库管理命令
title: Memory & Knowledge
description: Memory distillation and knowledge base management commands
---
## memory
管理 Agent 的长期记忆系统。
Manage the Agent's long-term memory system.
### memory dream
手动触发记忆蒸馏Deep Dream整理近期的天级记忆蒸馏合并到 MEMORY.md并生成梦境日记。
Manually trigger memory distillation (Deep Dream) — consolidate recent daily memories into MEMORY.md and generate a dream diary.
```text
/memory dream [N]
```
- `N`:整理近 N 天的记忆,默认 3 天,最大 30
- 蒸馏在后台异步执行,完成后会在对话中通知结果
- 无需等待 Agent 初始化,首次对话前即可使用
- `N`: Consolidate the last N days of memory (default 3, max 30)
- Runs asynchronously in the background; you'll be notified in chat when complete
- Works without Agent initialization — can be used before the first conversation
**示例:**
**Examples:**
```text
/memory dream # 整理近 3 天
/memory dream 7 # 整理近 7 天
/memory dream 30 # 整理近 30 天(全量)
/memory dream # Consolidate last 3 days
/memory dream 7 # Consolidate last 7 days
/memory dream 30 # Consolidate last 30 days (full)
```
蒸馏完成后Web 端会收到带有跳转链接的通知,可直接查看更新后的 MEMORY.md 和梦境日记。
On the Web console, the completion notification includes clickable links to view the updated MEMORY.md and dream diary.
<Tip>
系统每天 23:55 会自动执行一次蒸馏lookback 1 天)。手动触发适用于首次部署后的历史整理,或需要立即更新记忆时使用。
The system automatically runs distillation daily at 23:55 (lookback 1 day). Manual trigger is useful for consolidating historical memories after first deployment, or when you need an immediate memory update.
</Tip>
## knowledge
查看和管理个人知识库。默认显示知识库统计信息。
View and manage the personal knowledge base. Shows statistics by default.
```text
/knowledge
```
输出示例:
```
📚 知识库
- 状态:已开启
- 页面数12
- 总大小45.2 KB
- 分类明细:
- concepts/: 5 篇
- entities/: 4 篇
- sources/: 3 篇
```
### knowledge list
查看知识库目录树结构。
View the knowledge base directory tree.
```text
/knowledge list
@@ -65,7 +51,7 @@ description: 记忆蒸馏和知识库管理命令
### knowledge on / off
开启或关闭知识库。关闭后不再注入知识提示词和索引知识文件。
Enable or disable the knowledge base. When disabled, knowledge prompts and file indexing are not injected.
```text
/knowledge on
@@ -73,5 +59,5 @@ description: 记忆蒸馏和知识库管理命令
```
<Note>
终端 CLI `cow knowledge` `cow knowledge list` 可用,但 `on|off` 仅支持在对话中使用(需实时生效)。
In the terminal CLI, `cow knowledge` and `cow knowledge list` are available, but `on|off` is only supported in chat (requires runtime effect).
</Note>

View File

@@ -1,28 +1,28 @@
---
title: 进程管理
description: 使用 cow 命令管理 CowAgent 进程的启动、停止、重启、更新等操作
title: Process Management
description: Manage CowAgent process lifecycle with cow commands
---
进程管理命令用于控制 CowAgent 后台进程的生命周期。这些命令仅在终端中可用。
Process management commands control the CowAgent background process. These commands are only available in the terminal.
## start
启动 CowAgent 服务。默认以后台进程方式运行,并自动跟踪日志输出。
Start the CowAgent service. Runs as a background daemon by default and automatically tails logs.
```bash
cow start
```
**选项:**
**Options:**
| 选项 | 说明 |
| Option | Description |
| --- | --- |
| `-f`, `--foreground` | 前台运行,不以后台守护进程方式启动 |
| `--no-logs` | 启动后不自动跟踪日志 |
| `-f`, `--foreground` | Run in foreground, not as a background daemon |
| `--no-logs` | Don't tail logs after starting |
## stop
停止正在运行的 CowAgent 服务。
Stop the running CowAgent service.
```bash
cow stop
@@ -30,97 +30,86 @@ cow stop
## restart
重启 CowAgent 服务(先停止再启动)。
Restart the CowAgent service (stop then start).
```bash
cow restart
```
**选项:**
**Options:**
| 选项 | 说明 |
| Option | Description |
| --- | --- |
| `--no-logs` | 重启后不自动跟踪日志 |
| `--no-logs` | Don't tail logs after restart |
## update
更新代码并重启服务。自动执行以下流程:
Update code and restart the service. Automatically performs:
1. 拉取最新代码(`git pull`
2. 停止当前服务
3. 更新 Python 依赖
4. 重新安装 CLI
5. 启动服务
1. Pull latest code (`git pull`)
2. Stop current service
3. Update Python dependencies
4. Reinstall CLI
5. Start service
```bash
cow update
```
<Warning>
如果 `git pull` 失败(如存在本地未提交的修改),更新会中止,服务不受影响。
If `git pull` fails (e.g., uncommitted local changes), the update aborts and the service remains unaffected.
</Warning>
## status
查看 CowAgent 服务运行状态,包括进程信息、版本号、当前配置的模型和通道。
Check CowAgent service status, including process info, version, and current model/channel configuration.
```bash
cow status
```
输出示例:
```
🐮 CowAgent Status
Status: ● Running (PID: 12345)
Version: 2.0.4
Channel: web
Model: MiniMax-M2.5
Mode: agent
```
## logs
查看服务日志。
View service logs.
```bash
cow logs
```
**选项:**
**Options:**
| 选项 | 说明 | 默认值 |
| Option | Description | Default |
| --- | --- | --- |
| `-f`, `--follow` | 持续跟踪日志输出 | |
| `-n`, `--lines` | 显示最近 N 行 | 50 |
| `-f`, `--follow` | Continuously tail log output | No |
| `-n`, `--lines` | Show last N lines | 50 |
示例:
Examples:
```bash
# 查看最近 100 行日志
# View last 100 lines
cow logs -n 100
# 持续跟踪日志
# Continuously tail logs
cow logs -f
```
## install-browser
安装 Playwright Chromium 浏览器,用于启用 [浏览器工具](/tools/browser)
Install Playwright and Chromium browser for the [browser tool](/tools/browser).
```bash
cow install-browser
```
<Tip>
仅在需要使用浏览器工具(如网页浏览、截图等)时才需要安装。
Only needed when using browser tools (web browsing, screenshots, etc.).
</Tip>
## run.sh 兼容
## run.sh Compatibility
如果未安装 Cow CLI,也可以使用 `run.sh` 脚本管理服务:
If Cow CLI is not installed, you can use `run.sh` to manage the service:
| cow 命令 | run.sh 等效命令 |
| cow command | run.sh equivalent |
| --- | --- |
| `cow start` | `./run.sh start` |
| `cow stop` | `./run.sh stop` |
@@ -130,5 +119,5 @@ cow install-browser
| `cow logs` | `./run.sh logs` |
<Note>
推荐使用 `cow` 命令,它提供更简洁的语法和更丰富的功能。通过一键安装脚本部署时 `cow` 命令会自动安装。
The `cow` command is recommended — it provides cleaner syntax and richer features. It is automatically installed via the one-click install script.
</Note>

View File

@@ -1,190 +1,182 @@
---
title: 技能管理
description: 通过命令安装、卸载、启用、禁用和管理技能
title: Skill Management
description: Install, uninstall, enable, disable, and manage skills via commands
---
技能管理命令用于安装、查询和管理 CowAgent 的技能。在对话中使用 `/skill <子命令>`,在终端中使用 `cow skill <子命令>`。
Skill management commands are used to install, query, and manage CowAgent skills. Use `/skill <subcommand>` in chat or `cow skill <subcommand>` in the terminal.
## list
列出已安装的技能及其状态。
List installed skills and their status.
<CodeGroup>
```text 对话
```text Chat
/skill list
```
```bash 终端
```bash Terminal
cow skill list
```
</CodeGroup>
输出示例:
Example output:
```
📦 已安装的技能 (3/4)
📦 Installed skills (3/4)
✅ pptx
Use this skill any time a .pptx file is involved…
来源: cowhub
Source: cowhub
✅ skill-creator
Create, install, or update skills…
来源: builtin
Source: builtin
⏸️ image-vision (已禁用)
图片理解和视觉分析
来源: builtin
⏸️ image-vision (disabled)
Image understanding and visual analysis
Source: builtin
```
**浏览技能广场**(查看 Hub 上所有可安装的技能):
**Browse the Skill Hub** (view all available skills):
<CodeGroup>
```text 对话
```text Chat
/skill list --remote
```
```bash 终端
```bash Terminal
cow skill list --remote
```
</CodeGroup>
**选项:**
**Options:**
| 选项 | 说明 | 默认值 |
| Option | Description | Default |
| --- | --- | --- |
| `--remote`, `-r` | 浏览 Skill Hub 远程技能列表 | |
| `--page` | 远程列表分页页码 | 1 |
| `--remote`, `-r` | Browse Skill Hub remote skill list | No |
| `--page` | Page number for remote listing | 1 |
## search
在技能广场中搜索技能。
Search for skills on the Skill Hub.
<CodeGroup>
```text 对话
```text Chat
/skill search pptx
```
```bash 终端
```bash Terminal
cow skill search pptx
```
</CodeGroup>
## install
安装技能。通过统一的 `install` 命令,可一键安装来自 **Cow 技能广场、GitHubClawHub** 以及任意 URLzip 压缩包、SKILL.md 链接)上的技能,无需手动下载和配置。
Install skills with a single `install` command from Cow Skill Hub, GitHub, ClawHub, or any URL (zip archives, SKILL.md links) — no manual download or configuration required.
**从 Cow 技能广场安装(推荐):**
**From Skill Hub (recommended):**
<CodeGroup>
```text 对话
```text Chat
/skill install pptx
```
```bash 终端
```bash Terminal
cow skill install pptx
```
</CodeGroup>
** GitHub 安装:**
**From GitHub:**
<CodeGroup>
```text 对话
# 安装仓库中的所有技能(自动扫描包含 SKILL.md 的子目录)
```text Chat
# Install all skills in a repo (auto-discovers subdirectories with SKILL.md)
/skill install larksuite/cli
# 指定子目录,只安装单个技能
# Specify a subdirectory to install a single skill
/skill install https://github.com/larksuite/cli/tree/main/skills/lark-im
# 使用 # 指定子目录
# Use # to specify a subdirectory
/skill install larksuite/cli#skills/lark-minutes
```
```bash 终端
# 安装仓库中的所有技能(自动扫描包含 SKILL.md 的子目录)
```bash Terminal
# Install all skills in a repo (auto-discovers subdirectories with SKILL.md)
cow skill install larksuite/cli
# 指定子目录,只安装单个技能
# Specify a subdirectory to install a single skill
cow skill install https://github.com/larksuite/cli/tree/main/skills/lark-im
# 使用 # 指定子目录
# Use # to specify a subdirectory
cow skill install larksuite/cli#skills/lark-minutes
```
</CodeGroup>
支持完整的 GitHub URL `owner/repo` 简写。对于 mono-repo一个仓库中包含多个技能不指定子目录时会自动发现并批量安装所有技能指定子目录时只安装该目录下的技能。
Supports full GitHub URLs and `owner/repo` shorthand. For mono-repos (multiple skills in one repository), omitting the subdirectory auto-discovers and batch-installs all skills; specifying a subdirectory installs only that skill.
** ClawHub 安装:**
**From ClawHub:**
<CodeGroup>
```text 对话
```text Chat
/skill install clawhub:baidu-search
```
```bash 终端
```bash Terminal
cow skill install clawhub:baidu-search
```
</CodeGroup>
**从 URL 安装:**
**From URL:**
<CodeGroup>
```text 对话
# 从 zip 压缩包安装(支持单个或批量)
```text Chat
# Install from a zip archive (single or batch)
/skill install https://cdn.link-ai.tech/skills/pptx.zip
# SKILL.md 链接安装
# Install from a SKILL.md link
/skill install https://example.com/path/to/SKILL.md
```
```bash 终端
# 从 zip 压缩包安装(支持单个或批量)
```bash Terminal
# Install from a zip archive (single or batch)
cow skill install https://cdn.link-ai.tech/skills/pptx.zip
# SKILL.md 链接安装
# Install from a SKILL.md link
cow skill install https://example.com/path/to/SKILL.md
```
</CodeGroup>
支持从 zip / tar.gz 压缩包 URL 安装,解压后自动扫描包含 `SKILL.md` 的目录,支持单个或批量安装。也支持直接从 `SKILL.md` 文件链接安装,会自动解析技能名称和描述。
安装成功后会显示技能名称、描述和来源,例如:
```
✅ baidu-search
百度搜索:使用百度搜索引擎检索信息…
来源: clawhub
```
Supports installing from zip / tar.gz archive URLs — automatically extracts and discovers directories containing `SKILL.md`, with support for single or batch install. Also supports installing directly from a `SKILL.md` file URL, automatically parsing the skill name and description.
## uninstall
卸载已安装的技能。
Uninstall an installed skill.
<CodeGroup>
```text 对话
```text Chat
/skill uninstall pptx
```
```bash 终端
```bash Terminal
cow skill uninstall pptx
```
</CodeGroup>
<Warning>
卸载操作会删除技能目录下的所有文件,此操作不可恢复。
Uninstalling deletes all files in the skill directory. This action cannot be undone.
</Warning>
## enable / disable
启用或禁用技能,禁用后技能不会被 Agent 调用。
Enable or disable a skill. Disabled skills will not be invoked by the Agent.
<CodeGroup>
```text 对话
```text Chat
/skill enable pptx
/skill disable pptx
```
```bash 终端
```bash Terminal
cow skill enable pptx
cow skill disable pptx
```
@@ -192,27 +184,27 @@ cow skill disable pptx
## info
查看已安装技能的详细信息,包括 `SKILL.md` 内容预览。
View details of an installed skill, including a preview of its `SKILL.md`.
<CodeGroup>
```text 对话
```text Chat
/skill info pptx
```
```bash 终端
```bash Terminal
cow skill info pptx
```
</CodeGroup>
## 技能来源
## Skill Sources
安装的技能会记录来源信息,可通过 `/skill list` 查看:
Installed skills track their origin, viewable via `/skill list`:
| 来源标识 | 说明 |
| Source | Description |
| --- | --- |
| `builtin` | 项目内置技能 |
| `cowhub` | CowAgent Skill Hub 安装 |
| `github` | GitHub URL 直接安装 |
| `clawhub` | ClawHub 安装 |
| `url` | SKILL.md URL 安装 |
| `local` | 本地创建的技能 |
| `builtin` | Built-in project skills |
| `cowhub` | Installed from CowAgent Skill Hub |
| `github` | Installed directly from a GitHub URL |
| `clawhub` | Installed from ClawHub |
| `url` | Installed from a SKILL.md URL |
| `local` | Locally created skills |