@guowenzhang/dsh-pocket 0.0.0-stage → 2.12.2

package/client/mobile/nav-targets.mjs

@@ -0,0 +1,117 @@
+// 抽屉点击规则的判定常量与纯函数 —— 抽成独立 ESM 模块，好让 node 测试直接
+// 引入（client 侧是 esbuild 打进 bundle 的，测试里没有 DOM 可用）。
+
+/**
+ * 抽屉本体（宿主自带抽屉的版本，DSH 0.2.2 起）：AppFrame 内部结构变了——
+ * 宽 < 768 时宿主自己把侧边栏列拉成抽屉，并在第一个网格位置插入一个
+ * `drawerMask`（点它关闭抽屉的全屏遮罩）。所以「第一个子元素」不再等于侧边栏，
+ * 只能按列名找：CSS Module 的哈希前缀每次构建都变，后缀 `_sidebarCol` 稳定。
+ * @type {string}
+ */
+export const DRAWER_COLUMN_SELECTOR = '[data-mobile-nav="frame"] > [class$="_sidebarCol"]'
+
+/**
+ * 抽屉本体的旧口径：没有自带抽屉的宿主里，第一个网格子元素就是侧边栏列。
+ * @type {string}
+ */
+export const LEGACY_DRAWER_SELECTOR = '[data-mobile-nav="frame"] > :first-child'
+
+/**
+ * 当前页面的抽屉根节点：优先按列名找（新宿主），找不到再退回第一个子元素
+ * （老宿主）。两代结构都在用，不能只留一条选择器。
+ * @param {Document | Element | null} [root] - 查询根，默认当前 document。
+ * @returns {Element | null} 抽屉根节点。
+ */
+export function findDrawer(root) {
+  const scope = root ?? (typeof document === 'undefined' ? null : document)
+  if (scope === null || typeof scope.querySelector !== 'function') return null
+  return scope.querySelector(DRAWER_COLUMN_SELECTOR) ?? scope.querySelector(LEGACY_DRAWER_SELECTOR)
+}
+
+/**
+ * 宿主是否自带移动端抽屉（0.2.2 起）。自带时网格改写、抽屉定位、点外部关闭
+ * 全部交给宿主，插件再插手就是两套抽屉打架。
+ * @param {Element | null} frame - AppFrame 元素。
+ * @returns {boolean}
+ */
+export function hasNativeDrawer(frame) {
+  if (frame == null || typeof frame.hasAttribute !== 'function') return false
+  return frame.hasAttribute('data-sidebar-drawer')
+}
+
+/** 抽屉开关（会话头部那颗按钮）——点它不该被"点抽屉外就关"二次触发。 */
+export const TOGGLE_SELECTOR = '[data-mobile-nav="toggle"]'
+
+/**
+ * 命中即视为导航的行：点它们要把屏幕让给刚打开的内容，所以顺带关抽屉。
+ *
+ * 类名现状（2026-08，侧边栏 qDHVXG_* / YDXeBa_* 这一代）：
+ * - `YDXeBa_sessionRow`  会话行 —— 命中 [class*="sessionRow"]
+ * - `YDXeBa_projectRow`  工作区行 —— **故意不收**：实测它是折叠/展开开关
+ *   （aria-expanded 来回翻，会话列表显隐），不是导航。收进来会让每次展开
+ *   工作区都把抽屉关掉（issue #72）。
+ * 旧一代侧边栏的 `_searchResultWorkspace_` / `_searchResultRow_` 保留，兼容
+ * 尚未升级的宿主。
+ *
+ * @type {string}
+ */
+export const NAV_TARGETS = [
+  'button[data-dsh-taskboard-entry]',
+  'button[data-dsh-ssh-entry]',
+  // 抽屉底部的 "文件" 入口打开的是 dsh-web-ui 的 explorer 面板，它的 z-index
+  // (55) 低于展开的抽屉 (600)，且在抽屉 DOM 之外：抽屉不关就会盖住面板，点
+  // 面板里的行又会被"点抽屉外就关"吃掉。所以按导航处理，一起关掉。
+  '[data-mobile-nav="files"]',
+  '[class*="sessionRow"]',
+  '[class*="newSession"]',
+  '[class*="searchResultWorkspace"]',
+  '[class*="searchResultRow"]',
+].join(', ')
+
+/**
+ * 行内操作按钮（会话行的 kebab：重命名 / 删除）——点开的是菜单不是内容，
+ * 不能按导航处理，否则抽屉一关，刚弹出的菜单跟着没了。
+ * @type {string}
+ */
+export const NAV_EXCLUDE = '[class*="sessionRow"] button'
+
+/**
+ * 浮层（portal 到 body 的下拉菜单 / 弹窗）。
+ *
+ * 抽屉里的控件（工作区区块的"视图选项"、"添加工作区"，会话行的 kebab…）
+ * 弹出的菜单在 DOM 上属于 body，不在抽屉里。"点抽屉外就关"因此会把菜单项
+ * 的第一下点击吃掉：抽屉先滑走 → 菜单随侧边栏卸载 → 菜单项的 onClick 永远
+ * 不执行。手机上表现就是工作区相关菜单"点了没反应"（issue #72）。
+ *
+ * 落在浮层内的点击一律豁免，交给浮层自己收尾。
+ *
+ * @type {string}
+ */
+export const OVERLAY_SELECTOR = [
+  '[role="menu"]',
+  '[role="listbox"]',
+  '[role="dialog"]',
+  '[role="tooltip"]',
+  '[data-radix-popper-content-wrapper]',
+].join(', ')
+
+/**
+ * 抽屉内一次点击是否算导航（应关抽屉）。命中 NAV_EXCLUDE 的行内按钮不算。
+ * @param {Element | null | undefined} target - 点击目标。
+ * @returns {Element | null} 命中的导航行，未命中返回 null。
+ */
+export function navTargetFor(target) {
+  if (target == null || typeof target.closest !== 'function') return null
+  if (target.closest(NAV_EXCLUDE) !== null) return null
+  return target.closest(NAV_TARGETS)
+}
+
+/**
+ * 一次点击是否落在浮层内（浮层自己会关闭，不该由抽屉规则接管）。
+ * @param {Element | null | undefined} target - 点击目标。
+ * @returns {boolean}
+ */
+export function isOverlayTap(target) {
+  if (target == null || typeof target.closest !== 'function') return false
+  return target.closest(OVERLAY_SELECTOR) !== null
+}

package/client/pocket-locales.js

@@ -0,0 +1,165 @@
+// dsh-pocket 设置页签 i18n 词典（与 client/mobile/locales.ts 同款：zh 为源真，en 为译文）。
+// 需要新增字符串时：先加到 zh（key-set 唯一来源），再补 en（key 必须与 zh 完全一致）。
+export const NS = 'pocket'
+
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export const zh = {
+  'section': '手机访问',
+  'title': '📱 手机访问',
+  'subtitle': '手机扫码打开的就是电脑上的这个界面，实时同步',
+  'restarted': '🔄 已重启',
+  'ok': '知道了',
+  'bgHint': '进程在后台运行（不挂终端）。如需停止：{cmd}',
+  'wanAccess': '公网访问',
+  'pinLabel': '访问密码',
+  'modeLabel': '地址模式',
+  'advAddress': '高级 · 手动选地址',
+  'wanOffHint': '开启后可从任何网络访问（每次开启需确认免责声明）',
+  'resetFactory': '🧹 恢复出厂设置',
+  'resetGo': '恢复',
+  'resetIntro': '设置搞出问题时的临时兜底：清空本机配置并重设随机密码（DSH 的会话、模型、插件配置不受影响）',
+  'resetTitle': '⚠️ 确认恢复出厂设置？',
+  'resetBody': '将清空并恢复默认：\n① 开关：局域网访问=开、访问密码=开、手机端右边栏=开、局域网地址=自动\n② 公网：模式回到随机域名，清空 Tunnel Token 与固定域名，并关闭正在运行的公网\n③ 密码：公网和局域网都换成新的随机 8 位密码（旧密码立即作废，手机需重新输入）\n\nDSH 自身的会话、模型、插件配置不受影响；此操作不可撤销。',
+  'resetConfirm': '确认恢复',
+  'resetDone': '✅ 已恢复出厂设置：设置已清空，密码已换新（手机需重新输入）',
+  'resetFailed': '❌ 恢复失败，请重试',
+  'lanTitle': '📶 局域网（同一 WiFi）',
+  'lanHint': '手机连接同一 WiFi 后扫码即可打开',
+  'lanAccess': '局域网访问',
+  'lanDisabledHint': '🔒 局域网访问已关闭：手机扫码/链接均不可用（公网不受影响）。点「开」恢复。',
+  'lanToggleTitleOff': '关闭局域网访问',
+  'lanToggleBodyOff': '关闭后，同一 WiFi 下的手机将无法扫码访问（局域网二维码/链接立即失效）。公网访问不受影响。确定关闭？',
+  'lanToggleTitleOn': '开启局域网访问',
+  'lanToggleBodyOn': '开启后，同一 WiFi 的手机扫码即可访问（默认需输入局域网密码）。确定开启？',
+  'confirm': '确定',
+  'lanAddress': '局域网地址',
+  'lanAddressAuto': '自动（推荐）',
+  'lanPin': '局域网访问密码',
+  'on': '开',
+  'off': '关',
+  'lanPinValue': '🔐 访问密码：{pin}（手机打开需输入；与公网密码分开）',
+  'lanPinCustomValue': '🔐 访问密码：{pin}（自定义；手机打开需输入）',
+  'refresh': '刷新',
+  'customize': '自定义',
+  'customizing': '新密码（8–64 位，英文字母或数字）：',
+  'save': '保存',
+  'cancel': '取消',
+  'pinInvalid': '密码必须是 8–64 位英文字母或数字',
+  'pinCustomHint': '自定义后开启公网不再自动换新',
+  'lanPinOff': '🔓 密码已关闭：扫码直连，无需密码（仅同一局域网设备可访问；公网仍要密码）',
+  'lanStarting': '代理未就绪…',
+  'mobileRightbar': '手机端右边栏',
+  'mobileRightbarHint': '显示原生右边栏入口；普通手机可按需关闭，折叠屏展开后使用更方便',
+  'wanTitle': '🌐 公网（人在外面）',
+  'wanHint': '任何网络扫码即用（URL 每次重启自动换新）',
+  'wanPin': '🔐 访问密码：{pin}（每次开启公网变新；手机打开链接需输入此密码）',
+  'wanPinCustom': '🔐 访问密码：{pin}（自定义，开启公网不再自动换新）',
+  'wanEphemeralWarn': '⚠️ 公网链接仅在本次开启期间有效：关闭或重启后失效，并可能被他人复用为陌生网站。请勿收藏，每次从本页扫「当前」二维码。需要固定不变的地址请用下方「固定域名」。',
+  'stopTunnel': '关闭公网',
+  'enable': '开启公网访问',
+  'opening': '开启中…',
+  'tunnelMode': '公网模式：',
+  'modeQuick': '随机域名（默认）',
+  'modeNamed': '固定域名',
+  'namedSummary': '固定域名：{host} · Token {token}',
+  'namedTokenSet': '已配置',
+  'namedTokenMissing': '未配置',
+  'namedEdit': '修改',
+  'namedHostnameLabel': '固定域名：',
+  'namedTokenLabel': 'Tunnel Token（留空 = 保持不变）：',
+  'namedHow': '在 Cloudflare Zero Trust → Networks → Tunnels 创建隧道并复制 Token；把域名的 Service 指向 http://127.0.0.1:3081（代理端口）。地址固定，重启不再变化。',
+  'namedSecurity': '固定域名长期暴露在公网、更易被扫描，建议同时设置自定义强密码（本模式公网密码默认不随重启轮换）。',
+  'namedNeedCfg': '请先填写固定域名与 Tunnel Token',
+  'namedRunningHint': '固定域名（Cloudflare 命名隧道）——地址不随重启变化',
+  'namedTakeEffect': '已保存固定域名配置——需关闭并重新开启公网访问后生效',
+  'disclaimerTitle': '⚠️ 安全免责声明',
+  'disclaimerBody': '开启公网 = 把本机 DSH（能执行代码）暴露到互联网。任何人拿到公网链接和密码，都能访问甚至操作你的电脑。请确认：① 使用自定义强密码或妥善保管自动密码；② 用完立即「关闭公网」；③ 公司/涉密网络请先确认合规。',
+  'disclaimerAgree': '我已知情，同意开启',
+  'disclaimerHint': '请勾选「我已知情」后再开启公网',
+  'downloading': '⏳ 下载 cloudflared（首次约 20-50MB，通常 1-2 分钟；之后秒开）· 已等待 {s} 秒',
+  'connecting': '⏳ 连接 Cloudflare 边缘（通常 5-30 秒）· 已等待 {s} 秒{suffix}',
+  'slowHint': ' — 有点久？检查是否开着代理/VPN（Clash TUN 等）',
+  'error': '❌ 开启失败：{detail}（可重试；若是代理/VPN 问题见 README 排障）',
+  'unknownError': '未知错误',
+}
+
+/** English dictionary, key-identical to the Chinese source of truth. */
+export const en = {
+  'section': 'Phone access',
+  'title': '📱 Phone access',
+  'subtitle': 'The phone shows this exact screen, live',
+  'restarted': '🔄 Restarted',
+  'ok': 'Got it',
+  'bgHint': 'Running in the background (not attached to a terminal). To stop: {cmd}',
+  'wanAccess': 'Public access',
+  'pinLabel': 'Access PIN',
+  'modeLabel': 'Address mode',
+  'advAddress': 'Advanced · Pick address',
+  'wanOffHint': 'Reachable from any network once enabled (a disclaimer is confirmed on each enable)',
+  'resetFactory': '🧹 Factory reset',
+  'resetGo': 'Reset',
+  'resetIntro': 'Temporary fallback when settings break: clear local config and re-roll random PINs (DSH sessions, models and plugin config are untouched)',
+  'resetTitle': '⚠️ Confirm factory reset?',
+  'resetBody': 'This clears and restores defaults:\n① Switches: LAN access on, access PIN on, mobile right sidebar on, LAN address auto\n② Public: mode back to random URL, Tunnel Token and fixed domain cleared, and any running tunnel is stopped\n③ PINs: both public and LAN become new random 8-character PINs (old ones stop working; the phone must re-enter)\n\nYour DSH sessions, models and plugin config are untouched. This cannot be undone.',
+  'resetConfirm': 'Reset',
+  'resetDone': '✅ Factory reset done: settings cleared and PINs re-rolled (re-enter the PIN on your phone)',
+  'resetFailed': '❌ Reset failed — please retry',
+  'lanTitle': '📶 LAN (same Wi-Fi)',
+  'lanHint': 'Scan to open once your phone is on the same Wi-Fi',
+  'lanAccess': 'LAN access',
+  'lanDisabledHint': '🔒 LAN access is off — the QR code and link are unavailable (public access is unaffected). Tap "On" to restore.',
+  'lanToggleTitleOff': 'Turn off LAN access',
+  'lanToggleBodyOff': 'Once off, phones on the same Wi-Fi can no longer scan to connect (the LAN QR code and link stop working immediately). Public access is unaffected. Turn it off?',
+  'lanToggleTitleOn': 'Turn on LAN access',
+  'lanToggleBodyOn': 'Once on, phones on the same Wi-Fi can scan to connect (a LAN PIN is required by default). Turn it on?',
+  'confirm': 'Confirm',
+  'lanAddress': 'LAN address',
+  'lanAddressAuto': 'Auto (recommended)',
+  'lanPin': 'LAN access PIN',
+  'on': 'On',
+  'off': 'Off',
+  'lanPinValue': '🔐 PIN: {pin} (required on the phone; separate from the public PIN)',
+  'lanPinCustomValue': '🔐 PIN: {pin} (custom; required on the phone)',
+  'refresh': 'Refresh',
+  'customize': 'Customize',
+  'customizing': 'New PIN (8–64 chars, letters/digits): ',
+  'save': 'Save',
+  'cancel': 'Cancel',
+  'pinInvalid': 'PIN must be 8–64 characters (letters and digits only)',
+  'pinCustomHint': 'custom PINs are not rotated on tunnel start',
+  'lanPinOff': '🔓 PIN off — scan & go, no PIN (LAN devices only; public still requires PIN)',
+  'lanStarting': 'Proxy starting…',
+  'mobileRightbar': 'Mobile right sidebar',
+  'mobileRightbarHint': 'Show the native right-sidebar entry; disable it for a compact phone header or keep it on for an unfolded display',
+  'wanTitle': '🌐 Anywhere (public)',
+  'wanHint': 'Scan from any network (the URL changes on every restart)',
+  'wanPin': '🔐 PIN: {pin} (changes each time the tunnel is enabled; required on the phone)',
+  'wanPinCustom': '🔐 PIN: {pin} (custom — not rotated on tunnel start)',
+  'wanEphemeralWarn': '⚠️ The public link is valid only for this session: it stops working after you close or restart, and may be reused by someone else for an unrelated site. Do not bookmark it — scan the CURRENT QR code from this page each time. For a permanent address use "Fixed domain" below.',
+  'stopTunnel': 'Stop',
+  'enable': 'Enable anywhere',
+  'opening': 'Enabling…',
+  'tunnelMode': 'Mode:',
+  'modeQuick': 'Random URL (default)',
+  'modeNamed': 'Fixed domain',
+  'namedSummary': 'Fixed domain: {host} · Token {token}',
+  'namedTokenSet': 'configured',
+  'namedTokenMissing': 'not set',
+  'namedEdit': 'Edit',
+  'namedHostnameLabel': 'Fixed domain:',
+  'namedTokenLabel': 'Tunnel Token (blank = keep current):',
+  'namedHow': 'Create a tunnel in Cloudflare Zero Trust → Networks → Tunnels and copy the token; point the hostname\'s Service at http://127.0.0.1:3081 (the proxy port). The URL stays fixed across restarts.',
+  'namedSecurity': 'A fixed domain is long-lived and easier to scan — set a strong custom PIN too (the public PIN is not rotated on restart in this mode).',
+  'namedNeedCfg': 'Set the fixed domain and Tunnel Token first',
+  'namedRunningHint': 'Fixed domain (Cloudflare named tunnel) — the URL no longer changes on restart',
+  'namedTakeEffect': 'Fixed-domain config saved — turn public access off and on again to take effect',
+  'disclaimerTitle': '⚠️ Security disclaimer',
+  'disclaimerBody': 'Enabling public access exposes this computer\u2019s DSH (which can execute code) to the internet. Anyone with the public link and PIN can reach — and operate — your computer. Please confirm: ① use a strong custom PIN or keep the auto-generated one safe; ② turn public access OFF as soon as you\u2019re done; ③ on a corporate/classified network, confirm compliance first.',
+  'disclaimerAgree': 'I understand and agree',
+  'disclaimerHint': 'Check "I understand" before enabling public access',
+  'downloading': '⏳ Downloading cloudflared (first run ~20-50MB, usually 1-2 min; instant afterward) · {s}s elapsed',
+  'connecting': '⏳ Connecting to Cloudflare edge (usually 5-30s) · {s}s elapsed{suffix}',
+  'slowHint': ' — taking long? Check for a proxy/VPN (e.g., Clash TUN)',
+  'error': '❌ Failed to enable: {detail} (you can retry; for proxy/VPN issues see the README)',
+  'unknownError': 'unknown error',
+}

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# dsh-pocket bundle patch（dsh.bundle manifest 要求的加载配置）
+# 单包单插件：装一次，设置页「手机访问」全部功能到位。
+- insert:
+    - id: dsh-pocket
+      name: '@guowenzhang/dsh-pocket'