pi-web-ui 0.85.0 → 0.86.2

package/dist/server/client-state.js

@@ -7,7 +7,7 @@
  * 从 agent-service.ts 抽出，行为保持不变。
  */
 import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
-import { dirname } from "node:path";
+import { dirname, isAbsolute, resolve } from "node:path";
 import { deriveLegacy, legacyToDisabled, normalizeDisabledAgentTools } from "./tool-manager.js";
 /** 大模型 API 出错自动重试次数的默认值（SDK 默认 3）。 */
 export const DEFAULT_RETRY_MAX_ATTEMPTS = 6;
@@ -18,6 +18,47 @@ export function normalizeRetryMaxAttempts(v) {
         return DEFAULT_RETRY_MAX_ATTEMPTS;
     return Math.min(100, Math.max(0, n));
 }
+/**
+ * 归一化 UI 布局偏好（UiLayoutPrefs）：只收字符串数组 / 字符串字典，去重 + 长度上限。
+ * 脏数据（数字、对象、超长 key、嵌套）一律丢弃而不是整份回落 —— 用户手动调过的那部分
+ * 不该因为插件写坏了一个字段就全丢。
+ */
+export function normalizeUiLayout(v) {
+    if (!v || typeof v !== "object" || Array.isArray(v))
+        return {};
+    const o = v;
+    const arr = (x, max) => {
+        if (!Array.isArray(x))
+            return undefined;
+        const out = [
+            ...new Set(x.filter((s) => typeof s === "string" && s.length > 0 && s.length <= 96)),
+        ].slice(0, max);
+        return out.length ? out : undefined;
+    };
+    const dict = (x, max) => {
+        if (!x || typeof x !== "object" || Array.isArray(x))
+            return undefined;
+        const out = {};
+        for (const [k, val] of Object.entries(x).slice(0, max)) {
+            if (k.length > 0 && k.length <= 96 && typeof val === "string" && val.length > 0 && val.length <= 120) {
+                out[k] = val;
+            }
+        }
+        return Object.keys(out).length ? out : undefined;
+    };
+    const hidden = arr(o.hidden, 200);
+    const shown = arr(o.shown, 200);
+    const order = arr(o.order, 200);
+    const groups = dict(o.groups, 200);
+    const labels = dict(o.labels, 200);
+    return {
+        ...(hidden ? { hidden } : {}),
+        ...(shown ? { shown } : {}),
+        ...(order ? { order } : {}),
+        ...(groups ? { groups } : {}),
+        ...(labels ? { labels } : {}),
+    };
+}
 /** 归一化技能名单：字符串数组原样过滤；其他（含旧 bool 开关）回落空数组。 */
 export function normalizeSkillList(v) {
     return Array.isArray(v) ? v.filter((x) => typeof x === "string") : [];
@@ -69,6 +110,36 @@ export function isExtensionEnabled(e, enabled) {
     const keys = extensionKeyCandidates(e);
     return enabled.some((d) => keys.includes(d));
 }
+/** 额外工作区根（宿主侧多根，issue #146）上限：右栏文件树可切换的根数量。 */
+export const MAX_WORKSPACE_ROOTS = 8;
+/**
+ * 归一化「额外工作区根」列表：只收**绝对路径**（相对路径在服务端没有任何可靠基准）、
+ * 去重（win32 折大小写）、上限 MAX_WORKSPACE_ROOTS，并 resolve 成规范形式以便与工作区
+ * 做前缀比较。脏数据（数字/空串/对象）逐个丢弃而不是整份回落 —— 用户加过的根不该因为
+ * 前端传坏了一个元素就全丢。
+ */
+export function normalizeWorkspaceRoots(v) {
+    if (!Array.isArray(v))
+        return [];
+    const out = [];
+    const seen = new Set();
+    for (const raw of v) {
+        if (typeof raw !== "string")
+            continue;
+        const p = raw.trim();
+        if (!p || !isAbsolute(p))
+            continue;
+        const abs = resolve(p);
+        const key = process.platform === "win32" ? abs.toLowerCase() : abs;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(abs);
+        if (out.length >= MAX_WORKSPACE_ROOTS)
+            break;
+    }
+    return out;
+}
 /**
  * Persists which workspace each browser client last used + which workspaces it
  * has opened, so a server restart / page reload restores the same project and
@@ -165,6 +236,27 @@ export class ClientStateStore {
             locked: s.goalPrefs.locked ?? true,
         };
     }
+    /** 某项目当前的额外工作区根（空数组 = 单根）。 */
+    getWorkspaceRoots(clientId, cwd) {
+        return this.load()[clientId]?.workspaceRoots?.[cwd] ?? [];
+    }
+    /** 记下某项目的额外工作区根（空数组 = 清掉该项目的键，不留空壳）。 */
+    saveWorkspaceRoots(clientId, cwd, roots) {
+        const all = this.load();
+        const state = (all[clientId] ??= { projects: [] });
+        const next = normalizeWorkspaceRoots(roots);
+        if (next.length === 0) {
+            if (state.workspaceRoots) {
+                delete state.workspaceRoots[cwd];
+                if (Object.keys(state.workspaceRoots).length === 0)
+                    delete state.workspaceRoots;
+            }
+            this.save();
+            return;
+        }
+        (state.workspaceRoots ??= {})[cwd] = next;
+        this.save();
+    }
     /** Persist the client's UI locale code (hello/set_locale; best-effort). */
     saveLocale(clientId, locale) {
         const code = locale.trim().slice(0, 16);
@@ -249,6 +341,8 @@ export class ClientStateStore {
                 : (stored?.questionnaireEnabled ?? true),
             goalModeEnabled: stored?.goalModeEnabled ?? true,
             thinkingWrap: stored?.thinkingWrap ?? false,
+            devNoCache: stored?.devNoCache,
+            autoReload: stored?.autoReload,
             toolsWrap: stored?.toolsWrap ?? true,
             skillsFullText: normalizeSkillList(stored?.skillsFullText),
             visionBridgeEnabled: stored?.visionBridgeEnabled ?? true,
@@ -262,6 +356,7 @@ export class ClientStateStore {
             reviewPrompt: stored?.reviewPrompt ?? "",
             reviewDisabledSkills: stored?.reviewDisabledSkills ?? [],
             disabledPlugins: stored?.disabledPlugins ?? [],
+            uiLayout: normalizeUiLayout(stored?.uiLayout),
         };
     }
     /** Persist the settings-panel state (partial merge) — global shared config. */
@@ -284,6 +379,8 @@ export class ClientStateStore {
             questionnaireEnabled: settings.questionnaireEnabled ?? cur.questionnaireEnabled ?? true,
             goalModeEnabled: settings.goalModeEnabled ?? cur.goalModeEnabled ?? true,
             thinkingWrap: settings.thinkingWrap ?? cur.thinkingWrap ?? false,
+            devNoCache: settings.devNoCache ?? cur.devNoCache,
+            autoReload: settings.autoReload ?? cur.autoReload,
             toolsWrap: settings.toolsWrap ?? cur.toolsWrap ?? true,
             skillsFullText: normalizeSkillList(settings.skillsFullText ?? cur.skillsFullText),
             visionBridgeEnabled: settings.visionBridgeEnabled ?? cur.visionBridgeEnabled ?? true,
@@ -295,6 +392,7 @@ export class ClientStateStore {
             reviewPrompt: settings.reviewPrompt ?? cur.reviewPrompt ?? "",
             reviewDisabledSkills: settings.reviewDisabledSkills ?? cur.reviewDisabledSkills ?? [],
             disabledPlugins: settings.disabledPlugins ?? cur.disabledPlugins ?? [],
+            uiLayout: normalizeUiLayout(settings.uiLayout ?? cur.uiLayout),
             quickPhrases: settings.quickPhrases ?? cur.quickPhrases ?? [],
             quickPhrasesEnabled: settings.quickPhrasesEnabled ?? cur.quickPhrasesEnabled ?? true,
         };

package/dist/server/dsh/dsh-agent-service.js

@@ -30,13 +30,14 @@ import { randomUUID } from "node:crypto";
 import { homedir } from "node:os";
 import { BgServerTracker } from "../bg-servers.js";
 import { ClientStateStore, DEFAULT_RETRY_MAX_ATTEMPTS } from "../client-state.js";
+import { normalizeUiLayout } from "../client-state.js";
 import { FilesService, workspacePath } from "../files-service.js";
 import { QuiesceRejectedError } from "../agent-service.js";
 import { NATIVE_COMMANDS, parseSlash } from "../slash-commands.js";
 import { bilingual, pick, resolveServerLang } from "../i18n.js";
 import { TerminalManager, loadCommands, saveCommandsFile } from "../terminals.js";
 import { saveUpload } from "../uploads.js";
-import { checkAll as checkAllUpdates, collectTargets } from "../update-check.js";
+import { checkAll as checkAllUpdates, collectTargets, resolveNpmRegistry } from "../update-check.js";
 import { previewKind } from "../text-sniff.js";
 import { launchOrigin, toServiceInfo } from "../launch-origin.js";
 import { DshRuntime, loadDeepSeekKey } from "./dsh-client.js";
@@ -116,6 +117,7 @@ const DEFAULT_SETTINGS = {
     thinkingWrap: false,
     toolsWrap: true,
     disabledPlugins: [],
+    uiLayout: {},
     reviewPrompt: "",
     quickPhrases: [],
     quickPhrasesEnabled: true,
@@ -126,6 +128,9 @@ const DEFAULT_SETTINGS = {
 export class DshClientSession {
     clientId;
     cwd;
+    /** 当前项目的额外工作区根（宿主侧多根，见 protocol 的 set_workspace_roots）——
+     *  按 cwd 存在 client-state 里，这里只存一份内存缓存给快照热路径读。 */
+    roots = [];
     stateStore;
     sessionRoot;
     dataDir;
@@ -179,10 +184,20 @@ export class DshClientSession {
     onQuit;
     isQuiesced;
     onCwdChanged;
+    /** issue #145 跨客户端感知（DshAgentService.attach 接线，与 pi 引擎同语义；
+     *  DSH 的会话身份是 sessionId = JSONL 目录名）。 */
+    findSessionOwnerById = undefined;
+    listProjectRunners = undefined;
+    listExternalRunning = undefined;
+    notifyExternalClients = undefined;
+    onRunningChanged = undefined;
+    /** issue #145：上次 emit 时流式对话签名（变化才 poke 其他客户端，防循环）。 */
+    lastRunningSig = "";
     constructor(clientId, cwd, stateStore, dataDir, agentDir) {
         this.clientId = clientId;
         this.cwd = cwd;
         this.stateStore = stateStore;
+        this.roots = stateStore.getWorkspaceRoots(clientId, cwd);
         this.dataDir = dataDir;
         this.agentDir = agentDir;
         this.sessionRoot = dshSessionRoot(dataDir);
@@ -234,6 +249,7 @@ export class DshClientSession {
                 thinkingWrap: savedSettings.thinkingWrap,
                 toolsWrap: savedSettings.toolsWrap,
                 disabledPlugins: savedSettings.disabledPlugins ?? [],
+                uiLayout: normalizeUiLayout(savedSettings.uiLayout),
                 reviewPrompt: savedSettings.reviewPrompt,
                 quickPhrases: savedSettings.quickPhrases ?? [],
                 quickPhrasesEnabled: savedSettings.quickPhrasesEnabled ?? true,
@@ -1042,6 +1058,7 @@ export class DshClientSession {
         return {
             clientId: this.clientId,
             cwd: this.cwd,
+            workspaceRoots: this.roots,
             sessionId: conv.sessionId,
             conversationId: this.activeId,
             rev,
@@ -1121,6 +1138,43 @@ export class DshClientSession {
     pendingMessages() {
         return 0;
     }
+    /** issue #145：本实例连接的 socket 数（0 = 标签页全关了，会话残留）。 */
+    sinkCount() {
+        return this.sinks.size;
+    }
+    /** issue #145：按 sessionId 找本实例持有的对话（跨客户端查重的本机一半）。 */
+    findConversationBySessionId(sessionId) {
+        for (const conv of this.convs.values())
+            if (conv.sessionId === sessionId)
+                return conv;
+        return undefined;
+    }
+    /** issue #145：本实例在某 cwd 下正在跑的对话摘要（同项目并行感知用）。 */
+    streamingInCwd(cwd) {
+        const out = [];
+        for (const conv of this.convs.values()) {
+            if (conv.cwd !== cwd || !conv.isStreaming)
+                continue;
+            out.push({ convId: conv.id, title: conv.title, sessionId: conv.sessionId });
+        }
+        return out;
+    }
+    /** issue #145：本实例所有正在跑的对话摘要（elsewhere 列表的本机一半）。 */
+    streamingSummariesAll() {
+        const out = [];
+        for (const conv of this.convs.values()) {
+            if (!conv.isStreaming)
+                continue;
+            out.push({ title: conv.title, cwd: conv.cwd, isStreaming: true });
+        }
+        return out;
+    }
+    /** issue #145：其他客户端重推 conversations 用（elsewhere 刷新）。 */
+    refreshExternalRunning() {
+        if (this.disposed)
+            return;
+        this.emitConversations();
+    }
     /** 左栏展示口径（issue #140，与 pi 引擎同义）：listed 之外，当前对话只要有
      *  内容（DSH 的对话消息全在内存里，直接数 messages）也在列表里；空白新对话
      *  不入列。只影响展示，不动 listed 的语义。 */
@@ -1143,7 +1197,23 @@ export class DshClientSession {
                 isSubagent: false,
             });
         }
-        this.emit({ type: "conversations", conversations: list, activeId: this.activeId });
+        // issue #145：流式集合签名变化 → 通知其他客户端重推（左栏「另一处正在运行」近实时）
+        const sig = JSON.stringify([...this.convs.values()]
+            .filter((c) => c.isStreaming)
+            .map((c) => c.id)
+            .sort());
+        if (sig !== this.lastRunningSig) {
+            this.lastRunningSig = sig;
+            this.onRunningChanged?.();
+        }
+        const elsewhere = this.listExternalRunning?.() ?? [];
+        this.emit({
+            type: "conversations",
+            conversations: list,
+            activeId: this.activeId,
+            // 为空时缺省（老快照字节一致）
+            ...(elsewhere.length > 0 ? { elsewhere } : {}),
+        });
     }
     /** 语义同 pi 引擎的 newChat：true = 当前活动对话是可接收首条的空白新对话
      *  （/new <prompt> 靠它决定要不要把首条提示发出去）。 */
@@ -1239,6 +1309,51 @@ export class DshClientSession {
             }
         }
         let conv = this.conv;
+        // issue #145：同文件守卫 —— 别处正在跑同一 sessionId 时拒绝发送（不造第二个 writer）。
+        const fileOwner = this.findSessionOwnerById?.(conv.sessionId);
+        if (fileOwner && fileOwner.isStreaming) {
+            this.emit({
+                type: "notice",
+                level: "warning",
+                text: `发送已拦截：该对话正在另一处运行中（「${fileOwner.title}」）。请等它结束后再发，或回到原窗口继续 —— 否则两个 agent 会同时写同一份记录，其中一支事后不可见。`,
+                textEn: `Prompt blocked: this conversation is running in another window ("${fileOwner.title}"). Wait for it to finish or continue there — two writers on one transcript would leave one run permanently invisible.`,
+            });
+            this.flushSnapshot();
+            return;
+        }
+        // issue #145：同项目并行感知（与 pi 引擎同语义；DSH 无 display:false 的
+        // custom 消息通道，提醒以前置系统文本随本轮发给运行时，用户气泡保持原文）。
+        let sysPrefix = "";
+        if (!conv.isStreaming) {
+            const localTitles = [...this.convs.values()]
+                .filter((c) => c.id !== conv.id && c.cwd === conv.cwd && c.isStreaming)
+                .map((c) => `本窗口「${c.title}」`);
+            const externalRunners = (this.listProjectRunners?.(conv.cwd) ?? []).filter((r) => r.sessionFile === undefined || basename(dirname(resolve(r.sessionFile))) !== conv.sessionId);
+            const runnerTitles = [...localTitles, ...externalRunners.map((r) => `另一处「${r.title}」`)];
+            if (runnerTitles.length > 0) {
+                const shown = runnerTitles.slice(0, 3).join("、");
+                const more = runnerTitles.length > 3 ? `等 ${runnerTitles.length} 处` : "";
+                this.emit({
+                    type: "notice",
+                    level: "info",
+                    text: `同项目并行提醒：${shown}${more}正在同一项目运行。你可以继续（适合改不同文件），改动同一文件前请先确认；拿不准就等它跑完。`,
+                    textEn: `Parallel-work notice: ${shown}${more ? " and more" : ""} running in the same project. You may continue (fine for different files); confirm before touching the same files, or wait for it to finish when unsure.`,
+                });
+                sysPrefix =
+                    `(System reminder: ${runnerTitles.length} other run(s) [${runnerTitles.join("; ").slice(0, 600)}] are currently running in the same project directory. ` +
+                        `You may work in parallel on different files, but before reading/writing files or running commands, assess the conflict probability with the other run(s). ` +
+                        `If a conflict is likely or you are unsure, use ask_user_question to let the user choose: continue in parallel / wait / watch read-only.)\n` +
+                        `（系统提醒：同一项目另有 ${runnerTitles.length} 处运行（${shown}${more}）。改不同文件可并行；读写文件或跑命令前先评估冲突概率，拿不准就用 ask_user_question 让用户选择：并行 / 等它跑完 / 只读围观。）\n\n`;
+                if (externalRunners.length > 0) {
+                    this.notifyExternalClients?.({
+                        type: "notice",
+                        level: "info",
+                        text: `同项目并行提醒：另一处在「${conv.cwd}」开始了对话（「${conv.title}」），可能与你正在跑的任务并行改动同一项目。`,
+                        textEn: `Parallel-work notice: another window started a conversation ("${conv.title}") in "${conv.cwd}", possibly editing the same project in parallel with your running task.`,
+                    });
+                }
+            }
+        }
         // 磁盘回放会话（switch_session）没有 live runtime session —— DSH 的
         // JSON-RPC 面不支持恢复（id collision），自动 fork 新会话继续：把历史
         // 作为上下文注入首条 prompt，前端提示。
@@ -1256,7 +1371,7 @@ export class DshClientSession {
             conv.title = trimmed.length > 30 ? `${trimmed.slice(0, 30)}…` : trimmed;
             this.emitConversations();
         }
-        await this.promptConv(conv, text, attachments, queue);
+        await this.promptConv(conv, text, attachments, queue, sysPrefix);
     }
     /**
      * Remove ONE queued prompt text (the ✕ on a pending bubble). DSH queues are
@@ -1315,13 +1430,15 @@ export class DshClientSession {
             /* 补图失败保持占位 */
         }
     }
-    async promptConv(conv, text, attachments, _queue = false) {
+    async promptConv(conv, text, attachments, _queue = false, 
+    // issue #145 同项目并行提醒：只进运行时上下文，不进用户气泡。
+    sysPrefix = "") {
         try {
             if (this.quiesceBlocked())
                 return;
             conv.promptedSinceActive = true;
             conv.lastEventAt = Date.now();
-            const blocks = await this.buildContentBlocks(text, attachments);
+            const blocks = await this.buildContentBlocks(sysPrefix ? `${sysPrefix}${text}` : text, attachments);
             // 乐观落地用户消息（id 用暂定值；user/message 事件到达时按内容去重）。
             const optimistic = {
                 id: `u-pending-${Date.now()}-${conv.deltaSeq++}`,
@@ -1869,6 +1986,29 @@ export class DshClientSession {
                     return;
                 }
             }
+            // issue #145：同 pi 引擎 —— 别处正在跑同一 sessionId 时不建第二个持有者。
+            const owner = this.findSessionOwnerById?.(sessionId);
+            if (owner && owner.isStreaming) {
+                this.emit({
+                    type: "notice",
+                    level: "warning",
+                    text: `该对话正在另一处运行中（「${owner.title}」），为避免两个 agent 同时写同一份记录，已停止打开。请等它结束后再试，或回到原窗口继续。`,
+                    textEn: `This conversation is running in another window ("${owner.title}"). Opening it here would create a second writer for the same transcript, so it was blocked. Wait for it to finish, or continue in the original window.`,
+                });
+                this.flushSnapshot(true);
+                return;
+            }
+            if (owner) {
+                // 对端已断开（标签页关了）只剩残留会话 —— 不打扰，直接开。
+                if (owner.connected) {
+                    this.emit({
+                        type: "notice",
+                        level: "info",
+                        text: `提醒：该对话在另一处也开着（「${owner.title}」，当前空闲）。请只留一处发送消息，否则两边轮流发送会让历史分叉、其中一支事后不可见。`,
+                        textEn: `Note: this conversation is also open in another window ("${owner.title}", currently idle). Send new messages from only one place — alternating between two writers forks the history and hides one branch.`,
+                    });
+                }
+            }
             const prev = this.conv;
             prev.listed = prev.isStreaming || prev.terminals.list().length > 0 || prev.promptedSinceActive;
             const conv = this.addConversation(sessionId, this.cwd, true);
@@ -2252,6 +2392,7 @@ export class DshClientSession {
             reviewPrompt: this.settings.reviewPrompt,
             reviewDisabledSkills: [],
             disabledPlugins: this.settings.disabledPlugins,
+            uiLayout: normalizeUiLayout(this.settings.uiLayout),
             promptTemplate: "",
             promptOverrides: {},
             effectiveSystemPrompt: this.settings.customSystemPrompt,
@@ -2306,6 +2447,8 @@ export class DshClientSession {
             this.settings.toolsWrap = partial.toolsWrap;
         if (partial.disabledPlugins !== undefined)
             this.settings.disabledPlugins = partial.disabledPlugins;
+        if (partial.uiLayout !== undefined)
+            this.settings.uiLayout = normalizeUiLayout(partial.uiLayout);
         if (partial.reviewPrompt !== undefined)
             this.settings.reviewPrompt = partial.reviewPrompt;
         if (partial.quickPhrases !== undefined) {
@@ -2334,6 +2477,7 @@ export class DshClientSession {
             thinkingWrap: this.settings.thinkingWrap,
             toolsWrap: this.settings.toolsWrap,
             disabledPlugins: this.settings.disabledPlugins,
+            uiLayout: normalizeUiLayout(this.settings.uiLayout),
             reviewPrompt: this.settings.reviewPrompt,
             quickPhrases: this.settings.quickPhrases,
             quickPhrasesEnabled: this.settings.quickPhrasesEnabled,
@@ -2442,6 +2586,7 @@ export class DshClientSession {
             thinkingWrap: this.settings.thinkingWrap,
             toolsWrap: this.settings.toolsWrap,
             disabledPlugins: this.settings.disabledPlugins,
+            uiLayout: normalizeUiLayout(this.settings.uiLayout),
             reviewPrompt: this.settings.reviewPrompt,
         });
         await this.applyPersona();
@@ -2983,7 +3128,9 @@ export class DshClientSession {
     }
     async checkUpdate() {
         try {
-            const latest = await checkAllUpdates([{ name: "pi-web-ui", version: DshClientSession.currentAppVersion(), kind: "webui" }], undefined, () => this.getLang());
+            // registry 遵从 ~/.pi/agent/npm/.npmrc（与 `pi update` 经 npm 的行为一致，issue #151）
+            const npmRegistry = resolveNpmRegistry(join(homedir(), ".pi", "agent"));
+            const latest = await checkAllUpdates([{ name: "pi-web-ui", version: DshClientSession.currentAppVersion(), kind: "webui" }], undefined, () => this.getLang(), npmRegistry);
             const item = latest[0];
             this.emit({
                 type: "update_status",
@@ -3008,7 +3155,7 @@ export class DshClientSession {
     async checkUpdatesAll(force = false) {
         try {
             const targets = collectTargets(join(homedir(), ".pi", "agent"), DshClientSession.currentAppVersion());
-            const items = await checkAllUpdates(targets, undefined, () => this.getLang());
+            const items = await checkAllUpdates(targets, undefined, () => this.getLang(), resolveNpmRegistry(join(homedir(), ".pi", "agent")));
             if (force) {
                 // 强制模式：忽略缓存（默认 Fetcher 带 TTL，直接再查一次即可）。
                 void items;
@@ -3263,6 +3410,19 @@ export class DshClientSession {
             return;
         this.stateStore.saveLocale(this.clientId, code);
     }
+    /** 设置当前项目的额外工作区根（宿主侧多根，宿主 API v2 的宿主侧能力）。
+     *  DSH 引擎没有插件宿主，多根只落到「宿主知道 / 快照下发」这一层：右栏文件树
+     *  （前端）据此多出可切换的根。
+     *  与 pi 引擎同口径：归一化交给 ClientStateStore（只收绝对路径 / 去重 / 上限 8）。 */
+    async setWorkspaceRoots(roots) {
+        const before = this.stateStore.getWorkspaceRoots(this.clientId, this.cwd);
+        this.stateStore.saveWorkspaceRoots(this.clientId, this.cwd, roots ?? []);
+        const saved = this.stateStore.getWorkspaceRoots(this.clientId, this.cwd);
+        if (saved.length === before.length && saved.every((p, i) => p === before[i]))
+            return;
+        this.roots = saved;
+        this.flushSnapshot();
+    }
     async setCwd(newCwd) {
         try {
             const abs = resolve(newCwd);
@@ -3278,6 +3438,7 @@ export class DshClientSession {
             if (abs === this.cwd)
                 return;
             this.cwd = abs;
+            this.roots = this.stateStore.getWorkspaceRoots(this.clientId, abs);
             this.stateStore.remember(this.clientId, abs);
             // 换项目 = 重启运行时（initialize 固定 cwd）。
             try {
@@ -3440,6 +3601,71 @@ export class DshAgentService {
             service: toServiceInfo(launchOrigin()),
         };
     }
+    /** issue #145：跨客户端同会话查重（sessionId 口径，与 pi 引擎同语义）。 */
+    findSessionOwner(sessionId, excludeClientId) {
+        for (const [clientId, cs] of this.clients) {
+            if (clientId === excludeClientId)
+                continue;
+            const conv = cs.findConversationBySessionId(sessionId);
+            if (conv)
+                return {
+                    clientId,
+                    title: conv.title,
+                    cwd: conv.cwd,
+                    isStreaming: conv.isStreaming,
+                    connected: cs.sinkCount() > 0,
+                };
+        }
+        return null;
+    }
+    /** issue #145：别处在某 cwd 下正在跑的对话（同项目并行感知用）。 */
+    listProjectRunners(cwd, excludeClientId) {
+        const out = [];
+        for (const [clientId, cs] of this.clients) {
+            if (clientId === excludeClientId)
+                continue;
+            for (const r of cs.streamingInCwd(cwd))
+                out.push({ clientId, title: r.title });
+        }
+        return out;
+    }
+    /** issue #145：别处所有正在跑的对话（左栏 elsewhere 只读感知用）。 */
+    listExternalRunning(excludeClientId) {
+        const out = [];
+        for (const [clientId, cs] of this.clients) {
+            if (clientId === excludeClientId)
+                continue;
+            for (const r of cs.streamingSummariesAll())
+                out.push(r);
+        }
+        return out;
+    }
+    /** issue #145：某客户端流式集合变化 → 其他客户端重推 conversations。 */
+    pokeExternalRunning(excludeClientId) {
+        for (const [clientId, cs] of this.clients) {
+            if (clientId === excludeClientId)
+                continue;
+            try {
+                cs.refreshExternalRunning();
+            }
+            catch {
+                // 单客户端坏了不影响其他
+            }
+        }
+    }
+    /** issue #145：向除请求方外的所有客户端发一条 notice（并行通告用）。 */
+    notifyClientsExcept(excludeClientId, msg) {
+        for (const [clientId, cs] of this.clients) {
+            if (clientId === excludeClientId)
+                continue;
+            try {
+                cs.emitNotice(msg.level, msg.text, msg.textEn);
+            }
+            catch {
+                // 单客户端坏了不影响其他
+            }
+        }
+    }
     async attach(clientId, send) {
         let cs = this.clients.get(clientId);
         if (!cs) {
@@ -3478,6 +3704,12 @@ export class DshAgentService {
         cs.pluginBgTasksProvider = this.pluginBgTasksProvider;
         cs.pluginStopBgTask = this.pluginStopBgTask;
         cs.isQuiesced = () => this.quiesced;
+        // issue #145 跨客户端感知接线（同会话查重 / 同项目并行 / elsewhere 列表）。
+        cs.findSessionOwnerById = (sessionId) => this.findSessionOwner(sessionId, clientId);
+        cs.listProjectRunners = (cwd) => this.listProjectRunners(cwd, clientId);
+        cs.listExternalRunning = () => this.listExternalRunning(clientId);
+        cs.notifyExternalClients = (msg) => this.notifyClientsExcept(clientId, msg);
+        cs.onRunningChanged = () => this.pokeExternalRunning(clientId);
         cs.onCwdChanged = (abs) => this.onClientCwdChanged?.(abs);
         this.onClientCwdChanged?.(cs.cwd);
         return cs;