dsh-dev-delivery
DiscoveredDSH Development Delivery Plugin and Skill: Turning "looks like it works" code delivery into "has commands, has exit codes, has file fingerprints that prove it works." Forcing two independent risk reviews.
DSH 开发交付助手 0.2.3
适用:Windows DSH Desktop 2.0.18 / Harness 0.2.1-rc.2。其他版本需另行验证。
这个包包含插件和 Skill。插件记录计划、执行结果和文件指纹;Skill 引导 DeepSeek 分步开发、主动寻找遗漏风险、先复现后修复、保留回归测试并准确交付。它不会改变模型权重,也不保证达到其他模型水平或找出全部 bug。
开始使用
安装后,在项目工作目录的新聊天中说:
使用 dsh-dev-delivery,帮我从零开发这个项目。先明确需求和可验证的完成条件,跑通一条功能后逐步扩展。完成前主动检查已有测试未覆盖的风险,先复现并确认问题,再修复、保留回归测试和重新验收。交付源码、启动说明、实际结果和未验证部分。
已有项目要它主动检查,可说:
使用 dsh-dev-delivery,审查并改进当前项目。阅读需求、源码和已有测试,选择至少两个相关的不同风险类别,用 delivery_audit 实际验证。确认问题后做最小修复并保留回归测试,最后运行 delivery_report,说明发现、修复和仍未验证的内容。不要为凑数量编造 bug 或重复相同测试。
网络恢复或下次继续时,可说:
用 delivery_status 恢复这个项目,核查当前文件和未完成任务,先确认上次操作是否执行,再继续;完成时运行 delivery_report。
两类审查必须各自验证有意义的风险,例如记账项目的“非法金额被拒绝”和“保存失败不留下错误成功状态”。并发、安全或界面检查是否适用由项目决定,不要求所有类别全做,也不要求一定发现 bug。没有两类适用检查时,应说明门槛未满足,不能假报完整验收。
安装、更新和卸载
先退出正在执行任务的 DSH,解压整个包。在本目录运行 node scripts/install.mjs install,然后重新打开 DSH。需要本机 Node.js。安装器会打印备份位置,并添加本插件和 Skill 的受管理配置。
- 查看状态:
node scripts/install.mjs status - 更新:
node scripts/install.mjs update,备份旧插件和 Skill 后切换到带内容指纹的新入口。 - 禁用:
node scripts/install.mjs disable,然后重启 DSH。 - 启用:
node scripts/install.mjs enable,然后重启 DSH。 - 卸载:
node scripts/install.mjs uninstall,归档本插件和 Skill,保留开发记录。
安装更新不改模型、凭据、聊天和其他插件,已有禁用状态会保留。配置备份可能含本机敏感信息,只保留在本机 .dsh/plugin-backups,不要放入分享包。升级复用原受管理目录,所以目录名可能仍有0.1.0;实际版本以 Status.cmd 的 package/owner 信息为准。
状态中的 integrity.ok 会检查入口存在且指纹匹配、Skill 主文件可读且非空、package/owner 版本一致;它不校验 Skill 正文与发布包是否相同。diagnostics 给出具体损坏项。运行中的 delivery_status 和 delivery_report 还会返回 pluginVersion,可与磁盘安装版本对照。
安装器先预检、备份并准备文件,再切换;可捕获的失败会回滚。强行结束进程或断电后的恢复不能等同于已测试的异常回滚:保留锁与备份,检查事务状态后再处理,不要反复覆盖安装。
配置提交和回滚会先捕获实际原文件,再以不覆盖已存在文件的方式发布新文件,避免最后检查后的并发编辑被静默覆盖。安装器先检查配置目录是否支持硬链接;不支持时在移动现有插件前停止。操作期间须退出 DSH,并避免其他程序同时修改配置。遇到 recovery-required 时保留配置捕获文件和事务备份,核对后恢复,不重复覆盖安装。
若切换已成功但仅临时文件清理失败,结果和事务记录会列出 cleanupWarnings,保留已完成操作的状态;清理错误不会覆盖原有恢复错误。核对诊断和备份后再处理残留临时文件。
安装前使用随包附带的 YAML 解析器核对注册的实际含义,识别锚点、别名、转义和多行标量,不把注释或消息里的示例当成注册。配置中的 !!js 不会在检查时执行;无法安全确认的动态插件 ID 或损坏配置会拒绝操作。原配置仍只修改所属标记块,不整体重写。解析器使用 yaml 2.9.0,ISC 许可证位于 lib/yaml-LICENSE.txt。
验收怎样生效
六个原生工具分别负责计划、状态、记录、计划检查、独立审查和报告:delivery_plan、delivery_status、delivery_note、delivery_verify、delivery_audit、delivery_report。插件注入简短工作约定,详细流程存放在 Skill 中;普通问答和微小编辑无需套用整套流程。
新建或修改的计划必须满足计划检查,并有至少两个不同类别的独立审查在当前文件上通过;任何未解决的失败审查都会阻止 delivery_report.ready。未修改的0.1.x计划保留旧规则。审查采用“可检验假设 → 实际执行 → 区分缺陷、测试错误和环境故障 → 最小修复 → 保留回归测试 → 重新验证”,不把静态怀疑写成已确认 bug。
审查 id 绑定原类别和假设,不能把失败风险替换成简单检查。修改命令需提供具体 revisionReason,报告显示最近修订依据及修订次数;身份和修订摘要不会随运行明细裁剪丢失。模型还须证明没有弱化断言。审查不能与计划检查或其他审查使用完全相同的命令;换包装或换名字也不能证明检查独立。工具能核对执行与文件证据,不能自动判断测试是否充分、假设是否合理。
验收通过 DSH 原生 pwsh 执行,沿用其权限、超时和输出机制,文件读取使用 DSH fs 服务。每个检查须正确传播失败退出码。测试脚本和审查文件也要加入计划文件清单,构建产物、数据库和覆盖率等运行产物放在清单外。
重复提交相同计划不增加修订;只改 goal/steps 保留有效证据,steps 不代表机器验证进度。改某项检查的需求、命令或超时使该项过期;改文件清单或被跟踪文件使全部证据过期。需求含义变化时应同步改检查和断言。代码和测试确定后验收最终快照,已有当前有效证据且没有新变化或疑点时,无需无意义重复测试。
ready=true 只表示当前所列文件、检查和审查条件满足。它不证明所有需求、安全性、外部服务或部署状态都正确。源码完成、构建通过、服务启动、功能验证和已部署是不同结果,交付时要分别说明。
中断和故障恢复
status 和 report 都会重新核对文件,并且为只读;status 默认返回摘要,detail:true 返回完整计划及近期记录。损坏、版本或目录不符、读取失败和无计划会分别报告,不能把读取错误当作新项目覆盖。
状态读取还会核对执行标志的类型、证据格式和执行事实。passed 不能覆盖未结算后台任务、执行时文件变化、非零退出或不支持的证据格式;异常字段会阻止通过,原始记录保留以便核查。
重新验收会先写入未完成记录,随后读取文件和执行命令,避免中断时继续沿用旧通过。running/interrupted/pending、超时、取消和权限拒绝都不算通过。报告中的 pendingExecutions 提供原调用和任务身份;删除原计划检查也不会隐藏未结束任务。后台任务用原会话的 job_output 查看,必要时用 job_kill 停止自己的任务。插件仅认可明确的终结状态,或原会话里匹配的持久 job/settled 事件;后者可支持在新聊天恢复重跑,但不会把旧后台结果算作通过。后台条目消失或查询失败不能证明已完成,也不能通过新建计划绕过等待。
断网、执行器异常或模型中断后,先检查状态、已有文件和原操作结果,再决定是否重试;不重复派发可能仍运行的任务。相同快照连续三次真正失败后,需要修复实现/检查,或提供说明新诊断或环境修复的 retryReason;它不授予通过。没有恢复依据时如实说明阻塞和下一步,不无限重试。
项目写入采用原子写入和跨进程锁,崩溃遗留锁不妨碍只读查看。人工处理锁前,先核对其中 pid、确认原进程已退出并备份,再归档;不要仅按时间删除锁。Windows 路径大小写和分隔符会归一化,实际移动到其他目录仍需重新建计划和验收。旧记录冲突时停止并提示核对。
工具先通过原生文件系统固定实际工作目录,命令和状态留在原物理项目;排队期间别名已改向会拒绝开始,仍使用已变别名提交状态也会拒绝,不把原项目记录写到新目标。新写入的状态增加可选 projectIdentity,旧状态仍可只读兼容;链接改向后可从原物理目录读取已绑定的原记录。工作流与安装器清理锁前都核对文件身份和随机所有权标记,发现外部替换就保留并报告。
记录位于 $DSH_HOME/dev-delivery,默认 %USERPROFILE%/.dsh/dev-delivery,按工作目录隔离。换目录、机器或 DSH_HOME 时,通过 detail:true 取得计划,在目标目录核查并重验,不转移旧通过资格。历史记录有限保留,详情以状态返回为准;本机记录可能含路径或敏感信息,不直接用于分享。
失败记录保留最多800字符、按常见密钥行、JSON/YAML 引号字段及长 token 规则脱敏的输出摘要,以及原生调用 ID 和退出状态。脱敏先于截断,包含换行放置的完整引号值。规则无法保证识别所有秘密,测试本身不要输出秘密;原始完整输出仍在原生工具历史。
支持范围与开发验证
当前只支持 Windows 原生 pwsh。timeoutMs 申请范围1000..900000,默认60000,实际受原生执行器上限限制;本次验证环境默认上限600000ms。最多250个跟踪文件、单文件2MiB;可先计划待创建文件,但验收时须全部存在。大型项目选择清晰范围,长测试合理拆分。后台结果不自动转为通过,需完成新的前台验收。
插件不会自动无限续跑,也不能强制拦截模型的普通回答。持续开发依靠模型执行 Skill,状态和交付资格由工具核对。安装成功、真实工具验证、模型实测和能力提升基准需要分别提供证据,不能相互代替。
开发检查:node --test tests/*.test.mjs。安装开发依赖 esbuild 和 yaml 后用 node scripts/build.mjs 构建;安装插件本身不需要下载依赖。离线构建可设置 ESBUILD_PATH 和 YAML_PATH 指向本机已有包。真实运行验收脚本需要 DSH_APP 指向 resources/app、ESBUILD_PATH 指向本机 esbuild 包目录;它使用实际 Cordis、ToolRuntime、文件系统和 PowerShell,在隔离 artifacts 目录验证失败、修复、过期和权限拒绝等行为。设置 DSH_APP 时,tests/adversarial-core.test.mjs 还运行真实后台提升与取消竞态;没有设置时明确跳过该集成项。Windows 无文件符号链接权限时,对应两项所有权测试也明确跳过,不修改系统权限以求通过。
扩展运行验收:node scripts/verify-expanded-runtime.mjs。使用真实后台任务、Session、JSONL 持久化和查询,模拟派发后响应丢失,验证运行中任务不重复执行、不同项目互不阻塞、完整测试运行时关闭后新会话从磁盘结束事件恢复,并重新执行前台验收。模拟响应丢失不等于物理断网实验。可用 DELIVERY_ENTRY 指向已安装入口以验证最终安装文件;不指定时需 ESBUILD_PATH 构建隔离候选。
实际目录验收:设置 DSH_APP 后运行 node scripts/verify-path-runtime.mjs。默认验证已构建的 lib/host.mjs,也可用 DELIVERY_ENTRY 指向已安装入口;无需模型或 esbuild。脚本只将测试副本的 DSH 工具导入连接到指定原生运行时,在隔离目录里用真实 PowerShell 启动 Node 子进程,启动前把项目别名改向另一个项目,核对写入仍留在原项目、另一项目状态与源码未变,并保存 artifacts/path-runtime-verification-<版本>.json。它保留隔离测试目录和改向前的别名作为证据,不读取用户配置或启动桌面。
Comments
Loading…
Similar plugins
by feely0208
装第三方插件之前,先看它会动什么 —— 静态审查一个包的代码能力(执行/读凭据/出网/装时钩子)
★ 1
MIT
Shell
Nov 5, 2026
dsh plugin --profile web add @deepwhale-cn/dsh-tool-vetby william-jin-cmu
dsh 插件:文件交付协议——send_artifact 工具经 tool/result meta 携带结构化描述子,任意客户端可渲染
★ 0
BSD-3-Clause
TypeScript
Aug 13, 2026
dsh plugin --profile web add @dsh-external/dsh-artifactby CHAAAAA
DeepSeek Harness(DSH)的项目与工程管理插件,把需求、项目文档、Git 提交、AI 提交信息、代码评审、工作树、后台任务与周报聚合到一个侧边栏工作台里。
★ 0
MIT
TypeScript
Nov 2, 2026
dsh plugin --profile web add dsh-devbench-plugin把 DSH 能读到的 skills 统一扫描、 归并、可视化,解决「skills 太多、不知道哪个命令属于哪个来源」的痛点。
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-skill-catalog阅读代码 · DSH 独立插件:一个独立于普通工作区选择的代码阅读模式:先理解业务,再梳理调用链、精读实现,最后通过具体场景验证理解。
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-code-readingby akira399
DSH 插件开发与 GitHub 发布工作流技能插件 (consent-gated) — develop, verify, publish & marketplace-visible DSH plugins
★ 2
MIT
JavaScript
Aug 14, 2026
dsh plugin --profile web add dsh-plugin-publisher