house-calc-toolkit · 房产公共计算工具包

零依赖 Python 工具（任何电脑有 Python3 即可跑），服务所有身份端：购房者、经纪人、案场销售、渠道、自媒体博主的算数场景。

快速上手

python3 skills/calc-toolkit/mortgage.py --price 1500000 --downpay 30 --years 30 --city 昆明
python3 skills/calc-toolkit/tax.py --price 1500000 --area 89 --city 昆明 --first 1 --held 6 --unique 1   # 二手全成本
python3 skills/calc-toolkit/newhome.py --price 1500000 --area 100 --city 昆明 --first 1                  # 一手全成本
python3 skills/calc-toolkit/floor.py --price 25000 --area 100 --floor 15 --top 30 --floor-adj 300 --d 98 --d 99 --pay one_time

工具清单（19/20，1件砍掉）

原计划20件，其中"分销结算单核对器"因各地结算口径不统一砍掉（08-31定盘）——19件已全部完成。

规则四层引擎（每个数字可追溯）

层1 全国默认档（rules/cities.yaml → default）
      ↓ 被覆盖
层2 城市档（35城）→ 区县档（districts）
      ↓ 被覆盖
层3 我的模板（--save-template / --template）
      ↓ 被覆盖
层4 --set 即时覆盖（任何参数当场改，来源表如实标注）

• 未内置城市：自动套全国默认档并明确提示（不装懂）
• 每项输出末尾附「参数来源表」：这个数字来自哪个城市档、哪个时点
• 政策变了只改 rules/cities.yaml，工具代码不动

详细说明见包内 README.md。

规范六段（v1 补齐）

必问信息

知识库与数据来源

• 35 城规则库四层引擎：国家层 → 省级 → 城市 → 项目参数，输出必须带「口径出处」段（来源 + 版本号，如 版本[2026.08.31-r3]）
• 默认档与城市档不同时必须写明"用的是哪一档"，不许静默套默认值
• 利率、税费、公积金额度等外部参数：按当地当期公告现查，工具只负责算，不负责替你更新政策

目标读者

置业顾问与经纪人（案场算价、佣金结算）、购房者（月供与全成本）、策划与财务（费效与销控测算）。同一份结果给客户看时要去掉内部口径字段。

写作风格

• 只给数字与口径，不给"大概""差不多"
• 单位统一：金额用「元」或「万元」并在同一次回答内保持一致；面积用「㎡」
• 计算结论必须能复现：给出可复制的命令行，而不是只给结果

输出格式

1. 工具原始输出（含口径出处段，不许删）
2. 三行结论：结论数字 / 依据（用了哪档参数）/ 边界（哪些情况不适用）
3. 需要用户确认的输入缺项（如有）

数据时间戳

每次输出末行标注：参数来源：来源[XX档] 版本[X]；外部政策口径按当地 YYYY-MM 公告。跨版本对比必须同版本口径，否则结论无效。