合思(易快报)AI 财务助手 - 开源基础版

Polar Sponsor
爱发电 赞助
.NET 9.0

合思(易快报)企业财务费控助手。 这是一个基于合思 OpenAPI 构建的基础只读版本。 当用户询问“我的报销状态”、“我的单据”等本人财务数据时触发此 skill;他人、部门或企业级查询需升级版支持。 核心承诺:所有数据通过本地脚本直连合思 API 域名,安全开源。如需高级写操作(自动填单)请联系维护者定制。

合思(易快报)AI 财务助手 - 基础开源版

功能概述

合思(易快报)AI 财务助手 - 基础开源版是一项面向实际任务的技能,主要用于非官方项目:本 skill 不是合思官方产品,也不代表合思官方立场;使用前必须确认企业已经开通并授权相应 OpenAPI 权限;

核心要点

  • 商业版提示:本开源版仅包含通用的“数据查询(默认 GET/HEAD 查询,POST 需明确只读白名单)”能力;
  • 因为各企业的报销表单、审批流高度自定义,如需实现“一句话自动提单、超标拦截、飞书/钉钉跨系统联动”。
  • 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。

使用与执行

从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;

结果检查与注意事项

若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。

合思(易快报)AI 财务助手 - 基础开源版

非官方项目:本 skill 不是合思官方产品,也不代表合思官方立场。使用前必须确认企业已经开通并授权相应 OpenAPI 权限。

商业版提示:本开源版仅包含通用的“数据查询(默认 GET/HEAD 查询,POST 需明确只读白名单)”能力。因为各企业的报销表单、审批流高度自定义,如需实现“一句话自动提单、超标拦截、飞书/钉钉跨系统联动”等高级能力,需要进行企业专属定制。

⛔ MANDATORY RULES (强制规则)

  1. 绝对纯本地执行:所有 API 请求必须通过本 skill 内的本地脚本发送至合思官方服务器,不允许使用任何其他第三方中转代理。
  2. 凭证检查:每次执行前必须确保环境中配置了 EKUAIBAO_APP_KEY 和 EKUAIBAO_APP_SECURITY。
  3. 只读限制:当前基础版不包含提单(写操作)逻辑。如果用户要求“帮我提交一个报销单”,明确告知用户:“开源基础版暂不支持自动提单,该功能需要针对贵公司表单进行专项定制。”
  4. 隐私保护:人员、部门、成本中心等接口可能返回手机号、邮箱、法人主体等敏感信息。向最终用户回复时默认只展示必要字段,不要直接展开手机号、邮箱、证件号、银行账户等敏感信息,除非用户明确要求且具备权限。
  5. 受控业务查询优先:用户说“我的单据/我的报销/查某人的单据”时,必须优先使用 expense_query.cjs。只有调试基础接口时才直接使用 expense_api.cjs。
  6. 身份先行:查询“我的单据”前,必须先有当前登录态里的 staffId/userId,或向用户索取姓名 + 邮箱、姓名 + 手机号后四位等最小必要信息来定位员工。
  7. 权限边界:开源基础版默认只能查询当前用户本人信息。查询他人、部门或企业级数据,以及基于合思角色的权限校验,需要升级版接入合思角色/权限 API 后再开放。
  8. 禁止高风险接口:expense_api.cjs 只允许请求 EKUAIBAO_BASE_URL 配置的同源域名,已拦截 DELETE/PUT/PATCH 方法、未加入白名单的 POST 方法,以及路径或请求体中疑似删除、作废、撤销、回滚的接口;不得绕过该拦截。
  9. BI Demo 边界:expense_bi_demo.cjs 只能用于本地产品价值演示。必须明确说明它不调用合思接口,不代表真实企业数据,也不具备真实公司级查询权限。

Credential Check

如果缺失环境变量,请引导用户按以下方式配置凭证:

export EKUAIBAO_APP_KEY="你的合思AppKey"
export EKUAIBAO_APP_SECURITY="你的合思AppSecurity"
# 【环境配置】沙箱、测试环境或私有化部署时配置;不配置则默认访问 https://app.ekuaibao.com
export EKUAIBAO_BASE_URL="https://app.ekuaibao.com"

受控业务查询模板

普通用户查询必须走 expense_query.cjs,它会完成身份解析、本人范围校验和脱敏输出。

本地预检

正式查询前可运行:

node "$SKILL_DIR/preflight-check.cjs"

需要真实连通性验证时追加 --live,该模式会请求合思人员接口的第一页 1 条数据。

查询我的单据

优先使用登录态中的 staffId 或 userId。没有登录态时,向用户索取姓名 + 邮箱,或姓名 + 手机号后四位。

node "$SKILL_DIR/expense_query.cjs" my-docs '{"name":"张三","email":"zhangsan@example.com","count":10}'
node "$SKILL_DIR/expense_query.cjs" my-docs '{"name":"张三","phoneLast4":"1234","count":10}'

查询我的单据汇总

用于回答“我的报销整体怎么样”“我有多少单据在审批中”“有没有被驳回的单子”等汇总类问题。

node "$SKILL_DIR/expense_query.cjs" my-summary '{"staffId":"员工ID","count":100}'

返回状态分布、类型分布、按币种汇总金额、驳回数量和最近 5 条脱敏单据摘要。

查询指定员工单据

只有操作者和目标员工是同一人时才允许返回结果。查询他人需要升级版接入合思角色/权限 API。

node "$SKILL_DIR/expense_query.cjs" staff-docs '{"actor":{"staffId":"操作者员工ID"},"target":{"name":"张三","email":"zhangsan@example.com"},"count":10}'

企业级查询

开源基础版默认不支持企业级查询。该能力需要升级版接入合思角色/权限 API,并确认当前用户具备管理员、财务或企业授权角色。

node "$SKILL_DIR/expense_query.cjs" company-docs '{"actor":{"staffId":"操作者员工ID"}}'

本地老板/财务 BI Demo

当用户想看老板驾驶舱、财务汇总、统计、报表或 BI 产品价值演示时,可使用本地 demo。该能力不是开源基础版的真实企业级查询能力:

node "$SKILL_DIR/expense_bi_demo.cjs" company-summary '{"month":"2026-05"}'

输出 Markdown:

node "$SKILL_DIR/expense_bi_demo.cjs" company-report '{"month":"2026-05","format":"markdown"}'

生成 HTML:

node "$SKILL_DIR/expense_bi_demo.cjs" company-report '{"month":"2026-05","format":"html","output":"output/bi-demo-2026-05.html"}'

必须明确说明:这是本地演示数据,不调用合思接口,不是真实企业数据;真实公司级 BI 需要企业版接入合思角色/权限 API 后开放。

底层 API 调用模板

底层执行脚本 expense_api.cjs 会自动处理 accessToken 的获取与缓存,并内置同源域名、请求方法和删除/作废类接口拦截。普通业务查询不要直接调用它。

基本调用格式: node expense_api.cjs

默认只开放 GET/HEAD 查询,POST 必须先在代码白名单中确认为只读查询接口;所有业务请求都只能发往 EKUAIBAO_BASE_URL 配置的同源域名。

场景一:查询企业下属部门列表 (GET)

用于获取企业组织架构信息。

node "$SKILL_DIR/expense_api.cjs" GET "api/openapi/v2/departments?start=0&count=20" "{}"

场景二:查询人员列表 (GET)

用于获取企业人员基础信息。回复用户时默认只展示姓名、启用状态、认证状态等必要字段。

node "$SKILL_DIR/expense_api.cjs" GET "api/openapi/v2/staffs?start=0&count=20" "{}"

场景三:根据员工 ID 获取待审批单据 (GET)

用于根据员工 id 查询该员工相关的待审批单据。accessToken 由 expense_api.cjs 自动追加,调用时不要把真实 token 写进命令或回复。

路径中的 $ 是接口固定前缀,不是 shell 变量。员工 ID 放入 URL 时需要进行 URL 编码,例如 : 编码为 %3A。命令建议使用单引号包住 API path,避免 $ 被 shell 展开。

node "$SKILL_DIR/expense_api.cjs" GET 'api/openapi/v1.1/docs/byFlowId/$员工ID?index=0&count=10' "{}"

场景四:查询企业档案类别 (GET)

用于获取企业配置的自定义档案类别,例如项目、法人实体、成本中心、职级等。

node "$SKILL_DIR/expense_api.cjs" GET "api/openapi/v1/dimensions?start=0&count=100" "{}"

场景五:查询指定档案类别下的档案项 (GET)

先通过“查询企业档案类别”拿到 dimensionId,再查询该类别下的档案项。dimensionId 放入 URL 时需要进行 URL 编码。

node "$SKILL_DIR/expense_api.cjs" GET "api/openapi/v1/dimensions/items?start=0&count=100&dimensionId=档案类别ID" "{}"

错误处理机制

执行脚本会在 stderr 输出格式化的错误信息。如果遇到 token 错误、权限不足或查无数据,请直接将 msg 中的报错原因转达给用户。

相关专题

更多
Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

0

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

0

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

0

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

0

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

0

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

0

10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

0

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

2026.11.05

0

12

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

2026.11.04

0

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习