dsh-web-ui 插件准入指南:5 步判断你的插件能否进全家桶

📅 2026/8/19 17:52:36
dsh-web-ui 插件准入指南:5 步判断你的插件能否进全家桶
dsh-web-ui 插件准入指南5 步判断你的插件能否进全家桶【免费下载链接】dsh-web-uiPlugin and skin collection for DeepSeek Harness (DSH) Web UI - task board, git graph, right-side panel, remote mobile UI, pet, live token stats, and skin center.项目地址: https://gitcode.com/gh_mirrors/ds/dsh-web-uidsh-web-ui 是 DeepSeek HarnessDSHWeb UI 的插件与皮肤全家桶——任务看板、Git 图谱、右侧面板、远程移动端、桌面宠物、实时令牌统计与皮肤中心都出自这个仓库。社区插件想进来别急着提 PR先跟着本文走一遍完整的准入流程先做自检归类再选收录或登记通道最后对照合规红线与检查清单确保一次通过。先做一张准入自检你的插件属于哪一类在动手提交之前先回答一个关键问题这段代码的版权到底归谁这个答案直接决定了你的插件走哪条收录路径。家族仓库欢迎社区插件但收编必须透明所有规则都写在仓库的 docs/plugins.md 里。你可以用下面这张自检表快速归类插件状态判定标准对应处理方式活跃且有上游维护上游还在持续更新不搬代码fork 或作为依赖引用满足收编条件上游停更、无活跃上游、或作者明确授权托管git subtree 迁入保留完整历史触犯合规红线无 LICENSE、作者未授权、版权归属不明一律不收编自检完成后绝大多数情况都能对号入座。接下来我们分别看这两条合法通道怎么走。能引用就不搬代码活跃上游插件的正确去向如果你的插件活跃且有上游维护家族仓库不会搬运你的代码。正确的做法是 fork 到 dsh-external 组织维护或者作为依赖被全家桶引用——这样既保留上游关联又能随时 merge 上游的更新全家桶只负责注册它的安装入口其余交给上游自己迭代。记住这句强对比能引用的不搬代码要收编的必留痕迹。只有当你明确想放弃上游、把插件正式托管进家族仓库时才需要考虑收编。要收编必留痕迹合规审核看什么满足收编条件上游停更、无活跃上游、作者授权托管后迁入动作本身也有硬性要求用git subtree add迁入保留完整 git 历史必须保留上游 LICENSE 文件与作者署名包内 LICENSE、README 作者声明在包 README 记录来源仓库与迁移日期版权归原作者本仓库仅托管、不主张版权。合规红线只有三条碰任何一条直接出局无 LICENSE、作者未授权、版权归属不明。这条底线保护了原作者权益也让每个用户用得安心——全家桶里收录的每一段代码都有清晰出处。一个插件从提交到上线的完整流程确认走收编路径后按下面七步推进。需要提醒的是全新功能、新插件暂不接受直接 PR先提 issue 讨论、确认后再动手这是仓库贡献指南CONTRIBUTING.md的明确约定。提 issue 讨论插件方案确认收编意向跑脚手架生成标准骨架node scripts/dsh-plugin-new name自动产出双语 README 三件套与 AGENTS.md 模板实现逻辑src/index.ts是 host 半区跑在 dsh 进程侧src/client/是 browser 半区Web GUI 侧src/core/放两侧共享的纯逻辑注册进聚合包把- ../name追加到packages/dsh-web-ui-all/aggregate.yml的patchFrom和deps再运行node scripts/aggregate.mjs构建验证pnpm install后跑pnpm -r build本地挂载验证node scripts/link-profile.mjs把全家桶链接进 profile重启dsh web确认插件行生效提 PR按模板填写、门禁全绿、用户可见功能附截图证据、使用 AI 编码时如实披露。收录不等于一劳永逸五个必须遵守的包级规范被收编的插件还要遵守全家桶的通用规范确保生态一致命名新包一律dsh-前缀npm 包名linxin666/dsh-*挂载只通过cordis.patch.yml profile 机制挂载到 DSH Web UI绝不修改 DSH 源码类型来源只能基于官方 NPM SDKdeepseek-ai/*禁止 tsconfig 指向任何 DSH 源码 checkout双语纪律主包 README 必须中英配对README.mdREADME.zh.mdREADME.i18n.yaml任一侧改动要同步另一侧测试纪律每个包必须有vitest run可通过的测试行为变化必须带测试。这五项是 CI 门禁的一部分缺一不可——它们共同保证了全家桶装得齐、跑得稳、改得动。不想被收编还有一条轻量登记通道如果只想让更多人发现你的插件而不想把代码迁入仓库可以用社区插件索引它只收录链接、不搬代码条目版权归原作者。在设置 → 社区插件里每个条目都链接到作者自己的仓库目前 Data Agent、dsh-TUI、天书 TUI 等社区插件都是这样登记的。登记只需三步在packages/dsh-community-plugins/community.json追加条目id/name/nameEn/author/repohttps:// 仓库 URL必填description/descriptionEn/npm可选运行node scripts/community-index重新生成注册表并提交生成的community.ts运行pnpm community:check校验数据与生成物一致这是 CI 门禁。提交前对照这份清单避开最常见的被拒原因最后把最容易踩坑的四种情况摆在桌面上提交前逐条核对代码没有 LICENSE或版权归属说不清——红线问题直接拒绝全新功能 / 新插件跳过 issue 直接开 PR——会被打回先去讨论确认只改文档的 PR标题以 docs: 开头——会被自动关闭文档改动先提 issue门禁不过——typecheck、test、docs:check 必须全绿涉及聚合包、画廊、皮肤中心时还要跑 aggregate:check / gallery:check / skin-center:check提交信息与文档禁带 emoji。下一步做什么如果你是插件作者先读仓库的 docs/plugins.md 与 CONTRIBUTING.md确认自己的插件满足收编条件再按流程提 issue、实现、过门禁。如果你是普通用户也可以放心——设置页里出现的每一个插件都经过了同样的合规审查。【免费下载链接】dsh-web-uiPlugin and skin collection for DeepSeek Harness (DSH) Web UI - task board, git graph, right-side panel, remote mobile UI, pet, live token stats, and skin center.项目地址: https://gitcode.com/gh_mirrors/ds/dsh-web-ui创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考