押金保证金收取与退还核对（免费版）

押金保证金台账与退还明细表逐项核对。应退金额复算（应退金额 = 收取金额 − 扣除金额）、扣除金额带依据与上限（扣除依据为空或没写明事由、扣除金额超过收取金额）、退还时间超过约定期限提示（应退截止日 = 收取日期 + 约定退还期限，含已过截止日仍未退清）、同一合同同一押金类型重复退还、台账余额勾稽（台账余额 = 收取金额 − 退还金额 − 已结转金额）、关键字段缺失或为负。每条结论都引用原文行号，材料不足时不给结论。触发词包括 押金保证金收取与退还核对、押金保证金台账与退还明细表对不上、押金该退多少对不上、退押金超期、台账余额对不上。

完全本地运行：引擎已经打包在本技能里（engine/ 目录）。 核对过程不需要联网、不需要 API Key、没有调用次数上限、材料不出本机。

什么时候用

谁在什么时候用：出纳、财务、物业与招商运营在收押金、退租退押、月底核对押金台账时 —— 「押金保证金台账与退还明细表」是退押付款、押金科目余额与合同履约的原始依据， 钱付出去之后再改就要走红冲与追款流程。

这张表会逐项核对什么（免费版执行 6 项，逐条都带原文行号）：

1. 应退金额复算 —— 应退金额 = 收取金额 − 扣除金额，差 0.01 也会报。
2. 扣除金额带依据与上限 —— 扣除金额大于 0 时，扣除依据不能为空、不能只写一个占位符， 也不能只写一句看不出事由的话（要落到违约金 / 损坏赔偿 / 欠费 / 滞纳 这类事由上）； 扣除金额还不得超过收取金额。
3. 退还时间超过约定期限 —— 应退截止日 = 收取日期 + 约定退还期限（自然日）； 退还日期晚于截止日会报超期天数，已过截止日而台账余额仍有余额且没有退还日期的也会报。
4. 同一合同同一押金类型重复退还 —— 同一份合同同一类押金出现两次以上实际退还。
5. 台账余额勾稽 —— 台账余额 = 收取金额 − 退还金额 − 已结转金额。
6. 关键字段缺失 / 金额为负 —— 必需单元格为空或写着「待填 / — / 无 / N/A」，以及金额列为负。

每条结论都带原文行号与算式，可被第三方用同一份输入复算； 材料不足时不给结论，会明确列出还缺什么，也不会用默认值编出结论。

这个免费版查什么

上面 6 项就是本版本执行的全部检查项。跑 --sample 会在 scope.checks 里打印本次实际执行了哪些， scope.checks_not_run 会如实列出本版本没有执行的检查项（只列出，不会伪造结论）。

怎么用

bash

node scripts/run.mjs --sample                      # 先看样例（样例本身就是一张自洽的押金台账）
node scripts/run.mjs --input 你的材料.json          # 跑自己的材料
node scripts/run.mjs --input 你的材料.json --json   # 机器可读输出

入参两种写法都行：

• {"text": "（把表的**表头**和若干行一起复制进来，Tab 分隔最稳）"}
• 直接把「押金保证金台账与退还明细表」（含表头）从 Excel 复制成文本贴进 .json 里； 文件不是合法 JSON 时整体按纯文本材料处理。

必需列（缺一列就不给结论）：合同编号、承租方、项目、押金类型、收取日期、约定退还期限、扣除依据、 扣除金额、应退金额、退还日期、退还金额、已结转金额、台账余额。 可选列：备注、台账截止日。

两个口径要先写清楚，否则本工具只能按下方口径复算：

• 已结转金额 = 本行押金在本期已处置的金额（含按依据扣除核销的部分 + 转入下期 / 其他合同的部分）。
• 台账截止日（可选）填了就用它当口径日；没填就用表内最晚日期—— 表里只有收取日期时，本工具不会凭空断定"已经超期"。

出参

• status：success 才有结论；insufficient_input 表示材料不足，此时没有 result、没有 findings， 只有 missing（缺什么）与 advice（怎么补）。
• result.findings[]：每条含 level（P0/P1/P2）、category、line（原文行号）、message（含算式与差额）、 advice、basis（引用原文整行）。
• result.summary：rows / contracts / projects / periods / total / p0 / p1 / p2 / verdict （NO_ISSUE_FOUND | NEEDS_REVIEW | ERROR_FOUND）。
• result.scope：本次执行的 checks、未执行的 checks_not_run、base_date、cutoff_source、 column_totals（各金额列合计）、outstanding_total、tolerance、executed_locally: true、network_used: false。
• result.checks_out_of_scope：本工具根本不做的判断清单（边界诚实）。
• CLI 退出码：0 已执行检查 / 1 没给入参 / 3 材料不足 / 4 入参读不到或无法解析 / 9 未预期错误。

常见错法（本产品专属）

1. 扣了钱、却没从应退金额里减：应退金额写成收取金额原数，差额正好等于扣除金额 —— 这就是"扣款只在依据栏里说了一句、账上没落"。复算会直接把差额算给你看。
2. 扣除依据只写"扣款"两个字：依据栏不能空，也不能只写「扣了一笔」这种看不出事由的话； 违约金要有合同条款、损坏赔偿要有维修单编号、欠费要有催缴单或对账确认，否则这条扣款对方不认。
3. 扣除金额大于押金本金：押金只有那么多，超出的部分不是押金能覆盖的 —— 要么另开应收（欠费 / 违约金单独挂账），要么这一格抄成了两行的合计。
4. 把"起算日"当"收取日"：本表口径是「应退截止日 = 收取日期 + 约定退还期限」。 如果合同写的是"退租之日起多少日内退还"，请把起算日折算进这一列或在备注里写明，不要两种口径混用。
5. 同一份押金拆成两行、都填了退还金额：被判重复退还 —— 分次退还请在备注里写清每次的依据， 或把退款明细附在材料里，不要用两行都挂同一份合同同一押金类型。
6. 扣掉的钱没记进"已结转金额"：应退金额减对了，台账余额却还挂着那笔扣款 —— 余额勾稽的差额正好等于扣除金额时，就是这个问题。
7. 余额用上期数没重算：本期退还 / 结转变了，台账余额还是上个月的数； 余额是"这笔押金还挂在账上多少"，必须跟着本期变动走。
8. 该写 0.00 的格子留空：金额列留空表示"不知道"，写 0.00 才表示"确实没有"； 本工具对留空的格子不给结论（只有扣除依据 / 退还日期 / 备注确实没有时可以留空）。
9. 退还金额还没填就写退还日期：会按超期逐行报出来；没退就把退还日期留空， 本工具会用台账截止日判断"已过截止日仍未退清"。

这个免费版不包含

本免费版是完整可用的核心产出，本版本不包含下面这些项（它们会如实列在输出的 checks_not_run 里，绝不会伪造）：

• 差异归因（扣除依据口径 / 期限口径 / 重复退口径 / 结转口径）；
• 跨项目 / 跨期押金汇总台账（按项目与按收取月份归集收取、扣除、应退、退还、结转与未退余额）；
• 按超期未退金额排序的处理清单（带原文行号、超期天数与建议动作）。

同名工具的完整档是另一个独立商品（条款以它自己的商品页为准）；两档的差别就是上面这些，没有别的。

需要完整档时（可选）

本免费版是完整可用的核心产出，本版本不包含下面这些项：

• 差异归因（扣除依据口径 / 期限口径 / 重复退口径 / 结转口径）
• 跨项目 / 跨期押金汇总台账（按项目与按收取月份归集收取 / 扣除 / 应退 / 退还 / 结转 / 未退余额）
• 按超期未退金额排序的处理清单（带原文行号、超期天数与建议动作）

同名工具的完整档是另一个独立商品（条款与条件以它自己的商品页为准）；两档的差别就是上面这些，没有别的。

边界（请务必知道）

本工具不做引擎 checks_out_of_scope 里列的那些判断，其中最容易误解的四条：

• 不判断押金该收多少、比例是否合规（以租赁合同、招标文件与内部制度为准）；
• 不判断扣除依据的文本是否合法有效、违约金到底该不该收（本工具只看依据栏是否为空、有没有写明事由）；
• 不判断押金是否真的收到 / 退还（要拿银行流水、收据与退款凭证核，本工具不去查外部系统）；
• 不计算押金利息 / 资金占用费，也不处理增值税、代扣代缴与发票。

材料不足时不给结论，也不会输出「未发现问题」。

与相邻能力的区别：rent-collection-check 核的是租金收取（应收租金与实收租金）， bid-deposit-refund-check 核的是投标保证金在招投标场景下的收取与退还； 本能力核的是押金 / 保证金台账的「收取 − 扣除 = 应退」「收取 − 退还 − 已结转 = 台账余额」 与「收取日期 + 约定退还期限 = 应退截止日」三组勾稽。