插件工坊 (dsh-plugin-forge)

DSH 的理念是“一切皆插件”。编写本地插件需要遵循特定的格式规范,并积累开发中的经验以避免重复踩坑。dsh-plugin-forge 是一个元插件,允许在任意工作区按 dph 格式快速脚手架 DSH 本地插件,并维护踩坑经验库持续修正开发。

这是 CAI-MH 维护的一个工作流类插件。

核心功能

插件提供了四个主要命令,覆盖从开发到部署的全流程:

  • 获取规范与经验:plugin_forge_guide,用于获取最新的格式规范以及踩坑经验库,写插件前必读。
  • 生成骨架:plugin_forge_scaffold,在当前工作区生成可加载的 bundle 骨架,用于后续实现业务逻辑。
  • 校验与安装:plugin_forge_install,校验插件并安装到本机 web profile,需重启 DSH 生效。
  • 记录经验:plugin_forge_experience,用于记录或查看踩坑经验,解决一个问题后应记录,反哺后续开发。

典型用法

  1. 写插件前:执行 plugin_forge_guide,阅读最新的格式规范与经验库。
  2. 生成骨架:执行 plugin_forge_scaffold 生成骨架文件。
  3. 实现逻辑:在生成的骨架中编写具体的业务逻辑代码。
  4. 安装插件:执行 plugin_forge_install 完成校验与安装,随后重启 DSH。
  5. 记录坑点:每解决一个开发中的问题,执行 plugin_forge_experience(action=add) 将经验写入库中。

踩坑经验库

踩坑经验库是全局共享的,存储位置为:
~/.dsh/plugin-forge/EXPERIENCE.md

首次使用时,该库会自动写入种子经验。该文件在所有工作区间共享,适合作为团队或个人的通用避坑指南。

安装与启用

目前未在已抓取资料中找到官方安装命令。该插件以 module 类型存在,通过 DSH bundle 的形式加载。

注意事项

  • 插件类型为 module。
  • 安装插件后必须重启 DSH 才能生效。
  • 插件以当前 DSH 进程的权限运行,安装前应检查源码与许可证(MIT)。

总结

这个工具通过规范化的脚手架和全局经验库,降低了 DSH 插件开发的门槛,并确保踩坑经验能够被持续沉淀和复用。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜