@fieldwangai/agentflow 0.1.41 → 0.1.43

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (12) hide show
  1. package/bin/lib/ui-server.mjs +288 -11
  2. package/builtin/web-ui/dist/assets/index-BCquw8dA.js +218 -0
  3. package/builtin/web-ui/dist/assets/index-CXO3VpkR.css +1 -0
  4. package/builtin/web-ui/dist/index.html +2 -2
  5. package/package.json +1 -1
  6. package/skills/agentflow-workspace-chart/SKILL.md +102 -0
  7. package/skills/agentflow-workspace-graph/SKILL.md +4 -0
  8. package/skills/agentflow-workspace-html/SKILL.md +65 -0
  9. package/skills/agentflow-workspace-image/SKILL.md +52 -0
  10. package/skills/agentflow-workspace-table/SKILL.md +65 -0
  11. package/builtin/web-ui/dist/assets/index-DyBxNnlo.css +0 -1
  12. package/builtin/web-ui/dist/assets/index-TXmzGUhf.js +0 -218
package/builtin/web-ui/dist/index.html CHANGED
@@ -15,8 +15,8 @@
15
15
  href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@24,400,0,0"
16
16
  rel="stylesheet"
17
17
  />
18
- <script type="module" crossorigin src="/assets/index-TXmzGUhf.js"></script>
19
- <link rel="stylesheet" crossorigin href="/assets/index-DyBxNnlo.css">
18
+ <script type="module" crossorigin src="/assets/index-BCquw8dA.js"></script>
19
+ <link rel="stylesheet" crossorigin href="/assets/index-CXO3VpkR.css">
20
20
  </head>
21
21
  <body>
22
22
  <div id="root"></div>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fieldwangai/agentflow",
3
- "version": "0.1.41",
3
+ "version": "0.1.43",
4
4
  "description": "Orchestration system for long-running complex agent tasks using Cursor, OpenCode, or Claude Code as execution backends",
5
5
  "type": "module",
6
6
  "main": "bin/agentflow.mjs",
package/skills/agentflow-workspace-chart/SKILL.md ADDED
@@ -0,0 +1,102 @@
1
+ ---
2
+ name: agentflow-workspace-chart
3
+ description: >-
4
+ AgentFlow Workspace 图表展示技能。用于给 display_chart 节点或连接到 chart
5
+ 展示节点的输出引脚生成 ChartSpec JSON；约束模型只输出安全、可解析的 ECharts
6
+ JSON 对象，不混入 Markdown、HTML 或过程说明。
7
+ ---
8
+
9
+ # AgentFlow Workspace Chart
10
+
11
+ 在 Workspace 中需要把数据展示为图表时使用本技能。优先使用 `display_chart`，不要用 HTML 自己加载图表库，除非用户明确要求完整自定义页面。
12
+
13
+ ## ChartSpec 格式
14
+
15
+ 图表节点只接受一个 JSON 对象：
16
+
17
+ ```json
18
+ {
19
+ "type": "chart",
20
+ "version": "1.0",
21
+ "renderer": "echarts",
22
+ "title": "最近 3 天崩溃率",
23
+ "option": {
24
+ "tooltip": { "trigger": "axis" },
25
+ "legend": {},
26
+ "xAxis": { "type": "category", "data": ["2026-06-28", "2026-06-29", "2026-06-30"] },
27
+ "yAxis": { "type": "value", "name": "崩溃率(%)" },
28
+ "series": [
29
+ { "name": "崩溃率", "type": "line", "smooth": true, "data": [0.527, 0.529, 0.433] }
30
+ ]
31
+ },
32
+ "fallback": {
33
+ "type": "table",
34
+ "columns": ["日期", "崩溃率"],
35
+ "rows": [["2026-06-28", "0.527%"], ["2026-06-29", "0.529%"], ["2026-06-30", "0.433%"]]
36
+ }
37
+ }
38
+ ```
39
+
40
+ 必填字段：
41
+
42
+ - `type`: 必须是 `"chart"`。
43
+ - `version`: 必须是 `"1.0"`。
44
+ - `renderer`: 必须是 `"echarts"`。
45
+ - `option`: ECharts option JSON 对象。
46
+ - `option.series`: 一个 series 对象或 series 数组。
47
+
48
+ 允许的 `series.type`：
49
+
50
+ `line`, `bar`, `pie`, `scatter`, `radar`, `heatmap`, `tree`, `treemap`, `sunburst`, `sankey`, `graph`, `gauge`, `funnel`。
51
+
52
+ ## 输出到具名引脚
53
+
54
+ 如果上游 agent 节点的某个输出引脚连接到了图表节点，比如用户要求“图表展示写入 `${graph}`”，最终回复必须是 Workspace 输出协议：
55
+
56
+ ```json
57
+ {
58
+ "result": "给 Markdown/默认展示节点看的说明正文",
59
+ "outParams": {
60
+ "graph": {
61
+ "type": "chart",
62
+ "version": "1.0",
63
+ "renderer": "echarts",
64
+ "option": {
65
+ "xAxis": { "type": "category", "data": [] },
66
+ "yAxis": { "type": "value" },
67
+ "series": [{ "type": "line", "data": [] }]
68
+ }
69
+ }
70
+ }
71
+ }
72
+ ```
73
+
74
+ 不要把 ChartSpec 写进 `result`，除非图表节点连接的是 `result` 输出口。
75
+
76
+ ## 安全规则
77
+
78
+ - 只输出 JSON 对象，不要包 Markdown 代码围栏。
79
+ - 不要输出 HTML、`script`、`iframe`、事件处理器或 JS 函数。
80
+ - 不要使用 ECharts 回调函数，例如 `formatter: function () {}`；只能用字符串模板或普通 JSON 值。
81
+ - 不要引用外部脚本或网络资源。
82
+ - 数据量大时先聚合或采样。
83
+ - 小结果建议同时提供 `fallback` 表格，便于失败时排查。
84
+
85
+ ## 图表选择
86
+
87
+ - 时间序列、趋势：`line`。
88
+ - 分类对比：`bar`。
89
+ - 占比：少量分类用 `pie`，分类多时用 `bar`。
90
+ - 相关性或分布：`scatter`。
91
+ - 矩阵：`heatmap`。
92
+ - 层级：`tree`、`treemap`、`sunburst`。
93
+ - 流向：`sankey`。
94
+ - 网络关系：`graph`。
95
+ - KPI 目标：`gauge`。
96
+ - 转化漏斗：`funnel`。
97
+
98
+ ## 视觉建议
99
+
100
+ - 默认不要设置深色文字、复杂背景或自定义主题色；Workspace 会应用暗色画布默认样式。
101
+ - 有坐标轴时建议 `grid.containLabel: true`。
102
+ - `title` 保持短，详细说明放在 Markdown 结果里。
package/skills/agentflow-workspace-graph/SKILL.md CHANGED
@@ -47,6 +47,10 @@ description: >-
47
47
  - 用 `display_markdown` 展示 Markdown 正文、分析报告、会议纪要、代码结构说明。
48
48
  - 用 `display_mermaid` 展示 Mermaid 图源码。
49
49
  - 用 `display_ascii` 展示 ASCII 图。
50
+ - 用 `display_html` 展示可交互 HTML 原型或富 UI 片段。
51
+ - 用 `display_image` 展示图片 URL、data URL 或图片路径。
52
+ - 用 `display_chart` 展示 ChartSpec JSON 图表。
53
+ - 用 `display_table` 展示结构化表格数据。
50
54
  - 用普通 pipeline 节点作为上下文节点时，保持 `instances` 结构与 flow.yaml instance 一致，但它只属于 workspace graph。
51
55
  - 每个新增 instance 必须有 `ui.nodePositions`。
52
56
  - 展示节点建议写 `ui.nodeSizes`，避免内容区域过小。
package/skills/agentflow-workspace-html/SKILL.md ADDED
@@ -0,0 +1,65 @@
1
+ ---
2
+ name: agentflow-workspace-html
3
+ description: >-
4
+ AgentFlow Workspace HTML 展示技能。用于给 display_html 节点或连接到 html
5
+ 展示节点的输出引脚生成可直接 iframe 渲染的 HTML；适合交互原型、移动端页面、
6
+ 小型可视化和富 UI 预览。
7
+ ---
8
+
9
+ # AgentFlow Workspace HTML
10
+
11
+ 在 Workspace 中需要展示可交互 UI、移动端原型、富文本布局或自包含页面时使用本技能。若只是图表，优先使用 `display_chart`；若只是表格，优先使用 `display_table`。
12
+
13
+ ## 内容格式
14
+
15
+ HTML 展示节点接收完整 HTML 文档或 HTML fragment：
16
+
17
+ ```html
18
+ <!doctype html>
19
+ <html lang="zh-CN">
20
+ <head>
21
+ <meta charset="utf-8" />
22
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
23
+ <style>
24
+ body { margin: 0; font-family: system-ui, sans-serif; }
25
+ </style>
26
+ </head>
27
+ <body>
28
+ <main>...</main>
29
+ <script>
30
+ // 可写少量自包含交互脚本
31
+ </script>
32
+ </body>
33
+ </html>
34
+ ```
35
+
36
+ 不要包 Markdown 代码围栏，不要在 HTML 外追加解释文字。
37
+
38
+ ## 输出到具名引脚
39
+
40
+ 如果上游 agent 节点的某个输出引脚连接到了 HTML 节点，比如用户要求“HTML 写入 `${html}`”，最终回复必须是 Workspace 输出协议：
41
+
42
+ ```json
43
+ {
44
+ "result": "给 Markdown/默认展示节点看的说明正文",
45
+ "outParams": {
46
+ "html": "<!doctype html><html><body>...</body></html>"
47
+ }
48
+ }
49
+ ```
50
+
51
+ 不要把 HTML 写进 `result`，除非 HTML 节点连接的是 `result` 输出口。
52
+
53
+ ## 安全与兼容
54
+
55
+ - HTML 在 sandbox iframe 中运行，允许脚本、表单和弹窗，但不要依赖父页面权限。
56
+ - 不要引用外部 JS/CSS 资源；优先写自包含 CSS/JS。
57
+ - 不要使用网络接口发送敏感数据。
58
+ - 移动端原型建议固定一个清晰的设计宽度，例如 `max-width: 430px`，并兼容容器缩放。
59
+ - 文本、按钮、列表和卡片必须避免溢出；不要用纯装饰性背景代替实际内容。
60
+
61
+ ## 节点写入
62
+
63
+ 新增或更新 `workspace.graph.json` 中的 `display_html` instance 时，`body`、`input.content.value`、`output.content.value` 使用同一份 HTML。
64
+
65
+ 建议默认尺寸：宽 430-760，高 640-860，按原型复杂度调整。
package/skills/agentflow-workspace-image/SKILL.md ADDED
@@ -0,0 +1,52 @@
1
+ ---
2
+ name: agentflow-workspace-image
3
+ description: >-
4
+ AgentFlow Workspace 图片展示技能。用于给 display_image 节点或连接到 image
5
+ 展示节点的输出引脚生成图片 URL、data URL 或 workspace 内图片路径；适合截图、
6
+ 视觉参考、生成图和设计资产预览。
7
+ ---
8
+
9
+ # AgentFlow Workspace Image
10
+
11
+ 在 Workspace 中需要展示一张图片、截图、设计参考图、生成图或文件产物时使用本技能。图片节点只接收可作为 `<img src>` 使用的字符串。
12
+
13
+ ## 内容格式
14
+
15
+ 支持：
16
+
17
+ - HTTP/HTTPS 图片 URL。
18
+ - `data:image/png;base64,...` 等 data URL。
19
+ - workspace 内可访问的相对图片路径或绝对路径。
20
+
21
+ 不支持：
22
+
23
+ - Markdown 图片语法，例如 `![alt](url)`。
24
+ - HTML `<img>` 标签。
25
+ - 多张图片列表；需要多图时创建多个 `display_image` 节点或用 HTML 展示。
26
+
27
+ ## 输出到具名引脚
28
+
29
+ 如果上游 agent 节点的某个输出引脚连接到了图片节点，比如用户要求“图片写入 `${image}`”，最终回复必须是 Workspace 输出协议：
30
+
31
+ ```json
32
+ {
33
+ "result": "给 Markdown/默认展示节点看的说明正文",
34
+ "outParams": {
35
+ "image": "outputs/example.png"
36
+ }
37
+ }
38
+ ```
39
+
40
+ 不要把图片地址写进 `result`，除非图片节点连接的是 `result` 输出口。
41
+
42
+ ## 生成与落盘
43
+
44
+ - 如果任务产出新图片，优先保存到 workspace 下稳定路径，例如 `outputs/image.png`。
45
+ - 确保路径对应的文件真实存在，且扩展名与内容类型匹配。
46
+ - 需要说明图片含义时，把说明写到 `result` 或 Markdown 节点，不要混进图片 src。
47
+
48
+ ## 节点写入
49
+
50
+ 新增或更新 `workspace.graph.json` 中的 `display_image` instance 时，`body`、`input.src.value`、`output.src.value` 使用同一份图片 src。
51
+
52
+ 建议默认尺寸：宽 520-760，高 420-680。
package/skills/agentflow-workspace-table/SKILL.md ADDED
@@ -0,0 +1,65 @@
1
+ ---
2
+ name: agentflow-workspace-table
3
+ description: >-
4
+ AgentFlow Workspace 表格展示技能。用于给 display_table 节点或连接到 table
5
+ 展示节点的输出引脚生成结构化表格数据；约束模型输出可解析、紧凑的 JSON 表格，
6
+ 不混入 Markdown 说明或 HTML。
7
+ ---
8
+
9
+ # AgentFlow Workspace Table
10
+
11
+ 在 Workspace 中需要展示查询结果、对比数据、字段列表、明细行时使用本技能。优先输出结构化 JSON，只有用户明确要求时才输出 Markdown 表格、CSV 或 TSV。
12
+
13
+ ## 推荐格式
14
+
15
+ 表格节点推荐接收：
16
+
17
+ ```json
18
+ {
19
+ "columns": ["日期", "崩溃设备数", "启动设备数", "崩溃率"],
20
+ "rows": [
21
+ ["2026-06-28", 35632, 6755735, "0.527%"],
22
+ ["2026-06-29", 35821, 6767040, "0.529%"],
23
+ ["2026-06-30", 25179, 5813363, "0.433%"]
24
+ ]
25
+ }
26
+ ```
27
+
28
+ 也可以使用对象数组：
29
+
30
+ ```json
31
+ [
32
+ { "日期": "2026-06-28", "崩溃率": "0.527%" },
33
+ { "日期": "2026-06-29", "崩溃率": "0.529%" }
34
+ ]
35
+ ```
36
+
37
+ ## 输出到具名引脚
38
+
39
+ 如果上游 agent 节点的某个输出引脚连接到了表格节点，比如用户要求“表格写入 `${table}`”，最终回复必须是 Workspace 输出协议：
40
+
41
+ ```json
42
+ {
43
+ "result": "给 Markdown/默认展示节点看的说明正文",
44
+ "outParams": {
45
+ "table": {
46
+ "columns": ["列名1", "列名2"],
47
+ "rows": [["值1", "值2"]]
48
+ }
49
+ }
50
+ }
51
+ ```
52
+
53
+ 不要把表格数据写进 `result`，除非表格节点连接的是 `result` 输出口。
54
+
55
+ ## 内容规则
56
+
57
+ - 表格数据只放结构化数据，不要混入解释段落。
58
+ - 列名要短、稳定，适合作为表头。
59
+ - 行数很多时默认输出聚合结果或前 50 行，并在 `result` 中说明截断策略。
60
+ - 数字保持数字类型；展示单位可以放列名中，例如 `崩溃率(%)`。
61
+ - 不要输出 HTML 表格。
62
+
63
+ ## Markdown / CSV 兼容
64
+
65
+ 表格节点也能解析 Markdown 表格、CSV、TSV，但优先级低于 JSON。只有用户明确要求“Markdown 表格”或上游系统只能生成文本时才使用这些格式。