DSH 的理念是“一切皆插件”。编写本地插件需要遵循特定的格式规范,并积累开发中的经验以避免重复踩坑。dsh-plugin-forge 是一个元插件,允许在任意工作区按 dph 格式快速脚手架 DSH 本地插件,并维护踩坑经验库持续修正开发。
这是 CAI-MH 维护的一个工作流类插件。
核心功能¶
插件提供了四个主要命令,覆盖从开发到部署的全流程:
- 获取规范与经验:
plugin_forge_guide,用于获取最新的格式规范以及踩坑经验库,写插件前必读。 - 生成骨架:
plugin_forge_scaffold,在当前工作区生成可加载的 bundle 骨架,用于后续实现业务逻辑。 - 校验与安装:
plugin_forge_install,校验插件并安装到本机 web profile,需重启 DSH 生效。 - 记录经验:
plugin_forge_experience,用于记录或查看踩坑经验,解决一个问题后应记录,反哺后续开发。
典型用法¶
- 写插件前:执行
plugin_forge_guide,阅读最新的格式规范与经验库。 - 生成骨架:执行
plugin_forge_scaffold生成骨架文件。 - 实现逻辑:在生成的骨架中编写具体的业务逻辑代码。
- 安装插件:执行
plugin_forge_install完成校验与安装,随后重启 DSH。 - 记录坑点:每解决一个开发中的问题,执行
plugin_forge_experience(action=add)将经验写入库中。
踩坑经验库¶
踩坑经验库是全局共享的,存储位置为:
~/.dsh/plugin-forge/EXPERIENCE.md
首次使用时,该库会自动写入种子经验。该文件在所有工作区间共享,适合作为团队或个人的通用避坑指南。
安装与启用¶
目前未在已抓取资料中找到官方安装命令。该插件以 module 类型存在,通过 DSH bundle 的形式加载。
注意事项¶
- 插件类型为 module。
- 安装插件后必须重启 DSH 才能生效。
- 插件以当前 DSH 进程的权限运行,安装前应检查源码与许可证(MIT)。
总结¶
这个工具通过规范化的脚手架和全局经验库,降低了 DSH 插件开发的门槛,并确保踩坑经验能够被持续沉淀和复用。