DeepSeek Harness 插件

Lucky020/dsh-delivery-kit

Star 数 ★ 0 下载量(近 30 天) 2,494 分类 文档与渲染 收录于 2026-11-02 npm dsh-delivery-kit

把代码仓库与运行中的系统变成验收材料:数据库设计、概要设计、详细设计、带截图的使用说明书,以及测试报告、上线报告、验收报告。章节按 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

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。