dsh-manual-compact-plugin 0.1.0

package/README.md

@@ -0,0 +1,37 @@
+# dsh-manual-compact-plugin
+
+手动上下文压缩插件（DeepSeek Harness / DSH）。
+
+> 点击上下文圆圈（或输入框旁的"压缩"按钮）→ 选择保留最近 N 条 → 停止或分批压缩 → 每次压缩都有存档可查。
+
+## 功能
+
+- **保留最近 N 条**：5 / 10（推荐）/ 20 / 30 / 50 / 自定义
+- **处理方式**：
+  - 完成一批后停止
+  - 分批处理直到完成
+- **压缩存档**：每次压缩显示时间、条数、约计 tokens，点击展开完整摘要
+- 调用 DSH 官方 compaction API（`compaction.compactRegion`）：不拆开工具调用对、会话忙时自动拒绝、失败不改动会话
+
+## 安装
+
+```bash
+dsh plugin --profile web add dsh-manual-compact-plugin
+```
+
+安装后重启一次 DSH。
+
+## 界面位置
+
+- 如果 DSH 带有 `conversation.input.contextMeterPanel` Slot（对应上游补丁），控件嵌入**上下文圆圈弹窗**内
+- 否则自动降级为**输入框工具行右侧的"压缩"按钮**（弹窗面板）
+
+## 工作原理
+
+- 浏览器端通过 `manual-compact` 设置命名空间写入 `request`（会话、保留数、模式）
+- 宿主端读取请求，经当前会话的 compaction 服务执行，把结果写回 `lastRun`
+- 存档来自会话日志中已落地的 `compaction/summary` 事件，随会话持久化
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# dsh-manual-compact bundle patch: manual context compaction with a per-session archive.
+- insert:
+    - id: manual-compact
+      name: dsh-manual-compact-plugin
+      config: {}

package/lib/client.js

@@ -0,0 +1,322 @@
+/**
+ * dsh-manual-compact — browser face.
+ *
+ * Hand-written loader module mirroring the in-repo client bundle format
+ * (window.__ModuleLoader__.load with a CommonJS factory) — no JSX, no
+ * bundler, no TS. React is required through the app's module table.
+ *
+ * Two contributions:
+ * 1. `conversation.input.contextMeterPanel` — the manual-compaction section
+ *    inside the context meter popup (DSH builds that declare the slot).
+ * 2. `conversation.input.right` — a small composer button with the same panel
+ *    in a popup, registered only when the meter-panel slot is absent.
+ *
+ * Both read and write the `manual-compact` settings namespace through the
+ * shared `ctx.settingsScope` transport; the host executes the compaction and
+ * publishes the outcome into `lastRun`.
+ */
+
+window.__ModuleLoader__.load({
+  id: "dsh-manual-compact-plugin/client",
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+    Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+    var react = require("react");
+    var useSyncExternalStore = react.useSyncExternalStore;
+    var useState = react.useState;
+    var useEffect = react.useEffect;
+    var useRef = react.useRef;
+
+    var CSS_ID = "dsh-manual-compact-plugin/client";
+    var css = [
+      ".dsmc-title{font-weight:600;margin:10px 0 6px;font-size:12px;color:var(--dsw-alias-label-primary)}",
+      ".dsmc-sep{border:0;border-top:1px solid var(--dsw-alias-border-l3);margin:8px 0}",
+      ".dsmc-row{display:flex;align-items:center;gap:6px;margin:6px 0}",
+      ".dsmc-row label{flex:none;min-width:52px;color:var(--dsw-alias-label-secondary);font-size:12px}",
+      ".dsmc-row select,.dsmc-row input{box-sizing:border-box;min-width:0;flex:1;padding:4px 6px;border:1px solid var(--dsw-alias-border-l3);border-radius:6px;background:var(--dsw-specific-input);color:var(--dsw-alias-label-primary);font-size:12px}",
+      ".dsmc-actions{display:flex;justify-content:flex-end;margin-top:8px}",
+      ".dsmc-actions button{border:0;border-radius:6px;padding:5px 10px;cursor:pointer;font-size:12px}",
+      ".dsmc-actions button:disabled{cursor:default;opacity:.6}",
+      ".dsmc-confirm{background:var(--dsw-alias-interactive-bg-primary);color:var(--dsw-alias-label-on-color)}",
+      ".dsmc-msg{margin-top:6px;font-size:12px;line-height:16px;color:var(--dsw-alias-label-tertiary)}",
+      ".dsmc-msg.dsmc-err{color:var(--dsw-alias-state-error-primary)}",
+      ".dsmc-archive{max-height:160px;overflow:auto}",
+      ".dsmc-arch-item{border:0;background:transparent;width:100%;text-align:left;padding:4px 0;font-size:12px;line-height:16px;color:var(--dsw-alias-label-secondary);cursor:pointer}",
+      ".dsmc-arch-item:hover{background:var(--dsw-alias-interactive-bg-hover)}",
+      ".dsmc-arch-summary{font-size:12px;line-height:16px;color:var(--dsw-alias-label-secondary);margin:4px 0 8px;white-space:pre-wrap}",
+      ".dsmc-empty{font-size:12px;color:var(--dsw-alias-label-tertiary)}",
+      ".dsmc-wrap{position:relative;display:inline-flex}",
+      ".dsmc-btn{height:24px;padding:0 8px;border:0;border-radius:6px;background:transparent;color:var(--dsw-alias-label-secondary);font-size:12px;cursor:pointer}",
+      ".dsmc-btn:hover{background:var(--dsw-alias-interactive-bg-hover)}",
+      ".dsmc-pop{position:absolute;right:0;bottom:32px;z-index:120;width:280px;max-height:440px;overflow:auto;padding:12px;border:1px solid var(--dsw-alias-border-inverted);border-radius:12px;background:var(--dsw-specific-menu);box-shadow:var(--dsw-shadow-lv3);color:var(--dsw-alias-label-primary);font-size:12px;text-align:left}",
+    ].join("");
+    if (typeof document !== "undefined" && document.querySelector('style[data-plugin-css="' + CSS_ID + '"]') === null) {
+      var tag = document.createElement("style");
+      tag.dataset.plugin = "dsh-manual-compact-plugin";
+      tag.dataset.pluginCss = CSS_ID;
+      tag.textContent = css;
+      document.head.appendChild(tag);
+    }
+
+    /**
+     * Read the `manual-compact` namespace snapshot reactively.
+     * @param scope - the bound SettingsScope.
+     * @returns `{ value, writable, ready }`.
+     */
+    function useNamespaceSnapshot(scope) {
+      var snapshot = useSyncExternalStore(
+        function (onChange) { return scope.subscribe(onChange); },
+        function () { return scope.getSnapshot(); }
+      );
+      var ready = snapshot.status === "ready" && snapshot.value !== undefined;
+      return {
+        value: ready ? snapshot.value : undefined,
+        writable: snapshot.writable === true && ready,
+        ready: snapshot.status === "ready",
+      };
+    }
+
+    function fmtTime(ms) {
+      if (typeof ms !== "number" || !isFinite(ms)) return "";
+      var d = new Date(ms);
+      var pad = function (v) { return String(v).padStart(2, "0"); };
+      return (d.getMonth() + 1) + "/" + d.getDate() + " " + pad(d.getHours()) + ":" + pad(d.getMinutes());
+    }
+
+    function fmtTokens(v) {
+      if (typeof v !== "number" || !isFinite(v)) return "?";
+      if (v >= 1000) return Math.round(v / 1000) + "k";
+      return String(v);
+    }
+
+    /**
+     * The shared controls: keep selector, mode selector, submit, last result,
+     * and the landed compaction archive read from the conversation snapshot.
+     */
+    function CompactControls(props) {
+      var state = useNamespaceSnapshot(props.scope);
+      var value = state.value || {};
+      var [keep, setKeep] = useState("10");
+      var [customKeep, setCustomKeep] = useState("");
+      var [mode, setMode] = useState("stop");
+      var [localError, setLocalError] = useState("");
+      var [expandedSeq, setExpandedSeq] = useState(null);
+
+      var request = value.request;
+      var busy = request !== null && request !== undefined;
+      var lastRun = value.lastRun;
+
+      var legacy = props.session && props.session.chat && props.session.chat.legacy;
+      var nodes = legacy && Array.isArray(legacy.nodes) ? legacy.nodes : [];
+      var entries = [];
+      for (var i = nodes.length - 1; i >= 0; i -= 1) {
+        var n = nodes[i];
+        if (n && n.kind === "compaction") entries.push(n);
+      }
+
+      var effectiveKeep = keep === "custom" ? customKeep : keep;
+      function submit() {
+        var n = Number(effectiveKeep);
+        if (!Number.isInteger(n) || n < 1) {
+          setLocalError("请输入大于 0 的保留数量。");
+          return;
+        }
+        setLocalError("");
+        if (props.sessionId === undefined || props.sessionId === null) {
+          setLocalError("当前没有可压缩的会话。");
+          return;
+        }
+        props.scope.set("request", {
+          nonce: Date.now() * 1000 + Math.floor(Math.random() * 1000),
+          sessionId: props.sessionId,
+          keep: n,
+          mode: mode,
+        }).catch(function (error) {
+          console.error("[dsh-manual-compact-plugin] submit failed:", error);
+          setLocalError("请求发送失败，请稍后重试。");
+        });
+      }
+
+      return react.createElement(
+        "div",
+        { className: "dsmc", "data-manual-compact": true },
+        react.createElement("hr", { className: "dsmc-sep" }),
+        react.createElement("div", { className: "dsmc-title" }, "手动压缩"),
+        react.createElement(
+          "div",
+          { className: "dsmc-row" },
+          react.createElement("label", null, "保留最近"),
+          react.createElement(
+            "select",
+            { value: keep, disabled: busy, onChange: function (e) { setKeep(e.target.value); } },
+            react.createElement("option", { value: "5" }, "5 条"),
+            react.createElement("option", { value: "10" }, "10 条（推荐）"),
+            react.createElement("option", { value: "20" }, "20 条"),
+            react.createElement("option", { value: "30" }, "30 条"),
+            react.createElement("option", { value: "50" }, "50 条"),
+            react.createElement("option", { value: "custom" }, "自定义")
+          )
+        ),
+        keep === "custom"
+          ? react.createElement("input", {
+            type: "number",
+            min: 1,
+            max: 10000,
+            placeholder: "输入数量",
+            disabled: busy,
+            onChange: function (e) { setCustomKeep(e.target.value); },
+          })
+          : null,
+        react.createElement(
+          "div",
+          { className: "dsmc-row" },
+          react.createElement("label", null, "处理方式"),
+          react.createElement(
+            "select",
+            { value: mode, disabled: busy, onChange: function (e) { setMode(e.target.value); } },
+            react.createElement("option", { value: "stop" }, "完成一批后停止"),
+            react.createElement("option", { value: "batch" }, "分批处理直到完成")
+          )
+        ),
+        react.createElement(
+          "div",
+          { className: "dsmc-actions" },
+          react.createElement(
+            "button",
+            { type: "button", className: "dsmc-confirm", disabled: busy, onClick: submit },
+            busy ? "处理中…" : "开始压缩"
+          )
+        ),
+        localError
+          ? react.createElement("div", { className: "dsmc-msg dsmc-err" }, localError)
+          : lastRun
+            ? react.createElement(
+              "div",
+              { className: lastRun.ok ? "dsmc-msg" : "dsmc-msg dsmc-err" },
+              lastRun.message + "（" + fmtTime(lastRun.at) + "）"
+            )
+            : null,
+        react.createElement("hr", { className: "dsmc-sep" }),
+        react.createElement("div", { className: "dsmc-title" }, "压缩存档（" + entries.length + "）"),
+        entries.length === 0
+          ? react.createElement("div", { className: "dsmc-empty" }, "暂无压缩记录。")
+          : react.createElement(
+            "div",
+            { className: "dsmc-archive" },
+            entries.map(function (n) {
+              return react.createElement(
+                "div",
+                { key: String(n.seq) },
+                react.createElement(
+                  "button",
+                  {
+                    type: "button",
+                    className: "dsmc-arch-item",
+                    onClick: function () { setExpandedSeq(expandedSeq === n.seq ? null : n.seq); },
+                  },
+                  fmtTime(n.time) + " · " + (n.shadowedItemCount === null ? "?" : n.shadowedItemCount) + " 条 · ~" + fmtTokens(n.shadowedTokenCount) + " tokens"
+                ),
+                expandedSeq === n.seq && n.summary
+                  ? react.createElement("div", { className: "dsmc-arch-summary" }, n.summary)
+                  : null
+              );
+            })
+          )
+      );
+    }
+
+    /** Inline entry for the context meter popup (declared by patched DSH). */
+    function MeterEntry(props) {
+      return react.createElement(CompactControls, { scope: props.scope, session: props.session, sessionId: props.sessionId });
+    }
+
+    /** Composer-button entry with a floating popup, for stock DSH builds. */
+    function RightEntry(props) {
+      var scope = props.scope;
+      var [open, setOpen] = useState(false);
+      var rootRef = useRef(null);
+      useEffect(function () {
+        if (!open) return;
+        function onPointerDown(e) {
+          if (e.target instanceof Node && rootRef.current && rootRef.current.contains(e.target)) return;
+          setOpen(false);
+        }
+        function onKeyDown(e) {
+          if (e.key === "Escape") setOpen(false);
+        }
+        document.addEventListener("pointerdown", onPointerDown);
+        document.addEventListener("keydown", onKeyDown);
+        return function () {
+          document.removeEventListener("pointerdown", onPointerDown);
+          document.removeEventListener("keydown", onKeyDown);
+        };
+      }, [open]);
+      return react.createElement(
+        "span",
+        { ref: rootRef, className: "dsmc-wrap" },
+        react.createElement(
+          "button",
+          {
+            type: "button",
+            className: "dsmc-btn",
+            "aria-expanded": open,
+            onClick: function () { setOpen(!open); },
+          },
+          "压缩"
+        ),
+        open
+          ? react.createElement(
+            "div",
+            { className: "dsmc-pop", role: "dialog", "aria-label": "手动压缩上下文" },
+            react.createElement(CompactControls, { scope: scope, session: props.session, sessionId: props.sessionId })
+          )
+          : null
+      );
+    }
+
+    /**
+     * Browser plugin body: bind the `manual-compact` settings scope, then
+     * register the meter-panel section and — only when that slot is absent —
+     * the composer button fallback.
+     * @param ctx - client cordis context.
+     */
+    function apply(ctx) {
+      var scope = ctx.settingsScope.bind({ namespace: "manual-compact" });
+      var meterDeclared = false;
+      ctx.slots.inject("conversation.input.contextMeterPanel", function () {
+        meterDeclared = true;
+        return ctx.slots.register({
+          name: "conversation.input.contextMeterPanel",
+          id: "manual-compact",
+          order: 0,
+        }, function (props) {
+          return react.createElement(MeterEntry, { scope: scope, session: props.session, sessionId: props.sessionId });
+        });
+      });
+      ctx.timeout(function () {
+        if (meterDeclared) return;
+        ctx.slots.inject("conversation.input.right", function () {
+          return ctx.slots.register({
+            name: "conversation.input.right",
+            id: "manual-compact-button",
+            order: 50,
+          }, function (props) {
+            return react.createElement(RightEntry, { scope: scope, session: props.session, sessionId: props.sessionId });
+          });
+        });
+      }, 5000);
+    }
+
+    exports.name = "manual-compact-ui";
+    exports.apply = apply;
+    // Cordis service names the browser loader must wait for — NOT package
+    // names (those belong in package.json's dsh.client.inject).
+    exports.inject = [
+      "slots",
+      "settingsScope",
+      "timer",
+    ];
+    return module.exports;
+  },
+});

package/lib/index.js

@@ -0,0 +1,127 @@
+/**
+ * dsh-manual-compact — host face.
+ *
+ * Registers the `manual-compact` settings namespace as the Client<->Host
+ * transport (the same pattern dsh-plugin-proxy uses). The browser half writes
+ * a `request` object; this half executes the compaction through the current
+ * agent's official compaction seam (`compaction.compactRegion`) and writes the
+ * outcome into `lastRun`, clearing the request. Safe boundaries (tool-call
+ * pairing, busy session, cancellation) are enforced by the compaction seam.
+ */
+
+import z from '@deepseek-ai/schemastery'
+import { installSettingsSection } from '@deepseek-ai/dsh-settings'
+
+const name = 'dsh-manual-compact-plugin'
+const inject = ['settings', 'agents']
+const NS = 'manual-compact'
+
+/** Composition-row configuration (also the settings schema). */
+const Config = z.object({
+  request: z.union([z.const(null), z.object({
+    nonce: z.number(),
+    sessionId: z.string(),
+    keep: z.number(),
+    mode: z.union([z.const('stop'), z.const('batch')]),
+  })]).default(null),
+  lastRun: z.union([z.const(null), z.object({
+    at: z.number(),
+    keep: z.number(),
+    mode: z.string(),
+    ok: z.boolean(),
+    shadowed: z.number(),
+    message: z.string(),
+  })]).default(null),
+})
+
+/**
+ * Run one manual compaction request against the requesting session.
+ * @param ctx - registrant context (logger only).
+ * @param agents - live agent registry; resolves the session's agent.
+ * @param request - validated request payload.
+ * @returns the outcome: ok, shadowed item count, and a human message.
+ */
+async function executeCompact(ctx, agents, request) {
+  const agent = agents.get(request.sessionId)
+  const compaction = agent && agent.ctx && agent.ctx.get('compaction')
+  if (!agent || !compaction) {
+    return { ok: false, shadowed: 0, message: '当前会话暂时没有可用的压缩服务。' }
+  }
+  try {
+    let total = 0
+    while (true) {
+      const nodes = agent.session.surface.nodes
+      if (!Array.isArray(nodes) || nodes.length <= request.keep) break
+      const endIndex = Math.min(nodes.length - request.keep - 1, request.mode === 'batch' ? 19 : nodes.length - request.keep - 1)
+      if (endIndex < 0) break
+      const result = await compaction.compactRegion(nodes[0], nodes[endIndex], agent)
+      total += result.shadowedSeqs.length
+      if (request.mode !== 'batch') break
+    }
+    return {
+      ok: true,
+      shadowed: total,
+      message: total
+        ? `已压缩 ${total} 条历史，保留最近 ${request.keep} 条。`
+        : `没有可压缩的历史，已保留最近 ${request.keep} 条。`,
+    }
+  } catch (error) {
+    const messages = {
+      busy: '当前正在压缩或模型仍在工作，请稍后再试。',
+      changed: '会话发生变化，本次压缩已停止。',
+      summary: '无法生成有效摘要，本次压缩已停止。',
+      commit: '压缩提交未完成。',
+      persistence: '摘要生成完成，但保存会话失败。',
+    }
+    return { ok: false, shadowed: 0, message: messages[error && error.code] || `压缩失败：${error && error.message ? error.message : String(error)}` }
+  }
+}
+
+/**
+ * Cordis plugin body.
+ * @param ctx - registrant context (`settings`, `agents`, `logger`).
+ * @param config - validated composition configuration.
+ */
+function apply(ctx, config) {
+  let getter = () => config
+  let lastHandledNonce = null
+  let handling = null
+  const handle = () => {
+    if (handling !== null) return
+    handling = (async () => {
+      try {
+        const current = getter()
+        const request = current && current.request
+        if (request === null || request === undefined || request.nonce === lastHandledNonce) return
+        lastHandledNonce = request.nonce
+        const result = await executeCompact(ctx, ctx.agents, request)
+        await ctx.settings.update(NS, {
+          request: null,
+          lastRun: {
+            at: Date.now(),
+            keep: request.keep,
+            mode: request.mode,
+            ok: result.ok,
+            shadowed: result.shadowed,
+            message: result.message,
+          },
+        })
+      } catch (error) {
+        ctx.logger.warn('manual-compact: handling a request failed: %s', String(error))
+      } finally {
+        handling = null
+      }
+    })()
+  }
+  installSettingsSection(ctx, NS, Config, config, {
+    setSource: (current) => {
+      getter = current
+      handle()
+    },
+    onChange: () => {
+      handle()
+    },
+  })
+}
+
+export { Config, apply, inject, name }

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "dsh-manual-compact-plugin",
+  "version": "0.1.0",
+  "description": "Manual context compaction for DeepSeek Harness: keep the latest N conversation items with stop or batch mode and a per-session compaction archive — embedded in the context meter popup when the meter panel slot exists, or a composer button otherwise.",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "cordis",
+    "compaction",
+    "context",
+    "archive"
+  ],
+  "license": "MIT",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-settings"
+      ],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "react": "^18.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-client-ui-conversation": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kimkingyu/dsh-manual-compact.git"
+  },
+  "homepage": "https://github.com/kimkingyu/dsh-manual-compact#readme",
+  "bugs": {
+    "url": "https://github.com/kimkingyu/dsh-manual-compact/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}