skykoi 2026.3.11 → 2026.3.13

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

@@ -2,7 +2,7 @@
 read_when:
   - 你想了解自动压缩和 /compact
   - 你正在调试长会话触及上下文限制的问题
-summary: 上下文窗口 + 压缩：SkyKoi 如何将会话保持在模型限制内
+summary: 上下文窗口 + 压缩：SKYKOI 如何将会话保持在模型限制内
 title: 压缩
 x-i18n:
   generated_at: "2026-02-01T20:22:17Z"
@@ -15,7 +15,7 @@ x-i18n:
 
 # 上下文窗口与压缩
 
-每个模型都有一个**上下文窗口**（可见的最大 token 数）。长时间运行的对话会累积消息和工具结果；一旦窗口空间紧张，SkyKoi 会**压缩**较早的历史记录以保持在限制范围内。
+每个模型都有一个**上下文窗口**（可见的最大 token 数）。长时间运行的对话会累积消息和工具结果；一旦窗口空间紧张，SKYKOI 会**压缩**较早的历史记录以保持在限制范围内。
 
 ## 什么是压缩
 
@@ -32,14 +32,14 @@ x-i18n:
 
 ## 自动压缩（默认开启）
 
-当会话接近或超过模型的上下文窗口时，SkyKoi 会触发自动压缩，并可能使用压缩后的上下文重试原始请求。
+当会话接近或超过模型的上下文窗口时，SKYKOI 会触发自动压缩，并可能使用压缩后的上下文重试原始请求。
 
 你会看到：
 
 - 详细模式下显示 `🧹 Auto-compaction complete`
 - `/status` 显示 `🧹 Compactions: <count>`
 
-在压缩之前，SkyKoi 可以运行一次**静默记忆刷写**轮次，将持久化笔记写入磁盘。详情及配置请参阅[记忆](/concepts/memory)。
+在压缩之前，SKYKOI 可以运行一次**静默记忆刷写**轮次，将持久化笔记写入磁盘。详情及配置请参阅[记忆](/concepts/memory)。
 
 ## 手动压缩
 
@@ -51,7 +51,7 @@ x-i18n:
 
 ## 上下文窗口来源
 
-上下文窗口因模型而异。SkyKoi 使用已配置提供商目录中的模型定义来确定限制。
+上下文窗口因模型而异。SKYKOI 使用已配置提供商目录中的模型定义来确定限制。
 
 ## 压缩与修剪
 

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

@@ -1,6 +1,6 @@
 ---
 read_when:
-  - 你想了解 SkyKoi 中"上下文"的含义
+  - 你想了解 SKYKOI 中"上下文"的含义
   - 你在调试为什么模型"知道"某些内容（或忘记了）
   - 你想减少上下文开销（/context、/status、/compact）
 summary: 上下文：模型看到的内容、如何构建以及如何检查
@@ -16,11 +16,11 @@ x-i18n:
 
 # 上下文
 
-"上下文"是 **SkyKoi 在一次运行中发送给模型的所有内容**。它受模型的**上下文窗口**（token 限制）约束。
+"上下文"是 **SKYKOI 在一次运行中发送给模型的所有内容**。它受模型的**上下文窗口**（token 限制）约束。
 
 新手心智模型：
 
-- **系统提示词**（SkyKoi 构建）：规则、工具、Skills 列表、时间/运行时，以及注入的工作区文件。
+- **系统提示词**（SKYKOI 构建）：规则、工具、Skills 列表、时间/运行时，以及注入的工作区文件。
 - **对话历史**：你的消息 + 助手在此会话中的消息。
 - **工具调用/结果 + 附件**：命令输出、文件读取、图片/音频等。
 
@@ -94,9 +94,9 @@ Top tools (schema size):
 - 压缩摘要和修剪产物。
 - 提供商"包装器"或隐藏头部（不可见，仍然计数）。
 
-## SkyKoi 如何构建系统提示词
+## SKYKOI 如何构建系统提示词
 
-系统提示词由 **SkyKoi 拥有**，每次运行时重建。它包括：
+系统提示词由 **SKYKOI 拥有**，每次运行时重建。它包括：
 
 - 工具列表 + 简短描述。
 - Skills 列表（仅元数据；见下文）。
@@ -109,7 +109,7 @@ Top tools (schema size):
 
 ## 注入的工作区文件（项目上下文）
 
-默认情况下，SkyKoi 注入一组固定的工作区文件（如果存在）：
+默认情况下，SKYKOI 注入一组固定的工作区文件（如果存在）：
 
 - `AGENTS.md`
 - `SOUL.md`

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

@@ -1,7 +1,7 @@
 ---
 read_when:
-  - 你想了解 SkyKoi 支持的完整功能列表
-summary: SkyKoi 在渠道、路由、媒体和用户体验方面的功能。
+  - 你想了解 SKYKOI 支持的完整功能列表
+summary: SKYKOI 在渠道、路由、媒体和用户体验方面的功能。
 title: 功能
 x-i18n:
   generated_at: "2026-02-04T17:53:22Z"

package/docs/zh-CN/concepts/markdown-formatting.md

@@ -16,7 +16,7 @@ x-i18n:
 
 # Markdown 格式化
 
-SkyKoi 通过将出站 Markdown 转换为共享的中间表示（IR），然后再渲染为特定渠道的输出来进行格式化。IR 保留源文本不变，同时携带样式/链接跨度信息，使分块和渲染在各渠道间保持一致。
+SKYKOI 通过将出站 Markdown 转换为共享的中间表示（IR），然后再渲染为特定渠道的输出来进行格式化。IR 保留源文本不变，同时携带样式/链接跨度信息，使分块和渲染在各渠道间保持一致。
 
 ## 目标
 
@@ -43,7 +43,7 @@ SkyKoi 通过将出站 Markdown 转换为共享的中间表示（IR），然后
 输入 Markdown：
 
 ```markdown
-Hello **world** — see [docs](https://docs.skykoi.com).
+Hello **world** — see [docs](https://docs.SKYKOI.com).
 ```
 
 IR（示意）：
@@ -52,7 +52,7 @@ IR（示意）：
 {
   "text": "Hello world — see docs.",
   "styles": [{ "start": 6, "end": 11, "style": "bold" }],
-  "links": [{ "start": 19, "end": 23, "href": "https://docs.skykoi.com" }]
+  "links": [{ "start": 19, "end": 23, "href": "https://docs.SKYKOI.com" }]
 }
 ```
 

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

@@ -2,7 +2,7 @@
 read_when:
   - 你想了解记忆文件布局和工作流程
   - 你想调整自动压缩前的记忆刷新
-summary: SkyKoi 记忆的工作原理（工作空间文件 + 自动记忆刷新）
+summary: SKYKOI 记忆的工作原理（工作空间文件 + 自动记忆刷新）
 title: 记忆
 x-i18n:
   generated_at: "2026-02-03T07:47:38Z"
@@ -15,7 +15,7 @@ x-i18n:
 
 # 记忆
 
-SkyKoi 记忆是**智能体工作空间中的纯 Markdown 文件**。这些文件是唯一的事实来源；模型只"记住"写入磁盘的内容。
+SKYKOI 记忆是**智能体工作空间中的纯 Markdown 文件**。这些文件是唯一的事实来源；模型只"记住"写入磁盘的内容。
 
 记忆搜索工具由活动的记忆插件提供（默认：`memory-core`）。使用 `plugins.slots.memory = "none"` 禁用记忆插件。
 
@@ -30,7 +30,7 @@ SkyKoi 记忆是**智能体工作空间中的纯 Markdown 文件**。这些文
   - 精心整理的长期记忆。
   - **仅在主要的私人会话中加载**（绝不在群组上下文中加载）。
 
-这些文件位于工作空间下（`agents.defaults.workspace`，默认 `~/.skykoi/workspace`）。完整布局参见[智能体工作空间](/concepts/agent-workspace)。
+这些文件位于工作空间下（`agents.defaults.workspace`，默认 `~/.SKYKOI/workspace`）。完整布局参见[智能体工作空间](/concepts/agent-workspace)。
 
 ## 何时写入记忆
 
@@ -42,7 +42,7 @@ SkyKoi 记忆是**智能体工作空间中的纯 Markdown 文件**。这些文
 
 ## 自动记忆刷新（压缩前触发）
 
-当会话**接近自动压缩**时，SkyKoi 会触发一个**静默的智能体回合**，提醒模型在上下文被压缩**之前**写入持久记忆。默认提示明确说明模型*可以回复*，但通常 `NO_REPLY` 是正确的响应，因此用户永远不会看到这个回合。
+当会话**接近自动压缩**时，SKYKOI 会触发一个**静默的智能体回合**，提醒模型在上下文被压缩**之前**写入持久记忆。默认提示明确说明模型*可以回复*，但通常 `NO_REPLY` 是正确的响应，因此用户永远不会看到这个回合。
 
 这由 `agents.defaults.compaction.memoryFlush` 控制：
 
@@ -76,13 +76,13 @@ SkyKoi 记忆是**智能体工作空间中的纯 Markdown 文件**。这些文
 
 ## 向量记忆搜索
 
-SkyKoi 可以在 `MEMORY.md` 和 `memory/*.md`（以及你选择加入的任何额外目录或文件）上构建小型向量索引，以便语义查询可以找到相关笔记，即使措辞不同。
+SKYKOI 可以在 `MEMORY.md` 和 `memory/*.md`（以及你选择加入的任何额外目录或文件）上构建小型向量索引，以便语义查询可以找到相关笔记，即使措辞不同。
 
 默认值：
 
 - 默认启用。
 - 监视记忆文件的更改（去抖动）。
-- 默认使用远程嵌入。如果未设置 `memorySearch.provider`，SkyKoi 自动选择：
+- 默认使用远程嵌入。如果未设置 `memorySearch.provider`，SKYKOI 自动选择：
   1. 如果配置了 `memorySearch.local.modelPath` 且文件存在，则使用 `local`。
   2. 如果可以解析 OpenAI 密钥，则使用 `openai`。
   3. 如果可以解析 Gemini 密钥，则使用 `gemini`。
@@ -90,7 +90,7 @@ SkyKoi 可以在 `MEMORY.md` 和 `memory/*.md`（以及你选择加入的任何
 - 本地模式使用 node-llama-cpp，可能需要运行 `pnpm approve-builds`。
 - 使用 sqlite-vec（如果可用）在 SQLite 中加速向量搜索。
 
-远程嵌入**需要**嵌入提供商的 API 密钥。SkyKoi 从身份验证配置文件、`models.providers.*.apiKey` 或环境变量解析密钥。Codex OAuth 仅涵盖聊天/补全，**不**满足记忆搜索的嵌入需求。对于 Gemini，使用 `GEMINI_API_KEY` 或 `models.providers.google.apiKey`。使用自定义 OpenAI 兼容端点时，设置 `memorySearch.remote.apiKey`（以及可选的 `memorySearch.remote.headers`）。
+远程嵌入**需要**嵌入提供商的 API 密钥。SKYKOI 从身份验证配置文件、`models.providers.*.apiKey` 或环境变量解析密钥。Codex OAuth 仅涵盖聊天/补全，**不**满足记忆搜索的嵌入需求。对于 Gemini，使用 `GEMINI_API_KEY` 或 `models.providers.google.apiKey`。使用自定义 OpenAI 兼容端点时，设置 `memorySearch.remote.apiKey`（以及可选的 `memorySearch.remote.headers`）。
 
 ### 额外记忆路径
 
@@ -216,18 +216,18 @@ agents: {
 ### 索引内容（及时机）
 
 - 文件类型：仅 Markdown（`MEMORY.md`、`memory/**/*.md`，以及 `memorySearch.extraPaths` 下的任何 `.md` 文件）。
-- 索引存储：每个智能体的 SQLite 位于 `~/.skykoi/memory/<agentId>.sqlite`（可通过 `agents.defaults.memorySearch.store.path` 配置，支持 `{agentId}` 令牌）。
+- 索引存储：每个智能体的 SQLite 位于 `~/.SKYKOI/memory/<agentId>.sqlite`（可通过 `agents.defaults.memorySearch.store.path` 配置，支持 `{agentId}` 令牌）。
 - 新鲜度：监视器监视 `MEMORY.md`、`memory/` 和 `memorySearch.extraPaths`，标记索引为脏（去抖动 1.5 秒）。同步在会话开始时、搜索时或按间隔安排，并异步运行。会话记录使用增量阈值触发后台同步。
-- 重新索引触发器：索引存储嵌入的**提供商/模型 + 端点指纹 + 分块参数**。如果其中任何一个发生变化，SkyKoi 会自动重置并重新索引整个存储。
+- 重新索引触发器：索引存储嵌入的**提供商/模型 + 端点指纹 + 分块参数**。如果其中任何一个发生变化，SKYKOI 会自动重置并重新索引整个存储。
 
 ### 混合搜索（BM25 + 向量）
 
-启用时，SkyKoi 结合：
+启用时，SKYKOI 结合：
 
 - **向量相似度**（语义匹配，措辞可以不同）
 - **BM25 关键词相关性**（精确令牌如 ID、环境变量、代码符号）
 
-如果你的平台上全文搜索不可用，SkyKoi 会回退到纯向量搜索。
+如果你的平台上全文搜索不可用，SKYKOI 会回退到纯向量搜索。
 
 #### 为什么使用混合搜索？
 
@@ -292,7 +292,7 @@ agents: {
 
 ### 嵌入缓存
 
-SkyKoi 可以在 SQLite 中缓存**块嵌入**，这样重新索引和频繁更新（特别是会话记录）不会重新嵌入未更改的文本。
+SKYKOI 可以在 SQLite 中缓存**块嵌入**，这样重新索引和频繁更新（特别是会话记录）不会重新嵌入未更改的文本。
 
 配置：
 
@@ -332,7 +332,7 @@ agents: {
 - `memory_search` 永远不会阻塞索引；在后台同步完成之前，结果可能略有延迟。
 - 结果仍然只包含片段；`memory_get` 仍然仅限于记忆文件。
 - 会话索引按智能体隔离（仅索引该智能体的会话日志）。
-- 会话日志存储在磁盘上（`~/.skykoi/agents/<agentId>/sessions/*.jsonl`）。任何具有文件系统访问权限的进程/用户都可以读取它们，因此将磁盘访问视为信任边界。对于更严格的隔离，在单独的操作系统用户或主机下运行智能体。
+- 会话日志存储在磁盘上（`~/.SKYKOI/agents/<agentId>/sessions/*.jsonl`）。任何具有文件系统访问权限的进程/用户都可以读取它们，因此将磁盘访问视为信任边界。对于更严格的隔离，在单独的操作系统用户或主机下运行智能体。
 
 增量阈值（显示默认值）：
 
@@ -353,7 +353,7 @@ agents: {
 
 ### SQLite 向量加速（sqlite-vec）
 
-当 sqlite-vec 扩展可用时，SkyKoi 将嵌入存储在 SQLite 虚拟表（`vec0`）中，并在数据库中执行向量距离查询。这使搜索保持快速，无需将每个嵌入加载到 JS 中。
+当 sqlite-vec 扩展可用时，SKYKOI 将嵌入存储在 SQLite 虚拟表（`vec0`）中，并在数据库中执行向量距离查询。这使搜索保持快速，无需将每个嵌入加载到 JS 中。
 
 配置（可选）：
 
@@ -375,7 +375,7 @@ agents: {
 说明：
 
 - `enabled` 默认为 true；禁用时，搜索回退到对存储嵌入的进程内余弦相似度计算。
-- 如果 sqlite-vec 扩展缺失或加载失败，SkyKoi 会记录错误并继续使用 JS 回退（无向量表）。
+- 如果 sqlite-vec 扩展缺失或加载失败，SKYKOI 会记录错误并继续使用 JS 回退（无向量表）。
 - `extensionPath` 覆盖捆绑的 sqlite-vec 路径（对于自定义构建或非标准安装位置很有用）。
 
 ### 本地嵌入自动下载

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

@@ -16,7 +16,7 @@ x-i18n:
 
 # 消息
 
-本页汇总了 SkyKoi 如何处理入站消息、会话、队列、流式传输和推理可见性。
+本页汇总了 SKYKOI 如何处理入站消息、会话、队列、流式传输和推理可见性。
 
 ## 消息流程（高层概述）
 
@@ -38,7 +38,7 @@ x-i18n:
 
 ## 入站去重
 
-渠道可能在重新连接后重复投递同一消息。SkyKoi 保持一个短期缓存，以渠道/账户/对端/会话/消息 ID 为键，因此重复投递不会触发另一次智能体运行。
+渠道可能在重新连接后重复投递同一消息。SKYKOI 保持一个短期缓存，以渠道/账户/对端/会话/消息 ID 为键，因此重复投递不会触发另一次智能体运行。
 
 ## 入站防抖
 
@@ -80,7 +80,7 @@ x-i18n:
 
 ## 入站正文和历史上下文
 
-SkyKoi 将**提示正文**与**命令正文**分开：
+SKYKOI 将**提示正文**与**命令正文**分开：
 
 - `Body`：发送给智能体的提示文本。这可能包括渠道信封和可选的历史包装器。
 - `CommandBody`：用于指令/命令解析的原始用户文本。
@@ -123,7 +123,7 @@ SkyKoi 将**提示正文**与**命令正文**分开：
 
 ## 推理可见性和 token
 
-SkyKoi 可以显示或隐藏模型推理：
+SKYKOI 可以显示或隐藏模型推理：
 
 - `/reasoning on|off|stream` 控制可见性。
 - 当模型产生推理内容时，它仍计入 token 使用量。

package/docs/zh-CN/concepts/model-failover.md

@@ -2,7 +2,7 @@
 read_when:
   - 诊断认证配置文件轮换、冷却时间或模型回退行为
   - 更新认证配置文件或模型的故障转移规则
-summary: SkyKoi 如何轮换认证配置文件并在模型之间进行回退
+summary: SKYKOI 如何轮换认证配置文件并在模型之间进行回退
 title: 模型故障转移
 x-i18n:
   generated_at: "2026-02-03T07:46:17Z"
@@ -15,7 +15,7 @@ x-i18n:
 
 # 模型故障转移
 
-SkyKoi 分两个阶段处理故障：
+SKYKOI 分两个阶段处理故障：
 
 1. 在当前提供商内进行**认证配置文件轮换**。
 2. **模型回退**到 `agents.defaults.model.fallbacks` 中的下一个模型。
@@ -24,11 +24,11 @@ SkyKoi 分两个阶段处理故障：
 
 ## 认证存储（密钥 + OAuth）
 
-SkyKoi 对 API 密钥和 OAuth 令牌都使用**认证配置文件**。
+SKYKOI 对 API 密钥和 OAuth 令牌都使用**认证配置文件**。
 
-- 密钥存储在 `~/.skykoi/agents/<agentId>/agent/auth-profiles.json`（旧版：`~/.skykoi/agent/auth-profiles.json`）。
+- 密钥存储在 `~/.SKYKOI/agents/<agentId>/agent/auth-profiles.json`（旧版：`~/.SKYKOI/agent/auth-profiles.json`）。
 - 配置 `auth.profiles` / `auth.order` **仅用于元数据和路由**（不含密钥）。
-- 旧版仅导入 OAuth 文件：`~/.skykoi/credentials/oauth.json`（首次使用时导入到 `auth-profiles.json`）。
+- 旧版仅导入 OAuth 文件：`~/.SKYKOI/credentials/oauth.json`（首次使用时导入到 `auth-profiles.json`）。
 
 更多详情：[/concepts/oauth](/concepts/oauth)
 
@@ -44,17 +44,17 @@ OAuth 登录创建不同的配置文件，以便多个账户可以共存。
 - 默认：当没有电子邮件可用时为 `provider:default`。
 - 带电子邮件的 OAuth：`provider:<email>`（例如 `google-antigravity:user@gmail.com`）。
 
-配置文件存储在 `~/.skykoi/agents/<agentId>/agent/auth-profiles.json` 的 `profiles` 下。
+配置文件存储在 `~/.SKYKOI/agents/<agentId>/agent/auth-profiles.json` 的 `profiles` 下。
 
 ## 轮换顺序
 
-当一个提供商有多个配置文件时，SkyKoi 按以下顺序选择：
+当一个提供商有多个配置文件时，SKYKOI 按以下顺序选择：
 
 1. **显式配置**：`auth.order[provider]`（如果设置）。
 2. **已配置的配置文件**：按提供商过滤的 `auth.profiles`。
 3. **已存储的配置文件**：`auth-profiles.json` 中该提供商的条目。
 
-如果没有配置显式顺序，SkyKoi 使用轮询顺序：
+如果没有配置显式顺序，SKYKOI 使用轮询顺序：
 
 - **主键：** 配置文件类型（**OAuth 优先于 API 密钥**）。
 - **次键：** `usageStats.lastUsed`（每种类型中最旧的优先）。
@@ -62,7 +62,7 @@ OAuth 登录创建不同的配置文件，以便多个账户可以共存。
 
 ### 会话粘性（缓存友好）
 
-SkyKoi **为每个会话固定所选的认证配置文件**以保持提供商缓存热度。它**不会**在每个请求时轮换。固定的配置文件会被重用直到：
+SKYKOI **为每个会话固定所选的认证配置文件**以保持提供商缓存热度。它**不会**在每个请求时轮换。固定的配置文件会被重用直到：
 
 - 会话被重置（`/new` / `/reset`）
 - 压缩完成（压缩计数递增）
@@ -70,7 +70,7 @@ SkyKoi **为每个会话固定所选的认证配置文件**以保持提供商缓
 
 通过 `/model …@<profileId>` 手动选择会为该会话设置**用户覆盖**，在新会话开始之前不会自动轮换。
 
-自动固定的配置文件（由会话路由器选择）被视为**偏好**：它们会优先尝试，但 SkyKoi 可能在速率限制/超时时轮换到另一个配置文件。用户固定的配置文件会锁定到该配置文件；如果失败且配置了模型回退，SkyKoi 会移动到下一个模型而不是切换配置文件。
+自动固定的配置文件（由会话路由器选择）被视为**偏好**：它们会优先尝试，但 SKYKOI 可能在速率限制/超时时轮换到另一个配置文件。用户固定的配置文件会锁定到该配置文件；如果失败且配置了模型回退，SKYKOI 会移动到下一个模型而不是切换配置文件。
 
 ### 为什么 OAuth 可能"看起来丢失"
 
@@ -81,7 +81,7 @@ SkyKoi **为每个会话固定所选的认证配置文件**以保持提供商缓
 
 ## 冷却时间
 
-当配置文件因认证/速率限制错误（或看起来像速率限制的超时）而失败时，SkyKoi 将其标记为冷却状态并移动到下一个配置文件。格式/无效请求错误（例如 Cloud Code Assist 工具调用 ID 验证失败）被视为值得故障转移的情况，使用相同的冷却时间。
+当配置文件因认证/速率限制错误（或看起来像速率限制的超时）而失败时，SKYKOI 将其标记为冷却状态并移动到下一个配置文件。格式/无效请求错误（例如 Cloud Code Assist 工具调用 ID 验证失败）被视为值得故障转移的情况，使用相同的冷却时间。
 
 冷却时间使用指数退避：
 
@@ -106,7 +106,7 @@ SkyKoi **为每个会话固定所选的认证配置文件**以保持提供商缓
 
 ## 账单禁用
 
-账单/额度失败（例如"insufficient credits"/"credit balance too low"）被视为值得故障转移的情况，但它们通常不是暂时性的。SkyKoi 不使用短冷却时间，而是将配置文件标记为**禁用**（使用更长的退避时间）并轮换到下一个配置文件/提供商。
+账单/额度失败（例如"insufficient credits"/"credit balance too low"）被视为值得故障转移的情况，但它们通常不是暂时性的。SKYKOI 不使用短冷却时间，而是将配置文件标记为**禁用**（使用更长的退避时间）并轮换到下一个配置文件/提供商。
 
 状态存储在 `auth-profiles.json` 中：
 
@@ -128,7 +128,7 @@ SkyKoi **为每个会话固定所选的认证配置文件**以保持提供商缓
 
 ## 模型回退
 
-如果某个提供商的所有配置文件都失败，SkyKoi 会移动到 `agents.defaults.model.fallbacks` 中的下一个模型。这适用于认证失败、速率限制和耗尽配置文件轮换的超时（其他错误不会推进回退）。
+如果某个提供商的所有配置文件都失败，SKYKOI 会移动到 `agents.defaults.model.fallbacks` 中的下一个模型。这适用于认证失败、速率限制和耗尽配置文件轮换的超时（其他错误不会推进回退）。
 
 当运行以模型覆盖（钩子或 CLI）开始时，在尝试任何配置的回退之后，回退仍会在 `agents.defaults.model.primary` 处结束。
 

package/docs/zh-CN/concepts/model-providers.md

@@ -22,18 +22,18 @@ x-i18n:
 
 - 模型引用使用 `provider/model` 格式（例如：`opencode/claude-opus-4-5`）。
 - 如果设置了 `agents.defaults.models`，它将成为允许列表。
-- CLI 辅助工具：`SkyKoi onboard`、`SkyKoi models list`、`SkyKoi models set <provider/model>`。
+- CLI 辅助工具：`SKYKOI onboard`、`SKYKOI models list`、`SKYKOI models set <provider/model>`。
 
 ## 内置提供商（pi-ai 目录）
 
-SkyKoi 附带 pi-ai 目录。这些提供商**不需要** `models.providers` 配置；只需设置认证 + 选择模型。
+SKYKOI 附带 pi-ai 目录。这些提供商**不需要** `models.providers` 配置；只需设置认证 + 选择模型。
 
 ### OpenAI
 
 - 提供商：`openai`
 - 认证：`OPENAI_API_KEY`
 - 示例模型：`openai/gpt-5.2`
-- CLI：`SkyKoi onboard --auth-choice openai-api-key`
+- CLI：`SKYKOI onboard --auth-choice openai-api-key`
 
 ```json5
 {
@@ -46,7 +46,7 @@ SkyKoi 附带 pi-ai 目录。这些提供商**不需要** `models.providers` 配
 - 提供商：`anthropic`
 - 认证：`ANTHROPIC_API_KEY` 或 `claude setup-token`
 - 示例模型：`anthropic/claude-opus-4-5`
-- CLI：`SkyKoi onboard --auth-choice token`（粘贴 setup-token）或 `SkyKoi models auth paste-token --provider anthropic`
+- CLI：`SKYKOI onboard --auth-choice token`（粘贴 setup-token）或 `SKYKOI models auth paste-token --provider anthropic`
 
 ```json5
 {
@@ -59,7 +59,7 @@ SkyKoi 附带 pi-ai 目录。这些提供商**不需要** `models.providers` 配
 - 提供商：`openai-codex`
 - 认证：OAuth (ChatGPT)
 - 示例模型：`openai-codex/gpt-5.2`
-- CLI：`SkyKoi onboard --auth-choice openai-codex` 或 `SkyKoi models auth login --provider openai-codex`
+- CLI：`SKYKOI onboard --auth-choice openai-codex` 或 `SKYKOI models auth login --provider openai-codex`
 
 ```json5
 {
@@ -72,7 +72,7 @@ SkyKoi 附带 pi-ai 目录。这些提供商**不需要** `models.providers` 配
 - 提供商：`opencode`
 - 认证：`OPENCODE_API_KEY`（或 `OPENCODE_ZEN_API_KEY`）
 - 示例模型：`opencode/claude-opus-4-5`
-- CLI：`SkyKoi onboard --auth-choice opencode-zen`
+- CLI：`SKYKOI onboard --auth-choice opencode-zen`
 
 ```json5
 {
@@ -85,26 +85,26 @@ SkyKoi 附带 pi-ai 目录。这些提供商**不需要** `models.providers` 配
 - 提供商：`google`
 - 认证：`GEMINI_API_KEY`
 - 示例模型：`google/gemini-3-pro-preview`
-- CLI：`SkyKoi onboard --auth-choice gemini-api-key`
+- CLI：`SKYKOI onboard --auth-choice gemini-api-key`
 
 ### Google Vertex、Antigravity 和 Gemini CLI
 
 - 提供商：`google-vertex`、`google-antigravity`、`google-gemini-cli`
 - 认证：Vertex 使用 gcloud ADC；Antigravity/Gemini CLI 使用各自的认证流程
 - Antigravity OAuth 作为捆绑插件提供（`google-antigravity-auth`，默认禁用）。
-  - 启用：`SkyKoi plugins enable google-antigravity-auth`
-  - 登录：`SkyKoi models auth login --provider google-antigravity --set-default`
+  - 启用：`SKYKOI plugins enable google-antigravity-auth`
+  - 登录：`SKYKOI models auth login --provider google-antigravity --set-default`
 - Gemini CLI OAuth 作为捆绑插件提供（`google-gemini-cli-auth`，默认禁用）。
-  - 启用：`SkyKoi plugins enable google-gemini-cli-auth`
-  - 登录：`SkyKoi models auth login --provider google-gemini-cli --set-default`
-  - 注意：你**不需要**将客户端 ID 或密钥粘贴到 `skykoi.json` 中。CLI 登录流程将令牌存储在 Gateway 网关主机的认证配置文件中。
+  - 启用：`SKYKOI plugins enable google-gemini-cli-auth`
+  - 登录：`SKYKOI models auth login --provider google-gemini-cli --set-default`
+  - 注意：你**不需要**将客户端 ID 或密钥粘贴到 `SKYKOI.json` 中。CLI 登录流程将令牌存储在 Gateway 网关主机的认证配置文件中。
 
 ### Z.AI (GLM)
 
 - 提供商：`zai`
 - 认证：`ZAI_API_KEY`
 - 示例模型：`zai/glm-4.7`
-- CLI：`SkyKoi onboard --auth-choice zai-api-key`
+- CLI：`SKYKOI onboard --auth-choice zai-api-key`
   - 别名：`z.ai/*` 和 `z-ai/*` 规范化为 `zai/*`
 
 ### Vercel AI Gateway
@@ -112,7 +112,7 @@ SkyKoi 附带 pi-ai 目录。这些提供商**不需要** `models.providers` 配
 - 提供商：`vercel-ai-gateway`
 - 认证：`AI_GATEWAY_API_KEY`
 - 示例模型：`vercel-ai-gateway/anthropic/claude-opus-4.5`
-- CLI：`SkyKoi onboard --auth-choice ai-gateway-api-key`
+- CLI：`SKYKOI onboard --auth-choice ai-gateway-api-key`
 
 ### 其他内置提供商
 
@@ -191,8 +191,8 @@ Qwen 通过设备码流程提供对 Qwen Coder + Vision 的 OAuth 访问。
 启用捆绑插件，然后登录：
 
 ```bash
-SkyKoi plugins enable qwen-portal-auth
-SkyKoi models auth login --provider qwen-portal --set-default
+SKYKOI plugins enable qwen-portal-auth
+SKYKOI models auth login --provider qwen-portal --set-default
 ```
 
 模型引用：
@@ -209,7 +209,7 @@ Synthetic 通过 `synthetic` 提供商提供 Anthropic 兼容模型：
 - 提供商：`synthetic`
 - 认证：`SYNTHETIC_API_KEY`
 - 示例模型：`synthetic/hf:MiniMaxAI/MiniMax-M2.1`
-- CLI：`SkyKoi onboard --auth-choice synthetic-api-key`
+- CLI：`SKYKOI onboard --auth-choice synthetic-api-key`
 
 ```json5
 {
@@ -301,7 +301,7 @@ ollama pull llama3.3
 注意事项：
 
 - 对于自定义提供商，`reasoning`、`input`、`cost`、`contextWindow` 和 `maxTokens` 是可选的。
-  省略时，SkyKoi 默认为：
+  省略时，SKYKOI 默认为：
   - `reasoning: false`
   - `input: ["text"]`
   - `cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }`
@@ -312,9 +312,9 @@ ollama pull llama3.3
 ## CLI 示例
 
 ```bash
-SkyKoi onboard --auth-choice opencode-zen
-SkyKoi models set opencode/claude-opus-4-5
-SkyKoi models list
+SKYKOI onboard --auth-choice opencode-zen
+SKYKOI models set opencode/claude-opus-4-5
+SKYKOI models list
 ```
 
 另请参阅：[/gateway/configuration](/gateway/configuration) 了解完整配置示例。

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

@@ -21,7 +21,7 @@ x-i18n:
 
 ## 模型选择工作原理
 
-SkyKoi 按以下顺序选择模型：
+SKYKOI 按以下顺序选择模型：
 
 1. **主要**模型（`agents.defaults.model.primary` 或 `agents.defaults.model`）。
 2. `agents.defaults.model.fallbacks` 中的**回退**（按顺序）。
@@ -29,7 +29,7 @@ SkyKoi 按以下顺序选择模型：
 
 相关：
 
-- `agents.defaults.models` 是 SkyKoi 可使用的模型白名单/目录（加上别名）。
+- `agents.defaults.models` 是 SKYKOI 可使用的模型白名单/目录（加上别名）。
 - `agents.defaults.imageModel` **仅在**主要模型无法接受图像时使用。
 - 每个智能体的默认值可以通过 `agents.list[].model` 加绑定覆盖 `agents.defaults.model`（参见 [/concepts/multi-agent](/concepts/multi-agent)）。
 
@@ -43,7 +43,7 @@ SkyKoi 按以下顺序选择模型：
 如果你不想手动编辑配置，请运行新手引导向导：
 
 ```bash
-SkyKoi onboard
+SKYKOI onboard
 ```
 
 它可以为常见提供商设置模型 + 认证，包括 **OpenAI Code（Codex）订阅**（OAuth）和 **Anthropic**（推荐使用 API 密钥；也支持 `claude setup-token`）。
@@ -61,7 +61,7 @@ SkyKoi onboard
 
 ## "Model is not allowed"（以及为什么回复停止）
 
-如果设置了 `agents.defaults.models`，它将成为 `/model` 和会话覆盖的**白名单**。当用户选择不在该白名单中的模型时，SkyKoi 返回：
+如果设置了 `agents.defaults.models`，它将成为 `/model` 和会话覆盖的**白名单**。当用户选择不在该白名单中的模型时，SKYKOI 返回：
 
 ```
 Model "provider/model" is not allowed. Use /model to list available models.
@@ -106,34 +106,34 @@ Model "provider/model" is not allowed. Use /model to list available models.
 - `/model status` 是详细视图（认证候选项，以及配置时的提供商端点 `baseUrl` + `api` 模式）。
 - 模型引用通过在**第一个** `/` 处分割来解析。输入 `/model <ref>` 时使用 `provider/model`。
 - 如果模型 ID 本身包含 `/`（OpenRouter 风格），你必须包含提供商前缀（例如：`/model openrouter/moonshotai/kimi-k2`）。
-- 如果省略提供商，SkyKoi 将输入视为别名或**默认提供商**的模型（仅在模型 ID 中没有 `/` 时有效）。
+- 如果省略提供商，SKYKOI 将输入视为别名或**默认提供商**的模型（仅在模型 ID 中没有 `/` 时有效）。
 
 完整命令行为/配置：[斜杠命令](/tools/slash-commands)。
 
 ## CLI 命令
 
 ```bash
-SkyKoi models list
-SkyKoi models status
-SkyKoi models set <provider/model>
-SkyKoi models set-image <provider/model>
-
-SkyKoi models aliases list
-SkyKoi models aliases add <alias> <provider/model>
-SkyKoi models aliases remove <alias>
-
-SkyKoi models fallbacks list
-SkyKoi models fallbacks add <provider/model>
-SkyKoi models fallbacks remove <provider/model>
-SkyKoi models fallbacks clear
-
-SkyKoi models image-fallbacks list
-SkyKoi models image-fallbacks add <provider/model>
-SkyKoi models image-fallbacks remove <provider/model>
-SkyKoi models image-fallbacks clear
+SKYKOI models list
+SKYKOI models status
+SKYKOI models set <provider/model>
+SKYKOI models set-image <provider/model>
+
+SKYKOI models aliases list
+SKYKOI models aliases add <alias> <provider/model>
+SKYKOI models aliases remove <alias>
+
+SKYKOI models fallbacks list
+SKYKOI models fallbacks add <provider/model>
+SKYKOI models fallbacks remove <provider/model>
+SKYKOI models fallbacks clear
+
+SKYKOI models image-fallbacks list
+SKYKOI models image-fallbacks add <provider/model>
+SKYKOI models image-fallbacks remove <provider/model>
+SKYKOI models image-fallbacks clear
 ```
 
-`SkyKoi models`（无子命令）是 `models status` 的快捷方式。
+`SKYKOI models`（无子命令）是 `models status` 的快捷方式。
 
 ### `models list`
 
@@ -156,12 +156,12 @@ JSON 包括 `auth.oauth`（警告窗口 + 配置文件）和 `auth.providers`（
 
 ```bash
 claude setup-token
-SkyKoi models status
+SKYKOI models status
 ```
 
 ## 扫描（OpenRouter 免费模型）
 
-`SkyKoi models scan` 检查 OpenRouter 的**免费模型目录**，并可选择性地探测模型的工具和图像支持。
+`SKYKOI models scan` 检查 OpenRouter 的**免费模型目录**，并可选择性地探测模型的工具和图像支持。
 
 关键标志：
 
@@ -193,4 +193,4 @@ SkyKoi models status
 
 ## 模型注册表（`models.json`）
 
-`models.providers` 中的自定义提供商会写入智能体目录下的 `models.json`（默认 `~/.skykoi/agents/<agentId>/models.json`）。除非 `models.mode` 设置为 `replace`，否则此文件默认会被合并。
+`models.providers` 中的自定义提供商会写入智能体目录下的 `models.json`（默认 `~/.SKYKOI/agents/<agentId>/models.json`）。除非 `models.mode` 设置为 `replace`，否则此文件默认会被合并。