KAM 千路文档标准

千路=询价管理+出入库/WMS(开发中)。本包权威=询价侧 Excel 表头/文件名(REFERENCE §1–10)、报价对比§12；问价单导出与报价单导入列对齐（含 MOQ/MPQ，无「状态」列）。术语/流程=naming+process。触发：表头命名、单据核验、报价对比矩阵、两子系统边界、filebrowser、采购单回传作用。

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install kam-qianlu-doc-standards

kam-qianlu-doc-standards（精简版，详表见 REFERENCE）

版本 version：与仓库 Git 带 v 前缀的语义化 tag 对齐（当前 v6.1.2）。打新 tag 时请同步更新本文件 frontmatter 中的 version，避免 skill 与线上/发布口径漂移。

1. 产品边界（必答清）

询价管理系统：询价/报价/回询/订货/采购/报价对比/可订等 — 本 SKILL + 同目录 REFERENCE.md 管表头与文件名。
出入库管理系统（WMS）：开发中；实收核销、库内表头 不在此包权威范围，答用户时单列说明。
易混：「订货单入库完整版」= 询价侧导出给仓库用的 Excel，≠ WMS 产品本体。

2. 同目录文档（勿在对话里复述长表）

文件	内容
REFERENCE.md	§1–10 各单据表头/别名/文件名；§11 术语索引；§12 报价对比（基准单/品牌矩阵，仅有效报价单）
naming-and-terminology.md	术语、UI 用词
process-and-rules.md	流程、校验（订货↔回询匹配等）；与 `apps/inquiry-server/docs/functions/process-and-rules.md` 宜对照维护

3. 行为约定

查标准：按用户单据类型打开 REFERENCE 对应节，摘要要点即可；完整列名/别名以 REFERENCE 为准。
核验 Excel：确认类型 → 先问是否核验表头与建议文件名 → 用 openpyxl 找表头行（含「品牌」或 brand 的首行，否则第 1 行）→ 对照 REFERENCE 别名 → 输出映射 + §1 文件名规则。
术语/流程：REFERENCE §11 → 打开 naming 或 process。
上传：若有 filebrowser-api / kam-filebrowser-operator 可代传；本 skill 只做表头/命名。

4. 单据类型 → REFERENCE 节号（速查）

二询价导入 · 三报价导入 · 四问价导出（§4：第 1 行说明合并整行；表头 9 列 — 品牌、零件号、替换号、中文名称、数量、报价含税、MOQ、MPQ、备注；与 §3 报价单可识别列一致，不含「状态」）· 五回询导出（§5：英文表头 8 列 — BRAND、PARTS、QTY、PRICE、MOQ、MPQ、Replace No、价差比例）· 六订货导入 · 七订货导出（§7.1 校对版 9 列 / §7.2 入库版 11 列）· 八采购导出 · 九采购单回传导入 · 十可订导入 · 十二报价对比

问价单（实现一句）：常量 QUOTE_REQUEST_HEADERS / build_quote_request_excel 见 apps/inquiry-server/server/services/rfq_quote_group_service.py；规范 §5.8 见 apps/inquiry-server/docs/requirements-0309-1122.md。

采购单回传（业务一句）：我方导出采购单 → 供应商填无效/替换号/备注 → 文件 校对-采购单-*.xlsx 再导入 → 按品牌+零件号更新订货行，与线下一致。

5. 与 `apps/inquiry-*` 实现锚点（写代码/对需求时优先查）

以下为 AI-CRM 询价子系统 中与「单据格式、导入导出、校对」最直接相关的路径；表头别名仍以 REFERENCE + 后端 ORDER_HEADER_ALIASES 为准，勿仅凭记忆改列名。

5.1 后端 `apps/inquiry-server`

主题	位置
问价单 Excel 导出（组 / ZIP）	`server/services/rfq_quote_group_service.py` → `QUOTE_REQUEST_HEADERS`、`INSTRUCTION_ROW`、`build_quote_request_excel`、`build_batch_export_zip`；路由 `server/routers/rfq.py`（`/groups/{id}/export`、`batch-export`）
订货单 Excel 列检测与别名	`server/services/order_import_service.py` → `ORDER_HEADER_ALIASES`、`detect_order_columns`
订货导入/校对版导出/订单校对 API 数据	同上 → `import_order_excel`、`export_order_excel`、`get_order_verify`、`parse_order_feedback_excel` 等
订货单列表（含「采购关联」统计）	`server/routers/order.py` → `list_orders`（`matched_items` = 订货明细与 `confirmed_purchase` 命中行数）
采购汇总、确认入库、已确认采购、导出	`server/routers/purchase.py`；业务实现多在 `server/services/purchase_summary_service.py`、`purchase_feedback_service.py`
待订单校对（推导、与订货基准比对）	`server/services/confirmed_feedback_derive.py`
报价对比导出	`server/services/compare_service.py`（矩阵/基准与 REFERENCE §12 一致）
可订库 / 替换号	`server/services/availability_service.py` 等
补充需求与历史说明	`apps/inquiry-server/docs/`、`docs/requirements-*.md`（仓库根目录）

5.2 前端 `apps/inquiry-web`

主题	位置
询价单操作总页（Tab：回询/订货匹配/采购单生成等）	`src/pages/RfqOperatePage.tsx`
问价单组、生成/打包下载	`src/pages/RfqOperate/AskTab.tsx`；API `src/api/rfq.ts`（`exportQuoteRequest`、`exportQuoteRequestBatch`）
订货单列表与切换	`src/pages/RfqOperate/OrderListSection.tsx`
订货单匹配 / 校对表格	`src/pages/RfqOperate/OrderVerifySection.tsx`、`OrderFeedbackPanel.tsx`
采购单生成工作台与已确认采购	`src/pages/RfqOperate/PurchaseConfirmSection.tsx`
API 类型与请求	`src/api/order.ts`、`src/api/purchase.ts`
采购工作台本地草稿	`src/utils/workbenchStorage.ts`

5.3 仓库级说明

工作区约定与 MySQL 本地配置摘要：仓库根目录 CLAUDE.md（与 skill 互补：skill 管单据标准，CLAUDE 管怎么跑项目）。

6. ClawHub / 嵌入

正文刻意缩短以防 8192 token 上限；任何「完整表头表」必须从 REFERENCE.md 读取，不要凭记忆编造列名。