dsh-delivery-kit
Manifest validTurns a repository and a running system into acceptance material - database design, design specs, a user manual with screenshots, and test / go-live / acceptance reports. Sections follow GB/T 8567-88;
dsh-delivery-kit · 交付工坊
把代码仓库 + 运行中的系统变成系统验收材料。DeepSeek Harness 插件,本地运行,不上传代码。
8 份文档:数据库设计 / 概要设计 / 详细设计 / 使用说明书 / 测试报告 / 上线报告 / 验收报告 / 技术协议
它替你干的三件苦力活
| 你平时怎么做 | 装了之后 |
|---|---|
| 翻菜单、截图、记路由,整理功能清单 | 从系统/代码自动取,35 条页面 + 路由一次到位 |
| 使用说明书 30+ 张截图,一张张截、一张张排版 | 打开系统自动逐页截图,按章节插图 |
| 记不住国标要求哪几章(GB/T 8567-88) | 骨架按国标走,缺章自己补不上 |
它不干的:正文词句还是模板话,业务内容得你自己写进去——这一点不吹。
能生成哪些文档
| 文档 | 自动化 | 需要你提供 |
|---|---|---|
| 数据库设计文档 | 95% | — |
| 概要设计说明书 | 70% | 架构取舍(可选) |
| 详细设计说明书 | 60% | 关键流程(可选) |
| 技术协议 | 10% | 合同范围 / 性能指标 / 验收标准 |
| 测试报告 | 30% | 测试环境、真实执行结果 |
| 上线报告 | 30% | 上线时间、参与人 |
| 验收报告 | 40% | 合同号、验收日期、结论、签认 |
| 使用说明书 | 50% | 界面截图(系统在跑可自动截) |
用法
delivery_catalog 先问:能生成哪些、每份要什么材料、项目规模多大
↓ 用户挑
delivery_doc 逐份生成;材料缺了就返回 missing,不替你编
核心约定:代码里没有的事实,工具不写。数量(功能数/字段数)、结论(测试通过/验收符合)一律留「待填写 / 待验证」。
数据库结构从哪来
数据库设计文档的质量取决于能不能拿到真实表结构。三条路,按推荐排序:
| 方式 | 需要你给 | 能拿到 |
|---|---|---|
| ① 建表 SQL(推荐) | 一份 .sql 文件 | 表名、字段、真实类型、可空、默认值、注释 |
| ② 字段清单 | .csv / .tsv / Excel 另存 | 同上(手动整理,最省事) |
| ③ 结构 JSON | .json | 同上 |
| ④ 只读连接 | 连接串(多数场景拿不到) | 同上,自动 |
| ⑤ 扫代码模型 | 无 | 仅模型字段名,类型靠推断,没有注释 |
不需要数据库账号:一条 mysqldump --no-data 或 pg_dump --schema-only,或者从 Navicat/DBeaver 右键「DDL」,就能拿到建表 SQL。
// schema_path 文件格式
{ "tables": [ { "name": "banqian_xieyi", "comment": "搬迁补偿协议",
"fields": [ { "name": "xieyi_no", "type": "varchar(64)", "nullable": false, "comment": "协议编号" } ] } ] }
支持 PostgreSQL 与 MySQL,只读 information_schema,不做任何写操作。
使用说明书的截图
- 系统在运行:给
base_url+ 页面清单,自动 headless 截图并插图 - 系统没运行:返回提示,由你后期手动补图
安装
dsh plugin --profile web add github:Lucky020/dsh-delivery-kit
装完重启 dsh web。
依赖
| 用途 | 依赖 |
|---|---|
| 文档渲染 | python3 + python-docx |
| 自动截图 | Google Chrome(或 DSH_COPYRIGHT_CHROME 指定路径) |
python3 -m pip install python-docx
篇幅原则
篇幅由内容决定,不灌水:材料齐的按 25 页标准写;材料缺的该省就省,文档自然变短,不拿通用章节凑页数。
与 dsh-copyright-kit 的关系
两者独立:软著工坊出软著登记材料(源程序 + 说明书),交付工坊出验收材料(设计/测试/上线/验收/协议)。渲染引擎各自内置,互不依赖。
MIT
Comments
Loading…
Similar plugins
Turns a one-line DSH draft into a complete task brief (role / goal / constraints / output format). The engine is a byte-verified port of linshenkx/prompt-optimizer (three modes, 10 templates identical
★ 0
dsh plugin --profile web add @benrong/dsh-prompt-polishby HuanLinOTO
暴露 run_python/run_node 工具,通过 stdin 执行代码返回 stdout/stderr/exit,含解释器路径配置卡 | Exposes run_python/run_node tools that execute code via stdin and return stdout/stderr/exit, with interpreter-path config card
★ 10
↓ 243/wk
NOASSERTION
JavaScript
Oct 18, 2026
dsh plugin --profile web add @huanlin/dsh-plugin-interpretersby huangfuren
把本机 dsh 配置同步到另一台机器:导出可移植 bundle(settings / 凭据(可选) / 插件源码 / profile 清单)并生成自安装 apply.ps1。接收方无需装 dsh-sync,跑一次脚本即可继续用 dsh。
★ 0
MIT
JavaScript
Oct 26, 2026
dsh plugin --profile web add dsh-syncby dingchenhui0618-arch
A delivery receipt panel for a project hand-off. One trigger collects the branch and commit, the test and build results, screenshot dimensions with sha256, and the secret-scan verdict, then assigns ev
★ 0
MIT
JavaScript
Oct 27, 2026
dsh plugin --profile web add dsh-delivery-receiptby zz12hui
DSH 工具插件:上传 GitHub 前把仓库 README 按统一版式优化——10 种首图风格随机配色、过程图生成、排版校验、带重试推送。
★ 2
MIT
Python
Oct 26, 2026
dsh plugin --profile web add dsh-local-github-readmeby dingchenhui0618-arch
A shareable delivery receipt for a project hand-off. The `ship_receipt` tool measures what it can and records what it was told, then sorts every line into three zones: verified (evidence this run prod
★ 0
MIT
JavaScript
Oct 27, 2026
dsh plugin --profile web add dsh-ship-receipt