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