WinCode
Chat

权限请求与工具调用

权限确认面板、问答交互、工具调用展示

权限请求与工具调用

AI 引擎在执行文件操作、终端命令、网络请求等行为时,会发送权限请求。WinCode 将这些请求转化为可视化的确认面板和工具调用展示,让用户清楚了解 AI 正在做什么。

权限确认面板

权限确认面板

触发机制

当收到权限请求时,系统会将请求加入待处理队列。界面检测到有待处理请求时,显示权限确认面板。

权限类型

权限确认面板支持以下 7 种展示类型:

类型图标展示内容
bash终端图标命令内容 + 工作目录
edit文件编辑图标文件路径 + 旧内容(红色)+ 新内容(绿色)
write新建文件图标文件路径 + 文件内容预览
read文件图标文件路径
search搜索图标搜索模式 + 文件路径
fetch网络图标URL + 描述
other工具图标JSON 原文

操作按钮

每个权限请求附带多个操作选项:

  • 允许 -- 蓝色强调按钮,允许本次操作
  • 始终允许 -- 带盾牌图标的次要按钮,同时将工具名加入权限规则白名单
  • 拒绝 -- 红色系按钮,拒绝操作

点击「始终允许」时,系统会将该工具加入白名单,后续同类操作不再弹窗确认。

队列机制

多个权限请求会排队等待处理。面板底部显示「还有 N 个待处理请求」。当前请求处理完毕后,下一个请求自动显示。

面板容器

权限面板从底部滑入,位于输入框上方,不遮挡消息列表。

问答交互

触发机制

当 AI 回复中包含问题时,系统自动解析问题内容并显示问答交互面板。

界面结构

问答面板同样从底部滑入,包含:

  1. 问题文本 -- 显示 AI 提出的问题
  2. 选项列表 -- 如果问题附带选项,以可点击的按钮列表呈现,选中态有强调色边框
  3. 补充输入 -- 底部输入框可输入补充说明,按 Enter 发送
  4. 发送按钮 -- 选中选项或输入补充后激活

回答会以组合形式发送:选项标签 + 补充说明。发送后继续流式对话。

工具调用展示

折叠分组

工具调用将多个调用折叠为一行摘要:

▶ 🔧 3 个工具调用

点击展开后显示每个工具调用的详情。

工具调用详情

每个工具调用卡片包含:

  1. 标题栏 -- 工具图标 + 显示名称 + 状态徽章
  2. 输入区域 -- 根据工具类型智能展示:
    • Bash -- 描述 + 命令(等宽字体,暗色终端背景)
    • Edit -- 文件路径 + 旧内容 + 新内容
    • Read -- 文件路径 + offset/limit 参数
    • Write -- 文件路径 + 内容预览
    • Glob/Grep -- 搜索模式 + 路径
    • WebFetch -- URL + prompt
    • WebSearch -- 搜索查询
  3. 输出区域 -- 根据工具类型格式化:
    • Bash -- 暗色终端背景 + 颜色解析
    • Read -- 带行号的文件内容显示
    • Glob/Grep -- 文件列表
    • 其他 -- 纯文本预览

状态徽章

状态文字颜色
pending等待中灰色
running运行中强调色
completed完成绿色
error错误红色

图标映射

工具名称到图标的映射:

工具名图标
bash终端图标
edit文件编辑图标
write新建文件图标
read文件图标
glob / grep搜索图标
web_fetch / websearch网络图标
其他工具图标

相关文档

On this page