Release Notes - v0.8.12

🎉 新版本亮点 / Highlights

本次更新修复了 v0.8.11 安装后启动崩溃的问题（#419），同时大幅精简依赖体积，移除了约 100MB 的非核心依赖，并清理了无效的代理禁用代码。

This release fixes the startup crash after v0.8.11 installation (#419), significantly reduces dependency size by removing ~100MB of non-core dependencies, and removes ineffective proxy bypass code.

🐛 修复 / Fixes

• 修复 v0.8.11 安装后启动崩溃 / Fix startup crash after v0.8.11 installation (#419)
  v0.8.11 将 mammoth 和 pdf-parse 从 dependencies 移至 optionalDependencies，但代码中仍使用静态 import，导致模块加载阶段立即报错 Cannot find module 'mammoth'，插件无法启动。现已改为动态 import + 优雅降级：缺失时打印警告并跳过，不影响核心功能。
  v0.8.11 moved mammoth and pdf-parse from dependencies to optionalDependencies, but the code still used static import, causing immediate Cannot find module 'mammoth' error at module load time. Now uses dynamic import with graceful degradation: prints a warning and skips when missing, without affecting core functionality.

📦 依赖优化 / Dependency Optimization

• 移除大体积非核心依赖 / Remove large non-core dependencies
  将 pdf-parse（~21MB）、fluent-ffmpeg（~12MB）、@ffmpeg-installer/ffmpeg（~70MB）、@ffprobe-installer/ffprobe 从 optionalDependencies 中移除。这些包均已改为动态 import，缺失时优雅降级，需要时用户可手动安装。仅保留 mammoth（~2MB）在 optionalDependencies 中。
  Removed pdf-parse (~21MB), fluent-ffmpeg (~12MB), @ffmpeg-installer/ffmpeg (~70MB), @ffprobe-installer/ffprobe from optionalDependencies. All packages now use dynamic import with graceful degradation. Users can manually install them when needed. Only mammoth (~2MB) remains in optionalDependencies.

🧹 代码清理 / Code Cleanup

• 移除无效的代理禁用代码 / Remove ineffective proxy bypass code
  经源码分析，dingtalk-stream SDK 的 WebSocket 连接使用 ws 库直接建立，不经过 axios 也不受 axios.defaults.proxy 影响。之前在 connection.ts 中设置 axios.defaults.proxy = false 以及 http-client.ts 中的 proxy: getProxyConfig() 对 WebSocket 连接无效。现已移除 src/utils/proxy-config.ts 模块及所有相关代理配置代码。
  Source code analysis revealed that dingtalk-stream SDK's WebSocket connection uses the ws library directly, bypassing axios entirely. The previous axios.defaults.proxy = false in connection.ts and proxy: getProxyConfig() in http-client.ts had no effect on WebSocket connections. Removed src/utils/proxy-config.ts module and all related proxy configuration code.

📥 安装升级 / Installation & Upgrade

# 通过 npm 安装最新版本 / Install latest version via npm
openclaw plugins install @dingtalk-real-ai/dingtalk-connector

# 或升级现有版本 / Or upgrade existing version
openclaw plugins update dingtalk-connector

# 通过 Git 安装 / Install via Git
openclaw plugins install https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector.git

可选依赖手动安装 / Optional Dependencies

# Word 文档解析（自动安装，~2MB）
# mammoth is auto-installed as optionalDependency

# PDF 文档解析（需手动安装）
npm install pdf-parse

# 视频/音频转码（需手动安装）
npm install fluent-ffmpeg @ffmpeg-installer/ffmpeg @ffprobe-installer/ffprobe

🔗 相关链接 / Related Links

• Issue #419
• 完整变更日志 / Full Changelog
• 使用文档 / Documentation

发布日期 / Release Date：2026-04-01
版本号 / Version：v0.8.12
兼容性 / Compatibility：OpenClaw Gateway 0.4.0+