feat(jd-collect): 建单页「登录京麦」独立入口 + jd_login 分档引导(桥 open_jd_login)

背景(2026-11-20 装机日志+截图两帧):京麦登录态失效后,采集专用浏览器
(19899/chrome_data_jd)的登录窗口只在任务失败那十几秒里"顺带"出现、随即被
任务 finally 关掉;用户在日常 Chrome 登京麦成功但采集连败 3 次——两套浏览器
登录态不共享,误登=白登。客户端侧执行体与桥见 app_client b2af332。

- JdCollectTab.vue:「同步分类」旁新增「登录京麦」按钮(老客户端桥无该方法
  ⇒ 置灰+升级指引,与「同步分类」同口径);openJdLogin 分档——成功走绿色
  success,busy/重入/超时/关窗走 amber notice(超时档客户端不关窗口,用户可
  继续登),仅 jd_page/未知走红色 error。
- 「同步分类」jd_login 档现在点名引导「登录京麦」按钮(旧文案只说"去采集
  浏览器登录",用户找不到窗口)。
- pywebview.ts 登记 open_jd_login 桥类型(本笔只含该 hunk,341/326 全文件
  diff 事故已纠正——工作树 CRLF、仓内 blob LF,构造件归一 LF 后 numstat 15/0;
  jd_publish_protocol 类型属发布窗在飞改动,未卷入)。
- tests/jd-collect-tab.test.ts:新增「登录京麦独立入口」源扫判据(按钮/桥类型/
  分档通道/jd_login 引导,改回即红);node --test 13 例全绿、vue-tsc rc=0。

未完项(BACKLOG B121-04):京东发布侧 JdPublishTab 失败弹窗未接新按钮(发布窗
在飞面上,下一窗接线);装机面生效前置=随下一版客户端出包+用户端发版。
This commit is contained in:
2026-11-20 17:46:39 +08:00
parent 5bdc125b18
commit acd61aa1d2
3 changed files with 105 additions and 1 deletions
+52 -1
View File
@@ -74,6 +74,9 @@ const selectedShopCategoryValues = ref<string[]>([])
/** 同步中/可用态:可用性按桥上有没有 get_jd_shop_categories 方法判(老客户端置灰)。 */
const syncingCategories = ref(false)
const canSyncCategories = ref(false)
/** 「登录京麦」(2026-11-20):起采集专用浏览器等人工登录;可用态同口径按桥判。 */
const loggingIn = ref(false)
const canLoginJd = ref(false)
/** 最近一次同步到的店铺名(空=尚未同步或京麦页面没返回店铺名)。 */
const syncedShopName = ref('')
/** 本页选项集来自上次缓存的时间(空=本次没回填缓存;只作提示,不参与建单)。 */
@@ -102,9 +105,14 @@ function restoreCategoryCache() {
/** 无桥(浏览器打开)或老客户端(桥没有该方法)时点同步的提示。 */
const SYNC_UNAVAILABLE_NOTE =
'当前在浏览器中打开或客户端版本较旧,无法同步店内分类。请在本机客户端中打开本页;仍不可用请把客户端升级到最新版'
/** 同上口径的「登录京麦」不可用提示(2026-11-20)。 */
const LOGIN_UNAVAILABLE_NOTE =
'当前在浏览器中打开或客户端版本较旧,无法打开京麦登录窗口。请在本机客户端中打开本页;仍不可用请把客户端升级到最新版'
function refreshSyncAvailability() {
canSyncCategories.value = typeof getPywebviewApi()?.get_jd_shop_categories === 'function'
const api = getPywebviewApi()
canSyncCategories.value = typeof api?.get_jd_shop_categories === 'function'
canLoginJd.value = typeof api?.open_jd_login === 'function'
}
/** 分类块底部说明:同步状态 + 选中口径 + 「先挂分类才有命中」的边界,一行讲完。 */
@@ -162,6 +170,11 @@ async function syncShopCategories() {
}
} else if (result?.code === 'jd_busy') {
noticeMessage.value = result.error || '京东任务正在运行,请等任务结束后再同步分类'
} else if (result?.code === 'jd_login') {
errorMessage.value = result.error || '京麦未登录(登录态失效)'
if (canLoginJd.value) {
noticeMessage.value = '点上方「登录京麦」按钮打开登录窗口,登录完成后重新点「同步分类」'
}
} else {
errorMessage.value = result?.error || '同步分类未返回结果,请稍后重试'
}
@@ -176,6 +189,39 @@ function clearShopCategories() {
selectedShopCategoryValues.value = []
}
/** 点「登录京麦」(2026-11-20 装机实录后的独立登录入口):桥 → 客户端起采集专用
* 浏览器停在京麦登录页等人工登录,登录成功即关窗、登录态常驻本机 profile。
* 分档口径:busy/重入/超时/用户关窗都是「设计内等待或可恢复」走 amber notice
* (超时档客户端**不关窗口**,用户可继续登),只有 jd_page/未知才是红色 error。 */
async function openJdLogin() {
if (loggingIn.value) return
errorMessage.value = ''
noticeMessage.value = ''
successMessage.value = ''
const api = getPywebviewApi()
const bridge = api?.open_jd_login
if (typeof bridge !== 'function') {
errorMessage.value = LOGIN_UNAVAILABLE_NOTE
return
}
loggingIn.value = true
try {
const result = await bridge()
if (result?.success) {
successMessage.value = result.message || '京麦登录完成,可重跑采集或点「同步分类」'
} else if (result?.code === 'jd_busy' || result?.code === 'jd_login_running'
|| result?.code === 'timeout' || result?.code === 'window_closed') {
noticeMessage.value = result.error || '京麦登录未完成,请按提示重试'
} else {
errorMessage.value = result?.error || '打开登录窗口失败,请稍后重试'
}
} catch (error) {
errorMessage.value = error instanceof Error ? `登录京麦失败:${error.message}` : '登录京麦失败,请稍后重试'
} finally {
loggingIn.value = false
}
}
/** 选中项按选项集原序反查回对象(下拉里点选的先后不进请求体——双键顺序恒等于同步序)。 */
const selectedShopCategories = computed(() =>
shopCategoryOptions.value.filter((item) => selectedShopCategoryValues.value.includes(item.value)),
@@ -546,6 +592,11 @@ onUnmounted(() => {
<div class="category-block">
<div class="category-head">
<span class="category-label">采集分类(可选,多选)</span>
<button class="shop-cat-sync" type="button" :disabled="!canLoginJd || loggingIn"
title="打开京东采集专用浏览器,停在京麦登录页人工登录(登录态失效时需要;登录一次即常驻本机)"
@click="openJdLogin">
{{ loggingIn ? '等待登录中…' : '登录京麦' }}
</button>
<button class="shop-cat-sync" type="button" :disabled="!canSyncCategories || syncingCategories"
title="从本机已登录的京麦店铺拉取店内分类(每家店不一样)" @click="syncShopCategories">
{{ syncingCategories ? '同步中…' : '同步分类' }}
@@ -219,6 +219,21 @@ export interface PywebviewApi {
code?: string;
error?: string;
}>;
/**
* 京东采集建单页「登录京麦」(2026-11-20):起本机京东采集专用浏览器、停在京麦
* 登录页等人工登录(执行体在客户端 amazon/jd/login_window.py,登录态常驻采集专用
* profile chrome_data_jd,登一次后续任务复用)。code 分档:成功 logged_in /
* already_logged_in(带 message);失败 jd_busy(京东任务在跑)/ jd_login_running
* (登录窗口已在等待,可恢复)/ window_closed(用户关了窗口,再点一次)/
* timeout(等待超时,窗口保持打开)/ jd_page(真失败)。
* 老客户端没有这个方法 ⇒ 页面把「登录京麦」按钮置灰并提示升级。
*/
open_jd_login?: () => Promise<{
success: boolean;
code?: string;
message?: string;
error?: string;
}>;
// —— ASIN 变体采集(VariantCollectionAPI,vc_* 前缀)——
vc_select_input_files?: () => Promise<string[]>;
vc_start_collect?: (params: {
+38
View File
@@ -199,6 +199,44 @@ test('建单后先激活再推客户端队列', () => {
* 横幅(兜底拉取 2 分钟后照常认领,任务没坏)。推送失败是设计内慢路径不是错误——文案
* 改中性动作句、展示走 amber notice 通道,红色 error 只留给真失败(建单/激活失败)。
* 把提示改回塞进 errorMessage 即红。 */
/** 2026-11-20 装机实录:京麦登录态失效后,登录窗口只在任务失败那十几秒"顺带"出现、
* 还会被任务 finally 关掉 ⇒ 独立登录入口「登录京麦」(桥 open_jd_login → 客户端
* amazon/jd/login_window.py)。把按钮下线、分档改回全红 error、或 jd_login 不再引导
* 去「登录京麦」(用户就会去登自己的浏览器——登录态不共享,白登),即红。 */
test('登录京麦独立入口:按钮 + 桥类型 + 分档引导', () => {
const page = readIfExists(
join(process.cwd(), 'src', 'pages', 'jd', 'JdCollectTab.vue'),
'JdCollectTab.vue',
)
assert.ok(page.includes('open_jd_login'), 'JdCollectTab.vue 必须经桥 open_jd_login')
assert.ok(page.includes('登录京麦'), '必须有「登录京麦」按钮(登录态失效后唯一稳定登录入口)')
assert.ok(page.includes('canLoginJd'), '老客户端(桥无该方法)置灰提示升级(与「同步分类」同口径)')
const bridge = readIfExists(
join(process.cwd(), 'src', 'shared', 'bridges', 'pywebview.ts'),
'pywebview.ts',
)
assert.ok(bridge.includes('open_jd_login'), 'pywebview.ts 必须登记 open_jd_login 桥类型')
const startAt = page.indexOf('async function openJdLogin')
assert.ok(startAt > 0, 'JdCollectTab.vue 缺 openJdLogin')
const endAt = page.indexOf('selectedShopCategories = computed', startAt)
assert.ok(endAt > startAt, 'openJdLogin 之后的锚点形状变了,请同步本判据')
const body = page.slice(startAt, endAt)
assert.ok(body.includes("code === 'jd_busy'") && body.includes("code === 'jd_login_running'")
&& body.includes("code === 'timeout'") && body.includes("code === 'window_closed'")
&& body.includes('noticeMessage.value'),
'busy/重入/超时/关窗都是设计内等待或可恢复,必须走 amber notice(超时档窗口还开着,不是失败)')
assert.ok(body.includes('successMessage.value'), '登录成功必须走绿色 success 展示')
assert.ok(body.includes('errorMessage.value = result?.error'), '仅 jd_page/未知失败走红色 error')
assert.ok(body.includes('LOGIN_UNAVAILABLE_NOTE'), '无桥必须给升级指引(与 SYNC_UNAVAILABLE_NOTE 同口径)')
const syncStart = page.indexOf('async function syncShopCategories')
const syncBody = page.slice(syncStart, page.indexOf('function clearShopCategories'))
assert.ok(syncBody.includes("code === 'jd_login'") && syncBody.includes('登录京麦'),
'「同步分类」遇 jd_login 必须引导点「登录京麦」(否则用户去登自己的浏览器=白登)')
})
test('推送失败的兜底提示走 notice 通道,不占红色 error', () => {
const page = readIfExists(
join(process.cwd(), 'src', 'pages', 'jd', 'JdCollectTab.vue'),