name: kingdee-dev version: 1.1.0 description: > 金蝶二次開發全棧技能。覆蓋金蝶雲星空（K3 Cloud）和金蝶雲蒼穹（Cosmic）的二次開發， 重點聚焦外掛開發。觸發場景：金蝶、K3、星空、蒼穹、BOS、BOS IDE、單據、外掛開發、 表單外掛、列表外掛、操作外掛、報表外掛、單據轉換外掛、服務外掛、審批流外掛、 WebAPI、DynamicObject、BusinessInfo、IIS、SQL Server、KingScript、動態表單、 金蝶二開、金蝶開發、金蝶介面、金蝶單據、金蝶報表、金蝶審批流、金蝶工作流、 金蝶資料庫、金蝶打包部署、金蝶補丁、金蝶自定義WebAPI、金蝶外掛註冊、金蝶欄位操作、 金蝶選單釋出、金蝶許可權配置、金蝶資料遷移、金蝶多組織、金蝶效能最佳化、金蝶蒼穹低程式碼、 金蝶蒼穹Java開發。當用戶提到任何與金蝶ERP系統開發相關的需求時使用此技能。

金蝶二次開發技能

產品線識別

收到需求後先識別目標產品：

無法判斷時，先問使用者："是金蝶雲星空（K3 Cloud）還是金蝶雲蒼穹（Cosmic）？"

需求決策樹

拿到一個二開需求，按以下決策樹快速定位：

1. 識別需求型別

2. 星空開發完整流程

1. 明確產品線：星空 / 蒼穹
2. 確定需求型別：外掛 / BOS建模 / 介面 / 報表 / 資料遷移
3. 選擇外掛型別：見下方外掛選擇矩陣
4. 編碼實現：使用 references/plugin-templates.md 對應模板
5. 處理邊界：空值判斷、異常處理、事務安全、許可權控制
6. 本地測試：BOS IDE 註冊外掛，IIS 回收，瀏覽器驗證
7. 部署上線：BOS IDE 打包 → 測試環境驗證 → 生產環境部署

外掛選擇矩陣（星空）

核心參考檔案

編碼規範

• 命名：外掛類名 = {業務物件}{功能}PlugIn，如 SaleOrderValidatePlugIn
• 防禦式程式設計：所有欄位取值都做空判斷，避免 NullReferenceException
• 多語言：涉及中文名稱的欄位必須關聯 _L 表，FLOCALEID=2052
• 上下游關聯：使用 _LK 關聯表，FSID → 上游明細 FENTRYID
• SQL安全：所有 SQL 查詢使用引數化，禁止字串拼接使用者輸入

  更多技能請訪問小蔥技能站7w4.net。

• 效能：操作外掛在 OnPreparePropertys 中只宣告必要欄位，避免全量載入
• 單據操作：系統自帶單據先"擴充套件"再修改，修改前必須"簽出"，改完"儲存→簽入→釋出"
• 異常處理：表單外掛使用 try-catch；操作外掛異常會阻止單據操作，需謹慎使用
• 日誌：關鍵節點寫日誌，便於生產排查

版本相容性

星空不同版本的 BOS API 可能存在差異。開發時需注意： - 從對應版本 K3Cloud\WebSite\bin 目錄複製引用 DLL - 升級後重新編譯並註冊所有自定義外掛 - 公有云與私有云的部分 API 行為可能不同

官方資源索引

這個技能包質量較好，涵蓋了金蝶兩大主要產品的開發指導。結構清晰，容易找到需要的內容，程式碼示例豐富實用，風險提示也很到位。主要優點是內容全面、分類合理、使用便捷；不足之處是部分高階功能的介紹相對簡略，部分文件篇幅較長可能影響查閱效率。適合有一定開發基礎的使用者使用。