Jupiter：图片对话与网页版

1.0.9 增加了两项功能：把截图直接发进会话，以及从浏览器打开同一套工作区。前者方便讨论界面问题，后者让桌面以外的设备也有了入口。

图片附件需要跟随草稿、排队消息和历史记录保存，编辑消息或重启后仍能打开。Web 版复用桌面界面时，还要处理文件传输和多个客户端的会话写入。

1. 图片附件的存储与恢复

1.1 先存本地资源，再保存引用

粘贴、选择和拖放图片走同一套附件处理。图片先解码、校正方向和压缩，再按内容哈希保存；消息里留下资源引用和尺寸等元数据。下面是ImageAttachment 类型的源码摘录：

export interface ImageAttachment {
  kind: "image";
  id: string;
  name: string;
  mime: ImageMime;
  bytes: number;
  width: number;
  height: number;
  originalWidth?: number;
  originalHeight?: number;
  staticFrame?: boolean;
}

id 对应持久图片资源。会话正文不用塞进很长的 base64，也不用拿供应商的临时 file ID 当永久地址。这样草稿、排队消息、编辑重发和失败恢复都能继续引用原图。

1.2 上下文压缩与资源清理

上下文压缩会保留原图引用。清理资源时，还要查看会话、归档、备份和草稿有没有用到它。仍有引用的图片会保留，避免清理后旧对话无法打开附件。

2. 本地图片和模型端文件分开保存

官方 Files 上传结果可以复用，明确失效时才做受限回退；第三方端点使用内联图片。本地资源保存用户材料，上游文件缓存负责当前供应商的上传，两者寿命不同。上游引用过期以后，仍能从本地原图重新准备请求。

供应商配置按一组数据测试和保存。普通 OpenAI 兼容端点不会顺带收到 DeepSeek 的 thinking、reasoning、prefix 或缓存扩展字段，也不会在不提示的情况下把历史图片交给另一个模型。

3. Web 版直接复用桌面工作区

Web Beta 复用 Desktop React 界面、会话和 Agent 运行时，文件上传下载、预览、终端、Git、通知和设备管理都接进浏览器。手机宽度下，左右面板收进抽屉，主对话区先留出来。

本机启动命令来自Web Beta 指南：

jupiter web /path/to/project

默认监听随机端口的 127.0.0.1。浏览器通过上传下载入口访问授权工作区中的文件。桌宠、自动更新、全局快捷键和原生内嵌 WebView 仍属于桌面端。

4. 设备配对与会话写入控制

设备通过一次性链接配对，也可以撤销。多个页面能看任务，但同一时刻只有一个持有写入租约，也就是当前被允许发送消息和执行操作的页面。Desktop 和 Web 同时打开同一会话时，还有跨进程会话锁负责单写保护。

断线恢复也要核对连接代次和重放事件，免得把断线前的消息当作新操作。查看会话与写入会话使用不同的权限。

公网访问需要配置代理、身份验证和设备控制权，配置示例见对应版本访问指南。

5. Beta 功能范围与相关文档

图片附件支持草稿保存、历史恢复和重新发送，Web Beta 支持从浏览器继续处理项目。识图效果取决于所用模型和图片，浏览器、设备及网络兼容性仍需继续测试。

附件存储和请求投影可继续看多模态实现说明，发布记录在 1.0.9 Release。