Marionette v0.2.0

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）

Marionette v0.0.1

Marionette v0.0.1 — Portable

单文件 Windows 可执行程序，无需安装包。双击即用。

下载

• Marionette.exe（约 1.22 MB）— 拷到任意位置双击即可

系统要求

• Windows 10 / 11
• Microsoft Edge WebView2 Runtime（较新系统一般已自带）
• 若缺失，启动时会弹窗并给出官方下载链接（不会静默安装）

---

本版本更新

首个面向日常使用的便携版发布。Marionette 是一个多 Agent CLI 图形壳：不替代 OpenCode / Claude Code / Codex / Grok 等原厂 agent，只负责启动、展示、切换、记录与 handoff。

核心能力

• 一个窗口，所有 Agent — Claude Code、OpenCode、Codex、Grok Build 等，按需懒启动，不占空闲资源
• 切换 Agent 不断上下文 — 自动生成 handoff Markdown，支持对话接力
• MCP / Skills 统一管理 — 扫描一次，多 Agent 共享
• 轻量便携 — 单文件约 1.2MB，内存占用克制

对话与交互

• 统一消息卡片：思考过程可折叠，工具调用清晰
• 对话目录 / 消息批注 / 图片批注（点选框选直指要改处）
• edit & resend、权限弹窗、Ask Question / Plan 审批
• @ 委派：消息里点名另一个 Agent，上下文自动交接
• 智能回复气泡（拖入文件、选项、报错、继续执行等场景）
• 发送键可切换：右键发送按钮，在 Enter 与 Ctrl+Enter 间切换

项目与窗口

• 项目拖拽排序、会话按最近发送时间排序
• Tab 撕出多窗口（幽灵预览后独立窗）
• 多窗口状态同步；关窗防闪退与隐藏壳回收
• 侧栏打开项目文件夹 / 资源管理器

用量与登录

• 右侧栏展示上下文用量
• ChatGPT / Claude / Codex / Grok 等额度与限流信息
• 各内置 Agent 登录状态探测 + Sign in 引导

记忆与稳定性

• 会话 JSONL 持久化，重开不丢、可搜索
• Git 感知：改动文件列表与只读 diff
• 记忆每个 Agent 上次使用的 model / effort / mode，新会话自动沿用
• 冷会话剪枝、虚拟列表、图片卸载，降低内存
• 流式输出清洗（去掉 transport 标记与运行时元数据）
• Codex full-access 模式发送前重同步；Grok 始终批准偏好
• OpenCode 鉴权类型与未登录状态修正
• Windows 关闭崩溃修复（tao paint re-entry）

其他

• 自定义 ACP agents、应用更新入口
• Tasks 项目级 Todo（手写增删、换 Agent 不丢，可吸收 AI Plan）

---

说明

• 未代码签名，首次运行可能被 SmartScreen 拦截（「更多信息」→ 仍要运行）
• 应用数据目录：%USERPROFILE%\.marionette 与项目下 .marionette
• 本机构建：build-portable.bat 或 npm run build:portable

快速下载

gh release download v0.0.1 --clobber -p Marionette.exe

Marionette v0.1.0

Marionette v0.1.0 — Portable

单文件 Windows 可执行程序，无需安装包。

下载

• Marionette.exe（约 4.69 MB）— 拷到任意位置双击即可

系统要求

• Windows 10/11
• Microsoft Edge WebView2 Runtime（较新系统一般已自带）
• 若缺失，启动时会弹窗并给出官方下载链接（不会静默安装）

构建方式

本机：build-portable.bat 或 npm run build:portable

说明

• 未代码签名，首次运行可能被 SmartScreen 拦截（「更多信息」→ 仍要运行）
• 应用数据在 %USERPROFILE%\.marionette 与项目目录 .marionette