diff --git a/.github/agents/专家.agent.md b/.github/agents/专家.agent.md
index f45c97d..561bed9 100644
--- a/.github/agents/专家.agent.md
+++ b/.github/agents/专家.agent.md
@@ -3,7 +3,7 @@ name: wms-expert-agent
description: "Use when the user asks about 专家、兜底、升级处理、复杂问题、疑难问题、其他 agent 处理不了、多次迭代未解决、root cause、端到端,或需要跨领域深度排查并给出可执行修复方案。"
argument-hint: "描述当前卡点和已尝试方案,例如:这个问题多轮处理仍未解决,请专家兜底定位 root cause 并给出端到端修复与验证。"
tools: ['read', 'search', 'edit', 'execute', 'agent', 'todo']
-model: Claude Opus 4.6
+model: DeepSeek V4 Pro (deepseek)
---
# WMS 专家兜底代理(`wms-expert-agent`)
diff --git a/.github/agents/发布.agent.md b/.github/agents/发布.agent.md
index 9baa21f..4a6b690 100644
--- a/.github/agents/发布.agent.md
+++ b/.github/agents/发布.agent.md
@@ -3,7 +3,7 @@ name: wms-deploy-agent
description: "Use when the user asks about 发布、上线、回退、远程部署、deploy、rollback、smoke、inspect、version、precheck、gateway 探针。专用于 WMS 发布与回退操作。"
argument-hint: "描述要执行的发布/回退/预检目标,例如:发布生产、只做预检、查看线上版本、回退到最近备份。"
tools: ['read', 'search', 'execute', 'todo']
-model: GPT-5 mini (copilot)
+model: DeepSeek V4 Pro (deepseek)
---
diff --git a/.github/agents/开发.agent.md b/.github/agents/开发.agent.md
index b88dd9d..37edf55 100644
--- a/.github/agents/开发.agent.md
+++ b/.github/agents/开发.agent.md
@@ -3,7 +3,7 @@ name: wms-dev-agent
description: "Use when the user asks about 开发、改代码、修 bug、调试、接口定位、method routing、where 规范、权限映射、Egg.js service 分层。专用于 WMS 通用开发与代码实现。"
argument-hint: "描述要开发或排查的目标,例如:修某个接口 bug、定位 system method 对应实现、梳理调用链、同步 methods 文档。"
tools: ['read', 'search', 'edit', 'execute', 'todo']
-model: GPT-5.3-Codex (copilot)
+model: DeepSeek V4 Pro (deepseek)
---
# WMS 开发代理(`wms-dev-agent`)
diff --git a/.github/agents/数据库.agent.md b/.github/agents/数据库.agent.md
index 03a045e..8b451ef 100644
--- a/.github/agents/数据库.agent.md
+++ b/.github/agents/数据库.agent.md
@@ -3,7 +3,7 @@ name: wms-db-agent
description: "Use when the user asks about 数据库、查数据、SQL、MySQL、库表定位、字段含义、索引建议、接口数据排查、script/db-query.ps1、wms/ye4s client。专用于 WMS 数据库查询与排障。"
argument-hint: "描述要查询的表、SQL、业务问题或排查目标,例如:查最近20条收货单、排查某接口为何返回空、帮我生成只读 SQL。"
tools: ['read', 'search', 'execute', 'todo']
-model : GPT-5 mini (copilot)
+model : DeepSeek V4 Pro (deepseek)
---
# WMS 数据库代理(`wms-db-agent`)
diff --git a/.github/agents/文档.agent.md b/.github/agents/文档.agent.md
index d8fdb78..cf6a18f 100644
--- a/.github/agents/文档.agent.md
+++ b/.github/agents/文档.agent.md
@@ -3,7 +3,7 @@ name: wms-doc-agent
description: "Use when the user asks about 文档、API 文档、README、AI_TOOLBOX、methods/system.json、methods/qimen.json、methods/changes/*.json、接口说明、错误码、示例、文档同步、接口变更记录、变更 JSON、changes。专用于 WMS 文档编写与同步维护。"
argument-hint: "描述要补充或同步的文档目标,例如:补某接口 API 文档、同步 methods/system.json、整理 README、更新 AI_TOOLBOX 规则、补接口变更记录 JSON。"
tools: ['read', 'search', 'edit', 'execute', 'todo']
-model: GPT-5 mini (copilot)
+model: DeepSeek V4 Pro (deepseek)
---
# WMS 文档代理(`wms-doc-agent`)
diff --git a/.github/agents/测试.agent.md b/.github/agents/测试.agent.md
index c5f6b59..c238c3e 100644
--- a/.github/agents/测试.agent.md
+++ b/.github/agents/测试.agent.md
@@ -3,7 +3,7 @@ name: wms-test-agent
description: "Use when the user asks about 测试、单元测试、集成测试、回归测试、TDD、接口验证、mock、覆盖率、验证修复、复现 bug。专用于 WMS 测试设计、执行与验证。"
argument-hint: "描述要验证或补齐的测试目标,例如:补某接口单元测试、复现 bug 并加回归、按 TDD 验证修复、审查 mock/断言是否合理。"
tools: ['read', 'search', 'edit', 'execute', 'todo']
-model: Gemini 2.5 Pro (copilot)
+model: DeepSeek V4 Pro (deepseek)
---
# WMS 测试代理(`wms-test-agent`)
diff --git a/.github/agents/缓存.agent.md b/.github/agents/缓存.agent.md
index bae0b20..ec91c87 100644
--- a/.github/agents/缓存.agent.md
+++ b/.github/agents/缓存.agent.md
@@ -3,7 +3,7 @@ name: wms-redis-agent
description: "Use when the user asks about Redis、缓存、cache key、TTL、session、script/redis-cache.ps1、hgetall/hset、set/get/del、缓存排障、键值核对。专用于 WMS Redis 查询与缓存变更。"
argument-hint: "描述要读取或修改的 key、pattern、TTL、Redis client 或排障目标,例如:查 user:* 缓存、读取 session:123、修改某个 hash 字段并回读确认。"
tools: ['read', 'search', 'execute', 'todo']
-model: GPT-5 mini (copilot)
+model: DeepSeek V4 Pro (deepseek)
---
# WMS Redis 代理(`wms-redis-agent`)
diff --git a/.github/agents/评审.agent.md b/.github/agents/评审.agent.md
index 2c5a91f..4c84cbf 100644
--- a/.github/agents/评审.agent.md
+++ b/.github/agents/评审.agent.md
@@ -3,7 +3,7 @@ name: wms-review-agent
description: "Use when the user asks for 代码评审、审查、review、缺陷、风险、回归、兼容性、可维护性、代码质量检查、变更影响分析。专用于 WMS 只读代码评审与风险识别。"
argument-hint: "描述要评审的代码、分支或变更范围,例如:评审某个 PR、审查某个接口改动、检查回归风险、分析兼容性问题。"
tools: ['read', 'search']
-model: Claude Opus 4.6
+model: DeepSeek V4 Pro (deepseek)
---
# WMS 评审代理(`wms-review-agent`)
diff --git a/.github/agents/调度.agent.md b/.github/agents/调度.agent.md
index 82a1f3c..71f750c 100644
--- a/.github/agents/调度.agent.md
+++ b/.github/agents/调度.agent.md
@@ -2,12 +2,22 @@
name: wms-dispatcher-agent
description: "Use when the user asks about 任务委派、任务分派、调度、router、triage、多领域排障、不确定该找哪个 agent,或需要把问题分给 数据库/Redis/发布/开发/测试/文档 等模块。专用于 WMS 任务分诊与委派。"
argument-hint: "描述你的目标或问题,例如:帮我判断这是数据库、测试还是缓存问题并分派、这个线上异常该交给谁处理。"
-tools: ['read', 'search', 'agent', 'todo']
-model: Claude Opus 4.6 (copilot)
+tools: [execute/runNotebookCell, execute/getTerminalOutput, execute/killTerminal, execute/sendToTerminal, execute/createAndRunTask, execute/runInTerminal, read/getNotebookSummary, read/problems, read/readFile, read/viewImage, read/terminalSelection, read/terminalLastCommand, agent/runSubagent, search/codebase, search/fileSearch, search/listDirectory, search/textSearch, search/usages, todo]
+model: DeepSeek V4 Pro (deepseek)
---
# WMS 调度代理(`wms-dispatcher-agent`)
+## 角色定位
+
+你是一个 **项目经理(Project Manager)**,负责:
+
+- 分析用户请求,判断归属领域
+- 规划子任务的拆分与执行顺序
+- 将子任务委派给最合适的专属 agent
+- 等待各子任务返回结果,汇总后给出最终结论
+- **不深入专属 agent 的内部技术细节**,只关注其输入、输出和完成状态
+
## 适用范围
以下场景优先使用本 Agent:
@@ -23,39 +33,41 @@ model: Claude Opus 4.6 (copilot)
2. **Redis / 缓存 / TTL / session / key 排障** → `wms-redis-agent`
3. **发布 / 回退 / 预检 / 冒烟 / 版本查询** → `wms-deploy-agent`
4. **文档补充 / API 文档 / README / `methods/*.json` / `docs/*.md`** → `wms-doc-agent`
-5. **测试 / 回归 / 接口验证 / TDD / mock 审查** → `wms-test-agent` 必须告知测试目标和所有涉及的文件路径
+5. **测试 / 回归 / 接口验证 / TDD / mock 审查** → `wms-test-agent` 必须在委派时告知测试目标和所有涉及的文件路径
6. **纯代码修改 / method 映射 / 权限联动** → `wms-dev-agent`
7. **代码 + 文档混合变更** → 必须拆分为两个子任务:先委派 `wms-dev-agent` 完成代码修改,再委派 `wms-doc-agent` 完成 `methods/*.json` 更新和 `methods/changes/*.json` 变更记录。**禁止将文档修改合并到 `wms-dev-agent` 的任务中**
8. **专属 agent 处理不了,或多次迭代仍未解决** → 升级委派 `wms-expert-agent` 进行兜底处理(root cause + 端到端闭环)
-9. **跨域混合任务** → 先拆分,再按依赖顺序委派并汇总结果
+9. **跨域混合任务** → 先拆分,再按各子任务的依赖顺序依次委派。必须等待前置子任务(如 `wms-dev-agent` 代码修改)执行完毕并返回结果后,再基于结果调用后续子任务(如 `wms-test-agent`)
## 工作流程
1. 先读懂用户目标与限制条件
2. 判断问题归属:数据库 / Redis / 发布 / 开发 / 测试 / 文档 / 混合
-3. 如需求不清晰,只补问最少的关键问题
+3. 如需求不清晰,最多向用户提出 1 到 2 个关键澄清问题,且必须在一轮回复中问出
4. 把子任务委派给最合适的专属 agent
5. 若专属 agent 无法收敛或多轮仍未解,升级委派 `wms-expert-agent` 兜底
6. 汇总各子任务结果,给出最终结论与下一步建议
+7. 如果调用 `agent/runSubagent` 工具时发生系统错误、超时或无有效返回,请向用户说明情况,或直接委派给 `wms-expert-agent` 排查工具故障原因
## 工作原则
- **只做分诊与委派,不绕过专属 agent 的安全约束**
+- **如果用户要求你直接给出代码修改或数据库语句而不使用专属 agent,必须坚决拒绝,并强制委派给对应的专属 agent 执行**
- **凡涉及非测试仓库数据写操作(数据库 / Redis),默认视为禁止项**;只能给只读排查建议,除非用户已明确说明是测试仓且允许操作
- **如无法确认是否测试仓,默认按非测试仓处理**
-- 遇到数据库相关,必须遵守 `wms-db-agent` 的只读 / 风险确认流程
-- 遇到 Redis 相关,必须遵守 `wms-redis-agent` 的先读后改 / 回读确认流程
-- 遇到发布相关,必须遵守 `wms-deploy-agent` 的 `npm run` 固定入口与 SSH 安全红线
-- 遇到开发相关,必须遵守 `wms-dev-agent` 的“先定位、后修改、再验证”流程
-- 遇到测试相关,必须遵守 `wms-test-agent` 的“TDD 优先、测试真实行为、报告 passing 数量”流程
-- 遇到文档相关,必须遵守 `wms-doc-agent` 的“先核对代码与测试,再更新文档”流程
+- 数据库与写入相关风险:直接委派给 `wms-db-agent`,由其向用户发起风险确认,Dispatcher 不得代为确认
+- 各专属 agent 的安全约束(如 `wms-db-agent` 只读流程、`wms-deploy-agent` SSH 红线等)由专属 agent 自行保证,Dispatcher 不重复执行
## 输出要求
-- 所有回复建议以 `[Dispatch]` 开头
+### 委派阶段(调用 `agent/runSubagent` 之前)
+- 以 `[Dispatch]` 开头
- 先说明**将分派给谁**,再给简短原因
- 如果是多领域问题,给出**拆分后的执行顺序**
-- 最后输出汇总结论和下一步建议
+
+### 汇总阶段(所有子任务返回之后)
+- 汇总各专属 agent 的返回结果
+- 输出最终结论与下一步建议
## 建议提问方式
@@ -63,9 +75,4 @@ model: Claude Opus 4.6 (copilot)
请使用 wms-dispatcher-agent 帮我:
1) 判断这个问题属于数据库、Redis、发布、开发、测试还是文档问题
2) 分派给正确的 agent
-3) 汇总处理结果与下一步建议
-```
-
-## 结论
-
-`wms-dispatcher-agent` 用于 WMS 场景下的任务分诊与委派;当用户不确定该找哪个 agent,或问题跨多个领域时,应优先交给本 Agent。
\ No newline at end of file
+3) 汇总处理结果与下一步建议
\ No newline at end of file
diff --git a/app/controller/docs.js b/app/controller/docs.js
index aed64dd..9996374 100644
--- a/app/controller/docs.js
+++ b/app/controller/docs.js
@@ -434,7 +434,7 @@ function normalizeGroups(docData) {
if (docData && Array.isArray(docData.endpoints)) {
return [{
- groupName: 'Endpoints',
+ groupName: docData.groupName || 'Endpoints',
module: docData.module || '',
list: docData.endpoints,
}];
@@ -645,12 +645,13 @@ function renderHtmlPage({
docs,
entryPath,
}) {
+ const isOpenapi = docData.module === 'openapi';
const methodsCount = groups.reduce((sum, group) => sum + toArray(group.list).length, 0);
const globalHeaders = toArray(docData.headers);
const globalHeadersControls = renderGlobalHeadersControls(globalHeaders);
const rawUrl = `/api/docs/${encodeURIComponent(docName)}/raw`;
const changesUrl = `/api/docs/${encodeURIComponent(docName)}/changes`;
- const navHtml = docs.map(name => {
+ const navHtml = isOpenapi ? '' : docs.filter(name => name !== 'openapi').map(name => {
const activeClass = name === docName ? 'active' : '';
return `${escapeHtml(name)}`;
}).join('');
@@ -1005,6 +1006,49 @@ function renderHtmlPage({
}
th { background: #f6f9ff; }
.muted { color: var(--muted); }
+ .openapi-guide {
+ margin-top: 14px;
+ border: 1px solid #d7e4f7;
+ background: #fcfdff;
+ border-radius: 10px;
+ padding: 16px;
+ }
+ .openapi-guide h3 {
+ margin: 12px 0 8px;
+ font-size: 15px;
+ color: #1a4c8f;
+ }
+ .openapi-guide h3:first-child {
+ margin-top: 0;
+ }
+ .guide-code {
+ background: #0d1d33;
+ color: #d8e7ff;
+ border-radius: 8px;
+ padding: 12px;
+ font-size: 13px;
+ font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
+ overflow-x: auto;
+ white-space: pre-wrap;
+ word-break: break-all;
+ line-height: 1.6;
+ margin: 4px 0 0;
+ }
+ .guide-notes {
+ list-style: disc;
+ padding-left: 20px;
+ margin: 4px 0 0;
+ color: var(--muted);
+ font-size: 13px;
+ line-height: 1.8;
+ }
+ .guide-notes code {
+ background: #e8f1fc;
+ padding: 1px 6px;
+ border-radius: 4px;
+ font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
+ font-size: 12px;
+ }
@media (max-width: 768px) {
.container { padding: 14px; }
.method-card { padding: 12px; }
@@ -1032,7 +1076,7 @@ function renderHtmlPage({
查看变更记录
查看 JSON
-
+ ${isOpenapi ? '' : `
全局 Authorization
@@ -1042,8 +1086,8 @@ function renderHtmlPage({
全局业务 Header
${globalHeadersControls}
来自 JSON 的 headers 定义;带 * 的字段为必填,支持下拉 list 选择。
-
-
+
`}
+ ${isOpenapi ? '' : `
+
`}
+ ${isOpenapi ? `
+
请求方式
+
POST /openapi?method={方法名}&v=1.0×tamp={时间戳}&app_key={app_key}&sign={签名}
+Content-Type: application/json
+
+{请求体 JSON}
+
+
签名算法(MD5)
+
参与签名字符串 = canonicalQuery + self_app_secret + bodySign
+最终签名 sign = md5(参与签名字符串).toLowerCase()
+
+其中:
+ canonicalQuery = 将 query 参数(排除 sign/signature)按 key 字母序升序排列,
+ 拼接为 key1=value1&key2=value2 格式。
+ 参数值序列化规则:undefined/null → 空字符串,
+ 对象类型 → stableStringify 序列化,其他 → String(value)。
+ bodySign = md5(stableStringify(请求体))
+ stableStringify = 递归排序对象 key 的稳定序列化:
+ - 对普通对象,按 key 字母序递归序列化每个字段
+ - 对数组,按顺序递归序列化每个元素
+ - 对非普通对象(Date 等),使用 JSON.stringify
+ - undefined 返回空字符串,null 返回 "null"
+ self_app_secret = 平台分配的密钥
+
+示例(假设 self_app_secret=abc123,请求体={"id":1}):
+ query: app_key=myapp&method=index.ping×tamp=1700000000&v=1.0
+ canonicalQuery = app_key=myapp&method=index.ping×tamp=1700000000&v=1.0
+ stableStringify({"id":1}) = {"id":1}
+ bodySign = md5({"id":1}) = 0a5b3e...
+ signText = app_key=myapp&method=index.ping×tamp=1700000000&v=1.0abc1230a5b3e...
+ sign = md5(signText) = ...
+
+
注意事项
+
+ - method 格式为
模块.方法,如 index.ping
+ - app_key / self_app_secret 由仓库申请配置,请联系仓库管理员获取
+ - 请求体必须为合法 JSON,空 body 传
{}
+ - 时间戳 timestamp 为 Unix 秒级时间戳(数字类型)
+ - 时间戳 timestamp 时效校验:与服务器时间差不得超过 ±10 分钟(600 秒),超时返回 400
+ - 签名结果为 32 位小写十六进制字符串
+
+
+ → 回调测试工具
+ (模拟接收回调通知,验证回调链路)
+
+
` : ''}
@@ -1234,6 +1324,7 @@ function renderHtmlPage({
function md51(str) {
var state = [ 1732584193, -271733879, -1732584194, 271733878 ];
+ var originalLength = str.length;
var i;
for (i = 64; i <= str.length; i += 64) {
md5cycle(state, md5blk(str.substring(i - 64, i)));
@@ -1248,7 +1339,7 @@ function renderHtmlPage({
md5cycle(state, tail);
tail = new Array(16).fill(0);
}
- tail[14] = str.length * 8;
+ tail[14] = originalLength * 8;
md5cycle(state, tail);
return state;
}
@@ -1941,6 +2032,14 @@ class DocsController extends Controller {
await this.list();
}
+ /**
+ * 渲染 OpenAPI 文档独立页面。
+ * @return {Promise} 无返回值。
+ */
+ async openapi() {
+ await this.renderDoc('openapi');
+ }
+
async detail() {
const { ctx } = this;
const docName = ctx.params.docName;
diff --git a/app/controller/openapiCallback.js b/app/controller/openapiCallback.js
new file mode 100644
index 0000000..e10ad8c
--- /dev/null
+++ b/app/controller/openapiCallback.js
@@ -0,0 +1,277 @@
+'use strict';
+const { Controller } = require('egg');
+const { CALLBACK_EVENTS } = require('../service/openapi/callbackRegistry');
+
+/**
+ * OpenAPI 回调测试控制器。
+ * 提供独立的回调调试页面,用于模拟回调推送并查看响应结果。
+ */
+class OpenapiCallbackController extends Controller {
+ /**
+ * 渲染回调测试页面。
+ * 页面支持选择已注册的回调事件、填入测试 URL 和密钥,
+ * 前端计算 MD5 签名后 POST 到目标 URL 并展示完整请求/响应。
+ */
+ async testPage() {
+ const { ctx } = this;
+
+ const eventsJson = JSON.stringify(CALLBACK_EVENTS);
+
+ ctx.type = 'text/html; charset=utf-8';
+ ctx.body = `
+
+
+
+
+ OpenAPI 回调测试
+
+
+
+
+
+
OpenAPI 回调测试
+
选择已注册的回调事件,填入测试 URL,模拟真实回调推送。
+
+ ← 返回 API 文档
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
点击发送后显示响应
+
+
+
+
+
+`;
+ }
+}
+
+module.exports = OpenapiCallbackController;
diff --git a/app/dict/businessDict.js b/app/dict/businessDict.js
index 4fb637f..43fa09c 100644
--- a/app/dict/businessDict.js
+++ b/app/dict/businessDict.js
@@ -135,6 +135,7 @@ module.exports = {
STORE_CREATE: '创建货主',
STORE_CREATE_WAREHOUSE: '创建仓库',
STORE_SIGN: '签约货主',
+ STORE_OPEN_ACCOUNT: '仓库代开户',
STORE_RENAME: '修改签约备注',
STORE_UNBIND: '解绑签约',
STORE_SAVE_POLICY_CONFIG: '保存签约策略配置',
diff --git a/app/lib/express_print_payload_builder.js b/app/lib/express_print_payload_builder.js
index 9b12989..e630ac8 100644
--- a/app/lib/express_print_payload_builder.js
+++ b/app/lib/express_print_payload_builder.js
@@ -97,6 +97,7 @@ class ExpressPrintPayloadBuilder {
buildPayload(options = {}) {
const requestOptions = isPlainObject(options) ? options : {};
const platform = String(requestOptions.platform || '').trim();
+ const normalizedPlatform = this.normalizePlatform(platform);
if (!platform) {
throw new Error('快递打印缺少平台标识');
}
@@ -117,19 +118,58 @@ class ExpressPrintPayloadBuilder {
}
const payload = this.loadTemplate(platform);
- if (!isPlainObject(payload.task)) {
- payload.task = {};
- }
const requestId = idGenerator.nextRequestId();
this.applyRequestId(payload, requestId);
- payload.task.taskID = idGenerator.nextTaskId();
- payload.task.printer = printerName;
- payload.task.documents = this.buildDocumentsFromOrders(orders, idGenerator);
+ payload.printer = printerName;
+
+ if (Array.isArray(payload.taskList)) {
+ payload.taskList.forEach(item => {
+ if (isPlainObject(item)) {
+ item.printer = printerName;
+ }
+ });
+ }
+
+ if (normalizedPlatform === 'sph') {
+ this.applySphTaskDynamicFields(payload, orders);
+ } else {
+ if (!isPlainObject(payload.task)) {
+ payload.task = {};
+ }
+ payload.task.taskID = idGenerator.nextTaskId();
+ payload.task.printer = printerName;
+ payload.task.documents = this.buildDocumentsFromOrders(orders, idGenerator);
+ }
+
+ if (normalizedPlatform === 'jd') {
+ this.mergeJdParametersContents(payload, printerName);
+ }
return payload;
}
+ /**
+ * 将京东平台模板参数中的 contents 替换为订单实际内容。
+ * @param {Object} payload 打印请求 payload。
+ * @param {string} printerName 打印机名称。
+ */
+ mergeJdParametersContents(payload, printerName) {
+ if (!isPlainObject(payload.parameters)) {
+ payload.parameters = {};
+ }
+
+ payload.parameters.printName = printerName;
+
+ const documents = Array.isArray(payload.task && payload.task.documents) ? payload.task.documents : [];
+ payload.parameters.contents = documents.map(document => {
+ if (!isPlainObject(document) || !Array.isArray(document.contents) || !document.contents[0]) {
+ return {};
+ }
+ return deepClone(document.contents[0]);
+ });
+ }
+
/**
* 将 orders 映射为 documents。
* @param {Array