mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-06-09 08:21:50 +00:00
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.
This commit is contained in:
Teknium
GitHub
parent
3c8f1dee8d
commit
f5c3fc319c
26 changed files with 42 additions and 37 deletions
|
|
@ -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)）。
|
||||
|
||||
|
|
|
|||
|
|
@ -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"
|
||||
```
|
||||
|
||||
|
|
|
|||
|
|
@ -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。
|
||||
|
|
|
|||
|
|
@ -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`）。
|
||||
|
|
|
|||
|
|
@ -95,7 +95,7 @@ hermes chat [options]
|
|||
| `-q`, `--query "..."` | 单次非交互式 prompt。 |
|
||||
| `-m`, `--model <model>` | 覆盖本次运行的模型。 |
|
||||
| `-t`, `--toolsets <csv>` | 启用逗号分隔的 toolset 集合。 |
|
||||
| `--provider <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>` | 强制指定 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 <name>` | 为会话预加载一个或多个 skill（可重复或逗号分隔）。 |
|
||||
| `-v`, `--verbose` | 详细输出。 |
|
||||
| `-Q`, `--quiet` | 程序化模式：抑制横幅/spinner/工具预览。 |
|
||||
|
|
|
|||
|
|
@ -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: {}
|
||||
```
|
||||
|
||||
|
|
|
|||
|
|
@ -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 上有意义。
|
||||
|
||||
## 破坏性命令的确认提示
|
||||
|
|
|
|||
|
|
@ -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_<server>_` 为前缀（例如，`github` MCP 服务器的 `mcp_github_create_issue`）。配置方法见 [MCP 集成](/user-guide/features/mcp)。
|
||||
|
|
|
|||
|
|
@ -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 中以单次查询模式运行
|
||||
```
|
||||
|
||||
## 界面布局
|
||||
|
|
|
|||
|
|
@ -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` 中调整这些按平台的开关。
|
||||
:::
|
||||
|
||||
## 群聊会话隔离
|
||||
|
|
|
|||
|
|
@ -43,7 +43,7 @@ Hermes 使用两类模型槽位：
|
|||
|
||||
## 设置辅助模型
|
||||
|
||||
点击 **Show auxiliary** 展开八个任务槽位：
|
||||
点击 **Show auxiliary** 展开 11 个任务槽位：
|
||||
|
||||
|
||||
|
||||
|
|
@ -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 · <task>` 标签，方便一眼看出历史模型的使用情况。
|
||||
|
|
|
|||
|
|
@ -108,8 +108,7 @@ dashboard 进程崩溃，s6-overlay 会在短暂退避后自动
|
|||
重启它——你会看到新的 PID，无需重启容器。日志和崩溃输出可通过
|
||||
`docker logs <container>` 查看（s6 将服务的 stdout/stderr 转发至此）。
|
||||
|
||||
不支持将 dashboard 作为独立容器运行：其
|
||||
gateway 存活检测需要与 gateway 进程共享 PID 命名空间。
|
||||
当独立的 dashboard 容器与宿主机共享 PID 与网络命名空间时（例如 `network_mode: host`，正如仓库自带的 `docker-compose.yml` 中的 `dashboard` 服务那样），**是**支持将 dashboard 作为独立容器运行的。其 gateway 存活检测需要与 gateway 进程共享 PID 命名空间，因此该限制仅适用于在隔离的 bridge 网络容器中、且未共享 PID 命名空间的 dashboard。
|
||||
:::
|
||||
|
||||
## 交互式运行（CLI 聊天）
|
||||
|
|
|
|||
|
|
@ -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:
|
||||
|
|
|
|||
|
|
@ -1,3 +1,8 @@
|
|||
---
|
||||
title: 电脑操控
|
||||
sidebar_position: 16
|
||||
---
|
||||
|
||||
# 电脑操控（macOS）
|
||||
|
||||
Hermes Agent 可以在**后台**驱动你的 Mac 桌面——点击、输入、滚动、拖拽。你的光标不会移动，键盘焦点不会改变，macOS 也不会切换 Spaces。你和 Agent 可以在同一台机器上协同工作。
|
||||
|
|
|
|||
|
|
@ -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)。
|
||||
|
||||
|
|
|
|||
|
|
@ -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-<server>` 等动态 MCP 工具集）请参阅 [工具集参考](/reference/toolsets-reference)。
|
||||
|
||||
|
|
|
|||
|
|
@ -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:
|
||||
|
|
|
|||
|
|
@ -155,7 +155,7 @@ Hermes 将：
|
|||
这是获得 worktree 隔离的最简便方式。也可与单次查询结合使用：
|
||||
|
||||
```bash
|
||||
hermes -w -q "Fix issue #123"
|
||||
hermes -w -z "Fix issue #123"
|
||||
```
|
||||
|
||||
如需并行运行多个 agent，在多个终端中分别运行 `hermes -w`——每次调用都会自动获得独立的 worktree 和分支。
|
||||
|
|
|
|||
|
|
@ -27,7 +27,7 @@ description: "通过 Telegram、Discord、Slack、WhatsApp、Signal、SMS、Emai
|
|||
| Matrix | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| DingTalk | — | ✅ | ✅ | — | ✅ | — | ✅ |
|
||||
| Feishu/Lark | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| WeCom | ✅ | ✅ | ✅ | — | — | ✅ | ✅ |
|
||||
| WeCom | ✅ | ✅ | ✅ | — | — | — | — |
|
||||
| WeCom Callback | — | — | — | — | — | — | — |
|
||||
| Weixin | ✅ | ✅ | ✅ | — | — | ✅ | ✅ |
|
||||
| BlueBubbles | — | ✅ | ✅ | — | ✅ | ✅ | — |
|
||||
|
|
|
|||
|
|
@ -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 聊天中显示。
|
||||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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)。
|
||||
|
||||
## 安全加固
|
||||
|
||||
|
|
|
|||
|
|
@ -17,7 +17,7 @@ ntfy 是 Hermes 的轻量级推送渠道的理想选择：通过 [ntfy 移动应
|
|||
### 通过设置向导
|
||||
|
||||
```bash
|
||||
hermes setup gateway
|
||||
hermes gateway setup
|
||||
```
|
||||
|
||||
选择 **ntfy** 并按提示操作。
|
||||
|
|
|
|||
|
|
@ -32,7 +32,7 @@ simplex-chat -p 5225
|
|||
### 通过设置向导
|
||||
|
||||
```bash
|
||||
hermes setup gateway
|
||||
hermes gateway setup
|
||||
```
|
||||
|
||||
选择 **SimpleX Chat** 并按提示操作。
|
||||
|
|
@ -64,7 +64,7 @@ SIMPLEX_HOME_CHANNEL=<contact-id>
|
|||
默认情况下**所有联系人均被拒绝访问**。你必须选择以下方式之一：
|
||||
|
||||
1. 将 `SIMPLEX_ALLOWED_USERS` 设置为以逗号分隔的联系人 ID 列表，或
|
||||
2. 使用 **DM 配对**——向 Bot 发送任意消息，Bot 将回复一个配对码。通过 `hermes gateway pair` 输入该配对码。
|
||||
2. 使用 **DM 配对**——向 Bot 发送任意消息，Bot 将回复一个配对码。通过 `hermes pairing approve simplex <CODE>` 输入该配对码。
|
||||
|
||||
## 在 cron 任务中使用 SimpleX
|
||||
|
||||
|
|
|
|||
|
|
@ -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` 允许所有人（不推荐） |
|
||||
|
|
|
|||
|
|
@ -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，因此最终答案才是保留在聊天历史中的内容。
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue