chatccc 0.2.62 → 0.2.63

package/config.sample.json

@@ -14,7 +14,7 @@
   "claude": {
     "enabled": false,
     "defaultAgent": true,
-    "model": "",
+    "model": "claude-sonnet-4-6",
     "subagentModel": "",
     "effort": "",
     "apiKey": "",

package/im-skills/wechat-file-skill/receive-send-file.md

@@ -0,0 +1,42 @@
+# Receiving & Sending Files (WeChat)
+
+## Receive Files
+
+Files sent to the bot are automatically downloaded to `~/.chatccc/files/downloads/` with the `wx_` filename prefix.
+
+The message text you receive will include the downloaded path in the format:
+```text
+[文件] C:\Users\<user>\.chatccc\files\downloads\wx_<key>_<filename>
+```
+
+You can read the file at that path to inspect, parse, transform, or forward it.
+
+## Send Files
+
+### Script (recommended)
+```bash
+node "{{wechat_send_file_script}}" --path "<absolute file path>" --caption "<optional caption>"
+```
+
+The script reads the current WeChat session's auth token, chat ID, and context token from `~/.chatccc/state/ilink-auth.json`, then sends the file to the most recent chat.
+
+### Direct usage in test scripts
+
+The underlying SDK call is:
+```ts
+import { Client as OpenIlinkWire } from "@openilink/openilink-sdk-node";
+const wire = new OpenIlinkWire(token, { base_url: baseUrl });
+await wire.sendMediaFile(chatId, contextToken, fileBuffer, "report.pdf", "caption");
+```
+
+For non-image and non-video MIME types, the SDK routes the upload as a file attachment.
+
+### Rules
+
+- Save or choose a local file first.
+- Use an absolute local path.
+- Supported formats: .txt, .pdf, .doc, .docx, .xls, .xlsx, .csv, .ppt, .pptx, .zip, .tar, .gz.
+- Max file size: 30MB.
+- Use the dedicated image or video skill for images and videos.
+- Only send a file when the user asked for one or when it materially helps the answer.
+- File sending counts as an outgoing WeChat message. Avoid repeated unsolicited sends.

package/im-skills/wechat-file-skill/send-file.mjs

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { basename, extname, isAbsolute, join } from "node:path";
+import { homedir } from "node:os";
+
+import { Client as OpenIlinkWire } from "@openilink/openilink-sdk-node";
+
+const ILINK_AUTH_PATH = join(homedir(), ".chatccc", "state", "ilink-auth.json");
+const MAX_FILE_BYTES = 30 * 1024 * 1024;
+const ALLOWED_EXTS = new Set([
+  ".txt",
+  ".pdf",
+  ".doc",
+  ".docx",
+  ".xls",
+  ".xlsx",
+  ".csv",
+  ".ppt",
+  ".pptx",
+  ".zip",
+  ".tar",
+  ".gz",
+]);
+
+function parseArgs(argv) {
+  const result = {};
+  for (let i = 0; i < argv.length; i++) {
+    const key = argv[i];
+    if (!key.startsWith("--")) continue;
+    const value = argv[i + 1] && !argv[i + 1].startsWith("--") ? argv[++i] : "true";
+    result[key.slice(2)] = value;
+  }
+  return result;
+}
+
+function usage() {
+  console.error(`Usage:
+  node ${basename(process.argv[1])} --path <absolute file path> [--caption <text>]`);
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const filePath = args.path;
+  const caption = args.caption || "";
+
+  if (!filePath) {
+    usage();
+    process.exit(1);
+  }
+  if (!isAbsolute(filePath)) {
+    console.error("File path must be absolute.");
+    process.exit(1);
+  }
+
+  const ext = extname(filePath).toLowerCase();
+  if (!ALLOWED_EXTS.has(ext)) {
+    console.error(`Unsupported file extension: ${ext || "(none)"}`);
+    process.exit(1);
+  }
+
+  const st = statSync(filePath);
+  if (!st.isFile()) {
+    console.error("File path is not a file");
+    process.exit(1);
+  }
+  if (st.size <= 0) {
+    console.error("File is empty");
+    process.exit(1);
+  }
+  if (st.size > MAX_FILE_BYTES) {
+    console.error("File exceeds 30MB limit");
+    process.exit(1);
+  }
+
+  if (!existsSync(ILINK_AUTH_PATH)) {
+    console.error(`Auth snapshot not found: ${ILINK_AUTH_PATH}`);
+    console.error("Make sure the WeChat iLink platform is logged in.");
+    process.exit(1);
+  }
+
+  const snap = JSON.parse(readFileSync(ILINK_AUTH_PATH, "utf8"));
+  if (!snap.token || !snap.lastChatId || !snap.contextToken) {
+    console.error("Auth snapshot missing token, lastChatId, or contextToken.");
+    process.exit(1);
+  }
+
+  const fileData = readFileSync(filePath);
+  const fileName = basename(filePath);
+
+  const wire = new OpenIlinkWire(snap.token, {
+    base_url: snap.baseUrl,
+  });
+
+  await wire.sendMediaFile(snap.lastChatId, snap.contextToken, fileData, fileName, caption);
+  console.log(JSON.stringify({ ok: true, sentTo: 1 }));
+}
+
+main().catch((err) => {
+  console.error(err instanceof Error ? err.message : String(err));
+  process.exit(1);
+});

package/im-skills/wechat-file-skill/skill.md

@@ -0,0 +1,11 @@
+---
+name: wechat-file-skill
+description: WeChat iLink local skill for sending and receiving files.
+---
+
+Current working directory: {{cwd}}
+
+WeChat files are handled through the iLink SDK. The local server does NOT have HTTP RPC endpoints for WeChat; use the helper script below instead.
+
+- **Receive files**: Files sent to the bot are automatically downloaded to `~/.chatccc/files/downloads/` with the filename prefix `wx_`. The message text will include the local path as `[文件] <absolute path>`.
+- **Send files**: Use the send-file helper script — read `{{im_skills_cache_dir}}/wechat-file-skill/receive-send-file.md`

package/im-skills/{wechat-skill → wechat-image-skill}/receive-send-image.md

@@ -1,39 +1,39 @@
-# Receiving & Sending Images (WeChat)
-
-## Receive Images
-
-Images sent to the bot are **automatically downloaded** to `~/.chatccc/images/downloads/` with the `wx_` filename prefix.
-
-The message text you receive will include the downloaded path in the format:
-```
-[图片] C:\Users\<用户名>\.chatccc\images\downloads\wx_<key>.png
-```
-
-You can read the image file at that path to understand what the user sent.
-
-## Send Images
-
-### Script (recommended)
-```bash
-node "{{wechat_send_image_script}}" --path "<absolute image path>" --caption "<optional caption>"
-```
-
-The script reads the current WeChat session's auth token, chat ID, and context token from `~/.chatccc/state/ilink-auth.json`, then sends the image to the most recent chat.
-
-### Direct usage in test scripts
-
-The underlying SDK call is:
-```ts
-import { Client as OpenIlinkWire } from "@openilink/openilink-sdk-node";
-const wire = new OpenIlinkWire(token, { base_url: baseUrl });
-await wire.sendMediaFile(chatId, contextToken, imageBuffer, "filename.png", "caption");
-```
-
-### Rules
-
-- Save or choose a local image file first.
-- Use an absolute local path.
-- Supported formats: .png, .jpg, .jpeg, .webp, .gif, .bmp.
-- Max image size: 10MB (SDK guideline; larger files upload slower).
-- Only send an image when the user asked for one or when it materially helps the answer.
-- **Claw 限制**: 图片发送也计入微信 claw 连发计数，连续 10 条未回复会截断。
+# Receiving & Sending Images (WeChat)
+
+## Receive Images
+
+Images sent to the bot are automatically downloaded to `~/.chatccc/images/downloads/` with the `wx_` filename prefix.
+
+The message text you receive will include the downloaded path in the format:
+```text
+[图片] C:\Users\<user>\.chatccc\images\downloads\wx_<key>.png
+```
+
+You can read the image file at that path to understand what the user sent.
+
+## Send Images
+
+### Script (recommended)
+```bash
+node "{{wechat_send_image_script}}" --path "<absolute image path>" --caption "<optional caption>"
+```
+
+The script reads the current WeChat session's auth token, chat ID, and context token from `~/.chatccc/state/ilink-auth.json`, then sends the image to the most recent chat.
+
+### Direct usage in test scripts
+
+The underlying SDK call is:
+```ts
+import { Client as OpenIlinkWire } from "@openilink/openilink-sdk-node";
+const wire = new OpenIlinkWire(token, { base_url: baseUrl });
+await wire.sendMediaFile(chatId, contextToken, imageBuffer, "filename.png", "caption");
+```
+
+### Rules
+
+- Save or choose a local image file first.
+- Use an absolute local path.
+- Supported formats: .png, .jpg, .jpeg, .webp, .gif, .bmp.
+- Max image size: 10MB.
+- Only send an image when the user asked for one or when it materially helps the answer.
+- Image sending counts as an outgoing WeChat message. Avoid repeated unsolicited sends.

package/im-skills/{wechat-skill → wechat-image-skill}/send-image.mjs

@@ -1,80 +1,84 @@
-#!/usr/bin/env node
-import { existsSync, readFileSync, statSync } from "node:fs";
-import { basename, extname, join } from "node:path";
-import { homedir } from "node:os";
-
-import { Client as OpenIlinkWire } from "@openilink/openilink-sdk-node";
-
-const ILINK_AUTH_PATH = join(homedir(), ".chatccc", "state", "ilink-auth.json");
-const MAX_IMAGE_BYTES = 10 * 1024 * 1024;
-const ALLOWED_EXTS = new Set([".png", ".jpg", ".jpeg", ".webp", ".gif", ".bmp"]);
-
-function parseArgs(argv) {
-  const result = {};
-  for (let i = 0; i < argv.length; i++) {
-    const key = argv[i];
-    if (!key.startsWith("--")) continue;
-    const value = argv[i + 1] && !argv[i + 1].startsWith("--") ? argv[++i] : "true";
-    result[key.slice(2)] = value;
-  }
-  return result;
-}
-
-function usage() {
-  console.error(`Usage:
-  node ${basename(process.argv[1])} --path <absolute image path> [--caption <text>]`);
-}
-
-async function main() {
-  const args = parseArgs(process.argv.slice(2));
-  const imagePath = args.path;
-  const caption = args.caption || "";
-
-  if (!imagePath) {
-    usage();
-    process.exit(1);
-  }
-
-  const ext = extname(imagePath).toLowerCase();
-  if (!ALLOWED_EXTS.has(ext)) {
-    console.error(`Unsupported image extension: ${ext || "(none)"}`);
-    process.exit(1);
-  }
-
-  const st = statSync(imagePath);
-  if (!st.isFile()) {
-    console.error("Image path is not a file");
-    process.exit(1);
-  }
-  if (st.size > MAX_IMAGE_BYTES) {
-    console.error("Image file exceeds 10MB limit");
-    process.exit(1);
-  }
-
-  if (!existsSync(ILINK_AUTH_PATH)) {
-    console.error(`Auth snapshot not found: ${ILINK_AUTH_PATH}`);
-    console.error("Make sure the WeChat iLink platform is logged in.");
-    process.exit(1);
-  }
-
-  const snap = JSON.parse(readFileSync(ILINK_AUTH_PATH, "utf8"));
-  if (!snap.token || !snap.lastChatId || !snap.contextToken) {
-    console.error("Auth snapshot missing token, lastChatId, or contextToken.");
-    process.exit(1);
-  }
-
-  const imgData = readFileSync(imagePath);
-  const fileName = basename(imagePath);
-
-  const wire = new OpenIlinkWire(snap.token, {
-    base_url: snap.baseUrl,
-  });
-
-  await wire.sendMediaFile(snap.lastChatId, snap.contextToken, imgData, fileName, caption);
-  console.log(JSON.stringify({ ok: true, sentTo: 1 }));
-}
-
-main().catch((err) => {
-  console.error(err instanceof Error ? err.message : String(err));
-  process.exit(1);
-});
+#!/usr/bin/env node
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { basename, extname, isAbsolute, join } from "node:path";
+import { homedir } from "node:os";
+
+import { Client as OpenIlinkWire } from "@openilink/openilink-sdk-node";
+
+const ILINK_AUTH_PATH = join(homedir(), ".chatccc", "state", "ilink-auth.json");
+const MAX_IMAGE_BYTES = 10 * 1024 * 1024;
+const ALLOWED_EXTS = new Set([".png", ".jpg", ".jpeg", ".webp", ".gif", ".bmp"]);
+
+function parseArgs(argv) {
+  const result = {};
+  for (let i = 0; i < argv.length; i++) {
+    const key = argv[i];
+    if (!key.startsWith("--")) continue;
+    const value = argv[i + 1] && !argv[i + 1].startsWith("--") ? argv[++i] : "true";
+    result[key.slice(2)] = value;
+  }
+  return result;
+}
+
+function usage() {
+  console.error(`Usage:
+  node ${basename(process.argv[1])} --path <absolute image path> [--caption <text>]`);
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const imagePath = args.path;
+  const caption = args.caption || "";
+
+  if (!imagePath) {
+    usage();
+    process.exit(1);
+  }
+  if (!isAbsolute(imagePath)) {
+    console.error("Image path must be absolute.");
+    process.exit(1);
+  }
+
+  const ext = extname(imagePath).toLowerCase();
+  if (!ALLOWED_EXTS.has(ext)) {
+    console.error(`Unsupported image extension: ${ext || "(none)"}`);
+    process.exit(1);
+  }
+
+  const st = statSync(imagePath);
+  if (!st.isFile()) {
+    console.error("Image path is not a file");
+    process.exit(1);
+  }
+  if (st.size > MAX_IMAGE_BYTES) {
+    console.error("Image file exceeds 10MB limit");
+    process.exit(1);
+  }
+
+  if (!existsSync(ILINK_AUTH_PATH)) {
+    console.error(`Auth snapshot not found: ${ILINK_AUTH_PATH}`);
+    console.error("Make sure the WeChat iLink platform is logged in.");
+    process.exit(1);
+  }
+
+  const snap = JSON.parse(readFileSync(ILINK_AUTH_PATH, "utf8"));
+  if (!snap.token || !snap.lastChatId || !snap.contextToken) {
+    console.error("Auth snapshot missing token, lastChatId, or contextToken.");
+    process.exit(1);
+  }
+
+  const imgData = readFileSync(imagePath);
+  const fileName = basename(imagePath);
+
+  const wire = new OpenIlinkWire(snap.token, {
+    base_url: snap.baseUrl,
+  });
+
+  await wire.sendMediaFile(snap.lastChatId, snap.contextToken, imgData, fileName, caption);
+  console.log(JSON.stringify({ ok: true, sentTo: 1 }));
+}
+
+main().catch((err) => {
+  console.error(err instanceof Error ? err.message : String(err));
+  process.exit(1);
+});

package/im-skills/{wechat-skill → wechat-image-skill}/skill.md

@@ -1,11 +1,11 @@
----
-name: wechat-skill
-description: WeChat iLink local skills for sending and receiving images.
----
-
-Current working directory: {{cwd}}
-
-WeChat images are handled through the iLink SDK. The local server does NOT have HTTP RPC endpoints for WeChat; use the helper scripts below instead.
-
-- **Receive images**: Images sent to the bot are automatically downloaded to `~/.chatccc/images/downloads/` with the filename prefix `wx_`. The message text will include the local path as `[图片] <absolute path>`.
-- **Send images**: Use the send-image helper script — read `{{im_skills_cache_dir}}/wechat-skill/receive-send-image.md`
+---
+name: wechat-image-skill
+description: WeChat iLink local skill for sending and receiving images.
+---
+
+Current working directory: {{cwd}}
+
+WeChat images are handled through the iLink SDK. The local server does NOT have HTTP RPC endpoints for WeChat; use the helper script below instead.
+
+- **Receive images**: Images sent to the bot are automatically downloaded to `~/.chatccc/images/downloads/` with the filename prefix `wx_`. The message text will include the local path as `[图片] <absolute path>`.
+- **Send images**: Use the send-image helper script — read `{{im_skills_cache_dir}}/wechat-image-skill/receive-send-image.md`

package/im-skills/wechat-video-skill/receive-send-video.md

@@ -0,0 +1,41 @@
+# Receiving & Sending Videos (WeChat)
+
+## Receive Videos
+
+Videos sent to the bot are automatically downloaded to `~/.chatccc/videos/downloads/` with the `wx_` filename prefix.
+
+The message text you receive will include the downloaded path in the format:
+```text
+[视频] C:\Users\<user>\.chatccc\videos\downloads\wx_<key>.mp4
+```
+
+You can read the video file at that path to inspect, transcode, trim, or forward it.
+
+## Send Videos
+
+### Script (recommended)
+```bash
+node "{{wechat_send_video_script}}" --path "<absolute video path>" --caption "<optional caption>"
+```
+
+The script reads the current WeChat session's auth token, chat ID, and context token from `~/.chatccc/state/ilink-auth.json`, then sends the video to the most recent chat.
+
+### Direct usage in test scripts
+
+The underlying SDK call is:
+```ts
+import { Client as OpenIlinkWire } from "@openilink/openilink-sdk-node";
+const wire = new OpenIlinkWire(token, { base_url: baseUrl });
+await wire.sendMediaFile(chatId, contextToken, videoBuffer, "filename.mp4", "caption");
+```
+
+The SDK detects video MIME types from the file name and routes `.mp4`, `.mov`, `.avi`, `.mkv`, `.webm`, and `.flv` as videos.
+
+### Rules
+
+- Save or choose a local video file first.
+- Use an absolute local path.
+- Supported formats: .mp4, .mov, .avi, .mkv, .webm, .flv.
+- Max video size: 30MB.
+- Only send a video when the user asked for one or when it materially helps the answer.
+- Video sending counts as an outgoing WeChat message. Avoid repeated unsolicited sends.

package/im-skills/wechat-video-skill/send-video.mjs

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { basename, extname, isAbsolute, join } from "node:path";
+import { homedir } from "node:os";
+
+import { Client as OpenIlinkWire } from "@openilink/openilink-sdk-node";
+
+const ILINK_AUTH_PATH = join(homedir(), ".chatccc", "state", "ilink-auth.json");
+const MAX_VIDEO_BYTES = 30 * 1024 * 1024;
+const ALLOWED_EXTS = new Set([".mp4", ".mov", ".avi", ".mkv", ".webm", ".flv"]);
+
+function parseArgs(argv) {
+  const result = {};
+  for (let i = 0; i < argv.length; i++) {
+    const key = argv[i];
+    if (!key.startsWith("--")) continue;
+    const value = argv[i + 1] && !argv[i + 1].startsWith("--") ? argv[++i] : "true";
+    result[key.slice(2)] = value;
+  }
+  return result;
+}
+
+function usage() {
+  console.error(`Usage:
+  node ${basename(process.argv[1])} --path <absolute video path> [--caption <text>]`);
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const videoPath = args.path;
+  const caption = args.caption || "";
+
+  if (!videoPath) {
+    usage();
+    process.exit(1);
+  }
+  if (!isAbsolute(videoPath)) {
+    console.error("Video path must be absolute.");
+    process.exit(1);
+  }
+
+  const ext = extname(videoPath).toLowerCase();
+  if (!ALLOWED_EXTS.has(ext)) {
+    console.error(`Unsupported video extension: ${ext || "(none)"}`);
+    process.exit(1);
+  }
+
+  const st = statSync(videoPath);
+  if (!st.isFile()) {
+    console.error("Video path is not a file");
+    process.exit(1);
+  }
+  if (st.size > MAX_VIDEO_BYTES) {
+    console.error("Video file exceeds 30MB limit");
+    process.exit(1);
+  }
+
+  if (!existsSync(ILINK_AUTH_PATH)) {
+    console.error(`Auth snapshot not found: ${ILINK_AUTH_PATH}`);
+    console.error("Make sure the WeChat iLink platform is logged in.");
+    process.exit(1);
+  }
+
+  const snap = JSON.parse(readFileSync(ILINK_AUTH_PATH, "utf8"));
+  if (!snap.token || !snap.lastChatId || !snap.contextToken) {
+    console.error("Auth snapshot missing token, lastChatId, or contextToken.");
+    process.exit(1);
+  }
+
+  const videoData = readFileSync(videoPath);
+  const fileName = basename(videoPath);
+
+  const wire = new OpenIlinkWire(snap.token, {
+    base_url: snap.baseUrl,
+  });
+
+  await wire.sendMediaFile(snap.lastChatId, snap.contextToken, videoData, fileName, caption);
+  console.log(JSON.stringify({ ok: true, sentTo: 1 }));
+}
+
+main().catch((err) => {
+  console.error(err instanceof Error ? err.message : String(err));
+  process.exit(1);
+});

package/im-skills/wechat-video-skill/skill.md

@@ -0,0 +1,11 @@
+---
+name: wechat-video-skill
+description: WeChat iLink local skill for sending and receiving videos.
+---
+
+Current working directory: {{cwd}}
+
+WeChat videos are handled through the iLink SDK. The local server does NOT have HTTP RPC endpoints for WeChat; use the helper script below instead.
+
+- **Receive videos**: Videos sent to the bot are automatically downloaded to `~/.chatccc/videos/downloads/` with the filename prefix `wx_`. The message text will include the local path as `[视频] <absolute path>`.
+- **Send videos**: Use the send-video helper script — read `{{im_skills_cache_dir}}/wechat-video-skill/receive-send-video.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatccc",
-  "version": "0.2.62",
+  "version": "0.2.63",
   "description": "Feishu bot bridge for Claude Code",
   "license": "Apache-2.0",
   "type": "module",

package/src/__tests__/im-skills.test.ts

@@ -1,9 +1,9 @@
-import { mkdtemp, mkdir, rm, writeFile } from "node:fs/promises";
+import { mkdtemp, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { tmpdir } from "node:os";
 import { afterEach, describe, expect, it } from "vitest";
 
-import { buildImSkillsPrompt } from "../im-skills.ts";
+import { buildImSkillsPrompt, exportSkillSubDocs } from "../im-skills.ts";
 
 let tempRoot: string | null = null;
 
@@ -43,4 +43,59 @@ describe("IM skills prompt rendering", () => {
     expect(prompt).toContain("cwd=C:/work");
     expect(prompt).not.toContain("{{");
   });
+
+  it("renders separate WeChat image, file, and video capability docs", async () => {
+    tempRoot = await mkdtemp(join(tmpdir(), "chatccc-im-skills-cache-"));
+    const prompt = await buildImSkillsPrompt({
+      variables: {
+        cwd: "C:/work",
+        im_skills_cache_dir: tempRoot,
+        wechat_send_image_script: "C:/work/im-skills/wechat-image-skill/send-image.mjs",
+        wechat_send_file_script: "C:/work/im-skills/wechat-file-skill/send-file.mjs",
+        wechat_send_video_script: "C:/work/im-skills/wechat-video-skill/send-video.mjs",
+      },
+    });
+
+    const exported = await exportSkillSubDocs(
+      {
+        variables: {
+          cwd: "C:/work",
+          im_skills_cache_dir: tempRoot,
+          wechat_send_image_script: "C:/work/im-skills/wechat-image-skill/send-image.mjs",
+          wechat_send_file_script: "C:/work/im-skills/wechat-file-skill/send-file.mjs",
+          wechat_send_video_script: "C:/work/im-skills/wechat-video-skill/send-video.mjs",
+        },
+      },
+      tempRoot,
+    );
+
+    expect(prompt).toContain("[ChatCCC IM skill: wechat-image-skill]");
+    expect(prompt).toContain("[ChatCCC IM skill: wechat-file-skill]");
+    expect(prompt).toContain("[ChatCCC IM skill: wechat-video-skill]");
+    expect(prompt).not.toContain("[ChatCCC IM skill: wechat-skill]");
+    expect(prompt).toContain("Receive images");
+    expect(prompt).toContain("Send images");
+    expect(prompt).toContain("Receive files");
+    expect(prompt).toContain("Send files");
+    expect(prompt).toContain("Receive videos");
+    expect(prompt).toContain("Send videos");
+    expect(prompt).toContain("receive-send-image.md");
+    expect(prompt).toContain("receive-send-file.md");
+    expect(prompt).toContain("receive-send-video.md");
+    expect(prompt).not.toContain("{{wechat_send_image_script}}");
+    expect(prompt).not.toContain("{{wechat_send_file_script}}");
+    expect(prompt).not.toContain("{{wechat_send_video_script}}");
+    expect(exported.some((file) => file.endsWith(join("wechat-image-skill", "receive-send-image.md")))).toBe(true);
+    expect(exported.some((file) => file.endsWith(join("wechat-file-skill", "receive-send-file.md")))).toBe(true);
+    expect(exported.some((file) => file.endsWith(join("wechat-video-skill", "receive-send-video.md")))).toBe(true);
+    await expect(readFile(join(tempRoot, "wechat-image-skill", "receive-send-image.md"), "utf8")).resolves.toContain(
+      "send-image.mjs",
+    );
+    await expect(readFile(join(tempRoot, "wechat-file-skill", "receive-send-file.md"), "utf8")).resolves.toContain(
+      "send-file.mjs",
+    );
+    await expect(readFile(join(tempRoot, "wechat-video-skill", "receive-send-video.md"), "utf8")).resolves.toContain(
+      "send-video.mjs",
+    );
+  });
 });

package/src/__tests__/orchestrator.test.ts

@@ -146,7 +146,7 @@ describe("handleCommand WeChat processing ack", () => {
     expect(platform.sendCard).toHaveBeenCalledWith(
       "wx-chat",
       "生成中",
-      "该会话正在生成回复中，请等待完成后再发送新消息。",
+      "该会话正在生成回复中，请等待完成后再发送新消息。如需中断生成，请发送 /stop 指令。",
       "yellow",
     );
   });

package/src/__tests__/wechat-platform.test.ts

@@ -1,7 +1,11 @@
 import { beforeEach, describe, expect, it, vi } from "vitest";
+import { mkdtemp, readFile, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
 
 import { buildHelpCard } from "../cards.ts";
 import {
+  _downloadWechatMediaAttachmentsForTest,
   _resetWechatClawStateForTest,
   _setWxMinSendIntervalMsForTest,
   createWechatAdapter,
@@ -109,3 +113,64 @@ describe("createWechatAdapter", () => {
     );
   });
 });
+
+describe("WeChat media receive helpers", () => {
+  it("downloads image, file, and video items and returns message attachment paths", async () => {
+    const tempRoot = await mkdtemp(join(tmpdir(), "chatccc-wx-media-"));
+    const imageDir = join(tempRoot, "images");
+    const fileDir = join(tempRoot, "files");
+    const videoDir = join(tempRoot, "videos");
+    try {
+      const imageMedia = { aes_key: "image-key-1234567890", encrypt_query_param: "image" };
+      const fileMedia = { aes_key: "file-key-1234567890", encrypt_query_param: "file" };
+      const videoMedia = { aes_key: "video-key-1234567890", encrypt_query_param: "video" };
+      const wire = {
+        downloadMedia: vi.fn(async (media: unknown) => {
+          if (media === imageMedia) return Buffer.from("image-data");
+          if (media === fileMedia) return Buffer.from("file-data");
+          if (media === videoMedia) return Buffer.from("video-data");
+          throw new Error("unexpected media");
+        }),
+      };
+
+      const result = await _downloadWechatMediaAttachmentsForTest(
+        {
+          message_id: 123,
+          item_list: [
+            { image_item: { media: imageMedia } },
+            {
+              file_item: {
+                media: fileMedia,
+                file_name: "report.txt",
+                md5: "1234567890abcdef1234567890abcdef",
+              },
+            },
+            {
+              video_item: {
+                media: videoMedia,
+                video_md5: "abcdef1234567890abcdef",
+              },
+            },
+          ],
+        },
+        { wire, imageDir, fileDir, videoDir },
+      );
+
+      expect(result.imagePaths).toHaveLength(1);
+      expect(result.filePaths).toHaveLength(1);
+      expect(result.videoPaths).toHaveLength(1);
+      expect(result.messageLines[0]).toMatch(/^\[图片\] /);
+      expect(result.messageLines[1]).toMatch(/^\[文件\] /);
+      expect(result.messageLines[2]).toMatch(/^\[视频\] /);
+      expect(result.imagePaths[0]).toContain(join("images", "wx_image-key-123456.png"));
+      expect(result.filePaths[0]).toContain(join("files", "wx_1234567890abcdef_report.txt"));
+      expect(result.videoPaths[0]).toContain(join("videos", "wx_abcdef1234567890.mp4"));
+      await expect(readFile(result.imagePaths[0], "utf8")).resolves.toBe("image-data");
+      await expect(readFile(result.filePaths[0], "utf8")).resolves.toBe("file-data");
+      await expect(readFile(result.videoPaths[0], "utf8")).resolves.toBe("video-data");
+      expect(wire.downloadMedia).toHaveBeenCalledTimes(3);
+    } finally {
+      await rm(tempRoot, { recursive: true, force: true });
+    }
+  });
+});

package/src/orchestrator.ts

@@ -889,7 +889,7 @@ export async function handleCommand(
 
       const targetToolLabel = toolDisplayName(target.tool);
       const busyNote = isSessionRunning(target.sessionId)
-        ? "\n\n⚠️ 该会话当前正在生成中，请等待完成后再发送消息。"
+        ? "\n\n⚠️ 该会话当前正在生成中，请等待完成后再发送消息。如需中断生成，请发送 /stop 指令。"
         : "";
       await platform.sendCard(
         chatId,
@@ -991,7 +991,7 @@ export async function handleCommand(
       await platform.sendCard(
         chatId,
         "生成中",
-        "该会话正在生成回复中，请等待完成后再发送新消息。",
+        "该会话正在生成回复中，请等待完成后再发送新消息。如需中断生成，请发送 /stop 指令。",
         "yellow",
       );
       return;

package/src/session.ts

@@ -675,7 +675,7 @@ export async function runAgentSession(
     const isWechatBusy = platform.kind === "wechat";
     const busyMsg = isWechatBusy
       ? "当前正在生成回复中，请等待完成后再发送消息。如需中断生成，请发送 /stop 指令。"
-      : "该会话正在生成回复中，请等待完成后再发送消息。";
+      : "该会话正在生成回复中，请等待完成后再发送消息。如需中断生成，请发送 /stop 指令。";
     await platform.sendText(_chatId, busyMsg).catch(() => {});
     return;
   }
@@ -705,7 +705,9 @@ export async function runAgentSession(
 
     // 构建 IM skills prompt（sessionId 方式，无 token）
     const feishuSkillDir = join(PROJECT_ROOT, "im-skills", "feishu-skill");
-    const wechatSkillDir = join(PROJECT_ROOT, "im-skills", "wechat-skill");
+    const wechatImageSkillDir = join(PROJECT_ROOT, "im-skills", "wechat-image-skill");
+    const wechatFileSkillDir = join(PROJECT_ROOT, "im-skills", "wechat-file-skill");
+    const wechatVideoSkillDir = join(PROJECT_ROOT, "im-skills", "wechat-video-skill");
     const imSkillsCacheDir = join(USER_DATA_DIR, "im-skills");
     const skillVariables = {
       cwd,
@@ -716,7 +718,9 @@ export async function runAgentSession(
       send_image_script: join(feishuSkillDir, "send-image.mjs"),
       send_file_script: join(feishuSkillDir, "send-file.mjs"),
       download_video_script: join(feishuSkillDir, "download-video.mjs"),
-      wechat_send_image_script: join(wechatSkillDir, "send-image.mjs"),
+      wechat_send_image_script: join(wechatImageSkillDir, "send-image.mjs"),
+      wechat_send_file_script: join(wechatFileSkillDir, "send-file.mjs"),
+      wechat_send_video_script: join(wechatVideoSkillDir, "send-video.mjs"),
     };
     var imSkillsPrompt = await buildImSkillsPrompt({ variables: skillVariables });
     await exportSkillSubDocs({ variables: skillVariables }, imSkillsCacheDir);

package/src/wechat-platform.ts

@@ -10,7 +10,7 @@
 
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { createRequire } from "node:module";
-import { dirname, extname, join } from "node:path";
+import { basename, dirname, extname, join } from "node:path";
 import { homedir } from "node:os";
 
 import {
@@ -19,7 +19,7 @@ import {
   type GetUpdatesResponse,
   type WeixinMessage,
 } from "@openilink/openilink-sdk-node";
-import type { CDNMedia, ImageItem } from "@openilink/openilink-sdk-node";
+import type { FileItem, ImageItem, VideoItem } from "@openilink/openilink-sdk-node";
 
 import type { PlatformAdapter } from "./platform-adapter.ts";
 import { setupFileLogging } from "./shared.ts";
@@ -502,8 +502,31 @@ export async function startWechatPlatform(
 }
 
 const WECHAT_IMAGE_DOWNLOAD_DIR = join(homedir(), ".chatccc", "images", "downloads");
+const WECHAT_FILE_DOWNLOAD_DIR = join(homedir(), ".chatccc", "files", "downloads");
+const WECHAT_VIDEO_DOWNLOAD_DIR = join(homedir(), ".chatccc", "videos", "downloads");
 
-function extFromMimeOrName(mime?: string | null, fileName?: string | null): string {
+type WechatMediaDownloader = Pick<OpenIlinkWire, "downloadMedia">;
+
+interface WechatMediaDownloadOptions {
+  wire?: WechatMediaDownloader | null;
+  imageDir?: string;
+  fileDir?: string;
+  videoDir?: string;
+  log?: (msg: string) => void;
+}
+
+interface WechatDownloadedMediaAttachments {
+  imagePaths: string[];
+  filePaths: string[];
+  videoPaths: string[];
+  messageLines: string[];
+}
+
+function extFromMimeOrName(
+  mime?: string | null,
+  fileName?: string | null,
+  fallback = ".bin",
+): string {
   if (mime) {
     const map: Record<string, string> = {
       "image/png": ".png",
@@ -512,6 +535,17 @@ function extFromMimeOrName(mime?: string | null, fileName?: string | null): stri
       "image/gif": ".gif",
       "image/bmp": ".bmp",
       "image/svg+xml": ".svg",
+      "video/mp4": ".mp4",
+      "video/quicktime": ".mov",
+      "video/x-msvideo": ".avi",
+      "video/x-matroska": ".mkv",
+      "video/webm": ".webm",
+      "video/x-flv": ".flv",
+      "text/plain": ".txt",
+      "text/csv": ".csv",
+      "application/pdf": ".pdf",
+      "application/zip": ".zip",
+      "application/gzip": ".gz",
     };
     const key = mime.split(";")[0].trim().toLowerCase();
     if (map[key]) return map[key];
@@ -520,25 +554,145 @@ function extFromMimeOrName(mime?: string | null, fileName?: string | null): stri
     const ext = extname(fileName).toLowerCase();
     if (ext) return ext;
   }
-  return ".png";
+  return fallback;
 }
 
-async function downloadWechatImage(imageItem: ImageItem, msgId?: number): Promise<string> {
-  const wire = ilinkWire;
+async function downloadWechatImage(
+  imageItem: ImageItem,
+  msgId?: number,
+  options: WechatMediaDownloadOptions = {},
+): Promise<string> {
+  const wire = options.wire ?? ilinkWire;
   if (!wire) throw new Error("iLink wire not available");
   if (!imageItem.media) throw new Error("image item has no media");
 
   const data = await wire.downloadMedia(imageItem.media);
   const mime = (imageItem as Record<string, unknown>).mime_type as string | undefined;
-  const ext = extFromMimeOrName(mime);
+  const fileName = (imageItem as Record<string, unknown>).file_name as string | undefined;
+  const ext = extFromMimeOrName(mime, fileName, ".png");
   const key = imageItem.media.aes_key?.slice(0, 16) ?? (msgId?.toString() ?? Date.now().toString());
-  await mkdirSync(WECHAT_IMAGE_DOWNLOAD_DIR, { recursive: true });
-  const localPath = join(WECHAT_IMAGE_DOWNLOAD_DIR, `wx_${key}${ext}`);
+  const downloadDir = options.imageDir ?? WECHAT_IMAGE_DOWNLOAD_DIR;
+  mkdirSync(downloadDir, { recursive: true });
+  const localPath = join(downloadDir, `wx_${key}${ext}`);
   writeFileSync(localPath, data);
   platformLog(`图片已下载: ${localPath}`);
   return localPath;
 }
 
+function safeLocalFileName(fileName: string): string {
+  return basename(fileName).replace(/[<>:"/\\|?*\x00-\x1F]/g, "_");
+}
+
+async function downloadWechatFile(
+  fileItem: FileItem,
+  msgId?: number,
+  options: WechatMediaDownloadOptions = {},
+): Promise<string> {
+  const wire = options.wire ?? ilinkWire;
+  if (!wire) throw new Error("iLink wire not available");
+  if (!fileItem.media) throw new Error("file item has no media");
+
+  const data = await wire.downloadMedia(fileItem.media);
+  const mime = (fileItem as Record<string, unknown>).mime_type as string | undefined;
+  const ext = extFromMimeOrName(mime, fileItem.file_name, ".bin");
+  const key =
+    fileItem.md5?.slice(0, 16) ??
+    fileItem.media.aes_key?.slice(0, 16) ??
+    (msgId?.toString() ?? Date.now().toString());
+  const localName = fileItem.file_name
+    ? `wx_${key}_${safeLocalFileName(fileItem.file_name)}`
+    : `wx_${key}${ext}`;
+  const downloadDir = options.fileDir ?? WECHAT_FILE_DOWNLOAD_DIR;
+  mkdirSync(downloadDir, { recursive: true });
+  const localPath = join(downloadDir, localName);
+  writeFileSync(localPath, data);
+  (options.log ?? platformLog)(`文件已下载: ${localPath}`);
+  return localPath;
+}
+
+async function downloadWechatVideo(
+  videoItem: VideoItem,
+  msgId?: number,
+  options: WechatMediaDownloadOptions = {},
+): Promise<string> {
+  const wire = options.wire ?? ilinkWire;
+  if (!wire) throw new Error("iLink wire not available");
+  if (!videoItem.media) throw new Error("video item has no media");
+
+  const data = await wire.downloadMedia(videoItem.media);
+  const mime = (videoItem as Record<string, unknown>).mime_type as string | undefined;
+  const fileName = (videoItem as Record<string, unknown>).file_name as string | undefined;
+  const ext = extFromMimeOrName(mime, fileName, ".mp4");
+  const key =
+    videoItem.video_md5?.slice(0, 16) ??
+    videoItem.media.aes_key?.slice(0, 16) ??
+    (msgId?.toString() ?? Date.now().toString());
+  const downloadDir = options.videoDir ?? WECHAT_VIDEO_DOWNLOAD_DIR;
+  mkdirSync(downloadDir, { recursive: true });
+  const localPath = join(downloadDir, `wx_${key}${ext}`);
+  writeFileSync(localPath, data);
+  (options.log ?? platformLog)(`视频已下载: ${localPath}`);
+  return localPath;
+}
+
+async function downloadWechatMediaAttachments(
+  message: WeixinMessage,
+  options: WechatMediaDownloadOptions = {},
+): Promise<WechatDownloadedMediaAttachments> {
+  const imagePaths: string[] = [];
+  const filePaths: string[] = [];
+  const videoPaths: string[] = [];
+  const messageLines: string[] = [];
+  const items = message.item_list;
+  if (items) {
+    for (const item of items) {
+      if (item.image_item?.media) {
+        try {
+          const localPath = await downloadWechatImage(item.image_item, message.message_id, options);
+          imagePaths.push(localPath);
+          messageLines.push(`[图片] ${localPath}`);
+        } catch (err) {
+          (options.log ?? platformLog)(`图片下载失败: ${(err as Error).message}`);
+        }
+      }
+
+      if (item.file_item?.media) {
+        try {
+          const localPath = await downloadWechatFile(item.file_item, message.message_id, options);
+          filePaths.push(localPath);
+          messageLines.push(`[文件] ${localPath}`);
+        } catch (err) {
+          (options.log ?? platformLog)(`文件下载失败: ${(err as Error).message}`);
+        }
+      }
+
+      if (item.video_item?.media) {
+        try {
+          const localPath = await downloadWechatVideo(item.video_item, message.message_id, options);
+          videoPaths.push(localPath);
+          messageLines.push(`[视频] ${localPath}`);
+        } catch (err) {
+          (options.log ?? platformLog)(`视频下载失败: ${(err as Error).message}`);
+        }
+      }
+    }
+  }
+
+  return {
+    imagePaths,
+    filePaths,
+    videoPaths,
+    messageLines,
+  };
+}
+
+export async function _downloadWechatMediaAttachmentsForTest(
+  message: WeixinMessage,
+  options: WechatMediaDownloadOptions,
+): Promise<WechatDownloadedMediaAttachments> {
+  return downloadWechatMediaAttachments(message, options);
+}
+
 async function handleWechatMessage(
   message: WeixinMessage,
   handler: MessageHandler,
@@ -564,37 +718,23 @@ async function handleWechatMessage(
   const text = extractText(message).trim();
   const msgTimestamp = message.create_time_ms ?? Date.now();
 
-  // 检测并下载图片
-  const imagePaths: string[] = [];
-  const items = message.item_list;
-  if (items) {
-    for (const item of items) {
-      if (item.image_item?.media) {
-        try {
-          const localPath = await downloadWechatImage(item.image_item, message.message_id);
-          imagePaths.push(localPath);
-        } catch (err) {
-          platformLog(`图片下载失败: ${(err as Error).message}`);
-        }
-      }
-    }
-  }
+  const mediaAttachments = await downloadWechatMediaAttachments(message);
 
-  // 构建消息文本：文本内容 + 图片路径
+  // 构建消息文本：文本内容 + 媒体路径
   let fullText = text;
-  if (imagePaths.length > 0) {
-    const imageLines = imagePaths.map((p) => `[图片] ${p}`).join("\n");
-    fullText = fullText ? `${fullText}\n${imageLines}` : imageLines;
+  if (mediaAttachments.messageLines.length > 0) {
+    const mediaLines = mediaAttachments.messageLines.join("\n");
+    fullText = fullText ? `${fullText}\n${mediaLines}` : mediaLines;
   }
 
-  // 纯图片且无文字时跳过（避免空消息触发会话）
+  // 纯媒体且无可下载内容时跳过（避免空消息触发会话）
   if (!fullText.trim()) {
     platformLog(`跳过纯媒体消息（无文本）: chatId=${chatId}`);
     return;
   }
 
   platformLog(
-    `收到消息: chatId=${chatId} text="${text.slice(0, 80)}" images=${imagePaths.length}`,
+    `收到消息: chatId=${chatId} text="${text.slice(0, 80)}" images=${mediaAttachments.imagePaths.length} files=${mediaAttachments.filePaths.length} videos=${mediaAttachments.videoPaths.length}`,
   );
   appendChatLog(chatId, chatId, fullText);