First read
../openerp-shared/SKILL.md(authentication, exit codes, output contract).
There are thousands of Kingdee business objects.Discovery layerlets you look up any object at runtime, without waiting for a domain command wrapper. High-frequency objects already have domain commands (see ../openerp-domains/SKILL.md); everything else follows this three-step discovery process.
Three-step discovery workflow
# 1) 找对象 FormId（搜 BOS_ObjectType）
openerp objects --keyword 销售订单
# → 行含 [FID, FName, FSubSystemId]，FID 即 FormId（如 SAL_SaleOrder）
# 2) 查该对象的可用字段
openerp schema SAL_SaleOrder --fields-only
# → 各 entry 的字段 key/中文名/类型/关联对象(lookUpForm)
openerp query --form-id SAL_SaleOrder
--fields "FBillNo,FDate,FCustId.FName,FMaterialId.FNumber,FQty"
--filter "FBillNo='XSDD000006'" --top 20
> **发现前先回忆、发现后即沉淀**：三步发现前先 `ls ~/.config/openerp/object-notes/` 看该 FormId 有无既往经验；查通后把已验证的字段/过滤/陷阱写回 `object-notes/{FormId}.{profile}.md`。约定见 [`../openerp-shared/SKILL.md`](../openerp-shared/SKILL.md) §6「对象经验」。
## 关键规则（实测坐实，务必遵守）
- **字段 key 不要带 entry/分录前缀。** ExecuteBillQuery 把表头与分录字段拉平在同一命名空间：用分录字段就直接写它的 key（如 `FMaterialId`、`FQty`），**不要**写 `FEntity.FMaterialId` / `FSaleOrderEntry.FQty`（会报“标识为 FEntity 的字段不存在”）。
- **关联字段用点号下钻**：`FSupplierId.FName`、`FMaterialId.FNumber`、`FCustId.FNumber`。`schema` 输出里字段的 `lookUpForm` 非空即表示它是关联字段，可点号取关联对象的字段。
- **字段名大小写敏感**，以 `schema` 实测为准（同一概念在不同单据可能是 `FMaterialId` / `FMATERIALID` / `FMaterialID`）。
- **查询要带过滤或 --top**，避免全表扫描；超过 2000 行用 `--page-all`。
- 某字段整列为 `null`：多为无数据权限或字段名拼错 → 回到 `schema` 核对。
## 命名陷阱与不支持项
- **即时库存现量用 `STK_Inventory`（现存量余额对象），不是 `STK_InventoryQuery`**（后者是查询界面，无字段模型）。已封装为 `openerp inventory balance list`。
- **报表/账表**（模型类型 900、GUID 命名，如“销售订单执行明细表/销售明细表”）：**仍不支持**，需 `GetSysReportData`；或改用对应单据（如 `SAL_OUTSTOCK` 出库明细）复现。
- 个别对象 `QueryBusinessInfo` 返回空模型（如车间成本计算 `CB_SFCCostCalBill`）→ 无可查字段，不能走通用查询。
## objects 命令
```bash
openerp objects --keyword <名称关键词> # 必须给收敛条件
openerp objects --subsystem <子系统> # 按子系统过滤
openerp objects --keyword 委外 --top 30
schema command
openerp schema <FormId> # 完整元数据
openerp schema <FormId> --fields-only # 精简字段清单（推荐）