dsh-email 0.14.1 → 0.14.3

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.14.3（2026-09-28）
+
+- 兼容验证更新到 Harness 0.2.0-rc.1：282 项邮件测试与 18 插件共同加载检查通过。
+- 运行时代码未变；同步中英文兼容性声明。
+
+## 0.14.2（2026-09-28）
+
+- 修复 [#17](https://github.com/STARDUSTLC666/dsh-email/issues/17)：空主机配合未修改的表单默认端口/TLS 不再覆盖服务商预设；Outlook 恢复 587/STARTTLS。旧设置转换和 Harness 0.1.7 已迁移配置共用归一化规则，保留自定义主机、非默认组合和不含占位 host 的显式端口覆盖。
+- 感谢 [SenkjM 的 PR #18](https://github.com/STARDUSTLC666/dsh-email/pull/18) 提供复现与修复方向。本次补齐新版运行时路径并避免误删明确的端口设置；282 项邮件测试通过。配置和界面验证不代表真实 SMTP 投递已验证。
+
 ## 0.14.1（2026-09-27）
 
 - 未补全的账号和服务器预设会显示未保存提示；避免草稿丢失和错误的“已保存”状态。测试连接只校验所选账号，错误直接指向设置页中的对应字段。

package/README.en.md

@@ -1,10 +1,10 @@
 # dsh-email
 
-## 0.14.1 update (2026-09-27)
+## 0.14.2 update (2026-09-28)
 
-Incomplete account and server-preset drafts display an unsaved status and are protected against accidental navigation. Connection tests validate the selected account independently and identify the relevant settings field.
+Fixes saved blank-host defaults overriding Outlook's 587/STARTTLS preset, including legacy settings migrated to Harness 0.1.7. Explicit custom hosts, ports and TLS choices remain effective. Thanks to [SenkjM for the reproduction and proposed fix in #17 / #18](https://github.com/STARDUSTLC666/dsh-email/pull/18).
 
-Validation host: Harness 0.1.7-rc.2 built from official sources, retaining the local tool-scheduler fix. Build and automated checks pass; interactive coverage and external-service limits are recorded in this release round.
+Validation host: Harness `0.2.0-rc.1` built from official sources (commit `407e65c8`) with Node `24.16.0` on 2026-09-28. All 282 plugin tests pass in an isolated environment; all 18 plugins mount together in one host registering 10 tools, with tool schemas and health-check contracts passing. No live ports or external services were exercised in this round.
 
 ![npm](https://img.shields.io/npm/v/dsh-email) ![downloads](https://img.shields.io/npm/dm/dsh-email) ![license](https://img.shields.io/github/license/STARDUSTLC666/dsh-email) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-email?style=social)
 
@@ -53,7 +53,7 @@ Example:
 - **0.10.8 and earlier**: see [CHANGELOG.md](CHANGELOG.md).
 ## Compatibility
 
-The current baseline is official-source Harness **0.1.7-alpha.2** (2026-09-23, with a local `Symbol.for` tool-scheduler fix). All 18 plugins load together. Legacy migration, editing and automatic saving in the real Web UI, refresh, revision conflicts and restart persistence have been checked with isolated fixture accounts. No live mailbox connection or sending was exercised in this round.
+The current baseline is official-source Harness **0.2.0-rc.1** (2026-09-28, with a local `Symbol.for` tool-scheduler fix). All 18 plugins load together. Settings coverage includes legacy migration, real Web UI editing and automatic saving, refresh, revision conflicts and restart persistence with isolated fixture accounts. No live mailbox connection or sending was exercised in this round.
 
 2026-09-21: the current release package was installed through the official CLI in an isolated profile and co-loaded with the other two most-downloaded plugins on source-built Harness `0.1.6-alpha.2`. All 18 plugin tools registered; calendar/email configuration checks, PPT theme listing and 17-row table generation passed. The host is based on the official alpha.2 release plus the tool-scheduler `Symbol.for` fix (`93badd88`). This run did not connect to live mail or calendar services.
 

package/README.md

@@ -2,11 +2,11 @@
 
 # dsh-email
 
-## 0.14.1 更新（2026-09-27）
+## 0.14.2 更新（2026-09-28）
 
-未补全的账号和服务器预设会显示未保存提示；避免草稿丢失和错误的“已保存”状态。测试连接只校验所选账号，错误直接指向设置页中的对应字段。
+修复保存过的空服务器默认值覆盖 Outlook 预设的问题：恢复 `587 / STARTTLS`，并覆盖 Harness 0.1.7 的旧配置迁移路径。明确设置的自定义主机、端口和 TLS 仍然生效。感谢 [SenkjM 在 #17 / #18 提供复现和修复方向](https://github.com/STARDUSTLC666/dsh-email/pull/18)。
 
-验证宿主：官方源码构建的 Harness 0.1.7-rc.2（保留本地工具调度器修复）。构建与自动测试通过；实际操作和外部服务限制见本轮验收记录。
+验证宿主：官方源码构建的 Harness `0.2.0-rc.1`（commit `407e65c8`）+ Node `24.16.0`（2026-09-28）。282 项插件测试在隔离环境全部通过；同一个宿主里 18 个插件共同加载，注册 10 个工具，工具 schema 与健康检查契约通过。本轮未启用真实端口与外部服务。
 
 > **让 agent 协助处理邮件**：收发、搜索、回复转发、附件、邮件整理与新邮件提醒，支持八种常见邮箱服务预设。
 
@@ -61,7 +61,7 @@ IMAP/SMTP email tools for DeepSeek Harness, with replies, forwarding, mailbox or
 - **0.10.8 及更早**：见 [CHANGELOG.md](CHANGELOG.md)。
 ## 兼容性
 
-当前验证基线为官方源码构建的 Harness **0.1.7-alpha.2**（2026-09-23，含本地工具调度器 `Symbol.for` 修复）。18 个插件共同加载；邮件设置已通过旧配置迁移、真实网页编辑与自动保存、刷新恢复、修订冲突和重启持久化检查。本轮使用隔离测试账号，未连接真实邮箱或发送邮件。
+当前验证基线为官方源码构建的 Harness **0.2.0-rc.1**（2026-09-28，含本地工具调度器 `Symbol.for` 修复）。18 个插件共同加载；邮件设置覆盖旧配置迁移、真实网页编辑与自动保存、刷新恢复、修订冲突和重启持久化检查。本轮使用隔离测试账号，未连接真实邮箱或发送邮件。
 
 2026-09-21：当前发布包经官方 CLI 安装到隔离 profile，在源码构建的 Harness `0.1.6-alpha.2` 上与另外两个下载量前三插件共同加载，18 个插件工具注册正常；日历/邮件配置自检、PPT 主题查询和 17 行表格生成通过。测试本体基于官方 alpha.2 发布提交，另含工具调度器 `Symbol.for` 修复（`93badd88`）。本轮未连接真实邮箱或日历服务。
 

package/lib/config.d.ts

@@ -56,6 +56,18 @@ export interface SmtpConfig {
     port?: number;
     secure?: boolean;
 }
+/** Legacy form placeholders; an untouched blank-host endpoint delegates to its provider. */
+export declare const ENDPOINT_DEFAULTS: {
+    readonly imap: {
+        readonly port: 993;
+        readonly secure: true;
+    };
+    readonly smtp: {
+        readonly port: 465;
+        readonly secure: true;
+    };
+};
+export declare function normalizeSettingsEndpoint<T extends SmtpConfig>(value: T, kind: keyof typeof ENDPOINT_DEFAULTS): Omit<T, 'host' | 'port' | 'secure'> & SmtpConfig;
 /** One mailbox account. Top-level shorthand fields act as shared defaults. */
 export interface AccountConfig {
     /** Built-in provider name, or a custom serverPresets name. */

package/lib/config.js

@@ -34,6 +34,24 @@ export const OUTLOOK_IMAP_HOST = 'outlook.office365.com';
  * them, so such a release asks every built-in account to log in one more time.
  */
 export const OUTLOOK_OAUTH2_CLIENT_ID = '15dcd5aa-00dd-487f-82d7-1d2b2c299e14';
+/** Legacy form placeholders; an untouched blank-host endpoint delegates to its provider. */
+export const ENDPOINT_DEFAULTS = {
+    imap: { port: 993, secure: true }, smtp: { port: 465, secure: true },
+};
+export function normalizeSettingsEndpoint(value, kind) {
+    if (typeof value.host !== 'string' || value.host.trim() !== '')
+        return value;
+    const normalized = { ...value };
+    delete normalized.host;
+    const defaults = ENDPOINT_DEFAULTS[kind];
+    // A changed port or TLS choice is intentional; preserve that whole combination.
+    if ((value.port === undefined || value.port === defaults.port)
+        && (value.secure === undefined || value.secure === defaults.secure)) {
+        delete normalized.port;
+        delete normalized.secure;
+    }
+    return normalized;
+}
 export const PROVIDER_PRESETS = {
     qq: { imap: { host: 'imap.qq.com', port: 993, secure: true }, smtp: { host: 'smtp.qq.com', port: 465, secure: true } },
     '163': { imap: { host: 'imap.163.com', port: 993, secure: true }, smtp: { host: 'smtp.163.com', port: 465, secure: true } },
@@ -340,17 +358,21 @@ function resolveAccount(name, common, acc, allowEnvPassword, providers, known) {
     const authUser = (acc.authUser ?? common.authUser ?? '').trim() || user;
     const authPassword = (acc.authPassword ?? common.authPassword) || password;
     const senderName = (acc.senderName ?? common.senderName ?? '').trim();
+    const accountImap = acc.imap && normalizeSettingsEndpoint(acc.imap, 'imap');
+    const sharedImap = common.imap && normalizeSettingsEndpoint(common.imap, 'imap');
+    const accountSmtp = acc.smtp && normalizeSettingsEndpoint(acc.smtp, 'smtp');
+    const sharedSmtp = common.smtp && normalizeSettingsEndpoint(common.smtp, 'smtp');
     const imap = {
-        host: acc.imap?.host ?? common.imap?.host ?? preset?.imap.host,
-        port: acc.imap?.port ?? common.imap?.port ?? preset?.imap.port,
-        secure: acc.imap?.secure ?? common.imap?.secure ?? preset?.imap.secure,
-        connectionTimeoutMs: acc.imap?.connectionTimeoutMs ?? common.imap?.connectionTimeoutMs,
-        socketTimeoutMs: acc.imap?.socketTimeoutMs ?? common.imap?.socketTimeoutMs,
+        host: accountImap?.host ?? sharedImap?.host ?? preset?.imap.host,
+        port: accountImap?.port ?? sharedImap?.port ?? preset?.imap.port,
+        secure: accountImap?.secure ?? sharedImap?.secure ?? preset?.imap.secure,
+        connectionTimeoutMs: accountImap?.connectionTimeoutMs ?? sharedImap?.connectionTimeoutMs,
+        socketTimeoutMs: accountImap?.socketTimeoutMs ?? sharedImap?.socketTimeoutMs,
     };
     const smtp = {
-        host: acc.smtp?.host ?? common.smtp?.host ?? preset?.smtp.host,
-        port: acc.smtp?.port ?? common.smtp?.port ?? preset?.smtp.port,
-        secure: acc.smtp?.secure ?? common.smtp?.secure ?? preset?.smtp.secure,
+        host: accountSmtp?.host ?? sharedSmtp?.host ?? preset?.smtp.host,
+        port: accountSmtp?.port ?? sharedSmtp?.port ?? preset?.smtp.port,
+        secure: accountSmtp?.secure ?? sharedSmtp?.secure ?? preset?.smtp.secure,
     };
     const problems = [];
     if (user === '')

package/lib/settings.js

@@ -1,5 +1,5 @@
 import z from 'schemastery';
-import { PROVIDER_NAMES } from './config.js';
+import { ENDPOINT_DEFAULTS, normalizeSettingsEndpoint, PROVIDER_NAMES } from './config.js';
 /** Settings-document namespace this plugin owns (editable from the Web settings page). */
 export const SETTINGS_NAMESPACE = 'dsh-email';
 /**
@@ -22,13 +22,13 @@ export const EmailSettingsSchema = z.object({
     serverPresets: z.string().default(''),
     imap: z.object({
         host: z.string().default(''),
-        port: z.number().default(993),
-        secure: z.boolean().default(true),
+        port: z.number().default(ENDPOINT_DEFAULTS.imap.port),
+        secure: z.boolean().default(ENDPOINT_DEFAULTS.imap.secure),
     }),
     smtp: z.object({
         host: z.string().default(''),
-        port: z.number().default(465),
-        secure: z.boolean().default(true),
+        port: z.number().default(ENDPOINT_DEFAULTS.smtp.port),
+        secure: z.boolean().default(ENDPOINT_DEFAULTS.smtp.secure),
     }),
 });
 /** Project the row config (cordis.patch.yml) into the settings-schema base shape. */
@@ -45,15 +45,15 @@ export function toSettingsBase(config) {
         ...(config.imap !== undefined ? {
             imap: {
                 host: config.imap.host ?? '',
-                port: config.imap.port ?? 993,
-                secure: config.imap.secure ?? true,
+                port: config.imap.port ?? ENDPOINT_DEFAULTS.imap.port,
+                secure: config.imap.secure ?? ENDPOINT_DEFAULTS.imap.secure,
             },
         } : {}),
         ...(config.smtp !== undefined ? {
             smtp: {
                 host: config.smtp.host ?? '',
-                port: config.smtp.port ?? 465,
-                secure: config.smtp.secure ?? true,
+                port: config.smtp.port ?? ENDPOINT_DEFAULTS.smtp.port,
+                secure: config.smtp.secure ?? ENDPOINT_DEFAULTS.smtp.secure,
             },
         } : {}),
     };
@@ -131,7 +131,9 @@ export function toEmailConfig(value, user) {
     // serverPresets is intentionally NOT projected: it is UI-side metadata that
     // resolution never reads, and projecting it would put it into the resolved
     // fingerprint, so saving a preset would dispose every live IMAP connection.
-    const imapValue = draft.imap;
+    // Only a persisted blank host signals a placeholder. A schema-added blank
+    // host must not erase an explicit port-only override from the raw document.
+    const imapValue = user?.imap?.host !== undefined && draft.imap ? normalizeSettingsEndpoint(draft.imap, 'imap') : draft.imap;
     const imapKeys = user === null ? imapValue : user?.imap;
     if (isSet(imapKeys) && isSet(imapValue)) {
         const imap = {};
@@ -145,7 +147,7 @@ export function toEmailConfig(value, user) {
             imap.secure = imapValue.secure;
         out.imap = imap;
     }
-    const smtpValue = draft.smtp;
+    const smtpValue = user?.smtp?.host !== undefined && draft.smtp ? normalizeSettingsEndpoint(draft.smtp, 'smtp') : draft.smtp;
     const smtpKeys = user === null ? smtpValue : user?.smtp;
     if (isSet(smtpKeys) && isSet(smtpValue)) {
         const smtp = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-email",
-  "version": "0.14.1",
+  "version": "0.14.3",
   "description": "DSH 邮件插件：IMAP/SMTP 收发搜索、回复转发、附件与整理，多账号卡片设置页、Outlook OAuth2 登录与发信审批。",
   "type": "module",
   "main": "lib/index.js",