skykoi 2026.3.11 → 2026.3.13

package/docs/zh-CN/gateway/multiple-gateways.md

@@ -2,7 +2,7 @@
 read_when:
   - 在同一台机器上运行多个 Gateway 网关
   - 你需要每个 Gateway 网关有隔离的配置/状态/端口
-summary: 在同一主机上运行多个 SkyKoi Gateway 网关（隔离、端口和配置文件）
+summary: 在同一主机上运行多个 SKYKOI Gateway 网关（隔离、端口和配置文件）
 title: 多 Gateway 网关
 x-i18n:
   generated_at: "2026-02-03T07:48:13Z"
@@ -33,19 +33,19 @@ x-i18n:
 
 ```bash
 # main
-SkyKoi --profile main setup
-SkyKoi --profile main gateway --port 18789
+SKYKOI --profile main setup
+SKYKOI --profile main gateway --port 18789
 
 # rescue
-SkyKoi --profile rescue setup
-SkyKoi --profile rescue gateway --port 19001
+SKYKOI --profile rescue setup
+SKYKOI --profile rescue gateway --port 19001
 ```
 
 按配置文件的服务：
 
 ```bash
-SkyKoi --profile main gateway install
-SkyKoi --profile rescue gateway install
+SKYKOI --profile main gateway install
+SKYKOI --profile rescue gateway install
 ```
 
 ## 救援机器人指南
@@ -66,11 +66,11 @@ SkyKoi --profile rescue gateway install
 ```bash
 # 主机器人（现有或新建，不带 --profile 参数）
 # 运行在端口 18789 + Chrome CDC/Canvas/... 端口
-SkyKoi onboard
-SkyKoi gateway install
+SKYKOI onboard
+SKYKOI gateway install
 
 # 救援机器人（隔离的配置文件 + 端口）
-SkyKoi --profile rescue onboard
+SKYKOI --profile rescue onboard
 # 注意：
 # - 工作区名称默认会添加 -rescue 后缀
 # - 端口应至少为 18789 + 20 个端口，
@@ -78,7 +78,7 @@ SkyKoi --profile rescue onboard
 # - 其余的新手引导与正常相同
 
 # 安装服务（如果在新手引导期间没有自动完成）
-SkyKoi --profile rescue gateway install
+SKYKOI --profile rescue gateway install
 ```
 
 ## 端口映射（派生）
@@ -101,19 +101,19 @@ SkyKoi --profile rescue gateway install
 ## 手动环境变量示例
 
 ```bash
-SKYKOI_CONFIG_PATH=~/.skykoi/main.json \
-SKYKOI_STATE_DIR=~/.skykoi-main \
-SkyKoi gateway --port 18789
+SKYKOI_CONFIG_PATH=~/.SKYKOI/main.json \
+SKYKOI_STATE_DIR=~/.SKYKOI-main \
+SKYKOI gateway --port 18789
 
-SKYKOI_CONFIG_PATH=~/.skykoi/rescue.json \
-SKYKOI_STATE_DIR=~/.skykoi-rescue \
-SkyKoi gateway --port 19001
+SKYKOI_CONFIG_PATH=~/.SKYKOI/rescue.json \
+SKYKOI_STATE_DIR=~/.SKYKOI-rescue \
+SKYKOI gateway --port 19001
 ```
 
 ## 快速检查
 
 ```bash
-SkyKoi --profile main status
-SkyKoi --profile rescue status
-SkyKoi --profile rescue browser status
+SKYKOI --profile main status
+SKYKOI --profile rescue status
+SKYKOI --profile rescue browser status
 ```

package/docs/zh-CN/gateway/network-model.md

@@ -12,12 +12,12 @@ x-i18n:
   workflow: 15
 ---
 
-大多数操作通过 Gateway 网关（`SkyKoi gateway`）进行，它是一个长期运行的单一进程，负责管理渠道连接和 WebSocket 控制平面。
+大多数操作通过 Gateway 网关（`SKYKOI gateway`）进行，它是一个长期运行的单一进程，负责管理渠道连接和 WebSocket 控制平面。
 
 ## 核心规则
 
 - 建议每台主机运行一个 Gateway 网关。它是唯一允许拥有 WhatsApp Web 会话的进程。对于救援机器人或严格隔离的场景，可以使用隔离的配置文件和端口运行多个 Gateway 网关。参见[多 Gateway 网关](/gateway/multiple-gateways)。
-- 优先使用回环地址：Gateway 网关的 WS 默认为 `ws://127.0.0.1:18789`。即使是回环连接，向导也会默认生成 gateway token。若需通过 tailnet 访问，请运行 `SkyKoi gateway --bind tailnet --token ...`，因为非回环绑定必须使用 token。
+- 优先使用回环地址：Gateway 网关的 WS 默认为 `ws://127.0.0.1:18789`。即使是回环连接，向导也会默认生成 gateway token。若需通过 tailnet 访问，请运行 `SKYKOI gateway --bind tailnet --token ...`，因为非回环绑定必须使用 token。
 - 节点根据需要通过局域网、tailnet 或 SSH 连接到 Gateway 网关的 WS。旧版 TCP 桥接已弃用。
 - Canvas 主机是一个 HTTP 文件服务器，运行在 `canvasHost.port`（默认 `18793`）上，提供 `/__SKYKOI__/canvas/` 路径供节点 WebView 使用。参见 [Gateway 网关配置](/gateway/configuration)（`canvasHost`）。
 - 远程使用通常通过 SSH 隧道或 Tailscale VPN。参见[远程访问](/gateway/remote)和[设备发现](/gateway/discovery)。

package/docs/zh-CN/gateway/openai-http-api.md

@@ -14,14 +14,14 @@ x-i18n:
 
 # OpenAI Chat Completions（HTTP）
 
-SkyKoi 的 Gateway 网关可以提供一个小型的 OpenAI 兼容 Chat Completions 端点。
+SKYKOI 的 Gateway 网关可以提供一个小型的 OpenAI 兼容 Chat Completions 端点。
 
 此端点**默认禁用**。请先在配置中启用它。
 
 - `POST /v1/chat/completions`
 - 与 Gateway 网关相同的端口（WS + HTTP 多路复用）：`http://<gateway-host>:<port>/v1/chat/completions`
 
-底层实现中，请求作为普通的 Gateway 网关智能体运行执行（与 `SkyKoi agent` 相同的代码路径），因此路由/权限/配置与你的 Gateway 网关一致。
+底层实现中，请求作为普通的 Gateway 网关智能体运行执行（与 `SKYKOI agent` 相同的代码路径），因此路由/权限/配置与你的 Gateway 网关一致。
 
 ## 认证
 
@@ -38,16 +38,16 @@ SkyKoi 的 Gateway 网关可以提供一个小型的 OpenAI 兼容 Chat Completi
 
 无需自定义头：在 OpenAI `model` 字段中编码智能体 ID：
 
-- `model: "SkyKoi:<agentId>"`（例如：`"SkyKoi:main"`、`"SkyKoi:beta"`）
+- `model: "SKYKOI:<agentId>"`（例如：`"SKYKOI:main"`、`"SKYKOI:beta"`）
 - `model: "agent:<agentId>"`（别名）
 
-或通过头指定特定的 SkyKoi 智能体：
+或通过头指定特定的 SKYKOI 智能体：
 
-- `x-SkyKoi-agent-id: <agentId>`（默认：`main`）
+- `x-SKYKOI-agent-id: <agentId>`（默认：`main`）
 
 高级选项：
 
-- `x-SkyKoi-session-key: <sessionKey>` 完全控制会话路由。
+- `x-SKYKOI-session-key: <sessionKey>` 完全控制会话路由。
 
 ## 启用端点
 
@@ -103,9 +103,9 @@ SkyKoi 的 Gateway 网关可以提供一个小型的 OpenAI 兼容 Chat Completi
 curl -sS http://127.0.0.1:18789/v1/chat/completions \
   -H 'Authorization: Bearer YOUR_TOKEN' \
   -H 'Content-Type: application/json' \
-  -H 'x-SkyKoi-agent-id: main' \
+  -H 'x-SKYKOI-agent-id: main' \
   -d '{
-    "model": "SkyKoi",
+    "model": "SKYKOI",
     "messages": [{"role":"user","content":"hi"}]
   }'
 ```
@@ -116,9 +116,9 @@ curl -sS http://127.0.0.1:18789/v1/chat/completions \
 curl -N http://127.0.0.1:18789/v1/chat/completions \
   -H 'Authorization: Bearer YOUR_TOKEN' \
   -H 'Content-Type: application/json' \
-  -H 'x-SkyKoi-agent-id: main' \
+  -H 'x-SKYKOI-agent-id: main' \
   -d '{
-    "model": "SkyKoi",
+    "model": "SKYKOI",
     "stream": true,
     "messages": [{"role":"user","content":"hi"}]
   }'

package/docs/zh-CN/gateway/openresponses-http-api.md

@@ -15,14 +15,14 @@ x-i18n:
 
 # OpenResponses API（HTTP）
 
-SkyKoi 的 Gateway 网关可以提供兼容 OpenResponses 的 `POST /v1/responses` 端点。
+SKYKOI 的 Gateway 网关可以提供兼容 OpenResponses 的 `POST /v1/responses` 端点。
 
 此端点**默认禁用**。请先在配置中启用。
 
 - `POST /v1/responses`
 - 与 Gateway 网关相同的端口（WS + HTTP 多路复用）：`http://<gateway-host>:<port>/v1/responses`
 
-底层实现中，请求作为正常的 Gateway 网关智能体运行执行（与 `SkyKoi agent` 相同的代码路径），因此路由/权限/配置与你的 Gateway 网关一致。
+底层实现中，请求作为正常的 Gateway 网关智能体运行执行（与 `SKYKOI agent` 相同的代码路径），因此路由/权限/配置与你的 Gateway 网关一致。
 
 ## 认证
 
@@ -39,16 +39,16 @@ SkyKoi 的 Gateway 网关可以提供兼容 OpenResponses 的 `POST /v1/response
 
 无需自定义头：在 OpenResponses `model` 字段中编码智能体 id：
 
-- `model: "SkyKoi:<agentId>"`（示例：`"SkyKoi:main"`、`"SkyKoi:beta"`）
+- `model: "SKYKOI:<agentId>"`（示例：`"SKYKOI:main"`、`"SKYKOI:beta"`）
 - `model: "agent:<agentId>"`（别名）
 
-或通过头指定特定的 SkyKoi 智能体：
+或通过头指定特定的 SKYKOI 智能体：
 
-- `x-SkyKoi-agent-id: <agentId>`（默认：`main`）
+- `x-SKYKOI-agent-id: <agentId>`（默认：`main`）
 
 高级：
 
-- `x-SkyKoi-session-key: <sessionKey>` 完全控制会话路由。
+- `x-SKYKOI-session-key: <sessionKey>` 完全控制会话路由。
 
 ## 启用端点
 
@@ -295,9 +295,9 @@ URL 获取默认值：
 curl -sS http://127.0.0.1:18789/v1/responses \
   -H 'Authorization: Bearer YOUR_TOKEN' \
   -H 'Content-Type: application/json' \
-  -H 'x-SkyKoi-agent-id: main' \
+  -H 'x-SKYKOI-agent-id: main' \
   -d '{
-    "model": "SkyKoi",
+    "model": "SKYKOI",
     "input": "hi"
   }'
 ```
@@ -308,9 +308,9 @@ curl -sS http://127.0.0.1:18789/v1/responses \
 curl -N http://127.0.0.1:18789/v1/responses \
   -H 'Authorization: Bearer YOUR_TOKEN' \
   -H 'Content-Type: application/json' \
-  -H 'x-SkyKoi-agent-id: main' \
+  -H 'x-SKYKOI-agent-id: main' \
   -d '{
-    "model": "SkyKoi",
+    "model": "SKYKOI",
     "stream": true,
     "input": "hi"
   }'

package/docs/zh-CN/gateway/pairing.md

@@ -39,11 +39,11 @@ x-i18n:
 ## CLI 工作流程（支持无头模式）
 
 ```bash
-SkyKoi nodes pending
-SkyKoi nodes approve <requestId>
-SkyKoi nodes reject <requestId>
-SkyKoi nodes status
-SkyKoi nodes rename --node <id|name|ip> --name "Living Room iPad"
+SKYKOI nodes pending
+SKYKOI nodes approve <requestId>
+SKYKOI nodes reject <requestId>
+SKYKOI nodes status
+SKYKOI nodes rename --node <id|name|ip> --name "Living Room iPad"
 ```
 
 `nodes status` 显示已配对/已连接的节点及其功能。
@@ -80,10 +80,10 @@ SkyKoi nodes rename --node <id|name|ip> --name "Living Room iPad"
 
 ## 存储（本地，私有）
 
-配对状态存储在 Gateway 网关状态目录下（默认 `~/.skykoi`）：
+配对状态存储在 Gateway 网关状态目录下（默认 `~/.SKYKOI`）：
 
-- `~/.skykoi/nodes/paired.json`
-- `~/.skykoi/nodes/pending.json`
+- `~/.SKYKOI/nodes/paired.json`
+- `~/.SKYKOI/nodes/pending.json`
 
 如果你覆盖了 `SKYKOI_STATE_DIR`，`nodes/` 文件夹会随之移动。
 

package/docs/zh-CN/gateway/protocol.md

@@ -16,7 +16,7 @@ x-i18n:
 
 # Gateway 网关协议（WebSocket）
 
-Gateway 网关 WS 协议是 SkyKoi 的**单一控制平面 + 节点传输**。所有客户端（CLI、Web UI、macOS 应用、iOS/Android 节点、无头节点）都通过 WebSocket 连接，并在握手时声明其**角色** + **作用域**。
+Gateway 网关 WS 协议是 SKYKOI 的**单一控制平面 + 节点传输**。所有客户端（CLI、Web UI、macOS 应用、iOS/Android 节点、无头节点）都通过 WebSocket 连接，并在握手时声明其**角色** + **作用域**。
 
 ## 传输
 
@@ -58,7 +58,7 @@ Gateway 网关 → 客户端（连接前质询）：
     "permissions": {},
     "auth": { "token": "…" },
     "locale": "en-US",
-    "userAgent": "SkyKoi-cli/1.2.3",
+    "userAgent": "SKYKOI-cli/1.2.3",
     "device": {
       "id": "device_fingerprint",
       "publicKey": "…",
@@ -116,7 +116,7 @@ Gateway 网关 → 客户端：
     "permissions": { "camera.capture": true, "screen.record": false },
     "auth": { "token": "…" },
     "locale": "en-US",
-    "userAgent": "SkyKoi-ios/1.2.3",
+    "userAgent": "SKYKOI-ios/1.2.3",
     "device": {
       "id": "device_fingerprint",
       "publicKey": "…",

package/docs/zh-CN/gateway/remote-gateway-readme.md

@@ -1,6 +1,6 @@
 ---
 read_when: Connecting the macOS app to a remote gateway over SSH
-summary: SkyKoi.app 连接远程 Gateway 网关的 SSH 隧道设置
+summary: SKYKOI.app 连接远程 Gateway 网关的 SSH 隧道设置
 title: 远程 Gateway 网关设置
 x-i18n:
   generated_at: "2026-02-03T07:48:37Z"
@@ -11,9 +11,9 @@ x-i18n:
   workflow: 15
 ---
 
-# 使用远程 Gateway 网关运行 SkyKoi.app
+# 使用远程 Gateway 网关运行 SKYKOI.app
 
-SkyKoi.app 使用 SSH 隧道连接到远程 Gateway 网关。本指南向你展示如何设置。
+SKYKOI.app 使用 SSH 隧道连接到远程 Gateway 网关。本指南向你展示如何设置。
 
 ## 概述
 
@@ -21,7 +21,7 @@ SkyKoi.app 使用 SSH 隧道连接到远程 Gateway 网关。本指南向你展
 ┌─────────────────────────────────────────────────────────────┐
 │                        Client Machine                          │
 │                                                              │
-│  SkyKoi.app ──► ws://127.0.0.1:18789 (local port)           │
+│  SKYKOI.app ──► ws://127.0.0.1:18789 (local port)           │
 │                     │                                        │
 │                     ▼                                        │
 │  SSH Tunnel ────────────────────────────────────────────────│
@@ -73,11 +73,11 @@ launchctl setenv SKYKOI_GATEWAY_TOKEN "<your-token>"
 ssh -N remote-gateway &
 ```
 
-### 步骤 5：重启 SkyKoi.app
+### 步骤 5：重启 SKYKOI.app
 
 ```bash
-# Quit SkyKoi.app (⌘Q), then reopen:
-open /path/to/SkyKoi.app
+# Quit SKYKOI.app (⌘Q), then reopen:
+open /path/to/SKYKOI.app
 ```
 
 应用现在将通过 SSH 隧道连接到远程 Gateway 网关。
@@ -125,7 +125,7 @@ launchctl bootstrap gui/$UID ~/Library/LaunchAgents/bot.molt.ssh-tunnel.plist
 - 崩溃时重新启动
 - 在后台持续运行
 
-旧版注意事项：如果存在任何遗留的 `com.skykoi.ssh-tunnel` LaunchAgent，请将其删除。
+旧版注意事项：如果存在任何遗留的 `com.SKYKOI.ssh-tunnel` LaunchAgent，请将其删除。
 
 ---
 
@@ -161,4 +161,4 @@ launchctl bootout gui/$UID/bot.molt.ssh-tunnel
 | `KeepAlive`                          | 隧道崩溃时自动重启                    |
 | `RunAtLoad`                          | 代理加载时启动隧道                    |
 
-SkyKoi.app 连接到你的客户端机器上的 `ws://127.0.0.1:18789`。SSH 隧道将该连接转发到运行 Gateway 网关的远程机器的端口 18789。
+SKYKOI.app 连接到你的客户端机器上的 `ws://127.0.0.1:18789`。SSH 隧道将该连接转发到运行 Gateway 网关的远程机器的端口 18789。

package/docs/zh-CN/gateway/remote.md

@@ -43,7 +43,7 @@ x-i18n:
 
 笔记本电脑**不**运行智能体。它远程连接：
 
-- 使用 macOS 应用的 **Remote over SSH** 模式（设置 → 通用 → "SkyKoi runs"）。
+- 使用 macOS 应用的 **Remote over SSH** 模式（设置 → 通用 → "SKYKOI runs"）。
 - 应用打开并管理隧道，因此 WebChat + 健康检查"直接工作"。
 
 操作手册：[macOS 远程访问](/platforms/mac/remote)。
@@ -83,8 +83,8 @@ ssh -N -L 18789:127.0.0.1:18789 user@host
 
 隧道建立后：
 
-- `SkyKoi health` 和 `SkyKoi status --deep` 现在通过 `ws://127.0.0.1:18789` 访问远程 Gateway 网关。
-- `SkyKoi gateway {status,health,send,agent,call}` 在需要时也可以通过 `--url` 指定转发的 URL。
+- `SKYKOI health` 和 `SKYKOI status --deep` 现在通过 `ws://127.0.0.1:18789` 访问远程 Gateway 网关。
+- `SKYKOI gateway {status,health,send,agent,call}` 在需要时也可以通过 `--url` 指定转发的 URL。
 
 注意：将 `18789` 替换为你配置的 `gateway.port`（或 `--port`/`SKYKOI_GATEWAY_PORT`）。
 

package/docs/zh-CN/gateway/sandbox-vs-tool-policy-vs-elevated.md

@@ -14,7 +14,7 @@ x-i18n:
 
 # 沙箱 vs 工具策略 vs 提权
 
-SkyKoi 有三个相关（但不同）的控制：
+SKYKOI 有三个相关（但不同）的控制：
 
 1. **沙箱**（`agents.defaults.sandbox.*` / `agents.list[].sandbox.*`）决定**工具在哪里运行**（Docker vs 主机）。
 2. **工具策略**（`tools.*`、`tools.sandbox.tools.*`、`agents.list[].tools.*`）决定**哪些工具可用/允许**。
@@ -22,13 +22,13 @@ SkyKoi 有三个相关（但不同）的控制：
 
 ## 快速调试
 
-使用检查器查看 SkyKoi *实际*在做什么：
+使用检查器查看 SKYKOI *实际*在做什么：
 
 ```bash
-SkyKoi sandbox explain
-SkyKoi sandbox explain --session agent:main:main
-SkyKoi sandbox explain --agent work
-SkyKoi sandbox explain --json
+SKYKOI sandbox explain
+SKYKOI sandbox explain --session agent:main:main
+SKYKOI sandbox explain --agent work
+SKYKOI sandbox explain --json
 ```
 
 它会打印：
@@ -100,7 +100,7 @@ SkyKoi sandbox explain --json
 - `group:automation`：`cron`、`gateway`
 - `group:messaging`：`message`
 - `group:nodes`：`nodes`
-- `group:SkyKoi`：所有内置 SkyKoi 工具（不包括提供商插件）
+- `group:SKYKOI`：所有内置 SKYKOI 工具（不包括提供商插件）
 
 ## 提权：仅限 exec 的"在主机上运行"
 

package/docs/zh-CN/gateway/sandboxing.md

@@ -1,7 +1,7 @@
 ---
 read_when: You want a dedicated explanation of sandboxing or need to tune agents.defaults.sandbox.
 status: active
-summary: SkyKoi 沙箱隔离的工作原理：模式、作用域、工作区访问和镜像
+summary: SKYKOI 沙箱隔离的工作原理：模式、作用域、工作区访问和镜像
 title: 沙箱隔离
 x-i18n:
   generated_at: "2026-02-03T07:49:29Z"
@@ -14,7 +14,7 @@ x-i18n:
 
 # 沙箱隔离
 
-SkyKoi 可以**在 Docker 容器内运行工具**以减少影响范围。
+SKYKOI 可以**在 Docker 容器内运行工具**以减少影响范围。
 这是**可选的**，由配置控制（`agents.defaults.sandbox` 或 `agents.list[].sandbox`）。如果沙箱隔离关闭，工具在主机上运行。
 Gateway 网关保留在主机上；启用时工具执行在隔离的沙箱中运行。
 
@@ -58,12 +58,12 @@ Gateway 网关保留在主机上；启用时工具执行在隔离的沙箱中运
 
 `agents.defaults.sandbox.workspaceAccess` 控制**沙箱可以看到什么**：
 
-- `"none"`（默认）：工具看到 `~/.skykoi/sandboxes` 下的沙箱工作区。
+- `"none"`（默认）：工具看到 `~/.SKYKOI/sandboxes` 下的沙箱工作区。
 - `"ro"`：以只读方式在 `/agent` 挂载智能体工作区（禁用 `write`/`edit`/`apply_patch`）。
 - `"rw"`：以读写方式在 `/workspace` 挂载智能体工作区。
 
 入站媒体被复制到活动沙箱工作区（`media/inbound/*`）。
-Skills 注意事项：`read` 工具以沙箱为根。使用 `workspaceAccess: "none"` 时，SkyKoi 将符合条件的 Skills 镜像到沙箱工作区（`.../skills`）以便可以读取。使用 `"rw"` 时，工作区 Skills 可从 `/workspace/skills` 读取。
+Skills 注意事项：`read` 工具以沙箱为根。使用 `workspaceAccess: "none"` 时，SKYKOI 将符合条件的 Skills 镜像到沙箱工作区（`.../skills`）以便可以读取。使用 `"rw"` 时，工作区 Skills 可从 `/workspace/skills` 读取。
 
 ## 自定义绑定挂载
 
@@ -107,7 +107,7 @@ Skills 注意事项：`read` 工具以沙箱为根。使用 `workspaceAccess: "n
 
 ## 镜像 + 设置
 
-默认镜像：`SkyKoi-sandbox:bookworm-slim`
+默认镜像：`SKYKOI-sandbox:bookworm-slim`
 
 构建一次：
 
@@ -155,7 +155,7 @@ Docker 安装和容器化 Gateway 网关在此：
 
 调试：
 
-- 使用 `SkyKoi sandbox explain` 检查生效的沙箱模式、工具策略和修复配置键。
+- 使用 `SKYKOI sandbox explain` 检查生效的沙箱模式、工具策略和修复配置键。
 - 参见[沙箱 vs 工具策略 vs 提权](/gateway/sandbox-vs-tool-policy-vs-elevated)了解"为什么被阻止？"的心智模型。
   保持锁定。