dsh-email 0.17.2 → 0.18.0

package/lib/client.js

@@ -12,10 +12,10 @@ const h = React.createElement;
 const __FR_KEY = 'dsh-first-run:dsh-email:v1';
 const __FR_TITLE = '邮件 · 首次使用（4 步）';
 const __FR_STEPS = [
-  { title: '先把账号填上', body: '下面填 IMAP / SMTP 地址与授权码（QQ 邮箱用「授权码」，不是登录密码）。保存后这里会显示连接状态。' },
-  { title: '看一眼收件箱', body: '连接成功后，下方会列出最近邮件的标题与发件人；点开任意一封可读正文。' },
+  { title: '先把账号填上', body: '选择邮箱服务商或 AgentMail，填写对应授权码、登录信息或 API Key，再测试连接。' },
+  { title: '看一眼收件箱', body: '连接成功后切到「收发邮件」，选择账号与文件夹；点开一封邮件即可阅读正文。' },
   { title: '让它替你整理', body: '在对话里直接说你要做的事，比在页面里逐个点更快。', tryIt: '把今天的未读邮件按主题归纳一下' },
-  { title: '发信前一定先看草稿', body: '涉及发信时默认先生成草稿给你确认，确认后才真正发送；收件人规则在下方「发信规则」里配。' },
+  { title: '发信前先看草稿', body: '用「写邮件」或「回复到草稿」准备内容，核对后再确认发送；模型发送工具仍遵守审批设置，收件人规则在对应页配置。' },
 ];
 
 // ---- first-run guide (shared snippet, keep in sync across plugins) ----
@@ -53,19 +53,20 @@ function __FirstRunCard() {
   const [index, setIndex] = React.useState(0);
   React.useEffect(() => { __frEnsureCss(); }, []);
   if (done) return null;
-  const step = __FR_STEPS[index];
-  const last = index >= __FR_STEPS.length - 1;
+  const steps = UI_LANG === "en" ? [{title:"Add an account",body:"Choose your mail provider or AgentMail and enter its credentials. Test the connection before browsing."},{title:"Open your mailbox",body:"Use Mailbox to browse Inbox and Sent, search, and read a message."},{title:"Let DSH organize mail",body:"Ask DSH to summarize unread mail or find a message."},{title:"Review before sending",body:"Compose or reply in Drafts. Review recipients, content and attachments, then confirm sending."}] : __FR_STEPS;
+  const step = steps[index];
+  const last = index >= steps.length - 1;
   const close = () => { __frWrite(); setDone(true); };
   return h('div', { className: 'fr-card' },
-    h('div', { className: 'fr-head' }, h('span', { className: 'fr-dot' }), h('span', { className: 'fr-title' }, __FR_TITLE), h('span', { className: 'fr-count' }, (index + 1) + ' / ' + __FR_STEPS.length)),
+    h('div', { className: 'fr-head' }, h('span', { className: 'fr-dot' }), h('span', { className: 'fr-title' }, UI_LANG === 'en' ? 'Email · Getting started (4 steps)' : __FR_TITLE), h('span', { className: 'fr-count' }, (index + 1) + ' / ' + steps.length)),
     h('div', { className: 'fr-step' }, step.title),
     h('div', { className: 'fr-body' }, step.body),
     step.tryIt ? h('div', { className: 'fr-try' }, h('span', null, '可以直接说'), h('code', null, '「' + step.tryIt + '」')) : null,
     h('div', { className: 'fr-bar' },
-      h('div', { className: 'fr-progress' }, __FR_STEPS.map((_, i) => h('span', { key: i, className: 'fr-seg' + (i <= index ? ' on' : '') }))),
-      h('button', { className: 'fr-btn ghost', type: 'button', onClick: close }, '跳过'),
-      index > 0 ? h('button', { className: 'fr-btn', type: 'button', onClick: () => setIndex(index - 1) }, '上一步') : null,
-      h('button', { className: 'fr-btn primary', type: 'button', onClick: () => { if (last) close(); else setIndex(index + 1); } }, last ? '开始使用' : '下一步')));
+      h('div', { className: 'fr-progress' }, steps.map((_, i) => h('span', { key: i, className: 'fr-seg' + (i <= index ? ' on' : '') }))),
+      h('button', { className: 'fr-btn ghost', type: 'button', onClick: close }, UI_LANG === 'en' ? 'Skip' : '跳过'),
+      index > 0 ? h('button', { className: 'fr-btn', type: 'button', onClick: () => setIndex(index - 1) }, UI_LANG === 'en' ? 'Previous' : '上一步') : null,
+      h('button', { className: 'fr-btn primary', type: 'button', onClick: () => { if (last) close(); else setIndex(index + 1); } }, last ? (UI_LANG === 'en' ? 'Start' : '开始使用') : (UI_LANG === 'en' ? 'Next' : '下一步'))));
 }
 function __withFirstRun(Component) {
   return function FirstRunWrapped(props) {
@@ -92,7 +93,8 @@ function emailError(error) {
   if (/预览已过期|draft-preview-expired/.test(message + ' ' + (error?.code || ''))) return 'The send review expired or was already used. Review the current draft again.';
   if (/改变|已更新|冲突|重新加载/.test(message)) return 'The draft, account or rules changed. Reload the latest version and review your input before retrying.';
   if (/请先填写并保存邮件主题/.test(message)) return 'Fill in and save the email subject first.';
-  if (/附件/.test(message)) return 'Check the attachments. Save the draft first; use up to 10 readable files and 20 MiB total. Remove invalid files and add them again.';
+  if (/附件/.test(message)) return 'Check the attachments and the selected account limit (up to 4 MiB for AgentMail, 20 MiB for IMAP). Save first, use at most 10 files, and remove unreadable or oversized files.';
+  if (/AgentMail/.test(message)) { const status = message.match(/HTTP \d+/)?.[0]; return 'AgentMail request failed' + (status ? ' (' + status + ')' : '') + '. Check the API region, key, inbox and service status. For sending, check Sent before trying again.'; }
   if (/账号|配置不完整|尚未登录|OAuth|设备码/.test(message)) return 'Check the selected email account. Complete its credentials or OAuth sign-in in Account settings, then test the connection.';
   if (/收件人|邮箱地址/.test(message)) return 'Check the recipient addresses and trusted-recipient rules before reviewing the draft again.';
   return 'The email operation failed. Check the account settings and DSH logs, then retry. For a send operation, check the mailbox before retrying.';
@@ -900,6 +902,7 @@ function draftsFromCards(list) {
  */
 function providerOptions(presets) {
   const out = PROVIDERS.map(([value, labelKey]) => ({ value, label: t(labelKey) }));
+  out.push({value:"agentmail",label:"AgentMail (US API)"},{value:"agentmail-eu",label:"AgentMail (EU API)"});
   const custom = (presets && presets.custom) || {};
   for (const name of Object.keys(custom)) {
     if (name === "") continue;
@@ -1017,6 +1020,7 @@ function renameDrafts(drafts, oldName, nextName) {
  * presets.custom（值还是 undefined，端点要等下一次快照），它已经是合法预设了。
  */
 function accountSummary(draft, presets) {
+  if(draft.provider==="agentmail"||draft.provider==="agentmail-eu")return {label:draft.provider==="agentmail-eu"?"AgentMail EU":"AgentMail US",isCustom:false};
   const provider = draft.provider || "";
   const entry = PROVIDERS.filter(([value]) => value === provider)[0];
   if (entry) return { label: t(entry[1]), isCustom: false };
@@ -1039,6 +1043,7 @@ function presetEndpointText(endpoint) {
  * 保存后的新快照优先，避免自定义预设更新后继续显示旧地址。
  */
 function providerMetaText(draft, presets, cards) {
+  if(draft.provider==="agentmail"||draft.provider==="agentmail-eu")return draft.provider==="agentmail-eu"?"AgentMail · api.agentmail.eu":"AgentMail · api.agentmail.to";
   const provider = String(draft.provider || "").trim();
   const saved = (cards || []).find(card => card.name === draft.name)
     || (cards || []).find(card => card.name === draft.originalName);
@@ -1722,7 +1727,7 @@ function AccountCardsEditor(props) {
       setRowStatus((cur) => Object.assign({}, cur, {
         [draftName]: {
           kind: "success",
-          text: t("card.testOk", { ms: result.ms, host: result.imapHost, port: result.imapPort }),
+          text: result.apiHost ? dt("API 连接成功 · ","API connected · ")+result.apiHost : t("card.testOk", { ms: result.ms, host: result.imapHost, port: result.imapPort }),
         },
       }));
     } catch (e) {
@@ -1866,7 +1871,7 @@ function AccountCardsEditor(props) {
                   h("label", null, t("card.addressLabel")),
                   fieldInput("text", draft.user, (v) => patchDraft(name, { user: v }), "you@example.com"),
                 ]),
-                h("div", { className: "dshe-field" }, [
+                !draft.provider?.startsWith("agentmail") && h("div", { className: "dshe-field" }, [
                   h("label", null, t("card.senderNameLabel")),
                   fieldInput("text", draft.senderName, (v) => patchDraft(name, { senderName: v }), t("card.senderNamePlaceholder")),
                   h("div", { className: "dshe-hint" }, t("card.senderNameHint")),
@@ -1912,32 +1917,32 @@ function AccountCardsEditor(props) {
                     })
                   : h(React.Fragment, null, [
                       h("div", { className: "dshe-field" }, [
-                        h("label", null, t("card.passwordLabel")),
+                        h("label", null, draft.provider?.startsWith("agentmail") ? "AgentMail API Key" : t("card.passwordLabel")),
                         h("input", {
                           type: "password",
                           value: draft.password,
                           disabled: busy !== "",
-                          placeholder: t("card.passwordPlaceholder"),
+                          placeholder: draft.provider?.startsWith("agentmail") ? dt("输入 API Key；留空保留已存密钥", "API key; leave blank to retain saved key") : t("card.passwordPlaceholder"),
                           onChange: (e) => patchDraft(name, { password: e.target.value }),
                         }),
                         h("div", { className: "dshe-hint" },
                           view.hasPassword
                             ? t("card.passwordSaved")
-                            : t("card.passwordHint")),
+                            : draft.provider?.startsWith("agentmail") ? dt("从 AgentMail 控制台取得 API Key。API Key 保存在本机账号配置中，由 DSH 后端调用所选区域的 API。", "Use an API key from the AgentMail console. The key is stored in the local account configuration; the DSH backend calls the selected region.") : t("card.passwordHint")),
                       ]),
                       // 别名/中继：登录名与登录密码都只在密码类账号上有意义（OAuth2 用 token 登录）。
-                      h("div", { className: "dshe-field" }, [
+                      !draft.provider?.startsWith("agentmail") && h("div", { className: "dshe-field" }, [
                         h("label", null, t("card.authUserLabel")),
                         fieldInput("text", draft.authUser, (v) => patchDraft(name, { authUser: v }), t("card.authUserPlaceholder")),
                         h("div", { className: "dshe-hint" }, t("card.authUserHint")),
                       ]),
-                      h("div", { className: "dshe-field" }, [
+                      !draft.provider?.startsWith("agentmail") && h("div", { className: "dshe-field" }, [
                         h("label", null, t("card.authPasswordLabel")),
                         h("input", {
                           type: "password",
                           value: draft.authPassword,
                           disabled: busy !== "",
-                          placeholder: t("card.passwordPlaceholder"),
+                          placeholder: draft.provider?.startsWith("agentmail") ? dt("输入 API Key；留空保留已存密钥", "API key; leave blank to retain saved key") : t("card.passwordPlaceholder"),
                           onChange: (e) => patchDraft(name, { authPassword: e.target.value }),
                         }),
                         h("div", { className: "dshe-hint" },
@@ -1946,7 +1951,7 @@ function AccountCardsEditor(props) {
                             : t("card.authPasswordHint")),
                       ]),
                     ]),
-                h("div", { className: "dshe-field" }, [
+                !draft.provider?.startsWith("agentmail") && h("div", { className: "dshe-field" }, [
                   h("label", null, t("card.inboxLabel")),
                   fieldInput("text", draft.inboxFolder, (v) => patchDraft(name, { inboxFolder: v }), "INBOX"),
                 ]),
@@ -2228,6 +2233,93 @@ function ServerPresetsEditor(props) {
   ]);
 }
 
+const MAILBOX_ROUTE = "api/dsh-email/mailbox";
+async function mailboxApi(action, payload = {}, signal) {
+  const response = await fetch(MAILBOX_ROUTE, { credentials: "same-origin", method: "POST", headers: { "Content-Type": "application/json", "x-dsh-email-mailbox": "1" }, body: JSON.stringify({ ...payload, action }), signal });
+  if (action === "download" && response.ok) return response.blob();
+  const result = await response.json();
+  if (!response.ok || !result.ok) throw new Error(result.error?.message || dt("邮箱操作失败", "Mailbox action failed"));
+  return result.value;
+}
+function MailboxWorkbench({ active, onConfigure, onDraft }) {
+  const [accounts, setAccounts] = useState([]), [account, setAccount] = useState(""), [folders, setFolders] = useState([]), [folder, setFolder] = useState("");
+  const [input, setInput] = useState(""), [query, setQuery] = useState(""), [offset, setOffset] = useState(0), [scanOffset, setScanOffset] = useState(0), [unread, setUnread] = useState(false), [refresh, setRefresh] = useState(0);
+  const [result, setResult] = useState(null), [selected, setSelected] = useState(null), [detail, setDetail] = useState(null), [loading, setLoading] = useState(false), [reading, setReading] = useState(false), [busy, setBusy] = useState(false), [error, setError] = useState("");
+  const busyRef = useRef(false), context = useRef(0);
+  useEffect(() => {
+    if (!document.getElementById("dshe-mailbox-css")) { const css = document.createElement("style"); css.id = "dshe-mailbox-css"; css.textContent = ".dshe-mail-toolbar{display:flex;flex-wrap:wrap;gap:10px;align-items:end}.dshe-mail-toolbar .dshe-field{flex:1 1 160px;margin:0}.dshe-mail-search{display:flex;gap:8px;flex:1 1 260px;align-items:end}.dshe-mail-search input[type=search]{min-width:0;width:100%}.dshe-mail-search>.dshe-field{flex:1 1 180px;min-width:120px}.dshe-mail-search .dshe-check{flex:0 0 auto;white-space:nowrap;display:flex;align-items:center;gap:6px}.dshe-mail-search input[type=checkbox]{width:auto}.dshe-mail-grid{display:grid;grid-template-columns:minmax(220px,1fr) minmax(0,1.5fr);gap:12px;margin-top:16px}.dshe-mail-list{display:flex;flex-direction:column;gap:6px;max-height:60vh;overflow:auto;min-width:0}.dshe-mail-row{display:block;width:100%;text-align:left;padding:12px;border-radius:10px;border:1px solid rgba(128,128,128,.3);background:transparent;color:inherit;cursor:pointer}.dshe-mail-row[aria-pressed=true]{background:rgba(80,130,220,.13);outline:2px solid rgba(80,130,220,.45);outline-offset:-2px}.dshe-mail-row strong,.dshe-mail-row small{display:block;overflow-wrap:anywhere}.dshe-mail-row small{opacity:.75;margin-top:5px}.dshe-mail-detail{min-width:0;padding:14px;border:1px solid rgba(128,128,128,.3);border-radius:12px}.dshe-mail-detail h3,.dshe-mail-detail p{overflow-wrap:anywhere}.dshe-mail-detail pre{white-space:pre-wrap;overflow-wrap:anywhere;max-height:55vh;overflow:auto;font:inherit;line-height:1.7;border-top:1px solid rgba(128,128,128,.25);padding-top:12px}.dshe-mail-meta{font-size:12px;opacity:.8}.dshe-mail-footer{display:flex;flex-wrap:wrap;gap:8px;align-items:center;margin-top:12px}.dshe-mail-empty{padding:24px 10px;opacity:.75}.dshe-tabs{flex-wrap:wrap}@media(max-width:760px){.dshe-mail-grid{grid-template-columns:minmax(0,1fr)}.dshe-mail-list{max-height:35vh}.dshe-mail-detail pre{max-height:none}.dshe-mail-search{flex-wrap:wrap}}"; document.head.appendChild(css); }
+  }, []);
+  useEffect(() => {
+    if (!active) return;
+    const ctrl = new AbortController(); setError("");
+    mailboxApi("accounts", {}, ctrl.signal).then(value => { if(ctrl.signal.aborted)return;setAccounts(value.accounts);setAccount(old => value.accounts.some(a => a.name === old) ? old : value.defaultAccount); }).catch(e => {if(!ctrl.signal.aborted)setError(emailError(e));});
+    return () => ctrl.abort();
+  }, [active]);
+  useEffect(() => {
+    context.current++; setSelected(null); setDetail(null); setResult(null); setFolder(""); setFolders([]); setOffset(0); setScanOffset(0);
+    if (!active || !account) return;
+    const ctrl = new AbortController();
+    mailboxApi("folders", {account}, ctrl.signal).then(value => { if(ctrl.signal.aborted)return;setFolders(value.folders);setFolder(value.folders.find(f => f.specialUse === "\\Inbox")?.path || value.folders.find(f => f.path === "INBOX")?.path || value.folders[0]?.path || ""); }).catch(e=>{if(!ctrl.signal.aborted)setError(emailError(e));});
+    return () => ctrl.abort();
+  }, [active, account]);
+  useEffect(() => {
+    context.current++; setSelected(null); setDetail(null); setResult(null);
+    if(!active || !account || !folder)return;
+    const ctrl=new AbortController();setLoading(true);setError("");
+    mailboxApi("list", {account,folder,query,offset,unreadOnly:unread,headerScanOffset:scanOffset}, ctrl.signal).then(value=>{if(!ctrl.signal.aborted)setResult(value);}).catch(e=>{if(!ctrl.signal.aborted)setError(emailError(e));}).finally(()=>{if(!ctrl.signal.aborted)setLoading(false);});
+    return ()=>ctrl.abort();
+  },[active,account,folder,query,offset,scanOffset,unread,refresh]);
+  useEffect(()=>{
+    setDetail(null); if(!active || selected===null)return;
+    const ctrl=new AbortController();setReading(true);setError("");
+    mailboxApi("read",{account,folder,uid:selected},ctrl.signal).then(value=>{if(!ctrl.signal.aborted)setDetail(value);}).catch(e=>{if(!ctrl.signal.aborted)setError(emailError(e));}).finally(()=>{if(!ctrl.signal.aborted)setReading(false);});
+    return ()=>ctrl.abort();
+  },[active,account,folder,selected]);
+  const run=async task=>{if(busyRef.current)return;busyRef.current=true;setBusy(true);setError("");const generation=context.current;try{await task(()=>generation===context.current);}catch(e){if(generation===context.current)setError(emailError(e));}finally{busyRef.current=false;setBusy(false);}};
+  const reset=()=>{setOffset(0);setScanOffset(0);setSelected(null);setDetail(null);};
+  const changeFolder=value=>{reset();setFolder(value);};
+  const who=list=>(list||[]).map(a=>a.name&&a.address?a.name+" <"+a.address+">":a.address||a.name).filter(Boolean).join(", ");
+  const date=value=>{const d=new Date(value);return Number.isNaN(d.getTime())?value:d.toLocaleString(UI_LANG==="en"?"en-US":"zh-CN");};
+  const rows=result?.messages||[], currentRow=rows.find(m=>m.uid===selected), hasMore=result?.hasMore??(result?.headerScan&&result?.searchSource==="local-headers"?offset+rows.length<result.count:result?.bodyScan?rows.length===20:offset+rows.length<(result?.count||0));
+  const folderButton=(special,zh,en)=>{const target=folders.find(f=>f.specialUse===special)||folders.find(f=>special==="\\Sent"?/^(sent|sent messages|已发送)$/i.test(f.path):f.path==="INBOX");return target?h("button",{type:"button",className:"dshe-btn",disabled:busy||loading,"aria-pressed":folder===target.path,onClick:()=>changeFolder(target.path)},dt(zh,en)):null;};
+  return h("section",{className:"dshe-panel","aria-label":dt("邮箱工作台","Mailbox workbench")},[
+    h("div",{className:"dshe-mail-toolbar"},[
+      h("div",{className:"dshe-field"},[h("label",{htmlFor:"dshe-mail-account"},dt("邮箱账号","Account")),h("select",{id:"dshe-mail-account",value:account,disabled:busy,onChange:e=>{reset();setInput("");setQuery("");setAccount(e.target.value);}},accounts.map(a=>h("option",{key:a.name,value:a.name},a.name+" · "+a.user)))]),
+      h("div",{className:"dshe-field"},[h("label",{htmlFor:"dshe-mail-folder"},dt("文件夹","Folder")),h("select",{id:"dshe-mail-folder",value:folder,disabled:busy||!folders.length,onChange:e=>changeFolder(e.target.value)},folders.map(f=>h("option",{key:f.path,value:f.path},f.name)))]),
+      h("button",{type:"button",className:"dshe-btn primary",disabled:busy||!account,onClick:()=>run(async valid=>{const draft=await draftApi("create",{account,to:"",cc:"",subject:"",text:""});if(valid())onDraft(draft.id);})},dt("写邮件","Compose")),
+      h("button",{type:"button",className:"dshe-btn",disabled:loading||busy||!account,onClick:()=>setRefresh(n=>n+1)},dt("刷新邮件","Refresh mail")),
+    ]),
+    h("form",{className:"dshe-mail-search",onSubmit:e=>{e.preventDefault();reset();setUnread(false);setQuery(input.trim());setRefresh(n=>n+1);}},[
+      h("div",{className:"dshe-field"},[h("label",{htmlFor:"dshe-mail-search"},dt("搜索当前文件夹","Search current folder")),h("input",{id:"dshe-mail-search",type:"search",value:input,maxLength:500,disabled:busy,onChange:e=>setInput(e.target.value)})]),
+      h("button",{type:"submit",className:"dshe-btn",disabled:loading||busy||!folder},dt("搜索","Search")),
+      query?h("button",{type:"button",className:"dshe-btn",disabled:busy,onClick:()=>{reset();setInput("");setQuery("");}},dt("清除搜索","Clear search")):null,
+      h("label",{className:"dshe-check"},[h("input",{type:"checkbox",checked:unread,disabled:busy||!!query,onChange:e=>{reset();setUnread(e.target.checked);}}),dt("只看未读","Unread only")]),
+    ]),
+    h("div",{className:"dshe-actions"},[folderButton("\\Inbox","收件箱","Inbox"),folderButton("\\Sent","已发送","Sent")]),
+    error?h("div",{className:"dshe-alert error",role:"alert"},[error," ",h("button",{type:"button",className:"dshe-btn",onClick:onConfigure},dt("检查账号设置","Check account settings"))]):null,
+    h("div",{role:"status","aria-live":"polite",className:"dshe-hint"},loading?dt("正在读取邮件…","Loading messages…"):result?dt("本页 ","This page: ")+rows.length+dt(" 封"," messages")+(result.order==="relevance"?dt(" · 按相关性排序"," · Ranked by relevance"):dt(" · 按邮箱到达序排列"," · Mailbox arrival order")):dt("在账号设置中添加并测试邮箱后，即可浏览邮件。","Add and test an account in settings to browse mail.")),
+    result?.headerScan?h("p",{className:"dshe-hint"},dt("信封实际扫描：","Headers scanned: ")+result.headerScan.scanned+" / "+result.headerScan.mailboxTotal+(result.headerScan.complete?dt("，信封覆盖完整；正文另有限制。","; headers fully covered; body search has a separate limit."):dt("，尚未覆盖全文件夹。","; folder coverage is partial."))):null,
+    result?.searchSource==="api"?h("p",{className:"dshe-hint"},dt("AgentMail 搜索由服务按相关性返回，垃圾箱等特殊邮件不在其搜索范围。","AgentMail ranks results by relevance and excludes spam, trash and other protected mail.")):null,
+    h("div",{className:"dshe-mail-grid"},[
+      h("div",{className:"dshe-mail-list","aria-label":dt("邮件列表","Message list")},rows.length?rows.map(m=>h("button",{key:String(m.uid),type:"button",className:"dshe-mail-row",disabled:busy,"aria-pressed":selected===m.uid,onClick:()=>setSelected(m.uid)},[h("strong",null,(m.flagged?"★ ":"")+(m.seen?"":"● ")+(m.subject||dt("（无主题）","(No subject)"))),h("small",null,who(m.from)),h("small",null,date(m.date))])):h("p",{className:"dshe-mail-empty"},loading?dt("请稍候…","Please wait…"):query?dt("当前检索范围内没有结果。","No results in the current search window."):dt("当前页没有邮件。","No messages on this page."))),
+      h("article",{className:"dshe-mail-detail","aria-label":dt("邮件详情","Message details")},reading&&selected!==null?h("p",{role:"status"},dt("正在读取正文…","Loading message…")):detail?[
+        h("h3",null,detail.subject||dt("（无主题）","(No subject)")),h("p",{className:"dshe-mail-meta"},dt("发件人：","From: ")+who(detail.from)),h("p",{className:"dshe-mail-meta"},dt("收件人：","To: ")+who(detail.to)),detail.cc?.length?h("p",{className:"dshe-mail-meta"},"Cc: "+who(detail.cc)):null,h("p",{className:"dshe-mail-meta"},date(detail.date)),
+        h("div",{className:"dshe-actions"},[
+          ...[false,true].map(all=>h("button",{key:String(all),type:"button",className:"dshe-btn",disabled:busy,onClick:()=>run(async valid=>{const draft=await mailboxApi("replyDraft",{account,folder,uid:selected,replyAll:all});if(valid())onDraft(draft.id);})},all?dt("回复全部到草稿","Reply all in drafts"):dt("回复到草稿","Reply in drafts"))),
+          h("button",{type:"button",className:"dshe-btn",disabled:busy,onClick:()=>run(async valid=>{await mailboxApi("mark",{account,folder,uid:selected,mark:currentRow?.seen?"unread":"read"});if(valid())setResult(old=>({...old,messages:old.messages.map(m=>m.uid===selected?{...m,seen:!m.seen}:m)}));})},currentRow?.seen?dt("标记未读","Mark unread"):dt("标记已读","Mark read")),
+          h("button",{type:"button",className:"dshe-btn",disabled:busy,onClick:()=>run(async valid=>{await mailboxApi("mark",{account,folder,uid:selected,mark:currentRow?.flagged?"unstar":"star"});if(valid())setResult(old=>({...old,messages:old.messages.map(m=>m.uid===selected?{...m,flagged:!m.flagged}:m)}));})},currentRow?.flagged?dt("取消星标","Unstar"):dt("添加星标","Star")),
+        ]),
+        h("pre",null,detail.text||dt("（空正文）","(Empty body)")),detail.truncated?h("p",{className:"dshe-hint"},dt("正文超过显示上限，已截断。","Body truncated at the display limit.")):null,
+        detail.attachments?.length?h("ul",{className:"dshe-files"},detail.attachments.map((file,index)=>h("li",{key:index},[h("span",null,file.filename+" · "+Math.ceil(file.size/1024)+" KiB"),h("button",{type:"button",className:"dshe-btn",disabled:busy,onClick:()=>run(async valid=>{const blob=await mailboxApi("download",{account,folder,uid:selected,index});if(!valid())return;const url=URL.createObjectURL(blob),link=document.createElement("a");link.href=url;link.download=file.filename;link.click();setTimeout(()=>URL.revokeObjectURL(url),1000);})},dt("下载附件","Download attachment"))]))):null,
+      ]:h("p",{className:"dshe-mail-empty"},dt("选择一封邮件查看正文。","Select a message to read it."))),
+    ]),
+    h("div",{className:"dshe-mail-footer"},[
+      h("button",{type:"button",className:"dshe-btn",disabled:loading||busy||offset===0,onClick:()=>setOffset(n=>Math.max(0,n-20))},dt("上一页","Previous page")),h("span",null,dt("第 ","Page ")+(Math.floor(offset/20)+1)+dt(" 页","")),h("button",{type:"button",className:"dshe-btn",disabled:loading||busy||!hasMore,onClick:()=>setOffset(n=>n+20)},dt("下一页","Next page")),
+      result?.headerScan?.nextScanOffset!==undefined?h("button",{type:"button",className:"dshe-btn",disabled:loading||busy,onClick:()=>{setOffset(0);setScanOffset(result.headerScan.nextScanOffset);}},dt("继续搜索更早邮件","Search older headers")):null,
+    ]),
+  ]);
+}
+
 const DRAFT_ROUTE = "api/dsh-email/drafts";
 const dt = (zh, en) => UI_LANG === "en" ? en : zh;
 // Session memory survives closing the host settings dialog. A page reload
@@ -2244,15 +2336,17 @@ async function draftApi(action, payload, upload) {
   return result.value;
 }
 const draftForm = (draft) => ({ account: draft.account || "", to: draft.to || "", cc: draft.cc || "", subject: draft.subject || "", text: draft.text || "", attachments: draft.attachments.map(file => file.id) });
-const draftState = (state) => ({ draft: dt("未发送", "Not sent"), sending: dt("正在提交 / 待核对", "Submitting / check mailbox"), sent: dt("SMTP 已返回回执", "SMTP receipt saved"), uncertain: dt("结果未确定，请核对邮箱", "Outcome uncertain, check mailbox") })[state] || state;
+const draftState = (state) => ({ draft: dt("未发送", "Not sent"), sending: dt("正在提交 / 待核对", "Submitting / check mailbox"), sent: dt("已保存服务端回执", "Server receipt saved"), uncertain: dt("结果未确定，请核对邮箱", "Outcome uncertain, check mailbox") })[state] || state;
 
-function DraftWorkbench({ active }) {
+function DraftWorkbench({ active, requestedDraft }) {
   const [data, setData] = useState({ drafts: [], accounts: [] }), [selected, setSelected] = useState(() => draftUiCache && draftUiCache.selected), [form, setForm] = useState(() => draftUiCache && draftUiCache.form);
   const [busy, setBusy] = useState(false), [error, setError] = useState(""), [notice, setNotice] = useState(""), [preview, setPreview] = useState(null), [acknowledged, setAcknowledged] = useState(false), [pending, setPending] = useState(null), [remove, setRemove] = useState(false), [copy, setCopy] = useState(false);
-  const operation = useRef(false);
+  const operation = useRef(false), handledRequested = useRef("");
   const dirty = selected && form && JSON.stringify(form) !== JSON.stringify(draftForm(selected));
   useEffect(() => { draftUiCache = { selected, form }; }, [selected, form]);
   const locked = !selected || selected.state !== "draft";
+  const attachmentCap = data.attachmentLimits?.[form?.account] ?? 20 * 1024 * 1024;
+  const capLabel = attachmentCap >= 1024 * 1024 ? (attachmentCap / 1024 / 1024) + " MiB" : Math.ceil(attachmentCap / 1024) + " KiB";
   const reload = async () => { const next = await draftApi("list"); setData(next); return next; };
   const run = async (fn) => {
     if (operation.current) return;
@@ -2272,9 +2366,10 @@ function DraftWorkbench({ active }) {
     await reload(); setPending(null);
   };
   const requestSwitch = (target) => { if (dirty) setPending(target); else run(() => switchTo(target)); };
+  useEffect(() => { if(active && requestedDraft && handledRequested.current!==requestedDraft && !operation.current && !busy) {handledRequested.current=requestedDraft;requestSwitch({kind:"open",id:requestedDraft});} }, [active,requestedDraft,busy]);
   const field = (key, zh, en, multiline) => h("div", { className: "dshe-field", key }, [
     h("label", { htmlFor: "dshe-draft-" + key }, dt(zh, en)),
-    h(multiline ? "textarea" : "input", { id: "dshe-draft-" + key, type: multiline ? undefined : "text", value: form[key], disabled: busy || locked, rows: multiline ? 8 : undefined, maxLength: multiline ? 102400 : key === "subject" ? 500 : 4096, onChange: (event) => { const value = event.target.value; setForm(current => ({ ...current, [key]: value })); setPreview(null); setAcknowledged(false); setNotice(""); } }),
+    h(multiline ? "textarea" : "input", { id: "dshe-draft-" + key, type: multiline ? undefined : "text", value: form[key], disabled: busy || locked || !!selected?.reply && key === "subject", rows: multiline ? 8 : undefined, maxLength: multiline ? 102400 : key === "subject" ? 500 : 4096, onChange: (event) => { const value = event.target.value; setForm(current => ({ ...current, [key]: value })); setPreview(null); setAcknowledged(false); setNotice(""); } }),
   ]);
   const review = preview && h("section", { className: "dshe-review", "aria-label": dt("发送前预览", "Review before sending") }, [
     h("h3", null, dt("发送前预览", "Review before sending")),
@@ -2314,16 +2409,16 @@ function DraftWorkbench({ active }) {
       h("aside", { className: "dshe-draft-list", "aria-label": dt("已保存的草稿", "Saved drafts") }, data.drafts.length ? data.drafts.map(draft => h("button", { key: draft.id, type: "button", className: "dshe-draft-row", disabled: busy, "aria-pressed": selected && selected.id === draft.id, onClick: () => requestSwitch({ kind: "open", id: draft.id }) }, [h("strong", null, draft.subject || dt("未命名草稿", "Untitled draft")), h("small", null, draft.account + " · " + draftState(draft.state))])) : h("p", { className: "dshe-hint" }, dt("还没有草稿，先新建一份。", "No drafts yet. Create your first draft."))),
       selected && form ? h("div", { className: "dshe-draft-editor" }, [
         h("div", { role: "status", className: "dshe-hint" }, dirty ? dt("有未保存的编辑", "Unsaved edits") : draftState(selected.state)),
-        h("div", { className: "dshe-field" }, [h("label", { htmlFor: "dshe-draft-account" }, dt("发件账号", "Sending account")), h("select", { id: "dshe-draft-account", value: form.account, disabled: busy || locked, onChange: event => { const value = event.target.value; setForm(current => ({ ...current, account: value })); setPreview(null); setAcknowledged(false); } }, [h("option", { value: "" }, dt("请选择账号", "Choose an account")), ...[...new Set([...data.accounts, ...(form.account ? [form.account] : [])])].map(name => h("option", { key: name, value: name }, name))])]),
+        h("div", { className: "dshe-field" }, [h("label", { htmlFor: "dshe-draft-account" }, dt("发件账号", "Sending account")), h("select", { id: "dshe-draft-account", value: form.account, disabled: busy || locked || !!selected?.reply, onChange: event => { const value = event.target.value; setForm(current => ({ ...current, account: value })); setPreview(null); setAcknowledged(false); } }, [h("option", { value: "" }, dt("请选择账号", "Choose an account")), ...[...new Set([...data.accounts, ...(form.account ? [form.account] : [])])].map(name => h("option", { key: name, value: name }, name))])]),
         field("to", "收件人 To", "Recipients To"), field("cc", "抄送 Cc", "Copy Cc"), field("subject", "主题", "Subject"), field("text", "正文", "Message", true),
         h("ul", { className: "dshe-files" }, selected.attachments.filter(file => form.attachments.includes(file.id)).map(file => h("li", { key: file.id }, [h("span", null, file.filename), !locked ? h("button", { type: "button", className: "dshe-btn", disabled: busy, "aria-label": dt("移除附件 ", "Remove attachment ") + file.filename, onClick: () => { setForm(current => ({ ...current, attachments: current.attachments.filter(id => id !== file.id) })); setPreview(null); setAcknowledged(false); } }, dt("移除", "Remove")) : null]))),
-        !locked ? h("label", { className: "dshe-upload" }, [dt("添加附件（先保存编辑，最多 10 个 / 合计 20 MiB）", "Add attachments (save edits first; up to 10 files / 20 MiB total)"), h("input", { type: "file", multiple: true, disabled: busy || dirty, "aria-label": dt("添加附件", "Add attachments"), onChange: event => { const files = Array.from(event.target.files || []); event.target.value = ""; run(async () => { let current = selected; for (const file of files) { if (file.size > 20 * 1024 * 1024) throw new Error(dt("单个附件超过 20 MiB", "Attachment exceeds 20 MiB")); current = await draftApi("upload", { id: current.id, revision: current.revision }, file); adopt(current); } await reload(); setNotice(dt("附件已添加，尚未发送。请检查预览。", "Attachments added. Review before sending.")); }); } })]) : null,
+        !locked ? h("label", { className: "dshe-upload" }, [dt("添加附件（先保存编辑，最多 10 个 / 合计 ", "Add attachments (save edits first; up to 10 files / ") + capLabel + dt("）", " total)"), h("input", { type: "file", multiple: true, disabled: busy || dirty, "aria-label": dt("添加附件", "Add attachments"), onChange: event => { const files = Array.from(event.target.files || []); event.target.value = ""; run(async () => { let current = selected; for (const file of files) { if (file.size > attachmentCap) throw new Error(dt("单个附件超过 ", "Attachment exceeds ") + capLabel); current = await draftApi("upload", { id: current.id, revision: current.revision }, file); adopt(current); } await reload(); setNotice(dt("附件已添加，尚未发送。请检查预览。", "Attachments added. Review before sending.")); }); } })]) : null,
         !locked ? h("div", { className: "dshe-actions" }, [
           h("button", { type: "button", className: "dshe-btn", disabled: busy || !dirty, onClick: () => run(save) }, dt("保存草稿", "Save draft")),
           h("button", { type: "button", className: "dshe-btn primary", disabled: busy || dirty, onClick: () => run(async () => { setPreview(await draftApi("preview", { id: selected.id, revision: selected.revision })); setAcknowledged(false); setNotice(""); }) }, dt("检查发送预览", "Review before sending")),
         ]) : null,
         review,
-        selected.receipt ? h("div", { className: "dshe-alert " + (selected.receipt.rejected.length ? "info" : "success"), role: "status" }, [(selected.receipt.rejected.length ? dt("部分地址被服务器拒绝，邮件不会自动重发。服务器接受：", "Some addresses were rejected. This email will not retry automatically. Server accepted: ") : dt("SMTP 已返回回执，邮件不会再次发送。服务器接受：", "SMTP receipt saved. This draft will not send again. Server accepted: ")) + (selected.receipt.accepted.join(", ") || dt("无", "none")), h("p", null, dt("服务器拒绝：", "Server rejected: ") + (selected.receipt.rejected.join(", ") || dt("无", "none"))), h("p", null, dt("这是服务器提交结果，不代表已送达收件人的收件箱。", "This confirms the server response, not delivery to the recipient inbox."))]) : null,
+        selected.receipt ? h("div", { className: "dshe-alert " + (selected.receipt.rejected.length ? "info" : "success"), role: "status" }, [(selected.receipt.rejected.length ? dt("部分地址被服务器拒绝，邮件不会自动重发。服务器接受：", "Some addresses were rejected. This email will not retry automatically. Server accepted: ") : dt("服务器已返回回执，邮件不会再次发送。服务器接受：", "Server receipt saved. This draft will not send again. Server accepted: ")) + (selected.receipt.accepted.join(", ") || dt("无", "none")), h("p", null, dt("服务器拒绝：", "Server rejected: ") + (selected.receipt.rejected.join(", ") || dt("无", "none"))), h("p", null, dt("这是服务器提交结果，不代表已送达收件人的收件箱。", "This confirms the server response, not delivery to the recipient inbox."))]) : null,
         selected.state === "uncertain" || selected.state === "sending" ? h("div", { className: "dshe-alert info", role: "status" }, selected.error || dt("提交尚未留下回执。先核对邮箱，再刷新列表；不要重复发送。", "No receipt yet. Check your mailbox, then refresh the list. Do not send again.")) : null,
         h("div", { className: "dshe-local-actions" }, [
           h("button", { type: "button", className: "dshe-btn", disabled: busy || selected.state === "sending" || dirty, onClick: () => setCopy(true) }, dt("复制为新草稿", "Copy to a new draft")),
@@ -2374,6 +2469,8 @@ function RecipientRules({ active, onSaved }) {
 
 function EmailSettingsSection() {
   const [tab, setTab] = useState(emailActiveTab);
+  const [requestedDraft,setRequestedDraft]=useState("");
+  const openMailboxDraft=id=>{setRequestedDraft(id);setTab("drafts");};
   useEffect(() => { emailActiveTab = tab; }, [tab]);
   const [draft, setDraft] = useState(null);
   useEffect(() => {
@@ -2661,13 +2758,14 @@ function EmailSettingsSection() {
 
   return h("div", { className: "dshe-settings" }, [
     h("header", { className: "dshe-header" }, [
-      h("span", { className: "dshe-kicker" }, "dsh-email · IMAP/SMTP"),
+      h("span", { className: "dshe-kicker" }, "dsh-email · IMAP / SMTP / AgentMail"),
       h("h2", null, t("section.title")),
-      h("p", null, dt("配置邮箱账号，编辑草稿并确认发送，或管理收件人规则。账号设置修改后会自动保存。", "Configure accounts, edit and confirm drafts, or manage recipient rules. Account settings save automatically.")),
+      h("p", null, dt("浏览和搜索邮件，把回复存成草稿，核对后发送。账号设置修改后会自动保存。", "Browse and search mail, prepare replies in drafts, and review before sending. Account settings save automatically.")),
     ]),
     tab === "accounts" ? status : null,
-    h("div", { className: "dshe-tabs", role: "tablist", "aria-label": dt("邮件功能", "Email features") }, [["accounts", dt("邮箱账号", "Accounts")], ["drafts", dt("草稿", "Drafts")], ["rules", dt("收件人规则", "Recipient rules")]].map(([id, label]) => h("button", { key: id, type: "button", role: "tab", className: "dshe-btn", "aria-selected": tab === id, "aria-controls": "dshe-pane-" + id, onClick: () => setTab(id) }, label))),
-    h("div", { id: "dshe-pane-drafts", role: "tabpanel", hidden: tab !== "drafts", className: "dshe-section-hidden" }, h(DraftWorkbench, { active: tab === "drafts" })),
+    h("div", { className: "dshe-tabs", role: "tablist", "aria-label": dt("邮件功能", "Email features") }, [["accounts", dt("邮箱账号", "Accounts")], ["mailbox", dt("收发邮件", "Mailbox")], ["drafts", dt("草稿", "Drafts")], ["rules", dt("收件人规则", "Recipient rules")]].map(([id, label]) => h("button", { key: id, type: "button", role: "tab", className: "dshe-btn", "aria-selected": tab === id, "aria-controls": "dshe-pane-" + id, onClick: () => setTab(id) }, label))),
+    h("div", {id:"dshe-pane-mailbox",role:"tabpanel",hidden:tab!=="mailbox",className:"dshe-section-hidden"},h(MailboxWorkbench,{active:tab==="mailbox",onConfigure:()=>setTab("accounts"),onDraft:openMailboxDraft})),
+    h("div", { id: "dshe-pane-drafts", role: "tabpanel", hidden: tab !== "drafts", className: "dshe-section-hidden" }, h(DraftWorkbench, { active: tab === "drafts", requestedDraft })),
     h("div", { id: "dshe-pane-rules", role: "tabpanel", hidden: tab !== "rules", className: "dshe-section-hidden" }, h(RecipientRules, { active: tab === "rules", onSaved: revision => { setSnapshot(old => ({ ...old, settings: { ...old.settings, revision } })); } })),
     h("section", { id: "dshe-pane-accounts", role: "tabpanel", hidden: tab !== "accounts", className: "dshe-panel dshe-section-hidden" }, [
       // 全局设置：发信确认和下载目录对所有账号一视同仁，不属于任何一张卡片，

package/lib/config.d.ts

@@ -71,6 +71,8 @@ export declare const ENDPOINT_DEFAULTS: {
 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 {
+    /** AgentMail credential; the account editor also accepts it through its secret field. */
+    apiKey?: string;
     /** Built-in provider name, or a custom serverPresets name. */
     provider?: ProviderRef;
     user?: string;
@@ -175,6 +177,8 @@ export declare const PROVIDER_NAMES: string[];
 export declare const EMAIL_PASSWORD_ENV = "DSH_EMAIL_PASSWORD";
 /** Fully resolved, validated configuration for one account. */
 export interface ResolvedEmailConfig {
+    transport?: 'agentmail';
+    apiBase?: 'https://api.agentmail.to' | 'https://api.agentmail.eu';
     user: string;
     /** Display name for the From header, '' when the account does not set one. */
     senderName: string;

package/lib/config.js

@@ -228,7 +228,7 @@ export function resolveEmailSettings(config, onlyAccount) {
     const common = {
         provider: raw.provider,
         user: raw.user,
-        password: raw.password,
+        password: raw.password, apiKey: raw.apiKey,
         senderName: raw.senderName,
         authUser: raw.authUser,
         authPassword: raw.authPassword,
@@ -327,7 +327,7 @@ function providerTable(custom) {
 }
 /** Every name a `provider:` may legally use, built-ins first. */
 export function providerNames(custom = {}) {
-    const names = [...PROVIDER_NAMES];
+    const names = [...PROVIDER_NAMES, 'agentmail', 'agentmail-eu'];
     for (const name of Object.keys(custom))
         if (!names.includes(name))
             names.push(name);
@@ -369,6 +369,16 @@ function resolveAccount(name, common, acc, allowEnvPassword, providers, known) {
     // Normalize it like the legacy projection and YAML writer before preset lookup.
     const requested = (acc.provider === '' ? undefined : acc.provider) ?? (common.provider === '' ? undefined : common.provider);
     const preset = requested === undefined ? undefined : providers[requested];
+    if (requested === 'agentmail' || requested === 'agentmail-eu') {
+        const user = String(acc.user ?? common.user ?? '').trim();
+        const sharedApi = common.provider === requested;
+        const key = String(acc.password || acc.apiKey || (sharedApi ? common.password || common.apiKey : '') || (allowEnvPassword ? process.env.DSH_AGENTMAIL_API_KEY ?? '' : '')).trim();
+        if (!/^[^\s<>@]+@[^\s<>@]+\.[^\s<>@]+$/.test(user) || !key || key.length > 4096 || /[^\x21-\x7e]/.test(key))
+            throw new Error('AgentMail 账号需要有效邮箱地址和 API Key，请在「设置 → 邮件」补全后测试连接。');
+        return { transport: 'agentmail', apiBase: requested === 'agentmail-eu' ? 'https://api.agentmail.eu' : 'https://api.agentmail.to', user,
+            senderName: '', authUser: user, authPassword: key, password: key, authKind: 'password',
+            imap: { host: '', port: 993, secure: true }, smtp: { host: '', port: 465, secure: true }, inboxFolder: 'INBOX' };
+    }
     if (requested !== undefined && preset === undefined) {
         throw new Error(`dsh-email：账号 "${name}" 的 provider "${requested}" 未知，可选：${known.join('/')}；或省略 provider 直接填 imap.host 与 smtp.host`);
     }

package/lib/draft-store.d.ts

@@ -21,6 +21,11 @@ export interface EmailDraft {
     attemptAt?: string;
     receipt?: EmailSendResult;
     error?: string;
+    reply?: {
+        uid: number | string;
+        folder: string;
+        uidValidity?: number;
+    };
 }
 export interface DraftFields {
     account: string;

package/lib/draft-store.js

@@ -43,6 +43,10 @@ export class DraftStore {
                 if (!isId(draft.id) || !Number.isSafeInteger(draft.revision) || draft.revision < 1 || !['draft', 'sending', 'sent', 'uncertain'].includes(draft.state))
                     throw new Error('invalid draft');
                 draftFields(draft);
+                if (draft.reply && (!(typeof draft.reply.uid === 'number' && Number.isSafeInteger(draft.reply.uid) && draft.reply.uid > 0 || typeof draft.reply.uid === 'string' && draft.reply.uid.length > 0 && draft.reply.uid.length <= 998 && !/[\r\n\0]/.test(draft.reply.uid)) || typeof draft.reply.folder !== 'string' || draft.reply.folder.length > 1024))
+                    throw new Error('invalid reply reference');
+                if (draft.reply?.uidValidity !== undefined && (!Number.isSafeInteger(draft.reply.uidValidity) || draft.reply.uidValidity <= 0))
+                    throw new Error('invalid reply UIDVALIDITY');
                 if (!Array.isArray(draft.attachments) || draft.attachments.length > 10 || draft.attachments.some(file => !isId(file.id) || !isAbsolute(file.path) || typeof file.filename !== 'string' || typeof file.owned !== 'boolean'))
                     throw new Error('invalid attachments');
             }

package/lib/draft-web.js

@@ -37,7 +37,7 @@ export class EmailDraftBackend {
         if (!config)
             throw new DraftError('发件账号不存在，请重新选择账号');
         const value = this.runtime.getSettingsValue(), policies = parseRecipientPolicies(value.trustedRecipientsYaml);
-        return { name, config, cap: Math.min(settings.maxAttachmentBytes, MAX_BYTES), policy: policies.get(name), key: hash({ name, config, cap: settings.maxAttachmentBytes, policies: value.trustedRecipientsYaml ?? '', approval: value.sendApproval }) };
+        return { name, config, cap: Math.min(settings.maxAttachmentBytes, config.transport === 'agentmail' ? 4 * 1024 * 1024 : MAX_BYTES), policy: policies.get(name), key: hash({ name, config, cap: settings.maxAttachmentBytes, policies: value.trustedRecipientsYaml ?? '', approval: value.sendApproval }) };
     }
     safe(error) {
         let message = redactCredentials(messageOf(error, '操作失败，请稍后重试'));
@@ -127,7 +127,13 @@ export class EmailDraftBackend {
         if (body.action === 'list') {
             await this.recover(signal);
             const snapshot = await this.settings.snapshot();
-            return { drafts: (await this.store.list()).map(view), accounts: snapshot.accounts, revision: snapshot.settings.revision, writable: snapshot.writable };
+            const attachmentLimits = {};
+            try {
+                for (const name of this.runtime.getEffectiveSettings().accounts.keys())
+                    attachmentLimits[name] = this.connection(name).cap;
+            }
+            catch { /* Drafts remain usable before account setup. */ }
+            return { drafts: (await this.store.list()).map(view), accounts: snapshot.accounts, attachmentLimits, revision: snapshot.settings.revision, writable: snapshot.writable };
         }
         if (body.action === 'rules') {
             const snapshot = await this.settings.snapshot();
@@ -162,6 +168,8 @@ export class EmailDraftBackend {
         if (body.action === 'update') {
             editable(draft);
             const fields = draftFields(body), keep = body.attachments ?? draft.attachments.map(file => file.id);
+            if (draft.reply && (fields.account !== draft.account || fields.subject !== draft.subject))
+                throw new DraftError('回复草稿须保留原发件账号和主题；如需更换请新建邮件');
             if (!Array.isArray(keep) || keep.some(key => !draft.attachments.some(file => file.id === key)) || new Set(keep).size !== keep.length)
                 throw new DraftError('附件列表无效，请重新打开草稿');
             const changed = await this.store.change(id, body.revision, value => { editable(value); Object.assign(value, fields); value.attachments = value.attachments.filter(file => keep.includes(file.id)); }, signal);
@@ -192,7 +200,8 @@ export class EmailDraftBackend {
                     files.push(stored);
                     await this.writeUpload(owned.path, file.content, signal);
                 }
-                const changed = await this.store.change(created.id, created.revision, value => { value.attachments = files; }, signal);
+                const changed = await this.store.change(created.id, created.revision, value => { value.attachments = files; if (draft.reply)
+                    value.reply = { ...draft.reply }; }, signal);
                 return view(changed);
             }
             catch (error) {
@@ -245,7 +254,7 @@ export class EmailDraftBackend {
                 }
                 let receipt;
                 try {
-                    receipt = await pool.sendPrepared(before.account, before.to, before.subject, before.text, before.cc, plan.attachments.map(({ filename, content }) => ({ filename, content })), current);
+                    receipt = await pool.sendPrepared(before.account, before.to, before.subject, before.text, before.cc, plan.attachments.map(({ filename, content }) => ({ filename, content })), current, before.reply);
                 }
                 catch (error) {
                     if (error instanceof RecipientPolicyError) {
@@ -257,12 +266,12 @@ export class EmailDraftBackend {
                         throw new DraftError('提交结果未确定，且回执未能保存；请先去邮箱核对，不要直接重发', 'draft-storage');
                     return { draft: view(failed) };
                 }
-                // Once SMTP acknowledges, a disconnected browser must not prevent the receipt from being persisted.
+                // Once the server acknowledges, persist its receipt even if the browser disconnects.
                 try {
                     return { draft: view(await this.store.change(id, pending.revision, value => { value.state = 'sent'; value.receipt = receipt; })) };
                 }
                 catch {
-                    throw new DraftError('SMTP 已返回回执，但本地保存失败；请先核对邮箱，不要再次发送', 'draft-storage');
+                    throw new DraftError('服务器已返回回执，但本地保存失败；请先核对邮箱，不要再次发送', 'draft-storage');
                 }
             }, signal);
         }

package/lib/host-config.js

@@ -7,6 +7,7 @@ const endpoint = () => z.object({
 export const Config = z.object({
     provider: z.string().volatile(), user: z.string().volatile(),
     password: z.string().role('secret').volatile(),
+    apiKey: z.string().role('secret').volatile(),
     senderName: z.string().volatile(), authUser: z.string().volatile(),
     authPassword: z.string().role('secret').volatile(),
     clientId: z.string().volatile(), authKind: z.union(['password', 'oauth2']).volatile(),

package/lib/index.d.ts

@@ -1,10 +1,13 @@
 import type { EmailConfig } from './config.js';
+import { type MailDependencies } from './mail-service.js';
 export declare const Config: import("@deepseek-ai/schemastery").default;
 export declare const name = "tool-email";
 export declare const inject: string[];
 export type Config = EmailConfig;
 /** Compose settings/pool lifecycle, tools, browser routes and the outgoing-mail gate. */
 export declare function apply(ctx: any, config?: Config): void;
+/** Shared application assembly; transports can be supplied by embedders and protocol fixtures. */
+export declare function installEmailApplication(ctx: any, config?: Config, dependencies?: MailDependencies): void;
 export { clampInt, defaultDownloadDir, EMAIL_PASSWORD_ENV, isOAuth2Account, OUTLOOK_OAUTH2_CLIENT_ID, OUTLOOK_PROVIDER, parseAccountsYaml, parseServerPresets, presetNamesIn, providerNames, PROVIDER_NAMES, resolveEmailConfig, resolveEmailSettings, serializeAccountsYaml } from './config.js';
 export type { AuthKind, ResolvedEmailConfig } from './config.js';
 export { ACCESS_TOKEN_MARGIN_MS, classifyOAuthFailure, clearTokenFor, clientIdOf, DEVICE_CODE_URL, getFreshAccessToken, mapAadstsMessage, NO_CLIENT_ID_MESSAGE, NOT_LOGGED_IN_MESSAGE, oauth2StateOf, oauth2TokenFile, OAUTH2_SCOPES, OAuth2Error, pollDeviceFlow, readTokenStore, startDeviceFlow, TOKEN_URL, writeTokenStore, } from './oauth2.js';
@@ -17,3 +20,6 @@ export { EmailSettingsBackend, installEmailSettingsWeb, SETTINGS_ROUTE } from '.
 export type { AccountCardData, AccountCardInput } from './web.js';
 export { EmailDraftBackend, installEmailDrafts, EMAIL_DRAFT_ROUTE } from './draft-web.js';
 export { DraftStore, DraftError } from './draft-store.js';
+export { AgentMailClient } from './agentmail.js';
+export { EmailService } from './mail-service.js';
+export { EmailMailboxBackend, installEmailMailbox, MAILBOX_ROUTE } from './mailbox-web.js';

package/lib/index.js

@@ -6,11 +6,17 @@ import { liveConfig, Config as ConfigSchema } from './host-config.js';
 import { installLegacySettingsImport } from './legacy-settings.js';
 import { EmailSettingsSchema, SETTINGS_NAMESPACE } from './settings.js';
 import { EmailDraftBackend, installEmailDrafts } from './draft-web.js';
+import { EmailMailboxBackend, installEmailMailbox } from './mailbox-web.js';
+import { EmailService } from './mail-service.js';
 export const Config = ConfigSchema;
 export const name = 'tool-email';
 export const inject = ['settings', 'tools'];
 /** Compose settings/pool lifecycle, tools, browser routes and the outgoing-mail gate. */
 export function apply(ctx, config = {}) {
+    installEmailApplication(ctx, config);
+}
+/** Shared application assembly; transports can be supplied by embedders and protocol fixtures. */
+export function installEmailApplication(ctx, config = {}, dependencies = {}) {
     config = liveConfig(config);
     installLegacySettingsImport(ctx, config, SETTINGS_NAMESPACE, 'tool-email', Object.keys(EmailSettingsSchema.dict));
     if (typeof ctx.settings.configure === 'function' && typeof ctx.inject === 'function') {
@@ -18,12 +24,13 @@ export function apply(ctx, config = {}) {
             settingsCtx.effect(() => settingsCtx.settings.configure({ auto: false }, ctx.fiber));
         });
     }
-    const runtime = createEmailRuntime(ctx, config);
-    const backend = new EmailSettingsBackend(ctx, runtime.settingsScope, config);
+    const runtime = createEmailRuntime(ctx, config, settings => new EmailService(settings, dependencies));
+    const backend = new EmailSettingsBackend(ctx, runtime.settingsScope, config, dependencies.fetch);
     backend.watchImpl = runtime.watch;
     installEmailSettingsWeb(ctx, backend);
     const drafts = new EmailDraftBackend(runtime, backend);
     installEmailDrafts(ctx, drafts);
+    installEmailMailbox(ctx, new EmailMailboxBackend(runtime, drafts));
     for (const definition of buildEmailTools(runtime, drafts))
         ctx.tools.register(definition);
     installSendApproval(ctx, runtime);
@@ -37,3 +44,6 @@ export { parseEmailDay } from './tool-contract.js';
 export { EmailSettingsBackend, installEmailSettingsWeb, SETTINGS_ROUTE } from './web.js';
 export { EmailDraftBackend, installEmailDrafts, EMAIL_DRAFT_ROUTE } from './draft-web.js';
 export { DraftStore, DraftError } from './draft-store.js';
+export { AgentMailClient } from './agentmail.js';
+export { EmailService } from './mail-service.js';
+export { EmailMailboxBackend, installEmailMailbox, MAILBOX_ROUTE } from './mailbox-web.js';