skykoi 2026.3.11 → 2026.3.13

package/docs/zh-CN/cli/sessions.md

@@ -1,7 +1,7 @@
 ---
 read_when:
   - 你想列出已存储的会话并查看近期活动
-summary: "`SkyKoi sessions`（列出已存储的会话及使用情况）的 CLI 参考"
+summary: "`SKYKOI sessions`（列出已存储的会话及使用情况）的 CLI 参考"
 title: sessions
 x-i18n:
   generated_at: "2026-02-01T20:21:25Z"
@@ -12,12 +12,12 @@ x-i18n:
   workflow: 14
 ---
 
-# `SkyKoi sessions`
+# `SKYKOI sessions`
 
 列出已存储的对话会话。
 
 ```bash
-SkyKoi sessions
-SkyKoi sessions --active 120
-SkyKoi sessions --json
+SKYKOI sessions
+SKYKOI sessions --active 120
+SKYKOI sessions --json
 ```

package/docs/zh-CN/cli/setup.md

@@ -2,7 +2,7 @@
 read_when:
   - 你在不使用完整新手引导向导的情况下进行首次设置
   - 你想设置默认工作区路径
-summary: "`SkyKoi setup` 的 CLI 参考（初始化配置 + 工作区）"
+summary: "`SKYKOI setup` 的 CLI 参考（初始化配置 + 工作区）"
 title: setup
 x-i18n:
   generated_at: "2026-02-01T20:21:26Z"
@@ -13,9 +13,9 @@ x-i18n:
   workflow: 14
 ---
 
-# `SkyKoi setup`
+# `SKYKOI setup`
 
-初始化 `~/.skykoi/skykoi.json` 和智能体工作区。
+初始化 `~/.SKYKOI/SKYKOI.json` 和智能体工作区。
 
 相关内容：
 
@@ -25,12 +25,12 @@ x-i18n:
 ## 示例
 
 ```bash
-SkyKoi setup
-SkyKoi setup --workspace ~/.skykoi/workspace
+SKYKOI setup
+SKYKOI setup --workspace ~/.SKYKOI/workspace
 ```
 
 通过 setup 运行向导：
 
 ```bash
-SkyKoi setup --wizard
+SKYKOI setup --wizard
 ```

package/docs/zh-CN/cli/skills.md

@@ -2,7 +2,7 @@
 read_when:
   - 你想查看哪些 Skills 可用并准备好运行
   - 你想调试 Skills 缺少的二进制文件/环境变量/配置
-summary: "`skykoi skills` 的 CLI 参考（列出/信息/检查）和 skill 资格"
+summary: "`SKYKOI skills` 的 CLI 参考（列出/信息/检查）和 skill 资格"
 title: skills
 x-i18n:
   generated_at: "2026-02-03T07:45:14Z"
@@ -13,7 +13,7 @@ x-i18n:
   workflow: 15
 ---
 
-# `skykoi skills`
+# `SKYKOI skills`
 
 检查 Skills（内置 + 工作区 + 托管覆盖）并查看哪些符合条件，哪些缺少要求。
 
@@ -21,13 +21,13 @@ x-i18n:
 
 - Skills 系统：[Skills](/tools/skills)
 - Skills 配置：[Skills 配置](/tools/skills-config)
-- SkyKoi Skills 安装：[SkyKoi Skills](/tools/SkyKoi Skills)
+- SKYKOI Skills 安装：[SKYKOI Skills](/tools/SKYKOI Skills)
 
 ## 命令
 
 ```bash
-SkyKoi skills list
-SkyKoi skills list --eligible
-SkyKoi skills info <name>
-SkyKoi skills check
+SKYKOI skills list
+SKYKOI skills list --eligible
+SKYKOI skills info <name>
+SKYKOI skills check
 ```

package/docs/zh-CN/cli/status.md

@@ -2,7 +2,7 @@
 read_when:
   - 你想快速诊断渠道健康状况 + 最近的会话接收者
   - 你想获取可粘贴的"all"状态用于调试
-summary: "`SkyKoi status` 的 CLI 参考（诊断、探测、使用量快照）"
+summary: "`SKYKOI status` 的 CLI 参考（诊断、探测、使用量快照）"
 title: status
 x-i18n:
   generated_at: "2026-02-03T07:45:21Z"
@@ -13,15 +13,15 @@ x-i18n:
   workflow: 15
 ---
 
-# `SkyKoi status`
+# `SKYKOI status`
 
 渠道 + 会话的诊断。
 
 ```bash
-SkyKoi status
-SkyKoi status --all
-SkyKoi status --deep
-SkyKoi status --usage
+SKYKOI status
+SKYKOI status --all
+SKYKOI status --deep
+SKYKOI status --usage
 ```
 
 注意事项：
@@ -30,4 +30,4 @@ SkyKoi status --usage
 - 当配置了多个智能体时，输出包含每个智能体的会话存储。
 - 概览包含 Gateway 网关 + 节点主机服务安装/运行时状态（如果可用）。
 - 概览包含更新渠道 + git SHA（用于源代码检出）。
-- 更新信息显示在概览中；如果有可用更新，status 会打印提示运行 `SkyKoi update`（参见[更新](/install/updating)）。
+- 更新信息显示在概览中；如果有可用更新，status 会打印提示运行 `SKYKOI update`（参见[更新](/install/updating)）。

package/docs/zh-CN/cli/system.md

@@ -3,7 +3,7 @@ read_when:
   - 你想在不创建 cron 作业的情况下入队系统事件
   - 你需要启用或禁用心跳
   - 你想检查系统在线状态条目
-summary: "`SkyKoi system` 的 CLI 参考（系统事件、心跳、在线状态）"
+summary: "`SKYKOI system` 的 CLI 参考（系统事件、心跳、在线状态）"
 title: system
 x-i18n:
   generated_at: "2026-02-03T07:45:23Z"
@@ -14,17 +14,17 @@ x-i18n:
   workflow: 15
 ---
 
-# `SkyKoi system`
+# `SKYKOI system`
 
 Gateway 网关的系统级辅助工具：入队系统事件、控制心跳和查看在线状态。
 
 ## 常用命令
 
 ```bash
-SkyKoi system event --text "Check for urgent follow-ups" --mode now
-SkyKoi system heartbeat enable
-SkyKoi system heartbeat last
-SkyKoi system presence
+SKYKOI system event --text "Check for urgent follow-ups" --mode now
+SKYKOI system heartbeat enable
+SKYKOI system heartbeat last
+SKYKOI system presence
 ```
 
 ## `system event`

package/docs/zh-CN/cli/tui.md

@@ -2,7 +2,7 @@
 read_when:
   - 你想要一个连接 Gateway 网关的终端 UI（支持远程）
   - 你想从脚本传递 url/token/session
-summary: "`SkyKoi tui` 的 CLI 参考（连接到 Gateway 网关的终端 UI）"
+summary: "`SKYKOI tui` 的 CLI 参考（连接到 Gateway 网关的终端 UI）"
 title: tui
 x-i18n:
   generated_at: "2026-02-03T07:45:20Z"
@@ -13,7 +13,7 @@ x-i18n:
   workflow: 15
 ---
 
-# `SkyKoi tui`
+# `SKYKOI tui`
 
 打开连接到 Gateway 网关的终端 UI。
 
@@ -24,7 +24,7 @@ x-i18n:
 ## 示例
 
 ```bash
-SkyKoi tui
-SkyKoi tui --url ws://127.0.0.1:18789 --token <token>
-SkyKoi tui --session main --deliver
+SKYKOI tui
+SKYKOI tui --url ws://127.0.0.1:18789 --token <token>
+SKYKOI tui --session main --deliver
 ```

package/docs/zh-CN/cli/uninstall.md

@@ -2,7 +2,7 @@
 read_when:
   - 你想移除 Gateway 网关服务和/或本地状态
   - 你想先进行试运行
-summary: "`SkyKoi uninstall` 的 CLI 参考（移除 Gateway 网关服务 + 本地数据）"
+summary: "`SKYKOI uninstall` 的 CLI 参考（移除 Gateway 网关服务 + 本地数据）"
 title: uninstall
 x-i18n:
   generated_at: "2026-02-03T10:04:23Z"
@@ -13,12 +13,12 @@ x-i18n:
   workflow: 15
 ---
 
-# `SkyKoi uninstall`
+# `SKYKOI uninstall`
 
 卸载 Gateway 网关服务 + 本地数据（CLI 保留）。
 
 ```bash
-SkyKoi uninstall
-SkyKoi uninstall --all --yes
-SkyKoi uninstall --dry-run
+SKYKOI uninstall
+SKYKOI uninstall --all --yes
+SKYKOI uninstall --dry-run
 ```

package/docs/zh-CN/cli/update.md

@@ -2,7 +2,7 @@
 read_when:
   - 你想安全地更新源码检出
   - 你需要了解 `--update` 简写行为
-summary: "`SkyKoi update` 的 CLI 参考（相对安全的源码更新 + Gateway 网关自动重启）"
+summary: "`SKYKOI update` 的 CLI 参考（相对安全的源码更新 + Gateway 网关自动重启）"
 title: update
 x-i18n:
   generated_at: "2026-02-03T07:45:34Z"
@@ -13,24 +13,24 @@ x-i18n:
   workflow: 15
 ---
 
-# `SkyKoi update`
+# `SKYKOI update`
 
-安全更新 SkyKoi 并在 stable/beta/dev 渠道之间切换。
+安全更新 SKYKOI 并在 stable/beta/dev 渠道之间切换。
 
 如果你通过 **npm/pnpm** 安装（全局安装，无 git 元数据），更新通过 [更新](/install/updating) 中的包管理器流程进行。
 
 ## 用法
 
 ```bash
-SkyKoi update
-SkyKoi update status
-SkyKoi update wizard
-SkyKoi update --channel beta
-SkyKoi update --channel dev
-SkyKoi update --tag beta
-SkyKoi update --no-restart
-SkyKoi update --json
-SkyKoi --update
+SKYKOI update
+SKYKOI update status
+SKYKOI update wizard
+SKYKOI update --channel beta
+SKYKOI update --channel dev
+SKYKOI update --tag beta
+SKYKOI update --no-restart
+SKYKOI update --json
+SKYKOI --update
 ```
 
 ## 选项
@@ -48,9 +48,9 @@ SkyKoi --update
 显示当前更新渠道 + git 标签/分支/SHA（对于源码检出），以及更新可用性。
 
 ```bash
-SkyKoi update status
-SkyKoi update status --json
-SkyKoi update status --timeout 10
+SKYKOI update status
+SKYKOI update status --json
+SKYKOI update status --timeout 10
 ```
 
 选项：
@@ -64,9 +64,9 @@ SkyKoi update status --timeout 10
 
 ## 工作原理
 
-当你显式切换渠道（`--channel ...`）时，SkyKoi 也会保持安装方式一致：
+当你显式切换渠道（`--channel ...`）时，SKYKOI 也会保持安装方式一致：
 
-- `dev` → 确保存在 git 检出（默认：`~/SkyKoi`，可通过 `SKYKOI_GIT_DIR` 覆盖），更新它，并从该检出安装全局 CLI。
+- `dev` → 确保存在 git 检出（默认：`~/SKYKOI`，可通过 `SKYKOI_GIT_DIR` 覆盖），更新它，并从该检出安装全局 CLI。
 - `stable`/`beta` → 使用匹配的 dist-tag 从 npm 安装。
 
 ## Git 检出流程
@@ -86,16 +86,16 @@ SkyKoi update status --timeout 10
 5. Rebase 到所选提交（仅 dev）。
 6. 安装依赖（优先使用 pnpm；npm 作为备选）。
 7. 构建 + 构建控制界面。
-8. 运行 `SkyKoi doctor` 作为最终的"安全更新"检查。
+8. 运行 `SKYKOI doctor` 作为最终的"安全更新"检查。
 9. 将插件同步到当前渠道（dev 使用捆绑的扩展；stable/beta 使用 npm）并更新 npm 安装的插件。
 
 ## `--update` 简写
 
-`SkyKoi --update` 会重写为 `SkyKoi update`（便于 shell 和启动脚本使用）。
+`SKYKOI --update` 会重写为 `SKYKOI update`（便于 shell 和启动脚本使用）。
 
 ## 另请参阅
 
-- `SkyKoi doctor`（在 git 检出上会提供先运行更新的选项）
+- `SKYKOI doctor`（在 git 检出上会提供先运行更新的选项）
 - [开发渠道](/install/development-channels)
 - [更新](/install/updating)
 - [CLI 参考](/cli)

package/docs/zh-CN/cli/voicecall.md

@@ -2,7 +2,7 @@
 read_when:
   - 使用语音通话插件并想了解 CLI 入口
   - 想要 `voicecall call|continue|status|tail|expose` 的快速示例
-summary: 语音通话插件命令的 `SkyKoi voicecall` CLI 参考
+summary: 语音通话插件命令的 `SKYKOI voicecall` CLI 参考
 title: voicecall
 x-i18n:
   generated_at: "2026-02-01T20:21:37Z"
@@ -13,7 +13,7 @@ x-i18n:
   workflow: 14
 ---
 
-# `SkyKoi voicecall`
+# `SKYKOI voicecall`
 
 `voicecall` 是一个由插件提供的命令。只有在安装并启用了语音通话插件时才会出现。
 
@@ -24,18 +24,18 @@ x-i18n:
 ## 常用命令
 
 ```bash
-SkyKoi voicecall status --call-id <id>
-SkyKoi voicecall call --to "+15555550123" --message "Hello" --mode notify
-SkyKoi voicecall continue --call-id <id> --message "Any questions?"
-SkyKoi voicecall end --call-id <id>
+SKYKOI voicecall status --call-id <id>
+SKYKOI voicecall call --to "+15555550123" --message "Hello" --mode notify
+SKYKOI voicecall continue --call-id <id> --message "Any questions?"
+SKYKOI voicecall end --call-id <id>
 ```
 
 ## 暴露 Webhook（Tailscale）
 
 ```bash
-SkyKoi voicecall expose --mode serve
-SkyKoi voicecall expose --mode funnel
-SkyKoi voicecall unexpose
+SKYKOI voicecall expose --mode serve
+SKYKOI voicecall expose --mode funnel
+SKYKOI voicecall unexpose
 ```
 
 安全提示：仅将 webhook 端点暴露给你信任的网络。尽可能优先使用 Tailscale Serve 而非 Funnel。

package/docs/zh-CN/cli/webhooks.md

@@ -1,8 +1,8 @@
 ---
 read_when:
-  - 你想将 Gmail Pub/Sub 事件接入 SkyKoi
+  - 你想将 Gmail Pub/Sub 事件接入 SKYKOI
   - 你需要 Webhook 辅助命令
-summary: "`SkyKoi webhooks`（Webhook 辅助工具 + Gmail Pub/Sub）的 CLI 参考"
+summary: "`SKYKOI webhooks`（Webhook 辅助工具 + Gmail Pub/Sub）的 CLI 参考"
 title: webhooks
 x-i18n:
   generated_at: "2026-02-01T20:21:38Z"
@@ -13,7 +13,7 @@ x-i18n:
   workflow: 14
 ---
 
-# `SkyKoi webhooks`
+# `SKYKOI webhooks`
 
 Webhook 辅助工具和集成（Gmail Pub/Sub、Webhook 辅助工具）。
 
@@ -25,8 +25,8 @@ Webhook 辅助工具和集成（Gmail Pub/Sub、Webhook 辅助工具）。
 ## Gmail
 
 ```bash
-SkyKoi webhooks gmail setup --account you@example.com
-SkyKoi webhooks gmail run
+SKYKOI webhooks gmail setup --account you@example.com
+SKYKOI webhooks gmail run
 ```
 
 详情请参阅 [Gmail Pub/Sub 文档](/automation/gmail-pubsub)。

package/docs/zh-CN/concepts/agent-loop.md

@@ -12,11 +12,11 @@ x-i18n:
   workflow: 15
 ---
 
-# 智能体循环（SkyKoi）
+# 智能体循环（SKYKOI）
 
 智能体循环是智能体的完整"真实"运行：接收 → 上下文组装 → 模型推理 → 工具执行 → 流式回复 → 持久化。这是将消息转化为操作和最终回复的权威路径，同时保持会话状态的一致性。
 
-在 SkyKoi 中，循环是每个会话的单次序列化运行，在模型思考、调用工具和流式输出时发出生命周期和流事件。本文档解释了这个真实循环是如何端到端连接的。
+在 SKYKOI 中，循环是每个会话的单次序列化运行，在模型思考、调用工具和流式输出时发出生命周期和流事件。本文档解释了这个真实循环是如何端到端连接的。
 
 ## 入口点
 
@@ -37,7 +37,7 @@ x-i18n:
    - 订阅 pi 事件并流式传输助手/工具增量
    - 强制执行超时 -> 超时则中止运行
    - 返回有效负载 + 使用元数据
-4. `subscribeEmbeddedPiSession` 将 pi-agent-core 事件桥接到 SkyKoi `agent` 流：
+4. `subscribeEmbeddedPiSession` 将 pi-agent-core 事件桥接到 SKYKOI `agent` 流：
    - 工具事件 => `stream: "tool"`
    - 助手增量 => `stream: "assistant"`
    - 生命周期事件 => `stream: "lifecycle"`（`phase: "start" | "end" | "error"`）
@@ -60,13 +60,13 @@ x-i18n:
 
 ## 提示组装 + 系统提示
 
-- 系统提示由 SkyKoi 的基础提示、Skills 提示、引导上下文和每次运行的覆盖构建。
+- 系统提示由 SKYKOI 的基础提示、Skills 提示、引导上下文和每次运行的覆盖构建。
 - 强制执行模型特定的限制和压缩保留令牌。
 - 参见[系统提示](/concepts/system-prompt)了解模型看到的内容。
 
 ## 钩子点（可以拦截的位置）
 
-SkyKoi 有两个钩子系统：
+SKYKOI 有两个钩子系统：
 
 - **内部钩子**（Gateway 网关钩子）：用于命令和生命周期事件的事件驱动脚本。
 - **插件钩子**：智能体/工具生命周期和 Gateway 网关管道中的扩展点。

package/docs/zh-CN/concepts/agent-workspace.md

@@ -17,28 +17,28 @@ x-i18n:
 
 工作区是智能体的家。它是文件工具和工作区上下文使用的唯一工作目录。请保持其私密性并将其视为记忆。
 
-这与 `~/.skykoi/` 是分开的，后者存储配置、凭证和会话。
+这与 `~/.SKYKOI/` 是分开的，后者存储配置、凭证和会话。
 
 **重要：** 工作区是**默认 cwd**，而不是硬性沙箱。工具会根据工作区解析相对路径，但绝对路径仍然可以访问主机上的其他位置，除非启用了沙箱隔离。如果你需要隔离，请使用
 [`agents.defaults.sandbox`](/gateway/sandboxing)（和/或每智能体沙箱配置）。
-当启用沙箱隔离且 `workspaceAccess` 不是 `"rw"` 时，工具在 `~/.skykoi/sandboxes` 下的沙箱工作区内操作，而不是你的主机工作区。
+当启用沙箱隔离且 `workspaceAccess` 不是 `"rw"` 时，工具在 `~/.SKYKOI/sandboxes` 下的沙箱工作区内操作，而不是你的主机工作区。
 
 ## 默认位置
 
-- 默认：`~/.skykoi/workspace`
+- 默认：`~/.SKYKOI/workspace`
 - 如果设置了 `SKYKOI_PROFILE` 且不是 `"default"`，默认值变为
-  `~/.skykoi/workspace-<profile>`。
-- 在 `~/.skykoi/skykoi.json` 中覆盖：
+  `~/.SKYKOI/workspace-<profile>`。
+- 在 `~/.SKYKOI/SKYKOI.json` 中覆盖：
 
 ```json5
 {
   agent: {
-    workspace: "~/.skykoi/workspace",
+    workspace: "~/.SKYKOI/workspace",
   },
 }
 ```
 
-`SkyKoi onboard`、`SkyKoi configure` 或 `SkyKoi setup` 将创建工作区并在缺失时填充引导文件。
+`SKYKOI onboard`、`SKYKOI configure` 或 `SKYKOI setup` 将创建工作区并在缺失时填充引导文件。
 
 如果你已经自己管理工作区文件，可以禁用引导文件创建：
 
@@ -48,16 +48,16 @@ x-i18n:
 
 ## 额外的工作区文件夹
 
-旧版安装可能创建了 `~/SkyKoi`。保留多个工作区目录可能会导致混乱的认证或状态漂移，因为同一时间只有一个工作区是活动的。
+旧版安装可能创建了 `~/SKYKOI`。保留多个工作区目录可能会导致混乱的认证或状态漂移，因为同一时间只有一个工作区是活动的。
 
-**建议：** 保持单个活动工作区。如果你不再使用额外的文件夹，请归档或移至废纸篓（例如 `trash ~/SkyKoi`）。
+**建议：** 保持单个活动工作区。如果你不再使用额外的文件夹，请归档或移至废纸篓（例如 `trash ~/SKYKOI`）。
 如果你有意保留多个工作区，请确保 `agents.defaults.workspace` 指向活动的那个。
 
-`SkyKoi doctor` 在检测到额外工作区目录时会发出警告。
+`SKYKOI doctor` 在检测到额外工作区目录时会发出警告。
 
 ## 工作区文件映射（每个文件的含义）
 
-这些是 SkyKoi 在工作区内期望的标准文件：
+这些是 SKYKOI 在工作区内期望的标准文件：
 
 - `AGENTS.md`
   - 智能体的操作指南以及它应该如何使用记忆。
@@ -110,17 +110,17 @@ x-i18n:
 - `canvas/`（可选）
   - 用于节点显示的 Canvas UI 文件（例如 `canvas/index.html`）。
 
-如果任何引导文件缺失，SkyKoi 会在会话中注入"缺失文件"标记并继续。大型引导文件在注入时会被截断；使用 `agents.defaults.bootstrapMaxChars` 调整限制（默认：20000）。
-`SkyKoi setup` 可以重新创建缺失的默认值而不覆盖现有文件。
+如果任何引导文件缺失，SKYKOI 会在会话中注入"缺失文件"标记并继续。大型引导文件在注入时会被截断；使用 `agents.defaults.bootstrapMaxChars` 调整限制（默认：20000）。
+`SKYKOI setup` 可以重新创建缺失的默认值而不覆盖现有文件。
 
 ## 工作区中不包含的内容
 
-这些位于 `~/.skykoi/` 下，不应提交到工作区仓库：
+这些位于 `~/.SKYKOI/` 下，不应提交到工作区仓库：
 
-- `~/.skykoi/skykoi.json`（配置）
-- `~/.skykoi/credentials/`（OAuth token、API 密钥）
-- `~/.skykoi/agents/<agentId>/sessions/`（会话记录 + 元数据）
-- `~/.skykoi/skills/`（托管的 Skills）
+- `~/.SKYKOI/SKYKOI.json`（配置）
+- `~/.SKYKOI/credentials/`（OAuth token、API 密钥）
+- `~/.SKYKOI/agents/<agentId>/sessions/`（会话记录 + 元数据）
+- `~/.SKYKOI/skills/`（托管的 Skills）
 
 如果你需要迁移会话或配置，请单独复制它们并将它们排除在版本控制之外。
 
@@ -135,7 +135,7 @@ x-i18n:
 如果安装了 git，全新工作区会自动初始化。如果此工作区还不是仓库，请运行：
 
 ```bash
-cd ~/.skykoi/workspace
+cd ~/.SKYKOI/workspace
 git init
 git add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/
 git commit -m "Add agent workspace"
@@ -160,7 +160,7 @@ git push -u origin main
 
 ```bash
 gh auth login
-gh repo create SkyKoi-workspace --private --source . --remote origin --push
+gh repo create SKYKOI-workspace --private --source . --remote origin --push
 ```
 
 选项 C：GitLab 网页界面
@@ -190,10 +190,10 @@ git push
 即使在私有仓库中，也要避免在工作区中存储密钥：
 
 - API 密钥、OAuth token、密码或私有凭证。
-- `~/.skykoi/` 下的任何内容。
+- `~/.SKYKOI/` 下的任何内容。
 - 聊天的原始转储或敏感附件。
 
-如果你必须存储敏感引用，请使用占位符并将真正的密钥保存在其他地方（密码管理器、环境变量或 `~/.skykoi/`）。
+如果你必须存储敏感引用，请使用占位符并将真正的密钥保存在其他地方（密码管理器、环境变量或 `~/.SKYKOI/`）。
 
 建议的 `.gitignore` 起始配置：
 
@@ -207,10 +207,10 @@ git push
 
 ## 将工作区迁移到新机器
 
-1. 将仓库克隆到所需路径（默认 `~/.skykoi/workspace`）。
-2. 在 `~/.skykoi/skykoi.json` 中将 `agents.defaults.workspace` 设置为该路径。
-3. 运行 `SkyKoi setup --workspace <path>` 来填充任何缺失的文件。
-4. 如果你需要会话，请单独从旧机器复制 `~/.skykoi/agents/<agentId>/sessions/`。
+1. 将仓库克隆到所需路径（默认 `~/.SKYKOI/workspace`）。
+2. 在 `~/.SKYKOI/SKYKOI.json` 中将 `agents.defaults.workspace` 设置为该路径。
+3. 运行 `SKYKOI setup --workspace <path>` 来填充任何缺失的文件。
+4. 如果你需要会话，请单独从旧机器复制 `~/.SKYKOI/agents/<agentId>/sessions/`。
 
 ## 高级注意事项
 

package/docs/zh-CN/concepts/agent.md

@@ -14,13 +14,13 @@ x-i18n:
 
 # 智能体运行时 🤖
 
-SkyKoi 运行一个源自 **pi-mono** 的嵌入式智能体运行时。
+SKYKOI 运行一个源自 **pi-mono** 的嵌入式智能体运行时。
 
 ## 工作区（必需）
 
-SkyKoi 使用单一智能体工作区目录（`agents.defaults.workspace`）作为智能体**唯一**的工作目录（`cwd`），用于工具和上下文。
+SKYKOI 使用单一智能体工作区目录（`agents.defaults.workspace`）作为智能体**唯一**的工作目录（`cwd`），用于工具和上下文。
 
-建议：使用 `SkyKoi setup` 在缺失时创建 `~/.skykoi/skykoi.json` 并初始化工作区文件。
+建议：使用 `SKYKOI setup` 在缺失时创建 `~/.SKYKOI/SKYKOI.json` 并初始化工作区文件。
 
 完整工作区布局 + 备份指南：[智能体工作区](/concepts/agent-workspace)
 
@@ -28,7 +28,7 @@ SkyKoi 使用单一智能体工作区目录（`agents.defaults.workspace`）作
 
 ## 引导文件（注入）
 
-在 `agents.defaults.workspace` 内，SkyKoi 期望以下用户可编辑的文件：
+在 `agents.defaults.workspace` 内，SKYKOI 期望以下用户可编辑的文件：
 
 - `AGENTS.md` — 操作指令 + "记忆"
 - `SOUL.md` — 人设、边界、语气
@@ -37,11 +37,11 @@ SkyKoi 使用单一智能体工作区目录（`agents.defaults.workspace`）作
 - `IDENTITY.md` — 智能体名称/风格/表情
 - `USER.md` — 用户档案 + 偏好称呼
 
-在新会话的第一轮，SkyKoi 将这些文件的内容直接注入智能体上下文。
+在新会话的第一轮，SKYKOI 将这些文件的内容直接注入智能体上下文。
 
 空文件会被跳过。大文件会被修剪和截断并添加标记，以保持提示词精简（阅读文件获取完整内容）。
 
-如果文件缺失，SkyKoi 会注入一行"文件缺失"标记（`SkyKoi setup` 将创建安全的默认模板）。
+如果文件缺失，SKYKOI 会注入一行"文件缺失"标记（`SKYKOI setup` 将创建安全的默认模板）。
 
 `BOOTSTRAP.md` 仅在**全新工作区**（没有其他引导文件存在）时创建。如果你在完成仪式后删除它，后续重启不应重新创建。
 
@@ -57,17 +57,17 @@ SkyKoi 使用单一智能体工作区目录（`agents.defaults.workspace`）作
 
 ## Skills
 
-SkyKoi 从三个位置加载 Skills（名称冲突时工作区优先）：
+SKYKOI 从三个位置加载 Skills（名称冲突时工作区优先）：
 
 - 内置（随安装包提供）
-- 托管/本地：`~/.skykoi/skills`
+- 托管/本地：`~/.SKYKOI/skills`
 - 工作区：`<workspace>/skills`
 
 Skills 可通过配置/环境变量控制（参见 [Gateway 网关配置](/gateway/configuration) 中的 `skills`）。
 
 ## pi-mono 集成
 
-SkyKoi 复用 pi-mono 代码库的部分内容（模型/工具），但**会话管理、设备发现和工具连接由 SkyKoi 负责**。
+SKYKOI 复用 pi-mono 代码库的部分内容（模型/工具），但**会话管理、设备发现和工具连接由 SKYKOI 负责**。
 
 - 无 pi-coding 智能体运行时。
 - 不读取 `~/.pi/agent` 或 `<workspace>/.pi` 设置。
@@ -76,9 +76,9 @@ SkyKoi 复用 pi-mono 代码库的部分内容（模型/工具），但**会话
 
 会话记录以 JSONL 格式存储在：
 
-- `~/.skykoi/agents/<agentId>/sessions/<SessionId>.jsonl`
+- `~/.SKYKOI/agents/<agentId>/sessions/<SessionId>.jsonl`
 
-会话 ID 是稳定的，由 SkyKoi 选择。
+会话 ID 是稳定的，由 SKYKOI 选择。
 **不**读取旧版 Pi/Tau 会话文件夹。
 
 ## 流式传输中的引导
@@ -101,7 +101,7 @@ SkyKoi 复用 pi-mono 代码库的部分内容（模型/工具），但**会话
 
 - 配置模型时使用 `provider/model`。
 - 如果模型 ID 本身包含 `/`（OpenRouter 风格），请包含提供商前缀（例如：`openrouter/moonshotai/kimi-k2`）。
-- 如果省略提供商，SkyKoi 将输入视为别名或**默认提供商**的模型（仅在模型 ID 中没有 `/` 时有效）。
+- 如果省略提供商，SKYKOI 将输入视为别名或**默认提供商**的模型（仅在模型 ID 中没有 `/` 时有效）。
 
 ## 配置（最小）
 

package/docs/zh-CN/concepts/architecture.md

@@ -112,7 +112,7 @@ Client                    Gateway
 
 ## 操作快照
 
-- 启动：`SkyKoi gateway`（前台，日志输出到 stdout）。
+- 启动：`SKYKOI gateway`（前台，日志输出到 stdout）。
 - 健康检查：通过 WS 的 `health`（也包含在 `hello-ok` 中）。
 - 监控：使用 launchd/systemd 自动重启。