@symerian/symi 3.0.20 → 3.0.22

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

@@ -1,24 +0,0 @@
----
-read_when:
-  - 你想在保留 CLI 安装的同时清除本地状态
-  - 你想预览哪些内容会被移除
-summary: "`symi reset`（重置本地状态/配置）的 CLI 参考"
-title: reset
-x-i18n:
-  generated_at: "2026-02-01T20:21:22Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 08afed5830f892e07d6e2e167f09aaf2d79fd5b2ba2a26a65dca857ebdbf873c
-  source_path: cli/reset.md
-  workflow: 14
----
-
-# `symi reset`
-
-重置本地配置/状态（保留 CLI 安装）。
-
-```bash
-symi reset
-symi reset --dry-run
-symi reset --scope config+creds+sessions --yes --non-interactive
-```

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

@@ -1,158 +0,0 @@
----
-read_when: You are managing sandbox containers or debugging sandbox/tool-policy behavior.
-status: active
-summary: 管理沙箱容器并检查生效的沙箱策略
-title: 沙箱 CLI
-x-i18n:
-  generated_at: "2026-02-03T07:45:18Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 6e1186f26c77e188206ce5e198ab624d6b38bc7bb7c06e4d2281b6935c39e347
-  source_path: cli/sandbox.md
-  workflow: 15
----
-
-# 沙箱 CLI
-
-管理基于 Docker 的沙箱容器，用于隔离智能体执行。
-
-## 概述
-
-Symi 可以在隔离的 Docker 容器中运行智能体以确保安全。`sandbox` 命令帮助你管理这些容器，特别是在更新或配置更改后。
-
-## 命令
-
-### `symi sandbox explain`
-
-检查**生效的**沙箱模式/作用域/工作区访问权限、沙箱工具策略和提权门控（附带修复配置的键路径）。
-
-```bash
-symi sandbox explain
-symi sandbox explain --session agent:main:main
-symi sandbox explain --agent work
-symi sandbox explain --json
-```
-
-### `symi sandbox list`
-
-列出所有沙箱容器及其状态和配置。
-
-```bash
-symi sandbox list
-symi sandbox list --browser  # List only browser containers
-symi sandbox list --json     # JSON output
-```
-
-**输出包括：**
-
-- 容器名称和状态（运行中/已停止）
-- Docker 镜像及其是否与配置匹配
-- 创建时间
-- 空闲时间（自上次使用以来的时间）
-- 关联的会话/智能体
-
-### `symi sandbox recreate`
-
-移除沙箱容器以强制使用更新的镜像/配置重新创建。
-
-```bash
-symi sandbox recreate --all                # Recreate all containers
-symi sandbox recreate --session main       # Specific session
-symi sandbox recreate --agent mybot        # Specific agent
-symi sandbox recreate --browser            # Only browser containers
-symi sandbox recreate --all --force        # Skip confirmation
-```
-
-**选项：**
-
-- `--all`：重新创建所有沙箱容器
-- `--session <key>`：重新创建特定会话的容器
-- `--agent <id>`：重新创建特定智能体的容器
-- `--browser`：仅重新创建浏览器容器
-- `--force`：跳过确认提示
-
-**重要：** 容器会在智能体下次使用时自动重新创建。
-
-## 使用场景
-
-### 更新 Docker 镜像后
-
-```bash
-# Pull new image
-docker pull symi-sandbox:latest
-docker tag symi-sandbox:latest symi-sandbox:bookworm-slim
-
-# Update config to use new image
-# Edit config: agents.defaults.sandbox.docker.image (or agents.list[].sandbox.docker.image)
-
-# Recreate containers
-symi sandbox recreate --all
-```
-
-### 更改沙箱配置后
-
-```bash
-# Edit config: agents.defaults.sandbox.* (or agents.list[].sandbox.*)
-
-# Recreate to apply new config
-symi sandbox recreate --all
-```
-
-### 更改 setupCommand 后
-
-```bash
-symi sandbox recreate --all
-# or just one agent:
-symi sandbox recreate --agent family
-```
-
-### 仅针对特定智能体
-
-```bash
-# Update only one agent's containers
-symi sandbox recreate --agent alfred
-```
-
-## 为什么需要这个？
-
-**问题：** 当你更新沙箱 Docker 镜像或配置时：
-
-- 现有容器继续使用旧设置运行
-- 容器仅在空闲 24 小时后才被清理
-- 经常使用的智能体会无限期保持旧容器运行
-
-**解决方案：** 使用 `symi sandbox recreate` 强制移除旧容器。它们会在下次需要时自动使用当前设置重新创建。
-
-提示：优先使用 `symi sandbox recreate` 而不是手动 `docker rm`。它使用 Gateway 网关的容器命名规则，避免在作用域/会话键更改时出现不匹配。
-
-## 配置
-
-沙箱设置位于 `~/.symi/symi.json` 的 `agents.defaults.sandbox` 下（每个智能体的覆盖设置在 `agents.list[].sandbox` 中）：
-
-```jsonc
-{
-  "agents": {
-    "defaults": {
-      "sandbox": {
-        "mode": "all", // off, non-main, all
-        "scope": "agent", // session, agent, shared
-        "docker": {
-          "image": "symi-sandbox:bookworm-slim",
-          "containerPrefix": "symi-sbx-",
-          // ... more Docker options
-        },
-        "prune": {
-          "idleHours": 24, // Auto-prune after 24h idle
-          "maxAgeDays": 7, // Auto-prune after 7 days
-        },
-      },
-    },
-  },
-}
-```
-
-## 另请参阅
-
-- [沙箱文档](/gateway/sandboxing)
-- [智能体配置](/concepts/agent-workspace)
-- [Doctor 命令](/gateway/doctor) - 检查沙箱设置

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

@@ -1,33 +0,0 @@
----
-read_when:
-  - 你想对配置/状态运行快速安全审计
-  - 你想应用安全的"修复"建议（chmod、收紧默认值）
-summary: "`symi security` 的 CLI 参考（审计和修复常见安全隐患）"
-title: security
-x-i18n:
-  generated_at: "2026-02-03T07:45:13Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 19705b0fff848fa6f302b4ed09b7660c64e09048dba517c7f6a833d2db40bebf
-  source_path: cli/security.md
-  workflow: 15
----
-
-# `symi security`
-
-安全工具（审计 + 可选修复）。
-
-相关：
-
-- 安全指南：[安全](/gateway/security)
-
-## 审计
-
-```bash
-symi security audit
-symi security audit --deep
-symi security audit --fix
-```
-
-当多个私信发送者共享主会话时，审计会发出警告，并建议对共享收件箱使用 `session.dmScope="per-channel-peer"`（或多账户渠道使用 `per-account-channel-peer`）。
-当使用小模型（`<=300B`）且未启用沙箱隔离但启用了 web/browser 工具时，它也会发出警告。

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

@@ -1,23 +0,0 @@
----
-read_when:
-  - 你想列出已存储的会话并查看近期活动
-summary: "`symi sessions`（列出已存储的会话及使用情况）的 CLI 参考"
-title: sessions
-x-i18n:
-  generated_at: "2026-02-01T20:21:25Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: d8866ef166c0dea5e8d691bb62171298694935ae0771a46fada537774dadfb32
-  source_path: cli/sessions.md
-  workflow: 14
----
-
-# `symi sessions`
-
-列出已存储的对话会话。
-
-```bash
-symi sessions
-symi sessions --active 120
-symi sessions --json
-```

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

@@ -1,36 +0,0 @@
----
-read_when:
-  - 你在不使用完整新手引导向导的情况下进行首次设置
-  - 你想设置默认工作区路径
-summary: "`symi setup` 的 CLI 参考（初始化配置 + 工作区）"
-title: setup
-x-i18n:
-  generated_at: "2026-02-01T20:21:26Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 7f3fc8b246924edf48501785be2c0d356bd31bfbb133e75a139a5ee41dbf57f4
-  source_path: cli/setup.md
-  workflow: 14
----
-
-# `symi setup`
-
-初始化 `~/.symi/symi.json` 和智能体工作区。
-
-相关内容：
-
-- 快速开始：[快速开始](/start/getting-started)
-- 向导：[新手引导](/start/onboarding)
-
-## 示例
-
-```bash
-symi setup
-symi setup --workspace ~/.symi/workspace
-```
-
-通过 setup 运行向导：
-
-```bash
-symi setup --wizard
-```

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

@@ -1,33 +0,0 @@
----
-read_when:
-  - 你想查看哪些 Skills 可用并准备好运行
-  - 你想调试 Skills 缺少的二进制文件/环境变量/配置
-summary: "`symi skills` 的 CLI 参考（列出/信息/检查）和 skill 资格"
-title: skills
-x-i18n:
-  generated_at: "2026-02-03T07:45:14Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 7878442c88a27ec8033f3125c319e9a6a85a1c497a404a06112ad45185c261b0
-  source_path: cli/skills.md
-  workflow: 15
----
-
-# `symi skills`
-
-检查 Skills（内置 + 工作区 + 托管覆盖）并查看哪些符合条件，哪些缺少要求。
-
-相关内容：
-
-- Skills 系统：[Skills](/tools/skills)
-- Skills 配置：[Skills 配置](/tools/skills-config)
-- SymiHub 安装：[SymiHub](/tools/symihub)
-
-## 命令
-
-```bash
-symi skills list
-symi skills list --eligible
-symi skills info <name>
-symi skills check
-```

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

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

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

@@ -1,63 +0,0 @@
----
-read_when:
-  - 你想在不创建 cron 作业的情况下入队系统事件
-  - 你需要启用或禁用心跳
-  - 你想检查系统在线状态条目
-summary: "`symi system` 的 CLI 参考（系统事件、心跳、在线状态）"
-title: system
-x-i18n:
-  generated_at: "2026-02-03T07:45:23Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 36ae5dbdec327f5a32f7ef44bdc1f161bad69868de62f5071bb4d25a71bfdfe9
-  source_path: cli/system.md
-  workflow: 15
----
-
-# `symi system`
-
-Gateway 网关的系统级辅助工具：入队系统事件、控制心跳和查看在线状态。
-
-## 常用命令
-
-```bash
-symi system event --text "Check for urgent follow-ups" --mode now
-symi system heartbeat enable
-symi system heartbeat last
-symi system presence
-```
-
-## `system event`
-
-在**主**会话上入队系统事件。下一次心跳会将其作为 `System:` 行注入到提示中。使用 `--mode now` 立即触发心跳；`next-heartbeat` 等待下一个计划的心跳时刻。
-
-标志：
-
-- `--text <text>`：必填的系统事件文本。
-- `--mode <mode>`：`now` 或 `next-heartbeat`（默认）。
-- `--json`：机器可读输出。
-
-## `system heartbeat last|enable|disable`
-
-心跳控制：
-
-- `last`：显示最后一次心跳事件。
-- `enable`：重新开启心跳（如果之前被禁用，使用此命令）。
-- `disable`：暂停心跳。
-
-标志：
-
-- `--json`：机器可读输出。
-
-## `system presence`
-
-列出 Gateway 网关已知的当前系统在线状态条目（节点、实例和类似状态行）。
-
-标志：
-
-- `--json`：机器可读输出。
-
-## 注意
-
-- 需要一个运行中的 Gateway 网关，可通过你当前的配置访问（本地或远程）。
-- 系统事件是临时的，不会在重启后持久化。

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

@@ -1,30 +0,0 @@
----
-read_when:
-  - 你想要一个连接 Gateway 网关的终端 UI（支持远程）
-  - 你想从脚本传递 url/token/session
-summary: "`symi tui` 的 CLI 参考（连接到 Gateway 网关的终端 UI）"
-title: tui
-x-i18n:
-  generated_at: "2026-02-03T07:45:20Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: f0a97d92e08746a9d6a4f31d361ccad9aea4c3dc61cfafb310d88715f61cfb64
-  source_path: cli/tui.md
-  workflow: 15
----
-
-# `symi tui`
-
-打开连接到 Gateway 网关的终端 UI。
-
-相关：
-
-- TUI 指南：[TUI](/web/tui)
-
-## 示例
-
-```bash
-symi tui
-symi tui --url ws://127.0.0.1:18789 --token <token>
-symi tui --session main --deliver
-```

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

@@ -1,24 +0,0 @@
----
-read_when:
-  - 你想移除 Gateway 网关服务和/或本地状态
-  - 你想先进行试运行
-summary: "`symi uninstall` 的 CLI 参考（移除 Gateway 网关服务 + 本地数据）"
-title: uninstall
-x-i18n:
-  generated_at: "2026-02-03T10:04:23Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 8d6c3890923f18f95c12b76443d649a6b404934ebd054fb86a9fa1abae843fe4
-  source_path: cli/uninstall.md
-  workflow: 15
----
-
-# `symi uninstall`
-
-卸载 Gateway 网关服务 + 本地数据（CLI 保留）。
-
-```bash
-symi uninstall
-symi uninstall --all --yes
-symi uninstall --dry-run
-```

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

@@ -1,101 +0,0 @@
----
-read_when:
-  - 你想安全地更新源码检出
-  - 你需要了解 `--update` 简写行为
-summary: "`symi update` 的 CLI 参考（相对安全的源码更新 + Gateway 网关自动重启）"
-title: update
-x-i18n:
-  generated_at: "2026-02-03T07:45:34Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 3a08e8ac797612c498eef54ecb83e61c9a1ee5de09162a01dbb4b3bd72897206
-  source_path: cli/update.md
-  workflow: 15
----
-
-# `symi update`
-
-安全更新 Symi 并在 stable/beta/dev 渠道之间切换。
-
-如果你通过 **npm/pnpm** 安装（全局安装，无 git 元数据），更新通过 [更新](/install/updating) 中的包管理器流程进行。
-
-## 用法
-
-```bash
-symi update
-symi update status
-symi update wizard
-symi update --channel beta
-symi update --channel dev
-symi update --tag beta
-symi update --no-restart
-symi update --json
-symi --update
-```
-
-## 选项
-
-- `--no-restart`：成功更新后跳过重启 Gateway 网关服务。
-- `--channel <stable|beta|dev>`：设置更新渠道（git + npm；持久化到配置中）。
-- `--tag <dist-tag|version>`：仅为本次更新覆盖 npm dist-tag 或版本。
-- `--json`：打印机器可读的 `UpdateRunResult` JSON。
-- `--timeout <seconds>`：每步超时时间（默认 1200 秒）。
-
-注意：降级需要确认，因为旧版本可能会破坏配置。
-
-## `update status`
-
-显示当前更新渠道 + git 标签/分支/SHA（对于源码检出），以及更新可用性。
-
-```bash
-symi update status
-symi update status --json
-symi update status --timeout 10
-```
-
-选项：
-
-- `--json`：打印机器可读的状态 JSON。
-- `--timeout <seconds>`：检查超时时间（默认 3 秒）。
-
-## `update wizard`
-
-交互式流程，用于选择更新渠道并确认是否在更新后重启 Gateway 网关（默认重启）。如果你选择 `dev` 但没有 git 检出，它会提供创建一个的选项。
-
-## 工作原理
-
-当你显式切换渠道（`--channel ...`）时，Symi 也会保持安装方式一致：
-
-- `dev` → 确保存在 git 检出（默认：`~/symi`，可通过 `SYMI_GIT_DIR` 覆盖），更新它，并从该检出安装全局 CLI。
-- `stable`/`beta` → 使用匹配的 dist-tag 从 npm 安装。
-
-## Git 检出流程
-
-渠道：
-
-- `stable`：检出最新的非 beta 标签，然后构建 + doctor。
-- `beta`：检出最新的 `-beta` 标签，然后构建 + doctor。
-- `dev`：检出 `main`，然后 fetch + rebase。
-
-高层概述：
-
-1. 需要干净的工作树（无未提交的更改）。
-2. 切换到所选渠道（标签或分支）。
-3. 获取上游（仅 dev）。
-4. 仅 dev：在临时工作树中预检 lint + TypeScript 构建；如果最新提交失败，回退最多 10 个提交以找到最新的干净构建。
-5. Rebase 到所选提交（仅 dev）。
-6. 安装依赖（优先使用 pnpm；npm 作为备选）。
-7. 构建 + 构建控制界面。
-8. 运行 `symi doctor` 作为最终的"安全更新"检查。
-9. 将插件同步到当前渠道（dev 使用捆绑的扩展；stable/beta 使用 npm）并更新 npm 安装的插件。
-
-## `--update` 简写
-
-`symi --update` 会重写为 `symi update`（便于 shell 和启动脚本使用）。
-
-## 另请参阅
-
-- `symi doctor`（在 git 检出上会提供先运行更新的选项）
-- [开发渠道](/install/development-channels)
-- [更新](/install/updating)
-- [CLI 参考](/cli)

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

@@ -1,41 +0,0 @@
----
-read_when:
-  - 使用语音通话插件并想了解 CLI 入口
-  - 想要 `voicecall call|continue|status|tail|expose` 的快速示例
-summary: 语音通话插件命令的 `symi voicecall` CLI 参考
-title: voicecall
-x-i18n:
-  generated_at: "2026-02-01T20:21:37Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: d93aaee6f6f5c9ac468d8d2905cb23f0f2db75809408cb305c055505be9936f2
-  source_path: cli/voicecall.md
-  workflow: 14
----
-
-# `symi voicecall`
-
-`voicecall` 是一个由插件提供的命令。只有在安装并启用了语音通话插件时才会出现。
-
-主要文档：
-
-- 语音通话插件：[语音通话](/plugins/voice-call)
-
-## 常用命令
-
-```bash
-symi voicecall status --call-id <id>
-symi voicecall call --to "+15555550123" --message "Hello" --mode notify
-symi voicecall continue --call-id <id> --message "Any questions?"
-symi voicecall end --call-id <id>
-```
-
-## 暴露 Webhook（Tailscale）
-
-```bash
-symi voicecall expose --mode serve
-symi voicecall expose --mode funnel
-symi voicecall unexpose
-```
-
-安全提示：仅将 webhook 端点暴露给你信任的网络。尽可能优先使用 Tailscale Serve 而非 Funnel。

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

@@ -1,32 +0,0 @@
----
-read_when:
-  - 你想将 Gmail Pub/Sub 事件接入 Symi
-  - 你需要 Webhook 辅助命令
-summary: "`symi webhooks`（Webhook 辅助工具 + Gmail Pub/Sub）的 CLI 参考"
-title: webhooks
-x-i18n:
-  generated_at: "2026-02-01T20:21:38Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 785ec62afe6631b340ce4a4541ceb34cd6b97704cf7a9889762cb4c1f29a5ca0
-  source_path: cli/webhooks.md
-  workflow: 14
----
-
-# `symi webhooks`
-
-Webhook 辅助工具和集成（Gmail Pub/Sub、Webhook 辅助工具）。
-
-相关内容：
-
-- Webhook：[Webhook](/automation/webhook)
-- Gmail Pub/Sub：[Gmail Pub/Sub](/automation/gmail-pubsub)
-
-## Gmail
-
-```bash
-symi webhooks gmail setup --account you@example.com
-symi webhooks gmail run
-```
-
-详情请参阅 [Gmail Pub/Sub 文档](/automation/gmail-pubsub)。