插件即原生
风格、版本，双重对齐
跨会话记忆、成本审计、GitHub / npm 连接器 —— 每一个像素都对齐 DSH Web 官方设计系统，每一次 dsh 升级都经过两道闸体检。
跨会话记忆、成本审计、GitHub / npm 连接器 —— 每一个像素都对齐 DSH Web 官方设计系统，每一次 dsh 升级都经过两道闸体检。
不是"风格相似"，而是直接复刻 DSH 的设计令牌。插件渲染在 DSH 设置面板里，与官方界面放在一起分辨不出来——因为它们本就出自同一套 design-platform.css。
颜色、圆角、字号、间距逐项取自 DSH 的 --dsw-* 变量表：bluish 灰阶、deepseek 品牌蓝、14px 卡片圆角、13px 正文节奏。
折叠设置卡、Pill 徽章、Segmented 分段器、StateDot 状态点、KPI 卡——全部按官方组件的结构与交互态实现，含深浅双主题。
文案走 DSH 的 locale 体系（默认中文），加载态、空态、错误态全部遵循官方规范——安装后没有"第三方感"。
host（能力）+ client（设置页 UI）+ wire（协议）分层，全部跑在 DSH 插件机制上，pnpm dev 一键装入 profile。
GitHub 连接器：令牌写入本机凭据存储，永不回显。
成本审计：把每次会话折算成真金白银。
跨会话/跨工作区共享记忆层。
npm 发布管线：token 全权接管——从起名、发布、打标签、弃用到 OIDC trust。
复刻 DSH 设计系统的本地 React 组件库，零 cordis 依赖。
插件事件订阅运行时与 remote 协议定义，新插件的小时级脚手架。
dsh 迭代很快，接口与事件随时改名。本插件线只承诺一件事：与最新发布版 dsh兼容——每次发版都由 CI 用最新 dsh 构建并跑完整验收。其他版本请先跑两道闸。
真实教训：dsh 曾把 ProjectionDefinition.schema/view 改成 stateSchema/wire、把事件 credentials/updated 改名 credentials/reference-updated——旧插件装上新版 dsh，轻则编译失败，重则静默失效。
| 你的 dsh 版本 | 兼容状态 | 说明 | 建议动作 |
|---|---|---|---|
| 0.1.5-rc.2（最新） | 完全兼容 | 发布流水线用该版本构建，并用发布出去的资产端到端验收通过 | 直接安装 |
| 其他版本 | 未验证 | 本线只保证最新版兼容：更旧的可能缺符号，更新的接口面未知 | 先升 dsh / 跑两道闸 |
pnpm check:dsh-upgrade
把插件实际 import 的符号、接口成员、事件名逐个对到新版 .d.ts 里——删符号、改字段、换事件名都逃不掉。报告自动归档 docs/dsh-upgrade-reports/。
pnpm dryrun:dsh-upgrade
临时目录钉新版本、干净安装、全仓编译——专抓第一道闸报不出的运行期语义破坏。全绿才允许正式升级。
当前插件线只保证与最新 dsh 兼容（当前 0.1.5-rc.2），其他版本先看上方兼容矩阵。需 Node ≥ 18；不需要 git（需要 pnpm：corepack enable 即可）。
dsh --version
从 GitHub Release 下载预构建产物、校验 sha256 后装进 profile。不 clone、不构建：
curl -fsSL https://neil-ji.github.io/dsh-spark-plugins/install.sh | sh
Windows（PowerShell 5.1+）：
irm https://neil-ji.github.io/dsh-spark-plugins/install.ps1 -OutFile install.ps1; .\install.ps1
Windows（cmd.exe，薄包装，等价）：
curl -fsSL -o install.cmd https://neil-ji.github.io/dsh-spark-plugins/install.cmd && install.cmd
重启 dsh web，点右下角悬浮球打开指挥舱，在各模块里完成连接配置。变体：
install.sh --version v0.2.0 --profile web
Windows：.\install.ps1 -Version v0.2.0；只装部分插件 --only dsh-spark；装到沙箱 home（不碰 ~/.dsh）--home .\.dev\home；开发路径 --from-source
profile 里其它插件、它们自己的 override 与补丁一律保留。建议先预演：
install.sh --uninstall --dry-run
确认后执行 install.sh --uninstall；Windows .\install.ps1 -Uninstall -DryRun；保留缓存加 --keep-cache / -KeepCache
Windows：.\install.ps1 -Version v0.2.0；只装部分插件 --only dsh-spark；装到沙箱 home（不碰 ~/.dsh）--home .\.dev\home；开发路径 --from-source