词元广场TOKPUB.COM - 欢迎您，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"技巧与最佳实践"
技巧与最佳实践
获得最佳结果
明确说明你的需求
api/handlers.py 第 47 行的 TypeError——process_request() 函数从 parse_body() 收到了 None。"给出的上下文越多，所需的迭代次数就越少。预先提供上下文
使用上下文文件处理重复指令
/api/v2"），把它们放进 AGENTS.md 文件。agent 每次会话都会自动读取它——设置一次，永久生效。让 Agent 使用它的工具
tests/test_foo.py，看第 42 行，然后……"。agent 拥有文件搜索、终端访问和代码执行能力——让它自行探索和迭代。对复杂工作流使用 Skill
/skills 浏览可用的 skill，或直接调用，例如 /axolotl 或 /github-pr-workflow。CLI 高级用户技巧
多行输入
Shift+Enter 仅在终端将其作为独立按键发送时有效（Kitty / foot / WezTerm / Ghostty 默认支持；iTerm2 / Alacritty / VS Code 终端需启用 Kitty 键盘协议）。另外两种方式在所有终端中均可使用。粘贴检测
中断与重定向
使用 -c 恢复会话
hermes -c 可精确恢复到上次离开的位置，完整对话历史全部还原。也可以按标题恢复：hermes -r "my research project"。剪贴板图片粘贴
Slash 命令自动补全
/ 后按 Tab 可查看所有可用命令，包括内置命令（/compress、/model、/title）和所有已安装的 skill。无需记忆任何内容——Tab 补全全部搞定。提示
/verbose 循环切换工具输出显示模式：off → new → all → verbose。"all" 模式非常适合观察 agent 的操作过程；"off" 模式在简单问答时最为简洁。上下文文件
AGENTS.md：你的项目大脑
AGENTS.md，写入架构决策、编码规范和项目专属指令。该文件会自动注入每次会话，让 agent 始终了解你的项目规则。SOUL.md：自定义个性
~/.hermes/SOUL.md（如果使用自定义 Hermes home，则为 $HERMES_HOME/SOUL.md）。Hermes 现在会自动生成一个初始 SOUL 文件，并将该全局文件作为实例级个性来源。SOUL.md 设置持久个性，使用 AGENTS.md 设置项目专属指令。.cursorrules 兼容性
.cursorrules 或 .cursor/rules/*.mdc 文件？Hermes 同样会读取它们。无需重复编写编码规范——这些文件会从工作目录自动加载。发现机制
AGENTS.md。子目录中的 AGENTS.md 文件在工具调用期间通过 subdirectory_hints.py 延迟发现，并注入工具结果——不会在启动时预先加载到系统 prompt 中。提示
记忆与 Skill
记忆 vs. Skill：各司其职
何时创建 Skill
deploy-staging 的 skill"。下次只需输入 /deploy-staging，agent 就会加载完整流程。管理记忆容量
MEMORY.md 约 2,200 字符，USER.md 约 1,375 字符）。当记忆填满时，agent 会自动整合条目。你也可以主动说"清理你的记忆"或"替换旧的 Python 3.9 备注——我们现在用 3.12 了"。让 Agent 记住内容
deploy.yml 工作流。"警告
性能与成本
不要破坏 Prompt 缓存
在达到限制前使用 /compress
/compress。这会对对话历史进行摘要，在大幅减少 token 数量的同时保留关键上下文。使用 /usage 查看当前用量。使用委托实现并行工作
delegate_task 并行分配子任务。每个子 agent 独立运行，拥有各自的上下文，最终只有摘要结果返回——大幅减少主对话的 token 消耗。使用 execute_code 进行批量操作
.jpeg 文件重命名为 .jpg 并运行它"比逐个重命名文件更省钱、更快速。选择合适的模型
/model 在会话中途切换模型。对于复杂推理和架构决策，使用前沿模型（Claude Sonnet/Opus、GPT-4o）；对于格式化、重命名或样板代码生成等简单任务，切换到更快的模型。提示
/usage 查看 token 消耗情况。运行 /insights 可查看过去 30 天的用量模式概览。消息技巧
设置主频道
/sethome，将其指定为主频道。定时任务结果和计划任务输出会发送到这里。没有主频道，agent 就没有地方发送主动消息。使用 /title 整理会话
/title auth-refactor 或 /title research-llm-quantization 为会话命名。命名后的会话可通过 hermes sessions list 轻松找到，并用 hermes -r "auth-refactor" 恢复。未命名的会话会堆积起来，难以区分。DM 配对实现团队访问
hermes pairing approve telegram XKGH5N7P 批准即可——简单且安全。工具进度显示模式
/verbose 控制工具活动的显示详细程度。在消息平台上，通常越简洁越好——保持"new"模式只查看新的工具调用。在 CLI 中，"all" 模式可以实时查看 agent 的所有操作。提示
~/.hermes/config.yaml 中按平台调整。安全
对不可信代码使用 Docker
.env 中设置 TERMINAL_BACKEND=docker。容器内的破坏性命令不会影响宿主系统。避免 Windows 编码陷阱
cp125x）无法表示所有 Unicode 字符，在测试或脚本中写入文件时可能导致 UnicodeEncodeError。$OutputEncoding = [Console]::OutputEncoding = [Text.UTF8Encoding]::new($false)谨慎选择"始终允许"
rm -rf、DROP TABLE 等）时，你有四个选项：once（仅此一次）、session（本次会话）、always（始终允许）、deny（拒绝）。选择"always"前请仔细考虑——它会永久将该模式加入白名单。在熟悉之前，先用"session"。命令审批是你的安全防线
警告
为消息 Bot 使用白名单
GATEWAY_ALLOW_ALL_USERS=true。始终使用平台专属白名单（TELEGRAM_ALLOWED_USERS、DISCORD_ALLOWED_USERS）或 DM 配对来控制谁可以与你的 agent 交互。