Atomic Chat 自定义助手教程：如何设置System Prompt与采样参数打造专属AI角色

Atomic Chat 是一款完全在本地运行的开源 AI 桌面应用，可离线跑开源大模型，隐私安全 100% 有保障。除了直接聊天，它还内置了**自定义助手（Assistant）**功能：你可以为每个助手单独编写 System Prompt（系统提示词），并调节温度（Temperature）、Top P、Top K 等采样参数，几分钟就能打造出一个"法律顾问""旅行规划师"或"专属写作搭档"般的 AI 角色，且配置全部保存在本地。

一、助手在哪里设置？认识 Atomic Chat 的助手功能

Atomic Chat 的助手功能有两个入口，覆盖"创建"和"快速微调"两种场景：

助手的完整资料（名称、头像、描述、System Prompt、采样参数）会持久化保存到本地，重启应用后依然生效。管理界面代码位于 assistant.tsx，新建/编辑弹窗在 AddEditAssistant.tsx。

二、四步创建专属助手：从头像到保存

第 1 步：打开设置页。点击左侧栏底部Settings（设置），进入Assistants页面，点击右上角带+号的Add Assistant按钮。

第 2 步：填写基本信息。弹窗中有 4 个字段：

• Emoji 头像：点击笑脸图标，从表情选择器里挑一个（如 🧑‍⚖️ 配律师、✈️ 配旅行助手）；
• Name：助手名称，必填，比如"合同审核专员"；
• Description：一句话介绍，方便日后区分；
• Instructions：这就是System Prompt 输入框，下一节详解。

第 3 步：保存。点击Save，助手立即出现在列表中。

第 4 步（可选）：设为默认助手。在列表上方的 "Default Assistant" 下拉框里选择它，之后每次新开的对话都会自动使用这个角色。

💡 小技巧：在聊天界面的运行设置面板里也能直接新建助手，且会立刻应用到当前对话，不用来回切换页面。

三、System Prompt 怎么写：让角色"听话"的 4 个要点

System Prompt 是助手每次对话前都会"背"的一段角色指令，它决定了 AI 的语气、专长和输出格式。原子聊天内置的默认助手就写了一句简单的角色设定（见 useAssistant.ts），你可以照着下面的模板升级：

1. 先定身份：开头一句"你是谁"。例如"你是一名资深合同审核律师，精通数据保护与劳动法规。"
2. 再定风格：说明语气和深度。例如"回答简洁专业，用列表输出风险点，必要时给出改写建议。"
3. 再定格式：规定输出结构。例如"先给结论，再列 3 条依据，最后给 1 条改进建议。"
4. 善用日期占位符：输入{{current_date}}，应用会在发送时自动替换成今天日期（界面下方有提示），模型就不会再闹"我不知道现在几月"的笑话。

📌 写好 System Prompt 后，下一条消息发送时就会生效，无需重新加载模型。

四、采样参数速查：7 个滑块一次看懂

采样参数控制模型"怎么说话"：温度越高越有创意，惩罚项越强越不啰嗦。所有参数的定义与默认值见 predefinedParams.ts，调节面板组件在 ParametersSection.tsx。

新手调参口诀：

• 🎯要精准、要稳定（审核、计算、代码）：温度调低到 0.3–0.5；
• ✍️要创意、要文采（写作、头脑风暴）：温度提到 0.8–1.0，可再加一点 Frequency Penalty 防重复；
• ⚠️ 拿不准就点面板顶部的Reset Sampling（恢复默认），一键回到出厂值，不会把模型"调废"。

五、快速微调：在聊天里实时调参

切换助手或调参数不必离开对话界面：

1. 打开聊天界面右侧的运行设置面板（Run settings，实现见 RunSettingsPanel.tsx）；
2. 顶部下拉框切换当前对话使用的助手；
3. 在 Instructions 文本框中直接改写 System Prompt（边写边存，防抖自动落盘）；
4. 往下滚动，拖动 Sampling 与 Penalties 分组里的滑块，改动即时保存到该助手。

⚙️ 注意：采样滑块只在本地引擎（llama.cpp、MLX 等）下显示——云端 API 服务商会自行管理这些值，面板会自动隐藏，避免"调了个寂寞"。

六、总结：三步拥有你的专属 AI 角色

• ✅创建：设置 → Assistants → Add Assistant，起名字、挑头像；
• ✅定人设：System Prompt 写清"身份 + 风格 + 格式"，加上{{current_date}}；
• ✅调性格：精准任务降温度，创意任务升温度，不满意一键 Reset。

全部配置保存在你电脑上，模型与对话 100% 离线运行——你的专属 AI 角色，只属于你自己。更多细节可参考 README 与 docs/ 下的官方文档。