@symerian/symi 3.0.20 → 3.0.22

package/docs/zh-CN/index.md

@@ -1,183 +0,0 @@
----
-read_when:
-  - 向新用户介绍 Symi
-summary: Symi 是一个多渠道 AI 智能体 Gateway 网关，可在任何操作系统上运行。
-title: Symi
-x-i18n:
-  generated_at: "2026-02-04T17:53:40Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: fc8babf7885ef91d526795051376d928599c4cf8aff75400138a0d7d9fa3b75f
-  source_path: index.md
-  workflow: 15
----
-
-# Symi 🦞
-
-<p align="center">
-    <img
-        src="/assets/symi-logo-text-dark.png"
-        alt="Symi"
-        width="500"
-        class="dark:hidden"
-    />
-    <img
-        src="/assets/symi-logo-text.png"
-        alt="Symi"
-        width="500"
-        class="hidden dark:block"
-    />
-</p>
-
-> _"去壳！去壳！"_ — 大概是一只太空龙虾说的
-
-<p align="center">
-  发送消息，随时随地获取智能体响应。通过插件可添加 Mattermost 等更多渠道。
-</p>
-
-<Columns>
-  <Card title="入门指南" href="/start/getting-started" icon="rocket">
-    安装 Symi 并在几分钟内启动 Gateway 网关。
-  </Card>
-  <Card title="运行向导" href="/start/wizard" icon="sparkles">
-    通过 `symi onboard` 和配对流程进行引导式设置。
-  </Card>
-  <Card title="打开控制界面" href="/web/control-ui" icon="layout-dashboard">
-    启动浏览器仪表板，管理聊天、配置和会话。
-  </Card>
-</Columns>
-
-Symi 通过单个 Gateway 网关进程将聊天应用连接到 Pi 等编程智能体。它为 Symi 助手提供支持，并支持本地或远程部署。
-
-## 工作原理
-
-```mermaid
-flowchart LR
-  A["Chat apps + plugins"] --> B["Gateway"]
-  B --> C["Pi agent"]
-  B --> D["CLI"]
-  B --> E["Web Control UI"]
-  B --> F["macOS app"]
-  B --> G["iOS and Android nodes"]
-```
-
-Gateway 网关是会话、路由和渠道连接的唯一事实来源。
-
-## 核心功能
-
-<Columns>
-  <Card title="多渠道 Gateway 网关" icon="network">
-  </Card>
-  <Card title="插件渠道" icon="plug">
-    通过扩展包添加 Mattermost 等更多渠道。
-  </Card>
-  <Card title="多智能体路由" icon="route">
-    按智能体、工作区或发送者隔离会话。
-  </Card>
-  <Card title="媒体支持" icon="image">
-    发送和接收图片、音频和文档。
-  </Card>
-  <Card title="Web 控制界面" icon="monitor">
-    浏览器仪表板，用于聊天、配置、会话和节点管理。
-  </Card>
-  <Card title="移动节点" icon="smartphone">
-    配对 iOS 和 Android 节点，支持 Canvas。
-  </Card>
-</Columns>
-
-## 快速开始
-
-<Steps>
-  <Step title="安装 Symi">
-    ```bash
-    npm install -g @symerian/symi@latest
-    ```
-  </Step>
-  <Step title="新手引导并安装服务">
-    ```bash
-    symi onboard --install-daemon
-    ```
-  </Step>
-  <Step title="配对 WhatsApp 并启动 Gateway 网关">
-    ```bash
-    symi channels login
-    symi gateway --port 18789
-    ```
-  </Step>
-</Steps>
-
-需要完整的安装和开发环境设置？请参阅[快速开始](/start/quickstart)。
-
-## 仪表板
-
-Gateway 网关启动后，打开浏览器控制界面。
-
-- 本地默认地址：http://127.0.0.1:18789/
-- 远程访问：[Web 界面](/web)和 [Tailscale](/gateway/tailscale)
-
-<p align="center">
-  <img src="whatsapp-symi.jpg" alt="Symi" width="420" />
-</p>
-
-## 配置（可选）
-
-配置文件位于 `~/.symi/symi.json`。
-
-- 如果你**不做任何修改**，Symi 将使用内置的 Pi 二进制文件以 RPC 模式运行，并按发送者创建独立会话。
-- 如果你想要限制访问，可以从 `channels.whatsapp.allowFrom` 和（针对群组的）提及规则开始配置。
-
-示例：
-
-```json5
-{
-  channels: {
-    whatsapp: {
-      allowFrom: ["+15555550123"],
-      groups: { "*": { requireMention: true } },
-    },
-  },
-  messages: { groupChat: { mentionPatterns: ["@symi"] } },
-}
-```
-
-## 从这里开始
-
-<Columns>
-  <Card title="文档中心" href="/start/hubs" icon="book-open">
-    所有文档和指南，按用例分类。
-  </Card>
-  <Card title="配置" href="/gateway/configuration" icon="settings">
-    核心 Gateway 网关设置、令牌和提供商配置。
-  </Card>
-  <Card title="远程访问" href="/gateway/remote" icon="globe">
-    SSH 和 tailnet 访问模式。
-  </Card>
-  <Card title="渠道" href="/channels/telegram" icon="message-square">
-  </Card>
-  <Card title="节点" href="/nodes" icon="smartphone">
-    iOS 和 Android 节点的配对与 Canvas 功能。
-  </Card>
-  <Card title="帮助" href="/help" icon="life-buoy">
-    常见修复方法和故障排除入口。
-  </Card>
-</Columns>
-
-## 了解更多
-
-<Columns>
-  <Card title="完整功能列表" href="/concepts/features" icon="list">
-    全部渠道、路由和媒体功能。
-  </Card>
-  <Card title="多智能体路由" href="/concepts/multi-agent" icon="route">
-    工作区隔离和按智能体的会话管理。
-  </Card>
-  <Card title="安全" href="/gateway/security" icon="shield">
-    令牌、白名单和安全控制。
-  </Card>
-  <Card title="故障排除" href="/gateway/troubleshooting" icon="wrench">
-    Gateway 网关诊断和常见错误。
-  </Card>
-  <Card title="关于与致谢" href="/reference/credits" icon="info">
-    项目起源、贡献者和许可证。
-  </Card>
-</Columns>

package/docs/zh-CN/install/ansible.md

@@ -1,214 +0,0 @@
----
-read_when:
-  - 你想要带安全加固的自动化服务器部署
-  - 你需要带 VPN 访问的防火墙隔离设置
-  - 你正在部署到远程 Debian/Ubuntu 服务器
-summary: 使用 Ansible、Tailscale VPN 和防火墙隔离进行自动化、加固的 Symi 安装
-title: Ansible
-x-i18n:
-  generated_at: "2026-02-03T07:49:29Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 896807f344d923f09039f377c13b4bf4a824aa94eec35159fc169596a3493b29
-  source_path: install/ansible.md
-  workflow: 15
----
-
-# Ansible 安装
-
-将 Symi 部署到生产服务器的推荐方式是通过 **[symi-ansible](https://github.com/symi/symi-ansible)** — 一个安全优先架构的自动化安装程序。
-
-## 快速开始
-
-一条命令安装：
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/symi/symi-ansible/main/install.sh | bash
-```
-
-> **📦 完整指南：[github.com/symi/symi-ansible](https://github.com/symi/symi-ansible)**
->
-> symi-ansible 仓库是 Ansible 部署的权威来源。本页是快速概述。
-
-## 你将获得
-
-- 🔒 **防火墙优先安全**：UFW + Docker 隔离（仅 SSH + Tailscale 可访问）
-- 🔐 **Tailscale VPN**：安全远程访问，无需公开暴露服务
-- 🐳 **Docker**：隔离的沙箱容器，仅绑定 localhost
-- 🛡️ **纵深防御**：4 层安全架构
-- 🚀 **一条命令设置**：几分钟内完成部署
-- 🔧 **Systemd 集成**：带加固的开机自启动
-
-## 要求
-
-- **操作系统**：Debian 11+ 或 Ubuntu 20.04+
-- **访问权限**：Root 或 sudo 权限
-- **网络**：用于包安装的互联网连接
-- **Ansible**：2.14+（由快速启动脚本自动安装）
-
-## 安装内容
-
-Ansible playbook 安装并配置：
-
-1. **Tailscale**（用于安全远程访问的 mesh VPN）
-2. **UFW 防火墙**（仅允许 SSH + Tailscale 端口）
-3. **Docker CE + Compose V2**（用于智能体沙箱）
-4. **Node.js 22.x + pnpm**（运行时依赖）
-5. **Symi**（基于主机，非容器化）
-6. **Systemd 服务**（带安全加固的自动启动）
-
-注意：Gateway 网关**直接在主机上运行**（不在 Docker 中），但智能体沙箱使用 Docker 进行隔离。详情参见[沙箱隔离](/gateway/sandboxing)。
-
-## 安装后设置
-
-安装完成后，切换到 symi 用户：
-
-```bash
-sudo -i -u symi
-```
-
-安装后脚本将引导你完成：
-
-1. **新手引导向导**：配置 Symi 设置
-2. **Gateway 网关测试**：验证安装
-3. **Tailscale 设置**：连接到你的 VPN mesh
-
-### 常用命令
-
-```bash
-# 检查服务状态
-sudo systemctl status symi
-
-# 查看实时日志
-sudo journalctl -u symi -f
-
-# 重启 Gateway 网关
-sudo systemctl restart symi
-
-# 提供商登录（以 symi 用户运行）
-sudo -i -u symi
-symi channels login
-```
-
-## 安全架构
-
-### 4 层防御
-
-1. **防火墙（UFW）**：仅公开暴露 SSH（22）+ Tailscale（41641/udp）
-2. **VPN（Tailscale）**：Gateway 网关仅通过 VPN mesh 可访问
-3. **Docker 隔离**：DOCKER-USER iptables 链防止外部端口暴露
-4. **Systemd 加固**：NoNewPrivileges、PrivateTmp、非特权用户
-
-### 验证
-
-测试外部攻击面：
-
-```bash
-nmap -p- YOUR_SERVER_IP
-```
-
-应该显示**仅端口 22**（SSH）开放。所有其他服务（Gateway 网关、Docker）都被锁定。
-
-### Docker 可用性
-
-Docker 用于**智能体沙箱**（隔离的工具执行），而不是用于运行 Gateway 网关本身。Gateway 网关仅绑定到 localhost，通过 Tailscale VPN 访问。
-
-沙箱配置参见[多智能体沙箱与工具](/tools/multi-agent-sandbox-tools)。
-
-## 手动安装
-
-如果你更喜欢手动控制而非自动化：
-
-```bash
-# 1. 安装先决条件
-sudo apt update && sudo apt install -y ansible git
-
-# 2. 克隆仓库
-git clone https://github.com/symi/symi-ansible.git
-cd symi-ansible
-
-# 3. 安装 Ansible collections
-ansible-galaxy collection install -r requirements.yml
-
-# 4. 运行 playbook
-./run-playbook.sh
-
-# 或直接运行（然后手动执行 /tmp/symi-setup.sh）
-# ansible-playbook playbook.yml --ask-become-pass
-```
-
-## 更新 Symi
-
-Ansible 安装程序设置 Symi 为手动更新。标准更新流程参见[更新](/install/updating)。
-
-要重新运行 Ansible playbook（例如，用于配置更改）：
-
-```bash
-cd symi-ansible
-./run-playbook.sh
-```
-
-注意：这是幂等的，可以安全地多次运行。
-
-## 故障排除
-
-### 防火墙阻止了我的连接
-
-如果你被锁定：
-
-- 确保你可以先通过 Tailscale VPN 访问
-- SSH 访问（端口 22）始终允许
-- Gateway 网关**仅**通过 Tailscale 访问，这是设计如此
-
-### 服务无法启动
-
-```bash
-# 检查日志
-sudo journalctl -u symi -n 100
-
-# 验证权限
-sudo ls -la /opt/symi
-
-# 测试手动启动
-sudo -i -u symi
-cd ~/symi
-pnpm start
-```
-
-### Docker 沙箱问题
-
-```bash
-# 验证 Docker 正在运行
-sudo systemctl status docker
-
-# 检查沙箱镜像
-sudo docker images | grep symi-sandbox
-
-# 如果缺失则构建沙箱镜像
-cd /opt/symi/symi
-sudo -u symi ./scripts/sandbox-setup.sh
-```
-
-### 提供商登录失败
-
-确保你以 `symi` 用户运行：
-
-```bash
-sudo -i -u symi
-symi channels login
-```
-
-## 高级配置
-
-详细的安全架构和故障排除：
-
-- [安全架构](https://github.com/symi/symi-ansible/blob/main/docs/security.md)
-- [技术详情](https://github.com/symi/symi-ansible/blob/main/docs/architecture.md)
-- [故障排除指南](https://github.com/symi/symi-ansible/blob/main/docs/troubleshooting.md)
-
-## 相关内容
-
-- [symi-ansible](https://github.com/symi/symi-ansible) — 完整部署指南
-- [Docker](/install/docker) — 容器化 Gateway 网关设置
-- [沙箱隔离](/gateway/sandboxing) — 智能体沙箱配置
-- [多智能体沙箱与工具](/tools/multi-agent-sandbox-tools) — 每个智能体的隔离

package/docs/zh-CN/install/bun.md

@@ -1,65 +0,0 @@
----
-read_when:
-  - 你想要最快的本地开发循环（bun + watch）
-  - 你遇到 Bun 安装/补丁/生命周期脚本问题
-summary: Bun 工作流（实验性）：安装及与 pnpm 相比的注意事项
-title: Bun（实验性）
-x-i18n:
-  generated_at: "2026-02-03T07:49:24Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: eb3f4c222b6bae49938d8bf53a0818fe5f5e0c0c3c1adb3e0a832ce8f785e1e3
-  source_path: install/bun.md
-  workflow: 15
----
-
-# Bun（实验性）
-
-目标：使用 **Bun** 运行此仓库（可选，不推荐用于 WhatsApp/Telegram），同时不偏离 pnpm 工作流。
-
-⚠️ **不推荐用于 Gateway 网关运行时**（WhatsApp/Telegram 存在 bug）。生产环境请使用 Node。
-
-## 状态
-
-- Bun 是一个可选的本地运行时，用于直接运行 TypeScript（`bun run …`、`bun --watch …`）。
-- `pnpm` 是构建的默认工具，仍然完全支持（并被一些文档工具使用）。
-- Bun 无法使用 `pnpm-lock.yaml` 并会忽略它。
-
-## 安装
-
-默认：
-
-```sh
-bun install
-```
-
-注意：`bun.lock`/`bun.lockb` 被 gitignore，所以无论哪种方式都不会有仓库变动。如果你想*不写入锁文件*：
-
-```sh
-bun install --no-save
-```
-
-## 构建/测试（Bun）
-
-```sh
-bun run build
-bun run vitest run
-```
-
-## Bun 生命周期脚本（默认被阻止）
-
-除非明确信任（`bun pm untrusted` / `bun pm trust`），Bun 可能会阻止依赖的生命周期脚本。
-对于此仓库，通常被阻止的脚本不是必需的：
-
-- `@whiskeysockets/baileys` `preinstall`：检查 Node 主版本 >= 20（我们运行 Node 22+）。
-- `protobufjs` `postinstall`：发出关于不兼容版本方案的警告（无构建产物）。
-
-如果你遇到真正需要这些脚本的运行时问题，请明确信任它们：
-
-```sh
-bun pm trust @whiskeysockets/baileys protobufjs
-```
-
-## 注意事项
-
-- 一些脚本仍然硬编码 pnpm（例如 `docs:build`、`ui:*`、`protocol:check`）。目前请通过 pnpm 运行这些脚本。

package/docs/zh-CN/install/development-channels.md

@@ -1,81 +0,0 @@
----
-read_when:
-  - 你想在 stable/beta/dev 之间切换
-  - 你正在标记或发布预发布版本
-summary: stable、beta 和 dev 渠道：语义、切换和标签
-title: 开发渠道
-x-i18n:
-  generated_at: "2026-02-03T10:07:21Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 2b01219b7e705044ce39838a0da7c7fa65c719809ab2f8a51e14529064af81bf
-  source_path: install/development-channels.md
-  workflow: 15
----
-
-# 开发渠道
-
-最后更新：2026-01-21
-
-Symi 提供三个更新渠道：
-
-- **stable**：npm dist-tag `latest`。
-- **beta**：npm dist-tag `beta`（测试中的构建）。
-- **dev**：`main` 的移动头（git）。npm dist-tag：`dev`（发布时）。
-
-我们将构建发布到 **beta**，进行测试，然后**将经过验证的构建提升到 `latest`**，
-版本号不变——dist-tag 是 npm 安装的数据源。
-
-## 切换渠道
-
-Git checkout：
-
-```bash
-symi update --channel stable
-symi update --channel beta
-symi update --channel dev
-```
-
-- `stable`/`beta` 检出最新匹配的标签（通常是同一个标签）。
-- `dev` 切换到 `main` 并在上游基础上 rebase。
-
-npm/pnpm 全局安装：
-
-```bash
-symi update --channel stable
-symi update --channel beta
-symi update --channel dev
-```
-
-这会通过相应的 npm dist-tag（`latest`、`beta`、`dev`）进行更新。
-
-当你使用 `--channel` **显式**切换渠道时，Symi 还会对齐安装方式：
-
-- `dev` 确保有一个 git checkout（默认 `~/symi`，可通过 `SYMI_GIT_DIR` 覆盖），
-  更新它，并从该 checkout 安装全局 CLI。
-- `stable`/`beta` 使用匹配的 dist-tag 从 npm 安装。
-
-提示：如果你想同时使用 stable + dev，保留两个克隆并将 Gateway 网关指向 stable 那个。
-
-## 插件和渠道
-
-当你使用 `symi update` 切换渠道时，Symi 还会同步插件来源：
-
-- `dev` 优先使用 git checkout 中的内置插件。
-- `stable` 和 `beta` 恢复 npm 安装的插件包。
-
-## 标签最佳实践
-
-- 为你希望 git checkout 落在的发布版本打标签（`vYYYY.M.D` 或 `vYYYY.M.D-<patch>`）。
-- 保持标签不可变：永远不要移动或重用标签。
-- npm dist-tag 仍然是 npm 安装的数据源：
-  - `latest` → stable
-  - `beta` → 候选构建
-  - `dev` → main 快照（可选）
-
-## macOS 应用可用性
-
-Beta 和 dev 构建可能**不**包含 macOS 应用发布。这没问题：
-
-- git 标签和 npm dist-tag 仍然可以发布。
-- 在发布说明或变更日志中注明"此 beta 无 macOS 构建"。