@mokuyoaxis/dsh-iris 0.2.5 → 0.2.6

package/.dsh/skills/iris-use/SKILL.md

@@ -5,7 +5,7 @@ description: "Use dsh-iris for a single media operation or an existing task: ima
 
 # 使用 Iris 媒体能力
 
-把用户要求交给对应的 Iris 功能，使用当前配置分配的模型，并交付实际产物。单独生成一首音乐、修改一张图片、识别文字或查询已有任务都适用本 skill。
+把用户要求交给对应的 Iris 功能，使用当前功能允许的模型，并交付实际产物。单独生成一首音乐、修改一张图片、识别文字或查询已有任务都适用本 skill。
 
 ## 选择入口
 
@@ -28,7 +28,7 @@ description: "Use dsh-iris for a single media operation or an existing task: ima
 ## 按当前能力执行
 
 - 当前工具列表是可调用入口的依据；skill 可见不代表插件已经装载新工具。工具缺失、服务端/客户端不一致或模型未配置时，说明具体缺口。必要时查看 Iris 工作台的宿主诊断与能力分配，不以生成请求探测配置。
-- 模型名称、供应商名称和模型目录不能证明能力。尊重用户指定的 `providerId::modelId`，其余按功能配置选择；Music 必须有明确分配，并绑定音乐协议。
+- 模型名称、供应商名称和模型目录不能证明能力。仅在用户明确指定时传 `providerId::modelId`，其余省略模型参数，按当前功能策略选择；不要默认填首个候选。Music 必须在当前功能允许范围内，并绑定音乐协议。
 - 参数与输入输出的详细区别见[共享能力和产物说明](references/media-contract.md)。仅阅读当前操作相关部分。
 - 请求歌曲或配乐时调用 Music；TTS 用于说话声音。音乐未配置或调用失败时报告原因，不擅自用 NumPy、节拍合成或 TTS 替代。用户明确要求程序化合成时按该要求处理。
 - 音乐生成的时长、歌词、演唱语言和风格当前由 prompt 表达；不把它们当作保证生效的结构化控制。

package/.dsh/skills/iris-use/references/media-contract.md

@@ -28,9 +28,9 @@
 
 ## 功能与模型选择
 
-生图、视频、TTS、Music、转写和视觉只使用各自明确分配的有序名单；空名单不调用，临时指定须已分配且只用该项。DSH默认视觉须明确加入视觉名单，不能在指定模型失败后隐式回退。手动实测独立于生产分配，旧任务查询/补交付仍绑定原模型。改图复用生图名单，接受 `openai-chat-images` 或 `dashscope` 原生 Qwen edit/max/plus、2.0/pro及日期快照；其他原生Qwen版本尚未接入。源图为一个Core静态PNG/JPEG/WebP，最多20 MiB；不提供蒙版或多张参考图输入。默认发送预算8 MiB，可按账号/模型调整；原生Qwen发送副本另限10 MiB，原作品保留。
+生图、视频、TTS、Music、转写和视觉按当前功能允许范围选择。0.2.4/0.2.5仅使用明确有序名单；0.2.6另支持已确认用途的自动池及显式停用，旧缺失/空分配不自动启用。仅在用户指定时传模型参数，只调用该项；默认省略，保留完整候选链。DSH默认视觉须明确加入名单或开启自动池的宿主视觉选项，不能在指定模型失败后隐式回退。手动实测独立于生产范围，旧任务查询/补交付仍绑定原模型。改图复用图片功能池，接受 `openai-chat-images` 或 `dashscope` 原生 Qwen edit/max/plus、2.0/pro及日期快照；其他原生Qwen版本尚未接入。源图为一个Core静态PNG/JPEG/WebP，最多20 MiB；不提供蒙版或多张参考图输入。默认发送预算8 MiB，可按账号/模型调整；原生Qwen发送副本另限10 MiB，原作品保留。
 
-Music 为独立 `music-gen` 功能，仅使用明确分配名单。模型须配置 `musicProtocol: gemini-web-music`；它不改变账号图片默认协议。其他 Music Adapter 尚未实现。当前正式参数控制客户端超时与502重试；曲长、人声、歌词、语言等是描述意图。
+Music 为独立 `music-gen` 功能，仅使用其当前允许范围。模型须配置 `musicProtocol: gemini-web-music`；它不改变账号图片默认协议。其他 Music Adapter 尚未实现。当前正式参数控制客户端超时与502重试；曲长、人声、歌词、语言等是描述意图。
 
 通用候选仅在明确未受理时切换。Music 的HTTP502策略是按配置重新生成同一模型，不是换供应商：默认额外2次、间隔5000ms，每次新Task并记录retriedFrom，可能额外消耗额度。Agent 调用一次工具后消费其结果；工具失败不授权另一层自动重试。已有完整结果优先补交付，详见各 skill 链接的任务恢复说明。
 

package/CHANGELOG.md

@@ -4,6 +4,31 @@
 
 ## [Unreleased]
 
+## [0.2.6] - 2026-10-19
+
+0.2.6 的重点是减少重复配置，并让模型候选与当前连接保持一致：复用 DSH 连接、可选功能自动池、按需目录同步和能力检测。旧名单、空配置及任务恢复边界保持。升级后需重载 DSH 服务端并刷新页面，见 [发布说明](docs/releases/0.2.6.md)。
+
+### Added
+
+- DSH供应商连接引用：工作台可选择已有连接，地址和API Key在操作时由宿主解析，避免重复保存密钥；协议、模型用途及功能策略仍需明确确认。支持公开API Key凭据来源，缺少宿主接口、OAuth或自定义认证时说明限制。见 [连接复用](docs/DSH_PROVIDER_CONNECTIONS.md)。
+- 六类功能可选择自动池、仅用所选模型或停用。自动池按稳定顺序使用已确认用途的合格模型，明确未受理时安全切换；显式指定只调用该项，未增加跨请求轮转。旧名单与缺失/空分配保持原行为。见 [功能模型池](docs/FUNCTION_MODEL_POOLS.md)。
+- 首次配置可在确认模型用途时同时启用所选功能的自动池，免去二次分配；工作台展示候选数和配置缺口。后续发现条目待确认，不静默扩池；配置与候选预览不发起生成。
+- 功能池切换采用页面内确认与逐项保存反馈；慢响应时防止重复提交，保存结果不明时可只读核对。识别尚未加载新策略的服务端并暂停切换，避免旧接口返回成功却未启用自动池。
+- 工作台新增“能力状态与检测”：六项能力卡、中文检测直达入口、只读配置检查与单模型实测详情；页面内确认、逐项进度、防重复提交和未知结果提示。视频、音乐、转写引导到真实任务，适配深浅主题及手机布局。见 [能力健康](docs/PROVIDER_HEALTH.md)。
+- 工作台统一分区卡片、标题、按钮及表单样式，收紧卡片留白和控件间距，保留手机点击尺寸。能力检测默认折叠保留摘要，功能池、创作工具、偏好、诊断和历史默认收起，入口显示“展开/收起”。检测跳转自动展开目标分区，折叠期间保留正在执行的请求和结果。
+- 模型目录采用完整快照，自动请求前按需刷新、成功缓存 10 分钟，失败保留旧目录。工作台新增默认折叠的同步摘要与变更信息；新增模型仍需确认用途，不删除旧模型。见 [目录与候选规则](docs/FUNCTION_MODEL_POOLS.md#目录更新与候选可用性)。
+
+### Fixed
+
+- 工作台折叠提示改为只渲染当前状态的一条文案，关闭显示“展开”、打开显示“收起”；重新加载客户端时原位更新旧样式，修复旧样式残留导致两个提示同时显示的问题。
+- TTS 不再把已知实时语音及尚未接入的语音系列当作普通 HTTP 模型检测或自动选用；缺少专用音色的复刻/设计模型跳过空样本检测，保留历史证据。`Model not exist` 提示具体模型、请求域名及地域/协议排查方向；不自动修改个人模型或重试。
+- 当前连接明确返回模型不存在后，按模型与能力隔离后续候选，保留历史成功和手工配置，支持单项实测恢复。CLI、DSH 与 Agent 共用判断；目录发现不再把视频混合音频或音频理解误判为独立 TTS/转写能力。
+
+### Security
+
+- 媒体 Provider Adapter 在错误截断前移除本次已知 API Key，覆盖无厂商前缀的密钥及错误码回显，避免进入公开错误与任务记录。
+- `sharp` 最低版本升至 `0.35.5` 并同步锁文件，处理预编译 librsvg 的高危公告 [GHSA-wq5f-xc86-pv6w](https://github.com/lovell/sharp/security/advisories/GHSA-wq5f-xc86-pv6w)。自定义系统库的部署仍需单独检查。
+
 ## [0.2.5] - 2026-10-16
 
 ### Changed
@@ -335,7 +360,8 @@ Iris 0.2.0 要求 Node.js ≥ 22.0.0，DSH 插件仅支持 `0.2.0-rc.2`；旧宿
 - 上传采用流式限额、临时 `.part` 文件和原子落盘，失败时会清理未完成文件。
 - 修改状态的路由拒绝明确的跨站请求，媒体文件继续使用随机能力令牌访问。
 
-[Unreleased]: https://github.com/mokuyoaxis/dsh-iris/compare/v0.2.5...HEAD
+[Unreleased]: https://github.com/mokuyoaxis/dsh-iris/compare/v0.2.6...HEAD
+[0.2.6]: https://github.com/mokuyoaxis/dsh-iris/compare/v0.2.5...v0.2.6
 [0.2.5]: https://github.com/mokuyoaxis/dsh-iris/compare/v0.2.4...v0.2.5
 [0.2.4]: https://github.com/mokuyoaxis/dsh-iris/compare/v0.2.3...v0.2.4
 [0.2.3]: https://github.com/mokuyoaxis/dsh-iris/compare/v0.2.2...v0.2.3

package/README.en.md

@@ -20,7 +20,11 @@
 
 dsh-iris gives agents, the Iris workbench and a standalone CLI image, video, music, speech and visual understanding capabilities. Each image model can use DashScope, OpenAI Images, chat image generation or Responses. Shared Core Artifacts connect generation, vision, OCR and chat editing. The DSH workbench provides configuration and task management, while the 🫧 bubble offers draft optimization in the composer.
 
-Music uses a Chat Completions interface with inline audio, explicit model assignment, configurable 502 retries, and playback/export. See [Music setup and usage](docs/MUSIC.md) (Chinese).
+Music uses a Chat Completions interface with inline audio, confirmed model uses and function policies, configurable 502 retries, and playback/export. See [Music setup and usage](docs/MUSIC.md) (Chinese).
+
+Iris 0.2.6 can [reference an existing DSH provider connection](docs/DSH_PROVIDER_CONNECTIONS.md) (Chinese), resolving its endpoint and API key per operation without storing a second key. It adds [automatic, selected-only, and disabled function pools](docs/FUNCTION_MODEL_POOLS.md) (Chinese): confirming a model's uses can enable automatic selection without a second assignment step. Discovery alone never expands the pool; existing lists and empty configurations retain their behavior. Selection uses stable priority with safe failover, without a round-robin cursor.
+
+Provider directories refresh on demand with a 10-minute successful cache. Confirmed model-not-found failures exclude that connection's model and capability from subsequent requests while preserving configured models and historical success. Directory details start collapsed; failed refreshes retain the last complete snapshot, and new models still require approval of their uses.
 
 ## A real generation example
 
@@ -46,22 +50,25 @@ These captures come from an Android browser connected to DSH under Termux/PRoot
 
 The project is at an early stage; interfaces and configuration formats may still change between releases.
 
-Iris 0.2.5 provides a DSH plugin and a headless CLI sharing tasks, artifacts and model routing. This release restores current Iris features on older DSH hosts; image import, native Qwen editing, music, three agent skills and synchronous delivery recovery remain available. Core internals have not been frozen as a public SDK.
+This documentation covers **Iris 0.2.6**. Pin the version when installing or upgrading, and check the host compatibility range below first.
+
+Iris 0.2.6 provides a DSH plugin and a headless CLI sharing tasks, artifacts and model routing. It adds connection reuse, optional automatic function pools, directory synchronization and capability checks. Image import, native Qwen editing, music, three agent skills and synchronous delivery recovery remain available. Core internals have not been frozen as a public SDK.
 
-> Version support: Iris 0.2.5 covers 12 exact DSH versions across the 0.1.2, 0.1.5, 0.1.7 and 0.2 lines; see the [compatibility matrix](docs/DSH_COMPATIBILITY.md). Node.js must be at least 22.0.0, including on older DSH hosts, and meet any higher host requirement.
+> Version support: Iris 0.2.6 retains the 12 exact DSH versions declared in 0.2.5; see the [compatibility matrix](docs/DSH_COMPATIBILITY.md). Node.js must be at least 22.0.0 and meet any higher host requirement. Connection reuse also requires the relevant public host services.
 
-## What's new in 0.2.5 and existing features
+## What's new in 0.2.6 and existing features
 
-**Keep current Iris features on older hosts.** Default vision uses host API capabilities to bind an exact model route; the verified host range grows from two to twelve exact versions.
+**Choose a connection, confirm model uses, then call a function.** Automatic pools use stable priority and safe failover, without cross-request round-robin.
 
 - **Persistent image import:** save an existing image through the workbench, agent, or CLI for later vision, editing, and export. The source file stays intact and no model is called.
 - **Native Qwen editing:** use supported DashScope Qwen image editing models as well as chat image models; edited images retain a link to their source.
-- **Explicit assignments:** image, video, TTS, music, transcription, and vision use only their assigned ordered lists. Explicit overrides must also be assigned.
+- **Connection reuse and function pools:** reference a DSH API-key connection, and choose automatic, selected-only or disabled mode for each function. Confirming uses can also enable its automatic pool.
+- **Directories and checks:** refresh directories before automatic requests and exclude confirmed missing models from later requests. Capability checks and advanced sections start collapsed; paid probes require separate confirmation.
 - **Older and transitional hosts:** the twelve exact versions in the matrix share current features and use the same manifest, client peer and Doctor compatibility boundary.
 
-**Check assignments before upgrading:** empty lists stop new calls instead of adding models from the pool. Existing tasks retain their original bindings. Add the DSH default model explicitly to vision when needed. See the [upgrade guide](docs/FUNCTION_MODEL_ASSIGNMENTS.md).
+**Upgrades preserve your allowed scope:** existing lists and missing or empty assignments do not become automatic. New directory entries still require confirmation of their uses; absence alone does not prove a model unavailable. Explicitly add host vision or enable it in the automatic vision pool. Existing tasks retain their bindings. See [function pools](docs/FUNCTION_MODEL_POOLS.md).
 
-See the [0.2.5 release notes](docs/releases/0.2.5.md) for host compatibility and validation limits, and the [CHANGELOG](CHANGELOG.md). Image import and assignments were added in [0.2.4](docs/releases/0.2.4.md); music and Skills are documented in [0.2.3](docs/releases/0.2.3.md).
+See the [0.2.6 release notes](docs/releases/0.2.6.md) for upgrade steps and validation limits, and the [CHANGELOG](CHANGELOG.md). Older-host support was restored in [0.2.5](docs/releases/0.2.5.md); image import arrived in [0.2.4](docs/releases/0.2.4.md), and music and Skills in [0.2.3](docs/releases/0.2.3.md).
 
 Future work includes additional protocol adapters and creative workflows; see the [roadmap](docs/ROADMAP.md#后续功能方向).
 
@@ -81,40 +88,40 @@ Both paths read and write the same Core Task/Artifact facts: point the CLI at th
 
 ## Optional legacy configuration import
 
-For a new installation, add providers in the Iris workbench. Iris uses its own configuration and does not scan other projects by default.
+For a new installation, add a provider or reference a DSH connection in the Iris workbench. Iris uses its own configuration and does not scan other projects by default.
 
 If you already have an ai-paint configuration, set `IRIS_IMPORT_WORKBENCH_CONFIG` to its absolute file path for a one-time provider import. Iris leaves the source untouched and does not keep configurations synchronized. The variable holds a file path, not an API key. See the [user guide](user_guide.md) for details.
 
 ## Quickest start
 
-Check the host with `dsh --version` and ensure `pnpm` is on your PATH. Iris and DSH have independent version numbers; Iris0.2.5 supports all twelve exact hosts listed in the [compatibility matrix](docs/DSH_COMPATIBILITY.md).
+Check the host with `dsh --version` and ensure `pnpm` is on your PATH. Iris and DSH have independent version numbers; Iris 0.2.6 retains the twelve exact hosts listed in the [compatibility matrix](docs/DSH_COMPATIBILITY.md).
 
 | Your DSH | Iris choice | Source |
 |---|---|---|
-| Exact 0.1.2 / 0.1.5 / 0.1.7 / 0.2 versions in the matrix | `0.2.5` | Pinned npm release |
+| Exact 0.1.2 / 0.1.5 / 0.1.7 / 0.2 versions in the matrix | `0.2.6` | Pinned npm version |
 | Versions outside the matrix | Not yet validated | Check the actual host interfaces |
 
-### DSH plugin: install 0.2.5
+### DSH plugin: install 0.2.6
 
 Install the pinned release into your Web profile:
 
 ```bash
-dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.2.5
+dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.2.6
 dsh web
 ```
 
 The plugin loads on the next DSH start. The web UI defaults to `http://127.0.0.1:3080`; open the complete URL if startup output includes authentication parameters. Reload the backend and refresh the web client after updating.
 
-### Standalone CLI: install 0.2.5
+### Standalone CLI: install 0.2.6
 
 Install in your own project without DSH:
 
 ```bash
-npm install @mokuyoaxis/dsh-iris@0.2.5
+npm install @mokuyoaxis/dsh-iris@0.2.6
 npx dsh-iris --help
 ```
 
-Download the package separately with `npm pack @mokuyoaxis/dsh-iris@0.2.5`. Users who need historical Iris0.1.4 can still pin it; see the matrix for its DSH/Node requirements. It lacks the current Core media CLI and later features.
+Download the package separately with `npm pack @mokuyoaxis/dsh-iris@0.2.6`. Users who need historical Iris0.1.4 can still pin it; see the matrix for its DSH/Node requirements. It lacks the current Core media CLI and later features.
 
 ### Choosing a version in dsh-market
 
@@ -122,7 +129,7 @@ The marketplace entry should resolve to the full package name `@mokuyoaxis/dsh-i
 
 > The unscoped `dsh-iris` on npm belongs to a different plugin. Always keep the fully scoped name `@mokuyoaxis/dsh-iris` when installing or updating Iris Media.
 
-After the first start, open "Settings → Iris workbench → + Add provider", enter your provider base URL and API key, discover models, label their capabilities, and assign them to each function. Version 0.2.4 uses explicit ordered lists for all functions; see [assignment rules and upgrade impact](docs/FUNCTION_MODEL_ASSIGNMENTS.md) (Chinese). Full steps and protocol selection are in the [user guide](user_guide.md) (Chinese).
+After the first start, open "Settings → Iris workbench → + Add provider", reference a DSH connection or enter your endpoint and key, and choose the media protocol. Synchronize the directory and confirm model uses; first-time setup can enable automatic selection in the same step. Selected-only mode still requires a list. See [function pools](docs/FUNCTION_MODEL_POOLS.md) and the [user guide](user_guide.md) (Chinese).
 
 Once configured, minimal instructions can be as simple as:
 
@@ -161,7 +168,7 @@ After installing the plugin, add a provider in the Iris workbench and assign mod
 
 ## DeepSeek Harness adaptation
 
-dsh-iris remains a native DSH plugin. Iris 0.2.5 registers 17 agent tools, including import, editing, and music, and uses host routing, attachments, models, and lifecycle services. The web client contributes settings, composer, and global-overlay UI. Iris does not start another service or listen on an extra port.
+dsh-iris remains a native DSH plugin. Iris 0.2.6 registers 17 agent tools, including import, editing, and music, and uses host routing, attachments, models, and lifecycle services. The web client contributes settings, composer, and global-overlay UI. Iris does not start another service or listen on an extra port.
 
 Save an uploaded or local image as a persistent Artifact for viewing, editing and export; see [image import](docs/IMAGE_IMPORT.md) (Chinese).
 
@@ -174,6 +181,7 @@ Save an uploaded or local image as a persistent Artifact for viewing, editing an
 | `0.2.3` | Only `0.2.0-rc.2` | Adds music and a third skill; check actual loading with Host Doctor after upgrading |
 | `0.2.4` | `0.2.0-rc.2` or `0.2.1-alpha.4` | 17 tools / 3 skills; actual SDK, loader, and client slot isolation checks; full browser and hot reload checks remain separate |
 | `0.2.5` | 12 exact versions across the 0.1.2 / 0.1.5 / 0.1.7 / 0.2 lines; see the matrix | Official SDK isolation checks including Music and Qwen dispatch; old profiles also load the actual installed package |
+| `0.2.6` | Retains the 12 exact versions declared in 0.2.5 | Adds connection reuse, function pools and directories; connection reuse requires public host services; see this version's release notes |
 
 See the [compatibility matrix](docs/DSH_COMPATIBILITY.md) for the current scope and [rc.2 adaptation notes](docs/DSH_RC2_ADAPTATION.md) for historical changes. npm 0.1.4 does not contain these later adaptations.
 
@@ -270,7 +278,7 @@ npx @mokuyoaxis/dsh-iris doctor --json
 
 The installed binary is `dsh-iris`. Exit code `0` is healthy, `1` means warnings, and `2` means hard errors. Offline Doctor checks Node.js, sharp, ffmpeg/ffprobe, a real but cleaned-up storage write probe, configuration, models/assignments, task semantics, temporary files, and orphaned or missing artifacts.
 
-A running DSH instance also provides a “Host diagnostics” card and authenticated `/iris/api/doctor` JSON. It checks the host version, plugin, 17 tools and three skills, four route groups, host capabilities, client version, and four UI slots. It reads safe registration evidence without calling Browser, models, or providers. See [Host Doctor](docs/HOST_DOCTOR.md).
+A running DSH instance also provides a “Host diagnostics” card and `/iris/api/doctor` JSON protected by Iris's Host and browser-origin guards. These guards do not authenticate users. Doctor checks the host version, plugin, 17 tools and three skills, four route groups, host capabilities, client version, and four UI slots. It reads safe registration evidence without calling Browser, models, or providers. See [Host Doctor](docs/HOST_DOCTOR.md).
 
 ## Composed workflow example
 

package/README.md

@@ -44,22 +44,25 @@ dsh-iris 为 Agent、Iris 工作台和独立 CLI 提供图像、视频、音乐
 
 项目目前处于早期版本，接口和配置格式仍可能随版本迭代调整。
 
-Iris 0.2.5 同时提供 DSH 插件与无 DSH 的 CLI，共用任务、产物和模型路由。新版恢复旧DSH的当前功能支持；图片导入、原生Qwen改图、音乐、三项Agent Skills和同步媒体交付恢复继续可用。Core内部接口尚未冻结为公共SDK。
+当前文档对应 **Iris 0.2.6**。安装与升级请固定版本，并先核对下方的宿主兼容范围。
 
-> 版本支持：Iris0.2.5覆盖DSH 0.1.2、0.1.5、0.1.7及0.2线中的12个准确版本，见 [兼容矩阵](docs/DSH_COMPATIBILITY.md)。保留旧DSH时仍需Node.js ≥22.0.0，宿主若要求更高，以宿主为准。
+Iris 0.2.6 同时提供 DSH 插件与无 DSH 的 CLI，共用任务、产物和模型路由。新增连接复用、可选功能自动池、目录同步和能力检测；图片导入、原生 Qwen 改图、音乐、三项 Agent Skills 和同步交付恢复继续可用。Core 内部接口尚未冻结为公共 SDK。
 
-## 0.2.5 更新重点与现有能力
+> 版本支持：Iris 0.2.6 沿用 0.2.5 的 12 个准确 DSH 版本，见 [兼容矩阵](docs/DSH_COMPATIBILITY.md)。保留旧 DSH 时仍需 Node.js ≥22.0.0，宿主若要求更高，以宿主为准。连接复用另需宿主提供对应公开接口。
 
-**旧宿主继续使用当前Iris功能**。默认视觉按接口能力选择精确路由，支持范围从2个准确DSH版本扩大至12个。
+## 0.2.6 更新重点与现有能力
+
+**选一次连接、确认模型用途，再按功能调用。** 自动池采用稳定顺序和安全切换，没有跨请求轮转。
 
 - **图片导入**：通过工作台、Agent或CLI把已有图片保存为持久作品，继续看图、改图和导出；保留源文件，不调用模型。
 - **原生 Qwen 改图**：除聊天生图外，支持DashScope Qwen带图编辑，修改版另存为关联原图的新作品。
-- **统一功能分配**：生图、视频、TTS、Music、转写和视觉只使用各自明确分配的有序名单；临时指定也须已分配。
+- **连接复用与功能池**：可引用 DSH 已有 API Key 连接；六类功能可选自动池、仅用所选模型或停用，确认用途时可同时启用自动池。
+- **目录与检测**：自动请求前按需同步目录，明确模型不存在后隔离后续候选；能力检测、目录及高级分区默认折叠，实测单独确认费用。
 - **旧宿主与过渡版本**：兼容矩阵中的12个准确版本共用当前功能，manifest、客户端peer和Doctor使用相同范围。
 
-**升级前请检查功能分配**：空名单会停止新调用，不再自动补入模型池；已有任务仍可按原绑定查询和恢复。DSH默认视觉须明确加入视觉名单。详见 [升级说明](docs/FUNCTION_MODEL_ASSIGNMENTS.md)。
+**升级保持已有调用范围**：旧名单和缺失/空分配不会自动启用；需主动选择自动池。新发现模型仍要确认用途，目录未列出不等于下线。DSH 默认视觉需明确加入名单或开启自动池的宿主视觉选项；已有任务按原绑定恢复。详见 [功能模型池](docs/FUNCTION_MODEL_POOLS.md)。
 
-兼容修正与验证边界见 [0.2.5发布说明](docs/releases/0.2.5.md) 和 [CHANGELOG](CHANGELOG.md)。图片续作与统一分配见 [0.2.4](docs/releases/0.2.4.md)，音乐与Skills见 [0.2.3](docs/releases/0.2.3.md)。
+升级与验证边界见 [0.2.6 发布说明](docs/releases/0.2.6.md) 和 [CHANGELOG](CHANGELOG.md)。旧宿主支持见 [0.2.5](docs/releases/0.2.5.md)，图片续作见 [0.2.4](docs/releases/0.2.4.md)，音乐与 Skills 见 [0.2.3](docs/releases/0.2.3.md)。
 
 音乐的接口格式、模型分配与使用示例见 [Music](docs/MUSIC.md)。其他协议与后续能力见 [路线图](docs/ROADMAP.md#后续功能方向)。
 
@@ -79,40 +82,46 @@ Iris 0.2.5 同时提供 DSH 插件与无 DSH 的 CLI，共用任务、产物和
 
 ## 可选的旧配置导入
 
-首次使用时，直接在 Iris 工作台添加供应商。Iris 使用自己的配置，不会默认扫描其他项目。
+首次使用时，在 Iris 工作台添加供应商或引用 DSH 已有连接。Iris 使用自己的配置，不会默认扫描其他项目。
+
+[引用 DSH 已有连接](docs/DSH_PROVIDER_CONNECTIONS.md)只保存连接标识，在操作时读取宿主管理的地址和密钥；无可复用连接时可手动填写供应商信息。
+
+[功能自动池、手选与停用](docs/FUNCTION_MODEL_POOLS.md)：确认模型用途时可直接启用自动池，免去再次逐项分配。旧名单和空分配保持原行为。
+
+自动池按需同步模型目录（成功缓存 10 分钟），并隔离当前连接已明确返回“模型不存在”的条目。供应商详情默认折叠展示同步结果；失败保留旧目录，新增条目仍待确认用途，手工配置与历史成功保留。
 
 已有旧 ai-paint 配置时，可通过 `IRIS_IMPORT_WORKBENCH_CONFIG` 显式指定来源文件的绝对路径，一次性导入供应商；不修改来源文件、不持续同步。该变量保存文件路径，不包含 API Key。具体操作见[用户指南](user_guide.md#从旧工作台显式导入)。
 
 ## 最快开始
 
-先用 `dsh --version` 核对宿主版本，并确认 `pnpm` 在PATH中。Iris与DSH的版本号独立；在 [兼容矩阵](docs/DSH_COMPATIBILITY.md) 列出的12个准确版本中均可安装Iris0.2.5。
+先用 `dsh --version` 核对宿主版本，并确认 `pnpm` 在 PATH 中。Iris 与 DSH 的版本号独立；0.2.6 沿用 [兼容矩阵](docs/DSH_COMPATIBILITY.md) 列出的 12 个准确版本。
 
 | 你的 DSH | Iris 选择 | 安装来源 |
 |---|---|---|
-| 矩阵中的0.1.2/0.1.5/0.1.7/0.2线准确版本 | `0.2.5` | 固定npm版本 |
+| 矩阵中的0.1.2/0.1.5/0.1.7/0.2线准确版本 | `0.2.6` | 固定 npm 版本 |
 | 未列入矩阵的版本 | 尚未验收 | 按实际宿主接口另行检查 |
 
-### DSH插件：安装0.2.5
+### DSH插件：安装0.2.6
 
 安装固定版本到 Web profile：
 
 ```bash
-dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.2.5
+dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.2.6
 dsh web
 ```
 
 插件在下一次 DSH 启动时装载。Web UI 默认位于 `http://127.0.0.1:3080`；启动输出带认证参数时请打开完整 URL。更新后需重新加载后端并刷新客户端。
 
-### 独立CLI：安装0.2.5
+### 独立CLI：安装0.2.6
 
 在自己的项目中安装，无需 DSH：
 
 ```bash
-npm install @mokuyoaxis/dsh-iris@0.2.5
+npm install @mokuyoaxis/dsh-iris@0.2.6
 npx dsh-iris --help
 ```
 
-需要单独下载时运行`npm pack @mokuyoaxis/dsh-iris@0.2.5`。仍需保留历史Iris0.1.4时可以固定其版本；历史DSH/Node范围见兼容矩阵，0.1.4不包含当前Core媒体CLI及后续新功能。
+需要单独下载时运行`npm pack @mokuyoaxis/dsh-iris@0.2.6`。仍需保留历史Iris0.1.4时可以固定其版本；历史DSH/Node范围见兼容矩阵，0.1.4不包含当前Core媒体CLI及后续新功能。
 
 ### dsh-market 安装时的版本选择
 
@@ -120,7 +129,7 @@ npx dsh-iris --help
 
 > npm 上无 scope 的 `dsh-iris` 属于另一款插件。安装和更新 Iris Media 时必须保留完整包名 `@mokuyoaxis/dsh-iris`。
 
-首次启动后，打开“设置 → Iris 工作台 → + 添加供应商”，填入供应商Base URL和API Key，再点“发现模型”，标注能力并为所需功能分配模型。0.2.4统一严格名单，升级差异见 [功能模型分配](docs/FUNCTION_MODEL_ASSIGNMENTS.md)；完整步骤和协议选择见 [用户指南](user_guide.md)。
+首次启动后，打开“设置 → Iris 工作台 → + 添加供应商”，引用 DSH 连接或手动填写地址与密钥，明确媒体协议，再同步目录并确认模型用途。首次配置可同时启用所选功能的自动池；保留手选模式时需选择模型。完整步骤见 [用户指南](user_guide.md) 和 [功能模型池](docs/FUNCTION_MODEL_POOLS.md)。
 
 配置完成后，最小指令可以是：
 
@@ -160,7 +169,7 @@ DSH 的 profile 与插件命令由[官方安装说明](https://github.com/deepse
 
 ## DeepSeek Harness 适配
 
-dsh-iris仍按DSH原生插件装载。0.2.5服务端注册17个Agent工具，包含图片导入、改图与音乐；使用宿主提供的路由、附件、模型和生命周期能力。Web客户端接入设置页、会话输入区与全局悬浮层，不启动额外服务或监听端口。
+dsh-iris仍按DSH原生插件装载。0.2.6服务端注册17个Agent工具，包含图片导入、改图与音乐；使用宿主提供的路由、附件、模型和生命周期能力。Web客户端接入设置页、会话输入区与全局悬浮层，不启动额外服务或监听端口。
 
 上传图片或本地图片可保存为持久作品，继续看图、改图及导出，见 [图片导入](docs/IMAGE_IMPORT.md)。
 
@@ -173,6 +182,7 @@ dsh-iris仍按DSH原生插件装载。0.2.5服务端注册17个Agent工具，包
 | `0.2.3` | 仅 `0.2.0-rc.2` | 增加音乐工具和第三项 Skill；升级后用宿主诊断检查实际装载 |
 | `0.2.4` | `0.2.0-rc.2` 或 `0.2.1-alpha.4` | 17工具/3项Skill；两版实际SDK、加载器与界面插槽隔离验收，完整浏览器/热更新另验 |
 | `0.2.5` | 0.1.2/0.1.5/0.1.7/0.2线的12个准确版本，见兼容矩阵 | 每版官方SDK隔离检查，包含Music与Qwen工具链；旧profile另通过实际安装包装载 |
+| `0.2.6` | 沿用0.2.5的12个准确版本 | 新增连接复用、功能池与目录；连接引用按宿主公开服务检测，具体边界见本版发布说明 |
 
 当前声明与验收范围见 [版本兼容](docs/DSH_COMPATIBILITY.md)，早期rc.2修正见 [历史适配记录](docs/DSH_RC2_ADAPTATION.md)；npm0.1.4不包含这些后续适配。
 
@@ -269,7 +279,7 @@ npx @mokuyoaxis/dsh-iris doctor --json
 
 安装后的二进制名是 `dsh-iris`。退出码 `0` 表示正常、`1` 表示有警告、`2` 表示有硬错误。离线 Doctor 检查 Node、sharp、ffmpeg/ffprobe、数据目录真实写入、配置、模型/分配、任务语义、临时文件和孤儿/缺失产物。
 
-运行中的DSH另在Iris工作台提供“宿主诊断”卡片及已认证的 `/iris/api/doctor` JSON，检查宿主版本、插件、17工具/3项Skill、四组路由、宿主能力、客户端版本和四个UI Slot。它只读取安全快照与注册证据，不调用Browser、模型或Provider，详见 [Host Doctor](docs/HOST_DOCTOR.md)。
+运行中的 DSH 另在 Iris 工作台提供“宿主诊断”卡片及受 Host/浏览器来源守卫保护的 `/iris/api/doctor` JSON，检查宿主版本、插件、17 工具/3 项 Skill、四组路由、宿主能力、客户端版本和四个 UI Slot。该守卫不提供身份认证。诊断只读取安全快照与注册证据，不调用 Browser、模型或 Provider，详见 [Host Doctor](docs/HOST_DOCTOR.md)。
 
 ## 组合工作流示例
 

package/bin/dsh-iris.js

@@ -7,7 +7,7 @@ import { recoverCoreWriterLease } from '../lib/core-lease-recovery.js';
 import { doctor, formatDoctorReport } from '../lib/doctor.js';
 import { loadProviderCatalog, providerCatalogSnapshot, catalogCapabilitySnapshot, imageCandidatesFromCatalog, musicCandidatesFromCatalog, providerForTaskFromCatalog, providerTaskBinding, transcribeCandidatesFromCatalog, ttsCandidatesFromCatalog, videoCandidatesFromCatalog } from '../lib/provider-catalog.js';
 import { createConfiguredProviderAdapter } from '../lib/provider-adapters.js';
-import { providerForImageModel } from '../lib/provider-protocol.js';
+import { providerForImageModel, selectMediaProtocol, dashscopeTtsInputIssue } from '../lib/provider-protocol.js';
 import { prepareProviderInput } from '../lib/provider-adapter.js';
 import { createProviderTaskRunner } from '../lib/provider-task-runner.js';
 import { generateMusicTask } from '../lib/music-generation.js';
@@ -15,7 +15,7 @@ import { GenerationInputError, normalizeGenerationInput } from '../lib/generatio
 import { executeVisionCommand, normalizeVisionInput } from '../lib/headless-vision.js';
 import { videoTaskCandidates } from '../lib/video-input.js';
 import { createChromiumBrowser } from '../lib/chromium-browser.js';
-import { executeConfigCommand, recordCatalogRateLimit } from '../lib/provider-config-service.js';
+import { executeConfigCommand, recordCatalogRateLimit, recordCatalogAvailability, refreshCatalogDirectories } from '../lib/provider-config-service.js';
 import { probeVisionModel } from '../lib/vision-model-routing.js';
 import { RED_TEST_IMAGE } from '../lib/vision.js';
 import { parseModelRef, modelRef as qualifiedModelRef } from '../lib/models.js';
@@ -24,10 +24,18 @@ import { coreTaskWaitFinished } from '../lib/task-wait.js';
 function trackedProviderAdapter(provider, options, task) {
   return createConfiguredProviderAdapter(provider, {
     modelId: parseModelRef(task?.modelRef)?.modelId,
+    onModelAvailability: event => recordCatalogAvailability(options['provider-config'], event),
     onRateLimit: event => recordCatalogRateLimit(options['provider-config'], event)
   });
 }
 
+async function generationCatalog(options, capability, modelRef) {
+  const file = required(options['provider-config'], 'provider-config');
+  const catalog = loadProviderCatalog(file);
+  if (!modelRef) await refreshCatalogDirectories(file, catalog, capability, { signal: cliAbortController.signal });
+  return catalog;
+}
+
 class CliUsageError extends Error {
   constructor(message) {
     super(message);
@@ -258,6 +266,10 @@ async function main(args) {
         if (['video-gen', 'transcribe'].includes(capability) && !options.input) return {
           skipped: true, ok: false, reason: '请用 models test --input 提供与 run video/transcribe 相同的真实素材；未发起请求'
         };
+        if (capability === 'tts' && selectMediaProtocol(provider).mediaProtocol === 'dashscope') {
+          const issue = dashscopeTtsInputIssue(modelId, probeInput.voice || provider.ttsVoice);
+          if (issue) return { skipped: true, ok: false, reason: issue };
+        }
         return withRawRuntime('writer', options['data-root'], async runtime => {
           const mediaCapability = capability === 'image-gen' ? 'image' : capability === 'video-gen' ? 'video' : capability;
           if (mediaCapability === 'image') provider = providerForImageModel(provider, modelId);
@@ -266,7 +278,7 @@ async function main(args) {
             ? { prompt: 'red circle', n: 1, ...(['openai-chat-images', 'openai-responses-images'].includes(adapter.protocol) ? {} : {
               size: adapter.protocol === 'openai-images' ? '256x256' : '512*512'
             }) }
-            : { text: '你好', voice: provider.ttsVoice || 'Cherry' };
+            : { text: '你好', voice: probeInput.voice || provider.ttsVoice || 'Cherry' };
           let candidates = [{ adapter, model: qualifiedModelRef(provider.id, modelId), selectionReason: 'explicit', providerBinding: providerTaskBinding(provider) }];
           if (['video', 'transcribe'].includes(mediaCapability)) {
             const normalized = generationInput(mediaCapability, { ...probeInput, model_ref: qualifiedModelRef(provider.id, modelId) },
@@ -284,7 +296,7 @@ async function main(args) {
             task_id: submitted.task.id, timeout_ms: 60000, poll_interval_ms: 1000 });
           const task = waited.task;
           return { ok: task.outcome === 'succeeded' && task.deliveryState === 'ready', taskId: task.id,
-            category: task.lastError?.category, httpStatus: task.lastError?.httpStatus };
+            category: task.lastError?.category, httpStatus: task.lastError?.httpStatus, providerCode: task.lastError?.providerCode };
         });
       }
     });
@@ -307,9 +319,11 @@ async function main(args) {
         fs.accessSync(path.dirname(file), fs.constants.W_OK);
       } catch (_) { throw new CliUsageError('输出文件已存在或父目录不可写'); }
     }
-    const catalog = loadProviderCatalog(required(options['provider-config'], 'provider-config'));
+    const catalog = await generationCatalog(options, 'vision', options['model-ref'] || input.model_ref);
+    if (input.transcribe && !input.transcribe_model_ref) await refreshCatalogDirectories(options['provider-config'], catalog, 'transcribe', { signal: cliAbortController.signal });
     const execute = runtime => executeVisionCommand({ command, input, catalog, runtime,
       onRateLimit: event => recordCatalogRateLimit(options['provider-config'], event),
+      onModelAvailability: event => recordCatalogAvailability(options['provider-config'], event),
       modelRef: options['model-ref'] || '', signal: cliAbortController.signal,
       ...(options['timeout-ms'] !== undefined ? { timeoutMs: Number(options['timeout-ms']) } : {}) });
     const completed = input.transcribe
@@ -362,7 +376,7 @@ async function main(args) {
   if (args[0] === 'run' && args[1] === 'image') {
     const options = flags(args.slice(2), ['data-root', 'provider-config', 'input']);
     const { providerInput, modelRef, sourceArtifactId } = generationInput('image', jsonInput(options.input));
-    const catalog = loadProviderCatalog(required(options['provider-config'], 'provider-config'));
+    const catalog = await generationCatalog(options, 'image-gen', modelRef);
     const routes = imageCandidatesFromCatalog(catalog, modelRef);
     await withRawRuntime('writer', options['data-root'], async (runtime) => {
       const candidates = routes.map((route) => ({
@@ -384,7 +398,7 @@ async function main(args) {
     const options = flags(args.slice(2), ['data-root', 'provider-config', 'input']);
     const normalized = generationInput('video', jsonInput(options.input), { allowVideoPaths: true });
     const { providerInput, modelRef } = normalized;
-    const catalog = loadProviderCatalog(required(options['provider-config'], 'provider-config'));
+    const catalog = await generationCatalog(options, 'video-gen', modelRef);
     const routes = videoCandidatesFromCatalog(catalog, modelRef);
     await withRawRuntime('writer', options['data-root'], async (runtime) => {
       const candidates = videoTaskCandidates(routes.map((route) => ({
@@ -405,7 +419,7 @@ async function main(args) {
   if (args[0] === 'run' && args[1] === 'music') {
     const options = flags(args.slice(2), ['data-root', 'provider-config', 'input']);
     const normalized = generationInput('music', jsonInput(options.input));
-    const catalog = loadProviderCatalog(required(options['provider-config'], 'provider-config'));
+    const catalog = await generationCatalog(options, 'music-gen', normalized.modelRef);
     const routes = musicCandidatesFromCatalog(catalog, normalized.modelRef);
     let result;
     await withRawRuntime('writer', options['data-root'], async runtime => {
@@ -421,7 +435,7 @@ async function main(args) {
   if (args[0] === 'run' && args[1] === 'tts') {
     const options = flags(args.slice(2), ['data-root', 'provider-config', 'input']);
     const { providerInput, modelRef } = generationInput('tts', jsonInput(options.input));
-    const catalog = loadProviderCatalog(required(options['provider-config'], 'provider-config'));
+    const catalog = await generationCatalog(options, 'tts', modelRef);
     const routes = ttsCandidatesFromCatalog(catalog, modelRef);
     await withRawRuntime('writer', options['data-root'], async (runtime) => {
       const candidates = routes.map((route) => ({
@@ -443,7 +457,7 @@ async function main(args) {
   if (args[0] === 'run' && args[1] === 'transcribe') {
     const options = flags(args.slice(2), ['data-root', 'provider-config', 'input']);
     const normalized = generationInput('transcribe', jsonInput(options.input), { allowAudioPath: true });
-    const catalog = loadProviderCatalog(required(options['provider-config'], 'provider-config'));
+    const catalog = await generationCatalog(options, 'transcribe', normalized.modelRef);
     const routes = transcribeCandidatesFromCatalog(catalog, normalized.modelRef);
     let providerInput = normalized.providerInput;
     if (normalized.audioPath) {
@@ -528,7 +542,9 @@ async function main(args) {
       model_ref: options['model-ref'],
       confirm_billing: confirmBilling
     }), {
-      resolveTaskCandidates: ({ capability, modelRef }) => (capability === 'video'
+      resolveTaskCandidates: async ({ capability, modelRef }) => {
+        const catalog = await generationCatalog(options, { image: 'image-gen', video: 'video-gen', music: 'music-gen' }[capability] || capability, modelRef);
+        return (capability === 'video'
         ? videoCandidatesFromCatalog(catalog, modelRef || undefined)
         : capability === 'tts'
           ? ttsCandidatesFromCatalog(catalog, modelRef || undefined)
@@ -542,7 +558,8 @@ async function main(args) {
         model: route.modelRef,
         selectionReason: route.selectionReason,
         providerBinding: providerTaskBinding(route.provider)
-      }))
+      }));
+      }
     });
     console.log(JSON.stringify(result, null, 2));
     return 0;

package/docs/AGENT_QUICKSTART.md

@@ -2,17 +2,17 @@
 
 把下面一段交给负责安装或使用 Iris 的 Agent。版本与发布状态以当前 [README](../README.md) 为准；Iris 和 DSH 的版本号独立。
 
-下列npm示例对应Iris0.2.5，支持旧宿主的当前功能，准确范围见 [兼容矩阵](DSH_COMPATIBILITY.md)。执行安装命令前先核对发布状态，再确认所选发行包的实际版本、工具和功能分配。
+下列 npm 示例对应 Iris 0.2.6，准确范围见 [兼容矩阵](DSH_COMPATIBILITY.md)。执行安装命令前确认所选发行包的实际版本、工具和功能策略。
 
 ## 中文
 
 ```text
 请根据本仓库 README，帮我安装并使用 Iris（@mokuyoaxis/dsh-iris）。
 先确认运行环境、目标 DSH profile，并用 dsh --version 核对宿主；Iris 0.2.x 要求 Node.js >=22.0.0（旧 npm 0.1.4 的历史要求为 >=20.10.0）：
-- DSH在docs/DSH_COMPATIBILITY.md列出的12个准确版本中：固定安装 dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.2.5；只下载用 npm pack @mokuyoaxis/dsh-iris@0.2.5。
+- DSH在docs/DSH_COMPATIBILITY.md列出的12个准确版本中：固定安装 dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.2.6；只下载用 npm pack @mokuyoaxis/dsh-iris@0.2.6。
 - 未列入所选Iris版本兼容矩阵的DSH：先报告没有支持声明，不自行升级宿主或跳过版本检查。
-没有DSH、希望用CLI时，按docs/HEADLESS_CLI.md使用npm0.2.5；npm0.1.4不含当前Core媒体CLI。
-先用--help和Doctor核对实际版本与命令。六类模型功能都需明确分配，空名单停止新调用；DSH默认视觉也须明确加入。图片导入用iris_import_image，改图用iris_edit_image；音乐用iris_generate_music并配置Chat Completions（内嵌音频）协议，见docs/MUSIC.md。
+没有DSH、希望用CLI时，按docs/HEADLESS_CLI.md使用npm0.2.6；npm0.1.4不含当前Core媒体CLI。
+先用--help和Doctor核对实际版本与命令。可引用DSH已有API Key连接，再确认模型用途并主动启用自动池，或保留手选名单；旧空配置不自动启用。DSH默认视觉须明确加入或启用。目录新增模型仍需确认用途；不以实测请求探测配置。图片导入用iris_import_image，改图用iris_edit_image；音乐用iris_generate_music并配置Chat Completions（内嵌音频）协议，见docs/MUSIC.md。
 从dsh-market安装也要核对实际包名、版本和兼容范围；缓存的旧版安装信息仍按其历史矩阵判断。
 若使用其他 profile，把示例中的 web 换成已确认的目标。保留完整 scoped 包名，不把 dsh-iris 当作同一 npm 包。
 安装后检查 Doctor 和工具可达性，再执行我指定的媒体任务；不要输出 API Key，重启宿主前说明影响。
@@ -25,10 +25,10 @@
 ```text
 Help me install and use Iris (@mokuyoaxis/dsh-iris) according to this repository's README.
 Check the environment, target DSH profile, and dsh --version first; Iris 0.2.x requires Node.js >=22.0.0 (the published npm 0.1.4 historically requires >=20.10.0):
-- For one of the twelve exact DSH versions in docs/DSH_COMPATIBILITY.md, pin dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.2.5; download only with npm pack @mokuyoaxis/dsh-iris@0.2.5.
+- For one of the twelve exact DSH versions in docs/DSH_COMPATIBILITY.md, pin dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.2.6; download only with npm pack @mokuyoaxis/dsh-iris@0.2.6.
 - DSH versions outside the selected Iris version's matrix: report the missing support claim; do not upgrade the host or bypass its version checks automatically.
-For CLI use without DSH, follow docs/HEADLESS_CLI.md using npm0.2.5; npm0.1.4 lacks the current Core media CLI. Check the README publication status first.
-Check --help, Doctor and the actual installed version. All six model functions require explicit assignments; empty lists stop new calls. Add DSH default vision explicitly when needed. Use iris_import_image for import, iris_edit_image for editing, and iris_generate_music with its configured inline-audio protocol for music.
+For CLI use without DSH, follow docs/HEADLESS_CLI.md using npm0.2.6; npm0.1.4 lacks the current Core media CLI.
+Check --help, Doctor and the actual installed version. Reference a DSH API-key connection when available, confirm model uses, and explicitly enable automatic pools or retain selected-only lists. Existing empty configurations stay inactive. Host vision and new directory models require explicit authorization. Do not probe paid models to check configuration. Use iris_import_image for import, iris_edit_image for editing, and iris_generate_music with its configured inline-audio protocol for music.
 For dsh-market, check the actual package name, version, and compatibility range too. Cached older releases retain their historical compatibility matrices.
 Replace web with the confirmed profile when needed. Keep the scoped package name; unscoped dsh-iris is a different npm package.
 Check Doctor and tool availability after installation, then carry out my requested media task. Do not expose API keys; explain the impact before restarting the host.

package/docs/CLI_MANAGEMENT.md

@@ -1,11 +1,13 @@
 # CLI 配置与任务管理
 
-本文面向 Iris 0.2.2，沿用 `dsh-iris` 入口，无需启动 DSH，未新增生产依赖。安装 `npm install @mokuyoaxis/dsh-iris@0.2.2` 后运行 `npx dsh-iris ...`；也可从源码或本地 tarball 使用同一入口。视觉命令见 [视觉 CLI](VISION_CLI.md)，基础媒体链路见 [Headless CLI](HEADLESS_CLI.md)。
+本文面向 Iris 0.2.6，沿用 `dsh-iris` 入口，无需启动 DSH。安装 `npm install @mokuyoaxis/dsh-iris@0.2.6` 后运行 `npx dsh-iris ...`；也可从源码或本地 tarball 使用同一入口。发布状态见 [README](../README.md)；视觉命令见 [视觉 CLI](VISION_CLI.md)，基础媒体链路见 [Headless CLI](HEADLESS_CLI.md)。
 
 所有需要 JSON 的命令均支持 `--input '<json>'`、`--input-file /path/input.json` 或 `--input -`（stdin），只能选择一种，输入最多 2 MiB。私有配置必须是普通文件、绝对路径，POSIX 权限为 `0600`。真实请求只由显式执行生成、发现、实测或观察命令触发。
 
 能力配置规则已同步Iris 0.2.2：能力来自明确配置或供应商元数据，裸账号和模型名称不自动赋能。现有功能入口、按功能分配的有序候选池和安全切换规则保持。
 
+0.2.6 的自动池会在新请求前按需读取目录（成功缓存 10 分钟），并跳过当前连接已明确返回模型不存在的候选。`models list`、`capabilities list`、配置检查和旧任务观察保持只读；`models discover --apply true` 显式更新目录并保留原模型，新发现用途仍需确认。手选、停用、显式单模型请求不暗中同步或扩池。`task retry` 先通过计费确认再刷新自动候选，旧任务不变；详见 [功能模型池](FUNCTION_MODEL_POOLS.md)。
+
 ## S2V 数字人视频
 
 ```bash
@@ -36,6 +38,8 @@ dsh-iris media html --data-root /path/core --input-file /path/html-input.json \
 
 0.2.4的六类功能均需明确分配；`assignments clear`停止新调用，已有Task仍按原绑定观察和补交付。临时指定须在名单内。旧自动池升级及DSH宿主资源见 [功能模型分配](FUNCTION_MODEL_ASSIGNMENTS.md)。
 
+0.2.6 支持 [三种功能池策略](FUNCTION_MODEL_POOLS.md)：现有 `assignments set` 的 JSON 可传 `mode`，`models add/caps` 可传 `enableAutomatic:true`。旧参数和已有分配行为保留；省略新字段不会自动改策略。
+
 | 命令 | 行为 |
 | --- | --- |
 | `config init/show/check` | 创建空私有配置（不覆盖）、脱敏查看、检查重复账号和失效分配 |

package/docs/DSH_COMPATIBILITY.md

@@ -2,7 +2,11 @@
 
 Iris与DSH的版本号独立。安装前运行 `dsh --version`，并核对要安装的Iris版本；发布状态见 [README](../README.md)。
 
-## Iris 0.2.5
+## Iris 0.2.6
+
+0.2.6 沿用 0.2.5 的以下 12 个准确版本声明，不因连接复用扩大宿主支持范围。连接引用另需供应商目录、脱敏设置及凭据公开服务；缺少接口时使用手动供应商。首次配置与升级规则见 [功能模型池](FUNCTION_MODEL_POOLS.md)。
+
+## 0.2.5 建立的兼容范围
 
 0.2.5恢复旧宿主支持，并覆盖以下12个准确版本。旧宿主使用同一套 Iris Core、Music、图片导入和原生 Qwen 改图功能，无需维护旧版功能分支。
 
@@ -30,15 +34,15 @@ Iris与DSH的版本号独立。安装前运行 `dsh --version`，并核对要安
 
 ## 安装与升级
 
-在上述12个准确版本的宿主中固定安装0.2.5：
+在上述 12 个准确版本的宿主中，固定安装 Iris 0.2.6：
 
 ```bash
-dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.2.5
+dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.2.6
 ```
 
 使用其他profile时替换 `web`。更新后检查服务端装载、刷新Web客户端，并查看Iris工作台的 [宿主诊断](HOST_DOCTOR.md)。alpha.3及之后的DSH改善了插件更新与热加载，但仍以实际装载结果为准。
 
-0.2.4起统一六类功能的明确模型名单。已有分配保持；以前依赖自动模型池的功能需要在升级后明确分配，见 [升级说明](FUNCTION_MODEL_ASSIGNMENTS.md)。本次宿主适配不迁移旧作品、任务或个人配置；从Iris0.1.4整体升级的旧数据流程仍需单独验收。
+0.2.4/0.2.5 统一六类功能的明确模型名单；0.2.6 可主动启用自动池，旧名单和空配置不自动改变，见 [功能池及升级说明](FUNCTION_MODEL_POOLS.md)。从 Iris 0.1.4 整体升级的旧数据流程仍需单独验收。
 
 ## 兼容声明如何生效