@windypro-rourou/dsh-code-studio 0.1.1 → 0.1.3

package/README.md

@@ -1,42 +1,43 @@
-# Code Studio 鈥?DSH Web GUI 鐨?VS Code + Cline 娣峰悎鎻掍欢
+# Code Studio — DSH Web UI 文件修改监视器 · 代码工作台
 
-鍦?DeepSeek Harness 鐨?Web 鐣岄潰锛坵ebui锛夐噷鐩存帴**娴忚銆佺紪杈戜唬鐮?*锛屽苟鍦?**Agent 淇敼鏂囦欢鏃跺儚 Cline 涓€鏍烽€愯鏄剧ず Diff**锛氭敼鍔ㄥ尯琛屽彿鍓嶆爣娉?`+`锛堟柊澧?缁胯壊锛夈€乣-`锛堝垹闄?绾㈣壊锛夈€乣~`锛堜慨鏀?榛勮壊锛夈€?
-## 鍔熻兘
+> A **file-change monitor & code editor** inside the DeepSeek Harness Web UI.
+> Watch agent edits land as line-by-line diffs in real time, right beside your
+> conversation — then open, edit and save any workspace file without leaving
+> the browser.
 
-- 鏂囦欢鏍戯細宸︿晶鎳掑姞杞界洰褰曟爲锛岀偣鍑绘枃浠舵墦寮€锛堟敮鎸佹墦寮€宸ヤ綔鍖轰换鎰忚矾寰勶級銆?- 缂栬緫鍣細甯﹁鍙风殑浠ｇ爜缂栬緫瑙嗗浘锛汣trl+S 淇濆瓨锛孋trl+D 鍦?缂栬緫/Diff 闂村垏鎹€?- Cline 寮?Diff锛欴iff 瑙嗗浘鎸夎鏄剧ず before/after锛涜鍙峰墠鏂规湁绗﹀彿鍒楋紙+ - ~锛夛紝鏈敼鍔ㄥぇ娈佃嚜鍔ㄦ姌鍙犱负銆屸嫰 N 琛屾湭鏀瑰姩銆嶏紝鍙偣鍑诲睍寮€鍏ㄩ儴銆?- Agent 鍙樻洿璺熻釜锛欻ost 渚ч€掑綊鐩戝惉宸ヤ綔鍖猴紙fs.watch + mtime 杞鍏滃簳锛夛紝Agent 鍐欏叆鏂囦欢鍚庢祻瑙堝櫒瀹炴椂鏀跺埌浜嬩欢锛涙枃浠舵爲椤堕儴銆孉gent 鍙樻洿銆嶅垪琛ㄦ樉绀烘湁鍙樻洿鐨勬枃浠讹紙缁?鏂板缓銆侀粍=淇敼銆佺孩=鍒犻櫎锛夛紝鐐瑰嚮鍗崇湅 Diff銆?- 鍙樻洿鍘嗗彶锛氭瘡涓枃浠朵繚鐣欐渶杩?30 鏉?before/after 璁板綍锛?api/code-studio/history锛夈€?- 鍙岀鎻掍欢锛欻ost锛圢ode锛夋彁渚?/api/code-studio/* REST + SSE锛汣lient锛堟祻瑙堝櫒 bundle锛夋彁渚?UI銆?
-## 瀹夎锛堝凡瑁呭ソ锛?
-鎻掍欢宸插畨瑁呭埌 web profile锛?DSH_HOME/profiles/web锛夛細
-- 鍖呬綅浜?profiles/web/node_modules/@windypro-rourou/dsh-code-studio
-- cordis.patch.yml 宸叉彃鍏?code-studio 琛?- package.json 宸插姞鍏?link:F:/CycleMaster/dsh-code-studio 渚濊禆
+在 DeepSeek Harness 的 Web 界面里，实时监视 Agent 对文件的每一次修改：**改动落盘的瞬间**，逐行 Diff（`+` 新增 / `−` 删除 / `~` 修改）自动浮现在你的会话旁；内置语法高亮编辑器，随时查看和修改工作区文件。**不用离开 DSH，Agent 改了哪里、改了什么，一目了然。**
 
-**鐢熸晥鏃舵満**锛欴SH 鐨勫鎴风鎻掍欢鍚嶅崟锛坆oot manifest锛夊湪鍚姩鏃跺浐鍖栵紝鏂版彃浠堕渶瑕?*閲嶅惎 dsh web**锛堟垨涓嬫鍚姩 harness锛夊悗鍑虹幇鍦ㄤ晶杈规爮銆傚綋鍓嶆鍦ㄨ繍琛岀殑 webui 鏃犳硶鐑姞杞芥柊鎻掍欢锛堣繖鏄钩鍙版満鍒讹紝闈炴彃浠剁己闄凤級銆?
-### 鎵嬪姩瀹夎锛堝叾浠栨満鍣級
+## 核心价值
 
-```powershell
-# 1. 鐢ㄥ畼鏂瑰懡浠ら摼鎺ユ彃浠讹紙浼氳嚜鍔ㄦ妸瀹冨姞鍏?profile bundles 灞傦級
-dsh plugin --profile web add link:F:/CycleMaster/dsh-code-studio
+- 🔭 **实时文件修改监视**：基于会话工具事件直推，Agent 每次 write / edit 完成立即推送 Diff —— 不依赖文件系统轮询，不漏报、不延迟。
+- 🗂 **多工作区覆盖**：自动监视所有会话的工作区目录，Agent 在任意目录改文件都能捕获。
+- 🔒 **按会话隔离**：每个 Code Studio 只响应当前会话的修改，切换会话互不干扰。
+- 🧠 **会话状态记忆**：变更列表、打开的标签、面板宽度按会话分别保留（本地持久化）。
+- 📝 **语法高亮编辑器**：类编辑器体验，行号、光标、滚动同步；`Ctrl+S` 保存，`Ctrl+D` 查看 Diff。
+- 📐 **可拖拽面板**：宽度自由调整并记住；UI 与 DSH 主题完全一致（`--dsw-alias-*` 令牌）。
 
-# 2. 鎴栬€呭湪 profiles/web/cordis.patch.yml 杩藉姞锛?# - insert:
-#     - id: code-studio
-#       name: '@windypro-rourou/dsh-code-studio'
-```
+## 安装
 
-### 鐜板湪灏辨兂棰勮锛?
-```powershell
-dsh web --port 3081   # 浼氱湅鍒颁晶杈规爮鍑虹幇 "Code Studio" 鍏ュ彛
+```sh
+dsh plugin --profile web add @windypro-rourou/dsh-code-studio
+# 或使用 GitHub 源
+dsh plugin --profile web add github:WindyPro-rourou/dsh-code-studio
 ```
 
-## 浣跨敤
+重启 `dsh web` 后，左侧边栏出现 **Code Studio** 入口。
+
+## 使用
+
+1. 打开 Code Studio（右侧面板，可拖左缘调宽）。
+2. 让 Agent 修改代码 —— 面板**自动浮现**该文件的逐行 Diff：行号前 `+`（绿）/ `−`（红）/ `~`（黄），未改动大段自动折叠。
+3. 「文件」页签：浏览工作区、打开文件、直接编辑保存（`Ctrl+S`）。
+
+## 技术说明
 
-1. 鍒锋柊椤甸潰鍚庯紝宸︿晶杈规爮鍑虹幇 **Code Studio** 鍏ュ彛锛堜唬鐮佸浘鏍囷級銆?2. 鐐瑰嚮鎵撳紑鍏ㄥ睆闈㈡澘锛氬乏渚ф枃浠舵爲锛屼腑闂存爣绛鹃〉缂栬緫鍣ㄣ€?3. 璁?Agent 淇敼浠ｇ爜锛堝啓鏂囦欢/缂栬緫锛夛紝闈㈡澘椤堕儴銆孉gent 鍙樻洿銆嶅疄鏃跺垪鍑哄彉鍖栨枃浠躲€?4. 鐐瑰嚮鍙樻洿鏂囦欢 鈫?榛樿杩涘叆 Diff 瑙嗗浘锛氳鍙峰墠绗﹀彿 + 棰滆壊鑳屾櫙锛屼竴鐩簡鐒躲€?
-## 蹇嵎閿?
-| 鎸夐敭 | 鍔熻兘 |
-| --- | --- |
-| Ctrl+S | 淇濆瓨褰撳墠鏂囦欢 |
-| Ctrl+D | 鍒囨崲 缂栬緫 / Diff 瑙嗗浘 |
+- **Host**（`lib/index.js`）：监听 `session/event` 工具事件（`tool/call` ↔ `tool/result` 配对），对写文件工具即时读取并推送 before/after；递归文件监视 + mtime 轮询兜底；`/api/code-studio/*` REST + SSE。
+- **Client**（`lib/client.js`）：浏览器 bundle，仅依赖 react；LCS 行级 Diff 引擎、语法高亮、按会话状态管理。
 
-## 鎶€鏈鏄?
-- Host锛歭ib/index.js 鈥?webServer.register 娉ㄥ唽 6 涓矾鐢憋紱fs.watch(recursive) + 1500ms mtime 杞锛涘姣忎釜鏂囦欢缁存姢鍩虹嚎蹇収锛屼粠鑰屼骇鍑虹簿纭殑 before/after銆?- Client锛歭ib/client.js 鈥?绾祻瑙堝櫒 bundle锛坵indow.__ModuleLoader__.load锛夛紝浠呬緷璧?react/react-dom锛涜嚜甯?LCS 琛岀骇 diff 寮曟搸涓庢牱寮忋€?- 璺緞瀹夊叏锛欰PI 浠呮帴鍙?loopback + 鍚屾簮鏍囪璇锋眰銆?
-## 宸茬煡闄愬埗
+## 已知限制
 
-- 鍗曟枃浠?> 512KB 涓嶈鍙栧唴瀹癸紙闃叉祻瑙堝櫒鍗℃锛夛紝浣嗕細鏍囪銆屾枃浠惰繃澶с€嶃€?- Diff 瑙嗗浘閽堝銆屾墦寮€鍚?涓婃璇诲彇鍚庛€嶇殑鍙樻洿鍋氬熀绾垮姣旓紝绗﹀悎 Cline 鐨勪細璇濊涔夈€?
+- 单文件 > 512KB 不读取内容（防浏览器卡顿）。
+- 通过 bash/pwsh 等非文件工具写入的变更依赖文件监视兜底（仍会捕获，可能有少量延迟）。

package/lib/client.js

@@ -166,6 +166,28 @@ window.__ModuleLoader__.load({
 		}
 		function subscribePanel(fn) { panel.listeners.add(fn); return () => panel.listeners.delete(fn); }
 
+		// current session id (per-session change isolation)
+		let currentSessionId = null;
+		const sessListeners = new Set();
+		function setSessionId(v) {
+			currentSessionId = v;
+			for (const fn of sessListeners) fn(v);
+		}
+		function subscribeSession(fn) { sessListeners.add(fn); return () => sessListeners.delete(fn); }
+
+		// per-session UI state memory (changes, tabs, width), persisted locally
+		const SESS_STATE_KEY = "cs.sessionStates.v1";
+		function loadSessionStates() {
+			try {
+				const raw = globalThis.localStorage?.getItem(SESS_STATE_KEY);
+				if (raw) return JSON.parse(raw);
+			} catch { /* ignore */ }
+			return {};
+		}
+		function persistSessionStates(map) {
+			try { globalThis.localStorage?.setItem(SESS_STATE_KEY, JSON.stringify(map)); } catch { /* ignore */ }
+		}
+
 		// ============================ CSS ============================
 		const CSS = [
 			".cs-root{position:absolute;top:0;right:0;bottom:0;display:flex;flex-direction:column;background:var(--dsw-alias-bg-layer-1,#151922);color:var(--dsw-alias-label-primary,#d7dde6);border-left:1px solid var(--dsw-alias-border-l1,#262a33);font:13px/1.55 -apple-system,BlinkMacSystemFont,\"Segoe UI\",Roboto,sans-serif;z-index:30;box-shadow:-12px 0 32px rgba(0,0,0,.18);animation:csSlideIn .18s ease-out;--cs-mono:ui-monospace,SFMono-Regular,Menlo,Consolas,\"Liberation Mono\",monospace}",
@@ -408,6 +430,32 @@ window.__ModuleLoader__.load({
 			});
 			const dragRef = React.useRef(null);
 			const changedSet = React.useMemo(() => new Set(changes.map((c) => c.path)), [changes]);
+			// current session for per-session isolation
+			const [sessId, setSessId] = React.useState(currentSessionId);
+			const sessIdRef = React.useRef(currentSessionId);
+			// per-session UI memory: save current snapshot on switch, restore target's
+			const sessStatesRef = React.useRef(loadSessionStates());
+			const snapRef = React.useRef({ changes, expandedPath, editor, tab, width });
+			snapRef.current = { changes, expandedPath, editor, tab, width };
+			React.useEffect(() => subscribeSession((v) => {
+				const cur = sessIdRef.current;
+				if (cur && cur !== v) {
+					sessStatesRef.current[cur] = snapRef.current;
+					persistSessionStates(sessStatesRef.current);
+				}
+				sessIdRef.current = v;
+				setSessId(v);
+				const st = sessStatesRef.current[v];
+				if (st) {
+					setChanges(st.changes ?? []);
+					setExpandedPath(st.expandedPath ?? null);
+					setEditor(st.editor ?? null);
+					setTab(st.tab ?? "changes");
+					setWidth(st.width ?? 400);
+				} else {
+					setChanges([]); setExpandedPath(null); setEditor(null); setTab("changes");
+				}
+			}), []);
 
 			React.useEffect(() => subscribePanel(setOpen), []);
 			React.useEffect(() => {
@@ -435,11 +483,16 @@ window.__ModuleLoader__.load({
 						try {
 							const ev = JSON.parse(msg.data);
 							if (!ev || typeof ev.path !== "string") return;
+							// per-session isolation: only react to changes owned by the active session
+							// (or unattributed ones, treated as the current session's/user's own edits)
+							// per-session isolation: only filter when we KNOW the active session.
+							// If current is null, do not filter - otherwise edits would never appear.
+							if (ev.sessionId && sessIdRef.current && ev.sessionId !== sessIdRef.current) return;
 							setConn("ok"); setConnText("已连接");
 							const name = ev.path.split(/[\\/]/).pop() || ev.path;
 							setChanges((prev) => {
 								const next = prev.filter((c) => c.path !== ev.path);
-								next.unshift({ path: ev.path, name, before: ev.before, after: ev.after, deleted: !!ev.deleted, ts: ev.ts });
+								next.unshift({ path: ev.path, name, before: ev.before, after: ev.after, deleted: !!ev.deleted, ts: ev.ts, sessionId: ev.sessionId });
 								return next.slice(0, 50);
 							});
 							setPanelOpen(true);
@@ -487,12 +540,17 @@ window.__ModuleLoader__.load({
 				setTab("changes");
 				setExpandedPath(path);
 				historyApi(path).then((data) => {
-					const last = data.events && data.events.length > 0 ? data.events[data.events.length - 1] : null;
-					if (!last) return;
+					const events = data.events && data.events.length > 0 ? data.events : [];
+					if (events.length === 0) return;
+					// prefer the latest event owned by the active session; fall back to the latest overall
+					let last = events[events.length - 1];
+					for (let i = events.length - 1; i >= 0; i--) {
+						if (events[i].sessionId && events[i].sessionId === sessIdRef.current) { last = events[i]; break; }
+					}
 					const name = path.split(/[\\/]/).pop() || path;
 					setChanges((prev) => {
 						if (prev.some((c) => c.path === path)) return prev;
-						return [{ path, name, before: last.before, after: last.after, deleted: !!last.deleted, ts: last.ts }, ...prev];
+						return [{ path, name, before: last.before, after: last.after, deleted: !!last.deleted, ts: last.ts, sessionId: last.sessionId }, ...prev];
 					});
 				}).catch(() => {});
 			};
@@ -513,7 +571,10 @@ window.__ModuleLoader__.load({
 				if (!dragRef.current) return;
 				dragRef.current = null;
 				e.currentTarget.classList.remove("cs-drag");
-				try { globalThis.localStorage?.setItem("cs.panelWidth", String(width)); } catch { /* ignore */ }
+				if (sessIdRef.current) {
+					sessStatesRef.current[sessIdRef.current] = { ...snapRef.current, width };
+					persistSessionStates(sessStatesRef.current);
+				}
 			};
 
 			if (!open) {
@@ -596,6 +657,7 @@ window.__ModuleLoader__.load({
 					el("span", { className: "cs-sdot cs-" + conn }),
 					el("span", null, connText),
 					el("span", { style: { marginLeft: "auto" } }, "变更 " + changes.length + " 文件"),
+					sessId ? el("span", { title: "仅显示当前会话的变更" }, "会话 " + String(sessId).slice(-6)) : null,
 					el("span", null, editor && editor.dirty ? "未保存" : "就绪")
 				)
 			);
@@ -662,6 +724,17 @@ window.__ModuleLoader__.load({
 				} catch (error) {
 					console.error("[code-studio] sidebar entry failed", error);
 				}
+				// track the active session so the panel only reacts to this session's edits
+				try {
+					const sessions = ctx.get("sessions");
+					if (sessions && typeof sessions.list?.getSnapshot === "function" && typeof sessions.list.subscribe === "function") {
+						const sync = () => { try { setSessionId(sessions.list.getSnapshot()?.current ?? null); } catch { /* ignore */ } };
+						disposers.push(sessions.list.subscribe(sync));
+						sync();
+					}
+				} catch (error) {
+					console.error("[code-studio] session tracking failed", error);
+				}
 				try {
 					const slots = ctx.get("slots");
 					if (slots !== void 0) {

package/lib/index.js

@@ -61,7 +61,9 @@ function safePath(raw) {
 
 class FileLedger {
   constructor(root) {
-    this.root = root;
+    /** watched workspace roots (one recursive watcher each) */
+    this.roots = new Set();
+    this.watchers = new Map();
     /** baseline cache: absolute path -> { content, mtimeMs, size } */
     this.baseline = new Map();
     /** change history: absolute path -> [{ ts, before, after, deleted }] */
@@ -69,7 +71,41 @@ class FileLedger {
     /** SSE subscribers */
     this.subscribers = new Set();
     this.debounce = new Map();
-    this.watcher = void 0;
+    /** file path -> owning session { sessionId, ts } (learnt from tool/call events) */
+    this.owners = new Map();
+    if (root) this.addRoot(root);
+  }
+
+  /** Add one workspace root (recursive watcher). Idempotent. */
+  addRoot(root) {
+    if (typeof root !== "string" || root === "") return;
+    let resolved;
+    try { resolved = realpathSync(root); } catch { return; }
+    if (this.roots.has(resolved)) return;
+    this.roots.add(resolved);
+    try {
+      const watcher = fsWatch(resolved, { recursive: true }, (_eventType, filename) => {
+        if (typeof filename !== "string") return;
+        this.schedule(join(resolved, filename));
+      });
+      watcher.on?.("error", () => { /* poll covers us */ });
+      this.watchers.set(resolved, watcher);
+    } catch { /* poll covers us */ }
+  }
+
+  /** Attribute a file to a session (from a session tool/call event). */
+  claim(path, sessionId) {
+    if (typeof path !== "string" || path === "" || typeof sessionId !== "string") return;
+    this.owners.set(path, { sessionId, ts: Date.now() });
+    if (this.owners.size > 2000) {
+      const oldest = [...this.owners.entries()].sort((a, b) => a[1].ts - b[1].ts)[0];
+      if (oldest) this.owners.delete(oldest[0]);
+    }
+  }
+
+  /** Owning session for a path, if known. */
+  ownerOf(path) {
+    return this.owners.get(path)?.sessionId ?? null;
   }
 
   snapshot(path) {
@@ -111,8 +147,9 @@ class FileLedger {
       if (error.code === "ENOENT") {
         const before = this.baseline.get(path);
         this.baseline.delete(path);
-        this.push({ path, ts: Date.now(), before: before?.content ?? null, after: null, deleted: true });
-        this.addHistory(path, { ts: Date.now(), before: before?.content ?? null, after: null, deleted: true });
+        const ev = { path, ts: Date.now(), before: before?.content ?? null, after: null, deleted: true, sessionId: this.ownerOf(path) };
+        this.push(ev);
+        this.addHistory(path, ev);
         return;
       }
       return;
@@ -121,7 +158,7 @@ class FileLedger {
     const before = prior && !prior.tooLarge ? prior.content : null;
     this.baseline.set(path, { ...current });
     if (prior && prior.mtimeMs === current.mtimeMs && prior.size === current.size && prior.content === current.content) return;
-    const event = { path, ts: Date.now(), before, after: current.tooLarge ? null : current.content, deleted: false, tooLarge: current.tooLarge };
+    const event = { path, ts: Date.now(), before, after: current.tooLarge ? null : current.content, deleted: false, tooLarge: current.tooLarge, sessionId: this.ownerOf(path) };
     this.push(event);
     this.addHistory(path, event);
   }
@@ -163,21 +200,14 @@ class FileLedger {
   }
 
   start() {
-    try {
-      this.watcher = fsWatch(this.root, { recursive: true }, (_eventType, filename) => {
-        if (typeof filename !== "string") return;
-        this.schedule(join(this.root, filename));
-      });
-      this.watcher.on?.("error", () => { /* recursive watch may fail on some mounts; poll covers us */ });
-    } catch (error) {
-      this.watcher = void 0;
-    }
+    for (const root of this.roots) this.addRoot(root);
   }
 
   stop() {
     for (const timer of this.debounce.values()) clearTimeout(timer);
     this.debounce.clear();
-    if (this.watcher) { try { this.watcher.close(); } catch { /* ignore */ } }
+    for (const watcher of this.watchers.values()) { try { watcher.close(); } catch { /* ignore */ } }
+    this.watchers.clear();
     for (const res of this.subscribers) { try { res.destroy(); } catch { /* ignore */ } }
     this.subscribers.clear();
   }
@@ -277,7 +307,8 @@ function makeRoutes(ledger, root, cwd) {
           before: ledger.snapshot(path)?.content ?? null,
           after: body.content,
           deleted: false,
-          source: "user"
+          source: "user",
+          sessionId: ledger.ownerOf(path)
         };
         ledger.recordBaseline(path, body.content, mtimeMs, body.content.length);
         ledger.push(event);
@@ -322,6 +353,21 @@ function makeRoutes(ledger, root, cwd) {
 
 /* ---------- plugin ---------- */
 
+/** Tool names whose arguments carry a file path we can attribute to a session. */
+const PATH_TOOLS = new Set(["write", "edit", "str-replace", "apply-patch", "fs-write", "write-file"]);
+const PATH_ARGS = ["file_path", "path", "filePath", "target", "file"];
+
+/** Resolve a tool argument to an absolute path, anchoring relative paths at the session cwd. */
+function toolPath(args, sessionCwd) {
+  for (const key of PATH_ARGS) {
+    const p = args?.[key];
+    if (typeof p === "string" && p !== "") {
+      return isAbsolute(p) ? resolve(p) : resolve(sessionCwd ?? process.cwd(), p);
+    }
+  }
+  return void 0;
+}
+
 function apply(ctx, config) {
   const root = realpathSync((config?.root && config.root !== "" ? config.root : process.env.DSH_WORKSPACE ?? process.cwd()));
   const cwd = process.cwd();
@@ -335,6 +381,58 @@ function apply(ctx, config) {
       const timer = setInterval(() => ledger.poll(), pollIntervalMs);
       timer.unref();
       disposers.push(() => clearInterval(timer));
+      // Watch every session's workspace, not just our cwd: agents edit files
+      // in whichever directory their session was started in.
+      const addSessionRoot = (session) => {
+        if (session?.header?.cwd) ledger.addRoot(session.header.cwd);
+      };
+      try {
+        const sessions = ctx.get("sessions");
+        if (sessions && typeof sessions.list === "function") {
+          for (const session of sessions.list()) addSessionRoot(session);
+        }
+      } catch { /* ignore */ }
+      // ---- reliable real-time change detection from tool events ----
+      // tool/call records { name, arguments, callId } per session; tool/result
+      // pairs by callId. On a file-writing tool completing, read the file NOW
+      // and push the change immediately (fs.watch on atomic writes/renames is
+      // unreliable and late), attributing it to the owning session.
+      const pendingCalls = new Map(); // callId -> { name, args, sessionId, cwd }
+      const offSession = ctx.on("session/event", (session, event) => {
+        addSessionRoot(session);
+        const data = event?.data;
+        if (!data || typeof data !== "object") return;
+        if (event.type === "tool/call") {
+          if (typeof data.name === "string" && data.arguments && typeof data.arguments === "object") {
+            pendingCalls.set(String(data.callId), {
+              name: data.name,
+              args: data.arguments,
+              sessionId: session?.id,
+              cwd: session?.header?.cwd
+            });
+            if (pendingCalls.size > 500) {
+              const oldest = pendingCalls.keys().next().value;
+              if (oldest !== void 0) pendingCalls.delete(oldest);
+            }
+          }
+          return;
+        }
+        if (event.type === "tool/result") {
+          const callId = data.message?.source?.callId ?? data.callId ?? data.call_id;
+          const call = callId !== void 0 ? pendingCalls.get(String(callId)) : void 0;
+          if (call === void 0) return;
+          pendingCalls.delete(String(callId));
+          if (!PATH_TOOLS.has(call.name)) return;
+          const abs = toolPath(call.args, call.cwd);
+          if (abs === void 0) return;
+          ledger.claim(abs, call.sessionId);
+          // proactive immediate read+push; fs.watch remains a fallback for
+          // writes that bypass tools (bash, user edits)
+          void ledger.handleChange(abs);
+          return;
+        }
+      });
+      disposers.push(offSession);
     } catch (error) {
       for (const dispose of disposers) dispose();
       ledger.stop();

package/package.json

@@ -1,56 +1,56 @@
-{
-  "name": "@windypro-rourou/dsh-code-studio",
-  "description": "Code Studio for DSH Web GUI — a VS Code + Cline hybrid: file tree, syntax-highlighted editor, and Cline-style line-by-line diffs that auto-appear when the agent edits files.",
-  "version": "0.1.1",
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/types/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/types/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./client": {
-      "types": "./lib/types/client/index.d.ts",
-      "default": "./lib/client.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [
-        "@deepseek-ai/dsh-client-runtime"
-      ],
-      "platform": "web"
-    }
-  },
-  "keywords": [
-    "dsh-plugin",
-    "dsh",
-    "deepseek-harness",
-    "code-studio",
-    "cline",
-    "diff",
-    "editor",
-    "web-ui"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/windypro-rourou/dsh-code-studio.git"
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "react": "^18.2.0"
-  },
-  "files": [
-    "lib/**/*.js",
-    "lib/**/*.d.ts",
-    "cordis.patch.yml",
-    "README.md",
-    "scripts"
-  ],
-  "license": "MIT"
-}
+{
+    "name":  "@windypro-rourou/dsh-code-studio",
+    "description":  "File-change monitor \u0026 code editor for the DSH Web UI: watch agent edits land as line-by-line diffs in real time, right beside your conversation, then view and edit any workspace file without leaving the browser.",
+    "version":  "0.1.3",
+    "type":  "module",
+    "main":  "lib/index.js",
+    "types":  "lib/types/index.d.ts",
+    "exports":  {
+                    ".":  {
+                              "types":  "./lib/types/index.d.ts",
+                              "default":  "./lib/index.js"
+                          },
+                    "./client":  {
+                                     "types":  "./lib/types/client/index.d.ts",
+                                     "default":  "./lib/client.js"
+                                 },
+                    "./package.json":  "./package.json"
+                },
+    "dsh":  {
+                "bundle":  {
+                               "patch":  "./cordis.patch.yml"
+                           },
+                "client":  {
+                               "inject":  [
+                                              "@deepseek-ai/dsh-client-runtime"
+                                          ],
+                               "platform":  "web"
+                           }
+            },
+    "keywords":  [
+                     "dsh-plugin",
+                     "dsh",
+                     "deepseek-harness",
+                     "code-studio",
+                     "cline",
+                     "diff",
+                     "editor",
+                     "web-ui"
+                 ],
+    "repository":  {
+                       "type":  "git",
+                       "url":  "git+https://github.com/windypro-rourou/dsh-code-studio.git"
+                   },
+    "peerDependencies":  {
+                             "@deepseek-ai/cordis":  "^4.0.1",
+                             "react":  "^18.2.0"
+                         },
+    "files":  [
+                  "lib/**/*.js",
+                  "lib/**/*.d.ts",
+                  "cordis.patch.yml",
+                  "README.md",
+                  "scripts"
+              ],
+    "license":  "MIT"
+}