dsh-plugin-sessiongraph-panel 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CC ZHAO
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/lib/client.js

@@ -0,0 +1,326 @@
+/**
+ * dsh-plugin-sessiongraph-panel · 浏览器端入口：设置页「会话检索」tab
+ *
+ * 为什么单独一个文件：本包只有客户端半侧，宿主负责把客户端模块下发给浏览器；所以这里走
+ * CJS factory 包装，靠宿主注入的 require 取 react，不引任何 npm 包（没有构建步骤、也没有
+ * import 语句）。
+ *
+ * 这一个 tab 只做一件事：在 `sessiongraph` / `kernel` / `both` 之间切换「哪些会话检索工具
+ * 对模型可见」。数据全走同源 `/dsh-plugin-sessiongraph/api/tools`，无 token、无轮询——
+ * 值只有用户点「保存」时才会变。
+ */
+window.__ModuleLoader__.load({
+  id: "dsh-plugin-sessiongraph-panel",
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+
+    const React = require("react");
+    /** 免 JSX 写组件（产物风格同官方插件） */
+    const h = React.createElement;
+
+    /** 宿主侧路由前缀；改这里要同步改 packages/tool/src/panel.ts */
+    const API = "/dsh-plugin-sessiongraph/api";
+    const MONO = "ui-monospace, SFMono-Regular, Menlo, monospace";
+
+    /** 宿主主题变量优先，取不到就退中性色 */
+    const C = {
+      primary: "var(--dsw-alias-label-primary, #1f2328)",
+      secondary: "var(--dsw-alias-label-secondary, #6e7781)",
+      tertiary: "var(--dsw-alias-label-tertiary, #8c959f)",
+      border: "var(--dsw-alias-border-l2, rgba(0, 0, 0, 0.12))",
+      bg: "var(--dsw-alias-bg-l1, rgba(0, 0, 0, 0.03))",
+      danger: "var(--dsw-alias-state-error-primary, #d9534f)",
+      ok: "var(--dsw-alias-state-success-primary, #2e7d32)",
+    };
+
+    const BTN = {
+      font: "inherit",
+      fontSize: 12,
+      lineHeight: "20px",
+      padding: "2px 10px",
+      borderRadius: 4,
+      border: "1px solid " + C.border,
+      background: "transparent",
+      color: C.primary,
+      cursor: "pointer",
+      whiteSpace: "nowrap",
+    };
+
+    const S = {
+      root: {
+        padding: "16px 20px",
+        fontSize: "var(--dsh-content-font-size, 13px)",
+        lineHeight: 1.5,
+        color: C.primary,
+        display: "flex",
+        flexDirection: "column",
+        gap: 14,
+      },
+      block: { display: "flex", flexDirection: "column", gap: 8, minWidth: 0 },
+      headRow: { display: "flex", alignItems: "center", gap: 12, flexWrap: "wrap" },
+      h1: { margin: 0, fontSize: 14, fontWeight: 600, lineHeight: 1.5, whiteSpace: "nowrap" },
+      hint: { color: C.tertiary, fontSize: 12 },
+      row: { display: "flex", alignItems: "center", gap: 8, flexWrap: "wrap" },
+      label: { color: C.secondary, fontSize: 12, whiteSpace: "nowrap" },
+      select: {
+        boxSizing: "border-box",
+        minWidth: 220,
+        padding: "4px 8px",
+        border: "1px solid " + C.border,
+        borderRadius: 4,
+        background: C.bg,
+        color: C.primary,
+        font: "inherit",
+        fontSize: 12,
+        lineHeight: "20px",
+        outline: "none",
+      },
+      btn: BTN,
+      btnOff: { ...BTN, color: C.tertiary, cursor: "default" },
+      okText: { color: C.ok, fontSize: 12, whiteSpace: "pre-wrap" },
+      danger: { color: C.danger, fontSize: 12, whiteSpace: "pre-wrap" },
+      muted: { color: C.tertiary, fontSize: 12 },
+      mono: {
+        fontFamily: MONO,
+        fontSize: 12,
+        overflow: "hidden",
+        textOverflow: "ellipsis",
+        whiteSpace: "nowrap",
+      },
+      options: { display: "flex", flexDirection: "column", gap: 4, margin: 0, padding: 0 },
+      option: { color: C.secondary, fontSize: 12, lineHeight: 1.6 },
+    };
+
+    /**
+     * 三个选项的说明。值是契约的一部分（宿主侧的 ToolSet 联合类型），文案只是给人看的：
+     * 每个选项后面那句话回答的是「模型会因此少看到什么」，而不是复述名字。
+     */
+    const OPTIONS = [
+      {
+        value: "sessiongraph",
+        label: "sessiongraph（推荐）",
+        note: "隐藏内核的 5 个会话工具，只留 sessiongraph：答案来自预建索引，更快也更完整。",
+      },
+      {
+        value: "kernel",
+        label: "kernel",
+        note: "隐藏本插件的 sessiongraph，只留宿主自带的 session_* 工具。",
+      },
+      {
+        value: "both",
+        label: "both",
+        note: "两套都暴露。模型可能同一件事查两遍，也更占上下文。",
+      },
+    ];
+
+    /**
+     * 统一 fetch：把网络错误、非 2xx、以及 200 里 ok:false 都收敛成 { ok, message }。
+     * 组件层面只读 ok/message，任何异常都不会冒成渲染错误。
+     */
+    async function call(url, init) {
+      try {
+        const res = await fetch(url, init);
+        let body = null;
+        try {
+          body = await res.json();
+        } catch (err) {
+          body = null; // 非 JSON 也不该吞掉状态码，下面按 HTTP 报
+        }
+        if (!res.ok || (body && body.ok === false)) {
+          return { ok: false, message: (body && body.message) || "HTTP " + res.status };
+        }
+        return { ok: true, data: body };
+      } catch (err) {
+        return { ok: false, message: "请求失败：" + (err && err.message ? err.message : err) };
+      }
+    }
+
+    /** 宿主返回的 toolSet 只认这三个值；其它一律当作还没读到 */
+    function knownToolSet(value) {
+      return value === "sessiongraph" || value === "kernel" || value === "both" ? value : null;
+    }
+
+    /** 一行「检测到什么」的说明：没检测到比检测到更值得说，因为它意味着选了也不生效 */
+    function availabilityText(available) {
+      if (!available) return null;
+      const kernel = Array.isArray(available.kernel) ? available.kernel : [];
+      const parts = [];
+      parts.push("内核会话工具：" + (kernel.length > 0 ? kernel.join("、") : "未检测到"));
+      parts.push("sessiongraph：" + (available.sessiongraph === false ? "未检测到" : "已注册"));
+      return parts.join(" ｜ ");
+    }
+
+    function SessiongraphSection() {
+      const [toolSet, setToolSet] = React.useState(null);
+      const [draft, setDraft] = React.useState("sessiongraph");
+      const [available, setAvailable] = React.useState(null);
+      const [error, setError] = React.useState(null);
+      const [notice, setNotice] = React.useState(null);
+      /** null | "load" | "save"：同时只跑一个请求 */
+      const [busy, setBusy] = React.useState(null);
+      /** 是否成功读过一次；用来区分「还没读」和「读到了但值是空的」 */
+      const [loaded, setLoaded] = React.useState(false);
+
+      // 打开就自动读一次当前值。设置页是用户主动打开的地方，一次同源 GET 的代价可以忽略。
+      React.useEffect(function () {
+        load();
+        // 只在挂载时跑：之后由「保存」按钮驱动
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+      }, []);
+
+      /** 所有错误都走 state，不 throw —— 一个 tab 不该把设置页打白 */
+      async function load() {
+        setBusy("load");
+        const result = await call(API + "/tools");
+        setBusy(null);
+        if (!result.ok) {
+          setError(result.message);
+          return;
+        }
+        const data = result.data || {};
+        setError(null);
+        setAvailable(data.available || null);
+        const current = knownToolSet(data.toolSet) || "sessiongraph";
+        setToolSet(current);
+        setDraft(current);
+        setLoaded(true);
+      }
+
+      async function onSave() {
+        if (busy !== null) return;
+        setBusy("save");
+        setError(null);
+        setNotice(null);
+        const result = await call(API + "/tools", {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({ toolSet: draft }),
+        });
+        setBusy(null);
+        if (!result.ok) {
+          setError(result.message);
+          return;
+        }
+        const data = result.data || {};
+        const saved = knownToolSet(data.toolSet) || draft;
+        setToolSet(saved);
+        setDraft(saved);
+        if (data.available) setAvailable(data.available);
+        setNotice("已保存：" + saved + "。新值对之后创建的会话立即生效，已在跑的会话在下一步重新读取工具表。");
+      }
+
+      const dirty = loaded && toolSet !== null && draft !== toolSet;
+
+      const options = OPTIONS.map((option) =>
+        h("option", { key: option.value, value: option.value }, option.label),
+      );
+
+      const header = h(
+        "div",
+        { style: S.block },
+        h(
+          "div",
+          { style: S.headRow },
+          h("h2", { style: S.h1 }, "会话检索"),
+          h(
+            "div",
+            { style: S.row },
+            h("span", { style: S.label }, "工具集"),
+            h(
+              "select",
+              {
+                style: S.select,
+                value: draft,
+                title: "决定哪些会话检索工具对模型可见",
+                disabled: busy === "save",
+                onChange: (event) => {
+                  setDraft(event.target.value);
+                  setNotice(null);
+                },
+              },
+              options,
+            ),
+            h(
+              "button",
+              {
+                type: "button",
+                style: busy !== null ? S.btnOff : S.btn,
+                disabled: busy !== null,
+                title: "保存并立即应用",
+                onClick: onSave,
+              },
+              busy === "save" ? "保存中…" : "保存",
+            ),
+          ),
+        ),
+        h(
+          "div",
+          { style: S.hint },
+          "决定哪些会话检索工具对模型可见：切到 sessiongraph 会隐藏宿主的 session_search 系列，"
+            + "切到 kernel 会隐藏本插件的 sessiongraph，both 两个都留。改动立刻生效，不需重启。",
+        ),
+      );
+
+      const notes = h(
+        "div",
+        { style: S.options },
+        OPTIONS.map((option) =>
+          h(
+            "div",
+            { key: option.value, style: option.value === draft ? S.option : S.muted },
+            option.value + " — " + option.note,
+          ),
+        ),
+      );
+
+      const status = availabilityText(available);
+
+      return h(
+        "div",
+        { style: S.root, "data-sessiongraph-panel": "" },
+        header,
+        notes,
+        status ? h("div", { style: S.mono }, status) : null,
+        error ? h("div", { style: S.danger, role: "alert" }, error) : null,
+        notice ? h("div", { style: S.okText, role: "status" }, notice) : null,
+        busy === "load" ? h("div", { style: S.muted }, "读取当前设置…") : null,
+        dirty ? h("div", { style: S.muted }, "有未保存的改动。") : null,
+      );
+    }
+
+    /**
+     * 注册「会话检索」tab。
+     *
+     * 两处都单独 try/catch：注册抛错会让 DSH 把 web 判成 failed，
+     * 一个 tab 不该拖垮整个客户端。
+     */
+    function apply(ctx) {
+      try {
+        ctx.slots.inject("settings.section", () => {
+          try {
+            return ctx.slots.register(
+              {
+                name: "settings.section",
+                id: "sessiongraph",
+                order: 31,
+                label: () => "会话检索",
+              },
+              SessiongraphSection,
+            );
+          } catch (err) {
+            console.warn("[sessiongraph] 注册 settings.section 失败：", err);
+            return null;
+          }
+        });
+      } catch (err) {
+        console.warn("[sessiongraph] 注入 settings.section 失败：", err);
+      }
+    }
+
+    exports.name = "sessiongraph-panel-client";
+    exports.inject = ["slots"];
+    exports.apply = apply;
+    return module.exports;
+  },
+});

package/lib/host.js

@@ -0,0 +1,21 @@
+/**
+ * dsh-plugin-sessiongraph-panel · 宿主端入口（空实现）
+ *
+ * 为什么需要它：cordis loader 按包的宿主入口加载一行插件，插件列表里那颗「运行中 / 未运行」
+ * 的指示灯就是这一步的结论。本包只有浏览器半边——`lib/client.js` 是给
+ * `window.__ModuleLoader__` 的 CJS factory，在 Node 里一 import 就碰 `window` 直接抛错——
+ * 所以宿主入口必须是一个能 import、什么都不做的空模块。没有它，整行就是「未运行」。
+ *
+ * 浏览器半边不靠这个入口：它由 package.json 的 `dsh.client` 声明发现，宿主把客户端模块
+ * 下发给浏览器，和这里无关。宿主侧真正提供数据的是 `packages/tool/src/panel.ts` 注册的
+ * `/dsh-plugin-sessiongraph/api/*` 路由。
+ * @module dsh-plugin-sessiongraph-panel/host
+ */
+
+/**
+ * Host plugin body — this package has no host-side behavior.
+ */
+export function apply() {
+  // Intentionally empty. The package exists for its browser half; this function only makes the
+  // package loadable so the loader can report it as running.
+}

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "dsh-plugin-sessiongraph-panel",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Settings-page panel for dsh-plugin-sessiongraph: a 会话检索 tab that switches which session-reading tools the model can see (sessiongraph / kernel / both). Browser half only — every value comes from the host's /dsh-plugin-sessiongraph/api/* routes.",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "cordis",
+    "sessiongraph",
+    "session-history",
+    "settings",
+    "panel",
+    "web-ui"
+  ],
+  "license": "MIT",
+  "author": "CC ZHAO",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CC19990113/dsh-plugin-sessiongraph.git",
+    "directory": "packages/panel"
+  },
+  "homepage": "https://github.com/CC19990113/dsh-plugin-sessiongraph#readme",
+  "bugs": "https://github.com/CC19990113/dsh-plugin-sessiongraph/issues",
+  "type": "module",
+  "main": "lib/host.js",
+  "exports": {
+    ".": {
+      "default": "./lib/host.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/**/*.js"
+  ],
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "dsh": {
+    "client": {
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-settings"
+      ],
+      "platform": "web"
+    }
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.