dsh-showcase

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

dsh-showcase 是一个本地运行的 DSH 插件。它读取目标项目的 Git 改动、测试回执和可选截图，生成 Markdown 摘要与自包含 HTML 海报。

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

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

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

先看效果

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

你需要什么

• 必须：已经可以运行的 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 读取新项目，按下面三步操作。

它能帮你做什么

支持前端、后端、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 分钟快速开始

dsh plugin --profile web add dsh-showcase

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"

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

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

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

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

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

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

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

$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 生态中被发现

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 官方命令安装：

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

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

赞助商

介绍

鸽子中转站

稳定、透明、易接入的 AI API 中转服务，兼容 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、体验额度或其他使用权益，活动时间和参与规则以站内公告为准。

最省事的用法

安装插件后，也可以让有终端权限的 DSH Agent 完成采集和汇总。把下面这段话里的工具目录改成你的实际路径：

使用 C:\tools\dsh-showcase 的 CLI 检查当前项目。如果没有 .showcase/config.json，先执行 init 并让我确认测试命令；然后执行 capture，最后调用 showcase_layout_summary 生成中文 Markdown 和 HTML 海报。不要上传任何项目文件。

这样用户只需要确认测试命令，不需要手动编写工具参数。

生成了哪些文件

本仓库已经默认忽略 .showcase/。其他项目也建议把它加入 .gitignore：

.showcase/

测试命令如何确定

init 会根据项目文件尝试填写默认测试：

混合技术栈会保留各语言的默认命令。自动检测只是初始建议，运行前请检查 .showcase/config.json，使用项目实际支持的、非 watch 模式的测试命令。

测试也可以单独设置超时：

{
  "tests": [
    "npm test",
    {
      "command": "pytest -q",
      "timeoutMs": 180000
    }
  ]
}

没有识别到测试时仍会生成报告，但状态会是 partial。

截图证据

CLI 会保留 report.json 中已经存在的截图记录，但不会自动启动浏览器截图，也不会把旧截图时间更新成当前时间。建议先保存代码，再截图，最后运行 capture 并生成摘要。

前端项目可以用 Playwright、浏览器验收工具或自己的截图脚本，把图片保存在目标项目内，再把记录加入 report.json.screenshots：

{
  "id": "desktop-after",
  "label": "桌面完成态",
  "viewport": {
    "name": "desktop",
    "width": 1440,
    "height": 900
  },
  "imagePath": "evidence/desktop-after.png",
  "capturedAt": "2026-08-20T10:00:00.000Z",
  "kind": "after",
  "deviceScaleFactor": 1,
  "captureMode": "viewport",
  "url": "http://localhost:4173/"
}

截图规则：

• imagePath 必须位于目标项目内部；
• 普通项目无需填写 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。

在每个目标项目中分别执行 init，检查 .showcase/config.json 的任务和验证命令，再执行 capture；DSH 工具的 projectPath 指向这个目标项目。CLI 会根据常见项目标记提供默认命令，但测试环境和依赖需要在本机可运行；自定义构建系统、单体仓库子项目应填写自己的命令。插件不会自动证明任意项目已通过测试，也不会自动拍摄截图。

调用参数

工具名：showcase_layout_summary

特殊项目结构示例：

{
  "projectPath": "C:/work/your-project",
  "appPath": "src/client/App.tsx",
  "cssPath": "src/client/styles.css",
  "locale": "zh-CN",
  "generatePoster": false
}

常见问题

为什么没有生成 HTML 海报？

检查插件设置中的海报开关，或在本次调用中传入 "generatePoster": true。Markdown 默认仍会生成。

为什么状态是 partial？

采集阶段通常是没有 Git 或没有可运行的测试命令；汇总阶段还可能额外提示截图缺失或过期。partial 的含义是“可以继续审查，但证据不完整”，不是程序崩溃。

为什么截图没有出现在海报里？

检查文件是否存在、路径是否位于目标项目内、capturedAt 是否早于图片修改时间，以及截图主题是否匹配。

测试失败了，为什么原报告写着 completed？

汇总会重新核对回执：非零退出码或失败测试优先标记失败；跳过测试、缺失视觉证据、时效警告会降为待复核。测试执行期间产生的新文件或修改会进入最终 Git 清单，并提示重新验证。

提示输出被锁定怎么办？

采集与产物生成使用 .showcase/.write.lock 串行写入，避免多个会话互相覆盖。正常完成或取消会释放锁；等待超过 30 秒会报错，不会抢占正在工作的进程。只有确认锁内记录的进程已经退出、没有其他采集任务时，才手动删除遗留锁再重试。损坏的既有 report.json 也不会被自动覆盖，应先备份并修正它。

可以用于非前端项目吗？

可以。后端、CLI 和库项目不要求截图，仍可生成 Git 与测试回执。

安全与边界

• 所有默认产物只写入目标项目的 .showcase/；
• 没有远程上传步骤；
• 测试输出、命令和任务文案会尝试脱敏，包括常见 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 旧版运行时不再作为本版本的兼容目标。

npm ci
npm run check
npm run dev

本地预览：/?theme=dijiang 为当前终末地主题，/?theme=fish 为蓝色大肥鱼。终末地演示页与插件导出共用渲染器；旧版保留在 /?theme=dijiang&legacy=1 供视觉对照，不用于新报告导出。

主要目录：

src/                  CLI、报告 schema、Git、命令和脱敏逻辑
plugin/               DSH 插件、设置面板、摘要和海报生成器
tests/                单元、跨项目、极端输入和产物测试
docs/                 使用、上传、发布和预览素材
.github/workflows/    Windows/Linux，Node 20/22/24 CI

维护文档：

• 贡献指南
• 安全策略
• 发布检查清单
• GitHub 上传与维护指南
• 演示素材授权说明

许可证

源代码和普通仓库文件使用 MIT，详见 LICENSE。演示角色、照片和主题截图不自动包含在 MIT 授权中，详见 CHARACTER_ASSET_NOTICE.md。