概览
dsh-image-gen
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- 参考图编辑使用 DSH 文件路径并逐次请求外部上传授权。专用附件选择器仍是后续工作;无交互环境或 `approval: never` 会话会拒绝上传。 - ChatGPT Codex 订阅端点属于私有兼容接口。真实请求证实它接受两个 GPT Image 2.5 模型别名与 `xhigh` / `max` 档位,但会忽略字面的 `size` 与 `quality`,按自己的预算出图(2026-09-11 实测:`high` 为 `1774x887` / 1030 token,`max` 为 `1536x1024` / 1372 token)。官方仍未把它描述为 Image API 编辑端点,因此插件继续禁用订阅参考编辑和仅公开 API 支持的输出参数。 - 订阅路径的 `size` 与 `quality` 影响的是 Provider 自身预算,而非字面请求,因此同一档位交付的尺寸与消耗可能与 API Key 契约不同。 - 卡片通过回环 RPC 读取成图,而 Host 需要从会话存储中授权该次读取,会话存储是异步写入的。因此读取请求可能早于结果事件落盘。`0.4.1` 把这种情况当作可恢复而非终态:Host 会为刚生成的引用保留 `servedResultTtlMs`(默认 5 分钟,且绝不是长期授权通道),返回独立的 `pending` 原因,卡片按有界退避重试后才显示可操作的提示。把 `servedResultTtlMs` 设为 `0` 可让会话存储在任何时刻都是唯一授权来源。 - 最终预览刻意限制为回环访问。远程 Web 客户端只会看到明确的不可用状态,不会收到图片字节。 - 当前 DSH 凭据解析和附件保存服务不接收取消信号。插件会在这些阶段前后检查取消,并在卸载时等待它们结束,但无法中断卡死在服务内部的 Provider 实现。 - OpenAI 可能调整任意尺寸限制或事件字段。遇到不兼容响应时,插件会安全失败,而不是猜测。 - GPT Image 2.5 的 API Key 路径仅用确定性的 Provider 模拟响应验证,未在真实计费账号上调用。Codex 订阅路径已用真实订阅额度验证 `gpt-image-2.5-flare` 与 `gpt-image-2.5-sunburst`;真实 API Key 调用以及订阅端点上的 `gpt-image-2` 仍待验证。
