dsh-session-conductor 1.3.4 → 1.3.6

package/README.md

@@ -137,10 +137,29 @@ allowBuilds:
 
 ### 真实后端预览页
 
-改 UI 后免重启查看效果：
+改 UI 后免重启查看效果 —— **预览能力已移出本插件**，统一用独立插件 `dsh-useful-tools`（**0.1.11**）的 `preview` / `minihost` 工具。
 
-- **快照模式（推荐，免重启）**：`bash tools/preview-snapshot.sh` → 生成 `assets/preview-*.html`（内嵌生成时真实后端响应），file:// 打开即可查看，无 CORS、无假数据
-- **DSH 同源路由**：重启后访问 `/api/session-conductor/preview/settings`（或 `/panel`），同源实时 fetch
+**最短三行（实测可用；本仓库没有 `assets/preview.spec.mjs` 也能出真实界面）**：
+
+```
+minihost { action: "start", plugin: "<插件根>", port: 31177, services: "<插件根>/test/api/helpers/fake-services.mjs" }
+preview  { action: "gen",   plugin: "<插件根>" }
+preview  { action: "serve", file: "<插件根>/assets/preview.html", backend: "http://127.0.0.1:31177" }
+```
+
+停止：`minihost { action:"stop", port:31177 }` + `preview { action:"stop", port:31188 }`；状态：两者都用 `action:"status"`。
+
+**要点**：
+
+- **`services` 必须传**（0.1.11 新增）：本插件 `apply()` 依赖 `storageDomain` 等宿主服务，不注入时 `/templates` 会 500、页面显示「storageDomain 不可用」；注入 `test/api/helpers/fake-services.mjs` 后 `/templates` 返回 200 真实数据（已实测）。
+- **autoMount**（0.1.7 起）：无 spec 时 mock 宿主 `__ModuleLoader__` / `require` / `ctx`（slots / locale / effect），调插件 `apply(ctx)`，把 `slots.register(def, component)` 捕获到的组件 `createRoot().render()` 到 `#root`。**限制**：组件若依赖 `useSettings` / `useSession` 这类宿主 hooks 会渲染失败（页面会显示错误与已捕获插槽清单，不白屏）；要 100% 还原仍需 spec 提供 mock。locale 取插件自己 `ctx.locale.register` 的字典，键名不一致会回退成 key。
+- `gen` 默认产物是 `<插件根>/assets/preview.html`（会写进仓库）⇒ 不想入库就传 `out`（如 `out: "/tmp/sc-preview.html"`），并让 `serve` 的 `file` 指向同一路径。本仓库已把该产物加进 `.gitignore`。
+- `serve` 默认端口 **31188**，显式传 `port` 才用你给的；`backend` 可指向 minihost 的端口（`/api/*` 反代到模拟后端），也可指向**真实 DSH 后端**。
+- 显式传 `spec` 但文件不存在会**直接报错**（不静默降级）—— 故意的，避免指错文件还生成一个看不懂的页面。
+- **截图**（README 配图）走 **browser 插件的 `browser_screenshot`**；「自包含快照」形态不做（理由见 `dsh-useful-tools` 的 `docs/NOT-DONE.md`）。
+- **隔离实例自测**（0.1.8/0.1.9）：`test_env { action:"create"|"start"|"stop"|"status", plugin, pluginName }` 起独立 `DSH_HOME` + 自动端口的实例；`sync_plugin { write:true, register:true, dshHome:"<测试环境 DSH_HOME>" }` 把插件装进去（写 profile 的 `dependencies` + `dsh.profile.bundles`，并对齐 `node_modules` 副本）。
+- 停止：`minihost { action: "stop", port: 31177 }` + `preview { action: "stop", port: 31200 }`；状态：两者都用 `action: "status"`。
+- **截图**（README 配图）改走 **browser 插件的 `browser_screenshot`**；「自包含快照」形态不做（理由见 `dsh-useful-tools` 的 `docs/NOT-DONE.md`）。
 
 ### 聊天框指令：`/model-switch`
 
@@ -221,7 +240,6 @@ allowBuilds:
 | `/templates/dir` | GET | 目录浏览 |
 | `/auto-rename-model` | GET | 自动重命名模型（透传官方 modelCatalog） |
 | `/i18n` | GET | 语言包（zh/en 外置 JSON） |
-| `/preview/settings` `/preview/panel` | GET | 真实后端预览页（同源服务） |
 
 示例：
 

package/lib/apply.js

@@ -234,35 +234,11 @@ export async function apply(ctx, config = {}) {
       },
     });
 
-    // ---------- GET /api/session-conductor/preview/<settings|panel> ----------
-    // 真实后端预览页：单文件 html（assets/preview-*.html）经本路由同源服务，浏览器从 DSH 反代地址
-    // 打开即同源 fetch /api/*（file:// 双击会被 CORS 拦——DSH API 不带 Access-Control-Allow-Origin）。
-    // 用 kind:"exact" 枚举两个预览（DSH 的 kind:"prefix" 实测 401 不生效）
-    const PREVIEW_FILES = {
-      settings: new URL("../../assets/preview-settings.html", import.meta.url),
-      panel: new URL("../../assets/preview-panel.html", import.meta.url),
-    };
-    const servePreview = async (req, res, name) => {
-      try {
-        if ((req.method ?? "GET") !== "GET") {
-          return send(res, 405, { ok: false, error: { code: "METHOD", message: "Method Not Allowed" } });
-        }
-        const file = PREVIEW_FILES[name];
-        if (!file) return send(res, 404, { ok: false, error: { code: "NOT_FOUND", message: "未知预览: " + name } });
-        const html = readFileSync(file, "utf8");
-        res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
-        return res.end(html);
-      } catch (error) {
-        return send(res, 500, { ok: false, error: { code: "INTERNAL", message: String(error?.message ?? error) } });
-      }
-    };
-    for (const name of ["settings", "panel"]) {
-      webServer.register({
-        kind: "exact",
-        path: "/api/session-conductor/preview/" + name,
-        handler: (req, res) => servePreview(req, res, name),
-      });
-    }
+    // ---------- 预览页已移出本插件 ----------
+    // 原先这里用 /api/session-conductor/preview/<settings|panel> 同源服务 assets/preview-*.html
+    // （那两份 html 由已移除的 tools/preview-snapshot.sh 生成）。现在预览能力统一由独立插件
+    // dsh-useful-tools 的 `preview` 工具提供：gen 生成 + serve 带 backend 反代真实后端，
+    // 效果等价且本插件不必再托管静态页，故路由与产物一并移除。
 
     // ---------- GET /api/session-conductor/list ----------
     webServer.register({

package/lib/client-parts/apply.js

@@ -17,10 +17,24 @@
         locale: NS,
         inject: () => ({
           onOpenSession: (sessionId) => {
+            // 打开会话的真实入口随宿主版本不同，按优先级尝试（**不要只认一个**）：
+            //   · workspaceNavigation.openSession(id) —— dsh-client-ui-conversation 的用法
+            //   · ctx.uiWorkspace.openSession(id)    —— dsh-client-ui-chat 的用法
+            //   · sessions.open(id)                  —— 早期路径，保留兜底
+            // 以前只写了第三个，而宿主客户端并没有 `sessions` 这个服务 ⇒ 可选链把失败吞成
+            // 「点了没反应」，且不报错、难查。所以这里：多个入口都试；全失败要留下痕迹。
             try {
-              ctx.get("sessions")?.open?.(sessionId);
-            } catch {
-              // 打开失败不阻塞面板
+              const nav = ctx.get?.("workspaceNavigation");
+              if (typeof nav?.openSession === "function") return nav.openSession(sessionId);
+              if (typeof ctx.uiWorkspace?.openSession === "function") return ctx.uiWorkspace.openSession(sessionId);
+              const legacy = ctx.get?.("sessions");
+              if (typeof legacy?.open === "function") return legacy.open(sessionId);
+              // eslint-disable-next-line no-console
+              console.warn("[session-conductor] 打不开会话：宿主客户端未暴露 workspaceNavigation/uiWorkspace/sessions 任一入口", sessionId);
+            } catch (error) {
+              // 打开失败不阻塞面板，但不再静默
+              // eslint-disable-next-line no-console
+              console.warn("[session-conductor] 打开会话失败:", error);
             }
           },
         }),
@@ -38,6 +52,6 @@
  * 本卡只保留：
  *   · 分组列表（GET /api/session-conductor/group/list，只读展示）
  *   · 每行「在分组下新建会话」（POST /api/session-conductor/group/new-session {workspaceId}）
- *   · 「新建会话（上次会话工作区）」（new-session 不带 workspaceId = 最近活跃会话 cwd 归属分组）
+ *   · 「新建会话（上一次使用的工作区）」（new-session 不带 workspaceId = 最近活跃会话 cwd 归属分组）
  */
 

package/lib/client-parts/components/panel.js

@@ -768,7 +768,33 @@
                 }),
                 (0, react_jsx_runtime.jsx)("div", {
                   style: S.rowSid,
-                  title: "session id",
+                  title: "点击复制会话 id",
+                  // 单击复制：优先 Clipboard API，退回 execCommand（旧版宿主/非安全上下文）；
+                  // 成功后把这段文字临时换成「✅ 已复制」再复原 —— 不依赖宿主 toast（旧版未必有）。
+                  onClick: (event) => {
+                    event.stopPropagation();
+                    const el = event.currentTarget;
+                    const flash = () => {
+                      try {
+                        const prev = el.textContent;
+                        el.textContent = "✅ 已复制";
+                        setTimeout(() => { el.textContent = prev; }, 1200);
+                      } catch { /* 提示失败不影响复制 */ }
+                    };
+                    try {
+                      if (navigator.clipboard && typeof navigator.clipboard.writeText === "function") {
+                        navigator.clipboard.writeText(session.id).then(flash, () => {});
+                      } else {
+                        const ta = document.createElement("textarea");
+                        ta.value = session.id;
+                        document.body.appendChild(ta);
+                        ta.select();
+                        document.execCommand("copy");
+                        ta.remove();
+                        flash();
+                      }
+                    } catch { /* 复制失败不阻塞面板 */ }
+                  },
                   children: session.id,
                 }),
               ],

package/lib/client.js

@@ -1177,7 +1177,33 @@ window.__ModuleLoader__.load({
                 }),
                 (0, react_jsx_runtime.jsx)("div", {
                   style: S.rowSid,
-                  title: "session id",
+                  title: "点击复制会话 id",
+                  // 单击复制：优先 Clipboard API，退回 execCommand（旧版宿主/非安全上下文）；
+                  // 成功后把这段文字临时换成「✅ 已复制」再复原 —— 不依赖宿主 toast（旧版未必有）。
+                  onClick: (event) => {
+                    event.stopPropagation();
+                    const el = event.currentTarget;
+                    const flash = () => {
+                      try {
+                        const prev = el.textContent;
+                        el.textContent = "✅ 已复制";
+                        setTimeout(() => { el.textContent = prev; }, 1200);
+                      } catch { /* 提示失败不影响复制 */ }
+                    };
+                    try {
+                      if (navigator.clipboard && typeof navigator.clipboard.writeText === "function") {
+                        navigator.clipboard.writeText(session.id).then(flash, () => {});
+                      } else {
+                        const ta = document.createElement("textarea");
+                        ta.value = session.id;
+                        document.body.appendChild(ta);
+                        ta.select();
+                        document.execCommand("copy");
+                        ta.remove();
+                        flash();
+                      }
+                    } catch { /* 复制失败不阻塞面板 */ }
+                  },
                   children: session.id,
                 }),
               ],
@@ -2106,10 +2132,24 @@ window.__ModuleLoader__.load({
         locale: NS,
         inject: () => ({
           onOpenSession: (sessionId) => {
+            // 打开会话的真实入口随宿主版本不同，按优先级尝试（**不要只认一个**）：
+            //   · workspaceNavigation.openSession(id) —— dsh-client-ui-conversation 的用法
+            //   · ctx.uiWorkspace.openSession(id)    —— dsh-client-ui-chat 的用法
+            //   · sessions.open(id)                  —— 早期路径，保留兜底
+            // 以前只写了第三个，而宿主客户端并没有 `sessions` 这个服务 ⇒ 可选链把失败吞成
+            // 「点了没反应」，且不报错、难查。所以这里：多个入口都试；全失败要留下痕迹。
             try {
-              ctx.get("sessions")?.open?.(sessionId);
-            } catch {
-              // 打开失败不阻塞面板
+              const nav = ctx.get?.("workspaceNavigation");
+              if (typeof nav?.openSession === "function") return nav.openSession(sessionId);
+              if (typeof ctx.uiWorkspace?.openSession === "function") return ctx.uiWorkspace.openSession(sessionId);
+              const legacy = ctx.get?.("sessions");
+              if (typeof legacy?.open === "function") return legacy.open(sessionId);
+              // eslint-disable-next-line no-console
+              console.warn("[session-conductor] 打不开会话：宿主客户端未暴露 workspaceNavigation/uiWorkspace/sessions 任一入口", sessionId);
+            } catch (error) {
+              // 打开失败不阻塞面板，但不再静默
+              // eslint-disable-next-line no-console
+              console.warn("[session-conductor] 打开会话失败:", error);
             }
           },
         }),
@@ -2127,7 +2167,7 @@ window.__ModuleLoader__.load({
  * 本卡只保留：
  *   · 分组列表（GET /api/session-conductor/group/list，只读展示）
  *   · 每行「在分组下新建会话」（POST /api/session-conductor/group/new-session {workspaceId}）
- *   · 「新建会话（上次会话工作区）」（new-session 不带 workspaceId = 最近活跃会话 cwd 归属分组）
+ *   · 「新建会话（上一次使用的工作区）」（new-session 不带 workspaceId = 最近活跃会话 cwd 归属分组）
  */
 
     return module.exports;

package/lib/features/memory-recall/index.js

@@ -180,7 +180,15 @@ export function formatRecallBlock(turns, opts = {}) {
     kept.unshift(block);
     used += block.length;
   }
-  return head + kept.join("");
+  // 有轮次因总长上限被丢掉时**如实说明**：静默丢轮次是「要 30 轮只回 5 轮」那个 bug 的根因之一，
+  // 调用方需要知道自己拿到的是残缺结果、以及怎么取到更早的内容。
+  const dropped = list.length - kept.length;
+  const tail = dropped > 0
+    ? `\n\n（⚠️ 受总长上限 ${maxTotal} 字符限制，最早的 ${dropped} 轮未包含；需要更早的内容请调小 rounds 分次取）`
+    : "";
+  // 输出末尾附上实际字符数：调用方据此判断这次取回的代价（也便于对照 maxTotalChars 的截断阈值）。
+  const body = head + kept.join("") + tail;
+  return `${body}\n\n（本次输出正文 ${body.length} 字符）`;
 }
 
 /**
@@ -291,7 +299,9 @@ export function registerMemoryRecallTool(ctx, defineTool, tools, deps = {}) {
         });
         if (!turns || turns.length === 0) return "没取到可用的记忆（日志缺失，或该会话还没有用户消息）。";
         const text = format(turns, {
-          maxTotalChars: config?.retrieveMemoryMaxChars,
+          // 手动路径的总额**按请求规模算**（rounds × 单条上限），不套自动注入那条 4000 字符的紧上限：
+          //   调用方明确要 N 轮，就该给 N 轮；套紧上限会把最早的轮次静默丢掉（实测 rounds:30 只剩 5 轮）。
+          maxTotalChars: rounds * (config?.retrieveMemoryMaxCharsPerItem ?? 800),
           manual: true,
           // 跨会话时标注来源，并写明只作背景——别把别处的文字当成当前这轮的要求
           ...(fromOther ? { sourceNote: `来自另一个会话 ${targetId}` } : {}),

package/lib/features/session-messaging/logic.js

@@ -262,11 +262,18 @@ export function contentOf(text) {
   return [{ type: "text", text: String(text) }];
 }
 
-/** 投递一条消息到目标会话（走本体官方 prompt；目标空闲时会被 resume 唤醒）。 */
-export function deliverPrompt(sc, { sessionId, text, mode, requestId }) {
+/**
+ * 投递一条消息到目标会话（走本体官方 prompt；目标空闲时会被 resume 唤醒）。
+ *
+ * 【为什么自动加发送者标记】本体 prompt 只带正文，接收方看不到「这条是谁发的」——实测出现过
+ * 「A 会话投递的消息，B 会话以为是当前这一方发的」。这里统一在正文头部加一行
+ * `【来自会话 <sessionId>】`，id 由调用方从 `currentSessionId(exec.agent)` 取，**不需要 AI 自己写**。
+ */
+export function deliverPrompt(sc, { sessionId, text, mode, requestId, from }) {
+  const body = from ? `【来自会话 ${from}】\n${String(text ?? "")}` : String(text ?? "");
   // 本体签名是 prompt(request, signal)：signal 必传（内部会 throwIfAborted）。
   return sc.prompt(
-    { requestId, sessionId, mode, content: contentOf(text) },
+    { requestId, sessionId, mode, content: contentOf(body) },
     AbortSignal.timeout(PROMPT_TIMEOUT_MS),
   );
 }

package/lib/features/session-messaging/tools.js

@@ -236,7 +236,7 @@ function registerSendToSession(ctx, defineTool, tools) {
       if (isInFlight(requestId)) return `投递失败：同一 requestId 正在投递中（${requestId}）`;
       markInFlight(requestId);
       try {
-        await deliverPrompt(sc, { sessionId: to, text, mode, requestId });
+        await deliverPrompt(sc, { sessionId: to, text, mode, requestId, from });
         logMessaging(ctx, `跨会话投递 ${from ?? "?"} → ${to}（mode=${mode} requestId=${requestId} hops=${hops}）`);
         return `已投递到 ${to}（mode=${mode} ｜ requestId=${requestId}）。`
           + (mode === "steer"
@@ -341,7 +341,7 @@ function registerCreateSession(ctx, defineTool, tools) {
       }
       if (text.trim()) {
         try {
-          await deliverPrompt(sc, { sessionId, text, mode: "queue", requestId: newRequestId() });
+          await deliverPrompt(sc, { sessionId, text, mode: "queue", requestId: newRequestId(), from: currentSessionId(exec?.agent) });
         } catch (error) {
           notes.push(`⚠️ 会话已建，但初始消息未投递（${mapPromptError(error)}：${shortError(error)}）`);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-session-conductor",
-  "version": "1.3.4",
+  "version": "1.3.6",
   "description": "DSH session management enhancement: archive/restore sessions, batch & conditional delete, AI auto-rename, interrupted-session auto-resume, release idle sessions, workspace grouping, undo last message, repair damaged session logs, value analysis, full-text search, per-member model switching (list_models / set_member_model), and plan/closing template injection (system-prompt + context).",
   "type": "module",
   "main": "lib/index.js",