@wenbin_wb/dsh-bridge 2.10.8 → 2.10.10

package/CHANGELOG.md

@@ -4,6 +4,33 @@
 
 ---
 
+## [v2.10.10] - 2026-09-14
+
+### ✨ 新功能
+
+- **设置页新增「高级设置」**（每个 IM 平台卡片内）：可直接配置该平台远程会话的 **Agent 预设**（下拉列出本机可用预设，留空使用 DSH 默认预设）、**工作区目录**、**模型提供方 / 模型**，以及进度摘要间隔、审批超时、单条消息上限、分块发送间隔。保存后立即生效，并随宿主重启保留——此前这四个会话级配置没有任何界面入口，只能手改 `config.json`，节奏参数的面板也已在早前重构中丢失。
+
+### 🐞 修复
+
+- **DSH 0.1.5 系列上远程 IM 会话工具集残缺**（issue #40）：DSH 从 `0.1.5` 起把 agent 侧的工具、提示词与技能目录整体挪到了 agent preset 后面（宿主层不再挂载 `tool-fs` / `tool-bash` / `tool-jobs` / `tool-skill` 等），改由每个会话在创建时挂载预设提供。桥此前只把预设名写进会话元数据、从未真正挂载，会话因此落在「空预设层」——表现为远程 Agent 缺少工具（例如没有读文件的工具）。现在新建与恢复会话都会真实挂载预设：未配置时使用 DSH 自身的默认预设；配置的预设在本机已不存在时回退默认预设，并在会话创建提示里明确告知，不再静默降级。
+- **宿主重启后给已有会话发消息报 `session "..." already exists`、随后卡在「当前没有活动会话」**（issue #39）：判断会话是否已持久化时沿用了旧的数据结构假设，而 DSH 0.1.5 的会话列表返回的是 `{ header, revision, sizeBytes }` 快照，`entry.id` 恒为空——已存在的历史会话被误判成新会话，走 `agents.create` 建同名会话而失败。现按真实结构取会话头，重启后能正常恢复续聊。
+- **远程会话的工作区与预设配置重启即丢**（issue #40）：`cwd`、`agentPreset`、`agentProvider`、`agentModel` 写进配置后，宿主重启即失效（恢复链路只回写了白名单里的少数字段），远程会话会掉到默认目录与默认预设。现已在重启恢复与配置备份导入时一并读回；同时补上 QQ / 飞书此前遗漏的摘要间隔、审批超时、分块延时恢复。配置的工作区目录不可用（被删、换机器、写成相对路径）时回落到已注册工作区并提示，不再把会话建在不存在的目录上。
+- **`/rename` 改名重启即失效**：此前调用的是 `sessionPersistence.update()`——DSH 的持久化服务根本没有这个方法，被可选链静默跳过，改名只改了内存对象。现改用 DSH 原生会话标题服务（追加 `session/title` 事件并落盘），重启与 Web 侧边栏都能看到新标题；会话尚未恢复时会明确提示而不是假报成功。
+
+---
+
+## [v2.10.9] - 2026-09-12
+
+### 🐞 修复
+
+- **DSH 0.1.5 系列上 `dsh web` 启动即崩**（issue #38）：DSH 从 `0.1.5-alpha.1` 起，宿主自带的 `dsh-client-connection` 调整了插件级服务声明却遗漏了一处同步修改，导致凡是注册 RPC 通道的插件都会让**整棵插件树加载失败**、`dsh web` 直接退出（报 `cannot get property "webServer" without inject`）。现已插件侧兼容：正常路径完全不变，仅在命中该宿主缺陷时自动补上解析兜底并完成通道注册，上游修复后自动空转、无副作用。DSH `0.1.5-alpha.1` / `alpha.2` / `rc.1` / `rc.2`（含当前最新版）均已实测通过，`0.1.0`~`0.1.4` 行为不变。
+
+### ✨ 优化
+
+- **与 DSH 原生鉴权（`0.1.2` 起内置）确认兼容并加固**：反代转发时自动注入 DSH 要求的回环会话 cookie，手机 / 局域网 / 隧道访问无需处理 DSH 自身的 `?token=` 登录流程；同时修正凭据解析——当 DSH 凭据文件里存在多条密钥记录时，确保取用浏览器会话记录对应的密钥，避免远程访问出现 401。
+
+---
+
 ## [v2.10.8] - 2026-09-08
 
 ### ✨ 新功能

package/README.en.md

@@ -48,6 +48,7 @@
   - [7. 📊 Maintenance Dashboard & Graceful Restart](#7-📊-maintenance-dashboard--graceful-restart)
 - [💬 FAQ](#-faq)
 - [🛠️ Development & Contribution](#️-development--contribution)
+- [⭐ Star History](#-star-history)
 - [📄 License](#-license)
 
 ---
@@ -77,6 +78,20 @@ node -v   # v22.19+ or v24+
 dsh --version
 ```
 
+### DSH version compatibility
+
+This plugin supports **both old and new DSH releases** — there is no need to pick a plugin version to match your harness.
+
+| DSH version | Status |
+| --- | --- |
+| `0.1.0` ~ `0.1.1` | ✅ Supported (loopback-only RPC channel hardening) |
+| `0.1.2` ~ `0.1.4` | ✅ Supported |
+| `0.1.5-alpha.1` ~ `0.1.5-rc.2` | ✅ Supported (since v2.10.9) |
+
+> **About the built-in DSH authentication**: since `0.1.2`, `dsh web` ships browser authentication — it prints a URL carrying a one-time token (`http://127.0.0.1:3080/?token=…`), which is exchanged for a session cookie bound to the loopback address. Afterwards `/`, `/api` and every plugin RPC channel require that cookie.
+>
+> This is **complementary to, not a duplicate of**, this plugin's access-password gate: the built-in auth protects "the DSH process on local loopback", while this plugin's gate protects "remote access arriving over LAN or a public tunnel". The plugin's reverse proxy injects a valid loopback session cookie while forwarding, so phone / tunnel access needs **no** manual handling of DSH's `?token=` — just use it as documented on this page.
+
 ### Installation
 
 ```bash
@@ -405,6 +420,18 @@ dsh plugin --profile web add .
 
 ---
 
+## ⭐ Star History
+
+<a href="https://www.star-history.com/?repos=wenbin-wb%2Fdsh-bridge&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=wenbin-wb/dsh-bridge&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=wenbin-wb/dsh-bridge&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=wenbin-wb/dsh-bridge&type=date&legend=top-left" />
+ </picture>
+</a>
+
+---
+
 ## 📄 License
 
 MIT © [wenbin-wb](https://github.com/wenbin-wb)

package/README.md

@@ -48,6 +48,7 @@
   - [7. 📊 运维监控看板与一键平滑重启](#7-📊-运维监控看板与一键平滑重启)
 - [💬 常见问题 (FAQ)](#-常见问题-faq)
 - [🛠️ 开发与贡献](#️-开发与贡献)
+- [⭐ Star History](#-star-history)
 - [📄 开源协议](#-开源协议)
 
 ---
@@ -79,6 +80,20 @@ node -v   # 应显示 v22.19+ 或 v24+
 dsh --version
 ```
 
+### DSH 版本兼容性
+
+本插件**同时兼容新旧 DSH**，无需按 DSH 版本挑选插件版本：
+
+| DSH 版本 | 状态 |
+| --- | --- |
+| `0.1.0` ~ `0.1.1` | ✅ 支持（回环专用 RPC 通道加固） |
+| `0.1.2` ~ `0.1.4` | ✅ 支持 |
+| `0.1.5-alpha.1` ~ `0.1.5-rc.2` | ✅ 支持（v2.10.9 起） |
+
+> **关于 DSH 原生鉴权**：DSH 从 `0.1.2` 起为 `dsh web` 内置了浏览器鉴权——启动时会打印带一次性 token 的地址（`http://127.0.0.1:3080/?token=…`），换取一枚绑定回环地址的会话 cookie，此后 `/`、`/api` 及各插件 RPC 通道都要求该 cookie。
+>
+> 这与本插件的**访问密码门禁是两层互补的防护**，不冲突也不重复：原生鉴权保护的是"本机回环上的 DSH 进程"，本插件的门禁保护的是"经局域网 / 公网隧道进入的远程访问"。本插件的反向代理会在转发时自动注入合法的回环会话 cookie，因此手机 / 隧道访问**无需**手动处理 DSH 的 `?token=`，按本页说明正常使用即可。
+
 ### 安装插件
 
 ```bash
@@ -427,6 +442,18 @@ dsh plugin --profile web add .
 
 ---
 
+## ⭐ Star History
+
+<a href="https://www.star-history.com/?repos=wenbin-wb%2Fdsh-bridge&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=wenbin-wb/dsh-bridge&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=wenbin-wb/dsh-bridge&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=wenbin-wb/dsh-bridge&type=date&legend=top-left" />
+ </picture>
+</a>
+
+---
+
 ## 📄 开源协议
 
 本项目基于 [MIT 许可证](LICENSE) 开源发布。

package/client/client.js

@@ -1091,6 +1091,8 @@ var BRIDGE_ENDPOINTS = {
   platformStop: "platformStop",
   platformStart: "platformStart",
   platformUnbind: "platformUnbind",
+  // 本机可用的 DSH agent preset（设置页下拉用；老版本 DSH 返回 available:false）
+  listAgentPresets: "listAgentPresets",
   // 微信 Bot（v1.x 向后兼容别名，deprecated）
   wechatGetStatus: "wechatGetStatus",
   wechatLogin: "wechatLogin",
@@ -2652,10 +2654,29 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall }) {
         appSecret: "",
         domain: platform.config.domain ?? "feishu",
         botToken: "",
-        proxy: platform.config.proxy ?? ""
+        proxy: platform.config.proxy ?? "",
+        // 会话级配置：留空 = 使用 DSH 默认值
+        agentPreset: platform.config.agentPreset ?? "",
+        cwd: platform.config.cwd ?? "",
+        agentProvider: platform.config.agentProvider ?? "",
+        agentModel: platform.config.agentModel ?? ""
       });
     }
   }, [platform?.config, platformId]);
+  const [presetOptions, setPresetOptions] = React.useState(null);
+  React.useEffect(() => {
+    let cancelled = false;
+    (async () => {
+      try {
+        const r = await rpcCall(BRIDGE_ENDPOINTS.listAgentPresets, {});
+        if (!cancelled && r?.ok) setPresetOptions(r.value ?? { available: false, presets: [] });
+      } catch {
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [rpcCall]);
   const loadInFlightRef = React.useRef(false);
   const seqRef = React.useRef(0);
   const load = React.useCallback(async (quiet = false) => {
@@ -2746,7 +2767,12 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall }) {
       digestIntervalSec: num(cfgDraft.digestIntervalSec, platform?.config?.digestIntervalSec ?? 300),
       approvalTimeoutSec: num(cfgDraft.approvalTimeoutSec, platform?.config?.approvalTimeoutSec ?? 600),
       maxMessageChars: num(cfgDraft.maxMessageChars, platform?.config?.maxMessageChars ?? 2e3),
-      sendChunkDelayMs: num(cfgDraft.sendChunkDelayMs, platform?.config?.sendChunkDelayMs ?? 1500)
+      sendChunkDelayMs: num(cfgDraft.sendChunkDelayMs, platform?.config?.sendChunkDelayMs ?? 1500),
+      // 会话级配置：空串表示清除该设置、回落 DSH 默认值
+      agentPreset: (cfgDraft.agentPreset ?? "").trim(),
+      cwd: (cfgDraft.cwd ?? "").trim(),
+      agentProvider: (cfgDraft.agentProvider ?? "").trim(),
+      agentModel: (cfgDraft.agentModel ?? "").trim()
     };
     if (platformId === "qq") {
       payload.appId = cfgDraft.appId.trim();
@@ -2761,7 +2787,7 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall }) {
     }
     await act(BRIDGE_ENDPOINTS.platformSetConfig, payload);
   }, [act, cfgDraft, platformId]);
-  const cfgDirty = cfgDraft && platform?.config && (Number(cfgDraft.digestIntervalSec) !== platform.config.digestIntervalSec || Number(cfgDraft.approvalTimeoutSec) !== platform.config.approvalTimeoutSec || Number(cfgDraft.maxMessageChars) !== platform.config.maxMessageChars || Number(cfgDraft.sendChunkDelayMs) !== platform.config.sendChunkDelayMs || platformId === "qq" && (cfgDraft.appId !== (platform.config.appId ?? "") || cfgDraft.clientSecret !== (platform.config.clientSecret ?? "")) || platformId === "feishu" && (cfgDraft.appId !== (platform.config.appId ?? "") || cfgDraft.appSecret !== (platform.config.appSecret ?? "")) || platformId === "telegram" && (cfgDraft.botToken !== "" || cfgDraft.proxy !== (platform.config.proxy ?? "")));
+  const cfgDirty = cfgDraft && platform?.config && (Number(cfgDraft.digestIntervalSec) !== platform.config.digestIntervalSec || Number(cfgDraft.approvalTimeoutSec) !== platform.config.approvalTimeoutSec || Number(cfgDraft.maxMessageChars) !== platform.config.maxMessageChars || Number(cfgDraft.sendChunkDelayMs) !== platform.config.sendChunkDelayMs || (cfgDraft.agentPreset ?? "") !== (platform.config.agentPreset ?? "") || (cfgDraft.cwd ?? "") !== (platform.config.cwd ?? "") || (cfgDraft.agentProvider ?? "") !== (platform.config.agentProvider ?? "") || (cfgDraft.agentModel ?? "") !== (platform.config.agentModel ?? "") || platformId === "qq" && (cfgDraft.appId !== (platform.config.appId ?? "") || cfgDraft.clientSecret !== (platform.config.clientSecret ?? "")) || platformId === "feishu" && (cfgDraft.appId !== (platform.config.appId ?? "") || cfgDraft.appSecret !== (platform.config.appSecret ?? "")) || platformId === "telegram" && (cfgDraft.botToken !== "" || cfgDraft.proxy !== (platform.config.proxy ?? "")));
   if (!platform && !err) {
     return React.createElement(
       "div",
@@ -3006,6 +3032,121 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall }) {
         }),
         React.createElement("span", null, "\u7FA4\u804A\u81EA\u52A8\u6388\u6743\uFF08\u65B0\u7FA4\u9996\u6B21 @\u673A\u5668\u4EBA \u81EA\u52A8\u52A0\u5165\u767D\u540D\u5355\uFF0C\u9ED8\u8BA4\u5173\u95ED\uFF09")
       ),
+      // 高级设置：会话级配置（工作区 / Agent 预设 / 模型路由）+ 会话节奏参数
+      React.createElement(
+        "div",
+        { style: { marginTop: 12 } },
+        React.createElement("button", {
+          style: s.btnGhost,
+          onClick: () => setShowAdvanced((v) => !v)
+        }, showAdvanced ? "\u6536\u8D77\u9AD8\u7EA7\u8BBE\u7F6E" : "\u2699\uFE0F \u9AD8\u7EA7\u8BBE\u7F6E"),
+        showAdvanced && React.createElement(
+          "div",
+          { style: { ...s.block, marginTop: 8, display: "flex", flexDirection: "column", gap: 10 } },
+          React.createElement(
+            "div",
+            { style: { ...s.muted, fontSize: 12, lineHeight: 1.6 } },
+            "\u4EE5\u4E0B\u8BBE\u7F6E\u6309\u5E73\u53F0\u4FDD\u5B58\uFF0C\u53EA\u5F71\u54CD\u8BE5\u5E73\u53F0\u901A\u8FC7 Bot \u65B0\u5EFA\u7684\u4F1A\u8BDD\uFF08\u7559\u7A7A = \u4F7F\u7528 DSH \u9ED8\u8BA4\u503C\uFF09\u3002"
+          ),
+          // Agent 预设：决定远程会话挂载哪些工具/技能
+          React.createElement(
+            "div",
+            null,
+            React.createElement("div", { style: { ...s.muted, marginBottom: 4 } }, "Agent \u9884\u8BBE \u2014 \u51B3\u5B9A\u8FDC\u7A0B\u4F1A\u8BDD\u53EF\u7528\u7684\u5DE5\u5177\u4E0E\u6280\u80FD\uFF0C\u7559\u7A7A\u7528 DSH \u9ED8\u8BA4\u9884\u8BBE"),
+            React.createElement("input", {
+              style: { ...s.input, width: "100%" },
+              list: "dsh-bridge-agent-presets",
+              placeholder: presetOptions?.default ? `\u7559\u7A7A = DSH \u9ED8\u8BA4\uFF08${presetOptions.default}\uFF09` : "\u7559\u7A7A = DSH \u9ED8\u8BA4\u9884\u8BBE",
+              value: cfgDraft?.agentPreset ?? "",
+              onChange: (e) => setCfgDraft((d) => ({ ...d, agentPreset: e.target.value }))
+            }),
+            React.createElement(
+              "datalist",
+              { id: "dsh-bridge-agent-presets" },
+              (presetOptions?.presets ?? []).map((p) => React.createElement("option", { key: p.id, value: p.id }, p.name && p.name !== p.id ? p.name : null))
+            ),
+            React.createElement(
+              "div",
+              { style: { ...s.muted, fontSize: 11, marginTop: 4 } },
+              presetOptions == null ? "\u6B63\u5728\u8BFB\u53D6\u672C\u673A\u53EF\u7528\u9884\u8BBE\u2026" : presetOptions.available ? `\u672C\u673A\u53EF\u7528\uFF1A${(presetOptions.presets ?? []).map((p) => p.id).join(" / ") || "\uFF08\u65E0\uFF09"}` : "\u5F53\u524D DSH \u7248\u672C\u672A\u63D0\u4F9B\u9884\u8BBE\u5217\u8868\uFF0C\u8BF7\u624B\u52A8\u586B\u5199\u9884\u8BBE\u540D"
+            )
+          ),
+          // 工作区
+          React.createElement(
+            "div",
+            null,
+            React.createElement("div", { style: { ...s.muted, marginBottom: 4 } }, "\u5DE5\u4F5C\u533A\u76EE\u5F55 \u2014 \u8BE5\u5E73\u53F0 /new \u65B0\u5EFA\u4F1A\u8BDD\u7684\u9ED8\u8BA4\u76EE\u5F55\uFF0C\u7559\u7A7A\u7528\u9996\u4E2A\u5DF2\u6CE8\u518C\u5DE5\u4F5C\u533A"),
+            React.createElement("input", {
+              style: { ...s.input, width: "100%" },
+              placeholder: "\u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u4F8B\u5982 /home/me/project \u6216 D:\\project",
+              value: cfgDraft?.cwd ?? "",
+              onChange: (e) => setCfgDraft((d) => ({ ...d, cwd: e.target.value }))
+            })
+          ),
+          // 模型路由
+          React.createElement(
+            "div",
+            { style: { display: "grid", gridTemplateColumns: "repeat(auto-fit, minmax(160px, 1fr))", gap: 8 } },
+            React.createElement(
+              "div",
+              null,
+              React.createElement("div", { style: { ...s.muted, marginBottom: 4 } }, "\u6A21\u578B\u63D0\u4F9B\u65B9\uFF08\u53EF\u9009\uFF09"),
+              React.createElement("input", {
+                style: { ...s.input, width: "100%" },
+                placeholder: "\u7559\u7A7A = DSH \u9ED8\u8BA4",
+                value: cfgDraft?.agentProvider ?? "",
+                onChange: (e) => setCfgDraft((d) => ({ ...d, agentProvider: e.target.value }))
+              })
+            ),
+            React.createElement(
+              "div",
+              null,
+              React.createElement("div", { style: { ...s.muted, marginBottom: 4 } }, "\u6A21\u578B\uFF08\u53EF\u9009\uFF09"),
+              React.createElement("input", {
+                style: { ...s.input, width: "100%" },
+                placeholder: "\u7559\u7A7A = DSH \u9ED8\u8BA4",
+                value: cfgDraft?.agentModel ?? "",
+                onChange: (e) => setCfgDraft((d) => ({ ...d, agentModel: e.target.value }))
+              })
+            )
+          ),
+          // 会话节奏参数
+          React.createElement(
+            "div",
+            { style: { display: "grid", gridTemplateColumns: "repeat(auto-fit, minmax(150px, 1fr))", gap: 8 } },
+            [
+              ["digestIntervalSec", "\u8FDB\u5EA6\u6458\u8981\u95F4\u9694\uFF08\u79D2\uFF09"],
+              ["approvalTimeoutSec", "\u5BA1\u6279\u8D85\u65F6\uFF08\u79D2\uFF09"],
+              ["maxMessageChars", "\u5355\u6761\u6D88\u606F\u4E0A\u9650\uFF08\u5B57\u7B26\uFF09"],
+              ["sendChunkDelayMs", "\u5206\u5757\u53D1\u9001\u95F4\u9694\uFF08\u6BEB\u79D2\uFF09"]
+            ].map(([key, label]) => React.createElement(
+              "div",
+              { key },
+              React.createElement("div", { style: { ...s.muted, marginBottom: 4 } }, label),
+              React.createElement("input", {
+                style: { ...s.input, width: "100%" },
+                inputMode: "numeric",
+                value: cfgDraft?.[key] ?? "",
+                onChange: (e) => setCfgDraft((d) => ({ ...d, [key]: e.target.value }))
+              })
+            ))
+          ),
+          React.createElement(
+            "div",
+            { style: { display: "flex", gap: 8, alignItems: "center", flexWrap: "wrap" } },
+            React.createElement("button", {
+              style: { ...s.btnPri, opacity: busy || !cfgDirty ? 0.5 : 1 },
+              onClick: saveConfig,
+              disabled: busy || !cfgDirty
+            }, busy ? "\u4FDD\u5B58\u4E2D\u2026" : "\u4FDD\u5B58\u9AD8\u7EA7\u8BBE\u7F6E"),
+            React.createElement("button", {
+              style: { ...s.btnGhost },
+              onClick: resetDefaults,
+              disabled: busy
+            }, "\u6062\u590D\u63A8\u8350\u8282\u594F\u53C2\u6570")
+          )
+        )
+      ),
       // 飞书 / Telegram 扫码直达对话引导卡片
       (platformId === "feishu" || platformId === "telegram") && platform.botQr && React.createElement(
         "div",

package/client/index.js

@@ -1396,10 +1396,28 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall }) {
         domain: platform.config.domain ?? 'feishu',
         botToken: '',
         proxy: platform.config.proxy ?? '',
+        // 会话级配置：留空 = 使用 DSH 默认值
+        agentPreset: platform.config.agentPreset ?? '',
+        cwd: platform.config.cwd ?? '',
+        agentProvider: platform.config.agentProvider ?? '',
+        agentModel: platform.config.agentModel ?? '',
       });
     }
   }, [platform?.config, platformId]);
 
+  // 本机可用的 DSH agent preset（旧版本 DSH 返回 available:false → 退化为手填）
+  const [presetOptions, setPresetOptions] = React.useState(null);
+  React.useEffect(() => {
+    let cancelled = false;
+    (async () => {
+      try {
+        const r = await rpcCall(BRIDGE_ENDPOINTS.listAgentPresets, {});
+        if (!cancelled && r?.ok) setPresetOptions(r.value ?? { available: false, presets: [] });
+      } catch { /* 读取失败保持手填 */ }
+    })();
+    return () => { cancelled = true; };
+  }, [rpcCall]);
+
   const loadInFlightRef = React.useRef(false);
   const seqRef = React.useRef(0);
   const load = React.useCallback(async (quiet = false) => {
@@ -1507,6 +1525,11 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall }) {
       approvalTimeoutSec: num(cfgDraft.approvalTimeoutSec, platform?.config?.approvalTimeoutSec ?? 600),
       maxMessageChars:    num(cfgDraft.maxMessageChars,    platform?.config?.maxMessageChars    ?? 2000),
       sendChunkDelayMs:   num(cfgDraft.sendChunkDelayMs,   platform?.config?.sendChunkDelayMs   ?? 1500),
+      // 会话级配置：空串表示清除该设置、回落 DSH 默认值
+      agentPreset:   (cfgDraft.agentPreset ?? '').trim(),
+      cwd:           (cfgDraft.cwd ?? '').trim(),
+      agentProvider: (cfgDraft.agentProvider ?? '').trim(),
+      agentModel:    (cfgDraft.agentModel ?? '').trim(),
     };
     // QQ / 飞书 / Telegram 平台额外携带凭证
     if (platformId === 'qq') {
@@ -1527,6 +1550,10 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall }) {
     Number(cfgDraft.approvalTimeoutSec) !== platform.config.approvalTimeoutSec ||
     Number(cfgDraft.maxMessageChars)    !== platform.config.maxMessageChars    ||
     Number(cfgDraft.sendChunkDelayMs)   !== platform.config.sendChunkDelayMs   ||
+    (cfgDraft.agentPreset ?? '')   !== (platform.config.agentPreset ?? '')     ||
+    (cfgDraft.cwd ?? '')           !== (platform.config.cwd ?? '')             ||
+    (cfgDraft.agentProvider ?? '') !== (platform.config.agentProvider ?? '')   ||
+    (cfgDraft.agentModel ?? '')    !== (platform.config.agentModel ?? '')      ||
     (platformId === 'qq' && (
       cfgDraft.appId !== (platform.config.appId ?? '') ||
       cfgDraft.clientSecret !== (platform.config.clientSecret ?? '')
@@ -1747,6 +1774,99 @@ function PlatformCard({ platformId, platformName, platformDesc, rpcCall }) {
         }),
         React.createElement('span', null, '群聊自动授权（新群首次 @机器人 自动加入白名单，默认关闭）'),
       ),
+      // 高级设置：会话级配置（工作区 / Agent 预设 / 模型路由）+ 会话节奏参数
+      React.createElement('div', { style: { marginTop: 12 } },
+        React.createElement('button', {
+          style: s.btnGhost,
+          onClick: () => setShowAdvanced(v => !v),
+        }, showAdvanced ? '收起高级设置' : '⚙️ 高级设置'),
+        showAdvanced && React.createElement('div', { style: { ...s.block, marginTop: 8, display: 'flex', flexDirection: 'column', gap: 10 } },
+          React.createElement('div', { style: { ...s.muted, fontSize: 12, lineHeight: 1.6 } },
+            '以下设置按平台保存，只影响该平台通过 Bot 新建的会话（留空 = 使用 DSH 默认值）。'),
+          // Agent 预设：决定远程会话挂载哪些工具/技能
+          React.createElement('div', null,
+            React.createElement('div', { style: { ...s.muted, marginBottom: 4 } }, 'Agent 预设 — 决定远程会话可用的工具与技能，留空用 DSH 默认预设'),
+            React.createElement('input', {
+              style: { ...s.input, width: '100%' },
+              list: 'dsh-bridge-agent-presets',
+              placeholder: presetOptions?.default ? `留空 = DSH 默认（${presetOptions.default}）` : '留空 = DSH 默认预设',
+              value: cfgDraft?.agentPreset ?? '',
+              onChange: (e) => setCfgDraft(d => ({ ...d, agentPreset: e.target.value })),
+            }),
+            React.createElement('datalist', { id: 'dsh-bridge-agent-presets' },
+              (presetOptions?.presets ?? []).map((p) =>
+                React.createElement('option', { key: p.id, value: p.id }, p.name && p.name !== p.id ? p.name : null)),
+            ),
+            React.createElement('div', { style: { ...s.muted, fontSize: 11, marginTop: 4 } },
+              presetOptions == null
+                ? '正在读取本机可用预设…'
+                : presetOptions.available
+                  ? `本机可用：${(presetOptions.presets ?? []).map((p) => p.id).join(' / ') || '（无）'}`
+                  : '当前 DSH 版本未提供预设列表，请手动填写预设名'),
+          ),
+          // 工作区
+          React.createElement('div', null,
+            React.createElement('div', { style: { ...s.muted, marginBottom: 4 } }, '工作区目录 — 该平台 /new 新建会话的默认目录，留空用首个已注册工作区'),
+            React.createElement('input', {
+              style: { ...s.input, width: '100%' },
+              placeholder: '绝对路径，例如 /home/me/project 或 D:\\project',
+              value: cfgDraft?.cwd ?? '',
+              onChange: (e) => setCfgDraft(d => ({ ...d, cwd: e.target.value })),
+            }),
+          ),
+          // 模型路由
+          React.createElement('div', { style: { display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(160px, 1fr))', gap: 8 } },
+            React.createElement('div', null,
+              React.createElement('div', { style: { ...s.muted, marginBottom: 4 } }, '模型提供方（可选）'),
+              React.createElement('input', {
+                style: { ...s.input, width: '100%' },
+                placeholder: '留空 = DSH 默认',
+                value: cfgDraft?.agentProvider ?? '',
+                onChange: (e) => setCfgDraft(d => ({ ...d, agentProvider: e.target.value })),
+              }),
+            ),
+            React.createElement('div', null,
+              React.createElement('div', { style: { ...s.muted, marginBottom: 4 } }, '模型（可选）'),
+              React.createElement('input', {
+                style: { ...s.input, width: '100%' },
+                placeholder: '留空 = DSH 默认',
+                value: cfgDraft?.agentModel ?? '',
+                onChange: (e) => setCfgDraft(d => ({ ...d, agentModel: e.target.value })),
+              }),
+            ),
+          ),
+          // 会话节奏参数
+          React.createElement('div', { style: { display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(150px, 1fr))', gap: 8 } },
+            [
+              ['digestIntervalSec', '进度摘要间隔（秒）'],
+              ['approvalTimeoutSec', '审批超时（秒）'],
+              ['maxMessageChars', '单条消息上限（字符）'],
+              ['sendChunkDelayMs', '分块发送间隔（毫秒）'],
+            ].map(([key, label]) =>
+              React.createElement('div', { key },
+                React.createElement('div', { style: { ...s.muted, marginBottom: 4 } }, label),
+                React.createElement('input', {
+                  style: { ...s.input, width: '100%' },
+                  inputMode: 'numeric',
+                  value: cfgDraft?.[key] ?? '',
+                  onChange: (e) => setCfgDraft(d => ({ ...d, [key]: e.target.value })),
+                }),
+              )),
+          ),
+          React.createElement('div', { style: { display: 'flex', gap: 8, alignItems: 'center', flexWrap: 'wrap' } },
+            React.createElement('button', {
+              style: { ...s.btnPri, opacity: (busy || !cfgDirty) ? 0.5 : 1 },
+              onClick: saveConfig,
+              disabled: busy || !cfgDirty,
+            }, busy ? '保存中…' : '保存高级设置'),
+            React.createElement('button', {
+              style: { ...s.btnGhost },
+              onClick: resetDefaults,
+              disabled: busy,
+            }, '恢复推荐节奏参数'),
+          ),
+        ),
+      ),
       // 飞书 / Telegram 扫码直达对话引导卡片
       (platformId === 'feishu' || platformId === 'telegram') && platform.botQr && React.createElement('div', {
         style: {

package/lib/auth/dsh-native-cookie.js

@@ -0,0 +1,148 @@
+// DSH 原生浏览器鉴权的兼容层（lib/auth/dsh-native-cookie.js）
+//
+// 背景
+// ---------------------------------------------------------------
+// DSH 从 0.1.2 起为 `dsh web` 引入了"原生浏览器鉴权"：
+//   1. 启动时打印带一次性 launch token 的地址：http://127.0.0.1:<port>/?token=…
+//   2. `GET /?token=<token>` 校验通过后 303 重定向到 `/`，并下发签名会话 cookie
+//   3. 此后所有受保护路由（`/`、`/api`、以及任何经
+//      `ctx.connection.rpc.handle()` 注册的通道）都要求该 cookie，否则 401
+//
+// cookie 的构造（见 @deepseek-ai/dsh-client-connection 的 BrowserAuth）：
+//   名称：`dsh-auth-` + base64url(sha256(authority))，authority = `127.0.0.1:<port>`
+//   值  ：`v1.<base64url(JSON payload)>.<base64url(HMAC-SHA256(secret, body))>`
+//   载荷：`{ version: 1, authority, issuedAt, expiresAt }`（均为安全整数）
+//   密钥：`<DSH_HOME>/.credentials.yaml` 里 record
+//         `client-connection/browser-session` 的 `payload.secret`（base64url 32 字节）
+//
+// 为什么本插件需要它
+// ---------------------------------------------------------------
+// 本插件的自建反向代理监听自己的端口（默认 3082），对外提供局域网/隧道访问，
+// 再把请求转发到 DSH 回环地址。浏览器持有的是"代理 origin"的 cookie，
+// 而 DSH 的 cookie 绑定的是 `127.0.0.1:<dshPort>` 这个 authority，两者不是同一个，
+// 因此代理必须自行注入一枚合法的 loopback 会话 cookie，否则远程访问会一律 401。
+//
+// 本模块只做"按 DSH 的格式生成一枚回环会话 cookie"，不引入任何三方依赖。
+
+import { createHash, createHmac } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+/** DSH 会话 cookie 的名称前缀（与 dsh-client-connection 的 COOKIE_PREFIX 一致）。 */
+export const DSH_AUTH_COOKIE_PREFIX = 'dsh-auth-';
+
+/** cookie 载荷版本（与 dsh-client-connection 的 COOKIE_PAYLOAD_VERSION 一致）。 */
+export const DSH_AUTH_COOKIE_VERSION = 1;
+
+/** 会话 cookie 有效期（毫秒）。与 DSH 默认的 cookieMaxAgeDays=30 对齐。 */
+export const DSH_AUTH_COOKIE_MAX_AGE_MS = 30 * 24 * 3600 * 1000;
+
+/** 承载签名密钥的 DSH 凭据记录键。 */
+export const DSH_BROWSER_SESSION_RECORD = 'client-connection/browser-session';
+
+function base64Url(value) {
+  return Buffer.from(value).toString('base64url');
+}
+
+/**
+ * 计算 DSH 会话 cookie 的名称（authority 绑定）。
+ * @param {number|string} targetPort DSH 回环端口
+ * @param {string} [host] 默认 127.0.0.1
+ * @returns {string} 形如 `dsh-auth-<base64url(sha256("127.0.0.1:3080"))>`
+ */
+export function dshAuthCookieName(targetPort, host = '127.0.0.1') {
+  const authority = `${host}:${targetPort}`;
+  return DSH_AUTH_COOKIE_PREFIX + base64Url(createHash('sha256').update(authority).digest());
+}
+
+/**
+ * 从 DSH 凭据文件内容中取出 browser-session 记录的签名密钥。
+ *
+ * 必须精确定位 `client-connection/browser-session` 这条 record：
+ * 凭据文件里还有 `refs:` 段（各家模型 API key）以及可能存在其它插件写入的
+ * record，一旦取到别处的 `secret:`，签名就会无效 —— 现象是"远程访问一律 401"，
+ * 且极难定位。因此先锚定 record 键，再在其后的小范围内取 secret；
+ * 仅当锚点缺失（异常/未来格式）时才退回"全文件第一个 secret:"的旧行为。
+ *
+ * @param {string} content 凭据文件文本
+ * @returns {string} base64url 编码的密钥；取不到时返回空串
+ */
+export function readBrowserSessionSecret(content) {
+  if (typeof content !== 'string' || content === '') return '';
+
+  // 锚定 record 键所在行，随后只在该行往后的一小段内查找 secret
+  const anchorMatch = /^[ \t]*client-connection\/browser-session:[ \t]*$/m.exec(content);
+  if (anchorMatch) {
+    const tail = content.slice(anchorMatch.index);
+    const scoped = /secret:[ \t]*([A-Za-z0-9_-]+)/.exec(tail);
+    if (scoped) return scoped[1];
+  }
+
+  // 兜底：老格式/异常格式下沿用全文件首个 secret:
+  const fallback = /secret:[ \t]*([A-Za-z0-9_-]+)/.exec(content);
+  return fallback ? fallback[1] : '';
+}
+
+/**
+ * 生成一枚绑定到 loopback authority 的 DSH 原生会话 cookie。
+ *
+ * @param {object} opts
+ * @param {number|string} opts.targetPort DSH 回环端口
+ * @param {string} opts.secret base64url 编码的签名密钥
+ * @param {string} [opts.host] 默认 127.0.0.1
+ * @param {number} [opts.now] 当前时间戳（测试注入用）
+ * @param {number} [opts.maxAgeMs] 有效期
+ * @returns {string} `name=value`；密钥缺失时返回空串
+ */
+export function buildDshLoopbackCookie({
+  targetPort,
+  secret,
+  host = '127.0.0.1',
+  now = Date.now(),
+  maxAgeMs = DSH_AUTH_COOKIE_MAX_AGE_MS,
+}) {
+  if (!secret || !targetPort) return '';
+
+  const authority = `${host}:${targetPort}`;
+  const name = dshAuthCookieName(targetPort, host);
+  // 与 DSH 一致：issuedAt 略微回拨，避免与宿主的同秒比较产生边界问题
+  const issuedAt = now - 1000;
+  const expiresAt = issuedAt + maxAgeMs;
+
+  const body = base64Url(Buffer.from(JSON.stringify({
+    version: DSH_AUTH_COOKIE_VERSION,
+    authority,
+    issuedAt,
+    expiresAt,
+  }), 'utf8'));
+  const key = Buffer.from(secret, 'base64url');
+  const sig = base64Url(createHmac('sha256', key).update(body).digest());
+  return `${name}=v${DSH_AUTH_COOKIE_VERSION}.${body}.${sig}`;
+}
+
+/**
+ * 读取本机 DSH 凭据并生成回环会话 cookie（失败时返回空串，绝不抛出）。
+ *
+ * @param {number|string} targetPort DSH 回环端口
+ * @param {object} [env] 便于测试注入的环境
+ * @param {string} [env.dshHome] DSH 主目录（默认 $DSH_HOME 或 ~/.dsh）
+ * @param {Function} [env.readFileSync] 文件读取实现（默认 node:fs）
+ * @param {Function} [env.existsSync] 存在性判断实现
+ * @param {number} [env.now] 当前时间戳
+ * @returns {string} `name=value`，或空串
+ */
+export function getDshLoopbackCookie(targetPort, env = {}) {
+  const readFile = env.readFileSync ?? readFileSync;
+  const exists = env.existsSync ?? existsSync;
+  try {
+    const dshHome = env.dshHome ?? process.env.DSH_HOME ?? join(homedir(), '.dsh');
+    const credPath = join(dshHome, '.credentials.yaml');
+    if (!exists(credPath)) return '';
+    const secret = readBrowserSessionSecret(readFile(credPath, 'utf8'));
+    if (!secret) return '';
+    return buildDshLoopbackCookie({ targetPort, secret, now: env.now });
+  } catch {
+    return '';
+  }
+}

package/lib/bridge-rpc-constants.js

@@ -40,6 +40,8 @@ export const BRIDGE_ENDPOINTS = {
   platformStop: 'platformStop',
   platformStart: 'platformStart',
   platformUnbind: 'platformUnbind',
+  // 本机可用的 DSH agent preset（设置页下拉用；老版本 DSH 返回 available:false）
+  listAgentPresets: 'listAgentPresets',
   // 微信 Bot（v1.x 向后兼容别名，deprecated）
   wechatGetStatus: 'wechatGetStatus',
   wechatLogin: 'wechatLogin',