skykoi 2026.3.11 → 2026.3.13

package/docs/zh-CN/automation/auth-monitoring.md

@@ -15,12 +15,12 @@ x-i18n:
 
 # 认证监控
 
-SkyKoi 通过 `SkyKoi models status` 提供 OAuth 过期健康状态。请使用该命令进行自动化和告警；脚本是为手机工作流程提供的可选附加功能。
+SKYKOI 通过 `SKYKOI models status` 提供 OAuth 过期健康状态。请使用该命令进行自动化和告警；脚本是为手机工作流程提供的可选附加功能。
 
 ## 推荐方式：CLI 检查（可移植）
 
 ```bash
-SkyKoi models status --check
+SKYKOI models status --check
 ```
 
 退出码：
@@ -35,13 +35,13 @@ SkyKoi models status --check
 
 这些脚本位于 `scripts/` 目录下，属于**可选**内容。它们假定你可以通过 SSH 访问 Gateway 网关主机，并针对 systemd + Termux 进行了调优。
 
-- `scripts/claude-auth-status.sh` 现在使用 `SkyKoi models status --json` 作为数据来源（如果 CLI 不可用则回退到直接读取文件），因此请确保 `SkyKoi` 在定时器的 `PATH` 中。
+- `scripts/claude-auth-status.sh` 现在使用 `SKYKOI models status --json` 作为数据来源（如果 CLI 不可用则回退到直接读取文件），因此请确保 `SKYKOI` 在定时器的 `PATH` 中。
 - `scripts/auth-monitor.sh`：cron/systemd 定时器目标；发送告警（ntfy 或手机）。
-- `scripts/systemd/SkyKoi-auth-monitor.{service,timer}`：systemd 用户定时器。
-- `scripts/claude-auth-status.sh`：Claude Code + SkyKoi 认证检查器（完整/json/简洁模式）。
+- `scripts/systemd/SKYKOI-auth-monitor.{service,timer}`：systemd 用户定时器。
+- `scripts/claude-auth-status.sh`：Claude Code + SKYKOI 认证检查器（完整/json/简洁模式）。
 - `scripts/mobile-reauth.sh`：通过 SSH 引导的重新认证流程。
 - `scripts/termux-quick-auth.sh`：一键小部件状态查看 + 打开认证 URL。
 - `scripts/termux-auth-widget.sh`：完整的引导式小部件流程。
-- `scripts/termux-sync-widget.sh`：同步 Claude Code 凭证 → SkyKoi。
+- `scripts/termux-sync-widget.sh`：同步 Claude Code 凭证 → SKYKOI。
 
 如果你不需要手机自动化或 systemd 定时器，可以跳过这些脚本。

package/docs/zh-CN/automation/cron-jobs.md

@@ -25,7 +25,7 @@ x-i18n:
 ## 简要概述
 
 - 定时任务运行在 **Gateway网关内部**（而非模型内部）。
-- 任务持久化存储在 `~/.skykoi/cron/` 下，因此重启不会丢失计划。
+- 任务持久化存储在 `~/.SKYKOI/cron/` 下，因此重启不会丢失计划。
 - 两种执行方式：
   - **主会话**：入队一个系统事件，然后在下一次心跳时运行。
   - **隔离式**：在 `cron:<jobId>` 中运行专用智能体轮次，可投递摘要（默认 announce）或不投递。
@@ -36,7 +36,7 @@ x-i18n:
 创建一个一次性提醒，验证其存在，然后立即运行：
 
 ```bash
-SkyKoi cron add \
+SKYKOI cron add \
   --name "Reminder" \
   --at "2026-02-01T16:00:00Z" \
   --session main \
@@ -44,15 +44,15 @@ SkyKoi cron add \
   --wake now \
   --delete-after-run
 
-SkyKoi cron list
-SkyKoi cron run <job-id> --force
-SkyKoi cron runs --id <job-id>
+SKYKOI cron list
+SKYKOI cron run <job-id> --force
+SKYKOI cron runs --id <job-id>
 ```
 
 调度一个带投递功能的周期性隔离任务：
 
 ```bash
-SkyKoi cron add \
+SKYKOI cron add \
   --name "Morning brief" \
   --cron "0 7 * * *" \
   --tz "America/Los_Angeles" \
@@ -69,7 +69,7 @@ SkyKoi cron add \
 
 ## 定时任务的存储位置
 
-定时任务默认持久化存储在 Gateway网关主机的 `~/.skykoi/cron/jobs.json` 中。Gateway网关将文件加载到内存中，并在更改时写回，因此仅在 Gateway网关停止时手动编辑才是安全的。请优先使用 `SkyKoi cron add/edit` 或定时任务工具调用 API 进行更改。
+定时任务默认持久化存储在 Gateway网关主机的 `~/.SKYKOI/cron/jobs.json` 中。Gateway网关将文件加载到内存中，并在更改时写回，因此仅在 Gateway网关停止时手动编辑才是安全的。请优先使用 `SKYKOI cron add/edit` 或定时任务工具调用 API 进行更改。
 
 ## 新手友好概述
 
@@ -276,8 +276,8 @@ Telegram 通过 `message_thread_id` 支持论坛主题。对于定时任务投
 
 ## 存储与历史
 
-- 任务存储：`~/.skykoi/cron/jobs.json`（Gateway网关管理的 JSON）。
-- 运行历史：`~/.skykoi/cron/runs/<jobId>.jsonl`（JSONL，自动清理）。
+- 任务存储：`~/.SKYKOI/cron/jobs.json`（Gateway网关管理的 JSON）。
+- 运行历史：`~/.SKYKOI/cron/runs/<jobId>.jsonl`（JSONL，自动清理）。
 - 覆盖存储路径：配置中的 `cron.store`。
 
 ## 配置
@@ -286,7 +286,7 @@ Telegram 通过 `message_thread_id` 支持论坛主题。对于定时任务投
 {
   cron: {
     enabled: true, // 默认 true
-    store: "~/.skykoi/cron/jobs.json",
+    store: "~/.SKYKOI/cron/jobs.json",
     maxConcurrentRuns: 1, // 默认 1
   },
 }
@@ -302,7 +302,7 @@ Telegram 通过 `message_thread_id` 支持论坛主题。对于定时任务投
 一次性提醒（UTC ISO，成功后自动删除）：
 
 ```bash
-SkyKoi cron add \
+SKYKOI cron add \
   --name "Send reminder" \
   --at "2026-01-12T18:00:00Z" \
   --session main \
@@ -314,7 +314,7 @@ SkyKoi cron add \
 一次性提醒（主会话，立即唤醒）：
 
 ```bash
-SkyKoi cron add \
+SKYKOI cron add \
   --name "Calendar check" \
   --at "20m" \
   --session main \
@@ -325,7 +325,7 @@ SkyKoi cron add \
 周期性隔离任务（投递到 WhatsApp）：
 
 ```bash
-SkyKoi cron add \
+SKYKOI cron add \
   --name "Morning status" \
   --cron "0 7 * * *" \
   --tz "America/Los_Angeles" \
@@ -339,7 +339,7 @@ SkyKoi cron add \
 周期性隔离任务（投递到 Telegram 主题）：
 
 ```bash
-SkyKoi cron add \
+SKYKOI cron add \
   --name "Nightly summary (topic)" \
   --cron "0 22 * * *" \
   --tz "America/Los_Angeles" \
@@ -353,7 +353,7 @@ SkyKoi cron add \
 带模型和思维覆盖的隔离任务：
 
 ```bash
-SkyKoi cron add \
+SKYKOI cron add \
   --name "Deep analysis" \
   --cron "0 6 * * 1" \
   --tz "America/Los_Angeles" \
@@ -370,23 +370,23 @@ SkyKoi cron add \
 
 ```bash
 # 将任务绑定到智能体 "ops"（如果该智能体不存在则回退到默认智能体）
-SkyKoi cron add --name "Ops sweep" --cron "0 6 * * *" --session isolated --message "Check ops queue" --agent ops
+SKYKOI cron add --name "Ops sweep" --cron "0 6 * * *" --session isolated --message "Check ops queue" --agent ops
 
 # 切换或清除现有任务的智能体
-SkyKoi cron edit <jobId> --agent ops
-SkyKoi cron edit <jobId> --clear-agent
+SKYKOI cron edit <jobId> --agent ops
+SKYKOI cron edit <jobId> --clear-agent
 ```
 
 手动运行（调试）：
 
 ```bash
-SkyKoi cron run <jobId> --force
+SKYKOI cron run <jobId> --force
 ```
 
 编辑现有任务（补丁字段）：
 
 ```bash
-SkyKoi cron edit <jobId> \
+SKYKOI cron edit <jobId> \
   --message "Updated prompt" \
   --model "opus" \
   --thinking low
@@ -395,20 +395,20 @@ SkyKoi cron edit <jobId> \
 运行历史：
 
 ```bash
-SkyKoi cron runs --id <jobId> --limit 50
+SKYKOI cron runs --id <jobId> --limit 50
 ```
 
 不创建任务直接发送系统事件：
 
 ```bash
-SkyKoi system event --mode now --text "Next heartbeat: check battery."
+SKYKOI system event --mode now --text "Next heartbeat: check battery."
 ```
 
 ## Gateway网关 API 接口
 
 - `cron.list`、`cron.status`、`cron.add`、`cron.update`、`cron.remove`
 - `cron.run`（强制或到期）、`cron.runs`
-  如需不创建任务直接发送系统事件，请使用 [`SkyKoi system event`](/cli/system)。
+  如需不创建任务直接发送系统事件，请使用 [`SKYKOI system event`](/cli/system)。
 
 ## 故障排除
 

package/docs/zh-CN/automation/cron-vs-heartbeat.md

@@ -104,7 +104,7 @@ x-i18n:
 ### 定时任务示例：每日早间简报
 
 ```bash
-SkyKoi cron add \
+SKYKOI cron add \
   --name "Morning briefing" \
   --cron "0 7 * * *" \
   --tz "America/New_York" \
@@ -121,7 +121,7 @@ SkyKoi cron add \
 ### 定时任务示例：一次性提醒
 
 ```bash
-SkyKoi cron add \
+SKYKOI cron add \
   --name "Meeting reminder" \
   --at "20m" \
   --session main \
@@ -180,13 +180,13 @@ SkyKoi cron add \
 
 ```bash
 # 每天早上 7 点的早间简报
-SkyKoi cron add --name "Morning brief" --cron "0 7 * * *" --session isolated --message "..." --announce
+SKYKOI cron add --name "Morning brief" --cron "0 7 * * *" --session isolated --message "..." --announce
 
 # 每周一上午 9 点的项目回顾
-SkyKoi cron add --name "Weekly review" --cron "0 9 * * 1" --session isolated --message "..." --model opus
+SKYKOI cron add --name "Weekly review" --cron "0 9 * * 1" --session isolated --message "..." --model opus
 
 # 一次性提醒
-SkyKoi cron add --name "Call back" --at "2h" --session main --system-event "Call back the client" --wake now
+SKYKOI cron add --name "Call back" --at "2h" --session main --system-event "Call back the client" --wake now
 ```
 
 ## Lobster：带审批的确定性工作流
@@ -236,7 +236,7 @@ Lobster 是用于**多步骤工具管道**的工作流运行时，适用于需
 - 不需要单独的隔离运行
 
 ```bash
-SkyKoi cron add \
+SKYKOI cron add \
   --name "Check project" \
   --every "4h" \
   --session main \
@@ -254,7 +254,7 @@ SkyKoi cron add \
 - 不会把主会话搞得杂乱的历史记录
 
 ```bash
-SkyKoi cron add \
+SKYKOI cron add \
   --name "Deep analysis" \
   --cron "0 6 * * 0" \
   --session isolated \

package/docs/zh-CN/automation/gmail-pubsub.md

@@ -1,8 +1,8 @@
 ---
 read_when:
-  - 将 Gmail 收件箱触发器接入 SkyKoi
+  - 将 Gmail 收件箱触发器接入 SKYKOI
   - 为智能体唤醒设置 Pub/Sub 推送
-summary: 通过 gogcli 将 Gmail Pub/Sub 推送接入 SkyKoi webhooks
+summary: 通过 gogcli 将 Gmail Pub/Sub 推送接入 SKYKOI webhooks
 title: Gmail PubSub
 x-i18n:
   generated_at: "2026-02-03T07:43:25Z"
@@ -13,15 +13,15 @@ x-i18n:
   workflow: 15
 ---
 
-# Gmail Pub/Sub -> SkyKoi
+# Gmail Pub/Sub -> SKYKOI
 
-目标：Gmail watch -> Pub/Sub 推送 -> `gog gmail watch serve` -> SkyKoi webhook。
+目标：Gmail watch -> Pub/Sub 推送 -> `gog gmail watch serve` -> SKYKOI webhook。
 
 ## 前置条件
 
 - 已安装并登录 `gcloud`（[安装指南](https://docs.cloud.google.com/sdk/docs/install-sdk)）。
 - 已安装 `gog` (gogcli) 并为 Gmail 账户授权（[gogcli.sh](https://gogcli.sh/)）。
-- 已启用 SkyKoi hooks（参见 [Webhooks](/automation/webhook)）。
+- 已启用 SKYKOI hooks（参见 [Webhooks](/automation/webhook)）。
 - 已登录 `tailscale`（[tailscale.com](https://tailscale.com/)）。支持的设置使用 Tailscale Funnel 作为公共 HTTPS 端点。
   其他隧道服务也可以使用，但需要自行配置/不受支持，需要手动接入。
   目前，我们支持的是 Tailscale。
@@ -32,7 +32,7 @@ x-i18n:
 {
   hooks: {
     enabled: true,
-    token: "SkyKoi_HOOK_TOKEN",
+    token: "SKYKOI_HOOK_TOKEN",
     path: "/hooks",
     presets: ["gmail"],
   },
@@ -45,7 +45,7 @@ x-i18n:
 {
   hooks: {
     enabled: true,
-    token: "SkyKoi_HOOK_TOKEN",
+    token: "SKYKOI_HOOK_TOKEN",
     presets: ["gmail"],
     mappings: [
       {
@@ -94,20 +94,20 @@ x-i18n:
 
 ## 向导（推荐）
 
-使用 SkyKoi 助手将所有内容接入在一起（在 macOS 上通过 brew 安装依赖）：
+使用 SKYKOI 助手将所有内容接入在一起（在 macOS 上通过 brew 安装依赖）：
 
 ```bash
-SkyKoi webhooks gmail setup \
-  --account SkyKoi@gmail.com
+SKYKOI webhooks gmail setup \
+  --account SKYKOI@gmail.com
 ```
 
 默认设置：
 
 - 使用 Tailscale Funnel 作为公共推送端点。
-- 为 `skykoi webhooks gmail run` 写入 `hooks.gmail` 配置。
+- 为 `SKYKOI webhooks gmail run` 写入 `hooks.gmail` 配置。
 - 启用 Gmail hook 预设（`hooks.presets: ["gmail"]`）。
 
-路径说明：当启用 `tailscale.mode` 时，SkyKoi 会自动将 `hooks.gmail.serve.path` 设置为 `/`，并将公共路径保持在 `hooks.gmail.tailscale.path`（默认 `/gmail-pubsub`），因为 Tailscale 在代理之前会剥离设置的路径前缀。
+路径说明：当启用 `tailscale.mode` 时，SKYKOI 会自动将 `hooks.gmail.serve.path` 设置为 `/`，并将公共路径保持在 `hooks.gmail.tailscale.path`（默认 `/gmail-pubsub`），因为 Tailscale 在代理之前会剥离设置的路径前缀。
 如果你需要后端接收带前缀的路径，请将 `hooks.gmail.tailscale.target`（或 `--tailscale-target`）设置为完整 URL，如 `http://127.0.0.1:8788/gmail-pubsub`，并匹配 `hooks.gmail.serve.path`。
 
 想要自定义端点？使用 `--push-endpoint <url>` 或 `--tailscale off`。
@@ -117,13 +117,13 @@ SkyKoi webhooks gmail setup \
 Gateway 网关自动启动（推荐）：
 
 - 当 `hooks.enabled=true` 且设置了 `hooks.gmail.account` 时，Gateway 网关会在启动时运行 `gog gmail watch serve` 并自动续期 watch。
-- 设置 `SkyKoi_SKIP_GMAIL_WATCHER=1` 可退出（如果你自己运行守护进程则很有用）。
+- 设置 `SKYKOI_SKIP_GMAIL_WATCHER=1` 可退出（如果你自己运行守护进程则很有用）。
 - 不要同时运行手动守护进程，否则会遇到 `listen tcp 127.0.0.1:8788: bind: address already in use`。
 
 手动守护进程（启动 `gog gmail watch serve` + 自动续期）：
 
 ```bash
-SkyKoi webhooks gmail run
+SKYKOI webhooks gmail run
 ```
 
 ## 一次性设置
@@ -161,7 +161,7 @@ gcloud pubsub topics add-iam-policy-binding gog-gmail-watch \
 
 ```bash
 gog gmail watch start \
-  --account SkyKoi@gmail.com \
+  --account SKYKOI@gmail.com \
   --label INBOX \
   --topic projects/<project-id>/topics/gog-gmail-watch
 ```
@@ -174,13 +174,13 @@ gog gmail watch start \
 
 ```bash
 gog gmail watch serve \
-  --account SkyKoi@gmail.com \
+  --account SKYKOI@gmail.com \
   --bind 127.0.0.1 \
   --port 8788 \
   --path /gmail-pubsub \
   --token <shared> \
   --hook-url http://127.0.0.1:18789/hooks/gmail \
-  --hook-token SkyKoi_HOOK_TOKEN \
+  --hook-token SKYKOI_HOOK_TOKEN \
   --include-body \
   --max-bytes 20000
 ```
@@ -188,10 +188,10 @@ gog gmail watch serve \
 注意事项：
 
 - `--token` 保护推送端点（`x-gog-token` 或 `?token=`）。
-- `--hook-url` 指向 SkyKoi `/hooks/gmail`（已映射；隔离运行 + 摘要发送到主线程）。
-- `--include-body` 和 `--max-bytes` 控制发送到 SkyKoi 的正文片段。
+- `--hook-url` 指向 SKYKOI `/hooks/gmail`（已映射；隔离运行 + 摘要发送到主线程）。
+- `--include-body` 和 `--max-bytes` 控制发送到 SKYKOI 的正文片段。
 
-推荐：`skykoi webhooks gmail run` 封装了相同的流程并自动续期 watch。
+推荐：`SKYKOI webhooks gmail run` 封装了相同的流程并自动续期 watch。
 
 ## 暴露处理程序（高级，不受支持）
 
@@ -221,8 +221,8 @@ gog gmail watch serve --verify-oidc --oidc-email <svc@...>
 
 ```bash
 gog gmail send \
-  --account SkyKoi@gmail.com \
-  --to SkyKoi@gmail.com \
+  --account SKYKOI@gmail.com \
+  --to SKYKOI@gmail.com \
   --subject "watch test" \
   --body "ping"
 ```
@@ -230,8 +230,8 @@ gog gmail send \
 检查 watch 状态和历史记录：
 
 ```bash
-gog gmail watch status --account SkyKoi@gmail.com
-gog gmail history --account SkyKoi@gmail.com --since <historyId>
+gog gmail watch status --account SKYKOI@gmail.com
+gog gmail history --account SKYKOI@gmail.com --since <historyId>
 ```
 
 ## 故障排除
@@ -243,7 +243,7 @@ gog gmail history --account SkyKoi@gmail.com --since <historyId>
 ## 清理
 
 ```bash
-gog gmail watch stop --account SkyKoi@gmail.com
+gog gmail watch stop --account SKYKOI@gmail.com
 gcloud pubsub subscriptions delete gog-gmail-watch-push
 gcloud pubsub topics delete gog-gmail-watch
 ```