dsh-plugin-kit

DSH PLUGIN开发与运行时

仓库 wufeng0105/dsh-plugin-kit · npm @wufeng0105/dsh-plugin-kit

开发与运行时 未标注验证等级 安全审查:未标注 可信度:未标注 可安装插件
安装这个插件

为 DSH plugin 开发提供契约查证 skill 与 preflight/recheck 验证脚本,覆盖四大失败家族与升级后触点复检。

一句话选型结论

按资料字段整理

dsh-plugin-kit 是开发与运行时类的 DSH 可安装插件,未做沙盒验证,暂无安全审查结论,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类开发与运行时 收录类型可安装插件 验证等级未标注验证等级 安全审查未标注
验证等级 UNKNOWN 未标注验证等级
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-14 创建于 2026-11-09
README 8.7 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add @wufeng0105/dsh-plugin-kit
  1. 1
    确认版本与运行环境

    Node.js 要求 >=20.3.0;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求>=20.3.0来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名@wufeng0105/dsh-plugin-kit可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-plugin-kit:DeepSeek Harness 插件开发的契约查证与完成验证工具

  • 三步查契约 skill
  • 首装 preflight 自检
  • 升级 recheck 触点复检
  • 四大失败家族判定
  • 新插件项目骨架模板

上游标签

deepseek-harnessdshdsh-plugin

验证等级与安全审查

未标注验证等级
自动化流程结论,不是人工审核
验证等级未标注验证等级上游未给出验证结论,安装前请自行确认
安全审查未标注静态分析结论,未标注不代表已通过审查
仓库健康度未标注按仓库活跃度与最近更新时间给出
可信度未标注综合仓库活跃度与验证结果

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 安全审查还没结论,装之前先看仓库改了什么、要什么权限。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在开发与运行时场景里给 DSH 补能力的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-plugin-kit当前 未做沙盒验证 未标注 0 未标注 有
deepseek-harness L3 · 安装规范通过 低风险 24.6 万 未标注 无
rea L4 · 沙盒安装通过 低风险 2.6 万 0.1.1-rc.2 有
dsh-TUI L4 · 沙盒安装通过 中风险 4,292 0.1.7-rc.2 等 5 个 有
mirage L3 · 安装规范通过 低风险 3,681 未标注 无
dashi-taskboard L4 · 沙盒安装通过 低风险 3,311 0.1.1-rc.2 有

仓库档案

开发与运行时
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方wufeng0105仓库 dsh-plugin-kit · 默认分支 main
分类开发与运行时dev
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-09 · 2026-11-14最后推送 2026-11-14
本站收录2026-11-14首次进入本站目录的时间

README 全文

8.7 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-plugin-kit

> 一个包,两样东西:契约查证顺序(skill)+ 完成验证脚本(preflight 首装自检 / recheck 升级复检)。

装它,plugin-kit 这个 skill 自动出现在你的 skill 目录里。它不拦任何调用、不记台账、不注入常驻提示——旧形态(阶段门拦截 / 台账 / 纪律段)已于 2026-11-13 退役,决策记录见 docs/adr/。

它解决什么

开发 DSH 插件,你在对着一个黑盒:

痛点 表现
宿主是黑盒 契约(接缝、事件签名、Config 形状、加载方式)全在宿主运行时与 208MB 的 app.asar 里,shell 工具打不开;离线合法的代码宿主里可能非法
「完成」没有权威定义 代码写完、测试全绿之后,没人告诉你什么算装上了、什么算能用了;DSH 升级后同一问题再来一遍

这个插件把两面都变成可执行的程序:写之前按三步顺序查契约,宣称完成之前跑 preflight,升级之后跑 recheck + 重解。

三步查契约(写在 skill 正文里)

  1. cordis_inspect_query —— 权威源。Service 方法、事件名/mode/签名、Config schema。事件全集(如 rc.2 的 fs/write-intent)只在 inspect 里,任何文档都没有逐条清单。
  2. dsh-doc 文档 —— 机制原则与装配形态。可检索副本随包分发在 skills/plugin-kit/host-skills/dsh-doc/(43 文件,可 grep / glob)。
  3. 找一个真实运行的同类型插件读源码 —— 最有效、最容易被忘的一招。

完成验证(脚本)

# 首装自检:四大失败家族逐条核查(装不上 / 看不见 / 一加载就崩 / 环境相关)
node skills/plugin-kit/scripts/preflight.mjs <你的插件项目根>

# 升级复检:你依赖的宿主触点还成立吗
node skills/plugin-kit/scripts/recheck.mjs --touchpoints touchpoints.json --snapshot host-snapshot.json --strict
  • 每项输出 PASS / FAIL / UNVERIFIABLE,FAIL 附「缺什么、怎么补」
  • UNVERIFIABLE 不是通过:按提示人工验,验完自己记结论
  • 两个脚本都自带 --self-test——先证明判定式会红,再用它判你的项目

四大失败家族(每条判定式都有真机事故出处,见 CHANGELOG):

家族 典型形态
① 装不上 缺 dsh.bundle.patch;patch 的 name 与包名不一致;Config = {};inject 猜了不存在的服务
② 装上了但看不见 skill 缺 resourceBase;slot 注册塞进 inject 回调
③ 一加载就崩 client.js 含 ESM export——宿主把所有插件 client.js 拼成一个大脚本
④ 环境相关 最小 profile 能用、完整插件集崩(只能真机验,脚本标 UNVERIFIABLE)

升级保鲜

DSH 升级后两件事:

# ① 宿主文档副本过期判定 + 一键重解(rc.2 实测:四份旧 skill 已被宿主合并为 dsh-doc)
#    注意:reextract 只在源码仓有(它要读本机 app.asar 并写回仓内副本),不随 npm 包分发——
#    装包形态下请在源码仓根跑,或见 plugin-kit skill §三的两态说明。
node scripts/reextract.mjs --check
node scripts/reextract.mjs
#    自动同步 VERSION.json 的 dsh 版本号(从 asar 的 dsh/package.json 读,不靠人填)

# ② 触点复检(recheck 随包分发,装包形态从 skills/plugin-kit/scripts/ 跑)
#    先跑 gen-host-snapshot.mjs 生成当前宿主的快照与触点清单(仓库内,不联网):
node scripts/gen-host-snapshot.mjs
node skills/plugin-kit/scripts/recheck.mjs \
--touchpoints skills/plugin-kit/assets/touchpoints.json \
--snapshot  skills/plugin-kit/assets/host-snapshot.json --strict

安装

# 从 npm(推荐)
plugin_manager install_bundle target=@wufeng0105/dsh-plugin-kit

# 或从源码仓路径
plugin_manager install_bundle target=<本目录绝对路径>

包已发布到 npm:@wufeng0105/dsh-plugin-kit。

装完验证:skill 目录里出现 plugin-kit;让模型复述「四大失败家族」→ 能。

发布与版本管理

版本号只有一个来源:package.json 的 version。git tag 名与 npm 版本都从它派生。

node scripts/release.mjs --check          # 只核对现状(七项),不改任何东西
node scripts/release.mjs patch|minor|major # 升版 + 提交 + 打 tag(跑全量验证门后才动)
git push origin main --follow-tags
npm run publish:npm                        # 内部先跑 check + pack 干跑,再发

release.mjs 的七项核对:版本是纯 x.y.z、CHANGELOG 有对应节、tag 不存在、工作树干净、分支是 main 且已同步、npm 上该版本不存在、repository 指回本仓。任何一项不过就拒绝继续。

脚本不代做 push 与 publish——两个不可撤销的外部动作,执行权留给人。发布后核对:npm view @wufeng0105/dsh-plugin-kit version --registry=https://registry.npmjs.org/。

> 首次发布时 packument(包根索引)会比版本端点晚几分钟生效,期间 npm install 报 404 而 tarball 直链已可下载——这是 CDN 传播,不是发布失败。

源码布局

dsh-plugin-kit/
├── index.js                 Host 半:只做 skill provider 注册(86 行)
├── lib/skill-provider.js    skill 扫描与定义校验
├── skills/plugin-kit/       产品本体
│   ├── SKILL.md             判据正文:查契约三步 + 失败家族 + 开发纪律
│   ├── scripts/             preflight.mjs(首装自检)/ recheck.mjs(升级复检)
│   ├── template/            新插件项目骨架(4 文件)
│   ├── assets/              触点清单 / 宿主快照样例
│   └── host-skills/         dsh-doc 副本(rc.2 逐字节)+ VERSION.json
├── scripts/reextract.mjs    asar 解析与重解(--check / --self-test;只在源码仓,不随 npm 包分发)
├── CONTEXT.md               词汇表(含退役词清单)
├── docs/                    reviewer.md(本仓开发纪律)+ adr/(三个决策记录)
├── evidence/                凭据:裁定书、真机存证、重定义验收记录、探针脚本
└── test/                    全部验证入口见 npm run check

文档地图

文件 只讲这一件事
README.md(本文件) 这个包是什么、怎么装、怎么用
CONTEXT.md 词汇表:现行词与退役词
docs/adr/ 三个重大决策及其依据
docs/reviewer.md 审查员协议——本仓自身的开发纪律(不随 npm 包分发)
skills/plugin-kit/SKILL.md 判据正文(装进宿主的就是它)
CHANGELOG.md 版本历史(0.2.0 重定义 + 0.1.x 事故出处表)
evidence/ 凭据:主张引用的原始报告与实测记录

跨文档引用按名不按号。

日志

启动两行(info)+ 打包缺失一行(error):

[plugin-kit] v0.2.0 已加载 → cwd=<你的项目目录>
[plugin-kit] skill provider 已注册 → name=plugin-kit root=<包内 skills 路径>

有一条 error 就说明插件是残的(比如打包漏了 skills/)。headless 模式看不到这些日志——确认插件在工作:让模型列出可用 skill,应含 plugin-kit。

已知限制(诚实列)

限制 影响
preflight 是静态检查 它判不了运行时行为——装完后的实际可见性仍需一次性 profile 真机验证
「环境相关」家族 UNVERIFIABLE 插件间冲突只能真机验(复刻完整 bundle 组合的一次性 profile)
文档副本会过期 宿主升级后在源码仓跑 node scripts/reextract.mjs --check(该脚本不随 npm 包分发,见上「源码布局」);不做激活时自动同步(拿稳定性换新鲜度不划算)
inspect 不可达时判不了 没有宿主运行时,契约只能读到 L3(源码核对),不冒充已验证

生命周期

  • 升级:plugin_manager install_bundle target=<新包路径>,启动日志版本号会变
  • 卸载:dsh plugin --profile remove @wufeng0105/dsh-plugin-kit——不删你项目的任何文件
  • 从 0.1.x(旧阶段门形态)升级:直接换包即可;你项目里的 .stage-gate.json / stages/ / stages/_ledger.jsonl 不会被删除也不会再被读写——要不要清掉由你决定(它们属于已退役的机制)
  • 从更早的旧包名 @wufeng0105/dsh-stage-gate 升级:必须先卸旧再装新(旧包若仍在 profile 中,两套 bundle 行并存会双重注册)

许可证

MIT

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-plugin-kit 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add @wufeng0105/dsh-plugin-kit` 即可。对应的 npm 包名是 `@wufeng0105/dsh-plugin-kit`。

dsh-plugin-kit 的验证等级是什么意思?

未标注验证等级。上游未给出验证结论,安装前请自行确认

dsh-plugin-kit 安全吗?

未标注。

dsh-plugin-kit 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-plugin-kit 需要什么运行环境?

Node.js >=20.3.0。环境不满足时安装会失败,建议先确认本机版本。

dsh-plugin-kit 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-plugin-kit 有哪些功能?

三步查契约 skill、首装 preflight 自检、升级 recheck 触点复检、四大失败家族判定、新插件项目骨架模板。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

8 条
不同作者的仓库分开列,请确认你要装的是哪一个
开发与运行时
按星标排序,可作替代方案

rea

rea

L4 · 沙盒安装通过 2.6 万 星

dsh-TUI

dsh-TUI

Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。

L4 · 沙盒安装通过 4,292 星

mirage

mirage

把文件系统与 bash 提供者换成 mirage 虚拟工作区:文件工具与 shell 命令作用于挂载的资源(RAM、S3、Redis、Sla

L3 · 安装规范通过 3,681 星

dashi-taskboard

dashi-taskboard

把当前已安装并运行中的 Codex Taskboard 嵌入 DeepSeek Harness 侧边栏,并通过 Launcher 运行时描述

L4 · 沙盒安装通过 3,311 星

wufeng0105 的其它插件

5 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 —。