akira399/dsh-plugin-publisher

DSH插件开发与GitHub发布工作流技能插件(consent-gated)— 开发、验证、发布及市场可见的DSH插件

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH) that automates the entire workflow of DSH plugin development and GitHub publishing. It ships with both host-side backend logic and a client-side graphical settings page that you can access through DSH’s web GUI. After installation, it registers a built-in skill called dsh-plugin-publishing that is enabled by default, and follows an opt-out rule where it remains active unless you explicitly disable it in the settings. The skill allows AI to complete the full process of packaging a skill into a valid DSH plugin, running local validation, and publishing it to a GitHub repository, but only after you give explicit consent for each publishing operation.

This plugin is designed for DSH plugin developers who want to streamline their plugin release workflow. It covers every step of the development and release process, from checking your local environment for required dependencies like node, pnpm, git, and DSH CLI, to looking up DSH plugin contract conventions, generating standard directory structures, running multiple validation checks, and publishing to GitHub. After publishing, the plugin can guide users through installing the new plugin directly via the official DSH CLI, no third-party plugin marketplace is required. To install this plugin, you can run the official command npx -p @deepseek-ai/dsh dsh plugin --profile web add github:akira399/dsh-plugin-publisher and restart DSH after installation completes.

The plugin is released under the open-source MIT license, and has zero third-party dependencies. You can configure the plugin’s settings through DSH’s graphical settings page after restarting DSH. You can toggle the skill on or off, and optionally add a GitHub fine-grained personal access token (PAT) that the plugin will store in your system’s Git credential manager. The PAT is never displayed or shared by the plugin, and is only used for authenticated Git operations. All write operations like creating a repository or pushing code require your explicit approval before they run, and you are responsible for checking for any sensitive information in your code before publishing it publicly.

这是一款专为 DeepSeek Harness(DSH)开发的原生插件,提供 DSH 插件开发与 GitHub 发布的完整工作流,包含 Host 端逻辑和图形化设置页。安装完成后会自动注册默认启用的 dsh-plugin-publishing 技能,采用退出式 opt-out 启用规则,AI 可借助该技能在获得用户明确授权后,独立完成从技能打包、本地验证到发布至 GitHub 的全流程。

本插件适合 DSH 插件开发者使用,可帮助开发者自动化完成插件开发的全流程,包含环境依赖检查、DSH 插件契约规范速查、标准目录结构生成、多维度验证打包和 GitHub 发布流程。开发者仅需对发布操作进行确认授权,即可完成插件的发布和分发,整个过程不依赖任何第三方插件市场。

本插件采用 MIT 许可开源,零第三方依赖,可通过官方 DSH CLI 命令完成安装,安装后需要重启 DSH 才能生效。用户可在图形化设置页配置技能启用状态和可选的 GitHub 细粒度个人访问令牌(PAT),PAT 仅存储在本地凭据管理器,不会回显或外传。所有操作必须经用户授权,发布代码需用户自行检查隐私风险。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:akira399/dsh-plugin-publisher

把 akira399/dsh-plugin-publisher 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-plugin-publisher

DeepSeek Harness(DSH)插件开发与 GitHub 发布工作流插件(双端:Host + 设置页 GUI)。

安装后插件会把内置的 dsh-plugin-publishing 技能注册到会话(默认启用):AI 可据此独立完成「把技能打包成 DSH 插件 → 本地验证 → 发布到 GitHub」的完整流程。

⚠️ 启用状态(opt-out):技能默认启用,保存后刷新仍保持启用;只有你在 DSH 设置页(设置 → 插件配置 → dsh-plugin-publisher)主动取消勾选「启用技能」并保存后才会停用。「默认启用」不等于「自动发布」——每次创建公开仓库/推送代码前,AI 仍会先征得你的明确同意。可在同一卡片(可选)填入自己的 GitHub PAT。

技能内容

  • 铁律:用户授权门禁、隐私红线(token/凭据/本地路径/个人信息绝不入仓)、免责声明、超时不死等
  • 环境确认:node / pnpm / git / dsh CLI / GitHub 凭据检测(不回显 token)
  • DSH 插件契约速查:bundle / profile / patch 层(insert vs 覆盖)/ host+client 双端 / 运行时技能注册 / 零依赖策略 / 设置区 schema 免依赖写法 / 凭据联动
  • 开发步骤:标准目录结构、package.json、cordis.patch.yml、lib/index.js、lib/client.js、SKILL.md、.gitattributes
  • 验证矩阵:node --check + mock 单测(含门禁/设置/凭据监听)+ scratch 组合测试(⚠️ 不能跑任务)+ headless 运行时测试(off/on)
  • GitHub 发布:隐私扫描 → 建仓 → 打标签(可选)→ 推送 → 匿名/克隆验证
  • 分发与启用:官方 dsh plugin 安装 + 设置页图形化启用;不依赖任何第三方插件市场
  • FAQ / 超时处理、授权与安全、免责声明

安装(官方路径)

npx -p @deepseek-ai/dsh dsh plugin --profile web add github:akira399/dsh-plugin-publisher

安装完成后重启 DSH(重新运行 dsh web)。

启用状态与配置(图形化)

重启后打开 DSH Web GUI → 设置 → 插件配置 → dsh-plugin-publisher 卡片:

  1. 启用技能:默认勾选(启用),保存后刷新保持启用;要停用请取消勾选 → 点「保存」,技能即注销。
  2. GitHub PAT(可选):在「GitHub PAT」输入框粘贴你的 Fine-grained Personal Access Token(PAT) → 点「保存」。插件会自动把它同步到系统 Git 凭据管理器,之后 git push/git clone 直接可用;内容永不回显,只写入 DSH 凭据存储与系统凭据管理器。

效果即时生效;可用性说明:

  • 技能启用时,会话技能目录中即出现 dsh-plugin-publishing;用它时 AI 仍会先征得你对每次发布操作的明确同意。
  • 若未填 PAT,技能照常可用——AI 会优先使用系统已有的 Git 凭据,没有则向你询问。

如何创建 GitHub PAT(Fine-grained Personal Access Token)

  1. 打开 GitHub → 右上角头像 → Settings
  2. 左侧最底部 Developer settings → Personal access tokens → Fine-grained tokens
  3. 点 Generate new token,填写名称(如 dsh-publish)与有效期
  4. Repository access 选择 All repositories(因为需要创建新仓库,无法预先指定一个不存在的仓库)
  5. 在 Permissions → Repository permissions 中授予:
权限 访问级别 用途
Contents Read and write 推送代码(git push / HTTPS)
Administration Read and write 通过 API 创建/删除仓库、设置 Topics
Metadata Read 自动包含(必选,保持开启)
  1. 点 Generate token,复制(只显示一次)后粘贴到设置卡片的输入框

Fine-grained PAT 形如 github_pat 开头(后接下划线与一长串随机字符),与旧的 classic PAT(ghp 开头)不同。本插件只把它写入系统 Git 凭据管理器用于推送,不会回显或上传。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-phone 下一个 Next dsh-conversation-manager →