dsh-pocket-relay 1.0.0

package/client/mobile/nav-targets.mjs

@@ -0,0 +1,85 @@
+// 抽屉点击规则的判定常量与纯函数 —— 抽成独立 ESM 模块，好让 node 测试直接
+// 引入（client 侧是 esbuild 打进 bundle 的，测试里没有 DOM 可用）。
+
+/**
+ * 抽屉本体：AppFrame 的第一个网格子元素，即被拉成抽屉的侧边栏列。
+ * @type {string}
+ */
+export const DRAWER_SELECTOR = '[data-mobile-nav="frame"] > :first-child'
+
+/** 抽屉开关（会话头部那颗按钮）——点它不该被"点抽屉外就关"二次触发。 */
+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,331 @@
+// dsh-pocket-relay 设置页签 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': '手机扫码打开的就是电脑上的这个界面，实时同步',
+  'developer': '基于 dsh-pocket 二次开发（GPL-2.0）',
+  'starAsk': '⭐ 顺手留颗 Star，作者能高兴一整天',
+  'starCta': '行，给你一颗 Star',
+  'restarted': '🔄 已重启',
+  'ok': '知道了',
+  'bgHint': '进程在后台运行（不挂终端）。如需停止：{cmd}',
+  'updatedRestart': '✅ 已更新 v{ver}，重启生效',
+  'updateAutoRestarting': '✅ 已更新 v{ver}，正在自动重启…',
+  'updatedOk': '✅ 已更新 v{ver}',
+  'updateAvailable': '📦 新版本 v{ver}',
+  'updating': '更新中…',
+  'updateTo': '更新到 v{ver}',
+  'restartingNow': '正在重启生效…',
+  'restarting': '重启中…',
+  'restartNow': '🔄 重启 dsh web 生效',
+  'updatingDetail': '⏳ 更新中（通常 1-2 分钟）· 已等待 {s} 秒',
+  'restartingDetail': '⏳ 正在重启生效（通常 10-30 秒）· 已等待 {s} 秒',
+  'updatedAutoDetail': '✅ 已更新，正在自动重启生效，请稍候刷新',
+  'updatedRestartDetail': '✅ 已更新，重启 dsh web 生效',
+  'updateFailed': '❌ 失败：{err}（手动更新：dsh plugin --profile web update dsh-pocket-relay --latest -w）',
+  'versionRange': '当前 v{cur} → 最新 v{latest}',
+  '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 位，英文字母或数字）：',
+  'save': '保存',
+  'cancel': '取消',
+  'pinInvalid': '密码必须是 8 位英文字母或数字',
+  'pinCustomHint': '自定义后开启公网不再自动换新',
+  'lanPinOff': '🔓 密码已关闭：扫码直连，无需密码（仅同一局域网设备可访问；公网仍要密码）',
+  'lanStarting': '代理未就绪…',
+  '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': '未知错误',
+  'feedback': '有问题？欢迎到 GitHub Issues 反馈 🙏',
+
+  // ---------- 中继（自建服务器） ----------
+  'relayTitle': '🛰 中继（自建服务器）',
+  'relayIntro': '用自己的服务器中转，地址固定、不依赖第三方。配置好即常开：dsh 一起来就在线，不用每次手动开。',
+  'relayStateOnline': '🟢 已连接',
+  'relayStateConnecting': '🟠 连接中…',
+  'relayStateError': '🔴 未连接',
+  'relayStateStopped': '⚪ 已暂停',
+  'relayStateIdle': '⚪ 未启用',
+  'relayHostLabel': '服务器地址',
+  'relayHostPh': 'relay.example.com',
+  'relayPortLabel': 'agent 端口',
+  'relayPublicUrlLabel': '对外访问地址',
+  'relayPublicUrlPh': 'https://relay.example.com:8443',
+  'relayPublicUrlHint': '手机扫码和收藏用这个地址。relay 自己终结 TLS，所以填 https:// 加端口。',
+  'relayTokenLabel': 'Token（留空 = 保持不变）',
+  'relayTokenSet': '已配置',
+  'relayTokenMissing': '未配置',
+  'relayAgentIdLabel': '本机名称',
+  'relayAgentIdPh': '留空 = 用电脑主机名',
+  'relayAgentIdHint': '同一台中继上挂多台电脑时靠它区分（只允许字母、数字、- _ .）。留空就用主机名——同一台中继上多台电脑不能同名，否则会互相顶下线。',
+  'relayThisPc': '本机名称：{id}',
+  'relayTlsLabel': 'agent 通道使用 TLS',
+  'relayTlsHint': 'agent 通道承载你和电脑之间的全部明文流量，除非走 Tailscale/WireGuard 内网，否则建议开启。',
+  'relayInsecureLabel': '允许自签名证书',
+  'relayInsecureHint': '⚠️ 等于放弃中间人防护，仅在完全可信的网络里用。',
+  'relaySave': '保存并连接',
+  'relaySaving': '保存中…',
+  'relaySaved': '✅ 中继配置已保存',
+  'relaySaveFailed': '❌ 保存失败：{err}',
+  'relayNeedCfg': '请先填写服务器地址、agent 端口、对外访问地址和 Token',
+  'relayPause': '暂停远程',
+  'relayResume': '恢复远程',
+  'relayReconnects': '已重连 {n} 次',
+  'relayStreams': '进行中的连接：{n}',
+  'relayConsentTitle': '⚠️ 常开远程访问的安全声明',
+  'relayConsentBody': '开启后，只要 dsh 在运行，这台电脑就会**长期**挂在中继服务器上，任何人在公网上都能尝试连接。\n\n① 请确认已设置访问密码或完成设备配对；\n② 中继通道使用设备认证：每台设备一个独立密码，可单独撤销；\n③ 手机丢失请在电脑上「撤销」那台设备（不是改密码）；\n④ 公司/涉密网络请先确认合规。',
+  'relayConsentAgree': '我已知情，同意常开',
+  'relayConsentHint': '请先勾选「我已知情」',
+  'relayQrHint': '手机用这个地址访问（需先完成配对）',
+
+  // ---------- 设备管理 ----------
+  'deviceTitle': '已配对设备',
+  'deviceIntro': '中继通道用设备认证：每台手机一个独立密码，丢了一台只撤一台。',
+  'deviceAdd': '添加设备',
+  'deviceAdding': '生成中…',
+  'deviceNone': '还没有已配对的设备',
+  'devicePendingTitle': '待批准',
+  'devicePendingNone': '没有待批准的设备',
+  'deviceApprove': '批准',
+  'deviceReject': '拒绝',
+  'deviceRevoke': '撤销',
+  'deviceName': '名称',
+  'deviceCreatedAt': '添加时间',
+  'deviceLastLogin': '最后登录',
+  'deviceNever': '从未登录',
+  'devicePairTitle': '📱 配对二维码',
+  'devicePairHint': '手机扫码后设置自己的设备密码，再回来点「批准」。二维码 5 分钟内有效，且只能用一次。',
+  'devicePairExpire': '过期时间：{time}',
+  'devicePairCancel': '取消配对',
+  'deviceRevokeConfirm': '撤销后该设备需重新配对才能访问，确定继续？',
+  'deviceRevokeDone': '✅ 已撤销该设备',
+  'deviceApprovedDone': '✅ 已批准该设备',
+  'deviceRejectedDone': '✅ 已拒绝该设备',
+  'deviceNamePh': '如：我的 iPhone',
+  'deviceCount': '已配对 {n} 台',
+}
+
+/** 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',
+  'developer': 'Built on dsh-pocket (GPL-2.0)',
+  'starAsk': '⭐ Drop a Star if it helped — it makes the author’s day',
+  'starCta': '★ Give a Star',
+  'restarted': '🔄 Restarted',
+  'ok': 'Got it',
+  'bgHint': 'Running in the background (not attached to a terminal). To stop: {cmd}',
+  'updatedRestart': '✅ Updated to v{ver} — restart to apply',
+  'updateAutoRestarting': '✅ Updated to v{ver} — auto-restarting…',
+  'updatedOk': '✅ Updated to v{ver}',
+  'updateAvailable': '📦 Update available: v{ver}',
+  'updating': 'Updating…',
+  'updateTo': 'Update to v{ver}',
+  'restartingNow': 'Restarting to apply…',
+  'restarting': 'Restarting…',
+  'restartNow': '🔄 Restart dsh web now',
+  'updatingDetail': '⏳ Updating (usually 1-2 min) · {s}s elapsed',
+  'restartingDetail': '⏳ Restarting to apply (usually 10-30s) · {s}s elapsed',
+  'updatedAutoDetail': '✅ Updated — auto-restarting in progress, refresh shortly',
+  'updatedRestartDetail': '✅ Updated — restart dsh web to apply',
+  'updateFailed': '❌ Failed: {err} (manual update: dsh plugin --profile web update dsh-pocket-relay --latest -w)',
+  'versionRange': 'Current v{cur} → latest v{latest}',
+  '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, 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 chars, letters/digits): ',
+  'save': 'Save',
+  'cancel': 'Cancel',
+  'pinInvalid': 'PIN must be exactly 8 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…',
+  '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',
+  'feedback': '🙏 Questions? Open an issue on GitHub',
+
+  // ---------- Relay (self-hosted server) ----------
+  'relayTitle': '🛰 Relay (self-hosted)',
+  'relayIntro': 'Route through your own server: fixed address, no third party. Once configured it stays on — as long as dsh runs, you are reachable.',
+  'relayStateOnline': '🟢 Connected',
+  'relayStateConnecting': '🟠 Connecting…',
+  'relayStateError': '🔴 Not connected',
+  'relayStateStopped': '⚪ Paused',
+  'relayStateIdle': '⚪ Not enabled',
+  'relayHostLabel': 'Server address',
+  'relayHostPh': 'relay.example.com',
+  'relayPortLabel': 'Agent port',
+  'relayPublicUrlLabel': 'Public URL',
+  'relayPublicUrlPh': 'https://relay.example.com:8443',
+  'relayPublicUrlHint': 'The phone scans/bookmarks this. The relay terminates TLS itself, so use https:// plus the port.',
+  'relayTokenLabel': 'Token (blank = keep current)',
+  'relayTokenSet': 'configured',
+  'relayTokenMissing': 'not set',
+  'relayAgentIdLabel': 'This PC name',
+  'relayAgentIdPh': 'blank = computer hostname',
+  'relayAgentIdHint': 'Distinguishes multiple PCs behind one relay (letters, digits, - _ . only). Blank uses the hostname — two PCs on one relay must not share a name, or they will keep kicking each other off.',
+  'relayThisPc': 'This PC: {id}',
+  'relayTlsLabel': 'Use TLS for the agent channel',
+  'relayTlsHint': 'The agent channel carries all plaintext traffic between you and the PC. Keep it on unless you are on a Tailscale/WireGuard network.',
+  'relayInsecureLabel': 'Allow self-signed certificate',
+  'relayInsecureHint': '⚠️ Gives up man-in-the-middle protection. Only on a fully trusted network.',
+  'relaySave': 'Save & connect',
+  'relaySaving': 'Saving…',
+  'relaySaved': '✅ Relay settings saved',
+  'relaySaveFailed': '❌ Save failed: {err}',
+  'relayNeedCfg': 'Fill in the server address, agent port, public URL and token first',
+  'relayPause': 'Pause remote',
+  'relayResume': 'Resume remote',
+  'relayReconnects': 'Reconnects: {n}',
+  'relayStreams': 'Active connections: {n}',
+  'relayConsentTitle': '⚠️ Always-on remote access',
+  'relayConsentBody': 'Once enabled, this computer stays reachable through the relay server for as long as dsh is running, and anyone on the internet can attempt to connect.\n\n① Make sure an access PIN is set or device pairing is complete;\n② The relay channel uses device auth: each device has its own password and can be revoked individually;\n③ If a phone is lost, revoke THAT device on the computer (do not just change a password);\n④ On a corporate/classified network, confirm compliance first.',
+  'relayConsentAgree': 'I understand, enable always-on',
+  'relayConsentHint': 'Check "I understand" first',
+  'relayQrHint': 'Open this address on your phone (pairing required first)',
+
+  // ---------- Device management ----------
+  'deviceTitle': 'Paired devices',
+  'deviceIntro': 'The relay channel uses device auth: each phone has its own password, so losing one only affects that one.',
+  'deviceAdd': 'Add device',
+  'deviceAdding': 'Generating…',
+  'deviceNone': 'No paired devices yet',
+  'devicePendingTitle': 'Pending approval',
+  'devicePendingNone': 'Nothing waiting for approval',
+  'deviceApprove': 'Approve',
+  'deviceReject': 'Reject',
+  'deviceRevoke': 'Revoke',
+  'deviceName': 'Name',
+  'deviceCreatedAt': 'Added',
+  'deviceLastLogin': 'Last login',
+  'deviceNever': 'never',
+  'devicePairTitle': '📱 Pairing QR code',
+  'devicePairHint': 'Scan on the phone, set its own device password, then come back and tap Approve. The code is valid for 5 minutes and single-use.',
+  'devicePairExpire': 'Expires: {time}',
+  'devicePairCancel': 'Cancel pairing',
+  'deviceRevokeConfirm': 'The device will need to pair again to regain access. Continue?',
+  'deviceRevokeDone': '✅ Device revoked',
+  'deviceApprovedDone': '✅ Device approved',
+  'deviceRejectedDone': '✅ Device rejected',
+  'deviceNamePh': 'e.g. My iPhone',
+  'deviceCount': '{n} paired',
+}

package/cordis.patch.yml

@@ -0,0 +1,11 @@
+# dsh-pocket-relay bundle patch（dsh.bundle manifest 要求的加载配置）
+# 单包单插件：装一次，设置页「手机访问」全部功能到位。
+#
+# 注意 id 与 name 的分工（别随手改成一样的）：
+#   - name：loader 据此解析 npm 包名，必须与 package.json 的 name 一致；
+#   - id：市场「热禁用 / 启用」开关写 profile 补丁时认的就是它。刻意保留
+#     dsh-pocket 这个历史 id，这样从旧包名升级上来的用户，原有的启用/停用
+#     状态不会失配。
+- insert:
+    - id: dsh-pocket
+      name: dsh-pocket-relay