@symerian/symi 3.0.20 → 3.0.22

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

@@ -1,31 +0,0 @@
----
-read_when:
-  - 你需要远程跟踪 Gateway 网关日志（无需 SSH）
-  - 你需要 JSON 日志行用于工具处理
-summary: "`symi logs` 的 CLI 参考（通过 RPC 跟踪 Gateway 网关日志）"
-title: logs
-x-i18n:
-  generated_at: "2026-02-03T07:44:57Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 911a57f0f3b78412c26312f7bf87a5a26418ab7b74e5e2eb40f16edefb6c6b8e
-  source_path: cli/logs.md
-  workflow: 15
----
-
-# `symi logs`
-
-通过 RPC 跟踪 Gateway 网关文件日志（在远程模式下可用）。
-
-相关内容：
-
-- 日志概述：[日志](/logging)
-
-## 示例
-
-```bash
-symi logs
-symi logs --follow
-symi logs --json
-symi logs --limit 500
-```

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

@@ -1,52 +0,0 @@
----
-read_when:
-  - 你想要索引或搜索语义记忆
-  - 你正在调试记忆可用性或索引问题
-summary: "`symi memory`（status/index/search）的 CLI 参考"
-title: memory
-x-i18n:
-  generated_at: "2026-02-01T20:21:11Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 95a9e94306f95be2218a909be59be5bbaa5d31322b71b23564c71a89c3a3941a
-  source_path: cli/memory.md
-  workflow: 14
----
-
-# `symi memory`
-
-管理语义记忆的索引和搜索。
-由活跃的记忆插件提供（默认：`memory-core`；设置 `plugins.slots.memory = "none"` 可禁用）。
-
-相关内容：
-
-- 记忆概念：[记忆](/concepts/memory)
-- 插件：[插件](/tools/plugin)
-
-## 示例
-
-```bash
-symi memory status
-symi memory status --deep
-symi memory status --deep --index
-symi memory status --deep --index --verbose
-symi memory index
-symi memory index --verbose
-symi memory search "release checklist"
-symi memory status --agent main
-symi memory index --agent main --verbose
-```
-
-## 选项
-
-通用选项：
-
-- `--agent <id>`：限定到单个智能体（默认：所有已配置的智能体）。
-- `--verbose`：在探测和索引期间输出详细日志。
-
-说明：
-
-- `memory status --deep` 探测向量存储和嵌入模型的可用性。
-- `memory status --deep --index` 在存储有未同步变更时运行重新索引。
-- `memory index --verbose` 打印每个阶段的详细信息（提供商、模型、数据源、批处理活动）。
-- `memory status` 包含通过 `memorySearch.extraPaths` 配置的所有额外路径。

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

@@ -1,205 +0,0 @@
----
-read_when:
-  - 添加或修改消息 CLI 操作
-  - 更改出站渠道行为
-summary: "`symi message`（发送 + 渠道操作）的 CLI 参考"
-title: message
-x-i18n:
-  generated_at: "2026-02-01T20:21:30Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 35159baf1ef7136252e3ab1e5e03881ebc4196dd43425e2319a39306ced7f48c
-  source_path: cli/message.md
-  workflow: 14
----
-
-# `symi message`
-
-用于发送消息和渠道操作的单一出站命令
-
-## 用法
-
-```
-symi message <subcommand> [flags]
-```
-
-渠道选择：
-
-- 如果配置了多个渠道，则必须指定 `--channel`。
-- 如果只配置了一个渠道，则该渠道为默认值。
-
-目标格式（`--target`）：
-
-- WhatsApp：E.164 或群组 JID
-- Telegram：聊天 ID 或 `@username`
-- Google Chat：`spaces/<spaceId>` 或 `users/<userId>`
-- Slack：`channel:<id>` 或 `user:<id>`（接受纯频道 ID）
-- Mattermost（插件）：`channel:<id>`、`user:<id>` 或 `@username`（纯 ID 被视为频道）
-- Signal：`+E.164`、`group:<id>`、`signal:+E.164`、`signal:group:<id>` 或 `username:<name>`/`u:<name>`
-- iMessage：句柄、`chat_id:<id>`、`chat_guid:<guid>` 或 `chat_identifier:<id>`
-- MS Teams：会话 ID（`19:...@thread.tacv2`）或 `conversation:<id>` 或 `user:<aad-object-id>`
-
-名称查找：
-
-- 缓存未命中时，如果提供商支持，Symi 将尝试实时目录查找。
-
-## 通用标志
-
-- `--channel <name>`
-- `--account <id>`
-- `--target <dest>`（用于 send/poll/read 等的目标渠道或用户）
-- `--targets <name>`（可重复；仅限广播）
-- `--json`
-- `--dry-run`
-- `--verbose`
-
-## 操作
-
-### 核心
-
-- `send`
-  - 必需：`--target`，以及 `--message` 或 `--media`
-  - 可选：`--media`、`--reply-to`、`--thread-id`、`--gif-playback`
-  - 仅限 Telegram：`--buttons`（需要 `channels.telegram.capabilities.inlineButtons` 以启用）
-  - 仅限 Telegram：`--thread-id`（论坛主题 ID）
-  - 仅限 Slack：`--thread-id`（线程时间戳；`--reply-to` 使用相同字段）
-  - 仅限 WhatsApp：`--gif-playback`
-
-- `poll`
-  - 必需：`--target`、`--poll-question`、`--poll-option`（可重复）
-  - 可选：`--poll-multi`
-
-- `react`
-  - 必需：`--message-id`、`--target`
-  - 可选：`--emoji`、`--remove`、`--participant`、`--from-me`、`--target-author`、`--target-author-uuid`
-  - 注意：`--remove` 需要 `--emoji`（省略 `--emoji` 可清除自己的表情回应（如果支持）；参见 /tools/reactions）
-  - 仅限 WhatsApp：`--participant`、`--from-me`
-  - Signal 群组表情回应：需要 `--target-author` 或 `--target-author-uuid`
-
-- `reactions`
-  - 必需：`--message-id`、`--target`
-  - 可选：`--limit`
-
-- `read`
-  - 必需：`--target`
-  - 可选：`--limit`、`--before`、`--after`
-
-- `edit`
-  - 必需：`--message-id`、`--message`、`--target`
-
-- `delete`
-  - 必需：`--message-id`、`--target`
-
-- `pin` / `unpin`
-  - 必需：`--message-id`、`--target`
-
-- `pins`（列表）
-  - 必需：`--target`
-
-- `permissions`
-  - 必需：`--target`
-
-- `search`
-  - 必需：`--guild-id`、`--query`
-  - 可选：`--channel-id`、`--channel-ids`（可重复）、`--author-id`、`--author-ids`（可重复）、`--limit`
-
-### 线程
-
-- `thread create`
-  - 必需：`--thread-name`、`--target`（频道 ID）
-  - 可选：`--message-id`、`--auto-archive-min`
-
-- `thread list`
-  - 必需：`--guild-id`
-  - 可选：`--channel-id`、`--include-archived`、`--before`、`--limit`
-
-- `thread reply`
-  - 必需：`--target`（线程 ID）、`--message`
-  - 可选：`--media`、`--reply-to`
-
-### 表情符号
-
-- `emoji list`
-  - Slack：无需额外标志
-
-- `emoji upload`
-  - 必需：`--guild-id`、`--emoji-name`、`--media`
-  - 可选：`--role-ids`（可重复）
-
-### 贴纸
-
-- `sticker send`
-  - 必需：`--target`、`--sticker-id`（可重复）
-  - 可选：`--message`
-
-- `sticker upload`
-  - 必需：`--guild-id`、`--sticker-name`、`--sticker-desc`、`--sticker-tags`、`--media`
-
-### 角色 / 频道 / 成员 / 语音
-
-### 事件
-
-- 可选：`--end-time`、`--desc`、`--channel-id`、`--location`、`--event-type`
-
-- `timeout`：`--guild-id`、`--user-id`（可选 `--duration-min` 或 `--until`；两者都省略则清除超时）
-- `kick`：`--guild-id`、`--user-id`（+ `--reason`）
-- `ban`：`--guild-id`、`--user-id`（+ `--delete-days`、`--reason`）
-  - `timeout` 也支持 `--reason`
-
-### 广播
-
-- `broadcast`
-  - 渠道：任何已配置的渠道；使用 `--channel all` 可针对所有提供商
-  - 必需：`--targets`（可重复）
-  - 可选：`--message`、`--media`、`--dry-run`
-
-## 示例
-
-```
-  --target channel:123 --message "hi" --reply-to 456
-```
-
-```
-  --target channel:123 \
-  --poll-question "Snack?" \
-  --poll-option Pizza --poll-option Sushi \
-  --poll-multi --poll-duration-hours 48
-```
-
-发送 Teams 主动消息：
-
-```
-symi message send --channel msteams \
-  --target conversation:19:abc@thread.tacv2 --message "hi"
-```
-
-创建 Teams 投票：
-
-```
-symi message poll --channel msteams \
-  --target conversation:19:abc@thread.tacv2 \
-  --poll-question "Lunch?" \
-  --poll-option Pizza --poll-option Sushi
-```
-
-在 Slack 中添加表情回应：
-
-```
-symi message react --channel slack \
-  --target C123 --message-id 456 --emoji "✅"
-```
-
-在 Signal 群组中添加表情回应：
-
-```
-symi message react --channel signal \
-  --target signal:group:abc123 --message-id 1737630212345 \
-  --emoji "✅" --target-author-uuid 123e4567-e89b-12d3-a456-426614174000
-```
-
-发送 Telegram 内联按钮：
-
-```
-symi message send --channel telegram --target @mychat --message "Choose:" \
-  --buttons '[ [{"text":"Yes","callback_data":"cmd:yes"}], [{"text":"No","callback_data":"cmd:no"}] ]'
-```

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

@@ -1,85 +0,0 @@
----
-read_when:
-  - 你想更改默认模型或查看提供商认证状态
-  - 你想扫描可用的模型/提供商并调试认证配置
-summary: "`symi models` 的 CLI 参考（status/list/set/scan、别名、回退、认证）"
-title: models
-x-i18n:
-  generated_at: "2026-02-01T20:21:16Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 923b6ffc7de382ba25bc6e699f0515607e74877b39f2136ccdba2d99e1b1e9c3
-  source_path: cli/models.md
-  workflow: 14
----
-
-# `symi models`
-
-模型发现、扫描和配置（默认模型、回退、认证配置）。
-
-相关内容：
-
-- 提供商 + 模型：[模型](/providers/models)
-- 提供商认证设置：[快速开始](/start/getting-started)
-
-## 常用命令
-
-```bash
-symi models status
-symi models list
-symi models set <model-or-alias>
-symi models scan
-```
-
-`symi models status` 显示已解析的默认模型/回退配置以及认证概览。
-当提供商使用快照可用时，OAuth/令牌状态部分会包含提供商使用头信息。
-添加 `--probe` 可对每个已配置的提供商配置运行实时认证探测。
-探测会发送真实请求（可能消耗令牌并触发速率限制）。
-使用 `--agent <id>` 可检查已配置智能体的模型/认证状态。省略时，
-命令会使用 `SYMI_AGENT_DIR`/`PI_CODING_AGENT_DIR`（如已设置），否则使用
-已配置的默认智能体。
-
-注意事项：
-
-- `models set <model-or-alias>` 接受 `provider/model` 或别名。
-- 模型引用通过在**第一个** `/` 处拆分来解析。如果模型 ID 包含 `/`（OpenRouter 风格），需包含提供商前缀（示例：`openrouter/moonshotai/kimi-k2`）。
-- 如果省略提供商，Symi 会将输入视为别名或**默认提供商**的模型（仅在模型 ID 不包含 `/` 时有效）。
-
-### `models status`
-
-选项：
-
-- `--json`
-- `--plain`
-- `--check`（退出码 1=已过期/缺失，2=即将过期）
-- `--probe`（对已配置的认证配置进行实时探测）
-- `--probe-provider <name>`（探测单个提供商）
-- `--probe-profile <id>`（可重复或逗号分隔的配置 ID）
-- `--probe-timeout <ms>`
-- `--probe-concurrency <n>`
-- `--probe-max-tokens <n>`
-- `--agent <id>`（已配置的智能体 ID；覆盖 `SYMI_AGENT_DIR`/`PI_CODING_AGENT_DIR`）
-
-## 别名 + 回退
-
-```bash
-symi models aliases list
-symi models fallbacks list
-```
-
-## 认证配置
-
-```bash
-symi models auth add
-symi models auth login --provider <id>
-symi models auth setup-token
-symi models auth paste-token
-```
-
-`models auth login` 运行提供商插件的认证流程（OAuth/API 密钥）。使用
-`symi plugins list` 查看已安装的提供商。
-
-注意事项：
-
-- `setup-token` 会提示输入 setup-token 值（在任意机器上使用 `claude setup-token` 生成）。
-- `paste-token` 接受在其他地方或通过自动化生成的令牌字符串。

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

@@ -1,115 +0,0 @@
----
-read_when:
-  - 运行无头节点主机
-  - 为 system.run 配对非 macOS 节点
-summary: "`symi node` 的 CLI 参考（无头节点主机）"
-title: node
-x-i18n:
-  generated_at: "2026-02-03T07:45:07Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: a8b1a57712663e2285c9ecd306fe57d067eb3e6820d7d8aec650b41b022d995a
-  source_path: cli/node.md
-  workflow: 15
----
-
-# `symi node`
-
-运行一个**无头节点主机**，连接到 Gateway 网关 WebSocket 并在此机器上暴露
-`system.run` / `system.which`。
-
-## 为什么使用节点主机？
-
-当你希望智能体**在网络中的其他机器上运行命令**，而无需在那里安装完整的 macOS 配套应用时，请使用节点主机。
-
-常见用例：
-
-- 在远程 Linux/Windows 机器上运行命令（构建服务器、实验室机器、NAS）。
-- 在 Gateway 网关上保持执行的**沙箱隔离**，但将批准的运行委托给其他主机。
-- 为自动化或 CI 节点提供轻量级、无头的执行目标。
-
-执行仍然受**执行批准**和节点主机上的每智能体允许列表保护，因此你可以保持命令访问的范围明确。
-
-## 浏览器代理（零配置）
-
-如果节点上的 `browser.enabled` 未被禁用，节点主机会自动广播浏览器代理。这让智能体无需额外配置即可在该节点上使用浏览器自动化。
-
-如需在节点上禁用：
-
-```json5
-{
-  nodeHost: {
-    browserProxy: {
-      enabled: false,
-    },
-  },
-}
-```
-
-## 运行（前台）
-
-```bash
-symi node run --host <gateway-host> --port 18789
-```
-
-选项：
-
-- `--host <host>`：Gateway 网关 WebSocket 主机（默认：`127.0.0.1`）
-- `--port <port>`：Gateway 网关 WebSocket 端口（默认：`18789`）
-- `--tls`：为 Gateway 网关连接使用 TLS
-- `--tls-fingerprint <sha256>`：预期的 TLS 证书指纹（sha256）
-- `--node-id <id>`：覆盖节点 id（清除配对 token）
-- `--display-name <name>`：覆盖节点显示名称
-
-## 服务（后台）
-
-将无头节点主机安装为用户服务。
-
-```bash
-symi node install --host <gateway-host> --port 18789
-```
-
-选项：
-
-- `--host <host>`：Gateway 网关 WebSocket 主机（默认：`127.0.0.1`）
-- `--port <port>`：Gateway 网关 WebSocket 端口（默认：`18789`）
-- `--tls`：为 Gateway 网关连接使用 TLS
-- `--tls-fingerprint <sha256>`：预期的 TLS 证书指纹（sha256）
-- `--node-id <id>`：覆盖节点 id（清除配对 token）
-- `--display-name <name>`：覆盖节点显示名称
-- `--runtime <runtime>`：服务运行时（`node` 或 `bun`）
-- `--force`：如果已安装则重新安装/覆盖
-
-管理服务：
-
-```bash
-symi node status
-symi node stop
-symi node restart
-symi node uninstall
-```
-
-使用 `symi node run` 运行前台节点主机（无服务）。
-
-服务命令接受 `--json` 以获取机器可读输出。
-
-## 配对
-
-首次连接会在 Gateway 网关上创建待处理的节点配对请求。
-通过以下方式批准：
-
-```bash
-symi nodes pending
-symi nodes approve <requestId>
-```
-
-节点主机将其节点 id、token、显示名称和 Gateway 网关连接信息存储在
-`~/.symi/node.json` 中。
-
-## 执行批准
-
-`system.run` 受本地执行批准限制：
-
-- `~/.symi/exec-approvals.json`
-- [执行批准](/tools/exec-approvals)
-- `symi approvals --node <id|name|ip>`（从 Gateway 网关编辑）

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

@@ -1,80 +0,0 @@
----
-read_when:
-  - 你正在管理已配对的节点（摄像头、屏幕、画布）
-  - 你需要批准请求或调用节点命令
-summary: "`symi nodes` 的 CLI 参考（列表/状态/批准/调用，摄像头/画布/屏幕）"
-title: nodes
-x-i18n:
-  generated_at: "2026-02-03T10:04:26Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 23da6efdd659a82dbbc4afd18eb4ab1020a2892f69c28d610f912c8a799f734c
-  source_path: cli/nodes.md
-  workflow: 15
----
-
-# `symi nodes`
-
-管理已配对的节点（设备）并调用节点功能。
-
-相关内容：
-
-- 节点概述：[节点](/nodes)
-- 摄像头：[摄像头节点](/nodes/camera)
-- 图像：[图像节点](/nodes/images)
-
-通用选项：
-
-- `--url`、`--token`、`--timeout`、`--json`
-
-## 常用命令
-
-```bash
-symi nodes list
-symi nodes list --connected
-symi nodes list --last-connected 24h
-symi nodes pending
-symi nodes approve <requestId>
-symi nodes status
-symi nodes status --connected
-symi nodes status --last-connected 24h
-```
-
-`nodes list` 打印待处理/已配对表格。已配对行包含最近连接时长（Last Connect）。
-使用 `--connected` 仅显示当前已连接的节点。使用 `--last-connected <duration>`
-筛选在指定时间段内连接过的节点（例如 `24h`、`7d`）。
-
-## 调用 / 运行
-
-```bash
-symi nodes invoke --node <id|name|ip> --command <command> --params <json>
-symi nodes run --node <id|name|ip> <command...>
-symi nodes run --raw "git status"
-symi nodes run --agent main --node <id|name|ip> --raw "git status"
-```
-
-调用标志：
-
-- `--params <json>`：JSON 对象字符串（默认 `{}`）。
-- `--invoke-timeout <ms>`：节点调用超时（默认 `15000`）。
-- `--idempotency-key <key>`：可选的幂等键。
-
-### Exec 风格默认值
-
-`nodes run` 与模型的 exec 行为一致（默认值 + 审批）：
-
-- 读取 `tools.exec.*`（以及 `agents.list[].tools.exec.*` 覆盖）。
-- 在调用 `system.run` 前使用 exec 审批（`exec.approval.request`）。
-- 当设置了 `tools.exec.node` 时可省略 `--node`。
-- 需要支持 `system.run` 的节点（macOS 配套应用或无头节点主机）。
-
-标志：
-
-- `--cwd <path>`：工作目录。
-- `--env <key=val>`：环境变量覆盖（可重复）。
-- `--command-timeout <ms>`：命令超时。
-- `--invoke-timeout <ms>`：节点调用超时（默认 `30000`）。
-- `--needs-screen-recording`：要求屏幕录制权限。
-- `--raw <command>`：运行 shell 字符串（`/bin/sh -lc` 或 `cmd.exe /c`）。
-- `--agent <id>`：智能体范围的审批/白名单（默认为已配置的智能体）。
-- `--ask <off|on-miss|always>`、`--security <deny|allowlist|full>`：覆盖选项。

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

@@ -1,36 +0,0 @@
----
-read_when:
-  - 你想要 Gateway 网关、工作区、认证、渠道和 Skills 的引导式设置
-summary: "`symi onboard` 的 CLI 参考（交互式新手引导向导）"
-title: onboard
-x-i18n:
-  generated_at: "2026-02-03T07:45:00Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: a661049a6983233986a880a68440a3bcc6869ee2c4c6f5e9f3ab8ff973e22f60
-  source_path: cli/onboard.md
-  workflow: 15
----
-
-# `symi onboard`
-
-交互式新手引导向导（本地或远程 Gateway 网关设置）。
-
-相关内容：
-
-- 向导指南：[新手引导](/start/onboarding)
-
-## 示例
-
-```bash
-symi onboard
-symi onboard --flow quickstart
-symi onboard --flow manual
-symi onboard --mode remote --remote-url ws://gateway-host:18789
-```
-
-流程说明：
-
-- `quickstart`：最少提示，自动生成 Gateway 网关令牌。
-- `manual`：完整的端口/绑定/认证提示（`advanced` 的别名）。
-- 最快开始聊天：`symi dashboard`（控制 UI，无需渠道设置）。

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

@@ -1,28 +0,0 @@
----
-read_when:
-  - 你正在使用配对模式私信并需要批准发送者
-summary: "`symi pairing` 的 CLI 参考（批准/列出配对请求）"
-title: pairing
-x-i18n:
-  generated_at: "2026-02-03T07:45:02Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: e0bc9707294463c95d13e0deb67d834cfad6a105ab44baf4c25592e5de65ddf5
-  source_path: cli/pairing.md
-  workflow: 15
----
-
-# `symi pairing`
-
-批准或检查私信配对请求（适用于支持配对的渠道）。
-
-相关内容：
-
-- 配对流程：[配对](/channels/pairing)
-
-## 命令
-
-```bash
-symi pairing list whatsapp
-symi pairing approve whatsapp <code> --notify
-```

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

@@ -1,66 +0,0 @@
----
-read_when:
-  - 你想安装或管理进程内 Gateway 网关插件
-  - 你想调试插件加载失败问题
-summary: "`symi plugins` 的 CLI 参考（列出、安装、启用/禁用、诊断）"
-title: plugins
-x-i18n:
-  generated_at: "2026-02-03T07:45:08Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: c6bf76b1e766b912ec30a0101d455151c88f1a778bffa121cdd1d0b4fbe73e1c
-  source_path: cli/plugins.md
-  workflow: 15
----
-
-# `symi plugins`
-
-管理 Gateway 网关插件/扩展（进程内加载）。
-
-相关内容：
-
-- 插件系统：[插件](/tools/plugin)
-- 插件清单 + 模式：[插件清单](/plugins/manifest)
-- 安全加固：[安全](/gateway/security)
-
-## 命令
-
-```bash
-symi plugins list
-symi plugins info <id>
-symi plugins enable <id>
-symi plugins disable <id>
-symi plugins doctor
-symi plugins update <id>
-symi plugins update --all
-```
-
-内置插件随 Symi 一起发布，但默认禁用。使用 `plugins enable` 来激活它们。
-
-所有插件必须提供 `symi.plugin.json` 文件，其中包含内联 JSON Schema（`configSchema`，即使为空）。缺少或无效的清单或模式会阻止插件加载并导致配置验证失败。
-
-### 安装
-
-```bash
-symi plugins install <path-or-spec>
-```
-
-安全提示：将插件安装视为运行代码。优先使用固定版本。
-
-支持的归档格式：`.zip`、`.tgz`、`.tar.gz`、`.tar`。
-
-使用 `--link` 避免复制本地目录（添加到 `plugins.load.paths`）：
-
-```bash
-symi plugins install -l ./my-plugin
-```
-
-### 更新
-
-```bash
-symi plugins update <id>
-symi plugins update --all
-symi plugins update <id> --dry-run
-```
-
-更新仅适用于从 npm 安装的插件（在 `plugins.installs` 中跟踪）。