dsh-showcase 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -4,8 +4,36 @@
 
 ## [Unreleased]
 
+后续变更将在下一版本发布前继续记录在这里。
+
+## [0.1.4] - 2026-10-04
+
+### Fixed
+
+- 迁移到 DSH `0.2.0-rc.2` 的 SettingsForms 与 Plugins 配置槽位：主题和海报开关改用 `.volatile()` 配置及官方行配置页，保留现有 profile 选择并支持修订号冲突保护。
+- 适配 DSH `0.2` 的严格工具输出 JSON Schema，移除旧版属性级 `required` 写法；插件不再抢占 Connection 的私有 RPC 通道，避免 Web/API Gateway 冲突。
+- 将客户端入口从旧 Settings 列表迁移到 `plugins.row.config`，在 summary/page 两种视图下均保持单一、可用的配置卡。
+- Markdown-only 摘要遇到项目外部 symlink 时静默跳过越界记录，不再把外部视口标签写入文档；海报生成仍严格拒绝越界路径。
+- GitHub Actions 改用兼容 Node 24 的官方 Action 版本，避免旧运行时弃用提醒。
+- 浏览器拒绝本地存储或偏好 JSON 损坏时，离线报告保留导出时的明暗、强调色和动效设置；无效设置不会覆盖有效值。
+- 手机端显示设置的操作区域至少为 44px，并保留矮屏滚动边界。
+- 两套主题统一保留测试回执的具体输出；蓝色大肥鱼主题新增可展开的命令输出与截断提示，不再只显示命令摘要。
+
+- CLI 与插件共享报告校验和脱敏，覆盖命令、任务说明及多种凭据格式；损坏的旧报告不再被静默覆盖。
+- 使用项目级跨进程写锁与真实路径检查，防止并发产物混写及 junction 越界写入；保留回滚失败时的备份。
+- 修复 Git 重命名、monorepo 子目录、历史比较和 detached HEAD；记录提交 SHA 与工作区指纹，测试后的变更不再遗漏。
+- 状态以实际回执为准；校验截图尺寸、时效、Before/After 和 DPR，并在 HTML 中展示复核警告。
+- 长文本海报与矮屏布局改为内容自适应；HTML 内嵌主题素材，数据与 Markdown 导出实际下载文件。
+- 设置连接失败后可以重试；测试输出保留头尾并标注截断，支持 UTF-8 BOM 配置与混合技术栈检测。
+- 移除未使用的 jsdom，约束 Zod 主版本，更新 Vitest 安全补丁，并扩展 Windows/Linux CI 矩阵。
+
 ### Added
 
+- 依据终末地官网实际样式校正社区主题：白色 / 中性灰 / 硬黑分区、`#fffa00` 信号黄、局部地形等高线、灰色导航选中态；加载页使用 `#141414` 深底、旋转仪表与黄色横向扫幕，保留可持久化的明暗和动效设置。
+- 复核信息收紧到报告顶部，变更与测试前置，单张 / 双张截图按记录数量适配；保留鱼主题与旧版终末地。
+
+- 终末地补齐任务摘要、可切换逐行 Diff、同页同视口前后截图对比、脱敏分类及 JSON / Markdown 下载；演示截图独立采集，不复用鱼主题图片。
+- CLI 可保留经过脱敏的有限文本补丁；旧报告继续兼容，二进制、未跟踪、超限和缺失补丁均有明确说明。
 - 终末地帝江号与蓝色大肥鱼两套独立海报主题。
 - DSH 插件设置、Markdown 摘要和可选的自包含 HTML 海报。
 - 跨项目源码发现、证据时效检查、路径约束和极端输入保护。
@@ -14,6 +42,13 @@
 
 ### Changed
 
+- 更新 README 的鸽子中转站介绍，补充当前模型覆盖、订阅方式与不定期抽奖赠 Token 福利说明。
+- 加强终末地首屏主视觉：扩大公告式标题、提高等高线存在感，加入黑色结构面与斜切信号黄带，让工业编辑风格形成明确视觉峰值。
+- 终末地交付报告收敛状态色为黑 / 灰 / 信号黄，减少红绿仪表盘噪音；桌面标题、摘要和分区增加留白，移动端阶段导航改为文档流内的吸顶栏，避免遮挡 Diff 与回执。
+- 加强终末地主屏层次：将交付中继融入黑灰标题带，局部复用等高线素材，使用深色命令输出与浅色文件清单，并补充导航、回执和按钮的交互反馈。
+- 终末地演示与插件 HTML 共用交付工作台：单条阶段导航、实际界面证据、变更档案、可展开回执和交付中继；无截图时显示证据缺口，不再展示装饰性拓扑。
+- 增加路径复制、原图下载与自包含 HTML 下载；保留旧版终末地对照入口，不改变蓝色大肥鱼的视觉布局。
+- 修复加载仪表旋转中心和进度编号重叠，保留厚进度条与黄色斜切扫幕；主题纹理加载失败不再阻断演示报告。
 - 重写 GitHub 首页，明确安装、使用、隐私、素材和发布边界。
 - 强化终末地帝江号加载器的机械校准环、厚进度轨和黄色切换幕。
 

package/README.md

@@ -2,7 +2,7 @@
 
 [![CI](https://github.com/DoveLi-Gu/dsh-showcase/actions/workflows/ci.yml/badge.svg)](https://github.com/DoveLi-Gu/dsh-showcase/actions/workflows/ci.yml)
 [![License](https://img.shields.io/badge/license-MIT-111115.svg)](LICENSE)
-[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D20-2f855a.svg)](https://nodejs.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-22.19%2B%20%7C%2024%2B-2f855a.svg)](https://nodejs.org/)
 
 **把编程 Agent 的改动和测试结果，整理成可核验的中文交付报告。**
 
@@ -21,8 +21,10 @@ dsh-showcase 是一个本地运行的 DSH 插件。它读取目标项目的 Git
 <details>
 <summary>终末地帝江号（机械工业 / 等高线 / 黄黑校准）</summary>
 
-<p><img src="docs/assets/dijiang-desktop-latest.png" alt="终末地帝江号桌面 1K 预览，1024 x 640" width="680"></p>
-<p><img src="docs/assets/dijiang-mobile-latest.png" alt="终末地帝江号移动端 1K 预览，455 x 1024" width="220"></p>
+<p><img src="docs/assets/dijiang-desktop-latest.png" alt="终末地帝江号当前桌面首屏，1000 x 900" width="680"></p>
+<p><img src="docs/assets/dijiang-mobile-latest.png" alt="终末地帝江号当前移动端首屏，455 x 1024" width="220"></p>
+
+终末地主题采用白、浅灰与硬黑分区，搭配信号黄、局部等高线和细分隔线。左侧阶段导航在手机上收至底部；变更档案与验证回执前置，截图保留完整画面。深色加载页以旋转仪表和信号色横向扫幕进入报告。右上角可切换明暗、谷地黄 / 武陵青、动效及背景帧率上限。这些是社区主题设计，预览中的演示数据不代表目标项目已通过验证。
 </details>
 
 <details>
@@ -34,8 +36,8 @@ dsh-showcase 是一个本地运行的 DSH 插件。它读取目标项目的 Git
 
 ## 你需要什么
 
-- **必须**：已经可以运行的 DSH Web 环境；
-- **必须**：Node.js 20+ 和 npm，用于安装本仓库及运行采集 CLI；
+- **必须**：已经可以运行的 DSH Web 环境（当前插件兼容 DSH `0.2.0-rc.2` 及同一 0.2 系列）；
+- **必须**：Node.js `22.19+` 或 `24+` 和 npm，用于安装本仓库及运行采集 CLI；
 - **可选**：Git。没有 Git 时仍会生成报告，但状态会明确标为 `partial`；
 - **可选**：Playwright 或其他浏览器验收工具。截图不是后端、CLI、库项目的必需项。
 
@@ -45,7 +47,7 @@ dsh-showcase 是一个本地运行的 DSH 插件。它读取目标项目的 Git
 
 | 你现在要做的事 | dsh-showcase 的输出 |
 | --- | --- |
-| 向别人说明这次改了什么 | Git 文件清单、增删行统计和当前引用 |
+| 向别人说明这次改了什么 | Git 文件清单、增删行统计、当前引用；终末地报告可切换文件查看保留的逐行 Diff |
 | 证明测试确实运行过 | 测试命令、退出码、耗时和脱敏后的输出 |
 | 检查桌面和移动端界面 | 最多 3 张经过路径、时间和主题校验的截图 |
 | 给交付结果做归档 | Markdown 摘要和可独立打开的 HTML 海报 |
@@ -53,6 +55,10 @@ dsh-showcase 是一个本地运行的 DSH 插件。它读取目标项目的 Git
 
 支持前端、后端、CLI、Node.js、Python、Rust、Go、Java、库和静态 HTML 项目。
 
+终末地 HTML 还包含任务耗时、增删总量、脱敏分类明细，以及 HTML / JSON / Markdown 下载。同页同视口的 Before / After 截图可用滑块对比。JSON 是脱敏后的报告数据，不包含图片二进制；HTML 内嵌图片，可以离线查看和操作。
+
+`capture` 会为前 20 个变更文件尝试采集文本 Diff，每份最多保留 16,000 个字符并标注截断。二进制、未跟踪、超大或无法读取的文件只保留明确的缺失说明；旧报告没有 Diff 时不会生成假差异。补丁仍需人工复核后再对外分享。
+
 工作流只有一条：
 
 ```text
@@ -82,7 +88,7 @@ dsh plugin --profile web add "C:\tools\dsh-showcase"
 
 然后重启 `dsh web`，再新建一个会话。若命令提示 `dsh` 不存在，先安装并确认 DSH CLI 已加入 `PATH`；这不是本插件自身的安装错误。
 
-打开 DSH 的插件设置，找到 **布局证据产物**。这里可以选择：
+打开 DSH 侧栏的 **插件**，进入 `dsh-showcase`，点击组件 `dsh-showcase/plugin` 的 **配置**，找到 **布局证据产物**。这里可以选择：
 
 - **终末地帝江号**：机械工业、密集等高线和黄黑校准色；
 - **蓝色大肥鱼**：浅蓝背景、角色主视觉和钴蓝强调；
@@ -183,6 +189,20 @@ $showcaseRepo = "C:\tools\dsh-showcase"
 
 </details>
 
+## 在 DSH 生态中被发现
+
+DeepSeek Harness 官方目前没有单独的插件提交审核页面；官方仓库建议插件作者给 GitHub 仓库添加 `dsh-plugin` Topic，用于社区发现。本仓库已经配置 `dsh-plugin`、`deepseek-harness`、`dsh` 和 `cordis` 等主题标签。
+
+部分社区插件目录会定期扫描 `dsh-plugin` Topic，并根据公开仓库的 `package.json`、`dsh.bundle.patch`、入口文件和版本信息生成卡片。收录通常存在延迟，目录属于社区项目，不代表 DeepSeek 官方背书；用户仍可直接使用 DSH 官方命令安装：
+
+~~~powershell
+dsh plugin --profile web add dsh-showcase
+~~~
+
+- 官方生态说明：[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)
+- 社区目录示例：[DSH Plugins Marketplace](https://github.com/bradeGithub/DSH-Plugins-Marketplace)
+- 社区展示与反馈：DeepSeek Harness 仓库的 **Show Your Plugins** Discussions
+
 ## 赞助商
 
 <div align="center">
@@ -194,12 +214,14 @@ $showcaseRepo = "C:\tools\dsh-showcase"
   <p><strong>稳定、透明、易接入的 AI API 中转服务</strong></p>
 </div>
 
-鸽子中转站（Pigeon API Relay）兼容 OpenAI API 格式，重点提供 GPT-5.6 全系列、Claude Opus 5、Fable 5 等模型，同时覆盖多种国产模型，适用于 AI 编程、客户端接入、日常对话、内容创作和图像生成等场景。
+鸽子中转站（Pigeon API Relay）兼容 OpenAI API 格式，持续跟进主流模型与可用线路。当前重点覆盖 GPT-6.1 Sol、GPT-6 Astra / Sol / Luna、GPT-5.6 全系列、GPT-5.5 / 5.4，Claude Opus 5、Fable 5、Sonnet 5，DeepSeek V4 Pro / Flash、Gemini、Grok，以及 Qwen、Kimi、GLM 等国产模型，适用于 AI 编程、Agent 工具调用、客户端接入、日常对话、内容创作和图像生成等场景。
+
+平台支持余额按量与订阅套餐两种方式，提供灵活的日卡、月卡方案；你可以在一个控制台中统一管理 API Key、模型调用、余额、用量和订阅权益，并查看模型价格、服务状态与详细接入文档。模型列表、可用线路、价格和套餐权益会随站内运营持续更新，最终以鸽子中转站实时信息为准。
 
-平台支持余额按量与订阅套餐两种方式，包含灵活的日卡、月卡方案；模型价格和套餐权益清晰可查。你可以在一个控制台中统一管理 API Key、模型调用、余额、用量和订阅权益，并查看服务状态与详细接入文档。具体模型、价格及套餐权益以鸽子中转站站内实时信息为准。
+站长也会不定期组织抽奖和用户福利，赠送 Token、体验额度或其他使用权益。活动时间、参与方式与发放规则以鸽子中转站公告为准，欢迎关注站内动态。
 
 <p align="center">
-  <code>兼容 OpenAI API</code> · <code>GPT-5.6 全系列</code> · <code>余额按量</code> · <code>日卡/月卡订阅</code>
+  <code>兼容 OpenAI API</code> · <code>GPT-6 / GPT-5.6</code> · <code>DeepSeek V4</code> · <code>余额按量</code> · <code>日卡/月卡订阅</code> · <code>不定期抽奖送 Token</code>
 </p>
 
 <p align="center">
@@ -227,8 +249,9 @@ $showcaseRepo = "C:\tools\dsh-showcase"
       </td>
       <td>
         <p><strong>稳定、透明、易接入的 AI API 中转服务，兼容 OpenAI API 格式。</strong></p>
-        <p>重点提供 GPT-5.6 全系列、Claude Opus 5、Fable 5 等模型，同时覆盖多种国产模型，适用于 AI 编程、客户端接入、日常对话、内容创作和图像生成等场景。</p>
-        <p>平台支持余额按量与订阅套餐两种方式，包含灵活的日卡、月卡方案；用户可以统一管理 API Key、模型调用、余额、用量和订阅权益，并查看模型价格、套餐权益、服务状态和详细接入文档。具体模型、价格及套餐权益以站内实时信息为准。</p>
+        <p>当前重点覆盖 GPT-6.1 Sol、GPT-6 Astra / Sol / Luna、GPT-5.6 全系列、GPT-5.5 / 5.4，Claude Opus 5、Fable 5、Sonnet 5，DeepSeek V4 Pro / Flash、Gemini、Grok，以及 Qwen、Kimi、GLM 等国产模型，适用于 AI 编程、Agent 工具调用、客户端接入、日常对话、内容创作和图像生成等场景。</p>
+        <p>平台支持余额按量与订阅套餐，提供日卡、月卡等灵活方案；用户可以统一管理 API Key、模型调用、余额、用量和订阅权益，并查看模型价格、服务状态与详细接入文档。模型列表、线路、价格和套餐权益会持续更新，最终以站内实时信息为准。</p>
+        <p><strong>不定期福利：</strong>站长会组织抽奖并赠送 Token、体验额度或其他使用权益，活动时间和参与规则以站内公告为准。</p>
       </td>
     </tr>
   </tbody>
@@ -264,12 +287,15 @@ $showcaseRepo = "C:\tools\dsh-showcase"
 
 | 检测到的文件 | 默认测试 |
 | --- | --- |
-| `package.json` 中存在 `scripts.test` | `npm test` |
+| `package.json` 中存在 `scripts.test` | 按锁文件选择 `pnpm test`、`yarn test`、`bun run test`，否则 `npm test` |
 | `pyproject.toml`、`pytest.ini`、`setup.cfg` 或 `requirements.txt` | `pytest -q` |
 | `Cargo.toml` | `cargo test` |
 | `go.mod` | `go test ./...` |
 | `pom.xml` | `mvn test` |
 | `gradlew.bat` | `gradlew.bat test` |
+| POSIX 系统的 `gradlew` | `./gradlew test` |
+
+混合技术栈会保留各语言的默认命令。自动检测只是初始建议，运行前请检查 `.showcase/config.json`，使用项目实际支持的、非 watch 模式的测试命令。
 
 测试也可以单独设置超时：
 
@@ -289,7 +315,7 @@ $showcaseRepo = "C:\tools\dsh-showcase"
 
 ## 截图证据
 
-CLI 会保留 `report.json` 中已经存在的截图记录，但不会自动启动浏览器截图。
+CLI 会保留 `report.json` 中已经存在的截图记录，但不会自动启动浏览器截图，也不会把旧截图时间更新成当前时间。建议先保存代码，再截图，最后运行 `capture` 并生成摘要。
 
 前端项目可以用 Playwright、浏览器验收工具或自己的截图脚本，把图片保存在目标项目内，再把记录加入 `report.json.screenshots`：
 
@@ -297,7 +323,6 @@ CLI 会保留 `report.json` 中已经存在的截图记录，但不会自动启
 {
   "id": "desktop-after",
   "label": "桌面完成态",
-  "theme": "frontier-signal",
   "viewport": {
     "name": "desktop",
     "width": 1440,
@@ -306,6 +331,8 @@ CLI 会保留 `report.json` 中已经存在的截图记录，但不会自动启
   "imagePath": "evidence/desktop-after.png",
   "capturedAt": "2026-08-20T10:00:00.000Z",
   "kind": "after",
+  "deviceScaleFactor": 1,
+  "captureMode": "viewport",
   "url": "http://localhost:4173/"
 }
 ~~~
@@ -313,22 +340,43 @@ CLI 会保留 `report.json` 中已经存在的截图记录，但不会自动启
 截图规则：
 
 - `imagePath` 必须位于目标项目内部；
-- `theme` 使用 `frontier-signal` 或 `blue-big-fish`；
-- 截图主题必须与 DSH 插件当前主题匹配；
+- 普通项目无需填写 `theme`，同一份证据可使用任意海报主题展示；
+- 只有明确区分本项目两套视觉版本时才填写 `theme`，跨主题记录会被隔离；
 - 缺失、过期、跨主题或不可读的截图不会被当成有效证据；
+- `capturedAt` 应为真实采集时间，不能晚于报告，也不能早于截图文件或已发现源码的修改时间（容差 2 秒）；
+- `viewport` 是浏览器 CSS 像素，`deviceScaleFactor` 是截图设备像素比；整屏用 `viewport`、整页用 `full-page`、局部裁剪用 `region`；
+- 实际图片尺寸必须与视口、像素比匹配。局部裁剪和 `before` 图片会单独标注，不能代替改版后整屏验收；
+- 可选 `sourceFingerprint` 记录截图时的 Git 工作区指纹，汇总时会与采集报告比对；
 - 没有可视界面的项目可以不提供截图。
 
-截图不是“随便放一张图片”：它必须属于目标项目、采集时间不能晚于报告、格式和尺寸必须可读，而且主题要和当前海报一致。跨主题截图会保留在报告里，但会从当前海报隔离出去。
+截图不是“随便放一张图片”：路径、格式、像素尺寸和时间都需要通过检查。缺少截图的视觉项目会标为待复核；检查说明同时出现在 Markdown 与 HTML。插件生成的海报最多嵌入 3 张有效截图，优先保留可配对的 Before / After，再补其他视口。
+
+前后对比要求页面 URL、视口尺寸、采集模式及图片比例一致，不能使用局部裁剪。当旧版与新版地址不同但确实是同一页面时，可以给两条记录设置相同的 `comparisonId`。没有可用配对就显示缺失状态。仓库终末地演示页附带 3 张当前视口截图和 1 张本轮修改前截图，不占用目标项目的采集记录。
 
 `frontier-signal` 是“终末地帝江号”的内部兼容键，不是第三套主题；普通用户只需要在 DSH 设置中选择中文主题名。
 
 ## 工具参数
 
+### 换到其他项目
+
+主题只改变交付报告，不会改写目标项目的界面，也不会把本仓库的示例截图、文件名或测试结果带过去。项目名、任务、Diff、测试回执和截图都来自目标项目自己的 `.showcase/report.json`。
+
+| 目标项目 | 报告如何展示 |
+| --- | --- |
+| 有界面的前端或静态站点 | 展示该项目的截图、文件改动与命令结果；缺少有效截图时提示复核 |
+| 后端、CLI 或库 | 保留变更与验证回执，明确说明截图非必需 |
+| 没有 Git 的目录 | 使用本地文件模式，不编造提交范围或 Diff，状态保留待复核 |
+| 测试失败或证据缺失 | 展示失败日志或缺失原因，不沿用演示页的成功结果 |
+
+在每个目标项目中分别执行 `init`，检查 `.showcase/config.json` 的任务和验证命令，再执行 `capture`；DSH 工具的 `projectPath` 指向这个目标项目。CLI 会根据常见项目标记提供默认命令，但测试环境和依赖需要在本机可运行；自定义构建系统、单体仓库子项目应填写自己的命令。插件不会自动证明任意项目已通过测试，也不会自动拍摄截图。
+
+### 调用参数
+
 工具名：`showcase_layout_summary`
 
 | 参数 | 必填 | 默认值或用途 |
 | --- | --- | --- |
-| `projectPath` | 是 | 目标项目根目录 |
+| `projectPath` | 是 | 目标项目根目录；相对路径基于 DSH 当前会话工作目录，无法获知会话目录时须传绝对路径 |
 | `reportPath` | 否 | `.showcase/report.json` |
 | `outputPath` | 否 | `.showcase/layout-summary.md` |
 | `posterPath` | 否 | `.showcase/layout-poster.html` |
@@ -363,6 +411,14 @@ CLI 会保留 `report.json` 中已经存在的截图记录，但不会自动启
 
 检查文件是否存在、路径是否位于目标项目内、`capturedAt` 是否早于图片修改时间，以及截图主题是否匹配。
 
+### 测试失败了，为什么原报告写着 completed？
+
+汇总会重新核对回执：非零退出码或失败测试优先标记失败；跳过测试、缺失视觉证据、时效警告会降为待复核。测试执行期间产生的新文件或修改会进入最终 Git 清单，并提示重新验证。
+
+### 提示输出被锁定怎么办？
+
+采集与产物生成使用 `.showcase/.write.lock` 串行写入，避免多个会话互相覆盖。正常完成或取消会释放锁；等待超过 30 秒会报错，不会抢占正在工作的进程。只有确认锁内记录的进程已经退出、没有其他采集任务时，才手动删除遗留锁再重试。损坏的既有 `report.json` 也不会被自动覆盖，应先备份并修正它。
+
 ### 可以用于非前端项目吗？
 
 可以。后端、CLI 和库项目不要求截图，仍可生成 Git 与测试回执。
@@ -371,19 +427,25 @@ CLI 会保留 `report.json` 中已经存在的截图记录，但不会自动启
 
 - 所有默认产物只写入目标项目的 `.showcase/`；
 - 没有远程上传步骤；
-- 常见 Token、Authorization、GitHub Token 格式和本机绝对路径会尝试脱敏；
+- 测试输出、命令和任务文案会尝试脱敏，包括常见 API Key、Basic/Bearer Authorization、Cookie 与 JSON Token；
 - 报告最大 2 MiB，单张截图最大 8 MiB、尺寸不超过 16384 px；
 - 每张海报最多嵌入 3 张有效截图；
 - 脱敏不是绝对保证，公开分享前仍需人工检查。
+- 路径限制会检查真实路径，拒绝通过符号链接或 Windows junction 写出项目边界；这不是执行任意测试命令的安全沙箱，只运行你信任的项目和配置。
+- 证据检查不是数字签名或完整浏览器渲染验证。源码自动发现最多 4000 个文件、8 层目录，不能替代完整依赖图分析；截图和人工验收仍由使用者负责。
 
 ## 从源码开发
 
+构建工具和 DSH `0.2` 插件运行时要求 Node.js `22.19+` 或 `24+`；建议使用 Node.js 24。DSH `0.1` 旧版运行时不再作为本版本的兼容目标。
+
 ~~~powershell
 npm ci
 npm run check
 npm run dev
 ~~~
 
+本地预览：`/?theme=dijiang` 为当前终末地主题，`/?theme=fish` 为蓝色大肥鱼。终末地演示页与插件导出共用渲染器；旧版保留在 `/?theme=dijiang&legacy=1` 供视觉对照，不用于新报告导出。
+
 主要目录：
 
 ~~~text
@@ -391,7 +453,7 @@ src/                  CLI、报告 schema、Git、命令和脱敏逻辑
 plugin/               DSH 插件、设置面板、摘要和海报生成器
 tests/                单元、跨项目、极端输入和产物测试
 docs/                 使用、上传、发布和预览素材
-.github/workflows/    Node 20/22 CI
+.github/workflows/    Windows/Linux，Node 20/22/24 CI
 ~~~
 
 维护文档：

package/README.zh-CN.md

@@ -6,7 +6,7 @@
 
 [打开 README.md](README.md)
 
-赞助商：**鸽子中转站（Pigeon API Relay）**。它兼容 OpenAI API 格式，提供 GPT-5.6 全系列、Claude Opus 5、Fable 5 等重点模型和多种国产模型，并支持余额按量、日卡/月卡订阅及统一权益管理；详情见主 README 快速开始后的赞助商区域。
+赞助商：**鸽子中转站（Pigeon API Relay）**。它兼容 OpenAI API 格式，当前重点覆盖 GPT-6、GPT-5.6、Claude Opus/Fable/Sonnet 5、DeepSeek V4、Gemini、Grok 及多种国产模型，并支持余额按量、日卡/月卡订阅及统一权益管理。站长还会不定期组织抽奖，赠送 Token、体验额度等福利；模型与活动详情以站内实时信息为准，完整介绍见主 README 快速开始后的赞助商区域。
 
 本项目提供两套主题：
 
@@ -15,6 +15,8 @@
 
 主题只在 DSH 插件设置里选择，目标项目不需要增加 `theme` 字段。
 
+当前兼容 DSH `0.2.0-rc.2` 及同一 0.2 系列。安装后从 DSH 侧栏进入 **插件**，打开 `dsh-showcase`，在 `dsh-showcase/plugin` 行点击 **配置**；Node.js 使用 `22.19+` 或 `24+`。旧版 DSH 0.1 不属于本版本的兼容目标。
+
 维护与发布相关文档：
 
 - [GitHub 上传与维护指南](docs/GITHUB_UPLOAD_GUIDE_ZH.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-showcase",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Local, verifiable delivery evidence reports for coding-agent work.",
   "type": "module",
   "main": "./plugin/client-host.js",
@@ -23,7 +23,7 @@
     "developer-tools"
   ],
   "engines": {
-    "node": ">=20"
+    "node": "^22.19.0 || >=24.0.0"
   },
   "packageManager": "npm@11.15.0",
   "publishConfig": {
@@ -41,11 +41,9 @@
     },
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-client-ui-settings",
-        "@deepseek-ai/dsh-client-ui-settings-plugins"
+        "@deepseek-ai/dsh-client-ui-plugin-manager"
       ],
       "platform": "web"
     }
@@ -58,7 +56,14 @@
     "plugin/layout-summary.d.ts",
     "plugin/layout-summary.js",
     "plugin/poster-html.js",
+    "plugin/dijiang-layout.js",
+    "plugin/dijiang-style.js",
+    "plugin/dijiang-motion.js",
+    "plugin/report-content.js",
     "plugin/report-schema.js",
+    "plugin/project-io.js",
+    "plugin/project-io.d.ts",
+    "plugin/redaction.js",
     "plugin/assets/dijiang-survey-surface.webp",
     "plugin/assets/whale-girl-keyvisual.webp",
     "cordis.patch.yml",
@@ -82,28 +87,26 @@
     "capture": "tsx src/cli/index.ts capture"
   },
   "dependencies": {
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6",
-    "@deepseek-ai/schemastery": "^3.18.1",
-    "zod": "latest"
+    "@deepseek-ai/schemastery": "^3.18.4",
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
-    "@deepseek-ai/cordis": "^4.0.1"
+    "@deepseek-ai/dsh-tools": "^0.2.0-rc.2",
+    "@deepseek-ai/cordis": "^4.0.4"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-tools": "^0.2.0-rc.2",
     "@types/node": "latest",
     "@types/react": "latest",
     "@types/react-dom": "latest",
     "@vitejs/plugin-react": "latest",
-    "jsdom": "latest",
     "lucide-react": "latest",
     "react": "latest",
     "react-dom": "latest",
     "tsx": "latest",
     "typescript": "latest",
     "vite": "latest",
-    "vitest": "latest"
+    "vitest": "^4.1.11"
   }
 }

package/plugin/client.js

@@ -6,9 +6,7 @@ window.__ModuleLoader__.load({
     const React = require("react");
     const { useEffect, useRef, useState } = React;
 
-const inject = ["slots", "locale", "connection"];
-
-const RPC_CHANNEL = "/showcase-layout-summary";
+const inject = ["slots", "locale"];
 const LOCALE_NAMESPACE = "showcase.layoutSummary.settings";
 const STYLE_ID = "dsh-showcase-settings-style";
 const THEME_VALUES = ["frontier-signal", "blue-big-fish"];
@@ -16,6 +14,7 @@ const THEME_VALUES = ["frontier-signal", "blue-big-fish"];
 const messages = {
   zh: {
     title: "布局证据产物",
+    summary: "配置布局证据产物的海报主题与生成策略。",
     description: "先完成采集与测试，再在交付或视觉审核节点生成摘要；海报是可选的重产物。",
     legend: "海报风格",
     dijiang: "终末地帝江号",
@@ -32,9 +31,11 @@ const messages = {
     failed: "保存失败，请重试。",
     loading: "正在读取插件设置…",
     unavailable: "插件设置服务当前不可用。",
+    retry: "重新连接",
   },
   en: {
     title: "Layout evidence artifacts",
+    summary: "Configure the poster theme and generation policy for layout evidence.",
     description: "Capture and test first, then generate at the delivery or visual-review checkpoint. The poster is optional and heavier.",
     legend: "Poster theme",
     dijiang: "Dijiang",
@@ -51,6 +52,7 @@ const messages = {
     failed: "Could not save the setting. Try again.",
     loading: "Loading plugin settings…",
     unavailable: "Plugin settings are currently unavailable.",
+    retry: "Reconnect",
   },
 };
 
@@ -122,42 +124,48 @@ function installStyles() {
   document.head.append(tag);
 }
 
-function createThemeCard(rpc) {
-  return function ThemeCard({ t }) {
+function createThemeCard() {
+  return function ThemeCard({ t, form, view }) {
+    if (view === "summary") return React.createElement("span", { className: "dsh-showcase-settings__summary" }, t("summary"));
     const [theme, setTheme] = useState();
     const [generatePoster, setGeneratePoster] = useState(false);
     const [loadState, setLoadState] = useState("loading");
     const [saveState, setSaveState] = useState("idle");
+    const [loadAttempt, setLoadAttempt] = useState(0);
+    const [writable, setWritable] = useState(false);
     const mountedRef = useRef(true);
     const savingRef = useRef(false);
     const choiceRefs = useRef({});
     useEffect(() => {
       let active = true;
       mountedRef.current = true;
-      rpc.call(RPC_CHANNEL, "get", {}).then((result) => {
+      setLoadState("loading");
+      const sync = () => {
         if (!active) return;
-        const value = result.ok ? result.value : undefined;
+        const snapshot = form?.state;
+        const value = snapshot?.value;
         const validTheme = value?.theme === "frontier-signal" || value?.theme === "blue-big-fish";
         const validPosterSetting = value?.generatePoster === undefined || typeof value?.generatePoster === "boolean";
         if (validTheme && validPosterSetting) {
           setTheme(value.theme);
           if (typeof value.generatePoster === "boolean") setGeneratePoster(value.generatePoster);
-          setLoadState("ready");
+          setWritable(snapshot.writable === true);
+          setLoadState(snapshot.status === "ready" ? "ready" : "unavailable");
         } else {
+          setWritable(false);
           setLoadState("unavailable");
         }
-      }).catch(() => {
-        if (active) setLoadState("unavailable");
-      });
+      };
+      sync();
       return () => {
         active = false;
         mountedRef.current = false;
       };
-    }, []);
+    }, [form, form?.state, loadAttempt]);
 
     if (loadState !== "ready") {
       const loading = loadState === "loading";
-      return React.createElement("li", {
+      return React.createElement("div", {
         className: "dsh-showcase-settings",
         "data-load-state": loadState,
         "aria-busy": loading,
@@ -168,7 +176,12 @@ function createThemeCard(rpc) {
             className: "dsh-showcase-settings__description",
             role: "status",
             "aria-live": "polite",
-          }, t(loadState))),
+          }, t(loadState)),
+          !loading && React.createElement("button", {
+            type: "button",
+            className: "dsh-showcase-settings__choice",
+            onClick: () => setLoadAttempt((attempt) => attempt + 1),
+          }, t("retry"))),
         loading && React.createElement("div", { className: "dsh-showcase-settings__body", "aria-hidden": true },
           React.createElement("div", { className: "dsh-showcase-settings__loading-choices" },
             ...THEME_VALUES.map((value) => React.createElement("div", {
@@ -184,25 +197,18 @@ function createThemeCard(rpc) {
             React.createElement("div", { className: "dsh-showcase-settings__loading-switch" }))));
     }
 
-    const disabled = saveState === "saving";
+    const disabled = saveState === "saving" || !writable;
     const save = async (patch, rollback = () => {}) => {
-      if (savingRef.current) return;
+      if (savingRef.current || !form?.mutate) return;
       savingRef.current = true;
       setSaveState("saving");
       try {
-        const result = await rpc.call(RPC_CHANNEL, "set", patch);
+        const snapshot = form.state;
+        const operations = Object.entries(patch).map(([path, value]) => ({ op: "set", path: [path], value }));
+        const accepted = await form.mutate(operations, snapshot.revision);
         if (!mountedRef.current) return;
-        const value = result.ok ? result.value : undefined;
-        const validTheme = value?.theme === "frontier-signal" || value?.theme === "blue-big-fish";
-        const validPosterSetting = value?.generatePoster === undefined || typeof value?.generatePoster === "boolean";
-        if (validTheme && validPosterSetting) {
-          setTheme(value.theme);
-          if (typeof value.generatePoster === "boolean") setGeneratePoster(value.generatePoster);
-          setSaveState("saved");
-        } else {
-          rollback();
-          setSaveState("failed");
-        }
+        if (!accepted) throw new Error("The configuration was rejected.");
+        setSaveState("saved");
       } catch {
         if (mountedRef.current) {
           rollback();
@@ -262,7 +268,7 @@ function createThemeCard(rpc) {
             ? t("failed")
             : "";
 
-    return React.createElement("li", {
+    return React.createElement("div", {
       className: "dsh-showcase-settings",
       "data-save-state": saveState,
       "aria-busy": disabled,
@@ -312,11 +318,10 @@ function createThemeCard(rpc) {
 function apply(ctx) {
   installStyles();
   ctx.effect(() => ctx.locale.register(LOCALE_NAMESPACE, messages), "dsh-showcase: settings locale");
-  const ThemeCard = createThemeCard(ctx.get("connection").rpc);
-  ctx.slots.inject("settings.plugin.item", () => ctx.slots.register({
-    name: "settings.plugin.item",
-    id: "showcase-layout-summary",
-    order: 30,
+  const ThemeCard = createThemeCard();
+  ctx.slots.inject("plugins.row.config", () => ctx.slots.register({
+    name: "plugins.row.config",
+    key: "dsh-showcase#showcase-layout-summary",
     locale: LOCALE_NAMESPACE,
   }, ThemeCard));
 }