feat: refresh docs for agent capabilities and wording

Author: dingyi222666

docs/ecosystem/plugin/extension-agent.md

@@ -6,7 +6,7 @@
 
 ## 配置
 
-* 前往插件市场搜索 `chatluna-agent` 并安装。
+- 前往插件市场搜索 `chatluna-agent` 并安装。
 
 ![安装 chatluna-agent](/images/agent-install.png)
 
@@ -18,8 +18,8 @@
 
 以下是推荐的一些插件源：
 
-* [https://koishi-registry.yumetsuki.moe/index.json](https://koishi-registry.yumetsuki.moe/index.json)
-* [https://kp.itzdrli.cc](https://kp.itzdrli.cc)
+- [https://koishi-registry.yumetsuki.moe/index.json](https://koishi-registry.yumetsuki.moe/index.json)
+- [https://kp.itzdrli.cc](https://kp.itzdrli.cc)
 
 :::
 
@@ -43,16 +43,16 @@
 
 ![总览页](/images/agent-overview.png)
 
-总览页中每个区块对应一个子系统：
+总览页中每个位置对应一个子系统：
 
-* **MCP**：已连接的服务器数量和可用工具数。
-* **Computer**：当前可用的后端和活跃会话数。
-* **Skills**：扫描到的技能总数和可见技能数。
-* **Sub-Agent**：已启用的子代理数量。
-* **Tools**：可用工具总数。
-* **Trigger**：启用的任务数。
+- **MCP**：已连接的服务器数量和可用工具数。
+- **Computer**：当前可用的后端和活跃会话数。
+- **Skills**：扫描到的技能总数和可见技能数。
+- **Sub-Agent**：已启用的子代理数量。
+- **Tools**：可用工具总数。
+- **Trigger**：启用的任务数。
 
-如果某个区块显示错误或数值为零，点击进入对应页面进行排查。
+如果某个位置显示错误，你可以点击进入对应页面进行排查。
 
 ### MCP
 
@@ -86,9 +86,9 @@ MCP 页面用于管理 MCP 协议服务器。你可以在此添加、编辑、
 
 每个工具支持以下控制项：
 
-* **启用/禁用**：关闭后该工具不会注册给模型。
-* **超时**：覆盖服务器级别的超时时间，单位秒。
-* **选择器**：填写关键词，只有对话中包含这些关键词时工具才会出现在候选列表中。留空表示始终可用。
+- **启用/禁用**：关闭后该工具不会注册给模型。
+- **超时**：覆盖服务器级别的超时时间，单位秒。
+- **选择器**：填写关键词，只有对话中包含这些关键词时工具才会出现在候选列表中。留空表示始终可用。
 
 #### 重连和删除
 
@@ -104,12 +104,12 @@ Tools 页面展示所有注册到 ChatLuna 的工具，包括 Computer 工具、
 
 每个工具提供以下控制项：
 
-* **启用**：工具总开关。
-* **主会话**：是否允许主 ChatLuna 会话使用。
-* **ChatLuna**：是否允许普通 ChatLuna 来源使用。
-* **角色**：是否允许角色扮演来源使用，可以分别控制群聊和私聊。
-* **权限等级**：调用该工具所需的最低 Koishi 用户权限。默认情况下，`bash`、`file_read`、`file_write`、`file_edit`、`trigger` 等工具需要 3 级权限。
-* **子代理**：控制哪些子代理可以使用该工具。
+- **启用**：工具总开关。
+- **主会话**：是否允许主 ChatLuna 会话使用。
+- **ChatLuna**：是否允许普通 ChatLuna 来源使用。
+- **角色**：是否允许角色扮演来源使用，可以分别控制群聊和私聊。
+- **权限等级**：调用该工具所需的最低 Koishi 用户权限。默认情况下，`bash`、`file_read`、`file_write`、`file_edit`、`trigger` 等工具需要 3 级权限。
+- **子代理**：控制哪些子代理可以使用该工具。
 
 ![Tools 页面 - 编辑工具](/images/agent-tools-edit.png)
 
@@ -124,9 +124,9 @@ Computer 页面用于启用和管理文件操作、搜索、Shell 执行和终
 
 插件支持三种 Computer 后端：
 
-* **Local**：直接在 Koishi 所在机器上运行，适合个人开发机调试。
-* **E2B**：使用 E2B 云沙箱，适合需要隔离执行的场景。
-* **Open Terminal**：连接外部终端服务。
+- **Local**：直接在 Koishi 所在机器上运行，适合个人开发机调试。
+- **E2B**：使用 E2B 云沙箱，适合需要隔离执行的场景。
+- **Open Terminal**：连接外部终端服务。
 
 #### 启用 Local 后端
 
@@ -164,13 +164,13 @@ Local 后端直接操作宿主机。不要在面向普通用户的群聊中随
 
 启用任一后端后，以下工具会自动注册：
 
-* `file_read`：读取文件内容或列出目录。
-* `file_write`：创建或覆盖文件。
-* `file_edit`：对已有文件做精确字符串替换。
-* `grep`：正则搜索文件内容。
-* `glob`：按 glob 模式匹配文件。
-* `bash`：执行 Shell 命令，也可管理后台任务。
-* `file_publish`：把生成的文件发布给用户（需要 `chatluna-storage-service`）。
+- `file_read`：读取文件内容或列出目录。
+- `file_write`：创建或覆盖文件。
+- `file_edit`：对已有文件做精确字符串替换。
+- `grep`：正则搜索文件内容。
+- `glob`：按 glob 模式匹配文件。
+- `bash`：执行 Shell 命令，也可管理后台任务。
+- `file_publish`：把生成的文件发布给用户（需要 `chatluna-storage-service`）。
 
 #### 终端和后台任务
 
@@ -188,9 +188,9 @@ Skills 页面用于管理 `SKILL.md` 技能文件。技能是一种可复用的
 
 点击导入按钮，可以从三种来源导入技能：
 
-* **GitHub**：填写仓库或目录 URL。
-* **ZIP**：上传压缩包。
-* **文件夹**：选择本地目录内容。
+- **GitHub**：填写仓库或目录 URL。
+- **ZIP**：上传压缩包。
+- **文件夹**：选择本地目录内容。
 
 ![Skills 页面 - 导入](/images/agent-skills-import.png)
 
@@ -200,11 +200,11 @@ Skills 页面用于管理 `SKILL.md` 技能文件。技能是一种可复用的
 
 技能列表中每个技能支持以下操作：
 
-* **启用/禁用**：控制技能是否可用。
-* **模式切换**：在 `off`、`description`（默认，只注入名称和描述）、`full`（每轮注入完整内容）之间切换。
-* **编辑内容**：编辑本地导入的 `SKILL.md`。
-* **导出**：导出为压缩包。
-* **删除**：删除导入到 `data/chatluna/skills` 的本地技能。
+- **启用/禁用**：控制技能是否可用。
+- **模式切换**：在 `off`、`description`（默认，只注入名称和描述）、`full`（每轮注入完整内容）之间切换。
+- **编辑内容**：编辑本地导入的 `SKILL.md`。
+- **导出**：导出为压缩包。
+- **删除**：删除导入到 `data/chatluna/skills` 的本地技能。
 
 ![Skills 页面 - 编辑技能](/images/agent-skills-edit.png)
 
@@ -229,9 +229,9 @@ Sub-Agent 页面用于管理子代理。子代理允许主模型把特定任务
 
 插件内置三个子代理，默认关闭。在 Sub-Agent 页面中找到并启用即可。
 
-* **plan**：只读分析代理，用于制定实现方案。只能使用 `file_read`、`grep`、`glob`。
-* **explore**：快速搜索代理，用于收集代码上下文。只能使用 `file_read`、`grep`、`glob`。
-* **general**：通用实现代理，可以读写文件和执行命令。
+- **plan**：只读分析代理，用于制定实现方案。只能使用 `file_read`、`grep`、`glob`。
+- **explore**：快速搜索代理，用于收集代码上下文。只能使用 `file_read`、`grep`、`glob`。
+- **general**：通用实现代理，可以读写文件和执行命令。
 
 ![Sub-Agent 页面 - 启用内置子代理](/images/agent-subagent-builtin.png)
 
@@ -251,9 +251,9 @@ Sub-Agent 页面用于管理子代理。子代理允许主模型把特定任务
 
 点击导入按钮，可以上传或粘贴带 YAML frontmatter 的 Markdown 文件。插件兼容三种格式：
 
-* **ChatLuna 格式**：推荐格式。
-* **Claude 格式**：来自 `~/.claude/agents` 的 Markdown 文件。
-* **OpenCode 格式**：来自 `~/.config/opencode/agents` 的 Markdown 文件。
+- **ChatLuna 格式**：推荐格式。
+- **Claude 格式**：来自 `~/.claude/agents` 的 Markdown 文件。
+- **OpenCode 格式**：来自 `~/.config/opencode/agents` 的 Markdown 文件。
 
 ![Sub-Agent 页面 - 导入子代理](/images/agent-subagent-import.png)
 
@@ -291,21 +291,21 @@ Trigger 页面用于创建定时或被动触发任务。任务触发后会主动
 
 #### 内置触发器类型
 
-* **cron**：使用标准 cron 表达式周期触发。例如 `0 9 * * 1-5` 表示工作日上午 9 点。
-* **once**：在指定时间触发一次，触发后自动禁用。
-* **keyword**：当消息文本包含配置的关键词时被动触发。
-* **activity**：根据群聊活跃度（消息频率、参与人数等因素）达到阈值时触发。
+- **cron**：使用标准 cron 表达式周期触发。例如 `0 9 * * 1-5` 表示工作日上午 9 点。
+- **once**：在指定时间触发一次，触发后自动禁用。
+- **keyword**：当消息文本包含配置的关键词时被动触发。
+- **activity**：根据群聊活跃度（消息频率、参与人数等因素）达到阈值时触发。
 
 ![Trigger 页面 - Cron 配置](/images/agent-trigger-cron.png)
 
 #### 管理任务
 
 Trigger 列表中可以对每个任务进行以下操作：
 
-* **启用/禁用**：暂停或恢复任务。
-* **编辑**：修改消息、参数、目标和回复方式。
-* **立即触发**：不等待触发条件，马上执行一次。
-* **删除**：移除任务。
+- **启用/禁用**：暂停或恢复任务。
+- **编辑**：修改消息、参数、目标和回复方式。
+- **立即触发**：不等待触发条件，马上执行一次。
+- **删除**：移除任务。
 
 如果任务执行失败，可以在任务详情中查看 `lastError` 字段排查原因。
 

docs/guide/introduction.md

@@ -1,6 +1,6 @@
 # 介绍
 
-[ChatLuna](https://github.com/ChatLunaLab/chatluna) 是基于 [LangChain](https://github.com/langchain-ai/langchainjs) 构建的 Koishi 大语言模型聊天插件。它可以统一接入 OpenAI、Google Gemini、Claude 以及生态中的其他模型适配器。
+[ChatLuna](https://github.com/ChatLunaLab/chatluna) 是基于 [LangChain](https://github.com/langchain-ai/langchainjs) 构建的 Koishi 大语言模型聊天插件。它可以统一接入 OpenAI、Google Gemini、Claude 以及生态中的其他模型适配器，并提供 Agent 能力支持。
 
 除了面向最终用户的聊天能力，ChatLuna 也向 Koishi 插件开发者暴露了可复用的模型服务接口。长期记忆、知识库、渲染器、Agent 工具等特性都是基于这套 API 扩展的。
 
@@ -11,7 +11,7 @@
 - 资源管理：支持全局冷却、并发限制和调用次数控制。
 - 多模态：支持图片多模态，并可渲染模型回复，支持文本、图片、语音等多种格式。
 - 上下文管理：支持默认的短期聊天记录保存。并可额外安装长期记忆或知识库插件，实现更复杂的知识管理。
-- 多种聊天模式：提供 chat、browsing 和 agent 三种模式。browsing 可以联网感知消息，agent 模式则可让模型调用各种工具。
+- Agent 模式：安装附加插件后，模型将拥有沙箱，skills 等能力，进行更复杂的操作。
 - 内容安全：支持 koishi 的 censor 服务，过滤不良内容
 
 ## 接下来阅读

docs/index.md

@@ -25,7 +25,7 @@ features:
     details: 集成 Deepseek、OpenAI、Google Gemini、Anthropic Claude 等主流平台，并持续扩展更多平台。
   - icon: 🔗
     title: Agentic 能力
-    details: 使用 Agent 模式，可以让模型任意调用已有工具。支持 MCP，联网搜索，知识库等复杂工具。
+    details: Agent 模式下，可以让模型任意调用已有工具。支持 沙盒，MCP，联网搜索等复杂工具。
   - icon: 🎨
     title: 多模态与渲染输出
     details: 支持图片多模态，并可渲染模型回复，支持文本、图片、语音等多种格式。