@dsh-plus/notify-email 0.1.49 → 0.1.50

package/lib/index.d.ts

@@ -3,7 +3,6 @@ import { UnwrapVolatile } from "@dsh-plus/shared";
 import z from "@deepseek-ai/schemastery";
 //#region src/config.d.ts
 declare const Config: z<Schemastery.ObjectS<NoInfer<{
-  enabled: z<boolean, boolean, "volatile-defined">;
   smtp: z<NoInfer<Schemastery.ObjectS<NoInfer<{
     host: z<string, string, "defined">;
     port: z<number, number, "defined">;
@@ -37,7 +36,6 @@ declare const Config: z<Schemastery.ObjectS<NoInfer<{
   maxBodyChars: z<number, number, "volatile-defined">;
   dryRun: z<boolean, boolean, "volatile-defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
-  enabled: z<boolean, boolean, "volatile-defined">;
   smtp: z<NoInfer<Schemastery.ObjectS<NoInfer<{
     host: z<string, string, "defined">;
     port: z<number, number, "defined">;
@@ -134,12 +132,12 @@ declare class NotifyEmailService extends Service {
   dispatchDecision(call: DecisionCall): Promise<void>;
   /** 任务停止类观察入口（turn-end watcher 调用）。 */
   dispatchTurnEnd(info: TurnEndInfo): Promise<void>;
-  /** 配置卡片「发送测试邮件」：绕过 enabled 门禁，仍需 SMTP 完整。 */
+  /** 配置卡片「发送测试邮件」：走与常规通知同一条发送路径。 */
   sendTest(): Promise<{
     ok: boolean;
     detail: string;
   }>;
-  /** 通用直发接口（如 lifeboat 故障告警）：走正常 enabled/完整性门禁。 */
+  /** 通用直发接口（如 lifeboat 故障告警）：走正常完整性门禁。 */
   sendNotice(notice: {
     subject: string;
     text: string;

package/lib/index.js

@@ -97,7 +97,6 @@ const TriggerSchema = z.object({
 	onPlanReview: z.boolean().description("plan 待审批时通知").default(true)
 });
 const Config = z.object({
-	enabled: z.boolean().description("总开关").default(false).volatile(),
 	smtp: SmtpSchema.default({
 		host: "",
 		port: 465,
@@ -173,16 +172,9 @@ var Mailer = class {
 		this.audit = audit;
 		this.credentials = credentials;
 	}
-	/**
-	* 常规通知发送：受 enabled 与配置完整性门禁。
-	* @param force 为 true 时跳过 enabled 门禁（配置卡片的「发送测试邮件」），仍需 SMTP 完整。
-	*/
-	async send(msg, force = false) {
+	/** 通知发送：受配置完整性门禁（整行开关由官方行开关承担）。 */
+	async send(msg) {
 		const cfg = this.resolveConfig();
-		if (!force && !cfg.enabled) return this.record(msg, cfg, {
-			ok: false,
-			detail: "disabled"
-		});
 		if (cfg.smtp.host.length === 0 || cfg.smtp.from.length === 0 || cfg.to.length === 0) return this.record(msg, cfg, {
 			ok: false,
 			detail: "incomplete"
@@ -480,14 +472,14 @@ var NotifyEmailService = class extends Service {
 	async dispatchTurnEnd(info) {
 		await this.dispatch("turn-end", info, (t) => t.onTurnEnd?.(info));
 	}
-	/** 配置卡片「发送测试邮件」：绕过 enabled 门禁，仍需 SMTP 完整。 */
+	/** 配置卡片「发送测试邮件」：走与常规通知同一条发送路径。 */
 	async sendTest() {
 		return this.mailer.send({
 			subject: "[DSH] 邮件通知测试",
 			text: "这是一封来自 dsh notify-email 插件的测试邮件。"
-		}, true);
+		});
 	}
-	/** 通用直发接口（如 lifeboat 故障告警）：走正常 enabled/完整性门禁。 */
+	/** 通用直发接口（如 lifeboat 故障告警）：走正常完整性门禁。 */
 	async sendNotice(notice) {
 		return this.mailer.send(notice);
 	}
@@ -502,7 +494,7 @@ var NotifyEmailService = class extends Service {
 			}
 			if (notice === void 0) continue;
 			const result = await this.mailer.send(notice);
-			if (!result.ok && result.detail !== "disabled" && result.detail !== "incomplete") this.ctx.logger("notify-email").warn(`deliver failed via trigger ${trigger.id}: ${result.detail}`);
+			if (!result.ok && result.detail !== "incomplete") this.ctx.logger("notify-email").warn(`deliver failed via trigger ${trigger.id}: ${result.detail}`);
 			return;
 		}
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/notify-email",
-  "version": "0.1.49",
+  "version": "0.1.50",
   "description": "dsh-plus service+ui plugin: 任务结束/等待决策/出错时向指定邮箱发送邮件通知",
   "type": "module",
   "main": "lib/index.js",
@@ -32,7 +32,7 @@
   },
   "dependencies": {
     "nodemailer": "9.0.6",
-    "@dsh-plus/shared": "0.1.43"
+    "@dsh-plus/shared": "0.1.44"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5",

package/src/client/card.tsx

@@ -1,7 +1,7 @@
 /**
  * 「邮件通知」配置卡片：经 injectPluginConfigCard 注册（插件页 plugins.row.config /
  * plugins.bundle.config，view 分发 summary/page）。
- * 外壳与基础控件走 @dsh-plus/shared/client 套件（CardChrome/TextField/CheckRow），
+ * 外壳与基础控件走 @dsh-plus/shared/client 套件（ConfigShell/Section/字段控件），
  * 本文件只保留业务字段与保存/测试逻辑。交互对齐官方卡片：折叠/展开、
  * staged draft、未保存标记、保存/放弃；另加「发送测试邮件」。
  * 配置读写经 ctx.remote.settings 直连（connection.api.settings
@@ -13,14 +13,14 @@
 
 import {
   type CardAction,
-  CardChrome,
   CardLoading,
   type CardStatusState,
-  CheckRow,
+  ConfigShell,
   IDLE_STATUS,
   type NamespaceSettingsApi,
   type PluginConfigViewProps,
   type Scope,
+  Section,
 } from '@dsh-plus/shared/client'
 import { type ReactElement, useEffect, useMemo, useState, useSyncExternalStore } from 'react'
 import { SETTINGS_NS } from '../ns.ts'
@@ -209,11 +209,10 @@ export function NotifyEmailCard(props: CardProps): ReactElement | string | null
 
   const disabled = !snapshot.writable
   return (
-    <CardChrome
+    <ConfigShell
       prefix="dne"
       title={t('title')}
       description={t('description')}
-      statusBadge={{ text: t(draft.enabled ? 'enabledOn' : 'enabledOff'), on: draft.enabled }}
       dirty={dirty}
       dirtyLabel={t('unsaved')}
       readOnlyNotice={disabled ? t('readOnly') : undefined}
@@ -233,28 +232,24 @@ export function NotifyEmailCard(props: CardProps): ReactElement | string | null
         onSave,
       })}
     >
-      <CheckRow
-        prefix="dne"
-        id="dne-enabled"
-        label={t('enabled')}
-        checked={draft.enabled}
-        disabled={disabled}
-        onEdit={(v) => edit('enabled', v)}
-      />
-      <SmtpFields
-        t={t}
-        draft={draft}
-        disabled={disabled}
-        passConfigured={passConfigured}
-        onEdit={edit}
-      />
-      <TriggerFields
-        t={t}
-        draft={draft}
-        disabled={disabled}
-        onEdit={edit}
-        onTrigger={editTrigger}
-      />
-    </CardChrome>
+      <Section prefix="dne" title={t('smtpGroup')}>
+        <SmtpFields
+          t={t}
+          draft={draft}
+          disabled={disabled}
+          passConfigured={passConfigured}
+          onEdit={edit}
+        />
+      </Section>
+      <Section prefix="dne" title={t('triggerGroup')}>
+        <TriggerFields
+          t={t}
+          draft={draft}
+          disabled={disabled}
+          onEdit={edit}
+          onTrigger={editTrigger}
+        />
+      </Section>
+    </ConfigShell>
   )
 }

package/src/client/draft.ts

@@ -6,7 +6,6 @@
 
 /** settings 命名空间的脱敏解析值（smtp.pass 被脱敏剥除）。 */
 export interface ConfigValue {
-  enabled: boolean
   smtp: {
     host: string
     port: number
@@ -29,7 +28,6 @@ export interface ConfigValue {
 
 /** 编辑草稿：数值字段以文本承载（保存时校验并折算）。 */
 export interface Draft {
-  enabled: boolean
   host: string
   port: string
   secure: boolean
@@ -60,7 +58,6 @@ export function isPositiveInt(text: string): boolean {
 
 export function draftFromValue(value: ConfigValue): Draft {
   return {
-    enabled: value.enabled,
     host: value.smtp.host,
     port: String(value.smtp.port),
     secure: value.smtp.secure,
@@ -78,7 +75,6 @@ export function draftFromValue(value: ConfigValue): Draft {
 /** 草稿 → 提交形状（pass 为空表示「保持已存密钥」，由调用方剔除该键）。 */
 export function toPatch(draft: Draft): Record<string, unknown> {
   return {
-    enabled: draft.enabled,
     smtp: {
       host: draft.host.trim(),
       port: Number(draft.port),

package/src/client/fields.tsx

@@ -4,7 +4,7 @@
  * @module notify-email/client/fields
  */
 
-import { CheckRow, TextField } from '@dsh-plus/shared/client'
+import { CheckRow, NumberField, TextField } from '@dsh-plus/shared/client'
 import type { ReactElement } from 'react'
 
 import { type Draft, isPositiveInt, TRIGGER_KEYS, type TriggerKey } from './draft.ts'
@@ -32,13 +32,12 @@ export function SmtpFields(props: CardFieldsProps & { passConfigured: boolean })
         disabled={disabled}
         onEdit={(v) => onEdit('host', v)}
       />
-      <TextField
+      <NumberField
         prefix="dne"
         id="dne-port"
         label={t('port')}
         hint={t('portHint')}
         value={draft.port}
-        numeric
         disabled={disabled}
         invalid={!isPositiveInt(draft.port)}
         invalidLabel={t('invalidNumber')}
@@ -104,7 +103,6 @@ export function TriggerFields(
         disabled={disabled}
         onEdit={(v) => onEdit('toText', v)}
       />
-      <p className="dne-groupLabel">{t('triggerGroup')}</p>
       {TRIGGER_KEYS.map((key) => (
         <CheckRow
           prefix="dne"
@@ -116,25 +114,23 @@ export function TriggerFields(
           onEdit={(v) => props.onTrigger(key, v)}
         />
       ))}
-      <TextField
+      <NumberField
         prefix="dne"
         id="dne-debounce"
         label={t('idleDebounceMs')}
         hint={t('idleDebounceMsHint')}
         value={draft.idleDebounceMs}
-        numeric
         disabled={disabled}
         invalid={!isPositiveInt(draft.idleDebounceMs)}
         invalidLabel={t('invalidNumber')}
         onEdit={(v) => onEdit('idleDebounceMs', v)}
       />
-      <TextField
+      <NumberField
         prefix="dne"
         id="dne-maxchars"
         label={t('maxBodyChars')}
         hint={t('maxBodyCharsHint')}
         value={draft.maxBodyChars}
-        numeric
         disabled={disabled}
         invalid={!isPositiveInt(draft.maxBodyChars) || Number(draft.maxBodyChars) < 200}
         invalidLabel={t('invalidNumber')}

package/src/client/i18n.ts

@@ -11,7 +11,7 @@ const ownZh = {
   title: '邮件通知',
   description: '任务结束、等待决策或出错时向指定邮箱发送邮件。',
   summaryLine: '任务结束、等待决策或出错时向指定邮箱发送邮件。',
-  enabled: '启用通知',
+  smtpGroup: 'SMTP 连接',
   host: 'SMTP 服务器',
   hostHint: '如 smtp.qq.com、smtp.163.com。',
   port: '端口',
@@ -50,7 +50,7 @@ const ownEn = {
   title: 'Email notifications',
   description: 'Email a mailbox when a task finishes, awaits a decision, or fails.',
   summaryLine: 'Email a mailbox when a task finishes, awaits a decision, or fails.',
-  enabled: 'Enable notifications',
+  smtpGroup: 'SMTP connection',
   host: 'SMTP host',
   hostHint: 'e.g. smtp.qq.com, smtp.gmail.com.',
   port: 'Port',

package/src/config.ts

@@ -39,7 +39,6 @@ const TriggerSchema = z.object({
 })
 
 export const Config = z.object({
-  enabled: z.boolean().description('总开关').default(false).volatile(),
   smtp: SmtpSchema.default({
     host: '',
     port: 465,
@@ -71,7 +70,10 @@ export type NotifyEmailConfigFields = Schemastery.TypeT<typeof Config>
 export type NotifyEmailConfig = UnwrapVolatile<NotifyEmailConfigFields>
 export type TriggerToggles = NotifyEmailConfig['triggers']
 
-/** 是否具备发信条件（enabled 之外的最小完整性）。 */
+/**
+ * 是否具备发信条件：SMTP 主机/发件人/收件人齐备。
+ * 整行开关由官方行开关承担（profile patch `disabled`），配置内不再有第二套总开关。
+ */
 export function isDeliverable(cfg: NotifyEmailConfig): boolean {
-  return cfg.enabled && cfg.smtp.host.length > 0 && cfg.smtp.from.length > 0 && cfg.to.length > 0
+  return cfg.smtp.host.length > 0 && cfg.smtp.from.length > 0 && cfg.to.length > 0
 }

package/src/mailer.ts

@@ -19,7 +19,7 @@ export interface MailMessage {
 
 export interface SendResult {
   ok: boolean
-  /** 'sent' | 'dry-run' | 'disabled' | 'incomplete' | 错误消息。 */
+  /** 'sent' | 'dry-run' | 'incomplete' | 错误消息。 */
   detail: string
 }
 
@@ -102,13 +102,9 @@ export class Mailer {
     this.credentials = credentials
   }
 
-  /**
-   * 常规通知发送：受 enabled 与配置完整性门禁。
-   * @param force 为 true 时跳过 enabled 门禁（配置卡片的「发送测试邮件」），仍需 SMTP 完整。
-   */
-  async send(msg: MailMessage, force = false): Promise<SendResult> {
+  /** 通知发送：受配置完整性门禁（整行开关由官方行开关承担）。 */
+  async send(msg: MailMessage): Promise<SendResult> {
     const cfg = this.resolveConfig()
-    if (!force && !cfg.enabled) return this.record(msg, cfg, { ok: false, detail: 'disabled' })
     if (cfg.smtp.host.length === 0 || cfg.smtp.from.length === 0 || cfg.to.length === 0) {
       return this.record(msg, cfg, { ok: false, detail: 'incomplete' })
     }

package/src/service.ts

@@ -90,18 +90,15 @@ export class NotifyEmailService extends Service {
     await this.dispatch('turn-end', info, (t) => t.onTurnEnd?.(info))
   }
 
-  /** 配置卡片「发送测试邮件」：绕过 enabled 门禁，仍需 SMTP 完整。 */
+  /** 配置卡片「发送测试邮件」：走与常规通知同一条发送路径。 */
   async sendTest(): Promise<{ ok: boolean; detail: string }> {
-    return this.mailer.send(
-      {
-        subject: '[DSH] 邮件通知测试',
-        text: '这是一封来自 dsh notify-email 插件的测试邮件。',
-      },
-      true,
-    )
+    return this.mailer.send({
+      subject: '[DSH] 邮件通知测试',
+      text: '这是一封来自 dsh notify-email 插件的测试邮件。',
+    })
   }
 
-  /** 通用直发接口（如 lifeboat 故障告警）：走正常 enabled/完整性门禁。 */
+  /** 通用直发接口（如 lifeboat 故障告警）：走正常完整性门禁。 */
   async sendNotice(notice: {
     subject: string
     text: string
@@ -128,7 +125,7 @@ export class NotifyEmailService extends Service {
       }
       if (notice === undefined) continue
       const result = await this.mailer.send(notice)
-      if (!result.ok && result.detail !== 'disabled' && result.detail !== 'incomplete') {
+      if (!result.ok && result.detail !== 'incomplete') {
         this.ctx
           .logger('notify-email')
           .warn(`deliver failed via trigger ${trigger.id}: ${result.detail}`)