120 lines
5.2 KiB
JavaScript
120 lines
5.2 KiB
JavaScript
/**
|
||
* dsh-better-chat 客户端:让审批卡片的回车 / Esc 不再挑焦点。
|
||
*
|
||
* 背景(DSH 0.2.2-rc.1 的 @deepseek-ai/dsh-client-ui-approval):
|
||
* 官方审批卡自带键盘处理 —— Enter 批准(单次)、Esc 拒绝 —— 但它的
|
||
* keydown 挂在卡片根节点上,且要求焦点先落在卡片内。审批弹出时焦点
|
||
* 往往还在对话区/页面主体上,按回车毫无反应,必须先点一下卡片。
|
||
*
|
||
* 本模块补两件事,不改官方任何逻辑:
|
||
* 1. 审批卡出现时,若用户没有正在别处输入,把焦点送进卡片的详情区
|
||
* ([data-approval-scroll],本身 tabIndex=0),官方处理立即生效。
|
||
* 2. 焦点不在卡片内时兜底路由:在 document 捕获阶段监听 keydown,
|
||
* 满足全部防误触条件时,点击卡片操作行里的按钮 —— 顺序由官方渲染
|
||
* 固定为 [拒绝, 允许(单次), 始终允许?],回车点「允许(单次)」,
|
||
* 永远不会误触「始终允许」;Esc 点「拒绝」。
|
||
*
|
||
* 防误触(与官方卡片内部规则对齐):
|
||
* - 正在任何输入控件(input/textarea/select/contenteditable)里打字 → 不管
|
||
* - 焦点已在卡片内 → 官方处理,绝不重复作答
|
||
* - 带 Ctrl/Meta/Alt/Shift、长按连发、输入法组词中 → 不管
|
||
* - 回车落在某个按钮/链接上 → 保留那个按钮自己的回车行为
|
||
* - 卡片已作答(aria-busy=true)或按钮禁用 → 不管
|
||
*/
|
||
|
||
const CARD_SELECTOR = '[data-approval-key]'
|
||
const SCROLL_SELECTOR = '[data-approval-scroll]'
|
||
const EDITABLE_SELECTOR = 'input, textarea, select, [contenteditable="true"], [contenteditable=""]'
|
||
|
||
/** 卡片操作行的按钮:详情滚动区之外的全部按钮,顺序 [拒绝, 允许, 始终允许?]。 */
|
||
export function actionButtons(card) {
|
||
return [...card.querySelectorAll('button')].filter((b) => !b.closest(SCROLL_SELECTOR))
|
||
}
|
||
|
||
/** 找当前可作答的审批卡(DOM 顺序第一张未作答、按钮齐全的卡)。 */
|
||
export function findPendingCard(doc) {
|
||
for (const card of doc.querySelectorAll(CARD_SELECTOR)) {
|
||
if (card.getAttribute('aria-busy') === 'true') continue
|
||
const buttons = actionButtons(card)
|
||
if (buttons.length >= 2 && !buttons[0].disabled && !buttons[1].disabled) return card
|
||
}
|
||
return null
|
||
}
|
||
|
||
/**
|
||
* 纯判定:这次 keydown 是否应该路由到审批卡。
|
||
* @returns {'allow'|'reject'|null}
|
||
*/
|
||
export function decideKeyAction(input) {
|
||
const { key, ctrlKey, metaKey, altKey, shiftKey, repeat, isComposing, keyCode, defaultPrevented, target, activeElement, card } = input
|
||
if (!card) return null
|
||
if (defaultPrevented) return null
|
||
if (key !== 'Enter' && key !== 'Escape') return null
|
||
if (ctrlKey || metaKey || altKey || shiftKey) return null
|
||
if (repeat || isComposing || keyCode === 229) return null
|
||
if (activeElement && card.contains(activeElement)) return null // 焦点在卡内:官方处理
|
||
if (target && typeof target.closest === 'function') {
|
||
if (target.closest(EDITABLE_SELECTOR) !== null) return null // 正在别处输入
|
||
if (key === 'Enter' && target.closest('button, a[href], [role="button"]') !== null) return null
|
||
}
|
||
return key === 'Enter' ? 'allow' : 'reject'
|
||
}
|
||
|
||
/** 纯判定:审批卡出现时是否应该把焦点送进详情区。 */
|
||
export function shouldAutoFocus(activeElement, card) {
|
||
if (!activeElement) return true
|
||
if (activeElement === card.ownerDocument?.body) return true
|
||
if (card.contains(activeElement)) return false // 已经在卡里
|
||
if (typeof activeElement.closest === 'function' && activeElement.closest(EDITABLE_SELECTOR) !== null) return false // 正在别处输入
|
||
return true
|
||
}
|
||
|
||
function install(doc) {
|
||
const focusedCards = new WeakSet()
|
||
|
||
const tryAutoFocus = () => {
|
||
const card = findPendingCard(doc)
|
||
if (!card || focusedCards.has(card)) return
|
||
focusedCards.add(card)
|
||
if (!shouldAutoFocus(doc.activeElement, card)) return
|
||
const region = card.querySelector(SCROLL_SELECTOR)
|
||
if (region && typeof region.focus === 'function') region.focus()
|
||
}
|
||
|
||
const observer = new MutationObserver(tryAutoFocus)
|
||
observer.observe(doc.documentElement, { childList: true, subtree: true })
|
||
tryAutoFocus()
|
||
|
||
const onKeyDown = (event) => {
|
||
const card = findPendingCard(doc)
|
||
const action = decideKeyAction({
|
||
key: event.key,
|
||
ctrlKey: event.ctrlKey, metaKey: event.metaKey, altKey: event.altKey, shiftKey: event.shiftKey,
|
||
repeat: event.repeat, isComposing: event.isComposing, keyCode: event.keyCode,
|
||
defaultPrevented: event.defaultPrevented,
|
||
target: event.target, activeElement: doc.activeElement, card,
|
||
})
|
||
if (!action) return
|
||
const buttons = actionButtons(card)
|
||
const button = action === 'allow' ? buttons[1] : buttons[0]
|
||
if (!button || button.disabled) return
|
||
event.preventDefault()
|
||
event.stopPropagation()
|
||
button.click()
|
||
}
|
||
doc.addEventListener('keydown', onKeyDown, true)
|
||
|
||
return () => {
|
||
observer.disconnect()
|
||
doc.removeEventListener('keydown', onKeyDown, true)
|
||
}
|
||
}
|
||
|
||
/** 本插件不需要任何客户端服务。 */
|
||
export const inject = []
|
||
|
||
/** 插件主体:挂载审批快捷键增强,卸载时完整摘除。 */
|
||
export function apply(ctx) {
|
||
ctx.effect(() => install(document), 'dsh-better-chat: approval enter/esc routing')
|
||
}
|