把代码仓库与运行中的系统变成验收材料:数据库设计、概要设计、详细设计、带截图的使用说明书,以及测试报告、上线报告、验收报告。章节按 GB/T 8567-88 组织,无法核实的字段与结论一律留空,不编造。需 Python 3 与 python-docx 生成 .docx,自动截图需 Google Chrome。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-delivery-kit
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:Lucky020/dsh-delivery-kit
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
把代码仓库 + 运行中的系统变成系统验收材料。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
链接
同类插件
tt-a1i/archify#integrations/deepseek-harness★ 92724
从仓库或系统描述生成经过校验的自包含交互式架构图、流程图、时序图、数据流图和生命周期图。
dream-num/dsh-univer-office★ 657
为 DeepSeek Harness 打造一个真正的办公环境。Univer Office 插件将电子表格、文档、幻灯片、画布、多维表格等汇聚到同一个运行时——数据互联、修改经过校验、变更按版本管理,并以隔离工作树支持多 Agent 协作。
ECNU/EduWork#dsh-knowledge-studio★ 275
基于工作区资料的 Studio,复用 DSH 模型与共享成果服务,制作报告、演示文稿、表格、思维导图、测验、闪卡及音视频。Office 生成需 Python 3.12+ 及相关依赖,并配置 DSH_OFFICE_PYTHON;媒体渲染需 Chromium;本地语音转写另需 whisper.cpp 和模型。
PerryLink/dsh-industry-research★ 215
面向 DeepSeek Harness 的确定性行业研究报告:公司与行业研究流程基于分阶段证据产出结构化、可核验的报告。
HuanLinOTO/dsh-plugin-mineru★ 51
向模型暴露 MineRU 文档解析工具。
PolinniZhong/dsh-knit★ 48
把会话工作区里已有的 Markdown 文档、源码、图片与视频列进 DSH 侧边栏,按与当前对话的相关性排序。默认的词法模式用最近几条消息在本地与标题、摘要、正文做带 IDF 加权的匹配(BM25)—— 不调用模型、没有网络出口,内容不出本机。列表来自工作区扫描,而不是「最近打开记录」,所以重启 DSH 或新开会话都不会变空。排序结果组织成主要 / 辅助 / 相关三层的阅读顺序,每一条都写明可核验的理由(命中了哪个字段、被哪一篇引用),点一行即可就地预览:Markdown 按渲染后的样子显示、相对路径图片真实渲染、源码走宿主自带的语法高亮、视频走 HTTP Range 流式播放。同一份 Context Pack 也作为 knit_docs 工具交给 agent。后续版本陆续补上读取证据与生命周期(归因在读那一刻冻结)、固定 / 排除(排除先于检索生效,且可恢复)、关系证据(引用 / 导入 / 测试,带行号)与增量索引(重启后复用)。v0.23 起还多一条可选的混合检索:默认关闭,只有你自己配好 Ollama 或 OpenAI 兼容的 embedding 服务才会生效。它生效时,发出去的是你这句查询原话加上每篇候选文件的标题与摘要 —— Markdown 的摘要取自正文首段(不超过 60 字),代码的摘要是它所在的工作区相对目录,图片 / 视频贡献的是文件名;完整正文与绝对路径都不发送,指向本机服务(loopback)时内容不出这台机器。v0.24 起还能做变更关联:用一条只读的 git status(固定 argv、不走 shell、子进程环境白名单),配合同一套引用 / 导入 / 测试 / 提及证据,指出这次改动大概率该一起看哪些文件 —— 默认关闭。语义检索的收益仍待真 provider 实测,因此不承诺召回提升。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。