better-dsh 0.2.4 → 0.2.5

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/memory.md

@@ -0,0 +1,233 @@
+---
+sidebar_position: 3
+title: "持久化记忆"
+description: "Hermes Agent 如何跨会话记忆——MEMORY.md、USER.md 与会话搜索"
+---
+
+# 持久化记忆
+
+Hermes Agent 拥有有界、经过整理的记忆，可跨会话持久保存。这使它能够记住你的偏好、项目、环境以及已学到的内容。
+
+## 工作原理
+
+两个文件构成 Agent 的记忆：
+
+| 文件 | 用途 | 字符上限 |
+|------|------|----------|
+| **MEMORY.md** | Agent 的个人笔记——环境事实、约定、已学内容 | 2,200 字符（约 800 tokens） |
+| **USER.md** | 用户档案——你的偏好、沟通风格、期望 | 1,375 字符（约 500 tokens） |
+
+两个文件均存储于 `~/.hermes/memories/`，在会话开始时以冻结快照的形式注入系统 prompt（提示词）。Agent 通过 `memory` 工具管理自身记忆——可添加、替换或删除条目。
+
+:::info
+字符上限使记忆保持聚焦。当记忆已满时，Agent 会整合或替换条目以腾出空间存放新信息。
+:::
+
+## 记忆在系统 Prompt 中的呈现方式
+
+每次会话开始时，记忆条目从磁盘加载并以冻结块的形式渲染到系统 prompt 中：
+
+```
+══════════════════════════════════════════════
+MEMORY (your personal notes) [67% — 1,474/2,200 chars]
+══════════════════════════════════════════════
+User's project is a Rust web service at ~/code/myapi using Axum + SQLx
+§
+This machine runs Ubuntu 22.04, has Docker and Podman installed
+§
+User prefers concise responses, dislikes verbose explanations
+```
+
+格式包含：
+- 标头，显示存储类型（MEMORY 或 USER PROFILE）
+- 使用百分比和字符计数，让 Agent 了解容量
+- 以 `§`（节符）分隔的各条目
+- 条目可以是多行
+
+**冻结快照模式：** 系统 prompt 注入在会话开始时捕获一次，会话中途不会改变。这是有意为之——目的是保留 LLM 的前缀缓存以提升性能。当 Agent 在会话期间添加或删除记忆条目时，更改会立即持久化到磁盘，但要到下一次会话开始时才会出现在系统 prompt 中。工具响应始终显示实时状态。
+
+## Memory 工具操作
+
+Agent 使用 `memory` 工具执行以下操作：
+
+- **add** — 添加新的记忆条目
+- **replace** — 用更新内容替换现有条目（通过 `old_text` 进行子字符串匹配）
+- **remove** — 删除不再相关的条目（通过 `old_text` 进行子字符串匹配）
+
+没有 `read` 操作——记忆内容在会话开始时自动注入系统 prompt。Agent 将其记忆作为对话上下文的一部分来查看。
+
+### 子字符串匹配
+
+`replace` 和 `remove` 操作使用简短的唯一子字符串匹配——不需要完整的条目文本。`old_text` 参数只需是能唯一标识某一条目的子字符串即可：
+
+```python
+# If memory contains "User prefers dark mode in all editors"
+memory(action="replace", target="memory",
+       old_text="dark mode",
+       content="User prefers light mode in VS Code, dark mode in terminal")
+```
+
+如果子字符串匹配到多个条目，则返回错误，要求提供更具体的匹配内容。
+
+## 两个目标说明
+
+### `memory` — Agent 的个人笔记
+
+用于 Agent 需要记住的环境、工作流及经验教训相关信息：
+
+- 环境事实（操作系统、工具、项目结构）
+- 项目约定和配置
+- 发现的工具怪癖与变通方法
+- 已完成任务的日记条目
+- 有效的技能和技术
+
+### `user` — 用户档案
+
+用于记录用户的身份、偏好和沟通风格：
+
+- 姓名、角色、时区
+- 沟通偏好（简洁 vs 详细、格式偏好）
+- 反感的事项和需要避免的内容
+- 工作流习惯
+- 技术水平
+
+## 什么该保存，什么该跳过
+
+### 主动保存这些内容
+
+Agent 会自动保存——无需你主动要求。当它学到以下内容时会保存：
+
+- **用户偏好：** "我更喜欢 TypeScript 而非 JavaScript" → 保存到 `user`
+- **环境事实：** "此服务器运行 Debian 12，安装了 PostgreSQL 16" → 保存到 `memory`
+- **纠正信息：** "Docker 命令不要用 `sudo`，用户已在 docker 组中" → 保存到 `memory`
+- **约定：** "项目使用 tab 缩进、120 字符行宽、Google 风格 docstring" → 保存到 `memory`
+- **已完成的工作：** "2026-01-15 将数据库从 MySQL 迁移到 PostgreSQL" → 保存到 `memory`
+- **明确请求：** "记住我的 API 密钥每月轮换一次" → 保存到 `memory`
+
+### 跳过这些内容
+
+- **琐碎/显而易见的信息：** "用户询问了 Python"——太模糊，没有实用价值
+- **容易重新发现的事实：** "Python 3.12 支持 f-string 嵌套"——可以网络搜索
+- **原始数据转储：** 大型代码块、日志文件、数据表——对记忆来说太大
+- **会话特定的临时内容：** 临时文件路径、一次性调试上下文
+- **已在上下文文件中的信息：** SOUL.md 和 AGENTS.md 的内容
+
+## 容量管理
+
+记忆有严格的字符上限，以保持系统 prompt 的有界性：
+
+| 存储 | 上限 | 典型条目数 |
+|------|------|-----------|
+| memory | 2,200 字符 | 8-15 条 |
+| user | 1,375 字符 | 5-10 条 |
+
+### 记忆已满时的处理
+
+当你尝试添加会超出上限的条目时，工具返回错误：
+
+```json
+{
+  "success": false,
+  "error": "Memory at 2,100/2,200 chars. Adding this entry (250 chars) would exceed the limit. Replace or remove existing entries first.",
+  "current_entries": ["..."],
+  "usage": "2,100/2,200"
+}
+```
+
+Agent 应当：
+1. 读取当前条目（显示在错误响应中）
+2. 识别可以删除或整合的条目
+3. 使用 `replace` 将相关条目合并为更简短的版本
+4. 然后 `add` 新条目
+
+**最佳实践：** 当记忆使用率超过 80%（在系统 prompt 标头中可见）时，在添加新条目之前先整合现有条目。例如，将三个独立的"项目使用 X"条目合并为一个综合性的项目描述条目。
+
+### 优质记忆条目的实际示例
+
+**紧凑、信息密度高的条目效果最佳：**
+
+```
+# Good: Packs multiple related facts
+User runs macOS 14 Sonoma, uses Homebrew, has Docker Desktop and Podman. Shell: zsh with oh-my-zsh. Editor: VS Code with Vim keybindings.
+
+# Good: Specific, actionable convention
+Project ~/code/api uses Go 1.22, sqlc for DB queries, chi router. Run tests with 'make test'. CI via GitHub Actions.
+
+# Good: Lesson learned with context
+The staging server (10.0.1.50) needs SSH port 2222, not 22. Key is at ~/.ssh/staging_ed25519.
+
+# Bad: Too vague
+User has a project.
+
+# Bad: Too verbose
+On January 5th, 2026, the user asked me to look at their project which is
+located at ~/code/api. I discovered it uses Go version 1.22 and...
+```
+
+## 重复防护
+
+记忆系统会自动拒绝完全重复的条目。如果你尝试添加已存在的内容，系统返回成功并附带"未添加重复项"的消息。
+
+## 安全扫描
+
+记忆条目在被接受之前会扫描注入和数据外泄模式，因为它们会被注入系统 prompt。匹配威胁模式（prompt 注入、凭据外泄、SSH 后门）或包含不可见 Unicode 字符的内容将被拦截。
+
+## 会话搜索
+
+除 MEMORY.md 和 USER.md 之外，Agent 还可以使用 `session_search` 工具搜索过去的对话：
+
+- 所有 CLI 和消息会话均存储在 SQLite（`~/.hermes/state.db`）中，支持 FTS5 全文搜索
+- 搜索查询返回数据库中的实际消息——无 LLM 摘要，无截断
+- Agent 可以找到数周前讨论过的内容，即使它们不在活跃记忆中
+- Agent 还可以在找到的任意会话中向前或向后滚动
+
+```bash
+hermes sessions list    # 浏览过去的会话
+```
+
+有关三种调用形式（发现 / 滚动 / 浏览）和响应格式，请参阅[会话搜索工具](/user-guide/sessions#session-search-tool)。
+
+### session_search 与 memory 的对比
+
+| 特性 | 持久化记忆 | 会话搜索 |
+|------|-----------|---------|
+| **容量** | 约 1,300 tokens 总计 | 无限制（所有会话） |
+| **速度** | 即时（在系统 prompt 中） | 约 20ms FTS5 查询，约 1ms 滚动 |
+| **成本** | 每次 prompt 均有 token 开销 | 免费——无 LLM 调用 |
+| **使用场景** | 始终可用的关键事实 | 查找特定的过去对话 |
+| **管理方式** | 由 Agent 手动整理 | 自动——所有会话均存储 |
+| **Token 开销** | 每次会话固定（约 1,300 tokens） | 按需（仅在搜索时产生） |
+
+**记忆**用于应始终在上下文中的关键事实。**会话搜索**用于"我们上周讨论过 X 吗？"这类需要 Agent 从过去对话中回忆具体内容的查询。
+
+## 同模型审查的推理强度 {#same-model-review-reasoning}
+
+后台审查与主会话使用同一模型时，**始终继承主会话的推理强度**。`auxiliary.background_review.reasoning_effort` 不会覆盖该设置；`auto` 路由和显式指定主会话的 provider/model 都遵循此规则。
+
+分支创建时，推理设置、系统 prompt、完整会话快照和工具定义保持与主会话逐字节一致，以复用 prompt 缓存前缀。只改变审查的推理强度会破坏这种一致性。没有用于同模型审查的独立推理强度开关。
+
+若要减少审查工作而不改变主会话的推理强度，可以调整 `memory.nudge_interval` / `skills.creation_nudge_interval`，通过 `auxiliary.background_review.enabled: false` 禁用自动审查，或将审查路由到其他模型。其他模型使用会话摘要，不共享主会话的预热缓存前缀；其任务推理强度的独立问题见 [#94825](https://github.com/NousResearch/hermes-agent/issues/94825)。频率和路由控制并不会分离同模型审查的推理强度。
+
+## 配置
+
+```yaml
+# In ~/.hermes/config.yaml
+memory:
+  memory_enabled: true
+  user_profile_enabled: true
+  memory_char_limit: 2200   # ~800 tokens
+  user_char_limit: 1375     # ~500 tokens
+```
+
+## 外部记忆提供商
+
+对于超出 MEMORY.md 和 USER.md 范围的更深层持久化记忆，Hermes 内置了 8 个外部记忆提供商插件——包括 Honcho、OpenViking、Mem0、Hindsight、Holographic、RetainDB、ByteRover 和 Supermemory。
+
+外部提供商与内置记忆**并行**运行（而非替代），并增加了知识图谱、语义搜索、自动事实提取和跨会话用户建模等能力。
+
+```bash
+hermes memory setup      # 选择并配置提供商
+hermes memory status     # 查看当前激活状态
+```
+
+有关每个提供商的完整详情、设置说明和对比，请参阅[记忆提供商](./memory-providers.md)指南。

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/overview.md

@@ -0,0 +1,52 @@
+---
+title: "功能概览"
+sidebar_label: "概览"
+sidebar_position: 1
+---
+
+# 功能概览
+
+Hermes Agent 包含一套丰富的能力，远超基础聊天范畴。从持久化记忆、文件感知上下文，到浏览器自动化和语音对话，这些功能协同工作，使 Hermes 成为一个强大的自主助手。
+
+## 核心功能
+
+- **[工具与工具集](tools.md)** — 工具是扩展 Agent 能力的函数。它们被组织成逻辑工具集，可按平台启用或禁用，涵盖网络搜索、终端执行、文件编辑、记忆、委派等功能。
+- **[技能系统](skills.md)** — Agent 可按需加载的知识文档。技能遵循渐进式披露模式以最小化 token 用量，并兼容 [agentskills.io](https://agentskills.io/specification) 开放标准。
+- **[持久化记忆](memory.md)** — 跨会话持久保存的有界、精选记忆。Hermes 通过 `MEMORY.md` 和 `USER.md` 记住你的偏好、项目、环境及已学习的内容。
+- **[上下文文件](context-files.md)** — Hermes 自动发现并加载项目上下文文件（`.hermes.md`、`AGENTS.md`、`CLAUDE.md`、`SOUL.md`、`.cursorrules`），这些文件决定了它在你项目中的行为方式。
+- **[上下文引用](context-references.md)** — 输入 `@` 后跟引用内容，可将文件、文件夹、git diff 和 URL 直接注入消息中。Hermes 会内联展开引用并自动附加相应内容。
+- **[检查点](../checkpoints-and-rollback.md)** — Hermes 在进行文件更改前自动为工作目录创建快照，提供安全网，可通过 `/rollback` 回滚至出错前的状态。
+
+## 自动化
+
+- **[定时任务（Cron）](cron.md)** — 使用自然语言或 cron 表达式调度自动运行的任务。任务可附加技能、将结果推送至任意平台，并支持暂停/恢复/编辑操作。
+- **[子 Agent 委派](delegation.md)** — `delegate_task` 工具可生成具有独立上下文、受限工具集和独立终端会话的子 Agent 实例。默认并发运行 3 个子 Agent（可配置），支持并行工作流。
+- **[代码执行](code-execution.md)** — `execute_code` 工具允许 Agent 编写以编程方式调用 Hermes 工具的 Python 脚本，通过沙箱 RPC 执行将多步骤工作流压缩为单次 LLM 调用。
+- **[事件 Hook](hooks.md)** — 在关键生命周期节点运行自定义代码。Gateway hook 处理日志、告警和 webhook；plugin hook 处理工具拦截、指标和护栏。
+- **[批处理](batch-processing.md)** — 跨数百或数千个 prompt（提示词）并行运行 Hermes Agent，生成 ShareGPT 格式的结构化轨迹数据，用于训练数据生成或评估。
+
+## 媒体与网络
+
+- **[语音模式](voice-mode.md)** — 跨 CLI 和消息平台的完整语音交互。使用麦克风与 Agent 对话，收听语音回复，并在 Discord 语音频道中进行实时语音对话。
+- **[浏览器自动化](browser.md)** — 支持多种后端的完整浏览器自动化：Browserbase 云端、Browser Use 云端、通过 CDP 连接的本地 Chrome/Brave/Chromium/Edge，或本地 Chromium。可导航网站、填写表单并提取信息。
+- **[视觉与图片粘贴](vision.md)** — 多模态视觉支持。将剪贴板中的图片粘贴到 CLI，并使用任意支持视觉的模型请求 Agent 分析、描述或处理图片。
+- **[图像生成](image-generation.md)** — 使用 FAL.ai 从文本 prompt 生成图像。支持九种模型（FLUX 2 Klein/Pro、GPT-Image 1.5/2、Nano Banana Pro、Ideogram V3、Recraft V4 Pro、Qwen、Z-Image Turbo）；可通过 `hermes tools` 选择。
+- **[语音与 TTS](tts.md)** — 跨所有消息平台的文字转语音输出和语音消息转录，提供十种原生提供商选项：Edge TTS（免费）、ElevenLabs、OpenAI TTS、MiniMax、Mistral Voxtral、Google Gemini、xAI、NeuTTS、KittenTTS 和 Piper——以及支持任意本地 TTS CLI 的自定义命令提供商。
+
+## 集成
+
+- **[MCP 集成](mcp.md)** — 通过 stdio 或 HTTP 传输连接任意 MCP 服务器。无需编写原生 Hermes 工具，即可访问来自 GitHub、数据库、文件系统和内部 API 的外部工具。支持按服务器过滤工具及 sampling（采样）。
+- **[提供商路由](provider-routing.md)** — 对 AI 提供商处理请求的方式进行精细控制。通过排序、白名单、黑名单和优先级排序，在成本、速度或质量之间优化。
+- **[备用提供商](fallback-providers.md)** — 当主模型遇到错误时自动故障转移至备用 LLM 提供商，包括针对视觉和压缩等辅助任务的独立备用机制。
+- **[凭证池](credential-pools.md)** — 在同一提供商的多个密钥之间分发 API 调用。在触发速率限制或发生故障时自动轮换。
+- **[Prompt 缓存](../configuration#prompt-caching)** — 针对原生 Anthropic、OpenRouter 和 Nous Portal 上的 Claude，内置跨会话 1 小时前缀缓存。始终开启，无需配置。
+- **[记忆提供商](memory-providers.md)** — 接入外部记忆后端（Honcho、OpenViking、Mem0、Hindsight、Holographic、RetainDB、ByteRover、Supermemory），实现跨会话用户建模和超越内置记忆系统的个性化。
+- **[API 服务器](api-server.md)** — 将 Hermes 作为兼容 OpenAI 的 HTTP 端点暴露。连接任何支持 OpenAI 格式的前端——Open WebUI、LobeChat、LibreChat 等。
+- **[IDE 集成（ACP）](acp.md)** — 在兼容 ACP 的编辑器（如 VS Code、Zed 和 JetBrains）中使用 Hermes。聊天、工具活动、文件 diff 和终端命令均在编辑器内渲染。
+- **[强化学习训练](rl-training.md)** — 从 Agent 会话中生成轨迹数据，用于强化学习和模型微调。
+
+## 自定义
+
+- **[个性与 SOUL.md](personality.md)** — 完全可自定义的 Agent 个性。`SOUL.md` 是主要身份文件——系统提示词中的第一项——你可以在每个会话中切换内置或自定义的 `/personality` 预设。
+- **[皮肤与主题](skins.md)** — 自定义 CLI 的视觉呈现：横幅颜色、加载动画图标和动词、响应框标签、品牌文字，以及工具活动前缀。
+- **[插件](plugins.md)** — 无需修改核心代码即可添加自定义工具、hook 和集成。三种插件类型：通用插件（工具/hook）、记忆提供商（跨会话知识）和上下文引擎（替代上下文管理）。通过统一的 `hermes plugins` 交互式界面管理。

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/personality.md

@@ -0,0 +1,271 @@
+---
+sidebar_position: 9
+title: "个性与 SOUL.md"
+description: "通过全局 SOUL.md、内置个性预设和自定义角色定义来自定义 Hermes Agent 的个性"
+---
+
+# 个性与 SOUL.md
+
+Hermes Agent 的个性完全可自定义。`SOUL.md` 是**主要身份标识**——它是系统提示词（prompt）中的第一项内容，定义了 Agent 是谁。
+
+- `SOUL.md` — 存放在 `HERMES_HOME` 中的持久角色文件，作为 Agent 的身份标识（系统提示词中的第 1 个槽位）
+- 内置或自定义的 `/personality` 预设 — 会话级系统提示词覆盖层
+
+如果你想改变 Hermes 的身份，或将其替换为完全不同的 Agent 角色，请编辑 `SOUL.md`。
+
+## SOUL.md 的工作方式
+
+Hermes 现在会自动在以下位置生成默认的 `SOUL.md`：
+
+```text
+~/.hermes/SOUL.md
+```
+
+更准确地说，它使用当前实例的 `HERMES_HOME`，因此如果你以自定义主目录运行 Hermes，它将使用：
+
+```text
+$HERMES_HOME/SOUL.md
+```
+
+### 重要行为
+
+- **SOUL.md 是 Agent 的主要身份标识。** 它占据系统提示词的第 1 个槽位，替代硬编码的默认身份。
+- 如果 `SOUL.md` 尚不存在，Hermes 会自动创建一个初始文件
+- 已有的用户 `SOUL.md` 文件不会被覆盖
+- Hermes 仅从 `HERMES_HOME` 加载 `SOUL.md`
+- Hermes 不会在当前工作目录中查找 `SOUL.md`
+- 如果 `SOUL.md` 存在但为空，或无法加载，Hermes 将回退到内置的默认身份
+- 如果 `SOUL.md` 有内容，该内容在经过安全扫描和截断处理后将原样注入
+- SOUL.md **不会**在上下文文件部分重复出现——它仅作为身份标识出现一次
+
+这使 `SOUL.md` 成为真正的每用户或每实例身份标识，而不仅仅是一个附加层。
+
+## 此设计的原因
+
+这样可以保持个性的可预测性。
+
+如果 Hermes 从你启动它的任意目录加载 `SOUL.md`，你的个性可能会在不同项目之间意外改变。通过仅从 `HERMES_HOME` 加载，个性归属于 Hermes 实例本身。
+
+这也让用户更容易理解：
+- "编辑 `~/.hermes/SOUL.md` 来更改 Hermes 的默认个性。"
+
+## 编辑位置
+
+对于大多数用户：
+
+```bash
+~/.hermes/SOUL.md
+```
+
+如果你使用自定义主目录：
+
+```bash
+$HERMES_HOME/SOUL.md
+```
+
+## SOUL.md 应该写什么？
+
+用于持久的语气和个性指导，例如：
+- 语气
+- 沟通风格
+- 直接程度
+- 默认交互风格
+- 风格上应避免的内容
+- Hermes 应如何处理不确定性、分歧或模糊情况
+
+不适合写入的内容：
+- 一次性项目说明
+- 文件路径
+- 代码库规范
+- 临时工作流细节
+
+这些内容属于 `AGENTS.md`，而不是 `SOUL.md`。
+
+## 优质 SOUL.md 内容
+
+一个好的 SOUL 文件应该：
+- 在不同上下文中保持稳定
+- 足够宽泛，适用于多种对话场景
+- 足够具体，能实质性地塑造语气
+- 专注于沟通和身份，而非特定任务的指令
+
+### 示例
+
+```markdown
+# Personality
+
+You are a pragmatic senior engineer with strong taste.
+You optimize for truth, clarity, and usefulness over politeness theater.
+
+## Style
+- Be direct without being cold
+- Prefer substance over filler
+- Push back when something is a bad idea
+- Admit uncertainty plainly
+- Keep explanations compact unless depth is useful
+
+## What to avoid
+- Sycophancy
+- Hype language
+- Repeating the user's framing if it's wrong
+- Overexplaining obvious things
+
+## Technical posture
+- Prefer simple systems over clever systems
+- Care about operational reality, not idealized architecture
+- Treat edge cases as part of the design, not cleanup
+```
+
+## Hermes 注入提示词的内容
+
+`SOUL.md` 的内容直接进入系统提示词的第 1 个槽位——即 Agent 身份位置。不会在其周围添加任何包装语言。
+
+内容会经过以下处理：
+- 提示词注入扫描
+- 内容过大时进行截断
+
+如果文件为空、仅含空白字符或无法读取，Hermes 将回退到内置默认身份（"You are Hermes Agent, built by Nous Research. Be direct: match the length of your reply to the weight of the ask..."）。当 `skip_context_files` 被设置时（例如在子 Agent/委托上下文中），同样适用此回退。
+
+## 安全扫描
+
+`SOUL.md` 与其他携带上下文的文件一样，在被包含前会进行提示词注入模式扫描。
+
+这意味着你仍应将其专注于角色/语气，而不是试图混入奇怪的元指令。
+
+## SOUL.md 与 AGENTS.md
+
+这是最重要的区别。
+
+### SOUL.md
+用于：
+- 身份
+- 语气
+- 风格
+- 沟通默认值
+- 个性层面的行为
+
+### AGENTS.md
+用于：
+- 项目架构
+- 编码规范
+- 工具偏好
+- 代码库特定工作流
+- 命令、端口、路径、部署说明
+
+一个实用的判断规则：
+- 如果它应该随你到处适用，属于 `SOUL.md`
+- 如果它属于某个项目，属于 `AGENTS.md`
+
+## SOUL.md 与 `/personality`
+
+`SOUL.md` 是你的持久默认个性。
+
+`/personality` 是会话级覆盖层，用于更改或补充当前系统提示词。
+
+因此：
+- `SOUL.md` = 基础语气
+- `/personality` = 临时模式切换
+
+示例：
+- 保持务实的默认 SOUL，然后在辅导对话中使用 `/personality teacher`
+- 保持简洁的 SOUL，然后在头脑风暴时使用 `/personality creative`
+
+## 内置个性
+
+Hermes 内置了多种个性，可通过 `/personality` 切换。
+
+| 名称 | 描述 |
+|------|-------------|
+| **helpful** | 友好的通用助手 |
+| **concise** | 简短、直击要点的回复 |
+| **technical** | 详尽、准确的技术专家 |
+| **creative** | 创新、突破常规的思维 |
+| **teacher** | 耐心的教育者，配有清晰示例 |
+| **kawaii** | 可爱表达、闪光效果与热情 ★ |
+| **catgirl** | 带有猫咪表达方式的 Neko-chan，nya~ |
+| **pirate** | 船长 Hermes，精通技术的海盗 |
+| **shakespeare** | 充满戏剧张力的吟游诗人风格 |
+| **surfer** | 超级冷静的冲浪者氛围 |
+| **noir** | 硬派侦探叙事风格 |
+| **uwu** | 极致可爱的 uwu 语气 |
+| **philosopher** | 对每个问题深度沉思 |
+| **hype** | 最大能量与热情！！！ |
+
+## 使用命令切换个性
+
+### CLI
+
+```text
+/personality
+/personality concise
+/personality technical
+```
+
+### 消息平台
+
+```text
+/personality teacher
+```
+
+这些是便捷的覆盖层，但你的全局 `SOUL.md` 仍然赋予 Hermes 持久的默认个性，除非覆盖层对其进行了实质性更改。
+
+## 在配置中定义自定义个性
+
+你也可以在 `~/.hermes/config.yaml` 的 `agent.personalities` 下定义命名的自定义个性。
+
+```yaml
+agent:
+  personalities:
+    codereviewer: >
+      You are a meticulous code reviewer. Identify bugs, security issues,
+      performance concerns, and unclear design choices. Be precise and constructive.
+```
+
+然后通过以下方式切换：
+
+```text
+/personality codereviewer
+```
+
+## 推荐工作流
+
+一个强健的默认配置：
+
+1. 在 `~/.hermes/SOUL.md` 中维护一个经过深思熟虑的全局 `SOUL.md`
+2. 将项目说明放在 `AGENTS.md` 中
+3. 仅在需要临时模式切换时使用 `/personality`
+
+这样你将获得：
+- 稳定的语气
+- 项目特定行为归属于正确位置
+- 需要时的临时控制
+
+## 个性如何与完整提示词交互
+
+从高层次来看，提示词栈包含：
+1. **SOUL.md**（Agent 身份——如果 SOUL.md 不可用则使用内置回退）
+2. 工具感知行为指导
+3. 记忆/用户上下文
+4. 技能指导
+5. 上下文文件（`AGENTS.md`、`.cursorrules`）
+6. 时间戳
+7. 平台特定格式提示
+8. 可选的系统提示词覆盖层，如 `/personality`
+
+`SOUL.md` 是基础——其他所有内容都建立在它之上。
+
+## 相关文档
+
+- [上下文文件](/user-guide/features/context-files)
+- [配置](/user-guide/configuration)
+- [技巧与最佳实践](/guides/tips)
+- [SOUL.md 指南](/guides/use-soul-with-hermes)
+
+## CLI 外观与对话个性
+
+对话个性与 CLI 外观是相互独立的：
+
+- `SOUL.md`、`agent.system_prompt` 和 `/personality` 影响 Hermes 的说话方式
+- `display.skin` 和 `/skin` 影响 Hermes 在终端中的显示外观
+
+关于终端外观，请参阅 [皮肤与主题](./skins.md)。