@xgjktech/xg_cwork_im 1.14.6 → 1.15.1

package/dist/src/user-facing-errors.js

@@ -0,0 +1,105 @@
+/**
+ * 面向 IM 用户的错误文案：只描述发生了什么，不包含操作建议。
+ */
+import { summarizeMediaRef } from "./resource-file.js";
+function errorMessageLower(context) {
+    return (context?.errorMessage ?? "").trim().toLowerCase();
+}
+export function isAttachmentBlockedErrorMessage(message) {
+    const lower = message.trim().toLowerCase();
+    return (lower.includes("blocked attachment") ||
+        lower.includes("outside allowed roots") ||
+        lower.includes("not under an allowed directory") ||
+        (lower.includes("skipping attachment") && lower.includes("blocked")));
+}
+export function isContextOverflowErrorMessage(message) {
+    const lower = message.trim().toLowerCase();
+    return (lower.includes("context overflow") ||
+        lower.includes("context-overflow") ||
+        lower.includes("overflowtokens") ||
+        lower.includes("overflow tokens") ||
+        lower.includes("prompt too large") ||
+        lower.includes("too large for the model") ||
+        lower.includes("too large for this model") ||
+        lower.includes("promptbudget") ||
+        (lower.includes("precheck") && lower.includes("overflow")));
+}
+/**
+ * 根据终态与观测到的原始错误，生成发给用户的中文说明（仅陈述事实）。
+ */
+export function buildTerminalUserMessage(state, context) {
+    const errLower = errorMessageLower(context);
+    switch (state) {
+        case "precheck_error":
+            return "当前对话上下文过大，本轮未能调用模型。";
+        case "compaction_failed":
+            return "系统已尝试压缩对话历史，但仍未生成回复。";
+        case "timeout":
+            return "当前请求处理超时。";
+        case "no_reply":
+            if (context?.noReplyCause === "zero_deliver") {
+                return "消息已收到，本轮未向 IM 发送任何回复内容。";
+            }
+            return "消息已收到，但这一轮没有生成回复。";
+        case "runtime_error":
+            if (isAttachmentBlockedErrorMessage(errLower)) {
+                return ("您发送的图片或附件未能加载（系统路径访问受限），模型可能看不到附件内容；文本消息已收到。");
+            }
+            if (isContextOverflowErrorMessage(errLower)) {
+                return "当前对话上下文过大，处理失败。";
+            }
+            return "当前请求处理时出现异常。";
+        case "delivery_failed":
+            return "回复已生成，但发送到 IM 时失败。";
+        case "cancelled":
+            return "当前请求已取消。";
+        case "superseded":
+            return "当前请求已被更新的处理覆盖。";
+        case "success":
+            return "";
+    }
+}
+/**
+ * 出站发文件失败时，将技术错误转为用户可读说明（不含实现细节与操作建议）。
+ */
+export function formatUserFacingMediaDeliverError(err, mediaRefs = []) {
+    const raw = err instanceof Error ? err.message : String(err);
+    const lower = raw.toLowerCase();
+    const ref = mediaRefs.find((u) => u.trim())?.trim() ?? extractPathFromMediaError(raw);
+    const shortRef = ref ? summarizeMediaRef(ref, 120) : undefined;
+    if (lower.includes("无法读取媒体") || lower.includes("unsupported ref")) {
+        if (shortRef && looksLikeWorkspaceRelativePath(shortRef)) {
+            return `未能将文件发送到 IM：找不到或无法读取「${shortRef}」。`;
+        }
+        return "未能将文件发送到 IM：找不到或无法读取附件路径。";
+    }
+    if (lower.includes("enoent") || lower.includes("no such file")) {
+        return shortRef
+            ? `未能将文件发送到 IM：本地找不到「${shortRef}」。`
+            : "未能将文件发送到 IM：本地找不到对应文件。";
+    }
+    if (lower.includes("eacces") || lower.includes("permission denied")) {
+        return "未能将文件发送到 IM：没有读取该文件的权限。";
+    }
+    if (lower.includes("abort") || lower.includes("timeout") || lower.includes("timed out")) {
+        return "未能将文件发送到 IM：读取或上传超时。";
+    }
+    if (lower.includes("axios") || lower.includes("network") || lower.includes("econnrefused")) {
+        return "未能将文件发送到 IM：网络或上传服务异常。";
+    }
+    return "未能将文件发送到 IM。";
+}
+function looksLikeWorkspaceRelativePath(ref) {
+    const t = ref.trim();
+    return (t.startsWith("project/") ||
+        t.startsWith("./project/") ||
+        t.startsWith("/project/") ||
+        t.startsWith("xg-cwork-im/") ||
+        t.startsWith("./xg") ||
+        t.startsWith("/workspace/"));
+}
+function extractPathFromMediaError(raw) {
+    const m = /:\s*(\S+)\s*$/.exec(raw.trim());
+    return m?.[1];
+}
+//# sourceMappingURL=user-facing-errors.js.map

package/dist/src/user-facing-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-facing-errors.js","sourceRoot":"","sources":["../../src/user-facing-errors.ts"],"names":[],"mappings":"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"}

package/dist/src/user-facing-errors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=user-facing-errors.test.d.ts.map

package/dist/src/user-facing-errors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-facing-errors.test.d.ts","sourceRoot":"","sources":["../../src/user-facing-errors.test.ts"],"names":[],"mappings":""}

package/dist/src/user-facing-errors.test.js

@@ -0,0 +1,62 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { buildTerminalUserMessage, formatUserFacingMediaDeliverError, isAttachmentBlockedErrorMessage, isContextOverflowErrorMessage, } from "./user-facing-errors.js";
+describe("isContextOverflowErrorMessage", () => {
+    it("detects context-overflow-precheck log style", () => {
+        assert.equal(isContextOverflowErrorMessage("[context-overflow-precheck] overflowTokens=72970 estimatedPromptTokens=328586"), true);
+    });
+});
+describe("isAttachmentBlockedErrorMessage", () => {
+    it("detects blocked attachment roots", () => {
+        assert.equal(isAttachmentBlockedErrorMessage("Blocked attachment path outside allowed roots: ./project/a.png"), true);
+        assert.equal(isAttachmentBlockedErrorMessage("Local media path is not under an allowed directory: /Users/x/ws/project/a.png"), true);
+    });
+});
+describe("buildTerminalUserMessage", () => {
+    it("refines runtime_error for attachment block", () => {
+        const msg = buildTerminalUserMessage("runtime_error", {
+            errorMessage: "Blocked attachment path outside allowed roots: ./project/x.png",
+        });
+        assert.ok(msg.includes("附件未能加载"));
+        assert.ok(!msg.includes("Blocked attachment"));
+    });
+    it("refines runtime_error for context overflow", () => {
+        const msg = buildTerminalUserMessage("runtime_error", {
+            errorMessage: "[context-overflow-precheck] overflowTokens=100",
+        });
+        assert.ok(msg.includes("上下文过大"));
+    });
+    it("refines no_reply for zero_deliver", () => {
+        const msg = buildTerminalUserMessage("no_reply", { noReplyCause: "zero_deliver" });
+        assert.ok(msg.includes("未向 IM 发送"));
+        assert.ok(!msg.includes("请"));
+    });
+    it("does not include operational suggestions in terminal copy", () => {
+        const cases = [
+            buildTerminalUserMessage("runtime_error"),
+            buildTerminalUserMessage("precheck_error"),
+            buildTerminalUserMessage("no_reply"),
+        ];
+        for (const msg of cases) {
+            assert.ok(!/请(稍后|发送|联系|确认|新开|换)/.test(msg));
+            assert.ok(!msg.includes("管理员"));
+        }
+    });
+});
+describe("formatUserFacingMediaDeliverError", () => {
+    it("maps workspace-relative media read failure", () => {
+        const msg = formatUserFacingMediaDeliverError(new Error("[cwork_im] 无法读取媒体（请使用 http(s)...）: project/202607/207/artifacts/daily/summary.md"), ["project/202607/207/artifacts/daily/summary.md"]);
+        assert.ok(msg.includes("未能将文件发送到 IM"));
+        assert.ok(msg.includes("project/"));
+        assert.ok(!msg.includes("[cwork_im]"));
+        assert.ok(!msg.includes("http(s)"));
+        assert.ok(!/请(稍后|发送|联系|确认)/.test(msg));
+    });
+    it("maps enoent", () => {
+        const msg = formatUserFacingMediaDeliverError(new Error("ENOENT: no such file"), [
+            "./project/a.md",
+        ]);
+        assert.ok(msg.includes("找不到"));
+    });
+});
+//# sourceMappingURL=user-facing-errors.test.js.map

package/dist/src/user-facing-errors.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-facing-errors.test.js","sourceRoot":"","sources":["../../src/user-facing-errors.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xgjktech/xg_cwork_im",
-  "version": "1.14.6",
+  "version": "1.15.1",
   "description": "XG CWork IM channel plugin for OpenClaw",
   "keywords": [
     "bot",
@@ -22,7 +22,7 @@
     "build": "tsc -p tsconfig.json",
     "type-check": "tsc -p tsconfig.json --noEmit",
     "lint": "tsc -p tsconfig.json --noEmit",
-    "test": "npm run build && node --test dist/src/inbound-terminal-state.test.js dist/src/deliver-text.test.js dist/src/agent-context-types.test.js dist/src/block-streaming-config.test.js dist/src/per-message-fallback-notice.test.js",
+    "test": "npm run build && node --test dist/src/inbound-terminal-state.test.js dist/src/user-facing-errors.test.js dist/src/deliver-text.test.js dist/src/agent-context-types.test.js dist/src/block-streaming-config.test.js dist/src/per-message-fallback-notice.test.js dist/src/thinking-ws-progress.test.js dist/src/resource-file.test.js",
     "install:prod": "npm install --omit=dev",
     "prepublishOnly": "npm run build"
   },