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

Aiko DSH 插件目录

为 Aiko DeepSeek Harness 部署提供的组织精选插件。公共 aiko-dsh-plugin-catalog npm 包提供插件版本、安装依赖、中英文帮助以及内嵌截图。plugins-npm.json 是其源清单；plugins.json 保留旧版 GitHub 安装目标。

与 Aiko dsh-market 配合使用

- id: dsh-market
name: aiko-dsh-market
config:
additionalRegistryPackages:
- aiko-dsh-plugin-catalog

需要 Aiko dsh-market 1.38.0 或更高版本。官方目录保持启用。每个附加目录都是必需的，并按其稳定的仓库 URL 标识符进行合并；不可用的目录会被报告，而不是静默隐藏其插件。公共链接使用 npm 主页和本目录的 issue 跟踪器。阅读四个 Aiko 插件的帮助和截图不会获取其 GitHub 仓库，也不会下载 Office 的运行时归档。

市场通过其区域 npm 注册表解析最新目录版本，验证 SHA-512 完整性，并从有界归档中读取 plugins.json，而不解压或执行它。已发布的目录没有依赖项或脚本。帮助以 Markdown 形式呈现，并带有内联光栅图像；原始 HTML 和远程 Markdown 图像不会被加载。

GitHub 社区发现

github-topic.json 是 Aiko dsh-market 的可选发现源，与精选的 plugins.json 分开。在 discoveryRegistryUrls 下启用其公共原始 URL。在发布引用该源的 market Bundle 之前，先发布此源。GitHub Topic 成员资格是社区元数据，而非 DeepSeek 认证。

运行 npm ci --ignore-scripts，然后运行 npm test 和 npm run discover。收集器仅为 GitHub API 请求读取 GITHUB_TOKEN；该令牌绝不会写入源或发送到 npm。公共读取也可在无需身份验证的情况下工作，但搜索频率较慢。它支持 --search-requests、--check-repositories、--recheck-hours、--state 和 --output。默认值为每次运行 20 次搜索请求、60 次仓库检查和七天重新检查间隔。

收集过程按仓库创建时间对搜索进行分区，以避免 GitHub 的 1,000 条结果上限，将分页状态持久化到 .discovery-cache/state.json，并且仅在完成扫描后移除已消失的仓库。搜索结果在收集过程中会发生变化，因此扫描并非原子快照。搜索失败会保留上次发布的文件。检查失败仍可重试，并且不会贡献过时的安装目标。先前尝试过的仓库会轮换到未尝试过的仓库之后。计数描述的是到目前为止已收集的仓库；部分扫描会被明确标记为不完整。
收集器会检查根包和 monorepo 包清单，排除依赖/vendor/test/example 目录树。过大或被截断的目录树仍处于未验证状态。它在内存中读取实际的 npm 或同一仓库的 Release 归档，检查包身份、Bundle 补丁和运行时入口是否存在，并验证 npm 来源和 SHA-512。不会解压或执行任何归档文件。已检查的归档不是安全审查、传递依赖检查或运行时兼容性测试。仅源码的 bundle 会在没有安装目标的情况下发布。

GitHub Actions 工作流每四小时运行一次，也可手动触发。它会测试收集器、恢复可续传状态、仅更新 github-topic.json，并使用普通推送推送到 main；远端发生移动时推送会失败，而不是覆盖提交。该工作流需要仓库启用 Actions，并授予 GITHUB_TOKEN 写入内容的权限。源码更改在推送之前不会生效。本地缓存文件会被忽略，且不得发布。

精选条目

编辑 plugins-npm.json，保持 count 等于插件条目数量，并选择一个确切已发布的 npm 包和版本。对于 npm 条目，省略 tarball。即使仓库已停用，也要保持仓库标识符和依赖标识符稳定。在迁移期间，为较旧的市场保留 plugins.json 及其不可变的 GitHub Release URL。

维护 content//en.md、zh.md 和 images.json。截图文件名必须指明该目录中的本地 PNG 文件。在 THIRD-PARTY-NOTICES.md 中为复制的资源包含许可证和署名。构建器会拒绝缺失依赖、依赖循环、无效安装目标、过大的资源，以及指向四个已停用插件仓库的帮助链接。

运行 npm ci --ignore-scripts、npm test、npm run build 和 npm pack ./dist --ignore-scripts。在所有引用的插件版本均可从 npm 匿名获取后，发布已检查的数据归档。每次发布都要递增目录版本。仓库根目录的发布通过 private: true 被禁用；只有 dist 可发布。仅更改 GitHub 源文件不会更新 npm 目录。

每个已发布的条目都会声明其包 version。npm 市场身份是 aiko-dsh-market；旧版 feed 使用 dshmarket 和 Aiko GitHub 发布产物。桌面端仅在已安装的源内比较版本。现有配置文件会保留其包源，并且需要通过原生插件管理器显式重新安装才能迁移到 npm。在安装 aiko-dsh-market 之前移除 dshmarket，因为这两个包会贡献相同的配置行。
在更新线上 npm 目录之前，发布并匿名验证每个引用的 npm 版本。Bid Studio 0.2.3 支持 Ontology Kernel ^0.1.3；此目录选择 0.1.4。它需要 DSH 0.1.5-alpha.2 客户端 API；桌面安装路径还需要 Aiko 的桌面桥接 v1。将 Kernel 标识符保留在场景插件的 requires 列表中，以便市场首先安装它。

私有源码与公开分发

活跃开发使用独立的私有仓库。npm 分发插件及其目录资源；GitHub Releases 分发 Mac 应用程序 ZIP。新客户端使用 npm。现有配置文件保留其已安装的包源和显式目录覆盖：迁移这些配置文件，并在停用其 GitHub 发布仓库之前清除旧的组织 URL。删除仓库不会重定向旧的 lockfile URL，也不会抹除先前分发的代码。

| 组件 | 私有开发仓库 | 公开分发 |
|---|---|---|
| 桌面客户端 | aiko-dsh-plugins/deepseek-harness-source | aiko-dsh-plugins/deepseek-harness |
| 市场 | aiko-dsh-plugins/dsh-market-source | npm 上的 aiko-dsh-market |
| Office | aiko-dsh-plugins/dsh-office-source | npm 上的 aiko-dsh-office |
| Bid Studio | aiko-dsh-plugins/dsh-bid-studio-source | npm 上的 aiko-dsh-bid-studio |
| Ontology Kernel | aiko-dsh-plugins/dsh-ontology-kernel-source | npm 上的 aiko-dsh-ontology-kernel |

本地开发检出默认推送到其 source 远程。仅在私有仓库中提交插件实现变更和版本标签。此公开目录仓库保留目录资源、社区发现和问题报告。公开客户端仓库保留 Mac 下载。

在私有检出中构建并测试，检查包内容，然后使用 npm publish  --access public --tag latest --registry=https://registry.npmjs.org/ 发布已检查的 .tgz。每次发布都使用新版本。只有在公开 npm 元数据、完整性和匿名安装均验证通过后，才推进线上目录。插件元数据使用 npm 主页和目录问题跟踪器；不需要公开源码仓库。

私有 Actions 产物不是公开下载。市场的 Aiko market package 工作流和 Office 的平台工作流为维护者生成已检查的 npm 产物。客户端的 Aiko Mac test client 工作流为公开客户端下载生成 Apple Silicon 和 Intel Mac ZIP。全新客户端预装 npm 市场，并将 Office 保留为可选。现有下载 URL 仍然有效。此过程不需要在桌面应用程序中使用 GitHub token。上游市场 npm 发布和站点部署仅适用于上游仓库。
先前发布的代码和包仍然公开。新的插件包不再包含可选的 TypeScript 源代码树和浏览器源映射；可执行的 JavaScript 和 Office 所需的 Python 脚本仍会分发，并且可以进行检查。私有仓库的可见性控制的是开发访问权限，而不是运行公开插件所需代码的访问权限。

许可证

目录元数据：CC0-1.0。捆绑的帮助和截图：MIT；请参阅 THIRD-PARTY-NOTICES.md。