@wenbin_wb/dsh-bridge 2.6.0 → 2.6.1

package/README.en.md

@@ -104,8 +104,8 @@ npm install -g @deepseek-ai/dsh
 # Install the latest version
 dsh plugin --profile web add @wenbin_wb/dsh-bridge
 
-# Or install a specific version (e.g. 2.6.0)
-dsh plugin --profile web add @wenbin_wb/dsh-bridge@2.6.0
+# Or install a specific version (e.g. 2.6.1)
+dsh plugin --profile web add @wenbin_wb/dsh-bridge@2.6.1
 ```
 
 > 💡 **No global install permission?** Use `npx`:
@@ -212,18 +212,23 @@ Deeply tailored for smartphone screens and touch gestures, providing a clean and
 #### Chat & Session Experience
 
 <p align="center">
-  <img src="docs/screenshots/remote-web-mobile.jpg" width="32%" alt="Mobile New Session Home" />
-  <img src="docs/screenshots/mobile-chat.jpg" width="32%" alt="Mobile Active Chat View" />
-  <img src="docs/screenshots/mobile-drawer.jpg" width="32%" alt="Mobile Native Sidebar Drawer" />
+  <img src="docs/screenshots/remote-web-mobile.jpg" width="29%" alt="Mobile New Session Home" />
+  &nbsp;&nbsp;&nbsp;
+  <img src="docs/screenshots/mobile-chat.jpg" width="29%" alt="Mobile Active Chat View" />
+  &nbsp;&nbsp;&nbsp;
+  <img src="docs/screenshots/mobile-drawer.jpg" width="29%" alt="Mobile Native Sidebar Drawer" />
 </p>
 
 #### Remote Access & Plugin Settings Console
 
 <p align="center">
-  <img src="docs/screenshots/mobile-settings-lan.jpg" width="24%" alt="LAN Access Console" />
-  <img src="docs/screenshots/mobile-settings-tunnel.jpg" width="24%" alt="Public Tunnel Settings" />
-  <img src="docs/screenshots/mobile-settings-im.jpg" width="24%" alt="IM Bot Platforms" />
-  <img src="docs/screenshots/mobile-settings-security.jpg" width="24%" alt="Global Access Security" />
+  <img src="docs/screenshots/mobile-settings-lan.jpg" width="22%" alt="LAN Access Console" />
+  &nbsp;&nbsp;
+  <img src="docs/screenshots/mobile-settings-tunnel.jpg" width="22%" alt="Public Tunnel Settings" />
+  &nbsp;&nbsp;
+  <img src="docs/screenshots/mobile-settings-im.jpg" width="22%" alt="IM Bot Platforms" />
+  &nbsp;&nbsp;
+  <img src="docs/screenshots/mobile-settings-security.jpg" width="22%" alt="Global Access Security" />
 </p>
 
 ---
@@ -236,10 +241,17 @@ Automatically active when the plugin starts, zero configuration needed. Open Set
 
 ### Cloudflare Tunnel
 
-1. Click the "Start" button in the "Cloudflare Tunnel" card
-2. On first use, cloudflared (~30MB) will be automatically downloaded from GitHub
-3. Once downloaded, it starts automatically and displays a public URL and QR code within seconds
-4. The URL changes on each restart; click "Reset URL" to request a new URL
+Supports both **Quick Tunnel (zero config)** and **Cloudflare Token Named Tunnel (fixed domain)**, with optional automatic start on DSH boot:
+
+- **Mode 1: Instant Quick Tunnel (Default)**
+  1. Click the "Start" button in the "Cloudflare Tunnel" card;
+  2. On first use, cloudflared (~30MB) will be automatically downloaded from GitHub;
+  3. Displays a public URL and QR code within seconds (changes on restart or click "Reset URL").
+
+- **Mode 2: Cloudflare Token Named Tunnel (Permanent Fixed Domain · 100% Free)**
+  1. Create a free tunnel on the [Cloudflare Zero Trust Console](https://one.dash.cloudflare.com/) and bind your custom domain (e.g. `dsh.yourdomain.com`);
+  2. Expand the **"⚙️ Advanced: Fixed Domain (Cloudflare Token)"** form at the bottom of the card, enter your domain and Tunnel Token, then save;
+  3. Check **"Auto-start with DSH"** — the tunnel will automatically recover on DSH restarts with a **permanently fixed URL**!
 
 ![Public Tunnel Settings](docs/screenshots/tunnel-access.jpg)
 

package/README.md

@@ -104,8 +104,8 @@ npm install -g @deepseek-ai/dsh
 # 安装最新版
 dsh plugin --profile web add @wenbin_wb/dsh-bridge
 
-# 或指定版本（如 2.6.0）
-dsh plugin --profile web add @wenbin_wb/dsh-bridge@2.6.0
+# 或指定版本（如 2.6.1）
+dsh plugin --profile web add @wenbin_wb/dsh-bridge@2.6.1
 ```
 
 > 💡 **没有全局安装权限？** 使用 `npx` 方式：
@@ -212,18 +212,23 @@ dsh plugin --profile web add @wenbin_wb/dsh-bridge@latest
 #### 对话与会话管理体验
 
 <p align="center">
-  <img src="docs/screenshots/remote-web-mobile.jpg" width="32%" alt="移动端新会话主页" />
-  <img src="docs/screenshots/mobile-chat.jpg" width="32%" alt="移动端已有对话交互" />
-  <img src="docs/screenshots/mobile-drawer.jpg" width="32%" alt="移动端原生抽屉侧边栏" />
+  <img src="docs/screenshots/remote-web-mobile.jpg" width="29%" alt="移动端新会话主页" />
+  &nbsp;&nbsp;&nbsp;
+  <img src="docs/screenshots/mobile-chat.jpg" width="29%" alt="移动端已有对话交互" />
+  &nbsp;&nbsp;&nbsp;
+  <img src="docs/screenshots/mobile-drawer.jpg" width="29%" alt="移动端原生抽屉侧边栏" />
 </p>
 
 #### 远程访问与插件设置中心
 
 <p align="center">
-  <img src="docs/screenshots/mobile-settings-lan.jpg" width="24%" alt="局域网访问控制台" />
-  <img src="docs/screenshots/mobile-settings-tunnel.jpg" width="24%" alt="公网隧道配置" />
-  <img src="docs/screenshots/mobile-settings-im.jpg" width="24%" alt="IM 机器人矩阵" />
-  <img src="docs/screenshots/mobile-settings-security.jpg" width="24%" alt="全局访问安全认证" />
+  <img src="docs/screenshots/mobile-settings-lan.jpg" width="22%" alt="局域网访问控制台" />
+  &nbsp;&nbsp;
+  <img src="docs/screenshots/mobile-settings-tunnel.jpg" width="22%" alt="公网隧道配置" />
+  &nbsp;&nbsp;
+  <img src="docs/screenshots/mobile-settings-im.jpg" width="22%" alt="IM 机器人矩阵" />
+  &nbsp;&nbsp;
+  <img src="docs/screenshots/mobile-settings-security.jpg" width="22%" alt="全局访问安全认证" />
 </p>
 
 ---
@@ -236,10 +241,17 @@ dsh plugin --profile web add @wenbin_wb/dsh-bridge@latest
 
 ### Cloudflare 隧道
 
-1. 点击「Cloudflare 隧道」卡片中的「开启」按钮
-2. 首次使用会自动从 GitHub 下载 cloudflared（约 30MB）
-3. 下载完成后自动启动，几秒内显示公网 URL 和二维码
-4. 每次重启后 URL 会变化；点「重置链接」可主动获取新 URL
+支持**免登录临时隧道**与**专属 Token 固定域名隧道**双模式，支持随 DSH 启动自动开启：
+
+- **模式 1：极速免登录临时隧道（默认）**
+  1. 直接点击「Cloudflare 隧道」卡片中的「开启」按钮；
+  2. 首次使用会自动从 GitHub 下载 cloudflared（约 30MB）；
+  3. 几秒内自动生成公网 URL 和二维码，点「重置链接」可随时换新。
+
+- **模式 2：Cloudflare Token 固定域名（永久不变，完全免费）**
+  1. 在 [Cloudflare Zero Trust 控制台](https://one.dash.cloudflare.com/) 免费创建 Tunnel 并绑定域名（如 `dsh.yourdomain.com`）；
+  2. 展开卡片底部的 **「⚙️ 高级配置：固定域名 (Cloudflare Token)」**，填入自定义域名与 Tunnel Token 并保存；
+  3. 勾选 **「随 DSH 启动自动开启」**，每次 DSH 重启即可自动恢复隧道，**URL 永久固定不变**！
 
 ![公网隧道配置](docs/screenshots/tunnel-access.jpg)
 

package/client/client.js

@@ -40,6 +40,8 @@ var BRIDGE_ENDPOINTS = {
   startCloudflared: "startCloudflared",
   stopCloudflared: "stopCloudflared",
   resetCloudflared: "resetCloudflared",
+  saveCloudflaredConfig: "saveCloudflaredConfig",
+  setTunnelAutoStart: "setTunnelAutoStart",
   saveCustomTunnelConfig: "saveCustomTunnelConfig",
   checkVersion: "checkVersion",
   upgradePlugin: "upgradePlugin",
@@ -447,7 +449,19 @@ var CustomTunnelConfigForm = React.memo(function CustomTunnelConfigForm2({ serve
     )
   );
 });
-var TunnelCard = React.memo(function TunnelCard2({ title, desc, data, onStart, onStop, onReset, auth, onNavigateSecurity, children }) {
+var TunnelCard = React.memo(function TunnelCard2({
+  title,
+  desc,
+  data,
+  autoStart,
+  onToggleAutoStart,
+  onStart,
+  onStop,
+  onReset,
+  auth,
+  onNavigateSecurity,
+  children
+}) {
   const { running, configured, url, qr, state } = data ?? {};
   const phase = state?.phase ?? "idle";
   return React.createElement(
@@ -462,7 +476,32 @@ var TunnelCard = React.memo(function TunnelCard2({ title, desc, data, onStart, o
         React.createElement("div", { style: s.label }, title),
         React.createElement("div", { style: { ...s.muted, marginTop: 2 } }, desc)
       ),
-      React.createElement(StatusTag, { running })
+      React.createElement(
+        "div",
+        { style: { display: "flex", flexDirection: "column", alignItems: "flex-end", gap: 6 } },
+        React.createElement(StatusTag, { running }),
+        onToggleAutoStart && React.createElement(
+          "label",
+          {
+            style: {
+              display: "flex",
+              alignItems: "center",
+              gap: 4,
+              fontSize: 11,
+              color: "var(--dsw-alias-label-secondary,#6b7280)",
+              cursor: "pointer",
+              userSelect: "none"
+            },
+            title: "DSH \u542F\u52A8\u65F6\u81EA\u52A8\u6062\u590D\u8BE5\u96A7\u9053\u7684\u8FD0\u884C\u72B6\u6001"
+          },
+          React.createElement("input", {
+            type: "checkbox",
+            checked: Boolean(autoStart),
+            onChange: (e) => onToggleAutoStart(e.target.checked)
+          }),
+          "\u968F DSH \u542F\u52A8\u81EA\u52A8\u5F00\u542F"
+        )
+      )
     ),
     children,
     phase !== "idle" && phase !== "ready" && React.createElement("div", {
@@ -488,6 +527,107 @@ var TunnelCard = React.memo(function TunnelCard2({ title, desc, data, onStart, o
     )
   );
 });
+var CloudflareConfigForm = React.memo(function CloudflareConfigForm2({ token, hostname, onSave }) {
+  const [open, setOpen] = React.useState(Boolean(token || hostname));
+  const [tokenVal, setTokenVal] = React.useState(token || "");
+  const [hostnameVal, setHostnameVal] = React.useState(hostname || "");
+  const [saving, setSaving] = React.useState(false);
+  const [msg, setMsg] = React.useState(null);
+  React.useEffect(() => {
+    setTokenVal(token || "");
+    setHostnameVal(hostname || "");
+  }, [token, hostname]);
+  const handleSave = async (e) => {
+    e.preventDefault();
+    setSaving(true);
+    setMsg(null);
+    try {
+      await onSave({ token: tokenVal, hostname: hostnameVal });
+      setMsg({ ok: true, text: "\u2713 \u56FA\u5B9A\u57DF\u540D\u914D\u7F6E\u5DF2\u4FDD\u5B58" });
+    } catch (err) {
+      setMsg({ ok: false, text: err.message || "\u4FDD\u5B58\u5931\u8D25" });
+    } finally {
+      setSaving(false);
+    }
+  };
+  return React.createElement(
+    "div",
+    {
+      style: {
+        ...s.block,
+        borderTop: "1px solid var(--dsw-alias-border-secondary, #e5e7eb)",
+        paddingTop: 10,
+        marginTop: 10
+      }
+    },
+    React.createElement(
+      "div",
+      {
+        style: { display: "flex", alignItems: "center", justifyContent: "space-between", cursor: "pointer", userSelect: "none" },
+        onClick: () => setOpen((v) => !v)
+      },
+      React.createElement(
+        "div",
+        { style: { fontSize: 12, fontWeight: 500, color: "var(--dsw-alias-brand-primary, #3b82f6)" } },
+        "\u2699\uFE0F \u9AD8\u7EA7\u914D\u7F6E\uFF1A\u56FA\u5B9A\u57DF\u540D (Cloudflare Token) ",
+        (token || hostname) && React.createElement("span", { style: { fontSize: 11, color: "var(--dsw-alias-state-success-primary, #059669)", fontWeight: 400 } }, "\u25CF \u5DF2\u914D\u7F6E\u56FA\u5B9A\u57DF\u540D")
+      ),
+      React.createElement("span", { style: { fontSize: 11, color: "var(--dsw-alias-label-secondary, #9ca3af)" } }, open ? "\u25B4 \u6298\u53E0" : "\u25BE \u5C55\u5F00")
+    ),
+    open && React.createElement(
+      "form",
+      { onSubmit: handleSave, style: { marginTop: 10 } },
+      React.createElement(
+        "div",
+        { style: { fontSize: 12, color: "var(--dsw-alias-label-secondary, #6b7280)", marginBottom: 8, lineHeight: 1.5 } },
+        "\u5728 Cloudflare Zero Trust \u63A7\u5236\u53F0\u521B\u5EFA Tunnel \u5373\u53EF\u83B7\u53D6\u4E13\u5C5E Token \u5E76\u7ED1\u5B9A\u81EA\u5DF1\u7684\u57DF\u540D\uFF08\u5982 dsh.yourname.com\uFF09\uFF0C\u6BCF\u6B21\u91CD\u542F URL \u6C38\u4E0D\u53D8\u66F4\u3002\u4E0D\u586B\u5219\u4F7F\u7528\u9ED8\u8BA4\u514D\u767B\u5F55\u4E34\u65F6\u968F\u673A\u57DF\u540D\u3002"
+      ),
+      React.createElement(
+        "div",
+        { style: { marginBottom: 8 } },
+        React.createElement("input", {
+          style: s.input,
+          type: "text",
+          placeholder: "\u81EA\u5B9A\u4E49\u56FA\u5B9A\u57DF\u540D (\u4F8B\u5982: dsh.yourdomain.com)",
+          value: hostnameVal,
+          onChange: (e) => setHostnameVal(e.target.value)
+        })
+      ),
+      React.createElement(
+        "div",
+        { style: { marginBottom: 8 } },
+        React.createElement("input", {
+          style: s.input,
+          type: "password",
+          placeholder: "Tunnel Token (\u4F8B\u5982: eyJhIjoi...)",
+          value: tokenVal,
+          onChange: (e) => setTokenVal(e.target.value)
+        })
+      ),
+      React.createElement(
+        "div",
+        { style: { display: "flex", gap: 8, alignItems: "center", flexWrap: "wrap" } },
+        React.createElement("button", {
+          type: "submit",
+          style: { ...s.btnPri, height: 28, fontSize: 12, padding: "0 12px" },
+          disabled: saving
+        }, saving ? "\u4FDD\u5B58\u4E2D\u2026" : "\u4FDD\u5B58\u56FA\u5B9A\u57DF\u540D\u914D\u7F6E"),
+        (tokenVal || hostnameVal) && React.createElement("button", {
+          type: "button",
+          style: { ...s.btnGhost, height: 28, fontSize: 12, padding: "0 10px" },
+          onClick: () => {
+            setTokenVal("");
+            setHostnameVal("");
+            onSave({ token: "", hostname: "" });
+          }
+        }, "\u6E05\u9664"),
+        msg && React.createElement("span", {
+          style: { fontSize: 12, color: msg.ok ? "var(--dsw-alias-state-success-primary, #059669)" : "var(--dsw-alias-state-error-primary, #dc2626)" }
+        }, msg.text)
+      )
+    )
+  );
+});
 var AccessAuthCard = React.memo(function AccessAuthCard2({ auth, rpcCall, onUpdate }) {
   const [enabled, setEnabled] = React.useState(auth?.enabled ?? false);
   const [mode, setMode] = React.useState(auth?.mode ?? "token_and_password");
@@ -2031,8 +2171,20 @@ function BridgePanel({ rpcCall }) {
     () => act(BRIDGE_ENDPOINTS.stopCloudflared).then(() => act(BRIDGE_ENDPOINTS.startCloudflared)),
     [act]
   );
+  const onToggleCloudflaredAutoStart = React.useCallback(
+    (autoStart) => act(BRIDGE_ENDPOINTS.setTunnelAutoStart, { tunnel: "cloudflared", autoStart }),
+    [act]
+  );
+  const saveCloudflaredConfig = React.useCallback(
+    ({ token, hostname }) => act(BRIDGE_ENDPOINTS.saveCloudflaredConfig, { token, hostname }),
+    [act]
+  );
   const onStartCustom = React.useCallback(() => act(BRIDGE_ENDPOINTS.startCustomTunnel), [act]);
   const onStopCustom = React.useCallback(() => act(BRIDGE_ENDPOINTS.stopCustomTunnel), [act]);
+  const onToggleCustomAutoStart = React.useCallback(
+    (autoStart) => act(BRIDGE_ENDPOINTS.setTunnelAutoStart, { tunnel: "customTunnel", autoStart }),
+    [act]
+  );
   const saveConfig = React.useCallback(
     (serverUrl, accessToken) => act(BRIDGE_ENDPOINTS.saveCustomTunnelConfig, { serverUrl, accessToken }),
     [act]
@@ -2066,21 +2218,31 @@ function BridgePanel({ rpcCall }) {
     tabContent = React.createElement(
       React.Fragment,
       null,
-      React.createElement(TunnelCard, {
-        title: "Cloudflare \u96A7\u9053",
-        desc: "\u4E00\u952E\u83B7\u53D6\u516C\u7F51\u5730\u5740\uFF08\u91CD\u542F\u540E URL \u4F1A\u53D8\u5316\uFF09",
-        data: {
-          running: status?.cloudflared?.running,
-          url: status?.cloudflared?.url,
-          qr: status?.cloudflared?.qr,
-          state: status?.cloudflared?.state
+      React.createElement(
+        TunnelCard,
+        {
+          title: "Cloudflare \u96A7\u9053",
+          desc: status?.cloudflared?.tokenConfigured ? "\u56FA\u5B9A\u57DF\u540D\u6A21\u5F0F\uFF08Token \u8FD0\u884C \xB7 \u91CD\u542F URL \u4FDD\u6301\u4E0D\u53D8\uFF09" : "\u4E00\u952E\u83B7\u53D6\u516C\u7F51\u5730\u5740\uFF08\u514D\u767B\u5F55\u4E34\u65F6\u968F\u673A\u57DF\u540D\uFF09",
+          data: {
+            running: status?.cloudflared?.running,
+            url: status?.cloudflared?.url,
+            qr: status?.cloudflared?.qr,
+            state: status?.cloudflared?.state
+          },
+          autoStart: status?.cloudflared?.autoStart,
+          onToggleAutoStart: onToggleCloudflaredAutoStart,
+          auth: status?.auth,
+          onNavigateSecurity: navSecurity,
+          onStart: onStartCloudflared,
+          onStop: onStopCloudflared,
+          onReset: status?.cloudflared?.running ? onResetCloudflared : null
         },
-        auth: status?.auth,
-        onNavigateSecurity: navSecurity,
-        onStart: onStartCloudflared,
-        onStop: onStopCloudflared,
-        onReset: status?.cloudflared?.running ? onResetCloudflared : null
-      }),
+        React.createElement(CloudflareConfigForm, {
+          token: status?.cloudflared?.token ?? "",
+          hostname: status?.cloudflared?.hostname ?? "",
+          onSave: saveCloudflaredConfig
+        })
+      ),
       React.createElement(
         TunnelCard,
         {
@@ -2093,6 +2255,8 @@ function BridgePanel({ rpcCall }) {
             qr: ct?.qr,
             state: ct?.state
           },
+          autoStart: ct?.autoStart,
+          onToggleAutoStart: onToggleCustomAutoStart,
           auth: status?.auth,
           onNavigateSecurity: navSecurity,
           onStart: onStartCustom,

package/client/index.js

@@ -351,7 +351,19 @@ const CustomTunnelConfigForm = React.memo(function CustomTunnelConfigForm({ serv
   );
 });
 
-const TunnelCard = React.memo(function TunnelCard({ title, desc, data, onStart, onStop, onReset, auth, onNavigateSecurity, children }) {
+const TunnelCard = React.memo(function TunnelCard({
+  title,
+  desc,
+  data,
+  autoStart,
+  onToggleAutoStart,
+  onStart,
+  onStop,
+  onReset,
+  auth,
+  onNavigateSecurity,
+  children
+}) {
   const { running, configured, url, qr, state } = data ?? {};
   const phase = state?.phase ?? 'idle';
 
@@ -361,7 +373,28 @@ const TunnelCard = React.memo(function TunnelCard({ title, desc, data, onStart,
         React.createElement('div', { style: s.label }, title),
         React.createElement('div', { style: { ...s.muted, marginTop: 2 } }, desc),
       ),
-      React.createElement(StatusTag, { running }),
+      React.createElement('div', { style: { display: 'flex', flexDirection: 'column', alignItems: 'flex-end', gap: 6 } },
+        React.createElement(StatusTag, { running }),
+        onToggleAutoStart && React.createElement('label', {
+          style: {
+            display: 'flex',
+            alignItems: 'center',
+            gap: 4,
+            fontSize: 11,
+            color: 'var(--dsw-alias-label-secondary,#6b7280)',
+            cursor: 'pointer',
+            userSelect: 'none',
+          },
+          title: 'DSH 启动时自动恢复该隧道的运行状态',
+        },
+          React.createElement('input', {
+            type: 'checkbox',
+            checked: Boolean(autoStart),
+            onChange: (e) => onToggleAutoStart(e.target.checked),
+          }),
+          '随 DSH 启动自动开启',
+        ),
+      ),
     ),
     children,
     phase !== 'idle' && phase !== 'ready' && React.createElement('div', {
@@ -385,6 +418,96 @@ const TunnelCard = React.memo(function TunnelCard({ title, desc, data, onStart,
   );
 });
 
+// Cloudflare 命名隧道（固定域名 / Token）高级配置表单
+const CloudflareConfigForm = React.memo(function CloudflareConfigForm({ token, hostname, onSave }) {
+  const [open, setOpen] = React.useState(Boolean(token || hostname));
+  const [tokenVal, setTokenVal] = React.useState(token || '');
+  const [hostnameVal, setHostnameVal] = React.useState(hostname || '');
+  const [saving, setSaving] = React.useState(false);
+  const [msg, setMsg] = React.useState(null);
+
+  React.useEffect(() => {
+    setTokenVal(token || '');
+    setHostnameVal(hostname || '');
+  }, [token, hostname]);
+
+  const handleSave = async (e) => {
+    e.preventDefault();
+    setSaving(true);
+    setMsg(null);
+    try {
+      await onSave({ token: tokenVal, hostname: hostnameVal });
+      setMsg({ ok: true, text: '✓ 固定域名配置已保存' });
+    } catch (err) {
+      setMsg({ ok: false, text: err.message || '保存失败' });
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  return React.createElement('div', {
+    style: {
+      ...s.block,
+      borderTop: '1px solid var(--dsw-alias-border-secondary, #e5e7eb)',
+      paddingTop: 10,
+      marginTop: 10,
+    },
+  },
+    React.createElement('div', {
+      style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between', cursor: 'pointer', userSelect: 'none' },
+      onClick: () => setOpen(v => !v),
+    },
+      React.createElement('div', { style: { fontSize: 12, fontWeight: 500, color: 'var(--dsw-alias-brand-primary, #3b82f6)' } },
+        '⚙️ 高级配置：固定域名 (Cloudflare Token) ',
+        (token || hostname) && React.createElement('span', { style: { fontSize: 11, color: 'var(--dsw-alias-state-success-primary, #059669)', fontWeight: 400 } }, '● 已配置固定域名')
+      ),
+      React.createElement('span', { style: { fontSize: 11, color: 'var(--dsw-alias-label-secondary, #9ca3af)' } }, open ? '▴ 折叠' : '▾ 展开'),
+    ),
+    open && React.createElement('form', { onSubmit: handleSave, style: { marginTop: 10 } },
+      React.createElement('div', { style: { fontSize: 12, color: 'var(--dsw-alias-label-secondary, #6b7280)', marginBottom: 8, lineHeight: 1.5 } },
+        '在 Cloudflare Zero Trust 控制台创建 Tunnel 即可获取专属 Token 并绑定自己的域名（如 dsh.yourname.com），每次重启 URL 永不变更。不填则使用默认免登录临时随机域名。'
+      ),
+      React.createElement('div', { style: { marginBottom: 8 } },
+        React.createElement('input', {
+          style: s.input,
+          type: 'text',
+          placeholder: '自定义固定域名 (例如: dsh.yourdomain.com)',
+          value: hostnameVal,
+          onChange: (e) => setHostnameVal(e.target.value),
+        }),
+      ),
+      React.createElement('div', { style: { marginBottom: 8 } },
+        React.createElement('input', {
+          style: s.input,
+          type: 'password',
+          placeholder: 'Tunnel Token (例如: eyJhIjoi...)',
+          value: tokenVal,
+          onChange: (e) => setTokenVal(e.target.value),
+        }),
+      ),
+      React.createElement('div', { style: { display: 'flex', gap: 8, alignItems: 'center', flexWrap: 'wrap' } },
+        React.createElement('button', {
+          type: 'submit',
+          style: { ...s.btnPri, height: 28, fontSize: 12, padding: '0 12px' },
+          disabled: saving,
+        }, saving ? '保存中…' : '保存固定域名配置'),
+        (tokenVal || hostnameVal) && React.createElement('button', {
+          type: 'button',
+          style: { ...s.btnGhost, height: 28, fontSize: 12, padding: '0 10px' },
+          onClick: () => {
+            setTokenVal('');
+            setHostnameVal('');
+            onSave({ token: '', hostname: '' });
+          },
+        }, '清除'),
+        msg && React.createElement('span', {
+          style: { fontSize: 12, color: msg.ok ? 'var(--dsw-alias-state-success-primary, #059669)' : 'var(--dsw-alias-state-error-primary, #dc2626)' },
+        }, msg.text),
+      ),
+    ),
+  );
+});
+
 // ---- 访问安全认证卡片 ----
 
 const AccessAuthCard = React.memo(function AccessAuthCard({ auth, rpcCall, onUpdate }) {
@@ -1824,8 +1947,18 @@ function BridgePanel({ rpcCall }) {
   const onResetCloudflared = React.useCallback(() =>
     act(BRIDGE_ENDPOINTS.stopCloudflared).then(() => act(BRIDGE_ENDPOINTS.startCloudflared))
   , [act]);
+  const onToggleCloudflaredAutoStart = React.useCallback((autoStart) =>
+    act(BRIDGE_ENDPOINTS.setTunnelAutoStart, { tunnel: 'cloudflared', autoStart })
+  , [act]);
+  const saveCloudflaredConfig = React.useCallback(({ token, hostname }) =>
+    act(BRIDGE_ENDPOINTS.saveCloudflaredConfig, { token, hostname })
+  , [act]);
+
   const onStartCustom = React.useCallback(() => act(BRIDGE_ENDPOINTS.startCustomTunnel), [act]);
   const onStopCustom  = React.useCallback(() => act(BRIDGE_ENDPOINTS.stopCustomTunnel), [act]);
+  const onToggleCustomAutoStart = React.useCallback((autoStart) =>
+    act(BRIDGE_ENDPOINTS.setTunnelAutoStart, { tunnel: 'customTunnel', autoStart })
+  , [act]);
   const saveConfig = React.useCallback((serverUrl, accessToken) =>
     act(BRIDGE_ENDPOINTS.saveCustomTunnelConfig, { serverUrl, accessToken })
   , [act]);
@@ -1865,19 +1998,29 @@ function BridgePanel({ rpcCall }) {
     tabContent = React.createElement(React.Fragment, null,
       React.createElement(TunnelCard, {
         title: 'Cloudflare 隧道',
-        desc: '一键获取公网地址（重启后 URL 会变化）',
+        desc: status?.cloudflared?.tokenConfigured
+          ? '固定域名模式（Token 运行 · 重启 URL 保持不变）'
+          : '一键获取公网地址（免登录临时随机域名）',
         data: {
           running: status?.cloudflared?.running,
           url: status?.cloudflared?.url,
           qr: status?.cloudflared?.qr,
           state: status?.cloudflared?.state,
         },
+        autoStart: status?.cloudflared?.autoStart,
+        onToggleAutoStart: onToggleCloudflaredAutoStart,
         auth: status?.auth,
         onNavigateSecurity: navSecurity,
         onStart: onStartCloudflared,
         onStop:  onStopCloudflared,
         onReset: status?.cloudflared?.running ? onResetCloudflared : null,
-      }),
+      },
+        React.createElement(CloudflareConfigForm, {
+          token: status?.cloudflared?.token ?? '',
+          hostname: status?.cloudflared?.hostname ?? '',
+          onSave: saveCloudflaredConfig,
+        }),
+      ),
       React.createElement(TunnelCard, {
         title: '自建隧道',
         desc: '连接自己部署的隧道服务器，获得固定域名',
@@ -1888,6 +2031,8 @@ function BridgePanel({ rpcCall }) {
           qr: ct?.qr,
           state: ct?.state,
         },
+        autoStart: ct?.autoStart,
+        onToggleAutoStart: onToggleCustomAutoStart,
         auth: status?.auth,
         onNavigateSecurity: navSecurity,
         onStart: onStartCustom,

package/docs/feishu-usage.md

@@ -96,3 +96,19 @@
 
 ![飞书对话与卡片审批](screenshots/feishu-chat.jpg)
 
+---
+
+## ❓ 常见问题 (FAQ)
+
+### Q1: 点击卡片上的「批准」/「拒绝」按钮提示无权限或无反应？
+请依次核对以下三项飞书开放平台配置：
+1. **是否订阅了卡片交互事件**：在开放平台后台 **「事件与回调」➔「事件配置」** 中，必须添加 **`card.action.trigger`**（消息卡片回传交互）事件。若只添加了接收消息事件，卡片点击不会下发回调。
+2. **是否发布了新版本生效**：飞书平台的所有权限与事件变更，**必须在「版本管理与发布」中「创建版本」并申请发布通过后才会生效**。
+3. **应用可用范围**：在「版本管理与发布」中，确认应用可用范围包含了您当前的飞书账号（建议设为「所有员工」或将自己加入可用成员）。
+4. **快速应急处理**：如果卡片按钮暂时受网络或配置影响，可直接在聊天中回复文字 **`/yes`**（或 `1`）批准，回复 **`/no`**（或 `2`）拒绝。
+
+### Q2: 机器人无法在群聊中回复消息？
+1. 确保在「权限管理」中开通了 **`im:message.group_msg`**（获取群组中所有消息）权限；
+2. 确保在「版本管理与发布」中发布了包含该权限的新版本；
+3. 将机器人拉入群聊后，需要 **`@机器人`** 唤醒并发送指令。
+

package/lib/bridge-rpc-constants.js

@@ -9,6 +9,8 @@ export const BRIDGE_ENDPOINTS = {
   startCloudflared: 'startCloudflared',
   stopCloudflared: 'stopCloudflared',
   resetCloudflared: 'resetCloudflared',
+  saveCloudflaredConfig: 'saveCloudflaredConfig',
+  setTunnelAutoStart: 'setTunnelAutoStart',
   saveCustomTunnelConfig: 'saveCustomTunnelConfig',
   checkVersion: 'checkVersion',
   upgradePlugin: 'upgradePlugin',

package/lib/bridge-rpc.js

@@ -144,6 +144,26 @@ export function installBridgeRpc(ctx, { service, authManager, wechat, platformMa
           return ok(status);
         }
 
+        if (endpoint === BRIDGE_ENDPOINTS.saveCloudflaredConfig) {
+          const adminErr = checkAdminAuth(authManager, payload);
+          if (adminErr) return adminErr;
+
+          const { token = '', hostname = '' } = payload;
+          await service.saveCloudflaredConfig({ token, hostname });
+          const status = await service.getStatus();
+          return ok(status);
+        }
+
+        if (endpoint === BRIDGE_ENDPOINTS.setTunnelAutoStart) {
+          const adminErr = checkAdminAuth(authManager, payload);
+          if (adminErr) return adminErr;
+
+          const { tunnel, autoStart } = payload;
+          await service.setTunnelAutoStart({ tunnel, autoStart });
+          const status = await service.getStatus();
+          return ok(status);
+        }
+
         if (endpoint === BRIDGE_ENDPOINTS.startCustomTunnel) {
           const adminErr = checkAdminAuth(authManager, payload);
           if (adminErr) return adminErr;

package/lib/cloudflared-manager.mjs

@@ -74,9 +74,11 @@ async function downloadFile(url, dest, onProgress) {
 }
 
 export class CloudflaredManager {
-  constructor({ port, home, onStateChange, logger }) {
+  constructor({ port, home, token, hostname, onStateChange, logger }) {
     this.port = port;
     this.home = home || join(homedir(), '.dsh-bridge');
+    this.token = token ? String(token).trim() : null;
+    this.hostname = hostname ? String(hostname).trim() : null;
     this.onStateChange = onStateChange;
     this.logger = logger;
 
@@ -152,8 +154,13 @@ export class CloudflaredManager {
 
       this._setState('connecting', '正在连接 Cloudflare...');
 
-      const args = ['tunnel', '--url', `http://127.0.0.1:${this.port}`];
-      this.logger?.info('启动 cloudflared: %s %s', this.binaryPath, args.join(' '));
+      const args = this.token
+        ? ['tunnel', 'run', '--token', this.token]
+        : ['tunnel', '--url', `http://127.0.0.1:${this.port}`];
+
+      // 隐藏日志中的 token 敏感字段
+      const safeArgs = this.token ? ['tunnel', 'run', '--token', '***'] : args;
+      this.logger?.info('启动 cloudflared: %s %s', this.binaryPath, safeArgs.join(' '));
 
       this.process = spawn(this.binaryPath, args, {
         stdio: ['ignore', 'pipe', 'pipe'],
@@ -168,13 +175,38 @@ export class CloudflaredManager {
         }
       };
 
-      // URL 同时在 stdout 和 stderr 里找（不同版本行为不同）
+      // 1. 命名/Token 隧道：通过握手日志判定就绪，使用预设固定域名
+      const parseNamedTunnel = (text) => {
+        if (!this.token) return;
+        if (
+          (text.includes('Registered tunnel') ||
+           text.includes('registered connIndex') ||
+           text.includes('Connection') && text.includes('registered') ||
+           text.includes('Updated to new configuration') ||
+           text.includes('Route propagated')) &&
+          !resolved
+        ) {
+          let fixedUrl = this.hostname
+            ? (this.hostname.startsWith('http') ? this.hostname : `https://${this.hostname}`)
+            : null;
+          this.url = fixedUrl;
+          this._setState('ready', fixedUrl ? `固定隧道已建立 (${fixedUrl})` : '固定隧道已建立');
+          this.logger?.info('cloudflared 固定隧道就绪: %s', this.url || 'Token 模式');
+          tryResolve();
+        }
+      };
+
+      // 2. 免费临时隧道：从 stdout/stderr 解析随机分配的 trycloudflare.com 域名
       const parseUrl = (text) => {
+        if (this.token) {
+          parseNamedTunnel(text);
+          return;
+        }
         const match = text.match(/https:\/\/[a-z0-9-]+\.trycloudflare\.com/);
         if (match && !resolved) {
           this.url = match[0];
-          this._setState('ready', '隧道已建立');
-          this.logger?.info('cloudflared 隧道就绪: %s', this.url);
+          this._setState('ready', '临时隧道已建立');
+          this.logger?.info('cloudflared 临时隧道就绪: %s', this.url);
           tryResolve();
         }
       };
@@ -185,7 +217,7 @@ export class CloudflaredManager {
         this.logger?.debug('cloudflared: %s', text.trim());
         parseUrl(text);
         if (text.includes('Registered tunnel') && !resolved) {
-          this._setState('connecting', '隧道已注册，等待 URL...');
+          this._setState('connecting', '隧道已注册，等待就绪...');
         }
       });
 

package/lib/index.js

@@ -452,12 +452,14 @@ class ProxyServer {
  * Bridge Service
  */
 class BridgeService {
-  constructor({ dshPort, proxyPort, home, customTunnelConfig, authManager, logger }) {
+  constructor({ dshPort, proxyPort, home, cloudflaredConfig, customTunnelConfig, authManager, onPersist, logger }) {
     this.dshPort = dshPort;
     this.proxyPort = proxyPort;
     this.home = home;
+    this.cloudflaredConfig = cloudflaredConfig ?? { token: '', hostname: '', autoStart: false };
     this.customTunnelConfig = customTunnelConfig ?? null;
     this.authManager = authManager ?? null;
+    this.onPersist = onPersist ?? null;
     this.logger = logger;
 
     this.qrCache = new QrCache();
@@ -539,6 +541,10 @@ class BridgeService {
           ? await this.qrCache.get(cloudflaredUrl)
           : null,
         state: this.cloudflaredState,
+        tokenConfigured: !!this.cloudflaredConfig?.token,
+        token: adminAuthValid ? (this.cloudflaredConfig?.token || '') : (this.cloudflaredConfig?.token ? '******' : ''),
+        hostname: this.cloudflaredConfig?.hostname || '',
+        autoStart: Boolean(this.cloudflaredConfig?.autoStart),
       },
 
       customTunnel: {
@@ -551,6 +557,7 @@ class BridgeService {
           ? await this.qrCache.get(customUrl)
           : null,
         state: this.customTunnelState,
+        autoStart: Boolean(this.customTunnelConfig?.autoStart),
       },
 
       // 轻量摘要，供 UI Tab 状态点使用（完整状态由 wechatGetStatus 提供）
@@ -558,7 +565,33 @@ class BridgeService {
     };
   }
 
-  async startCustomTunnel() {
+  async saveCloudflaredConfig({ token, hostname }) {
+    this.cloudflaredConfig = {
+      ...(this.cloudflaredConfig ?? {}),
+      token: token ? String(token).trim() : '',
+      hostname: hostname ? String(hostname).trim() : '',
+    };
+    await this.onPersist?.({ cloudflared: this.cloudflaredConfig });
+  }
+
+  async setTunnelAutoStart({ tunnel, autoStart }) {
+    const isAuto = Boolean(autoStart);
+    if (tunnel === 'cloudflared') {
+      this.cloudflaredConfig = {
+        ...(this.cloudflaredConfig ?? {}),
+        autoStart: isAuto,
+      };
+      await this.onPersist?.({ cloudflared: this.cloudflaredConfig });
+    } else if (tunnel === 'customTunnel' || tunnel === 'custom') {
+      this.customTunnelConfig = {
+        ...(this.customTunnelConfig ?? {}),
+        autoStart: isAuto,
+      };
+      await this.onPersist?.({ customTunnel: this.customTunnelConfig });
+    }
+  }
+
+  async startCustomTunnel({ autoStart = true } = {}) {
     if (this.customTunnel) {
       throw new Error('自建隧道已在运行');
     }
@@ -567,9 +600,15 @@ class BridgeService {
     const accessToken = this.customTunnelConfig?.accessToken;
 
     if (!serverUrl || !accessToken) {
-      throw new Error('缺少配置：请在 cordis.yml 中配置 customTunnel.serverUrl 和 customTunnel.accessToken');
+      throw new Error('缺少配置：请在控制台配置 customTunnel.serverUrl 和 customTunnel.accessToken');
     }
 
+    this.customTunnelConfig = {
+      ...(this.customTunnelConfig ?? {}),
+      autoStart: Boolean(autoStart),
+    };
+    await this.onPersist?.({ customTunnel: this.customTunnelConfig });
+
     this.customTunnel = new CustomTunnelClient({
       serverUrl,
       accessToken,
@@ -584,23 +623,36 @@ class BridgeService {
     await this.customTunnel.connect();
   }
 
-  stopCustomTunnel() {
+  async stopCustomTunnel() {
     if (this.customTunnel) {
       this.customTunnel.disconnect();
       this.customTunnel = null;
       this.customTunnelState = { phase: 'idle', detail: '' };
     }
+    this.customTunnelConfig = {
+      ...(this.customTunnelConfig ?? {}),
+      autoStart: false,
+    };
+    await this.onPersist?.({ customTunnel: this.customTunnelConfig });
   }
 
-  async startCloudflared() {
+  async startCloudflared({ autoStart = true } = {}) {
     if (this.cloudflared) {
       throw new Error('Cloudflare 隧道已在运行');
     }
 
+    this.cloudflaredConfig = {
+      ...(this.cloudflaredConfig ?? {}),
+      autoStart: Boolean(autoStart),
+    };
+    await this.onPersist?.({ cloudflared: this.cloudflaredConfig });
+
     this.cloudflaredState = { phase: 'connecting', detail: '正在初始化...' };
     this.cloudflared = new CloudflaredManager({
       port: this.proxyPort,
       home: this.home,
+      token: this.cloudflaredConfig?.token,
+      hostname: this.cloudflaredConfig?.hostname,
       onStateChange: (state) => {
         this.cloudflaredState = state;
         // 出错时自动清理，让用户可以重新开启
@@ -615,17 +667,22 @@ class BridgeService {
     this.cloudflared.start();
   }
 
-  stopCloudflared() {
+  async stopCloudflared() {
     if (this.cloudflared) {
       this.cloudflared.stop();
       this.cloudflared = null;
       this.cloudflaredState = { phase: 'idle', detail: '' };
     }
+    this.cloudflaredConfig = {
+      ...(this.cloudflaredConfig ?? {}),
+      autoStart: false,
+    };
+    await this.onPersist?.({ cloudflared: this.cloudflaredConfig });
   }
 
   // 重置 Cloudflare 隧道：关闭隧道 + 删除已下载的 cloudflared 二进制
   async resetCloudflared() {
-    this.stopCloudflared();
+    await this.stopCloudflared();
     const binDir = join(this.home ?? join(homedir(), '.dsh-bridge'), 'bin');
     const candidates = ['cloudflared.exe', 'cloudflared'];
     for (const name of candidates) {
@@ -835,15 +892,38 @@ function apply(ctx, config = {}) {
     proxyPort,
     home: config.home,
     customTunnelConfig: config.customTunnel ?? null,
+    cloudflaredConfig: config.cloudflared ?? null,
     authManager,
+    onPersist: async (patch) => {
+      const stored = await loadConfig();
+      Object.assign(stored, patch);
+      await saveConfig(stored);
+    },
     logger,
   });
 
-  // 启动时读取已保存的自建隧道配置
-  loadConfig().then((stored) => {
-    if (stored?.customTunnel?.serverUrl) {
+  // 启动时读取已保存的公网隧道配置并按需自动拉起
+  loadConfig().then(async (stored) => {
+    if (stored?.cloudflared) {
+      service.cloudflaredConfig = stored.cloudflared;
+      logger.info('dsh-bridge: loaded saved cloudflared config (autoStart=%s, tokenConfigured=%s)', Boolean(service.cloudflaredConfig.autoStart), Boolean(service.cloudflaredConfig.token));
+      if (service.cloudflaredConfig.autoStart) {
+        logger.info('dsh-bridge: auto-starting cloudflared tunnel...');
+        service.startCloudflared({ autoStart: true }).catch((err) => {
+          logger.error('dsh-bridge: cloudflared auto-start failed: %s', err?.message ?? err);
+        });
+      }
+    }
+
+    if (stored?.customTunnel) {
       service.customTunnelConfig = stored.customTunnel;
-      logger.info('dsh-bridge: loaded saved custom tunnel config');
+      logger.info('dsh-bridge: loaded saved custom tunnel config (autoStart=%s)', Boolean(service.customTunnelConfig.autoStart));
+      if (service.customTunnelConfig.autoStart && service.customTunnelConfig.serverUrl) {
+        logger.info('dsh-bridge: auto-starting custom tunnel...');
+        service.startCustomTunnel({ autoStart: true }).catch((err) => {
+          logger.error('dsh-bridge: custom tunnel auto-start failed: %s', err?.message ?? err);
+        });
+      }
     }
   }).catch(() => {});
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@wenbin_wb/dsh-bridge",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "手机扫码即可在移动端/公网继续用 DeepSeek Harness，人不在电脑前也能接着干。一键局域网二维码、Cloudflare 公网隧道、自建隧道与微信 / QQ / 飞书 / Telegram Bot（多工作区/会话持久化/媒体/卡片审批/流式输出），无需自己搭公网服务器。",
-  "releaseNotes": "【v2.6.0 移动端交互重构与长按菜单】\n• 📱 深度重构移动端触控交互，极简通透顶栏与大圆角输入胶囊\n• 🖐️ 侧边栏支持长按（Long Press）呼出操作菜单（重命名/分叉/归档），边缘滑动开闭抽屉\n• 🛠️ 彻底修复「运行中」等状态药丸徽标在手机屏幕下的换行问题\n• ⚡ 优化版本检查与升级提示，直观展示新版本更新内容亮点",
+  "releaseNotes": "【v2.6.1 公网隧道自启与固定域名】\n• 🔄 支持公网隧道（Cloudflare/自建）开机自启与重启状态记忆\n• 🌐 支持 Cloudflare 命名隧道（Token 模式），永久固定专属域名永不变更\n• ⚙️ 控制台新增「随 DSH 启动自动开启」开关与高级 Token 配置",
   "type": "module",
   "main": "lib/index.js",
   "exports": {