| name | maildb-operations |
| description | Use when the user asks about email, mail, メール, 〆切, deadline, 受信, inbox, 返信, reply, IMAP, or references a mail database (univ, hu2022, apple, etc.). 正準システムは SourceVault mail サブシステム (SourceVault_maildb.wl, context SourceVault`): SourceVaultMailEnsureLoaded / SourceVaultMailView / SourceVaultSearchMailSnapshots / SourceVaultInferMailDerivedBatch / SourceVaultMailFetchNew / SourceVaultRegisterMailAccount。旧 maildb.wl は maildb_legacy.wl に改名され参照専用 (mailEnsureLoaded/showMails/searchFromMails/mailAskLLM は新規コードで使わない)。Security routing: privacy > 0.5 は $ClaudePrivateModel (ローカル LLM)。 |
メール操作ガイド (正準: SourceVault mail サブシステム)
⛔ 最重要: メールは SourceVault mail サブシステムを使う
メール操作のコードは `SourceVault`` context の関数で生成する。
- ❌
Needs["Maildb\"]/mailEnsureLoaded/showMails/searchFromMails/mailAskLLM は**使わない**。maildb.wlは廃止されmaildb_legacy.wl (参照専用) に改名済み。Maildb`` パッケージはロードできない。
- ✅
SourceVaultMailEnsureLoaded → SourceVaultMailView / SourceVaultSearchMailSnapshots を使う。
関数名が不確実なら Get/Import でファイルを読まず、Names["SourceVaultMail*"] で検索し、SourceVault_info/docs/api_maildb.md を参照する (rule 13)。
基本ワークフロー (2 段)
- ロード (月シャード単位の増分・キャッシュ付き):
SourceVaultMailEnsureLoaded[mbox, period]
- 表示 / 検索 (ロード済み snapshot を絞り込み):
SourceVaultMailView[query, opts] / SourceVaultSearchMailSnapshots[query, opts]
(* univ の 2026年6月分シャードをロードしてから 6/5〜6/6 を一覧 *)
SourceVaultMailEnsureLoaded["univ", "202606"];
SourceVaultMailView["", MBox -> "univ",
DateFrom -> DateObject[{2026, 6, 5}], DateTo -> DateObject[{2026, 6, 6}],
Newest -> True]
主要関数
SourceVaultMailEnsureLoaded[mbox, period]
メモリへ増分ロード。何度呼んでも高速。<|Status, MBox, Period, Shards, NewlyLoaded, InMemory|> を返す。
period 受理形式:
"Latest" または Automatic — 直近 (最新) の月シャード"YYYYMM" — その月のシャード (例 "202606"){"YYYYMM", "YYYYMM"} — 月の範囲n (正整数) — 直近 n か月分All — 全シャード
(注: {年,月} の整数リストや DateObject は EnsureLoaded の period には使わない。月は "YYYYMM" 文字列で渡す。)
SourceVaultMailView[query, opts] / SourceVaultMailDataset[query, opts]
ロード済み snapshot を対話表 Dataset (✉本文 / 📎添付 / ↩返信 ボタン付き) で表示。SourceVaultMailDataset はプレーン Dataset。query は件名/要約の部分文字列 (空文字 "" で全件)。
opts (= SourceVaultSearchMailSnapshots と同一):
MBox -> "univ" — メールボックスDateFrom / DateTo — DateObject / 文字列 / {y,m,d}。日単位の包含比較 (DateFrom=DateTo=同日 で当日が一致)Newest -> True — 新着 (日付降順)Limit -> n — 件数上限From, FromContact, HasAttachment, MinPriority/MaxPriority, MinPrivacy/MaxPrivacy, SortBy, SortOrder
SourceVaultSearchMailSnapshots[query, opts]
件名/要約の部分一致 + 各種フィルタで snapshot リストを返す (表示用の生データ)。opts は上記と同じ。
SourceVaultInferMailDerivedBatch[opts]
未処理メールの派生 (WorkRequest / PrivacyLevel / Summary) をローカル LLM で増分生成・in-place 更新 (中断耐性)。opts: Limit (既定50、範囲全部なら Infinity), DateFrom/DateTo (日付範囲で対象を限定), CheckpointEvery, Persist。
SourceVaultMailFetchNew[mbox, opts]
IMAP から新着取得。opts: Period ({年,月} / "YYYYMM" / "YYYY" / n日 / {from,to}), Overwrite, Process -> False (LLM 派生を分離)。
返信 (自動送信しない)
SourceVaultMailComposeReply[recordId, opts] (返信ドラフト生成) / SourceVaultMailOpenReplyNotebook[recordId] (返信ノートブックを開く)。
アカウント登録
SourceVaultRegisterMailAccount[<|"MBox","User","CredKey","Server","Port"|>] → vault config。ログイン情報をソースにハードコードしない (rule 03)。
典型的なユーザー要求 → 生成コード
| 要求 | コード |
|---|
| 「今日の univ メール」 | SourceVaultMailEnsureLoaded["univ", "Latest"]; SourceVaultMailView["", MBox->"univ", DateFrom->DateObject[Take[DateList[],3]], Newest->True] |
| 「2026/6/5〜6/6 の univ メール」 | SourceVaultMailEnsureLoaded["univ", "202606"]; SourceVaultMailView["", MBox->"univ", DateFrom->DateObject[{2026,6,5}], DateTo->DateObject[{2026,6,6}], Newest->True] |
| 「2026年3月のメール」 | SourceVaultMailEnsureLoaded["univ", "202603"]; SourceVaultMailView["", MBox->"univ", DateFrom->DateObject[{2026,3,1}], DateTo->DateObject[{2026,3,31}], Newest->True] |
| 「直近3か月のメール」 | SourceVaultMailEnsureLoaded["univ", 3]; SourceVaultMailView["", MBox->"univ", Newest->True] |
| 「研究費に関するメールを検索」 | SourceVaultMailEnsureLoaded["univ", "Latest"]; SourceVaultMailView["研究費", MBox->"univ", Newest->True] |
| 「重要メール一覧」 | SourceVaultMailView["", MBox->"univ", MinPriority->0.7, Newest->True] |
| 「公開メールのみ」 | SourceVaultMailView["", MBox->"univ", MaxPrivacy->0.5, Newest->True] |
| 「添付のあるメール」 | SourceVaultMailView["", MBox->"univ", HasAttachment->True, Newest->True] |
| 「新着を取得」 | SourceVaultMailFetchNew["univ", Period->"202606"] |
| 「範囲のメールの派生を生成」 | SourceVaultInferMailDerivedBatch["DateFrom"->DateObject[{2026,6,5}], "DateTo"->DateObject[{2026,6,6}], "Limit"->Infinity] |
セキュリティルーティング (最重要)
snapshot の Derived.PrivacyLevel > 0.5 のメールは $ClaudeModel (クラウド LLM) に送信しない。$ClaudePrivateModel (ローカル LLM) で処理する。SourceVaultSearchMailSnapshots[..., MaxPrivacy -> 0.5] で公開メールのみに絞れる。
- 本文は暗号化・ヘッダ (件名/From/To/日付) は平文+token (件名は設計上暗号化しない)。
- 永続データの復号には
NBAccess\$NBCredentialBackend = "SystemCredential"` が必須 (Memory backend だと別鍵で復号不可 = データ消失)。
- ScheduledTask 内で
ClaudeQuery を呼ばない (rules/95)。
不変条件
- 重要度は構造計算: LLM は依頼度 (WorkRequest) のみ判定。優先度は送信者グループ重み (
SourceVaultSetPriorityGroupWeight) + To/Cc 位置 + ML 判定で SourceVaultMailComputePriority が決定的に計算する。
- 2層アドレス帳 (識別子/実体): 取込で From/To/Cc が自動識別子化。実体は後でマージ (
SourceVaultIdentityLinkUI / EntityEditUI)。所有者 = ユーザDB #1 (SourceVaultOwnerEntity)。受信者プロフィールは所有者の LLMProfile から (ハードコードしない、rule 03)。
(参照のみ) 旧 maildb_legacy 対応表
旧 maildb.wl は maildb_legacy.wl に改名済み。以下の旧 API は maildb_legacy.wl を明示ロードした場合のみ有効で、新規コードでは使わない。
| 旧 (maildb_legacy) | 新 (SourceVault) |
|---|
mailEnsureLoaded["univ"] | SourceVaultMailEnsureLoaded["univ", period] |
showMails[mdb, opts] | SourceVaultMailView[query, opts] / SourceVaultMailDataset |
searchFromMails[mdb, phrase, n] | SourceVaultSearchMailSnapshots[query, opts] / SourceVaultMailView |
mailAskLLM[...] | SourceVaultInferMailDerivedBatch + SourceVaultMailComputePriority |
updateMonthlyMaildb / checkNewMail | SourceVaultMailFetchNew[mbox, opts] |
sendReply / sendReplyTr | SourceVaultMailComposeReply / SourceVaultMailOpenReplyNotebook |
$maildbDescriptions (ソース直書き) | SourceVaultRegisterMailAccount[...] → vault config |
