Marionette v0.2.0 — Portable
单文件 Windows 可执行程序，无需安装。
下载
- Marionette.exe（约 1.2 MB，UPX 压缩）— 拷到任意位置双击即可
- 另附未压缩版约 4.1 MB（构建产物，一般用压缩版即可）
系统要求
- Windows 10 / 11
- Microsoft Edge WebView2 Runtime（多数系统已自带）
- 若缺失：启动时会弹窗并给出官方下载链接（不会静默安装）
相对 v0.1.0 的主要更新
资源管理器集成
- 在此处打开 Marionette：文件夹 / 空白处右键（Win11 在「显示更多选项」或 Shift+右键）
- 首次运行自动注册；再次启动会刷新 exe 路径（便携移动后仍可用）
- 从路径打开时：项目置顶、显示「此处」角标、默认选中并新建对话
- 单实例：已在运行时再次打开会交接路径并聚焦窗口
侧边栏与会话恢复
- 记住上次聚焦的对话与打开的标签（冷启动恢复）
- 项目折叠状态持久化
- 项目列表不再 Show more/less，全部项目可见；会话列表仍可折叠
长对话性能与稳定性
- 工具密集会话（数百个 tool card）不再卡死 WebView
- 折叠的 Tool/Thought 懒加载正文
- 长 transcript 重新启用虚拟列表
- 空闲会话加载时关闭孤儿
pending工具，避免误显示「进行中」 - Shell/subagent 完成后正确收起工作中卡片
多 Agent / 流式 / 使用量
- 全内置 Agent 登录探测与 Sign-in
- Claude
/usage解析与展示；隐藏聊天栏中的 usage 转储 - ChatGPT 订阅用量；Grok billing / always-approve 偏好
- 流式文本管道：剥离 transport 标记与 runtime 元数据
- Codex / Grok thought/reply 空白 token 保留；fence 修复
- 选择文字时冻结 transcript DOM，避免流式更新清掉高亮
- OpenCode 子代理更诚实的状态与更长静默阈值
- 取消后的 stream 粘合、detached 窗口中断
工作流与 UI
- 发送时可排队（live turn 中下一条自动续发）
- Git 分支指示
- 项目拖拽排序、会话按最近活跃排序
- 标签撕出独立窗口（multi-window）
- 发送键：Enter 或 Ctrl+Enter（右键菜单切换）
- 记忆每个 Agent 上次使用的 model / effort / mode 作为新会话默认
- 冷会话内存裁剪、图片卸载，降低 RAM
- 桌面通知（回复 / 卡住时任务栏闪烁 + 提示音）
- ACP elicitation、权限/问答/计划审批卡片
- 应用内更新检查；自定义 Agent；预检 npm/Node（Windows GUI PATH 加固）
- 关闭窗口时避免 tao WebView paint 断言崩溃
文档
- README 面向非专业用户重写；截图与 Tasks 说明
使用说明
- 未代码签名，首次运行可能被 SmartScreen 拦截 →「更多信息」→「仍要运行」
- 应用数据：
%USERPROFILE%\.marionette；项目数据：项目目录下.marionette - 右键「在此处打开」：Win11 现代菜单里通常在 显示更多选项 中（系统限制，非 bug）
构建
本机：build-portable.bat 或 npm run build:portable（可选 UPX 压到 ~1.2 MB）