# 开发路线与验收范围

本文保留完整目标。`0.2.0` 已交付的范围以 [VALIDATION.md](VALIDATION.md) 为准，不能把下面所有条目当作已交付。

## 1. 连接与模型提供方

- 独立插件设置，配置 API 地址与凭据引用，测试连接。
- 注册原生 dsh LLM 提供方；复用 dsh 会话、工具、权限和重试机制。
- 拉取模型目录，合并能力元数据与已知规则，未知模型支持手动分类。
- 只把聊天模型注册到聊天选择器；媒体模型用于对应工具。
- 思考等级、上下文、输出限制按精确模型声明，未知值不伪装为已验证。

## 2. 图片、视频和语音工具

- 图片生成与编辑；验证返回链接及 Base64 等实际响应格式。
- 视频生成、任务查询，分别验证编辑和延长接口。
- 文字转语音；不将 TTS 等同于语音识别或实时语音对话。
- 工具结果关联调用会话，明确参数、错误阶段和上游能力限制。

## 3. 持久任务与结果

- 记录任务 ID、模型、状态、时间和文件引用，不保存调用密钥。
- 真实进度与阶段展示，区分提交未知、生成失败和下载失败。
- 下载临时结果，临时文件完成校验后转为正式文件。
- 断网与重启恢复、有限重试、避免重复生成和重复费用。
- 默认私有保存；日志不泄露密钥或含凭据的结果 URL。

## 已知问题（等待上游或后续版本）

### 聊天路由依赖官方适配器的内部注册约定

插件的聊天路由复用 `@deepseek-ai/dsh-llm-pi-ai`。该包只导出 `PiAiAdapter` 类，而实例化它需要内部的 `profiles()`、`auth`（凭据存储与授权上下文）等结构，没有公开的「第三方构造一条路由」入口。因此 `src/adapter.js` 用一份最小 scope 调用官方 `apply`，再捕获它注册的适配器实例。

- 影响：dsh 调整注册约定或其内部依赖的作用域时，路由会注册失败。版本门禁是 `engines.dsh` 的 `>=0.2.1-rc.2 <0.3.0-0`。已核对 `@deepseek-ai/dsh-llm-pi-ai@0.2.1-rc.2`：公开导出有 `apply`、`Config`、`PiAiAdapter`，但构造适配器所需的凭据存储和模型集合助手仍未导出。升级 dsh 必须重跑集成测试。
- 现有缓解：捕获到的实例再交给公开的 `ctx.llm.registerAdapter`。集成测试断言它是官方 `LlmAdapter`，并校验 `providerInfo` 与 `listModels`；注册失败保留真实错误并写入 warn 日志。
- 解除条件：dsh 导出可独立构造的第三方路由工厂后，改为直接调用并删除 scope 捕获。

## 4. 展示与发布

- 复用图片、附件和文件交付；验证桌面与 Web 的实际行为。
- 增加音视频展示，验收播放、寻址、鉴权、错误和文件缺失状态。
- 本地与公网网关分别验收，明确超时与上传限制。
- 文档说明受支持的 dsh 版本与已验证功能。
- 完成实现和验收后再发布可安装版本及 npm 包。