dsh-hooks 0.12.0 → 0.13.0

package/lib/client.js

@@ -31,6 +31,44 @@ window.__ModuleLoader__.load({
 		async function fetchHistory(n = 50, fetchFn = fetch) {
 			return getJson(`/dsh-hooks/history?n=${Math.max(1, Math.min(500, Math.floor(n)))}`, fetchFn);
 		}
+		/** Outcomes a hook run can end in (kept in sync with the host record type). */
+		const HISTORY_OUTCOMES = [
+			"spawned",
+			"exit-0",
+			"exit-nonzero",
+			"timeout",
+			"spawn-failed",
+			"skipped",
+			"sent",
+			"send-failed"
+		];
+		/**
+		* Apply the panel's filters to a batch of records. The three conditions are
+		* AND-ed; an empty filter keeps everything (the timeline's default view).
+		*/
+		function filterHistory(records, filter) {
+			const session = filter.session?.trim().toLowerCase();
+			return records.filter((record) => {
+				if (filter.event !== void 0 && filter.event !== "" && record.event !== filter.event) return false;
+				if (filter.outcome !== void 0 && filter.outcome !== "" && record.outcome !== filter.outcome) return false;
+				if (session !== void 0 && session !== "") {
+					const id = record.sessionId?.toLowerCase() ?? "";
+					const name = record.sessionName?.toLowerCase() ?? "";
+					if (!id.includes(session) && !name.includes(session)) return false;
+				}
+				return true;
+			});
+		}
+		/** Serialize records as JSONL — byte-compatible with the on-disk history log. */
+		function historyToJsonl(records) {
+			if (records.length === 0) return "";
+			return `${records.map((record) => JSON.stringify(record)).join("\n")}\n`;
+		}
+		/** Download file name for a history export, stamped with local time. */
+		function historyExportName(now = /* @__PURE__ */ new Date()) {
+			const pad = (n) => String(n).padStart(2, "0");
+			return `dsh-hooks-history-${`${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`}.jsonl`;
+		}
 		async function postTest(body, fetchFn = fetch) {
 			try {
 				const response = await fetchFn("/dsh-hooks/test", {
@@ -317,10 +355,35 @@ window.__ModuleLoader__.load({
 				}
 			});
 			const [loadError, setLoadError] = (0, react.useState)(false);
+			const [historyFilter, setHistoryFilterState] = (0, react.useState)(() => ({
+				event: loadStored("dsh-hooks.historyEvent", ""),
+				outcome: loadStored("dsh-hooks.historyOutcome", ""),
+				session: loadStored("dsh-hooks.historySession", "")
+			}));
+			const setHistoryFilter = (patch) => {
+				setHistoryFilterState((current) => {
+					const next = {
+						...current,
+						...patch
+					};
+					storeValue("dsh-hooks.historyEvent", next.event ?? "");
+					storeValue("dsh-hooks.historyOutcome", next.outcome ?? "");
+					storeValue("dsh-hooks.historySession", next.session ?? "");
+					return next;
+				});
+			};
+			const visibleHistory = history === null ? null : filterHistory(history, historyFilter);
+			const historyFiltered = (historyFilter.event ?? "") !== "" || (historyFilter.outcome ?? "") !== "" || (historyFilter.session ?? "") !== "";
 			const [event, setEvent] = (0, react.useState)("turn/end");
 			const [reason, setReason] = (0, react.useState)("completed");
 			const [tool, setTool] = (0, react.useState)("");
 			const [testResult, setTestResult] = (0, react.useState)(null);
+			const [mockFields, setMockFields] = (0, react.useState)({
+				runningSubagents: "",
+				durationMs: "",
+				usageInputTokens: "",
+				usageOutputTokens: ""
+			});
 			const [notifyChannel, setNotifyChannel] = (0, react.useState)("webhook");
 			const [notifyUrl, setNotifyUrl] = (0, react.useState)("");
 			const [notifySlack, setNotifySlack] = (0, react.useState)(false);
@@ -345,7 +408,7 @@ window.__ModuleLoader__.load({
 			const refresh = (0, react.useCallback)(async () => {
 				const [statusInfo, records, feishuInfo] = await Promise.all([
 					fetchStatus(),
-					fetchHistory(30),
+					fetchHistory(200),
 					fetchFeishuStatus()
 				]);
 				setStatus(statusInfo);
@@ -379,18 +442,47 @@ window.__ModuleLoader__.load({
 			}, [
 				event,
 				reason,
-				tool
+				tool,
+				mockFields
 			]);
+			/** Numeric overrides the user actually filled in (empty inputs are skipped). */
+			const testFields = () => {
+				const fields = {};
+				for (const [key, raw] of Object.entries(mockFields)) {
+					const text = raw.trim();
+					if (text === "") continue;
+					const value = Number(text);
+					if (Number.isFinite(value)) fields[key] = value;
+				}
+				return Object.keys(fields).length > 0 ? fields : void 0;
+			};
 			const runTest = async (execute) => {
 				const result = await postTest({
 					event,
 					reason: event === "turn/end" && reason !== "" ? reason : void 0,
 					tool: tool !== "" ? tool : void 0,
+					fields: testFields(),
 					execute
 				});
 				setTestResult(result);
 				if (execute) refresh();
 			};
+			/** Download the filtered timeline as JSONL (same shape as the on-disk log). */
+			const exportHistory = () => {
+				const records = visibleHistory ?? [];
+				if (records.length === 0) return;
+				const name = historyExportName();
+				const blob = new Blob([historyToJsonl(records)], { type: "application/x-ndjson" });
+				const url = URL.createObjectURL(blob);
+				try {
+					const anchor = document.createElement("a");
+					anchor.href = url;
+					anchor.download = name;
+					anchor.click();
+				} finally {
+					setTimeout(() => URL.revokeObjectURL(url), 0);
+				}
+			};
 			const sendNotifyTest = async () => {
 				setNotifyResult(null);
 				const result = await postNotifyTest(notifyChannel, notifyUrl.trim() || void 0, notifySlack);
@@ -703,6 +795,46 @@ window.__ModuleLoader__.load({
 									})
 								]
 							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "dh-test-row",
+								children: [
+									[
+										"runningSubagents",
+										"runningSubagents",
+										"0"
+									],
+									[
+										"durationMs",
+										"durationMs",
+										"1200"
+									],
+									[
+										"usageInputTokens",
+										"usage 输入",
+										"120000"
+									],
+									[
+										"usageOutputTokens",
+										"usage 输出",
+										"45000"
+									]
+								].map(([key, label, placeholder]) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+									className: "dh-field",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+										className: "dh-field-label",
+										children: [label, "（可选）"]
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+										className: "dh-input",
+										value: mockFields[key],
+										inputMode: "numeric",
+										onChange: (e) => setMockFields((current) => ({
+											...current,
+											[key]: e.target.value
+										})),
+										placeholder
+									})]
+								}, key))
+							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 								className: "dh-buttons",
 								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
@@ -1347,58 +1479,152 @@ window.__ModuleLoader__.load({
 							]
 						}, hook.index))
 					})] }),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-						className: "dh-section-head",
-						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("h3", {
-							className: "dh-section-title",
-							children: ["执行历史（最近 30 条）", status !== null && status.historyCount > 0 ? ` · ${status.historyCount} 条` : ""]
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-							type: "button",
-							className: "dh-button dh-toggle",
-							onClick: () => setHistoryOpen(!historyOpen),
-							"aria-expanded": historyOpen,
-							children: historyOpen ? "收起 ▲" : "展开 ▼"
-						})]
-					}), historyOpen && (history === null || history.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-						className: "dh-empty",
-						children: history === null ? "加载中…" : "暂无记录"
-					}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-						className: "dh-timeline",
-						children: [...history].reverse().map((record, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-							className: "dh-record",
-							children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-								className: "dh-record-main",
-								children: [
-									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-										className: "dh-record-top",
-										children: [
-											/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-												className: "dh-record-time",
-												children: formatTime(record.ts)
-											}),
-											/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-												className: "dh-record-event",
-												children: record.event
-											}),
-											/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-												className: `dh-outcome ${outcomeClass(record.outcome)}`,
-												children: outcomeLabel(record.outcome)
-											})
-										]
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-										className: "dh-record-command",
-										title: record.command,
-										children: record.command
-									}),
-									record.error !== void 0 && record.error !== "" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-										className: "dh-record-error",
-										children: record.error.slice(0, 200)
-									})
-								]
-							})
-						}, `${record.ts}-${index}`))
-					}))] })
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", { children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dh-section-head",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("h3", {
+								className: "dh-section-title",
+								children: ["执行历史（最近 30 条）", status !== null && status.historyCount > 0 ? ` · ${status.historyCount} 条` : ""]
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "dh-button dh-toggle",
+								onClick: () => setHistoryOpen(!historyOpen),
+								"aria-expanded": historyOpen,
+								children: historyOpen ? "收起 ▲" : "展开 ▼"
+							})]
+						}),
+						historyOpen && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dh-test-row dh-history-filters",
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+									className: "dh-field",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "dh-field-label",
+										children: "事件"
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+										className: "dh-select",
+										value: historyFilter.event ?? "",
+										onChange: (e) => setHistoryFilter({ event: e.target.value }),
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+											value: "",
+											children: "全部"
+										}), EVENTS.map((name) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+											value: name,
+											children: name
+										}, name))]
+									})]
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+									className: "dh-field",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "dh-field-label",
+										children: "结果"
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+										className: "dh-select",
+										value: historyFilter.outcome ?? "",
+										onChange: (e) => setHistoryFilter({ outcome: e.target.value }),
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+											value: "",
+											children: "全部"
+										}), HISTORY_OUTCOMES.map((name) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+											value: name,
+											children: outcomeLabel(name)
+										}, name))]
+									})]
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+									className: "dh-field",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "dh-field-label",
+										children: "会话（可选）"
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+										className: "dh-input",
+										value: historyFilter.session ?? "",
+										onChange: (e) => setHistoryFilter({ session: e.target.value }),
+										placeholder: "id 或名称片段"
+									})]
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "dh-buttons",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "dh-button",
+										disabled: !historyFiltered,
+										onClick: () => setHistoryFilter({
+											event: "",
+											outcome: "",
+											session: ""
+										}),
+										children: "清空过滤"
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "dh-button",
+										disabled: (visibleHistory ?? []).length === 0,
+										onClick: exportHistory,
+										children: "导出 JSONL"
+									})]
+								})
+							]
+						}),
+						historyOpen && history !== null && history.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dh-history-count",
+							children: [
+								"显示 ",
+								visibleHistory?.length ?? 0,
+								" / 共 ",
+								history.length,
+								" 条（最近 200 条内）",
+								historyFiltered ? " · 已过滤" : ""
+							]
+						}),
+						historyOpen && (history === null || history.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "dh-empty",
+							children: history === null ? "加载中…" : "暂无记录"
+						}) : (visibleHistory ?? []).length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "dh-empty",
+							children: "没有符合过滤条件的记录"
+						}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "dh-timeline",
+							children: [...visibleHistory ?? []].reverse().map((record, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "dh-record",
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "dh-record-main",
+									children: [
+										/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+											className: "dh-record-top",
+											children: [
+												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+													className: "dh-record-time",
+													children: formatTime(record.ts)
+												}),
+												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+													className: "dh-record-event",
+													children: record.event
+												}),
+												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+													className: `dh-outcome ${outcomeClass(record.outcome)}`,
+													children: outcomeLabel(record.outcome)
+												})
+											]
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+											className: "dh-record-command",
+											title: record.command,
+											children: record.command
+										}),
+										record.sessionName !== void 0 && record.sessionName !== "" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+											className: "dh-record-session",
+											children: record.sessionName
+										}),
+										record.error !== void 0 && record.error !== "" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+											className: "dh-record-error",
+											children: record.error.slice(0, 200)
+										})
+									]
+								})
+							}, `${record.ts}-${index}`))
+						}))
+					] })
 				]
 			});
 		}
@@ -1417,7 +1643,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/settings-card.module.css?inline
-		var settings_card_module_default = ":root {\n  --dsh-hooks-border: #80849038;\n  --dsh-hooks-muted: #767c85;\n  --dsh-hooks-accent: #4d8df7;\n  --dsh-hooks-ok: #3fb56b;\n  --dsh-hooks-bad: #e5534b;\n  --dsh-hooks-warn: #d9a13c;\n}\n\n.dh-card {\n  flex-direction: column;\n  gap: 14px;\n  padding: 12px 4px;\n  font-size: 13px;\n  line-height: 1.5;\n  display: flex;\n}\n\n.dh-card-head {\n  align-items: center;\n  gap: 10px;\n  display: flex;\n}\n\n.dh-card-title {\n  font-size: 14px;\n  font-weight: 600;\n}\n\n.dh-badges {\n  gap: 6px;\n  display: flex;\n}\n\n.dh-badge {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  background: #80849029;\n  border-radius: 9px;\n  padding: 1px 7px;\n  font-size: 11px;\n}\n\n.dh-section-title {\n  color: var(--dsh-hooks-muted);\n  text-transform: uppercase;\n  letter-spacing: .04em;\n  margin: 0 0 8px;\n  font-size: 12px;\n  font-weight: 600;\n}\n\n.dh-section-head {\n  justify-content: space-between;\n  align-items: center;\n  gap: 8px;\n  margin: 0 0 8px;\n  display: flex;\n}\n\n.dh-section-head .dh-section-title {\n  margin: 0;\n}\n\n.dh-toggle {\n  padding: 2px 10px;\n  font-size: 11px;\n}\n\n.dh-field-narrow {\n  flex: 0 0 150px;\n}\n\n.dh-feishu-row {\n  align-items: flex-end;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-timeline {\n  flex-direction: column;\n  gap: 6px;\n  display: flex;\n}\n\n.dh-record {\n  border: 1px solid var(--dsh-hooks-border);\n  border-radius: 6px;\n  gap: 8px;\n  padding: 7px 9px;\n  display: flex;\n}\n\n.dh-record-main {\n  flex: 1;\n  min-width: 0;\n}\n\n.dh-record-top {\n  align-items: baseline;\n  gap: 6px;\n  display: flex;\n}\n\n.dh-record-time {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  font-size: 11px;\n}\n\n.dh-record-event {\n  white-space: nowrap;\n  text-overflow: ellipsis;\n  font-weight: 600;\n  overflow: hidden;\n}\n\n.dh-record-command {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  text-overflow: ellipsis;\n  text-align: left;\n  direction: rtl;\n  font-size: 12px;\n  overflow: hidden;\n}\n\n.dh-outcome {\n  white-space: nowrap;\n  border-radius: 9px;\n  align-self: flex-start;\n  padding: 1px 7px;\n  font-size: 11px;\n}\n\n.dh-outcome-ok {\n  color: var(--dsh-hooks-ok);\n  background: #3fb56b29;\n}\n\n.dh-outcome-bad {\n  color: var(--dsh-hooks-bad);\n  background: #e5534b29;\n}\n\n.dh-outcome-warn {\n  color: var(--dsh-hooks-warn);\n  background: #d9a13c29;\n}\n\n.dh-outcome-neutral {\n  color: var(--dsh-hooks-muted);\n  background: #80849029;\n}\n\n.dh-record-error {\n  color: var(--dsh-hooks-bad);\n  white-space: pre-wrap;\n  word-break: break-all;\n  margin-top: 4px;\n  font-size: 11px;\n}\n\n.dh-empty {\n  color: var(--dsh-hooks-muted);\n  padding: 6px 2px;\n  font-size: 12px;\n}\n\n.dh-test-form {\n  flex-direction: column;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-test-row {\n  gap: 8px;\n  display: flex;\n}\n\n.dh-field {\n  flex-direction: column;\n  flex: 1;\n  gap: 3px;\n  min-width: 0;\n  display: flex;\n}\n\n.dh-field-label {\n  color: var(--dsh-hooks-muted);\n  font-size: 11px;\n}\n\n.dh-input, .dh-select {\n  border: 1px solid var(--dsh-hooks-border);\n  color: inherit;\n  box-sizing: border-box;\n  background: #8084901f;\n  border-radius: 5px;\n  outline: none;\n  width: 100%;\n  padding: 5px 8px;\n  font-size: 12px;\n}\n\nbody[data-ds-dark-theme] .dh-select {\n  color-scheme: dark;\n}\n\n.dh-select option {\n  background-color: var(--dsw-specific-menu, transparent);\n  color: inherit;\n}\n\n.dh-input:focus, .dh-select:focus {\n  border-color: var(--dsh-hooks-accent);\n}\n\n.dh-buttons {\n  gap: 8px;\n  display: flex;\n}\n\n.dh-button {\n  border: 1px solid var(--dsh-hooks-border);\n  color: inherit;\n  cursor: pointer;\n  background: #8084901f;\n  border-radius: 5px;\n  padding: 5px 12px;\n  font-size: 12px;\n}\n\n.dh-button:hover {\n  background: #80849038;\n}\n\n.dh-button-primary {\n  background: var(--dsh-hooks-accent);\n  border-color: var(--dsh-hooks-accent);\n  color: #fff;\n}\n\n.dh-button-primary:hover {\n  background: #3c7de8;\n}\n\n.dh-test-results {\n  flex-direction: column;\n  gap: 4px;\n  display: flex;\n}\n\n.dh-test-line {\n  word-break: break-all;\n  border-radius: 5px;\n  padding: 4px 8px;\n  font-size: 12px;\n}\n\n.dh-test-line-match {\n  color: var(--dsh-hooks-ok);\n  background: #3fb56b24;\n}\n\n.dh-test-line-skip {\n  color: var(--dsh-hooks-muted);\n  background: #8084901a;\n}\n\n.dh-error-banner {\n  color: var(--dsh-hooks-bad);\n  background: #e5534b1f;\n  border: 1px solid #e5534b66;\n  border-radius: 6px;\n  padding: 8px 10px;\n  font-size: 12px;\n}\n\n.dh-feishu {\n  flex-direction: column;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-feishu-form, .dh-feishu-status, .dh-feishu-qr {\n  flex-direction: column;\n  align-items: flex-start;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-feishu-qr-img {\n  border: 1px solid var(--dsh-hooks-border);\n  box-sizing: border-box;\n  background: #fff;\n  border-radius: 8px;\n  width: 220px;\n  height: 220px;\n  padding: 6px;\n}\n\n.dh-feishu-line {\n  font-size: 12px;\n}\n\n.dh-feishu-ok {\n  color: var(--dsh-hooks-ok);\n}\n\n.dh-feishu-error {\n  color: var(--dsh-hooks-bad);\n  word-break: break-all;\n  font-size: 12px;\n}\n\n.dh-feishu-hint {\n  color: var(--dsh-hooks-muted);\n  font-size: 11px;\n}\n\n.dh-feishu-link {\n  color: var(--dsh-hooks-accent);\n  font-size: 12px;\n}\n\n.dh-badge-bad {\n  color: var(--dsh-hooks-bad);\n  background: #e5534b29;\n}\n\n.dh-error-retry {\n  flex-shrink: 0;\n  margin-left: 8px;\n  padding: 2px 10px;\n  font-size: 11px;\n}\n\n.dh-check {\n  color: var(--dsh-hooks-muted);\n  align-items: center;\n  gap: 6px;\n  font-size: 12px;\n  display: flex;\n}\n\n.dh-button-small {\n  padding: 2px 8px;\n  font-size: 11px;\n}\n\n.dh-button-danger {\n  color: var(--dsh-hooks-bad);\n  border-color: #e5534b80;\n}\n\n.dh-button-danger:hover {\n  background: #e5534b24;\n}\n\n.dh-hook-list, .dh-hook-editor {\n  flex-direction: column;\n  gap: 6px;\n  display: flex;\n}\n\n.dh-hook {\n  border: 1px solid var(--dsh-hooks-border);\n  border-radius: 6px;\n  flex-direction: column;\n  gap: 4px;\n  padding: 7px 9px;\n  display: flex;\n}\n\n.dh-hook-editing {\n  border-color: #4d8df766;\n  gap: 8px;\n  padding: 9px;\n}\n\n.dh-hook-head {\n  align-items: baseline;\n  gap: 8px;\n  min-width: 0;\n  display: flex;\n}\n\n.dh-hook-event {\n  white-space: nowrap;\n  font-size: 12px;\n  font-weight: 600;\n}\n\n.dh-hook-action {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  text-overflow: ellipsis;\n  text-align: left;\n  direction: rtl;\n  flex: 1;\n  min-width: 0;\n  font-size: 12px;\n  overflow: hidden;\n}\n\n.dh-hook-match {\n  color: var(--dsh-hooks-accent);\n  word-break: break-all;\n  font-size: 11px;\n}\n\n.dh-hook-meta {\n  align-items: center;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-match-key {\n  flex: 0 0 130px;\n}\n\n.dh-feishu-preview {\n  color: var(--dsh-hooks-muted);\n  border-left: 2px solid var(--dsh-hooks-border);\n  word-break: break-all;\n  max-height: 120px;\n  padding: 4px 8px;\n  font-size: 11px;\n  overflow: hidden;\n}\n";
+		var settings_card_module_default = ":root {\n  --dsh-hooks-border: #80849038;\n  --dsh-hooks-muted: #767c85;\n  --dsh-hooks-accent: #4d8df7;\n  --dsh-hooks-ok: #3fb56b;\n  --dsh-hooks-bad: #e5534b;\n  --dsh-hooks-warn: #d9a13c;\n}\n\n.dh-card {\n  flex-direction: column;\n  gap: 14px;\n  padding: 12px 4px;\n  font-size: 13px;\n  line-height: 1.5;\n  display: flex;\n}\n\n.dh-card-head {\n  align-items: center;\n  gap: 10px;\n  display: flex;\n}\n\n.dh-card-title {\n  font-size: 14px;\n  font-weight: 600;\n}\n\n.dh-badges {\n  gap: 6px;\n  display: flex;\n}\n\n.dh-badge {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  background: #80849029;\n  border-radius: 9px;\n  padding: 1px 7px;\n  font-size: 11px;\n}\n\n.dh-section-title {\n  color: var(--dsh-hooks-muted);\n  text-transform: uppercase;\n  letter-spacing: .04em;\n  margin: 0 0 8px;\n  font-size: 12px;\n  font-weight: 600;\n}\n\n.dh-section-head {\n  justify-content: space-between;\n  align-items: center;\n  gap: 8px;\n  margin: 0 0 8px;\n  display: flex;\n}\n\n.dh-section-head .dh-section-title {\n  margin: 0;\n}\n\n.dh-toggle {\n  padding: 2px 10px;\n  font-size: 11px;\n}\n\n.dh-field-narrow {\n  flex: 0 0 150px;\n}\n\n.dh-feishu-row {\n  align-items: flex-end;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-timeline {\n  flex-direction: column;\n  gap: 6px;\n  display: flex;\n}\n\n.dh-record {\n  border: 1px solid var(--dsh-hooks-border);\n  border-radius: 6px;\n  gap: 8px;\n  padding: 7px 9px;\n  display: flex;\n}\n\n.dh-record-main {\n  flex: 1;\n  min-width: 0;\n}\n\n.dh-record-top {\n  align-items: baseline;\n  gap: 6px;\n  display: flex;\n}\n\n.dh-record-time {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  font-size: 11px;\n}\n\n.dh-record-event {\n  white-space: nowrap;\n  text-overflow: ellipsis;\n  font-weight: 600;\n  overflow: hidden;\n}\n\n.dh-record-command {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  text-overflow: ellipsis;\n  text-align: left;\n  direction: rtl;\n  font-size: 12px;\n  overflow: hidden;\n}\n\n.dh-outcome {\n  white-space: nowrap;\n  border-radius: 9px;\n  align-self: flex-start;\n  padding: 1px 7px;\n  font-size: 11px;\n}\n\n.dh-outcome-ok {\n  color: var(--dsh-hooks-ok);\n  background: #3fb56b29;\n}\n\n.dh-outcome-bad {\n  color: var(--dsh-hooks-bad);\n  background: #e5534b29;\n}\n\n.dh-outcome-warn {\n  color: var(--dsh-hooks-warn);\n  background: #d9a13c29;\n}\n\n.dh-outcome-neutral {\n  color: var(--dsh-hooks-muted);\n  background: #80849029;\n}\n\n.dh-record-error {\n  color: var(--dsh-hooks-bad);\n  white-space: pre-wrap;\n  word-break: break-all;\n  margin-top: 4px;\n  font-size: 11px;\n}\n\n.dh-empty {\n  color: var(--dsh-hooks-muted);\n  padding: 6px 2px;\n  font-size: 12px;\n}\n\n.dh-history-filters {\n  flex-wrap: wrap;\n  align-items: flex-end;\n  margin-bottom: 6px;\n}\n\n.dh-history-filters .dh-buttons {\n  flex: none;\n}\n\n.dh-history-count {\n  color: var(--dsh-hooks-muted);\n  padding: 0 2px 6px;\n  font-size: 11px;\n}\n\n.dh-record-session {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  text-overflow: ellipsis;\n  font-size: 11px;\n  overflow: hidden;\n}\n\n.dh-test-form {\n  flex-direction: column;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-test-row {\n  gap: 8px;\n  display: flex;\n}\n\n.dh-field {\n  flex-direction: column;\n  flex: 1;\n  gap: 3px;\n  min-width: 0;\n  display: flex;\n}\n\n.dh-field-label {\n  color: var(--dsh-hooks-muted);\n  font-size: 11px;\n}\n\n.dh-input, .dh-select {\n  border: 1px solid var(--dsh-hooks-border);\n  color: inherit;\n  box-sizing: border-box;\n  background: #8084901f;\n  border-radius: 5px;\n  outline: none;\n  width: 100%;\n  padding: 5px 8px;\n  font-size: 12px;\n}\n\nbody[data-ds-dark-theme] .dh-select {\n  color-scheme: dark;\n}\n\n.dh-select option {\n  background-color: var(--dsw-specific-menu, transparent);\n  color: inherit;\n}\n\n.dh-input:focus, .dh-select:focus {\n  border-color: var(--dsh-hooks-accent);\n}\n\n.dh-buttons {\n  gap: 8px;\n  display: flex;\n}\n\n.dh-button {\n  border: 1px solid var(--dsh-hooks-border);\n  color: inherit;\n  cursor: pointer;\n  background: #8084901f;\n  border-radius: 5px;\n  padding: 5px 12px;\n  font-size: 12px;\n}\n\n.dh-button:hover {\n  background: #80849038;\n}\n\n.dh-button-primary {\n  background: var(--dsh-hooks-accent);\n  border-color: var(--dsh-hooks-accent);\n  color: #fff;\n}\n\n.dh-button-primary:hover {\n  background: #3c7de8;\n}\n\n.dh-test-results {\n  flex-direction: column;\n  gap: 4px;\n  display: flex;\n}\n\n.dh-test-line {\n  word-break: break-all;\n  border-radius: 5px;\n  padding: 4px 8px;\n  font-size: 12px;\n}\n\n.dh-test-line-match {\n  color: var(--dsh-hooks-ok);\n  background: #3fb56b24;\n}\n\n.dh-test-line-skip {\n  color: var(--dsh-hooks-muted);\n  background: #8084901a;\n}\n\n.dh-error-banner {\n  color: var(--dsh-hooks-bad);\n  background: #e5534b1f;\n  border: 1px solid #e5534b66;\n  border-radius: 6px;\n  padding: 8px 10px;\n  font-size: 12px;\n}\n\n.dh-feishu {\n  flex-direction: column;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-feishu-form, .dh-feishu-status, .dh-feishu-qr {\n  flex-direction: column;\n  align-items: flex-start;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-feishu-qr-img {\n  border: 1px solid var(--dsh-hooks-border);\n  box-sizing: border-box;\n  background: #fff;\n  border-radius: 8px;\n  width: 220px;\n  height: 220px;\n  padding: 6px;\n}\n\n.dh-feishu-line {\n  font-size: 12px;\n}\n\n.dh-feishu-ok {\n  color: var(--dsh-hooks-ok);\n}\n\n.dh-feishu-error {\n  color: var(--dsh-hooks-bad);\n  word-break: break-all;\n  font-size: 12px;\n}\n\n.dh-feishu-hint {\n  color: var(--dsh-hooks-muted);\n  font-size: 11px;\n}\n\n.dh-feishu-link {\n  color: var(--dsh-hooks-accent);\n  font-size: 12px;\n}\n\n.dh-badge-bad {\n  color: var(--dsh-hooks-bad);\n  background: #e5534b29;\n}\n\n.dh-error-retry {\n  flex-shrink: 0;\n  margin-left: 8px;\n  padding: 2px 10px;\n  font-size: 11px;\n}\n\n.dh-check {\n  color: var(--dsh-hooks-muted);\n  align-items: center;\n  gap: 6px;\n  font-size: 12px;\n  display: flex;\n}\n\n.dh-button-small {\n  padding: 2px 8px;\n  font-size: 11px;\n}\n\n.dh-button-danger {\n  color: var(--dsh-hooks-bad);\n  border-color: #e5534b80;\n}\n\n.dh-button-danger:hover {\n  background: #e5534b24;\n}\n\n.dh-hook-list, .dh-hook-editor {\n  flex-direction: column;\n  gap: 6px;\n  display: flex;\n}\n\n.dh-hook {\n  border: 1px solid var(--dsh-hooks-border);\n  border-radius: 6px;\n  flex-direction: column;\n  gap: 4px;\n  padding: 7px 9px;\n  display: flex;\n}\n\n.dh-hook-editing {\n  border-color: #4d8df766;\n  gap: 8px;\n  padding: 9px;\n}\n\n.dh-hook-head {\n  align-items: baseline;\n  gap: 8px;\n  min-width: 0;\n  display: flex;\n}\n\n.dh-hook-event {\n  white-space: nowrap;\n  font-size: 12px;\n  font-weight: 600;\n}\n\n.dh-hook-action {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  text-overflow: ellipsis;\n  text-align: left;\n  direction: rtl;\n  flex: 1;\n  min-width: 0;\n  font-size: 12px;\n  overflow: hidden;\n}\n\n.dh-hook-match {\n  color: var(--dsh-hooks-accent);\n  word-break: break-all;\n  font-size: 11px;\n}\n\n.dh-hook-meta {\n  align-items: center;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-match-key {\n  flex: 0 0 130px;\n}\n\n.dh-feishu-preview {\n  color: var(--dsh-hooks-muted);\n  border-left: 2px solid var(--dsh-hooks-border);\n  word-break: break-all;\n  max-height: 120px;\n  padding: 4px 8px;\n  font-size: 11px;\n  overflow: hidden;\n}\n";
 		//#endregion
 		//#region src/client/index.ts
 		const name = "dsh-hooks";

package/lib/config.d.ts

@@ -65,8 +65,10 @@ export interface HookSpec {
     /** Per-hook timeout in milliseconds. Defaults to 10000. */
     timeoutMs?: number;
     /**
-     * Retry count for non-zero exit codes (default 0: fire-and-forget,
-     * never retried). Spawn failures and timeouts are never retried.
+     * Retry count for retryable failures (default 0: fire-and-forget, never
+     * retried). `run`: non-zero exit codes only — spawn failures and timeouts
+     * are never retried. `notify` (webhook): transport failures and HTTP
+     * 408/429/5xx; the desktop channel never retries.
      */
     retries?: number;
     /** Base delay between retries in milliseconds; doubles per attempt. Defaults to 500. */

package/lib/config.js

@@ -64,7 +64,7 @@ export const Config = Schema.object({
             .default('env')
             .description('上下文传递方式：env 只传 DSH_HOOK_* 环境变量（默认）；stdin 额外把完整上下文 JSON 写入命令标准输入'),
         timeoutMs: Schema.number().default(10000).description('单次执行超时（毫秒）'),
-        retries: Schema.natural().default(0).description('非零退出码的重试次数（默认 0 不重试；spawn 失败与超时不重试）'),
+        retries: Schema.natural().default(0).description('重试次数（默认 0 不重试）：run 重试非零退出码（spawn 失败与超时不重试）；notify 的 webhook 渠道重试传输失败与 HTTP 408/429/5xx（desktop 渠道不重试）'),
         retryDelayMs: Schema.natural().default(500).description('重试基础间隔（毫秒），每次翻倍'),
         enabled: Schema.boolean()
             .default(true)

package/lib/dry-run.d.ts

@@ -13,6 +13,33 @@ export declare function loadHooks(profile: string, paths?: {
     hooks: HookSpec[];
     source: string;
 };
+/**
+ * Resolve the JSONL path a profile's dsh-hooks config writes history to
+ * (`config.history.path`, else the plugin default). Deliberately lenient:
+ * `tail` must keep working while the config file is missing or mid-edit.
+ */
+export declare function loadHistoryPath(profile: string, paths?: {
+    patchFile?: string;
+}): string;
+/**
+ * Numeric context fields a simulated event may override — the ones a `match`
+ * comparison can meaningfully target. Strings keep their dedicated CLI flag /
+ * tester input (`--tool`, `--session-name`, …) and the mock defaults.
+ */
+export declare const MOCK_NUMERIC_FIELDS: readonly ['turn', 'step', 'durationMs', 'toolDurationMs', 'runningSubagents', 'totalSubagents', 'treeDurationMs', 'usageTurns', 'usageSessions', 'usageInputTokens', 'usageOutputTokens', 'usageCacheReadTokens', 'usageCacheWriteTokens', 'usageReasoningTokens'];
+export type MockNumericField = (typeof MOCK_NUMERIC_FIELDS)[number];
+export interface MockFieldsResult {
+    ctx: HookContext;
+    /** Keys that were dropped: unknown field names or non-finite numbers. */
+    ignored: string[];
+}
+/**
+ * Apply explicit numeric overrides to a simulated context. Values must be
+ * finite numbers; anything else (unknown field, string, NaN) is reported in
+ * `ignored` instead of being silently coerced — a tester must never "pass"
+ * because a filter was fed the wrong type.
+ */
+export declare function applyMockFields(ctx: HookContext, fields: Record<string, unknown> | undefined): MockFieldsResult;
 /** A synthetic context for the simulated event, overridable per field. */
 export declare function mockContext(event: string, overrides?: Partial<HookContext>): HookContext;
 export interface DryRunLine {
@@ -34,6 +61,8 @@ export interface DryRunOptions {
     reason?: TurnEndReasonKind;
     tool?: string;
     sessionName?: string;
+    /** Explicit numeric context overrides (see {@link MOCK_NUMERIC_FIELDS}). */
+    fields?: Record<string, unknown>;
     /** Actually run the matching hooks (real side effects!). */
     execute?: boolean;
     print?: (line: string) => void;

package/lib/dry-run.js

@@ -9,6 +9,7 @@ import { join } from 'node:path';
 import YAML from 'yaml';
 import { Config } from './config.js';
 import { matchFilters } from './events.js';
+import { DEFAULT_HISTORY_PATH } from './history.js';
 import { localDayKey } from './usage.js';
 import { createHookRunner } from './runner.js';
 import { fireNotify } from './notify.js';
@@ -17,12 +18,10 @@ export function patchFilePath(profile) {
     return join(homedir(), '.dsh', 'profiles', profile, 'cordis.patch.yml');
 }
 /**
- * Load and normalize the dsh-hooks config block from a profile's
- * cordis.patch.yml. Runs the block through the Config schema so match
- * regexes compile and invalid entries fail loudly.
+ * Raw `dsh-hooks` config block from a profile's cordis.patch.yml. Throws on a
+ * missing/unreadable file — callers that must stay lenient catch it.
  */
-export function loadHooks(profile, paths = {}) {
-    const file = paths.patchFile ?? patchFilePath(profile);
+function readConfigBlock(file) {
     if (!existsSync(file))
         throw new Error(`未找到 ${file}（profile 不存在或没有 cordis.patch.yml）`);
     let entries;
@@ -34,19 +33,85 @@ export function loadHooks(profile, paths = {}) {
     }
     if (!Array.isArray(entries))
         throw new Error('cordis.patch.yml 顶层必须是 YAML 数组');
-    let block;
     for (const entry of entries) {
         if (entry !== null && typeof entry === 'object' && entry.id === 'dsh-hooks') {
-            block = entry;
-            break;
+            return entry;
         }
     }
-    if (block === undefined)
-        throw new Error('cordis.patch.yml 中没有 id: dsh-hooks 的配置块');
+    throw new Error('cordis.patch.yml 中没有 id: dsh-hooks 的配置块');
+}
+/**
+ * Load and normalize the dsh-hooks config block from a profile's
+ * cordis.patch.yml. Runs the block through the Config schema so match
+ * regexes compile and invalid entries fail loudly.
+ */
+export function loadHooks(profile, paths = {}) {
+    const file = paths.patchFile ?? patchFilePath(profile);
+    const block = readConfigBlock(file);
     const rawHooks = block.config?.hooks;
     const config = Config({ hooks: (Array.isArray(rawHooks) ? rawHooks : []) });
     return { hooks: config.hooks ?? [], source: file };
 }
+/**
+ * Resolve the JSONL path a profile's dsh-hooks config writes history to
+ * (`config.history.path`, else the plugin default). Deliberately lenient:
+ * `tail` must keep working while the config file is missing or mid-edit.
+ */
+export function loadHistoryPath(profile, paths = {}) {
+    const file = paths.patchFile ?? patchFilePath(profile);
+    try {
+        const block = readConfigBlock(file);
+        const configured = block.config?.history?.path;
+        if (typeof configured === 'string' && configured.trim() !== '')
+            return configured;
+    }
+    catch {
+        // Missing/broken config: fall through to the plugin default.
+    }
+    return DEFAULT_HISTORY_PATH;
+}
+/**
+ * Numeric context fields a simulated event may override — the ones a `match`
+ * comparison can meaningfully target. Strings keep their dedicated CLI flag /
+ * tester input (`--tool`, `--session-name`, …) and the mock defaults.
+ */
+export const MOCK_NUMERIC_FIELDS = [
+    'turn',
+    'step',
+    'durationMs',
+    'toolDurationMs',
+    'runningSubagents',
+    'totalSubagents',
+    'treeDurationMs',
+    'usageTurns',
+    'usageSessions',
+    'usageInputTokens',
+    'usageOutputTokens',
+    'usageCacheReadTokens',
+    'usageCacheWriteTokens',
+    'usageReasoningTokens',
+];
+/**
+ * Apply explicit numeric overrides to a simulated context. Values must be
+ * finite numbers; anything else (unknown field, string, NaN) is reported in
+ * `ignored` instead of being silently coerced — a tester must never "pass"
+ * because a filter was fed the wrong type.
+ */
+export function applyMockFields(ctx, fields) {
+    if (fields === undefined)
+        return { ctx, ignored: [] };
+    const next = { ...ctx };
+    const ignored = [];
+    for (const [key, value] of Object.entries(fields)) {
+        if (!MOCK_NUMERIC_FIELDS.includes(key) || typeof value !== 'number' || !Number.isFinite(value)) {
+            ignored.push(key);
+            continue;
+        }
+        ;
+        next[key] = value;
+    }
+    return { ctx: next, ignored };
+}
 /** A synthetic context for the simulated event, overridable per field. */
 export function mockContext(event, overrides = {}) {
     const ctx = {
@@ -61,6 +126,12 @@ export function mockContext(event, overrides = {}) {
         content: 'dry-run 模拟内容',
         timestamp: new Date().toISOString(),
     };
+    if (event === 'turn/end') {
+        // The real turn/end context ALWAYS carries the live subagent count (0 when
+        // none are running), so the mock must too — otherwise the documented
+        // `match: { runningSubagents: '^0$' }` pattern could never match here.
+        ctx.runningSubagents = 0;
+    }
     if (event === 'usage/daily') {
         // A daily report always describes a day that already ended, and the
         // simulated numbers must be non-zero so `match` filters on them (e.g.
@@ -125,14 +196,23 @@ export async function runDryRun(options) {
     const print = options.print ?? console.log;
     const { hooks, source } = loadHooks(profile, options.paths);
     const reasonKind = options.reason;
-    const ctx = mockContext(options.event, {
+    const simulated = applyMockFields(mockContext(options.event, {
         reason: reasonKind,
         tool: options.tool,
         sessionName: options.sessionName,
-    });
+    }), options.fields);
+    const ctx = simulated.ctx;
     print('dsh-hooks dry-run');
     print(`配置来源：${source}（${hooks.length} 个 hook）`);
     print(`模拟事件：${options.event}${reasonKind ? `（reason=${reasonKind}）` : ''}`);
+    if (options.fields !== undefined && Object.keys(options.fields).length > 0) {
+        const applied = Object.keys(options.fields).filter((key) => !simulated.ignored.includes(key));
+        if (applied.length > 0)
+            print(`模拟字段：${applied.map((key) => `${key}=${String(options.fields?.[key])}`).join(', ')}`);
+    }
+    if (simulated.ignored.length > 0) {
+        print(`⚠ 已忽略无法模拟的字段：${simulated.ignored.join(', ')}（可用：${MOCK_NUMERIC_FIELDS.join(' / ')}）`);
+    }
     const lines = evaluateHooks(hooks, options.event, ctx, reasonKind);
     for (const line of lines) {
         print(line.matched ? `✅ [${line.index}] ${line.summary}` : `⏭ [${line.index}] ${line.summary} —— ${line.why}`);
@@ -153,7 +233,7 @@ export async function runDryRun(options) {
             }
             else if (hook.notify) {
                 print(`▶ 发送 [${line.index}] notify:${hook.notify.channel}`);
-                await fireNotify(hook.notify, ctx);
+                await fireNotify(hook.notify, ctx, undefined, { retries: hook.retries, retryDelayMs: hook.retryDelayMs });
             }
         }
         print('（run 命令 fire-and-forget：执行结果见 dsh 日志）');