# 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 技能，已生效