@jeik/dingtalk-connector 0.8.28 → 0.8.29

package/CHANGELOG.md

@@ -5,53 +5,52 @@ 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.29] - 2026-07-25
 
 ### 主题
 
-基于**官方最新 0.8.24** 继续做社区增强：把连接做稳、消息少丢、错误提示更清楚。少折腾、多好用。
+正式版加固：默认日志更轻、排障只靠配置 `debug: true`；继承 0.8.28 连接/消息/错误卡能力。
 
-### 基于官方 0.8.24 吸收的能力
+### 变更
 
-- 更稳的长连接思路：连接建立后再挂心跳相关监听，减少「看起来连着、其实收不到消息」的假死重连
-- 机器人忙着回上一条时，处理过程中也会保持连接活跃，长回复不容易被中途掐断
-- 上游 SDK 刷屏日志过滤，控制台更干净，少误判成故障
-- 空回复时的友好提示（尤其是群聊配置不当的情况）
+- 🧹 **默认静默诊断刷屏** — 无图文本回复不再输出 LocalImage / MediaIdTrace / CardCache / Quote 成功路径
+- 🔍 **debug 配置统一开关** — 顶层或账号 `"debug": true` 打开连接摘要、图片 mediaId、引用回填、队列计数等详细日志；**不再依赖环境变量**
+- 📚 **文档** — 安装命令精简为三条递进指导；README 中英同步至 0.8.29
 
-> 说明：官方给其他插件用的「卡片创建/更新开放接口」本版**未合入**（对话体验不依赖它）。需要时可后续单独加。
+### 继承（0.8.28）
 
-### 本版重点优化（效果向）
+- 基于官方 0.8.24 的长连接更稳、消息少丢、模型错误中文定稿、本仓库独有答案卡/图片能力
 
-**1. 长连接更稳**
-- 只有钉钉确认「这条连接可以收机器人消息」之后，才对外显示已连接
-- 连不上会自动多试几轮，而不是假装在线
-- 正常使用时尽量不乱拆连接，减少「连发好几条消息完全没反应」
+### 安装
 
-**2. 消息更少丢、反馈更快**
-- 消息进队成功后再向钉钉确认已收到，失败可让平台重发，避免「确认了却其实没处理」
-- 同一会话排队处理更可靠：任务进行中再发消息，更容易马上出现「已排队 / 处理中」提示和思考中表情
-- 单条任务卡住太久会自动放开队列，避免后面消息永远等不到
+```bash
+# 1）装最新
+openclaw plugins install @jeik/dingtalk-connector --force && openclaw gateway restart
 
-**3. 模型出错时体验更好**
-- 上游欠费、无可用线路、503 等失败时，群聊/私聊都更容易定格成清晰中文错误卡片
-- 减少卡在「正在召唤大模型…」或莫名「思考完成」却看不到原因的情况
-- 错误结束后继续发消息，响应能力明显好于旧版
+# 2）若不是最新，指定版本
+openclaw plugins install @jeik/dingtalk-connector@0.8.29 --force && openclaw gateway restart
 
-**4. 社区原有增强（继续保留）**
-- 即时首响卡片、大段答案独立答案卡、图片/本地图修复、中文错误映射、强制群聊正常回复合流等
+# 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
 
-```bash
-npx -y @jeik/dingtalk-connector@0.8.28 install --force
-openclaw gateway restart
-```
+### 主题
+
+基于**官方最新 0.8.24**，并保留**本仓库独有**优化：连接更稳、消息少丢、错误提示更清楚。
+
+### 本版重点
 
-或：
+- 长连接：能收消息才显示已连接；少假死误重连
+- 消息：进队后再 ACK；排队反馈更及时
+- 错误：503 / 欠费 / 无通道等中文定稿，少卡「正在召唤大模型」
+- 本仓库独有：答案卡、图片全路径、首响等
+
+### 安装
 
 ```bash
-openclaw plugins install @jeik/dingtalk-connector@0.8.28 --force
-openclaw gateway restart
+openclaw plugins install @jeik/dingtalk-connector@0.8.28 --force && openclaw gateway restart
 ```
 
 ## [0.8.26] - 2026-07-25

package/README.en.md

@@ -2,9 +2,9 @@
   <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-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>
+  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 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><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,45 +23,31 @@
 
 ## 🔧 Recent Updates
 
-### 🚀 v0.8.28 · 2026-07-25 (current)
+### 🚀 v0.8.29 · 2026-07-25 (current)
 
-**Theme: based on official 0.8.24 · steadier connection · fewer lost messages · clearer errors**
+**Theme: production hardening · quieter logs · debug config only**
 
-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.
-
-#### From official 0.8.24
-
-- 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
-
-#### Extra community improvements (what you’ll notice)
+Built on **0.8.28** (steadier connection / fewer lost messages / clearer error cards):
 
 | 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 |
+| 🧹 **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@0.8.28 install --force && openclaw gateway restart
+openclaw plugins install @jeik/dingtalk-connector --force && openclaw gateway restart
 ```
 
-### 📦 v0.8.26 · 2026-07-25
-
-Stricter outbound target ID rules (keep `==` suffixes and case).
-
-### 📦 v0.8.25 · 2026-07-24
-
-Sender role/title identity; bare DingTalk IDs as direct chat.
+### 📦 v0.8.28 · 2026-07-25
 
-### 📦 v0.8.21-fix49 and earlier
+Official 0.8.24-aligned connection & delivery hardening (included in 0.8.29).
 
-Answer cards, image path fixes, streaming finalize, Chinese error mapping — see [CHANGELOG.md](CHANGELOG.md).
+### 📦 v0.8.26 / 0.8.25 and earlier
 
-Full log: [CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md)
+Target ID rules, sender identity, answer cards, image fixes — see [CHANGELOG.md](CHANGELOG.md).
 
 ---
 
@@ -232,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
-
-# force overwrite when a local dingtalk-connector already exists
-npx -y @jeik/dingtalk-connector install --force
-```
+# 1) Install latest
+openclaw plugins install @jeik/dingtalk-connector --force && openclaw gateway restart
 
-**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
@@ -301,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

@@ -4,7 +4,7 @@
   <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.28</strong>（推荐生产；一键安装：`npx -y @jeik/dingtalk-connector@0.8.28 install --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,45 +23,31 @@
 
 ## 🔧 最近更新
 
-### 🚀 v0.8.28 · 2026-07-25（当前正式版）
+### 🚀 v0.8.29 · 2026-07-25（当前正式版）
 
-**主题：基于官方 0.8.24 · 长连接更稳 · 消息少丢 · 错误提示更清楚**
+**主题：正式加固 · 日志更干净 · 排障只开 debug**
 
-本版在社区增强能力之上，对齐官方 **0.8.24** 的连接改进，并重点打磨「发了消息却没反应」「错误卡卡住」「排队提示不出现」等真实使用体验。
-
-#### 基于官方 0.8.24 吸收了什么
-
-- 更稳妥的长连接建立与保活方式，减少假死、误重连
-- 机器人处理长任务时连接不易被中途掐断
-- 控制台少刷无用日志，排障更清爽
-
-#### 社区本版额外优化（你会感受到的效果）
+在 **0.8.28**（连接更稳 / 消息少丢 / 错误卡可定稿）基础上再打磨：
 
 | 体验 | 效果 |
 |------|------|
-| 🔗 **连接更靠谱** | 只有真正能收消息时才显示「已连接」；连不上会自动多试几轮，而不是假装在线 |
-| 📩 **消息更少丢** | 明显缓解：连发多条、错误回复后、任务刚结束时「发了没进网关」的情况 |
-| ⏳ **排队反馈更及时** | 上一条还在处理时再发，更容易马上看到「已排队 / 处理中」和思考中表情 |
-| ⚠️ **模型故障更好懂** | 欠费、无可用线路、503 等失败时，卡片更容易定格成中文说明，少卡在「正在召唤大模型」 |
-| 🃏 **答案卡 / 图片等** | 社区原有大段答案独立卡片、图片全路径修复等能力继续保留 |
+| 🧹 **默认日志更轻** | 无图正常回复不再刷 LocalImage / MediaIdTrace / CardCache |
+| 🔍 **排障更简单** | 配置 `"debug": true` 即输出连接、图片、引用、队列详细日志（无需环境变量） |
+| 🔗 **连接 / 队列** | 继承 0.8.28：能收消息才算在线；连发、错误后再发更稳；排队反馈更及时 |
+| ⚠️ **模型故障** | 503 / 欠费 / 无通道等更容易定格中文错误，少卡「正在召唤大模型」 |
+| 🃏 **本仓库独有** | 答案卡、图片全路径、首响体验等继续保留 |
 
 ```bash
-npx -y @jeik/dingtalk-connector@0.8.28 install --force && openclaw gateway restart
+openclaw plugins install @jeik/dingtalk-connector --force && openclaw gateway restart
 ```
 
-### 📦 v0.8.26 · 2026-07-25
-
-目标 ID 填写约束（保留 `==` 等后缀与大小写）。
+### 📦 v0.8.28 · 2026-07-25
 
-### 📦 v0.8.25 · 2026-07-24
+基于官方 0.8.24 的长连接与消息体验加固（当前能力已并入 0.8.29）。
 
-发送人岗位与身份信息；裸钉钉 ID 推导为单聊。
+### 📦 v0.8.26 / 0.8.25 及更早
 
-### 📦 v0.8.21-fix49 及更早
-
-答案卡、图片全路径修复、流式定稿、中文错误映射等——详见 [CHANGELOG.md](CHANGELOG.md)。
-
-完整说明：[CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md)
+目标 ID 约束、发送人身份、答案卡、图片修复等——详见 [CHANGELOG.md](CHANGELOG.md)。
 
 ---
 
@@ -197,9 +183,23 @@ npx -y @jeik/dingtalk-connector@0.8.28 install --force && openclaw gateway resta
 | `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
+  }
+}
+```
+
 ---
 
 ## 🎯 回复标记 + 答案卡 + 工具进度（核心增强）
@@ -236,79 +236,51 @@ npx -y @jeik/dingtalk-connector@0.8.28 install --force && openclaw gateway resta
 
 | 项目 | 说明 |
 |------|------|
-| 基础版本 | 官方 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
-
-# 已有 dingtalk-connector / 装不上时强制覆盖
-npx -y @jeik/dingtalk-connector install --force
-```
+# 1）装最新
+openclaw plugins install @jeik/dingtalk-connector --force && openclaw gateway restart
 
-**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）升级到最新版：**
-
-```bash
-openclaw plugins install @jeik/dingtalk-connector --force
-openclaw gateway restart
-```
+> 一键扫码建机器人（可选）：`npx @jeik/dingtalk-connector install --force`
 
-### 方式二：本地 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-Cxb4b-91.mjs → background-work-DkaSDqWk.mjs}

@@ -1,4 +1,15 @@
+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() {
@@ -31,7 +42,7 @@ function trackBackgroundWork(work, label) {
 		notify();
 	};
 	work.then(done, done);
-	if (label && typeof process !== "undefined" && process.env?.DINGTALK_DEBUG_QUEUE === "1") {
+	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}`);

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-bDQFz2u8.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-BE71drPg.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-BZiVgd3A.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-BE71drPg.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-PwhogwfE.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-DgL28gCZ.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-BZiVgd3A.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 };