feat(pdd): 拼多多订单支持 out_sku_sn 匹配与浏览器插件加密保活

- 拼多多进单 Cookie 失效即时拦截与告警修复(支持 43001 会话过期等错误识别)
- 拼多多订单映射优先使用 out_sku_sn(外部商家编码)作为商品规格与工单匹配核心字段
- 新增 Chrome/Edge 浏览器扩展 (Manifest V3),支持端到端 RSA-OAEP + AES-256-GCM 信封加密自动保活
- 后台店铺管理新增插件配对面板、专属密钥管理与一键导入配置 JSON
This commit is contained in:
yml2213
2026-09-14 12:24:48 +08:00
parent 38c0cf1223
commit 9fb27b0ad2
26 changed files with 2090 additions and 22 deletions
@@ -13,6 +13,7 @@ import {
deletePddStore,
getPddStoreById,
updatePddStoreCheckStatus,
generatePddStoreSyncToken,
} from '../../../services/platforms/pdd/pdd-source-config-service.js'
import { notifyPddCookieExpired } from '../../../services/notification/domain-notifications.js'
import {
@@ -102,6 +103,35 @@ router.delete(
}),
)
/**
* POST /platform-config/pdd/stores/:shopId/sync-token
* 为指定拼多多店铺生成或重置浏览器插件配对密钥。
*/
router.post(
'/pdd/stores/:shopId/sync-token',
createJsonHandler(
async (req) => {
const syncToken = await generatePddStoreSyncToken(req.params.shopId)
const store = getPddStoreById(req.params.shopId)
return {
shopId: req.params.shopId,
shopName: store?.shopName || req.params.shopId,
syncToken,
}
},
{
successMessage: '店铺插件配对密钥已生成',
errorMessage: '生成插件配对密钥失败',
scope: '[admin/platform-config/pdd/stores/:shopId/sync-token]',
audit: (req) => ({
action: 'platform_pdd_store_token_generated',
targetType: 'platform_store',
targetId: String(req.params.shopId || ''),
}),
},
),
)
/**
* POST /platform-config/pdd/test-cookie
* Test Cookie validity for a given cookie string or an existing shop.
@@ -0,0 +1,151 @@
import test from 'node:test'
import assert from 'node:assert/strict'
import express from 'express'
import http from 'node:http'
import pddExtensionRouter from './pdd-extension.js'
import {
getOrCreatePddRsaKeyPair,
testEncryptPddPayload,
} from '../services/platforms/pdd/pdd-crypto-service.js'
import {
generatePddStoreSyncToken,
getPddStoreById,
savePddSourcesConfig,
getPddSourcesConfig,
} from '../services/platforms/pdd/pdd-source-config-service.js'
import { PddClient } from '../services/platforms/pdd/pdd-client.js'
import { query } from '../db/client.js'
function makeTestApp() {
const app = express()
app.use(express.json())
app.use('/api/v1/pdd/extension', pddExtensionRouter)
return app
}
test('pdd-extension router: GET /public-key and POST /sync-cookie full flow', async (t) => {
let dbAvailable = false
try {
const check = await query('SELECT 1').catch(() => null)
dbAvailable = Boolean(check)
} catch {
dbAvailable = false
}
if (!dbAvailable) {
t.skip('Skipping integration test: PostgreSQL database is not reachable outside container')
return
}
const app = makeTestApp()
const server = http.createServer(app)
await new Promise<void>((resolve) => server.listen(0, resolve))
const addr = server.address()
const port = typeof addr === 'object' && addr ? addr.port : 0
const baseUrl = `http://127.0.0.1:${port}/api/v1/pdd/extension`
// Prepare a test store in config
const originalConfig = getPddSourcesConfig()
const testShopId = 'test_shop_router_01'
const mockConfig = {
...originalConfig,
stores: [
{
shopId: testShopId,
shopName: '测试路由店铺',
cookie: 'old_cookie=123;',
cookieValid: false,
enabled: true,
},
],
}
await savePddSourcesConfig(mockConfig)
// Generate sync token
const token = await generatePddStoreSyncToken(testShopId)
// Mock PddClient.testCookie
const originalTestCookie = PddClient.testCookie
PddClient.testCookie = async () => ({
valid: true,
totalOrders: 88,
})
try {
// 1. Test GET /public-key
const pkResp = await fetch(`${baseUrl}/public-key`)
assert.equal(pkResp.status, 200)
const pkData = await pkResp.json()
assert.equal(pkData.code, 0)
assert.ok(pkData.data.publicKeySpki)
assert.equal(pkData.data.algorithm, 'RSA-OAEP-256')
// 2. Test POST /sync-cookie with missing token
const kp = getOrCreatePddRsaKeyPair()
const payload = {
shopId: testShopId,
cookie: 'new_fresh_cookie=xyz;',
userAgent: 'Mozilla/5.0 Extension Test',
timestamp: Date.now(),
nonce: 'nonce_test_' + Math.random().toString(36).slice(2),
}
const envelope = testEncryptPddPayload(payload, kp.publicKeyPem)
const noTokenResp = await fetch(`${baseUrl}/sync-cookie`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ envelope }),
})
assert.equal(noTokenResp.status, 401)
// 3. Test POST /sync-cookie with wrong token
const wrongTokenResp = await fetch(`${baseUrl}/sync-cookie`, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-Shop-Token': 'wrong-token-abc',
},
body: JSON.stringify({
envelope: testEncryptPddPayload(
{ ...payload, nonce: 'nonce_wrong_' + Math.random().toString(36).slice(2) },
kp.publicKeyPem,
),
}),
})
assert.equal(wrongTokenResp.status, 403)
// 4. Test POST /sync-cookie with valid token and fresh nonce
const freshPayload = {
...payload,
nonce: 'nonce_fresh_' + Math.random().toString(36).slice(2),
}
const freshEnvelope = testEncryptPddPayload(freshPayload, kp.publicKeyPem)
const validResp = await fetch(`${baseUrl}/sync-cookie`, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-Shop-Token': token,
},
body: JSON.stringify({ envelope: freshEnvelope }),
})
assert.equal(validResp.status, 200)
const validData = await validResp.json()
assert.equal(validData.code, 0)
assert.equal(validData.data.shopId, testShopId)
assert.equal(validData.data.valid, true)
assert.equal(validData.data.totalOrders, 88)
// Verify store was updated in memory/config
const updatedStore = getPddStoreById(testShopId)
assert.ok(updatedStore)
assert.equal(updatedStore.cookie, 'new_fresh_cookie=xyz;')
assert.equal(updatedStore.cookieValid, true)
assert.ok(updatedStore.lastExtensionSyncAt)
} finally {
PddClient.testCookie = originalTestCookie
await savePddSourcesConfig(originalConfig)
await new Promise<void>((resolve) => server.close(() => resolve()))
}
})
+151
View File
@@ -0,0 +1,151 @@
/**
* Pinduoduo Extension Public API Routes
* 拼多多浏览器插件端到端加密同步接口
*/
import { Router } from 'express'
import {
decryptPddExtensionPayload,
getPddExtensionPublicKeyInfo,
type PddEncryptedEnvelope,
} from '../services/platforms/pdd/pdd-crypto-service.js'
import {
getPddStoreById,
updatePddStoreCookieFromExtension,
verifyPddStoreSyncToken,
} from '../services/platforms/pdd/pdd-source-config-service.js'
import { PddClient } from '../services/platforms/pdd/pdd-client.js'
import { createHttpError } from '../utils/http.js'
import { logInfo, logWarn } from '../utils/logger.js'
const router = Router()
// 浏览器扩展跨域支持(支持 chrome-extension:// 等各种来源)
router.use((req, res, next) => {
const origin = req.headers.origin
if (origin) {
res.setHeader('Access-Control-Allow-Origin', origin)
} else {
res.setHeader('Access-Control-Allow-Origin', '*')
}
res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization, X-Shop-Token')
res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS')
if (req.method === 'OPTIONS') {
res.sendStatus(204)
return
}
next()
})
/**
* GET /api/v1/pdd/extension/public-key
* 获取服务端 RSA-OAEP 2048 公钥信息(供浏览器插件加密使用)
*/
router.get('/public-key', (_req, res) => {
const info = getPddExtensionPublicKeyInfo()
res.json({
code: 0,
message: 'ok',
data: info,
})
})
/**
* POST /api/v1/pdd/extension/sync-cookie
* 浏览器插件上传端到端加密的最新 Cookie
*/
router.post('/sync-cookie', async (req, res, next) => {
try {
const envelope = (req.body?.envelope || req.body) as PddEncryptedEnvelope
// 1. 端到端安全解密
const decrypted = decryptPddExtensionPayload(envelope)
const clientToken = String(
req.headers['x-shop-token'] ||
req.body?.token ||
req.query?.token ||
decrypted.syncToken ||
'',
).trim()
if (!clientToken) {
throw createHttpError('未提供店铺专属配对密钥 (X-Shop-Token header 或 token 字段)', {
statusCode: 401,
errorCode: 'missing_shop_token',
})
}
// 2. 校验店铺配对密钥
const isTokenValid = verifyPddStoreSyncToken(decrypted.shopId, clientToken)
if (!isTokenValid) {
logWarn('[pdd-extension]', `插件尝试为店铺 ${decrypted.shopId} 上传 Cookie,但配对密钥无效`, {
shopId: decrypted.shopId,
ip: req.ip,
})
throw createHttpError('店铺配对密钥无效或已重置,请重新在后台复制配置', {
statusCode: 403,
errorCode: 'invalid_shop_token',
})
}
const store = getPddStoreById(decrypted.shopId)
if (!store) {
throw createHttpError(`店铺不存在: ${decrypted.shopId}`, {
statusCode: 404,
errorCode: 'store_not_found',
})
}
// 3. 实测 Cookie 有效性(轻量探测)
const testResult = await PddClient.testCookie({
cookie: decrypted.cookie,
userAgent: decrypted.userAgent || store.userAgent,
})
if (!testResult.valid) {
logWarn('[pdd-extension]', `插件上报的 Cookie 实测未通过: ${testResult.message}`, {
shopId: store.shopId,
})
res.status(400).json({
code: 400,
message: `Cookie 校验失败: ${testResult.message}`,
data: {
valid: false,
shopId: store.shopId,
shopName: store.shopName,
},
})
return
}
// 4. 更新店铺配置并自动置为有效
const updatedStore = await updatePddStoreCookieFromExtension(store.shopId, {
cookie: decrypted.cookie,
userAgent: decrypted.userAgent,
etag: decrypted.etag,
})
logInfo('[pdd-extension]', `插件成功自动同步店铺 [${store.shopName}(${store.shopId})] Cookie`, {
shopId: store.shopId,
totalOrders: testResult.totalOrders,
lastSyncAt: updatedStore.lastExtensionSyncAt,
})
res.json({
code: 0,
message: 'Cookie 同步成功并已生效',
data: {
shopId: updatedStore.shopId,
shopName: updatedStore.shopName,
valid: true,
totalOrders: testResult.totalOrders,
lastExtensionSyncAt: updatedStore.lastExtensionSyncAt,
},
})
} catch (err) {
next(err)
}
})
export default router