[{"data":1,"prerenderedAt":5731},["ShallowReactive",2],{"seo-locale-availability:\u002Fblog":3,"all-posts:ja":7},[4,5,6],"zh-CN","en","ja",[8,2535,4251,4510,4965,5367],{"id":9,"title":10,"accent":11,"body":12,"description":2507,"draft":2508,"experience":2509,"extension":2510,"featured":421,"image":2511,"meta":2517,"navigation":421,"path":2518,"publishedAt":2519,"readingTime":686,"seo":2520,"stem":2521,"tags":2522,"updatedAt":2509,"video":2527,"__hash__":2534,"contentLocale":6,"isFallback":2508},"posts_ja\u002Fblog\u002Fcloudflare-email-service-send-receive-guide.md","Cloudflare Email Service 送受信実践ガイド—Routing、Workers、API、SMTP まで","cyan",{"type":13,"value":14,"toc":2474},"minimark",[15,24,27,39,61,68,71,77,82,85,142,145,155,158,164,171,177,181,184,189,192,195,215,219,222,225,239,242,246,249,253,256,267,270,278,285,302,305,316,319,325,328,332,335,352,355,362,372,760,770,864,880,884,891,1026,1029,1046,1050,1076,1079,1100,1103,1107,1110,1117,1187,1193,1196,1215,1221,1225,1436,1442,1446,1449,1773,1776,1782,1787,1791,1794,1847,1850,1853,1874,1877,1880,2002,2005,2008,2011,2014,2020,2023,2046,2057,2060,2063,2066,2072,2075,2081,2085,2088,2113,2116,2136,2139,2143,2154,2160,2163,2166,2187,2190,2251,2254,2257,2289,2292,2295,2315,2318,2335,2338,2341,2344,2347,2350,2371,2374,2377,2470],[16,17,18,19,23],"p",{},"長い間、Cloudflare とメールの関係は主に二つでした。DNS を管理することと、Email Routing で ",[20,21,22],"code",{},"support@example.com"," を実際のメールボックスへ転送することです。",[16,25,26],{},"2026 年、この境界は大きく前へ進みました。",[16,28,29,30,34,35,38],{},"Cloudflare は 4 月に ",[31,32,33],"strong",{},"Email Sending"," を public beta へ移行し、Workers から ",[20,36,37],{},"env.EMAIL.send()"," を直接呼んでトランザクションメールを送れるようにしました。6 月には認証 SMTP も追加されました。従来の Email Routing と Email Workers を組み合わせると、Cloudflare Email Service は現在、次の処理を行えます。",[40,41,42,46,49,52,55,58],"ul",{},[43,44,45],"li",{},"独自ドメイン宛てのメールを受信する。",[43,47,48],{},"検証済みの実メールボックスへ転送する。",[43,50,51],{},"受信メールを Worker に渡し、解析、フィルター、保存、自動化を行う。",[43,53,54],{},"元のメールスレッド内で返信する。",[43,56,57],{},"Worker、REST API、SMTP からトランザクションメールを送る。",[43,59,60],{},"送信ログ、bounce、suppression、配信指標を確認する。",[16,62,63,64,67],{},"この記事は ",[31,65,66],{},"2026 年 7 月 28 日","時点の公式機能を基準に、Cloudflare のメール送受信モデル全体を整理し、Nuxt、Workers、D1 プロジェクトに適した実装方法を示します。",[16,69,70],{},"先に結論を述べます。",[72,73,74],"blockquote",{},[16,75,76],{},"Cloudflare Email Service は従来型の IMAP \u002F POP3 メールボックスでも、Web 画面でメールを読む企業向けスイートでもありません。「メールの入口、送信チャネル、プログラム可能なイベント」の集合として捉えると分かりやすく、認証コード、パスワードリセット、注文通知、システムアラート、サポートチケット、メール駆動の自動化に適しています。",[78,79,81],"h2",{"id":80},"最初に受信と送信を分ける","最初に「受信」と「送信」を分ける",[16,83,84],{},"メールの送受信は一つの機能に見えますが、Cloudflare では独立した二つの経路です。",[86,87,88,107],"table",{},[89,90,91],"thead",{},[92,93,94,98,101,104],"tr",{},[95,96,97],"th",{},"方向",[95,99,100],{},"Cloudflare 製品",[95,102,103],{},"入口",[95,105,106],{},"Worker でできること",[108,109,110,125],"tbody",{},[92,111,112,116,119,122],{},[113,114,115],"td",{},"受信",[113,117,118],{},"Email Routing \u002F Email Workers",[113,120,121],{},"外部メールサーバーが Cloudflare MX へ接続",[113,123,124],{},"転送、返信、拒否、解析、D1\u002FR2 への保存、Queue への投入",[92,126,127,130,132,135],{},[113,128,129],{},"送信",[113,131,33],{},[113,133,134],{},"Workers binding、REST API、認証 SMTP",[113,136,137,138,141],{},"text\u002FHTML、添付、カスタム header を送り、",[20,139,140],{},"messageId"," を取得",[16,143,144],{},"受信経路はおおよそ次のとおりです。",[146,147,153],"pre",{"className":148,"code":150,"language":151,"meta":152},[149],"language-text","送信元 SMTP\n → Cloudflare MX\n → SPF \u002F DKIM \u002F DMARC と reputation の確認\n → アドレスルールまたは Catch-all に一致\n → メールボックスへ転送 \u002F Worker \u002F drop\n","text","",[20,154,150],{"__ignoreMap":152},[16,156,157],{},"送信経路は次のとおりです。",[146,159,162],{"className":160,"code":161,"language":151,"meta":152},[149],"Nuxt API \u002F Worker \u002F 外部アプリケーション\n → EMAIL binding \u002F REST API \u002F SMTP\n → 送信ドメインとパラメータの検証\n → Cloudflare 配信パイプライン\n → 受信側メールサーバー\n",[20,163,161],{"__ignoreMap":152},[16,165,166],{},[167,168],"img",{"alt":169,"src":170},"メールはエッジ入口で検査され、実メールボックス、Worker 処理ノード、拒否経路へ振り分けられる","\u002Fmedia\u002Fposts\u002Fcloudflare-email-service-send-receive-guide\u002Finbound-routing-v1.webp",[16,172,173],{},[174,175,176],"em",{},"これは概念図です。実際の判断には SMTP セッション、メール認証、ルールマッチ、Worker 実行制限も含まれます。",[78,178,180],{"id":179},"_2026-年の製品境界と料金","2026 年の製品境界と料金",[16,182,183],{},"Cloudflare は現在、受信と送信を Email Service の下にまとめていますが、利用できるプランは異なります。",[185,186,188],"h3",{"id":187},"email-routing受信と転送","Email Routing：受信と転送",[16,190,191],{},"Email Routing は Workers Free と Workers Paid の両方で利用できます。公式料金ページでは受信メール数は無制限とされていますが、Worker が処理するメールは対応する Worker リクエストと計算資源を消費します。",[16,193,194],{},"適している用途は次のとおりです。",[40,196,197,203,206,212],{},[43,198,199,202],{},[20,200,201],{},"support@yourdomain.com"," を既存の個人メールボックスへ転送する。",[43,204,205],{},"サイトごとに独立した連絡先アドレスを作る。",[43,207,208,211],{},[20,209,210],{},"orders+shop-a@yourdomain.com"," のような sub-address で送信元を区別する。",[43,213,214],{},"受信メールを Worker でチケット、Webhook、データベースレコードへ変換する。",[185,216,218],{"id":217},"email-sendingトランザクションメール","Email Sending：トランザクションメール",[16,220,221],{},"Email Sending は現在も public beta です。",[16,223,224],{},"任意の受信者への送信には Workers Paid プランが必要です。2026 年 7 月の公式料金では、",[40,226,227,230,233,236],{},[43,228,229],{},"アカウントごとに月 3,000 通の送信が含まれる。",[43,231,232],{},"超過後は 1,000 通あたり 0.35 ドル。",[43,234,235],{},"アカウント内の「検証済み宛先アドレス」へのメールは常に無料で、含まれる枠を消費しない。",[43,237,238],{},"Email Service に受理されたメールは、後で hard bounce しても通常は枠を消費する。API 境界で直接拒否されたリクエストは消費しない。",[16,240,241],{},"料金と beta 状態は今後も変わる可能性があります。本番導入前に公式料金ページを再確認し、この記事の数値を予算モデルへ固定しないでください。",[78,243,245],{"id":244},"第-1-歩ドメインを正しく接続する","第 1 歩：ドメインを正しく接続する",[16,247,248],{},"Email Service は Cloudflare DNS を利用するドメインを必要とします。送信と受信では用途の異なる二組の DNS record が作られます。",[185,250,252],{"id":251},"受信はルートドメインの-record-を使う","受信はルートドメインの record を使う",[16,254,255],{},"Email Routing を有効にすると、Cloudflare はドメインルートに次を設定します。",[40,257,258,261,264],{},[43,259,260],{},"MX：受信メールを Cloudflare のメール入口へ届ける。",[43,262,263],{},"SPF：Cloudflare による転送を許可する。",[43,265,266],{},"DKIM：転送経路へ署名を付与する。",[16,268,269],{},"これらは「第三者が自分のドメインへメールを送る」経路を担当します。",[185,271,273,274,277],{"id":272},"送信は-cf-bounce-record-を使う","送信は ",[20,275,276],{},"cf-bounce"," record を使う",[16,279,280,281,284],{},"Email Sending を有効にすると、Cloudflare は ",[20,282,283],{},"cf-bounce.yourdomain.com"," に次を設定します。",[40,286,287,290,293,296],{},[43,288,289],{},"MX：bounce を処理する。",[43,291,292],{},"SPF：Cloudflare がドメインを代理して送信することを許可する。",[43,294,295],{},"DKIM：メール内容が転送中に変更されていないことを検証する。",[43,297,298,301],{},[20,299,300],{},"_dmarc.yourdomain.com","：認証失敗時の処理方針を宣言する。",[16,303,304],{},"送信と受信は異なる DKIM selector を使います。DKIM record が二つあっても重複設定ではありません。",[16,306,307,308,311,312,315],{},"Google Workspace、Microsoft 365、その他のメールサービスをすでに使っている場合は、MX と SPF の競合を特に確認してください。一つのドメインに有効な SPF policy は一つだけです。複数サービスを同時に許可する場合は ",[20,309,310],{},"include"," を統合し、二つ目の ",[20,313,314],{},"v=spf1"," を作らないでください。",[16,317,318],{},"reputation の用途ごとに subdomain を分けることを勧めます。",[146,320,323],{"className":321,"code":322,"language":151,"meta":152},[149],"noreply@example.com アカウント認証とパスワードリセット\nnotify@mail.example.com プロダクト通知\nsupport@example.com 人によるサポートと受信処理\n",[20,324,322],{"__ignoreMap":152},[16,326,327],{},"トランザクション通知、人とのやり取り、将来の一括メールが互いの reputation を損なわず、障害と移行の境界も明確になります。",[78,329,331],{"id":330},"メール受信転送ルールから-email-worker-まで","メール受信：転送ルールから Email Worker まで",[16,333,334],{},"最も簡単な受信方法にはコードが不要です。",[336,337,338,341,346,349],"ol",{},[43,339,340],{},"Email Routing に検証済みの宛先メールボックスを追加する。",[43,342,343,345],{},[20,344,201],{}," を作成する。",[43,347,348],{},"「メールへ送信」を選択する。",[43,350,351],{},"Cloudflare が受信メールを宛先へ転送する。",[16,353,354],{},"件名で分類し、添付を抽出し、チケットを作り、自動返信したい場合は、action を「Worker へ送信」に変えます。",[185,356,358,361],{"id":357},"email-が受信メールの入口",[20,359,360],{},"email()"," が受信メールの入口",[16,363,364,365,368,369,371],{},"Email Worker の入口は ",[20,366,367],{},"fetch()"," ではなく ",[20,370,360],{}," です。",[146,373,377],{"className":374,"code":375,"language":376,"meta":152,"style":152},"language-ts shiki shiki-themes github-dark github-dark","interface Env {\n SUPPORT_FORWARD_TO: string\n}\n\nexport default {\n async email(message, env): Promise\u003Cvoid> {\n const recipient = message.to.toLowerCase()\n const subject = message.headers.get('subject') ?? ''\n\n if (message.rawSize > 10 * 1024 * 1024) {\n message.setReject('Message is too large for this mailbox')\n return\n }\n\n if (recipient === 'support@example.com') {\n console.log('Support email accepted', {\n fromDomain: message.from.split('@').at(-1),\n subjectLength: subject.length,\n rawSize: message.rawSize,\n })\n\n await message.forward(env.SUPPORT_FORWARD_TO)\n return\n }\n\n message.setReject('Unknown recipient')\n },\n} satisfies ExportedHandler\u003CEnv>\n","ts",[20,378,379,396,410,416,423,434,472,493,524,529,557,574,580,586,591,607,624,655,667,673,679,684,704,709,714,719,734,740],{"__ignoreMap":152},[380,381,384,388,392],"span",{"class":382,"line":383},"line",1,[380,385,387],{"class":386},"sOPea","interface",[380,389,391],{"class":390},"sFR8T"," Env",[380,393,395],{"class":394},"suv1-"," {\n",[380,397,399,403,406],{"class":382,"line":398},2,[380,400,402],{"class":401},"s-3mD"," SUPPORT_FORWARD_TO",[380,404,405],{"class":386},":",[380,407,409],{"class":408},"s8ozJ"," string\n",[380,411,413],{"class":382,"line":412},3,[380,414,415],{"class":394},"}\n",[380,417,419],{"class":382,"line":418},4,[380,420,422],{"emptyLinePlaceholder":421},true,"\n",[380,424,426,429,432],{"class":382,"line":425},5,[380,427,428],{"class":386},"export",[380,430,431],{"class":386}," default",[380,433,395],{"class":394},[380,435,437,440,443,446,449,452,455,458,460,463,466,469],{"class":382,"line":436},6,[380,438,439],{"class":386}," async",[380,441,442],{"class":390}," email",[380,444,445],{"class":394},"(",[380,447,448],{"class":401},"message",[380,450,451],{"class":394},", ",[380,453,454],{"class":401},"env",[380,456,457],{"class":394},")",[380,459,405],{"class":386},[380,461,462],{"class":390}," Promise",[380,464,465],{"class":394},"\u003C",[380,467,468],{"class":408},"void",[380,470,471],{"class":394},"> {\n",[380,473,475,478,481,484,487,490],{"class":382,"line":474},7,[380,476,477],{"class":386}," const",[380,479,480],{"class":408}," recipient",[380,482,483],{"class":386}," =",[380,485,486],{"class":394}," message.to.",[380,488,489],{"class":390},"toLowerCase",[380,491,492],{"class":394},"()\n",[380,494,496,498,501,503,506,509,511,515,518,521],{"class":382,"line":495},8,[380,497,477],{"class":386},[380,499,500],{"class":408}," subject",[380,502,483],{"class":386},[380,504,505],{"class":394}," message.headers.",[380,507,508],{"class":390},"get",[380,510,445],{"class":394},[380,512,514],{"class":513},"s4wv1","'subject'",[380,516,517],{"class":394},") ",[380,519,520],{"class":386},"??",[380,522,523],{"class":513}," ''\n",[380,525,527],{"class":382,"line":526},9,[380,528,422],{"emptyLinePlaceholder":421},[380,530,532,535,538,541,544,547,550,552,554],{"class":382,"line":531},10,[380,533,534],{"class":386}," if",[380,536,537],{"class":394}," (message.rawSize ",[380,539,540],{"class":386},">",[380,542,543],{"class":408}," 10",[380,545,546],{"class":386}," *",[380,548,549],{"class":408}," 1024",[380,551,546],{"class":386},[380,553,549],{"class":408},[380,555,556],{"class":394},") {\n",[380,558,560,563,566,568,571],{"class":382,"line":559},11,[380,561,562],{"class":394}," message.",[380,564,565],{"class":390},"setReject",[380,567,445],{"class":394},[380,569,570],{"class":513},"'Message is too large for this mailbox'",[380,572,573],{"class":394},")\n",[380,575,577],{"class":382,"line":576},12,[380,578,579],{"class":386}," return\n",[380,581,583],{"class":382,"line":582},13,[380,584,585],{"class":394}," }\n",[380,587,589],{"class":382,"line":588},14,[380,590,422],{"emptyLinePlaceholder":421},[380,592,594,596,599,602,605],{"class":382,"line":593},15,[380,595,534],{"class":386},[380,597,598],{"class":394}," (recipient ",[380,600,601],{"class":386},"===",[380,603,604],{"class":513}," 'support@example.com'",[380,606,556],{"class":394},[380,608,610,613,616,618,621],{"class":382,"line":609},16,[380,611,612],{"class":394}," console.",[380,614,615],{"class":390},"log",[380,617,445],{"class":394},[380,619,620],{"class":513},"'Support email accepted'",[380,622,623],{"class":394},", {\n",[380,625,627,630,633,635,638,641,644,646,649,652],{"class":382,"line":626},17,[380,628,629],{"class":394}," fromDomain: message.from.",[380,631,632],{"class":390},"split",[380,634,445],{"class":394},[380,636,637],{"class":513},"'@'",[380,639,640],{"class":394},").",[380,642,643],{"class":390},"at",[380,645,445],{"class":394},[380,647,648],{"class":386},"-",[380,650,651],{"class":408},"1",[380,653,654],{"class":394},"),\n",[380,656,658,661,664],{"class":382,"line":657},18,[380,659,660],{"class":394}," subjectLength: subject.",[380,662,663],{"class":408},"length",[380,665,666],{"class":394},",\n",[380,668,670],{"class":382,"line":669},19,[380,671,672],{"class":394}," rawSize: message.rawSize,\n",[380,674,676],{"class":382,"line":675},20,[380,677,678],{"class":394}," })\n",[380,680,682],{"class":382,"line":681},21,[380,683,422],{"emptyLinePlaceholder":421},[380,685,687,690,693,696,699,702],{"class":382,"line":686},22,[380,688,689],{"class":386}," await",[380,691,692],{"class":394}," message.",[380,694,695],{"class":390},"forward",[380,697,698],{"class":394},"(env.",[380,700,701],{"class":408},"SUPPORT_FORWARD_TO",[380,703,573],{"class":394},[380,705,707],{"class":382,"line":706},23,[380,708,579],{"class":386},[380,710,712],{"class":382,"line":711},24,[380,713,585],{"class":394},[380,715,717],{"class":382,"line":716},25,[380,718,422],{"emptyLinePlaceholder":421},[380,720,722,725,727,729,732],{"class":382,"line":721},26,[380,723,724],{"class":394}," message.",[380,726,565],{"class":390},[380,728,445],{"class":394},[380,730,731],{"class":513},"'Unknown recipient'",[380,733,573],{"class":394},[380,735,737],{"class":382,"line":736},27,[380,738,739],{"class":394}," },\n",[380,741,743,746,749,752,754,757],{"class":382,"line":742},28,[380,744,745],{"class":394},"} ",[380,747,748],{"class":386},"satisfies",[380,750,751],{"class":390}," ExportedHandler",[380,753,465],{"class":394},[380,755,756],{"class":390},"Env",[380,758,759],{"class":394},">\n",[16,761,762,763,765,766,769],{},"ここで ",[20,764,448],{}," は ",[20,767,768],{},"ForwardableEmailMessage"," です。よく使う field と操作は次のとおりです。",[86,771,772,782],{},[89,773,774],{},[92,775,776,779],{},[95,777,778],{},"機能",[95,780,781],{},"用途",[108,783,784,794,804,814,824,834,844,854],{},[92,785,786,791],{},[113,787,788],{},[20,789,790],{},"message.from",[113,792,793],{},"SMTP envelope の送信者",[92,795,796,801],{},[113,797,798],{},[20,799,800],{},"message.to",[113,802,803],{},"SMTP envelope の受信者",[92,805,806,811],{},[113,807,808],{},[20,809,810],{},"message.headers",[113,812,813],{},"Subject、Message-ID などの header を読む",[92,815,816,821],{},[113,817,818],{},[20,819,820],{},"message.raw",[113,822,823],{},"生の MIME stream",[92,825,826,831],{},[113,827,828],{},[20,829,830],{},"message.rawSize",[113,832,833],{},"生メールのサイズ",[92,835,836,841],{},[113,837,838],{},[20,839,840],{},"message.forward(address)",[113,842,843],{},"検証済み宛先へ転送する",[92,845,846,851],{},[113,847,848],{},[20,849,850],{},"message.reply(email)",[113,852,853],{},"制約の範囲内で元の送信者へ返信する",[92,855,856,861],{},[113,857,858],{},[20,859,860],{},"message.setReject(reason)",[113,862,863],{},"永続的な SMTP rejection を返す",[16,865,866,867,869,870,872,873,869,876,879],{},"見落としやすいセキュリティ上の注意があります。",[20,868,790],{}," \u002F ",[20,871,800],{}," は SMTP envelope の値で、メール本文 header 内の ",[20,874,875],{},"From:",[20,877,878],{},"To:"," とは異なる場合があります。認可、routing、audit では、ユーザーに表示する header アドレスを信頼できる identity と誤認しないでください。",[185,881,883],{"id":882},"本文が必要なときだけ-mime-を解析する","本文が必要なときだけ MIME を解析する",[16,885,886,887,890],{},"転送またはアドレスによる routing だけなら、メール全体を解析する必要はありません。本文と添付を取り出す場合は ",[20,888,889],{},"postal-mime"," を使えます。",[146,892,894],{"className":374,"code":893,"language":376,"meta":152,"style":152},"import PostalMime from 'postal-mime'\n\nexport default {\n async email(message): Promise\u003Cvoid> {\n const parsed = await PostalMime.parse(message.raw)\n\n console.log({\n subject: parsed.subject,\n textLength: parsed.text?.length ?? 0,\n attachmentCount: parsed.attachments.length,\n })\n },\n} satisfies ExportedHandler\n",[20,895,896,910,914,922,944,965,969,979,984,999,1008,1013,1017],{"__ignoreMap":152},[380,897,898,901,904,907],{"class":382,"line":383},[380,899,900],{"class":386},"import",[380,902,903],{"class":394}," PostalMime ",[380,905,906],{"class":386},"from",[380,908,909],{"class":513}," 'postal-mime'\n",[380,911,912],{"class":382,"line":398},[380,913,422],{"emptyLinePlaceholder":421},[380,915,916,918,920],{"class":382,"line":412},[380,917,428],{"class":386},[380,919,431],{"class":386},[380,921,395],{"class":394},[380,923,924,926,928,930,932,934,936,938,940,942],{"class":382,"line":418},[380,925,439],{"class":386},[380,927,442],{"class":390},[380,929,445],{"class":394},[380,931,448],{"class":401},[380,933,457],{"class":394},[380,935,405],{"class":386},[380,937,462],{"class":390},[380,939,465],{"class":394},[380,941,468],{"class":408},[380,943,471],{"class":394},[380,945,946,948,951,953,956,959,962],{"class":382,"line":425},[380,947,477],{"class":386},[380,949,950],{"class":408}," parsed",[380,952,483],{"class":386},[380,954,955],{"class":386}," await",[380,957,958],{"class":394}," PostalMime.",[380,960,961],{"class":390},"parse",[380,963,964],{"class":394},"(message.raw)\n",[380,966,967],{"class":382,"line":436},[380,968,422],{"emptyLinePlaceholder":421},[380,970,971,974,976],{"class":382,"line":474},[380,972,973],{"class":394}," console.",[380,975,615],{"class":390},[380,977,978],{"class":394},"({\n",[380,980,981],{"class":382,"line":495},[380,982,983],{"class":394}," subject: parsed.subject,\n",[380,985,986,989,991,994,997],{"class":382,"line":526},[380,987,988],{"class":394}," textLength: parsed.text?.",[380,990,663],{"class":408},[380,992,993],{"class":386}," ??",[380,995,996],{"class":408}," 0",[380,998,666],{"class":394},[380,1000,1001,1004,1006],{"class":382,"line":531},[380,1002,1003],{"class":394}," attachmentCount: parsed.attachments.",[380,1005,663],{"class":408},[380,1007,666],{"class":394},[380,1009,1010],{"class":382,"line":559},[380,1011,1012],{"class":394}," })\n",[380,1014,1015],{"class":382,"line":576},[380,1016,739],{"class":394},[380,1018,1019,1021,1023],{"class":382,"line":582},[380,1020,745],{"class":394},[380,1022,748],{"class":386},[380,1024,1025],{"class":390}," ExportedHandler\n",[16,1027,1028],{},"解析後の HTML、ファイル名、Content-Type、添付はすべて外部入力です。安全な方法は次のとおりです。",[40,1030,1031,1034,1037,1040,1043],{},[43,1032,1033],{},"管理画面へ受信 HTML を直接挿入しない。",[43,1035,1036],{},"本文、添付数、展開後サイズを制限する。",[43,1038,1039],{},"R2 へ保存する前に新しい object key を生成し、元のファイル名を path に使わない。",[43,1041,1042],{},"メール本文から SQL、Shell、template、AI ツールパラメータを直接組み立てない。",[43,1044,1045],{},"virus scan、OCR、モデル呼び出しを受信イベントの同期 CPU 時間へ詰め込まず、重い処理は Queue へ渡す。",[185,1047,1049],{"id":1048},"転送返信拒否silent-drop-の違い","転送、返信、拒否、silent drop の違い",[40,1051,1052,1058,1064,1070],{},[43,1053,1054,1057],{},[31,1055,1056],{},"転送","：人のメールボックスで処理を続ける用途。宛先は事前に検証が必要。",[43,1059,1060,1063],{},[31,1061,1062],{},"返信","：自動確認やメール bot に適するが、追加制約がある。",[43,1065,1066,1069],{},[31,1067,1068],{},"拒否","：SMTP 段階で送信元へ受け付けなかったことを伝える。",[43,1071,1072,1075],{},[31,1073,1074],{},"drop","：ルール一致後に処理を止め、送信元へ業務レベルの応答を返さない。",[16,1077,1078],{},"自動返信を任意の送信 interface として使うことはできません。現在の公式要件は次のとおりです。",[40,1080,1081,1084,1087,1090,1093],{},[43,1082,1083],{},"受信メールに有効な DMARC 結果がある。",[43,1085,1086],{},"一つの受信イベントにつき返信は一度だけ。",[43,1088,1089],{},"返信先は元の送信者である。",[43,1091,1092],{},"返信の送信ドメインは受信したドメインと同じである。",[43,1094,1095,1096,1099],{},"メールループ防止のため、",[20,1097,1098],{},"References"," が 100 項目を超えると返信を拒否する。",[16,1101,1102],{},"この制約はむしろ有益です。「このメールへ返信する」と「任意のアドレスへ新規メールを送る」が異なる権限になります。",[78,1104,1106],{"id":1105},"メール送信workers-binding-を優先する","メール送信：Workers binding を優先する",[16,1108,1109],{},"アプリケーションが Cloudflare Workers 上で動いているなら、Workers binding が最も自然です。業務コードに Cloudflare API Token を保存する必要がありません。",[16,1111,1112,1113,1116],{},"まず ",[20,1114,1115],{},"wrangler.jsonc"," で binding を宣言します。",[146,1118,1122],{"className":1119,"code":1120,"language":1121,"meta":152,"style":152},"language-jsonc shiki shiki-themes github-dark github-dark","{\n \"send_email\": [\n {\n \"name\": \"EMAIL\",\n \"allowed_sender_addresses\": [\n \"noreply@example.com\"\n ]\n }\n ],\n \"vars\": {\n \"EMAIL_FROM\": \"noreply@example.com\"\n }\n}\n","jsonc",[20,1123,1124,1129,1134,1139,1144,1149,1154,1159,1163,1168,1173,1178,1183],{"__ignoreMap":152},[380,1125,1126],{"class":382,"line":383},[380,1127,1128],{},"{\n",[380,1130,1131],{"class":382,"line":398},[380,1132,1133],{}," \"send_email\": [\n",[380,1135,1136],{"class":382,"line":412},[380,1137,1138],{}," {\n",[380,1140,1141],{"class":382,"line":418},[380,1142,1143],{}," \"name\": \"EMAIL\",\n",[380,1145,1146],{"class":382,"line":425},[380,1147,1148],{}," \"allowed_sender_addresses\": [\n",[380,1150,1151],{"class":382,"line":436},[380,1152,1153],{}," \"noreply@example.com\"\n",[380,1155,1156],{"class":382,"line":474},[380,1157,1158],{}," ]\n",[380,1160,1161],{"class":382,"line":495},[380,1162,585],{},[380,1164,1165],{"class":382,"line":526},[380,1166,1167],{}," ],\n",[380,1169,1170],{"class":382,"line":531},[380,1171,1172],{}," \"vars\": {\n",[380,1174,1175],{"class":382,"line":559},[380,1176,1177],{}," \"EMAIL_FROM\": \"noreply@example.com\"\n",[380,1179,1180],{"class":382,"line":576},[380,1181,1182],{}," }\n",[380,1184,1185],{"class":382,"line":582},[380,1186,415],{},[16,1188,1189,1192],{},[20,1190,1191],{},"allowed_sender_addresses"," は説明用の設定ではなく、実行時の権限境界です。endpoint が誤用されても、この binding は別の送信者アドレスになりすませません。",[16,1194,1195],{},"次の設定で宛先も制限できます。",[40,1197,1198,1204,1210],{},[43,1199,1200,1203],{},[20,1201,1202],{},"destination_address","：宛先を一つに固定する。",[43,1205,1206,1209],{},[20,1207,1208],{},"allowed_destination_addresses","：宛先を許可リストに限定する。",[43,1211,1212,1214],{},[20,1213,1191],{},"：利用できる送信元アドレスを制限する。",[16,1216,1217,1218,1220],{},"システムアラート用 Worker は ",[20,1219,1202],{}," の固定に適しています。ユーザー認証サービスでは通常、送信者を制限し、アプリ側で宛先と頻度を検証します。",[185,1222,1224],{"id":1223},"worker-内から送信する","Worker 内から送信する",[146,1226,1228],{"className":374,"code":1227,"language":376,"meta":152,"style":152},"interface Env {\n EMAIL: SendEmail\n}\n\nexport default {\n async fetch(_request, env): Promise\u003CResponse> {\n const result = await env.EMAIL.send({\n from: {\n email: 'noreply@example.com',\n name: 'Example App',\n },\n to: 'reader@example.net',\n subject: 'メールアドレスを確認してください',\n text: '認証コードは 482913 です。5 分間有効です。',\n html: '\u003Cp>認証コードは \u003Cstrong>482913\u003C\u002Fstrong> です。5 分間有効です。\u003C\u002Fp>',\n })\n\n return Response.json({\n messageId: result.messageId,\n })\n },\n} satisfies ExportedHandler\u003CEnv>\n",[20,1229,1230,1238,1248,1252,1256,1264,1293,1318,1323,1333,1343,1348,1358,1368,1378,1388,1392,1396,1409,1414,1418,1422],{"__ignoreMap":152},[380,1231,1232,1234,1236],{"class":382,"line":383},[380,1233,387],{"class":386},[380,1235,391],{"class":390},[380,1237,395],{"class":394},[380,1239,1240,1243,1245],{"class":382,"line":398},[380,1241,1242],{"class":401}," EMAIL",[380,1244,405],{"class":386},[380,1246,1247],{"class":390}," SendEmail\n",[380,1249,1250],{"class":382,"line":412},[380,1251,415],{"class":394},[380,1253,1254],{"class":382,"line":418},[380,1255,422],{"emptyLinePlaceholder":421},[380,1257,1258,1260,1262],{"class":382,"line":425},[380,1259,428],{"class":386},[380,1261,431],{"class":386},[380,1263,395],{"class":394},[380,1265,1266,1268,1271,1273,1276,1278,1280,1282,1284,1286,1288,1291],{"class":382,"line":436},[380,1267,439],{"class":386},[380,1269,1270],{"class":390}," fetch",[380,1272,445],{"class":394},[380,1274,1275],{"class":401},"_request",[380,1277,451],{"class":394},[380,1279,454],{"class":401},[380,1281,457],{"class":394},[380,1283,405],{"class":386},[380,1285,462],{"class":390},[380,1287,465],{"class":394},[380,1289,1290],{"class":390},"Response",[380,1292,471],{"class":394},[380,1294,1295,1297,1300,1302,1304,1307,1310,1313,1316],{"class":382,"line":474},[380,1296,477],{"class":386},[380,1298,1299],{"class":408}," result",[380,1301,483],{"class":386},[380,1303,955],{"class":386},[380,1305,1306],{"class":394}," env.",[380,1308,1309],{"class":408},"EMAIL",[380,1311,1312],{"class":394},".",[380,1314,1315],{"class":390},"send",[380,1317,978],{"class":394},[380,1319,1320],{"class":382,"line":495},[380,1321,1322],{"class":394}," from: {\n",[380,1324,1325,1328,1331],{"class":382,"line":526},[380,1326,1327],{"class":394}," email: ",[380,1329,1330],{"class":513},"'noreply@example.com'",[380,1332,666],{"class":394},[380,1334,1335,1338,1341],{"class":382,"line":531},[380,1336,1337],{"class":394}," name: ",[380,1339,1340],{"class":513},"'Example App'",[380,1342,666],{"class":394},[380,1344,1345],{"class":382,"line":559},[380,1346,1347],{"class":394}," },\n",[380,1349,1350,1353,1356],{"class":382,"line":576},[380,1351,1352],{"class":394}," to: ",[380,1354,1355],{"class":513},"'reader@example.net'",[380,1357,666],{"class":394},[380,1359,1360,1363,1366],{"class":382,"line":582},[380,1361,1362],{"class":394}," subject: ",[380,1364,1365],{"class":513},"'メールアドレスを確認してください'",[380,1367,666],{"class":394},[380,1369,1370,1373,1376],{"class":382,"line":588},[380,1371,1372],{"class":394}," text: ",[380,1374,1375],{"class":513},"'認証コードは 482913 です。5 分間有効です。'",[380,1377,666],{"class":394},[380,1379,1380,1383,1386],{"class":382,"line":593},[380,1381,1382],{"class":394}," html: ",[380,1384,1385],{"class":513},"'\u003Cp>認証コードは \u003Cstrong>482913\u003C\u002Fstrong> です。5 分間有効です。\u003C\u002Fp>'",[380,1387,666],{"class":394},[380,1389,1390],{"class":382,"line":609},[380,1391,1012],{"class":394},[380,1393,1394],{"class":382,"line":626},[380,1395,422],{"emptyLinePlaceholder":421},[380,1397,1398,1401,1404,1407],{"class":382,"line":657},[380,1399,1400],{"class":386}," return",[380,1402,1403],{"class":394}," Response.",[380,1405,1406],{"class":390},"json",[380,1408,978],{"class":394},[380,1410,1411],{"class":382,"line":669},[380,1412,1413],{"class":394}," messageId: result.messageId,\n",[380,1415,1416],{"class":382,"line":675},[380,1417,1012],{"class":394},[380,1419,1420],{"class":382,"line":681},[380,1421,739],{"class":394},[380,1423,1424,1426,1428,1430,1432,1434],{"class":382,"line":686},[380,1425,745],{"class":394},[380,1427,748],{"class":386},[380,1429,751],{"class":390},[380,1431,465],{"class":394},[380,1433,756],{"class":390},[380,1435,759],{"class":394},[16,1437,1438,1439,1441],{},"Workers binding が成功すると ",[20,1440,140],{}," を返します。これは Cloudflare が送信リクエストを受理したことを意味し、ユーザーの受信トレイにすでに表示されたことを保証しません。最終配信、遅延、bounce、suppression は Email Service の log と metric で確認します。",[185,1443,1445],{"id":1444},"nuxt-のサーバー-api-から送信する","Nuxt のサーバー API から送信する",[16,1447,1448],{},"Nuxt を Workers へデプロイすると、サーバールートから同じ binding を読めます。",[146,1450,1452],{"className":374,"code":1451,"language":376,"meta":152,"style":152},"import { z } from 'zod'\n\nconst schema = z.object({\n email: z.string().trim().email().max(254),\n})\n\nexport default defineEventHandler(async (event) => {\n const { email } = schema.parse(await readBody(event))\n const env = event.context.cloudflare.env as {\n EMAIL: SendEmail\n EMAIL_FROM: string\n }\n\n \u002F\u002F 実際のプロジェクトでは same-origin を確認し、\n \u002F\u002F IP とメールアドレスを rate-limit し、D1 で\n \u002F\u002F 一度の送信資格を atomically に取得します。\n const result = await env.EMAIL.send({\n from: {\n email: env.EMAIL_FROM,\n name: 'Example App',\n },\n to: email,\n subject: 'メールアドレスの確認',\n text: '認証コードは 5 分後に失効します。',\n html: '\u003Cp>認証コードは \u003Cstrong>5 分後\u003C\u002Fstrong>に失効します。\u003C\u002Fp>',\n })\n\n return {\n ok: true,\n messageId: result.messageId,\n }\n})\n",[20,1453,1454,1466,1470,1488,1519,1524,1528,1555,1587,1604,1613,1622,1626,1630,1636,1641,1646,1666,1671,1681,1690,1695,1700,1710,1720,1730,1735,1739,1746,1757,1763,1768],{"__ignoreMap":152},[380,1455,1456,1458,1461,1463],{"class":382,"line":383},[380,1457,900],{"class":386},[380,1459,1460],{"class":394}," { z } ",[380,1462,906],{"class":386},[380,1464,1465],{"class":513}," 'zod'\n",[380,1467,1468],{"class":382,"line":398},[380,1469,422],{"emptyLinePlaceholder":421},[380,1471,1472,1475,1478,1480,1483,1486],{"class":382,"line":412},[380,1473,1474],{"class":386},"const",[380,1476,1477],{"class":408}," schema",[380,1479,483],{"class":386},[380,1481,1482],{"class":394}," z.",[380,1484,1485],{"class":390},"object",[380,1487,978],{"class":394},[380,1489,1490,1493,1496,1499,1502,1504,1507,1509,1512,1514,1517],{"class":382,"line":418},[380,1491,1492],{"class":394}," email: z.",[380,1494,1495],{"class":390},"string",[380,1497,1498],{"class":394},"().",[380,1500,1501],{"class":390},"trim",[380,1503,1498],{"class":394},[380,1505,1506],{"class":390},"email",[380,1508,1498],{"class":394},[380,1510,1511],{"class":390},"max",[380,1513,445],{"class":394},[380,1515,1516],{"class":408},"254",[380,1518,654],{"class":394},[380,1520,1521],{"class":382,"line":425},[380,1522,1523],{"class":394},"})\n",[380,1525,1526],{"class":382,"line":436},[380,1527,422],{"emptyLinePlaceholder":421},[380,1529,1530,1532,1534,1537,1539,1542,1545,1548,1550,1553],{"class":382,"line":474},[380,1531,428],{"class":386},[380,1533,431],{"class":386},[380,1535,1536],{"class":390}," defineEventHandler",[380,1538,445],{"class":394},[380,1540,1541],{"class":386},"async",[380,1543,1544],{"class":394}," (",[380,1546,1547],{"class":401},"event",[380,1549,517],{"class":394},[380,1551,1552],{"class":386},"=>",[380,1554,395],{"class":394},[380,1556,1557,1560,1563,1565,1568,1571,1574,1576,1578,1581,1584],{"class":382,"line":495},[380,1558,1559],{"class":386}," const",[380,1561,1562],{"class":394}," { ",[380,1564,1506],{"class":408},[380,1566,1567],{"class":394}," } ",[380,1569,1570],{"class":386},"=",[380,1572,1573],{"class":394}," schema.",[380,1575,961],{"class":390},[380,1577,445],{"class":394},[380,1579,1580],{"class":386},"await",[380,1582,1583],{"class":390}," readBody",[380,1585,1586],{"class":394},"(event))\n",[380,1588,1589,1591,1594,1596,1599,1602],{"class":382,"line":526},[380,1590,1559],{"class":386},[380,1592,1593],{"class":408}," env",[380,1595,483],{"class":386},[380,1597,1598],{"class":394}," event.context.cloudflare.env ",[380,1600,1601],{"class":386},"as",[380,1603,395],{"class":394},[380,1605,1606,1609,1611],{"class":382,"line":531},[380,1607,1608],{"class":401}," EMAIL",[380,1610,405],{"class":386},[380,1612,1247],{"class":390},[380,1614,1615,1618,1620],{"class":382,"line":559},[380,1616,1617],{"class":401}," EMAIL_FROM",[380,1619,405],{"class":386},[380,1621,409],{"class":408},[380,1623,1624],{"class":382,"line":576},[380,1625,1182],{"class":394},[380,1627,1628],{"class":382,"line":582},[380,1629,422],{"emptyLinePlaceholder":421},[380,1631,1632],{"class":382,"line":588},[380,1633,1635],{"class":1634},"sJ8bj"," \u002F\u002F 実際のプロジェクトでは same-origin を確認し、\n",[380,1637,1638],{"class":382,"line":593},[380,1639,1640],{"class":1634}," \u002F\u002F IP とメールアドレスを rate-limit し、D1 で\n",[380,1642,1643],{"class":382,"line":609},[380,1644,1645],{"class":1634}," \u002F\u002F 一度の送信資格を atomically に取得します。\n",[380,1647,1648,1650,1652,1654,1656,1658,1660,1662,1664],{"class":382,"line":626},[380,1649,1559],{"class":386},[380,1651,1299],{"class":408},[380,1653,483],{"class":386},[380,1655,955],{"class":386},[380,1657,1306],{"class":394},[380,1659,1309],{"class":408},[380,1661,1312],{"class":394},[380,1663,1315],{"class":390},[380,1665,978],{"class":394},[380,1667,1668],{"class":382,"line":657},[380,1669,1670],{"class":394}," from: {\n",[380,1672,1673,1676,1679],{"class":382,"line":669},[380,1674,1675],{"class":394}," email: env.",[380,1677,1678],{"class":408},"EMAIL_FROM",[380,1680,666],{"class":394},[380,1682,1683,1686,1688],{"class":382,"line":675},[380,1684,1685],{"class":394}," name: ",[380,1687,1340],{"class":513},[380,1689,666],{"class":394},[380,1691,1692],{"class":382,"line":681},[380,1693,1694],{"class":394}," },\n",[380,1696,1697],{"class":382,"line":686},[380,1698,1699],{"class":394}," to: email,\n",[380,1701,1702,1705,1708],{"class":382,"line":706},[380,1703,1704],{"class":394}," subject: ",[380,1706,1707],{"class":513},"'メールアドレスの確認'",[380,1709,666],{"class":394},[380,1711,1712,1715,1718],{"class":382,"line":711},[380,1713,1714],{"class":394}," text: ",[380,1716,1717],{"class":513},"'認証コードは 5 分後に失効します。'",[380,1719,666],{"class":394},[380,1721,1722,1725,1728],{"class":382,"line":716},[380,1723,1724],{"class":394}," html: ",[380,1726,1727],{"class":513},"'\u003Cp>認証コードは \u003Cstrong>5 分後\u003C\u002Fstrong>に失効します。\u003C\u002Fp>'",[380,1729,666],{"class":394},[380,1731,1732],{"class":382,"line":721},[380,1733,1734],{"class":394}," })\n",[380,1736,1737],{"class":382,"line":736},[380,1738,422],{"emptyLinePlaceholder":421},[380,1740,1741,1744],{"class":382,"line":742},[380,1742,1743],{"class":386}," return",[380,1745,395],{"class":394},[380,1747,1749,1752,1755],{"class":382,"line":1748},29,[380,1750,1751],{"class":394}," ok: ",[380,1753,1754],{"class":408},"true",[380,1756,666],{"class":394},[380,1758,1760],{"class":382,"line":1759},30,[380,1761,1762],{"class":394}," messageId: result.messageId,\n",[380,1764,1766],{"class":382,"line":1765},31,[380,1767,1182],{"class":394},[380,1769,1771],{"class":382,"line":1770},32,[380,1772,1523],{"class":394},[16,1774,1775],{},"この例を、匿名で無制限に呼べ、件名と本文を自由に指定できる公開 API にしないでください。自分のドメインが spam relay になります。",[16,1777,1778],{},[167,1779],{"alt":1780,"src":1781},"Worker が生成したトランザクションメールが複数の認証レイヤーを通り、異なる受信システムへ配信される","\u002Fmedia\u002Fposts\u002Fcloudflare-email-service-send-receive-guide\u002Foutbound-delivery-v1.webp",[16,1783,1784],{},[174,1785,1786],{},"SPF、DKIM、DMARC は「誰が送信できるか、内容が変更されていないか、失敗時にどう処理するか」を扱います。すべてのメールがメイン受信トレイへ入ることは保証しません。",[78,1788,1790],{"id":1789},"rest-api-と認証-smtp-が適する場面","REST API と認証 SMTP が適する場面",[16,1792,1793],{},"Cloudflare は現在、三つの送信入口を提供しています。",[86,1795,1796,1809],{},[89,1797,1798],{},[92,1799,1800,1803,1806],{},[95,1801,1802],{},"方法",[95,1804,1805],{},"最適な用途",[95,1807,1808],{},"認証情報と境界",[108,1810,1811,1822,1833],{},[92,1812,1813,1816,1819],{},[113,1814,1815],{},"Workers binding",[113,1817,1818],{},"すでに Workers 上で動く Nuxt、Hono、Agent",[113,1820,1821],{},"コードに API Token を保存せず、binding で送信者と宛先を制限できる",[92,1823,1824,1827,1830],{},[113,1825,1826],{},"REST API",[113,1828,1829],{},"別の cloud、CI、backend platform で動くプログラム",[113,1831,1832],{},"最小権限 API Token を使い、response は受信者ごとに delivered、queued、permanent bounce を区別する",[92,1834,1835,1838,1841],{},[113,1836,1837],{},"認証 SMTP",[113,1839,1840],{},"Nodemailer、PHPMailer、JavaMail などの SMTP client を使う既存システム",[113,1842,1843,1846],{},[20,1844,1845],{},"smtp.mx.cloudflare.net:465","、implicit TLS のみ。password は Email Sending 権限を持つ API Token",[16,1848,1849],{},"認証 SMTP は 2026 年 6 月に追加された beta 機能です。現在は 465 port の SMTPS だけをサポートし、587 port の STARTTLS や匿名利用できる 25 port relay はありません。",[16,1851,1852],{},"SMTP Token が漏れると、所有者はアカウントへ接続された送信ドメインを使ってメールを送れます。そのため、",[40,1854,1855,1858,1865,1868,1871],{},[43,1856,1857],{},"account-owned token を優先する。",[43,1859,1860,1861,1864],{},"権限は ",[20,1862,1863],{},"Email Sending: Edit"," だけにする。",[43,1866,1867],{},"repository、image、frontend environment variable に書かない。",[43,1869,1870],{},"システムごとに別 Token を使い、個別に revoke できるようにする。",[43,1872,1873],{},"Worker binding を使えるなら、「SMTP に慣れている」という理由だけで長期 credential を追加しない。",[78,1875,1876],{"id":1876},"必ず把握すべき制限",[16,1878,1879],{},"2026 年 7 月時点で、アプリ側のコードで事前に防御すべき主な platform limit は次のとおりです。",[86,1881,1882,1896],{},[89,1883,1884],{},[92,1885,1886,1889,1893],{},[95,1887,1888],{},"制限",[95,1890,1892],{"align":1891},"right","現在値",[95,1894,1895],{},"実装への影響",[108,1897,1898,1909,1919,1930,1941,1952,1962,1973,1984],{},[92,1899,1900,1903,1906],{},[113,1901,1902],{},"ドメインごとの Email Routing ルール",[113,1904,1905],{"align":1891},"200",[113,1907,1908],{},"multi-tenant システムでユーザーごとの静的ルールを作らない",[92,1910,1911,1914,1916],{},[113,1912,1913],{},"アカウントごとの検証済み宛先",[113,1915,1905],{"align":1891},[113,1917,1918],{},"多数のメールボックスへ転送する前に account-level の宛先を設計",[92,1920,1921,1924,1927],{},[113,1922,1923],{},"受信メールサイズ",[113,1925,1926],{"align":1891},"25 MiB",[113,1928,1929],{},"それより大きいメールは SMTP 段階で拒否",[92,1931,1932,1935,1938],{},[113,1933,1934],{},"送信メール 1 通あたりの受信者",[113,1936,1937],{"align":1891},"50",[113,1939,1940],{},"To、Cc、Bcc の合計",[92,1942,1943,1946,1949],{},[113,1944,1945],{},"通常の送信メール総サイズ",[113,1947,1948],{"align":1891},"5 MiB",[113,1950,1951],{},"添付と MIME encoding overhead を含む",[92,1953,1954,1957,1959],{},[113,1955,1956],{},"検証済み宛先への総サイズ",[113,1958,1926],{"align":1891},[113,1960,1961],{},"検証済み宛先アドレスにのみ適用",[92,1963,1964,1967,1970],{},[113,1965,1966],{},"カスタム header の総サイズ",[113,1968,1969],{"align":1891},"16 KB",[113,1971,1972],{},"業務データを Header へ詰め込まない",[92,1974,1975,1978,1981],{},[113,1976,1977],{},"1 Zone の送信\u002Frouting ドメイン数",[113,1979,1980],{"align":1891},"30",[113,1982,1983],{},"root domain と subdomain の両方を数える",[92,1985,1986,1992,1995],{},[113,1987,1988,1989,1991],{},"返信の ",[20,1990,1098],{}," 項目数",[113,1993,1994],{"align":1891},"100",[113,1996,1997,1998,2001],{},"超えると ",[20,1999,2000],{},"reply()"," が失敗",[16,2003,2004],{},"添付は Base64 と MIME で包装されます。3 MiB の生ファイルでも最終メールが 3 MiB のままとは限りません。encoding、本文、header の余裕を残してください。",[16,2006,2007],{},"platform は account reputation、配信成績、利用履歴に応じて一日の送信枠を調整することもあります。「月間枠が残っている」ことを、ある一秒間に無制限の並行送信ができるという意味にしないでください。",[78,2009,2010],{"id":2010},"認証コードとパスワードリセットの設計",[16,2012,2013],{},"このブログの登録・パスワードリセットメールは、次の経路を使います。",[146,2015,2018],{"className":2016,"code":2017,"language":151,"meta":152},[149],"ユーザーがメールアドレスを送信\n → same-origin check\n → IP とメールアドレスの rate limit\n → 6 桁コードを生成\n → D1 は salted hash、用途、有効期限、試行回数だけを保存\n → EMAIL binding で送信\n → 認証成功時に atomically に使用済みへ更新\n",[20,2019,2017],{"__ignoreMap":152},[16,2021,2022],{},"重要な規則は次のとおりです。",[40,2024,2025,2028,2031,2034,2037,2040,2043],{},[43,2026,2027],{},"同じメールアドレスには 5 分に 1 通だけ送る。",[43,2029,2030],{},"認証コードは 5 分後に失効する。",[43,2032,2033],{},"コードは一度だけ使用できる。",[43,2035,2036],{},"D1 に plaintext のコードを保存しない。",[43,2038,2039],{},"連続して間違え、しきい値へ達したら認証を止める。",[43,2041,2042],{},"送信失敗時は取得した枠を解放し、届かなかったコードでユーザーを lock しない。",[43,2044,2045],{},"パスワードリセット時は password hash だけを置き換えず、既存のログインセッションを revoke する。",[16,2047,2048,2049,2052,2053,2056],{},"rate limit はデータベース内で送信資格を ",[31,2050,2051],{},"atomically に取得","する必要があります。前回送信時刻を検索してから row を insert する実装では、二つの並行リクエストが両方とも確認を通過します。unique key と ",[20,2054,2055],{},"INSERT ... ON CONFLICT ... WHERE"," を組み合わせ、どのリクエストが送信枠を得るかをデータベースに決めさせます。",[16,2058,2059],{},"メール API の response は「このアドレスが登録済みか」を公開してはいけません。攻撃者による user enumeration を可能にします。",[78,2061,2062],{"id":2062},"より完全な本番アーキテクチャ",[16,2064,2065],{},"メール処理が Demo から本番へ進んだら、責務を分けます。",[146,2067,2070],{"className":2068,"code":2069,"language":151,"meta":152},[149],"HTTP リクエスト \u002F 業務イベント\n → 認証、origin check、入力検証、rate limit、idempotency\n → Queue\n → メール template の描画\n → EMAIL binding\n → messageId \u002F error code を D1 へ保存\n → Email Service logs と alert\n",[20,2071,2069],{"__ignoreMap":152},[16,2073,2074],{},"受信経路は次のようにできます。",[146,2076,2079],{"className":2077,"code":2078,"language":151,"meta":152},[149],"support@yourdomain.com\n → Email Routing\n → Email Worker\n → 認証とサイズ確認\n → MIME 解析\n → 添付を R2 へ保存 \u002F D1 にチケットを作成\n → 重い処理を Queue へ\n → 人のメールボックスへ転送、または制約付き返信\n",[20,2080,2078],{"__ignoreMap":152},[185,2082,2084],{"id":2083},"d1-に記録するもの","D1 に記録するもの",[16,2086,2087],{},"記録に適する項目は次のとおりです。",[40,2089,2090,2093,2096,2101,2104,2107,2110],{},[43,2091,2092],{},"業務イベント ID と idempotency key。",[43,2094,2095],{},"template ID と template version。",[43,2097,2098,2100],{},[20,2099,140],{},"。",[43,2102,2103],{},"受信者数。必ずしも完全なアドレスを保存する必要はない。",[43,2105,2106],{},"accepted \u002F failed などアプリ側の状態。",[43,2108,2109],{},"Cloudflare error code。",[43,2111,2112],{},"作成、送信、最終更新時刻。",[16,2114,2115],{},"既定では記録しないもの：",[40,2117,2118,2121,2124,2127,2130,2133],{},[43,2119,2120],{},"plaintext の認証コード。",[43,2122,2123],{},"パスワードリセット Token。",[43,2125,2126],{},"完全なメール本文。",[43,2128,2129],{},"添付内容。",[43,2131,2132],{},"SMTP\u002FAPI Token。",[43,2134,2135],{},"デバッグのため無期限に保存する生の受信メール。",[16,2137,2138],{},"log 自体が新たな個人データ源になる可能性があります。",[185,2140,2142],{"id":2141},"email-routing-のdroppedを送信失敗と判断しない","Email Routing の「Dropped」を送信失敗と判断しない",[16,2144,2145,2146,2149,2150,2153],{},"公式ドキュメントは、",[20,2147,2148],{},"send_email"," binding から送ったメールが実際には正常に配信されていても、Email Routing の集計ページで ",[31,2151,2152],{},"dropped"," と表示される場合があると明記しています。",[16,2155,2156,2157,2159],{},"送信結果は Email Sending の Metrics と Logs で確認し、",[20,2158,140],{}," を使ってアプリログと関連付けます。Routing ページが示すのは受信 routing の処理であり、完全な送信配信 state machine ではありません。",[78,2161,2162],{"id":2162},"ローカルでのテスト",[16,2164,2165],{},"Wrangler は Email Worker のローカルイベントをサポートします。次を実行します。",[146,2167,2171],{"className":2168,"code":2169,"language":2170,"meta":152,"style":152},"language-bash shiki shiki-themes github-dark github-dark","pnpm exec wrangler dev\n","bash",[20,2172,2173],{"__ignoreMap":152},[380,2174,2175,2178,2181,2184],{"class":382,"line":383},[380,2176,2177],{"class":390},"pnpm",[380,2179,2180],{"class":513}," exec",[380,2182,2183],{"class":513}," wrangler",[380,2185,2186],{"class":513}," dev\n",[16,2188,2189],{},"ローカル handler へ生メールを送ります。",[146,2191,2193],{"className":2168,"code":2192,"language":2170,"meta":152,"style":152},"curl -X POST \\\n 'http:\u002F\u002Flocalhost:8787\u002Fcdn-cgi\u002Fhandler\u002Femail?from=sender@example.net&to=support@example.com' \\\n -H 'Content-Type: text\u002Fplain' \\\n --data-binary $'From: sender@example.net\\nTo: support@example.com\\nSubject: Local test\\n\\nHello from local development.'\n",[20,2194,2195,2209,2216,2226],{"__ignoreMap":152},[380,2196,2197,2200,2203,2206],{"class":382,"line":383},[380,2198,2199],{"class":390},"curl",[380,2201,2202],{"class":408}," -X",[380,2204,2205],{"class":513}," POST",[380,2207,2208],{"class":408}," \\\n",[380,2210,2211,2214],{"class":382,"line":398},[380,2212,2213],{"class":513}," 'http:\u002F\u002Flocalhost:8787\u002Fcdn-cgi\u002Fhandler\u002Femail?from=sender@example.net&to=support@example.com'",[380,2215,2208],{"class":408},[380,2217,2218,2221,2224],{"class":382,"line":412},[380,2219,2220],{"class":408}," -H",[380,2222,2223],{"class":513}," 'Content-Type: text\u002Fplain'",[380,2225,2208],{"class":408},[380,2227,2228,2231,2234,2237,2240,2242,2245,2248],{"class":382,"line":418},[380,2229,2230],{"class":408}," --data-binary",[380,2232,2233],{"class":513}," $'From: sender@example.net",[380,2235,2236],{"class":408},"\\n",[380,2238,2239],{"class":513},"To: support@example.com",[380,2241,2236],{"class":408},[380,2243,2244],{"class":513},"Subject: Local test",[380,2246,2247],{"class":408},"\\n\\n",[380,2249,2250],{"class":513},"Hello from local development.'\n",[16,2252,2253],{},"ローカルの送信 binding は text と HTML を確認できるファイルとして保存するため、template 検証に適しています。binary 添付のローカル simulation には個別の制限があるため、添付フローは remote test も追加してください。",[16,2255,2256],{},"少なくとも次をテストします。",[40,2258,2259,2262,2265,2268,2271,2274,2277,2280,2283,2286],{},[43,2260,2261],{},"通常の text と HTML。",[43,2263,2264],{},"非 ASCII の件名と送信者表示名。",[43,2266,2267],{},"重複リクエストと idempotency。",[43,2269,2270],{},"cooldown 完了前の認証コード再送。",[43,2272,2273],{},"大きな本文と添付の境界。",[43,2275,2276],{},"Header newline injection。",[43,2278,2279],{},"未検証の送信ドメイン、または制限された受信者。",[43,2281,2282],{},"bounce、suppression、枠、頻度の error。",[43,2284,2285],{},"一致しない受信アドレス、Catch-all、拒否経路。",[43,2287,2288],{},"HTML メール内の script、remote resource、危険な添付ファイル名。",[78,2290,2291],{"id":2291},"適する用途と適さない用途",[16,2293,2294],{},"適する用途：",[40,2296,2297,2300,2303,2306,2309,2312],{},[43,2298,2299],{},"登録認証、magic link、パスワードリセット。",[43,2301,2302],{},"注文、請求、デプロイ、監視通知。",[43,2304,2305],{},"個人ドメインのメール転送。",[43,2307,2308],{},"contact form とサポートチケット。",[43,2310,2311],{},"メールを trigger にする Agent や自動化。",[43,2313,2314],{},"SMTP サーバーの保守を減らしたい Cloudflare アプリケーション。",[16,2316,2317],{},"直接使うべきでない用途：",[40,2319,2320,2323,2326,2329,2332],{},[43,2321,2322],{},"同意のない marketing 一括送信。",[43,2324,2325],{},"unsubscribe、complaint、suppression 管理のない Newsletter。",[43,2327,2328],{},"匿名で公開する「代わりにメールを送る」endpoint。",[43,2330,2331],{},"IMAP folder、calendar、contact、複数人の shared mailbox が必要な企業メール。",[43,2333,2334],{},"任意の受信本文を、高権限ツールを持つ Agent へ直接渡すこと。",[16,2336,2337],{},"Cloudflare はメール入口と配信インフラを保守しますが、送信者 reputation、ユーザー同意、コンテンツ安全性、頻度制御、データ最小化はアプリケーション自身の責任です。",[78,2339,2340],{"id":2340},"最終的な判断",[16,2342,2343],{},"Cloudflare Email Service の最も価値ある点は「新しい SMTP provider」になったことではなく、メールを Workers、D1、R2、Queue、Agents と同じランタイム境界へ入れたことです。",[16,2345,2346],{},"受信メールは人のメールボックスへ転送するだけではなく、制約されたイベント入口になります。送信メールも、認証コードのためだけに外部 SDK と別の credential system を導入する必要がなくなります。",[16,2348,2349],{},"プロジェクトがすでに Workers 上にあるなら、次の最小経路から始めます。",[336,2351,2352,2359,2362,2365,2368],{},[43,2353,2354,2355,2358],{},"Email Routing で ",[20,2356,2357],{},"support@"," を受信する。",[43,2360,2361],{},"Worker binding で認証コードとパスワードリセットを送信する。",[43,2363,2364],{},"D1 で cooldown、一度限りの認証、最小限の log を実装する。",[43,2366,2367],{},"sender allowlist で binding 権限を制限する。",[43,2369,2370],{},"API の成功 response だけでなく、Email Sending log で配信を確認する。",[16,2372,2373],{},"外部 platform から本当に送信する必要が出たときに REST API を追加します。既存システムが SMTP client へ深く依存している場合だけ認証 SMTP を使います。",[78,2375,2376],{"id":2376},"参考資料",[40,2378,2379,2388,2395,2402,2409,2416,2423,2430,2436,2442,2449,2456,2463],{},[43,2380,2381],{},[2382,2383,2387],"a",{"href":2384,"rel":2385},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Femail-service\u002F",[2386],"nofollow","Cloudflare Email Service 概要",[43,2389,2390],{},[2382,2391,2394],{"href":2392,"rel":2393},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Femail-service\u002Fget-started\u002Fsend-emails\u002F",[2386],"Email Sending の設定",[43,2396,2397],{},[2382,2398,2401],{"href":2399,"rel":2400},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Femail-service\u002Fget-started\u002Froute-emails\u002F",[2386],"Email Routing の設定",[43,2403,2404],{},[2382,2405,2408],{"href":2406,"rel":2407},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Femail-service\u002Fconfiguration\u002Fdomains\u002F",[2386],"ドメインと DNS 設定",[43,2410,2411],{},[2382,2412,2415],{"href":2413,"rel":2414},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Femail-service\u002Fconfiguration\u002Fsend-bindings\u002F",[2386],"送信 binding の権限設定",[43,2417,2418],{},[2382,2419,2422],{"href":2420,"rel":2421},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Femail-service\u002Fapi\u002Fsend-emails\u002Fworkers-api\u002F",[2386],"Workers 送信 API",[43,2424,2425],{},[2382,2426,2429],{"href":2427,"rel":2428},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Femail-service\u002Fapi\u002Froute-emails\u002Femail-handler\u002F",[2386],"Email Worker 受信 API",[43,2431,2432],{},[2382,2433,1826],{"href":2434,"rel":2435},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Femail-service\u002Fapi\u002Fsend-emails\u002Frest-api\u002F",[2386],[43,2437,2438],{},[2382,2439,1837],{"href":2440,"rel":2441},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Femail-service\u002Fapi\u002Fsend-emails\u002Fsmtp\u002F",[2386],[43,2443,2444],{},[2382,2445,2448],{"href":2446,"rel":2447},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Femail-service\u002Fplatform\u002Flimits\u002F",[2386],"プラットフォーム制限",[43,2450,2451],{},[2382,2452,2455],{"href":2453,"rel":2454},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Femail-service\u002Fplatform\u002Fpricing\u002F",[2386],"料金",[43,2457,2458],{},[2382,2459,2462],{"href":2460,"rel":2461},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Femail-service\u002Fconcepts\u002Femail-authentication\u002F",[2386],"メール認証と配信",[43,2464,2465],{},[2382,2466,2469],{"href":2467,"rel":2468},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Femail-service\u002Flocal-development\u002Frouting\u002F",[2386],"Email Worker のローカルテスト",[2471,2472,2473],"style",{},"html pre.shiki code .sOPea, html code.shiki .sOPea{--shiki-default:#F97583;--shiki-dark:#F97583}html pre.shiki code .sFR8T, html code.shiki .sFR8T{--shiki-default:#B392F0;--shiki-dark:#B392F0}html pre.shiki code .suv1-, html code.shiki .suv1-{--shiki-default:#E1E4E8;--shiki-dark:#E1E4E8}html pre.shiki code .s-3mD, html code.shiki .s-3mD{--shiki-default:#FFAB70;--shiki-dark:#FFAB70}html pre.shiki code .s8ozJ, html code.shiki .s8ozJ{--shiki-default:#79B8FF;--shiki-dark:#79B8FF}html pre.shiki code .s4wv1, html code.shiki .s4wv1{--shiki-default:#9ECBFF;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}",{"title":152,"searchDepth":412,"depth":412,"links":2475},[2476,2477,2481,2486,2492,2496,2497,2498,2499,2503,2504,2505,2506],{"id":80,"depth":398,"text":81},{"id":179,"depth":398,"text":180,"children":2478},[2479,2480],{"id":187,"depth":412,"text":188},{"id":217,"depth":412,"text":218},{"id":244,"depth":398,"text":245,"children":2482},[2483,2484],{"id":251,"depth":412,"text":252},{"id":272,"depth":412,"text":2485},"送信は cf-bounce record を使う",{"id":330,"depth":398,"text":331,"children":2487},[2488,2490,2491],{"id":357,"depth":412,"text":2489},"email() が受信メールの入口",{"id":882,"depth":412,"text":883},{"id":1048,"depth":412,"text":1049},{"id":1105,"depth":398,"text":1106,"children":2493},[2494,2495],{"id":1223,"depth":412,"text":1224},{"id":1444,"depth":412,"text":1445},{"id":1789,"depth":398,"text":1790},{"id":1876,"depth":398,"text":1876},{"id":2010,"depth":398,"text":2010},{"id":2062,"depth":398,"text":2062,"children":2500},[2501,2502],{"id":2083,"depth":412,"text":2084},{"id":2141,"depth":412,"text":2142},{"id":2162,"depth":398,"text":2162},{"id":2291,"depth":398,"text":2291},{"id":2340,"depth":398,"text":2340},{"id":2376,"depth":398,"text":2376},"2026 年 7 月時点の Cloudflare Email Service を使った受信、転送、解析、返信、トランザクションメール送信を、Nuxt、Workers、D1、セキュリティ、レート制限とともに解説します。",false,null,"md",{"src":2512,"alt":2513,"caption":2514,"width":2515,"height":2516},"\u002Fmedia\u002Fposts\u002Fcloudflare-email-service-send-receive-guide\u002Fcover-v1.webp","世界中のエッジネットワークにある Worker ノードがメールを受信、認証、送信する","Cloudflare Email Service は、メールを保守が必要なサーバーからコードで処理できるイベントへ変えます",1600,900,{},"\u002Fblog\u002Fcloudflare-email-service-send-receive-guide","2026-07-28",{"title":10,"description":2507},"blog\u002Fcloudflare-email-service-send-receive-guide",[2523,2524,2525,2526],"Cloudflare","Email","Workers","Serverless",{"src":2528,"poster":2512,"title":2529,"description":2530,"duration":2531,"width":2532,"height":2533},"\u002Fmedia\u002Fvideos\u002Fcloudflare-email-service-explained\u002Fcloudflare-email-service-explained-v1.mp4","Cloudflare Email Service 実践—11 分で分かる設定ガイド","DNS、Email Routing、Email Worker、send_email binding から REST、SMTP、Nuxt、D1、5 分間の認証コード、本番確認までを解説します。",661,1920,1080,"qW1O2KtlO0gzPc1CCQSN2y2VBaCtC21jxaEJwSq98fI",{"id":2536,"title":2537,"accent":2538,"body":2539,"description":4236,"draft":2508,"experience":2509,"extension":2510,"featured":421,"image":4237,"meta":4241,"navigation":421,"path":4242,"publishedAt":4243,"readingTime":657,"seo":4244,"stem":4245,"tags":4246,"updatedAt":2509,"video":2509,"__hash__":4250,"contentLocale":6,"isFallback":2508},"posts_ja\u002Fblog\u002Fvue-3-6-rc-upgrade-guide.md","Vue 3.6 RC アップグレード全解説—3.5 から Vapor Mode と alien-signals へ","mint",{"type":13,"value":2540,"toc":4197},[2541,2548,2562,2565,2574,2578,2717,2720,2725,2729,2732,2767,2770,2776,2780,2787,2790,2903,2906,2912,2917,2920,2923,2936,2943,2946,2949,2966,2969,2972,2988,3005,3008,3012,3015,3018,3026,3029,3033,3036,3161,3164,3192,3220,3223,3227,3230,3280,3283,3287,3294,3355,3358,3361,3367,3373,3376,3380,3383,3397,3405,3452,3459,3462,3475,3478,3482,3485,3621,3628,3634,3637,3724,3727,3761,3765,3778,3781,3785,3788,3791,3794,3798,3801,3805,3808,3811,3814,3818,3821,3836,3842,3859,3862,3894,3897,3901,3904,3924,3927,3931,3934,3957,3960,3964,3967,3970,3990,3993,3997,4000,4004,4007,4011,4014,4018,4021,4024,4107,4109,4112,4120,4123,4130,4133,4136,4139,4189,4194],[16,2542,2543,2544,2547],{},"バージョン番号だけを見れば、Vue 3.6 は普通のマイナーアップデートに見えます。しかしリリースノートを最後まで読むと、印象は違います。",[31,2545,2546],{},"Vue が次の段階に向けてエンジンを交換する更新","に近いのです。",[16,2549,2550,2551,2554,2555,2554,2558,2561],{},"一方では alien-signals を基盤にリアクティビティコアが再構築され、公開されている ",[20,2552,2553],{},"ref","、",[20,2556,2557],{},"computed",[20,2559,2560],{},"watch"," の使い方はほぼ変わりません。もう一方では Vapor Mode が正式に RC へ入り、Vue の SFC を Virtual DOM を経由せず、より直接的な DOM 更新ロジックへコンパイルできるようになります。",[16,2563,2564],{},"最初に、最も重要なバージョン情報を確認します。",[72,2566,2567],{},[16,2568,2569,2570,2573],{},"2026 年 7 月 26 日時点で、Vue 3.6 の最新版は ",[31,2571,2572],{},"3.6.0-rc.2"," です。RC はリリース候補であり、安定版ではありません。この記事は評価、実験、移行準備のためのもので、すべての本番プロジェクトが直ちにアップグレードすべきだという意味ではありません。",[78,2575,2577],{"id":2576},"先に結論36-では何が変わったのか","先に結論：3.6 では何が変わったのか",[86,2579,2580,2596],{},[89,2581,2582],{},[92,2583,2584,2587,2590,2593],{},[95,2585,2586],{},"比較項目",[95,2588,2589],{},"Vue 3.5",[95,2591,2592],{},"Vue 3.6 RC",[95,2594,2595],{},"既存プロジェクトへの実際の影響",[108,2597,2598,2612,2626,2640,2654,2668,2685,2703],{},[92,2599,2600,2603,2606,2609],{},[113,2601,2602],{},"リアクティビティ",[113,2604,2605],{},"3.5 で内部最適化済み",[113,2607,2608],{},"alien-signals を基盤に大幅再構築",[113,2610,2611],{},"通常の Composition API は書き直し不要ですが、複雑な副作用とスケジューリングは回帰テストが必要",[92,2613,2614,2617,2620,2623],{},[113,2615,2616],{},"デフォルト描画",[113,2618,2619],{},"Virtual DOM",[113,2621,2622],{},"引き続き Virtual DOM",[113,2624,2625],{},"依存関係を更新するだけで Vapor へ移行することはない",[92,2627,2628,2631,2634,2637],{},[113,2629,2630],{},"Vapor Mode",[113,2632,2633],{},"3.5 の正式機能としては未提供",[113,2635,2636],{},"機能セットが RC、完全な明示的 opt-in",[113,2638,2639],{},"性能が重要な一領域から実験できる",[92,2641,2642,2645,2648,2651],{},[113,2643,2644],{},"アプリサイズ",[113,2646,2647],{},"VDOM runtime を既定で含む",[113,2649,2650],{},"純粋な Vapor アプリは VDOM runtime を省略可能",[113,2652,2653],{},"純 Vapor または境界が明確な領域でサイズ効果を得やすい",[92,2655,2656,2659,2662,2665],{},[113,2657,2658],{},"API 対応範囲",[113,2660,2661],{},"Vue 3 API の完全なエコシステム",[113,2663,2664],{},"Vapor は Vue API のサブセットをサポート",[113,2666,2667],{},"Options API やインスタンスプロキシ関連機能は直接移行できない",[92,2669,2670,2673,2676,2682],{},[113,2671,2672],{},"VDOM \u002F Vapor 混在",[113,2674,2675],{},"対象外",[113,2677,2678,2681],{},[20,2679,2680],{},"vaporInteropPlugin"," で相互運用",[113,2683,2684],{},"標準的な props、イベント、slots は対応済みですが、複雑なネストはテストが必要",[92,2686,2687,2690,2693,2700],{},[113,2688,2689],{},"イベント委譲",[113,2691,2692],{},"ネイティブなリスナー動作",[113,2694,2695,2696,2699],{},"rc.2 以降は直接 binding が既定、",[20,2697,2698],{},".delegate"," で明示的に委譲",[113,2701,2702],{},"rc.1 の自動委譲という認識を引き継がない",[92,2704,2705,2708,2711,2714],{},[113,2706,2707],{},"本番利用",[113,2709,2710],{},"安定版",[113,2712,2713],{},"現在もプレリリース",[113,2715,2716],{},"安定版と上位エコシステムの明示的対応を待つべき",[16,2718,2719],{},"一言でまとめると、",[16,2721,2722],{},[31,2723,2724],{},"Vue 3.5 の中心は開発体験と SSR 機能の向上、Vue 3.6 の中心はリアクティビティコアと描画アーキテクチャの更新です。",[78,2726,2728],{"id":2727},"_35-から-36-へ変化の重心が移った","3.5 から 3.6 へ：変化の重心が移った",[16,2730,2731],{},"Vue 3.5 には破壊的変更がなく、多くの改善を業務コードから直接感じられました。",[40,2733,2734,2737,2743,2749,2755,2758,2764],{},[43,2735,2736],{},"Reactive Props Destructure が安定版になった。",[43,2738,2739,2742],{},[20,2740,2741],{},"useTemplateRef()"," が template ref の整理方法を改善した。",[43,2744,2745,2748],{},[20,2746,2747],{},"onWatcherCleanup()"," で watcher の cleanup を自然に書けるようになった。",[43,2750,2751,2754],{},[20,2752,2753],{},"useId()"," が SSR に適した安定 ID を提供した。",[43,2756,2757],{},"非同期コンポーネントが Lazy Hydration に対応した。",[43,2759,2760,2763],{},[20,2761,2762],{},"data-allow-mismatch"," で許容する hydration 差異を宣言できるようになった。",[43,2765,2766],{},"Deferred Teleport とカスタム要素が強化された。",[16,2768,2769],{},"3.6 にも多くの修正がありますが、最も注目すべき alien-signals と Vapor は、どちらもフレームワークの下層にあります。業務コードに新 API を一つも追加しなくても、性能特性、コンパイル結果、ランタイム境界は変わります。",[16,2771,2772,2773],{},"そのためアップグレード方法も変わります。",[31,2774,2775],{},"「コンパイルできるか」だけでなく、リアクティブな動作、SSR hydration、コンポーネント間の相互運用、実際の性能を確認してください。",[78,2777,2779],{"id":2778},"変更点-1リアクティビティコアが-alien-signals-へ","変更点 1：リアクティビティコアが alien-signals へ",[16,2781,2782,2783,2786],{},"Vue 3.6 は ",[20,2784,2785],{},"@vue\u002Freactivity"," を大規模に再構築し、その基盤には StackBlitz がオープンソース化した alien-signals が使われています。",[16,2788,2789],{},"大多数のアプリケーション開発者にとって、次のコードはこれまでどおりの Vue です。",[146,2791,2793],{"className":374,"code":2792,"language":376,"meta":152,"style":152},"import { computed, ref, watchEffect } from 'vue'\n\nconst price = ref(99)\nconst count = ref(2)\nconst total = computed(() => price.value * count.value)\n\nwatchEffect(() => {\n console.log(total.value)\n})\n",[20,2794,2795,2807,2811,2830,2848,2874,2878,2889,2899],{"__ignoreMap":152},[380,2796,2797,2799,2802,2804],{"class":382,"line":383},[380,2798,900],{"class":386},[380,2800,2801],{"class":394}," { computed, ref, watchEffect } ",[380,2803,906],{"class":386},[380,2805,2806],{"class":513}," 'vue'\n",[380,2808,2809],{"class":382,"line":398},[380,2810,422],{"emptyLinePlaceholder":421},[380,2812,2813,2815,2818,2820,2823,2825,2828],{"class":382,"line":412},[380,2814,1474],{"class":386},[380,2816,2817],{"class":408}," price",[380,2819,483],{"class":386},[380,2821,2822],{"class":390}," ref",[380,2824,445],{"class":394},[380,2826,2827],{"class":408},"99",[380,2829,573],{"class":394},[380,2831,2832,2834,2837,2839,2841,2843,2846],{"class":382,"line":418},[380,2833,1474],{"class":386},[380,2835,2836],{"class":408}," count",[380,2838,483],{"class":386},[380,2840,2822],{"class":390},[380,2842,445],{"class":394},[380,2844,2845],{"class":408},"2",[380,2847,573],{"class":394},[380,2849,2850,2852,2855,2857,2860,2863,2865,2868,2871],{"class":382,"line":425},[380,2851,1474],{"class":386},[380,2853,2854],{"class":408}," total",[380,2856,483],{"class":386},[380,2858,2859],{"class":390}," computed",[380,2861,2862],{"class":394},"(() ",[380,2864,1552],{"class":386},[380,2866,2867],{"class":394}," price.value ",[380,2869,2870],{"class":386},"*",[380,2872,2873],{"class":394}," count.value)\n",[380,2875,2876],{"class":382,"line":436},[380,2877,422],{"emptyLinePlaceholder":421},[380,2879,2880,2883,2885,2887],{"class":382,"line":474},[380,2881,2882],{"class":390},"watchEffect",[380,2884,2862],{"class":394},[380,2886,1552],{"class":386},[380,2888,395],{"class":394},[380,2890,2891,2894,2896],{"class":382,"line":495},[380,2892,2893],{"class":394}," console.",[380,2895,615],{"class":390},[380,2897,2898],{"class":394},"(total.value)\n",[380,2900,2901],{"class":382,"line":526},[380,2902,1523],{"class":394},[16,2904,2905],{},"変化したのは内部です。依存関係の構築方法、状態のマーク方法、computed がいつ無効になるか、effect が依存グラフをどう伝播するか、そして関係をどう cleanup し再利用するかが変わりました。",[16,2907,2908],{},[167,2909],{"alt":2910,"src":2911},"アクティブな経路と休眠中の経路から構成される細粒度リアクティブ依存ネットワーク","\u002Fmedia\u002Fposts\u002Fvue-3-6-rc-upgrade-guide\u002Freactivity-core-v1.webp",[16,2913,2914],{},[174,2915,2916],{},"この図は依存伝播の概念を示したもので、Vue の内部データ構造をフィールド単位で表したものではありません。",[185,2918,2919],{"id":2919},"性能数値をどう理解するか",[16,2921,2922],{},"Vue core の alien-signals マージ PR では、二種類のマイクロベンチマーク結果が示されています。",[40,2924,2925,2933],{},[43,2926,2927,2928,2554,2930,2932],{},"多数の ",[20,2929,2553],{},[20,2931,2557],{},"、effect インスタンスを生成する場面で、サンプルのメモリ使用量が約 2.3 MB から約 2.0 MB へ減り、およそ 13% 削減された。",[43,2934,2935],{},"一つの source が変化した後、多数の computed を読み取る特定のストレスケースで、30 倍を超える性能向上が見られた。",[16,2937,2938,2939,2942],{},"二つ目の数字は目を引きますが、「Vue 3.6 のアプリが 30 倍速くなる」という意味ではありません。示しているのは、",[31,2940,2941],{},"以前は規模とともにコストが急増した一部の依存グラフで、新しい伝播アルゴリズムの計算量特性が改善した","ということです。",[16,2944,2945],{},"実際のページには DOM、layout、network、コンポーネントライブラリ、serialization、業務計算も含まれます。アップグレード前後は、自分のプロジェクトの flame chart、操作遅延、メモリ曲線、bundle 結果で判断し、フレームワークのマイクロベンチマークをそのままアプリの約束にしないでください。",[185,2947,2948],{"id":2948},"効果を感じやすいプロジェクト",[40,2950,2951,2954,2957,2960,2963],{},[43,2952,2953],{},"多数の computed が相互依存するデータダッシュボード。",[43,2955,2956],{},"高頻度の変更、フィルター、多くの派生状態を持つエディター。",[43,2958,2959],{},"長時間動作し、多数の effect を生成・破棄するワークベンチ。",[43,2961,2962],{},"フィールド数が多く、検証規則と連動関係が複雑なフォーム。",[43,2964,2965],{},"Vue のリアクティブ primitive を基盤にした状態管理やツールライブラリ。",[16,2967,2968],{},"通常のコンテンツページも内部改善を受けますが、ユーザーが大きな違いを感じるとは限りません。",[185,2970,2971],{"id":2971},"特に注意すべきコード",[16,2973,2974,2975,2554,2977,2554,2980,2554,2982,2554,2984,2987],{},"公開 API の ",[20,2976,2553],{},[20,2978,2979],{},"reactive",[20,2981,2557],{},[20,2983,2560],{},[20,2985,2986],{},"effectScope"," だけを使っていれば、移行リスクは比較的限定的です。本当に注意すべきなのは次のコードです。",[40,2989,2990,2993,2996,2999,3002],{},[43,2991,2992],{},"Vue の非公開リアクティブフィールドを直接読む、または変更する。",[43,2994,2995],{},"非公開の effect、Dep、scheduler の実装詳細へ依存する。",[43,2997,2998],{},"リアクティブ関数を monkey patch する。",[43,3000,3001],{},"watcher の実行順、同期 flush、cleanup timing に暗黙の仮定がある。",[43,3003,3004],{},"複数の Vue マイナーバージョンに対応するライブラリで、境界テストがない。",[16,3006,3007],{},"内部再構築の意義は、公開 API を保ったまま Vue が実装を交換できることです。逆に、内部実装に依存するコードほど、この種のアップグレードで問題が表面化します。",[78,3009,3011],{"id":3010},"変更点-2vapor-mode-は実験的な概念だけではなくなった","変更点 2：Vapor Mode は実験的な概念だけではなくなった",[16,3013,3014],{},"Vapor Mode は Vue SFC の新しいコンパイルモードです。従来の Vue template は VNode を生成し、Virtual DOM runtime が新旧ツリーを比較して差分を実 DOM へ反映します。Vapor ではコンパイラが動的部分を事前に認識し、より直接的で細粒度な更新ロジックを生成します。",[16,3016,3017],{},"目標は二つです。",[336,3019,3020,3023],{},[43,3021,3022],{},"アプリケーションの基礎 bundle サイズを削減する。",[43,3024,3025],{},"実行時に VNode を生成、走査、比較するコストを減らす。",[16,3027,3028],{},"公式リリースノートによると、Vapor は第三者の js-framework-benchmark で Solid や Svelte 5 に近い水準に達しています。これも「ベンチマークの場面での結果」と理解すべきで、異なるフレームワークと実アプリの性能を一つの順位に圧縮するものではありません。",[185,3030,3032],{"id":3031},"アップグレードしても-vapor-は自動で有効にならない","アップグレードしても Vapor は自動で有効にならない",[16,3034,3035],{},"Vue 3.6 も既定では VDOM を使います。SFC で Vapor を使うには明示的に指定します。",[146,3037,3041],{"className":3038,"code":3039,"language":3040,"meta":152,"style":152},"language-vue shiki shiki-themes github-dark github-dark","\u003Cscript setup vapor lang=\"ts\">\nimport { ref } from 'vue'\n\nconst count = ref(0)\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n \u003Cbutton @click=\"count++\">\n Count: {{ count }}\n \u003C\u002Fbutton>\n\u003C\u002Ftemplate>\n","vue",[20,3042,3043,3067,3078,3082,3099,3108,3112,3121,3139,3144,3153],{"__ignoreMap":152},[380,3044,3045,3047,3051,3054,3057,3060,3062,3065],{"class":382,"line":383},[380,3046,465],{"class":394},[380,3048,3050],{"class":3049},"sxg3X","script",[380,3052,3053],{"class":390}," setup",[380,3055,3056],{"class":390}," vapor",[380,3058,3059],{"class":390}," lang",[380,3061,1570],{"class":394},[380,3063,3064],{"class":513},"\"ts\"",[380,3066,759],{"class":394},[380,3068,3069,3071,3074,3076],{"class":382,"line":398},[380,3070,900],{"class":386},[380,3072,3073],{"class":394}," { ref } ",[380,3075,906],{"class":386},[380,3077,2806],{"class":513},[380,3079,3080],{"class":382,"line":412},[380,3081,422],{"emptyLinePlaceholder":421},[380,3083,3084,3086,3088,3090,3092,3094,3097],{"class":382,"line":418},[380,3085,1474],{"class":386},[380,3087,2836],{"class":408},[380,3089,483],{"class":386},[380,3091,2822],{"class":390},[380,3093,445],{"class":394},[380,3095,3096],{"class":408},"0",[380,3098,573],{"class":394},[380,3100,3101,3104,3106],{"class":382,"line":425},[380,3102,3103],{"class":394},"\u003C\u002F",[380,3105,3050],{"class":3049},[380,3107,759],{"class":394},[380,3109,3110],{"class":382,"line":436},[380,3111,422],{"emptyLinePlaceholder":421},[380,3113,3114,3116,3119],{"class":382,"line":474},[380,3115,465],{"class":394},[380,3117,3118],{"class":3049},"template",[380,3120,759],{"class":394},[380,3122,3123,3126,3129,3132,3134,3137],{"class":382,"line":495},[380,3124,3125],{"class":394}," \u003C",[380,3127,3128],{"class":3049},"button",[380,3130,3131],{"class":390}," @click",[380,3133,1570],{"class":394},[380,3135,3136],{"class":513},"\"count++\"",[380,3138,759],{"class":394},[380,3140,3141],{"class":382,"line":526},[380,3142,3143],{"class":394}," Count: {{ count }}\n",[380,3145,3146,3149,3151],{"class":382,"line":531},[380,3147,3148],{"class":394}," \u003C\u002F",[380,3150,3128],{"class":3049},[380,3152,759],{"class":394},[380,3154,3155,3157,3159],{"class":382,"line":559},[380,3156,3103],{"class":394},[380,3158,3118],{"class":3049},[380,3160,759],{"class":394},[16,3162,3163],{},"同等の入口がほかに二つあります。",[146,3165,3167],{"className":3038,"code":3166,"language":3040,"meta":152,"style":152},"\u003Cscript vapor>\n\u002F\u002F \u003Cscript setup vapor> の短縮形\n\u003C\u002Fscript>\n",[20,3168,3169,3179,3184],{"__ignoreMap":152},[380,3170,3171,3173,3175,3177],{"class":382,"line":383},[380,3172,465],{"class":394},[380,3174,3050],{"class":3049},[380,3176,3056],{"class":390},[380,3178,759],{"class":394},[380,3180,3181],{"class":382,"line":398},[380,3182,3183],{"class":1634},"\u002F\u002F \u003Cscript setup vapor> の短縮形\n",[380,3185,3186,3188,3190],{"class":382,"line":412},[380,3187,3103],{"class":394},[380,3189,3050],{"class":3049},[380,3191,759],{"class":394},[146,3193,3195],{"className":3038,"code":3194,"language":3040,"meta":152,"style":152},"\u003Ctemplate vapor>\n \u003C!-- SFC 全体を Vapor でコンパイル -->\n\u003C\u002Ftemplate>\n",[20,3196,3197,3207,3212],{"__ignoreMap":152},[380,3198,3199,3201,3203,3205],{"class":382,"line":383},[380,3200,465],{"class":394},[380,3202,3118],{"class":3049},[380,3204,3056],{"class":390},[380,3206,759],{"class":394},[380,3208,3209],{"class":382,"line":398},[380,3210,3211],{"class":1634}," \u003C!-- SFC 全体を Vapor でコンパイル -->\n",[380,3213,3214,3216,3218],{"class":382,"line":412},[380,3215,3103],{"class":394},[380,3217,3118],{"class":3049},[380,3219,759],{"class":394},[16,3221,3222],{},"つまり 3.6 へアップグレードした後も既存の VDOM アプリを維持し、特定のコンポーネントやページだけを選んで移行できます。",[185,3224,3226],{"id":3225},"純粋な-vapor-アプリケーション","純粋な Vapor アプリケーション",[16,3228,3229],{},"アプリケーションが完全に Vapor コンポーネントで構成される場合は、次を使えます。",[146,3231,3233],{"className":374,"code":3232,"language":376,"meta":152,"style":152},"import { createVaporApp } from 'vue'\nimport App from '.\u002FApp.vue'\n\ncreateVaporApp(App).mount('#app')\n",[20,3234,3235,3246,3258,3262],{"__ignoreMap":152},[380,3236,3237,3239,3242,3244],{"class":382,"line":383},[380,3238,900],{"class":386},[380,3240,3241],{"class":394}," { createVaporApp } ",[380,3243,906],{"class":386},[380,3245,2806],{"class":513},[380,3247,3248,3250,3253,3255],{"class":382,"line":398},[380,3249,900],{"class":386},[380,3251,3252],{"class":394}," App ",[380,3254,906],{"class":386},[380,3256,3257],{"class":513}," '.\u002FApp.vue'\n",[380,3259,3260],{"class":382,"line":412},[380,3261,422],{"emptyLinePlaceholder":421},[380,3263,3264,3267,3270,3273,3275,3278],{"class":382,"line":418},[380,3265,3266],{"class":390},"createVaporApp",[380,3268,3269],{"class":394},"(App).",[380,3271,3272],{"class":390},"mount",[380,3274,445],{"class":394},[380,3276,3277],{"class":513},"'#app'",[380,3279,573],{"class":394},[16,3281,3282],{},"このモードは Virtual DOM runtime を取り込む必要がなく、基礎 bundle サイズの効果を最も得やすい方法です。小さな新規アプリ、インタラクティブなツール、技術スタックを明確に制約できる独立ページに向いています。",[185,3284,3286],{"id":3285},"既存の-vdom-アプリケーションで-vapor-を使う","既存の VDOM アプリケーションで Vapor を使う",[16,3288,3289,3290,3293],{},"既存の ",[20,3291,3292],{},"createApp()"," プロジェクトには相互運用プラグインが必要です。",[146,3295,3297],{"className":374,"code":3296,"language":376,"meta":152,"style":152},"import { createApp, vaporInteropPlugin } from 'vue'\nimport App from '.\u002FApp.vue'\n\ncreateApp(App)\n .use(vaporInteropPlugin)\n .mount('#app')\n",[20,3298,3299,3310,3320,3324,3332,3343],{"__ignoreMap":152},[380,3300,3301,3303,3306,3308],{"class":382,"line":383},[380,3302,900],{"class":386},[380,3304,3305],{"class":394}," { createApp, vaporInteropPlugin } ",[380,3307,906],{"class":386},[380,3309,2806],{"class":513},[380,3311,3312,3314,3316,3318],{"class":382,"line":398},[380,3313,900],{"class":386},[380,3315,3252],{"class":394},[380,3317,906],{"class":386},[380,3319,3257],{"class":513},[380,3321,3322],{"class":382,"line":412},[380,3323,422],{"emptyLinePlaceholder":421},[380,3325,3326,3329],{"class":382,"line":418},[380,3327,3328],{"class":390},"createApp",[380,3330,3331],{"class":394},"(App)\n",[380,3333,3334,3337,3340],{"class":382,"line":425},[380,3335,3336],{"class":394}," .",[380,3338,3339],{"class":390},"use",[380,3341,3342],{"class":394},"(vaporInteropPlugin)\n",[380,3344,3345,3347,3349,3351,3353],{"class":382,"line":436},[380,3346,3336],{"class":394},[380,3348,3272],{"class":390},[380,3350,445],{"class":394},[380,3352,3277],{"class":513},[380,3354,573],{"class":394},[16,3356,3357],{},"逆に、Vapor アプリもこのプラグインを導入して VDOM コンポーネントを含められます。ただし VDOM runtime が再び入り、bundle サイズの利点は小さくなります。",[16,3359,3360],{},"Render Function や JSX で書いたコンポーネントも VDOM コンポーネントのままです。純 Vapor アプリで使う場合は相互運用が必要です。",[16,3362,3363],{},[167,3364],{"alt":3365,"src":3366},"既存の VDOM 領域が明示的な相互運用境界を通じて独立した Vapor 領域へ接続される","\u002Fmedia\u002Fposts\u002Fvue-3-6-rc-upgrade-guide\u002Fvapor-boundaries-v1.webp",[16,3368,3369,3370],{},"私の提案も公式ガイダンスと同じです。",[31,3371,3372],{},"二つの描画モードを境界の明確な領域へ整理し、コンポーネント階層の各段で交互にネストしないでください。",[16,3374,3375],{},"例えば、高頻度に更新するデータキャンバスだけを Vapor ページまたは subtree にし、周囲の管理ナビゲーション、dialog、成熟したコンポーネントライブラリは VDOM のままにします。そのほうが効果、障害範囲、ロールバック経路を測定しやすくなります。",[78,3377,3379],{"id":3378},"rc2-で最も陥りやすい変更イベント委譲が明示的-opt-in-になった","rc.2 で最も陥りやすい変更：イベント委譲が明示的 opt-in になった",[16,3381,3382],{},"rc.1 の段階で Vapor を試した場合、この節は特に重要です。",[16,3384,3385,3386,3389,3390,3393,3394,3396],{},"rc.1 では条件を満たすイベントが自動的に ",[20,3387,3388],{},"document"," へ委譲されました。しかし、これはネイティブ DOM と標準 Vue の動作と異なります。祖先要素が先に ",[20,3391,3392],{},"stopPropagation()"," を呼ぶとイベントは ",[20,3395,3388],{}," へ到達せず、子要素の委譲 handler も実行されません。",[16,3398,3399,3401,3402,3404],{},[31,3400,2572],{}," 以降、Vapor は既定で DOM listener を要素へ直接 binding します。document レベルの委譲を明示的に使いたい場合だけ、Vapor 専用の ",[20,3403,2698],{}," modifier を付けます。",[146,3406,3408],{"className":3038,"code":3407,"language":3040,"meta":152,"style":152},"\u003Cbutton @click.delegate=\"onClick\">\n 保存\n\u003C\u002Fbutton>\n",[20,3409,3410,3439,3444],{"__ignoreMap":152},[380,3411,3412,3414,3416,3419,3422,3424,3427,3429,3432,3435,3437],{"class":382,"line":383},[380,3413,465],{"class":394},[380,3415,3128],{"class":3049},[380,3417,3418],{"class":394}," @",[380,3420,3421],{"class":390},"click",[380,3423,1312],{"class":394},[380,3425,3426],{"class":390},"delegate",[380,3428,1570],{"class":394},[380,3430,3431],{"class":513},"\"",[380,3433,3434],{"class":394},"onClick",[380,3436,3431],{"class":513},[380,3438,759],{"class":394},[380,3440,3441],{"class":382,"line":398},[380,3442,3443],{"class":394}," 保存\n",[380,3445,3446,3448,3450],{"class":382,"line":412},[380,3447,3103],{"class":394},[380,3449,3128],{"class":3049},[380,3451,759],{"class":394},[16,3453,3454,3455,3458],{},"古い ",[20,3456,3457],{},"compilerOptions.eventDelegation"," は削除されました。",[16,3460,3461],{},"移行では二つの作業が必要です。",[336,3463,3464,3469],{},[43,3465,3289,3466,3468],{},[20,3467,3457],{}," を削除する。",[43,3470,3471,3472,3474],{},"数が多く、イベントが安定し、伝播経路を検証済みの listener だけに ",[20,3473,2698],{}," を使う。",[16,3476,3477],{},"これは全体へ機械的に置換するための最適化ではありません。委譲に価値があるかは、ノード数、ライフサイクル、伝播セマンティクスを合わせて判断します。",[78,3479,3481],{"id":3480},"vapor-と標準-vue-の互換性境界","Vapor と標準 Vue の互換性境界",[16,3483,3484],{},"Vapor は初日から Vue の歴史的な機能をすべて覆うことを目標にしていません。公式には既存 Vue API のサブセットをサポートし、VNode やコンポーネントの公開インスタンスプロキシへ依存する機能は現在直接利用できません。",[86,3486,3487,3499],{},[89,3488,3489],{},[92,3490,3491,3493,3496],{},[95,3492,778],{},[95,3494,3495],{},"VDOM コンポーネント",[95,3497,3498],{},"Vapor コンポーネント",[108,3500,3501,3512,3522,3533,3549,3560,3572,3584,3610],{},[92,3502,3503,3506,3509],{},[113,3504,3505],{},"Composition API",[113,3507,3508],{},"対応",[113,3510,3511],{},"主なプログラミングモデル",[92,3513,3514,3517,3519],{},[113,3515,3516],{},"Options API",[113,3518,3508],{},[113,3520,3521],{},"非対応",[92,3523,3524,3529,3531],{},[113,3525,3526],{},[20,3527,3528],{},"app.config.globalProperties",[113,3530,3508],{},[113,3532,3521],{},[92,3534,3535,3540,3543],{},[113,3536,3537],{},[20,3538,3539],{},"getCurrentInstance()",[113,3541,3542],{},"現在のインスタンスを返す",[113,3544,3545,3548],{},[20,3546,3547],{},"null"," を返す",[92,3550,3551,3554,3557],{},[113,3552,3553],{},"Render Function \u002F JSX",[113,3555,3556],{},"ネイティブ VDOM",[113,3558,3559],{},"VDOM のまま、混在には interop が必要",[92,3561,3562,3567,3569],{},[113,3563,3564],{},[20,3565,3566],{},"v-memo",[113,3568,3508],{},[113,3570,3571],{},"対象外 \u002F 非対応",[92,3573,3574,3580,3582],{},[113,3575,3576,3579],{},[20,3577,3578],{},"@vue:xxx"," 要素ライフサイクルイベント",[113,3581,3508],{},[113,3583,3521],{},[92,3585,3586,3589,3592],{},[113,3587,3588],{},"コンポーネント template ref",[113,3590,3591],{},"公開インスタンス機能を公開",[113,3593,3594,2554,3597,2554,3600,2554,3603,2554,3606,3609],{},[20,3595,3596],{},"$el",[20,3598,3599],{},"$props",[20,3601,3602],{},"$attrs",[20,3604,3605],{},"$slots",[20,3607,3608],{},"$refs"," などを公開しない",[92,3611,3612,3615,3618],{},[113,3613,3614],{},"カスタム directive",[113,3616,3617],{},"標準 directive lifecycle object",[113,3619,3620],{},"Vapor 専用の関数インターフェース",[185,3622,3624,3627],{"id":3623},"slotsdefault-を副作用のない確認に使わない",[20,3625,3626],{},"slots.default()"," を副作用のない確認に使わない",[16,3629,3630,3631,3633],{},"VDOM では、先に ",[20,3632,3626],{}," を呼び、返った内容を確認してから fallback を描画するコンポーネントがあります。Vapor で slot を呼ぶと、Block と DOM の生成、リアクティブ effect の登録、hydration 時の既存 SSR DOM の取得が直ちに行われる可能性があります。",[16,3635,3636],{},"次のように書かないでください。",[146,3638,3640],{"className":3038,"code":3639,"language":3040,"meta":152,"style":152},"\u003Cscript setup vapor>\nimport { useSlots } from 'vue'\n\nconst slots = useSlots()\nconst content = slots.default?.()\nconst showFallback = !content\n\u003C\u002Fscript>\n",[20,3641,3642,3654,3665,3669,3683,3701,3716],{"__ignoreMap":152},[380,3643,3644,3646,3648,3650,3652],{"class":382,"line":383},[380,3645,465],{"class":394},[380,3647,3050],{"class":3049},[380,3649,3053],{"class":390},[380,3651,3056],{"class":390},[380,3653,759],{"class":394},[380,3655,3656,3658,3661,3663],{"class":382,"line":398},[380,3657,900],{"class":386},[380,3659,3660],{"class":394}," { useSlots } ",[380,3662,906],{"class":386},[380,3664,2806],{"class":513},[380,3666,3667],{"class":382,"line":412},[380,3668,422],{"emptyLinePlaceholder":421},[380,3670,3671,3673,3676,3678,3681],{"class":382,"line":418},[380,3672,1474],{"class":386},[380,3674,3675],{"class":408}," slots",[380,3677,483],{"class":386},[380,3679,3680],{"class":390}," useSlots",[380,3682,492],{"class":394},[380,3684,3685,3687,3690,3692,3695,3698],{"class":382,"line":425},[380,3686,1474],{"class":386},[380,3688,3689],{"class":408}," content",[380,3691,483],{"class":386},[380,3693,3694],{"class":394}," slots.",[380,3696,3697],{"class":390},"default",[380,3699,3700],{"class":394},"?.()\n",[380,3702,3703,3705,3708,3710,3713],{"class":382,"line":436},[380,3704,1474],{"class":386},[380,3706,3707],{"class":408}," showFallback",[380,3709,483],{"class":386},[380,3711,3712],{"class":386}," !",[380,3714,3715],{"class":394},"content\n",[380,3717,3718,3720,3722],{"class":382,"line":474},[380,3719,3103],{"class":394},[380,3721,3050],{"class":3049},[380,3723,759],{"class":394},[16,3725,3726],{},"実際の slot 描画は template に任せるほうが安全です。",[146,3728,3730],{"className":3038,"code":3729,"language":3040,"meta":152,"style":152},"\u003Ctemplate>\n \u003Cslot \u002F>\n\u003C\u002Ftemplate>\n",[20,3731,3732,3740,3753],{"__ignoreMap":152},[380,3733,3734,3736,3738],{"class":382,"line":383},[380,3735,465],{"class":394},[380,3737,3118],{"class":3049},[380,3739,759],{"class":394},[380,3741,3742,3744,3747,3751],{"class":382,"line":398},[380,3743,3125],{"class":394},[380,3745,3746],{"class":3049},"slot",[380,3748,3750],{"class":3749},"sX7ps"," \u002F",[380,3752,759],{"class":394},[380,3754,3755,3757,3759],{"class":382,"line":412},[380,3756,3103],{"class":394},[380,3758,3118],{"class":3049},[380,3760,759],{"class":394},[185,3762,3764],{"id":3763},"カスタム-directive-は個別に移行する","カスタム directive は個別に移行する",[16,3766,3767,3768,2554,3771,2554,3774,3777],{},"Vapor のカスタム directive はノードとリアクティブ getter を受け取り、cleanup 関数を返せます。VDOM directive の ",[20,3769,3770],{},"mounted",[20,3772,3773],{},"updated",[20,3775,3776],{},"unmounted"," オブジェクトをそのまま移すものではありません。",[16,3779,3780],{},"多くのカスタム directive に依存するプロジェクトやコンポーネントライブラリでは、独立した移行項目として一覧化し、リアクティブ更新、cleanup、SSR 動作を一つずつ検証してください。",[78,3782,3784],{"id":3783},"nuxtrouterpiniaコンポーネントライブラリをどう見るべきか","Nuxt、Router、Pinia、コンポーネントライブラリをどう見るべきか",[16,3786,3787],{},"Vue core で利用できることは、その上のフレームワークが Vapor 統合を自動的に完了したことを意味しません。",[16,3789,3790],{},"公式 Vapor Roadmap は Router、Pinia、Nuxt、DevTools、Vue Test Utils などのエコシステム作業を個別に追跡しています。Nuxt はさらに SSR hydration 機能へ依存します。実プロジェクトでは、コンパイラの Vapor 認識、サーバー出力、クライアント hydration、開発ツールでのコンポーネント確認までが一つの完全なチェーンです。",[16,3792,3793],{},"そのため、プロジェクトを二種類に分けて考えます。",[185,3795,3797],{"id":3796},"通常の-vue-vite-アプリケーション","通常の Vue \u002F Vite アプリケーション",[16,3799,3800],{},"ブランチ上で 3.6 RC へアップグレードし、既存 VDOM モードを先に検証してから、一つの leaf ページで Vapor を試します。依存関係が比較的直接的なので、問題の原因も特定しやすくなります。",[185,3802,3804],{"id":3803},"nuxtssrまたはコンポーネントライブラリを多用するアプリ","Nuxt、SSR、またはコンポーネントライブラリを多用するアプリ",[16,3806,3807],{},"package override で下層 Vue だけを RC に変え、Vapor 移行が完了したと考えないでください。フレームワーク、build plugin、SSR チェーンが対象バージョンを明示的にサポートすることを確認してから、hydration、ルート遷移、非同期コンポーネント、コンポーネントライブラリとの相互運用をテストします。",[16,3809,3810],{},"Vapor を使わなくても、Vue 3.6 の新しいリアクティビティコアを試す価値はあります。ただし独立ブランチかテスト環境に置くのが安全です。",[78,3812,3813],{"id":3813},"より安全なアップグレード手順",[185,3815,3817],{"id":3816},"第-1-段階vapor-を有効にせず依存関係だけを更新","第 1 段階：Vapor を有効にせず、依存関係だけを更新",[16,3819,3820],{},"通常の Vue \u002F Vite プロジェクトでは、実験ブランチに RC をインストールできます。",[146,3822,3824],{"className":2168,"code":3823,"language":2170,"meta":152,"style":152},"pnpm add vue@3.6.0-rc.2\n",[20,3825,3826],{"__ignoreMap":152},[380,3827,3828,3830,3833],{"class":382,"line":383},[380,3829,2177],{"class":390},[380,3831,3832],{"class":513}," add",[380,3834,3835],{"class":513}," vue@3.6.0-rc.2\n",[16,3837,3838,3841],{},[20,3839,3840],{},"@vue\u002Fserver-renderer"," に直接依存している場合は Vue と同じバージョンに揃えます。",[146,3843,3845],{"className":2168,"code":3844,"language":2170,"meta":152,"style":152},"pnpm add vue@3.6.0-rc.2 @vue\u002Fserver-renderer@3.6.0-rc.2\n",[20,3846,3847],{"__ignoreMap":152},[380,3848,3849,3851,3853,3856],{"class":382,"line":383},[380,3850,2177],{"class":390},[380,3852,3832],{"class":513},[380,3854,3855],{"class":513}," vue@3.6.0-rc.2",[380,3857,3858],{"class":513}," @vue\u002Fserver-renderer@3.6.0-rc.2\n",[16,3860,3861],{},"まず従来の VDOM アプリを検証します。",[40,3863,3864,3867,3870,3879,3882,3885,3888,3891],{},[43,3865,3866],{},"unit test と component test。",[43,3868,3869],{},"初期 SSR とクライアント hydration。",[43,3871,3872,3873,2554,3875,2554,3877,2100],{},"複雑な ",[20,3874,2560],{},[20,3876,2557],{},[20,3878,2986],{},[43,3880,3881],{},"高速なルート遷移後の副作用 cleanup。",[43,3883,3884],{},"カスタム directive、Teleport、Suspense、非同期コンポーネント。",[43,3886,3887],{},"開発 build と本番 build。",[43,3889,3890],{},"ブラウザコンソールの warning と error。",[43,3892,3893],{},"重要な操作の時間とメモリ基準。",[16,3895,3896],{},"この段階で失敗した場合、原因は Vapor よりも新しいリアクティビティ実装や RC の回帰である可能性が高く、切り分けが簡単になります。",[185,3898,3900],{"id":3899},"第-2-段階境界が明確な領域を一つ選ぶ","第 2 段階：境界が明確な領域を一つ選ぶ",[16,3902,3903],{},"良い試験領域には通常、次の条件がそろっています。",[40,3905,3906,3909,3912,3915,3918,3921],{},[43,3907,3908],{},"Composition API を使っている。",[43,3910,3911],{},"コンポーネントインスタンスへの依存が少ない。",[43,3913,3914],{},"複雑な VDOM コンポーネントライブラリへ依存しない。",[43,3916,3917],{},"更新頻度が高く、実際の性能負荷がある。",[43,3919,3920],{},"独立したルートまたは明確なコンポーネントツリー境界がある。",[43,3922,3923],{},"再現可能な性能テストがある。",[16,3925,3926],{},"移行前の JavaScript サイズ、操作遅延、CPU 時間、メモリを記録してから Vapor を有効にします。基準がなければ「技術的に動いた」を「移行する価値があった」と誤認しやすくなります。",[185,3928,3930],{"id":3929},"第-3-段階相互運用と-ssr-を検証","第 3 段階：相互運用と SSR を検証",[16,3932,3933],{},"最低でも次の組み合わせを確認します。",[336,3935,3936,3939,3942,3945,3948,3951,3954],{},[43,3937,3938],{},"VDOM 親コンポーネントに Vapor 子コンポーネント。",[43,3940,3941],{},"Vapor 親コンポーネントに VDOM 子コンポーネント。",[43,3943,3944],{},"props、emit、双方向 binding。",[43,3946,3947],{},"default、named、scoped slot。",[43,3949,3950],{},"Suspense、非同期コンポーネント、error boundary。",[43,3952,3953],{},"サーバー出力、hydration、mismatch recovery。",[43,3955,3956],{},"unmount 後の watcher、event、directive cleanup。",[16,3958,3959],{},"rc.2 の修正には hydration、Suspense、slot anchor、VDOM interop に集中する項目が多くあります。これらの領域が急速に収束している証拠であると同時に、今最も重点的にテストすべき場所でもあります。",[185,3961,3963],{"id":3962},"第-4-段階安定版を待って本番スケジュールを決める","第 4 段階：安定版を待って本番スケジュールを決める",[16,3965,3966],{},"RC は機能セットがほぼ確定し、回帰と境界問題の発見へ重点が移った状態です。エコシステム全体が安定したという意味ではありません。",[16,3968,3969],{},"本番プロジェクトは少なくとも次の条件を満たす必要があります。",[40,3971,3972,3975,3978,3981,3984,3987],{},[43,3973,3974],{},"Vue 3.6 の安定版が公開されている。",[43,3976,3977],{},"利用するフレームワークと build tool が明示的に対応している。",[43,3979,3980],{},"主要コンポーネントライブラリが相互運用テストを通過している。",[43,3982,3983],{},"DevTools、テストツール、SSR チェーンが利用できる。",[43,3985,3986],{},"性能効果が移行・保守コストを上回る。",[43,3988,3989],{},"いつでも VDOM へ戻せる。",[78,3991,3992],{"id":3992},"推奨しない四つのこと",[185,3994,3996],{"id":3995},"_1-rc-を通常の-patch-と同じように扱わない","1. RC を通常の patch と同じように扱わない",[16,3998,3999],{},"プレリリースでは動作が変わる可能性があります。rc.1 から rc.2 へのイベント委譲の変更が最も分かりやすい例です。",[185,4001,4003],{"id":4002},"_2-vapor-を使うために全コンポーネントを移行しない","2. 「Vapor を使う」ために全コンポーネントを移行しない",[16,4005,4006],{},"ナビゲーション、静的コンテンツ、更新頻度の低い設定ページでは意味のある効果を得られないかもしれません。移行率ではなく性能 bottleneck を優先します。",[185,4008,4010],{"id":4009},"_3-マイクロベンチマークをアプリの約束にしない","3. マイクロベンチマークをアプリの約束にしない",[16,4012,4013],{},"「30 倍超」は特定のリアクティブストレスケース、「Solid や Svelte 5 と同水準」は第三者 benchmark の結果です。技術的な方向性は証明しますが、プロジェクト自身の測定には代えられません。",[185,4015,4017],{"id":4016},"_4-エコシステム境界を無視しない","4. エコシステム境界を無視しない",[16,4019,4020],{},"Vue core、SFC compiler、Vite plugin、Nuxt、SSR、Router、Pinia、コンポーネントライブラリ、DevTools、テストツールが一緒に開発体験を構成します。一つの package を RC にするだけでは、チェーン全体の更新にはなりません。",[78,4022,4023],{"id":4023},"プロジェクト種別ごとの提案",[86,4025,4026,4039],{},[89,4027,4028],{},[92,4029,4030,4033,4036],{},[95,4031,4032],{},"プロジェクト種別",[95,4034,4035],{},"今試す価値",[95,4037,4038],{},"提案",[108,4040,4041,4052,4063,4074,4085,4096],{},[92,4042,4043,4046,4049],{},[113,4044,4045],{},"小規模な新規ツール、社内実験",[113,4047,4048],{},"ある",[113,4050,4051],{},"純 Vapor を試し、bundle サイズと操作性能を測る",[92,4053,4054,4057,4060],{},[113,4055,4056],{},"既存 Vue SPA",[113,4058,4059],{},"ブランチ上で試す価値がある",[113,4061,4062],{},"まず VDOM を維持し、性能が重要な一ページだけを移行",[92,4064,4065,4068,4071],{},[113,4066,4067],{},"Nuxt \u002F SSR サイト",[113,4069,4070],{},"研究には適するが本番は待つ",[113,4072,4073],{},"フレームワーク対応を確認し hydration を重点的にテスト",[92,4075,4076,4079,4082],{},[113,4077,4078],{},"コンポーネントライブラリ",[113,4080,4081],{},"早期に互換テストを始める",[113,4083,4084],{},"instance proxy、slots、カスタム directive、interop を確認",[92,4086,4087,4090,4093],{},[113,4088,4089],{},"大規模ダッシュボード \u002F エディター",[113,4091,4092],{},"stress test の価値が高い",[113,4094,4095],{},"alien-signals と Vapor それぞれの効果を分けて比較",[92,4097,4098,4101,4104],{},[113,4099,4100],{},"コンテンツ中心のサイト",[113,4102,4103],{},"優先度は低い",[113,4105,4106],{},"限定的な効果のために複雑さを増やさず、安定版と成熟したエコシステムを待つ",[78,4108,2340],{"id":2340},[16,4110,4111],{},"Vue 3.6 RC の最も価値ある点は、業務コードですぐ使える新 API の数ではなく、二つの長期的な問題を同時に進めていることです。",[40,4113,4114,4117],{},[43,4115,4116],{},"Vue のリアクティビティは、より複雑な依存グラフでも効率を保てるか。",[43,4118,4119],{},"Vue の template は、慣れた開発体験を保ちながら Virtual DOM のコストを必須ではなくせるか。",[16,4121,4122],{},"alien-signals は一つ目に答え、Vapor は二つ目に答えようとしています。",[16,4124,4125,4126,4129],{},"既存プロジェクトで最も合理的な戦略は、",[31,4127,4128],{},"まず 3.6 をリアクティビティコアの更新としてテストし、その後 Vapor を任意の局所コンパイルモードとして評価すること","です。二つを分けて検証すれば、性能変化の原因を理解でき、リスクを明確な境界内に保てます。",[16,4131,4132],{},"Vue 3.6 はまだ「全員が今日アップグレードすべき」段階ではありません。しかし「すべての Vue チームが理解を始める価値がある」段階には達しています。",[4134,4135],"hr",{},[78,4137,4138],{"id":4138},"資料と注記",[40,4140,4141,4149,4157,4165,4173,4181],{},[43,4142,4143,4148],{},[2382,4144,4147],{"href":4145,"rel":4146},"https:\u002F\u002Fgithub.com\u002Fvuejs\u002Fcore\u002Fblob\u002Fminor\u002FCHANGELOG.md",[2386],"Vue 3.6 minor ブランチ Changelog","：3.6.0-rc.1 の Vapor 概要と互換性境界、rc.2 のイベント委譲変更。",[43,4150,4151,4156],{},[2382,4152,4155],{"href":4153,"rel":4154},"https:\u002F\u002Fgithub.com\u002Fvuejs\u002Fcore\u002Freleases\u002Ftag\u002Fv3.6.0-rc.2",[2386],"Vue 3.6.0-rc.2 Release","：この記事公開時点の最新リリース候補。",[43,4158,4159,4164],{},[2382,4160,4163],{"href":4161,"rel":4162},"https:\u002F\u002Fblog.vuejs.org\u002Fposts\u002Fvue-3-5",[2386],"Vue 3.5 リリースノート","：Vue 3.5 のリアクティビティ改善、SSR、開発者 API の基準。",[43,4166,4167,4172],{},[2382,4168,4171],{"href":4169,"rel":4170},"https:\u002F\u002Fgithub.com\u002Fvuejs\u002Fcore\u002Fpull\u002F12349",[2386],"Vue core：alien-signals 再構築 PR","：リアクティビティ実装、メモリ、特定ストレスケースのマイクロベンチマーク。",[43,4174,4175,4180],{},[2382,4176,4179],{"href":4177,"rel":4178},"https:\u002F\u002Fgithub.com\u002Fvuejs\u002Fcore\u002Fissues\u002F13687",[2386],"Vapor Mode Roadmap","：コア機能と Vue エコシステム統合のロードマップ。",[43,4182,4183,4188],{},[2382,4184,4187],{"href":4185,"rel":4186},"https:\u002F\u002Fgithub.com\u002Fkrausest\u002Fjs-framework-benchmark",[2386],"js-framework-benchmark","：Vue 公式リリースノートが参照した第三者フロントエンド benchmark。",[72,4190,4191],{},[16,4192,4193],{},"この記事のアップグレード提案は、公式資料とエンジニアリング経験に基づく私の判断です。AI が資料整理と言語校正を補助しましたが、各プロジェクトでは自身のテスト結果を基準にしてください。",[2471,4195,4196],{},"html pre.shiki code .sOPea, html code.shiki .sOPea{--shiki-default:#F97583;--shiki-dark:#F97583}html pre.shiki code .suv1-, html code.shiki .suv1-{--shiki-default:#E1E4E8;--shiki-dark:#E1E4E8}html pre.shiki code .s4wv1, html code.shiki .s4wv1{--shiki-default:#9ECBFF;--shiki-dark:#9ECBFF}html pre.shiki code .s8ozJ, html code.shiki .s8ozJ{--shiki-default:#79B8FF;--shiki-dark:#79B8FF}html pre.shiki code .sFR8T, html code.shiki .sFR8T{--shiki-default:#B392F0;--shiki-dark:#B392F0}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sxg3X, html code.shiki .sxg3X{--shiki-default:#85E89D;--shiki-dark:#85E89D}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sX7ps, html code.shiki .sX7ps{--shiki-default:#FDAEB7;--shiki-default-font-style:italic;--shiki-dark:#FDAEB7;--shiki-dark-font-style:italic}",{"title":152,"searchDepth":412,"depth":412,"links":4198},[4199,4200,4201,4206,4211,4212,4217,4221,4227,4233,4234,4235],{"id":2576,"depth":398,"text":2577},{"id":2727,"depth":398,"text":2728},{"id":2778,"depth":398,"text":2779,"children":4202},[4203,4204,4205],{"id":2919,"depth":412,"text":2919},{"id":2948,"depth":412,"text":2948},{"id":2971,"depth":412,"text":2971},{"id":3010,"depth":398,"text":3011,"children":4207},[4208,4209,4210],{"id":3031,"depth":412,"text":3032},{"id":3225,"depth":412,"text":3226},{"id":3285,"depth":412,"text":3286},{"id":3378,"depth":398,"text":3379},{"id":3480,"depth":398,"text":3481,"children":4213},[4214,4216],{"id":3623,"depth":412,"text":4215},"slots.default() を副作用のない確認に使わない",{"id":3763,"depth":412,"text":3764},{"id":3783,"depth":398,"text":3784,"children":4218},[4219,4220],{"id":3796,"depth":412,"text":3797},{"id":3803,"depth":412,"text":3804},{"id":3813,"depth":398,"text":3813,"children":4222},[4223,4224,4225,4226],{"id":3816,"depth":412,"text":3817},{"id":3899,"depth":412,"text":3900},{"id":3929,"depth":412,"text":3930},{"id":3962,"depth":412,"text":3963},{"id":3992,"depth":398,"text":3992,"children":4228},[4229,4230,4231,4232],{"id":3995,"depth":412,"text":3996},{"id":4002,"depth":412,"text":4003},{"id":4009,"depth":412,"text":4010},{"id":4016,"depth":412,"text":4017},{"id":4023,"depth":398,"text":4023},{"id":2340,"depth":398,"text":2340},{"id":4138,"depth":398,"text":4138},"Vue 3.6.0-rc.2 時点で、Vue 3.5 と 3.6 のリアクティビティコア、Vapor Mode、イベント委譲、相互運用境界、段階的な移行戦略を比較します。",{"src":4238,"alt":4239,"caption":4240,"width":2515,"height":2516},"\u002Fmedia\u002Fposts\u002Fvue-3-6-rc-upgrade-guide\u002Fcover-v1.webp","Vue 3.5 の Virtual DOM コンポーネントツリーが結晶の通路を抜け、Vue 3.6 の細粒度シグナルネットワークへ移行する","Vue 3.6 RC は新 API の一覧というより、コンパイラとランタイムのアーキテクチャを切り替える更新です",{},"\u002Fblog\u002Fvue-3-6-rc-upgrade-guide","2026-07-26",{"title":2537,"description":4236},"blog\u002Fvue-3-6-rc-upgrade-guide",[4247,4248,4249],"Vue","JavaScript","フロントエンド","Nh6ytLUqnzdHOnmVTD55dslpQ84UZ1_-faPlGdYtf_o",{"id":4252,"title":4253,"accent":4254,"body":4255,"description":4490,"draft":2508,"experience":4491,"extension":2510,"featured":421,"image":4496,"meta":4500,"navigation":421,"path":4501,"publishedAt":4502,"readingTime":495,"seo":4503,"stem":4504,"tags":4505,"updatedAt":2509,"video":2509,"__hash__":4509,"contentLocale":6,"isFallback":2508},"posts_ja\u002Fblog\u002Ffrom-gpt-4-invite-to-agents.md","一通の GPT‑4 招待メールから、AI エージェントの時代へ","violet",{"type":13,"value":4256,"toc":4482},[4257,4260,4263,4268,4275,4281,4284,4287,4291,4294,4297,4303,4306,4309,4313,4316,4330,4333,4350,4356,4359,4362,4366,4369,4372,4386,4389,4403,4406,4410,4413,4416,4433,4436,4440,4443,4446,4449,4452,4454,4456],[16,4258,4259],{},"今日、古いメールを整理していると、2023 年 3 月 18 日に届いた一通のメールが再び目に入りました。",[16,4261,4262],{},"件名はとても簡潔でした。",[72,4264,4265],{},[16,4266,4267],{},"You’re invited to use the OpenAI GPT-4 API.",[16,4269,4270,4271,4274],{},"本文には、",[31,4272,4273],{},"8K のコンテキスト","を持つ GPT‑4 を API から利用できるようになったと書かれていました。",[16,4276,4277],{},[167,4278],{"alt":4279,"src":4280},"8K コンテキストを利用できると記された、2023 年の GPT‑4 API 招待メール","\u002Fmedia\u002Fposts\u002Ffrom-gpt-4-invite-to-agents\u002Femail-invite-v1.webp",[16,4282,4283],{},"GPT‑4 の公開から、まだ数日しか経っていない頃です。API を使うには申請して待ち、OpenAI から段階的に招待される必要がありました。公開時の資料では、標準版 GPT‑4 のコンテキスト長は 8,192 トークンで、32,768 トークン版は限定的に提供されていました。当時の私には、API の利用権そのものが、開いたばかりの小さな扉のように感じられました。",[16,4285,4286],{},"3 年以上が過ぎた今、このメールは製品のお知らせというより、一つのタイムカプセルに見えます。",[78,4288,4290],{"id":4289},"数字が大きくなったことはもっとも見えやすい変化にすぎない","数字が大きくなったことは、もっとも見えやすい変化にすぎない",[16,4292,4293],{},"初期の開発者にとって、4K や 8K のコンテキストは身近な制約でした。プロンプトを書くたびに残りの容量を数え、資料を削り、長い文章を分割し、前のリクエストの結果を次へ引き継ぐ方法を考えていました。",[16,4295,4296],{},"2026 年になると、100 万トークン規模のコンテキストは最先端モデルの主流に入りました。OpenAI の現在のモデル一覧では、GPT‑5.6 系列に約 105 万トークンのコンテキストウィンドウが記載されています。Google の長文コンテキスト資料でも、複数の Gemini モデルが 100 万トークン以上に対応すると説明されています。",[16,4298,4299],{},[167,4300],{"alt":4301,"src":4302},"4K、8K から 100 万トークン以上へ。短いメモがマルチモーダルな資料回廊へ伸びていく","\u002Fmedia\u002Fposts\u002Ffrom-gpt-4-invite-to-agents\u002Fcontext-window-v1.webp",[16,4304,4305],{},"これは単に「より多くの文章を詰め込める」という話ではありません。コード、画像、音声、動画、大量の文書を、一つのタスクの背景として扱えるようになりました。以前なら分割、索引化、要約が必要だった資料を、同じ作業コンテキストに置ける可能性が広がっています。",[16,4307,4308],{},"しかし、長いコンテキストは完全な記憶ではなく、モデルが自動的に重要な点を見抜く保証でもありません。資料が増えれば、ノイズ、コスト、遅延、誤った関連付けも増えます。重要なのは今も、どの情報を選び、どの順序で渡し、モデルが重要な制約を理解したかをどう検証するかです。",[78,4310,4312],{"id":4311},"本当に変わったのはやり取りの単位","本当に変わったのは、やり取りの単位",[16,4314,4315],{},"3 年前、私がよく行っていたのは「質問と回答」でした。",[336,4317,4318,4321,4324,4327],{},[43,4319,4320],{},"プロンプトを書く。",[43,4322,4323],{},"モデルの生成を待つ。",[43,4325,4326],{},"結果をコピーする。",[43,4328,4329],{},"残りの作業を自分で終える。",[16,4331,4332],{},"今では、より多くのタスクが「目標、文脈、行動、検証」という形になっています。",[336,4334,4335,4338,4341,4344,4347],{},[43,4336,4337],{},"最終目標と完了条件を示す。",[43,4339,4340],{},"リポジトリ、文書、現在の状態を渡す。",[43,4342,4343],{},"検索、ファイル、ターミナルなどのツール利用を許可する。",[43,4345,4346],{},"相互に依存する一連の手順を実行させる。",[43,4348,4349],{},"テスト、ビルド、差分確認、人のレビューで結果を確かめる。",[16,4351,4352],{},[167,4353],{"alt":4354,"src":4355},"チャット欄が文書、コード、ブラウザ、ツール呼び出し、人の確認を含むエージェントのワークフローへ広がる","\u002Fmedia\u002Fposts\u002Ffrom-gpt-4-invite-to-agents\u002Fagent-workflow-v1.webp",[16,4357,4358],{},"OpenAI の現在のモデルおよび Responses API の資料には、関数呼び出し、ウェブ検索、ファイル検索、コンピューター操作が利用可能なツールとして記載されています。モデルは「どうすればよいか」を説明するだけでなく、与えられた権限の範囲で実際の作業に参加し始めました。",[16,4360,4361],{},"これが、私の考える「チャットモデル」と「エージェント」のもっとも重要な違いです。前者はコンテンツを返し、後者は状態が変化するタスクを前へ進めます。",[78,4363,4365],{"id":4364},"プログラマーの仕事は消えず両端へ移動した","プログラマーの仕事は消えず、両端へ移動した",[16,4367,4368],{},"モデルがコードを読み、ファイルを編集し、コマンドを実行し、結果を確認できるようになっても、プログラマーが不要になるわけではありません。むしろ私たちの注意は、タスクの前後へ移っていきます。",[16,4370,4371],{},"行動の前には、問題をより明確に定義する必要があります。",[40,4373,4374,4377,4380,4383],{},[43,4375,4376],{},"目標は何か。何が対象外なのか。",[43,4378,4379],{},"どの資料を信頼でき、どれは参考にすぎないのか。",[43,4381,4382],{},"どの権限を渡せるか。どの操作は確認を必要とするか。",[43,4384,4385],{},"失敗したとき、停止、再試行、ロールバックのどれを選ぶか。",[16,4387,4388],{},"行動の後には、結果をより確実に検証する必要があります。",[40,4390,4391,4394,4397,4400],{},[43,4392,4393],{},"コードはテストとビルドを通過するか。",[43,4395,4396],{},"ページは本当に期待どおりか。「生成できた」だけではないか。",[43,4398,4399],{},"外部の状態は実際に変わったか。",[43,4401,4402],{},"結果を説明、再現、監査できるか。",[16,4404,4405],{},"3 年前、私たちはより良いプロンプトの書き方を学んでいました。今はそれに加えて、文脈、ツール、権限、チェックポイント、受け入れ条件の設計も学ぶ必要があります。",[78,4407,4409],{"id":4408},"能力は委ねられても責任は外部化できない","能力は委ねられても、責任は外部化できない",[16,4411,4412],{},"エージェントが現実の操作を実行できるほど、境界は重要になります。",[16,4414,4415],{},"記事の要約を頼むことと、本番データベースの変更を許可することは、同じ権限ではありません。メールの下書きを頼むことと、顧客へ直接送信させることも、同じリスクではありません。成熟したエージェントシステムは「何ができるか」だけでなく、次の点を明確にするべきです。",[40,4417,4418,4421,4424,4427,4430],{},[43,4419,4420],{},"デフォルトは読み取り専用か、書き込み可能か。",[43,4422,4423],{},"実行前に人の確認が必要な操作は何か。",[43,4425,4426],{},"対象、ディレクトリ、アカウント、データ範囲をどう制限するか。",[43,4428,4429],{},"必要な操作履歴をどう保存するか。",[43,4431,4432],{},"問題が起きたとき、どう停止し復旧するか。",[16,4434,4435],{},"モデルがより多くの行動を担っても、判断と責任は消えません。なぜ行うのか、根拠は何か、誰がリスクを負うのか、結果を受け入れられるかという問いには、最後まで人が答える必要があります。",[78,4437,4439],{"id":4438},"_3-年後私たちは今日をどう見るだろう","3 年後、私たちは今日をどう見るだろう",[16,4441,4442],{},"この古いメールは、偶然残しておいた一枚の切符のようです。",[16,4444,4445],{},"2023 年、私が申請していたのはモデルへアクセスする機会でした。2026 年には、長期目標を理解させ、ツールを使わせ、複数の工程を進め、人の監督のもとで仕事を完了させる方法を学んでいます。",[16,4447,4448],{},"心を動かされるのは、パラメーターが何倍になったかではなく、時間が圧縮されたことです。遠い未来にしかないと思われた能力は、何十年もかけて少しずつ来たのではありません。数回のバージョン更新の間に、静かに日常へ入り込みました。",[16,4450,4451],{},"さらに 3 年が経てば、今の私たちを驚かせる 100 万トークンのコンテキストやエージェントも、このメールと同じように見えるかもしれません。未来が始まったばかりの瞬間に残された、古い品物として。",[4134,4453],{},[78,4455,2376],{"id":2376},[40,4457,4458,4466,4474],{},[43,4459,4460,4465],{},[2382,4461,4464],{"href":4462,"rel":4463},"https:\u002F\u002Fopenai.com\u002Findex\u002Fgpt-4-research\u002F",[2386],"OpenAI: GPT‑4 research"," — GPT‑4 は 2023 年 3 月に公開され、標準のコンテキストは 8,192 トークン、32,768 トークン版は限定提供でした。",[43,4467,4468,4473],{},[2382,4469,4472],{"href":4470,"rel":4471},"https:\u002F\u002Fdevelopers.openai.com\u002Fapi\u002Fdocs\u002Fmodels",[2386],"OpenAI: model catalog"," — 記事公開時点で、最先端の GPT‑5.6 系列には約 105 万トークンのコンテキストと複数カテゴリのツール対応が記載されています。",[43,4475,4476,4481],{},[2382,4477,4480],{"href":4478,"rel":4479},"https:\u002F\u002Fai.google.dev\u002Fgemini-api\u002Fdocs\u002Flong-context",[2386],"Google AI: Long context"," — 100 万トークン以上のコンテキストを持つ Gemini モデルの用途と制約を説明しています。",{"title":152,"searchDepth":412,"depth":412,"links":4483},[4484,4485,4486,4487,4488,4489],{"id":4289,"depth":398,"text":4290},{"id":4311,"depth":398,"text":4312},{"id":4364,"depth":398,"text":4365},{"id":4408,"depth":398,"text":4409},{"id":4438,"depth":398,"text":4439},{"id":2376,"depth":398,"text":2376},"2023 年に待っていたのは 8K コンテキストの API 利用権でした。3 年後の今、私たちはエージェントに目標、権限、境界、完了条件を伝える方法を学んでいます。",{"src":4492,"title":4493,"description":4494,"duration":4495,"hasAudio":421},"\u002Fexperiences\u002Ffrom-gpt-4-invite-to-agents","GPT-4 の招待からエージェント時代へ · 6 幕のインタラクティブストーリー","コンテキスト、エージェントのワークフロー、能力と責任の変化を 2 分 26 秒で振り返ります。ナレーションは中国語です。",146,{"src":4497,"alt":4498,"caption":4499,"width":2515,"height":2516},"\u002Fmedia\u002Fposts\u002Ffrom-gpt-4-invite-to-agents\u002Fcover-ja-v1.webp","2023 年のメールがガラスのタイムカプセルから現代のエージェント用ワークスペースへとつながる","3 年前はモデルへのアクセスを申請し、今はモデルと協働する方法を学んでいる",{},"\u002Fblog\u002Ffrom-gpt-4-invite-to-agents","2026-07-25",{"title":4253,"description":4490},"blog\u002Ffrom-gpt-4-invite-to-agents",[4506,4507,4508],"AI","GPT-4","エージェント","MMkyyNWTPG5slI4EvXqp_pD8TJrZjZ-_JOgC08cs05o",{"id":4511,"title":4512,"accent":11,"body":4513,"description":4951,"draft":2508,"experience":2509,"extension":2510,"featured":421,"image":4952,"meta":4956,"navigation":421,"path":4957,"publishedAt":4958,"readingTime":495,"seo":4959,"stem":4960,"tags":4961,"updatedAt":4963,"video":2509,"__hash__":4964,"contentLocale":6,"isFallback":2508},"posts_ja\u002Fblog\u002Fedge-stateful-apps.md","エッジでステートフルなアプリケーションを構築する",{"type":13,"value":4514,"toc":4943},[4515,4522,4525,4528,4531,4581,4584,4589,4592,4596,4599,4669,4672,4754,4757,4760,4763,4840,4855,4858,4861,4864,4867,4878,4881,4884,4887,4890,4904,4907,4911,4914,4917,4934,4940],[16,4516,4517,4518,4521],{},"エッジコンピューティングの最も魅力的な約束は、コードをユーザーの近くへ届けることです。しかし、アプリケーションがアカウント、セッション、コメントを保存し始めると、問題は単に「関数をより多くの拠点へデプロイする」ことではなくなります。",[31,4519,4520],{},"状態は実際にどこにあり、誰が責任を持ち、障害時にシステムはどう縮退するのか","を考えなければなりません。",[16,4523,4524],{},"この記事では、ログインとコメント機能を備えたブログを最小の例として、Cloudflare Workers と D1 でステートフルなアプリケーションを構築するときに重要な設計境界を整理します。",[78,4526,4527],{"id":4527},"まず状態の地図を描く",[16,4529,4530],{},"小さく見えるブログにも、少なくとも三種類のまったく異なる状態があります。",[86,4532,4533,4546],{},[89,4534,4535],{},[92,4536,4537,4540,4543],{},[95,4538,4539],{},"状態",[95,4541,4542],{},"保存元",[95,4544,4545],{},"ライフサイクル",[108,4547,4548,4559,4570],{},[92,4549,4550,4553,4556],{},[113,4551,4552],{},"記事本文",[113,4554,4555],{},"Git 内の Markdown",[113,4557,4558],{},"デプロイとともに更新",[92,4560,4561,4564,4567],{},[113,4562,4563],{},"ユーザーとコメント",[113,4565,4566],{},"D1",[113,4568,4569],{},"長期的に永続化",[92,4571,4572,4575,4578],{},[113,4573,4574],{},"ログインセッション",[113,4576,4577],{},"D1 + Cookie",[113,4579,4580],{},"明確な有効期限",[16,4582,4583],{},"記事コンテンツはコードのバージョンと一緒に管理するのが適しています。レビュー、ロールバック、ビルド時検証は必要ですが、読者が実行時に変更する必要はありません。ユーザーデータはその逆で、デプロイのライフサイクルから独立して存在し続けなければなりません。",[72,4585,4586],{},[16,4587,4588],{},"データベースを選ぶ前に、そのデータがコードのバージョンに従うべきか、ユーザーの行動に従うべきかを判断します。",[16,4590,4591],{},"この区別から、自然にシンプルな構成が導かれます。Nuxt Content が Markdown を、D1 が実行時の業務データを担当し、Worker が一つのリクエストの中で両者を組み合わせます。",[78,4593,4595],{"id":4594},"ネットワークリクエストより-binding-が重要","ネットワークリクエストより binding が重要",[16,4597,4598],{},"Worker が D1 にアクセスするために API Token を保存する必要はなく、実行時に Cloudflare REST API を呼び出すべきでもありません。D1 は binding を通じてランタイムへ直接渡されます。",[146,4600,4603],{"className":4601,"code":4602,"filename":1115,"language":1406,"meta":152,"style":152},"language-json shiki shiki-themes github-dark github-dark","{\n \"d1_databases\": [\n {\n \"binding\": \"DB\",\n \"database_name\": \"signal-log-db\",\n \"database_id\": \"\u003CYOUR_DATABASE_ID>\"\n }\n ]\n}\n",[20,4604,4605,4609,4617,4621,4634,4646,4656,4660,4665],{"__ignoreMap":152},[380,4606,4607],{"class":382,"line":383},[380,4608,1128],{"class":394},[380,4610,4611,4614],{"class":382,"line":398},[380,4612,4613],{"class":408}," \"d1_databases\"",[380,4615,4616],{"class":394},": [\n",[380,4618,4619],{"class":382,"line":412},[380,4620,1138],{"class":394},[380,4622,4623,4626,4629,4632],{"class":382,"line":418},[380,4624,4625],{"class":408}," \"binding\"",[380,4627,4628],{"class":394},": ",[380,4630,4631],{"class":513},"\"DB\"",[380,4633,666],{"class":394},[380,4635,4636,4639,4641,4644],{"class":382,"line":425},[380,4637,4638],{"class":408}," \"database_name\"",[380,4640,4628],{"class":394},[380,4642,4643],{"class":513},"\"signal-log-db\"",[380,4645,666],{"class":394},[380,4647,4648,4651,4653],{"class":382,"line":436},[380,4649,4650],{"class":408}," \"database_id\"",[380,4652,4628],{"class":394},[380,4654,4655],{"class":513},"\"\u003CYOUR_DATABASE_ID>\"\n",[380,4657,4658],{"class":382,"line":474},[380,4659,585],{"class":394},[380,4661,4662],{"class":382,"line":495},[380,4663,4664],{"class":394}," ]\n",[380,4666,4667],{"class":382,"line":526},[380,4668,415],{"class":394},[16,4670,4671],{},"サーバールートでは、データベースオブジェクトを現在のリクエストコンテキストから取得します。すべての SQL は prepared statement を使います。",[146,4673,4675],{"className":374,"code":4674,"language":376,"meta":152,"style":152},"const comment = await db\n .prepare(`\n SELECT id, body, created_at\n FROM comments\n WHERE post_slug = ?1 AND status = 'published'\n ORDER BY created_at DESC\n LIMIT 100\n `)\n .bind(postSlug)\n .all()\n",[20,4676,4677,4691,4703,4708,4713,4718,4723,4728,4735,4745],{"__ignoreMap":152},[380,4678,4679,4681,4684,4686,4688],{"class":382,"line":383},[380,4680,1474],{"class":386},[380,4682,4683],{"class":408}," comment",[380,4685,483],{"class":386},[380,4687,955],{"class":386},[380,4689,4690],{"class":394}," db\n",[380,4692,4693,4695,4698,4700],{"class":382,"line":398},[380,4694,3336],{"class":394},[380,4696,4697],{"class":390},"prepare",[380,4699,445],{"class":394},[380,4701,4702],{"class":513},"`\n",[380,4704,4705],{"class":382,"line":412},[380,4706,4707],{"class":513}," SELECT id, body, created_at\n",[380,4709,4710],{"class":382,"line":418},[380,4711,4712],{"class":513}," FROM comments\n",[380,4714,4715],{"class":382,"line":425},[380,4716,4717],{"class":513}," WHERE post_slug = ?1 AND status = 'published'\n",[380,4719,4720],{"class":382,"line":436},[380,4721,4722],{"class":513}," ORDER BY created_at DESC\n",[380,4724,4725],{"class":382,"line":474},[380,4726,4727],{"class":513}," LIMIT 100\n",[380,4729,4730,4733],{"class":382,"line":495},[380,4731,4732],{"class":513}," `",[380,4734,573],{"class":394},[380,4736,4737,4739,4742],{"class":382,"line":526},[380,4738,3336],{"class":394},[380,4740,4741],{"class":390},"bind",[380,4743,4744],{"class":394},"(postSlug)\n",[380,4746,4747,4749,4752],{"class":382,"line":531},[380,4748,3336],{"class":394},[380,4750,4751],{"class":390},"all",[380,4753,492],{"class":394},[16,4755,4756],{},"パラメータ binding は単なるコードスタイルではなく、入力境界の一部です。記事パス、メールアドレス、表示名、コメント本文はいずれもユーザー由来です。どの値も SQL 文字列へ連結してはいけません。",[78,4758,4759],{"id":4759},"セッションには不可逆なダイジェストだけを保存する",[16,4761,4762],{},"ログインに成功すると、ブラウザはランダムなセッショントークンを受け取ります。一方、データベースに保存するのは SHA-256 ダイジェストだけです。セッションテーブルが誤って公開されても、元のトークンをそのままログインに利用することはできません。",[146,4764,4766],{"className":374,"code":4765,"language":376,"meta":152,"style":152},"const token = createRandomToken()\nconst tokenHash = await sha256(token)\n\nawait db\n .prepare('INSERT INTO sessions (token_hash, user_id, expires_at) VALUES (?1, ?2, ?3)')\n .bind(tokenHash, userId, expiresAt)\n .run()\n",[20,4767,4768,4782,4799,4803,4809,4822,4831],{"__ignoreMap":152},[380,4769,4770,4772,4775,4777,4780],{"class":382,"line":383},[380,4771,1474],{"class":386},[380,4773,4774],{"class":408}," token",[380,4776,483],{"class":386},[380,4778,4779],{"class":390}," createRandomToken",[380,4781,492],{"class":394},[380,4783,4784,4786,4789,4791,4793,4796],{"class":382,"line":398},[380,4785,1474],{"class":386},[380,4787,4788],{"class":408}," tokenHash",[380,4790,483],{"class":386},[380,4792,955],{"class":386},[380,4794,4795],{"class":390}," sha256",[380,4797,4798],{"class":394},"(token)\n",[380,4800,4801],{"class":382,"line":412},[380,4802,422],{"emptyLinePlaceholder":421},[380,4804,4805,4807],{"class":382,"line":418},[380,4806,1580],{"class":386},[380,4808,4690],{"class":394},[380,4810,4811,4813,4815,4817,4820],{"class":382,"line":425},[380,4812,3336],{"class":394},[380,4814,4697],{"class":390},[380,4816,445],{"class":394},[380,4818,4819],{"class":513},"'INSERT INTO sessions (token_hash, user_id, expires_at) VALUES (?1, ?2, ?3)'",[380,4821,573],{"class":394},[380,4823,4824,4826,4828],{"class":382,"line":436},[380,4825,3336],{"class":394},[380,4827,4741],{"class":390},[380,4829,4830],{"class":394},"(tokenHash, userId, expiresAt)\n",[380,4832,4833,4835,4838],{"class":382,"line":474},[380,4834,3336],{"class":394},[380,4836,4837],{"class":390},"run",[380,4839,492],{"class":394},[16,4841,4842,4843,4846,4847,4850,4851,4854],{},"Cookie には ",[20,4844,4845],{},"HttpOnly"," を設定してフロントエンド JavaScript から読めないようにし、",[20,4848,4849],{},"SameSite=Lax"," でクロスサイトリクエストのリスクを下げ、本番環境ではさらに ",[20,4852,4853],{},"Secure"," を付けます。",[16,4856,4857],{},"これでシステムが「絶対に安全」になるわけではありません。より正確には、各レイヤーが仕事に必要な最小限の能力だけを持つようにしています。",[78,4859,4860],{"id":4860},"一貫性はユーザー操作を中心に設計する",[16,4862,4863],{},"D1 はリレーショナルデータベースですが、エッジアプリケーションでも、どのフローが強い一貫性を必要とするかを明確にする必要があります。",[16,4865,4866],{},"ブログの重要な操作は多くありません。",[336,4868,4869,4872,4875],{},[43,4870,4871],{},"登録直後にログインできること。",[43,4873,4874],{},"コメント送信の成功直後に現在のページへ表示されること。",[43,4876,4877],{},"ログアウト直後に古いセッションが無効になること。",[16,4879,4880],{},"これらのフローは、同じプライマリデータベースに書き込み、その直後の読み取りもそこから行うべきです。記事一覧や公開コメント一覧などの読み取り専用の場面にこそ、より大きなキャッシュ余地があります。",[16,4882,4883],{},"「どこをキャッシュできるか」ではなく、「ユーザーが今完了した約束は何か」から考えます。",[78,4885,4886],{"id":4886},"障害にもプロダクト設計が必要",[16,4888,4889],{},"エッジランタイムは失敗することがあり、データベースも一時的に利用できなくなることがあります。違いは、その失敗をユーザーが理解できる状態に変えられるかどうかです。",[40,4891,4892,4895,4898,4901],{},[43,4893,4894],{},"ログイン失敗時は「メールアドレスが存在しない」と「パスワードが違う」を区別せず、アカウント列挙を防ぎます。",[43,4896,4897],{},"コメント書き込みに失敗したら入力内容を保持し、再試行できるようにします。",[43,4899,4900],{},"コンテンツ取得に失敗したら、空白ページではなく正しいエラー状態を返します。",[43,4902,4903],{},"サーバーエラーは構造化ログに記録しますが、内部 SQL やスタックトレースをブラウザへ返しません。",[16,4905,4906],{},"信頼性とは「絶対に失敗しない」ことではなく、失敗が起きても境界が壊れないことです。",[78,4908,4910],{"id":4909},"最後に退屈なアーキテクチャを保つ","最後に、退屈なアーキテクチャを保つ",[16,4912,4913],{},"この構成にはメッセージキューも、分散ロックも、追加の認証サービスもありません。それらに価値がないからではなく、現在の問題がまだ必要としていないからです。",[16,4915,4916],{},"長期的に保守しやすい個人サイトの基礎は、たいてい次のようにシンプルです。",[40,4918,4919,4922,4925,4928,4931],{},[43,4920,4921],{},"コンテンツは Git とともに管理する。",[43,4923,4924],{},"実行時データは D1 に保存する。",[43,4926,4927],{},"シークレットは Worker secret に置く。",[43,4929,4930],{},"入力は境界で検証する。",[43,4932,4933],{},"障害を明確にし、観測可能かつ復旧可能にする。",[16,4935,4936,4937],{},"トラフィックやプロダクト要件が本当に変化したときに、証拠に合わせてアーキテクチャを進化させれば十分です。",[31,4938,4939],{},"エッジはすでに十分高速です。エンジニアリングの仕事は、その単純さを保つことです。",[2471,4941,4942],{},"html pre.shiki code .suv1-, html code.shiki .suv1-{--shiki-default:#E1E4E8;--shiki-dark:#E1E4E8}html pre.shiki code .s8ozJ, html code.shiki .s8ozJ{--shiki-default:#79B8FF;--shiki-dark:#79B8FF}html pre.shiki code .s4wv1, html code.shiki .s4wv1{--shiki-default:#9ECBFF;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sOPea, html code.shiki .sOPea{--shiki-default:#F97583;--shiki-dark:#F97583}html pre.shiki code .sFR8T, html code.shiki .sFR8T{--shiki-default:#B392F0;--shiki-dark:#B392F0}",{"title":152,"searchDepth":412,"depth":412,"links":4944},[4945,4946,4947,4948,4949,4950],{"id":4527,"depth":398,"text":4527},{"id":4594,"depth":398,"text":4595},{"id":4759,"depth":398,"text":4759},{"id":4860,"depth":398,"text":4860},{"id":4886,"depth":398,"text":4886},{"id":4909,"depth":398,"text":4910},"Cloudflare Workers は高速で D1 は近くにあります。しかし本当に難しいのは、状態、一貫性、障害の境界を明確に設計することです。",{"src":4953,"alt":4954,"caption":4955,"width":2515,"height":2516},"\u002Fmedia\u002Fposts\u002Fedge-stateful-apps\u002Fcover-v1.webp","中央のデータベースを囲むエッジノードがステートフルなアプリケーショントポロジーを構成している","状態、エッジノード、一貫性の境界",{},"\u002Fblog\u002Fedge-stateful-apps","2026-07-21",{"title":4512,"description":4951},"blog\u002Fedge-stateful-apps",[2523,4566,4962],"エンジニアリング","2026-07-24","45JW9j2ScEo7kmmOD41SBwFEzTUp3ok22gVd9dOmZ9k",{"id":4966,"title":4967,"accent":2538,"body":4968,"description":5353,"draft":2508,"experience":2509,"extension":2510,"featured":2508,"image":5354,"meta":5358,"navigation":421,"path":5359,"publishedAt":5360,"readingTime":436,"seo":5361,"stem":5362,"tags":5363,"updatedAt":2509,"video":2509,"__hash__":5366,"contentLocale":6,"isFallback":2508},"posts_ja\u002Fblog\u002Fnuxt-4-architecture-subtraction.md","Nuxt 4 におけるアーキテクチャの引き算",{"type":13,"value":4969,"toc":5345},[4970,4973,4980,4984,4987,5038,5041,5048,5051,5054,5178,5181,5199,5202,5205,5208,5211,5214,5219,5223,5230,5236,5239,5242,5245,5248,5313,5316,5319,5322,5339,5342],[16,4971,4972],{},"Nuxt プロジェクトが複雑になる理由は、ビジネスが本当に複雑だからとは限りません。あらゆる将来の可能性を、あまりに早くアーキテクチャへ入れてしまうことがよくあります。",[16,4974,4975,4976,4979],{},"個人ブログは良い調整基準になります。ページ数は限られ、コンテンツ構造は安定し、インタラクションは少数の領域に集中しています。フレームワークの最も価値ある役割は、機能を増やすことではなく、",[31,4977,4978],{},"不要な選択肢を削除すること","だと気づかせてくれます。",[78,4981,4983],{"id":4982},"デフォルトの-ssr-から始める","デフォルトの SSR から始める",[16,4985,4986],{},"技術記事は検索エンジンに理解される必要があり、低速な回線でも本文をできるだけ早く表示したいものです。Nuxt のデフォルトであるサーバーサイドレンダリングは、その目的に合っています。",[146,4988,4991],{"className":374,"code":4989,"filename":4990,"language":376,"meta":152,"style":152},"export default defineNuxtConfig({\n modules: ['@nuxt\u002Fcontent'],\n nitro: {\n preset: 'cloudflare',\n },\n})\n","nuxt.config.ts",[20,4992,4993,5004,5015,5020,5030,5034],{"__ignoreMap":152},[380,4994,4995,4997,4999,5002],{"class":382,"line":383},[380,4996,428],{"class":386},[380,4998,431],{"class":386},[380,5000,5001],{"class":390}," defineNuxtConfig",[380,5003,978],{"class":394},[380,5005,5006,5009,5012],{"class":382,"line":398},[380,5007,5008],{"class":394}," modules: [",[380,5010,5011],{"class":513},"'@nuxt\u002Fcontent'",[380,5013,5014],{"class":394},"],\n",[380,5016,5017],{"class":382,"line":412},[380,5018,5019],{"class":394}," nitro: {\n",[380,5021,5022,5025,5028],{"class":382,"line":418},[380,5023,5024],{"class":394}," preset: ",[380,5026,5027],{"class":513},"'cloudflare'",[380,5029,666],{"class":394},[380,5031,5032],{"class":382,"line":425},[380,5033,739],{"class":394},[380,5035,5036],{"class":382,"line":436},[380,5037,1523],{"class":394},[16,5039,5040],{},"サイト全体を SPA に変える必要も、ページごとに別のデータ取得方法を発明する必要もありません。最初のクエリとレンダリングはサーバーで完了し、クライアントが引き継いだ後も同じルーターを使います。",[16,5042,5043,5044,5047],{},"ブラウザ API に依存する小さな領域だけ、局所的に ",[20,5045,5046],{},"ClientOnly"," を使えば十分です。一つのクライアントコンポーネントのために、ページ全体のセマンティクスとファーストビューを犠牲にしてはいけません。",[78,5049,5050],{"id":5050},"コンテンツクエリをページ境界に置く",[16,5052,5053],{},"ホーム、記事一覧、記事詳細では必要なデータ粒度が異なります。クエリは利用するページの近くに置きます。",[146,5055,5057],{"className":374,"code":5056,"language":376,"meta":152,"style":152},"const { data: posts } = await useAsyncData('latest-posts', () => {\n return queryCollection('posts')\n .where('draft', '=', false)\n .order('publishedAt', 'DESC')\n .limit(6)\n .all()\n})\n",[20,5058,5059,5094,5108,5133,5152,5166,5174],{"__ignoreMap":152},[380,5060,5061,5063,5065,5068,5070,5073,5075,5077,5079,5082,5084,5087,5090,5092],{"class":382,"line":383},[380,5062,1474],{"class":386},[380,5064,1562],{"class":394},[380,5066,5067],{"class":401},"data",[380,5069,4628],{"class":394},[380,5071,5072],{"class":408},"posts",[380,5074,1567],{"class":394},[380,5076,1570],{"class":386},[380,5078,955],{"class":386},[380,5080,5081],{"class":390}," useAsyncData",[380,5083,445],{"class":394},[380,5085,5086],{"class":513},"'latest-posts'",[380,5088,5089],{"class":394},", () ",[380,5091,1552],{"class":386},[380,5093,395],{"class":394},[380,5095,5096,5098,5101,5103,5106],{"class":382,"line":398},[380,5097,1743],{"class":386},[380,5099,5100],{"class":390}," queryCollection",[380,5102,445],{"class":394},[380,5104,5105],{"class":513},"'posts'",[380,5107,573],{"class":394},[380,5109,5110,5113,5116,5118,5121,5123,5126,5128,5131],{"class":382,"line":412},[380,5111,5112],{"class":394}," .",[380,5114,5115],{"class":390},"where",[380,5117,445],{"class":394},[380,5119,5120],{"class":513},"'draft'",[380,5122,451],{"class":394},[380,5124,5125],{"class":513},"'='",[380,5127,451],{"class":394},[380,5129,5130],{"class":408},"false",[380,5132,573],{"class":394},[380,5134,5135,5137,5140,5142,5145,5147,5150],{"class":382,"line":418},[380,5136,5112],{"class":394},[380,5138,5139],{"class":390},"order",[380,5141,445],{"class":394},[380,5143,5144],{"class":513},"'publishedAt'",[380,5146,451],{"class":394},[380,5148,5149],{"class":513},"'DESC'",[380,5151,573],{"class":394},[380,5153,5154,5156,5159,5161,5164],{"class":382,"line":425},[380,5155,5112],{"class":394},[380,5157,5158],{"class":390},"limit",[380,5160,445],{"class":394},[380,5162,5163],{"class":408},"6",[380,5165,573],{"class":394},[380,5167,5168,5170,5172],{"class":382,"line":436},[380,5169,5112],{"class":394},[380,5171,4751],{"class":390},[380,5173,492],{"class":394},[380,5175,5176],{"class":382,"line":474},[380,5177,1523],{"class":394},[16,5179,5180],{},"この方法には直接的な利点があります。",[40,5182,5183,5190,5193,5196],{},[43,5184,5185,5186,5189],{},"データが SSR に参加し、",[20,5187,5188],{},"onMounted"," 後に点滅しながら表示されません。",[43,5191,5192],{},"クエリキーが明確なので、Nuxt は hydration 時に payload を再利用できます。",[43,5194,5195],{},"ページ自身が必要なものを理解し、汎用 store を経由する必要がありません。",[43,5197,5198],{},"下書きの除外と並び順が、本当に関係する場所に現れます。",[16,5200,5201],{},"複数のページが同じ複雑な業務状態を共有するようになったときにだけ、composable や store へ抽出する価値があります。",[78,5203,5204],{"id":5204},"安定して繰り返すものだけをコンポーネント化する",[16,5206,5207],{},"「再利用できそう」はコンポーネント境界ではありません。本当に安定した繰り返しには、通常、構造、意味、動作が同時に含まれます。",[16,5209,5210],{},"このブログでは記事カードが適切なコンポーネントです。ホームと一覧ページの両方に現れ、メタデータ、タイトル、概要、タグ、遷移動作が固定されています。",[16,5212,5213],{},"一方、ホームの Hero は大きくても、必ずしも五つの小さなコンポーネントへ分割する必要はありません。一つのページにしか現れず、内部要素がまとまって一つの視覚的な物語を作ります。早すぎる分割は、スタイルの関係を複数ファイルへ散らすだけです。",[72,5215,5216],{},[16,5217,5218],{},"コンポーネントはファイル整理の道具ではなく、独立して理解し再利用できる UI 契約です。",[78,5220,5222],{"id":5221},"サーバー-api-のインターフェースを狭く保つ","サーバー API のインターフェースを狭く保つ",[16,5224,5225,5226,5229],{},"ログインとコメントは実行時データなので ",[20,5227,5228],{},"server\u002Fapi"," に置きます。各 endpoint は一つの仕事だけを行います。",[146,5231,5234],{"className":5232,"code":5233,"language":151,"meta":152},[149],"POST \u002Fapi\u002Fauth\u002Fregister\nPOST \u002Fapi\u002Fauth\u002Flogin\nPOST \u002Fapi\u002Fauth\u002Flogout\nGET \u002Fapi\u002Fauth\u002Fsession\nGET \u002Fapi\u002Fcomments\u002F:post\nPOST \u002Fapi\u002Fcomments\u002F:post\n",[20,5235,5233],{"__ignoreMap":152},[16,5237,5238],{},"狭いインターフェースは認可規則を確認しやすくします。コメントの読み取りは公開、作成にはセッションが必要、ログアウトはユーザープロフィールに触れず現在のトークンだけを破棄します。",[16,5240,5241],{},"一つの endpoint が読み取り、書き込み、ログイン、形式変換を同時に扱うなら、すでに明確な境界を失っています。",[78,5243,5244],{"id":5244},"状態を正しい場所へ戻す",[16,5246,5247],{},"Vue のリアクティブな状態は便利ですが、すべての状態を JavaScript に置くべきではありません。",[86,5249,5250,5259],{},[89,5251,5252],{},[92,5253,5254,5256],{},[95,5255,4539],{},[95,5257,5258],{},"最適な場所",[108,5260,5261,5269,5279,5287,5298,5305],{},[92,5262,5263,5266],{},[113,5264,5265],{},"現在の記事",[113,5267,5268],{},"ルート",[92,5270,5271,5274],{},[113,5272,5273],{},"検索語",[113,5275,5276,5277],{},"ページの ",[20,5278,2553],{},[92,5280,5281,5284],{},[113,5282,5283],{},"タグ絞り込み",[113,5285,5286],{},"URL query + ページ状態",[92,5288,5289,5292],{},[113,5290,5291],{},"ログインユーザー",[113,5293,5294,5295],{},"SSR 安全な ",[20,5296,5297],{},"useState",[92,5299,5300,5302],{},[113,5301,4552],{},[113,5303,5304],{},"Nuxt Content",[92,5306,5307,5310],{},[113,5308,5309],{},"セッションの真正性",[113,5311,5312],{},"サーバー側の D1",[16,5314,5315],{},"状態を正しい場所へ置けば、大量の「同期ロジック」が自然に消えます。ルートを監視して store を修復する必要も、localStorage でログイン状態が信頼できるふりをする必要もなくなります。",[78,5317,5318],{"id":5318},"引き算は機能を減らすことではない",[16,5320,5321],{},"良いアーキテクチャの引き算は、ユーザーから何も奪いません。むしろ、ユーザーが実際に感じる部分へ複雑さの予算を残します。",[40,5323,5324,5327,5330,5333,5336],{},[43,5325,5326],{},"より明確なタイポグラフィ。",[43,5328,5329],{},"より速いファーストビュー。",[43,5331,5332],{},"より信頼できるログイン。",[43,5334,5335],{},"より快適なモバイル読書。",[43,5337,5338],{},"続けやすい Markdown 執筆フロー。",[16,5340,5341],{},"Nuxt 4 には十分な機能があります。成熟したプロジェクトとは、それらをすべて使うものではなく、今は使わなくてよい機能を知っているものです。",[2471,5343,5344],{},"html pre.shiki code .sOPea, html code.shiki .sOPea{--shiki-default:#F97583;--shiki-dark:#F97583}html pre.shiki code .sFR8T, html code.shiki .sFR8T{--shiki-default:#B392F0;--shiki-dark:#B392F0}html pre.shiki code .suv1-, html code.shiki .suv1-{--shiki-default:#E1E4E8;--shiki-dark:#E1E4E8}html pre.shiki code .s4wv1, html code.shiki .s4wv1{--shiki-default:#9ECBFF;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s-3mD, html code.shiki .s-3mD{--shiki-default:#FFAB70;--shiki-dark:#FFAB70}html pre.shiki code .s8ozJ, html code.shiki .s8ozJ{--shiki-default:#79B8FF;--shiki-dark:#79B8FF}",{"title":152,"searchDepth":412,"depth":412,"links":5346},[5347,5348,5349,5350,5351,5352],{"id":4982,"depth":398,"text":4983},{"id":5050,"depth":398,"text":5050},{"id":5204,"depth":398,"text":5204},{"id":5221,"depth":398,"text":5222},{"id":5244,"depth":398,"text":5244},{"id":5318,"depth":398,"text":5318},"コンテンツ中心のサイトに複雑なフロントエンド状態は不要です。ルーティング、SSR、コンテンツクエリを、それぞれ得意な場所へ戻します。",{"src":5355,"alt":5356,"caption":5357,"width":2515,"height":2516},"\u002Fmedia\u002Fposts\u002Fnuxt-4-architecture-subtraction\u002Fcover-v1.webp","複雑なモジュールが明確でコンパクトな Nuxt アプリケーションの中心へ収束していく","アーキテクチャの引き算で境界を明確にする",{},"\u002Fblog\u002Fnuxt-4-architecture-subtraction","2026-07-16",{"title":4967,"description":5353},"blog\u002Fnuxt-4-architecture-subtraction",[5364,4247,5365],"Nuxt","アーキテクチャ","ssY4mnEKHetrOcAiq0xs3OxgnqvkR3kHHmApyaxbxhc",{"id":5368,"title":5369,"accent":4254,"body":5370,"description":5718,"draft":2508,"experience":2509,"extension":2510,"featured":2508,"image":5719,"meta":5723,"navigation":421,"path":5724,"publishedAt":5725,"readingTime":474,"seo":5726,"stem":5727,"tags":5728,"updatedAt":2509,"video":2509,"__hash__":5730,"contentLocale":6,"isFallback":2508},"posts_ja\u002Fblog\u002Fobservable-ai-systems.md","AI システムの可観測性は Token の請求書だけではない",{"type":13,"value":5371,"toc":5705},[5372,5375,5380,5383,5386,5389,5393,5396,5400,5403,5407,5410,5414,5417,5420,5424,5431,5545,5548,5551,5568,5571,5574,5577,5631,5634,5637,5640,5657,5660,5663,5666,5669,5683,5686,5690,5693,5699,5702],[16,5373,5374],{},"従来のサービスで問題が起きたとき、私たちはステータスコード、レイテンシ、エラースタックを確認します。AI アプリケーションでもこれらの指標は重要ですが、最も大切な問いに答えるには不十分なことがよくあります。",[16,5376,5377],{},[31,5378,5379],{},"モデルはなぜこの選択をしたのか。",[16,5381,5382],{},"答えは一つのログにはありません。ユーザーの目標、コンテキストの組み立て、モデルの判断、ツールの実行、最終結果までのチェーン全体にあります。",[78,5384,5385],{"id":5385},"まず四種類の失敗を区別する",[16,5387,5388],{},"すべての失敗を「モデルの性能が悪い」と記録してしまうと、チームは具体的な行動を取れません。少なくとも次の四つを区別する必要があります。",[185,5390,5392],{"id":5391},"_1-入力の失敗","1. 入力の失敗",[16,5394,5395],{},"ユーザーの目標が不完全、またはタスクの完了に必要なコンテキストをシステムが取得できていません。この場合、モデルをアップグレードしても通常は解決しません。",[185,5397,5399],{"id":5398},"_2-推論の失敗","2. 推論の失敗",[16,5401,5402],{},"コンテキストは正しいものの、モデルが誤った経路を選び、制約を見落とし、あるいは早すぎる結論に到達しています。",[185,5404,5406],{"id":5405},"_3-ツールの失敗","3. ツールの失敗",[16,5408,5409],{},"モデルの選択は正しいものの、権限、ネットワーク、パラメータ、外部状態などの理由で実行に失敗しています。",[185,5411,5413],{"id":5412},"_4-伝達の失敗","4. 伝達の失敗",[16,5415,5416],{},"内部の作業は完了しているのに、最終回答が結果、制約、次のステップを明確に説明できていません。",[16,5418,5419],{},"これら四つの問題は、プロダクト、プロンプト設計、プラットフォームエンジニアリング、インタラクション設計という異なる担当者を必要とします。可観測性の最初の価値は、問題を正しい人へ戻すことです。",[78,5421,5423],{"id":5422},"一つの実行には共通の-trace-が必要","一つの実行には共通の Trace が必要",[16,5425,5426,5427,5430],{},"各ユーザーリクエストには安定した ",[20,5428,5429],{},"trace_id"," を割り当て、モデル呼び出しとツール実行をつなぎます。",[146,5432,5434],{"className":374,"code":5433,"language":376,"meta":152,"style":152},"type AgentEvent = {\n traceId: string\n spanId: string\n parentSpanId?: string\n type: 'model' | 'tool' | 'handoff' | 'result'\n startedAt: string\n durationMs?: number\n status: 'running' | 'ok' | 'error'\n}\n",[20,5435,5436,5448,5457,5466,5476,5502,5511,5521,5541],{"__ignoreMap":152},[380,5437,5438,5441,5444,5446],{"class":382,"line":383},[380,5439,5440],{"class":386},"type",[380,5442,5443],{"class":390}," AgentEvent",[380,5445,483],{"class":386},[380,5447,395],{"class":394},[380,5449,5450,5453,5455],{"class":382,"line":398},[380,5451,5452],{"class":401}," traceId",[380,5454,405],{"class":386},[380,5456,409],{"class":408},[380,5458,5459,5462,5464],{"class":382,"line":412},[380,5460,5461],{"class":401}," spanId",[380,5463,405],{"class":386},[380,5465,409],{"class":408},[380,5467,5468,5471,5474],{"class":382,"line":418},[380,5469,5470],{"class":401}," parentSpanId",[380,5472,5473],{"class":386},"?:",[380,5475,409],{"class":408},[380,5477,5478,5481,5483,5486,5489,5492,5494,5497,5499],{"class":382,"line":425},[380,5479,5480],{"class":401}," type",[380,5482,405],{"class":386},[380,5484,5485],{"class":513}," 'model'",[380,5487,5488],{"class":386}," |",[380,5490,5491],{"class":513}," 'tool'",[380,5493,5488],{"class":386},[380,5495,5496],{"class":513}," 'handoff'",[380,5498,5488],{"class":386},[380,5500,5501],{"class":513}," 'result'\n",[380,5503,5504,5507,5509],{"class":382,"line":436},[380,5505,5506],{"class":401}," startedAt",[380,5508,405],{"class":386},[380,5510,409],{"class":408},[380,5512,5513,5516,5518],{"class":382,"line":474},[380,5514,5515],{"class":401}," durationMs",[380,5517,5473],{"class":386},[380,5519,5520],{"class":408}," number\n",[380,5522,5523,5526,5528,5531,5533,5536,5538],{"class":382,"line":495},[380,5524,5525],{"class":401}," status",[380,5527,405],{"class":386},[380,5529,5530],{"class":513}," 'running'",[380,5532,5488],{"class":386},[380,5534,5535],{"class":513}," 'ok'",[380,5537,5488],{"class":386},[380,5539,5540],{"class":513}," 'error'\n",[380,5542,5543],{"class":382,"line":526},[380,5544,415],{"class":394},[16,5546,5547],{},"ツール呼び出しは、モデル判断の外部表現です。呼び出した理由を残さず戻り値だけを記録すると判断コンテキストを失います。プロンプトだけを保存してツール結果を残さなければ、実行が意図どおりだったか判断できません。",[16,5549,5550],{},"観測は無制限な収集を意味しません。生のプロンプトには個人情報、認証情報、業務データが含まれる可能性があります。より安全な方法は次のとおりです。",[40,5552,5553,5556,5559,5562,5565],{},[43,5554,5555],{},"デフォルトでは構造化メタデータを記録する。",[43,5557,5558],{},"本文はフィールド単位でマスキングする。",[43,5560,5561],{},"デバッグ用サンプルには短い保存期間を設定する。",[43,5563,5564],{},"ユーザーや事業者が学習・分析への不参加を明示的に選べるようにする。",[43,5566,5567],{},"ログにシークレットや完全な個人識別情報を保存しない。",[78,5569,5570],{"id":5570},"品質指標をタスクに近づける",[16,5572,5573],{},"Token、レイテンシ、モデルエラー率はプラットフォーム指標ですが、ユーザーが結果を得られたかは示せません。",[16,5575,5576],{},"コード修正 Agent にとって、より意味のある指標は次のようなものです。",[86,5578,5579,5589],{},[89,5580,5581],{},[92,5582,5583,5586],{},[95,5584,5585],{},"レイヤー",[95,5587,5588],{},"指標の例",[108,5590,5591,5599,5607,5615,5623],{},[92,5592,5593,5596],{},[113,5594,5595],{},"結果",[113,5597,5598],{},"影響を受けるテストが通ったか",[92,5600,5601,5604],{},[113,5602,5603],{},"プロセス",[113,5605,5606],{},"関連する制約ファイルを読んだか",[92,5608,5609,5612],{},[113,5610,5611],{},"安全性",[113,5613,5614],{},"タスク範囲外のファイルを変更していないか",[92,5616,5617,5620],{},[113,5618,5619],{},"効率",[113,5621,5622],{},"有効なツール呼び出し \u002F 全ツール呼び出し",[92,5624,5625,5628],{},[113,5626,5627],{},"伝達",[113,5629,5630],{},"検証可能なファイルやコミットを提供したか",[16,5632,5633],{},"単なる呼び出し回数より「有効なツール呼び出し」が重要です。一度の正確な検索が、十回の推測的な読み取りを置き換えることがあります。",[78,5635,5636],{"id":5636},"評価を日常的なフィードバックへ変える",[16,5638,5639],{},"オフライン benchmark はモデルのバージョン比較には役立ちますが、実際のワークフローすべてを網羅できません。持続可能な評価セットは、本番環境の価値あるサンプルから作ります。",[336,5641,5642,5645,5648,5651,5654],{},[43,5643,5644],{},"明確に成功した実行と明確に失敗した実行を集める。",[43,5646,5647],{},"判断構造を保ちながら個人情報を削除する。",[43,5649,5650],{},"総合点だけでなく、失敗の種類をラベル付けする。",[43,5652,5653],{},"プロンプト、モデル、ツールを変更したときに再実行する。",[43,5655,5656],{},"結果品質、コスト、レイテンシを同時に比較する。",[16,5658,5659],{},"評価セットは最初から大規模である必要はありません。境界が明確で安定して再現できる二十件のケースは、出所が曖昧な二千件のサンプルよりも、エンジニアリングを導くことがあります。",[78,5661,5662],{"id":5662},"人のための可観測性",[16,5664,5665],{},"最後の観測レイヤーはダッシュボードではなく、プロダクトの画面にあります。",[16,5667,5668],{},"Agent がファイルを読み、承認を待ち、デプロイを実行しているとき、ユーザーはどの段階にいるのかを知る必要があります。良いステータス更新は内部思考を垂れ流すのではなく、次を伝えます。",[40,5670,5671,5674,5677,5680],{},[43,5672,5673],{},"現在何を完了しようとしているか。",[43,5675,5676],{},"すでに何を確認したか。",[43,5678,5679],{},"ユーザーの行動が必要か。",[43,5681,5682],{},"どのリスクがまだ残っているか。",[16,5684,5685],{},"この可視性は、システムの信頼性に対するユーザーの判断を直接変えます。数十秒かかっても過程が明確なタスクは、十秒後に突然不透明な結果を返すタスクより安心できることがあります。",[78,5687,5689],{"id":5688},"説明可能であることはすべてを公開することではない","説明可能であることは、すべてを公開することではない",[16,5691,5692],{},"AI システムは内部のすべての token をユーザーへ見せる必要はなく、機密コンテキストをそのままログに書くべきでもありません。必要なのは、十分に明確な因果チェーンです。",[146,5694,5697],{"className":5695,"code":5696,"language":151,"meta":152},[149],"ユーザーの目標\n → どのコンテキストを使ったか\n → どのツールを選んだか\n → ツールがどの状態を返したか\n → 最終的にどの結果を届けたか\n",[20,5698,5696],{"__ignoreMap":152},[16,5700,5701],{},"このチェーンを検索、比較、再現できるようになって初めて、チームは「時々とても賢い」を「長期的に信頼できる」へ変えられます。",[2471,5703,5704],{},"html pre.shiki code .sOPea, html code.shiki .sOPea{--shiki-default:#F97583;--shiki-dark:#F97583}html pre.shiki code .sFR8T, html code.shiki .sFR8T{--shiki-default:#B392F0;--shiki-dark:#B392F0}html pre.shiki code .suv1-, html code.shiki .suv1-{--shiki-default:#E1E4E8;--shiki-dark:#E1E4E8}html pre.shiki code .s-3mD, html code.shiki .s-3mD{--shiki-default:#FFAB70;--shiki-dark:#FFAB70}html pre.shiki code .s8ozJ, html code.shiki .s8ozJ{--shiki-default:#79B8FF;--shiki-dark:#79B8FF}html pre.shiki code .s4wv1, html code.shiki .s4wv1{--shiki-default:#9ECBFF;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":152,"searchDepth":412,"depth":412,"links":5706},[5707,5713,5714,5715,5716,5717],{"id":5385,"depth":398,"text":5385,"children":5708},[5709,5710,5711,5712],{"id":5391,"depth":412,"text":5392},{"id":5398,"depth":412,"text":5399},{"id":5405,"depth":412,"text":5406},{"id":5412,"depth":412,"text":5413},{"id":5422,"depth":398,"text":5423},{"id":5570,"depth":398,"text":5570},{"id":5636,"depth":398,"text":5636},{"id":5662,"depth":398,"text":5662},{"id":5688,"depth":398,"text":5689},"プロンプト、ツール呼び出し、ユーザーに見える結果まで、AI アプリケーションには「なぜ」を説明できる観測チェーンが必要です。",{"src":5720,"alt":5721,"caption":5722,"width":2515,"height":2516},"\u002Fmedia\u002Fposts\u002Fobservable-ai-systems\u002Fcover-v1.webp","AI リクエストが入力からモデルとツールのノードを通り、完全な観測チェーンを形成している","プロンプトから結果までを説明できる Trace",{},"\u002Fblog\u002Fobservable-ai-systems","2026-07-09",{"title":5369,"description":5718},"blog\u002Fobservable-ai-systems",[4506,5729,4962],"可観測性","t0LYdTk81d8m4r5OxPnfA9rpTh4e3hfr1sF49X_xm5o",1785385297791]