feat(jd): 采集分类改「同步分类」按店实时拉取+回补 4.0.78 窗用户端 amber notice 源码

This commit is contained in:
2026-11-19 12:50:53 +08:00
parent 8453091630
commit 23e326df19
7 changed files with 393 additions and 152 deletions
+158 -31
View File
@@ -21,13 +21,12 @@ import { userNotice } from '@/shared/utils/user-notice'
import { formatDateTime } from '@/shared/utils/datetime'
import { useLiveTaskBoard } from '@/shared/composables/useLiveTaskBoard'
import NotificationBell from '@/shared/components/NotificationBell.vue'
import { JD_SHOP_CATEGORY_SNAPSHOT } from './jd-shop-category.ts'
/** 京东「获取店铺数据」(v1.5):一键建单 → 推送本机客户端 → 右侧任务面板实时进度。
*
* 四个真源与四条边界(照 v1.4 已落地的采集契约与外观专利任务面板骨架,不另造流程):
* 1. 建单走后端 `/api/jd-collect/tasks`(通道恒 LOCAL,服务端落 PENDING);可选多选采集
* 分类(京麦「店内分类」快照,`shopCategoryNames`/`shopCategoryIds` 双键)——空=全店
* 分类(京麦「店内分类」,`shopCategoryNames`/`shopCategoryIds` 双键)——空=全店
* 采集,选中值随建单进 request_json、随推送/兜底拉取进客户端,客户端按行
* shopCategorys/shopCategoryPath/groupId 等值过滤、任一键命中即命中(三处同键契约;
* 2026-11-16 类目级联按客户口径「类目不需要只要分类」下线,categoryPaths 仅历史行兼容);
@@ -38,9 +37,12 @@ import { JD_SHOP_CATEGORY_SNAPSHOT } from './jd-shop-category.ts'
* 4. 失败/中断任务「重试/继续」走通用原位复位(铁律 26,保留已收分片与断点游标),
* 复位后页面重新激活并推队列——同一份输入不再多出好几行结果。
*
* 2026-11-16 客户口径「管理员弄了多少店铺分类 普通账户都能看到」落点改为本多选块:
* 客户的参照系是京麦后台的「店内分类」(getShopCategoryList 快照),不再是后管平台分组
* (平台分组接口从本页下线,分组数据面归京东数据库与商品上架)。
* 2026-11-19 客户口径「每一家店铺的分类都会不一样」:选项集正本从冻结快照
* (2026-11-16 对花屿巷一家店的抓包,对第二家店必错)改为**按店实时拉取**——
* 「同步分类」按钮 → 桥 `get_jd_shop_categories` → 客户端用本机已登录京麦的
* profile 现拉 getShopCategoryList(执行体 amazon/jd/shop_categories.py)。
* 店内分类是商家在京麦后台自维护的,选项集永远等于「本机已登录那家店」的现值;
* 老客户端没有该桥方法 ⇒ 按钮置灰并提示升级。
*/
/** 页面不再让用户填店铺名:店铺名称由客户端从京麦后台读,建单先按此占位记录。 */
@@ -54,22 +56,96 @@ const username = ref('admin')
const submitting = ref(false)
const errorMessage = ref('')
const successMessage = ref('')
/** 推送失败等「设计内慢路径」提示:amber 展示,不占红色 error(2026-11-19 用户反馈红条吓人)。 */
const noticeMessage = ref('')
// ---- 采集分类(可选,下拉多选;空=全店采集)----
/** 选项集=京麦「店内分类」快照(getShopCategoryList,2026-11-16 真机取证 9 个;
* 京麦侧改分类后按取证路重抓,见 jd-shop-category.ts 头注释——快照不会自动过期告警)。
* 2026-11-17 客户口径「不要全展示出来,弄个下拉式多选」:复选列表换 el-select 多选
* (collapse-tags 折叠成「+N」徽标),选择模型改存分类 id 数组,label/id 双键从快照反查。 */
const shopCategoryOptions = JD_SHOP_CATEGORY_SNAPSHOT
/** 京麦「店内分类」项:label=分类名(行级等值词),value=分类 id。形状与旧快照同形。 */
interface ShopCategoryOption {
label: string
value: string
}
/** 选项集=「同步分类」从本机已登录京麦店铺现拉的实时结果(2026-11-19 起;
* 旧冻结快照已退役——每家店的店内分类名字与 id 都不同,写死必错)。 */
const shopCategoryOptions = ref<ShopCategoryOption[]>([])
const selectedShopCategoryValues = ref<string[]>([])
/** 同步中/可用态:可用性按桥上有没有 get_jd_shop_categories 方法判(老客户端置灰)。 */
const syncingCategories = ref(false)
const canSyncCategories = ref(false)
/** 最近一次同步到的店铺名(空=尚未同步或京麦页面没返回店铺名)。 */
const syncedShopName = ref('')
/** 无桥(浏览器打开)或老客户端(桥没有该方法)时点同步的提示。 */
const SYNC_UNAVAILABLE_NOTE =
'当前在浏览器中打开或客户端版本较旧,无法同步店内分类。请在本机客户端中打开本页;仍不可用请把客户端升级到最新版'
function refreshSyncAvailability() {
canSyncCategories.value = typeof getPywebviewApi()?.get_jd_shop_categories === 'function'
}
/** 分类块底部说明:同步状态 + 选中口径 + 「先挂分类才有命中」的边界,一行讲完。 */
const categoryHint = computed(() => {
const parts: string[] = []
if (syncedShopName.value) {
parts.push(`已同步店铺「${syncedShopName.value}」:${shopCategoryOptions.value.length} 个分类`)
} else {
parts.push('分类来自本机客户端已登录的京麦店铺,点「同步分类」拉取;未同步或空选=全店采集')
}
if (selectedShopCategoryValues.value.length) {
parts.push(`只采选中 ${selectedShopCategoryValues.value.length} 个分类的商品`)
}
parts.push('商品要先在京麦挂上分类才会被选中')
return `${parts.join(';')}。`
})
/** 点「同步分类」:桥 → 客户端现拉 getShopCategoryList。成功刷新选项集并清理
* 不属于当前店铺的已选 id(id 是店铺自有,跨店必错);失败按 code 分档——
* jd_busy(京东任务在跑)走 amber notice,jd_login/jd_page/未知走红色 error。 */
async function syncShopCategories() {
if (syncingCategories.value) return
errorMessage.value = ''
noticeMessage.value = ''
const api = getPywebviewApi()
const bridge = api?.get_jd_shop_categories
if (typeof bridge !== 'function') {
errorMessage.value = SYNC_UNAVAILABLE_NOTE
return
}
syncingCategories.value = true
try {
const result = await bridge()
if (result?.success && Array.isArray(result.categories)) {
const options = result.categories.filter((item) => item && item.label && item.value)
const optionIds = new Set(options.map((item) => item.value))
const staleCount =
selectedShopCategoryValues.value.filter((value) => !optionIds.has(value)).length
selectedShopCategoryValues.value =
selectedShopCategoryValues.value.filter((value) => optionIds.has(value))
shopCategoryOptions.value = options
syncedShopName.value = result.shopName || ''
if (staleCount > 0) {
noticeMessage.value = `已按当前店铺刷新分类,清除了 ${staleCount} 个不属于当前店铺的已选项`
}
} else if (result?.code === 'jd_busy') {
noticeMessage.value = result.error || '京东任务正在运行,请等任务结束后再同步分类'
} else {
errorMessage.value = result?.error || '同步分类未返回结果,请稍后重试'
}
} catch (error) {
errorMessage.value = error instanceof Error ? `同步分类失败:${error.message}` : '同步分类失败,请稍后重试'
} finally {
syncingCategories.value = false
}
}
function clearShopCategories() {
selectedShopCategoryValues.value = []
}
/** 选中项按快照原序反查回对象(下拉里点选的先后不进请求体——双键顺序恒等于快照序)。 */
/** 选中项按选项集原序反查回对象(下拉里点选的先后不进请求体——双键顺序恒等于同步序)。 */
const selectedShopCategories = computed(() =>
shopCategoryOptions.filter((item) => selectedShopCategoryValues.value.includes(item.value)),
shopCategoryOptions.value.filter((item) => selectedShopCategoryValues.value.includes(item.value)),
)
/** 建单/推送载荷的选中值:label 与 id 双键同发(行级填充形状未取证,任一键命中即命中)。 */
@@ -289,7 +365,14 @@ async function activateTask(id: number): Promise<string | null> {
}
}
/** 建单成功后推送本机队列;返回 null 表示环境无队列能力(浏览器预览),返回 string 表示失败原因。
/** 推送失败 ≠ 建单失败:任务已在服务端落库,客户端兜底拉取线程(60 秒一轮)会自动认领。
* 2026-11-19 用户反馈红色「推送失败」横幅吓人(实为设计内慢路径,最多晚约 1 分钟)——
* 文案改中性动作句,展示走 amber notice 通道,红色 error 只留给真失败(建单/激活失败)。 */
const PUSH_FALLBACK_NOTE =
'任务已创建,但未能即时推送到本机队列。请保持本机客户端在线,客户端会在约 1 分钟内自动领取并执行'
/** 建单成功后推送本机队列;返回 null 表示已推送成功,返回 string 表示要展示的提示文案
* (含浏览器无桥环境——任务仍会由在线客户端兜底认领,不是失败)。
* shopCategoryNames/Ids 是建单时选的京麦店内分类(重试/继续从历史行同源带回)——推送载荷
* 与建单请求体、客户端兜底拉取(request_json)三处同键,缺一处客户端就按全店采集跑。 */
async function pushToClientQueue(
@@ -301,7 +384,7 @@ async function pushToClientQueue(
): Promise<string | null> {
const api = getPywebviewApi()
if (!api?.enqueue_json) {
return '当前环境未启用任务队列能力(浏览器预览环境不会启动),请在本机客户端中打开本页'
return '当前在浏览器中打开,无法直接推送本机队列。任务已创建,将由在线的本机客户端自动领取;如需本机立即执行,请在本机客户端中打开本页'
}
const payload = {
type: 'jd-shop-collect-run',
@@ -316,7 +399,7 @@ async function pushToClientQueue(
if (pushResult?.error) {
console.error('[jd-collect] enqueue_json 被拒', pushResult.error)
}
return '推送本机队列失败,任务将由客户端兜底拉取认领'
return PUSH_FALLBACK_NOTE
}
const isRunning = computed(() => Boolean(board.dashboard.value.pendingTaskCount) || submitting.value)
@@ -325,6 +408,7 @@ async function startCollect() {
if (submitting.value) return
errorMessage.value = ''
successMessage.value = ''
noticeMessage.value = ''
submitting.value = true
const shop = DEFAULT_SHOP_NAME
const tabs = DEFAULT_TABS
@@ -333,25 +417,24 @@ async function startCollect() {
try {
const vo = await createJdCollectTask(shop, tabs, 0, [], shopNames, shopIds)
board.addPollingTask(vo.taskId)
let pushNote = ''
const activateError = await activateTask(vo.taskId)
if (activateError) {
// 没激活成功就不推队列:推了也是白跑一轮(分片全被拒)。任务留在 PENDING,
// 由服务端兜底拉取认领后照样会跑,所以这里只提示、不回滚建单。
pushNote = activateError
// 由客户端兜底拉取认领后照样会跑,所以这里只提示、不回滚建单。
// 激活失败是服务端原因,留在红色 error 档提醒用户可重试。
errorMessage.value = activateError
} else {
try {
const pushError = await pushToClientQueue(vo.taskId, shop, tabs, shopNames, shopIds)
if (pushError) pushNote = pushError
// 推送失败只是慢路径(兜底拉取约 1 分钟内认领),走 amber notice,不占红色 error。
if (pushError) noticeMessage.value = pushError
} catch (pushErr) {
// 推送自身异常不回滚建单:任务可由服务端兜底拉取认领。
pushNote = '推送本机队列失败,任务将由服务端兜底派发给本机客户端执行'
// 推送自身异常不回滚建单:任务可由客户端兜底拉取认领。
noticeMessage.value = PUSH_FALLBACK_NOTE
console.error('[jd-collect] 推送本机队列失败', pushErr)
}
}
if (pushNote) {
errorMessage.value = pushNote
} else {
if (!errorMessage.value && !noticeMessage.value) {
successMessage.value = shopNames.length
? `任务已创建(只采 ${shopNames.length} 个分类)并推送给本机客户端,进度显示在右侧任务区`
: '任务已创建并推送给本机客户端,进度显示在右侧任务区'
@@ -368,6 +451,9 @@ onMounted(async () => {
const localName = (window.localStorage.getItem('username') || '').trim()
if (localName) username.value = localName
board.loadPollingIds()
// 同步按钮可用性:桥晚到(pywebviewready 在挂载之后)也要能翻成可用。
refreshSyncAvailability()
window.addEventListener('pywebviewready', refreshSyncAvailability)
await Promise.all([
board.loadDashboard().catch(() => undefined),
board.loadHistory().catch(() => undefined),
@@ -378,6 +464,7 @@ onMounted(async () => {
})
onUnmounted(() => {
window.removeEventListener('pywebviewready', refreshSyncAvailability)
board.dispose()
})
</script>
@@ -412,17 +499,19 @@ onUnmounted(() => {
<main class="jd-body">
<aside class="left-panel">
<div class="category-block">
<span class="category-label">采集分类(可选,多选)</span>
<div class="category-head">
<span class="category-label">采集分类(可选,多选)</span>
<button class="shop-cat-sync" type="button" :disabled="!canSyncCategories || syncingCategories"
title="从本机已登录的京麦店铺拉取店内分类(每家店不一样)" @click="syncShopCategories">
{{ syncingCategories ? '同步中…' : '同步分类' }}
</button>
</div>
<el-select v-model="selectedShopCategoryValues" multiple collapse-tags collapse-tags-tooltip
:max-collapse-tags="1" placeholder="全店采集(点击选择分类)" class="shop-cat-select">
<el-option v-for="category in shopCategoryOptions" :key="category.value"
:label="category.label" :value="category.value" />
</el-select>
<p class="category-hint">
{{ selectedShopCategoryValues.length
? `只采选中 ${selectedShopCategoryValues.length} 个分类的商品;`
: '默认全店采集。' }}
分类是京麦后台「店内分类」(2026-11-16 快照);商品要先在京麦挂上分类才会被选中。
<p class="category-hint">{{ categoryHint }}
<button v-if="selectedShopCategoryValues.length" class="shop-cat-clear" type="button"
@click="clearShopCategories">清空</button>
</p>
@@ -438,6 +527,7 @@ onUnmounted(() => {
</p>
<p v-if="successMessage" class="feedback success">{{ successMessage }}</p>
<p v-if="noticeMessage" class="feedback notice">{{ noticeMessage }}</p>
<p v-if="errorMessage" class="feedback error">{{ errorMessage }}</p>
</aside>
@@ -647,14 +737,45 @@ onUnmounted(() => {
margin-bottom: 16px;
}
/* label 与「同步分类」按钮同一行(2026-11-19 用户口径:店内分类旁边加个同步按钮)。 */
.category-head {
display: flex;
align-items: center;
justify-content: space-between;
gap: 10px;
margin-bottom: 8px;
}
.category-label {
display: block;
margin-bottom: 8px;
color: #c8d2e2;
font-size: 13px;
font-weight: 600;
}
.shop-cat-sync {
flex-shrink: 0;
padding: 4px 12px;
border: 1px solid #3e4a62;
border-radius: 6px;
background: #232b3d;
color: #6ea8ff;
font-size: 12px;
font-family: inherit;
cursor: pointer;
transition: all 0.2s;
}
.shop-cat-sync:hover:not(:disabled) {
background: #2b3447;
border-color: #6ea8ff;
}
.shop-cat-sync:disabled {
opacity: 0.5;
cursor: not-allowed;
}
.category-hint {
margin: 8px 0 0;
color: #7f8ca3;
@@ -729,6 +850,12 @@ onUnmounted(() => {
color: #fca5a5;
}
/* amber notice:设计内慢路径(推送失败走兜底拉取)专用,不是错误——与 success/error 同族配色 */
.feedback.notice {
background: rgba(245, 158, 11, 0.14);
color: #fcd34d;
}
/* 行内动作按钮:与外观专利 Tab 同色系(中断琥珀/重试绿/删除红),钉死 12px 字号 */
.btn-delete, .btn-retry, .btn-interrupt { border: none; cursor: pointer; border-radius: 6px; font-size: 12px; }
.btn-delete { padding: 6px 10px; color: #ff8f8f; background: rgba(231, 76, 60, .12); }
@@ -1,41 +0,0 @@
/** 京麦「店内分类」快照——建单页采集分类多选的选项集(2026-11-16 真机取证)。
*
* 数据来源(唯一正本):京麦商品列表页首屏自发的
* `dsm.product.manage.ShopCategoryReadViewService.getShopCategoryList`
* (响应 `data.shopCategoryList[]` = `{parent:"0", orderNo, children:[], label, value}`;
* 2026-11-16 本机 Chrome 19899/chrome_data_jd profile 真机抓包,原始响应与取证脚本存
* D:/tmp/jd_group_probe/)。label=店内分类名,value=分类 id;扁平单层(parent 恒 0、
* children 恒空),本店 9 个,按 orderNo 排序。
*
* 口径与边界(先说清,防止后人当它错改):
* - 这是**京麦侧**的店内分类(商家在京麦后台维护),不是后管「京东数据库」的平台分组
* (那是 biz_jd_product_group,两套概念,2026-11-16 客户口径「选京麦的内部分类去采集」
* 指的是这一套);
* - 行级过滤键:列表行 `shopCategorys/shopCategoryPath/groupId`(取证见客户端
* `app_client/amazon/jd/jd_base.py::_filter_by_shop_category`);**填充形状未取证**
* (450 行采样全空——采样店铺还没给商品挂分类),所以建单把 label 与 value 双键同发
* (shopCategoryNames + shopCategoryIds),客户端任一键命中即命中;
* - ⚠ 采样店铺(花屿巷)当前 0/450 商品挂了店内分类:选任何分类采集都是 0 行命中
* (客户端零命中时打 WARNING 校准点),商家在京麦把商品挂上分类后本功能才真正生效;
* - 京麦侧改分类(增删改名)后按原取证路重抓替换本数据(快照不会自动过期告警)。
*
* 纯数据,node --test 直测。后管若要用,复制同形文件(两前端没有共享包)。 */
/** 店内分类项:label=分类名(行级等值词),value=分类 id(取证留档 + id 形状对冲)。 */
export interface JdShopCategory {
label: string
value: string
}
/** 京麦店内分类快照(2026-11-16 取证,getShopCategoryList 按 orderNo 原序)。 */
export const JD_SHOP_CATEGORY_SNAPSHOT: JdShopCategory[] = [
{ label: '工作制服', value: '1024347567' },
{ label: '礼服/演出服', value: '1024347568' },
{ label: '女士演出服/民族服装', value: '1024347569' },
{ label: '特殊服装', value: '1024347570' },
{ label: '睡衣/家居服', value: '1024347571' },
{ label: '拉丁舞服', value: '1024347572' },
{ label: '服饰配件', value: '1024347573' },
{ label: '男士卫衣', value: '1024347574' },
{ label: '其他', value: '1024347575' },
]
@@ -72,7 +72,7 @@ export interface JdCollectCategoryVo {
* (先全店采集一次即有),拉取失败不阻塞建单——不选类目=全店采集。
*
* @deprecated 2026-11-16 建单页类目级联下线(客户口径「类目不需要只要分类」,换京麦
* 店内分类多选,见 pages/jd/jd-shop-category.ts);本函数与 /api/jd-collect/categories
* 店内分类多选);本函数与 /api/jd-collect/categories
* 端点保留给数据面(endpoints 冻结快照仍登记),建单页不再消费。
*/
export function fetchJdCollectCategories() {
@@ -204,6 +204,21 @@ export interface PywebviewApi {
enqueue_json?: (
data: unknown,
) => Promise<{ success: boolean; queue_size?: number; error?: string; code?: string }>;
/**
* 京东建单页「同步分类」:现拉本机已登录京麦店铺的「店内分类」(2026-11-19 起
* 选项集正本,替代冻结快照——每家店的店内分类名字与 id 都不同)。执行体在客户端
* amazon/jd/shop_categories.py,全程返回 dict;code 分档 jd_busy(京东任务在跑,
* amber notice)/ jd_login(京麦未登录)/ jd_page(页面结构变更,红色 error)。
* 老客户端没有这个方法 ⇒ 页面把「同步分类」按钮置灰并提示升级。
*/
get_jd_shop_categories?: () => Promise<{
success: boolean;
shopName?: string;
shopId?: string;
categories?: Array<{ label: string; value: string }>;
code?: string;
error?: string;
}>;
// —— ASIN 变体采集(VariantCollectionAPI,vc_* 前缀)——
vc_select_input_files?: () => Promise<string[]>;
vc_start_collect?: (params: {