Assistant Configuration Guide Chinese
本指南说明 AionUi 中助手的工作原理 —— 如何使用 21 个内置助手、用 Rules 和 Skills 定制它们，以及创建自己的助手。
助手是构建在某个 Agent 后端之上的专注型 AI 角色。一个助手包含：
- 后端 Agent —— 真正执行任务的引擎（由 aionrs 驱动的内置 Agent、Claude Code、Codex、Gemini、Qwen、Cursor 等）
- 提示词（Rules） —— Markdown 格式，告诉 Agent 怎么做事
- 一组 技能（Skills） —— 给 Agent 额外能力（PPT、Word、Excel、图表、MCP 工具等）
- 展示元数据：名称、头像（emoji 或内置图标）、描述
AionUi 当前内置 21 个助手，包括 Cowork、PPT Creator、Word Creator、Excel Creator、Morph PPT 3D、Pitch Deck Creator、Dashboard Creator、Academic Paper、Financial Model Creator、UI/UX Pro Max、3D Game、OpenClaw Setup、Beautiful Mermaid、moltbook、Story Roleplay、AionUi Butler 等。
- 本地优先 —— 助手在你本机运行，Rules 以 Markdown 文件保存在数据目录里
- 后端可换 —— 同一份 Rules/Skills 可以挂在不同的 Agent 后端上
- 可定制 —— 内置助手可以改后端、Rules、Skills；自定义助手可以从零开始
- Skills 可叠加 —— 同时启用多个 Skills；Skills 可以是内置、用户导入或扩展提供
- 点击左侧边栏的 设置（⚙️）
- 切换到 助手 标签
- 点击 创建
| 字段 | 必填 | 说明 |
|---|---|---|
| 名称 | ✅ | 助手列表中显示的名字 |
| 头像 | — | 选 emoji（默认 🤖） |
| 描述 | — | 一句话介绍这个助手做什么 |
| 后端 Agent | ✅ | 从可用 Agent 中选择 —— 内置 Agent、Claude Code、Codex、Gemini、Qwen、Cursor、OpenCode、Snow 等 |
💡 可选后端与你本机检测到的 Agent 一致（参见多 Agent 模式）。内置 Agent 随应用提供，无需另装外部 Agent。不同后端对 Rules、Skills、工具和权限的支持可能不同。
Rules 就是助手的系统提示词 —— Markdown 格式，作为普通 .md 文件保存在数据目录里（assistant-rules/<id>.<locale>.md）。助手运行时，AionUi 会把 Rules 作为系统指令喂给后端 Agent。
- 工作流 —— "用户问 X 时，先 A 再 B 然后 C"
- 约束 —— "不要修改项目根目录之外的文件"
- 领域上下文 —— "这个代码库用 Bun + Vite，测试是 Vitest"
- 输出风格 —— "始终用 Markdown 回答，开头先给一个 TL;DR"
- 打开助手 → 找到 Rules 区块
- 在 编辑 标签页写 Markdown
- 在 预览 标签页看渲染效果
- 保存 —— 下次会话生效
# 文件管理助手
## 路径约定
- 用户提到的文件默认在当前项目目录下，除非明确说明
- 只给文件名时用 Glob 查找 —— 不要反问"文件在哪儿"
- 能改现有文件就不要新建文件
## 执行原则
- 复杂任务拆成步骤并汇报进度
- 删除/覆盖等破坏性操作前先确认
- 解决方案保持最小和聚焦- ✅ 写明确 —— 短的祈使句最好用
- ✅ 用标题和列表 —— Agent 会注意结构
- ✅ 对最关心的场景提供具体示例
- ❌ 别把大块参考资料堆在 Rules 里 —— 那是 Skills 的职责
Skills 给助手扩展打包好的能力 —— 文件格式处理器、文档生成器、MCP 工具集、领域参考资料包等。Skills 是 Markdown 文档（SKILL.md），Agent 按需加载。
- 内置（Built-in） —— 随 AionUi 发布（PPT、Word、Excel、Morph PPT、Mermaid 图表等）—— 勾选启用
- 自定义（Custom） —— 你自己的 Skills，从指定文件夹导入
- 扩展（Extension） —— 由外部 Agent 扩展提供
- 在助手编辑页打开 Skills 区块
- 展开 内置 Skills 面板
- 勾选要启用的 Skills（可多选）
- 打开 设置 → Skills
- 导入已有 Skill 文件夹，或创建新 Skill
- 返回 设置 → 助手，打开目标助手
- 在 Skills 区块绑定该 Skill，然后保存
- 启用/禁用 —— 勾选/取消勾选
- 删除自定义 Skill —— 鼠标悬停在条目上，点击 🗑️
- 内置 Skill —— 可以禁用，但无法移除
- 点击编辑器底部的 保存
- 助手出现在欢迎页的助手列表里
- 创建新会话时选择该助手
- 在列表里打开助手，编辑任意字段
- 保存生效
- ✅ 后端 Agent
- ✅ Rules
- ✅ Skills
- ✅ 描述
- ❌ 名称和头像（锁定，保持辨识度）
- ❌ 不能删除
- 完全可编辑，包括名称和头像
- 编辑器底部点 删除 移除（不可恢复）
后端：内置 Agent
Rules：
# 文件管理助手
## 核心职责
- 批量重命名、智能分类、查找重复、格式转换
## 工作原则
- 任何操作前先用 Glob 验证文件位置
- 破坏性操作前先做备份
- 用简洁的要点汇报进度Skills：内置文件工具 + 你自己的文件操作 Skills
后端：Claude Code 或内置 Agent
Rules：
# 代码审查助手
## 审查重点
- 正确性、可读性、性能、安全、项目规范
## 输出格式
- Markdown，按严重程度分组（高 / 中 / 低）
- 引用具体位置：`path:line`
- 每个高优先级问题都给修复建议Skills：代码分析 Skills + 你仓库的 style guide
A：Rules 告诉 Agent 怎么做事（系统提示词）；Skills 给 Agent 额外能力（文件处理器、文档生成器、工具集）。Rules 始终加载；Skills 按需加载。
A：可以，按需开多少都行。
A：一个包含 SKILL.md 的文件夹（Markdown，YAML frontmatter 中包含 name 和 description）。在 设置 → Skills 中导入，再绑定到助手。
A：勾选 = 启用，取消勾选 = 禁用。状态按助手保存。
A：可以改描述、Rules、Skills、后端 Agent；名称和头像锁定；内置助手不能删除（只能禁用）。
A：标准 CommonMark —— 标题、列表、代码块、粗体/斜体、链接、图片。
A：以 .md 文件保存在 AionUi 数据目录里：assistant-rules/<assistant-id>.<locale>.md，可以像普通文本文件一样备份。
需要帮助？
打造你自己的 AI 专家 —— 选后端、写 Rules、装 Skills。