dsh-email 0.9.0 → 0.9.1

package/README.en.md

@@ -26,7 +26,7 @@ Pure Node, **cross-platform** (one codebase for Windows / macOS / Linux), no she
 
 Once an account is configured, a "whale-girl courier" popup lives in the bottom-right corner of the main UI: it checks for new mail every 30 seconds and shows a card (sender + subject) when something arrives, auto-dismissing after 12 seconds. The popup shares the cursor logic with `email_watch` but keeps its own counter, so they never consume each other's mail.
 
-The popup artwork prefers the locally installed [dsh-deep-whale](https://github.com/Small-tailqwq/dsh-deep-whale) whale-girl skin assets (**never bundled** — read at runtime from your own installation): the artwork is a derivative of the original whale-girl character by [上善](https://www.pixiv.net/users/62155430) (skin by Small-tailqwq), published under CC BY-NC-SA 4.0 (Attribution-NonCommercial-ShareAlike); the popup shows the full attribution chain. A built-in fallback image is used when no skin is installed.
+The popup artwork prefers the locally installed [dsh-deep-whale](https://github.com/Small-tailqwq/dsh-deep-whale) whale-girl skin assets (**never bundled** — read at runtime from your own installation): the artwork is a derivative of the original whale-girl character by [上善](https://www.pixiv.net/users/62155430) (skin by Small-tailqwq), published under CC BY-NC-SA 4.0 (Attribution-NonCommercial-ShareAlike); the popup shows the full attribution chain. Without the skin, a bundled community whale-girl artwork is used (copyright stays with the original author, personal non-commercial use only; removed on request via issue).
 
 Example:
 
@@ -42,7 +42,7 @@ Example:
 
 ## Compatibility
 
-Verified against `@deepseek-ai/dsh@0.1.2-alpha.2` on 2026-08-31. Built for the cordis patch-bundle plugin model (`cordis.patch.yml` + `dsh.bundle.patch`). No runtime imports of `@deepseek-ai/*` internals.
+Verified against `@deepseek-ai/dsh@0.1.2-alpha.3` on 2026-09-01 (settings page / asset route / email_watch fully regression-tested). Built for the cordis patch-bundle plugin model (`cordis.patch.yml` + `dsh.bundle.patch`). No runtime imports of `@deepseek-ai/*` internals.
 
 ## Installation
 

package/README.md

@@ -34,7 +34,7 @@ Email tools for DeepSeek Harness: list, read, search and send mail through stand
 
 配置好账号后，主界面右下角会出现「鲸鱼娘递信」小弹窗：每 30 秒检查一次新邮件，有新邮件时弹出卡片（发件人 + 主题），12 秒自动消失。弹窗与 `email_watch` 工具共用同一套游标逻辑但各自独立计数，互不抢占。
 
-弹窗形象优先使用本地安装的 [dsh-deep-whale](https://github.com/Small-tailqwq/dsh-deep-whale) 鲸鱼娘皮肤素材（**不打包分发**，运行时从你自己的安装目录读取）：该素材为一创 [上善](https://www.pixiv.net/users/62155430) 鲸鱼娘形象的衍生创作（二创 Small-tailqwq），以 CC BY-NC-SA 4.0（署名-非商业性使用-相同方式共享）发布，弹窗内附完整署名链。未安装皮肤时使用内置回退图。
+弹窗形象优先使用本地安装的 [dsh-deep-whale](https://github.com/Small-tailqwq/dsh-deep-whale) 鲸鱼娘皮肤素材（**不打包分发**，运行时从你自己的安装目录读取）：该素材为一创 [上善](https://www.pixiv.net/users/62155430) 鲸鱼娘形象的衍生创作（二创 Small-tailqwq），以 CC BY-NC-SA 4.0（署名-非商业性使用-相同方式共享）发布，弹窗内附完整署名链。未安装皮肤时使用内置的社区鲸鱼娘形象（版权归原作者，仅供个人非商业使用；如有异议请提 Issue，会立即移除）。
 
 示例对话：
 
@@ -42,6 +42,7 @@ Email tools for DeepSeek Harness: list, read, search and send mail through stand
 
 ### 版本记录
 
+- **0.9.1**：修复设置页空主机遮蔽 provider 预设（#3/#6）；IMAP 连接超时不再杀死整个 DSH 进程（#4）；暗色模式输入控件可见（#2）；密码栏提示环境变量 `DSH_EMAIL_PASSWORD` 免明文方案（#5）。
 - **0.9.0**：新增 `email_watch` 增量新邮件检查工具（游标式，适合定时提醒）；Web 端新增「鲸鱼娘递信」新邮件弹窗（本地皮肤素材运行时读取 + 内置回退图）。
 - **0.8.2**：`since` / `until` 参数描述与其余参数统一为英文，方便多语言 agent 理解。
 - **0.8.0/0.8.1**：`email_list` / `email_search` 新增 `since` / `until` 日期范围过滤；新增 `email_health` 自检（账号/连接/配置一键体检）；适配 harness 0.1.2（清理已删除的客户端注入声明）。
@@ -50,7 +51,7 @@ Email tools for DeepSeek Harness: list, read, search and send mail through stand
 
 ## 兼容性
 
-在 `@deepseek-ai/dsh@0.1.2-alpha.2` 上验证（2026-08-31）。遵循 cordis 组合包补丁模型（`cordis.patch.yml` + `dsh.bundle.patch`），运行时不 import 任何 `@deepseek-ai/*` 内部模块。
+在 `@deepseek-ai/dsh@0.1.2-alpha.3` 上实测通过（2026-09-01，设置页/素材路由/email_watch 全回归）。遵循 cordis 组合包补丁模型（`cordis.patch.yml` + `dsh.bundle.patch`），运行时不 import 任何 `@deepseek-ai/*` 内部模块。
 
 ## 安装
 

package/lib/client.js

@@ -51,7 +51,7 @@ const EMPTY = {
 };
 
 const CSS = [
-  ".dshe-settings{display:grid;gap:14px;max-width:900px;padding:8px 2px 32px;color:var(--dsw-alias-fg-primary,#26231f)}",
+  ".dshe-settings{display:grid;gap:14px;max-width:900px;padding:8px 2px 32px;color:var(--dsw-alias-fg-primary,#26231f);color-scheme:light dark}",
   ".dshe-header{display:grid;gap:4px;padding:8px 2px}",
   ".dshe-header h2{font-size:22px;letter-spacing:-.02em;margin:0}",
   ".dshe-header p{max-width:640px;margin:4px 0 0;color:var(--dsw-alias-fg-muted,#77736d);font-size:13px;line-height:1.55}",
@@ -60,7 +60,8 @@ const CSS = [
   ".dshe-grid{display:grid;grid-template-columns:1fr 1fr;gap:12px}",
   ".dshe-field{display:grid;gap:6px}",
   ".dshe-field label{font-size:12px;font-weight:600;color:var(--dsw-alias-fg-primary,#26231f)}",
-  ".dshe-field input[type=text],.dshe-field input[type=password],.dshe-field input[type=number],.dshe-field select{width:100%;box-sizing:border-box;padding:8px 10px;border:1px solid var(--dsw-alias-border-subtle,#dedbd5);border-radius:9px;background:var(--dsw-alias-bg-layer-1,#fff);color:inherit;font:inherit;font-size:13px}",
+  ".dshe-field input[type=text],.dshe-field input[type=password],.dshe-field input[type=number],.dshe-field select,.dshe-field textarea{width:100%;box-sizing:border-box;padding:8px 10px;border:1px solid var(--dsw-alias-border-subtle,#dedbd5);border-radius:9px;background:var(--dsw-alias-bg-layer-1,#fff);color:var(--dsw-alias-fg-primary,#26231f);font:inherit;font-size:13px}",
+  ".dshe-field select option{background:var(--dsw-alias-bg-layer-1,#fff);color:var(--dsw-alias-fg-primary,#26231f)}",
   ".dshe-check{display:flex;gap:8px;align-items:center;font-size:13px}",
   ".dshe-actions{display:flex;gap:8px;flex-wrap:wrap}",
   ".dshe-btn{display:inline-flex;align-items:center;height:32px;padding:0 14px;border-radius:999px;border:1px solid var(--dsw-alias-border-subtle,#dedbd5);background:var(--dsw-alias-bg-layer-1,#fff);color:inherit;font-size:13px;font-weight:600;cursor:pointer}",
@@ -73,7 +74,7 @@ const CSS = [
   ".dshe-details summary{font-size:12px;font-weight:600;cursor:pointer;color:var(--dsw-alias-fg-muted,#77736d)}",
   ".dshe-hint{font-size:12px;color:var(--dsw-alias-fg-muted,#77736d);line-height:1.5}",
   ".dshe-whale-root{position:fixed;right:20px;bottom:20px;z-index:2147483000;pointer-events:none}",
-  ".dshe-whale-card{pointer-events:auto;position:relative;width:300px;border:1px solid var(--dsw-alias-border-subtle,#dedbd5);border-radius:14px;background:var(--dsw-alias-bg-layer-1,#fff);box-shadow:0 10px 30px rgba(0,0,0,.18);overflow:hidden;animation:dshe-whale-in .35s ease-out;font-size:13px;color:var(--dsw-alias-fg-primary,#26231f)}",
+  ".dshe-whale-card{pointer-events:auto;position:relative;width:300px;border:1px solid var(--dsw-alias-border-subtle,#dedbd5);border-radius:14px;background:var(--dsw-alias-bg-layer-1,#fff);box-shadow:0 10px 30px rgba(0,0,0,.18);overflow:hidden;animation:dshe-whale-in .35s ease-out;font-size:13px;color:var(--dsw-alias-fg-primary,#26231f);color-scheme:light dark}",
   "@keyframes dshe-whale-in{from{opacity:0;transform:translateY(14px)}to{opacity:1;transform:translateY(0)}}",
   ".dshe-whale-img{display:block;width:100%;height:120px;object-fit:cover;object-position:center top;background:#eaf3f8}",
   ".dshe-whale-body{padding:10px 12px 12px;display:grid;gap:6px}",
@@ -219,6 +220,7 @@ function EmailSettingsSection() {
             placeholder: "不是登录密码；QQ/163 在邮箱设置里生成授权码",
             onChange: (e) => update({ password: e.target.value }),
           }),
+          h("div", { className: "dshe-hint" }, "不想明文保存？此栏留空，改用环境变量 DSH_EMAIL_PASSWORD（仅单账号时生效）。"),
         ]),
         h("div", { className: "dshe-field" }, [
           h("label", null, "收件文件夹（默认 INBOX）"),

package/lib/mail-client.js

@@ -120,7 +120,7 @@ export class EmailPool {
         return this.enqueue(name, () => this.imapRun(name, cfg, folder, run));
     }
     createImap(cfg) {
-        return new ImapFlow({
+        const client = new ImapFlow({
             host: cfg.imap.host,
             port: cfg.imap.port,
             secure: cfg.imap.secure,
@@ -130,6 +130,19 @@ export class EmailPool {
             greetingTimeout: 30000,
             socketTimeout: cfg.imap.socketTimeoutMs ?? 60000,
         });
+        // ImapFlow emits 'error' on socket timeouts/drops; without a listener Node
+        // escalates it to an uncaught exception and kills the whole DSH process
+        // (issue #4). Swallow it here and reap the dead connection when idle —
+        // in-flight calls fail through their own promise paths instead.
+        client.on('error', () => {
+            for (const [name, entry] of this.imaps) {
+                if (entry.client === client && entry.inUse === 0) {
+                    void this.evictImap(name);
+                    return;
+                }
+            }
+        });
+        return client;
     }
     async imapRun(name, cfg, folder, run) {
         let entry = this.imaps.get(name);

package/lib/settings.js

@@ -83,7 +83,9 @@ export function toEmailConfig(value, user) {
     if (user === null || user?.imap !== undefined) {
         const fields = user === null ? value.imap : (user.imap ?? {});
         const imap = {};
-        if (fields.host !== undefined)
+        // Empty host means "use the provider preset" — never project it, or the
+        // preset gets shadowed by '' (issues #3 / #6).
+        if (fields.host !== undefined && value.imap.host !== '')
             imap.host = value.imap.host;
         if (fields.port !== undefined)
             imap.port = value.imap.port;
@@ -94,7 +96,7 @@ export function toEmailConfig(value, user) {
     if (user === null || user?.smtp !== undefined) {
         const fields = user === null ? value.smtp : (user.smtp ?? {});
         const smtp = {};
-        if (fields.host !== undefined)
+        if (fields.host !== undefined && value.smtp.host !== '')
             smtp.host = value.smtp.host;
         if (fields.port !== undefined)
             smtp.port = value.smtp.port;

package/lib/web.js

@@ -13,6 +13,8 @@ const SKIN_PACKAGES = [
     '@dsh-external/dsh-client-ui-skin-maid-atelier',
 ];
 const WHALE_CREDIT = '鲸鱼娘：一创 上善（pixiv 62155430）· 二创 Small-tailqwq / dsh-deep-whale · CC BY-NC-SA 4.0（非商业）';
+/** Credit shown with the bundled fallback artwork (community fan character). */
+const FALLBACK_CREDIT = '鲸鱼娘：社区同人形象，版权归原作者，仅供个人非商业使用；如有异议请提 Issue 移除';
 let whaleCache;
 function pickFromDir(dir) {
     let names = [];
@@ -36,10 +38,12 @@ function contentTypeOf(file) {
     return 'image/png';
 }
 /**
- * Locate the whale-girl artwork at runtime. It is never bundled: the skin art
- * is CC BY-NC-SA 4.0, so dsh-email only serves it from the user's own
- * installed dsh-deep-whale skin package (with the attribution chain shown in
- * the widget); otherwise the bundled MIT fallback is served.
+ * Locate the whale-girl artwork at runtime. Skin art is never bundled: it is
+ * CC BY-NC-SA 4.0, so dsh-email only serves it from the user's own installed
+ * dsh-deep-whale skin package (with the attribution chain shown in the
+ * widget). Without the skin, a bundled community whale-girl artwork is
+ * served with its own credit line (copyright stays with the original author;
+ * personal non-commercial use, removed on request via issue).
  */
 function findWhaleAsset() {
     if (whaleCache !== undefined)
@@ -60,7 +64,7 @@ function findWhaleAsset() {
     }
     const fallback = join(packageDir, 'assets', 'whale-fallback.png');
     if (existsSync(fallback)) {
-        whaleCache = { file: fallback, contentType: 'image/png', skin: false, credit: '' };
+        whaleCache = { file: fallback, contentType: 'image/png', skin: false, credit: FALLBACK_CREDIT };
         return whaleCache;
     }
     return whaleCache;
@@ -130,6 +134,16 @@ export class EmailSettingsBackend {
             await pool.withImap(settings.defaultAccount, null, async () => 'connected');
             return { ok: true, ms: Date.now() - started };
         }
+        catch (error) {
+            // imapflow reports failed LOGIN as a bare "Command failed"; surface an
+            // actionable hint instead of the opaque message.
+            const raw = messageOf(error, 'unknown error');
+            const lower = raw.toLowerCase();
+            if (lower.includes('command failed') || lower.includes('authentication') || lower.includes('login')) {
+                throw new Error('邮箱登录失败：请检查邮箱地址与授权码（' + raw + '）');
+            }
+            throw error;
+        }
         finally {
             pool.dispose();
         }
@@ -231,8 +245,8 @@ export class EmailSettingsBackend {
             res.setHeader('Content-Type', asset.contentType);
             res.setHeader('Content-Length', String(bytes.length));
             res.setHeader('Cache-Control', 'no-store');
-            if (asset.credit !== '')
-                res.setHeader('X-Whale-Credit', asset.credit);
+            // No credit header: HTTP header values must be latin-1, and the widget
+            // already shows the credit from the snapshot JSON.
             res.writeHead(200);
             res.end(bytes);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-email",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "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",