🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI

插件脚手架 ciceroyang/dsh-plugin-starter

DeepSeek Harness
ciceroyang44 天前有提交已提供中文文档扫描:含敏感能力

一条命令生成含工具、技能与测试的插件工程

32/100
综合分
3
GitHub 星标
—
npm 周下载
—/5
用户评分

数据截至 2026/9/23 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。

自动兼容检查有告警:未发布到 npm registry,仅可从源码安装。
安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add ciceroyang/dsh-plugin-starter
该包不可直接 npm 安装,改从 GitHub 源安装(明细见下方安装检查)

状态速览

判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位:已验证
是什么
dsh 原生插件 · dev
装得上吗
本站已在 dsh 0.2.1-rc.5 下真实安装成功
非静态推断
L5 · 运行时冒烟等级说明 →
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
更新放缓:最近一次提交在 44 天前
档位由哪些信号合成

本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查⚠ 装前注意

未发布到 npm registry,仅可从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✗npm 包dsh-plugin-starter(未发布到 npm,仅可源码安装)
✓Node 引擎要求 >=18 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/11 18:52:56

安全扫描自动 · 静态分析源码
v2.7.0
🔵 扫描:含敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力:执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量(至少其一)。这是能力清单,不是危险判定——具体能力项与证据见下方,安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件
查看扫描证据(共 11 处,展示前 11 条)
  • 读取本地文件
    generator.mjs:58
    for (const entry of readdirSync(srcDir)) {
  • 读取本地文件
    generator.mjs:60
    const stat = statSync(src)
  • 读取本地文件
    generator.mjs:66
    const text = readFileSync(src, 'utf8')
  • 写入本地文件
    generator.mjs:72
    mkdirSync(join(dest, '..'), { recursive: true })
  • 写入本地文件
    generator.mjs:73
    writeFileSync(dest, out, 'utf8')
  • 读取本地文件
    generator.mjs:84
    const pkg = JSON.parse(readFileSync(pkgFile, 'utf8'))
  • 写入本地文件
    generator.mjs:113
    writeFileSync(pkgFile, JSON.stringify(pkg, null, 2) + '\n')
  • 读取本地文件
    generator.mjs:121
    if (existsSync(outDir) && readdirSync(outDir).length > 0) {
  • 读取本地文件
    generator.mjs:121
    if (existsSync(outDir) && readdirSync(outDir).length > 0) {
  • 执行外部命令来自配置/变量
    generator.mjs:137
    execFileSync(process.execPath, ['--test'], { cwd: outDir, stdio: 'inherit', env })
  • 读取本地文件
    templates/index.js:35
    content: readFileSync(SKILL_FILE, 'utf8'),
扫描于 2026/11/4(0 天前) · 范围 入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个

功能亮点

  • 一条命令生成插件工程
  • 含工具与技能
  • 含测试与CI

一条命令搭好经实战检验的 DeepSeek Harness 插件(打包、工具、技能、测试、CI)

README

由 DeepSeek 最新模型翻译生成
dsh-plugin-starter 一键生成"实战验证过"的 DeepSeek Harness 插件工程:宿主插件 + 工具 + 运行时 skill + 单测 + CI + bundle 协议。基础脚手架零运行时依赖、无需构建;可选的 --with-settings 变体会加入构建工具。 快速开始 需要 Node.js 18 或更高版本。无需克隆,直接从 GitHub 运行: npx --yes github:ciceroyang/dsh-plugin-starter my-plugin --verify 也可以克隆源码: git clone https://github.com/ciceroyang/dsh-plugin-starter.git cd dsh-plugin-starter node generator.mjs my-plugin --desc "一句话描述" 或指定输出目录 node generator.mjs my-plugin --out ./packages/my-plugin 生成后立刻跑冒烟测试 node generator.mjs my-plugin --verify 带设置卡片(client 半,需要 tsdown + React) node generator.mjs my-plugin --with-settings
展开完整文档(README 剩余 1 节)
dsh-plugin-starter

一键生成"实战验证过"的 DeepSeek Harness 插件工程:宿主插件 + 工具 + 运行时 skill + 单测 + CI + bundle 协议。基础脚手架零运行时依赖、无需构建;可选的 --with-settings 变体会加入构建工具。

快速开始

需要 Node.js 18 或更高版本。无需克隆,直接从 GitHub 运行:

npx --yes github:ciceroyang/dsh-plugin-starter my-plugin --verify

也可以克隆源码:

git clone https://github.com/ciceroyang/dsh-plugin-starter.git
cd dsh-plugin-starter

node generator.mjs my-plugin --desc "一句话描述"
或指定输出目录
node generator.mjs my-plugin --out ./packages/my-plugin
生成后立刻跑冒烟测试
node generator.mjs my-plugin --verify
带设置卡片(client 半,需要 tsdown + React)
node generator.mjs my-plugin --with-settings

生成的结构:

my-plugin/
├── index.js 宿主插件:greet 示例工具 + 运行时 skill 注册 ├── lib/hello.js 纯函数示例(单测友好) ├── skills/my-plugin/SKILL.md 技能说明书 ├── tests/hello.test.js node:test 单测 ├── cordis.patch.yml bundle patch 层 ├── package.json dsh.bundle manifest + peer 依赖 ├── .github/workflows/ci.yml 4 版本 Node 矩阵 └── README.md 含开发/安装/发布清单

生成即通过测试:cd 进目录跑 node --test。

为什么值得用

模板把下面这些坑全部避开(详见配套教程):
- object 输出 schema 缺 additionalProperties 注册即失败
- --patch 绝对路径插件的模块解析(node_modules 软链)
- 注册是效果:disposer 收集与卸载清理
- 可选服务用 ctx.get('skills') 而不是 inject
- 单测保持纯函数,不依赖 harness 服务

设置卡片变体(--with-settings)

在基础工程上追加:client/index.tsx(settings.section 注册 + 最小表单)、dsh.client manifest、tsdown 构建脚本与依赖。生成后 pnpm install && pnpm build 产出 lib/client.js。注意 settings RPC 是 loopback-only(远程浏览器设置页不可用)。完整机制见 docs/settings-guide.md。

发布你的插件

1. 改 index.js 和 SKILL.md
2. GitHub 建仓库,打 topic:dsh-plugin
3. 给 awesome-deepseek-harness 提收录 PR

参考

- 实战教程(含 6 个实测坑):https://github.com/ciceroyang/dsh-report-studio/blob/main/docs/tutorial-zh.md
- 完整插件实例:https://github.com/ciceroyang/dsh-report-studio
预览分享卡片长什么样 ↓ciceroyang/dsh-plugin-starter
分享 · DeepSeek Harness Hub
ciceroyang/dsh-plugin-starter

一条命令生成含工具、技能与测试的插件工程

这是你的仓库?认领条目

回到顶部