 jkooe
|
8ab8f8ae80
|
feat(crates): 入库 Rust 控制端客户端 nodeagent-client
复刻 @nodeagent/client 的协议行为，供桌面控制台（Tauri 壳）经 Cargo path 依赖：
- 模块：error / types / ulid / crypto / tls / discovery / client
- 握手：hello → challenge → auth → auth_ok；psk(HMAC-SHA256) 与 ed25519 两种模式
- 证书指纹 sha256(DER) 钉住（E_CERT_MISMATCH）；ULID(Crockford Base32)
- 断线指数退避重连 1s→30s（±15% 抖动）
Rust async Send 三层陷阱（本轮主要成本，解法已写入 client.rs 注释）：
1. futures_util::lock::Mutex 无手写 Sync 实现 → 含它的类型整体 !Sync
2. tokio::sync::MutexGuard 非 Send
3. establish → spawn(read_loop) → on_disconnected → establish 构成**类型级递归**，
编译器无法证明 Send。最终采用**监督者模式**：单个 supervise 任务串行
「建立+握手 → 等读循环 Notify 断开 → 退避重连」，读循环只 notify 不回调
establish，从而打破递归；发送半用专用写任务 + mpsc 解耦（同步 send，不跨 await 持锁）。
测试：9 单测（crypto/ulid/Send+Sync 断言）+ 2 E2E（psk 握手→invoke 全链路、连不上端口
返回 NODE_OFFLINE），`cargo clippy --all-targets -- -D warnings` 零告警。
另附 examples/connect.rs（连真实被控端）与 examples/probe.rs（字段契约探针，
输出顶层键+数组首元素键，并按 system.info.os 区分「平台不支持」与「真失败」）。
.gitignore：crates/ 转正后必须显式忽略 /crates/target/ —— 此前是靠整个 /crates/
被忽略才没让 4GB 级构建产物进库，取消那条保护后会裸奔。
|
2026-10-07 10:13:41 +08:00 |
|
|
jkooe
|
5571cf1aea
|
chore: 取消跟踪误提交的在建工程（保持工作区文件不动）
上一个提交（v1.6）用了 git add -A，把工作区里**不属于本任务的用户在建文件**
一起带入并推送：crates/（Rust 客户端脚手架）、docs/console-plan.md、
docs/ROADMAP.md，以及 docs/RETROSPECTIVE.md 的本地改动。
本提交将它们移出 git 跟踪（磁盘文件全部保留、回到未跟踪状态），
使公开仓库只包含 v1.6 的预期变更。如需从历史中彻底抹去，
可另行 filter-repo 重写（公开仓库，需皇上决策）。
|
2026-10-07 01:22:58 +08:00 |
|
|
jkooe
|
2eb33587fe
|
feat(v1.6): 新增 gui.await 等待条件能力（复盘短板之「语义」）
把 GUI 操作从「按一下→睡几秒→截图碰运气」变成**可断言**：四类条件
window / control / process / file，各复用 window.list / screen.find /
process.list / fs.stat（零新平台代码，平台行为与既有能力一致，只读低危）。
- present/absent 两种等待；超时正确返回 satisfied:false + note
- 轮询期单次异常**不视为失败**（启动中程序常短暂报错），超时才带回 last_error
- 参数非法分两层拒：schema 层（协议错误）与业务层（E_PARAM_INVALID）
本地真实验证（macOS，7 项全过）：present 命中（1208ms/7 次轮询）、absent 命中、
超时返回、非法参数 2+1 拒绝、process 命中、底层报错不中断轮询（last_error 带回
辅助功能权限提示）、缺省参数可用。
能力数 42 → 43（数量守卫测试同步更新）；README 补快捷键与 gui.await 用法章节。
|
2026-10-07 01:21:41 +08:00 |
|