金蝶雲星空二次開發
💻 開發程式設計
免費
📖 技能介紹
金蝶二次開發技能
產品線識別
收到需求後先識別目標產品：
| 關鍵詞 | 產品 | 技術棧 | 參考 |
|---|---|---|---|
| 星空、K3 Cloud、K/3 Cloud、BOS IDE、C#外掛、K3Cloud | 金蝶雲星空 | C# / .NET / SQL Server / IIS | references/xingkong-plugin-dev.md |
| 蒼穹、Cosmic、AI蒼穹、低程式碼、KingScript、Java外掛 | 金蝶雲蒼穹 | Java / Spring Cloud / PostgreSQL | references/cangqiong-dev.md |
無法判斷時，先問使用者："是金蝶雲星空（K3 Cloud）還是金蝶雲蒼穹（Cosmic）？"
需求決策樹
拿到一個二開需求，按以下決策樹快速定位：
1. 識別需求型別
| 使用者說 | 處理方向 | 推薦文件 |
|---|---|---|
| "介面按鈕點選/欄位聯動/表單載入後控制" | 星空表單外掛 | references/xingkong-plugin-dev.md §表單外掛 |
| "列表過濾/行著色/批次操作" | 星空列表外掛 | references/xingkong-plugin-dev.md §列表外掛 |
| "儲存前校驗/提交前校驗/稽核後處理" | 星空操作外掛 | references/xingkong-plugin-dev.md §操作外掛 |
| "下推時改欄位/轉單邏輯" | 星空單據轉換外掛 | references/xingkong-plugin-dev.md §單據轉換外掛 |
| "自定義報表/賬表" | 星空報表外掛 | references/xingkong-plugin-dev.md §報表外掛 |
| "自定義介面/定時任務/後臺服務" | 星空服務外掛 | references/xingkong-plugin-dev.md §服務外掛 |
| "審批人動態設定/審批流擴充套件/跳過審批" | 星空審批流外掛 | references/workflow-plugin-dev.md |
| "多組織/資料許可權/欄位許可權" | 星空多組織與許可權 | references/multi-org-security.md |
| "慢/卡/大數據量/效能最佳化" | 星空效能最佳化 | references/performance-debugging.md |
| "查表/SQL/上下游關聯" | 星空資料庫參考 | references/database-reference.md |
| "部署/打包/除錯/運維" | 星空部署運維 | references/deployment-ops.md |
| "第三方系統對接/外部介面" | 星空WebAPI | references/xingkong-webapi.md |
| "BOS建模/欄位擴充套件/選單釋出" | BOS IDE 操作 | references/xingkong-bos-ide.md |
| "蒼穹表單/操作/列表/報表/Java" | 蒼穹開發 | references/cangqiong-dev.md |
2. 星空開發完整流程
- 明確產品線：星空 / 蒼穹
- 確定需求型別：外掛 / BOS建模 / 介面 / 報表 / 資料遷移
- 選擇外掛型別：見下方外掛選擇矩陣
- 編碼實現：使用
references/plugin-templates.md對應模板 - 處理邊界：空值判斷、異常處理、事務安全、許可權控制
- 本地測試：BOS IDE 註冊外掛，IIS 回收，瀏覽器驗證
本技能來自小蔥技能站7w4.net。
- 部署上線：BOS IDE 打包 → 測試環境驗證 → 生產環境部署
外掛選擇矩陣（星空）
| 需求場景 | 外掛型別 | 基類 | 參考 |
|---|---|---|---|
| 單據介面互動（按鈕點選、欄位變更、資料聯動） | 表單外掛 | AbstractFormPlugin |
references/xingkong-plugin-dev.md §表單外掛 |
| 列表介面過濾、工具欄操作、行著色 | 列表外掛 | AbstractListPlugin |
references/xingkong-plugin-dev.md §列表外掛 |
| 儲存/提交/稽核/反稽核時校驗或干預 | 操作外掛 | AbstractOperationServicePlugIn |
references/xingkong-plugin-dev.md §操作外掛 |
| 報表資料查詢與展示 | 報表外掛 | AbstractSysReportServicePlugIn |
references/xingkong-plugin-dev.md §報表外掛 |
| 下推轉單時干預轉換邏輯 | 單據轉換外掛 | AbstractConvertPlugIn |
references/xingkong-plugin-dev.md §單據轉換外掛 |
| 自定義WebAPI / 定時任務 / 後臺服務 | 服務外掛 | AbstractServiceHandler / IScheduleService |
references/xingkong-plugin-dev.md §服務外掛 |
| 審批流節點控制、動態審批人 | 審批流外掛 | AbstractWorkflowPlugin |
references/workflow-plugin-dev.md |
核心參考檔案
| 檔案 | 內容 | 何時讀取 |
|---|---|---|
references/xingkong-plugin-dev.md |
星空6大類外掛完整開發指南 | 星空外掛開發需求 |
references/plugin-templates.md |
各類外掛完整程式碼模板 + 複雜案例 | 編碼階段直接套用 |
references/workflow-plugin-dev.md |
審批流外掛開發與節點控制 | 審批流擴充套件需求 |
references/multi-org-security.md |
多組織、許可權、SQL安全 | 多組織/許可權相關需求 |
references/performance-debugging.md |
效能最佳化、日誌分析、死鎖排查 | 效能問題/除錯排錯 |
references/xingkong-bos-ide.md |
BOS IDE 操作手冊 | 需要BOS建模/配置時 |
references/xingkong-webapi.md |
WebAPI 介面開發 | 第三方對接需求 |
references/database-reference.md |
資料庫核心表/SQL/多語言/LK表 | 寫SQL/查資料時 |
references/cangqiong-dev.md |
蒼穹二次開發 | 蒼穹相關需求 |
references/common-patterns.md |
常見開發模式 + 社群FAQ | 遇到典型問題/報錯時 |
references/deployment-ops.md |
打包部署/除錯/運維 | 部署階段 |
編碼規範
- 命名：外掛類名 =
{業務物件}{功能}PlugIn，如SaleOrderValidatePlugIn - 防禦式程式設計：所有欄位取值都做空判斷，避免
NullReferenceException - 多語言：涉及中文名稱的欄位必須關聯
_L表，FLOCALEID=2052 - 上下游關聯：使用
_LK關聯表，FSID→ 上游明細FENTRYID - SQL安全：所有 SQL 查詢使用引數化，禁止字串拼接使用者輸入
- 效能：操作外掛在
OnPreparePropertys中只宣告必要欄位，避免全量載入 - 單據操作：系統自帶單據先"擴充套件"再修改，修改前必須"簽出"，改完"儲存→簽入→釋出"
- 異常處理：表單外掛使用 try-catch；操作外掛異常會阻止單據操作，需謹慎使用
- 日誌：關鍵節點寫日誌，便於生產排查
版本相容性
星空不同版本的 BOS API 可能存在差異。開發時需注意：
- 從對應版本
K3Cloud\WebSite\bin目錄複製引用 DLL - 升級後重新編譯並註冊所有自定義外掛
- 公有云與私有云的部分 API 行為可能不同
官方資源索引
🤖 AI 評測
這個技能包質量較好，涵蓋了金蝶兩大主要產品的開發指導。結構清晰，容易找到需要的內容，程式碼示例豐富實用，風險提示也很到位。主要優點是內容全面、分類合理、使用便捷；不足之處是部分高階功能的介紹相對簡略，部分文件篇幅較長可能影響查閱效率。適合有一定開發基礎的使用者使用。
📊 多維度評分
適應性4.3
規範性4.3
有效性4.5
可靠性4.4
可信度5
📁 包含檔案 (14 個)
📄 SKILL.md
7.7 KB
📄 _meta.json
130 B
📄 references/cangqiong-dev.md
18.3 KB
📄 references/common-patterns.md
8.1 KB
📄 references/database-reference.md
8.9 KB
📄 references/deployment-ops.md
19.8 KB
📄 references/multi-org-security.md
7.7 KB
📄 references/performance-debugging.md
7.5 KB
📄 references/plugin-templates.md
30.1 KB
📄 references/workflow-plugin-dev.md
7.1 KB
📄 references/xingkong-bos-ide.md
6.3 KB
📄 references/xingkong-plugin-dev.md
19.7 KB
📄 references/xingkong-webapi.md
7.9 KB
📄 skill-card.md
3.5 KB
