diffcat-cli 0.2.1 → 0.3.0

package/dist/types.d.ts

@@ -35,3 +35,21 @@ export interface OperationResponse {
     result?: unknown;
     [key: string]: unknown;
 }
+export interface AgentGrantSubject {
+    id: string;
+    displayName: string;
+    userKind: string;
+    departmentId: string | null;
+    roleId: string | null;
+}
+export interface CurrentAgentGrant {
+    id: string;
+    clientId: string;
+    deviceName: string;
+    capabilities: string[];
+    constraints: Record<string, unknown>;
+    expiresAt: string;
+    lastUsedAt: string | null;
+    createdAt: string;
+    subject: AgentGrantSubject;
+}

package/knowledge/catalog.json

@@ -0,0 +1,542 @@
+{
+  "schemaVersion": 1,
+  "knowledgeVersion": "0.3.0",
+  "updatedAt": "2026-09-09",
+  "categories": [
+    { "id": "overview", "title": "开始使用", "description": "系统定位、菜单入口和知识使用方式。" },
+    { "id": "modules", "title": "业务模块", "description": "各业务模块的用途、入口和协作关系。" },
+    { "id": "documents", "title": "单据与流程", "description": "单据用途、办理节点、状态和业务影响。" },
+    { "id": "guides", "title": "操作指引", "description": "登录、查询、草稿、待办和恢复操作。" },
+    { "id": "troubleshooting", "title": "疑难诊断", "description": "按实时状态和用户身份判断处理路径。" }
+  ],
+  "topics": [
+    {
+      "id": "overview.system",
+      "title": "DiffCat 系统概览",
+      "summary": "了解系统覆盖的业务领域、资料、单据、流程和跨模块影响。",
+      "category": "overview",
+      "relatedTopicIds": ["overview.navigation", "guide.login-and-authorization"],
+      "keywords": ["系统介绍", "功能介绍", "能做什么", "业务全景"],
+      "aliases": ["diffcat overview", "system introduction", "features"],
+      "path": "topics/overview/system.md",
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "overview.navigation",
+      "title": "菜单与功能导航",
+      "summary": "按九个菜单分组查找当前 54 个员工端页面及嘉宾门户入口。",
+      "category": "overview",
+      "relatedTopicIds": ["overview.system", "troubleshooting.permission-and-not-found"],
+      "keywords": ["菜单", "页面", "入口", "在哪里", "54个页面"],
+      "aliases": ["menu navigation", "page entry", "where is"],
+      "path": "topics/overview/navigation.md",
+      "menuCodes": ["workbench:home", "workbench:data-center"],
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "module.organization",
+      "title": "组织与权限模块",
+      "summary": "用户、部门、角色、公司、菜单授权和个人账号的使用说明。",
+      "category": "modules",
+      "relatedTopicIds": ["module.operations", "overview.navigation", "guide.login-and-authorization"],
+      "keywords": ["组织", "用户", "部门", "角色", "公司", "权限"],
+      "aliases": ["organization", "users", "departments", "roles", "companies", "permissions"],
+      "path": "topics/modules/organization.md",
+      "menuCodes": ["org:users", "org:depts", "org:roles", "org:comps"],
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "module.operations",
+      "title": "运维与系统配置模块",
+      "summary": "菜单、字典、流程模板、币种汇率、单位、编码和审计配置说明。",
+      "category": "modules",
+      "relatedTopicIds": ["module.organization", "guide.recovery"],
+      "keywords": ["运维", "字典", "审计", "流程模板", "编码规则", "汇率"],
+      "aliases": ["operations", "administration console", "dictionary", "audit", "flow templates"],
+      "path": "topics/modules/operations.md",
+      "menuCodes": ["ops:menus", "ops:audits", "ops:events", "ops:dict", "ops:flow-temps", "ops:currencies", "ops:ex-rates", "ops:uoms", "ops:ec-rules", "ops:fee-sbjs"],
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "module.sales",
+      "title": "销售与品牌模块",
+      "summary": "客户、门店、合同、商品、价目和三类销售单据的协作方式。",
+      "category": "modules",
+      "relatedTopicIds": ["document.sales-order", "document.direct-order", "document.consignment-reconciliation", "module.finance"],
+      "keywords": ["品牌", "销售", "客户", "门店", "合同", "商品", "价目"],
+      "aliases": ["sales", "brand", "customer", "store", "contract", "product", "price list"],
+      "path": "topics/modules/sales.md",
+      "menuCodes": ["sales:custs", "sales:stores", "sales:contract", "sales:prods", "sales:prices", "sales:orders", "sales:direct-orders", "sales:con-rec"],
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "module.inventory",
+      "title": "制造与库存模块",
+      "summary": "仓库、供应商、物料、库存流水和采购、出入库、盘存的使用说明。",
+      "category": "modules",
+      "relatedTopicIds": ["document.purchase-request", "document.inbound-order", "document.outbound-order", "document.stocktake-order"],
+      "keywords": ["制造", "库存", "仓库", "供应商", "物料", "采购", "入库", "出库", "盘存"],
+      "aliases": ["inventory", "manufacturing", "warehouse", "supplier", "material", "purchase", "inbound", "outbound", "stocktake"],
+      "path": "topics/modules/inventory.md",
+      "menuCodes": ["inv:warehouses", "inv:suppliers", "inv:materials", "inv:material-invs", "inv:records", "inv:purchases", "inv:inbounds", "inv:outbounds", "inv:stocktakes"],
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "module.administration",
+      "title": "行政模块",
+      "summary": "行政用品、用品库存、固定支出、费用和请假业务说明。",
+      "category": "modules",
+      "relatedTopicIds": ["document.supply-entry-order", "document.supply-issue-request", "document.supply-purchase-request", "document.supply-stocktake-order", "document.leave-request", "document.expense-request"],
+      "keywords": ["行政", "用品", "固定支出", "请假", "费用"],
+      "aliases": ["administration", "office supplies", "fixed expense", "leave request"],
+      "path": "topics/modules/administration.md",
+      "menuCodes": ["adm:sup", "adm:sup-purchases", "adm:sup-issues", "adm:sup-stocktakes", "adm:sup-entries", "adm:expenses", "adm:expense-plans", "adm:leaves"],
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "module.finance",
+      "title": "财务模块",
+      "summary": "应收、收款、应付、付款、银行、开票、退款和费用的业务关系。",
+      "category": "modules",
+      "relatedTopicIds": ["document.expense-request", "document.invoice-request", "document.refund-request", "module.sales"],
+      "keywords": ["财务", "应收", "收款", "应付", "付款", "银行", "开票", "退款"],
+      "aliases": ["finance", "receivable", "receipt", "payable", "payment", "invoice", "refund"],
+      "path": "topics/modules/finance.md",
+      "menuCodes": ["fin:receivables", "fin:receipts", "fin:invoices", "fin:payables", "fin:payments", "fin:bank-accounts", "fin:bank-trans", "fin:credit-records", "fin:refund-requests"],
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "module.project",
+      "title": "项目模块使用说明",
+      "summary": "项目档案、预算条目、预算申请、项目计划和项目核算的使用路径。",
+      "category": "modules",
+      "relatedTopicIds": ["module.inventory", "module.finance", "guide.master-data-and-query"],
+      "keywords": ["项目模块怎么用", "项目档案", "预算", "计划", "核算"],
+      "aliases": ["project module", "project management", "project budget", "project plan", "project accounting"],
+      "path": "topics/modules/project.md",
+      "resourceNames": ["pm.projects"],
+      "menuCodes": ["proj:projects"],
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "module.crowdfunding",
+      "title": "众筹项目与履约模块",
+      "summary": "众筹平台、项目、订单导入、准备发货、履约单和发货记录说明。",
+      "category": "modules",
+      "relatedTopicIds": ["document.crowdfunding-order", "module.inventory", "module.finance"],
+      "keywords": ["众筹", "平台", "导入", "履约", "发货"],
+      "aliases": ["crowdfunding", "campaign", "fulfillment", "shipment"],
+      "path": "topics/modules/crowdfunding.md",
+      "menuCodes": ["crowdfunding:platforms", "crowdfunding:projects", "crowdfunding:shipments"],
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "module.partner",
+      "title": "合作商门户",
+      "summary": "嘉宾用户查看订单、资金和专属仓库库存的范围与限制。",
+      "category": "modules",
+      "relatedTopicIds": ["module.sales", "document.sales-order", "guide.login-and-authorization"],
+      "keywords": ["合作商", "嘉宾", "门户", "资金", "专属仓库"],
+      "aliases": ["partner portal", "guest user", "partner order", "partner inventory"],
+      "path": "topics/modules/partner.md",
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "document.sales-order",
+      "title": "销售订单办理流程",
+      "summary": "销售订单从创建、报价、接单、发货、财务处理到确认收货的办理说明。",
+      "category": "documents",
+      "relatedTopicIds": ["module.sales", "module.inventory", "module.finance", "troubleshooting.document-correction"],
+      "keywords": ["销售订单流程", "报价", "接单", "待发货", "财务处理", "确认收货"],
+      "aliases": ["sales order workflow", "sales order process", "sales.orders"],
+      "path": "topics/documents/sales-order.md",
+      "resourceNames": ["sales.orders"],
+      "menuCodes": ["sales:orders"],
+      "flowCode": "SALES_ORDER",
+      "updatedAt": "2026-09-09",
+      "nodeResponsibilities": {
+        "START": "启动销售订单流程。",
+        "CREATOR_TYPE": "根据创建人类型判断是否需要先报价。",
+        "QUOTE": "为嘉宾创建的订单确认商品价格、数量和结算信息。",
+        "ACCEPT": "复核并接单，准备额度或预存资金并创建销售出库。",
+        "WAIT_OUTBOUND": "等待全部有效销售出库完成并汇总实际发货。",
+        "FINANCE_PROCESS": "核对收款方式并完成销售订单财务处理。",
+        "CONFIRM_RECEIPT": "确认客户已收货并结束履约。",
+        "END": "完成销售订单流程。"
+      }
+    },
+    {
+      "id": "document.direct-order",
+      "title": "直销订单办理流程",
+      "summary": "直销订单初审、接单、发货和确认收货流程。",
+      "category": "documents",
+      "relatedTopicIds": ["module.sales", "module.inventory", "troubleshooting.document-correction"],
+      "keywords": ["直销订单", "初审", "接单", "发货"],
+      "aliases": ["direct sales order", "sales.direct_orders"],
+      "path": "topics/documents/direct-order.md",
+      "resourceNames": ["sales.direct_orders"],
+      "menuCodes": ["sales:direct-orders"],
+      "flowCode": "SALES_DIRECT_ORDER",
+      "updatedAt": "2026-09-09",
+      "nodeResponsibilities": {
+        "INITIAL_AUDIT": "核对直销订单来源、客户、商品、数量和价格。",
+        "ACCEPT": "确认接单并创建后续出库安排。",
+        "WAIT_OUTBOUND": "等待关联出库全部完成。",
+        "CONFIRM_RECEIPT": "确认收货并完成直销订单。"
+      }
+    },
+    {
+      "id": "document.consignment-reconciliation",
+      "title": "代销对账单办理流程",
+      "summary": "代销对账单业务审核、财务办理和收款核销说明。",
+      "category": "documents",
+      "relatedTopicIds": ["module.sales", "module.finance", "troubleshooting.document-correction"],
+      "keywords": ["代销", "对账单", "核销", "财务办理"],
+      "aliases": ["consignment reconciliation", "sales.consignment_reconciliations"],
+      "path": "topics/documents/consignment-reconciliation.md",
+      "resourceNames": ["sales.consignment_reconciliations"],
+      "menuCodes": ["sales:con-rec"],
+      "flowCode": "SALES_CONSIGNMENT_RECONCILIATION",
+      "updatedAt": "2026-09-09",
+      "nodeResponsibilities": {
+        "BUSINESS_APPROVAL": "复核门店对账范围、销售数据和应收金额。",
+        "FINANCE_HANDLE": "核对入账流水，办理收款并完成门店库存核销。"
+      }
+    },
+    {
+      "id": "document.crowdfunding-order",
+      "title": "众筹履约订单办理流程",
+      "summary": "众筹履约订单市场审核、发货等待和确认收货流程。",
+      "category": "documents",
+      "relatedTopicIds": ["module.crowdfunding", "module.inventory", "troubleshooting.document-correction"],
+      "keywords": ["众筹履约订单", "市场审核", "来源冲突", "准备发货"],
+      "aliases": ["crowdfunding fulfillment order", "sales.crowdfunding_orders"],
+      "path": "topics/documents/crowdfunding-order.md",
+      "resourceNames": ["sales.crowdfunding_orders"],
+      "menuCodes": ["crowdfunding:projects"],
+      "flowCode": "CROWDFUNDING_ORDER_FLOW_V2",
+      "updatedAt": "2026-09-09",
+      "nodeResponsibilities": {
+        "MARKET_APPROVAL": "复核来源冲突、单仓和数量，创建唯一销售出库。",
+        "WAIT_OUTBOUND": "等待关联出库完成并回写实际发货数量。",
+        "CONFIRM_RECEIPT": "确认收货并完成众筹履约订单。"
+      }
+    },
+    {
+      "id": "document.purchase-request",
+      "title": "采购申请办理流程",
+      "summary": "采购申请从部门审核、总经理审核、财务办理到等待入库的流程。",
+      "category": "documents",
+      "relatedTopicIds": ["module.inventory", "module.finance", "document.inbound-order", "troubleshooting.document-correction"],
+      "keywords": ["采购申请", "部门审核", "总经理审核", "财务办理", "等待入库"],
+      "aliases": ["purchase request workflow", "inv.purchase_requests"],
+      "path": "topics/documents/purchase-request.md",
+      "resourceNames": ["inv.purchase_requests"],
+      "menuCodes": ["inv:purchases"],
+      "flowCode": "PURCHASE_REQUEST",
+      "updatedAt": "2026-09-09",
+      "nodeResponsibilities": {
+        "DEPT_APPROVAL": "由归属部门核对采购必要性、物料和数量。",
+        "GENERAL_MANAGER_APPROVAL": "对采购安排和预算作管理审批。",
+        "FINANCE_PROCESS": "准备应付或付款安排。",
+        "WAIT_INBOUND": "等待关联采购入库完成并汇总差异。"
+      }
+    },
+    {
+      "id": "document.inbound-order",
+      "title": "入库单办理流程",
+      "summary": "不同入库类型的部门审核、明细核实、IQC 和完成入库说明。",
+      "category": "documents",
+      "relatedTopicIds": ["module.inventory", "document.purchase-request", "troubleshooting.workflow-stuck"],
+      "keywords": ["入库单", "采购入库", "生产入库", "调拨入库", "IQC", "核实明细"],
+      "aliases": ["inbound order workflow", "goods receipt", "inv.inbound_orders"],
+      "path": "topics/documents/inbound-order.md",
+      "resourceNames": ["inv.inbound_orders"],
+      "menuCodes": ["inv:inbounds"],
+      "flowCode": "INBOUND_ORDER",
+      "updatedAt": "2026-09-09",
+      "nodeResponsibilities": {
+        "INBOUND_TYPE": "按入库类型和仓库选择审核路径。",
+        "PRODUCTION_WAREHOUSE": "判断生产入库是否进入生产仓路径。",
+        "MARKET_DEPT_APPROVAL": "审核市场相关入库。",
+        "PRODUCTION_DEPT_APPROVAL": "审核生产入库。",
+        "PURCHASE_DEPT_APPROVAL": "审核采购入库。",
+        "TRANSFER_RETURN_DEPT_APPROVAL": "审核调拨或退货入库。",
+        "OTHER_DEPT_APPROVAL": "审核其他入库。",
+        "VERIFY_LINES": "核实实际入库明细和来源差异。",
+        "OTHER_VERIFY_LINES": "核实其他类型入库明细。",
+        "IQC_INSPECTION": "完成生产入库的质量检验。",
+        "COMPLETE_INBOUND": "写入库存、批次和库存流水并完成入库。"
+      }
+    },
+    {
+      "id": "document.outbound-order",
+      "title": "出库单办理流程",
+      "summary": "出库单仓库审核、备货冻结和发货扣减流程。",
+      "category": "documents",
+      "relatedTopicIds": ["module.inventory", "document.sales-order", "troubleshooting.workflow-stuck"],
+      "keywords": ["出库单", "仓库审核", "备货", "冻结库存", "发货"],
+      "aliases": ["outbound order workflow", "shipment", "inv.outbound_orders"],
+      "path": "topics/documents/outbound-order.md",
+      "resourceNames": ["inv.outbound_orders"],
+      "menuCodes": ["inv:outbounds"],
+      "flowCode": "OUTBOUND_ORDER",
+      "updatedAt": "2026-09-09",
+      "nodeResponsibilities": {
+        "WAREHOUSE_APPROVAL": "仓库核对出库类型、仓库和明细。",
+        "PREPARE_OUTBOUND": "按批次备货并冻结可用库存。",
+        "SHIP_OUTBOUND": "扣减冻结库存、记录库存流水并通知来源单据。"
+      }
+    },
+    {
+      "id": "document.stocktake-order",
+      "title": "盘存单办理流程",
+      "summary": "盘存审批、库存锁、盘盈盘亏执行和反冲边界。",
+      "category": "documents",
+      "relatedTopicIds": ["module.inventory", "troubleshooting.document-correction"],
+      "keywords": ["盘存单", "盘点", "盘盈", "盘亏", "库存锁"],
+      "aliases": ["stocktake order", "inventory count", "inv.stocktake_orders"],
+      "path": "topics/documents/stocktake-order.md",
+      "resourceNames": ["inv.stocktake_orders"],
+      "menuCodes": ["inv:stocktakes"],
+      "flowCode": "INV_STOCKTAKE_ORDER",
+      "updatedAt": "2026-09-09",
+      "nodeResponsibilities": {
+        "APPROVAL": "复核盘点明细，并在库存锁保护下执行盘盈、盘亏或平账。"
+      }
+    },
+    {
+      "id": "document.expense-request",
+      "title": "费用申请办理流程",
+      "summary": "费用申请部门审核、总经理审核和财务办理流程。",
+      "category": "documents",
+      "relatedTopicIds": ["module.administration", "module.finance", "troubleshooting.document-correction"],
+      "keywords": ["费用申请", "报销", "部门审核", "总经理审核", "财务办理"],
+      "aliases": ["expense request", "reimbursement", "fin.expense_requests"],
+      "path": "topics/documents/expense-request.md",
+      "resourceNames": ["fin.expense_requests"],
+      "menuCodes": ["adm:expenses"],
+      "flowCode": "FIN_EXPENSE_REQUEST",
+      "updatedAt": "2026-09-09",
+      "nodeResponsibilities": {
+        "DEPT_APPROVAL": "核对费用归属、事由、金额和附件。",
+        "GENERAL_MANAGER_APPROVAL": "对费用合理性和管理授权作审批。",
+        "FINANCE_HANDLE": "复核财务资料并生成应付账款。"
+      }
+    },
+    {
+      "id": "document.invoice-request",
+      "title": "开票申请办理流程",
+      "summary": "开票申请财务审核和开票办理流程。",
+      "category": "documents",
+      "relatedTopicIds": ["module.finance", "troubleshooting.document-correction"],
+      "keywords": ["开票申请", "发票", "财务审核", "开票办理"],
+      "aliases": ["invoice request", "fin.invoice_requests"],
+      "path": "topics/documents/invoice-request.md",
+      "resourceNames": ["fin.invoice_requests"],
+      "menuCodes": ["fin:invoices"],
+      "flowCode": "FIN_INVOICE_REQUEST",
+      "updatedAt": "2026-09-09",
+      "nodeResponsibilities": {
+        "FINANCE_APPROVAL": "核对购方、税号、金额和开票依据。",
+        "INVOICE_HANDLE": "登记实际开票信息并完成申请。"
+      }
+    },
+    {
+      "id": "document.refund-request",
+      "title": "退款申请办理流程",
+      "summary": "退款申请财务办理、付款完成和上游恢复说明。",
+      "category": "documents",
+      "relatedTopicIds": ["module.finance", "document.sales-order", "troubleshooting.document-correction"],
+      "keywords": ["退款申请", "退款", "财务办理", "付款", "撤销"],
+      "aliases": ["refund request", "fin.refund_requests"],
+      "path": "topics/documents/refund-request.md",
+      "resourceNames": ["fin.refund_requests"],
+      "menuCodes": ["fin:refund-requests"],
+      "flowCode": "FIN_REFUND_REQUEST",
+      "updatedAt": "2026-09-09",
+      "nodeResponsibilities": {
+        "FINANCE_HANDLE": "核对退款来源、收款记录、金额和收款账户。",
+        "COMPLETE": "生成应付和付款并完成退款，按来源恢复上游业务。"
+      }
+    },
+    {
+      "id": "document.supply-entry-order",
+      "title": "用品录入单办理流程",
+      "summary": "行政用品录入的部门审核、部门办理和库存增加说明。",
+      "category": "documents",
+      "relatedTopicIds": ["module.administration", "troubleshooting.document-correction"],
+      "keywords": ["用品录入单", "用品入库", "部门审核", "部门办理"],
+      "aliases": ["supply entry order", "adm.supply_entry_orders"],
+      "path": "topics/documents/supply-entry-order.md",
+      "resourceNames": ["adm.supply_entry_orders"],
+      "menuCodes": ["adm:sup-entries"],
+      "flowCode": "ADM_SUPPLY_ENTRY_ORDER",
+      "updatedAt": "2026-09-09",
+      "nodeResponsibilities": {
+        "DEPT_APPROVAL": "审核用品、数量、仓库和录入原因。",
+        "DEPT_HANDLE": "执行用品库存增加并完成录入。"
+      }
+    },
+    {
+      "id": "document.supply-issue-request",
+      "title": "用品领用申请办理流程",
+      "summary": "行政用品领用审核、发放和库存扣减说明。",
+      "category": "documents",
+      "relatedTopicIds": ["module.administration", "troubleshooting.document-correction"],
+      "keywords": ["用品领用", "领用申请", "用品发放", "资产"],
+      "aliases": ["supply issue request", "adm.supply_issue_requests"],
+      "path": "topics/documents/supply-issue-request.md",
+      "resourceNames": ["adm.supply_issue_requests"],
+      "menuCodes": ["adm:sup-issues"],
+      "flowCode": "ADM_SUPPLY_ISSUE_REQUEST",
+      "updatedAt": "2026-09-09",
+      "nodeResponsibilities": {
+        "DEPT_APPROVAL": "审核领用人、用品、数量和用途。",
+        "DEPT_HANDLE": "发放用品，扣减库存并按需形成资产记录。"
+      }
+    },
+    {
+      "id": "document.supply-purchase-request",
+      "title": "用品采购申请办理流程",
+      "summary": "行政用品采购审核、办理和费用关联说明。",
+      "category": "documents",
+      "relatedTopicIds": ["module.administration", "document.expense-request", "troubleshooting.document-correction"],
+      "keywords": ["用品采购", "采购申请", "费用申请", "项目计划"],
+      "aliases": ["supply purchase request", "adm.supply_purchase_requests"],
+      "path": "topics/documents/supply-purchase-request.md",
+      "resourceNames": ["adm.supply_purchase_requests"],
+      "menuCodes": ["adm:sup-purchases"],
+      "flowCode": "ADM_SUPPLY_PURCHASE_REQUEST",
+      "updatedAt": "2026-09-09",
+      "nodeResponsibilities": {
+        "DEPT_APPROVAL": "审核采购用品、数量、费用来源和项目计划。",
+        "DEPT_HANDLE": "完成采购办理并登记后续用品录入依据。"
+      }
+    },
+    {
+      "id": "document.supply-stocktake-order",
+      "title": "用品盘点单办理流程",
+      "summary": "行政用品盘点审核、办理和库存调整说明。",
+      "category": "documents",
+      "relatedTopicIds": ["module.administration", "troubleshooting.document-correction"],
+      "keywords": ["用品盘点", "用品库存", "盘盈", "盘亏"],
+      "aliases": ["supply stocktake order", "adm.supply_stocktake_orders"],
+      "path": "topics/documents/supply-stocktake-order.md",
+      "resourceNames": ["adm.supply_stocktake_orders"],
+      "menuCodes": ["adm:sup-stocktakes"],
+      "flowCode": "ADM_SUPPLY_STOCKTAKE_ORDER",
+      "updatedAt": "2026-09-09",
+      "nodeResponsibilities": {
+        "DEPT_APPROVAL": "审核盘点范围、账面数和实盘数。",
+        "DEPT_HANDLE": "执行用品库存调整并记录盘点结果。"
+      }
+    },
+    {
+      "id": "document.leave-request",
+      "title": "请假申请办理流程",
+      "summary": "请假申请的部门审批、主管审批和返岗办理说明。",
+      "category": "documents",
+      "relatedTopicIds": ["module.administration", "troubleshooting.document-correction"],
+      "keywords": ["请假申请", "部门审批", "主管审批", "返岗"],
+      "aliases": ["leave request", "absence request"],
+      "path": "topics/documents/leave-request.md",
+      "menuCodes": ["adm:leaves"],
+      "flowCode": "adm_leave_request.default",
+      "updatedAt": "2026-09-09",
+      "nodeResponsibilities": {
+        "DEPT_APPROVAL": "由申请人所属部门审核请假安排。",
+        "DIRECTOR_APPROVAL": "由主管复核请假安排和工作交接。",
+        "RETURN_HANDLE": "确认返岗并完成请假流程。"
+      }
+    },
+    {
+      "id": "guide.login-and-authorization",
+      "title": "登录与最小授权",
+      "summary": "连接 DiffCat、选择 profile、申请最小能力和处理授权失效。",
+      "category": "guides",
+      "relatedTopicIds": ["overview.system", "guide.recovery", "troubleshooting.permission-and-not-found"],
+      "keywords": ["登录", "授权", "profile", "能力", "权限失效"],
+      "aliases": ["login", "authentication", "authorization", "grant", "profile"],
+      "path": "topics/guides/login-and-authorization.md",
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "guide.master-data-and-query",
+      "title": "基础资料与业务查询",
+      "summary": "按名称解析资料、查询列表和详情，并正确处理分页与重名。",
+      "category": "guides",
+      "relatedTopicIds": ["guide.login-and-authorization", "guide.document-drafts", "troubleshooting.permission-and-not-found"],
+      "keywords": ["基础资料", "查询", "列表", "详情", "分页", "重名"],
+      "aliases": ["master data", "resource query", "list", "get", "pagination"],
+      "path": "topics/guides/master-data-and-query.md",
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "guide.document-drafts",
+      "title": "创建单据草稿",
+      "summary": "准备业务字段、解析基础资料并创建和回查单据草稿。",
+      "category": "guides",
+      "relatedTopicIds": ["guide.master-data-and-query", "guide.workflow-tasks", "guide.recovery"],
+      "keywords": ["创建草稿", "新建单据", "必填信息", "回查"],
+      "aliases": ["create draft", "document draft", "create document"],
+      "path": "topics/guides/document-drafts.md",
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "guide.workflow-tasks",
+      "title": "流程待办与审批",
+      "summary": "查看当前办理人的任务、理解节点职责并安全办理支持的审批。",
+      "category": "guides",
+      "relatedTopicIds": ["guide.document-drafts", "troubleshooting.workflow-stuck", "guide.recovery"],
+      "keywords": ["待办", "审批", "办理人", "流程任务", "抄送"],
+      "aliases": ["workflow task", "approval", "assignee", "pending task"],
+      "path": "topics/guides/workflow-tasks.md",
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "guide.recovery",
+      "title": "失败恢复与安全重试",
+      "summary": "处理中断、状态未知、网页确认、校验失败和授权撤销。",
+      "category": "guides",
+      "relatedTopicIds": ["guide.login-and-authorization", "guide.document-drafts", "guide.workflow-tasks"],
+      "keywords": ["失败", "恢复", "重试", "状态未知", "确认", "幂等"],
+      "aliases": ["recovery", "retry", "unknown status", "idempotency", "verification failed"],
+      "path": "topics/guides/recovery.md",
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "troubleshooting.document-correction",
+      "title": "单据填错后的处理判断",
+      "summary": "根据单号、单据状态、当前用户身份、流程权限和下游影响选择修正方案。",
+      "category": "troubleshooting",
+      "relatedTopicIds": ["guide.master-data-and-query", "guide.workflow-tasks", "guide.recovery", "document.sales-order"],
+      "keywords": ["订单填错了", "单据填错", "怎么改", "修改订单", "撤回", "重建", "取消"],
+      "aliases": ["wrong order", "correct document", "edit submitted order", "fix order"],
+      "path": "topics/troubleshooting/document-correction.md",
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "troubleshooting.permission-and-not-found",
+      "title": "没有权限或查不到数据",
+      "summary": "区分未登录、未授权、无菜单权限、对象范围限制和查询条件问题。",
+      "category": "troubleshooting",
+      "relatedTopicIds": ["guide.login-and-authorization", "guide.master-data-and-query", "overview.navigation"],
+      "keywords": ["没有权限", "查不到", "不存在", "无结果", "越权"],
+      "aliases": ["permission denied", "not found", "empty result", "missing capability"],
+      "path": "topics/troubleshooting/permission-and-not-found.md",
+      "updatedAt": "2026-09-09"
+    },
+    {
+      "id": "troubleshooting.workflow-stuck",
+      "title": "流程停滞与待办诊断",
+      "summary": "判断流程是否在人工节点、等待外部事件、办理人缺失或下游失败。",
+      "category": "troubleshooting",
+      "relatedTopicIds": ["guide.workflow-tasks", "guide.recovery", "document.inbound-order", "document.outbound-order"],
+      "keywords": ["流程卡住", "一直等待", "没有待办", "办理人", "发货未完成", "入库未完成"],
+      "aliases": ["workflow stuck", "missing task", "wait node", "no assignee"],
+      "path": "topics/troubleshooting/workflow-stuck.md",
+      "updatedAt": "2026-09-09"
+    }
+  ]
+}

package/knowledge/topics/documents/consignment-reconciliation.md

@@ -0,0 +1,7 @@
+# 代销对账单办理流程
+
+代销对账单用于把门店代销期间的销售结果汇总为可审核、可收款核销的业务依据。创建前应核对门店、对账期间、销售明细、退货或差异及应收金额。
+
+基线流程包含业务审核和财务办理。业务审核确认对账范围与销售数据；财务办理核对入账流水、生成或处理收款，并完成门店库存核销。实际配置使用 `knowledge flow SALES_CONSIGNMENT_RECONCILIATION` 查询。
+
+完成核销后发现错误时，应先检查收款和库存结果，再选择受控的撤销、冲正或重建路径。

package/knowledge/topics/documents/crowdfunding-order.md

@@ -0,0 +1,7 @@
+# 众筹履约订单办理流程
+
+众筹履约订单承接平台订单导入后的审核、出库与收货确认。办理前核对平台项目、外部订单唯一性、收货地址、商品映射、仓库和数量。
+
+基线流程为市场审核、等待出库和确认收货。市场审核需要处理来源冲突并确保唯一出库；等待节点汇总实际发货；确认收货结束履约。当前发布配置使用 `knowledge flow CROWDFUNDING_ORDER_FLOW_V2` 查询。
+
+已创建出库或已发货时，不得重复生成履约；应结合下游出库和发货记录诊断。

package/knowledge/topics/documents/direct-order.md

@@ -0,0 +1,7 @@
+# 直销订单办理流程
+
+直销订单用于较直接的销售履约。创建前核对客户、商品、价格、数量、收货信息和仓库安排。
+
+基线流程为初审、接单、等待出库、确认收货。初审关注订单来源与交易字段；接单确认可履约性并安排出库；等待节点依赖全部有效出库完成；确认收货结束订单。当前节点和办理人以 `knowledge flow SALES_DIRECT_ORDER` 返回的发布版本为准。
+
+若订单已生成出库或已经发货，修正必须连同库存和履约结果一起判断，不能仅改原订单字段。

package/knowledge/topics/documents/expense-request.md

@@ -0,0 +1,7 @@
+# 费用申请办理流程
+
+费用申请用于提交费用或报销事项，并在完成后形成财务应付。创建前准备申请人、归属部门、费用科目、事由、金额、项目或计划以及必要附件。
+
+基线流程为部门审核、总经理审核和财务办理。部门核对归属和凭据；总经理作管理审批；财务复核并生成应付账款。实际版本用 `knowledge flow FIN_EXPENSE_REQUEST` 查询。
+
+若应付已经生成，纠错要同时检查应付和后续付款；附件或金额问题不能只修改原申请而忽略财务结果。

package/knowledge/topics/documents/inbound-order.md

@@ -0,0 +1,7 @@
+# 入库单办理流程
+
+入库单记录采购、生产、调拨退货或其他来源的实际入库。创建前确认入库类型、来源单据、仓库、物料、批次和数量。
+
+流程会按入库类型和仓库选择部门审核路径，再核实实际明细；生产入库可能需要 IQC；完成节点才正式写入库存、批次和流水。当前分支与办理人以 `knowledge flow INBOUND_ORDER` 为准。
+
+流程停在等待或核实时，应检查来源单据、明细差异、质量检验和办理人。已完成入库后发现错误，需要评估库存反冲或后续调整，不能当作未提交草稿修改。

package/knowledge/topics/documents/invoice-request.md

@@ -0,0 +1,7 @@
+# 开票申请办理流程
+
+开票申请用于基于真实交易向购方开具发票。创建前核对购方名称、税号、地址电话、开户信息、开票内容、金额和业务依据。
+
+基线流程包含财务审核和开票办理。审核节点确认购方、金额和依据；办理节点登记实际发票信息并完成申请。当前配置使用 `knowledge flow FIN_INVOICE_REQUEST` 查询。
+
+已开票后发现错误时，应按发票和财务制度判断红冲、作废或重开，不能仅修改申请记录。

package/knowledge/topics/documents/leave-request.md

@@ -0,0 +1,7 @@
+# 请假申请办理流程
+
+请假申请记录员工的请假类型、起止时间、原因、工作交接和返岗情况。创建前应确认申请人部门、主管关系和时间是否冲突。
+
+基线流程包含部门审批、主管审批和返岗办理；具体节点可随组织和流程配置变化。使用 `knowledge flow adm_leave_request.default` 查询当前发布版本和办理人。
+
+提交后填错时，应先查看当前待办和是否允许撤回。已经审批或进入请假期间时，还需考虑排班、考勤及工作交接影响。

package/knowledge/topics/documents/outbound-order.md

@@ -0,0 +1,7 @@
+# 出库单办理流程
+
+出库单承接销售、调拨或其他领用来源，控制从审核到库存扣减的全过程。创建前确认出库类型、来源、仓库、物料或商品、批次和数量。
+
+基线流程为仓库审核、备货和发货。仓库审核核对来源及明细；备货按批次冻结可用库存；发货扣减冻结库存、记录流水并通知来源单据。当前配置使用 `knowledge flow OUTBOUND_ORDER` 查询。
+
+卡在备货时重点检查可用库存、批次和冻结；已发货后修正会影响库存和上游订单，必须走受控处理路径。