agent-handoff 0.2.0 → 0.4.0
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.
- package/CHANGELOG.md +23 -1
- package/README.md +43 -1
- package/dist/index.js +743 -8
- package/dist/index.js.map +1 -1
- package/package.json +6 -3
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,28 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to this project will be documented in this file.
|
|
4
4
|
|
|
5
|
+
## [0.4.0] - 2026-03-02
|
|
6
|
+
|
|
7
|
+
### Added
|
|
8
|
+
- `agent-handoff export --format web`：导出静态 Web Timeline Viewer（离线打开）
|
|
9
|
+
- Timeline Viewer：内联 events 数据，无需网络/服务端
|
|
10
|
+
- Artifact Viewer：将 links 指向的产物导出为可点击的 HTML 页面（`timeline/artifacts/`）
|
|
11
|
+
- Timeline 过滤与搜索：按 stepId/type/workItemId 过滤，关键字匹配 summary/data，并同步 URL 参数
|
|
12
|
+
- events.jsonl 读取模块：支持非法行统计、排序与 limit 裁剪（为 Viewer 提供结构化数据）
|
|
13
|
+
|
|
14
|
+
## [0.3.0] - 2026-03-02
|
|
15
|
+
|
|
16
|
+
### Added
|
|
17
|
+
- TRAE 自动化能力（可选）：视觉识别、自动输入、任务等待（Nut.js 路线）
|
|
18
|
+
- 自动化操作日志：会话级 JSONL 落盘（`workspace/operations/`）
|
|
19
|
+
- 自动化诊断落盘：失败时输出 diagnostics JSON（`workspace/diagnostics/`）
|
|
20
|
+
- 自动化降级：失败时输出可继续手工执行的辅助模式提示，并可复制 prompt 到剪贴板
|
|
21
|
+
- `agent-handoff report` 命令：从 operations JSONL 生成 json/markdown/html 报告
|
|
22
|
+
- 新事件类型：`automation.session`（events.jsonl，支持 data 字段承载统计信息）
|
|
23
|
+
|
|
24
|
+
### Changed
|
|
25
|
+
- `TraeAdapter.execute()` 支持恢复重试与失败降级输出
|
|
26
|
+
|
|
5
27
|
## [0.2.0] - 2026-03-02
|
|
6
28
|
|
|
7
29
|
### Added
|
|
@@ -9,7 +31,7 @@ All notable changes to this project will be documented in this file.
|
|
|
9
31
|
- `agent-handoff advance` 命令 - 推进 workspace 状态
|
|
10
32
|
- `agent-handoff config` 命令 - 查看和管理配置
|
|
11
33
|
- `--copy` 选项 - 自动复制 prompt 到剪贴板（跨平台支持）
|
|
12
|
-
- `--
|
|
34
|
+
- `--no-event` 选项 - 跳过事件日志写入
|
|
13
35
|
- 产物校验模块 - 检查 output.md 必要区块
|
|
14
36
|
- 剪贴板模块 - 跨平台剪贴板操作
|
|
15
37
|
- 事件写入模块 - events.jsonl 追加式日志
|
package/README.md
CHANGED
|
@@ -65,11 +65,53 @@ agent-handoff status [workspace] [--json]
|
|
|
65
65
|
输出下一步执行指令和 prompt。
|
|
66
66
|
|
|
67
67
|
```bash
|
|
68
|
-
agent-handoff next [workspace]
|
|
68
|
+
agent-handoff next [workspace] [--copy] [--no-event]
|
|
69
69
|
```
|
|
70
70
|
|
|
71
71
|
参数：
|
|
72
72
|
- `[workspace]` - workspace 路径（默认当前目录）
|
|
73
|
+
- `--copy, -c` - 复制 prompt 到剪贴板
|
|
74
|
+
- `--no-event` - 不写入 events.jsonl
|
|
75
|
+
|
|
76
|
+
### validate
|
|
77
|
+
|
|
78
|
+
校验 workflow 与产物结构。
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
agent-handoff validate [workspace]
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### advance
|
|
85
|
+
|
|
86
|
+
手动推进 workflow 状态，并可写入事件。
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
agent-handoff advance [workspace]
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### config
|
|
93
|
+
|
|
94
|
+
查看或生成配置文件。
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
agent-handoff config [workspace]
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
### report
|
|
101
|
+
|
|
102
|
+
读取 workspace 下的自动化操作日志并生成报告（json/markdown/html）。
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
agent-handoff report [workspace] [--format markdown|json|html] [--session <id>] [--screenshots] [--output <path>]
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
### export
|
|
109
|
+
|
|
110
|
+
导出静态 Web Timeline Viewer（离线 HTML，可直接打开）。
|
|
111
|
+
|
|
112
|
+
```bash
|
|
113
|
+
agent-handoff export [workspace] --format web [--output <dir>] [--limit <n>]
|
|
114
|
+
```
|
|
73
115
|
|
|
74
116
|
## Workspace 结构
|
|
75
117
|
|