前言¶
给「招商合伙（总部—门店—合伙人）」模式做月度结算系统，踩的坑高度一致：某个门店算不出数，查半天是字段缺失；加了一个开关，历史数据全变 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。
