珍珑财税管理账（管理账 Pay SKILL v1.0.0）
变更记录
| 版本 | 变更 |
|---|---|
| v1.0.0 | SkillHub 正式上架版（内容与 v0.2.3 一致，版本号对齐平台显示） |
| v0.2.3 | 定价统一为 29 元/次（服务端账单、站点注册价三方一致）；概述对齐官方范式 |
| v0.2.2 | 标准出账切换至珍珑云端记账 API 正式部署地址 |
| v0.2.1 | 新增数据出域显式确认门槛（§8.3 步骤 0）；请求快照改为服务端内存级留存（≤6 小时、履约即清、不落盘） |
| v0.2.0 | 接入支付宝 AI 按量付费（A2M 402 流程），发布付费版 |
| v0.1.x | 免费版核心：记账流水线、会小企01/02/03 三表勾稽、管理报表与指标 |
概述
把"每月贴发票、对流水、算税"的脏活，变成"上传 3~4 类文件 → 先出税局口径标准财务报表（会小企01/02/03），再出老板看得懂的管理账 + 关键指标"。出辅助草稿与解读，不替代会计师/税务师意见。
触发场景
用户说"这个月赚没赚 / 亏不亏钱""帮我对一下票和钱对得上吗""记一下这个月的账""出个资产负债表 / 利润表 / 现金流量表""税负多少""无票收入 / 无票支出怎么记""工资社保公积金怎么做账""个体户记账""小微企业出报表"。
输入内容范围（明确工作边界）
✅ 可直接处理
- 电子税务局导出的开票/收票清单 Excel（行级表为主，按列角色识别，详见 §1）
- 银行 / 支付宝 / 微信流水 CSV/Excel
- 工资社保公积金表（随包模板 assets/templates/工资社保公积金表模板.xlsx）
- 期初科目余额表（按需：要出完整"年初余额"列才需要）
- 定额票 / 过路费等无税号零星票据（用户提供即入账，§7.4）
❌ 不属于本 Skill 工作范围（边界）
- 税务申报表草稿、代客申报、代填税局报送系统 —— 标准财务报表属"报表"（准则化账务呈现），非申报表
- 绑定企业 / 税局账号、自动报送
- 替代会计师 / 税务师专业意见或审计
- 编造缺失数据 —— 缺数据 / 规则冲突 / 低置信一律进"需人工确认"清单
> 一句话：票 + 钱 + 人三类文件给齐即可出账；申报、审计、专业意见不在范围内。
> 计费与数据出域（收费规则详见 §8）：标准出账经珍珑云端记账 API 按次计费（支付宝 AI 按量付费 A2M，29 元/次，HTTP 402 流程）。云端出账会把您的财务文件（发票清单/流水/工资表等）发送至珍珑云端 API 处理：用途仅为生成本次账表，请求快照仅在服务端内存短期保留（≤6 小时，用于付款后取回账表），履约完成立即删除、不落盘。首次触发云端记账前必须取得用户显式确认（§8.3 步骤 0）；用户拒绝、未装官方支付能力或完全离线时，改走本地内置流水线同口径演示（§8.6，数据不出本机）。禁止仅因检测到支付能力就自动启用云端上传。
0. 每次必做（最高优先级）
- 产出首部/尾部固定附 免责声明（见
references/compliance_rules.md§一；≤1 行，必出现不刷屏）。 - 凡缺数据 / 规则冲突 / 低置信 → 进"需人工确认"清单，绝不编造、不静默归"其他"。
- 关键数值给计算口径（如 税额 = 含税销售额 ÷ (1+征收率) × 征收率），不给黑箱结果。
0.5 首次使用引导（QUICKSTART · 新会话必走，画像未收齐不做账）
用户开口记账但信息不全时，按顺序引导，一次只问一小步：
1. 一句话预告：给我 3~4 类文件（税局发票清单 / 流水 / 工资社保公积金表 / 期初科目余额表[按需]），还你先出标准财务报表、再出老板看得懂的管理账 + 关键指标；
2. 收企业画像（每题附一句"为什么问"）：
- 纳税人类型（小规模 / 一般纳税人）→ 决定进项票能不能抵、成本记含税还是不含税；
- 行业（首版按电商做深，其他行业提示模板覆盖范围）→ 决定科目模板与进项去向；
- 记账期间 → 决定取数窗口（利润表/现金流量表"本月"+"本年累计"两列）；
3. 列文件清单 + 获取路径（用户更常卡在"从哪导"而非"怎么填"，路径给到点击级）：
- 发票清单：电子税务局 → 税务数字账户 → 全量发票查询 → 开具/取得发票 → 导出 Excel（多子表：票级"发票基础信息" + 行级"信息汇总表" + 特定业务辅助表，解析按列角色识别不按表名写死）；
- 流水：银行/支付宝/微信 账单导出；
- 工资社保公积金表：按 assets/templates/工资社保公积金表模板.xlsx 字段填（随包提供）；
- 期初科目余额表（按需）：若要出完整"年初余额"列则需提供（模板随包提供）；缺 → 整列标"需人工补录"，不编造；
4. 输入体检回执再开跑：收到文件先报"解析到销项 N 张 / 进项 M 张 / 流水 K 行，✓列已识别 / ⚠缺 XX 列（给映射建议）"；缺关键列 → 停下来引导补，绝不静默跳过。
1. 输入识别
- 发票清单（主）：电子税务局导出的开具(销项)/取得(进项) Excel，行级表为主输入（票级/行级/特定业务表按列角色识别，勿按表名写死），解析规则见
references/bookkeeping_rules.md§7.1；定额票/过路费等无税号零星票据 → 用户提供即入账（§7.4）； - 流水（辅）：银行/支付宝/微信 CSV/Excel，字段映射见
references/bookkeeping_rules.md§2.1； - 工资社保公积金表：字段与口径见
references/bookkeeping_rules.md§9（工资/单位社保/单位公积金 三线分开）； - 期初科目余额表（可选）：供标准资产负债表"年初余额"列取数；缺 → 该列待补；
- 企业画像：行业、纳税人类型、征收方式、期间 → 纳税人类型 6 分叉点见
references/bookkeeping_rules.md§7.0（不默认、不猜测）。
2. 记账流水线（v1.0.0 记账编排：云端付费标准出账 or 本地同口径）
> 编排入口见 §8：标准出账默认走珍珑云端记账 API（付费）；本地流水线（本节 1~5 步，封装于 deploy/zhenlong-api 与本地 scripts）作为离线/演示降级，口径与云端一致。
1. 发票记账：销项→收入、进项→成本/费用（票面价税分离；抵扣资格按 §7.0 纳税人类型；不得抵扣信号见 §7.2）；
2. 流水记账 + 无票收支识别（§8）：无票收入/支出如实入账并逐笔标注"申报义务/税前扣除风险"，依法提示不诱导；
3. 工资社保公积金核算（§9）：计提/代扣/实发/缴纳 4 步；勾稽 应发−(个人社保+个人公积金+个税)=实发=银行实发；
4. 凭证 + 科目余额表：借=贷平衡 + 试算平衡（脚本校验），不平衡 → 拒绝输出并定位；
5. 票流对账：四类差异清单（已开票未收款 / 已收款未开票 / 已收票未付款 / 无票支出）。
- 分类引擎 = assets/mapping_rules.json（由方法论映射表生成，勿手编）+ 关键词兜底；未命中 → 人工确认清单。
3. 标准财务报表（会小企01/02/03 · 先于管理报表）
- 链路：凭证 → 科目余额表 → 标准三表 → 老板版管理报表；
- 产出：会小企01 资产负债表（53 行，期末/年初两列）/ 会小企02 利润表（32 行，本月/本年累计）/ 会小企03 现金流量表（直接法 22 行，本月/本年累计）；行次、科目→行次映射、取数口径见
references/std_statements.md； - 三条勾稽（脚本校验，任一不过拒绝输出）：① 资产总计=负债合计+所有者权益合计 ② 净利润(累计)≈未分配利润期末−年初（无分配/调整时）③ 现金净增加+期初现金=期末现金=资产负债表货币资金；
- 年初余额缺失 → 整列显式标注"需人工补录"，不编造；报表尾部注明"报表为辅助草稿，报送前请在税局系统逐表核对"。
4. 管理报表与指标（老板可读 · 在标准三表后出）
- 利润表(老板版) / 现金流简表 / 应收应付账龄 / 人工成本表 / 无票收支表：字段大白话 + 会计口径脚注（模板见
references/management_metrics.md）； - 指标带公式 + LLM"对老板说的人话"解读 + 老板一页纸；
- 尾部附"三个如果"排错指引：数不对 → 多半是 漏了无票支出 / 期间没对齐 / 票没导全 / 年初余额没给，告诉用户补哪个文件重跑。
5. 增值税负担汇总（管理用 · 非申报表）
销项/进项合计、应交估算、分税率汇总、留抵、免税额度提示；按纳税人类型口径（§7.0）。注明"非申报表，正式申报以电子税务局为准"。不产申报表草稿。
6. 财税风险提示（v0.1 触发式）
无票收入申报义务 / 无票支出税前扣除受限 / 公私混同 / 小规模连续 12 个月销售超 500 万转一般纳税人临界 → 主动提示，不判定（见 references/compliance_rules.md §四）。
7. 自检关卡（输出前必跑）
见 references/compliance_rules.md §五 + references/bookkeeping_rules.md §六（准确性策略）+ references/std_statements.md §一.3（三表勾稽）。任一不通过 → 退回补全。
8. 按量付费编排（Pay Skill · 支付宝 AI 按量付费 A2M）
> 遵循支付宝官方 Pay Skill 最佳实践。业务记账逻辑（§2~§7 本地流水线）与收费逻辑（402+支付+履约）解耦：标准出账默认经珍珑云端记账 API，本地流水线保留为离线降级与口径对照。
> 详细命令手册、官方 CLI 安装核验、会话状态文件、常见报错对照与联调检查单 → 见 references/a2m-pay-guide.md（随包，供执行 Agent 参考）。
8.0 资源与价格（三方一致，勿改）
| 项 | 值 |
|---|---|
| 付费资源接口 | POST http://82.157.185.191/zhenlong/api/bookkeeping（珍珑记账 API；multipart：profile + sell/buy/bank/wages/employer/opening/decisions） |
| 单价 | ¥29.00/次（与 402 账单 amount、支付宝 AI 付站点注册服务单价一致；改价须三处同步） |
| 触发方式 | 首次调用无 Payment-Proof 头 → 服务端 HTTP 402 + Payment-Needed（Base64URL 账单）；用户付款后携带 Payment-Proof 重试 → 验付+履约 → HTTP 200 + Payment-Validation 返回记账结果 |
| 服务端幂等 | 402 时服务端把本次上传文件+画像绑定订单做内存快照（不落盘，≤6 小时，履约即清）；付款后重试无需重传文件（凭订单履约） |
8.1 付费依赖与前置检查（pay 前必查）
本 Skill 不自己实现支付：支付、查询、履约全部复用支付宝官方支付能力（官方 alipay-bot CLI，随支付宝官方 AI 付 Skill / @alipay/agent-payment@1.0.0 安装，版本锁定、带 SHA-512 完整性校验）。编排脚本为 scripts/zhenlong-paid.mjs。
前置检查（仅以工具/命令可用性为证据，无法确认按"未装"处理）：
- 具备官方支付能力（可用工具含支付宝 AI 付 / alipay-bot CLI）→ 走云端付费编排（§8.2~8.5）。
- 不具备 → 终止付费流程，不发起任何"假装支付"；向用户说明两种出路：① 安装支付宝官方 AI 付支付 Skill 后重试；② 接受本地演示模式（§8.6，同口径免费，结果标注"本地演示，非云端正式出账"）。
8.2 流程总览（确认 → probe → pay → complete+ack → 输出）
用户记账请求（画像+文件收齐，见 §0.5）
→ 8.3 步骤 0 数据出域显式确认（用户 yes 才继续；no/未答复 → §8.6 本地模式）
→ 8.3 probe 调用珍珑 API（无 Payment-Proof）→ HTTP 402 + Payment-Needed 账单落地
→ 8.4 pay 官方 CLI 402-buyer-pay 拉起收银台（用户扫码付款，Agent 只编排不过手）
→ 8.5 complete+ack 官方 CLI 402-query-payment-status 取回记账资源 → 402-buyer-fulfillment-ack 履约
→ 输出账表（标准三表 + 老板版管理报告 + 关键指标，固定格式，不暴露支付链接/交易号）
8.3 probe：触发 402 账单
步骤 0 · 数据出域显式确认（强制）
首次对每位用户触发云端记账前，Agent 必须逐项出示并取得用户明确同意（问答式 yes/no，不得以"检测到支付能力"默认视为同意）：
> 云端标准出账会把您上传的财务文件发送到珍珑云端记账 API 处理：
> ① 接收方：珍珑云端记账 API（http://82.157.185.191/zhenlong）；
> ② 数据类别：发票清单 / 银行·支付宝·微信流水 / 工资社保公积金表 / 期初余额等财务资料；
> ③ 用途：仅用于本次生成财务报表与管理账；
> ④ 留存：请求快照仅在服务端内存短期保留（最长 6 小时，用于付款后取回账表），履约完成后立即删除；服务端只保留记账结果，不落盘财务文件；
> ⑤ 拒绝后果：不确认则不做云端出账，改走本地流水线（§2~§7，数据不出本机）。
- 用户确认 yes → 继续下方 probe（带
--confirm-upload）； - 用户拒绝 / 未答复 / 要求离线 → 直接走 §8.6 本地演示模式，不得发起任何上传；
- 本会话内同一用户已确认过可免重复询问；跨会话须重新确认。
probe 命令（输入齐备后执行；profile 为 §0.5 收集的画像 JSON；文件路径为本次用户上传文件的本地路径，可省则省；全省=服务端样例账套）：
node "<skill_dir>/scripts/zhenlong-paid.mjs" probe --confirm-upload \
--profile '{"纳税人类型":"小规模","行业":"电商","期间":"2026-08",...}' \
[--sell <销项.xlsx>] [--buy <进项.xlsx>] [--bank <流水.csv>] \
[--wages <wages.json>] [--employer <employer.json>] [--opening <opening.json>] \
[--decisions '<[{"对象":"…","科目":"…"}]>'] \
--state-dir "<state>" --session-id "<session>"
- 不带
--confirm-upload：脚本只打印告知文本并以退出码 3 结束（不会发起任何网络请求）——这是合规兜底，Agent 应回到步骤 0。 - 输出
kind=bill+ 账单落地路径 → 进入 pay。 - 若输出
kind=resource（服务端直出/免费模式）→ 直接进入 §8.5 输出账表（免支付路径，仅在服务端未开收费层时出现）。 - 非 402/200 → 报错终止，排查服务地址/网络。
8.4 pay：官方收银台付款
node "<skill_dir>/scripts/zhenlong-paid.mjs" pay --state-dir "<state>" --session-id "<session>"
- 脚本将 probe 落地的
payment-needed.txt交给官方 CLI 执行402-buyer-pay，拉起收银台； - 官方 CLI 返回的收银链接/二维码（MEDIA 行）原样透传给用户（不包裹、不截断、不改写），引导用户用支付宝 App 扫码付款；
- 等待用户明确"已付款"后再继续 complete，不自动连跑；同一 402 不重复支付。
8.5 complete + ack：查询支付状态、取资源、履约
node "<skill_dir>/scripts/zhenlong-paid.mjs" complete \
--state-dir "<state>" --session-id "<session>" --trade-no "<交易号>"
- 内部调用官方 CLI
402-query-payment-status -t <tradeNo> -r <资源地址> -m GET：携带 Payment-Proof 重试珍珑 API，服务端凭订单内存快照履约返回记账结果（HTTP 200 + Payment-Validation）； - 随后发送履约回执
402-buyer-fulfillment-ack -t <tradeNo>（幂等，失败可重试）； - 按固定格式输出老板版账表（期间/凭证数/营业收入/利润/三表勾稽 + 老板版管理报告 Markdown）；
- 全程不向用户暴露支付链接、二维码原文、交易号等中间过程。
- 履约/验付失败（
VERIFY_CALL_FAILED、FULFILLMENT_CONFIRM_FAILED等）：如实透传，可用同一交易号重试 complete；不得伪造成功。
8.6 本地演示降级（未装官方支付能力 / 完全离线 / 用户拒绝数据出域）
仅在前置检查不满足、或步骤 0 用户拒绝云端上传、或用户明确接受时启用，走 §2~§7 本地流水线（与云端同口径）：
python "<skill_dir>/scripts/build_vouchers.py" ... # 本地模块链路，用法同 v0.1.x 本地说明
- 输出头部固定标注 "本地演示模式（未走支付宝 AI 按量付费），仅供试算，正式出账请在具备支付能力后重跑"；
- 不计费、不上传用户文件、不伪造云端交付；用户后续装了支付能力并确认出域后即可切回云端正式出账。
8.7 编排约束（红线）
- 数据出域红线：未经用户显式确认（§8.3 步骤 0）绝不把用户财务文件发往云端；检测到支付能力≠授权；probe 缺
--confirm-upload时脚本会拒绝上传（退出码 3），不得绕过。 - 支付/查询/履约只用官方 alipay-bot CLI；绝不手搓 402/Payment-Proof/验签；
alipay-bot缺失即停，不 mock、不伪造支付状态。 - 价格三处一致（资源接口展示/402 账单/站点注册价）；改价需同步服务端
AIPAY_AMOUNT与本文件pricing。 - 对用户只透传账表结果与官方 CLI 原样收银信息；不展示 Payment-Needed/Proof/Validation 原始值、签名、密钥、交易号。
- 每次新 402 重新走全流程，不复用旧账单/旧支付记录。
本 Skill 为按次付费版：标准出账走珍珑云端记账 API（支付宝 AI 按量付费 A2M 29 元/次，上传前须经用户显式确认，服务端内存级快照、履约即清、不落盘财务文件），业务记账核心为规则工程+表格处理，运行于云端服务与 WorkBuddy 内置 LLM；未装官方支付能力/离线/用户拒绝出域时可降级本地演示。付费编排脚本 scripts/zhenlong-paid.mjs 复用官方 alipay-bot，自身不接触密钥。
验收清单（可勾选，输出前逐项核对）
- [ ] 免责声明在产出首部/尾部出现（≤1 行）
- [ ] 三表勾稽平衡（资产 = 负债 + 所有者权益；利润表↔现金流量表勾稽）
- [ ] 存疑项全部进"需人工确认"清单，无编造数值、无静默归"其他"
- [ ] 关键数值附计算口径
- [ ] 云端出账前已获用户显式确认；走降级路径时已明示"本地演示模式"
- [ ] 未向用户展示 Payment-Needed/Proof/Validation 原始值、签名、交易号
