Menu
智控助手使用指南，包括对话、技能管理、斜杠命令、快捷键
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
多模态服务指南，包括图片生成、视频生成、语音合成、音乐生成的配置与使用
系统概述，介绍 Protocol Proxy 的定位、核心能力和典型使用场景
供应商管理指南，包括创建供应商、配置 API Key、密钥轮换
监控与日志指南，包括用量统计、请求日志、系统日志查看
MCP 服务配置指南，包括添加、连接、排查 MCP 服务器
系统诊断工具，包括健康检查、日志分析、代理诊断、MCP 诊断
| name | guide-assistant |
| description | 智控助手使用指南，包括对话、技能管理、斜杠命令、快捷键 |
| trigger | 用户询问智控助手怎么用、技能怎么创建、斜杠命令、怎么中断 AI、怎么切换模型、对话管理、技能触发、子任务、子智能体、委派任务、SOUL、人设、工具审批 |
智控助手是基于 AI 的管理工具，可以通过自然语言与系统交互，支持 MCP 工具调用和 Skill 扩展。
| 配置项 | 含义 | 说明 |
|---|---|---|
| 后端代理 | 用于连接 AI 服务的代理 | 必须选择一个运行中的代理 |
| 供应商 | 指定使用哪个供应商的 AI | 默认为「跟随代理」，即使用代理配置的供应商 |
| 模型 | 指定使用的 AI 模型 | 默认为「跟随代理」，即使用代理配置的默认模型 |
| 会话 | 对话历史管理 | 可创建新会话或切换到历史会话 |
| 要求 | 说明 |
|---|---|
| 必须运行中 | 代理必须在「运行中」状态才能使用 |
| 协议匹配 | 代理的协议需要与 AI 服务兼容（OpenAI 格式推荐） |
| 配置项 | 含义 | 影响 |
|---|---|---|
| 上下文大小 | 模型能处理的最大 token 数 | 影响压缩触发阈值 |
| 最大工具调用轮次 | 单次对话中模型连续调用工具的最大次数 | 到达上限后模型自动总结回复 |
| 最大会话数 | 保存的历史会话数量上限 | 超出自动删除最早的会话，0 表示不限制 |
| 操作 | 说明 |
|---|---|
| 新会话 | 点击「新会话」按钮清空当前对话 |
| 切换会话 | 点击会话下拉框选择历史会话 |
| 压缩上下文 | 当上下文接近上限时，点击「压缩」按钮整理对话 |
AI 也可通过工具管理会话：
| 工具 | 功能 |
|---|---|
list_conversations | 列出所有历史会话（含消息数和预览） |
delete_conversation | 删除指定会话 |
clear_conversation | 清空指定会话的消息历史 |
智控助手会跟踪对话上下文：
在智控助手输入框中输入 / 可触发自动补全，显示可用的客户端命令和技能。客户端命令直接在浏览器端处理，不发送到 AI。
| 命令 | 功能 | 说明 |
|---|---|---|
/help | 显示帮助 | 列出所有可用命令和技能 |
/clear | 清空对话 | 清除当前对话的显示内容 |
/new | 新建会话 | 开启一个全新的对话会话 |
/compact | 压缩上下文 | 将当前对话历史压缩为摘要，释放上下文空间 |
/model | 切换模型 | 弹出模型选择器，快速切换当前使用的 AI 模型 |
命令优先级：客户端命令优先于技能。例如输入 /help 匹配客户端命令，不会发送到 AI；输入 /health-check 无客户端命令匹配时，正常触发对应技能。
当 AI 正在生成回复时，可以随时中断：
| 方式 | 操作 |
|---|---|
| 键盘 | 按 Escape 键中断当前响应 |
| 按钮 | 点击发送按钮变为的「停止」按钮 |
中断后，AI 已生成的内容会保留，后续内容不再生成。
技能管理是智控助手的核心扩展机制，允许通过自然语言指令扩展 AI 的能力边界。
技能有三种触发方式：
/技能名 或在技能面板点击trigger 条件时，AI 会自动调用该技能invoke_skill 工具主动加载技能| 方式 | 操作 |
|---|---|
| 斜杠触发 | 输入 /技能名 直接触发，如 /health-check |
| 自动补全 | 输入 / 后继续输入文字，自动匹配命令和技能，支持 ↑↓ 键盘导航 |
| 面板加载 | 点击输入框右侧「⚡」按钮，在技能面板中点击加载 |
| AI 自动触发 | AI 根据技能的 trigger 条件自动判断是否需要调用 |
| 字段 | 含义 | 示例 |
|---|---|---|
| 名称 | 技能的唯一标识，英文 | my-helper |
| 描述 | 技能功能说明 | 帮助整理代码规范 |
| 触发条件 | AI 何时应自动使用此技能 | 用户要求检查代码规范、整理代码风格 |
| 内容 | 技能的详细指令（Markdown 格式） | 技能执行的具体步骤和规则 |
trigger 字段描述了技能应在什么场景下被使用，帮助 AI 判断是否需要调用：
trigger: 用户要求分析日志、查找错误、排查问题趋势
| 建议 | 说明 |
|---|---|
| 明确步骤 | 使用编号列表描述执行步骤 |
| 指定工具 | 如需调用 API，列出需要使用的工具名 |
| 输出格式 | 说明期望的输出格式（表格、列表等） |
| 边界条件 | 描述异常情况的处理方式 |
如果技能需要调用 MCP 工具，在技能内容中说明即可：
1. 调用 `web_search` 搜索相关信息
2. 分析搜索结果
3. 汇总输出
AI 会自动在技能执行过程中调用对应的 MCP 工具。
MCP 服务器可为 AI 提供额外工具能力。系统预置了 10+ 个常用 MCP 配置（Filesystem、Context7、Chrome DevTools 等），详见 /guide-mcp 技能。
智控助手支持将复杂任务拆分为多个子任务，并行委派给子智能体执行。
直接用自然语言描述需要完成的任务，AI 会根据需要自动调用 delegate_task 工具：
子代理支持权限分化，不同权限决定可用的工具和操作范围：
| 权限 | 适用场景 | 能力 |
|---|---|---|
full | 通用任务（默认） | 继承全局配置 |
readonly | 搜索、分析、审查、规划 | 只读，无法修改文件或执行命令 |
writer | 编码、重构、跑测试 | 可写项目文件，可执行命令（受策略控制） |
权限可通过 delegate_task 的 role 参数（统一权限）或 goal_roles 数组（每个子任务不同权限）指定。详细的委派指南可通过 /delegate 技能查看。
子任务创建后，可通过以下工具查看和管理：
| 工具 | 功能 | 说明 |
|---|---|---|
list_tasks | 列出子任务 | 可按状态筛选（created/running/completed/failed/stopped） |
get_task | 查看详情 | 获取单个子任务的完整信息 |
stop_task | 终止任务 | 停止正在运行的子任务 |
message_task | 追加消息 | 向已完成或失败的子任务追加消息，可指定额外轮次继续执行 |
list_agents | 列出代理身份 | 查看所有可用的代理身份（用于 delegate_task 的 agent 参数） |
子智能体运行在受限沙盒中：递归委派被阻止，写入隔离在沙盒目录内，危险命令由执行策略引擎拦截。详见 /guide-settings 第三节（子智能体设置）和第六节（执行策略）。
子任务卡片会在对话中实时显示状态变化：
| 状态 | 含义 |
|---|---|
| created | 已创建，等待执行 |
| running | 正在执行 |
| completed | 执行完成，显示结果摘要 |
| failed | 执行失败，显示错误信息 |
| stopped | 被手动终止 |
Agent 身份用于定义子代理的人设和行为风格，可通过 delegate_task 的 agent 参数指定。
| 工具 | 功能 |
|---|---|
list_agents | 列出所有可用的代理身份 |
get_agent | 获取单个 Agent 的详细信息 |
create_agent | 创建新的 Agent 身份（名称、人设、颜色、角色） |
update_agent | 修改已有 Agent 身份的配置 |
delete_agent | 删除非系统级 Agent 身份 |
reload_agents | 从磁盘重新加载所有 Agent 定义 |
智能体支持自定义人设（Persona），通过 SOUL.md 定义智能体的角色、性格和行为准则。
| 操作 | 方式 |
|---|---|
| 查看 | 在「设置」→「记忆」中查看当前人设，或使用 get_memory 工具 |
| 修改 | 在「设置」→「记忆」中编辑，或使用 update_soul 工具 |
| 生效 | 人设内容会在每次对话时注入系统提示词，修改后立即生效 |
当 AI 调用高权限工具（如写入文件、执行命令）时，系统会弹出审批请求：
| 操作 | 说明 |
|---|---|
| 批准 | 允许本次工具调用执行 |
| 拒绝 | 阻止本次工具调用，AI 会收到拒绝提示 |
工具审批权限可在「设置」中配置，也可通过工具权限分级自动控制。
/guide-client-configget_mcp_presets 获取预置 MCP 服务器列表并引导安装，详见 /guide-mcp| 快捷键 | 功能 |
|---|---|
| Enter | 发送消息 |
| Shift + Enter | 输入换行 |
| Escape | 中断 AI 响应 / 关闭自动补全 |
| / | 触发命令和技能自动补全 |
| ↑↓ | 在自动补全列表中导航选择 |
| Enter（补全列表中） | 确认选中项 |
智控助手支持自然语言交互，以下是典型场景：
| 指令示例 | 说明 |
|---|---|
| "帮我看看系统状态" | 获取代理、密钥、供应商运行状态 |
| "启动所有代理" / "停止代理 xxx" | 管理代理启停 |
| "帮我新建一个 OpenAI 供应商" | 创建供应商 |
| "分析最近的请求日志，看看有什么问题" | 排查请求问题 |
| "帮我开启开机自启动" | 管理开机自启 |
| "添加一条允许 npm install 的执行策略" | 管理命令执行策略 |
| "帮我把代理配置写入 Claude Code" | 客户端配置管理 |
| "测试一下代理 xxx 的连通性" | 客户端连接测试 |
| "创建一个代码审查 Agent" | Agent 身份管理 |
| "推荐几个好用的 MCP 服务器" | MCP 预设推荐 |