@tencent-ai/codebuddy-code 2.71.1 → 2.72.0-next.6c5fd20.20260402

package/dist/web-ui/docs/cn/cli/http-api.md

@@ -0,0 +1,401 @@
+# CodeBuddy Code HTTP API <sup>Beta</sup>
+
+> **Beta**: 此 API 处于 Beta 阶段，接口可能会有调整。欢迎反馈意见。
+
+CodeBuddy Code 提供两套公开接口，面向开发者构建 Agent 应用：
+
+- **REST API** (`/api/v1/*`) — 无状态 HTTP 请求/响应，适合 Webhook 接入、管理操作、简单查询
+- **ACP** (`/api/v1/acp`) — 有状态流式协议（JSON-RPC over SSE），适合构建完整 Agent 客户端应用
+
+## 快速开始
+
+### 启动 HTTP 服务
+
+```bash
+codebuddy --serve --port 8080 --session-id my-session
+```
+
+### API 文档（Swagger UI）
+
+服务启动后访问：
+
+- **交互式文档**: `http://127.0.0.1:8080/api/docs`
+- **OpenAPI 规范**: `http://127.0.0.1:8080/api/openapi.json`
+
+Swagger UI 提供所有公开端点的交互式测试界面。
+
+### 验证服务正常
+
+```bash
+curl http://127.0.0.1:8080/api/v1/health
+# {"data":{"status":"ok","uptime":12.3,"platforms":["generic","wecom","wechat-kf"]}}
+```
+
+## API 分层
+
+| 层级 | 路由前缀 | 兼容性承诺 | 说明 |
+|------|---------|-----------|------|
+| **公开 REST API** | `/api/v1/*` | 语义化版本，不做破坏性变更 | 本文档覆盖的内容 |
+| **公开 ACP 协议** | `/api/v1/acp` | 遵循 ACP 规范 | 完整对话能力，参见 [ACP 文档](https://agentclientprotocol.com) |
+| **内部 RPC** | `/internal/*` | 不保证兼容性 | CLI 内部使用，不对外开放 |
+
+## 认证
+
+支持两种模式（环境变量 `CODEBUDDY_GATEWAY_AUTH` 控制）：
+
+| 模式 | 值 | 说明 |
+|------|---|------|
+| 无认证 | `none`（默认） | 本地开发用，不需要认证 |
+| 密码认证 | `password` | 远程访问时自动开启 |
+
+密码认证支持以下方式（任一通过即可）：
+
+```bash
+# Bearer Token
+curl -H "Authorization: Bearer YOUR_PASSWORD" http://host:port/api/v1/sessions
+
+# URL 参数
+curl http://host:port/api/v1/sessions?password=YOUR_PASSWORD
+```
+
+## 响应格式
+
+所有 `/api/v1/*` 端点使用统一的信封格式：
+
+```jsonc
+// 成功
+{
+    "data": { ... }
+}
+
+// 错误
+{
+    "error": {
+        "code": "AUTH_REQUIRED",      // 机器可读错误码
+        "message": "Authentication required"  // 人类可读描述
+    }
+}
+```
+
+## 端点概览
+
+### 系统
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| GET | `/api/v1/health` | 健康检查 |
+| GET | `/api/v1/info` | 环境信息（版本、OS、CWD 等） |
+| GET | `/api/v1/metrics` | 系统资源指标（对齐 E2B envd） |
+| GET | `/api/v1/envs` | 环境变量（对齐 E2B envd） |
+
+### 认证
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| GET | `/api/v1/auth/status` | 获取认证状态 |
+| POST | `/api/v1/auth/login` | 密码登录，返回 token |
+
+### Runs（Agent 执行）
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| POST | `/api/v1/runs` | 发起 Agent 执行（异步，返回 runId） |
+| GET | `/api/v1/runs/:runId` | 查询执行状态 |
+| GET | `/api/v1/runs/:runId/stream` | SSE 流式获取执行结果 |
+| POST | `/api/v1/runs/:runId/cancel` | 取消执行 |
+
+### Webhooks（第三方平台接入）
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| GET | `/api/v1/webhooks/:platform` | 平台 URL 验证（企微等） |
+| POST | `/api/v1/webhooks/:platform` | 平台消息 Webhook 入口 |
+
+支持的平台：`generic`、`wecom`（企业微信）、`wechat-kf`（微信客服）
+
+### 会话
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| GET | `/api/v1/sessions` | 获取会话列表 |
+| DELETE | `/api/v1/sessions/:id` | 删除会话 |
+| POST | `/api/v1/sessions/:id/rename` | 重命名会话 |
+
+### PTY（终端）
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| POST | `/api/v1/pty` | 创建 PTY 会话 |
+| GET | `/api/v1/pty` | 列出 PTY 会话 |
+| GET | `/api/v1/pty/:id` | 查询 PTY 会话 |
+| DELETE | `/api/v1/pty/:id` | 销毁 PTY 会话 |
+| GET | `/api/v1/pty/:id/output` | SSE 流式获取 PTY 输出（替代 WebSocket） |
+| POST | `/api/v1/pty/:id/input/send` | 发送 PTY 输入（对齐 E2B Process.SendInput） |
+| POST | `/api/v1/pty/:id/resize` | 调整 PTY 大小（对齐 E2B Process.Update） |
+| WebSocket | `/api/v1/pty/:id/ws` | PTY 双向数据传输（兼容保留） |
+
+### 实例
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| GET | `/api/v1/instances` | 获取实例列表 |
+| POST | `/api/v1/instances` | 添加远程实例 |
+| DELETE | `/api/v1/instances/:id` | 删除实例 |
+
+### Channels（远程控制）
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| GET | `/api/v1/channels` | 获取客户端列表 |
+| POST | `/api/v1/channels/:type/:id/start` | 启动客户端 |
+| POST | `/api/v1/channels/:type/:id/stop` | 停止客户端 |
+| POST | `/api/v1/channels/wechat` | 创建微信实例 |
+| POST | `/api/v1/channels/wecom` | 创建企微实例 |
+
+### 文件系统（E2B 兼容）
+
+文件内容操作（对齐 E2B envd HTTP 端点）：
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| GET | `/api/v1/files/download?path=...` | 下载文件（对齐 E2B envd GET /files） |
+| POST | `/api/v1/files/upload?path=...` | 上传文件（对齐 E2B envd POST /files） |
+| POST | `/api/v1/files/compose` | 合并多文件（对齐 E2B envd POST /files/compose） |
+
+文件操作（对齐 E2B filesystem.proto）：
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| POST | `/api/v1/fs/stat` | 获取文件/目录信息（对齐 Filesystem.Stat） |
+| POST | `/api/v1/fs/list` | 列出目录内容（对齐 Filesystem.ListDir） |
+| POST | `/api/v1/fs/mkdir` | 创建目录（对齐 Filesystem.MakeDir） |
+| POST | `/api/v1/fs/remove` | 删除文件/目录（对齐 Filesystem.Remove） |
+| POST | `/api/v1/fs/move` | 移动/重命名（对齐 Filesystem.Move） |
+
+文件监听（对齐 E2B filesystem.proto）：
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| POST | `/api/v1/fs/watch` | 流式目录监听 SSE（对齐 Filesystem.WatchDir） |
+| POST | `/api/v1/fs/watcher/create` | 创建监听器（对齐 Filesystem.CreateWatcher） |
+| POST | `/api/v1/fs/watcher/events` | 获取监听事件（对齐 Filesystem.GetWatcherEvents） |
+| POST | `/api/v1/fs/watcher/remove` | 删除监听器（对齐 Filesystem.RemoveWatcher） |
+
+CBC 增强：
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| GET | `/api/v1/fs/search?query=...` | 文件模糊搜索（基于 ripgrep，E2B 无对应接口） |
+
+### 进程管理（E2B 兼容）
+
+对齐 E2B process.proto，将 gRPC 方法映射为 REST 端点：
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| POST | `/api/v1/process/start` | 启动进程（对齐 Process.Start，支持 SSE/JSON） |
+| GET | `/api/v1/process/list` | 列出运行中进程（对齐 Process.List） |
+| POST | `/api/v1/process/connect` | 连接到进程 SSE 流（对齐 Process.Connect） |
+| POST | `/api/v1/process/input/send` | 发送 stdin（对齐 Process.SendInput） |
+| POST | `/api/v1/process/input/stream` | 流式发送 stdin（对齐 Process.StreamInput） |
+| POST | `/api/v1/process/signal/send` | 发送信号（对齐 Process.SendSignal） |
+| POST | `/api/v1/process/stdin/close` | 关闭 stdin（对齐 Process.CloseStdin） |
+| POST | `/api/v1/process/update` | 更新进程配置如 PTY resize（对齐 Process.Update） |
+
+### ACP（Agent Client Protocol）
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| POST | `/api/v1/acp/connect` | 建立 ACP 连接，返回 connectionId 和 sessionToken |
+| GET | `/api/v1/acp` | SSE 通知订阅（需要 acp-connection-id Header） |
+| POST | `/api/v1/acp` | 发送 JSON-RPC 请求（newSession、prompt、cancelRun 等） |
+| DELETE | `/api/v1/acp` | 断开连接 |
+
+### 文件变更（Checkpoint）
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| GET | `/api/v1/file-changes/diff?path=...` | 获取单个文件的 diff 内容 |
+| GET | `/api/v1/file-changes/checkpoints` | 列出可回退的 checkpoint |
+| POST | `/api/v1/file-changes/revert` | 撤回文件变更或回退到 checkpoint |
+
+### 任务模板
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| GET | `/api/v1/tasks/templates` | 获取任务模板 |
+| POST | `/api/v1/tasks/templates/refresh` | 刷新（触发 AI 推荐） |
+
+## 使用示例
+
+### 健康检查
+
+```bash
+curl http://127.0.0.1:8080/api/v1/health
+```
+
+### 发起 Agent 执行
+
+```bash
+# 发送消息
+curl -X POST http://127.0.0.1:8080/api/v1/runs \
+  -H "Content-Type: application/json" \
+  -d '{"text": "帮我分析代码性能", "sender": {"id": "dev", "name": "Developer"}}'
+
+# 响应: {"data": {"runId": "uuid-xxx", "status": "accepted"}}
+
+# 通过 SSE 流获取结果
+curl http://127.0.0.1:8080/api/v1/runs/uuid-xxx/stream
+```
+
+### PTY 终端管理
+
+```bash
+# 创建终端
+curl -X POST http://127.0.0.1:8080/api/v1/pty \
+  -H "Content-Type: application/json" \
+  -d '{"cols": 120, "rows": 40}'
+
+# 列出终端
+curl http://127.0.0.1:8080/api/v1/pty
+
+# SSE 流式获取输出（替代 WebSocket）
+curl http://127.0.0.1:8080/api/v1/pty/SESSION_ID/output
+
+# 发送输入
+curl -X POST http://127.0.0.1:8080/api/v1/pty/SESSION_ID/input/send \
+  -H "Content-Type: application/json" \
+  -d '{"data": "ls -la\n"}'
+
+# 调整大小
+curl -X POST http://127.0.0.1:8080/api/v1/pty/SESSION_ID/resize \
+  -H "Content-Type: application/json" \
+  -d '{"cols": 200, "rows": 50}'
+
+# 销毁终端
+curl -X DELETE http://127.0.0.1:8080/api/v1/pty/SESSION_ID
+```
+
+### 文件系统操作（E2B 兼容）
+
+```bash
+# 下载文件
+curl "http://127.0.0.1:8080/api/v1/files/download?path=/tmp/test.txt"
+
+# 上传文件
+curl -X POST "http://127.0.0.1:8080/api/v1/files/upload?path=/tmp/upload.txt" \
+  -H "Content-Type: application/octet-stream" \
+  --data-binary @local-file.txt
+
+# 获取文件信息
+curl -X POST http://127.0.0.1:8080/api/v1/fs/stat \
+  -H "Content-Type: application/json" \
+  -d '{"path": "/tmp"}'
+
+# 列出目录
+curl -X POST http://127.0.0.1:8080/api/v1/fs/list \
+  -H "Content-Type: application/json" \
+  -d '{"path": "/tmp", "depth": 2}'
+
+# 创建目录
+curl -X POST http://127.0.0.1:8080/api/v1/fs/mkdir \
+  -H "Content-Type: application/json" \
+  -d '{"path": "/tmp/new-dir"}'
+
+# 文件模糊搜索（CBC 增强）
+curl "http://127.0.0.1:8080/api/v1/fs/search?query=component&limit=10"
+```
+
+### 进程管理（E2B 兼容）
+
+```bash
+# 启动进程（JSON 模式）
+curl -X POST http://127.0.0.1:8080/api/v1/process/start \
+  -H "Content-Type: application/json" \
+  -d '{"process": {"cmd": "python3", "args": ["script.py"]}, "tag": "my-script"}'
+
+# 启动进程（SSE 流式输出）
+curl -X POST http://127.0.0.1:8080/api/v1/process/start \
+  -H "Content-Type: application/json" \
+  -H "Accept: text/event-stream" \
+  -d '{"process": {"cmd": "python3", "args": ["script.py"]}}'
+
+# 列出运行中进程
+curl http://127.0.0.1:8080/api/v1/process/list
+
+# 发送 stdin
+curl -X POST http://127.0.0.1:8080/api/v1/process/input/send \
+  -H "Content-Type: application/json" \
+  -d '{"process": {"pid": 12345}, "input": {"stdin": "hello\n"}}'
+
+# 发送信号（SIGTERM）
+curl -X POST http://127.0.0.1:8080/api/v1/process/signal/send \
+  -H "Content-Type: application/json" \
+  -d '{"process": {"tag": "my-script"}, "signal": 15}'
+
+# 系统指标
+curl http://127.0.0.1:8080/api/v1/metrics
+```
+
+### 会话管理
+
+```bash
+# 获取会话列表
+curl http://127.0.0.1:8080/api/v1/sessions
+
+# 重命名会话
+curl -X POST http://127.0.0.1:8080/api/v1/sessions/SESSION_ID/rename \
+  -H "Content-Type: application/json" \
+  -d '{"name": "性能优化讨论"}'
+```
+
+### 文件变更管理
+
+```bash
+# 获取文件 diff（需要文件在 checkpoint 中被跟踪）
+curl "http://127.0.0.1:8080/api/v1/file-changes/diff?path=/path/to/file.ts"
+# 响应: {"path": "/path/to/file.ts", "oldText": "...", "newText": "..."}
+
+# 列出可回退的 checkpoint
+curl http://127.0.0.1:8080/api/v1/file-changes/checkpoints
+# 响应: {"checkpoints": [{"id": "xxx", "label": "...", "createdAt": 1234567890, "files": [...], "additions": 5, "deletions": 2}]}
+
+# 按文件撤回变更
+curl -X POST http://127.0.0.1:8080/api/v1/file-changes/revert \
+  -H "Content-Type: application/json" \
+  -d '{"paths": ["/path/to/file.ts"]}'
+# 响应: {"success": true, "revertedFiles": ["/path/to/file.ts"]}
+
+# 回退到指定 checkpoint
+curl -X POST http://127.0.0.1:8080/api/v1/file-changes/revert \
+  -H "Content-Type: application/json" \
+  -d '{"checkpointId": "checkpoint-uuid", "scope": "CodeAndConversation"}'
+# scope 可选值: "Code"（仅回退文件）, "Conversation"（仅回退对话）, "CodeAndConversation"（全部回退）
+
+# 撤回全部变更（回退到最早的 checkpoint）
+curl -X POST http://127.0.0.1:8080/api/v1/file-changes/revert \
+  -H "Content-Type: application/json" \
+  -d '{}'
+```
+
+## 错误码
+
+| 错误码 | HTTP 状态 | 说明 |
+|--------|----------|------|
+| `AUTH_REQUIRED` | 401 | 需要认证 |
+| `AUTH_INVALID` | 401 | 认证无效 |
+| `AUTH_RATE_LIMITED` | 429 | 登录尝试过多 |
+| `NOT_FOUND` | 404 | 资源不存在 |
+| `BAD_REQUEST` | 400 | 请求参数错误 |
+| `RATE_LIMITED` | 429 | 请求频率过高 |
+| `INTERNAL_ERROR` | 500 | 服务器内部错误 |
+| `SESSION_NOT_FOUND` | 404 | 会话不存在 |
+| `SESSION_DELETE_CURRENT` | 400 | 不能删除当前会话 |
+| `TERMINAL_NOT_FOUND` | 404 | PTY 不存在 |
+| `PROCESS_NOT_FOUND` | 404 | 进程不存在 |
+| `PATH_REQUIRED` | 400 | 缺少 path 参数 |
+| `PATH_NOT_DIRECTORY` | 400 | 路径不是目录 |
+| `INSUFFICIENT_STORAGE` | 507 | 磁盘空间不足 |
+| `RUN_NOT_FOUND` | 404 | 执行不存在 |
+| `PLATFORM_UNSUPPORTED` | 400 | 不支持的 Webhook 平台 |
+| `SIGNATURE_INVALID` | 403 | 签名验证失败 |

package/dist/web-ui/docs/cn/cli/release-notes/README.md

@@ -17,6 +17,11 @@ Release Notes 记录了每个版本的用户可见变更，包括：
 
 <!-- 新版本自动添加到此处 -->
 
+- [v2.71.1](./v2.71.1.md) - 2026-04-01
+- [v2.71.0](./v2.71.0.md) - 2026-04-01
+- [v2.70.1](./v2.70.1.md) - 2026-03-31
+- [v2.70.0](./v2.70.0.md) - 2026-03-31
+- [v2.69.0](./v2.69.0.md) - 2026-03-30
 - [v2.68.0](./v2.68.0.md) - 2026-03-30
 - [v2.67.0](./v2.67.0.md) - 2026-03-28
 - [v2.66.2](./v2.66.2.md) - 2026-03-26

package/dist/web-ui/docs/cn/cli/release-notes/v2.69.0.md

@@ -0,0 +1,24 @@
+# 🚀 CodeBuddy Code v2.69.0 发布
+
+## ✨ 新功能
+
+### E2B 兼容 API
+
+全面对齐 E2B 开放协议，让 CodeBuddy Code 可作为 E2B 兼容的沙箱环境使用：
+
+- **文件系统 API**：新增 `/api/v1/fs/*` 和 `/api/v1/files/*` 端点，支持文件读写、目录操作、文件监听等完整文件系统功能
+- **进程管理 API**：新增 `/api/v1/process/*` 端点，支持进程启动（PTY/管道）、输入输出流、信号发送等全生命周期管理
+- **系统指标与环境变量 API**：新增 `/api/v1/metrics` 和 `/api/v1/envs` 端点，提供 CPU/内存/磁盘使用指标和环境变量查询
+
+## 🔧 改进优化
+
+- **PTY 终端增强**：新增 SSE 输出流、HTTP 输入发送、HTTP resize 端点，提供 WebSocket 之外的纯 HTTP 替代方案
+- **终端 Web UI 重构**：前端终端组件从 WebSocket 迁移到 SSE + HTTP 通信，提升跨平台兼容性
+- **分布式追踪**：基于 Hook 机制重构 trace 链路，支持 SDK 传递 traceId 实现端到端追踪，每次工具调用自动创建子 Span
+- **WeChat 多实例支持**：支持同时连接多个 WeChat 机器人实例，自动路由消息到正确的客户端
+- **WeChat 媒体消息**：支持接收和发送图片、文件、语音、视频消息
+- **中文引号修复**：自动修复模型输出中的中文引号，避免工具调用 JSON 解析失败
+
+## 🔒 安全修复
+
+- **企业微信 SSRF 防护**：企业微信机器人媒体下载添加 URL 白名单校验，确保仅限企微官方 CDN 域名，防止服务端请求伪造攻击

package/dist/web-ui/docs/cn/cli/release-notes/v2.70.0.md

@@ -0,0 +1,16 @@
+# 🚀 CodeBuddy Code v2.70.0 发布
+
+## ✨ 新功能
+
+### 内置命令模型驱动调用
+
+AI 模型现在可以通过 Skill 工具直接执行部分内置斜杠命令（如 /clear、/model、/config、/resume、/gateway 等），让 WebChat、微信等非终端场景也能由模型代理执行命令，无需用户手动输入斜杠命令。
+
+- /model、/config、/resume 等命令新增 `list` 子命令，支持以文本方式列出可用选项
+- 通过 `disableModelInvocation` 字段统一控制内置命令和自定义命令是否允许模型调用
+
+## 🔧 改进优化
+
+- **实例注册地址简化**：将 localUrl/tunnelUrl 合并为统一的 url 字段，后端自动确定最佳可达地址，简化配置
+- **权限确认框稳定性**：使用 useSyncExternalStore 替代 useEffect 订阅模式，彻底解决权限确认框偶发不显示的竞态问题
+- **会话权限模式保持**：修复多实例场景下切换会话时权限模式被重置的问题

package/dist/web-ui/docs/cn/cli/release-notes/v2.70.1.md

@@ -0,0 +1,18 @@
+# CodeBuddy Code v2.70.1 发布
+
+## 🔒 安全修复
+
+### CORS 跨域攻击防护
+
+修复了本地 Gateway 服务（`cbc --serve`）存在的跨域请求安全漏洞。此前，恶意网页可通过 JavaScript 跨域访问用户本地 localhost 服务，执行 Agent 命令或窃取输出数据。
+
+主要修复内容：
+
+- 替换框架默认的 `Access-Control-Allow-Origin: *` 为精确白名单机制，仅允许 localhost、127.0.0.1 和 Tunnel URL 的跨域请求
+- 新增 Host 头验证中间件，防止 DNS Rebinding 攻击
+- 修复 SSE 流式端点的 CORS 通配符漏洞
+- 默认绑定地址从 `0.0.0.0` 改为 `127.0.0.1`，避免服务暴露到局域网
+
+## 🔧 改进优化
+
+- **自定义跨域规则**：支持通过环境变量 `CODEBUDDY_CODE_CORS_ORIGINS`（逗号分隔）或 Settings 配置 `gateway.corsOrigins` 自定义允许的跨域源，满足特殊场景需求

package/dist/web-ui/docs/cn/cli/release-notes/v2.71.0.md

@@ -0,0 +1,18 @@
+# 🚀 CodeBuddy Code v2.71.0 发布
+
+## ✨ 新功能
+
+### Web UI 代码编辑器
+
+Web UI 新增文件浏览和代码编辑功能，让你可以直接在浏览器中查看和编辑项目文件：
+
+- **目录树导航**：左侧面板展示项目文件结构，快速定位文件
+- **多标签编辑**：同时打开多个文件，在标签间自由切换
+- **Monaco Editor**：集成 VS Code 同款编辑器引擎，支持语法高亮
+- **自动保存**：编辑内容自动保存，无需手动操作
+- **文件拖拽移动**：支持拖拽文件进行移动操作
+- **键盘快捷键**：支持常用快捷键，提升编辑效率
+
+## 🔧 改进优化
+
+- **流式超时时间优化**：将流式响应超时和首 token 超时默认值从 2 分钟提升至 10 分钟，减少复杂任务中因模型响应较慢导致的超时中断。仍可通过 `CODEBUDDY_STREAM_TIMEOUT_MS` 和 `CODEBUDDY_FIRST_TOKEN_TIMEOUT_MS` 环境变量自定义

package/dist/web-ui/docs/cn/cli/release-notes/v2.71.1.md

@@ -0,0 +1,7 @@
+# 🚀 CodeBuddy Code v2.71.1 发布
+
+## 🔧 改进优化
+
+- **SDK MCP 超时机制**：将固定超时替换为 AbortSignal 取消机制，支持长时间运行的 MCP 工具调用，避免复杂工具因超时被意外中断
+- **推理模型配置**：启用 thinking 模式时自动默认 effort 为 high，确保模型实际产出推理输出
+- **产品配置修复**：修正模型配置中 reasoning 字段的拼写错误

package/dist/web-ui/docs/cn/cli/remote-control.md

@@ -94,7 +94,7 @@ winget install Cloudflare.cloudflared
 当 `cloudflared` 未安装或 Tunnel 启动失败时，Gateway 自动回退到局域网模式。此模式下，仅同一网络中的设备可以访问。
 
 - 默认监听端口：`8321`
-- 监听地址：`0.0.0.0`（所有网络接口）
+- 监听地址：默认 `127.0.0.1`（仅本机），可通过 `--host 0.0.0.0` 监听所有网络接口
 
 ## 安全机制
 
@@ -172,7 +172,7 @@ Web UI 基于 ACP（Agent Client Protocol）与本地 Agent 通信，保证了
 
 | 环境变量 | 说明 |
 |:---------|:-----|
-| `CODEBUDDY_CORS_ORIGINS` | 额外的 CORS 允许来源（逗号分隔） |
+| `CODEBUDDY_CODE_CORS_ORIGINS` | 额外的 CORS 允许来源（逗号分隔） |
 
 ## 实例管理
 

package/dist/web-ui/docs/cn/cli/slash-commands.md

@@ -17,15 +17,15 @@ CodeBuddy Code 支持斜杠命令，允许您在聊天中执行特殊操作、
 | `/add-dir` | `<path>` | ✅ 支持 | 添加工作目录。指定要添加的目录路径。 |
 | `/agents` | | ✅ 支持 | 管理实验性 AI 智能体 |
 | `/compact`| | ✅ 支持 | 压缩上下文。 |
-| `/config`| | ✅ 支持 | 查看或修改本地配置，包括响应语言、模型、主题等设置。 |
+| `/config`| `[list \| get \| set]` | ✅ 支持 | 查看或修改本地配置。不带参数时打开交互式面板，`list` 列出当前设置，`get <key>` 读取设置，`set <key> <value>` 修改设置。 |
 | `/context` | | ✅ 支持 | 计算当前会话的上下文 token 分布情况。 |
 | `/cost` | | ✅ 支持 | 显示会话的成本和 Token 使用情况。 |
 | `/init` | | ✅ 支持 | 初始化一个新的 CodeBuddy 存储库。 |
 | `/mcp` | | ✅ 支持 | 管理 MCP 连接。 |
 | `/memory`| | ✅ 支持 | 管理长期记忆 |
-| `/model` | `[model-name]` | ✅ 支持 | 切换或查看当前使用的 AI 模型。不带参数时打开交互式选择界面，带模型名称参数时直接切换到指定模型（如 `/model gpt-5-codex`）。 |
-| `/model:text-to-image` | `[model-id]` | ✅ 支持 | 切换或查看当前使用的文生图模型。不带参数时打开交互式选择界面，带模型 ID 参数时直接切换到指定模型。 |
-| `/model:image-to-image` | `[model-id]` | ✅ 支持 | 切换或查看当前使用的图生图模型。不带参数时打开交互式选择界面，带模型 ID 参数时直接切换到指定模型。 |
+| `/model` | `[list \| model-name]` | ✅ 支持 | 切换或查看当前使用的 AI 模型。不带参数时打开交互式选择界面，`list` 列出可用模型，带模型名称参数时直接切换到指定模型（如 `/model gpt-4o`）。 |
+| `/model:text-to-image` | `[list \| model-id]` | ✅ 支持 | 切换或查看当前使用的文生图模型。不带参数时打开交互式选择界面，`list` 列出可用模型，带模型 ID 参数时直接切换到指定模型。 |
+| `/model:image-to-image` | `[list \| model-id]` | ✅ 支持 | 切换或查看当前使用的图生图模型。不带参数时打开交互式选择界面，`list` 列出可用模型，带模型 ID 参数时直接切换到指定模型。 |
 | `/permissions` | | ✅ 支持 | 管理工具权限和工作区目录访问权限。 |
 | `/plan` | | ✅ 支持 | 预览当前计划模式下的计划文件内容。 |
 | `/upgrade` | | ✅ 支持 | 在浏览器中打开升级页面，查看高级功能和订阅选项。 |
@@ -37,7 +37,7 @@ CodeBuddy Code 支持斜杠命令，允许您在聊天中执行特殊操作、
 | `/theme` | | ✅ 支持 | 打开主题选择面板，可选择和预览不同的终端主题(dark、light、colorblind-friendly、ANSI 等）。 |
 | `/export` | | ✅ 支持 | 导出当前对话到文件或剪贴板。 |
 | `/feedback` | | ✅ 支持 | 打开反馈页面，提交 Bug 报告或功能建议。 |
-| `/resume` | | ✅ 支持 | 恢复之前的会话。 |
+| `/resume` | `[list \| session-id]` | ✅ 支持 | 恢复之前的会话。不带参数时打开交互式面板，`list` 列出所有会话，带 session-id 时直接切换到指定会话。 |
 | `/rewind` | | ✅ 支持 | 回退对话到之前的某个消息点，可选择仅回退对话、仅回退代码或同时回退两者。详见 [检查点](checkpointing.md)。 |
 | `/sandbox` | | ✅ 支持 | 管理 Bash 命令沙箱模式，控制命令执行的安全策略。详见 [沙箱文档](bash-sandboxing.md)。 |
 | `/stats` | | ✅ 支持 | 显示使用统计信息，包括 Token 使用量、模型调用次数、会话时长等详细数据，支持总览和按模型分类两个视图。 |