Agent Actions

    右侧 开发助手 AI 通过注册的 Action 操控应用。以下为完整能力清单（Protocol v1.0.0）。

    运行时以 getRegisteredActions() / listProtocolActions() 为准；调试时可调用 exportActionsMarkdown() 导出最新表格。

    实现入口：

    模块路径
    Bridge / 注册py_tauri_works/src/composables/useAgentBridge.ts
    协议契约py_tauri_works/src/services/agent/protocol/agentProtocol.ts
    编排入口py_tauri_works/src/services/agent/agentOrchestrator.ts
    Loop 引擎py_tauri_works/src/services/agent/agentLoop.ts
    模块 Actionspy_tauri_works/src/services/agent/*Actions.ts

    结果字段见 Agent Protocol：success / message / data / content[] / errorCode / progress。

    导航

    Action权限说明
    navigate.toread跳转到 /task、/workflow、/set 等页面

    任务

    Action权限说明
    task.createwrite创建任务
    task.generateScriptwrite生成任务脚本
    task.listread列出任务
    task.readScriptread读取脚本
    task.updateScriptwrite更新脚本
    task.updatewrite更新任务
    task.deletedestructive删除任务
    task.enable / task.disablewrite启用 / 禁用
    task.runwrite执行任务
    task.createWorkflowwrite从任务创建工作流

    工作流

    Action权限说明
    workflow.listread列出工作流
    workflow.createwrite创建工作流
    workflow.createFromPromptwrite按描述创建
    workflow.publishwrite发布
    workflow.runwrite运行
    workflow.openread打开编辑器
    workflow.addNode / updateNode / deleteNodewrite节点操作

    技能 / SOP / 即刻开始

    Action权限说明
    skill.list / enable / disable / install / execute各异技能管理与执行
    sop.list / get / previewPromptreadSOP 只读
    immediate.list / get / create / update / delete / navigate各异灵感 / 即刻开始

    设置 / 统计 / 插件（DSH）

    Action权限说明
    settings.getModels / update / navigate各异模型与设置
    stats.getSummary / refresh / setRange / clear各异统计
    dsh.listread列出已安装 DSH 工具插件及状态
    dsh.inspectread重新检测某插件是否为可复用工具类
    dsh.enable / dsh.disablewrite启用（注册 tools）/ 停用
    dsh.addLocalwrite添加本地插件路径
    dsh.deletedestructive删除插件记录
    dsh.hostStatusread检查 Cordis Host 是否就绪

    实验：插件管理 / 市场尚无稳定官方源。用户文档见 插件管理（实验）。启用成功后，插件自身暴露的 tools 会动态进入 Agent 可调用集合（名称以插件为准）。

    旧称 tools.list / tools.run 已由 DSH 插件体系与动态 tools 替代，请以运行时注册表为准。

    集成 / MCP

    Action权限说明
    integration.list / add / open / launch / stop / delete各异集成 CRUD 与进程
    integration.mcp.connectwriteMCP 连接并注册动态工具
    integration.mcp.disconnectwrite断开
    integration.mcp.listToolsread列出工具
    integration.mcp.listResourcesread列出 MCP Resources
    integration.mcp.readResourceread读取 Resource（需 uri）
    integration.getOutput / sendInput / getWindowInfo各异纯 CLI 终端
    integration.{id}.{tool}动态已连接 MCP 工具

    详见 MCP 集成规范。

    文件 / Shell

    Action权限说明
    fs.read / write / edit / apply_patch各异读写与补丁（可 Diff 预览）
    fs.list / glob / grep / statread目录与检索
    fs.deletedestructive删除
    shell.execwrite执行终端命令

    浏览器

    Action权限说明
    browser.setupwrite启动本机 Chrome/Edge；默认复用日常用户目录保留登录态；useSystemProfile=false 才用隔离目录
    browser.status / tabsread状态与标签
    browser.navigatewrite打开 / 跳转 URL（可复用 targetId）
    browser.extract_text / eval / click / type / wait各异页面交互
    browser.screenshotread截图（返回 content 含 image）
    browser.list_linksread列出匹配链接（不打开详情；可 preset=zhihu_collection）
    browser.collect_pageswrite通用列表采集：默认 maxNew=1（一篇一总结）；知乎 URL 可自动加 preset
    browser.append_summarieswrite通用将摘要追加写入 md/jsonl 并标记已处理
    browser.stopdestructive关闭自动化浏览器
    browser.scrape_zhihu_collectionwrite知乎快捷：等同 collect_pages + preset=zhihu_collection
    browser.save_zhihu_summarieswrite保存知乎摘要并标记已处理（兼容路径；新流程优先 append_summaries）

    说明：遇登录墙时 Action 可返回 needUser，UI 展示可点选按钮；对话中点 停止 会取消进行中的浏览器工作。

    联网

    Action权限说明
    web.searchread搜索（默认 Bing）
    web.fetchread抓取网页

    媒体

    Action权限说明
    media.generateImagewrite生图并落盘（content 含 image）
    media.generateVideowrite生视频并落盘（content 含 video）

    向量记忆

    Action权限说明
    memory.searchread检索本地向量记忆
    memory.indexwrite写入记忆
    memory.statusread组件就绪与条目数
    memory.cleardestructive清空（需 confirm=true）

    Agent Loop

    默认开启：观察 → 调用工具 → 再观察。关闭 Loop 时回退 legacy planner（兼容路径，已标记弃用倾向）。

    • 预算自动追加：步数/轮次将尽且任务仍在推进时，可自动扩预算（有次数与上限）；用尽后暂停，用户可继续。
    • 停止：cancelActiveRun 会同时取消浏览器后台采集。

    配置入口：设置 → 系统设置（权限、Hooks、搜索提供商、Diff 预览、记忆开关等）。

    设计说明见应用仓库 _docs/ 与 AGENTS.md。