JackalClient

Appearance

Agent ​

AI代理 分类：Web 描述：使用人工智能代理和受控工具完成任务。

需求 ​

  • 安全级别：高风险模块
  • 权限需求：根据工具操作可能需要管理员权限
  • 驱动依赖：否
  • 联网需求：是
  • 开发状态：稳定/常规
  • 版本属性：普通可用

介绍 ​

Agent（AI代理）通过任务预设中允许的工具完成用户任务。 工具调用会在执行层校验任务范围和工具准备项，并按 effect、风险等级和 capability 统一授权。只读工具无需确认；命令、文件写入、交互进程、Jackal 指令、进程、窗口、音频输出及键盘操作等有副作用的工具会在执行前审批。 审批会展示规范化参数、目标资源和风险等级，文件写入还会显示内容差异。授权可仅生效一次，也可在本次任务内允许同一 capability；高风险操作不会因确认超时而自动放行。 任务运行过程由独立运行上下文管理，可区分暂停、等待模型、等待审批、执行工具、完成、失败和取消；暂停、恢复、取消和用户追加要求通过运行事件队列传递并与任务输入同步合并。 任务达到最长运行时间、用户停止或审批取消后，会在模型和工具调用边界检查取消状态，并在结束时清理 Agent 创建的交互式进程。 适合联网信息获取、账号联动、系统操作和在线交互场景。 初次使用可优先调整：Current Instruction、Pause Task Hotkey、Correct JSON Format。 使用前请确认网络可用及相关 API/平台账号配置完整。

配置项 ​

  • Current Instruction（当前指令） 类型：枚举；默认："Run" 说明：这是选项型配置。默认值 Run 一般更稳妥；建议按使用场景逐个试用，而不是一次性切换多项。 可选：Run（未收录）；Pause（未收录）；Stop（停止）
  • Pause Task Hotkey（暂停任务快捷键） 类型：按键/复合；默认：{ { "Keybind", {VK_LCONTROL, VK_LMENU, VK_NUMPAD0 } }} 说明：用于设置快捷键触发。建议避免与系统或常用软件冲突，优先使用组合键提高可控性。
  • Correct JSON Format（纠正JSON格式） 类型：布尔；默认：true 说明：这是开关型配置。默认值 true 代表作者推荐的初始行为；若要改动，建议一次只改一个开关便于观察影响。
  • Max Allowed Asks（最大允许对话次数） 类型：数值；默认：100 说明：这是数值型配置。默认值 100 通常在稳定性与效果之间做了平衡，建议小步调整并观察实际变化。
  • Max Task Duration (s)（任务最长运行时间（秒）） 类型：数值；默认：1800 说明：限制单次 Agent 任务的总运行时间。达到时限后任务会请求取消并进入终止流程，避免同步模型或工具调用无限占用任务生命周期。
  • Max Allowed File Operations（最大允许文件操作次数） 类型：数值；默认：100 说明：用于指定文件/目录路径。建议使用稳定的绝对路径并确认权限可访问，避免因路径变化导致功能失效。
  • Max Allowed Commands（最大允许执行的命令次数） 类型：数值；默认：50 说明：这是数值型配置。默认值 50 通常在稳定性与效果之间做了平衡，建议小步调整并观察实际变化。
  • Max Allowed Repeated Commands（最大允许执行的重复命令次数） 类型：数值；默认：3 说明：这是数值型配置。默认值 3 通常在稳定性与效果之间做了平衡，建议小步调整并观察实际变化。
  • Command Confirmation（命令确认） 类型：枚举；默认："MessageBox" 说明：控制文件写入以外有副作用工具的统一审批方式。AI 不再负责审查自身操作风险。 可选：Always Allow（始终允许）；MessageBox（消息框）；Console（控制台）
  • File Confirmation（文件确认） 类型：枚举；默认："MessageBox" 说明：控制文件写入审批方式；审批内容包含路径、文件大小和内容差异预览。 可选：Always Allow（始终允许）；MessageBox（消息框）；Console（控制台）
  • Approval Grant Scope（审批授权范围） 类型：枚举；默认："Once" 说明：选择消息框批准仅作用于当前工具调用，或在本次 Agent 任务中允许同一 capability。新任务开始时会清空授权。 可选：Once（仅一次）；Capability For Run（本次任务同类能力）
  • MessageBox Confirm Timeout Enabled（启用消息框超时自动操作） 类型：布尔；默认：true 说明：用于控制检测/刷新/动画节奏。默认值 true 以稳定为主；调小会更灵敏但可能增加资源占用，调大则更省资源但响应更慢。
  • MessageBox Confirm Timeout (ms)（消息框超时时间（毫秒）） 类型：数值；默认：60000L 说明：用于控制检测/刷新/动画节奏。默认值 60000L 以稳定为主；调小会更灵敏但可能增加资源占用，调大则更省资源但响应更慢。
  • MessageBox Confirm Timeout Operation（消息框确认超时操作） 类型：枚举；默认："Cancel" 说明：用于控制检测/刷新/动画节奏。默认值 Cancel 以稳定为主；调小会更灵敏但可能增加资源占用，调大则更省资源但响应更慢。 可选：Accept（接受）；Decline（拒绝）；Cancel（取消）
  • Output Real Ask（输出真实问题） 类型：布尔；默认：true 说明：这是开关型配置。默认值 true 代表作者推荐的初始行为；若要改动，建议一次只改一个开关便于观察影响。
  • Allow Tool Preparation Missing（允许工具缺少准备） 类型：布尔；默认：false 说明：控制非 general 任务是否允许在部分工具缺少准备项时启动。无论该项如何设置，缺少准备项的具体工具都不会执行；general 任务会隐藏不可用工具并继续运行。

历史更新 ​

  • v1.1.5：补充 Agent 运行上下文和明确状态记录，暂停与用户追加要求的处理更稳定。
  • v1.1.5：引入统一工具策略与审批，按 effect、风险和 capability 区分工具，支持文件差异预览和本次任务同类能力授权。
  • v1.1.5：加强任务工具范围和准备项校验，统一高风险工具确认，并修复文件拒绝、工具参数、次数限制和任务状态问题。

备注 ​

该模块可能受系统版本、权限级别、目标进程状态或安全软件策略影响；若功能未生效，优先检查管理员权限、驱动依赖、联网状态与系统兼容性。

相关命令 ​

无

相关模块 ​

相关资料 ​

无