组织插件目录 aiko-dsh-plugins/dsh-plugin-catalog

Aiko DSH 插件目录

公开包 aiko-dsh-plugin-catalog 列出 Aiko 市场允许使用的 npm 包名。插件版本、描述、指南、截图和兼容性声明由各插件自己维护。

Aiko DSH 仓库地图 说明了本目录在私有 Host、Workbench、Workspace 仓库之间的位置。Aiko 和 Yunyao 使用同一份包成员清单；两者的配置档模板和主题选择放在 Workbench，不在本目录。

使用目录

Aiko Market 1.39.0 及更高版本通过 additionalRegistryPackages: [aiko-dsh-plugin-catalog] 读取这份 schema。目录里不含可执行的插件代码。

{
"schemaVersion": 2,
"packages": ["aiko-dsh-market", "aiko-dsh-office", "aiko-dsh-ontology-kernel", "aiko-dsh-bid-studio"]
}

市场先校验目录归档的 SHA-512 完整性，再读取每个列出包的 npm manifest。每次刷新都会重新校验插件版本，即使目录版本没变也一样。不可用的插件会单独标记，无法用过期元数据安装；其他包照常可用。

每个插件在自己的 manifest 里维护 dsh.market 展示字段和 dsh.compatibility.host。必需的激活依赖写在 dsh.compatibility.plugins。双语 Markdown 和内嵌 PNG 随轻量 manifest 一起分发，所以浏览 Office 时不会下载它的解释器。

维护与发布

只改 plugins-npm.json 里的包名。增删插件需要发布新的目录版本；更新已有插件只需发布该插件。

依次运行 npm ci --ignore-scripts、npm test、npm run build，再运行 npm pack ./dist --ignore-scripts。检查并发布生成的数据归档。根包是私有的，只有生成的发行版可以发布。普通构建不访问 npm，也不锁定插件版本。

Schema 2 需要新版市场。已安装的桌面端还需要配套安装器：修复已下线的 Aiko GitHub 源、替换旧的 dshmarket 标识、检查应用兼容性。只发布本目录，修不好旧应用里已保存的下载 URL。冻结的旧版 plugins.json 不是 npm schema 2 的来源。

GitHub 社区发现

github-topic.json 仍是可选的社区发现源。它的采集器和测试独立于 npm 包目录。运行 npm run discover 采集 GitHub Topic 候选；通过 discoveryRegistryUrls 配置它的 URL。发现状态只是发布情况的佐证，不代表官方认证。

源码与发行版

plugins-npm.json 是本包成员列表的来源；scripts/build-npm.mjs 生成可发布的 dist/ 归档，tests/ 校验 schema 与完整性。DSH 0.2 市场集成及其固定版本的目录副本维护在 Workbench modules/market 和 modules/plugin-catalog。准备该产品的下一次构建时，请同步那边的成员变更。

原先的 dsh-market-source 和 dsh-office-source GitHub 远程仓库已不可用。市场集成源码在 Workbench 中；官方 DSH Office 技能由 Host 配置档选定。保留的私有仓库 dsh-bid-studio-source 和 dsh-ontology-kernel-source 继续维护各自较旧的 npm 兼容线。目录条目并不证明某个插件版本能与当前 Host 配合工作：发布前请检查该包的兼容性元数据，并验证安装。

License

目录元数据：CC0-1.0。各插件自行负责其自身资源的许可声明。