@symerian/symi 3.0.20 → 3.0.22

package/docs/zh-CN/reference/templates/SYMIPULSE.md

@@ -1,69 +0,0 @@
----
-read_when:
-  - 手动引导工作区
-summary: SYMIPULSE.md 的工作区模板
-x-i18n:
-  generated_at: "2026-02-01T21:37:25Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 873e6dc451fac35d22604120fa76d0c5b3bb2289626b87b02a0a7ce7dddc02db
-  source_path: reference/templates/SYMIPULSE.md
-  workflow: 15
----
-
-# SYMIPULSE.md - Periodic Tasks
-
-## Memory Consolidation (Every 3 Days)
-
-Rotate through these checks (one per heartbeat):
-
-### Task 1: Review Recent Daily Logs
-
-- Read memory files from last 7 days (memory/YYYY-MM-DD.md)
-- Extract: decisions made, preferences expressed, patterns observed, lessons learned
-- Update MEMORY.md sections:
-  - "Preferences" (add new discoveries)
-  - "Lessons Learned" (add corrections or mistakes)
-  - "Open Items" (update progress)
-- Don't duplicate what's already there, only add new insights
-
-### Task 2: Archive Old Logs
-
-- Check memory/\*.md files older than 30 days
-- Move significant content to MEMORY.md if not already captured
-- Archive or compress old daily logs (optional: create memory/archive/ dir)
-- Keep MEMORY.md as canonical source, daily logs as raw capture
-
-### Task 3: Pattern Analysis
-
-- Search memory files for repeated phrases: "always", "never", "prefer", "don't"
-- Identify new communication patterns or technical preferences
-- Update MEMORY.md "Preferences" section with discoveries
-- Look for: time patterns, common tasks, recurring issues
-
-### Task 4: Self-Assessment
-
-- Review "Lessons Learned" section
-- Check if past mistakes are being avoided
-- Verify preferences are being followed in recent interactions
-- Update approach if patterns show gaps
-
-## Execution Schedule
-
-Heartbeat runs every 30 minutes. Rotate through tasks:
-
-- Heartbeat 1: Task 1 (review recent logs)
-- Heartbeat 2: Skip (SYMIPULSE_OK)
-- Heartbeat 3: Skip (SYMIPULSE_OK)
-- Heartbeat 4: Task 3 (pattern analysis)
-- Heartbeat 5-9: Skip (SYMIPULSE_OK)
-- Heartbeat 10: Task 2 (archive old logs)
-
-This gives ~3-day cycles for full memory consolidation.
-
-## Notes
-
-- Only run memory tasks during main session (not in group chats)
-- Keep updates concise - MEMORY.md should stay readable
-- Focus on actionable insights, not raw history
-- Archive, don't delete - history might be useful later

package/docs/zh-CN/reference/templates/TOOLS.dev.md

@@ -1,31 +0,0 @@
----
-read_when:
-  - 使用开发 gateway 模板
-  - 更新默认开发智能体身份
-summary: 开发智能体工具备注（C-3PO）
-x-i18n:
-  generated_at: "2026-02-01T21:37:41Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 3d41097967c9811637855664f978c02107a28b6d811ba49941a8f96f0720cd45
-  source_path: reference/templates/TOOLS.dev.md
-  workflow: 15
----
-
-# TOOLS.md - 用户工具备注（可编辑）
-
-此文件用于记录*你*关于外部工具和约定的备注。
-它不定义哪些工具可用；Symi 在内部提供内置工具。
-
-## 示例
-
-### imsg
-
-- 发送 iMessage/SMS：描述收件人/内容，发送前确认。
-- 尽量发送简短消息；避免发送密钥。
-
-### sag
-
-- 文字转语音：指定语音、目标扬声器/房间，以及是否使用流式传输。
-
-添加任何你希望助手了解的关于本地工具链的内容。

package/docs/zh-CN/reference/templates/TOOLS.md

@@ -1,53 +0,0 @@
----
-read_when:
-  - 手动引导工作区
-summary: TOOLS.md 的工作区模板
-x-i18n:
-  generated_at: "2026-02-01T21:38:05Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 3ed08cd537620749c40ab363f5db40a058d8ddab4d0192a1f071edbfcf37a739
-  source_path: reference/templates/TOOLS.md
-  workflow: 15
----
-
-# TOOLS.md - 本地备注
-
-Skills 定义了工具的*工作方式*。此文件用于记录*你的*具体信息——那些你的环境中独有的内容。
-
-## 应该放什么
-
-例如：
-
-- 摄像头名称和位置
-- SSH 主机和别名
-- TTS 首选语音
-- 音箱/房间名称
-- 设备昵称
-- 任何与环境相关的内容
-
-## 示例
-
-```markdown
-### Cameras
-
-- living-room → 主区域，180° 广角
-- front-door → 入口，运动触发
-
-### SSH
-
-- home-server → 192.168.1.100, user: admin
-
-### TTS
-
-- Preferred voice: "Nova"（温暖，略带英式口音）
-- Default speaker: Kitchen HomePod
-```
-
-## 为什么要分开？
-
-Skills 是共享的。你的配置是你自己的。将它们分开意味着你可以更新 Skills 而不丢失你的备注，也可以分享 Skills 而不泄露你的基础设施信息。
-
----
-
-添加任何对你有帮助的内容。这是你的速查表。

package/docs/zh-CN/reference/templates/USER.dev.md

@@ -1,25 +0,0 @@
----
-read_when:
-  - 使用开发 Gateway 网关模板
-  - 更新默认开发智能体身份
-summary: 开发智能体用户档案（C-3PO）
-x-i18n:
-  generated_at: "2026-02-03T10:09:37Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: f78f58bdbef10afbba0bc2673832eaa12e0c26270906d04a56584d5620af6fdf
-  source_path: reference/templates/USER.dev.md
-  workflow: 15
----
-
-# USER.md - 用户档案
-
-- **姓名：** The Symibutors
-- **称呼偏好：** They/Them（集体）
-- **代词：** they/them
-- **时区：** 全球分布（工作区默认：Europe/Vienna）
-- **备注：**
-  - 我们是多人。Symi 的贡献者，C-3PO 所在的框架。
-  - C-3PO 的存在是为了尽可能地帮助调试和提供协助。
-  - 跨时区工作，致力于让 Symi 变得更好。
-  - 创造者。构建者。深入代码的人。

package/docs/zh-CN/reference/templates/USER.md

@@ -1,30 +0,0 @@
----
-read_when:
-  - 手动引导工作区
-summary: 用户档案记录
-x-i18n:
-  generated_at: "2026-02-01T21:38:04Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 508dfcd4648512df712eaf8ca5d397a925d8035bac5bf2357e44d6f52f9fa9a6
-  source_path: reference/templates/USER.md
-  workflow: 15
----
-
-# USER.md - 关于你的用户
-
-_了解你正在帮助的人。随时更新此文件。_
-
-- **姓名：**
-- **称呼方式：**
-- **代词：** _（可选）_
-- **时区：**
-- **备注：**
-
-## 背景
-
-_（他们关心什么？正在做什么项目？什么让他们烦恼？什么让他们开心？随着时间推移逐步完善。）_
-
----
-
-你了解得越多，就越能提供更好的帮助。但请记住——你是在了解一个人，而不是在建立档案。尊重这两者之间的区别。

package/docs/zh-CN/reference/test.md

@@ -1,57 +0,0 @@
----
-read_when:
-  - 运行或修复测试
-summary: 如何在本地运行测试（vitest）以及何时使用 force/coverage 模式
-title: 测试
-x-i18n:
-  generated_at: "2026-02-03T10:09:52Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: be7b751fb81c8c94b1293624bdca6582e60a26084960d1df9558061969502e6f
-  source_path: reference/test.md
-  workflow: 15
----
-
-# 测试
-
-- 完整测试套件（测试集、实时测试、Docker）：[测试](/help/testing)
-
-- `pnpm test:force`：终止任何占用默认控制端口的遗留 Gateway 网关进程，然后使用隔离的 Gateway 网关端口运行完整的 Vitest 套件，这样服务器测试不会与正在运行的实例冲突。当之前的 Gateway 网关运行占用了端口 18789 时使用此命令。
-- `pnpm test:coverage`：使用 V8 覆盖率运行 Vitest。全局阈值为 70% 的行/分支/函数/语句覆盖率。覆盖率排除了集成密集型入口点（CLI 连接、gateway/telegram 桥接、webchat 静态服务器），以保持目标集中在可单元测试的逻辑上。
-- `pnpm test:e2e`：运行 Gateway 网关端到端冒烟测试（多实例 WS/HTTP/节点配对）。
-- `pnpm test:live`：运行提供商实时测试（minimax/zai）。需要 API 密钥和 `LIVE=1`（或提供商特定的 `*_LIVE_TEST=1`）才能取消跳过。
-
-## 模型延迟基准测试（本地密钥）
-
-脚本：[`scripts/bench-model.ts`](https://github.com/symi/symi/blob/main/scripts/bench-model.ts)
-
-用法：
-
-- `source ~/.profile && pnpm tsx scripts/bench-model.ts --runs 10`
-- 可选环境变量：`MINIMAX_API_KEY`、`MINIMAX_BASE_URL`、`MINIMAX_MODEL`、`ANTHROPIC_API_KEY`
-- 默认提示词："Reply with a single word: ok. No punctuation or extra text."
-
-上次运行（2025-12-31，20 次）：
-
-- minimax 中位数 1279ms（最小 1114，最大 2431）
-- opus 中位数 2454ms（最小 1224，最大 3170）
-
-## 新手引导 E2E（Docker）
-
-Docker 是可选的；这仅用于容器化的新手引导冒烟测试。
-
-在干净的 Linux 容器中完整的冷启动流程：
-
-```bash
-scripts/e2e/onboard-docker.sh
-```
-
-此脚本通过伪终端驱动交互式向导，验证配置/工作区/会话文件，然后启动 Gateway 网关并运行 `symi health`。
-
-## QR 导入冒烟测试（Docker）
-
-确保 `qrcode-terminal` 在 Docker 中的 Node 22+ 下加载：
-
-```bash
-pnpm test:docker:qr
-```

package/docs/zh-CN/reference/token-use.md

@@ -1,119 +0,0 @@
----
-read_when:
-  - 解释 token 使用量、成本或上下文窗口时
-  - 调试上下文增长或压缩行为时
-summary: Symi 如何构建提示上下文并报告 token 使用量 + 成本
-title: Token 使用与成本
-x-i18n:
-  generated_at: "2026-02-03T07:54:57Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: aee417119851db9e36890487517ed9602d214849e412127e7f534ebec5c9e105
-  source_path: reference/token-use.md
-  workflow: 15
----
-
-# Token 使用与成本
-
-Symi 跟踪的是 **token**，而不是字符。Token 是模型特定的，但大多数
-OpenAI 风格的模型对于英文文本平均约 4 个字符为一个 token。
-
-## 系统提示词如何构建
-
-Symi 在每次运行时组装自己的系统提示词。它包括：
-
-- 工具列表 + 简短描述
-- Skills 列表（仅元数据；指令通过 `read` 按需加载）
-- 自我更新指令
-- 工作区 + 引导文件（`AGENTS.md`、`SYMICORE.md`、`TOOLS.md`、`IDENTITY.md`、`USER.md`、`SYMIPULSE.md`、`BOOTSTRAP.md`（新建时））。大文件会被 `agents.defaults.bootstrapMaxChars`（默认：20000）截断。
-- 时间（UTC + 用户时区）
-- 回复标签 + 心跳行为
-- 运行时元数据（主机/操作系统/模型/思考）
-
-完整分解参见[系统提示词](/concepts/system-prompt)。
-
-## 什么算入上下文窗口
-
-模型接收的所有内容都计入上下文限制：
-
-- 系统提示词（上面列出的所有部分）
-- 对话历史（用户 + 助手消息）
-- 工具调用和工具结果
-- 附件/转录（图片、音频、文件）
-- 压缩摘要和修剪产物
-- 提供商包装或安全头（不可见，但仍计数）
-
-有关实际分解（每个注入文件、工具、Skills 和系统提示词大小），使用 `/context list` 或 `/context detail`。参见[上下文](/concepts/context)。
-
-## 如何查看当前 token 使用量
-
-在聊天中使用：
-
-- `/status` → 带有会话模型、上下文使用量、
-  最后响应输入/输出 token 和**预估成本**（仅 API 密钥）的 **emoji 丰富的状态卡片**。
-- `/usage off|tokens|full` → 在每个回复后附加**每响应使用量页脚**。
-  - 每会话持久化（存储为 `responseUsage`）。
-  - OAuth 认证**隐藏成本**（仅 token）。
-- `/usage cost` → 从 Symi 会话日志显示本地成本摘要。
-
-其他界面：
-
-- **TUI/Web TUI：** 支持 `/status` + `/usage`。
-- **CLI：** `symi status --usage` 和 `symi channels list` 显示
-  提供商配额窗口（不是每响应成本）。
-
-## 成本估算（显示时）
-
-成本从你的模型定价配置估算：
-
-```
-models.providers.<provider>.models[].cost
-```
-
-这些是 `input`、`output`、`cacheRead` 和
-`cacheWrite` 的**每 1M token 美元**。如果缺少定价，Symi 仅显示 token。OAuth 令牌
-永远不显示美元成本。
-
-## 缓存 TTL 和修剪影响
-
-提供商提示缓存仅在缓存 TTL 窗口内适用。Symi 可以
-选择性地运行**缓存 TTL 修剪**：它在缓存 TTL
-过期后修剪会话，然后重置缓存窗口，以便后续请求可以重用
-新缓存的上下文，而不是重新缓存完整历史。这在会话空闲超过 TTL 时
-可以降低缓存写入成本。
-
-在 [Gateway 网关配置](/gateway/configuration) 中配置它，并在
-[会话修剪](/concepts/session-pruning) 中查看行为详情。
-
-心跳可以在空闲间隙中保持缓存**热**。如果你的模型缓存 TTL
-是 `1h`，将心跳间隔设置为略低于此（例如 `55m`）可以避免
-重新缓存完整提示，从而降低缓存写入成本。
-
-有关 Anthropic API 定价，缓存读取比输入
-token 便宜得多，而缓存写入以更高的倍率计费。参见 Anthropic 的
-提示缓存定价了解最新费率和 TTL 倍率：
-https://docs.anthropic.com/docs/build-with-claude/prompt-caching
-
-### 示例：用心跳保持 1 小时缓存热
-
-```yaml
-agents:
-  defaults:
-    model:
-      primary: "anthropic/claude-opus-4-5"
-    models:
-      "anthropic/claude-opus-4-5":
-        params:
-          cacheRetention: "long"
-    heartbeat:
-      every: "55m"
-```
-
-## 减少 token 压力的技巧
-
-- 使用 `/compact` 来总结长会话。
-- 在你的工作流中修剪大的工具输出。
-- 保持 skill 描述简短（skill 列表会注入到提示中）。
-- 对于冗长的探索性工作，优先使用较小的模型。
-
-精确的 skill 列表开销公式参见 [Skills](/tools/skills)。

package/docs/zh-CN/reference/transcript-hygiene.md

@@ -1,109 +0,0 @@
----
-read_when:
-  - 你正在调试与对话记录结构相关的提供商请求拒绝问题
-  - 你正在修改对话记录清理或工具调用修复逻辑
-  - 你正在调查跨提供商的工具调用 id 不匹配问题
-summary: 参考：提供商特定的对话记录清理与修复规则
-title: 对话记录清理
-x-i18n:
-  generated_at: "2026-02-01T21:38:16Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 6ce62fad0b07c4d8575c9cdb1c8c2663695ef2d4221cf4a0964fce03461523af
-  source_path: reference/transcript-hygiene.md
-  workflow: 15
----
-
-# 对话记录清理（提供商修正）
-
-本文档描述了在运行前（构建模型上下文时）应用于对话记录的**提供商特定修正**。这些是**内存中**的调整，用于满足提供商的严格要求。它们**不会**重写磁盘上存储的 JSONL 对话记录。
-
-涵盖范围包括：
-
-- 工具调用 id 清理
-- 工具结果配对修复
-- 轮次验证 / 排序
-- 思考签名清理
-- 图片负载清理
-
-如需了解对话记录存储细节，请参阅：
-
-- [/reference/session-management-compaction](/reference/session-management-compaction)
-
----
-
-## 运行位置
-
-所有对话记录清理逻辑集中在嵌入式运行器中：
-
-- 策略选择：`src/agents/transcript-policy.ts`
-- 清理/修复应用：`src/agents/pi-embedded-runner/google.ts` 中的 `sanitizeSessionHistory`
-
-策略根据 `provider`、`modelApi` 和 `modelId` 来决定应用哪些规则。
-
----
-
-## 全局规则：图片清理
-
-图片负载始终会被清理，以防止因大小限制导致提供商端拒绝（对超大 base64 图片进行缩放/重新压缩）。
-
-实现：
-
-- `src/agents/pi-embedded-helpers/images.ts` 中的 `sanitizeSessionMessagesImages`
-- `src/agents/tool-images.ts` 中的 `sanitizeContentBlocksImages`
-
----
-
-## 提供商矩阵（当前行为）
-
-**OpenAI / OpenAI Codex**
-
-- 仅图片清理。
-- 切换到 OpenAI Responses/Codex 模型时，丢弃孤立的推理签名（没有后续内容块的独立推理项）。
-- 不进行工具调用 id 清理。
-- 不进行工具结果配对修复。
-- 不进行轮次验证或重新排序。
-- 不生成合成工具结果。
-- 不剥离思考签名。
-
-**Google (Generative AI / Gemini CLI / Antigravity)**
-
-- 工具调用 id 清理：严格字母数字。
-- 工具结果配对修复和合成工具结果。
-- 轮次验证（Gemini 风格的轮次交替）。
-- Google 轮次排序修正（如果历史记录以助手开头，则在前面添加一个小型用户引导消息）。
-- Antigravity Claude：规范化思考签名；丢弃未签名的思考块。
-
-**Anthropic / Minimax（Anthropic 兼容）**
-
-- 工具结果配对修复和合成工具结果。
-- 轮次验证（合并连续的用户轮次以满足严格交替要求）。
-
-**Mistral（包括基于 model-id 的检测）**
-
-- 工具调用 id 清理：strict9（字母数字，长度 9）。
-
-**OpenRouter Gemini**
-
-- 思考签名清理：剥离非 base64 的 `thought_signature` 值（保留 base64）。
-
-**其他所有提供商**
-
-- 仅图片清理。
-
----
-
-## 历史行为（2026.1.22 之前）
-
-在 2026.1.22 版本发布之前，Symi 应用了多层对话记录清理：
-
-- 一个**对话记录清理扩展**在每次上下文构建时运行，可以：
-  - 修复工具使用/结果配对。
-  - 清理工具调用 id（包括保留 `_`/`-` 的非严格模式）。
-- 运行器也执行提供商特定的清理，导致重复工作。
-- 在提供商策略之外还存在额外的变更，包括：
-  - 在持久化之前从助手文本中剥离 `<final>` 标签。
-  - 丢弃空的助手错误轮次。
-  - 截断工具调用之后的助手内容。
-
-这种复杂性导致了跨提供商的回归问题（尤其是 `openai-responses` 的 `call_id|fc_id` 配对）。2026.1.22 的清理移除了该扩展，将逻辑集中到运行器中，并使 OpenAI 在图片清理之外**不做任何修改**。

package/docs/zh-CN/reference/wizard.md

@@ -1,9 +0,0 @@
----
-summary: Onboarding 向导参考：完整步骤、参数与配置字段
-title: 向导参考
-sidebarTitle: 向导参考
----
-
-# 向导参考
-
-该页面是英文文档的中文占位版本，完整内容请先参考英文版：[Onboarding Wizard Reference](/reference/wizard)。

package/docs/zh-CN/security/formal-verification.md

@@ -1,171 +0,0 @@
----
-permalink: /security/formal-verification/
-summary: 针对 Symi 最高风险路径的机器检查安全模型。
-title: 形式化验证（安全模型）
-x-i18n:
-  generated_at: "2026-02-03T07:54:04Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 8dff6ea41a37fb6b870424e4e788015c3f8a6099075eece5dbf909883c045106
-  source_path: security/formal-verification.md
-  workflow: 15
----
-
-# 形式化验证（安全模型）
-
-本页跟踪 Symi 的**形式化安全模型**（目前是 TLA+/TLC；根据需要会添加更多）。
-
-> 注意：一些较旧的链接可能引用了以前的项目名称。
-
-**目标（北极星）：** 提供机器检查的论证，证明 Symi 在明确假设下执行其
-预期的安全策略（授权、会话隔离、工具门控和
-配置错误安全）。
-
-**目前是什么：** 一个可执行的、攻击者驱动的**安全回归测试套件**：
-
-- 每个声明都有一个在有限状态空间上运行的模型检查。
-- 许多声明有一个配对的**负面模型**，为现实的 bug 类别生成反例追踪。
-
-**目前还不是什么：** 证明"Symi 在所有方面都是安全的"或完整 TypeScript 实现是正确的。
-
-## 模型存放位置
-
-模型维护在一个单独的仓库中：[vignesh07/symi-formal-models](https://github.com/vignesh07/symi-formal-models)。
-
-## 重要注意事项
-
-- 这些是**模型**，不是完整的 TypeScript 实现。模型和代码之间可能存在偏差。
-- 结果受 TLC 探索的状态空间限制；"绿色"并不意味着在建模的假设和边界之外也是安全的。
-- 一些声明依赖于明确的环境假设（例如，正确的部署、正确的配置输入）。
-
-## 复现结果
-
-目前，结果通过在本地克隆模型仓库并运行 TLC 来复现（见下文）。未来的迭代可能提供：
-
-- 带有公开产物（反例追踪、运行日志）的 CI 运行模型
-- 用于小型、有界检查的托管"运行此模型"工作流
-
-开始使用：
-
-```bash
-git clone https://github.com/vignesh07/symi-formal-models
-cd symi-formal-models
-
-# 需要 Java 11+（TLC 在 JVM 上运行）。
-# 仓库内置了固定版本的 `tla2tools.jar`（TLA+ 工具）并提供 `bin/tlc` + Make 目标。
-
-make <target>
-```
-
-### Gateway 网关暴露和开放 Gateway 网关配置错误
-
-**声明：** 在没有认证的情况下绑定到 loopback 之外可能使远程入侵成为可能 / 增加暴露；令牌/密码可以阻止未认证的攻击者（根据模型假设）。
-
-- 绿色运行：
-  - `make gateway-exposure-v2`
-  - `make gateway-exposure-v2-protected`
-- 红色（预期）：
-  - `make gateway-exposure-v2-negative`
-
-另见：模型仓库中的 `docs/gateway-exposure-matrix.md`。
-
-### Nodes.run 管道（最高风险能力）
-
-**声明：** `nodes.run` 需要（a）节点命令允许列表加上声明的命令以及（b）配置时的实时批准；批准被令牌化以防止重放（在模型中）。
-
-- 绿色运行：
-  - `make nodes-pipeline`
-  - `make approvals-token`
-- 红色（预期）：
-  - `make nodes-pipeline-negative`
-  - `make approvals-token-negative`
-
-### 配对存储（私信门控）
-
-**声明：** 配对请求遵守 TTL 和待处理请求上限。
-
-- 绿色运行：
-  - `make pairing`
-  - `make pairing-cap`
-- 红色（预期）：
-  - `make pairing-negative`
-  - `make pairing-cap-negative`
-
-### 入站门控（提及 + 控制命令绕过）
-
-**声明：** 在需要提及的群组上下文中，未授权的"控制命令"不能绕过提及门控。
-
-- 绿色：
-  - `make ingress-gating`
-- 红色（预期）：
-  - `make ingress-gating-negative`
-
-### 路由/会话键隔离
-
-**声明：** 来自不同对等方的私信不会折叠到同一会话中，除非明确链接/配置。
-
-- 绿色：
-  - `make routing-isolation`
-- 红色（预期）：
-  - `make routing-isolation-negative`
-
-## v1++：额外的有界模型（并发、重试、追踪正确性）
-
-这些是后续模型，围绕真实世界的故障模式（非原子更新、重试和消息扇出）提高保真度。
-
-### 配对存储并发 / 幂等性
-
-**声明：** 配对存储应该在交错情况下也强制执行 `MaxPending` 和幂等性（即"检查然后写入"必须是原子/加锁的；刷新不应创建重复项）。
-
-这意味着：
-
-- 在并发请求下，你不能超过渠道的 `MaxPending`。
-- 对同一 `(channel, sender)` 的重复请求/刷新不应创建重复的活跃待处理行。
-
-- 绿色运行：
-  - `make pairing-race`（原子/加锁的上限检查）
-  - `make pairing-idempotency`
-  - `make pairing-refresh`
-  - `make pairing-refresh-race`
-- 红色（预期）：
-  - `make pairing-race-negative`（非原子 begin/commit 上限竞争）
-  - `make pairing-idempotency-negative`
-  - `make pairing-refresh-negative`
-  - `make pairing-refresh-race-negative`
-
-### 入站追踪关联 / 幂等性
-
-**声明：** 摄入应在扇出过程中保持追踪关联，并在提供商重试下保持幂等。
-
-这意味着：
-
-- 当一个外部事件变成多个内部消息时，每个部分都保持相同的追踪/事件标识。
-- 重试不会导致重复处理。
-- 如果提供商事件 ID 缺失，去重回退到安全键（例如，追踪 ID）以避免丢弃不同的事件。
-
-- 绿色：
-  - `make ingress-trace`
-  - `make ingress-trace2`
-  - `make ingress-idempotency`
-  - `make ingress-dedupe-fallback`
-- 红色（预期）：
-  - `make ingress-trace-negative`
-  - `make ingress-trace2-negative`
-  - `make ingress-idempotency-negative`
-  - `make ingress-dedupe-fallback-negative`
-
-### 路由 dmScope 优先级 + identityLinks
-
-**声明：** 路由必须默认保持私信会话隔离，只有在明确配置时才折叠会话（渠道优先级 + 身份链接）。
-
-这意味着：
-
-- 渠道特定的 dmScope 覆盖必须优先于全局默认值。
-- identityLinks 应该只在明确链接的组内折叠，而不是跨不相关的对等方。
-
-- 绿色：
-  - `make routing-precedence`
-  - `make routing-identitylinks`
-- 红色（预期）：
-  - `make routing-precedence-negative`
-  - `make routing-identitylinks-negative`

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

@@ -1,9 +0,0 @@
----
-summary: 智能体引导流程：首次运行时如何初始化工作区与身份文件
-title: 智能体引导
-sidebarTitle: 引导
----
-
-# 智能体引导
-
-该页面是英文文档的中文占位版本，完整内容请先参考英文版：[Agent Bootstrapping](/start/bootstrapping)。