本地运行 Holon

当你想检查 Holon，又不假定每个接口都已稳定时，用这套流程。

1. 构建与测试

cargo build
cargo test

针对具体工作时，优先跑最相关的 Rust 测试目标，提交改动前再跑更广的检查。

2. 检查命令面

cargo run -- --help

运行时仍在演进。以编译出的帮助输出为准，它定义了你这份 checkout 的确切本地 CLI 行为。

3. 让生命周期概念保持可见

测试行为时，记录你正在验证哪个运行时概念：

• 工作项的创建或更新
• 任务生命周期与输出获取
• 排队和唤醒/休眠行为
• 外部触发器的接入
• 面向用户的投递与内部轨迹输出的区别

这样实验才会贴合 Holon 的产品意图，而不是退化成模型提示词试验。

4. 通过仓库检查验证

默认的 Rust 检查是：

cargo fmt --all -- --check
RUSTFLAGS="-D warnings" cargo check --all-targets
cargo test

迭代时可以用更窄的检查，但最终验证不要用一次性脚本替代真实的项目检查。

Web GUI 开发

正式发布版本内置了 Web GUI；本地开发服务器用于修改其前端源码。要求 Node.js 24.x，且不低于 24.22.1。在仓库根目录执行以下命令，在启动 GUI 之前先安装并构建共享的 conversation SDK：

npm ci --prefix packages/conversation-sdk
npm --prefix packages/conversation-sdk run build
cd web-gui/app
npm ci
npm run dev

开发服务器支持热重载。其 /api 代理默认指向 http://127.0.0.1:7878；当测试守护进程运行在不同地址时，可设置 HOLON_API_PROXY_TARGET 环境变量。请使用专用的开发守护进程，避免使用包含生产凭据或真实数据的环境。

通过 Web GUI 指南中的流程对照正在运行的守护进程验证前端改动。切勿将本地 Mock 夹具输出当作真实网络请求成功的依据。