dsh-skill-hub 0.3.11 → 0.3.12

package/README.md

@@ -24,7 +24,7 @@ dsh plugin --profile web add dsh-skill-hub
 # restart dsh web → Settings → 技能 → Market → scan → import
 ```
 
-Requires `Node ^22.19 || >=24` + dsh web (`0.1.5-alpha.1`, `0.1.x` forward compatible).
+Requires `Node ^22.19 || >=24` + dsh web (`0.1.5-rc.2`, `0.1.x` forward compatible).
 
 ## Features
 

package/README.zh.md

@@ -24,7 +24,7 @@ dsh plugin --profile web add dsh-skill-hub
 # 重启 dsh web → 设置 → 技能 → 市场 → 扫描 → 导入
 ```
 
-要求 `Node ^22.19 || >=24` + dsh web（`0.1.5-alpha.1`，兼容后续 `0.1.x`）。
+要求 `Node ^22.19 || >=24` + dsh web（`0.1.5-rc.2`，兼容后续 `0.1.x`）。
 
 ## 功能
 

package/lib/index.js

@@ -108,10 +108,45 @@ function isProjectSource(source) {
 * 错误文案收敛：宿主各处把 unknown 异常转成一行可读文字。原先这条表达式
 * 在宿主侧内联了 22 次（`error instanceof Error ? error.message : String(error)`），
 * 现在统一走这里。浏览器半有自己的 `helpers.errorMessage`，两半互不引用。
+*
+* Error 的 `cause` 链（undici 的 `fetch failed`、AggregateError 的多地址
+* 失败、TLS 证书错误等）以括号附录带出，避免只剩笼统的顶层 message。
 */
-/** 从 unknown 异常取出可读文案；非 Error 值用 String 兜底。 */
+/** cause 链最大展开深度，防自引用/超深链。 */
+const MAX_CAUSE_DEPTH = 4;
+/** 合成一条 cause 细节；code 已在 message 里则不重复。 */
+function causeDetail(message, code) {
+	const text = message.trim();
+	if (code === "") return text;
+	if (text === "") return "[" + code + "]";
+	return text.includes(code) ? text : text + " [" + code + "]";
+}
+/** 深度受限地收集 cause 链细节（AggregateError 展开其 errors）。 */
+function collectCauseDetails(cause, depth, seen, out) {
+	if (depth > MAX_CAUSE_DEPTH || cause === null || cause === void 0 || seen.has(cause)) return;
+	seen.add(cause);
+	if (cause instanceof Error) {
+		const errors = cause.errors;
+		if (Array.isArray(errors)) for (const item of errors) collectCauseDetails(item, depth + 1, seen, out);
+		const rawCode = cause.code;
+		const code = typeof rawCode === "string" ? rawCode : "";
+		const detail = causeDetail(cause.message, code);
+		if (detail !== "") out.push(detail);
+		collectCauseDetails(cause.cause, depth + 1, seen, out);
+		return;
+	}
+	const detail = causeDetail(String(cause), "");
+	if (detail !== "") out.push(detail);
+}
+/** 从 unknown 异常取出可读文案；非 Error 值用 String 兜底，cause 附在括号里。 */
 function errorText(error) {
-	return error instanceof Error ? error.message : String(error);
+	if (!(error instanceof Error)) return String(error);
+	const details = [];
+	collectCauseDetails(error.cause, 1, /* @__PURE__ */ new Set(), details);
+	for (let index = details.length - 1; index >= 0; index -= 1) if (details[index] === error.message || details.indexOf(details[index]) !== index) details.splice(index, 1);
+	if (details.length === 0) return error.message;
+	const suffix = details.join("; ");
+	return error.message === "" ? suffix : error.message + " (" + suffix + ")";
 }
 //#endregion
 //#region src/store/paths.ts

package/lib/types/error-text.d.ts

@@ -2,6 +2,9 @@
  * 错误文案收敛：宿主各处把 unknown 异常转成一行可读文字。原先这条表达式
  * 在宿主侧内联了 22 次（`error instanceof Error ? error.message : String(error)`），
  * 现在统一走这里。浏览器半有自己的 `helpers.errorMessage`，两半互不引用。
+ *
+ * Error 的 `cause` 链（undici 的 `fetch failed`、AggregateError 的多地址
+ * 失败、TLS 证书错误等）以括号附录带出，避免只剩笼统的顶层 message。
  */
-/** 从 unknown 异常取出可读文案；非 Error 值用 String 兜底。 */
+/** 从 unknown 异常取出可读文案；非 Error 值用 String 兜底，cause 附在括号里。 */
 export declare function errorText(error: unknown): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-skill-hub",
-  "version": "0.3.11",
+  "version": "0.3.12",
   "description": "In-GUI skill hub for DeepSeek Harness (dsh): browse the full local skill catalog from the official ctx.skills registry (every root + third-party providers), toggle skills on/off, inspect bodies, surface frontmatter diagnostics, and scaffold new skills — plus a codex-style skill market (built-in catalog, upstream update checks, one-click update-all) with tracked source sync. The full manager beyond the read-only dsh-skill-manager browser.",
   "type": "module",
   "engines": {
@@ -69,7 +69,10 @@
         "0.1.2-alpha.5",
         "0.1.2-rc.1",
         "0.1.3-alpha.2",
-        "0.1.5-alpha.1"
+        "0.1.5-alpha.1",
+        "0.1.5-alpha.2",
+        "0.1.5-rc.1",
+        "0.1.5-rc.2"
       ]
     },
     "capability": {
@@ -91,19 +94,19 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1 || ^4.0.2",
-    "@deepseek-ai/dsh-client-connection": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0",
-    "@deepseek-ai/dsh-client-locale": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0",
-    "@deepseek-ai/dsh-client-runtime": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0",
-    "@deepseek-ai/dsh-client-store": ">=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0",
-    "@deepseek-ai/dsh-client-ui-input-trigger": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0",
-    "@deepseek-ai/dsh-host-webserver": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0",
-    "@deepseek-ai/dsh-session": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0",
-    "@deepseek-ai/dsh-session-query": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0",
-    "@deepseek-ai/dsh-settings": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0",
-    "@deepseek-ai/dsh-skill": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0",
-    "@deepseek-ai/dsh-system-prompt": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-client-connection": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0 || >=0.1.5-alpha.2 <0.2.0-0 || >=0.1.5-rc.1 <0.2.0-0 || >=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0 || >=0.1.5-alpha.2 <0.2.0-0 || >=0.1.5-rc.1 <0.2.0-0 || >=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-client-runtime": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0 || >=0.1.5-alpha.2 <0.2.0-0 || >=0.1.5-rc.1 <0.2.0-0 || >=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-client-store": ">=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0 || >=0.1.5-alpha.2 <0.2.0-0 || >=0.1.5-rc.1 <0.2.0-0 || >=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-input-trigger": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0 || >=0.1.5-alpha.2 <0.2.0-0 || >=0.1.5-rc.1 <0.2.0-0 || >=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0 || >=0.1.5-alpha.2 <0.2.0-0 || >=0.1.5-rc.1 <0.2.0-0 || >=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0 || >=0.1.5-alpha.2 <0.2.0-0 || >=0.1.5-rc.1 <0.2.0-0 || >=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-host-webserver": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0 || >=0.1.5-alpha.2 <0.2.0-0 || >=0.1.5-rc.1 <0.2.0-0 || >=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-session": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0 || >=0.1.5-alpha.2 <0.2.0-0 || >=0.1.5-rc.1 <0.2.0-0 || >=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-session-query": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0 || >=0.1.5-alpha.2 <0.2.0-0 || >=0.1.5-rc.1 <0.2.0-0 || >=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-settings": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0 || >=0.1.5-alpha.2 <0.2.0-0 || >=0.1.5-rc.1 <0.2.0-0 || >=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-skill": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0 || >=0.1.5-alpha.2 <0.2.0-0 || >=0.1.5-rc.1 <0.2.0-0 || >=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-system-prompt": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0 || >=0.1.2-rc.1 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0 || >=0.1.5-alpha.2 <0.2.0-0 || >=0.1.5-rc.1 <0.2.0-0 || >=0.1.5-rc.2 <0.2.0-0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
@@ -117,30 +120,32 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-store": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-query": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-settings": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-skill": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-store": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-session-query": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-skill": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.5-rc.2",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.20.0",
     "@types/react": "~18.3.1",
     "@types/react-dom": "^18.3.5",
+    "immer": "^10.2.0",
     "lightningcss": "1.32.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "schemastery": "^3.18.0",
     "tsdown": "0.22.2",
     "typescript": "~5.7.2",
-    "vitest": "^3.0.0"
+    "vitest": "^3.0.0",
+    "zustand": "~4.4.7"
   },
   "files": [
     "lib/**/*.js",

package/src/error-text.test.ts

@@ -16,4 +16,49 @@ describe('errorText', () => {
   it('uses an empty message when the Error has none', () => {
     expect(errorText(new Error(''))).toBe('')
   })
+
+  it('appends a cause message to a fetch failure', () => {
+    const error = new TypeError('fetch failed', { cause: new Error('getaddrinfo ENOTFOUND api.github.com') })
+    expect(errorText(error)).toBe('fetch failed (getaddrinfo ENOTFOUND api.github.com)')
+  })
+
+  it('appends an error code when the cause message does not contain it', () => {
+    const cause = Object.assign(new Error('Connect Timeout Error'), { code: 'UND_ERR_CONNECT_TIMEOUT' })
+    expect(errorText(new TypeError('fetch failed', { cause }))).toBe('fetch failed (Connect Timeout Error [UND_ERR_CONNECT_TIMEOUT])')
+  })
+
+  it('does not duplicate a code already present in the cause message', () => {
+    const cause = Object.assign(new Error('getaddrinfo ENOTFOUND api.github.com'), { code: 'ENOTFOUND' })
+    expect(errorText(new TypeError('fetch failed', { cause }))).toBe('fetch failed (getaddrinfo ENOTFOUND api.github.com)')
+  })
+
+  it('walks nested cause chains', () => {
+    const inner = new Error('inner reason')
+    const outer = new Error('outer', { cause: inner })
+    expect(errorText(new TypeError('fetch failed', { cause: outer }))).toBe('fetch failed (outer; inner reason)')
+  })
+
+  it('expands an AggregateError cause', () => {
+    const cause = new AggregateError([
+      new Error('connect ECONNREFUSED 127.0.0.1:443'),
+      new Error('connect ECONNREFUSED [::1]:443'),
+    ])
+    expect(errorText(new TypeError('fetch failed', { cause }))).toBe('fetch failed (connect ECONNREFUSED 127.0.0.1:443; connect ECONNREFUSED [::1]:443)')
+  })
+
+  it('stops at self-referencing cause chains', () => {
+    const error = new Error('fetch failed')
+    error.cause = error
+    expect(errorText(error)).toBe('fetch failed')
+  })
+
+  it('stringifies non-Error causes', () => {
+    const error = new Error('fetch failed')
+    error.cause = 'socket closed'
+    expect(errorText(error)).toBe('fetch failed (socket closed)')
+  })
+
+  it('returns the cause detail alone when the top message is empty', () => {
+    expect(errorText(new Error('', { cause: new Error('boom') }))).toBe('boom')
+  })
 })

package/src/error-text.ts

@@ -2,9 +2,51 @@
  * 错误文案收敛：宿主各处把 unknown 异常转成一行可读文字。原先这条表达式
  * 在宿主侧内联了 22 次（`error instanceof Error ? error.message : String(error)`），
  * 现在统一走这里。浏览器半有自己的 `helpers.errorMessage`，两半互不引用。
+ *
+ * Error 的 `cause` 链（undici 的 `fetch failed`、AggregateError 的多地址
+ * 失败、TLS 证书错误等）以括号附录带出，避免只剩笼统的顶层 message。
  */
 
-/** 从 unknown 异常取出可读文案；非 Error 值用 String 兜底。 */
+/** cause 链最大展开深度，防自引用/超深链。 */
+const MAX_CAUSE_DEPTH = 4
+
+/** 合成一条 cause 细节；code 已在 message 里则不重复。 */
+function causeDetail(message: string, code: string): string {
+  const text = message.trim()
+  if (code === '') return text
+  if (text === '') return '[' + code + ']'
+  return text.includes(code) ? text : text + ' [' + code + ']'
+}
+
+/** 深度受限地收集 cause 链细节（AggregateError 展开其 errors）。 */
+function collectCauseDetails(cause: unknown, depth: number, seen: Set<unknown>, out: string[]): void {
+  if (depth > MAX_CAUSE_DEPTH || cause === null || cause === undefined || seen.has(cause)) return
+  seen.add(cause)
+  if (cause instanceof Error) {
+    const errors = (cause as { errors?: unknown }).errors
+    if (Array.isArray(errors)) {
+      for (const item of errors) collectCauseDetails(item, depth + 1, seen, out)
+    }
+    const rawCode: unknown = (cause as { code?: unknown }).code
+    const code = typeof rawCode === 'string' ? rawCode : ''
+    const detail = causeDetail(cause.message, code)
+    if (detail !== '') out.push(detail)
+    collectCauseDetails(cause.cause, depth + 1, seen, out)
+    return
+  }
+  const detail = causeDetail(String(cause), '')
+  if (detail !== '') out.push(detail)
+}
+
+/** 从 unknown 异常取出可读文案；非 Error 值用 String 兜底，cause 附在括号里。 */
 export function errorText(error: unknown): string {
-  return error instanceof Error ? error.message : String(error)
+  if (!(error instanceof Error)) return String(error)
+  const details: string[] = []
+  collectCauseDetails(error.cause, 1, new Set(), details)
+  for (let index = details.length - 1; index >= 0; index -= 1) {
+    if (details[index] === error.message || details.indexOf(details[index]) !== index) details.splice(index, 1)
+  }
+  if (details.length === 0) return error.message
+  const suffix = details.join('; ')
+  return error.message === '' ? suffix : error.message + ' (' + suffix + ')'
 }