DSHIO-LIST · 收录标准
什么插件能进目录,什么情况会被标「已下架」,以及为什么下架了也不删记录。
进目录的条件
| 编号 | 条件 | 怎么核 |
|---|---|---|
| L1 | 在 npm 或 Git 上真实存在 | 拉 registry / 仓库元数据 |
| L2 | package.json 可解析 | 读 manifest |
| L3 | 声明了 dsh.bundle.patch | 读 manifest |
| L4 | 不是 private: true | 读 manifest |
| L5 | 包名是合法的 npm 名 | 格式校验 |
只要满足 L1-L5 就收录,不以质量为准入。
我们不做「只收好插件」的精品店 —— 那样用户永远不知道被排除的是什么。
收录是广泛的,质量由等级表达。
三种状态
| 状态 | 含义 | 来源 |
|---|---|---|
| 已测 | 跑过 DSHIO-TEST,有等级 | 我们的测试 |
| 未测 | 已收录,还没跑 | — |
| 已下架 | 不再可用,保留记录 | 见下方 |
下架的四种情况
| 情况 | 判定 | 记录 |
|---|---|---|
| npm 上 404 | 拉 registry 返回 404 | 标 npm-gone,移入已下架 |
| 仓库归档或删除 | GitHub archived: true | 标 archived |
| 违反安全红线 | DSHIO-DEV 6.1-6.6 任一条 | 标 removed-violation |
| 名称/身份伪装 | 冒充官方或他人 | 标 impersonation |
为什么下架了不删记录。
「这个包曾经存在、现在没了」本身就是有用的信息:
· 用户想知道「之前看到的插件为什么装不上」
· 作者想知道「我的包在 npm 上 404 了」
· 所有人想知道「这个生态里消失过什么」
删掉记录等于抹除历史。我们把下架的插件单独放在 已下架 页,永久保留。
· 用户想知道「之前看到的插件为什么装不上」
· 作者想知道「我的包在 npm 上 404 了」
· 所有人想知道「这个生态里消失过什么」
删掉记录等于抹除历史。我们把下架的插件单独放在 已下架 页,永久保留。
不收录什么
| 类型 | 理由 |
|---|---|
| 不是 DSH 插件(没有 dsh.bundle) | 装了也不会加载 |
| 纯占位仓库(无代码) | 没有可安装的东西 |
| tarball 直链 | 无法追溯来源 |
| 带凭据的 URL | 安全 |
数据来源与更新
| 数据 | 来源 | 频率 |
|---|---|---|
| 插件存在性 | npm registry / GitHub API | 每日 |
| 下载量 / stars | npm / GitHub | 每日 |
| 版本列表 | npm registry | 每日 |
| 测试结果 | 我们的沙箱 | 按需 + 定期 |
版本历史
| 版本 | 标准号 | 发布日期 | 变更内容 |
|---|---|---|---|
| v1.0 | DSHIO/T 04—2026 | 2026-11-06 | 首次发布 |
条款变更时版本号递增,旧版本保留可查。