dsh-session-conductor 1.3.4 → 1.3.5

package/README.md

@@ -137,10 +137,24 @@ allowBuilds:
 
 ### 真实后端预览页
 
-改 UI 后免重启查看效果：
+改 UI 后免重启查看效果 —— **预览能力已移出本插件**，统一用独立插件 `dsh-useful-tools` 的 `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 }   # ① 后端模拟
+preview  { action: "gen",   plugin: "<插件根>" }                 # ② 前端预览页（无 spec 自动用默认垫片）
+preview  { action: "serve", file: "<插件根>/assets/preview.html", backend: "http://127.0.0.1:31177" }  # ③ 前端接后端
+```
+
+**几个容易写错的点**：
+
+- `gen` 默认产物是 `<插件根>/assets/preview.html`（会写进仓库）⇒ 不想入库就传 `out`（如 `out: "/tmp/sc-preview.html"`），并让 `serve` 的 `file` 指向同一路径。本仓库已把该产物加进 `.gitignore`。
+- `serve` 默认端口 **31188**，显式传 `port` 才用你给的。
+- `backend` 可指向 minihost 的端口（`/api/*` 反代到模拟后端），也可指向**真实 DSH 后端**。
+- 显式传 `spec` 但文件不存在会**直接报错**（不静默降级）—— 故意的，避免指错文件还生成一个看不懂的页面。
+- 停止：`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 +235,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/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.5",
   "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",