v2.1.0 — 自动归组、附件导入与连接诊断

Local Workspace 2.1.0

本次更新保留 2.0.2 的原图预览、工作区详情、Windows 路径打开和按钮样式，新增自动会话归组、聊天附件导入与连接诊断。

新功能

• 请求包含官方 openai/session 元数据时自动归组；组织和用户标识参与区分。显式手动登记继续可用，标题修改不会被后续路径调用覆盖。匿名会话标识不是 ChatGPT 真实会话链接，也不是权限凭据。
• 第 25 个工具 import_file 使用 openai/fileParams 声明输入，接收 file_id、download_url 和可选文件名、类型。用户指定本地目标路径；目录需已存在，文件必须是新文件。最多 32 MiB、整体下载期限 45 秒、最多 3 次重定向，采用临时文件与原子创建，返回 SHA256。
• 文件下载使用 TLS 1.2，保留服务器证书校验。拒绝 HTTP、带用户信息的 URL、非 443 端口和内网/回环目标；兼容 TUN 代理将域名映射到 198.18/15 的合成 DNS，仍拒绝直接使用该网段的 IP 地址。签名 URL 不写入工作台回执和日志。
• 工作台诊断面板分别显示配置、隧道存活、隧道就绪、握手、发现、成功调用和会话信号；桌面“更多”菜单也提供入口。配置检查调用同目录官方 Tunnel Client 的 doctor --json --explain，只呈现已知检查项目和状态。不会重启服务。
• 各工具声明返回字段；模型正文使用短摘要，完整字段统一读取 structuredContent.result。原生图片内容和命令输出仍可访问。

升级

1. 解压发行包，保留 LocalWorkspace.exe、dashboard.html、tunnel-client.exe 及许可证文件。
2. 退出旧程序后启动新版，沿用原有配置。
3. 在 ChatGPT 设置中刷新连接器工具，并在新聊天中调用 get_workspace_status。
4. 核对 version: 2.1.0 与 tool_count: 25。

自建客户端如果解析 content[0].text 中的 JSON，需要改为读取 structuredContent.result。输出的业务字段保留，正文摘要不再是 JSON。自动归组是当前进程内状态，重启后重新建立；没有宿主会话元数据时继续使用 register_conversation。

验证范围

• 本地真实 EXE 的 legacy / modern 协议、文件和命令工具回归；各工具的真实结果通过声明的 JSON Schema 校验。
• 模拟宿主元数据的会话稳定性、不同会话/组织/用户区分、手动兼容、命名保持，以及命令和任务误用另一会话 ID 的拒绝行为。
• modern 确认后重试与自动归组组合；失败回执和活动记录不泄漏签名下载 URL。
• 公网 HTTPS 文件下载并逐字节及 SHA256 比对，HTTP 404、已有目标和内网地址失败处理；失败后不留下临时文件。
• 实际浏览器中的诊断打开、重复检查、关闭后重新打开及窄窗口布局；既有图片、路径与工作区详情回归。
• 使用发行目录中的官方 doctor 验证无效配置；受控本地健康端点验证“存活通过、就绪失败、工具调用待验证”能够分别呈现。

最终 dist/LocalWorkspace.exe 的测试运行报告 19 个条目通过。认证 Tunnel 冒烟脚本未启用，未将其退出成功计为宿主连通证据。

这些验证使用隔离进程。没有将本地模拟请求标成 ChatGPT 端到端验收：真实 ChatGPT Tunnel 是否转发匿名会话信号、具体账号是否显示附件选择，需要从宿主实际发起调用。诊断页的“未检查”“待验证”保留这一差别。发布包继续固定 OpenAI Tunnel Client v0.0.14；本次未升级隧道组件。

官方依据

• 插件参考：文件输入与客户端元数据
• 构建 MCP 服务：工具说明与返回值
• 优化工具元数据
• Secure MCP Tunnels：doctor 与健康接口

标准 Codex 插件目录打包留作独立工作，本版仍按现有 Windows 桌面程序与 ChatGPT Tunnel 方式分发。

发行包 SHA256：E33042A1A2A677E788168CFB9E608E2DC54A90DF56056DC7661B9BD41F270E11

2.0.2 — 图片预览、工作区详情与 Windows 路径打开

本次更新补全了工作台里的图片和工作区详情，并统一路径操作与按钮外观。

• 查看图片：直接预览本次 read_image 实际读取的内容，可切换适应窗口 / 原始尺寸，显示尺寸、格式、大小和位置。文件后来变化不会替换历史预览。
• 工作区状态：展示版本、程序位置、面板地址、运行中命令、已登记目录及 24 个工具。
• 点击路径：目录在 Windows 资源管理器中打开，文件在目录中选中，HTTP/HTTPS 地址由默认浏览器打开。支持中文、空格和特殊字符，并显示失效路径的原因。
• 按钮：移除刷新、暂停、复制、侧栏切换等按钮的原生黑框，统一轻背景、圆角、浅深色与键盘焦点。
• 文档：更新中英文 README，新增图片预览与工作区状态截图。

下载与升级

下载下面的 local-workspace-2.0.2-windows-x64.zip，解压后保持 LocalWorkspace.exe、dashboard.html 和官方 tunnel-client.exe 在同一目录。随附 Tunnel Client 版本仍为 v0.0.14，无需重新填写原有配置。

完成当前任务后退出旧程序，再启动新版。运行中的旧进程不会因文件替换自动升级；旧进程没有保存的图片需要重新读取。预览缓存仅在当前进程内保留，最多 100 张 / 32 MiB。

验证

针对最终 dist EXE 的本地测试报告 17 项通过、0 失败；实际浏览器检查图片、工作区详情、浅深色和窄屏布局。通过 Windows Shell 确认目录打开与文件选中。认证 Tunnel 冒烟未启用，未中断现有连接。

ZIP SHA256: e942943326e8dc0973d32acdb898368a8ddbde956fbb80bb7836f64d69ba70c2

2.0.1 —— 修复 ChatGPT 安全校验阻断（icons 仅 modern 下发）

修复：ChatGPT 连接器对 2.0.0 的 tools/list 安全校验失败（拒绝 data-URI 图标），导致所有工具调用被宿主阻断。

• icons 改为仅 modern（2026-07-28）时代下发；legacy tools/list 与 1.7.0 逐字节一致（新增回归断言）
• 其余 2.0.0 能力不受影响：server/discover、MRTR 确认、Tasks 扩展、OTel trace、缓存字段
• 升级后请在 ChatGPT 设置 → 插件 → 本地工作区 → 信息 刷新工具列表；若仍阻断，删除连接器重新添加

发行包：local-workspace-2.0.1-windows-x64.zip

2.0.0 —— dual-era MCP server (2026-07-28) + MRTR confirmations + Tasks extension

对照 MCP 2026-07-28 规范的协议大版本。

• Dual-era：legacy（initialize，ChatGPT Tunnel 现行）零回归；modern 无状态协议：server/discover、每请求 _meta 版本协商、resultType、可缓存 tools/list、serverInfo 回执
• MRTR 危险操作确认：elicitation 能力下 apply_patch / 覆盖写先返回 input_required；requestState 经 HMAC-SHA256 签名，防篡改与重放
• Tasks 扩展：exec_command 长任务返回标准 task 句柄（tasks/get / tasks/cancel / tasks/update）
• OpenTelemetry：traceparent 记入操作日志，工作台检查器显示 trace 短 ID
• 24 个工具附 SVG icons；get_workspace_status 增加 protocol_versions
• 新增 tests/modern.test.cjs，全量 16 项测试通过

发行包：local-workspace-2.0.0-windows-x64.zip（单 EXE + 官方 tunnel-client，解压即用）。详见 UPGRADE-NOTES.md。

1.7.0 — 桌面重绘 + 内嵌实时工作台 + ChatGPT 卡片下线

1.7.0 更新内容

• 桌面程序重绘：单行工具栏（启动/停止合一、在浏览器打开、更多菜单）+ 实时工作台 / 操作记录 / 原始日志 / 连接配置 四个页签；操作记录与原始日志为自绘视图（级别徽章/芯片、等宽排版、尾随跟随）。
• 实时工作台内嵌：首个页签经 WebView2 嵌入工作台页面，连接就绪自动载入；WebView2 组件以资源内置，保持单 EXE 发行；缺运行时自动回退浏览器。
• ChatGPT 卡片下线：移除 render_workspace 与 resources 通道，工具数 25 → 24；可视化进度统一在桌面程序查看，对话内回执为文本。
• 配置校验：Tunnel ID / API Key 缺失或格式错误时，启动/保存自动跳到连接配置页签并标红对应输入框。

使用

1. 解压后 LocalWorkspace.exe 与 tunnel-client.exe 必须同级保留。
2. 按 README「快速开始」在 ChatGPT 网页启用 Developer Mode、创建连接器，拿到 Tunnel ID 与 API Key 填入桌面程序「连接配置」页签。
3. 从旧版升级后：在 ChatGPT 设置 → 连接器 → 本地工作区 → 信息 中刷新元数据，并新开聊天验证（get_workspace_status 应返回 version 1.7.0、tool_count 24）。

完整说明见仓库 README.md；升级明细见 UPGRADE-NOTES.md。