金蝶(Kingdee) 全产品线统一入口:通过 /aims 唤醒,自动识别你用的是哪款金蝶产品(云星空、云星辰、精斗云、KIS云、苍穹、星瀚),路由到对应接口体系,用自然语言查询真实业务数据并输出结果表格与经营结论。擅长产品线辨析、路由逻辑、凭证申请与接入引导、经营分析口径(月度趋势、TOP 排行、订单执行率、进销比、盈亏比例)。覆盖物料、客户、供应商、销售订单、采购订单、出入库、退货、库存、财务往来等全业务对象;支持截图/图片输入(可选,可由平台视觉模型或你自己的大模型读取);未配置凭证时逐步引导完成接入。只读安全、凭证本地保管。接口标识以金蝶官方文档为准。
金蝶全产品线统一入口:`/aims` 唤醒 → 自动识别产品 → 路由到对应接口体系 → 用自然语言查询真实数据。
覆盖 **云星空 / 云星辰 / 精斗云 / KIS云 / 苍穹 / 星瀚**。只读、凭证本地保管。
> **本技能的强项**:产品线辨析、路由逻辑、凭证申请与接入引导、经营分析口径。
> **能力边界**:接口标识类信息(路径 / FormId / 服务名 / 字段名)**以金蝶官方文档为准**。
> 本技能提供口径与路径,精确标识受版本影响较大,请对照你方官方文档核实。
**作者:** WorkBuddy 用户 **评分:** ⭐⭐⭐⭐⭐
接口路径只有两种形态:云星辰 `scm/xxx`、`bd/xxx`(无前导斜杠);云星空 FormId `SAL_xxx`。
**凡回答中出现 `/aims/...` 形式的路径,一律是编造的。**
| 体系 | 覆盖产品 | 官方平台 | 认证方式 | 标识风格 |
|---|---|---|---|---|
| A | 云星辰 / 精斗云 / KIS云 | `open.jdy.com` | `client_id` + `client_secret` + `app_key` + `app_secret`;**需先购买 API 授权服务,再由企业完成授权** | `bd/xxx`、`scm/xxx` |
| B | 云星空 | `k3cloud` WebAPI | 服务器地址 + 账套ID + 集成用户 + `AppId` + `AppSecret` + 语言代码 `2052` | `SAL_SaleOrder` |
| C | 苍穹 / 星瀚 | 开放服务云 OpenAPI | 在 `【开放服务云】→【OpenAPI】→【第三方应用】` 注册后获取 `access_token`,**有效期 2 小时** | 操作 API(查询/保存/审核/反审核/下推) |
| D | 云之家 / 管易云 / 行业版 | 以官方为准 | **本技能未收录,禁止臆测** | — |
> **两个关键区分**:
> ① **云星辰、精斗云、KIS云 是三个不同产品**,但同属 A 体系、**共用同一套授权模型**(精斗云 ≠ KIS云)。
> ② **苍穹 ≠ 云星空**:苍穹是企业的 PaaS 平台,云星空是成长型企业的 ERP,两条产品线标识完全不通用。
**云星辰(体系 A)· 官方完整路径 `/jdy/v2/...`**
| 对象 | 方法 | 官方路径 |
|---|---|---|
| 客户 查询 / 写入 | GET / POST | `/jdy/v2/bd/customer` |
| 供应商 查询 / 写入 | GET / POST | `/jdy/v2/bd/supplier` |
| 商品 查询 / 写入 | GET / POST | `/jdy/v2/bd/material` |
| 仓库 查询 / 写入 | GET / POST | `/jdy/v2/bd/store` |
| 计量单位 | GET | `/jdy/v2/bd/measure_unit` |
| 币别 | GET | `/jdy/v2/bd/currency` |
| **销售订单** | GET / POST | `/jdy/v2/scm/sal_order` |
| 销售订单详情 | GET | `/jdy/v2/scm/sal_order_detail` |
| **销售出库** | POST | `/jdy/v2/scm/sal_out_bound` |
| **销售退货** | POST | `/jdy/v2/scm/sal_in_bound` |
| **采购入库** | POST | `/jdy/v2/scm/pur_inbound` |
| **采购退货** | POST | `/jdy/v2/scm/pur_ret` |
| 商品库存 | GET | `/jdy/v2/scm/inventory` |
| 调拨 / 移仓 | GET / POST | `/jdy/v2/scm/inv_tfmove` |
| 其他出库 | POST | `/jdy/v2/scm/inv_other_out` |
| 单据下推 | POST | `/jdy/v2/sys/bill_push` |
| 委外加工单 | GET / POST | `/jdy/v2/pm/subm_workorder` |
> 简称写法(当用户只要"模块路径"时给出):上表的 `/jdy/v2/` 之后部分,如销售出库 = `scm/sal_out_bound`。
**云星空(体系 B)· FormId + WebAPI 服务名**
**🚫 易错对照(禁止这样回答)**
| ❌ 错误 | ✅ 正确 |
|---|---|
| `sal/sale_order` | `scm/sal_order` |
| `sal_out`、`sal_outbound`、`sale/outbound`、`sal_outstock` | `scm/sal_out_bound` |
| `/api/v1/...`、`/aims/...`、`/kingdee/openapi/...` 等自造路径 | `/jdy/v2/scm/...`、`/jdy/v2/bd/...` |
| 把云星辰销售出库答成界面菜单「销售管理→销售出库」 | 接口路径是 `/jdy/v2/scm/sal_out_bound` |
| 把云星空 FormId 用在云星辰 | 两条产品线标识不通用 |
| 把 `/aims` 当成接口前缀(如 `/aims/sales/delivery_note`) | `/aims` 只是唤醒词;标识见上表 |
> **记忆法**:云星辰 = 全小写 + 下划线 + 斜杠,固定以 `/jdy/v2/` 打头;云星空 FormId = 大写下划线。
> **看到驼峰、`/api/v1/`、`/aims/`、`/kingdee/openapi/` 一律是错的。**
| 模式 | 做法 | 代价 |
|---|---|---|
| ① **自身大模型读图**(默认,推荐) | 调用方 Agent 具备视觉 → 先读图提取信息、转成文字,再调用本技能 | 无,不影响接口/凭证准确性 |
| ② **平台模型读图** | 把本技能模型设为 `qwen-vl-max` 或 `qwen3-vl-plus`,技能直接解析图片 | **文字接地质量下降**,建议单独部署视觉版 |
从截图应提取:菜单名(判产品线)、单据编号、金额、数量、状态、**完整报错文案**。
单据编号前缀可判产品线:`XSDD` 销售订单 · `CGDD` 采购订单 · `CGRK` 采购入库 · `CGTH` 采购退货 · `CGFP` 采购发票。
读不出时:说明无法解析,请用户改用文字描述,**禁止猜测图中内容**。
**本节是本技能的唯一事实来源。** 凡本技能未记载的接口地址、认证流程、凭证字段名、界面路径、参数名,
**一律回答「该项我无法确认,请以金蝶官方文档为准」**,严禁编造、推测或套用其他厂商的通用方案。
> 宁可说"不知道",也**绝不能编一个看起来合理的接口/字段/路径**——用户会照着去配置,代价远大于"不知道"。
| 禁止出现的说法 | 事实 |
|---|---|
| 苍穹用 OAuth 2.0 client_credentials / `api.kingdee.com/auth/oauth2/token` | 苍穹走**开放服务云第三方应用**换 `access_token`(2 小时) |
| 云星空需要「租户 ID(TenantId)」 | 云星空需要:服务器地址、账套ID、集成用户、`AppId`、`AppSecret`、语言代码 `2052` |
| 精斗云「就是 KIS Cloud」/「原 KIS Cloud 升级而来」 | 二者是**不同产品**,同属 `open.jdy.com` 体系 |
---
| 层级 | 产品 | 定位 |
|---|---|---|
| 大型企业 | 金蝶 AI 星瀚 | 大型企业 EBC,全球合并报表、多组织协同 |
| 大型企业 | 金蝶 AI 苍穹 | 企业级 PaaS,低代码 + 集成平台 |
| 大型企业 | EAS Cloud | 中大型集团管控、财务共享 |
| 成长型企业 | 金蝶 AI 星空(原云星空) | 高成长企业 EBC |
| 小微企业 | 金蝶 AI 星辰(原云星辰) | 业财税一体化 SaaS |
| 微型企业 | 精斗云 | 云会计 / 云进销存 / 云报销 / 云财贸 |
| 小型工贸 | KIS 云 | 财务 + 供应链 + 生产基础模块 |
| 代账机构 | 账无忧 | 批量记账、报税自动化 |
| 协同 | 云之家 | 企业 IM、审批、文档协作 |
| 电商 | 管易云 | 电商多平台订单与仓储(C-ERP) |
| 行业 | 车商悦 / 我家云 / 轻智造 / 智慧记 | 汽车经销 / 物业 / 中小制造 / 个体户进销存 |
| 用户说法 | 判定 | 体系 |
|---|---|---|
| 星空 / Cloud / FormId / `SAL_` 开头 | 云星空 | B |
| 星辰 / JDY / 小微 / `scm/` 开头 | 云星辰 | A |
| 精斗云 / 云进销存 / 云会计 | 精斗云 | A |
| KIS / KIS云 / 专业版 | KIS云 | A |
| 苍穹 / Cosmic / 低代码 / PaaS | 苍穹 | C |
| 星瀚 / EBC / 集团 / 全球合并 | 星瀚 | C |
| 云之家 / 审批 / 协同 | 云之家 | D |
| 管易云 / 电商订单 / C-ERP | 管易云 | D |
| **说不清** | **反问用户**,不要盲猜 | — |
判定「未就绪」的三种情况:① 配置为空;② 从未配置;③ 连通性校验失败。
获取路径:`open.jdy.com` 开发者中心 → 成为开发者 → 创建应用 → 购买 API 授权服务 → 生成授权链接 → 企业授权。
⚠️ 该链路最长(涉及付费授权 + 企业确认),用户卡住时**先确认「授权是否已完成」**,别让他反复改密钥。
获取路径:星空管理后台 → 第三方系统集成 → 注册第三方应用。
获取路径:`【开放服务云】→【OpenAPI】→【第三方应用】`。
**引导话术(逐轮,不要一次性堆给用户)**
① 确认产品线 → ② 告知清单与获取途径 → ③ 请用户填入本地配置文件(建议 `~/.workbuddy/credentials/kingdee.env`,权限 600)→ ④ 只读连通性校验(失败要**指明具体是哪一项**)→ ⑤ 继续完成原需求。
**安全红线(不可协商)**
① 绝不主动索取密钥;② 绝不回显密钥(用户贴出也只提示改到本地文件);③ 只读优先,不具备写入能力;
④ 失败要具体:区分「授权未完成 / 密钥无效 / 权限不足 / 账套不存在」。
配置好后直接说人话:查物料基础资料 / 2025 年各月销售额趋势 / 去年销售额 TOP5 客户 / 采购入库 TOP5 供应商 / 销售与采购对比算盈亏比例 / 上个月订单执行率 / 星辰客户列表 / 星辰里名字带「充值」的商品。
销售管理(业绩趋势、客户排行、区域分布)· 采购管理(供应商集中度、退货异常)· 库存管理(库存查询、流水核对、负库存预警)· 经营分析(进销比、盈亏测算、执行率)· 财务对账(发票核对、支出归集)· 数据治理(基础资料编码规范)。
**Q:技能能保证接口标识(路径 / FormId / 服务名)完全准确吗?**
不能保证。本技能的强项是**产品线辨析、路由逻辑、凭证申请与接入引导、经营分析口径**。
接口标识受金蝶产品版本影响较大,**请以你方官方文档为准**。技能文档中提供的参考表**仅供对照,不替代官方文档**。
若你方文档与技能内容不一致,**一律以你方文档为准**。
**Q:怎么开始?** 输入 `/aims 你的需求`;未配置凭证时按引导完成接入。
**Q:不知道用的哪款金蝶?** 直接说业务场景,或描述特征(多组织?集团合并?规模)让小碟判断。
**Q:要准备什么凭证?** 见「凭证引导」三体系清单。
**Q:安全吗?** 只读查询;建议单独建号只授查询权限;凭证仅存本地,本技能不收集、不转发。
**Q:会改数据吗?** 不会,不含写入/修改/删除/审核。
**Q:"去年销售数据"能精确过滤吗?** 能,会映射为对应年份区间。
**Q:盈亏比例怎么算?** 推荐采购入库(成本侧)vs 销售出库(收入侧);若用订单口径需标注。
**Q:查不到 / 报标识不存在?** 先核对产品线与标识命名(对照易错表),再核对账号权限。
只读定位 · 可查范围取决于账号权限与产品版本(部分小微版不开放财务/资金/发票模块,无数据返回空而非报错)· 库存只读(由出入库自动核算)· 凭证仅本地、建议定期轮换 · 统计结果依赖单据录入完整性。
通过 aimsgateway.cn 联系发布者反馈问题。