合思(易快报)企业财务费控助手。 这是一个基于合思 OpenAPI 构建的基础只读版本。 当用户询问“我的报销状态”、“我的单据”等本人财务数据时触发此 skill;他人、部门或企业级查询需升级版支持。 核心承诺:所有数据通过本地脚本直连合思 API 域名,安全开源。如需高级写操作(自动填单)请联系维护者定制。
合思(易快报)AI 财务助手 - 基础开源版
功能概述
合思(易快报)AI 财务助手 - 基础开源版是一项面向实际任务的技能,主要用于非官方项目:本 skill 不是合思官方产品,也不代表合思官方立场;使用前必须确认企业已经开通并授权相应 OpenAPI 权限;
核心要点
- 商业版提示:本开源版仅包含通用的“数据查询(默认 GET/HEAD 查询,POST 需明确只读白名单)”能力;
- 因为各企业的报销表单、审批流高度自定义,如需实现“一句话自动提单、超标拦截、飞书/钉钉跨系统联动”。
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
使用与执行
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
结果检查与注意事项
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
合思(易快报)AI 财务助手 - 基础开源版
非官方项目:本 skill 不是合思官方产品,也不代表合思官方立场。使用前必须确认企业已经开通并授权相应 OpenAPI 权限。
商业版提示:本开源版仅包含通用的“数据查询(默认 GET/HEAD 查询,POST 需明确只读白名单)”能力。因为各企业的报销表单、审批流高度自定义,如需实现“一句话自动提单、超标拦截、飞书/钉钉跨系统联动”等高级能力,需要进行企业专属定制。
⛔ MANDATORY RULES (强制规则)
- 绝对纯本地执行:所有 API 请求必须通过本 skill 内的本地脚本发送至合思官方服务器,不允许使用任何其他第三方中转代理。
- 凭证检查:每次执行前必须确保环境中配置了
EKUAIBAO_APP_KEY和EKUAIBAO_APP_SECURITY。 - 只读限制:当前基础版不包含提单(写操作)逻辑。如果用户要求“帮我提交一个报销单”,明确告知用户:“开源基础版暂不支持自动提单,该功能需要针对贵公司表单进行专项定制。”
- 隐私保护:人员、部门、成本中心等接口可能返回手机号、邮箱、法人主体等敏感信息。向最终用户回复时默认只展示必要字段,不要直接展开手机号、邮箱、证件号、银行账户等敏感信息,除非用户明确要求且具备权限。
- 受控业务查询优先:用户说“我的单据/我的报销/查某人的单据”时,必须优先使用
expense_query.cjs。只有调试基础接口时才直接使用expense_api.cjs。 - 身份先行:查询“我的单据”前,必须先有当前登录态里的
staffId/userId,或向用户索取姓名 + 邮箱、姓名 + 手机号后四位等最小必要信息来定位员工。 - 权限边界:开源基础版默认只能查询当前用户本人信息。查询他人、部门或企业级数据,以及基于合思角色的权限校验,需要升级版接入合思角色/权限 API 后再开放。
- 禁止高风险接口:
expense_api.cjs只允许请求EKUAIBAO_BASE_URL配置的同源域名,已拦截DELETE/PUT/PATCH方法、未加入白名单的POST方法,以及路径或请求体中疑似删除、作废、撤销、回滚的接口;不得绕过该拦截。 - 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 中的报错原因转达给用户。
热门AI工具
相关专题
本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。
0
2026.11.12
本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.12
本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。
0
2026.11.12
本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。
0
2026.11.06
围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。
0
2026.11.06
详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。
0
2026.11.06
DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。
0
2026.11.05
DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。
0
2026.11.05
本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。
0
2026.11.04
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.9万人学习
共6课时 | 54.7万人学习
最新文章