@symerian/symi 3.0.21 → 3.0.22

package/docs/zh-CN/tools/subagents.md

@@ -1,167 +0,0 @@
----
-read_when:
-  - 你想通过智能体执行后台/并行工作
-  - 你正在更改 sessions_spawn 或子智能体工具策略
-summary: 子智能体：生成隔离的智能体运行，并将结果通告回请求者聊天
-title: 子智能体
-x-i18n:
-  generated_at: "2026-02-03T10:12:07Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 3c83eeed69a65dbbb6b21a386f3ac363d3ef8f077f0e03b834c3f0a9911dca7c
-  source_path: tools/subagents.md
-  workflow: 15
----
-
-# 子智能体
-
-子智能体是从现有智能体运行中生成的后台智能体运行。它们在自己的会话中运行（`agent:<agentId>:subagent:<uuid>`），完成后将结果**通告**回请求者的聊天渠道。
-
-## 斜杠命令
-
-使用 `/subagents` 检查或控制**当前会话**的子智能体运行：
-
-- `/subagents list`
-- `/subagents kill <id|#|all>`
-- `/subagents log <id|#> [limit] [tools]`
-- `/subagents info <id|#>`
-- `/subagents send <id|#> <message>`
-- `/subagents steer <id|#> <message>`
-- `/subagents spawn <agentId> <task> [--model <model>] [--thinking <level>]`
-
-`/subagents info` 显示运行元数据（状态、时间戳、会话 id、转录路径、清理）。
-
-### 启动行为
-
-`/subagents spawn` 以用户命令方式启动后台子智能体，任务完成后会向请求者聊天频道回发一条最终完成消息。
-
-- 该命令非阻塞，先返回 `runId`。
-- 完成后，子智能体会将汇总/结果消息发布到请求者聊天渠道。
-- `--model` 与 `--thinking` 可仅对本次运行做覆盖设置。
-- 可在完成后通过 `info`/`log` 查看详细信息和输出。
-
-主要目标：
-
-- 并行化"研究 / 长任务 / 慢工具"工作，而不阻塞主运行。
-- 默认保持子智能体隔离（会话分离 + 可选沙箱隔离）。
-- 保持工具接口难以滥用：子智能体默认**不**获得会话工具。
-- 避免嵌套扇出：子智能体不能生成子智能体。
-
-成本说明：每个子智能体都有**自己的**上下文和 token 使用量。对于繁重或重复的任务，为子智能体设置更便宜的模型，而让主智能体使用更高质量的模型。你可以通过 `agents.defaults.subagents.model` 或每智能体覆盖来配置。
-
-## 工具
-
-使用 `sessions_spawn`：
-
-- 启动子智能体运行（`deliver: false`，全局队列：`subagent`）
-- 然后运行通告步骤，并将通告回复发布到请求者的聊天渠道
-- 默认模型：继承调用者，除非你设置了 `agents.defaults.subagents.model`（或每智能体的 `agents.list[].subagents.model`）；显式的 `sessions_spawn.model` 仍然优先。
-- 默认思考：继承调用者，除非你设置了 `agents.defaults.subagents.thinking`（或每智能体的 `agents.list[].subagents.thinking`）；显式的 `sessions_spawn.thinking` 仍然优先。
-
-工具参数：
-
-- `task`（必需）
-- `label?`（可选）
-- `agentId?`（可选；如果允许，在另一个智能体 id 下生成）
-- `model?`（可选；覆盖子智能体模型；无效值会被跳过，子智能体将使用默认模型运行并在工具结果中显示警告）
-- `thinking?`（可选；覆盖子智能体运行的思考级别）
-- `runTimeoutSeconds?`（默认 `0`；设置后，子智能体运行在 N 秒后中止）
-- `cleanup?`（`delete|keep`，默认 `keep`）
-
-允许列表：
-
-- `agents.list[].subagents.allowAgents`：可以通过 `agentId` 指定的智能体 id 列表（`["*"]` 允许任意）。默认：仅限请求者智能体。
-
-发现：
-
-- 使用 `agents_list` 查看当前允许用于 `sessions_spawn` 的智能体 id。
-
-自动归档：
-
-- 子智能体会话在 `agents.defaults.subagents.archiveAfterMinutes` 后自动归档（默认：60）。
-- 归档使用 `sessions.delete` 并将转录重命名为 `*.deleted.<timestamp>`（同一文件夹）。
-- `cleanup: "delete"` 在通告后立即归档（仍通过重命名保留转录）。
-- 自动归档是尽力而为的；如果 Gateway 网关重启，待处理的定时器会丢失。
-- `runTimeoutSeconds` **不会**自动归档；它只停止运行。会话会保留直到自动归档。
-
-## 认证
-
-子智能体认证按**智能体 id** 解析，而不是按会话类型：
-
-- 子智能体会话键是 `agent:<agentId>:subagent:<uuid>`。
-- 认证存储从该智能体的 `agentDir` 加载。
-- 主智能体的认证配置文件作为**回退**合并；智能体配置文件在冲突时覆盖主配置文件。
-
-注意：合并是累加的，所以主配置文件始终可用作回退。目前尚不支持每智能体完全隔离的认证。
-
-## 通告
-
-子智能体通过通告步骤报告：
-
-- 通告步骤在子智能体会话中运行（不是请求者会话）。
-- 如果子智能体精确回复 `ANNOUNCE_SKIP`，则不发布任何内容。
-- 否则，通告回复通过后续的 `agent` 调用（`deliver=true`）发布到请求者的聊天渠道。
-- 通告回复在可用时保留线程/话题路由（Slack 线程、Telegram 话题、Matrix 线程）。
-- 通告消息被规范化为稳定模板：
-  - `Status:` 从运行结果派生（`success`、`error`、`timeout` 或 `unknown`）。
-  - `Result:` 通告步骤的摘要内容（如果缺失则为 `(not available)`）。
-  - `Notes:` 错误详情和其他有用的上下文。
-- `Status` 不是从模型输出推断的；它来自运行时结果信号。
-
-通告负载在末尾包含统计行（即使被包装）：
-
-- 运行时间（例如 `runtime 5m12s`）
-- Token 使用量（输入/输出/总计）
-- 配置模型定价时的估计成本（`models.providers.*.models[].cost`）
-- `sessionKey`、`sessionId` 和转录路径（以便主智能体可以通过 `sessions_history` 获取历史记录或检查磁盘上的文件）
-
-## 工具策略（子智能体工具）
-
-默认情况下，子智能体获得**除会话工具外的所有工具**：
-
-- `sessions_list`
-- `sessions_history`
-- `sessions_send`
-- `sessions_spawn`
-
-通过配置覆盖：
-
-```json5
-{
-  agents: {
-    defaults: {
-      subagents: {
-        maxConcurrent: 1,
-      },
-    },
-  },
-  tools: {
-    subagents: {
-      tools: {
-        // deny 优先
-        deny: ["gateway", "cron"],
-        // 如果设置了 allow，则变为仅允许模式（deny 仍然优先）
-        // allow: ["read", "exec", "process"]
-      },
-    },
-  },
-}
-```
-
-## 并发
-
-子智能体使用专用的进程内队列通道：
-
-- 通道名称：`subagent`
-- 并发数：`agents.defaults.subagents.maxConcurrent`（默认 `8`）
-
-## 停止
-
-- 在请求者聊天中发送 `/stop` 会中止请求者会话并停止从中生成的任何活动子智能体运行。
-
-## 限制
-
-- 子智能体通告是**尽力而为**的。如果 Gateway 网关重启，待处理的"通告回复"工作会丢失。
-- 子智能体仍然共享相同的 Gateway 网关进程资源；将 `maxConcurrent` 视为安全阀。
-- `sessions_spawn` 始终是非阻塞的：它立即返回 `{ status: "accepted", runId, childSessionKey }`。
-- 子智能体上下文仅注入 `AGENTS.md` + `TOOLS.md`（无 `SYMICORE.md`、`IDENTITY.md`、`USER.md`、`SYMIPULSE.md` 或 `BOOTSTRAP.md`）。

package/docs/zh-CN/tools/symihub.md

@@ -1,209 +0,0 @@
----
-read_when:
-  - 向新用户介绍 SymiHub
-  - 安装、搜索或发布 Skills
-  - 说明 SymiHub CLI 标志和同步行为
-summary: SymiHub 指南：公共 Skills 注册中心 + CLI 工作流
-title: SymiHub
-x-i18n:
-  generated_at: "2026-02-01T21:42:32Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 8b7f8fab80a34e409f37fa130a49ff5b487966755a7b0d214dfebf5207c7124c
-  source_path: tools/symihub.md
-  workflow: 15
----
-
-# SymiHub
-
-SymiHub 是 **Symi 的公共 Skills 注册中心**。它是一项免费服务：所有 Skills 都是公开的、开放的，所有人都可以查看、共享和复用。Skills 就是一个包含 `SKILL.md` 文件（以及辅助文本文件）的文件夹。你可以在网页应用中浏览 Skills，也可以使用 CLI 来搜索、安装、更新和发布 Skills。
-
-网站：[symihub.com](https://symihub.com)
-
-## 适用人群（新手友好）
-
-如果你想为 Symi 智能体添加新功能，SymiHub 是查找和安装 Skills 的最简单方式。你不需要了解后端的工作原理。你可以：
-
-- 使用自然语言搜索 Skills。
-- 将 Skills 安装到你的工作区。
-- 之后使用一条命令更新 Skills。
-- 通过发布 Skills 来备份你自己的 Skills。
-
-## 快速入门（非技术人员）
-
-1. 安装 CLI（参见下一节）。
-2. 搜索你需要的内容：
-   - `symihub search "calendar"`
-3. 安装一个 Skills：
-   - `symihub install <skill-slug>`
-4. 启动一个新的 Symi 会话，以加载新 Skills。
-
-## 安装 CLI
-
-任选其一：
-
-```bash
-npm i -g symihub
-```
-
-```bash
-pnpm add -g symihub
-```
-
-## 在 Symi 中的定位
-
-默认情况下，CLI 会将 Skills 安装到当前工作目录下的 `./skills`。如果已配置 Symi 工作区，`symihub` 会回退到该工作区，除非你通过 `--workdir`（或 `SYMIHUB_WORKDIR`）进行覆盖。Symi 从 `<workspace>/skills` 加载工作区 Skills，并会在**下一个**会话中生效。如果你已经在使用 `~/.symi/skills` 或内置 Skills，工作区 Skills 优先级更高。
-
-有关 Skills 加载、共享和权限控制的更多详情，请参阅
-[Skills](/tools/skills)。
-
-## 服务功能
-
-- **公开浏览**Skills 及其 `SKILL.md` 内容。
-- 基于嵌入向量（向量搜索）的**搜索**，而不仅仅是关键词匹配。
-- 支持语义化版本号、变更日志和标签（包括 `latest`）的**版本管理**。
-- 每个版本以 zip 格式**下载**。
-- **星标和评论**，支持社区反馈。
-- **审核**钩子，用于审批和审计。
-- **CLI 友好的 API**，支持自动化和脚本编写。
-
-## CLI 命令和参数
-
-全局选项（适用于所有命令）：
-
-- `--workdir <dir>`：工作目录（默认：当前目录；回退到 Symi 工作区）。
-- `--dir <dir>`：Skills 目录，相对于工作目录（默认：`skills`）。
-- `--site <url>`：网站基础 URL（浏览器登录）。
-- `--registry <url>`：注册中心 API 基础 URL。
-- `--no-input`：禁用提示（非交互模式）。
-- `-V, --cli-version`：打印 CLI 版本。
-
-认证：
-
-- `symihub login`（浏览器流程）或 `symihub login --token <token>`
-- `symihub logout`
-- `symihub whoami`
-
-选项：
-
-- `--token <token>`：粘贴 API 令牌。
-- `--label <label>`：为浏览器登录令牌存储的标签（默认：`CLI token`）。
-- `--no-browser`：不打开浏览器（需要 `--token`）。
-
-搜索：
-
-- `symihub search "query"`
-- `--limit <n>`：最大结果数。
-
-安装：
-
-- `symihub install <slug>`
-- `--version <version>`：安装指定版本。
-- `--force`：如果文件夹已存在则覆盖。
-
-更新：
-
-- `symihub update <slug>`
-- `symihub update --all`
-- `--version <version>`：更新到指定版本（仅限单个 slug）。
-- `--force`：当本地文件与任何已发布版本不匹配时强制覆盖。
-
-列表：
-
-- `symihub list`（读取 `.symihub/lock.json`）
-
-发布：
-
-- `symihub publish <path>`
-- `--slug <slug>`：Skills 标识符。
-- `--name <name>`：显示名称。
-- `--version <version>`：语义化版本号。
-- `--changelog <text>`：变更日志文本（可以为空）。
-- `--tags <tags>`：逗号分隔的标签（默认：`latest`）。
-
-删除/恢复（仅所有者/管理员）：
-
-- `symihub delete <slug> --yes`
-- `symihub undelete <slug> --yes`
-
-同步（扫描本地 Skills + 发布新增/更新的 Skills）：
-
-- `symihub sync`
-- `--root <dir...>`：额外的扫描根目录。
-- `--all`：无提示上传所有内容。
-- `--dry-run`：显示将要上传的内容。
-- `--bump <type>`：更新的版本号递增类型 `patch|minor|major`（默认：`patch`）。
-- `--changelog <text>`：非交互更新的变更日志。
-- `--tags <tags>`：逗号分隔的标签（默认：`latest`）。
-- `--concurrency <n>`：注册中心检查并发数（默认：4）。
-
-## 智能体常用工作流
-
-### 搜索 Skills
-
-```bash
-symihub search "postgres backups"
-```
-
-### 下载新 Skills
-
-```bash
-symihub install my-skill-pack
-```
-
-### 更新已安装的 Skills
-
-```bash
-symihub update --all
-```
-
-### 备份你的 Skills（发布或同步）
-
-对于单个 Skills 文件夹：
-
-```bash
-symihub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
-```
-
-一次扫描并备份多个 Skills：
-
-```bash
-symihub sync --all
-```
-
-## 高级详情（技术性）
-
-### 版本管理和标签
-
-- 每次发布都会创建一个新的**语义化版本** `SkillVersion`。
-- 标签（如 `latest`）指向某个版本；移动标签可以实现回滚。
-- 变更日志附加在每个版本上，在同步或发布更新时可以为空。
-
-### 本地更改与注册中心版本
-
-更新时会使用内容哈希将本地 Skills 内容与注册中心版本进行比较。如果本地文件与任何已发布版本不匹配，CLI 会在覆盖前询问确认（或在非交互模式下需要 `--force`）。
-
-### 同步扫描和回退根目录
-
-`symihub sync` 首先扫描当前工作目录。如果未找到 Skills，它会回退到已知的旧版位置（例如 `~/symi/skills` 和 `~/.symi/skills`）。这样设计是为了在不需要额外标志的情况下找到旧版 Skills 安装。
-
-### 存储和锁文件
-
-- 已安装的 Skills 记录在工作目录下的 `.symihub/lock.json` 中。
-- 认证令牌存储在 SymiHub CLI 配置文件中（可通过 `SYMIHUB_CONFIG_PATH` 覆盖）。
-
-### 遥测（安装计数）
-
-当你在登录状态下运行 `symihub sync` 时，CLI 会发送一个最小快照用于计算安装次数。你可以完全禁用此功能：
-
-```bash
-export SYMIHUB_DISABLE_TELEMETRY=1
-```
-
-## 环境变量
-
-- `SYMIHUB_SITE`：覆盖网站 URL。
-- `SYMIHUB_REGISTRY`：覆盖注册中心 API URL。
-- `SYMIHUB_CONFIG_PATH`：覆盖 CLI 存储令牌/配置的位置。
-- `SYMIHUB_WORKDIR`：覆盖默认工作目录。
-- `SYMIHUB_DISABLE_TELEMETRY=1`：禁用 `sync` 的遥测功能。

package/docs/zh-CN/tools/thinking.md

@@ -1,80 +0,0 @@
----
-read_when:
-  - 调整思考或详细模式指令解析或默认值时
-summary: "`/think` + `/verbose` 的指令语法及其对模型推理的影响"
-title: 思考级别
-x-i18n:
-  generated_at: "2026-02-01T21:43:37Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 1a611474c2781c9a8e9dac0e084e7ee4ef58aebece181fdc877392fc27442746
-  source_path: tools/thinking.md
-  workflow: 15
----
-
-# 思考级别（/think 指令）
-
-## 功能说明
-
-- 在任何入站消息正文中使用内联指令：`/t <level>`、`/think:<level>` 或 `/thinking <level>`。
-- 级别（别名）：`off | minimal | low | medium | high | xhigh`（仅 GPT-5.2 + Codex 模型）
-  - minimal → "think"
-  - low → "think hard"
-  - medium → "think harder"
-  - high → "ultrathink"（最大预算）
-  - xhigh → "ultrathink+"（仅 GPT-5.2 + Codex 模型）
-  - `highest`、`max` 映射为 `high`。
-- 提供商说明：
-  - Z.AI（`zai/*`）仅支持二元思考（`on`/`off`）。任何非 `off` 级别均视为 `on`（映射为 `low`）。
-
-## 解析优先顺序
-
-1. 消息上的内联指令（仅适用于该条消息）。
-2. 会话覆盖（通过发送仅包含指令的消息设置）。
-3. 全局默认值（配置中的 `agents.defaults.thinkingDefault`）。
-4. 回退：具备推理能力的模型为 low；否则为 off。
-
-## 设置会话默认值
-
-- 发送一条**仅包含**指令的消息（允许空白），例如 `/think:medium` 或 `/t high`。
-- 该设置在当前会话中持续生效（默认按发送者）；通过 `/think:off` 或会话空闲重置来清除。
-- 会发送确认回复（`Thinking level set to high.` / `Thinking disabled.`）。如果级别无效（例如 `/thinking big`），命令将被拒绝并给出提示，会话状态保持不变。
-- 不带参数发送 `/think`（或 `/think:`）可查看当前思考级别。
-
-## 按智能体应用
-
-- **内嵌 Pi**：解析后的级别传递给进程内的 Pi 智能体运行时。
-
-## 详细模式指令（/verbose 或 /v）
-
-- 级别：`on`（最小）| `full` | `off`（默认）。
-- 仅包含指令的消息切换会话详细模式并回复 `Verbose logging enabled.` / `Verbose logging disabled.`；无效级别返回提示且不改变状态。
-- `/verbose off` 存储一个显式的会话覆盖；通过会话 UI 选择 `inherit` 来清除。
-- 内联指令仅影响该条消息；否则应用会话/全局默认值。
-- 不带参数发送 `/verbose`（或 `/verbose:`）可查看当前详细模式级别。
-- 启用详细模式后，发出结构化工具结果的智能体（Pi 及其他 JSON 智能体）会将每个工具调用作为独立的元数据消息发回，可用时以 `<emoji> <tool-name>: <arg>` 为前缀（路径/命令）。这些工具摘要在每个工具启动时立即发送（独立气泡），而非作为流式增量。
-- 当详细模式为 `full` 时，工具输出也会在完成后转发（独立气泡，截断至安全长度）。如果在运行过程中切换 `/verbose on|full|off`，后续的工具气泡会遵循新设置。
-
-## 推理可见性（/reasoning）
-
-- 级别：`on|off|stream`。
-- 仅包含指令的消息切换回复中是否显示思考块。
-- 启用时，推理内容作为**独立消息**发送，以 `Reasoning:` 为前缀。
-- `stream`（仅 Telegram）：在回复生成期间将推理内容流式输出到 Telegram 草稿气泡中，然后发送不包含推理的最终回答。
-- 别名：`/reason`。
-- 不带参数发送 `/reasoning`（或 `/reasoning:`）可查看当前推理级别。
-
-## 相关内容
-
-- 提权模式文档位于[提权模式](/tools/elevated)。
-
-## 心跳
-
-- 心跳探测正文为配置的心跳提示词（默认：`Read SYMIPULSE.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply SYMIPULSE_OK.`）。心跳消息中的内联指令照常生效（但避免从心跳中更改会话默认值）。
-- 心跳投递默认仅包含最终负载。要同时发送单独的 `Reasoning:` 消息（如果可用），请设置 `agents.defaults.heartbeat.includeReasoning: true` 或按智能体 `agents.list[].heartbeat.includeReasoning: true`。
-
-## Web 聊天 UI
-
-- Web 聊天的思考选择器在页面加载时从入站会话存储/配置中读取并反映会话的已存储级别。
-- 选择另一个级别仅应用于下一条消息（`thinkingOnce`）；发送后，选择器会回到已存储的会话级别。
-- 要更改会话默认值，请发送 `/think:<level>` 指令（和之前一样）；选择器将在下次刷新后反映该设置。