better-dsh 0.2.5 → 0.3.0-a

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

@@ -1,233 +0,0 @@
----
-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

@@ -1,52 +0,0 @@
----
-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

@@ -1,271 +0,0 @@
----
-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)。