@symerian/symi 3.0.20 → 3.0.22

package/docs/zh-CN/concepts/streaming.md

@@ -1,131 +0,0 @@
----
-read_when:
-  - 解释流式传输或分块在渠道上如何工作
-  - 更改分块流式传输或渠道分块行为
-  - 调试重复/提前的块回复或草稿流式传输
-summary: 流式传输 + 分块行为（块回复、草稿流式传输、限制）
-title: 流式传输和分块
-x-i18n:
-  generated_at: "2026-02-03T10:05:41Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: f014eb1898c4351b1d6b812223226d91324701e3e809cd0f3faf6679841bc353
-  source_path: concepts/streaming.md
-  workflow: 15
----
-
-# 流式传输 + 分块
-
-Symi 有两个独立的"流式传输"层：
-
-- **分块流式传输（渠道）：** 在助手写入时发出已完成的**块**。这些是普通的渠道消息（不是令牌增量）。
-- **类令牌流式传输（仅限 Telegram）：** 在生成时用部分文本更新**草稿气泡**；最终消息在结束时发送。
-
-目前**没有真正的令牌流式传输**到外部渠道消息。Telegram 草稿流式传输是唯一的部分流式传输界面。
-
-## 分块流式传输（渠道消息）
-
-分块流式传输在助手输出可用时以粗粒度块发送。
-
-```
-模型输出
-  └─ text_delta/events
-       ├─ (blockStreamingBreak=text_end)
-       │    └─ 分块器在缓冲区增长时发出块
-       └─ (blockStreamingBreak=message_end)
-            └─ 分块器在 message_end 时刷新
-                   └─ 渠道发送（块回复）
-```
-
-图例：
-
-- `text_delta/events`：模型流事件（对于非流式模型可能稀疏）。
-- `chunker`：应用最小/最大边界 + 断点偏好的 `EmbeddedBlockChunker`。
-- `channel send`：实际的出站消息（块回复）。
-
-**控制项：**
-
-- `agents.defaults.blockStreamingDefault`：`"on"`/`"off"`（默认关闭）。
-- 渠道覆盖：`*.blockStreaming`（以及每账户变体）可为每个渠道强制设置 `"on"`/`"off"`。
-- `agents.defaults.blockStreamingBreak`：`"text_end"` 或 `"message_end"`。
-- `agents.defaults.blockStreamingChunk`：`{ minChars, maxChars, breakPreference? }`。
-- `agents.defaults.blockStreamingCoalesce`：`{ minChars?, maxChars?, idleMs? }`（发送前合并流式块）。
-- 渠道硬上限：`*.textChunkLimit`（例如 `channels.whatsapp.textChunkLimit`）。
-- 渠道分块模式：`*.chunkMode`（默认 `length`，`newline` 在长度分块之前按空行（段落边界）分割）。
-
-**边界语义：**
-
-- `text_end`：分块器发出时立即流式传输块；在每个 `text_end` 时刷新。
-- `message_end`：等到助手消息完成，然后刷新缓冲的输出。
-
-如果缓冲文本超过 `maxChars`，`message_end` 仍然使用分块器，因此可能在最后发出多个块。
-
-## 分块算法（低/高边界）
-
-块分块由 `EmbeddedBlockChunker` 实现：
-
-- **低边界：** 在缓冲区 >= `minChars` 之前不发出（除非强制）。
-- **高边界：** 优先在 `maxChars` 之前分割；如果强制，则在 `maxChars` 处分割。
-- **断点偏好：** `paragraph` → `newline` → `sentence` → `whitespace` → 硬断点。
-- **代码围栏：** 从不在围栏内分割；当在 `maxChars` 处强制分割时，关闭 + 重新打开围栏以保持 Markdown 有效。
-
-`maxChars` 被限制在渠道 `textChunkLimit` 内，因此你无法超过每渠道的上限。
-
-## 合并（合并流式块）
-
-启用分块流式传输时，Symi 可以在发送前**合并连续的块分块**。这减少了"单行刷屏"，同时仍提供渐进式输出。
-
-- 合并在**空闲间隙**（`idleMs`）后刷新。
-- 缓冲区受 `maxChars` 限制，超过时将刷新。
-- `minChars` 防止微小片段发送，直到累积足够文本（最终刷新始终发送剩余文本）。
-- 连接符从 `blockStreamingChunk.breakPreference` 派生（`paragraph` → `\n\n`，`newline` → `\n`，`sentence` → 空格）。
-- 渠道覆盖通过 `*.blockStreamingCoalesce` 可用（包括每账户配置）。
-
-## 块之间的类人节奏
-
-启用分块流式传输时，你可以在块回复之间添加**随机暂停**（在第一个块之后）。这使多气泡响应感觉更自然。
-
-- 配置：`agents.defaults.humanDelay`（通过 `agents.list[].humanDelay` 按智能体覆盖）。
-- 模式：`off`（默认）、`natural`（800–2500ms）、`custom`（`minMs`/`maxMs`）。
-- 仅适用于**块回复**，不适用于最终回复或工具摘要。
-
-## "流式传输块或全部内容"
-
-这映射到：
-
-- **流式传输块：** `blockStreamingDefault: "on"` + `blockStreamingBreak: "text_end"`（边生成边发出）。非 Telegram 渠道还需要 `*.blockStreaming: true`。
-- **最后流式传输全部内容：** `blockStreamingBreak: "message_end"`（刷新一次，如果很长可能有多个块）。
-- **无分块流式传输：** `blockStreamingDefault: "off"`（只有最终回复）。
-
-**渠道说明：** 对于非 Telegram 渠道，分块流式传输**默认关闭**，除非 `*.blockStreaming` 明确设置为 `true`。Telegram 可以在没有块回复的情况下流式传输草稿（`channels.telegram.streamMode`）。
-
-配置位置提醒：`blockStreaming*` 默认值位于 `agents.defaults` 下，而不是根配置。
-
-## Telegram 草稿流式传输（类令牌）
-
-Telegram 是唯一支持草稿流式传输的渠道：
-
-- 在**带主题的私聊**中使用 Bot API `sendMessageDraft`。
-- `channels.telegram.streamMode: "partial" | "block" | "off"`。
-  - `partial`：用最新的流式文本更新草稿。
-  - `block`：以分块方式更新草稿（相同的分块器规则）。
-  - `off`：无草稿流式传输。
-- 草稿分块配置（仅用于 `streamMode: "block"`）：`channels.telegram.draftChunk`（默认值：`minChars: 200`，`maxChars: 800`）。
-- 草稿流式传输与分块流式传输分开；块回复默认关闭，仅在非 Telegram 渠道上通过 `*.blockStreaming: true` 启用。
-- 最终回复仍然是普通消息。
-- `/reasoning stream` 将推理写入草稿气泡（仅限 Telegram）。
-
-当草稿流式传输活跃时，Symi 会为该回复禁用分块流式传输以避免双重流式传输。
-
-```
-Telegram（私聊 + 主题）
-  └─ sendMessageDraft（草稿气泡）
-       ├─ streamMode=partial → 更新最新文本
-       └─ streamMode=block   → 分块器更新草稿
-  └─ 最终回复 → 普通消息
-```
-
-图例：
-
-- `sendMessageDraft`：Telegram 草稿气泡（不是真正的消息）。
-- `final reply`：普通 Telegram 消息发送。

package/docs/zh-CN/concepts/system-prompt.md

@@ -1,99 +0,0 @@
----
-read_when:
-  - 编辑系统提示词文本、工具列表或时间/心跳部分
-  - 更改工作区引导或 Skills 注入行为
-summary: Symi 系统提示词包含的内容及其组装方式
-title: 系统提示词
-x-i18n:
-  generated_at: "2026-02-03T07:46:58Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: bef4b2674ba0414ce28fd08a4c3ead0e0ebe989e7df3c88ca8a0b2abfec2a50b
-  source_path: concepts/system-prompt.md
-  workflow: 15
----
-
-# 系统提示词
-
-Symi 为每次智能体运行构建自定义系统提示词。该提示词由 **Symi 拥有**，不使用 pi-coding-agent 默认提示词。
-
-该提示词由 Symi 组装并注入到每次智能体运行中。
-
-## 结构
-
-该提示词设计紧凑，使用固定部分：
-
-- **Tooling**：当前工具列表 + 简短描述。
-- **Safety**：简短的防护提醒，避免追求权力的行为或绕过监督。
-- **Skills**（如果可用）：告诉模型如何按需加载 Skill 指令。
-- **Symi Self-Update**：如何运行 `config.apply` 和 `update.run`。
-- **Workspace**：工作目录（`agents.defaults.workspace`）。
-- **Documentation**：Symi 文档的本地路径（仓库或 npm 包）以及何时阅读它们。
-- **Workspace Files (injected)**：表示下方包含引导文件。
-- **Sandbox**（启用时）：表示沙箱隔离运行时、沙箱路径，以及是否可用提权执行。
-- **Current Date & Time**：用户本地时间、时区和时间格式。
-- **Reply Tags**：支持的提供商的可选回复标签语法。
-- **Heartbeats**：心跳提示词和确认行为。
-- **Runtime**：主机、操作系统、node、模型、仓库根目录（检测到时）、思考级别（一行）。
-- **Reasoning**：当前可见性级别 + /reasoning 切换提示。
-
-系统提示词中的安全防护是建议性的。它们指导模型行为但不强制执行策略。使用工具策略、执行审批、沙箱隔离和渠道允许列表进行硬性执行；运维人员可以按设计禁用这些。
-
-## 提示词模式
-
-Symi 可以为子智能体渲染更小的系统提示词。运行时为每次运行设置一个 `promptMode`（不是面向用户的配置）：
-
-- `full`（默认）：包含上述所有部分。
-- `minimal`：用于子智能体；省略 **Skills**、**Memory Recall**、**Symi Self-Update**、**Model Aliases**、**User Identity**、**Reply Tags**、**Messaging**、**Silent Replies** 和 **Heartbeats**。Tooling、**Safety**、Workspace、Sandbox、Current Date & Time（已知时）、Runtime 和注入的上下文仍然可用。
-- `none`：仅返回基本身份行。
-
-当 `promptMode=minimal` 时，额外注入的提示词标记为 **Subagent Context** 而不是 **Group Chat Context**。
-
-## 工作区引导注入
-
-引导文件被修剪后附加在 **Project Context** 下，这样模型无需显式读取即可看到身份和配置上下文：
-
-- `AGENTS.md`
-- `SYMICORE.md`
-- `TOOLS.md`
-- `IDENTITY.md`
-- `USER.md`
-- `SYMIPULSE.md`
-- `BOOTSTRAP.md`（仅在全新工作区上）
-
-大文件会带截断标记被截断。每个文件的最大大小由 `agents.defaults.bootstrapMaxChars` 控制（默认：20000）。缺失的文件会注入一个简短的缺失文件标记。
-
-内部钩子可以通过 `agent:bootstrap` 拦截此步骤以修改或替换注入的引导文件（例如将 `SYMICORE.md` 替换为其他角色）。
-
-要检查每个注入文件贡献了多少（原始 vs 注入、截断，加上工具 schema 开销），使用 `/context list` 或 `/context detail`。参见[上下文](/concepts/context)。
-
-## 时间处理
-
-当用户时区已知时，系统提示词包含专用的 **Current Date & Time** 部分。为保持提示词缓存稳定，它现在只包含**时区**（没有动态时钟或时间格式）。
-
-当智能体需要当前时间时使用 `session_status`；状态卡片包含时间戳行。
-
-配置方式：
-
-- `agents.defaults.userTimezone`
-- `agents.defaults.timeFormat`（`auto` | `12` | `24`）
-
-完整行为详情参见[日期和时间](/date-time)。
-
-## Skills
-
-当存在符合条件的 Skills 时，Symi 注入一个紧凑的**可用 Skills 列表**（`formatSkillsForPrompt`），其中包含每个 Skill 的**文件路径**。提示词指示模型使用 `read` 加载列出位置（工作区、托管或内置）的 SKILL.md。如果没有符合条件的 Skills，则省略 Skills 部分。
-
-```
-<available_skills>
-  <skill>
-    <name>...</name>
-    <description>...</description>
-    <location>...</location>
-  </skill>
-</available_skills>
-```
-
-这使基础提示词保持小巧，同时仍然支持有针对性的 Skill 使用。
-
-## 文档

package/docs/zh-CN/concepts/timezone.md

@@ -1,94 +0,0 @@
----
-read_when:
-  - 需要了解时间戳如何为模型进行规范化
-  - 为系统提示词配置用户时区
-summary: 智能体、信封和提示词的时区处理
-title: 时区
-x-i18n:
-  generated_at: "2026-02-01T20:24:13Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 9ee809c96897db1126c7efcaa5bf48a63cdcb2092abd4b3205af224ebd882766
-  source_path: concepts/timezone.md
-  workflow: 14
----
-
-# 时区
-
-Symi 对时间戳进行标准化，使模型看到**单一的参考时间**。
-
-## 消息信封（默认为本地时间）
-
-入站消息被包装在如下信封中：
-
-```
-[Provider ... 2026-01-05 16:26 PST] message text
-```
-
-信封中的时间戳**默认为主机本地时间**，精确到分钟。
-
-你可以通过以下配置进行覆盖：
-
-```json5
-{
-  agents: {
-    defaults: {
-      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA 时区
-      envelopeTimestamp: "on", // "on" | "off"
-      envelopeElapsed: "on", // "on" | "off"
-    },
-  },
-}
-```
-
-- `envelopeTimezone: "utc"` 使用 UTC。
-- `envelopeTimezone: "user"` 使用 `agents.defaults.userTimezone`（回退到主机时区）。
-- 使用显式 IANA 时区（例如 `"Europe/Vienna"`）可设置固定偏移量。
-- `envelopeTimestamp: "off"` 从信封头中移除绝对时间戳。
-- `envelopeElapsed: "off"` 移除已用时间后缀（`+2m` 样式）。
-
-### 示例
-
-**本地时间（默认）：**
-
-```
-[Signal Alice +1555 2026-01-18 00:19 PST] hello
-```
-
-**固定时区：**
-
-```
-[Signal Alice +1555 2026-01-18 06:19 GMT+1] hello
-```
-
-**已用时间：**
-
-```
-[Signal Alice +1555 +2m 2026-01-18T05:19Z] follow-up
-```
-
-## 工具负载（原始提供商数据 + 规范化字段）
-
-- `timestampMs`（UTC 纪元毫秒数）
-- `timestampUtc`（ISO 8601 UTC 字符串）
-
-原始提供商字段保持不变。
-
-## 系统提示词的用户时区
-
-设置 `agents.defaults.userTimezone` 来告知模型用户的本地时区。如果未设置，Symi 会在运行时**解析主机时区**（无需写入配置）。
-
-```json5
-{
-  agents: { defaults: { userTimezone: "America/Chicago" } },
-}
-```
-
-系统提示词包含：
-
-- `Current Date & Time` 部分，显示本地时间和时区
-- `Time format: 12-hour` 或 `24-hour`
-
-你可以通过 `agents.defaults.timeFormat`（`auto` | `12` | `24`）控制提示词格式。
-
-详情参见[日期与时间](/date-time)的完整行为和示例。

package/docs/zh-CN/concepts/typebox.md

@@ -1,284 +0,0 @@
----
-read_when:
-  - 更新协议模式或代码生成
-summary: TypeBox 模式作为 Gateway 网关协议的唯一事实来源
-title: TypeBox
-x-i18n:
-  generated_at: "2026-02-03T07:47:23Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 233800f4f5fabe8ed0e1b3d8aded2eca27252e08c9b0b24ea9c6293e9282c918
-  source_path: concepts/typebox.md
-  workflow: 15
----
-
-# TypeBox 作为协议的事实来源
-
-最后更新：2026-01-10
-
-TypeBox 是一个 TypeScript 优先的模式库。我们用它来定义 **Gateway 网关 WebSocket 协议**（握手、请求/响应、服务器事件）。这些模式驱动**运行时验证**、**JSON Schema 导出**和 macOS 应用的 **Swift 代码生成**。一个事实来源；其他一切都是生成的。
-
-如果你想了解更高层次的协议上下文，请从 [Gateway 网关架构](/concepts/architecture)开始。
-
-## 心智模型（30 秒）
-
-每个 Gateway 网关 WS 消息都是以下三种帧之一：
-
-- **Request**：`{ type: "req", id, method, params }`
-- **Response**：`{ type: "res", id, ok, payload | error }`
-- **Event**：`{ type: "event", event, payload, seq?, stateVersion? }`
-
-第一个帧**必须**是 `connect` 请求。之后，客户端可以调用方法（例如 `health`、`send`、`chat.send`）并订阅事件（例如 `presence`、`tick`、`agent`）。
-
-连接流程（最小）：
-
-```
-Client                    Gateway
-  |---- req:connect -------->|
-  |<---- res:hello-ok --------|
-  |<---- event:tick ----------|
-  |---- req:health ---------->|
-  |<---- res:health ----------|
-```
-
-常用方法 + 事件：
-
-| 类别 | 示例                                                      | 说明                            |
-| ---- | --------------------------------------------------------- | ------------------------------- |
-| 核心 | `connect`、`health`、`status`                             | `connect` 必须是第一个          |
-| 消息 | `send`、`poll`、`agent`、`agent.wait`                     | 有副作用的需要 `idempotencyKey` |
-| 聊天 | `chat.history`、`chat.send`、`chat.abort`、`chat.inject`  | WebChat 使用这些                |
-| 会话 | `sessions.list`、`sessions.patch`、`sessions.delete`      | 会话管理                        |
-| 节点 | `node.list`、`node.invoke`、`node.pair.*`                 | Gateway 网关 WS + 节点操作      |
-| 事件 | `tick`、`presence`、`agent`、`chat`、`health`、`shutdown` | 服务器推送                      |
-
-权威列表在 `src/gateway/server.ts`（`METHODS`、`EVENTS`）中。
-
-## 模式所在位置
-
-- 源码：`src/gateway/protocol/schema.ts`
-- 运行时验证器（AJV）：`src/gateway/protocol/index.ts`
-- 服务器握手 + 方法分发：`src/gateway/server.ts`
-- 节点客户端：`src/gateway/client.ts`
-- 生成的 JSON Schema：`dist/protocol.schema.json`
-- 生成的 Swift 模型：`apps/macos/Sources/SymiProtocol/GatewayModels.swift`
-
-## 当前流程
-
-- `pnpm protocol:gen`
-  - 将 JSON Schema（draft‑07）写入 `dist/protocol.schema.json`
-- `pnpm protocol:gen:swift`
-  - 生成 Swift Gateway 网关模型
-- `pnpm protocol:check`
-  - 运行两个生成器并验证输出已提交
-
-## 模式在运行时的使用方式
-
-- **服务器端**：每个入站帧都用 AJV 验证。握手仅接受参数匹配 `ConnectParams` 的 `connect` 请求。
-- **客户端**：JS 客户端在使用之前验证事件和响应帧。
-- **方法表面**：Gateway 网关在 `hello-ok` 中公布支持的 `methods` 和 `events`。
-
-## 示例帧
-
-Connect（第一条消息）：
-
-```json
-{
-  "type": "req",
-  "id": "c1",
-  "method": "connect",
-  "params": {
-    "minProtocol": 2,
-    "maxProtocol": 2,
-    "client": {
-      "id": "symi-macos",
-      "displayName": "macos",
-      "version": "1.0.0",
-      "platform": "macos 15.1",
-      "mode": "ui",
-      "instanceId": "A1B2"
-    }
-  }
-}
-```
-
-Hello-ok 响应：
-
-```json
-{
-  "type": "res",
-  "id": "c1",
-  "ok": true,
-  "payload": {
-    "type": "hello-ok",
-    "protocol": 2,
-    "server": { "version": "dev", "connId": "ws-1" },
-    "features": { "methods": ["health"], "events": ["tick"] },
-    "snapshot": {
-      "presence": [],
-      "health": {},
-      "stateVersion": { "presence": 0, "health": 0 },
-      "uptimeMs": 0
-    },
-    "policy": { "maxPayload": 1048576, "maxBufferedBytes": 1048576, "tickIntervalMs": 30000 }
-  }
-}
-```
-
-请求 + 响应：
-
-```json
-{ "type": "req", "id": "r1", "method": "health" }
-```
-
-```json
-{ "type": "res", "id": "r1", "ok": true, "payload": { "ok": true } }
-```
-
-事件：
-
-```json
-{ "type": "event", "event": "tick", "payload": { "ts": 1730000000 }, "seq": 12 }
-```
-
-## 最小客户端（Node.js）
-
-最小可用流程：connect + health。
-
-```ts
-import { WebSocket } from "ws";
-
-const ws = new WebSocket("ws://127.0.0.1:18789");
-
-ws.on("open", () => {
-  ws.send(
-    JSON.stringify({
-      type: "req",
-      id: "c1",
-      method: "connect",
-      params: {
-        minProtocol: 3,
-        maxProtocol: 3,
-        client: {
-          id: "cli",
-          displayName: "example",
-          version: "dev",
-          platform: "node",
-          mode: "cli",
-        },
-      },
-    }),
-  );
-});
-
-ws.on("message", (data) => {
-  const msg = JSON.parse(String(data));
-  if (msg.type === "res" && msg.id === "c1" && msg.ok) {
-    ws.send(JSON.stringify({ type: "req", id: "h1", method: "health" }));
-  }
-  if (msg.type === "res" && msg.id === "h1") {
-    console.log("health:", msg.payload);
-    ws.close();
-  }
-});
-```
-
-## 实践示例：端到端添加方法
-
-示例：添加一个新的 `system.echo` 请求，返回 `{ ok: true, text }`。
-
-1. **模式（事实来源）**
-
-添加到 `src/gateway/protocol/schema.ts`：
-
-```ts
-export const SystemEchoParamsSchema = Type.Object(
-  { text: NonEmptyString },
-  { additionalProperties: false },
-);
-
-export const SystemEchoResultSchema = Type.Object(
-  { ok: Type.Boolean(), text: NonEmptyString },
-  { additionalProperties: false },
-);
-```
-
-将两者添加到 `ProtocolSchemas` 并导出类型：
-
-```ts
-  SystemEchoParams: SystemEchoParamsSchema,
-  SystemEchoResult: SystemEchoResultSchema,
-```
-
-```ts
-export type SystemEchoParams = Static<typeof SystemEchoParamsSchema>;
-export type SystemEchoResult = Static<typeof SystemEchoResultSchema>;
-```
-
-2. **验证**
-
-在 `src/gateway/protocol/index.ts` 中，导出一个 AJV 验证器：
-
-```ts
-export const validateSystemEchoParams = ajv.compile<SystemEchoParams>(SystemEchoParamsSchema);
-```
-
-3. **服务器行为**
-
-在 `src/gateway/server-methods/system.ts` 中添加处理程序：
-
-```ts
-export const systemHandlers: GatewayRequestHandlers = {
-  "system.echo": ({ params, respond }) => {
-    const text = String(params.text ?? "");
-    respond(true, { ok: true, text });
-  },
-};
-```
-
-在 `src/gateway/server-methods.ts` 中注册（已合并 `systemHandlers`），然后将 `"system.echo"` 添加到 `src/gateway/server.ts` 中的 `METHODS`。
-
-4. **重新生成**
-
-```bash
-pnpm protocol:check
-```
-
-5. **测试 + 文档**
-
-在 `src/gateway/server.*.test.ts` 中添加服务器测试，并在文档中记录该方法。
-
-## Swift 代码生成行为
-
-Swift 生成器输出：
-
-- 带有 `req`、`res`、`event` 和 `unknown` 情况的 `GatewayFrame` 枚举
-- 强类型的 payload 结构体/枚举
-- `ErrorCode` 值和 `GATEWAY_PROTOCOL_VERSION`
-
-未知的帧类型保留为原始 payload 以实现向前兼容。
-
-## 版本控制 + 兼容性
-
-- `PROTOCOL_VERSION` 在 `src/gateway/protocol/schema.ts` 中。
-- 客户端发送 `minProtocol` + `maxProtocol`；服务器拒绝不匹配的。
-- Swift 模型保留未知帧类型以避免破坏旧客户端。
-
-## 模式模式和约定
-
-- 大多数对象使用 `additionalProperties: false` 以实现严格的 payload。
-- `NonEmptyString` 是 ID 和方法/事件名称的默认值。
-- 顶层 `GatewayFrame` 在 `type` 上使用**鉴别器**。
-- 有副作用的方法通常需要在 params 中包含 `idempotencyKey`（示例：`send`、`poll`、`agent`、`chat.send`）。
-
-## 实时 schema JSON
-
-生成的 JSON Schema 在仓库的 `dist/protocol.schema.json` 中。发布的原始文件通常可在以下位置获取：
-
-- https://raw.githubusercontent.com/symi/symi/main/dist/protocol.schema.json
-
-## 当你更改模式时
-
-1. 更新 TypeBox 模式。
-2. 运行 `pnpm protocol:check`。
-3. 提交重新生成的 schema + Swift 模型。

package/docs/zh-CN/concepts/typing-indicators.md

@@ -1,74 +0,0 @@
----
-read_when:
-  - 更改输入指示器的行为或默认设置
-summary: Symi 何时显示输入指示器以及如何调整它们
-title: 输入指示器
-x-i18n:
-  generated_at: "2026-02-01T20:24:47Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 8ee82d02829c4ff58462be8bf5bb52f23f519aeda816c2fd8a583e7a317a2e98
-  source_path: concepts/typing-indicators.md
-  workflow: 14
----
-
-# 输入指示器
-
-在运行活跃期间，输入指示器会发送到聊天渠道。使用
-`agents.defaults.typingMode` 控制输入指示器**何时**开始显示，使用 `typingIntervalSeconds`
-控制**刷新频率**。
-
-## 默认行为
-
-当 `agents.defaults.typingMode` **未设置**时，Symi 保持旧版行为：
-
-- **私聊**：模型循环开始后立即显示输入指示器。
-- **群聊中被提及**：立即显示输入指示器。
-- **群聊中未被提及**：仅在消息文本开始流式传输时显示输入指示器。
-- **心跳运行**：输入指示器禁用。
-
-## 模式
-
-将 `agents.defaults.typingMode` 设置为以下值之一：
-
-- `never` — 永远不显示输入指示器。
-- `instant` — **模型循环开始后立即**显示输入指示器，即使运行最终只返回静默回复令牌。
-- `thinking` — 在**第一个推理增量**时开始显示输入指示器（需要运行时设置
-  `reasoningLevel: "stream"`）。
-- `message` — 在**第一个非静默文本增量**时开始显示输入指示器（忽略
-  `NO_REPLY` 静默令牌）。
-
-触发时机从晚到早的顺序：
-`never` → `message` → `thinking` → `instant`
-
-## 配置
-
-```json5
-{
-  agent: {
-    typingMode: "thinking",
-    typingIntervalSeconds: 6,
-  },
-}
-```
-
-可以按会话覆盖模式或刷新频率：
-
-```json5
-{
-  session: {
-    typingMode: "message",
-    typingIntervalSeconds: 4,
-  },
-}
-```
-
-## 注意事项
-
-- `message` 模式不会为纯静默回复显示输入指示器（例如用于抑制输出的 `NO_REPLY`
-  令牌）。
-- `thinking` 仅在运行流式传输推理时触发（`reasoningLevel: "stream"`）。
-  如果模型未产生推理增量，则不会显示输入指示器。
-- 无论使用何种模式，心跳运行都不会显示输入指示器。
-- `typingIntervalSeconds` 控制的是**刷新频率**，而非开始时间。
-  默认值为 6 秒。