DSH Plugins Marketplace

DSH Plugins

Plugins

/

Tools & Capabilities

/

dsh-nanshan-market-publish

S

dsh-nanshan-market-publish

Manifest valid

[Nanshan] DSH Plugin Marketplace Release: Scans DSH components currently being developed on the local machine, guides you through two tracks according to the official contributing.md requirements to complete GitHub code submission and plugin marketplace inclusion PR, and generates data/plugins/<owner>__<repo>.yml.

UI (client)hasBundlePatch

【南山】DSH插件市场发布助手

左侧栏插件:扫描本机正在开发的 DSH 组件,按官方 contributing.md 分两条互相独立的轨道引导发布:

  1. GitHub 提交 —— 初始化仓库、创建公开仓库、提交推送、添加 dsh-plugin topic。
  2. 市场收录 PR —— 生成 data/plugins/<owner>__<repo>.yml,fork 官方列表仓库、写入条目、开 PR,并跟踪 CI 与 held: author 状态。

两条轨道各自有独立的进度与按钮:只做完 GitHub 提交,组件已经是可安装的公开仓库;再做收录 PR,市场里才能搜到它。

两个轨道

543842fe-69d4-4e70-9a07-320058a498a7

功能

  • 组件发现:自动发现本机档案里以 link: 安装的 DSH 组件,以及打开的 workspace;也可以点「选择文件夹」调起系统原生文件夹选择器,选中任意组件目录后加入清单(校验 package.json 里是否有 dsh.bundle / dsh.client)。原生选择器不可用时(例如某些远程页面)才会退回手工输入绝对路径。
  • 官方预检:把 contributing.md 里会被 CI 与人工评审检查的项目逐条算成清单——dsh.bundle 声明、真实代码、仓库公开、满 1 天、dsh-plugin topic、分类取值、英文描述必填与句号、描述含营销词、图标必须是 GitHub 托管的位图、tarball 链接、monorepo 子包路径、官方包需用 peerDependencies 等。
  • 一键动作:初始化仓库、创建并推送、提交并推送、加 topic、提交收录 PR,背后是 git 与 GitHub REST API。
  • 傻瓜式引导:7 步流程,只把「下一个还没完成的动作」放大显示,做完一步自动推进。
  • PR 跟踪:PR 状态、CI 检查项、标签(含 held: author)、变更文件、最近评论;可直接补一条评论。
  • 记录:建库、推送、topic、PR、评论都留本地记录,附 GitHub 链接。

安装

# 本地目录安装
dsh plugin add /path/to/nanshan-market-publish

或在 DSH 的 插件 页面选择 添加插件 并指向本目录。安装后在左侧栏点 「插件市场发布助手」。面板分四个页签:组件清单、发布引导、发布记录、设置。

连接 GitHub

打开 设置 → GitHub 连接,填入一个 classic Token,勾选 public_repo(需要操作私有仓库时用 repo)。

  • Token 写入 DSH 凭据服务(ctx.credentials 的 record),不写进配置文件、不会回传给页面、不进入状态文件。
  • 也支持环境变量 GITHUB_TOKEN / GH_TOKEN / NSMP_GITHUB_TOKEN 作为兜底来源。
  • 不需要安装 gh CLI。

两条轨道分别做什么

轨道 A:GitHub 提交

步骤动作产物
初始化git init -b main(父目录已是仓库时跳过).git
创建并推送POST /user/repos 建公开仓库 → 设置 origin → git add -A + git commit → git push -u origin HEAD:main远端仓库
提交并推送之后每次改动的增量提交与推送新提交
添加 topicPUT /repos/{owner}/{repo}/topics 追加 dsh-plugintopic

推送使用一次性 credential helper(Token 通过子进程环境变量传入),不会把 Token 写进 .git/config。

轨道 B:市场收录 PR

  1. 填条目:分类(官方 23 个取值)、英文描述(必填)、中文描述(可选)、可选的卡片图标与 tarball。
  2. 预检:逐条对照官方要求,失败项写明「怎么改」。
  3. 提交:fork awesome-dsh-plugin/awesome-dsh-plugin → 从默认分支开 add-<repo>-<id> 分支 → 写入 data/plugins/<owner>__<repo>.yml → 开 PR。
  4. 跟踪:PR 状态、CI check-runs、标签、变更文件、评论;被打上 held: author 时给出「推同一分支 + 留一条评论」的说明。

仓库创建不满 1 天时,插件会在本地拦下 PR 提交并显示还差多久——CI 一定会拒,提前开 PR 只会多一个红叉。到点后再点一次即可。

提交重试是幂等的:分支名固定为 add-plugin-<repo>,已有分支和条目文件会被复用/更新,不会每次都留下一个孤儿分支。

一个 PR 只提交 1 条条目;描述含 : 会自动加引号,避免 YAML 解析成嵌套键。

官方要求(插件内置了同一份清单)

  • package.json 声明 dsh.bundle(只写 dsh.client 无法安装,是最常见的被拒原因)。
  • 仓库公开、有真实可用代码、创建满 1 天。
  • 仓库带 dsh-plugin topic。
  • 一个 PR 只加一个文件,最多 3 条条目;描述必须属实、不带营销词,分类选最贴近功能的。
  • 可选:1-8 张截图写在仓库自己的 screenshots.json;发 npm 时 repository 必须指回该仓库。

CI 通过只是前置条件,维护者会读代码;需要修改时会被打上 held: author。

常见问题

推送报 Error in the HTTP2 framing layer

GitHub 的 HTTP/2 连接被代理、VPN 或公司网关打断时的典型报错。插件会自动改用 http.version=HTTP/1.1 重试一次;成功后会把「这个组件走 HTTP/1.1」记在本地,之后直接走 HTTP/1.1(操作记录里会标 HTTP/1.1)。命令行里遇到同样问题时:

git config --global http.version HTTP/1.1   # 撤销:git config --global --unset http.version

如果重试仍失败,检查 HTTPS_PROXY / HTTP_PROXY 是否指向一个已经失效的代理。

推送被拒:Authentication failed

Token 需要 repo 权限(classic)或对目标仓库有 Contents 写权限(fine-grained);远程地址是 SSH 时则依赖本机 SSH 密钥。

数据与隐私

  • 状态:~/.dsh/nanshan-market-publish/state.json(组件清单、条目草稿、PR 编号、操作记录)。
  • Token:DSH 凭据服务的 nanshan-market-publish/github-token 记录。
  • 只读取你选择或扫描到的组件目录中的 manifest、patch、locale、图标与 Git 元数据,不执行组件代码。
  • 除 GitHub API(api.github.com)与本地 git 外不发起任何网络请求。
  • 卸载插件不会删除 GitHub 上的仓库与 PR;本地状态文件可以手动删除。

限制

  • 未安装 gh CLI 也能用:所有 GitHub 操作走 REST API 与 git。
  • GitHub 仓库年龄由 GitHub API 返回的 created_at 计算;未连接 Token 时这一项显示为「待确认」。
  • 推送走 HTTPS。若 origin 是 SSH 地址,插件会执行普通的 git push,需要你本机已配置 SSH 密钥。
  • 无法在本机完成 fork 的自动同步:fork 落后时用新条目分支提交即可,条目文件是新增文件,一般不受影响。

English

A left-sidebar DSH plugin that scans DSH components under development on this machine and walks you through the official contributing.md in two independent tracks: submitting the code to GitHub (initialise, create a public repository, commit and push, add the dsh-plugin topic) and opening the market listing PR (generate data/plugins/<owner>__<repo>.yml, fork, write the entry, open the PR, follow CI and held: author).

Every mechanically checkable rule from the guide is computed as a checklist with a concrete fix, and each track can be completed without the other. A GitHub token with public_repo scope is required and is stored in the DSH credentials service; repository creation, topics, the fork branch and the PR all go through the GitHub REST API, so no gh CLI is needed. The plugin reads only manifests, patches, locale files, icons and Git metadata of the folders you choose, never executes component code, and sends nothing anywhere except GitHub.

Comments

Loading…

Similar plugins

dsh-nanshan-publish-manager

by SouthM

【南山】DSH发布管理:以 npm 包(dsh.bundle + dsh.client)的官方形式,管理本机 DSH 组件的发布设置、发布预检查、npm 发布与发布记录。

Tools & CapabilitiesManifest valid

★ 0

JavaScript

Nov 18, 2026

dsh plugin --profile web add @wangnanshan/dsh-nanshan-publish-manager

by Noob-stupid

DeepSeek Harness (DSH) 插件管理面板:一键启用/停用插件 + GitHub dsh-plugin 插件市场,带插件详情与一键安装,一键框架升级自动回滚 | Plugin manager & marketplace for DeepSeek Harness

UI & ExperienceManifest valid

★ 103

↓ 7k/wk

MIT

JavaScript

Aug 25, 2026

dsh plugin --profile web add @noob-stupid/dsh-plugin-console

by fazhu4

DSH plugin manager: official/community grouped plugin list with localized descriptions, one-click enable/disable and uninstall, plus a GitHub dsh-plugin market tab.

Terminal & ClientsManifest valid

★ 4

↓ 159/wk

MIT

TypeScript

Aug 18, 2026

dsh plugin --profile web add dsh-plugin-studio

by Charlestam218

DSH 插件发布器:把本地做好的插件一键推送到 GitHub 仓库(凭据 → 建仓 → 提交 → 推送 → 可选 Release)

Manifest valid

★ 0

JavaScript

Oct 2, 2026

dsh plugin --profile web add dsh-github-publish

by Jackbessaliuz

DSH 插件市场的补丁层:一键更新全部(退出后自动完成并重开)+ 更新安全网(启动失败自动回退)+ 本地插件更新检测与快照回滚。

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 4

MIT

JavaScript

Nov 17, 2026

dsh plugin --profile web add dsh-market-expand

by HarrisXiu

DSH(DeepSeek Harness)插件发现工具:自动在 GitHub 与 npm 上检索社区插件,给出每个插件的 npm 包名与 GitHub 仓库地址,并内置一份可安装的推荐清单。装上后可在侧边栏「插件发现」页面浏览搜索,也可以让 agent 直接调用 dsh_plugin_finder 工具检索。

Manifest valid

★ 0

MIT

JavaScript

Sep 30, 2026

dsh plugin --profile web add dsh-plugin-finder