dsh-showcase

dsh-showcase

把编程 Agent 的改动和测试结果，整理成可核验的中文交付报告。

dsh-showcase 提供 DSH 插件和免费通用 Skill 两种入口。它读取目标项目的 Git 改动、测试回执和可选截图，生成 Markdown 摘要与自包含 HTML 海报。

它不会上传项目文件，也不会把目标项目的数据写回本仓库。

本项目是社区工具，不是 DeepSeek、DSH 或《终末地》的官方产品。主题名仅描述视觉风格，不代表官方授权。演示素材说明见 CHARACTER_ASSET_NOTICE.md。

目录： 功能 · 快速开始 · 赞助商 · 产物 · 截图 · 工具参数 · 边界与安全 · 开发

先看效果

这是一个 DSH 插件 + 本地采集 CLI，不是只展示截图的主题包。插件负责把证据整理成摘要和海报；CLI 负责在任意目标项目中采集 Git 与测试回执。

以下图片于 2026-10-17 从当前界面源码重新采集。v0.1.8 包含这批双主题界面、鲸鱼娘互动和导出修复；安装或升级使用 dsh plugin --profile web add dsh-showcase@0.1.8，重新加载插件并生成新报告即可生效。更新内容见 v0.1.8 发布公告。截图中的“演示状态：待复核”仅标识演示报告，不代表插件开发进度；正式使用时仍按真实任务结果显示。

终末地帝江号（机械工业 / 等高线 / 黄黑校准）

终末地主题采用深色工业首屏与浅色证据正文，搭配大字标题、信号黄、等高线和细分隔线。阶段导航在桌面位于左侧，在手机移至顶部；变更档案、验证回执和界面截图按阅读顺序展开。深色加载页以旋转仪表和信号色横向扫幕进入报告。右上角可切换明暗、谷地黄 / 武陵青、动效及背景帧率上限。这些是社区主题设计，预览中的演示数据不代表目标项目已通过验证。

蓝色大肥鱼（Q 版鲸鱼娘 / 任务联动 / 蓝白黄）

鲸鱼娘与任务说明、状态和统计融在同一条内容带里：完成时抬头、待复核时专注、失败时伏下。鼠标靠近任务或统计时会轻微转向并回应，点击角色可打开相关验证回执或交付产物，也支持键盘和触屏。右上角“动态回应”默认尊重系统减少动效偏好；关闭后仍保留真实状态表情。角色图片和互动脚本内嵌在 HTML 中，离线打开也可使用。

你需要什么

不使用 DSH？ 直接安装下方免费 Skill，只需要支持本地终端的 Agent 和 Node.js，无需启动 DSH、API Key 或安装 npm 依赖。以下 DSH 要求仅适用于插件入口。

• 必须：已经可以运行的 DSH Web 环境（当前插件兼容 DSH 0.2.0-rc.2 及同一 0.2 系列）；
• 必须：Node.js 22.19+ 或 24+ 和 npm，用于安装本仓库及运行采集 CLI；
• 可选：Git。没有 Git 时仍会生成报告，但状态会明确标为 partial；
• 可选：Playwright 或其他浏览器验收工具。截图不是后端、CLI、库项目的必需项。

如果你只想查看海报，可以直接打开已经生成的 .showcase/layout-poster.html；如果你要让 DSH 读取新项目，按下面三步操作。

它能帮你做什么

你现在要做的事 · dsh-showcase 的输出 向别人说明这次改了什么 · Git 文件清单、增删行统计、当前引用；终末地报告可切换文件查看保留的逐行 Diff 证明测试确实运行过 · 测试命令、退出码、耗时和脱敏后的输出 检查桌面和移动端界面 · 最多 3 张经过路径、时间和主题校验的截图 给交付结果做归档 · Markdown 摘要和可独立打开的 HTML 海报 证据还不完整 · 明确标记 partial 或 failed，不会伪装成功

支持前端、后端、CLI、Node.js、Python、Rust、Go、Java、库和静态 HTML 项目。

终末地 HTML 还包含任务耗时、增删总量、脱敏分类明细，以及 HTML / JSON / Markdown 下载。同页同视口的 Before / After 截图可用滑块对比。JSON 是脱敏后的报告数据，不包含图片二进制；HTML 内嵌图片，可以离线查看和操作。

capture 会为前 20 个变更文件尝试采集文本 Diff，每份最多保留 16,000 个字符并标注截断。二进制、未跟踪、超大或无法读取的文件只保留明确的缺失说明；旧报告没有 Diff 时不会生成假差异。补丁仍需人工复核后再对外分享。

工作流只有一条：

目标项目 → init 配置 → capture 采集 → report.json → DSH 工具 → Markdown / HTML

5 分钟快速开始

免费 Skill：无需 DSH

适用于能读取 SKILL.md、运行本地终端的 Agent，例如 Codex、Claude Code 或 Cursor。各客户端的安装目录不同，请使用该客户端的本地 Skill 安装功能；不支持终端的纯聊天环境不能直接执行采集。

1. 从 Skill v1.0.0 发布页下载 ZIP，解压后将完整的 dsh-showcase 文件夹安装到 Agent 的 Skill 目录，不要只复制 `SKILL.md`。
2. 确认 Node.js 22.19+ 或 24+。运行包已包含依赖，不需要 npm install，也不需要 DSH 服务。
3. 对 Agent 说：“使用 dsh-showcase，为当前项目生成可核验的交付报告。先检查配置的测试命令，保留失败和缺失证据；使用鲸鱼娘主题和中文。”

Skill 会先展示测试计划，经确认在任务授权范围内再采集；失败测试仍可生成报告。输出在目标项目的 .showcase/，两种主题均可选。报告不会自动上传，分享前仍需人工检查敏感信息。

查看 Skill 源码与使用流程 · 证据配置与状态规则。Skill 使用独立版本号 1.0.0，当前复用插件 0.1.8 引擎，不改变 npm 插件版本。

源码开发者可执行 npm ci 和 npm run skill:build，在 output/skills/ 得到完整 ZIP 与校验文件。仓库中的 skills/dsh-showcase/ 是说明源文件，运行脚本由构建步骤生成；直接使用请下载发行 ZIP。

DSH 插件

第一步：安装插件

插件运行时已发布到 npm。推荐优先使用 npm 安装插件；如果需要运行采集 CLI 或参与开发，再从 GitHub 源码安装完整仓库。

~~~powershell dsh plugin --profile web add dsh-showcase ~~~

如果你需要同时使用采集 CLI，继续按下面的源码方式安装。仓库放在固定目录后，DSH 插件和采集 CLI 可以共用同一份代码。

~~~powershell Set-Location C:\tools git clone https://github.com/DoveLi-Gu/dsh-showcase.git Set-Location .\dsh-showcase npm ci dsh plugin --profile web add "C:\tools\dsh-showcase" ~~~

然后重启 dsh web，再新建一个会话。若命令提示 dsh 不存在，先安装并确认 DSH CLI 已加入 PATH；这不是本插件自身的安装错误。

打开 DSH 侧栏的 插件，进入 dsh-showcase，点击组件 dsh-showcase/plugin 的 配置，找到 布局证据产物。这里可以选择：

• 终末地帝江号：机械工业、密集等高线和黄黑校准色；
• 蓝色大肥鱼：浅蓝背景、角色主视觉和钴蓝强调；
• 生成自包含 HTML 海报：关闭时只生成 Markdown，开启后同时生成 HTML。

主题只在插件设置中选择，目标项目不需要增加主题字段。

npm 包说明：插件入口可以使用 dsh plugin --profile web add dsh-showcase 安装。不要使用 npm install --global dsh-showcase：npm 包提供的是 DSH 插件运行时，不是全局 CLI。采集 CLI 仍按上面的 GitHub 源码目录运行。

第二步：在目标项目采集证据

进入你真正要检查的项目：

~~~powershell Set-Location C:\work\your-project $showcaseRepo = "C:\tools\dsh-showcase"

& "$showcaseRepo\node_modules.bin\tsx.cmd" ` "$showcaseRepo\src\cli\index.ts" init ~~~

这会创建 .showcase/config.json。打开它，确认任务目标和测试命令：

~~~json { "task": "完成用户设置页并通过回归测试", "baseRef": "HEAD~1", "timeoutMs": 120000, "tests": [ "npm test", "npm run build" ] } ~~~

然后执行采集：

~~~powershell & "$showcaseRepo\node_modules.bin\tsx.cmd" ` "$showcaseRepo\src\cli\index.ts" capture ~~~

采集完成后，目标项目中会出现：

~~~text .showcase/ ├─ config.json # 任务目标、Git 基准、测试和超时 └─ report.json # Git 改动、测试回执、截图记录和脱敏统计 ~~~

init 只需执行一次。如果 config.json 已存在，直接编辑后运行 capture。

第三步：让 DSH 生成报告

回到这个目标项目的 DSH 会话，直接发送：

请调用 showcase_layout_summary，以当前项目为 projectPath，读取 .showcase/report.json 并生成中文交付摘要。本次需要 HTML 海报，请把 generatePoster 设为 true。

等价的工具参数：

~~~json { "projectPath": ".", "locale": "zh-CN", "generatePoster": true } ~~~

projectPath 是唯一必填参数。默认输出：

~~~text .showcase/layout-summary.md .showcase/layout-poster.html ~~~

只想生成 Markdown 时，将 generatePoster 设为 false，或关闭插件设置里的海报开关。

补充：最小可用命令

如果你不需要自定义任务，下面是一次完整的最短流程（在目标项目目录执行）：

~~~powershell $showcaseRepo = "C:\tools\dsh-showcase" & "$showcaseRepo\node_modules.bin\tsx.cmd" "$showcaseRepo\src\cli\index.ts" init & "$showcaseRepo\node_modules.bin\tsx.cmd" "$showcaseRepo\src\cli\index.ts" capture ~~~

随后在 DSH 会话中调用 showcase_layout_summary。init 只执行一次；以后每次改完代码、测试和截图后，只需要重新执行 capture，再重新生成摘要。

在 DSH 生态中被发现

DeepSeek Harness 官方目前没有单独的插件提交审核页面；官方仓库建议插件作者给 GitHub 仓库添加 dsh-plugin Topic，用于社区发现。本仓库已经配置 dsh-plugin、deepseek-harness、dsh 和 cordis 等主题标签。

本包已经补齐 DSH 目录通常需要的 engines.dsh 兼容范围、package.json.icon、中英文 locale 元数据和公开 npm 构建产物。部分社区插件目录会定期扫描 dsh-plugin Topic，并根据公开仓库的 package.json、dsh.bundle.patch、入口文件和版本信息生成卡片。收录通常存在延迟，目录属于社区项目，不代表 DeepSeek 官方背书；用户仍可直接使用 DSH 官方命令安装：

~~~powershell dsh plugin --profile web add dsh-showcase ~~~

• 官方生态说明：DeepSeek Harness
• 社区目录示例（均为非官方项目）：dsh-market、dsh-plugin-marketplace、dsh-plugins-store
• 社区展示与反馈：DeepSeek Harness 仓库的 Show Your Plugins Discussions

想让更多人找到这个插件，建议按下面顺序维护：

1. 保持 GitHub 仓库公开，并保留 dsh-plugin Topic、安装命令、兼容版本和真实截图。
2. 每次发布同步更新 npm 包、CHANGELOG.md 和 GitHub tag；插件商店一般读取公开 npm 包和仓库元数据。
3. 在官方 Show Your Plugins 讨论区发布一段简短介绍，或向对应的社区目录提交收录请求；目前没有统一的官方插件商店提交按钮。

本项目不会声称已经被任何社区目录收录。目录由各自的扫描、审核和缓存策略决定，提交后可能需要等待下一次同步。

赞助商

项目主赞助 鸽子中转站 · Pigeon API Relay 稳定、透明、易接入的 AI API 中转服务

鸽子中转站（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、模型调用、余额、用量和订阅权益，并查看模型价格、服务状态与详细接入文档。模型列表、可用线路、价格和套餐权益会随站内运营持续更新，最终以鸽子中转站实时信息为准。

站长也会不定期组织抽奖和用户福利，赠送 Token、体验额度或其他使用权益。活动时间、参与方式与发放规则以鸽子中转站公告为准，欢迎关注站内动态。

兼容 OpenAI API · GPT-6 / GPT-5.6 · DeepSeek V4 · 余额按量 · 日卡/月卡订阅 · 不定期抽奖送 Token

创建账户 · 模型与价格 · 订阅套餐 · 接入文档 · 服务状态