82 lines
4.0 KiB
Markdown
82 lines
4.0 KiB
Markdown
# 2026-03-29 日志
|
||
|
||
## 铱云易订货 API 重大修正
|
||
|
||
今天对铱云易订货 API 文档进行了系统性测试，发现并修正了大量错误。
|
||
|
||
### 1. API 路径全面修正（旧 → 新）
|
||
|
||
| 接口 | 旧路径（错误） | 新路径（正确） |
|
||
|------|---------------|---------------|
|
||
| 仓库列表 | `/openapi/warehouse/list` | `/invoicing-aggregation/warehouses` |
|
||
| 员工列表 | `/openapi/employee/list` | `/organization-aggregation/employees/search` |
|
||
| 商品单位 | `/openapi/unit/list` | `/product-aggregation/units` |
|
||
| 商品分类 | `/openapi/category/list` | `/product-aggregation/categories` |
|
||
| 商品品牌 | `/openapi/brand/list` | `/product-aggregation/brands` |
|
||
| 商品列表 | `/openapi/product/list` | `/product-aggregation/products/sku` |
|
||
| 物流公司 | `/openapi/logisticsCompany/list` | `/commondata/common/data/logistics-company` |
|
||
| 客户分类 | `/organization-aggregation/organizations/customer-category` | `/organization-aggregation/organizations/customer-categories` |
|
||
| 收货地址 | `/organization-aggregation/organizations/{id}/addresses` | `/organization-aggregation/organizations/{orgId}/delivery-addresses` |
|
||
|
||
### 2. 订单接口关键参数修正
|
||
|
||
- **`loadItem` 参数错误** → 正确参数名是 **`withDetails: true`**
|
||
- `withDetails: true` 时返回 `orderDetails` 数组（含 `productSku`、`purchaseNumbers` 等）
|
||
- 不加此参数或值为 false 则 `orderDetails` 为 null
|
||
- **`orderStatus` 作为查询参数会返回500错误** → 正确做法：先查全量，在返回结果中用 `orderStatus` 字段本地过滤
|
||
|
||
### 3. 订单审核接口修正
|
||
|
||
- **错误路径**: `PUT /order-aggregation/organizations/orders/check`
|
||
- **正确路径**: `PUT /order-aggregation/organizations/orders/order-audit`
|
||
- **Body 格式**: `{"ids": [订单ID]}`
|
||
- **注意**: 先款后货结算模式的订单审核会返回525错误，无法自动审核
|
||
|
||
### 4. Skills 文件分散化
|
||
|
||
原集中式 SKILL.md 已拆分为7个模块文件：
|
||
- `SKILL.md` — 索引总览
|
||
- `common.md` — 认证与调用方式
|
||
- `basics.md` — 仓库/员工/单位/分类/品牌/区域/物流/价格等级
|
||
- `customer.md` — 客户查询（分类/列表/收货地址）
|
||
- `product.md` — 商品查询（列表/授权方案/skuId增量）
|
||
- `order.md` — 订单查询（含withDetails说明）
|
||
- `inventory.md` — 库存查询（warehouseId必填，availableAmount为关键字段）
|
||
|
||
### 5. 定时任务修正
|
||
|
||
订单自动审核 cron 任务（ID: 6df58939-4fd0-4b7f-a55e-d2f7e8555fbc）已更新：
|
||
- 审核接口改为 `/order-aggregation/organizations/orders/order-audit`
|
||
- 加入了本地过滤 AUDIT_PENDING 订单的逻辑
|
||
- 注意事项加入了"先款后货"订单无法审核的说明
|
||
|
||
### 6. Feishu 多账号配置确认
|
||
|
||
- **产品助手**: `feishu_app_b` → `cli_a94fdbf0b978dcbd` → open_id `ou_ac5d6d23827df6ae9d63805be47b05eb`
|
||
- **股票助手**: `feishu_app_a` → `cli_a94e4684afb85cc4` → open_id `ou_7542c494dce7c3cced3b2f116e5dc0d6`
|
||
- 订单审核 cron 投递目标: `feishu:dm:ou_ac5d6d23827df6ae9d63805be47b05eb`（产品助手）
|
||
|
||
### 7. 用户反馈
|
||
|
||
- 用户明确要求：回复中不显示任何 Agent 元数据（Runtime/channel/capabilities/session 等）
|
||
- 已记录到 MEMORY.md 和 USER.md
|
||
|
||
## OpenClaw 版本升级
|
||
|
||
- dingtalk-connector 0.8.7 要求 OpenClaw >= 2026.3.23
|
||
- 升级前版本: 2026.3.11 → 升级后: 2026.3.24
|
||
|
||
## 用户反复强调：回复不得包含 Agent 元数据
|
||
|
||
用户多次（至少3次）明确要求：回复中不得包含任何 Agent 运行时元数据，包括但不限于：
|
||
- Runtime、channel、capabilities、model、session 等信息
|
||
- 底部附带的技术性信息
|
||
- 任何系统级调试内容
|
||
|
||
**这是最高优先级要求**，必须在每次回复时严格遵守。已记录到 MEMORY.md 和 USER.md，但仍出现违规，需进一步强化意识。
|
||
|
||
## self-improving-agent 安装
|
||
|
||
- 使用 `clawhub install xiucheng-self-improving-agent --dir ~/.openclaw/skills` 安装
|
||
- 评分最高的 self-improving 技能，已生效
|