@windypro-rourou/dsh-code-studio 0.1.4 → 0.2.0

package/README.md

@@ -5,15 +5,22 @@
 > conversation — then open, edit and save any workspace file without leaving
 > the browser.
 
-在 DeepSeek Harness 的 Web 界面里，实时监视 Agent 对文件的每一次修改：**改动落盘的瞬间**，逐行 Diff（`+` 新增 / `−` 删除 / `~` 修改）自动浮现在你的会话旁；内置语法高亮编辑器，随时查看和修改工作区文件。**不用离开 DSH，Agent 改了哪里、改了什么，一目了然。**
+在 DeepSeek Harness 的 Web 界面里，实时监视 Agent 对文件的每一次修改：**改动落盘的瞬间**，逐行 Diff（`+` 新增 / `−` 删除 / `~` 修改）自动浮现在你的会话旁；内置语法高亮编辑器，随时查看和修改工作区文件。**不用离开 DSH，Agent 改了哪里、改了什么、想还原就还原。**
 
 ## 核心价值
 
 - 🔭 **实时文件修改监视**：基于会话工具事件直推，Agent 每次 write / edit 完成立即推送 Diff —— 不依赖文件系统轮询，不漏报、不延迟。
-- 🗂 **多工作区覆盖**：自动监视所有会话的工作区目录，Agent 在任意目录改文件都能捕获。
-- 🔒 **按会话隔离**：每个 Code Studio 只响应当前会话的修改，切换会话互不干扰。
-- 🧠 **会话状态记忆**：变更列表、打开的标签、面板宽度按会话分别保留（本地持久化）。
+- 🗂 **多工作区覆盖 + 切换器**：自动监视所有会话的工作区目录，「文件」页签顶部可随时切换工作区根目录（按会话记忆）。
+- 🔒 **按会话隔离**：每个 Code Studio 只响应当前会话的修改，切换会话互不干扰；未查看变更数徽标按会话分别计数。
+- 🧠 **会话状态记忆**：变更列表、打开的标签、面板宽度、过滤条件、工作区选择按会话分别保留（本地持久化）。
+- ↩️ **一键还原（Revert）**：每个变更条目带「还原」按钮 —— 撤销 Agent 在本会话内对该文件的全部修改（还原点取自 Agent 首次写入前的内容快照；新建文件还原为删除；检测到外部修改会提示冲突）。
+- 🕘 **修改历史时间线**：每个文件的 Agent / 用户 / 还原事件按时间倒序回放，任意版本可展开查看 Diff。
+- 💬 **发送到会话**：把当前打开的文件内容一键发给当前会话的 Agent（不可用时自动退化为复制到剪贴板）。
 - 📝 **语法高亮编辑器**：类编辑器体验，行号、光标、滚动同步；`Ctrl+S` 保存，`Ctrl+D` 查看 Diff。
+- ⚡ **大文件虚拟滚动**：Diff 视图窗口化渲染 + 差异过大截断提示，万行级文件流畅滚动。
+- 🔁 **SSE 断线自愈**：事件带序号 + 服务端环形缓冲，断线重连自动补发丢失的变更（Last-Event-ID）。
+- 🔍 **变更过滤搜索**：按路径关键词 + 文件类型（代码/文档/配置/其他）过滤变更列表。
+- ⌨️ **键盘快捷键**：`Ctrl+Alt+C` 开关面板，`Alt+↓/↑` 在变更之间跳转。
 - 📐 **可拖拽面板**：宽度自由调整并记住；UI 与 DSH 主题完全一致（`--dsw-alias-*` 令牌）。
 
 ## 安装
@@ -33,16 +40,20 @@ dsh plugin --profile web add github:WindyPro-rourou/dsh-code-studio
 
 ## 使用
 
-1. 打开 Code Studio（右侧面板，可拖左缘调宽）。
-2. 让 Agent 修改代码 —— 面板**自动浮现**该文件的逐行 Diff：行号前 `+`（绿）/ `−`（红）/ `~`（黄），未改动大段自动折叠。
-3. 「文件」页签：浏览工作区、打开文件、直接编辑保存（`Ctrl+S`）。
+1. 打开 Code Studio（右侧面板，可拖左缘调宽；`Ctrl+Alt+C` 快捷开关）。
+2. 让 Agent 修改代码 —— 面板**自动浮现**该文件的逐行 Diff：行号前 `+`（绿）/ `−`（红）/ `~`（黄），未改动大段自动折叠；面板关闭时侧边栏入口显示未查看变更数徽标。
+3. 对不满意的修改点「还原」，一键回到 Agent 动手前；点「历史」回放该文件的每一次改动。
+4. 「文件」页签：切换工作区、浏览文件树、打开文件直接编辑保存（`Ctrl+S`），或「发送到会话」让 Agent 接着改。
+5. 变更多了？顶部搜索框 + 类型筛选快速定位；`Alt+↓/↑` 在变更间跳转。
 
 ## 技术说明
 
-- **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**（`lib/index.js`）：监听 `session/event` 工具事件（`tool/call` ↔ `tool/result` 配对），在 `tool/call` 阶段抓取还原点快照、在 `tool/result` 阶段即时读取并推送 before/after；递归文件监视 + mtime 轮询兜底；SSE 事件带自增 `id` 并保留 200 条环形缓冲用于 `Last-Event-ID` 断线补发；`/api/code-studio/*` REST + SSE（含 `/revert`、`/workspaces`、`/history`）。
+- **Client**（`lib/client.js`）：浏览器 bundle，仅依赖 react；LCS 行级 Diff 引擎（大文件自动退化贪心算法）、窗口化虚拟滚动、语法高亮、按会话状态管理、未读徽标。
+- **自测**：`node scripts/selftest.mjs`（host 逻辑 21 项断言）、`node scripts/smoke-client.mjs`（浏览器 bundle 冒烟）。
 
 ## 已知限制
 
-- 单文件 > 512KB 不读取内容（防浏览器卡顿）。
-- 通过 bash/pwsh 等非文件工具写入的变更依赖文件监视兜底（仍会捕获，可能有少量延迟）。
+- 单文件 > 512KB 不读取内容（防浏览器卡顿）；>100KB 的历史事件内容会截断保存（SSE 推送仍为全量）。
+- 通过 bash/pwsh 等非文件工具写入的变更依赖文件监视兜底（仍会捕获，可能有少量延迟），且仅显示 Agent 声明过的文件。
+- 还原点保存在内存中，服务重启后丢失（新会话的 Agent 修改会重新建立还原点）。

package/lib/client.js

@@ -151,6 +151,10 @@ window.__ModuleLoader__.load({
 			const i = name.lastIndexOf(".");
 			return i >= 0 ? name.slice(i + 1).toLowerCase() : "";
 		}
+		const CODE_EXTS = new Set(["js","jsx","ts","tsx","mjs","cjs","py","go","rs","java","kt","kts","swift","c","h","cpp","hpp","cc","cs","php","rb","sh","ps1","lua","pl","vue","svelte","html","css","scss","less","sql","proto","dart","ex","exs","ml","fs","scala","zig","asm"]);
+		const DOC_EXTS = new Set(["md","mdx","txt","rst","adoc"]);
+		const CONF_EXTS = new Set(["json","jsonc","yml","yaml","toml","ini","conf","cfg","xml","env"]);
+		function extType(ext) { return CODE_EXTS.has(ext) ? "code" : DOC_EXTS.has(ext) ? "doc" : CONF_EXTS.has(ext) ? "conf" : "other"; }
 		function Highlighted({ text, path }) {
 			const toks = React.useMemo(() => tokenizeLine(text), [text]);
 			return el("span", null,
@@ -175,6 +179,17 @@ window.__ModuleLoader__.load({
 		}
 		function subscribeSession(fn) { sessListeners.add(fn); return () => sessListeners.delete(fn); }
 
+		// ============================ module state ============================
+		let ctxRef = null;            // plugin ctx (set in apply) for send-to-chat
+		let lastSeq = 0;              // last SSE seq seen (dedupe + replay recovery)
+		const unseen = new Map();     // sessionKey -> unseen change count (sidebar badge)
+		const badgeListeners = new Set();
+		function bumpUnseen(key, by) { unseen.set(key, (unseen.get(key) ?? 0) + by); for (const fn of badgeListeners) fn(); }
+		function clearUnseen(key) { if (key != null && unseen.delete(key)) for (const fn of badgeListeners) fn(); }
+		function unseenCount(key) { return unseen.get(key) ?? 0; }
+		function subscribeBadge(fn) { badgeListeners.add(fn); return () => badgeListeners.delete(fn); }
+		function badgeKey(sessionId) { return sessionId ?? "__unknown"; }
+
 		// per-session UI state memory (changes, tabs, width), persisted locally
 		const SESS_STATE_KEY = "cs.sessionStates.v1";
 		function loadSessionStates() {
@@ -217,8 +232,8 @@ window.__ModuleLoader__.load({
 			".cs-bad-del{background:var(--dsw-alias-state-error-secondary,rgba(239,68,68,.14));color:var(--dsw-alias-state-error-primary,#ef4444)}",
 			".cs-plus{color:var(--dsw-alias-state-success-primary,#22c55e);flex:none;font-size:11px}",
 			".cs-minus{color:var(--dsw-alias-state-error-primary,#ef4444);flex:none;font-size:11px}",
-			".cs-chg-body{border-top:1px solid var(--dsw-alias-border-l1,#262a33)}",
-			".cs-dline{display:flex;font-family:var(--cs-mono);font-size:11.5px;line-height:1.5;min-width:max-content}",
+			".cs-chg-body{border-top:1px solid var(--dsw-alias-border-l1,#262a33);max-height:55vh;overflow:auto}",
+			".cs-dline{display:flex;font-family:var(--cs-mono);font-size:11.5px;line-height:17px;height:17px;min-width:max-content;overflow:hidden}",
 			".cs-dg{flex:none;display:flex;user-select:none}",
 			".cs-dsym{width:16px;flex:none;text-align:center;font-weight:700}",
 			".cs-dnum{min-width:34px;flex:none;text-align:right;padding-right:8px;color:var(--dsw-alias-label-quaternary,#565e6e);font-size:10.5px}",
@@ -226,7 +241,7 @@ window.__ModuleLoader__.load({
 			".cs-dline.cs-add{background:var(--dsw-alias-state-success-secondary,rgba(34,197,94,.14))}.cs-dline.cs-add .cs-dsym{color:var(--dsw-alias-state-success-primary,#22c55e)}",
 			".cs-dline.cs-del{background:var(--dsw-alias-state-error-secondary,rgba(239,68,68,.13))}.cs-dline.cs-del .cs-dsym{color:var(--dsw-alias-state-error-primary,#ef4444)}.cs-dline.cs-del .cs-dtxt{text-decoration:line-through;text-decoration-color:rgba(239,68,68,.45)}",
 			".cs-dline.cs-mod{background:var(--dsw-alias-state-warn-secondary,rgba(234,179,8,.12))}.cs-dline.cs-mod .cs-dsym{color:var(--dsw-alias-state-warn-primary,#eab308)}",
-			".cs-dgap{display:flex;align-items:center;gap:8px;padding:0 10px;height:22px;cursor:pointer;color:var(--dsw-alias-label-tertiary,#8b93a3);font-size:10.5px;user-select:none}",
+			".cs-dgap{display:flex;align-items:center;gap:8px;padding:0 10px;height:17px;cursor:pointer;color:var(--dsw-alias-label-tertiary,#8b93a3);font-size:10.5px;user-select:none}",
 			".cs-dgap:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(255,255,255,.05))}",
 			".cs-dgap .cs-dgbar{flex:1;height:1px;background:var(--dsw-alias-border-l1,#262a33)}",
 			".cs-empty{flex:1;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:6px;color:var(--dsw-alias-label-tertiary,#8b93a3);font-size:12px;padding:24px}",
@@ -262,16 +277,18 @@ window.__ModuleLoader__.load({
 			".cs-status .cs-err{background:var(--dsw-alias-state-error-primary,#ef4444)}",
 			".cs-badge-f{position:fixed;right:16px;bottom:16px;z-index:40;display:flex;align-items:center;gap:8px;padding:8px 14px;border-radius:10px;background:var(--dsw-alias-bg-overlay,#1b2130);color:var(--dsw-alias-label-primary,#d7dde6);border:1px solid var(--dsw-alias-border-l1,#262a33);font-size:12px;cursor:pointer;box-shadow:0 8px 24px rgba(0,0,0,.3);animation:csSlideIn .2s ease-out}",
 			".cs-badge-f:hover{background:var(--dsw-alias-bg-layer-3,#222836)}",
-			".cs-badge-f .cs-bd{width:8px;height:8px;border-radius:50%;background:var(--dsw-alias-state-business-primary,#2f6fed);flex:none}"
+			".cs-badge-f .cs-bd{width:8px;height:8px;border-radius:50%;background:var(--dsw-alias-state-business-primary,#2f6fed);flex:none}",".cs-badge-n{flex:none;min-width:16px;height:16px;padding:0 4px;border-radius:8px;background:var(--dsw-alias-state-error-primary,#ef4444);color:#fff;font-size:9.5px;font-weight:600;display:flex;align-items:center;justify-content:center;margin-left:auto;line-height:1}",".cs-filter{display:flex;gap:6px;padding:6px 8px;flex:none;border-bottom:1px solid var(--dsw-alias-border-l1,#262a33);background:var(--dsw-alias-bg-layer-2,#1a1f2b)}",".cs-filter input{flex:1;min-width:0;background:var(--dsw-alias-bg-base,#0f1115);border:1px solid var(--dsw-alias-border-l1,#262a33);color:var(--dsw-alias-label-primary,#d7dde6);border-radius:6px;padding:3px 8px;font-size:11px;outline:none}",".cs-filter select{flex:none;background:var(--dsw-alias-bg-base,#0f1115);border:1px solid var(--dsw-alias-border-l1,#262a33);color:var(--dsw-alias-label-secondary,#b6bdc9);border-radius:6px;padding:3px 4px;font-size:11px;outline:none}",".cs-rev{flex:none;background:transparent;border:1px solid var(--dsw-alias-border-l1,#262a33);color:var(--dsw-alias-state-warn-primary,#eab308);border-radius:6px;padding:1px 7px;font-size:10.5px;cursor:pointer;font-family:var(--cs-mono)}",".cs-rev:hover{background:var(--dsw-alias-state-warn-secondary,rgba(234,179,8,.12))}",".cs-rev:disabled{opacity:.4;cursor:default}",".cs-hist-back{display:flex;align-items:center;gap:8px;padding:6px 10px;flex:none;border-bottom:1px solid var(--dsw-alias-border-l1,#262a33);font-size:11px;color:var(--dsw-alias-label-tertiary,#8b93a3);background:var(--dsw-alias-bg-layer-2,#1a1f2b)}",".cs-hist-back .cs-fp{flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-family:var(--cs-mono)}",".cs-hist-item{border:1px solid var(--dsw-alias-border-l1,#262a33);border-radius:8px;margin:0 2px 6px;overflow:hidden;background:var(--dsw-alias-bg-base,#0f1115)}",".cs-hist-row{display:flex;align-items:center;gap:8px;padding:5px 8px;cursor:pointer;font-family:var(--cs-mono);font-size:10.5px;color:var(--dsw-alias-label-secondary,#b6bdc9)}",".cs-hist-row:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(255,255,255,.05))}",".cs-hist-tag{font-size:9.5px;border-radius:4px;padding:0 5px;flex:none}",".cs-hist-tag.cs-src{background:var(--dsw-alias-state-business-secondary,rgba(47,111,237,.16));color:var(--dsw-alias-state-business-primary,#2f6fed)}",".cs-hist-tag.cs-usr{background:var(--dsw-alias-state-warn-secondary,rgba(234,179,8,.12));color:var(--dsw-alias-state-warn-primary,#eab308)}",".cs-hist-tag.cs-rev2{background:var(--dsw-alias-state-success-secondary,rgba(34,197,94,.16));color:var(--dsw-alias-state-success-primary,#22c55e)}",".cs-ws-bar{display:flex;align-items:center;gap:6px;padding:5px 8px;border-bottom:1px solid var(--dsw-alias-border-l1,#262a33);flex:none;background:var(--dsw-alias-bg-layer-2,#1a1f2b)}",".cs-ws-bar select{flex:1;min-width:0;background:var(--dsw-alias-bg-base,#0f1115);border:1px solid var(--dsw-alias-border-l1,#262a33);color:var(--dsw-alias-label-secondary,#b6bdc9);border-radius:6px;padding:3px 6px;font-size:11px;outline:none}",".cs-ws-bar span{font-size:10px;color:var(--dsw-alias-label-quaternary,#565e6e);white-space:nowrap}",".cs-kbd{font-family:var(--cs-mono);font-size:10px;background:var(--dsw-alias-bg-mask-1,rgba(255,255,255,.05));border:1px solid var(--dsw-alias-border-l1,#262a33);border-radius:4px;padding:0 4px;color:var(--dsw-alias-label-tertiary,#8b93a3)}"
 		].join("\n");
 
 		// ============================ diff view ============================
+		const ROW_H = 17; // must match .cs-dline/.cs-dgap CSS height
+		const MAX_DIFF_ROWS = 30000;
 		function DiffRows({ before, after, path, expanded }) {
 			const ops = React.useMemo(() => mergeModified(lineDiff(before, after)), [before, after]);
 			const [open, setOpen] = React.useState(false);
 			const showAll = expanded === true || open;
 			const blocks = React.useMemo(() => buildBlocks(ops), [ops]);
-			const rows = [];
+			const [scrollTop, setScrollTop] = React.useState(0);
 			const rowOf = (op, key) => {
 				const type = op.type;
 				const sym = type === "add" ? "+" : type === "del" ? "−" : type === "mod" ? "~" : " ";
@@ -282,21 +299,34 @@ window.__ModuleLoader__.load({
 					el("span", { className: "cs-dtxt" }, el(Highlighted, { text: op.text, path }))
 				);
 			};
-			for (const block of blocks) {
-				if (block.kind === "gap") {
-					rows.push(el("div", { className: "cs-dgap", key: "g" + rows.length, onClick: () => setOpen(true) },
-						el("span", null, "⋯ " + block.count + " 行未改动"),
-						el("span", { className: "cs-dgbar" })
-					));
-				} else {
-					for (const op of block.ops) rows.push(rowOf(op, "r" + rows.length));
+			const rows = React.useMemo(() => {
+				const out = [];
+				for (const block of blocks) {
+					if (block.kind === "gap") {
+						out.push(el("div", { className: "cs-dgap", key: "g" + out.length, onClick: () => setOpen(true) },
+							el("span", null, "⋯ " + block.count + " 行未改动"),
+							el("span", { className: "cs-dgbar" })
+						));
+					} else {
+						for (const op of block.ops) out.push(rowOf(op, "r" + out.length));
+					}
 				}
-			}
-			if (showAll) {
-				const all = ops.map((op, i) => rowOf(op, "e" + i));
-				return el("div", null, all);
-			}
-			return el("div", null, rows);
+				if (showAll) {
+					const all = ops.map((op, i) => rowOf(op, "e" + i));
+					return all;
+				}
+				return out;
+			}, [blocks, ops, showAll]);
+			const total = Math.min(rows.length, MAX_DIFF_ROWS);
+			const onScroll = (e) => setScrollTop(e.currentTarget.scrollTop);
+			const start = Math.max(0, Math.floor(scrollTop / ROW_H) - 12);
+			const end = Math.min(total, Math.ceil((scrollTop + 420) / ROW_H) + 12);
+			return el("div", { className: "cs-chg-body", onScroll },
+				total < rows.length ? el("div", { className: "cs-dgap", key: "limit" }, "⋯ 差异过大，仅显示前 " + total + " 行") : null,
+				el("div", { key: "top", style: { height: start * ROW_H } }),
+				rows.slice(start, end),
+				el("div", { key: "bot", style: { height: (total - end) * ROW_H } })
+			);
 		}
 
 		// ============================ file tree ============================
@@ -364,7 +394,7 @@ window.__ModuleLoader__.load({
 		}
 
 		// ============================ editor (syntax highlighted overlay) ============================
-		function Editor({ file, onEdit, onSave, onDiff }) {
+		function Editor({ file, onEdit, onSave, onDiff, onSend, onHistory }) {
 			const gutterRef = React.useRef(null);
 			const hlRef = React.useRef(null);
 			const taRef = React.useRef(null);
@@ -390,6 +420,8 @@ window.__ModuleLoader__.load({
 						el("b", { style: { color: "var(--dsw-alias-state-error-primary)" } }, "−" + stats.dels)
 					) : null,
 					el("button", { className: "cs-btn", onClick: onDiff, title: "查看该文件的 Diff" }, "Diff"),
+					el("button", { className: "cs-btn", onClick: onHistory, title: "该文件的修改历史" }, "历史"),
+					el("button", { className: "cs-btn", onClick: onSend, disabled: file.content == null, title: "把文件内容发送给当前会话的 Agent" }, "发送到会话"),
 					el("button", { className: "cs-btn cs-pri", onClick: onSave, disabled: !file.dirty || file.content == null }, "保存")
 				),
 				el("div", { className: "cs-edit-wrap" },
@@ -428,6 +460,14 @@ window.__ModuleLoader__.load({
 				} catch { /* ignore */ }
 				return 400;
 			});
+			const [reverting, setReverting] = React.useState(null);
+			const [histPath, setHistPath] = React.useState(null);
+			const [histData, setHistData] = React.useState([]);
+			const [histOpen, setHistOpen] = React.useState(null);
+			const [filter, setFilter] = React.useState("");
+			const [ftype, setFtype] = React.useState("all");
+			const [workspaces, setWorkspaces] = React.useState([]);
+			const [activeRoot, setActiveRoot] = React.useState(null);
 			const dragRef = React.useRef(null);
 			const changedSet = React.useMemo(() => new Set(changes.map((c) => c.path)), [changes]);
 			// current session for per-session isolation
@@ -435,8 +475,8 @@ window.__ModuleLoader__.load({
 			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 };
+			const snapRef = React.useRef({ changes, expandedPath, editor, tab, width, filter, ftype, activeRoot });
+			snapRef.current = { changes, expandedPath, editor, tab, width, filter, ftype, activeRoot };
 			React.useEffect(() => subscribeSession((v) => {
 				const cur = sessIdRef.current;
 				if (cur && cur !== v) {
@@ -452,12 +492,19 @@ window.__ModuleLoader__.load({
 					setEditor(st.editor ?? null);
 					setTab(st.tab ?? "changes");
 					setWidth(st.width ?? 400);
+					setFilter(st.filter ?? "");
+					setFtype(st.ftype ?? "all");
+					setActiveRoot(st.activeRoot ?? null);
 				} else {
 					setChanges([]); setExpandedPath(null); setEditor(null); setTab("changes");
+					setFilter(""); setFtype("all"); setActiveRoot(null);
 				}
 			}), []);
 
-			React.useEffect(() => subscribePanel(setOpen), []);
+			React.useEffect(() => subscribePanel((open) => {
+				setOpen(open);
+				if (open) { clearUnseen(badgeKey(sessIdRef.current)); }
+			}), []);
 			React.useEffect(() => {
 				const tagId = "@windypro-rourou/dsh-code-studio/styles";
 				if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=\"" + tagId + "\"]") === null) {
@@ -469,7 +516,11 @@ window.__ModuleLoader__.load({
 				}
 			}, []);
 			React.useEffect(() => {
-				getRoot().then((d) => setRoot(d.root)).catch((e) => { setConn("err"); setConnText(String(e.message)); });
+				getRoot().then((d) => {
+					setRoot(d.root);
+					setActiveRoot((prev) => prev ?? d.root);
+				}).catch((e) => { setConn("err"); setConnText(String(e.message)); });
+				api("/workspaces").then((d) => setWorkspaces(d.workspaces ?? [])).catch(() => {});
 			}, []);
 
 			// SSE change feed + auto-appear
@@ -483,8 +534,11 @@ 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)
+							// dedupe across EventSource reconnect replays (Last-Event-ID)
+							if (typeof ev.seq === "number") {
+								if (ev.seq <= lastSeq) return;
+								lastSeq = ev.seq;
+							}
 							// 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;
@@ -492,9 +546,10 @@ window.__ModuleLoader__.load({
 							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, sessionId: ev.sessionId });
+								next.unshift({ path: ev.path, name, before: ev.before, after: ev.after, deleted: !!ev.deleted, ts: ev.ts, seq: ev.seq, sessionId: ev.sessionId });
 								return next.slice(0, 50);
 							});
+							if (ev.source !== "revert" && !panel.open) bumpUnseen(badgeKey(ev.sessionId ?? sessIdRef.current), 1);
 							setPanelOpen(true);
 							setExpandedPath(ev.path);
 						} catch { /* ignore */ }
@@ -504,9 +559,21 @@ window.__ModuleLoader__.load({
 				return () => { if (source) source.close(); };
 			}, []);
 
-			// Ctrl+S / Ctrl+D
+			// keyboard: Ctrl+Alt+C toggle panel, Alt+↓/↑ jump changes, Ctrl+S save, Ctrl+D diff
 			React.useEffect(() => {
 				const onKey = (e) => {
+					if ((e.ctrlKey || e.metaKey) && e.altKey && (e.key === "c" || e.key === "C")) {
+						e.preventDefault();
+						setPanelOpen(!panel.open);
+						return;
+					}
+					if (e.altKey && !e.ctrlKey && !e.metaKey && !e.shiftKey && (e.key === "ArrowDown" || e.key === "ArrowUp")) {
+						const t = e.target;
+						if (t && (t.tagName === "TEXTAREA" || t.tagName === "INPUT" || t.isContentEditable)) return;
+						e.preventDefault();
+						stepChange(e.key === "ArrowDown" ? 1 : -1);
+						return;
+					}
 					if (!editor) return;
 					if ((e.ctrlKey || e.metaKey) && e.key === "s") { e.preventDefault(); void saveCurrent(); }
 					if ((e.ctrlKey || e.metaKey) && e.key === "d") { e.preventDefault(); viewDiff(editor.path); }
@@ -555,6 +622,62 @@ window.__ModuleLoader__.load({
 				}).catch(() => {});
 			};
 			const clearChanges = () => setChanges([]);
+			const revertChange = async (path) => {
+				if (typeof globalThis.confirm !== "function" || !globalThis.confirm("还原将撤销 Agent 在本会话内对该文件的全部修改（若期间有外部改动会被覆盖）。确定还原？")) return;
+				setReverting(path);
+				setConn("busy"); setConnText("还原中…");
+				try {
+					const r = await api("/revert", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ path }) });
+					setConn("ok"); setConnText(r.conflict ? "已还原（检测到外部修改，已覆盖）" : "已还原 " + new Date().toLocaleTimeString());
+				} catch (e) {
+					setConn("err"); setConnText("还原失败: " + e.message);
+				} finally { setReverting(null); }
+			};
+			const openHistory = (path) => {
+				setHistPath(path); setHistData([]); setHistOpen(null);
+				historyApi(path).then((d) => setHistData(d.events ?? [])).catch(() => setHistData([]));
+			};
+			const sendToChat = async (path, content) => {
+				if (content == null) return;
+				const text = "我在 Code Studio 中打开了文件 " + path + "，内容如下：\n\n```\n" + content + "\n```";
+				try {
+					const sessions = ctxRef && typeof ctxRef.get === "function" ? ctxRef.get("sessions") : void 0;
+					const face = sessions && typeof sessions.binding === "function" ? sessions.binding(sessIdRef.current)?.session : void 0;
+					if (face && typeof face.prompt === "function") {
+						setConn("busy"); setConnText("发送到会话…");
+						await face.prompt([{ type: "text", text }], "queue");
+						setConn("ok"); setConnText("已发送到会话");
+						return;
+					}
+				} catch (e) {
+					setConn("err"); setConnText("发送失败: " + e.message);
+					return;
+				}
+				try {
+					await navigator.clipboard.writeText(text);
+					setConn("ok"); setConnText("已复制到剪贴板（自动发送不可用）");
+				} catch {
+					setConn("err"); setConnText("无法发送");
+				}
+			};
+			const stepChange = (dir) => {
+				if (changes.length === 0) return;
+				const idx = changes.findIndex((c) => c.path === expandedPath);
+				const from = idx < 0 ? (dir > 0 ? -1 : 0) : idx;
+				const next = changes[Math.max(0, Math.min(changes.length - 1, from + dir))];
+				if (!next) return;
+				setExpandedPath(next.path);
+				const node = document.querySelector('[data-cs-chg="' + (globalThis.CSS && globalThis.CSS.escape ? globalThis.CSS.escape(next.path) : next.path) + '"]');
+				if (node) node.scrollIntoView({ block: "center", behavior: "smooth" });
+			};
+			const shownChanges = React.useMemo(() => {
+				const q = filter.trim().toLowerCase();
+				return changes.filter((c) => {
+					if (q && !c.path.toLowerCase().includes(q) && !c.name.toLowerCase().includes(q)) return false;
+					if (ftype !== "all" && extType(extOf(c.path)) !== ftype) return false;
+					return true;
+				});
+			}, [changes, filter, ftype]);
 
 			// drag to resize
 			const onResizeDown = (e) => {
@@ -577,6 +700,108 @@ window.__ModuleLoader__.load({
 				}
 			};
 
+			const renderChangesTab = () => {
+				if (histPath) {
+					return el("div", { className: "cs-files" },
+						el("div", { className: "cs-hist-back" },
+							el("button", { className: "cs-btn", onClick: () => setHistPath(null) }, "← 返回变更"),
+							el("span", { className: "cs-fp" }, histPath)
+						),
+						el("div", { className: "cs-chg-list" },
+							histData.length === 0
+								? el("div", { className: "cs-empty" }, "暂无历史记录")
+								: histData.map((ev, i) => {
+									const stats = ev.deleted ? { adds: 0, dels: 0 } : fileStats(ev.before, ev.after);
+									const tag = ev.source === "revert"
+										? el("span", { className: "cs-hist-tag cs-rev2" }, "还原")
+										: ev.source === "user"
+											? el("span", { className: "cs-hist-tag cs-usr" }, "用户")
+											: el("span", { className: "cs-hist-tag cs-src" }, "Agent");
+									const isOpen = histOpen === i;
+									return el("div", { className: "cs-hist-item", key: i },
+										el("div", { className: "cs-hist-row", onClick: () => setHistOpen(isOpen ? null : i) },
+											el("span", { className: "cs-caret" }, isOpen ? "▾" : "▸"),
+											tag,
+											el("span", { style: { color: "var(--dsw-alias-label-tertiary)" } }, new Date(ev.ts).toLocaleTimeString()),
+											el("span", { className: "cs-plus" }, "+" + stats.adds),
+											el("span", { className: "cs-minus" }, "−" + stats.dels)
+										),
+										isOpen ? el(DiffRows, { before: ev.before, after: ev.after, path: histPath }) : null
+									);
+								})
+						)
+					);
+				}
+				if (changes.length === 0) {
+					return el("div", { className: "cs-empty" },
+						el("div", null, "暂无文件变更"),
+						el("span", { className: "cs-hint" }, "Agent 修改文件时，这里会自动浮现逐行 Diff（+ 新增  − 删除  ~ 修改）。快捷键：Ctrl+Alt+C 开关面板，Alt+↓/↑ 跳转变更")
+					);
+				}
+				return el("div", { className: "cs-files" },
+					el("div", { className: "cs-filter" },
+						el("input", { placeholder: "搜索路径…", value: filter, onChange: (e) => setFilter(e.target.value), spellCheck: false }),
+						el("select", { value: ftype, onChange: (e) => setFtype(e.target.value) },
+							el("option", { value: "all" }, "全部"),
+							el("option", { value: "code" }, "代码"),
+							el("option", { value: "doc" }, "文档"),
+							el("option", { value: "conf" }, "配置"),
+							el("option", { value: "other" }, "其他")
+						)
+					),
+					el("div", { className: "cs-chg-list" },
+						shownChanges.length === 0
+							? el("div", { className: "cs-empty" }, "无匹配的变更")
+							: shownChanges.map((c) => {
+								const stats = c.deleted ? { adds: 0, dels: 0 } : fileStats(c.before, c.after);
+								const isOpen = expandedPath === c.path;
+								return el("div", { className: "cs-chg", key: c.path, "data-cs-chg": c.path },
+									el("div", { className: "cs-chg-row", onClick: () => setExpandedPath(isOpen ? null : c.path) },
+										el("span", { className: "cs-caret" }, isOpen ? "▾" : "▸"),
+										el("span", { className: "cs-chg-path" }, c.name,
+											c.deleted ? el("span", { className: "cs-bad cs-bad-del" }, "删除")
+												: c.before == null ? el("span", { className: "cs-bad cs-bad-add" }, "新建")
+												: null
+										),
+										el("span", { className: "cs-plus" }, "+" + stats.adds),
+										el("span", { className: "cs-minus" }, "−" + stats.dels),
+										el("button", { className: "cs-rev", title: "还原为该会话 Agent 修改前的版本", disabled: reverting === c.path, onClick: (e) => { e.stopPropagation(); void revertChange(c.path); } }, "还原"),
+										el("button", { className: "cs-btn", title: "该文件的修改历史", onClick: (e) => { e.stopPropagation(); openHistory(c.path); } }, "历史")
+									),
+									isOpen ? (c.deleted
+										? el("div", { className: "cs-chg-body" }, el("div", { className: "cs-empty" }, "文件已删除"))
+										: el(DiffRows, { before: c.before, after: c.after, path: c.path })
+									) : null
+								);
+							}),
+						el("div", { style: { display: "flex", gap: 6, padding: "4px 2px" } },
+							el("button", { className: "cs-btn", onClick: clearChanges }, "清空列表")
+						)
+					)
+				);
+			};
+			const renderFilesTab = () => {
+				return el("div", { className: "cs-files" },
+					el("div", { className: "cs-ws-bar" },
+						el("span", null, "工作区"),
+						el("select", { value: activeRoot ?? "", onChange: (e) => setActiveRoot(e.target.value) },
+							(workspaces.length === 0 ? [{ path: root, label: root ?? "…", sessionCount: 0 }] : workspaces).map((w) =>
+								el("option", { value: w.path, key: w.path }, w.label + (w.sessionCount ? " (" + w.sessionCount + " 会话)" : ""))
+							)
+						)
+					),
+					(activeRoot ?? root) ? el(FileTree, { root: activeRoot ?? root, selected: editor?.path, changed: changedSet, onOpen: openFile })
+						: el("div", { className: "cs-empty" }, "加载工作区…"),
+					editor ? (
+						editor.loading ? el("div", { className: "cs-empty" }, "加载中…")
+						: editor.error ? el("div", { className: "cs-empty" }, editor.error)
+						: el(Editor, { file: editor, onEdit: editContent, onSave: () => void saveCurrent(), onDiff: () => viewDiff(editor.path), onSend: () => void sendToChat(editor.path, editor.content), onHistory: () => { viewDiff(editor.path); openHistory(editor.path); } })
+					) : el("div", { className: "cs-empty" },
+						el("div", null, "点击上方文件开始编辑"),
+						el("span", { className: "cs-hint" }, "打开文件后可编辑，Ctrl+S 保存，Ctrl+D 查看 Diff")
+					)
+				);
+			};
 			if (!open) {
 				if (changes.length > 0) {
 					return el("div", { className: "cs-badge-f", onClick: () => setPanelOpen(true) },
@@ -598,7 +823,7 @@ window.__ModuleLoader__.load({
 						el("span", { className: "cs-dot" }),
 						"Code Studio"
 					),
-					el("span", { className: "cs-count" }, changes.length > 0 ? changes.length + " 变更" : "就绪"),
+					el("span", { className: "cs-count" }, changes.length > 0 ? shownChanges.length + "/" + changes.length + " 变更" : "就绪"),
 					el("button", { className: "cs-close", onClick: () => setPanelOpen(false), title: "关闭" }, "✕")
 				),
 				el("div", { className: "cs-tabs" },
@@ -606,66 +831,33 @@ window.__ModuleLoader__.load({
 					el("div", { className: "cs-tab" + (tab === "files" ? " cs-on" : ""), onClick: () => setTab("files") }, "文件")
 				),
 				el("div", { className: "cs-body" },
-					tab === "changes" ? (
-						changes.length === 0
-							? el("div", { className: "cs-empty" },
-								el("div", null, "暂无文件变更"),
-								el("span", { className: "cs-hint" }, "Agent 修改文件时，这里会自动浮现逐行 Diff（+ 新增  − 删除  ~ 修改）")
-							)
-							: el("div", { className: "cs-chg-list" },
-								changes.map((c) => {
-									const stats = c.deleted ? { adds: 0, dels: 0 } : fileStats(c.before, c.after);
-									const isOpen = expandedPath === c.path;
-									return el("div", { className: "cs-chg", key: c.path },
-										el("div", { className: "cs-chg-row", onClick: () => setExpandedPath(isOpen ? null : c.path) },
-											el("span", { className: "cs-caret" }, isOpen ? "▾" : "▸"),
-											el("span", { className: "cs-chg-path" }, c.name,
-												c.deleted ? el("span", { className: "cs-bad cs-bad-del" }, "删除")
-													: c.before == null ? el("span", { className: "cs-bad cs-bad-add" }, "新建")
-													: null
-											),
-											el("span", { className: "cs-plus" }, "+" + stats.adds),
-											el("span", { className: "cs-minus" }, "−" + stats.dels)
-										),
-										isOpen ? el("div", { className: "cs-chg-body" },
-											c.deleted
-												? el("div", { className: "cs-empty" }, "文件已删除")
-												: el(DiffRows, { before: c.before, after: c.after, path: c.path })
-										) : null
-									);
-								}),
-								el("div", { style: { display: "flex", gap: 6, padding: "4px 2px" } },
-									el("button", { className: "cs-btn", onClick: clearChanges }, "清空列表")
-								)
-							)
-					) : (
-						el("div", { className: "cs-files" },
-							root ? el(FileTree, { root, selected: editor?.path, changed: changedSet, onOpen: openFile })
-								: el("div", { className: "cs-empty" }, "加载工作区…"),
-							editor ? (
-								editor.loading ? el("div", { className: "cs-empty" }, "加载中…")
-								: editor.error ? el("div", { className: "cs-empty" }, editor.error)
-								: el(Editor, { file: editor, onEdit: editContent, onSave: () => void saveCurrent(), onDiff: () => viewDiff(editor.path) })
-							) : el("div", { className: "cs-empty" },
-								el("div", null, "点击上方文件开始编辑"),
-								el("span", { className: "cs-hint" }, "打开文件后可编辑，Ctrl+S 保存，Ctrl+D 查看 Diff")
-							)
-						)
-					)
+					tab === "changes" ? renderChangesTab() : renderFilesTab()
 				),
 				el("div", { className: "cs-status" },
 					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 ? "未保存" : "就绪")
+					el("span", null, editor && editor.dirty ? "未保存" : "就绪"),
+					el("span", { style: { marginLeft: "auto" } }, "Ctrl+Alt+C 面板 · Alt+↓/↑ 跳转")
 				)
 			);
 		}
 
 		// ============================ sidebar entry ============================
 		const ENTRY_SELECTOR = "[data-cs-entry]";
-		const ENTRY_VERSION = "4";
+		const ENTRY_VERSION = "5";
+		let badgeEl = null;
+		function updateBadge() {
+			if (badgeEl === null) return;
+			const n = panel.open ? 0 : unseenCount(badgeKey(currentSessionId));
+			if (n > 0) {
+				badgeEl.textContent = n > 99 ? "99+" : String(n);
+				badgeEl.style.display = "flex";
+			} else {
+				badgeEl.style.display = "none";
+			}
+		}
 		const ENTRY_ICON = "<svg viewBox=\"0 0 16 16\" width=\"15\" height=\"15\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.3\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M4 1.5h6l2.5 2.5v10.5a.5.5 0 0 1-.5.5H4a.5.5 0 0 1-.5-.5V2a.5.5 0 0 1 .5-.5z\"/><path d=\"M4 6h8M4 9h8M4 12h5\"/></svg>";
 		function sidebarRoot() {
 			const column = document.querySelector("[data-pane=\"sidebar\"], [class*=\"sidebarCol\"]");
@@ -691,7 +883,7 @@ window.__ModuleLoader__.load({
 			entry.setAttribute("data-dsh-plugin", "code-studio");
 			entry.setAttribute("data-dsh-part", "sidebar-entry");
 			entry.title = "Code Studio — 代码编辑与 Diff（拖拽面板左缘可调宽）";
-			entry.innerHTML = "<span>" + ENTRY_ICON + "</span><span>Code Studio</span>";
+			entry.innerHTML = "<span>" + ENTRY_ICON + "</span><span>Code Studio</span><span data-cs-badge class=\"cs-badge-n\" style=\"display:none\"></span>";
 			entry.style.cssText = "display:flex;align-items:center;gap:8px;width:100%;padding:8px 12px;background:transparent;border:none;color:inherit;cursor:pointer;font-size:13px;border-radius:8px;";
 			entry.addEventListener("click", () => setPanelOpen(!panel.open));
 			let root;
@@ -709,7 +901,17 @@ window.__ModuleLoader__.load({
 			const observer = new MutationObserver(place);
 			observer.observe(document.body, { childList: true, subtree: true });
 			place();
-			return () => { observer.disconnect(); entry.remove(); };
+			badgeEl = entry.querySelector("[data-cs-badge]");
+			const unBadge = subscribeBadge(updateBadge);
+			const unPanel = subscribePanel(updateBadge);
+			const unSess = subscribeSession(updateBadge);
+			updateBadge();
+			return () => {
+				observer.disconnect();
+				entry.remove();
+				unBadge(); unPanel(); unSess();
+				badgeEl = null;
+			};
 		}
 
 		// ============================ apply ============================
@@ -717,6 +919,7 @@ window.__ModuleLoader__.load({
 		function apply(ctx) {
 			if (mounted) return;
 			mounted = true;
+			ctxRef = ctx;
 			ctx.effect(() => {
 				const disposers = [];
 				try {

package/lib/index.js

@@ -1,4 +1,4 @@
-import { readFile, readdir, stat, writeFile } from "node:fs/promises";
+import { readFile, readdir, stat, writeFile, unlink } from "node:fs/promises";
 import { watch as fsWatch, statSync, realpathSync } from "node:fs";
 import { join, dirname, basename, resolve, isAbsolute } from "node:path";
 
@@ -16,6 +16,9 @@ const HEARTBEAT_MS = 25000;
 const DEBOUNCE_MS = 120;
 const MAX_READ_BYTES = 512 * 1024; // protect the browser from huge files
 const HISTORY_LIMIT = 30;
+const HISTORY_MAX_CONTENT = 100 * 1024; // per-event content kept in history (SSE still carries full)
+const SSE_RING = 200; // events retained for Last-Event-ID replay
+const REVERT_LIMIT = 400;
 
 /* ---------- helpers ---------- */
 
@@ -73,6 +76,13 @@ class FileLedger {
     this.debounce = new Map();
     /** file path -> owning session { sessionId, ts } (learnt from tool/call events) */
     this.owners = new Map();
+    /** monotonic SSE sequence + replay ring (Last-Event-ID recovery) */
+    this.seq = 0;
+    this.ring = [];
+    /** agent-first-write snapshot per file: abs path -> { content|null, existed, sessionId, ts } */
+    this.revertPoints = new Map();
+    /** abs workspace root -> Set<sessionId> (for the workspace switcher) */
+    this.sessionRoots = new Map();
     if (root) this.addRoot(root);
   }
 
@@ -137,9 +147,20 @@ class FileLedger {
     return false;
   }
 
+  /**
+   * Only files the agent has actually touched (claimed via write/edit tool
+   * events) are interesting. Everything else - the user editing in another
+   * editor, IDE/build writes, background processes - is silently ignored so
+   * the panel shows exactly "which file the agent changed".
+   */
+  isInteresting(path) {
+    return this.owners.has(path);
+  }
+
   /** Called when a file may have changed on disk. */
   async handleChange(path) {
     if (FileLedger.isNoise(path)) return;
+    if (!this.isInteresting(path)) return;
     let current;
     try {
       current = await this.readCurrent(path);
@@ -163,16 +184,60 @@ class FileLedger {
     this.addHistory(path, event);
   }
 
+  /**
+   * Snapshot the file content BEFORE the agent's first write in a session, so
+   * the user can undo the agent's whole session on this file. Called at
+   * tool/call time (the write has not happened yet). Content null + existed
+   * false means the file did not exist (revert = keep deleted).
+   */
+  async captureRevertPoint(path, sessionId) {
+    if (typeof path !== "string" || path === "" || typeof sessionId !== "string") return;
+    const existing = this.revertPoints.get(path);
+    if (existing && existing.sessionId === sessionId) return;
+    let content = null;
+    let existed = false;
+    try {
+      const st = await stat(path);
+      existed = true;
+      if (st.size <= MAX_READ_BYTES) content = await readFile(path, "utf8");
+    } catch (error) {
+      if (error.code !== "ENOENT") return;
+    }
+    if (this.revertPoints.size >= REVERT_LIMIT) {
+      const oldest = [...this.revertPoints.entries()].sort((a, b) => a[1].ts - b[1].ts)[0];
+      if (oldest) this.revertPoints.delete(oldest[0]);
+    }
+    this.revertPoints.set(path, { content, existed, sessionId, ts: Date.now() });
+  }
+
+  /** Attribute a workspace root to a session (drives the switcher). */
+  noteSessionRoot(root, sessionId) {
+    if (typeof root !== "string" || root === "") return;
+    let resolved;
+    try { resolved = realpathSync(root); } catch { return; }
+    let set = this.sessionRoots.get(resolved);
+    if (!set) { set = new Set(); this.sessionRoots.set(resolved, set); }
+    if (sessionId) set.add(sessionId);
+  }
+
   addHistory(path, event) {
+    const trim = (v) => typeof v === "string" && v.length > HISTORY_MAX_CONTENT
+      ? v.slice(0, HISTORY_MAX_CONTENT) + "\n…[history 截断]"
+      : v;
+    const copy = { ...event, before: trim(event.before), after: trim(event.after) };
     const list = this.history.get(path) ?? [];
-    list.push(event);
+    list.push(copy);
     if (list.length > HISTORY_LIMIT) list.shift();
     this.history.set(path, list);
   }
 
   push(event) {
+    event.seq = ++this.seq;
+    if (this.ring.length >= SSE_RING) this.ring.shift();
+    this.ring.push(event);
+    const payload = `id: ${event.seq}\ndata: ${JSON.stringify(event)}\n\n`;
     for (const res of this.subscribers) {
-      try { res.write(`data: ${JSON.stringify(event)}\n\n`); } catch { /* ignore */ }
+      try { res.write(payload); } catch { /* ignore */ }
     }
   }
 
@@ -326,6 +391,70 @@ function makeRoutes(ledger, root, cwd) {
         json(res, 200, { ok: true, path, events: path === void 0 ? [] : (ledger.history.get(path) ?? []) });
       }
     },
+    {
+      kind: "exact",
+      path: `${PREFIX}/revert`,
+      handler: async (req, res) => {
+        if (req.method !== "POST") return json(res, 405, { ok: false, error: "method-not-allowed" });
+        if (!guard(req, res)) return;
+        let body;
+        try { body = await readBody(req); }
+        catch { return json(res, 400, { ok: false, error: "invalid-body" }); }
+        const path = safePath(body?.path);
+        if (path === void 0) return json(res, 400, { ok: false, error: "path-required" });
+        const point = ledger.revertPoints.get(path);
+        if (point === void 0) return json(res, 404, { ok: false, error: "no-revert-point" });
+        if (point.existed && point.content === null) return json(res, 409, { ok: false, error: "revert-point-too-large" });
+        // conflict: file differs from the last content we saw (changed outside the agent's write)
+        let current = null, currentDeleted = false, conflict = false;
+        try {
+          const st = await stat(path);
+          if (st.size <= MAX_READ_BYTES) current = await readFile(path, "utf8");
+        } catch (error) {
+          if (error.code === "ENOENT") currentDeleted = true;
+        }
+        const baseline = ledger.snapshot(path);
+        if (!currentDeleted && baseline !== void 0 && baseline.content !== null && current !== null && baseline.content !== current) conflict = true;
+        try {
+          if (!point.existed) {
+            await unlink(path).catch((error) => { if (error.code !== "ENOENT") throw error; });
+          } else {
+            await writeFile(path, point.content, "utf8");
+          }
+        } catch (error) {
+          return json(res, 400, { ok: false, error: String(error.message ?? error) });
+        }
+        const st2 = await stat(path).catch(() => void 0);
+        const event = {
+          path,
+          ts: Date.now(),
+          before: currentDeleted ? null : current,
+          after: point.existed ? point.content : null,
+          deleted: !point.existed,
+          source: "revert",
+          sessionId: ledger.ownerOf(path)
+        };
+        ledger.recordBaseline(path, point.content, st2?.mtimeMs ?? Date.now(), point.content?.length ?? 0);
+        ledger.push(event);
+        ledger.addHistory(path, event);
+        json(res, 200, { ok: true, path, reverted: true, conflict });
+      }
+    },
+    {
+      kind: "exact",
+      path: `${PREFIX}/workspaces`,
+      handler: (req, res) => {
+        if (req.method !== "GET") return json(res, 405, { ok: false, error: "method-not-allowed" });
+        if (!guard(req, res)) return;
+        const workspaces = [];
+        for (const r of ledger.roots) {
+          const sessions = ledger.sessionRoots.get(r);
+          workspaces.push({ path: r, label: r.split(/[\\/]/).pop() || r, sessionCount: sessions ? sessions.size : 0 });
+        }
+        workspaces.sort((a, b) => (a.path === root ? -1 : b.path === root ? 1 : a.label.localeCompare(b.label)));
+        json(res, 200, { ok: true, workspaces, current: root });
+      }
+    },
     {
       kind: "exact",
       path: `${PREFIX}/events`,
@@ -338,6 +467,14 @@ function makeRoutes(ledger, root, cwd) {
           connection: "keep-alive"
         });
         res.write(": connected\n\n");
+        const lastEventId = Number(req.headers["last-event-id"]);
+        if (Number.isFinite(lastEventId) && lastEventId > 0) {
+          for (const ev of ledger.ring) {
+            if (ev.seq > lastEventId) {
+              try { res.write(`id: ${ev.seq}\ndata: ${JSON.stringify(ev)}\n\n`); } catch { /* ignore */ }
+            }
+          }
+        }
         ledger.subscribers.add(res);
         const heartbeat = setInterval(() => { try { res.write(": ping\n\n"); } catch { /* ignore */ } }, HEARTBEAT_MS);
         const close = () => {
@@ -410,6 +547,11 @@ function apply(ctx, config) {
               sessionId: session?.id,
               cwd: session?.header?.cwd
             });
+            // snapshot the pre-write content NOW (tool/call fires before the write)
+            if (PATH_TOOLS.has(data.name)) {
+              const abs = toolPath(data.arguments, session?.header?.cwd);
+              if (abs !== void 0) void ledger.captureRevertPoint(abs, session?.id);
+            }
             if (pendingCalls.size > 500) {
               const oldest = pendingCalls.keys().next().value;
               if (oldest !== void 0) pendingCalls.delete(oldest);
@@ -445,4 +587,4 @@ function apply(ctx, config) {
   }, "code-studio: routes and watcher");
 }
 
-export { apply, inject, name };
+export { apply, inject, name, FileLedger, makeRoutes };

package/package.json

@@ -1,58 +1,58 @@
-{
-    "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.4",
-    "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",
-                             "@deepseek-ai/dsh-client-runtime":  "^0.1.0-rc.8",
-                             "@deepseek-ai/dsh-client-connection":  "^0.1.0-rc.8"
-                         },
-    "files":  [
-                  "lib/**/*.js",
-                  "lib/**/*.d.ts",
-                  "cordis.patch.yml",
-                  "README.md",
-                  "scripts"
-              ],
-    "license":  "MIT"
-}
+{
+    "name": "@windypro-rourou/dsh-code-studio",
+    "description": "File-change monitor & 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.2.0",
+    "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",
+        "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.8",
+        "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.8"
+    },
+    "files": [
+        "lib/**/*.js",
+        "lib/**/*.d.ts",
+        "cordis.patch.yml",
+        "README.md",
+        "scripts"
+    ],
+    "license": "MIT"
+}

package/scripts/selftest.mjs

@@ -0,0 +1,130 @@
+// selftest.mjs - zero-dependency sanity checks for the code-studio host half.
+// Run: node scripts/selftest.mjs  (needs a writable temp dir; cleans up after)
+import { mkdtemp, writeFile, readFile, rm, stat, unlink } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { FileLedger, makeRoutes } from "../lib/index.js";
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const ROOT = await mkdtemp(join(tmpdir(), "cs-selftest-"));
+const PREFIX = "/api/code-studio";
+let passed = 0, failed = 0;
+const ok = (cond, name) => { if (cond) { passed++; console.log("  ✓ " + name); } else { failed++; console.log("  ✗ FAIL: " + name); } };
+
+function mockReq(method, url, body) {
+  const req = { method, url, headers: {}, socket: { remoteAddress: "127.0.0.1" },
+    on(ev, fn) {
+      if (ev === "data" && body !== undefined) queueMicrotask(() => fn(Buffer.from(JSON.stringify(body))));
+      if (ev === "end") queueMicrotask(() => fn());
+      return req;
+    } };
+  return req;
+}
+function mockRes() {
+  return { status: 0, body: "", writeHead(s) { this.status = s; }, end(b) { if (typeof b === "string") this.body = b; }, write(b) { this.body += b; }, destroy() {} };
+}
+const route = (routes, p) => routes.find((r) => r.path === PREFIX + p);
+
+console.log("== FileLedger basics ==");
+const ledger = new FileLedger(ROOT);
+ok(ledger.roots.has(ROOT), "root added");
+
+// SSE seq + ring
+const received = [];
+ledger.subscribers.add({ write: (chunk) => received.push(chunk) });
+ledger.push({ path: "a", ts: 1 });
+ledger.push({ path: "b", ts: 2 });
+ok(received[0].startsWith("id: 1\ndata:"), "first event carries id:1");
+ok(received[1].includes("id: 2"), "second event carries id:2");
+ok(ledger.ring.length === 2 && ledger.ring[0].seq === 1 && ledger.ring[1].seq === 2, "ring keeps ordered seq");
+ledger.subscribers.clear();
+
+// claim + handleChange produces before/after event
+const f1 = join(ROOT, "alpha.txt");
+await writeFile(f1, "line1\nline2\n", "utf8");
+ledger.claim(f1, "s1");
+await ledger.handleChange(f1);
+let hist = ledger.history.get(f1) ?? [];
+ok(hist.length === 1 && hist[0].before === null && hist[0].after === "line1\nline2\n" && hist[0].sessionId === "s1", "first change: before=null after=content, session s1");
+await writeFile(f1, "line1\nCHANGED\n", "utf8");
+await ledger.handleChange(f1);
+hist = ledger.history.get(f1) ?? [];
+ok(hist.length === 2 && hist[1].before === "line1\nline2\n" && hist[1].after === "line1\nCHANGED\n", "second change carries before/after");
+
+// history trim
+const big = "x".repeat(150 * 1024);
+await writeFile(f1, big, "utf8");
+await ledger.handleChange(f1);
+hist = ledger.history.get(f1) ?? [];
+const last = hist[hist.length - 1];
+ok(typeof last.after === "string" && last.after.length <= 100 * 1024 + 40 && last.after.includes("[history 截断]"), "history content trimmed");
+ok(ledger.ring[ledger.ring.length - 1].after.length === big.length, "SSE ring keeps FULL content");
+
+console.log("== revert ==");
+const f2 = join(ROOT, "beta.js");
+await writeFile(f2, "v1\n", "utf8");
+await ledger.captureRevertPoint(f2, "s1");
+await writeFile(f2, "v2\n", "utf8");
+ledger.claim(f2, "s1");
+await ledger.handleChange(f2);
+// capture again same session -> must NOT overwrite
+await ledger.captureRevertPoint(f2, "s1");
+ok(ledger.revertPoints.get(f2).content === "v1\n", "revert point keeps pre-write content");
+// new session -> overwrite with current
+await ledger.captureRevertPoint(f2, "s2");
+ok(ledger.revertPoints.get(f2).content === "v2\n", "new session re-baselines revert point");
+await ledger.captureRevertPoint(f2, "s1");
+ok(ledger.revertPoints.get(f2).content === "v2\n", "old session does not clobber");
+
+const routes = makeRoutes(ledger, ROOT, ROOT);
+const rev = route(routes, "/revert");
+ok(rev !== void 0, "/revert route exists");
+let res = mockRes();
+await rev.handler(mockReq("POST", "/revert", { path: f2 }), res);
+const r1 = JSON.parse(res.body);
+ok(res.status === 200 && r1.ok && r1.reverted, "revert succeeds");
+ok((await readFile(f2, "utf8")) === "v2\n", "file restored to revert point (v2)");
+
+// conflict detection: external edit not seen by ledger
+await writeFile(f2, "EXTERNAL\n", "utf8"); // bypass handleChange on purpose
+res = mockRes();
+await rev.handler(mockReq("POST", "/revert", { path: f2 }), res);
+const r2 = JSON.parse(res.body);
+ok(res.status === 200 && r2.conflict === true, "conflict flagged when file changed outside agent writes");
+
+// revert of a file that did not exist pre-agent
+const f3 = join(ROOT, "newfile.ts");
+await ledger.captureRevertPoint(f3, "s1"); // ENOENT -> existed=false
+await writeFile(f3, "created by agent\n", "utf8");
+ledger.claim(f3, "s1");
+await ledger.handleChange(f3);
+res = mockRes();
+await rev.handler(mockReq("POST", "/revert", { path: f3 }), res);
+const r3 = JSON.parse(res.body);
+ok(res.status === 200 && r3.ok, "revert of created file ok");
+ok((await stat(f3).catch(() => null)) === null, "created file removed on revert");
+ok((await ledger.history.get(f3) ?? []).some((e) => e.source === "revert"), "revert recorded in history");
+
+// no-revert-point 404
+res = mockRes();
+await rev.handler(mockReq("POST", "/revert", { path: join(ROOT, "never.txt") }), res);
+ok(res.status === 404, "no-revert-point -> 404");
+
+console.log("== workspaces ==");
+ledger.noteSessionRoot(ROOT, "s1");
+ledger.noteSessionRoot(ROOT, "s2");
+const ws = route(routes, "/workspaces");
+res = mockRes();
+await ws.handler(mockReq("GET", "/workspaces"), res);
+const w = JSON.parse(res.body);
+ok(w.ok && w.workspaces.length === 1 && w.workspaces[0].path === ROOT && w.workspaces[0].sessionCount === 2, "workspaces lists root with session count");
+
+console.log("== guard ==");
+res = mockRes();
+const evil = mockReq("POST", "/revert", { path: f2 }); evil.socket.remoteAddress = "8.8.8.8"; await rev.handler(evil, res);
+ok(res.status === 403, "non-loopback rejected");
+
+await rm(ROOT, { recursive: true, force: true });
+console.log("\n" + passed + " passed, " + failed + " failed");
+process.exit(failed === 0 ? 0 : 1);

package/scripts/smoke-client.mjs

@@ -0,0 +1,18 @@
+// smoke-client.mjs - loads lib/client.js under a mocked browser env
+import { readFile } from "node:fs/promises";
+const code = await readFile(new URL("../lib/client.js", import.meta.url), "utf8");
+let loaded = null;
+globalThis.window = {
+  __ModuleLoader__: { load(spec) { loaded = spec; } }
+};
+const react = { createElement: (t, p, ...c) => ({ t, p, c }) };
+(0, eval)(code); // executes window.__ModuleLoader__.load({...})
+if (loaded === null) throw new Error("module loader was not invoked");
+const factory = loaded.factory;
+const mod = factory((name) => {
+  if (name === "react") return react;
+  throw new Error("unexpected require: " + name);
+});
+if (typeof mod.apply !== "function") throw new Error("apply missing");
+if (!Array.isArray(mod.inject)) throw new Error("inject missing");
+console.log("smoke OK: apply=" + typeof mod.apply + " inject=" + JSON.stringify(mod.inject));