财务软件账套连接器（已适配用友好会计、金蝶云会计、金蝶精斗云、浪潮云会计、亿企代账等主流云端财务软件）

概述

第三方财务数据查询与分析 Skill

1. 核心流程

固定链路：

确认软件 → 柠檬云用户转官方 Skill / 第三方软件确认支持范围 → 获取 API Key → 获取必要登录信息 → CLI 登录（传入 Key，由 CLI 校验）→ 查询账套并经用户确认 → 一次完整采集 → 本地保存 → 生成分析快照 → 查询/汇总/财务分析

本 Skill 的核心能力是连接第三方财务软件、获取用户有权限访问的账套数据，并基于本地采集结果进行持续查询和分析。

1.0 会话准备与更新后重读（先执行）

1. 每个会话首次使用时，先在独立 PowerShell 进程执行 scripts/prepare-session.ps1，等待完整 JSON 结果后再读取业务引用、检查 Key 或开始业务；这些动作按顺序执行。它串行检查/更新 Skill，避免更新期间并行读入旧文件。
2. 已确认当前任务需要受支持的 CLI 登录、列账套、采集或刷新时，加 -RequireCli，由准备脚本在 Skill 更新完成后调用当前磁盘的 CLI Update；本地缺失或落后才下载，同版复用、不降级。纯本地分析不加此参数。软件/平台尚未确认时先只准备 Skill，读取支持规则确认后再带 RequireCli 准备；明确离线时加 -Offline，不宣称最新。维护入口目前使用 Windows PowerShell；无可用引擎时说明无法自动维护，保留原安装，授权纯本地分析仍可继续，CLI 采集仍按平台闸门执行。
3. 先处理 reload_required，再判断能否继续业务。 为 true 时，按 reload_paths 重新读取新版 SKILL.md 和当前任务引用，依据新内容重新安排未执行步骤；即使随后 CLI 失败也要完成重读。status=Updated 才表示发生更新，previous_version 是更新前值，local_version 是更新后值，不能因 local/latest 相同而宣称未更新。磁盘更新不代表模型已加载新版。
4. 重读完成后，只有 success=true 且需要 CLI 时 cli_ready=true 才使用返回的 cli_executable 进入本轮业务；CLI 失败按运行位置说明处理，不能伪报就绪。本会话已成功准备 CLI 时，后续每轮只用 Resolve，整轮固定同一实例；用户明确更新/重试时重新准备。命令、失败保留和重读协议见 references/deployment-update.md 的“统一会话准备与规则重读”。

1.1 采集版 CLI 平台支持闸门（V0.1.1）

• 目前仅支持在 Windows x64（AMD64）的真实 CLI 执行环境中运行采集版 CLI。 每次准备执行 CLI 登录、查询账套、采集或刷新前都要确认 Agent 实际执行主机的 OS/架构；不能用用户电脑系统代替执行环境。
• 若为 macOS、Linux、ARM64、移动设备或无法确认执行环境，禁止调用 Windows CLI，明确提示当前采集能力只支持 Windows 64 位，不得假装已成功采集；不得私自尝试兼容层或更换其它 CLI。
• 已有可信本地快照的数据查询与 AI 分析不依赖 CLI，可以在环境允许读取数据且满足授权的情况下继续；需要重新登录或刷新时仍需满足 Windows x64 条件。
• 详细的安装前拦截、提示文案与平台支持范围见 lemon-finance-data-analysis-install.md 的“当前平台支持限制”。

首次 CLI 业务统一执行 prepare-session.ps1 -RequireCli，底层安装、更新、定位继续复用 install-collector-cli.ps1；先完成 1.0 的顺序准备及规则重读，再进入登录。已准备会话后续每轮 Resolve，整轮固定同一实例。详细位置、离线、失败保留旧版与最低版本处理见 references/external-cli-runtime.md。

2. 首次安装、首次启用与 API Key

2.1 安装完成后的首次提醒

安装、更新或新会话中需要连接业务时，先按 references/api-key-storage.md 执行本机 Status 检查；已保存且可读则自动复用，不因开启新会话再次索取 Key。仅未配置时给出以下引导；安装和纯本地分析不以 Key 为前提：

• 简单说明本 Skill 用于连接第三方财务软件并进行账套查询与财务分析。
• 提醒首次使用前需要到柠檬云 AI 财税开放平台创建 API Key，并绑定【第三方财务数据采集】能力权限。
• 用户已有 API Key 时直接使用；提供 Key 用于配置后加密保存到本机，无需重复创建。

不得向用户展开内部执行流程、安装包结构、CLI 位置、运行机制等技术说明。

2.2 API Key 配置成功后的试用引导

仅在 Save 成功后提示“API Key 已加密保存到本机，下次会话可自动使用；实际有效性将在连接时校验”。用户明确只本次使用时提示“API Key 已用于本次会话，未保存”；保存失败不能宣称配置完成。随后给出 3～5 个可直接尝试的问题，例如：

• 帮我连接我的财务软件
• 帮我看看这个月的经营情况
• 帮我分析最近 3 个月收入、成本、费用和利润的变化
• 帮我查一下管理费用为什么比上个月高
• 帮我查询某个科目的余额、明细或相关凭证

不要向用户解释后续内部执行流程。若尚未采集账套数据，这些内容仅作为试用示例。

2.3 API Key 使用规则

• 新业务会话先使用 scripts/manage-api-key.ps1 -Mode Status 检查本机保存记录；Configured 时通过 Get 读取，缺失时才获取用户已有 Key 或引导创建。用户提供 Key 用于配置时通过 Save 加密保存，更换和清除分别用 Save、Clear；详细命令、读取异常及更新保留规则见 references/api-key-storage.md。
• API Key 需绑定【第三方财务数据采集】能力权限；具体权限名称以开放平台实际配置为准。
• 每次调用 third-party-login、select-account-sets、generate-accountset-packages 都必须通过 --api-key <运行时 API Key> 显式传入同一轮使用的 Key。 即使前一条命令已成功，也不能省略后续命令的 Key。
• 由 CLI 在每个业务命令入口自动校验 API Key，有效且有权限才进入业务执行。 Skill 不单独请求鉴权接口，不新增“先由 Agent 鉴权、通过后才能启动 CLI”的外层流程。
• Key 缺失时不发起业务命令；CLI 返回 Key 无效、无权限或授权服务不可用时，停止本次业务流程，按实际结果引导用户配置、调整权限或稍后重试，不绕过校验、不假称成功。
• Key 不放入 --config 的业务 JSON、Account.json 或 release-config.json；CLI 不从这些文件读取 Key。命令构造使用独立参数传值，不回显带 Key 的完整命令。
• API Key 仅通过专用脚本以 Windows 当前用户 DPAPI 密文保存到 Skill 同级本机凭据文件，业务调用时解密到内存；明文不写入文件、日志、快照或 AI 最终回答。第三方软件登录密码不持久化。
• 已经成功采集到本地的数据，后续仅做本地查询和分析时不需要 Key，也不重复鉴权；--help、--print-schema、--version 和公开版本 GET 查询均不需要 Key。
• 用户主动要求重新获取最新数据、刷新或重新采集时，重新取得或复用已授权 Key，并在本轮每个业务 CLI 命令中再次传入，由 CLI 逐次校验。

已通过当前采集版 CLI 的 --help / --print-schema 确认参数为 --api-key。具体调用示例、独立 Key 文件的使用边界和错误处理见 references/cli-workflow-core.md；CLI 升级后以实际帮助为准，不猜测未支持的参数。

3. 数据采集流程

3.1 确认软件与柠檬云分流（必经）

1. 首次连接前询问“您正在使用哪款财务软件？”；如果用户已经明确给出软件名称则直接使用，不重复询问。用户仅提供品牌而版本影响适配判断时，再追问具体版本，不自行猜测。
2. 柠檬云分支：若用户使用柠檬云财务软件，直接告知：“柠檬云已原生集成 AI 能力，直接使用柠檬云官方 Skill 即可，数据直连、无需额外配置，体验更顺畅。”提供官方入口 https://www.ningmengyun.com/skill/index ，请用户自行访问；当前第三方采集连接流程到此结束，不收集第三方登录凭据、不调用采集 CLI。
3. 其他第三方软件分支：读取 references/source-intake-modes.md 并优先运行 scripts/source_capability_lookup.py --software <软件名称> --out <结果文件> 识别软件身份和登录路由；脚本未命中时定位读取 references/source-capabilities.md 对应软件内容，不全文预加载。确认支持的登录方式后才进入下一步。

3.2 登录信息收集、CLI 登录与账套确认（强制）

1. 软件名称已在 3.1 确认，不重复收集。 优先使用当前智能体平台自带的信息收集表单/弹窗及安全密码字段；平台没有可用表单或安全密码输入能力时，可由用户在对话中提供必要登录信息，不因缺少表单而阻断登录。仅在用户发起连接时获取凭据；对话输入可能由平台保存在聊天记录中，不承诺完全不留存。
2. 必要登录信息：登录账号（必填）、登录密码（必填）、拟分析的企业/账套名称（选填，可跳过）。按对应软件的实际登录要求动态增加字段：如账三丰等需企业号的软件，企业号为该软件登录时的必填项，其他无需企业号的软件不显示或不强制填写。不得把所有三方软件的企业号一律设为必填。验证码/动态认证按实际 CLI 能力与安全交互处理。
3. 若用户提前提供账套名称，仅作为登录后账套列表匹配线索，不能跳过查询和最终确认，也不能要求用户在登录前一定知道账套名称。
4. 获取必要凭据和 API Key 后，由 Agent 将账号、密码等作为当前 CLI 支持的独立命令行参数传入第三方登录命令，并通过 --api-key 传入 Key，由 CLI 先完成授权校验再执行登录。第三方登录密码和解密后的 Key 保存在运行时变量中，不将明文写入配置、脚本、日志、报告或快照，不回显密码、Key 或包含它们的完整命令；登录失败按实际错误原因反馈，允许用户重新提供。具体参数见 references/cli-workflow-core.md。
5. 登录成功后通过 CLI 查询真实可访问的企业/账套列表，展示名称及可获取的识别信息，让用户选定或确认本次要分析的公司账套。即使仅查询到一个账套，也须明确展示名称并等待用户确认。预填名称匹配到多个候选时必须由用户选择，不得自动猜测。
6. 只有用户确认目标账套后才能正式采集。默认一次采集一个账套；需要多账套对比时逐个确认目标及采集范围。不得以未确认的账套直接开始采集。

3.3 一次完整采集

• 用户未明确限定采集范围时，默认采集全部科目、期初、凭证及当前采集版 CLI 对该云端软件支持的全部业务数据，包括报表、发票、资金流水、固定资产、员工及工资；不因用户只问利润、费用等分析问题而缩小采集范围，也不主动要求用户逐项启用模块。
• 用户明确“不采集某部分”时，仅排除指定部分，其余全部采集；明确“只采集某部分”时，仅采集指定部分。按本轮最新的明确范围执行，未重新限定的刷新沿用已确认范围。
• Agent 根据当前 CLI 帮助/schema 设置实际模块开关；参数和范围落实见 references/cli-workflow-core.md。软件查询只定位软件和登录方式，不用静态模块名单关闭采集。
• 只有实际返回或产物确认的成功、无数据、失败、无权限或不支持才作对应说明；完成回复不展示默认关闭模块的提醒，实际失败仍如实报告。
• 某个模块失败时，可保留其他已成功模块并继续分析；采集完成时说明实际缺失，不能把部分成功报成全部完成。
• 同一轮采集形成同一批数据快照，避免连续查询时混用不同采集时间的数据。

3.4 采集完成

采集完成后运行：

• scripts/record-analysis-snapshot.py：按 CLI 实际结果准备模块状态文件，通过 --module-status-json 传入，不能把未传开关视为未采集；格式见核心执行协议。
• scripts/build-analysis-handoff.py

生成：

• analysis_snapshot.json
• analysis_handoff.json

调用智能体优先读取 analysis_handoff.json 获取来源软件、账套、采集时间、模块状态和数据位置，不为获取这些信息重新扫描大数据包或执行日志。

4. 数据时间基线

只要回答使用了本次采集数据，首次分析回复或用户询问数据新旧时必须说明：

数据基线：本次分析基于 <collectedAt> 从 <来源软件>/<账套名称> 采集的数据。

若 dataThrough 已知，再补充：

来源业务数据覆盖至 <dataThrough>。

不得把历史快照描述为实时数据或当前最新数据。

用户明确提出重新获取、更新、看最新、重新采集等请求时：

取得或复用已授权 API Key → 各业务 CLI 命令传入 Key 并由 CLI 校验 → 重新登录第三方软件 → 按已确认范围重新采集 → 生成新快照 → 后续查询使用新快照

不做不同采集时间的数据模块拼接。

5. 查询与分析

5.1 查询原则

• 不让 AI 直接读取整个大型数据包。
• 大量凭证、余额、发票、资金流水先由脚本或确定性查询方式筛选、汇总、排序或 TopN，再将必要结果交给模型。
• 只读取回答当前问题需要的数据。
• 明确存在的 ID、编码或稳定业务键才允许跨模块关联。
• 不得仅根据金额相同、日期接近、摘要相似或客户名称相同推断关联关系。

5.2 查询边界

以下情况必须明确说明，不能猜测：

• 当前软件未适配该数据模块
• 当前模块本次采集失败或无权限
• 数据中不存在用户询问的信息
• 数据没有明确跨模块关联关系
• 缺少业务背景，无法判断真实业务原因
• 没有明确规则，无法判断违规、风险或业务合理性

6. 采集完成后的用户引导

采集完成后，先告知用户账套数据已获取，并根据本次实际采集成功的模块动态推荐 3～5 个可继续执行的问题。

基础推荐方向：

• 经营情况：分析收入、成本、费用、利润及变化
• 账务查询：查询科目余额、明细、凭证
• 报表分析：分析资产负债表、利润表等（本次有报表数据时才展示）
• 发票分析：查询或汇总发票（本次有发票数据时才展示）
• 资金分析：查询账户收支、主要流入流出（本次有资金数据时才展示）
• 资产分析：查询固定资产及折旧（本次有资产数据时才展示）
• 工资分析：查询员工工资数据（本次有工资数据且权限允许时才展示）

推荐话术示例：

账套数据已经获取完成。接下来您可以直接告诉我想查什么。比如：①分析本月经营情况；②对比最近 3 个月收入、成本、费用和利润；③查询某个科目的余额和相关凭证。

不得推荐当前软件不支持或本次没有成功采集的数据能力。

7. 本地数据与隐私

• 第三方软件账号密码只用于本次第三方登录，以运行时变量传入 CLI；不回显密码或包含密码的完整命令，不主动写入配置、脚本、日志、报告或快照。
• API Key 允许专用脚本在本机保存 DPAPI 密文；明文不写入磁盘、日志、快照或报告。
• 采集数据保存在本地任务目录，后续查询优先复用本次数据。
• 不同任务、不同账套的数据必须隔离。
• 员工、工资、身份证、手机号、银行卡等敏感数据只在用户有权限且确有查询需要时读取；最终回答避免无必要展示完整敏感字段。

8. Token 与执行约束

1. 软件身份和登录路由优先运行 source_capability_lookup.py；模块采集按 3.3 和实际 CLI 参数执行，不按静态名单缩减。
2. 时间、来源、账套、模块状态优先读取 analysis_handoff.json。
3. 大数据必须先筛选或聚合，再交给模型。
4. 不递归扫描整个输出目录判断进度；使用 scripts/cli_runtime_state.py。
5. 已采集完成的数据重复查询时不得重新登录或重新采集。
6. 只有用户要求最新数据或当前快照不可用时才重新采集。
7. 正常路径只加载 references/cli-workflow-core.md；登录兼容和来源识别按需加载 references/source-intake-modes.md。

9. CLI 运行位置

业务调用先完成 1.0 的统一准备和必要重读，首次通过 prepare-session.ps1 -RequireCli 自动更新并取得已验证 EXE；已准备会话后续每轮才用 -Mode Resolve，整轮采集使用同一实例。安装、更新和修复参数见安装说明；本机位置配置、验证与失败保留规则统一见 references/external-cli-runtime.md。

执行前检查 CLI 是否存在。该检查属于内部运行准备，安装完成时不要主动向用户说明安装包结构或 CLI 文件情况；只有用户实际发起采集且运行环境确实不可用时，再给出必要的故障提示。不得自行搜索其他可执行文件或替换运行程序。

所有具体命令参数以当前 CLI --help / --print-schema 为准。

10. 统一 Skill 发布与安装说明（V0.1.1）

• 仅有一个 lemon-finance-data-analysis Skill。SKILL.md 为业务执行说明；同目录 lemon-finance-data-analysis-install.md 是官网“复制安装链接”所指向的安装与更新说明文件，并不是第二个 Skill。
• 官网发布安装说明文件，同时在 OSS 提供该 Skill 的唯一 ZIP 发布包。ZIP 根目录直接包含 SKILL.md 等文档、配置及脚本目录，没有外层 Skill 文件夹；手动新装默认创建 <Agent Skill 根目录>/lemon-finance-data-analysis/；平台安装时使用已注册的实际目录，保留后缀等完整目录名，再解压包内内容。采集版 CLI 为独立依赖，按 release-config.json 中已配置的当前环境 Windows AMD64 OSS 地址下载，不嵌入 Skill ZIP。
• 首次安装和手工重装先阅读 lemon-finance-data-analysis-install.md；使用时自动更新执行 1.0 的入口及部署说明，不以 CLI 版本代替 Skill 版本。首次配置 API Key 时按安装说明的简短用户提示处理。
• 统一发布配置为 release-config.json。当前环境安装说明、Skill ZIP 与 Windows AMD64 CLI ZIP 的 OSS 地址均已配置。安装和更新按版本号检查，不使用哈希校验；Skill 版本由 metadata.version 与配置的 version 维护。CLI 最新版本查询复用导账工具公开接口 GetImportToolLatestVersion，Host 为 https://daozhangapi.ningmengyun.com，无需鉴权；本地版本通过采集版 CLI 的 --version 读取。
• 本地已有且经确认可用的采集版 CLI 可继续走原采集流程，具体参数以 CLI 实际 --help / --print-schema 为准。

11. 采集结果按 11 个模块拆分（V0.1.1）

当 CLI 采集成功并同时产生 AccountSet.json 和 FinancialTables.json 后，在同一任务数据目录执行：

python -X utf8 "<Skill安装目录>scriptssplit_json_modules.py" --accountset ".AccountSet.json" --financial-tables ".FinancialTables.json" --output-dir ".modules"

• 实际调用使用经过安全解析的本地路径，不能将 <Skill安装目录> 字面量直接执行；若文件在其他目录则使用绝对路径。
• 不修改源文件；脚本仅从现有 JSON 字段拆分、保留未识别字段和报告各期间；不可为了让拆分成功而删除/篡改科目期初或凭证。
• 11 个模块：basic_information、journals、invoices、salary、fixed_assets、accountset_metadata、balance_sheet、income_statement、trial_balance、business_activity、financial_tables_metadata。
• basic_information.json 汇集科目、辅助核算、科目余额和凭证；报表模块按期间保留。查询优先定位目标模块，禁止全文加载模块文件再分析。
• 任一源文件缺失、JSON 非法、拆分失败：保留原始采集数据并提示模块化处理未完成；不得声称模块生成成功。只有两份源文件均存在且拆分成功才启用模块化读取；不能凭空补齐缺失数据。
• analysis_snapshot.json / analysis_handoff.json 的原有生成逻辑保留；模块拆分为后续本地高效查询的附加步骤，不替换来源时间基线与采集结果真实性。

12. 导账工具最新版本查询（V0.1.1）

• 每个会话首次需要 CLI 时，由统一准备入口内部调用 CLI -Mode Update 查询并按需更新；用户仅询问导账工具或采集版 CLI 最新版本、更新内容、最低支持版本时按 references/import-tool-version-query.md 只查询，不下载安装。纯本地快照分析不因此增加一次调用。
• 接口为 GET https://daozhangapi.ningmengyun.com/api/accimport/GetImportToolLatestVersion，仅需 Accept: application/json，无需 Bearer accessToken、API Key 或登录态，不发送 Authorization。直接使用 release-config.json 已配置的 Host 与完整接口地址，不读取凭据文件或触发登录流程；实际数据采集的 API Key 鉴权规则保持不变。
• 服务器最新版本只取接口 Data.Version。本地已有采集版 CLI 时，用安装记录中的实际 EXE 执行 --version 参数，读取成功结果的 data.version 并确认 data.edition=Collector；本地不存在时报告“未安装 CLI”。仅查询版本不下载 CLI，实际安装或更新完成后再运行命令读取版本。两种版本不得互相替代，也不使用包内历史版本记录代替当前命令结果。
• release-config.json 的 cli_version 可以留空，不作为最新版本或本地已安装版本的依据。有效的服务器版本与本地命令版本相同则复用；实际 CLI 业务首次准备时，本地落后由 Update 自动更新，仅查询版本时只说明可更新。更新后由安装器运行 --version 核对；版本无法取得时如实说明，不假称已是最新，不自动降级。
• 严格检查 HTTP、Code 和非空 Data.Version；只读 GET、不执行发布版本更新 POST；成功报告环境、时间、版本和更新说明，最低支持版本非空时一并报告；失败不得伪报版本。
• 开发已确认采集 CLI 与导账工具共用版本号：使用接口 Data.Version 与本地 data.version 检查版本。接口附带的 Data.PackageSha256 和 Data.PackageSize 不参与本 Skill 的版本判定或安装检查；实际更新完成解压、启动验证和必要回滚，详见引用文档。

13. 版本记录

• V0.1.1 / 2026-10-09：统一 Skill 发布版本、安装目录和发布文件名；配置测试环境安装说明、Skill ZIP 及外置 CLI 地址。
• 本版保留 Windows x64 执行环境检查、软件分流、安全凭据收集、采集前账套确认、完整采集、快照查询分析和 11 模块拆分规则；采集范围及模块结果按本版规则记录。
• CLI 与导账工具共用版本查询协议，使用已配置导账服务 Host 的公开 GET，无需登录或鉴权；安装更新按版本号检查，不使用哈希校验，保留解压验证、更新回滚及已有快照查询规则。
• V0.1.1 / 2026-10-12：发布地址配置为 https://download.ningmengyun.com/Skills/tax-ledger-import/，运行与版本核对规则保持不变。
• V0.1.1 / 2026-10-12：登录优先使用平台表单；无可用表单时允许用户通过对话提供必要信息，由 Agent 以运行时参数调用 CLI；安装阶段不收集凭据。
• V0.1.1（2026-10-13）：新增 API Key 本机加密保存，新会话自动读取，支持更换和清除；Skill 更新保留同级密文。
• V0.1.1 / 2026-10-13：新增使用时 Skill 自动更新；先读取 OSS 同名 Markdown 的元数据版本，远程更高才下载 ZIP，保留外置配置和 CLI，失败回滚并报告。
• V0.1.3 / 2026-10-13：CLI 在每个会话首次需要登录或采集时自动检查更新，缺失或落后才下载；后续离线定位，保留旧版、API Key 和数据。
• V0.1.4 / 2026-10-13：新增串行会话准备入口，更新后明确返回旧版本、当前版本及重读清单，修复 Skill 更新后仍使用旧上下文而漏掉 CLI Update 的流程风险。
• V0.1.5 / 2026-10-14：默认采集全部科目、期初、凭证及业务数据，仅按用户明确范围排除或只采集指定部分；移除静态模块名单限制，快照区分成功、无数据、排除、失败和未知状态。
• V0.1.6 / 2026-10-14：兼容平台为安装目录追加身份后缀或使用自定义目录名；依据脚本位置原位更新，以包内逻辑名称校验身份，保留既有外置凭据和 CLI 记录。