全能调用应用能力
34-AI 助手 · 2026-10-12 · 3.9 KB
这一篇回答一个问题：它凭什么"全能"？ —— 因为它用的是应用自己的那套能力工具（uc_do_*），
你在界面上手动能做的事，它基本都能代你做完（查现状 → 建节点 → 连好 → 跑 → 收产物）。
本专题手工维护（2026-10-12 建）；⚠ 工具清单会漂 ⇒ 一律以 tools/list 现查为准（本页只给"族"与代表工具 ✓）。
一、"全能"是怎么实现的
| 事实 | 说明 |
|---|---|
| 同一套工具 | 助手直接调用应用的能力工具（与外部 MCP 客户端同一套注册表）⇒ ⛔ 不存在"助手版能力" ✗ |
| 进程内直连 | 它在应用内部调用（不经 HTTP/MCP 线），所以更快、更稳；外部客户端走网络那一套 ⇒ 见《MCP 指南》✓ |
| 工具定义按模式给 | 只读模式只给它"读 / 查 / 预检"那批；全能力模式给全部已注册工具 ✓ |
⇒ 换句话说："全能"＝工具面的全能（能力边界＝注入给它的工具范围 ✓）
二、能力族总览（它能覆盖的面）
⚠ 族与工具名可能随版本增减 ⇒ 全清单以 tools/list（或应用内「MCP 接口手册」）为准 ✓
| 能力族 | 它能替你做什么 | 代表工具 |
|---|---|---|
| 入门与总览 | 自报家底、健康检查、给提示词建议 | uc_do_gain_agent_overview · uc_do_health · uc_do_suggest_prompt |
| 模板与提示词 | 查有哪些模板、某模板的端口与参数、提示词规范 | uc_do_sheet_templates · uc_do_gain_template_guide · uc_do_gain_template_prompt_rules |
| 画布管理 | 新建/查看画布、列画布、读项目文件 | uc_do_new_canvas · uc_do_gain_canvas · uc_do_sheet_canvases |
| 节点与参数 | 建节点、写参数、写提示词、连线 | uc_do_create_node · uc_do_write_node_params · uc_do_connect_nodes |
| 运行与任务 | 跑节点、等任务、查任务与产物 | uc_do_run_node · uc_do_wait_for_job · uc_do_gain_job_status · uc_do_gain_node_result |
| 媒体与素材 | 建媒体节点、列素材、上传、分析图片 | uc_do_create_media_node · uc_do_sheet_assets · uc_do_analyze_image |
| 导演台与蓝图 | 蓝图校验 / 预检 / 一键调度 | uc_do_validate_blueprint · uc_do_preflight_engine · uc_do_director_run |
| 海报与时间线 | 海报/时间线的规范、校验、保存 | uc_do_gain_poster_spec · uc_do_save_poster · uc_do_validate_timeline |
| 自定义 API | 查自定义 API 预设、纯本地预检、申请授权 | uc_do_gain_custom_api_presets · uc_do_preflight_custom_api · uc_do_request_api_approval |
| 知识库（含技能） | 检索知识、查/写技能 | uc_do_kb_search · uc_do_kb_get · uc_do_kb_skill_list / get / add / edit / del |
| 助手协作 | 写计划清单、向你提问、压缩上下文、一次性生成、存文本 | uc_do_plan_write · uc_do_ask_user · uc_do_compact_context · uc_do_gen_once |
三、它能"写"什么（写类能力）
| 写什么 | 代表工具 |
|---|---|
| 建/改节点、连线 | uc_do_create_node · uc_do_create_media_node · uc_do_write_node_params · uc_do_write_node_prompt · uc_do_connect_nodes |
| 跑 / 取消任务 | uc_do_run_node · uc_do_cancel_job |
| 画布级改动 | uc_do_new_canvas · uc_do_clear_canvas · uc_do_change_canvas_name · uc_do_write_canvas_globals |
| 一次性生成 / 存文本 | uc_do_gen_once（须你确认）· uc_do_save_text |
| 蓝图 / 海报 / 时间线 | uc_do_save_blueprint · uc_do_save_poster · uc_do_save_timeline |
| 技能（可增删改查） | uc_do_kb_skill_add / edit / del（⚠ 只在全能力模式出现） |
⚠ 知识条目它不能直接写：写侧只提工单（知识条目由人写）⇒ 它只能"申请入库"，不能自己定稿 ✓
四、权限与门（为什么它不会乱动你的画布）
| 门 | 拦什么 |
|---|---|
| ① 规则门禁 | 任何画布写操作前，必须先读过该画布的规则（不知规则 ⇒ 不放行） |
| ② 授权门禁 | 它自建的沙箱画布 ⇒ 免授权 ✓；会话助手 + 当前画布 ⇒ 放行 ✓；其余你的画布 ⇒ 需你开启「AI 编辑授权」 ✓ |
| 硬门：人机协同节点 | 海报设计 / 视频剪辑这类"要人在界面里动手"的节点 ⇒ ⛔ 不许在沙箱画布建/改/跑（直接报错 ✓） |
| 生成确认 | 生成类动作必须经你确认 ✓ |
| 助手身份不可伪造 | 它有"助手监督"身份，但它只由应用在会话循环里开/关，⛔ 不是模型能自称的、也不落盘 ✓ |
⇒ 一句话：它能在你眼皮底下干活，但绕过不了"你的授权"和"必须有人在场的节点" ✓
五、两种能力模式（只读 / 全能力）
| 模式 | 给它的工具 | 什么时候用 |
|---|---|---|
| 只读模式 | 只放"读 / 查 / 预检"那批 ⇒ 它只能核实事实、给步骤与建议，⛔ 不能代你执行写操作 | 只想"问问、看看"，不让它动画布 ✓ |
| 全能力模式（缺省） | 全部已注册工具 ⇒ 建节点、跑任务、写技能都能干 ✓ | 让它真的动手 ✓ |
⚠ 说明：只读模式也放行"技能查询"（要知道"这类活怎么干"，恰恰得先看操作规程 ✓）；增删改技能只在全能力模式 ✓
六、它怎么"知道现场"（上下文从哪来）
| 来源 | 内容 |
|---|---|
| 自动注入（每轮都有） | 【当前画布上下文】（画布 / 节点 / 导演台进度 / 任务队列）+【完整模板清单】+【工具权限】+【应用知识】+【技能目录】✓ |
| 按需查询（它自己调工具） | 具体节点、任务、产物、素材等细节 ⇒ 需要时它去查 ✓ |
⇒ 所以：它默认已经知道你在干嘛（不用你复述）✓；但你若换了画布/项目，记得让它重新看一眼或开新会话 ✓
⚠ 一个已知边界：它没有"读项目文件"的工具 ⇒ 项目文件缺了什么，它只能告诉你"缺多少 + 真实路径"（读文件另走别的入口 ✓）
七、多步执行：计划卡 与 工具循环
- 计划清单：它可以先写一份任务清单（会话里显示成"计划卡"，含进行中/已完成/失败）⇒ 用它盯进度 ✓
- 工具循环：一轮问答里它会连续调用若干工具（次数有上限），轨迹可展开看 ⇒ 失败项会标出来 ✓
- 需要你时它会提问（
uc_do_ask_user）⇒ 你回答后它继续，不猜 ✓
⇒ 想让外部客户端也能这么干 ⇒ 见《MCP 指南》卷的「标准作业流程（SOP）」✓
来源：E:/workbuddyProj/unlimitCanvas/ai_manual/ai_helper/01-全能调用应用能力.md