@yaoyuanchao/dingtalk 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -69,15 +69,12 @@ This release transforms the DingTalk plugin into an official Clawdbot plugin tha
 
 ### Migration Guide
 
-If you're upgrading from v0.1.0:
+If you're upgrading from v0.1.0, see [UPGRADE.md](./UPGRADE.md) for detailed steps.
 
+Summary:
 1. **No configuration changes required** - existing configs work as-is
-2. **Optional**: Try the new onboarding wizard for fresh setup
-3. **Optional**: Reinstall via NPM for easier updates:
-   ```bash
-   clawdbot plugins uninstall dingtalk
-   clawdbot plugins install @yaoyuanchao/dingtalk
-   ```
+2. Backup, stop gateway, delete old plugin, install via NPM, restart
+3. **Optional**: Try the new onboarding wizard for fresh setup
 
 ## [0.1.0] - 2026-01-26
 

package/README.md

@@ -24,6 +24,8 @@
 
 ## 快速开始
 
+> **从 v0.1.0 升级？** 查看 [升级指南](./UPGRADE.md)
+
 ### 方式一：官方安装（推荐）
 
 ```bash
@@ -81,7 +83,7 @@ clawdbot plugins install .
         "allowFrom": ["YOUR_STAFF_ID"]
       },
       "groupPolicy": "allowlist",
-      "groupAllowlist": ["cidlnNrtqQ4kGskU56Qni6zTg=="],
+      "groupAllowlist": ["YOUR_CONVERSATION_ID"],
       "requireMention": true
     }
   }
@@ -147,7 +149,7 @@ tail -f /tmp/clawdbot/clawdbot-$(date +%Y-%m-%d).log | grep dingtalk
 
 1. 在钉钉中找到机器人
 2. 发送任意消息
-3. 机器人会回复："Access denied. Your staffId: 050914185922786044 Ask admin to add you."
+3. 机器人会回复："Access denied. Your staffId: XXXXXXXXXXXXXXXXXXXX Ask admin to add you."
 4. 将这个 staffId 添加到配置文件的 `dm.allowFrom` 数组中
 5. 重启 gateway
 
@@ -168,7 +170,7 @@ tail -f /tmp/clawdbot/clawdbot-$(date +%Y-%m-%d).log | grep "dingtalk.*Group"
 1. 临时修改配置为 `groupPolicy: "open"`
 2. 重启 gateway
 3. 在群聊中 @机器人发送消息
-4. 查看日志获取 conversationId（格式类似 `cidlnNrtqQ4kGskU56Qni6zTg==`）
+4. 查看日志获取 conversationId（格式类似 `cidXXXXXXXXXXXXXXXXXX==`）
 5. 将 conversationId 添加到 `groupAllowlist` 数组
 6. 改回 `groupPolicy: "allowlist"` 并重启
 
@@ -177,8 +179,8 @@ tail -f /tmp/clawdbot/clawdbot-$(date +%Y-%m-%d).log | grep "dingtalk.*Group"
 {
   "groupPolicy": "allowlist",
   "groupAllowlist": [
-    "cidlnNrtqQ4kGskU56Qni6zTg==",
-    "anotherConversationId123=="
+    "cidXXXXXXXXXXXXXXXXXX==",
+    "cidYYYYYYYYYYYYYYYYYY=="
   ],
   "requireMention": true
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaoyuanchao/dingtalk",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "type": "module",
   "description": "DingTalk channel plugin for Clawdbot with Stream Mode support",
   "license": "MIT",

package/src/config-schema.ts

@@ -9,8 +9,8 @@ export const groupPolicySchema = z.enum(['disabled', 'allowlist', 'open'], {
   description: 'Group chat access control policy',
 });
 
-export const messageFormatSchema = z.enum(['text', 'markdown'], {
-  description: 'Message format for bot responses',
+export const messageFormatSchema = z.enum(['text', 'markdown', 'richtext'], {
+  description: 'Message format for bot responses (richtext is an alias for markdown)',
 });
 
 // DingTalk 配置 Schema
@@ -59,7 +59,8 @@ export const dingTalkConfigSchema = z.object({
     .describe(
       'Message format:\n' +
       '  - text: Plain text (recommended, supports tables)\n' +
-      '  - markdown: DingTalk markdown (limited support, no tables)'
+      '  - markdown: DingTalk markdown (limited support, no tables)\n' +
+      '  - richtext: Alias for markdown (deprecated, use markdown instead)'
     ),
 
   // 高级配置（可选）

package/src/types.ts

@@ -51,6 +51,6 @@ export interface DingTalkChannelConfig {
   groupAllowlist?: string[];
   requireMention?: boolean;
   textChunkLimit?: number;
-  messageFormat?: 'text' | 'markdown';
+  messageFormat?: 'text' | 'markdown' | 'richtext';
   [key: string]: unknown;
 }