[{"rendered_body":"\u003cp data-sourcepos=\"1:1-1:268\"\u003eCustom patches are a creative and affordable way to personalise clothing, promote businesses and showcase unique designs. Whether you're a clothing brand, sports team, school or business owner, personalised patches help create a professional and recognisable identity.\u003c/p\u003e\n\u003cp data-sourcepos=\"3:1-5:75\"\u003eAt Australian Patch, we offer a wide range of custom patches designed to bring your ideas to life with quality materials, detailed craftsmanship and attractive finishes.\u003cbr\u003e\nExplore Our Custom Patch Collection\u003cbr\u003e\nAustralian Patch offers different patch styles to suit your branding needs.\u003c/p\u003e\n\u003col data-sourcepos=\"6:1-18:59\"\u003e\n\u003cli data-sourcepos=\"6:1-7:161\"\u003eCustom Embroidered Patches\u003cbr\u003e\nEmbroidered patches feature colourful thread stitching and textured designs. They're ideal for uniforms, jackets, caps, sports teams and promotional merchandise.\u003c/li\u003e\n\u003cli data-sourcepos=\"8:1-9:134\"\u003eCustom Woven Patches\u003cbr\u003e\nWoven patches provide a smooth finish with fine details, making them perfect for intricate logos, small lettering and clothing labels.\u003c/li\u003e\n\u003cli data-sourcepos=\"10:1-12:47\"\u003eCustom PVC Patches\u003cbr\u003e\nPVC patches are flexible, water-resistant and durable. Their raised designs and vibrant colours make them suitable for outdoor gear, backpacks and uniforms.\u003cbr\u003e\n\u003ca href=\"https://australianpatch.com/product/pvc-patches\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://australianpatch.com/product/pvc-patches\u003c/a\u003e\n\u003c/li\u003e\n\u003cli data-sourcepos=\"13:1-14:103\"\u003eCustom Leather Patches\u003cbr\u003e\nLeather patches add a stylish, premium appearance to denim jackets, caps, bags and fashion accessories.\u003c/li\u003e\n\u003cli data-sourcepos=\"15:1-18:59\"\u003eCustom Iron-On Patches\u003cbr\u003e\nIron-on patches provide a convenient way to personalise compatible clothing and accessories using heat-activated backing.\u003cbr\u003e\nWhy Choose Australian Patch?\u003cbr\u003e\nWe aim to make custom patch ordering simple and convenient.\u003c/li\u003e\n\u003c/ol\u003e\n\u003cul data-sourcepos=\"19:1-25:40\"\u003e\n\u003cli data-sourcepos=\"19:1-19:67\"\u003ePremium Quality: Carefully crafted patches with detailed designs.\u003c/li\u003e\n\u003cli data-sourcepos=\"20:1-20:82\"\u003eCustomisation Options: Choose your preferred shapes, sizes, colours and backing.\u003c/li\u003e\n\u003cli data-sourcepos=\"21:1-21:57\"\u003eAffordable Pricing: Suitable for small and bulk orders.\u003c/li\u003e\n\u003cli data-sourcepos=\"22:1-22:91\"\u003eVersatile Applications: Perfect for businesses, schools, sports teams and fashion brands.\u003c/li\u003e\n\u003cli data-sourcepos=\"23:1-25:40\"\u003eAustralia-Wide Delivery: Custom patches delivered across Australia.\u003cbr\u003e\nHow to Order Custom Patches in Australia\u003cbr\u003e\nOrdering personalised patches is simple:\u003c/li\u003e\n\u003c/ul\u003e\n\u003col data-sourcepos=\"26:1-33:0\"\u003e\n\u003cli data-sourcepos=\"26:1-26:43\"\u003eShare your logo, artwork or design idea.\u003c/li\u003e\n\u003cli data-sourcepos=\"27:1-27:44\"\u003eChoose your patch type, size and colours.\u003c/li\u003e\n\u003cli data-sourcepos=\"28:1-28:44\"\u003eSelect your preferred backing and border.\u003c/li\u003e\n\u003cli data-sourcepos=\"29:1-29:35\"\u003eReview your free digital mockup.\u003c/li\u003e\n\u003cli data-sourcepos=\"30:1-33:0\"\u003eApprove your design for production and delivery.\u003cbr\u003e\nAustralian Patch advertises free artwork assistance, digital proofs and a standard minimum order of 10 patches on its homepage.\u003cbr\u003e\nEmbroidered \u0026amp; PVC Patches\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp data-sourcepos=\"34:1-35:38\"\u003eFrequently Asked Questions\u003cbr\u003e\nCan I create patches with my own logo?\u003c/p\u003e\n\u003cp data-sourcepos=\"37:1-37:87\"\u003eYes! You can personalise patches with company logos, names, artwork and unique designs.\u003c/p\u003e\n\u003cp data-sourcepos=\"39:1-39:43\"\u003eWhich custom patches are best for clothing?\u003c/p\u003e\n\u003cp data-sourcepos=\"41:1-41:111\"\u003eEmbroidered, woven and leather patches are popular choices for jackets, uniforms, caps and fashion accessories.\u003c/p\u003e\n\u003cp data-sourcepos=\"43:1-43:34\"\u003eAre iron-on patches easy to apply?\u003c/p\u003e\n\u003cp data-sourcepos=\"45:1-45:105\"\u003eYes. Iron-on patches use heat-activated adhesive and can be applied to compatible fabrics without sewing.\u003c/p\u003e\n\u003cp data-sourcepos=\"47:1-47:35\"\u003eCan I order custom patches in bulk?\u003c/p\u003e\n\u003cp data-sourcepos=\"49:1-51:258\"\u003eYes. Bulk orders are suitable for businesses, schools, sports teams, clothing brands and events.\u003cbr\u003e\nConclusion\u003cbr\u003e\nCustom patches are an excellent way to express creativity, strengthen brand identity and personalise clothing or accessories. From traditional embroidered patches to modern PVC and premium leather designs, Australian Patch offers options for different needs.\u003c/p\u003e\n\u003cp data-sourcepos=\"53:1-53:44\"\u003eReady to create your perfect custom patches?\u003c/p\u003e\n\u003cp data-sourcepos=\"55:1-56:28\"\u003eVisit Australian Patch today to explore our collection and request your free quote!\u003cbr\u003e\n\u003ca href=\"https://australianpatch.com/\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://australianpatch.com/\u003c/a\u003e\u003c/p\u003e\n","body":"Custom patches are a creative and affordable way to personalise clothing, promote businesses and showcase unique designs. Whether you're a clothing brand, sports team, school or business owner, personalised patches help create a professional and recognisable identity.\n\nAt Australian Patch, we offer a wide range of custom patches designed to bring your ideas to life with quality materials, detailed craftsmanship and attractive finishes.\nExplore Our Custom Patch Collection\nAustralian Patch offers different patch styles to suit your branding needs.\n1. Custom Embroidered Patches\nEmbroidered patches feature colourful thread stitching and textured designs. They're ideal for uniforms, jackets, caps, sports teams and promotional merchandise.\n2. Custom Woven Patches\nWoven patches provide a smooth finish with fine details, making them perfect for intricate logos, small lettering and clothing labels.\n3. Custom PVC Patches\nPVC patches are flexible, water-resistant and durable. Their raised designs and vibrant colours make them suitable for outdoor gear, backpacks and uniforms.\nhttps://australianpatch.com/product/pvc-patches\n4. Custom Leather Patches\nLeather patches add a stylish, premium appearance to denim jackets, caps, bags and fashion accessories.\n5. Custom Iron-On Patches\nIron-on patches provide a convenient way to personalise compatible clothing and accessories using heat-activated backing.\nWhy Choose Australian Patch?\nWe aim to make custom patch ordering simple and convenient.\n- Premium Quality: Carefully crafted patches with detailed designs.\n- Customisation Options: Choose your preferred shapes, sizes, colours and backing.\n- Affordable Pricing: Suitable for small and bulk orders.\n- Versatile Applications: Perfect for businesses, schools, sports teams and fashion brands.\n- Australia-Wide Delivery: Custom patches delivered across Australia.\nHow to Order Custom Patches in Australia\nOrdering personalised patches is simple:\n1. Share your logo, artwork or design idea.\n2. Choose your patch type, size and colours.\n3. Select your preferred backing and border.\n4. Review your free digital mockup.\n5. Approve your design for production and delivery.\nAustralian Patch advertises free artwork assistance, digital proofs and a standard minimum order of 10 patches on its homepage. \nEmbroidered \u0026 PVC Patches\n\nFrequently Asked Questions\nCan I create patches with my own logo?\n\nYes! You can personalise patches with company logos, names, artwork and unique designs.\n\nWhich custom patches are best for clothing?\n\nEmbroidered, woven and leather patches are popular choices for jackets, uniforms, caps and fashion accessories.\n\nAre iron-on patches easy to apply?\n\nYes. Iron-on patches use heat-activated adhesive and can be applied to compatible fabrics without sewing.\n\nCan I order custom patches in bulk?\n\nYes. Bulk orders are suitable for businesses, schools, sports teams, clothing brands and events.\nConclusion\nCustom patches are an excellent way to express creativity, strengthen brand identity and personalise clothing or accessories. From traditional embroidered patches to modern PVC and premium leather designs, Australian Patch offers options for different needs.\n\nReady to create your perfect custom patches?\n\nVisit Australian Patch today to explore our collection and request your free quote!\nhttps://australianpatch.com/\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T03:24:26+09:00","group":null,"id":"c8ef46da93e84f116cbd","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"CUSTOMPATCHES","versions":[]},{"name":"PATCHESINAUSTRALIA","versions":[]}],"title":"Custom Patches Australia: Premium Personalized Patches for Every Purpose","updated_at":"2026-11-18T03:24:26+09:00","url":"https://qiita.com/CUSTOMAUSTRALIANPATCH/items/c8ef46da93e84f116cbd","user":{"description":"Woven patches use fine threadwork to reproduce small text, gradients, and intricate logos with a smooth, flat finish. They're perfect for detailed branding where embroidery would lose definition.\r\n\r\n","facebook_id":"","followees_count":1,"followers_count":0,"github_login_name":null,"id":"CUSTOMAUSTRALIANPATCH","items_count":1,"linkedin_id":"","location":"AUSTRALIA","name":"CUSTOM AUSTRALIAN PATCH","organization":"CUSTOM AUSTRALIAN PATCH","permanent_id":4534224,"profile_image_url":"https://lh3.googleusercontent.com/a/ACg8ocKzRFLMIjfKxf8qRm3hLsO_pKHbNzjHFszOkgEpZZfXTwsdbAs=s96-c","team_only":false,"twitter_screen_name":null,"website_url":"https://australianpatch.com/product/woven-patches"},"page_views_count":null,"team_membership":null,"organization_url_name":null,"slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003ch1 data-sourcepos=\"1:1-1:14\"\u003e\n\u003cspan id=\"はじめに\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eはじめに\u003c/h1\u003e\n\u003cp data-sourcepos=\"2:1-2:360\"\u003eMac OS上にアプリを導入しましたが、エラーが発生しました。原因を特定するためにリクエストとレスポンスの流れを確認しようとしましたが、アプリのためにブラウザで使用できる開発者モードに相当するものがありません。そのため、HTTP Toolkitを使用してみました。\u003c/p\u003e\n\u003ch1 data-sourcepos=\"4:1-4:8\"\u003e\n\u003cspan id=\"環境\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%92%B0%E5%A2%83\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e環境\u003c/h1\u003e\n\u003cp data-sourcepos=\"5:1-6:20\"\u003emacOS Tahoe: 26.6.2\u003cbr\u003e\nHTTP Toolkit: 1.27.4\u003c/p\u003e\n\u003ch1 data-sourcepos=\"8:1-8:20\"\u003e\n\u003cspan id=\"インストール\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eインストール\u003c/h1\u003e\n\u003cp data-sourcepos=\"10:1-10:344\"\u003eProxymanというアプリもあり、当初はそちらをダウンロードしようと思いましたが、有料のようでした。（後で確認したら無料版もあるようです。）そのため、HTTP Toolkitをダウンロードします。無料版と有料版がありますが、無料版をインストールしました。\u003c/p\u003e\n\u003ch1 data-sourcepos=\"12:1-12:8\"\u003e\n\u003cspan id=\"設定\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E8%A8%AD%E5%AE%9A\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e設定\u003c/h1\u003e\n\u003cp data-sourcepos=\"13:1-13:36\"\u003e次に設定をしていきます。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"15:1-15:27\"\u003e\n\u003cspan id=\"ポート番号の確認\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%9D%E3%83%BC%E3%83%88%E7%95%AA%E5%8F%B7%E3%81%AE%E7%A2%BA%E8%AA%8D\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eポート番号の確認\u003c/h2\u003e\n\u003cp data-sourcepos=\"16:1-17:76\"\u003eIntercept \u0026gt; Anythingを確認します。\u003cbr\u003e\nここで表示されるポート番号を確認します。8000でした。\u003c/p\u003e\n\u003cp data-sourcepos=\"19:1-19:155\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F3684675%2F961bc51e-8248-4df8-9ef4-43e684e0bd6a.jpeg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=aa5c4fe2679e4ef17d0c8a3bbc77ef4a\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F3684675%2F961bc51e-8248-4df8-9ef4-43e684e0bd6a.jpeg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=aa5c4fe2679e4ef17d0c8a3bbc77ef4a\" alt=\"Screenshot 2026-11-16 at 4.20.49 PM.jpg\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F3684675%2F961bc51e-8248-4df8-9ef4-43e684e0bd6a.jpeg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=c8137abf442d847eb33f84b0db93cb94 1x\" data-canonical-src=\"https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3684675/961bc51e-8248-4df8-9ef4-43e684e0bd6a.jpeg\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003ch2 data-sourcepos=\"21:1-21:21\"\u003e\n\u003cspan id=\"証明書の追加\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E8%A8%BC%E6%98%8E%E6%9B%B8%E3%81%AE%E8%BF%BD%E5%8A%A0\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e証明書の追加\u003c/h2\u003e\n\u003cp data-sourcepos=\"22:1-22:114\"\u003e次に、書き出した証明書をダブルクリックし、キーチェーンアクセスに追加します。\u003c/p\u003e\n\u003cp data-sourcepos=\"24:1-24:99\"\u003eしかし、うまく行きませんでした。以下を実行するとうまく動きました。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"25:1-27:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003esudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain ~/Library/Preferences/httptoolkit/ca.pem\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"28:1-28:111\"\u003eHTTP Toolkitの証明書がシステムのキーチェーンに「常に信頼」として登録されます。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"31:1-31:32\"\u003e\n\u003cspan id=\"macosのプロキシを設定\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#macos%E3%81%AE%E3%83%97%E3%83%AD%E3%82%AD%E3%82%B7%E3%82%92%E8%A8%AD%E5%AE%9A\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003emacOSのプロキシを設定\u003c/h2\u003e\n\u003cp data-sourcepos=\"32:1-32:41\"\u003emacOSのプロキシを設定します。\u003c/p\u003e\n\u003cp data-sourcepos=\"34:1-36:71\"\u003e「システム設定」→「ネットワーク」→ 使っている接続（Wi‑Fiなど）→「詳細…」→「プロキシ」を開きます。\u003cbr\u003e\n「Webプロキシ（HTTP）」をオン：サーバ 127.0.0.1、ポートは先ほどの番号(8000)\u003cbr\u003e\n「保護されたWebプロキシ（HTTPS）」をオン：同じ設定\u003c/p\u003e\n\u003cp data-sourcepos=\"38:1-38:155\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F3684675%2Fe645e3be-0a37-4049-9343-59025f8a787e.jpeg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=428420b356b280195a78acd4e3397d6a\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F3684675%2Fe645e3be-0a37-4049-9343-59025f8a787e.jpeg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=428420b356b280195a78acd4e3397d6a\" alt=\"Screenshot 2026-11-16 at 4.25.21 PM.jpg\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F3684675%2Fe645e3be-0a37-4049-9343-59025f8a787e.jpeg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=dc91fdf583b14b390e97424e0ff1e5b1 1x\" data-canonical-src=\"https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3684675/e645e3be-0a37-4049-9343-59025f8a787e.jpeg\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cdiv data-sourcepos=\"41:1-46:3\" class=\"note info\"\u003e\n\u003cspan class=\"fa fa-fw fa-check-circle\"\u003e\u003c/span\u003e\u003cdiv\u003e\n\u003cp data-sourcepos=\"42:1-42:211\"\u003e作業終了後は、プロキシ2つを必ずオフに戻す必要があります。オンのままHTTP Toolkitを閉じると、以下のような流れになり、ネットにつながらなくなります。\u003c/p\u003e\n\u003cp data-sourcepos=\"44:1-45:89\"\u003e動いている間： アプリ → 127.0.0.1:8000（HTTP Toolkit）→ インターネット   ✅\u003cbr\u003e\n閉じた後　　： アプリ → 127.0.0.1:8000（誰もいない）  ✗ 接続拒否\u003c/p\u003e\n\u003c/div\u003e\n\u003c/div\u003e\n\u003ch1 data-sourcepos=\"49:1-49:11\"\u003e\n\u003cspan id=\"reference\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#reference\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eReference\u003c/h1\u003e\n\u003cp data-sourcepos=\"50:1-50:24\"\u003e\u003ciframe id=\"qiita-embed-content__a56b8fe0644ec27738149cf9b4d9d8be\" src=\"https://qiita.com/embed-contents/link-card#qiita-embed-content__a56b8fe0644ec27738149cf9b4d9d8be\" data-content=\"https%3A%2F%2Fhttptoolkit.com%2F\" frameborder=\"0\" scrolling=\"no\" loading=\"lazy\" style=\"width:100%;\" height=\"29\"\u003e\n\u003c/iframe\u003e\n\u003c/p\u003e\n\u003ch1 data-sourcepos=\"52:1-52:11\"\u003e\n\u003cspan id=\"まとめ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%BE%E3%81%A8%E3%82%81\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eまとめ\u003c/h1\u003e\n\u003cp data-sourcepos=\"54:1-54:51\"\u003eHTTP Toolkitの設定方法をまとめました。\u003c/p\u003e\n","body":"# はじめに\nMac OS上にアプリを導入しましたが、エラーが発生しました。原因を特定するためにリクエストとレスポンスの流れを確認しようとしましたが、アプリのためにブラウザで使用できる開発者モードに相当するものがありません。そのため、HTTP Toolkitを使用してみました。\n\n# 環境\nmacOS Tahoe: 26.6.2\nHTTP Toolkit: 1.27.4\n\n# インストール\n\nProxymanというアプリもあり、当初はそちらをダウンロードしようと思いましたが、有料のようでした。（後で確認したら無料版もあるようです。）そのため、HTTP Toolkitをダウンロードします。無料版と有料版がありますが、無料版をインストールしました。\n\n# 設定\n次に設定をしていきます。\n\n## ポート番号の確認\nIntercept \u003e Anythingを確認します。\nここで表示されるポート番号を確認します。8000でした。\n\n![Screenshot 2026-11-16 at 4.20.49 PM.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3684675/961bc51e-8248-4df8-9ef4-43e684e0bd6a.jpeg)\n\n## 証明書の追加\n次に、書き出した証明書をダブルクリックし、キーチェーンアクセスに追加します。\n\nしかし、うまく行きませんでした。以下を実行するとうまく動きました。\n```\nsudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain ~/Library/Preferences/httptoolkit/ca.pem\n```\nHTTP Toolkitの証明書がシステムのキーチェーンに「常に信頼」として登録されます。\n\n\n## macOSのプロキシを設定\nmacOSのプロキシを設定します。\n\n「システム設定」→「ネットワーク」→ 使っている接続（Wi‑Fiなど）→「詳細…」→「プロキシ」を開きます。\n「Webプロキシ（HTTP）」をオン：サーバ 127.0.0.1、ポートは先ほどの番号(8000)\n「保護されたWebプロキシ（HTTPS）」をオン：同じ設定\n\n![Screenshot 2026-11-16 at 4.25.21 PM.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3684675/e645e3be-0a37-4049-9343-59025f8a787e.jpeg)\n\n\n:::note info\n作業終了後は、プロキシ2つを必ずオフに戻す必要があります。オンのままHTTP Toolkitを閉じると、以下のような流れになり、ネットにつながらなくなります。\n\n動いている間： アプリ → 127.0.0.1:8000（HTTP Toolkit）→ インターネット   ✅\n閉じた後　　： アプリ → 127.0.0.1:8000（誰もいない）  ✗ 接続拒否\n:::\n\n\n# Reference\nhttps://httptoolkit.com/\n\n# まとめ\n\nHTTP Toolkitの設定方法をまとめました。\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T03:24:11+09:00","group":null,"id":"7a69879e82c65aa7fa38","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"HTTP","versions":[]}],"title":"HTTP Toolkitを使用してみる","updated_at":"2026-11-18T03:24:11+09:00","url":"https://qiita.com/k96mz/items/7a69879e82c65aa7fa38","user":{"description":null,"facebook_id":null,"followees_count":10,"followers_count":3,"github_login_name":"k96mz","id":"k96mz","items_count":89,"linkedin_id":null,"location":null,"name":"","organization":null,"permanent_id":3684675,"profile_image_url":"https://avatars.githubusercontent.com/u/65704916?v=4","team_only":false,"twitter_screen_name":null,"website_url":null},"page_views_count":null,"team_membership":null,"organization_url_name":null,"slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003ch2 data-sourcepos=\"1:1-1:15\"\u003e\n\u003cspan id=\"環境情報\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%92%B0%E5%A2%83%E6%83%85%E5%A0%B1\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e環境情報\u003c/h2\u003e\n\u003ctable data-sourcepos=\"3:1-10:62\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"3:1-3:28\"\u003e\n\u003cth data-sourcepos=\"3:2-3:9\"\u003e項目\u003c/th\u003e\n\u003cth data-sourcepos=\"3:11-3:27\"\u003eバージョン\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"5:1-5:28\"\u003e\n\u003ctd data-sourcepos=\"5:2-5:12\"\u003e移行元\u003c/td\u003e\n\u003ctd data-sourcepos=\"5:14-5:27\"\u003eMySQL 5.7.44\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"6:1-6:27\"\u003e\n\u003ctd data-sourcepos=\"6:2-6:12\"\u003e移行先\u003c/td\u003e\n\u003ctd data-sourcepos=\"6:14-6:26\"\u003eMySQL 8.4.x\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"7:1-7:42\"\u003e\n\u003ctd data-sourcepos=\"7:2-7:27\"\u003eアプリケーション\u003c/td\u003e\n\u003ctd data-sourcepos=\"7:29-7:41\"\u003eEC-CUBE 4.3\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"8:1-8:25\"\u003e\n\u003ctd data-sourcepos=\"8:2-8:6\"\u003ePHP\u003c/td\u003e\n\u003ctd data-sourcepos=\"8:8-8:24\"\u003e8.2 / PDO MySQL\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"9:1-9:55\"\u003e\n\u003ctd data-sourcepos=\"9:2-9:21\"\u003e該当テーブル\u003c/td\u003e\n\u003ctd data-sourcepos=\"9:23-9:54\"\u003e\n\u003ccode\u003edtb_csv\u003c/code\u003e（CSV出力定義）\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"10:1-10:62\"\u003e\n\u003ctd data-sourcepos=\"10:2-10:15\"\u003e発生箇所\u003c/td\u003e\n\u003ctd data-sourcepos=\"10:17-10:61\"\u003e商品CSV / 受注CSV / 会員CSV の出力\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"12:1-12:434\"\u003eMySQL 5.7から8.4へバージョンを上げただけで、\u003cstrong\u003eアプリケーションコードは1行も変えていないのにCSVの列順が入れ替わる\u003c/strong\u003e現象に遭遇しました。データは正しい、件数も一致している、なのに列の並びだけが実行ごとに変わる。移行検証でありがちな「件数一致だけを見る」チェックでは絶対に検出できない種類の破壊です。\u003c/p\u003e\n\u003cp data-sourcepos=\"14:1-14:174\"\u003eこの記事では、原因の特定から検出・振り直し・ロールバック付きの検証までを、実際に使ったSQLとPHPのコード付きで残します。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"16:1-16:24\"\u003e\n\u003cspan id=\"何が起きたのか\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BD%95%E3%81%8C%E8%B5%B7%E3%81%8D%E3%81%9F%E3%81%AE%E3%81%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e何が起きたのか\u003c/h2\u003e\n\u003cp data-sourcepos=\"18:1-18:271\"\u003eEC-CUBE 4.3のCSV出力は、\u003ccode\u003edtb_csv\u003c/code\u003e テーブルの行1件が「CSVの1列」に対応します。各行は \u003ccode\u003esort_no\u003c/code\u003e（並び番号）を持ち、出力時はこの番号の昇順で列が並びます。つまり \u003cstrong\u003e列順の根拠は \u003ccode\u003esort_no\u003c/code\u003e ただ一つ\u003c/strong\u003eです。\u003c/p\u003e\n\u003cp data-sourcepos=\"20:1-20:302\"\u003eところが、拡張プラグインが項目を追加する際、既存の最大値+1を取らずに固定値（あるいは既存と同じ値）を \u003ccode\u003esort_no\u003c/code\u003e に設定していました。結果として \u003ccode\u003ecsv_type\u003c/code\u003e（CSVの種類）ごとに \u003ccode\u003esort_no\u003c/code\u003e が重複した状態になっていました。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"sql\" data-sourcepos=\"22:1-28:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"c1\"\u003e-- 重複の例: csv_type = 'product' の中で sort_no = 30 が2件\u003c/span\u003e\n\u003cspan class=\"k\"\u003eSELECT\u003c/span\u003e \u003cspan class=\"n\"\u003ecsv_id\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003ecsv_type\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003efield_name\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003esort_no\u003c/span\u003e\n\u003cspan class=\"k\"\u003eFROM\u003c/span\u003e \u003cspan class=\"n\"\u003edtb_csv\u003c/span\u003e\n\u003cspan class=\"k\"\u003eWHERE\u003c/span\u003e \u003cspan class=\"n\"\u003ecsv_type\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"s1\"\u003e'product'\u003c/span\u003e\n\u003cspan class=\"k\"\u003eORDER\u003c/span\u003e \u003cspan class=\"k\"\u003eBY\u003c/span\u003e \u003cspan class=\"n\"\u003esort_no\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003ecsv_id\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"30:1-40:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e+--------+-----------+------------------+---------+\n| csv_id | csv_type  | field_name       | sort_no |\n+--------+-----------+------------------+---------+\n|    101 | product   | product_code     |      10 |\n|    102 | product   | product_name     |      20 |\n|    103 | product   | price01          |      30 |\n|    138 | product   | stock_unlimited  |      30 |  ← プラグイン追加分\n|    104 | product   | category_id      |      40 |\n+--------+-----------+------------------+---------+\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003ch3 data-sourcepos=\"42:1-42:43\"\u003e\n\u003cspan id=\"57では表面化しなかった理由\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#57%E3%81%A7%E3%81%AF%E8%A1%A8%E9%9D%A2%E5%8C%96%E3%81%97%E3%81%AA%E3%81%8B%E3%81%A3%E3%81%9F%E7%90%86%E7%94%B1\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e5.7では表面化しなかった理由\u003c/h3\u003e\n\u003cp data-sourcepos=\"44:1-44:422\"\u003eMySQL 5.7では、\u003ccode\u003eORDER BY sort_no\u003c/code\u003e のように\u003cstrong\u003e同値が存在する並び替え\u003c/strong\u003eにおいて、同値グループ内の順序は仕様上保証されていません。しかし実際にはテーブルスキャン順（多くの場合主キー順）で返ることが多く、結果として「登録した順」に見えていました。アプリケーション側もそれを前提に動いていたわけです。\u003c/p\u003e\n\u003cp data-sourcepos=\"46:1-46:352\"\u003eMySQL 8.0以降はオプティマイザとソートアルゴリズムが変更され、同値グループ内の順序は実行計画・統計情報・ソートバッファのサイズなどで変動します。結果として、\u003cstrong\u003eある実行では逆順、ある実行では正順\u003c/strong\u003eという、再現性すら安定しない状態になりました。\u003c/p\u003e\n\u003ctable data-sourcepos=\"48:1-53:94\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"48:1-48:34\"\u003e\n\u003cth data-sourcepos=\"48:2-48:9\"\u003e観点\u003c/th\u003e\n\u003cth data-sourcepos=\"48:11-48:21\"\u003eMySQL 5.7\u003c/th\u003e\n\u003cth data-sourcepos=\"48:23-48:33\"\u003eMySQL 8.4\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"50:1-50:134\"\u003e\n\u003ctd data-sourcepos=\"50:2-50:29\"\u003e同値 \u003ccode\u003esort_no\u003c/code\u003e の順序\u003c/td\u003e\n\u003ctd data-sourcepos=\"50:31-50:82\"\u003e仕様上は不定（実質PK順になりがち）\u003c/td\u003e\n\u003ctd data-sourcepos=\"50:84-50:133\"\u003e仕様上も不定、実行計画依存で変動\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"51:1-51:94\"\u003e\n\u003ctd data-sourcepos=\"51:2-51:12\"\u003e再現性\u003c/td\u003e\n\u003ctd data-sourcepos=\"51:14-51:48\"\u003eほぼ安定して「登録順」\u003c/td\u003e\n\u003ctd data-sourcepos=\"51:50-51:93\"\u003e実行ごとに変わることすらある\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"52:1-52:85\"\u003e\n\u003ctd data-sourcepos=\"52:2-52:21\"\u003e原因の見え方\u003c/td\u003e\n\u003ctd data-sourcepos=\"52:23-52:51\"\u003e問題が表面化しない\u003c/td\u003e\n\u003ctd data-sourcepos=\"52:53-52:84\"\u003e断続的に列順が壊れる\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"53:1-53:94\"\u003e\n\u003ctd data-sourcepos=\"53:2-53:21\"\u003e検証での検出\u003c/td\u003e\n\u003ctd data-sourcepos=\"53:23-53:57\"\u003e件数一致だけでは不可能\u003c/td\u003e\n\u003ctd data-sourcepos=\"53:59-53:93\"\u003e件数一致だけでは不可能\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003ch3 data-sourcepos=\"55:1-55:40\"\u003e\n\u003cspan id=\"なぜ静かに壊れるのか\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%AA%E3%81%9C%E9%9D%99%E3%81%8B%E3%81%AB%E5%A3%8A%E3%82%8C%E3%82%8B%E3%81%AE%E3%81%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eなぜ「静かに」壊れるのか\u003c/h3\u003e\n\u003cp data-sourcepos=\"57:1-57:409\"\u003eCSVを取り込む側のシステムは、ヘッダ行を見ずに\u003cstrong\u003e列の位置\u003c/strong\u003eで項目を判断していることが多いからです。列順が変われば、\u003ccode\u003eprice\u003c/code\u003e の位置に \u003ccode\u003estock\u003c/code\u003e が来ていても、取込側は「3列目は価格」として処理を続けます。エラーにならず、値だけがずれた状態で在庫や受注が登録される。これが最も厄介な点です。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"59:1-59:19\"\u003e\n\u003cspan id=\"対処は3段階\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%AF%BE%E5%87%A6%E3%81%AF3%E6%AE%B5%E9%9A%8E\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e対処は3段階\u003c/h2\u003e\n\u003cp data-sourcepos=\"61:1-61:58\"\u003e対処方針はシンプルに3段階に分けました。\u003c/p\u003e\n\u003col data-sourcepos=\"63:1-66:0\"\u003e\n\u003cli data-sourcepos=\"63:1-63:61\"\u003eCSVの種類ごとに、\u003ccode\u003esort_no\u003c/code\u003e の重複を検出する\u003c/li\u003e\n\u003cli data-sourcepos=\"64:1-64:84\"\u003e重複があった種類だけ、\u003ccode\u003e(sort_no, csv_id)\u003c/code\u003e の順で1から振り直す\u003c/li\u003e\n\u003cli data-sourcepos=\"65:1-66:0\"\u003e1トランザクション内で振り直し前後の有効な列順を比較し、違えばロールバック。2回目は何もしない冪等な作りにする\u003c/li\u003e\n\u003c/ol\u003e\n\u003ch3 data-sourcepos=\"67:1-67:28\"\u003e\n\u003cspan id=\"手順1-重複の検出\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%89%8B%E9%A0%861-%E9%87%8D%E8%A4%87%E3%81%AE%E6%A4%9C%E5%87%BA\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e手順1: 重複の検出\u003c/h3\u003e\n\u003cp data-sourcepos=\"69:1-69:368\"\u003eまずは「どのCSV種類が壊れているか」を洗い出します。ここで重要なのは、\u003cstrong\u003e有効な列（\u003ccode\u003eenabled = 1\u003c/code\u003e）だけを対象にする\u003c/strong\u003eことです。無効な列が同値を持っていても出力には影響しませんが、後で有効化した瞬間に壊れます。検出は有効・無効の両方を見ておくのが安全です。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"sql\" data-sourcepos=\"71:1-79:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"c1\"\u003e-- CSV種類ごとに sort_no が重複しているものを検出\u003c/span\u003e\n\u003cspan class=\"k\"\u003eSELECT\u003c/span\u003e \u003cspan class=\"n\"\u003ecsv_type\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003esort_no\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"k\"\u003eCOUNT\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"o\"\u003e*\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"k\"\u003eAS\u003c/span\u003e \u003cspan class=\"n\"\u003edup_count\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n       \u003cspan class=\"n\"\u003eGROUP_CONCAT\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003ecsv_id\u003c/span\u003e \u003cspan class=\"k\"\u003eORDER\u003c/span\u003e \u003cspan class=\"k\"\u003eBY\u003c/span\u003e \u003cspan class=\"n\"\u003ecsv_id\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"k\"\u003eAS\u003c/span\u003e \u003cspan class=\"n\"\u003ecsv_ids\u003c/span\u003e\n\u003cspan class=\"k\"\u003eFROM\u003c/span\u003e \u003cspan class=\"n\"\u003edtb_csv\u003c/span\u003e\n\u003cspan class=\"k\"\u003eGROUP\u003c/span\u003e \u003cspan class=\"k\"\u003eBY\u003c/span\u003e \u003cspan class=\"n\"\u003ecsv_type\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003esort_no\u003c/span\u003e\n\u003cspan class=\"k\"\u003eHAVING\u003c/span\u003e \u003cspan class=\"k\"\u003eCOUNT\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"o\"\u003e*\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"o\"\u003e\u0026gt;\u003c/span\u003e \u003cspan class=\"mi\"\u003e1\u003c/span\u003e\n\u003cspan class=\"k\"\u003eORDER\u003c/span\u003e \u003cspan class=\"k\"\u003eBY\u003c/span\u003e \u003cspan class=\"n\"\u003ecsv_type\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003esort_no\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003ch3 data-sourcepos=\"81:1-81:55\"\u003e\n\u003cspan id=\"手順2-重複があった種類だけ振り直す\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%89%8B%E9%A0%862-%E9%87%8D%E8%A4%87%E3%81%8C%E3%81%82%E3%81%A3%E3%81%9F%E7%A8%AE%E9%A1%9E%E3%81%A0%E3%81%91%E6%8C%AF%E3%82%8A%E7%9B%B4%E3%81%99\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e手順2: 重複があった種類だけ振り直す\u003c/h3\u003e\n\u003cp data-sourcepos=\"83:1-83:395\"\u003e振り直しは \u003ccode\u003eROW_NUMBER()\u003c/code\u003e で \u003ccode\u003e(sort_no, csv_id)\u003c/code\u003e の順に1から振るだけです。ただし\u003cstrong\u003e同一テーブルをサブクエリで参照しながらUPDATEすると \u003ccode\u003eERROR 1093\u003c/code\u003e になり得る\u003c/strong\u003eため、一時テーブルを挟みます。これは5.7時代の検証環境でも同じSQLで動かせるので、移行前後で手順を共通化できるメリットもあります。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"sql\" data-sourcepos=\"85:1-99:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"c1\"\u003e-- 対象の csv_type だけを一時テーブルに退避して採番\u003c/span\u003e\n\u003cspan class=\"k\"\u003eCREATE\u003c/span\u003e \u003cspan class=\"k\"\u003eTEMPORARY\u003c/span\u003e \u003cspan class=\"k\"\u003eTABLE\u003c/span\u003e \u003cspan class=\"n\"\u003etmp_csv_sort\u003c/span\u003e \u003cspan class=\"k\"\u003eAS\u003c/span\u003e\n\u003cspan class=\"k\"\u003eSELECT\u003c/span\u003e \u003cspan class=\"n\"\u003ecsv_id\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n       \u003cspan class=\"n\"\u003eROW_NUMBER\u003c/span\u003e\u003cspan class=\"p\"\u003e()\u003c/span\u003e \u003cspan class=\"n\"\u003eOVER\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"k\"\u003ePARTITION\u003c/span\u003e \u003cspan class=\"k\"\u003eBY\u003c/span\u003e \u003cspan class=\"n\"\u003ecsv_type\u003c/span\u003e \u003cspan class=\"k\"\u003eORDER\u003c/span\u003e \u003cspan class=\"k\"\u003eBY\u003c/span\u003e \u003cspan class=\"n\"\u003esort_no\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003ecsv_id\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"k\"\u003eAS\u003c/span\u003e \u003cspan class=\"n\"\u003enew_sort_no\u003c/span\u003e\n\u003cspan class=\"k\"\u003eFROM\u003c/span\u003e \u003cspan class=\"n\"\u003edtb_csv\u003c/span\u003e\n\u003cspan class=\"k\"\u003eWHERE\u003c/span\u003e \u003cspan class=\"n\"\u003ecsv_type\u003c/span\u003e \u003cspan class=\"k\"\u003eIN\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"s1\"\u003e'product'\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"s1\"\u003e'order'\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"s1\"\u003e'customer'\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e  \u003cspan class=\"c1\"\u003e-- 重複が見つかった種類のみ\u003c/span\u003e\n\n\u003cspan class=\"c1\"\u003e-- 一時テーブル経由で更新（ERROR 1093 回避）\u003c/span\u003e\n\u003cspan class=\"k\"\u003eUPDATE\u003c/span\u003e \u003cspan class=\"n\"\u003edtb_csv\u003c/span\u003e \u003cspan class=\"k\"\u003ec\u003c/span\u003e\n\u003cspan class=\"k\"\u003eJOIN\u003c/span\u003e \u003cspan class=\"n\"\u003etmp_csv_sort\u003c/span\u003e \u003cspan class=\"n\"\u003et\u003c/span\u003e \u003cspan class=\"k\"\u003eON\u003c/span\u003e \u003cspan class=\"n\"\u003et\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003ecsv_id\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"k\"\u003ec\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003ecsv_id\u003c/span\u003e\n\u003cspan class=\"k\"\u003eSET\u003c/span\u003e \u003cspan class=\"k\"\u003ec\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003esort_no\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003et\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003enew_sort_no\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\n\u003cspan class=\"k\"\u003eDROP\u003c/span\u003e \u003cspan class=\"k\"\u003eTEMPORARY\u003c/span\u003e \u003cspan class=\"k\"\u003eTABLE\u003c/span\u003e \u003cspan class=\"n\"\u003etmp_csv_sort\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"101:1-101:233\"\u003e\u003ccode\u003eORDER BY sort_no, csv_id\u003c/code\u003e の第2キーに \u003ccode\u003ecsv_id\u003c/code\u003e を必ず入れるのがポイントです。ここを省略すると「重複を解消するための採番」がまた不定順序になり、同じ事故を再生産します。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"103:1-103:67\"\u003e\n\u003cspan id=\"手順3-トランザクション内で前後比較冪等化\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%89%8B%E9%A0%863-%E3%83%88%E3%83%A9%E3%83%B3%E3%82%B6%E3%82%AF%E3%82%B7%E3%83%A7%E3%83%B3%E5%86%85%E3%81%A7%E5%89%8D%E5%BE%8C%E6%AF%94%E8%BC%83%E5%86%AA%E7%AD%89%E5%8C%96\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e手順3: トランザクション内で前後比較＋冪等化\u003c/h3\u003e\n\u003cp data-sourcepos=\"105:1-105:301\"\u003e振り直しは「壊れた状態を直す」操作なので、\u003cstrong\u003e適用前に必ず前後の列順を比較して、意図しない変化があればロールバック\u003c/strong\u003eします。さらにマイグレーションスクリプトは何度実行されるか分からないので、冪等にします。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"php\" data-sourcepos=\"107:1-164:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"cp\"\u003e\u0026lt;?php\u003c/span\u003e\n\u003cspan class=\"c1\"\u003e// migrate_csv_sort_no.php\u003c/span\u003e\n\u003cspan class=\"nv\"\u003e$pdo\u003c/span\u003e\u003cspan class=\"o\"\u003e-\u0026gt;\u003c/span\u003e\u003cspan class=\"nf\"\u003ebeginTransaction\u003c/span\u003e\u003cspan class=\"p\"\u003e();\u003c/span\u003e\n\n\u003cspan class=\"k\"\u003etry\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"nv\"\u003e$types\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"nv\"\u003e$pdo\u003c/span\u003e\u003cspan class=\"o\"\u003e-\u0026gt;\u003c/span\u003e\u003cspan class=\"nf\"\u003equery\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n        \u003cspan class=\"s2\"\u003e\"SELECT csv_type FROM dtb_csv\n         GROUP BY csv_type, sort_no HAVING COUNT(*) \u0026gt; 1\"\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e)\u003c/span\u003e\u003cspan class=\"o\"\u003e-\u0026gt;\u003c/span\u003e\u003cspan class=\"nf\"\u003efetchAll\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"no\"\u003ePDO\u003c/span\u003e\u003cspan class=\"o\"\u003e::\u003c/span\u003e\u003cspan class=\"no\"\u003eFETCH_COLUMN\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n\n    \u003cspan class=\"k\"\u003eif\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"o\"\u003e!\u003c/span\u003e\u003cspan class=\"nv\"\u003e$types\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n        \u003cspan class=\"c1\"\u003e// 重複なし = 何もしない（冪等）\u003c/span\u003e\n        \u003cspan class=\"nv\"\u003e$pdo\u003c/span\u003e\u003cspan class=\"o\"\u003e-\u0026gt;\u003c/span\u003e\u003cspan class=\"nf\"\u003ecommit\u003c/span\u003e\u003cspan class=\"p\"\u003e();\u003c/span\u003e\n        \u003cspan class=\"k\"\u003eexit\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"mi\"\u003e0\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\n    \u003cspan class=\"k\"\u003eforeach\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"nv\"\u003e$types\u003c/span\u003e \u003cspan class=\"k\"\u003eas\u003c/span\u003e \u003cspan class=\"nv\"\u003e$type\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n        \u003cspan class=\"c1\"\u003e// 振り直し前の「有効な列順」をハッシュ化して保持\u003c/span\u003e\n        \u003cspan class=\"nv\"\u003e$before\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"nf\"\u003efetchOrderHash\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"nv\"\u003e$pdo\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"nv\"\u003e$type\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n\n        \u003cspan class=\"nv\"\u003e$stmt\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"nv\"\u003e$pdo\u003c/span\u003e\u003cspan class=\"o\"\u003e-\u0026gt;\u003c/span\u003e\u003cspan class=\"nf\"\u003eprepare\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n            \u003cspan class=\"s2\"\u003e\"UPDATE dtb_csv c\n             JOIN (\n               SELECT csv_id,\n                      ROW_NUMBER() OVER (PARTITION BY csv_type\n                                         ORDER BY sort_no, csv_id) AS new_sort_no\n               FROM dtb_csv WHERE csv_type = :t\n             ) t ON t.csv_id = c.csv_id\n             SET c.sort_no = t.new_sort_no\"\u003c/span\u003e\n        \u003cspan class=\"p\"\u003e);\u003c/span\u003e\n        \u003cspan class=\"nv\"\u003e$stmt\u003c/span\u003e\u003cspan class=\"o\"\u003e-\u0026gt;\u003c/span\u003e\u003cspan class=\"nf\"\u003eexecute\u003c/span\u003e\u003cspan class=\"p\"\u003e([\u003c/span\u003e\u003cspan class=\"s1\"\u003e':t'\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"nv\"\u003e$type\u003c/span\u003e\u003cspan class=\"p\"\u003e]);\u003c/span\u003e\n\n        \u003cspan class=\"nv\"\u003e$after\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"nf\"\u003efetchOrderHash\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"nv\"\u003e$pdo\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"nv\"\u003e$type\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n\n        \u003cspan class=\"c1\"\u003e// field_name の並びが変わったら即ロールバック\u003c/span\u003e\n        \u003cspan class=\"k\"\u003eif\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"nv\"\u003e$before\u003c/span\u003e \u003cspan class=\"o\"\u003e!==\u003c/span\u003e \u003cspan class=\"nv\"\u003e$after\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n            \u003cspan class=\"k\"\u003ethrow\u003c/span\u003e \u003cspan class=\"k\"\u003enew\u003c/span\u003e \u003cspan class=\"nc\"\u003eRuntimeException\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"s2\"\u003e\"列順が変化: \u003c/span\u003e\u003cspan class=\"si\"\u003e{\u003c/span\u003e\u003cspan class=\"nv\"\u003e$type\u003c/span\u003e\u003cspan class=\"si\"\u003e}\u003c/span\u003e\u003cspan class=\"s2\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n        \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\n    \u003cspan class=\"nv\"\u003e$pdo\u003c/span\u003e\u003cspan class=\"o\"\u003e-\u0026gt;\u003c/span\u003e\u003cspan class=\"nf\"\u003ecommit\u003c/span\u003e\u003cspan class=\"p\"\u003e();\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e \u003cspan class=\"k\"\u003ecatch\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"nc\"\u003eThrowable\u003c/span\u003e \u003cspan class=\"nv\"\u003e$e\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"nv\"\u003e$pdo\u003c/span\u003e\u003cspan class=\"o\"\u003e-\u0026gt;\u003c/span\u003e\u003cspan class=\"nf\"\u003erollBack\u003c/span\u003e\u003cspan class=\"p\"\u003e();\u003c/span\u003e\n    \u003cspan class=\"k\"\u003ethrow\u003c/span\u003e \u003cspan class=\"nv\"\u003e$e\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\n\u003cspan class=\"k\"\u003efunction\u003c/span\u003e \u003cspan class=\"n\"\u003efetchOrderHash\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003ePDO\u003c/span\u003e \u003cspan class=\"nv\"\u003e$pdo\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"kt\"\u003estring\u003c/span\u003e \u003cspan class=\"nv\"\u003e$type\u003c/span\u003e\u003cspan class=\"p\"\u003e):\u003c/span\u003e \u003cspan class=\"kt\"\u003estring\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"nv\"\u003e$stmt\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"nv\"\u003e$pdo\u003c/span\u003e\u003cspan class=\"o\"\u003e-\u0026gt;\u003c/span\u003e\u003cspan class=\"nf\"\u003eprepare\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n        \u003cspan class=\"s2\"\u003e\"SELECT field_name FROM dtb_csv\n         WHERE csv_type = :t AND enabled = 1\n         ORDER BY sort_no, csv_id\"\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e);\u003c/span\u003e\n    \u003cspan class=\"nv\"\u003e$stmt\u003c/span\u003e\u003cspan class=\"o\"\u003e-\u0026gt;\u003c/span\u003e\u003cspan class=\"nf\"\u003eexecute\u003c/span\u003e\u003cspan class=\"p\"\u003e([\u003c/span\u003e\u003cspan class=\"s1\"\u003e':t'\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"nv\"\u003e$type\u003c/span\u003e\u003cspan class=\"p\"\u003e]);\u003c/span\u003e\n    \u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"nb\"\u003ehash\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"s1\"\u003e'sha256'\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"nb\"\u003eimplode\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"s1\"\u003e','\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"nv\"\u003e$stmt\u003c/span\u003e\u003cspan class=\"o\"\u003e-\u0026gt;\u003c/span\u003e\u003cspan class=\"nf\"\u003efetchAll\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"no\"\u003ePDO\u003c/span\u003e\u003cspan class=\"o\"\u003e::\u003c/span\u003e\u003cspan class=\"no\"\u003eFETCH_COLUMN\u003c/span\u003e\u003cspan class=\"p\"\u003e)));\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"166:1-166:365\"\u003eここでのミソは、比較対象を \u003ccode\u003esort_no\u003c/code\u003e そのものではなく \u003cstrong\u003e\u003ccode\u003efield_name\u003c/code\u003e の並び\u003c/strong\u003eにしている点です。番号の振り直しは番号が変わることを目的にしているので、番号を比較しては意味がありません。「利用者から見た列の並びが変わっていないか」を検証する必要があります。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"168:1-168:45\"\u003e\n\u003cspan id=\"移行前チェックリストの見直し\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%A7%BB%E8%A1%8C%E5%89%8D%E3%83%81%E3%82%A7%E3%83%83%E3%82%AF%E3%83%AA%E3%82%B9%E3%83%88%E3%81%AE%E8%A6%8B%E7%9B%B4%E3%81%97\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e移行前チェックリストの見直し\u003c/h2\u003e\n\u003cp data-sourcepos=\"170:1-170:241\"\u003e今回の件を受けて、バージョンアップ前の確認項目の先頭に「\u003cstrong\u003e並び順の根拠が一意か\u003c/strong\u003e」を置きました。データが正しくても、順序の保証が変われば壊れる箇所があるからです。\u003c/p\u003e\n\u003ctable data-sourcepos=\"172:1-178:92\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"172:1-172:55\"\u003e\n\u003cth data-sourcepos=\"172:2-172:9\"\u003e優先\u003c/th\u003e\n\u003cth data-sourcepos=\"172:11-172:30\"\u003eチェック項目\u003c/th\u003e\n\u003cth data-sourcepos=\"172:32-172:45\"\u003e確認方法\u003c/th\u003e\n\u003cth data-sourcepos=\"172:47-172:54\"\u003e理由\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"174:1-174:120\"\u003e\n\u003ctd data-sourcepos=\"174:2-174:4\"\u003e1\u003c/td\u003e\n\u003ctd data-sourcepos=\"174:6-174:37\"\u003e並び順の根拠が一意か\u003c/td\u003e\n\u003ctd data-sourcepos=\"174:39-174:74\"\u003e\u003ccode\u003eGROUP BY ... HAVING COUNT(*) \u0026gt; 1\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-sourcepos=\"174:76-174:119\"\u003e順序保証の変化で最初に壊れる\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"175:1-175:86\"\u003e\n\u003ctd data-sourcepos=\"175:2-175:4\"\u003e2\u003c/td\u003e\n\u003ctd data-sourcepos=\"175:6-175:22\"\u003e件数の一致\u003c/td\u003e\n\u003ctd data-sourcepos=\"175:24-175:58\"\u003e移行前後の \u003ccode\u003eCOUNT(*)\u003c/code\u003e 比較\u003c/td\u003e\n\u003ctd data-sourcepos=\"175:60-175:85\"\u003e欠損・重複の検出\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"176:1-176:93\"\u003e\n\u003ctd data-sourcepos=\"176:2-176:4\"\u003e3\u003c/td\u003e\n\u003ctd data-sourcepos=\"176:6-176:31\"\u003eチェックサム一致\u003c/td\u003e\n\u003ctd data-sourcepos=\"176:33-176:71\"\u003e\n\u003ccode\u003eCHECKSUM TABLE\u003c/code\u003e / 全列ハッシュ\u003c/td\u003e\n\u003ctd data-sourcepos=\"176:73-176:92\"\u003e値の破壊検出\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"177:1-177:81\"\u003e\n\u003ctd data-sourcepos=\"177:2-177:4\"\u003e4\u003c/td\u003e\n\u003ctd data-sourcepos=\"177:6-177:28\"\u003e実行計画の変化\u003c/td\u003e\n\u003ctd data-sourcepos=\"177:30-177:56\"\u003e\n\u003ccode\u003eEXPLAIN\u003c/code\u003e の前後比較\u003c/td\u003e\n\u003ctd data-sourcepos=\"177:58-177:80\"\u003e性能劣化の予兆\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"178:1-178:92\"\u003e\n\u003ctd data-sourcepos=\"178:2-178:4\"\u003e5\u003c/td\u003e\n\u003ctd data-sourcepos=\"178:6-178:25\"\u003e文字照合順序\u003c/td\u003e\n\u003ctd data-sourcepos=\"178:27-178:67\"\u003e\n\u003ccode\u003eutf8mb4_0900_ai_ci\u003c/code\u003e への変更影響\u003c/td\u003e\n\u003ctd data-sourcepos=\"178:69-178:91\"\u003e検索結果の差分\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"180:1-180:370\"\u003e「件数の一致検証と並び順の一意性、どちらを先に確認するか」と問われたら、私は\u003cstrong\u003e並び順の一意性を先\u003c/strong\u003eにします。件数は合っていても順序が壊れていれば、取込側で値がずれたまま正常終了してしまうからです。件数不一致はまだ気づけますが、列ずれは気づけません。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"182:1-182:24\"\u003e\n\u003cspan id=\"ハマりポイント\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%8F%E3%83%9E%E3%82%8A%E3%83%9D%E3%82%A4%E3%83%B3%E3%83%88\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eハマりポイント\u003c/h2\u003e\n\u003cul data-sourcepos=\"184:1-189:0\"\u003e\n\u003cli data-sourcepos=\"184:1-184:178\"\u003e\n\u003cstrong\u003e\u003ccode\u003eORDER BY\u003c/code\u003e にタイブレークキーを入れ忘れる\u003c/strong\u003e。\u003ccode\u003eORDER BY sort_no\u003c/code\u003e だけの箇所は全て \u003ccode\u003eORDER BY sort_no, csv_id\u003c/code\u003e に直す。アプリ側のSQLも同様。\u003c/li\u003e\n\u003cli data-sourcepos=\"185:1-185:216\"\u003e\n\u003cstrong\u003e\u003ccode\u003eONLY_FULL_GROUP_BY\u003c/code\u003e\u003c/strong\u003e。5.7からデフォルト有効ですが、8.4でも有効です。\u003ccode\u003eSELECT csv_type, field_name ... GROUP BY csv_type\u003c/code\u003e のような雑なクエリが移行後にエラーになります。\u003c/li\u003e\n\u003cli data-sourcepos=\"186:1-186:141\"\u003e\n\u003cstrong\u003e\u003ccode\u003eERROR 1093\u003c/code\u003e\u003c/strong\u003e。同一テーブルをサブクエリで参照するUPDATEは避け、一時テーブルか派生テーブルを使う。\u003c/li\u003e\n\u003cli data-sourcepos=\"187:1-187:179\"\u003e\n\u003cstrong\u003e認証プラグインの変更\u003c/strong\u003e。\u003ccode\u003emysql_native_password\u003c/code\u003e から \u003ccode\u003ecaching_sha2_password\u003c/code\u003e へ変わり、古いPDO/ドライバだと接続できないことがあります。\u003c/li\u003e\n\u003cli data-sourcepos=\"188:1-189:0\"\u003e\n\u003cstrong\u003e照合順序のデフォルト変更\u003c/strong\u003e。\u003ccode\u003eutf8mb4_0900_ai_ci\u003c/code\u003e になり、\u003ccode\u003eORDER BY name\u003c/code\u003e の結果が5.7と変わる場合があります。これも「静かに変わる」系です。\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch2 data-sourcepos=\"190:1-190:6\"\u003e\n\u003cspan id=\"faq\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#faq\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eFAQ\u003c/h2\u003e\n\u003cp data-sourcepos=\"192:1-193:330\"\u003e\u003cstrong\u003eQ. 5.7で今まで動いていたのに、なぜ8.4で急に壊れるのですか？\u003c/strong\u003e\u003cbr\u003e\nA. 同値グループ内の順序は5.7でも仕様上は不定です。たまたま主キー順で返っていただけで、8.0以降のオプティマイザ変更でその「偶然」が成立しなくなった、というのが正確な理解です。バグではなく、未定義動作への依存が露呈した形です。\u003c/p\u003e\n\u003cp data-sourcepos=\"195:1-196:242\"\u003e\u003cstrong\u003eQ. \u003ccode\u003esort_no\u003c/code\u003e にUNIQUE制約を付ければ再発しませんか？\u003c/strong\u003e\u003cbr\u003e\nA. 再発は防げますが、既存データの重複を先に解消する必要があります。また \u003ccode\u003e(csv_type, sort_no)\u003c/code\u003e の複合UNIQUEにしないと意味がありません。中長期的には制約追加をおすすめします。\u003c/p\u003e\n\u003cp data-sourcepos=\"198:1-199:242\"\u003e\u003cstrong\u003eQ. 振り直しで列順が変わってしまうことはありませんか？\u003c/strong\u003e\u003cbr\u003e\nA. \u003ccode\u003e(sort_no, csv_id)\u003c/code\u003e で採番するため、重複していた場合のみ順序が確定します。手順3のハッシュ比較で \u003ccode\u003efield_name\u003c/code\u003e の並びが変わった場合はロールバックするので、安全側に倒せます。\u003c/p\u003e\n\u003cp data-sourcepos=\"201:1-202:181\"\u003e\u003cstrong\u003eQ. 本番適用前に何を確認すべきですか？\u003c/strong\u003e\u003cbr\u003e\nA. ステージングで同じSQLを流し、出力CSVのヘッダ行を移行前後でdiffしてください。列数と列名の並びが完全一致していれば合格です。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"204:1-204:12\"\u003e\n\u003cspan id=\"まとめ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%BE%E3%81%A8%E3%82%81\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eまとめ\u003c/h2\u003e\n\u003cul data-sourcepos=\"206:1-210:0\"\u003e\n\u003cli data-sourcepos=\"206:1-206:145\"\u003e列順の根拠が \u003ccode\u003esort_no\u003c/code\u003e のように\u003cstrong\u003e単一カラムで重複し得る\u003c/strong\u003e設計は、MySQLのバージョンアップで静かに壊れる\u003c/li\u003e\n\u003cli data-sourcepos=\"207:1-207:139\"\u003e対策は「検出 → 重複分だけ振り直し → トランザクション内で並びを比較してロールバック」の3段階\u003c/li\u003e\n\u003cli data-sourcepos=\"208:1-208:129\"\u003eマイグレーションスクリプトは冪等に。比較は番号ではなく\u003cstrong\u003e利用者から見た列の並び\u003c/strong\u003eで行う\u003c/li\u003e\n\u003cli data-sourcepos=\"209:1-210:0\"\u003e移行前チェックは「並び順の根拠が一意か」を件数一致より先に確認する\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"211:1-211:219\"\u003eデータが正しいことと、順序が保証されていることは別問題です。バージョンアップで後者が変わる可能性を、チェックリストの先頭に置いておくのが安全です。\u003c/p\u003e\n\u003chr data-sourcepos=\"213:1-214:0\"\u003e\n\u003ch2 data-sourcepos=\"215:1-215:30\"\u003e\n\u003cspan id=\"この記事を書いた人\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%93%E3%81%AE%E8%A8%98%E4%BA%8B%E3%82%92%E6%9B%B8%E3%81%84%E3%81%9F%E4%BA%BA\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eこの記事を書いた人\u003c/h2\u003e\n\u003cp data-sourcepos=\"217:1-217:106\"\u003e\u003cstrong\u003eBENTEN Web Works\u003c/strong\u003e — 業務自動化・システム開発のフリーランスエンジニアです。\u003c/p\u003e\n\u003cp data-sourcepos=\"219:1-220:96\"\u003eGAS / Python / RPA を使った業務自動化や、Web制作・システム開発のご相談を承っています。\u003cbr\u003e\n「こんなこと自動化できる？」というご質問だけでもお気軽にどうぞ。\u003c/p\u003e\n\u003cp data-sourcepos=\"222:1-223:90\"\u003e👉 \u003cstrong\u003e\u003ca href=\"https://bentenweb.com\" rel=\"nofollow noopener\" target=\"_blank\"\u003eBENTEN Web Works\u003c/a\u003e\u003c/strong\u003e — 詳細・お問い合わせはこちら\u003cbr\u003e\n🐦 \u003cstrong\u003e\u003ca href=\"https://x.com/Fumi_BENTENweb\" rel=\"nofollow noopener\" target=\"_blank\"\u003eX（旧Twitter）\u003c/a\u003e\u003c/strong\u003e — 日々の知見を発信中\u003c/p\u003e\n","body":"## 環境情報\n\n| 項目 | バージョン |\n| --- | --- |\n| 移行元 | MySQL 5.7.44 |\n| 移行先 | MySQL 8.4.x |\n| アプリケーション | EC-CUBE 4.3 |\n| PHP | 8.2 / PDO MySQL |\n| 該当テーブル | `dtb_csv`（CSV出力定義） |\n| 発生箇所 | 商品CSV / 受注CSV / 会員CSV の出力 |\n\nMySQL 5.7から8.4へバージョンを上げただけで、**アプリケーションコードは1行も変えていないのにCSVの列順が入れ替わる**現象に遭遇しました。データは正しい、件数も一致している、なのに列の並びだけが実行ごとに変わる。移行検証でありがちな「件数一致だけを見る」チェックでは絶対に検出できない種類の破壊です。\n\nこの記事では、原因の特定から検出・振り直し・ロールバック付きの検証までを、実際に使ったSQLとPHPのコード付きで残します。\n\n## 何が起きたのか\n\nEC-CUBE 4.3のCSV出力は、`dtb_csv` テーブルの行1件が「CSVの1列」に対応します。各行は `sort_no`（並び番号）を持ち、出力時はこの番号の昇順で列が並びます。つまり **列順の根拠は `sort_no` ただ一つ**です。\n\nところが、拡張プラグインが項目を追加する際、既存の最大値+1を取らずに固定値（あるいは既存と同じ値）を `sort_no` に設定していました。結果として `csv_type`（CSVの種類）ごとに `sort_no` が重複した状態になっていました。\n\n```sql\n-- 重複の例: csv_type = 'product' の中で sort_no = 30 が2件\nSELECT csv_id, csv_type, field_name, sort_no\nFROM dtb_csv\nWHERE csv_type = 'product'\nORDER BY sort_no, csv_id;\n```\n\n```\n+--------+-----------+------------------+---------+\n| csv_id | csv_type  | field_name       | sort_no |\n+--------+-----------+------------------+---------+\n|    101 | product   | product_code     |      10 |\n|    102 | product   | product_name     |      20 |\n|    103 | product   | price01          |      30 |\n|    138 | product   | stock_unlimited  |      30 |  ← プラグイン追加分\n|    104 | product   | category_id      |      40 |\n+--------+-----------+------------------+---------+\n```\n\n### 5.7では表面化しなかった理由\n\nMySQL 5.7では、`ORDER BY sort_no` のように**同値が存在する並び替え**において、同値グループ内の順序は仕様上保証されていません。しかし実際にはテーブルスキャン順（多くの場合主キー順）で返ることが多く、結果として「登録した順」に見えていました。アプリケーション側もそれを前提に動いていたわけです。\n\nMySQL 8.0以降はオプティマイザとソートアルゴリズムが変更され、同値グループ内の順序は実行計画・統計情報・ソートバッファのサイズなどで変動します。結果として、**ある実行では逆順、ある実行では正順**という、再現性すら安定しない状態になりました。\n\n| 観点 | MySQL 5.7 | MySQL 8.4 |\n| --- | --- | --- |\n| 同値 `sort_no` の順序 | 仕様上は不定（実質PK順になりがち） | 仕様上も不定、実行計画依存で変動 |\n| 再現性 | ほぼ安定して「登録順」 | 実行ごとに変わることすらある |\n| 原因の見え方 | 問題が表面化しない | 断続的に列順が壊れる |\n| 検証での検出 | 件数一致だけでは不可能 | 件数一致だけでは不可能 |\n\n### なぜ「静かに」壊れるのか\n\nCSVを取り込む側のシステムは、ヘッダ行を見ずに**列の位置**で項目を判断していることが多いからです。列順が変われば、`price` の位置に `stock` が来ていても、取込側は「3列目は価格」として処理を続けます。エラーにならず、値だけがずれた状態で在庫や受注が登録される。これが最も厄介な点です。\n\n## 対処は3段階\n\n対処方針はシンプルに3段階に分けました。\n\n1. CSVの種類ごとに、`sort_no` の重複を検出する\n2. 重複があった種類だけ、`(sort_no, csv_id)` の順で1から振り直す\n3. 1トランザクション内で振り直し前後の有効な列順を比較し、違えばロールバック。2回目は何もしない冪等な作りにする\n\n### 手順1: 重複の検出\n\nまずは「どのCSV種類が壊れているか」を洗い出します。ここで重要なのは、**有効な列（`enabled = 1`）だけを対象にする**ことです。無効な列が同値を持っていても出力には影響しませんが、後で有効化した瞬間に壊れます。検出は有効・無効の両方を見ておくのが安全です。\n\n```sql\n-- CSV種類ごとに sort_no が重複しているものを検出\nSELECT csv_type, sort_no, COUNT(*) AS dup_count,\n       GROUP_CONCAT(csv_id ORDER BY csv_id) AS csv_ids\nFROM dtb_csv\nGROUP BY csv_type, sort_no\nHAVING COUNT(*) \u003e 1\nORDER BY csv_type, sort_no;\n```\n\n### 手順2: 重複があった種類だけ振り直す\n\n振り直しは `ROW_NUMBER()` で `(sort_no, csv_id)` の順に1から振るだけです。ただし**同一テーブルをサブクエリで参照しながらUPDATEすると `ERROR 1093` になり得る**ため、一時テーブルを挟みます。これは5.7時代の検証環境でも同じSQLで動かせるので、移行前後で手順を共通化できるメリットもあります。\n\n```sql\n-- 対象の csv_type だけを一時テーブルに退避して採番\nCREATE TEMPORARY TABLE tmp_csv_sort AS\nSELECT csv_id,\n       ROW_NUMBER() OVER (PARTITION BY csv_type ORDER BY sort_no, csv_id) AS new_sort_no\nFROM dtb_csv\nWHERE csv_type IN ('product', 'order', 'customer');  -- 重複が見つかった種類のみ\n\n-- 一時テーブル経由で更新（ERROR 1093 回避）\nUPDATE dtb_csv c\nJOIN tmp_csv_sort t ON t.csv_id = c.csv_id\nSET c.sort_no = t.new_sort_no;\n\nDROP TEMPORARY TABLE tmp_csv_sort;\n```\n\n`ORDER BY sort_no, csv_id` の第2キーに `csv_id` を必ず入れるのがポイントです。ここを省略すると「重複を解消するための採番」がまた不定順序になり、同じ事故を再生産します。\n\n### 手順3: トランザクション内で前後比較＋冪等化\n\n振り直しは「壊れた状態を直す」操作なので、**適用前に必ず前後の列順を比較して、意図しない変化があればロールバック**します。さらにマイグレーションスクリプトは何度実行されるか分からないので、冪等にします。\n\n```php\n\u003c?php\n// migrate_csv_sort_no.php\n$pdo-\u003ebeginTransaction();\n\ntry {\n    $types = $pdo-\u003equery(\n        \"SELECT csv_type FROM dtb_csv\n         GROUP BY csv_type, sort_no HAVING COUNT(*) \u003e 1\"\n    )-\u003efetchAll(PDO::FETCH_COLUMN);\n\n    if (!$types) {\n        // 重複なし = 何もしない（冪等）\n        $pdo-\u003ecommit();\n        exit(0);\n    }\n\n    foreach ($types as $type) {\n        // 振り直し前の「有効な列順」をハッシュ化して保持\n        $before = fetchOrderHash($pdo, $type);\n\n        $stmt = $pdo-\u003eprepare(\n            \"UPDATE dtb_csv c\n             JOIN (\n               SELECT csv_id,\n                      ROW_NUMBER() OVER (PARTITION BY csv_type\n                                         ORDER BY sort_no, csv_id) AS new_sort_no\n               FROM dtb_csv WHERE csv_type = :t\n             ) t ON t.csv_id = c.csv_id\n             SET c.sort_no = t.new_sort_no\"\n        );\n        $stmt-\u003eexecute([':t' =\u003e $type]);\n\n        $after = fetchOrderHash($pdo, $type);\n\n        // field_name の並びが変わったら即ロールバック\n        if ($before !== $after) {\n            throw new RuntimeException(\"列順が変化: {$type}\");\n        }\n    }\n\n    $pdo-\u003ecommit();\n} catch (Throwable $e) {\n    $pdo-\u003erollBack();\n    throw $e;\n}\n\nfunction fetchOrderHash(PDO $pdo, string $type): string\n{\n    $stmt = $pdo-\u003eprepare(\n        \"SELECT field_name FROM dtb_csv\n         WHERE csv_type = :t AND enabled = 1\n         ORDER BY sort_no, csv_id\"\n    );\n    $stmt-\u003eexecute([':t' =\u003e $type]);\n    return hash('sha256', implode(',', $stmt-\u003efetchAll(PDO::FETCH_COLUMN)));\n}\n```\n\nここでのミソは、比較対象を `sort_no` そのものではなく **`field_name` の並び**にしている点です。番号の振り直しは番号が変わることを目的にしているので、番号を比較しては意味がありません。「利用者から見た列の並びが変わっていないか」を検証する必要があります。\n\n## 移行前チェックリストの見直し\n\n今回の件を受けて、バージョンアップ前の確認項目の先頭に「**並び順の根拠が一意か**」を置きました。データが正しくても、順序の保証が変われば壊れる箇所があるからです。\n\n| 優先 | チェック項目 | 確認方法 | 理由 |\n| --- | --- | --- | --- |\n| 1 | 並び順の根拠が一意か | `GROUP BY ... HAVING COUNT(*) \u003e 1` | 順序保証の変化で最初に壊れる |\n| 2 | 件数の一致 | 移行前後の `COUNT(*)` 比較 | 欠損・重複の検出 |\n| 3 | チェックサム一致 | `CHECKSUM TABLE` / 全列ハッシュ | 値の破壊検出 |\n| 4 | 実行計画の変化 | `EXPLAIN` の前後比較 | 性能劣化の予兆 |\n| 5 | 文字照合順序 | `utf8mb4_0900_ai_ci` への変更影響 | 検索結果の差分 |\n\n「件数の一致検証と並び順の一意性、どちらを先に確認するか」と問われたら、私は**並び順の一意性を先**にします。件数は合っていても順序が壊れていれば、取込側で値がずれたまま正常終了してしまうからです。件数不一致はまだ気づけますが、列ずれは気づけません。\n\n## ハマりポイント\n\n- **`ORDER BY` にタイブレークキーを入れ忘れる**。`ORDER BY sort_no` だけの箇所は全て `ORDER BY sort_no, csv_id` に直す。アプリ側のSQLも同様。\n- **`ONLY_FULL_GROUP_BY`**。5.7からデフォルト有効ですが、8.4でも有効です。`SELECT csv_type, field_name ... GROUP BY csv_type` のような雑なクエリが移行後にエラーになります。\n- **`ERROR 1093`**。同一テーブルをサブクエリで参照するUPDATEは避け、一時テーブルか派生テーブルを使う。\n- **認証プラグインの変更**。`mysql_native_password` から `caching_sha2_password` へ変わり、古いPDO/ドライバだと接続できないことがあります。\n- **照合順序のデフォルト変更**。`utf8mb4_0900_ai_ci` になり、`ORDER BY name` の結果が5.7と変わる場合があります。これも「静かに変わる」系です。\n\n## FAQ\n\n**Q. 5.7で今まで動いていたのに、なぜ8.4で急に壊れるのですか？**\nA. 同値グループ内の順序は5.7でも仕様上は不定です。たまたま主キー順で返っていただけで、8.0以降のオプティマイザ変更でその「偶然」が成立しなくなった、というのが正確な理解です。バグではなく、未定義動作への依存が露呈した形です。\n\n**Q. `sort_no` にUNIQUE制約を付ければ再発しませんか？**\nA. 再発は防げますが、既存データの重複を先に解消する必要があります。また `(csv_type, sort_no)` の複合UNIQUEにしないと意味がありません。中長期的には制約追加をおすすめします。\n\n**Q. 振り直しで列順が変わってしまうことはありませんか？**\nA. `(sort_no, csv_id)` で採番するため、重複していた場合のみ順序が確定します。手順3のハッシュ比較で `field_name` の並びが変わった場合はロールバックするので、安全側に倒せます。\n\n**Q. 本番適用前に何を確認すべきですか？**\nA. ステージングで同じSQLを流し、出力CSVのヘッダ行を移行前後でdiffしてください。列数と列名の並びが完全一致していれば合格です。\n\n## まとめ\n\n- 列順の根拠が `sort_no` のように**単一カラムで重複し得る**設計は、MySQLのバージョンアップで静かに壊れる\n- 対策は「検出 → 重複分だけ振り直し → トランザクション内で並びを比較してロールバック」の3段階\n- マイグレーションスクリプトは冪等に。比較は番号ではなく**利用者から見た列の並び**で行う\n- 移行前チェックは「並び順の根拠が一意か」を件数一致より先に確認する\n\nデータが正しいことと、順序が保証されていることは別問題です。バージョンアップで後者が変わる可能性を、チェックリストの先頭に置いておくのが安全です。\n\n---\n\n## この記事を書いた人\n\n**BENTEN Web Works** — 業務自動化・システム開発のフリーランスエンジニアです。\n\nGAS / Python / RPA を使った業務自動化や、Web制作・システム開発のご相談を承っています。\n「こんなこと自動化できる？」というご質問だけでもお気軽にどうぞ。\n\n👉 **[BENTEN Web Works](https://bentenweb.com)** — 詳細・お問い合わせはこちら\n🐦 **[X（旧Twitter）](https://x.com/Fumi_BENTENweb)** — 日々の知見を発信中\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T03:14:42+09:00","group":null,"id":"30f1294497aed0c70104","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"AI","versions":[]}],"title":"MySQL 5.7→8.4移行でCSVの列順が静かに変わる — 並び番号の重複を検出・振り直し・検証する","updated_at":"2026-11-18T03:14:42+09:00","url":"https://qiita.com/freefreefree1222/items/30f1294497aed0c70104","user":{"description":null,"facebook_id":null,"followees_count":0,"followers_count":1,"github_login_name":null,"id":"freefreefree1222","items_count":75,"linkedin_id":null,"location":null,"name":"","organization":null,"permanent_id":3953333,"profile_image_url":"https://s3-ap-northeast-1.amazonaws.com/qiita-image-store/0/3953333/27c71ebd9cba8315167a971ffbdedafee4e38197/x_large.png?1775357073","team_only":false,"twitter_screen_name":null,"website_url":null},"page_views_count":null,"team_membership":null,"organization_url_name":null,"slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003ch2 data-sourcepos=\"2:1-2:15\"\u003e\n\u003cspan id=\"はじめに\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eはじめに\u003c/h2\u003e\n\u003cp data-sourcepos=\"4:1-4:127\"\u003eプリザンター 1.5.10.0 のリリースノートには、パスキー認証に関する修正が 3 つ入っています。\u003c/p\u003e\n\u003cul data-sourcepos=\"6:1-9:0\"\u003e\n\u003cli data-sourcepos=\"6:1-6:93\"\u003eセッションの保存先を Redis にすると、パスキー認証が利用できない\u003c/li\u003e\n\u003cli data-sourcepos=\"7:1-7:74\"\u003e無効にしたユーザでもパスキー認証でログインできる\u003c/li\u003e\n\u003cli data-sourcepos=\"8:1-9:0\"\u003eパスキーの登録途中で別のユーザでログインし直しても、登録が完了できてしまう\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"10:1-10:271\"\u003eこの記事では、1.5.9.1 から 1.5.10.0 までの差分を追いかけて、\u003cstrong\u003eどのコードがどう変わったのか\u003c/strong\u003eを具体的に読み解きます。パスキーの仕組みを知らなくても読めるように、先に処理の流れを整理します。\u003c/p\u003e\n\u003cdiv data-sourcepos=\"12:1-14:3\" class=\"note info\"\u003e\n\u003cspan class=\"fa fa-fw fa-check-circle\"\u003e\u003c/span\u003e\u003cdiv\u003e\n\u003cp data-sourcepos=\"13:1-13:368\"\u003e対象は 1.5.9.1 → 1.5.10.0 の差分です。コードの引用は 1.5.10.0 のコミット（\u003ccode\u003ec6d8974df84ab5ba6029aaf394f9613b3a4211cb\u003c/code\u003e）、修正前は 1.5.9.1 のコミット（\u003ccode\u003e1c693a1ee379a87e588232e43216400431376653\u003c/code\u003e）に固定しています。いずれもソースを読んだ結果で、各経路を実行して再現した結果ではありません。\u003c/p\u003e\n\u003c/div\u003e\n\u003c/div\u003e\n\u003ch2 data-sourcepos=\"16:1-16:33\"\u003e\n\u003cspan id=\"パスキーの処理の流れ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%91%E3%82%B9%E3%82%AD%E3%83%BC%E3%81%AE%E5%87%A6%E7%90%86%E3%81%AE%E6%B5%81%E3%82%8C\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eパスキーの処理の流れ\u003c/h2\u003e\n\u003cp data-sourcepos=\"18:1-18:327\"\u003eパスキー（WebAuthn）の登録とログインは、どちらも\u003cstrong\u003eサーバーが作った「チャレンジ入りのオプション」をブラウザーに渡し、ブラウザーが認証器で署名した応答を返し、サーバーが元のオプションと突き合わせて検証する\u003c/strong\u003eという 2 往復です。\u003c/p\u003e\n\u003ciframe id=\"qiita-embed-content__309d103564e7e82d371ee10b7d75491f\" src=\"https://qiita.com/embed-contents/mermaid#qiita-embed-content__309d103564e7e82d371ee10b7d75491f\" style=\"width:100%;\" frameborder=\"0\" scrolling=\"no\" loading=\"lazy\" data-content='{\"data\":\"sequenceDiagram\\n participant B as ブラウザー\\n participant S as プリザンター\\n B-\u0026gt;\u0026gt;S: 1. オプションの要求（登録: CreateOptions／ログイン: AssertionOptions）\\n S-\u0026gt;\u0026gt;S: オプションをセッションへ保存\\n S--\u0026gt;\u0026gt;B: オプション（チャレンジ入り）\\n B-\u0026gt;\u0026gt;B: 認証器で署名\\n B-\u0026gt;\u0026gt;S: 2. 署名の応答（登録: MakeCredential／ログイン: MakeAssertion）\\n S-\u0026gt;\u0026gt;S: セッションからオプションを取り出して検証\\n S--\u0026gt;\u0026gt;B: 結果\",\"key\":\"00f29b4df1d21286c7df5890cd2aa7e9\"}'\u003e\n\u003c/iframe\u003e\n\n\u003cp data-sourcepos=\"33:1-33:272\"\u003eつまり\u003cstrong\u003eセッションに預けたオプションが、2 回目のリクエストで確実に、1 回だけ、正しい相手のものとして取り出せるか\u003c/strong\u003eが安全性の要です。今回の 3 つの修正は、この前後の扱いに関わっています。\u003c/p\u003e\n\u003cp data-sourcepos=\"35:1-35:336\"\u003eプリザンターでは \u003ccode\u003ePasskeysController\u003c/code\u003e が 4 つの入口（登録のオプション作成・登録の完了、ログインのオプション作成・ログインの完了）を持ち、オプションは \u003ccode\u003ePasskeyUtilities.SessionSet\u003c/code\u003e でセッションに保存します。キーには \u003ccode\u003ePasskeys_\u003c/code\u003e の接頭辞が付きます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"csharp\" data-sourcepos=\"37:1-42:3\"\u003e\n\u003cdiv class=\"code-lang\"\u003e\u003cspan class=\"bold\"\u003ePasskeyUtilities.cs\u003c/span\u003e\u003c/div\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"n\"\u003eSessionUtilities\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eSet\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n    \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"n\"\u003ekey\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"s\"\u003e$\"Passkeys_\u003c/span\u003e\u003cspan class=\"p\"\u003e{\u003c/span\u003e\u003cspan class=\"n\"\u003ekey\u003c/span\u003e\u003cspan class=\"p\"\u003e}\u003c/span\u003e\u003cspan class=\"s\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"k\"\u003evalue\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003estringValue\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\n\u003c/div\u003e\n\u003cp data-sourcepos=\"44:1-44:182\"\u003e（\u003ca href=\"https://github.com/Implem/Implem.Pleasanter/blob/c6d8974df84ab5ba6029aaf394f9613b3a4211cb/Implem.Pleasanter/Models/Passkeys/PasskeyUtilities.cs#L250-L267\" rel=\"nofollow noopener\" target=\"_blank\"\u003ePasskeyUtilities.cs\u003c/a\u003e）\u003c/p\u003e\n\u003ch2 data-sourcepos=\"46:1-46:81\"\u003e\n\u003cspan id=\"修正1取り出しと削除を1-回の原子的な操作に変えた\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BF%AE%E6%AD%A31%E5%8F%96%E3%82%8A%E5%87%BA%E3%81%97%E3%81%A8%E5%89%8A%E9%99%A4%E3%82%921-%E5%9B%9E%E3%81%AE%E5%8E%9F%E5%AD%90%E7%9A%84%E3%81%AA%E6%93%8D%E4%BD%9C%E3%81%AB%E5%A4%89%E3%81%88%E3%81%9F\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e修正1：取り出しと削除を「1 回の原子的な操作」に変えた\u003c/h2\u003e\n\u003cp data-sourcepos=\"48:1-48:87\"\u003e修正は、セッションからの取り出し方そのものを変えています。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"50:1-50:49\"\u003e\n\u003cspan id=\"修正前読んでから別操作で消す\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BF%AE%E6%AD%A3%E5%89%8D%E8%AA%AD%E3%82%93%E3%81%A7%E3%81%8B%E3%82%89%E5%88%A5%E6%93%8D%E4%BD%9C%E3%81%A7%E6%B6%88%E3%81%99\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e修正前：読んでから別操作で消す\u003c/h3\u003e\n\u003cp data-sourcepos=\"52:1-52:140\"\u003e1.5.9.1 の \u003ccode\u003eMakeCredential\u003c/code\u003e（登録の完了）と \u003ccode\u003eMakeAssertion\u003c/code\u003e（ログインの完了）は、次の順に処理していました。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"csharp\" data-sourcepos=\"54:1-65:3\"\u003e\n\u003cdiv class=\"code-lang\"\u003e\u003cspan class=\"bold\"\u003ePasskeysController.cs（1.5.9.1）\u003c/span\u003e\u003c/div\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"kt\"\u003evar\u003c/span\u003e \u003cspan class=\"n\"\u003ebodyData\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003eJsonSerializer\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eDeserialize\u003c/span\u003e\u003cspan class=\"p\"\u003e\u0026lt;\u003c/span\u003e\u003cspan class=\"n\"\u003eAuthenticatorAttestationRawResponse\u003c/span\u003e\u003cspan class=\"p\"\u003e\u0026gt;(\u003c/span\u003e\u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eForms\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eData\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"s\"\u003e\"data\"\u003c/span\u003e\u003cspan class=\"p\"\u003e));\u003c/span\u003e\n\u003cspan class=\"kt\"\u003evar\u003c/span\u003e \u003cspan class=\"n\"\u003eoptionsJson\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003ePasskeyUtilities\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eSessionGetString\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n    \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"n\"\u003ekey\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003eFido2AttestationOptions\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n\u003cspan class=\"k\"\u003eif\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eoptionsJson\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eIsNullOrWhiteSpace\u003c/span\u003e\u003cspan class=\"p\"\u003e())\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"n\"\u003eMessages\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eResponsePasskeyResponseInvalid\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n        \u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eToJson\u003c/span\u003e\u003cspan class=\"p\"\u003e();\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003cspan class=\"n\"\u003ePasskeyUtilities\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eSessionRemove\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003ekey\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003eFido2AttestationOptions\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\n\u003c/div\u003e\n\u003cp data-sourcepos=\"67:1-67:118\"\u003e\u003ccode\u003eSessionGetString\u003c/code\u003e が\u003cstrong\u003e取得\u003c/strong\u003eし、その後で \u003ccode\u003eSessionRemove\u003c/code\u003e が\u003cstrong\u003e削除\u003c/strong\u003eします。2 つの別操作です。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"69:1-69:59\"\u003e\n\u003cspan id=\"修正後take-で取得と削除を同時に行う\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BF%AE%E6%AD%A3%E5%BE%8Ctake-%E3%81%A7%E5%8F%96%E5%BE%97%E3%81%A8%E5%89%8A%E9%99%A4%E3%82%92%E5%90%8C%E6%99%82%E3%81%AB%E8%A1%8C%E3%81%86\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e修正後：\u003ccode\u003eTake\u003c/code\u003e で取得と削除を同時に行う\u003c/h3\u003e\n\u003cp data-sourcepos=\"71:1-71:100\"\u003e1.5.10.0 では \u003ccode\u003eSessionTakeString\u003c/code\u003e に置き換わり、\u003ccode\u003eSessionRemove\u003c/code\u003e は削除されました。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"csharp\" data-sourcepos=\"73:1-83:3\"\u003e\n\u003cdiv class=\"code-lang\"\u003e\u003cspan class=\"bold\"\u003ePasskeysController.cs\u003c/span\u003e\u003c/div\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"kt\"\u003evar\u003c/span\u003e \u003cspan class=\"n\"\u003eoptionsJson\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003ePasskeyUtilities\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eSessionTakeString\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n    \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"n\"\u003ekey\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003eFido2AttestationOptions\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n\u003cspan class=\"k\"\u003eif\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eoptionsJson\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eIsNullOrWhiteSpace\u003c/span\u003e\u003cspan class=\"p\"\u003e())\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"n\"\u003eMessages\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eResponsePasskeyResponseInvalid\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n        \u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eToJson\u003c/span\u003e\u003cspan class=\"p\"\u003e();\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003cspan class=\"kt\"\u003evar\u003c/span\u003e \u003cspan class=\"n\"\u003ebodyData\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003eJsonSerializer\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eDeserialize\u003c/span\u003e\u003cspan class=\"p\"\u003e\u0026lt;\u003c/span\u003e\u003cspan class=\"n\"\u003eAuthenticatorAttestationRawResponse\u003c/span\u003e\u003cspan class=\"p\"\u003e\u0026gt;(\u003c/span\u003e\u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eForms\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eData\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"s\"\u003e\"data\"\u003c/span\u003e\u003cspan class=\"p\"\u003e));\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\n\u003c/div\u003e\n\u003cp data-sourcepos=\"85:1-85:192\"\u003e（\u003ca href=\"https://github.com/Implem/Implem.Pleasanter/blob/c6d8974df84ab5ba6029aaf394f9613b3a4211cb/Implem.Pleasanter/Controllers/PasskeysController.cs#L134-L142\" rel=\"nofollow noopener\" target=\"_blank\"\u003ePasskeysController.cs#L134-L142\u003c/a\u003e）\u003c/p\u003e\n\u003cp data-sourcepos=\"87:1-87:337\"\u003e細かい点ですが、\u003cstrong\u003e応答の JSON のデシリアライズを、オプションの取り出しより後ろに移動\u003c/strong\u003eしています。不正な本文を送ってもオプションの取り出し（＝消費）は先に済むので、「失敗しても同じオプションで何度でも試せる」状態にはなりません。\u003c/p\u003e\n\u003cp data-sourcepos=\"89:1-89:84\"\u003e\u003ccode\u003eSessionTakeString\u003c/code\u003e の中身は、新設された \u003ccode\u003eSessionUtilities.Take\u003c/code\u003e です。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"csharp\" data-sourcepos=\"91:1-98:3\"\u003e\n\u003cdiv class=\"code-lang\"\u003e\u003cspan class=\"bold\"\u003ePasskeyUtilities.cs\u003c/span\u003e\u003c/div\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"k\"\u003estatic\u003c/span\u003e \u003cspan class=\"kt\"\u003estring\u003c/span\u003e \u003cspan class=\"nf\"\u003eSessionTakeString\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eContext\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"kt\"\u003estring\u003c/span\u003e \u003cspan class=\"n\"\u003ekey\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"n\"\u003eSessionUtilities\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eTake\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n        \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n        \u003cspan class=\"n\"\u003ekey\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"s\"\u003e$\"Passkeys_\u003c/span\u003e\u003cspan class=\"p\"\u003e{\u003c/span\u003e\u003cspan class=\"n\"\u003ekey\u003c/span\u003e\u003cspan class=\"p\"\u003e}\u003c/span\u003e\u003cspan class=\"s\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e??\u003c/span\u003e \u003cspan class=\"kt\"\u003estring\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eEmpty\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\n\u003c/div\u003e\n\u003ch3 data-sourcepos=\"100:1-100:65\"\u003e\n\u003cspan id=\"take-の実装保存先ごとに原子的に取り出す\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#take-%E3%81%AE%E5%AE%9F%E8%A3%85%E4%BF%9D%E5%AD%98%E5%85%88%E3%81%94%E3%81%A8%E3%81%AB%E5%8E%9F%E5%AD%90%E7%9A%84%E3%81%AB%E5%8F%96%E3%82%8A%E5%87%BA%E3%81%99\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e\u003ccode\u003eTake\u003c/code\u003e の実装：保存先ごとに原子的に取り出す\u003c/h3\u003e\n\u003cp data-sourcepos=\"102:1-102:254\"\u003e\u003ccode\u003eTake\u003c/code\u003e は、保存先によって 2 通りに分かれます（\u003ca href=\"https://github.com/Implem/Implem.Pleasanter/blob/c6d8974df84ab5ba6029aaf394f9613b3a4211cb/Implem.Pleasanter/Models/Sessions/SessionUtilities.cs#L30-L100\" rel=\"nofollow noopener\" target=\"_blank\"\u003eSessionUtilities.cs#L30-L100\u003c/a\u003e）。\u003c/p\u003e\n\u003cp data-sourcepos=\"104:1-104:143\"\u003e\u003cstrong\u003eRedis（\u003ccode\u003eParameters.Session.UseKeyValueStore\u003c/code\u003e）の場合\u003c/strong\u003eは、Lua スクリプトで取得と削除を 1 回の命令にまとめます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"csharp\" data-sourcepos=\"106:1-114:3\"\u003e\n\u003cdiv class=\"code-lang\"\u003e\u003cspan class=\"bold\"\u003eSessionUtilities.cs\u003c/span\u003e\u003c/div\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"kt\"\u003evar\u003c/span\u003e \u003cspan class=\"n\"\u003eresult\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003eImplem\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003ePleasanter\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eLibraries\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eRedis\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eCacheForRedisConnection\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eConnection\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eGetDatabase\u003c/span\u003e\u003cspan class=\"p\"\u003e().\u003c/span\u003e\u003cspan class=\"nf\"\u003eScriptEvaluate\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n        \u003cspan class=\"n\"\u003escript\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"s\"\u003e\"local value = redis.call('HGET', KEYS[1], ARGV[1]); \"\u003c/span\u003e\n            \u003cspan class=\"p\"\u003e+\u003c/span\u003e \u003cspan class=\"s\"\u003e\"if value then redis.call('HDEL', KEYS[1], ARGV[1]); return value end; return false\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n        \u003cspan class=\"n\"\u003ekeys\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"k\"\u003enew\u003c/span\u003e \u003cspan class=\"n\"\u003eStackExchange\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eRedis\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eRedisKey\u003c/span\u003e\u003cspan class=\"p\"\u003e[]\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e \u003cspan class=\"n\"\u003etarget\u003c/span\u003e \u003cspan class=\"p\"\u003e},\u003c/span\u003e\n        \u003cspan class=\"n\"\u003evalues\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"k\"\u003enew\u003c/span\u003e \u003cspan class=\"n\"\u003eStackExchange\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eRedis\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eRedisValue\u003c/span\u003e\u003cspan class=\"p\"\u003e[]\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e \u003cspan class=\"n\"\u003efield\u003c/span\u003e \u003cspan class=\"p\"\u003e});\u003c/span\u003e\n\u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003estring\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\u003cspan class=\"n\"\u003eresult\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\n\u003c/div\u003e\n\u003cp data-sourcepos=\"116:1-116:147\"\u003eRedis はスクリプトを 1 つの命令として実行するので、\u003ccode\u003eHGET\u003c/code\u003e と \u003ccode\u003eHDEL\u003c/code\u003e の間に他のリクエストが割り込めません。\u003c/p\u003e\n\u003cp data-sourcepos=\"118:1-118:143\"\u003e\u003cstrong\u003eデータベース（SQL Server・PostgreSQL・MySQL）の場合\u003c/strong\u003eは、DBMS ごとに「削除しながら値を返す」SQL にします。\u003c/p\u003e\n\u003ctable data-sourcepos=\"120:1-124:135\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"120:1-120:17\"\u003e\n\u003cth data-sourcepos=\"120:2-120:7\"\u003eDBMS\u003c/th\u003e\n\u003cth data-sourcepos=\"120:9-120:16\"\u003e方法\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"122:1-122:52\"\u003e\n\u003ctd data-sourcepos=\"122:2-122:13\"\u003eSQL Server\u003c/td\u003e\n\u003ctd data-sourcepos=\"122:15-122:51\"\u003e\u003ccode\u003edelete ... output deleted.\"Value\"\u003c/code\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"123:1-123:47\"\u003e\n\u003ctd data-sourcepos=\"123:2-123:13\"\u003ePostgreSQL\u003c/td\u003e\n\u003ctd data-sourcepos=\"123:15-123:46\"\u003e\u003ccode\u003edelete ... returning \"Value\"\u003c/code\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"124:1-124:135\"\u003e\n\u003ctd data-sourcepos=\"124:2-124:8\"\u003eMySQL\u003c/td\u003e\n\u003ctd data-sourcepos=\"124:10-124:134\"\u003e\n\u003ccode\u003eselect ... for update\u003c/code\u003e で行を押さえ、続けて \u003ccode\u003edelete\u003c/code\u003e（削除できた件数が 1 のときだけ値を返す）\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"126:1-126:442\"\u003eMySQL は \u003ccode\u003ereturning\u003c/code\u003e を持たないため、トランザクションの中で \u003ccode\u003efor update\u003c/code\u003e により行をロックしてから削除しています。この 3 つ以外の DBMS は \u003ccode\u003eNotSupportedException\u003c/code\u003e で、原子的に取り出せない状態を黙って通すことはしません。さらに、削除の条件には \u003ccode\u003eReadOnce\u003c/code\u003e と \u003ccode\u003eUserArea\u003c/code\u003e のどちらも立っていない行だけを対象にする条件が付いています。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"128:1-128:34\"\u003e\n\u003cspan id=\"これで何が防がれるか\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%93%E3%82%8C%E3%81%A7%E4%BD%95%E3%81%8C%E9%98%B2%E3%81%8C%E3%82%8C%E3%82%8B%E3%81%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eこれで何が防がれるか\u003c/h3\u003e\n\u003cp data-sourcepos=\"130:1-130:518\"\u003e「オプションは 1 回しか使えない」ことが、チャレンジを使った検証の前提です。取得と削除が別操作だと、\u003cstrong\u003e同じセッションで 2 つのリクエストをほぼ同時に送ると、両方が「まだ残っている」オプションを取得できる\u003c/strong\u003e可能性があります。\u003ccode\u003eTake\u003c/code\u003e は、片方だけが値を受け取り、もう片方は空文字列になるため、\u003ccode\u003eoptionsJson.IsNullOrWhiteSpace()\u003c/code\u003e の分岐で \u003ccode\u003eResponsePasskeyResponseInvalid\u003c/code\u003e になります。\u003c/p\u003e\n\u003cdiv data-sourcepos=\"132:1-134:3\" class=\"note warn\"\u003e\n\u003cspan class=\"fa fa-fw fa-exclamation-circle\"\u003e\u003c/span\u003e\u003cdiv\u003e\n\u003cp data-sourcepos=\"133:1-133:255\"\u003eこの競合が実際に悪用できるかどうかは、ここでは検証していません。コードから言えるのは、修正前は取得と削除が別操作で、修正後は 1 回の原子的な操作になった、という点までです。\u003c/p\u003e\n\u003c/div\u003e\n\u003c/div\u003e\n\u003ch2 data-sourcepos=\"136:1-136:79\"\u003e\n\u003cspan id=\"修正2redis-のときにオプションを取り出せなかった問題\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BF%AE%E6%AD%A32redis-%E3%81%AE%E3%81%A8%E3%81%8D%E3%81%AB%E3%82%AA%E3%83%97%E3%82%B7%E3%83%A7%E3%83%B3%E3%82%92%E5%8F%96%E3%82%8A%E5%87%BA%E3%81%9B%E3%81%AA%E3%81%8B%E3%81%A3%E3%81%9F%E5%95%8F%E9%A1%8C\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e修正2：Redis のときにオプションを取り出せなかった問題\u003c/h2\u003e\n\u003cp data-sourcepos=\"138:1-138:206\"\u003eリリースノートの「セッションの保存先を Redis にすると、パスキー認証が利用できない」は、\u003ccode\u003eTake\u003c/code\u003e の追加でなぜ直るのかが、コードから読み取れます。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"140:1-140:75\"\u003e\n\u003cspan id=\"修正前キーを-_-で分割して先頭だけを使っていた\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BF%AE%E6%AD%A3%E5%89%8D%E3%82%AD%E3%83%BC%E3%82%92-_-%E3%81%A7%E5%88%86%E5%89%B2%E3%81%97%E3%81%A6%E5%85%88%E9%A0%AD%E3%81%A0%E3%81%91%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%A6%E3%81%84%E3%81%9F\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e修正前：キーを \u003ccode\u003e_\u003c/code\u003e で分割して先頭だけを使っていた\u003c/h3\u003e\n\u003cp data-sourcepos=\"142:1-142:183\"\u003eRedis 利用時の \u003ccode\u003eSessionUtilities.Get\u003c/code\u003e は、Redis のハッシュのフィールド名を \u003ccode\u003e_\u003c/code\u003e で分割し、\u003cstrong\u003e先頭の要素をキー\u003c/strong\u003eにした辞書を返していました。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"csharp\" data-sourcepos=\"144:1-151:3\"\u003e\n\u003cdiv class=\"code-lang\"\u003e\u003cspan class=\"bold\"\u003eSessionUtilities.cs（1.5.9.1）\u003c/span\u003e\u003c/div\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"kt\"\u003evar\u003c/span\u003e \u003cspan class=\"n\"\u003esessions\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003eiDatabase\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eHashGetAll\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003ekey\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eWhere\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003edataRow\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e\n        \u003cspan class=\"n\"\u003edataRow\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eName\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eToString\u003c/span\u003e\u003cspan class=\"p\"\u003e().\u003c/span\u003e\u003cspan class=\"nf\"\u003eSplit\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"sc\"\u003e'_'\u003c/span\u003e\u003cspan class=\"p\"\u003e).\u003c/span\u003e\u003cspan class=\"nf\"\u003eCount\u003c/span\u003e\u003cspan class=\"p\"\u003e()\u003c/span\u003e \u003cspan class=\"p\"\u003e==\u003c/span\u003e \u003cspan class=\"m\"\u003e1\u003c/span\u003e \u003cspan class=\"p\"\u003e||\u003c/span\u003e\n        \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003ePage\u003c/span\u003e \u003cspan class=\"p\"\u003e==\u003c/span\u003e \u003cspan class=\"k\"\u003enull\u003c/span\u003e \u003cspan class=\"p\"\u003e\u0026amp;\u0026amp;\u003c/span\u003e \u003cspan class=\"n\"\u003esessionGuid\u003c/span\u003e \u003cspan class=\"p\"\u003e==\u003c/span\u003e \u003cspan class=\"k\"\u003enull\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e||\u003c/span\u003e\n        \u003cspan class=\"n\"\u003edataRow\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eName\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eToString\u003c/span\u003e\u003cspan class=\"p\"\u003e().\u003c/span\u003e\u003cspan class=\"nf\"\u003eSplit\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"sc\"\u003e'_'\u003c/span\u003e\u003cspan class=\"p\"\u003e)[\u003c/span\u003e\u003cspan class=\"m\"\u003e1\u003c/span\u003e\u003cspan class=\"p\"\u003e]\u003c/span\u003e \u003cspan class=\"p\"\u003e==\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003ePage\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eToDictionary\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003edataRow\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003edataRow\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eName\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eToString\u003c/span\u003e\u003cspan class=\"p\"\u003e().\u003c/span\u003e\u003cspan class=\"nf\"\u003eSplit\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"sc\"\u003e'_'\u003c/span\u003e\u003cspan class=\"p\"\u003e)[\u003c/span\u003e\u003cspan class=\"m\"\u003e0\u003c/span\u003e\u003cspan class=\"p\"\u003e],\u003c/span\u003e \u003cspan class=\"n\"\u003edataRow\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003edataRow\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eValue\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eToString\u003c/span\u003e\u003cspan class=\"p\"\u003e());\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\n\u003c/div\u003e\n\u003cp data-sourcepos=\"153:1-153:192\"\u003e（\u003ca href=\"https://github.com/Implem/Implem.Pleasanter/blob/1c693a1ee379a87e588232e43216400431376653/Implem.Pleasanter/Models/Sessions/SessionUtilities.cs#L44\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.5.9.1 の SessionUtilities.cs#L44\u003c/a\u003e）\u003c/p\u003e\n\u003cp data-sourcepos=\"155:1-155:369\"\u003eこれは、Redis のフィールド名が \u003ccode\u003eキー\u003c/code\u003e または \u003ccode\u003eキー_ページ名\u003c/code\u003e の形で保存されることを前提にした作りです。ところがパスキーのキーは、\u003ccode\u003ePasskeys_Fido2AttestationOptions\u003c/code\u003e のように、\u003cstrong\u003eキー自体に \u003ccode\u003e_\u003c/code\u003e を含みます\u003c/strong\u003e。\u003ccode\u003eSplit('_')[0]\u003c/code\u003e を取ると、辞書のキーは \u003ccode\u003ePasskeys\u003c/code\u003e になってしまいます。\u003c/p\u003e\n\u003cp data-sourcepos=\"157:1-157:104\"\u003e一方、取得する側は修正前の \u003ccode\u003eSessionGetString\u003c/code\u003e で、次のようにキーを探します。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"csharp\" data-sourcepos=\"159:1-166:3\"\u003e\n\u003cdiv class=\"code-lang\"\u003e\u003cspan class=\"bold\"\u003ePasskeyUtilities.cs（1.5.9.1）\u003c/span\u003e\u003c/div\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"kt\"\u003evar\u003c/span\u003e \u003cspan class=\"n\"\u003edic\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003eSessionUtilities\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eGet\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n\u003cspan class=\"k\"\u003eif\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003edic\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eTryGetValue\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"s\"\u003e$\"Passkeys_\u003c/span\u003e\u003cspan class=\"p\"\u003e{\u003c/span\u003e\u003cspan class=\"n\"\u003ekey\u003c/span\u003e\u003cspan class=\"p\"\u003e}\u003c/span\u003e\u003cspan class=\"s\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"k\"\u003eout\u003c/span\u003e \u003cspan class=\"kt\"\u003evar\u003c/span\u003e \u003cspan class=\"n\"\u003ejson\u003c/span\u003e\u003cspan class=\"p\"\u003e))\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"n\"\u003ejson\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"kt\"\u003estring\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eEmpty\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\n\u003c/div\u003e\n\u003cp data-sourcepos=\"168:1-168:473\"\u003e辞書にあるのは \u003ccode\u003ePasskeys\u003c/code\u003e で、探しているのは \u003ccode\u003ePasskeys_Fido2AttestationOptions\u003c/code\u003e ですから、\u003cstrong\u003eRedis のときは一致せず、必ず空文字列が返ります\u003c/strong\u003e。空なら \u003ccode\u003eResponsePasskeyResponseInvalid\u003c/code\u003e になるので、登録もログインも完了できません。リリースノートの症状と一致します。データベースを使う構成では、\u003ccode\u003eKey\u003c/code\u003e 列を丸ごと辞書のキーにするため、この問題は起きません。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"170:1-170:67\"\u003e\n\u003cspan id=\"修正後分割せずフィールド名をそのまま使う\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BF%AE%E6%AD%A3%E5%BE%8C%E5%88%86%E5%89%B2%E3%81%9B%E3%81%9A%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E5%90%8D%E3%82%92%E3%81%9D%E3%81%AE%E3%81%BE%E3%81%BE%E4%BD%BF%E3%81%86\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e修正後：分割せずフィールド名をそのまま使う\u003c/h3\u003e\n\u003cp data-sourcepos=\"172:1-172:107\"\u003e\u003ccode\u003eTake\u003c/code\u003e は \u003ccode\u003eGet\u003c/code\u003e を経由せず、\u003cstrong\u003eフィールド名をそのまま\u003c/strong\u003e \u003ccode\u003eHGET\u003c/code\u003e / \u003ccode\u003eHDEL\u003c/code\u003e に渡します。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"csharp\" data-sourcepos=\"174:1-176:3\"\u003e\n\u003cdiv class=\"code-lang\"\u003e\u003cspan class=\"bold\"\u003eSessionUtilities.cs\u003c/span\u003e\u003c/div\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"kt\"\u003evar\u003c/span\u003e \u003cspan class=\"n\"\u003efield\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003epageName\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eLength\u003c/span\u003e \u003cspan class=\"p\"\u003e==\u003c/span\u003e \u003cspan class=\"m\"\u003e0\u003c/span\u003e \u003cspan class=\"p\"\u003e?\u003c/span\u003e \u003cspan class=\"n\"\u003ekey\u003c/span\u003e \u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"s\"\u003e$\"\u003c/span\u003e\u003cspan class=\"p\"\u003e{\u003c/span\u003e\u003cspan class=\"n\"\u003ekey\u003c/span\u003e\u003cspan class=\"p\"\u003e}\u003c/span\u003e\u003cspan class=\"s\"\u003e_\u003c/span\u003e\u003cspan class=\"p\"\u003e{\u003c/span\u003e\u003cspan class=\"n\"\u003epageName\u003c/span\u003e\u003cspan class=\"p\"\u003e}\u003c/span\u003e\u003cspan class=\"s\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\n\u003c/div\u003e\n\u003cp data-sourcepos=\"178:1-178:124\"\u003e\u003ccode\u003ekey\u003c/code\u003e は \u003ccode\u003ePasskeys_Fido2AttestationOptions\u003c/code\u003e のままで、分割しません。これで Redis でも取り出せます。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"180:1-180:46\"\u003e\n\u003cspan id=\"削除側にあったもう-1-つの穴\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%89%8A%E9%99%A4%E5%81%B4%E3%81%AB%E3%81%82%E3%81%A3%E3%81%9F%E3%82%82%E3%81%86-1-%E3%81%A4%E3%81%AE%E7%A9%B4\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e削除側にあった、もう 1 つの穴\u003c/h3\u003e\n\u003cp data-sourcepos=\"182:1-182:693\"\u003e修正前の \u003ccode\u003eSessionRemove\u003c/code\u003e は、\u003ccode\u003eSessionUtilities.Remove\u003c/code\u003e を呼んでいました。この関数は \u003ccode\u003eRds.PhysicalDeleteSessions\u003c/code\u003e で\u003cstrong\u003eデータベースの \u003ccode\u003eSessions\u003c/code\u003e テーブルだけを削除\u003c/strong\u003eします（\u003ca href=\"https://github.com/Implem/Implem.Pleasanter/blob/1c693a1ee379a87e588232e43216400431376653/Implem.Pleasanter/Models/Sessions/SessionUtilities.cs#L248\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.5.9.1 の SessionUtilities.cs#L248\u003c/a\u003e）。Redis にある値には触れません。そのため、仮に取得できていたとしても、Redis では「使い終わったオプションが消えずに残る」ことになります。\u003ccode\u003eTake\u003c/code\u003e は取得と削除を Redis 側で行うので、この点も解消しています。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"184:1-184:79\"\u003e\n\u003cspan id=\"修正3登録の完了時に誰のオプションかを確認する\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BF%AE%E6%AD%A33%E7%99%BB%E9%8C%B2%E3%81%AE%E5%AE%8C%E4%BA%86%E6%99%82%E3%81%AB%E8%AA%B0%E3%81%AE%E3%82%AA%E3%83%97%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%8B%E3%82%92%E7%A2%BA%E8%AA%8D%E3%81%99%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e修正3：登録の完了時に「誰のオプションか」を確認する\u003c/h2\u003e\n\u003cp data-sourcepos=\"186:1-186:168\"\u003eもう 1 つは、リリースノートの「パスキーの登録途中で別のユーザでログインし直しても、登録が完了できてしまう」です。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"188:1-188:76\"\u003e\n\u003cspan id=\"登録のオプションにはユーザーが埋め込まれている\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%99%BB%E9%8C%B2%E3%81%AE%E3%82%AA%E3%83%97%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%AB%E3%81%AF%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%81%8C%E5%9F%8B%E3%82%81%E8%BE%BC%E3%81%BE%E3%82%8C%E3%81%A6%E3%81%84%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e登録のオプションには、ユーザーが埋め込まれている\u003c/h3\u003e\n\u003cp data-sourcepos=\"190:1-190:157\"\u003e登録を始めるとき（\u003ccode\u003eCreateOptions\u003c/code\u003e 側）、オプションには\u003cstrong\u003eログイン中のユーザーの ID が \u003ccode\u003eFido2User.Id\u003c/code\u003e として入ります\u003c/strong\u003e。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"csharp\" data-sourcepos=\"192:1-199:3\"\u003e\n\u003cdiv class=\"code-lang\"\u003e\u003cspan class=\"bold\"\u003ePasskeysController.cs\u003c/span\u003e\u003c/div\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"kt\"\u003evar\u003c/span\u003e \u003cspan class=\"n\"\u003efido2User\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"k\"\u003enew\u003c/span\u003e \u003cspan class=\"n\"\u003eFido2User\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"n\"\u003eId\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003eSystem\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eText\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eEncoding\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eUTF8\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eGetBytes\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eUserId\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eToString\u003c/span\u003e\u003cspan class=\"p\"\u003e()),\u003c/span\u003e\n    \u003cspan class=\"n\"\u003eName\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eLoginId\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"n\"\u003eDisplayName\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e?.\u003c/span\u003e\u003cspan class=\"n\"\u003eUser\u003c/span\u003e\u003cspan class=\"p\"\u003e?.\u003c/span\u003e\u003cspan class=\"n\"\u003eName\u003c/span\u003e \u003cspan class=\"p\"\u003e??\u003c/span\u003e \u003cspan class=\"kt\"\u003estring\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eEmpty\u003c/span\u003e\n\u003cspan class=\"p\"\u003e};\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\n\u003c/div\u003e\n\u003cp data-sourcepos=\"201:1-201:188\"\u003e（\u003ca href=\"https://github.com/Implem/Implem.Pleasanter/blob/c6d8974df84ab5ba6029aaf394f9613b3a4211cb/Implem.Pleasanter/Controllers/PasskeysController.cs#L78-L84\" rel=\"nofollow noopener\" target=\"_blank\"\u003ePasskeysController.cs#L80-L85\u003c/a\u003e）\u003c/p\u003e\n\u003ch3 data-sourcepos=\"203:1-203:98\"\u003e\n\u003cspan id=\"修正前完了時に今ログインしているユーザーの-id-で保存していた\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BF%AE%E6%AD%A3%E5%89%8D%E5%AE%8C%E4%BA%86%E6%99%82%E3%81%AB%E4%BB%8A%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%81%AE-id-%E3%81%A7%E4%BF%9D%E5%AD%98%E3%81%97%E3%81%A6%E3%81%84%E3%81%9F\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e修正前：完了時に、今ログインしているユーザーの ID で保存していた\u003c/h3\u003e\n\u003cp data-sourcepos=\"205:1-205:194\"\u003e登録を完了する \u003ccode\u003eMakeCredential\u003c/code\u003e は、オプションを取り出した後、**そのときのセッションのユーザー（\u003ccode\u003econtext.UserId\u003c/code\u003e）**で、パスキーを保存します。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"csharp\" data-sourcepos=\"207:1-214:3\"\u003e\n\u003cdiv class=\"code-lang\"\u003e\u003cspan class=\"bold\"\u003ePasskeysController.cs\u003c/span\u003e\u003c/div\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"kt\"\u003evar\u003c/span\u003e \u003cspan class=\"n\"\u003epasskeyModel\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"k\"\u003enew\u003c/span\u003e \u003cspan class=\"nf\"\u003ePasskeyModel\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n    \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"n\"\u003euserId\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eUserId\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"n\"\u003eCredentialId\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003ecredential\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eId\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eToBase64UrlString\u003c/span\u003e\u003cspan class=\"p\"\u003e(),\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e...\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\n\u003c/div\u003e\n\u003cp data-sourcepos=\"216:1-216:569\"\u003eオプションを作ったユーザーと、完了時のユーザーが\u003cstrong\u003e一致するかどうかの確認がありませんでした\u003c/strong\u003e。同じブラウザーのセッションで、ユーザー A で登録を始めてオプションを作り、ユーザー B でログインし直してから完了させると、A 用のオプションに対する応答が、B のパスキーとして登録される経路があったことになります。リリースノートの「登録途中で別のユーザでログインし直しても」はこの状況のことです。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"218:1-218:93\"\u003e\n\u003cspan id=\"修正後オプションのユーザー-id-と現在のユーザー-id-を比較する\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BF%AE%E6%AD%A3%E5%BE%8C%E3%82%AA%E3%83%97%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%AE%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC-id-%E3%81%A8%E7%8F%BE%E5%9C%A8%E3%81%AE%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC-id-%E3%82%92%E6%AF%94%E8%BC%83%E3%81%99%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e修正後：オプションのユーザー ID と現在のユーザー ID を比較する\u003c/h3\u003e\n\u003cp data-sourcepos=\"220:1-220:111\"\u003e1.5.10.0 では、取り出したオプションを作り直した後に、次の確認が加わりました。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"csharp\" data-sourcepos=\"222:1-231:3\"\u003e\n\u003cdiv class=\"code-lang\"\u003e\u003cspan class=\"bold\"\u003ePasskeysController.cs\u003c/span\u003e\u003c/div\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"kt\"\u003evar\u003c/span\u003e \u003cspan class=\"n\"\u003eoptions\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003eCredentialCreateOptions\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eFromJson\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eoptionsJson\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n\u003cspan class=\"k\"\u003eif\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eUserId\u003c/span\u003e \u003cspan class=\"p\"\u003e\u0026lt;=\u003c/span\u003e \u003cspan class=\"m\"\u003e0\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e||\u003c/span\u003e \u003cspan class=\"n\"\u003eoptions\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eUser\u003c/span\u003e\u003cspan class=\"p\"\u003e?.\u003c/span\u003e\u003cspan class=\"n\"\u003eId\u003c/span\u003e \u003cspan class=\"p\"\u003e==\u003c/span\u003e \u003cspan class=\"k\"\u003enull\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e||\u003c/span\u003e \u003cspan class=\"p\"\u003e!\u003c/span\u003e\u003cspan class=\"n\"\u003eoptions\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eUser\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eId\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eSequenceEqual\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eSystem\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eText\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eEncoding\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eUTF8\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eGetBytes\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eUserId\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eToString\u003c/span\u003e\u003cspan class=\"p\"\u003e())))\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"n\"\u003eMessages\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eResponsePasskeyResponseInvalid\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n        \u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eToJson\u003c/span\u003e\u003cspan class=\"p\"\u003e();\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\n\u003c/div\u003e\n\u003cp data-sourcepos=\"233:1-233:192\"\u003e（\u003ca href=\"https://github.com/Implem/Implem.Pleasanter/blob/c6d8974df84ab5ba6029aaf394f9613b3a4211cb/Implem.Pleasanter/Controllers/PasskeysController.cs#L142-L150\" rel=\"nofollow noopener\" target=\"_blank\"\u003ePasskeysController.cs#L143-L151\u003c/a\u003e）\u003c/p\u003e\n\u003cp data-sourcepos=\"235:1-235:76\"\u003e条件は 3 つで、\u003cstrong\u003eどれか 1 つでも満たすと拒否\u003c/strong\u003eします。\u003c/p\u003e\n\u003ctable data-sourcepos=\"237:1-241:115\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"237:1-237:19\"\u003e\n\u003cth data-sourcepos=\"237:2-237:9\"\u003e条件\u003c/th\u003e\n\u003cth data-sourcepos=\"237:11-237:18\"\u003e意味\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"239:1-239:55\"\u003e\n\u003ctd data-sourcepos=\"239:2-239:24\"\u003e\u003ccode\u003econtext.UserId \u0026lt;= 0\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-sourcepos=\"239:26-239:54\"\u003eログインしていない\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"240:1-240:84\"\u003e\n\u003ctd data-sourcepos=\"240:2-240:29\"\u003e\u003ccode\u003eoptions.User?.Id == null\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-sourcepos=\"240:31-240:83\"\u003eオプションにユーザーが入っていない\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"241:1-241:115\"\u003e\n\u003ctd data-sourcepos=\"241:2-241:39\"\u003eID のバイト列が一致しない\u003c/td\u003e\n\u003ctd data-sourcepos=\"241:41-241:114\"\u003eオプションを作ったユーザーと、今のユーザーが違う\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"243:1-243:478\"\u003e比較は、オプションを作ったときと同じ方法（\u003ccode\u003eUserId\u003c/code\u003e の文字列を UTF-8 のバイト列にしたもの）で行います。\u003cstrong\u003e登録の最後に、オプションが「いま完了しようとしているユーザーのために作られたもの」であることを確かめる\u003c/strong\u003e形です。なお、この確認より前に \u003ccode\u003eTake\u003c/code\u003e でオプションが消費されているので、拒否されたオプションを使い回すこともできません。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"245:1-245:79\"\u003e\n\u003cspan id=\"修正4無効なユーザーはパスキーでもログインさせない\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BF%AE%E6%AD%A34%E7%84%A1%E5%8A%B9%E3%81%AA%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%81%AF%E3%83%91%E3%82%B9%E3%82%AD%E3%83%BC%E3%81%A7%E3%82%82%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%95%E3%81%9B%E3%81%AA%E3%81%84\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e修正4：無効なユーザーはパスキーでもログインさせない\u003c/h2\u003e\n\u003cp data-sourcepos=\"247:1-247:123\"\u003e最後が、リリースノートの「無効にしたユーザでもパスキー認証でログインできる」です。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"249:1-249:40\"\u003e\n\u003cspan id=\"ログインの完了までの流れ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%AE%E5%AE%8C%E4%BA%86%E3%81%BE%E3%81%A7%E3%81%AE%E6%B5%81%E3%82%8C\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eログインの完了までの流れ\u003c/h3\u003e\n\u003cp data-sourcepos=\"251:1-251:259\"\u003e\u003ccode\u003eMakeAssertion\u003c/code\u003e（ログインの完了）は、署名の検証を終えると、パスキーに結び付いた \u003ccode\u003eUserId\u003c/code\u003e からユーザーを引き、\u003ccode\u003eUserModel.Authenticate\u003c/code\u003e を呼びます。このとき \u003ccode\u003eisAuthenticationByPasskey: true\u003c/code\u003e を渡します。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"csharp\" data-sourcepos=\"253:1-268:3\"\u003e\n\u003cdiv class=\"code-lang\"\u003e\u003cspan class=\"bold\"\u003ePasskeysController.cs\u003c/span\u003e\u003c/div\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"n\"\u003ejson\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"k\"\u003enew\u003c/span\u003e \u003cspan class=\"nf\"\u003eUserModel\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n    \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"n\"\u003ess\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003ess\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"n\"\u003euserId\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003epasskey\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eUserId\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n        \u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eGet\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n            \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n            \u003cspan class=\"n\"\u003ess\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003ess\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n            \u003cspan class=\"k\"\u003ewhere\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003eRds\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eUsersWhere\u003c/span\u003e\u003cspan class=\"p\"\u003e()\u003c/span\u003e\n                \u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eUserId\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003epasskey\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eUserId\u003c/span\u003e\u003cspan class=\"p\"\u003e))\u003c/span\u003e\n        \u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eAuthenticate\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n            \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n            \u003cspan class=\"n\"\u003ereturnUrl\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003ereturnUrl\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n            \u003cspan class=\"n\"\u003eisAuthenticationByMail\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"k\"\u003efalse\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n            \u003cspan class=\"n\"\u003eisAuthenticationByPasskey\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"k\"\u003etrue\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\n\u003c/div\u003e\n\u003cp data-sourcepos=\"270:1-270:192\"\u003e（\u003ca href=\"https://github.com/Implem/Implem.Pleasanter/blob/c6d8974df84ab5ba6029aaf394f9613b3a4211cb/Implem.Pleasanter/Controllers/PasskeysController.cs#L328-L341\" rel=\"nofollow noopener\" target=\"_blank\"\u003ePasskeysController.cs#L328-L341\u003c/a\u003e）\u003c/p\u003e\n\u003ch3 data-sourcepos=\"272:1-272:82\"\u003e\n\u003cspan id=\"authenticate-はパスキーのときパスワード側の検証を飛ばす\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#authenticate-%E3%81%AF%E3%83%91%E3%82%B9%E3%82%AD%E3%83%BC%E3%81%AE%E3%81%A8%E3%81%8D%E3%83%91%E3%82%B9%E3%83%AF%E3%83%BC%E3%83%89%E5%81%B4%E3%81%AE%E6%A4%9C%E8%A8%BC%E3%82%92%E9%A3%9B%E3%81%B0%E3%81%99\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e\u003ccode\u003eAuthenticate\u003c/code\u003e はパスキーのときパスワード側の検証を飛ばす\u003c/h3\u003e\n\u003cp data-sourcepos=\"274:1-274:70\"\u003e\u003ccode\u003eUserModel.Authenticate\u003c/code\u003e の中には、次の分岐があります。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"csharp\" data-sourcepos=\"276:1-282:3\"\u003e\n\u003cdiv class=\"code-lang\"\u003e\u003cspan class=\"bold\"\u003eUserModel.cs\u003c/span\u003e\u003c/div\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"k\"\u003eif\u003c/span\u003e \u003cspan class=\"p\"\u003e(!\u003c/span\u003e\u003cspan class=\"n\"\u003eisAuthenticationByPasskey\u003c/span\u003e \u003cspan class=\"p\"\u003e\u0026amp;\u0026amp;\u003c/span\u003e \u003cspan class=\"p\"\u003e!\u003c/span\u003e\u003cspan class=\"nf\"\u003eAuthenticate\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e))\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e...\u003c/span\u003e\n    \u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"nf\"\u003eDeny\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\n\u003c/div\u003e\n\u003cp data-sourcepos=\"284:1-284:356\"\u003eパスキーで認証済みの場合は、パスワードなどを検証する \u003ccode\u003eAuthenticate(context)\u003c/code\u003e をまるごと飛ばします。署名の検証はすでに終わっているためです。ただし、パスワード側の検証を飛ばしたことで、\u003cstrong\u003eその検証に含まれていた確認まで通らなくなる\u003c/strong\u003e可能性があります。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"286:1-286:45\"\u003e\n\u003cspan id=\"修正disabled-を先に拒否する\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BF%AE%E6%AD%A3disabled-%E3%82%92%E5%85%88%E3%81%AB%E6%8B%92%E5%90%A6%E3%81%99%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e修正：\u003ccode\u003eDisabled\u003c/code\u003e を先に拒否する\u003c/h3\u003e\n\u003cp data-sourcepos=\"288:1-288:149\"\u003e1.5.10.0 では、この分岐より前に、パスキー認証で \u003ccode\u003eDisabled\u003c/code\u003e（無効）のユーザーを拒否する判定が加わりました。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"csharp\" data-sourcepos=\"290:1-295:3\"\u003e\n\u003cdiv class=\"code-lang\"\u003e\u003cspan class=\"bold\"\u003eUserModel.cs\u003c/span\u003e\u003c/div\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"k\"\u003eif\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eisAuthenticationByPasskey\u003c/span\u003e \u003cspan class=\"p\"\u003e\u0026amp;\u0026amp;\u003c/span\u003e \u003cspan class=\"n\"\u003eDisabled\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"nf\"\u003eDeny\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003econtext\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\n\u003c/div\u003e\n\u003cp data-sourcepos=\"297:1-297:179\"\u003e（\u003ca href=\"https://github.com/Implem/Implem.Pleasanter/blob/c6d8974df84ab5ba6029aaf394f9613b3a4211cb/Implem.Pleasanter/Models/Users/UserModel.cs#L4740-L4743\" rel=\"nofollow noopener\" target=\"_blank\"\u003eUserModel.cs#L4740-L4743\u003c/a\u003e）\u003c/p\u003e\n\u003cp data-sourcepos=\"299:1-299:437\"\u003e位置にも意味があります。直前には、\u003ccode\u003eParameters.Security.RevealUserDisabled\u003c/code\u003e が有効なときに「ユーザーが無効です」と具体的に返す処理があり、その後ろ、\u003ccode\u003eRejectUnregisteredUser\u003c/code\u003e や、パスワード側の \u003ccode\u003eAuthenticate\u003c/code\u003e の分岐より前です。パスキーで来た無効ユーザーは、\u003cstrong\u003e他のどの確認よりも先に\u003c/strong\u003e、\u003ccode\u003eDeny\u003c/code\u003e（一般的な拒否応答）で止まります。\u003c/p\u003e\n\u003cp data-sourcepos=\"301:1-301:354\"\u003eなお、署名の検証は \u003ccode\u003eMakeAssertion\u003c/code\u003e の中で先に済んでいます。無効にしたユーザーでも、パスキーそのものは有効な署名を返せるため、署名の検証だけでは止められません。\u003cstrong\u003e認証の成功と、アカウントが使える状態であることは別の確認\u003c/strong\u003e、という典型的な穴です。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"303:1-303:26\"\u003e\n\u003cspan id=\"3-つの修正の関係\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#3-%E3%81%A4%E3%81%AE%E4%BF%AE%E6%AD%A3%E3%81%AE%E9%96%A2%E4%BF%82\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e3 つの修正の関係\u003c/h2\u003e\n\u003ctable data-sourcepos=\"305:1-310:122\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"305:1-305:49\"\u003e\n\u003cth data-sourcepos=\"305:2-305:9\"\u003e症状\u003c/th\u003e\n\u003cth data-sourcepos=\"305:11-305:30\"\u003e変更した場所\u003c/th\u003e\n\u003cth data-sourcepos=\"305:32-305:48\"\u003e変更の要点\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"307:1-307:152\"\u003e\n\u003ctd data-sourcepos=\"307:2-307:45\"\u003eRedis でパスキー認証が使えない\u003c/td\u003e\n\u003ctd data-sourcepos=\"307:47-307:83\"\u003e\n\u003ccode\u003eSessionUtilities.Take\u003c/code\u003e（新設）\u003c/td\u003e\n\u003ctd data-sourcepos=\"307:85-307:151\"\u003e\n\u003ccode\u003e_\u003c/code\u003e で分割せず、フィールド名のまま \u003ccode\u003eHGET\u003c/code\u003e・\u003ccode\u003eHDEL\u003c/code\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"308:1-308:184\"\u003e\n\u003ctd data-sourcepos=\"308:2-308:45\"\u003eオプションが使い回せる可能性\u003c/td\u003e\n\u003ctd data-sourcepos=\"308:47-308:94\"\u003e\n\u003ccode\u003ePasskeysController\u003c/code\u003e、\u003ccode\u003eSessionUtilities.Take\u003c/code\u003e\n\u003c/td\u003e\n\u003ctd data-sourcepos=\"308:96-308:183\"\u003e取得と削除を原子的に（Lua／\u003ccode\u003edelete ... output/returning\u003c/code\u003e／\u003ccode\u003efor update\u003c/code\u003e）\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"309:1-309:149\"\u003e\n\u003ctd data-sourcepos=\"309:2-309:48\"\u003e登録途中でユーザーを替えられる\u003c/td\u003e\n\u003ctd data-sourcepos=\"309:50-309:86\"\u003e\u003ccode\u003ePasskeysController.MakeCredential\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-sourcepos=\"309:88-309:148\"\u003eオプションの \u003ccode\u003eUser.Id\u003c/code\u003e と \u003ccode\u003econtext.UserId\u003c/code\u003e を比較\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"310:1-310:122\"\u003e\n\u003ctd data-sourcepos=\"310:2-310:45\"\u003e無効ユーザーがログインできる\u003c/td\u003e\n\u003ctd data-sourcepos=\"310:47-310:72\"\u003e\u003ccode\u003eUserModel.Authenticate\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-sourcepos=\"310:74-310:121\"\u003eパスキー認証で \u003ccode\u003eDisabled\u003c/code\u003e なら \u003ccode\u003eDeny\u003c/code\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"312:1-312:253\"\u003eこの表の 2 行目と 3 行目は、セットで効いています。**1 回しか使えないオプションを（2 行目）、作った本人のためのものとして確認する（3 行目）**ことで、登録の入口が閉じる形です。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"314:1-314:33\"\u003e\n\u003cspan id=\"更新時の確認ポイント\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%9B%B4%E6%96%B0%E6%99%82%E3%81%AE%E7%A2%BA%E8%AA%8D%E3%83%9D%E3%82%A4%E3%83%B3%E3%83%88\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e更新時の確認ポイント\u003c/h2\u003e\n\u003ctable data-sourcepos=\"316:1-322:127\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"316:1-316:37\"\u003e\n\u003cth data-sourcepos=\"316:2-316:21\"\u003e確認する項目\u003c/th\u003e\n\u003cth data-sourcepos=\"316:23-316:36\"\u003e見るもの\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"318:1-318:123\"\u003e\n\u003ctd data-sourcepos=\"318:2-318:18\"\u003e利用中の版\u003c/td\u003e\n\u003ctd data-sourcepos=\"318:20-318:122\"\u003e1.5.9.1 以前なら、いずれの修正も入っていません。1.5.10.0 以降へ更新します\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"319:1-319:93\"\u003e\n\u003ctd data-sourcepos=\"319:2-319:36\"\u003eパスキーを使っているか\u003c/td\u003e\n\u003ctd data-sourcepos=\"319:38-319:92\"\u003e\n\u003ccode\u003eAuthentication.json\u003c/code\u003e の \u003ccode\u003ePasskeyParameters.Enabled\u003c/code\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"320:1-320:158\"\u003e\n\u003ctd data-sourcepos=\"320:2-320:30\"\u003eRedis を使っているか\u003c/td\u003e\n\u003ctd data-sourcepos=\"320:32-320:157\"\u003e\n\u003ccode\u003eSession.json\u003c/code\u003e の \u003ccode\u003eUseKeyValueStore\u003c/code\u003e。有効なら、更新前はパスキーが使えなかった可能性があります\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"321:1-321:139\"\u003e\n\u003ctd data-sourcepos=\"321:2-321:30\"\u003e無効ユーザーの運用\u003c/td\u003e\n\u003ctd data-sourcepos=\"321:32-321:138\"\u003eパスキー登録済みのユーザーを無効にした場合に、ログインが拒否されること\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"322:1-322:127\"\u003e\n\u003ctd data-sourcepos=\"322:2-322:18\"\u003e登録の動作\u003c/td\u003e\n\u003ctd data-sourcepos=\"322:20-322:126\"\u003e検証環境で、別ユーザーでログインし直す手順を入れて、登録が失敗すること\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"324:1-324:114\"\u003eこの表は、ソースから整理した確認項目です。実機での検証までは行っていません。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"326:1-326:12\"\u003e\n\u003cspan id=\"まとめ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%BE%E3%81%A8%E3%82%81\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eまとめ\u003c/h2\u003e\n\u003cp data-sourcepos=\"328:1-328:96\"\u003e1.5.10.0 のパスキー関連の修正 3 点を、コード差分から読み解きました。\u003c/p\u003e\n\u003cul data-sourcepos=\"330:1-334:0\"\u003e\n\u003cli data-sourcepos=\"330:1-330:191\"\u003e\n\u003cstrong\u003eRedis\u003c/strong\u003e：キーを \u003ccode\u003e_\u003c/code\u003e で分割して先頭だけを使う作りが、\u003ccode\u003ePasskeys_...\u003c/code\u003e というキーと噛み合っていなかった。\u003ccode\u003eTake\u003c/code\u003e はフィールド名をそのまま使う\u003c/li\u003e\n\u003cli data-sourcepos=\"331:1-331:196\"\u003e\n\u003cstrong\u003e使い回し\u003c/strong\u003e：取得と削除が別操作だったものを、\u003ccode\u003eTake\u003c/code\u003e で原子的な 1 操作にした。保存先ごとに Lua・\u003ccode\u003eoutput\u003c/code\u003e・\u003ccode\u003ereturning\u003c/code\u003e・\u003ccode\u003efor update\u003c/code\u003e で実現している\u003c/li\u003e\n\u003cli data-sourcepos=\"332:1-332:141\"\u003e\n\u003cstrong\u003e登録\u003c/strong\u003e：完了時に、オプションを作ったユーザーと今のユーザーが同じかどうかを確認するようにした\u003c/li\u003e\n\u003cli data-sourcepos=\"333:1-334:0\"\u003e\n\u003cstrong\u003e無効ユーザー\u003c/strong\u003e：パスキー認証でも \u003ccode\u003eDisabled\u003c/code\u003e を先に \u003ccode\u003eDeny\u003c/code\u003e する\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"335:1-335:410\"\u003eパスキーは、署名が正しいことと、その署名を受け入れてよい状況であることが別々の確認になります。今回の修正は、署名の検証の\u003cstrong\u003e前後\u003c/strong\u003eにある「セッションの扱い」と「アカウントの状態」の確認を埋めるものでした。パスキーを使っている環境は、早めに 1.5.10.0 以降への更新を検討してください。\u003c/p\u003e\n","body":"\n## はじめに\n\nプリザンター 1.5.10.0 のリリースノートには、パスキー認証に関する修正が 3 つ入っています。\n\n- セッションの保存先を Redis にすると、パスキー認証が利用できない\n- 無効にしたユーザでもパスキー認証でログインできる\n- パスキーの登録途中で別のユーザでログインし直しても、登録が完了できてしまう\n\nこの記事では、1.5.9.1 から 1.5.10.0 までの差分を追いかけて、**どのコードがどう変わったのか**を具体的に読み解きます。パスキーの仕組みを知らなくても読めるように、先に処理の流れを整理します。\n\n:::note info\n対象は 1.5.9.1 → 1.5.10.0 の差分です。コードの引用は 1.5.10.0 のコミット（`c6d8974df84ab5ba6029aaf394f9613b3a4211cb`）、修正前は 1.5.9.1 のコミット（`1c693a1ee379a87e588232e43216400431376653`）に固定しています。いずれもソースを読んだ結果で、各経路を実行して再現した結果ではありません。\n:::\n\n## パスキーの処理の流れ\n\nパスキー（WebAuthn）の登録とログインは、どちらも**サーバーが作った「チャレンジ入りのオプション」をブラウザーに渡し、ブラウザーが認証器で署名した応答を返し、サーバーが元のオプションと突き合わせて検証する**という 2 往復です。\n\n```mermaid\nsequenceDiagram\n    participant B as ブラウザー\n    participant S as プリザンター\n    B-\u003e\u003eS: 1. オプションの要求（登録: CreateOptions／ログイン: AssertionOptions）\n    S-\u003e\u003eS: オプションをセッションへ保存\n    S--\u003e\u003eB: オプション（チャレンジ入り）\n    B-\u003e\u003eB: 認証器で署名\n    B-\u003e\u003eS: 2. 署名の応答（登録: MakeCredential／ログイン: MakeAssertion）\n    S-\u003e\u003eS: セッションからオプションを取り出して検証\n    S--\u003e\u003eB: 結果\n```\n\nつまり**セッションに預けたオプションが、2 回目のリクエストで確実に、1 回だけ、正しい相手のものとして取り出せるか**が安全性の要です。今回の 3 つの修正は、この前後の扱いに関わっています。\n\nプリザンターでは `PasskeysController` が 4 つの入口（登録のオプション作成・登録の完了、ログインのオプション作成・ログインの完了）を持ち、オプションは `PasskeyUtilities.SessionSet` でセッションに保存します。キーには `Passkeys_` の接頭辞が付きます。\n\n```csharp:PasskeyUtilities.cs\nSessionUtilities.Set(\n    context: context,\n    key: $\"Passkeys_{key}\",\n    value: stringValue);\n```\n\n（[PasskeyUtilities.cs](https://github.com/Implem/Implem.Pleasanter/blob/c6d8974df84ab5ba6029aaf394f9613b3a4211cb/Implem.Pleasanter/Models/Passkeys/PasskeyUtilities.cs#L250-L267)）\n\n## 修正1：取り出しと削除を「1 回の原子的な操作」に変えた\n\n修正は、セッションからの取り出し方そのものを変えています。\n\n### 修正前：読んでから別操作で消す\n\n1.5.9.1 の `MakeCredential`（登録の完了）と `MakeAssertion`（ログインの完了）は、次の順に処理していました。\n\n```csharp:PasskeysController.cs（1.5.9.1）\nvar bodyData = JsonSerializer.Deserialize\u003cAuthenticatorAttestationRawResponse\u003e(context.Forms.Data(\"data\"));\nvar optionsJson = PasskeyUtilities.SessionGetString(\n    context: context,\n    key: Fido2AttestationOptions);\nif (optionsJson.IsNullOrWhiteSpace())\n{\n    return Messages.ResponsePasskeyResponseInvalid(context: context)\n        .ToJson();\n}\nPasskeyUtilities.SessionRemove(context: context, key: Fido2AttestationOptions);\n```\n\n`SessionGetString` が**取得**し、その後で `SessionRemove` が**削除**します。2 つの別操作です。\n\n### 修正後：`Take` で取得と削除を同時に行う\n\n1.5.10.0 では `SessionTakeString` に置き換わり、`SessionRemove` は削除されました。\n\n```csharp:PasskeysController.cs\nvar optionsJson = PasskeyUtilities.SessionTakeString(\n    context: context,\n    key: Fido2AttestationOptions);\nif (optionsJson.IsNullOrWhiteSpace())\n{\n    return Messages.ResponsePasskeyResponseInvalid(context: context)\n        .ToJson();\n}\nvar bodyData = JsonSerializer.Deserialize\u003cAuthenticatorAttestationRawResponse\u003e(context.Forms.Data(\"data\"));\n```\n\n（[PasskeysController.cs#L134-L142](https://github.com/Implem/Implem.Pleasanter/blob/c6d8974df84ab5ba6029aaf394f9613b3a4211cb/Implem.Pleasanter/Controllers/PasskeysController.cs#L134-L142)）\n\n細かい点ですが、**応答の JSON のデシリアライズを、オプションの取り出しより後ろに移動**しています。不正な本文を送ってもオプションの取り出し（＝消費）は先に済むので、「失敗しても同じオプションで何度でも試せる」状態にはなりません。\n\n`SessionTakeString` の中身は、新設された `SessionUtilities.Take` です。\n\n```csharp:PasskeyUtilities.cs\npublic static string SessionTakeString(Context context, string key)\n{\n    return SessionUtilities.Take(\n        context: context,\n        key: $\"Passkeys_{key}\") ?? string.Empty;\n}\n```\n\n### `Take` の実装：保存先ごとに原子的に取り出す\n\n`Take` は、保存先によって 2 通りに分かれます（[SessionUtilities.cs#L30-L100](https://github.com/Implem/Implem.Pleasanter/blob/c6d8974df84ab5ba6029aaf394f9613b3a4211cb/Implem.Pleasanter/Models/Sessions/SessionUtilities.cs#L30-L100)）。\n\n**Redis（`Parameters.Session.UseKeyValueStore`）の場合**は、Lua スクリプトで取得と削除を 1 回の命令にまとめます。\n\n```csharp:SessionUtilities.cs\nvar result = Implem.Pleasanter.Libraries.Redis.CacheForRedisConnection.Connection\n    .GetDatabase().ScriptEvaluate(\n        script: \"local value = redis.call('HGET', KEYS[1], ARGV[1]); \"\n            + \"if value then redis.call('HDEL', KEYS[1], ARGV[1]); return value end; return false\",\n        keys: new StackExchange.Redis.RedisKey[] { target },\n        values: new StackExchange.Redis.RedisValue[] { field });\nreturn (string)result;\n```\n\nRedis はスクリプトを 1 つの命令として実行するので、`HGET` と `HDEL` の間に他のリクエストが割り込めません。\n\n**データベース（SQL Server・PostgreSQL・MySQL）の場合**は、DBMS ごとに「削除しながら値を返す」SQL にします。\n\n| DBMS | 方法 |\n| --- | --- |\n| SQL Server | `delete ... output deleted.\"Value\"` |\n| PostgreSQL | `delete ... returning \"Value\"` |\n| MySQL | `select ... for update` で行を押さえ、続けて `delete`（削除できた件数が 1 のときだけ値を返す） |\n\nMySQL は `returning` を持たないため、トランザクションの中で `for update` により行をロックしてから削除しています。この 3 つ以外の DBMS は `NotSupportedException` で、原子的に取り出せない状態を黙って通すことはしません。さらに、削除の条件には `ReadOnce` と `UserArea` のどちらも立っていない行だけを対象にする条件が付いています。\n\n### これで何が防がれるか\n\n「オプションは 1 回しか使えない」ことが、チャレンジを使った検証の前提です。取得と削除が別操作だと、**同じセッションで 2 つのリクエストをほぼ同時に送ると、両方が「まだ残っている」オプションを取得できる**可能性があります。`Take` は、片方だけが値を受け取り、もう片方は空文字列になるため、`optionsJson.IsNullOrWhiteSpace()` の分岐で `ResponsePasskeyResponseInvalid` になります。\n\n:::note warn\nこの競合が実際に悪用できるかどうかは、ここでは検証していません。コードから言えるのは、修正前は取得と削除が別操作で、修正後は 1 回の原子的な操作になった、という点までです。\n:::\n\n## 修正2：Redis のときにオプションを取り出せなかった問題\n\nリリースノートの「セッションの保存先を Redis にすると、パスキー認証が利用できない」は、`Take` の追加でなぜ直るのかが、コードから読み取れます。\n\n### 修正前：キーを `_` で分割して先頭だけを使っていた\n\nRedis 利用時の `SessionUtilities.Get` は、Redis のハッシュのフィールド名を `_` で分割し、**先頭の要素をキー**にした辞書を返していました。\n\n```csharp:SessionUtilities.cs（1.5.9.1）\nvar sessions = iDatabase.HashGetAll(key)\n    .Where(dataRow =\u003e\n        dataRow.Name.ToString().Split('_').Count() == 1 ||\n        (context.Page == null \u0026\u0026 sessionGuid == null) ||\n        dataRow.Name.ToString().Split('_')[1] == context.Page)\n    .ToDictionary(dataRow =\u003e dataRow.Name.ToString().Split('_')[0], dataRow =\u003e dataRow.Value.ToString());\n```\n\n（[1.5.9.1 の SessionUtilities.cs#L44](https://github.com/Implem/Implem.Pleasanter/blob/1c693a1ee379a87e588232e43216400431376653/Implem.Pleasanter/Models/Sessions/SessionUtilities.cs#L44)）\n\nこれは、Redis のフィールド名が `キー` または `キー_ページ名` の形で保存されることを前提にした作りです。ところがパスキーのキーは、`Passkeys_Fido2AttestationOptions` のように、**キー自体に `_` を含みます**。`Split('_')[0]` を取ると、辞書のキーは `Passkeys` になってしまいます。\n\n一方、取得する側は修正前の `SessionGetString` で、次のようにキーを探します。\n\n```csharp:PasskeyUtilities.cs（1.5.9.1）\nvar dic = SessionUtilities.Get(context: context);\nif (dic.TryGetValue($\"Passkeys_{key}\", out var json))\n{\n    return json;\n}\nreturn string.Empty;\n```\n\n辞書にあるのは `Passkeys` で、探しているのは `Passkeys_Fido2AttestationOptions` ですから、**Redis のときは一致せず、必ず空文字列が返ります**。空なら `ResponsePasskeyResponseInvalid` になるので、登録もログインも完了できません。リリースノートの症状と一致します。データベースを使う構成では、`Key` 列を丸ごと辞書のキーにするため、この問題は起きません。\n\n### 修正後：分割せずフィールド名をそのまま使う\n\n`Take` は `Get` を経由せず、**フィールド名をそのまま** `HGET` / `HDEL` に渡します。\n\n```csharp:SessionUtilities.cs\nvar field = pageName.Length == 0 ? key : $\"{key}_{pageName}\";\n```\n\n`key` は `Passkeys_Fido2AttestationOptions` のままで、分割しません。これで Redis でも取り出せます。\n\n### 削除側にあった、もう 1 つの穴\n\n修正前の `SessionRemove` は、`SessionUtilities.Remove` を呼んでいました。この関数は `Rds.PhysicalDeleteSessions` で**データベースの `Sessions` テーブルだけを削除**します（[1.5.9.1 の SessionUtilities.cs#L248](https://github.com/Implem/Implem.Pleasanter/blob/1c693a1ee379a87e588232e43216400431376653/Implem.Pleasanter/Models/Sessions/SessionUtilities.cs#L248)）。Redis にある値には触れません。そのため、仮に取得できていたとしても、Redis では「使い終わったオプションが消えずに残る」ことになります。`Take` は取得と削除を Redis 側で行うので、この点も解消しています。\n\n## 修正3：登録の完了時に「誰のオプションか」を確認する\n\nもう 1 つは、リリースノートの「パスキーの登録途中で別のユーザでログインし直しても、登録が完了できてしまう」です。\n\n### 登録のオプションには、ユーザーが埋め込まれている\n\n登録を始めるとき（`CreateOptions` 側）、オプションには**ログイン中のユーザーの ID が `Fido2User.Id` として入ります**。\n\n```csharp:PasskeysController.cs\nvar fido2User = new Fido2User\n{\n    Id = System.Text.Encoding.UTF8.GetBytes(context.UserId.ToString()),\n    Name = context.LoginId,\n    DisplayName = context?.User?.Name ?? string.Empty\n};\n```\n\n（[PasskeysController.cs#L80-L85](https://github.com/Implem/Implem.Pleasanter/blob/c6d8974df84ab5ba6029aaf394f9613b3a4211cb/Implem.Pleasanter/Controllers/PasskeysController.cs#L78-L84)）\n\n### 修正前：完了時に、今ログインしているユーザーの ID で保存していた\n\n登録を完了する `MakeCredential` は、オプションを取り出した後、**そのときのセッションのユーザー（`context.UserId`）**で、パスキーを保存します。\n\n```csharp:PasskeysController.cs\nvar passkeyModel = new PasskeyModel(\n    context: context,\n    userId: context.UserId)\n{\n    CredentialId = credential.Id.ToBase64UrlString(),\n    ...\n```\n\nオプションを作ったユーザーと、完了時のユーザーが**一致するかどうかの確認がありませんでした**。同じブラウザーのセッションで、ユーザー A で登録を始めてオプションを作り、ユーザー B でログインし直してから完了させると、A 用のオプションに対する応答が、B のパスキーとして登録される経路があったことになります。リリースノートの「登録途中で別のユーザでログインし直しても」はこの状況のことです。\n\n### 修正後：オプションのユーザー ID と現在のユーザー ID を比較する\n\n1.5.10.0 では、取り出したオプションを作り直した後に、次の確認が加わりました。\n\n```csharp:PasskeysController.cs\nvar options = CredentialCreateOptions.FromJson(optionsJson);\nif (context.UserId \u003c= 0\n    || options.User?.Id == null\n    || !options.User.Id.SequenceEqual(System.Text.Encoding.UTF8.GetBytes(context.UserId.ToString())))\n{\n    return Messages.ResponsePasskeyResponseInvalid(context: context)\n        .ToJson();\n}\n```\n\n（[PasskeysController.cs#L143-L151](https://github.com/Implem/Implem.Pleasanter/blob/c6d8974df84ab5ba6029aaf394f9613b3a4211cb/Implem.Pleasanter/Controllers/PasskeysController.cs#L142-L150)）\n\n条件は 3 つで、**どれか 1 つでも満たすと拒否**します。\n\n| 条件 | 意味 |\n| --- | --- |\n| `context.UserId \u003c= 0` | ログインしていない |\n| `options.User?.Id == null` | オプションにユーザーが入っていない |\n| ID のバイト列が一致しない | オプションを作ったユーザーと、今のユーザーが違う |\n\n比較は、オプションを作ったときと同じ方法（`UserId` の文字列を UTF-8 のバイト列にしたもの）で行います。**登録の最後に、オプションが「いま完了しようとしているユーザーのために作られたもの」であることを確かめる**形です。なお、この確認より前に `Take` でオプションが消費されているので、拒否されたオプションを使い回すこともできません。\n\n## 修正4：無効なユーザーはパスキーでもログインさせない\n\n最後が、リリースノートの「無効にしたユーザでもパスキー認証でログインできる」です。\n\n### ログインの完了までの流れ\n\n`MakeAssertion`（ログインの完了）は、署名の検証を終えると、パスキーに結び付いた `UserId` からユーザーを引き、`UserModel.Authenticate` を呼びます。このとき `isAuthenticationByPasskey: true` を渡します。\n\n```csharp:PasskeysController.cs\njson = new UserModel(\n    context: context,\n    ss: ss,\n    userId: passkey.UserId)\n        .Get(\n            context: context,\n            ss: ss,\n            where: Rds.UsersWhere()\n                .UserId(passkey.UserId))\n        .Authenticate(\n            context: context,\n            returnUrl: returnUrl,\n            isAuthenticationByMail: false,\n            isAuthenticationByPasskey: true);\n```\n\n（[PasskeysController.cs#L328-L341](https://github.com/Implem/Implem.Pleasanter/blob/c6d8974df84ab5ba6029aaf394f9613b3a4211cb/Implem.Pleasanter/Controllers/PasskeysController.cs#L328-L341)）\n\n### `Authenticate` はパスキーのときパスワード側の検証を飛ばす\n\n`UserModel.Authenticate` の中には、次の分岐があります。\n\n```csharp:UserModel.cs\nif (!isAuthenticationByPasskey \u0026\u0026 !Authenticate(context: context))\n{\n    ...\n    return Deny(context: context);\n}\n```\n\nパスキーで認証済みの場合は、パスワードなどを検証する `Authenticate(context)` をまるごと飛ばします。署名の検証はすでに終わっているためです。ただし、パスワード側の検証を飛ばしたことで、**その検証に含まれていた確認まで通らなくなる**可能性があります。\n\n### 修正：`Disabled` を先に拒否する\n\n1.5.10.0 では、この分岐より前に、パスキー認証で `Disabled`（無効）のユーザーを拒否する判定が加わりました。\n\n```csharp:UserModel.cs\nif (isAuthenticationByPasskey \u0026\u0026 Disabled)\n{\n    return Deny(context: context);\n}\n```\n\n（[UserModel.cs#L4740-L4743](https://github.com/Implem/Implem.Pleasanter/blob/c6d8974df84ab5ba6029aaf394f9613b3a4211cb/Implem.Pleasanter/Models/Users/UserModel.cs#L4740-L4743)）\n\n位置にも意味があります。直前には、`Parameters.Security.RevealUserDisabled` が有効なときに「ユーザーが無効です」と具体的に返す処理があり、その後ろ、`RejectUnregisteredUser` や、パスワード側の `Authenticate` の分岐より前です。パスキーで来た無効ユーザーは、**他のどの確認よりも先に**、`Deny`（一般的な拒否応答）で止まります。\n\nなお、署名の検証は `MakeAssertion` の中で先に済んでいます。無効にしたユーザーでも、パスキーそのものは有効な署名を返せるため、署名の検証だけでは止められません。**認証の成功と、アカウントが使える状態であることは別の確認**、という典型的な穴です。\n\n## 3 つの修正の関係\n\n| 症状 | 変更した場所 | 変更の要点 |\n| --- | --- | --- |\n| Redis でパスキー認証が使えない | `SessionUtilities.Take`（新設） | `_` で分割せず、フィールド名のまま `HGET`・`HDEL` |\n| オプションが使い回せる可能性 | `PasskeysController`、`SessionUtilities.Take` | 取得と削除を原子的に（Lua／`delete ... output/returning`／`for update`） |\n| 登録途中でユーザーを替えられる | `PasskeysController.MakeCredential` | オプションの `User.Id` と `context.UserId` を比較 |\n| 無効ユーザーがログインできる | `UserModel.Authenticate` | パスキー認証で `Disabled` なら `Deny` |\n\nこの表の 2 行目と 3 行目は、セットで効いています。**1 回しか使えないオプションを（2 行目）、作った本人のためのものとして確認する（3 行目）**ことで、登録の入口が閉じる形です。\n\n## 更新時の確認ポイント\n\n| 確認する項目 | 見るもの |\n| --- | --- |\n| 利用中の版 | 1.5.9.1 以前なら、いずれの修正も入っていません。1.5.10.0 以降へ更新します |\n| パスキーを使っているか | `Authentication.json` の `PasskeyParameters.Enabled` |\n| Redis を使っているか | `Session.json` の `UseKeyValueStore`。有効なら、更新前はパスキーが使えなかった可能性があります |\n| 無効ユーザーの運用 | パスキー登録済みのユーザーを無効にした場合に、ログインが拒否されること |\n| 登録の動作 | 検証環境で、別ユーザーでログインし直す手順を入れて、登録が失敗すること |\n\nこの表は、ソースから整理した確認項目です。実機での検証までは行っていません。\n\n## まとめ\n\n1.5.10.0 のパスキー関連の修正 3 点を、コード差分から読み解きました。\n\n- **Redis**：キーを `_` で分割して先頭だけを使う作りが、`Passkeys_...` というキーと噛み合っていなかった。`Take` はフィールド名をそのまま使う\n- **使い回し**：取得と削除が別操作だったものを、`Take` で原子的な 1 操作にした。保存先ごとに Lua・`output`・`returning`・`for update` で実現している\n- **登録**：完了時に、オプションを作ったユーザーと今のユーザーが同じかどうかを確認するようにした\n- **無効ユーザー**：パスキー認証でも `Disabled` を先に `Deny` する\n\nパスキーは、署名が正しいことと、その署名を受け入れてよい状況であることが別々の確認になります。今回の修正は、署名の検証の**前後**にある「セッションの扱い」と「アカウントの状態」の確認を埋めるものでした。パスキーを使っている環境は、早めに 1.5.10.0 以降への更新を検討してください。\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T03:08:33+09:00","group":null,"id":"d64d6fb3f48ce719ad43","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"プリザンター","versions":[]},{"name":"Pleasanter","versions":[]},{"name":"パスキー","versions":[]},{"name":"Security","versions":[]},{"name":"C#","versions":[]}],"title":"プリザンターのパスキー脆弱性修正3点をコード差分で読み解く","updated_at":"2026-11-18T03:08:33+09:00","url":"https://qiita.com/pmc-ko/items/d64d6fb3f48ce719ad43","user":{"description":"VehicleVisionという移動体(主に自動車)管理のためのパッケージの開発をしています。画像解析用の撮影光源の設計・開発やプリザンターのコントリビュータもやっています。","facebook_id":"","followees_count":35,"followers_count":16,"github_login_name":"pmc-ko","id":"pmc-ko","items_count":221,"linkedin_id":"","location":"","name":"K Ohtsuka","organization":"株式会社ピー・エム・シー","permanent_id":3555395,"profile_image_url":"https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3555395/profile-images/1773886383","team_only":false,"twitter_screen_name":null,"website_url":"https://github.com/pmc-ko"},"page_views_count":null,"team_membership":null,"organization_url_name":"vehiclevisionjp","slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003ch2 data-sourcepos=\"2:1-2:15\"\u003e\n\u003cspan id=\"はじめに\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eはじめに\u003c/h2\u003e\n\u003cp data-sourcepos=\"4:1-5:79\"\u003e前回の記事「VS Codeの更新を月1回振り返る[第1回：週次リリース開始から2026年10月まで]」では、1.111 から 1.142 までを振り返りました。\u003cbr\u003e\n今回はその続きとして、10月15日以降の更新を整理します。\u003c/p\u003e\n\u003cp data-sourcepos=\"7:1-8:182\"\u003eこの期間は、新機能が増えたというより、\u003cstrong\u003eCopilot harness が既定になり、これまでの Local harness から移行する流れがはっきりした\u003c/strong\u003eのが大きな変化です。\u003cbr\u003e\nあわせて、複数モデルの比較、クラウド上で動くセッション、Markdown や \u003ccode\u003efiles.exclude\u003c/code\u003e といった日常の編集に関わる改善も入っています。\u003c/p\u003e\n\u003cdiv data-sourcepos=\"10:1-14:3\" class=\"note info\"\u003e\n\u003cspan class=\"fa fa-fw fa-check-circle\"\u003e\u003c/span\u003e\u003cdiv\u003e\n\u003cp data-sourcepos=\"11:1-13:161\"\u003e対象は2026年10月15日から11月17日までに Stable として公開された 1.143 から 1.146 です。1.147 は一覧では Insiders 版のため対象外にしています。\u003cbr\u003e\n1.143 の公式ノートには公開日の記載が見当たらなかったため、日付は書かず、一覧の順序から 1.142 と 1.144 の間のリリースとして扱います。1.144 は10月28日、1.145 は11月4日、1.146 は11月11日の公開です。\u003cbr\u003e\n情報確認日は2026年11月17日です。公式リリースノートをもとにした整理で、各機能の実機検証レポートではありません。\u003c/p\u003e\n\u003c/div\u003e\n\u003c/div\u003e\n\u003ch2 data-sourcepos=\"16:1-16:24\"\u003e\n\u003cspan id=\"今月の主な変更\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BB%8A%E6%9C%88%E3%81%AE%E4%B8%BB%E3%81%AA%E5%A4%89%E6%9B%B4\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e今月の主な変更\u003c/h2\u003e\n\u003ctable data-sourcepos=\"18:1-23:150\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"18:1-18:52\"\u003e\n\u003cth data-sourcepos=\"18:2-18:18\"\u003eバージョン\u003c/th\u003e\n\u003cth data-sourcepos=\"18:20-18:33\"\u003e主な変更\u003c/th\u003e\n\u003cth data-sourcepos=\"18:35-18:51\"\u003e公式ノート\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"20:1-20:178\"\u003e\n\u003ctd data-sourcepos=\"20:2-20:8\"\u003e1.143\u003c/td\u003e\n\u003ctd data-sourcepos=\"20:10-20:121\"\u003eCopilot harness が新規セッションの既定に（一般提供）。モデル比較（Preview）が登場\u003c/td\u003e\n\u003ctd data-sourcepos=\"20:123-20:177\"\u003e\u003ca href=\"https://code.visualstudio.com/updates/v1_143\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.143\u003c/a\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"21:1-21:160\"\u003e\n\u003ctd data-sourcepos=\"21:2-21:8\"\u003e1.144\u003c/td\u003e\n\u003ctd data-sourcepos=\"21:10-21:103\"\u003eクラウドセッション、Copilot Fusion、アシスト付き権限承認の一般提供\u003c/td\u003e\n\u003ctd data-sourcepos=\"21:105-21:159\"\u003e\u003ca href=\"https://code.visualstudio.com/updates/v1_144\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.144\u003c/a\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"22:1-22:167\"\u003e\n\u003ctd data-sourcepos=\"22:2-22:8\"\u003e1.145\u003c/td\u003e\n\u003ctd data-sourcepos=\"22:10-22:110\"\u003e1つのセッションで複数の harness を混在（Preview）、\u003ccode\u003efiles.exclude\u003c/code\u003e の例外指定\u003c/td\u003e\n\u003ctd data-sourcepos=\"22:112-22:166\"\u003e\u003ca href=\"https://code.visualstudio.com/updates/v1_145\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.145\u003c/a\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"23:1-23:150\"\u003e\n\u003ctd data-sourcepos=\"23:2-23:8\"\u003e1.146\u003c/td\u003e\n\u003ctd data-sourcepos=\"23:10-23:93\"\u003eLocal harness の廃止予告（2027年2月）、Inbox モード（Experimental）\u003c/td\u003e\n\u003ctd data-sourcepos=\"23:95-23:149\"\u003e\u003ca href=\"https://code.visualstudio.com/updates/v1_146\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.146\u003c/a\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003ch2 data-sourcepos=\"25:1-25:30\"\u003e\n\u003cspan id=\"普段の開発への影響\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%99%AE%E6%AE%B5%E3%81%AE%E9%96%8B%E7%99%BA%E3%81%B8%E3%81%AE%E5%BD%B1%E9%9F%BF\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e普段の開発への影響\u003c/h2\u003e\n\u003ch3 data-sourcepos=\"27:1-27:59\"\u003e\n\u003cspan id=\"filesexclude-に例外を書けるようになった\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#filesexclude-%E3%81%AB%E4%BE%8B%E5%A4%96%E3%82%92%E6%9B%B8%E3%81%91%E3%82%8B%E3%82%88%E3%81%86%E3%81%AB%E3%81%AA%E3%81%A3%E3%81%9F\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e\u003ccode\u003efiles.exclude\u003c/code\u003e に例外を書けるようになった\u003c/h3\u003e\n\u003cp data-sourcepos=\"29:1-31:167\"\u003e1.145 では、\u003ccode\u003efiles.exclude\u003c/code\u003e のパターンの先頭に \u003ccode\u003e!\u003c/code\u003e を付けると、一致した項目を Explorer・検索・クイックオープンに表示したままにできるようになりました。\u003cbr\u003e\n広いパターンで隠しておいて、一部だけ見せたい、という書き方がしやすくなります。\u003cbr\u003e\n\u003ccode\u003esearch.exclude\u003c/code\u003e に書いた例外は、検索とクイックオープンにだけ適用されます。\u003ca href=\"https://code.visualstudio.com/updates/v1_145\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.145 の変更\u003c/a\u003e\u003c/p\u003e\n\u003ch3 data-sourcepos=\"33:1-33:53\"\u003e\n\u003cspan id=\"診断表示の上限と-markdown-プレビュー\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E8%A8%BA%E6%96%AD%E8%A1%A8%E7%A4%BA%E3%81%AE%E4%B8%8A%E9%99%90%E3%81%A8-markdown-%E3%83%97%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e診断表示の上限と Markdown プレビュー\u003c/h3\u003e\n\u003cp data-sourcepos=\"35:1-36:203\"\u003e1.143 では、エディタ上でハイライトする診断の上限が、ファイルごとに 500 から 5,000 に増えました。\u003cbr\u003e\n拡張機能ごとの診断は1ファイルあたり 1,000 件までで、上限に達すると言語ステータスに警告が出ます。\u003ca href=\"https://code.visualstudio.com/updates/v1_143\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.143 の変更\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"38:1-38:54\"\u003eMarkdown 周辺では、次の変更があります。\u003c/p\u003e\n\u003ctable data-sourcepos=\"40:1-44:183\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"40:1-40:46\"\u003e\n\u003cth data-sourcepos=\"40:2-40:18\"\u003eバージョン\u003c/th\u003e\n\u003cth data-sourcepos=\"40:20-40:27\"\u003e変更\u003c/th\u003e\n\u003cth data-sourcepos=\"40:29-40:45\"\u003e使いどころ\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"42:1-42:152\"\u003e\n\u003ctd data-sourcepos=\"42:2-42:8\"\u003e1.144\u003c/td\u003e\n\u003ctd data-sourcepos=\"42:10-42:122\"\u003eMarkdown エディタで、表示を見ながら直接編集するか、ソースを編集するかを選べる\u003c/td\u003e\n\u003ctd data-sourcepos=\"42:124-42:151\"\u003e記事や README の編集\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"43:1-43:149\"\u003e\n\u003ctd data-sourcepos=\"43:2-43:8\"\u003e1.145\u003c/td\u003e\n\u003ctd data-sourcepos=\"43:10-43:110\"\u003eプレビューの Mermaid で、線がサブグラフのタイトルをまたがないよう改善\u003c/td\u003e\n\u003ctd data-sourcepos=\"43:112-43:148\"\u003eMermaid の図を確認するとき\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"44:1-44:183\"\u003e\n\u003ctd data-sourcepos=\"44:2-44:8\"\u003e1.146\u003c/td\u003e\n\u003ctd data-sourcepos=\"44:10-44:149\"\u003eチャット・Markdown プレビュー・ノートブックの Mermaid が Mermaid 12 に更新され、ユースケース図が使える\u003c/td\u003e\n\u003ctd data-sourcepos=\"44:151-44:182\"\u003e図を含むドキュメント\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"46:1-46:174\"\u003e出典：\u003ca href=\"https://code.visualstudio.com/updates/v1_144\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.144\u003c/a\u003e、\u003ca href=\"https://code.visualstudio.com/updates/v1_145\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.145\u003c/a\u003e、\u003ca href=\"https://code.visualstudio.com/updates/v1_146\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.146\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"48:1-49:78\"\u003eQiita に投稿する Mermaid は、VS Code のプレビューとは別のレンダリングです。\u003cbr\u003e\n記事にするときは、Qiita 側のプレビューでも確認します。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"51:1-51:16\"\u003e\n\u003cspan id=\"そのほか\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%9D%E3%81%AE%E3%81%BB%E3%81%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eそのほか\u003c/h3\u003e\n\u003cul data-sourcepos=\"53:1-56:0\"\u003e\n\u003cli data-sourcepos=\"53:1-53:292\"\u003e1.144 の Windows 版ターミナルでは、コンソールツールのダイアログが VS Code の前面に開くようになりました。\u003ccode\u003eterminal.integrated.windowsReparentConsoleWindow\u003c/code\u003e で制御し、\u003ccode\u003eterminal.integrated.windowsUseConptyDll\u003c/code\u003e（既定で有効）が前提です。\u003c/li\u003e\n\u003cli data-sourcepos=\"54:1-54:178\"\u003e1.144 の Issue Reporter には、1ページで入力でき、ファイルを添付できる新しいウィザード（\u003ccode\u003eissueReporter.wizard.enabled\u003c/code\u003e）が加わりました。\u003c/li\u003e\n\u003cli data-sourcepos=\"55:1-56:0\"\u003e1.146 の内蔵ブラウザーでは、ローカル HTML ファイルの \u003ccode\u003efile://\u003c/code\u003e アドレスをコピーできます。\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"57:1-57:112\"\u003eGit については、今回の公式ノートで特に取り上げる変更は見当たりませんでした。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"59:1-59:32\"\u003e\n\u003cspan id=\"aiエージェント関連\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#ai%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E9%96%A2%E9%80%A3\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eAI・エージェント関連\u003c/h2\u003e\n\u003ch3 data-sourcepos=\"61:1-61:73\"\u003e\n\u003cspan id=\"copilot-harness-が既定になりlocal-harness-は廃止予定に\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#copilot-harness-%E3%81%8C%E6%97%A2%E5%AE%9A%E3%81%AB%E3%81%AA%E3%82%8Alocal-harness-%E3%81%AF%E5%BB%83%E6%AD%A2%E4%BA%88%E5%AE%9A%E3%81%AB\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eCopilot harness が既定になり、Local harness は廃止予定に\u003c/h3\u003e\n\u003cp data-sourcepos=\"63:1-64:287\"\u003e1.143 で、新規セッションは Copilot harness が既定になりました。\u003cbr\u003e\nCopilot harness は Copilot SDK をもとにしていて、Agent Host を通して動きます。エディタと Agents ウィンドウを切り替えても、セッションをバックグラウンドで動かし続けられます。\u003ca href=\"https://code.visualstudio.com/updates/v1_143\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.143\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"66:1-68:317\"\u003eその流れで、1.146 では \u003cstrong\u003eLocal harness が機能的に凍結され、2027年2月に削除される\u003c/strong\u003eと案内されました。\u003cbr\u003e\n組織向けの設定 \u003ccode\u003evscode.temporaryDefaultToLocalHarness\u003c/code\u003e も、同じ時期に削除されます。\u003ca href=\"https://code.visualstudio.com/updates/v1_146\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.146\u003c/a\u003e\u003cbr\u003e\n1.145 では Local harness 向けの \u003ccode\u003e#installExtension\u003c/code\u003e・\u003ccode\u003e#runCommand\u003c/code\u003e・\u003ccode\u003e#newWorkspace\u003c/code\u003e ツールと \u003ccode\u003e/new\u003c/code\u003e コマンドも削除されているので、これらを使うカスタムエージェントやプロンプトファイルは見直しが必要です。\u003ca href=\"https://code.visualstudio.com/updates/v1_145\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.145\u003c/a\u003e\u003c/p\u003e\n\u003ch3 data-sourcepos=\"70:1-70:55\"\u003e\n\u003cspan id=\"複数モデル複数-harness-を使い分ける\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E8%A4%87%E6%95%B0%E3%83%A2%E3%83%87%E3%83%AB%E8%A4%87%E6%95%B0-harness-%E3%82%92%E4%BD%BF%E3%81%84%E5%88%86%E3%81%91%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e複数モデル・複数 harness を使い分ける\u003c/h3\u003e\n\u003ctable data-sourcepos=\"72:1-76:188\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"72:1-72:37\"\u003e\n\u003cth data-sourcepos=\"72:2-72:9\"\u003e機能\u003c/th\u003e\n\u003cth data-sourcepos=\"72:11-72:18\"\u003e状態\u003c/th\u003e\n\u003cth data-sourcepos=\"72:20-72:27\"\u003e概要\u003c/th\u003e\n\u003cth data-sourcepos=\"72:29-72:36\"\u003e条件\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"74:1-74:205\"\u003e\n\u003ctd data-sourcepos=\"74:2-74:29\"\u003eモデル比較（1.143）\u003c/td\u003e\n\u003ctd data-sourcepos=\"74:31-74:39\"\u003ePreview\u003c/td\u003e\n\u003ctd data-sourcepos=\"74:41-74:138\"\u003e1つのプロンプトを Copilot・Claude・Codex の harness で実行し、結果を比べる\u003c/td\u003e\n\u003ctd data-sourcepos=\"74:140-74:204\"\u003eAgents ウィンドウで \u003ccode\u003esessions.chat.compareAgents.enabled\u003c/code\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"75:1-75:181\"\u003e\n\u003ctd data-sourcepos=\"75:2-75:28\"\u003eCopilot Fusion（1.144）\u003c/td\u003e\n\u003ctd data-sourcepos=\"75:30-75:43\"\u003e一般提供\u003c/td\u003e\n\u003ctd data-sourcepos=\"75:45-75:109\"\u003eリクエストごとにモデルを選んで組み合わせる\u003c/td\u003e\n\u003ctd data-sourcepos=\"75:111-75:180\"\u003eHigh・Max の階層は Pro+、Max、Business、Enterprise プラン\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"76:1-76:188\"\u003e\n\u003ctd data-sourcepos=\"76:2-76:38\"\u003e複数 harness の混在（1.145）\u003c/td\u003e\n\u003ctd data-sourcepos=\"76:40-76:48\"\u003ePreview\u003c/td\u003e\n\u003ctd data-sourcepos=\"76:50-76:138\"\u003eネストしたセッションで、親と別の harness（Claude や Codex）を使う\u003c/td\u003e\n\u003ctd data-sourcepos=\"76:140-76:187\"\u003e\u003ccode\u003echat.agentHost.multipleChatProviders.enabled\u003c/code\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"78:1-78:174\"\u003e出典：\u003ca href=\"https://code.visualstudio.com/updates/v1_143\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.143\u003c/a\u003e、\u003ca href=\"https://code.visualstudio.com/updates/v1_144\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.144\u003c/a\u003e、\u003ca href=\"https://code.visualstudio.com/updates/v1_145\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.145\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"80:1-81:114\"\u003e1.144 では、モデル比較は対象となる新規の Agents ウィンドウのセッションで既定で有効になりました。\u003cbr\u003e\n1.146 では、Copilot Fusion を比較の対象・審査役・統合役に選べるようになっています。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"83:1-83:31\"\u003e\n\u003cspan id=\"クラウドと定期実行\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%AF%E3%83%A9%E3%82%A6%E3%83%89%E3%81%A8%E5%AE%9A%E6%9C%9F%E5%AE%9F%E8%A1%8C\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eクラウドと定期実行\u003c/h3\u003e\n\u003cp data-sourcepos=\"85:1-86:269\"\u003e1.144 の\u003cstrong\u003eクラウドセッション\u003c/strong\u003eは、GitHub のインフラ上で Copilot のタスクを動かす機能です。手元のマシンをつけたままにしなくても作業が続きます。有料の Copilot プランが必要です。\u003cbr\u003e\n同じ 1.144 で、**クラウド Automations（Preview）**も登場しました。\u003ccode\u003echat.automations.cloud.enabled\u003c/code\u003e は既定で有効で、スケジュールやリポジトリのイベントで実行できます。\u003ca href=\"https://code.visualstudio.com/updates/v1_144\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.144\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"88:1-88:229\"\u003e1.145 では、ローカルの Automations に5項目の cron 式を使えるようになりました。ただし、cron 式はクラウド Automations では使えません。\u003ca href=\"https://code.visualstudio.com/updates/v1_145\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.145\u003c/a\u003e\u003c/p\u003e\n\u003ch3 data-sourcepos=\"90:1-90:22\"\u003e\n\u003cspan id=\"権限と安全面\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%A8%A9%E9%99%90%E3%81%A8%E5%AE%89%E5%85%A8%E9%9D%A2\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e権限と安全面\u003c/h3\u003e\n\u003cul data-sourcepos=\"92:1-96:0\"\u003e\n\u003cli data-sourcepos=\"92:1-92:243\"\u003e1.144：Copilot セッションの\u003cstrong\u003eアシスト付き権限承認\u003c/strong\u003eが一般提供になりました。ツール呼び出しの危険度を LLM が評価し、低いものを自動承認します。フォルダーの分離が必要です。\u003c/li\u003e\n\u003cli data-sourcepos=\"93:1-93:219\"\u003e1.144：デスクトップ操作を行う \u003cstrong\u003eComputer Use\u003c/strong\u003e が Experimental で登場しました。macOS または Windows の Copilot harness 向けで、\u003ccode\u003echat.agentHost.computerUse.enabled\u003c/code\u003e で有効にします。\u003c/li\u003e\n\u003cli data-sourcepos=\"94:1-94:209\"\u003e1.146：サンドボックス内のツールから環境変数を隠せる \u003ccode\u003echat.agent.sandbox.credentials.envVars\u003c/code\u003e が加わりました。承認した HTTPS ホストにだけ実際の値を渡します。\u003c/li\u003e\n\u003cli data-sourcepos=\"95:1-96:0\"\u003e1.146：URL 取得などの許可で、「このセッションで許可」のような広い選択肢ではなく、ドメイン・コマンド・ディレクトリ単位の許可が提示されるようになりました。\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"97:1-97:118\"\u003e出典：\u003ca href=\"https://code.visualstudio.com/updates/v1_144\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.144\u003c/a\u003e、\u003ca href=\"https://code.visualstudio.com/updates/v1_146\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.146\u003c/a\u003e\u003c/p\u003e\n\u003ch3 data-sourcepos=\"99:1-99:37\"\u003e\n\u003cspan id=\"canvases-や記憶そのほか\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#canvases-%E3%82%84%E8%A8%98%E6%86%B6%E3%81%9D%E3%81%AE%E3%81%BB%E3%81%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eCanvases や記憶、そのほか\u003c/h3\u003e\n\u003cp data-sourcepos=\"101:1-103:112\"\u003eCanvases（Preview）は、1.143 から 1.146 まで毎回拡充されています。\u003cbr\u003e\n1.145 では、リモートの Agent Host 上での利用（\u003ccode\u003eworkbench.browser.enableRemoteProxy\u003c/code\u003e も必要）と、サイドバーへのピン留め（Experimental）が追加されました。\u003cbr\u003e\n1.146 では、canvas 拡張が特権的な機能を使う前に許可を求めるようになっています。\u003c/p\u003e\n\u003cp data-sourcepos=\"105:1-106:284\"\u003e1.144 では、Copilot harness で Copilot Memory が既定で有効になりました。\u003cbr\u003e\nまた、GitHub が管理する MCP サーバーを使う Copilot Connectors（Preview）が全プランで既定で有効になっています。Slack・Notion・Sentry などに対応し、Copilot harness のみで使えます。\u003ca href=\"https://code.visualstudio.com/updates/v1_144\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.144\u003c/a\u003e\u003c/p\u003e\n\u003ch2 data-sourcepos=\"108:1-108:30\"\u003e\n\u003cspan id=\"パッチで直ったこと\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%91%E3%83%83%E3%83%81%E3%81%A7%E7%9B%B4%E3%81%A3%E3%81%9F%E3%81%93%E3%81%A8\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eパッチで直ったこと\u003c/h2\u003e\n\u003cp data-sourcepos=\"110:1-110:69\"\u003e公式ノートで確認できたパッチは次のとおりです。\u003c/p\u003e\n\u003ctable data-sourcepos=\"112:1-117:95\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"112:1-112:61\"\u003e\n\u003cth data-sourcepos=\"112:2-112:12\"\u003eパッチ\u003c/th\u003e\n\u003cth data-sourcepos=\"112:14-112:51\"\u003e公式に案内されている内容\u003c/th\u003e\n\u003cth data-sourcepos=\"112:53-112:60\"\u003e備考\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"114:1-114:124\"\u003e\n\u003ctd data-sourcepos=\"114:2-114:10\"\u003e1.143.1\u003c/td\u003e\n\u003ctd data-sourcepos=\"114:12-114:59\"\u003e候補として挙がった Issue への対応\u003c/td\u003e\n\u003ctd data-sourcepos=\"114:61-114:123\"\u003e修正内容の一覧は Issue 一覧へのリンクで案内\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"115:1-115:107\"\u003e\n\u003ctd data-sourcepos=\"115:2-115:10\"\u003e1.144.1\u003c/td\u003e\n\u003ctd data-sourcepos=\"115:12-115:52\"\u003eダウンロード対象として記載\u003c/td\u003e\n\u003ctd data-sourcepos=\"115:54-115:106\"\u003e1.144 のノートには修正内容の説明なし\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"116:1-116:78\"\u003e\n\u003ctd data-sourcepos=\"116:2-116:20\"\u003e1.145.1、1.145.2\u003c/td\u003e\n\u003ctd data-sourcepos=\"116:22-116:38\"\u003e不具合修正\u003c/td\u003e\n\u003ctd data-sourcepos=\"116:40-116:77\"\u003eIssue 一覧へのリンクで案内\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"117:1-117:95\"\u003e\n\u003ctd data-sourcepos=\"117:2-117:10\"\u003e1.145.3\u003c/td\u003e\n\u003ctd data-sourcepos=\"117:12-117:55\"\u003eセキュリティ上の問題への対応\u003c/td\u003e\n\u003ctd data-sourcepos=\"117:57-117:94\"\u003eIssue 一覧へのリンクで案内\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"119:1-119:174\"\u003e出典：\u003ca href=\"https://code.visualstudio.com/updates/v1_143\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.143\u003c/a\u003e、\u003ca href=\"https://code.visualstudio.com/updates/v1_144\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.144\u003c/a\u003e、\u003ca href=\"https://code.visualstudio.com/updates/v1_145\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.145\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"121:1-123:87\"\u003e1.146 のノートにはパッチの案内はありませんでした。\u003cbr\u003e\n個々の修正内容、影響する環境や操作は、公式ノートからリンクされた Issue 一覧を確認する必要があります。ここでは、公式ノートに書かれた範囲だけを整理しています。\u003cbr\u003e\nパッチの数から、更新の品質や原因を推測することはしません。\u003c/p\u003e\n\u003cp data-sourcepos=\"125:1-125:103\"\u003e1.145 のリリースノートには、本体の修正として次の2点も記載されています。\u003c/p\u003e\n\u003cul data-sourcepos=\"127:1-129:0\"\u003e\n\u003cli data-sourcepos=\"127:1-127:195\"\u003e組織が無効にしたエージェント（Claude や Codex）を以前選んでいても、読み取り専用のチャットにならず、新規チャットは既定の harness に戻る。\u003c/li\u003e\n\u003cli data-sourcepos=\"128:1-129:0\"\u003eMCP レジストリのポリシー更新に失敗しても、レジストリの制限が外れず、最後に取得したポリシーが維持される。\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch2 data-sourcepos=\"130:1-130:27\"\u003e\n\u003cspan id=\"注意が必要な変更\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%B3%A8%E6%84%8F%E3%81%8C%E5%BF%85%E8%A6%81%E3%81%AA%E5%A4%89%E6%9B%B4\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e注意が必要な変更\u003c/h2\u003e\n\u003ctable data-sourcepos=\"132:1-138:216\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"132:1-132:58\"\u003e\n\u003cth data-sourcepos=\"132:2-132:9\"\u003e対象\u003c/th\u003e\n\u003cth data-sourcepos=\"132:11-132:18\"\u003e変更\u003c/th\u003e\n\u003cth data-sourcepos=\"132:20-132:39\"\u003e確認すること\u003c/th\u003e\n\u003cth data-sourcepos=\"132:41-132:57\"\u003e公式ノート\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"134:1-134:250\"\u003e\n\u003ctd data-sourcepos=\"134:2-134:16\"\u003eLocal harness\u003c/td\u003e\n\u003ctd data-sourcepos=\"134:18-134:69\"\u003e1.146 で機能凍結。2027年2月に削除予定\u003c/td\u003e\n\u003ctd data-sourcepos=\"134:71-134:193\"\u003eCopilot harness で今の作業が動くか。Local 向けのカスタムエージェント・プロンプトを見直す\u003c/td\u003e\n\u003ctd data-sourcepos=\"134:195-134:249\"\u003e\u003ca href=\"https://code.visualstudio.com/updates/v1_146\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.146\u003c/a\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"135:1-135:261\"\u003e\n\u003ctd data-sourcepos=\"135:2-135:29\"\u003eLocal harness のツール\u003c/td\u003e\n\u003ctd data-sourcepos=\"135:31-135:129\"\u003e1.145 で \u003ccode\u003e#installExtension\u003c/code\u003e・\u003ccode\u003e#runCommand\u003c/code\u003e・\u003ccode\u003e#newWorkspace\u003c/code\u003e・\u003ccode\u003e/new\u003c/code\u003e と関連設定を削除\u003c/td\u003e\n\u003ctd data-sourcepos=\"135:131-135:204\"\u003eカスタムエージェントやプロンプトファイルでの参照\u003c/td\u003e\n\u003ctd data-sourcepos=\"135:206-135:260\"\u003e\u003ca href=\"https://code.visualstudio.com/updates/v1_145\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.145\u003c/a\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"136:1-136:239\"\u003e\n\u003ctd data-sourcepos=\"136:2-136:36\"\u003e作業中の編集の Keep / Undo\u003c/td\u003e\n\u003ctd data-sourcepos=\"136:38-136:96\"\u003e1.144 でエディタウィンドウでは既定で有効\u003c/td\u003e\n\u003ctd data-sourcepos=\"136:98-136:182\"\u003eChanges のピル表示に戻すなら \u003ccode\u003echat.editor.workingSet.enabled\u003c/code\u003e を \u003ccode\u003efalse\u003c/code\u003e\n\u003c/td\u003e\n\u003ctd data-sourcepos=\"136:184-136:238\"\u003e\u003ca href=\"https://code.visualstudio.com/updates/v1_144\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.144\u003c/a\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"137:1-137:258\"\u003e\n\u003ctd data-sourcepos=\"137:2-137:21\"\u003e組織の既定値\u003c/td\u003e\n\u003ctd data-sourcepos=\"137:23-137:114\"\u003eモデルや権限レベルの組織既定が、記憶された選択より優先される\u003c/td\u003e\n\u003ctd data-sourcepos=\"137:116-137:201\"\u003e新しいチャットの初期設定が変わる場合は組織ポリシーを確認\u003c/td\u003e\n\u003ctd data-sourcepos=\"137:203-137:257\"\u003e\u003ca href=\"https://code.visualstudio.com/updates/v1_144\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.144\u003c/a\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"138:1-138:216\"\u003e\n\u003ctd data-sourcepos=\"138:2-138:18\"\u003e権限の確認\u003c/td\u003e\n\u003ctd data-sourcepos=\"138:20-138:99\"\u003e広い許可から、ドメイン・コマンド・ディレクトリ単位へ\u003c/td\u003e\n\u003ctd data-sourcepos=\"138:101-138:159\"\u003e確認ダイアログが増えた場合の理由として\u003c/td\u003e\n\u003ctd data-sourcepos=\"138:161-138:215\"\u003e\u003ca href=\"https://code.visualstudio.com/updates/v1_146\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.146\u003c/a\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003ch2 data-sourcepos=\"140:1-140:27\"\u003e\n\u003cspan id=\"試してみたい機能\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E8%A9%A6%E3%81%97%E3%81%A6%E3%81%BF%E3%81%9F%E3%81%84%E6%A9%9F%E8%83%BD\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e試してみたい機能\u003c/h2\u003e\n\u003cp data-sourcepos=\"142:1-142:96\"\u003eここでは公式ノートの内容を紹介します。実機では確認していません。\u003c/p\u003e\n\u003cul data-sourcepos=\"144:1-147:0\"\u003e\n\u003cli data-sourcepos=\"144:1-144:199\"\u003e\n\u003cstrong\u003e\u003ccode\u003efiles.exclude\u003c/code\u003e の \u003ccode\u003e!\u003c/code\u003e 例外\u003c/strong\u003e：Explorer を整理している人向けです。設定の書き方は \u003ca href=\"https://code.visualstudio.com/updates/v1_145\" rel=\"nofollow noopener\" target=\"_blank\"\u003e1.145 のノート\u003c/a\u003eで確認できます。\u003c/li\u003e\n\u003cli data-sourcepos=\"145:1-145:171\"\u003e\n\u003cstrong\u003eモデル比較\u003c/strong\u003e：同じ依頼を複数のモデル・harness で試せます。Agents ウィンドウで \u003ccode\u003esessions.chat.compareAgents.enabled\u003c/code\u003e を確認します。\u003c/li\u003e\n\u003cli data-sourcepos=\"146:1-147:0\"\u003e\n\u003cstrong\u003eサンドボックスの環境変数の隠蔽\u003c/strong\u003e：\u003ccode\u003echat.agent.sandbox.credentials.envVars\u003c/code\u003e に、エージェントに見せたくない環境変数を指定します。\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch2 data-sourcepos=\"148:1-148:12\"\u003e\n\u003cspan id=\"まとめ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%BE%E3%81%A8%E3%82%81\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eまとめ\u003c/h2\u003e\n\u003cul data-sourcepos=\"150:1-156:0\"\u003e\n\u003cli data-sourcepos=\"150:1-150:119\"\u003e対象期間は 1.143 から 1.146 で、10月15日から11月17日までに Stable で公開されたものです。\u003c/li\u003e\n\u003cli data-sourcepos=\"151:1-151:124\"\u003eCopilot harness が新規セッションの既定になり、Local harness は2027年2月に削除される予定です。\u003c/li\u003e\n\u003cli data-sourcepos=\"152:1-152:155\"\u003eモデルの比較、複数 harness の混在、クラウドセッション、Automations など、エージェントの使い方が広がりました。\u003c/li\u003e\n\u003cli data-sourcepos=\"153:1-153:125\"\u003e\n\u003ccode\u003efiles.exclude\u003c/code\u003e の例外指定や Markdown・Mermaid の改善など、日常の編集に関わる変更もあります。\u003c/li\u003e\n\u003cli data-sourcepos=\"154:1-154:138\"\u003eパッチは 1.143.1、1.144.1、1.145.1 から 1.145.3 を公式ノートで確認でき、1.145.3 がセキュリティ対応です。\u003c/li\u003e\n\u003cli data-sourcepos=\"155:1-156:0\"\u003eLocal 向けのカスタムエージェント、組織ポリシー、権限確認の変化は、更新前後で見比べておきたい部分です。\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"157:1-158:172\"\u003e次回は11月18日以降を対象にする予定です。\u003cbr\u003e\n気になる変更は、各項目の公式ノートと\u003ca href=\"https://code.visualstudio.com/updates/archive\" rel=\"nofollow noopener\" target=\"_blank\"\u003eリリースノート一覧\u003c/a\u003eで条件を確認してみましょう。\u003c/p\u003e\n","body":"\n## はじめに\n\n前回の記事「VS Codeの更新を月1回振り返る[第1回：週次リリース開始から2026年10月まで]」では、1.111 から 1.142 までを振り返りました。\n今回はその続きとして、10月15日以降の更新を整理します。\n\nこの期間は、新機能が増えたというより、**Copilot harness が既定になり、これまでの Local harness から移行する流れがはっきりした**のが大きな変化です。\nあわせて、複数モデルの比較、クラウド上で動くセッション、Markdown や `files.exclude` といった日常の編集に関わる改善も入っています。\n\n:::note info\n対象は2026年10月15日から11月17日までに Stable として公開された 1.143 から 1.146 です。1.147 は一覧では Insiders 版のため対象外にしています。\n1.143 の公式ノートには公開日の記載が見当たらなかったため、日付は書かず、一覧の順序から 1.142 と 1.144 の間のリリースとして扱います。1.144 は10月28日、1.145 は11月4日、1.146 は11月11日の公開です。\n情報確認日は2026年11月17日です。公式リリースノートをもとにした整理で、各機能の実機検証レポートではありません。\n:::\n\n## 今月の主な変更\n\n| バージョン | 主な変更 | 公式ノート |\n| --- | --- | --- |\n| 1.143 | Copilot harness が新規セッションの既定に（一般提供）。モデル比較（Preview）が登場 | [1.143](https://code.visualstudio.com/updates/v1_143) |\n| 1.144 | クラウドセッション、Copilot Fusion、アシスト付き権限承認の一般提供 | [1.144](https://code.visualstudio.com/updates/v1_144) |\n| 1.145 | 1つのセッションで複数の harness を混在（Preview）、`files.exclude` の例外指定 | [1.145](https://code.visualstudio.com/updates/v1_145) |\n| 1.146 | Local harness の廃止予告（2027年2月）、Inbox モード（Experimental） | [1.146](https://code.visualstudio.com/updates/v1_146) |\n\n## 普段の開発への影響\n\n### `files.exclude` に例外を書けるようになった\n\n1.145 では、`files.exclude` のパターンの先頭に `!` を付けると、一致した項目を Explorer・検索・クイックオープンに表示したままにできるようになりました。\n広いパターンで隠しておいて、一部だけ見せたい、という書き方がしやすくなります。\n`search.exclude` に書いた例外は、検索とクイックオープンにだけ適用されます。[1.145 の変更](https://code.visualstudio.com/updates/v1_145)\n\n### 診断表示の上限と Markdown プレビュー\n\n1.143 では、エディタ上でハイライトする診断の上限が、ファイルごとに 500 から 5,000 に増えました。\n拡張機能ごとの診断は1ファイルあたり 1,000 件までで、上限に達すると言語ステータスに警告が出ます。[1.143 の変更](https://code.visualstudio.com/updates/v1_143)\n\nMarkdown 周辺では、次の変更があります。\n\n| バージョン | 変更 | 使いどころ |\n| --- | --- | --- |\n| 1.144 | Markdown エディタで、表示を見ながら直接編集するか、ソースを編集するかを選べる | 記事や README の編集 |\n| 1.145 | プレビューの Mermaid で、線がサブグラフのタイトルをまたがないよう改善 | Mermaid の図を確認するとき |\n| 1.146 | チャット・Markdown プレビュー・ノートブックの Mermaid が Mermaid 12 に更新され、ユースケース図が使える | 図を含むドキュメント |\n\n出典：[1.144](https://code.visualstudio.com/updates/v1_144)、[1.145](https://code.visualstudio.com/updates/v1_145)、[1.146](https://code.visualstudio.com/updates/v1_146)\n\nQiita に投稿する Mermaid は、VS Code のプレビューとは別のレンダリングです。\n記事にするときは、Qiita 側のプレビューでも確認します。\n\n### そのほか\n\n- 1.144 の Windows 版ターミナルでは、コンソールツールのダイアログが VS Code の前面に開くようになりました。`terminal.integrated.windowsReparentConsoleWindow` で制御し、`terminal.integrated.windowsUseConptyDll`（既定で有効）が前提です。\n- 1.144 の Issue Reporter には、1ページで入力でき、ファイルを添付できる新しいウィザード（`issueReporter.wizard.enabled`）が加わりました。\n- 1.146 の内蔵ブラウザーでは、ローカル HTML ファイルの `file://` アドレスをコピーできます。\n\nGit については、今回の公式ノートで特に取り上げる変更は見当たりませんでした。\n\n## AI・エージェント関連\n\n### Copilot harness が既定になり、Local harness は廃止予定に\n\n1.143 で、新規セッションは Copilot harness が既定になりました。\nCopilot harness は Copilot SDK をもとにしていて、Agent Host を通して動きます。エディタと Agents ウィンドウを切り替えても、セッションをバックグラウンドで動かし続けられます。[1.143](https://code.visualstudio.com/updates/v1_143)\n\nその流れで、1.146 では **Local harness が機能的に凍結され、2027年2月に削除される**と案内されました。\n組織向けの設定 `vscode.temporaryDefaultToLocalHarness` も、同じ時期に削除されます。[1.146](https://code.visualstudio.com/updates/v1_146)\n1.145 では Local harness 向けの `#installExtension`・`#runCommand`・`#newWorkspace` ツールと `/new` コマンドも削除されているので、これらを使うカスタムエージェントやプロンプトファイルは見直しが必要です。[1.145](https://code.visualstudio.com/updates/v1_145)\n\n### 複数モデル・複数 harness を使い分ける\n\n| 機能 | 状態 | 概要 | 条件 |\n| --- | --- | --- | --- |\n| モデル比較（1.143） | Preview | 1つのプロンプトを Copilot・Claude・Codex の harness で実行し、結果を比べる | Agents ウィンドウで `sessions.chat.compareAgents.enabled` |\n| Copilot Fusion（1.144） | 一般提供 | リクエストごとにモデルを選んで組み合わせる | High・Max の階層は Pro+、Max、Business、Enterprise プラン |\n| 複数 harness の混在（1.145） | Preview | ネストしたセッションで、親と別の harness（Claude や Codex）を使う | `chat.agentHost.multipleChatProviders.enabled` |\n\n出典：[1.143](https://code.visualstudio.com/updates/v1_143)、[1.144](https://code.visualstudio.com/updates/v1_144)、[1.145](https://code.visualstudio.com/updates/v1_145)\n\n1.144 では、モデル比較は対象となる新規の Agents ウィンドウのセッションで既定で有効になりました。\n1.146 では、Copilot Fusion を比較の対象・審査役・統合役に選べるようになっています。\n\n### クラウドと定期実行\n\n1.144 の**クラウドセッション**は、GitHub のインフラ上で Copilot のタスクを動かす機能です。手元のマシンをつけたままにしなくても作業が続きます。有料の Copilot プランが必要です。\n同じ 1.144 で、**クラウド Automations（Preview）**も登場しました。`chat.automations.cloud.enabled` は既定で有効で、スケジュールやリポジトリのイベントで実行できます。[1.144](https://code.visualstudio.com/updates/v1_144)\n\n1.145 では、ローカルの Automations に5項目の cron 式を使えるようになりました。ただし、cron 式はクラウド Automations では使えません。[1.145](https://code.visualstudio.com/updates/v1_145)\n\n### 権限と安全面\n\n- 1.144：Copilot セッションの**アシスト付き権限承認**が一般提供になりました。ツール呼び出しの危険度を LLM が評価し、低いものを自動承認します。フォルダーの分離が必要です。\n- 1.144：デスクトップ操作を行う **Computer Use** が Experimental で登場しました。macOS または Windows の Copilot harness 向けで、`chat.agentHost.computerUse.enabled` で有効にします。\n- 1.146：サンドボックス内のツールから環境変数を隠せる `chat.agent.sandbox.credentials.envVars` が加わりました。承認した HTTPS ホストにだけ実際の値を渡します。\n- 1.146：URL 取得などの許可で、「このセッションで許可」のような広い選択肢ではなく、ドメイン・コマンド・ディレクトリ単位の許可が提示されるようになりました。\n\n出典：[1.144](https://code.visualstudio.com/updates/v1_144)、[1.146](https://code.visualstudio.com/updates/v1_146)\n\n### Canvases や記憶、そのほか\n\nCanvases（Preview）は、1.143 から 1.146 まで毎回拡充されています。\n1.145 では、リモートの Agent Host 上での利用（`workbench.browser.enableRemoteProxy` も必要）と、サイドバーへのピン留め（Experimental）が追加されました。\n1.146 では、canvas 拡張が特権的な機能を使う前に許可を求めるようになっています。\n\n1.144 では、Copilot harness で Copilot Memory が既定で有効になりました。\nまた、GitHub が管理する MCP サーバーを使う Copilot Connectors（Preview）が全プランで既定で有効になっています。Slack・Notion・Sentry などに対応し、Copilot harness のみで使えます。[1.144](https://code.visualstudio.com/updates/v1_144)\n\n## パッチで直ったこと\n\n公式ノートで確認できたパッチは次のとおりです。\n\n| パッチ | 公式に案内されている内容 | 備考 |\n| --- | --- | --- |\n| 1.143.1 | 候補として挙がった Issue への対応 | 修正内容の一覧は Issue 一覧へのリンクで案内 |\n| 1.144.1 | ダウンロード対象として記載 | 1.144 のノートには修正内容の説明なし |\n| 1.145.1、1.145.2 | 不具合修正 | Issue 一覧へのリンクで案内 |\n| 1.145.3 | セキュリティ上の問題への対応 | Issue 一覧へのリンクで案内 |\n\n出典：[1.143](https://code.visualstudio.com/updates/v1_143)、[1.144](https://code.visualstudio.com/updates/v1_144)、[1.145](https://code.visualstudio.com/updates/v1_145)\n\n1.146 のノートにはパッチの案内はありませんでした。\n個々の修正内容、影響する環境や操作は、公式ノートからリンクされた Issue 一覧を確認する必要があります。ここでは、公式ノートに書かれた範囲だけを整理しています。\nパッチの数から、更新の品質や原因を推測することはしません。\n\n1.145 のリリースノートには、本体の修正として次の2点も記載されています。\n\n- 組織が無効にしたエージェント（Claude や Codex）を以前選んでいても、読み取り専用のチャットにならず、新規チャットは既定の harness に戻る。\n- MCP レジストリのポリシー更新に失敗しても、レジストリの制限が外れず、最後に取得したポリシーが維持される。\n\n## 注意が必要な変更\n\n| 対象 | 変更 | 確認すること | 公式ノート |\n| --- | --- | --- | --- |\n| Local harness | 1.146 で機能凍結。2027年2月に削除予定 | Copilot harness で今の作業が動くか。Local 向けのカスタムエージェント・プロンプトを見直す | [1.146](https://code.visualstudio.com/updates/v1_146) |\n| Local harness のツール | 1.145 で `#installExtension`・`#runCommand`・`#newWorkspace`・`/new` と関連設定を削除 | カスタムエージェントやプロンプトファイルでの参照 | [1.145](https://code.visualstudio.com/updates/v1_145) |\n| 作業中の編集の Keep / Undo | 1.144 でエディタウィンドウでは既定で有効 | Changes のピル表示に戻すなら `chat.editor.workingSet.enabled` を `false` | [1.144](https://code.visualstudio.com/updates/v1_144) |\n| 組織の既定値 | モデルや権限レベルの組織既定が、記憶された選択より優先される | 新しいチャットの初期設定が変わる場合は組織ポリシーを確認 | [1.144](https://code.visualstudio.com/updates/v1_144) |\n| 権限の確認 | 広い許可から、ドメイン・コマンド・ディレクトリ単位へ | 確認ダイアログが増えた場合の理由として | [1.146](https://code.visualstudio.com/updates/v1_146) |\n\n## 試してみたい機能\n\nここでは公式ノートの内容を紹介します。実機では確認していません。\n\n- **`files.exclude` の `!` 例外**：Explorer を整理している人向けです。設定の書き方は [1.145 のノート](https://code.visualstudio.com/updates/v1_145)で確認できます。\n- **モデル比較**：同じ依頼を複数のモデル・harness で試せます。Agents ウィンドウで `sessions.chat.compareAgents.enabled` を確認します。\n- **サンドボックスの環境変数の隠蔽**：`chat.agent.sandbox.credentials.envVars` に、エージェントに見せたくない環境変数を指定します。\n\n## まとめ\n\n- 対象期間は 1.143 から 1.146 で、10月15日から11月17日までに Stable で公開されたものです。\n- Copilot harness が新規セッションの既定になり、Local harness は2027年2月に削除される予定です。\n- モデルの比較、複数 harness の混在、クラウドセッション、Automations など、エージェントの使い方が広がりました。\n- `files.exclude` の例外指定や Markdown・Mermaid の改善など、日常の編集に関わる変更もあります。\n- パッチは 1.143.1、1.144.1、1.145.1 から 1.145.3 を公式ノートで確認でき、1.145.3 がセキュリティ対応です。\n- Local 向けのカスタムエージェント、組織ポリシー、権限確認の変化は、更新前後で見比べておきたい部分です。\n\n次回は11月18日以降を対象にする予定です。\n気になる変更は、各項目の公式ノートと[リリースノート一覧](https://code.visualstudio.com/updates/archive)で条件を確認してみましょう。\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T03:08:33+09:00","group":null,"id":"01ecf487d3047870062d","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"VSCode","versions":[]},{"name":"GitHubCopilot","versions":[]},{"name":"開発環境","versions":[]},{"name":"エディタ","versions":[]},{"name":"AI","versions":[]}],"title":"VS Codeの更新を月1回振り返る[第2回：2026年10月15日から11月17日まで]","updated_at":"2026-11-18T03:08:33+09:00","url":"https://qiita.com/pmc-ko/items/01ecf487d3047870062d","user":{"description":"VehicleVisionという移動体(主に自動車)管理のためのパッケージの開発をしています。画像解析用の撮影光源の設計・開発やプリザンターのコントリビュータもやっています。","facebook_id":"","followees_count":35,"followers_count":16,"github_login_name":"pmc-ko","id":"pmc-ko","items_count":221,"linkedin_id":"","location":"","name":"K Ohtsuka","organization":"株式会社ピー・エム・シー","permanent_id":3555395,"profile_image_url":"https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3555395/profile-images/1773886383","team_only":false,"twitter_screen_name":null,"website_url":"https://github.com/pmc-ko"},"page_views_count":null,"team_membership":null,"organization_url_name":"vehiclevisionjp","slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003ch1 data-sourcepos=\"1:1-1:14\"\u003e\n\u003cspan id=\"検証環境\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%A4%9C%E8%A8%BC%E7%92%B0%E5%A2%83\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e検証環境\u003c/h1\u003e\n\u003cul data-sourcepos=\"3:1-7:0\"\u003e\n\u003cli data-sourcepos=\"3:1-3:30\"\u003e.NET SDK 11.0.100（C# 15）\u003c/li\u003e\n\u003cli data-sourcepos=\"4:1-4:52\"\u003eWindows 11（x64）、13th Gen Intel Core i7-1360P\u003c/li\u003e\n\u003cli data-sourcepos=\"5:1-5:27\"\u003eILSpy（ilspycmd）11.2.0\u003c/li\u003e\n\u003cli data-sourcepos=\"6:1-7:0\"\u003eBenchmarkDotNet 0.15.8\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch1 data-sourcepos=\"8:1-8:46\"\u003e\n\u003cspan id=\"はじめにunion型の簡単な紹介\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%AF%E3%81%98%E3%82%81%E3%81%ABunion%E5%9E%8B%E3%81%AE%E7%B0%A1%E5%8D%98%E3%81%AA%E7%B4%B9%E4%BB%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eはじめに（union型の簡単な紹介）\u003c/h1\u003e\n\u003cp data-sourcepos=\"9:1-9:65\"\u003e.NET 11(C# 15)で、C# が union型をサポートしました。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"11:1-13:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"n\"\u003eunion\u003c/span\u003e \u003cspan class=\"nf\"\u003eIntOrDecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003eint\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"15:1-16:56\"\u003e上記のように定義すると、「\u003ccode\u003eint\u003c/code\u003e か \u003ccode\u003edecimal\u003c/code\u003e のどちらかを表す型」を作れます。\u003cbr\u003e\n下記のように switch 式でも記述できます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"18:1-27:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e \u003cspan class=\"n\"\u003ea\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"m\"\u003e12\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e \u003cspan class=\"n\"\u003eb\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"m\"\u003e1.23m\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\n\u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e \u003cspan class=\"nf\"\u003eToDecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e \u003cspan class=\"n\"\u003eu\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003eu\u003c/span\u003e \u003cspan class=\"k\"\u003eswitch\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"kt\"\u003eint\u003c/span\u003e \u003cspan class=\"n\"\u003ei\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\u003cspan class=\"n\"\u003ei\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"c1\"\u003e// キャストを書かなくても暗黙変換されるが、意図の明確化の為にキャスト\u003c/span\u003e\n    \u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e \u003cspan class=\"n\"\u003ed\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003ed\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e     \u003cspan class=\"c1\"\u003e// 中身がdecimalならそのまま返す\u003c/span\u003e\n\u003cspan class=\"p\"\u003e};\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"29:1-29:121\"\u003eここで、\u003ccode\u003edecimal\u003c/code\u003e 型の分岐を書き忘れると、ちゃんと警告してくれます（ありがたい！）。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"31:1-36:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e \u003cspan class=\"nf\"\u003eToDecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e \u003cspan class=\"n\"\u003eu\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003eu\u003c/span\u003e \u003cspan class=\"k\"\u003eswitch\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"kt\"\u003eint\u003c/span\u003e \u003cspan class=\"n\"\u003ei\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\u003cspan class=\"n\"\u003ei\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \n\u003cspan class=\"p\"\u003e};\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"38:1-40:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003ewarning CS8509: この switch 式では入力型の可能な値がすべて扱われるわけではありません (すべてが網羅されているわけではありません)。たとえば、パターン 'decimal' がカバーされていません。\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"42:1-43:63\"\u003eこの記事では、C# の union 型がどのような挙動をするのか、ILSpyで覗いたり、いろいろ試して実験してみたいと思います。\u003cbr\u003e\n（思いつくままなので、網羅的ではないです）\u003c/p\u003e\n\u003cp data-sourcepos=\"45:1-45:226\"\u003e尚、この記事では分かりやすさの為に \u003ccode\u003eint\u003c/code\u003e と \u003ccode\u003edecimal\u003c/code\u003e の union 型を作っていますが、もちろん \u003ccode\u003eclass\u003c/code\u003e や \u003ccode\u003estruct\u003c/code\u003e、\u003ccode\u003erecord\u003c/code\u003e 型なんかでも自由に組み合わせることができます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"47:1-49:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"n\"\u003eunion\u003c/span\u003e \u003cspan class=\"n\"\u003eResult\u003c/span\u003e\u003cspan class=\"p\"\u003e\u0026lt;\u003c/span\u003e\u003cspan class=\"n\"\u003eT\u003c/span\u003e\u003cspan class=\"p\"\u003e\u0026gt;(\u003c/span\u003e\u003cspan class=\"n\"\u003eT\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003eError\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003ch1 data-sourcepos=\"51:1-51:47\"\u003e\n\u003cspan id=\"union-は内部でどう表現されるのか\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#union-%E3%81%AF%E5%86%85%E9%83%A8%E3%81%A7%E3%81%A9%E3%81%86%E8%A1%A8%E7%8F%BE%E3%81%95%E3%82%8C%E3%82%8B%E3%81%AE%E3%81%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eunion は内部でどう表現されるのか\u003c/h1\u003e\n\u003cp data-sourcepos=\"53:1-53:109\"\u003eC# 15の仕様書には、union 宣言は次のような struct に変換されると書かれています。\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"55:1-60:48\"\u003e\n\u003cp data-sourcepos=\"55:3-55:61\"\u003eA union declaration is lowered to a struct declaration with\u003c/p\u003e\n\u003cul data-sourcepos=\"56:3-60:48\"\u003e\n\u003cli data-sourcepos=\"56:3-56:74\"\u003ethe same attributes, modifiers, name, type parameters and constraints,\u003c/li\u003e\n\u003cli data-sourcepos=\"57:3-57:41\"\u003eimplicit implementations of \u003ccode\u003eIUnion\u003c/code\u003e,\u003c/li\u003e\n\u003cli data-sourcepos=\"58:3-58:52\"\u003ea \u003ccode\u003epublic object? Value { get; }\u003c/code\u003e auto-property,\u003c/li\u003e\n\u003cli data-sourcepos=\"59:3-59:54\"\u003ea public constructor for each of the \u003cem\u003ecase_types\u003c/em\u003e,\u003c/li\u003e\n\u003cli data-sourcepos=\"60:3-60:48\"\u003eany members in the union declaration's body.\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"62:1-62:151\"\u003e出典：\u003ca href=\"https://learn.microsoft.com/dotnet/csharp/language-reference/proposals/csharp-15.0/unions#lowering\" rel=\"nofollow noopener\" target=\"_blank\"\u003eUnions（C# 15 機能仕様）- Lowering\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"64:1-64:15\"\u003e日本語訳：\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"65:1-70:88\"\u003e\n\u003cp data-sourcepos=\"65:3-65:91\"\u003eunion 宣言は、次のような struct 宣言に落とし込まれます。つまり、\u003c/p\u003e\n\u003cul data-sourcepos=\"66:3-70:88\"\u003e\n\u003cli data-sourcepos=\"66:3-66:79\"\u003e同じ属性、修飾子、名前、型パラメータ、制約を持ち、\u003c/li\u003e\n\u003cli data-sourcepos=\"67:3-67:46\"\u003e\n\u003ccode\u003eIUnion\u003c/code\u003e の暗黙的な実装を持ち、\u003c/li\u003e\n\u003cli data-sourcepos=\"68:3-68:72\"\u003e\n\u003ccode\u003epublic object? Value { get; }\u003c/code\u003e の自動プロパティを持ち、\u003c/li\u003e\n\u003cli data-sourcepos=\"69:3-69:74\"\u003e各 \u003cem\u003ecase_types\u003c/em\u003e に対する public コンストラクタを持ち、\u003c/li\u003e\n\u003cli data-sourcepos=\"70:3-70:88\"\u003eunion 宣言の本体に含まれるメンバーを持つ、というものです。\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/blockquote\u003e\n\u003ch2 data-sourcepos=\"73:1-73:29\"\u003e\n\u003cspan id=\"ilspyで逆コンパイル\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#ilspy%E3%81%A7%E9%80%86%E3%82%B3%E3%83%B3%E3%83%91%E3%82%A4%E3%83%AB\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eILSpyで逆コンパイル\u003c/h2\u003e\n\u003cp data-sourcepos=\"75:1-75:148\"\u003eさきほど定義した \u003ccode\u003eIntOrDecimal\u003c/code\u003e 型は、どのようにコンパイルされるのか ILSpyの逆コンパイルで確認してみます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"77:1-95:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"p\"\u003e[\u003c/span\u003e\u003cspan class=\"n\"\u003eUnion\u003c/span\u003e\u003cspan class=\"p\"\u003e]\u003c/span\u003e\n\u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"k\"\u003estruct\u003c/span\u003e \u003cspan class=\"nc\"\u003eIntOrDecimal\u003c/span\u003e \u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003eIUnion\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"kt\"\u003eobject\u003c/span\u003e\u003cspan class=\"p\"\u003e?\u003c/span\u003e \u003cspan class=\"n\"\u003eValue\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e \u003cspan class=\"k\"\u003eget\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\n    \u003cspan class=\"p\"\u003e[\u003c/span\u003e\u003cspan class=\"n\"\u003eCompilerGenerated\u003c/span\u003e\u003cspan class=\"p\"\u003e]\u003c/span\u003e\n    \u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"nf\"\u003eIntOrDecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003eint\u003c/span\u003e \u003cspan class=\"k\"\u003evalue\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n        \u003cspan class=\"n\"\u003eValue\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"k\"\u003evalue\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\n    \u003cspan class=\"p\"\u003e[\u003c/span\u003e\u003cspan class=\"n\"\u003eCompilerGenerated\u003c/span\u003e\u003cspan class=\"p\"\u003e]\u003c/span\u003e\n    \u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"nf\"\u003eIntOrDecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e \u003cspan class=\"k\"\u003evalue\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n        \u003cspan class=\"n\"\u003eValue\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"k\"\u003evalue\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"97:1-97:158\"\u003eつまり、「いろんな型を保持できる」というのは、実際には \u003ccode\u003eobject?\u003c/code\u003e 型として保持されているだけ、ということです。\u003c/p\u003e\n\u003cp data-sourcepos=\"99:1-100:110\"\u003e他、\u003ccode\u003eUnionAttribute\u003c/code\u003e が付いていたり、\u003ccode\u003eIUnion\u003c/code\u003e を実装していたりという形式になっています。\u003cbr\u003e\n\u003ccode\u003eIUnion\u003c/code\u003e は次のように \u003ccode\u003eobject? Value\u003c/code\u003e プロパティだけを持つインターフェイスでした。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"102:1-107:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"k\"\u003einterface\u003c/span\u003e \u003cspan class=\"nc\"\u003eIUnion\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"kt\"\u003eobject\u003c/span\u003e\u003cspan class=\"p\"\u003e?\u003c/span\u003e \u003cspan class=\"n\"\u003eValue\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e \u003cspan class=\"k\"\u003eget\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003ch2 data-sourcepos=\"109:1-109:38\"\u003e\n\u003cspan id=\"unsafesizeof-でサイズを確認\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#unsafesizeof-%E3%81%A7%E3%82%B5%E3%82%A4%E3%82%BA%E3%82%92%E7%A2%BA%E8%AA%8D\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eUnsafe.SizeOf でサイズを確認\u003c/h2\u003e\n\u003cp data-sourcepos=\"111:1-112:117\"\u003e\u003ccode\u003eUnsafe.SizeOf\u0026lt;T\u0026gt;()\u003c/code\u003e で \u003ccode\u003eIntOrDecimal\u003c/code\u003e のサイズを測ると、8バイトでした。\u003cbr\u003e\nこれは、\u003ccode\u003eobject\u003c/code\u003e 型が示す参照（ポインタ）1つ分のサイズです（64ビット環境の場合）。\u003c/p\u003e\n\u003cp data-sourcepos=\"114:1-114:146\"\u003e参照の先にあるオブジェクト（\u003ccode\u003eint\u003c/code\u003e や \u003ccode\u003edecimal\u003c/code\u003e の値が入った実体）のサイズは含まれていない事に注意です。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"117:1-117:15\"\u003e\n\u003cspan id=\"union-変換\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#union-%E5%A4%89%E6%8F%9B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eunion 変換\u003c/h2\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"119:1-121:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e \u003cspan class=\"n\"\u003ex\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"m\"\u003e12\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"123:1-124:147\"\u003e上記のような代入（union 変換）は、内部でどのように変換されるのでしょうか。\u003cbr\u003e\n引数で受け取った \u003ccode\u003eint\u003c/code\u003e をそのまま \u003ccode\u003eIntOrDecimal\u003c/code\u003e として返すだけの、次のメソッドを用意して IL を見てみます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"126:1-128:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"k\"\u003estatic\u003c/span\u003e \u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e \u003cspan class=\"nf\"\u003eCreateGenerated\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003eint\u003c/span\u003e \u003cspan class=\"n\"\u003ex\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003ex\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e   \u003cspan class=\"c1\"\u003e// int → IntOrDecimal の union 変換\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"130:1-130:104\"\u003eILで見ると次のようになっていました（\u003ccode\u003eldarg.0\u003c/code\u003e は引数 \u003ccode\u003ex\u003c/code\u003e の読み込みです）。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"132:1-137:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e// IntOrDecimal CreateGenerated(int x) の IL\n  IL_0000: ldarg.0\n  IL_0001: newobj         IntOrDecimal::.ctor(int)\n  IL_0006: ret\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"139:1-139:304\"\u003e\u003ccode\u003eIntOrDecimal(int value)\u003c/code\u003e のコンストラクタ呼び出しになっています。\u003ccode\u003eIntOrDecimal\u003c/code\u003e に \u003ccode\u003eimplicit operator\u003c/code\u003e（\u003ccode\u003eop_Implicit\u003c/code\u003e メソッド）が生成されているわけではなく、コンパイラが union 変換をコンストラクタ呼び出しに直接置き換えています。\u003c/p\u003e\n\u003cp data-sourcepos=\"141:1-141:84\"\u003e仕様書では、union 変換について次のように説明されています。\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"143:1-144:156\"\u003e\n\u003cp data-sourcepos=\"143:3-144:156\"\u003eA union conversion is executed by calling the union's creation member（中略）\u003cbr\u003e\nUnion conversion is just another \"form\" of an implicit user-defined conversion. An applicable user-defined conversion operator \"shadows\" union conversion.\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"146:1-146:169\"\u003e出典：\u003ca href=\"https://learn.microsoft.com/dotnet/csharp/language-reference/proposals/csharp-15.0/unions#union-conversions\" rel=\"nofollow noopener\" target=\"_blank\"\u003eUnions（C# 15 機能仕様）- Union conversions\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"148:1-148:30\"\u003e日本語訳（筆者訳）：\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"149:1-150:230\"\u003e\n\u003cp data-sourcepos=\"149:3-150:230\"\u003eunion 変換は、union の作成メンバー（コンストラクタ）を呼び出すことで実行される。（中略）\u003cbr\u003e\nunion 変換は、ユーザー定義の暗黙変換の一つの「形」にすぎない。適用できるユーザー定義の変換演算子があれば、union 変換はそれに隠される（そちらが優先される）。\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"152:1-152:327\"\u003eつまり、分類上はユーザー定義の暗黙変換の仲間ですが、自分で \u003ccode\u003eimplicit operator\u003c/code\u003e を書かなくても、コンパイラが用意したコンストラクタが使われるということです。同じ型への \u003ccode\u003eimplicit operator\u003c/code\u003e を自分で定義した場合は、そちらが優先されます。\u003c/p\u003e\n\u003cp data-sourcepos=\"154:1-154:208\"\u003eこのコンストラクタは、冒頭で引用した仕様書の lowering の説明（\"a public constructor for each of the \u003cem\u003ecase_types\u003c/em\u003e\"）のとおり、コンパイラが自動生成したものです。\u003c/p\u003e\n\u003cp data-sourcepos=\"156:1-156:83\"\u003eそして、そのコンストラクタをILで見るとこうなっています。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"158:1-165:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e// IntOrDecimal::.ctor(int)\n  IL_0000: ldarg.0\n  IL_0001: ldarg.1\n  IL_0002: box            int        ← ここで boxing されている\n  IL_0007: stfld          object IntOrDecimal::\u0026lt;Value\u0026gt;k__BackingField\n  IL_000c: ret\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"167:1-168:159\"\u003e\u003ccode\u003eint\u003c/code\u003e から \u003ccode\u003eobject\u003c/code\u003e への代入なので、当然ながら boxing されています。\u003cbr\u003e\nboxing されるということはメモリがスタックではなくヒープに確保されるということであり、当然GCの影響も受けます。\u003c/p\u003e\n\u003cp data-sourcepos=\"170:1-171:172\"\u003eここは、union 型の定義の形 \u003ccode\u003eunion IntOrDecimal(int, decimal)\u003c/code\u003e からはあまり想像がつかない点で、内部で \u003ccode\u003eobject?\u003c/code\u003e として表現されていると知っていれば自ずと想像が付きますが、知らないと boxing されるとはあまり思わない気がします。\u003cbr\u003e\nこの、union のケース型が値型（\u003ccode\u003eint\u003c/code\u003e や \u003ccode\u003edecimal\u003c/code\u003e、struct など）の場合に boxing されるという点は、だいぶ注意が必要だと思います。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"173:1-173:40\"\u003e\n\u003cspan id=\"switch-式による値の取り出し\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#switch-%E5%BC%8F%E3%81%AB%E3%82%88%E3%82%8B%E5%80%A4%E3%81%AE%E5%8F%96%E3%82%8A%E5%87%BA%E3%81%97\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eswitch 式による値の取り出し\u003c/h2\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"175:1-184:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"c1\"\u003e// switch 式で中身を取り出す\u003c/span\u003e\n\u003cspan class=\"p\"\u003e[\u003c/span\u003e\u003cspan class=\"nf\"\u003eMethodImpl\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eMethodImplOptions\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eNoInlining\u003c/span\u003e\u003cspan class=\"p\"\u003e)]\u003c/span\u003e\n\u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"k\"\u003estatic\u003c/span\u003e \u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e \u003cspan class=\"nf\"\u003eToDecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e \u003cspan class=\"n\"\u003eu\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003eu\u003c/span\u003e \u003cspan class=\"k\"\u003eswitch\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"kt\"\u003eint\u003c/span\u003e \u003cspan class=\"n\"\u003ei\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\u003cspan class=\"n\"\u003ei\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e \u003cspan class=\"n\"\u003ed\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003ed\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"k\"\u003enull\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"m\"\u003e0m\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e   \u003cspan class=\"c1\"\u003e// default のとき（後述）\u003c/span\u003e\n\u003cspan class=\"p\"\u003e};\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"186:1-186:104\"\u003e上記のようなテスト用のメソッドを作り、コンパイル結果をILで見てみます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"188:1-209:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e  IL_0000: ldarga.s       0\n  IL_0002: call           object IntOrDecimal::get_Value()   ← 中身を object で取得\n  IL_0007: stloc.3\n  IL_0008: ldloc.3\n  IL_0009: isinst         int                                ← int か？\n  IL_000e: brfalse.s      IL_0019\n  IL_0010: ldloc.3\n  IL_0011: unbox.any      int                                ← unboxing\n  IL_0016: stloc.0\n  IL_0017: br.s           IL_002f\n  IL_0019: ldloc.3\n  IL_001a: isinst         decimal                            ← decimal か？\n  IL_001f: brfalse.s      IL_002a\n  IL_0021: ldloc.3\n  IL_0022: unbox.any      decimal                            ← unboxing\n  IL_0027: stloc.1\n  IL_0028: br.s           IL_0038\n  IL_002a: ldloc.3\n  IL_002b: brfalse.s      IL_003c                            ← null か？\n  ...\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"211:1-211:158\"\u003eつまり、中身を \u003ccode\u003eobject\u003c/code\u003e として取り出し、その型が \u003ccode\u003eint\u003c/code\u003e か \u003ccode\u003edecimal\u003c/code\u003e なら unboxing して返す、という流れになっています。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"214:1-214:36\"\u003e\n\u003cspan id=\"アロケーション量を計測\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%A2%E3%83%AD%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E9%87%8F%E3%82%92%E8%A8%88%E6%B8%AC\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eアロケーション量を計測\u003c/h2\u003e\n\u003cp data-sourcepos=\"216:1-216:135\"\u003e\u003ccode\u003eGC.GetAllocatedBytesForCurrentThread()\u003c/code\u003e で1回あたりのアロケーション量を測ると、以下のようになりました。\u003c/p\u003e\n\u003cul data-sourcepos=\"218:1-221:0\"\u003e\n\u003cli data-sourcepos=\"218:1-218:28\"\u003e(1) 生成(int) : 24 bytes\u003c/li\u003e\n\u003cli data-sourcepos=\"219:1-219:32\"\u003e(2) 生成(decimal) : 32 bytes\u003c/li\u003e\n\u003cli data-sourcepos=\"220:1-221:0\"\u003e(3) switch で取り出し : 0 bytes\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"222:1-222:154\"\u003e64ビット環境では、boxing されたオブジェクトのサイズは次の式で計算したあと、8バイト境界に切り上げられます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"224:1-226:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003eオブジェクトヘッダ（8バイト） + メソッドテーブルへのポインタ（8バイト） + 値\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"228:1-228:159\"\u003e\u003ccode\u003eint\u003c/code\u003e だと 8 + 8 + 4 = 20 で 24バイトへ切り上げられ、\u003ccode\u003edecimal\u003c/code\u003e だと 8 + 8 + 16 = 32バイトとなり、計測値と同じになりました。\u003c/p\u003e\n\u003cp data-sourcepos=\"230:1-230:274\"\u003e本来 \u003ccode\u003eint\u003c/code\u003e 1つなら 4バイトで済むところを、boxing のせいで 24バイトのヒープ領域が確保される上に GC の回収対象にもなるということで、大量に union を作るケースだと無視できないコストになりそうです。\u003c/p\u003e\n\u003cp data-sourcepos=\"232:1-232:163\"\u003eswitchでの値の取り出しは、前述の通り unboxing されているだけでメモリアロケーションはないので、この結果も納得です。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"234:1-234:126\"\u003e\n\u003cspan id=\"余談union宣言に-int-と-decimal-のフィールドを足してごにょごにょできないの--できない\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BD%99%E8%AB%87union%E5%AE%A3%E8%A8%80%E3%81%AB-int-%E3%81%A8-decimal-%E3%81%AE%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%82%92%E8%B6%B3%E3%81%97%E3%81%A6%E3%81%94%E3%81%AB%E3%82%87%E3%81%94%E3%81%AB%E3%82%87%E3%81%A7%E3%81%8D%E3%81%AA%E3%81%84%E3%81%AE--%E3%81%A7%E3%81%8D%E3%81%AA%E3%81%84\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e余談：union宣言に int と decimal のフィールドを足してごにょごにょできないの？ → できない\u003c/h2\u003e\n\u003cp data-sourcepos=\"236:1-236:106\"\u003eこんな風に宣言して、boxing を回避できないかなぁと思いましたがダメでした。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"238:1-243:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"n\"\u003eunion\u003c/span\u003e \u003cspan class=\"nf\"\u003eIntOrDecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003eint\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eprivate\u003c/span\u003e \u003cspan class=\"k\"\u003ereadonly\u003c/span\u003e \u003cspan class=\"kt\"\u003eint\u003c/span\u003e \u003cspan class=\"n\"\u003e_int\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e   \u003cspan class=\"c1\"\u003e// error CS9373\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"245:1-247:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003eerror CS9373: インスタンス フィールド、自動プロパティ、またはフィールドに似たイベントは、'union' 宣言では許可されません。\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"249:1-249:91\"\u003eそういう風に使いたい場合は、後述するカスタム union を使います。\u003c/p\u003e\n\u003ch1 data-sourcepos=\"251:1-251:47\"\u003e\n\u003cspan id=\"default-を代入すると-null-が入る\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#default-%E3%82%92%E4%BB%A3%E5%85%A5%E3%81%99%E3%82%8B%E3%81%A8-null-%E3%81%8C%E5%85%A5%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e\u003ccode\u003edefault\u003c/code\u003e を代入すると \u003ccode\u003enull\u003c/code\u003e が入る\u003c/h1\u003e\n\u003cp data-sourcepos=\"253:1-253:133\"\u003e私はちょっと驚いたのですが、union には \u003ccode\u003edefault\u003c/code\u003e が代入できて、その場合中身は \u003ccode\u003enull\u003c/code\u003e になります。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"255:1-259:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e \u003cspan class=\"n\"\u003ea\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"k\"\u003edefault\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e \u003cspan class=\"c1\"\u003e// 中身（Value）が null になる\u003c/span\u003e\n\u003cspan class=\"kt\"\u003ebool\u003c/span\u003e \u003cspan class=\"n\"\u003eb1\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003ea\u003c/span\u003e \u003cspan class=\"k\"\u003eis\u003c/span\u003e \u003cspan class=\"k\"\u003enull\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e \u003cspan class=\"c1\"\u003e// true\u003c/span\u003e\n\u003cspan class=\"kt\"\u003ebool\u003c/span\u003e \u003cspan class=\"n\"\u003eb2\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003eobject\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\u003cspan class=\"n\"\u003ea\u003c/span\u003e \u003cspan class=\"k\"\u003eis\u003c/span\u003e \u003cspan class=\"k\"\u003enull\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e \u003cspan class=\"c1\"\u003e// false（union自体は null じゃない）\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"261:1-261:171\"\u003eただの struct でも \u003ccode\u003edefault\u003c/code\u003e が代入できましたが、結果はそれぞれのフィールドが \u003ccode\u003e0\u003c/code\u003e や \u003ccode\u003efalse\u003c/code\u003e、\u003ccode\u003enull\u003c/code\u003e にクリアされるだけでした。\u003c/p\u003e\n\u003cp data-sourcepos=\"263:1-263:168\"\u003eでも考えてみると、\u003ccode\u003eobject?\u003c/code\u003e を持つ struct として union が定義されているなら、当然それは \u003ccode\u003enull\u003c/code\u003e になるという事なんでしょう。\u003c/p\u003e\n\u003cp data-sourcepos=\"265:1-265:131\"\u003eしかしそのせいで、別に \u003ccode\u003enullable\u003c/code\u003e ではないのに \u003ccode\u003enull\u003c/code\u003e である可能性を考慮する必要が出てきます。\u003c/p\u003e\n\u003cp data-sourcepos=\"267:1-267:89\"\u003eその一方で、\u003ccode\u003eIntOrDecimal\u003c/code\u003e には \u003ccode\u003enull\u003c/code\u003e を代入することはできません。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"269:1-271:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e \u003cspan class=\"n\"\u003ed\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"k\"\u003enull\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"273:1-275:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003eerror CS0037: Null 非許容の値型であるため、Null を 'IntOrDecimal' に変換できません\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"277:1-277:185\"\u003eもちろん、ケース型に \u003ccode\u003eint?\u003c/code\u003e を含む union（例：\u003ccode\u003eunion NullableIntOrDecimal(int?, decimal);\u003c/code\u003e）なら、\u003ccode\u003e= null\u003c/code\u003e は union変換になり、\u003ccode\u003enull\u003c/code\u003e を代入できます。\u003c/p\u003e\n\u003cp data-sourcepos=\"279:1-279:267\"\u003eまた、\u003ccode\u003eIntOrDecimal?\u003c/code\u003e にも \u003ccode\u003enull\u003c/code\u003e を代入できます。ただし、これは union 変換ではありません。\u003ccode\u003eIntOrDecimal?\u003c/code\u003e は \u003ccode\u003eNullable\u0026lt;IntOrDecimal\u0026gt;\u003c/code\u003e という別の型で、\u003ccode\u003enull\u003c/code\u003e を代入できるのは Nullable の仕組みによるものです。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"281:1-284:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e?\u003c/span\u003e \u003cspan class=\"n\"\u003en\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"k\"\u003enull\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e   \u003cspan class=\"c1\"\u003e// OK：Nullable の null（union の値そのものが無い）\u003c/span\u003e\n\u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e?\u003c/span\u003e \u003cspan class=\"n\"\u003em\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"m\"\u003e42\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e     \u003cspan class=\"c1\"\u003e// OK：union 変換したうえで Nullable に入る\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"286:1-286:141\"\u003e\u003ccode\u003eIntOrDecimal?\u003c/code\u003e の \u003ccode\u003enull\u003c/code\u003e は「union の値そのものが無い」状態で、前述の「中身が null の union」とは別物です。\u003c/p\u003e\n\u003cp data-sourcepos=\"288:1-288:54\"\u003e問題になるのは、\u003ccode\u003eswitch\u003c/code\u003e 式の場合です。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"290:1-296:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e \u003cspan class=\"nf\"\u003eToDecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e \u003cspan class=\"n\"\u003eu\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003eu\u003c/span\u003e \u003cspan class=\"k\"\u003eswitch\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"kt\"\u003eint\u003c/span\u003e \u003cspan class=\"n\"\u003ei\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\u003cspan class=\"n\"\u003ei\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e \u003cspan class=\"n\"\u003ed\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003ed\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n\u003cspan class=\"p\"\u003e};\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"298:1-299:45\"\u003e上記に \u003ccode\u003edefault\u003c/code\u003e を渡してもコンパイルエラーになりません。switch式に \u003ccode\u003enull\u003c/code\u003e の分岐がないことへの警告も出ません。\u003cbr\u003e\nしかし、実行時例外が起きます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"301:1-304:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003eSwitchExpressionException: Non-exhaustive switch expression failed to match its input.\nUnmatched value was IntOrDecimal.\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"306:1-306:72\"\u003eこれはなんか、どうにかして欲しい気がしますが…。\u003c/p\u003e\n\u003cp data-sourcepos=\"308:1-308:134\"\u003e中身が null の union は、\u003ccode\u003edefault\u003c/code\u003e を代入したときだけでなく、次のような場合にもできてしまいます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"310:1-319:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e \u003cspan class=\"n\"\u003ea\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"k\"\u003edefault\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e \u003cspan class=\"n\"\u003eb\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"k\"\u003enew\u003c/span\u003e \u003cspan class=\"nf\"\u003eIntOrDecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e();\u003c/span\u003e      \u003cspan class=\"c1\"\u003e// 引数なしのコンストラクタ\u003c/span\u003e\n\u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e[]\u003c/span\u003e \u003cspan class=\"n\"\u003ec\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"k\"\u003enew\u003c/span\u003e \u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e[\u003c/span\u003e\u003cspan class=\"m\"\u003e1\u003c/span\u003e\u003cspan class=\"p\"\u003e];\u003c/span\u003e   \u003cspan class=\"c1\"\u003e// 初期化していない配列の要素\u003c/span\u003e\n\n\u003cspan class=\"n\"\u003eConsole\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eWriteLine\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003ea\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eValue\u003c/span\u003e \u003cspan class=\"k\"\u003eis\u003c/span\u003e \u003cspan class=\"k\"\u003enull\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e       \u003cspan class=\"c1\"\u003e// True\u003c/span\u003e\n\u003cspan class=\"n\"\u003eConsole\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eWriteLine\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eb\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eValue\u003c/span\u003e \u003cspan class=\"k\"\u003eis\u003c/span\u003e \u003cspan class=\"k\"\u003enull\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e       \u003cspan class=\"c1\"\u003e// True\u003c/span\u003e\n\u003cspan class=\"n\"\u003eConsole\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eWriteLine\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003ec\u003c/span\u003e\u003cspan class=\"p\"\u003e[\u003c/span\u003e\u003cspan class=\"m\"\u003e0\u003c/span\u003e\u003cspan class=\"p\"\u003e].\u003c/span\u003e\u003cspan class=\"n\"\u003eValue\u003c/span\u003e \u003cspan class=\"k\"\u003eis\u003c/span\u003e \u003cspan class=\"k\"\u003enull\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e    \u003cspan class=\"c1\"\u003e// True\u003c/span\u003e\n\u003cspan class=\"n\"\u003eConsole\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eWriteLine\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003ea\u003c/span\u003e \u003cspan class=\"k\"\u003eis\u003c/span\u003e \u003cspan class=\"k\"\u003enull\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e             \u003cspan class=\"c1\"\u003e// True（null パターンは中身を調べる）\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"321:1-321:174\"\u003eクラスのフィールドで初期化していないものも同様です。実際のコードでは、これがいちばん踏みやすいケースかもしれません。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"323:1-328:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"k\"\u003eclass\u003c/span\u003e \u003cspan class=\"nc\"\u003eOrder\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eprivate\u003c/span\u003e \u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e \u003cspan class=\"n\"\u003e_amount\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e   \u003cspan class=\"c1\"\u003e// 初期化していないフィールドも default（中身が null）\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"330:1-330:152\"\u003e今のところは以下のように \u003ccode\u003enull\u003c/code\u003e の分岐も書いておくべきなんでしょうか（これなら実行時例外も起きません）。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"332:1-339:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e \u003cspan class=\"nf\"\u003eToDecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e \u003cspan class=\"n\"\u003eu\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003eu\u003c/span\u003e \u003cspan class=\"k\"\u003eswitch\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"kt\"\u003eint\u003c/span\u003e \u003cspan class=\"n\"\u003ei\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\u003cspan class=\"n\"\u003ei\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e \u003cspan class=\"n\"\u003ed\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003ed\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"k\"\u003enull\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"m\"\u003e0m\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e   \u003cspan class=\"c1\"\u003e// default のとき\u003c/span\u003e\n\u003cspan class=\"p\"\u003e};\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"341:1-341:136\"\u003eまたは、\u003ccode\u003enull\u003c/code\u003e なんて想定していない事を明示する為にも、ここは例外を投げるべきなんでしょうか。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"343:1-350:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e \u003cspan class=\"nf\"\u003eToDecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eIntOrDecimal\u003c/span\u003e \u003cspan class=\"n\"\u003eu\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003eu\u003c/span\u003e \u003cspan class=\"k\"\u003eswitch\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"kt\"\u003eint\u003c/span\u003e \u003cspan class=\"n\"\u003ei\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\u003cspan class=\"n\"\u003ei\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e \u003cspan class=\"n\"\u003ed\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003ed\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"k\"\u003enull\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"k\"\u003ethrow\u003c/span\u003e \u003cspan class=\"k\"\u003enew\u003c/span\u003e \u003cspan class=\"nf\"\u003eInvalidOperationException\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"s\"\u003e\"IntOrDecimal に値が入っていません\"\u003c/span\u003e\u003cspan class=\"p\"\u003e),\u003c/span\u003e   \u003cspan class=\"c1\"\u003e// default のとき\u003c/span\u003e\n\u003cspan class=\"p\"\u003e};\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"352:1-352:330\"\u003eもっとも、\u003ccode\u003enull\u003c/code\u003e の分岐が無い場合でも、\u003ccode\u003edefault\u003c/code\u003e が来れば結局 \u003ccode\u003eSwitchExpressionException\u003c/code\u003e が投げられます。明示的に \u003ccode\u003ethrow\u003c/code\u003e を書く利点は、「null を想定していない」という意図がコードに残ることと、例外の種類やメッセージを自分で選べることです。\u003c/p\u003e\n\u003ch1 data-sourcepos=\"355:1-355:56\"\u003e\n\u003cspan id=\"カスタム-union-型で-boxing-を回避する方法\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%AB%E3%82%B9%E3%82%BF%E3%83%A0-union-%E5%9E%8B%E3%81%A7-boxing-%E3%82%92%E5%9B%9E%E9%81%BF%E3%81%99%E3%82%8B%E6%96%B9%E6%B3%95\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eカスタム union 型で boxing を回避する方法\u003c/h1\u003e\n\u003cp data-sourcepos=\"357:1-357:107\"\u003eカスタムの union 型を自分で定義することで、boxing を回避する方法があります。\u003c/p\u003e\n\u003cp data-sourcepos=\"359:1-359:58\"\u003eその前に、まず union 型の条件を挙げます。\u003c/p\u003e\n\u003cul data-sourcepos=\"361:1-364:0\"\u003e\n\u003cli data-sourcepos=\"361:1-361:68\"\u003e\n\u003ccode\u003e[System.Runtime.CompilerServices.Union]\u003c/code\u003e 属性が付いている\u003c/li\u003e\n\u003cli data-sourcepos=\"362:1-362:99\"\u003e引数1つのpublicコンストラクタがある（その引数の型がケース型になる）\u003c/li\u003e\n\u003cli data-sourcepos=\"363:1-364:0\"\u003e\n\u003ccode\u003eobject?\u003c/code\u003e 又は \u003ccode\u003eobject\u003c/code\u003e 型の public な \u003ccode\u003eValue\u003c/code\u003e プロパティ（\u003ccode\u003eget\u003c/code\u003e アクセサ）がある\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"365:1-366:213\"\u003eこれさえ満たしていれば、その型は union として機能します。\u003cbr\u003e\n尚、\u003ccode\u003eIUnion\u003c/code\u003e はどうも必須ではないようで、なしでも union 変換や \u003ccode\u003eswitch\u003c/code\u003e は動作しました。とはいえ、基本的には \u003ccode\u003eIUnion\u003c/code\u003e も実装しておくべきだろうと思います。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"368:1-368:75\"\u003e\n\u003cspan id=\"非-boxing-アクセスパターンnon-boxing-union-access-pattern\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E9%9D%9E-boxing-%E3%82%A2%E3%82%AF%E3%82%BB%E3%82%B9%E3%83%91%E3%82%BF%E3%83%BC%E3%83%B3non-boxing-union-access-pattern\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e非 boxing アクセスパターン（non-boxing union access pattern）\u003c/h2\u003e\n\u003cp data-sourcepos=\"370:1-370:444\"\u003e上記の基本パターンに加えて次の2種類のメンバーを追加すると、コンパイラはパターンマッチングで \u003ccode\u003eValue\u003c/code\u003e プロパティを使わなくなります。これを 非 boxing アクセスパターンと呼びます。（出典：\u003ca href=\"https://learn.microsoft.com/dotnet/csharp/language-reference/proposals/csharp-15.0/unions#non-boxing-access-members\" rel=\"nofollow noopener\" target=\"_blank\"\u003eUnions（C# 15 機能仕様）- Non-boxing access members\u003c/a\u003e）\u003c/p\u003e\n\u003cul data-sourcepos=\"372:1-374:0\"\u003e\n\u003cli data-sourcepos=\"372:1-372:147\"\u003e\n\u003ccode\u003ebool HasValue { get; }\u003c/code\u003e : 中身が \u003ccode\u003enull\u003c/code\u003e でなければ \u003ccode\u003etrue\u003c/code\u003e （ \u003ccode\u003eu is null\u003c/code\u003e や \u003ccode\u003enull =\u0026gt;\u003c/code\u003e などの null パターンで利用される）\u003c/li\u003e\n\u003cli data-sourcepos=\"373:1-374:0\"\u003e\n\u003ccode\u003ebool TryGetValue(out T value)\u003c/code\u003e : 中身が \u003ccode\u003eT\u003c/code\u003e なら \u003ccode\u003etrue\u003c/code\u003e を返し、値を \u003ccode\u003eout\u003c/code\u003e で返す （\u003ccode\u003eu is int i\u003c/code\u003e や \u003ccode\u003eint i =\u0026gt;\u003c/code\u003e などの 型パターンで利用される）\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"375:1-375:85\"\u003eこれらを使って \u003ccode\u003eIntOrDecimal\u003c/code\u003e を定義しなおしたのがこちらです。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"377:1-411:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"p\"\u003e[\u003c/span\u003e\u003cspan class=\"n\"\u003eUnion\u003c/span\u003e\u003cspan class=\"p\"\u003e]\u003c/span\u003e\n\u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"k\"\u003ereadonly\u003c/span\u003e \u003cspan class=\"k\"\u003estruct\u003c/span\u003e \u003cspan class=\"nc\"\u003eIntOrDecimalNoBox\u003c/span\u003e \u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003eIUnion\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eprivate\u003c/span\u003e \u003cspan class=\"k\"\u003ereadonly\u003c/span\u003e \u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e \u003cspan class=\"n\"\u003e_decimal\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eprivate\u003c/span\u003e \u003cspan class=\"k\"\u003ereadonly\u003c/span\u003e \u003cspan class=\"kt\"\u003eint\u003c/span\u003e \u003cspan class=\"n\"\u003e_int\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eprivate\u003c/span\u003e \u003cspan class=\"k\"\u003ereadonly\u003c/span\u003e \u003cspan class=\"kt\"\u003ebyte\u003c/span\u003e \u003cspan class=\"n\"\u003e_tag\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e \u003cspan class=\"c1\"\u003e// 0 = 空, 1 = int, 2 = decimal\u003c/span\u003e\n\n    \u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"nf\"\u003eIntOrDecimalNoBox\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003eint\u003c/span\u003e \u003cspan class=\"k\"\u003evalue\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e \u003cspan class=\"n\"\u003e_int\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"k\"\u003evalue\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e \u003cspan class=\"n\"\u003e_tag\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"m\"\u003e1\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n    \u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"nf\"\u003eIntOrDecimalNoBox\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e \u003cspan class=\"k\"\u003evalue\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e \u003cspan class=\"n\"\u003e_decimal\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"k\"\u003evalue\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e \u003cspan class=\"n\"\u003e_tag\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"m\"\u003e2\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\n    \u003cspan class=\"c1\"\u003e// IUnion の要件。object を返すので、ここを呼ぶと boxing される\u003c/span\u003e\n    \u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"kt\"\u003eobject\u003c/span\u003e\u003cspan class=\"p\"\u003e?\u003c/span\u003e \u003cspan class=\"n\"\u003eValue\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003e_tag\u003c/span\u003e \u003cspan class=\"k\"\u003eswitch\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n        \u003cspan class=\"m\"\u003e1\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003e_int\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n        \u003cspan class=\"m\"\u003e2\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003e_decimal\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n        \u003cspan class=\"n\"\u003e_\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"k\"\u003enull\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e};\u003c/span\u003e\n\n    \u003cspan class=\"c1\"\u003e// --- 非 boxing アクセスパターン\u003c/span\u003e\n    \u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"kt\"\u003ebool\u003c/span\u003e \u003cspan class=\"n\"\u003eHasValue\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003e_tag\u003c/span\u003e \u003cspan class=\"p\"\u003e!=\u003c/span\u003e \u003cspan class=\"m\"\u003e0\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\n    \u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"kt\"\u003ebool\u003c/span\u003e \u003cspan class=\"nf\"\u003eTryGetValue\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"k\"\u003eout\u003c/span\u003e \u003cspan class=\"kt\"\u003eint\u003c/span\u003e \u003cspan class=\"k\"\u003evalue\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n        \u003cspan class=\"k\"\u003evalue\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003e_int\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n        \u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"n\"\u003e_tag\u003c/span\u003e \u003cspan class=\"p\"\u003e==\u003c/span\u003e \u003cspan class=\"m\"\u003e1\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\n    \u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"kt\"\u003ebool\u003c/span\u003e \u003cspan class=\"nf\"\u003eTryGetValue\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"k\"\u003eout\u003c/span\u003e \u003cspan class=\"kt\"\u003edecimal\u003c/span\u003e \u003cspan class=\"k\"\u003evalue\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n        \u003cspan class=\"k\"\u003evalue\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003e_decimal\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n        \u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"n\"\u003e_tag\u003c/span\u003e \u003cspan class=\"p\"\u003e==\u003c/span\u003e \u003cspan class=\"m\"\u003e2\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"413:1-413:104\"\u003e仕様書には、非 boxing アクセスパターンについて次のような注記があります。\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"415:1-415:331\"\u003e\n\u003cp data-sourcepos=\"415:3-415:331\"\u003e（前略）The user code can store the content any way it likes. In particular, it does not prevent the implementation from boxing! The \u003ccode\u003enon-boxing\u003c/code\u003e in its name refers to allowing the compiler's pattern matching implementation to access each case type in a strongly typed way, as opposed to the \u003ccode\u003eobject?\u003c/code\u003e-typed \u003ccode\u003eValue\u003c/code\u003e property.\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"417:1-417:181\"\u003e出典：\u003ca href=\"https://learn.microsoft.com/dotnet/csharp/language-reference/proposals/csharp-15.0/unions#examples-of-union-types\" rel=\"nofollow noopener\" target=\"_blank\"\u003eUnions（C# 15 機能仕様）- Examples of union types\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"419:1-419:30\"\u003e日本語訳（筆者訳）：\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"420:1-420:421\"\u003e\n\u003cp data-sourcepos=\"420:3-420:421\"\u003e中身をどのように格納するかは、ユーザーのコードが自由に決められる。特に、この仕組みは実装が boxing することを防ぐものではない！ 名前にある「非 boxing」とは、コンパイラのパターンマッチングの実装が、\u003ccode\u003eobject?\u003c/code\u003e 型の \u003ccode\u003eValue\u003c/code\u003e プロパティではなく、各ケース型に型付きでアクセスできることを指している。\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"422:1-422:202\"\u003eさすがに、内部で \u003ccode\u003eobject?\u003c/code\u003e で保持したまま boxing を回避するというのは無理筋で、ちゃんとそれぞれの型用のフィールドを定義してね、という事です。\u003c/p\u003e\n\u003cp data-sourcepos=\"424:1-424:174\"\u003e実際に \u003ccode\u003eIntOrDecimalNoBox x = 42;\u003c/code\u003e のような union変換がどう IL にコンパイルされるか、先ほどと同じように次のメソッドで見てみます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"426:1-428:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"k\"\u003estatic\u003c/span\u003e \u003cspan class=\"n\"\u003eIntOrDecimalNoBox\u003c/span\u003e \u003cspan class=\"nf\"\u003eCreateNoBox\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003eint\u003c/span\u003e \u003cspan class=\"n\"\u003ex\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003ex\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e   \u003cspan class=\"c1\"\u003e// int → IntOrDecimalNoBox の union 変換\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"430:1-435:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e// IntOrDecimalNoBox CreateNoBox(int x) の IL\n  IL_0000: ldarg.0\n  IL_0001: newobj         IntOrDecimalNoBox::.ctor(int)\n  IL_0006: ret\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"437:1-438:75\"\u003e代入自体は上記のように、コンストラクタ呼び出しです。\u003cbr\u003e\nそのコンストラクタの中身は次のようになっています。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"440:1-464:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e// IntOrDecimalNoBox::.ctor(int)\n  IL_0000: ldarg.0\n  IL_0001: ldflda         decimal IntOrDecimalNoBox::_decimal\n  IL_0006: initobj        decimal                          ← _decimal を既定値（0）で初期化\n  IL_000c: ldarg.0\n  IL_000d: ldarg.1\n  IL_000e: stfld          int IntOrDecimalNoBox::_int      ← int のまま int 型のフィールドに格納\n  IL_0013: ldarg.0\n  IL_0014: ldc.i4.1\n  IL_0015: stfld          byte IntOrDecimalNoBox::_tag     ← _tag = 1\n  IL_001a: ret\n\n// IntOrDecimalNoBox::.ctor(decimal)\n  IL_0000: ldarg.0\n  IL_0001: ldc.i4.0\n  IL_0002: stfld          int IntOrDecimalNoBox::_int      ← _int を既定値（0）で初期化\n  IL_0007: ldarg.0\n  IL_0008: ldarg.1\n  IL_0009: stfld          decimal IntOrDecimalNoBox::_decimal  ← decimal のまま decimal 型のフィールドに格納\n  IL_000e: ldarg.0\n  IL_000f: ldc.i4.2\n  IL_0010: stfld          byte IntOrDecimalNoBox::_tag     ← _tag = 2\n  IL_0015: ret\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"466:1-466:40\"\u003eboxing が無くなっていますね！\u003c/p\u003e\n\u003cp data-sourcepos=\"468:1-468:227\"\u003eちなみにサイズを確認すると、24 bytes でした。\u003ccode\u003edecimal\u003c/code\u003e (16バイト)、\u003ccode\u003eint\u003c/code\u003e （4バイト）、tag用の \u003ccode\u003ebyte\u003c/code\u003e （1バイト）で、境界で切り上げられて24バイト、ということでしょう。\u003c/p\u003e\n\u003cp data-sourcepos=\"470:1-470:181\"\u003eswitch式は、これまで \u003ccode\u003eget_Value\u003c/code\u003e や \u003ccode\u003eisinst\u003c/code\u003e、\u003ccode\u003eunbox.any\u003c/code\u003e だった場所が以下のように \u003ccode\u003eTryGetValue\u003c/code\u003e と \u003ccode\u003eHasValue\u003c/code\u003e 呼び出しに置き換えられています。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"472:1-494:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e//   local [3] int\n//   local [4] decimal\n  IL_0000: ldarga.s       0\n  IL_0002: ldloca.s       3\n  IL_0004: call           bool IntOrDecimalNoBox::TryGetValue(int\u0026amp;)       ← int i =\u0026gt; ...\n  IL_0009: brfalse.s      IL_000f\n  IL_000b: ldloc.3\n  IL_000c: stloc.0\n  IL_000d: br.s           IL_002a\n  IL_000f: ldarga.s       0\n  IL_0011: ldloca.s       4\n  IL_0013: call           bool IntOrDecimalNoBox::TryGetValue(decimal\u0026amp;)   ← decimal d =\u0026gt; ...\n  IL_0018: brfalse.s      IL_001f\n  IL_001a: ldloc.s        4\n  IL_001c: stloc.1\n  IL_001d: br.s           IL_0033\n  IL_001f: ldarga.s       0\n  IL_0021: call           bool IntOrDecimalNoBox::get_HasValue()          ← null =\u0026gt; ...\n  IL_0026: brfalse.s      IL_0037\n  IL_0028: br.s           IL_003f\n  ...\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"496:1-497:86\"\u003e同様の方法でアロケーション量を測りましたが、全て 0 bytes となりました。\u003cbr\u003e\n（もちろん、\u003ccode\u003e.Value\u003c/code\u003e を直接呼び出せば boxing されてしまいます）\u003c/p\u003e\n\u003ch2 data-sourcepos=\"499:1-499:75\"\u003e\n\u003cspan id=\"余談カスタム-union-ではdefault-を-null-以外にできる\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BD%99%E8%AB%87%E3%82%AB%E3%82%B9%E3%82%BF%E3%83%A0-union-%E3%81%A7%E3%81%AFdefault-%E3%82%92-null-%E4%BB%A5%E5%A4%96%E3%81%AB%E3%81%A7%E3%81%8D%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e余談：カスタム union では、default を null 以外にできる\u003c/h2\u003e\n\u003cp data-sourcepos=\"501:1-501:57\"\u003e公式ドキュメントに次のようにあります。\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"503:1-503:243\"\u003e\n\u003cp data-sourcepos=\"503:3-503:243\"\u003e\u003cstrong\u003eSoundness\u003c/strong\u003e: \u003ccode\u003eValue\u003c/code\u003e always returns \u003ccode\u003enull\u003c/code\u003e or a value of one of the case types, including for a default struct value. A custom union can represent its default value as a non-null case, unlike the null contents of a default generated union.\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"505:1-505:159\"\u003e出典：\u003ca href=\"https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/union#custom-union-types\" rel=\"nofollow noopener\" target=\"_blank\"\u003eUnion types (C# reference) - Custom union types\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"507:1-507:30\"\u003e日本語訳（筆者訳）：\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"508:1-508:339\"\u003e\n\u003cp data-sourcepos=\"508:3-508:339\"\u003e\u003cstrong\u003eSoundness（健全性）\u003c/strong\u003e：\u003ccode\u003eValue\u003c/code\u003e は、default の struct 値であっても、常に \u003ccode\u003enull\u003c/code\u003e かケース型のいずれかの値を返す。自作の union は、default 値を null ではないケースとして表現してもよい。これは、生成された union の default の中身が null であるのとは異なる。\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"510:1-510:111\"\u003eC# 15機能仕様に載っている \u003ccode\u003eIntOrBool\u003c/code\u003e のサンプルがまさにこの好例となっています。\u003c/p\u003e\n\u003cp data-sourcepos=\"512:1-512:187\"\u003e出典：\u003ca href=\"https://learn.microsoft.com/ja-jp/dotnet/csharp/language-reference/proposals/csharp-15.0/unions#examples-of-union-types\" rel=\"nofollow noopener\" target=\"_blank\"\u003eUnions（C# 15 機能仕様）- Examples of union types\u003c/a\u003e\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"514:1-538:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"p\"\u003e[\u003c/span\u003e\u003cspan class=\"n\"\u003eUnion\u003c/span\u003e\u003cspan class=\"p\"\u003e]\u003c/span\u003e\n\u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"k\"\u003erecord\u003c/span\u003e \u003cspan class=\"nc\"\u003estruct\u003c/span\u003e \u003cspan class=\"n\"\u003eIntOrBool\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eprivate\u003c/span\u003e \u003cspan class=\"kt\"\u003ebool\u003c/span\u003e \u003cspan class=\"n\"\u003e_isBool\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eprivate\u003c/span\u003e \u003cspan class=\"kt\"\u003eint\u003c/span\u003e \u003cspan class=\"n\"\u003e_value\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\n    \u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"nf\"\u003eIntOrBool\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003eint\u003c/span\u003e \u003cspan class=\"k\"\u003evalue\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003e_isBool\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003e_value\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"k\"\u003efalse\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"k\"\u003evalue\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n    \u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"nf\"\u003eIntOrBool\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kt\"\u003ebool\u003c/span\u003e \u003cspan class=\"k\"\u003evalue\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003e_isBool\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003e_value\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"k\"\u003etrue\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"k\"\u003evalue\u003c/span\u003e \u003cspan class=\"p\"\u003e?\u003c/span\u003e \u003cspan class=\"m\"\u003e1\u003c/span\u003e \u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"m\"\u003e0\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n\n    \u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"kt\"\u003eobject\u003c/span\u003e \u003cspan class=\"n\"\u003eValue\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"n\"\u003e_isBool\u003c/span\u003e \u003cspan class=\"p\"\u003e?\u003c/span\u003e \u003cspan class=\"n\"\u003e_value\u003c/span\u003e \u003cspan class=\"k\"\u003eis\u003c/span\u003e \u003cspan class=\"m\"\u003e1\u003c/span\u003e \u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003e_value\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\n    \u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"kt\"\u003ebool\u003c/span\u003e \u003cspan class=\"n\"\u003eHasValue\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"k\"\u003etrue\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n    \u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"kt\"\u003ebool\u003c/span\u003e \u003cspan class=\"nf\"\u003eTryGetValue\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"k\"\u003eout\u003c/span\u003e \u003cspan class=\"kt\"\u003eint\u003c/span\u003e \u003cspan class=\"k\"\u003evalue\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n        \u003cspan class=\"k\"\u003evalue\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003e_value\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n        \u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"p\"\u003e!\u003c/span\u003e\u003cspan class=\"n\"\u003e_isBool\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n    \u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"kt\"\u003ebool\u003c/span\u003e \u003cspan class=\"nf\"\u003eTryGetValue\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"k\"\u003eout\u003c/span\u003e \u003cspan class=\"kt\"\u003ebool\u003c/span\u003e \u003cspan class=\"k\"\u003evalue\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n        \u003cspan class=\"k\"\u003evalue\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003e_isBool\u003c/span\u003e \u003cspan class=\"p\"\u003e\u0026amp;\u0026amp;\u003c/span\u003e \u003cspan class=\"n\"\u003e_value\u003c/span\u003e \u003cspan class=\"k\"\u003eis\u003c/span\u003e \u003cspan class=\"m\"\u003e1\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n        \u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"n\"\u003e_isBool\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"540:1-540:151\"\u003eここで \u003ccode\u003eIntOrBool x = default\u003c/code\u003e と書くと、struct の通常ルール通り、\u003ccode\u003e_isBool\u003c/code\u003e が \u003ccode\u003efalse\u003c/code\u003e、\u003ccode\u003e_value\u003c/code\u003e が \u003ccode\u003e0\u003c/code\u003e で初期化されます。\u003c/p\u003e\n\u003cp data-sourcepos=\"542:1-542:242\"\u003e\u003ccode\u003e_isBool\u003c/code\u003e が \u003ccode\u003efalse\u003c/code\u003e なので、\u003ccode\u003eValue\u003c/code\u003e は \u003ccode\u003e_value\u003c/code\u003e、つまり \u003ccode\u003eint\u003c/code\u003e の \u003ccode\u003e0\u003c/code\u003e を返し、\u003ccode\u003eTryGetValue(out int)\u003c/code\u003e も \u003ccode\u003etrue\u003c/code\u003e を返します。つまり \u003ccode\u003edefault\u003c/code\u003e は、「\u003ccode\u003eint\u003c/code\u003e の \u003ccode\u003e0\u003c/code\u003e が入っている状態」として扱われます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"544:1-549:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"n\"\u003eIntOrBool\u003c/span\u003e \u003cspan class=\"n\"\u003ex\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"k\"\u003edefault\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003cspan class=\"n\"\u003eConsole\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eWriteLine\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003ex\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eValue\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e     \u003cspan class=\"c1\"\u003e// 0（int）\u003c/span\u003e\n\u003cspan class=\"n\"\u003eConsole\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eWriteLine\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003ex\u003c/span\u003e \u003cspan class=\"k\"\u003eis\u003c/span\u003e \u003cspan class=\"k\"\u003enull\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e   \u003cspan class=\"c1\"\u003e// False\u003c/span\u003e\n\u003cspan class=\"n\"\u003eConsole\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eWriteLine\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003ex\u003c/span\u003e \u003cspan class=\"k\"\u003eis\u003c/span\u003e \u003cspan class=\"kt\"\u003eint\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e    \u003cspan class=\"c1\"\u003e// True\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"551:1-551:284\"\u003e\u003ccode\u003eHasValue\u003c/code\u003e も常に \u003ccode\u003etrue\u003c/code\u003e を返しますので、\u003ccode\u003enull\u003c/code\u003e の状態がありません。そのため、\u003ccode\u003eswitch\u003c/code\u003e 式に \u003ccode\u003enull\u003c/code\u003e の分岐を書かなくても、\u003ccode\u003edefault\u003c/code\u003e を渡したときに実行時例外になることはありません（\u003ccode\u003eint\u003c/code\u003e の分岐にマッチします）。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"553:1-553:59\"\u003e\n\u003cspan id=\"余談union-属性は-class-にも付けられる\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BD%99%E8%AB%87union-%E5%B1%9E%E6%80%A7%E3%81%AF-class-%E3%81%AB%E3%82%82%E4%BB%98%E3%81%91%E3%82%89%E3%82%8C%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e余談：\u003ccode\u003e[Union]\u003c/code\u003e 属性は class にも付けられる\u003c/h2\u003e\n\u003cp data-sourcepos=\"555:1-555:237\"\u003eここまでは struct で union を作ってきましたが、\u003ccode\u003e[Union]\u003c/code\u003e 属性は class にも付けられます。たとえば、\u003ccode\u003eIntOrDecimalNoBox\u003c/code\u003e の \u003ccode\u003estruct\u003c/code\u003e を \u003ccode\u003eclass\u003c/code\u003e に変えるだけで、class 版の union になります。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"c#\" data-sourcepos=\"557:1-563:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"p\"\u003e[\u003c/span\u003e\u003cspan class=\"n\"\u003eUnion\u003c/span\u003e\u003cspan class=\"p\"\u003e]\u003c/span\u003e\n\u003cspan class=\"k\"\u003epublic\u003c/span\u003e \u003cspan class=\"k\"\u003esealed\u003c/span\u003e \u003cspan class=\"k\"\u003eclass\u003c/span\u003e \u003cspan class=\"nc\"\u003eIntOrDecimalClass\u003c/span\u003e \u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"n\"\u003eIUnion\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"c1\"\u003e// 中身は IntOrDecimalNoBox と同じ\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"565:1-565:55\"\u003estruct 版との主な違いは次のとおりです。\u003c/p\u003e\n\u003cul data-sourcepos=\"567:1-570:0\"\u003e\n\u003cli data-sourcepos=\"567:1-567:175\"\u003eunion 自体がヒープに確保される。中身は値型のフィールドで持つので boxing はされないが、生成のたびにインスタンスが作られる\u003c/li\u003e\n\u003cli data-sourcepos=\"568:1-568:161\"\u003e\n\u003ccode\u003edefault\u003c/code\u003e を代入すると null 参照になる（中身が空の union ではなく、union 自体が null）。参照型なので \u003ccode\u003enull\u003c/code\u003e も代入できる\u003c/li\u003e\n\u003cli data-sourcepos=\"569:1-570:0\"\u003e\n\u003ccode\u003enull\u003c/code\u003e パターンは、「union の参照が null」と「中身が null」のどちらにもマッチする\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"571:1-571:281\"\u003eアロケーションを避けたいなら、\u003ccode\u003eIntOrDecimalNoBox\u003c/code\u003e のように、中身を値型のフィールドで持つ struct の union にする必要があります（union 宣言も内部では struct ですが、中身を \u003ccode\u003eobject?\u003c/code\u003e で持つので boxing されます）。\u003c/p\u003e\n\u003cp data-sourcepos=\"573:1-573:424\"\u003e一方、インスタンスを参照で共有したい場合や、継承を使いたい場合は class が向いています。公式ドキュメントでも、class の union は参照のセマンティクスや継承が必要な場合に便利だとされています。ただし、\u003ccode\u003e[Union]\u003c/code\u003e 属性は派生クラスには引き継がれず、派生クラスは union として扱われないので注意が必要です。\u003c/p\u003e\n\u003cp data-sourcepos=\"575:1-575:169\"\u003e出典：\u003ca href=\"https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/union#class-based-union-types\" rel=\"nofollow noopener\" target=\"_blank\"\u003eUnion types (C# reference) - Class-based union types\u003c/a\u003e\u003c/p\u003e\n\u003ch1 data-sourcepos=\"578:1-578:11\"\u003e\n\u003cspan id=\"まとめ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%BE%E3%81%A8%E3%82%81\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eまとめ\u003c/h1\u003e\n\u003cp data-sourcepos=\"580:1-580:206\"\u003eBenchmarkDotNet で、1,000 件の union を生成して配列に格納する処理と、switch 式で値を取り出して合計する処理を測りました（\u003ccode\u003eint\u003c/code\u003e と \u003ccode\u003edecimal\u003c/code\u003e を交互に格納）。\u003c/p\u003e\n\u003ctable data-sourcepos=\"582:1-585:62\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"582:1-582:106\"\u003e\n\u003cth data-sourcepos=\"582:2-582:24\"\u003e処理（1,000 件）\u003c/th\u003e\n\u003cth style=\"text-align: right\" data-sourcepos=\"582:26-582:59\"\u003eunion 宣言（\u003ccode\u003eIntOrDecimal\u003c/code\u003e）\u003c/th\u003e\n\u003cth style=\"text-align: right\" data-sourcepos=\"582:61-582:105\"\u003eカスタム union（\u003ccode\u003eIntOrDecimalNoBox\u003c/code\u003e）\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"584:1-584:50\"\u003e\n\u003ctd data-sourcepos=\"584:2-584:9\"\u003e生成\u003c/td\u003e\n\u003ctd style=\"text-align: right\" data-sourcepos=\"584:11-584:32\"\u003e11,944 ns / 28,000 B\u003c/td\u003e\n\u003ctd style=\"text-align: right\" data-sourcepos=\"584:34-584:49\"\u003e1,070 ns / 0 B\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"585:1-585:62\"\u003e\n\u003ctd data-sourcepos=\"585:2-585:25\"\u003eswitch で取り出し\u003c/td\u003e\n\u003ctd style=\"text-align: right\" data-sourcepos=\"585:27-585:43\"\u003e13,331 ns / 0 B\u003c/td\u003e\n\u003ctd style=\"text-align: right\" data-sourcepos=\"585:45-585:61\"\u003e12,746 ns / 0 B\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"587:1-587:388\"\u003eカスタム union では、生成にかかる時間が約 \u003ccode\u003e1/7\u003c/code\u003e〜\u003ccode\u003e1/11\u003c/code\u003e（計測するたびにばらつきがあり、別の計測では 6,141 ns と 912 ns でした）、メモリアロケーションは当然 \u003ccode\u003e0\u003c/code\u003e なので、明らかに優秀です。逆に、switch でのパターンマッチングや値の取り出しについては、ほとんど差は出ませんでした。\u003c/p\u003e\n\u003cp data-sourcepos=\"589:1-589:263\"\u003eカスタム union は優秀ではありますが、コードは見づらく、その動作の正当性は自分で保証しなくてはならないので、カスタム union を書く際には一緒にテストを書くことは必須になると思います。\u003c/p\u003e\n\u003cp data-sourcepos=\"591:1-591:175\"\u003e基本的には union 宣言で定義して気軽に利用し、大量に生成するようなケースでは書き換える、という使い方が良いかと思います。\u003c/p\u003e\n\u003cp data-sourcepos=\"593:1-593:294\"\u003eとはいえ今のところぱっと良い使い道が思いつかず、\u003ccode\u003eResult\u0026lt;T\u0026gt;\u003c/code\u003e の union版の話題を見ながら「それホントに使いやすいのかな…」と懐疑的に見ていますが、せっかく面白い機能なので可能性を探っていきたいところです。\u003c/p\u003e\n","body":"# 検証環境\n\n- .NET SDK 11.0.100（C# 15）\n- Windows 11（x64）、13th Gen Intel Core i7-1360P\n- ILSpy（ilspycmd）11.2.0\n- BenchmarkDotNet 0.15.8\n\n# はじめに（union型の簡単な紹介）\n.NET 11(C# 15)で、C# が union型をサポートしました。\n\n```c#\npublic union IntOrDecimal(int, decimal);\n```\n\n上記のように定義すると、「`int` か `decimal` のどちらかを表す型」を作れます。\n下記のように switch 式でも記述できます。\n\n```c#\nIntOrDecimal a = 12;\nIntOrDecimal b = 1.23m;\n\ndecimal ToDecimal(IntOrDecimal u) =\u003e u switch\n{\n    int i =\u003e (decimal)i, // キャストを書かなくても暗黙変換されるが、意図の明確化の為にキャスト\n    decimal d =\u003e d,     // 中身がdecimalならそのまま返す\n};\n```\n\nここで、`decimal` 型の分岐を書き忘れると、ちゃんと警告してくれます（ありがたい！）。\n\n```c#\ndecimal ToDecimal(IntOrDecimal u) =\u003e u switch\n{\n    int i =\u003e (decimal)i, \n};\n```\n\n```\nwarning CS8509: この switch 式では入力型の可能な値がすべて扱われるわけではありません (すべてが網羅されているわけではありません)。たとえば、パターン 'decimal' がカバーされていません。\n```\n\nこの記事では、C# の union 型がどのような挙動をするのか、ILSpyで覗いたり、いろいろ試して実験してみたいと思います。\n（思いつくままなので、網羅的ではないです）\n\n尚、この記事では分かりやすさの為に `int` と `decimal` の union 型を作っていますが、もちろん `class` や `struct`、`record` 型なんかでも自由に組み合わせることができます。\n\n```c#\npublic union Result\u003cT\u003e(T, Error);\n```\n\n# union は内部でどう表現されるのか\n\nC# 15の仕様書には、union 宣言は次のような struct に変換されると書かれています。\n\n\u003e A union declaration is lowered to a struct declaration with\n\u003e - the same attributes, modifiers, name, type parameters and constraints,\n\u003e - implicit implementations of `IUnion`,\n\u003e - a `public object? Value { get; }` auto-property,\n\u003e - a public constructor for each of the *case_types*,\n\u003e - any members in the union declaration's body.\n\n出典：[Unions（C# 15 機能仕様）- Lowering](https://learn.microsoft.com/dotnet/csharp/language-reference/proposals/csharp-15.0/unions#lowering)\n\n日本語訳：\n\u003e union 宣言は、次のような struct 宣言に落とし込まれます。つまり、\n\u003e - 同じ属性、修飾子、名前、型パラメータ、制約を持ち、\n\u003e - `IUnion` の暗黙的な実装を持ち、\n\u003e - `public object? Value { get; }` の自動プロパティを持ち、\n\u003e - 各 *case_types* に対する public コンストラクタを持ち、\n\u003e - union 宣言の本体に含まれるメンバーを持つ、というものです。\n\n\n## ILSpyで逆コンパイル\n\nさきほど定義した `IntOrDecimal` 型は、どのようにコンパイルされるのか ILSpyの逆コンパイルで確認してみます。\n\n```c#\n[Union]\npublic struct IntOrDecimal : IUnion\n{\n    public object? Value { get; }\n\n    [CompilerGenerated]\n    public IntOrDecimal(int value)\n    {\n        Value = value;\n    }\n\n    [CompilerGenerated]\n    public IntOrDecimal(decimal value)\n    {\n        Value = value;\n    }\n}\n```\n\nつまり、「いろんな型を保持できる」というのは、実際には `object?` 型として保持されているだけ、ということです。\n\n他、`UnionAttribute` が付いていたり、`IUnion` を実装していたりという形式になっています。\n`IUnion` は次のように `object? Value` プロパティだけを持つインターフェイスでした。\n\n```c#\npublic interface IUnion\n{\n    object? Value { get; }\n}\n```\n\n## Unsafe.SizeOf でサイズを確認\n\n`Unsafe.SizeOf\u003cT\u003e()` で `IntOrDecimal` のサイズを測ると、8バイトでした。\nこれは、`object` 型が示す参照（ポインタ）1つ分のサイズです（64ビット環境の場合）。\n\n参照の先にあるオブジェクト（`int` や `decimal` の値が入った実体）のサイズは含まれていない事に注意です。\n\n\n## union 変換\n\n```c#\nIntOrDecimal x = 12;\n```\n\n上記のような代入（union 変換）は、内部でどのように変換されるのでしょうか。\n引数で受け取った `int` をそのまま `IntOrDecimal` として返すだけの、次のメソッドを用意して IL を見てみます。\n\n```c#\npublic static IntOrDecimal CreateGenerated(int x) =\u003e x;   // int → IntOrDecimal の union 変換\n```\n\nILで見ると次のようになっていました（`ldarg.0` は引数 `x` の読み込みです）。\n\n```\n// IntOrDecimal CreateGenerated(int x) の IL\n  IL_0000: ldarg.0\n  IL_0001: newobj         IntOrDecimal::.ctor(int)\n  IL_0006: ret\n```\n\n`IntOrDecimal(int value)` のコンストラクタ呼び出しになっています。`IntOrDecimal` に `implicit operator`（`op_Implicit` メソッド）が生成されているわけではなく、コンパイラが union 変換をコンストラクタ呼び出しに直接置き換えています。\n\n仕様書では、union 変換について次のように説明されています。\n\n\u003e A union conversion is executed by calling the union's creation member（中略）\n\u003e Union conversion is just another \"form\" of an implicit user-defined conversion. An applicable user-defined conversion operator \"shadows\" union conversion.\n\n出典：[Unions（C# 15 機能仕様）- Union conversions](https://learn.microsoft.com/dotnet/csharp/language-reference/proposals/csharp-15.0/unions#union-conversions)\n\n日本語訳（筆者訳）：\n\u003e union 変換は、union の作成メンバー（コンストラクタ）を呼び出すことで実行される。（中略）\n\u003e union 変換は、ユーザー定義の暗黙変換の一つの「形」にすぎない。適用できるユーザー定義の変換演算子があれば、union 変換はそれに隠される（そちらが優先される）。\n\nつまり、分類上はユーザー定義の暗黙変換の仲間ですが、自分で `implicit operator` を書かなくても、コンパイラが用意したコンストラクタが使われるということです。同じ型への `implicit operator` を自分で定義した場合は、そちらが優先されます。\n\nこのコンストラクタは、冒頭で引用した仕様書の lowering の説明（\"a public constructor for each of the *case_types*\"）のとおり、コンパイラが自動生成したものです。\n\nそして、そのコンストラクタをILで見るとこうなっています。\n\n```\n// IntOrDecimal::.ctor(int)\n  IL_0000: ldarg.0\n  IL_0001: ldarg.1\n  IL_0002: box            int        ← ここで boxing されている\n  IL_0007: stfld          object IntOrDecimal::\u003cValue\u003ek__BackingField\n  IL_000c: ret\n```\n\n`int` から `object` への代入なので、当然ながら boxing されています。\nboxing されるということはメモリがスタックではなくヒープに確保されるということであり、当然GCの影響も受けます。\n\nここは、union 型の定義の形 `union IntOrDecimal(int, decimal)` からはあまり想像がつかない点で、内部で `object?` として表現されていると知っていれば自ずと想像が付きますが、知らないと boxing されるとはあまり思わない気がします。\nこの、union のケース型が値型（`int` や `decimal`、struct など）の場合に boxing されるという点は、だいぶ注意が必要だと思います。\n\n## switch 式による値の取り出し\n\n```c#\n// switch 式で中身を取り出す\n[MethodImpl(MethodImplOptions.NoInlining)]\npublic static decimal ToDecimal(IntOrDecimal u) =\u003e u switch\n{\n    int i =\u003e (decimal)i,\n    decimal d =\u003e d,\n    null =\u003e 0m,   // default のとき（後述）\n};\n```\n\n上記のようなテスト用のメソッドを作り、コンパイル結果をILで見てみます。\n\n```\n  IL_0000: ldarga.s       0\n  IL_0002: call           object IntOrDecimal::get_Value()   ← 中身を object で取得\n  IL_0007: stloc.3\n  IL_0008: ldloc.3\n  IL_0009: isinst         int                                ← int か？\n  IL_000e: brfalse.s      IL_0019\n  IL_0010: ldloc.3\n  IL_0011: unbox.any      int                                ← unboxing\n  IL_0016: stloc.0\n  IL_0017: br.s           IL_002f\n  IL_0019: ldloc.3\n  IL_001a: isinst         decimal                            ← decimal か？\n  IL_001f: brfalse.s      IL_002a\n  IL_0021: ldloc.3\n  IL_0022: unbox.any      decimal                            ← unboxing\n  IL_0027: stloc.1\n  IL_0028: br.s           IL_0038\n  IL_002a: ldloc.3\n  IL_002b: brfalse.s      IL_003c                            ← null か？\n  ...\n```\n\nつまり、中身を `object` として取り出し、その型が `int` か `decimal` なら unboxing して返す、という流れになっています。\n\n\n## アロケーション量を計測\n\n`GC.GetAllocatedBytesForCurrentThread()` で1回あたりのアロケーション量を測ると、以下のようになりました。\n\n- (1) 生成(int) : 24 bytes\n- (2) 生成(decimal) : 32 bytes\n- (3) switch で取り出し : 0 bytes\n\n64ビット環境では、boxing されたオブジェクトのサイズは次の式で計算したあと、8バイト境界に切り上げられます。\n\n```\nオブジェクトヘッダ（8バイト） + メソッドテーブルへのポインタ（8バイト） + 値\n```\n\n`int` だと 8 + 8 + 4 = 20 で 24バイトへ切り上げられ、`decimal` だと 8 + 8 + 16 = 32バイトとなり、計測値と同じになりました。\n\n本来 `int` 1つなら 4バイトで済むところを、boxing のせいで 24バイトのヒープ領域が確保される上に GC の回収対象にもなるということで、大量に union を作るケースだと無視できないコストになりそうです。\n\nswitchでの値の取り出しは、前述の通り unboxing されているだけでメモリアロケーションはないので、この結果も納得です。\n\n## 余談：union宣言に int と decimal のフィールドを足してごにょごにょできないの？ → できない\n\nこんな風に宣言して、boxing を回避できないかなぁと思いましたがダメでした。\n\n```c#\npublic union IntOrDecimal(int, decimal)\n{\n    private readonly int _int;   // error CS9373\n}\n```\n\n```\nerror CS9373: インスタンス フィールド、自動プロパティ、またはフィールドに似たイベントは、'union' 宣言では許可されません。\n```\n\nそういう風に使いたい場合は、後述するカスタム union を使います。\n\n# `default` を代入すると `null` が入る\n\n私はちょっと驚いたのですが、union には `default` が代入できて、その場合中身は `null` になります。\n\n```c#\nIntOrDecimal a = default; // 中身（Value）が null になる\nbool b1 = a is null; // true\nbool b2 = (object)a is null; // false（union自体は null じゃない）\n```\n\nただの struct でも `default` が代入できましたが、結果はそれぞれのフィールドが `0` や `false`、`null` にクリアされるだけでした。\n\nでも考えてみると、`object?` を持つ struct として union が定義されているなら、当然それは `null` になるという事なんでしょう。\n\nしかしそのせいで、別に `nullable` ではないのに `null` である可能性を考慮する必要が出てきます。\n\nその一方で、`IntOrDecimal` には `null` を代入することはできません。\n\n```c#\nIntOrDecimal d = null;\n```\n\n```\nerror CS0037: Null 非許容の値型であるため、Null を 'IntOrDecimal' に変換できません\n```\n\nもちろん、ケース型に `int?` を含む union（例：`union NullableIntOrDecimal(int?, decimal);`）なら、`= null` は union変換になり、`null` を代入できます。\n\nまた、`IntOrDecimal?` にも `null` を代入できます。ただし、これは union 変換ではありません。`IntOrDecimal?` は `Nullable\u003cIntOrDecimal\u003e` という別の型で、`null` を代入できるのは Nullable の仕組みによるものです。\n\n```c#\nIntOrDecimal? n = null;   // OK：Nullable の null（union の値そのものが無い）\nIntOrDecimal? m = 42;     // OK：union 変換したうえで Nullable に入る\n```\n\n`IntOrDecimal?` の `null` は「union の値そのものが無い」状態で、前述の「中身が null の union」とは別物です。\n\n問題になるのは、`switch` 式の場合です。\n\n```c#\ndecimal ToDecimal(IntOrDecimal u) =\u003e u switch\n{\n    int i =\u003e (decimal)i,\n    decimal d =\u003e d,\n};\n```\n\n上記に `default` を渡してもコンパイルエラーになりません。switch式に `null` の分岐がないことへの警告も出ません。\nしかし、実行時例外が起きます。\n\n```\nSwitchExpressionException: Non-exhaustive switch expression failed to match its input.\nUnmatched value was IntOrDecimal.\n```\n\nこれはなんか、どうにかして欲しい気がしますが…。\n\n中身が null の union は、`default` を代入したときだけでなく、次のような場合にもできてしまいます。\n\n```c#\nIntOrDecimal a = default;\nIntOrDecimal b = new IntOrDecimal();      // 引数なしのコンストラクタ\nIntOrDecimal[] c = new IntOrDecimal[1];   // 初期化していない配列の要素\n\nConsole.WriteLine(a.Value is null);       // True\nConsole.WriteLine(b.Value is null);       // True\nConsole.WriteLine(c[0].Value is null);    // True\nConsole.WriteLine(a is null);             // True（null パターンは中身を調べる）\n```\n\nクラスのフィールドで初期化していないものも同様です。実際のコードでは、これがいちばん踏みやすいケースかもしれません。\n\n```c#\nclass Order\n{\n    private IntOrDecimal _amount;   // 初期化していないフィールドも default（中身が null）\n}\n```\n\n今のところは以下のように `null` の分岐も書いておくべきなんでしょうか（これなら実行時例外も起きません）。\n\n```c#\ndecimal ToDecimal(IntOrDecimal u) =\u003e u switch\n{\n    int i =\u003e (decimal)i,\n    decimal d =\u003e d,\n    null =\u003e 0m,   // default のとき\n};\n```\n\nまたは、`null` なんて想定していない事を明示する為にも、ここは例外を投げるべきなんでしょうか。\n\n```c#\ndecimal ToDecimal(IntOrDecimal u) =\u003e u switch\n{\n    int i =\u003e (decimal)i,\n    decimal d =\u003e d,\n    null =\u003e throw new InvalidOperationException(\"IntOrDecimal に値が入っていません\"),   // default のとき\n};\n```\n\nもっとも、`null` の分岐が無い場合でも、`default` が来れば結局 `SwitchExpressionException` が投げられます。明示的に `throw` を書く利点は、「null を想定していない」という意図がコードに残ることと、例外の種類やメッセージを自分で選べることです。\n\n\n# カスタム union 型で boxing を回避する方法\n\nカスタムの union 型を自分で定義することで、boxing を回避する方法があります。\n\nその前に、まず union 型の条件を挙げます。\n\n- `[System.Runtime.CompilerServices.Union]` 属性が付いている\n- 引数1つのpublicコンストラクタがある（その引数の型がケース型になる）\n- `object?` 又は `object` 型の public な `Value` プロパティ（`get` アクセサ）がある\n\nこれさえ満たしていれば、その型は union として機能します。\n尚、`IUnion` はどうも必須ではないようで、なしでも union 変換や `switch` は動作しました。とはいえ、基本的には `IUnion` も実装しておくべきだろうと思います。\n\n## 非 boxing アクセスパターン（non-boxing union access pattern）\n\n上記の基本パターンに加えて次の2種類のメンバーを追加すると、コンパイラはパターンマッチングで `Value` プロパティを使わなくなります。これを 非 boxing アクセスパターンと呼びます。（出典：[Unions（C# 15 機能仕様）- Non-boxing access members](https://learn.microsoft.com/dotnet/csharp/language-reference/proposals/csharp-15.0/unions#non-boxing-access-members)）\n\n- `bool HasValue { get; }` : 中身が `null` でなければ `true` （ `u is null` や `null =\u003e` などの null パターンで利用される）\n- `bool TryGetValue(out T value)` : 中身が `T` なら `true` を返し、値を `out` で返す （`u is int i` や `int i =\u003e` などの 型パターンで利用される）\n\nこれらを使って `IntOrDecimal` を定義しなおしたのがこちらです。\n\n```c#\n[Union]\npublic readonly struct IntOrDecimalNoBox : IUnion\n{\n    private readonly decimal _decimal;\n    private readonly int _int;\n    private readonly byte _tag; // 0 = 空, 1 = int, 2 = decimal\n\n    public IntOrDecimalNoBox(int value) { _int = value; _tag = 1; }\n    public IntOrDecimalNoBox(decimal value) { _decimal = value; _tag = 2; }\n\n    // IUnion の要件。object を返すので、ここを呼ぶと boxing される\n    public object? Value =\u003e _tag switch\n    {\n        1 =\u003e _int,\n        2 =\u003e _decimal,\n        _ =\u003e null,\n    };\n\n    // --- 非 boxing アクセスパターン\n    public bool HasValue =\u003e _tag != 0;\n\n    public bool TryGetValue(out int value)\n    {\n        value = _int;\n        return _tag == 1;\n    }\n\n    public bool TryGetValue(out decimal value)\n    {\n        value = _decimal;\n        return _tag == 2;\n    }\n}\n```\n\n仕様書には、非 boxing アクセスパターンについて次のような注記があります。\n\n\u003e （前略）The user code can store the content any way it likes. In particular, it does not prevent the implementation from boxing! The `non-boxing` in its name refers to allowing the compiler's pattern matching implementation to access each case type in a strongly typed way, as opposed to the `object?`-typed `Value` property.\n\n出典：[Unions（C# 15 機能仕様）- Examples of union types](https://learn.microsoft.com/dotnet/csharp/language-reference/proposals/csharp-15.0/unions#examples-of-union-types)\n\n日本語訳（筆者訳）：\n\u003e 中身をどのように格納するかは、ユーザーのコードが自由に決められる。特に、この仕組みは実装が boxing することを防ぐものではない！ 名前にある「非 boxing」とは、コンパイラのパターンマッチングの実装が、`object?` 型の `Value` プロパティではなく、各ケース型に型付きでアクセスできることを指している。\n\nさすがに、内部で `object?` で保持したまま boxing を回避するというのは無理筋で、ちゃんとそれぞれの型用のフィールドを定義してね、という事です。\n\n実際に `IntOrDecimalNoBox x = 42;` のような union変換がどう IL にコンパイルされるか、先ほどと同じように次のメソッドで見てみます。\n\n```c#\npublic static IntOrDecimalNoBox CreateNoBox(int x) =\u003e x;   // int → IntOrDecimalNoBox の union 変換\n```\n\n```\n// IntOrDecimalNoBox CreateNoBox(int x) の IL\n  IL_0000: ldarg.0\n  IL_0001: newobj         IntOrDecimalNoBox::.ctor(int)\n  IL_0006: ret\n```\n\n代入自体は上記のように、コンストラクタ呼び出しです。\nそのコンストラクタの中身は次のようになっています。\n\n```\n// IntOrDecimalNoBox::.ctor(int)\n  IL_0000: ldarg.0\n  IL_0001: ldflda         decimal IntOrDecimalNoBox::_decimal\n  IL_0006: initobj        decimal                          ← _decimal を既定値（0）で初期化\n  IL_000c: ldarg.0\n  IL_000d: ldarg.1\n  IL_000e: stfld          int IntOrDecimalNoBox::_int      ← int のまま int 型のフィールドに格納\n  IL_0013: ldarg.0\n  IL_0014: ldc.i4.1\n  IL_0015: stfld          byte IntOrDecimalNoBox::_tag     ← _tag = 1\n  IL_001a: ret\n\n// IntOrDecimalNoBox::.ctor(decimal)\n  IL_0000: ldarg.0\n  IL_0001: ldc.i4.0\n  IL_0002: stfld          int IntOrDecimalNoBox::_int      ← _int を既定値（0）で初期化\n  IL_0007: ldarg.0\n  IL_0008: ldarg.1\n  IL_0009: stfld          decimal IntOrDecimalNoBox::_decimal  ← decimal のまま decimal 型のフィールドに格納\n  IL_000e: ldarg.0\n  IL_000f: ldc.i4.2\n  IL_0010: stfld          byte IntOrDecimalNoBox::_tag     ← _tag = 2\n  IL_0015: ret\n```\n\nboxing が無くなっていますね！\n\nちなみにサイズを確認すると、24 bytes でした。`decimal` (16バイト)、`int` （4バイト）、tag用の `byte` （1バイト）で、境界で切り上げられて24バイト、ということでしょう。\n\nswitch式は、これまで `get_Value` や `isinst`、`unbox.any` だった場所が以下のように `TryGetValue` と `HasValue` 呼び出しに置き換えられています。\n\n```\n//   local [3] int\n//   local [4] decimal\n  IL_0000: ldarga.s       0\n  IL_0002: ldloca.s       3\n  IL_0004: call           bool IntOrDecimalNoBox::TryGetValue(int\u0026)       ← int i =\u003e ...\n  IL_0009: brfalse.s      IL_000f\n  IL_000b: ldloc.3\n  IL_000c: stloc.0\n  IL_000d: br.s           IL_002a\n  IL_000f: ldarga.s       0\n  IL_0011: ldloca.s       4\n  IL_0013: call           bool IntOrDecimalNoBox::TryGetValue(decimal\u0026)   ← decimal d =\u003e ...\n  IL_0018: brfalse.s      IL_001f\n  IL_001a: ldloc.s        4\n  IL_001c: stloc.1\n  IL_001d: br.s           IL_0033\n  IL_001f: ldarga.s       0\n  IL_0021: call           bool IntOrDecimalNoBox::get_HasValue()          ← null =\u003e ...\n  IL_0026: brfalse.s      IL_0037\n  IL_0028: br.s           IL_003f\n  ...\n```\n\n同様の方法でアロケーション量を測りましたが、全て 0 bytes となりました。\n（もちろん、`.Value` を直接呼び出せば boxing されてしまいます）\n\n## 余談：カスタム union では、default を null 以外にできる\n\n公式ドキュメントに次のようにあります。\n\n\u003e **Soundness**: `Value` always returns `null` or a value of one of the case types, including for a default struct value. A custom union can represent its default value as a non-null case, unlike the null contents of a default generated union.\n\n出典：[Union types (C# reference) - Custom union types](https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/union#custom-union-types)\n\n日本語訳（筆者訳）：\n\u003e **Soundness（健全性）**：`Value` は、default の struct 値であっても、常に `null` かケース型のいずれかの値を返す。自作の union は、default 値を null ではないケースとして表現してもよい。これは、生成された union の default の中身が null であるのとは異なる。\n\nC# 15機能仕様に載っている `IntOrBool` のサンプルがまさにこの好例となっています。\n\n出典：[Unions（C# 15 機能仕様）- Examples of union types](https://learn.microsoft.com/ja-jp/dotnet/csharp/language-reference/proposals/csharp-15.0/unions#examples-of-union-types)\n\n```c#\n[Union]\npublic record struct IntOrBool\n{\n    private bool _isBool;\n    private int _value;\n\n    public IntOrBool(int value) =\u003e (_isBool, _value) = (false, value);\n    public IntOrBool(bool value) =\u003e (_isBool, _value) = (true, value ? 1 : 0);\n\n    public object Value =\u003e _isBool ? _value is 1 : _value;\n\n    public bool HasValue =\u003e true;\n    public bool TryGetValue(out int value)\n    {\n        value = _value;\n        return !_isBool;\n    }\n    public bool TryGetValue(out bool value)\n    {\n        value = _isBool \u0026\u0026 _value is 1;\n        return _isBool;\n    }\n}\n```\n\nここで `IntOrBool x = default` と書くと、struct の通常ルール通り、`_isBool` が `false`、`_value` が `0` で初期化されます。\n\n`_isBool` が `false` なので、`Value` は `_value`、つまり `int` の `0` を返し、`TryGetValue(out int)` も `true` を返します。つまり `default` は、「`int` の `0` が入っている状態」として扱われます。\n\n```c#\nIntOrBool x = default;\nConsole.WriteLine(x.Value);     // 0（int）\nConsole.WriteLine(x is null);   // False\nConsole.WriteLine(x is int);    // True\n```\n\n`HasValue` も常に `true` を返しますので、`null` の状態がありません。そのため、`switch` 式に `null` の分岐を書かなくても、`default` を渡したときに実行時例外になることはありません（`int` の分岐にマッチします）。\n\n## 余談：`[Union]` 属性は class にも付けられる\n\nここまでは struct で union を作ってきましたが、`[Union]` 属性は class にも付けられます。たとえば、`IntOrDecimalNoBox` の `struct` を `class` に変えるだけで、class 版の union になります。\n\n```c#\n[Union]\npublic sealed class IntOrDecimalClass : IUnion\n{\n    // 中身は IntOrDecimalNoBox と同じ\n}\n```\n\nstruct 版との主な違いは次のとおりです。\n\n- union 自体がヒープに確保される。中身は値型のフィールドで持つので boxing はされないが、生成のたびにインスタンスが作られる\n- `default` を代入すると null 参照になる（中身が空の union ではなく、union 自体が null）。参照型なので `null` も代入できる\n- `null` パターンは、「union の参照が null」と「中身が null」のどちらにもマッチする\n\nアロケーションを避けたいなら、`IntOrDecimalNoBox` のように、中身を値型のフィールドで持つ struct の union にする必要があります（union 宣言も内部では struct ですが、中身を `object?` で持つので boxing されます）。\n\n一方、インスタンスを参照で共有したい場合や、継承を使いたい場合は class が向いています。公式ドキュメントでも、class の union は参照のセマンティクスや継承が必要な場合に便利だとされています。ただし、`[Union]` 属性は派生クラスには引き継がれず、派生クラスは union として扱われないので注意が必要です。\n\n出典：[Union types (C# reference) - Class-based union types](https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/union#class-based-union-types)\n\n\n# まとめ\n\nBenchmarkDotNet で、1,000 件の union を生成して配列に格納する処理と、switch 式で値を取り出して合計する処理を測りました（`int` と `decimal` を交互に格納）。\n\n| 処理（1,000 件） | union 宣言（`IntOrDecimal`） | カスタム union（`IntOrDecimalNoBox`） |\n|---|---:|---:|\n| 生成 | 11,944 ns / 28,000 B | 1,070 ns / 0 B |\n| switch で取り出し | 13,331 ns / 0 B | 12,746 ns / 0 B |\n\nカスタム union では、生成にかかる時間が約 `1/7`〜`1/11`（計測するたびにばらつきがあり、別の計測では 6,141 ns と 912 ns でした）、メモリアロケーションは当然 `0` なので、明らかに優秀です。逆に、switch でのパターンマッチングや値の取り出しについては、ほとんど差は出ませんでした。\n\nカスタム union は優秀ではありますが、コードは見づらく、その動作の正当性は自分で保証しなくてはならないので、カスタム union を書く際には一緒にテストを書くことは必須になると思います。\n\n基本的には union 宣言で定義して気軽に利用し、大量に生成するようなケースでは書き換える、という使い方が良いかと思います。\n\nとはいえ今のところぱっと良い使い道が思いつかず、`Result\u003cT\u003e` の union版の話題を見ながら「それホントに使いやすいのかな…」と懐疑的に見ていますが、せっかく面白い機能なので可能性を探っていきたいところです。\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T03:01:14+09:00","group":null,"id":"758db6cb12f1a83a8bf6","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"C#","versions":[]},{"name":".NET","versions":[]},{"name":"union","versions":[]}],"title":"C# 15 の union 型を ILSpy で覗いてみた","updated_at":"2026-11-18T03:01:14+09:00","url":"https://qiita.com/jun1s/items/758db6cb12f1a83a8bf6","user":{"description":"福井県越前市在住のプログラマーです。\r\n主にマイクロソフト系の技術者であり、javascript系のweb技術もフォローしています。\r\nC#、ASP.NET Core MVC(.NET 6以降)での開発を得意としています。\r\n※2024年現在、かねてより希望だったAzureとC#を使う仕事に就くことができ、そちらでてんてこまいの幸せな日々を送っております。","facebook_id":"","followees_count":20,"followers_count":161,"github_login_name":null,"id":"jun1s","items_count":94,"linkedin_id":"","location":"Echizen-shi, Fukui, Japan","name":"Jun-ichi Shinde","organization":"","permanent_id":207038,"profile_image_url":"https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/207038/profile-images/1626694207","team_only":false,"twitter_screen_name":"jun1s","website_url":""},"page_views_count":null,"team_membership":null,"organization_url_name":null,"slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003cp data-sourcepos=\"1:1-1:486\"\u003e2026-11-17 に更新された 13 ページは、大きく 3 つの方向にまとまっています。サブエージェントを誰がどう起動するかの整理、画面の前に人がいない実行（非対話・バックグラウンド・定期実行）での挙動の明記、そしてフックや定期タスクが動く条件の追記です。新しい機能の紹介というより、無人で動く場面の前提を文章で確定させる更新が目立つ日でした。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"3:1-3:111\"\u003e\n\u003cspan id=\"サブエージェントの呼び出しが提案から常時適用までの-3-段階で整理された\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%B5%E3%83%96%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%81%AE%E5%91%BC%E3%81%B3%E5%87%BA%E3%81%97%E3%81%8C%E6%8F%90%E6%A1%88%E3%81%8B%E3%82%89%E5%B8%B8%E6%99%82%E9%81%A9%E7%94%A8%E3%81%BE%E3%81%A7%E3%81%AE-3-%E6%AE%B5%E9%9A%8E%E3%81%A7%E6%95%B4%E7%90%86%E3%81%95%E3%82%8C%E3%81%9F\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eサブエージェントの呼び出しが「提案から常時適用まで」の 3 段階で整理された\u003c/h2\u003e\n\u003cp data-sourcepos=\"5:1-5:516\"\u003eサブエージェントのページ（sub-agents）には、呼び出しの強さを段階で捉える説明が加わりました。1 つ目は自然言語で名前を挙げる方法で、委任するかどうかは Claude が判断します。2 つ目は @ でサブエージェントを選ぶ方法で、その 1 回のタスクで実行するよう Claude に伝えます。3 つ目は --agent フラグまたは agent 設定で、セッション全体をそのサブエージェントとして動かします。\u003c/p\u003e\n\u003cp data-sourcepos=\"7:1-7:311\"\u003e@ で指定した場合も、入力したメッセージはそのまま Claude に渡ります。サブエージェントに渡すタスクの指示文は、Claude がそのメッセージから組み立てます。つまり @ 指定は、プロンプトをそのまま転送する機能ではありません。\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"9:1-9:106\"\u003e\n\u003cp data-sourcepos=\"9:3-9:106\"\u003eYour full message still goes to Claude, which writes the subagent's task prompt based on what you asked.\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"11:1-11:16\"\u003e（出典 [2]）\u003c/p\u003e\n\u003cp data-sourcepos=\"13:1-13:204\"\u003e（訳：入力したメッセージ全体は引き続き Claude に渡り、Claude が、あなたの依頼内容に基づいてサブエージェントへのタスクプロンプトを書きます。）\u003c/p\u003e\n\u003cp data-sourcepos=\"15:1-15:537\"\u003eAgent SDK 側のページにも対応する追記があります。プロンプト内で名前を挙げる明示的な呼び出しと、それまでの会話をコピーして引き継ぐ fork 型のサブエージェントです。説明文が具体的であるほど Claude がタスクを適切なサブエージェントに対応づけやすい、という例も載りました。モデルについては、定義したサブエージェントは既定で、起動元の会話と同じモデルで動くと記載されています。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"17:1-17:73\"\u003e\n\u003cspan id=\"sdk-とバックグラウンド実行終了前に何を待つのか\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#sdk-%E3%81%A8%E3%83%90%E3%83%83%E3%82%AF%E3%82%B0%E3%83%A9%E3%82%A6%E3%83%B3%E3%83%89%E5%AE%9F%E8%A1%8C%E7%B5%82%E4%BA%86%E5%89%8D%E3%81%AB%E4%BD%95%E3%82%92%E5%BE%85%E3%81%A4%E3%81%AE%E3%81%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eSDK とバックグラウンド実行：終了前に何を待つのか\u003c/h2\u003e\n\u003cp data-sourcepos=\"19:1-19:498\"\u003eAgent SDK のコスト追跡ページには、バックグラウンドのサブエージェントが残っている場合の扱いが追加されました。single message input mode では、最終ターンの終了時点でまだ動いているバックグラウンドのサブエージェントを待ってから結果を出力するとされています。サブエージェントのリクエストは、トップレベルのループの分と合わせて、モデル別に集計されます。\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"21:1-21:70\"\u003e\n\u003cp data-sourcepos=\"21:3-21:70\"\u003eThe wait lasts up to the cap described in background tasks at exit .\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"23:1-23:16\"\u003e（出典 [8]）\u003c/p\u003e\n\u003cp data-sourcepos=\"25:1-25:94\"\u003e（訳：待機は、background tasks at exit に記載された上限まで続きます。）\u003c/p\u003e\n\u003cp data-sourcepos=\"27:1-27:283\"\u003e上限の具体値は追加文には含まれておらず、このページからは分かりません。SDK でコストを集計している場合、結果メッセージの出力タイミングが後ろにずれ得る点は、運用側で把握しておく必要があります。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"29:1-29:69\"\u003e\n\u003cspan id=\"フックの発火条件とタイムアウトが明文化された\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%95%E3%83%83%E3%82%AF%E3%81%AE%E7%99%BA%E7%81%AB%E6%9D%A1%E4%BB%B6%E3%81%A8%E3%82%BF%E3%82%A4%E3%83%A0%E3%82%A2%E3%82%A6%E3%83%88%E3%81%8C%E6%98%8E%E6%96%87%E5%8C%96%E3%81%95%E3%82%8C%E3%81%9F\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eフックの発火条件とタイムアウトが明文化された\u003c/h2\u003e\n\u003cp data-sourcepos=\"31:1-31:270\"\u003ehooks のページでは、UserPromptSubmit フックのタイムアウトが明記されました。command、http、mcp_tool の各タイプで既定 30 秒（2026-11-17 時点）で、他の多くのイベントでの既定 600 秒より短いとされています。\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"33:1-33:101\"\u003e\n\u003cp data-sourcepos=\"33:3-33:101\"\u003eUserPromptSubmit hooks have a default timeout of 30 seconds for command , http , and mcp_tool types\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"35:1-35:16\"\u003e（出典 [1]）\u003c/p\u003e\n\u003cp data-sourcepos=\"37:1-37:143\"\u003e（訳：UserPromptSubmit フックには、command、http、mcp_tool の各タイプで 30 秒の既定タイムアウトがあります。）\u003c/p\u003e\n\u003cp data-sourcepos=\"39:1-39:885\"\u003e同じ箇所には、ユーザー入力以外で Claude Code がこのフックを走らせる場面の列挙も追加されました。セッションスコープの定期タスクの発火（/loop の各反復を含む）、バックグラウンドのサブエージェントが起動元セッションに報告を返すとき、別セッションから main の会話にメッセージが送られたとき、Code Mode セッションで Claude が実行したコードの出力です。ただし、この列挙の主語（どのフックを指すか）は追加文の冒頭に含まれていません。UserPromptSubmit の説明に続く文であることから同フックの話と読めますが、断定はできません。入力検査やログ記録をこのフックに載せている場合、人の入力以外でも発火し得る点を確認する価値があります。\u003c/p\u003e\n\u003cp data-sourcepos=\"41:1-41:283\"\u003eあわせて、Elicitation フックの説明に、ダイアログが出ない場合の切り分けが加わっています。デバッグログに「Elicitation resolved by hook:」と accept を含む行があれば、フックが応答を済ませているという意味です。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"43:1-43:57\"\u003e\n\u003cspan id=\"定期タスクの停止上限コピーの扱い\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%AE%9A%E6%9C%9F%E3%82%BF%E3%82%B9%E3%82%AF%E3%81%AE%E5%81%9C%E6%AD%A2%E4%B8%8A%E9%99%90%E3%82%B3%E3%83%94%E3%83%BC%E3%81%AE%E6%89%B1%E3%81%84\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e定期タスクの停止・上限・コピーの扱い\u003c/h2\u003e\n\u003cp data-sourcepos=\"45:1-45:109\"\u003escheduled-tasks のページには、ループの扱いに関する具体的な追記が 3 点あります。\u003c/p\u003e\n\u003cul data-sourcepos=\"47:1-50:0\"\u003e\n\u003cli data-sourcepos=\"47:1-47:167\"\u003e自己ペース（Claude が間隔を決める）のループは、次の反復を待っている間に空のプロンプトで Esc を押すと止められます。\u003c/li\u003e\n\u003cli data-sourcepos=\"48:1-48:97\"\u003eloop.md は 25,000 bytes（2026-11-17 時点）を超えた部分が切り詰められます。\u003c/li\u003e\n\u003cli data-sourcepos=\"49:1-50:0\"\u003e定期タスクのファイルを別フォルダにコピーしても、そこでは一覧に表示されるだけで実行されません。\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"51:1-51:223\"\u003e3 点目は worktree と関わります。並列セッション用に新しい worktree を作ると、コピー済みのタスクは見えても動かないため、そのフォルダで作り直す必要があります。\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"53:1-53:165\"\u003e\n\u003cp data-sourcepos=\"53:3-53:165\"\u003eIf you copy the file into another folder, such as a new worktree, sessions there list the copied tasks but don't run them, so create the task again in that folder.\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"55:1-55:16\"\u003e（出典 [9]）\u003c/p\u003e\n\u003cp data-sourcepos=\"57:1-57:274\"\u003e（訳：ファイルを新しい worktree のような別フォルダにコピーすると、そこのセッションではコピーされたタスクが一覧に出るものの実行はされないため、そのフォルダでタスクを作り直してください。）\u003c/p\u003e\n\u003cp data-sourcepos=\"59:1-59:525\"\u003eworktrees のページにも、gitignore 対象のファイル（.env など）が worktree には存在しないことを前提にしたコピー方法の節が追加されています。クラウドの定期タスクについては、スキルのページに注意が加わりました。スキルが手元の ~/.claude/skills/ にしかない場合、クラウドの定期タスクから呼ぶと見つからないと報告されます。ローカルで動いたタスクをクラウドへ移す際の落とし穴です。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"61:1-61:52\"\u003e\n\u003cspan id=\"claude--p-とクラウド実行で変わる前提\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#claude--p-%E3%81%A8%E3%82%AF%E3%83%A9%E3%82%A6%E3%83%89%E5%AE%9F%E8%A1%8C%E3%81%A7%E5%A4%89%E3%82%8F%E3%82%8B%E5%89%8D%E6%8F%90\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eclaude -p とクラウド実行で変わる前提\u003c/h2\u003e\n\u003cp data-sourcepos=\"63:1-63:98\"\u003eheadless のページでは、非対話実行で Claude に渡る情報が整理されました。\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"65:1-65:118\"\u003e\n\u003cp data-sourcepos=\"65:3-65:118\"\u003eClaude receives your prompts and the tool results without the system reminders Claude Code would add alongside them.\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"67:1-67:16\"\u003e（出典 [5]）\u003c/p\u003e\n\u003cp data-sourcepos=\"69:1-69:178\"\u003e（訳：Claude は、プロンプトとツール結果を受け取りますが、Claude Code が通常それらに添えるシステムリマインダーは付きません。）\u003c/p\u003e\n\u003cp data-sourcepos=\"71:1-71:464\"\u003e具体例として、先に編集したファイルがディスク上で変わっても Claude には通知されません。--add-dir のフォルダ由来のものを含め、利用可能なスキルの一覧も渡されません。この挙動がどの起動オプションの記述なのかは、追加文だけでは判別できません。対話セッション側でも、--ide を渡さない限り IDE への自動接続は行われないとあります。\u003c/p\u003e\n\u003cp data-sourcepos=\"73:1-73:515\"\u003eCLI リファレンスでは、--environment と組み合わせる --ref  が追加されました。新しいセッションのチェックアウトを、指定した ref を基準にします。直後に「Requires Claude Code v2.1.224 or later」とあり、例には --environment と --ref main の併用が載っていますが、この要件がどのオプションにかかるかは追加文からは確定できません。--remote は --cloud の非推奨エイリアスと記載されました。\u003c/p\u003e\n\u003cp data-sourcepos=\"75:1-75:238\"\u003epermission-modes のページでは、Code Mode をオンにした場合、Claude が書いたコードは実行前に分類器へ 1 回渡され、その内側のツール呼び出しは個別には渡されないとされています。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"77:1-77:21\"\u003e\n\u003cspan id=\"その他の更新\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%9D%E3%81%AE%E4%BB%96%E3%81%AE%E6%9B%B4%E6%96%B0\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eその他の更新\u003c/h2\u003e\n\u003cul data-sourcepos=\"79:1-83:0\"\u003e\n\u003cli data-sourcepos=\"79:1-79:243\"\u003estatusline：ステータスラインは組み込みフッターバッジの上の独立した行に表示され、バッジを置き換えません。カスタム設定時は一部のフッターヒントが表示されなくなります。\u003c/li\u003e\n\u003cli data-sourcepos=\"80:1-80:378\"\u003eenv-vars：CLAUDE_CODE_MAX_RETRIES は API リクエストの再試行回数を上書きする変数で、既定は 10 回（2026-11-17 時点）です。解決できないモデル ID の既定は 32000、上限は 128000 とされています（単位は追加文に記載なし）。リフレッシュトークンは 1 回しか使えず、交換で置き換わります。\u003c/li\u003e\n\u003cli data-sourcepos=\"81:1-81:102\"\u003esub-agents：プラグインの検証は指定したディレクトリだけを対象にします。\u003c/li\u003e\n\u003cli data-sourcepos=\"82:1-83:0\"\u003eskills、slash-commands：claude.ai と同期されたスキルは claude.ai/customize/skills/yours で管理します。\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch2 data-sourcepos=\"84:1-84:39\"\u003e\n\u003cspan id=\"この日の更新をまとめると\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%93%E3%81%AE%E6%97%A5%E3%81%AE%E6%9B%B4%E6%96%B0%E3%82%92%E3%81%BE%E3%81%A8%E3%82%81%E3%82%8B%E3%81%A8\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eこの日の更新をまとめると\u003c/h2\u003e\n\u003cp data-sourcepos=\"86:1-86:795\"\u003e影響が大きいのは、サブエージェントや定期タスク、フック、SDK を使って、人が見ていない場で Claude Code を動かしている開発者です。UserPromptSubmit フックの 30 秒タイムアウトと発火場面の拡大、claude -p でシステムリマインダーが付かないこと、worktree へコピーした定期タスクが動かないこと、ローカルのみのスキルがクラウドの定期タスクで見つからないことは、手元の対話セッションでは気づきにくい差です。一方で、待機の上限値や、一部の記述が指す対象の条件など、追加文だけでは分からない点も残っています。該当する運用がある場合は、各ページの全文で確認してください。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"88:1-88:9\"\u003e\n\u003cspan id=\"出典\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%87%BA%E5%85%B8\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e出典\u003c/h2\u003e\n\u003cp data-sourcepos=\"90:1-90:137\"\u003e本稿の引用はすべて一次資料と逐語照合（verify_article 通過）のうえ掲載しています（2026-11-18 検証）。\u003c/p\u003e\n\u003cp data-sourcepos=\"92:1-104:43\"\u003e[1] \u003ca href=\"https://code.claude.com/docs/en/hooks\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://code.claude.com/docs/en/hooks\u003c/a\u003e\u003cbr\u003e\n[2] \u003ca href=\"https://code.claude.com/docs/en/sub-agents\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://code.claude.com/docs/en/sub-agents\u003c/a\u003e\u003cbr\u003e\n[3] \u003ca href=\"https://code.claude.com/docs/en/worktrees\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://code.claude.com/docs/en/worktrees\u003c/a\u003e\u003cbr\u003e\n[4] \u003ca href=\"https://code.claude.com/docs/en/agent-sdk/subagents\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://code.claude.com/docs/en/agent-sdk/subagents\u003c/a\u003e\u003cbr\u003e\n[5] \u003ca href=\"https://code.claude.com/docs/en/headless\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://code.claude.com/docs/en/headless\u003c/a\u003e\u003cbr\u003e\n[6] \u003ca href=\"https://code.claude.com/docs/en/cli-reference\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://code.claude.com/docs/en/cli-reference\u003c/a\u003e\u003cbr\u003e\n[7] \u003ca href=\"https://code.claude.com/docs/en/statusline\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://code.claude.com/docs/en/statusline\u003c/a\u003e\u003cbr\u003e\n[8] \u003ca href=\"https://code.claude.com/docs/en/agent-sdk/cost-tracking\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://code.claude.com/docs/en/agent-sdk/cost-tracking\u003c/a\u003e\u003cbr\u003e\n[9] \u003ca href=\"https://code.claude.com/docs/en/scheduled-tasks\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://code.claude.com/docs/en/scheduled-tasks\u003c/a\u003e\u003cbr\u003e\n[10] \u003ca href=\"https://code.claude.com/docs/en/env-vars\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://code.claude.com/docs/en/env-vars\u003c/a\u003e\u003cbr\u003e\n[11] \u003ca href=\"https://code.claude.com/docs/en/permission-modes\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://code.claude.com/docs/en/permission-modes\u003c/a\u003e\u003cbr\u003e\n[12] \u003ca href=\"https://code.claude.com/docs/en/slash-commands\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://code.claude.com/docs/en/slash-commands\u003c/a\u003e\u003cbr\u003e\n[13] \u003ca href=\"https://code.claude.com/docs/en/skills\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://code.claude.com/docs/en/skills\u003c/a\u003e\u003c/p\u003e\n","body":"2026-11-17 に更新された 13 ページは、大きく 3 つの方向にまとまっています。サブエージェントを誰がどう起動するかの整理、画面の前に人がいない実行（非対話・バックグラウンド・定期実行）での挙動の明記、そしてフックや定期タスクが動く条件の追記です。新しい機能の紹介というより、無人で動く場面の前提を文章で確定させる更新が目立つ日でした。\n\n## サブエージェントの呼び出しが「提案から常時適用まで」の 3 段階で整理された\n\nサブエージェントのページ（sub-agents）には、呼び出しの強さを段階で捉える説明が加わりました。1 つ目は自然言語で名前を挙げる方法で、委任するかどうかは Claude が判断します。2 つ目は @ でサブエージェントを選ぶ方法で、その 1 回のタスクで実行するよう Claude に伝えます。3 つ目は --agent フラグまたは agent 設定で、セッション全体をそのサブエージェントとして動かします。\n\n@ で指定した場合も、入力したメッセージはそのまま Claude に渡ります。サブエージェントに渡すタスクの指示文は、Claude がそのメッセージから組み立てます。つまり @ 指定は、プロンプトをそのまま転送する機能ではありません。\n\n\u003e Your full message still goes to Claude, which writes the subagent's task prompt based on what you asked.\n\n（出典 [2]）\n\n（訳：入力したメッセージ全体は引き続き Claude に渡り、Claude が、あなたの依頼内容に基づいてサブエージェントへのタスクプロンプトを書きます。）\n\nAgent SDK 側のページにも対応する追記があります。プロンプト内で名前を挙げる明示的な呼び出しと、それまでの会話をコピーして引き継ぐ fork 型のサブエージェントです。説明文が具体的であるほど Claude がタスクを適切なサブエージェントに対応づけやすい、という例も載りました。モデルについては、定義したサブエージェントは既定で、起動元の会話と同じモデルで動くと記載されています。\n\n## SDK とバックグラウンド実行：終了前に何を待つのか\n\nAgent SDK のコスト追跡ページには、バックグラウンドのサブエージェントが残っている場合の扱いが追加されました。single message input mode では、最終ターンの終了時点でまだ動いているバックグラウンドのサブエージェントを待ってから結果を出力するとされています。サブエージェントのリクエストは、トップレベルのループの分と合わせて、モデル別に集計されます。\n\n\u003e The wait lasts up to the cap described in background tasks at exit .\n\n（出典 [8]）\n\n（訳：待機は、background tasks at exit に記載された上限まで続きます。）\n\n上限の具体値は追加文には含まれておらず、このページからは分かりません。SDK でコストを集計している場合、結果メッセージの出力タイミングが後ろにずれ得る点は、運用側で把握しておく必要があります。\n\n## フックの発火条件とタイムアウトが明文化された\n\nhooks のページでは、UserPromptSubmit フックのタイムアウトが明記されました。command、http、mcp_tool の各タイプで既定 30 秒（2026-11-17 時点）で、他の多くのイベントでの既定 600 秒より短いとされています。\n\n\u003e UserPromptSubmit hooks have a default timeout of 30 seconds for command , http , and mcp_tool types\n\n（出典 [1]）\n\n（訳：UserPromptSubmit フックには、command、http、mcp_tool の各タイプで 30 秒の既定タイムアウトがあります。）\n\n同じ箇所には、ユーザー入力以外で Claude Code がこのフックを走らせる場面の列挙も追加されました。セッションスコープの定期タスクの発火（/loop の各反復を含む）、バックグラウンドのサブエージェントが起動元セッションに報告を返すとき、別セッションから main の会話にメッセージが送られたとき、Code Mode セッションで Claude が実行したコードの出力です。ただし、この列挙の主語（どのフックを指すか）は追加文の冒頭に含まれていません。UserPromptSubmit の説明に続く文であることから同フックの話と読めますが、断定はできません。入力検査やログ記録をこのフックに載せている場合、人の入力以外でも発火し得る点を確認する価値があります。\n\nあわせて、Elicitation フックの説明に、ダイアログが出ない場合の切り分けが加わっています。デバッグログに「Elicitation resolved by hook:」と accept を含む行があれば、フックが応答を済ませているという意味です。\n\n## 定期タスクの停止・上限・コピーの扱い\n\nscheduled-tasks のページには、ループの扱いに関する具体的な追記が 3 点あります。\n\n- 自己ペース（Claude が間隔を決める）のループは、次の反復を待っている間に空のプロンプトで Esc を押すと止められます。\n- loop.md は 25,000 bytes（2026-11-17 時点）を超えた部分が切り詰められます。\n- 定期タスクのファイルを別フォルダにコピーしても、そこでは一覧に表示されるだけで実行されません。\n\n3 点目は worktree と関わります。並列セッション用に新しい worktree を作ると、コピー済みのタスクは見えても動かないため、そのフォルダで作り直す必要があります。\n\n\u003e If you copy the file into another folder, such as a new worktree, sessions there list the copied tasks but don't run them, so create the task again in that folder.\n\n（出典 [9]）\n\n（訳：ファイルを新しい worktree のような別フォルダにコピーすると、そこのセッションではコピーされたタスクが一覧に出るものの実行はされないため、そのフォルダでタスクを作り直してください。）\n\nworktrees のページにも、gitignore 対象のファイル（.env など）が worktree には存在しないことを前提にしたコピー方法の節が追加されています。クラウドの定期タスクについては、スキルのページに注意が加わりました。スキルが手元の ~/.claude/skills/ にしかない場合、クラウドの定期タスクから呼ぶと見つからないと報告されます。ローカルで動いたタスクをクラウドへ移す際の落とし穴です。\n\n## claude -p とクラウド実行で変わる前提\n\nheadless のページでは、非対話実行で Claude に渡る情報が整理されました。\n\n\u003e Claude receives your prompts and the tool results without the system reminders Claude Code would add alongside them.\n\n（出典 [5]）\n\n（訳：Claude は、プロンプトとツール結果を受け取りますが、Claude Code が通常それらに添えるシステムリマインダーは付きません。）\n\n具体例として、先に編集したファイルがディスク上で変わっても Claude には通知されません。--add-dir のフォルダ由来のものを含め、利用可能なスキルの一覧も渡されません。この挙動がどの起動オプションの記述なのかは、追加文だけでは判別できません。対話セッション側でも、--ide を渡さない限り IDE への自動接続は行われないとあります。\n\nCLI リファレンスでは、--environment と組み合わせる --ref \u003cbranch\u003e が追加されました。新しいセッションのチェックアウトを、指定した ref を基準にします。直後に「Requires Claude Code v2.1.224 or later」とあり、例には --environment と --ref main の併用が載っていますが、この要件がどのオプションにかかるかは追加文からは確定できません。--remote は --cloud の非推奨エイリアスと記載されました。\n\npermission-modes のページでは、Code Mode をオンにした場合、Claude が書いたコードは実行前に分類器へ 1 回渡され、その内側のツール呼び出しは個別には渡されないとされています。\n\n## その他の更新\n\n- statusline：ステータスラインは組み込みフッターバッジの上の独立した行に表示され、バッジを置き換えません。カスタム設定時は一部のフッターヒントが表示されなくなります。\n- env-vars：CLAUDE_CODE_MAX_RETRIES は API リクエストの再試行回数を上書きする変数で、既定は 10 回（2026-11-17 時点）です。解決できないモデル ID の既定は 32000、上限は 128000 とされています（単位は追加文に記載なし）。リフレッシュトークンは 1 回しか使えず、交換で置き換わります。\n- sub-agents：プラグインの検証は指定したディレクトリだけを対象にします。\n- skills、slash-commands：claude.ai と同期されたスキルは claude.ai/customize/skills/yours で管理します。\n\n## この日の更新をまとめると\n\n影響が大きいのは、サブエージェントや定期タスク、フック、SDK を使って、人が見ていない場で Claude Code を動かしている開発者です。UserPromptSubmit フックの 30 秒タイムアウトと発火場面の拡大、claude -p でシステムリマインダーが付かないこと、worktree へコピーした定期タスクが動かないこと、ローカルのみのスキルがクラウドの定期タスクで見つからないことは、手元の対話セッションでは気づきにくい差です。一方で、待機の上限値や、一部の記述が指す対象の条件など、追加文だけでは分からない点も残っています。該当する運用がある場合は、各ページの全文で確認してください。\n\n## 出典\n\n本稿の引用はすべて一次資料と逐語照合（verify_article 通過）のうえ掲載しています（2026-11-18 検証）。\n\n[1] https://code.claude.com/docs/en/hooks\n[2] https://code.claude.com/docs/en/sub-agents\n[3] https://code.claude.com/docs/en/worktrees\n[4] https://code.claude.com/docs/en/agent-sdk/subagents\n[5] https://code.claude.com/docs/en/headless\n[6] https://code.claude.com/docs/en/cli-reference\n[7] https://code.claude.com/docs/en/statusline\n[8] https://code.claude.com/docs/en/agent-sdk/cost-tracking\n[9] https://code.claude.com/docs/en/scheduled-tasks\n[10] https://code.claude.com/docs/en/env-vars\n[11] https://code.claude.com/docs/en/permission-modes\n[12] https://code.claude.com/docs/en/slash-commands\n[13] https://code.claude.com/docs/en/skills\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T02:56:33+09:00","group":null,"id":"e98641f8909f1167e9f2","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"ClaudeCode","versions":[]},{"name":"AI開発","versions":[]},{"name":"速報","versions":[]},{"name":"公式ドキュメント","versions":[]}],"title":"11/17 の公式ドキュメント更新：サブエージェントの呼び出しと非対話実行の前提","updated_at":"2026-11-18T02:56:33+09:00","url":"https://qiita.com/akihidem/items/e98641f8909f1167e9f2","user":{"description":null,"facebook_id":null,"followees_count":2,"followers_count":3,"github_login_name":"akihidem","id":"akihidem","items_count":205,"linkedin_id":null,"location":null,"name":"","organization":null,"permanent_id":606478,"profile_image_url":"https://avatars1.githubusercontent.com/u/62442661?v=4","team_only":false,"twitter_screen_name":null,"website_url":null},"page_views_count":null,"team_membership":null,"organization_url_name":null,"slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003cp data-sourcepos=\"1:1-1:430\"\u003eClaude Code のスキルの最初の題材として、「未コミットの変更を要約し、危ない箇所を指摘する」スキルは手頃です。公式 docs（2026-11-17 取得）も、これを最初のスキル作成例として載せています [1]。この記事は、その例を実リポジトリで使うときに外せない設計判断を、docs の記述と筆者の設計意見に分けて整理します。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"3:1-3:42\"\u003e\n\u003cspan id=\"公式例が前提にしていること\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%85%AC%E5%BC%8F%E4%BE%8B%E3%81%8C%E5%89%8D%E6%8F%90%E3%81%AB%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B%E3%81%93%E3%81%A8\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e公式例が前提にしていること\u003c/h2\u003e\n\u003cp data-sourcepos=\"5:1-5:76\"\u003e公式 docs はこの例を、次のように位置づけています [1]。\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"7:1-7:85\"\u003e\n\u003cp data-sourcepos=\"7:3-7:85\"\u003esummarizes the uncommitted changes in your git repository and flags anything risky.\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"9:1-9:597\"\u003edescription には、何が変わったかを聞かれたとき、コミットメッセージが欲しいとき、diff のレビューを頼まれたときを発動条件として書いています。本文は、Claude が diff を読む前にコマンドを実行し、出力でその行を置き換える動的コンテキスト注入を使います。指示文は、リスクの例としてエラー処理の欠落、ハードコードされた値、更新が必要なテストを挙げます。diff が空なら、未コミットの変更はないと答えさせる分岐もあります [1]。\u003c/p\u003e\n\u003cp data-sourcepos=\"11:1-11:258\"\u003eこの例は git diff HEAD の出力だけを前提にしています。git の通常の挙動として、未追跡の新規ファイルは git diff HEAD に出ません。これは docs の記述ではなく git の仕様で、手元で確認できます。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"13:1-13:66\"\u003e\n\u003cspan id=\"注入コマンドの失敗は呼び出し全体を止める\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%B3%A8%E5%85%A5%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E3%81%AE%E5%A4%B1%E6%95%97%E3%81%AF%E5%91%BC%E3%81%B3%E5%87%BA%E3%81%97%E5%85%A8%E4%BD%93%E3%82%92%E6%AD%A2%E3%82%81%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e注入コマンドの失敗は、呼び出し全体を止める\u003c/h2\u003e\n\u003cp data-sourcepos=\"15:1-15:168\"\u003edocs によると、注入コマンドが 1 つでも失敗すると、そのプレースホルダだけでなくスキル呼び出し全体が中止されます [1]。\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"17:1-17:84\"\u003e\n\u003cp data-sourcepos=\"17:3-17:84\"\u003eA failed command aborts the entire skill invocation, not just its own placeholder.\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"19:1-19:798\"\u003e既定の bash シェルでは、検索・比較系コマンドの終了コード 1 は正常結果として扱われ、2 以上は失敗です。非ゼロ終了が想定されるコマンドには、末尾に || true を付けるよう docs が案内しています。stderr は stdout にマージされ、注入テキストに含まれます。各コマンドには Bash ツールの既定タイムアウト 2 分（2026-11-17 時点）が適用されます。Bash ツールが自動でバックグラウンド化しない種類のコマンドは、タイムアウト時に強制終了されます。shell: powershell で PowerShell ツールが有効な場合、終了コード 1 を正常扱いにするコマンド群は、grep と git diff を含み、find と diff を含みません [1]。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"21:1-21:36\"\u003e\n\u003cspan id=\"出力が大きいときの扱い\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%87%BA%E5%8A%9B%E3%81%8C%E5%A4%A7%E3%81%8D%E3%81%84%E3%81%A8%E3%81%8D%E3%81%AE%E6%89%B1%E3%81%84\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e出力が大きいときの扱い\u003c/h2\u003e\n\u003cp data-sourcepos=\"23:1-23:121\"\u003e注入コマンドの出力が Bash ツールのインライン上限を超えると、次のようになります [1]。\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"25:1-25:65\"\u003e\n\u003cp data-sourcepos=\"25:3-25:65\"\u003earrives as a file path plus a short preview, not truncated text\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"27:1-27:285\"\u003e上限の具体的な数値は、本稿が参照した範囲では確認できていません。プレビューが出力のどの部分かも同様に確認できていないため、重要な情報は出力の先頭側に置くのが安全です。これは設計上の意見です。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"29:1-29:48\"\u003e\n\u003cspan id=\"会話への残り方とコンパクション\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BC%9A%E8%A9%B1%E3%81%B8%E3%81%AE%E6%AE%8B%E3%82%8A%E6%96%B9%E3%81%A8%E3%82%B3%E3%83%B3%E3%83%91%E3%82%AF%E3%82%B7%E3%83%A7%E3%83%B3\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e会話への残り方とコンパクション\u003c/h2\u003e\n\u003cp data-sourcepos=\"31:1-31:89\"\u003e描画済みの SKILL.md は会話に入り、以降のターンにも残ります [1]。\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"33:1-33:81\"\u003e\n\u003cp data-sourcepos=\"33:3-33:81\"\u003eenters the conversation as a single message and stays there across later turns.\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"35:1-35:588\"\u003e自動コンパクション時は、各スキルの直近の呼び出し結果の先頭 5,000 トークンまでが再添付されます。再添付されるスキル全体の合計予算は 25,000 トークンです（2026-11-17 時点）。そのため docs は、最重要の指示を SKILL.md の冒頭近くに置くよう案内しています。毎回必ず守らせたいルールは、スキル本文ではなく hook に移すよう案内されています。hook はイベントのたびに、スキルに従っているかどうかを問わず実行されるためです [1]。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"37:1-37:30\"\u003e\n\u003cspan id=\"無効化権限まわり\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%84%A1%E5%8A%B9%E5%8C%96%E6%A8%A9%E9%99%90%E3%81%BE%E3%82%8F%E3%82%8A\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e無効化・権限まわり\u003c/h2\u003e\n\u003cp data-sourcepos=\"39:1-39:109\"\u003eポリシーで注入コマンドが無効化されている場合の挙動は、次のとおりです [1]。\u003c/p\u003e\n\u003cblockquote data-sourcepos=\"41:1-41:82\"\u003e\n\u003cp data-sourcepos=\"41:3-41:82\"\u003ereplaced with [shell command execution disabled by policy] instead of being run.\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"43:1-43:500\"\u003edeny ルールに一致する注入コマンドは、呼び出し全体を中止させます。bare リポジトリに見えるフォルダでは、git を含む Bash コマンドに対して allowed-tools が無視されます。allowed-tools は、スキルを呼び出したターンの間だけ、列挙したツールを承認プロンプトなしで使えるようにします。リポジトリにコミットされたスキルの allowed-tools は、実行前のレビュー対象です [1]。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"45:1-45:36\"\u003e\n\u003cspan id=\"設計方針筆者の意見\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E8%A8%AD%E8%A8%88%E6%96%B9%E9%87%9D%E7%AD%86%E8%80%85%E3%81%AE%E6%84%8F%E8%A6%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e設計方針（筆者の意見）\u003c/h2\u003e\n\u003cp data-sourcepos=\"47:1-47:87\"\u003e以下は docs の記述ではなく、上の仕様から導いた設計意見です。\u003c/p\u003e\n\u003cul data-sourcepos=\"49:1-53:0\"\u003e\n\u003cli data-sourcepos=\"49:1-49:236\"\u003e注入コマンドは、想定内の状況では必ず終了コード 0 で終え、失敗は本文の目印語（INCOMPLETE、NOT_A_GIT_REPOSITORY）で伝えます。空の出力を「変更なし」と読ませないためです。\u003c/li\u003e\n\u003cli data-sourcepos=\"50:1-50:124\"\u003e出力は小さく、重要な順（秘密の疑い、status、未追跡、巨大変更、diff 本文）に並べます。\u003c/li\u003e\n\u003cli data-sourcepos=\"51:1-51:140\"\u003e秘密の値は会話に入れません。該当ファイルの本文は注入せず、ファイル名と行番号だけを出します。\u003c/li\u003e\n\u003cli data-sourcepos=\"52:1-53:0\"\u003e守らせたい硬い制約は、スキル本文の指示ではなく hook に置きます。\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"54:1-54:71\"\u003e完全な実装と動作確認の手順は、note 版で扱います。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"56:1-56:13\"\u003e\n\u003cspan id=\"references\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#references\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eReferences\u003c/h2\u003e\n\u003cp data-sourcepos=\"58:1-58:42\"\u003e[1] \u003ca href=\"https://code.claude.com/docs/en/skills\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://code.claude.com/docs/en/skills\u003c/a\u003e\u003c/p\u003e\n","body":"Claude Code のスキルの最初の題材として、「未コミットの変更を要約し、危ない箇所を指摘する」スキルは手頃です。公式 docs（2026-11-17 取得）も、これを最初のスキル作成例として載せています [1]。この記事は、その例を実リポジトリで使うときに外せない設計判断を、docs の記述と筆者の設計意見に分けて整理します。\n\n## 公式例が前提にしていること\n\n公式 docs はこの例を、次のように位置づけています [1]。\n\n\u003e summarizes the uncommitted changes in your git repository and flags anything risky.\n\ndescription には、何が変わったかを聞かれたとき、コミットメッセージが欲しいとき、diff のレビューを頼まれたときを発動条件として書いています。本文は、Claude が diff を読む前にコマンドを実行し、出力でその行を置き換える動的コンテキスト注入を使います。指示文は、リスクの例としてエラー処理の欠落、ハードコードされた値、更新が必要なテストを挙げます。diff が空なら、未コミットの変更はないと答えさせる分岐もあります [1]。\n\nこの例は git diff HEAD の出力だけを前提にしています。git の通常の挙動として、未追跡の新規ファイルは git diff HEAD に出ません。これは docs の記述ではなく git の仕様で、手元で確認できます。\n\n## 注入コマンドの失敗は、呼び出し全体を止める\n\ndocs によると、注入コマンドが 1 つでも失敗すると、そのプレースホルダだけでなくスキル呼び出し全体が中止されます [1]。\n\n\u003e A failed command aborts the entire skill invocation, not just its own placeholder.\n\n既定の bash シェルでは、検索・比較系コマンドの終了コード 1 は正常結果として扱われ、2 以上は失敗です。非ゼロ終了が想定されるコマンドには、末尾に || true を付けるよう docs が案内しています。stderr は stdout にマージされ、注入テキストに含まれます。各コマンドには Bash ツールの既定タイムアウト 2 分（2026-11-17 時点）が適用されます。Bash ツールが自動でバックグラウンド化しない種類のコマンドは、タイムアウト時に強制終了されます。shell: powershell で PowerShell ツールが有効な場合、終了コード 1 を正常扱いにするコマンド群は、grep と git diff を含み、find と diff を含みません [1]。\n\n## 出力が大きいときの扱い\n\n注入コマンドの出力が Bash ツールのインライン上限を超えると、次のようになります [1]。\n\n\u003e arrives as a file path plus a short preview, not truncated text\n\n上限の具体的な数値は、本稿が参照した範囲では確認できていません。プレビューが出力のどの部分かも同様に確認できていないため、重要な情報は出力の先頭側に置くのが安全です。これは設計上の意見です。\n\n## 会話への残り方とコンパクション\n\n描画済みの SKILL.md は会話に入り、以降のターンにも残ります [1]。\n\n\u003e enters the conversation as a single message and stays there across later turns.\n\n自動コンパクション時は、各スキルの直近の呼び出し結果の先頭 5,000 トークンまでが再添付されます。再添付されるスキル全体の合計予算は 25,000 トークンです（2026-11-17 時点）。そのため docs は、最重要の指示を SKILL.md の冒頭近くに置くよう案内しています。毎回必ず守らせたいルールは、スキル本文ではなく hook に移すよう案内されています。hook はイベントのたびに、スキルに従っているかどうかを問わず実行されるためです [1]。\n\n## 無効化・権限まわり\n\nポリシーで注入コマンドが無効化されている場合の挙動は、次のとおりです [1]。\n\n\u003e replaced with [shell command execution disabled by policy] instead of being run.\n\ndeny ルールに一致する注入コマンドは、呼び出し全体を中止させます。bare リポジトリに見えるフォルダでは、git を含む Bash コマンドに対して allowed-tools が無視されます。allowed-tools は、スキルを呼び出したターンの間だけ、列挙したツールを承認プロンプトなしで使えるようにします。リポジトリにコミットされたスキルの allowed-tools は、実行前のレビュー対象です [1]。\n\n## 設計方針（筆者の意見）\n\n以下は docs の記述ではなく、上の仕様から導いた設計意見です。\n\n- 注入コマンドは、想定内の状況では必ず終了コード 0 で終え、失敗は本文の目印語（INCOMPLETE、NOT_A_GIT_REPOSITORY）で伝えます。空の出力を「変更なし」と読ませないためです。\n- 出力は小さく、重要な順（秘密の疑い、status、未追跡、巨大変更、diff 本文）に並べます。\n- 秘密の値は会話に入れません。該当ファイルの本文は注入せず、ファイル名と行番号だけを出します。\n- 守らせたい硬い制約は、スキル本文の指示ではなく hook に置きます。\n\n完全な実装と動作確認の手順は、note 版で扱います。\n\n## References\n\n[1] https://code.claude.com/docs/en/skills\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T02:55:02+09:00","group":null,"id":"912922fbb4c68517ce2d","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"ClaudeCode","versions":[]},{"name":"AI開発","versions":[]},{"name":"実践","versions":[]}],"title":"未コミット差分の要約スキルを実リポジトリで使うための設計勘所（2026-11-17 時点）","updated_at":"2026-11-18T02:55:02+09:00","url":"https://qiita.com/akihidem/items/912922fbb4c68517ce2d","user":{"description":null,"facebook_id":null,"followees_count":2,"followers_count":3,"github_login_name":"akihidem","id":"akihidem","items_count":205,"linkedin_id":null,"location":null,"name":"","organization":null,"permanent_id":606478,"profile_image_url":"https://avatars1.githubusercontent.com/u/62442661?v=4","team_only":false,"twitter_screen_name":null,"website_url":null},"page_views_count":null,"team_membership":null,"organization_url_name":null,"slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003ch2\u003e\n\u003cspan id=\"外部リンクの死線stackpostsにbio-link生成機能を組み込むエンジニアの執念\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%A4%96%E9%83%A8%E3%83%AA%E3%83%B3%E3%82%AF%E3%81%AE%E6%AD%BB%E7%B7%9Astackposts%E3%81%ABbio-link%E7%94%9F%E6%88%90%E6%A9%9F%E8%83%BD%E3%82%92%E7%B5%84%E3%81%BF%E8%BE%BC%E3%82%80%E3%82%A8%E3%83%B3%E3%82%B8%E3%83%8B%E3%82%A2%E3%81%AE%E5%9F%B7%E5%BF%B5\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e外部リンクの死線：StackpostsにBio Link生成機能を組み込むエンジニアの執念\u003c/h2\u003e\n\u003cp data-sourcepos=\"3:1-3:30\"\u003eリンクが踏まれない。\u003c/p\u003e\n\u003cp data-sourcepos=\"5:1-5:534\"\u003e理由は残酷です。Instagram、TikTok、Threads、X――あらゆるプラットフォームが自社経済圏への囲い込みを強化し、キャプション欄のURLを踏み台にする投稿のインプレッションを容赦なく削ぎ落とすアルゴリズムを敷き詰めているからです。プロフィール欄に鎮座する「たった1行のURL」。これが、SNS上の膨大なトラフィックを自社の自社決済やリード獲得ファネルへ逃がす唯一の関門となっています。\u003c/p\u003e\n\u003cp data-sourcepos=\"7:1-7:218\"\u003eだが、毎月LinktreeやBiolink系の外部SaaSへアカウントごとに数千円の課金を垂れ流し続けるのは、代理店や自前でSaaSを回すエンジニアにとって経済的自殺に等しい。\u003c/p\u003e\n\u003cp data-sourcepos=\"9:1-9:419\"\u003eすでに稼働しているStackposts（ソーシャルメディア自動投稿・マーケティングSaaS）のバックボーンをそのまま流用し、自前のサーバー内でBio Linkビルダーを完結させられないか――そう考えて現場に投入したのが、\u003ca href=\"https://gplpal.com/product/smartbio-bio-link-builder-addon-for-stackposts/\" rel=\"nofollow noopener\" target=\"_blank\"\u003eSmartBio Bio Link Builder Addon for Stackposts\u003c/a\u003eです。\u003c/p\u003e\n\u003cp data-sourcepos=\"11:1-11:131\"\u003e実戦テストの舞台は、Ubuntu 22.04 LTS上で稼働する実案件のStackposts基盤（PHP 8.2 / Nginx / MariaDB 10.6）。\u003c/p\u003e\n\u003cp data-sourcepos=\"13:1-13:36\"\u003e先に事実を突きつけます。\u003c/p\u003e\n\u003cp data-sourcepos=\"15:1-15:105\"\u003eこれは「Zipを上げてワンクリックで全自動」という魔法の杖ではありません。\u003c/p\u003e\n\u003cp data-sourcepos=\"17:1-17:597\"\u003eStackposts本体のルーティング規則との干渉、Instagramアプリ内ブラウザ（In-App Browser）の過酷なサンドボックス、さらには絵文字満載のプロフィール文言によるデータベースの文字コード爆発。数々の地雷が埋設されています。しかし、サーバー側のパラメータとNginxのロジックを一度正しく調律してしまえば、月額課金なしで何千人ものクライアントへ「自社製バイオリンク作成SaaS」を即座に提供できる強烈なキャッシュポイントが誕生します。\u003c/p\u003e\n\u003ch2\u003e\n\u003cspan id=\"機能解体競合saasを食い尽くす3つのキラーコンポーネント\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%A9%9F%E8%83%BD%E8%A7%A3%E4%BD%93%E7%AB%B6%E5%90%88saas%E3%82%92%E9%A3%9F%E3%81%84%E5%B0%BD%E3%81%8F%E3%81%993%E3%81%A4%E3%81%AE%E3%82%AD%E3%83%A9%E3%83%BC%E3%82%B3%E3%83%B3%E3%83%9D%E3%83%BC%E3%83%8D%E3%83%B3%E3%83%88\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e機能解体：競合SaaSを食い尽くす3つのキラーコンポーネント\u003c/h2\u003e\n\u003cp data-sourcepos=\"21:1-21:243\"\u003eSmartBioは単なる「ボタンの縦並びリスト」を吐き出すツールではありません。ソーシャル運用者を顧客に持つSaaSプラットフォームとして、欲しい機能が執拗に詰め込まれています。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"リッチブロックの柔軟性静的リンクから動的メディアハブへ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%AA%E3%83%83%E3%83%81%E3%83%96%E3%83%AD%E3%83%83%E3%82%AF%E3%81%AE%E6%9F%94%E8%BB%9F%E6%80%A7%E9%9D%99%E7%9A%84%E3%83%AA%E3%83%B3%E3%82%AF%E3%81%8B%E3%82%89%E5%8B%95%E7%9A%84%E3%83%A1%E3%83%87%E3%82%A3%E3%82%A2%E3%83%8F%E3%83%96%E3%81%B8\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eリッチブロックの柔軟性：静的リンクから動的メディアハブへ\u003c/h3\u003e\n\u003cp data-sourcepos=\"25:1-25:90\"\u003e初期のバイオリンクツールはハイパーリンクを並べるだけでした。\u003c/p\u003e\n\u003cp data-sourcepos=\"27:1-27:26\"\u003eSmartBioは違います。\u003c/p\u003e\n\u003cp data-sourcepos=\"29:1-29:295\"\u003eYouTubeやVimeoの動画インライン再生、SpotifyやSoundCloudの楽曲埋め込み、問い合わせ用フォーム、FAQアコーディオン、画像ギャラリー、そして自社ECへの誘導カード。これらがドラッグ＆ドロップで自在に並び替えられます。\u003c/p\u003e\n\u003cp data-sourcepos=\"31:1-31:321\"\u003e特に動画と音楽の埋め込みは強力です。ユーザーを外部アプリへ離脱させることなく、バイオリンクの画面内にとどまらせたままコンテンツを消費させられる。滞在時間の伸長は、そのまま後述するピクセル計測の精度向上へ直結します。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"ファーストパーティアナリティクスと広告ピクセル連携\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%95%E3%82%A1%E3%83%BC%E3%82%B9%E3%83%88%E3%83%91%E3%83%BC%E3%83%86%E3%82%A3%E3%82%A2%E3%83%8A%E3%83%AA%E3%83%86%E3%82%A3%E3%82%AF%E3%82%B9%E3%81%A8%E5%BA%83%E5%91%8A%E3%83%94%E3%82%AF%E3%82%BB%E3%83%AB%E9%80%A3%E6%90%BA\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eファーストパーティ・アナリティクスと広告ピクセル連携\u003c/h3\u003e\n\u003cp data-sourcepos=\"35:1-35:96\"\u003e外部の短縮URLサービスに頼る最大のリスクは、データ主権の喪失です。\u003c/p\u003e\n\u003cp data-sourcepos=\"37:1-37:352\"\u003eSmartBioは、アクセス元リファラー、使用デバイス、ブラウザ、国別IPの位置情報を自社データベースへダイレクトに記録します。サードパーティCookieの規制が極限まで進んだ現代において、ファーストパーティの生ログを自前で保持できる価値は計り知れません。\u003c/p\u003e\n\u003cp data-sourcepos=\"39:1-39:380\"\u003eさらに、Meta Pixel（Facebook）、Google Analytics 4、TikTok Pixel、Twitter Tagをページごとに埋め込むことが可能です。SNSのプロフィールリンクを踏んだ見込み客を即座にリターゲティングオーディエンスへ放り込む設計が、コードを一切書けないエンドユーザーの画面からも数秒で完了します。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"パッケージ機能による収益モデルの構築\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E6%A9%9F%E8%83%BD%E3%81%AB%E3%82%88%E3%82%8B%E5%8F%8E%E7%9B%8A%E3%83%A2%E3%83%87%E3%83%AB%E3%81%AE%E6%A7%8B%E7%AF%89\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eパッケージ機能による収益モデルの構築\u003c/h3\u003e\n\u003cp data-sourcepos=\"43:1-43:82\"\u003eStackposts本体のサブスクリプション機能と完全に連動します。\u003c/p\u003e\n\u003cul data-sourcepos=\"45:1-47:0\"\u003e\n\u003cli data-sourcepos=\"45:1-45:147\"\u003e無料プラン：作成可能リンク数1個、基本テンプレートのみ、ページ下部に自社ブランドのクレジット表示。\u003c/li\u003e\n\u003cli data-sourcepos=\"46:1-47:0\"\u003eプロプラン：無制限のリンク作成、動的メディアブロック解禁、カスタムCSS、アナリティクス詳細閲覧、クレジット非表示。\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"48:1-48:357\"\u003eこの権限の切り分けがStackpostsの管理画面側にある「Packages」からチェックボックスのオン・オフだけで完結します。既存のSNSスケジューラーの付加価値としてBio Link機能を追加した瞬間、ユーザーの解約率（Churn Rate）が目に見えて低下するのを実感できるはずです。\u003c/p\u003e\n\u003ch2\u003e\n\u003cspan id=\"デプロイ手順stackposts環境へのアドオン統合\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%87%E3%83%97%E3%83%AD%E3%82%A4%E6%89%8B%E9%A0%86stackposts%E7%92%B0%E5%A2%83%E3%81%B8%E3%81%AE%E3%82%A2%E3%83%89%E3%82%AA%E3%83%B3%E7%B5%B1%E5%90%88\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eデプロイ手順：Stackposts環境へのアドオン統合\u003c/h2\u003e\n\u003cp data-sourcepos=\"52:1-52:108\"\u003e作業を開始する前に、インフラエンジニアとしての最低限の防衛策を講じます。\u003c/p\u003e\n\u003cp data-sourcepos=\"54:1-54:586\"\u003e私たちがクライアントワークの環境にアドオンを統合する際、ソースコードの改ざんや外部への怪しいビーコンが徹底的に排除されている \u003ca href=\"https://gplpal.com/\" rel=\"nofollow noopener\" target=\"_blank\"\u003egplpal\u003c/a\u003e からパッケージを入手しているのもそのためです。クリーンなファイル構成であることが確認できているからこそ、エラー発生時に「テーマやアドオン自体のバックドア」を疑う無駄な時間をゼロにし、サーバー環境や設定の不整合だけに集中してデバッグを進められます。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"事前要件の確認\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BA%8B%E5%89%8D%E8%A6%81%E4%BB%B6%E3%81%AE%E7%A2%BA%E8%AA%8D\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e事前要件の確認\u003c/h3\u003e\n\u003cp data-sourcepos=\"58:1-58:147\"\u003eStackpostsが正常に稼働していることが前提ですが、SmartBioを動かすには追加で以下のPHP拡張機能が不可欠です。\u003c/p\u003e\n\u003cul data-sourcepos=\"60:1-63:0\"\u003e\n\u003cli data-sourcepos=\"60:1-60:108\"\u003e\n\u003ccode\u003ephp-gd\u003c/code\u003e または \u003ccode\u003ephp-imagick\u003c/code\u003e（アバター画像のリサイズおよびQRコード生成に必須）\u003c/li\u003e\n\u003cli data-sourcepos=\"61:1-61:42\"\u003e\n\u003ccode\u003ephp-intl\u003c/code\u003e（国際化文字列処理）\u003c/li\u003e\n\u003cli data-sourcepos=\"62:1-63:0\"\u003e\n\u003ccode\u003ephp-curl\u003c/code\u003e（外部APIとの通信）\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch3\u003e\n\u003cspan id=\"インストールと有効化\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%81%A8%E6%9C%89%E5%8A%B9%E5%8C%96\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eインストールと有効化\u003c/h3\u003e\n\u003cp data-sourcepos=\"66:1-66:70\"\u003eStackpostsの管理者ダッシュボードへログインします。\u003c/p\u003e\n\u003cp data-sourcepos=\"68:1-68:484\"\u003e左側メニューの「Modules」または「Plugins」セクションを開き、ダウンロードしたアドオンパッケージのzipファイルを直接アップロードします。コマンドラインから手動で展開する場合は、\u003ccode\u003e/inc/plugins/\u003c/code\u003eまたは\u003ccode\u003e/app/modules/\u003c/code\u003e（Stackpostsのバージョン構成に準拠）へディレクトリ構造を保ったまま配置し、所有権をWebサーバーユーザー（\u003ccode\u003ewww-data\u003c/code\u003e等）へ付与してください。\u003c/p\u003e\n\u003cp data-sourcepos=\"70:1-70:74\"\u003e管理画面のモジュール一覧に「SmartBio」が出現します。\u003c/p\u003e\n\u003cp data-sourcepos=\"72:1-72:32\"\u003e「Activate」をクリック。\u003c/p\u003e\n\u003cp data-sourcepos=\"74:1-74:244\"\u003e面倒な認証キーの入力を要求されるような障壁はなく、そのままワンクリックでデータベースのマイグレーションが走り、専用のテーブル群（\u003ccode\u003esp_smartbio\u003c/code\u003eなど）が自動生成されます。\u003c/p\u003e\n\u003cp data-sourcepos=\"76:1-76:301\"\u003e最後に、管理者メニューの「Packages」を開き、ユーザーに割り当てる各プランに対して「SmartBio」の利用権限を有効化します。これを行わないと、一般ユーザーのサイドバーにメニューが表示されないので注意してください。\u003c/p\u003e\n\u003ch2\u003e\n\u003cspan id=\"現場のログから抜粋実際に直面した不具合とリカバリー記録\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%8F%BE%E5%A0%B4%E3%81%AE%E3%83%AD%E3%82%B0%E3%81%8B%E3%82%89%E6%8A%9C%E7%B2%8B%E5%AE%9F%E9%9A%9B%E3%81%AB%E7%9B%B4%E9%9D%A2%E3%81%97%E3%81%9F%E4%B8%8D%E5%85%B7%E5%90%88%E3%81%A8%E3%83%AA%E3%82%AB%E3%83%90%E3%83%AA%E3%83%BC%E8%A8%98%E9%8C%B2\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e現場のログから抜粋：実際に直面した不具合とリカバリー記録\u003c/h2\u003e\n\u003cp data-sourcepos=\"80:1-80:276\"\u003eどんなに洗練されたモジュールも、現場のインフラに組み込んだ瞬間から予期せぬ挙動を見せ始めます。私たちが実際に検証環境で頭を抱え、ログを掘り返して解決した実録トラブルシューティングです。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"公開リンクを開くとnginxが404-not-foundを吐き捨てるルーティング衝突\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%85%AC%E9%96%8B%E3%83%AA%E3%83%B3%E3%82%AF%E3%82%92%E9%96%8B%E3%81%8F%E3%81%A8nginx%E3%81%8C404-not-found%E3%82%92%E5%90%90%E3%81%8D%E6%8D%A8%E3%81%A6%E3%82%8B%E3%83%AB%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0%E8%A1%9D%E7%AA%81\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e公開リンクを開くとNginxが404 Not Foundを吐き捨てるルーティング衝突\u003c/h3\u003e\n\u003cp data-sourcepos=\"84:1-84:245\"\u003eユーザーがバイオリンクを作成し、発行されたURL（例：\u003ccode\u003eyourdomain.com/bio/username\u003c/code\u003e）にブラウザでアクセスしたところ、Stackpostsの404画面ではなくNginxの標準エラー画面が返ってきました。\u003c/p\u003e\n\u003cp data-sourcepos=\"86:1-86:387\"\u003e原因は、NginxのロケーションブロックにおけるURI書き換えルールの優先順位でした。Stackpostsのルーティングは基本的に\u003ccode\u003eindex.php\u003c/code\u003eを経由して処理されますが、アドオンが新規に追加したパス構造（\u003ccode\u003e/bio/\u003c/code\u003e）を静的ディレクトリと誤認し、ディスク上に物理ファイルを探しにいっていたのです。\u003c/p\u003e\n\u003cp data-sourcepos=\"88:1-88:68\"\u003eNginxの設定ファイルを以下のように微調整します。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"nginx\" data-sourcepos=\"90:1-99:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"k\"\u003elocation\u003c/span\u003e \u003cspan class=\"n\"\u003e/\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"kn\"\u003etry_files\u003c/span\u003e \u003cspan class=\"nv\"\u003e$uri\u003c/span\u003e \u003cspan class=\"nv\"\u003e$uri\u003c/span\u003e\u003cspan class=\"n\"\u003e/\u003c/span\u003e \u003cspan class=\"n\"\u003e/index.php?\u003c/span\u003e\u003cspan class=\"nv\"\u003e$query_string\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\n\u003cspan class=\"c1\"\u003e# bioリンク専用の内部リライト（必要な場合）\u003c/span\u003e\n\u003cspan class=\"k\"\u003elocation\u003c/span\u003e \u003cspan class=\"n\"\u003e/bio/\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"kn\"\u003etry_files\u003c/span\u003e \u003cspan class=\"nv\"\u003e$uri\u003c/span\u003e \u003cspan class=\"nv\"\u003e$uri\u003c/span\u003e\u003cspan class=\"n\"\u003e/\u003c/span\u003e \u003cspan class=\"n\"\u003e/index.php?\u003c/span\u003e\u003cspan class=\"nv\"\u003e$query_string\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"101:1-101:211\"\u003e設定をリロード（\u003ccode\u003enginx -s reload\u003c/code\u003e）した瞬間、URLは正常にSmartBioのコントローラーへルーティングされ、美しいプロフィールページがレンダリングされました。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"絵文字入りのプロフィールを保存した瞬間に走るsql-1366エラー\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%B5%B5%E6%96%87%E5%AD%97%E5%85%A5%E3%82%8A%E3%81%AE%E3%83%97%E3%83%AD%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%82%92%E4%BF%9D%E5%AD%98%E3%81%97%E3%81%9F%E7%9E%AC%E9%96%93%E3%81%AB%E8%B5%B0%E3%82%8Bsql-1366%E3%82%A8%E3%83%A9%E3%83%BC\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e絵文字入りのプロフィールを保存した瞬間に走るSQL 1366エラー\u003c/h3\u003e\n\u003cp data-sourcepos=\"105:1-105:117\"\u003e今どきのSNS運用者がプロフィールの自己紹介文に絵文字を使わないはずがありません。\u003c/p\u003e\n\u003cp data-sourcepos=\"107:1-107:242\"\u003eところが、ユーザーが「🔥フリーランス動画クリエイター🚀」といった文言を入力して保存を押すと、システムが沈黙。コンソールログには無情な500エラーが刻まれていました。\u003c/p\u003e\n\u003cp data-sourcepos=\"109:1-109:57\"\u003eデータベースのエラーログを確認します。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"111:1-113:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003eSQLSTATE[22007]: Invalid datetime format: 1366 Incorrect string value: '\\xF0\\x9F\\x94\\xA5...' for column 'description'\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"115:1-115:245\"\u003e典型的な文字コードの不整合です。SmartBioが自動生成したデータベーステーブルのデフォルトCollationが、4バイトUTF-8（\u003ccode\u003eutf8mb4\u003c/code\u003e）ではなく古い3バイトの\u003ccode\u003eutf8_general_ci\u003c/code\u003eになっていました。\u003c/p\u003e\n\u003cp data-sourcepos=\"117:1-117:108\"\u003ephpMyAdminまたはMySQLコンソールから該当テーブルの文字コードを強制変更します。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"sql\" data-sourcepos=\"119:1-122:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"k\"\u003eALTER\u003c/span\u003e \u003cspan class=\"k\"\u003eTABLE\u003c/span\u003e \u003cspan class=\"n\"\u003esp_smartbio\u003c/span\u003e \u003cspan class=\"k\"\u003eCONVERT\u003c/span\u003e \u003cspan class=\"k\"\u003eTO\u003c/span\u003e \u003cspan class=\"nb\"\u003eCHARACTER\u003c/span\u003e \u003cspan class=\"k\"\u003eSET\u003c/span\u003e \u003cspan class=\"n\"\u003eutf8mb4\u003c/span\u003e \u003cspan class=\"k\"\u003eCOLLATE\u003c/span\u003e \u003cspan class=\"n\"\u003eutf8mb4_unicode_ci\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003cspan class=\"k\"\u003eALTER\u003c/span\u003e \u003cspan class=\"k\"\u003eTABLE\u003c/span\u003e \u003cspan class=\"n\"\u003esp_smartbio_links\u003c/span\u003e \u003cspan class=\"k\"\u003eCONVERT\u003c/span\u003e \u003cspan class=\"k\"\u003eTO\u003c/span\u003e \u003cspan class=\"nb\"\u003eCHARACTER\u003c/span\u003e \u003cspan class=\"k\"\u003eSET\u003c/span\u003e \u003cspan class=\"n\"\u003eutf8mb4\u003c/span\u003e \u003cspan class=\"k\"\u003eCOLLATE\u003c/span\u003e \u003cspan class=\"n\"\u003eutf8mb4_unicode_ci\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"124:1-124:108\"\u003eこれで、絵文字をいくら詰め込んでも例外が投げられることはなくなりました。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"アナリティクスの訪問地域がすべて米国cloudflareに偽装される現象\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%A2%E3%83%8A%E3%83%AA%E3%83%86%E3%82%A3%E3%82%AF%E3%82%B9%E3%81%AE%E8%A8%AA%E5%95%8F%E5%9C%B0%E5%9F%9F%E3%81%8C%E3%81%99%E3%81%B9%E3%81%A6%E7%B1%B3%E5%9B%BDcloudflare%E3%81%AB%E5%81%BD%E8%A3%85%E3%81%95%E3%82%8C%E3%82%8B%E7%8F%BE%E8%B1%A1\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eアナリティクスの訪問地域がすべて「米国・Cloudflare」に偽装される現象\u003c/h3\u003e\n\u003cp data-sourcepos=\"128:1-128:93\"\u003eアクセス解析の画面を開いたとき、明らかな違和感に襲われました。\u003c/p\u003e\n\u003cp data-sourcepos=\"130:1-130:206\"\u003e日本国内の社内端末からテストアクセスを繰り返しているにもかかわらず、ダッシュボード上の国別グラフが100%「United States」と記録されていたのです。\u003c/p\u003e\n\u003cp data-sourcepos=\"132:1-132:256\"\u003e犯人はリバースプロキシです。サーバーの前段にCloudflareを噛ませていたため、PHPの\u003ccode\u003e$_SERVER['REMOTE_ADDR']\u003c/code\u003eが訪問者の本当のIPではなく、CloudflareのエッジサーバーのIPアドレスを拾っていました。\u003c/p\u003e\n\u003cp data-sourcepos=\"134:1-134:167\"\u003eSmartBioのコアファイル、またはStackposts共通のヘルパー関数内のIP取得ロジックを確認し、ヘッダーの優先順位を修正します。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"php\" data-sourcepos=\"136:1-147:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"k\"\u003efunction\u003c/span\u003e \u003cspan class=\"n\"\u003eget_real_client_ip\u003c/span\u003e\u003cspan class=\"p\"\u003e()\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eif\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"o\"\u003e!\u003c/span\u003e\u003cspan class=\"k\"\u003eempty\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"nv\"\u003e$_SERVER\u003c/span\u003e\u003cspan class=\"p\"\u003e[\u003c/span\u003e\u003cspan class=\"s1\"\u003e'HTTP_CF_CONNECTING_IP'\u003c/span\u003e\u003cspan class=\"p\"\u003e]))\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n        \u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"nv\"\u003e$_SERVER\u003c/span\u003e\u003cspan class=\"p\"\u003e[\u003c/span\u003e\u003cspan class=\"s1\"\u003e'HTTP_CF_CONNECTING_IP'\u003c/span\u003e\u003cspan class=\"p\"\u003e];\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eif\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"o\"\u003e!\u003c/span\u003e\u003cspan class=\"k\"\u003eempty\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"nv\"\u003e$_SERVER\u003c/span\u003e\u003cspan class=\"p\"\u003e[\u003c/span\u003e\u003cspan class=\"s1\"\u003e'HTTP_X_FORWARDED_FOR'\u003c/span\u003e\u003cspan class=\"p\"\u003e]))\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n        \u003cspan class=\"nv\"\u003e$ip_list\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"nb\"\u003eexplode\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"s1\"\u003e','\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"nv\"\u003e$_SERVER\u003c/span\u003e\u003cspan class=\"p\"\u003e[\u003c/span\u003e\u003cspan class=\"s1\"\u003e'HTTP_X_FORWARDED_FOR'\u003c/span\u003e\u003cspan class=\"p\"\u003e]);\u003c/span\u003e\n        \u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"nb\"\u003etrim\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"nv\"\u003e$ip_list\u003c/span\u003e\u003cspan class=\"p\"\u003e[\u003c/span\u003e\u003cspan class=\"mi\"\u003e0\u003c/span\u003e\u003cspan class=\"p\"\u003e]);\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n    \u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"nv\"\u003e$_SERVER\u003c/span\u003e\u003cspan class=\"p\"\u003e[\u003c/span\u003e\u003cspan class=\"s1\"\u003e'REMOTE_ADDR'\u003c/span\u003e\u003cspan class=\"p\"\u003e];\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"149:1-149:198\"\u003eこの修正を入れた直後から、来訪者の正確な都道府県や市区町村レベルの位置データがダッシュボードへ正しくプロットされるようになりました。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"スマホのinstagramアプリ内ブラウザiabで動画が再生されないトラブル\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%B9%E3%83%9E%E3%83%9B%E3%81%AEinstagram%E3%82%A2%E3%83%97%E3%83%AA%E5%86%85%E3%83%96%E3%83%A9%E3%82%A6%E3%82%B6iab%E3%81%A7%E5%8B%95%E7%94%BB%E3%81%8C%E5%86%8D%E7%94%9F%E3%81%95%E3%82%8C%E3%81%AA%E3%81%84%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eスマホのInstagramアプリ内ブラウザ（IAB）で動画が再生されないトラブル\u003c/h3\u003e\n\u003cp data-sourcepos=\"153:1-153:214\"\u003e外部のSafariやChromeでは完璧に動いているYouTube埋め込みが、Instagramのアプリ内ブラウザで開いたときだけ黒い画面のままフリーズするクレームが発生しました。\u003c/p\u003e\n\u003cp data-sourcepos=\"155:1-155:454\"\u003eアプリ内ブラウザ特有の厳しいCSP（コンテンツセキュリティポリシー）と、サードパーティCookieの自動ブロックが原因でした。埋め込みコードのiframeに対して\u003ccode\u003eallow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\"\u003c/code\u003e属性が不足しており、さらにHTTPSの混在コンテンツ（Mixed Content）が微小に含まれていたためです。\u003c/p\u003e\n\u003cp data-sourcepos=\"157:1-157:286\"\u003eテンプレート側のiframeタグ生成ロジックを見直し、\u003ccode\u003esandbox\u003c/code\u003e属性と\u003ccode\u003eallow\u003c/code\u003e属性を明示的に付与するコードへ書き換えることで、アプリ内ブラウザでも引っかかりなくインライン動画が再生されることを確認しました。\u003c/p\u003e\n\u003ch2\u003e\n\u003cspan id=\"2026年の検索aiエコシステムにおけるバイオリンクの生存戦略\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#2026%E5%B9%B4%E3%81%AE%E6%A4%9C%E7%B4%A2ai%E3%82%A8%E3%82%B3%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E3%81%AB%E3%81%8A%E3%81%91%E3%82%8B%E3%83%90%E3%82%A4%E3%82%AA%E3%83%AA%E3%83%B3%E3%82%AF%E3%81%AE%E7%94%9F%E5%AD%98%E6%88%A6%E7%95%A5\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e2026年の検索・AIエコシステムにおけるバイオリンクの生存戦略\u003c/h2\u003e\n\u003cp data-sourcepos=\"161:1-161:57\"\u003e検索とSNSの境界線はすでに崩壊しました。\u003c/p\u003e\n\u003cp data-sourcepos=\"163:1-163:286\"\u003eTikTokやInstagramが検索エンジンとして使われる一方、GoogleのSGE（Search Generative Experience）や各種AI検索エージェントは、個人の権威性（E-E-A-T）を検証するためにSNSのバイオリンクを横断的にクローリングしています。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"セマンティックなschemaorgprofilepageマークアップ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%BB%E3%83%9E%E3%83%B3%E3%83%86%E3%82%A3%E3%83%83%E3%82%AF%E3%81%AAschemaorgprofilepage%E3%83%9E%E3%83%BC%E3%82%AF%E3%82%A2%E3%83%83%E3%83%97\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eセマンティックなSchema.org（ProfilePage）マークアップ\u003c/h3\u003e\n\u003cp data-sourcepos=\"167:1-167:214\"\u003eAIクローラーがあなたのバイオリンクを踏んだとき、そこに何が書かれているかを正確に機械可読な形で提示できなければ、AIの回答ソースから除外されます。\u003c/p\u003e\n\u003cp data-sourcepos=\"169:1-169:157\"\u003eSmartBioの出力テンプレートの\u003ccode\u003e\u0026lt;head\u0026gt;\u003c/code\u003eセクションへ、以下のような構造化データを流し込むカスタマイズを推奨します。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"html\" data-sourcepos=\"171:1-188:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"nt\"\u003e\u0026lt;script \u003c/span\u003e\u003cspan class=\"na\"\u003etype=\u003c/span\u003e\u003cspan class=\"s\"\u003e\"application/ld+json\"\u003c/span\u003e\u003cspan class=\"nt\"\u003e\u0026gt;\u003c/span\u003e\n\u003cspan class=\"p\"\u003e{\u003c/span\u003e\n  \u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"s2\"\u003e@context\u003c/span\u003e\u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"s2\"\u003ehttps://schema.org\u003c/span\u003e\u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n  \u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"s2\"\u003e@type\u003c/span\u003e\u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"s2\"\u003eProfilePage\u003c/span\u003e\u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n  \u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"s2\"\u003emainEntity\u003c/span\u003e\u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"s2\"\u003e@type\u003c/span\u003e\u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"s2\"\u003ePerson\u003c/span\u003e\u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"s2\"\u003ename\u003c/span\u003e\u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"s2\"\u003eCreator Name\u003c/span\u003e\u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"s2\"\u003eurl\u003c/span\u003e\u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"s2\"\u003ehttps://yourdomain.com/bio/creator\u003c/span\u003e\u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"s2\"\u003esameAs\u003c/span\u003e\u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"p\"\u003e[\u003c/span\u003e\n      \u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"s2\"\u003ehttps://twitter.com/creator\u003c/span\u003e\u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n      \u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"s2\"\u003ehttps://instagram.com/creator\u003c/span\u003e\u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n      \u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\u003cspan class=\"s2\"\u003ehttps://youtube.com/@creator\u003c/span\u003e\u003cspan class=\"dl\"\u003e\"\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e]\u003c/span\u003e\n  \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003cspan class=\"nt\"\u003e\u0026lt;/script\u0026gt;\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"190:1-190:286\"\u003eこのマークアップが存在することで、AIエージェントは「この人物がどのSNSの公式オーナーであるか」を瞬時に名寄せし、検索結果のナレッジグラフやAI回答時の参照元リンクとして採用する確率を跳ね上げます。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"core-web-vitalsinp-50ms以下を叩き出す軽量化\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#core-web-vitalsinp-50ms%E4%BB%A5%E4%B8%8B%E3%82%92%E5%8F%A9%E3%81%8D%E5%87%BA%E3%81%99%E8%BB%BD%E9%87%8F%E5%8C%96\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eCore Web Vitals：INP 50ms以下を叩き出す軽量化\u003c/h3\u003e\n\u003cp data-sourcepos=\"194:1-194:229\"\u003eモバイルの回線速度は常に不安定です。満員電車の中でInstagramを開き、プロフィールリンクをタップしたユーザーは、ページの表示に2秒以上かかった瞬間に離脱します。\u003c/p\u003e\n\u003cp data-sourcepos=\"196:1-196:98\"\u003eSmartBioはデフォルトで無駄なjQueryライブラリを多重読み込みしがちです。\u003c/p\u003e\n\u003cp data-sourcepos=\"198:1-198:462\"\u003eアセットの最適化として、不要なアイコンフォントの読み込みを間引き、SVGアイコンへインライン置換。さらにCSSを1つの圧縮ファイルへ結合することで、モバイル環境におけるINP（Interaction to Next Paint）を40ms前後に抑え込みました。指が触れた瞬間に画面が反応する。この速度こそが、コンバージョン率を物理的に底上げする最強の武器です。\u003c/p\u003e\n\u003ch2\u003e\n\u003cspan id=\"導入すべきか見送るべきかエンジニアの最終ジャッジ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%B0%8E%E5%85%A5%E3%81%99%E3%81%B9%E3%81%8D%E3%81%8B%E8%A6%8B%E9%80%81%E3%82%8B%E3%81%B9%E3%81%8D%E3%81%8B%E3%82%A8%E3%83%B3%E3%82%B8%E3%83%8B%E3%82%A2%E3%81%AE%E6%9C%80%E7%B5%82%E3%82%B8%E3%83%A3%E3%83%83%E3%82%B8\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e導入すべきか、見送るべきか：エンジニアの最終ジャッジ\u003c/h2\u003e\n\u003cp data-sourcepos=\"202:1-202:78\"\u003eすべての人にこのアドオンを勧めるつもりはありません。\u003c/p\u003e\n\u003cp data-sourcepos=\"204:1-204:328\"\u003e自分のアカウント1つだけでシンプルなリンク集を作りたいだけの個人インフルエンサーなら、無料の外部サービスを使い倒した方がインフラの保守コストを考えれば合理的です。サーバーのログを見るのが嫌いな人は手を出してはいけません。\u003c/p\u003e\n\u003cp data-sourcepos=\"206:1-206:57\"\u003eだが、以下に当てはまるなら話は別です。\u003c/p\u003e\n\u003col data-sourcepos=\"208:1-211:0\"\u003e\n\u003cli data-sourcepos=\"208:1-208:140\"\u003e自分のStackposts環境をすでに所有しており、ユーザーへの提供価値を一気に引き上げたいSaaSオーナー。\u003c/li\u003e\n\u003cli data-sourcepos=\"209:1-209:159\"\u003e多数のクライアントのアカウントを一括管理し、月額のツール費用を根本から圧縮したいWebマーケティング代理店。\u003c/li\u003e\n\u003cli data-sourcepos=\"210:1-211:0\"\u003e顧客データやピクセル情報を自社のサーバー内で完全に統制・防衛したいデータ主権重視のエンジニア。\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp data-sourcepos=\"212:1-212:242\"\u003eこの条件に合致するなら、SmartBioは投じたわずかなセットアップ工数を瞬時にペイし、自社プラットフォームの収益力を次の次元へ押し上げる強力無比なエンジンとなるはずです。\u003c/p\u003e\n","body":"\u003ch2\u003e外部リンクの死線：StackpostsにBio Link生成機能を組み込むエンジニアの執念\u003c/h2\u003e\n\nリンクが踏まれない。\n\n理由は残酷です。Instagram、TikTok、Threads、X――あらゆるプラットフォームが自社経済圏への囲い込みを強化し、キャプション欄のURLを踏み台にする投稿のインプレッションを容赦なく削ぎ落とすアルゴリズムを敷き詰めているからです。プロフィール欄に鎮座する「たった1行のURL」。これが、SNS上の膨大なトラフィックを自社の自社決済やリード獲得ファネルへ逃がす唯一の関門となっています。\n\nだが、毎月LinktreeやBiolink系の外部SaaSへアカウントごとに数千円の課金を垂れ流し続けるのは、代理店や自前でSaaSを回すエンジニアにとって経済的自殺に等しい。\n\nすでに稼働しているStackposts（ソーシャルメディア自動投稿・マーケティングSaaS）のバックボーンをそのまま流用し、自前のサーバー内でBio Linkビルダーを完結させられないか――そう考えて現場に投入したのが、[SmartBio Bio Link Builder Addon for Stackposts](https://gplpal.com/product/smartbio-bio-link-builder-addon-for-stackposts/)です。\n\n実戦テストの舞台は、Ubuntu 22.04 LTS上で稼働する実案件のStackposts基盤（PHP 8.2 / Nginx / MariaDB 10.6）。\n\n先に事実を突きつけます。\n\nこれは「Zipを上げてワンクリックで全自動」という魔法の杖ではありません。\n\nStackposts本体のルーティング規則との干渉、Instagramアプリ内ブラウザ（In-App Browser）の過酷なサンドボックス、さらには絵文字満載のプロフィール文言によるデータベースの文字コード爆発。数々の地雷が埋設されています。しかし、サーバー側のパラメータとNginxのロジックを一度正しく調律してしまえば、月額課金なしで何千人ものクライアントへ「自社製バイオリンク作成SaaS」を即座に提供できる強烈なキャッシュポイントが誕生します。\n\n\u003ch2\u003e機能解体：競合SaaSを食い尽くす3つのキラーコンポーネント\u003c/h2\u003e\n\nSmartBioは単なる「ボタンの縦並びリスト」を吐き出すツールではありません。ソーシャル運用者を顧客に持つSaaSプラットフォームとして、欲しい機能が執拗に詰め込まれています。\n\n\u003ch3\u003eリッチブロックの柔軟性：静的リンクから動的メディアハブへ\u003c/h3\u003e\n\n初期のバイオリンクツールはハイパーリンクを並べるだけでした。\n\nSmartBioは違います。\n\nYouTubeやVimeoの動画インライン再生、SpotifyやSoundCloudの楽曲埋め込み、問い合わせ用フォーム、FAQアコーディオン、画像ギャラリー、そして自社ECへの誘導カード。これらがドラッグ＆ドロップで自在に並び替えられます。\n\n特に動画と音楽の埋め込みは強力です。ユーザーを外部アプリへ離脱させることなく、バイオリンクの画面内にとどまらせたままコンテンツを消費させられる。滞在時間の伸長は、そのまま後述するピクセル計測の精度向上へ直結します。\n\n\u003ch3\u003eファーストパーティ・アナリティクスと広告ピクセル連携\u003c/h3\u003e\n\n外部の短縮URLサービスに頼る最大のリスクは、データ主権の喪失です。\n\nSmartBioは、アクセス元リファラー、使用デバイス、ブラウザ、国別IPの位置情報を自社データベースへダイレクトに記録します。サードパーティCookieの規制が極限まで進んだ現代において、ファーストパーティの生ログを自前で保持できる価値は計り知れません。\n\nさらに、Meta Pixel（Facebook）、Google Analytics 4、TikTok Pixel、Twitter Tagをページごとに埋め込むことが可能です。SNSのプロフィールリンクを踏んだ見込み客を即座にリターゲティングオーディエンスへ放り込む設計が、コードを一切書けないエンドユーザーの画面からも数秒で完了します。\n\n\u003ch3\u003eパッケージ機能による収益モデルの構築\u003c/h3\u003e\n\nStackposts本体のサブスクリプション機能と完全に連動します。\n\n* 無料プラン：作成可能リンク数1個、基本テンプレートのみ、ページ下部に自社ブランドのクレジット表示。\n* プロプラン：無制限のリンク作成、動的メディアブロック解禁、カスタムCSS、アナリティクス詳細閲覧、クレジット非表示。\n\nこの権限の切り分けがStackpostsの管理画面側にある「Packages」からチェックボックスのオン・オフだけで完結します。既存のSNSスケジューラーの付加価値としてBio Link機能を追加した瞬間、ユーザーの解約率（Churn Rate）が目に見えて低下するのを実感できるはずです。\n\n\u003ch2\u003eデプロイ手順：Stackposts環境へのアドオン統合\u003c/h2\u003e\n\n作業を開始する前に、インフラエンジニアとしての最低限の防衛策を講じます。\n\n私たちがクライアントワークの環境にアドオンを統合する際、ソースコードの改ざんや外部への怪しいビーコンが徹底的に排除されている [gplpal](https://gplpal.com/) からパッケージを入手しているのもそのためです。クリーンなファイル構成であることが確認できているからこそ、エラー発生時に「テーマやアドオン自体のバックドア」を疑う無駄な時間をゼロにし、サーバー環境や設定の不整合だけに集中してデバッグを進められます。\n\n\u003ch3\u003e事前要件の確認\u003c/h3\u003e\n\nStackpostsが正常に稼働していることが前提ですが、SmartBioを動かすには追加で以下のPHP拡張機能が不可欠です。\n\n* `php-gd` または `php-imagick`（アバター画像のリサイズおよびQRコード生成に必須）\n* `php-intl`（国際化文字列処理）\n* `php-curl`（外部APIとの通信）\n\n\u003ch3\u003eインストールと有効化\u003c/h3\u003e\n\nStackpostsの管理者ダッシュボードへログインします。\n\n左側メニューの「Modules」または「Plugins」セクションを開き、ダウンロードしたアドオンパッケージのzipファイルを直接アップロードします。コマンドラインから手動で展開する場合は、`/inc/plugins/`または`/app/modules/`（Stackpostsのバージョン構成に準拠）へディレクトリ構造を保ったまま配置し、所有権をWebサーバーユーザー（`www-data`等）へ付与してください。\n\n管理画面のモジュール一覧に「SmartBio」が出現します。\n\n「Activate」をクリック。\n\n面倒な認証キーの入力を要求されるような障壁はなく、そのままワンクリックでデータベースのマイグレーションが走り、専用のテーブル群（`sp_smartbio`など）が自動生成されます。\n\n最後に、管理者メニューの「Packages」を開き、ユーザーに割り当てる各プランに対して「SmartBio」の利用権限を有効化します。これを行わないと、一般ユーザーのサイドバーにメニューが表示されないので注意してください。\n\n\u003ch2\u003e現場のログから抜粋：実際に直面した不具合とリカバリー記録\u003c/h2\u003e\n\nどんなに洗練されたモジュールも、現場のインフラに組み込んだ瞬間から予期せぬ挙動を見せ始めます。私たちが実際に検証環境で頭を抱え、ログを掘り返して解決した実録トラブルシューティングです。\n\n\u003ch3\u003e公開リンクを開くとNginxが404 Not Foundを吐き捨てるルーティング衝突\u003c/h3\u003e\n\nユーザーがバイオリンクを作成し、発行されたURL（例：`yourdomain.com/bio/username`）にブラウザでアクセスしたところ、Stackpostsの404画面ではなくNginxの標準エラー画面が返ってきました。\n\n原因は、NginxのロケーションブロックにおけるURI書き換えルールの優先順位でした。Stackpostsのルーティングは基本的に`index.php`を経由して処理されますが、アドオンが新規に追加したパス構造（`/bio/`）を静的ディレクトリと誤認し、ディスク上に物理ファイルを探しにいっていたのです。\n\nNginxの設定ファイルを以下のように微調整します。\n\n```nginx\nlocation / {\n    try_files $uri $uri/ /index.php?$query_string;\n}\n\n# bioリンク専用の内部リライト（必要な場合）\nlocation /bio/ {\n    try_files $uri $uri/ /index.php?$query_string;\n}\n```\n\n設定をリロード（`nginx -s reload`）した瞬間、URLは正常にSmartBioのコントローラーへルーティングされ、美しいプロフィールページがレンダリングされました。\n\n\u003ch3\u003e絵文字入りのプロフィールを保存した瞬間に走るSQL 1366エラー\u003c/h3\u003e\n\n今どきのSNS運用者がプロフィールの自己紹介文に絵文字を使わないはずがありません。\n\nところが、ユーザーが「🔥フリーランス動画クリエイター🚀」といった文言を入力して保存を押すと、システムが沈黙。コンソールログには無情な500エラーが刻まれていました。\n\nデータベースのエラーログを確認します。\n\n```text\nSQLSTATE[22007]: Invalid datetime format: 1366 Incorrect string value: '\\xF0\\x9F\\x94\\xA5...' for column 'description'\n```\n\n典型的な文字コードの不整合です。SmartBioが自動生成したデータベーステーブルのデフォルトCollationが、4バイトUTF-8（`utf8mb4`）ではなく古い3バイトの`utf8_general_ci`になっていました。\n\nphpMyAdminまたはMySQLコンソールから該当テーブルの文字コードを強制変更します。\n\n```sql\nALTER TABLE sp_smartbio CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;\nALTER TABLE sp_smartbio_links CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;\n```\n\nこれで、絵文字をいくら詰め込んでも例外が投げられることはなくなりました。\n\n\u003ch3\u003eアナリティクスの訪問地域がすべて「米国・Cloudflare」に偽装される現象\u003c/h3\u003e\n\nアクセス解析の画面を開いたとき、明らかな違和感に襲われました。\n\n日本国内の社内端末からテストアクセスを繰り返しているにもかかわらず、ダッシュボード上の国別グラフが100%「United States」と記録されていたのです。\n\n犯人はリバースプロキシです。サーバーの前段にCloudflareを噛ませていたため、PHPの`$_SERVER['REMOTE_ADDR']`が訪問者の本当のIPではなく、CloudflareのエッジサーバーのIPアドレスを拾っていました。\n\nSmartBioのコアファイル、またはStackposts共通のヘルパー関数内のIP取得ロジックを確認し、ヘッダーの優先順位を修正します。\n\n```php\nfunction get_real_client_ip() {\n    if (!empty($_SERVER['HTTP_CF_CONNECTING_IP'])) {\n        return $_SERVER['HTTP_CF_CONNECTING_IP'];\n    }\n    if (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {\n        $ip_list = explode(',', $_SERVER['HTTP_X_FORWARDED_FOR']);\n        return trim($ip_list[0]);\n    }\n    return $_SERVER['REMOTE_ADDR'];\n}\n```\n\nこの修正を入れた直後から、来訪者の正確な都道府県や市区町村レベルの位置データがダッシュボードへ正しくプロットされるようになりました。\n\n\u003ch3\u003eスマホのInstagramアプリ内ブラウザ（IAB）で動画が再生されないトラブル\u003c/h3\u003e\n\n外部のSafariやChromeでは完璧に動いているYouTube埋め込みが、Instagramのアプリ内ブラウザで開いたときだけ黒い画面のままフリーズするクレームが発生しました。\n\nアプリ内ブラウザ特有の厳しいCSP（コンテンツセキュリティポリシー）と、サードパーティCookieの自動ブロックが原因でした。埋め込みコードのiframeに対して`allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\"`属性が不足しており、さらにHTTPSの混在コンテンツ（Mixed Content）が微小に含まれていたためです。\n\nテンプレート側のiframeタグ生成ロジックを見直し、`sandbox`属性と`allow`属性を明示的に付与するコードへ書き換えることで、アプリ内ブラウザでも引っかかりなくインライン動画が再生されることを確認しました。\n\n\u003ch2\u003e2026年の検索・AIエコシステムにおけるバイオリンクの生存戦略\u003c/h2\u003e\n\n検索とSNSの境界線はすでに崩壊しました。\n\nTikTokやInstagramが検索エンジンとして使われる一方、GoogleのSGE（Search Generative Experience）や各種AI検索エージェントは、個人の権威性（E-E-A-T）を検証するためにSNSのバイオリンクを横断的にクローリングしています。\n\n\u003ch3\u003eセマンティックなSchema.org（ProfilePage）マークアップ\u003c/h3\u003e\n\nAIクローラーがあなたのバイオリンクを踏んだとき、そこに何が書かれているかを正確に機械可読な形で提示できなければ、AIの回答ソースから除外されます。\n\nSmartBioの出力テンプレートの`\u003chead\u003e`セクションへ、以下のような構造化データを流し込むカスタマイズを推奨します。\n\n```html\n\u003cscript type=\"application/ld+json\"\u003e\n{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"ProfilePage\",\n  \"mainEntity\": {\n    \"@type\": \"Person\",\n    \"name\": \"Creator Name\",\n    \"url\": \"https://yourdomain.com/bio/creator\",\n    \"sameAs\": [\n      \"https://twitter.com/creator\",\n      \"https://instagram.com/creator\",\n      \"https://youtube.com/@creator\"\n    ]\n  }\n}\n\u003c/script\u003e\n```\n\nこのマークアップが存在することで、AIエージェントは「この人物がどのSNSの公式オーナーであるか」を瞬時に名寄せし、検索結果のナレッジグラフやAI回答時の参照元リンクとして採用する確率を跳ね上げます。\n\n\u003ch3\u003eCore Web Vitals：INP 50ms以下を叩き出す軽量化\u003c/h3\u003e\n\nモバイルの回線速度は常に不安定です。満員電車の中でInstagramを開き、プロフィールリンクをタップしたユーザーは、ページの表示に2秒以上かかった瞬間に離脱します。\n\nSmartBioはデフォルトで無駄なjQueryライブラリを多重読み込みしがちです。\n\nアセットの最適化として、不要なアイコンフォントの読み込みを間引き、SVGアイコンへインライン置換。さらにCSSを1つの圧縮ファイルへ結合することで、モバイル環境におけるINP（Interaction to Next Paint）を40ms前後に抑え込みました。指が触れた瞬間に画面が反応する。この速度こそが、コンバージョン率を物理的に底上げする最強の武器です。\n\n\u003ch2\u003e導入すべきか、見送るべきか：エンジニアの最終ジャッジ\u003c/h2\u003e\n\nすべての人にこのアドオンを勧めるつもりはありません。\n\n自分のアカウント1つだけでシンプルなリンク集を作りたいだけの個人インフルエンサーなら、無料の外部サービスを使い倒した方がインフラの保守コストを考えれば合理的です。サーバーのログを見るのが嫌いな人は手を出してはいけません。\n\nだが、以下に当てはまるなら話は別です。\n\n1. 自分のStackposts環境をすでに所有しており、ユーザーへの提供価値を一気に引き上げたいSaaSオーナー。\n2. 多数のクライアントのアカウントを一括管理し、月額のツール費用を根本から圧縮したいWebマーケティング代理店。\n3. 顧客データやピクセル情報を自社のサーバー内で完全に統制・防衛したいデータ主権重視のエンジニア。\n\nこの条件に合致するなら、SmartBioは投じたわずかなセットアップ工数を瞬時にペイし、自社プラットフォームの収益力を次の次元へ押し上げる強力無比なエンジンとなるはずです。\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T02:48:33+09:00","group":null,"id":"16f95e98f50d24a604ba","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"PHP","versions":[]}],"title":"SmartBio Bio Link Builder Addon for Stackposts徹底検証：導入と不具合回避","updated_at":"2026-11-18T02:48:33+09:00","url":"https://qiita.com/gplpal/items/16f95e98f50d24a604ba","user":{"description":null,"facebook_id":null,"followees_count":1,"followers_count":0,"github_login_name":null,"id":"gplpal","items_count":25,"linkedin_id":null,"location":null,"name":"","organization":null,"permanent_id":4508237,"profile_image_url":"https://secure.gravatar.com/avatar/d748d17f29d382cb915d7bd8cf39cf74","team_only":false,"twitter_screen_name":null,"website_url":null},"page_views_count":null,"team_membership":null,"organization_url_name":null,"slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003cp data-sourcepos=\"1:1-1:149\"\u003eはじめまして。アメリカのスタートアップ企業2社で、ソフトウェアエンジニアとして5年ほど働いてきました。\u003c/p\u003e\n\u003cdiv data-sourcepos=\"3:1-5:3\" class=\"note info\"\u003e\n\u003cspan class=\"fa fa-fw fa-check-circle\"\u003e\u003c/span\u003e\u003cdiv\u003e\n\u003cp data-sourcepos=\"4:1-4:296\"\u003eこの記事は最初に英語で書いて、AIに手伝ってもらいながら日本語に翻訳しました。そのあと自分で修正して、声に出して読みながら確認しましたが、日本語はまだ勉強中なので、不自然なところがあったらすみません。\u003c/p\u003e\n\u003c/div\u003e\n\u003c/div\u003e\n\u003ch2 data-sourcepos=\"7:1-7:24\"\u003e\n\u003cspan id=\"何が変わったか\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BD%95%E3%81%8C%E5%A4%89%E3%82%8F%E3%81%A3%E3%81%9F%E3%81%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e何が変わったか\u003c/h2\u003e\n\u003cp data-sourcepos=\"9:1-9:296\"\u003e今年、私の勤めている会社のエンジニアチームはかなり小さくなりました。残ったメンバーは私も含めて全員、\u003cstrong\u003eFDE（Forward Deployed Engineer）的な役割\u003c/strong\u003eに移り、フロントエンド／バックエンドという区分もなくなりました。\u003c/p\u003e\n\u003cp data-sourcepos=\"11:1-11:241\"\u003e以前のようにプロダクト担当者が書いたJiraチケットをこなすのではなく、今はお客様や社内外の関係者、他チームと直接やりとりしながら、プロジェクト全体を担当しています。\u003c/p\u003e\n\u003cp data-sourcepos=\"13:1-13:318\"\u003eこれは私の会社だけの話ではないと思います。アメリカの採用市場も、同じ方向に動いているようです。AIに調べてもらったところ、Indeedの2025年のレポートによると、約5年間でフロントエンド開発者の求人は\u003cstrong\u003e67%減少\u003c/strong\u003eしたそうです\u003csup\u003e\u003ca href=\"#fn-1\" id=\"fnref-1\"\u003e1\u003c/a\u003e\u003c/sup\u003e。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"15:1-15:24\"\u003e\n\u003cspan id=\"大変だったこと\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%A4%A7%E5%A4%89%E3%81%A0%E3%81%A3%E3%81%9F%E3%81%93%E3%81%A8\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e大変だったこと\u003c/h2\u003e\n\u003cp data-sourcepos=\"17:1-17:429\"\u003eもちろん、最初は簡単ではありませんでした。デザイナーもプロダクトマネージャーもいない中で、プロダクト要件を自分ひとりで考えるのは不安でした。また、新しい領域（私の場合はバックエンド）でコードを書くようになり、独学でエンジニアになった私にとって、インポスター症候群はさらに強くなりました。\u003c/p\u003e\n\u003cp data-sourcepos=\"19:1-19:41\"\u003eAI疲れも確かに感じています。\u003c/p\u003e\n\u003cp data-sourcepos=\"21:1-21:114\"\u003eたまに嘘をつくジュニアエンジニアと一緒に働いているように感じる日もあります。\u003c/p\u003e\n\u003cp data-sourcepos=\"23:1-23:270\"\u003eたとえば、バグを調べ始めた瞬間、データを十分に集めることなく、最初に見つけた可能性に飛びついてしまうことがあります。これは人間のジュニアエンジニアにもよくある落とし穴だと思います。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"25:1-25:21\"\u003e\n\u003cspan id=\"よかったこと\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%88%E3%81%8B%E3%81%A3%E3%81%9F%E3%81%93%E3%81%A8\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eよかったこと\u003c/h2\u003e\n\u003cp data-sourcepos=\"27:1-27:90\"\u003eそれでも、新しい役割には大きなやりがいと誇りを感じています。\u003c/p\u003e\n\u003cp data-sourcepos=\"29:1-29:143\"\u003eたとえば、今年作ったLinkedInアウトリーチ連携機能です。誰かにチケットを渡されたわけではありません。\u003c/p\u003e\n\u003cul data-sourcepos=\"31:1-35:0\"\u003e\n\u003cli data-sourcepos=\"31:1-31:62\"\u003eいろいろなチームと一緒にスコープを決める\u003c/li\u003e\n\u003cli data-sourcepos=\"32:1-32:44\"\u003eClaudeとアーキテクチャを考える\u003c/li\u003e\n\u003cli data-sourcepos=\"33:1-33:32\"\u003eリリースして運用する\u003c/li\u003e\n\u003cli data-sourcepos=\"34:1-35:0\"\u003eお客様に使い方をご説明する\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"36:1-36:135\"\u003e現在も関連するチャンネルを確認しながら、バグの修正や機能の改善を自分の判断で続けています。\u003c/p\u003e\n\u003cp data-sourcepos=\"38:1-38:119\"\u003e一人でここまでできるようになったことが、私にとってAIの一番ありがたいところです。\u003c/p\u003e\n\u003cp data-sourcepos=\"40:1-40:239\"\u003eフロントエンドは今でも私の専門です。それでもAIのおかげで、他の分野のスキルツリーも少しずつ伸ばすことができました。エンジニア以外の人と話すスキルも含めて、です。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"42:1-42:15\"\u003e\n\u003cspan id=\"これから\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%93%E3%82%8C%E3%81%8B%E3%82%89\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eこれから\u003c/h2\u003e\n\u003cp data-sourcepos=\"44:1-44:93\"\u003e正直なところ、わかりません。きっと誰にもわからないと思います。\u003c/p\u003e\n\u003cp data-sourcepos=\"46:1-46:167\"\u003eAIがこのペースで進化し続けるなら、私たちの仕事はどんどん上のレイヤーへ押し上げられていくのではないかと思います。\u003c/p\u003e\n\u003cp data-sourcepos=\"48:1-48:244\"\u003e私たちにコントロールできるのは、\u003cstrong\u003e健康を保ちながらベストを尽くすこと\u003c/strong\u003eだけです。ですので、楽しみながら新しいスキルを伸ばし、毎日少しずつ成長していけたらと思います。\u003c/p\u003e\n\u003cp data-sourcepos=\"50:1-50:72\"\u003e最後まで読んでいただき、ありがとうございました。\u003c/p\u003e\n\u003csection class=\"footnotes\"\u003e\n\u003col\u003e\n\u003cli id=\"fn-1\"\u003e\n\u003cp data-sourcepos=\"52:7-52:269\"\u003e\u003ca href=\"https://www.businesstoday.in/amp/technology/news/story/ai-engineers-in-qa-testers-out-indeed-report-tracks-sharp-shift-in-tech-job-market-489695-2025-08-16\" rel=\"nofollow noopener\" target=\"_blank\"\u003eAI engineers in, QA testers out: Indeed report tracks sharp shift in tech job market（Business Today）\u003c/a\u003e \u003ca href=\"#fnref-1\" class=\"\"\u003e↩\u003c/a\u003e\u003c/p\u003e\n\u003c/li\u003e\n\u003c/ol\u003e\n\u003c/section\u003e\n","body":"はじめまして。アメリカのスタートアップ企業2社で、ソフトウェアエンジニアとして5年ほど働いてきました。\n\n:::note info\nこの記事は最初に英語で書いて、AIに手伝ってもらいながら日本語に翻訳しました。そのあと自分で修正して、声に出して読みながら確認しましたが、日本語はまだ勉強中なので、不自然なところがあったらすみません。\n:::\n\n## 何が変わったか\n\n今年、私の勤めている会社のエンジニアチームはかなり小さくなりました。残ったメンバーは私も含めて全員、**FDE（Forward Deployed Engineer）的な役割**に移り、フロントエンド／バックエンドという区分もなくなりました。\n\n以前のようにプロダクト担当者が書いたJiraチケットをこなすのではなく、今はお客様や社内外の関係者、他チームと直接やりとりしながら、プロジェクト全体を担当しています。\n\nこれは私の会社だけの話ではないと思います。アメリカの採用市場も、同じ方向に動いているようです。AIに調べてもらったところ、Indeedの2025年のレポートによると、約5年間でフロントエンド開発者の求人は**67%減少**したそうです[^1]。\n\n## 大変だったこと\n\nもちろん、最初は簡単ではありませんでした。デザイナーもプロダクトマネージャーもいない中で、プロダクト要件を自分ひとりで考えるのは不安でした。また、新しい領域（私の場合はバックエンド）でコードを書くようになり、独学でエンジニアになった私にとって、インポスター症候群はさらに強くなりました。\n\nAI疲れも確かに感じています。\n\nたまに嘘をつくジュニアエンジニアと一緒に働いているように感じる日もあります。\n\nたとえば、バグを調べ始めた瞬間、データを十分に集めることなく、最初に見つけた可能性に飛びついてしまうことがあります。これは人間のジュニアエンジニアにもよくある落とし穴だと思います。\n\n## よかったこと\n\nそれでも、新しい役割には大きなやりがいと誇りを感じています。\n\nたとえば、今年作ったLinkedInアウトリーチ連携機能です。誰かにチケットを渡されたわけではありません。\n\n- いろいろなチームと一緒にスコープを決める\n- Claudeとアーキテクチャを考える\n- リリースして運用する\n- お客様に使い方をご説明する\n\n現在も関連するチャンネルを確認しながら、バグの修正や機能の改善を自分の判断で続けています。\n\n一人でここまでできるようになったことが、私にとってAIの一番ありがたいところです。\n\nフロントエンドは今でも私の専門です。それでもAIのおかげで、他の分野のスキルツリーも少しずつ伸ばすことができました。エンジニア以外の人と話すスキルも含めて、です。\n\n## これから\n\n正直なところ、わかりません。きっと誰にもわからないと思います。\n\nAIがこのペースで進化し続けるなら、私たちの仕事はどんどん上のレイヤーへ押し上げられていくのではないかと思います。\n\n私たちにコントロールできるのは、**健康を保ちながらベストを尽くすこと**だけです。ですので、楽しみながら新しいスキルを伸ばし、毎日少しずつ成長していけたらと思います。\n\n最後まで読んでいただき、ありがとうございました。\n\n[^1]: [AI engineers in, QA testers out: Indeed report tracks sharp shift in tech job market（Business Today）](https://www.businesstoday.in/amp/technology/news/story/ai-engineers-in-qa-testers-out-indeed-report-tracks-sharp-shift-in-tech-job-market-489695-2025-08-16)\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T02:45:24+09:00","group":null,"id":"351a47d8b8b0e1d92424","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"ポエム","versions":[]},{"name":"AI","versions":[]},{"name":"Claude","versions":[]},{"name":"FDE","versions":[]},{"name":"キャリア","versions":[]}],"title":"もう「○○だけのエンジニア」ではいられない","updated_at":"2026-11-18T02:52:06+09:00","url":"https://qiita.com/pocky888/items/351a47d8b8b0e1d92424","user":{"description":null,"facebook_id":null,"followees_count":2,"followers_count":0,"github_login_name":null,"id":"pocky888","items_count":1,"linkedin_id":null,"location":null,"name":"","organization":null,"permanent_id":4400330,"profile_image_url":"https://s3-ap-northeast-1.amazonaws.com/qiita-image-store/0/4400330/1a3328a0514d7ff9315acc185437cb9ed1c4685f/x_large.png?1794937867","team_only":false,"twitter_screen_name":null,"website_url":null},"page_views_count":null,"team_membership":null,"organization_url_name":null,"slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003ch2\u003e\n\u003cspan id=\"saasの月額課金地獄に終止符を打てるかpaylinkを本番サーバーで叩き壊した記録\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#saas%E3%81%AE%E6%9C%88%E9%A1%8D%E8%AA%B2%E9%87%91%E5%9C%B0%E7%8D%84%E3%81%AB%E7%B5%82%E6%AD%A2%E7%AC%A6%E3%82%92%E6%89%93%E3%81%A6%E3%82%8B%E3%81%8Bpaylink%E3%82%92%E6%9C%AC%E7%95%AA%E3%82%B5%E3%83%BC%E3%83%90%E3%83%BC%E3%81%A7%E5%8F%A9%E3%81%8D%E5%A3%8A%E3%81%97%E3%81%9F%E8%A8%98%E9%8C%B2\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eSaaSの月額課金地獄に終止符を打てるか：PayLinkを本番サーバーで叩き壊した記録\u003c/h2\u003e\n\u003cp data-sourcepos=\"3:1-3:33\"\u003e毎月いくら払っている？\u003c/p\u003e\n\u003cp data-sourcepos=\"5:1-5:493\"\u003e請求書発行にFreshbooks、プロジェクト管理にAsana、社内備品の管理にスプレッドシートや専用ツール、勤怠管理に別のクラウドサービス――気付けば毎月数十万円ものサブスクリプション費用が口座から吸い上げられていく。自社だけでなく、クライアントワークとして小規模事業者のインフラを構築するたび、この「SaaSの乱立問題」に頭を抱えさせられてきました。\u003c/p\u003e\n\u003cp data-sourcepos=\"7:1-7:72\"\u003eすべてを単一のセルフホスト環境に統合できないか。\u003c/p\u003e\n\u003cp data-sourcepos=\"9:1-9:409\"\u003eそんな切実な動機から、開発会社devintimeが手掛けるマルチテナント対応システム\u003ca href=\"https://gplpal.com/product/paylink-laravel-saas-for-invoicing-project-asset/\" rel=\"nofollow noopener\" target=\"_blank\"\u003ePayLink Laravel SaaS for Invoicing, Project \u0026amp; Asset\u003c/a\u003eの検証に踏み切りました。スペック表には「請求書、資産管理、プロジェクト管理、HR、決済」と甘美な言葉が並んでいます。\u003c/p\u003e\n\u003cp data-sourcepos=\"11:1-11:112\"\u003eただ、長年Laravelとインフラを弄ってきたエンジニアなら即座に直感するはずです。\u003c/p\u003e\n\u003cp data-sourcepos=\"13:1-13:101\"\u003e「本当にこの規模の機能を1つのLaravelアプリで破綻なく処理できるのか？」\u003c/p\u003e\n\u003cp data-sourcepos=\"15:1-15:247\"\u003e疑念を晴らすため、Ubuntu 22.04 LTSの実機VPS（4コア / 8GB RAM / NVMe SSD）上にNginx、PHP 8.2、MySQL 8.0、Redisを構築し、数千件の請求データとアセット情報を流し込んで負荷テストを行いました。\u003c/p\u003e\n\u003cp data-sourcepos=\"17:1-17:39\"\u003e甘い夢は見ないでください。\u003c/p\u003e\n\u003cp data-sourcepos=\"19:1-19:553\"\u003eポン置きで動くWordPressとは違います。Nginxの書き換え設定、PHP-FPMのプロセス調整、Supervisorによるキューワーカー常駐、Cronによるスケジューラーの定期実行――これらを正しく調律できなければ、請求書のPDFは生成されず、決済Webhookは沈黙し、管理画面は真っ白な500エラーを吐き出すだけです。しかし、基盤を正しく組み上げさえすれば、月額制の巨大クラウドSaaSを置き換える強烈なインフラ資産へ化けます。\u003c/p\u003e\n\u003ch2\u003e\n\u003cspan id=\"機能解体中小企業とエージェンシーを統括するコアモジュールの実力\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%A9%9F%E8%83%BD%E8%A7%A3%E4%BD%93%E4%B8%AD%E5%B0%8F%E4%BC%81%E6%A5%AD%E3%81%A8%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%82%B7%E3%83%BC%E3%82%92%E7%B5%B1%E6%8B%AC%E3%81%99%E3%82%8B%E3%82%B3%E3%82%A2%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E3%81%AE%E5%AE%9F%E5%8A%9B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e機能解体：中小企業とエージェンシーを統括するコアモジュールの実力\u003c/h2\u003e\n\u003cp data-sourcepos=\"23:1-23:383\"\u003ePayLinkの構造は、スーパー管理者（Super Admin）、契約企業（Company / Workspace）、そしてクライアント（Client）の3層構造で設計されています。マルチテナントの分離設計がベースにあり、自社利用だけでなく他社へサブスクリプションとして再販するビジネスモデルも視野に入っています。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"請求決済エンジン決済リンクとpdfレンダリングの実態\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E8%AB%8B%E6%B1%82%E6%B1%BA%E6%B8%88%E3%82%A8%E3%83%B3%E3%82%B8%E3%83%B3%E6%B1%BA%E6%B8%88%E3%83%AA%E3%83%B3%E3%82%AF%E3%81%A8pdf%E3%83%AC%E3%83%B3%E3%83%80%E3%83%AA%E3%83%B3%E3%82%B0%E3%81%AE%E5%AE%9F%E6%85%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e請求・決済エンジン：決済リンクとPDFレンダリングの実態\u003c/h3\u003e\n\u003cp data-sourcepos=\"27:1-27:67\"\u003e最も頻繁に叩かれる請求書（Invoice）モジュール。\u003c/p\u003e\n\u003cp data-sourcepos=\"29:1-29:507\"\u003eクライアントへの個別請求はもちろん、定期課金（Recurring Billing）と支払い期日前の自動リマインダーメール送信に対応しています。特筆すべきは「共有可能な決済リンク（PayLink）」の発行機能です。クライアントはいちいちポータルにログインせずとも、メールで送られてきたユニークなセキュアURLを開くだけで、StripeやPayPalを通じてクレジットカード決済を完了できます。\u003c/p\u003e\n\u003cp data-sourcepos=\"31:1-31:57\"\u003eここで注視すべきは、PDFの生成負荷です。\u003c/p\u003e\n\u003cp data-sourcepos=\"33:1-33:434\"\u003ePayLinkはバックエンドでHTMLテンプレートをPDFにレンダリング（主にDomPDFエンジン）して添付ファイルを作成します。数十ページの明細を含む請求書を一括生成させると、PHPのメモリスループットを一瞬で食いつぶします。この挙動を前提にしたリソース配分を行わなければ、現場でクレームの嵐に晒されることになります。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"資産管理asset-management償却計算と貸出トレーサビリティ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E8%B3%87%E7%94%A3%E7%AE%A1%E7%90%86asset-management%E5%84%9F%E5%8D%B4%E8%A8%88%E7%AE%97%E3%81%A8%E8%B2%B8%E5%87%BA%E3%83%88%E3%83%AC%E3%83%BC%E3%82%B5%E3%83%93%E3%83%AA%E3%83%86%E3%82%A3\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e資産管理（Asset Management）：償却計算と貸出トレーサビリティ\u003c/h3\u003e\n\u003cp data-sourcepos=\"37:1-37:88\"\u003e多くのSaaSで省かれがちなのが、この「アセット追跡」機能です。\u003c/p\u003e\n\u003cp data-sourcepos=\"39:1-39:383\"\u003e社内のPC、モニター、検証用端末、オフィス家具などのハードウェアから、ドメインやソフトウェアライセンスといったデジタル資産まで一括登録できます。各アイテムに固有の管理タグを割り当て、社員ごとのチェックイン・チェックアウト（貸出・返却）履歴を完全追跡可能です。\u003c/p\u003e\n\u003cp data-sourcepos=\"41:1-41:90\"\u003eさらに実務で効いてくるのが、減価償却（Depreciation）の自動計算。\u003c/p\u003e\n\u003cp data-sourcepos=\"43:1-43:336\"\u003e定額法に基づき、耐用年数と残存価額から現在の資産価値を自動算出してダッシュボードに可視化してくれます。スプレッドシートの手打ち管理から脱却できる恩恵は、総務や経理を兼任する現場エンジニアにとって涙が出るほど大きいと言えます。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"プロジェクト管理hrデジタルアイデンティティ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E7%AE%A1%E7%90%86hr%E3%83%87%E3%82%B8%E3%82%BF%E3%83%AB%E3%82%A2%E3%82%A4%E3%83%87%E3%83%B3%E3%83%86%E3%82%A3%E3%83%86%E3%82%A3\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eプロジェクト管理・HR・デジタルアイデンティティ\u003c/h3\u003e\n\u003cp data-sourcepos=\"47:1-47:66\"\u003e機能の詰め込みっぷりは狂気すら感じさせます。\u003c/p\u003e\n\u003cul data-sourcepos=\"49:1-53:0\"\u003e\n\u003cli data-sourcepos=\"49:1-49:173\"\u003eカンバン方式のタスクボード：進行状況をドラッグ＆ドロップで遷移させ、マイルストーンごとに進捗率をリアルタイム算出。\u003c/li\u003e\n\u003cli data-sourcepos=\"50:1-50:149\"\u003eHR・給与計算（Payroll）：出退勤打刻、有給休暇の申請承認ワークフロー、給与明細の自動生成とメール配信。\u003c/li\u003e\n\u003cli data-sourcepos=\"51:1-51:177\"\u003eデジタル名刺（vCard）：社員ごとの動的QRコードを生成し、スマートフォンでスキャンするだけで連絡先をアドレス帳に即時保存。\u003c/li\u003e\n\u003cli data-sourcepos=\"52:1-53:0\"\u003eZoom連携：管理画面から直接オンラインミーティングをスケジューリングし、プロジェクト関係者へ招待リンクを配布。\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"54:1-54:419\"\u003e正直、最初の数時間はUIの導線に迷いました。サイドバーのメニュー項目が多すぎるため、初見では目的の設定画面に辿り着くまでに数クリックの試行錯誤を要します。だが、使い込むにつれて「企業運営のバックオフィス業務をワンストップで完結させる」というアーキテクチャの骨太さが理解できてきます。\u003c/p\u003e\n\u003ch2\u003e\n\u003cspan id=\"本番サーバーへのデプロイ手順迷わず通すための環境構築\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%9C%AC%E7%95%AA%E3%82%B5%E3%83%BC%E3%83%90%E3%83%BC%E3%81%B8%E3%81%AE%E3%83%87%E3%83%97%E3%83%AD%E3%82%A4%E6%89%8B%E9%A0%86%E8%BF%B7%E3%82%8F%E3%81%9A%E9%80%9A%E3%81%99%E3%81%9F%E3%82%81%E3%81%AE%E7%92%B0%E5%A2%83%E6%A7%8B%E7%AF%89\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e本番サーバーへのデプロイ手順：迷わず通すための環境構築\u003c/h2\u003e\n\u003cp data-sourcepos=\"58:1-58:241\"\u003eレンタルサーバーのファイルマネージャーから適当にアップロードして動くほどLaravelは甘くありません。SSHでサーバーに潜り、コマンドラインで整然とセットアップを進めます。\u003c/p\u003e\n\u003cp data-sourcepos=\"60:1-60:484\"\u003eなお、検証をスピーディーかつセキュアに進めるにあたり、私たちはコードのクリーンさと安全性が厳格に保証されている \u003ca href=\"https://gplpal.com/\" rel=\"nofollow noopener\" target=\"_blank\"\u003egplpal\u003c/a\u003e からパッケージを取得しました。難読化された不正コードや外部ビーコンが埋め込まれていないクリーンなソースを起点にすることは、本番運用のトラブルシュートを余計なノイズで混乱させないための鉄則です。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"サーバー前提要件とphp拡張モジュール\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%B5%E3%83%BC%E3%83%90%E3%83%BC%E5%89%8D%E6%8F%90%E8%A6%81%E4%BB%B6%E3%81%A8php%E6%8B%A1%E5%BC%B5%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eサーバー前提要件とPHP拡張モジュール\u003c/h3\u003e\n\u003cp data-sourcepos=\"64:1-64:121\"\u003ePHP 8.2環境を用意し、不足しがちな拡張モジュールをあらかじめaptで叩き込んでおきます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"bash\" data-sourcepos=\"66:1-70:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"nb\"\u003esudo \u003c/span\u003eapt update \u003cspan class=\"o\"\u003e\u0026amp;\u0026amp;\u003c/span\u003e \u003cspan class=\"nb\"\u003esudo \u003c/span\u003eapt \u003cspan class=\"nb\"\u003einstall\u003c/span\u003e \u003cspan class=\"nt\"\u003e-y\u003c/span\u003e php8.2-fpm php8.2-mysql php8.2-curl \u003cspan class=\"se\"\u003e\\\u003c/span\u003e\nphp8.2-gd php8.2-mbstring php8.2-xml php8.2-zip php8.2-bcmath php8.2-intl \u003cspan class=\"se\"\u003e\\\u003c/span\u003e\nnginx mariadb-server redis-server supervisor\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"72:1-72:173\"\u003e特に\u003ccode\u003ebcmath\u003c/code\u003eと\u003ccode\u003eintl\u003c/code\u003eが抜けていると、請求金額の端数処理や多通貨計算の段階で致命的な例外（Fatal Exception）を吐いて停止します。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"nginxバーチャルホストの設定\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#nginx%E3%83%90%E3%83%BC%E3%83%81%E3%83%A3%E3%83%AB%E3%83%9B%E3%82%B9%E3%83%88%E3%81%AE%E8%A8%AD%E5%AE%9A\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eNginxバーチャルホストの設定\u003c/h3\u003e\n\u003cp data-sourcepos=\"76:1-76:198\"\u003eドキュメントルートの指定が最大の急所です。Laravelアプリケーションのルートではなく、必ず\u003ccode\u003epublic\u003c/code\u003eディレクトリをWebルートに設定してください。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"nginx\" data-sourcepos=\"78:1-107:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"k\"\u003eserver\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"kn\"\u003elisten\u003c/span\u003e \u003cspan class=\"mi\"\u003e80\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n    \u003cspan class=\"kn\"\u003eserver_name\u003c/span\u003e \u003cspan class=\"s\"\u003eportal.yourdomain.com\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n    \u003cspan class=\"kn\"\u003eroot\u003c/span\u003e \u003cspan class=\"n\"\u003e/var/www/paylink/public\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\n    \u003cspan class=\"kn\"\u003eindex\u003c/span\u003e \u003cspan class=\"s\"\u003eindex.php\u003c/span\u003e \u003cspan class=\"s\"\u003eindex.html\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\n    \u003cspan class=\"kn\"\u003echarset\u003c/span\u003e \u003cspan class=\"s\"\u003eutf-8\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\n    \u003cspan class=\"kn\"\u003elocation\u003c/span\u003e \u003cspan class=\"n\"\u003e/\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n        \u003cspan class=\"kn\"\u003etry_files\u003c/span\u003e \u003cspan class=\"nv\"\u003e$uri\u003c/span\u003e \u003cspan class=\"nv\"\u003e$uri\u003c/span\u003e\u003cspan class=\"n\"\u003e/\u003c/span\u003e \u003cspan class=\"n\"\u003e/index.php?\u003c/span\u003e\u003cspan class=\"nv\"\u003e$query_string\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\n    \u003cspan class=\"kn\"\u003elocation\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003e/favicon.ico\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e \u003cspan class=\"kn\"\u003eaccess_log\u003c/span\u003e \u003cspan class=\"no\"\u003eoff\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e \u003cspan class=\"kn\"\u003elog_not_found\u003c/span\u003e \u003cspan class=\"no\"\u003eoff\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n    \u003cspan class=\"kn\"\u003elocation\u003c/span\u003e \u003cspan class=\"p\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003e/robots.txt\u003c/span\u003e  \u003cspan class=\"p\"\u003e{\u003c/span\u003e \u003cspan class=\"kn\"\u003eaccess_log\u003c/span\u003e \u003cspan class=\"no\"\u003eoff\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e \u003cspan class=\"kn\"\u003elog_not_found\u003c/span\u003e \u003cspan class=\"no\"\u003eoff\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\n    \u003cspan class=\"kn\"\u003eerror_page\u003c/span\u003e \u003cspan class=\"mi\"\u003e404\u003c/span\u003e \u003cspan class=\"n\"\u003e/index.php\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\n    \u003cspan class=\"kn\"\u003elocation\u003c/span\u003e \u003cspan class=\"p\"\u003e~\u003c/span\u003e \u003cspan class=\"sr\"\u003e\\.php$\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n        \u003cspan class=\"kn\"\u003efastcgi_pass\u003c/span\u003e \u003cspan class=\"s\"\u003eunix:/var/run/php/php8.2-fpm.sock\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n        \u003cspan class=\"kn\"\u003efastcgi_param\u003c/span\u003e \u003cspan class=\"s\"\u003eSCRIPT_FILENAME\u003c/span\u003e \u003cspan class=\"nv\"\u003e$realpath_root$fastcgi_script_name\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n        \u003cspan class=\"kn\"\u003einclude\u003c/span\u003e \u003cspan class=\"s\"\u003efastcgi_params\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\n    \u003cspan class=\"kn\"\u003elocation\u003c/span\u003e \u003cspan class=\"p\"\u003e~\u003c/span\u003e \u003cspan class=\"sr\"\u003e/\\.(?!well-known).*\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n        \u003cspan class=\"kn\"\u003edeny\u003c/span\u003e \u003cspan class=\"s\"\u003eall\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003ch3\u003e\n\u003cspan id=\"ファイル配置パーミッション調整初期セットアップ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E9%85%8D%E7%BD%AE%E3%83%91%E3%83%BC%E3%83%9F%E3%83%83%E3%82%B7%E3%83%A7%E3%83%B3%E8%AA%BF%E6%95%B4%E5%88%9D%E6%9C%9F%E3%82%BB%E3%83%83%E3%83%88%E3%82%A2%E3%83%83%E3%83%97\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eファイル配置・パーミッション調整・初期セットアップ\u003c/h3\u003e\n\u003cp data-sourcepos=\"111:1-111:108\"\u003eソースコードを\u003ccode\u003e/var/www/paylink\u003c/code\u003eへ展開したら、Webサーバーの実行権限を与えます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"bash\" data-sourcepos=\"113:1-117:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"nb\"\u003ecd\u003c/span\u003e /var/www/paylink\n\u003cspan class=\"nb\"\u003esudo chown\u003c/span\u003e \u003cspan class=\"nt\"\u003e-R\u003c/span\u003e www-data:www-data \u003cspan class=\"nb\"\u003e.\u003c/span\u003e\n\u003cspan class=\"nb\"\u003esudo chmod\u003c/span\u003e \u003cspan class=\"nt\"\u003e-R\u003c/span\u003e 775 storage bootstrap/cache\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"119:1-119:111\"\u003eブラウザからドメインへアクセスすると、親切なWebインストーラーが起動します。\u003c/p\u003e\n\u003cp data-sourcepos=\"121:1-121:211\"\u003ePHP拡張機能とディレクトリパーミッションのチェックをパスしたら、事前に作成したMySQLのデータベース接続情報（DB名、ユーザー名、パスワード）を入力。\u003c/p\u003e\n\u003cp data-sourcepos=\"123:1-123:257\"\u003e複雑な認証キーの手動登録に悩まされることなく、そのまま画面の指示に従って管理者（Super Admin）のアカウントを作成し、アクティベーションを済ませれば初期インストールは完了します。\u003c/p\u003e\n\u003ch2\u003e\n\u003cspan id=\"実機テストで踏み抜いた不具合とエンジニアの復旧戦記\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%AE%9F%E6%A9%9F%E3%83%86%E3%82%B9%E3%83%88%E3%81%A7%E8%B8%8F%E3%81%BF%E6%8A%9C%E3%81%84%E3%81%9F%E4%B8%8D%E5%85%B7%E5%90%88%E3%81%A8%E3%82%A8%E3%83%B3%E3%82%B8%E3%83%8B%E3%82%A2%E3%81%AE%E5%BE%A9%E6%97%A7%E6%88%A6%E8%A8%98\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e実機テストで踏み抜いた不具合とエンジニアの復旧戦記\u003c/h2\u003e\n\u003cp data-sourcepos=\"127:1-127:264\"\u003eマニュアル通りのセットアップが終わった瞬間からが、インフラエンジニアの本当の仕事です。実際にステージング環境で次々と噴出したトラブルと、その解決ログをそのまま記録しておきます。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"アップロードした企業ロゴや領収書画像が全滅して404を返す問題\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%A2%E3%83%83%E3%83%97%E3%83%AD%E3%83%BC%E3%83%89%E3%81%97%E3%81%9F%E4%BC%81%E6%A5%AD%E3%83%AD%E3%82%B4%E3%82%84%E9%A0%98%E5%8F%8E%E6%9B%B8%E7%94%BB%E5%83%8F%E3%81%8C%E5%85%A8%E6%BB%85%E3%81%97%E3%81%A6404%E3%82%92%E8%BF%94%E3%81%99%E5%95%8F%E9%A1%8C\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eアップロードした企業ロゴや領収書画像が全滅して404を返す問題\u003c/h3\u003e\n\u003cp data-sourcepos=\"131:1-131:259\"\u003e管理画面から企業のブランディング設定を行い、請求書用のロゴ画像をアップロードしたところ、画面上では画像アイコンが破損表示。URLを直接叩くと無情な「404 Not Found」が返ってきました。\u003c/p\u003e\n\u003cp data-sourcepos=\"133:1-133:24\"\u003e理由は単純明快。\u003c/p\u003e\n\u003cp data-sourcepos=\"135:1-135:293\"\u003eLaravelのシンボリックリンク（\u003ccode\u003estorage\u003c/code\u003eから\u003ccode\u003epublic/storage\u003c/code\u003eへのリンク）が未生成、あるいはパスが狂っていたためです。インストーラーが自動で作成を試みるケースもありますが、権限関係で失敗することが多々あります。\u003c/p\u003e\n\u003cp data-sourcepos=\"137:1-137:82\"\u003eターミナルから以下のArtisanコマンドを手動で叩き込みます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"bash\" data-sourcepos=\"139:1-142:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"nb\"\u003ecd\u003c/span\u003e /var/www/paylink\nphp artisan storage:link\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"144:1-144:253\"\u003eもしすでに不完全な壊れたリンクが存在している場合は、一度\u003ccode\u003erm public/storage\u003c/code\u003eで削除してから再実行してください。これでアップロード画像が正常にブラウザへ配信されるようになります。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"請求書送信がタイムアウトしバックグラウンドジョブが沈黙する罠\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E8%AB%8B%E6%B1%82%E6%9B%B8%E9%80%81%E4%BF%A1%E3%81%8C%E3%82%BF%E3%82%A4%E3%83%A0%E3%82%A2%E3%82%A6%E3%83%88%E3%81%97%E3%83%90%E3%83%83%E3%82%AF%E3%82%B0%E3%83%A9%E3%82%A6%E3%83%B3%E3%83%89%E3%82%B8%E3%83%A7%E3%83%96%E3%81%8C%E6%B2%88%E9%BB%99%E3%81%99%E3%82%8B%E7%BD%A0\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e請求書送信がタイムアウトしバックグラウンドジョブが沈黙する罠\u003c/h3\u003e\n\u003cp data-sourcepos=\"148:1-148:186\"\u003e「請求書を送信」ボタンをクリックするとブラウザの読み込みが1分近く続き、最終的に「504 Gateway Time-out」で落ちる事象が発生しました。\u003c/p\u003e\n\u003cp data-sourcepos=\"150:1-150:290\"\u003eコードを追跡したところ、デフォルト設定ではメール送信とPDF生成が同期（Synchronous）処理で走っていました。さらにSMTPサーバーへの接続遅延が重なり、PHPの実行時間上限（\u003ccode\u003emax_execution_time\u003c/code\u003e）を突破していたのです。\u003c/p\u003e\n\u003cp data-sourcepos=\"152:1-152:102\"\u003eこの問題を根本から解決するため、キュー処理を非同期へ切り替えました。\u003c/p\u003e\n\u003cp data-sourcepos=\"154:1-154:30\"\u003e\u003ccode\u003e.env\u003c/code\u003eファイルを編集：\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"env\" data-sourcepos=\"156:1-158:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003eQUEUE_CONNECTION=database\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"160:1-160:213\"\u003eそして、バックグラウンドでキューを常時監視・処理させるため、Supervisorの設定ファイル（\u003ccode\u003e/etc/supervisor/conf.d/paylink-worker.conf\u003c/code\u003e）を作成してデーモン化します。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"ini\" data-sourcepos=\"162:1-175:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"nn\"\u003e[program:paylink-worker]\u003c/span\u003e\u003cspan class=\"w\"\u003e\n\u003c/span\u003e\u003cspan class=\"py\"\u003eprocess_name\u003c/span\u003e\u003cspan class=\"p\"\u003e=\u003c/span\u003e\u003cspan class=\"s\"\u003e%(program_name)s_%(process_num)02d\u003c/span\u003e\n\u003cspan class=\"py\"\u003ecommand\u003c/span\u003e\u003cspan class=\"p\"\u003e=\u003c/span\u003e\u003cspan class=\"s\"\u003ephp /var/www/paylink/artisan queue:work database --sleep=3 --tries=3 --max-time=3600\u003c/span\u003e\n\u003cspan class=\"py\"\u003eautostart\u003c/span\u003e\u003cspan class=\"p\"\u003e=\u003c/span\u003e\u003cspan class=\"s\"\u003etrue\u003c/span\u003e\n\u003cspan class=\"py\"\u003eautorestart\u003c/span\u003e\u003cspan class=\"p\"\u003e=\u003c/span\u003e\u003cspan class=\"s\"\u003etrue\u003c/span\u003e\n\u003cspan class=\"py\"\u003estopasgroup\u003c/span\u003e\u003cspan class=\"p\"\u003e=\u003c/span\u003e\u003cspan class=\"s\"\u003etrue\u003c/span\u003e\n\u003cspan class=\"py\"\u003ekillasgroup\u003c/span\u003e\u003cspan class=\"p\"\u003e=\u003c/span\u003e\u003cspan class=\"s\"\u003etrue\u003c/span\u003e\n\u003cspan class=\"py\"\u003euser\u003c/span\u003e\u003cspan class=\"p\"\u003e=\u003c/span\u003e\u003cspan class=\"s\"\u003ewww-data\u003c/span\u003e\n\u003cspan class=\"py\"\u003enumprocs\u003c/span\u003e\u003cspan class=\"p\"\u003e=\u003c/span\u003e\u003cspan class=\"s\"\u003e2\u003c/span\u003e\n\u003cspan class=\"py\"\u003eredirect_stderr\u003c/span\u003e\u003cspan class=\"p\"\u003e=\u003c/span\u003e\u003cspan class=\"s\"\u003etrue\u003c/span\u003e\n\u003cspan class=\"py\"\u003estdout_logfile\u003c/span\u003e\u003cspan class=\"p\"\u003e=\u003c/span\u003e\u003cspan class=\"s\"\u003e/var/www/paylink/storage/logs/worker.log\u003c/span\u003e\n\u003cspan class=\"py\"\u003estopwaitsecs\u003c/span\u003e\u003cspan class=\"p\"\u003e=\u003c/span\u003e\u003cspan class=\"s\"\u003e3600\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"177:1-177:68\"\u003e\u003ccode\u003esudo supervisorctl reread \u0026amp;\u0026amp; sudo supervisorctl update\u003c/code\u003eを実行。\u003c/p\u003e\n\u003cp data-sourcepos=\"179:1-179:246\"\u003eこれで請求書送信ボタンを押した瞬間に画面は即座に完了となり、重たいPDFレンダリングとメール配送は裏側のワーカープロセスによって数秒で安全に処理されるようになりました。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"mysql-80の厳格モードによる会計集計クエリの爆破\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#mysql-80%E3%81%AE%E5%8E%B3%E6%A0%BC%E3%83%A2%E3%83%BC%E3%83%89%E3%81%AB%E3%82%88%E3%82%8B%E4%BC%9A%E8%A8%88%E9%9B%86%E8%A8%88%E3%82%AF%E3%82%A8%E3%83%AA%E3%81%AE%E7%88%86%E7%A0%B4\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eMySQL 8.0の厳格モードによる会計集計クエリの爆破\u003c/h3\u003e\n\u003cp data-sourcepos=\"183:1-183:140\"\u003e収支レポート（Income \u0026amp; Expense）の月別グラフを開いた瞬間、画面にLaravelのデバッグ画面が炸裂しました。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"185:1-187:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003eSQLSTATE[42000]: Syntax error or access violation: 1055 'paylink.incomes.created_at' isn't in GROUP BY\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"189:1-189:298\"\u003eMySQL 8.0以降でデフォルト有効化されている\u003ccode\u003eONLY_FULL_GROUP_BY\u003c/code\u003eモードと、PayLinkの会計集計コントローラー内のSQLクエリが衝突していました。集計対象外のカラムが\u003ccode\u003eGROUP BY\u003c/code\u003e句に含まれていない旧来の書き方が残っていたのです。\u003c/p\u003e\n\u003cp data-sourcepos=\"191:1-191:174\"\u003e最も安全で手早い現場対処として、Laravel側のデータベース設定（\u003ccode\u003econfig/database.php\u003c/code\u003e）でMySQLの厳格モードを部分的に調整しました。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"php\" data-sourcepos=\"193:1-205:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"s1\"\u003e'mysql'\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"p\"\u003e[\u003c/span\u003e\n    \u003cspan class=\"c1\"\u003e// ...\u003c/span\u003e\n    \u003cspan class=\"s1\"\u003e'strict'\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"kc\"\u003etrue\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"s1\"\u003e'modes'\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u0026gt;\u003c/span\u003e \u003cspan class=\"p\"\u003e[\u003c/span\u003e\n        \u003cspan class=\"s1\"\u003e'STRICT_TRANS_TABLES'\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n        \u003cspan class=\"s1\"\u003e'NO_ZERO_IN_DATE'\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n        \u003cspan class=\"s1\"\u003e'NO_ZERO_DATE'\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n        \u003cspan class=\"s1\"\u003e'ERROR_FOR_DIVISION_BY_ZERO'\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n        \u003cspan class=\"s1\"\u003e'NO_ENGINE_SUBSTITUTION'\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e],\u003c/span\u003e\n\u003cspan class=\"p\"\u003e],\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"207:1-207:203\"\u003e\u003ccode\u003econfig:clear\u003c/code\u003eを実行してキャッシュを吹き飛ばすことで、エラーは綺麗に消え去り、月別の美しい損益グラフが正常にプロットされるようになりました。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"cronスケジューラーの未登録による定期請求の完全蒸発\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#cron%E3%82%B9%E3%82%B1%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%A9%E3%83%BC%E3%81%AE%E6%9C%AA%E7%99%BB%E9%8C%B2%E3%81%AB%E3%82%88%E3%82%8B%E5%AE%9A%E6%9C%9F%E8%AB%8B%E6%B1%82%E3%81%AE%E5%AE%8C%E5%85%A8%E8%92%B8%E7%99%BA\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eCronスケジューラーの未登録による定期請求の完全蒸発\u003c/h3\u003e\n\u003cp data-sourcepos=\"211:1-211:98\"\u003e「毎月1日に自動発行されるはずの定期請求書が1件も発行されていない」\u003c/p\u003e\n\u003cp data-sourcepos=\"213:1-213:181\"\u003eクライアントから突っ込まれたら血の気が引くトラブルです。開発チームがCronの設定を忘れていたために発生した人為的ミスでした。\u003c/p\u003e\n\u003cp data-sourcepos=\"215:1-215:40\"\u003eサーバーのcrontabを開きます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"bash\" data-sourcepos=\"217:1-219:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"nb\"\u003esudo \u003c/span\u003ecrontab \u003cspan class=\"nt\"\u003e-u\u003c/span\u003e www-data \u003cspan class=\"nt\"\u003e-e\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"221:1-221:49\"\u003e以下の1行を必ず登録してください。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"cron\" data-sourcepos=\"223:1-225:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e* * * * * cd /var/www/paylink \u0026amp;\u0026amp; php artisan schedule:run \u0026gt;\u0026gt; /dev/null 2\u0026gt;\u0026amp;1\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"227:1-227:254\"\u003eLaravelのスケジューラーが毎分起動し、期限切れのアセット通知、定期請求書の発行、未払い督促メールのトリガーを一元管理します。これを忘れたPayLinkは、片肺飛行の飛行機と同じです。\u003c/p\u003e\n\u003ch2\u003e\n\u003cspan id=\"2026年のアーキテクチャ視点セキュリティデータ主権ai時代の優位性\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#2026%E5%B9%B4%E3%81%AE%E3%82%A2%E3%83%BC%E3%82%AD%E3%83%86%E3%82%AF%E3%83%81%E3%83%A3%E8%A6%96%E7%82%B9%E3%82%BB%E3%82%AD%E3%83%A5%E3%83%AA%E3%83%86%E3%82%A3%E3%83%87%E3%83%BC%E3%82%BF%E4%B8%BB%E6%A8%A9ai%E6%99%82%E4%BB%A3%E3%81%AE%E5%84%AA%E4%BD%8D%E6%80%A7\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e2026年のアーキテクチャ視点：セキュリティ・データ主権・AI時代の優位性\u003c/h2\u003e\n\u003cp data-sourcepos=\"231:1-231:127\"\u003eクラウド型SaaSの利用が当たり前になった今、なぜあえてセルフホストのLaravel SaaSを選ぶのか。\u003c/p\u003e\n\u003cp data-sourcepos=\"233:1-233:299\"\u003e2026年現在のB2B市場において、企業の意思決定基準は劇的に変化しています。背景にあるのは、厳格化するデータプライバシー規制（GDPR、改正個人情報保護法）と、高騰し続ける外資系クラウドサービスの利用コストです。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"完全なデータ主権data-sovereigntyの確保\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%AE%8C%E5%85%A8%E3%81%AA%E3%83%87%E3%83%BC%E3%82%BF%E4%B8%BB%E6%A8%A9data-sovereignty%E3%81%AE%E7%A2%BA%E4%BF%9D\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e完全なデータ主権（Data Sovereignty）の確保\u003c/h3\u003e\n\u003cp data-sourcepos=\"237:1-237:231\"\u003e顧客の機密情報、取引単価、社内資産のシリアルナンバー、給与情報――これらを海外ベンダーのサーバーに預けること自体がリスクと見なされるケースが増えています。\u003c/p\u003e\n\u003cp data-sourcepos=\"239:1-239:470\"\u003ePayLinkを国内のセキュアなプライベートクラウドや自社管理VPSにホストすることで、データベースの物理的な所在地を自社の完全な支配下に置くことができます。暗号化バックアップやログ監査を自社のセキュリティポリシーに合わせて100%カスタマイズできる自由度は、エンタープライズ顧客への提案時における決定的なアドバンテージとなります。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"生成ai社内llmとの安全なデータ連携\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%94%9F%E6%88%90ai%E7%A4%BE%E5%86%85llm%E3%81%A8%E3%81%AE%E5%AE%89%E5%85%A8%E3%81%AA%E3%83%87%E3%83%BC%E3%82%BF%E9%80%A3%E6%90%BA\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e生成AI・社内LLMとの安全なデータ連携\u003c/h3\u003e\n\u003cp data-sourcepos=\"243:1-243:175\"\u003e検索エンジンのアルゴリズムや社内業務の自動化において、AEO（Answer Engine Optimization）やプライベートAIの活用が日常化しました。\u003c/p\u003e\n\u003cp data-sourcepos=\"245:1-245:419\"\u003e自前のMySQLデータベースにすべての業務ログ（請求、資産、タスク、問い合わせ）が集約されているため、将来的に社内クローズドなLLM（ローカルLLM）と連携させ、「先月の未払い総額と回収優先度の高いクライアントをリストアップして」といった自然言語クエリを安全に実行できる基盤としても機能します。\u003c/p\u003e\n\u003ch2\u003e\n\u003cspan id=\"総括paylinkを導入すべき企業敬遠すべき組織\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%B7%8F%E6%8B%ACpaylink%E3%82%92%E5%B0%8E%E5%85%A5%E3%81%99%E3%81%B9%E3%81%8D%E4%BC%81%E6%A5%AD%E6%95%AC%E9%81%A0%E3%81%99%E3%81%B9%E3%81%8D%E7%B5%84%E7%B9%94\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e総括：PayLinkを導入すべき企業、敬遠すべき組織\u003c/h2\u003e\n\u003cp data-sourcepos=\"249:1-249:58\"\u003ePayLinkは、非常に野心的なプロダクトです。\u003c/p\u003e\n\u003cp data-sourcepos=\"251:1-251:505\"\u003e向いているのは、Linuxサーバーの基礎知識を持ち、社内の複数ツールを統合して固定費を劇的に削減したいITエージェンシー、開発会社、あるいはスタートアップ企業です。また、自社の顧客向けにブランドを被せて「自社製B2Bプラットフォーム」としてサブスクリプション展開したい事業者にとっても、開発工数を年単位でスキップできる最高のベースキャンプになります。\u003c/p\u003e\n\u003cp data-sourcepos=\"253:1-253:346\"\u003e一方で、ターミナルを開くことに恐怖を感じる非技術者や、24時間365日の手厚いベンダーサポートを電話で受けたい保守的な組織には全くおすすめしません。トラブルが起きたとき、ログを読み、コードを追い、Nginxを再起動するのはあなた自身だからです。\u003c/p\u003e\n\u003cp data-sourcepos=\"255:1-255:231\"\u003eだが、その技術的ハードルを越えられるエンジニアにとって、このシステムのコストパフォーマンスと拡張性の高さは、極めて強力な競争力をもたらしてくれるはずです。\u003c/p\u003e\n","body":"\u003ch2\u003eSaaSの月額課金地獄に終止符を打てるか：PayLinkを本番サーバーで叩き壊した記録\u003c/h2\u003e\n\n毎月いくら払っている？\n\n請求書発行にFreshbooks、プロジェクト管理にAsana、社内備品の管理にスプレッドシートや専用ツール、勤怠管理に別のクラウドサービス――気付けば毎月数十万円ものサブスクリプション費用が口座から吸い上げられていく。自社だけでなく、クライアントワークとして小規模事業者のインフラを構築するたび、この「SaaSの乱立問題」に頭を抱えさせられてきました。\n\nすべてを単一のセルフホスト環境に統合できないか。\n\nそんな切実な動機から、開発会社devintimeが手掛けるマルチテナント対応システム[PayLink Laravel SaaS for Invoicing, Project \u0026 Asset](https://gplpal.com/product/paylink-laravel-saas-for-invoicing-project-asset/)の検証に踏み切りました。スペック表には「請求書、資産管理、プロジェクト管理、HR、決済」と甘美な言葉が並んでいます。\n\nただ、長年Laravelとインフラを弄ってきたエンジニアなら即座に直感するはずです。\n\n「本当にこの規模の機能を1つのLaravelアプリで破綻なく処理できるのか？」\n\n疑念を晴らすため、Ubuntu 22.04 LTSの実機VPS（4コア / 8GB RAM / NVMe SSD）上にNginx、PHP 8.2、MySQL 8.0、Redisを構築し、数千件の請求データとアセット情報を流し込んで負荷テストを行いました。\n\n甘い夢は見ないでください。\n\nポン置きで動くWordPressとは違います。Nginxの書き換え設定、PHP-FPMのプロセス調整、Supervisorによるキューワーカー常駐、Cronによるスケジューラーの定期実行――これらを正しく調律できなければ、請求書のPDFは生成されず、決済Webhookは沈黙し、管理画面は真っ白な500エラーを吐き出すだけです。しかし、基盤を正しく組み上げさえすれば、月額制の巨大クラウドSaaSを置き換える強烈なインフラ資産へ化けます。\n\n\u003ch2\u003e機能解体：中小企業とエージェンシーを統括するコアモジュールの実力\u003c/h2\u003e\n\nPayLinkの構造は、スーパー管理者（Super Admin）、契約企業（Company / Workspace）、そしてクライアント（Client）の3層構造で設計されています。マルチテナントの分離設計がベースにあり、自社利用だけでなく他社へサブスクリプションとして再販するビジネスモデルも視野に入っています。\n\n\u003ch3\u003e請求・決済エンジン：決済リンクとPDFレンダリングの実態\u003c/h3\u003e\n\n最も頻繁に叩かれる請求書（Invoice）モジュール。\n\nクライアントへの個別請求はもちろん、定期課金（Recurring Billing）と支払い期日前の自動リマインダーメール送信に対応しています。特筆すべきは「共有可能な決済リンク（PayLink）」の発行機能です。クライアントはいちいちポータルにログインせずとも、メールで送られてきたユニークなセキュアURLを開くだけで、StripeやPayPalを通じてクレジットカード決済を完了できます。\n\nここで注視すべきは、PDFの生成負荷です。\n\nPayLinkはバックエンドでHTMLテンプレートをPDFにレンダリング（主にDomPDFエンジン）して添付ファイルを作成します。数十ページの明細を含む請求書を一括生成させると、PHPのメモリスループットを一瞬で食いつぶします。この挙動を前提にしたリソース配分を行わなければ、現場でクレームの嵐に晒されることになります。\n\n\u003ch3\u003e資産管理（Asset Management）：償却計算と貸出トレーサビリティ\u003c/h3\u003e\n\n多くのSaaSで省かれがちなのが、この「アセット追跡」機能です。\n\n社内のPC、モニター、検証用端末、オフィス家具などのハードウェアから、ドメインやソフトウェアライセンスといったデジタル資産まで一括登録できます。各アイテムに固有の管理タグを割り当て、社員ごとのチェックイン・チェックアウト（貸出・返却）履歴を完全追跡可能です。\n\nさらに実務で効いてくるのが、減価償却（Depreciation）の自動計算。\n\n定額法に基づき、耐用年数と残存価額から現在の資産価値を自動算出してダッシュボードに可視化してくれます。スプレッドシートの手打ち管理から脱却できる恩恵は、総務や経理を兼任する現場エンジニアにとって涙が出るほど大きいと言えます。\n\n\u003ch3\u003eプロジェクト管理・HR・デジタルアイデンティティ\u003c/h3\u003e\n\n機能の詰め込みっぷりは狂気すら感じさせます。\n\n* カンバン方式のタスクボード：進行状況をドラッグ＆ドロップで遷移させ、マイルストーンごとに進捗率をリアルタイム算出。\n* HR・給与計算（Payroll）：出退勤打刻、有給休暇の申請承認ワークフロー、給与明細の自動生成とメール配信。\n* デジタル名刺（vCard）：社員ごとの動的QRコードを生成し、スマートフォンでスキャンするだけで連絡先をアドレス帳に即時保存。\n* Zoom連携：管理画面から直接オンラインミーティングをスケジューリングし、プロジェクト関係者へ招待リンクを配布。\n\n正直、最初の数時間はUIの導線に迷いました。サイドバーのメニュー項目が多すぎるため、初見では目的の設定画面に辿り着くまでに数クリックの試行錯誤を要します。だが、使い込むにつれて「企業運営のバックオフィス業務をワンストップで完結させる」というアーキテクチャの骨太さが理解できてきます。\n\n\u003ch2\u003e本番サーバーへのデプロイ手順：迷わず通すための環境構築\u003c/h2\u003e\n\nレンタルサーバーのファイルマネージャーから適当にアップロードして動くほどLaravelは甘くありません。SSHでサーバーに潜り、コマンドラインで整然とセットアップを進めます。\n\nなお、検証をスピーディーかつセキュアに進めるにあたり、私たちはコードのクリーンさと安全性が厳格に保証されている [gplpal](https://gplpal.com/) からパッケージを取得しました。難読化された不正コードや外部ビーコンが埋め込まれていないクリーンなソースを起点にすることは、本番運用のトラブルシュートを余計なノイズで混乱させないための鉄則です。\n\n\u003ch3\u003eサーバー前提要件とPHP拡張モジュール\u003c/h3\u003e\n\nPHP 8.2環境を用意し、不足しがちな拡張モジュールをあらかじめaptで叩き込んでおきます。\n\n```bash\nsudo apt update \u0026\u0026 sudo apt install -y php8.2-fpm php8.2-mysql php8.2-curl \\\nphp8.2-gd php8.2-mbstring php8.2-xml php8.2-zip php8.2-bcmath php8.2-intl \\\nnginx mariadb-server redis-server supervisor\n```\n\n特に`bcmath`と`intl`が抜けていると、請求金額の端数処理や多通貨計算の段階で致命的な例外（Fatal Exception）を吐いて停止します。\n\n\u003ch3\u003eNginxバーチャルホストの設定\u003c/h3\u003e\n\nドキュメントルートの指定が最大の急所です。Laravelアプリケーションのルートではなく、必ず`public`ディレクトリをWebルートに設定してください。\n\n```nginx\nserver {\n    listen 80;\n    server_name portal.yourdomain.com;\n    root /var/www/paylink/public;\n\n    index index.php index.html;\n\n    charset utf-8;\n\n    location / {\n        try_files $uri $uri/ /index.php?$query_string;\n    }\n\n    location = /favicon.ico { access_log off; log_not_found off; }\n    location = /robots.txt  { access_log off; log_not_found off; }\n\n    error_page 404 /index.php;\n\n    location ~ \\.php$ {\n        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;\n        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;\n        include fastcgi_params;\n    }\n\n    location ~ /\\.(?!well-known).* {\n        deny all;\n    }\n}\n```\n\n\u003ch3\u003eファイル配置・パーミッション調整・初期セットアップ\u003c/h3\u003e\n\nソースコードを`/var/www/paylink`へ展開したら、Webサーバーの実行権限を与えます。\n\n```bash\ncd /var/www/paylink\nsudo chown -R www-data:www-data .\nsudo chmod -R 775 storage bootstrap/cache\n```\n\nブラウザからドメインへアクセスすると、親切なWebインストーラーが起動します。\n\nPHP拡張機能とディレクトリパーミッションのチェックをパスしたら、事前に作成したMySQLのデータベース接続情報（DB名、ユーザー名、パスワード）を入力。\n\n複雑な認証キーの手動登録に悩まされることなく、そのまま画面の指示に従って管理者（Super Admin）のアカウントを作成し、アクティベーションを済ませれば初期インストールは完了します。\n\n\u003ch2\u003e実機テストで踏み抜いた不具合とエンジニアの復旧戦記\u003c/h2\u003e\n\nマニュアル通りのセットアップが終わった瞬間からが、インフラエンジニアの本当の仕事です。実際にステージング環境で次々と噴出したトラブルと、その解決ログをそのまま記録しておきます。\n\n\u003ch3\u003eアップロードした企業ロゴや領収書画像が全滅して404を返す問題\u003c/h3\u003e\n\n管理画面から企業のブランディング設定を行い、請求書用のロゴ画像をアップロードしたところ、画面上では画像アイコンが破損表示。URLを直接叩くと無情な「404 Not Found」が返ってきました。\n\n理由は単純明快。\n\nLaravelのシンボリックリンク（`storage`から`public/storage`へのリンク）が未生成、あるいはパスが狂っていたためです。インストーラーが自動で作成を試みるケースもありますが、権限関係で失敗することが多々あります。\n\nターミナルから以下のArtisanコマンドを手動で叩き込みます。\n\n```bash\ncd /var/www/paylink\nphp artisan storage:link\n```\n\nもしすでに不完全な壊れたリンクが存在している場合は、一度`rm public/storage`で削除してから再実行してください。これでアップロード画像が正常にブラウザへ配信されるようになります。\n\n\u003ch3\u003e請求書送信がタイムアウトしバックグラウンドジョブが沈黙する罠\u003c/h3\u003e\n\n「請求書を送信」ボタンをクリックするとブラウザの読み込みが1分近く続き、最終的に「504 Gateway Time-out」で落ちる事象が発生しました。\n\nコードを追跡したところ、デフォルト設定ではメール送信とPDF生成が同期（Synchronous）処理で走っていました。さらにSMTPサーバーへの接続遅延が重なり、PHPの実行時間上限（`max_execution_time`）を突破していたのです。\n\nこの問題を根本から解決するため、キュー処理を非同期へ切り替えました。\n\n`.env`ファイルを編集：\n\n```env\nQUEUE_CONNECTION=database\n```\n\nそして、バックグラウンドでキューを常時監視・処理させるため、Supervisorの設定ファイル（`/etc/supervisor/conf.d/paylink-worker.conf`）を作成してデーモン化します。\n\n```ini\n[program:paylink-worker]\nprocess_name=%(program_name)s_%(process_num)02d\ncommand=php /var/www/paylink/artisan queue:work database --sleep=3 --tries=3 --max-time=3600\nautostart=true\nautorestart=true\nstopasgroup=true\nkillasgroup=true\nuser=www-data\nnumprocs=2\nredirect_stderr=true\nstdout_logfile=/var/www/paylink/storage/logs/worker.log\nstopwaitsecs=3600\n```\n\n`sudo supervisorctl reread \u0026\u0026 sudo supervisorctl update`を実行。\n\nこれで請求書送信ボタンを押した瞬間に画面は即座に完了となり、重たいPDFレンダリングとメール配送は裏側のワーカープロセスによって数秒で安全に処理されるようになりました。\n\n\u003ch3\u003eMySQL 8.0の厳格モードによる会計集計クエリの爆破\u003c/h3\u003e\n\n収支レポート（Income \u0026 Expense）の月別グラフを開いた瞬間、画面にLaravelのデバッグ画面が炸裂しました。\n\n```text\nSQLSTATE[42000]: Syntax error or access violation: 1055 'paylink.incomes.created_at' isn't in GROUP BY\n```\n\nMySQL 8.0以降でデフォルト有効化されている`ONLY_FULL_GROUP_BY`モードと、PayLinkの会計集計コントローラー内のSQLクエリが衝突していました。集計対象外のカラムが`GROUP BY`句に含まれていない旧来の書き方が残っていたのです。\n\n最も安全で手早い現場対処として、Laravel側のデータベース設定（`config/database.php`）でMySQLの厳格モードを部分的に調整しました。\n\n```php\n'mysql' =\u003e [\n    // ...\n    'strict' =\u003e true,\n    'modes' =\u003e [\n        'STRICT_TRANS_TABLES',\n        'NO_ZERO_IN_DATE',\n        'NO_ZERO_DATE',\n        'ERROR_FOR_DIVISION_BY_ZERO',\n        'NO_ENGINE_SUBSTITUTION',\n    ],\n],\n```\n\n`config:clear`を実行してキャッシュを吹き飛ばすことで、エラーは綺麗に消え去り、月別の美しい損益グラフが正常にプロットされるようになりました。\n\n\u003ch3\u003eCronスケジューラーの未登録による定期請求の完全蒸発\u003c/h3\u003e\n\n「毎月1日に自動発行されるはずの定期請求書が1件も発行されていない」\n\nクライアントから突っ込まれたら血の気が引くトラブルです。開発チームがCronの設定を忘れていたために発生した人為的ミスでした。\n\nサーバーのcrontabを開きます。\n\n```bash\nsudo crontab -u www-data -e\n```\n\n以下の1行を必ず登録してください。\n\n```cron\n* * * * * cd /var/www/paylink \u0026\u0026 php artisan schedule:run \u003e\u003e /dev/null 2\u003e\u00261\n```\n\nLaravelのスケジューラーが毎分起動し、期限切れのアセット通知、定期請求書の発行、未払い督促メールのトリガーを一元管理します。これを忘れたPayLinkは、片肺飛行の飛行機と同じです。\n\n\u003ch2\u003e2026年のアーキテクチャ視点：セキュリティ・データ主権・AI時代の優位性\u003c/h2\u003e\n\nクラウド型SaaSの利用が当たり前になった今、なぜあえてセルフホストのLaravel SaaSを選ぶのか。\n\n2026年現在のB2B市場において、企業の意思決定基準は劇的に変化しています。背景にあるのは、厳格化するデータプライバシー規制（GDPR、改正個人情報保護法）と、高騰し続ける外資系クラウドサービスの利用コストです。\n\n\u003ch3\u003e完全なデータ主権（Data Sovereignty）の確保\u003c/h3\u003e\n\n顧客の機密情報、取引単価、社内資産のシリアルナンバー、給与情報――これらを海外ベンダーのサーバーに預けること自体がリスクと見なされるケースが増えています。\n\nPayLinkを国内のセキュアなプライベートクラウドや自社管理VPSにホストすることで、データベースの物理的な所在地を自社の完全な支配下に置くことができます。暗号化バックアップやログ監査を自社のセキュリティポリシーに合わせて100%カスタマイズできる自由度は、エンタープライズ顧客への提案時における決定的なアドバンテージとなります。\n\n\u003ch3\u003e生成AI・社内LLMとの安全なデータ連携\u003c/h3\u003e\n\n検索エンジンのアルゴリズムや社内業務の自動化において、AEO（Answer Engine Optimization）やプライベートAIの活用が日常化しました。\n\n自前のMySQLデータベースにすべての業務ログ（請求、資産、タスク、問い合わせ）が集約されているため、将来的に社内クローズドなLLM（ローカルLLM）と連携させ、「先月の未払い総額と回収優先度の高いクライアントをリストアップして」といった自然言語クエリを安全に実行できる基盤としても機能します。\n\n\u003ch2\u003e総括：PayLinkを導入すべき企業、敬遠すべき組織\u003c/h2\u003e\n\nPayLinkは、非常に野心的なプロダクトです。\n\n向いているのは、Linuxサーバーの基礎知識を持ち、社内の複数ツールを統合して固定費を劇的に削減したいITエージェンシー、開発会社、あるいはスタートアップ企業です。また、自社の顧客向けにブランドを被せて「自社製B2Bプラットフォーム」としてサブスクリプション展開したい事業者にとっても、開発工数を年単位でスキップできる最高のベースキャンプになります。\n\n一方で、ターミナルを開くことに恐怖を感じる非技術者や、24時間365日の手厚いベンダーサポートを電話で受けたい保守的な組織には全くおすすめしません。トラブルが起きたとき、ログを読み、コードを追い、Nginxを再起動するのはあなた自身だからです。\n\nだが、その技術的ハードルを越えられるエンジニアにとって、このシステムのコストパフォーマンスと拡張性の高さは、極めて強力な競争力をもたらしてくれるはずです。\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T02:44:57+09:00","group":null,"id":"4c8285017cf5f0d0a6f5","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"Laravel","versions":[]},{"name":"SaaS","versions":[]}],"title":"PayLink Laravel SaaS for Invoicing, Project \u0026 Asset検証：導入と不具合対策","updated_at":"2026-11-18T02:44:57+09:00","url":"https://qiita.com/gplpal/items/4c8285017cf5f0d0a6f5","user":{"description":null,"facebook_id":null,"followees_count":1,"followers_count":0,"github_login_name":null,"id":"gplpal","items_count":25,"linkedin_id":null,"location":null,"name":"","organization":null,"permanent_id":4508237,"profile_image_url":"https://secure.gravatar.com/avatar/d748d17f29d382cb915d7bd8cf39cf74","team_only":false,"twitter_screen_name":null,"website_url":null},"page_views_count":null,"team_membership":null,"organization_url_name":null,"slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003ch2\u003e\n\u003cspan id=\"ページビルダー肥大化への反逆kutakを本番投入して突きつけられた現実\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%9A%E3%83%BC%E3%82%B8%E3%83%93%E3%83%AB%E3%83%80%E3%83%BC%E8%82%A5%E5%A4%A7%E5%8C%96%E3%81%B8%E3%81%AE%E5%8F%8D%E9%80%86kutak%E3%82%92%E6%9C%AC%E7%95%AA%E6%8A%95%E5%85%A5%E3%81%97%E3%81%A6%E7%AA%81%E3%81%8D%E3%81%A4%E3%81%91%E3%82%89%E3%82%8C%E3%81%9F%E7%8F%BE%E5%AE%9F\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eページビルダー肥大化への反逆：Kutakを本番投入して突きつけられた現実\u003c/h2\u003e\n\u003cp data-sourcepos=\"3:1-3:36\"\u003eページビルダーを捨てろ。\u003c/p\u003e\n\u003cp data-sourcepos=\"5:1-5:528\"\u003e数十メガバイトのJavaScript、無駄に多層化されたdivタグの海、モバイルで引っかかるスクロール――現代のWordPressサイトが抱える肥大化（Bloat）への苛立ちは、エンジニアなら誰しも一度は飲み込んだ苦い記憶のはずです。読者が求めているのは、過剰な視差効果でも派手なローディングアニメーションでもありません。ただ「速く、美しく、ストレスなく文字が読めること」、それだけです。\u003c/p\u003e\n\u003cp data-sourcepos=\"7:1-7:268\"\u003eそうした原点回帰の思想を掲げてAPALODIがリリースし、バージョン3.0でPHP・JS・CSSの全コードベースを完全刷新したのが\u003ca href=\"https://gplpal.com/product/kutak-minimal-blog-wordpress-theme/\" rel=\"nofollow noopener\" target=\"_blank\"\u003eKutak Minimal Blog WordPress Theme\u003c/a\u003eです。\u003c/p\u003e\n\u003cp data-sourcepos=\"9:1-9:300\"\u003e私たちはこのテーマを、実運用のトラフィックを想定したステージング環境（Nginx 1.24 / PHP 8.2 / MariaDB 10.11 / Redisオブジェクトキャッシュ有効）にデプロイし、3週間にわたって徹底的に負荷とカスタマイズを叩き込みました。\u003c/p\u003e\n\u003cp data-sourcepos=\"11:1-11:39\"\u003e先に結論を投げておきます。\u003c/p\u003e\n\u003cp data-sourcepos=\"13:1-13:225\"\u003e飾り気のない個人ブログや、純粋なテキスト勝負のミニマルマガジンを運営するなら、現行のWordPressエコシステムにおいてこれ以上軽快な選択肢は滅多にありません。\u003c/p\u003e\n\u003cp data-sourcepos=\"15:1-15:45\"\u003eしかし、甘く見てはいけません。\u003c/p\u003e\n\u003cp data-sourcepos=\"17:1-17:373\"\u003e「ミニマル」という言葉は、裏を返せば「テーマ側で手取り足取り面倒を見ない」という意味でもあります。Elementorのようなマウス操作での微調整に慣れきった非エンジニアが手を出すと、CSSの継承問題や Gutenbergブロックの制約にぶつかり、途方に暮れることになるはずです。\u003c/p\u003e\n\u003ch2\u003e\n\u003cspan id=\"開発者が唸ったミニマリズムの設計思想kutakの真価\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E9%96%8B%E7%99%BA%E8%80%85%E3%81%8C%E5%94%B8%E3%81%A3%E3%81%9F%E3%83%9F%E3%83%8B%E3%83%9E%E3%83%AA%E3%82%BA%E3%83%A0%E3%81%AE%E8%A8%AD%E8%A8%88%E6%80%9D%E6%83%B3kutak%E3%81%AE%E7%9C%9F%E4%BE%A1\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e開発者が唸ったミニマリズムの設計思想：Kutakの真価\u003c/h2\u003e\n\u003cp data-sourcepos=\"21:1-21:252\"\u003eデモ画面を眺めているだけでは、このテーマの本質は見えてきません。ブラウザの開発者ツールを開き、DOMツリーを展開した瞬間に、製作者の偏執的なまでのこだわりが伝わってきます。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"divツリーの浅さとセマンティックなhtml5\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#div%E3%83%84%E3%83%AA%E3%83%BC%E3%81%AE%E6%B5%85%E3%81%95%E3%81%A8%E3%82%BB%E3%83%9E%E3%83%B3%E3%83%86%E3%82%A3%E3%83%83%E3%82%AF%E3%81%AAhtml5\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003edivツリーの浅さとセマンティックなHTML5\u003c/h3\u003e\n\u003cp data-sourcepos=\"25:1-25:152\"\u003e多くの多機能テーマは、テキストブロックを1つ表示するだけで10層以上のコンテナを重ねます。Kutakは違います。\u003c/p\u003e\n\u003cp data-sourcepos=\"27:1-27:458\"\u003e\u003ccode\u003e\u0026lt;article\u0026gt;\u003c/code\u003e、\u003ccode\u003e\u0026lt;header\u0026gt;\u003c/code\u003e、\u003ccode\u003e\u0026lt;main\u0026gt;\u003c/code\u003e、\u003ccode\u003e\u0026lt;time\u0026gt;\u003c/code\u003eといったHTML5の標準要素が、教科書通りに美しく並びます。DOM深度が極めて浅いため、ブラウザのスタイル計算とレンダリングパイプラインに負荷をかけません。ページをスクロールした際のフレームレートが常に60fpsに張り付く快感は、余計なライブラリを削ぎ落とした設計だからこそ味わえる特権です。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"3つのページネーション戦略とuxの分岐\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#3%E3%81%A4%E3%81%AE%E3%83%9A%E3%83%BC%E3%82%B8%E3%83%8D%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E6%88%A6%E7%95%A5%E3%81%A8ux%E3%81%AE%E5%88%86%E5%B2%90\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e3つのページネーション戦略とUXの分岐\u003c/h3\u003e\n\u003cp data-sourcepos=\"31:1-31:148\"\u003eブログの回遊性を左右する記事一覧のページ送りには、現場の好みに応じた3種類の挙動が用意されています。\u003c/p\u003e\n\u003cul data-sourcepos=\"33:1-36:0\"\u003e\n\u003cli data-sourcepos=\"33:1-33:152\"\u003eクラシックな数字付きページネーション（SEO観点で最もクローラーに優しく、予期せぬスクロール酔いを防ぐ）\u003c/li\u003e\n\u003cli data-sourcepos=\"34:1-34:168\"\u003e「さらに読み込む（Load More）」AJAXボタン（ユーザーの自発的なタップをトリガーにするため、無駄なリクエストを最小化）\u003c/li\u003e\n\u003cli data-sourcepos=\"35:1-36:0\"\u003e無限スクロール（Infinite Scroll：SNSライクな没入感を生み出すが、フッターへの到達が困難になる諸刃の剣）\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"37:1-37:267\"\u003eこの選択肢の切り替えが、管理画面の「外観」\u0026gt;「カスタマイズ」から1タップで完了します。特に「Load More」の挙動は軽量なVanilla JSで書かれており、重厚なjQuery依存を排除している点が現代的です。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"タググロッサリーとカテゴリ専用テンプレートの構造的威力\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%BF%E3%82%B0%E3%82%B0%E3%83%AD%E3%83%83%E3%82%B5%E3%83%AA%E3%83%BC%E3%81%A8%E3%82%AB%E3%83%86%E3%82%B4%E3%83%AA%E5%B0%82%E7%94%A8%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%E3%81%AE%E6%A7%8B%E9%80%A0%E7%9A%84%E5%A8%81%E5%8A%9B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eタググロッサリーとカテゴリ専用テンプレートの構造的威力\u003c/h3\u003e\n\u003cp data-sourcepos=\"41:1-41:178\"\u003e地味ですが、コンテンツマーケティングの観点から絶叫したくなるほど優れた機能が「Tagmap / Tags Glossary」ページテンプレートです。\u003c/p\u003e\n\u003cp data-sourcepos=\"43:1-43:431\"\u003eサイト内の全タグをアルファベット順（または日本語なら50音順の辞書形式）で一覧表示し、内部リンクの網の目を自動構築してくれます。数千記事規模のアーカイブを抱える雑記ブログや技術ブログにおいて、埋もれがちな過去記事へのクローラビリティを劇的に改善する仕組みが最初からテーマに内蔵されています。\u003c/p\u003e\n\u003ch2\u003e\n\u003cspan id=\"エンジニア目線の導入手順無駄を削ぎ落とした環境構築\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%A8%E3%83%B3%E3%82%B8%E3%83%8B%E3%82%A2%E7%9B%AE%E7%B7%9A%E3%81%AE%E5%B0%8E%E5%85%A5%E6%89%8B%E9%A0%86%E7%84%A1%E9%A7%84%E3%82%92%E5%89%8A%E3%81%8E%E8%90%BD%E3%81%A8%E3%81%97%E3%81%9F%E7%92%B0%E5%A2%83%E6%A7%8B%E7%AF%89\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eエンジニア目線の導入手順：無駄を削ぎ落とした環境構築\u003c/h2\u003e\n\u003cp data-sourcepos=\"47:1-47:81\"\u003e環境構築に余計なライセンス認証の儀式は必要ありません。\u003c/p\u003e\n\u003cp data-sourcepos=\"49:1-49:448\"\u003e私たちが本番前のテスト環境でテーマバイナリを調達する際、コード改変や不正スクリプト混入の監査が徹底されている \u003ca href=\"https://gplpal.com/\" rel=\"nofollow noopener\" target=\"_blank\"\u003egplpal\u003c/a\u003e を基準に選定しているのもそのためです。クリーンなソースコードから作業を開始できる安心感は、予期せぬバックドアやエラーの切り分けに無駄な時間を割かないための鉄則と言えます。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"推奨サーバー設定と前提条件\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%8E%A8%E5%A5%A8%E3%82%B5%E3%83%BC%E3%83%90%E3%83%BC%E8%A8%AD%E5%AE%9A%E3%81%A8%E5%89%8D%E6%8F%90%E6%9D%A1%E4%BB%B6\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e推奨サーバー設定と前提条件\u003c/h3\u003e\n\u003cp data-sourcepos=\"53:1-53:175\"\u003eKutakは軽量ですが、最新のPHP 8.1〜8.3環境でその真価を発揮します。古いPHP 7.4のまま放置されたサーバーに投げ込むのは論外です。\u003c/p\u003e\n\u003cul data-sourcepos=\"55:1-59:0\"\u003e\n\u003cli data-sourcepos=\"55:1-55:47\"\u003ePHPバージョン：8.1以上（8.2推奨）\u003c/li\u003e\n\u003cli data-sourcepos=\"56:1-56:54\"\u003e\n\u003ccode\u003ememory_limit\u003c/code\u003e：128M以上（256Mあれば盤石）\u003c/li\u003e\n\u003cli data-sourcepos=\"57:1-57:31\"\u003e\n\u003ccode\u003emax_execution_time\u003c/code\u003e：120秒\u003c/li\u003e\n\u003cli data-sourcepos=\"58:1-59:0\"\u003eOPcache：有効化必須（メモリ割り当て128MB以上）\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch3\u003e\n\u003cspan id=\"インストールからアクティベーション\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%81%8B%E3%82%89%E3%82%A2%E3%82%AF%E3%83%86%E3%82%A3%E3%83%99%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eインストールからアクティベーション\u003c/h3\u003e\n\u003cp data-sourcepos=\"62:1-62:163\"\u003e管理画面の「外観」\u0026gt;「テーマ」\u0026gt;「新規追加」から、配布パッケージを展開して得られる\u003ccode\u003ekutak.zip\u003c/code\u003eをアップロードします。\u003c/p\u003e\n\u003cp data-sourcepos=\"64:1-64:54\"\u003eここで急いで有効化してはいけません。\u003c/p\u003e\n\u003cp data-sourcepos=\"66:1-66:403\"\u003e必ず同時に同梱されている子テーマ（\u003ccode\u003ekutak-child.zip\u003c/code\u003e）もアップロードし、有効化するのは「子テーマ側」にしてください。Kutakはバージョン3.0以降、細かなCSS調整やフックの追加を頻繁に行う設計になっているため、親テーマを直接編集するとアップデート時にすべてのカスタマイズが吹き飛びます。\u003c/p\u003e\n\u003cp data-sourcepos=\"68:1-68:27\"\u003e有効化をクリック。\u003c/p\u003e\n\u003cp data-sourcepos=\"70:1-70:519\"\u003e管理画面上部に推奨プラグインの通知が出ますが、必須のものはごくわずかです。必要なウィジェット拡張や問い合わせフォーム用のプラグインだけを一括選択して有効化すれば、準備は整います。デモデータのXMLインポートも用意されていますが、純粋なブログであればダミーデータを流し込まず、既存の投稿データをそのまま当てはめた方がレイアウトの確認は圧倒的に早いです。\u003c/p\u003e\n\u003ch2\u003e\n\u003cspan id=\"現場で遭遇した不具合とリアルなデバッグ記録\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%8F%BE%E5%A0%B4%E3%81%A7%E9%81%AD%E9%81%87%E3%81%97%E3%81%9F%E4%B8%8D%E5%85%B7%E5%90%88%E3%81%A8%E3%83%AA%E3%82%A2%E3%83%AB%E3%81%AA%E3%83%87%E3%83%90%E3%83%83%E3%82%B0%E8%A8%98%E9%8C%B2\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e現場で遭遇した不具合とリアルなデバッグ記録\u003c/h2\u003e\n\u003cp data-sourcepos=\"74:1-74:270\"\u003eどんなに洗練されたテーマでも、現場のサーバー環境とプラグインが交差する交差点では必ず火花が散ります。私たちが実際に直面し、頭を抱えながら解決したトラブルのログをそのまま公開します。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"深夜の網膜を焼くダークモードのfouc未スタイル要素のフラッシュ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%B7%B1%E5%A4%9C%E3%81%AE%E7%B6%B2%E8%86%9C%E3%82%92%E7%84%BC%E3%81%8F%E3%83%80%E3%83%BC%E3%82%AF%E3%83%A2%E3%83%BC%E3%83%89%E3%81%AEfouc%E6%9C%AA%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB%E8%A6%81%E7%B4%A0%E3%81%AE%E3%83%95%E3%83%A9%E3%83%83%E3%82%B7%E3%83%A5\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e深夜の網膜を焼くダークモードのFOUC（未スタイル要素のフラッシュ）\u003c/h3\u003e\n\u003cp data-sourcepos=\"78:1-78:21\"\u003e眩しい。白い。\u003c/p\u003e\n\u003cp data-sourcepos=\"80:1-80:290\"\u003e深夜の検証作業中、ダークモードを有効にしていたブラウザをリロードした瞬間、一瞬だけ真っ白な画面がフラッシュしてから黒背景に切り替わる現象が発生しました。いわゆる「FOUC（Flash of Unstyled Content）」です。\u003c/p\u003e\n\u003cp data-sourcepos=\"82:1-82:221\"\u003eテーマ標準のダークモードスクリプトは、DOMが完全に構築された後（\u003ccode\u003eDOMContentLoaded\u003c/code\u003e）に\u003ccode\u003elocalStorage\u003c/code\u003eの値を読み取り、\u003ccode\u003ebody\u003c/code\u003eタグへ\u003ccode\u003e.dark-mode\u003c/code\u003eクラスを付与していました。\u003c/p\u003e\n\u003cp data-sourcepos=\"84:1-84:30\"\u003eこれでは遅すぎます。\u003c/p\u003e\n\u003cp data-sourcepos=\"86:1-86:166\"\u003eHTMLのパースとレンダリングが始まってからクラスを付与しているため、白から黒への反転が一瞬目視できてしまうのです。\u003c/p\u003e\n\u003cp data-sourcepos=\"88:1-88:200\"\u003eこのチラつきを根絶するため、子テーマの\u003ccode\u003efunctions.php\u003c/code\u003eから\u003ccode\u003e\u0026lt;head\u0026gt;\u003c/code\u003eタグの最上部、CSSの読み込みよりも前にインラインスクリプトを強制注入しました。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"php\" data-sourcepos=\"90:1-103:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003eadd_action( 'wp_head', function() {\n    ?\u0026gt;\n    \u003cspan class=\"nt\"\u003e\u0026lt;script\u0026gt;\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"kd\"\u003efunction\u003c/span\u003e\u003cspan class=\"p\"\u003e()\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n        \u003cspan class=\"kd\"\u003econst\u003c/span\u003e \u003cspan class=\"nx\"\u003etheme\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"nx\"\u003elocalStorage\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003egetItem\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"dl\"\u003e'\u003c/span\u003e\u003cspan class=\"s1\"\u003ekutak_theme_mode\u003c/span\u003e\u003cspan class=\"dl\"\u003e'\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n        \u003cspan class=\"k\"\u003eif \u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"nx\"\u003etheme\u003c/span\u003e \u003cspan class=\"o\"\u003e===\u003c/span\u003e \u003cspan class=\"dl\"\u003e'\u003c/span\u003e\u003cspan class=\"s1\"\u003edark\u003c/span\u003e\u003cspan class=\"dl\"\u003e'\u003c/span\u003e \u003cspan class=\"o\"\u003e||\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"o\"\u003e!\u003c/span\u003e\u003cspan class=\"nx\"\u003etheme\u003c/span\u003e \u003cspan class=\"o\"\u003e\u0026amp;\u0026amp;\u003c/span\u003e \u003cspan class=\"nb\"\u003ewindow\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003ematchMedia\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"dl\"\u003e'\u003c/span\u003e\u003cspan class=\"s1\"\u003e(prefers-color-scheme: dark)\u003c/span\u003e\u003cspan class=\"dl\"\u003e'\u003c/span\u003e\u003cspan class=\"p\"\u003e).\u003c/span\u003e\u003cspan class=\"nx\"\u003ematches\u003c/span\u003e\u003cspan class=\"p\"\u003e))\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n            \u003cspan class=\"nb\"\u003edocument\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nx\"\u003edocumentElement\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nx\"\u003eclassList\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eadd\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"dl\"\u003e'\u003c/span\u003e\u003cspan class=\"s1\"\u003edark-mode\u003c/span\u003e\u003cspan class=\"dl\"\u003e'\u003c/span\u003e\u003cspan class=\"p\"\u003e);\u003c/span\u003e\n        \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e})();\u003c/span\u003e\n    \u003cspan class=\"nt\"\u003e\u0026lt;/script\u0026gt;\u003c/span\u003e\n    \u003cspan class=\"cp\"\u003e\u0026lt;?php\u003c/span\u003e\n\u003cspan class=\"p\"\u003e},\u003c/span\u003e \u003cspan class=\"mi\"\u003e1\u003c/span\u003e \u003cspan class=\"p\"\u003e);\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"105:1-105:275\"\u003e\u003ccode\u003ebody\u003c/code\u003eではなく\u003ccode\u003edocumentElement\u003c/code\u003e（\u003ccode\u003e\u0026lt;html\u0026gt;\u003c/code\u003eタグ）に対してレンダリング前にクラスを付与し、CSSセレクタ側も\u003ccode\u003ehtml.dark-mode\u003c/code\u003eに対応させることで、ページ遷移時のフラッシュは完全に消失しました。極めて快適です。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"無限スクロールがgoogleアナリティクス4の計測を闇に葬るトラブル\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%84%A1%E9%99%90%E3%82%B9%E3%82%AF%E3%83%AD%E3%83%BC%E3%83%AB%E3%81%8Cgoogle%E3%82%A2%E3%83%8A%E3%83%AA%E3%83%86%E3%82%A3%E3%82%AF%E3%82%B94%E3%81%AE%E8%A8%88%E6%B8%AC%E3%82%92%E9%97%87%E3%81%AB%E8%91%AC%E3%82%8B%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e無限スクロールがGoogleアナリティクス4の計測を闇に葬るトラブル\u003c/h3\u003e\n\u003cp data-sourcepos=\"109:1-109:66\"\u003e「2ページ目以降のPV数がまったく取れていない」\u003c/p\u003e\n\u003cp data-sourcepos=\"111:1-111:419\"\u003eアナリティクスのリアルタイムレポートを監視していたデータアナリストからの指摘で冷や汗をかきました。原因は単純です。Kutakの無限スクロール（およびLoad More）は非同期通信（AJAX）でHTMLの断片を取得して既存のリストへ差し込むため、ブラウザのURL書き換え（\u003ccode\u003ehistory.pushState\u003c/code\u003e）を行っていなかったのです。\u003c/p\u003e\n\u003cp data-sourcepos=\"113:1-113:126\"\u003e読者がスクロールして10記事を読もうが、最初の1記事分のページビューしか計測されません。\u003c/p\u003e\n\u003cp data-sourcepos=\"115:1-115:245\"\u003e解決にあたり、KutakがAJAX完了時に発火するカスタムイベントを監視し、Googleタグ（gtag.js）へ仮想ページビュー（Virtual Pageview）を手動送信するスクリプトを子テーマに配置しました。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"javascript\" data-sourcepos=\"117:1-127:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"nb\"\u003edocument\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eaddEventListener\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"dl\"\u003e'\u003c/span\u003e\u003cspan class=\"s1\"\u003ekutak_posts_loaded\u003c/span\u003e\u003cspan class=\"dl\"\u003e'\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"kd\"\u003efunction\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"nx\"\u003ee\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eif \u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"k\"\u003etypeof\u003c/span\u003e \u003cspan class=\"nx\"\u003egtag\u003c/span\u003e \u003cspan class=\"o\"\u003e===\u003c/span\u003e \u003cspan class=\"dl\"\u003e'\u003c/span\u003e\u003cspan class=\"s1\"\u003efunction\u003c/span\u003e\u003cspan class=\"dl\"\u003e'\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n        \u003cspan class=\"nf\"\u003egtag\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"dl\"\u003e'\u003c/span\u003e\u003cspan class=\"s1\"\u003eevent\u003c/span\u003e\u003cspan class=\"dl\"\u003e'\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"dl\"\u003e'\u003c/span\u003e\u003cspan class=\"s1\"\u003epage_view\u003c/span\u003e\u003cspan class=\"dl\"\u003e'\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n            \u003cspan class=\"na\"\u003epage_title\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"nb\"\u003edocument\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nx\"\u003etitle\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n            \u003cspan class=\"na\"\u003epage_location\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"nb\"\u003ewindow\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nx\"\u003elocation\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nx\"\u003ehref\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n            \u003cspan class=\"na\"\u003epage_path\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"nb\"\u003ewindow\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nx\"\u003elocation\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nx\"\u003epathname\u003c/span\u003e\n        \u003cspan class=\"p\"\u003e});\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003cspan class=\"p\"\u003e});\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"129:1-129:279\"\u003eこれでスクロールによって新規記事が読み込まれるたび、アナリティクス側へ正確な閲覧シグナルが飛ぶようになります。メディア運営において計測漏れは致命傷です。必ず本番公開前に検証してください。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"safariでsvgロゴが画面いっぱいに巨大化するレイアウト崩壊\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#safari%E3%81%A7svg%E3%83%AD%E3%82%B4%E3%81%8C%E7%94%BB%E9%9D%A2%E3%81%84%E3%81%A3%E3%81%B1%E3%81%84%E3%81%AB%E5%B7%A8%E5%A4%A7%E5%8C%96%E3%81%99%E3%82%8B%E3%83%AC%E3%82%A4%E3%82%A2%E3%82%A6%E3%83%88%E5%B4%A9%E5%A3%8A\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eSafariでSVGロゴが画面いっぱいに巨大化するレイアウト崩壊\u003c/h3\u003e\n\u003cp data-sourcepos=\"133:1-133:253\"\u003eChromeで完璧に見えていたサイトを、手元のiPhone Safariで確認した瞬間に息が止まりました。ヘッダーのSVGロゴが画面全体の横幅を突き抜け、ナビゲーションをすべて押し出していたのです。\u003c/p\u003e\n\u003cp data-sourcepos=\"135:1-135:81\"\u003eWebKitブラウザにおけるSVGレンダリングの古典的なバグです。\u003c/p\u003e\n\u003cp data-sourcepos=\"137:1-137:223\"\u003eKutakの初期スタイルシートではロゴ画像に対して\u003ccode\u003emax-width: 100%\u003c/code\u003eしか指定されておらず、SVG内部の\u003ccode\u003eviewBox\u003c/code\u003eアスペクト比計算がSafari上で正しく解決されていませんでした。\u003c/p\u003e\n\u003cp data-sourcepos=\"139:1-139:71\"\u003e子テーマの\u003ccode\u003estyle.css\u003c/code\u003eに以下のコードをねじ込みます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"css\" data-sourcepos=\"141:1-148:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"nc\"\u003e.site-branding\u003c/span\u003e \u003cspan class=\"nc\"\u003e.custom-logo-link\u003c/span\u003e \u003cspan class=\"nt\"\u003esvg\u003c/span\u003e\u003cspan class=\"o\"\u003e,\u003c/span\u003e\n\u003cspan class=\"nc\"\u003e.site-branding\u003c/span\u003e \u003cspan class=\"nt\"\u003eimg\u003c/span\u003e\u003cspan class=\"o\"\u003e[\u003c/span\u003e\u003cspan class=\"nt\"\u003esrc\u003c/span\u003e\u003cspan class=\"err\"\u003e$\u003c/span\u003e\u003cspan class=\"o\"\u003e=\u003c/span\u003e\u003cspan class=\"s1\"\u003e\".svg\"\u003c/span\u003e\u003cspan class=\"o\"\u003e]\u003c/span\u003e \u003cspan class=\"p\"\u003e{\u003c/span\u003e\n    \u003cspan class=\"nl\"\u003ewidth\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"m\"\u003e180px\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e \u003cspan class=\"c\"\u003e/* 任意の固定幅 */\u003c/span\u003e\n    \u003cspan class=\"nl\"\u003eheight\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"nb\"\u003eauto\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n    \u003cspan class=\"nl\"\u003emax-width\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e \u003cspan class=\"m\"\u003e100%\u003c/span\u003e\u003cspan class=\"p\"\u003e;\u003c/span\u003e\n\u003cspan class=\"p\"\u003e}\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"150:1-150:214\"\u003e明示的な横幅（\u003ccode\u003ewidth\u003c/code\u003e）を与えることで、ブラウザエンジンに対する曖昧さを排除します。これでiOS環境でも意図通りのプロポーションでロゴが収まりました。\u003c/p\u003e\n\u003ch3\u003e\n\u003cspan id=\"gutenbergの全幅alignfullブロックが引き起こす横スクロール\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#gutenberg%E3%81%AE%E5%85%A8%E5%B9%85alignfull%E3%83%96%E3%83%AD%E3%83%83%E3%82%AF%E3%81%8C%E5%BC%95%E3%81%8D%E8%B5%B7%E3%81%93%E3%81%99%E6%A8%AA%E3%82%B9%E3%82%AF%E3%83%AD%E3%83%BC%E3%83%AB\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eGutenbergの全幅（alignfull）ブロックが引き起こす横スクロール\u003c/h3\u003e\n\u003cp data-sourcepos=\"154:1-154:195\"\u003e記事内に大きな写真を見せようと「全幅画像」を配置したところ、モバイル端末で微妙に左右へ画面がグラグラと横揺れする現象が起きました。\u003c/p\u003e\n\u003cp data-sourcepos=\"156:1-156:390\"\u003e原因を辿ると、Kutakのミニマルなシングルカラムレイアウトに対し、全幅ブロックが\u003ccode\u003emargin-left: calc(-50vw + 50%)\u003c/code\u003eというCSS手法でビューポート端まで画像を引っ張っていました。この計算時にブラウザの垂直スクロールバーの幅（約15px）が加算され、横幅が100%をオーバーフローしていたのです。\u003c/p\u003e\n\u003cp data-sourcepos=\"158:1-158:190\"\u003e親要素のラッパーに対して\u003ccode\u003eoverflow-x: clip;\u003c/code\u003eを付与することで、レイアウトの美しさを保ったまま不快な横スクロールを完全に封じ込めました。\u003c/p\u003e\n\u003ch2\u003e\n\u003cspan id=\"2026年の検索エコシステムseogeoaeoにおけるkutakの戦闘力\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#2026%E5%B9%B4%E3%81%AE%E6%A4%9C%E7%B4%A2%E3%82%A8%E3%82%B3%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0seogeoaeo%E3%81%AB%E3%81%8A%E3%81%91%E3%82%8Bkutak%E3%81%AE%E6%88%A6%E9%97%98%E5%8A%9B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e2026年の検索エコシステム（SEO/GEO/AEO）におけるKutakの戦闘力\u003c/h2\u003e\n\u003cp data-sourcepos=\"162:1-162:39\"\u003e検索の世界は劇変しました。\u003c/p\u003e\n\u003cp data-sourcepos=\"164:1-164:308\"\u003e従来のキーワードマッチングを中心としたSEOに加え、生成AI（SearchGPT、Perplexity、Gemini）が最適な回答を直接抽出する「GEO（Generative Engine Optimization）」および「AEO（Answer Engine Optimization）」の評価軸が決定的な意味を持っています。\u003c/p\u003e\n\u003cp data-sourcepos=\"166:1-166:80\"\u003eこの新しい戦場において、Kutakの構造は驚くほど強力です。\u003c/p\u003e\n\u003cp data-sourcepos=\"168:1-168:339\"\u003eAIエージェントのクローラーは、重厚なスクリプトを実行してDOMを展開するようなコストの高いWebサイトを嫌います。軽量で、テキストとHTMLタグの比率（Text-to-HTML Ratio）が高く、情報が明確に構造化されているページを好んで参照元として引用します。\u003c/p\u003e\n\u003cul data-sourcepos=\"170:1-173:0\"\u003e\n\u003cli data-sourcepos=\"170:1-170:191\"\u003e\n\u003cstrong\u003eCore Web Vitalsの圧倒的スコア\u003c/strong\u003e：余計なスクリプトがないため、新指標である「INP（Interaction to Next Paint）」は容易に30ms以下を叩き出します。\u003c/li\u003e\n\u003cli data-sourcepos=\"171:1-171:208\"\u003e\n\u003cstrong\u003eArticle構造化データのネイティブ最適化\u003c/strong\u003e：見出し構造（h1からh4の階層関係）が壊れにくく、AIクローラーが記事の要約ポイントを迷わず特定できます。\u003c/li\u003e\n\u003cli data-sourcepos=\"172:1-173:0\"\u003e\n\u003cstrong\u003eクリーンなコンテンツツリー\u003c/strong\u003e：ページビルダー特有の入れ子構造が存在しないため、機械学習モデルがテキストコンテキストをノイズなしで解釈可能です。\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"174:1-174:319\"\u003e私たちはさらに検索エンジンの理解を深めるため、子テーマ側でJSON-LDの著者情報（\u003ccode\u003eauthor\u003c/code\u003e）と専門分野（\u003ccode\u003eknowsAbout\u003c/code\u003e）を拡充する微調整を施しました。個人の専門性（E-E-A-T）をダイレクトに検索アルゴリズムへ伝えるための必須処置です。\u003c/p\u003e\n\u003ch2\u003e\n\u003cspan id=\"総合評価このテーマに投資すべきユーザーの境界線\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%B7%8F%E5%90%88%E8%A9%95%E4%BE%A1%E3%81%93%E3%81%AE%E3%83%86%E3%83%BC%E3%83%9E%E3%81%AB%E6%8A%95%E8%B3%87%E3%81%99%E3%81%B9%E3%81%8D%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%81%AE%E5%A2%83%E7%95%8C%E7%B7%9A\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e総合評価：このテーマに投資すべきユーザーの境界線\u003c/h2\u003e\n\u003cp data-sourcepos=\"178:1-178:54\"\u003e万人受けするテーマなど存在しません。\u003c/p\u003e\n\u003cp data-sourcepos=\"180:1-180:425\"\u003eKutakを選ぶべきなのは、ライティングに情熱を注ぎ、余計な装飾を排して記事そのものの力で勝負したいブロガー、エッセイスト、あるいは個人のオピニオンを発信する開発者です。爆速の表示スピードと洗練されたタイポグラフィは、一度体験すると二度と重厚な汎用テーマへ戻れなくなる中毒性を持っています。\u003c/p\u003e\n\u003cp data-sourcepos=\"182:1-182:353\"\u003e一方で、ドラッグ＆ドロップでランディングページのような複雑なカラムレイアウトを作りたい人や、ボタン一つで無数のアニメーションを散りばめたい人には全く向きません。それはKutakの思想に対する冒涜であり、お互いにとって不幸な結果を生むだけです。\u003c/p\u003e\n\u003cp data-sourcepos=\"184:1-184:72\"\u003e「速さは正義であり、文字こそがコンテンツである」\u003c/p\u003e\n\u003cp data-sourcepos=\"186:1-186:195\"\u003eこの哲学に共鳴できる書き手にとって、Kutakは2026年現在の混沌としたテーマ市場の中で、静かに、しかし強烈に輝く最良の相棒となるはずです。\u003c/p\u003e\n","body":"\u003ch2\u003eページビルダー肥大化への反逆：Kutakを本番投入して突きつけられた現実\u003c/h2\u003e\n\nページビルダーを捨てろ。\n\n数十メガバイトのJavaScript、無駄に多層化されたdivタグの海、モバイルで引っかかるスクロール――現代のWordPressサイトが抱える肥大化（Bloat）への苛立ちは、エンジニアなら誰しも一度は飲み込んだ苦い記憶のはずです。読者が求めているのは、過剰な視差効果でも派手なローディングアニメーションでもありません。ただ「速く、美しく、ストレスなく文字が読めること」、それだけです。\n\nそうした原点回帰の思想を掲げてAPALODIがリリースし、バージョン3.0でPHP・JS・CSSの全コードベースを完全刷新したのが[Kutak Minimal Blog WordPress Theme](https://gplpal.com/product/kutak-minimal-blog-wordpress-theme/)です。\n\n私たちはこのテーマを、実運用のトラフィックを想定したステージング環境（Nginx 1.24 / PHP 8.2 / MariaDB 10.11 / Redisオブジェクトキャッシュ有効）にデプロイし、3週間にわたって徹底的に負荷とカスタマイズを叩き込みました。\n\n先に結論を投げておきます。\n\n飾り気のない個人ブログや、純粋なテキスト勝負のミニマルマガジンを運営するなら、現行のWordPressエコシステムにおいてこれ以上軽快な選択肢は滅多にありません。\n\nしかし、甘く見てはいけません。\n\n「ミニマル」という言葉は、裏を返せば「テーマ側で手取り足取り面倒を見ない」という意味でもあります。Elementorのようなマウス操作での微調整に慣れきった非エンジニアが手を出すと、CSSの継承問題や Gutenbergブロックの制約にぶつかり、途方に暮れることになるはずです。\n\n\u003ch2\u003e開発者が唸ったミニマリズムの設計思想：Kutakの真価\u003c/h2\u003e\n\nデモ画面を眺めているだけでは、このテーマの本質は見えてきません。ブラウザの開発者ツールを開き、DOMツリーを展開した瞬間に、製作者の偏執的なまでのこだわりが伝わってきます。\n\n\u003ch3\u003edivツリーの浅さとセマンティックなHTML5\u003c/h3\u003e\n\n多くの多機能テーマは、テキストブロックを1つ表示するだけで10層以上のコンテナを重ねます。Kutakは違います。\n\n`\u003carticle\u003e`、`\u003cheader\u003e`、`\u003cmain\u003e`、`\u003ctime\u003e`といったHTML5の標準要素が、教科書通りに美しく並びます。DOM深度が極めて浅いため、ブラウザのスタイル計算とレンダリングパイプラインに負荷をかけません。ページをスクロールした際のフレームレートが常に60fpsに張り付く快感は、余計なライブラリを削ぎ落とした設計だからこそ味わえる特権です。\n\n\u003ch3\u003e3つのページネーション戦略とUXの分岐\u003c/h3\u003e\n\nブログの回遊性を左右する記事一覧のページ送りには、現場の好みに応じた3種類の挙動が用意されています。\n\n* クラシックな数字付きページネーション（SEO観点で最もクローラーに優しく、予期せぬスクロール酔いを防ぐ）\n* 「さらに読み込む（Load More）」AJAXボタン（ユーザーの自発的なタップをトリガーにするため、無駄なリクエストを最小化）\n* 無限スクロール（Infinite Scroll：SNSライクな没入感を生み出すが、フッターへの到達が困難になる諸刃の剣）\n\nこの選択肢の切り替えが、管理画面の「外観」\u003e「カスタマイズ」から1タップで完了します。特に「Load More」の挙動は軽量なVanilla JSで書かれており、重厚なjQuery依存を排除している点が現代的です。\n\n\u003ch3\u003eタググロッサリーとカテゴリ専用テンプレートの構造的威力\u003c/h3\u003e\n\n地味ですが、コンテンツマーケティングの観点から絶叫したくなるほど優れた機能が「Tagmap / Tags Glossary」ページテンプレートです。\n\nサイト内の全タグをアルファベット順（または日本語なら50音順の辞書形式）で一覧表示し、内部リンクの網の目を自動構築してくれます。数千記事規模のアーカイブを抱える雑記ブログや技術ブログにおいて、埋もれがちな過去記事へのクローラビリティを劇的に改善する仕組みが最初からテーマに内蔵されています。\n\n\u003ch2\u003eエンジニア目線の導入手順：無駄を削ぎ落とした環境構築\u003c/h2\u003e\n\n環境構築に余計なライセンス認証の儀式は必要ありません。\n\n私たちが本番前のテスト環境でテーマバイナリを調達する際、コード改変や不正スクリプト混入の監査が徹底されている [gplpal](https://gplpal.com/) を基準に選定しているのもそのためです。クリーンなソースコードから作業を開始できる安心感は、予期せぬバックドアやエラーの切り分けに無駄な時間を割かないための鉄則と言えます。\n\n\u003ch3\u003e推奨サーバー設定と前提条件\u003c/h3\u003e\n\nKutakは軽量ですが、最新のPHP 8.1〜8.3環境でその真価を発揮します。古いPHP 7.4のまま放置されたサーバーに投げ込むのは論外です。\n\n* PHPバージョン：8.1以上（8.2推奨）\n* `memory_limit`：128M以上（256Mあれば盤石）\n* `max_execution_time`：120秒\n* OPcache：有効化必須（メモリ割り当て128MB以上）\n\n\u003ch3\u003eインストールからアクティベーション\u003c/h3\u003e\n\n管理画面の「外観」\u003e「テーマ」\u003e「新規追加」から、配布パッケージを展開して得られる`kutak.zip`をアップロードします。\n\nここで急いで有効化してはいけません。\n\n必ず同時に同梱されている子テーマ（`kutak-child.zip`）もアップロードし、有効化するのは「子テーマ側」にしてください。Kutakはバージョン3.0以降、細かなCSS調整やフックの追加を頻繁に行う設計になっているため、親テーマを直接編集するとアップデート時にすべてのカスタマイズが吹き飛びます。\n\n有効化をクリック。\n\n管理画面上部に推奨プラグインの通知が出ますが、必須のものはごくわずかです。必要なウィジェット拡張や問い合わせフォーム用のプラグインだけを一括選択して有効化すれば、準備は整います。デモデータのXMLインポートも用意されていますが、純粋なブログであればダミーデータを流し込まず、既存の投稿データをそのまま当てはめた方がレイアウトの確認は圧倒的に早いです。\n\n\u003ch2\u003e現場で遭遇した不具合とリアルなデバッグ記録\u003c/h2\u003e\n\nどんなに洗練されたテーマでも、現場のサーバー環境とプラグインが交差する交差点では必ず火花が散ります。私たちが実際に直面し、頭を抱えながら解決したトラブルのログをそのまま公開します。\n\n\u003ch3\u003e深夜の網膜を焼くダークモードのFOUC（未スタイル要素のフラッシュ）\u003c/h3\u003e\n\n眩しい。白い。\n\n深夜の検証作業中、ダークモードを有効にしていたブラウザをリロードした瞬間、一瞬だけ真っ白な画面がフラッシュしてから黒背景に切り替わる現象が発生しました。いわゆる「FOUC（Flash of Unstyled Content）」です。\n\nテーマ標準のダークモードスクリプトは、DOMが完全に構築された後（`DOMContentLoaded`）に`localStorage`の値を読み取り、`body`タグへ`.dark-mode`クラスを付与していました。\n\nこれでは遅すぎます。\n\nHTMLのパースとレンダリングが始まってからクラスを付与しているため、白から黒への反転が一瞬目視できてしまうのです。\n\nこのチラつきを根絶するため、子テーマの`functions.php`から`\u003chead\u003e`タグの最上部、CSSの読み込みよりも前にインラインスクリプトを強制注入しました。\n\n```php\nadd_action( 'wp_head', function() {\n    ?\u003e\n    \u003cscript\u003e\n    (function() {\n        const theme = localStorage.getItem('kutak_theme_mode');\n        if (theme === 'dark' || (!theme \u0026\u0026 window.matchMedia('(prefers-color-scheme: dark)').matches)) {\n            document.documentElement.classList.add('dark-mode');\n        }\n    })();\n    \u003c/script\u003e\n    \u003c?php\n}, 1 );\n```\n\n`body`ではなく`documentElement`（`\u003chtml\u003e`タグ）に対してレンダリング前にクラスを付与し、CSSセレクタ側も`html.dark-mode`に対応させることで、ページ遷移時のフラッシュは完全に消失しました。極めて快適です。\n\n\u003ch3\u003e無限スクロールがGoogleアナリティクス4の計測を闇に葬るトラブル\u003c/h3\u003e\n\n「2ページ目以降のPV数がまったく取れていない」\n\nアナリティクスのリアルタイムレポートを監視していたデータアナリストからの指摘で冷や汗をかきました。原因は単純です。Kutakの無限スクロール（およびLoad More）は非同期通信（AJAX）でHTMLの断片を取得して既存のリストへ差し込むため、ブラウザのURL書き換え（`history.pushState`）を行っていなかったのです。\n\n読者がスクロールして10記事を読もうが、最初の1記事分のページビューしか計測されません。\n\n解決にあたり、KutakがAJAX完了時に発火するカスタムイベントを監視し、Googleタグ（gtag.js）へ仮想ページビュー（Virtual Pageview）を手動送信するスクリプトを子テーマに配置しました。\n\n```javascript\ndocument.addEventListener('kutak_posts_loaded', function(e) {\n    if (typeof gtag === 'function') {\n        gtag('event', 'page_view', {\n            page_title: document.title,\n            page_location: window.location.href,\n            page_path: window.location.pathname\n        });\n    }\n});\n```\n\nこれでスクロールによって新規記事が読み込まれるたび、アナリティクス側へ正確な閲覧シグナルが飛ぶようになります。メディア運営において計測漏れは致命傷です。必ず本番公開前に検証してください。\n\n\u003ch3\u003eSafariでSVGロゴが画面いっぱいに巨大化するレイアウト崩壊\u003c/h3\u003e\n\nChromeで完璧に見えていたサイトを、手元のiPhone Safariで確認した瞬間に息が止まりました。ヘッダーのSVGロゴが画面全体の横幅を突き抜け、ナビゲーションをすべて押し出していたのです。\n\nWebKitブラウザにおけるSVGレンダリングの古典的なバグです。\n\nKutakの初期スタイルシートではロゴ画像に対して`max-width: 100%`しか指定されておらず、SVG内部の`viewBox`アスペクト比計算がSafari上で正しく解決されていませんでした。\n\n子テーマの`style.css`に以下のコードをねじ込みます。\n\n```css\n.site-branding .custom-logo-link svg,\n.site-branding img[src$=\".svg\"] {\n    width: 180px; /* 任意の固定幅 */\n    height: auto;\n    max-width: 100%;\n}\n```\n\n明示的な横幅（`width`）を与えることで、ブラウザエンジンに対する曖昧さを排除します。これでiOS環境でも意図通りのプロポーションでロゴが収まりました。\n\n\u003ch3\u003eGutenbergの全幅（alignfull）ブロックが引き起こす横スクロール\u003c/h3\u003e\n\n記事内に大きな写真を見せようと「全幅画像」を配置したところ、モバイル端末で微妙に左右へ画面がグラグラと横揺れする現象が起きました。\n\n原因を辿ると、Kutakのミニマルなシングルカラムレイアウトに対し、全幅ブロックが`margin-left: calc(-50vw + 50%)`というCSS手法でビューポート端まで画像を引っ張っていました。この計算時にブラウザの垂直スクロールバーの幅（約15px）が加算され、横幅が100%をオーバーフローしていたのです。\n\n親要素のラッパーに対して`overflow-x: clip;`を付与することで、レイアウトの美しさを保ったまま不快な横スクロールを完全に封じ込めました。\n\n\u003ch2\u003e2026年の検索エコシステム（SEO/GEO/AEO）におけるKutakの戦闘力\u003c/h2\u003e\n\n検索の世界は劇変しました。\n\n従来のキーワードマッチングを中心としたSEOに加え、生成AI（SearchGPT、Perplexity、Gemini）が最適な回答を直接抽出する「GEO（Generative Engine Optimization）」および「AEO（Answer Engine Optimization）」の評価軸が決定的な意味を持っています。\n\nこの新しい戦場において、Kutakの構造は驚くほど強力です。\n\nAIエージェントのクローラーは、重厚なスクリプトを実行してDOMを展開するようなコストの高いWebサイトを嫌います。軽量で、テキストとHTMLタグの比率（Text-to-HTML Ratio）が高く、情報が明確に構造化されているページを好んで参照元として引用します。\n\n* **Core Web Vitalsの圧倒的スコア**：余計なスクリプトがないため、新指標である「INP（Interaction to Next Paint）」は容易に30ms以下を叩き出します。\n* **Article構造化データのネイティブ最適化**：見出し構造（h1からh4の階層関係）が壊れにくく、AIクローラーが記事の要約ポイントを迷わず特定できます。\n* **クリーンなコンテンツツリー**：ページビルダー特有の入れ子構造が存在しないため、機械学習モデルがテキストコンテキストをノイズなしで解釈可能です。\n\n私たちはさらに検索エンジンの理解を深めるため、子テーマ側でJSON-LDの著者情報（`author`）と専門分野（`knowsAbout`）を拡充する微調整を施しました。個人の専門性（E-E-A-T）をダイレクトに検索アルゴリズムへ伝えるための必須処置です。\n\n\u003ch2\u003e総合評価：このテーマに投資すべきユーザーの境界線\u003c/h2\u003e\n\n万人受けするテーマなど存在しません。\n\nKutakを選ぶべきなのは、ライティングに情熱を注ぎ、余計な装飾を排して記事そのものの力で勝負したいブロガー、エッセイスト、あるいは個人のオピニオンを発信する開発者です。爆速の表示スピードと洗練されたタイポグラフィは、一度体験すると二度と重厚な汎用テーマへ戻れなくなる中毒性を持っています。\n\n一方で、ドラッグ＆ドロップでランディングページのような複雑なカラムレイアウトを作りたい人や、ボタン一つで無数のアニメーションを散りばめたい人には全く向きません。それはKutakの思想に対する冒涜であり、お互いにとって不幸な結果を生むだけです。\n\n「速さは正義であり、文字こそがコンテンツである」\n\nこの哲学に共鳴できる書き手にとって、Kutakは2026年現在の混沌としたテーマ市場の中で、静かに、しかし強烈に輝く最良の相棒となるはずです。\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T02:42:40+09:00","group":null,"id":"d2f5e29097f59c8c54db","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"WordPress","versions":[]}],"title":"Kutak Minimal Blog WordPress Theme徹底検証：表示速度と不具合対策","updated_at":"2026-11-18T02:42:40+09:00","url":"https://qiita.com/gplpal/items/d2f5e29097f59c8c54db","user":{"description":null,"facebook_id":null,"followees_count":1,"followers_count":0,"github_login_name":null,"id":"gplpal","items_count":25,"linkedin_id":null,"location":null,"name":"","organization":null,"permanent_id":4508237,"profile_image_url":"https://secure.gravatar.com/avatar/d748d17f29d382cb915d7bd8cf39cf74","team_only":false,"twitter_screen_name":null,"website_url":null},"page_views_count":null,"team_membership":null,"organization_url_name":null,"slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003cp data-sourcepos=\"1:1-1:98\"\u003e「IQ120以上の人には特徴がある」という話を、ネットでよく見かけます。\u003c/p\u003e\n\u003cp data-sourcepos=\"3:1-3:84\"\u003eでも、その特徴は本当にデータで言えることなのでしょうか。\u003c/p\u003e\n\u003cp data-sourcepos=\"5:1-5:131\"\u003eこの記事では、IQ120以上の位置を計算で出し、語られがちな特徴を研究と照らして仕分けました。\u003c/p\u003e\n\u003cp data-sourcepos=\"7:1-7:109\"\u003e結論を先に書くと、\u003cstrong\u003e数字で言い切れるのは位置づけと仕事との相関まで\u003c/strong\u003eです。\u003c/p\u003e\n\u003cp data-sourcepos=\"9:1-9:105\"\u003e人柄のような特徴は、研究の側から断言できる材料が乏しいと分かりました。\u003c/p\u003e\n\u003cp data-sourcepos=\"11:1-11:114\"\u003e\u003ciframe id=\"qiita-embed-content__a5280156ad67a90b50acacd756b15443\" src=\"https://qiita.com/embed-contents/link-card#qiita-embed-content__a5280156ad67a90b50acacd756b15443\" data-content=\"https%3A%2F%2Fiq-test-official.site%2Fja%3Futm_source%3Dqiita%26utm_medium%3Dblog%26utm_campaign%3Diq120-ijou-tokuchou%26utm_content%3Dtop\" frameborder=\"0\" scrolling=\"no\" loading=\"lazy\" style=\"width:100%;\" height=\"29\"\u003e\n\u003c/iframe\u003e\n\u003c/p\u003e\n\u003ch2 data-sourcepos=\"13:1-13:56\"\u003e\n\u003cspan id=\"確かめる前にiq120の位置を数字にする\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%A2%BA%E3%81%8B%E3%82%81%E3%82%8B%E5%89%8D%E3%81%ABiq120%E3%81%AE%E4%BD%8D%E7%BD%AE%E3%82%92%E6%95%B0%E5%AD%97%E3%81%AB%E3%81%99%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e確かめる前に、IQ120の位置を数字にする\u003c/h2\u003e\n\u003cp data-sourcepos=\"15:1-15:86\"\u003e特徴を語る前に、そもそもIQ120がどこにいるのかを押さえます。\u003c/p\u003e\n\u003cp data-sourcepos=\"17:1-17:100\"\u003eIQは、中心を100、ばらつきの単位を15とする釣り鐘型の分布で表されます。\u003c/p\u003e\n\u003cp data-sourcepos=\"19:1-19:84\"\u003e標準偏差とは、データの散らばり具合を表す単位のことです。\u003c/p\u003e\n\u003cp data-sourcepos=\"21:1-21:81\"\u003eこれを使えば、IQ120が上位何%に当たるかは計算で出せます。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"python\" data-sourcepos=\"23:1-33:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"kn\"\u003eimport\u003c/span\u003e \u003cspan class=\"nn\"\u003emath\u003c/span\u003e\n\n\u003cspan class=\"k\"\u003edef\u003c/span\u003e \u003cspan class=\"nf\"\u003eupper_tail\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eiq\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003emean\u003c/span\u003e\u003cspan class=\"o\"\u003e=\u003c/span\u003e\u003cspan class=\"mi\"\u003e100\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003esd\u003c/span\u003e\u003cspan class=\"o\"\u003e=\u003c/span\u003e\u003cspan class=\"mi\"\u003e15\u003c/span\u003e\u003cspan class=\"p\"\u003e):\u003c/span\u003e\n    \u003cspan class=\"n\"\u003ez\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eiq\u003c/span\u003e \u003cspan class=\"o\"\u003e-\u003c/span\u003e \u003cspan class=\"n\"\u003emean\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e \u003cspan class=\"o\"\u003e/\u003c/span\u003e \u003cspan class=\"n\"\u003esd\u003c/span\u003e\n    \u003cspan class=\"k\"\u003ereturn\u003c/span\u003e \u003cspan class=\"n\"\u003ez\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mf\"\u003e0.5\u003c/span\u003e \u003cspan class=\"o\"\u003e*\u003c/span\u003e \u003cspan class=\"n\"\u003emath\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eerfc\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003ez\u003c/span\u003e \u003cspan class=\"o\"\u003e/\u003c/span\u003e \u003cspan class=\"n\"\u003emath\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003esqrt\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"mi\"\u003e2\u003c/span\u003e\u003cspan class=\"p\"\u003e))\u003c/span\u003e\n\n\u003cspan class=\"k\"\u003efor\u003c/span\u003e \u003cspan class=\"n\"\u003eiq\u003c/span\u003e \u003cspan class=\"ow\"\u003ein\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"mi\"\u003e110\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e115\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e120\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e125\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e130\u003c/span\u003e\u003cspan class=\"p\"\u003e):\u003c/span\u003e\n    \u003cspan class=\"n\"\u003ez\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003etail\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003eupper_tail\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eiq\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eprint\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"sa\"\u003ef\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003eIQ\u003c/span\u003e\u003cspan class=\"si\"\u003e{\u003c/span\u003e\u003cspan class=\"n\"\u003eiq\u003c/span\u003e\u003cspan class=\"si\"\u003e}\u003c/span\u003e\u003cspan class=\"s\"\u003e: 上位\u003c/span\u003e\u003cspan class=\"si\"\u003e{\u003c/span\u003e\u003cspan class=\"n\"\u003etail\u003c/span\u003e \u003cspan class=\"o\"\u003e*\u003c/span\u003e \u003cspan class=\"mi\"\u003e100\u003c/span\u003e\u003cspan class=\"si\"\u003e:\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"mi\"\u003e1\u003c/span\u003e\u003cspan class=\"n\"\u003ef\u003c/span\u003e\u003cspan class=\"si\"\u003e}\u003c/span\u003e\u003cspan class=\"s\"\u003e%  偏差値\u003c/span\u003e\u003cspan class=\"si\"\u003e{\u003c/span\u003e\u003cspan class=\"mi\"\u003e50\u003c/span\u003e \u003cspan class=\"o\"\u003e+\u003c/span\u003e \u003cspan class=\"mi\"\u003e10\u003c/span\u003e \u003cspan class=\"o\"\u003e*\u003c/span\u003e \u003cspan class=\"n\"\u003ez\u003c/span\u003e\u003cspan class=\"si\"\u003e:\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"mi\"\u003e1\u003c/span\u003e\u003cspan class=\"n\"\u003ef\u003c/span\u003e\u003cspan class=\"si\"\u003e}\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"35:1-35:33\"\u003e出力は次のとおりです。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"37:1-43:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003eIQ110: 上位25.2%  偏差値56.7\nIQ115: 上位15.9%  偏差値60.0\nIQ120: 上位9.1%  偏差値63.3\nIQ125: 上位4.8%  偏差値66.7\nIQ130: 上位2.3%  偏差値70.0\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"45:1-45:67\"\u003e\u003cstrong\u003eIQ120は上位9%前後、偏差値に直すと63ほど\u003c/strong\u003eです。\u003c/p\u003e\n\u003cp data-sourcepos=\"47:1-47:98\"\u003e100人の集団なら9人、30人のクラスなら2〜3人が該当する計算になります。\u003c/p\u003e\n\u003cp data-sourcepos=\"49:1-49:83\"\u003eつまり、IQ120以上は「ごく少数の特別な人」ではありません。\u003c/p\u003e\n\u003cp data-sourcepos=\"51:1-51:81\"\u003e職場や学校で何人か見かけても、不思議ではない割合です。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"53:1-53:51\"\u003e\n\u003cspan id=\"語られがちな特徴を研究で仕分ける\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E8%AA%9E%E3%82%89%E3%82%8C%E3%81%8C%E3%81%A1%E3%81%AA%E7%89%B9%E5%BE%B4%E3%82%92%E7%A0%94%E7%A9%B6%E3%81%A7%E4%BB%95%E5%88%86%E3%81%91%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e語られがちな特徴を研究で仕分ける\u003c/h2\u003e\n\u003cp data-sourcepos=\"55:1-55:54\"\u003e次に、よく挙がる特徴を表にしました。\u003c/p\u003e\n\u003cp data-sourcepos=\"57:1-57:102\"\u003e「研究で言えること」の欄は、私が確かめられた範囲だけを書いています。\u003c/p\u003e\n\u003ctable data-sourcepos=\"59:1-65:91\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"59:1-59:67\"\u003e\n\u003cth data-sourcepos=\"59:2-59:21\"\u003e語られる特徴\u003c/th\u003e\n\u003cth data-sourcepos=\"59:23-59:57\"\u003e研究・計算で言えること\u003c/th\u003e\n\u003cth data-sourcepos=\"59:59-59:66\"\u003e判定\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"61:1-61:84\"\u003e\n\u003ctd data-sourcepos=\"61:2-61:18\"\u003e上位に入る\u003c/td\u003e\n\u003ctd data-sourcepos=\"61:20-61:62\"\u003e正規分布の計算で約9%と出せる\u003c/td\u003e\n\u003ctd data-sourcepos=\"61:64-61:83\"\u003e数字で言える\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"62:1-62:133\"\u003e\n\u003ctd data-sourcepos=\"62:2-62:33\"\u003e仕事の成果と関係する\u003c/td\u003e\n\u003ctd data-sourcepos=\"62:35-62:105\"\u003e平均的に正の相関がある。ただし推定値に幅がある\u003c/td\u003e\n\u003ctd data-sourcepos=\"62:107-62:132\"\u003e条件つきで言える\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"63:1-63:118\"\u003e\n\u003ctd data-sourcepos=\"63:2-63:42\"\u003e新しいことの飲み込みが速い\u003c/td\u003e\n\u003ctd data-sourcepos=\"63:44-63:96\"\u003e傾向として語られる。個人差が大きい\u003c/td\u003e\n\u003ctd data-sourcepos=\"63:98-63:117\"\u003e断言できない\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"64:1-64:85\"\u003e\n\u003ctd data-sourcepos=\"64:2-64:24\"\u003e会話の先を読む\u003c/td\u003e\n\u003ctd data-sourcepos=\"64:26-64:63\"\u003e性格や経験にも左右される\u003c/td\u003e\n\u003ctd data-sourcepos=\"64:65-64:84\"\u003e断言できない\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"65:1-65:91\"\u003e\n\u003ctd data-sourcepos=\"65:2-65:30\"\u003e周囲から孤立しない\u003c/td\u003e\n\u003ctd data-sourcepos=\"65:32-65:69\"\u003e人柄や環境の要素が大きい\u003c/td\u003e\n\u003ctd data-sourcepos=\"65:71-65:90\"\u003e断言できない\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"67:1-67:52\"\u003e上の2行は、数字として確認できます。\u003c/p\u003e\n\u003cp data-sourcepos=\"69:1-69:111\"\u003e下の3行は、よく聞く話ではあるものの、IQの値だけで説明できるとは言えません。\u003c/p\u003e\n\u003cp data-sourcepos=\"71:1-71:146\"\u003eIQの内訳（言語に強い、図形に強い、処理が速いなど）のバランスで、現れ方が人によって変わるからです。\u003c/p\u003e\n\u003cp data-sourcepos=\"73:1-73:105\"\u003e同じ120でも、得意な領域が違えば周囲に見える印象はまるで別物になります。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"75:1-75:43\"\u003e\n\u003cspan id=\"仕事との相関はどのくらいか\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BB%95%E4%BA%8B%E3%81%A8%E3%81%AE%E7%9B%B8%E9%96%A2%E3%81%AF%E3%81%A9%E3%81%AE%E3%81%8F%E3%82%89%E3%81%84%E3%81%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e仕事との相関はどのくらいか\u003c/h3\u003e\n\u003cp data-sourcepos=\"77:1-77:65\"\u003e仕事の成果とIQの関係は、研究が多い分野です。\u003c/p\u003e\n\u003cp data-sourcepos=\"79:1-79:94\"\u003e有名なのは、1998年にシュミットとハンターが発表したメタ分析です。\u003c/p\u003e\n\u003cp data-sourcepos=\"81:1-81:99\"\u003eメタ分析とは、複数の研究の結果をまとめて分析し直す手法のことです。\u003c/p\u003e\n\u003cp data-sourcepos=\"83:1-83:121\"\u003eこの研究では、一般的な知的能力と仕事の成果の相関係数がおよそ0.51と報告されました。\u003c/p\u003e\n\u003cp data-sourcepos=\"85:1-85:125\"\u003eところが近年、サケットらが2022年に再分析し、0.31前後というより小さな値を示しています。\u003c/p\u003e\n\u003cp data-sourcepos=\"87:1-87:78\"\u003e同じテーマでも、補正の仕方で推定値が変わるわけです。\u003c/p\u003e\n\u003cp data-sourcepos=\"89:1-89:94\"\u003e相関係数の2乗は、成果のばらつきのうち説明できる割合を表します。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"python\" data-sourcepos=\"91:1-94:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"k\"\u003efor\u003c/span\u003e \u003cspan class=\"n\"\u003er\u003c/span\u003e \u003cspan class=\"ow\"\u003ein\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"mf\"\u003e0.51\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mf\"\u003e0.31\u003c/span\u003e\u003cspan class=\"p\"\u003e):\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eprint\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"sa\"\u003ef\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003er=\u003c/span\u003e\u003cspan class=\"si\"\u003e{\u003c/span\u003e\u003cspan class=\"n\"\u003er\u003c/span\u003e\u003cspan class=\"si\"\u003e}\u003c/span\u003e\u003cspan class=\"s\"\u003e: 説明できる割合 \u003c/span\u003e\u003cspan class=\"si\"\u003e{\u003c/span\u003e\u003cspan class=\"n\"\u003er\u003c/span\u003e \u003cspan class=\"o\"\u003e**\u003c/span\u003e \u003cspan class=\"mi\"\u003e2\u003c/span\u003e\u003cspan class=\"si\"\u003e:\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"mi\"\u003e0\u003c/span\u003e\u003cspan class=\"o\"\u003e%\u003c/span\u003e\u003cspan class=\"si\"\u003e}\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"96:1-99:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003er=0.51: 説明できる割合 26%\nr=0.31: 説明できる割合 10%\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"101:1-101:71\"\u003e古い推定値でも、成果のばらつきの4分の1ほどです。\u003c/p\u003e\n\u003cp data-sourcepos=\"103:1-103:60\"\u003e新しい推定値なら、10%程度にとどまります。\u003c/p\u003e\n\u003cp data-sourcepos=\"105:1-105:125\"\u003e\u003cstrong\u003eIQが高いと仕事で有利な傾向はあるが、結果の大半はIQ以外で決まる\u003c/strong\u003eと読むのが妥当です。\u003c/p\u003e\n\u003cp data-sourcepos=\"107:1-107:63\"\u003e出典は、記事の末尾にまとめて載せています。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"109:1-109:48\"\u003e\n\u003cspan id=\"特徴が当てはまりにくい理由\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%89%B9%E5%BE%B4%E3%81%8C%E5%BD%93%E3%81%A6%E3%81%AF%E3%81%BE%E3%82%8A%E3%81%AB%E3%81%8F%E3%81%84%E7%90%86%E7%94%B1\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e「特徴」が当てはまりにくい理由\u003c/h2\u003e\n\u003cp data-sourcepos=\"111:1-111:78\"\u003eデータで確かめにくいのには、構造的な理由があります。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"113:1-113:43\"\u003e\n\u003cspan id=\"120の人はそもそも大勢いる\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#120%E3%81%AE%E4%BA%BA%E3%81%AF%E3%81%9D%E3%82%82%E3%81%9D%E3%82%82%E5%A4%A7%E5%8B%A2%E3%81%84%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e120の人は、そもそも大勢いる\u003c/h3\u003e\n\u003cp data-sourcepos=\"115:1-115:74\"\u003e上位9%は、少数派というより「ちょっと上の層」です。\u003c/p\u003e\n\u003cp data-sourcepos=\"117:1-117:108\"\u003eその中には、話し上手な人も口下手な人も、几帳面な人も大雑把な人もいます。\u003c/p\u003e\n\u003cp data-sourcepos=\"119:1-119:93\"\u003e層が厚いほど、平均的な特徴を一言でまとめるのは難しくなります。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"121:1-121:37\"\u003e\n\u003cspan id=\"テストの点は誤差を含む\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%86%E3%82%B9%E3%83%88%E3%81%AE%E7%82%B9%E3%81%AF%E8%AA%A4%E5%B7%AE%E3%82%92%E5%90%AB%E3%82%80\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eテストの点は誤差を含む\u003c/h3\u003e\n\u003cp data-sourcepos=\"123:1-123:80\"\u003eIQテストの点数は、受けた日の体調や集中力でも動きます。\u003c/p\u003e\n\u003cp data-sourcepos=\"125:1-125:84\"\u003e同じ人が受け直して、数ポイント違うことは普通にあります。\u003c/p\u003e\n\u003cp data-sourcepos=\"127:1-127:108\"\u003e「120以上」というラインの上下にいる人は、そもそも入れ替わりやすいのです。\u003c/p\u003e\n\u003cp data-sourcepos=\"129:1-129:129\"\u003eだから、ラインを少し超えた人にだけ特別な特徴が現れる、という考え方には無理があります。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"131:1-131:40\"\u003e\n\u003cspan id=\"測っているのは知能の一部\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%B8%AC%E3%81%A3%E3%81%A6%E3%81%84%E3%82%8B%E3%81%AE%E3%81%AF%E7%9F%A5%E8%83%BD%E3%81%AE%E4%B8%80%E9%83%A8\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e測っているのは知能の一部\u003c/h3\u003e\n\u003cp data-sourcepos=\"133:1-133:96\"\u003e多くの知能検査は、複数の下位検査を組み合わせて総合点を出します。\u003c/p\u003e\n\u003cp data-sourcepos=\"135:1-135:96\"\u003e総合点が同じでも、得意な領域の組み合わせは人によって異なります。\u003c/p\u003e\n\u003cp data-sourcepos=\"137:1-137:108\"\u003e文章が得意な人と、図形の把握が得意な人が、同じ120ということが起こります。\u003c/p\u003e\n\u003cp data-sourcepos=\"139:1-139:63\"\u003e特徴が一つにそろわないのは、このためです。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"141:1-141:39\"\u003e\n\u003cspan id=\"特徴より当てにしたい見方\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%89%B9%E5%BE%B4%E3%82%88%E3%82%8A%E5%BD%93%E3%81%A6%E3%81%AB%E3%81%97%E3%81%9F%E3%81%84%E8%A6%8B%E6%96%B9\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e特徴より当てにしたい見方\u003c/h2\u003e\n\u003cp data-sourcepos=\"143:1-143:125\"\u003e「自分はIQ120だから、こういう人間のはず」と決めつけるのは、あまり得策ではありません。\u003c/p\u003e\n\u003cp data-sourcepos=\"145:1-145:75\"\u003e代わりに、次の見方のほうが実用的だと考えています。\u003c/p\u003e\n\u003cul data-sourcepos=\"147:1-152:0\"\u003e\n\u003cli data-sourcepos=\"147:1-148:0\"\u003e\n\u003cp data-sourcepos=\"147:3-147:68\"\u003e総合点より、得意な領域と苦手な領域の差を見る\u003c/p\u003e\n\u003c/li\u003e\n\u003cli data-sourcepos=\"149:1-150:0\"\u003e\n\u003cp data-sourcepos=\"149:3-149:74\"\u003e点数は単独で信じず、別のテストと比べて幅で捉える\u003c/p\u003e\n\u003c/li\u003e\n\u003cli data-sourcepos=\"151:1-152:0\"\u003e\n\u003cp data-sourcepos=\"151:3-151:92\"\u003e努力や環境、性格のほうが成果を左右する場面が多いと知っておく\u003c/p\u003e\n\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"153:1-153:92\"\u003e勉強や仕事で伸びるかどうかは、IQ以外の部分でかなり決まります。\u003c/p\u003e\n\u003cp data-sourcepos=\"155:1-155:81\"\u003e数字は、自分を理解するための材料のひとつにすぎません。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"157:1-157:55\"\u003e\n\u003cspan id=\"ギフテッドとの線引きも整理しておく\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%AE%E3%83%95%E3%83%86%E3%83%83%E3%83%89%E3%81%A8%E3%81%AE%E7%B7%9A%E5%BC%95%E3%81%8D%E3%82%82%E6%95%B4%E7%90%86%E3%81%97%E3%81%A6%E3%81%8A%E3%81%8F\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eギフテッドとの線引きも整理しておく\u003c/h3\u003e\n\u003cp data-sourcepos=\"159:1-159:92\"\u003eギフテッドの目安としては、IQ130以上が使われることが一般的です。\u003c/p\u003e\n\u003cp data-sourcepos=\"161:1-161:56\"\u003eIQ120は、そのひとつ下の層にあたります。\u003c/p\u003e\n\u003cp data-sourcepos=\"163:1-163:90\"\u003eウェクスラー式の区分では、120〜129は「高い」の範囲に入ります。\u003c/p\u003e\n\u003cp data-sourcepos=\"165:1-165:52\"\u003e先ほどの表では、130は上位2.3%でした。\u003c/p\u003e\n\u003cp data-sourcepos=\"167:1-167:94\"\u003e120との差は10ポイントですが、該当者の割合は4分の1ほどになります。\u003c/p\u003e\n\u003cp data-sourcepos=\"169:1-169:114\"\u003e数字の差がそのまま人数の差になるわけではない点も、覚えておくと混乱しません。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"171:1-171:48\"\u003e\n\u003cspan id=\"自分の位置を知りたいときの手順\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E8%87%AA%E5%88%86%E3%81%AE%E4%BD%8D%E7%BD%AE%E3%82%92%E7%9F%A5%E3%82%8A%E3%81%9F%E3%81%84%E3%81%A8%E3%81%8D%E3%81%AE%E6%89%8B%E9%A0%86\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e自分の位置を知りたいときの手順\u003c/h2\u003e\n\u003cp data-sourcepos=\"173:1-173:108\"\u003eここまで読んで、自分はどのあたりにいるのか気になった人もいると思います。\u003c/p\u003e\n\u003cp data-sourcepos=\"175:1-175:63\"\u003eその場合は、次の順で確かめるのが無難です。\u003c/p\u003e\n\u003col data-sourcepos=\"177:1-182:0\"\u003e\n\u003cli data-sourcepos=\"177:1-178:0\"\u003e\n\u003cp data-sourcepos=\"177:4-177:72\"\u003eまず、標準偏差がいくつの物差しなのかを確認する\u003c/p\u003e\n\u003c/li\u003e\n\u003cli data-sourcepos=\"179:1-180:0\"\u003e\n\u003cp data-sourcepos=\"179:4-179:72\"\u003e別の日にもう一度、できれば別の形式で受けてみる\u003c/p\u003e\n\u003c/li\u003e\n\u003cli data-sourcepos=\"181:1-182:0\"\u003e\n\u003cp data-sourcepos=\"181:4-181:63\"\u003e総合点だけでなく、得意不得意の偏りを見る\u003c/p\u003e\n\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp data-sourcepos=\"183:1-183:93\"\u003e点数の目安を知りたいだけなら、オンラインのテストでも十分です。\u003c/p\u003e\n\u003cp data-sourcepos=\"185:1-185:126\"\u003eただし、検査の結果を公的な場面で使うなら、専門家が実施するものを選ぶ必要があります。\u003c/p\u003e\n\u003cp data-sourcepos=\"187:1-187:96\"\u003eこうした条件を満たすオンラインテストを、私は以下で試しています。\u003c/p\u003e\n\u003cp data-sourcepos=\"189:1-189:117\"\u003e\u003ciframe id=\"qiita-embed-content__a3ba06ae96b6616e538da15eee648c84\" src=\"https://qiita.com/embed-contents/link-card#qiita-embed-content__a3ba06ae96b6616e538da15eee648c84\" data-content=\"https%3A%2F%2Fiq-test-official.site%2Fja%3Futm_source%3Dqiita%26utm_medium%3Dblog%26utm_campaign%3Diq120-ijou-tokuchou%26utm_content%3Dbottom\" frameborder=\"0\" scrolling=\"no\" loading=\"lazy\" style=\"width:100%;\" height=\"29\"\u003e\n\u003c/iframe\u003e\n\u003c/p\u003e\n\u003ch2 data-sourcepos=\"191:1-191:12\"\u003e\n\u003cspan id=\"まとめ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%BE%E3%81%A8%E3%82%81\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eまとめ\u003c/h2\u003e\n\u003cp data-sourcepos=\"193:1-193:95\"\u003eIQ120以上の「特徴」を研究データで確かめた結果は、次のとおりです。\u003c/p\u003e\n\u003cul data-sourcepos=\"195:1-200:0\"\u003e\n\u003cli data-sourcepos=\"195:1-196:0\"\u003e\n\u003cp data-sourcepos=\"195:3-195:74\"\u003eIQ120は上位9%前後で、偏差値なら63ほど。数字で言える\u003c/p\u003e\n\u003c/li\u003e\n\u003cli data-sourcepos=\"197:1-198:0\"\u003e\n\u003cp data-sourcepos=\"197:3-197:82\"\u003e仕事の成果とは相関があるが、推定値は0.31〜0.51と幅がある\u003c/p\u003e\n\u003c/li\u003e\n\u003cli data-sourcepos=\"199:1-200:0\"\u003e\n\u003cp data-sourcepos=\"199:3-199:73\"\u003e人柄や話し方の特徴は、IQの値だけでは説明できない\u003c/p\u003e\n\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"201:1-201:98\"\u003e「IQ120以上ならこうなる」という型は、データからは作れませんでした。\u003c/p\u003e\n\u003cp data-sourcepos=\"203:1-203:111\"\u003e数字は位置を知る道具として使い、自分の得意不得意を見るほうが役に立ちます。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"205:1-205:24\"\u003e\n\u003cspan id=\"参考にした情報\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%8F%82%E8%80%83%E3%81%AB%E3%81%97%E3%81%9F%E6%83%85%E5%A0%B1\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e参考にした情報\u003c/h2\u003e\n\u003cul data-sourcepos=\"207:1-210:0\"\u003e\n\u003cli data-sourcepos=\"207:1-208:0\"\u003e\n\u003cp data-sourcepos=\"207:3-207:90\"\u003eSchmidt \u0026amp; Hunter (1998) の解説: \u003ca href=\"https://www.plum.io/blog/schmidt-hunter-meta-analysis\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://www.plum.io/blog/schmidt-hunter-meta-analysis\u003c/a\u003e\u003c/p\u003e\n\u003c/li\u003e\n\u003cli data-sourcepos=\"209:1-210:0\"\u003e\n\u003cp data-sourcepos=\"209:3-209:95\"\u003eSackett らの再分析（2022）の論文: \u003ca href=\"https://Www.Gwern.net/doc/iq/ses/2023-sackett.pdf\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://Www.Gwern.net/doc/iq/ses/2023-sackett.pdf\u003c/a\u003e\u003c/p\u003e\n\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"211:1-211:105\"\u003e数値は二次情報で確かめたものです。最新の内容は原典で確認してください。\u003c/p\u003e\n","body":"「IQ120以上の人には特徴がある」という話を、ネットでよく見かけます。\n\nでも、その特徴は本当にデータで言えることなのでしょうか。\n\nこの記事では、IQ120以上の位置を計算で出し、語られがちな特徴を研究と照らして仕分けました。\n\n結論を先に書くと、**数字で言い切れるのは位置づけと仕事との相関まで**です。\n\n人柄のような特徴は、研究の側から断言できる材料が乏しいと分かりました。\n\nhttps://iq-test-official.site/ja?utm_source=qiita\u0026utm_medium=blog\u0026utm_campaign=iq120-ijou-tokuchou\u0026utm_content=top\n\n## 確かめる前に、IQ120の位置を数字にする\n\n特徴を語る前に、そもそもIQ120がどこにいるのかを押さえます。\n\nIQは、中心を100、ばらつきの単位を15とする釣り鐘型の分布で表されます。\n\n標準偏差とは、データの散らばり具合を表す単位のことです。\n\nこれを使えば、IQ120が上位何%に当たるかは計算で出せます。\n\n```python\nimport math\n\ndef upper_tail(iq, mean=100, sd=15):\n    z = (iq - mean) / sd\n    return z, 0.5 * math.erfc(z / math.sqrt(2))\n\nfor iq in (110, 115, 120, 125, 130):\n    z, tail = upper_tail(iq)\n    print(f\"IQ{iq}: 上位{tail * 100:.1f}%  偏差値{50 + 10 * z:.1f}\")\n```\n\n出力は次のとおりです。\n\n```text\nIQ110: 上位25.2%  偏差値56.7\nIQ115: 上位15.9%  偏差値60.0\nIQ120: 上位9.1%  偏差値63.3\nIQ125: 上位4.8%  偏差値66.7\nIQ130: 上位2.3%  偏差値70.0\n```\n\n**IQ120は上位9%前後、偏差値に直すと63ほど**です。\n\n100人の集団なら9人、30人のクラスなら2〜3人が該当する計算になります。\n\nつまり、IQ120以上は「ごく少数の特別な人」ではありません。\n\n職場や学校で何人か見かけても、不思議ではない割合です。\n\n## 語られがちな特徴を研究で仕分ける\n\n次に、よく挙がる特徴を表にしました。\n\n「研究で言えること」の欄は、私が確かめられた範囲だけを書いています。\n\n| 語られる特徴 | 研究・計算で言えること | 判定 |\n|---|---|---|\n| 上位に入る | 正規分布の計算で約9%と出せる | 数字で言える |\n| 仕事の成果と関係する | 平均的に正の相関がある。ただし推定値に幅がある | 条件つきで言える |\n| 新しいことの飲み込みが速い | 傾向として語られる。個人差が大きい | 断言できない |\n| 会話の先を読む | 性格や経験にも左右される | 断言できない |\n| 周囲から孤立しない | 人柄や環境の要素が大きい | 断言できない |\n\n上の2行は、数字として確認できます。\n\n下の3行は、よく聞く話ではあるものの、IQの値だけで説明できるとは言えません。\n\nIQの内訳（言語に強い、図形に強い、処理が速いなど）のバランスで、現れ方が人によって変わるからです。\n\n同じ120でも、得意な領域が違えば周囲に見える印象はまるで別物になります。\n\n### 仕事との相関はどのくらいか\n\n仕事の成果とIQの関係は、研究が多い分野です。\n\n有名なのは、1998年にシュミットとハンターが発表したメタ分析です。\n\nメタ分析とは、複数の研究の結果をまとめて分析し直す手法のことです。\n\nこの研究では、一般的な知的能力と仕事の成果の相関係数がおよそ0.51と報告されました。\n\nところが近年、サケットらが2022年に再分析し、0.31前後というより小さな値を示しています。\n\n同じテーマでも、補正の仕方で推定値が変わるわけです。\n\n相関係数の2乗は、成果のばらつきのうち説明できる割合を表します。\n\n```python\nfor r in (0.51, 0.31):\n    print(f\"r={r}: 説明できる割合 {r ** 2:.0%}\")\n```\n\n```text\nr=0.51: 説明できる割合 26%\nr=0.31: 説明できる割合 10%\n```\n\n古い推定値でも、成果のばらつきの4分の1ほどです。\n\n新しい推定値なら、10%程度にとどまります。\n\n**IQが高いと仕事で有利な傾向はあるが、結果の大半はIQ以外で決まる**と読むのが妥当です。\n\n出典は、記事の末尾にまとめて載せています。\n\n## 「特徴」が当てはまりにくい理由\n\nデータで確かめにくいのには、構造的な理由があります。\n\n### 120の人は、そもそも大勢いる\n\n上位9%は、少数派というより「ちょっと上の層」です。\n\nその中には、話し上手な人も口下手な人も、几帳面な人も大雑把な人もいます。\n\n層が厚いほど、平均的な特徴を一言でまとめるのは難しくなります。\n\n### テストの点は誤差を含む\n\nIQテストの点数は、受けた日の体調や集中力でも動きます。\n\n同じ人が受け直して、数ポイント違うことは普通にあります。\n\n「120以上」というラインの上下にいる人は、そもそも入れ替わりやすいのです。\n\nだから、ラインを少し超えた人にだけ特別な特徴が現れる、という考え方には無理があります。\n\n### 測っているのは知能の一部\n\n多くの知能検査は、複数の下位検査を組み合わせて総合点を出します。\n\n総合点が同じでも、得意な領域の組み合わせは人によって異なります。\n\n文章が得意な人と、図形の把握が得意な人が、同じ120ということが起こります。\n\n特徴が一つにそろわないのは、このためです。\n\n## 特徴より当てにしたい見方\n\n「自分はIQ120だから、こういう人間のはず」と決めつけるのは、あまり得策ではありません。\n\n代わりに、次の見方のほうが実用的だと考えています。\n\n- 総合点より、得意な領域と苦手な領域の差を見る\n\n- 点数は単独で信じず、別のテストと比べて幅で捉える\n\n- 努力や環境、性格のほうが成果を左右する場面が多いと知っておく\n\n勉強や仕事で伸びるかどうかは、IQ以外の部分でかなり決まります。\n\n数字は、自分を理解するための材料のひとつにすぎません。\n\n### ギフテッドとの線引きも整理しておく\n\nギフテッドの目安としては、IQ130以上が使われることが一般的です。\n\nIQ120は、そのひとつ下の層にあたります。\n\nウェクスラー式の区分では、120〜129は「高い」の範囲に入ります。\n\n先ほどの表では、130は上位2.3%でした。\n\n120との差は10ポイントですが、該当者の割合は4分の1ほどになります。\n\n数字の差がそのまま人数の差になるわけではない点も、覚えておくと混乱しません。\n\n## 自分の位置を知りたいときの手順\n\nここまで読んで、自分はどのあたりにいるのか気になった人もいると思います。\n\nその場合は、次の順で確かめるのが無難です。\n\n1. まず、標準偏差がいくつの物差しなのかを確認する\n\n2. 別の日にもう一度、できれば別の形式で受けてみる\n\n3. 総合点だけでなく、得意不得意の偏りを見る\n\n点数の目安を知りたいだけなら、オンラインのテストでも十分です。\n\nただし、検査の結果を公的な場面で使うなら、専門家が実施するものを選ぶ必要があります。\n\nこうした条件を満たすオンラインテストを、私は以下で試しています。\n\nhttps://iq-test-official.site/ja?utm_source=qiita\u0026utm_medium=blog\u0026utm_campaign=iq120-ijou-tokuchou\u0026utm_content=bottom\n\n## まとめ\n\nIQ120以上の「特徴」を研究データで確かめた結果は、次のとおりです。\n\n- IQ120は上位9%前後で、偏差値なら63ほど。数字で言える\n\n- 仕事の成果とは相関があるが、推定値は0.31〜0.51と幅がある\n\n- 人柄や話し方の特徴は、IQの値だけでは説明できない\n\n「IQ120以上ならこうなる」という型は、データからは作れませんでした。\n\n数字は位置を知る道具として使い、自分の得意不得意を見るほうが役に立ちます。\n\n## 参考にした情報\n\n- Schmidt \u0026 Hunter (1998) の解説: https://www.plum.io/blog/schmidt-hunter-meta-analysis\n\n- Sackett らの再分析（2022）の論文: https://Www.Gwern.net/doc/iq/ses/2023-sackett.pdf\n\n数値は二次情報で確かめたものです。最新の内容は原典で確認してください。\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T02:18:03+09:00","group":null,"id":"e23b76db6300bb84bc93","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"IQテスト","versions":[]},{"name":"検証","versions":[]},{"name":"Python","versions":[]},{"name":"統計","versions":[]},{"name":"メタ分析","versions":[]}],"title":"本当に特徴はある？IQ120以上の人の傾向を研究データで確かめた","updated_at":"2026-11-18T02:18:03+09:00","url":"https://qiita.com/tsukutte_mita920/items/e23b76db6300bb84bc93","user":{"description":"「作ってみたら壊れた」を繰り返してる個人開発者。LTのデモで公開処刑されてからセキュリティに目覚めた。失敗談多め。Picoli（URL短縮サービス）作ってます。","facebook_id":"","followees_count":1,"followers_count":1,"github_login_name":null,"id":"tsukutte_mita920","items_count":64,"linkedin_id":"","location":"","name":"つくってみた","organization":"","permanent_id":4367230,"profile_image_url":"https://s3-ap-northeast-1.amazonaws.com/qiita-image-store/0/4367230/f13bf4dfb3e02f07eafadc7e2a696b26c5e8e687/x_large.png?1772091114","team_only":false,"twitter_screen_name":null,"website_url":"https://picoli.site"},"page_views_count":null,"team_membership":null,"organization_url_name":null,"slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003cdiv data-sourcepos=\"1:1-8:3\"\u003e\n\u003cp data-sourcepos=\"2:1-2:44\"\u003e🐹🦜 \u003cstrong\u003eこの記事に登場する2匹\u003c/strong\u003e\u003c/p\u003e\n\u003cul data-sourcepos=\"4:1-6:0\"\u003e\n\u003cli data-sourcepos=\"4:1-4:139\"\u003e🐹 \u003cstrong\u003eもっちー\u003c/strong\u003e （ハムスター）… AI はまだ勉強中。「それどういうこと？」と素朴に質問する生徒役\u003c/li\u003e\n\u003cli data-sourcepos=\"5:1-6:0\"\u003e🦜 \u003cstrong\u003eきなこ\u003c/strong\u003e （セキセイインコ）… AI で調べものをこなす解説役。やさしく深掘りして教える先生役\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"7:1-7:130\"\u003eこの記事は2匹の掛け合いを書き起こした形式です。発言の先頭にいる絵文字＋名前が話者です。\u003c/p\u003e\n\u003c/div\u003e\n\u003ch2 data-sourcepos=\"10:1-10:37\"\u003e\n\u003cspan id=\"-geminiアプリのtasksとは\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#-gemini%E3%82%A2%E3%83%97%E3%83%AA%E3%81%AEtasks%E3%81%A8%E3%81%AF\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e🚀 GeminiアプリのTasksとは\u003c/h2\u003e\n\u003cp data-sourcepos=\"12:1-12:114\"\u003e🐹もっちー：Geminiアプリに「Tasks」が出たって聞いたんだけど、これ何ができるの？\u003c/p\u003e\n\u003cp data-sourcepos=\"14:1-14:350\"\u003e🦜きなこ：Google公式ブログ（2026年11月17日・米国時間）によると、予約の手配や買い物、公共料金の確認のような複数の手順が必要な作業を、Geminiが代わりに進めてくれる機能だよ。使うときはホーム画面のトグルを「Chat」から「Task」に切り替えるんだって。\u003c/p\u003e\n\u003cp data-sourcepos=\"16:1-16:71\"\u003e🐹もっちー：お金がかかるやつ？ 日本でも使える？\u003c/p\u003e\n\u003cp data-sourcepos=\"18:1-18:326\"\u003e🦜きなこ：無料で提供されていて、対象国は米国・日本・韓国・カナダ・オーストラリア・インドの6か国と書かれているよ。ただし高度な機能はまず米国から提供される。日本でどこまで使えるかは、公式の記事には明記されていないんだ。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"20:1-20:16\"\u003e\n\u003cspan id=\"ポイント\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%9D%E3%82%A4%E3%83%B3%E3%83%88\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eポイント\u003c/h3\u003e\n\u003cul data-sourcepos=\"21:1-25:0\"\u003e\n\u003cli data-sourcepos=\"21:1-21:101\"\u003e複数手順の作業（予約・買い物・公共料金の確認など）をGeminiが代行する\u003c/li\u003e\n\u003cli data-sourcepos=\"22:1-22:54\"\u003e無料で提供。対象国に日本を含む6か国\u003c/li\u003e\n\u003cli data-sourcepos=\"23:1-23:122\"\u003e購入などの重要な操作の前には確認を求める。支払いはAP2を使い、利用上限を設定できる\u003c/li\u003e\n\u003cli data-sourcepos=\"24:1-25:0\"\u003e公式ブログは、タスクは完全ではなく途中で失敗することがあると明記している\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch3 data-sourcepos=\"26:1-26:10\"\u003e\n\u003cspan id=\"注意\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%B3%A8%E6%84%8F\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e注意\u003c/h3\u003e\n\u003cp data-sourcepos=\"27:1-27:165\"\u003e日本での利用範囲や細かい仕様は公式の続報を待つ必要があるよ。この記事は公式ブログの記載だけを根拠にしているよ。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"29:1-29:29\"\u003e\n\u003cspan id=\"-公式一次ソース\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#-%E5%85%AC%E5%BC%8F%E4%B8%80%E6%AC%A1%E3%82%BD%E3%83%BC%E3%82%B9\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e📌 公式一次ソース\u003c/h2\u003e\n\u003cblockquote data-sourcepos=\"31:1-31:164\"\u003e\n\u003cp data-sourcepos=\"31:3-31:164\"\u003e\u003ca href=\"https://blog.google/innovation-and-ai/products/gemini-app/tasks-in-gemini-free-new-features/\" rel=\"nofollow noopener\" target=\"_blank\"\u003eGeminiアプリのTasksとは？公式発表を3分で速報解説\u003c/a\u003e\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp data-sourcepos=\"33:1-33:63\"\u003e公式発表の詳細はリンク先をご確認ください。\u003c/p\u003e\n\u003chr data-sourcepos=\"35:1-36:0\"\u003e\n\u003cblockquote data-sourcepos=\"37:1-38:144\"\u003e\n\u003cp data-sourcepos=\"37:3-38:144\"\u003e🦜 \u003cstrong\u003eきなこもっちーのテック深掘り\u003c/strong\u003e では、AI・LLM を中心とした最新テックをハムスターのもっちーとセキセイインコのきなこの掛け合いで深掘り解説しています。チャンネル登録してお待ちください！\u003cbr\u003e\n▶ \u003ca href=\"https://www.youtube.com/@kinamocchi_tech?utm_source=qiita\u0026amp;utm_medium=blog\u0026amp;utm_campaign=flash_footer\" rel=\"nofollow noopener\" target=\"_blank\"\u003eYouTube チャンネルはこちら\u003c/a\u003e\u003c/p\u003e\n\u003c/blockquote\u003e\n","body":":::message\n🐹🦜 **この記事に登場する2匹**\n\n- 🐹 **もっちー** （ハムスター）… AI はまだ勉強中。「それどういうこと？」と素朴に質問する生徒役\n- 🦜 **きなこ** （セキセイインコ）… AI で調べものをこなす解説役。やさしく深掘りして教える先生役\n\nこの記事は2匹の掛け合いを書き起こした形式です。発言の先頭にいる絵文字＋名前が話者です。\n:::\n\n## 🚀 GeminiアプリのTasksとは\n\n🐹もっちー：Geminiアプリに「Tasks」が出たって聞いたんだけど、これ何ができるの？\n\n🦜きなこ：Google公式ブログ（2026年11月17日・米国時間）によると、予約の手配や買い物、公共料金の確認のような複数の手順が必要な作業を、Geminiが代わりに進めてくれる機能だよ。使うときはホーム画面のトグルを「Chat」から「Task」に切り替えるんだって。\n\n🐹もっちー：お金がかかるやつ？ 日本でも使える？\n\n🦜きなこ：無料で提供されていて、対象国は米国・日本・韓国・カナダ・オーストラリア・インドの6か国と書かれているよ。ただし高度な機能はまず米国から提供される。日本でどこまで使えるかは、公式の記事には明記されていないんだ。\n\n### ポイント\n- 複数手順の作業（予約・買い物・公共料金の確認など）をGeminiが代行する\n- 無料で提供。対象国に日本を含む6か国\n- 購入などの重要な操作の前には確認を求める。支払いはAP2を使い、利用上限を設定できる\n- 公式ブログは、タスクは完全ではなく途中で失敗することがあると明記している\n\n### 注意\n日本での利用範囲や細かい仕様は公式の続報を待つ必要があるよ。この記事は公式ブログの記載だけを根拠にしているよ。\n\n## 📌 公式一次ソース\n\n\u003e [GeminiアプリのTasksとは？公式発表を3分で速報解説](https://blog.google/innovation-and-ai/products/gemini-app/tasks-in-gemini-free-new-features/)\n\n公式発表の詳細はリンク先をご確認ください。\n\n---\n\n\u003e 🦜 **きなこもっちーのテック深掘り** では、AI・LLM を中心とした最新テックをハムスターのもっちーとセキセイインコのきなこの掛け合いで深掘り解説しています。チャンネル登録してお待ちください！\n\u003e ▶ [YouTube チャンネルはこちら](https://www.youtube.com/@kinamocchi_tech?utm_source=qiita\u0026utm_medium=blog\u0026utm_campaign=flash_footer)\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T02:11:26+09:00","group":null,"id":"d83c655b9c3d2732f93c","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"AI","versions":[]},{"name":"LLM","versions":[]},{"name":"Gemini","versions":[]}],"title":"GeminiアプリのTasksとは？公式発表を3分で速報解説","updated_at":"2026-11-18T02:11:26+09:00","url":"https://qiita.com/kinamocchi_tech/items/d83c655b9c3d2732f93c","user":{"description":"🐹もっちー×🦜きなこのAI深掘りYouTubeチャンネルのテック発信アカウント。ChatGPT・Claude・Geminiなど最新AIをわかりやすく解説📺\r\n▶ YouTube: https://go.kinamocchi-tech.workers.dev/y/qb\r\n📚 Zenn有料解説本: https://go.kinamocchi-tech.workers.dev/b/qb","facebook_id":"","followees_count":22,"followers_count":8,"github_login_name":null,"id":"kinamocchi_tech","items_count":186,"linkedin_id":"","location":"YouTube","name":"きなこもっちーの テック深掘り🐹🐦","organization":"🦜きなこ🐹もっちーのテック深掘りチャンネル","permanent_id":4384447,"profile_image_url":"https://s3-ap-northeast-1.amazonaws.com/qiita-image-store/0/4384447/ec4f05cda96e8c9ba726ce5e022c9e86f93cff7e/x_large.png?1774166972","team_only":false,"twitter_screen_name":"kinamocchi_tech","website_url":"https://www.youtube.com/@kinamocchi_tech"},"page_views_count":null,"team_membership":null,"organization_url_name":null,"slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003cp data-sourcepos=\"1:1-1:139\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F4169312%2F66e3e068-2baf-4316-9390-ba6192cff943.png?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=f9ae1315dfebe0b9ea9983f3ff88cc77\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F4169312%2F66e3e068-2baf-4316-9390-ba6192cff943.png?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=f9ae1315dfebe0b9ea9983f3ff88cc77\" alt=\"Mat3ra 2D - 25.11.2026.png\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F4169312%2F66e3e068-2baf-4316-9390-ba6192cff943.png?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=90f3098dbb2b0899b6bfc3c12e2f1bba 1x\" data-canonical-src=\"https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4169312/66e3e068-2baf-4316-9390-ba6192cff943.png\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003ch2 data-sourcepos=\"4:1-4:8\"\u003e\n\u003cspan id=\"tldr\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#tldr\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eTL;DR\u003c/h2\u003e\n\u003cul data-sourcepos=\"6:1-10:0\"\u003e\n\u003cli data-sourcepos=\"6:1-6:200\"\u003e\n\u003cstrong\u003eオンラインウェビナー、2026年11月25日\u003c/strong\u003e、\u003cstrong\u003e英語\u003c/strong\u003eで開催:07:30 PST / 10:30 EST / 15:30 GMT / 16:30 CET / 21:00 インド / 23:30 シンガポール / \u003cstrong\u003e00:30 日本(11月26日)\u003c/strong\u003e\n\u003c/li\u003e\n\u003cli data-sourcepos=\"7:1-7:146\"\u003eJupyterLabノートブックから、Quantum ESPRESSOで\u003cstrong\u003eフォノン状態密度とフォノン分散\u003c/strong\u003eを計算する方法を学べます。\u003c/li\u003e\n\u003cli data-sourcepos=\"8:1-8:53\"\u003e実例:\u003cstrong\u003eシリコン、単層MoS₂、単層FeSe\u003c/strong\u003e\n\u003c/li\u003e\n\u003cli data-sourcepos=\"9:1-10:0\"\u003e最後にライブQ\u0026amp;Aがあります。\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch2 data-sourcepos=\"11:1-11:9\"\u003e\n\u003cspan id=\"内容\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%86%85%E5%AE%B9\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e内容\u003c/h2\u003e\n\u003col data-sourcepos=\"13:1-17:0\"\u003e\n\u003cli data-sourcepos=\"13:1-13:190\"\u003e\n\u003cstrong\u003eはじめに\u003c/strong\u003e:Mat3ra-2Dワークフローとこれまでの結果の振り返り、動機(材料の振動特性と動的安定性)、ノートブックからの計算の実行方法。\u003c/li\u003e\n\u003cli data-sourcepos=\"14:1-14:306\"\u003e\n\u003cstrong\u003e手法\u003c/strong\u003e:ノートブックのワークフロー(開く、ログイン、計算の設定、ジョブの投入、結果の表示)と、主要なパラメータ(k点メッシュ、q点メッシュ、エネルギーカットオフ、収束条件、構造緩和、2次元材料の真空層の大きさ)。\u003c/li\u003e\n\u003cli data-sourcepos=\"15:1-15:120\"\u003e\n\u003cstrong\u003e結果\u003c/strong\u003e:シリコン、単層MoS₂(2次元の例)、単層FeSeのフォノン状態密度とフォノン分散。\u003c/li\u003e\n\u003cli data-sourcepos=\"16:1-17:0\"\u003e\n\u003cstrong\u003eQ\u0026amp;A\u003c/strong\u003e:ディスカッションと質疑を交えたハンズオン。\u003c/li\u003e\n\u003c/ol\u003e\n\u003ch2 data-sourcepos=\"18:1-18:12\"\u003e\n\u003cspan id=\"登壇者\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%99%BB%E5%A3%87%E8%80%85\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e登壇者\u003c/h2\u003e\n\u003cul data-sourcepos=\"20:1-22:0\"\u003e\n\u003cli data-sourcepos=\"20:1-20:40\"\u003e\n\u003cstrong\u003e発表者\u003c/strong\u003e:Vsevolod (Seth) Biryukov\u003c/li\u003e\n\u003cli data-sourcepos=\"21:1-22:0\"\u003e\n\u003cstrong\u003eホスト\u003c/strong\u003e:Timur Bazhirov\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch2 data-sourcepos=\"23:1-23:15\"\u003e\n\u003cspan id=\"参加登録\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%8F%82%E5%8A%A0%E7%99%BB%E9%8C%B2\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e参加登録\u003c/h2\u003e\n\u003cp data-sourcepos=\"25:1-25:64\"\u003e\u003ciframe id=\"qiita-embed-content__396af98a955b91a2274a73dc0e89f123\" src=\"https://qiita.com/embed-contents/link-card#qiita-embed-content__396af98a955b91a2274a73dc0e89f123\" data-content=\"https%3A%2F%2Fwww.mat3ra.com%2Fevents-posts%2Fmat3ra-2d-webinar-2026-11-25\" frameborder=\"0\" scrolling=\"no\" loading=\"lazy\" style=\"width:100%;\" height=\"29\"\u003e\n\u003c/iframe\u003e\n\u003c/p\u003e\n\u003cp data-sourcepos=\"27:1-28:3\"\u003eフォノンや2次元材料に取り組んでいる方がお知り合いにいらっしゃれば、ぜひこの記事を共有してください。LGTMやストックは、他の方が記事を見つける助けになります。Qiita上のMat3raのOrganizationをフォローしていただくと、今後のセッションの情報も受け取れます。\u003cbr\u003e\n \u003c/p\u003e\n","body":"![Mat3ra 2D - 25.11.2026.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4169312/66e3e068-2baf-4316-9390-ba6192cff943.png)\n\n\n## TL;DR\n\n- **オンラインウェビナー、2026年11月25日**、**英語**で開催:07:30 PST / 10:30 EST / 15:30 GMT / 16:30 CET / 21:00 インド / 23:30 シンガポール / **00:30 日本(11月26日)**\n- JupyterLabノートブックから、Quantum ESPRESSOで**フォノン状態密度とフォノン分散**を計算する方法を学べます。\n- 実例:**シリコン、単層MoS₂、単層FeSe**\n- 最後にライブQ\u0026Aがあります。\n\n## 内容\n\n1. **はじめに**:Mat3ra-2Dワークフローとこれまでの結果の振り返り、動機(材料の振動特性と動的安定性)、ノートブックからの計算の実行方法。\n2. **手法**:ノートブックのワークフロー(開く、ログイン、計算の設定、ジョブの投入、結果の表示)と、主要なパラメータ(k点メッシュ、q点メッシュ、エネルギーカットオフ、収束条件、構造緩和、2次元材料の真空層の大きさ)。\n3. **結果**:シリコン、単層MoS₂(2次元の例)、単層FeSeのフォノン状態密度とフォノン分散。\n4. **Q\u0026A**:ディスカッションと質疑を交えたハンズオン。\n\n## 登壇者\n\n- **発表者**:Vsevolod (Seth) Biryukov\n- **ホスト**:Timur Bazhirov\n\n## 参加登録\n\nhttps://www.mat3ra.com/events-posts/mat3ra-2d-webinar-2026-11-25\n\nフォノンや2次元材料に取り組んでいる方がお知り合いにいらっしゃれば、ぜひこの記事を共有してください。LGTMやストックは、他の方が記事を見つける助けになります。Qiita上のMat3raのOrganizationをフォローしていただくと、今後のセッションの情報も受け取れます。\n \n","coediting":false,"comments_count":0,"created_at":"2026-11-18T01:45:54+09:00","group":null,"id":"7cd2da5294415c46395d","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"QuantumESPRESSO","versions":[]},{"name":"Jupyter","versions":[]},{"name":"材料科学","versions":[]},{"name":"フォノン","versions":[]},{"name":"第一原理計算","versions":[]}],"title":"# ウェビナー:Quantum ESPRESSOでフォノン状態密度とフォノン分散を計算する(Mat3ra 2D シーズン2 第8回、11月25日)","updated_at":"2026-11-18T01:45:54+09:00","url":"https://qiita.com/Yuliia/items/7cd2da5294415c46395d","user":{"description":"Mat3ra empowers materials scientists and chemists with latest digital R\u0026D capabilities","facebook_id":"https://www.facebook.com/mat3ra/reels/","followees_count":10,"followers_count":4,"github_login_name":null,"id":"Yuliia","items_count":33,"linkedin_id":"https://www.linkedin.com/company/mat3ra/posts/?feedView=all","location":"","name":"Yuliia Martynenko","organization":"Mat3ra.com","permanent_id":4169312,"profile_image_url":"https://s3-ap-northeast-1.amazonaws.com/qiita-image-store/0/4169312/f2955d9543af33d4fe086f13eec7ebd6292538c7/x_large.png?1794396527","team_only":false,"twitter_screen_name":null,"website_url":"https://mat3ra.com/"},"page_views_count":null,"team_membership":null,"organization_url_name":"mat3ra","slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003cp data-sourcepos=\"1:1-1:414\"\u003e「誰からの電話？」と聞かれて、ドメインの契約先の名前が出てくると、開発担当まで話が回ってくることがあります。でも、ドメインを登録している会社と、サイトを作るサービスと、変更を承認する担当者は同じとは限りません。営業の真偽をその場で当てるより、管理対象と権限を分けて確認します。\u003c/p\u003e\n\u003cp data-sourcepos=\"3:1-3:302\"\u003e\u003cstrong\u003e運営側からの案内：\u003c/strong\u003e whocallme.co.uk のサイト側による紹介・宣伝を含む編集記事です。AIの補助を受けて起草しています。以下は手元の台帳で行える確認手順で、システムへの実装や導入効果を報告する記事ではありません。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"5:1-5:48\"\u003e\n\u003cspan id=\"題材は管理会社を名乗る電話\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E9%A1%8C%E6%9D%90%E3%81%AF%E7%AE%A1%E7%90%86%E4%BC%9A%E7%A4%BE%E3%82%92%E5%90%8D%E4%B9%97%E3%82%8B%E9%9B%BB%E8%A9%B1\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e題材は「管理会社を名乗る電話」\u003c/h2\u003e\n\u003cp data-sourcepos=\"7:1-7:339\"\u003e当サイトの01452 645519の番号ページには、会社のドメイン登録先を名乗る相手から、ウェブサイト制作ツールを勧められたという投稿があります。投稿者は、会社の案件や利用中サービスの料金について質問され、繰り返し電話があったと述べています。\u003c/p\u003e\n\u003cp data-sourcepos=\"9:1-9:385\"\u003e\u003ca href=\"https://www.whocallme.co.uk/phone/01452645519\" rel=\"nofollow noopener\" target=\"_blank\"\u003eドメイン関連の営業についての投稿\u003c/a\u003eは、元の公開日が分からない取り込み情報です。匿名の未検証の記述であり、記載された企業が実際に発信したとは確認できません。表示番号の偽装もあり得るため、番号の持ち主を確定する材料にもなりません。\u003c/p\u003e\n\u003cp data-sourcepos=\"11:1-11:294\"\u003eここでは企業名の正否を推測せず、「その会社と契約があるかもしれない」という話を、どこまで社内で確認できるかに絞ります。投稿者が述べた昨日・今日を、実際のカレンダーの日付に置き換えることもしません。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"13:1-13:57\"\u003e\n\u003cspan id=\"台帳はサービス名ではなく対象から読む\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%8F%B0%E5%B8%B3%E3%81%AF%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E5%90%8D%E3%81%A7%E3%81%AF%E3%81%AA%E3%81%8F%E5%AF%BE%E8%B1%A1%E3%81%8B%E3%82%89%E8%AA%AD%E3%82%80\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e台帳はサービス名ではなく対象から読む\u003c/h2\u003e\n\u003cp data-sourcepos=\"15:1-15:276\"\u003e既存の資産台帳があれば、それを使います。なければ、自分の管理対象について分かる範囲を紙に書くだけでも確認できます。次の表は項目の例であり、架空の契約や認証情報を埋める必要はありません。\u003c/p\u003e\n\u003ctable data-sourcepos=\"17:1-22:85\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"17:1-17:88\"\u003e\n\u003cth data-sourcepos=\"17:2-17:9\"\u003e対象\u003c/th\u003e\n\u003cth data-sourcepos=\"17:11-17:54\"\u003e自分たちの記録で確認するもの\u003c/th\u003e\n\u003cth data-sourcepos=\"17:56-17:87\"\u003eこの表に書かないもの\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"19:1-19:103\"\u003e\n\u003ctd data-sourcepos=\"19:2-19:21\"\u003eドメイン登録\u003c/td\u003e\n\u003ctd data-sourcepos=\"19:23-19:75\"\u003e契約先、更新担当、契約記録の保管先\u003c/td\u003e\n\u003ctd data-sourcepos=\"19:77-19:102\"\u003e移管用の秘密情報\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"20:1-20:97\"\u003e\n\u003ctd data-sourcepos=\"20:2-20:12\"\u003eDNS管理\u003c/td\u003e\n\u003ctd data-sourcepos=\"20:14-20:57\"\u003e管理画面を扱う担当、承認経路\u003c/td\u003e\n\u003ctd data-sourcepos=\"20:59-20:96\"\u003eログイン情報やAPIの秘密値\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"21:1-21:97\"\u003e\n\u003ctd data-sourcepos=\"21:2-21:18\"\u003eサイト制作\u003c/td\u003e\n\u003ctd data-sourcepos=\"21:20-21:69\"\u003e制作担当、利用サービス、契約範囲\u003c/td\u003e\n\u003ctd data-sourcepos=\"21:71-21:96\"\u003e未公開案件の詳細\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"22:1-22:85\"\u003e\n\u003ctd data-sourcepos=\"22:2-22:9\"\u003e請求\u003c/td\u003e\n\u003ctd data-sourcepos=\"22:11-22:60\"\u003e請求の確認担当、既存伝票の参照先\u003c/td\u003e\n\u003ctd data-sourcepos=\"22:62-22:84\"\u003e支払情報の全文\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"24:1-24:237\"\u003e同じ会社が複数行を担当していても、行は分けます。登録先と契約があることを確認できても、電話で勧められた制作ツールまで現在の契約に含まれるとは言えないからです。\u003c/p\u003e\n\u003cp data-sourcepos=\"26:1-26:258\"\u003e逆に、サイト制作に別サービスを使っているという理由だけで、ドメイン登録先との関係を否定することもできません。役割を分けると、営業の説明と自分たちの管理範囲のずれが見えます。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"28:1-28:54\"\u003e\n\u003cspan id=\"読むだけの確認と変更操作を混ぜない\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E8%AA%AD%E3%82%80%E3%81%A0%E3%81%91%E3%81%AE%E7%A2%BA%E8%AA%8D%E3%81%A8%E5%A4%89%E6%9B%B4%E6%93%8D%E4%BD%9C%E3%82%92%E6%B7%B7%E3%81%9C%E3%81%AA%E3%81%84\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e読むだけの確認と変更操作を混ぜない\u003c/h2\u003e\n\u003cp data-sourcepos=\"30:1-30:213\"\u003eこの確認で必要なのは、既存の契約記録を見ることと、担当を確かめることです。DNSを書き換えたり、ネームサーバーを変更したりする作業ではありません。\u003c/p\u003e\n\u003cp data-sourcepos=\"32:1-32:378\"\u003e電話の相手に案内された画面ではなく、普段の手順で既存記録を開きます。相手に画面共有を求められたとしても、契約の有無を確認するために見せる必要はありません。これは将来そう求められた場合の境界で、今回の投稿に画面共有の要求があったという意味ではありません。\u003c/p\u003e\n\u003cp data-sourcepos=\"34:1-34:201\"\u003e登録先が一致したら「契約先の一致」だけを記録します。「発信者を認証済み」「制作ツールの導入を承認済み」へ状態を飛ばさないようにします。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"36:1-36:51\"\u003e\n\u003cspan id=\"案件情報は営業確認の入力にしない\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%A1%88%E4%BB%B6%E6%83%85%E5%A0%B1%E3%81%AF%E5%96%B6%E6%A5%AD%E7%A2%BA%E8%AA%8D%E3%81%AE%E5%85%A5%E5%8A%9B%E3%81%AB%E3%81%97%E3%81%AA%E3%81%84\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e案件情報は営業確認の入力にしない\u003c/h2\u003e\n\u003cp data-sourcepos=\"38:1-38:189\"\u003e開発中の案件数や顧客名、支払額を答えれば、話は具体的になるかもしれません。しかし、それらは発信元の確認に必要な情報とは別です。\u003c/p\u003e\n\u003cp data-sourcepos=\"40:1-40:276\"\u003e窓口担当から開発担当へ回すメモも、「制作ツールの提案があった。契約範囲の確認が必要」程度から始められます。投稿にあった質問を、そのまま社内で集めるべき項目に変えないことがポイントです。\u003c/p\u003e\n\u003cp data-sourcepos=\"42:1-42:225\"\u003e料金比較が本当に必要になったら、担当者が自分で必要な見積もり条件を決めます。突然の電話をきっかけに、未公開の予算や顧客案件を集約する必要はありません。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"44:1-44:45\"\u003e\n\u003cspan id=\"引き継ぎ先には権限を足さない\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%BC%95%E3%81%8D%E7%B6%99%E3%81%8E%E5%85%88%E3%81%AB%E3%81%AF%E6%A8%A9%E9%99%90%E3%82%92%E8%B6%B3%E3%81%95%E3%81%AA%E3%81%84\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e引き継ぎ先には権限を足さない\u003c/h2\u003e\n\u003cp data-sourcepos=\"46:1-46:372\"\u003e確認を別の担当者へ渡すときも、台帳の閲覧依頼と変更の承認依頼を分けます。「登録先を確認してほしい」という依頼に、移管や追加契約の承認まで含めないこと。受け取った側が何を終えればよいか分かる一文を添えれば、不要な管理画面操作を増やさずに引き継げます。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"48:1-48:36\"\u003e\n\u003cspan id=\"記録の終点を決めておく\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E8%A8%98%E9%8C%B2%E3%81%AE%E7%B5%82%E7%82%B9%E3%82%92%E6%B1%BA%E3%82%81%E3%81%A6%E3%81%8A%E3%81%8F\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e記録の終点を決めておく\u003c/h2\u003e\n\u003cp data-sourcepos=\"50:1-50:273\"\u003e確認結果は三つに分けて残せます。「契約記録が見つかった」「サービスの提案は未検討」「発信者との関係は未確認」。これは判定例で、今回の投稿者の会社で実際に確認された結果ではありません。\u003c/p\u003e\n\u003cp data-sourcepos=\"52:1-52:266\"\u003e他の番号の記述を読む場合も、\u003ca href=\"https://www.whocallme.co.uk/\" rel=\"nofollow noopener\" target=\"_blank\"\u003e番号から公開投稿を探す\u003c/a\u003e操作で得られるのは、あくまで投稿の文脈です。社内台帳の管理権限や契約の実在を置き換えるものではありません。\u003c/p\u003e\n\u003cp data-sourcepos=\"54:1-54:285\"\u003e今回の手順を使うなら、台帳の参照先と承認担当まで確認できたところで止めます。営業への返答を保留していても、ドメインの設定を触らず管理範囲を整理できれば、開発側で必要な切り分けは進んでいます。\u003c/p\u003e\n","body":"「誰からの電話？」と聞かれて、ドメインの契約先の名前が出てくると、開発担当まで話が回ってくることがあります。でも、ドメインを登録している会社と、サイトを作るサービスと、変更を承認する担当者は同じとは限りません。営業の真偽をその場で当てるより、管理対象と権限を分けて確認します。\n\n**運営側からの案内：** whocallme.co.uk のサイト側による紹介・宣伝を含む編集記事です。AIの補助を受けて起草しています。以下は手元の台帳で行える確認手順で、システムへの実装や導入効果を報告する記事ではありません。\n\n## 題材は「管理会社を名乗る電話」\n\n当サイトの01452 645519の番号ページには、会社のドメイン登録先を名乗る相手から、ウェブサイト制作ツールを勧められたという投稿があります。投稿者は、会社の案件や利用中サービスの料金について質問され、繰り返し電話があったと述べています。\n\n[ドメイン関連の営業についての投稿](https://www.whocallme.co.uk/phone/01452645519)は、元の公開日が分からない取り込み情報です。匿名の未検証の記述であり、記載された企業が実際に発信したとは確認できません。表示番号の偽装もあり得るため、番号の持ち主を確定する材料にもなりません。\n\nここでは企業名の正否を推測せず、「その会社と契約があるかもしれない」という話を、どこまで社内で確認できるかに絞ります。投稿者が述べた昨日・今日を、実際のカレンダーの日付に置き換えることもしません。\n\n## 台帳はサービス名ではなく対象から読む\n\n既存の資産台帳があれば、それを使います。なければ、自分の管理対象について分かる範囲を紙に書くだけでも確認できます。次の表は項目の例であり、架空の契約や認証情報を埋める必要はありません。\n\n| 対象 | 自分たちの記録で確認するもの | この表に書かないもの |\n|---|---|---|\n| ドメイン登録 | 契約先、更新担当、契約記録の保管先 | 移管用の秘密情報 |\n| DNS管理 | 管理画面を扱う担当、承認経路 | ログイン情報やAPIの秘密値 |\n| サイト制作 | 制作担当、利用サービス、契約範囲 | 未公開案件の詳細 |\n| 請求 | 請求の確認担当、既存伝票の参照先 | 支払情報の全文 |\n\n同じ会社が複数行を担当していても、行は分けます。登録先と契約があることを確認できても、電話で勧められた制作ツールまで現在の契約に含まれるとは言えないからです。\n\n逆に、サイト制作に別サービスを使っているという理由だけで、ドメイン登録先との関係を否定することもできません。役割を分けると、営業の説明と自分たちの管理範囲のずれが見えます。\n\n## 読むだけの確認と変更操作を混ぜない\n\nこの確認で必要なのは、既存の契約記録を見ることと、担当を確かめることです。DNSを書き換えたり、ネームサーバーを変更したりする作業ではありません。\n\n電話の相手に案内された画面ではなく、普段の手順で既存記録を開きます。相手に画面共有を求められたとしても、契約の有無を確認するために見せる必要はありません。これは将来そう求められた場合の境界で、今回の投稿に画面共有の要求があったという意味ではありません。\n\n登録先が一致したら「契約先の一致」だけを記録します。「発信者を認証済み」「制作ツールの導入を承認済み」へ状態を飛ばさないようにします。\n\n## 案件情報は営業確認の入力にしない\n\n開発中の案件数や顧客名、支払額を答えれば、話は具体的になるかもしれません。しかし、それらは発信元の確認に必要な情報とは別です。\n\n窓口担当から開発担当へ回すメモも、「制作ツールの提案があった。契約範囲の確認が必要」程度から始められます。投稿にあった質問を、そのまま社内で集めるべき項目に変えないことがポイントです。\n\n料金比較が本当に必要になったら、担当者が自分で必要な見積もり条件を決めます。突然の電話をきっかけに、未公開の予算や顧客案件を集約する必要はありません。\n\n## 引き継ぎ先には権限を足さない\n\n確認を別の担当者へ渡すときも、台帳の閲覧依頼と変更の承認依頼を分けます。「登録先を確認してほしい」という依頼に、移管や追加契約の承認まで含めないこと。受け取った側が何を終えればよいか分かる一文を添えれば、不要な管理画面操作を増やさずに引き継げます。\n\n## 記録の終点を決めておく\n\n確認結果は三つに分けて残せます。「契約記録が見つかった」「サービスの提案は未検討」「発信者との関係は未確認」。これは判定例で、今回の投稿者の会社で実際に確認された結果ではありません。\n\n他の番号の記述を読む場合も、[番号から公開投稿を探す](https://www.whocallme.co.uk/)操作で得られるのは、あくまで投稿の文脈です。社内台帳の管理権限や契約の実在を置き換えるものではありません。\n\n今回の手順を使うなら、台帳の参照先と承認担当まで確認できたところで止めます。営業への返答を保留していても、ドメインの設定を触らず管理範囲を整理できれば、開発側で必要な切り分けは進んでいます。\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T01:44:37+09:00","group":null,"id":"831bf048fc678714aff7","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"ドメイン","versions":[]},{"name":"Security","versions":[]},{"name":"情報管理","versions":[]}],"title":"誰からの電話？ ドメイン管理を名乗る営業を、開発者の資産台帳で切り分ける","updated_at":"2026-11-18T01:44:37+09:00","url":"https://qiita.com/whocallmeuknotes/items/831bf048fc678714aff7","user":{"description":null,"facebook_id":null,"followees_count":1,"followers_count":0,"github_login_name":null,"id":"whocallmeuknotes","items_count":1,"linkedin_id":null,"location":null,"name":"","organization":null,"permanent_id":4534198,"profile_image_url":"https://secure.gravatar.com/avatar/e4faaefda48bf3cfb23aed88bb78c560","team_only":false,"twitter_screen_name":null,"website_url":null},"page_views_count":null,"team_membership":null,"organization_url_name":null,"slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003ch1 data-sourcepos=\"1:1-1:116\"\u003e\n\u003cspan id=\"rp2350b-1-チップで作るオールドファッションなパソコンsgnanoα版を公開しました\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#rp2350b-1-%E3%83%81%E3%83%83%E3%83%97%E3%81%A7%E4%BD%9C%E3%82%8B%E3%82%AA%E3%83%BC%E3%83%AB%E3%83%89%E3%83%95%E3%82%A1%E3%83%83%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%AA%E3%83%91%E3%82%BD%E3%82%B3%E3%83%B3sgnano%CE%B1%E7%89%88%E3%82%92%E5%85%AC%E9%96%8B%E3%81%97%E3%81%BE%E3%81%97%E3%81%9F\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eRP2350B 1 チップで作る、オールドファッションなパソコン「sgnano」α版を公開しました\u003c/h1\u003e\n\u003cp data-sourcepos=\"3:1-3:58\"\u003eこんにちは。南極獅子（antarcticlion）です。\u003c/p\u003e\n\u003cp data-sourcepos=\"5:1-6:164\"\u003eRP2350B のチップ 1 つで、\u003cstrong\u003e画面・音・USB・ファイル・言語処理系・シェルまで入った\u003c/strong\u003e「\u003cstrong\u003eパソコン\u003c/strong\u003e」を作りました。\u003cbr\u003e\n名前は \u003cstrong\u003esgnano\u003c/strong\u003e（エスジーナノ）。2026 年 9 月 21 日にカラーバーを出すひな形から始めて、約 2 か月で α版まで来ました。\u003c/p\u003e\n\u003cul data-sourcepos=\"8:1-11:0\"\u003e\n\u003cli data-sourcepos=\"8:1-8:60\"\u003eリポジトリ: \u003ca href=\"https://github.com/antarcticlion/sgnano\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://github.com/antarcticlion/sgnano\u003c/a\u003e\n\u003c/li\u003e\n\u003cli data-sourcepos=\"9:1-9:88\"\u003eダウンロード（α1）: \u003ca href=\"https://github.com/antarcticlion/sgnano/releases/latest\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://github.com/antarcticlion/sgnano/releases/latest\u003c/a\u003e\n\u003c/li\u003e\n\u003cli data-sourcepos=\"10:1-11:0\"\u003e読み物（sgnano magazine）: \u003ca href=\"https://github.com/antarcticlion/sgnano/tree/master/docs/magazine\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://github.com/antarcticlion/sgnano/tree/master/docs/magazine\u003c/a\u003e\n\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"12:1-12:81\"\u003eこの記事では、何ができて、どう作ったのかを紹介します。\u003c/p\u003e\n\u003chr data-sourcepos=\"14:1-15:0\"\u003e\n\u003ch2 data-sourcepos=\"16:1-16:24\"\u003e\n\u003cspan id=\"電源を入れると\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E9%9B%BB%E6%BA%90%E3%82%92%E5%85%A5%E3%82%8C%E3%82%8B%E3%81%A8\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e電源を入れると\u003c/h2\u003e\n\u003cp data-sourcepos=\"18:1-18:104\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fboot_banner.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=e31383ca3f367d9ce0bb8c61bfdb2bc6\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fboot_banner.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=e31383ca3f367d9ce0bb8c61bfdb2bc6\" alt=\"起動バナー\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fboot_banner.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=7eebdbfd543b69ca22b32883c9e99277 1x\" data-canonical-src=\"https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/boot_banner.jpg\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"20:1-20:186\"\u003e全角の「ＳＧＮＡＮＯ」の題字が出て、星が流れます。8 秒（キーを押せばすぐ）で、PC-98 の FD に倣った 2 列のファイル一覧になります。\u003c/p\u003e\n\u003cp data-sourcepos=\"22:1-22:98\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Ffiler.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=cd9d2b88498cd1766bd6fa37adf6dfbd\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Ffiler.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=cd9d2b88498cd1766bd6fa37adf6dfbd\" alt=\"ファイラー\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Ffiler.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=7e14f3fccfa71574a70ef4ac10d28858 1x\" data-canonical-src=\"https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/filer.jpg\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"24:1-25:191\"\u003eそこから、テキストエディタでプログラムを書いて、その場で走らせられます。\u003cbr\u003e\n言語は \u003cstrong\u003emruby 4.0.0\u003c/strong\u003e、\u003cstrong\u003eMicroPython 1.29.0\u003c/strong\u003e、\u003cstrong\u003eSG BASIC R03.001\u003c/strong\u003eの 3 つ。どれも同じ \u003ccode\u003eMachine\u003c/code\u003e クラスで画面・音・GPIO を触れるようにそろえてあります。\u003c/p\u003e\n\u003cp data-sourcepos=\"27:1-27:107\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Ffontdemo.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=d08338396e1953503c15a5594a934782\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Ffontdemo.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=d08338396e1953503c15a5594a934782\" alt=\"フォントのデモ\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Ffontdemo.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=9b422d2b23e2dd00ee932857e4e32fad 1x\" data-canonical-src=\"https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/fontdemo.jpg\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"29:1-29:242\"\u003eフォントは \u003cstrong\u003e57,404 文字\u003c/strong\u003e（EmbFont16 v2.0、GNU Unifont の字形）。色・太字・下線・取り消し線・上線・反転・点滅・左右の線・回転・倍角を 1 画面で確かめられるデモが入っています。\u003c/p\u003e\n\u003chr data-sourcepos=\"31:1-32:0\"\u003e\n\u003ch2 data-sourcepos=\"33:1-33:21\"\u003e\n\u003cspan id=\"ハードウェア\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%8F%E3%83%BC%E3%83%89%E3%82%A6%E3%82%A7%E3%82%A2\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eハードウェア\u003c/h2\u003e\n\u003cp data-sourcepos=\"35:1-35:96\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fc_board.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=4e7374108c23254c2021c6cfb3226ef2\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fc_board.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=4e7374108c23254c2021c6cfb3226ef2\" alt=\"C ボード\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fc_board.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=25e5a930248f6617860ef0e28da0afca 1x\" data-canonical-src=\"https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/c_board.jpg\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cul data-sourcepos=\"37:1-42:0\"\u003e\n\u003cli data-sourcepos=\"37:1-37:74\"\u003e\n\u003cstrong\u003eCPU\u003c/strong\u003e: WeAct Studio RP2350B Core Board（Cortex-M33 × 2、302.4MHz）\u003c/li\u003e\n\u003cli data-sourcepos=\"38:1-38:62\"\u003e\n\u003cstrong\u003eメモリ\u003c/strong\u003e: SRAM 520KB、PSRAM 8MB、フラッシュ 16MB\u003c/li\u003e\n\u003cli data-sourcepos=\"39:1-39:117\"\u003e\n\u003cstrong\u003e画面\u003c/strong\u003e: R・G・B 各 5 ビットの R-2R ラダー DAC。15kHz / 24kHz / 31kHz の 12 通りのタイミング\u003c/li\u003e\n\u003cli data-sourcepos=\"40:1-40:126\"\u003e\n\u003cstrong\u003e音\u003c/strong\u003e: PT8211 × 4（1 チップに 1 声）。オペアンプで混ぜ、150kHz の LPF を通してラインアウトへ\u003c/li\u003e\n\u003cli data-sourcepos=\"41:1-42:0\"\u003e\n\u003cstrong\u003e入出力\u003c/strong\u003e: USB ホスト（キーボード・マウス・ストレージ・MIDI・LAN）、DIN MIDI、GPIO 8 本（PIO2 を開放）、ADC\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"43:1-44:121\"\u003e基板は 100 x 100mm の C ボードで、手はんだを前提にした高密度の実装です。\u003cbr\u003e\nガーバー・部品表・**26 ページの組み立てガイド（PDF）**もリポジトリに入れてあります。\u003c/p\u003e\n\u003cul data-sourcepos=\"46:1-47:0\"\u003e\n\u003cli data-sourcepos=\"46:1-47:0\"\u003e組み立てガイド: \u003ca href=\"https://github.com/antarcticlion/sgnano/blob/master/hardware/c_board/ASSEMBLY.md\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://github.com/antarcticlion/sgnano/blob/master/hardware/c_board/ASSEMBLY.md\u003c/a\u003e\n\u003c/li\u003e\n\u003c/ul\u003e\n\u003chr data-sourcepos=\"48:1-49:0\"\u003e\n\u003ch2 data-sourcepos=\"50:1-50:9\"\u003e\n\u003cspan id=\"中身\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%B8%AD%E8%BA%AB\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e中身\u003c/h2\u003e\n\u003ch3 data-sourcepos=\"52:1-52:19\"\u003e\n\u003cspan id=\"ファイラー\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%A9%E3%83%BC\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eファイラー\u003c/h3\u003e\n\u003cp data-sourcepos=\"54:1-54:276\"\u003ePC-98 の FD に倣った 2 列の一覧に、コピー・移動（行き先を木から選ぶ）・削除・名前の変更・属性・分割と結合・ZMODEM・テキスト / 16 進 / 画像のビュアー・テキストエディタ・日本語 IME が入っています。\u003c/p\u003e\n\u003cp data-sourcepos=\"56:1-56:90\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fsgcalc.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=1ef41e2dfd3129f6fe06d64edde17454\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fsgcalc.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=1ef41e2dfd3129f6fe06d64edde17454\" alt=\"SGCALC\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fsgcalc.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=4c09931f672471a16555f2b4d4f943ca 1x\" data-canonical-src=\"https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/sgcalc.jpg\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"58:1-58:135\"\u003e表計算の \u003cstrong\u003eSGCALC\u003c/strong\u003e は、セルに \u003ccode\u003e#!ruby\u003c/code\u003e / \u003ccode\u003e#!python\u003c/code\u003e / \u003ccode\u003e#!basic\u003c/code\u003e と書くと\u003cstrong\u003eマクロとして 3 言語で動きます\u003c/strong\u003e。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"60:1-60:13\"\u003e\n\u003cspan id=\"シェル\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%B7%E3%82%A7%E3%83%AB\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eシェル\u003c/h3\u003e\n\u003cp data-sourcepos=\"62:1-62:92\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fshell.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=e1604537f9a7e7a648d0c79ddb101862\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fshell.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=e1604537f9a7e7a648d0c79ddb101862\" alt=\"シェル\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fshell.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=f86b283718a7f5fe1f8576254a940229 1x\" data-canonical-src=\"https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/shell.jpg\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"64:1-64:273\"\u003ecsh のサブセット \u003cstrong\u003esgsh\u003c/strong\u003e。VT220 の上位互換の端末で、組み込みコマンド 70 個（\u003ccode\u003ezip\u003c/code\u003e / \u003ccode\u003eunzip\u003c/code\u003e / \u003ccode\u003e7z\u003c/code\u003e / \u003ccode\u003egzip\u003c/code\u003e / \u003ccode\u003ebzip2\u003c/code\u003e / \u003ccode\u003exz\u003c/code\u003e / \u003ccode\u003etar\u003c/code\u003e を含む）、履歴、別名、\u003ccode\u003eif\u003c/code\u003e / \u003ccode\u003ewhile\u003c/code\u003e / \u003ccode\u003eforeach\u003c/code\u003e / \u003ccode\u003eswitch\u003c/code\u003e / \u003ccode\u003egoto\u003c/code\u003e、パイプと背景の仕事。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"66:1-66:37\"\u003e\n\u003cspan id=\"外部実行ファイルsgx\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%A4%96%E9%83%A8%E5%AE%9F%E8%A1%8C%E3%83%95%E3%82%A1%E3%82%A4%E3%83%ABsgx\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e外部実行ファイル（SGX）\u003c/h3\u003e\n\u003cp data-sourcepos=\"68:1-68:160\"\u003eC で組んだ \u003ccode\u003e.sgx\u003c/code\u003e を PSRAM に読み込んで、RTOS のタスクとして走らせられます。\u003cstrong\u003eSGX ABI は 5.12（5.x を凍結、追加のみ）\u003c/strong\u003e。\u003c/p\u003e\n\u003cul data-sourcepos=\"70:1-71:0\"\u003e\n\u003cli data-sourcepos=\"70:1-71:0\"\u003eSDK と見本: \u003ca href=\"https://github.com/antarcticlion/sgnano/tree/master/sdk/sgx\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://github.com/antarcticlion/sgnano/tree/master/sdk/sgx\u003c/a\u003e\n\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"72:1-72:84\"\u003e大きな例は Doom と wav2mp3 で、別のリポジトリに分けています。\u003c/p\u003e\n\u003cul data-sourcepos=\"74:1-76:0\"\u003e\n\u003cli data-sourcepos=\"74:1-74:55\"\u003e\u003ca href=\"https://github.com/antarcticlion/sgnano_doomgeneric\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://github.com/antarcticlion/sgnano_doomgeneric\u003c/a\u003e\u003c/li\u003e\n\u003cli data-sourcepos=\"75:1-76:0\"\u003e\u003ca href=\"https://github.com/antarcticlion/sgnano_wav2mp3\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://github.com/antarcticlion/sgnano_wav2mp3\u003c/a\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\u003chr data-sourcepos=\"77:1-78:0\"\u003e\n\u003ch2 data-sourcepos=\"79:1-79:18\"\u003e\n\u003cspan id=\"画面モード\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%94%BB%E9%9D%A2%E3%83%A2%E3%83%BC%E3%83%89\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e画面モード\u003c/h2\u003e\n\u003cp data-sourcepos=\"81:1-81:237\"\u003eテキスト面（80x30、Unicode、32 ビットの属性）と、フレームバッファ（RGB555 / CLUT8 / CLUT4）、ローレゾ面（BG 2 面 + オブジェクト 128 個）を組み合わせて、モード 0〜7 があります。\u003c/p\u003e\n\u003cp data-sourcepos=\"83:1-83:100\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fmode7.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=89badf25adfa5137b1278a211f5696cf\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fmode7.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=89badf25adfa5137b1278a211f5696cf\" alt=\"画面モード 7\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fmode7.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=ccc6c4f070409426931ce76376a1bc86 1x\" data-canonical-src=\"https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/mode7.jpg\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"85:1-85:105\"\u003eモード 7 は 320x200x256（VGA の 13h 相当）+ テキスト 25 行。プラズマが回ります。\u003c/p\u003e\n\u003cp data-sourcepos=\"87:1-87:100\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fmode3.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=dfd2b838a7233f749397bdb31e16d477\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fmode3.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=dfd2b838a7233f749397bdb31e16d477\" alt=\"画面モード 3\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fmode3.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=afacd0346ad3ab2c2260ef9305404fe7 1x\" data-canonical-src=\"https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/mode3.jpg\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"89:1-89:138\"\u003eモード 3 は 256 色の FB + ローレゾ。テストアプリの \u003ccode\u003emode3.sgx\u003c/code\u003e は、色の帯と低解像度のデモを出します。\u003c/p\u003e\n\u003chr data-sourcepos=\"91:1-92:0\"\u003e\n\u003ch2 data-sourcepos=\"93:1-93:18\"\u003e\n\u003cspan id=\"遊べるもの\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E9%81%8A%E3%81%B9%E3%82%8B%E3%82%82%E3%81%AE\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e遊べるもの\u003c/h2\u003e\n\u003cp data-sourcepos=\"95:1-95:89\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fshogi.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=a251e56933eb9ae885c821bed23b4531\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fshogi.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=a251e56933eb9ae885c821bed23b4531\" alt=\"将棋\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fshogi.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=21018c7098532acdb2bef4182daf8bbf 1x\" data-canonical-src=\"https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/shogi.jpg\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"97:1-97:252\"\u003emruby で書いた将棋（盤・持駒・読み）。ほかに jumps（横スクロールのゲーム）、ラスターバー、マンデルブロ、3D の網、タブレットの試験などが \u003ccode\u003esamples/\u003c/code\u003e と S: の \u003ccode\u003etestapp\u003c/code\u003e に入っています。\u003c/p\u003e\n\u003cp data-sourcepos=\"99:1-99:88\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fjumps.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=198faabd2eaa692f8ce4ce3013083399\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fjumps.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=198faabd2eaa692f8ce4ce3013083399\" alt=\"jumps\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fjumps.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=490deaec8077b3c6ddcbd66d8f0b3a70 1x\" data-canonical-src=\"https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/jumps.jpg\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003chr data-sourcepos=\"101:1-102:0\"\u003e\n\u003ch2 data-sourcepos=\"103:1-103:24\"\u003e\n\u003cspan id=\"今回の見どころ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BB%8A%E5%9B%9E%E3%81%AE%E8%A6%8B%E3%81%A9%E3%81%93%E3%82%8D\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e今回の見どころ\u003c/h2\u003e\n\u003cul data-sourcepos=\"105:1-109:0\"\u003e\n\u003cli data-sourcepos=\"105:1-105:174\"\u003e\n\u003cstrong\u003e表示の言語が 62\u003c/strong\u003e。2026-11-17 に欧州・EU の 34 言語を追加しました（\u003ccode\u003enn\u003c/code\u003e・\u003ccode\u003erm\u003c/code\u003e は保留）。日本語と英語以外はまだ機械翻訳です。\u003c/li\u003e\n\u003cli data-sourcepos=\"106:1-106:175\"\u003e\n\u003cstrong\u003eIME\u003c/strong\u003e（日本語・English・한국어）。日本語の漢字変換の辞書は 8.8MB で S:（4MB）に入らないため、\u003cstrong\u003eUSB メモリに置く別配布\u003c/strong\u003eです。\u003c/li\u003e\n\u003cli data-sourcepos=\"107:1-107:259\"\u003e\n\u003cstrong\u003e圧縮と書庫\u003c/strong\u003e。gzip・zlib・bzip2・LZMA・xz、ZIP・7z・tar（.tar.gz / .tar.bz2 / .tar.xz）を、シェルとファイラーと 3 言語から。コピーレフトでない部品（miniz・libbzip2・LZMA SDK）だけで組んであります。\u003c/li\u003e\n\u003cli data-sourcepos=\"108:1-109:0\"\u003e\n\u003cstrong\u003e音\u003c/strong\u003e。4 声のウェーブテーブル、SMF / SGT のシーケンサー、MP3 / OGG / WAV（96kHz / 24bit まで）、VGM / VGZ（YM2151・YM2612・C352 など）、音楽 CD の再生とスペクトログラム。\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"110:1-110:110\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fcd.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=1b58fbad8d8019751941d4c87c054b52\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fcd.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=1b58fbad8d8019751941d4c87c054b52\" alt=\"CD のスペクトログラム\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fcd.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=b70022f132b22175a7769d34229a939c 1x\" data-canonical-src=\"https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/cd.jpg\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"112:1-112:89\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fclock.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=276ba0e19feaf8ca38b93baed8d52d84\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fclock.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=276ba0e19feaf8ca38b93baed8d52d84\" alt=\"時計\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fraw.githubusercontent.com%2Fantarcticlion%2Fsgnano%2Fmaster%2Fimages%2Fclock.jpg?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=0959fb6b49fe4fa028188410a07f0c4f 1x\" data-canonical-src=\"https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/clock.jpg\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003chr data-sourcepos=\"114:1-115:0\"\u003e\n\u003ch2 data-sourcepos=\"116:1-116:18\"\u003e\n\u003cspan id=\"動かすには\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%8B%95%E3%81%8B%E3%81%99%E3%81%AB%E3%81%AF\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e動かすには\u003c/h2\u003e\n\u003ch3 data-sourcepos=\"118:1-118:19\"\u003e\n\u003cspan id=\"必要なもの\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%BF%85%E8%A6%81%E3%81%AA%E3%82%82%E3%81%AE\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e必要なもの\u003c/h3\u003e\n\u003cul data-sourcepos=\"120:1-125:0\"\u003e\n\u003cli data-sourcepos=\"120:1-120:133\"\u003e\n\u003cstrong\u003eC ボード\u003c/strong\u003e（ガーバーと組み立てガイドはリポジトリにあります）と、WeAct Studio の RP2350B Core Board\u003c/li\u003e\n\u003cli data-sourcepos=\"121:1-121:31\"\u003ePSRAM（ESP-PSRAM64H、8MB）\u003c/li\u003e\n\u003cli data-sourcepos=\"122:1-122:68\"\u003eVGA モニタ（15kHz か 24kHz か 31kHz に対応するもの）\u003c/li\u003e\n\u003cli data-sourcepos=\"123:1-123:21\"\u003eUSB キーボード\u003c/li\u003e\n\u003cli data-sourcepos=\"124:1-125:0\"\u003e書き込み用に Raspberry Pi Pico / Pico 2（debugprobe ファームウェアを推奨）\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch3 data-sourcepos=\"126:1-126:16\"\u003e\n\u003cspan id=\"書き込み\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%9B%B8%E3%81%8D%E8%BE%BC%E3%81%BF\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e書き込み\u003c/h3\u003e\n\u003cp data-sourcepos=\"128:1-128:158\"\u003e\u003ca href=\"https://github.com/antarcticlion/sgnano/releases/latest\" rel=\"nofollow noopener\" target=\"_blank\"\u003eReleases\u003c/a\u003e から UF2 を落として、BOOTSEL で立ち上げた \u003ccode\u003eRPI-RP2\u003c/code\u003e へコピーします。\u003c/p\u003e\n\u003ctable data-sourcepos=\"130:1-134:85\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"130:1-130:31\"\u003e\n\u003cth data-sourcepos=\"130:2-130:15\"\u003eファイル\u003c/th\u003e\n\u003cth data-sourcepos=\"130:17-130:30\"\u003e使うとき\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"132:1-132:74\"\u003e\n\u003ctd data-sourcepos=\"132:2-132:14\"\u003e\u003ccode\u003e-full.uf2\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-sourcepos=\"132:16-132:73\"\u003e初回・初期化（ファーム + S: + フォント）\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"133:1-133:79\"\u003e\n\u003ctd data-sourcepos=\"133:2-133:18\"\u003e\u003ccode\u003e-firmware.uf2\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-sourcepos=\"133:20-133:78\"\u003eファームだけ更新（S: とフォントは残る）\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"134:1-134:85\"\u003e\n\u003ctd data-sourcepos=\"134:2-134:21\"\u003e\u003ccode\u003e-system-font.uf2\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-sourcepos=\"134:23-134:84\"\u003eS: とフォントを入れ直す（ファームは残る）\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"136:1-136:151\"\u003e日本語の漢字変換を使うときは、\u003ccode\u003e-ime-dict.zip\u003c/code\u003e を展開して、USB メモリのルートに \u003ccode\u003eSgnanoIME/\u003c/code\u003e ごと置いてください。\u003c/p\u003e\n\u003chr data-sourcepos=\"138:1-139:0\"\u003e\n\u003ch2 data-sourcepos=\"140:1-140:29\"\u003e\n\u003cspan id=\"いまの制約α版\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%84%E3%81%BE%E3%81%AE%E5%88%B6%E7%B4%84%CE%B1%E7%89%88\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eいまの制約（α版）\u003c/h2\u003e\n\u003cp data-sourcepos=\"142:1-142:68\"\u003eα版なので、以下は承知のうえで遊んでください。\u003c/p\u003e\n\u003cul data-sourcepos=\"144:1-150:0\"\u003e\n\u003cli data-sourcepos=\"144:1-144:175\"\u003e\n\u003cstrong\u003eファームのソースは α1 に含みません\u003c/strong\u003e（後のリリースで MIT 公開の予定）。SDK・見本・Doom / wav2mp3 のソースは公開しています。\u003c/li\u003e\n\u003cli data-sourcepos=\"145:1-145:144\"\u003ePSRAM は定格 133MHz を超える \u003cstrong\u003e151.2MHz\u003c/strong\u003e で動かしています。個体差・温度で不安定になる可能性があります。\u003c/li\u003e\n\u003cli data-sourcepos=\"146:1-146:138\"\u003e一覧で \u003cstrong\u003e\u003ccode\u003eShift+F1\u003c/code\u003e〜\u003ccode\u003eShift+F12\u003c/code\u003e が効きません\u003c/strong\u003e（文字のキー \u003ccode\u003eD\u003c/code\u003e \u003ccode\u003eK\u003c/code\u003e \u003ccode\u003eH\u003c/code\u003e などで代用）。次の版で直します。\u003c/li\u003e\n\u003cli data-sourcepos=\"147:1-147:130\"\u003eMicroPython の見本のうち \u003cstrong\u003e\u003ccode\u003efontdemo.py\u003c/code\u003e と \u003ccode\u003egfx.py\u003c/code\u003e が実機で動きません\u003c/strong\u003e（\u003ccode\u003e.rb\u003c/code\u003e / \u003ccode\u003e.bas\u003c/code\u003e は動きます）。\u003c/li\u003e\n\u003cli data-sourcepos=\"148:1-148:140\"\u003eリセット直後にごくまれに起動しないことがあります（GP0）。そのときはリセットし直してください。\u003c/li\u003e\n\u003cli data-sourcepos=\"149:1-150:0\"\u003e日本語・英語以外の 60 言語は機械翻訳のままです。翻訳の協力者を募集中です。\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"151:1-151:134\"\u003e詳しくは \u003ca href=\"https://github.com/antarcticlion/sgnano/blob/master/docs/KNOWN_LIMITATIONS.md\" rel=\"nofollow noopener\" target=\"_blank\"\u003e既知の制約\u003c/a\u003e を見てください。\u003c/p\u003e\n\u003chr data-sourcepos=\"153:1-154:0\"\u003e\n\u003ch2 data-sourcepos=\"155:1-155:15\"\u003e\n\u003cspan id=\"開発の話\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E9%96%8B%E7%99%BA%E3%81%AE%E8%A9%B1\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e開発の話\u003c/h2\u003e\n\u003cul data-sourcepos=\"157:1-161:0\"\u003e\n\u003cli data-sourcepos=\"157:1-157:139\"\u003e言語処理系は mruby・MicroPython・SG BASIC をソースから組み込み、\u003ccode\u003eMachine\u003c/code\u003e の API を 3 言語でそろえました。\u003c/li\u003e\n\u003cli data-sourcepos=\"158:1-158:87\"\u003eRTOS は自前（M33BEATOS）。2 コアで描画とアプリを分けています。\u003c/li\u003e\n\u003cli data-sourcepos=\"159:1-159:128\"\u003e画面の描画は PIO で VGA のタイミングを作り、PSRAM のフレームバッファを DMA で流しています。\u003c/li\u003e\n\u003cli data-sourcepos=\"160:1-161:0\"\u003eホスト試験は 50 本、実機の起動試験は 92 本中 90 本、静的解析（cppcheck）は warning 0 まで片づけました。\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"162:1-162:162\"\u003e開発の記録は \u003ccode\u003edocs/notes/\u003c/code\u003e に、仕様は \u003ccode\u003edocs/\u003c/code\u003e にあります。読み物として \u003cstrong\u003esgnano magazine\u003c/strong\u003e も書きました（第 1 号・第 2 号）。\u003c/p\u003e\n\u003cul data-sourcepos=\"164:1-165:0\"\u003e\n\u003cli data-sourcepos=\"164:1-165:0\"\u003e\u003ca href=\"https://github.com/antarcticlion/sgnano/tree/master/docs/magazine\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://github.com/antarcticlion/sgnano/tree/master/docs/magazine\u003c/a\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\u003chr data-sourcepos=\"166:1-167:0\"\u003e\n\u003ch2 data-sourcepos=\"168:1-168:12\"\u003e\n\u003cspan id=\"リンク\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%AA%E3%83%B3%E3%82%AF\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eリンク\u003c/h2\u003e\n\u003ctable data-sourcepos=\"170:1-177:82\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"170:1-170:5\"\u003e\n\u003cth data-sourcepos=\"170:2-170:2\"\u003e\u003c/th\u003e\n\u003cth data-sourcepos=\"170:4-170:4\"\u003e\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"172:1-172:63\"\u003e\n\u003ctd data-sourcepos=\"172:2-172:18\"\u003eリポジトリ\u003c/td\u003e\n\u003ctd data-sourcepos=\"172:20-172:62\"\u003e\u003ca href=\"https://github.com/antarcticlion/sgnano\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://github.com/antarcticlion/sgnano\u003c/a\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"173:1-173:91\"\u003e\n\u003ctd data-sourcepos=\"173:2-173:30\"\u003eダウンロード（α1）\u003c/td\u003e\n\u003ctd data-sourcepos=\"173:32-173:90\"\u003e\u003ca href=\"https://github.com/antarcticlion/sgnano/releases/latest\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://github.com/antarcticlion/sgnano/releases/latest\u003c/a\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"174:1-174:89\"\u003e\n\u003ctd data-sourcepos=\"174:2-174:18\"\u003esgnano magazine\u003c/td\u003e\n\u003ctd data-sourcepos=\"174:20-174:88\"\u003e\u003ca href=\"https://github.com/antarcticlion/sgnano/tree/master/docs/magazine\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://github.com/antarcticlion/sgnano/tree/master/docs/magazine\u003c/a\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"175:1-175:120\"\u003e\n\u003ctd data-sourcepos=\"175:2-175:33\"\u003e組み立てガイド（PDF）\u003c/td\u003e\n\u003ctd data-sourcepos=\"175:35-175:119\"\u003e\u003ca href=\"https://github.com/antarcticlion/sgnano/blob/master/hardware/c_board/ASSEMBLY.pdf\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://github.com/antarcticlion/sgnano/blob/master/hardware/c_board/ASSEMBLY.pdf\u003c/a\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"176:1-176:78\"\u003e\n\u003ctd data-sourcepos=\"176:2-176:30\"\u003eフォント（EmbFont16）\u003c/td\u003e\n\u003ctd data-sourcepos=\"176:32-176:77\"\u003e\u003ca href=\"https://github.com/antarcticlion/EmbFont16\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://github.com/antarcticlion/EmbFont16\u003c/a\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"177:1-177:82\"\u003e\n\u003ctd data-sourcepos=\"177:2-177:30\"\u003ePC 側のファイル管理\u003c/td\u003e\n\u003ctd data-sourcepos=\"177:32-177:81\"\u003e\u003ca href=\"https://github.com/antarcticlion/sgnano_remote\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://github.com/antarcticlion/sgnano_remote\u003c/a\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"179:1-179:177\"\u003e不具合は Issues へ。ビルド ID（\u003ccode\u003ealpha1-2026.11+g6913368\u003c/code\u003e）・画面モード・つないでいる機器・再現の手順を書いてもらえると助かります。\u003c/p\u003e\n\u003cp data-sourcepos=\"181:1-181:170\"\u003eα版の間は、対応や修正の期限を約束できません。それでも、触ってみて「これは面白い」と思ってもらえたらうれしいです。\u003c/p\u003e\n","body":"# RP2350B 1 チップで作る、オールドファッションなパソコン「sgnano」α版を公開しました\n\nこんにちは。南極獅子（antarcticlion）です。\n\nRP2350B のチップ 1 つで、**画面・音・USB・ファイル・言語処理系・シェルまで入った**「**パソコン**」を作りました。\n名前は **sgnano**（エスジーナノ）。2026 年 9 月 21 日にカラーバーを出すひな形から始めて、約 2 か月で α版まで来ました。\n\n- リポジトリ: \u003chttps://github.com/antarcticlion/sgnano\u003e\n- ダウンロード（α1）: \u003chttps://github.com/antarcticlion/sgnano/releases/latest\u003e\n- 読み物（sgnano magazine）: \u003chttps://github.com/antarcticlion/sgnano/tree/master/docs/magazine\u003e\n\nこの記事では、何ができて、どう作ったのかを紹介します。\n\n---\n\n## 電源を入れると\n\n![起動バナー](https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/boot_banner.jpg)\n\n全角の「ＳＧＮＡＮＯ」の題字が出て、星が流れます。8 秒（キーを押せばすぐ）で、PC-98 の FD に倣った 2 列のファイル一覧になります。\n\n![ファイラー](https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/filer.jpg)\n\nそこから、テキストエディタでプログラムを書いて、その場で走らせられます。\n言語は **mruby 4.0.0**、**MicroPython 1.29.0**、**SG BASIC R03.001**の 3 つ。どれも同じ `Machine` クラスで画面・音・GPIO を触れるようにそろえてあります。\n\n![フォントのデモ](https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/fontdemo.jpg)\n\nフォントは **57,404 文字**（EmbFont16 v2.0、GNU Unifont の字形）。色・太字・下線・取り消し線・上線・反転・点滅・左右の線・回転・倍角を 1 画面で確かめられるデモが入っています。\n\n---\n\n## ハードウェア\n\n![C ボード](https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/c_board.jpg)\n\n- **CPU**: WeAct Studio RP2350B Core Board（Cortex-M33 × 2、302.4MHz）\n- **メモリ**: SRAM 520KB、PSRAM 8MB、フラッシュ 16MB\n- **画面**: R・G・B 各 5 ビットの R-2R ラダー DAC。15kHz / 24kHz / 31kHz の 12 通りのタイミング\n- **音**: PT8211 × 4（1 チップに 1 声）。オペアンプで混ぜ、150kHz の LPF を通してラインアウトへ\n- **入出力**: USB ホスト（キーボード・マウス・ストレージ・MIDI・LAN）、DIN MIDI、GPIO 8 本（PIO2 を開放）、ADC\n\n基板は 100 x 100mm の C ボードで、手はんだを前提にした高密度の実装です。\nガーバー・部品表・**26 ページの組み立てガイド（PDF）**もリポジトリに入れてあります。\n\n- 組み立てガイド: \u003chttps://github.com/antarcticlion/sgnano/blob/master/hardware/c_board/ASSEMBLY.md\u003e\n\n---\n\n## 中身\n\n### ファイラー\n\nPC-98 の FD に倣った 2 列の一覧に、コピー・移動（行き先を木から選ぶ）・削除・名前の変更・属性・分割と結合・ZMODEM・テキスト / 16 進 / 画像のビュアー・テキストエディタ・日本語 IME が入っています。\n\n![SGCALC](https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/sgcalc.jpg)\n\n表計算の **SGCALC** は、セルに `#!ruby` / `#!python` / `#!basic` と書くと**マクロとして 3 言語で動きます**。\n\n### シェル\n\n![シェル](https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/shell.jpg)\n\ncsh のサブセット **sgsh**。VT220 の上位互換の端末で、組み込みコマンド 70 個（`zip` / `unzip` / `7z` / `gzip` / `bzip2` / `xz` / `tar` を含む）、履歴、別名、`if` / `while` / `foreach` / `switch` / `goto`、パイプと背景の仕事。\n\n### 外部実行ファイル（SGX）\n\nC で組んだ `.sgx` を PSRAM に読み込んで、RTOS のタスクとして走らせられます。**SGX ABI は 5.12（5.x を凍結、追加のみ）**。\n\n- SDK と見本: \u003chttps://github.com/antarcticlion/sgnano/tree/master/sdk/sgx\u003e\n\n大きな例は Doom と wav2mp3 で、別のリポジトリに分けています。\n\n- \u003chttps://github.com/antarcticlion/sgnano_doomgeneric\u003e\n- \u003chttps://github.com/antarcticlion/sgnano_wav2mp3\u003e\n\n---\n\n## 画面モード\n\nテキスト面（80x30、Unicode、32 ビットの属性）と、フレームバッファ（RGB555 / CLUT8 / CLUT4）、ローレゾ面（BG 2 面 + オブジェクト 128 個）を組み合わせて、モード 0〜7 があります。\n\n![画面モード 7](https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/mode7.jpg)\n\nモード 7 は 320x200x256（VGA の 13h 相当）+ テキスト 25 行。プラズマが回ります。\n\n![画面モード 3](https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/mode3.jpg)\n\nモード 3 は 256 色の FB + ローレゾ。テストアプリの `mode3.sgx` は、色の帯と低解像度のデモを出します。\n\n---\n\n## 遊べるもの\n\n![将棋](https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/shogi.jpg)\n\nmruby で書いた将棋（盤・持駒・読み）。ほかに jumps（横スクロールのゲーム）、ラスターバー、マンデルブロ、3D の網、タブレットの試験などが `samples/` と S: の `testapp` に入っています。\n\n![jumps](https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/jumps.jpg)\n\n---\n\n## 今回の見どころ\n\n- **表示の言語が 62**。2026-11-17 に欧州・EU の 34 言語を追加しました（`nn`・`rm` は保留）。日本語と英語以外はまだ機械翻訳です。\n- **IME**（日本語・English・한국어）。日本語の漢字変換の辞書は 8.8MB で S:（4MB）に入らないため、**USB メモリに置く別配布**です。\n- **圧縮と書庫**。gzip・zlib・bzip2・LZMA・xz、ZIP・7z・tar（.tar.gz / .tar.bz2 / .tar.xz）を、シェルとファイラーと 3 言語から。コピーレフトでない部品（miniz・libbzip2・LZMA SDK）だけで組んであります。\n- **音**。4 声のウェーブテーブル、SMF / SGT のシーケンサー、MP3 / OGG / WAV（96kHz / 24bit まで）、VGM / VGZ（YM2151・YM2612・C352 など）、音楽 CD の再生とスペクトログラム。\n\n![CD のスペクトログラム](https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/cd.jpg)\n\n![時計](https://raw.githubusercontent.com/antarcticlion/sgnano/master/images/clock.jpg)\n\n---\n\n## 動かすには\n\n### 必要なもの\n\n- **C ボード**（ガーバーと組み立てガイドはリポジトリにあります）と、WeAct Studio の RP2350B Core Board\n- PSRAM（ESP-PSRAM64H、8MB）\n- VGA モニタ（15kHz か 24kHz か 31kHz に対応するもの）\n- USB キーボード\n- 書き込み用に Raspberry Pi Pico / Pico 2（debugprobe ファームウェアを推奨）\n\n### 書き込み\n\n[Releases](https://github.com/antarcticlion/sgnano/releases/latest) から UF2 を落として、BOOTSEL で立ち上げた `RPI-RP2` へコピーします。\n\n| ファイル | 使うとき |\n|---|---|\n| `-full.uf2` | 初回・初期化（ファーム + S: + フォント） |\n| `-firmware.uf2` | ファームだけ更新（S: とフォントは残る） |\n| `-system-font.uf2` | S: とフォントを入れ直す（ファームは残る） |\n\n日本語の漢字変換を使うときは、`-ime-dict.zip` を展開して、USB メモリのルートに `SgnanoIME/` ごと置いてください。\n\n---\n\n## いまの制約（α版）\n\nα版なので、以下は承知のうえで遊んでください。\n\n- **ファームのソースは α1 に含みません**（後のリリースで MIT 公開の予定）。SDK・見本・Doom / wav2mp3 のソースは公開しています。\n- PSRAM は定格 133MHz を超える **151.2MHz** で動かしています。個体差・温度で不安定になる可能性があります。\n- 一覧で **`Shift+F1`〜`Shift+F12` が効きません**（文字のキー `D` `K` `H` などで代用）。次の版で直します。\n- MicroPython の見本のうち **`fontdemo.py` と `gfx.py` が実機で動きません**（`.rb` / `.bas` は動きます）。\n- リセット直後にごくまれに起動しないことがあります（GP0）。そのときはリセットし直してください。\n- 日本語・英語以外の 60 言語は機械翻訳のままです。翻訳の協力者を募集中です。\n\n詳しくは [既知の制約](https://github.com/antarcticlion/sgnano/blob/master/docs/KNOWN_LIMITATIONS.md) を見てください。\n\n---\n\n## 開発の話\n\n- 言語処理系は mruby・MicroPython・SG BASIC をソースから組み込み、`Machine` の API を 3 言語でそろえました。\n- RTOS は自前（M33BEATOS）。2 コアで描画とアプリを分けています。\n- 画面の描画は PIO で VGA のタイミングを作り、PSRAM のフレームバッファを DMA で流しています。\n- ホスト試験は 50 本、実機の起動試験は 92 本中 90 本、静的解析（cppcheck）は warning 0 まで片づけました。\n\n開発の記録は `docs/notes/` に、仕様は `docs/` にあります。読み物として **sgnano magazine** も書きました（第 1 号・第 2 号）。\n\n- \u003chttps://github.com/antarcticlion/sgnano/tree/master/docs/magazine\u003e\n\n---\n\n## リンク\n\n| | |\n|---|---|\n| リポジトリ | \u003chttps://github.com/antarcticlion/sgnano\u003e |\n| ダウンロード（α1） | \u003chttps://github.com/antarcticlion/sgnano/releases/latest\u003e |\n| sgnano magazine | \u003chttps://github.com/antarcticlion/sgnano/tree/master/docs/magazine\u003e |\n| 組み立てガイド（PDF） | \u003chttps://github.com/antarcticlion/sgnano/blob/master/hardware/c_board/ASSEMBLY.pdf\u003e |\n| フォント（EmbFont16） | \u003chttps://github.com/antarcticlion/EmbFont16\u003e |\n| PC 側のファイル管理 | \u003chttps://github.com/antarcticlion/sgnano_remote\u003e |\n\n不具合は Issues へ。ビルド ID（`alpha1-2026.11+g6913368`）・画面モード・つないでいる機器・再現の手順を書いてもらえると助かります。\n\nα版の間は、対応や修正の期限を約束できません。それでも、触ってみて「これは面白い」と思ってもらえたらうれしいです。\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T01:43:04+09:00","group":null,"id":"123ace0140de5444f9de","likes_count":1,"private":false,"reactions_count":0,"stocks_count":1,"tags":[{"name":"RP2350","versions":[]},{"name":"組み込み","versions":[]},{"name":"レトロPC","versions":[]},{"name":"mruby","versions":[]},{"name":"micropython","versions":[]}],"title":"RP2350B 1 チップで作る、オールドファッションなパソコン「sgnano」α版を公開しました","updated_at":"2026-11-18T01:43:04+09:00","url":"https://qiita.com/antarcticlion/items/123ace0140de5444f9de","user":{"description":"","facebook_id":"","followees_count":0,"followers_count":0,"github_login_name":null,"id":"antarcticlion","items_count":2,"linkedin_id":"","location":"地球","name":"南極 獅子","organization":"","permanent_id":216151,"profile_image_url":"https://qiita-image-store.s3.amazonaws.com/0/216151/profile-images/1551119055","team_only":false,"twitter_screen_name":"antarcticlion","website_url":""},"page_views_count":null,"team_membership":null,"organization_url_name":null,"slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003ch1 data-sourcepos=\"1:1-1:101\"\u003e\n\u003cspan id=\"opencvで画像内の不要な文字を消す方法inpaintingの仕組みと生成aiとの違い\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#opencv%E3%81%A7%E7%94%BB%E5%83%8F%E5%86%85%E3%81%AE%E4%B8%8D%E8%A6%81%E3%81%AA%E6%96%87%E5%AD%97%E3%82%92%E6%B6%88%E3%81%99%E6%96%B9%E6%B3%95inpainting%E3%81%AE%E4%BB%95%E7%B5%84%E3%81%BF%E3%81%A8%E7%94%9F%E6%88%90ai%E3%81%A8%E3%81%AE%E9%81%95%E3%81%84\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eOpenCVで画像内の不要な文字を消す方法：Inpaintingの仕組みと生成AIとの違い\u003c/h1\u003e\n\u003ch2 data-sourcepos=\"3:1-3:15\"\u003e\n\u003cspan id=\"はじめに\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eはじめに\u003c/h2\u003e\n\u003cp data-sourcepos=\"5:1-5:186\"\u003e画像を扱うアプリケーションを開発していると、写真やスクリーンショットに含まれる不要な文字や図形を取り除きたい場面があります。\u003c/p\u003e\n\u003cp data-sourcepos=\"7:1-7:45\"\u003e例えば、次のようなケースです。\u003c/p\u003e\n\u003cul data-sourcepos=\"9:1-13:0\"\u003e\n\u003cli data-sourcepos=\"9:1-9:83\"\u003e自分で撮影した写真に追加した日付やテキストを削除したい\u003c/li\u003e\n\u003cli data-sourcepos=\"10:1-10:91\"\u003eデザインのプレビュー画像に入れた「DRAFT」の文字を取り除きたい\u003c/li\u003e\n\u003cli data-sourcepos=\"11:1-11:62\"\u003e古い写真にある小さな傷や汚れを修復したい\u003c/li\u003e\n\u003cli data-sourcepos=\"12:1-13:0\"\u003e画像編集アプリにオブジェクト除去機能を実装したい\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"14:1-14:117\"\u003e単純に対象部分を背景色で塗りつぶすだけでは、不自然な四角形が残ってしまいます。\u003c/p\u003e\n\u003cp data-sourcepos=\"16:1-16:90\"\u003eそこで利用できるのが、\u003cstrong\u003eInpainting（画像修復）\u003c/strong\u003e という技術です。\u003c/p\u003e\n\u003cp data-sourcepos=\"18:1-18:180\"\u003e今回は Python と OpenCV を使って基本的な画像修復を実装し、さらに従来の Inpainting と生成AIによる画像修復の違いについて整理します。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"20:1-20:25\"\u003e\n\u003cspan id=\"1-inpaintingとは\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#1-inpainting%E3%81%A8%E3%81%AF\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e1. Inpaintingとは？\u003c/h2\u003e\n\u003cp data-sourcepos=\"22:1-22:106\"\u003eInpaintingとは、画像内の指定した領域を周囲の画素情報から補完する技術です。\u003c/p\u003e\n\u003cp data-sourcepos=\"24:1-24:156\"\u003e画像の一部が欠損している場合でも、周囲の色、境界、テクスチャなどを参考にして、自然な見た目に近づけます。\u003c/p\u003e\n\u003cp data-sourcepos=\"26:1-26:159\"\u003e例えば、青空の写真に小さな文字が重なっている場合、文字の周囲にある空の色を使って、その部分を補完できます。\u003c/p\u003e\n\u003cp data-sourcepos=\"28:1-28:106\"\u003eただし、Inpaintingは隠れていた元の画素を正確に復元する技術ではありません。\u003c/p\u003e\n\u003cp data-sourcepos=\"30:1-30:78\"\u003eあくまで、周囲の情報から欠損領域を推定する処理です。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"32:1-32:41\"\u003e\n\u003cspan id=\"opencvで利用できる2つの手法\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#opencv%E3%81%A7%E5%88%A9%E7%94%A8%E3%81%A7%E3%81%8D%E3%82%8B2%E3%81%A4%E3%81%AE%E6%89%8B%E6%B3%95\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eOpenCVで利用できる2つの手法\u003c/h3\u003e\n\u003cp data-sourcepos=\"34:1-34:102\"\u003eOpenCVの \u003ccode\u003ecv2.inpaint()\u003c/code\u003e には、代表的な2つのアルゴリズムが用意されています。\u003c/p\u003e\n\u003cp data-sourcepos=\"36:1-36:12\"\u003e\u003cstrong\u003eTELEA法\u003c/strong\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"38:1-38:50\"\u003eFast Marching Methodを利用する手法です。\u003c/p\u003e\n\u003cp data-sourcepos=\"40:1-40:111\"\u003e修復領域の境界から内部に向かって、周辺画素の情報を利用しながら補完します。\u003c/p\u003e\n\u003cp data-sourcepos=\"42:1-42:63\"\u003e比較的小さな傷や文字の除去に利用できます。\u003c/p\u003e\n\u003cp data-sourcepos=\"44:1-44:20\"\u003e\u003cstrong\u003eNavier-Stokes法\u003c/strong\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"46:1-46:117\"\u003e流体力学の考え方に基づき、画像内の方向や輝度の変化を考慮して補完する手法です。\u003c/p\u003e\n\u003cp data-sourcepos=\"48:1-48:57\"\u003eエッジの連続性を利用する点が特徴です。\u003c/p\u003e\n\u003cp data-sourcepos=\"50:1-50:147\"\u003eどちらが適しているかは画像の構造や修復領域によって異なるため、実際に比較してみるのがよさそうです。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"52:1-52:42\"\u003e\n\u003cspan id=\"2-pythonとopencvで実装してみる\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#2-python%E3%81%A8opencv%E3%81%A7%E5%AE%9F%E8%A3%85%E3%81%97%E3%81%A6%E3%81%BF%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e2. PythonとOpenCVで実装してみる\u003c/h2\u003e\n\u003cp data-sourcepos=\"54:1-54:66\"\u003eまず、必要なライブラリをインストールします。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"bash\" data-sourcepos=\"56:1-58:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003epip \u003cspan class=\"nb\"\u003einstall \u003c/span\u003eopencv-python numpy\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"60:1-60:51\"\u003e今回は以下のファイルを使用します。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"62:1-67:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003eimage-repair/\n├── sample.png\n├── mask.png\n└── inpaint.py\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"69:1-69:46\"\u003e\u003ccode\u003esample.png\u003c/code\u003e は修復対象の画像です。\u003c/p\u003e\n\u003cp data-sourcepos=\"71:1-71:74\"\u003e\u003ccode\u003emask.png\u003c/code\u003e は修復したい領域を指定するマスク画像です。\u003c/p\u003e\n\u003cp data-sourcepos=\"73:1-73:111\"\u003eマスクは元画像と同じサイズにし、修復したい部分を白、それ以外を黒にします。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"75:1-75:28\"\u003e\n\u003cspan id=\"マスク画像の準備\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%9E%E3%82%B9%E3%82%AF%E7%94%BB%E5%83%8F%E3%81%AE%E6%BA%96%E5%82%99\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eマスク画像の準備\u003c/h3\u003e\n\u003cp data-sourcepos=\"77:1-77:45\"\u003eマスクの考え方はシンプルです。\u003c/p\u003e\n\u003ctable data-sourcepos=\"79:1-82:38\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"79:1-79:16\"\u003e\n\u003cth data-sourcepos=\"79:2-79:6\"\u003e色\u003c/th\u003e\n\u003cth data-sourcepos=\"79:8-79:15\"\u003e意味\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"81:1-81:37\"\u003e\n\u003ctd data-sourcepos=\"81:2-81:15\"\u003e白（255）\u003c/td\u003e\n\u003ctd data-sourcepos=\"81:17-81:36\"\u003e修復する領域\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"82:1-82:38\"\u003e\n\u003ctd data-sourcepos=\"82:2-82:13\"\u003e黒（0）\u003c/td\u003e\n\u003ctd data-sourcepos=\"82:15-82:37\"\u003e変更しない領域\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"84:1-84:152\"\u003e例えば、写真の中央に「DRAFT」という文字を追加した場合、その文字部分だけを白く塗ったマスクを作成します。\u003c/p\u003e\n\u003cp data-sourcepos=\"86:1-86:82\"\u003ePhotoshopやGIMPなどの画像編集ソフトを使用しても構いません。\u003c/p\u003e\n\u003cp data-sourcepos=\"88:1-88:114\"\u003eここでは、動作確認用にPythonでサンプル画像とマスクを生成する方法も紹介します。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"python\" data-sourcepos=\"90:1-137:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"kn\"\u003eimport\u003c/span\u003e \u003cspan class=\"nn\"\u003ecv2\u003c/span\u003e\n\u003cspan class=\"kn\"\u003eimport\u003c/span\u003e \u003cspan class=\"nn\"\u003enumpy\u003c/span\u003e \u003cspan class=\"k\"\u003eas\u003c/span\u003e \u003cspan class=\"n\"\u003enp\u003c/span\u003e\n\n\u003cspan class=\"c1\"\u003e# 背景画像を作成\n\u003c/span\u003e\u003cspan class=\"n\"\u003eimg\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003enp\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003efull\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"mi\"\u003e360\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e640\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e3\u003c/span\u003e\u003cspan class=\"p\"\u003e),\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"mi\"\u003e230\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e215\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e185\u003c/span\u003e\u003cspan class=\"p\"\u003e),\u003c/span\u003e\n    \u003cspan class=\"n\"\u003edtype\u003c/span\u003e\u003cspan class=\"o\"\u003e=\u003c/span\u003e\u003cspan class=\"n\"\u003enp\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003euint8\u003c/span\u003e\n\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\n\u003cspan class=\"c1\"\u003e# 背景に図形を配置\n\u003c/span\u003e\u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003erectangle\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n    \u003cspan class=\"n\"\u003eimg\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"mi\"\u003e50\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e70\u003c/span\u003e\u003cspan class=\"p\"\u003e),\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"mi\"\u003e590\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e290\u003c/span\u003e\u003cspan class=\"p\"\u003e),\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"mi\"\u003e180\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e190\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e220\u003c/span\u003e\u003cspan class=\"p\"\u003e),\u003c/span\u003e \u003cspan class=\"o\"\u003e-\u003c/span\u003e\u003cspan class=\"mi\"\u003e1\u003c/span\u003e\n\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\n\u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003ecircle\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n    \u003cspan class=\"n\"\u003eimg\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"mi\"\u003e320\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e180\u003c/span\u003e\u003cspan class=\"p\"\u003e),\u003c/span\u003e \u003cspan class=\"mi\"\u003e90\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"mi\"\u003e120\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e165\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e100\u003c/span\u003e\u003cspan class=\"p\"\u003e),\u003c/span\u003e \u003cspan class=\"o\"\u003e-\u003c/span\u003e\u003cspan class=\"mi\"\u003e1\u003c/span\u003e\n\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\n\u003cspan class=\"c1\"\u003e# 文字の位置とフォント設定\n\u003c/span\u003e\u003cspan class=\"n\"\u003etext\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003eDRAFT\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\n\u003cspan class=\"n\"\u003eposition\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"mi\"\u003e115\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e200\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\u003cspan class=\"n\"\u003efont\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eFONT_HERSHEY_SIMPLEX\u003c/span\u003e\n\u003cspan class=\"n\"\u003efont_scale\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"mf\"\u003e2.6\u003c/span\u003e\n\u003cspan class=\"n\"\u003ethickness\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"mi\"\u003e7\u003c/span\u003e\n\n\u003cspan class=\"c1\"\u003e# 修復する領域をマスクとして保存\n\u003c/span\u003e\u003cspan class=\"n\"\u003emask\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003enp\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003ezeros\u003c/span\u003e\u003cspan class=\"p\"\u003e((\u003c/span\u003e\u003cspan class=\"mi\"\u003e360\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e640\u003c/span\u003e\u003cspan class=\"p\"\u003e),\u003c/span\u003e \u003cspan class=\"n\"\u003edtype\u003c/span\u003e\u003cspan class=\"o\"\u003e=\u003c/span\u003e\u003cspan class=\"n\"\u003enp\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003euint8\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\n\u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eputText\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n    \u003cspan class=\"n\"\u003emask\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003etext\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003eposition\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003efont\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"n\"\u003efont_scale\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e255\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003ethickness\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eLINE_AA\u003c/span\u003e\n\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\n\u003cspan class=\"c1\"\u003e# 元画像に文字を重ねる\n\u003c/span\u003e\u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eputText\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n    \u003cspan class=\"n\"\u003eimg\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003etext\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003eposition\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003efont\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"n\"\u003efont_scale\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"mi\"\u003e255\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e255\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e255\u003c/span\u003e\u003cspan class=\"p\"\u003e),\u003c/span\u003e\n    \u003cspan class=\"n\"\u003ethickness\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eLINE_AA\u003c/span\u003e\n\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\n\u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eimwrite\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003esample.png\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003eimg\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eimwrite\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003emask.png\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003emask\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"139:1-139:66\"\u003eこれでテスト用の画像とマスクを作成できます。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"141:1-141:23\"\u003e\n\u003cspan id=\"inpaintingの実装\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#inpainting%E3%81%AE%E5%AE%9F%E8%A3%85\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eInpaintingの実装\u003c/h3\u003e\n\u003cp data-sourcepos=\"143:1-143:44\"\u003e続いて \u003ccode\u003einpaint.py\u003c/code\u003e を作成します。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"python\" data-sourcepos=\"145:1-209:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e\u003cspan class=\"kn\"\u003eimport\u003c/span\u003e \u003cspan class=\"nn\"\u003eargparse\u003c/span\u003e\n\u003cspan class=\"kn\"\u003eimport\u003c/span\u003e \u003cspan class=\"nn\"\u003ecv2\u003c/span\u003e\n\u003cspan class=\"kn\"\u003eimport\u003c/span\u003e \u003cspan class=\"nn\"\u003enumpy\u003c/span\u003e \u003cspan class=\"k\"\u003eas\u003c/span\u003e \u003cspan class=\"n\"\u003enp\u003c/span\u003e\n\n\u003cspan class=\"n\"\u003eparser\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003eargparse\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nc\"\u003eArgumentParser\u003c/span\u003e\u003cspan class=\"p\"\u003e()\u003c/span\u003e\n\n\u003cspan class=\"n\"\u003eparser\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eadd_argument\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003e--input\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003edefault\u003c/span\u003e\u003cspan class=\"o\"\u003e=\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003esample.png\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\u003cspan class=\"n\"\u003eparser\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eadd_argument\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003e--mask\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003edefault\u003c/span\u003e\u003cspan class=\"o\"\u003e=\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003emask.png\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\u003cspan class=\"n\"\u003eparser\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eadd_argument\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003e--output\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003edefault\u003c/span\u003e\u003cspan class=\"o\"\u003e=\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003eresult.png\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\u003cspan class=\"n\"\u003eparser\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eadd_argument\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n    \u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003e--method\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"n\"\u003echoices\u003c/span\u003e\u003cspan class=\"o\"\u003e=\u003c/span\u003e\u003cspan class=\"p\"\u003e[\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003etelea\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003ens\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e],\u003c/span\u003e\n    \u003cspan class=\"n\"\u003edefault\u003c/span\u003e\u003cspan class=\"o\"\u003e=\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003etelea\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\n\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\u003cspan class=\"n\"\u003eparser\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eadd_argument\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003e--radius\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"nb\"\u003etype\u003c/span\u003e\u003cspan class=\"o\"\u003e=\u003c/span\u003e\u003cspan class=\"nb\"\u003efloat\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003edefault\u003c/span\u003e\u003cspan class=\"o\"\u003e=\u003c/span\u003e\u003cspan class=\"mf\"\u003e3.0\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\n\u003cspan class=\"n\"\u003eargs\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003eparser\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eparse_args\u003c/span\u003e\u003cspan class=\"p\"\u003e()\u003c/span\u003e\n\n\u003cspan class=\"c1\"\u003e# 画像を読み込む\n\u003c/span\u003e\u003cspan class=\"n\"\u003eimage\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eimread\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eargs\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003einput\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\u003cspan class=\"n\"\u003emask\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eimread\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eargs\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003emask\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eIMREAD_GRAYSCALE\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\n\u003cspan class=\"k\"\u003eif\u003c/span\u003e \u003cspan class=\"n\"\u003eimage\u003c/span\u003e \u003cspan class=\"ow\"\u003eis\u003c/span\u003e \u003cspan class=\"bp\"\u003eNone\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eraise\u003c/span\u003e \u003cspan class=\"ne\"\u003eFileNotFoundError\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003eInput image not found\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\n\u003cspan class=\"k\"\u003eif\u003c/span\u003e \u003cspan class=\"n\"\u003emask\u003c/span\u003e \u003cspan class=\"ow\"\u003eis\u003c/span\u003e \u003cspan class=\"bp\"\u003eNone\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eraise\u003c/span\u003e \u003cspan class=\"ne\"\u003eFileNotFoundError\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003eMask image not found\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\n\u003cspan class=\"k\"\u003eif\u003c/span\u003e \u003cspan class=\"n\"\u003eimage\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eshape\u003c/span\u003e\u003cspan class=\"p\"\u003e[:\u003c/span\u003e\u003cspan class=\"mi\"\u003e2\u003c/span\u003e\u003cspan class=\"p\"\u003e]\u003c/span\u003e \u003cspan class=\"o\"\u003e!=\u003c/span\u003e \u003cspan class=\"n\"\u003emask\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eshape\u003c/span\u003e\u003cspan class=\"p\"\u003e:\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eraise\u003c/span\u003e \u003cspan class=\"ne\"\u003eValueError\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003eImage and mask sizes must match\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\n\u003cspan class=\"c1\"\u003e# マスクを2値化する\n\u003c/span\u003e\u003cspan class=\"n\"\u003e_\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003emask\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003ethreshold\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n    \u003cspan class=\"n\"\u003emask\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e127\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e255\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eTHRESH_BINARY\u003c/span\u003e\n\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\n\u003cspan class=\"c1\"\u003e# 修復領域を少し広げる\n\u003c/span\u003e\u003cspan class=\"n\"\u003ekernel\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003enp\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eones\u003c/span\u003e\u003cspan class=\"p\"\u003e((\u003c/span\u003e\u003cspan class=\"mi\"\u003e3\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"mi\"\u003e3\u003c/span\u003e\u003cspan class=\"p\"\u003e),\u003c/span\u003e \u003cspan class=\"n\"\u003enp\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003euint8\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\n\u003cspan class=\"n\"\u003emask\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003edilate\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n    \u003cspan class=\"n\"\u003emask\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003ekernel\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003eiterations\u003c/span\u003e\u003cspan class=\"o\"\u003e=\u003c/span\u003e\u003cspan class=\"mi\"\u003e1\u003c/span\u003e\n\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\n\u003cspan class=\"c1\"\u003e# アルゴリズムの選択\n\u003c/span\u003e\u003cspan class=\"n\"\u003emethod\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"p\"\u003e(\u003c/span\u003e\n    \u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eINPAINT_TELEA\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eif\u003c/span\u003e \u003cspan class=\"n\"\u003eargs\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003emethod\u003c/span\u003e \u003cspan class=\"o\"\u003e==\u003c/span\u003e \u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003etelea\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eelse\u003c/span\u003e \u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eINPAINT_NS\u003c/span\u003e\n\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\n\u003cspan class=\"c1\"\u003e# 画像修復\n\u003c/span\u003e\u003cspan class=\"n\"\u003eresult\u003c/span\u003e \u003cspan class=\"o\"\u003e=\u003c/span\u003e \u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003einpaint\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\n    \u003cspan class=\"n\"\u003eimage\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"n\"\u003emask\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"n\"\u003eargs\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eradius\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e\n    \u003cspan class=\"n\"\u003emethod\u003c/span\u003e\n\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\n\u003cspan class=\"c1\"\u003e# 結果を保存\n\u003c/span\u003e\u003cspan class=\"k\"\u003eif\u003c/span\u003e \u003cspan class=\"ow\"\u003enot\u003c/span\u003e \u003cspan class=\"n\"\u003ecv2\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"nf\"\u003eimwrite\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"n\"\u003eargs\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eoutput\u003c/span\u003e\u003cspan class=\"p\"\u003e,\u003c/span\u003e \u003cspan class=\"n\"\u003eresult\u003c/span\u003e\u003cspan class=\"p\"\u003e):\u003c/span\u003e\n    \u003cspan class=\"k\"\u003eraise\u003c/span\u003e \u003cspan class=\"ne\"\u003eRuntimeError\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003eFailed to save output image\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\n\u003cspan class=\"k\"\u003eprint\u003c/span\u003e\u003cspan class=\"p\"\u003e(\u003c/span\u003e\u003cspan class=\"sa\"\u003ef\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"s\"\u003eSaved: \u003c/span\u003e\u003cspan class=\"si\"\u003e{\u003c/span\u003e\u003cspan class=\"n\"\u003eargs\u003c/span\u003e\u003cspan class=\"p\"\u003e.\u003c/span\u003e\u003cspan class=\"n\"\u003eoutput\u003c/span\u003e\u003cspan class=\"si\"\u003e}\u003c/span\u003e\u003cspan class=\"sh\"\u003e\"\u003c/span\u003e\u003cspan class=\"p\"\u003e)\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003ch3 data-sourcepos=\"211:1-211:16\"\u003e\n\u003cspan id=\"実行する\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%AE%9F%E8%A1%8C%E3%81%99%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e実行する\u003c/h3\u003e\n\u003cp data-sourcepos=\"213:1-213:32\"\u003eまずTELEA法を試します。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"bash\" data-sourcepos=\"215:1-217:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003epython inpaint.py \u003cspan class=\"nt\"\u003e--method\u003c/span\u003e telea \u003cspan class=\"nt\"\u003e--output\u003c/span\u003e result_telea.png\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"219:1-219:40\"\u003e次にNavier-Stokes法を試します。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"bash\" data-sourcepos=\"221:1-223:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003epython inpaint.py \u003cspan class=\"nt\"\u003e--method\u003c/span\u003e ns \u003cspan class=\"nt\"\u003e--output\u003c/span\u003e result_ns.png\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"225:1-225:100\"\u003e2種類の結果を比較することで、アルゴリズムによる違いを確認できます。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"227:1-227:51\"\u003e\n\u003cspan id=\"3-画像修復がうまくいかないケース\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#3-%E7%94%BB%E5%83%8F%E4%BF%AE%E5%BE%A9%E3%81%8C%E3%81%86%E3%81%BE%E3%81%8F%E3%81%84%E3%81%8B%E3%81%AA%E3%81%84%E3%82%B1%E3%83%BC%E3%82%B9\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e3. 画像修復がうまくいかないケース\u003c/h2\u003e\n\u003cp data-sourcepos=\"229:1-229:99\"\u003eここまでの方法で、比較的小さな文字や傷は修復できる場合があります。\u003c/p\u003e\n\u003cp data-sourcepos=\"231:1-231:102\"\u003eしかし、すべての画像に対して自然な結果を得られるわけではありません。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"233:1-233:62\"\u003e\n\u003cspan id=\"ケース1複雑な背景に文字が重なっている\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%B1%E3%83%BC%E3%82%B91%E8%A4%87%E9%9B%91%E3%81%AA%E8%83%8C%E6%99%AF%E3%81%AB%E6%96%87%E5%AD%97%E3%81%8C%E9%87%8D%E3%81%AA%E3%81%A3%E3%81%A6%E3%81%84%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eケース1：複雑な背景に文字が重なっている\u003c/h3\u003e\n\u003cp data-sourcepos=\"235:1-235:96\"\u003e例えば、建物の窓や木の枝の上に大きな文字が重なっている場合です。\u003c/p\u003e\n\u003cp data-sourcepos=\"237:1-237:105\"\u003e周囲の画素だけでは、隠れている構造を十分に推定できないことがあります。\u003c/p\u003e\n\u003cp data-sourcepos=\"239:1-239:90\"\u003e結果として、直線が途切れたり、テクスチャがぼやけたりします。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"241:1-241:53\"\u003e\n\u003cspan id=\"ケース2除去する領域が大きすぎる\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%B1%E3%83%BC%E3%82%B92%E9%99%A4%E5%8E%BB%E3%81%99%E3%82%8B%E9%A0%98%E5%9F%9F%E3%81%8C%E5%A4%A7%E3%81%8D%E3%81%99%E3%81%8E%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eケース2：除去する領域が大きすぎる\u003c/h3\u003e\n\u003cp data-sourcepos=\"243:1-243:55\"\u003eInpaintingでは周辺画素の情報が重要です。\u003c/p\u003e\n\u003cp data-sourcepos=\"245:1-245:90\"\u003e修復する範囲が広くなるほど、中央部分の推定が難しくなります。\u003c/p\u003e\n\u003cp data-sourcepos=\"247:1-247:117\"\u003e特に画像の大部分が文字や図形で覆われている場合、従来の手法には限界があります。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"249:1-249:47\"\u003e\n\u003cspan id=\"ケース3マスクが正確ではない\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%B1%E3%83%BC%E3%82%B93%E3%83%9E%E3%82%B9%E3%82%AF%E3%81%8C%E6%AD%A3%E7%A2%BA%E3%81%A7%E3%81%AF%E3%81%AA%E3%81%84\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eケース3：マスクが正確ではない\u003c/h3\u003e\n\u003cp data-sourcepos=\"251:1-251:114\"\u003e文字の輪郭を十分に覆えていないと、処理後も文字の一部が残る可能性があります。\u003c/p\u003e\n\u003cp data-sourcepos=\"253:1-253:117\"\u003e逆にマスクを広げすぎると、本来残したかった画像まで修復対象になってしまいます。\u003c/p\u003e\n\u003cp data-sourcepos=\"255:1-255:160\"\u003e先ほどのコードでは \u003ccode\u003ecv2.dilate()\u003c/code\u003e を使ってマスクを少し拡張していますが、必要に応じて調整したほうがよいでしょう。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"257:1-257:47\"\u003e\n\u003cspan id=\"4-生成aiによる画像修復との違い\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#4-%E7%94%9F%E6%88%90ai%E3%81%AB%E3%82%88%E3%82%8B%E7%94%BB%E5%83%8F%E4%BF%AE%E5%BE%A9%E3%81%A8%E3%81%AE%E9%81%95%E3%81%84\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e4. 生成AIによる画像修復との違い\u003c/h2\u003e\n\u003cp data-sourcepos=\"259:1-259:104\"\u003e最近は、生成AIを利用して画像の不要な領域を修復する方法も増えています。\u003c/p\u003e\n\u003cp data-sourcepos=\"261:1-261:105\"\u003e従来のInpaintingと生成AIによる画像修復では、補完の考え方に違いがあります。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"263:1-263:23\"\u003e\n\u003cspan id=\"従来のinpainting\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%BE%93%E6%9D%A5%E3%81%AEinpainting\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e従来のInpainting\u003c/h3\u003e\n\u003cp data-sourcepos=\"265:1-265:87\"\u003e周辺の画素情報を中心に利用して、欠損した領域を補完します。\u003c/p\u003e\n\u003cp data-sourcepos=\"267:1-267:81\"\u003e背景が単純で修復範囲が小さい場合に扱いやすい方法です。\u003c/p\u003e\n\u003cp data-sourcepos=\"269:1-269:141\"\u003eまた、OpenCVであればローカル環境で処理できるため、画像を外部にアップロードする必要がありません。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"271:1-271:31\"\u003e\n\u003cspan id=\"生成aiによるinpainting\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E7%94%9F%E6%88%90ai%E3%81%AB%E3%82%88%E3%82%8Binpainting\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e生成AIによるInpainting\u003c/h3\u003e\n\u003cp data-sourcepos=\"273:1-273:134\"\u003e生成AIを使う場合は、周辺の画素だけでなく、モデルが学習した画像の特徴も利用して補完します。\u003c/p\u003e\n\u003cp data-sourcepos=\"275:1-275:141\"\u003e例えば、建物の一部が隠れている場合、その周囲の構造から窓や壁などの形状を推定して生成できます。\u003c/p\u003e\n\u003cp data-sourcepos=\"277:1-277:87\"\u003eただし、生成された内容が元画像と一致する保証はありません。\u003c/p\u003e\n\u003cp data-sourcepos=\"279:1-279:105\"\u003e人の顔、商品の文字、細かな模様などが変更されてしまう可能性もあります。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"281:1-281:26\"\u003e\n\u003cspan id=\"2つの方法を比較\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#2%E3%81%A4%E3%81%AE%E6%96%B9%E6%B3%95%E3%82%92%E6%AF%94%E8%BC%83\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e2つの方法を比較\u003c/h3\u003e\n\u003ctable data-sourcepos=\"283:1-290:115\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"283:1-283:36\"\u003e\n\u003cth data-sourcepos=\"283:2-283:15\"\u003e比較項目\u003c/th\u003e\n\u003cth data-sourcepos=\"283:17-283:24\"\u003eOpenCV\u003c/th\u003e\n\u003cth data-sourcepos=\"283:26-283:35\"\u003e生成AI\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"285:1-285:103\"\u003e\n\u003ctd data-sourcepos=\"285:2-285:24\"\u003e基本的な仕組み\u003c/td\u003e\n\u003ctd data-sourcepos=\"285:26-285:54\"\u003e周辺画素による補完\u003c/td\u003e\n\u003ctd data-sourcepos=\"285:56-285:102\"\u003e学習済みモデルによる生成・補完\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"286:1-286:67\"\u003e\n\u003ctd data-sourcepos=\"286:2-286:24\"\u003e小さな傷の修復\u003c/td\u003e\n\u003ctd data-sourcepos=\"286:26-286:51\"\u003e得意な場合が多い\u003c/td\u003e\n\u003ctd data-sourcepos=\"286:53-286:66\"\u003e対応可能\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"287:1-287:88\"\u003e\n\u003ctd data-sourcepos=\"287:2-287:18\"\u003e複雑な背景\u003c/td\u003e\n\u003ctd data-sourcepos=\"287:20-287:45\"\u003e苦手な場合がある\u003c/td\u003e\n\u003ctd data-sourcepos=\"287:47-287:87\"\u003e自然に補完できる場合がある\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"288:1-288:73\"\u003e\n\u003ctd data-sourcepos=\"288:2-288:18\"\u003eマスク指定\u003c/td\u003e\n\u003ctd data-sourcepos=\"288:20-288:39\"\u003e基本的に必要\u003c/td\u003e\n\u003ctd data-sourcepos=\"288:41-288:72\"\u003eツールによって異なる\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"289:1-289:82\"\u003e\n\u003ctd data-sourcepos=\"289:2-289:15\"\u003e実行環境\u003c/td\u003e\n\u003ctd data-sourcepos=\"289:17-289:45\"\u003eローカルで実行可能\u003c/td\u003e\n\u003ctd data-sourcepos=\"289:47-289:81\"\u003eローカルまたはクラウド\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"290:1-290:115\"\u003e\n\u003ctd data-sourcepos=\"290:2-290:24\"\u003e元の細部の保持\u003c/td\u003e\n\u003ctd data-sourcepos=\"290:26-290:57\"\u003e修復領域は推定される\u003c/td\u003e\n\u003ctd data-sourcepos=\"290:59-290:114\"\u003e存在しない細部が生成されることがある\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"292:1-292:71\"\u003e生成AIのほうが常に優れているわけではありません。\u003c/p\u003e\n\u003cp data-sourcepos=\"294:1-294:164\"\u003e単純な修復ならOpenCVで十分なケースもありますし、複雑な画像であっても生成AIが必ず正確な結果を返すとは限りません。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"296:1-296:75\"\u003e\n\u003cspan id=\"5-実際の画像編集ワークフローではどう使い分ける\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#5-%E5%AE%9F%E9%9A%9B%E3%81%AE%E7%94%BB%E5%83%8F%E7%B7%A8%E9%9B%86%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%81%A7%E3%81%AF%E3%81%A9%E3%81%86%E4%BD%BF%E3%81%84%E5%88%86%E3%81%91%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e5. 実際の画像編集ワークフローではどう使い分ける？\u003c/h2\u003e\n\u003cp data-sourcepos=\"298:1-298:120\"\u003e個人的には、修復したい画像の状態によって手法を分けるのが合理的だと考えています。\u003c/p\u003e\n\u003cp data-sourcepos=\"300:1-300:34\"\u003e\u003cstrong\u003e小さな文字や傷の場合\u003c/strong\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"302:1-302:115\"\u003e修復領域が小さく、背景が単純であれば、まずOpenCVのInpaintingを試す方法があります。\u003c/p\u003e\n\u003cp data-sourcepos=\"304:1-304:108\"\u003eマスクを細かく調整できるため、どの部分を変更するのかも管理しやすいです。\u003c/p\u003e\n\u003cp data-sourcepos=\"306:1-306:28\"\u003e\u003cstrong\u003e複雑な背景の場合\u003c/strong\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"308:1-308:95\"\u003e背景の構造が複雑な場合は、生成AIを使った補完も選択肢になります。\u003c/p\u003e\n\u003cp data-sourcepos=\"310:1-310:268\"\u003e最近はブラウザ上で画像を処理できるサービスもあり、例えば \u003ca href=\"https://watermarkremoverai.io/\" rel=\"nofollow noopener\" target=\"_blank\"\u003eWatermark Remover AI\u003c/a\u003eのように、画像内の重なった文字やロゴを検出し、背景の再構成を試みるWebツールもあります。\u003c/p\u003e\n\u003cp data-sourcepos=\"312:1-312:231\"\u003eただし、こうしたオンラインサービスを利用する場合は、画像が外部サーバーに送信されることや、処理結果が必ずしも元の画像情報を再現しないことに注意が必要です。\u003c/p\u003e\n\u003cp data-sourcepos=\"314:1-314:108\"\u003eまた、画像内の重要な情報を変更する用途では、修復後の確認が欠かせません。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"316:1-316:54\"\u003e\n\u003cspan id=\"6-修復結果を確認するときのポイント\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#6-%E4%BF%AE%E5%BE%A9%E7%B5%90%E6%9E%9C%E3%82%92%E7%A2%BA%E8%AA%8D%E3%81%99%E3%82%8B%E3%81%A8%E3%81%8D%E3%81%AE%E3%83%9D%E3%82%A4%E3%83%B3%E3%83%88\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e6. 修復結果を確認するときのポイント\u003c/h2\u003e\n\u003cp data-sourcepos=\"318:1-318:117\"\u003e画像編集の処理が完了しても、それだけで成功と判断するのは難しい場合があります。\u003c/p\u003e\n\u003cp data-sourcepos=\"320:1-320:78\"\u003e特に、次の点を確認すると問題を発見しやすくなります。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"322:1-322:44\"\u003e\n\u003cspan id=\"-境界部分に違和感がないか\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#-%E5%A2%83%E7%95%8C%E9%83%A8%E5%88%86%E3%81%AB%E9%81%95%E5%92%8C%E6%84%9F%E3%81%8C%E3%81%AA%E3%81%84%E3%81%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e① 境界部分に違和感がないか\u003c/h3\u003e\n\u003cp data-sourcepos=\"324:1-324:120\"\u003e修復した領域と周囲の画像との境界に、不自然なぼかしや色の変化がないか確認します。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"326:1-326:56\"\u003e\n\u003cspan id=\"-テクスチャが繰り返されていないか\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#-%E3%83%86%E3%82%AF%E3%82%B9%E3%83%81%E3%83%A3%E3%81%8C%E7%B9%B0%E3%82%8A%E8%BF%94%E3%81%95%E3%82%8C%E3%81%A6%E3%81%84%E3%81%AA%E3%81%84%E3%81%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e② テクスチャが繰り返されていないか\u003c/h3\u003e\n\u003cp data-sourcepos=\"328:1-328:120\"\u003e背景に規則的な模様がある場合、補完結果に不自然なパターンが現れることがあります。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"330:1-330:53\"\u003e\n\u003cspan id=\"-本来の文字が変更されていないか\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#-%E6%9C%AC%E6%9D%A5%E3%81%AE%E6%96%87%E5%AD%97%E3%81%8C%E5%A4%89%E6%9B%B4%E3%81%95%E3%82%8C%E3%81%A6%E3%81%84%E3%81%AA%E3%81%84%E3%81%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e③ 本来の文字が変更されていないか\u003c/h3\u003e\n\u003cp data-sourcepos=\"332:1-332:150\"\u003e看板、商品ラベル、建物の案内表示など、元画像に含まれていた文字が誤って変更されていないか確認します。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"334:1-334:59\"\u003e\n\u003cspan id=\"-意図しない部分が変更されていないか\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#-%E6%84%8F%E5%9B%B3%E3%81%97%E3%81%AA%E3%81%84%E9%83%A8%E5%88%86%E3%81%8C%E5%A4%89%E6%9B%B4%E3%81%95%E3%82%8C%E3%81%A6%E3%81%84%E3%81%AA%E3%81%84%E3%81%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e④ 意図しない部分が変更されていないか\u003c/h3\u003e\n\u003cp data-sourcepos=\"336:1-336:125\"\u003e生成AIを利用した場合は、修復対象以外の領域についても元画像と比較しておくと安心です。\u003c/p\u003e\n\u003cp data-sourcepos=\"338:1-338:144\"\u003e特に商品写真や記録用途の画像では、見た目が自然であることと、情報が正確であることは別の問題です。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"340:1-340:51\"\u003e\n\u003cspan id=\"7-注意点画像の利用権限について\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#7-%E6%B3%A8%E6%84%8F%E7%82%B9%E7%94%BB%E5%83%8F%E3%81%AE%E5%88%A9%E7%94%A8%E6%A8%A9%E9%99%90%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e7. 注意点：画像の利用権限について\u003c/h2\u003e\n\u003cp data-sourcepos=\"342:1-342:105\"\u003e画像の修復技術は便利ですが、利用する画像の権利関係には注意が必要です。\u003c/p\u003e\n\u003cp data-sourcepos=\"344:1-344:240\"\u003e自分で作成した画像の不要な文字を消したり、許可を得た画像を修復したりする用途と、第三者の著作物に付けられた権利表示を無断で削除する行為は区別する必要があります。\u003c/p\u003e\n\u003cp data-sourcepos=\"346:1-346:147\"\u003e権利者が提供する元画像や正規のライセンス済み素材を利用できる場合は、そちらを優先するのが適切です。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"348:1-348:12\"\u003e\n\u003cspan id=\"まとめ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%BE%E3%81%A8%E3%82%81\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eまとめ\u003c/h2\u003e\n\u003cp data-sourcepos=\"350:1-350:129\"\u003e今回はOpenCVを使った画像修復の基本的な実装と、生成AIによるInpaintingとの違いを整理しました。\u003c/p\u003e\n\u003cp data-sourcepos=\"352:1-352:39\"\u003eポイントは次のとおりです。\u003c/p\u003e\n\u003cul data-sourcepos=\"354:1-359:0\"\u003e\n\u003cli data-sourcepos=\"354:1-354:82\"\u003eOpenCVの \u003ccode\u003ecv2.inpaint()\u003c/code\u003e では、TELEA法とNavier-Stokes法を利用できる\u003c/li\u003e\n\u003cli data-sourcepos=\"355:1-355:81\"\u003e従来のInpaintingは、周辺画素を利用して修復領域を補完する\u003c/li\u003e\n\u003cli data-sourcepos=\"356:1-356:113\"\u003e複雑な背景や大きな欠損領域では、従来の手法では不自然な結果になることがある\u003c/li\u003e\n\u003cli data-sourcepos=\"357:1-357:124\"\u003e生成AIは複雑な構造を補完できる可能性がある一方、存在しない細部を生成することもある\u003c/li\u003e\n\u003cli data-sourcepos=\"358:1-359:0\"\u003e修復結果は見た目だけでなく、元画像との整合性も確認する必要がある\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"360:1-360:134\"\u003e画像修復は単純な「削除」処理ではなく、\u003cstrong\u003e失われた領域に何を描くべきかを推定する問題\u003c/strong\u003e です。\u003c/p\u003e\n\u003cp data-sourcepos=\"362:1-362:185\"\u003eOpenCVのような従来の画像処理技術と、生成AIのアプローチを理解しておくことで、目的に応じた適切な方法を選びやすくなると思います。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"364:1-364:15\"\u003e\n\u003cspan id=\"参考資料\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%8F%82%E8%80%83%E8%B3%87%E6%96%99\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e参考資料\u003c/h2\u003e\n\u003cul data-sourcepos=\"366:1-367:46\"\u003e\n\u003cli data-sourcepos=\"366:1-366:117\"\u003e\u003ca href=\"https://docs.opencv.org/4.x/df/d3d/tutorial_py_inpainting.html\" rel=\"nofollow noopener\" target=\"_blank\"\u003eOpenCV公式ドキュメント：Image Inpainting\u003c/a\u003e\u003c/li\u003e\n\u003cli data-sourcepos=\"367:1-367:46\"\u003e\u003ca href=\"https://opencv.org/\" rel=\"nofollow noopener\" target=\"_blank\"\u003eOpenCV公式サイト\u003c/a\u003e\u003c/li\u003e\n\u003c/ul\u003e\n","body":"# OpenCVで画像内の不要な文字を消す方法：Inpaintingの仕組みと生成AIとの違い\n\n## はじめに\n\n画像を扱うアプリケーションを開発していると、写真やスクリーンショットに含まれる不要な文字や図形を取り除きたい場面があります。\n\n例えば、次のようなケースです。\n\n- 自分で撮影した写真に追加した日付やテキストを削除したい\n- デザインのプレビュー画像に入れた「DRAFT」の文字を取り除きたい\n- 古い写真にある小さな傷や汚れを修復したい\n- 画像編集アプリにオブジェクト除去機能を実装したい\n\n単純に対象部分を背景色で塗りつぶすだけでは、不自然な四角形が残ってしまいます。\n\nそこで利用できるのが、**Inpainting（画像修復）** という技術です。\n\n今回は Python と OpenCV を使って基本的な画像修復を実装し、さらに従来の Inpainting と生成AIによる画像修復の違いについて整理します。\n\n## 1. Inpaintingとは？\n\nInpaintingとは、画像内の指定した領域を周囲の画素情報から補完する技術です。\n\n画像の一部が欠損している場合でも、周囲の色、境界、テクスチャなどを参考にして、自然な見た目に近づけます。\n\n例えば、青空の写真に小さな文字が重なっている場合、文字の周囲にある空の色を使って、その部分を補完できます。\n\nただし、Inpaintingは隠れていた元の画素を正確に復元する技術ではありません。\n\nあくまで、周囲の情報から欠損領域を推定する処理です。\n\n### OpenCVで利用できる2つの手法\n\nOpenCVの `cv2.inpaint()` には、代表的な2つのアルゴリズムが用意されています。\n\n**TELEA法**\n\nFast Marching Methodを利用する手法です。\n\n修復領域の境界から内部に向かって、周辺画素の情報を利用しながら補完します。\n\n比較的小さな傷や文字の除去に利用できます。\n\n**Navier-Stokes法**\n\n流体力学の考え方に基づき、画像内の方向や輝度の変化を考慮して補完する手法です。\n\nエッジの連続性を利用する点が特徴です。\n\nどちらが適しているかは画像の構造や修復領域によって異なるため、実際に比較してみるのがよさそうです。\n\n## 2. PythonとOpenCVで実装してみる\n\nまず、必要なライブラリをインストールします。\n\n```bash\npip install opencv-python numpy\n```\n\n今回は以下のファイルを使用します。\n\n```text\nimage-repair/\n├── sample.png\n├── mask.png\n└── inpaint.py\n```\n\n`sample.png` は修復対象の画像です。\n\n`mask.png` は修復したい領域を指定するマスク画像です。\n\nマスクは元画像と同じサイズにし、修復したい部分を白、それ以外を黒にします。\n\n### マスク画像の準備\n\nマスクの考え方はシンプルです。\n\n| 色 | 意味 |\n|---|---|\n| 白（255） | 修復する領域 |\n| 黒（0） | 変更しない領域 |\n\n例えば、写真の中央に「DRAFT」という文字を追加した場合、その文字部分だけを白く塗ったマスクを作成します。\n\nPhotoshopやGIMPなどの画像編集ソフトを使用しても構いません。\n\nここでは、動作確認用にPythonでサンプル画像とマスクを生成する方法も紹介します。\n\n```python\nimport cv2\nimport numpy as np\n\n# 背景画像を作成\nimg = np.full(\n    (360, 640, 3),\n    (230, 215, 185),\n    dtype=np.uint8\n)\n\n# 背景に図形を配置\ncv2.rectangle(\n    img, (50, 70), (590, 290),\n    (180, 190, 220), -1\n)\n\ncv2.circle(\n    img, (320, 180), 90,\n    (120, 165, 100), -1\n)\n\n# 文字の位置とフォント設定\ntext = \"DRAFT\"\nposition = (115, 200)\nfont = cv2.FONT_HERSHEY_SIMPLEX\nfont_scale = 2.6\nthickness = 7\n\n# 修復する領域をマスクとして保存\nmask = np.zeros((360, 640), dtype=np.uint8)\n\ncv2.putText(\n    mask, text, position, font,\n    font_scale, 255, thickness,\n    cv2.LINE_AA\n)\n\n# 元画像に文字を重ねる\ncv2.putText(\n    img, text, position, font,\n    font_scale, (255, 255, 255),\n    thickness, cv2.LINE_AA\n)\n\ncv2.imwrite(\"sample.png\", img)\ncv2.imwrite(\"mask.png\", mask)\n```\n\nこれでテスト用の画像とマスクを作成できます。\n\n### Inpaintingの実装\n\n続いて `inpaint.py` を作成します。\n\n```python\nimport argparse\nimport cv2\nimport numpy as np\n\nparser = argparse.ArgumentParser()\n\nparser.add_argument(\"--input\", default=\"sample.png\")\nparser.add_argument(\"--mask\", default=\"mask.png\")\nparser.add_argument(\"--output\", default=\"result.png\")\nparser.add_argument(\n    \"--method\",\n    choices=[\"telea\", \"ns\"],\n    default=\"telea\"\n)\nparser.add_argument(\"--radius\", type=float, default=3.0)\n\nargs = parser.parse_args()\n\n# 画像を読み込む\nimage = cv2.imread(args.input)\nmask = cv2.imread(args.mask, cv2.IMREAD_GRAYSCALE)\n\nif image is None:\n    raise FileNotFoundError(\"Input image not found\")\n\nif mask is None:\n    raise FileNotFoundError(\"Mask image not found\")\n\nif image.shape[:2] != mask.shape:\n    raise ValueError(\"Image and mask sizes must match\")\n\n# マスクを2値化する\n_, mask = cv2.threshold(\n    mask, 127, 255, cv2.THRESH_BINARY\n)\n\n# 修復領域を少し広げる\nkernel = np.ones((3, 3), np.uint8)\n\nmask = cv2.dilate(\n    mask, kernel, iterations=1\n)\n\n# アルゴリズムの選択\nmethod = (\n    cv2.INPAINT_TELEA\n    if args.method == \"telea\"\n    else cv2.INPAINT_NS\n)\n\n# 画像修復\nresult = cv2.inpaint(\n    image,\n    mask,\n    args.radius,\n    method\n)\n\n# 結果を保存\nif not cv2.imwrite(args.output, result):\n    raise RuntimeError(\"Failed to save output image\")\n\nprint(f\"Saved: {args.output}\")\n```\n\n### 実行する\n\nまずTELEA法を試します。\n\n```bash\npython inpaint.py --method telea --output result_telea.png\n```\n\n次にNavier-Stokes法を試します。\n\n```bash\npython inpaint.py --method ns --output result_ns.png\n```\n\n2種類の結果を比較することで、アルゴリズムによる違いを確認できます。\n\n## 3. 画像修復がうまくいかないケース\n\nここまでの方法で、比較的小さな文字や傷は修復できる場合があります。\n\nしかし、すべての画像に対して自然な結果を得られるわけではありません。\n\n### ケース1：複雑な背景に文字が重なっている\n\n例えば、建物の窓や木の枝の上に大きな文字が重なっている場合です。\n\n周囲の画素だけでは、隠れている構造を十分に推定できないことがあります。\n\n結果として、直線が途切れたり、テクスチャがぼやけたりします。\n\n### ケース2：除去する領域が大きすぎる\n\nInpaintingでは周辺画素の情報が重要です。\n\n修復する範囲が広くなるほど、中央部分の推定が難しくなります。\n\n特に画像の大部分が文字や図形で覆われている場合、従来の手法には限界があります。\n\n### ケース3：マスクが正確ではない\n\n文字の輪郭を十分に覆えていないと、処理後も文字の一部が残る可能性があります。\n\n逆にマスクを広げすぎると、本来残したかった画像まで修復対象になってしまいます。\n\n先ほどのコードでは `cv2.dilate()` を使ってマスクを少し拡張していますが、必要に応じて調整したほうがよいでしょう。\n\n## 4. 生成AIによる画像修復との違い\n\n最近は、生成AIを利用して画像の不要な領域を修復する方法も増えています。\n\n従来のInpaintingと生成AIによる画像修復では、補完の考え方に違いがあります。\n\n### 従来のInpainting\n\n周辺の画素情報を中心に利用して、欠損した領域を補完します。\n\n背景が単純で修復範囲が小さい場合に扱いやすい方法です。\n\nまた、OpenCVであればローカル環境で処理できるため、画像を外部にアップロードする必要がありません。\n\n### 生成AIによるInpainting\n\n生成AIを使う場合は、周辺の画素だけでなく、モデルが学習した画像の特徴も利用して補完します。\n\n例えば、建物の一部が隠れている場合、その周囲の構造から窓や壁などの形状を推定して生成できます。\n\nただし、生成された内容が元画像と一致する保証はありません。\n\n人の顔、商品の文字、細かな模様などが変更されてしまう可能性もあります。\n\n### 2つの方法を比較\n\n| 比較項目 | OpenCV | 生成AI |\n|---|---|---|\n| 基本的な仕組み | 周辺画素による補完 | 学習済みモデルによる生成・補完 |\n| 小さな傷の修復 | 得意な場合が多い | 対応可能 |\n| 複雑な背景 | 苦手な場合がある | 自然に補完できる場合がある |\n| マスク指定 | 基本的に必要 | ツールによって異なる |\n| 実行環境 | ローカルで実行可能 | ローカルまたはクラウド |\n| 元の細部の保持 | 修復領域は推定される | 存在しない細部が生成されることがある |\n\n生成AIのほうが常に優れているわけではありません。\n\n単純な修復ならOpenCVで十分なケースもありますし、複雑な画像であっても生成AIが必ず正確な結果を返すとは限りません。\n\n## 5. 実際の画像編集ワークフローではどう使い分ける？\n\n個人的には、修復したい画像の状態によって手法を分けるのが合理的だと考えています。\n\n**小さな文字や傷の場合**\n\n修復領域が小さく、背景が単純であれば、まずOpenCVのInpaintingを試す方法があります。\n\nマスクを細かく調整できるため、どの部分を変更するのかも管理しやすいです。\n\n**複雑な背景の場合**\n\n背景の構造が複雑な場合は、生成AIを使った補完も選択肢になります。\n\n最近はブラウザ上で画像を処理できるサービスもあり、例えば [Watermark Remover AI](https://watermarkremoverai.io/)のように、画像内の重なった文字やロゴを検出し、背景の再構成を試みるWebツールもあります。\n\nただし、こうしたオンラインサービスを利用する場合は、画像が外部サーバーに送信されることや、処理結果が必ずしも元の画像情報を再現しないことに注意が必要です。\n\nまた、画像内の重要な情報を変更する用途では、修復後の確認が欠かせません。\n\n## 6. 修復結果を確認するときのポイント\n\n画像編集の処理が完了しても、それだけで成功と判断するのは難しい場合があります。\n\n特に、次の点を確認すると問題を発見しやすくなります。\n\n### ① 境界部分に違和感がないか\n\n修復した領域と周囲の画像との境界に、不自然なぼかしや色の変化がないか確認します。\n\n### ② テクスチャが繰り返されていないか\n\n背景に規則的な模様がある場合、補完結果に不自然なパターンが現れることがあります。\n\n### ③ 本来の文字が変更されていないか\n\n看板、商品ラベル、建物の案内表示など、元画像に含まれていた文字が誤って変更されていないか確認します。\n\n### ④ 意図しない部分が変更されていないか\n\n生成AIを利用した場合は、修復対象以外の領域についても元画像と比較しておくと安心です。\n\n特に商品写真や記録用途の画像では、見た目が自然であることと、情報が正確であることは別の問題です。\n\n## 7. 注意点：画像の利用権限について\n\n画像の修復技術は便利ですが、利用する画像の権利関係には注意が必要です。\n\n自分で作成した画像の不要な文字を消したり、許可を得た画像を修復したりする用途と、第三者の著作物に付けられた権利表示を無断で削除する行為は区別する必要があります。\n\n権利者が提供する元画像や正規のライセンス済み素材を利用できる場合は、そちらを優先するのが適切です。\n\n## まとめ\n\n今回はOpenCVを使った画像修復の基本的な実装と、生成AIによるInpaintingとの違いを整理しました。\n\nポイントは次のとおりです。\n\n- OpenCVの `cv2.inpaint()` では、TELEA法とNavier-Stokes法を利用できる\n- 従来のInpaintingは、周辺画素を利用して修復領域を補完する\n- 複雑な背景や大きな欠損領域では、従来の手法では不自然な結果になることがある\n- 生成AIは複雑な構造を補完できる可能性がある一方、存在しない細部を生成することもある\n- 修復結果は見た目だけでなく、元画像との整合性も確認する必要がある\n\n画像修復は単純な「削除」処理ではなく、**失われた領域に何を描くべきかを推定する問題** です。\n\nOpenCVのような従来の画像処理技術と、生成AIのアプローチを理解しておくことで、目的に応じた適切な方法を選びやすくなると思います。\n\n## 参考資料\n\n- [OpenCV公式ドキュメント：Image Inpainting](https://docs.opencv.org/4.x/df/d3d/tutorial_py_inpainting.html)\n- [OpenCV公式サイト](https://opencv.org/)\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T01:38:03+09:00","group":null,"id":"54cac5b6c7df5f02dfad","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"Python","versions":[]},{"name":"OpenCV","versions":[]},{"name":"画像処理","versions":[]},{"name":"生成AI","versions":[]},{"name":"inpainting","versions":[]}],"title":"OpenCVで画像内の不要な文字を消す方法：Inpaintingの仕組みと生成AIとの違い","updated_at":"2026-11-18T01:38:03+09:00","url":"https://qiita.com/watermover/items/54cac5b6c7df5f02dfad","user":{"description":null,"facebook_id":null,"followees_count":0,"followers_count":0,"github_login_name":null,"id":"watermover","items_count":1,"linkedin_id":null,"location":null,"name":"","organization":null,"permanent_id":4534197,"profile_image_url":"https://secure.gravatar.com/avatar/f3b0202c6b927bbd8c97282aef2b5ce2","team_only":false,"twitter_screen_name":null,"website_url":null},"page_views_count":null,"team_membership":null,"organization_url_name":null,"slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003cp data-sourcepos=\"1:1-1:307\"\u003eA lifi bridge transfer takes you from a connected wallet through route selection, approval, and sending, then ends when the destination transaction completes. The route may use a bridge and a decentralized exchange, but your wallet signs the required transactions and the transfer settles across two chains.\u003c/p\u003e\n\u003ch2 data-sourcepos=\"3:1-3:39\"\u003e\n\u003cspan id=\"prepare-your-wallet-for-the-transfer\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#prepare-your-wallet-for-the-transfer\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003ePrepare Your Wallet for the Transfer\u003c/h2\u003e\n\u003cp data-sourcepos=\"5:1-5:271\"\u003eA LI.FI cross-chain bridge transfer needs an EVM wallet with tokens and native gas on the source chain. Native gas means the source chain’s own token, which pays for transactions there. Keep enough to cover both a token approval, when required, and the transfer itself.\u003c/p\u003e\n\u003cp data-sourcepos=\"7:1-7:283\"\u003eAdd the destination network to your wallet before sending. This lets you switch to that chain and inspect the arriving balance. Know the token you want to receive as well as the one you hold: moving a token and swapping it into another token can produce different routes and amounts.\u003c/p\u003e\n\u003cp data-sourcepos=\"9:1-9:262\"\u003eJumper Exchange is a consumer front end built on LI.FI. A lifi bridge front end finds routes across supported bridges and decentralized exchanges. Use \u003ca href=\"https://lifibridge.com\" rel=\"nofollow noopener\" target=\"_blank\"\u003elifi bridge\u003c/a\u003e to find a route for your chosen chains and tokens and begin the transfer.\u003c/p\u003e\n\u003ch2 data-sourcepos=\"11:1-11:38\"\u003e\n\u003cspan id=\"choose-a-route-and-review-the-quote\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#choose-a-route-and-review-the-quote\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eChoose a Route and Review the Quote\u003c/h2\u003e\n\u003cp data-sourcepos=\"13:1-13:286\"\u003eChoose the source chain, source token, and amount, then choose the destination chain and token. The quote is the proposed route and its estimated outcome. Compare routes by estimated arrival time and amount received; the quickest route may deliver a different amount from another route.\u003c/p\u003e\n\u003cp data-sourcepos=\"15:1-15:290\"\u003eA route can combine a swap with a bridge transfer. Think of the aggregator as a travel planner: a route is the itinerary, a bridge is one leg, and a swap changes what you carry. The analogy stops at the wallet: it must sign transactions, and each chain records its own part of the transfer.\u003c/p\u003e\n\u003cp data-sourcepos=\"17:1-17:400\"\u003eReview the token symbols and chains before selecting a route. Across and Stargate are examples of underlying bridges a route might use; the available route depends on the tokens, chains, amount, and current conditions. The amount received can change with bridge costs, swap pricing, and network gas. Use the current quote for the decision, rather than assuming a previous transfer will cost the same.\u003c/p\u003e\n\u003ch2 data-sourcepos=\"19:1-19:42\"\u003e\n\u003cspan id=\"approve-the-token-and-send-the-transfer\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#approve-the-token-and-send-the-transfer\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eApprove the Token and Send the Transfer\u003c/h2\u003e\n\u003cp data-sourcepos=\"21:1-21:268\"\u003eSending an ERC-20 token usually requires two wallet confirmations: a token approval, then the bridge transaction. Approval gives the chosen transaction permission to use the specified token. Wait for that approval to confirm before signing the transfer that spends it.\u003c/p\u003e\n\u003cp data-sourcepos=\"23:1-23:302\"\u003eRead each wallet request before confirming it. The approval should concern the source token; the next request sends the transfer on the source chain. Source chain gas is paid in that chain’s native token. If the wallet reports insufficient gas, add native gas on the source chain before trying again.\u003c/p\u003e\n\u003cp data-sourcepos=\"25:1-25:366\"\u003eAfter the transfer is submitted, save its source transaction hash. This is the unique identifier for the transaction your wallet sent. Copy it from your wallet’s activity or the source chain explorer while it is easy to find. A wallet confirmation means you submitted the source transaction; it is not yet confirmation that tokens arrived on the destination chain.\u003c/p\u003e\n\u003ch2 data-sourcepos=\"27:1-27:48\"\u003e\n\u003cspan id=\"track-the-source-and-destination-transactions\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#track-the-source-and-destination-transactions\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eTrack the Source and Destination Transactions\u003c/h2\u003e\n\u003cp data-sourcepos=\"29:1-29:305\"\u003eThe LI.FI bridge explorer lets you follow the transfer by pasting in the source transaction hash. It links the source and destination transactions in one view, so you can see whether the source send has confirmed and whether the destination leg has completed. Keep the hash until both sides show complete.\u003c/p\u003e\n\u003cp data-sourcepos=\"31:1-31:296\"\u003eThe source transaction must be confirmed before the destination leg can finish. The bridge relies on the source chain’s record of what was sent. A confirmed source transaction shows that the first stage is recorded; the destination transaction and its status show whether delivery has finished.\u003c/p\u003e\n\u003cp data-sourcepos=\"33:1-33:371\"\u003eOnce the explorer reports completion, switch your wallet to the destination network and inspect the token balance. The transfer is done when the explorer shows completion and the received token appears in your wallet on that chain. If the explorer shows completion but the balance looks unchanged, verify that you are viewing the right network, wallet address, and token.\u003c/p\u003e\n\u003ch2 data-sourcepos=\"35:1-35:50\"\u003e\n\u003cspan id=\"resolve-a-missing-balance-or-a-delayed-transfer\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#resolve-a-missing-balance-or-a-delayed-transfer\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eResolve a Missing Balance or a Delayed Transfer\u003c/h2\u003e\n\u003cp data-sourcepos=\"37:1-37:442\"\u003eA missing wallet balance can be a display issue after the destination transaction completes. Some wallets do not show a received token until you import its token contract on the destination network. Get the contract address from a trusted source, confirm that its chain matches the destination chain, and import it in the wallet. The destination transaction record helps you distinguish an unlisted token from a transfer that has not arrived.\u003c/p\u003e\n\u003cp data-sourcepos=\"39:1-39:392\"\u003eA transfer pending past its estimated time is often waiting on the underlying bridge. Look up the source hash in the LI.FI explorer and identify which side is still pending. Do not send the same transfer again solely because the estimate passed: the first one may still complete. Contact support for the front end or underlying bridge with the source hash and current status before resending.\u003c/p\u003e\n\u003cp data-sourcepos=\"41:1-41:205\"\u003eTo complete a LI.FI cross-chain swap, follow both chain transactions through to destination completion. The source hash connects the stages, giving you a reliable way to check arrival and describe a delay.\u003c/p\u003e\n\u003ch2 data-sourcepos=\"43:1-43:41\"\u003e\n\u003cspan id=\"common-questions-about-lifi-transfers\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#common-questions-about-lifi-transfers\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eCommon Questions About LI.FI Transfers\u003c/h2\u003e\n\u003ch3 data-sourcepos=\"45:1-45:57\"\u003e\n\u003cspan id=\"can-i-cancel-a-lifi-bridge-transfer-after-sending-it\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#can-i-cancel-a-lifi-bridge-transfer-after-sending-it\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eCan I Cancel a lifi bridge Transfer After Sending It?\u003c/h3\u003e\n\u003cp data-sourcepos=\"47:1-47:309\"\u003eOnce the source transaction confirms, you generally cannot cancel the cross-chain transfer from your wallet. A still-pending source transaction may offer wallet-level replacement or cancellation, but check its status before taking action. Use the source hash to see whether the bridge has begun processing it.\u003c/p\u003e\n\u003ch3 data-sourcepos=\"49:1-49:46\"\u003e\n\u003cspan id=\"how-much-does-a-lifi-bridge-transfer-cost\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#how-much-does-a-lifi-bridge-transfer-cost\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eHow Much Does a lifi bridge Transfer Cost?\u003c/h3\u003e\n\u003cp data-sourcepos=\"51:1-51:244\"\u003eThe cost depends on source chain gas, the selected bridge, and any swap in the route. Gas and swap prices can change while you compare routes. Review the current quote’s estimated amount received alongside its time estimate before confirming.\u003c/p\u003e\n\u003ch3 data-sourcepos=\"53:1-53:41\"\u003e\n\u003cspan id=\"which-wallets-work-with-lifi-bridge\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#which-wallets-work-with-lifi-bridge\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eWhich Wallets Work With LI.FI Bridge?\u003c/h3\u003e\n\u003cp data-sourcepos=\"55:1-55:273\"\u003eAn EVM wallet that connects to the chosen LI.FI front end and signs the required transactions can be used for an EVM transfer; MetaMask is one example. The wallet needs the source tokens and native gas, plus access to the destination network so you can confirm the arrival.\u003c/p\u003e\n","body":"A lifi bridge transfer takes you from a connected wallet through route selection, approval, and sending, then ends when the destination transaction completes. The route may use a bridge and a decentralized exchange, but your wallet signs the required transactions and the transfer settles across two chains.\n\n## Prepare Your Wallet for the Transfer\n\nA LI.FI cross-chain bridge transfer needs an EVM wallet with tokens and native gas on the source chain. Native gas means the source chain’s own token, which pays for transactions there. Keep enough to cover both a token approval, when required, and the transfer itself.\n\nAdd the destination network to your wallet before sending. This lets you switch to that chain and inspect the arriving balance. Know the token you want to receive as well as the one you hold: moving a token and swapping it into another token can produce different routes and amounts.\n\nJumper Exchange is a consumer front end built on LI.FI. A lifi bridge front end finds routes across supported bridges and decentralized exchanges. Use [lifi bridge](https://lifibridge.com) to find a route for your chosen chains and tokens and begin the transfer.\n\n## Choose a Route and Review the Quote\n\nChoose the source chain, source token, and amount, then choose the destination chain and token. The quote is the proposed route and its estimated outcome. Compare routes by estimated arrival time and amount received; the quickest route may deliver a different amount from another route.\n\nA route can combine a swap with a bridge transfer. Think of the aggregator as a travel planner: a route is the itinerary, a bridge is one leg, and a swap changes what you carry. The analogy stops at the wallet: it must sign transactions, and each chain records its own part of the transfer.\n\nReview the token symbols and chains before selecting a route. Across and Stargate are examples of underlying bridges a route might use; the available route depends on the tokens, chains, amount, and current conditions. The amount received can change with bridge costs, swap pricing, and network gas. Use the current quote for the decision, rather than assuming a previous transfer will cost the same.\n\n## Approve the Token and Send the Transfer\n\nSending an ERC-20 token usually requires two wallet confirmations: a token approval, then the bridge transaction. Approval gives the chosen transaction permission to use the specified token. Wait for that approval to confirm before signing the transfer that spends it.\n\nRead each wallet request before confirming it. The approval should concern the source token; the next request sends the transfer on the source chain. Source chain gas is paid in that chain’s native token. If the wallet reports insufficient gas, add native gas on the source chain before trying again.\n\nAfter the transfer is submitted, save its source transaction hash. This is the unique identifier for the transaction your wallet sent. Copy it from your wallet’s activity or the source chain explorer while it is easy to find. A wallet confirmation means you submitted the source transaction; it is not yet confirmation that tokens arrived on the destination chain.\n\n## Track the Source and Destination Transactions\n\nThe LI.FI bridge explorer lets you follow the transfer by pasting in the source transaction hash. It links the source and destination transactions in one view, so you can see whether the source send has confirmed and whether the destination leg has completed. Keep the hash until both sides show complete.\n\nThe source transaction must be confirmed before the destination leg can finish. The bridge relies on the source chain’s record of what was sent. A confirmed source transaction shows that the first stage is recorded; the destination transaction and its status show whether delivery has finished.\n\nOnce the explorer reports completion, switch your wallet to the destination network and inspect the token balance. The transfer is done when the explorer shows completion and the received token appears in your wallet on that chain. If the explorer shows completion but the balance looks unchanged, verify that you are viewing the right network, wallet address, and token.\n\n## Resolve a Missing Balance or a Delayed Transfer\n\nA missing wallet balance can be a display issue after the destination transaction completes. Some wallets do not show a received token until you import its token contract on the destination network. Get the contract address from a trusted source, confirm that its chain matches the destination chain, and import it in the wallet. The destination transaction record helps you distinguish an unlisted token from a transfer that has not arrived.\n\nA transfer pending past its estimated time is often waiting on the underlying bridge. Look up the source hash in the LI.FI explorer and identify which side is still pending. Do not send the same transfer again solely because the estimate passed: the first one may still complete. Contact support for the front end or underlying bridge with the source hash and current status before resending.\n\nTo complete a LI.FI cross-chain swap, follow both chain transactions through to destination completion. The source hash connects the stages, giving you a reliable way to check arrival and describe a delay.\n\n## Common Questions About LI.FI Transfers\n\n### Can I Cancel a lifi bridge Transfer After Sending It?\n\nOnce the source transaction confirms, you generally cannot cancel the cross-chain transfer from your wallet. A still-pending source transaction may offer wallet-level replacement or cancellation, but check its status before taking action. Use the source hash to see whether the bridge has begun processing it.\n\n### How Much Does a lifi bridge Transfer Cost?\n\nThe cost depends on source chain gas, the selected bridge, and any swap in the route. Gas and swap prices can change while you compare routes. Review the current quote’s estimated amount received alongside its time estimate before confirming.\n\n### Which Wallets Work With LI.FI Bridge?\n\nAn EVM wallet that connects to the chosen LI.FI front end and signs the required transactions can be used for an EVM transfer; MetaMask is one example. The wallet needs the source tokens and native gas, plus access to the destination network so you can confirm the arrival.\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T01:22:37+09:00","group":null,"id":"92024283e73e735391af","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"tech","versions":[]}],"title":"How to Use lifi bridge Step by Step and Confirm Arrival","updated_at":"2026-11-18T01:22:37+09:00","url":"https://qiita.com/ethelerlo_WEB3/items/92024283e73e735391af","user":{"description":null,"facebook_id":null,"followees_count":1,"followers_count":0,"github_login_name":null,"id":"ethelerlo_WEB3","items_count":22,"linkedin_id":null,"location":null,"name":"","organization":null,"permanent_id":4507027,"profile_image_url":"https://lh3.googleusercontent.com/a/ACg8ocImFIBTkQy0xaNECeMxLnGjwpC2nLESbdVG121ZTMCWoPYn=s96-c","team_only":false,"twitter_screen_name":null,"website_url":null},"page_views_count":null,"team_membership":null,"organization_url_name":null,"slide":false,"posting_campaign_uuid":null},{"rendered_body":"\u003ch2 data-sourcepos=\"1:1-1:15\"\u003e\n\u003cspan id=\"はじめに\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eはじめに\u003c/h2\u003e\n\u003cp data-sourcepos=\"3:1-4:132\"\u003e2026年のボジョレー・ヌーヴォーは、11月19日（木）に解禁されます。\u003cbr\u003e\n毎年この時期になると、「今年のボジョレーは◯◯」というキャッチコピーが話題になりますね。\u003c/p\u003e\n\u003cp data-sourcepos=\"6:1-7:108\"\u003eふだんスーパーの500円ワインしか飲まない私は、ワインの味よりこのコピーのほうが気になります。\u003cbr\u003e\nそこで今年は、解禁前にキャッチコピーの中身を予想してみることにしました。\u003c/p\u003e\n\u003cp data-sourcepos=\"9:1-10:180\"\u003e使うのは、ボジョレー地区の過去の気象データと、歴代のキャッチコピーです。\u003cbr\u003e\n500円ワインの知識しかないのですが、私なりにボジョレーについて調べたうえで、ある程度筋が通っていそうな方法でやっています。\u003c/p\u003e\n\u003cp data-sourcepos=\"12:1-13:129\"\u003eAI に「今年のコピーを予想して」と頼むだけだと面白くないですよね。\u003cbr\u003e\n私は統計が好きなので、自分でも計算を追える形で、根拠を持って予想してみたいと思います。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"15:1-15:39\"\u003e\n\u003cspan id=\"先に予想を載せておきます\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%85%88%E3%81%AB%E4%BA%88%E6%83%B3%E3%82%92%E8%BC%89%E3%81%9B%E3%81%A6%E3%81%8A%E3%81%8D%E3%81%BE%E3%81%99\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e先に予想を載せておきます\u003c/h2\u003e\n\u003cp data-sourcepos=\"17:1-17:84\"\u003e今回たどり着いたキャッチコピーの予想、ずばりこちらです！\u003c/p\u003e\n\u003cp data-sourcepos=\"19:1-19:15\"\u003eClaudeの予想\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"20:1-22:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e2003年を超える太陽の年。歴史に刻まれる、偉大なヴィンテージ\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"23:1-23:15\"\u003e私の予想：\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"24:1-26:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e歴史的猛暑が生んだ奇跡！今世紀最高級のヴィンテージ\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"28:1-29:93\"\u003eどちらも、要素としては「ほかの年との比較」と「褒め言葉」が入りそうだ、という計算結果をもとに書いています。\u003cbr\u003e\nここから先は、この予想にたどり着くまでの計算を順に説明します。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"31:1-31:66\"\u003e\n\u003cspan id=\"ボジョレーヌーヴォーのキャッチコピーとは\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%9C%E3%82%B8%E3%83%A7%E3%83%AC%E3%83%BC%E3%83%8C%E3%83%BC%E3%83%B4%E3%82%A9%E3%83%BC%E3%81%AE%E3%82%AD%E3%83%A3%E3%83%83%E3%83%81%E3%82%B3%E3%83%94%E3%83%BC%E3%81%A8%E3%81%AF\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eボジョレー・ヌーヴォーのキャッチコピーとは\u003c/h2\u003e\n\u003cp data-sourcepos=\"33:1-34:66\"\u003eボジョレー・ヌーヴォーは、フランスのボジョレー地区で、その年に収穫したガメイ種のブドウから造る新酒です。\u003cbr\u003e\n解禁日は毎年11月の第3木曜日と決まっています。\u003c/p\u003e\n\u003cp data-sourcepos=\"36:1-38:157\"\u003eキャッチコピーには2つの系統があります。\u003cbr\u003e\nエノテカの記事\u003csup\u003e\u003ca href=\"#fn-enoteca\" id=\"fnref-enoteca\"\u003e1\u003c/a\u003e\u003c/sup\u003eによると、1つは「現地のボジョレーワイン委員会によるブドウの評価をもとに、フランス食品振興会（SOPEXA）が発表した公式見解を和訳したもの」です。\u003cbr\u003e\nもう1つは、その情報をもとに日本で作られたコピーで、こちらは誇大広告気味だと指摘されることもあるそうです。\u003c/p\u003e\n\u003cp data-sourcepos=\"40:1-40:60\"\u003eこの記事では、公式見解のほうを扱います。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"44:1-44:33\"\u003e\n\u003cspan id=\"歴代のキャッチコピー\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%AD%B4%E4%BB%A3%E3%81%AE%E3%82%AD%E3%83%A3%E3%83%83%E3%83%81%E3%82%B3%E3%83%94%E3%83%BC\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e歴代のキャッチコピー\u003c/h2\u003e\n\u003cp data-sourcepos=\"46:1-46:81\"\u003eエノテカの記事に載っている公式見解は、次のとおりです。\u003c/p\u003e\n\u003ctable data-sourcepos=\"48:1-74:53\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"48:1-48:31\"\u003e\n\u003cth data-sourcepos=\"48:2-48:6\"\u003e年\u003c/th\u003e\n\u003cth data-sourcepos=\"48:8-48:30\"\u003eキャッチコピー\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"50:1-50:59\"\u003e\n\u003ctd data-sourcepos=\"50:2-50:7\"\u003e2000\u003c/td\u003e\n\u003ctd data-sourcepos=\"50:9-50:58\"\u003e出来は上々で申し分の無い仕上がり\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"51:1-51:31\"\u003e\n\u003ctd data-sourcepos=\"51:2-51:7\"\u003e2001\u003c/td\u003e\n\u003ctd data-sourcepos=\"51:9-51:30\"\u003eここ10年で最高\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"52:1-52:62\"\u003e\n\u003ctd data-sourcepos=\"52:2-52:7\"\u003e2002\u003c/td\u003e\n\u003ctd data-sourcepos=\"52:9-52:61\"\u003e色付きが良く、しっかりとしたボディ\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"53:1-53:41\"\u003e\n\u003ctd data-sourcepos=\"53:2-53:7\"\u003e2003\u003c/td\u003e\n\u003ctd data-sourcepos=\"53:9-53:40\"\u003e並外れて素晴らしい年\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"54:1-54:44\"\u003e\n\u003ctd data-sourcepos=\"54:2-54:7\"\u003e2004\u003c/td\u003e\n\u003ctd data-sourcepos=\"54:9-54:43\"\u003e生産者の実力が表れる年\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"55:1-55:65\"\u003e\n\u003ctd data-sourcepos=\"55:2-55:7\"\u003e2005\u003c/td\u003e\n\u003ctd data-sourcepos=\"55:9-55:64\"\u003e59年や64年、76年のように偉大な年の一つ\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"56:1-56:41\"\u003e\n\u003ctd data-sourcepos=\"56:2-56:7\"\u003e2006\u003c/td\u003e\n\u003ctd data-sourcepos=\"56:9-56:40\"\u003eとてもうまくいった年\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"57:1-57:47\"\u003e\n\u003ctd data-sourcepos=\"57:2-57:7\"\u003e2007\u003c/td\u003e\n\u003ctd data-sourcepos=\"57:9-57:46\"\u003e果実味が豊かでエレガント\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"58:1-58:53\"\u003e\n\u003ctd data-sourcepos=\"58:2-58:7\"\u003e2008\u003c/td\u003e\n\u003ctd data-sourcepos=\"58:9-58:52\"\u003eフルーツ、フルーツ、フルーツ\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"59:1-59:80\"\u003e\n\u003ctd data-sourcepos=\"59:2-59:7\"\u003e2009\u003c/td\u003e\n\u003ctd data-sourcepos=\"59:9-59:79\"\u003e数量は少なく、完璧な品質。桁外れに素晴らしい年\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"60:1-60:68\"\u003e\n\u003ctd data-sourcepos=\"60:2-60:7\"\u003e2010\u003c/td\u003e\n\u003ctd data-sourcepos=\"60:9-60:67\"\u003e果実味豊かで、滑らかでバランスの取れた\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"61:1-61:54\"\u003e\n\u003ctd data-sourcepos=\"61:2-61:7\"\u003e2011\u003c/td\u003e\n\u003ctd data-sourcepos=\"61:9-61:53\"\u003e3年連続で、偉大な品質となった\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"62:1-62:92\"\u003e\n\u003ctd data-sourcepos=\"62:2-62:7\"\u003e2012\u003c/td\u003e\n\u003ctd data-sourcepos=\"62:9-62:91\"\u003e心地よく、偉大な繊細さと複雑味のある香りを持ち合わせた\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"63:1-63:77\"\u003e\n\u003ctd data-sourcepos=\"63:2-63:7\"\u003e2013\u003c/td\u003e\n\u003ctd data-sourcepos=\"63:9-63:76\"\u003e繊細でしっかりとした骨格。美しく複雑なアロマ\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"64:1-64:77\"\u003e\n\u003ctd data-sourcepos=\"64:2-64:7\"\u003e2014\u003c/td\u003e\n\u003ctd data-sourcepos=\"64:9-64:76\"\u003eエレガントで味わい深く、とてもバランスがよい\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"65:1-65:53\"\u003e\n\u003ctd data-sourcepos=\"65:2-65:7\"\u003e2015\u003c/td\u003e\n\u003ctd data-sourcepos=\"65:9-65:52\"\u003e記憶に残る素晴らしい出来栄え\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"66:1-66:53\"\u003e\n\u003ctd data-sourcepos=\"66:2-66:7\"\u003e2016\u003c/td\u003e\n\u003ctd data-sourcepos=\"66:9-66:52\"\u003eエレガントで、魅惑的なワイン\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"67:1-67:101\"\u003e\n\u003ctd data-sourcepos=\"67:2-67:7\"\u003e2017\u003c/td\u003e\n\u003ctd data-sourcepos=\"67:9-67:100\"\u003e豊満で朗らか、絹のようにしなやか。しかもフレッシュで輝かしい\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"68:1-68:119\"\u003e\n\u003ctd data-sourcepos=\"68:2-68:7\"\u003e2018\u003c/td\u003e\n\u003ctd data-sourcepos=\"68:9-68:118\"\u003e2017年、2015年、2009年と並び、珠玉のヴィンテージとして歴史に刻まれるでしょう\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"69:1-69:68\"\u003e\n\u003ctd data-sourcepos=\"69:2-69:7\"\u003e2019\u003c/td\u003e\n\u003ctd data-sourcepos=\"69:9-69:67\"\u003e有望だが、生産者のテクニックが重要な年\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"70:1-70:77\"\u003e\n\u003ctd data-sourcepos=\"70:2-70:7\"\u003e2020\u003c/td\u003e\n\u003ctd data-sourcepos=\"70:9-70:76\"\u003e非常にバランスが取れた爽やかさのある仕上がり\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"71:1-71:68\"\u003e\n\u003ctd data-sourcepos=\"71:2-71:7\"\u003e2021\u003c/td\u003e\n\u003ctd data-sourcepos=\"71:9-71:67\"\u003e挑戦の末たどり着いた、納得のヌーヴォー\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"72:1-72:108\"\u003e\n\u003ctd data-sourcepos=\"72:2-72:7\"\u003e2022\u003c/td\u003e\n\u003ctd data-sourcepos=\"72:9-72:107\"\u003e太陽に恵まれたヴィンテージ 果実味とストラクチュアの完璧なバランス\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"73:1-73:29\"\u003e\n\u003ctd data-sourcepos=\"73:2-73:7\"\u003e2023\u003c/td\u003e\n\u003ctd data-sourcepos=\"73:9-73:28\"\u003e（発表なし）\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"74:1-74:53\"\u003e\n\u003ctd data-sourcepos=\"74:2-74:7\"\u003e2024\u003c/td\u003e\n\u003ctd data-sourcepos=\"74:9-74:52\"\u003e努力と多様性のヴィンテージ！\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"76:1-77:98\"\u003e2023年は記事に「発表なし」とあり、2025年は掲載がありません。\u003cbr\u003e\nそのため、この記事で使うのは2000〜2024年のうち2023年を除いた24本です。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"79:1-79:21\"\u003e\n\u003cspan id=\"今回やること\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BB%8A%E5%9B%9E%E3%82%84%E3%82%8B%E3%81%93%E3%81%A8\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e今回やること\u003c/h2\u003e\n\u003cp data-sourcepos=\"81:1-83:75\"\u003e正解データが24しかないため、キャッチコピーの文面そのものを当てるのはさすがに無理がありそうです。\u003cbr\u003e\nそこで今回は、コピーを「どんな要素が入っているか」に分けて、要素ごとに予想することにしました。\u003cbr\u003e\nつまり、タグをつけてタグを予測するということです。\u003c/p\u003e\n\u003cp data-sourcepos=\"85:1-85:177\"\u003eたとえば2022年の「太陽に恵まれたヴィンテージ 果実味とストラクチュアの完璧なバランス」には、次の4つの要素が入っています。\u003c/p\u003e\n\u003cul data-sourcepos=\"87:1-91:0\"\u003e\n\u003cli data-sourcepos=\"87:1-87:47\"\u003e天候への言及（太陽に恵まれた）\u003c/li\u003e\n\u003cli data-sourcepos=\"88:1-88:32\"\u003e果実の風味（果実味）\u003c/li\u003e\n\u003cli data-sourcepos=\"89:1-89:62\"\u003e渋みからくるしっかり感（ストラクチュア）\u003c/li\u003e\n\u003cli data-sourcepos=\"90:1-91:0\"\u003e要素どうしの調和（バランス）\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp data-sourcepos=\"92:1-93:133\"\u003eこの要素を「タグ」として24本すべてに付け、気象データとの関係を調べます。\u003cbr\u003e\n2026年の気象がどの年に近いかが分かれば、今年のコピーに入りそうなタグも予想できるはずです。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"95:1-95:51\"\u003e\n\u003cspan id=\"歴代のキャッチコピーに付けたタグ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%AD%B4%E4%BB%A3%E3%81%AE%E3%82%AD%E3%83%A3%E3%83%83%E3%83%81%E3%82%B3%E3%83%94%E3%83%BC%E3%81%AB%E4%BB%98%E3%81%91%E3%81%9F%E3%82%BF%E3%82%B0\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e歴代のキャッチコピーに付けたタグ\u003c/h2\u003e\n\u003cp data-sourcepos=\"97:1-97:32\"\u003eタグは次の10種類です。\u003c/p\u003e\n\u003ctable data-sourcepos=\"99:1-110:76\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"99:1-99:31\"\u003e\n\u003cth data-sourcepos=\"99:2-99:9\"\u003eタグ\u003c/th\u003e\n\u003cth data-sourcepos=\"99:11-99:18\"\u003e中身\u003c/th\u003e\n\u003cth data-sourcepos=\"99:20-99:30\"\u003e語の例\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"101:1-101:88\"\u003e\n\u003ctd data-sourcepos=\"101:2-101:12\"\u003e果実味\u003c/td\u003e\n\u003ctd data-sourcepos=\"101:14-101:39\"\u003e果実の風味や香り\u003c/td\u003e\n\u003ctd data-sourcepos=\"101:41-101:87\"\u003e果実味、フルーツ、アロマ、香り\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"102:1-102:109\"\u003e\n\u003ctd data-sourcepos=\"102:2-102:12\"\u003eボディ\u003c/td\u003e\n\u003ctd data-sourcepos=\"102:14-102:60\"\u003e口の中で感じる厚みやなめらかさ\u003c/td\u003e\n\u003ctd data-sourcepos=\"102:62-102:108\"\u003eボディ、豊満、滑らか、絹のよう\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"103:1-103:85\"\u003e\n\u003ctd data-sourcepos=\"103:2-103:9\"\u003e酸味\u003c/td\u003e\n\u003ctd data-sourcepos=\"103:11-103:39\"\u003e酸からくる爽やかさ\u003c/td\u003e\n\u003ctd data-sourcepos=\"103:41-103:84\"\u003eフレッシュ、爽やか、輝かしい\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"104:1-104:79\"\u003e\n\u003ctd data-sourcepos=\"104:2-104:9\"\u003e骨格\u003c/td\u003e\n\u003ctd data-sourcepos=\"104:11-104:45\"\u003e渋みからくるしっかり感\u003c/td\u003e\n\u003ctd data-sourcepos=\"104:47-104:78\"\u003e骨格、ストラクチュア\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"105:1-105:67\"\u003e\n\u003ctd data-sourcepos=\"105:2-105:15\"\u003eバランス\u003c/td\u003e\n\u003ctd data-sourcepos=\"105:17-105:42\"\u003e要素どうしの調和\u003c/td\u003e\n\u003ctd data-sourcepos=\"105:44-105:66\"\u003eバランス、調和\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"106:1-106:40\"\u003e\n\u003ctd data-sourcepos=\"106:2-106:9\"\u003e色調\u003c/td\u003e\n\u003ctd data-sourcepos=\"106:11-106:27\"\u003e見た目の色\u003c/td\u003e\n\u003ctd data-sourcepos=\"106:29-106:39\"\u003e色付き\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"107:1-107:94\"\u003e\n\u003ctd data-sourcepos=\"107:2-107:9\"\u003e称賛\u003c/td\u003e\n\u003ctd data-sourcepos=\"107:11-107:48\"\u003e中身を特定しない褒め言葉\u003c/td\u003e\n\u003ctd data-sourcepos=\"107:50-107:93\"\u003e素晴らしい、偉大、エレガント\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"108:1-108:103\"\u003e\n\u003ctd data-sourcepos=\"108:2-108:9\"\u003e比較\u003c/td\u003e\n\u003ctd data-sourcepos=\"108:11-108:48\"\u003eほかの年との比較や希少性\u003c/td\u003e\n\u003ctd data-sourcepos=\"108:50-108:102\"\u003eここ10年で最高、◯年と並び、3年連続\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"109:1-109:103\"\u003e\n\u003ctd data-sourcepos=\"109:2-109:9\"\u003e留保\u003c/td\u003e\n\u003ctd data-sourcepos=\"109:11-109:63\"\u003e手放しで褒めず、条件や苦労に触れる\u003c/td\u003e\n\u003ctd data-sourcepos=\"109:65-109:102\"\u003e生産者の実力、挑戦、努力\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"110:1-110:76\"\u003e\n\u003ctd data-sourcepos=\"110:2-110:15\"\u003e外部要因\u003c/td\u003e\n\u003ctd data-sourcepos=\"110:17-110:45\"\u003e天候や収量への言及\u003c/td\u003e\n\u003ctd data-sourcepos=\"110:47-110:75\"\u003e太陽、数量は少なく\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"112:1-114:87\"\u003e1つのコピーにつき、それぞれのタグが該当するか、0/1のフラグを立てるイメージです。\u003cbr\u003e\nタグ付けは Claude にやってもらったうえで、私も目で確認しました。\u003cbr\u003e\n判断に迷う箇所もいくつかありましたが、ざっくりで進めます。\u003c/p\u003e\n\u003cp data-sourcepos=\"116:1-116:39\"\u003e出現回数は次のとおりです。\u003c/p\u003e\n\u003cp data-sourcepos=\"118:1-118:130\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F3664928%2F4f4790bf-da99-4744-9789-710519ef1801.png?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=36391031b60af91aa2e70cc224b99336\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F3664928%2F4f4790bf-da99-4744-9789-710519ef1801.png?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=36391031b60af91aa2e70cc224b99336\" alt=\"01_tag_counts.png\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F3664928%2F4f4790bf-da99-4744-9789-710519ef1801.png?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=a0751a8310c60ffe53e377827878088d 1x\" data-canonical-src=\"https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3664928/4f4790bf-da99-4744-9789-710519ef1801.png\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"121:1-123:174\"\u003e一番多いのは\"称賛\"で、24本中13本に入っていました。\u003cbr\u003e\n意外だったのは\"酸味\"の少なさで、24本中2本しかありません。\u003cbr\u003e\nヌーヴォーは酸のフレッシュさが大事なワインと言われますが、コピーで酸味が触れられた年は実はそんなになかったようです。\u003c/p\u003e\n\u003cp data-sourcepos=\"125:1-127:66\"\u003eボジョレーのキャッチコピーと聞くと、「◯年に一度の出来」のような、ほかの年と比べるフレーズを思い浮かべる人も多いと思います。\u003cbr\u003e\n公式見解のほうでも、\"比較\"は24本中7本に入っていて、\"称賛\"の次に多いタグでした。\u003cbr\u003e\nこの比較タグが、今回の予想の中心になります。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"129:1-129:21\"\u003e\n\u003cspan id=\"使ったデータ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BD%BF%E3%81%A3%E3%81%9F%E3%83%87%E3%83%BC%E3%82%BF\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e使ったデータ\u003c/h2\u003e\n\u003ch3 data-sourcepos=\"131:1-131:19\"\u003e\n\u003cspan id=\"気象データ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%B0%97%E8%B1%A1%E3%83%87%E3%83%BC%E3%82%BF\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e気象データ\u003c/h3\u003e\n\u003cp data-sourcepos=\"133:1-134:112\"\u003eOpen-Meteo の過去気象API\u003csup\u003e\u003ca href=\"#fn-openmeteo\" id=\"fnref-openmeteo\"\u003e2\u003c/a\u003e\u003c/sup\u003eから、ボジョレー地区の日ごとの気温と降水量を取得しました。\u003cbr\u003e\n地点は北緯46.0度、東経4.6度の1点で、期間は2000年1月1日から2026年11月10日までです。\u003c/p\u003e\n\u003cp data-sourcepos=\"136:1-136:76\"\u003eこのデータから、年ごとに次の4つの数字を作りました。\u003c/p\u003e\n\u003ctable data-sourcepos=\"138:1-143:54\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"138:1-138:19\"\u003e\n\u003cth data-sourcepos=\"138:2-138:9\"\u003e指標\u003c/th\u003e\n\u003cth data-sourcepos=\"138:11-138:18\"\u003e意味\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"140:1-140:57\"\u003e\n\u003ctd data-sourcepos=\"140:2-140:26\"\u003e4〜9月の平均気温\u003c/td\u003e\n\u003ctd data-sourcepos=\"140:28-140:56\"\u003e生育期間全体の暑さ\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"141:1-141:92\"\u003e\n\u003ctd data-sourcepos=\"141:2-141:52\"\u003e7〜8月に最高気温が30℃を超えた日数\u003c/td\u003e\n\u003ctd data-sourcepos=\"141:54-141:91\"\u003e実が熟す時期の猛暑の多さ\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"142:1-142:47\"\u003e\n\u003ctd data-sourcepos=\"142:2-142:31\"\u003e8月の最低気温の平均\u003c/td\u003e\n\u003ctd data-sourcepos=\"142:33-142:46\"\u003e夜の暑さ\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"143:1-143:54\"\u003e\n\u003ctd data-sourcepos=\"143:2-143:23\"\u003e4〜9月の降水量\u003c/td\u003e\n\u003ctd data-sourcepos=\"143:25-143:53\"\u003e生育期間の雨の多さ\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"145:1-145:159\"\u003eブドウのドメイン知識を多少勉強してみた結果、出来に関わる要素として「気温と降水量」が大きそうと睨みました。\u003c/p\u003e\n\u003cp data-sourcepos=\"147:1-150:69\"\u003e暑い年ほどブドウに糖がたまり、アルコールが高く厚みのあるワインになります。\u003cbr\u003e\n一方で、30℃を超える日が続くと、ブドウはリンゴ酸を呼吸で使ってしまい、酸が減ります。\u003cbr\u003e\n夜が涼しいと酸と香りが残りやすく、熱帯夜が続くと夜のあいだも酸が減ります。\u003cbr\u003e\n雨が多いと病気や腐敗が増え、果汁も薄まります。\u003c/p\u003e\n\u003cp data-sourcepos=\"152:1-153:144\"\u003eヌーヴォーは房ごと短期間で発酵させて、すぐに出荷します。\u003cbr\u003e\n醸造でブドウの出来を補う余地が小さいので、その年の天候がワインにそのまま出やすいと考えられます。\u003c/p\u003e\n\u003cp data-sourcepos=\"155:1-155:181\"\u003eなお、この4つは、ワインの気候研究で使われる標準的な指標\u003csup\u003e\u003ca href=\"#fn-mcc\" id=\"fnref-mcc\"\u003e3\u003c/a\u003e\u003c/sup\u003e（ヒュグリン指数、冷涼夜指数、乾燥指数）を参考にしたものです。\u003c/p\u003e\n\u003ch3 data-sourcepos=\"160:1-160:34\"\u003e\n\u003cspan id=\"ブドウの生育レポート\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%83%96%E3%83%89%E3%82%A6%E3%81%AE%E7%94%9F%E8%82%B2%E3%83%AC%E3%83%9D%E3%83%BC%E3%83%88\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eブドウの生育レポート\u003c/h3\u003e\n\u003cp data-sourcepos=\"162:1-163:93\"\u003eもう1つの材料として、フランスの地方農業局（DRAAF オーヴェルニュ＝ローヌ＝アルプ）が出しているブドウの病害速報（BSV）\u003csup\u003e\u003ca href=\"#fn-bsv\" id=\"fnref-bsv\"\u003e4\u003c/a\u003e\u003c/sup\u003eを使いました。\u003cbr\u003e\n生育の進み具合や病気の発生状況が、週ごとにまとめられています。\u003c/p\u003e\n\u003cp data-sourcepos=\"165:1-166:43\"\u003eこちらに関しては、24年分のレポートを集計して学習データにするのは非常に手間がかかるので、今回は2026年分を読んで補足に使うだけにしました。\u003cbr\u003e\n2026年の要点は次のとおりです。\u003c/p\u003e\n\u003cul data-sourcepos=\"168:1-172:0\"\u003e\n\u003cli data-sourcepos=\"168:1-168:62\"\u003e5月27日時点で、大多数の区画が開花期だった\u003c/li\u003e\n\u003cli data-sourcepos=\"169:1-169:109\"\u003e6月28〜29日の雷雨で、ボジョレーの複数のコミューン（村）に雹の被害があった\u003c/li\u003e\n\u003cli data-sourcepos=\"170:1-170:89\"\u003eうどんこ病などの病気は出ていたが、全体として低い水準だった\u003c/li\u003e\n\u003cli data-sourcepos=\"171:1-172:0\"\u003e7月上旬に実の色づきが始まった\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch2 data-sourcepos=\"175:1-175:37\"\u003e\n\u003cspan id=\"2026年はどんな年だったか\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#2026%E5%B9%B4%E3%81%AF%E3%81%A9%E3%82%93%E3%81%AA%E5%B9%B4%E3%81%A0%E3%81%A3%E3%81%9F%E3%81%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e2026年はどんな年だったか\u003c/h2\u003e\n\u003cp data-sourcepos=\"177:1-177:94\"\u003eまず、ボジョレー地区の2026年の4つの指標を、2000〜2025年と比べます。\u003c/p\u003e\n\u003ctable data-sourcepos=\"179:1-184:60\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"179:1-179:66\"\u003e\n\u003cth data-sourcepos=\"179:2-179:9\"\u003e指標\u003c/th\u003e\n\u003cth data-sourcepos=\"179:11-179:19\"\u003e2026年\u003c/th\u003e\n\u003cth data-sourcepos=\"179:21-179:45\"\u003e2000〜2025年の平均\u003c/th\u003e\n\u003cth data-sourcepos=\"179:47-179:65\"\u003e27年中の順位\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"181:1-181:56\"\u003e\n\u003ctd data-sourcepos=\"181:2-181:26\"\u003e4〜9月の平均気温\u003c/td\u003e\n\u003ctd data-sourcepos=\"181:28-181:37\"\u003e20.05℃\u003c/td\u003e\n\u003ctd data-sourcepos=\"181:39-181:48\"\u003e17.22℃\u003c/td\u003e\n\u003ctd data-sourcepos=\"181:50-181:55\"\u003e1位\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"182:1-182:60\"\u003e\n\u003ctd data-sourcepos=\"182:2-182:34\"\u003e7〜8月の30℃超えの日数\u003c/td\u003e\n\u003ctd data-sourcepos=\"182:36-182:42\"\u003e31日\u003c/td\u003e\n\u003ctd data-sourcepos=\"182:44-182:52\"\u003e11.6日\u003c/td\u003e\n\u003ctd data-sourcepos=\"182:54-182:59\"\u003e1位\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"183:1-183:61\"\u003e\n\u003ctd data-sourcepos=\"183:2-183:31\"\u003e8月の最低気温の平均\u003c/td\u003e\n\u003ctd data-sourcepos=\"183:33-183:42\"\u003e18.36℃\u003c/td\u003e\n\u003ctd data-sourcepos=\"183:44-183:53\"\u003e15.65℃\u003c/td\u003e\n\u003ctd data-sourcepos=\"183:55-183:60\"\u003e2位\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"184:1-184:60\"\u003e\n\u003ctd data-sourcepos=\"184:2-184:23\"\u003e4〜9月の降水量\u003c/td\u003e\n\u003ctd data-sourcepos=\"184:25-184:31\"\u003e269mm\u003c/td\u003e\n\u003ctd data-sourcepos=\"184:33-184:39\"\u003e446mm\u003c/td\u003e\n\u003ctd data-sourcepos=\"184:41-184:59\"\u003e27位（最少）\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"186:1-187:120\"\u003eボジョレー地区の2026年は、\u003cstrong\u003eこの27年でいちばん暑く\u003c/strong\u003e、\u003cstrong\u003eいちばん雨の少ない\u003c/strong\u003e年でした。\u003cbr\u003e\n猛暑だったと言われている2003年と比べても、4〜9月の平均気温は0.7℃高くなっています。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"189:1-189:72\"\u003e\n\u003cspan id=\"タグで集計して気候データのばらつきを見てみる\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%82%BF%E3%82%B0%E3%81%A7%E9%9B%86%E8%A8%88%E3%81%97%E3%81%A6%E6%B0%97%E5%80%99%E3%83%87%E3%83%BC%E3%82%BF%E3%81%AE%E3%81%B0%E3%82%89%E3%81%A4%E3%81%8D%E3%82%92%E8%A6%8B%E3%81%A6%E3%81%BF%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e①タグで集計して気候データのばらつきを見てみる\u003c/h2\u003e\n\u003cp data-sourcepos=\"191:1-191:132\"\u003e最初に、タグごとに「タグが付いた年」と「付かなかった年」で、暑さと雨の平均を比べました。\u003c/p\u003e\n\u003cp data-sourcepos=\"193:1-197:100\"\u003eここで、気温系の3つの指標はまとめて1つの「暑さ」として扱っています。\u003cbr\u003e\nこの3つは互いの相関が0.7〜0.8と高く、ほぼ同じものを測っているからです。\u003cbr\u003e\n具体的には、各指標を平均0・標準偏差1にそろえた値（zスコア）にしてから、3つを平均しました。\u003cbr\u003e\n降水量も同じようにzスコアにして、「雨」の軸にしています。\u003cbr\u003e\nこのあとの図で横軸の「暑さ」と書いているのは、この3指標の平均です。\u003c/p\u003e\n\u003cp data-sourcepos=\"199:1-201:149\"\u003e差が偶然の範囲かどうかは、並べ替え検定で確かめました。\u003cbr\u003e\nタグの「あり・なし」をランダムに入れ替えて差を計算する作業を10万回繰り返します。\u003cbr\u003e\nそのうえで、実際の差と同じかそれ以上の大きさの差（向きは問わない）が偶然に出る割合を p値としました。\u003c/p\u003e\n\u003ctable data-sourcepos=\"203:1-208:49\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"203:1-203:60\"\u003e\n\u003cth data-sourcepos=\"203:2-203:9\"\u003eタグ\u003c/th\u003e\n\u003cth data-sourcepos=\"203:11-203:18\"\u003e出現\u003c/th\u003e\n\u003cth data-sourcepos=\"203:20-203:33\"\u003e暑さの差\u003c/th\u003e\n\u003cth data-sourcepos=\"203:35-203:40\"\u003ep値\u003c/th\u003e\n\u003cth data-sourcepos=\"203:42-203:52\"\u003e雨の差\u003c/th\u003e\n\u003cth data-sourcepos=\"203:54-203:59\"\u003ep値\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"205:1-205:89\"\u003e\n\u003ctd data-sourcepos=\"205:2-205:48\"\u003e物性系（果実味〜色調のどれか）\u003c/td\u003e\n\u003ctd data-sourcepos=\"205:50-205:56\"\u003e10/24\u003c/td\u003e\n\u003ctd data-sourcepos=\"205:58-205:66\"\u003e−0.44\u003c/td\u003e\n\u003ctd data-sourcepos=\"205:68-205:73\"\u003e0.27\u003c/td\u003e\n\u003ctd data-sourcepos=\"205:75-205:81\"\u003e+0.31\u003c/td\u003e\n\u003ctd data-sourcepos=\"205:83-205:88\"\u003e0.48\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"206:1-206:50\"\u003e\n\u003ctd data-sourcepos=\"206:2-206:9\"\u003e称賛\u003c/td\u003e\n\u003ctd data-sourcepos=\"206:11-206:17\"\u003e13/24\u003c/td\u003e\n\u003ctd data-sourcepos=\"206:19-206:25\"\u003e+0.31\u003c/td\u003e\n\u003ctd data-sourcepos=\"206:27-206:32\"\u003e0.44\u003c/td\u003e\n\u003ctd data-sourcepos=\"206:34-206:42\"\u003e−0.09\u003c/td\u003e\n\u003ctd data-sourcepos=\"206:44-206:49\"\u003e0.84\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"207:1-207:50\"\u003e\n\u003ctd data-sourcepos=\"207:2-207:9\"\u003e比較\u003c/td\u003e\n\u003ctd data-sourcepos=\"207:11-207:16\"\u003e7/24\u003c/td\u003e\n\u003ctd data-sourcepos=\"207:18-207:24\"\u003e+0.91\u003c/td\u003e\n\u003ctd data-sourcepos=\"207:26-207:32\"\u003e0.025\u003c/td\u003e\n\u003ctd data-sourcepos=\"207:34-207:42\"\u003e−0.80\u003c/td\u003e\n\u003ctd data-sourcepos=\"207:44-207:49\"\u003e0.08\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"208:1-208:49\"\u003e\n\u003ctd data-sourcepos=\"208:2-208:9\"\u003e留保\u003c/td\u003e\n\u003ctd data-sourcepos=\"208:11-208:16\"\u003e4/24\u003c/td\u003e\n\u003ctd data-sourcepos=\"208:18-208:26\"\u003e−0.42\u003c/td\u003e\n\u003ctd data-sourcepos=\"208:28-208:33\"\u003e0.43\u003c/td\u003e\n\u003ctd data-sourcepos=\"208:35-208:41\"\u003e+0.44\u003c/td\u003e\n\u003ctd data-sourcepos=\"208:43-208:48\"\u003e0.46\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"210:1-212:134\"\u003e差の単位は標準偏差です。\u003cbr\u003e\nはっきりした差が出たのは、\"比較\"タグと「暑さ」の組み合わせだけでした。\u003cbr\u003e\n\"比較\"のフレーズが付いた年は、付かなかった年より標準偏差0.9個分ほど暑かったことになります。\u003c/p\u003e\n\u003cp data-sourcepos=\"214:1-214:357\"\u003e※ただし、表の4つのほかに果実味とバランスも調べていて、全部で12通りの組み合わせを検定しています。12回も試せば、どれか1つで p\u0026lt;0.05となる値が偶然出ることは珍しくありません。なので、ここでは「\"比較\"タグと暑さには関係がありそう」くらいの理解です。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"216:1-216:60\"\u003e\n\u003cspan id=\"気候データで年ごとの類似度を見てみる\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E6%B0%97%E5%80%99%E3%83%87%E3%83%BC%E3%82%BF%E3%81%A7%E5%B9%B4%E3%81%94%E3%81%A8%E3%81%AE%E9%A1%9E%E4%BC%BC%E5%BA%A6%E3%82%92%E8%A6%8B%E3%81%A6%E3%81%BF%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e②気候データで年ごとの類似度を見てみる\u003c/h2\u003e\n\u003cp data-sourcepos=\"218:1-219:153\"\u003e次に、2026年と天候が近い年を探しました。\u003cbr\u003e\n「暑さ」と「雨」の2つの軸で、各年と2026年の距離（ユークリッド距離）を計算し、近い順に5年を選んでいます。\u003c/p\u003e\n\u003cp data-sourcepos=\"221:1-221:129\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F3664928%2Ffe75c7b6-3295-4b01-8b50-c8ec5e9287b5.png?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=b3355df7833edf14a461344b0023a17c\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F3664928%2Ffe75c7b6-3295-4b01-8b50-c8ec5e9287b5.png?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=b3355df7833edf14a461344b0023a17c\" alt=\"02_heat_rain.png\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F3664928%2Ffe75c7b6-3295-4b01-8b50-c8ec5e9287b5.png?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=ca5ff9ccf316ab57e45bf785f30e0f68 1x\" data-canonical-src=\"https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3664928/fe75c7b6-3295-4b01-8b50-c8ec5e9287b5.png\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"224:1-226:122\"\u003e2026年に近いのは、2003年、2018年、2020年、2022年、2009年の5年でした。\u003cbr\u003e\n図では、2026年は右下の端にあります。\u003cbr\u003e\nいちばん近いのは2003年ですが、2026年はそれよりさらに暑く、雨も少ない位置にあります。\u003c/p\u003e\n\u003cp data-sourcepos=\"228:1-228:77\"\u003eこの5年で各タグが付いた割合を、2026年の予想とします。\u003c/p\u003e\n\u003ctable data-sourcepos=\"230:1-235:23\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"230:1-230:64\"\u003e\n\u003cth data-sourcepos=\"230:2-230:9\"\u003eタグ\u003c/th\u003e\n\u003cth data-sourcepos=\"230:11-230:37\"\u003e近い5年での出現率\u003c/th\u003e\n\u003cth data-sourcepos=\"230:39-230:63\"\u003e24年全体の出現率\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"232:1-232:26\"\u003e\n\u003ctd data-sourcepos=\"232:2-232:12\"\u003e物性系\u003c/td\u003e\n\u003ctd data-sourcepos=\"232:14-232:18\"\u003e0.4\u003c/td\u003e\n\u003ctd data-sourcepos=\"232:20-232:25\"\u003e0.42\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"233:1-233:23\"\u003e\n\u003ctd data-sourcepos=\"233:2-233:9\"\u003e称賛\u003c/td\u003e\n\u003ctd data-sourcepos=\"233:11-233:15\"\u003e0.6\u003c/td\u003e\n\u003ctd data-sourcepos=\"233:17-233:22\"\u003e0.54\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"234:1-234:23\"\u003e\n\u003ctd data-sourcepos=\"234:2-234:9\"\u003e比較\u003c/td\u003e\n\u003ctd data-sourcepos=\"234:11-234:15\"\u003e0.6\u003c/td\u003e\n\u003ctd data-sourcepos=\"234:17-234:22\"\u003e0.29\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"235:1-235:23\"\u003e\n\u003ctd data-sourcepos=\"235:2-235:9\"\u003e留保\u003c/td\u003e\n\u003ctd data-sourcepos=\"235:11-235:15\"\u003e0.0\u003c/td\u003e\n\u003ctd data-sourcepos=\"235:17-235:22\"\u003e0.17\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"237:1-238:89\"\u003e\"比較\"タグは全体の出現率は3割弱であるものの、気候が近い5年の中においては6割でした。\u003cbr\u003e\n①と同じく、暑い年ほど\"比較\"のフレーズが付く傾向が見えます。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"241:1-241:66\"\u003e\n\u003cspan id=\"実際に気候データからタグを予測してみる\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E5%AE%9F%E9%9A%9B%E3%81%AB%E6%B0%97%E5%80%99%E3%83%87%E3%83%BC%E3%82%BF%E3%81%8B%E3%82%89%E3%82%BF%E3%82%B0%E3%82%92%E4%BA%88%E6%B8%AC%E3%81%97%E3%81%A6%E3%81%BF%E3%82%8B\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e③実際に気候データからタグを予測してみる！\u003c/h2\u003e\n\u003cp data-sourcepos=\"243:1-243:24\"\u003e本丸の分析です。\u003c/p\u003e\n\u003cp data-sourcepos=\"245:1-247:130\"\u003e②の「近い年から予想する」方法が、本当に当たるのかを確かめます。\u003cbr\u003e\n2026年の答えはまだ分からないので、過去の年で試すことにしました。\u003cbr\u003e\nやり方は「1年抜き検証」と呼ばれるもので、答えを知らないふりをして過去の年を予想します。\u003c/p\u003e\n\u003cp data-sourcepos=\"249:1-249:46\"\u003e2018年を例に、手順を説明します。\u003c/p\u003e\n\u003col data-sourcepos=\"251:1-255:0\"\u003e\n\u003cli data-sourcepos=\"251:1-251:81\"\u003e2018年のコピーを隠して、残りの23年だけを手元に置きます\u003c/li\u003e\n\u003cli data-sourcepos=\"252:1-252:108\"\u003e23年の中から、2018年と天候が近い5年を選びます（2020、2019、2022、2009、2011年）\u003c/li\u003e\n\u003cli data-sourcepos=\"253:1-253:118\"\u003eこの5年のうち2年に\"比較\"タグがあるので、2018年に\"比較\"が付く確率を0.4と予想します\u003c/li\u003e\n\u003cli data-sourcepos=\"254:1-255:0\"\u003e実際の2018年のコピーには\"比較\"があった（1）ので、予想の外れ具合を (1 − 0.4)² = 0.36 と計算します\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp data-sourcepos=\"256:1-257:121\"\u003eこの外れ具合をブライアースコアといいます。\u003cbr\u003e\n予想した確率と実際の0/1の差を2乗したもので、小さいほど当たっていることになります。\u003c/p\u003e\n\u003cp data-sourcepos=\"259:1-262:127\"\u003e同じことを2000年から2024年まで24年分繰り返し、ブライアースコアを平均します。\u003cbr\u003e\n比べる相手は、「残り23年でタグが付いた割合を、そのまま予想に使う」という単純な方法です。\u003cbr\u003e\n2018年の例なら、残り23年のうち6年に\"比較\"があるので、予想は0.26、スコアは (1 − 0.26)² = 0.55 です。\u003cbr\u003e\n2018年については近い5年のほうが当たっていますが、24年分を平均するとどうなるでしょうか。\u003c/p\u003e\n\u003ctable data-sourcepos=\"264:1-269:26\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"264:1-264:53\"\u003e\n\u003cth data-sourcepos=\"264:2-264:9\"\u003eタグ\u003c/th\u003e\n\u003cth data-sourcepos=\"264:11-264:31\"\u003e近い5年の平均\u003c/th\u003e\n\u003cth data-sourcepos=\"264:33-264:52\"\u003e全体の出現率\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"266:1-266:29\"\u003e\n\u003ctd data-sourcepos=\"266:2-266:12\"\u003e物性系\u003c/td\u003e\n\u003ctd data-sourcepos=\"266:14-266:20\"\u003e0.360\u003c/td\u003e\n\u003ctd data-sourcepos=\"266:22-266:28\"\u003e0.265\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"267:1-267:26\"\u003e\n\u003ctd data-sourcepos=\"267:2-267:9\"\u003e称賛\u003c/td\u003e\n\u003ctd data-sourcepos=\"267:11-267:17\"\u003e0.342\u003c/td\u003e\n\u003ctd data-sourcepos=\"267:19-267:25\"\u003e0.270\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"268:1-268:26\"\u003e\n\u003ctd data-sourcepos=\"268:2-268:9\"\u003e比較\u003c/td\u003e\n\u003ctd data-sourcepos=\"268:11-268:17\"\u003e0.277\u003c/td\u003e\n\u003ctd data-sourcepos=\"268:19-268:25\"\u003e0.225\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"269:1-269:26\"\u003e\n\u003ctd data-sourcepos=\"269:2-269:9\"\u003e留保\u003c/td\u003e\n\u003ctd data-sourcepos=\"269:11-269:17\"\u003e0.168\u003c/td\u003e\n\u003ctd data-sourcepos=\"269:19-269:25\"\u003e0.151\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"271:1-273:132\"\u003e結果は、すべてのタグで「近い5年の平均」の負けでした。\u003cbr\u003e\n5年分しか使わないので、たまたま選ばれた年に予想が大きく左右されたのだと考えられます。\u003cbr\u003e\n天候の近い年を選んだ利点よりも、年の選ばれ方によるぶれのほうが大きかったことになります。\u003c/p\u003e\n\u003cp data-sourcepos=\"275:1-277:76\"\u003eそこで、全24年を使う方法も試しました。\u003cbr\u003e\n暑さ1つだけを説明変数にしたロジスティック回帰で、タグが付く確率を予想します。\u003cbr\u003e\n同じように1年抜き検証で採点した結果が、次の表です。\u003c/p\u003e\n\u003ctable data-sourcepos=\"279:1-284:26\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"279:1-279:61\"\u003e\n\u003cth data-sourcepos=\"279:2-279:9\"\u003eタグ\u003c/th\u003e\n\u003cth data-sourcepos=\"279:11-279:39\"\u003eロジスティック回帰\u003c/th\u003e\n\u003cth data-sourcepos=\"279:41-279:60\"\u003e全体の出現率\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"281:1-281:26\"\u003e\n\u003ctd data-sourcepos=\"281:2-281:9\"\u003e比較\u003c/td\u003e\n\u003ctd data-sourcepos=\"281:11-281:17\"\u003e0.196\u003c/td\u003e\n\u003ctd data-sourcepos=\"281:19-281:25\"\u003e0.225\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"282:1-282:26\"\u003e\n\u003ctd data-sourcepos=\"282:2-282:9\"\u003e称賛\u003c/td\u003e\n\u003ctd data-sourcepos=\"282:11-282:17\"\u003e0.285\u003c/td\u003e\n\u003ctd data-sourcepos=\"282:19-282:25\"\u003e0.270\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"283:1-283:29\"\u003e\n\u003ctd data-sourcepos=\"283:2-283:12\"\u003e物性系\u003c/td\u003e\n\u003ctd data-sourcepos=\"283:14-283:20\"\u003e0.271\u003c/td\u003e\n\u003ctd data-sourcepos=\"283:22-283:28\"\u003e0.265\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"284:1-284:26\"\u003e\n\u003ctd data-sourcepos=\"284:2-284:9\"\u003e留保\u003c/td\u003e\n\u003ctd data-sourcepos=\"284:11-284:17\"\u003e0.159\u003c/td\u003e\n\u003ctd data-sourcepos=\"284:19-284:25\"\u003e0.151\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"286:1-287:72\"\u003e\"比較\"タグだけは、ロジスティック回帰のほうが全体の出現率より小さいスコアになりました。\u003cbr\u003e\nほかのタグでは、やはり全体の出現率に届きません。\u003c/p\u003e\n\u003cp data-sourcepos=\"289:1-289:133\"\u003e\u003ca href=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F3664928%2Fb98148be-0329-46ca-9325-bf58cfbef2c8.png?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=5ececf4adeb2293f1bd2ea12882bd0ed\" target=\"_blank\" rel=\"nofollow noopener\"\u003e\u003cimg src=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F3664928%2Fb98148be-0329-46ca-9325-bf58cfbef2c8.png?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;s=5ececf4adeb2293f1bd2ea12882bd0ed\" alt=\"03_logit_compare.png\" srcset=\"https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F3664928%2Fb98148be-0329-46ca-9325-bf58cfbef2c8.png?ixlib=rb-4.1.1\u0026amp;auto=format\u0026amp;gif-q=60\u0026amp;q=75\u0026amp;w=1400\u0026amp;fit=max\u0026amp;s=464e68d242d7b8bbe8ea71e712799d29 1x\" data-canonical-src=\"https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3664928/b98148be-0329-46ca-9325-bf58cfbef2c8.png\" loading=\"lazy\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cp data-sourcepos=\"292:1-293:95\"\u003e暑い年ほど、比較タグが付く確率が高くなります。\u003cbr\u003e\n2026年の暑さを当てはめると、比較タグが付く確率は0.91になりました。\u003c/p\u003e\n\u003cp data-sourcepos=\"295:1-296:139\"\u003eただし、2026年の暑さは、これまでで最も暑かった2003年をわずかに上回っています。\u003cbr\u003e\nデータの範囲の外まで当てはめている（外挿している）ので、0.91は高めに出ている可能性があります。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"298:1-298:64\"\u003e\n\u003cspan id=\"予想2026年のコピーに入るタグはズバリこれ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E4%BA%88%E6%83%B32026%E5%B9%B4%E3%81%AE%E3%82%B3%E3%83%94%E3%83%BC%E3%81%AB%E5%85%A5%E3%82%8B%E3%82%BF%E3%82%B0%E3%81%AF%E3%82%BA%E3%83%90%E3%83%AA%E3%81%93%E3%82%8C\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003e予想：2026年のコピーに入るタグはズバリこれ\u003c/h2\u003e\n\u003cp data-sourcepos=\"300:1-301:141\"\u003eここまでの結果から、予想のルールを次のように決めました。\u003cbr\u003e\n全体の出現率に勝てた方法がある場合はその方法を使い、ない場合は全体の出現率をそのまま使います。\u003c/p\u003e\n\u003ctable data-sourcepos=\"303:1-308:38\"\u003e\n\u003cthead\u003e\n\u003ctr data-sourcepos=\"303:1-303:53\"\u003e\n\u003cth data-sourcepos=\"303:2-303:9\"\u003eタグ\u003c/th\u003e\n\u003cth data-sourcepos=\"303:11-303:34\"\u003e2026年の予想確率\u003c/th\u003e\n\u003cth data-sourcepos=\"303:36-303:52\"\u003e使った方法\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr data-sourcepos=\"305:1-305:59\"\u003e\n\u003ctd data-sourcepos=\"305:2-305:9\"\u003e比較\u003c/td\u003e\n\u003ctd data-sourcepos=\"305:11-305:16\"\u003e0.91\u003c/td\u003e\n\u003ctd data-sourcepos=\"305:18-305:58\"\u003eロジスティック回帰（暑さ）\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"306:1-306:38\"\u003e\n\u003ctd data-sourcepos=\"306:2-306:9\"\u003e称賛\u003c/td\u003e\n\u003ctd data-sourcepos=\"306:11-306:16\"\u003e0.54\u003c/td\u003e\n\u003ctd data-sourcepos=\"306:18-306:37\"\u003e全体の出現率\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"307:1-307:41\"\u003e\n\u003ctd data-sourcepos=\"307:2-307:12\"\u003e物性系\u003c/td\u003e\n\u003ctd data-sourcepos=\"307:14-307:19\"\u003e0.42\u003c/td\u003e\n\u003ctd data-sourcepos=\"307:21-307:40\"\u003e全体の出現率\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr data-sourcepos=\"308:1-308:38\"\u003e\n\u003ctd data-sourcepos=\"308:2-308:9\"\u003e留保\u003c/td\u003e\n\u003ctd data-sourcepos=\"308:11-308:16\"\u003e0.17\u003c/td\u003e\n\u003ctd data-sourcepos=\"308:18-308:37\"\u003e全体の出現率\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\u003cp data-sourcepos=\"310:1-311:120\"\u003eいちばん入りそうなのは\"比較\"で、次が\"称賛\"です。\u003cbr\u003e\n「◯年以来」「◯年と並ぶ」のような、ほかの年と比べるフレーズが入ると予想します。\u003c/p\u003e\n\u003cp data-sourcepos=\"313:1-315:135\"\u003e\"留保\"（生産者の腕や苦労に触れるもの）は、数字の上では低めです。\u003cbr\u003e\nただ、BSV によると、2026年は6月末に雹の被害がありました。\u003cbr\u003e\n気象データの数字には雹が表れないので、留保のフレーズが入る余地は残っていると考えています。\u003c/p\u003e\n\u003ch2 data-sourcepos=\"317:1-317:49\"\u003e\n\u003cspan id=\"claude-の予想と私も予想してみた\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#claude-%E3%81%AE%E4%BA%88%E6%83%B3%E3%81%A8%E7%A7%81%E3%82%82%E4%BA%88%E6%83%B3%E3%81%97%E3%81%A6%E3%81%BF%E3%81%9F\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eClaude の予想と、私も予想してみた\u003c/h2\u003e\n\u003cp data-sourcepos=\"319:1-320:64\"\u003e最後に、このタグの予想をもとに、実際のコピーを書きました。\u003cbr\u003e\n冒頭に載せた2つのコピーの狙いを説明します。\u003c/p\u003e\n\u003cp data-sourcepos=\"322:1-322:82\"\u003eClaude には、予想表とBSVの要点を渡して書いてもらいました。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"324:1-326:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e2003年を超える太陽の年。歴史に刻まれる、偉大なヴィンテージ\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"328:1-328:106\"\u003e比較（2003年を超える）、外部要因（太陽）、称賛（偉大な）を入れた形です。\u003c/p\u003e\n\u003cp data-sourcepos=\"330:1-330:33\"\u003e私の予想はこちらです。\u003c/p\u003e\n\u003cdiv class=\"code-frame\" data-lang=\"text\" data-sourcepos=\"332:1-334:3\"\u003e\u003cdiv class=\"highlight\"\u003e\u003cpre\u003e\u003ccode\u003e歴史的猛暑が生んだ奇跡！今世紀最高級のヴィンテージ\n\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003c/div\u003e\n\u003cp data-sourcepos=\"336:1-337:126\"\u003eタグの予想をもとに「比較」「称賛」の要素が入ってくると予想しつつ、気候が類似していた2022年、2003年を参考に書いてみました。私なりの\"ボジョレーのキャッチコピー感\"を強めに反映していますw\u003cbr\u003e\n何にせよ、今年が歴史的な猛暑であったことに対する言及が入ることは堅いと思っています。\u003c/p\u003e\n\u003cp data-sourcepos=\"339:1-339:273\"\u003e執筆にあたりボジョレーについていろいろと調べていると、今年のボジョレーに対する期待が高まってきて、かなりオーバーな表現になってしまいましたが、案外当たっているかも？？（とても楽しみ）\u003c/p\u003e\n\u003ch2 data-sourcepos=\"341:1-341:12\"\u003e\n\u003cspan id=\"まとめ\" class=\"fragment\"\u003e\u003c/span\u003e\u003ca href=\"#%E3%81%BE%E3%81%A8%E3%82%81\"\u003e\u003ci class=\"fa fa-link\"\u003e\u003c/i\u003e\u003c/a\u003eまとめ\u003c/h2\u003e\n\u003cp data-sourcepos=\"343:1-343:165\"\u003eボジョレー・ヌーヴォーのキャッチコピーを10種類のタグに分け、気象データとの関係から2026年のコピーを予想しました。\u003c/p\u003e\n\u003cp data-sourcepos=\"345:1-348:129\"\u003e2026年は、この27年でいちばん暑く、雨の少ない年でした。\u003cbr\u003e\n天候から予想できそうなタグは\"比較\"くらいかな、という結論になりました。\u003cbr\u003e\nただ、2026年はこれだけ記録的に暑い年だったので、\"比較\"が入る可能性は高いと見ています。\u003cbr\u003e\n暑い年は当たり年と受け止められ、過去の当たり年と並べて語られやすいのかもしれませんね。\u003c/p\u003e\n\u003cp data-sourcepos=\"350:1-350:43\"\u003e11月19日の解禁日が楽しみです。\u003c/p\u003e\n\u003cp data-sourcepos=\"352:1-352:117\"\u003e普段はスーパーの500円ワインしか飲まないけど、今年はボジョレー買ってみようかな。\u003c/p\u003e\n\u003chr data-sourcepos=\"354:1-355:0\"\u003e\n\u003cp data-sourcepos=\"356:1-357:114\"\u003e最後に補足です。\u003cbr\u003e\n今回はあえて簡単な方法を選んだので、もっと厳密にやるなら？も書いておきます。\u003c/p\u003e\n\u003cul data-sourcepos=\"359:1-367:0\"\u003e\n\u003cli data-sourcepos=\"359:1-359:295\"\u003e気温の期間は、暦の月ではなく、開花や色づきといったブドウの生育段階で区切るのが本来のやり方です。ただ、2026年はどの指標でも27年中1〜2位の暑さなので、区切り方を変えても結論は変わらないと考えています。\u003c/li\u003e\n\u003cli data-sourcepos=\"360:1-360:126\"\u003e気象データは1地点だけなので、地区内の複数の地点を平均したほうが実態に近くなります。\u003c/li\u003e\n\u003cli data-sourcepos=\"361:1-361:169\"\u003e「暑さ」の3指標は同じ重みで平均しました。24本のデータで重みまで決めると、その24本にだけ合った重みになるためです。\u003c/li\u003e\n\u003cli data-sourcepos=\"362:1-362:228\"\u003eタグは、複数の人が別々に付けて一致率を測るのが理想です。実際、2003年の「並外れて」を比較から外すと、2026年に比較タグが付く確率は0.91から0.55まで下がります。\u003c/li\u003e\n\u003cli data-sourcepos=\"363:1-363:154\"\u003eコピーが24本と少ないので、階層ベイズモデルを使ったり、ほかの産地のデータを足したりする方法もあります。\u003c/li\u003e\n\u003cli data-sourcepos=\"364:1-367:0\"\u003e生育レポートも過去の分を集めれば、病気や雹の有無から留保タグを予想する材料になります。\u003c/li\u003e\n\u003c/ul\u003e\n\u003csection class=\"footnotes\"\u003e\n\u003col\u003e\n\u003cli id=\"fn-enoteca\"\u003e\n\u003cp data-sourcepos=\"42:13-42:202\"\u003eエノテカ・オンライン「ボジョレー・ヌーヴォーのキャッチコピー裏話」 \u003ca href=\"https://www.enoteca.co.jp/article/archives/16864/\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://www.enoteca.co.jp/article/archives/16864/\u003c/a\u003e （2026年7月17日更新版を参照） \u003ca href=\"#fnref-enoteca\" class=\"\"\u003e↩\u003c/a\u003e\u003c/p\u003e\n\u003c/li\u003e\n\u003cli id=\"fn-openmeteo\"\u003e\n\u003cp data-sourcepos=\"157:15-157:101\"\u003eOpen-Meteo Historical Weather API \u003ca href=\"https://open-meteo.com/en/docs/historical-weather-api\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://open-meteo.com/en/docs/historical-weather-api\u003c/a\u003e \u003ca href=\"#fnref-openmeteo\" class=\"\"\u003e↩\u003c/a\u003e\u003c/p\u003e\n\u003c/li\u003e\n\u003cli id=\"fn-mcc\"\u003e\n\u003cp data-sourcepos=\"158:9-158:180\"\u003eTonietto, J. \u0026amp; Carbonneau, A. (2004). A multicriteria climatic classification system for grape-growing regions worldwide. Agricultural and Forest Meteorology, 124, 81–97. \u003ca href=\"#fnref-mcc\" class=\"\"\u003e↩\u003c/a\u003e\u003c/p\u003e\n\u003c/li\u003e\n\u003cli id=\"fn-bsv\"\u003e\n\u003cp data-sourcepos=\"173:9-173:245\"\u003eDRAAF Auvergne-Rhône-Alpes「BSV viticulture, édition du territoire Rhône-Alpes」2026年 第9〜16号（第11号を除く）。例: 第14号 \u003ca href=\"https://draaf.auvergne-rhone-alpes.agriculture.gouv.fr/IMG/pdf/bsv-viti-ra-14_30-06-2026.pdf\" class=\"autolink\" rel=\"nofollow noopener\" target=\"_blank\"\u003ehttps://draaf.auvergne-rhone-alpes.agriculture.gouv.fr/IMG/pdf/bsv-viti-ra-14_30-06-2026.pdf\u003c/a\u003e \u003ca href=\"#fnref-bsv\" class=\"\"\u003e↩\u003c/a\u003e\u003c/p\u003e\n\u003c/li\u003e\n\u003c/ol\u003e\n\u003c/section\u003e\n","body":"## はじめに\n\n2026年のボジョレー・ヌーヴォーは、11月19日（木）に解禁されます。\n毎年この時期になると、「今年のボジョレーは◯◯」というキャッチコピーが話題になりますね。\n\nふだんスーパーの500円ワインしか飲まない私は、ワインの味よりこのコピーのほうが気になります。\nそこで今年は、解禁前にキャッチコピーの中身を予想してみることにしました。\n\n使うのは、ボジョレー地区の過去の気象データと、歴代のキャッチコピーです。\n500円ワインの知識しかないのですが、私なりにボジョレーについて調べたうえで、ある程度筋が通っていそうな方法でやっています。\n\nAI に「今年のコピーを予想して」と頼むだけだと面白くないですよね。\n私は統計が好きなので、自分でも計算を追える形で、根拠を持って予想してみたいと思います。\n\n## 先に予想を載せておきます\n\n今回たどり着いたキャッチコピーの予想、ずばりこちらです！\n\nClaudeの予想\n```\n2003年を超える太陽の年。歴史に刻まれる、偉大なヴィンテージ\n```\n私の予想：\n```\n歴史的猛暑が生んだ奇跡！今世紀最高級のヴィンテージ\n```\n\nどちらも、要素としては「ほかの年との比較」と「褒め言葉」が入りそうだ、という計算結果をもとに書いています。\nここから先は、この予想にたどり着くまでの計算を順に説明します。\n\n## ボジョレー・ヌーヴォーのキャッチコピーとは\n\nボジョレー・ヌーヴォーは、フランスのボジョレー地区で、その年に収穫したガメイ種のブドウから造る新酒です。\n解禁日は毎年11月の第3木曜日と決まっています。\n\nキャッチコピーには2つの系統があります。\nエノテカの記事[^enoteca]によると、1つは「現地のボジョレーワイン委員会によるブドウの評価をもとに、フランス食品振興会（SOPEXA）が発表した公式見解を和訳したもの」です。\nもう1つは、その情報をもとに日本で作られたコピーで、こちらは誇大広告気味だと指摘されることもあるそうです。\n\nこの記事では、公式見解のほうを扱います。\n\n[^enoteca]: エノテカ・オンライン「ボジョレー・ヌーヴォーのキャッチコピー裏話」 https://www.enoteca.co.jp/article/archives/16864/ （2026年7月17日更新版を参照）\n\n## 歴代のキャッチコピー\n\nエノテカの記事に載っている公式見解は、次のとおりです。\n\n| 年 | キャッチコピー |\n|---|---|\n| 2000 | 出来は上々で申し分の無い仕上がり |\n| 2001 | ここ10年で最高 |\n| 2002 | 色付きが良く、しっかりとしたボディ |\n| 2003 | 並外れて素晴らしい年 |\n| 2004 | 生産者の実力が表れる年 |\n| 2005 | 59年や64年、76年のように偉大な年の一つ |\n| 2006 | とてもうまくいった年 |\n| 2007 | 果実味が豊かでエレガント |\n| 2008 | フルーツ、フルーツ、フルーツ |\n| 2009 | 数量は少なく、完璧な品質。桁外れに素晴らしい年 |\n| 2010 | 果実味豊かで、滑らかでバランスの取れた |\n| 2011 | 3年連続で、偉大な品質となった |\n| 2012 | 心地よく、偉大な繊細さと複雑味のある香りを持ち合わせた |\n| 2013 | 繊細でしっかりとした骨格。美しく複雑なアロマ |\n| 2014 | エレガントで味わい深く、とてもバランスがよい |\n| 2015 | 記憶に残る素晴らしい出来栄え |\n| 2016 | エレガントで、魅惑的なワイン |\n| 2017 | 豊満で朗らか、絹のようにしなやか。しかもフレッシュで輝かしい |\n| 2018 | 2017年、2015年、2009年と並び、珠玉のヴィンテージとして歴史に刻まれるでしょう |\n| 2019 | 有望だが、生産者のテクニックが重要な年 |\n| 2020 | 非常にバランスが取れた爽やかさのある仕上がり |\n| 2021 | 挑戦の末たどり着いた、納得のヌーヴォー |\n| 2022 | 太陽に恵まれたヴィンテージ 果実味とストラクチュアの完璧なバランス |\n| 2023 | （発表なし） |\n| 2024 | 努力と多様性のヴィンテージ！ |\n\n2023年は記事に「発表なし」とあり、2025年は掲載がありません。\nそのため、この記事で使うのは2000〜2024年のうち2023年を除いた24本です。\n\n## 今回やること\n\n正解データが24しかないため、キャッチコピーの文面そのものを当てるのはさすがに無理がありそうです。\nそこで今回は、コピーを「どんな要素が入っているか」に分けて、要素ごとに予想することにしました。\nつまり、タグをつけてタグを予測するということです。\n\nたとえば2022年の「太陽に恵まれたヴィンテージ 果実味とストラクチュアの完璧なバランス」には、次の4つの要素が入っています。\n\n- 天候への言及（太陽に恵まれた）\n- 果実の風味（果実味）\n- 渋みからくるしっかり感（ストラクチュア）\n- 要素どうしの調和（バランス）\n\nこの要素を「タグ」として24本すべてに付け、気象データとの関係を調べます。\n2026年の気象がどの年に近いかが分かれば、今年のコピーに入りそうなタグも予想できるはずです。\n\n## 歴代のキャッチコピーに付けたタグ\n\nタグは次の10種類です。\n\n| タグ | 中身 | 語の例 |\n|---|---|---|\n| 果実味 | 果実の風味や香り | 果実味、フルーツ、アロマ、香り |\n| ボディ | 口の中で感じる厚みやなめらかさ | ボディ、豊満、滑らか、絹のよう |\n| 酸味 | 酸からくる爽やかさ | フレッシュ、爽やか、輝かしい |\n| 骨格 | 渋みからくるしっかり感 | 骨格、ストラクチュア |\n| バランス | 要素どうしの調和 | バランス、調和 |\n| 色調 | 見た目の色 | 色付き |\n| 称賛 | 中身を特定しない褒め言葉 | 素晴らしい、偉大、エレガント |\n| 比較 | ほかの年との比較や希少性 | ここ10年で最高、◯年と並び、3年連続 |\n| 留保 | 手放しで褒めず、条件や苦労に触れる | 生産者の実力、挑戦、努力 |\n| 外部要因 | 天候や収量への言及 | 太陽、数量は少なく |\n\n1つのコピーにつき、それぞれのタグが該当するか、0/1のフラグを立てるイメージです。\nタグ付けは Claude にやってもらったうえで、私も目で確認しました。\n判断に迷う箇所もいくつかありましたが、ざっくりで進めます。\n\n出現回数は次のとおりです。\n\n![01_tag_counts.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3664928/4f4790bf-da99-4744-9789-710519ef1801.png)\n\n\n一番多いのは\"称賛\"で、24本中13本に入っていました。\n意外だったのは\"酸味\"の少なさで、24本中2本しかありません。\nヌーヴォーは酸のフレッシュさが大事なワインと言われますが、コピーで酸味が触れられた年は実はそんなになかったようです。\n\nボジョレーのキャッチコピーと聞くと、「◯年に一度の出来」のような、ほかの年と比べるフレーズを思い浮かべる人も多いと思います。\n公式見解のほうでも、\"比較\"は24本中7本に入っていて、\"称賛\"の次に多いタグでした。\nこの比較タグが、今回の予想の中心になります。\n\n## 使ったデータ\n\n### 気象データ\n\nOpen-Meteo の過去気象API[^openmeteo]から、ボジョレー地区の日ごとの気温と降水量を取得しました。\n地点は北緯46.0度、東経4.6度の1点で、期間は2000年1月1日から2026年11月10日までです。\n\nこのデータから、年ごとに次の4つの数字を作りました。\n\n| 指標 | 意味 |\n|---|---|\n| 4〜9月の平均気温 | 生育期間全体の暑さ |\n| 7〜8月に最高気温が30℃を超えた日数 | 実が熟す時期の猛暑の多さ |\n| 8月の最低気温の平均 | 夜の暑さ |\n| 4〜9月の降水量 | 生育期間の雨の多さ |\n\nブドウのドメイン知識を多少勉強してみた結果、出来に関わる要素として「気温と降水量」が大きそうと睨みました。\n\n暑い年ほどブドウに糖がたまり、アルコールが高く厚みのあるワインになります。\n一方で、30℃を超える日が続くと、ブドウはリンゴ酸を呼吸で使ってしまい、酸が減ります。\n夜が涼しいと酸と香りが残りやすく、熱帯夜が続くと夜のあいだも酸が減ります。\n雨が多いと病気や腐敗が増え、果汁も薄まります。\n\nヌーヴォーは房ごと短期間で発酵させて、すぐに出荷します。\n醸造でブドウの出来を補う余地が小さいので、その年の天候がワインにそのまま出やすいと考えられます。\n\nなお、この4つは、ワインの気候研究で使われる標準的な指標[^mcc]（ヒュグリン指数、冷涼夜指数、乾燥指数）を参考にしたものです。\n\n[^openmeteo]: Open-Meteo Historical Weather API https://open-meteo.com/en/docs/historical-weather-api\n[^mcc]: Tonietto, J. \u0026 Carbonneau, A. (2004). A multicriteria climatic classification system for grape-growing regions worldwide. Agricultural and Forest Meteorology, 124, 81–97.\n\n### ブドウの生育レポート\n\nもう1つの材料として、フランスの地方農業局（DRAAF オーヴェルニュ＝ローヌ＝アルプ）が出しているブドウの病害速報（BSV）[^bsv]を使いました。\n生育の進み具合や病気の発生状況が、週ごとにまとめられています。\n\nこちらに関しては、24年分のレポートを集計して学習データにするのは非常に手間がかかるので、今回は2026年分を読んで補足に使うだけにしました。\n2026年の要点は次のとおりです。\n\n- 5月27日時点で、大多数の区画が開花期だった\n- 6月28〜29日の雷雨で、ボジョレーの複数のコミューン（村）に雹の被害があった\n- うどんこ病などの病気は出ていたが、全体として低い水準だった\n- 7月上旬に実の色づきが始まった\n\n[^bsv]: DRAAF Auvergne-Rhône-Alpes「BSV viticulture, édition du territoire Rhône-Alpes」2026年 第9〜16号（第11号を除く）。例: 第14号 https://draaf.auvergne-rhone-alpes.agriculture.gouv.fr/IMG/pdf/bsv-viti-ra-14_30-06-2026.pdf\n\n## 2026年はどんな年だったか\n\nまず、ボジョレー地区の2026年の4つの指標を、2000〜2025年と比べます。\n\n| 指標 | 2026年 | 2000〜2025年の平均 | 27年中の順位 |\n|---|---|---|---|\n| 4〜9月の平均気温 | 20.05℃ | 17.22℃ | 1位 |\n| 7〜8月の30℃超えの日数 | 31日 | 11.6日 | 1位 |\n| 8月の最低気温の平均 | 18.36℃ | 15.65℃ | 2位 |\n| 4〜9月の降水量 | 269mm | 446mm | 27位（最少） |\n\nボジョレー地区の2026年は、**この27年でいちばん暑く**、**いちばん雨の少ない**年でした。\n猛暑だったと言われている2003年と比べても、4〜9月の平均気温は0.7℃高くなっています。\n\n## ①タグで集計して気候データのばらつきを見てみる\n\n最初に、タグごとに「タグが付いた年」と「付かなかった年」で、暑さと雨の平均を比べました。\n\nここで、気温系の3つの指標はまとめて1つの「暑さ」として扱っています。\nこの3つは互いの相関が0.7〜0.8と高く、ほぼ同じものを測っているからです。\n具体的には、各指標を平均0・標準偏差1にそろえた値（zスコア）にしてから、3つを平均しました。\n降水量も同じようにzスコアにして、「雨」の軸にしています。\nこのあとの図で横軸の「暑さ」と書いているのは、この3指標の平均です。\n\n差が偶然の範囲かどうかは、並べ替え検定で確かめました。\nタグの「あり・なし」をランダムに入れ替えて差を計算する作業を10万回繰り返します。\nそのうえで、実際の差と同じかそれ以上の大きさの差（向きは問わない）が偶然に出る割合を p値としました。\n\n| タグ | 出現 | 暑さの差 | p値 | 雨の差 | p値 |\n|---|---|---|---|---|---|\n| 物性系（果実味〜色調のどれか） | 10/24 | −0.44 | 0.27 | +0.31 | 0.48 |\n| 称賛 | 13/24 | +0.31 | 0.44 | −0.09 | 0.84 |\n| 比較 | 7/24 | +0.91 | 0.025 | −0.80 | 0.08 |\n| 留保 | 4/24 | −0.42 | 0.43 | +0.44 | 0.46 |\n\n差の単位は標準偏差です。\nはっきりした差が出たのは、\"比較\"タグと「暑さ」の組み合わせだけでした。\n\"比較\"のフレーズが付いた年は、付かなかった年より標準偏差0.9個分ほど暑かったことになります。\n\n※ただし、表の4つのほかに果実味とバランスも調べていて、全部で12通りの組み合わせを検定しています。12回も試せば、どれか1つで p\u003c0.05となる値が偶然出ることは珍しくありません。なので、ここでは「\"比較\"タグと暑さには関係がありそう」くらいの理解です。\n\n## ②気候データで年ごとの類似度を見てみる\n\n次に、2026年と天候が近い年を探しました。\n「暑さ」と「雨」の2つの軸で、各年と2026年の距離（ユークリッド距離）を計算し、近い順に5年を選んでいます。\n\n![02_heat_rain.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3664928/fe75c7b6-3295-4b01-8b50-c8ec5e9287b5.png)\n\n\n2026年に近いのは、2003年、2018年、2020年、2022年、2009年の5年でした。\n図では、2026年は右下の端にあります。\nいちばん近いのは2003年ですが、2026年はそれよりさらに暑く、雨も少ない位置にあります。\n\nこの5年で各タグが付いた割合を、2026年の予想とします。\n\n| タグ | 近い5年での出現率 | 24年全体の出現率 |\n|---|---|---|\n| 物性系 | 0.4 | 0.42 |\n| 称賛 | 0.6 | 0.54 |\n| 比較 | 0.6 | 0.29 |\n| 留保 | 0.0 | 0.17 |\n\n\"比較\"タグは全体の出現率は3割弱であるものの、気候が近い5年の中においては6割でした。\n①と同じく、暑い年ほど\"比較\"のフレーズが付く傾向が見えます。\n\n\n## ③実際に気候データからタグを予測してみる！\n\n本丸の分析です。\n\n②の「近い年から予想する」方法が、本当に当たるのかを確かめます。\n2026年の答えはまだ分からないので、過去の年で試すことにしました。\nやり方は「1年抜き検証」と呼ばれるもので、答えを知らないふりをして過去の年を予想します。\n\n2018年を例に、手順を説明します。\n\n1. 2018年のコピーを隠して、残りの23年だけを手元に置きます\n2. 23年の中から、2018年と天候が近い5年を選びます（2020、2019、2022、2009、2011年）\n3. この5年のうち2年に\"比較\"タグがあるので、2018年に\"比較\"が付く確率を0.4と予想します\n4. 実際の2018年のコピーには\"比較\"があった（1）ので、予想の外れ具合を (1 − 0.4)² = 0.36 と計算します\n\nこの外れ具合をブライアースコアといいます。\n予想した確率と実際の0/1の差を2乗したもので、小さいほど当たっていることになります。\n\n同じことを2000年から2024年まで24年分繰り返し、ブライアースコアを平均します。\n比べる相手は、「残り23年でタグが付いた割合を、そのまま予想に使う」という単純な方法です。\n2018年の例なら、残り23年のうち6年に\"比較\"があるので、予想は0.26、スコアは (1 − 0.26)² = 0.55 です。\n2018年については近い5年のほうが当たっていますが、24年分を平均するとどうなるでしょうか。\n\n| タグ | 近い5年の平均 | 全体の出現率 |\n|---|---|---|\n| 物性系 | 0.360 | 0.265 |\n| 称賛 | 0.342 | 0.270 |\n| 比較 | 0.277 | 0.225 |\n| 留保 | 0.168 | 0.151 |\n\n結果は、すべてのタグで「近い5年の平均」の負けでした。\n5年分しか使わないので、たまたま選ばれた年に予想が大きく左右されたのだと考えられます。\n天候の近い年を選んだ利点よりも、年の選ばれ方によるぶれのほうが大きかったことになります。\n\nそこで、全24年を使う方法も試しました。\n暑さ1つだけを説明変数にしたロジスティック回帰で、タグが付く確率を予想します。\n同じように1年抜き検証で採点した結果が、次の表です。\n\n| タグ | ロジスティック回帰 | 全体の出現率 |\n|---|---|---|\n| 比較 | 0.196 | 0.225 |\n| 称賛 | 0.285 | 0.270 |\n| 物性系 | 0.271 | 0.265 |\n| 留保 | 0.159 | 0.151 |\n\n\"比較\"タグだけは、ロジスティック回帰のほうが全体の出現率より小さいスコアになりました。\nほかのタグでは、やはり全体の出現率に届きません。\n\n![03_logit_compare.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3664928/b98148be-0329-46ca-9325-bf58cfbef2c8.png)\n\n\n暑い年ほど、比較タグが付く確率が高くなります。\n2026年の暑さを当てはめると、比較タグが付く確率は0.91になりました。\n\nただし、2026年の暑さは、これまでで最も暑かった2003年をわずかに上回っています。\nデータの範囲の外まで当てはめている（外挿している）ので、0.91は高めに出ている可能性があります。\n\n## 予想：2026年のコピーに入るタグはズバリこれ\n\nここまでの結果から、予想のルールを次のように決めました。\n全体の出現率に勝てた方法がある場合はその方法を使い、ない場合は全体の出現率をそのまま使います。\n\n| タグ | 2026年の予想確率 | 使った方法 |\n|---|---|---|\n| 比較 | 0.91 | ロジスティック回帰（暑さ） |\n| 称賛 | 0.54 | 全体の出現率 |\n| 物性系 | 0.42 | 全体の出現率 |\n| 留保 | 0.17 | 全体の出現率 |\n\nいちばん入りそうなのは\"比較\"で、次が\"称賛\"です。\n「◯年以来」「◯年と並ぶ」のような、ほかの年と比べるフレーズが入ると予想します。\n\n\"留保\"（生産者の腕や苦労に触れるもの）は、数字の上では低めです。\nただ、BSV によると、2026年は6月末に雹の被害がありました。\n気象データの数字には雹が表れないので、留保のフレーズが入る余地は残っていると考えています。\n\n## Claude の予想と、私も予想してみた\n\n最後に、このタグの予想をもとに、実際のコピーを書きました。\n冒頭に載せた2つのコピーの狙いを説明します。\n\nClaude には、予想表とBSVの要点を渡して書いてもらいました。\n\n```\n2003年を超える太陽の年。歴史に刻まれる、偉大なヴィンテージ\n```\n\n比較（2003年を超える）、外部要因（太陽）、称賛（偉大な）を入れた形です。\n\n私の予想はこちらです。\n\n```\n歴史的猛暑が生んだ奇跡！今世紀最高級のヴィンテージ\n```\n\nタグの予想をもとに「比較」「称賛」の要素が入ってくると予想しつつ、気候が類似していた2022年、2003年を参考に書いてみました。私なりの\"ボジョレーのキャッチコピー感\"を強めに反映していますw\n何にせよ、今年が歴史的な猛暑であったことに対する言及が入ることは堅いと思っています。\n\n執筆にあたりボジョレーについていろいろと調べていると、今年のボジョレーに対する期待が高まってきて、かなりオーバーな表現になってしまいましたが、案外当たっているかも？？（とても楽しみ）\n\n## まとめ\n\nボジョレー・ヌーヴォーのキャッチコピーを10種類のタグに分け、気象データとの関係から2026年のコピーを予想しました。\n\n2026年は、この27年でいちばん暑く、雨の少ない年でした。\n天候から予想できそうなタグは\"比較\"くらいかな、という結論になりました。\nただ、2026年はこれだけ記録的に暑い年だったので、\"比較\"が入る可能性は高いと見ています。\n暑い年は当たり年と受け止められ、過去の当たり年と並べて語られやすいのかもしれませんね。\n\n11月19日の解禁日が楽しみです。\n\n普段はスーパーの500円ワインしか飲まないけど、今年はボジョレー買ってみようかな。\n\n---\n\n最後に補足です。\n今回はあえて簡単な方法を選んだので、もっと厳密にやるなら？も書いておきます。\n\n- 気温の期間は、暦の月ではなく、開花や色づきといったブドウの生育段階で区切るのが本来のやり方です。ただ、2026年はどの指標でも27年中1〜2位の暑さなので、区切り方を変えても結論は変わらないと考えています。\n- 気象データは1地点だけなので、地区内の複数の地点を平均したほうが実態に近くなります。\n- 「暑さ」の3指標は同じ重みで平均しました。24本のデータで重みまで決めると、その24本にだけ合った重みになるためです。\n- タグは、複数の人が別々に付けて一致率を測るのが理想です。実際、2003年の「並外れて」を比較から外すと、2026年に比較タグが付く確率は0.91から0.55まで下がります。\n- コピーが24本と少ないので、階層ベイズモデルを使ったり、ほかの産地のデータを足したりする方法もあります。\n- 生育レポートも過去の分を集めれば、病気や雹の有無から留保タグを予想する材料になります。\n\n\n\n","coediting":false,"comments_count":0,"created_at":"2026-11-18T01:10:59+09:00","group":null,"id":"7e90fbe766fe7458c683","likes_count":0,"private":false,"reactions_count":0,"stocks_count":0,"tags":[{"name":"ボジョレーヌーボー","versions":[]},{"name":"自然言語処理","versions":[]},{"name":"ロジスティック回帰","versions":[]},{"name":"データ分析","versions":[]}],"title":"ボジョレー・ヌーヴォー2026のキャッチコピーをデータから予測してみた","updated_at":"2026-11-18T01:10:59+09:00","url":"https://qiita.com/bokkuzu/items/7e90fbe766fe7458c683","user":{"description":null,"facebook_id":null,"followees_count":8,"followers_count":0,"github_login_name":null,"id":"bokkuzu","items_count":11,"linkedin_id":null,"location":null,"name":"","organization":null,"permanent_id":3664928,"profile_image_url":"https://s3-ap-northeast-1.amazonaws.com/qiita-image-store/0/3664928/45fd130e2809de1099ef15a10eb80dd11b19c239/x_large.png?1752995708","team_only":false,"twitter_screen_name":null,"website_url":null},"page_views_count":null,"team_membership":null,"organization_url_name":null,"slide":false,"posting_campaign_uuid":null}]