@symerian/symi 3.0.20 → 3.0.22

package/docs/zh-CN/platforms/macos.md

@@ -1,193 +0,0 @@
----
-read_when:
-  - 实现 macOS 应用功能
-  - 在 macOS 上更改 Gateway 网关生命周期或节点桥接
-summary: Symi macOS 配套应用（菜单栏 + Gateway 网关代理）
-title: macOS 应用
-x-i18n:
-  generated_at: "2026-02-03T07:53:14Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: a5b1c02e5905e4cbc6c0688149cdb50a5bf7653e641947143e169ad948d1f057
-  source_path: platforms/macos.md
-  workflow: 15
----
-
-# Symi macOS 配套应用（菜单栏 + Gateway 网关代理）
-
-macOS 应用是 Symi 的**菜单栏配套应用**。它拥有权限，在本地管理/附加到 Gateway 网关（launchd 或手动），并作为节点向智能体暴露 macOS 功能。
-
-## 功能
-
-- 在菜单栏中显示原生通知和状态。
-- 拥有 TCC 提示（通知、辅助功能、屏幕录制、麦克风、语音识别、自动化/AppleScript）。
-- 运行或连接到 Gateway 网关（本地或远程）。
-- 暴露 macOS 专用工具（Canvas、相机、屏幕录制、`system.run`）。
-- 在**远程**模式下启动本地节点主机服务（launchd），在**本地**模式下停止它。
-- 可选地托管 **PeekabooBridge** 用于 UI 自动化。
-- 根据请求通过 npm/pnpm 安装全局 CLI（`symi`）（不建议使用 bun 作为 Gateway 网关运行时）。
-
-## 本地 vs 远程模式
-
-- **本地**（默认）：如果存在运行中的本地 Gateway 网关，应用附加到它；否则通过 `symi gateway install` 启用 launchd 服务。
-- **远程**：应用通过 SSH/Tailscale 连接到 Gateway 网关，从不启动本地进程。
-  应用启动本地**节点主机服务**，以便远程 Gateway 网关可以访问此 Mac。
-  应用不会将 Gateway 网关作为子进程生成。
-
-## Launchd 控制
-
-应用管理一个标记为 `bot.molt.gateway` 的每用户 LaunchAgent（使用 `--profile`/`SYMI_PROFILE` 时为 `bot.molt.<profile>`；旧版 `com.symi.*` 仍会卸载）。
-
-```bash
-launchctl kickstart -k gui/$UID/bot.molt.gateway
-launchctl bootout gui/$UID/bot.molt.gateway
-```
-
-运行命名配置文件时，将标签替换为 `bot.molt.<profile>`。
-
-如果 LaunchAgent 未安装，从应用中启用它或运行 `symi gateway install`。
-
-## 节点功能（mac）
-
-macOS 应用将自身呈现为一个节点。常用命令：
-
-- Canvas：`canvas.present`、`canvas.navigate`、`canvas.eval`、`canvas.snapshot`、`canvas.a2ui.*`
-- 相机：`camera.snap`、`camera.clip`
-- 屏幕：`screen.record`
-- 系统：`system.run`、`system.notify`
-
-节点报告一个 `permissions` 映射，以便智能体可以决定什么是允许的。
-
-节点服务 + 应用 IPC：
-
-- 当无头节点主机服务运行时（远程模式），它作为节点连接到 Gateway 网关 WS。
-- `system.run` 在 macOS 应用中执行（UI/TCC 上下文）通过本地 Unix 套接字；提示 + 输出保留在应用内。
-
-图示（SCI）：
-
-```
-Gateway -> Node Service (WS)
-                 |  IPC (UDS + token + HMAC + TTL)
-                 v
-             Mac App (UI + TCC + system.run)
-```
-
-## Exec 审批（system.run）
-
-`system.run` 由 macOS 应用中的 **Exec 审批**控制（设置 → Exec approvals）。安全 + 询问 + 允许列表本地存储在 Mac 上：
-
-```
-~/.symi/exec-approvals.json
-```
-
-示例：
-
-```json
-{
-  "version": 1,
-  "defaults": {
-    "security": "deny",
-    "ask": "on-miss"
-  },
-  "agents": {
-    "main": {
-      "security": "allowlist",
-      "ask": "on-miss",
-      "allowlist": [{ "pattern": "/opt/homebrew/bin/rg" }]
-    }
-  }
-}
-```
-
-注意事项：
-
-- `allowlist` 条目是解析后二进制路径的 glob 模式。
-- 在提示中选择"Always Allow"会将该命令添加到允许列表。
-- `system.run` 环境覆盖会被过滤（删除 `PATH`、`DYLD_*`、`LD_*`、`NODE_OPTIONS`、`PYTHON*`、`PERL*`、`RUBYOPT`），然后与应用的环境合并。
-
-## 深度链接
-
-应用为本地操作注册 `symi://` URL 方案。
-
-### `symi://agent`
-
-触发 Gateway 网关 `agent` 请求。
-
-```bash
-open 'symi://agent?message=Hello%20from%20deep%20link'
-```
-
-查询参数：
-
-- `message`（必需）
-- `sessionKey`（可选）
-- `thinking`（可选）
-- `deliver` / `to` / `channel`（可选）
-- `timeoutSeconds`（可选）
-- `key`（可选无人值守模式密钥）
-
-安全：
-
-- 没有 `key` 时，应用会提示确认。
-- 有有效的 `key` 时，运行是无人值守的（用于个人自动化）。
-
-## 新手引导流程（典型）
-
-1. 安装并启动 **Symi.app**。
-2. 完成权限清单（TCC 提示）。
-3. 确保**本地**模式处于活动状态且 Gateway 网关正在运行。
-4. 如果你想要终端访问，安装 CLI。
-
-## 构建和开发工作流程（原生）
-
-- `cd apps/macos && swift build`
-- `swift run Symi`（或 Xcode）
-- 打包应用：`scripts/package-mac-app.sh`
-
-## 调试 Gateway 网关连接（macOS CLI）
-
-使用调试 CLI 来执行与 macOS 应用使用的相同的 Gateway 网关 WebSocket 握手和发现逻辑，而无需启动应用。
-
-```bash
-cd apps/macos
-swift run symi-mac connect --json
-swift run symi-mac discover --timeout 3000 --json
-```
-
-Connect 选项：
-
-- `--url <ws://host:port>`：覆盖配置
-- `--mode <local|remote>`：从配置解析（默认：配置或 local）
-- `--probe`：强制进行新的健康探测
-- `--timeout <ms>`：请求超时（默认：`15000`）
-- `--json`：用于比较的结构化输出
-
-Discovery 选项：
-
-- `--include-local`：包含会被过滤为"本地"的 Gateway 网关
-- `--timeout <ms>`：总体发现窗口（默认：`2000`）
-- `--json`：用于比较的结构化输出
-
-提示：与 `symi gateway discover --json` 比较，查看 macOS 应用的发现管道（NWBrowser + tailnet DNS-SD 回退）是否与 Node CLI 基于 `dns-sd` 的发现不同。
-
-## 远程连接管道（SSH 隧道）
-
-当 macOS 应用在**远程**模式下运行时，它会打开一个 SSH 隧道，以便本地 UI 组件可以像在 localhost 上一样与远程 Gateway 网关通信。
-
-### 控制隧道（Gateway 网关 WebSocket 端口）
-
-- **目的：**健康检查、状态、Web Chat、配置和其他控制平面调用。
-- **本地端口：**Gateway 网关端口（默认 `18789`），始终稳定。
-- **远程端口：**远程主机上的相同 Gateway 网关端口。
-- **行为：**无随机本地端口；应用复用现有的健康隧道或在需要时重启它。
-- **SSH 形式：**`ssh -N -L <local>:127.0.0.1:<remote>`，带有 BatchMode + ExitOnForwardFailure + keepalive 选项。
-- **IP 报告：**SSH 隧道使用 loopback，因此 Gateway 网关将看到节点 IP 为 `127.0.0.1`。如果你想要显示真实的客户端 IP，请使用 **Direct (ws/wss)** 传输（参见 [macOS 远程访问](/platforms/mac/remote)）。
-
-有关设置步骤，请参阅 [macOS 远程访问](/platforms/mac/remote)。有关协议详情，请参阅 [Gateway 网关协议](/gateway/protocol)。
-
-## 相关文档
-
-- [Gateway 网关运维手册](/gateway)
-- [Gateway 网关（macOS）](/platforms/mac/bundled-gateway)
-- [macOS 权限](/platforms/mac/permissions)
-- [Canvas](/platforms/mac/canvas)

package/docs/zh-CN/platforms/oracle.md

@@ -1,310 +0,0 @@
----
-read_when:
-  - 在 Oracle Cloud 上设置 Symi
-  - 寻找 Symi 的低成本 VPS 托管
-  - 想要在小型服务器上 24/7 运行 Symi
-summary: 在 Oracle Cloud 上运行 Symi（Always Free ARM）
-title: Oracle Cloud
-x-i18n:
-  generated_at: "2026-02-03T07:53:25Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: d3cc337b40ea512b5756ac15ec4341fecad417ede75f717fea3035678c7c6697
-  source_path: platforms/oracle.md
-  workflow: 15
----
-
-# 在 Oracle Cloud（OCI）上运行 Symi
-
-## 目标
-
-在 Oracle Cloud 的 **Always Free** ARM 层上运行持久化的 Symi Gateway 网关。
-
-Oracle 的免费层非常适合 Symi（特别是如果你已经有 OCI 账户），但有一些权衡：
-
-- ARM 架构（大多数东西都能工作，但某些二进制文件可能仅支持 x86）
-- 容量和注册可能比较麻烦
-
-## 成本比较（2026）
-
-| 提供商       | 方案            | 配置                  | 价格/月 | 说明                 |
-| ------------ | --------------- | --------------------- | ------- | -------------------- |
-| Oracle Cloud | Always Free ARM | 最多 4 OCPU，24GB RAM | $0      | ARM，容量有限        |
-| Hetzner      | CX22            | 2 vCPU，4GB RAM       | ~ $4    | 最便宜的付费选项     |
-| DigitalOcean | Basic           | 1 vCPU，1GB RAM       | $6      | 易用的 UI，文档完善  |
-| Vultr        | Cloud Compute   | 1 vCPU，1GB RAM       | $6      | 多个地区             |
-| Linode       | Nanode          | 1 vCPU，1GB RAM       | $5      | 现为 Akamai 的一部分 |
-
----
-
-## 先决条件
-
-- Oracle Cloud 账户（[注册](https://www.oracle.com/cloud/free/)）——如果遇到问题请参阅[社区注册指南](https://gist.github.com/rssnyder/51e3cfedd730e7dd5f4a816143b25dbd)
-- Tailscale 账户（在 [tailscale.com](https://tailscale.com) 免费）
-- 约 30 分钟
-
-## 1) 创建 OCI 实例
-
-1. 登录 [Oracle Cloud Console](https://cloud.oracle.com/)
-2. 导航到 **Compute → Instances → Create Instance**
-3. 配置：
-   - **Name:** `symi`
-   - **Image:** Ubuntu 24.04 (aarch64)
-   - **Shape:** `VM.Standard.A1.Flex`（Ampere ARM）
-   - **OCPUs:** 2（或最多 4）
-   - **Memory:** 12 GB（或最多 24 GB）
-   - **Boot volume:** 50 GB（最多 200 GB 免费）
-   - **SSH key:** 添加你的公钥
-4. 点击 **Create**
-5. 记录公网 IP 地址
-
-**提示：** 如果实例创建失败并显示"Out of capacity"，尝试不同的可用性域或稍后重试。免费层容量有限。
-
-## 2) 连接并更新
-
-```bash
-# 通过公网 IP 连接
-ssh ubuntu@YOUR_PUBLIC_IP
-
-# 更新系统
-sudo apt update && sudo apt upgrade -y
-sudo apt install -y build-essential
-```
-
-**注意：** `build-essential` 是某些依赖项 ARM 编译所必需的。
-
-## 3) 配置用户和主机名
-
-```bash
-# 设置主机名
-sudo hostnamectl set-hostname symi
-
-# 为 ubuntu 用户设置密码
-sudo passwd ubuntu
-
-# 启用 lingering（注销后保持用户服务运行）
-sudo loginctl enable-linger ubuntu
-```
-
-## 4) 安装 Tailscale
-
-```bash
-curl -fsSL https://tailscale.com/install.sh | sh
-sudo tailscale up --ssh --hostname=symi
-```
-
-这会启用 Tailscale SSH，所以你可以从 tailnet 上的任何设备通过 `ssh symi` 连接——不需要公网 IP。
-
-验证：
-
-```bash
-tailscale status
-```
-
-**从现在开始，通过 Tailscale 连接：** `ssh ubuntu@symi`（或使用 Tailscale IP）。
-
-## 5) 安装 Symi
-
-```bash
-curl -fsSL https://jaysteelmind.github.io/getsymi/install.sh | bash
-source ~/.bashrc
-```
-
-当提示"How do you want to hatch your bot?"时，选择 **"Do this later"**。
-
-> 注意：如果你遇到 ARM 原生构建问题，在使用 Homebrew 之前先从系统包开始（例如 `sudo apt install -y build-essential`）。
-
-## 6) 配置 Gateway 网关（loopback + 令牌认证）并启用 Tailscale Serve
-
-使用令牌认证作为默认值。它是可预测的，避免需要任何"不安全认证"的控制 UI 标志。
-
-```bash
-# 在 VM 上保持 Gateway 网关私有
-symi config set gateway.bind loopback
-
-# 要求 Gateway 网关 + 控制 UI 的认证
-symi config set gateway.auth.mode token
-symi doctor --generate-gateway-token
-
-# 通过 Tailscale Serve 暴露（HTTPS + tailnet 访问）
-symi config set gateway.tailscale.mode serve
-symi config set gateway.trustedProxies '["127.0.0.1"]'
-
-systemctl --user restart symi-gateway
-```
-
-## 7) 验证
-
-```bash
-# 检查版本
-symi --version
-
-# 检查守护进程状态
-systemctl --user status symi-gateway
-
-# 检查 Tailscale Serve
-tailscale serve status
-
-# 测试本地响应
-curl http://localhost:18789
-```
-
-## 8) 锁定 VCN 安全
-
-现在一切正常工作了，锁定 VCN 以阻止除 Tailscale 之外的所有流量。OCI 的虚拟云网络充当网络边缘的防火墙——流量在到达你的实例之前就被阻止。
-
-1. 在 OCI Console 中转到 **Networking → Virtual Cloud Networks**
-2. 点击你的 VCN → **Security Lists** → Default Security List
-3. **移除**除以下之外的所有入站规则：
-   - `0.0.0.0/0 UDP 41641`（Tailscale）
-4. 保留默认出站规则（允许所有出站）
-
-这会在网络边缘阻止端口 22 上的 SSH、HTTP、HTTPS 和其他所有内容。从现在开始，你只能通过 Tailscale 连接。
-
----
-
-## 访问控制 UI
-
-从你 Tailscale 网络上的任何设备：
-
-```
-https://symi.<tailnet-name>.ts.net/
-```
-
-将 `<tailnet-name>` 替换为你的 tailnet 名称（在 `tailscale status` 中可见）。
-
-不需要 SSH 隧道。Tailscale 提供：
-
-- HTTPS 加密（自动证书）
-- 通过 Tailscale 身份认证
-- 从 tailnet 上的任何设备（笔记本电脑、手机等）访问
-
----
-
-## 安全：VCN + Tailscale（推荐基线）
-
-通过锁定 VCN（仅开放 UDP 41641）并将 Gateway 网关绑定到 loopback，你获得了强大的纵深防御：公共流量在网络边缘被阻止，管理访问通过你的 tailnet 进行。
-
-此设置通常消除了纯粹为了阻止互联网范围的 SSH 暴力破解而需要额外的基于主机的防火墙规则的*需求*——但你仍应保持操作系统更新，运行 `symi security audit`，并验证你没有意外地在公共接口上监听。
-
-### 已经受保护的内容
-
-| 传统步骤        | 是否需要？ | 原因                                             |
-| --------------- | ---------- | ------------------------------------------------ |
-| UFW 防火墙      | 否         | VCN 在流量到达实例之前就阻止了                   |
-| fail2ban        | 否         | 如果端口 22 在 VCN 被阻止则无暴力破解            |
-| sshd 加固       | 否         | Tailscale SSH 不使用 sshd                        |
-| 禁用 root 登录  | 否         | Tailscale 使用 Tailscale 身份，而不是系统用户    |
-| 仅 SSH 密钥认证 | 否         | Tailscale 通过你的 tailnet 认证                  |
-| IPv6 加固       | 通常不需要 | 取决于你的 VCN/子网设置；验证实际分配/暴露的内容 |
-
-### 仍然推荐
-
-- **凭证权限：** `chmod 700 ~/.symi`
-- **安全审计：** `symi security audit`
-- **系统更新：** 定期 `sudo apt update && sudo apt upgrade`
-- **监控 Tailscale：** 在 [Tailscale 管理控制台](https://login.tailscale.com/admin) 中查看设备
-
-### 验证安全态势
-
-```bash
-# 确认没有公共端口在监听
-sudo ss -tlnp | grep -v '127.0.0.1\|::1'
-
-# 验证 Tailscale SSH 处于活动状态
-tailscale status | grep -q 'offers: ssh' && echo "Tailscale SSH active"
-
-# 可选：完全禁用 sshd
-sudo systemctl disable --now ssh
-```
-
----
-
-## 备用方案：SSH 隧道
-
-如果 Tailscale Serve 不工作，使用 SSH 隧道：
-
-```bash
-# 从你的本地机器（通过 Tailscale）
-ssh -L 18789:127.0.0.1:18789 ubuntu@symi
-```
-
-然后打开 `http://localhost:18789`。
-
----
-
-## 故障排除
-
-### 实例创建失败（"Out of capacity"）
-
-免费层 ARM 实例很受欢迎。尝试：
-
-- 不同的可用性域
-- 在非高峰时段（清晨）重试
-- 选择 shape 时使用"Always Free"过滤器
-
-### Tailscale 无法连接
-
-```bash
-# 检查状态
-sudo tailscale status
-
-# 重新认证
-sudo tailscale up --ssh --hostname=symi --reset
-```
-
-### Gateway 网关无法启动
-
-```bash
-symi gateway status
-symi doctor --non-interactive
-journalctl --user -u symi-gateway -n 50
-```
-
-### 无法访问控制 UI
-
-```bash
-# 验证 Tailscale Serve 正在运行
-tailscale serve status
-
-# 检查 Gateway 网关是否在监听
-curl http://localhost:18789
-
-# 如需要则重启
-systemctl --user restart symi-gateway
-```
-
-### ARM 二进制文件问题
-
-某些工具可能没有 ARM 构建。检查：
-
-```bash
-uname -m  # 应该显示 aarch64
-```
-
-大多数 npm 包工作正常。对于二进制文件，寻找 `linux-arm64` 或 `aarch64` 版本。
-
----
-
-## 持久化
-
-所有状态存储在：
-
-- `~/.symi/` — 配置、凭证、会话数据
-- `~/.symi/workspace/` — 工作区（SYMICORE.md、记忆、产物）
-
-定期备份：
-
-```bash
-tar -czvf symi-backup.tar.gz ~/.symi ~/.symi/workspace
-```
-
----
-
-## 另请参阅
-
-- [Gateway 网关远程访问](/gateway/remote) — 其他远程访问模式
-- [Tailscale 集成](/gateway/tailscale) — 完整的 Tailscale 文档
-- [Gateway 网关配置](/gateway/configuration) — 所有配置选项
-- [DigitalOcean 指南](/platforms/digitalocean) — 如果你想要付费 + 更容易注册
-- [Hetzner 指南](/install/hetzner) — 基于 Docker 的替代方案