@tunnelbox/core 0.1.20 → 0.1.22

package/locales/zh-TW.json

@@ -273,5 +273,73 @@
   "adapter.logQuestionNative": "選擇請求 → 手機選擇卡 questionID={id} (session={session})",
   "adapter.logPermissionNative": "審批請求 → 手機權限卡 permissionID={id} (session={session})",
   "adapter.checkAppServerOk": "codex app-server 可用",
-  "adapter.checkAppServerMissing": "目前 Codex CLI 不支援 `codex app-server`（請升級 Codex CLI）"
+  "adapter.checkAppServerMissing": "目前 Codex CLI 不支援 `codex app-server`（請升級 Codex CLI）",
+  "adapter.warnCursorCliMissing": "未找到 Cursor CLI 執行檔 \"{bin}\"：請安裝（https://cursor.com/docs/cli），或用 TUNNELBOX_CURSOR_BIN 指定路徑",
+  "adapter.checkCursorCliMissing": "未找到 Cursor CLI 執行檔（{bin}）：請從 https://cursor.com/docs/cli 安裝",
+  "adapter.checkCursorAcpHint": "已偵測到 Cursor CLI；將使用 ACP 模式（`agent acp`）提供串流/審批/選擇",
+  "adapter.errAcpSpawn": "啟動 cursor `agent acp` 失敗：{message}（請確認 Cursor CLI 支援 `agent acp`）",
+  "adapter.errAcpNoSession": "Cursor ACP 未返回工作階段 id",
+  "adapter.logResumeFailed": "工作階段恢復失敗，改為建立新工作階段：{message}",
+  "adapter.logPlanNative": "計畫審批 → 手機審批卡 permissionID={id} (session={session})",
+  "adapter.errTimeout": "等待逾時，自動拒絕（fail-closed）",
+  "adapter.planApprovalPrompt": "Cursor 請求批准一項計畫",
+  "adapter.checkCursorHeader": "tunnelbox-cursor 環境自檢",
+  "adapter.errAskBridge": "啟動 ask 橋失敗：{message}",
+  "adapter.logAskBridge": "MCP ask 橋已監聽 {url}",
+  "cursor.mcpAskDesc": "讓使用者在手機上（tunnelbox）做選擇，並阻塞等待其作答。只要需要使用者在繼續前於若干選項中做出選擇（如選餐、選模式、選方案）就呼叫它。回傳使用者所選的選項文字。",
+  "cursor.mcpAskTitleDesc": "手機卡片上顯示的標題（可選）",
+  "cursor.mcpAskQuestionsDesc": "一個或多個問題；每個問題帶可選項",
+  "cursor.mcpPlanDesc": "讓使用者在手機上（tunnelbox）批准一項計畫，並阻塞等待其應答。回傳計畫是否被接受。",
+  "cursor.mcpNoBridge": "tunnelbox ask 橋不可用",
+  "cursor.mcpUnanswered": "使用者未在手機上作答（離線或逾時）。請繼續，或用對話方式詢問。",
+  "cursor.mcpRejected": "使用者在手機上拒絕了這個提問。",
+  "cursor.mcpAnswersHeader": "使用者（手機）的選擇：",
+  "cursor.mcpAccepted": "使用者已接受該計畫。",
+  "cursor.mcpDenied": "使用者拒絕了該計畫。",
+  "cursor.mcpPlanUnanswered": "使用者未在手機上回應計畫（離線或逾時）。",
+  "cursor.mcpAskNoQuestions": "未提供任何問題。",
+  "cursor.mcpFailed": "tunnelbox ask 呼叫失敗",
+  "adapter.errCursorExitCode": "Cursor CLI 退出碼 {code}",
+  "adapter.errCursorExit": "Cursor CLI 退出({code}): {err}",
+  "adapter.errCursorSpawn": "無法啟動 Cursor CLI（agent）：請確認已安裝並登入（{message}）",
+  "adapter.errCursorStart": "Cursor CLI 啟動失敗: {message}",
+  "adapter.errCursorGeneric": "Cursor 出錯",
+  "qr.downloadApp": "下載 tunnelbox App（Android / iOS）：{url}",
+  "adapter.logLegacyHookRemoved": "已移除舊的 PermissionRequest hook（hooks.json）",
+  "adapter.errAppServerNotRunning": "codex app-server 未執行",
+  "adapter.errAppServerTimeout": "app-server 請求逾時：{method}",
+  "adapter.errAppServerStopped": "app-server 用戶端已停止",
+  "adapter.errAppServerExited": "codex app-server 結束（code={code} signal={signal}）",
+  "adapter.errAppServerError": "app-server 錯誤：{message}",
+  "adapter.logAppServerStderr": "app-server：{line}",
+  "adapter.logAppServerExited": "app-server 結束（code={code} signal={signal}）",
+  "adapter.errDshGenerate": "dsh 產生錯誤",
+  "adapter.unknown": "未知",
+  "adapter.errGatewayClientMissing": "gateway client 未建立",
+  "adapter.errGatewayNotConnected": "gateway 未連線",
+  "adapter.sessionTitleWithId": "{name} 工作階段 {id}",
+  "adapter.promptApproveTool": "{name} 請求批准執行 {tool}",
+  "index.log.serverStart": "opencode server={server} baseUrl={baseUrl} auth={auth} lang={lang}",
+  "agent.err.http": "HTTP {status}：{text}",
+  "claude.promptUrl": "URL：{url}",
+  "hermes.errBridgeNotRunning": "bridge loop 未執行",
+  "hermes.errAskNoQuestion": "未提供問題。請傳入 questions=[{question, choices?, multi_select?}, ...]。",
+  "hermes.toolPairDesc": "向 tunnelbox 中繼申請一次性手機配對碼（供手機 tunnelbox App 掃碼/輸碼配對）。當使用者詢問如何用手機連線/配對/掃碼/遠端控制本機時使用。",
+  "hermes.toolPairRefreshDesc": "是否強制申請新配對碼（預設重用/忽略）",
+  "hermes.toolStatusDesc": "返回 tunnelbox 外掛狀態：中繼位址、agent 標識、是否已綁定手機帳號、資料目錄與最近配對資訊。當使用者詢問與手機的 tunnelbox 連線狀態/是否綁定/中繼位址時使用。",
+  "hermes.toolAskDesc": "把一個問題/選擇發到使用者的 tunnelbox 手機（遠端 UI）並等待其選擇或輸入。返回 JSON：{answered: bool, user_response: string|string[]|null}。手機離線或逾時會 answered=false。",
+  "hermes.toolAskQuestionDesc": "要問的問題文字",
+  "hermes.toolAskChoicesDesc": "預置選項（可選；最多 4 個）",
+  "hermes.toolAskMultipleDesc": "是否多選（需提供 choices）",
+  "hermes.cmdDesc": "tunnelbox：手機配對 / 連線狀態",
+  "hermes.logConfigLoadFailed": "tunnelbox: 讀取設定失敗，使用預設值: {err}",
+  "hermes.logRegisterToolsFailed": "tunnelbox: 註冊工具失敗: {err}",
+  "hermes.logRegisterCommandFailed": "tunnelbox: 註冊命令失敗: {err}",
+  "hermes.logRegisterSkillFailed": "tunnelbox: 註冊技能失敗: {err}",
+  "hermes.logRegisterHooksFailed": "tunnelbox: 註冊 hooks 失敗: {err}",
+  "hermes.logRegisterApprovalFailed": "tunnelbox: 註冊 approval transport 失敗: {err}",
+  "hermes.logRegisterAskFailed": "tunnelbox: 註冊 tunnelbox_ask 失敗: {err}",
+  "hermes.logRegisterSystemPromptFailed": "tunnelbox: 註冊 system prompt 段失敗: {err}",
+  "hermes.logBackgroundBridgeFailed": "tunnelbox: 背景橋啟動失敗: {err}",
+  "hermes.systemPromptAsk": "當你需要使用者做決定/澄清/選擇，且已連接 tunnelbox 手機時，請用 `tunnelbox_ask` 工具在手機上提問，而不是自行猜測；等到使用者作答後再繼續。"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tunnelbox/core",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "description": "tunnelbox 共享核心：协议类型、中继客户端、状态持久化、二维码配对",
   "type": "module",
   "main": "./dist/index.js",

package/src/i18n.ts

@@ -71,12 +71,18 @@ export function normalizeLang(raw?: string | null): Lang {
   return map[base] ?? DEFAULT_LANG;
 }
 
-/** 从系统环境变量（LANG/LC_ALL/LC_MESSAGES）探测语言；拿不到返回 null。 */
+/** 从系统环境变量（LANG/LC_ALL/LC_MESSAGES）探测语言；拿不到则用运行时默认 locale（跨平台，含 Windows）；仍拿不到返回 null。 */
 export function detectSystemLang(): string | null {
   for (const k of ["LC_ALL", "LC_MESSAGES", "LANG"]) {
     const v = process.env[k];
     if (v && v.trim()) return v.trim().split(".")[0];
   }
+  try {
+    const loc = Intl.DateTimeFormat().resolvedOptions().locale;
+    if (loc && loc.trim()) return loc.trim();
+  } catch {
+    /* ignore */
+  }
   return null;
 }
 

package/src/index.ts

@@ -11,3 +11,4 @@ export * from "./qr";
 export * from "./i18n";
 export * from "./messages";
 export * from "./cli";
+export * from "./terminal";

package/src/qr.ts

@@ -4,6 +4,7 @@
  */
 import { writePairingFile } from "./state";
 import { normalizeLang, resolveLang, t, type Lang } from "./i18n";
+import { hyperlink, websiteUrl } from "./terminal";
 
 /** 加载 qrcode 渲染器（可选依赖，加载失败返回 null）。 */
 async function loadQrcode(): Promise<{
@@ -90,6 +91,7 @@ export async function printPairing(
   console.log("│ " + padVisual(codeLine, W - 2) + " │");
   console.log("└" + bar + "┘");
   console.log("  " + hint);
+  console.log("  " + tt("qr.downloadApp", { url: hyperlink(websiteUrl()) }));
   console.log("  " + tt("qr.validFor"));
 
   try {

package/src/terminal.ts

@@ -0,0 +1,46 @@
+/**
+ * 终端链接辅助：在支持的终端把 URL 渲染为**可点击超链接**（OSC 8），否则回退纯文本。
+ * 供各适配器配对输出复用（官网下载引导）。默认自动探测，可用环境变量覆盖：
+ *   - TUNNELBOX_HYPERLINK=1|0  强制开启/关闭
+ *   - TUNNELBOX_WEBSITE_URL    覆盖官网地址
+ */
+
+/** 官网默认地址（可用 TUNNELBOX_WEBSITE_URL 覆盖）。 */
+export function websiteUrl(): string {
+  return (process.env.TUNNELBOX_WEBSITE_URL || "https://www.tunnelbox.top").trim();
+}
+
+function envFlag(raw: string | undefined): boolean | null {
+  const s = (raw || "").trim().toLowerCase();
+  if (["1", "true", "yes", "on"].includes(s)) return true;
+  if (["0", "false", "no", "off"].includes(s)) return false;
+  return null;
+}
+
+/**
+ * 是否支持 OSC 8 超链接：仅 TTY + 已知终端；可用 TUNNELBOX_HYPERLINK 强制。
+ * 覆盖的终端：Windows Terminal、iTerm2、WezTerm、VS Code、Hyper、Tabby、Warp、
+ * VTE 系（GNOME Terminal 等）、Konsole、kitty。
+ */
+export function supportsHyperlinks(): boolean {
+  const override = envFlag(process.env.TUNNELBOX_HYPERLINK);
+  if (override !== null) return override;
+  if (!process.stdout || !process.stdout.isTTY) return false;
+  const env = process.env;
+  if (env.WT_SESSION) return true; // Windows Terminal
+  if (env.WEZTERM_PANE) return true;
+  if (env.KITTY_WINDOW_ID) return true;
+  if (env.VTE_VERSION) return true; // GNOME Terminal 等 VTE
+  if (env.KONSOLE_VERSION) return true;
+  const tp = env.TERM_PROGRAM || "";
+  return /^(iTerm\.app|WezTerm|vscode|Hyper|Apple_Terminal|Tabby|WarpTerminal)$/i.test(tp);
+}
+
+/** OSC 8 超链接；不支持时返回纯文本（默认显示 URL 本身，仍可复制）。 */
+export function hyperlink(url: string, text?: string): string {
+  const label = text ?? url;
+  if (!supportsHyperlinks()) return label;
+  const OSC = "\u001B]8;;";
+  const ST = "\u001B\\";
+  return `${OSC}${url}${ST}${label}${OSC}${ST}`;
+}