npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

dsh-skill-audit

v0.1.1

Published

Skill and plugin audit console for DeepSeek Harness: scan DSH skills/plugins (0-100 + S/A/B/C/D) and audit WorkBuddy skill/expert packages with 25 gate checks, quality Q, value V and pricing suggestions, then export a Markdown report.

Readme

dsh-skill-audit

DeepSeek Harness 的技能 / 插件审核台。 一个面板、两种模式:

  1. DSH 资产:扫描本机 DSH 技能与插件,逐个打 0-100 分(S/A/B/C/D),列出 pass/warn/fail 与修复建议,可导出 Markdown 报告。
  2. WorkBuddy 包:审核 WorkBuddy 技能包 / 专家包(目录或 .zip),跑 25 条门禁(G01–G19 / E01–E06)+ 质量分 Q(5 维 22 项)+ 价值分 V(6 维),自动做 V_final = min(V_raw, Q + 15) 校准,并给出建议价格带。

dsh-skill-audit 是一个 DSH 插件(dsh.bundle + 浏览器半边):左侧栏底部挂 🛡️ 审核台 按钮,点开是 React 直接渲染的全屏面板(不用 iframe)。宿主半边负责扫描并提供 JSON 路由。

扫描范围

DSH 模式

| 来源 | 扫什么 | | --- | --- | | ~/.dsh/skills/* | 每个技能目录(SKILL.md) | | <profile>/node_modules/* | package.json 里声明了 dsh.bundle 的已安装插件(含作用域包) | | <workspace>/dsh-plugins/* | 当前工作区里正在开发的插件 |

WorkBuddy 模式

| 输入 | 识别方式 | | --- | --- | | 目录或 .zip | 根上有 SKILL.md → 技能包(若 ZIP 套了一层外层目录会自动剥开,并由 G01 判 fail) | | 目录或 .zip | 有 .codebuddy-plugin/plugin.json → 专家包(ZIP 必须有且只有一层顶层目录 = 包名) |

ZIP 是纯 JS 读取:解析中央目录 + zlib.inflateRawSync(stored / deflate),不落盘;只有脚本语法检查需要时,才把脚本临时解压到系统临时目录并立即清理。不支持 ZIP64 / 加密包。

DSH 模式检查项

技能(基于 SKILL.md)

| 检查项 | 权重 | 检查内容 | | --- | --- | --- | | SKILL.md | 20 | 存在且内容非空 | | frontmatter description | 20 | 有 YAML frontmatter、description 存在且够长 | | frontmatter author | 10 | 声明了作者 | | frontmatter name | 10 | 与目录名一致 | | LICENSE | 10 | 有许可证文件(或 frontmatter 里声明) | | 敏感信息 | 20 | 明显密钥 / Token / 私钥(命中值一律打码) | | 本机路径 / 隐私 | 10 | 硬编码的完整用户主目录路径 |

插件(基于 package.json)

| 检查项 | 权重 | 检查内容 | | --- | --- | --- | | package.json | 5 | 可读取、合法、name 与目录名一致 | | dsh.bundle | 15 | 已声明,且 patch 文件存在 | | cordis.patch.yml row name | 15 | insert 行的 name 等于包名 | | client 模块 id | 10 | __ModuleLoader__.load({ id }) 等于包名 | | 宿主 name | 10 | export const name / exports.name 等于包名 | | README | 5 | 至少有一个 README | | README 中英 | 5 | README.md + README.zh.md(或 README.en.md) | | LICENSE | 7 | 许可证文件存在 | | icon | 10 | icon 是 512×512 PNG(直接读 PNG 头判断尺寸) | | files 白名单 | 5 | 覆盖 lib / app / assets / README* / LICENSE / cordis.patch.yml | | 敏感信息 | 10 | 明显密钥 / Token / 私钥(命中值一律打码) | | 本机路径 / 隐私 | 3 | 硬编码的完整用户主目录路径 |

DSH 分数 = 加权通过率(pass=1、warn=0.5、fail=0、skip 不计入)。等级:S ≥ 90,A ≥ 80,B ≥ 70,C ≥ 60,D < 60。

WorkBuddy 模式检查

25 条门禁移植自 skill-value-auditor/rubric/rubric.v1.json(rubric v1.0.1)。每条返回 pass / warn / fail / skip,带 severity(blocker / major / minor)、可读原因、证据和 rubric 的修复建议。

| ID | 严重度 | 检查项 | | --- | --- | --- | | G01 | blocker | 包结构(平铺 ZIP、SKILL.md 在根、层级 ≤2、无垃圾文件;专家包顶层目录 = 包名) | | G02 | blocker | SKILL.md frontmatter 必填字段(name/description/version;专家包内嵌技能 name/description) | | G03 | major | name 与包名一致且为 kebab-case | | G04 | blocker | 展示名规则(≤15 字,仅中英文数字 / - / —,无括号空格) | | G05 | blocker | 文档反引号引用的本地文件必须存在(禁止通配符) | | G06 | blocker | 无硬编码密钥 / 令牌 / 私钥(值打码) | | G07 | blocker | YAML frontmatter 可解析(含 ': ' 引号陷阱) | | G08 | blocker | 付费包法律文件:LICENSE-USE / NOTICE / PRIVACY / SECURITY / CHANGELOG + 免责声明 | | G09 | minor | 图标素材 512×512 PNG ≤ 500 KB | | G10 | major | 中英双语字段(description_en / display_name_en / examples_en) | | G11 | blocker | 脚本语法可编译(JS 用 node --check,Python 有解释器时用 ast.parse) | | G12 | blocker | 无越权 / 破坏性命令(rm -rf / 注册表 / 浏览器凭据等) | | G13 | major | 无绝对化违规承诺(保本 / 稳赚 / 零风险 / 包过 / 避税等) | | G14 | major | 无未完成占位符(TODO / 待补 / TBD 等) | | G15 | minor | UTF-8 无 BOM | | G16 | blocker | 无外传用户数据(上传 / webhook 模式) | | G17 | major | 包体 <3 MB(专家包 <10 MB) | | G18 | major | author 字段 | | G19 | blocker | examples_zh / examples_en 各 ≤3 条(平台解析硬限制) | | E01 | blocker | plugin.json 16 个必填字段齐全且合法 | | E02 | blocker | avatar 512×512 且 ≤500 KB | | E03 | blocker | tags=3、quickPrompts=3、defaultInitPrompt 对齐、profession 非空 | | E04 | major | displayDescription.zh 40–50 字 | | E05 | blocker | agents/*.md frontmatter 与 agentName 对应(name/description/displayName/profession/maxTurns,禁止 tools) | | E06 | blocker | Team 型 settings.json / teamInfo 一致 |

质量分 Q(0–100,五维)

| 维度 | 权重 | 看什么 | | --- | --- | --- | | Q1 结构合规与工程健壮性 | 18 | 门禁结果、脚本与静态语法、selfcheck、版本/CHANGELOG/体积/编码 | | Q2 触发与路由 | 14 | description 对示例问法的覆盖、泛化词、名称可搜性、示例质量 | | Q3 工作流可执行性 | 24 | 编号步骤与分支、输入采集与降级、输出模板、不确定边界 | | Q4 知识与内容质量 | 26 | 知识密度、静态一致性、时效与出处、免责、可复用资产 | | Q5 体验与商业化基础 | 18 | 首用即得、双语上架文案、可导出格式、体积/token 效率 |

22 个细分项按 0–4 级锚点折算到各自满分,每一项都带证据(计数、文件、命中词),报告里全部列出。

价值分 V(0–100,六维)与定价

| 维度 | 权重 | 依据 | | --- | --- | --- | | V1 需求强度 | 25 | 领域需求先验 + 损失/事件/频率/决策/搜索句式词密度 | | V2 交付确定性 | 20 | 表格、脚本、模板、验收标准 | | V3 结果价值 | 20 | 领域损失基线 + 金额/罚款/理赔词 | | V4 可替代性/壁垒 | 15 | 知识体量、表格、脚本、公式、合规钩子,泛化词反向扣分 | | V5 复用频次与生命周期 | 10 | 领域频次先验 + 周期词 vs 一次性词 | | V6 付费意愿与责任风险 | 10 | 领域、免责声明、合规信号 |

校准:V_final = min(V_raw, Q + 15) —— 交付不行的包,需求再真也不值钱。 定价带(按 V_final):S ≥ 85 → ¥49–79 或订阅;A ≥ 72 → ¥29.9;B ≥ 60 → ¥19.9;C ≥ 48 → ¥9.9;其余免费 / 不上架。V5 ≥ 80 且 V ≥ 70 时追加建议按月订阅(¥9.9–19.9/月)。门禁有 blocker 时 V_final = 0 且不给定价。

惩罚项 P1–P6 跨维度扣分并单列:长行重复率 >30%、专业领域缺免责、绝对化承诺、兄弟包相似度(需批量语料,报告标注未触发)、体积/文本过大、占位符。

面板用法

  1. 安装插件(插件市场,或放进 profile 并加上 bundle row)。
  2. 点左侧栏底部的 🛡️ 审核台。
  3. DSH 资产 标签:打开即扫描,↻ 重新扫描,点击行展开检查明细,筛选 tabs,⬇ 导出报告 → <workspace>/outputs/skill-audit-<YYYY-MM-DD>.md。
  4. WorkBuddy 包 标签:粘贴包目录或 .zip 的绝对路径,点 🔍 扫描包;面板显示按严重度分组的门禁表、Q 五维、V 六维、惩罚项与价格带。⬇ 导出报告 → <workspace>/outputs/wb-audit-<包名>-<YYYY-MM-DD>.md。
  5. 静态预览 在新窗口打开构建时内嵌的 app/panel.html 预览页(只有示例数据,看设计用)。

宿主路由

| 路由 | 方法 | 说明 | | --- | --- | --- | | /api/dsh-skill-audit/scan | GET | DSH 扫描 JSON,可带 ?workspace=<绝对路径> | | /api/dsh-skill-audit/report | POST | DSH 扫描 + Markdown 报告,可带 { "workspace": "<绝对路径>" } | | /api/dsh-skill-audit/wb-scan | POST | WorkBuddy 包扫描,body { "path": "<绝对路径>", "paid"?: true/false, "skipScripts"?: true } | | /api/dsh-skill-audit/wb-report | POST | WorkBuddy 扫描 + Markdown 报告,body { "path": "...", "workspace"?: "..." } |

路由挂在宿主 connection 服务的共享 /api 通道上,登录态与 Host/Origin 校验由 DSH 统一处理。WorkBuddy 扫描只读,唯一的写操作是导出到 <workspace>/outputs/ 的报告(以及脚本语法检查时临时解压的脚本副本,用完即删)。

导出到哪个工作区?

报告写入位置 = <workspace>/outputs/,<workspace>/dsh-plugins/* 也从同一个工作区扫。按以下顺序取第一个有效候选:

  1. 面板上报的当前会话工作目录(最准确);
  2. DSH_WORKSPACE 环境变量;
  3. ~/.dsh/skill-audit.config.json 的 workspace 字段;
  4. 宿主进程 process.cwd()。
// ~/.dsh/skill-audit.config.json
{ "workspace": "C:/path/to/your/workspace" }

只接受「已存在、不是磁盘根目录」的绝对路径;其余情况自动回退。

命令行

同一套审计逻辑可以脱离 DSH 直接跑:

# DSH 资产
node tools/scan.mjs                          # 扫本机,工作区 = cwd
node tools/scan.mjs --workspace .            # 指定工作区
node tools/scan.mjs --asset ~/.dsh/skills/ai-brain   # 只看单个 DSH 资产
node tools/scan.mjs --json                   # 输出完整 JSON
node tools/scan.mjs --report report.md       # 同时写 Markdown 报告

# WorkBuddy 包
node tools/scan.mjs --wb E:/技能资产库/上架包/my-skill-1.0.0.zip
node tools/scan.mjs --wb E:/workspace/my-expert --json
node tools/scan.mjs --wb <路径> --paid       # 强制按付费包检查法律文件
node tools/scan.mjs --wb <路径> --skip-scripts   # 跳过脚本语法静态检查(更快)
node tools/scan.mjs --wb <路径> --report wb-report.md

--wb 在有 blocker 时退出码为 1,否则 0(方便接 CI)。

开发

node build.mjs          # 把 app/panel.html gzip 后内嵌进 lib/client.js
node test/smoke.mjs     # 离线冒烟:内嵌 gzip、槽位、两种模式面板、宿主路由
node test/scan.test.mjs # DSH 模式 fixture + 路由集成
node test/wb.test.mjs   # WorkBuddy fixture(好/坏技能与专家包、目录 + zip)+ Q/V + 路由
npm test                # 三组全跑
npm pack --dry-run      # 检查发布文件清单

目录结构:

lib/index.js            宿主半边(4 条路由、cordis 插件入口)
lib/audit.mjs           DSH 扫描 / 打分 / Markdown 逻辑
lib/wb-package.mjs      WorkBuddy 包读取(ZIP 中央目录、目录视图、YAML 子集解析)
lib/wb-audit.mjs        WorkBuddy 门禁 + Q/V + 定价 + Markdown 报告
lib/client.template.js  浏览器半边模板(React 面板、两个槽位、两种模式)
lib/client.js           build.mjs 生成的产物(不要手改)
app/panel.html          静态预览页,构建时 gzip 内嵌进 client.js
tools/scan.mjs          CLI(DSH + WorkBuddy)
tools/make-icon.py      用 Pillow 生成 assets/icon.png
test/                   smoke + DSH 扫描测试 + WorkBuddy 测试

隐私与安全

  • 扫描是只读的:不修改被扫描的技能 / 插件 / 包,不发起任何网络请求。
  • 唯一的写操作是导出到 <workspace>/outputs/ 的报告(以及脚本语法检查时临时解压的脚本副本,用完即删)。
  • 命中敏感信息时只报告「类型 + 数量」,命中值不会进 JSON、也不会进 Markdown 报告。
  • 本机路径只报数量,不回显用户名。
  • 扫描结果只在本机 DSH 面板内展示。

已知限制

  • WorkBuddy 评分是启发式静态近似,不是模型判断也不是人工审核:门禁是确定性检查,Q/V 用词频与结构启发式。报告里每个分数都带证据、可复核,但 Q/V 只作参考。
  • YAML 是小型子集解析器(标量、块标量、列表、简单嵌套 map)——写法特别的 YAML 可能被拒或读不全。
  • G11 只做静态语法检查(node --check、Python ast.parse),不执行脚本,所以 --demo / selfcheck 退出码 / T1 沙箱执行都没有验证。
  • T3 兄弟包相似度与 T4 行为评分未自动化(需要批量语料与真实 Agent 输出);P4 报告标注「未触发」。
  • DSH 模式 icon 只认 PNG 头;SVG/JPG 图标只给 warn。
  • 报告文件名按日期生成,同一天导出两次会互相覆盖。
  • WorkBuddy ZIP 支持 stored/deflate,不支持 ZIP64/加密;包必须能被 DSH 宿主进程读到(绝对路径)。
  • 付费判定是启发式(法律文件 / 价格字段 / --paid),没有法律文件又不带价格信息的付费包可能漏判。
  • 浏览器宿主拿不到 session 列表时,工作区按环境变量 / 配置 / cwd 顺序回退。

许可证

MIT,见 LICENSE。