需编辑soul.md文件来调整hermesagent角色设定：一、定位并用utf-8打开该文件，检查yaml front matter；二、修改人设概述、语言风格等段落；三、添加记忆锚点章节并绑定关键词；四、更新yaml元数据确保兼容；五、调用api重载人格并验证生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望调整HermesAgent的行为表现，使其更贴合特定角色设定或交互风格，则需通过编辑SOUL.md文件来直接定义AI的人设与性格特征。以下是具体操作步骤：
一、定位并打开SOUL.md文件
SOUL.md是HermesAgent用于加载人格参数的核心配置文件，其内容以Markdown格式组织，存储在项目根目录或agent/config/子路径下。修改前需确认该文件存在且具备读写权限。
1、进入HermesAgent部署目录，执行命令find . -name "SOUL.md"定位文件路径。
2、使用文本编辑器（如VS Code、nano或Notepad++）以UTF-8编码方式打开该文件。
3、检查文件头部是否存在YAML front matter区块（以---包裹的键值对），该区块常用于声明基础人格元数据。
二、修改人格描述区块
SOUL.md主体部分通常包含“人设概述”“语言风格”“价值观”“禁忌行为”等语义段落。这些段落共同构成AI的认知锚点，直接影响回应倾向与表达节奏。
1、在“人设概述”标题下，将原有描述替换为具象化、可感知的第三人称叙述，例如：“她是一位沉静敏锐的古典文献修复师，说话时习惯停顿半秒，偏好用隐喻而非直述表达观点”。
2、在“语言风格”段落中，明确限定句式偏好与词汇边界，例如：“禁用网络缩略语；每句话结尾避免使用感叹号；主动引入古籍引文频率不低于15%”。
3、删除或注释掉与新设定冲突的旧条款，确保全文无逻辑自洽矛盾。
三、注入记忆锚点与触发关键词
在SOUL.md末尾添加“记忆锚点”章节，可建立稳定的角色唤起机制。该机制使AI在对话中自动关联预设身份线索，增强一致性。
1、新增二级标题## 记忆锚点，在其下方以列表形式罗列3–5个不可替换的核心词。
2、每个锚点词后紧跟一句强制绑定描述，例如：“青檀纸——所有涉及材质的回应必须提及纤维脆性与明代抄本修复实践”。
3、确保所有锚点词在全文其他位置至少出现一次，避免被解析器忽略。
四、验证YAML元数据兼容性
若SOUL.md顶部存在YAML front matter，需同步更新其中的personality_id、tone_weight、formality_level等字段，否则运行时可能加载默认人格模板。
1、检查personality_id值是否与当前定制方案命名一致，例如："personality_id: soul_qingtan"。
2、将tone_weight设为0.85–0.95区间以强化人设权重，避免被上下文临时覆盖。
3、确认formality_level取值为整数1–5，且与语言风格段落中的正式度描述严格对应。
五、重启服务并触发人格重载
HermesAgent默认不会热重载SOUL.md，必须通过显式指令刷新人格缓存，否则修改内容不会生效。
1、执行curl -X POST http://localhost:8000/api/v1/agent/reload-soul发送重载请求。
2、观察终端日志中是否出现[SOUL] Loaded 4 anchor points, 12 trait constraints类提示信息。
3、发起测试对话，首句输入含锚点词的语句，例如：“这张青檀纸边缘有脆化迹象”，验证回应是否激活对应知识域与表达模式。
