@@ -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 : 16 px ;
}
/* label 与「同步分类」按钮同一行(2026-11-19 用户口径:店内分类旁边加个同步按钮)。 */
. category - head {
display : flex ;
align - items : center ;
justify - content : space - between ;
gap : 10 px ;
margin - bottom : 8 px ;
}
. category - label {
display : block ;
margin - bottom : 8 px ;
color : # c8d2e2 ;
font - size : 13 px ;
font - weight : 600 ;
}
. shop - cat - sync {
flex - shrink : 0 ;
padding : 4 px 12 px ;
border : 1 px solid # 3 e4a62 ;
border - radius : 6 px ;
background : # 232 b3d ;
color : # 6 ea8ff ;
font - size : 12 px ;
font - family : inherit ;
cursor : pointer ;
transition : all 0.2 s ;
}
. shop - cat - sync : hover : not ( : disabled ) {
background : # 2 b3447 ;
border - color : # 6 ea8ff ;
}
. shop - cat - sync : disabled {
opacity : 0.5 ;
cursor : not - allowed ;
}
. category - hint {
margin : 8 px 0 0 ;
color : # 7 f8ca3 ;
@@ -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 : 6 px ; font - size : 12 px ; }
. btn - delete { padding : 6 px 10 px ; color : # ff8f8f ; background : rgba ( 231 , 76 , 60 , .12 ) ; }