dsh-db-studio 1.0.2 → 1.0.3

package/CHANGELOG.md

@@ -1,8 +1,11 @@
 # Changelog
 
-## v1.0.2 — 2026-10-25
+## v1.0.3 — 2026-10-25
 
 - 新增 `/db` 斜杠指令：输入 `/` 后可从指令列表直接打开数据库面板，带数据库图标
+- 修复对话内数据库 tab 中数据表列表与数据页滚动未分离的问题；现在左侧表列表和右侧数据各自独立滚动
+- 新增对话数据库面板「查询历史」tab：按用户对话轮次分组、支持折叠，记录 SQL、连接、耗时、行数和成功状态，支持一键复现到 SQL 编辑器
+- 左侧全局面板新增「查询历史」tab：按对话分组展示历史，点击分组或记录可进入对应对话
 
 ## v1.0.1 — 2026-10-24
 

package/README.en.md

@@ -24,6 +24,7 @@ Connect to databases in [DeepSeek Harness](https://github.com/deepseek-ai/deepse
 - **Multi-select picker in the composer**: choose the databases this conversation may use.
 - **Talk to the data**: four agent tools for querying, creating tables and writing data.
 - **`/db` command**: type `/`, pick **Database** from the command list, and open the database panel.
+- **Query history**: a **Query history** tab in the conversation database panel groups SQL by user turn, supports collapsing, and records SQL, connection, timing and affected rows; click an entry to load it back into the SQL editor. The global database panel groups the same history by conversation, and clicking a group opens that conversation.
 
 ## Install
 
@@ -32,7 +33,7 @@ From npm:
 ```bash
 # macOS desktop
 DSH_CLI="/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh"
-"$DSH_CLI" plugin --profile desktop add dsh-db-studio@1.0.2
+"$DSH_CLI" plugin --profile desktop add dsh-db-studio@1.0.3
 ```
 
 Or install directly from GitHub:

package/README.md

@@ -22,6 +22,7 @@
 - **输入框旁多选下拉**：选择本次对话要使用的数据库，支持多选。
 - **对话中直接操作**：内置 4 个助手工具，可以帮你查询、建表、写数据。
 - **`/db` 指令**：输入 `/`，在指令列表里选择「数据库」，直接打开数据库面板。
+- **查询历史**：对话数据库面板新增「查询历史」tab，按用户对话轮次分组、支持折叠，记录 SQL、连接、耗时和影响行数，点击即可复现；左侧全局面板的查询历史按对话分组，点击可进入对应对话。
 
 ## 安装
 
@@ -30,7 +31,7 @@
 ```bash
 # macOS 桌面端
 DSH_CLI="/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh"
-"$DSH_CLI" plugin --profile desktop add dsh-db-studio@1.0.2
+"$DSH_CLI" plugin --profile desktop add dsh-db-studio@1.0.3
 ```
 
 也可以直接从 GitHub 安装：

package/lib/client.js

@@ -26,6 +26,24 @@ window.__ModuleLoader__.load({
       schema: "结构",
       data: "数据",
       sql: "SQL",
+      history: "查询历史",
+      historyEmpty: "还没有查询记录。在 SQL 页运行查询后会出现在这里。",
+      historyClear: "清空历史",
+      historyReproduce: "复现",
+      historyReproduceHint: "载入到 SQL 页，不会自动执行",
+      historySuccess: "成功",
+      historyFailed: "失败",
+      historyRows: "{n} 行",
+      historyChanges: "影响 {n} 行",
+      historyAgent: "助手",
+      historyConsole: "控制台",
+      historyUnavailable: "连接 {name} 已不在当前会话的选择范围内",
+      historyOpen: "进入对话",
+      historyOpenFailed: "无法打开对话",
+      historyOpenFailedDetail: "打开对话失败：{error}",
+      historyTurn: "第 {n} 轮",
+      historyManual: "手动查询",
+      historyTurnNoPrompt: "未命名输入",
       run: "运行",
       running: "运行中…",
       searchTable: "搜索表…",
@@ -145,6 +163,24 @@ window.__ModuleLoader__.load({
       schema: "Schema",
       data: "Data",
       sql: "SQL",
+      history: "Query history",
+      historyEmpty: "No queries yet. Run one from the SQL tab and it will show up here.",
+      historyClear: "Clear history",
+      historyReproduce: "Reproduce",
+      historyReproduceHint: "Load into the SQL tab without running it",
+      historySuccess: "OK",
+      historyFailed: "Failed",
+      historyRows: "{n} rows",
+      historyChanges: "{n} rows affected",
+      historyAgent: "Assistant",
+      historyConsole: "Console",
+      historyUnavailable: "Connection {name} is no longer selected for this conversation",
+      historyOpen: "Open conversation",
+      historyOpenFailed: "Could not open the conversation",
+      historyOpenFailedDetail: "Could not open the conversation: {error}",
+      historyTurn: "Turn {n}",
+      historyManual: "Manual queries",
+      historyTurnNoPrompt: "Untitled input",
       run: "Run",
       running: "Running…",
       searchTable: "Search tables…",
@@ -518,6 +554,7 @@ window.__ModuleLoader__.load({
     function CloseIcon(props) { return h(Svg, props, h("path", { d: "M6 6l12 12M18 6 6 18" })); }
     function CheckIcon(props) { return h(Svg, props, h("path", { d: "M5 12.5 10 17.5 19 7" })); }
     function SearchIcon(props) { return h(Svg, props, h("circle", { cx: 11, cy: 11, r: 6.5 }), h("path", { d: "m16 16 4 4" })); }
+    function HistoryIcon(props) { return h(Svg, props, h("circle", { cx: 12, cy: 12, r: 8 }), h("path", { d: "M12 7.5V12l3 2" })); }
     function SparkIcon(props) { return h(Svg, props, h("path", { d: "M12 3.5 13.8 9l5.5 1.8-5.5 1.8L12 18l-1.8-5.4L4.7 10.8 10.2 9 12 3.5Z" })); }
     function ChevronDownIcon(props) { return h(Svg, props, h("path", { d: "m6 9.5 6 6 6-6" })); }
     function CopyIcon(props) { return h(Svg, props, h("rect", { x: 8.5, y: 8.5, width: 11, height: 11, rx: 2 }), h("path", { d: "M15.5 5.5h-9a2 2 0 0 0-2 2v9" })); }
@@ -714,7 +751,12 @@ window.__ModuleLoader__.load({
 .dshdb-statuspop-name{font-size:12px;font-weight:550;color:var(--dsw-alias-label-primary);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
 .dshdb-statuspop-detail{font-size:10.5px;color:var(--dsw-alias-label-tertiary);line-height:1.4;word-break:break-word}
 .dshdb-statuspop-row:has(.dshdb-dot.bad) .dshdb-statuspop-detail{color:var(--dsw-alias-state-error-primary)}
-.dshdb-cv{height:100%;min-height:420px;display:flex;flex-direction:column;padding:14px 22px 16px;box-sizing:border-box;overflow:hidden;color:var(--dsw-alias-label-primary);font-family:var(--dsw-font-family);background:var(--dsw-alias-bg-base)}
+.dshdb-cv{height:100%;min-height:0;display:flex;flex-direction:column;padding:14px 22px 16px;box-sizing:border-box;overflow:hidden;color:var(--dsw-alias-label-primary);font-family:var(--dsw-font-family);background:var(--dsw-alias-bg-base)}
+/* The conversation shell gives a view an auto-height flex row; without bounding
+   that ancestor the workbench grows with the table list and drags the data pane
+   with it. Bounding it keeps the table list and the data grid on separate
+   scroll ports, exactly like the global panel. */
+*:has(> * > .dshdb-cv){flex:1 1 0!important;min-height:0!important;overflow:hidden!important}
 .dshdb-cv *{box-sizing:border-box}
 .dshdb-cvhead{display:flex;align-items:center;justify-content:space-between;gap:14px;flex-wrap:wrap;flex:0 0 auto}
 .dshdb-cvtitlewrap{display:flex;align-items:center;gap:10px;min-width:0}
@@ -735,6 +777,38 @@ window.__ModuleLoader__.load({
 .dshdb-cv .dshdb-pager{padding:7px 12px}
 .dshdb-cv .dshdb-sqlpane{padding:12px 14px;gap:10px;height:100%}
 .dshdb-cv .dshdb-tabs{margin-top:3px;flex:0 0 auto}
+.dshdb-historypage{flex:1 1 auto;min-height:0;display:flex;flex-direction:column;padding:14px 18px;gap:8px;overflow:hidden}
+.dshdb-historypagehead{flex:0 0 auto;display:flex;align-items:center;justify-content:space-between;gap:10px;padding:0 2px 8px;border-bottom:1px solid var(--dsw-alias-border-l2)}
+.dshdb-historygroups{flex:1 1 auto;min-height:0;overflow-y:auto;display:flex;flex-direction:column;gap:8px;padding:4px 2px 6px}
+.dshdb-historygroup{border:1px solid var(--dsw-alias-border-l2);border-radius:9px;overflow:hidden;background:var(--dsw-alias-bg-base)}
+.dshdb-historygrouphead{appearance:none;border:0;border-bottom:1px solid var(--dsw-alias-border-l2);background:color-mix(in srgb,var(--dsw-alias-bg-layer-2) 38%,var(--dsw-alias-bg-base));color:var(--dsw-alias-label-primary);font:inherit;width:100%;text-align:left;display:flex;align-items:center;gap:9px;padding:9px 11px;cursor:pointer}
+.dshdb-historygrouphead:hover{background:var(--dsw-alias-interactive-bg-hover)}
+.dshdb-historygroupmain{min-width:0;flex:1 1 auto;display:flex;flex-direction:column;gap:2px}
+.dshdb-historygrouptitle{font-size:12px;font-weight:600;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.dshdb-historygroupcwd{font-size:10px;color:var(--dsw-alias-label-tertiary);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.dshdb-historygroupcount{font-size:9.5px;font-weight:600;color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-interactive-bg-hover);border-radius:999px;padding:1px 6px;flex:0 0 auto}
+.dshdb-historyopen{display:inline-flex;align-items:center;gap:3px;font-size:10.5px;color:var(--dsw-alias-brand-primary);flex:0 0 auto}
+.dshdb-historygrouprows{display:flex;flex-direction:column;gap:4px;padding:6px}
+.dshdb-historypane{flex:1 1 auto;min-height:0;display:flex;flex-direction:column;padding:12px 14px;gap:8px;overflow:hidden}
+.dshdb-historybar{flex:0 0 auto;display:flex;align-items:center;justify-content:space-between;gap:10px;padding:2px 2px 8px;border-bottom:1px solid var(--dsw-alias-border-l2)}
+.dshdb-historytitle{display:flex;align-items:center;gap:7px;font-size:13px;font-weight:600}
+.dshdb-historyturn{border:1px solid var(--dsw-alias-border-l2);border-radius:8px;overflow:hidden;background:var(--dsw-alias-bg-base)}
+.dshdb-historyturnhead{appearance:none;border:0;background:transparent;color:var(--dsw-alias-label-primary);font:inherit;width:100%;text-align:left;display:flex;align-items:center;gap:7px;padding:7px 9px;cursor:pointer}
+.dshdb-historyturnhead:hover{background:var(--dsw-alias-interactive-bg-hover)}
+.dshdb-historyturnlabel{font-size:11px;font-weight:600;flex:0 0 auto;white-space:nowrap}
+.dshdb-historyturnprompt{font-size:11px;color:var(--dsw-alias-label-tertiary);min-width:0;flex:1 1 auto;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.dshdb-historyturncount{font-size:9.5px;color:var(--dsw-alias-label-tertiary);background:var(--dsw-alias-interactive-bg-hover);border-radius:999px;padding:1px 6px;flex:0 0 auto}
+.dshdb-historyturnrows{display:flex;flex-direction:column;gap:4px;padding:6px;border-top:1px solid var(--dsw-alias-border-l2)}
+.dshdb-historylist{flex:1 1 auto;min-height:0;overflow-y:auto;display:flex;flex-direction:column;gap:6px;padding:8px 2px}
+.dshdb-historyrow{display:flex;align-items:flex-start;gap:8px;width:100%;text-align:left;appearance:none;border:1px solid var(--dsw-alias-border-l2);background:transparent;border-radius:8px;padding:8px 9px;cursor:pointer;font:inherit;color:var(--dsw-alias-label-primary)}
+.dshdb-historyrow:hover{background:var(--dsw-alias-interactive-bg-hover)}
+.dshdb-historyrow.bad{border-color:color-mix(in srgb,var(--dsw-alias-state-error-primary) 28%,var(--dsw-alias-border-l2))}
+.dshdb-historystatus{display:flex;color:var(--dsw-alias-state-success-primary);flex:0 0 auto;margin-top:2px}
+.dshdb-historyrow.bad .dshdb-historystatus{color:var(--dsw-alias-state-error-primary)}
+.dshdb-historymain{min-width:0;flex:1 1 auto;display:flex;flex-direction:column;gap:3px}
+.dshdb-historysql{font-family:var(--ds-font-family-code);font-size:11.5px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;color:var(--dsw-alias-label-secondary)}
+.dshdb-historymeta{display:flex;gap:7px;flex-wrap:wrap;font-size:10px;color:var(--dsw-alias-label-tertiary);line-height:1.4}
+.dshdb-historyaction{display:inline-flex;align-items:center;gap:4px;flex:0 0 auto;font-size:10.5px;color:var(--dsw-alias-brand-primary);padding:2px 3px;white-space:nowrap}
 .dshdb-cvempty{flex:1;display:flex;align-items:center;justify-content:center;padding:26px;min-height:300px}
 .dshdb-cvloading{flex:1;display:flex;align-items:center;justify-content:center;min-height:300px}
 .dshdb-cvmessage{padding:6px 0;flex:0 0 auto}
@@ -1079,6 +1153,10 @@ window.__ModuleLoader__.load({
       var [sqlError, setSqlError] = React.useState(null);
       var [sqlLoading, setSqlLoading] = React.useState(false);
       var [sqlHistory, setSqlHistory] = React.useState([]);
+      var [historyGroups, setHistoryGroups] = React.useState([]);
+      var [historyLoading, setHistoryLoading] = React.useState(false);
+      var [historyError, setHistoryError] = React.useState(null);
+      var [sessionTitles, setSessionTitles] = React.useState({});
       var [dialog, setDialog] = React.useState(null);
       var [pendingDelete, setPendingDelete] = React.useState(null);
       var [busy, setBusy] = React.useState(false);
@@ -1101,6 +1179,52 @@ window.__ModuleLoader__.load({
         return function () { alive = false; };
       }, []);
 
+      React.useEffect(function () {
+        var sessions = APP_CTX && APP_CTX.get ? APP_CTX.get("sessions") : null;
+        if (!sessions || !sessions.list) return;
+        function update() {
+          var snapshot = sessions.list.getSnapshot();
+          setSessionTitles(snapshot && snapshot.byId ? snapshot.byId : {});
+        }
+        update();
+        var off = sessions.list.subscribe ? sessions.list.subscribe(update) : null;
+        return function () { if (typeof off === "function") off(); };
+      }, []);
+
+      React.useEffect(function () {
+        if (tab === "history") loadAllHistory();
+      }, [tab]);
+
+      function loadAllHistory() {
+        setHistoryLoading(true);
+        setHistoryError(null);
+        api({ action: "history-all" }).then(function (data) {
+          setHistoryGroups(Array.isArray(data.sessions) ? data.sessions : []);
+        }).catch(function (failure) {
+          setHistoryError(interpolate(t("loadFailed"), { error: failure.message }));
+        }).finally(function () { setHistoryLoading(false); });
+      }
+
+      function sessionLabel(sessionId) {
+        var row = sessionTitles[sessionId];
+        var title = row && (row.title || row.displayTitle);
+        if (title && String(title).trim()) return String(title).trim();
+        return String(sessionId || "").slice(0, 8);
+      }
+
+      function openConversation(sessionId) {
+        var workspace = APP_CTX && APP_CTX.get ? APP_CTX.get("uiWorkspace") : null;
+        if (!workspace || typeof workspace.openSession !== "function") {
+          setHistoryError(t("historyOpenFailed"));
+          return;
+        }
+        try {
+          workspace.openSession(sessionId);
+        } catch (failure) {
+          setHistoryError(interpolate(t("historyOpenFailedDetail"), { error: failure.message }));
+        }
+      }
+
       React.useEffect(function () {
         if (!activeId) { setTables([]); setSelectedTable(null); setSchema(null); setResult(null); return; }
         var alive = true;
@@ -1445,6 +1569,62 @@ window.__ModuleLoader__.load({
           ) : h("div", { className: "dshdb-result" }, h("div", { className: "dshdb-placeholder" }, t("result")))
         );
 
+        var historyPane = h("div", { className: "dshdb-historypage" },
+          h("div", { className: "dshdb-historypagehead" },
+            h("div", { className: "dshdb-historytitle" },
+              h(HistoryIcon, { size: 14 }),
+              t("history"),
+              h("span", { className: "dshdb-gridmeta" },
+                historyGroups.reduce(function (sum, group) { return sum + (group.entries ? group.entries.length : 0); }, 0))
+            ),
+            h("button", { type: "button", className: "dshdb-btn small ghost", disabled: historyLoading, onClick: loadAllHistory }, h(RefreshIcon, { size: 13 }), t("refresh"))
+          ),
+          historyError ? h("div", { className: "dshdb-cvmessage" }, h("div", { className: "dshdb-error" }, historyError)) : null,
+          historyLoading
+            ? h("div", { className: "dshdb-placeholder" }, h(Spinner))
+            : historyGroups.length === 0
+              ? h("div", { className: "dshdb-placeholder" }, t("historyEmpty"))
+              : h("div", { className: "dshdb-historygroups" }, historyGroups.map(function (group) {
+                  var rows = Array.isArray(group.entries) ? group.entries : [];
+                  var folder = group.cwd ? String(group.cwd).split(/[\\/]/).filter(Boolean).pop() : "";
+                  return h("div", { key: group.sessionId, className: "dshdb-historygroup" },
+                    h("button", { type: "button", className: "dshdb-historygrouphead", onClick: function () { openConversation(group.sessionId); } },
+                      h("span", { className: "dshdb-historygroupmain" },
+                        h("span", { className: "dshdb-historygrouptitle" }, sessionLabel(group.sessionId)),
+                        folder ? h("span", { className: "dshdb-historygroupcwd" }, folder) : null
+                      ),
+                      h("span", { className: "dshdb-historygroupcount" }, rows.length),
+                      h("span", { className: "dshdb-historyopen" }, t("historyOpen"), h(ChevronRightIcon, { size: 11 }))
+                    ),
+                    h("div", { className: "dshdb-historygrouprows" }, rows.map(function (row) {
+                      var ok = row.ok !== false;
+                      var source = row.source === "agent" ? t("historyAgent") : t("historyConsole");
+                      var count = row.changes != null
+                        ? interpolate(t("historyChanges"), { n: fmtNumber(row.changes) })
+                        : interpolate(t("historyRows"), { n: fmtNumber(row.rows || 0) });
+                      return h("button", {
+                        key: row.id,
+                        type: "button",
+                        className: "dshdb-historyrow" + (ok ? "" : " bad"),
+                        title: (ok ? "" : (row.error || t("historyFailed")) + " · ") + t("historyOpen"),
+                        onClick: function () { openConversation(group.sessionId); }
+                      },
+                        h("span", { className: "dshdb-historystatus" }, h(ok ? CheckIcon : CloseIcon, { size: 13 })),
+                        h("span", { className: "dshdb-historymain" },
+                          h("span", { className: "dshdb-historysql" }, row.sql),
+                          h("span", { className: "dshdb-historymeta" },
+                            h("span", null, row.connectionName || row.connectionId),
+                            h("span", null, source),
+                            h("span", null, new Date(row.at).toLocaleString()),
+                            h("span", null, count)
+                          )
+                        )
+                      );
+                    }))
+                  );
+                }))
+        );
+
         main = h("section", { className: "dshdb-main" },
           h("div", { className: "dshdb-mainhead" },
             h("div", { className: "dshdb-mainheadtop" },
@@ -1472,11 +1652,12 @@ window.__ModuleLoader__.load({
             ),
             h("div", { className: "dshdb-tabs", role: "tablist", "aria-label": t("tabsAria") },
               h("button", { type: "button", role: "tab", "aria-selected": tab === "data", className: "dshdb-tab" + (tab === "data" ? " active" : ""), onClick: function () { setTab("data"); } }, h(TableIcon, { size: 14 }), t("data")),
-              h("button", { type: "button", role: "tab", "aria-selected": tab === "sql", className: "dshdb-tab" + (tab === "sql" ? " active" : ""), onClick: function () { setTab("sql"); } }, h(PlayIcon, { size: 13 }), t("sql"))
+              h("button", { type: "button", role: "tab", "aria-selected": tab === "sql", className: "dshdb-tab" + (tab === "sql" ? " active" : ""), onClick: function () { setTab("sql"); } }, h(PlayIcon, { size: 13 }), t("sql")),
+              h("button", { type: "button", role: "tab", "aria-selected": tab === "history", className: "dshdb-tab" + (tab === "history" ? " active" : ""), onClick: function () { setTab("history"); } }, h(HistoryIcon, { size: 14 }), t("history"))
             )
           ),
-          tab === "data" ? dataPane : sqlPane,
-          h("div", { className: "dshdb-chatbar" },
+          tab === "data" ? dataPane : tab === "sql" ? sqlPane : historyPane,
+          tab === "history" ? null : h("div", { className: "dshdb-chatbar" },
             h(SparkIcon, { size: 14 }),
             h("div", null, h("b", null, t("inChat") + " · "), t("inChatHint"))
           )
@@ -1844,6 +2025,47 @@ window.__ModuleLoader__.load({
     }
 
     // ── conversation tab: the selected databases ────────────────────────
+    function messageContentText(content) {
+      if (typeof content === "string") return content;
+      if (!Array.isArray(content)) return "";
+      return content.map(function (block) {
+        return block && block.type === "text" && typeof block.text === "string" ? block.text : "";
+      }).join(" ").replace(/\s+/g, " ").trim();
+    }
+
+    /** Group recorded SQL by the loaded conversation turn whose time window contains it. */
+    function sqlHistoryTurns(history, turns, nodes, t) {
+      var loaded = (Array.isArray(turns) ? turns : []).map(function (item) {
+        var node = nodes && typeof nodes.get === "function" ? nodes.get(item.anchorKey) : null;
+        return {
+          id: "turn-" + item.turn,
+          turn: Number(item.turn) || 0,
+          time: Number(node && node.data ? node.data.time : 0) || 0,
+          prompt: item.prompt || "",
+          entries: [],
+        };
+      });
+      if (loaded.length === 0) return [{ id: "manual", index: 0, label: t("historyManual"), prompt: "", entries: history }];
+      var groups = loaded.map(function (turn) {
+        return { id: turn.id, index: 0, label: interpolate(t("historyTurn"), { n: turn.turn }), prompt: turn.prompt, time: turn.time, entries: [] };
+      });
+      var orphans = [];
+      history.forEach(function (row) {
+        var at = Number(row.at) || 0;
+        var index = -1;
+        for (var cursor = 0; cursor < loaded.length; cursor += 1) {
+          if (loaded[cursor].time <= at) index = cursor;
+          else break;
+        }
+        if (index < 0) orphans.push(row);
+        else groups[index].entries.push(row);
+      });
+      var result = groups.filter(function (group) { return group.entries.length > 0; }).reverse();
+      if (orphans.length) result.push({ id: "orphans", index: result.length, label: t("historyManual"), prompt: "", entries: orphans });
+      result.forEach(function (group, index) { group.index = index; });
+      return result;
+    }
+
     function ConversationDbView(props) {
       var t = props.t || function (key) { return key; };
       var sessionId = props.sessionId;
@@ -1870,6 +2092,15 @@ window.__ModuleLoader__.load({
       var [sqlResult, setSqlResult] = React.useState(null);
       var [sqlError, setSqlError] = React.useState(null);
       var [sqlLoading, setSqlLoading] = React.useState(false);
+      var [history, setHistory] = React.useState([]);
+      var [historyLoading, setHistoryLoading] = React.useState(false);
+      var [historyError, setHistoryError] = React.useState(null);
+      var [collapsedTurns, setCollapsedTurns] = React.useState({});
+      var fallbackUseChat = function () { return undefined; };
+      var useChat = typeof props.useChat === "function" ? props.useChat : fallbackUseChat;
+      var chatTurns = useChat(function (snapshot) { return snapshot.navigation ? snapshot.navigation.items() : undefined; });
+      var chatNodes = useChat(function (snapshot) { return snapshot.nodes; });
+      var turnGroups = sqlHistoryTurns(history, chatTurns, chatNodes, t);
       var [dialog, setDialog] = React.useState(null);
       var [busy, setBusy] = React.useState(false);
       var [error, setError] = React.useState(null);
@@ -1910,6 +2141,44 @@ window.__ModuleLoader__.load({
         return function () { alive = false; };
       }, [activeId, sessionId]);
 
+      React.useEffect(function () {
+        if (tab === "history") loadHistory();
+      }, [tab, sessionId]);
+
+      function loadHistory() {
+        if (!sessionId) return;
+        setHistoryLoading(true);
+        setHistoryError(null);
+        api({ action: "history-list", sessionId: sessionId }).then(function (data) {
+          setHistory(Array.isArray(data.entries) ? data.entries : []);
+        }).catch(function (failure) {
+          setHistoryError(interpolate(t("loadFailed"), { error: failure.message }));
+        }).finally(function () { setHistoryLoading(false); });
+      }
+
+      function clearHistory() {
+        if (!sessionId) return;
+        api({ action: "history-clear", sessionId: sessionId }).then(function () {
+          setHistory([]);
+        }).catch(function (failure) {
+          setHistoryError(interpolate(t("saveFailed"), { error: failure.message }));
+        });
+      }
+
+      function reproduceHistory(row) {
+        var connection = selected.find(function (item) { return item.id === row.connectionId; });
+        if (!connection) {
+          setError(interpolate(t("historyUnavailable"), { name: row.connectionName || row.connectionId }));
+          return;
+        }
+        setError(null);
+        setActiveId(row.connectionId);
+        setSql(row.sql || "");
+        setSqlResult(null);
+        setSqlError(null);
+        setTab("sql");
+      }
+
       function selectTable(connectionId, name, nextPage, internal) {
         setSelectedTable(name);
         setPage(nextPage || 0);
@@ -1972,7 +2241,10 @@ window.__ModuleLoader__.load({
           setSqlResult({ readOnly: readOnly, data: data });
         }).catch(function (failure) {
           setSqlError(interpolate(t("queryFailed"), { error: failure.message }));
-        }).finally(function () { setSqlLoading(false); });
+        }).finally(function () {
+          setSqlLoading(false);
+          loadHistory();
+        });
       }
 
       async function openDemo() {
@@ -2180,6 +2452,75 @@ window.__ModuleLoader__.load({
         ) : h("div", { className: "dshdb-result" }, h("div", { className: "dshdb-placeholder" }, t("result")))
       );
 
+      var historyPane = h("div", { className: "dshdb-historypane" },
+        h("div", { className: "dshdb-historybar" },
+          h("div", { className: "dshdb-historytitle" },
+            h(HistoryIcon, { size: 14 }),
+            t("history"),
+            h("span", { className: "dshdb-gridmeta" }, history.length)
+          ),
+          h("button", {
+            type: "button",
+            className: "dshdb-btn small ghost",
+            disabled: historyLoading || history.length === 0,
+            onClick: clearHistory
+          }, h(TrashIcon, { size: 13 }), t("historyClear"))
+        ),
+        historyError ? h("div", { className: "dshdb-cvmessage" }, h("div", { className: "dshdb-error" }, historyError)) : null,
+        historyLoading
+          ? h("div", { className: "dshdb-placeholder" }, h(Spinner))
+          : history.length === 0
+            ? h("div", { className: "dshdb-placeholder" }, t("historyEmpty"))
+            : h("div", { className: "dshdb-historylist" }, turnGroups.map(function (group) {
+                var collapsed = collapsedTurns[group.id] !== undefined ? collapsedTurns[group.id] : group.index > 0;
+                return h("div", { key: group.id, className: "dshdb-historyturn" },
+                  h("button", {
+                    type: "button",
+                    className: "dshdb-historyturnhead",
+                    "aria-expanded": !collapsed,
+                    onClick: function () {
+                      setCollapsedTurns(function (previous) {
+                        var next = Object.assign({}, previous);
+                        next[group.id] = !collapsed;
+                        return next;
+                      });
+                    }
+                  },
+                    h(ChevronDownIcon, { size: 13, style: { transform: collapsed ? "rotate(-90deg)" : "none", transition: "transform .12s ease" } }),
+                    h("span", { className: "dshdb-historyturnlabel" }, group.label),
+                    group.prompt ? h("span", { className: "dshdb-historyturnprompt", title: group.prompt }, group.prompt) : null,
+                    h("span", { className: "dshdb-historyturncount" }, group.entries.length)
+                  ),
+                  collapsed ? null : h("div", { className: "dshdb-historyturnrows" }, group.entries.map(function (row) {
+                    var ok = row.ok !== false;
+                    var source = row.source === "agent" ? t("historyAgent") : t("historyConsole");
+                    var count = row.changes != null
+                      ? interpolate(t("historyChanges"), { n: fmtNumber(row.changes) })
+                      : interpolate(t("historyRows"), { n: fmtNumber(row.rows || 0) });
+                    return h("button", {
+                      key: row.id,
+                      type: "button",
+                      className: "dshdb-historyrow" + (ok ? "" : " bad"),
+                      title: ok ? t("historyReproduceHint") : (row.error || t("historyFailed")),
+                      onClick: function () { reproduceHistory(row); }
+                    },
+                      h("span", { className: "dshdb-historystatus" }, h(ok ? CheckIcon : CloseIcon, { size: 13 })),
+                      h("span", { className: "dshdb-historymain" },
+                        h("span", { className: "dshdb-historysql" }, row.sql),
+                        h("span", { className: "dshdb-historymeta" },
+                          h("span", null, row.connectionName || row.connectionId),
+                          h("span", null, source),
+                          h("span", null, new Date(row.at).toLocaleString()),
+                          h("span", null, count)
+                        )
+                      ),
+                      h("span", { className: "dshdb-historyaction" }, h(PlayIcon, { size: 11 }), t("historyReproduce"))
+                    );
+                  }))
+                );
+              }))
+      );
+
       return h("div", { className: "dshdb-cv" },
         h("div", { className: "dshdb-cvhead" },
           h("div", { className: "dshdb-cvtitlewrap" },
@@ -2212,10 +2553,11 @@ window.__ModuleLoader__.load({
         ),
         h("div", { className: "dshdb-tabs", role: "tablist", "aria-label": t("tabsAria") },
           h("button", { type: "button", role: "tab", "aria-selected": tab === "data", className: "dshdb-tab" + (tab === "data" ? " active" : ""), onClick: function () { setTab("data"); } }, h(TableIcon, { size: 14 }), t("data")),
-          h("button", { type: "button", role: "tab", "aria-selected": tab === "sql", className: "dshdb-tab" + (tab === "sql" ? " active" : ""), onClick: function () { setTab("sql"); } }, h(PlayIcon, { size: 13 }), t("sql"))
+          h("button", { type: "button", role: "tab", "aria-selected": tab === "sql", className: "dshdb-tab" + (tab === "sql" ? " active" : ""), onClick: function () { setTab("sql"); } }, h(PlayIcon, { size: 13 }), t("sql")),
+          h("button", { type: "button", role: "tab", "aria-selected": tab === "history", className: "dshdb-tab" + (tab === "history" ? " active" : ""), onClick: function () { setTab("history"); } }, h(HistoryIcon, { size: 14 }), t("history"))
         ),
         error ? h("div", { className: "dshdb-cvmessage" }, h("div", { className: "dshdb-error" }, error)) : null,
-        h("div", { className: "dshdb-cvbody" }, tab === "data" ? dataPane : sqlPane),
+        h("div", { className: "dshdb-cvbody" }, tab === "data" ? dataPane : tab === "sql" ? sqlPane : historyPane),
         dialogNode
       );
     }

package/lib/index.js

@@ -284,7 +284,7 @@ function buildToolDefinitions(studio) {
       async execute(args, exec) {
         const session = sessionOf(exec)
         const id = await resolveConnectionId(studio, args?.connectionId, session)
-        const result = await studio.query(id, args?.sql, { limit: args?.limit, ...(session ? { sessionId: session.id, cwd: session.cwd } : {}) })
+        const result = await studio.query(id, args?.sql, { limit: args?.limit, source: 'agent', ...(session ? { sessionId: session.id, cwd: session.cwd } : {}) })
         const rows = result.rows ?? []
         const summaryParts = [`查询成功，返回 ${rows.length} 行${result.truncated ? '（已截断）' : ''}，耗时 ${result.elapsedMs} ms。`]
         const table = markdownTable(result.columns, rows, 25)
@@ -328,7 +328,7 @@ function buildToolDefinitions(studio) {
         if (args?.confirm !== true) throw new Error('写操作需要显式确认：请先在对话中得到用户同意，再以 confirm: true 重试。')
         const session = sessionOf(exec)
         const id = await resolveConnectionId(studio, args?.connectionId, session)
-        const result = await studio.execute(id, args?.sql, session ? { sessionId: session.id, cwd: session.cwd } : {})
+        const result = await studio.execute(id, args?.sql, { source: 'agent', ...(session ? { sessionId: session.id, cwd: session.cwd } : {}) })
         const affected = result.changes ?? 0
         return {
           summary: `执行成功：影响 ${affected} 行${result.lastInsertRowid != null ? `，最后插入 id = ${result.lastInsertRowid}` : ''}，耗时 ${result.elapsedMs ?? 0} ms。`,
@@ -365,9 +365,15 @@ async function dispatch(studio, body, options = {}) {
     case 'rows':
       return { ok: true, ...(await studio.rows(body.id, body.table, { limit: body.limit, offset: body.offset, ...scoped })) }
     case 'query':
-      return { ok: true, ...(await studio.query(body.id, body.sql, { limit: body.limit, ...scoped })) }
+      return { ok: true, ...(await studio.query(body.id, body.sql, { limit: body.limit, source: 'ui', ...scoped })) }
     case 'execute':
-      return { ok: true, ...(await studio.execute(body.id, body.sql, scoped)) }
+      return { ok: true, ...(await studio.execute(body.id, body.sql, { source: 'ui', ...scoped })) }
+    case 'history-list':
+      return { ok: true, ...(await studio.sqlHistory(sessionId)) }
+    case 'history-all':
+      return { ok: true, ...(await studio.allSqlHistory()) }
+    case 'history-clear':
+      return { ok: true, ...(await studio.clearSqlHistory(sessionId)) }
     case 'test':
       return { ok: true, ...(await studio.testConnection(body.connection ?? body)) }
     case 'add':

package/lib/service.js

@@ -398,16 +398,73 @@ export class DatabaseStudio {
     return { connection: publicConnection(connection), table: String(table), limit, offset, ...result }
   }
 
+  /**
+   * Record one SQL run for the conversation's history. History is a convenience
+   * surface: a write failure must never turn a successful query into an error,
+   * so recording errors are logged and swallowed.
+   */
+  async #recordSqlHistory(sessionId, connection, sql, source, outcome) {
+    if (!sessionId) return
+    try {
+      await this.selections.addHistory(sessionId, {
+        sql: String(sql ?? '').slice(0, 20000),
+        connectionId: connection.id,
+        connectionName: connection.name,
+        source: source === 'agent' ? 'agent' : 'ui',
+        ...outcome,
+      })
+    } catch (error) {
+      console.warn('dsh-db-studio: failed to record SQL history —', error?.message ?? error)
+    }
+  }
+
+  /** Every conversation's SQL history, grouped by Session. */
+  async allSqlHistory() {
+    await this.ready()
+    return { sessions: await this.selections.allHistory() }
+  }
+
+  /** One Session's SQL history, newest first. */
+  async sqlHistory(sessionId) {
+    await this.ready()
+    if (!sessionId) throw new Error('缺少会话 id / missing session id')
+    return { sessionId, entries: await this.selections.history(sessionId) }
+  }
+
+  /** Clear one Session's SQL history. */
+  async clearSqlHistory(sessionId) {
+    await this.ready()
+    if (!sessionId) throw new Error('缺少会话 id / missing session id')
+    const cleared = await this.selections.clearHistory(sessionId)
+    return { sessionId, cleared }
+  }
+
   /** Run a read-only query. */
   async query(id, sql, options = {}) {
     if (options.sessionId) await this.assertSessionConnection(options.sessionId, id, options.cwd)
     const connection = await this.connection(id)
     const limit = clampLimit(options.limit, this.config.maxRows, this.config.maxRows)
     const adapter = await this.#adapter(connection)
+    const source = options.source
     const started = Date.now()
-    const result = await adapter.query(sql, { limit })
-    this.touchUsage(connection.id, options.sessionId, options.cwd)
-    return { connection: publicConnection(connection), elapsedMs: Date.now() - started, ...result }
+    try {
+      const result = await adapter.query(sql, { limit })
+      await this.#recordSqlHistory(options.sessionId, connection, sql, source, {
+        ok: true,
+        elapsedMs: Date.now() - started,
+        rows: Array.isArray(result.rows) ? result.rows.length : 0,
+        truncated: result.truncated === true,
+      })
+      this.touchUsage(connection.id, options.sessionId, options.cwd)
+      return { connection: publicConnection(connection), elapsedMs: Date.now() - started, ...result }
+    } catch (error) {
+      await this.#recordSqlHistory(options.sessionId, connection, sql, source, {
+        ok: false,
+        elapsedMs: Date.now() - started,
+        error: error?.message ?? String(error),
+      })
+      throw error
+    }
   }
 
   /** Run a write statement (or any single statement) after policy checks. */
@@ -419,10 +476,26 @@ export class DatabaseStudio {
     if (!isSingleStatement(sql)) throw new Error('只允许执行一条 SQL / only one statement is allowed')
     return this.#serialized(connection.id, async () => {
       const adapter = await this.#adapter(connection)
+      const source = options.source
       const started = Date.now()
-      const result = await adapter.execute(sql)
-      this.touchUsage(connection.id, options.sessionId, options.cwd)
-      return { connection: publicConnection(connection), elapsedMs: result.elapsedMs ?? (Date.now() - started), ...result }
+      try {
+        const result = await adapter.execute(sql)
+        await this.#recordSqlHistory(options.sessionId, connection, sql, source, {
+          ok: true,
+          elapsedMs: result.elapsedMs ?? (Date.now() - started),
+          changes: result.changes ?? 0,
+          lastInsertRowid: result.lastInsertRowid == null ? undefined : String(result.lastInsertRowid),
+        })
+        this.touchUsage(connection.id, options.sessionId, options.cwd)
+        return { connection: publicConnection(connection), elapsedMs: result.elapsedMs ?? (Date.now() - started), ...result }
+      } catch (error) {
+        await this.#recordSqlHistory(options.sessionId, connection, sql, source, {
+          ok: false,
+          elapsedMs: Date.now() - started,
+          error: error?.message ?? String(error),
+        })
+        throw error
+      }
     })
   }
 

package/lib/session-store.js

@@ -20,6 +20,7 @@
  * @module dsh-db-studio/session-store
  */
 
+import { randomUUID } from 'node:crypto'
 import { chmod, mkdir, readFile, rename, writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
 import { studioHome } from './home.js'
@@ -27,11 +28,12 @@ import { studioHome } from './home.js'
 const FILE_MODE = 0o600
 const DIR_MODE = 0o700
 const MAX_SESSIONS = 200
+const MAX_HISTORY = 100
 const SAVE_DELAY_MS = 400
 
 /** Empty state document. */
 function emptyState() {
-  return { version: 1, sessions: {}, usage: {} }
+  return { version: 2, sessions: {}, usage: {}, history: {} }
 }
 
 /** Keep only the newest N sessions. */
@@ -42,6 +44,14 @@ function pruneSessions(sessions) {
   return Object.fromEntries(rows.slice(0, MAX_SESSIONS))
 }
 
+/** Keep only the newest N history rows per Session. */
+function pruneHistory(history) {
+  const rows = Object.entries(history)
+  if (rows.length <= MAX_SESSIONS) return history
+  rows.sort((left, right) => (right[1]?.[0]?.at ?? 0) - (left[1]?.[0]?.at ?? 0))
+  return Object.fromEntries(rows.slice(0, MAX_SESSIONS))
+}
+
 /** Normalize one stored entry. */
 function normalizeEntry(entry) {
   return {
@@ -71,9 +81,10 @@ export class SessionSelectionStore {
       const parsed = JSON.parse(raw)
       if (parsed && typeof parsed === 'object') {
         this.state = {
-          version: 1,
+          version: 2,
           sessions: parsed.sessions && typeof parsed.sessions === 'object' ? parsed.sessions : {},
           usage: parsed.usage && typeof parsed.usage === 'object' ? parsed.usage : {},
+          history: parsed.history && typeof parsed.history === 'object' ? parsed.history : {},
         }
       }
     } catch (error) {
@@ -93,6 +104,7 @@ export class SessionSelectionStore {
     this.saveQueue = this.saveQueue.catch(() => {}).then(async () => {
       await mkdir(this.dir, { recursive: true, mode: DIR_MODE })
       this.state.sessions = pruneSessions(this.state.sessions)
+      this.state.history = pruneHistory(this.state.history)
       const body = JSON.stringify(this.state, null, 2) + '\n'
       const temp = `${this.file}.${process.pid}.${Date.now()}.tmp`
       await writeFile(temp, body, { mode: FILE_MODE })
@@ -207,6 +219,56 @@ export class SessionSelectionStore {
     return normalizeEntry(this.#entry(sessionId)).ids
   }
 
+  /** Append one SQL run to a Session's history (newest first, bounded). */
+  async addHistory(sessionId, entry) {
+    if (!sessionId) return null
+    await this.load()
+    const record = {
+      id: randomUUID(),
+      at: Date.now(),
+      ...entry,
+    }
+    const rows = Array.isArray(this.state.history[sessionId]) ? this.state.history[sessionId] : []
+    rows.unshift(record)
+    this.state.history[sessionId] = rows.slice(0, MAX_HISTORY)
+    await this.save()
+    return record
+  }
+
+  /** Every Session's SQL history, newest activity first. */
+  async allHistory() {
+    await this.load()
+    const groups = []
+    for (const [sessionId, entries] of Object.entries(this.state.history)) {
+      if (!Array.isArray(entries) || entries.length === 0) continue
+      const session = normalizeEntry(this.state.sessions[sessionId])
+      groups.push({
+        sessionId,
+        cwd: session.cwd ?? null,
+        sessionUpdatedAt: session.updatedAt,
+        entries,
+      })
+    }
+    groups.sort((left, right) => (right.entries[0]?.at ?? 0) - (left.entries[0]?.at ?? 0))
+    return groups
+  }
+
+  /** One Session's SQL history, newest first. */
+  async history(sessionId) {
+    await this.load()
+    const rows = this.state.history[sessionId]
+    return Array.isArray(rows) ? rows.slice() : []
+  }
+
+  /** Clear one Session's SQL history. */
+  async clearHistory(sessionId) {
+    await this.load()
+    if (!this.state.history[sessionId]) return false
+    delete this.state.history[sessionId]
+    await this.save()
+    return true
+  }
+
   /** All usage rows (tests/debug). */
   usageSnapshot() {
     return { ...this.state.usage }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-db-studio",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Connect to databases in DeepSeek Harness (DSH), then query and edit data right in the conversation.",
   "type": "module",
   "license": "MIT",