@mokuyoaxis/dsh-iris 0.2.7 → 0.3.0-beta.1

package/CHANGELOG.md

@@ -4,6 +4,146 @@
 
 ## [Unreleased]
 
+## [0.3.0-beta.1] - 2026-11-05
+
+- 最低Node提高到22.1.0，并对齐包声明、Doctor及CI；隔离复现22.0.0原生fetch正文取消不关闭连接的问题，避免调度名额遗留。Windows Provider模板验收采用受控IPC递送正常关闭事件，保留真实CLI清理和原任务重启检查。
+
+首个0.3 beta：在alpha.1工作台、MCP与插件基础上，新增网络出口池与Doctor、有界并发调度、固定文生视频、环境凭据引用和独立插件模板，并收口主要流程及最小插件契约。使用npm `beta`通道，稳定`latest`保留0.2.7；旧根不自动迁移。见[发行说明](docs/releases/0.3.0-beta.1.md)。
+
+- 修复DSH连接引用可叠加媒体地址的问题，解析出的凭据只发送到宿主提供的端点；引用供应商不再显示媒体地址编辑器。无效来源组合读取时报错并保留文件，null等非法地址/密钥编辑在写入前拒绝。工作流报告同时脱敏属性名和字符串值；目录中包含完整Key的模型ID整份拒绝，不改写为虚构模型，短测试Key重合也适用。
+- 视频候选统一区分已知t2v/i2v/s2v/r2v输入家族，固定文生视频流程拒绝已知非t2v模型，未知兼容ID保留既有路径。修复来源转写Task重试误要求改图输入；明确提供新音频URL和费用确认后创建新Task，旧Flow和来源保持。
+- 索引重建/刷新失败保留dirty状态；新提交对已索引legacy作品复用已有摘要，不再读取其媒体，缺少摘要时要求显式重建。DSH快照复用元数据目录，单个坏作品不再清空正常作品。坏Task时调度观测返回计数不可用，提交准入继续严格检查，通知等待者的读错误不升级为无关写者释放失败。
+- 修正DSH浏览器入口的类型声明：`/client`提供工厂形状的`DshClientPlugin`类型，运行时继续通过宿主ModuleLoader注册，不声明不存在的Node默认导出。总览分别显示音频/视频工作区限制，补旧根、v3/v4及只读/执行状态的浏览器检查。
+
+- DSH HTML截图在保存前确认本次页面已由Iris渲染路由返回，未挂载、错误服务或仅HEAD不再凭PNG记成功；不增加探测请求或浏览器接口。进度区与泡泡共享Core活动快照，区分运行/观察暂停/待处理并遵守提醒处置；早期Core作品单列兼容提示，不自动迁移或哈希整库。旧视觉SSE兼容入口补齐累计2 MiB及取消/超时失败，保留主业务Model Port的严格完成语义。
+
+- MCP HTTP增加实例级4条消息的共享预算，覆盖正文读取到媒体响应排空；兼容路径的批量请求逐条计数，单批最多4条。繁忙返回429与Retry-After，不排队或自动重提；单正文9 MiB、既有媒体限额和Core原任务恢复保持。见[MCP HTTP](docs/MCP.md#http填写-url-和认证)。
+
+- 修复网络配置/代理凭据轮换后旧客户端一直保留到服务关闭的问题：后续解析替换旧缓存，停止旧客户端接收新操作，等完整正文和后续请求结束再释放连接池；实例关闭同时排空正在退役的客户端，清理失败仍报错。
+
+- 修复固定视频流程整读后才检查32 MiB，以及内联/缓存交付绕过媒体限额的问题；超限保留生成成功事实，不重新提交。DSH媒体GET改用流式发送，HEAD保留分块哈希校验且不整读。作品提交不再重哈希整个图库，索引失败/中断明确提示重建，原Task/Artifact和既有持久格式保持。
+
+- 补齐持久供应商的内联/env/DSH来源互斥，非法混存拒绝读取和保存，DSH合法内存解析副本保持可用。工作流检查在JSON编码前递归脱敏，覆盖转义凭据、嵌套选项与检查期间环境轮换。Retry-After及毫秒冷却提示有界处理，避免极端值掩盖原429；不迁移旧配置或任务。
+
+- 修复独立Flow CLI缺少音视频首次候选装配：创建不生成，继续沿原Run/Task执行或观察。转写本地音频在取得写权、保存原Attempt后按实际账号上传，上传取消停止候选链；根忙零上传。视频重试要求明确`video_mode`并重新提供对应媒体，DSH简化入口仅显式创建文生视频，防止旧图生/数字人输入丢失后静默降级；不迁移Task或扩大固定视频Flow范围。
+
+- 修复DSH启动接管旧任务时遗漏连接引用解析：保留原协议和远端ID，连接暂不可用不再把v1任务误判失败；关闭时排空解析，凭据不落盘。Core恢复同时补齐已明确未受理、最终失败尚未落盘的中断状态，沿原Attempt收口，不继续候选或重复生成。
+
+- 修复已接收Operation的写入排队超时/满员会拖垮整个执行服务的问题：单项失败持久保存、其他工作继续，短终态写入安全排空；真实存储/清理故障仍保留租约。内置媒体提交禁止自动跟随重定向，保持原受理未知且不切换候选重发；正常媒体下载继续可用。
+
+- Core原生改图/转写创建统一检查来源作品授权，HTTP/MCP及原Key接回不再借创建绕过来源读取限制；保留已授权的共享图片及无绑定导入规则，创建不上传、不生成。
+
+- 修复显式直连/代理传输中的原生 `FormData` 与 `Request` 互操作：上传保留 multipart 字段、文件和长度，Request 保留覆盖参数、正文、重定向与取消；不修改全局 fetch 或重放失败请求。补充真实本地 CONNECT 与调度回归。
+
+- 修复百炼文生视频尺寸分隔符：Core/工作台常用的 `832x480` 在DashScope传输时转换为厂商要求的 `832*480`，保留原Run输入与身份；已失败的远端任务不自动重提。
+
+- 修复真实百炼TTS暴露的WAV字节被记录为MP3的问题：新音频交付按有限文件头确认MIME和后缀，保留原字节，生成结果可直接作为转写来源；无效响应仅标记交付失败，不重新合成，不改写已有作品。供应商工厂的已知配置错误返回安全400，保留关联诊断；更新网络端口迁移后过期的lint守卫。
+
+- 整理[beta支持范围与兼容约定](docs/BETA_SCOPE.md)，明确最小插件面、主要用户入口、数据门禁和平台/真实账号证据的区别；发行按beta渠道，平台矩阵按同一提交核销。旧万相视频模型的官方参考指向legacy协议页。
+
+- 新增独立[万相 Provider 模板](templates/provider-starter/README.md)与[最小契约审查](docs/PROVIDER_PLUGIN_CONTRACT.md)：统一工厂接收 v1 只读上下文、当次解析的凭据及 Core 借出的 fetch；Core 管理完整正文/多跳、调度和关闭，旧窄扩展用法保留。模板实现公开异步协议，显式确认目录/模型池，经普通媒体 MCP 使用并恢复原任务；已完成受控接口验收及百炼北京 wan2.6-t2i 单账号真实交付，不代表全部账号或已发布 alpha.1 支持。
+
+- 新增显式[有界媒体调度](docs/MEDIA_SCHEDULING.md)：`api/web serve --scheduler-config` 保留单根单写者，媒体网络等待可并行，短写入串行接回；HTTP正文并发、滚动派发RPS与远端未结束Task分控，供应商/模型可进一步限制。模型冷却先等候，逐项取消、原Task恢复与未知受理不重提；Operation短接收不再等待整次网络，Web显示临时等待原因。缺省仍串行，未知插件业务保持独占，无新依赖、自动迁移或日常重启。
+
+- Core新增[网络出口页与Doctor](docs/NETWORK_WORKBENCH.md)：独立owner开关、节点/池/供应商绑定、候选排序、编辑取消与引用保护，沿用私有文件和CAS，不自动迁移旧配置。供应商/功能池显示配置出口，原任务显示已记录路线；静态检查来自实际Core进程，明确点击后才进行一次有界、无Provider Key的GET和可选IP观察，支持取消、区分上游状态与未知TUN。普通MCP不获得资源/环境或检测权限，未修改日常代理、依赖或核心存储格式。
+
+- 新增[供应商出口绑定与HTTP/HTTPS代理](docs/NETWORK_ROUTING.md)：显式新v2网络文件与Provider目录包装、固定/有序出口、未绑定继承环境；实例使用Undici7.30.1，不改全局代理或系统路由。只在业务发送前的连接预检选择备选，收到POST后断线保持受理未知、不换出口/模型重发；Task3与Flow从首次保存记录网络要求和派发路线，Core存储失败停止出站。受控真实代理、原任务跨Node进程换允许出口恢复、CLI/API和实际包验证通过；旧文件/任务不自动迁移，公开网络SDK继续后续。
+
+- 新增[出口节点与池资源管理](docs/NETWORK_RESOURCES.md)：独立显式私有文件及本地owner CLI，HTTP/HTTPS地址、认证环境引用、固定/有序候选与空池草稿、启停/引用删除保护、版本与字节修订门禁、写前备份和原子替换。资源命令不联网、不启用路由；供应商绑定、实际路由和上述Doctor单独显式启用。
+
+- 增加[Provider实例级出站网络基础](docs/PROVIDER_NETWORK.md)：内置媒体适配器、模型目录及共享候选/原Task装配可注入独立客户端，跟踪完整正文、多跳上传和下载后再关闭，保留同步错误映射。未配置保持原联网行为，显式请求失败不隐式回退；上传和转写错误响应释放正文，下载在出站前准备本地目录，避免存储失败留下未读响应。基础端口不切换全局代理，资源与实际路由由上述独立增量提供。
+
+- 修复凭据引用复查发现的摘要脱敏与目录导入遗漏：长 Key 在展示字段中先脱敏再截断；CLI/注册协议/旧目录刷新拒绝把上游直接回显的认证值导入为模型 ID，保持原配置/完整缓存，并按实际请求捕获值处理失败消息。HTTP/CLI提供明确的安全错误码。
+
+- 新增可选[供应商环境凭据引用](docs/PROVIDER_CREDENTIALS.md)：Web/CLI 显式保存 `apiKeyEnv` 名称，区分未就绪/已就绪/值无效，调用内存解析与精确脱敏；保留原内联 Key、owner 管理权限和旧 Task 绑定，轮换后查询原任务，不增加环境读取 MCP 工具、不自动读取 `.env` 或迁移配置。已发布 alpha.1 尚不包含此功能。
+
+- 新增[独立插件模板与开发说明](docs/PLUGIN_DEVELOPMENT.md)：独立身份/版本的真实图片业务复用公开对照板实现，贡献 Web 页面和 PNG 预览器；新目录初始化、明确启用/授权、原 UUID 恢复及包外自检，不新增 Core 接口或生产依赖。模板随beta.1分发，旧alpha.1不包含该目录。
+
+- Core Web/MCP 新增[固定文生视频流程](docs/VIDEO_FLOWS.md)：显式新 v4 根、实际模型候选和尺寸/时长、原 Run/Task/Operation 恢复、本地停止、视频作品分类及 MP4/WebM（≤32 MiB）播放下载；MCP 由用户选择 video-generate，标准资源引用/读取逐次校验授权，连接 Skill 同步生成指导。旧根/旧授权不迁移扩权；受控回归之外，另完成百炼北京 wan2.2-t2v-plus（832×480、5秒）真实单例的原任务重启接回、MCP及Web播放下载验收，不代表其他上游或客户端均已验证。此功能随beta.1分发。
+
+- Core 客户端页串起选择/授权、配置导出和接入核对，增加授权摘要、同/异机提示及草稿保护。配置生成、Iris 端只读配置检查、客户端握手/可选声明分开记录；检查不建立桥或调用模型，工具范围来自实际目录与 scopes，历史和自检不冒充 Agent 接入。切页/退出取消读取并清除私有预览，迟到复制不覆盖新页面；未增加 API、权限或持久格式。见 [MCP 连续接入](docs/MCP.md#工作台连续接入当前源码)。
+
+- 默认 Core 工作台新增只读“插件”页，集中展示加载身份/版本、Core 兼容范围、五类贡献、实际业务与页面启用、准确客户端授权和握手记录；区分缺失版本、权限缩减、未选择调用工具和撤销。目录或授权读取失败分别显示，详情默认折叠；查看和重新读取不执行业务、测试模型或自动授权。启用继续使用[明确启动配置](docs/PLUGIN_STARTUP.md#查看插件状态当前源码)。
+
+## [0.3.0-alpha.1] - 2026-10-30
+
+0.3 首个预发布：独立 Core 工作台、通用 MCP 和显式插件贡献与原 DSH/CLI 共用持久执行和作品。通过 `alpha` 通道获取，稳定 `latest` 保留 0.2.7；现有数据根不自动迁移。范围、入口与限制见 [发布说明](docs/releases/0.3.0-alpha.1.md)。
+
+- 发布工作流区分稳定和 alpha/beta/rc 渠道，预发布明确使用 npm dist-tag 与 GitHub prerelease，验证远端版本及渠道；新增实际 Shell 隔离回归，预发布不占用稳定版入口。
+
+- Windows 短路径与 Core 物理根统一认证记录身份和凭据目录边界检查，保留原默认认证目录映射与严格校验；媒体下载明确等待输出文件关闭后再发布或清理。补充 Windows 测试路径、Python TOML UTF-8 和正常关闭事件的跨平台回归，原强杀与租约恢复保护保持。
+
+- 统一插件图片来源的目录、预览和执行权限：带图片输入的业务共享同一数据根内 ≤8 MiB 的 PNG/JPEG/WebP，其他业务的调用和历史仍分别授权；无图片用途的业务不再默认读取裸图片。图库读取遇到维护提交窗口中的缺失文件时，在确认写者活跃后改报写入繁忙，真实损坏继续报错。CLI 启动测试改用单调时钟，补充超时双时钟与子进程诊断，保留原限额。
+
+- DSH 的 Core 作品、任务和高级诊断刷新只接受最新请求的结果，卸载后的回包不再更新界面；旧错误和结束加载回调也不能覆盖当前请求。
+
+- 修复普通视觉成功改写供应商配置和健康时间导致的设置草稿冲突，保留媒体任务与显式实测证据；补齐 React 测试夹具及路线图守卫。修复租约准备文件中断后的安全初始化、插件原 UUID 重试唤醒、DSH 晚到服务与释放回滚、桥接业务选择及 MCP 可选元数据阻塞。上游 JSON/媒体下载增加累计限额，交付保留错误类别；DSH 展开入口补键盘语义，legacy 视觉不再把截断结果当成功。
+
+- 重组中英文 README，以 Core 工作区和实际入口覆盖为主线，分别说明稳定 0.2.7 的 DSH/CLI 与 alpha Web/MCP/插件能力；新增 [Core 从零启动](docs/CORE_QUICKSTART.md)及英文正文附中文标题的 [Agent 接入指导](docs/AGENT_CORE_QUICKSTART.md)。更新实际候选包的默认背景工作台截图及来源，保留历史真实生成和 DSH 真机证据；本轮媒体为受控回放，不代表新增付费模型/GPU 验收。
+
+- Core [模型服务](docs/PROVIDER_SETTINGS.md)拆分供应商、功能模型池与健康检测：六色浅光谱区分候选、近期成功和受阻原因，全局池独立保存并可手动排序。供应商支持停用/恢复、影响预览与确认删除，当前根的未完成/可恢复依赖阻止删除，作品和历史保留。连接检查只读，保活默认关闭且仅本次服务有效；媒体验证先打开指定模型草稿，点击创作按钮才进入持久任务，真实成功受理记录精确健康证据。两类编辑页补齐返回/取消确认，长页保留退出登录入口；不增加依赖或迁移配置。
+
+- 新增[Core 启动与插件启用](docs/PLUGIN_STARTUP.md)：`plugins list/inspect`、明确 JSON 入口/业务/Panel 选择及 `api/web serve --plugin-config`。`--token-dir` 支持原命令重复启动，每次新建私有会话文件、保留旧文件，固定端口与原连接目录继续使用 MCP 配置。启动失败和信号退出按服务/runner → 插件顺序收尾；加载不授权，不自动安装、扫盘或修改客户端。
+
+- 新增可选[多图对照板](docs/CONTACT_SHEET.md)真实业务：只使用公开插件 SDK 和现有 Sharp，把已有图片排成新 PNG。显式启用后复用 Core 单根 runner、持久 `plugin.execute`、原 UUID/输入门禁及预留输出身份；Web 有制作入口和不依赖插件实现的业务记录页，连接按准确依赖选择后通过通用 MCP 目录/执行工具使用。安装不授权；重启不自动重做，缺失/升级插件和缩权均明确检查，原记录/已入库作品保留。验证包含实际图片、官方 MCP 双传输/协议、Chromium 和两个 SIGKILL 窗口；仍为 alpha 实验契约。
+
+- 默认 Core Panel 支持显式组合插件页面、设置表单与作品预览，共享主题、API 客户端与登录上下文；表单默认折叠，预览按实际媒体类型选择。新增公开 `createCorePluginWorkbench` 与设置贡献类型，有限资源不开放目录；切页/退出释放挂载，错误标注贡献与阶段。整套 Panel 替换保留；设置复用已开启的 Core Provider 管理，持久业务另行显式开启。见 [Web 贡献](docs/PLUGINS.md#web-贡献和生命周期)。
+
+- MCP接入增加通用/Claude Code/Codex/Kimi Code的8个显式预设、原生Codex TOML与Claude JSON导出、只读 `mcp check` 和 `mcp presets`；连接页保留手动/数据模板并下载正确格式，不扫描或自动配置客户端。修复Core客户端、stdio桥和HTTP网关的启动/关闭竞态，错误保留阶段、关联ID和原操作身份。原授权不扩张，Core仍显式启动；见[MCP指南](docs/MCP.md)。
+
+- Core 新增统一能力目录：MCP/DSH 工具、授权选项、Web 会话操作及连接 Skill 同源；插件贡献列出身份、版本与接入边界，连接中心默认折叠展示。服务显式复用插件注册器，注册/发现不授权，旧工具快照不扩张。见 [能力目录](docs/PLUGINS.md#core-能力目录与授权)。
+
+- 新增实验性 [Core 插件贡献 v0](docs/PLUGINS.md)及公开类型：五类贡献共用身份、兼容、生命周期与准确依赖。业务按明确授权进入 Core 队列，新插件 Provider 的 Task/Attempt 保存依赖并阻止跨版本误恢复；旧扩展/绑定保持。装配支持明确 CLI 配置或公开 SDK，不含安装器或市场。
+
+- Core 工作台新增能力总览：六类媒体卡片区分实际入口、保存配置、候选与历史实测，已有功能直达真实草稿；未接入的 Web/MCP 能力说明 CLI/DSH 范围，本地工具与详情默认折叠。只读刷新不调用供应商、不覆盖未保存配置；沿用原 API、授权和存储格式。
+
+- 统一 Core 音乐协议显示为“Chat Completions（内嵌音频）”，保留 `gemini-web-music` 配置标识。区分图片协议沿用默认与音乐必须明确选择，补齐音频流程、只读下载及认证选项的准确说明，同步供应商文档和 CLI 帮助；调用、授权与配置行为保持。
+
+- Core Web/MCP 接入 [语音合成与音频转写](docs/AUDIO_FLOWS.md)：新专用 v3 音频执行根、固定步骤/原 Task、来源音频持久保存和 Attempt 内临时上传；播放器、纯文本转写、原字节下载和作品分类共用单根 runner。MCP 按 tts/transcribe 分组明确授权并生成对应连接 Skill，旧图片授权不扩权；原 Key、未知受理不重提和原交付缓存恢复保持。通过受控 HTTP/stdio 与 Chromium 验证，未调用真实付费模型，不迁移现有根。
+
+- Core 工作台普通 `web serve` 默认使用[访问口令](docs/WORKBENCH_LOGIN.md)：首次设置，之后普通地址登录，默认记住设备30天并跨正常重启；退出撤销当前浏览器会话，再用原口令进入。`web login --data-root` 取地址、`web password reset --data-root` 撤销全部浏览器会话并重新设置，不修改 Core/MCP 数据。根外私有存储、异步 scrypt、独立浏览器凭据与 Host/Origin 边界；显式 Token 模式保留原一次性链接，SDK 可选启用，无新增依赖。
+
+- Core“客户端”“模型服务”改为概览卡片与独立编辑分组，接入帮助、未接入能力和技术详情后置；供应商保留六色极浅识别、ComfyUI彩蛋与未保存草稿保护。明暗统一在“外观”，移除顶栏重复按钮和紫罗兰/玫瑰/杏色点缀选项，固定鸢尾；旧外观设置只归一点缀，背景与布局保留。见 [工作台](docs/LOCAL_WEB.md)与 [外观](docs/PANEL_EXTENSIONS.md)。
+
+- Core 连接页补齐创建授权、导出配置和客户端启用的 MCP 指引，显示当前 HTTP 开关，并区分 stdio 桥接与 HTTP 服务。新增确认后删除连接：持久撤销、从列表移除并保留私有归档，旧凭据与旧创建 Key 不会复活；作品、任务和客户端配置保留。供应商从 ComfyUI 切回自定义时恢复此前 API 连接草稿，预设、实际协议与模式动画保持一致。见 [连接中心](docs/LOCAL_WEB.md#显式开启连接中心)。
+
+- 修复 Core 连接页默认改图草稿夹带生图工具、创建时被拒绝的问题；“新建连接”增加提示与手机定位/聚焦。供应商切换 ComfyUI 增加模式标识和一次鸢尾扫光。旧 Token 模式使用独立标签页会话存储，刷新先只读验证；退出或401清除，浏览器禁止存储时明确提示，不自动生成。普通口令模式另支持记住设备。见 [Core 工作台](docs/LOCAL_WEB.md)。
+
+- 现有 `iris-core` 增加 [ComfyUI 独立参考](skills/iris-core/references/comfyui.md)：先集中确认缺少的工作流/LoRA/参数要求，按真实目录选择，保留原任务恢复；区分普通 API、ComfyUI 和 ComfyUI 出图后交给 API 改图。连接专属 MCP Skill 按实际开放的目录、创建、执行和改图工具生成指导，不扩权；随包安装与自包含引用通过定向验证，DSH 三项 Skill 保持。
+
+- Core 工作台接通 ComfyUI v1 导入、已有标量参数命名与表单预览、LoRA 双权重/种子等控件，以及原 Run 参数查看。草稿只读检查沿用已保存连接和 owner/revision 门禁，检查不保存或入队；切换模型清空覆盖，检查变化失效，生成点击固定参数，未知受理不重提。更多参数默认折叠，窄屏/深浅色与减少动画保持；未接入真实 GPU 或新增 MCP 权限。见 [ComfyUI 入口](docs/IMAGE_GENERATION.md#comfyui-入口)。
+
+- 按 ComfyUI 官网及官方 `fe298e4` 源码复核请求/队列/历史/取图与 LoRA 元数据；更新兼容边界和 SaveImage 测试定义，保留旧版无数据输出的节点兼容。API 图中的越界整数也在模板边界拒绝，避免大种子被 JavaScript 静默舍入；真实 GPU 仍待验收。
+
+- DSH 工作台增加 [ComfyUI 专区](docs/IMAGE_GENERATION.md#dsh-工作台入口03-alpha)：无需密钥的已有服务连接、API 图/Iris 模板导入、明确节点与公开参数、只读检查和同名替换保护；原画图与泡泡卡片接通 LoRA 双权重等参数，额外设置默认折叠，并加入遵循减少动画设置的短暂鸢尾扫光。保留旧模型管理中的工作流字段，更换模板清除图片健康证据；不另起服务、不安装模型、不宣称真实 GPU 已验收。
+
+- ComfyUI 后端增加明确参数槽位（含 LoRA 双权重、负面提示词与种子）、官方节点定义的只读检查，以及首次提交前检查；CLI、Core 创建 API 和所选文生图 MCP 接通参数快照与原 Key 冲突保护。v0 固定模板保持，带参数的新 Run 由旧读取者拒绝；Core 与 DSH 参数界面均已接入，未宣称真实 GPU 验收。见 [参数模板与检查](docs/IMAGE_GENERATION.md#comfyui-参数模板与只读检查后端)。
+
+- 新增 [Core 独立文生图与 ComfyUI 入口](docs/IMAGE_GENERATION.md)：显式新 v2 执行根、固定生成步骤/Task、原 Key 恢复和选择下载；Web 分开生成/修改，MCP 新能力由用户明确选择，旧 12 工具授权不扩张。ComfyUI 通过现有 Provider 扩展框架连接已有服务、导入 API 工作流并绑定输入/输出，使用原任务队列/历史/取图，不发送全局中断、不安装服务。受控 HTTP 与浏览器验证不等于真实 GPU 出图。
+
+- Core 默认 Panel 改用白色主体与六色 105 度鸢尾点缀，新增本地外观/背景、受限主题 JSON 和显式可信 Panel 资源清单，API/CLI/MCP 独立。见 [Panel 与外观](docs/PANEL_EXTENSIONS.md)。
+- 新增 C3 [供应商与模型设置](docs/PROVIDER_SETTINGS.md)：独立 owner 开关、非秘密投影、保留/替换/清除 Key、revision 冲突和单次原子保存；目录/手填模型、六类用途及全局自动/手动/停用。设置不生成媒体、不迁移格式、不接管 harness 登录；显式媒体实测沿用 CLI，Web 验证草稿入口见本节模型服务更新。
+
+- 新增[Provider 扩展首版](docs/PROVIDER_EXTENSIONS.md)：实例级协议描述/工厂、版本与重复注册检查、等待在途调用后异步释放；CLI/API 显式加载可信本地模块，内置协议与外部协议共用候选、目录、模型级覆盖、实测及 Task 恢复。实验性窄包入口不等于完整 SDK；保留原 binding/存储格式，不自动安装插件、扩张功能授权或迁移数据，DSH 默认内置行为保持。
+
+- W1c 将 Demo 布局迁入真实 [Core 工作台](docs/LOCAL_WEB.md)：创作画布、右侧固定输入、真实作品筛选和独立连接页，支持深浅、窄屏、并排/叠图与放大。显式启用权限后可选图、改图、观察原任务、本地停止、按版本保存选择及下载；默认仍只读，刷新和回包丢失恢复不自动生成。HTTP 列表增加选择筛选/计数及有限结果摘要，不改变 CLI/MCP 列表或 Core 数据格式。
+
+- 新增 W1b [工作台请求核对与刷新恢复](docs/WEB_RECOVERY.md)：owner 按原上传/创建 Key 只读定位，session 提供稳定根身份；有限媒体客户端合并重复活动动作，显式重试保留原 Key，刷新和换根不自动生成。有界 sessionStorage 只存动作身份，不存 Token、Prompt 或文件；核对面板默认折叠，W1c 已接入真实创作控件。不改 Core 数据格式或 MCP 授权范围。
+
+- 更新源码树的独立 Web Demo：创作画布、作品筛选和连接草稿三个页面，支持浅/深色与窄屏，运行详情和工具预览默认折叠。演示使用标签页内存与内置样图，不调用模型、不写 Core；Demo 与预览脚本不进入 npm 包。见 [交互预览](docs/WEB_PROTOTYPE.md)。
+
+- 新增显式 `api/web serve --allow-selection`：仅 owner 可提交原图/结果及当前 Run 版本，同 writer 核对并原子保存；旧版本冲突，同版本重复选择不重写，不调用 Provider。创建、执行与选择开关不依赖连接管理，仍分别显式启用；默认只读、MCP 权限保持。页面选择遵守同一门禁，见 [持久选择](docs/LOCAL_SELECTION.md)。
+
+- 连接中心新增纯数据模板导入与按有效工具生成的 MCP Skill：模板只选择传输/JSON 格式，不增加权限；英文说明附中文标题，下载后通过 `skills install/status/uninstall --bundle` 显式安装，复用摘要、更新归档与本地修改保护。配置和 Skill 按当前服务权限取交集，原 `iris-core` 及 DSH 三项 Skills 保持。见 [连接专属 Skill](docs/CORE_SKILLS.md#连接专属-mcp-skill03-alpha)。
+
+- 新增显式 Core 连接中心：根外私有档案、稳定创建身份、修订保护、自由命名、媒体/工具/操作权限选择、stdio/HTTP 配置导出及持久撤销；官方 SDK 的客户端名称/版本以自报事实记录，不扫盘判断安装状态。可与同一有限执行服务组合，媒体权限独立启用，DSH 原生配置与 Skills 保持。见 [连接中心](docs/LOCAL_WEB.md#显式开启连接中心)和 [连接契约](docs/CORE_CONNECTIONS.md)。
+
+- MCP 默认采用 generic 连接，新增明确功能/工具选择、`mcp capabilities/config` 和 stdio 配置导出；`api serve --allow-mcp` 提供标准 Streamable HTTP，与 stdio 共用官方 SDK 工具工厂和现有 Core。服务端拒绝未选择的工具，旧连接按固定旧工具集读取，不自动扩权。CLI 的 HTTP 认证配置仅导出到新建私有文件，连接中心须由 owner 明确操作导出；当前媒体范围和待接入项见 [MCP 指南](docs/MCP.md)。
+- 增加面向 0.3 的 Operation 存储与版本门禁：新空 Flow 根显式 `execution init`，根内 Key 派生身份、原子接收、revision/活动冲突、有限持久状态和只读 `operation list/inspect`；维护保护引用，v0 不迁移，旧 0.2.7 写者拒绝 v1。见 [Operation 说明](docs/LOCAL_OPERATIONS.md)。
+- 新增显式 `api serve --allow-execution`：独立 runner 租约、真实 Provider 装配、单次继续、持久 202/原 Key 接回和本地停止，重启只标记中断，不自动生成或观察。连接身份/根 UUID/scopes 握手、官方 SDK `mcp serve` 与 DSH 可选共享 Flow 工具共用同一 Core 服务；原 DSH 媒体/Skills/UI 保持，页面按独立权限启用。新增依赖官方 MCP Server/Core 2.3.1 与 Zod 4.6.7，见 [Core 服务](docs/CORE_SERVICE.md)和 [连接契约](docs/CORE_CONNECTIONS.md)。
+
+- 增加面向 0.3 的 Core 工作台 `web serve`：显式本地会话、持久图片流程历史、认证原图/结果和已选作品原字节下载；登录按标签页保留，刷新只读验证，详情默认折叠。复用现有 API 的 Bearer/Host/Origin，固定静态资源随候选包分发；默认只读，媒体写入、执行与选择由独立开关明确启用。原 Demo 保留，npm 0.2.7 尚不含新入口。见 [本地工作台](docs/LOCAL_WEB.md)。
+
 ## [0.2.7] - 2026-10-22
 
 0.2.7 修复宿主截图集成，并提供宿主无关的图片流程、本地 API 与显式 Core Skill 安装器。DSH 沿用 12 个准确版本；独立 Web 仍是面向 0.3.0 的源码演示，尚未连接真实执行入口。英文发布说明附中文摘要，见 [0.2.7](docs/releases/0.2.7.md)。
@@ -381,7 +521,9 @@ 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.7...HEAD
+[Unreleased]: https://github.com/mokuyoaxis/dsh-iris/compare/v0.3.0-beta.1...HEAD
+[0.3.0-beta.1]: https://github.com/mokuyoaxis/dsh-iris/compare/v0.3.0-alpha.1...v0.3.0-beta.1
+[0.3.0-alpha.1]: https://github.com/mokuyoaxis/dsh-iris/compare/v0.2.7...v0.3.0-alpha.1
 [0.2.7]: https://github.com/mokuyoaxis/dsh-iris/compare/v0.2.6...v0.2.7
 [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