@jeik/dingtalk-connector 0.8.27 → 0.8.29

package/CHANGELOG.md

@@ -5,6 +5,54 @@ 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.29] - 2026-07-25
+
+### 主题
+
+正式版加固：默认日志更轻、排障只靠配置 `debug: true`；继承 0.8.28 连接/消息/错误卡能力。
+
+### 变更
+
+- 🧹 **默认静默诊断刷屏** — 无图文本回复不再输出 LocalImage / MediaIdTrace / CardCache / Quote 成功路径
+- 🔍 **debug 配置统一开关** — 顶层或账号 `"debug": true` 打开连接摘要、图片 mediaId、引用回填、队列计数等详细日志；**不再依赖环境变量**
+- 📚 **文档** — 安装命令精简为三条递进指导；README 中英同步至 0.8.29
+
+### 继承（0.8.28）
+
+- 基于官方 0.8.24 的长连接更稳、消息少丢、模型错误中文定稿、本仓库独有答案卡/图片能力
+
+### 安装
+
+```bash
+# 1）装最新
+openclaw plugins install @jeik/dingtalk-connector --force && openclaw gateway restart
+
+# 2）若不是最新，指定版本
+openclaw plugins install @jeik/dingtalk-connector@0.8.29 --force && openclaw gateway restart
+
+# 3）仍失败时走 npm 官方源
+NPM_CONFIG_REGISTRY=https://registry.npmjs.org openclaw plugins install @jeik/dingtalk-connector@0.8.29 --force && openclaw gateway restart
+```
+
+## [0.8.28] - 2026-07-25
+
+### 主题
+
+基于**官方最新 0.8.24**，并保留**本仓库独有**优化：连接更稳、消息少丢、错误提示更清楚。
+
+### 本版重点
+
+- 长连接：能收消息才显示已连接；少假死误重连
+- 消息：进队后再 ACK；排队反馈更及时
+- 错误：503 / 欠费 / 无通道等中文定稿，少卡「正在召唤大模型」
+- 本仓库独有：答案卡、图片全路径、首响等
+
+### 安装
+
+```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 <strong>this repo’s unique</strong> 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.29</strong></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,31 @@
 
 ## 🔧 Recent Updates
 
-### 🚀 v0.8.21-fix49 · 2026-07-21 (current)
+### 🚀 v0.8.29 · 2026-07-25 (current)
 
-**Theme: message tool answer card by default (toggle)**
+**Theme: production hardening · quieter logs · debug config only**
 
-| | 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 **0.8.28** (steadier connection / fewer lost messages / clearer error cards):
+
+| Experience | Effect |
+|------------|--------|
+| 🧹 **Quieter by default** | No LocalImage / MediaIdTrace / CardCache spam on normal text replies |
+| 🔍 **Simple debug** | Set `"debug": true` for connection, image, quote, and queue diagnostics (no env vars) |
+| 🔗 **Connection / queue** | Connected only when messages can be received; better multi-send and post-error recovery |
+| ⚠️ **Model failures** | 503 / billing / no-channel settle to clear Chinese cards instead of spinning forever |
+| 🃏 **This repo’s unique extras** | Answer cards, full image paths, first-response UX remain |
 
 ```bash
-npx -y @jeik/dingtalk-connector install --force && openclaw gateway restart
+openclaw plugins install @jeik/dingtalk-connector --force && openclaw gateway restart
 ```
 
-### 📦 v0.8.21-fix47 · 2026-07-20
-
-`file://` no longer misclassified as remote (grey-image fix).
-
-### 📦 v0.8.21-fix46 · 2026-07-20
-
-Always-on local MD image diagnostics.
+### 📦 v0.8.28 · 2026-07-25
 
-### 📦 v0.8.21-fix45 · 2026-07-20
+Official 0.8.24-aligned connection & delivery hardening (included in 0.8.29).
 
-Image + download link one bubble · only `![]` · quote cache · residual false-positive fix.
+### 📦 v0.8.26 / 0.8.25 and earlier
 
-### 📦 v0.8.21-fix38 · 2026-07-20
-
-Remote `media` download-then-upload.
-
-### 📦 v0.8.21-fix37 · 2026-07-20
-
-Local images (incl. `/mnt`) · `messageImageMd` · LocalImage diagnostics.
-
----
-
-### Earlier releases (summary)
-
-| 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 |
-
-Full log: [CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md) · [Release fix48](docs/RELEASE_NOTES_V0.8.21-fix49.md)
+Target ID rules, sender identity, answer cards, image fixes — see [CHANGELOG.md](CHANGELOG.md).
 
 ---
 
@@ -239,68 +218,43 @@ Community contributions (features & bug fixes) are always welcome — submit a P
 
 | Item | Description |
 |------|-------------|
-| Base | Official v0.8.20, fully identical features |
-| Fixes | Bugs the official team hasn't addressed (see recent fixes above) |
+| Base | Aligned with official **v0.8.24** long-connection work + this repo’s unique extras |
+| Fixes | Silent connection, lost messages, stuck error cards, grey images, etc. |
 | Maintenance | Community maintained, continuously tracking official updates |
 
 ---
 
 ## Requirements & Installation
 
-Before you start, make sure you have:
-
-- **OpenClaw**: Installed and running properly. Visit the [OpenClaw website](https://openclaw.ai/) for details.
-- **Version**: OpenClaw ≥ **2026.4.9**. Check with `openclaw -v`.
-
-> If below this version, upgrade with: `npm install -g openclaw`
-
----
-
-## Installation
-
-> Same channel id as the official plugin (`dingtalk-connector`); `--force` overwrites in place — **no uninstall** needed.  
-> **Current stable: `0.8.21-fix31`** (npm `latest`). Always run `openclaw gateway restart` after install/upgrade.
-
-### Option 1: npm (recommended)
+- **OpenClaw** installed and running ([website](https://openclaw.ai/))
+- **Version**: OpenClaw ≥ **2026.4.9** (`openclaw -v`)
+- Same channel id as official (`dingtalk-connector`); `--force` overwrites — **no uninstall** needed
+- Always `openclaw gateway restart` after install/upgrade
 
 Package: [`@jeik/dingtalk-connector`](https://www.npmjs.com/package/@jeik/dingtalk-connector)
 
-**1) One-command QR install** (bot → credentials → plugin → config):
+### Three install commands (try in order)
 
 ```bash
-npx -y @jeik/dingtalk-connector install
+# 1) Install latest
+openclaw plugins install @jeik/dingtalk-connector --force && openclaw gateway restart
 
-# force overwrite when a local dingtalk-connector already exists
-npx -y @jeik/dingtalk-connector install --force
-```
-
-**2) Plugin only** (credentials already set / manual setup):
+# 2) If you did not get the latest, pin the version
+openclaw plugins install @jeik/dingtalk-connector@0.8.29 --force && openclaw gateway restart
 
-```bash
-openclaw plugins install @jeik/dingtalk-connector --force
-openclaw gateway restart
+# 3) If it still fails, force the official npm registry
+NPM_CONFIG_REGISTRY=https://registry.npmjs.org openclaw plugins install @jeik/dingtalk-connector@0.8.29 --force && openclaw gateway restart
 ```
 
-**3) Upgrade to latest:**
+> Optional QR wizard: `npx @jeik/dingtalk-connector install --force`
 
-```bash
-openclaw plugins install @jeik/dingtalk-connector --force
-openclaw gateway restart
-```
-
-### Option 2: Local tgz / from source (dev / offline)
+### Local tgz / from source (dev / offline)
 
 ```bash
 git clone https://github.com/jeikl/dingtalk-openclaw-connector-fix-Community.git
 cd dingtalk-openclaw-connector-fix-Community
-# optional: pin a release (this is a git tag, not a branch)
-# git fetch --tags && git checkout v0.8.21-fix31
-
 npm install && npm run build && npm pack
-# → jeik-dingtalk-connector-0.8.21-fix31.tgz
-
-openclaw plugins install ./jeik-dingtalk-connector-0.8.21-fix31.tgz --force
-openclaw gateway restart
+openclaw plugins install ./jeik-dingtalk-connector-0.8.29.tgz --force && openclaw gateway restart
 ```
 
 ### Smoke check
@@ -308,9 +262,13 @@ openclaw gateway restart
 ```bash
 openclaw -v
 openclaw plugins list
-# Send a DingTalk message — you should first see "🦸 正在召唤大模型…" then streaming reply
+# Send a DingTalk message — first “summoning model…”, then streaming / answer card
 ```
 
+### Debug logs
+
+Set `"debug": true` under `channels.dingtalk-connector` (or a specific account), then restart the gateway. No environment variables required.
+
 ---
 
 ## Usage Guide

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.29</strong></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,31 @@
 
 ## 🔧 最近更新
 
-### 🚀 v0.8.26 · 2026-07-25（当前正式版）
+### 🚀 v0.8.29 · 2026-07-25（当前正式版）
 
-**主题：目标 ID 填写约束强化 + 特殊字符后缀与大小写保留**
+**主题：正式加固 · 日志更干净 · 排障只开 debug**
 
-| | 改动 |
-|--|------|
-| 🎯 **目标 ID 约束强化** | 出站消息回复指引强化，约束 target ID 完整保留 Base64/特殊字符后缀（如 `==`、`=`）与大小写 |
+在 **0.8.28**（连接更稳 / 消息少丢 / 错误卡可定稿）基础上再打磨：
 
-| | 改动 |
-|--|------|
-| 👤 **发送人岗位与身份** | 自动前置推送发送人真名、岗位 (Title)、入职时间及老板/主管角色信息 |
-| 🎯 **`targets` 解析修复** | 无前缀裸钉钉用户 ID 自动智能推导为 `direct`（单聊）类型 |
-| 🛠️ **消息处理增强** | 消息处理器底层逻辑优化与工具库稳定性提升 |
+| 体验 | 效果 |
+|------|------|
+| 🧹 **默认日志更轻** | 无图正常回复不再刷 LocalImage / MediaIdTrace / CardCache |
+| 🔍 **排障更简单** | 配置 `"debug": true` 即输出连接、图片、引用、队列详细日志（无需环境变量） |
+| 🔗 **连接 / 队列** | 继承 0.8.28：能收消息才算在线；连发、错误后再发更稳；排队反馈更及时 |
+| ⚠️ **模型故障** | 503 / 欠费 / 无通道等更容易定格中文错误，少卡「正在召唤大模型」 |
+| 🃏 **本仓库独有** | 答案卡、图片全路径、首响体验等继续保留 |
 
 ```bash
-npx -y @jeik/dingtalk-connector install --force && openclaw gateway restart
+openclaw plugins install @jeik/dingtalk-connector --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 误报修复。
-
-### 📦 v0.8.21-fix38 · 2026-07-20
-
-message 远程 `media` 下载上传。
+### 📦 v0.8.28 · 2026-07-25
 
-### 📦 v0.8.21-fix37 · 2026-07-20
+基于官方 0.8.24 的长连接与消息体验加固（当前能力已并入 0.8.29）。
 
-本地图（含 `/mnt`）· `messageImageMd` · LocalImage 诊断日志。
+### 📦 v0.8.26 / 0.8.25 及更早
 
----
-
-### 更早版本（摘要）
-
-| 日期 | 版本 / 要点 |
-|------|-------------|
-| 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) · [FIXES.md](FIXES.md) · [Release fix48](docs/RELEASE_NOTES_V0.8.21-fix49.md)
+目标 ID 约束、发送人身份、答案卡、图片修复等——详见 [CHANGELOG.md](CHANGELOG.md)。
 
 ---
 
@@ -212,9 +183,23 @@ message 远程 `media` 下载上传。
 | `answerCardTemplateId` | string | `d246b7f5-1783-4e9b-bb46-bef52d63050e.schema` | 答案静态卡模板 |
 | `messageAnswerCard` | boolean | **true** | message 工具正文走答案静态卡；`false`=普通消息 |
 | `messageImageMd` | boolean | **false** | message 图文：`false` 文图分开；`true` 可合并 markdown |
+| `debug` | boolean | **false** | 详细诊断日志（连接/图片 mediaId/引用回填/队列）。**日常关闭**；排障时顶层或某账号设 `true`，改完 `openclaw gateway restart` |
 
 > `answerCard` = 对话流式收尾；`messageAnswerCard` = message 工具外发。
 
+**临时开排障日志示例：**
+
+```json
+"channels": {
+  "dingtalk-connector": {
+    "enabled": true,
+    "clientId": "…",
+    "clientSecret": "…",
+    "debug": true
+  }
+}
+```
+
 ---
 
 ## 🎯 回复标记 + 答案卡 + 工具进度（核心增强）
@@ -251,79 +236,51 @@ message 远程 `media` 下载上传。
 
 | 项目 | 说明 |
 |------|------|
-| 基础版本 | 官方 v0.8.20，功能完全一致 |
-| 修复内容 | 官方一直不修的 Bug（见上方最近修复） |
+| 基础版本 | 对齐官方 **v0.8.24** 长连接能力，并叠加本仓库独有优化 |
+| 修复内容 | 连接假死、消息丢失、错误卡卡住、图片灰图等实际使用问题 |
 | 维护方式 | 社区维护，持续跟进官方更新 |
 
 ---
 
 ## 安装与要求
 
-开始之前，请确保：
-
-- **OpenClaw**：已安装并正常运行。详情请访问 [OpenClaw 官网](https://openclaw.ai/)
-- **版本要求**：OpenClaw ≥ **2026.4.9**，通过 `openclaw -v` 查看
-
-> 如低于此版本，执行 `npm install -g openclaw` 升级。
-
----
-
-## 安装
-
-> 与官方插件同 channel id（`dingtalk-connector`），`--force` 直接覆盖更新，**无需先卸载**官方版或旧版。  
-> **当前稳定版：`0.8.21-fix31`**（npm `latest` 已指向本版）。安装/更新后**必须** `openclaw gateway restart`。
-
-### 方式一：npm（推荐）
+- **OpenClaw** 已安装并正常运行（[官网](https://openclaw.ai/)）
+- **版本**：OpenClaw ≥ **2026.4.9**（`openclaw -v`）
+- 与官方插件同 channel id（`dingtalk-connector`），`--force` 可直接覆盖，**无需先卸载**
+- 安装/更新后**必须** `openclaw gateway restart`
 
 包名：[`@jeik/dingtalk-connector`](https://www.npmjs.com/package/@jeik/dingtalk-connector)
 
-**1）一键扫码安装**（推荐：创建机器人 → 取凭证 → 装插件 → 写配置）：
+### 三条安装命令（按顺序试）
 
 ```bash
-npx -y @jeik/dingtalk-connector install
+# 1）装最新
+openclaw plugins install @jeik/dingtalk-connector --force && openclaw gateway restart
 
-# 已有 dingtalk-connector / 装不上时强制覆盖
-npx -y @jeik/dingtalk-connector install --force
-```
-
-**2）只装插件**（凭证已配好，或走手动配置文档）：
+# 2）若装到的不是最新，指定版本号
+openclaw plugins install @jeik/dingtalk-connector@0.8.29 --force && openclaw gateway restart
 
-```bash
-openclaw plugins install @jeik/dingtalk-connector --force
-openclaw gateway restart
+# 3）若仍装不了，强制走 npm 官方源
+NPM_CONFIG_REGISTRY=https://registry.npmjs.org openclaw plugins install @jeik/dingtalk-connector@0.8.29 --force && openclaw gateway restart
 ```
 
-**3）升级到最新版：**
+> 一键扫码建机器人（可选）：`npx @jeik/dingtalk-connector install --force`
 
-```bash
-openclaw plugins install @jeik/dingtalk-connector --force
-openclaw gateway restart
-```
-
-### 方式二：本地 tgz / 源码构建（开发、离线、预发验证）
+### 本地 tgz / 源码（开发、离线）
 
 ```bash
 git clone https://github.com/jeikl/dingtalk-openclaw-connector-fix-Community.git
 cd dingtalk-openclaw-connector-fix-Community
-# 可选：钉到某次发布（这是 git tag，不是分支；clone 后可直接 checkout）
-# git fetch --tags && git checkout v0.8.21-fix31
-
 npm install && npm run build && npm pack
-# → jeik-dingtalk-connector-0.8.21-fix31.tgz
-
-openclaw plugins install ./jeik-dingtalk-connector-0.8.21-fix31.tgz --force
-openclaw gateway restart
+openclaw plugins install ./jeik-dingtalk-connector-0.8.29.tgz --force && openclaw gateway restart
 ```
 
-> 国内若 clone 慢，可用镜像前缀，例如：  
-> `git clone https://ghfast.top/https://github.com/jeikl/dingtalk-openclaw-connector-fix-Community.git`
-
 ### 安装后自检
 
 ```bash
-openclaw -v                    # OpenClaw ≥ 2026.4.9
+openclaw -v                    # ≥ 2026.4.9
 openclaw plugins list          # 应看到 dingtalk-connector / @jeik/dingtalk-connector
-# 发一条钉钉消息：应先出现「🦸 正在召唤大模型…」，再进入流式回复
+# 发一条钉钉消息：应先「正在召唤大模型…」，再流式/答案卡
 ```
 
 ---

package/dist/background-work-DkaSDqWk.mjs

@@ -0,0 +1,53 @@
+import { r as isDingtalkDebug } from "./logger-CnBTcwyq.mjs";
+//#region src/utils/background-work.ts
+/**
+* 后台任务引用计数。
+*
+* 钉钉 WS 回调只「入队」后就返回，真正的 AI 跑在 sessionQueues 后台 Promise 里。
+* 若只在 WS 回调里 markMessageProcessingStart/End，会在入队后立刻 End，
+* 长任务（尤其 503 重试）期间心跳超时会触发幽灵重连 → 后续消息「网关没反应」。
+*
+* 用法：session 队列任务创建后 trackBackgroundWork(taskPromise)。
+* connection 层订阅计数变化，在 count>0 时保持处理中 keepAlive。
+*/
+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" && isDingtalkDebug()) {
+		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-C7-XHhHw.mjs

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

package/dist/{card-content-cache-CYUzCaQJ.mjs → card-content-cache-DT_OYThh.mjs}

@@ -1,4 +1,18 @@
+import { r as isDingtalkDebug } from "./logger-CnBTcwyq.mjs";
 //#region src/services/messaging/card-content-cache.ts
+/**
+* AI / 交互卡片正文缓存
+*
+* 钉钉「引用 AI 卡片」时，回调里的 repliedMsg 经常是：
+*   { msgType: "interactiveCard", content: {} 或仅有 templateId }
+* 不带可读正文 → 模型侧只看到 `[引用] [interactiveCard消息]`。
+*
+* 对策：我们在 finishAICard / 定稿时把 outTrackId → 正文 记下来；
+* 引用时仅用载荷里的 outTrackId / msgId 等精确回填。
+* 默认不做「会话最近一条」兜底（会把错误卡片正文当成用户引用的内容）。
+*
+* 内存 LRU + TTL，进程重启后清空（可接受）。
+*/
 const MAX_ENTRIES = 300;
 /** 默认保留 7 天（引用历史卡片） */
 const DEFAULT_TTL_MS = 10080 * 60 * 1e3;
@@ -39,7 +53,7 @@ function rememberCardContent(params) {
 		byConversation.set(cid, next);
 		byKey.set(normalizeKey("convRef", `${cid}|${ref}`), entry);
 	}
-	try {
+	if (isDingtalkDebug()) try {
 		console.log(`[DingTalk][CardCache] 已缓存 | outTrack=${params.outTrackId || "-"} conv=${params.conversationId || "-"} len=${text.length}`);
 	} catch {}
 }

package/dist/chunk-upload-BKM1y4Ba.mjs

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

package/dist/{chunk-upload-BBQgGtcZ.mjs → chunk-upload-CIU5G_ay.mjs}

@@ -1,4 +1,4 @@
-import { t as createLogger } from "./logger-mZ9OSbmD.mjs";
+import { t as createLogger } from "./logger-CnBTcwyq.mjs";
 import { n as dingtalkOapiHttp } from "./http-client-DFWZgO1n.mjs";
 import * as fs from "fs";
 import * as path from "path";

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

@@ -1,6 +1,6 @@
-import { t as createLogger } from "./logger-mZ9OSbmD.mjs";
+import { t as createLogger } from "./logger-CnBTcwyq.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-CIU5G_ay.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-BKM1y4Ba.mjs");
 				const downloadCode = await uploadLargeFileByChunks(absPath, mediaType, oapiToken, debugEnabled);
 				if (downloadCode) {
 					log?.info?.(`分块上传成功：${absPath}, download_code: ${downloadCode}`);

package/dist/{common-B_A78n8u.mjs → common-C0Oaf0z-.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-BfIYs1yC.mjs";
 export { AUDIO_MARKER_PATTERN, FILE_MARKER_PATTERN, VIDEO_MARKER_PATTERN };