1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
在仓库根目录运行:
```sh
cargo fmt --check
cargo test --locked
cargo build --release --locked
cargo package --locked --target-dir target/package-verify
```
打包校验使用单独的 target 目录。在默认目录中,它与 dev 构建共用 fingerprint,之后的 `cargo build` 只检查解包出的副本,修改源码也不会重新编译。
普通测试使用本地临时数据,不调用模型。当前测试覆盖消息解析、消费确认、任务状态、结果游标、配置、`top` 画面和平台辅助函数。CI 在 Windows、Linux 和 macOS 上运行上述检查,并按 `Cargo.toml` 的 `rust-version` 检查最低 Rust 版本。
修改 `top` 后,在真实终端中运行 `python scripts/top_demo.py` 查看画面。脚本在临时数据目录写入各种状态的任务,在当前终端运行 `target/debug` 下的 `top`,并像 daemon 一样持续写入,不启动 daemon,也不调用 agent。`top` 退出后删除数据,`--keep` 保留,`--all` 和 `--` 之后的参数传给 `top`,例如 `-- trun` 只看一个任务。
从源码安装使用 `cargo install --path . --locked`。
各文档按用途维护,同一事实只在一处陈述,其他位置链接过去:
- -------
增删命令或选项前,参考数据目录中 `daemon/requests.jsonl` 记录的实际用法,字段见[存储](design.md#存储)。
文档只写事实、适用条件和依据。验证范围用平台、版本或提交号标识;省去日历日期、执行经过和中间判断。调研底稿保留来源链接。
代码注释用英文,解释代码本身看不出的原因。优先修复可确认的缺陷。提交使用 Conventional Commits,探针改动使用 `test(spikes)`。