AllDSH
EN

高级 · 1 分钟读完 · 更新于 2026-09-08

如何发布 DSH 插件并提交到目录站点

打包一个 DeepSeek Harness 插件,为它加上便于发现的标签,并提交到社区目录站点,让开发者能找到并安装它。

作者 赤榆 · 维护者与编辑

维护本站目录:逐条核对安装命令与已发布包是否一致、评定验证等级、执行自动扫描,并撰写教程。 ·

你已经有一个能用的插件了。现在它需要被找到。发布一个 DSH 插件有两半:让包可安装,以及让它可被发现。第一半是常规的 npm 工作。第二半是大多数插件栽跟头的地方,因为在这个生态里,被发现靠的是一个 GitHub 话题标签,以及你元数据的质量。

第 1 步:发布前先把包做完

一个可以发布的插件具备四样东西:

  • 一个已发布的 npm 包,或者一份能从 git 可靠安装的仓库规格。
  • 一份 README,说明插件做什么、确切的安装命令,以及它所针对的 harness 版本。
  • 一个许可证文件,因为目录站点会按已声明的许可证过滤。
  • 一份 dsh.compatibility 声明,写明你实际测试过的 harness 版本,让用户能判断它是否匹配自己的 harness。

README 里的安装命令应当可以直接复制粘贴,并且是完整的:

dsh plugin --profile web add your-package-name

第 2 步:给仓库打上便于发现的话题标签

目录站点通过 GitHub 的 dsh-plugin 话题发现社区插件。把它加到你的仓库上,同时加上描述能力而不是描述技术栈的话题标签:

  • dsh-plugin 和 deepseek-harness,用于被发现。
  • 一个能力标签,比如 web-search、memory、vision 或 theme。
  • 只有在能帮人做决定时才加语言标签,比如 typescript 或 python。

这个话题是你能做的杠杆最高的一件事,因为它能让一个未被索引的仓库变成可被发现的仓库,而且完全不需要提交任何东西。

第 3 步:写出能经得起自动化处理的元数据

目录站点会基于仓库元数据生成条目。也就是说,你的仓库描述和 README 实际上就是你的条目页:

字段 来自哪里 为什么重要
名称与一句话简介 仓库描述 会成为条目的标题行
分类 描述关键词加人工复核 决定你出现在哪些分类页
安装规格 README 的安装代码块 成为可复制的命令
兼容性 dshTarget 声明 在不匹配的搜索里把你过滤掉
许可证 LICENSE 文件 大多数目录站点都要求
活跃度 提交日期 供给“最近更新”视图

把仓库描述写成一句开发者会拿去搜索的话,而不是一句口号。free web search provider for DeepSeek Harness with a DuckDuckGo backend, no API key needed 要比 awesome search for agents 好得多。

第 4 步:诚实地声明兼容性

声明你测试过的 harness 版本。夸大兼容性会带来安装失败和最低评价;低估它则会排除掉那些本来没问题的用户。更新插件时,同步更新这份声明。

第 5 步:提交到目录站点

提交通常就是一个 URL 加一段简短描述。开始之前请准备好以下内容:

  1. 仓库 URL。
  2. 一句 160 字符以内的描述。
  3. 确切的安装命令。
  4. 你认为最合适的分类。
  5. 审阅者应该知道的信息,比如必需的凭据或付费端点。

你可以在提交页面向本站提交。预计审阅会集中评估与收录相同的四个信号:来源、安装规格、权限与维护状态。

第 6 步:让条目自己保持准确

条目会过期,因为仓库在变而元数据不变。两个习惯可以避免这一点:范围变化时同步更新仓库描述,并让 README 里的安装命令与已发布的包名保持一致。一个显示错误安装命令的条目,比没有条目更糟。

FAQ

必须发布到 npm 吗?

不必。git 安装规格也能用,但对处在代理后面的用户来说,npm 包安装得更快、更可预期。

加了话题标签就一定能被收录吗?

对扫描话题的目录站点来说,这让发现变成自动的。在条目出现之前,仍可能有人工复核。

目录站点会托管我的插件吗?

不会。目录站点只索引元数据并链接到你的源码。安装始终发生在你的仓库或包上。

如何纠正一个错误的条目?

联系目录站点。本站通过联系页面接受纠正。

下一步

读一读安全指南,让你的文档能回答审阅者会提出的问题,然后通过提交页面提交。

来源与参考

本页的技术判断建立在以下第一手资料之上,链接可直接追溯核对。

  1. [1]dsh-plugin GitHub topic — GitHub本站用于发现收录插件的检索入口。
  2. [2]Classifying a repository with topics — GitHub Docsdsh-plugin topic 的添加方式,以及为何 topic 是公开可验证的信号。
  3. [3]@deepseek-ai/dsh on npm — npm已发布的 harness 包,也是本站 dshTarget 字段跟踪的版本来源。
  4. [4]About semantic versioning — npm Docs兼容性与 dshTarget 建议所依据的版本号约定。
  5. [5]Keep a Changelog 1.1.0 — Keep a Changelog建议插件采用的可维护变更日志约定。
  6. [6]MIT License — Open Source Initiative本站插件最常声明的许可证的权威文本。

全部链接最后核验于 2026-09-11

ESC

输入关键词搜索索引,索引由 Pagefind 在部署时生成。