dsh-email 0.6.0 → 0.6.2

package/README.md

@@ -2,6 +2,11 @@
 
 # dsh-email
 
+> **给 agent 一个邮箱**：八个国内邮箱预设开箱即用，收发/搜索/附件下载全搞定。
+
+![npm version](https://img.shields.io/npm/v/dsh-email?label=npm&color=blue) ![npm downloads](https://img.shields.io/npm/dm/dsh-email) ![license](https://img.shields.io/npm/l/dsh-email) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-email?style=social)
+
+
 ![dsh-email banner](https://raw.githubusercontent.com/STARDUSTLC666/dsh-email/main/assets/banner.png)
 
 
@@ -158,3 +163,4 @@ MIT。这是一个社区插件，与 DeepSeek 官方无关；`@deepseek-ai/*`
 - [dsh-slack](https://github.com/STARDUSTLC666/dsh-slack) — Slack 通知/收件箱
 - [dsh-dingtalk](https://github.com/STARDUSTLC666/dsh-dingtalk) — 钉钉群通知（零依赖）
 - [dsh-email](https://github.com/STARDUSTLC666/dsh-email) — 邮件六件套 + Web 设置页
+

package/lib/index.js

@@ -118,6 +118,14 @@ const attachmentSchema = {
 function oneText(text) {
     return [{ type: 'text', text }];
 }
+function normalizeAttachmentPaths(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (!Array.isArray(value) || value.some(path => typeof path !== 'string' || path.trim() === '')) {
+        throw new Error('attachments 必须是文件路径字符串数组（且不能包含空字符串）');
+    }
+    return value.map(path => path.trim());
+}
 function describeMessage(message) {
     const from = message.from.map(a => a.name ?? a.address).filter(Boolean).join(', ') || '(未知)';
     const flags = [
@@ -300,7 +308,7 @@ export function apply(ctx, config = {}) {
                 throw new Error('to 不能为空');
             if (typeof args.subject !== 'string' || args.subject.trim() === '')
                 throw new Error('subject 不能为空');
-            return await getPool().send(args.account, args.to.trim(), args.subject.trim(), typeof args.text === 'string' ? args.text : undefined, typeof args.cc === 'string' && args.cc.trim() !== '' ? args.cc.trim() : undefined, Array.isArray(args.attachments) ? args.attachments : undefined);
+            return await getPool().send(args.account, args.to.trim(), args.subject.trim(), typeof args.text === 'string' ? args.text : undefined, typeof args.cc === 'string' && args.cc.trim() !== '' ? args.cc.trim() : undefined, normalizeAttachmentPaths(args.attachments));
         },
     });
     ctx.tools.register({

package/lib/mail-client.js

@@ -64,6 +64,11 @@ export function messageMatchesQuery(subject, fromText, body, query) {
         || fromText.toLowerCase().includes(q)
         || body.toLowerCase().includes(q);
 }
+function flattenAddressText(value) {
+    return flattenAddresses(value)
+        .map(a => (a.name ?? '') + ' ' + (a.address ?? ''))
+        .join(' ');
+}
 function toIso(date) {
     return date instanceof Date ? date.toISOString() : '';
 }
@@ -252,12 +257,13 @@ export class EmailPool {
         const folderName = folder || cfg.inboxFolder;
         return this.withImap(name, folderName, async (client) => {
             // No nested OR and no TEXT search: several servers (QQ among them)
-            // silently answer those with empty or match-everything results. Three
-            // independent searches unioned client-side behave well everywhere.
+            // silently answer those with empty or match-everything results.
+            // subject/from/to/cc searches unioned client-side behave well everywhere.
             const found = await Promise.all([
                 client.search({ subject: query }, { uid: true }),
                 client.search({ from: query }, { uid: true }),
                 client.search({ to: query }, { uid: true }),
+                client.search({ cc: query }, { uid: true }),
             ]);
             const uids = [...new Set(found.flatMap(result => result === false ? [] : result))].sort((a, b) => a - b);
             uids.reverse();
@@ -284,13 +290,19 @@ export class EmailPool {
             if (out.length >= limit)
                 break;
             const subject = message.envelope?.subject ?? '';
-            const fromText = flattenAddresses(message.envelope?.from).map(a => (a.name ?? '') + ' ' + (a.address ?? '')).join(' ');
+            const recipientSearchText = [message.envelope?.from, message.envelope?.to, message.envelope?.cc]
+                .map(flattenAddressText).join(' ');
             let body = '';
             if (message.source !== undefined) {
-                const parsed = await parseRawMessage(message.source, 4096);
-                body = parsed.text;
+                try {
+                    const parsed = await parseRawMessage(message.source, 4096);
+                    body = parsed.text;
+                }
+                catch {
+                    // 单封邮件解析失败不应中断整批回退扫描，继续用 subject/from/to/cc 匹配。
+                }
             }
-            if (messageMatchesQuery(subject, fromText, body, query)) {
+            if (messageMatchesQuery(subject, recipientSearchText, body, query)) {
                 out.push(listedFrom(message, message.size, structureHasAttachment(message.bodyStructure)));
             }
         }
@@ -300,7 +312,9 @@ export class EmailPool {
         if (uids.length === 0)
             return [];
         const fetched = await client.fetchAll(uids, { uid: true, envelope: true, flags: true, size: true, bodyStructure: true }, { uid: true });
-        return fetched.map(message => listedFrom(message, message.size, structureHasAttachment(message.bodyStructure)));
+        return fetched
+            .map(message => listedFrom(message, message.size, structureHasAttachment(message.bodyStructure)))
+            .sort((a, b) => b.uid - a.uid);
     }
     async read(accountName, uid, folder) {
         const name = this.resolveName(accountName);
@@ -396,7 +410,11 @@ export class EmailPool {
 export async function validateAttachmentPaths(paths, maxBytes) {
     const out = [];
     let total = 0;
-    for (const path of paths) {
+    for (const rawPath of paths) {
+        if (typeof rawPath !== 'string' || rawPath.trim() === '') {
+            throw new MailError('附件路径无效：' + String(rawPath));
+        }
+        const path = rawPath.trim();
         let info;
         try {
             info = await stat(path);

package/package.json

@@ -1,74 +1,71 @@
-{
-  "name": "dsh-email",
-  "version": "0.6.0",
-  "description": "IMAP/SMTP email tools for DeepSeek Harness: list, read, search and send mail, with QQ/163/126/Sina/Aliyun/Gmail/Outlook/iCloud presets.",
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./client": "./lib/client.js",
-    "./cordis.patch.yml": "./cordis.patch.yml",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib",
-    "cordis.patch.yml",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "prepare": "tsc",
-    "prepublishOnly": "pnpm run build",
-    "test": "pnpm run build && node --test \"test/*.test.mjs\""
-  },
-  "keywords": [
-    "dsh-plugin",
-    "deepseek-harness",
-    "dsh",
-    "email",
-    "imap",
-    "smtp"
-  ],
-  "author": "stardustlc",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/STARDUSTLC666/dsh-email"
-  },
-  "bugs": {
-    "url": "https://github.com/STARDUSTLC666/dsh-email/issues"
-  },
-  "homepage": "https://github.com/STARDUSTLC666/dsh-email#readme",
-  "license": "MIT",
-  "packageManager": "pnpm@11.7.0",
-  "engines": {
-    "node": ">=20"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [
-        "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-client-ui-settings"
-      ],
-      "platform": "web"
-    }
-  },
-  "dependencies": {
-    "imapflow": "^1.7.0",
-    "mailparser": "^3.9.15",
-    "nodemailer": "^9.0.5",
-    "schemastery": "^3.18.0",
-    "yaml": "^2.9.0"
-  },
-  "devDependencies": {
-    "@types/node": "^26.2.0",
-    "@types/nodemailer": "^8.0.1",
-    "typescript": "^5.7.3"
-  }
-}
+{
+  "name": "dsh-email",
+  "version": "0.6.2",
+  "description": "IMAP/SMTP email tools for DeepSeek Harness: list, read, search and send mail, with QQ/163/126/Sina/Aliyun/Gmail/Outlook/iCloud presets.",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "dsh",
+    "email",
+    "imap",
+    "smtp"
+  ],
+  "author": "stardustlc",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/STARDUSTLC666/dsh-email"
+  },
+  "bugs": {
+    "url": "https://github.com/STARDUSTLC666/dsh-email/issues"
+  },
+  "homepage": "https://github.com/STARDUSTLC666/dsh-email#readme",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ],
+      "platform": "web"
+    }
+  },
+  "dependencies": {
+    "imapflow": "^1.7.0",
+    "mailparser": "^3.9.15",
+    "nodemailer": "^9.0.5",
+    "schemastery": "^3.18.0",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "@types/nodemailer": "^8.0.1",
+    "typescript": "^5.7.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "pnpm run build && node --test \"test/*.test.mjs\""
+  }
+}