# 路线图

dsh-iris 已具备媒体生成、视觉处理和任务管理主流程。长期方向是宿主无关的多模态生产运行时，DSH 是首个受支持宿主。当前仍通过 DSH 插件使用，独立 Core、CLI 和工作台尚未实现。

变更详情见[变更记录](../CHANGELOG.md)，完整工具清单见[README](../README.md)。

## 当前状态

现有功能包括：

- 图像、视频、语音生成和音频转写
- 看图问答、OCR、定位、裁剪与像素比较
- 视频抽帧和多模态摘要
- 多供应商模型池与复合模型身份
- 浏览器上传、会话附件和宿主路径输入
- 异步任务恢复、取消传播、SSE 状态更新和授权媒体链接
- 面向 Agent 与用户的统一视频生成实现
- 两个仓库级 Agent Skills：UI 视觉验收与多步骤媒体编排

当前版本为 `v0.1.1`。该补丁完成配置独立、安全与工程收口，并把 Web loader 适配固定到已验证的 DSH `0.1.2-rc.1` 接口；更高预览版在进入支持范围前需要重新运行宿主 canary。

## 已完成：0.1.1

### 配置独立与工程收口

- 对齐公开文档和已发布标签，明确当前能力与未来方向。
- Iris 独立保存配置；ai-paint 仅作为维护者未公开的本地前身和可选迁移来源，不是用户依赖。停止默认读取，仅保留显式指定本地来源的一次性安全导入。
- 用 Node.js 调度测试，去除对 POSIX Shell 循环的依赖。
- 绑定供应商凭据与协议端点，统一私有存储权限和流式原子落盘，并验证损坏配置恢复。
- 将付费能力实测改为单项显式确认，视频与转写不做空样本自动探针。
- 默认将 Iris HTTP 路由限制在回环 Host，为反代提供显式信任列表和认证部署说明。
- 增加 Linux/Windows 与 Node.js 20.9/22 CI 矩阵、发布前测试护栏，并以当前 DSH 预览版完成宿主烟测。
- 核对打包清单，记录真实环境和未验证平台。

## 下一步

### 后续 0.1.x：可信基座

- 区分提交未受理、已受理与受理未知，完善 Attempt、取消和恢复语义。
- 用故障注入验证提交响应丢失、下载和落盘失败时不会重复提交。
- 定义最小宿主与供应商契约，提供离线诊断入口。

### 0.2.0：独立 Core 与产物记录

- 统一 Agent、工作台与 CLI 的命令执行核心，将 DSH 集成集中到宿主适配器。
- 为产物保存内容哈希、来源和派生关系，支持检查与导出。
- 在未安装 DSH 的干净环境完成本地动作和供应商任务验收。

### 后续方向

- 0.3：有界、可恢复的媒体工作流，以及用户显式启动的本地 API 和最小独立工作台。
- 0.4：根据真实消费者需要开放供应商和宿主适配契约。
- 1.0：冻结经过验证的公共契约和升级策略。版本表示目标聚合点，不代表发布日期承诺。

## 兼容性与限制

- Node.js 最低版本为 20.10。
- 图片处理依赖 `sharp`，非标准 libc 或移动终端环境可能没有可用的预编译包。
- 视频抽帧与视频摘要依赖 `ffmpeg` 和 `ffprobe`。
- WSL、远程浏览器和容器部署应优先使用上传或会话附件，避免混淆浏览器路径与宿主路径。
- HTML 截图运行在离线沙箱中，远程资源和页面脚本不可用。
- 模型发现只能列出候选项，具体能力需要通过实际请求确认。
- Node 测试调度器不依赖 Bash；原生 Windows/WSL 完整测试与 DSH 冒烟尚待验证，不因调度器改写而宣称已支持全部平台。

## 质量要求

计划中的改动应满足以下条件：

- `npm test` 通过，并为新增行为补充有针对性的测试。
- 不泄露供应商密钥、宿主绝对路径或未授权媒体内容。
- 不在远端任务受理后自动重提生成请求。
- 不让局部配置更新覆盖未修改字段。
- 在支持的平台上保持 Agent 工具与工作台行为一致。
- 发布前检查 npm 包内容和公开文档中的相对链接。

## 暂不计划

- 在插件内实现账号、权限或多租户系统。
- 接管 DeepSeek Harness 的通用聊天模型配置。
- 由 DSH 插件隐式启动独立后台服务或额外监听端口。
- 在本地工作台阶段建设公网 SaaS、组织账号和多租户系统。
- 自动探测全部模型能力并触发可能计费的请求。
- 仅为未来可能使用的供应商预建没有调用方的适配层。