前言¶
給「招商合夥（總部—門店—合夥人）」模式做月度結算系統，踩的坑高度一致：某個門店算不出數，查半天是字段缺失；加了一個開關，歷史數據全變 0；總額和明細對不上，沒人敢上線。這個 Skill 把這套系統的工程解法沉澱成可複製的模式——五條設計原則，外加一份開箱即用的迴歸校驗腳本。
下面介紹它是什麼、解決什麼問題、怎麼安裝啓用。
這是什麼¶
「門店月結 · 結算系統」是 SkillHub 上的社區 Skill，座標 @user_bb04ed0e/settlement-system-dev，發佈者 user_bb04ed0e，當前版本 1.0.8，分類 office-efficiency，來自 community。
它解決的不是「某一個結算公式怎麼寫」，而是結算系統的工程結構問題：公式怎麼歸一、字段怎麼回退、服務怎麼常駐、賬單怎麼自動發出去，以及改完之後怎麼確認沒改壞。按官方 SkillHub 頁面數據，評分 100000，下載 1302 次。
核心功能¶
這套方法論包含五條設計原則，覆蓋四個已明確的方向：
- 公式單點源：結算公式只寫一處，避免多處各算一遍導致總額與明細對不上。
- 字段三級回退：字段取值分級回退，門店算不出數時能定位到是哪一級缺失。
- 服務常駐：結算能力以常駐服務形式提供，而不是一次性腳本跑完就散。
- 賬單自動發送：結算完成後賬單自動發出。
- 第五條原則的具體表述，資料中未列出全文，以 Skill 包內 SKILL.md 爲準。
在原則之上，近期補充了一批針對實際項目的工程細節，逐項對應具體坑：
- 門店維護表的長表頭固定與滾動位置保留：長列表表頭不隨滾動消失，位置狀態保留。
- 抽點/無人值守封頂的默認推導與可覆蓋：封頂值能按規則默認算出，同時允許人工覆蓋。
- 代採費階梯與單店優先級鏈：代採費按階梯計，多優先級時按單店鏈式判定。
- 門店自動建檔與防重複：新門店自動建檔，重複門店名不重複建。
- 導入表頭同義兼容：去括號單位，別名子串兜底，不同來源的表頭都能導入。
- 部署留痕腳本與 SSH 僅密鑰收口：部署動作留痕，SSH 訪問只放行密鑰。
- 前端報錯診斷：報錯時能定位到前端環節的問題。
- 迴歸校驗腳本：改動後一鍵校驗，確認歷史數據沒被改壞。
安裝與啓用¶
官方給出兩種安裝方式，任選其一：
方式一，在 SkillHub 搜索「門店月結」，點「安裝」。
方式二，命令行安裝：
skillhub install settlement-system-dev
安裝後該 Skill 以通用 SKILL.md 格式被客戶端加載，無需額外配置項。頁面標籤顯示 requires_api_key=false，即不需要 API key。
資料中未說明 Cursor、Codex CLI、Claude Code 在安裝步驟上的差異，此處不做展開，以客戶端實際的 Skill 加載行爲爲準。
典型用法¶
官方簡介未給出完整示例腳本，可復現的流程是按方法論組織的：
- 先按五條原則搭結算骨架：公式歸一到單點源，字段取值走三級回退，結算能力以常駐服務提供。
- 門店數據進系統時，走自動建檔與防重複；導入外部表格時，靠表頭同義兼容（去括號單位 + 別名子串兜底）降低手工對錶成本。
- 配置抽點/無人值守封頂的默認推導，默認值需要調整時按單店優先級鏈覆蓋。
- 代採費按階梯計算，優先級鏈逐店判定。
- 結算完成後賬單自動發送。
- 每次改動後，運行包內迴歸校驗腳本，確認歷史門店數據未被改壞再上線。
適用場景與注意¶
適合給總部—門店—合夥人這類多層級加盟模式做月結結算的開發者：公式散落、字段缺失、開關誤傷歷史數據、上線沒底，都是這裏的高頻問題。
幾點注意：
- 它是方法論 + 校驗腳本，不是現成的結算業務系統，業務規則仍需按實際招商政策配置。
- 表頭兼容、封頂推導等補充項是爲近期實際項目沉澱的，接入時按門店表結構覈對默認行爲。
- SSH 僅密鑰收口屬於部署側要求，現有服務器權限模型需要一併調整。
- 頁面顯示安裝數爲 0，社區資料較少，遇到問題以 Skill 包內 SKILL.md 與發佈者說明爲準。
結尾¶
這個 Skill 的價值在於把結算系統的工程坑變成固定套路：公式單點源、字段回退、服務常駐、賬單自動發送，改完有迴歸腳本兜底。官方地址：https://api.skillhub.cn/user_bb04ed0e/settlement-system-dev，SkillHub 頁面：https://www.skillhub.cn/skills/user_bb04ed0e/settlement-system-dev。
