@jeik/dingtalk-connector 0.8.27-fix3 → 0.8.28

package/CHANGELOG.md

@@ -5,6 +5,55 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.28] - 2026-07-25
+
+### 主题
+
+基于**官方最新 0.8.24** 继续做社区增强：把连接做稳、消息少丢、错误提示更清楚。少折腾、多好用。
+
+### 基于官方 0.8.24 吸收的能力
+
+- 更稳的长连接思路：连接建立后再挂心跳相关监听，减少「看起来连着、其实收不到消息」的假死重连
+- 机器人忙着回上一条时，处理过程中也会保持连接活跃，长回复不容易被中途掐断
+- 上游 SDK 刷屏日志过滤，控制台更干净，少误判成故障
+- 空回复时的友好提示（尤其是群聊配置不当的情况）
+
+> 说明：官方给其他插件用的「卡片创建/更新开放接口」本版**未合入**（对话体验不依赖它）。需要时可后续单独加。
+
+### 本版重点优化（效果向）
+
+**1. 长连接更稳**
+- 只有钉钉确认「这条连接可以收机器人消息」之后，才对外显示已连接
+- 连不上会自动多试几轮，而不是假装在线
+- 正常使用时尽量不乱拆连接，减少「连发好几条消息完全没反应」
+
+**2. 消息更少丢、反馈更快**
+- 消息进队成功后再向钉钉确认已收到，失败可让平台重发，避免「确认了却其实没处理」
+- 同一会话排队处理更可靠：任务进行中再发消息，更容易马上出现「已排队 / 处理中」提示和思考中表情
+- 单条任务卡住太久会自动放开队列，避免后面消息永远等不到
+
+**3. 模型出错时体验更好**
+- 上游欠费、无可用线路、503 等失败时，群聊/私聊都更容易定格成清晰中文错误卡片
+- 减少卡在「正在召唤大模型…」或莫名「思考完成」却看不到原因的情况
+- 错误结束后继续发消息，响应能力明显好于旧版
+
+**4. 社区原有增强（继续保留）**
+- 即时首响卡片、大段答案独立答案卡、图片/本地图修复、中文错误映射、强制群聊正常回复合流等
+
+### 安装
+
+```bash
+npx -y @jeik/dingtalk-connector@0.8.28 install --force
+openclaw gateway restart
+```
+
+或：
+
+```bash
+openclaw plugins install @jeik/dingtalk-connector@0.8.28 --force
+openclaw gateway restart
+```
+
 ## [0.8.26] - 2026-07-25
 
 ### 修复与优化 / Fixed & Improved

package/README.en.md

@@ -1,10 +1,10 @@
 <div align="center">
   <img alt="DingTalk" src="https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-openclaw-connector/main/docs/images/dingtalk.svg" width="72" height="72" />
   <h1>dingtalk-openclaw-connector（Community Maintained Fork）</h1>
-  <p>Community maintained fork of the official <strong>v0.8.20</strong> release, tracking and fixing bugs the official team hasn't addressed.<br/>
-  Identical to the official release in functionality — only community-critical fixes applied.</p>
+  <p>Community-enhanced fork based on official <strong>v0.8.24</strong>: adopts official long-connection improvements, plus stronger message delivery, queue feedback, and error-card UX.<br/>
+  Keeps community extras (images, answer cards, first-response UX) and continues to fix issues not yet covered upstream.</p>
 
-  <p><strong>Current published release: <a href="https://www.npmjs.com/package/@jeik/dingtalk-connector">@jeik/dingtalk-connector</a> v0.8.21-fix49</strong> (production-stable; install: <code>npx -y @jeik/dingtalk-connector install</code>).</p>
+  <p><strong>Current release: <a href="https://www.npmjs.com/package/@jeik/dingtalk-connector">@jeik/dingtalk-connector</a> v0.8.28</strong> (recommended for production; install: <code>npx -y @jeik/dingtalk-connector@0.8.28 install --force</code>).</p>
 
   <p>
     <a href="https://www.npmjs.com/package/@jeik/dingtalk-connector"><img src="https://img.shields.io/npm/v/@jeik/dingtalk-connector.svg?style=flat&colorA=18181B&colorB=28CF8D" alt="npm version" /></a>
@@ -23,52 +23,45 @@
 
 ## 🔧 Recent Updates
 
-### 🚀 v0.8.21-fix49 · 2026-07-21 (current)
+### 🚀 v0.8.28 · 2026-07-25 (current)
 
-**Theme: message tool answer card by default (toggle)**
+**Theme: based on official 0.8.24 · steadier connection · fewer lost messages · clearer errors**
 
-| | Change |
-|--|--------|
-| ✨ **`messageAnswerCard`** | **Default `true`**: message body uses static answer card; set `false` for plain text/markdown |
-| 🔧 **Registered** | `schema` + `openclaw.plugin.json` (channels / accounts / uiHints) |
-| 📎 **Independent** | Separate from session-stream `answerCard`; media still uses normal APIs |
+Built on community enhancements, aligned with official **0.8.24** connection work, and focused on real UX: “sent but no reply”, stuck error cards, and missing “queued” feedback.
 
-```bash
-npx -y @jeik/dingtalk-connector install --force && openclaw gateway restart
-```
-
-### 📦 v0.8.21-fix47 · 2026-07-20
-
-`file://` no longer misclassified as remote (grey-image fix).
+#### From official 0.8.24
 
-### 📦 v0.8.21-fix46 · 2026-07-20
+- More reliable long-connection setup and keepalive (fewer “connected but silent” cases)
+- Long AI runs less likely to get cut mid-task by connection flapping
+- Cleaner console logs for easier ops
 
-Always-on local MD image diagnostics.
+#### Extra community improvements (what you’ll notice)
 
-### 📦 v0.8.21-fix45 · 2026-07-20
+| Experience | Effect |
+|------------|--------|
+| 🔗 **Connection** | Marks “connected” only when the bot can actually receive messages; auto-retries instead of faking online |
+| 📩 **Fewer lost messages** | Much better after errors, after a reply finishes, or when sending several messages quickly |
+| ⏳ **Queue feedback** | While the previous message is still running, new messages more reliably show “queued / processing” + thinking reaction |
+| ⚠️ **Model failures** | Billing / no channel / 503-style failures settle into clear Chinese error cards instead of spinning forever |
+| 🃏 **Answer cards & images** | Existing community answer-card and full image-path fixes remain |
 
-Image + download link one bubble · only `![]` · quote cache · residual false-positive fix.
-
-### 📦 v0.8.21-fix38 · 2026-07-20
+```bash
+npx -y @jeik/dingtalk-connector@0.8.28 install --force && openclaw gateway restart
+```
 
-Remote `media` download-then-upload.
+### 📦 v0.8.26 · 2026-07-25
 
-### 📦 v0.8.21-fix37 · 2026-07-20
+Stricter outbound target ID rules (keep `==` suffixes and case).
 
-Local images (incl. `/mnt`) · `messageImageMd` · LocalImage diagnostics.
+### 📦 v0.8.25 · 2026-07-24
 
----
+Sender role/title identity; bare DingTalk IDs as direct chat.
 
-### Earlier releases (summary)
+### 📦 v0.8.21-fix49 and earlier
 
-| Date | Highlights |
-|------|------------|
-| 2026-07-14 | **fix31** — serial stream queue; dual-card threshold; error mapping; ACK UX; wizard accountId; drop `cardToolVar`/`cardProcessVar` |
-| 2026-06-29 | Answer-card 500 fix; threshold 500; deferred card create; empty message-card fix; tool progress; wizard upgrades |
-| 2026-06-28 | npm `@jeik/dingtalk-connector`; premature finalization fix |
-| 2026-05 | MD images; multi-turn spam; 4.29 empty reply; WS phantom reconnect |
+Answer cards, image path fixes, streaming finalize, Chinese error mapping — see [CHANGELOG.md](CHANGELOG.md).
 
-Full log: [CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md) · [Release fix48](docs/RELEASE_NOTES_V0.8.21-fix49.md)
+Full log: [CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md)
 
 ---
 

package/README.md

@@ -1,10 +1,10 @@
 <div align="center">
   <img alt="DingTalk" src="https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-openclaw-connector/main/docs/images/dingtalk.svg" width="72" height="72" />
   <h1>dingtalk-openclaw-connector（社区维护版）</h1>
-  <p>基于官方 <strong>v0.8.20</strong> 的社区维护版本，由社区持续跟进修复官方无暇处理的 Bug。<br/>
-  功能与官方完全一致，拥有最快的修复速度，及时合并官方pr和个人发现的bug和社区急需的 Bug。</p>
+  <p>基于官方最新 <strong>v0.8.24</strong> 的社区增强版：吸收官方长连接改进，并重点优化消息接收、排队反馈与模型错误展示。<br/>
+  保留社区在图片、答案卡、首响体验上的增强，持续修官方暂未覆盖的实际使用问题。</p>
 
-  <p><strong>当前发布版：<a href="https://www.npmjs.com/package/@jeik/dingtalk-connector">@jeik/dingtalk-connector</a> v0.8.26</strong>（稳定生产可用；一键安装：`npx -y @jeik/dingtalk-connector install`；本地 tgz：`openclaw plugins install ./jeik-dingtalk-connector-0.8.26.tgz --force`）</p>
+  <p><strong>当前发布版：<a href="https://www.npmjs.com/package/@jeik/dingtalk-connector">@jeik/dingtalk-connector</a> v0.8.28</strong>（推荐生产；一键安装：`npx -y @jeik/dingtalk-connector@0.8.28 install --force`）</p>
 
   <p>
     <a href="https://www.npmjs.com/package/@jeik/dingtalk-connector"><img src="https://img.shields.io/npm/v/@jeik/dingtalk-connector.svg?style=flat&colorA=18181B&colorB=28CF8D" alt="npm version" /></a>
@@ -23,60 +23,45 @@
 
 ## 🔧 最近更新
 
-### 🚀 v0.8.26 · 2026-07-25（当前正式版）
+### 🚀 v0.8.28 · 2026-07-25（当前正式版）
 
-**主题：目标 ID 填写约束强化 + 特殊字符后缀与大小写保留**
+**主题：基于官方 0.8.24 · 长连接更稳 · 消息少丢 · 错误提示更清楚**
 
-| | 改动 |
-|--|------|
-| 🎯 **目标 ID 约束强化** | 出站消息回复指引强化，约束 target ID 完整保留 Base64/特殊字符后缀（如 `==`、`=`）与大小写 |
+本版在社区增强能力之上，对齐官方 **0.8.24** 的连接改进，并重点打磨「发了消息却没反应」「错误卡卡住」「排队提示不出现」等真实使用体验。
 
-| | 改动 |
-|--|------|
-| 👤 **发送人岗位与身份** | 自动前置推送发送人真名、岗位 (Title)、入职时间及老板/主管角色信息 |
-| 🎯 **`targets` 解析修复** | 无前缀裸钉钉用户 ID 自动智能推导为 `direct`（单聊）类型 |
-| 🛠️ **消息处理增强** | 消息处理器底层逻辑优化与工具库稳定性提升 |
+#### 基于官方 0.8.24 吸收了什么
 
-```bash
-npx -y @jeik/dingtalk-connector install --force && openclaw gateway restart
-```
-
-### 📦 v0.8.21-fix49 · 2026-07-21
-
-`message` 工具默认答案卡（可关）；增强模板字段一致。
-
-### 📦 v0.8.21-fix47 · 2026-07-20
-
-`file://` 本地图误判远程修复（不再 `fetch failed` 灰图）。
+- 更稳妥的长连接建立与保活方式，减少假死、误重连
+- 机器人处理长任务时连接不易被中途掐断
+- 控制台少刷无用日志，排障更清爽
 
-### 📦 v0.8.21-fix46 · 2026-07-20
+#### 社区本版额外优化（你会感受到的效果）
 
-本地 MD 图灰图诊断日志（LocalImage / MediaIdTrace）。
-
-### 📦 v0.8.21-fix45 · 2026-07-20
-
-图 + 下载链接单气泡 · 只认 `![]` · 引用卡片缓存 · residual 误报修复。
+| 体验 | 效果 |
+|------|------|
+| 🔗 **连接更靠谱** | 只有真正能收消息时才显示「已连接」；连不上会自动多试几轮，而不是假装在线 |
+| 📩 **消息更少丢** | 明显缓解：连发多条、错误回复后、任务刚结束时「发了没进网关」的情况 |
+| ⏳ **排队反馈更及时** | 上一条还在处理时再发，更容易马上看到「已排队 / 处理中」和思考中表情 |
+| ⚠️ **模型故障更好懂** | 欠费、无可用线路、503 等失败时，卡片更容易定格成中文说明，少卡在「正在召唤大模型」 |
+| 🃏 **答案卡 / 图片等** | 社区原有大段答案独立卡片、图片全路径修复等能力继续保留 |
 
-### 📦 v0.8.21-fix38 · 2026-07-20
+```bash
+npx -y @jeik/dingtalk-connector@0.8.28 install --force && openclaw gateway restart
+```
 
-message 远程 `media` 下载上传。
+### 📦 v0.8.26 · 2026-07-25
 
-### 📦 v0.8.21-fix37 · 2026-07-20
+目标 ID 填写约束（保留 `==` 等后缀与大小写）。
 
-本地图（含 `/mnt`）· `messageImageMd` · LocalImage 诊断日志。
+### 📦 v0.8.25 · 2026-07-24
 
----
+发送人岗位与身份信息；裸钉钉 ID 推导为单聊。
 
-### 更早版本（摘要）
+### 📦 v0.8.21-fix49 及更早
 
-| 日期 | 版本 / 要点 |
-|------|-------------|
-| 2026-07-14 | **fix31** — 流式串行队列防半截；双卡 `answerActToken`；错误中文映射；召唤 ACK；安装向导 accountId 推导；去掉 `cardToolVar`/`cardProcessVar` |
-| 2026-06-29 | 答案卡 500 修复；阈值默认 500；延迟建卡；message 空卡修复；答案卡模式；工具进度展示；过程消息误终稿修复；安装向导增强 |
-| 2026-06-28 | 上线 npm `@jeik/dingtalk-connector`；过程消息提前定稿修复 |
-| 2026-05 | MD 直链/本地图；多轮刷屏；4.29+ 无文本输出；WebSocket 幻影重连 |
+答案卡、图片全路径修复、流式定稿、中文错误映射等——详见 [CHANGELOG.md](CHANGELOG.md)。
 
-完整说明：[CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md) · [Release fix48](docs/RELEASE_NOTES_V0.8.21-fix49.md)
+完整说明：[CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md)
 
 ---
 

package/dist/background-work-Cxb4b-91.mjs

@@ -0,0 +1,42 @@
+//#region src/utils/background-work.ts
+let activeCount = 0;
+const listeners = /* @__PURE__ */ new Set();
+function getActiveBackgroundWorkCount() {
+	return activeCount;
+}
+/** 订阅计数变化；返回取消订阅函数 */
+function onBackgroundWorkCountChange(listener) {
+	listeners.add(listener);
+	return () => {
+		listeners.delete(listener);
+	};
+}
+function notify() {
+	for (const listener of listeners) try {
+		listener(activeCount);
+	} catch {}
+}
+/**
+* 跟踪一个后台 Promise：开始 +1，settle -1。
+* 重复 settle 安全（只减一次）。
+*/
+function trackBackgroundWork(work, label) {
+	activeCount += 1;
+	notify();
+	let settled = false;
+	const done = () => {
+		if (settled) return;
+		settled = true;
+		activeCount = Math.max(0, activeCount - 1);
+		notify();
+	};
+	work.then(done, done);
+	if (label && typeof process !== "undefined" && process.env?.DINGTALK_DEBUG_QUEUE === "1") {
+		console.log(`[DingTalk][bgWork] +1 label=${label} count=${activeCount}`);
+		work.finally(() => {
+			console.log(`[DingTalk][bgWork] -1 label=${label} count=${activeCount}`);
+		});
+	}
+}
+//#endregion
+export { onBackgroundWorkCountChange as n, trackBackgroundWork as r, getActiveBackgroundWorkCount as t };

package/dist/card-content-cache-c4Ls96eJ.mjs

@@ -0,0 +1,2 @@
+import { r as rememberCardContent } from "./card-content-cache-bDQFz2u8.mjs";
+export { rememberCardContent };

package/dist/chunk-upload-PwhogwfE.mjs

@@ -0,0 +1,2 @@
+import { a as uploadLargeFileByChunks } from "./chunk-upload-BE71drPg.mjs";
+export { uploadLargeFileByChunks };

package/dist/{common-DE0gd0Jg.mjs → common-BZiVgd3A.mjs}

@@ -1,6 +1,6 @@
 import { t as createLogger } from "./logger-mZ9OSbmD.mjs";
 import { r as dingtalkUploadHttp } from "./http-client-DFWZgO1n.mjs";
-import { t as CHUNK_CONFIG } from "./chunk-upload-BBQgGtcZ.mjs";
+import { t as CHUNK_CONFIG } from "./chunk-upload-BE71drPg.mjs";
 import * as fs from "fs";
 import * as path from "path";
 import FormData from "form-data";
@@ -48,7 +48,7 @@ async function uploadMediaToDingTalk(filePath, mediaType, oapiToken, maxSize = 2
 		if ((mediaType === "video" || mediaType === "file") && fileSize > CHUNK_CONFIG.SIZE_THRESHOLD) {
 			log?.info?.(`文件超过 20MB，使用分块上传：${absPath} (${fileSizeMB}MB)`);
 			try {
-				const { uploadLargeFileByChunks } = await import("./chunk-upload-DaLXXZH3.mjs");
+				const { uploadLargeFileByChunks } = await import("./chunk-upload-PwhogwfE.mjs");
 				const downloadCode = await uploadLargeFileByChunks(absPath, mediaType, oapiToken, debugEnabled);
 				if (downloadCode) {
 					log?.info?.(`分块上传成功：${absPath}, download_code: ${downloadCode}`);

package/dist/{common-B_A78n8u.mjs → common-DgL28gCZ.mjs}

@@ -1,2 +1,2 @@
-import { i as VIDEO_MARKER_PATTERN, r as FILE_MARKER_PATTERN, t as AUDIO_MARKER_PATTERN } from "./common-DE0gd0Jg.mjs";
+import { i as VIDEO_MARKER_PATTERN, r as FILE_MARKER_PATTERN, t as AUDIO_MARKER_PATTERN } from "./common-BZiVgd3A.mjs";
 export { AUDIO_MARKER_PATTERN, FILE_MARKER_PATTERN, VIDEO_MARKER_PATTERN };