@symerian/symi 3.0.21 → 3.0.22

package/docs/zh-CN/start/onboarding.md

@@ -1,105 +0,0 @@
----
-read_when:
-  - 设计 macOS 新手引导助手
-  - 实现认证或身份设置
-summary: Symi 的首次运行新手引导流程（macOS 应用）
-title: 新手引导
-x-i18n:
-  generated_at: "2026-02-03T07:54:07Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: ae883b2deb1f9032be7c47a04d67e1741dffbdcc4445de1e0bbaa976e606bc10
-  source_path: start/onboarding.md
-  workflow: 15
----
-
-# 新手引导（macOS 应用）
-
-本文档描述**当前**的首次运行新手引导流程。目标是流畅的"第 0 天"体验：选择 Gateway 网关运行位置、连接认证、运行向导，然后让智能体自行引导。
-
-## 页面顺序（当前）
-
-1. 欢迎 + 安全提示
-2. **Gateway 网关选择**（本地 / 远程 / 稍后配置）
-3. **认证（Anthropic OAuth）** — 仅限本地
-4. **设置向导**（Gateway 网关驱动）
-5. **权限**（TCC 提示）
-6. **CLI**（可选）
-7. **新手引导聊天**（专用会话）
-8. 就绪
-
-## 1) 欢迎 + 安全提示
-
-阅读显示的安全提示并相应决定。
-
-## 2) 本地 vs 远程
-
-**Gateway 网关**在哪里运行？
-
-- **本地（此 Mac）：** 新手引导可以在本地运行 OAuth 流程并写入凭证。
-- **远程（通过 SSH/Tailnet）：** 新手引导**不会**在本地运行 OAuth；凭证必须存在于 Gateway 网关主机上。
-- **稍后配置：** 跳过设置并保持应用未配置状态。
-
-Gateway 网关认证提示：
-
-- 向导现在即使对于 loopback 也会生成**令牌**，因此本地 WS 客户端必须认证。
-- 如果你禁用认证，任何本地进程都可以连接；仅在完全受信任的机器上使用。
-- 对于多机器访问或非 loopback 绑定，使用**令牌**。
-
-## 3) 仅限本地的认证（Anthropic OAuth）
-
-macOS 应用支持 Anthropic OAuth（Claude Pro/Max）。流程：
-
-- 打开浏览器进行 OAuth（PKCE）
-- 要求用户粘贴 `code#state` 值
-- 将凭证写入 `~/.symi/credentials/oauth.json`
-
-其他提供商（OpenAI、自定义 API）目前通过环境变量或配置文件配置。
-
-## 4) 设置向导（Gateway 网关驱动）
-
-应用可以运行与 CLI 相同的设置向导。这使新手引导与 Gateway 网关端行为保持同步，避免在 SwiftUI 中重复逻辑。
-
-## 5) 权限
-
-新手引导请求以下所需的 TCC 权限：
-
-- 通知
-- 辅助功能
-- 屏幕录制
-- 麦克风 / 语音识别
-- 自动化（AppleScript）
-
-## 6) CLI（可选）
-
-应用可以通过 npm/pnpm 安装全局 `symi` CLI，以便终端工作流和 launchd 任务开箱即用。
-
-## 7) 新手引导聊天（专用会话）
-
-设置完成后，应用会打开一个专用的新手引导聊天会话，让智能体可以自我介绍并指导后续步骤。这使首次运行指导与你的正常对话分开。
-
-## 智能体引导仪式
-
-在首次智能体运行时，Symi 会引导一个工作区（默认 `~/.symi/workspace`）：
-
-- 初始化 `AGENTS.md`、`BOOTSTRAP.md`、`IDENTITY.md`、`USER.md`
-- 运行简短的问答仪式（一次一个问题）
-- 将身份 + 偏好写入 `IDENTITY.md`、`USER.md`、`SYMICORE.md`
-- 完成后删除 `BOOTSTRAP.md`，使其只运行一次
-
-## 可选：Gmail 钩子（手动）
-
-Gmail Pub/Sub 设置目前是手动步骤。使用：
-
-```bash
-symi webhooks gmail setup --account you@gmail.com
-```
-
-参阅 [/automation/gmail-pubsub](/automation/gmail-pubsub) 了解详情。
-
-## 远程模式说明
-
-当 Gateway 网关在另一台机器上运行时，凭证和工作区文件存储在**该主机上**。如果你需要在远程模式下使用 OAuth，请在 Gateway 网关主机上创建：
-
-- `~/.symi/credentials/oauth.json`
-- `~/.symi/agents/<agentId>/agent/auth-profiles.json`

package/docs/zh-CN/start/quickstart.md

@@ -1,88 +0,0 @@
----
-read_when:
-  - 你希望以最快的方式从安装到运行一个可用的 Gateway 网关
-summary: 安装 Symi，完成 Gateway 网关新手引导，并配对你的第一个渠道。
-title: 快速开始
-x-i18n:
-  generated_at: "2026-02-04T17:53:21Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 3c5da65996f89913cd115279ae21dcab794eadd14595951b676d8f7864fbbe2d
-  source_path: start/quickstart.md
-  workflow: 15
----
-
-<Note>
-Symi 需要 Node 22 或更新版本。
-</Note>
-
-## 安装
-
-<Tabs>
-  <Tab title="npm">
-    ```bash
-    npm install -g @symerian/symi@latest
-    ```
-  </Tab>
-  <Tab title="pnpm">
-    ```bash
-    pnpm add -g symi@latest
-    ```
-  </Tab>
-</Tabs>
-
-## 新手引导并运行 Gateway 网关
-
-<Steps>
-  <Step title="新手引导并安装服务">
-    ```bash
-    symi onboard --install-daemon
-    ```
-  </Step>
-  <Step title="配对 WhatsApp">
-    ```bash
-    symi channels login
-    ```
-  </Step>
-  <Step title="启动 Gateway 网关">
-    ```bash
-    symi gateway --port 18789
-    ```
-  </Step>
-</Steps>
-
-完成新手引导后，Gateway 网关将通过用户服务运行。你也可以使用 `symi gateway` 手动启动。
-
-<Info>
-之后在 npm 安装和 git 安装之间切换非常简单。安装另一种方式后，运行
-`symi doctor` 即可更新 Gateway 网关服务入口点。
-</Info>
-
-## 从源码安装（开发）
-
-```bash
-git clone https://github.com/symi/symi.git
-cd symi
-pnpm install
-pnpm ui:build # 首次运行时会自动安装 UI 依赖
-pnpm build
-symi onboard --install-daemon
-```
-
-如果你还没有全局安装，可以在仓库目录中通过 `pnpm symi ...` 运行新手引导。
-
-## 多实例快速开始（可选）
-
-```bash
-SYMI_CONFIG_PATH=~/.symi/a.json \
-SYMI_STATE_DIR=~/.symi-a \
-symi gateway --port 19001
-```
-
-## 发送测试消息
-
-需要一个正在运行的 Gateway 网关。
-
-```bash
-symi message send --target +15555550123 --message "Hello from Symi"
-```

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

@@ -1,151 +0,0 @@
----
-read_when:
-  - 设置新机器
-  - 你想要"最新最好的"而不破坏你的个人设置
-summary: 设置指南：在保持最新的同时保持你的 Symi 设置个性化
-title: 设置
-x-i18n:
-  generated_at: "2026-02-03T07:54:27Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: b7f4bd657d0df4feb5035c9f5ee727f9c67b991e9cedfc7768f99d010553fa01
-  source_path: start/setup.md
-  workflow: 15
----
-
-# 设置
-
-最后更新：2026-01-01
-
-## 太长不看
-
-- **个性化设置存放在仓库之外：** `~/.symi/workspace`（工作区）+ `~/.symi/symi.json`（配置）。
-- **稳定工作流：** 安装 macOS 应用；让它运行内置的 Gateway 网关。
-- **前沿工作流：** 通过 `pnpm gateway:watch` 自己运行 Gateway 网关，然后让 macOS 应用以本地模式连接。
-
-## 先决条件（从源码）
-
-- Node `>=22`
-- `pnpm`
-- Docker（可选；仅用于容器化设置/e2e — 参阅 [Docker](/install/docker)）
-
-## 个性化策略（让更新不会造成问题）
-
-如果你想要"100% 为我定制"*并且*易于更新，将你的自定义内容保存在：
-
-- **配置：** `~/.symi/symi.json`（JSON/JSON5 格式）
-- **工作区：** `~/.symi/workspace`（Skills、提示、记忆；将其设为私有 git 仓库）
-
-引导一次：
-
-```bash
-symi setup
-```
-
-在此仓库内部，使用本地 CLI 入口：
-
-```bash
-symi setup
-```
-
-如果你还没有全局安装，通过 `pnpm symi setup` 运行它。
-
-## 稳定工作流（macOS 应用优先）
-
-1. 安装并启动 **Symi.app**（菜单栏）。
-2. 完成新手引导/权限检查清单（TCC 提示）。
-3. 确保 Gateway 网关是**本地**并正在运行（应用管理它）。
-4. 链接表面（示例：WhatsApp）：
-
-```bash
-symi channels login
-```
-
-5. 完整性检查：
-
-```bash
-symi health
-```
-
-如果你的构建版本中没有新手引导：
-
-- 运行 `symi setup`，然后 `symi channels login`，然后手动启动 Gateway 网关（`symi gateway`）。
-
-## 前沿工作流（在终端中运行 Gateway 网关）
-
-目标：开发 TypeScript Gateway 网关，获得热重载，保持 macOS 应用 UI 连接。
-
-### 0)（可选）也从源码运行 macOS 应用
-
-如果你也想让 macOS 应用保持前沿：
-
-```bash
-./scripts/restart-mac.sh
-```
-
-### 1) 启动开发 Gateway 网关
-
-```bash
-pnpm install
-pnpm gateway:watch
-```
-
-`gateway:watch` 以监视模式运行 Gateway 网关，并在 TypeScript 更改时重新加载。
-
-### 2) 将 macOS 应用指向你正在运行的 Gateway 网关
-
-在 **Symi.app** 中：
-
-- 连接模式：**本地**
-  应用将连接到在配置端口上运行的 Gateway 网关。
-
-### 3) 验证
-
-- 应用内 Gateway 网关状态应显示 **"Using existing gateway …"**
-- 或通过 CLI：
-
-```bash
-symi health
-```
-
-### 常见陷阱
-
-- **端口错误：** Gateway 网关 WS 默认为 `ws://127.0.0.1:18789`；保持应用 + CLI 在同一端口上。
-- **状态存储位置：**
-  - 凭证：`~/.symi/credentials/`
-  - 会话：`~/.symi/agents/<agentId>/sessions/`
-  - 日志：`/tmp/symi/`
-
-## 凭证存储映射
-
-在调试认证或决定备份什么时使用此映射：
-
-- **WhatsApp**：`~/.symi/credentials/whatsapp/<accountId>/creds.json`
-- **Telegram bot token**：配置/环境变量或 `channels.telegram.tokenFile`
-- **Slack tokens**：配置/环境变量（`channels.slack.*`）
-- **配对允许列表**：`~/.symi/credentials/<channel>-allowFrom.json`
-- **模型认证配置文件**：`~/.symi/agents/<agentId>/agent/auth-profiles.json`
-- **旧版 OAuth 导入**：`~/.symi/credentials/oauth.json`
-  更多详情：[安全](/gateway/security#credential-storage-map)。
-
-## 更新（不破坏你的设置）
-
-- 将 `~/.symi/workspace` 和 `~/.symi/` 保持为"你的东西"；不要将个人提示/配置放入 `symi` 仓库。
-- 更新源码：`git pull` + `pnpm install`（当锁文件更改时）+ 继续使用 `pnpm gateway:watch`。
-
-## Linux（systemd 用户服务）
-
-Linux 安装使用 systemd **用户**服务。默认情况下，systemd 在注销/空闲时停止用户服务，这会终止 Gateway 网关。新手引导会尝试为你启用 lingering（可能提示 sudo）。如果仍然关闭，运行：
-
-```bash
-sudo loginctl enable-linger $USER
-```
-
-对于常驻或多用户服务器，考虑使用**系统**服务而不是用户服务（不需要 lingering）。参阅 [Gateway 网关运行手册](/gateway) 了解 systemd 说明。
-
-## 相关文档
-
-- [Gateway 网关运行手册](/gateway)（标志、监督、端口）
-- [Gateway 网关配置](/gateway/configuration)（配置模式 + 示例）
-- [Symi 助手设置](/start/symi)
-- [macOS 应用](/platforms/macos)（Gateway 网关生命周期）