 jkooe
|
ad569d4e6d
|
ci: 控制台资源断言 2→3，并补 @nodeagent/agent 构建前置
控制台随包分发的资源由 2 份增至 3 份（sidecar.mjs / node / agent.mjs）：
- rust.yml 的资源项断言同步改为 3，且不再只数个数 ——
改为断言目标名确实包含 sidecar.mjs 与 agent.mjs、以及 node/node.exe 二者任一。
只数个数的话，「三份但错了一份」照样过。
顺序依赖（本地验证发现不了的一类）：
prepare:node 现在还要 esbuild 打包被控端，故 @nodeagent/agent 的 dist 成为新的
前置产物。本地验证时 dist 早就在，会把这层依赖完全掩盖 —— 故在 steps 里显式写全
构建步骤，并加注释说明为什么顺序不能调。
rust.yml 的 paths 触发器补 scripts/lib/bundle-agent.mjs 与 apps/agent/**：
改这两处同样会让控制台打包结果变化，不触发就等于零覆盖。
windows-e2e.yml 同步：Windows 分支现在也覆盖 agent.mjs 的准备与解析。
|
2026-10-11 11:42:14 +08:00 |
|
|
jkooe
|
8664ec2926
|
ci: 覆盖 Node 运行时准备与「产物自举」（Linux + Windows 双覆盖）
新增 runtime 准备脚本后，两件事此前零覆盖：脚本本身在 Windows 上的分支、
以及「打包产物能不能真跑」。补上：
- rust.yml：prepare:node 真跑（验证脚本可用 + 产物自检）→ 断言注入片段声明两份资源
→ `verify-bundle --runtime` 真 spawn 运行时跑 sidecar 走一次 JSON-RPC。
paths 触发加上 scripts/prepare-console.mjs。
注：Linux 上不走 strip 分支（macOS 专属），故「strip 必须 adhoc 重签」由 macOS 本机实测覆盖。
- windows-e2e.yml：新增一步跑 prepare:node + verify-bundle --runtime —— 该脚本在 Windows
上走的是「复制 node.exe、无 strip」的另一条分支，此前从未被真实 runner 验证过。
|
2026-10-11 08:55:38 +08:00 |
|
|
jkooe
|
9bba53d5c0
|
fix(ci): 修 Rust Shell 工作流 —— resources 只声明构建期必产出的文件
CI 失败根因（本地已复现确认）：`tauri-build`(build.rs) 会在**编译期校验**
`tauri.conf.json` 的 `bundle.resources` 声明文件是否存在。
我之前声明了两项：`sidecar.mjs`（CI 未生成）+ `resources/node`（Node 运行时未下载）
→ build.rs 直接失败（"failed to run custom build command"）。
修复：
- `tauri.conf.json` 的 resources **只留 sidecar.mjs**，并写明为何不能声明未就绪的文件
- `rust.yml` 在 clippy/test **之前**加「构建 sidecar」步骤（`pnpm --filter nodeagent-console sidecar:build`）
- console-plan.md：⑤ 不再把 node 记为已完成（未验证的不写成做完），
补「已知待办」（Node 运行时随包分发 + GUI 端到端人工验证）与「构建约束」说明
本地复现验证：删掉 `sidecar/dist/` → `cargo check` 复现同一错误；恢复 → 通过 ✓
|
2026-10-10 15:25:12 +08:00 |
|
|
jkooe
|
53bf5a0634
|
feat(console)!: Rust 壳改用 Node sidecar（选项 D 完成）—— 退役 crates/nodeagent-client
## 动机（消除「两套协议实现」）
原设计让 Rust 壳自己实现 client，与 TS 版（@nodeagent/client）并存 → 改一处漏一处时
构建过、单测过，只在真机暴露。现 Rust 壳只做**进程管理 + 消息转发**，协议实现只剩 TS 一份。
## ④ Rust 壳改造
- 新增 `src-tauri/src/sidecar.rs`（~290 行）：Sidecar 管理器 —— spawn node、
行分隔 JSON-RPC 的请求/响应匹配（oneshot + 超时兜底）、通知回调（state/log/agent_event）、
`resolve_node`/`resolve_sidecar` 路径解析（env → Tauri resource → 开发期系统 node）
- 重写 `lib.rs` 为薄转发层：`ensure_sidecar` 懒启动；**5 个 command 签名与 3 个 event 名
（na-state/na-log/na-event）一律不变 → 前端零改动**；`get_capabilities`/`get_state`
读本地缓存以**保持同步签名**；`RunEvent::Exit` 时优雅 shutdown（kill_on_drop 兜底不留孤儿）
- `Cargo.toml`：移除 nodeagent-client 依赖、加 tokio；**版本 0.1.0 → 2.0.0**
（原先与 tauri.conf.json 的 2.0.0 不一致，属版本号统一范围）
## ⑤ 打包配置
- `tauri.conf.json`：`bundle.resources` 声明 sidecar.mjs 与 node；
`beforeBuildCommand` 串上 `sidecar:build`（否则 resource 缺失）
## ⑥ 退役
- 删除整个 `crates/`（12 文件，含 nodeagent-client 与其 probe 示例）
- `rust.yml` 由「Rust client 单测」改为「**Rust 壳单测（真跑 sidecar）**」：
装 Tauri 系统依赖 + Node + pnpm，跑 clippy `-D warnings` 与 `cargo test`
- `package.json`：`test:rust` 改指 console 壳；移除 `probe`
（其「对真机逐项核对字段」的用途已由 CLI `nodeagent invoke` 覆盖）
- 引用清理：README（数字与协议客户端说明）、console 前端两处注释、
console-plan（开头加「原方案已被取代」提示 + 补改造详情）、ROADMAP 历史描述加退役批注
## 验证
- **`cargo test` 3/3 通过**（真跑 Node sidecar 子进程：spawn/请求-响应/错误不崩）——
这是关键：sidecar 管理器**不依赖 Tauri GUI**，故核心逻辑可在 CI 真实验证，不必等人工开窗口
- `cargo check` 零警告；clippy 标准与 CI 一致
- 273 单测 / 7 包构建 全绿
- ⚠️ **仍需人工验证**：Tauri GUI 端到端（开窗口 → 连被控端 → 点界面），沙箱跑不了图形应用
|
2026-10-10 15:16:24 +08:00 |
|
|
jkooe
|
d065242413
|
docs/ci: README 数字校正 + checkout 升 v5
- README：统计口径已过期（43 能力 · **32** MCP 工具 · **114** 单测 · **26** E2E），
校正为实测值：43 能力 · 38 MCP 工具 · 215 单测 · 30 E2E · 11 Rust 单测。
另补「桌面控制台」小节（架构图、页面表、构建命令、平台门控说明）与构建步骤说明
—— 新组件入库后不同步 README，读者会以为仓库里没有它。
- CI：actions/checkout@v4 → v5，消除 runner 上的 Node.js 20 弃用告警。
仅升被标记的这一个；setup-node / pnpm-action 未被标记，不做未验证的连带升级。
|
2026-10-07 10:18:52 +08:00 |
|
|
jkooe
|
0a5fa715d4
|
ci/test/chore: Rust CI + e2e 契约守卫 + 发版闸门加固
【新增 .github/workflows/rust.yml】crates/ 此前**零 CI 覆盖**（唯一工作流只在
windows-latest 跑 pnpm 那套，不碰 Rust）。新工作流走 Linux 快车道，只跑该 crate：
- clippy --all-targets -- -D warnings（告警即失败；该 crate 既定标准是零告警）
- cargo test（9 单测 + 2 E2E）
- **工具链锁死 1.98.1** 而不跟 stable 漂 —— 否则 lint 集合随工具链漂移，
「本地全绿」与「CI 绿」会分叉（本仓库已因同类原因吃过 8 轮 Windows CI 的苦头）。
本步当场抓到一处真实 lint：discovery.rs 的 sort_by(|a,b| b.f.cmp(&a.f)) → sort_by_key(Reverse(..))。
【tests/e2e/run.mjs】新增 testContractShapes：对**真实被控端**调 7 项只读能力，
断言返回字段 ⊆ manifest returns_schema（含数组首元素）。与单测侧的 console-contract
合起来构成闭环：
agent 实现 ──e2e──▶ 协议契约 ──unit──▶ 前端类型
只调无副作用能力（不写文件/不装软件/不动输入），避免 E2E 产生难回收的变更。
**已注入故障实测会红**：给 system.info 塞 injected_drift_field → 精确报出契约外字段。
【scripts/release.mjs】发版闸门补第二层。原闸门只查 git ls-files --others（未跟踪文件），
但紧接着的 `git add -A` 会提交**已修改的跟踪文件**，而它们不在原闸门视野里 —— 真例：
`pnpm install` 把某应用依赖写进跟踪中的根 pnpm-lock.yaml（+1401 行），发版时静默推走
且闸门不响。现补「脏文件白名单」：除脚本自己改的文件外，任何脏跟踪文件一律中止发版。
另：Tauri 的版本号不在 package.json 而另存于 src-tauri/tauri.conf.json（且它才是打进
.app 的版本），原先漏更新 → 现一并纳入版本号写入，避免「包里是旧版本号」。
【package.json】补 test:rust 与 probe 脚本（probe 需 crates/ 在库内，现已满足）。
|
2026-10-07 10:14:29 +08:00 |
|