Menu
智控助手使用指南，包括对话、技能管理、斜杠命令、快捷键
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
多模态服务指南，包括图片生成、视频生成、语音合成、音乐生成的配置与使用
系统概述，介绍 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 预设推荐 |