技能介绍

要解决什么问题

在 AI Agent 或脚本里对接纷析云账套时，凭证、报表、发票、资金、结账往往分散在多份接口文档里；辅助核算匹配失败、账期已结账、ID 被当成数字等问题也常在集成阶段才暴露。本技能把 REST + F-API-KEY 的主流程、子技能路由和读数脚本约定写在一起，让对话或自动化能按同一套规则走通。

技能如何工作

配置与上下文： 优先读工作目录下的 config.txt 或环境变量；仅有 AK 时必须先让用户选账套，不得默认第一个。通过 GET /ai/context 拿到科目列表、辅助核算等中文键上下文（MCP 侧为英文字段）。

能力路由： 按用户意图进入路径 A～I——例如自然语言记账走 A 创建凭证（末级科目匹配、辅助核算缺项则 POST /ai/auxiliary/create 后再预览）、报表走 B、发票/资金批量生成凭证走 D/E、账期与结转走 F。税务取票、开票、报税、风险自检等专项需先加载 skills/*.md 子技能。

读与写分工： 列表、余额表、三大表等读操作推荐 scripts/fxy.py 子命令（自动翻页、字段裁剪）；创建/更新凭证、结账、反结账等写操作按 api-reference.md 直接调 REST，且 写操作前必须用户确认。

边界与注意点

baseUrl 默认且推荐 https://f3.fenxi365.com/api；非 *.fenxi365.com 需用户明示并确认，脚本层会校验。
所有业务 ID 保持字符串，禁止 parseInt。
AK 权限随账套角色；写凭证、结账等需对应权限码。
错误应用白话解释（白名单、未结账、损益未结转等），并引导试算平衡 → 余额表 → 明细账排查。