Files
goodbuddy/docs/features/conversation-media-generation/prd.md
T
mesalogo e5aa9ed688 fix: reuse runtime processes across project sessions
Multiple projects could spawn duplicate heavyweight runtimes, while settings
changes and remote reconnection could cancel or strand native conversations.
Share compatible local OpenCode and DeepSeek Harness process owners and
Agent-owned ACP connections, retaining workspace routing, per-session modes,
model attribution, question ownership, targeted cancellation and idle cleanup.

Restore remote pending questions and terminal task projections across reconnect
and desktop restart, and preserve accepted ordinary requests during settings
replacement while cancelling expert-team parents with their replaced scheduler.
Extend regression coverage and Agent type checks. Record measured resource and
real-model validation results, including failures and limitations.

Also include the conversation media-generation design drafts (not an implemented
feature), documentation entry links and dedicated Linux test-directory guidance.
Desktop and Agent changes must be delivered together for shared process results.

Validation: typecheck and lint passed; staged content and documentation links
checked. Prior full regression and live-model evidence are recorded in progress
notes; no new full test suite or model calls were run for this commit.

Release note: 多项目会话现在复用兼容的 OpenCode 和 DeepSeek Harness 进程,减少重复启动并保持工作区、工具和取消隔离。修复远端问答在断线、重启及配置更新后的恢复与状态同步问题,Desktop 与 Agent 需配套更新。
2026-09-15 08:14:42 +08:00

4.1 KiB

产品需求

状态:设计草案。本文描述目标行为,不作为现有能力说明。

用户问题与范围

用户希望在文字会话中直接提出“画一张海报”“把背景改成蓝色”“用这张图生成视频”,由聊天助手调用已配置的专用模型。用户不应为了生成媒体而丢失当前聊天入口;切换聊天模型后,也应能继续引用已有成果。

范围包括模型调用开关、默认与会话选择、文生图、支持协议下的参考图编辑、文生视频及图生视频、结果展示和生成过程管理。视频具体服务商及协议待技术选型;接通真实服务前不能宣称视频可用。

不包含模型训练、自动采购服务、无工具能力 LLM 的通用文本指令执行器、批量渲染平台、应用退出后仍由桌面后台执行的承诺。直接选择图片模型的已有工作流继续保留。

功能需求

首期交付

首期只交付图片生成,自动调用先接通直连文本 Model Runtime。支持已有图片协议下的文生图、参考图编辑、历史图片引用与成果保存,不新增图片协议。保留模型调用开关、一个全局默认生图模型及用户本次明确指定;编辑默认沿用原成果模型。首期不持久化会话级生成模型选择。

切换聊天模型、生成模型或离开会话后,已提交操作仍固定原模型和原会话。切换到尚未接入工具的 Runtime 后,原操作继续,但该 Runtime 暂不能自动发起生图。不支持工具调用时说明限制,用户可使用已有直连图片工作流;首期不增加独立生成表单。

运行状态、取消、错误说明及人工重新生成属于首期。应用退出后不继续本地生成;重新打开时将未完成操作标明结果未确认,不自动重新提交。跨重启查询恢复和独立“重试保存”入口后续再做。

后续范围

视频生成与播放、其他本地及远程 Runtime 自动调用、会话级模型选择、独立生成表单、查询恢复及保存重试不纳入首期验收。不为这些能力预建工具、存储字段或界面占位。

以下 FR 编号保留完整目标;FR-1 至 FR-8 按上述首期范围验收,FR-9 首期只要求准确说明已接通的 Runtime 和使用限制,其余接入后分别验收。

编号 要求 产品验收
FR-1 图片、视频模型分别提供会话调用开关;新增和已有连接默认关闭,由用户主动开启 保存后成为对应可用能力,关闭后不能再提交新操作;历史成果保留
FR-2 支持全局默认、当前会话选择和本次明确指定 按选择规则解析并显示实际模型;不静默改用其他服务
FR-3 在支持工具调用的聊天模型下,使用自然语言生成媒体 从聊天输入到真实服务输出、保存与会话展示完整可用,活动记录可见
FR-4 支持聊天模型、Runtime 及生成模型切换 新请求获得当前能力,已提交操作保持原模型和原会话;切换不触发重新生成
FR-5 支持历史成果引用与继续编辑 重新打开会话后可引用已保存原图;缺失素材或编辑能力不足时有明确处理入口
FR-6 长耗时生成可独立显示状态、取消与重试 离开会话不取消;状态区分上游生成、结果保存、完成及失败,不虚构进度
FR-7 适配工作模式及能力边界 Ask 不提交生成;不支持工具调用时仍可用 Execute 下的显式生成入口
FR-8 图片、视频作为会话成果保存 结果可预览和导出,来源模型可追溯;聊天模型不能看图时只接收文字事实及引用
FR-9 本地和远程 Runtime 有可核验的支持说明 自动调用以真实工具往返验收为准;未接通的 Runtime 显示原因及显式生成入口

交付标准

以用户场景验收产品路径。生图、视频和各 Runtime 分别记录验证结果,不用某一个模型或 Runtime 的成功代替其他路径。配置连接检查成功不等于生成成功,真实生成成果必须在会话中可见且能重新打开。