diff --git a/src/components/scan-diag-panel.vue b/src/components/scan-diag-panel.vue
new file mode 100644
index 0000000..aaf4c36
--- /dev/null
+++ b/src/components/scan-diag-panel.vue
@@ -0,0 +1,200 @@
+
+
+
+
+ 扫码诊断
+
+ 刷新
+ 复制
+ 清空
+ ×
+
+
+
+ {{ text }}
+
+
+
+
+
+
+
+
+
diff --git a/src/core/scan-diag.js b/src/core/scan-diag.js
new file mode 100644
index 0000000..59e8ed8
--- /dev/null
+++ b/src/core/scan-diag.js
@@ -0,0 +1,360 @@
+/**
+ * 扫码链路诊断(长时间运行可追踪)
+ *
+ * 背景:真机上「长时间使用后扫码没反应」这类问题无法现场复现,必须留下可事后追溯的证据链。
+ * 本模块提供三件事:
+ * 1. 事件环形缓冲 + 计数器(按键到达 / 各门控丢弃 / 自愈次数 / 成功识别),
+ * 节流持久化到 storage:应用被杀或重启后日志仍在(诊断面板或 storage 可读)。
+ * 2. 真机同步写 logcat(tag: WMSScan),release 包也能 `adb logcat -s WMSScan` 事后追踪。
+ * 3. 60 秒健康心跳:记录区间内按键数 / 丢弃增量 / 门控快照,
+ * 可精确定位「哪一分钟开始收不到按键」以及当时的门控状态。
+ *
+ * 约定:本模块只做记录,不做任何业务决策,任何异常都不得向上抛。
+ */
+
+const STORAGE_KEY = 'scanDiagLog:v1'
+const LOGCAT_TAG = 'WMSScan'
+// 内存中保留的事件条数
+const MAX_EVENTS = 300
+// 持久化到 storage 的事件条数(控制体积,约 10KB)
+const MAX_PERSIST_EVENTS = 160
+const PERSIST_THROTTLE_MS = 2000
+// 健康心跳间隔(心跳里带门控快照,是"何时开始不响应"的关键线索)
+const HEALTH_INTERVAL_MS = 60 * 1000
+// 同一丢弃原因的最小记录间隔(计数照常累加,避免刷屏)
+const DROP_LOG_MIN_INTERVAL_MS = 30 * 1000
+// 超过该空闲时长后恢复的第一下按键单独记一条 key-resume
+const KEY_RESUME_GAP_MS = 60 * 1000
+
+const state = {
+ scope: 'unknown',
+ startedAt: Date.now(),
+ events: [],
+ counters: { keys: 0, keysBySource: {}, flushes: 0, heals: 0, drops: {} },
+ gates: {},
+ prevCounters: null,
+ lastKeyAt: 0,
+ lastHealthAt: 0,
+ healthKeys: 0,
+ healthDrops: 0,
+ healthHeals: 0,
+ dropLoggedAt: {},
+ loaded: false,
+ persistedAt: 0,
+ persistTimer: null,
+ logcatClass: null,
+}
+
+// ---------- 基础工具 ----------
+
+function hasUni() {
+ return typeof uni !== 'undefined' && !!uni && typeof uni.setStorageSync === 'function'
+}
+
+function pad2(n) {
+ return String(n).padStart(2, '0')
+}
+
+function fmtClock(ts) {
+ const d = new Date(ts)
+ return `${pad2(d.getHours())}:${pad2(d.getMinutes())}:${pad2(d.getSeconds())}`
+}
+
+function fmtDuration(ms) {
+ const totalSec = Math.max(0, Math.floor(ms / 1000))
+ if (totalSec < 60) {
+ return `${totalSec}s`
+ }
+ const totalMin = Math.floor(totalSec / 60)
+ if (totalMin < 60) {
+ return `${totalMin}m${pad2(totalSec % 60)}s`
+ }
+ return `${Math.floor(totalMin / 60)}h${pad2(totalMin % 60)}m`
+}
+
+/** 只保留可读的轻量字段,避免把大对象写进日志 */
+function tidy(data) {
+ if (!data || typeof data !== 'object') {
+ return undefined
+ }
+ const out = {}
+ Object.keys(data).forEach((key) => {
+ const value = data[key]
+ if (value === undefined || value === null) {
+ return
+ }
+ const type = typeof value
+ if (type === 'number' || type === 'boolean' || type === 'string') {
+ out[key] = value
+ }
+ })
+ return Object.keys(out).length ? out : undefined
+}
+
+function dataText(data) {
+ const tidyData = tidy(data)
+ if (!tidyData) {
+ return ''
+ }
+ return (
+ ' ' +
+ Object.keys(tidyData)
+ .map((key) => `${key}=${tidyData[key]}`)
+ .join(' ')
+ )
+}
+
+function totalDrops() {
+ return Object.keys(state.counters.drops).reduce((sum, key) => sum + state.counters.drops[key], 0)
+}
+
+/** 真机同步写 logcat:release 包 console 不可见,只能靠 logcat 事后追踪 */
+function logcat(line) {
+ try {
+ if (typeof plus === 'undefined' || !plus || !plus.android) {
+ return
+ }
+ if (!state.logcatClass) {
+ state.logcatClass = plus.android.importClass('android.util.Log')
+ }
+ state.logcatClass.i(LOGCAT_TAG, String(line))
+ } catch (e) {
+ // 忽略:日志失败绝不影响业务
+ }
+}
+
+// ---------- 持久化 ----------
+
+function persistNow() {
+ if (!hasUni()) {
+ return
+ }
+ state.persistedAt = Date.now()
+ try {
+ uni.setStorageSync(STORAGE_KEY, {
+ v: 1,
+ savedAt: state.persistedAt,
+ scope: state.scope,
+ counters: state.counters,
+ gates: state.gates,
+ events: state.events.slice(-MAX_PERSIST_EVENTS),
+ })
+ } catch (e) {
+ // 忽略:存储失败不影响业务
+ }
+}
+
+function schedulePersist() {
+ if (state.persistTimer) {
+ return
+ }
+ const wait = Math.max(0, PERSIST_THROTTLE_MS - (Date.now() - state.persistedAt))
+ state.persistTimer = setTimeout(() => {
+ state.persistTimer = null
+ persistNow()
+ }, wait)
+}
+
+function load() {
+ if (state.loaded) {
+ return
+ }
+ state.loaded = true
+ if (!hasUni()) {
+ return
+ }
+ try {
+ const raw = uni.getStorageSync(STORAGE_KEY)
+ if (raw && typeof raw === 'object' && Array.isArray(raw.events)) {
+ state.events = raw.events
+ .filter((item) => item && item.t && item.msg)
+ .slice(-MAX_PERSIST_EVENTS)
+ if (raw.counters && typeof raw.counters === 'object') {
+ // 上次运行的累计值仅作参考,不并入本次计数
+ state.prevCounters = raw.counters
+ }
+ }
+ } catch (e) {
+ // 忽略
+ }
+}
+
+// ---------- 写入事件 ----------
+
+function push(kind, message, data) {
+ const entry = { t: Date.now(), kind, msg: `${message}${dataText(data)}` }
+ state.events.push(entry)
+ if (state.events.length > MAX_EVENTS) {
+ state.events.splice(0, state.events.length - MAX_EVENTS)
+ }
+ // 按键逐条记录会刷屏,只计数(key-resume 会单独 push)
+ if (kind !== 'key') {
+ logcat(`${fmtClock(entry.t)} [${kind}] ${entry.msg}`)
+ schedulePersist()
+ }
+ return entry
+}
+
+// ---------- 对外 API ----------
+
+/** 页面进入时声明作用域(同一 scope 重复调用不产生新标记) */
+export function diagBegin(scope) {
+ load()
+ const next = String(scope || 'unknown')
+ if (state.scope === next) {
+ return
+ }
+ state.scope = next
+ const prev = state.prevCounters
+ push('note', `session-start scope=${next}${prev ? ` 上次运行=${JSON.stringify(prev)}` : ''}`)
+}
+
+/** 更新门控快照(会随健康心跳一起落盘,是定位"为何没反应"的核心依据) */
+export function diagSetGates(gates) {
+ const tidyGates = tidy(gates)
+ if (!tidyGates) {
+ return
+ }
+ state.gates = Object.assign({}, state.gates, tidyGates)
+}
+
+/**
+ * 记录一次按键到达(在任何门控判断之前调用)。
+ * 用于区分「按键根本没到 JS」和「到了 JS 但被门控丢掉」。
+ */
+export function diagKey(source) {
+ const now = Date.now()
+ const gap = state.lastKeyAt ? now - state.lastKeyAt : 0
+ state.lastKeyAt = now
+ state.counters.keys += 1
+ const key = String(source || 'unknown')
+ state.counters.keysBySource[key] = (state.counters.keysBySource[key] || 0) + 1
+ if (gap > KEY_RESUME_GAP_MS) {
+ // 长时间无按键后的第一下:定位"卡住→恢复"的时间点
+ push('key', `key-resume source=${key} 空闲=${fmtDuration(gap)}`)
+ }
+}
+
+/** 记录一次被丢弃的按键(reason 区分门控,便于统计各原因占比) */
+export function diagDrop(reason, data) {
+ const key = String(reason || 'unknown')
+ state.counters.drops[key] = (state.counters.drops[key] || 0) + 1
+ const count = state.counters.drops[key]
+ const now = Date.now()
+ const last = state.dropLoggedAt[key] || 0
+ if (count === 1 || now - last >= DROP_LOG_MIN_INTERVAL_MS || count % 100 === 0) {
+ state.dropLoggedAt[key] = now
+ push('drop', `reason=${key} count=${count}`, data)
+ }
+}
+
+/** 记录一次成功识别出的扫码结果 */
+export function diagFlush(info) {
+ state.counters.flushes += 1
+ push('flush', `#${state.counters.flushes}`, info)
+}
+
+/** 记录一次自愈动作(事件类型锁重置 / 监听重挂等) */
+export function diagHeal(reason, data) {
+ state.counters.heals += 1
+ push('heal', `reason=${reason} count=${state.counters.heals}`, data)
+}
+
+/** 记录任意备注(生命周期、提交动作、状态切换等) */
+export function diagNote(name, data) {
+ load()
+ push('note', String(name || ''), data)
+}
+
+/** 健康心跳:默认 60s 一条,含区间按键数/丢弃增量/门控快照 */
+export function diagHeartbeat(force) {
+ const now = Date.now()
+ if (!force && now - state.lastHealthAt < HEALTH_INTERVAL_MS) {
+ return
+ }
+ const keys = state.counters.keys - state.healthKeys
+ const drops = totalDrops() - state.healthDrops
+ const heals = state.counters.heals - state.healthHeals
+ const idleAgo = state.lastKeyAt ? fmtDuration(now - state.lastKeyAt) : 'never'
+ state.lastHealthAt = now
+ state.healthKeys = state.counters.keys
+ state.healthDrops = totalDrops()
+ state.healthHeals = state.counters.heals
+ push(
+ 'health',
+ `keys=${keys} drops=${drops} heals=${heals} flush累计=${state.counters.flushes} 最近按键=${idleAgo}前`,
+ state.gates
+ )
+}
+
+/** 立即落盘(页面 onHide/onUnload 时调用,避免节流窗口内丢日志) */
+export function diagPersistNow() {
+ if (state.persistTimer) {
+ clearTimeout(state.persistTimer)
+ state.persistTimer = null
+ }
+ persistNow()
+}
+
+/** 结构化快照(面板/上报可用) */
+export function diagSnapshot() {
+ return {
+ scope: state.scope,
+ uptimeMs: Date.now() - state.startedAt,
+ counters: {
+ keys: state.counters.keys,
+ keysBySource: Object.assign({}, state.counters.keysBySource),
+ flushes: state.counters.flushes,
+ heals: state.counters.heals,
+ drops: Object.assign({}, state.counters.drops),
+ },
+ gates: Object.assign({}, state.gates),
+ lastKeyAgoMs: state.lastKeyAt ? Date.now() - state.lastKeyAt : null,
+ events: state.events.slice(),
+ }
+}
+
+/** 纯文本摘要(现场截图/复制即可上报,无需 adb) */
+export function diagText() {
+ const snapshot = diagSnapshot()
+ const lines = []
+ lines.push(
+ `【扫码诊断】scope=${snapshot.scope} 运行=${fmtDuration(snapshot.uptimeMs)} 现在=${fmtClock(Date.now())}`
+ )
+ lines.push(
+ `按键到达=${snapshot.counters.keys}` +
+ (snapshot.lastKeyAgoMs === null
+ ? '(本次运行还没收到任何按键)'
+ : `(最近一次 ${fmtDuration(snapshot.lastKeyAgoMs)} 前)`)
+ )
+ lines.push(`按键来源=${JSON.stringify(snapshot.counters.keysBySource)}`)
+ lines.push(`成功识别=${snapshot.counters.flushes} 自愈=${snapshot.counters.heals}`)
+ const dropKeys = Object.keys(snapshot.counters.drops)
+ lines.push(
+ `丢弃统计=${
+ dropKeys.length
+ ? dropKeys.map((key) => `${key}:${snapshot.counters.drops[key]}`).join(' ')
+ : '无'
+ }`
+ )
+ lines.push(`门控快照=${JSON.stringify(snapshot.gates)}`)
+ lines.push('---- 最近事件(新→旧) ----')
+ const events = snapshot.events
+ for (let i = events.length - 1; i >= 0 && i >= events.length - 80; i--) {
+ lines.push(`${fmtClock(events[i].t)} [${events[i].kind}] ${events[i].msg}`)
+ }
+ return lines.join('\n')
+}
+
+/** 清空日志(诊断面板手动清空,或问题确认消除后清空) */
+export function diagClear() {
+ state.events = []
+ state.counters = { keys: 0, keysBySource: {}, flushes: 0, heals: 0, drops: {} }
+ state.healthKeys = 0
+ state.healthDrops = 0
+ state.healthHeals = 0
+ state.lastHealthAt = 0
+ state.dropLoggedAt = {}
+ push('note', 'log-cleared')
+ diagPersistNow()
+}
diff --git a/src/core/scan.js b/src/core/scan.js
index 44c9bc4..a73c0a8 100644
--- a/src/core/scan.js
+++ b/src/core/scan.js
@@ -5,8 +5,33 @@
* - 页面通过 registerScanReceiver 注册接收;同一时刻仅一个接收者
* - Enter 或超时(380ms/420ms)flush;长度 < minLength 的码直接丢弃
* - setScanPaused(true) 暂停捕获(如账号/密码输入框聚焦时)
+ *
+ * 长时间运行可追踪(配合 src/core/scan-diag.js):
+ * - 任何按键到达 JS 先计数(diagKey),再按门控丢弃原因分类计数(diagDrop),
+ * 由此可区分「按键根本没到」与「到了但被门控丢掉」。
+ * - 空闲后自动重置事件类型锁、长时间无按键强制重挂监听(自愈)。
*/
+import {
+ diagKey,
+ diagDrop,
+ diagFlush,
+ diagHeal,
+ diagHeartbeat,
+ diagSetGates,
+ diagNote,
+ diagPersistNow,
+} from './scan-diag'
+
+// 空闲超过该时长后重新锁定 plus.key 实际生效的事件类型。
+// 根因:本机实测只投递 keyup,若某次运行时锁被设成 'keydown'(其它来源的合成/注入事件),
+// 之后所有真按键都会被事件类型过滤静默丢掉 → 表现为「扫着扫着彻底没反应」。
+const IDLE_LOCK_RESET_MS = 1200
+// 长时间(默认 10 分钟)没有任何按键到达时,强制重挂 plus/DOM 监听(防桥接回调静默失效)
+const LISTENER_REARM_IDLE_MS = 10 * 60 * 1000
+// 自愈心跳间隔
+const SELF_HEAL_INTERVAL_MS = 5000
+
// Android KeyEvent 符号键映射(KEYCODE_* → 字符)。
// 这些 keyCode 与 ASCII 字母/数字区间重叠,必须优先于 ASCII 分支判断,
// 否则 KEYCODE_EQUALS=70 会被 ASCII 的 [65..90] 分支误读为 'F'。
@@ -38,6 +63,10 @@ let timer = null
let domListenerAttached = false
let plusAttached = false
+let lastAnyKeyAt = 0 // 最近一次按键到达(含被门控丢弃的),用于空闲判定
+let rearmedForIdle = false // 本次空闲是否已重挂过监听(收到按键后复位)
+let selfHealTimer = null
+let selfHealStartedAt = 0
let plusKeyStyle = null // 'android' | 'ascii'
let plusShiftDown = false
let plusShiftPrev = false
@@ -85,10 +114,12 @@ function flush(trigger, source) {
// 少于最小长度的码直接丢弃(可能是键盘误按/短码)
if (code.length < minLength) {
+ diagDrop('too-short', { length: code.length, minLength, trigger, source })
debug('code-dropped', { reason: 'too-short', code, length: code.length, minLength, trigger, source })
return
}
+ diagFlush({ trigger, source, length: code.length, durationMs })
debug('flush-buffer', { code, length: code.length, durationMs, trigger, source })
if (receiver && typeof receiver.onScanCode === 'function') {
@@ -111,15 +142,31 @@ function appendChar(ch) {
timer = setTimeout(() => flush('timer', 'dom'), 380)
}
+/**
+ * 记录「按键到达 JS」这一事实(必须在任何门控判断之前调用)。
+ * 返回距上一次按键的空闲时长,供事件类型锁自愈使用。
+ */
+function markKeyArrival(source) {
+ const now = Date.now()
+ const gap = lastAnyKeyAt ? now - lastAnyKeyAt : 0
+ lastAnyKeyAt = now
+ rearmedForIdle = false
+ diagKey(source)
+ return gap
+}
+
// ---------- DOM(H5/Electron) ----------
function onDomKeydown(event) {
+ markKeyArrival('dom')
if (!receiver || paused) {
+ diagDrop(receiver ? 'paused' : 'no-receiver', { source: 'dom' })
return
}
const key = event?.key || ''
const isPrintable = key.length === 1
const isEnter = key === 'Enter'
if (!isPrintable && !isEnter) {
+ diagDrop('unmapped-dom-key', { key })
return
}
debug('key-captured', { key, paused })
@@ -239,7 +286,15 @@ function isPlusEnterKey(keyCode, text) {
}
function handlePlusKeyEvent(event, type) {
+ const gap = markKeyArrival('plus')
+ // 空闲后重新锁定实际生效的事件类型:自愈「锁错就永久静默」
+ if (plusKeyEventType && gap > IDLE_LOCK_RESET_MS) {
+ const locked = plusKeyEventType
+ plusKeyEventType = null
+ diagHeal('event-type-lock-idle-reset', { locked, gapMs: gap })
+ }
if (!receiver || paused) {
+ diagDrop(receiver ? 'paused' : 'no-receiver', { source: 'plus' })
return
}
const keyCode = Number((event && event.keyCode) || 0)
@@ -263,6 +318,7 @@ function handlePlusKeyEvent(event, type) {
plusShiftPrev = plusShiftDown
const isEnter = isPlusEnterKey(keyCode, text)
if (!text && !isEnter) {
+ diagDrop('unmapped-keycode', { keyCode, type })
return
}
@@ -271,6 +327,7 @@ function handlePlusKeyEvent(event, type) {
plusKeyEventType = type
}
if (plusKeyEventType !== type) {
+ diagDrop('event-type-locked', { keyCode, type, locked: plusKeyEventType })
return
}
@@ -304,6 +361,8 @@ function ensurePlusListener() {
plus.key.addEventListener('keydown', onPlusKeyDown)
plus.key.addEventListener('keyup', onPlusKeyUp)
plusAttached = true
+ diagNote('plus-listener-attached')
+ diagSetGates({ plusAttached: true })
debug('plus-listener-attached')
// #endif
}
@@ -322,6 +381,7 @@ function removePlusListener() {
plusKeyEventType = null
plusShiftDown = false
plusShiftPrev = false
+ diagSetGates({ plusAttached: false })
}
// ---------- 公共 API ----------
@@ -340,6 +400,8 @@ export function registerScanReceiver(next) {
if (receiver) {
ensureDomListener()
ensurePlusListener()
+ diagSetGates({ receiver: true, minLength })
+ diagNote('receiver-registered')
debug('receiver-registered')
}
}
@@ -354,11 +416,19 @@ export function unregisterScanReceiver(target) {
removeDomListener()
removePlusListener()
setScanPaused(false)
+ diagSetGates({ receiver: false, paused: false, buffer: 0 })
+ diagNote('receiver-unregistered')
}
/** 暂停/恢复捕获(账号/密码等输入框聚焦时暂停,并清空已缓冲的按键) */
export function setScanPaused(value) {
- paused = !!value
+ const next = !!value
+ if (paused !== next) {
+ // 暂停标志卡住是最常见的"扫码没反应"原因,必须留痕
+ diagNote('setScanPaused', { value: next })
+ }
+ paused = next
+ diagSetGates({ paused })
if (paused) {
resetBuffer()
} else {
@@ -371,6 +441,7 @@ export function setScanMinLength(value) {
const num = Number(value)
if (num >= 1) {
minLength = Math.floor(num)
+ diagSetGates({ minLength })
}
}
@@ -383,3 +454,59 @@ export function resetScanBuffer() {
export function getScanMinLength() {
return minLength
}
+
+/** 当前链路状态快照(诊断面板/日志用) */
+export function getScanDiagState() {
+ return {
+ paused,
+ receiver: !!receiver,
+ plusAttached,
+ eventTypeLock: plusKeyEventType,
+ minLength,
+ bufferLength: buffer.length,
+ lastKeyAgoMs: lastAnyKeyAt ? Date.now() - lastAnyKeyAt : null,
+ }
+}
+
+/**
+ * 启动扫码链路自愈心跳(页面 onShow/activated 调用,onHide/deactivated 停止)
+ * - 每 5s 刷新门控快照 + 输出健康心跳(内部按 60s 节流);
+ * - 空闲超过 10 分钟仍无任何按键时,强制重挂 plus/DOM 监听(防桥接回调静默失效)。
+ * 注意:仅在空闲时重挂,不会打断正在进行的扫码。
+ */
+export function startScanSelfHeal(intervalMs) {
+ if (selfHealTimer) {
+ return
+ }
+ const period = Number(intervalMs) > 0 ? Number(intervalMs) : SELF_HEAL_INTERVAL_MS
+ selfHealStartedAt = Date.now()
+ selfHealTimer = setInterval(() => {
+ // 从未收到过按键时以心跳启动时刻为基准,否则"一直收不到"的情况永远不会触发重挂
+ const idleMs = Date.now() - (lastAnyKeyAt || selfHealStartedAt)
+ diagSetGates({
+ paused,
+ receiver: !!receiver,
+ plusAttached,
+ eventTypeLock: plusKeyEventType || 'none',
+ idleSec: Math.round(idleMs / 1000),
+ })
+ if (receiver && idleMs > LISTENER_REARM_IDLE_MS && !rearmedForIdle) {
+ rearmedForIdle = true
+ removePlusListener()
+ removeDomListener()
+ ensurePlusListener()
+ ensureDomListener()
+ diagHeal('listener-rearmed-idle', { idleMs, hint: '长时间无按键,强制重挂监听' })
+ }
+ diagHeartbeat()
+ }, period)
+}
+
+/** 停止自愈心跳(页面 onHide/deactivated 调用) */
+export function stopScanSelfHeal() {
+ if (selfHealTimer) {
+ clearInterval(selfHealTimer)
+ selfHealTimer = null
+ }
+ diagPersistNow()
+}
diff --git a/src/pages/login/login.vue b/src/pages/login/login.vue
index fffbcdd..5534746 100644
--- a/src/pages/login/login.vue
+++ b/src/pages/login/login.vue
@@ -169,7 +169,10 @@ import {
unregisterScanReceiver,
setScanPaused,
resetScanBuffer,
+ startScanSelfHeal,
+ stopScanSelfHeal,
} from '@/core/scan'
+import { diagBegin, diagNote, diagPersistNow } from '@/core/scan-diag'
const qrBaseUrl = 'https://ye4s.wms.gztbyc.com/grcode/build?text='
const qrFallbackBaseUrl = 'https://api.qrserver.com/v1/create-qr-code/?size=280x280&data='
@@ -282,20 +285,27 @@ export default {
this.clearHiddenRefocusTimer()
this.clearAutoEnterPackTimer()
this.scanBadgeSubmitting = false
+ stopScanSelfHeal()
+ diagPersistNow()
},
onReady() {
this.pageActive = true
+ diagBegin('login')
+ diagNote('lifecycle', { hook: 'onReady' })
this.hasStoredWorkbench = !!uni.getStorageSync('workbench_token')
this.setupScanCaptureMode()
this.registerScanCapture()
+ startScanSelfHeal()
this.suppressSoftKeyboardBurst()
this.scheduleScanInputFocus(260)
this.checkAppUpdate()
},
onShow() {
this.pageActive = true
+ diagNote('lifecycle', { hook: 'onShow' })
this.setupScanCaptureMode()
this.registerScanCapture()
+ startScanSelfHeal()
this.suppressSoftKeyboardBurst()
this.scheduleScanInputFocus(320)
this.resumeWorkbenchFlow()
@@ -303,6 +313,7 @@ export default {
},
onHide() {
this.pageActive = false
+ diagNote('lifecycle', { hook: 'onHide' })
this.stopScanLongPolling()
this.stopWorkbenchLongPolling()
this.abortScanRequest()
@@ -318,6 +329,7 @@ export default {
this.clearAutoEnterPackTimer()
this.scanHiddenFocused = false
this.scanInputFocus = false
+ stopScanSelfHeal()
},
beforeUnmount() {
this.pageActive = false
@@ -338,6 +350,8 @@ export default {
this.scanBadgeSubmitting = false
this.scanHiddenFocused = false
this.scanInputFocus = false
+ stopScanSelfHeal()
+ diagPersistNow()
},
methods: {
isPageActive() {
diff --git a/src/pages/packaging/index.vue b/src/pages/packaging/index.vue
index d4f7077..155fc09 100644
--- a/src/pages/packaging/index.vue
+++ b/src/pages/packaging/index.vue
@@ -6,7 +6,7 @@
{{ workbenchInfo.name }}
- 打包模式
+ 打包模式
@@ -314,6 +314,9 @@
+
+
+
@@ -328,6 +331,18 @@ import {
packOrder,
finishPack,
} from '@/api/index'
+import ScanDiagPanel from '@/components/scan-diag-panel.vue'
+import {
+ diagBegin,
+ diagDrop,
+ diagFlush,
+ diagHeal,
+ diagHeartbeat,
+ diagKey,
+ diagNote,
+ diagPersistNow,
+ diagSetGates,
+} from '@/core/scan-diag'
// 扫码枪识别参数(广播扫描:扫码枪为键盘 HID 设备,按键事件全局广播)
// 无回车结束符时:停止输入超过该毫秒数视为一次完整扫码,自动提交
@@ -359,6 +374,10 @@ const ANDROID_PUNCT_MAP = {
const MEMBER_STORAGE_KEY = 'workbenchMember'
// 扫描记录本地缓存 key(最多 50 条,出入栈:最新在前、超限丢最旧)
const SCAN_RECORDS_STORAGE_KEY = 'packScanRecords'
+// 空闲超过该时长后重新锁定 plus.key 实际生效的事件类型(自愈「锁错就永久静默」)
+const SCAN_IDLE_LOCK_RESET_MS = 1200
+// 长时间(默认 10 分钟)无任何按键到达时强制重挂监听(防桥接回调静默失效)
+const SCAN_LISTENER_REARM_IDLE_MS = 10 * 60 * 1000
// 无新打包任务自动退出:超过该时长(毫秒)自动登出所有成员并结束最后打包任务
const IDLE_AUTO_LOGOUT_MS = 30 * 60 * 1000
// 语音播报:HTTP 语音接口(参考 WMS_PDA voice.js,不依赖平板系统中文语音包)
@@ -367,6 +386,7 @@ const VOICE_API_PATH = 'http://tbdata.gztbyc.com'
export default {
name: 'PackagingPage',
+ components: { ScanDiagPanel },
data() {
return {
workbenchInfo: null,
@@ -425,6 +445,13 @@ export default {
scanInputIdleTimer: null,
lastSubmittedScan: { code: '', at: 0 },
lastScannedCode: '',
+ // ---- 长时间运行可追踪/自愈 ----
+ lastScanKeyArrivedAt: 0, // 最近一次按键到达(任何门控之前)
+ scanRearmedForIdle: false, // 本次空闲是否已重挂过监听(收到按键后复位)
+ scanWatchdogStartedAt: 0, // 看门狗启动时刻(从未收到按键时的空闲基线)
+ diagPanelVisible: false,
+ diagTitleTapAt: 0,
+ diagTitleTapCount: 0,
// ---- 绑定操作员(工作台成员)----
operatorDialogVisible: false,
badgeHandling: false,
@@ -590,6 +617,8 @@ export default {
// #ifdef APP-PLUS
plus.android.importClass('android.util.Log').i('WMSPage', 'onLoad')
// #endif
+ diagBegin('packaging')
+ diagNote('lifecycle', { hook: 'onLoad' })
// 简单守卫:无 token 时回到登录页
if (!uni.getStorageSync('token')) {
uni.reLaunch({
@@ -613,6 +642,7 @@ export default {
// #ifdef APP-PLUS
plus.android.importClass('android.util.Log').i('WMSPage', 'onShow')
// #endif
+ diagNote('lifecycle', { hook: 'onShow' })
try {
this.pageActive = true
this.lockLandscape()
@@ -640,6 +670,9 @@ export default {
this.removeGlobalKeyboardListener()
this.clearScanTimers()
this.clearIdleAutoLogoutTimer()
+ diagNote('lifecycle', { hook: 'onHide' })
+ diagSetGates({ pageActive: false })
+ diagPersistNow()
},
methods: {
// 强制锁定横屏 + 全屏重排:
@@ -1827,7 +1860,9 @@ export default {
* 回车且有内容时立即提交;无回车结束符则静默防抖自动提交。
*/
handleGlobalKeydown(event) {
+ this.markScanKeyArrived('dom')
if (!this.isPageActive()) {
+ diagDrop('page-inactive', { source: 'dom' })
return
}
const key = event.key || ''
@@ -1891,7 +1926,10 @@ export default {
return
}
if (this.isLikelyScannerCode(code, durationMs, true)) {
+ diagFlush({ trigger: 'enter', source: 'dom', length: code.length, durationMs })
this.submitScanCode(code, 'dom')
+ } else {
+ diagDrop('dom-not-scanner-code', { length: code.length, durationMs, trigger: 'enter' })
}
},
touchScanInput() {
@@ -1957,15 +1995,30 @@ export default {
},
// 看门狗:即使 onShow 异常未触发也能自愈恢复扫码。
// App/H5 页面隐藏或后台时收不到按键,所以 pageActive=true 不会误处理。
+ // 长时间运行自愈:
+ // 1) 空闲超过 10 分钟无任何按键 → 强制重挂 plus/DOM 监听(防桥接回调静默失效);
+ // 2) 每次心跳刷新门控快照 + 触发 60s 健康心跳,事后可定位「哪一分钟开始收不到按键」。
startScanWatchdog() {
if (this.scanWatchdogTimer) {
return
}
+ this.scanWatchdogStartedAt = Date.now()
this.scanWatchdogTimer = setInterval(() => {
this.pageActive = true
this.attachPlusKeyboardListener()
this.attachGlobalKeyboardListener()
this.ensureScanInputFocus()
+ this.maybeRearmScanListenersWhenIdle()
+ diagSetGates({
+ pageActive: this.pageActive !== false,
+ plusListener: !!(this.plusKeyListener || this.plusKeyUpListener),
+ domListener: !!this.globalKeyListener,
+ eventTypeLock: this._plusKeyEventType || 'none',
+ idleSec: this.lastScanKeyArrivedAt
+ ? Math.round((Date.now() - this.lastScanKeyArrivedAt) / 1000)
+ : 0,
+ })
+ diagHeartbeat()
}, 2000)
},
stopScanWatchdog() {
@@ -1974,6 +2027,52 @@ export default {
this.scanWatchdogTimer = null
}
},
+ /** 记录「按键到达 JS」(任何门控之前调用),返回距上次按键的空闲时长 */
+ markScanKeyArrived(source) {
+ const now = Date.now()
+ const gap = this.lastScanKeyArrivedAt ? now - this.lastScanKeyArrivedAt : 0
+ this.lastScanKeyArrivedAt = now
+ this.scanRearmedForIdle = false
+ diagKey(source)
+ return gap
+ },
+ /**
+ * 空闲(默认 10 分钟无任何按键)时强制重挂监听:
+ * 只在空闲时执行,不会打断正在进行的扫码;
+ * 用于兜住「监听器还在、但桥接回调不再投递按键」这类长时间运行才出现的静默失效。
+ */
+ maybeRearmScanListenersWhenIdle() {
+ if (this.scanRearmedForIdle) {
+ return
+ }
+ // 从未收到过按键时以看门狗启动时刻为基准,否则"一直收不到"永远不会触发重挂
+ const baseline = this.lastScanKeyArrivedAt || this.scanWatchdogStartedAt || Date.now()
+ const idleMs = Date.now() - baseline
+ if (idleMs < SCAN_LISTENER_REARM_IDLE_MS) {
+ return
+ }
+ this.scanRearmedForIdle = true
+ this.removePlusKeyboardListener()
+ this.removeGlobalKeyboardListener()
+ this.attachPlusKeyboardListener()
+ this.attachGlobalKeyboardListener()
+ diagHeal('listener-rearmed-idle', { idleMs, hint: '长时间无按键,强制重挂监听' })
+ console.log('[packaging][scan] 已重挂扫码监听(空闲)', idleMs)
+ },
+ /** 诊断面板隐藏入口:3 秒内连点标题 5 次(操作员不会误触) */
+ handleDiagTitleTap() {
+ const now = Date.now()
+ if (now - this.diagTitleTapAt > 3000) {
+ this.diagTitleTapCount = 0
+ }
+ this.diagTitleTapAt = now
+ this.diagTitleTapCount += 1
+ if (this.diagTitleTapCount >= 5) {
+ this.diagTitleTapCount = 0
+ this.diagPanelVisible = true
+ diagNote('diag-panel-opened')
+ }
+ },
isRealDevice() {
// #ifdef APP-PLUS
return true
@@ -2040,7 +2139,10 @@ export default {
return
}
if (this.isLikelyScannerCode(code, durationMs, false)) {
+ diagFlush({ trigger: 'timer', source: 'dom', length: code.length, durationMs })
this.submitScanCode(code, 'dom')
+ } else {
+ diagDrop('dom-not-scanner-code', { length: code.length, durationMs })
}
},
attachGlobalKeyboardListener() {
@@ -2170,7 +2272,16 @@ export default {
},
// 统一处理 plus.key 按键(keydown / keyup)
handlePlusKeyEvent(event, type) {
+ // 先记录「按键到达 JS」这一事实(任何门控之前),用于区分「按键根本没到」与「到了被门控丢掉」
+ const gap = this.markScanKeyArrived('plus')
+ // 空闲后重新锁定实际生效的事件类型:自愈「锁错就永久静默」
+ if (this._plusKeyEventType && gap > SCAN_IDLE_LOCK_RESET_MS) {
+ const locked = this._plusKeyEventType
+ this._plusKeyEventType = null
+ diagHeal('event-type-lock-idle-reset', { locked, gapMs: gap })
+ }
if (!this.isPageActive()) {
+ diagDrop('page-inactive', { source: 'plus' })
return
}
const keyCode = Number((event && event.keyCode) || 0)
@@ -2194,6 +2305,7 @@ export default {
this._plusShiftPrev = this._plusShiftDown
const isEnter = this.isPlusEnterKey(keyCode, text)
if (!text && !isEnter) {
+ diagDrop('unmapped-keycode', { keyCode, type })
return
}
@@ -2202,6 +2314,7 @@ export default {
this._plusKeyEventType = type
}
if (this._plusKeyEventType !== type) {
+ diagDrop('event-type-locked', { keyCode, type, locked: this._plusKeyEventType })
return
}
@@ -2242,9 +2355,13 @@ export default {
},
flushPlusKeyBuffer(trigger = 'timer') {
if (!this.isPageActive()) {
+ diagDrop('page-inactive-flush', { source: 'plus', trigger })
return
}
const code = (this.plusKeyBuffer || '').trim()
+ const durationMs = this.plusKeyStartedAt
+ ? Math.max(0, (this.plusKeyLastAt || Date.now()) - this.plusKeyStartedAt)
+ : 0
this.plusKeyBuffer = ''
this.plusKeyStartedAt = 0
this.plusKeyLastAt = 0
@@ -2252,6 +2369,7 @@ export default {
if (!code) {
return
}
+ diagFlush({ trigger, source: 'plus', length: code.length, durationMs })
console.log('[packaging][scan] plus-buffer trigger =', trigger, 'code =', code)
this.submitScanCode(code, 'plus')
},
@@ -2490,6 +2608,7 @@ export default {
},
submitScanCode(code, source) {
if (!this.isPageActive()) {
+ diagDrop('page-inactive-submit', { source })
return
}
const trimmed = this.dedupeRepeatedScan((code || '').trim())
@@ -2502,9 +2621,11 @@ export default {
this.lastSubmittedScan.code === trimmed &&
now - this.lastSubmittedScan.at < 600
) {
+ diagDrop('dedupe-same-code', { source, length: trimmed.length })
return
}
this.lastSubmittedScan = { code: trimmed, at: now }
+ diagNote('submit-scan', { source, length: trimmed.length })
console.log('[packaging][scan] submitScanCode source =', source, 'code =', trimmed)
// 操作员弹窗打开时:弹窗已无输入框,关闭弹窗后扫码内容走主流程
if (this.operatorDialogVisible) {
diff --git a/src/pages/returns/index.vue b/src/pages/returns/index.vue
index 879e03b..ea941c0 100644
--- a/src/pages/returns/index.vue
+++ b/src/pages/returns/index.vue
@@ -7,7 +7,7 @@
- 拆包工作台
+ 拆包工作台
@@ -408,6 +408,9 @@
@confirm="handleHiddenScanConfirm"
@blur="handleHiddenScanBlur"
/>
+
+
+
@@ -438,7 +441,9 @@ import {
cameraServerDetail,
getLiveStreamUrl,
} from '@/api/camera'
-import { registerScanReceiver, unregisterScanReceiver, setScanPaused, setScanMinLength } from '@/core/scan'
+import { registerScanReceiver, unregisterScanReceiver, setScanPaused, setScanMinLength, startScanSelfHeal, stopScanSelfHeal } from '@/core/scan'
+import ScanDiagPanel from '@/components/scan-diag-panel.vue'
+import { diagBegin, diagDrop, diagNote, diagPersistNow } from '@/core/scan-diag'
// ==================== 扫码指令定义(与散单 Web 端 scan-commands.ts 一致) ====================
// 制式 Code 128,内容为简单单词,识别时 trim + 忽略大小写,与商品条码(纯数字)零冲突
@@ -485,6 +490,7 @@ export default {
name: 'ReturnsPage',
components: {
TopNav,
+ ScanDiagPanel,
},
props: {
// 在布局壳内渲染时为 true,隐藏内嵌顶栏;独立访问时不传,显示顶栏
@@ -572,6 +578,10 @@ export default {
// 扫码捕获状态
pageActive: false,
modalBusy: false,
+ // 诊断面板(隐藏入口:3 秒内连点标题 5 次)
+ diagPanelVisible: false,
+ diagTitleTapAt: 0,
+ diagTitleTapCount: 0,
scanHiddenFocused: false,
scanInputFocus: false,
scanHiddenValue: '',
@@ -722,8 +732,11 @@ export default {
},
onShow() {
this.pageActive = true
+ diagBegin('returns')
+ diagNote('lifecycle', { hook: 'onShow' })
this.registerScanCapture()
this.resumePreviewIfNeeded()
+ startScanSelfHeal()
// APP:保持隐藏 input 聚焦(WebView 不聚焦不派发按键);H5 全局 DOM 监听无需焦点
// #ifdef APP-PLUS
this.requestScanFocus()
@@ -731,31 +744,41 @@ export default {
},
onHide() {
this.pageActive = false
+ diagNote('lifecycle', { hook: 'onHide' })
this.unregisterScanCapture()
this.clearScanTimers()
this.stopPreviewStream()
+ stopScanSelfHeal()
},
onUnload() {
this.pageActive = false
+ diagNote('lifecycle', { hook: 'onUnload' })
this.unregisterScanCapture()
this.clearScanTimers()
this.stopPreviewStream()
+ stopScanSelfHeal()
+ diagPersistNow()
},
// keep-alive 内嵌模式(外壳菜单切换):页面级 onShow/onHide 不会触发,
// 扫码捕获必须挂在 keep-alive 的 activated/deactivated 上(与订单复核页一致)
activated() {
this.pageActive = true
+ diagBegin('returns')
+ diagNote('lifecycle', { hook: 'activated' })
this.registerScanCapture()
this.resumePreviewIfNeeded()
+ startScanSelfHeal()
// #ifdef APP-PLUS
this.requestScanFocus()
// #endif
},
deactivated() {
this.pageActive = false
+ diagNote('lifecycle', { hook: 'deactivated' })
this.unregisterScanCapture()
this.clearScanTimers()
this.stopPreviewStream()
+ stopScanSelfHeal()
},
methods: {
// ==================== 通用 ====================
@@ -849,11 +872,29 @@ export default {
return this.pageActive
},
+ /** 诊断面板隐藏入口:3 秒内连点标题 5 次(操作员不会误触) */
+ handleDiagTitleTap() {
+ const now = Date.now()
+ if (now - this.diagTitleTapAt > 3000) {
+ this.diagTitleTapCount = 0
+ }
+ this.diagTitleTapAt = now
+ this.diagTitleTapCount += 1
+ if (this.diagTitleTapCount >= 5) {
+ this.diagTitleTapCount = 0
+ this.diagPanelVisible = true
+ diagNote('diag-panel-opened')
+ }
+ },
+
registerScanCapture() {
setScanMinLength(SCAN_MIN_LENGTH)
registerScanReceiver({
onScanCode: (code, meta) => {
- if (!this.isPageActive()) return
+ if (!this.isPageActive()) {
+ diagDrop('page-inactive-receiver', { source: 'receiver' })
+ return
+ }
this.handleScanCode(code, meta)
},
onScanDebug: (...args) => {