From f5c3fc319cde79aea3a904a7afe9c311e6fc79dc Mon Sep 17 00:00:00 2001 From: Teknium <127238744+teknium1@users.noreply.github.com> Date: Sun, 7 Jun 2026 01:57:18 -0700 Subject: [PATCH] docs(i18n): port deep-audit corrections to zh-Hans mirror (#41104) Mirrors the EN deep-audit fixes (PR #40952) into the zh-Hans translation so the two locales agree. zh-Hans is the only non-English locale; 26 translated pages carried the same stale claims. Corrections ported (code tokens identical across locales; prose re-translated where the surrounding text was already Chinese): - reference: /version slash command + dual-surface list; cli --provider adds openai-api + novita aliases; tool count 70->71 (+ removed phantom "10 RL tools" and fixed kanban 7->9); model_catalog ttl 24->1. - user-guide: hermes -w -q -> -w -z; language list 8->16; aux slots 8->11; docker separate-dashboard claim; gateway-streaming per-platform note; computer-use frontmatter. - features: curator prune_builtins truth; codex-runtime aux keys (context_compression->compression, vision_detect->vision); voice-mode STT/TTS enums; removed phantom rl toolset. - integrations: StepFun step-3-mini->step-3.5-flash; web-search backends 4->8; nous-portal status subcommand. - messaging: WeCom typing/streaming columns; telegram transport default edit->auto; sms host 0.0.0.0->127.0.0.1; simplex/ntfy gateway-setup + pairing approve; line smart-chunking; matrix MATRIX_DM_AUTO_THREAD; msgraph host note. - developer-guide: entry-point group hermes.plugins->hermes_agent.plugins; PLUGIN.yaml->plugin.yaml. Net-new EN sections (mcp mTLS, api-server run-approval, kanban CLI verbs) are untranslated in zh-Hans and fall back to English source, consistent with the mirror's existing partial-coverage state. Verified: docusaurus build --locale zh-Hans succeeds; no new broken anchors from these edits. --- .../current/developer-guide/adding-platform-adapters.md | 4 ++-- .../current/developer-guide/model-provider-plugin.md | 2 +- .../current/integrations/index.md | 2 +- .../current/integrations/providers.md | 4 ++-- .../current/reference/cli-commands.md | 2 +- .../current/reference/model-catalog.md | 2 +- .../current/reference/slash-commands.md | 3 ++- .../current/reference/tools-reference.md | 2 +- .../current/user-guide/cli.md | 2 +- .../current/user-guide/configuration.md | 4 ++-- .../current/user-guide/configuring-models.md | 4 ++-- .../current/user-guide/docker.md | 3 +-- .../user-guide/features/codex-app-server-runtime.md | 4 ++-- .../current/user-guide/features/computer-use.md | 5 +++++ .../current/user-guide/features/curator.md | 2 +- .../current/user-guide/features/tools.md | 4 ++-- .../current/user-guide/features/voice-mode.md | 4 ++-- .../current/user-guide/git-worktrees.md | 2 +- .../current/user-guide/messaging/index.md | 2 +- .../current/user-guide/messaging/line.md | 2 +- .../current/user-guide/messaging/matrix.md | 2 +- .../current/user-guide/messaging/msgraph-webhook.md | 2 +- .../current/user-guide/messaging/ntfy.md | 2 +- .../current/user-guide/messaging/simplex.md | 4 ++-- .../current/user-guide/messaging/sms.md | 2 +- .../current/user-guide/messaging/telegram.md | 8 ++++---- 26 files changed, 42 insertions(+), 37 deletions(-) diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/developer-guide/adding-platform-adapters.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/developer-guide/adding-platform-adapters.md index e53eb57cc54..0a947fa16db 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/developer-guide/adding-platform-adapters.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/developer-guide/adding-platform-adapters.md @@ -34,11 +34,11 @@ Plugin 系统允许你在不修改任何 Hermes 核心代码的情况下添加 ``` ~/.hermes/plugins/my-platform/ - PLUGIN.yaml # Plugin 元数据 + plugin.yaml # Plugin 元数据 adapter.py # 适配器类 + register() 入口点 ``` -### PLUGIN.yaml +### plugin.yaml Plugin 元数据。`requires_env` 和 `optional_env` 块会自动填充 `hermes config` UI 条目（参见下方[在 hermes config 中暴露环境变量](#surfacing-env-vars-in-hermes-config)）。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/developer-guide/model-provider-plugin.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/developer-guide/model-provider-plugin.md index 5559ecc1be8..f2b136bb6e0 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/developer-guide/model-provider-plugin.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/developer-guide/model-provider-plugin.md @@ -250,7 +250,7 @@ hermes -z "hello" --provider my-provider -m some-model 与所有 Hermes 插件一样，模型提供商可以作为 pip 包发布。在你的 `pyproject.toml` 中添加入口点： ```toml -[project.entry-points."hermes.plugins"] +[project.entry-points."hermes_agent.plugins"] acme-inference = "acme_hermes_plugin:register" ``` diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/integrations/index.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/integrations/index.md index 234716d09cb..39ca64095d1 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/integrations/index.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/integrations/index.md @@ -35,7 +35,7 @@ Hermes 开箱即支持多个 AI 推理提供商。使用 `hermes model` 进行 ```yaml web: - backend: firecrawl # firecrawl | parallel | tavily | exa + backend: firecrawl # firecrawl | searxng | brave-free | ddgs | tavily | exa | parallel | xai ``` 若未设置 `web.backend`，后端将根据可用的 API key 自动检测。也支持通过 `FIRECRAWL_API_URL` 使用自托管的 Firecrawl。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/integrations/providers.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/integrations/providers.md index ee3f9166a0c..35c28794b9b 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/integrations/providers.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/integrations/providers.md @@ -473,7 +473,7 @@ model: ```bash # StepFun -hermes chat --provider stepfun --model step-3-mini +hermes chat --provider stepfun --model step-3.5-flash # 需要：~/.hermes/.env 中的 STEPFUN_API_KEY ``` @@ -481,7 +481,7 @@ hermes chat --provider stepfun --model step-3-mini ```yaml model: provider: "stepfun" - default: "step-3-mini" + default: "step-3.5-flash" ``` 基础 URL 可通过 `STEPFUN_BASE_URL` 覆盖（默认：`https://api.stepfun.com/v1`）。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/cli-commands.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/cli-commands.md index ad0e8efe2ad..362e5c4dedf 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/cli-commands.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/cli-commands.md @@ -95,7 +95,7 @@ hermes chat [options] | `-q`, `--query "..."` | 单次非交互式 prompt。 | | `-m`, `--model ` | 覆盖本次运行的模型。 | | `-t`, `--toolsets ` | 启用逗号分隔的 toolset 集合。 | -| `--provider ` | 强制指定 provider：`auto`、`openrouter`、`nous`、`openai-codex`、`copilot-acp`、`copilot`、`anthropic`、`gemini`、`google-gemini-cli`、`huggingface`、`novita`、`zai`、`kimi-coding`、`kimi-coding-cn`、`minimax`、`minimax-cn`、`minimax-oauth`、`kilocode`、`xiaomi`、`arcee`、`gmi`、`alibaba`、`alibaba-coding-plan`（别名 `alibaba_coding`）、`deepseek`、`nvidia`、`ollama-cloud`、`xai`（别名 `grok`）、`xai-oauth`（别名 `grok-oauth`）、`qwen-oauth`、`bedrock`、`opencode-zen`、`opencode-go`、`azure-foundry`、`lmstudio`、`stepfun`、`tencent-tokenhub`（别名 `tencent`、`tokenhub`）。 | +| `--provider ` | 强制指定 provider：`auto`、`openrouter`、`nous`、`openai-codex`、`copilot-acp`、`copilot`、`anthropic`、`gemini`、`google-gemini-cli`、`huggingface`、`novita`（别名 `novita-ai`、`novitaai`）、`openai-api`、`zai`、`kimi-coding`、`kimi-coding-cn`、`minimax`、`minimax-cn`、`minimax-oauth`、`kilocode`、`xiaomi`、`arcee`、`gmi`、`alibaba`、`alibaba-coding-plan`（别名 `alibaba_coding`）、`deepseek`、`nvidia`、`ollama-cloud`、`xai`（别名 `grok`）、`xai-oauth`（别名 `grok-oauth`）、`qwen-oauth`、`bedrock`、`opencode-zen`、`opencode-go`、`azure-foundry`、`lmstudio`、`stepfun`、`tencent-tokenhub`（别名 `tencent`、`tokenhub`）。 | | `-s`, `--skills ` | 为会话预加载一个或多个 skill（可重复或逗号分隔）。 | | `-v`, `--verbose` | 详细输出。 | | `-Q`, `--quiet` | 程序化模式：抑制横幅/spinner/工具预览。 | diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/model-catalog.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/model-catalog.md index 742cd497b04..3e1a4c1e7f0 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/model-catalog.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/model-catalog.md @@ -69,7 +69,7 @@ https://hermes-agent.nousresearch.com/docs/api/model-catalog.json model_catalog: enabled: true url: https://hermes-agent.nousresearch.com/docs/api/model-catalog.json - ttl_hours: 24 + ttl_hours: 1 providers: {} ``` diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/slash-commands.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/slash-commands.md index 3d3cedb2b52..9fb39a9f8bf 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/slash-commands.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/slash-commands.md @@ -100,6 +100,7 @@ Hermes 有两个斜杠命令入口，均由 `hermes_cli/commands.py` 中的中 | 命令 | 描述 | |---------|-------------| | `/help` | 显示帮助信息 | +| `/version` | 显示 Hermes Agent 版本、构建及环境信息。 | | `/usage` | 显示 token 用量、费用明细、会话时长，以及——当活动提供商支持时——从提供商 API 实时拉取的**账户限额**部分，包含剩余配额/积分/套餐用量。 | | `/insights` | 显示用量洞察和分析（最近 30 天） | | `/platforms`（别名：`/gateway`） | 显示 gateway/消息平台状态（仅限 CLI 摘要视图）。 | @@ -236,7 +237,7 @@ hermes config set model.aliases.grok x-ai/grok-4 - `/skin`、`/snapshot`、`/gquota`、`/reload`、`/tools`、`/toolsets`、`/browser`、`/config`、`/cron`、`/skills`、`/platforms`、`/paste`、`/image`、`/statusbar`、`/plugins`、`/busy`、`/indicator`、`/redraw`、`/clear`、`/history`、`/save`、`/copy`、`/handoff` 和 `/quit` 是**仅限 CLI** 的命令。 - `/verbose` **默认仅限 CLI**，但可通过在 `config.yaml` 中设置 `display.tool_progress_command: true` 为消息平台启用。启用后，它会循环切换 `display.tool_progress` 模式并保存到配置。 - `/sethome`、`/update`、`/restart`、`/approve`、`/deny`、`/topic` 和 `/commands` 是**仅限消息平台**的命令。 -- `/status`、`/background`、`/queue`、`/steer`、`/voice`、`/reload-mcp`、`/reload-skills`、`/rollback`、`/debug`、`/fast`、`/footer`、`/curator`、`/kanban`、`/sessions` 和 `/yolo` 在 **CLI 和消息 gateway 中均可使用**。 +- `/status`、`/version`、`/background`、`/queue`、`/steer`、`/voice`、`/reload-mcp`、`/reload-skills`、`/rollback`、`/debug`、`/fast`、`/footer`、`/curator`、`/kanban`、`/sessions` 和 `/yolo` 在 **CLI 和消息 gateway 中均可使用**。 - `/voice join`、`/voice channel` 和 `/voice leave` 仅在 Discord 上有意义。 ## 破坏性命令的确认提示 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/tools-reference.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/tools-reference.md index 4026fac544c..7539fc07779 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/tools-reference.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/tools-reference.md @@ -8,7 +8,7 @@ description: "Hermes 内置工具权威参考，按工具集分组" 本页记录 Hermes 的内置工具，按工具集分组。可用性因平台、凭据和已启用的工具集而异。 -**当前注册表快速统计：** 约 70 个工具 —— 10 个浏览器工具（核心）+ 2 个 CDP 门控浏览器工具、4 个文件工具、10 个 RL 工具、4 个 Home Assistant 工具、2 个终端工具、2 个 Web 工具、5 个 Feishu 工具、7 个 Spotify 工具（由内置 `spotify` 插件注册）、5 个 Yuanbao 工具、7 个 kanban 工具（在 kanban 调度器生成 agent 时注册）、2 个 Discord 工具，以及若干独立工具（`memory`、`clarify`、`delegate_task`、`execute_code`、`cronjob`、`session_search`、`skill_view`/`skill_manage`/`skills_list`、`text_to_speech`、`image_generate`、`video_generate`、`vision_analyze`、`video_analyze`、`mixture_of_agents`、`send_message`、`todo`、`computer_use`、`process`）。 +**当前注册表快速统计：** 约 71 个工具 —— 10 个浏览器工具（核心）+ 2 个 CDP 门控浏览器工具、4 个文件工具、4 个 Home Assistant 工具、2 个终端工具、2 个 Web 工具、5 个 Feishu 工具、7 个 Spotify 工具（由内置 `spotify` 插件注册）、5 个 Yuanbao 工具、9 个 kanban 工具（在 kanban 调度器生成 agent 时注册）、2 个 Discord 工具，以及若干独立工具（`memory`、`clarify`、`delegate_task`、`execute_code`、`cronjob`、`session_search`、`skill_view`/`skill_manage`/`skills_list`、`text_to_speech`、`image_generate`、`video_generate`、`vision_analyze`、`video_analyze`、`mixture_of_agents`、`send_message`、`todo`、`computer_use`、`process`）。 :::tip MCP 工具 除内置工具外，Hermes 还可从 MCP 服务器动态加载工具。MCP 工具以 `mcp__` 为前缀（例如，`github` MCP 服务器的 `mcp_github_create_issue`）。配置方法见 [MCP 集成](/user-guide/features/mcp)。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/cli.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/cli.md index 0b5ccf0ab27..ced238eca24 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/cli.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/cli.md @@ -44,7 +44,7 @@ hermes chat --verbose # 隔离的 git worktree（用于并行运行多个 agent） hermes -w # 在 worktree 中以交互模式运行 -hermes -w -q "Fix issue #123" # 在 worktree 中以单次查询模式运行 +hermes -w -z "Fix issue #123" # 在 worktree 中以单次查询模式运行 ``` ## 界面布局 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/configuration.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/configuration.md index 4232161d944..ac7adc3efd7 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/configuration.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/configuration.md @@ -1156,7 +1156,7 @@ display: `display.language` 设置翻译一小组静态面向用户的消息 —— CLI 审批提示、少数 gateway 斜杠命令回复（例如重启排空通知、"审批已过期"、"目标已清除"）。它**不**翻译 agent 响应、日志行、工具输出、错误回溯或斜杠命令描述 —— 这些保持英文。如果您希望 agent 本身用另一种语言回复，只需在您的提示词或系统消息中告诉它。 -支持的值：`en`（默认）、`zh`（简体中文）、`ja`（日语）、`de`（德语）、`es`（西班牙语）、`fr`（法语）、`tr`（土耳其语）、`uk`（乌克兰语）。未知值回退到英文。 +支持的值：`en`（默认）、`zh`（简体中文）、`zh-hant`（繁体中文）、`ja`（日语）、`de`（德语）、`es`（西班牙语）、`fr`（法语）、`tr`（土耳其语）、`uk`（乌克兰语）、`af`（南非荷兰语）、`ko`（韩语）、`it`（意大利语）、`ga`（爱尔兰语）、`pt`（葡萄牙语）、`ru`（俄语）、`hu`（匈牙利语）。未知值回退到英文。 您也可以使用 `HERMES_LANGUAGE` 环境变量按会话设置，它会覆盖配置值。 @@ -1314,7 +1314,7 @@ streaming: **新的最终消息（Telegram）：** Telegram 的 `editMessageText` 保留原始消息时间戳，因此长时间运行的流式回复即使在完成后也会保留第一个 token 的时间戳。当 `fresh_final_after_seconds > 0`（默认 `60`）时，完成的回复作为全新消息传递（尽力删除旧预览），以便 Telegram 的可见时间戳反映完成时间。短预览仍然就地最终化。设置为 `0` 以始终就地编辑。 :::note -流式传输默认禁用。在 `~/.hermes/config.yaml` 中启用以尝试流式传输 UX。 +主开关 `streaming.enabled` 默认为 `false`——在你启用之前不会有任何流式传输。启用后，是否流式传输按**平台**决定：Telegram 默认带有 `display.platforms.telegram.streaming: true`（流式传输），Discord 为 `display.platforms.discord.streaming: false`（不流式传输）。因此启用流式传输后，Telegram 开箱即用地流式传输，Discord 在你修改其开关之前仍使用整条消息回复。你可以在仪表盘的 **Channels** 开关中或直接在 `~/.hermes/config.yaml` 中调整这些按平台的开关。 ::: ## 群聊会话隔离 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/configuring-models.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/configuring-models.md index a1802ea7f41..d24b4c43ae2 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/configuring-models.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/configuring-models.md @@ -43,7 +43,7 @@ Hermes 使用两类模型槽位： ## 设置辅助模型 -点击 **Show auxiliary** 展开八个任务槽位： +点击 **Show auxiliary** 展开 11 个任务槽位： ![辅助面板展开状态](/img/docs/dashboard-models/auxiliary-expanded.png) @@ -78,7 +78,7 @@ Hermes 使用两类模型槽位： 下拉菜单包含： - **Main model** — 与点击主行上的 Change 效果相同。 -- **All auxiliary tasks** — 将此模型分配给全部 8 个辅助槽位。适合将所有边缘任务统一切换到廉价 flash 模型的场景。 +- **All auxiliary tasks** — 将此模型分配给全部 11 个辅助槽位。适合将所有边缘任务统一切换到廉价 flash 模型的场景。 - **单项任务选项** — Vision、Web Extract、Compression 等。每项任务当前分配的模型标记为 `current`。 当模型卡片当前已分配到某个槽位时，会显示 `main` 或 `aux · ` 标签，方便一眼看出历史模型的使用情况。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/docker.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/docker.md index 5828c7a9881..09621039883 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/docker.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/docker.md @@ -108,8 +108,7 @@ dashboard 进程崩溃，s6-overlay 会在短暂退避后自动 重启它——你会看到新的 PID，无需重启容器。日志和崩溃输出可通过 `docker logs ` 查看（s6 将服务的 stdout/stderr 转发至此）。 -不支持将 dashboard 作为独立容器运行：其 -gateway 存活检测需要与 gateway 进程共享 PID 命名空间。 +当独立的 dashboard 容器与宿主机共享 PID 与网络命名空间时（例如 `network_mode: host`，正如仓库自带的 `docker-compose.yml` 中的 `dashboard` 服务那样），**是**支持将 dashboard 作为独立容器运行的。其 gateway 存活检测需要与 gateway 进程共享 PID 命名空间，因此该限制仅适用于在隔离的 bridge 网络容器中、且未共享 PID 命名空间的 dashboard。 ::: ## 交互式运行（CLI 聊天） diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/codex-app-server-runtime.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/codex-app-server-runtime.md index 3761161fa6b..d6cba49765e 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/codex-app-server-runtime.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/codex-app-server-runtime.md @@ -253,10 +253,10 @@ auxiliary: title_generation: provider: openrouter model: google/gemini-3-flash-preview - context_compression: + compression: provider: openrouter model: google/gemini-3-flash-preview - vision_detect: + vision: provider: openrouter model: google/gemini-3-flash-preview goal_judge: diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/computer-use.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/computer-use.md index a38a957bc6a..396a83dbaa0 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/computer-use.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/computer-use.md @@ -1,3 +1,8 @@ +--- +title: 电脑操控 +sidebar_position: 16 +--- + # 电脑操控（macOS） Hermes Agent 可以在**后台**驱动你的 Mac 桌面——点击、输入、滚动、拖拽。你的光标不会移动，键盘焦点不会改变，macOS 也不会切换 Spaces。你和 Agent 可以在同一台机器上协同工作。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/curator.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/curator.md index 3e9c624c1db..e0996056aa6 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/curator.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/curator.md @@ -10,7 +10,7 @@ Curator 是针对 **agent 创建的技能**的后台维护流程。它跟踪每 它的存在是为了防止通过[自我改进循环](/user-guide/features/skills#agent-managed-skills-skill_manage-tool)创建的技能无限堆积。每次 agent 解决新问题并保存技能时，该技能都会落入 `~/.hermes/skills/`。若没有维护，最终会出现数十个范围狭窄的近似重复项，污染技能目录并浪费 token（令牌）。 -Curator **绝不触碰**随仓库附带的捆绑技能，也不触碰通过 [agentskills.io](https://agentskills.io) 安装的 hub 技能。它只审查 agent 自身创作的技能。它也**绝不自动删除**——最坏的结果是归档到 `~/.hermes/skills/.archive/`，这是可恢复的。 +默认情况下（`prune_builtins: true`），Curator 在 `archive_after_days` 天未使用后，可以归档**未使用的捆绑内置技能**（随仓库附带），与它主要管理的 agent 自创技能一并处理。通过 [agentskills.io](https://agentskills.io) 安装的 hub 技能始终不受影响。设置 `curator.prune_builtins: false` 可恢复旧的“仅 agent 自创”行为，此时捆绑技能绝不会被触碰。Curator 也**绝不自动删除**——最坏的结果是归档到 `~/.hermes/skills/.archive/`，这是可恢复的。 跟踪 [issue #7816](https://github.com/NousResearch/hermes-agent/issues/7816)。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/tools.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/tools.md index ce0ee0ef5a4..6c90424e9c4 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/tools.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/tools.md @@ -28,7 +28,7 @@ Hermes 内置了丰富的工具注册表，涵盖网页搜索、浏览器自动 | **Agent 编排** | `todo`, `clarify`, `execute_code`, `delegate_task` | 规划、澄清、代码执行及子 Agent 委托。 | | **记忆与召回** | `memory`, `session_search` | 持久化记忆与会话搜索。 | | **自动化与投递** | `cronjob`, `send_message` | 支持创建/列出/更新/暂停/恢复/运行/删除操作的定时任务，以及出站消息投递。 | -| **集成** | `ha_*`、MCP server 工具、`rl_*` | Home Assistant、MCP、RL 训练及其他集成。 | +| **集成** | `ha_*`、MCP server 工具 | Home Assistant、MCP 及其他集成。 | 如需查看由代码派生的权威注册表，请参阅 [内置工具参考](/reference/tools-reference) 和 [工具集参考](/reference/toolsets-reference)。 @@ -49,7 +49,7 @@ hermes tools hermes tools ``` -常用工具集包括 `web`、`search`、`terminal`、`file`、`browser`、`vision`、`image_gen`、`moa`、`skills`、`tts`、`todo`、`memory`、`session_search`、`cronjob`、`code_execution`、`delegation`、`clarify`、`homeassistant`、`messaging`、`spotify`、`discord`、`discord_admin`、`debugging`、`safe` 和 `rl`。 +常用工具集包括 `web`、`search`、`terminal`、`file`、`browser`、`vision`、`image_gen`、`moa`、`skills`、`tts`、`todo`、`memory`、`session_search`、`cronjob`、`code_execution`、`delegation`、`clarify`、`homeassistant`、`messaging`、`spotify`、`discord`、`discord_admin`、`debugging` 和 `safe`。 完整列表（包括 `hermes-cli`、`hermes-telegram` 等平台预设以及 `mcp-` 等动态 MCP 工具集）请参阅 [工具集参考](/reference/toolsets-reference)。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/voice-mode.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/voice-mode.md index 88a563a2e9b..8c39422aa46 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/voice-mode.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/features/voice-mode.md @@ -400,14 +400,14 @@ stt: # 作为入站消息的一部分传递给 Agent， # 适用于自定义流水线 # （说话人分离、对齐、归档等） - provider: "local" # "local"（免费）| "groq" | "openai" + provider: "local" # "local"（免费）| "groq" | "openai" | "mistral" | "xai" local: model: "base" # tiny, base, small, medium, large-v3 # model: "whisper-1" # 旧版：在未设置 provider 时使用 # 文字转语音（TTS） tts: - provider: "edge" # "edge"（免费）| "elevenlabs" | "openai" | "neutts" | "minimax" + provider: "edge" # "edge"（免费）| "elevenlabs" | "openai" | "neutts" | "minimax" | "mistral" | "gemini" | "xai" | "kittentts" | "piper" edge: voice: "en-US-AriaNeural" # 322 种声音，74 种语言 elevenlabs: diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/git-worktrees.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/git-worktrees.md index fc9e6b97eff..51db2ba4836 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/git-worktrees.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/git-worktrees.md @@ -155,7 +155,7 @@ Hermes 将： 这是获得 worktree 隔离的最简便方式。也可与单次查询结合使用： ```bash -hermes -w -q "Fix issue #123" +hermes -w -z "Fix issue #123" ``` 如需并行运行多个 agent，在多个终端中分别运行 `hermes -w`——每次调用都会自动获得独立的 worktree 和分支。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/index.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/index.md index 31efcdfb02f..5e65306fcd5 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/index.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/index.md @@ -27,7 +27,7 @@ description: "通过 Telegram、Discord、Slack、WhatsApp、Signal、SMS、Emai | Matrix | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | DingTalk | — | ✅ | ✅ | — | ✅ | — | ✅ | | Feishu/Lark | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | -| WeCom | ✅ | ✅ | ✅ | — | — | ✅ | ✅ | +| WeCom | ✅ | ✅ | ✅ | — | — | — | — | | WeCom Callback | — | — | — | — | — | — | — | | Weixin | ✅ | ✅ | ✅ | — | — | ✅ | ✅ | | BlueBubbles | — | ✅ | ✅ | — | ✅ | ✅ | — | diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/line.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/line.md index 79472e62a4d..ae42696055f 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/line.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/line.md @@ -192,7 +192,7 @@ LINE_HOME_CHANNEL=Uxxxxxxxxxxxxxxxxxxxx # 默认推送目标 ## 限制 -* **每个分块仅一个气泡。** 每个 LINE 文本气泡最多 5000 个字符，每次 Reply/Push 调用最多发送 5 个气泡。超出长度的响应将被截断并附加省略号。 +* **气泡与长度上限。** 每个 LINE 文本气泡最多 5000 个字符。超长响应会在每次 Reply/Push 调用中按约 4500 个字符智能分块（最多 5 个气泡），并尽可能在自然边界处切分。 * **不支持原生消息编辑。** LINE 没有编辑消息的 API — 流式响应始终发送新气泡，不会编辑已有气泡。 * **不支持 Markdown 渲染。** 粗体（`**`）、斜体（`*`）、代码块和标题均以字面字符显示。适配器在发送前会将其剥离；URL 会被保留（`[label](url)` 转换为 `label (url)`）。 * **加载指示器仅限私聊。** LINE 对群组和房间拒绝 chat/loading API，因此输入指示器仅在 1:1 聊天中显示。 \ No newline at end of file diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/matrix.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/matrix.md index 8aad69d243d..388f378d8eb 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/matrix.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/matrix.md @@ -19,7 +19,7 @@ Hermes 兼容任何 Matrix homeserver——Synapse、Conduit、Dendrite 或 matr | **私聊（DM）** | Hermes 响应每条消息，无需 `@提及`。每个 DM 有独立的会话。设置 `MATRIX_DM_MENTION_THREADS=true` 可在 DM 中被 `@提及` 时创建线程。 | | **房间** | 默认情况下，Hermes 需要 `@提及` 才会响应。设置 `MATRIX_REQUIRE_MENTION=false` 或将房间 ID 添加到 `MATRIX_FREE_RESPONSE_ROOMS` 可开启自由响应模式。房间邀请会被自动接受。 | | **线程** | Hermes 支持 Matrix 线程（MSC3440）。在线程中回复时，Hermes 会将线程上下文与主房间时间线隔离。机器人已参与的线程无需提及即可响应。 | -| **自动线程** | 默认情况下，Hermes 会为其在房间中响应的每条消息自动创建线程，以保持对话隔离。设置 `MATRIX_AUTO_THREAD=false` 可禁用此功能。 | +| **自动线程** | 默认情况下，Hermes 会为其在房间中响应的每条消息自动创建线程，以保持对话隔离。设置 `MATRIX_AUTO_THREAD=false` 可禁用此功能。设置 `MATRIX_DM_AUTO_THREAD=true`（默认 false）可同时为私聊消息自动创建线程——这与 `MATRIX_DM_MENTION_THREADS` 不同，后者仅在私聊中 @提及 Bot 时才创建线程。 | | **多用户共享房间** | 默认情况下，Hermes 在房间内按用户隔离会话历史。同一房间中的两个人不会共享同一对话记录，除非你明确禁用该功能。 | :::tip diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/msgraph-webhook.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/msgraph-webhook.md index 40950cb36e1..ce9ff46fe03 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/msgraph-webhook.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/msgraph-webhook.md @@ -67,7 +67,7 @@ https://ops.example.com/msgraph/webhook | `max_seen_receipts` | `5000` | 通知 ID 的去重缓存大小。达到上限时淘汰最旧的条目。 | | `allowed_source_cidrs` | `[]`（允许全部） | 可选的源 IP 白名单。见下文。 | -每个设置也有对应的环境变量（`MSGRAPH_WEBHOOK_*`），在 gateway 启动时合并到配置中——参见[环境变量参考](/reference/environment-variables#microsoft-graph-teams-meetings)。 +大多数设置也有对应的环境变量（`MSGRAPH_WEBHOOK_*`），在 gateway 启动时合并到配置中（例外是 `host`，它仅可通过配置文件设置——参见上方说明）——参见[环境变量参考](/reference/environment-variables#microsoft-graph-teams-meetings)。 ## 安全加固 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/ntfy.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/ntfy.md index 31aecd86772..1a482cfae18 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/ntfy.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/ntfy.md @@ -17,7 +17,7 @@ ntfy 是 Hermes 的轻量级推送渠道的理想选择：通过 [ntfy 移动应 ### 通过设置向导 ```bash -hermes setup gateway +hermes gateway setup ``` 选择 **ntfy** 并按提示操作。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/simplex.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/simplex.md index 4d1caaaa558..431d8b27f70 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/simplex.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/simplex.md @@ -32,7 +32,7 @@ simplex-chat -p 5225 ### 通过设置向导 ```bash -hermes setup gateway +hermes gateway setup ``` 选择 **SimpleX Chat** 并按提示操作。 @@ -64,7 +64,7 @@ SIMPLEX_HOME_CHANNEL= 默认情况下**所有联系人均被拒绝访问**。你必须选择以下方式之一： 1. 将 `SIMPLEX_ALLOWED_USERS` 设置为以逗号分隔的联系人 ID 列表，或 -2. 使用 **DM 配对**——向 Bot 发送任意消息，Bot 将回复一个配对码。通过 `hermes gateway pair` 输入该配对码。 +2. 使用 **DM 配对**——向 Bot 发送任意消息，Bot 将回复一个配对码。通过 `hermes pairing approve simplex ` 输入该配对码。 ## 在 cron 任务中使用 SimpleX diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/sms.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/sms.md index 31402cbc1c9..b40bd46a804 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/sms.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/sms.md @@ -126,7 +126,7 @@ hermes gateway | `TWILIO_PHONE_NUMBER` | 是 | 你的 Twilio 电话号码（E.164 格式） | | `SMS_WEBHOOK_URL` | 是 | 用于 Twilio 签名验证的公网 URL——必须与 Twilio 控制台中的 webhook URL 一致 | | `SMS_WEBHOOK_PORT` | 否 | Webhook 监听端口（默认：`8080`） | -| `SMS_WEBHOOK_HOST` | 否 | Webhook 绑定地址（默认：`0.0.0.0`） | +| `SMS_WEBHOOK_HOST` | 否 | Webhook 绑定地址（默认：`127.0.0.1`） | | `SMS_INSECURE_NO_SIGNATURE` | 否 | 设为 `true` 可禁用签名验证（仅限本地开发——**不适用于生产环境**） | | `SMS_ALLOWED_USERS` | 否 | 允许聊天的 E.164 格式电话号码，逗号分隔 | | `SMS_ALLOW_ALL_USERS` | 否 | 设为 `true` 允许所有人（不推荐） | diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/telegram.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/telegram.md index 7042737f8b0..a65393202e2 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/telegram.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/telegram.md @@ -853,9 +853,9 @@ platforms: | 值 | 行为 | |---|---| -| `auto` | 在支持的聊天（目前为 Telegram 私聊）上使用原生草稿流式传输；否则使用旧版基于编辑的路径。如果草稿帧失败，会优雅回退。 | +| `auto`（默认） | 在支持的聊天（目前为 Telegram 私聊）上使用原生草稿流式传输；否则使用旧版基于编辑的路径。如果草稿帧失败，会优雅回退。 | | `draft` | 强制使用原生草稿。如果聊天不支持草稿（例如群组/话题），记录降级日志并回退到编辑方式。 | -| `edit`（默认） | 对所有聊天类型使用旧版渐进式 `editMessageText` 轮询。 | +| `edit` | 对所有聊天类型使用旧版渐进式 `editMessageText` 轮询。 | | `off` | 完全禁用流式传输（仅最终回复，无渐进更新）。 | 在 `~/.hermes/config.yaml` 中： @@ -864,10 +864,10 @@ platforms: gateway: streaming: enabled: true - transport: edit # edit | auto | draft | off + transport: auto # auto | draft | edit | off ``` -**使用 `edit`（默认）时私聊中的效果** — gateway 发送一条普通预览消息，并通过 `editMessageText` 渐进更新，避免 Telegram 草稿预览折叠/回滚效果。 +**使用 `edit` 传输时私聊中的效果** — gateway 发送一条普通预览消息，并通过 `editMessageText` 渐进更新，避免 Telegram 草稿预览折叠/回滚效果。 **使用 `auto` 或 `draft` 时私聊中的效果** — Telegram 显示逐 token 更新的动画草稿预览。回复完成后，它作为普通消息投递，草稿预览在客户端自然清除。草稿没有消息 ID，因此最终答案才是保留在聊天历史中的内容。