Agent Workflow Canvas (多 Agent 工作流画布 · 官方标准 App 版)

极客专享：为 HanaAgent 打造的标准应用（manifestVersion: 2），提供确定性的复杂任务执行前评估、DAG 拓扑看板与用户审核发令门禁。

---

🌟 核心功能与亮点

1. 执行前评估与防偷跑门禁：
   • 面对多步骤工程、跨模块改动、架构重构或需要委派子代理的复杂任务，模型严禁擅自提前修改业务代码；
   • 必须先完成执行前评估，拆解出正交独立的工作包，并在会话中展示 DAG 流程图卡片供用户审核。
2. 节点直接换人与动态指派：
   • 每个任务节点内嵌精致的下拉选择框，支持从全景专员名录中调换执行人；
   • 底部提供「➕ 输入自定义助手 ID」入口，采用纯 DOM 水墨模态弹窗，输入后按回车即自动追加至全局，100% 免疫系统沙箱对 prompt 的拦截。
3. 四重全景触控与滑动导航：
   • 左右悬浮翻页控制按钮（‹ / ›）；
   • 鼠标空白处抓手按住直接平移（Drag-to-Scroll）；
   • 普通鼠标滚轮横向直连映射；
   • 显式宣纸底色细滑块滚动条，告别截断遮挡。
4. 法定开工发令门禁与正式跨会话投递：
   • 用户确认人员排布后，点击卡片右下角的「确认方案 · 启动全链路调度」按钮；
   • 前端通过 App 独立后端端点 POST /workflow/:id/execute 提交发令；
   • 后端使用正式会话接口 ctx.bus.request("session:send", payload) 向主会话显式指定 scope: "all" 进行跨归属投递；
   • 应用清单（manifest.json）规范声明 app/session.start-turn 与 app/sessions.manage 双重权限；
   • 严格区分失败语义：宿主权限拒绝（HTTP 403）安全回滚为 idle 状态并明确提示，允许用户授权后重试；未知网络超时（HTTP 504）则保守锁定为 delivery_unknown，坚决防重复发令。

---

📦 包含的标准工程结构

agent-workflow-canvas/
├── manifest.json       # 符合 manifestVersion: 2 的官方应用清单
├── package.json        # v2.3.0 规范依赖与单测配置
├── index.js            # App 标准主入口 (导出 apply，挂载 tools 与 http 路由)
├── assets/
│   └── icon.svg        # 应用矢量图标
├── ui/
│   └── face.svg        # 卡片矢量封面 (满足平台 face 严格校验)
├── http/
│   └── workflow.js     # Webview 路由与审核发令执行端点
├── lib/
│   ├── agents.js       # 通用专员名录与本地 Agents 自动探测引擎
│   ├── dag.js          # DAG 拓扑分层、环路检测与写冲突串行化消解
│   ├── security.js     # 安全正则、防路径穿越与 XSS 实体转义
│   └── theme.js        # 宣纸水墨风渲染器、四重滑动导航与纯 DOM 模态弹窗
├── tools/
│   └── render_workflow.js  # 暴露给模型的 render_workflow 专用调度工具
└── test/               # 完整单元测试套件 (100% PASS)

---

🚀 极速安装指南

第一步：解压放入应用目录

将本应用文件夹解压后完整放置到你的 Hana 数据目录下的 apps/ 文件夹中：

~/.hanako/apps/agent-workflow-canvas/

（例如 Windows 路径为 C:\Users\<你的用户名>\.hanako\apps\agent-workflow-canvas）

第二步：在应用市场中启用

1. 打开 Hana 桌面客户端，进入「扩展 / 应用市场」；
2. 刷新后在已安装或本地应用列表中即可看到 「Agent 工作流画布」；
3. 点击启用即可。应用会自动挂载 Webview 路由并向你的所有 AI 模型暴露 render_workflow 工具。

第三步：在助手全局规则中挂载契约（推荐）

在助手的系统提示词（System Prompt 或 AGENTS.md）中添加以下指令，让助手在规划复杂任务时无条件遵守发令门禁：

# 复杂任务执行前评估与审核发令契约
遇到多步骤工程、跨模块改动、架构封装或涉及子代理协作的复杂任务：
1. 施工前严禁偷跑业务代码，必须先完成执行前评估，说明边界、分工与验收；
2. 调用 render_workflow 工具挂出支持节点换人的纯图形 DAG 流程图供用户审核；
3. 默认唯一开工信号是用户亲自点击卡片上的「🚀 立即执行」按钮，收到发令回执前主控和子代理均不得开工派发。

---

🧪 验证与自测

进入本目录执行：

node --test test/*.test.js

全量 36 项自动化测试（涵盖拓扑分层、环路检测、并发写冲突拦截、"." 根路径防御、跨会话 scope 契约、宿主权限拒绝 403 明确报错与 idle 安全回滚、accepted: true 成功受理、传输安全锁定、SSR 页面重载锁定与参数校验等）100% 绿灯全绿通过。