SuperAPI AI 工具集

dsh-plugin-dev

设计与创作

查看项目

更新于 10-15 20:10

技能介绍

用途:为 DSH Desktop 开发插件、把 Pi/Hermes 插件迁移到 DSH、做隔离装载实验、排查插件在真实宿主的行为、跟进版本升级适配,以及在发布前做机械审查与验收。该技能不代替实现者:创建插件先做设计预检,实现后回来做正式验收,审查器与生产者责任不混同。

主要能力:提供 scripts/lint.mjs 机械审查层(版本感知)、scripts/test-lint.mjs 自测、config/harness-path.example.yaml 路径配置示例、templates/plugin-quality-report.md 报告模板。审查规则分 §0 harness 溯源至 §9 文档版本残留,覆盖 package.json 版本漂移、dsh.bundle、exports 入口、dsh.client、client 工件、主题变量、locale 与 CJK 硬编码等。工作模式分设计预检、快速审查、正式验收三档。

使用方式:依赖 Node ≥ 18.6,无第三方包。运行审查:node skills/dsh-plugin-dev/scripts/lint.mjs <插件目录> --harness-root <DSH 源码仓库>;追加 --json 输出机器可读行,退出码等于 FAIL 数。harness 根解析优先级为 --harness-root 参数、DSH_HARNESS_ROOT 环境变量、config/harness-path.local.yaml。自测命令:node skills/dsh-plugin-dev/scripts/test-lint.mjs。

适用场景:Host 半体手写 ESM function plugin、业务对象与会话关联、会话投影、隔离装载验证(DSH_HOME 隔离与 profile 快照恢复)、宿主级验证、独立审查与踩坑回写。

限制:正则级解析不构建 AST,复杂 patch 结构与嵌套词典转人工(WARN/NOT_VERIFIED),bare builtin require 与 JSX CJK 检测为启发式需人工确认;harness 溯源需本地 DSH 源码仓库,缺依赖时版本相关检查标 NOT_VERIFIED。mock 冒烟不等于宿主验证,也不等于 GUI 验证,缺失证据须标 NOT_VERIFIED。开发依据版本必须与本机 Desktop 内嵌运行时一致。其他细节(如收费、平台支持)暂未提供。