插件工坊 (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 插件開發的門檻,並確保踩坑經驗能夠被持續沉澱和複用。

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

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

小夜