dsh-tree-task-flow 0.3.10 → 0.3.12

package/client.js

@@ -61,10 +61,27 @@ window.__ModuleLoader__.load({
 			primitives = {};
 		}
 
+		/**
+		 * 内置图标名有两套写法，这里两套都认。
+		 *
+		 * 旧外壳把尺寸写进名字：`IconCheckOutline16`、`IconChevronDownOutline14`；
+		 * 升级后的外壳把名字里的尺寸换成笔画粗细：`IconCheckOutlineRegular`、
+		 * `IconCheckOutlineMedium`，尺寸改由 `size` 属性给。按「尺寸后缀 → 粗细后缀
+		 * → 裸名」的顺序找，两套外壳都取得回图标，不会平白降级成文字。
+		 */
+		function findIcon(base, size) {
+			const candidates = [base + size, base + "14", base + "16", base + "Regular", base + "Medium", base];
+			for (const candidate of candidates) {
+				const component = primitives[candidate];
+				if (typeof component === "function") return component;
+			}
+			return null;
+		}
+
 		/** 取一个内置图标；这版外壳没有就返回 null，由调用方决定怎么退。 */
-		function icon(iconName, size) {
-			const component = primitives[iconName];
-			if (typeof component !== "function") return null;
+		function icon(base, size) {
+			const component = findIcon(base, size);
+			if (component === null) return null;
 			return h(component, { size });
 		}
 
@@ -75,16 +92,21 @@ window.__ModuleLoader__.load({
 			return h(Tooltip, { label, side: "bottom", delayMs: 500 }, node);
 		}
 
-		/** 图标按钮：有图标用图标，没图标退回短文字，保证永远点得到。 */
-		function IconButton({ iconName, label, disabled, onClick }) {
-			const glyph = icon(iconName, 16);
+		/**
+		 * 图标按钮：有图标用图标，没图标退回短文字，保证永远点得到。
+		 *
+		 * 退回文字时换成 `dsh-ttf-iconBtnText`：按钮按文字宽度自己撑开、文字长了
+		 * 用省略号收住，所以并排的几个按钮不会挤成一团互相压。
+		 */
+		function IconButton({ iconBase, label, size, disabled, onClick }) {
+			const glyph = icon(iconBase, typeof size === "number" ? size : 16);
 			return withTooltip(
 				label,
 				h(
 					"button",
 					{
 						type: "button",
-						className: "dsh-ttf-iconBtn",
+						className: glyph === null ? "dsh-ttf-iconBtn dsh-ttf-iconBtnText" : "dsh-ttf-iconBtn",
 						disabled: disabled === true,
 						"aria-label": label,
 						onClick,
@@ -307,16 +329,21 @@ window.__ModuleLoader__.load({
 			'.dsh-ttf-panel:after{border:.5px solid var(--dsw-alias-border-l1);border-radius:inherit;content:"";pointer-events:none;position:absolute;inset:0}',
 			".dsh-ttf-bar{box-sizing:border-box;width:100%;height:36px;display:flex;align-items:center;gap:10px;padding:4px 5px 4px 12px}",
 			".dsh-ttf-glyph{color:var(--dsw-alias-label-tertiary);flex:none;display:inline-flex;align-items:center}",
+			".dsh-ttf-glyphFallback{font-size:13px;line-height:16px}",
 			".dsh-ttf-label{color:var(--dsw-alias-label-primary);flex:none;font-size:13px;font-weight:500;line-height:24px;white-space:nowrap}",
 			".dsh-ttf-labelHeld{color:var(--dsw-alias-state-warning-primary,#a06800)}",
 			".dsh-ttf-title{min-width:0;flex:1;color:var(--dsw-alias-label-primary-dimmed);font-size:13px;line-height:20px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}",
 			".dsh-ttf-progress{flex:none;max-width:45%;min-width:0;color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:20px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}",
 			".dsh-ttf-actions{flex:none;display:flex;align-items:center;gap:2px}",
-			".dsh-ttf-iconBtn{corner-shape:round;width:28px;height:28px;border:none;background:0 0;border-radius:999px;color:var(--dsw-alias-label-tertiary);cursor:pointer;display:inline-flex;align-items:center;justify-content:center;padding:0;font:inherit}",
+			".dsh-ttf-iconBtn{corner-shape:round;width:28px;height:28px;border:none;background:0 0;border-radius:999px;color:var(--dsw-alias-label-tertiary);cursor:pointer;display:inline-flex;align-items:center;justify-content:center;padding:0;font:inherit;flex:none}",
 			".dsh-ttf-iconBtn:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}",
 			".dsh-ttf-iconBtn:disabled{opacity:.4;cursor:default}",
 			".dsh-ttf-iconBtn:disabled:hover{background:0 0;color:var(--dsw-alias-label-tertiary)}",
-			".dsh-ttf-iconText{font-size:12px;line-height:16px;padding:0 4px;white-space:nowrap}",
+			// 取不到内置图标时退回文字：固定 28px 宽装不下几个字，文字会溢出到相邻
+			// 按钮上，看着就是几个按钮叠在一起。这里按文字宽度撑开、留出边距，
+			// 并给一个上限，长了用省略号收住——几个按钮始终各占各的位置。
+			".dsh-ttf-iconBtnText{width:auto;min-width:28px;max-width:112px;height:24px;padding:0 8px}",
+			".dsh-ttf-iconText{min-width:0;max-width:100%;overflow:hidden;text-overflow:ellipsis;font-size:12px;line-height:16px;white-space:nowrap}",
 			// 展开体：限高滚动——这是输入框旁边的位置，不能让它把会话挤没了。
 			".dsh-ttf-body{max-height:264px;overflow-y:auto;padding:2px 8px 8px}",
 			".dsh-ttf-note{margin:4px 4px 6px;padding:6px 8px;border-radius:8px;font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-bg-module-platform)}",
@@ -388,11 +415,11 @@ window.__ModuleLoader__.load({
 		 */
 		function StatusMark({ node, isCurrent }) {
 			if (node.status === "done") {
-				const check = icon("IconCheckOutline14", 14);
+				const check = icon("IconCheckOutline", 14);
 				return h("span", { className: "dsh-ttf-markDone" }, check === null ? "✓" : check);
 			}
 			if (node.status === "dropped") {
-				const close = icon("IconCloseOutline16", 14);
+				const close = icon("IconCloseOutline", 14);
 				return h("span", { className: "dsh-ttf-markMuted" }, close === null ? "×" : close);
 			}
 			const circle = { cx: 7, cy: 7, r: 5.2, stroke: "currentColor", strokeWidth: 1.2 };
@@ -536,7 +563,7 @@ window.__ModuleLoader__.load({
 						{ className: "dsh-ttf-rowActions" },
 						canAct
 							? h(IconButton, {
-									iconName: "IconCheckOutline16",
+									iconBase: "IconCheckOutline",
 									label: t("action.done"),
 									disabled: busy,
 									onClick: () => {
@@ -547,7 +574,7 @@ window.__ModuleLoader__.load({
 							: null,
 						canAct && canDrop
 							? h(IconButton, {
-									iconName: "IconTrashOutline16",
+									iconBase: "IconTrashOutline",
 									label: t("action.drop"),
 									disabled: busy,
 									onClick: () => {
@@ -559,7 +586,7 @@ window.__ModuleLoader__.load({
 							: null,
 						expandable
 							? h(IconButton, {
-									iconName: open ? "IconChevronDownOutline14" : "IconChevronRightOutline14",
+									iconBase: open ? "IconChevronDownOutline" : "IconChevronRightOutline",
 									label: open ? t("action.collapse") : t("action.expand"),
 									onClick: () => setOpen(!open),
 								})
@@ -718,6 +745,10 @@ window.__ModuleLoader__.load({
 					: data.active === null
 						? t("state.done")
 						: t("state.running");
+			// 条首的清单图标；外壳连这个图标都没有时退回一个同类字符，别留空白。
+			const listIcon = icon("IconChecklistOutline", 14);
+			const listGlyph =
+				listIcon === null ? h("span", { className: "dsh-ttf-glyphFallback" }, "☰") : listIcon;
 
 			return h(
 				"div",
@@ -728,7 +759,7 @@ window.__ModuleLoader__.load({
 					h(
 						"div",
 						{ className: "dsh-ttf-bar" },
-						h("span", { className: "dsh-ttf-glyph", "aria-hidden": true }, icon("IconChecklistOutline14", 14)),
+						h("span", { className: "dsh-ttf-glyph", "aria-hidden": true }, listGlyph),
 						h("span", { className: "dsh-ttf-label" + (held ? " dsh-ttf-labelHeld" : "") }, stateLabel),
 						h("span", { className: "dsh-ttf-title", title: heading }, heading),
 						h(
@@ -740,13 +771,13 @@ window.__ModuleLoader__.load({
 							"div",
 							{ className: "dsh-ttf-actions" },
 							h(IconButton, {
-								iconName: held ? "IconPlayOutline16" : "IconPauseOutline16",
+								iconBase: held ? "IconPlayOutline" : "IconPauseOutline",
 								label: held ? t("action.resume") : t("action.pause"),
 								disabled: busy,
 								onClick: () => act({ action: held ? "resume" : "pause" }),
 							}),
 							h(IconButton, {
-								iconName: "IconTrashOutline16",
+								iconBase: "IconTrashOutline",
 								label: t("action.reset"),
 								disabled: busy,
 								onClick: () => {
@@ -754,7 +785,7 @@ window.__ModuleLoader__.load({
 								},
 							}),
 							h(IconButton, {
-								iconName: open ? "IconChevronDownOutline14" : "IconChevronUpOutline14",
+								iconBase: open ? "IconChevronDownOutline" : "IconChevronUpOutline",
 								label: open ? t("action.collapse") : t("action.expand"),
 								onClick: () => setOpen(!open),
 							}),

package/lib/auto-continue.js

@@ -16,6 +16,7 @@
  */
 
 import { activePath, renderContinue } from "./plan.js";
+import { pluginSource } from "./region.js";
 
 /**
  * 注册续行兜底。
@@ -57,7 +58,8 @@ export function registerAutoContinue(ctx, { store, cfg }) {
   // 必须按来源区分，不能按"这一步有没有消息"：`agent.followup()` 推的消息同样会
   // 从 inbox 进入下一步的 `payload.messages`，那样每一轮都会把自己刚用掉的配额
   // 重置回去，`maxAutoRounds` 也就失去了意义。
-  // `source.kind === 'user'` 才是真人，插件推的是 `'plugin'`。
+  // `source.kind === 'user'` 才是真人，插件推的是 `plugin:dsh-tree-task-flow`
+  // （v3 老会话里是 `{ kind: 'plugin', plugin: 'dsh-tree-task-flow' }`；两种都不是 `'user'`）。
   //
   // 注意这是 waterfall：必须 await next() 并把它返回，否则会截断监听器链。
   ctx.on("agent/pre-step", async (payload, next) => {
@@ -106,7 +108,7 @@ export function registerAutoContinue(ctx, { store, cfg }) {
         id: `tt-continue-${sessionId}-${Date.now().toString(36)}`,
         role: "user",
         content: [{ type: "text", text: renderContinue(plan) }],
-        source: { kind: "plugin", plugin: "dsh-tree-task-flow", form: "notice", summary: "计划续行" },
+        source: pluginSource("计划续行"),
       });
       ctx.logger?.info?.(
         `dsh-tree-task-flow: 自动续行 ${used + 1}/${cfg.maxAutoRounds}（步骤 ${active.step.id}）`,

package/lib/compaction.js

@@ -10,8 +10,15 @@
  * 又明确要求"不要提及这次压缩"，模型不会自己想到去查。
  *
  * 怎么认：压缩留下的表层节点是一条 `user/message`，它的 `source` 由
- * `compactCheckpointSource()` 构造，标记固定为 `plugin: "compact"`
- * （见 `@deepseek-ai/dsh-compaction` 的 `isCompactCheckpointSource`）。
+ * `compactCheckpointSource()` 构造。**两个形状都要认**：
+ *
+ *   - v4 原生：`{ kind: "compact-checkpoint", compactionId, … }`
+ *     （`COMPACT_CHECKPOINT_MARKER` 就是 `{ kind: "compact-checkpoint" }`）；
+ *   - v3 老写法：`{ kind: "plugin", plugin: "compact" }`——它只在 v3 → v4 迁移里
+ *     被改写成前者，迁移前的会话里仍是这个样子。
+ *
+ * 只认老写法，会让**已经迁到 v4 的会话彻底收不到压缩提示**（实测：本机
+ * session-2083c383 在 v4 里连续压缩两次，一条提示都没有）。
  *
  * **不要认 `compaction/summary` 事件**：那是压缩自己的记录，不带 `surfaceOp`，
  * 因此根本不在表层里；真正替代被收走那段的是紧随其后那条带
@@ -35,14 +42,21 @@
 import { summaryMessage } from "./region.js";
 
 /**
- * 压缩检查点的插件标记。
+ * 压缩检查点的插件标记——**只有** v3 老写法用到它。
  *
- * 与 `@deepseek-ai/dsh-compaction` 的 `COMPACT_CHECKPOINT_MARKER` 保持一致的
- * 字面量。这里按形状判断而不是 import 那个包：插件不该为了认一个标记，
- * 就把一个 DSH 内部包写进自己的依赖里。
+ * 与 `@deepseek-ai/dsh-compaction` 的 V3 侧字面量保持一致。这里按形状判断而不是
+ * import 那个包：插件不该为了认一个标记，就把一个 DSH 内部包写进自己的依赖里。
  */
 const COMPACTION_PLUGIN = "compact";
 
+/**
+ * v4 原生压缩检查点的 source kind。
+ *
+ * 与 `@deepseek-ai/dsh-compaction` 的 `COMPACT_CHECKPOINT_MARKER` 一致
+ * （`{ kind: "compact-checkpoint" }`）。
+ */
+const COMPACTION_KIND = "compact-checkpoint";
+
 /**
  * 提示正文。
  *
@@ -64,11 +78,13 @@ function noticeId() {
   return `tt-compaction-${Date.now().toString(36)}-${noticeSeq.toString(36)}`;
 }
 
-/** 这条表层节点是不是压缩落下的检查点。 */
+/** 这条表层节点是不是压缩落下的检查点（v4 新写法与 v3 老写法都认）。 */
 function isCompactionCheckpoint(event) {
   if (event?.type !== "user/message") return false;
   const source = event.data?.source;
-  return source?.kind === "plugin" && source.plugin === COMPACTION_PLUGIN;
+  if (source === undefined || source === null) return false;
+  if (source.kind === COMPACTION_KIND) return true;
+  return source.kind === "plugin" && source.plugin === COMPACTION_PLUGIN;
 }
 
 /**

package/lib/pause.js

@@ -39,9 +39,7 @@
  */
 
 import { activePath, renderContinue } from "./plan.js";
-
-/** 本插件放下的消息都带这个身份。 */
-const PLUGIN = "dsh-tree-task-flow";
+import { pluginSource } from "./region.js";
 
 /**
  * 注册暂停闸门。
@@ -152,7 +150,7 @@ export function registerPause(ctx, { store = null, autoContinue = null } = {}) {
         id: `tt-resume-${sessionId}-${Date.now().toString(36)}`,
         role: "user",
         content: [{ type: "text", text: renderContinue(plan) }],
-        source: { kind: "plugin", plugin: PLUGIN, form: "notice", summary: "恢复续行" },
+        source: pluginSource("恢复续行"),
       });
     } catch (error) {
       return {

package/lib/region.js

@@ -42,7 +42,55 @@
 import { activePath } from "./plan.js";
 
 /** 本插件放下的消息都带这个身份。 */
-const PLUGIN = "dsh-tree-task-flow";
+export const PLUGIN = "dsh-tree-task-flow";
+
+/**
+ * 本插件消息的 source kind。
+ *
+ * DSH 的会话格式 v4 要求消息来源带**生产者自有的** kind：老写法
+ * `{ kind: "plugin", plugin: "包名" }` 只在 v3 → v4 迁移那一刻被改写成
+ * `plugin:<包名>`（第三方插件一律加前缀，见 `dsh-session-format-v3-to-v4`
+ * 的转换表）。**已经是 v4 的会话不再经过迁移**，写入时直接按 v4 校验，
+ * 于是老写法被拒：
+ *
+ *     format v4 message requires a producer-owned source kind
+ *
+ * 这条错误来自 DSH 自己的编码路径（`releasedV4SessionFormatCodec.encodeEvent`
+ * → `assertV4RowAdmission` → `assertV4SourceRowAdmission`），位置在会话落盘那一段，
+ * 插件自己的 try/catch 拦不住。所以从这里起**直接写迁移后的那个 kind**——
+ * 它在 v4 里合法，在 v3 里是"非空且非 plugin 的直接来源"，原样保留、同样合法。
+ */
+export const PLUGIN_SOURCE_KIND = `plugin:${PLUGIN}`;
+
+/**
+ * 本插件一条 notice 消息的 source。
+ *
+ * 字段与老写法保持一致：`form: "notice"` 让界面渲染成可展开的一行说明，
+ * `summary` 是那一行的文字。
+ *
+ * @param summary - 界面上显示的一行摘要。
+ * @returns 消息 source。
+ */
+export function pluginSource(summary) {
+  return { kind: PLUGIN_SOURCE_KIND, form: "notice", summary };
+}
+
+/**
+ * 这条 source 是不是本插件留下的。
+ *
+ * **两种写法都认**：v4 起写 `plugin:dsh-tree-task-flow`，而旧版留在 v3 会话里、
+ * 或压缩折叠区间里带着的老消息仍是 `{ kind: "plugin", plugin: "dsh-tree-task-flow" }`。
+ * 只认新写法会让老会话里的历史通告被当成普通过程，只认老写法会让新会话里的通告
+ * 被反复折叠。
+ *
+ * @param source - 消息的 source。
+ * @returns 是否本插件所留。
+ */
+export function isPluginSource(source) {
+  if (source === undefined || source === null) return false;
+  if (source.kind === PLUGIN_SOURCE_KIND) return true;
+  return source.kind === "plugin" && source.plugin === PLUGIN;
+}
 
 /** 三层固定的名字。只给界面用的游标同步按这个顺序走。 */
 const LEVELS = ["goal", "task", "step"];
@@ -100,7 +148,7 @@ function isHumanMessage(event) {
 
 /** 这条消息是不是本插件自己落下的折叠通告。 */
 function isPluginNotice(event) {
-  return event?.type === "user/message" && event.data?.source?.plugin === PLUGIN;
+  return event?.type === "user/message" && isPluginSource(event.data?.source);
 }
 
 /** 从一次工具调用的参数里取它指向的文件路径；不是文件类调用就返回 null。 */
@@ -149,18 +197,16 @@ export function touchedFiles(session, shadowed) {
  * 形态是 `notice` + `summary`：界面把它渲染成一行可读的说明，展开才是正文。
  * 刻意**不用** `snapshot`——那个形态是"运行时上下文快照"的专属标签，
  * 借用它会让任务汇总在界面上冒充系统提示词/运行环境快照。
+ *
+ * source 走 {@link pluginSource}：**必须是生产者自有的 kind**，否则 v4 会话
+ * 会拒绝这条消息（见 `PLUGIN_SOURCE_KIND` 的说明）。
  */
 export function summaryMessage(id, text, summary) {
   return {
     id,
     role: "user",
     content: [{ type: "text", text }],
-    source: {
-      kind: "plugin",
-      plugin: PLUGIN,
-      form: "notice",
-      summary,
-    },
+    source: pluginSource(summary),
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-tree-task-flow",
-  "version": "0.3.10",
+  "version": "0.3.12",
   "description": "树形任务流：把多步任务组织成目标→任务→子任务三级树，节点完成时由 AI 提交结果，插件随即把该节点的执行过程从上下文里折叠掉，只留下结果。",
   "type": "module",
   "main": "lib/index.js",