Repository navigation
Releases
Releases · woodtong/neutrino
GhostScreen v0.1.0
首个 GitHub Release。发布线版本从 0.1.0 起独立编号,与开发线版本(当前 0.5.0-dev)分开;本包是开发线 0.5.0-dev + gs doctor(P2-07)的快照。
下载
| 文件 | 说明 |
|---|---|
GhostScreen-0.1.0-win-x64.zip |
self-contained MCP / CLI / Tray(Windows x64,无需安装 .NET) |
GhostScreen-0.1.0-win-x64.zip.sha256 |
SHA256 校验和 |
解压结构:mcp/、cli/、tray/、docs/、README/CHANGELOG/LICENSE/VERSION。包内 gs version 输出 GhostScreen 0.1.0。
新增(相对 0.4.0-beta)
Human Consent Gate(默认 strict)
- 人在最近 2 秒内有输入时,需要焦点的 UIA 动作不再静默抢前台:先返回可重试的
USER_ACTIVE(attempts / max_attempts / retry_after_ms)。 - 连续 3 次被挡后返回
AWAITING_USER(一次性consent_id+expires_at);托盘弹出非激活的 Allow/Deny 窗,15 秒倒计时,不抢焦点。 - 无人响应时倒计时自动放行;
USER_DENIED为终态;CONSENT_EXPIRED需重新请求。 - 票据绑定具体 target/action/element、一次性、授权后 30 秒过期;服务端只授权,动作由 Agent 执行,不会重放旧动作。
- 窗口消息与 CDP 路径永不经过门禁。
gs doctor 环境自检 + 排障文档
gs doctor [--json] [--bundle path]:检查 OS 版本/架构、Edge 路径与版本、WGC 可用性、虚拟屏/停车点、state 目录与 journal、status.json 端点;每项带 hint,任一 fail 时退出码 1。--bundle输出脱敏报告(用户名 →%USER%、token →%REDACTED%),可直接贴 issue。- 新增 doc/19-Troubleshooting:现象速查、错误码表、服务环境注意事项。
焦点安全(0.4.1-dev)
- 原生元素动作改为窗口消息优先(
BM_CLICK/WM_SETTEXT),不激活停泊窗口。 - 无 HWND 的 WPF/UWP 控件走 UIA 回退,执行后由
FocusGuard恢复原前台。
性能
- 窗口事实缓存、进程名 30 秒 TTL、点选场景去掉重复 UIA 树遍历、
click_element(name)去掉重复元素解析;本地微基准list_windows29.15 → 1.04 ms/op。
验证
- 测试 34/34;构建 0 warning / 0 error;
dotnet format --verify-no-changes通过。 gs doctor本机 6 项实测(os OK / edge WARN / wgc OK / display OK / state_dir OK / status INFO)。- 发布包自检:
gs version=GhostScreen 0.1.0;MCPinitializeclientInfo 版本0.1.0;stdio 冒烟返回 21 工具。
已知限制
- 混合 DPI/双屏、锁屏/唤醒未测(单屏)。
- 24h soak、4 target 混沌(锁屏/切桌面/断网)未完成。
- 托盘无暂停/恢复、登录自启;VDD、干净机器、代码签名未完成。
- 安装脚本 unsigned,SmartScreen 可能提示。
- UWP 协商门、多 Agent 排队/允许 5 分钟未实测。
从 0.4.0-beta 升级
- 替换
mcp/、cli/、tray/三个目录;MCP 工具签名不变(21 工具)。 - 行为变化:UIA 焦点动作默认走 strict 协商门;需要旧行为时可调整
InteractionPolicy(见 03-接口设计)。 - 建议升级后先跑
gs doctor确认环境。
完整说明:doc/17-0.1.0发布说明