diff --git a/.github/agents/文档.agent.md b/.github/agents/文档.agent.md index 7ca1a5e..6f37e86 100644 --- a/.github/agents/文档.agent.md +++ b/.github/agents/文档.agent.md @@ -63,6 +63,7 @@ node .\script\tmp-struct-system-params.cjs ## 推荐工作流 1. 先定位代码真实实现与调用链 +2. 在temp/apiDoc/目录下先备份对应的时间的json文档方便后续对比和回档,自动归档人工回档都在这个目录下进行 2. 如 system 入参结构变化,可先执行 `node .\script\tmp-struct-system-params.cjs` 3. 按 `docs/api-doc-update-workflow.md` 生成固定 spec JSON 4. 先执行 `npm run doc:api:update -- --spec= --dry-run` diff --git a/.github/agents/调度.agent.md b/.github/agents/调度.agent.md index c669667..82a1f3c 100644 --- a/.github/agents/调度.agent.md +++ b/.github/agents/调度.agent.md @@ -3,7 +3,7 @@ name: wms-dispatcher-agent description: "Use when the user asks about 任务委派、任务分派、调度、router、triage、多领域排障、不确定该找哪个 agent,或需要把问题分给 数据库/Redis/发布/开发/测试/文档 等模块。专用于 WMS 任务分诊与委派。" argument-hint: "描述你的目标或问题,例如:帮我判断这是数据库、测试还是缓存问题并分派、这个线上异常该交给谁处理。" tools: ['read', 'search', 'agent', 'todo'] -model: GPT-5.4 mini (copilot) +model: Claude Opus 4.6 (copilot) --- # WMS 调度代理(`wms-dispatcher-agent`) diff --git a/app.js b/app.js index 2a567d4..94f2416 100644 --- a/app.js +++ b/app.js @@ -1,7 +1,7 @@ // app.js const path = require('path'); const LocalFileWriter = require('./app/lib/file_writer'); -const ensureOrderDeliverySelfCheck = require('./app/lib/order_delivery_selfcheck'); +const QimenClient = require('./app/lib/qimen_client'); /** * 挂载应用级扩展能力。 @@ -13,8 +13,10 @@ module.exports = app => { global.APP_ROOT = path.resolve(__dirname, './'); app.appRoot = global.APP_ROOT; app.fileWriter = new LocalFileWriter(app); + app.qimenClient = new QimenClient(app); app.logger.info('✅ Application 扩展能力已加载'); app.logger.info('✅ fileWriter 已挂载到 app.fileWriter'); + app.logger.info('✅ qimenClient 已挂载到 app.qimenClient'); // 初始化工厂 app.beforeStart(async () => { const OrderDeliveryFactory = require('./app/model/order_delivery_factory'); @@ -32,7 +34,6 @@ module.exports = app => { app.OrderItemsFactory = OrderItemsFactory(app); app.model.OrderItemsFactory = app.OrderItemsFactory; app.logger.info('✅ 工厂类初始化完成'); - // await ensureOrderDeliverySelfCheck(app); } catch (error) { app.logger.error('❌ 工厂类初始化失败:', error); } diff --git a/app/controller/docs.js b/app/controller/docs.js index b0a247d..3958a9e 100644 --- a/app/controller/docs.js +++ b/app/controller/docs.js @@ -443,6 +443,28 @@ function normalizeGroups(docData) { return []; } +/** + * 解析文档对应的统一入口路径,优先使用文档内声明的 http.path。 + * @param {object} docData 文档 JSON 数据。 + * @return {string} 统一入口路径。 + */ +function resolveDocEntryPath(docData) { + const httpPath = String(docData?.http?.path || '').trim(); + if (httpPath.startsWith('/')) { + return httpPath; + } + + if (docData?.module === 'qimen') { + return '/qimen'; + } + + if (docData?.module === 'gateway') { + return '/internal/v1/gateway'; + } + + return '/system'; +} + /** * 渲染键值表格。 * @param {Array} items 数据项列表。 @@ -512,9 +534,14 @@ function renderMethodCard(item, entryPath, moduleName) { const methodName = item.method || item.name || 'unknown'; const description = item.description || ''; const isQimen = moduleName === 'qimen'; + const isOpenapi = moduleName === 'openapi'; const queryHint = isQimen ? 'app_key=xxx&method=...&v=2.0&format=json&sign_method=md5&sign=xxx×tamp=1700000000' - : `method=${methodName}&v=1.0×tamp=1700000000`; + : isOpenapi + ? `app_key=&method=${methodName}&v=1.0×tamp=1700000000` + : `method=${methodName}&v=1.0×tamp=1700000000`; + const queryLabel = isOpenapi ? 'Query 参数(自动生成)' : 'Query 参数'; + const queryReadonlyAttr = isOpenapi ? ' readonly data-auto-generated="true" aria-label="自动生成"' : ''; return `
@@ -584,8 +611,13 @@ function renderMethodCard(item, entryPath, moduleName) {
在线调试
- - + + + + ${isOpenapi ? ` + + + ` : ''} @@ -1043,8 +1075,11 @@ function renderHtmlPage({