dsh-plugin-core-demo

中文文档
0.22.1发布于 2026/11/03MITES Module零依赖构建来源已验证

DSH插件的共享UI基础,具有实时组件预览:设计令牌,公共控件,工作区浏览和通知维护在一个地方-安装它可以预览真实主机中的每个组件。

中文使用文档
文档目录3 节
  1. 构建
  2. 发布与安装
  3. 实现要点

dsh-plugin-core-demo

在 真实 DSH 宿主里预览 dsh-plugin-core 的控件与业务组件的插件。

它和库是完全分开的两个 npm 包(库是纯库,只有子路径导出;本包是插件):

包用途
库dsh-plugin-core各插件按子路径引用(/ui /utils /design …)
插件dsh-plugin-core-demo(本包)装进 DSH,宿主内预览

构建

# 在仓库根先构建库(本包引用 ../../dist/)
pnpm run build
# 再构建本包 → dist/index.js(server 壳)+ dist/client.js(预览页 bundle)
pnpm run build:demo

dist/ 与 src/ 一起入库:宿主安装插件时不跑构建脚本。

发布与安装

不要在本目录手跑 npm publish。 本包与核心共用同一个 vX.Y.Z tag,由 .github/workflows/demo-publish.yml 自动发布;版本必须与根 package.json 完全一致 (test/version-sync.test.mjs 与 CI 都校验,不一致直接失败)。

git tag v0.1.3 && git push origin v0.1.3      # 在仓库根:一次 tag 发库 + 本包
dsh plugin --profile web add dsh-plugin-core-demo

装好后:插件列表 → 本插件 → 设置页里的「组件预览」卡片 → 点开即整页预览;也可点侧栏图标。

实现要点

  • client 侧只导出 apply;依赖一律 ctx.inject([...], cb) 内等待(顶层导出 inject 会卡死宿主启动)。
  • 三块注册(sidebar.panellist / main / settings.plugin.item)各自 ctx.inject、自成一块; settings.plugin.item 与 main 的 key 必须 = 包名(宿主机制)。
  • 变量前缀统一用 dshpc,不碰 --dsw-* / --dsh-*(宿主在用); 展示代码直接用 --dshpc-*。
  • 零运行时依赖:不引内部 @deepseek-ai/*,故不声明 schemastery Config。

版本与发布记录

dsh-plugin-core-demo 共发布 64 个版本,首次发布于 2026/10/19;过去 12 个月发布了 64 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.22.1latest2026/11/03今天
0.22.02026/11/03今天
0.21.02026/11/03今天
0.20.92026/11/03今天
0.20.82026/11/03今天
0.20.72026/11/03今天

关于 dsh-plugin-core-demo 的常见问题

dsh-plugin-core-demo 是什么?

DSH插件的共享UI基础,具有实时组件预览:设计令牌,公共控件,工作区浏览和通知维护在一个地方-安装它可以预览真实主机中的每个组件。

如何安装 dsh-plugin-core-demo?

在项目目录运行 npm install dsh-plugin-core-demo,或使用 pnpm add / yarn add / bun add。

dsh-plugin-core-demo 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/dsh-plugin-core-demo 是否存在。

dsh-plugin-core-demo 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

dsh-plugin-core-demo 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.5。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

dsh-plugin-core-demo 可以商用吗?

dsh-plugin-core-demo 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

dsh-plugin-core-demo 还在维护吗?

最新版本 0.22.1 发布于 2026/11/03(今天);至今共发布 64 个版本,其中过去 12 个月发布了 64 个;首次发布于 2026/10/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。