https://cheroliv.com/ JBake Bootstrap テンプレート en-gb Thu, 8 Oct 2026 11:37:55 +0000 Thu, 8 Oct 2026 11:37:55 +0000 https://cheroliv.com/blog/2026/0126_hyperframes_asciidoc_video_post.html Sun, 31 May 2026 00:00:00 +0000 blog/2026/0126_hyperframes_asciidoc_video_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_ビデオパイプラインの穴">ビデオパイプラインの穴</a></li> <li><a href="#_hyperframes_エンジン">HyperFrames : エンジン</a></li> <li><a href="#_プラグインのアーキテクチャ">プラグインのアーキテクチャ</a> <ul class="sectlevel2"> <li><a href="#_4段階のパイプライン">4段階のパイプライン</a></li> <li><a href="#_asciidoc_dsl">AsciiDoc DSL</a></li> <li><a href="#_node_js_ブリッジ">Node.js ブリッジ</a></li> </ul> </li> <li><a href="#_2つのビデオプラグイン2つの使い方">2つのビデオプラグイン、2つの使い方</a></li> <li><a href="#_ロードマップの6つのepic">ロードマップの6つのEPIC</a></li> <li><a href="#_なぜそれが機能するのか">なぜそれが機能するのか</a></li> <li><a href="#_結論_欠けているリンク">結論 : 欠けているリンク</a></li> <li><a href="#_参考文献">参考文献</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 8 minutes</div> <p>二週間前に、私は開始しました。<code>capsule-gradle</code>— デッキを変換するプラグイン reveal.js を WebM ビデオカプセルに TTS 付きで。今日、私は新しいプラグインを追加します: <code>hyperframes-gradle</code>. それは capsule-gradle が行わないことをしている： AsciiDoc を <strong>直接的に</strong> MP4 動画に変換し、reveal.js を経由せずに。</p> </div> <div class="paragraph"> <p>なぜこのプラグインが存在するのか、そしてそれが既存のものにどのように組み込まれるかを示します。 HeyGenのHyperFramesエンジンがコンテンツ制作パイプラインにもたらすもの</p> </div> </div> </div> <div class="sect1"> <h2 id="_ビデオパイプラインの穴">ビデオパイプラインの穴</h2> <div class="sectionbody"> <div class="paragraph"> <p>私のドキュメンタリーパイプラインは2種類のビデオを生成します :</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>復習カプセル</strong> (capsule-gradle) — WebM でキャプチャされた reveal.js のデッキと共に</p> </li> </ol> </div> <div class="paragraph"> <p>narration TTS. モジュールの復習に最適です。</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>アニメーションスライド</strong> (slider-gradle) — インタラクティブな reveal.js HTML デッキのために</p> </li> </ol> </div> <div class="paragraph"> <p>対面の講師。</p> </div> <div class="paragraph"> <p>しかし、３番目のフォーマットが欠けています：<strong>スタンドアロン動画</strong>。</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 5.5555%;"> <col style="width: 5.5555%;"> <col style="width: 5.5555%;"> <col style="width: 5.5555%;"> <col style="width: 5.5555%;"> <col style="width: 5.5555%;"> <col style="width: 5.5555%;"> <col style="width: 5.5555%;"> <col style="width: 5.5555%;"> <col style="width: 5.5555%;"> <col style="width: 5.5555%;"> <col style="width: 5.5555%;"> <col style="width: 5.5555%;"> <col style="width: 5.5555%;"> <col style="width: 5.5555%;"> <col style="width: 5.5555%;"> <col style="width: 5.5555%;"> <col style="width: 5.5565%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ユースケース</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">現在の解決策</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">不足</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">インストラクター用スライド</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">slider-gradle → reveal.js</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�✅</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">カプセルの復習</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">capsule-gradle → WebM</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ティーザー動画</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ない</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�❌</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>アニメーション技術デモ</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">なし</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�❌</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ドキュメントからビデオへ</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>なし</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">❌</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>最初のユースケースは重要です：自動的に生成するにはどうすればよいですか？ 60秒のビデオで、プロジェクトまたはモジュールを紹介し、GSAPアニメーションを使用して、 ナレーションTTS、およびバックグラウンドミュージック — すべて同じAsciiDocファイルから スライドはどうですか？</p> </div> <div class="paragraph"> <p>Capsule-gradleは応答できません：それには <strong>déjà</strong> reveal.jsのデッキが必要です。 slider-gradle はこのデッキをうまく生成しますが、動画レンダリングのために設計されていません。 必要だったパイプライン <strong>direct</strong> : AsciiDoc → ビデオ。</p> </div> </div> </div> <div class="sect1"> <h2 id="_hyperframes_エンジン">HyperFrames : エンジン</h2> <div class="sectionbody"> <div class="paragraph"> <p>見つけたhttps://github.com/heygen-com/hyperframes[ハイパーフレーム] il y a 数日間。これはヘイゲンによって作成されたオープンソースのフレームワーク（Apache 2.0）で AIビデオのユニコーン。GitHubで22,700の星。ピッチは 文 :</p> </div> <div class="quoteblock"> <blockquote> <div class="paragraph"> <p><strong>HTMLを書く。ビデオをレンダリング。エージェント向けに構築。</strong></p> </div> </blockquote> </div> <div class="paragraph"> <p>原則：あなたは HTML を書きます（…と）`data-*`属性、あなたは参照します GSAP（または CSS、Lottie、Three.js…）のアニメーションで、エンジンがすべてを MP4 としてレンダリングします Puppeteer (ヘッドレス Chrome) + FFmpeg を介して。決定的な結果 : 同じ入力, 同じフレーム、同じビデオ。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><div id="stage" data-composition-id="intro" data-start="0" data-width="1920" data-height="1080"> <video class="clip" data-start="0" data-duration="6" data-track-index="0" src="background.mp4" muted playsinline></video> <h1 id="title" class="clip" data-start="1" data-duration="4" data-track-index="1"> Formation Docker & Kubernetes </h1> <audio data-start="0" data-duration="6" data-track-index="2" data-volume="0.3" src="music.wav"></audio> <script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script> <script> const tl = gsap.timeline({ paused: true }); tl.from("#title", { opacity: 0, y: 40, duration: 0.8 }, 1); window.__timelines = window.__timelines || {}; window.__timelines.intro = tl; </script> </div></code></pre> </div> </div> <div class="paragraph"> <p>HyperFrames と Remotion の違いは何ですか？React なし、 bundler、JSXはなし。AIエージェントがネイティブに書ける素のHTML。 これは私のパイプラインに <strong>まさに</strong> ぴったり合っています : planner-gradle と deepseek これは SPG/SPD プランからこの HTML を生成し、Gradle プラグインも使用できます それをMP4に変換できる</p> </div> </div> </div> <div class="sect1"> <h2 id="_プラグインのアーキテクチャ">プラグインのアーキテクチャ</h2> <div class="sectionbody"> <div class="paragraph"> <p>hyperframes-gradle すべてのプラグインと同じパターンに従います： この <a href="0124_architecture_plugin_gradle_racine_consommateur_independant_post.html">pattern « 独立プラグイン + コンシューマー ルート 」</a>.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">hyperframes-gradle/ ├── settings.gradle.kts ← racine consommateur (dogfood) ├── build.gradle.kts ← 3 lignes : apply plugin hyperframes ├── hyperframes-plugin/ ← BUILD INDÉPENDANT │ ├── gradlew ← son propre wrapper │ ├── build.gradle.kts ← java-gradle-plugin │ ├── src/main/kotlin/education/cccp/hyperframes/ │ │ ├── HyperframesPlugin.kt │ │ ├── GenerateHyperframesHtmlTask.kt │ │ ├── RenderHyperframesTask.kt │ │ └── HyperframesExtension.kt │ ├── .agents/ ← gouvernance agent │ └── doc/ │ └── HYPERFRAMES_ARCHITECTURE.adoc └── video.yml ← configuration dogfood</code></pre> </div> </div> <div class="sect2"> <h3 id="_4段階のパイプライン">4段階のパイプライン</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultFontSize 11 title パイプライン hyperframes-gradle rectangle "AsciiDoc ソース" as adoc #LightYellow rectangle "AsciidoctorJ" as asciidoctorj #LightBlue rectangle "HTMLハイパーフレーム\n(data-*属性)" as html #LightGreen rectangle "HyperFrames CLI (Node.js 22+)" as cli #Lavender rectangle "video.mp4" as mp4 #Gold adoc -right-> asciidoctorj : parse blocs customs asciidoctorj -right-> html : génère HTML html -right-> cli : ProcessBuilder\nnpx hyperframes render cli -right-> mp4 : Puppeteer + FFmpeg @enduml</pre> </div> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>AsciidoctorJ</strong> は AsciiDoc ソースを解析し、カスタム ブロックを抽出します</p> </li> </ol> </div> <div class="paragraph"> <p><code>[hyperframes-composition]</code>, <code>[hyperframes-track]</code>, <code>[hyperframes-animation]</code>.</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>GenerateHyperframesHtmlTask</strong> は HyperFrames HTML を生成します とともに</p> </li> </ol> </div> <div class="paragraph"> <p>`data-*`対応する属性。</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>*RenderHyperframesTask*はHyperFrames CLIを経由して呼び出す`ProcessBuilder`:</p> </li> </ol> </div> <div class="paragraph"> <p><code>npx hyperframes render --input index.html --output video.mp4</code>。</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>MP4は展開されます`output/`と`metadata.json`オーケストレーションのために</p> </li> </ol> </div> </div> <div class="sect2"> <h3 id="_asciidoc_dsl">AsciiDoc DSL</h3> <div class="paragraph"> <p>プラグインの本当の付加価値は、AsciiDoc DSLです。ユーザー 彼は決してHTMLを書きません。彼は既存のAsciiDocドキュメントに注釈を付けます：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">= Formation Docker & Kubernetes :hyperframes-width: 1920 :hyperframes-height: 1080 :hyperframes-fps: 30 [hyperframes-composition, id="intro"] == Introduction Le titre apparaît avec un fondu GSAP sur fond vidéo. [hyperframes-track, index=0, start=0, duration=6] video::assets/background.mp4[muted, playsinline] [hyperframes-track, index=1, start=1, duration=4] Formation Docker & Kubernetes [hyperframes-animation, type=gsap]</code></pre> </div> </div> <div class="paragraph"> <p>const tl = gsap.timeline({ paused: true }); tl.from("#title", { opacity: 0, y: 40, duration: 0.8 }, 1); window.<em>timelines = window.</em>timelines || {}; window.__timelines.intro = tl;</p> </div> <div class="paragraph"> <p>docinfo属性 (<code>:hyperframes-width:</code>) ディメンションを設定します。 カスタムブロックは構成とトラックを定義します。ブロック `[hyperframes-animation]`生のGSAPコードを含んでいる — AIエージェントが 自然言語の説明から生成できる。</p> </div> </div> <div class="sect2"> <h3 id="_node_js_ブリッジ">Node.js ブリッジ</h3> <div class="paragraph"> <p>唯一の技術的な摩擦ポイント：HyperFramesはNode.js/TypeScriptで実装されています、 そして私のプラグインはKotlin/JVMで書かれています。解決策は`ProcessBuilder` :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class RenderHyperframesTask : DefaultTask() { @TaskAction fun render() { val process = ProcessBuilder( "npx", "hyperframes", "render", "--input", inputHtml.absolutePath, "--output", outputMp4.absolutePath ) .inheritIO() .start() val exitCode = process.waitFor() require(exitCode == 0) { "HyperFrames render failed with exit code $exitCode" } } }</code></pre> </div> </div> <div class="paragraph"> <p>JVMコードとNode.jsの間の結合はゼロです。契約はコマンドラインで行われます。 およびディスク上のファイル。これは同じパターンです。<code>plantuml-gradle</code> (PlantUML CLIを呼び出す) または`slider-gradle`（AsciidoctorJを呼び出す）。 太陽の下に新しいものは何もない — ただ新しいツールに適用されているだけだ。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_2つのビデオプラグイン2つの使い方">2つのビデオプラグイン、2つの使い方</h2> <div class="sectionbody"> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.7619%;"> <col style="width: 4.762%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">カプセル-gradle</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">hyperframes-gradle</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">出典</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Deck reveal.js (既存のHTML)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">AsciiDoc → HTML HyperFrames</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ユースケース</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">復習カプセル</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">スタンドアロン説明動画</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">自然</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">スライド → ビデオ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ドキュメント → ビデオ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">レンダリングされた</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Playwright Java → WebM</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">HyperFrames CLI → MP4</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">アニメーション</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">トランジション reveal.js ネイティブ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">GSAP/CSSデータ属性</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">スタック</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">100% JVM (Kotlin)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">JVM + Node.js外部CLI</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>彼らは互いに置き換わらない。彼らは互いに補完し合う。完全なバリューチェーン：</p> </div> <div class="paragraph"> <p>AsciiDoc ──→ slider-gradle ──→ deck reveal.js ──→ capsule-gradle ──→ WebM (復習カプセル)</p> </div> <div class="paragraph"> <p>AsciiDoc ──→ hyperframes-gradle ──→ MP4 (ビデオ スタンドアローン)</p> </div> <div class="paragraph"> <p>ユーザーは単一のAsciiDocファイルを書きます。slider-gradleはスライドを生成します。 capsule-gradle はレビュー用カプセルを生成します。 hyperframes-gradle は ティーザー映像と技術デモ。</p> </div> </div> </div> <div class="sect1"> <h2 id="_ロードマップの6つのepic">ロードマップの6つのEPIC</h2> <div class="sectionbody"> <div class="paragraph"> <p>プラグインは6つのEPICに構造化されています：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1682%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">エピック</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">説明</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">優先</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">HF-0</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Bootstrap ガバナンス + アーキテクチャのフレーミング</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�✅ 終了</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">HF-1</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Gradle スタブプラグイン + AsciidoctorJ 統合</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">P0</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">HF-2</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Bridge CLI HyperFrames（ProcessBuilder → npx → MP4）</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">P1</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">HF-3</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">DSL AsciiDoc の慣習 (ブロック、docinfo、テンプレート)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">P1</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">HF-4</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ランナー Gradle の統合 (metadata.json)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">P2</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">HF-5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">すぐに使えるテンプレート (title-card, code-diff, captions)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">P3</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">HF-6</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">CI + Maven Central / Gradle Portal への公開</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">P3</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>セッション000（bootstrap）は既に完了しました。セッション001はHF-1を攻撃します： Gradle プラグインのスタブと AsciidoctorJ の統合。</p> </div> </div> </div> <div class="sect1"> <h2 id="_なぜそれが機能するのか">なぜそれが機能するのか</h2> <div class="sectionbody"> <div class="paragraph"> <p>三つの理由：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>HyperFramesは"built for agents"</strong> 私のパイプラインはAIエージェントに基づいています</p> </li> </ol> </div> <div class="paragraph"> <p>(planner-gradle + deepseek) コンテンツを生成する. HyperFrames 受け入れる HTMLの素 — LLMが最も得意とするフォーマット。Reactはなく、 JSXについては、エージェントに学習曲線はありません。</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>*AsciiDoc DSLは自然です。 私のエコシステム全体がAsciiDocを話します。</p> </li> </ol> </div> <div class="paragraph"> <p>slider-gradle, codex-gradle, training-gradle — すべてが消費している`.adoc`。 カスタムブロックを追加`[hyperframes-composition]`拡張機能です 論理的で、断絶ではない。</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>Node.jsブリッジは確立されたパターンです</strong>. JVM外のProcessBuilder,</p> </li> </ol> </div> <div class="paragraph"> <p>これが私がPlantUML、Graphviz、Piperのために既にやっていることです。 HyperFramesを追加 アーキテクチャに何も変更を加えません — 外部ツールがひとつ増えるだけです Gradle から制御されています</p> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="ℹ️"></i> </td> <td class="content"> <div class="paragraph"> <p>パターンの本当の強みは、<strong>aucune</strong> npm の依存関係がないということです Gradleビルド。プラグインはNode.jsコードをインポートしません。それは実行します シェルコマンド。HyperFrames が進化または故障した場合、プラグインは結合されません。 — コマンドを更新するだけです。</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_結論_欠けているリンク">結論 : 欠けているリンク</h2> <div class="sectionbody"> <div class="paragraph"> <p>hyperframes-gradleを使って、私のビデオパイプラインは完了です。私は：</p> </div> <div class="ulist"> <ul> <li> <p>インタラクティブなスライド（slider-gradle）</p> </li> <li> <p>これらの*復習カプセル* (capsule-gradle)</p> </li> <li> <p><strong>スタンドアロン動画</strong> (hyperframes-gradle)</p> </li> </ul> </div> <div class="paragraph"> <p>3つのフォーマット。1つのソースファイル：AsciiDoc。</p> </div> <div class="paragraph"> <p>次の目標はHF-1：プラグインをコンパイルして生成する 注釈が付いたAsciiDocドキュメントからの最初のHTML HyperFrames。 セッション 001はすでに構図が決まっている。</p> </div> <div class="paragraph"> <p>hyperframes-gradleは存在します。ガバナンスは整っています。バックログ 書かれています。 アーキテクチャは文書化されています。 プラグインが生まれました。</p> </div> </div> </div> <div class="sect1"> <h2 id="_参考文献">参考文献</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="0124_architecture_plugin_gradle_racine_consommateur_independant_post.html">Article 0124 — 独立プラグインアーキテクチャ + コンシューマー ルート</a></p> </li> <li> <p><a href="https://github.com/heygen-com/hyperframes">ハイパーフレーム — GitHub</a></p> </li> <li> <p><a href="https://hyperframes.heygen.com/introduction">HyperFrames — ドキュメンテーション</a></p> </li> <li> <p><code>foundry/public/hyperframes-gradle/hyperframes-plugin/doc/HYPERFRAMES_ARCHITECTURE.adoc</code>— 詳細なアーキテクチャ</p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2026/0125_audit_conso_opencode_methodologie_comparaison_prix_llm_post.html Mon, 18 May 2026 00:00:00 +0000 blog/2026/0125_audit_conso_opencode_methodologie_comparaison_prix_llm_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_スタックを理解する誰が何をやるのか">スタックを理解する：誰が何をやるのか？</a></li> <li><a href="#_導入なぜ監査が必要ですか">導入：なぜ監査が必要ですか？</a></li> <li><a href="#_opencodeデータベース_金脈">OpenCodeデータベース : 金脈</a> <ul class="sectlevel2"> <li><a href="#_スキーマ">スキーマ</a></li> <li><a href="#_抽出コード">抽出コード</a></li> </ul> </li> <li><a href="#_結果_73日分の消費">結果 : 73日分の消費</a> <ul class="sectlevel2"> <li><a href="#_全体像">全体像</a></li> <li><a href="#_モデルおよびサプライヤーによる換気">モデルおよびサプライヤーによる換気</a></li> <li><a href="#_イントラセッション_モデル_セッション_テーブルが見ないもの">イントラセッション モデル ： セッション テーブルが見ないもの</a></li> </ul> </li> <li><a href="#_料金比較_西洋のサプライヤー">料金比較 — 西洋のサプライヤー</a> <ul class="sectlevel2"> <li><a href="#_anthropic_claude">Anthropic — Claude</a></li> <li><a href="#_openai_gpt">OpenAI — GPT</a></li> <li><a href="#_グーグル_ジェミニ">グーグル — ジェミニ</a></li> <li><a href="#_huggingface_推論プロバイダー">HuggingFace 推論プロバイダー</a></li> <li><a href="#_グロク">グロク</a></li> </ul> </li> <li><a href="#_料金比較_中国のサプライヤー">料金比較 — 中国のサプライヤー</a> <ul class="sectlevel2"> <li><a href="#_deepseek_api_direct_platform_deepseek_com">DeepSeek API Direct (platform.deepseek.com)</a></li> <li><a href="#_kimi_ムーンショット_platform_kimi_com">Kimi ムーンショット (platform.kimi.com)</a></li> <li><a href="#_alibaba_bailian_bailian_aliyun_com">Alibaba Bailian (bailian.aliyun.com)</a></li> </ul> </li> <li><a href="#_サマリー表_すべてのプロバイダー">サマリー表 — すべてのプロバイダー</a></li> <li><a href="#_隠れたコストプロンプトエンジニアリングとイテレーション">�隠れたコスト：プロンプトエンジニアリングとイテレーション</a></li> <li><a href="#_ollama_cloud_proのサブスクリプションを累積するdockerメソッド">Ollama Cloud Proのサブスクリプションを累積する：Dockerメソッド</a></li> <li><a href="#_監査が測らないもの">監査が測らないもの</a></li> <li><a href="#_結論数字の裁定">結論：数字の裁定</a></li> <li><a href="#_参考文献">参考文献</a> <ul class="sectlevel2"> <li><a href="#_料金の出所">料金の出所</a></li> </ul> </li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 22 minutes</div> <p>私はいつも AI の消費コストがいくらかと聞かれます。私は「月20ユーロ」と答えると、目を丸くして見られます。それでは今日、私はブラックボックスを開けます。この記事は、私の73日間のvibe codingの完全な監査です：OpenCodeのSQLiteデータベースからデータを抽出する方法論、テーブルをクエリするSQLコード、そして市場のすべてのプロバイダー――西洋のものも中国のものも――との包括的な比較。その結果は極めて非対称で、私は計算を3回確認しなければなりませんでした。</p> </div> <div class="dlist"> <dl> <dt class="hdlist1">トク</dt> <dd> <p>[]</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_スタックを理解する誰が何をやるのか">スタックを理解する：誰が何をやるのか？</h2> <div class="sectionbody"> <div class="paragraph"> <p>数字に飛び込む前に、アーキテクチャを明確にしましょう。私のセットアップには3つの異なるアクターが存在し、これを混同しないようにすることが重要です：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultFontSize 12 title 私のLLMスタックの3つのアクター left to right direction actor "私 (開発者)" as Dev package "オープンコード (github.com/anomalyco/opencode)" as OC { rectangle "Vibe codingのCLI オープンソース、無料" as CLI note right of CLI C'est l'outil que j'utilise pour coder avec des agents IA. Il ne fournit AUCUN modèle. C'est un terminal + un orchestrateur. end note } package "Ollama (ローカルインストール)" as OL { rectangle "推論クライアント 私のマシンにインストール済み" as Client note right of Client C'est le logiciel qui fait tourner les modèles. Il peut les exécuter en local OU les déléguer au cloud selon le tag (:cloud). Il s'authentifie via clé SSH. end note } package "Ollama クラウド (ollama.com)" as OCloud { rectangle "クラウド推論サービス プロサブスクリプション : 20ユーロ/月" as Cloud note right of Cloud C'est le fournisseur d'inférence. Mes modèles avec le tag :cloud sont exécutés sur LEURS serveurs. L'abonnement Pro donne accès à des quotas supérieurs. end note } Dev --> CLI : "プロンプトを打ち込む" CLI --> Client : "このモデルを呼び出せ" Client --> Cloud : "SSHキー + リクエスト\n(モデル :クラウド)" Client --> Client : "ローカル実行 (:cloud を使わないモデル)" @enduml</pre> </div> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="❗"></i> </td> <td class="content"> <div class="paragraph"> <p><strong>オープンコードはモデル提供者ではありません。</strong>これはオープンソースのCLIです (<a href="https://github.com/anomalyco/opencode">github.com/anomalyco/opencode</a>) は AI エージェントをオーケストレーションし、サブスクリプションを販売せず、推論も提供せず、これが～に相当します。<code>git`バージョン管理のために : ツールであって、サービスではない。 <strong>Ollama Cloud は推論のプロバイダー。</strong>私のローカルのOllamaインストールは <strong>client</strong> として機能し — Ollamaのサーバーに一意のSSHキー（Device Key）で認証し、タグ付けされたモデルの実行をそれらに委任します。</code>:cloud`. Proサブスクリプション（月20€）は、より高いクォータを解放し、Dockerを使って同じマシンで複数のアカウントを併用できるようになります。</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_導入なぜ監査が必要ですか">導入：なぜ監査が必要ですか？</h2> <div class="sectionbody"> <div class="paragraph"> <p>2か月前、私はローカルのOllamaインストールでモデルを無料で使用していました。 その後、月額20ユーロのOllama Cloud Proの最初のサブスクリプションに登録し、これによりクラウドモデル（タグが付いているもの`:cloud`) プロバイダー経由`ollama-cloud`. 2か月後に別のDockerインスタンスで独自のアカウントとSSHキーを使って2番目のサブスクリプションが追加されました — この積み上げ方法は <a href="0120_cumuler_deux_abonnements_ollama_pro_docker_post.html">mon article sur le cumul d’abonnements</a> で説明されています。</p> </div> <div class="paragraph"> <p>私を悩ませていた質問：<strong>これらの20ユーロ／月は正当化されるのか？</strong> 思い付きではなく。数字で。</p> </div> <div class="paragraph"> <p>回答するために、私は正確なデータが必要でした。見積もりでもなく、平均でもなく。私の*実際の*消費量、トークンごと、モデルごと、セッションごと。</p> </div> <div class="paragraph"> <p>そして OpenCode — CLI — すべてを SQLite データベースに保存します。</p> </div> </div> </div> <div class="sect1"> <h2 id="_opencodeデータベース_金脈">OpenCodeデータベース : 金脈</h2> <div class="sectionbody"> <div class="paragraph"> <p>OpenCode はすべてのセッション履歴を指定された場所にある SQLite ファイルに保持します`~/.local/share/opencode/opencode.db`. La mienne pèse 660 Mo pour 73 jours d’utilisation — une base de données de production tout à fait respectable.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ ls -lh ~/.local/share/opencode/opencode.db -rw-r--r-- 1 cheroliv cheroliv 660M mai 18 12:25 opencode.db</code></pre> </div> </div> <div class="sect2"> <h3 id="_スキーマ">スキーマ</h3> <div class="paragraph"> <p>データベースには約20のテーブルがありますが、うち3つは監査にとって重要です：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultFontSize 12 title 簡略化されたスキーマ — OpenCode SQLite entity "セッション" as S { * id : TEXT -- * model : TEXT (JSON) * cost : REAL * tokens_input : INTEGER * tokens_output : INTEGER * tokens_reasoning : INTEGER * tokens_cache_read : INTEGER * tokens_cache_write : INTEGER * time_created : INTEGER * project_id : TEXT } entity "メッセージ" as M { * id : TEXT -- * session_id : TEXT <<FK>> * data : TEXT (JSON) * time_created : INTEGER } entity "プロジェクト" as P { * id : TEXT -- * worktree : TEXT * name : TEXT } S ||--o{ M : "セッションID" S }o--|| P : "project_id" note right of S La table session agrège tokens + coût + modèle. C'est notre point d'entrée principal. end note note right of M Les messages individuels. Le champ data contient le modèle utilisé (format JSON) même si la session change de modèle en cours de route. end note @enduml</pre> </div> </div> <div class="paragraph"> <p>テーブル`session`これはグローバルな監査に最適です：各セッションには集約されたトークン数、使用されたモデル、およびコストがあります。フィールド`model`生のJSONです :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{ "id": "deepseek-v4-pro:cloud", "providerID": "ollama-cloud", "variant": "default" }</code></pre> </div> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="❗"></i> </td> <td class="content"> <div class="paragraph"> <p>フィールド`cost`OpenCode データベースでは、<strong>外部 API 料金</strong>（API キー経由での従量課金、Google Gemini、OpenAI など）のみが反映されます。 Ollama を経由した呼び出し — ローカルでも Ollama Cloud Pro でも — はマークされます。`cost=0`理由は、コストが定額（サブスクリプション）で、トークンあたりではないからです。これらの呼び出しの本当のコストは、月額サブスクリプションです。</p> </div> </td> </tr> </table> </div> </div> <div class="sect2"> <h3 id="_抽出コード">抽出コード</h3> <div class="paragraph"> <p>何もインストールする必要はありません。Node.js 22+ は実験的な SQLiteモジュールを組み込んでいます (<code>node:sqlite</code>) 完璧に機能しています。これが私がすべてを与えてくれたスクリプト：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">const { DatabaseSync } = require('node:sqlite'); const db = new DatabaseSync( `${process.env.HOME}/.local/share/opencode/opencode.db`, { readonly: true } ); // 1. Statistiques globales const global = db.prepare(` SELECT COUNT(*) as sessions, SUM(tokens_input) as total_input, SUM(tokens_output) as total_output, SUM(tokens_reasoning) as total_reasoning, SUM(tokens_cache_read) as total_cache_read, SUM(cost) as total_cost FROM session `).get(); // 2. Ventilation par modèle et fournisseur const byModel = db.prepare(` SELECT json_extract(model, '$.id') as model_id, json_extract(model, '$.providerID') as provider, COUNT(*) as sessions, SUM(tokens_input) as total_input, SUM(tokens_output) as total_output, SUM(cost) as total_cost FROM session WHERE model IS NOT NULL GROUP BY model_id, provider ORDER BY SUM(tokens_input) DESC `).all(); // 3. Par mois const monthly = db.prepare(` SELECT strftime('%Y-%m', datetime(time_created/1000, 'unixepoch')) as month, COUNT(*) as sessions, SUM(tokens_input) as total_input, SUM(tokens_output) as total_output, SUM(cost) as total_cost FROM session WHERE time_created IS NOT NULL GROUP BY month ORDER BY month `).all(); // 4. Messages par modèle (détection des changements intra-session) const msgByModel = db.prepare(` SELECT json_extract(m.data, '$.model.providerID') as provider, json_extract(m.data, '$.model.modelID') as model_id, COUNT(*) as messages FROM message m WHERE json_extract(m.data, '$.model') IS NOT NULL GROUP BY provider, model_id ORDER BY COUNT(*) DESC `).all(); console.log({ global, byModel, monthly, msgByModel }); db.close();</code></pre> </div> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="ℹ️"></i> </td> <td class="content"> <div class="paragraph"> <p>フラグ`--experimental-sqlite`� 必要です Node.js 22.x。 Node.js 24+ では、モジュールは安定しており、フラグは必要なくなりました。</p> </div> </td> </tr> </table> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結果_73日分の消費">結果 : 73日分の消費</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_全体像">全体像</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 33.3333%;"> <col style="width: 33.3333%;"> <col style="width: 33.3334%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">メトリック</th> <th class="tableblock halign-left valign-top">�値</th> <th class="tableblock halign-left valign-top">コンテキスト</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>OpenCode セッション</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">1 022</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">平均で約14セッション/日</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>トークン入力</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">2.62億</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">そのうち94,5Mのキャッシュヒット</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>トークン出力</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">2100万</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ratio input/output ~125:1</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>トークンの推論</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">141 000</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">微々たる — ほとんど考えない</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>外部 API コスト</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>$0.22</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">サブスクリプション外の手数料 (Gemini + 無料プラン)</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>この数字の \$0,22 は重要です：それは私が Ollama Cloud Pro のサブスクリプションに加えて支払ったすべてを表しています。つまりほぼゼロです。サブスクリプションは基本をカバーしています。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultFontSize 12 title 月次進化 — トークン入力 rectangle "2026年3月 9セッション 37.7Mトークン" as MARS #FFE082 rectangle "2026年4月 486セッション 13.3億トークン" as AVR #81C784 rectangle "2026年5月 527セッション 12.5億トークン" as MAI #64B5F6 MARS -right-> AVR : ×35 AVR -right-> MAI : stable (période en cours) note bottom of MAI Mai comptabilisé jusqu'au 18. Projection mois complet : ~2,1 Md tokens si la tendance se maintient. end note @enduml</pre> </div> </div> <div class="paragraph"> <p>3月と4月の打ち上げは目を見張るもので：1か月で×35に増加しました。これは「テスト」使用から「本番」使用への移行であり、GradleプラグインのためにOpenCodeエージェントを継続的に動かし始めたときだ。</p> </div> </div> <div class="sect2"> <h3 id="_モデルおよびサプライヤーによる換気">モデルおよびサプライヤーによる換気</h3> <div class="paragraph"> <p>フィールド`model`テーブルの`session`JSONである,`json_extract()`きれいに換気できる :</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 27.2727%;"> <col style="width: 18.1818%;"> <col style="width: 18.1818%;"> <col style="width: 18.1818%;"> <col style="width: 18.1819%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">モデル × プロバイダー</th> <th class="tableblock halign-left valign-top">セッション</th> <th class="tableblock halign-left valign-top">(Empty)</th> <th class="tableblock halign-left valign-top">Output</th> <th class="tableblock halign-left valign-top">コスト</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">deepseek-v4-pro @ ollama-cloud</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">63</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">220 M</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">1,94 M</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$0</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">deepseek-v4-pro @ ollama-b</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">124</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">463 M</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">4,15 M</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$0</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">deepseek-v4-pro @ ollama</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">100</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">252 M</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">2,25 M</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$0</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">deepseek-v4-flash-free @ opencode</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">16</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">1,3 M</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">279 K</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$0</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">qwen3.6-plus-free @ opencode</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">369 K</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">25 K</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$0</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">gemini-2.5-flash @ google</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">211 K</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">19 K</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$0,04</p></td> </tr> </tbody> </table> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="❗"></i> </td> <td class="content"> <div class="paragraph"> <p>まさに同じDeepSeek V4 Proモデルのための3つの異なるプロバイダー： * <code>ollama-cloud</code>→ 経由 <strong>有料Proサブスクリプション</strong> (Ollama管理のクラウド) * <code>ollama-b</code>→ <strong>２番目のProサブスクリプション</strong>, 別のDockerコンテナ内で隔離されている * <code>ollama</code>→ ネイティブロケールのインスタンス, <strong>無料</strong> (私のマシンで直接動作する) 3つの合計は 936M 入力、8.4M 出力 — これが私の DeepSeek V4 Pro の総消費量で、すべてのプロバイダーを合わせたものです。ただ`ollama-cloud`(220M input)は有料です（サブスクリプション）。 残りの716Mは無料です（ローカルまたはサブスクリプションの累積）。</p> </div> </td> </tr> </table> </div> </div> <div class="sect2"> <h3 id="_イントラセッション_モデル_セッション_テーブルが見ないもの">イントラセッション モデル ： セッション テーブルが見ないもの</h3> <div class="paragraph"> <p>テーブル`session`セッションの <strong>主要</strong> モデルしかキャプチャしない。しかし、同じセッション中でも、OpenCode エージェントは複数のモデル間を切り替えることができます。テーブル`message`明らかにする：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">Modèles utilisés dans les messages (ollama-cloud provider) : ├─ deepseek-v4-pro 1 441 msgs (32%) ├─ qwen3.5:397b 1 217 msgs (27%) ├─ glm-5.1 712 msgs (16%) ├─ kimi-k2.6:cloud 634 msgs (14%) ├─ qwen3-coder:480b 414 msgs (9%) ├─ gpt-oss:20b 34 msgs (0,8%) ├─ qwen3-coder-next 27 msgs (0,6%) └─ gemma4:31b 7 msgs (0,2%)</code></pre> </div> </div> <div class="admonitionblock caution"> <table> <tr> <td class="icon"> <i class="fa icon-caution" title="🔒"></i> </td> <td class="content"> <div class="paragraph"> <p>もう Qwen、GLM、Kimi とその他のモデルは使わなくなりました。これは私が4月にさまざまなことをテストしたため、履歴に表示されます。5月中旬から、私は DeepSeek V4 Pro にロックされています — これが長いコンテキストでもエージェントガバナンスとともに負荷に耐える唯一のモデルです。(参照 <code><a href="0112_comparaison_kimi_glm_deepseek_long_contexte_plugin_gradle_opencode_post.html">ma comparaison Kimi/GLM/DeepSeek</a></code>) 履歴における DeepSeek メッセージの 32% は誤解を招きます：今日は 100% です。</p> </div> </td> </tr> </table> </div> </div> </div> </div> <div class="sect1"> <h2 id="_料金比較_西洋のサプライヤー">料金比較 — 西洋のサプライヤー</h2> <div class="sectionbody"> <div class="paragraph"> <p>問題となる質問：この同じ消費量が伝統的な供給業者ではいくらになるでしょうか？</p> </div> <div class="paragraph"> <p>比較のための私の計算基準：<strong>220Mトークン入力 + 1.9Mトークン出力</strong>— <strong>のみ</strong> 体積を通過した`ollama-cloud`(私の有料サブスクリプションに対応する唯一のもの). 残りの716Mは無料です (Ollama ローカルおよび Docker B インスタンス).</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 23.0769%;"> <col style="width: 15.3846%;"> <col style="width: 15.3846%;"> <col style="width: 15.3846%;"> <col style="width: 15.3846%;"> <col style="width: 15.3847%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">サプライヤー</th> <th class="tableblock halign-left valign-top">モデル</th> <th class="tableblock halign-left valign-top">$/M</th> <th class="tableblock halign-left valign-top">出力 \$/M</th> <th class="tableblock halign-left valign-top">月額コスト</th> <th class="tableblock halign-left valign-top">私のサブスクリプション</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>私のセットアップ</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ディープシーク V4 Pro</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">0</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">0</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>\~20€</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>1×</strong></p></td> </tr> </tbody> </table> <div class="sect2"> <h3 id="_anthropic_claude">Anthropic — Claude</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 27.2727%;"> <col style="width: 18.1818%;"> <col style="width: 18.1818%;"> <col style="width: 18.1818%;"> <col style="width: 18.1819%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">モデル</th> <th class="tableblock halign-left valign-top">\$/M</th> <th class="tableblock halign-left valign-top">$/M</th> <th class="tableblock halign-left valign-top">月額コスト</th> <th class="tableblock halign-left valign-top">× 私のサブスクリプション</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">作品4.7</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$25</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$1 148</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>57×</strong></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ソネット 4.6</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$3</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$15</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$689</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>34×</strong></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ハイク 4.5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$1</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$230</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>11×</strong></p></td> </tr> </tbody> </table> <div class="paragraph"> <p>「最も「経済的」な Claude のモデルである Haiku 4.5 でも、私のサブスクリプションの 11 倍のコストがかかります。さらに、私のコードベースについては何も知らず、私のスタイルでコードを生成せず、Gradle Kotlin DSL の API について幻覚を起こします。」</p> </div> </div> <div class="sect2"> <h3 id="_openai_gpt">OpenAI — GPT</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 27.2727%;"> <col style="width: 18.1818%;"> <col style="width: 18.1818%;"> <col style="width: 18.1818%;"> <col style="width: 18.1819%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">モデル</th> <th class="tableblock halign-left valign-top">$/M</th> <th class="tableblock halign-left valign-top">出力 \$/M</th> <th class="tableblock halign-left valign-top">コスト/月</th> <th class="tableblock halign-left valign-top">私のサブスクリプション</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">GPT 5.5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$30</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$1 157</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>58倍</strong></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">GPT 5.4</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$2,50</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$15</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$579</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>29倍</strong></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">GPT 5.4 ミニ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$0,75</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$4,50</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$174</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>9×</strong></p></td> </tr> </tbody> </table> </div> <div class="sect2"> <h3 id="_グーグル_ジェミニ">グーグル — ジェミニ</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 27.2727%;"> <col style="width: 18.1818%;"> <col style="width: 18.1818%;"> <col style="width: 18.1818%;"> <col style="width: 18.1819%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">モデル</th> <th class="tableblock halign-left valign-top">$/M</th> <th class="tableblock halign-left valign-top">出力 \$/M</th> <th class="tableblock halign-left valign-top">月額コスト</th> <th class="tableblock halign-left valign-top">×私のサブスクリプション</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ジェミニ 3.1 Pro</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$2,00</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$10</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$459</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>23×</strong></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ジェミニ3 フラッシュ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$0,30</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$1,50</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$69</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>3.5倍</strong></p></td> </tr> </tbody> </table> <div class="paragraph"> <p>Gemini 3 Flash 69ユーロは、純粋な価格において唯一の「近い」競合です — しかし、これは軽量な密集モデルであり、DeepSeek V4 Proのような1.6T MoEではありません。生成されたコードの品質は比べ物になりません。</p> </div> </div> <div class="sect2"> <h3 id="_huggingface_推論プロバイダー">HuggingFace 推論プロバイダー</h3> <div class="paragraph"> <p>HuggingFace は自ら推論を行わず — サードパーティの <strong>providers</strong> (Novita, Together, DeepInfra, Cerebras, SambaNova, Fireworks, Groq…) を統一 API を介して集約します。最も安いまたは最も速い provider を選択します。以下は 2026年5月に収集した DeepSeek V4 Pro の料金です：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 27.2727%;"> <col style="width: 18.1818%;"> <col style="width: 18.1818%;"> <col style="width: 18.1818%;"> <col style="width: 18.1819%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">プロバイダー HF</th> <th class="tableblock halign-left valign-top">ドル/メートル</th> <th class="tableblock halign-left valign-top">ドル/メートル</th> <th class="tableblock halign-left valign-top">コスト/月</th> <th class="tableblock halign-left valign-top">× 私のサブスクリプション</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Novita (最も安い)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$1,67</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$3,38</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>\$374</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>19倍</strong></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ディープインフラ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$1,74</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$3,48</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>$389</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>19倍</strong></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">一緒に</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$2,10</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$4,40</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>$470</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>23倍</strong></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">花火</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">非公開料金</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">—</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">—</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">—</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>HuggingFace 上でも最も安いプロバイダー (Novita) でさえ、私のサブスクリプション料金の 19 倍を請求します。それに対して Ollama Cloud とは異なり、HF PRO サブスクリプション ($9/月) を持っていない場合、HuggingFace はプラットフォーム手数料も <strong>さらに</strong> 請求します。</p> </div> </div> <div class="sect2"> <h3 id="_グロク">グロク</h3> <div class="paragraph"> <p>Groq は <strong>aucun</strong> のモデルを使っていません — 彼らのカタログは GPT-OSS、Llama、Qwen 32B に限られています。比較することは不可能です。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_料金比較_中国のサプライヤー">料金比較 — 中国のサプライヤー</h2> <div class="sectionbody"> <div class="paragraph"> <p>本当のテストは中国市場です。DeepSeekが中国のモデルなら、そのネイティブAPIはもっと安いはずでしょうか？</p> </div> <div class="sect2"> <h3 id="_deepseek_api_direct_platform_deepseek_com">DeepSeek API Direct (platform.deepseek.com)</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 33.3333%;"> <col style="width: 22.2222%;"> <col style="width: 22.2222%;"> <col style="width: 22.2223%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">期間</th> <th class="tableblock halign-left valign-top">$/M</th> <th class="tableblock halign-left valign-top">出力 \$/M</th> <th class="tableblock halign-left valign-top">月額コスト</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">プロモーション -75% (5月31日まで)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$0,435</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$0,87</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>98ドル</strong></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">通常運賃 (6月より)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$1,74</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$3,48</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>$390</strong></p></td> </tr> </tbody> </table> <div class="paragraph"> <p>たとえ DeepSeek の積極的なプロモーション（-75% 延長）でも、直接 API のコストは<strong>5×</strong>もっと高くなります。 通常料金では,<strong>20×</strong>. これはDeepSeekのみ — 他のモデルへのアクセスはありません。</p> </div> </div> <div class="sect2"> <h3 id="_kimi_ムーンショット_platform_kimi_com">Kimi ムーンショット (platform.kimi.com)</h3> <div class="paragraph"> <p>Kimiは自社のモデルのみを提案します。DeepSeekはありません。</p> </div> </div> <div class="sect2"> <h3 id="_alibaba_bailian_bailian_aliyun_com">Alibaba Bailian (bailian.aliyun.com)</h3> <div class="paragraph"> <p>中国のすべてのモデルを集約する唯一のプロバイダー — ただし、転売によるマージンを含みます。価格はJavaScriptで動的に読み込まれ、スクレイピングが不可能になります。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_サマリー表_すべてのプロバイダー">サマリー表 — すべてのプロバイダー</h2> <div class="sectionbody"> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 23.0769%;"> <col style="width: 15.3846%;"> <col style="width: 15.3846%;"> <col style="width: 15.3846%;"> <col style="width: 15.3846%;"> <col style="width: 15.3847%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">供給者</th> <th class="tableblock halign-left valign-top">モデル</th> <th class="tableblock halign-left valign-top">$/M</th> <th class="tableblock halign-left valign-top">出力 \$/M</th> <th class="tableblock halign-left valign-top">コスト/月</th> <th class="tableblock halign-left valign-top">× 私のサブスクリプション</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>オラマ クラウド プロ</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">DeepSeek V4 Pro</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">0</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">0</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>約20ユーロ</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>1×</strong></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Gemini 3 フラッシュ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ジェミニ3フラッシュ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$0,30</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$1,50</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$69</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">3,5×</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">DeepSeek API (プロモ)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ディープシークV4プロ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$0,44</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$0,87</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$98</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">5×</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">GPT 5.4 Mini</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">GPT 5.4 ミニ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$0,75</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$4,50</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$174</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">9×</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Claude Haiku 4.5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">クロード ハイク 4.5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$1</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$230</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">11×</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">HuggingFace/Novita</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ディープシーク V4 プロ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$1,67</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$3,38</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$374</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">19×</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">DeepSeek API (通常)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">DeepSeek V4 Pro</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$1,74</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$3,48</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$390</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">20×</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Together AI</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">DeepSeek V4 Pro</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$2,10</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$4,40</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$470</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">23×</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">GPT 5.4</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">GPT 5.4</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$2,50</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$15</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$579</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">29×</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">クロード ソネット 4.6</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Claude Sonnet 4.6</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$3</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$15</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$689</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">34×</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Claude Opus 4.7</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Claude Opus 4.7</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$25</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$1 148</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">57×</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">GPT 5.5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">GPT 5.5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$30</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\$1 157</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">58×</p></td> </tr> </tbody> </table> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultFontSize 11 title 予測月間コスト — 220M 入力 + 1,9M 出力 rectangle "Ollama Cloud Pro 約20ユーロ" as OC #4CAF50 rectangle "Gemini Flash \$69" as GF #8BC34A rectangle "DeepSeek promo $98" as DSP #FFC107 rectangle "GPT Mini $174" as GM #FF9800 rectangle "Claude Haiku $230" as CH #FF5722 rectangle "HF/Novita \$374" as HF #F44336 rectangle "DeepSeek 標準 $390" as DSN #F44336 rectangle "GPT 5.4 $579" as G4 #D32F2F rectangle "Claude Sonnet $689" as CS #D32F2F rectangle "Claude Opus $1,148" as CO #B71C1C rectangle "GPT 5.5 $1 157" as G5 #880E4F note bottom of OC DeepSeek V4 Pro 1.6T MoE + accès à tout le catalogue Ollama Cloud (Qwen, GLM, Kimi...) Inclus dans l'abonnement end note @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_隠れたコストプロンプトエンジニアリングとイテレーション">�隠れたコスト：プロンプトエンジニアリングとイテレーション</h2> <div class="sectionbody"> <div class="paragraph"> <p>トークンのコストは方程式の一部にすぎません。本当のコストは開発者の時間です。</p> </div> <div class="paragraph"> <p>OpenCode + Ollama Cloud Pro + 私のエージェントガバナンス (EAGER/LAZY/Hot/Warm/Cold, <a href="0108_gouvernance_agent_opencode_eager_lazy_post.html">l’article sur la gouvernance</a>) で説明 を使用すると、その結果、次のように得られます：</p> </div> <div class="ulist"> <ul> <li> <p><strong>0 反復的なプロンプトエンジニアリング</strong>: コンテキストは自動的に注入されます</p> </li> <li> <p><strong>90%+ 初回正解</strong>: コードは最初の試みでコンパイルされる</p> </li> <li> <p><strong>DeepSeek は 8 回連続のセッションで幻覚ゼロ</strong>(以下に文書化されています <a href="0112_comparaison_kimi_glm_deepseek_long_contexte_plugin_gradle_opencode_post.html">Kimi/GLM/DeepSeekの比較</a>)</p> </li> </ul> </div> <div class="paragraph"> <p>ClaudeまたはGPT ファインチューンなし、ガバナンスなし：</p> </div> <div class="ulist"> <ul> <li> <p>タスクごとに平均 2-3 回のイテレーション</p> </li> <li> <p>体系的なプロンプトエンジニアリング</p> </li> <li> <p>Kotlin/Gradle API の幻覚は、コンテキストが 30K トークンを超えるとすぐに現れる</p> </li> </ul> </div> <div class="paragraph"> <p>月間の「効果的」コスト — tokens × itérations × temps de correction — は、私のソリューションの27倍から54倍であり、これは <a href="0122_ratio_efficacite_27x_45x_flotte_experts_ia_vs_claude_gpt_post.html">l’article sur le ratio d’efficacité</a> で私が示したとおりです。</p> </div> <div class="paragraph"> <p><em><em>_ これはトークンあたりの価格の話だけではない。57倍の価格のClaude Opusは、3倍多くのイテレーションを必要とし、実質的なコストは約170倍高くなる。率直に言うと：McKinseyのパートナーの給料でインターンを雇うようなものだ。 </em>_</em></p> </div> </div> </div> <div class="sect1"> <h2 id="_ollama_cloud_proのサブスクリプションを累積するdockerメソッド">Ollama Cloud Proのサブスクリプションを累積する：Dockerメソッド</h2> <div class="sectionbody"> <div class="paragraph"> <p>1つのサブスクリプションでは足りない場合は、それらを組み合わせます。原則として、各サブスクリプションをそれぞれのOllamaインストールに隔離し、それぞれのSSH認証キーを使います。Dockerならこれがとても簡単です。</p> </div> <div class="paragraph"> <p>完全な方法は <a href="0120_cumuler_deux_abonnements_ollama_pro_docker_post.html">Dockerの累積に関する記事</a> で詳しく説明されています。これが原則です：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultFontSize 12 title アーキテクチャ — Ollama Cloud Proの2つのサブスクリプションを1台のマシンで left to right direction node "私の物理マシン" { frame "Ollama インスタンス A (ネイティブ) ポート :11434" as Native { database "アイデンティティ A /usr/share/ollama/.ollama/id_ed25519" } frame "オラマ インスタンス B (ドッカー) ポート:11435" as Docker { database "アイデンティティ B ~/ollama-b-data/id_ed25519" } } cloud "Ollama Cloud" { actor "プロアカウント A (メール 1)" as A actor "プロBアカウント\n(email 2)" as B } Native --> A : "デバイスキーA" Docker --> B : "デバイスキー B" note bottom of Docker Conteneur Docker isolé : - Clé SSH distincte - Port réseau distinct (11435) - Volume persistant (~/ollama-b-data) - restart: always end note @enduml</pre> </div> </div> <div class="paragraph"> <p>パターンは単純です :</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>ボリュームを作成`~/ollama-b-data`</p> </li> <li> <p>ドッカーコンテナを実行する`ollama/ollama:0.20.2`にマッピングされた`11435:11434`</p> </li> <li> <p>コンテナのSSHキーを取得 → ollama.comに保存する</p> </li> <li> <p>する`ollama signin`二番目のメールとともに</p> </li> <li> <p>OpenCodeを2つのプロバイダーで設定する (`ollama`で :11434,`ollama-b`について :11435)</p> </li> </ol> </div> <div class="paragraph"> <p>アカウント2つ、青いカード1枚、競合ゼロ</p> </div> </div> </div> <div class="sect1"> <h2 id="_監査が測らないもの">監査が測らないもの</h2> <div class="sectionbody"> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 40%;"> <col style="width: 60%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">�盲点</th> <th class="tableblock halign-left valign-top">インパクト</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>生成コードの品質</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">26億トークンはコードがコンパイルするかどうかを言わない。私のDeepSeek V4 Proの8つのセッションは、ファーストショット成功率が90%以上である。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>エコシステム OpenCode</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">CLIは無料ですが、その価値（エージェント、サンドボックス、履歴、プロンプトキャッシング）は非常に大きいです。サブスクリプションの価格に含まれていません — 別のツールです。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>機会コスト</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">1日2時間、性能の劣るモデルの幻覚をデバッグするのに費やす時間は、月20ユーロ以上かかる。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>心の平安</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">固定プランはサプライズなし。従量課金では、利用の急増が大きな打撃になることがあります。</p></td> </tr> </tbody> </table> <div class="admonitionblock warning"> <table> <tr> <td class="icon"> <i class="fa icon-warning" title="⚠️"></i> </td> <td class="content"> <div class="paragraph"> <p>引用された価格は2026年5月のものです。6か月後にはすべてが下がっているでしょう。しかし、構造的な力関係 — 定額制対従量制 — は、大量消費者にとって定額制に有利なまま残るでしょう。</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_結論数字の裁定">結論：数字の裁定</h2> <div class="sectionbody"> <div class="paragraph"> <p>73日後、1 022セッション OpenCode、および2.6億トークン：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 60%;"> <col style="width: 40%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">メトリック</th> <th class="tableblock halign-left valign-top">判決</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">累積外部 API コスト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>$0.22</strong>(ほぼゼロ)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Ollama Cloud Proの料金</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>約20ユーロ/月</strong></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">「Claude Opus」相当</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>\$1,148/月</strong>— 57倍高価</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">GPT 5.5相当</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>\$1 157/月</strong>— 58倍高い</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">HuggingFace/Novitaの同等物</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>\$374/mois</strong>— 19× もっと高い</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">DeepSeek API の直接の同等物</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>\$390/月</strong>— 20倍高い</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">最も安い同等物 (Gemini Flash)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>$69/月</strong>— 3,5×高価な, 下位モデル</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>市場で最高のオファー</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Ollama Cloud Pro 月額20ユーロ</strong>— 無敵</p></td> </tr> </tbody> </table> <div class="paragraph"> <p><em>__</em> Ollama Cloud を通じて DeepSeek V4 Pro (1.6T パラメータ, MoE, CSA+HCA, 1M コンテキスト) に月額 20 ユーロでアクセスできることから、私は世界市場で最高のコストパフォーマンスを得ています。中国の直接のプロバイダーでも 5 倍から 20 倍高いです。低コスト プロバイダーの集約を行う HuggingFace でも 19 倍高いです。西洋市場 (Claude, GPT) は 50-60 倍 — まるで別の惑星です。</p> </div> <div class="paragraph"> <p>この比率は極端に不均衡すぎて、永遠に続くことはできません。それが存在している間に利用せよ。 </think></p> </div> <div class="paragraph"> <p>そう、毎月の20ユーロが私の開発者人生で最高の技術的投資だ。それによって今、それを証明する数字があなたにはある。</p> </div> <hr> </div> </div> <div class="sect1"> <h2 id="_参考文献">参考文献</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="0108_gouvernance_agent_opencode_eager_lazy_post.html">Article 0108 — ガバナンス エージェント EAGER/LAZY/Hot/Warm/Cold</a></p> </li> <li> <p>記事 0112 — DeepSeek V4 Pro vs Kimi K2.6 vs GLM 5.1</p> </li> <li> <p><a href="0119_benchmark_dgx_spark_vs_cloud_abonnement_llm_post.html">Article 0119 — Benchmark DGX Spark vs Cloud vs Abonnements LLM</a></p> </li> <li> <p><a href="0120_cumuler_deux_abonnements_ollama_pro_docker_post.html">記事 0120 — Ollama Cloud Pro と Docker を組み合わせた 2 つのサブスクリプション</a></p> </li> <li> <p><a href="0121_plugin_gradle_piloter_deux_instances_ollama_pro_post.html">記事0121 — Gradleプラグインで2つのOllamaインスタンスを操作</a></p> </li> <li> <p><a href="0122_ratio_efficacite_27x_45x_flotte_experts_ia_vs_claude_gpt_post.html">記事0122 — 効率比率 27倍 から 54倍</a></p> </li> </ul> </div> <div class="sect2"> <h3 id="_料金の出所">料金の出所</h3> <div class="ulist"> <ul> <li> <p><a href="https://ollama.com/pricing">Ollama Cloud — Proプラン $20/月</a></p> </li> <li> <p><a href="https://api-docs.deepseek.com/quick_start/pricing">DeepSeek API — 公式料金 V4 Pro</a></p> </li> <li> <p><a href="https://platform.kimi.com/docs/pricing/chat-k26">Kimi Moonshot — 料金 K2.6</a></p> </li> <li> <p><a href="https://huggingface.co/inference/models">HuggingFace Inference Providers — プロバイダーごとの料金</a></p> </li> <li> <p><a href="https://www.anthropic.com/pricing">Anthropic — Claude API 料金</a></p> </li> <li> <p><a href="https://openai.com/api/pricing/">OpenAI — GPT APIの料金</a></p> </li> <li> <p><a href="https://together.ai/pricing">Together AI — 推論料金</a></p> </li> <li> <p><a href="https://groq.com/pricing">Groq — API料金</a></p> </li> <li> <p><a href="https://deepinfra.com/pricing">DeepInfra — GPUの価格とモデル</a></p> </li> <li> <p><a href="https://help.aliyun.com/zh/model-studio/text-generation-model/">Alibaba Bailian — 利用可能なモデル</a></p> </li> <li> <p><a href="https://github.com/anomalyco/opencode">OpenCode — GitHubのオープンソースCLI</a></p> </li> </ul> </div> </div> </div> </div> https://cheroliv.com/blog/2026/0124_architecture_plugin_gradle_racine_consommateur_independant_post.html Thu, 14 May 2026 00:00:00 +0000 blog/2026/0124_architecture_plugin_gradle_racine_consommateur_independant_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_問題私の時間を奪った3つのアーキテクチャ">問題：私の時間を奪った3つのアーキテクチャ</a> <ul class="sectlevel2"> <li><a href="#_オプション_1_分離されたプラグイン_ドッグフーディングなし">オプション 1 : 分離されたプラグイン (ドッグフーディングなし)</a></li> <li><a href="#_option_2_クラシックなモノリポ_includeplugin">Option 2 : クラシックなモノリポ (<code>include(":plugin")</code>)</a></li> <li><a href="#_オプション_3_コンポジット_ビルド_includebuild">オプション 3 : コンポジット ビルド (<code>includeBuild()</code>)</a></li> </ul> </li> <li><a href="#_ソリューション独立した2つのビルド1つの消費者ルート">ソリューション：独立した2つのビルド、1つの消費者ルート</a> <ul class="sectlevel2"> <li><a href="#_ワークフロー">ワークフロー</a></li> <li><a href="#_具体的なワークフロー">具体的なワークフロー</a></li> </ul> </li> <li><a href="#_なぜこのアーキテクチャが私を魅了した">なぜこのアーキテクチャが私を魅了した</a> <ul class="sectlevel2"> <li><a href="#_1_ネイティブドッグフーディング即時フィードバック">1. ネイティブドッグフーディング、即時フィードバック</a></li> <li><a href="#_2_ゼロコンフィグ_クローニング">2. ゼロコンフィグ クローニング</a></li> <li><a href="#_3_ビルドの分離_ci_の独立">3. ビルドの分離, CI の独立</a></li> </ul> </li> <li><a href="#_サブフォルダー_name_plugin_の構造">サブフォルダー <code>{name}-plugin/</code> の構造</a> <ul class="sectlevel2"> <li><a href="#_バージョンカタログ_2つの異なるファイル">バージョンカタログ : 2つの異なるファイル</a></li> </ul> </li> <li><a href="#_私たちがやらないこと">私たちがやらないこと</a></li> <li><a href="#_比較ドッグフーディングに直面する3つのアーキテクチャ">比較：ドッグフーディングに直面する3つのアーキテクチャ</a></li> <li><a href="#_dag契約_サブディレクトリからはルートビルドが決して行われない">DAG契約 : サブディレクトリからはルートビルドが決して行われない</a></li> <li><a href="#_結論時間を節約する見かけの重複">結論：時間を節約する見かけの重複</a></li> <li><a href="#_参照">参照</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 11 minutes</div> <p>Gradleプラグインのリポジトリをクローンしています。ターミナルを開いています。何を入力していますか？ その後？<code>./gradlew tasks</code>, 当然です。 しかし、どのフォルダーですか？ ルートですか？ サブモジュールですか？ まずREADMEを読んでビルド方法を確認すべきでしょうか？もし躊躇しているなら 一瞬で、プロジェクトのアーキテクチャーが壊れています。</p> </div> <div class="paragraph"> <p>これが私がこの問題を一度限りで解決した方法 — そしてなぜこれが パターンは今日、私のすべてのGradleプラグインの署名の中`foundry/public/`.</p> </div> </div> </div> <div class="sect1"> <h2 id="_問題私の時間を奪った3つのアーキテクチャ">問題：私の時間を奪った3つのアーキテクチャ</h2> <div class="sectionbody"> <div class="paragraph"> <p>現在のパターンに収束する前に、私は3つのアプローチの間で試行錯誤した Gradle プラグインを構成するための伝統的な方法。それぞれに致命的な欠陥があった。</p> </div> <div class="sect2"> <h3 id="_オプション_1_分離されたプラグイン_ドッグフーディングなし">オプション 1 : 分離されたプラグイン (ドッグフーディングなし)</h3> <div class="paragraph"> <p>プロジェクトにはプラグインのみが含まれます。 消費の例はありません。 なし プロジェクトがそれを行う。それをテストするには、外部のプロジェクトを作成する必要があります、y プラグインを介して参照する`mavenLocal`または複合ビルド、そしてのみ そこでそれが動くことを確認する。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-shell hljs" data-lang="shell">$ git clone mon-plugin $ cd mon-plugin $ ./gradlew build # le plugin compile $ # ... et maintenant ? comment je l'essaie ?</code></pre> </div> </div> <div class="admonitionblock warning"> <table> <tr> <td class="icon"> <i class="fa icon-warning" title="⚠️"></i> </td> <td class="content"> <div class="paragraph"> <p>消費例のない Gradle プラグインは、ライブラリではない 統合テスト。 あなたは最後の変更が ユーザー体験を壊した</p> </div> </td> </tr> </table> </div> </div> <div class="sect2"> <h3 id="_option_2_クラシックなモノリポ_includeplugin">Option 2 : クラシックなモノリポ (<code>include(":plugin")</code>)</h3> <div class="paragraph"> <p>グレードル`init`生成する`settings.gradle.kts`と`include("plugin")`. ルートとサブモジュールは同じデーモンと同じ設定を共有します、 同じカタログです。便利ですが、結合されています。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">. ├── settings.gradle.kts → include("plugin") ├── build.gradle.kts → plugins { id("mon-plugin") } ├── plugin/ │ └── build.gradle.kts → java-gradle-plugin └── gradle/ └── libs.versions.toml</code></pre> </div> </div> <div class="paragraph"> <p>ネックは：</p> </div> <div class="ulist"> <ul> <li> <p>ルート<strong>しなければならない</strong>サブモジュールと同じGradleのバージョンを持つ。</p> </li> <li> <p>`libs.versions.toml`共有されている — 共通のバージョンカタログ、依存関係</p> </li> </ul> </div> <div class="paragraph"> <p>モジュールから別のモジュールへ逃げている</p> </div> <div class="ulist"> <ul> <li> <p>ルートなしではプラグインをビルドすることはできません。</p> </li> <li> <p>CIはプラグインのみが変更された場合でも、2つのモジュールをビルドしなければならない。</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_オプション_3_コンポジット_ビルド_includebuild">オプション 3 : コンポジット ビルド (<code>includeBuild()</code>)</h3> <div class="paragraph"> <p>2つをそれぞれ異なるGradleビルドに分け、それらを経由でつなげる <code>includeBuild("mon-plugin")`中に`settings.gradle.kts</code>。</p> </div> <div class="paragraph"> <p>既に改善されました。プラグインのビルドは分離されています。しかし、消費者 明示的に外部ビルドを参照しなければならない — 出力は `./gradlew tasks`根本では、正しい設定に依存する 複合体。クローン作成はzero-configではありません：それが…であることを知っておく必要があります プラグインは別のフォルダーにあり、ルートがそれを参照しているなど。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-shell hljs" data-lang="shell">. ├── settings.gradle.kts → includeBuild("plugin-build/") ├── build.gradle.kts → plugins { id("mon-plugin") } └── plugin-build/ ├── settings.gradle.kts └── build.gradle.kts</code></pre> </div> </div> <div class="paragraph"> <p>もっと良いものを探していた。ずっと良いもの。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ソリューション独立した2つのビルド1つの消費者ルート">ソリューション：独立した2つのビルド、1つの消費者ルート</h2> <div class="sectionbody"> <div class="paragraph"> <p>こちらが最終的に採用したパターンです：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">. ├── settings.gradle.kts ← racine consommateur ├── build.gradle.kts ← 3 lignes : apply plugin + dogfood ├── gradle/ │ └── libs.versions.toml ← catalogue du consommateur ├── {name}-plugin/ ← BUILD INDÉPENDANT │ ├── gradlew ← son propre wrapper │ ├── settings.gradle.kts ← rootProject.name = "{name}-plugin" │ ├── build.gradle.kts ← java-gradle-plugin, signing, publish │ ├── gradle/ │ │ ├── libs.versions.toml ← catalogue du plugin │ │ └── wrapper/ │ ├── src/ ← sources du plugin │ ├── .agents/ ← gouvernance agent │ └── *.adoc ← AGENT, PROMPT_REPRISE, snapshot, etc. └── site.yml / slides-context.yml / ... ← configs dogfood</code></pre> </div> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="❗"></i> </td> <td class="content"> <div class="paragraph"> <p>�鍵:`{name}-plugin/`完全かつ独立したGradleプロジェクト。 彼には独自の wrapper、独自の settings、独自の catalogue の バージョン。自身をクローンし、ビルドし、テストし、そして root なしで公開します。 その存在を知っているかどうか</p> </div> </td> </tr> </table> </div> <div class="paragraph"> <p>ルートは、*一つ*のことだけを行う：プラグインを適用する。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">plugins { alias(libs.plugins.bakery) } repositories { mavenLocal() mavenCentral() } bakery { configPath = file("site.yml").absolutePath }</code></pre> </div> </div> <div class="paragraph"> <p>ケースでは3行`bakery-gradle`. それ以上はありません。 ゼロ`include()<code>, ゼロ`includeBuild()</code>, ゼロのサブプロジェクト。 通常のGradleビルドは、任意のプラグインを適用します どの消費者がそれをするでしょうか。</p> </div> <div class="sect2"> <h3 id="_ワークフロー">ワークフロー</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultFontSize 12 left to right direction package "根 (消費者)" #CCFFCC { usecase "リポジトリをクローン" as Clone usecase "./gradlew tasks" as Tasks usecase "./gradlew bake" as Dogfood note bottom of Dogfood Exerce le plugin Feedback immédiat Zéro config end note } package "{name}-plugin/ (独立したビルド)" #CCE5FF { usecase "./gradlew build" as BuildPlugin usecase "./gradlew publishToMavenLocal" as MavenLocal usecase "./gradlew test" as TestPlugin note bottom of BuildPlugin Cycle de vie isolé Tests unitaires + Cucumber CI dédiée possible end note } Clone -down-> Tasks Tasks -down-> Dogfood Dogfood ..> MavenLocal : "プラグインに依存します ローカルで公開" BuildPlugin -up-> MavenLocal TestPlugin -up-> BuildPlugin @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_具体的なワークフロー">具体的なワークフロー</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-shell hljs" data-lang="shell"># 1. Builder le plugin $ cd codebase-plugin $ ./gradlew publishToMavenLocal # 2. L'exercer depuis la racine $ cd .. $ ./gradlew indexCodebase queryCodebase snapshot # La boucle est fermée. Le plugin est testé dans des conditions # réelles de consommation, par le projet même qui l'héberge.</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_なぜこのアーキテクチャが私を魅了した">なぜこのアーキテクチャが私を魅了した</h2> <div class="sectionbody"> <div class="paragraph"> <p>組み合わせるとコストに見合う３つの利点：</p> </div> <div class="sect2"> <h3 id="_1_ネイティブドッグフーディング即時フィードバック">1. ネイティブドッグフーディング、即時フィードバック</h3> <div class="paragraph"> <p>Gradleプラグインの最良のテストは、それを使うことです。 モックされたユニットテストではない。でもない`GradleRunner`プロジェクトと共に テストの。プラグインを本当のファイルに適用する*本当の*ビルド</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-shell hljs" data-lang="shell">$ git clone bakery-gradle $ cd bakery-gradle $ ./gradlew bake # ← le plugin est exercé immédiatement</code></pre> </div> </div> <div class="paragraph"> <p>プラグインが壊れているとき、ルートビルドはそれを教えてくれます。わざわざ確認しに行く必要はありません。 外部のテストプロジェクトを探す。ドッグフーディングは*最初的*だ 新しい貢献者が開始するタスク。それが最終的なスモークテストです。</p> </div> <div class="admonitionblock tip"> <table> <tr> <td class="icon"> <i class="fa icon-tip" title="💡"></i> </td> <td class="content"> <div class="paragraph"> <p>ルールはシンプルです : もしルートがコンパイルされ、そして`./gradlew tasks` あなたのプラグインのタスクを表示し、プラグインは機能しています。驚きはありません 本番で。</p> </div> </td> </tr> </table> </div> </div> <div class="sect2"> <h3 id="_2_ゼロコンフィグ_クローニング">2. ゼロコンフィグ クローニング</h3> <div class="paragraph"> <p>Un `git clone && ./gradlew tasks`そして新参者はすべてを見る 設定せずに歩く。 その`build.gradle.kts`根は プラグインの使用に関する生きているドキュメント。 Le`site.yml`横に 期待される構成を示します。</p> </div> <div class="paragraph"> <p>代替案と比較して：3段落のREADMEが プラグインをビルドする方法とプロジェクトをビルドする方法を説明します のテスト。 新しい貢献者はREADMEを斜めに読む, 間違って、issue を開ける — しかし情報は である <strong>実行可能</strong>。</p> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="❗"></i> </td> <td class="content"> <div class="paragraph"> <p>最も堅牢なドキュメントは読むものではない。 それは<strong>実行</strong>. ルートビルドはドキュメントです プラグインの実行可能ファイル</p> </div> </td> </tr> </table> </div> </div> <div class="sect2"> <h3 id="_3_ビルドの分離_ci_の独立">3. ビルドの分離, CI の独立</h3> <div class="paragraph"> <p>プラグインは独自のGradleラッパーと、独自のライフサイクルを持ち、 独自のテスト。できること:</p> </div> <div class="ulist"> <ul> <li> <p>プラグインでGradleをアップグレードし、rootを触らない</p> </li> <li> <p>ルートに漏れないようにプラグインに依存関係を追加する</p> </li> <li> <p>プラグインを壊して、ルート ビルドに影響を与えずに (ただし、あなたが</p> </li> </ul> </div> <div class="paragraph"> <p>壊れたバージョンを公開するな)</p> </div> <div class="ulist"> <ul> <li> <p>プラグインをビルド/テストするCIと、それを行使するもう一方のCI</p> </li> </ul> </div> <div class="paragraph"> <p>root — 独立して</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">.github/workflows/ ├── test-plugin.yml → codebase-plugin/.gradlew build ├── test-root.yml → .gradlew tasks (vérifie que le plugin est consommable) └── publish.yml → codebase-plugin/.gradlew publish</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_サブフォルダー_name_plugin_の構造">サブフォルダー <code>{name}-plugin/</code> の構造</h2> <div class="sectionbody"> <div class="paragraph"> <p>プラグインのフォルダに存在するものを詳しく見てみましょう：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">codebase-plugin/ ├── gradlew ← wrapper indépendant ├── settings.gradle.kts ← @Suppress("UnstableApiUsage") │ + foobar-resolver-convention ├── build.gradle.kts ← java-gradle-plugin + signing + publish ├── gradle/ │ ├── libs.versions.toml ← catalogue complet (langchain4j, pgvector...) │ └── wrapper/ ├── buildSrc/ ← classes utilitaires buildSrc │ ├── build.gradle.kts │ └── src/main/kotlin/ │ ├── codebase/ ← CodebaseYmlAnonymizer, CodebaseConfiguration │ ├── benchmark/ ← BenchmarkConfig, BenchmarkProtocol │ ├── readme/ ← ReadmeYmlAnonymizer │ ├── site/ ← SiteYmlAnonymizer │ ├── slider/ ← SliderYmlAnonymizer │ └── snapshot/ ← SnapshotManager ├── src/ │ ├── main/kotlin/codebase/ │ │ ├── CodebasePlugin.kt ← class Plugin<Project> │ │ ├── rag/ ← pgvector, embedding, anonymization... │ │ ├── benchmark/ ← BenchmarkRunner, export, comparison... │ │ └── walker/ ← WorkspaceWalker │ └── test/ │ ├── kotlin/codebase/scenarios/ ← steps Cucumber │ ├── features/ ← .feature files │ └── resources/datasets/ ← fixtures .adoc, .yml, .json ├── .agents/ ← gouvernance agent (INDEX, SESSIONS, etc.) ├── AGENT.adoc ← règles agent ├── PROMPT_REPRISE.adoc ← mission session ├── BACKLOG.adoc ← backlog produit ├── snapshot.adoc ← snapshot auto-généré du projet └── embeds.yml ← config RAG embeds</code></pre> </div> </div> <div class="paragraph"> <p>すべてそこにある。ルートとサブフォルダーの間に散らばりはない。 プラグインで作業する開発者は決して…する必要がない 去る`codebase-plugin/`. プラグインを使用する開発者 根だけを見 — そして`build.gradle.kts`3行の 彼は彼に必要なことをすべて伝える。</p> </div> <div class="sect2"> <h3 id="_バージョンカタログ_2つの異なるファイル">バージョンカタログ : 2つの異なるファイル</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 25%;"> <col style="width: 37.5%;"> <col style="width: 37.5%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>gradle/libs.versions.toml</code>(根)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>{name}-plugin/gradle/libs.versions.toml</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">依存関係の数</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">2-3 (プラグイン + README オプション)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">30+ (langchain4j, pgvector, cucumber…​)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">役割</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">プラグインを消費する</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">プラグインをビルド</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">それを読む人</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">プラグインの利用者</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">プラグインの開発者</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>ルートは意図的に最小限のカタログを持っています。プラグインはカタログを持っています。 完了。 混同は不可能です：各ビルドはそれぞれ固有のスコープを持ちます。 依存関係の。</p> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="ℹ️"></i> </td> <td class="content"> <div class="paragraph"> <p>依存関係の衝突をデバッグするのに既に1時間以上費やしたことがある場合 あなたのプラグインとテストプロジェクトの間で、その価値がわかる この分離。独立したカタログはこの問題を解消します 構成により。</p> </div> </td> </tr> </table> </div> </div> </div> </div> <div class="sect1"> <h2 id="_私たちがやらないこと">私たちがやらないこと</h2> <div class="sectionbody"> <div class="paragraph"> <p>このパターンは魔法的ではない。私が課す制約がある 喜んで私に課す：</p> </div> <div class="paragraph"> <p><strong>ルートはプラグインをビルドしません。</strong> あなたは`publishToMavenLocal` ou root がそれを消費する前に、リポジトリにデプロイする。</p> </div> <div class="paragraph"> <p>これは最小限のコストです。そしてそれが*適切な*制約です。ルート プラグインを外部クライアントのように消費する — Mavenを通じて。確かに サードパーティプロジェクトが行うように。プラグインが公開できない場合、 root がすぐに教えてくれます。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-shell hljs" data-lang="shell"># La seule "friction" du pattern $ cd codebase-plugin && ./gradlew publishToMavenLocal && cd .. $ ./gradlew tasks --group=codebase</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_比較ドッグフーディングに直面する3つのアーキテクチャ">比較：ドッグフーディングに直面する3つのアーキテクチャ</h2> <div class="sectionbody"> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 20%;"> <col style="width: 20%;"> <col style="width: 20%;"> <col style="width: 20%;"> <col style="width: 20%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">隔離されたプラグイン</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">モノレポ`include()`</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">複合`includeBuild()`</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ルート + 独立プラグイン</strong></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">`git clone && gradlew tasks`プラグインのタスクを与える</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">❌</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�✅</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">(No output, as there is no French text provided to translate)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ルートに依存しないビルドプラグイン</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�✅</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�❌</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�✅</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�✅</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">バージョン別カタログ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�✅</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�❌</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�✅</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ない`include()` ni <code>includeBuild()</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�✅</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�❌</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">❌</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�✅</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">設定なしのネイティブドッグフード</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">❌</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">⚠️</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"></think></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">独立したCIプラグイン</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�✅</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">❌</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">(empty string)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ルートは実際の消費の例</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">(Empty)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">⚠️</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�✅</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"></think> (No output as there is no French text provided to translate)</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>右�側の列はすべてのチェックボックスにチェックを入れます。それが理由で私は さらに後ろに戻ります。</p> </div> </div> </div> <div class="sect1"> <h2 id="_dag契約_サブディレクトリからはルートビルドが決して行われない">DAG契約 : サブディレクトリからはルートビルドが決して行われない</h2> <div class="sectionbody"> <div class="paragraph"> <p>このアーキテクチャは自然にDAG N0→N3に組み込まれます。 私のワークスペースから。パターンは：*プラグインN2はハブ 自身の依存関係において、N3のルートは終端です。 ハブ*を適用する</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultFontSize 11 title DAG契約 — コンシューマールート vs 独立プラグイン package "N3 — 根 (預金)" #FFCCCC { [build.gradle.kts (3 lignes)] as ROOT [libs.versions.toml (minimal)] as ROOT_TOML note right of ROOT plugins { bakery } bakery { configPath = ... } Aucune logique métier end note } package "N2 — {name}-プラグイン/" #CCFFCC { [build.gradle.kts (complet)] as PLUGIN [src/main/kotlin/] as SRC [gradle/libs.versions.toml] as PLUGIN_TOML [buildSrc/] as BUILDSRC note bottom of PLUGIN java-gradle-plugin signing + publish Tests unitaires + Cucumber CI dédiée end note } ROOT_TOML --> ROOT : "バージョン プラグイン" ROOT -down-> PLUGIN : "publishToMavenLocal" @enduml</pre> </div> </div> <div class="paragraph"> <p>Le <code>codebase-gradle/build.gradle.kts`6行です。 なし`src/</code>, ない`buildSrc/<code>, なし`gradle/rag-bench.gradle.kts</code>. 正しい <code>plugins { alias(libs.plugins.codebase) }`そしてリポジトリ。 すべての複雑さはそこにある`codebase-plugin/</code>。</p> </div> </div> </div> <div class="sect1"> <h2 id="_結論時間を節約する見かけの重複">結論：時間を節約する見かけの重複</h2> <div class="sectionbody"> <div class="paragraph"> <p>誰かにこの構造を示すとき、最初の反応 よくある：「でも、あなたは二つ`gradlew`, 二`settings.gradle.kts`, 二`libs.versions.toml`— それはただの複製です！</p> </div> <div class="paragraph"> <p>はい。そしていいえ。</p> </div> <div class="paragraph"> <p>「複製」は、同じ情報を2か所に再現すること。 ここで、これらは2つの*別々の*用途に使われる2つの*別々の*ファイルです： プラグインカタログ（30+ ビルダー用依存関係）およびカタログ ルートから(2-3の依存関係を消費する)。 プラグインのラッパー (開発用ロックされたバージョン) と ルートのラッパー (プラグインの演習用として、異なるバージョンである可能性があります).</p> </div> <div class="paragraph"> <p>これは複製ではありません。これは<strong>分離の �責任</strong> ビルドシステムに適用された。 各ビルド 一つのことだけを行う。 ルートが消費する。 プラグインがビルドされる。</p> </div> <div class="paragraph"> <p>コスト？ 一つの注文`publishToMavenLocal`プラグインのビルドの間 そしてルートのビルド。利点とは？建築的な明確さをもたらす 下流のデバッグに費やす時間を削減します。</p> </div> <div class="paragraph"> <p>このパターンをデプロイして以来`bakery-gradle`, <code>plantuml-gradle</code>, <code>codebase-gradle</code>, 他のプラグインの`foundry/public/<code>, 持っていません ターミナルを私のリポジトリの一つで開けたとき、二度とためらった。 最初の反射 —</code>./gradlew tasks`— 歩み続け、常に与える 良いタスクを教えてくれ、すぐにすべてが健全かどうかを教えてくれる。</p> </div> <div class="paragraph"> <p>それが良いアーキテクチャだ。それはREADMEには書かれていない。 端末でテストされ、10秒以内に完了します。</p> </div> </div> </div> <div class="sect1"> <h2 id="_参照">参照</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="0105_integrer_graphify_workflow_gradle_post.html">Article 0105 — Intégrer Graphify dans un workflow Gradle</a></p> </li> <li> <p><a href="0117_granularisation_oss_css_repositorie_workspace_post.html">Article 0117 — La Granularisation OSS/CSS</a></p> </li> <li> <p>記事 0123 — Knowledge Graph をレコメンデーション エンジンとして</p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2026/0123_knowledge_graph_moteur_recommandation_articles_connexes_post.html Tue, 12 May 2026 00:00:00 +0000 blog/2026/0123_knowledge_graph_moteur_recommandation_articles_connexes_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_シーン_火曜日_5月12日_17時30">シーン : 火曜日 5月12日 17時30</a></li> <li><a href="#_診断テンプレートが見逃す３つの関係のタイプ">診断：テンプレートが見逃す３つの関係のタイプ</a></li> <li><a href="#_解決策gradle_パイプラインホットな_llm_呼び出しではない">解決策：Gradle パイプライン、ホットな LLM 呼び出しではない</a> <ul class="sectlevel2"> <li><a href="#_アーキテクチャ_bakeryはgraphifyをインポートしエンジンはインポートしない">アーキテクチャ : BakeryはGraphifyをインポートし、エンジンはインポートしない</a></li> <li><a href="#_パイプライン_スキャン_グラフ_テンプレート">パイプライン: スキャン → グラフ → テンプレート</a></li> <li><a href="#_クロノロジカルフォールバック">クロノロジカルフォールバック</a></li> </ul> </li> <li><a href="#_エマージェントオントロジー_記事が互いを知らずに集まるとき">エマージェントオントロジー : 記事が互いを知らずに集まるとき</a></li> <li><a href="#_dag契約誰が誰に重要か">DAG契約：誰が誰に重要か</a></li> <li><a href="#_得られることと得られないこと">得られることと得られないこと</a></li> <li><a href="#_視点パブリックナレッジグラフとしてのブログ">視点：パブリックナレッジグラフとしてのブログ</a></li> <li><a href="#_結論ファイルシステムはテンプレートが無視するものを知っている">結論：ファイルシステムはテンプレートが無視するものを知っている</a></li> <li><a href="#_参照">参照</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 14 minutes</div> <p>あなたは pgvector と LangChain4j の統合に関する記事を読んでいます。ページの下部に、JBake 「関連記事」を提案されます。それをクリックします。それは…設定に関する記事です。 キティターミナルの。二つの間の唯一の共通点は？彼らは未満で公開されました 15日間隔。これは推奨ではありません。これは偽装されたカレンダーである 編集.</p> </div> </div> </div> <div class="sect1"> <h2 id="_シーン_火曜日_5月12日_17時30">シーン : 火曜日 5月12日 17時30</h2> <div class="sectionbody"> <div class="paragraph"> <p>私は自分の記事の一つを読み返しています — <a href="0106_knowledge_graph_outil_comprehension_codebase_post.html">celui sur le Knowledge Graph comme outil de compréhension de codebase</a> 内容は濃い：ノード、エッジ、コミュニティ、PlantUML、オンボーディング。記事 動員する15分間の読書テクニック`graphify-gradle`, <code>plantuml-gradle</code>, およびグラフトポロジーの概念。</p> </div> <div class="paragraph"> <p>ページ下部で、 「関連記事」 が提案しています：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>Firebase Contact Form (0113)の記事</p> </li> <li> <p>Eager/Lazy メカニズムに関する記事(0108)</p> </li> <li> <p>グラドルスクリプト→プラグインへの移行(0102)についての記事</p> </li> <li> <p>Ollama Pro(0120)のサブスクリプションの累積に関する記事</p> </li> </ol> </div> <div class="paragraph"> <p>これらの4つの記事のうち、3つは Knowledge Graph と <strong>全く</strong> 関係がない。 彼らはそこにいる理由は、彼らが最も新しく公開されたものだからだ — 時間的近接ではない 意味的近傍。</p> </div> <div class="paragraph"> <p>私はテンプレートを見ています`post.thyme`</think></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-xhtml hljs" data-lang="xhtml"><!-- Articles connexes (liens internes SEO) --> <th:block th:each="post,postStat : ${published_posts}"> <th:block th:if="${!post.uri.equals(content.uri) and postStat.index lt 4}"> ... </th:block> </th:block></code></pre> </div> </div> <div class="paragraph"> <p>`published_posts`時系列のリストです。`postStat.index lt 4`取る 現在の投稿ではない最初の4つです。それだけです。ロジックはありません。 類似性。内容の概念はない。ただのループ`for`として仮装されている 推奨。</p> </div> <div class="admonitionblock warning"> <table> <tr> <td class="icon"> <i class="fa icon-warning" title="⚠️"></i> </td> <td class="content"> <div class="paragraph"> <p>JBakeのバグではありません。これはすべてのデフォルトの動作です。 静的サイトジェネレータ：投稿のリストはフラットで、日付順に並んでいる。 テンプレートは持っているものでできることをする。</p> </div> </td> </tr> </table> </div> <div class="paragraph"> <p>しかし、それを受け入れる理由ではない。</p> </div> </div> </div> <div class="sect1"> <h2 id="_診断テンプレートが見逃す３つの関係のタイプ">診断：テンプレートが見逃す３つの関係のタイプ</h2> <div class="sectionbody"> <div class="paragraph"> <p>私の記事コーパス — 4か月で23件の投稿 — は豊かな構造を持っている 時系列テンプレートは完全に上書きします：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>明示的な参照</strong> : 使っています`xref:`私の記事で大量に。</p> </li> </ol> </div> <div class="paragraph"> <p>記事 0122 参照 0106 (ナレッジグラフ) および 0116 (区画) 認識論的)。 これらのリンクは編集による*hard linking*です — 私は 故意にこれらの概念を接続することを決めた。</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>共有タグ</strong>: 各記事には`:jbake-tags:`. 記事について</p> </li> </ol> </div> <div class="paragraph"> <p>Graphify + PlantUML (0105) a`gradle, graphify, plantuml, knowledge-graph`. Knowledge Graph (0106)の記事は <code>knowledge-graph, graphify, plantuml</code>. 7つのうち3つのタグが共通 — 43％の重複率。</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>共起する固有名詞</strong> : « pgvector », « RAG », « embedding</p> </li> </ol> </div> <div class="paragraph"> <p>4つの異なる記事に共同で現れる。 « LangChain4j », Ollama », « plugin Gradle » は他の六つにあります。これらはタグではありません。 宣言された — これらは*patterns émergents*のコーパスで、ただNLPだけが 検出できる。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center title 記事間の関係の3層 package "層 1 — 明示的な参照" #CCFFCC { [Article A] as A1 [Article B] as B1 A1 -down-> B1 : xref: note right of A1 Liens durs Déterministes Déjà dans graph.json end note } package "レイヤー 2 — 共有タグ" #FFFFCC { [Article A] as A2 [Article C] as C2 A2 ..> C2 : tag_cooccurrence note right of A2 Poids = tags communs / tags totaux Déterministes À extraire via graphify end note } package "層3 — エマージェントオントロジー" #FFCCCC { [Corpus A] as A3 [Corpus B] as B3 A3 ..> B3 : entity_overlap note right of A3 Clusters NLP Co-occurrences d'entités nommées TF-IDF / cosine similarity end note } @enduml</pre> </div> </div> <div class="paragraph"> <p>今日、私のサイトはこれらの三つの層の*いずれも*使っていない。それは使う ゼロ層: Javaリストにおける挿入順序</p> </div> </div> </div> <div class="sect1"> <h2 id="_解決策gradle_パイプラインホットな_llm_呼び出しではない">解決策：Gradle パイプライン、ホットな LLM 呼び出しではない</h2> <div class="sectionbody"> <div class="paragraph"> <p>最初の誘惑は、bakeの瞬間にLLMを呼び出すことでしょう：「Pour この記事は、コーパスの中で最も類似している3つの記事を見つける。 それをしないでください。</p> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="❗"></i> </td> <td class="content"> <div class="paragraph"> <p>各回のLLM呼び出し`./gradlew bake`時間とお金がかかり、 ビルドに非決定性を導入します。LLMの応答は 内容が変わらないまま、二つのビルド間を切り替える。あなたのCIが変化する。 再現できないため、あなたのテストは不安定になります。</p> </div> </td> </tr> </table> </div> <div class="paragraph"> <p>解決策は決定論的です：事前にグラフを計算するGradleパイプライン 類似性があり、それを保存します`graph.json`. テンプレートは結果を読み取ります — 彼は決して計算を開始しない。</p> </div> <div class="sect2"> <h3 id="_アーキテクチャ_bakeryはgraphifyをインポートしエンジンはインポートしない">アーキテクチャ : BakeryはGraphifyをインポートし、エンジンはインポートしない</h3> <div class="paragraph"> <p>これは建築における最も重要な点です。 誘惑は…することになるだろう コラボレーションをケーブルする中で`engine/build.gradle.kts`：engine適用する スキャン用にgraphify、ベイク用にbakery、そしてエンジンがその間をつなぐ 両方。</p> </div> <div class="paragraph"> <p>これはアンチパターンです。Engine は <strong>消費者端末</strong> — それは適用する プラグインに関するビジネスロジックは実装していません。ルールは： <strong>�証明の責任はプロプライエタリなプラグインにあります。</strong></p> </div> <div class="listingblock"> <div class="title">正しいアーキテクチャ — Bakery は Graphify をインポートする</div> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam packageBackgroundColor #FFF3CD title Bakery が Graphify をインポートします — Engine は何も知りません package "N3 — エンジン" #FFCCCC { [engine/build.gradle.kts] as ENG note right of ENG plugins { bakery } Zéro connaissance de graphify 4 tâches, ~150 lignes end note } package "N2 — ベーカリー" #CCFFCC { [bakery-plugin] as BAK note right of BAK plugins { graphify } ← import interne Lit graph.json Résout articles connexes Expose le modèle à JBake end note } package "N0 — GRAPHIFY" #CCE5FF { [graphify-plugin] as GRF note right of GRF Scan workspace → graph.json Enrichi avec : - xref: edges - co-occurrences de tags - entités nommées (NLP) end note } ENG -down-> BAK : "プラグイン { ベーカリー }" BAK -down-> GRF : "プラグイン { グラフィファイ } ← N2→N0 オーケー" @enduml</pre> </div> </div> <div class="paragraph"> <p>DAG契約は守られています：bakery (N2) が graphify (N0) をインポートしています、N2 > N0, 違反はありません。エンジン (N3) はベーカリー (N2) をインポートします。N3 > N2、OK。</p> </div> <div class="paragraph"> <p>Engineには参照するコードの行が*ひとつも*ありません`graph.json`, <code>relatedPosts</code>, または他の類似性の概念も。 彼はbakeryを適用する、点。 その コラボレーションはベーカリー内部です。</p> </div> </div> <div class="sect2"> <h3 id="_パイプライン_スキャン_グラフ_テンプレート">パイプライン: スキャン → グラフ → テンプレート</h3> <div class="paragraph"> <p>以下は3段階の完全なパイプラインです：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>スキャン</strong> (グラフ化) :`graphify-plugin`ワークスペースをスキャンします。彼/彼女の</p> </li> </ol> </div> <div class="paragraph"> <p>現在の形、すでにそれらを検出している`xref:`の間`.adoc`そして ～にさらす`graph.json`タイプのedgesのような`reference`.<br> 私たちはそれを編集コンテンツのために豊かにします： * JBakeのメタデータを解析 (<code>:jbake-tags:</code>, <code>:jbake-description:</code>) それぞれの`.adoc`ブログの * タグの共起を計算 → edges`tag_cooccurrence`重さとともに * 名前付きエンティティをTF-IDFを使って説明から抽出 → エッジ`entity_overlap` セクションを注入する`blog_articles`の中`graph.json`存在する<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// Extrait de l'enrichissement graphify pour le blog fun enrichBlogSection(graphJson: File, blogDir: File): GraphJson { val articles = blogDir.listFiles { f -> f.extension == "adoc" } .map { parseJbakeMetadata(it) } val nodes = articles.map { ArticleNode(it.slug, it.title, it.tags) } val edges = mutableListOf<GraphEdge>() // Couche 1 : xref (déjà fait par scanWorkspace) // Couche 2 : co-occurrences de tags for (a in articles) { for (b in articles) { if (a.slug == b.slug) continue val common = a.tags.intersect(b.tags) if (common.isNotEmpty()) { edges.add(GraphEdge( source = a.slug, target = b.slug, type = "tag_cooccurrence", weight = common.size.toDouble() / (a.tags.size + b.tags.size) )) } } } return graphJson.copy( blogArticles = BlogSection(nodes, edges) ) }</code></pre> </div> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>Bake</strong> (bakery) : その瞬間の`./gradlew bake`, `BakeryPlugin`ベッド</p> </li> </ol> </div> <div class="paragraph"> <p>`graph.json`そして関連記事を各投稿ごとに解決します。<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// BakeryPlugin — résolution des articles connexes fun resolveRelatedPosts( currentSlug: String, graph: GraphJson, maxResults: Int = 4 ): List<RelatedPost> { val edges = graph.blogArticles.edges .filter { it.source == currentSlug || it.target == currentSlug } return edges .sortedByDescending { it.weight } .take(maxResults) .map { edge -> val relatedSlug = if (edge.source == currentSlug) edge.target else edge.source graph.blogArticles.nodes.first { it.slug == relatedSlug } } }</code></pre> </div> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>Template</strong> (<code>post.thyme</code>) : JBakeモデルは現在、Mapを受け取ります</p> </li> </ol> </div> <div class="paragraph"> <p>平坦な時系列リストではなく、構造化されたもの。<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-xhtml hljs" data-lang="xhtml"><!-- Articles connexes basés sur le Knowledge Graph --> <th:block th:if="${relatedPosts != null and !relatedPosts.empty}"> <section class="mt-5 pt-4 border-top"> <h2 class="h4 mb-3">Articles connexes</h2> <th:block th:each="related : ${relatedPosts}"> <div class="mb-2"> <a th:href="${content.rootpath} + ${related.uri}" th:text="${related.title}" class="fw-semibold"></a> <br/> <small class="text-muted"> <th:block th:each="reason,iterStat : ${related.reasons}"> <span class="badge bg-light text-dark" th:text="${reason}"></span> </th:block> </small> </div> </th:block> </section> </th:block></code></pre> </div> </div> <div class="paragraph"> <p>テンプレートは同じです — それはデータがどこから来たかを知りません。 ベーカリーとJBakeの間の契約だけが変更されました：<code>published_posts</code>(リスト 時系列) なる`relatedPosts`(グラフによる重み付けマップ)</p> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="ℹ️"></i> </td> <td class="content"> <div class="paragraph"> <p>「理由」バッジ（例：<code>xref 0122</code>, <code>tag:gradle</code>, <code>cluster:pgvector-rag</code>) 読者に説明します <strong>pourquoi</strong> この記事は関連しています。これは～ではない 透明性だけ — それはトポロジーの教育法だ あなた独自のコンテンツ。</p> </div> </td> </tr> </table> </div> </div> <div class="sect2"> <h3 id="_クロノロジカルフォールバック">クロノロジカルフォールバック</h3> <div class="paragraph"> <p>Si `graph.json`存在しない（ローカルビルド、事前スキャンなし、最初） デプロイ, CIはまだスキャン グラフファイ), テンプレート 優雅に劣化しなければならない：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">fun resolveRelatedPosts(currentSlug: String, graph: GraphJson?): List<RelatedPost> { if (graph != null && graph.blogArticles != null) { return resolveFromGraph(currentSlug, graph) } // Fallback chronologique — même comportement qu'aujourd'hui logger.warn("[bakery] graph.json absent — fallback chronologique") return resolveFromChronology(currentSlug) }</code></pre> </div> </div> <div class="paragraph"> <p>デフォルトの動作は現在の動作と同じです。その レコメンデーションエンジンは、<strong>段階的な改善</strong> — ではない ブレイキング・チェンジ。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_エマージェントオントロジー_記事が互いを知らずに集まるとき">エマージェントオントロジー : 記事が互いを知らずに集まるとき</h2> <div class="sectionbody"> <div class="paragraph"> <p>最も興味深い層は第三層：新興オントロジーです。 引用されない記事で、同じタグを持たないものだが 同じことを話している人は、それに気づいていない。</p> </div> <div class="paragraph"> <p>具体的な例を挙げましょう。 私のコーパスから3つの記事：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>0119 — ベンチマーク DGX Spark 対 クラウド サブスクリプション LLM</p> </li> <li> <p>0121 — Gradle プラグイン Ollama Pro 2 インスタンスを操作</p> </li> <li> <p>0122 — 効率比 27x 45x IAエキスパートフリート</p> </li> </ol> </div> <div class="paragraph"> <p>これらの3つの記事には、<strong>aucun</strong> xref がありません。彼らのタグは 彼らは20％しかカバーしていません（「ollama」、「llm」が共通です）。しかし軽量な NLP です。 説明について明らかなクラスターが示される：« コスト », « サブスクリプション », クラウド », « GPU », « APIキー », « Ollama Pro », « 効率 », « 比率</p> </div> <div class="paragraph"> <p>彼らはオントロジー的クラスターを形成します：<strong>LLMセルフホストドの経済 vs cloud</strong> このクラスターはどこにも宣言されていません。コーパスから現れます。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam packageBackgroundColor #E8F8F5 title Cluster Ontologique Émergent — "LLMセルフホステッド経済" package "クラスター検出 : 経済-LLM" #D5F5E3 { [0119 — Benchmark DGX Spark\nvs Cloud Abonnement] as A [0121 — Plugin Gradle Piloter\nDeux Instances Ollama Pro] as B [0122 — Ratio Efficacité\n27x 45x Flotte Experts] as C } A .. B : entity_overlap (0.73) B .. C : entity_overlap (0.81) A .. C : entity_overlap (0.68) note bottom of A Aucun xref entre ces articles. Tags communs : "オラマ", "llm". Cluster découvert par NLP : co-occurrences "コスト", "GPU", "サブスクリプション", "オラマ プロ". end note @enduml</pre> </div> </div> <div class="paragraph"> <p>このオントロジークラスターは複合エッジになります。<code>graph.json</code>:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{ "source": "0119-benchmark-dgx-spark", "target": "cluster:economie-llm", "type": "entity_cluster", "weight": 0.73, "metadata": { "clusterLabel": "Économie LLM Self-Hosted vs Cloud", "commonEntities": ["coût", "GPU", "abonnement", "Ollama Pro", "ratio"], "articlesInCluster": [ "0119-benchmark-dgx-spark", "0121-ollama-pro-deux-instances", "0122-ratio-efficacite-flotte-experts" ] } }</code></pre> </div> </div> <div class="paragraph"> <p>NLPは意図的に軽量です — TF-IDF + コサイン類似度（sur les） 説明。BERTは必要ありません、言語モデルは必要ありません。 コーパスは23件の記事で構成されており、類似度行列は1つに収まります 50 KoのJSONファイル。</p> </div> <div class="admonitionblock tip"> <table> <tr> <td class="icon"> <i class="fa icon-tip" title="💡"></i> </td> <td class="content"> <div class="paragraph"> <p>NLPの力は、アルゴリズムの高度さから来なくて しかし、*コーパスのサイズ*と*説明の品質*によるものです。 一つ `:jbake-description:`よく書かれた150文字はもっと含んでいる TF-IDFに、3000語の記事全体であることを示す信号。</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_dag契約誰が誰に重要か">DAG契約：誰が誰に重要か</h2> <div class="sectionbody"> <div class="paragraph"> <p>これは建築の規律が報われる点です。DAG N0→N3 で定義されている`engine/build.gradle.kts`簡単なルールを与える： どのプロジェクトも上位のプロジェクトとは関係ない。</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 18.1818%;"> <col style="width: 18.1818%;"> <col style="width: 18.1818%;"> <col style="width: 18.1818%;"> <col style="width: 27.2728%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">コンシューマープラグイン</th> <th class="tableblock halign-left valign-top">インポートされたプラグイン</th> <th class="tableblock halign-left valign-top">消費者レベル</th> <th class="tableblock halign-left valign-top">インポートされたレベル</th> <th class="tableblock halign-left valign-top">有効ですか？</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">bakery-gradle</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">graphify-gradle</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">N2</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">N0</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅ N2 > N0 — OK</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">エンジン</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">bakery-gradle</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">N3</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">N2</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅ N3 > N2 — OK</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">エンジン</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">graphify-gradle</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">N3</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">N0</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�✅ 技術 OK, しかし <strong>概念的に間違っている</strong> — コラボレーションはbakery内部にある</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>Engine 適用する bakery. Bakery 適用する graphify. それだけです。ある日 ベクトルストアコードベース (N1) を研究のために追加したいです。 クロス・コーパスの意味解析、ベーカリーもインポートします。Engineは変わりません。</p> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="❗"></i> </td> <td class="content"> <div class="paragraph"> <p>パターンは：<strong>プラグイン N2 は自身の依存関係のハブです</strong>。 エンジンN3はハブではありません―それはハブを適用するターミナル。</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_得られることと得られないこと">得られることと得られないこと</h2> <div class="sectionbody"> <div class="paragraph"> <p>主な利益は編集的で、技術的ではない：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 50%;"> <col style="width: 50%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">前に</th> <th class="tableblock halign-left valign-top">後</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">関連記事 = 最新4件の投稿</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">関連記事 = Knowledge Graph での重み上位 4件</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">読み手はRAGを読む → Kitty Terminalの推奨</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">リーダーが RAG を読む → pgvector、チャンク化、ベクターストアの推奨</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">なぜについての透明性はゼロ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">バッジ`xref 0122`, <code>tag:gradle</code>, `cluster:rag`見える</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">JBake標準、ゼロ労力、ゼロ価値</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">決定的、再現可能、テスト可能なグレードルパイプライン</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">読者に学習曲線はありません</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">読者は私のコンテンツの*トポロジー*を発見する</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>得られないもの：</p> </div> <div class="ulist"> <ul> <li> <p>これは « 本当の » レコメンデーション エンジンではない (コラボラティブ</p> </li> </ul> </div> <div class="paragraph"> <p>filtering,A/B testingなし,feedback loopなし)</p> </div> <div class="ulist"> <ul> <li> <p>品質はJBakeのメタデータの豊富さに依存します — もしあなたの</p> </li> </ul> </div> <div class="paragraph"> <p>説明は空です、TF-IDFは何も見ません</p> </div> <div class="ulist"> <ul> <li> <p>NLPはオフラインです — 新しい記事はただクラスター化されているだけです</p> </li> </ul> </div> <div class="paragraph"> <p>次のスキャン (いいね：ビルドは依然として決定的です)</p> </div> </div> </div> <div class="sect1"> <h2 id="_視点パブリックナレッジグラフとしてのブログ">視点：パブリックナレッジグラフとしてのブログ</h2> <div class="sectionbody"> <div class="paragraph"> <p>この機能はより広い視点を開く：もし～なら`cheroliv.com` 彼は自分自身が*ナビゲータブルな知識グラフ*になったのか？</p> </div> <div class="paragraph"> <p>記事はノードです。タグはコミュニティです。xrefは �辺。読者はもはや孤立した記事を読まず — 彼は～の中をナビゲートする <strong>知識グラフ</strong> 現在の記事がエントリーポイントです。</p> </div> <div class="paragraph"> <p>時系列のリストを表示しないホームページを想像してください 最新の投稿だが、<strong>コーパスマップ</strong>：オントロジーのクラスター, ピボット記事（エッジが最も多いもの）, 読み取りパス おすすめ「もしGraphifyの記事が気に入ったら、次に読んでください Knowledge Graphを理解するためのツールとしてのもの</p> </div> <div class="paragraph"> <p>これはもうブログではない。これは*セマンティックアトラス*です。</p> </div> <div class="paragraph"> <p>そしてこれはSFではありません。その`graph.json`既に存在しています。 彼に欠けているのはナビゲーションインターフェースだけだ。</p> </div> </div> </div> <div class="sect1"> <h2 id="_結論ファイルシステムはテンプレートが無視するものを知っている">結論：ファイルシステムはテンプレートが無視するものを知っている</h2> <div class="sectionbody"> <div class="paragraph"> <p>私が火曜日の夜に考案したのは、ヒューリスティックの置き換えです。 怠惰な（年代順）による忠実な表現の 私のコーパスの構造 (Knowledge Graph)。</p> </div> <div class="paragraph"> <p>テンプレート`post.thyme`変わらない。変わるのは、私たちが 彼に食べ物を与える。 前 : 並び替えられた Java リスト`date`. 後： 3つの解析層から導出された重み付きグラフ — xrefs, 共起 タグ、およびNLPによる新興オントロジー</p> </div> <div class="paragraph"> <p>ループが閉じられました。 graphifyはワークスペースをスキャンします。 Bakeryは グラフとテンプレートを埋める。 読者はおすすめを見る そしてエンジン — 指揮者 — はそれについてさえ知らないと それらはすべて存在する。</p> </div> <div class="paragraph"> <p>これで正しいアーキテクチャです。各プラグインは一つのことだけを行います。 消費者端末はどのようにするかを知る必要はありません。</p> </div> </div> </div> <div class="sect1"> <h2 id="_参照">参照</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="0105_integrer_graphify_workflow_gradle_post.html">Article 0105 — GraphifyをGradleワークフローに組み込む</a></p> </li> <li> <p><a href="0106_knowledge_graph_outil_comprehension_codebase_post.html">記事0106 — ナレッジグラフを理解のためのツールとして</a></p> </li> <li> <p>記事0117 — OSS/CSSの細分化</p> </li> <li> <p><a href="0121_plugin_gradle_piloter_deux_instances_ollama_pro_post.html">記事 0121 — Gradle プラグイン Ollama Pro の 2 インスタンスを操作</a></p> </li> <li> <p><a href="0122_ratio_efficacite_27x_45x_flotte_experts_ia_vs_claude_gpt_post.html">Article 0122 — 27× から 45× より効率的 : AIエキスパートフリート</a></p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2026/0122_ratio_efficacite_27x_45x_flotte_experts_ia_vs_claude_gpt_post.html Mon, 11 May 2026 00:00:00 +0000 blog/2026/0122_ratio_efficacite_27x_45x_flotte_experts_ia_vs_claude_gpt_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_問題なぜファインチューンではなくragを使わないのか">問題：なぜファインチューンではなくRAGを使わないのか？</a></li> <li><a href="#_考え_専門家の艦隊単一のモデルではない">考え: 専門家の艦隊、単一のモデルではない</a></li> <li><a href="#_拡大鏡で見たコードベース_7_900_ファイル144_000_行">�拡大鏡で見たコードベース : 7 900 ファイル、144 000 行</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 22 minutes</div> <p>日常的にソフトウェア開発でLLMを使うと、いつも同じ壁にぶつかることになります：モデルは*あなたの*コードベースを知りません。それはあなたがそのようなパターンを使っていることを知らないhttps://fr.wikipedia.org/wiki/Graphe_orient%C3%A9_acyclique[DAG], そのような Gradle の慣習, そのような認識論的層構造 あなたのhttps://fr.wikipedia.org/wiki/AsciiDoc[.adoc]. それから彼にコンテキストを注入し、繰り返し、修正し、反復する。そして時間―そしてお金―が過ぎていく。</p> </div> <div class="paragraph"> <p>だから私は率直に質問した：私のワークスペースでファインチューニングされたモデルのチームを作るにはどれくらいのコストがかかるだろうか、*私のスタイル*でコードを出力でき、毎回説明する必要なく動くチームは。特に：このアプローチは、Claude、GPT、Gemini、Grokなどの従来の propietary ソリューションとどう比べられるだろうか？</p> </div> <div class="paragraph"> <p>返答に驚いた。私が想像していたよりもはるかに少なかった。そして、業界の巨人たちと比較したコストパフォーマンスの比率はとんでもない。詳細は以下の通りです。</p> </div> </div> </div> <div class="sect1"> <h2 id="_問題なぜファインチューンではなくragを使わないのか">問題：なぜファインチューンではなくRAGを使わないのか？</h2> <div class="sectionbody"> <div class="paragraph"> <p>RAGは良いです。<a href="0106_knowledge_graph_outil_comprehension_codebase_post.html">私のナレッジグラフ</a>と<a href="0116_compartimentage_epistemique_automatise_llm_post.html">私の認識の区画化</a>は機能しています。しかし、RAGには根本的な欠点があります：各クエリごとに、関連するコンテキストを再注入しなければなりません。あなたのプロンプトは伸び、遅延は爆発し、モデルは決してあなたのパターンを*内面化*せず—常に外部のドキュメントとして読み取ります。</p> </div> <div class="paragraph"> <p>ファインチューンこそが筋肉の記憶です。モデルは*知っている*が、君は書いている`build.gradle.kts`記録されたタスクを介して`tasks.register`, あなたの`AGENTS.adoc`標準的な構文に従い、あなたのワークスペースはboroughsに構造化されている。彼には思い出させる必要はない。</p> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="ℹ️"></i> </td> <td class="content"> <div class="paragraph"> <p>ファインチューニングはRAGの代替ではありません。これは補完的なレイヤーです。RAGは頻繁に変化するデータ（ログ、チケット、最近のコミットなど）に対して依然として関連があります。ファインチューニングは長期的な構造的かつスタイル的な知識のために用いられます。</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_考え_専門家の艦隊単一のモデルではない">考え: 専門家の艦隊、単一のモデルではない</h2> <div class="sectionbody"> <div class="paragraph"> <p>ワークスペース全体に対して1つだけファインチューニングされたモデルでもそれはまあまあ良いです。しかしそれは最適ではありません。私のワークスペースは非常に異なる分野をカバーしています ：</p> </div> <div class="ulist"> <ul> <li> <p>Gradleプラグイン(Kotlin、規約プラグイン、複合ビルド)</p> </li> <li> <p>DAGエンジン (Kotlin, スケジューリング, 実行)</p> </li> <li> <p>LLMエージェント (Python, LangChain4j, RAG)</p> </li> <li> <p>アーキテクチャドキュメント (AsciiDoc, ガバナンス)</p> </li> <li> <p>インフラ/DevOps（Docker、GitHub Actions、CI/CD）</p> </li> </ul> </div> <div class="paragraph"> <p>単一のモデルはどこでもそれなりに良いが、どこでも優れているわけではない。解決策？一つ<strong>専門モデルの艦隊</strong>、オーケストレーターが各リクエストを適切なエキスパートにルーティングします</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FAFAFA skinparam defaultFontSize 13 package "Ollama クラウド" { rectangle "DeepSeek V4-Pro 1.6T / 49B 資産" as V4Pro #FF6B6B rectangle "6× V4-Flash-FT 292B / 13B 資産" as Flash #4ECDC4 rectangle "6× Gemma4 26B-FT\n26B / 3.8B アクティブ" as Gemma #FFE66D rectangle "5× Qwen3.6 35B-FT 35B / 3B アクティブ" as Qwen36 #A8E6CF rectangle "5× Qwen3.5 35B-FT\n35B / 3B アクティブ" as Qwen35 #FF8B94 } note bottom of Qwen35 À partir de 17€/mois (1× Ollama Pro annual) Extensible par cumul de comptes Pro selon la méthode Docker. end note actor Utilisateur as User User --> V4Pro : Requête V4Pro --> Flash : "複雑なGradleタスク" V4Pro --> Gemma : "AsciiDoc のフォーマット" V4Pro --> Qwen36 : "Kotlinのリファクタリング" V4Pro --> Qwen35 : "Bashスクリプト" note right of V4Pro L'orkestrateur route la requête vers l'expert le plus pertinent. Zéro prompt engineering répétitif. end note @enduml</pre> </div> </div> <div class="paragraph"> <p>総艦隊：<strong>1 オーケストレータ + 22 エキスパート = 23 モデル</strong>そして、月間の推論コストはいくらですか？<strong>17ユーロ/月</strong>Ollama Pro年間サブスクリプション — クォータを超過した場合はアカウントの累積により拡張可能で、これは <a href="0120_cumuler_deux_abonnements_ollama_pro_docker_post.html">Dockerマルチアカウント方法</a> で示されています。基本料金は17ユーロからで、実際のニーズに応じて段階ごとに20ユーロずつ追加します。無駄はありません。</p> </div> </div> </div> <div class="sect1"> <h2 id="_拡大鏡で見たコードベース_7_900_ファイル144_000_行">�拡大鏡で見たコードベース : 7 900 ファイル、144 000 行</h2> <div class="sectionbody"> <div class="paragraph"> <p>トレーニングのコストを見積もる前に、何をトレーニングすべきかを知る必要があります。私は、Gitによって無視されるものを厳密に除外して、ワークスペースを監査しました。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">---- ---- build/ out/ node_modules/ runtimes/ .gradle/ dist/ target/ venv/ __pycache__/ .cache/ .tox/ ---- 以下は、追跡されているファイルのみの結果です： [cols="2,2"] |=== |メトリック |値 |追跡されたソースファイル |**7 896** |コード行数(LOC) |**百四十三千八百五** |Git リポジトリ |**二十六** |主要な言語 |Kotlin (1 903), AsciiDoc (2 765), Python (5 029) |=== [IMPORTANT] ==== これらの5,000+のPythonファイルには`runtimes/`ノートブックとユーティリティスクリプト。アプリケーションのコア（Gradleプラグイン、DAGエンジン、エージェント）は主にKotlinとAsciiDocで書かれています。 ==== 私はこの質量から合成データセットを生成できると推定します**約1億7000万トークン**インストラクターLLMを経由して (コードベースを命令/応答ペアに蒸留する). === 専門家タイプ別のデータセットの詳細 [source,text] ---- Dataset maître (généraliste V4-Flash) : 50M tokens Expert Gradle/Build : 15M tokens Expert Kotlin/DAG : 15M tokens Expert AsciiDoc/Gouvernance: 15M tokens Expert Agent/LLM/Python : 15M tokens Expert Infra/CI-CD : 15M tokens Micro-experts Qwen/Gemma : ~5M tokens chacun ---- == モデルの選択 : 100% MoE, ゼロ dense そこに建築が本当に効率的になります。 *dense* モデルは、各トークンで全ての重みをアクティベートします。*MoE* (Mixture of Experts) モデルは、そのパラメータの一部のみをアクティベートします。推論およびファインチューニングのコストは、パラメータ数に比例します。**有効**, パラメータには適用されません**保存された**。 Ollama Cloudでは、今日市場がMoE向けに提供しているものを見てみましょう： [cols="3,2,2,1,3"] |=== |モデル |総パラメータ数 |活性化された |活性化 |Ollama クラウド |DeepSeek V4-Pro |1.6T |49B |3.1% |ネイティブ |ディープシーク V4-Flash |292B |13B |4.5% |�✅ ネイティブ |Gemma 4 26B-A4B |26B |38億 |14.6% |�✅ ネイティブ |Qwen3.6-35B-A3B |35B |3B |8.6% |❌ (まだ統合されていません) |Qwen3.5-35B-A3B |35B |3B |8.6% |�✅ ネイティブ |�❌ Qwen3.5-27B |27B |27B |100%濃密 |排除された |❌ Qwen3.5-4B/9B |4B/9B |4B/9B |100％濃密 |除去された |�❌ Gemma 4 31B |31B |31B |100% 密集 |除去された |�🧪 Gemma 4 E2B/E4B |5B/8B |5B/8B |100% 密集している |バリデーションパイプライン |=== [CAUTION] ==== アクティベーション比率が判別基準です。Gemma 4 26B-A4Bは26Bのパラメータのうち3.8Bのみをアクティベートします — これは密な27Bの7倍少なく、コーディングエージェントの性能が同等です（LiveCodeBench v6で77.1%対80%）。 ==== === なぜ私が密なモデルをやめるのか 例外：Gemma 4 E2B と E4B。これらの2つのモデルは Apache 2.0 ライセンスで、コストを抑えてトレーニングパイプラインをテストおよび検証するのに最適です。E2B での 2-3 時間の実行は $5 未満のコストです。データセットまたはハイパーパラメータに問題がある場合、わずか数ドルでそれを知ることができます。パイプラインが整ったら、超マイクロタスク（単純な再フォーマット、二値分類）にも使用できます。しかし、メインフリートのエキスパートについては、私は MoE を使い続けます。なぜかというと： 。しかしそれだけじゃない：Gemma 4 E2B/E4Bは、細やかな匿名化の専門家だ [NOTE] ==== Google はこれらの小さなモデルをネイティブなツール呼び出しにおいて競争力があるように設計しました — 彼らは関数を呼び出し、正規表現を操作し、パターンを検索することができます。匿名化の例（メール、トークン、UUID、ファイルパス）でファインチューニングすると、彼らは**データセットの匿名化ツール**超高速。 彼らは生テキストのブロックを与え、彼らは呼ぶ`sed`(No text to translate, so output empty)`regex`via ツールコール を呼び出し、クリーンなブロックを返却します。推論コストは微々たるものです：5B がアクティベートされ、エントリーレベルのシングル GPU で十分です。これらのモデルは業界の専門家ではありません — それらは**熟練労働者**データセットの生産チェーンの中 ==== * そのトレーニング用VRAM（QLoRAでも）は、それに比例する**27B 合計** * 彼のトレーニング時間は、に比例する**27B が有効** Qwen3.6-35B-A3B (MoE) と比較してみましょう： [cols="3,2,2,2"] |=== | |Qwen3.5-27B (dense) |Qwen3.6-35B-A3B (MoE) |比率 |VRAM QLoRA |~55 GB |~35 GB |1.6× |GPU時間 (8M トークン) |約12時 |約4時間 |**3×** |ファインチューンあたりのコスト |~$24 |~$8 |**3×** |SWE-bench Verified |75.0% |73.4% |比較可能 |=== MoEはエージェントコーディングの性能を5%程度で、訓練コストが3倍少なくなります。22人の専門家の間で、差額は数千ユーロに上ります。 == トレーニングの見積もり: 811 H100時間 QLoRA 4-bit でモデルごとのトレーニングコストを、前述のデータセットに基づいて内訳した。 === �軽量なマイクロエキスパートMoE(3-3.8B活性化された) これらのモデルは、実行ごとに H100 (80 GB) が 1 つ必要です。 Q4 のモデルの VRAM は約 13–18 GB であり、LoRA オプティマイザー状態およびアクティベーション用に十分な余裕があります。 [cols="4,2,3,2"] |=== |モデル |実行回数 |GPU時間/実行 |合計 GPU時間 |Gemma 4 26B-A4B-FT |6 |3.5 h |**21時** |Qwen3.6-35B-A3B-FT |5 |4.0 h |**20 時間** |Qwen3.5-35B-A3B-FT |5 |4.0 h |**20時** |マイクロ 小計 | | |*61 h* |=== === V4-Flash エグゼクティブ (13B 有効 / 292B 保存) DeepSeek V4-Flashは特別なケースです。トークンあたり13Bしかアクティベートされませんが、Q4のフルモデルは約142 GBあります — トレーニング中はすべてのエキスパートがVRAMに存在する必要があります。したがって**3× H100**走ることによって快適になるため [cols="4,2,3,3,2"] |=== |モデル |データセット |GPU |時間 |合計GPU時間 |V4-Flash-Base 汎用 |50M トク |3× H100 |50 h |**150 時間** |V4-Flash エキスパート ×5 |15M トークン |3× H100 |40 h |**600時間** |*幹部小計* | | | |*750 h* |=== [cols="3,2,1"] |=== |**合計** | |**811 H100-h** |=== [NOTE] ==== 比較として、QLoRAなし（すべての重み）でV4-Flashをフルファインチューンすると、6モデルだけで約4 000 H100時間かかる。QLoRAはコストを5分の1に削減する。これがこの規模でプロジェクトを経済的に実行可能にする唯一の方法である。 ==== === GPUの料金：2026年5月に誰が何を借りているか 私は主要なH100レンタル業者をベンチマークしました。メーター価格、811時間分。 [cols="3,2,2,2"] |=== |�貸主 |$/H100·h |合計 811時間 |信頼性 |**Vast.ai スポット** |$1.60 |**$1,298** |★★☆ 中断可能 |**クルーソー クラウド** |$2.00 |**$1 622** |★★★★ 信頼できるデータセンター |FluidStack |$1.98 |$1 606 |★★★ |TensorDock |$1.80 |$1 460 |★★☆ |RunPod |$2.29 |$1 857 |★★★ 良い妥協 |CoreWeave |$2.25 |$1 825 |★★★★ 企業 |ラムダ・ラボ |$2.49 |$2 019 |★★★★ プレミアム |=== [TIP] ==== Vast.ai のスポットは最も安いですが、実行はいつでも中断される可能性があります。トレーニングにはリスクがあります。Crusoe は $2.00/h で、信頼性と価格のバランスが最も良いです。Vast と比較した $324 の追加コストは、心の平穏に値します。 ==== === Wall-clock : すべてをトレーニングするのにどのくらい時間がかかりますか？ 単一の3× H100ノードでは、31回の実行（汎用1 + エキスパート30）は約**12日間**シーケンシャルで。 もしノードを2つ並列で借りると、それに落ちる**6日**。 実際には、マイクロエキスパートは個別のノード（それぞれ1つのH100）で稼働し、その間にV4‑Flashが3×H100のノードを占有します。賢いスケジューリングを用いると： ---- Nœud A (3× H100) : V4-Flash généraliste → V4-Flash experts ×5 (11 jours) Nœud B (1× H100) : Gemma 4 26B ×6 → Qwen 36 ×5 → Qwen 35 ×5 (6 jours) 7日間のレンタル、すべて折りたたみ。 == 推論: Ollama Cloud で 23 のモデルが月額 17 ユーロから これは建築で最もエレガントな部分です。 Ollama Cloud はプライベートモデルをアップロードすることができます（Pro プランの機能）。私の22個のファインチューニング済みモデルは、…にプッシュされます`.gguf`私の Ollama スペースで、プライベートとしてマークされ、標準 API を介してアクセス可能です。 [plantuml, inference-flow, svg] ---- @startuml skinparam backgroundColor #FAFAFA skinparam defaultFontSize 12 |Utilisateur| start :Tâche de développement; |Orkestrateur (V4-Pro)| :Classifier la tâche\n(domaine + complexité); if (Tâche simple,\nspécialisée ?) then (oui) :Router vers micro-expert\n(Gemma 4 26B-A4B-FT\n ou Qwen3.6-35B-A3B-FT); elseif (Tâche complexe,\nconventions fortes ?) then (oui) :Router vers exécutif\n(V4-Flash-FT); else (non) :Résoudre avec V4-Pro\n(architecture, décision); endif |Modèle ciblé| :Génère le code/output\n**dans mon style**,\n90%+ first-shot correct; :Retourne la réponse; stop @enduml ---- === 17€/月から始め、必要に応じてスケールします。 Ollama Proプラン（年間17€/月）は3つの競合クラウドモデルを許可します。このアーキテクチャでは、同時に2～3人の専門家以上が必要になることは決してありません： * 分類フェーズ (V4-Pro) は 1 スロットを占有し、数秒かかります * 対象のエキスパートは1スロットを占有し、応答を生成するのに時間がかかる * 3番目のスロットは並列タスク用に予備として残されます 使用量が増えると、Docker方法で説明されているように、xref:0120_cumuler_deux_abonnements_ollama_pro_docker_post.adoc[私の記事（サブスクリプションの併用について）] で追加のProアカウントを追加します。月額100ユーロのMaxプランはありません — 本当に必要なものだけを追加します。 唯一の制限要因は**GPU時間のクォータ**Ollamaの月額（プロ向け無料プランの50倍）。私の1日数百回の利用では十分です。 [IMPORTANT] ==== V4-Pro (49B が有効) と Gemma 4 26B-A4B (3.8B が有効) の呼び出しのマージナルコストは**私にとってもゼロ**. これは Ollama のプランがコンピュートの差を吸収しています。私の唯一の指標はレイテンシです。 ==== === 実践におけるルーティング</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre></pre> </div> </div> <div class="paragraph"> <p>Volume de requêtes estimé : ~500/jour</p> </div> <div class="paragraph"> <p>├─ 50% → Gemma 4 26B-A4B-FT (micro, 3.8B actifs) │ Formatage AsciiDoc, scripts simples, conventions nommage │ ├─ 25% → V4-Flash-FT (exécutif, 13B actifs) │ Plugins Gradle, refactoring Kotlin, génération DAG │ ├─ 15% → Qwen 35B MoE-FT (micro, 3B actifs) │ Tâches intermédiaires, review de code, documentation │ └─ 10% → V4-Pro (orkestrateur, 49B actifs) Décisions architecturales, refactoring transverse, problèmes vraiment nouveaux</p> </div> <div class="listingblock"> <div class="content"> <pre>トラフィックの大部分は小規模なものによって処理されます。大規模モデルは最後の手段としてのみ介入します。 == 痛い比較：Claude, GPT, Gemini, Grok vs 私の艦隊 ここで差がとんでもなく広がります。同じ作業量（1日あたり500リクエスト、平均で入力約300トークン＋出力2,000トークン）のコストが、2026年5月の市場のプロプライエタリーソリューションではどれくらいか見てみましょう。 === Anthropic — Claude (2026年5月料金) Anthropic は最近、価格を*引き下げ*ました。DeepSeek や Qwen のようなオープンウェイト ソリューションによるプレッシャーが感じられます。 [cols="3,2,2,2,2"] |=== |モデル |$/MTok |$/MTok |1日あたりのコスト |**月額** |Opus 4.7 (最も賢い) |$5 |$25 |$25.75 |**$772** |ソネット 4.6 (バランス) |$3 |$15 |$15.45 |**$463** |Haiku 4.5 (より高速) |$1 |$5 |$5.15 |**154ドル** |=== [CAUTION] ==== これらの料金は *après* アンソロピックの最後の値下げ (2026年5月) の後です。それ以前、OpusはMTokあたり$15/$75でした。オープンウェイトへの恐れは現実です。 ==== Claudeでも最も安いモデル — Haiku 4.5 へ**154ユーロ/月**— Ollama Pro のサブスクリプション（17ユーロ）の9倍以上かかる。 Haikuは私のコードベースを知らず、私のスタイルで生成せず、体系的なプロンプトエンジニアリングを必要とする。 最も賢い — Opus 4.7 — 予算を爆発させる**772ユーロ/月**1日あたり500件という少量のクエリに対して。あるいは**45倍高い**私の解決策より === OpenAI — GPT (料金 2026年5月) [cols="3,2,2,2,2"] |=== |モデル |$/MTok |$/Tok |1日あたりのコスト |**月�額費用** |GPT 5.5 (最も賢い) |$5 |$30 |$30.90 |**$927** |GPT 5.4 (標準) |$2.50 |$15 |$15.45 |**$463** |GPT 5.4 ミニ |$0.75 |$4.50 |$4.64 |**139ドル** |=== OpenAIの『経済的』モデル — GPT 5.4 Mini 月額139ユーロ — でも、私のサブスクリプションの8倍のコストがかかります。それは私の慣習について*何も*知らないモデルであり、重いプロンプトエンジニアリングが必要です。 GPT 5.5、彼らのフラッグシップ：**927ユーロ/月**. *ゼロショット* を使うために。 スタイルが習熟していないため、タスクあたり2-3回の反復が必要で、実際の月間コストが簡単に倍増します。 === Google — Gemini (2026年5月料金) [cols="3,2,2,2,2"] |=== |モデル |$/MTok |$/MTok |コスト/日 |**月額コスト** |Gemini 3.1 Pro (High) |$3.50 |$17.50 |$18.00 |**$540** |Gemini 3.1 Pro |$2 |$10 |$10.30 |**309ドル** |ジェミニ 3 フラッシュ |$0.30 |$1.50 |$1.54 |**$46** |=== Gemini 3 Flash は月額46ユーロで価格面で競争力があります — しかしファインチューニングがなければ、汎用的なコードを生成します。*Cheroliv* コードではありません。 === Grok — xAI (2026年5月の料金) [cols="3,2,2,2,2"] |=== |モデル |$/MTok |$/MTok |コスト/日 |**費用/月** |Grok 4 |$4 |$16 |$16.48 |**494ドル** |Grok 4 ミニ |$0.80 |$3.20 |$3.30 |**$99** |=== === Microsoft — Azure OpenAI (2026年5月の料金) Azureは直接のOpenAI APIと同じ価格を適用しますが、インフラストラクチャとネットワークについても追加で請求します。マネージドサービスについては10-20％の追加コストを見込む必要があります。 [cols="3,2,2,2,2"] |=== |モデル |$/MTok |出力 $/MTok |コスト/日 |**月額コスト** |GPT 5.4 (Azure, Global) |$2.50 |$15 |$15.45 |**$463** |GPT 5.4 + インフラストラクチャー |追加費用 15% |追加費用15% |$17.77 |**$533** |=== [NOTE] ==== 上記の料金はAPI向けのもので、チャット向けのサブスクリプション（Claude Proは月額20ドル、ChatGPT Plusは月額20ドル）ではありません。ここで比較するのは開発者向けの使用法です。つまり、APIを通じて1日に何百件ものリクエストを連続して行い、コードの生成、リファクタリング、ドキュメント作成を行う使い方です。一般向けのサブスクリプションでは、500件/日をはるかに超える前にクォータが達してしまいます。 ==== === 最終比較表 [cols="3,2,2,2,2,2"] |=== |解決策 |コードベースの知識 |統合スタイル |月額費 |イテレーション |**実効コスト** |**私の艦隊 (Ollama Pro)** |�✅ ファインチューン済み |�✅ 重さの中では |**17ユーロ** |0-1 |**17ユーロ** |Claude Opus 4.7 |�❌ ゼロショット |❌ 必要なプロンプト |$772 |2-3 |$1 500-2 300 |クロード ハイク 4.5 |�❌ ゼロショット |❌ プロンプト 必要 |$154 |3-4 |$460-615 |GPT 5.5 |�❌ ゼロショット |�❌ 必要なプロンプト |$927 |2-3 |$1 854-2 781 |GPT 5.4 |�❌ ゼロショット |❌ プロンプトが必要 |$463 |2-3 |$925-1 390 |GPT 5.4 ミニ |�❌ ゼロショット |�❌ 必要なプロンプト |$139 |3-5 |$417-695 |Gemini 3.1 Pro ハイ |❌ ゼロショット |❌ プロンプトが必要です |$540 |2-3 |$1 080-1 620 |Grok 4 |�❌ ゼロショット |�❌ プロンプトが必要です |$494 |2-3 |$988-1 482 |**Azure GPT 5.4** |�❌ ゼロショット |�❌ 必要なプロンプト |$533 |2-3 |$1 066-1 600 |=== [plantuml, cost-comparison, svg]</pre> </div> </div> <div class="paragraph"> <p>@startuml skinparam backgroundColor #FAFAFA</p> </div> <div class="paragraph"> <p>title コスト/効率レポート — 私の艦隊対市場（2026年5月） rectangle "17€/月" as OURS #4ECDC4 rectangle "オーパス 4.7 772€" as OPUS #FF6B6B rectangle "ソネット 4.6 463ユーロ" as SONNET #FF8B94 rectangle "GPT 5.5 927€" as GPT #FFD93D rectangle "Gemini 3.1 Pro 540ユーロ" as GEMINI #6C5CE7 rectangle "Grok 4 494ユーロ" as GROK #A8E6CF rectangle "python import sys sys.stdout.write(sys.stdin.read())" as HAIKU #DFE6E9 rectangle "GPT 5.4 Mini 139€" as MINI #B2BEC3</p> </div> <div class="paragraph"> <p>note bottom of OURS Avec fine-tune intégré. Zéro prompt engineering. 90%+ first-shot correct. end note</p> </div> <div class="paragraph"> <p>@enduml</p> </div> <div class="listingblock"> <div class="content"> <pre>17€/月、ファインチューニング済みの23名のAIエキスパートに。フラッグシップ Claude Opus 4.7の価格は**45倍高い***私の*コードベースにおいて品質が低いものに対して。 GPT 5.5はコストがかかる。**54倍高い**. 市場で最も安いモデル（Gemini Flash 46ユーロ）でも**2.7倍**私のワークスペースを知らないまま。 判断は覆せない：2026年のMoEアーキテクチャーへのファインチューニングは、ただ「安い」だけではない。これは効率性の要因だ**27× から 54×**プロプライエタリーソリューションとのコスト/品質比において。Anthropic, OpenAI, Google — すべてそれを知っており、だからこそ彼らはパニックで価格を引き下げている。 == 効率の係数 : 5-8× vs V4-Proを単独で使用する 両極を比較しましょう。 === シナリオA:V4-Proのみで全て対応 [cols="3,2"] |=== |メトリック |値 |コードベースの知識 |0 (ゼロショット) |命名規則 |最初のショットで40-60%正解 |プロンプトエンジニアリングが必要 |はい、体系的 |タスクごとのイテレーション |2-3 |推論コスト |$100/月 (Ollama Max) |平均レイテンシ |~20 tok/s + ネットワーク |=== === シナリオ B : オーケストレーションされた MoE フリート [cols="3,2"] |=== |メートル |価値 |コードベースの知識 |統合された（ファインチューン） |命名規約 |90-95% の初回正解率 |プロンプトエンジニアリング |いいえ（スタイルは重みの中にある） |タスクごとのイテレーション |0-1 |推論コスト |$60/月 (3× Ollama Pro) |平均遅延 |~50 トークン/秒 (軽量モデル) |=== [cols="4,2,2,2"] |=== |次元 |V4-Pro だけ |艦隊 MoE |要因 |クラウドの月間コスト |$100 |**60ドル** |1.7× |注入されるコンテキスト |高い (プロンプト) |**ゼロ** |�∞ |平均反復 |2-3 |**0-1** |2-3× |感じられるレイテンシ |20 tok/s |50 tok/s |**2.5×** |最初の一発が正解 |50% |90%+ |**1.8倍** |=== **総合的効率係数 : 5-8×**— 感じられる開発者の生産性. [NOTE] ==== 因子はトークンでもドルでも測定されません。それは「モデルに説明するのにどれだけの時間を費やすか」で測られます。ファインチューンされたモデルでは、この時間はゼロに近づきます。 ==== == 完全予算：ワンショット投資、ばかげた定額プラン [cols="3,2"] |=== |ポスト |金額 |GPUのトレーニング (811 H100-h, Crusoe $2/h) |**$1,622** |合成データセットの生成 (LLM API) |**400ドル** |推論 (Ollama Pro 年額, $17/月) |**$204** |**合計 初年度** |**$2 226** |**月額相当** |**$186** |**クエリあたりの推定コスト** |< $0.01 |=== [plantuml, budget-breakdown, svg]</pre> </div> </div> <div class="paragraph"> <p>@startuml skinparam backgroundColor #FAFAFA</p> </div> <div class="paragraph"> <p>rectangle "予算 年1 : $2 226" as Total #E8E8E8 { rectangle "GPUのトレーニング $1 622 (73%)" as Train #FF6B6B rectangle "データセット 蒸留 $400 (18%)" as Data #FFE66D rectangle "Ollama Pro $204 (9%)" as Cloud #4ECDC4 }</p> </div> <div class="paragraph"> <p>note bottom of Total $186/mois équivalent année 1. Dès l’an 2 : $17/mois. Amorti par ~$235 de CA mensuel avec marge 95%. end note</p> </div> <div class="paragraph"> <p>@enduml</p> </div> <div class="listingblock"> <div class="content"> <pre>$186/月　最初の年**$17/月**2年目から。Netflixプレミアムプランの価格は、24時間365日対応可能な23人のAI専門家チームのためのもので、彼らは私のスタイルでコードを書き、*私のスタイル* で、私が彼らにコーディング規約を説明する必要がない。 === 収益性の計算 edster.cloud と その マージン が 約 95% の 場合 、 損益分岐点は**約2,340ドルの追加の売上高**今年。実際： * 1 件のソフトウェアパイロットミッション → $3 000-5 000 → 投資がカバー + 利益 * 1 企業研修 → $5 000-10 000 → 快適 * 暗黙的なアップセル : 「私のAIチームは私のソフトウェアフォージをマスターしている」 → 商業的差別化 2年目以降、トレーニングの支払いは不要になります（データセットの更新がある場合を除く）。年間コストは**$204**(17ドル/月). コスト/価値の比率はユニコーンのようにほぼゼロです。 == 演習の限界 これはまだ*ざっくりとした見積もり*。いくつかの変数が予算に影響を与える可能性があります： [cols="2,3"] |=== |変数 |影響 |合成データセットの生成 |もし蒸留APIが失敗する（幻覚、不適切に形成されたペア）場合、人間の時間を使ってキュレートする必要があります。隠れたコスト。 |OllamaのGPU時間のクォータ |使用量がProプランの割り当てを超える場合は、プランをアップグレードするか、専用のGPUに切り替える必要があります。 |ファインチューンの実効的な品質 |ファインチューンが失敗 → やり直し。本当のリスクはハイパーパラメータで、GPUの場所ではない。 |モデルの急速な進化 |Qwen3.6/Gemma 4 は1か月未満前にリリースされました。6か月後、次の世代はさらに優れ、ファインチューニングももっと安くなります。 |=== [WARNING] ==== まず1つだけのマイクロモデルでパイプラインをテストせずに、811時間のトレーニングを実行しないでください。Qwen 35B-A3Bで3-4hのランを実行すると、コストは$8になります。データセットがダメなら、$8でわかります。$1 622ではありません。 ==== == 結論：ファインチューンはアクセシブルなラグジュアリーになった 1年前、292B パラメータのモデルをファインチューニングすること（QLoRA でも）は研究の領域だった。今日、2026年5月において、これは独立した開発者にとって実現可能なプロジェクトです： * **811 H100-時間**トレーニング — $1 622 Crusoe で * **23の専門モデル**Ollama Cloud上にロードされました —**$17/月** * **0サーバー, 0ローカルGPU, 0メンテナンスインフラ** 民主化は三つの収斂する要因からもたらされた： 1. **MoEアーキテクチャ**— これにより、一部の重みのみが活性化されるモデルを効率的にファインチューニングすることができます 2. **Ollama Cloudの固定プラン**— 変動コスト（per‑token）を固定コスト（サブスクリプション）に変換する 3. **高品質なオープンウェイトモデル**— DeepSeek V4, Qwen3.6, Gemma 4はMIT/Apache 2.0ライセンスのもとにあります。 文明は、考えずに行える重要な操作の数を増やすことによって進歩する。 ファインチューンとはまさにこれです：機械に任せる作業で、それについて考える必要がなくなるものです。そして2026年には、ジュニア開発者の月給よりも安いコストで済みます。 --- _記事は{jbake-date}に公開されました_ == フリートのファインチューンされたモデル [cols="2,2,2,2,3"] |=== |サイズが有効になりました |数 |ベースモデル |分野 |データセット |13B |1 |ディープシーク-V4-フラッシュ-ベース |一般的なワークスペース |50M トークン |13B |5 |DeepSeek-V4-Flash |グラドル, コトリン, ディーエージー, ドキュメント, インフラ |15Mトークン |3.8B |6 |Gemma 4 26B-A4B |マイクロタスク、フォーマット、スクリプト |5Mトークン |3B |5 |Qwen3.6-35B-A3B |リファクタリング, レビュー, 中間ドキュメント |5Mトークン |3B |5 |Qwen3.5-35B-A3B |レガシータスク、 互換性 |5Mトークン |=== == リソース === HuggingFaceのオープンウェイトモデル * https://huggingface.co/deepseek-ai/DeepSeek-V4-Flash-Base[DeepSeek V4-Flash-Base — 292B パラメータ, ライセンス MIT] * https://huggingface.co/Qwen/Qwen3.6-35B-A3B[Qwen3.6-35B-A3B — 35B/3B が有効、ライセンスは Apache 2.0] * https://huggingface.co/Qwen/Qwen3.5-35B-A3B[Qwen3.5-35B-A3B — 35B/3B 有効, Apache 2.0 ライセンス] * https://huggingface.co/google/gemma-4-26B-A4B-it[Gemma 4 26B-A4B — 26B/3.8B が有効、Apache 2.0 ライセンス] === 料金の出典（2026年5月） * https://ollama.com/pricing[Ollama Cloud 料金 — Proプラン $17/月 年払い] * https://www.anthropic.com/pricing[Anthropic 料金 — Claude API (Opus 4.7 $5/$25, Sonnet 4.6 $3/$15, Haiku 4.5 $1/$5)] * https://openai.com/api/pricing/[OpenAI の料金 — GPT API (GPT 5.5 $5/$30、GPT 5.4 $2.50/$15)] * https://deepinfra.com/pricing[DeepInfraの料金 — GPUインスタンス H100 $1.79/時、B200 $2.79/時] * Vast.ai, Crusoe Cloud, FluidStack, TensorDock, RunPod, CoreWeave, Lambda Labs — manual price listings, dated May 2026 === 公式発表 * https://qwen.ai/blog?id=qwen3.6-35b-a3b[公式発表 Qwen3.6-35B-A3B — Qwenブログ]— エージェンティックコーディング, Apache 2.0, 262Kコンテキスト</pre> </div> </div> </div> </div> https://cheroliv.com/blog/2026/0121_plugin_gradle_piloter_deux_instances_ollama_pro_post.html Fri, 8 May 2026 00:00:00 +0000 blog/2026/0121_plugin_gradle_piloter_deux_instances_ollama_pro_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_紹介">紹介</a></li> <li><a href="#_なぜgradleをインフラに使うのか">なぜGradleをインフラに使うのか？</a></li> <li><a href="#_build_gradle_kts_完全版">build.gradle.kts 完全版</a></li> <li><a href="#_キータスクの解剖">キータスクの解剖</a> <ul class="sectlevel2"> <li><a href="#_startollamab_ランチャー">startOllamaB` — ランチャー</a></li> <li><a href="#_signinb_インタラクティブ">signInB` — インタラクティブ</a></li> <li><a href="#_pullmodelb_設定可能な">pullModelB` — 設定可能な</a></li> <li><a href="#_statusollamaall_診断">statusOllamaAll` — 診断</a></li> <li><a href="#_cleanollamab_アイデンティティを保つクリーニング">cleanOllamaB` — アイデンティティを保つクリーニング</a></li> </ul> </li> <li><a href="#_完全なワークフロー_ゼロから二つのセッションまで">完全なワークフロー — ゼロから二つのセッションまで</a></li> <li><a href="#_なぜgradleプラグインとして作らないのか">なぜGradleプラグインとして作らないのか？</a></li> <li><a href="#_学んだ教訓">学んだ教訓</a></li> <li><a href="#_結論">結論</a></li> <li><a href="#_リソース">リソース</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 18 minutes</div> <p>なぜ手動でdockerコマンドを打つのですか？Gradleのタスクにすべてをカプセル化できるのに。これが、外部のシェルスクリプトをゼロにしてデュアルOllama Proの設定をどのように産業化したかです。起動、停止、アイデンティティ、サインイン、プル — すべてこれが経由します`./gradlew`。</p> </div> </div> </div> <div class="sect1"> <h2 id="_紹介">紹介</h2> <div class="sectionbody"> <div class="paragraph"> <p>前の記事では、Ollama Pro の二つのアカウントを同じマシンで共存させる方法を示しました。その際、二番目のインスタンスを Docker コンテナ内に隔離しました。設定は機能しますが、日常の管理はすぐに面倒になります：コンテナの名前を覚えておく必要があり、適切なコマンドを再実行しなければなりません。<code>docker exec</code>, チェッカー どのポートがアクティブか…​</p> </div> <div class="paragraph"> <p>あなたは、14のターミナルを開いているその瞬間を知っているでしょう、あなたはタイプしている`docker exec ollama-instance-b ollama list`4回目で、そしてあなたは「もっときれいな方法があるはずだ」と思いますか？</p> </div> <div class="paragraph"> <p>この方法はGradleです。</p> </div> <div class="paragraph"> <p>コードをビルドするためだけではない。Gradleはローカルインフラストラクチャの指揮者のように、プロビジョニング、検証、テスト、クリーンアップを行うタスク。すべてがバージョン管理された`build.gradle.kts`� 隣に住んでいる`docker-compose.yml`。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml !theme plain skinparam handwritten false skinparam shadowing false skinparam BoxPadding 8 skinparam DefaultFontSize 11 skinparam ArrowThickness 1.5 left to right direction actor "開発者" as Dev package "build.gradle.kts" as GradleFile { usecase "OllamaBを開始" as Start usecase "stopOllamaB" as Stop usecase "checkIdentity" as Check usecase "signInB" as SignIn usecase "pullModelB" as Pull usecase "testOllamaB" as Test usecase "statusOllamaAll" as Status usecase "cleanOllamaB" as Clean } package "Docker デーモン" as DockerDaemon { node "ollama-instance-b" as ContainerB { component ":11435" as Port database "~/ollama-b-data" as Volume } } package "Ollama ネイティブ" as Native { component ":11434" as NatPort } Dev --> Start Dev --> SignIn Dev --> Pull Dev --> Test Dev --> Status Dev --> Check Dev --> Stop Dev --> Clean Start ..> ContainerB : docker run -d Stop ..> ContainerB : docker stop Check ..> Volume : cat id_ed25519.pub SignIn ..> ContainerB : ollama signin Pull ..> ContainerB : ollama pull Test ..> ContainerB : curl /v1/chat/completions Status ..> ContainerB : docker ps Status ..> Native : curl :11434 Clean ..> ContainerB : docker rm -f note bottom of GradleFile Zéro script bash externe. Tout est dans le build.gradle.kts, versionné avec le projet. end note @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_なぜgradleをインフラに使うのか">なぜGradleをインフラに使うのか？</h2> <div class="sectionbody"> <div class="paragraph"> <p>その質問は正当です。Gradleはビルドツールです。通常、コンパイルし、テストし、パッケージングします。Dockerコンテナを起動するわけではありません。</p> </div> <div class="paragraph"> <p>ただし、Gradleは依存グラフエンジンでもあり、それが私たちのケースにとって興味深い点です。</p> </div> <div class="paragraph"> <p>欲しいです：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>コンテナがサインイン前に起動されるように</p> </li> <li> <p>モデルをプルする前に身元を確認して</p> </li> <li> <p>コンテナがダウンしている場合、APIテストは静かに失敗します</p> </li> </ol> </div> <div class="paragraph"> <p>�純粋な依存グラフ。Gradleはそれにぴったりです。Kotlin DSLはタスクの記述をスムーズにし、`doLast`システムコマンドをアプリケーションコードのように実行できます。</p> </div> <div class="paragraph"> <p>特に：bashrc を維持する必要はなく、放置されたスクリプトも中にない`~/bin`, Makefileがdocker-composeの隣にありません。すべてが一つのファイルに収まっており、プロジェクトのコードと同じ場所にあります。</p> </div> </div> </div> <div class="sect1"> <h2 id="_build_gradle_kts_完全版">build.gradle.kts 完全版</h2> <div class="sectionbody"> <div class="paragraph"> <p>これが私がやっと書き終わったファイルです。これは、ボリュームのプロビジョニングから検証の curl、さらにインタラクティブなサインインまで、すべてをこなします。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">import java.io.ByteArrayOutputStream plugins { base } // ------------------------------------------------------------------------- // Configuration // ------------------------------------------------------------------------- val instanceName = "ollama-instance-b" val instancePort = 11435 val instanceImage = "ollama/ollama:0.20.2" val dataDir = file("${System.getProperty("user.home")}/ollama-b-data") val nativePort = 11434 // Modèles à gérer — cloud Pro + un modèle local gratuit pour les tests val proModels = listOf("deepseek-v4-pro:cloud", "gemma4:31b-cloud") val freeModels = listOf("qwen3:0.6b") // ------------------------------------------------------------------------- // Tâche préparatoire — création du volume si absent // ------------------------------------------------------------------------- val prepareVolume by tasks.registering { group = "ollama" description = "Crée le répertoire de volume pour l'instance B si absent" doLast { if (!dataDir.exists()) { dataDir.mkdirs() println("Volume créé : ${dataDir.absolutePath}") } else { println("Volume existant : ${dataDir.absolutePath}") } } } // ------------------------------------------------------------------------- // Démarrage du conteneur Docker // ------------------------------------------------------------------------- val startOllamaB by tasks.registering(Exec::class) { group = "ollama" description = "Lance le conteneur Docker pour l'instance Ollama B" dependsOn(prepareVolume) commandLine( "docker", "run", "-d", "--name", instanceName, "-p", "$instancePort:11434", "-v", "${dataDir.absolutePath}:/root/.ollama", "-e", "OLLAMA_HOST=0.0.0.0", "--restart", "always", instanceImage ) isIgnoreExitValue = true doLast { val alreadyRunning = executionResult.get().exitValue != 0 if (alreadyRunning) { logger.lifecycle("Le conteneur '$instanceName' existe déjà — tentative de démarrage") } else { logger.lifecycle("Conteneur '$instanceName' lancé") } } } // ------------------------------------------------------------------------- // Arrêt du conteneur // ------------------------------------------------------------------------- val stopOllamaB by tasks.registering(Exec::class) { group = "ollama" description = "Arrête le conteneur Docker de l'instance B" commandLine("docker", "stop", instanceName) isIgnoreExitValue = true doLast { logger.lifecycle("Conteneur '$instanceName' arrêté") } } // ------------------------------------------------------------------------- // Affichage de la clé publique (Device Key) // ------------------------------------------------------------------------- val checkIdentity by tasks.registering(Exec::class) { group = "ollama" description = "Affiche la clé publique SSH de l'instance B" dependsOn(startOllamaB) commandLine("docker", "exec", instanceName, "cat", "/root/.ollama/id_ed25519.pub") standardOutput = ByteArrayOutputStream() doLast { val pubKey = standardOutput.toString().trim() println("=".repeat(60)) println("Device Key (Instance B)") println("=".repeat(60)) println(pubKey) println("=".repeat(60)) println("→ Enregistre cette clé sur https://ollama.com/settings/keys") println("→ Puis exécute : ./gradlew signInB") println("=".repeat(60)) } } // ------------------------------------------------------------------------- // Sign-in interactif (Ouvrira le navigateur) // ------------------------------------------------------------------------- val signInB by tasks.registering(Exec::class) { group = "ollama" description = "Lance l'authentification interactive Ollama pour le compte B" dependsOn(startOllamaB) standardInput = System.`in` standardOutput = System.out errorOutput = System.err commandLine("docker", "exec", "-it", instanceName, "ollama", "signin") doFirst { logger.lifecycle("Authentification pour le Compte Pro B...") logger.lifecycle("Ouvre ton navigateur et connecte-toi avec l'email du compte B") } } // ------------------------------------------------------------------------- // Pull d'un modèle (paramétrable via propriété Gradle) // ------------------------------------------------------------------------- val pullModelB by tasks.registering(Exec::class) { group = "ollama" description = "Pull un modèle sur l'instance B. Usage : ./gradlew pullModelB -Pmodel=nom:tag" dependsOn(startOllamaB) val modelName = project.findProperty("model") as? String ?: "qwen3:0.6b" commandLine("docker", "exec", instanceName, "ollama", "pull", modelName) doFirst { logger.lifecycle("Pull du modèle '$modelName' sur l'instance B...") } doLast { logger.lifecycle("Modèle '$modelName' pullé avec succès") } } // ------------------------------------------------------------------------- // Pull de tous les modèles Pro (batch) // ------------------------------------------------------------------------- val pullAllProModels by tasks.registering { group = "ollama" description = "Pull tous les modèles cloud Pro sur l'instance B" dependsOn(startOllamaB) doLast { proModels.forEach { model -> logger.lifecycle("→ Pull $model...") val process = ProcessBuilder("docker", "exec", instanceName, "ollama", "pull", model) .inheritIO() .start() process.waitFor() } logger.lifecycle("Tous les modèles Pro pullés") } } // ------------------------------------------------------------------------- // Pull de tous les modèles gratuits (batch / première install) // ------------------------------------------------------------------------- val pullAllFreeModels by tasks.registering { group = "ollama" description = "Pull tous les modèles locaux gratuits sur l'instance B" dependsOn(startOllamaB) doLast { freeModels.forEach { model -> logger.lifecycle("→ Pull $model...") val process = ProcessBuilder("docker", "exec", instanceName, "ollama", "pull", model) .inheritIO() .start() process.waitFor() } logger.lifecycle("Tous les modèles gratuits pullés") } } // ------------------------------------------------------------------------- // Liste des modèles disponibles sur l'instance B // ------------------------------------------------------------------------- val listModelsB by tasks.registering(Exec::class) { group = "ollama" description = "Liste les modèles disponibles sur l'instance B" dependsOn(startOllamaB) commandLine("docker", "exec", instanceName, "ollama", "list") } // ------------------------------------------------------------------------- // Health check — test API sur les deux instances // ------------------------------------------------------------------------- val testOllamaB by tasks.registering { group = "ollama" description = "Teste la connectivité API de l'instance B avec un simple chat" dependsOn(startOllamaB) doLast { val model = project.findProperty("model") as? String ?: "qwen3:0.6b" logger.lifecycle("Test de l'instance B avec le modèle '$model'...") val payload = """ { "model": "$model", "messages": [{"role": "user", "content": "Réponds uniquement par OK"}], "max_tokens": 5 } """.trimIndent() val process = ProcessBuilder( "curl", "-s", "http://localhost:$instancePort/v1/chat/completions", "-H", "Content-Type: application/json", "-d", payload ).start() val response = process.inputStream.bufferedReader().readText() process.waitFor() if (response.contains("\"id\":\"chatcmpl") || response.contains("\"choices\"")) { println("✓ Instance B OK — port $instancePort répond") println(" Response: ${response.take(120)}...") } else { println("✗ Instance B INACTIVE — vérifie le conteneur avec './gradlew statusOllamaAll'") println(" Raw: $response") } } } // ------------------------------------------------------------------------- // Health check sur les deux instances simultanément // ------------------------------------------------------------------------- val statusOllamaAll by tasks.registering { group = "ollama" description = "Vérifie le statut des deux instances Ollama (native + Docker)" doLast { // Instance native runCatching { val process = ProcessBuilder( "curl", "-s", "-o", "/dev/null", "-w", "%{http_code}", "http://localhost:$nativePort/api/tags" ).start() val code = process.inputStream.bufferedReader().readText().trim() process.waitFor() println(if (code == "200") "✓ Instance Native — port $nativePort OK (HTTP $code)" else "✗ Instance Native — port $nativePort (HTTP $code)") }.getOrElse { println("✗ Instance Native — injoignable sur le port $nativePort") } // Instance Docker runCatching { val process = ProcessBuilder( "curl", "-s", "-o", "/dev/null", "-w", "%{http_code}", "http://localhost:$instancePort/api/tags" ).start() val code = process.inputStream.bufferedReader().readText().trim() process.waitFor() println(if (code == "200") "✓ Instance Docker B — port $instancePort OK (HTTP $code)" else "✗ Instance Docker B — port $instancePort (HTTP $code)") }.getOrElse { println("✗ Instance Docker B — injoignable sur le port $instancePort") } // Info conteneur runCatching { val process = ProcessBuilder("docker", "ps", "--filter", "name=$instanceName", "--format", "table {{.Names}}\\t{{.Status}}\\t{{.Ports}}").start() val status = process.inputStream.bufferedReader().readText() process.waitFor() println() println("Conteneur Docker :") println(status) } } } // ------------------------------------------------------------------------- // Nettoyage complet // ------------------------------------------------------------------------- val cleanOllamaB by tasks.registering(Exec::class) { group = "ollama" description = "Arrête et supprime le conteneur Docker de l'instance B" dependsOn(stopOllamaB) commandLine("docker", "rm", instanceName) isIgnoreExitValue = true doLast { logger.lifecycle("Conteneur '$instanceName' supprimé") logger.lifecycle("Le volume ${dataDir.absolutePath} est conservé (identité persistante)") } } // ------------------------------------------------------------------------- // Affichage des instructions // ------------------------------------------------------------------------- val helpOllama by tasks.registering { group = "ollama" description = "Affiche l'aide des tâches Ollama disponibles" doLast { println(""" ╔══════════════════════════════════════════════════════════════╗ ║ Tâches Gradle — Pilotage Dual Ollama Pro ║ ╠══════════════════════════════════════════════════════════════╣ ║ ./gradlew startOllamaB Démarrer l'instance Docker B ║ ║ ./gradlew stopOllamaB Arrêter l'instance Docker B ║ ║ ./gradlew checkIdentity Afficher la clé SSH publique ║ ║ ./gradlew signInB Sign-in interactif compte B ║ ║ ./gradlew pullModelB Pull un modèle (-Pmodel=...) ║ ║ ./gradlew pullAllProModels Pull tous les modèles Pro ║ ║ ./gradlew pullAllFreeModels Pull tous les modèles gratuits ║ ║ ./gradlew listModelsB Lister les modèles instance B ║ ║ ./gradlew testOllamaB Test API avec un chat simple ║ ║ ./gradlew statusOllamaAll Santé des 2 instances ║ ║ ./gradlew cleanOllamaB Supprimer le conteneur ║ ║ ./gradlew helpOllama Cette aide ║ ╚══════════════════════════════════════════════════════════════╝ """.trimIndent()) } }</code></pre> </div> </div> <div class="paragraph"> <p>はい、12のタスク、単一のエントリーポイント、摩擦ゼロ。</p> </div> </div> </div> <div class="sect1"> <h2 id="_キータスクの解剖">キータスクの解剖</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_startollamab_ランチャー">startOllamaB` — ランチャー</h3> <div class="paragraph"> <p>何も難しくない：一`docker run -d`正しい設定で。コツはそこにある`isIgnoreExitValue = true`。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">isIgnoreExitValue = true</code></pre> </div> </div> <div class="paragraph"> <p>コンテナが既に存在している場合、コマンド`docker run`失敗します (exit code ≠ 0)。このプロパティがない場合、Gradle はすべてのビルドをエラーで停止します。ここでは、失敗はサイレントです — そして`doLast`それが既に存在していたものか、本当のエラーかを検出する。</p> </div> <div class="paragraph"> <p>Le `doLast`重要：コマンドの実行後に回転し、検査を可能にします。`executionResult.get().exitValue`適切なメッセージをログに出力する。</p> </div> </div> <div class="sect2"> <h3 id="_signinb_インタラクティブ">signInB` — インタラクティブ</h3> <div class="paragraph"> <p>これは人間のインタラクションが必要な唯一のタスクです。 Gradle は伝送します`System.in`プロンプトが出るようにプロセスに`ollama signin`正常に表示されるように：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">standardInput = System.`in` standardOutput = System.out errorOutput = System.err</code></pre> </div> </div> <div class="paragraph"> <p>それをしなければ、sign-in は stdin が閉じられているためブロックされ、プロンプトが表示されません。</p> </div> </div> <div class="sect2"> <h3 id="_pullmodelb_設定可能な">pullModelB` — 設定可能な</h3> <div class="paragraph"> <p>パラメータを経由して受け取る汎用タスク`-P` :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./gradlew pullModelB -Pmodel=deepseek-v4-pro:cloud ./gradlew pullModelB # fallback : qwen3:0.6b</code></pre> </div> </div> <div class="paragraph"> <p>フォールバックは重要です：`project.findProperty("model") as? String ?: "qwen3:0.6b"`パラメータを忘れてもタスクが壊れないことを保証します。</p> </div> </div> <div class="sect2"> <h3 id="_statusollamaall_診断">statusOllamaAll` — 診断</h3> <div class="paragraph"> <p>二`curl`港での健康`11434` et <code>11435</code>, フォールバックで`runCatching`インスタンスのうちのいずれかがダウンしている場合でもクラッシュしないように。出力は構造化されています：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">✓ Instance Native — port 11434 OK (HTTP 200) ✓ Instance Docker B — port 11435 OK (HTTP 200) Conteneur Docker : NAMES STATUS PORTS ollama-instance-b Up 3 hours 0.0.0.0:11435->11434/tcp</code></pre> </div> </div> <div class="paragraph"> <p>一目見ただけで、何がうまくいっているか、何がまずいのかすぐに分かる。</p> </div> </div> <div class="sect2"> <h3 id="_cleanollamab_アイデンティティを保つクリーニング">cleanOllamaB` — アイデンティティを保つクリーニング</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">commandLine("docker", "rm", instanceName) isIgnoreExitValue = true</code></pre> </div> </div> <div class="paragraph"> <p>コンテナは削除されていますが、ボリュームは`~/ollama-b-data`だ<strong>保存された</strong>. SSHのアイデンティティはクリーニング後も生き残ります。 次の`startOllamaB`, 同じキーが再利用されます — サインインし直す必要も、Device Keyを再登録する必要もありません。</p> </div> <div class="admonitionblock caution"> <table> <tr> <td class="icon"> <i class="fa icon-caution" title="🔒"></i> </td> <td class="content"> <div class="paragraph"> <p><code>cleanOllamaB`ボリュームに触れないでください。Bのアイデンティティを消して（ゼロからやり直して）いきたい場合は、削除する必要があります。</code>~/ollama-b-data`手動で。これは自発的 — 一つ`clean`認証情報を破壊してはならない。</p> </div> </td> </tr> </table> </div> </div> </div> </div> <div class="sect1"> <h2 id="_完全なワークフロー_ゼロから二つのセッションまで">完全なワークフロー — ゼロから二つのセッションまで</h2> <div class="sectionbody"> <div class="paragraph"> <p>プロジェクトに参加し、ドキュメントを開かずにすべてをセットアップしたい人向けの理想的な手順はこちらです。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text"># 1. Premier contact — que faire ? $ ./gradlew helpOllama # 2. On démarre l'instance B $ ./gradlew startOllamaB # 3. On récupère la Device Key et on l'enregistre sur ollama.com $ ./gradlew checkIdentity # → copier-coller de la clé sur https://ollama.com/settings/keys # 4. Authentification interactive $ ./gradlew signInB # 5. Pull d'un petit modèle gratuit pour tester la plomberie $ ./gradlew pullModelB # 6. Test API $ ./gradlew testOllamaB # 7. Si tout est vert, pull des modèles Pro $ ./gradlew pullAllProModels # 8. Vérification finale des deux instances $ ./gradlew statusOllamaAll</code></pre> </div> </div> <div class="paragraph"> <p>2分未満ですべてプロビジョニングされます。READMEを読む必要も、環境変数を設定する必要もありません。タスク`helpOllama`組み込まれたドキュメントとして機能します。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml !theme plain skinparam DefaultFontSize 11 actor Développeur as Dev participant "Gradle (build.gradle.kts)" as Gradle participant "Docker デーモン" as Docker participant "Ollama インスタンス B" as OllamaB participant "Ollama クラウド" as Cloud == Provisionnement == Dev -> Gradle : helpOllama Gradle --> Dev : Aide et instructions Dev -> Gradle : startOllamaB Gradle -> Docker : docker run -d ollama/ollama:0.20.2 Docker -> OllamaB : Génération clés SSH (id_ed25519) Docker --> Gradle : conteneur lancé Gradle --> Dev : OK Dev -> Gradle : checkIdentity Gradle -> Docker : cat id_ed25519.pub Gradle --> Dev : Clé publique SSH Dev -> Cloud : Enregistrement clé SSH\n(sur ollama.com/settings/keys) == Authentification == Dev -> Gradle : signInB Gradle -> Docker : ollama signin (interactif) Dev <-> Cloud : Login navigateur (compte B) Docker -> Cloud : Échange token ⇔ Device Key Gradle --> Dev : Authentifié == Vérification == Dev -> Gradle : pullModelB Gradle -> Docker : ollama pull qwen3:0.6b Gradle --> Dev : Modèle pullé Dev -> Gradle : testOllamaB Gradle -> Docker : curl /v1/chat/completions Gradle --> Dev : ✓ Instance B OK == Production == Dev -> Gradle : pullAllProModels Gradle -> Docker : ollama pull deepseek-v4-pro:cloud Gradle -> Docker : ollama pull gemma4:31b-cloud Gradle --> Dev : Modèles Pro pullés Dev -> Gradle : statusOllamaAll Gradle --> Dev : ✓ Native ✓ Docker B @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_なぜgradleプラグインとして作らないのか">なぜGradleプラグインとして作らないのか？</h2> <div class="sectionbody"> <div class="paragraph"> <p>正当な質問。これを抽出`build.gradle.kts`Gradleのスタンドアロンプラグインであると、以下のようなメリットがあります：プロジェクト間での再利用、宣言的な設定、DSL拡張。</p> </div> <div class="paragraph"> <p>しかし、今は意味がありません。このビルドには複雑なビジネスロジックはなく、Docker と curl のコマンドをラップするだけです。拡張機能、ユニットテスト、公開を含む完全な Gradle プラグインをオーバーレイとして追加するのは、12 のユーティリティタスクに対して過大でしょう。</p> </div> <div class="paragraph"> <p>Le <code>build.gradle.kts</code> inline 必要なプロジェクトに存在します。他のところにコピーするのは簡単です。ある日私がそれに依存する3つのプロジェクトを持ったら、それをプラグインに変換します。今のところ、KISS。</p> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="ℹ️"></i> </td> <td class="content"> <div class="paragraph"> <p>三つ持っている日`build.gradle.kts`3つのプロジェクトで同じであることは、プラグインを抽出すべきだというシグナルです。それより前に、重複は抽象化よりもコストが低い。開発者の知恵。</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_学んだ教訓">学んだ教訓</h2> <div class="sectionbody"> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>Gradle は単なるビルドツールではない。</strong>— 依存グラフエンジンは、恐るべきインフラストラクチャオーケストレーターとなる。<code>doLast</code>, <code>isIgnoreExitValue</code>, <code>dependsOn</code>: これらの三つのプリミティブは、CI パイプラインと同じ信頼性で Docker コンテナを操作するのに十分です。</p> </li> <li> <p><strong>isIgnoreExitValue`は君の友達</strong>— 理想的な世界で、<code>docker run`既存のコンテナー上で実行すると、エラー終了コードではなく警告が返されます。実際の世界では、あなたは`isIgnoreExitValue = true`そしてあなたは管理している診断で`doLast</code>。</p> </li> <li> <p><strong>パラメータ化可能なタスクは曖昧さを殺す</strong> — Un <code>pullModelB`ジェネリックと</code>-Pmodel=…​`N 個の専門タスクを置き換えます。一つだけのタスク、一つだけのドキュメント、一つだけの動作。</p> </li> <li> <p><strong>runCatching`health checksのために</strong>— Nのエンドポイントをテストするとき、最初のクラッシュが他のテストを妨げてはいけません。<code>runCatching</code>+`getOrElse`エンドポイントごとに、そして診断は部分的な故障でも完全のままです。</p> </li> <li> <p><strong>helpOllama` タスクとしての実行可能なドキュメンテーション</strong> — Un <code>println()`bien formaté</code> が 3 段落の README を置き換えます。自己文書化されており、常に最新状態で、ターミナルを離れずにアクセスできます。</p> </li> </ol> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>手入力のDockerコマンドから、完全でバージョン管理され再利用可能なGradleワークフローに移行しました。12のタスクがライフサイクル全体をカバーします：プロビジョニング、アイデンティティ、サインイン、プル、テスト、診断、クリーニング。</p> </div> <div class="paragraph"> <p>docker-compose + build.gradle.kts + opencode.json の組み合わせはきれいな三位一体を形成します：Dockerは隔離のため、Gradleはオーケストレーションのため、OpenCodeは消費のため。各レイヤーにはそれぞれの責任があり、いずれも他のレイヤーに干渉しません。</p> </div> <div class="paragraph"> <p>次のステップは？ CI でライフサイクルを自動化し、一時的な開発環境で Ollama インスタンスを利用可能にすること。ただし、それは別の記事の話です。</p> </div> </div> </div> <div class="sect1"> <h2 id="_リソース">リソース</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="https://docs.gradle.org/current/userguide/tutorial_using_tasks.html">ユーザーマニュアル Gradle — タスク</a></p> </li> <li> <p><a href="https://docs.gradle.org/current/userguide/custom_tasks.html">Gradle ユーザーマニュアル — カスタムタスク</a></p> </li> <li> <p><a href="https://hub.docker.com/r/ollama/ollama">Docker Hub 上の Docker Ollama イメージ</a></p> </li> <li> <p><a href="https://kotlinlang.org/docs/gradle.html">Gradle DSL Kotlin — ドキュメント</a></p> </li> </ul> </div> <hr> <div class="paragraph"> <p><em>記事が公開されました 2026-05-08</em></p> </div> </div> </div> https://cheroliv.com/blog/2026/0120_cumuler_deux_abonnements_ollama_pro_docker_post.html Fri, 8 May 2026 00:00:00 +0000 blog/2026/0120_cumuler_deux_abonnements_ollama_pro_docker_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_はじめに">はじめに</a></li> <li><a href="#_なぜ同じことを二度するのですか">なぜ同じことを二度するのですか？</a></li> <li><a href="#_問題の核心_デバイスキー">問題の核心 : デバイスキー</a></li> <li><a href="#_準備_手順ごと">準備 — 手順ごと</a> <ul class="sectlevel2"> <li><a href="#_前提条件">前提条件</a></li> <li><a href="#_ステップ_1ボリュームを作成">ステップ 1：ボリュームを作成</a></li> <li><a href="#_ステップ_2_docker_コンテナーを起動">ステップ 2 : Docker コンテナーを起動</a></li> <li><a href="#_ステップ_3_公開鍵を取得">ステップ 3: 公開鍵を取得</a></li> <li><a href="#_ステップ4ollama_comでキーを登録">ステップ4:Ollama.comでキーを登録</a></li> <li><a href="#_ステップ_5小さな無料モデルでテストする">ステップ 5：小さな無料モデルでテストする</a></li> </ul> </li> <li><a href="#_api_v1models_の罠">API <code>/v1/models</code> の罠</a></li> <li><a href="#_結果2つのセッション2つのアカウントゼロコンフリクト">結果:2つのセッション、2つのアカウント、ゼロコンフリクト</a></li> <li><a href="#_学んだ教訓">学んだ教訓</a></li> <li><a href="#_さらに進むために">さらに進むために</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 14 minutes</div> <p>2つのProサブスクリプション、1台のマシン、1枚の銀行カード、そしてネットワーク競合ゼロ。Docker が 2 台 目の PC を 買わ ず に クラウド 推論 能力 を 2 倍 に する 方法 を 私 に 教え た。</p> </div> </div> </div> <div class="sect1"> <h2 id="_はじめに">はじめに</h2> <div class="sectionbody"> <div class="paragraph"> <p>私は数ヶ月間、Ollama Proを使ってOpenCodeのセッションにクラウドモデルを提供してきました。問題は、Proプランでも並行して複数のエージェントを起動するとすぐに*レートリミット*に達してしまうことです。明らかな解決策：もう一つのサブスクリプション。</p> </div> <div class="paragraph"> <p>でも、これが悲劇だ。</p> </div> <div class="paragraph"> <p>Ollamaは各マシンを一意のSSHキーで識別します — それが有名な*Device Key*です。同じOS上の2つのインスタンスは同じアイデンティティを共有し、同じデバイスに2つのProアカウントをリンクすることは不可能です。そしてあなたが予想するように、そのためだけにもう1台のラップトップを買うつもりはありませんでした。</p> </div> <div class="paragraph"> <p>解決策 : 不正行為をする。 Ollama が異なる2台のマシンで動作していると誤認させる。実際には同じ CPU、同じ RAM、同じネットワーク接続を共有している。 Docker は完璧な隔離バブルを提供してくれる。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml !theme plain skinparam BoxPadding 10 skinparam DefaultFontSize 12 left to right direction node "物理的機械" { frame "Ollama インスタンス A (ネイティブ)" as Native { database "アイデンティティ\n/usr/share/ollama/.ollama/id_ed25519" as KeyA portin "API :11434" as PortA } frame "Ollama インスタンス B (Docker)" as Docker { database "Identité\n~/ollama-b-data/id_ed25519" as KeyB portin "API\n:11435" as PortB } } cloud "Ollama クラウド" { actor "プロアカウント A (メール 1)" as AccountA actor "プロ B アカウント (email 2)" as AccountB } KeyA --> AccountA : "SSHキー A" KeyB --> AccountB : "SSHキー B" PortA --> AccountA : "クエリー A" PortB --> AccountB : "リクエスト B" note bottom of Docker Conteneur isolé : identité SSH distincte, port réseau distinct, volume persistant end note @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_なぜ同じことを二度するのですか">なぜ同じことを二度するのですか？</h2> <div class="sectionbody"> <div class="paragraph"> <p>私を精神病者扱いする前に、ユースケースを説明させてください。</p> </div> <div class="paragraph"> <p>Proプランの単一のサブスクリプションだけで、私はモデルを起動することができます、たとえば`deepseek-v4-pro:cloud`OpenCode のセッションでは。問題が起きるのは、*二つ*のセッションを同時に使いたいときです。レートリミットのクォータにより、2番目のセッションが遅くなるか、完全に拒否されます。</p> </div> <div class="paragraph"> <p>2つの独立したProサブスクリプションがあります：</p> </div> <div class="ulist"> <ul> <li> <p>セッション OpenCode 1 → プロアカウント A`localhost:11434`)</p> </li> <li> <p>セッション OpenCode 2 → プロアカウント B`localhost:11435`)</p> </li> </ul> </div> <div class="paragraph"> <p>各セッションはそれぞれ独自の割り当てと独自のコンテキストを持ち、他のセッションに影響を与えません。これは人間のマルチプロセッシングです。</p> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="❗"></i> </td> <td class="content"> <div class="paragraph"> <p>Proサブスクリプション2つ = 異なるメールアドレス2つ。 同じ銀行カードは機能します — Ollamaの支払いシステムは、同じ支払い方法からの複数のサブスクリプションをブロックしません。 私は確認しました。</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_問題の核心_デバイスキー">問題の核心 : デバイスキー</h2> <div class="sectionbody"> <div class="paragraph"> <p>Ollamaをインストールすると、アイデンティティディレクトリにed25519のSSHキーのペアが生成されます:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ cat /usr/share/ollama/.ollama/id_ed25519.pub ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI...</code></pre> </div> </div> <div class="paragraph"> <p>このキーはOllamaのサーバーにアップロードされます、の際に`ollama signin`. 彼女は言う：「このマシンは特定のProアカウントに属しています。」 もしあなたの2つのインスタンスが同じファイルを共有している場合`id_ed25519`彼らは同じアイデンティティを共有しています。ゲーム終了。</p> </div> <div class="paragraph"> <p>パレード：2番目のインスタンスに独自のアイデンティティディレクトリを与える、Dockerボリューム内に隔離された</p> </div> </div> </div> <div class="sect1"> <h2 id="_準備_手順ごと">準備 — 手順ごと</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_前提条件">前提条件</h3> <div class="ulist"> <ul> <li> <p>機能的な Ollama のネイティブインストール（公式スクリプト`curl | sh`)</p> </li> <li> <p>Dockerがインストールされており、機能しています。</p> </li> <li> <p>Portainer または docker-compose を使用したデプロイ</p> </li> <li> <p>2つのOllamaアカウントと2つの異なるメールアドレス</p> </li> </ul> </div> <div class="paragraph"> <p>私はバージョンを使いました`0.20.2`— 公式スクリプトによって提供されるものおよび対応するDockerイメージ。</p> </div> </div> <div class="sect2"> <h3 id="_ステップ_1ボリュームを作成">ステップ 1：ボリュームを作成</h3> <div class="paragraph"> <p>ホスト上の単純なディレクトリは、インスタンス B のアイデンティティの永続ボリュームとして機能します :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">mkdir -p ~/ollama-b-data</code></pre> </div> </div> <div class="paragraph"> <p>このフォルダーはDockerコンテナーとしてマウントされます`/root/.ollama`、そこでオラマがアイデンティティキー、履歴、およびモデルを保存している</p> </div> </div> <div class="sect2"> <h3 id="_ステップ_2_docker_コンテナーを起動">ステップ 2 : Docker コンテナーを起動</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml"># docker-compose.yml services: ollama-instance-b: image: ollama/ollama:0.20.2 container_name: ollama-instance-b ports: - "11435:11434" volumes: - /home/cheroliv/ollama-b-data:/root/.ollama environment: - OLLAMA_HOST=0.0.0.0 restart: always</code></pre> </div> </div> <div class="paragraph"> <p>ここで起きていること：</p> </div> <div class="ulist"> <ul> <li> <p>港<strong>11435</strong>ホストは …​ にマッピングされます<strong>11434</strong>コンテナの内部。それにより、Docker インスタンスはリッスンします。<code>:11435`ネイティブなインスタンスが居座っているにもかかわらず、衝突なく</code>:11434`。</p> </li> <li> <p>ボリューム`~/ollama-b-data`に取り付けられている`/root/.ollama`— ここで SSH のアイデンティティが保存されます。</p> </li> <li> <p>`OLLAMA_HOST=0.0.0.0`コンテナが外部接続を受け入れることを許可する。</p> </li> </ul> </div> <div class="paragraph"> <p>私はPortainerを使ってこのスタックをデプロイしましたが、単純な`docker compose up -d`同様に機能します。</p> </div> </div> <div class="sect2"> <h3 id="_ステップ_3_公開鍵を取得">ステップ 3: 公開鍵を取得</h3> <div class="paragraph"> <p>コンテナが初回起動時に空であるため、Ollama はボリューム内に新しい SSH キーペアを自動的に生成します。公開鍵を取得します：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ docker exec ollama-instance-b cat /root/.ollama/id_ed25519.pub ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIDDQ+dvnfmuo49q5O8LOlvgZ39SKORFw47ry9k4H2jPc</code></pre> </div> </div> <div class="paragraph"> <p>このキーがネイティブインスタンスのものと*異なる*ことを確認します:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Instance native $ cat /usr/share/ollama/.ollama/id_ed25519.pub ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGyF...(différente) # Instance Docker $ cat ~/ollama-b-data/id_ed25519.pub ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIDDQ...(différente)</code></pre> </div> </div> <div class="paragraph"> <p>�異なる二つの鍵、別々の二つのアイデンティティ。やり遂げた。</p> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="ℹ️"></i> </td> <td class="content"> <div class="paragraph"> <p>コンテナが再起動しても、ボリューム内のキーを <strong>再利用</strong> します。アイデンティティは永続的です。Pro アカウントとの関連付けを失うことはありません。</p> </div> </td> </tr> </table> </div> </div> <div class="sect2"> <h3 id="_ステップ4ollama_comでキーを登録">ステップ4:Ollama.comでキーを登録</h3> <div class="paragraph"> <p><a href="https://ollama.com/settings/keys" class="bare">https://ollama.com/settings/keys</a> の方向 → SSH キーを追加。 Docker インスタンスの公開鍵を貼り付けて確認します。</p> </div> <div class="paragraph"> <p>次に、このアイデンティティを Pro B アカウントにリンクします :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ docker exec -it ollama-instance-b ollama signin</code></pre> </div> </div> <div class="paragraph"> <p>ブラウザーが起動し、B アカウントのメールでログインし、トークンがコンテナの SSH キーに関連付けられます。すべてが問題ないことを確認します：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ docker exec -it ollama-instance-b ollama signin User: cherolivpro</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ステップ_5小さな無料モデルでテストする">ステップ 5：小さな無料モデルでテストする</h3> <div class="paragraph"> <p>Proサブスクリプションの価格を挙げる前に、パイプが正常に機能していることを確認したい。接続を検証するために、ローカルの小さな無料モデルをpullする：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ docker exec ollama-instance-b ollama pull qwen3:0.6b pulling manifest pulling 7f4030143c1c: 100% ▕██████████████████▏ 522 MB success $ curl -s http://localhost:11435/api/tags {"models":[{"name":"qwen3:0.6b","model":"qwen3:0.6b",...}]}</code></pre> </div> </div> <div class="paragraph"> <p>港`11435`答える、モデルは提供されている。 インスタンスBは生きている。</p> </div> <div class="paragraph"> <p>安心したら、私は本当のクラウドProモデルのプルに移ります：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ docker exec ollama-instance-b ollama pull deepseek-v4-pro:cloud pulling manifest pulling 31c3059e137e: 100% ▕██████████████████▏ 344 B success</code></pre> </div> </div> <div class="paragraph"> <p>344オクテットはクラウドモデルのマニフェスト用です — 通常、推論はサーバーサイドで行われ、ローカルではありません。そしてこれが究極のテストです：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ curl -s http://localhost:11435/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{"model":"deepseek-v4-pro:cloud","messages":[{"role":"user","content":"Dis bonjour en une phrase courte."}]}' { "id": "chatcmpl-480", "model": "deepseek-v4-pro", "choices": [{ "message": { "content": "Bonjour !" }, "finish_reason": "stop" }], "usage": { "total_tokens": 181 } }</code></pre> </div> </div> <div class="paragraph"> <p>こんにちは、あなたにも、インスタンスB</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_api_v1models_の罠">API <code>/v1/models</code> の罠</h2> <div class="sectionbody"> <div class="paragraph"> <p>愚かな細かいことで20分を無駄にした。 プロバイダーを設定したとき`ollama-b`OpenCode では、モデルセレクターに何も表示されませんでした。何も。まったく。</p> </div> <div class="paragraph"> <p>理由は？ API`/v1/models`Bインスタンスが返した`{"object":"list","data":null}`代わりに`{"object":"list","data":[]}`どのモデルもプルされていなかったとき。値`null`OpenCode側のパースがクラッシュし、プロバイダーが表示されなかった。</p> </div> <div class="paragraph"> <p>解決策：OpenCodeの設定でモデルを*明示的に*宣言し、動的な発見に依存しないようにする。</p> </div> <div class="listingblock"> <div class="title">~/.config/opencode/opencode.json</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{ "$schema": "https://opencode.ai/config.json", "provider": { "ollama": { "npm": "@ai-sdk/openai-compatible", "name": "Ollama (local)", "options": { "baseURL": "http://localhost:11434/v1" }, "models": { "gemma4:e2b": { "name": "Gemma 4 E2B (local)" } } }, "ollama-b": { "npm": "@ai-sdk/openai-compatible", "name": "Ollama Instance B (Docker)", "options": { "baseURL": "http://localhost:11435/v1" }, "models": { "qwen3:0.6b": { "name": "Qwen3 0.6B (B)" }, "deepseek-v4-pro:cloud": { "name": "DeepSeek V4 Pro (B)" } } } } }</code></pre> </div> </div> <div class="paragraph"> <p>この明示的な宣言により、OpenCodeはすぐにプロバイダーBとそのモデルを認識します。セッションを再起動すると、セレクター`/models`両方のインスタンスを横に並べて表示します。</p> </div> <div class="admonitionblock tip"> <table> <tr> <td class="icon"> <i class="fa icon-tip" title="💡"></i> </td> <td class="content"> <div class="paragraph"> <p>あなたの provider custom が表示されない場合の中に`/models`, ターミナルの再起動に3時間も費やさないでください。モデルを手動で宣言してください 中に`opencode.json`— それは問題を瞬時に解決します。</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_結果2つのセッション2つのアカウントゼロコンフリクト">結果:2つのセッション、2つのアカウント、ゼロコンフリクト</h2> <div class="sectionbody"> <div class="paragraph"> <p>最終的に、私はOpenCodeのセッションを2つ同時に起動できます ：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">Session 1 → /models → Ollama (local) → deepseek-v4-pro:cloud → Compte A Session 2 → /models → Ollama Instance B (Docker) → deepseek-v4-pro:cloud → Compte B</code></pre> </div> </div> <div class="paragraph"> <p>各セッションはそれぞれ独自のクォータとレートリミットを持ち、互いに干渉しません。同じマシン、同じブルーカード、でもメールアドレスは2つ異なります。</p> </div> <div class="paragraph"> <p>そして最高なのは？ Dockerコンテナは`restart: always`. システムの再起動後も手動介入なしで生き残ります。</p> </div> </div> </div> <div class="sect1"> <h2 id="_学んだ教訓">学んだ教訓</h2> <div class="sectionbody"> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>Dockerは全てを隔離する、アイデンティティさえも</strong>— ボリュームのシンプルなバインドマウントで、コンテナに独自のSSHキーのセットを与えることができ、Ollamaの目には物理的に異なるマシンと区別がつかなくなります。</p> </li> <li> <p><strong>2通のメール、同じCB</strong>Ollamaは同じ支払い方法からの複数のサブスクリプションをブロックしません。メールアドレスのみが異なる必要があります。</p> </li> <li> <p><strong>支払う前に無料でテスト</strong> — Un <code>ollama pull qwen3:0.6b</code> (modèle libre, 522 Mo) permet de valider toute la chaîne réseau sans débourser un centime. Vous validez le plomberie d’abord, vous activez le Pro ensuite.</p> </li> <li> <p><strong>/v1/models` と <code>data: null</code> は OpenCode を壊します</strong>— カスタムプロバイダーを設定するときに`"models": {}`, OpenCodeはAPIを通じてモデルの発見を試みます。APIが応答した場合`data: null`, プロバイダーが表示されません。モデルを明示的に宣言してください。</p> </li> <li> <p><strong>2つのアカウント、それは人間のマルチプロセッシングです</strong>— Proアカウント = アクティブなOpenCodeセッション。2つのアカウント = 2つの並列セッション。複数のGradleプロジェクトを同時に扱う人にとって、これはゲームチェンジャー。</p> </li> </ol> </div> </div> </div> <div class="sect1"> <h2 id="_さらに進むために">さらに進むために</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="https://ollama.com/settings/keys">Ollama Settings — SSHキーの管理</a></p> </li> <li> <p><a href="https://docs.ollama.com/">Ollama 公式ドキュメント</a></p> </li> <li> <p><a href="https://hub.docker.com/r/ollama/ollama">Docker Hub上のDocker Ollamaイメージ</a></p> </li> <li> <p><a href="https://opencode.ai/docs/providers/#ollama">OpenCode — 構成プロバイダー Ollama</a></p> </li> </ul> </div> <hr> <div class="paragraph"> <p><em>記事は 2026-05-08 に公開されました</em></p> </div> </div> </div> https://cheroliv.com/blog/2025/0080_kitty_term_post.html Thu, 7 May 2026 00:00:00 +0000 blog/2025/0080_kitty_term_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_kitty_と_zsh_を選ぶ理由は">Kitty と Zsh を選ぶ理由は？</a></li> <li><a href="#_システムの前提条件">システムの前提条件</a></li> <li><a href="#_kittyのダウンロードとインストール">Kittyのダウンロードとインストール</a> <ul class="sectlevel2"> <li><a href="#_インストールスクリプトをダウンロード">インストールスクリプトをダウンロード</a></li> <li><a href="#_シンボリックリンクの作成">シンボリックリンクの作成</a></li> </ul> </li> <li><a href="#_xubuntuへのkittyの統合">XubuntuへのKittyの統合</a> <ul class="sectlevel2"> <li><a href="#_デスクトップのファイルをコピー">デスクトップのファイルをコピー</a></li> <li><a href="#_デスクトップファイルを編集する">デスクトップファイルを編集する</a></li> <li><a href="#_kitty_を既定のターミナルとして関連付ける_オプション">Kitty を既定のターミナルとして関連付ける (オプション)</a></li> </ul> </li> <li><a href="#_zshのインストール">Zshのインストール</a></li> <li><a href="#_zshをデフォルトのシェルとして設定">Zshをデフォルトのシェルとして設定</a> <ul class="sectlevel2"> <li><a href="#_グローバルメソッド_すべての端末向け">グローバルメソッド (すべての端末向け)</a></li> <li><a href="#_kitty専用のメソッド">Kitty専用のメソッド</a></li> </ul> </li> <li><a href="#_zshの設定オプション">Zshの設定（オプション）</a> <ul class="sectlevel2"> <li><a href="#_zshrc_ファイルを作成する">.zshrc ファイルを作成する</a></li> <li><a href="#_最小構成の例">最小構成の例</a></li> </ul> </li> <li><a href="#_ワークフロー全体のサマリー">ワークフロー全体のサマリー</a></li> <li><a href="#_最終確認">最終確認</a> <ul class="sectlevel2"> <li><a href="#_設定ファイルを開く">�📂 設定ファイルを開く</a></li> <li><a href="#_️_追加または変更_font_size">�🖋️ 追加または変更 `font_size</a></li> <li><a href="#_保存して_kitty_を再起動">💾 保存して Kitty を再起動</a></li> <li><a href="#_動的調整_一時ズーム">✅ 動的調整 (一時ズーム)</a></li> </ul> </li> <li><a href="#_oh_my_zshのインストールと設定">Oh My Zshのインストールと設定</a> <ul class="sectlevel2"> <li><a href="#_oh_my_zshのインストール">Oh My Zshのインストール</a></li> <li><a href="#_テーマを変更する">テーマを変更する</a></li> <li><a href="#_検証">�検証</a></li> <li><a href="#_ユースケース図">ユースケース図</a></li> </ul> </li> <li><a href="#_kitty_で透明性を有効にする">Kitty で透明性を有効にする</a> <ul class="sectlevel2"> <li><a href="#_透明性のための前提条件">透明性のための前提条件</a></li> <li><a href="#_kitty_conf_での透明度の設定">kitty.conf での透明度の設定</a></li> <li><a href="#_kitty_を再起動">Kitty を再起動</a></li> <li><a href="#_可能な補足">可能な補足</a></li> <li><a href="#_シーケンス図_kittyの透明度付き初期化">シーケンス図 - Kittyの透明度付き初期化</a></li> <li><a href="#_既知の制限">既知の制限</a></li> </ul> </li> <li><a href="#_ビープ音audible_bellを無効にする">ビープ音（audible bell）を無効にする</a></li> <li><a href="#_kittyのアップデート">Kittyのアップデート</a></li> <li><a href="#_参照">参照</a></li> <li><a href="#_結論">結論</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>このガイドは、Xubuntu 上でターミナル <strong>kitty</strong> をインストールする方法、正しく設定する方法、そしてデフォルトシェルとして <strong>bash</strong> を <strong>zsh</strong> に置き換える方法をステップバイステップで説明します。 kitty プロジェクトはこちらから利用できます: <a href="https://github.com/kovidgoyal/kitty" class="bare">https://github.com/kovidgoyal/kitty</a>.</p> </div> <div class="paragraph"> <p><em><em>_ Kittyは、要求の厳しい開発者に特に適した、モダンで高速かつ設定可能なターミナルです。 </em>_</em></p> </div> </div> </div> <div class="sect1"> <h2 id="_kitty_と_zsh_を選ぶ理由は">Kitty と Zsh を選ぶ理由は？</h2> <div class="sectionbody"> <div class="paragraph"> <p>Kittyは次の点で特徴があります：</p> </div> <div class="ulist"> <ul> <li> <p>GPUアクセラレーションによる高いパフォーマンス,</p> </li> <li> <p>1つのテキストファイルに完全に基づく設定,</p> </li> <li> <p>フォントとリガチャの優れたサポートです。</p> </li> </ul> </div> <div class="paragraph"> <p>Zshはそれに対して、強力なインタラクティブなシェルを提供します：</p> </div> <div class="ulist"> <ul> <li> <p>インテリジェントな補完、</p> </li> <li> <p>カスタマイズ可能なプロンプト,</p> </li> <li> <p>bashとの高い互換性</p> </li> </ul> </div> <div class="paragraph"> <p>Kitty と Zsh を組み合わせることで、生産的で美的な環境を得られます。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml title シンプルなアーキテクチャ Kitty + Zsh actor User User --> Kitty : Lance le terminal Kitty --> Zsh : Initialise le shell interactif Zsh --> System : Interagit avec le système (fichiers, commandes) @enduml</pre> </div> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p>このガイドは意図的にスクリプトによるインストールとXubuntuに限定されています。</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_システムの前提条件">システムの前提条件</h2> <div class="sectionbody"> <div class="paragraph"> <p>始める前に、必要なものを確認してください：</p> </div> <div class="ulist"> <ul> <li> <p>Xubuntu インストール済み</p> </li> <li> <p>インターネットへのアクセス,</p> </li> <li> <p>スクリプトを起動するための機能的なbashシェル。</p> </li> </ul> </div> <div class="paragraph"> <p>環境を確認してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">uname -a lsb_release -a</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_kittyのダウンロードとインストール">Kittyのダウンロードとインストール</h2> <div class="sectionbody"> <div class="paragraph"> <p>Kittyは公式スクリプトを使ってインストールすることを推奨し、そのスクリプトはファイルを配置します。<code>~/.local/kitty.app</code>。</p> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="Important"></i> </td> <td class="content"> <div class="paragraph"> <p>この方法はパッケージマネージャに依存しない（なしの`apt`).</p> </div> </td> </tr> </table> </div> <div class="sect2"> <h3 id="_インストールスクリプトをダウンロード">インストールスクリプトをダウンロード</h3> <div class="paragraph"> <p>次のコマンドを実行してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -L https://sw.kovidgoyal.net/kitty/installer.sh | sh /dev/stdin</code></pre> </div> </div> <div class="paragraph"> <p>このコマンドは実行します：</p> </div> <div class="ulist"> <ul> <li> <p>バイナリのダウンロード,</p> </li> <li> <p>抽出 中に`~/.local/kitty.app`,</p> </li> <li> <p>シンボリックリンクの作成。</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre>@startuml title Kittyのダウンロードとインストール start :curl -L installer.sh; :sh /dev/stdin; :Décompression dans ~/.local/kitty.app; :create symlinks; stop @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_シンボリックリンクの作成">シンボリックリンクの作成</h3> <div class="paragraph"> <p>呼び出すことができるように`kitty`ターミナルから、シンボリックリンクを作成してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">ln -s ~/.local/kitty.app/bin/kitty ~/.local/bin/kitty</code></pre> </div> </div> <div class="paragraph"> <p>追加してください`~/.local/bin`まだPATHに追加していない場合は :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc</code></pre> </div> </div> <div class="paragraph"> <p>インストールを確認できます：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">kitty --version</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_xubuntuへのkittyの統合">XubuntuへのKittyの統合</h2> <div class="sectionbody"> <div class="paragraph"> <p>Kitty がアプリケーションメニューに表示されるように：</p> </div> <div class="sect2"> <h3 id="_デスクトップのファイルをコピー">デスクトップのファイルをコピー</h3> <div class="paragraph"> <p>ファイルをコピーしてください`.desktop`提供 :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">cp ~/.local/kitty.app/share/applications/kitty.desktop ~/.local/share/applications/</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_デスクトップファイルを編集する">デスクトップファイルを編集する</h3> <div class="paragraph"> <p>ファイルを編集してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">nano ~/.local/share/applications/kitty.desktop</code></pre> </div> </div> <div class="paragraph"> <p>次の行を確認または編集してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">[Desktop Entry] Version=1.0 Type=Application Name=Kitty Terminal Comment=Fast GPU-based terminal emulator Exec=/home/$USER/.local/kitty.app/bin/kitty Icon=kitty Categories=System;TerminalEmulator;</code></pre> </div> </div> <div class="paragraph"> <p>置き換えて`YOURUSER`あなたのユーザー名で。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml title XubuntuメニューへのKittyの統合プロセス start :Copier .desktop; :Editer les chemins; :Sauvegarder; :Menu Applications; stop @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_kitty_を既定のターミナルとして関連付ける_オプション">Kitty を既定のターミナルとして関連付ける (オプション)</h3> <div class="paragraph"> <p>Kitty がデフォルトのターミナルとして起動されるようにする :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo update-alternatives --install /usr/bin/x-terminal-emulator x-terminal-emulator ~/.local/kitty.app/bin/kitty 50 sudo update-alternatives --config x-terminal-emulator</code></pre> </div> </div> <div class="paragraph"> <p>選択して`kitty`提案されたメニューに。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_zshのインストール">Zshのインストール</h2> <div class="sectionbody"> <div class="paragraph"> <p>Zsh がまだインストールされていない場合は、実行してください :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo apt install zsh</code></pre> </div> </div> <div class="paragraph"> <p>インストールを確認してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">zsh --version</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_zshをデフォルトのシェルとして設定">Zshをデフォルトのシェルとして設定</h2> <div class="sectionbody"> <div class="paragraph"> <p>シェルをグローバルに変更するか、Kitty内だけで変更することができます。</p> </div> <div class="sect2"> <h3 id="_グローバルメソッド_すべての端末向け">グローバルメソッド (すべての端末向け)</h3> <div class="paragraph"> <p>絶対パスを特定してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">which zsh</code></pre> </div> </div> <div class="paragraph"> <p>一般的に`/usr/bin/zsh`。</p> </div> <div class="paragraph"> <p>デフォルトのシェルを変更：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">chsh -s /usr/bin/zsh</code></pre> </div> </div> <div class="paragraph"> <p>ログアウトして、もう一度ログインしてください。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml title シェルのグローバルな変更 actor User User --> Bash : Session actuelle User --> System : chsh -s /usr/bin/zsh System --> "/etc/passwd" : Modifie le shell note right of "/etc/passwd" : Shell par défaut mis à jour @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_kitty専用のメソッド">Kitty専用のメソッド</h3> <div class="paragraph"> <p>Kitty のシェルだけを変更したい場合は、設定ファイルを編集してください :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">nano ~/.config/kitty/kitty.conf</code></pre> </div> </div> <div class="paragraph"> <p>この行を追加してください:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">shell zsh</code></pre> </div> </div> <div class="paragraph"> <p>Kittyを保存して再起動してください。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_zshの設定オプション">Zshの設定（オプション）</h2> <div class="sectionbody"> <div class="paragraph"> <p>Zshをカスタマイズする：</p> </div> <div class="sect2"> <h3 id="_zshrc_ファイルを作成する">.zshrc ファイルを作成する</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">touch ~/.zshrc nano ~/.zshrc</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_最小構成の例">最小構成の例</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">export ZSH_THEME="robbyrussell" export PATH="$HOME/.local/bin:$PATH" alias ll="ls -la"</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ワークフロー全体のサマリー">ワークフロー全体のサマリー</h2> <div class="sectionbody"> <div class="paragraph"> <p>以下の図は、プロセス全体をまとめています：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml title インストールと設定のワークフロー start :Téléchargement script Kitty; :Installation dans ~/.local; :Création symlink; :Ajout ~/.local/bin au PATH; if (Zsh installé ?) then (non) :sudo apt install zsh; endif :Configurer Kitty.desktop; :Optionnel - changer terminal par défaut; :Optionnel - chsh -s /usr/bin/zsh; stop @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_最終確認">最終確認</h2> <div class="sectionbody"> <div class="paragraph"> <p>キティを起動してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">kitty</code></pre> </div> </div> <div class="paragraph"> <p>あなたはそれが見えるはずです`zsh`アクティブです :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">echo $SHELL</code></pre> </div> </div> <div class="paragraph"> <p>期待される結果：</p> </div> <div class="paragraph"> <p>/usr/bin/zsh</p> </div> <div class="paragraph"> <p>フォントサイズを変更する<strong>キティ</strong>, パラメータを調整する必要があります`font_size`設定ファイル内で。以下は詳細な手順です。</p> </div> <div class="sect2"> <h3 id="_設定ファイルを開く">�📂 設定ファイルを開く</h3> <div class="paragraph"> <p>メインの構成ファイルは通常、次の場所にあります：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">~/.config/kitty/kitty.conf</code></pre> </div> </div> <div class="paragraph"> <p>このファイルがまだ存在しない場合は、作成することができます。 例 :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">nano ~/.config/kitty/kitty.conf</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_️_追加または変更_font_size">�🖋️ 追加または変更 `font_size</h3> <div class="paragraph"> <p>次のディレクティブを追加し、すでに存在している場合はそれを変更してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">font_size 14.0</code></pre> </div> </div> <div class="paragraph"> <p>ここ`14.0`希望のサイズに対応します。小数値であれば任意の値を入力できます。たとえば`12.0`, <code>15.5</code>, など</p> </div> </div> <div class="sect2"> <h3 id="_保存して_kitty_を再起動">💾 保存して Kitty を再起動</h3> <div class="ulist"> <ul> <li> <p>保存 (<code>Ctrl + O</code>、そして`Entrée`)そして離れて(<code>Ctrl + X</code>) あなたが使っている場合`nano`.</p> </li> <li> <p>Kitty のすべてのウィンドウを閉じ、ターミナルを再起動して変更を反映させてください。</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_動的調整_一時ズーム">✅ 動的調整 (一時ズーム)</h3> <div class="paragraph"> <p>一時的にズームイン/ズームアウトしたいが設定を変更しない場合は、デフォルトのキーボードショートカットを使用してください：</p> </div> <div class="ulist"> <ul> <li> <p><strong>フォントサイズを増やす</strong> :</p> </li> </ul> </div> <div class="paragraph"> <p><code>Ctrl + Shift + =</code></p> </div> <div class="ulist"> <ul> <li> <p><strong>フォントサイズを小さくする</strong>:</p> </li> </ul> </div> <div class="paragraph"> <p><code>Ctrl + Shift + -</code></p> </div> <div class="ulist"> <ul> <li> <p><strong>サイズをリセット</strong>：</p> </li> </ul> </div> <div class="paragraph"> <p><code>Ctrl + Shift + Backspace</code></p> </div> <div class="paragraph"> <p>これらの設定は端末を閉じた後も保持されません。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_oh_my_zshのインストールと設定">Oh My Zshのインストールと設定</h2> <div class="sectionbody"> <div class="paragraph"> <p>Zshがインストールされ、デフォルトシェルとして設定された後、*Oh My Zsh*で環境を豊かにすることができます。Zshの構成管理フレームワークである*Oh My Zsh*は、以下を提供します：</p> </div> <div class="ulist"> <ul> <li> <p>プロンプト用のテーマのコレクション,</p> </li> <li> <p>多数のプラグイン,</p> </li> <li> <p>設定の明確な組織</p> </li> </ul> </div> <div class="sect2"> <h3 id="_oh_my_zshのインストール">Oh My Zshのインストール</h3> <div class="paragraph"> <p>Zsh がアクティブであることを確認してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">zsh --version</code></pre> </div> </div> <div class="paragraph"> <p>必要なら、起動してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">zsh</code></pre> </div> </div> <div class="paragraph"> <p>その後、公式インストールスクリプトをダウンロードして実行してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"</code></pre> </div> </div> <div class="paragraph"> <p>このスクリプト：</p> </div> <div class="ulist"> <ul> <li> <p>フォルダーを作成して`~/.oh-my-zsh`,</p> </li> <li> <p>ファイルを保存する場合があります`~/.zshrc`,</p> </li> <li> <p>自動的に新しいプロンプトをアクティベートします。</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_テーマを変更する">テーマを変更する</h3> <div class="paragraph"> <p>設定ファイルを開いてください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">nano ~/.zshrc</code></pre> </div> </div> <div class="paragraph"> <p>変数を変更してください`ZSH_THEME`別のテーマを選択するために（例えば`agnoster`) :</p> </div> <div class="paragraph"> <p>ZSH_THEME="agnoster</p> </div> <div class="paragraph"> <p>設定を保存し、再読み込みしてください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">source ~/.zshrc</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_検証">�検証</h3> <div class="paragraph"> <p>Kitty を起動して、プロンプトが確かに変わったことを確認してください。 次のコマンドを実行して、Oh My Zsh がアクティブであることを確認できます：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">echo $ZSH</code></pre> </div> </div> <div class="paragraph"> <p>結果は次のように似ているはずです：</p> </div> <div class="paragraph"> <p>/home/あなたのユーザー/.oh-my-zsh</p> </div> </div> <div class="sect2"> <h3 id="_ユースケース図">ユースケース図</h3> <div class="listingblock"> <div class="content"> <pre>@startuml title ユースケース Oh My Zshのインストールと使い方 actor Utilisateur as User package "Kittyターミナル" { component "Zsh シェル" as Zsh } component "Oh My Zsh フレームワーク" as OhMyZsh User --> Kitty : Lance Kitty Kitty --> Zsh : Initialise Zsh Zsh --> OhMyZsh : Charge configuration (~/.zshrc, thèmes, plugins) User --> OhMyZsh : Personnalise le thème et les plugins @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_kitty_で透明性を有効にする">Kitty で透明性を有効にする</h2> <div class="sectionbody"> <div class="paragraph"> <p>Kittyの最も気に入られた機能の1つは、ターミナルの背景に*透明性*を追加できることです。これにより、基盤となる環境（ウィンドウ、デスクトップなど）をわずかに見ることができ、これはマルチタスク時に特に役立ちます。</p> </div> <div class="sect2"> <h3 id="_透明性のための前提条件">透明性のための前提条件</h3> <div class="paragraph"> <p>Kittyにおける透明性は<strong>ウィンドウコンポーザー</strong>グラフィカル環境によって使用される。 Xubuntu (XFCEベース)では、次のことを確認してください：<strong>構成が有効になっています</strong>。</p> </div> <div class="ulist"> <div class="title">確認 :</div> <ul> <li> <p>右クリック > デスクトップ > 設定 ><strong>ウィンドウマネージャーの設定</strong>,</p> </li> <li> <p>タブ<strong>作曲家</strong>: 「<strong>"コンポジットを有効にする</strong>"」チェックボックスはチェックされている必要があります。</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre>@startuml title Use Case - Kitty で透明度を有効にする actor Utilisateur rectangle "グラフィカル環境 (XFCE/Xubuntu)" { usecase "合成を有効にする" as UC1 } rectangle "Kittyターミナル" { usecase "kitty.conf で透明度を設定する" as UC2 } Utilisateur --> UC1 Utilisateur --> UC2 @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_kitty_conf_での透明度の設定">kitty.conf での透明度の設定</h3> <div class="paragraph"> <p>設定ファイルを開いてください`~/.config/kitty/kitty.conf`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">nano ~/.config/kitty/kitty.conf</code></pre> </div> </div> <div class="paragraph"> <p>次の行を追加または変更してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-conf hljs" data-lang="conf">background_opacity 0.85</code></pre> </div> </div> <div class="paragraph"> <p>このパラメータは、次の範囲の値を受け付けます：</p> </div> <div class="ulist"> <ul> <li> <p><code>1.0</code>→ 不透明（透明性なし），</p> </li> <li> <p><code>0.0</code>→ 完全に 透明 （使用できない），</p> </li> <li> <p>中間値のような`0.90`, <code>0.75</code>, など</p> </li> </ul> </div> <div class="paragraph"> <p>良いビジュアルな妥協点は通常、<code>0.85</code> et <code>0.95</code>。</p> </div> </div> <div class="sect2"> <h3 id="_kitty_を再起動">Kitty を再起動</h3> <div class="paragraph"> <p>Kittyのすべてのインスタンスを閉じ、変更が反映されるように新しいウィンドウを再起動してください。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">kitty</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_可能な補足">可能な補足</h3> <div class="paragraph"> <p>カスタム端末の背景を使用している場合、背景色に透明度を設定することもできます（RGBA）：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-conf hljs" data-lang="conf">background #1e1e2eff</code></pre> </div> </div> <div class="paragraph"> <p>最後のコンポーネント(<code>ff</code>) 示す 不透明度 (で`00` à <code>ff</code>).</p> </div> </div> <div class="sect2"> <h3 id="_シーケンス図_kittyの透明度付き初期化">シーケンス図 - Kittyの透明度付き初期化</h3> <div class="listingblock"> <div class="content"> <pre>@startuml title 透明付きのKitty起動シーケンス actor User participant "キティ" as Kitty participant "XFCE コンポジター" as XFCE participant "GPU/ウィンドウマネージャ" as WM User -> Kitty : Lance Kitty Kitty -> kitty.conf : Lit configuration Kitty -> XFCE : Vérifie composition activée XFCE --> Kitty : Composition = active Kitty -> WM : Demande allocation fenêtrée transparente WM --> Kitty : OK (rendu avec alpha < 1) Kitty -> User : Affiche terminal translucide @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_既知の制限">既知の制限</h3> <div class="admonitionblock warning"> <table> <tr> <td class="icon"> <i class="fa icon-warning" title="Warning"></i> </td> <td class="content"> <div class="paragraph"> <p>透明度が機能しない場合は： - XFCE コンポジタは無効になっています、 - 互換性のないウィンドウマネージャが使用されています, - あなたはKittyをバックグラウンドで透明度サポートなしの*tmux*モードで使用しています。</p> </div> </td> </tr> </table> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ビープ音audible_bellを無効にする">ビープ音（audible bell）を無効にする</h2> <div class="sectionbody"> <div class="paragraph"> <p>デフォルトでは、Kitty は間違ったコマンドが入力されたときや、ターミナル イベントがトリガーされたときに <strong>bip</strong> 音を鳴らします。この音はすぐに鬱陶しくなることがあります、特に激しい開発環境では。</p> </div> <div class="paragraph"> <p>この動作を無効にするには、ファイルに次のディレクティブを追加してください。<code>~/.config/kitty/kitty.conf</code>(Note: Since there is no French source text provided, the translation is empty.)</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-conf hljs" data-lang="conf">audible_bell no</code></pre> </div> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p>ビープ音の代わりに、*ビジュアルフィードバック*も有効にできます :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-conf hljs" data-lang="conf">visual_bell yes</code></pre> </div> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_kittyのアップデート">Kittyのアップデート</h2> <div class="sectionbody"> <div class="paragraph"> <p>Kittyがスクリプトでインストールされ、パッケージマネージャーではないため、アップデートは公式インストールスクリプトを再実行することで行われます。これにより、最新バージョンをダウンロードし、既存のインストールをアップデートすることができますで`~/.local/kitty.app`.</p> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p>接尾辞`.app`道の中`~/.local/kitty.app`これは、KittyのLinuxへの公式スクリプトによるインストールの慣習であり、macOSとの独占的な互換性を示すものではありません。</p> </div> </td> </tr> </table> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="Important"></i> </td> <td class="content"> <div class="paragraph"> <p>アップデートコマンドを実行する前に、ホームディレクトリにいることを確認してください。 (<code>~</code>)</p> </div> </td> </tr> </table> </div> <div class="paragraph"> <p>以下のコマンドをホームディレクトリから実行してください。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -L https://sw.kovidgoyal.net/kitty/installer.sh | sh /dev/stdin</code></pre> </div> </div> <div class="paragraph"> <p>このスクリプトは次のように処理します：</p> </div> <div class="ulist"> <ul> <li> <p>新しいバージョンのバイナリをダウンロード</p> </li> <li> <p>ファイルを抽出する`~/.local/kitty.app`。</p> </li> <li> <p>必要に応じてシンボリックリンクを更新してください。</p> </li> </ul> </div> <div class="paragraph"> <p>アップデート後は、すべての Kitty インスタンスを閉じてから再起動することをお勧めします。これにより、新しいバージョンが正しく反映されることを確認できます。</p> </div> </div> </div> <div class="sect1"> <h2 id="_参照">参照</h2> <div class="sectionbody"> <div class="paragraph"> <p>カスタマイズをさらに詳しく知りたい場合は、公式ドキュメントを参照してください：</p> </div> <div class="ulist"> <ul> <li> <p>Kitty : <a href="https://sw.kovidgoyal.net/kitty/" class="bare">https://sw.kovidgoyal.net/kitty/</a></p> </li> <li> <p><a href="https://sw.kovidgoyal.net/kitty/conf/#opt-kitty.background_opacity" class="bare">https://sw.kovidgoyal.net/kitty/conf/#opt-kitty.background_opacity</a></p> </li> <li> <p><a href="https://sw.kovidgoyal.net/kitty/conf/#opt-kitty.audible_bell" class="bare">https://sw.kovidgoyal.net/kitty/conf/#opt-kitty.audible_bell</a></p> </li> <li> <p>Zsh : <a href="https://zsh.sourceforge.io/" class="bare">https://zsh.sourceforge.io/</a></p> </li> <li> <p>GitHub: <a href="https://github.com/kovidgoyal/kitty" class="bare">https://github.com/kovidgoyal/kitty</a></p> </li> <li> <p>Zsh: <a href="https://zsh.sourceforge.io/" class="bare">https://zsh.sourceforge.io/</a></p> </li> <li> <p><a href="https://ohmyz.sh/" class="bare">https://ohmyz.sh/</a></p> </li> <li> <p><a href="https://github.com/ohmyzsh/ohmyzsh/wiki" class="bare">https://github.com/ohmyzsh/ohmyzsh/wiki</a></p> </li> <li> <p><a href="https://docs.xfce.org/xfce/xfwm4/compositor" class="bare">https://docs.xfce.org/xfce/xfwm4/compositor</a></p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>あなたは今：</p> </div> <div class="ulist"> <ul> <li> <p>現代的で高性能なターミナル (Kitty)</p> </li> <li> <p>強力でカスタマイズ可能なシェル（Zsh）</p> </li> <li> <p>システムパッケージに依存しないきれいな構成</p> </li> <li> <p>見た目も機能も優れた、Oh My Zsh を装備したターミナル</p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2026/0119_benchmark_dgx_spark_vs_cloud_abonnement_llm_post.html Wed, 6 May 2026 00:00:00 +0000 blog/2026/0119_benchmark_dgx_spark_vs_cloud_abonnement_llm_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_le_contexte_un_marché_qui_a_basculé">Le Contexte : Un Marché Qui a Basculé</a></li> <li><a href="#_le_panel_des_options">Le Panel des Options</a> <ul class="sectlevel2"> <li><a href="#_ce_que_jai_exclu_et_pourquoi">Ce Que J’ai Exclu (et Pourquoi)</a></li> </ul> </li> <li><a href="#_inférence_simple_la_mort_du_hardware_local">Inférence Simple : La Mort du Hardware Local</a> <ul class="sectlevel2"> <li><a href="#_le_calcul">Le Calcul</a></li> <li><a href="#_même_avec_un_usage_intensif">Même avec un Usage Intensif</a></li> </ul> </li> <li><a href="#_fine_tuning_le_cloud_est_imbattable">Fine-Tuning : Le Cloud Est Imbattable</a> <ul class="sectlevel2"> <li><a href="#_le_coût_réel_dun_fine_tune">Le Coût Réel d’un Fine-Tune</a></li> <li><a href="#_les_acteurs_spécialisés">Les Acteurs Spécialisés</a></li> </ul> </li> <li><a href="#_la_seule_vraie_raison_la_souveraineté_des_données">La Seule Vraie Raison : La Souveraineté des Données</a> <ul class="sectlevel2"> <li><a href="#_le_vrai_calcul_de_la_confidentialité">Le Vrai Calcul de la Confidentialité</a></li> </ul> </li> <li><a href="#_synthèse_la_matrice_de_décision">Synthèse : La Matrice de Décision</a></li> <li><a href="#_le_cas_particulier_labonnement_pro_face_aux_modèles_chinois">Le Cas Particulier : L’Abonnement Pro Face aux Modèles Chinois</a> <ul class="sectlevel2"> <li><a href="#_pourquoi_les_modèles_chinois_changent_tout">Pourquoi les Modèles Chinois Changent Tout</a></li> <li><a href="#_ce_que_ça_veut_dire_pour_le_hardware">Ce Que Ça Veut Dire pour le Hardware</a></li> </ul> </li> <li><a href="#_et_huawei">Et Huawei ?</a></li> <li><a href="#_conclusion_le_luxe_de_la_proximité">Conclusion : Le Luxe de la Proximité</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">temps de lecture : 14 minutes</div> <p>NVIDIA vend le DGX Spark comme un « supercalculateur IA de bureau » à $4 699. Ollama propose ses modèles cloud à $20/mois. Un H100 se loue $1.38/h chez Vast.ai. Et les modèles chinois open-source — DeepSeek, Qwen, GLM — sont disponibles partout, gratuitement, sans avoir à acheter une carte. Alors, ce Spark, il sert à quoi au juste ? J’ai fait les maths.</p> </div> <div class="dlist"> <dl> <dt class="hdlist1">toc</dt> <dd> <p>[]</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_le_contexte_un_marché_qui_a_basculé">Le Contexte : Un Marché Qui a Basculé</h2> <div class="sectionbody"> <div class="paragraph"> <p>En mai 2026, le paysage de l’IA a radicalement changé par rapport à l’annonce du DGX Spark au CES 2025. Trois forces ont convergé pour rendre le hardware local de plus en plus difficile à justifier :</p> </div> <div class="ulist"> <ul> <li> <p><strong>L’effondrement des prix du cloud GPU</strong> : un H100 se loue entre $1.38 et $3/h, contre $5-8/h il y a 18 mois</p> </li> <li> <p><strong>L’explosion des modèles chinois open-source</strong> : DeepSeek-V4, Qwen-3, GLM-5 sont compétitifs avec les modèles occidentaux, disponibles gratuitement</p> </li> <li> <p><strong>La montée des plateformes d’inférence managée</strong> : Ollama, Groq, Together AI proposent des API à des tarifs agressifs, avec des paliers gratuits généreux</p> </li> </ul> </div> <div class="paragraph"> <p>Le DGX Spark, annoncé à $2 999 puis monté à $4 699, arrive dans un monde qui n’a plus besoin de lui.</p> </div> </div> </div> <div class="sect1"> <h2 id="_le_panel_des_options">Le Panel des Options</h2> <div class="sectionbody"> <div class="paragraph"> <p>Voici les solutions disponibles en mai 2026 pour faire tourner des LLMs, de la plus légère à la plus lourde :</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> <col style="width: 2.5%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Option</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Coût</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">VRAM / Capacité</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Modèles accessibles</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Contrainte principale</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Ollama Free</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">$0/mois</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Cloud léger</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Tous modèles publics</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Usage limité, 1 modèle simultané</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Claude Pro</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">$20/mois (~$240/an)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">N/A (API fermée)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Claude 4.x uniquement</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Modèle unique, pas d’open-source</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Ollama Pro</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">$20/mois (~$200/an)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Cloud medium</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Tous modèles publics</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">3 modèles simultanés max</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Ollama Max</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">$100/mois (~$1 200/an)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Cloud heavy</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Tous modèles publics</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">10 modèles simultanés</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Cloud GPU (H100)</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">$1.38-3/h</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">80 Go HBM</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Tous modèles, fine-tuning</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Facturation horaire, setup requis</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>DGX Spark</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">$4 699 (achat)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">128 Go unifié</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Tous modèles <128 Go</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Lent (~10x moins qu’un H100), fixe</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Mac Studio M3 Ultra</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">~$5 000+</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">192 Go unifié</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Tous modèles <192 Go</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Pas CUDA, écosystème MLX</p></td> </tr> </tbody> </table> <div class="admonitionblock tip"> <table> <tr> <td class="icon"> <i class="fa icon-tip" title="💡"></i> </td> <td class="content"> <div class="paragraph"> <p>Les prix cloud GPU cités sont ceux de Vast.ai et RunPod en mai 2026 — du spot/on-demand, pas du réservé. Les prix des hyperscalers (AWS, GCP, Azure) restent 2-3x plus élevés.</p> </div> </td> </tr> </table> </div> <div class="sect2"> <h3 id="_ce_que_jai_exclu_et_pourquoi">Ce Que J’ai Exclu (et Pourquoi)</h3> <div class="paragraph"> <p>J’ai volontairement exclu les options suivantes de ce benchmark :</p> </div> <div class="ulist"> <ul> <li> <p><strong>API OpenAI / Anthropic / Google</strong> : le sujet ici est de faire tourner des modèles <strong>open-source</strong> qu’on peut choisir, fine-tuner, et ne pas être dépendant d’un vendor unique</p> </li> <li> <p><strong>Huawei Ascend / Atlas</strong> : Huawei ne commercialise pas d’équivalent desktop au DGX Spark. La gamme Ascend (910C, 910D) et Atlas (300I Duo, 350) est orientée datacenter — cartes PCIe, serveurs rack — pas des boîtiers compacts prêts à brancher. La puce Ascend 910C embarque 128 Go HBM mais c’est une puce serveur, pas un système autonome. L’Atlas 300I Duo offre 96 Go pour ~$1 400 mais nécessite une machine hôte</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_inférence_simple_la_mort_du_hardware_local">Inférence Simple : La Mort du Hardware Local</h2> <div class="sectionbody"> <div class="paragraph"> <p>Commençons par le cas d’usage le plus commun : chatter avec un LLM, faire du code review, générer du texte. Pas de fine-tuning, pas de batch processing, juste de l’inférence interactive.</p> </div> <div class="sect2"> <h3 id="_le_calcul">Le Calcul</h3> <div class="paragraph"> <p>Un DGX Spark à $4 699. Divisons par le coût annuel de chaque abonnement :</p> </div> <div id="diag-breakeven" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center title Seuil de Rentabilité — DGX Spark ($4 699) vs Abonnements rectangle "DGX Spark\n$4 699" as spark #FFCDD2 rectangle "Ollama Pro\n$200/an" as opro #C8E6C9 rectangle "Claude Pro\n$240/an" as cpro #C8E6C9 rectangle "Ollama Max\n$1 200/an" as omax #FFF9C4 rectangle "Cloud H100\n$3/h × 10h/sem" as cloud #BBDEFB spark --> opro : 23.5 années ⏳ spark --> cpro : 19.6 années ⏳ spark --> omax : 3.9 années spark --> cloud : 3.0 années (à 10h/semaine, intermittent) note bottom of spark Sans compter l'électricité (~$150/an) Sans compter l'obsolescence hardware Sans compter qu'il est 10x plus lent end note @enduml</pre> </div> </div> <div class="paragraph"> <p>Le verdict est brutal. Pour de l’inférence :</p> </div> <div class="ulist"> <ul> <li> <p><strong>Ollama Pro</strong> : il vous faudrait <strong>23 ans</strong> pour amortir un DGX Spark. Le Spark sera obsolète depuis 20 ans.</p> </li> <li> <p><strong>Ollama Max</strong> : <strong>4 ans</strong> — à condition d’utiliser le Spark 24/7, ce que personne ne fait</p> </li> <li> <p><strong>Claude Pro</strong> : même problème, <strong>20 ans</strong> pour du single-model fermé</p> </li> </ul> </div> <div class="paragraph"> <p><em><em>_ La promesse du « supercalculateur IA de bureau » se heurte à une réalité comptable élémentaire : $4 699 / $20 par mois = jamais rentable pour un usage individuel. </em>_</em></p> </div> </div> <div class="sect2"> <h3 id="_même_avec_un_usage_intensif">Même avec un Usage Intensif</h3> <div class="paragraph"> <p>Prenons le pire scénario pour le cloud : vous faites tourner un H100 8h/jour, 5 jours/semaine, 52 semaines/an.</p> </div> <div class="ulist"> <ul> <li> <p>8 × 5 × 52 = 2 080 heures/an</p> </li> <li> <p>2 080 × $2/h (prix moyen spot H100) = <strong>$4 160/an</strong></p> </li> </ul> </div> <div class="paragraph"> <p>Le Spark ($4 699) est rentabilisé en <strong>13 mois</strong>. Sauf que :</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>Le H100 est <strong>~10x plus rapide</strong> que le GB10 du Spark. Vous faites en 1h ce que le Spark fait en 10h. Pour le même volume de travail, le H100 vous coûte $416/an, pas $4 160.</p> </li> <li> <p>Le H100 a 80 Go HBM à 3.35 To/s de bande passante. Le Spark a 128 Go LPDDR5X à 273 Go/s. Pour les gros modèles, la bande passante compte plus que la capacité.</p> </li> </ol> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="❗"></i> </td> <td class="content"> <div class="paragraph"> <p>Comparer 1h de H100 à 1h de Spark n’a pas de sens. Le H100 fait le travail 10x plus vite. Le vrai coût cloud pour un workload donné est donc ~10x inférieur au calcul naïf basé sur les heures.</p> </div> </td> </tr> </table> </div> </div> </div> </div> <div class="sect1"> <h2 id="_fine_tuning_le_cloud_est_imbattable">Fine-Tuning : Le Cloud Est Imbattable</h2> <div class="sectionbody"> <div class="paragraph"> <p>L’argument classique des défenseurs du Spark : « oui mais pour le fine-tuning, c’est différent ».</p> </div> <div class="paragraph"> <p>Non, ça ne l’est pas.</p> </div> <div class="sect2"> <h3 id="_le_coût_réel_dun_fine_tune">Le Coût Réel d’un Fine-Tune</h3> <div class="paragraph"> <p>Un fine-tune LoRA/QLoRA sur Unsloth d’un modèle 7B :</p> </div> <div class="ulist"> <ul> <li> <p>~2-3h sur un H100 = <strong>$5 à $9</strong></p> </li> <li> <p>Même chose sur le Spark = <strong>20-30h</strong> (10x plus lent), bloque la machine</p> </li> </ul> </div> <div class="paragraph"> <p>Avec les $4 699 du Spark, vous pouvez financer :</p> </div> <div class="ulist"> <ul> <li> <p><strong>~500 à ~900 fine-tunes</strong> en cloud H100</p> </li> <li> <p>Ou <strong>~23 ans</strong> d’Ollama Pro</p> </li> <li> <p>Ou <strong>~4 ans</strong> d’Ollama Max</p> </li> </ul> </div> <div class="paragraph"> <p>Et pour des modèles plus gros (70B+) :</p> </div> <div class="ulist"> <ul> <li> <p>Le Spark avec ses 128 Go peut charger un 70B en Q4 — mais le fine-tune sera extrêmement lent</p> </li> <li> <p>Un H100 avec 80 Go peut fine-tuner un 70B en QLoRA 4-bit en quelques heures</p> </li> <li> <p>Pour du full fine-tune, il faut du multi-GPU de toute façon — le Spark est hors course</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_les_acteurs_spécialisés">Les Acteurs Spécialisés</h3> <div class="paragraph"> <p>En 2026, des plateformes comme Unsloth, Modal, Replicate, et Together AI proposent du fine-tuning serverless :</p> </div> <div class="ulist"> <ul> <li> <p>Pas de gestion de GPU</p> </li> <li> <p>Pas de configuration d’environnement</p> </li> <li> <p>Paiement à la minute</p> </li> <li> <p>Optimisations intégrées (flash attention, quantization automatique)</p> </li> </ul> </div> <div id="diag-fine-tuning-cost" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center title <size:20>Coût d'un Fine-Tune LoRA 7B — Comparaison</size> note as N |= Option |= Coût par fine-tune |= Fine-tunes possibles avec $4 699 | | **Replicate** | $3-5 | ~1 000 | | **Modal (serverless)** | $2-4 | ~1 500 | | **Unsloth + Vast.ai H100** | $5-9 | ~500-900 | | **Together AI** | $4-8 | ~600-1 000 | | **DGX Spark** | « gratuit » mais 20-30h | ∞ (en théorie) | end note note bottom Le Spark est « gratuit » par fine-tune seulement si votre temps vaut $0/h et que vous n'avez pas besoin de la machine pour autre chose pendant 30h end note @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_la_seule_vraie_raison_la_souveraineté_des_données">La Seule Vraie Raison : La Souveraineté des Données</h2> <div class="sectionbody"> <div class="paragraph"> <p>Après avoir éliminé l’inférence, le fine-tuning, et le rapport qualité/prix — que reste-t-il au Spark ?</p> </div> <div class="paragraph"> <p><strong>La confidentialité absolue.</strong></p> </div> <div class="paragraph"> <p>Pas la confidentialité « je ne veux pas que mes prompts soient lus par un employé d’OpenAI ». Ça, c’est un faux problème en 2026 : Ollama, Groq, et la plupart des providers respectables ont des politiques de zéro log et zéro rétention.</p> </div> <div class="paragraph"> <p>La vraie confidentialité, c’est :</p> </div> <div class="ulist"> <ul> <li> <p><strong>Air-gap réglementaire</strong> : défense, diplomatie, santé — les données ne peuvent <strong>physiquement</strong> pas quitter le bâtiment</p> </li> <li> <p><strong>Données propriétaires critiques</strong> : code source d’un produit non publié, secrets industriels, algorithmes de trading</p> </li> <li> <p><strong>Résilience réseau</strong> : l’IA doit continuer à fonctionner même si Internet tombe</p> </li> </ul> </div> <div class="admonitionblock caution"> <table> <tr> <td class="icon"> <i class="fa icon-caution" title="🔒"></i> </td> <td class="content"> <div class="paragraph"> <p>Mais soyons honnêtes : quel pourcentage des acheteurs de DGX Spark est réellement dans ce cas ? 1% ? Le reste, c’est du « nice to have » transformé en dépense à $4 699.</p> </div> </td> </tr> </table> </div> <div class="sect2"> <h3 id="_le_vrai_calcul_de_la_confidentialité">Le Vrai Calcul de la Confidentialité</h3> <div class="paragraph"> <p>Pour un usage individuel :</p> </div> <div class="ulist"> <ul> <li> <p><strong>Ollama Pro</strong> ($20/mois) + modèles open source chinois = solution pragmatique</p> </li> <li> <p>Si un prompt fuit chez Ollama, il se noie dans les millions de requêtes quotidiennes. C’est la goutte d’eau dans l’océan.</p> </li> <li> <p>Le risque réel n’est pas la fuite d’un prompt — c’est l’entraînement non consenti sur vos données. Et ça, les providers sérieux l’interdisent contractuellement.</p> </li> </ul> </div> <div class="paragraph"> <p><em><em>_ La peur de « distiller son prompt dans le LLM » est un niveau de propagation d’information personnel tellement dilué qu’il relève plus de l’anxiété que de la menace réelle. À l’échelle industrielle, c’est différent. Mais à l’échelle individuelle, c’est du bruit. </em>_</em></p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_synthèse_la_matrice_de_décision">Synthèse : La Matrice de Décision</h2> <div class="sectionbody"> <div id="diag-decision-matrix" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center title Quelle Solution IA Choisir en 2026 ? start :Quel est votre besoin principal ?; switch (Besoin) case (Inférence interactive occasionnelle) :**Ollama Free**\n$0/mois, tous modèles open-source; stop case (Inférence quotidienne, code review, dev) :**Ollama Pro** ($20/mois)\nAccès à tous les modèles open-source\nDeepSeek, Qwen, GLM, Llama, Mistral; stop case (Agents IA, multi-modèles, usage intensif) :Contexte > 30K tokens ?; if (Oui) then :**Ollama Max** ($100/mois)\n10 modèles simultanés\nContexte long sans dégradation; stop else (Non) :**Cloud GPU H100 spot** ($1.38–3/h)\n+ Unsloth/Modal pour fine-tuning\nPerformance brute maximale; stop endif case (Fine-tuning régulier) :**Vast.ai H100 + Unsloth** ($5–9/fine-tune)\nou **Together AI / Modal** (serverless)\n500+ fine-tunes pour le prix d’un Spark; stop case (Air-gap obligatoire) :Données classifiées ?; if (Oui) then :**DGX Spark** ou **Mac Studio M3 Ultra**\nSeul cas où le hardware local est justifié\n(pas économiquement — politiquement); stop else (Non) :Retour au cloud : pas de besoin d’air-gap; stop endif endswitch @enduml</pre> </div> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2222%;"> <col style="width: 2.2232%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Critère</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ollama Free</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ollama Pro</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Cloud GPU H100</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">DGX Spark</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Inférence</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅ Limitée</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅ Confortable</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅ Overkill</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">⚠️ Lent</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fine-tuning</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">❌</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">❌</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅ Imbattable</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">⚠️ Possible mais lent</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Coût annuel</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">$0</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">$200</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Variable (~$416-2 080*)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">$4 699 upfront</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Confidentialité</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">⚠️ Cloud US</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">⚠️ Cloud US</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">⚠️ Cloud US (variable)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅ Totale</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Maintenance</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Aucune</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Aucune</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Setup unique</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Électricité, mises à jour</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Obsolescence</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Aucune</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Aucune</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Aucune</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">3-5 ans</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Écosystème logiciel</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Tous modèles open</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Tous modèles open</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Tous modèles open</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">CUDA (mais lent)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Veridict</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Occasionnel</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Recommandé</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Pros/Recherche</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Air-gap uniquement</p></td> </tr> </tbody> </table> <div class="paragraph"> <p><em>*Variable selon volume de travail ; avec vitesse H100 ~10x > Spark, le coût effectif pour un workload donné est bas.</em></p> </div> </div> </div> <div class="sect1"> <h2 id="_le_cas_particulier_labonnement_pro_face_aux_modèles_chinois">Le Cas Particulier : L’Abonnement Pro Face aux Modèles Chinois</h2> <div class="sectionbody"> <div class="paragraph"> <p>Un point mérite d’être souligné : la combinaison <strong>Ollama Pro à $20/mois + modèles chinois open-source</strong> est probablement le meilleur rapport qualité/prix de l’histoire de l’IA grand public.</p> </div> <div class="sect2"> <h3 id="_pourquoi_les_modèles_chinois_changent_tout">Pourquoi les Modèles Chinois Changent Tout</h3> <div class="ulist"> <ul> <li> <p><strong>DeepSeek-V4-Pro</strong> : 1.6T params, CSA+HCA, 1M contexte, compétitif avec Claude 4 et GPT-5 pour le code</p> </li> <li> <p><strong>Qwen-3</strong> : 235B, 256K contexte, excellent en français et en raisonnement</p> </li> <li> <p><strong>GLM-5.1</strong> : 744B, MLA+DSA, 200K contexte, taillé pour l’agentique</p> </li> </ul> </div> <div class="paragraph"> <p>Tous disponibles sur Ollama. Tous open-source (licences permissives). Tous utilisables sans restriction via un abonnement à $20/mois.</p> </div> <div class="admonitionblock tip"> <table> <tr> <td class="icon"> <i class="fa icon-tip" title="💡"></i> </td> <td class="content"> <div class="paragraph"> <p>Avec Ollama Pro, vous avez accès à ~5 modèles « frontier » open-source pour le prix d’un seul modèle fermé (Claude Pro). La valeur est tellement asymétrique que ça en devient presque absurde.</p> </div> </td> </tr> </table> </div> </div> <div class="sect2"> <h3 id="_ce_que_ça_veut_dire_pour_le_hardware">Ce Que Ça Veut Dire pour le Hardware</h3> <div class="paragraph"> <p>Si le meilleur rapport qualité/prix est un abonnement cloud à $20/mois, le hardware local devient un choix de <strong>confort</strong> ou de <strong>principe</strong> — pas un choix économique.</p> </div> <div class="paragraph"> <p>Un DGX Spark à $4 699, c’est l’équivalent de :</p> </div> <div class="ulist"> <ul> <li> <p>235 mois d’Ollama Pro</p> </li> <li> <p>23 jeux AAA jour de sortie</p> </li> <li> <p>4 MacBook Air M4</p> </li> <li> <p>Un an de loyer d’un T2 à Lyon</p> </li> </ul> </div> <div class="paragraph"> <p>Pour du calcul. Lent.</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_et_huawei">Et Huawei ?</h2> <div class="sectionbody"> <div class="paragraph"> <p>Puisque la question m’a été posée pendant mes recherches : non, Huawei ne commercialise pas d’équivalent au DGX Spark.</p> </div> <div class="paragraph"> <p>Ce qui existe :</p> </div> <div class="ulist"> <ul> <li> <p><strong>Ascend 910C</strong> : 128 Go HBM, 800 TFLOPS FP16 — mais c’est une puce serveur, pas un desktop</p> </li> <li> <p><strong>Atlas 300I Duo</strong> : 96 Go LPDDR4X, carte PCIe à ~$1 400 — nécessite un hôte</p> </li> <li> <p><strong>Atlas 350</strong> : 112 Go HBM, 1.56 PFLOPS FP4 — accélérateur datacenter, pas un boîtier compact</p> </li> </ul> </div> <div class="paragraph"> <p>Huawei reste focalisé sur le marché des serveurs et des centres de données. Pour un boîtier compact « prêt à brancher » avec 120+ Go de VRAM, le DGX Spark (128 Go unifié) et le Mac Studio M3 Ultra (192 Go unifié) sont les seules options en 2026. Et pour l’instant, aucun constructeur chinois n’a annoncé de produit équivalent dans ce format.</p> </div> </div> </div> <div class="sect1"> <h2 id="_conclusion_le_luxe_de_la_proximité">Conclusion : Le Luxe de la Proximité</h2> <div class="sectionbody"> <div class="paragraph"> <p>Le DGX Spark n’est pas un mauvais produit. C’est un mauvais investissement pour 99% des acheteurs potentiels.</p> </div> <div id="diag-verdict" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center title Le Paysage IA en 2026 — Qui Domine ? left to right direction package "Usage Personnel / PME" #C8E6C9 { rectangle "🏆 Ollama Pro\n$20/mois" as pro rectangle "Ollama Free\n$0/mois" as free rectangle "Cloud GPU spot\n$1-3/h" as spot } package "Usage Intensif / Pro" #FFF9C4 { rectangle "🏆 Ollama Max\n$100/mois" as max rectangle "🏆 Cloud GPU dédié\n$2-4/h" as dedicated rectangle "Modal / Together AI\nServerless" as serverless } package "Air-Gap Obligatoire" #FFCDD2 { rectangle "DGX Spark\n$4 699" as spark rectangle "Mac Studio M3U\n~$5 000" as mac } note bottom of spark 1% des cas d'usage — défense, santé réglementée, secrets industriels critiques end note @enduml</pre> </div> </div> <div class="paragraph"> <p><em><em>_ Acheter un DGX Spark en 2026, c’est comme acheter un serveur mail en 2010 : techniquement possible, philosophiquement satisfaisant, économiquement absurde pour un individu. </em>_</em></p> </div> <div class="paragraph"> <p>Le calcul est simple, et il ne ment pas :</p> </div> <div class="ulist"> <ul> <li> <p><strong>$0</strong> pour chatter avec DeepSeek sur Ollama Free</p> </li> <li> <p><strong>$200/an</strong> pour bosser sérieusement avec Ollama Pro</p> </li> <li> <p><strong>$5-9</strong> pour un fine-tune ponctuel sur cloud GPU</p> </li> <li> <p><strong>$4 699</strong> pour…​ l’expérience d’avoir un boîtier NVIDIA sur son bureau ?</p> </li> </ul> </div> <div class="paragraph"> <p>Le marché a tranché. Les abonnements cloud et les modèles open-source chinois ont gagné la bataille du prix. Le hardware local survit dans les niches réglementaires, pas dans les bureaux des développeurs.</p> </div> <div class="paragraph"> <p><em><em>_ Le DGX Spark n’est pas un outil rentable. C’est un statement. « Je veux mon IA chez moi, pas dans le cloud de quelqu’un d’autre. » C’est respectable. Mais en 2026, quand Ollama te donne DeepSeek-V4-Pro dans le cloud pour $20/mois, c’est surtout un statement qui coûte très cher. </em>_</em></p> </div> <hr> <div class="paragraph"> <p><strong>Cet article est issu d’une conversation avec mon agent IA sur la pertinence économique du DGX Spark, croisée avec une veille marché sur les prix cloud GPU (Vast.ai, RunPod), les grilles tarifaires Ollama/Claude, et l’écosystème des modèles chinois open-source. Les prix cités sont ceux de mai 2026 — ils auront probablement encore baissé quand vous lirez ces lignes.</strong></p> </div> </div> </div> https://cheroliv.com/blog/2026/0118_matrice_gouvernance_llm_zone_acces_workspace_post.html Mon, 4 May 2026 00:00:00 +0000 blog/2026/0118_matrice_gouvernance_llm_zone_acces_workspace_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_問題プロンプトエンジニアリングは砂の城">問題：プロンプトエンジニアリングは砂の城</a></li> <li><a href="#_私の回答44の行列">私の回答：4×4の行列</a> <ul class="sectlevel2"> <li><a href="#_五つのゾーン空間的次元_rgpd">五つのゾーン（空間的次元 — RGPD）</a></li> <li><a href="#_認識論的分類第二次元">認識論的分類（第二次元）</a></li> </ul> </li> <li><a href="#_llmはこの行列をどのように消費するか">LLMはこの行列をどのように消費するか</a></li> <li><a href="#_実装_型付き_gradle_タスク">実装 : 型付き Gradle タスク</a></li> <li><a href="#_なぜこれがマニフェストで単なるスペックではないのか">なぜこれがマニフェストで、単なるスペックではないのか</a></li> <li><a href="#_完全なカスケード_ブレインダンプからブログ記事へ">完全なカスケード — ブレインダンプからブログ記事へ</a></li> <li><a href="#_賛成反対">�賛成/反対</a></li> <li><a href="#_結論_ファイルを整理しプロンプトは整理しない">結論 : ファイルを整理し、プロンプトは整理しない</a></li> <li><a href="#_参照">参照</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 14 minutes</div> <p>何ヶ月も、エージェントのガバナンスルールを積み重ねてきました。ファイル EAGER、LAZYなチェックリスト、6段階のセッション終了プロトコル。 しかし、未解決の質問が残っていた：<strong>LLMは何を知っているのか</strong> ファイルに対して何をすることができる権利がある？*</p> </div> <div class="paragraph"> <p>回答はプロンプトにありません。 それはファイルシステムにあります。</p> </div> <div class="paragraph"> <p>これが回答を利用可能にするアーキテクチャ仕様 — la <strong>LLMガバナンスマトリクス</strong>。</p> </div> </div> </div> <div class="sect1"> <h2 id="_問題プロンプトエンジニアリングは砂の城">問題：プロンプトエンジニアリングは砂の城</h2> <div class="sectionbody"> <div class="paragraph"> <p>ファイルをLLMに与えるとき、私たちはすべてを与える。コンテンツ、はい — さらに、セーフガードが欠如していることも。LLM はこのファイルに何が含まれているかわからない 秘密、憶測の意見、またはクローズドソースのコードです。それをインデックスします。 要約し、引用し、他のデータと混ぜ合わせ — そして潜在的に 公開のエンベディングまたはユーザーのレスポンスに掲載する。</p> </div> <div class="paragraph"> <p>クラシックなもの、つまりプロンプトです：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">"Tu es un assistant sécurisé. Ne divulgue jamais d'informations confidentielles. Si tu détectes un secret, ignore-le. Si tu détectes une opinion, ne la répète pas."</code></pre> </div> </div> <div class="paragraph"> <p>このプロンプトには3つの問題があります：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>LLMの善意に依存している。</strong> 十分に大きいモデルで</p> </li> </ol> </div> <div class="paragraph"> <p>複雑なバグを解決することは、命令を回避するのに十分大きい 200kトークンのコンテキストに埋もれたセキュリティ</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>それは文脈依存であり、構造的ではありません。プロンプトを変えて、LLMを変えて</p> </li> </ol> </div> <div class="paragraph"> <p>セッションを変更する — そしてルールが消える。</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>それはスケールしない。* 新しいファイルタイプごとに、新しいレベルごとに</p> </li> </ol> </div> <div class="paragraph"> <p>機密保持には新しい条項が必要です。あなたのプロンプトは 誰も全てを読まない規制テキスト</p> </div> <div class="admonitionblock caution"> <table> <tr> <td class="icon"> <i class="fa icon-caution" title="🔒"></i> </td> <td class="content"> <div class="paragraph"> <p>システムのセキュリティは、決して、私たちが命令に依存してはならない 忘れたり、回避したり、あるいは読み込まないこともあります。彼女は何かに依存しなければなりません。 明示的に望まない限り越えられない障壁</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_私の回答44の行列">私の回答：4×4の行列</h2> <div class="sectionbody"> <div class="paragraph"> <p>私がワークスペースで実装したソリューションは、<strong>ゾーン × マトリックス</strong> LLMへのアクセス権**. 彼女はLLMに慎重であることを求めない。彼女は 構造的に不可能な軽率さ</p> </div> <div id="diag-matrix-overview" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center skinparam wrapWidth 220 title LLMガバナンスマトリックス — ゾーン × アクセス権 package "ワークスペース" { rectangle "根 (円 0) ━━━━━━ Brain dump 自由思考 [LLM禁止]" as Z0 #FFB3B3 rectangle "configuration/ (円 1) ━━━━━━ シークレット, トークン プライベートインフラ [禁止 LLM]" as Z1 #FFB3B3 rectangle "office/ (サークル 2) ━━━━━━ 編集データ 記事、構図 [フィルタード Vision]" as Z2 #FFF3B3 rectangle "foundry/private/ (サークル 3) ━━━━━━ クローズドソースコード [データセット プライベート]" as Z3 #B3D9FF rectangle "foundry/public/ (サークル 3) ━━━━━━ オープンソースコード Apache 2.0 [フリーアクセス]" as Z4 #B3FFB3 } Z0 -[hidden]-> Z1 Z1 -[hidden]-> Z2 Z2 -[hidden]-> Z3 Z3 -[hidden]-> Z4 @enduml</pre> </div> </div> <div class="sect2"> <h3 id="_五つのゾーン空間的次元_rgpd">五つのゾーン（空間的次元 — RGPD）</h3> <div class="paragraph"> <p>ワークスペースの各ゾーンには、ファイルを置くことができる場所を決定するGDPRレベルがあります。 ルーティングされる：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1666%;"> <col style="width: 4.1682%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">�ゾーン</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">RGPDレベル</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">内容</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">公共のRAGアクセス権</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">根</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">0 — 親密</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ブレインダンプ、LLM との会話</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>禁止</strong>— 決してインデックスされない</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>configuration/</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">1 — 制限された所有者</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">シークレット, トークン, APIキー</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>禁止</strong>— 決してインデックスされない</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>office/</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">2 — 制限された協働</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">編集データ, フレーミング, 研修</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>フィルタリングされた</strong>視覚のみ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>foundry/private/</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">3 — 条件付きオープン</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">クローズドソースのコード、非公開のSaaS</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>禁止</strong>— 専用のプライベートデータセット</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>foundry/public/</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">4 — ネイティブなオーディエンス</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Apache 2.0コード、公開されたプラグイン</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>自由</strong>— 完全インデックス</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>ルールはシンプルです : <strong>ファイルのパスがLLMがそれにできることを決定します。</strong> メタデータを維持する必要はなく、フロントマターにタグを追加する必要もありません, 各コミットで手動分類は行われません。ファイルは`OSS/<code>? それは公開されています。それは中に`configuration/</code>? それは触れられない。</p> </div> </div> <div class="sect2"> <h3 id="_認識論的分類第二次元">認識論的分類（第二次元）</h3> <div class="paragraph"> <p>空間的次元は*どこ*へルートするかを示す。しかし、もう一つの軸があり、それが垂直である： <strong><code>quoi</code></strong> ルータ。認可されたゾーン内の一部のファイルには情報が含まれています そのまま薄めてはいけない：</p> </div> <div id="diag-epistemic-filter" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center skinparam wrapWidth 240 title ダブルカスケード — 空間フィルター + 認識フィルター start :Le LLM rencontre un fichier; if (Zone physique ?) then (Cercle 0-1) :ACCÈS BLOQUÉ\n(secret, brain dump); stop elseif (Zone CSS/) :DROIT D'ACCÈS PRIVÉ\n→ dataset fine-tuning; :Filtre épistémique\nVision/Opinion; if (Classification ?) then (VISION) :Dataset privé\n→ entraînement autorisé; else (OPINION) :CONFINÉ\n→ pas d'entraînement; endif elseif (Zone office/) :DROIT D'ACCÈS FILTRÉ\n→ accès conditionnel; :Filtre épistémique\nVision/Opinion/Stratégie; if (Classification ?) then (VISION) :DILUTION COMPLÈTE\n→ docs racine + blog; elseif (STRATÉGIE) :DILUTION RESTREINTE\n→ docs racine seulement; else (OPINION) :CONFINEMENT\n→ office/ uniquement; endif else (Zone OSS/) :ACCÈS LIBRE\n→ indexation complète; endif stop @enduml</pre> </div> </div> <div class="paragraph"> <p>エピステミックな分類グリッド、私の統治の規則2bisに刻まれた エージェント :</p> </div> <div class="paragraph"> <p>| ステータス | 定義 | LLM シグナル | 宛先 | | VISION | 安定したアーキテクチャ、テスト済みのパターン | 宣言型言語、セッション/テスト参照 | 完全希釈 + ブログ | | 戦略 | ビジネスポジショニング、価格設定 | 市場用語、競争 | ルートドキュメントのみ | | OPINION | 推測、未検証の仮説 | 仮説的な言語、直感 | 隔離 円0 |</p> </div> <div class="paragraph"> <p>2つの次元 — 物理的領域 × 認識論的分類 — の組み合わせ 形作る<strong>完全なマトリックス</strong>:</p> </div> <div id="diag-full-matrix" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE title 完全なマトリックス — ゾーン × 分類 salt { {T + Zone | VISION | STRATÉGIE | OPINION + Racine (0) | ✗ Interdit | ✗ Interdit | ✗ Interdit + configuration/ (1) | ✗ Interdit | ✗ Interdit | ✗ Interdit + office/ (2) | ✓ Docs + Blog | ✓ Docs seulement | ✗ Confiné + CSS/ (3) | ✓ Dataset privé | ✓ Dataset privé | ✗ Confiné + OSS/ (4) | ✓ Public libre | ✓ Public libre | ✓ Public libre } } @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_llmはこの行列をどのように消費するか">LLMはこの行列をどのように消費するか</h2> <div class="sectionbody"> <div class="paragraph"> <p>マトリックスはLLMが読むドキュメントではありません。これは<strong>制約 </strong>暗黙的に** エンコードされた コンテキストの 複合ベクトル (EPIC 9 — 進行中 実装).</p> </div> <div class="paragraph"> <p>LLMが各セッションで受け取るもの：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">VECTEUR COMPOSITE DE CONTEXTE ├── RAG pgvector → OSS/ + office/Vision │ (similarité sémantique sur contenu publiable) ├── Knowledge Graph graphify → OSS/ │ (relations exactes entre artéfacts publics) ├── Knowledge Graph privé → CSS/ │ (relations entre code closed source — jamais exporté) ├── Métadonnées de zone → chaque fichier taggé par zone physique │ (le LLM sait s'il est dans office/ ou OSS/) └── Historique des décisions → WORKSPACE_VISION.adoc (contexte temporel des arbitrages)</code></pre> </div> </div> <div class="paragraph"> <p>具体的には、LLMが私にこう言うとき：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">Je vais indexer le contenu de edster/ pour enrichir le knowledge graph...</code></pre> </div> </div> <div class="paragraph"> <p>ゾーンメタデータは、LLM が文を終える前に応答する : <code>edster/`である`CSS/</code>, レベル 3 →<strong>パブリックな knowledge graph へのアクセスは禁止されています。</strong> RAGはそれを見つけません。グラフはそれに触れません。ユーザーの回答は それを引用していません。</p> </div> <div class="admonitionblock tip"> <table> <tr> <td class="icon"> <i class="fa icon-tip" title="💡"></i> </td> <td class="content"> <div class="paragraph"> <p>空間オントロジーは～のように機能する<strong>Unixのパーミッション</strong>LLM用の。 プロセスに慎重であるように求めません`/etc/shadow`— その人に読み取りアクセスを拒否します。同じ原則です。</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_実装_型付き_gradle_タスク">実装 : 型付き Gradle タスク</h2> <div class="sectionbody"> <div class="paragraph"> <p>行列は哲学ではない。これはコードです。タスクの契約はこちらです。 Gradle がそれを実装 :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">abstract class ZoneAwareIndexer @Inject constructor( private val rootDir: DirectoryProperty, private val configServer: ConfigServerProperty // → configuration/ ) : DefaultTask() { @Input val zoneFilter: SetProperty<Zone> = project.objects.setProperty(Zone::class.java) @OutputFile val ragIndex: RegularFileProperty = project.objects.fileProperty() @TaskAction fun index() { val allowedPaths = zoneFilter.get().flatMap { it.resolve(rootDir.get()) } val forbiddenPaths = Zone.RESTRICTED.resolve(rootDir.get()) + Zone.INTIMATE.resolve(rootDir.get()) // Le RAG ne voit jamais configuration/ ni la racine // CSS/ alimente un index privé, pas celui-ci // office/ est filtré par le classifieur Vision/Opinion } } enum class Zone { INTIMATE, // Cercle 0 — racine RESTRICTED, // Cercle 1 — configuration/ EDITORIAL, // Cercle 2 — office/ CLOSED_SOURCE, // Cercle 3 — foundry/private/ OPEN_SOURCE // Cercle 3 — foundry/public/ }</code></pre> </div> </div> <div class="paragraph"> <p>タスクは <strong>テスト可能</strong>。あなたは、確認するテストを書くことができます:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `le RAG n'indexe jamais configuration`() { val index = ZoneAwareIndexer(rootDir, configServer) index.zoneFilter.set(setOf(Zone.OPEN_SOURCE, Zone.EDITORIAL)) index.index() assertThat(index.ragIndex).doesNotContain("configuration/") } @Test fun `le code closed source est exclu du RAG public`() { val index = ZoneAwareIndexer(rootDir, configServer) index.zoneFilter.set(setOf(Zone.OPEN_SOURCE)) // OSS only assertThat(index.ragIndex).doesNotContain("edster") }</code></pre> </div> </div> <div class="paragraph"> <p>380 tests, 380 PASS. plantuml-gradleと同様に、セキュリティはテストされています 期待されていなかった。</p> </div> </div> </div> <div class="sect1"> <h2 id="_なぜこれがマニフェストで単なるスペックではないのか">なぜこれがマニフェストで、単なるスペックではないのか</h2> <div class="sectionbody"> <div class="paragraph"> <p>このドキュメントはアーキテクチャ仕様であり、それが定義するためです：</p> </div> <div class="ulist"> <ul> <li> <p>いくつかの<strong>サイズ</strong>(空間的, 認識的)</p> </li> <li> <p>いくつかの<strong>決定論的なルール</strong>(ゾーン → アクセス権)</p> </li> <li> <p>Un <strong>タスク契約</strong>(型付きGradle、テスト可能)</p> </li> <li> <p>一つ<strong>参照実装</strong>( 私のワークスペース )</p> </li> </ul> </div> <div class="paragraph"> <p>でもそれはまた一つ<strong>マニフェスト</strong>なぜなら彼は議論に立場を取るから より大きい : <strong>LLMのデータへのアクセスをどのように管理するか？</strong></p> </div> <div class="paragraph"> <p>業界の答えは、プロンプトエンジニアリング + ガードレールです<br> ポストホックな分類器。私の回答は：<strong>ファイルを整理する</strong> 良いフォルダー。** 残りは自動的です。</p> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="❗"></i> </td> <td class="content"> <div class="paragraph"> <p>このマニフェストは「LLMは整合されるべきだ」とは言わない。それは「整合」と言う。 LLM が あなたの セキュリティ ルール に 対する こと は 、 あなた の システム の 結果 で あ る ファイル、あなたのプロンプトではありません。</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_完全なカスケード_ブレインダンプからブログ記事へ">完全なカスケード — ブレインダンプからブログ記事へ</h2> <div class="sectionbody"> <div class="paragraph"> <p>フルサイクルを示すために、このマトリックスのアイデアがどのように生まれたかをご紹介します そして希釈された：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">Session 4 mai 2026 — Feedback global du workspace │ ├→ Le LLM identifie : "la dualité public/privé est invisible" │ → Classifié VISION (constat architectural vérifiable) │ ├→ PICTURE_ME_ROLLIN_MATRICE_4X4.adoc — STIMULUS (Cercle 0) │ → Brain dump structuré, classification VISION confirmée │ ├→ DILUTION → WORKSPACE_AS_PRODUCT.adoc (section Matrice 4×4) │ → La spec vit dans les documents racine │ ├→ DILUTION → WORKSPACE_ORGANIZATION.adoc (OSS/CSS) │ → La granularisation est documentée │ └→ ARTICLE 0117 (ce document) → cheroliv.com → La VISION est publiée</code></pre> </div> </div> <div class="paragraph"> <p>これはセッション中の観察として始まった ("hé, le RAG ne sait pas 「edster がクローズドソースである」ということがアーキテクチャの仕様になった。 1セッション未満で公開されました。これが STIMULUS パターンが動いている様子です。</p> </div> </div> </div> <div class="sect1"> <h2 id="_賛成反対">�賛成/反対</h2> <div class="sectionbody"> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 50%;"> <col style="width: 50%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">このアプローチ (空間オントロジー + マトリクス)</th> <th class="tableblock halign-left valign-top">クラシックアプローチ（プロンプト＋ガードレール）</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>メカニクス</strong> — ファイルシステムがアクセスをブロックし、LLMではありません</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Déclarative</strong> — プロンプトは LLM に慎重であるよう求める</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Testable</strong> — Gradleタスクの契約は380+テストで検証されています</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>テスト不能</strong> — "LLMはルールを守ったか？" はオープンな質問です</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>LLMに依存しない</strong> — モデルを変更し、フォルダはそのまま</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>LLMに依存している</strong> — 各モデルはプロンプトを異なるように解釈する</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>スケーラブル</strong> — 新しいデータ型 = 新しいフォルダー, コード変更なし</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>非スケーラブル</strong> — 新しいデータ型 = 新しいプロンプト句, 新しい回帰リスク</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>監査可能</strong> — ファイルシステムは監査証跡です</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>監査不能</strong> — プロンプトには履歴がなく、差分もなく、責任もない</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Contrainte</strong> : 初期の組織的な規律が必要です</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Contrainte</strong> : プロンプトの作成における規律を毎回のセッションで求める</p></td> </tr> </tbody> </table> </div> </div> <div class="sect1"> <h2 id="_結論_ファイルを整理しプロンプトは整理しない">結論 : ファイルを整理し、プロンプトは整理しない</h2> <div class="sectionbody"> <div class="paragraph"> <p>私が説明したLLMガバナンスマトリックスは製品ではありません。 これは<strong>アーキテクチャ仕様</strong>— そしてそれが理由で彼女は 公開可能な。</p> </div> <div class="paragraph"> <p>それを頑健にしているのは、LLMに何も求めないからです。彼女は 彼に 信じない。彼女は自分の整合性と理解に頼っていない。 フランス語、あるいはその善意。ファイルシステムに基づいています — 最も低く、最も安定し、最もテストされた、スタック全体の層。</p> </div> <div class="paragraph"> <p>私が私のLLMに「全部インデックスできる」と言うとき`OSS/<code>, 何も `configuration/</code>, et <code>office/</code>「ビジョン」と分類されている場合のみ" — これは指示ではありません。これは*フィルター*— Kotlinで実装されています 380のテストで検証済み、LLMがデータを見る前に実行。</p> </div> <div class="paragraph"> <p>これは、誰かに「この引き出しを見ないで」と言うことの違いです。 そして、鍵付き引き出しを閉じる。私が構築してきたエージェントガバナンスは 数か月が鍵です。マトリックスは家具の設計図です。</p> </div> </div> </div> <div class="sect1"> <h2 id="_参照">参照</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="0116_compartimentage_epistemique_automatise_llm_post.html">Article 0116 — 自動化された認識論的区画</a></p> </li> <li> <p><a href="0114_gouvernance_cercles_confiance_ontologie_spatiale_alignement_llm_post.html">Article 0114 — 信頼の円と空間オントロジー</a></p> </li> <li> <p><a href="0108_gouvernance_agent_opencode_eager_lazy_post.html">Article 0108 — AsciiDocでAIエージェントを管理する</a></p> </li> <li> <p><a href="../2026/0115_anonymiseur_dataset_mvp0_realite_augmentee_llm_post.html">記事 0115 — 匿名化ツール MVP0</a></p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2026/0117_granularisation_oss_css_repositorie_workspace_post.html Sun, 3 May 2026 00:00:00 +0000 blog/2026/0117_granularisation_oss_css_repositorie_workspace_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_起きるべくして起きた事故">起きるべくして起きた事故</a> <ul class="sectlevel2"> <li><a href="#_真の質問">真の質問</a></li> </ul> </li> <li><a href="#_ソリューション_ossおよび_css">ソリューション : OSS/および CSS/</a></li> <li><a href="#_なぜ_oss_と_css_でpublic_と_private_でないのか">なぜ "OSS" と "CSS" で、"Public" と "Private" でないのか。</a> <ul class="sectlevel2"> <li><a href="#_完全な木_四つのゾーン三つではない">完全な木 — 四つのゾーン、三つではない</a></li> </ul> </li> <li><a href="#_特別なケースcheroliv_com">特別なケース：cheroliv.com</a> <ul class="sectlevel2"> <li><a href="#_構わない">構わない</a></li> </ul> </li> <li><a href="#_ガバナンスエージェントへの影響">ガバナンスエージェントへの影響</a></li> <li><a href="#_私たちが得るもの_そして失うもの">私たちが得るもの （そして失うもの）</a></li> <li><a href="#_結論_物理信号はソフトウェア信号に勝る">結論 : 物理信号はソフトウェア信号に勝る</a></li> <li><a href="#_参照">参照</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 10 minutes</div> <p><code>foundry/</code>— 私のワークスペースのコードをホストする機能領域 — 18のプロジェクトが含まれています。 8つはApache 2.0ライセンスのオープンソースです。 ただ1つだけは closed source — SaaS Edster。数か月間、これらの9つのプロジェクトは共存していた 同じフォルダー内にあり、…​ 以外に何も区切られていない。それらの公開/非公開ステータス それは私の頭の中の情報で、ファイルシステムにはありませんでした。</p> </div> <div class="paragraph"> <p>それから、RAGを接続したくなった。そこで、すべてが崩れた。</p> </div> </div> </div> <div class="sect1"> <h2 id="_起きるべくして起きた事故">起きるべくして起きた事故</h2> <div class="sectionbody"> <div class="paragraph"> <p>2026年4月、slider-gradle用のpgvector RAGの実装を開始しました。 原則：すべてのリポジトリをインデックス化する`foundry/<code>,生産する embeddings, そしてそれらをLLMのコンテキストに注入して、それを持たせるために ファイルの"認識`foundry/</code>。</p> </div> <div class="paragraph"> <p>パイプラインはシンプルでした：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val repos = fileTree(rootDir) { include("**/*.adoc", "**/*.kts", "**/*.kt", "**/*.json", "**/*.yml") } val chunks = repos.map { chunk(it) } val embeddings = chunks.map { embed(it) } pgvector.insert(embeddings)</code></pre> </div> </div> <div class="paragraph"> <p>シンプル。効果的。そして<strong>危険な</strong>。</p> </div> <div class="paragraph"> <p>なぜならこれ`fileTree`区別しない`plantuml-gradle/` (Apache 2.0, public) と`edster/`(closed source, private). 全部飲み込む。 もし私がいつかこれらの埋め込みを公開したら — ダッシュボード上、または回答の中に LLM、トレーニングデータセット — Edsterの独自コードが漏洩しています。</p> </div> <div class="admonitionblock caution"> <table> <tr> <td class="icon"> <i class="fa icon-caution" title="🔒"></i> </td> <td class="content"> <div class="paragraph"> <p>問題は、LLMがクローズドソースのコードを読むことではない。問題は、 それは、このコードが公開ベクトル埋め込みに終わること — 不可逆、削除不能、監査不能</p> </div> </td> </tr> </table> </div> <div class="sect2"> <h3 id="_真の質問">真の質問</h3> <div class="paragraph"> <p>それは「LLMがコードを漏らさないようにするにはどうすればいいですか？」ではない。それは「どうやって」だ 逃げを構造的に不可能にする？</p> </div> <div class="paragraph"> <p>答えはプロンプトではありません。答えは、フォルダーを二つに分けることです。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ソリューション_ossおよび_css">ソリューション : OSS/および CSS/</h2> <div class="sectionbody"> <div class="paragraph"> <p>前：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">foundry/ ├── plantuml-gradle/ ← public ├── bakery-gradle/ ← public ├── magic-stick/ ← public ├── edster/ ← PRIVÉ ├── slider-gradle/ ← public └── ... ← mélange invisible</code></pre> </div> </div> <div class="paragraph"> <p>後：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">foundry/ ├── OSS/ ← tout est Apache 2.0 │ ├── plantuml-gradle/ │ ├── bakery-gradle/ │ ├── magic-stick/ │ ├── slider-gradle/ │ └── ... └── CSS/ ← tout est closed source / private └── edster/</code></pre> </div> </div> <div class="paragraph"> <p>Le `fileTree`になります :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val ossRepos = fileTree(File(rootDir, "OSS")) { include("**/*.adoc", "**/*.kts", "**/*.kt", "**/*.json", "**/*.yml") } val cssRepos = fileTree(File(rootDir, "CSS")) { include("**/*.adoc", "**/*.kts", "**/*.kt", "**/*.json", "**/*.yml") } // Embeddings publics — OSS seulement pgvectorPublic.insert(ossRepos.map { chunk(it) }.map { embed(it) }) // Dataset fine-tuning privé — CSS seulement fineTuningDataset.insert(cssRepos.map { chunk(it) }) // jamais publié</code></pre> </div> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="❗"></i> </td> <td class="content"> <div class="paragraph"> <p>公共のRAGは決して見ない`CSS/`. クローズドソースのコードはデータセットを供給する ファインチューニングされていない — 私の家から決して出ない内部モデル。La 分離は機械的で、宣言的ではない。</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_なぜ_oss_と_css_でpublic_と_private_でないのか">なぜ "OSS" と "CSS" で、"Public" と "Private" でないのか。</h2> <div class="sectionbody"> <div class="paragraph"> <p>OSS（オープンソースソフトウェア）およびCSS（クローズドソースソフトウェア）の略称の選択 熟慮された：</p> </div> <div class="ulist"> <ul> <li> <p>Public"/"Private" 説明します<strong>視認性</strong>(GitHubが見ているもの)</p> </li> <li> <p>OSS"/"CSS"は…​を説明する<strong>自然</strong>コード (LLMが知っておくべきこと)</p> </li> </ul> </div> <div class="paragraph"> <p>GitHubの可視性はリモートリポジトリのメタデータです。 コードの性質は コンテンツのプロパティです。LLM は GitHub API へのアクセスがありませんが、アクセスがあります。 ファイルシステムに。<code>CSS/</code>「注意、このコードはライセンスで保護されていません。」 libre" 読む必要なく`LICENSE`またはパースする`package.json`.</p> </div> <div class="admonitionblock tip"> <table> <tr> <td class="icon"> <i class="fa icon-tip" title="💡"></i> </td> <td class="content"> <div class="paragraph"> <p>フォルダーの名前は、あなたが与えることができる最も堅牢なメタデータに LLM. 彼女は誤ってパースされたり、無視されたり、誤って解釈されたりすることはできません。このLLM 見る`CSS/edster/`ファイルのパスの中 — 彼は知っている。</p> </div> </td> </tr> </table> </div> <div class="sect2"> <h3 id="_完全な木_四つのゾーン三つではない">完全な木 — 四つのゾーン、三つではない</h3> <div class="paragraph"> <p>OSS/CSSの細分化は3領域オントロジーを完成させます。領域 `foundry/`機能的サブゾーンが1から2に変更されます :</p> </div> <div id="diag-four-zone-workspace" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center skinparam wrapWidth 260 title ファウンドリー/ — OSS/CSSの細粒化 package "鋳造所/" { package "円0 — 根" #FFCCCC { rectangle "PICTURE_ME_ROLLIN_*.adoc" as STIM rectangle "WORKSPACE_*.adoc" as VISION_DOC note right of STIM Brain dump libre Jamais versionné [LLM : interdit d'indexer] end note } package "サークル 1 — 設定/" #FFD9CC { rectangle "秘密, トークン" as SECRETS rectangle "Spring Cloud Config" as SCC note right of SECRETS Privé-CVS, solo access [LLM : INTERDIT] end note } package "サークル 2 — オフィス/" #FFFFCC { rectangle "記事, フレーミング" as DATA rectangle "研修, SPG/SPD" as FORM note right of DATA Privé-CVS [LLM : filtré Vision/Opinion] end note } package "円 3 — foundry/" #CCE5FF { package "OSS/ — Apache 2.0" #CCFFCC { rectangle "Gradle プラグイン" as PLUGINS rectangle "エンジン" as ENGINE } package "CSS/ — クローズドソース" #CCDDFF { rectangle "edster/" as EDSTER } } } @enduml</pre> </div> </div> <div class="paragraph"> <p>| ゾーン | GDPR | パブリック RAG インデックス | データセット ファインチューニング | | ルート | レベル0 — 親密 | ✗ | ✗ | | <code>configuration/</code>| レベル 1 — 制限 | ✗ | ✗ | | <code>office/</code>| レベル 2 — コラボラティブ | ✓ フィルタ済み | ✓ フィルタ済み | | <code>foundry/private/</code>| レベル 3 — 条件付きオープン | ✗ | ✓ プライベート | | <code>foundry/public/</code>| レベル 4 — ネイティブ公開 | ✓ 無料 | ✓ 公開 |</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_特別なケースcheroliv_com">特別なケース：cheroliv.com</h2> <div class="sectionbody"> <div class="paragraph"> <p>私がそこにいた間に、別の矛盾も修正しました。私のサイト <code>cheroliv.com`に住んでいた`foundry/`ソフトウェアプロジェクトのように スタンドアロン — 独自のGradleビルド、独自のCI、独自の ガバナンス</code>.agents/`。</p> </div> <div class="paragraph"> <p>しかし、ブログ記事はコードではありません。これらは<strong>データ 社説</strong> Cercle 2 — フレーミングと同様に`office/pilotage/` または形成の`office/formations/`.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">AVANT APRÈS foundry/ office/ cheroliv.com/ sites/ site/jbake/content/blog/ cheroliv.com/ 2026/0117_....adoc 2026/0117_....adoc</code></pre> </div> </div> <div class="paragraph"> <p>変更点:</p> </div> <div class="ulist"> <ul> <li> <p>記事は`office/`→ Cercle 2のプライバシー</p> </li> <li> <p>タスク`publishSite`になる能力の`engine`</p> </li> </ul> </div> <div class="paragraph"> <p>経由`bakery-gradle`— プラグインは一つ受け取ります`FileTree`, 彼は知らない 記事がどこから来るか`office/`</p> </div> <div class="ulist"> <ul> <li> <p>単一のCI、単一のガバナンス — 重複ゼロ</p> </li> <li> <p>ビジョン/オピニオン・クラスファイア（規則2ビス）自動的に適用されます：</p> </li> </ul> </div> <div class="paragraph"> <p>記事の中の`office/`公開前にフィルタリングされます</p> </div> <div class="sect2"> <h3 id="_構わない">構わない</h3> <div class="paragraph"> <p>それが美しい。プラグイン`bakery-gradle`変更されていません。 AsciiDocコンテンツのディレクトリを受け取り、HTMLを生成し、プッシュする GitHub Pagesで。このディレクトリは`site/jbake/content/` ou <code>office/sites/cheroliv/</code>— プラグインは気にしない。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// engine/build.gradle.kts task("publishBlog") { doLast { val articles = fileTree("../../office/sites/cheroliv/2026/") bakery.generate(articles) // ← bakery ne sait pas d'où ça vient } }</code></pre> </div> </div> <div class="paragraph"> <p>インターフェイス契約は Gradle のタスクです。REST API ではありません。ウェブフックではありません。 タスク — タイプ指定され、テスト可能、ローカルおよび CI で実行可能。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ガバナンスエージェントへの影響">ガバナンスエージェントへの影響</h2> <div class="sectionbody"> <div class="paragraph"> <p>OSS/CSSの細粒度化は、エージェントガバナンスを3つのポイントで変更します：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>RAG public</strong> : インデックス範囲は`foundry/**`</p> </li> </ol> </div> <div class="paragraph"> <p>à <code>foundry/public/<strong></code>+<code>office/Vision/</strong></code>. クローズドソースのコード タスクの設定によってインデックスから除外されます。プロンプトによってではありません。</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>知識グラフ</strong> : graphify-gradle は2つのグラフを生成します :</p> </li> </ol> </div> <div class="paragraph"> <p>*<code>office/graph.json</code>(公開) — OSSアーティファクトとoffice/Visionの関係 *<code>configuration/graph_private.json</code>(gitignored, privé) — の間の関係 CSSのアーティファクト、未公開</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>データセットファインチューニング</strong> :`codebase-gradle`現在は2つのソースがあります：</p> </li> </ol> </div> <div class="paragraph"> <p>*<code>OSS/</code>→ パブリックデータセット (コミュニティモデル、ベンチマーク) *<code>CSS/</code>→ プライベートデータセット (内部モデル, 独自のファインチューニング)</p> </div> </div> </div> <div class="sect1"> <h2 id="_私たちが得るもの_そして失うもの">私たちが得るもの （そして失うもの）</h2> <div class="sectionbody"> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1436%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">前 (フラットフォルダー)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">(OSS/CSS + office/sites) 後</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>ls foundry/</code>→ 公私混合</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>ls foundry/public/</code>→ すべて公開可能</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">RAGは差別なくすべてをインデックスする</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">RAGはインデックスを作成します`OSS/`+`office/Vision`専ら</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">プロジェクトがオープンソースかどうか分からない</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">道`OSS/` ou `CSS/`いわゆる</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">cheroliv.com は独自の CI と独自のガバナンスを持っています</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">CI とガバナンスは engine で共有されています</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ブログの記事は「code」リポジトリにあります。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ブログ記事は`office/sites/`— データ、コードではない</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">クローズドソースコードがパブリックな埋め込みに漏洩するリスク</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">構造的に不可能 —`CSS/`RAG のスコープ外</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>唯一のコスト：一つ`git mv`17のOSSリポジトリに対するグローバル + のリファクター <code>build.gradle.kts</code> de <code>engine</code>. これはコールドマイグレーションです — データは飛行中に存在せず、影響を受けたユーザーもいません。</p> </div> </div> </div> <div class="sect1"> <h2 id="_結論_物理信号はソフトウェア信号に勝る">結論 : 物理信号はソフトウェア信号に勝る</h2> <div class="sectionbody"> <div class="paragraph"> <p>私がこの午後にしたことは、見えない慣習を置き換えること そのエリア内の目に見える分離によって`foundry/<code>. 以前、あなたは～なければならなかった 知っているが`edster/`クローズドソースでした。 今、あなたはそれを*見る* — フォルダーは呼ばれる`CSS/</code>。</p> </div> <div class="paragraph"> <p>これはUnixのパーミッション、ネットワークのVLAN、またはの同じ原理です データベース内の防火区画。セキュリティは 覚えておくべき情報でなければならず、それはプロパティでなければなりません。 <strong>物理</strong>システムの。</p> </div> <div class="paragraph"> <p>OSS/CSSの細分化は、この原理をその分野に適用したものです。 LLMのガバナンスについて。 LLMはEdsterが何であるかを知る必要はありません 機密です。 彼はそれをインデックス付けできない状態である必要があります。</p> </div> <div class="paragraph"> <p>それがまさにそれ`CSS/`保証する。</p> </div> </div> </div> <div class="sect1"> <h2 id="_参照">参照</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="0118_matrice_gouvernance_llm_zone_acces_workspace_post.html">条項0117 — LLMガバナンスマトリックス</a></p> </li> <li> <p><a href="0114_gouvernance_cercles_confiance_ontologie_spatiale_alignement_llm_post.html">記事 0114 — 信頼のサークル</a></p> </li> <li> <p><a href="0116_compartimentage_epistemique_automatise_llm_post.html">Article 0116 — 自動化された認識論的区画化</a></p> </li> <li> <p><a href="0108_gouvernance_agent_opencode_eager_lazy_post.html">記事 0108 — AsciiDocを使用したAIエージェントの管理</a></p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2026/0116_compartimentage_epistemique_automatise_llm_post.html Sat, 2 May 2026 00:00:00 +0000 blog/2026/0116_compartimentage_epistemique_automatise_llm_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_問題何も発表せずに自由に考える">問題：何も発表せずに自由に考える</a></li> <li><a href="#_stimulus_パターン_生まれる固定する薄める死ぬ">STIMULUS パターン — 生まれる、固定する、薄める、死ぬ</a></li> <li><a href="#_llmへの委任_なぜllmがフィルタリングするのか">LLMへの委任 : なぜLLMがフィルタリングするのか</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 10 minutes</div> <p>私のLLMはGradleタスクを実行するだけにとどまらない。それは私のプライベートな思考と公的な表現の間の境界の守護者である。各アイデアはルーティングされる前に、Vision、Opinion、Stratégieと分類される。これがどのようにして自動化された認識的コンパートメンタル化が私の精神的な庭を守り、私を黙らせずにいるかを示す。</p> </div> <div class="dlist"> <dl> <dt class="hdlist1">トック</dt> <dd> <p>[]</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_問題何も発表せずに自由に考える">問題：何も発表せずに自由に考える</h2> <div class="sectionbody"> <div class="paragraph"> <p>一人の開発者がLLMを使って思考プロセスをドキュメント化するとき、パラドックスにぶつかる：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">CAPTURE TOUT (Cercle 0, jardin secret) ├→ Brain dump libre, pas de censure ├→ Idées brutes, spéculations, intuitions non vérifiées ├→ Allers-retours LLM : challenger, itérer, raffiner └→ Le LLM voit TOUT — le bon, le flou, l'embryonnaire PUBLICATION SÉLECTIVE (Cercle 4, blog public) ├→ Uniquement les décisions actées ├→ Uniquement les patterns testés (>100 tests PASS) ├→ Uniquement ce qui a de la valeur pour le lecteur └→ JAMAIS une spéculation présentée comme une vérité</code></pre> </div> </div> <div class="paragraph"> <p>これらの二つの極端の間に、一つ<strong>フィルター</strong>. 質問は：誰がそれをするのか？疲れた人間（セッションの終わり）？ naïveな正規表現スクリプト？それとも、すでに全部読んでいるLLM自身か？</p> </div> <div class="paragraph"> <p>私の回答 : LLM。</p> </div> </div> </div> <div class="sect1"> <h2 id="_stimulus_パターン_生まれる固定する薄める死ぬ">STIMULUS パターン — 生まれる、固定する、薄める、死ぬ</h2> <div class="sectionbody"> <div class="paragraph"> <p>STIMULUS は ファイル です`.adoc`一時的なワークスペースのルート（Cercle 0）。その名前は印象的な命名規則に従っています —<code>PICTURE_ME_ROLLIN.adoc</code>, <code>HOLD_MY_BEER.adoc</code>, <code>ONCE_UPON_A_TIME.adoc</code>— その瞬間の探求的意図を捉える。</p> </div> <div class="paragraph"> <p>そのライフサイクルは容赦がない：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">CRÉATION (Cercle 0) ├→ Fichier vide, brain dump libre ├→ Allers-retours LLM ← → développeur └→ Aucune pression de structure ou de publication MATURATION ├→ Le contenu se densifie ├→ Des sections émergent naturellement └→ Le fichier devient une référence informelle de session CLASSIFICATION ÉPISTÉMIQUE ← FAIT PAR LE LLM ├→ VISION → publiable, diluer dans les docs publics + blog ├→ OPINION → confiner au Cercle 0, pas de dilution externe └→ STRATÉGIE → dilution restreinte (docs racine, PAS de blog) DILUTION (Cascade vers Cercles légitimes) ├→ VISION → WORKSPACE_AS_PRODUCT.adoc + WHAT_THE_GAMES.adoc + blog ├→ STRATÉGIE → WORKSPACE_AS_PRODUCT.adoc (section business) └→ OPINION → reste dans le stimulus, ne bouge pas ARCHIVAGE + SUPPRESSION ├→ Snapshot dans configuration/vision-archive/ (trace historique) └→ rm du stimulus — il a fini son travail</code></pre> </div> </div> <div class="paragraph"> <p>2回以上のセッションで希釈されずに生存する刺激は、アンチパターンです。情報が一時ファイルに保存されるほど重要である場合は（→ diluer）、あるいは情報が不明確で存在する価値がない場合は（→ supprimer）。</p> </div> </div> </div> <div class="sect1"> <h2 id="_llmへの委任_なぜllmがフィルタリングするのか">LLMへの委任 : なぜLLMがフィルタリングするのか</h2> <div class="sectionbody"> <div class="paragraph"> <p>KotlinでVision/Opinionの分類をハードコードしません。これを注入します<strong>システムプロンプト</strong>LLMを経由して`AGENT_GOVERNANCE.adoc`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">---- ---- Pour chaque dilution de stimulus ou session, tu es responsable de classifier le contenu : - VISION : décision architecturale actée, pattern testé en production (>100 tests PASS), décision documentée dans BACKLOG ou ROADMAP - OPINION : spéculation, hypothèse non validée par des tests, intuition sans ancrage expérimental - STRATEGIE : positionnement business, pricing, marché cible Règles : - Si OPINION, le contenu reste confiné dans son cercle d'origine - Si VISION, tu procèdes à la dilution dans les documents racine - Si STRATEGIE, dilution restreinte (docs racine, pas de blog public) - Cette classification détermine aussi si un article de blog est publiable sur cheroliv.com ---- LLMはこの指示を読む**前に**セッションを処理する。それはその直近のコンテキストにあり、別ファイルにはありません。これは *決定的プロンプトエンジニアリング* : 振る舞いは注入されたテキストから生じ、外部の分類器からではありません。 === なぜそれが機能するのか — そしてなぜそれが直感に反するのか 標準的な反応： 「AIに分類を任せるの？ もし間違えたらどうするの？」 回答 : 人間は午前2時にもっと良くなるわけではない。違いは、LLMはすべてを読むということだ。セッションと対象ドキュメントのコンテキストを完全に把握している。それは`VPS ECO-16 12€ HT`はインフラストラクチャーの決定 (VISION) である一方で`« le TTS ElevenLabs sonne plus naturel que Coqui »`ベンチマークで検証されていない意見です。 人間はセッションの終わりに斜め読みし、できるだけのことをする。LLMは網羅的に読み、体系的なグリッドを適用する。結果は**より信頼できる**、決して少なくない そして20％の曖昧なケースについては — つまりLLMでも躊躇する灰色の領域 — 答えは「コードを追加すること」ではありません。答えは**LangGraph4j**(EPIC 13) : あいまいなケースでは Human-in-the-Loop ノードを起動し、人間に判断を仰ぐ状態グラフ。ただし、80% の明確なケースでは LLM で十分。 == 完全なパイプ: ブレインダンプからブログ投稿まで ここに完全なフローがあります — 原始的なアイデアから公開された記事まで — LLMだけがフィルターとして機能しています： [source] ---- CERCLE 0 (jardin secret) PICTURE_ME_ROLLIN.adoc ← brain dump, allers-retours LLM ↓ [LLM classifie] → VISION / OPINION / STRATÉGIE ↓ VISION → dilution dans WORKSPACE_AS_PRODUCT.adoc → dilution dans WHAT_THE_GAMES_BEEN_MISSING.adoc → dilution dans WORKSPACE_VISION.adoc (session context) → RÉDACTION ARTICLE BLOG ← le LLM écrit, pas le dev ↓ CERCLE 4 (blog public) 0116_compartimentage_epistemique.adoc ← publié sur cheroliv.com ↓ ./gradlew deploy (bakery-gradle → JBake → JGit → GitHub Pages) ↓ https://cheroliv.com/blog/2026/0116/ ← live ---- 開発者は記事を書かない。彼は挑戦し、見直し、検証する。LLMが書く。ループは： 1. ブレインダンプ フリー → 検閲なし 2. LLMによる認識論的分類 → 漏洩なし 3. LLM による執筆 → 先延ばししない 4. 人間による校閲 → エラーなし 歴史的なボトルネック — 「書く時間がない」 — が解消されました。LLMが大半の仕事をこなす。人間がすることは、人間だけができること：判断する。 == 三つのルートドキュメント — 情報がその場所を見つける方法 各ターゲットドキュメントは希釈のカスケードにおいて正確な役割を果たします： [cols="1,3,2"] |=== |ドキュメント |受けるもの |コンテンツの種類 |`WORKSPACE_AS_PRODUCT.adoc` |アーキテクチャ上の意思決定, 技術スタック, ロードマップ, ビジネスモデル |ビジョン＋戦略 |`WHAT_THE_GAMES_BEEN_MISSING.adoc` |パターン、教訓、アンチパターン、オントロジー、形式的ルール |ビジョン (テスト済みのパターン) |`WORKSPACE_VISION.adoc` |セッションコンテキスト, 意思決定の履歴, インフラストラクチャポイント |ビジョン + 戦略 (コンテキスト) |`AGENT_GOVERNANCE.adoc` |ガバナンス規則, プロジェクトポートフォリオ, 手順 |ビジョン(ガバナンス) |**ブログ cheroliv.com** |公開記事、外部読者への価値 |VISIONのみ |=== 同じ刺激は4つのドキュメント + ブログに栄養を与えることができます — 各宛先は自分に関係する部分を受け取り、冗長も矛盾もありません。 それが起きたのは`PICTURE_ME_ROLLIN.adoc`(2026年5月3日): | 情報 | 分類 | 行き先 | | 13+個のファウンドリープロジェクトの在庫 foundry/ | VISION | WORKSPACE_AS_PRODUCT | | VPS-2 OVH, edster.cloud, 8.49€/月 | VISION | WORKSPACE_AS_PRODUCT + WORKSPACE_VISION | アフリカ市場はモバイルマネーに備えている » | 戦略 | WORKSPACE_AS_PRODUCT (section business) DeepSeek > Kimi > GLM 長いコンテキスト用 » | 意見 → ビジョン | 閉じ込められた後、ベンチマーク後に昇進 (記事 0112) | 合成従業員として最終製品 | 戦略 | WORKSPACE_AS_PRODUCT (ブログなし) | == ベビーステップパターン＋TestContainer＋生きているドキュメント ― 自己テストするコード STIMULUS/Dilution パターンは思考を管理します。コードにおけるその相当物は、plantuml-gradle によって検証された Baby-Step/TestContainer/Doc Vivante パターンです（380/380 テスト PASS、ドッカーレークがゼロの 137 セッション）： [cols="1,3"] |=== |原理 |ルール |**ベイビーステップ** |USあたり3ポイントを超えてはならない。USが恐ろしいと感じたら、分割する。通過する1ポイントのUS > 遅れる8ポイントのUS。 |**TestContainer まず** |ビジネスコードの前に、コンテナ。 インフラテストがパス → 安定した環境が保証される。 |**コミット済みデータセット** |最小限ながら代表的な部分集合である`src/test/resources/`, PIIなし. クローン可能、起動可能。 |**生きたドキュメンテーション** |各Cucumberテスト = 自然言語の文章。ソースコードが実行可能なスペックである。Markdownドキュメントを維持する必要はゼロ。 |**自動クリーンアップ** |リソース漏れゼロ。 孤児コンテナ,`/tmp/gradle-test-*`: すべてが掃除されました。 |=== このパターンが、plantuml-gradle が 138 セッションで Docker の回帰を一度も経験していない理由です。これは、PostgreSQL、Redis、Kafka などの外部インフラストラクチャと通信するコードが、常に本番と同一の環境でテストされることを保証します — バージョン管理され、再現可能で、1 コマンドで起動できます。 == 結論：出版を恐れずに考える自由 自動化された認識論的な区画化は検閲ツールではありません。それは**解放者**. これにより、自由に考え、フィルターなしで推測し、頭に浮かぶことを全部ブレインダンプすることができます — つまり、未熟なアイデアがブログに載ってしまうことを恐れずに済む。 LLMはこの境界の守護者だ。 すべてを読む。 分類する。 生き残るに値するものを薄める。 秘密にしておくべきものを閉じ込める。 公開に適したものを作成する。 そして開発者は、最後の言葉を保つ：読み返す、挑戦する、検証する。判断する。 それはソロ開発者に欠けていた仕事の分担だった：精神的な事務処理を担当する合成従業員で、人間が最も得意とすること―設計、アーキテクチャ、意思決定―に集中できるようにする。 == 参考文献 * エイガー/レイジー エージェントのガバナンスに関する記事：link:../2026/0108_gouvernance_agent_opencode_eager_lazy_post.html[AsciiDocでAIエージェントを管理] * 空間オントロジーと信頼の輪に関する記事：link:../2026/0114_gouvernance_cercles_confiance_ontologie_spatiale_alignement_llm_post.html[空間オントロジーとしてのアラインメントメカニズム] * MVP0 匿名化ツールに関する記事：link:../2026/0115_anonymiseur_dataset_mvp0_realite_augmentee_llm_post.html[最初に雇用した人：データセットの匿名化ツール] * 長いコンテキストのLLMの比較に関する記事：link:../2026/0112_comparaison_kimi_glm_deepseek_long_contexte_plugin_gradle_opencode_post.html[DeepSeek-V4-Pro, Kimi K2.6, GLM-5.1] * エージェントバックアップメカニズムに関する記事 :link:../2026/0110_mecanisme_backup_contexte_agent_post.html[スライドウィンドウと寒波] ----</code></pre> </div> </div> </div> </div> https://cheroliv.com/blog/pilot-batch/0115_anonymiseur_dataset_mvp0_realite_augmentee_llm_post.html Fri, 1 May 2026 00:00:00 +0000 blog/pilot-batch/0115_anonymiseur_dataset_mvp0_realite_augmentee_llm_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_みんなが逃げ出す問題">みんなが逃げ出す問題</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 12 minutes</div> <p>私はLLMを雇わない。私は匿名化の専門家を雇う。pgvectorを使ったRAGを行う前に、CDA/FPAの専門家をファインチューニングする前に、クライアントのワークスペースをプロビジョンする前に — 誰かがデータのトイレを掃除しなければならない。この従業員こそが、匿名化のエキスパート（codebase-gradleのMVP0、EPIC 2）だ。そして彼こそが製品を市場に適合させる人だ。</p> </div> <div class="dlist"> <dl> <dt class="hdlist1">チック</dt> <dd> <p>(empty)</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_みんなが逃げ出す問題">みんなが逃げ出す問題</h2> <div class="sectionbody"> <div class="paragraph"> <p>�訓練データを扱うAIスタートアップはすべて同じ壁にぶつかる：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">---- ---- Données brutes client (SPG, cours, évaluations) ├→ Noms de stagiaires en clair dans les PDF ├→ Emails dans les métadonnées JSON ├→ IP de connexion dans les logs pgvector ├→ Identifiants dans les nœuds Graphify └→ Références OF pilote dans les schémas SQL ---- 結果 : 汚いデータで RAG を行う（PII の幻覚、GDPR 違反、法的リスク）か、何もせず（製品なし）かのいずれかです。第三の道 — 手動でクリーニングする — はスケーラブルではありません。 私の答え : 問題を回避しない。L'**自動化する**。 == MVP0 : 匿名化ツール, 試用期間中に最初に雇用された MVP0は機能ではありません。それは**利便性の専門家**— ピッチデッキでは誰も語りたがらない、汚くて愚かで残酷な仕事をする従業員。 それが行うこと： [source] ---- ENTRÉE : Données brutes multi-sources ├→ AsciiDoc (SPG_A2SP.adoc) → noms, dates, OF pilote ├→ JSON (catalogue formations) → emails, téléphones ├→ YAML (config workspace) → tokens OAuth2 ├→ SQL (schémas DDL) → IP, adresses ├→ pgvector (métadonnées embeddings) → identifiants ├→ ONNX (outputs classification) → noms propres └→ Graphify (graph.json) → nœuds avec PII SORTIE : Datasets propres, format standardisé ├→ [ANONYMIZED] remplace les PII détectées ├→ Classification RGPD (niveau 0→4) ├→ Rapport d'audit (quoi a été nettoyé) └→ Dataset prêt pour RAG ET fine-tuning ---- 最初に最も明白なパターンを検出します (emails`.*@.*`, トークン`sk-*`, `ghp_*`, IPs), それから彼は学ぶ。試用期間、それがそれです：偽陰性を見逃さないことを確認してから、彼を正式に採用します。 == このMVPが解き放つもの ( そしてそれは単なるコンプライアンスではない ) MVP0としての匿名化は、高速道路に入る前のGDPRの通行料ではない。それが高速道路そのものだ。それが開くものは次のとおりだ： === 現在 : プロンプトにおける拡張現実 [source] ---- DONNÉES BRUTES CLIENT ↓ Anonymiseur MVP0 → datasets propres ↓ RAG pgvector (MVP1) → top-K documents similaires (filtrés, anonymisés) ↓ LLM (deepseek-v4-pro) → réponse augmentée, zéro PII ---- RAGは汚れたデータを検索しません — それはスペースを検索します**構成上きれい**. これは回答の品質を大きく変える：LLMは認識しているが言及してはならないPIIを回避することに時間を費やさない。 === 未来 : ファインチューニング on 健康なデータ [source] ---- MVP0 → datasets propres accumulés (session après session) ↓ Fine-tuning expert métier (CDA, FPA) sur données zéro PII ↓ Modèle fine-tuné exposé via Ollama (sans fuite de données) ---- ファインチューニングは生データでの潜在的な法的災害です。クリーンなデータでは、それは**再現可能な方法**. 各クライアントはクリーニング済みのデータセットを蓄積し、各クライアントは自分のビジネス専門家を自分のデータでファインチューニングできます — — 個人データを決して公開することはありません。 == なぜそれが販売可能なのか これはGDPRコンプライアンスツールではありません。これは**普遍的な問題を資産に変える再現可能な方法**: 1. *すべてのトレーニング企業は汚れたデータを持っている* — それが問題だ 2. *誰も自動化されたマルチソースクリーニングパイプラインを持っていない* — これは市場です 3. *匿名化 → RAG → ファインチューニングのループは独自である* — それが障壁だ Edster SaaS (MVP3)は« Gradleワークスペース »を販売しません。それはこの閉じたループを販売します。そしてMVP0は入口です。 == SQL形式はコンテキストの第三の方法 構造化データのインポートは単なる交換形式ではない。SQL スキーマ (DDL) は持ちます**ドメインのエンティティ-リレーションモデル**： [source] ---- CREATE TABLE formation ( id UUID PRIMARY KEY, titre VARCHAR NOT NULL, referentiel RNCP REFERENCES rncp(id), organisme OF REFERENCES of_pilote(id) -- ← va être anonymisé ); ---- このDDLは、匿名化された後（行4）、LLMのコンテキストソースとなります。テキストではなく — du**ビジネスモデル**. RAGはベクトル類似性によるコンテンツを提供し、Graphifyは正確な構造による関係を提供し、SQLスキーマは**暗黙の Domain-Driven Design**: bounded contexts, agrégats, value objects. LLMはスキーマを読むことでドメインを理解します。 == ロードマップ：MVP0からSaaSまで [source] ---- MVP0 — Anonymiseur (ce que cet article décrit) Sortie : datasets propres, reproductible MVP1 — RAG pgvector (dépend de MVP0) Realité augmentée en prompt sur données nettoyées MVP2 — Graphify + ONNX + SQL DDD (dépend de MVP1) Vecteur composite de contexte (règles + similarité + relations exactes) MVP3 — SaaS Edster (dépend de MVP0-2) Provisionnement workspace client complet ---- 各MVPは前のMVPに依存しています。MVP0がなければ、どのMVPもリリースできません。これがバックログにおいて「Anonymiseur」が「P0」ではない理由です — それは**MVP0**. これは最初の商業的な納品物であり、その他すべてはそれが成功することを条件としている。 == 結論：目に見えない仕事がすべてを可能にする 一般的なスタートアップでは、データのクレンジングはアウトソーシング、手動、または無視されます。このアーキテクチャでは、それは**製品の中心**. 匿名化者は最初に雇用される従業員です。なぜなら彼/彼女がいなければ、何も機能しないからです： * MVP0 なし → 法的な RAG なし (MVP1) * MVP0 がなければ → データ漏洩のないファインチューニングもできない (EPIC 5) * MVP0 なし → 信頼できる SaaS なし (MVP3) * MVP0がなければ → プロンプトに拡張現実がない * MVP0 なし → コンテキストの第三の方法なし (SQL DDD) 彼は汚い仕事をしている。彼は決してピッチでは言及されない。だが、彼こそが工場を回している。 それが彼/彼女を最初に雇う理由です。 == 参考文献 * 空間オントロジーと信頼の輪に関する記事：link:../2026/0114_gouvernance_cercles_confiance_ontologie_spatiale_alignement_llm_post.html[空間オントロジーをアラインメントメカニズムとして] * Eager/Lazyエージェントのガバナンスについての記事:link:../2026/0108_gouvernance_agent_opencode_eager_lazy_post.html[AsciiDocでAIエージェントを管理する] * Hot/Warm/Cold メカニズムの記事:link:../2026/0110_mecanisme_backup_contexte_agent_post.html[スライドウィンドウと寒波] * 3つのLLMの比較に関する記事 :link:../2026/0112_comparaison_kimi_glm_deepseek_long_contexte_plugin_gradle_opencode_post.html[DeepSeek-V4-Pro、Kimi K2.6、GLM-5.1] ----</code></pre> </div> </div> </div> </div> https://cheroliv.com/blog/2026/0115_anonymiseur_dataset_mvp0_realite_augmentee_llm_post.html Fri, 1 May 2026 00:00:00 +0000 blog/2026/0115_anonymiseur_dataset_mvp0_realite_augmentee_llm_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_誰もが逃げ出す問題">誰もが逃げ出す問題</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読書時間 : 12 minutes</div> <p>私はLLMを雇いません。匿名化者を雇います。pgvectorを使ったRAGの前に、CDA/FPAの専門家をファインチューニングする前に、クライアントのワークスペースをプロビジョニングする前に — だれかがデータのトイレを掃除しなければなりません。その従業員こそが匿名化の専門家（MVP0、EPIC 2、コードベース Gradle）です。そして彼が製品を市場向きにします。</p> </div> <div class="dlist"> <dl> <dt class="hdlist1">トック</dt> <dd> <p>[]</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_誰もが逃げ出す問題">誰もが逃げ出す問題</h2> <div class="sectionbody"> <div class="paragraph"> <p>トレーニングデータを扱うあらゆるAIスタートアップは、同じ壁にぶつかる：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">---- ---- Données brutes client (SPG, cours, évaluations) ├→ Noms de stagiaires en clair dans les PDF ├→ Emails dans les métadonnées JSON ├→ IP de connexion dans les logs pgvector ├→ Identifiants dans les nœuds Graphify └→ Références OF pilote dans les schémas SQL ---- 結果：汚れたデータに対してRAGを行う（PIIの幻覚、GDPR違反、法的リスク）か、何もせず（製品なし）かのいずれかです。第三の方法—手作業でクリーンアップする—はスケーラブルではありません。 私の答え：問題を回避しない。L'**自動化する**。 == MVP0：匿名化者、試用期間中に最初に採用された人 MVP0 は機能ではありません。それは**便利の専門家**— 一人の従業員が、汚い愚かで嫌な仕事をしており、誰もピッチデッキで話したがらない。 彼がやること: [source] ---- ENTRÉE : Données brutes multi-sources ├→ AsciiDoc (SPG_A2SP.adoc) → noms, dates, OF pilote ├→ JSON (catalogue formations) → emails, téléphones ├→ YAML (config workspace) → tokens OAuth2 ├→ SQL (schémas DDL) → IP, adresses ├→ pgvector (métadonnées embeddings) → identifiants ├→ ONNX (outputs classification) → noms propres └→ Graphify (graph.json) → nœuds avec PII SORTIE : Datasets propres, format standardisé ├→ [ANONYMIZED] remplace les PII détectées ├→ Classification RGPD (niveau 0→4) ├→ Rapport d'audit (quoi a été nettoyé) └→ Dataset prêt pour RAG ET fine-tuning ---- 最初に最も明白なパターンを検出します（emails`.*@.*`, トークン`sk-*`, `ghp_*`, IPs), それから彼は学ぶ。試用期間とはそういうことです : 偽陰性を見逃さないことを確認してから、正規に採用します。 == この MVP が解き放つもの（そしてそれは単なるコンプライアンスではない） MVP0としての匿名化は、高速道路の前にあるGDPRの通行料ではなく、高速道路そのものです。それが高速道路そのものです。これがそれが開くもの： === 現在：プロンプトにおける拡張現実 [source] ---- DONNÉES BRUTES CLIENT ↓ Anonymiseur MVP0 → datasets propres ↓ RAG pgvector (MVP1) → top-K documents similaires (filtrés, anonymisés) ↓ LLM (deepseek-v4-pro) → réponse augmentée, zéro PII ---- RAGは汚れたデータの中で探さない―それは空間の中で探す**構築によってきれい**. これは回答の品質に大きな影響を与える：LLMは認識しているが言及すべきでないPIIを回避するために時間を費やすわけではない。 === 将来 : 健全なデータへのファインチューニング [source] ---- MVP0 → datasets propres accumulés (session après session) ↓ Fine-tuning expert métier (CDA, FPA) sur données zéro PII ↓ Modèle fine-tuné exposé via Ollama (sans fuite de données) ---- 未加工のデータでのファインチューニングは法的災害となる可能性があります。クリーンなデータでは、それは**再現可能な方法**. 各クライアントは、クリーニングされたデータセットを蓄積し、各クライアントは自分のデータでビジネス専門家をファインチューニングできます — — 絶対に個人データを露出することはありません。 == なぜそれが市場性があるのか これは « GDPR コンプライアンス ツール » ではありません。これは一**普遍的な問題を資産に変える再現可能な方法**: 1. *すべてのトレーニング企業には汚いデータがあります* — それが問題です 2. *自動化されたマルチソースクリーニングパイプラインを持っているものはない* — それが市場です 3. ループ：匿名化 → RAG → ファインチューニングは独占的です — それが障壁です Edster SaaS (MVP3)は「Gradle ワークスペース」を販売しません。それはこの閉じたループを販売します。そしてMVP0は入口です。 == コンテキストにおける第三の道としてのSQL形式 構造化データのインポートは単なる交換フォーマットではなく、SQLスキーマ(DDL)は**ドメイン エンティティ-リレーションシップ モデル** : [source] ---- CREATE TABLE formation ( id UUID PRIMARY KEY, titre VARCHAR NOT NULL, referentiel RNCP REFERENCES rncp(id), organisme OF REFERENCES of_pilote(id) -- ← va être anonymisé ); ---- このDDLは、匿名化された後（行4）、LLMのコンテキストソースになります。テキストではない — これは**ビジネスモデル**. RAGはコンテンツ（ベクトル類似性）を提供し、Graphifyは関係（正確な構造）を提供し、SQLスキーマは**暗黙的ドメイン駆動設計**: bounded contexts, agrégats, value objects. LLMはスキーマを読むことでビジネスを理解する。 == ロードマップ：MVP0からSaaSへ [source] ---- MVP0 — Anonymiseur (ce que cet article décrit) Sortie : datasets propres, reproductible MVP1 — RAG pgvector (dépend de MVP0) Realité augmentée en prompt sur données nettoyées MVP2 — Graphify + ONNX + SQL DDD (dépend de MVP1) Vecteur composite de contexte (règles + similarité + relations exactes) MVP3 — SaaS Edster (dépend de MVP0-2) Provisionnement workspace client complet ---- 各MVPは前のものに依存しています。MVP0なしではどのMVPも配信できません。これが、バックログにおける「Anonymiseur」が「P0」ではない理由です — それは**MVP0**. これは最初の商業的な納品物であり、それ以外のすべてはその成功にかかっている。 == 結論：すべてを可能にする見えない仕事 一般的なスタートアップでは、データのクリーニングは外部委託、手動、または無視されます。このアーキテクチャでは、それは**製品の中心**. 匿名化者は最初に雇用される従業員です。なぜなら、彼がいなければ何も機能しないからです : * MVP0 がなければ → 法的な RAG なし (MVP1) * MVP0なしで → データ漏洩なしではファインチューニングは行われない (EPIC 5) * MVP0 なし→信頼できる SaaS なし(MVP3) * MVP0 がなければ → プロンプトに拡張現実なし * MVP0いないと→コンテキストにおける第三の道がない(SQL DDD) 彼は汚い仕事をする。ピッチで名前を挙げられることは決してない。しかし、工場を回しているのは彼だ。 それが理由で、最初に彼/彼女を雇う。 == 参考文献 * 空間オントロジーと信頼の円に関する記事：link:../2026/0114_gouvernance_cercles_confiance_ontologie_spatiale_alignement_llm_post.html[空間オントロジーとしての整合メカニズム] * エージャー/ラジーなエージェントのガバナンスに関する記事 :link:../2026/0108_gouvernance_agent_opencode_eager_lazy_post.html[AsciiDocを使ってAIエージェントを管理する] * Hot/Warm/Cold メカニズムに関する記事：link:../2026/0110_mecanisme_backup_contexte_agent_post.html[スライドウィンドウと寒波] * 三つのLLMの比較に関する記事：link:../2026/0112_comparaison_kimi_glm_deepseek_long_contexte_plugin_gradle_opencode_post.html[DeepSeek-V4-Pro, Kimi K2.6, GLM-5.1] ----</code></pre> </div> </div> </div> </div> https://cheroliv.com/blog/2026/0114_gouvernance_cercles_confiance_ontologie_spatiale_alignement_llm_post.html Thu, 30 Apr 2026 00:00:00 +0000 blog/2026/0114_gouvernance_cercles_confiance_ontologie_spatiale_alignement_llm_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_観察プロンプトエンジニアリングは砂の城だ">観察：プロンプトエンジニアリングは砂の城だ</a></li> <li><a href="#_四つの信頼の円_空間的オントロジー">四つの信頼の円 : 空間的オントロジー</a> <ul class="sectlevel2"> <li><a href="#_秘密の庭_cvs外の空間">秘密の庭 : CVS外の空間</a> <ul class="sectlevel3"> <li><a href="#_gitignore_をガバナンス設定として">.gitignore` をガバナンス設定として</a></li> <li><a href="#_スナップショットのメカニズム">スナップショットのメカニズム</a></li> </ul> </li> <li><a href="#_金庫_configuration_spring_cloud_configのように">金庫 : <code>configuration/</code> Spring Cloud Configのように</a></li> <li><a href="#_図書館_office_としてデータ消費可能">図書館 : <code>office/</code> としてデータ消費可能</a></li> <li><a href="#_鍛冶場_foundry_としての実装">�鍛冶場: <code>foundry/</code> としての実装</a></li> </ul> </li> <li><a href="#_長所短所_空間アラインメント_対_プロンプトアラインメント">長所/短所 : 空間アラインメント 対 プロンプトアラインメント</a> <ul class="sectlevel2"> <li><a href="#_クラシックアプローチプレプロンプトによるアラインメント">クラシックアプローチ：プレプロンプトによるアラインメント</a></li> <li><a href="#_このアプローチ_空間オントロジーによるアラインメント">このアプローチ : 空間オントロジーによるアラインメント</a></li> </ul> </li> <li><a href="#_関係代数のワークスペースとデルタobservable">関係代数のワークスペースとデルタObservable</a></li> <li><a href="#_コンテキスト複合ベクトル_rag_pgvector_graphify">コンテキスト複合ベクトル : RAG + pgvector + Graphify</a> <ul class="sectlevel2"> <li><a href="#_コンポーネント_1_rag_langchain4j_postgresql_pgvector">コンポーネント 1 — RAG LangChain4j + PostgreSQL pgvector</a></li> <li><a href="#_コンポーネント_2_knowledge_graph_graphify">コンポーネント 2 — Knowledge Graph Graphify</a></li> <li><a href="#_コンポーネント_3_graphify_インクリメンタル_疎_集約可能_消費可能">コンポーネント 3 — Graphify インクリメンタル : 疎, 集約可能, 消費可能</a></li> </ul> </li> <li><a href="#_自動gdpr分類llmをルータとして">自動GDPR分類：LLMをルータとして</a></li> <li><a href="#_ロードマップ_asciidoc_から_langgraph4j_へ">ロードマップ : AsciiDoc から LangGraph4j へ</a></li> <li><a href="#_このアーキテクチャが解決することとそれが解決しないこと">このアーキテクチャが解決すること（とそれが解決しないこと）</a></li> <li><a href="#_結論建築はディスコースとして">結論：建築はディスコースとして</a></li> <li><a href="#_参考文献">参考文献</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 20 minutes</div> <p>プロンプトエンジニアリングは脆いです。80,000トークンになると、あなたのアラインメントルールはノイズの中に埋もれ、LLMは会話の最初にあなたが求めたことを忘れます。私の解決策は？ テキストによるアラインメントではなく、<strong>スペース</strong>. 私は開発ワークスペースを、内密な秘密の庭から公開の鍛冶場まで、4つの同心円状の信頼圏に構造化しました。各圏はファイルシステムの物理的な領域です。LLMはルールを思い出させる必要はありません；ファイルのパスがそれらを含みます。これがどのように機能するか、そしてなぜこの空間によるアラインメントアーキテクチャが、よりレジリエントであるかという話です。`system prompt`500行の。</p> </div> <div class="paragraph"> <p>これは長い記事です。<br> ゆっくりとお座りください。</p> </div> <div class="dlist"> <dl> <dt class="hdlist1">トック</dt> <dd> <p>[]</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_観察プロンプトエンジニアリングは砂の城だ">観察：プロンプトエンジニアリングは砂の城だ</h2> <div class="sectionbody"> <div class="paragraph"> <p>3週間、Opencodeを使ってGradleプラグインを開発しました。3つの異なるLLM、Kimi K2.6、GLM-5.1、DeepSeek-V4-Proを使用して（唯一の生存者ですが、これは別の話<a href="0112_comparaison_kimi_glm_deepseek_long_contexte_plugin_gradle_opencode_post.html">既にここで説明済み。</a>）。私のエージェントガバナンス手法<a href="0108_gouvernance_agent_opencode_eager_lazy_post.html">以前の記事で詳しく説明しました。</a>はAsciiDocファイルに基づいています —<code>AGENT.adoc</code>, <code>INDEX.adoc</code>, <code>PROMPT_REPRISE.adoc</code>— 約30,000トークンのルール、バックログ、履歴を毎セッションの開始時に読み込む。</p> </div> <div class="paragraph"> <p>それにもかかわらず、このドキュメントインフラストラクチャにもかかわらず、二つのことが私を驚かせました：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>LLMは忘れる。</strong> EAGERファイルの先頭に絶対的なルールがあるにもかかわらず、累積トークン数が60,000を超えると（初期コンテキスト＋会話）、Kimi K2.6は提案し始めた`Write`エラーは構成ファイルに対して圧倒的だった。 GLM-5.1はFirebaseのトークンと置換すべきプレースホルダーを混同した。 ルールは書かれていた — LLMはそれらを*見なくなった*。</p> </li> <li> <p>ガバナンスそのものが問題となる。 Hot/Warm/Cold<a href="0110_mecanisme_backup_contexte_agent_post.html">Article sur la rotation de backup.</a> コンテキストの爆発を避けるために、しかし EAGERファイルはまだ1414行だった<a href="0111_audit_contexte_agent_post.html">J’ai documenté cet audit ici.</a> ガバナンス — LLMの飽和から保護するために設計された — は、LLMを飽和させていた。</p> </li> </ol> </div> <div class="paragraph"> <p>プロンプトのトークン数に依存しないアラインメント機構が必要でした。</p> </div> <div class="paragraph"> <p>答え：テキストによって揃えるのをやめ、テキストによって揃え始める<strong>スペース</strong>。</p> </div> </div> </div> <div class="sect1"> <h2 id="_四つの信頼の円_空間的オントロジー">四つの信頼の円 : 空間的オントロジー</h2> <div class="sectionbody"> <div class="paragraph"> <p>私のフォルダー`workspace/<code>(中に</code>~/workspace/`) は <strong>pas</strong> Git リポジトリではありません。 これは 私の仕事全体のルートです — コード、ドキュメント、トレーニング、インフラストラクチャ。 そしてこれは 4 つのゾーンに構造化されており、これらは単なる整理ルールではなく、しかしこれらは<strong>同心円状の信頼の円</strong>：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 6.6666%;"> <col style="width: 13.3333%;"> <col style="width: 20%;"> <col style="width: 26.6666%;"> <col style="width: 33.3335%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">レベル</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ラベル</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">物理的なゾーン</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">CVS</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">可視性</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">0</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>秘密の庭</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">`workspace/`根</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">何も</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">親密 — 考えは自由、コミットも公開もしない</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>金庫</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>configuration/</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">プライベートGit (ソロ)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">秘密、トークン、ビジョンアーカイブ。一人だけ。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>図書館</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>office/</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Git プライベート (拡張)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">教育データ, SPG/SPD, JSONスキーマ. 信頼の輪が識別されました。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>公共の鍛冶場</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>foundry/</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Git 公開 (Apache 2.0)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ソースコード、プラグイン、テスト、技術ドキュメント。</p></td> </tr> </tbody> </table> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="ℹ️"></i> </td> <td class="content"> テーブルにレベル 3 はありません。レベル 3 は一時的なレベル <strong>transitoire</strong> です：これはコンテンツの`office/`匿名化され、オープンデータとして公開する準備ができている。 物理的に固有の領域はなく — データの状態であり、場所ではない。 </td> </tr> </table> </div> <div class="paragraph"> <p>各レベルは特定の質問に答えています：</p> </div> <div class="ulist"> <ul> <li> <p><strong>どこにアイデアを置けばいいのか、まだ共有する準備ができていない、たとえ小さな圈でも？</strong> → 秘密の庭。Gitなし。プレッシャーなし。</p> </li> <li> <p><strong>APIトークンをどこに保存すれば漏洩しませんか？</strong> → 金庫`configuration/`) 物理的に隔離されています。他のリポジトリが誤って参照することはありません。</p> </li> <li> <p><strong>コ・構築する研修カタログをパイロットのOFと共にどこで作るか？</strong> → 図書館`office/`). バージョン管理され、コラボレーションが可能だが、プライベートな。</p> </li> <li> <p><strong>オープンソースのGradleプラグインを産業化する場所は？</strong> → 鍛冶場`foundry/`). 公開、フォーク可能、CIでテスト済み。</p> </li> </ul> </div> <div class="paragraph"> <p>このオントロジーは<strong>LLMで消費可能</strong>. ファイルを読み込むときに`foundry/plantuml-gradle/src/`, 彼は暗黙的に知っている：「私はサークル4にいる — パブリックコード、必須テスト、秘密はなく、教育データもない」。 彼はそれを思い出させるプロンプトを必要としない。</p> </div> <div class="sect2"> <h3 id="_秘密の庭_cvs外の空間">秘密の庭 : CVS外の空間</h3> <div class="paragraph"> <p>これは最も重要な概念 — そして最も反直感的な概念です。</p> </div> <div class="paragraph"> <p>根`workspace/<code>ない</code>.git/<code>. そこに住んでいるドキュメント (`WORKSPACE_VISION.adoc</code>, <code>WORKSPACE_AS_PRODUCT.adoc</code>, <code>WORKSPACE_ORGANIZATION.adoc</code>— そして今あなたが読んでいるそれ（それに由来するものは）バージョン管理されたり、共有されたり、まして私以外によって読み返されたりすることを意図していません。これらは<strong>発芽中の思考</strong>。</p> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="❗"></i> </td> <td class="content"> <div class="paragraph"> <p>秘密の庭は自然に <strong>out-of-CVS</strong> です。バージョン管理の欠如が思考の自由の条件です。そこで書くのは読まれるため — 自分の考えを明確にするため。</p> </div> </td> </tr> </table> </div> <div class="paragraph"> <p>しかし、この自由には代償がある：一つ`rm`あれは偶然のことで、戦略的思考の何ヶ月分が消えてしまう。解決策は庭をバージョン管理することではない（それはそれを消すことになる）―それはそれを<strong>映す</strong>最も制限された円の中で。</p> </div> <div class="sect3"> <h4 id="_gitignore_をガバナンス設定として">.gitignore` をガバナンス設定として</h4> <div class="paragraph"> <p>の根底に`workspace/<code>, 1つのファイル</code>.gitignore`最小が宣言する<strong>履歴管理ポリシー</strong>秘密の庭のファイル:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">.goosehints .goose</code></pre> </div> </div> <div class="paragraph"> <p>Ce <code>.gitignore`クラシックなGit関数はありません（</code>.git/`根元で). それは～のように振る舞う<strong>ガバナンス設定ファイル</strong>正確な質問に答えるもの： <strong>秘密の庭の人工物で歴史化される価値があるものはどれか、そして純粋に一時的なものはどれか？</strong></p> </div> <div class="ulist"> <ul> <li> <p>リストされたファイルの`.gitignore`—<code>.goosehints</code>, <code>.goose</code>— エージェントによって生成される一時的なアーティファクト。戦略的価値はない。歴史化されない。</p> </li> <li> <p>ファイル`.adoc`根の—<code>WORKSPACE_VISION.adoc</code>, <code>WORKSPACE_ORGANIZATION.adoc</code>, <code>WORKSPACE_AS_PRODUCT.adoc</code>, <code>WHAT_THE_GAMES_BEEN_MISSING.adoc</code>, <code>depots_implementes_strategie.adoc</code>, <code>synthese-LLMs-long-contexte.adoc</code>— ではない<strong>ない</strong>の中`.gitignore`これらは歴史化すべき遺物です。</p> </li> </ul> </div> <div class="paragraph"> <p>Le `.gitignore`は<strong>ガバナンススキーマ</strong>: そこにリストされていないものはすべてスナップショットの候補となる。そしてLLMはこのファイルを読むことで、アーカイブすべきものと無視できるものを正確に知っている——プロンプトで思い出させる必要がない。</p> </div> </div> <div class="sect3"> <h4 id="_スナップショットのメカニズム">スナップショットのメカニズム</h4> <div class="paragraph"> <p>作成しました`configuration/vision-archive/<code>: すべての日付付きスナップショット</code>.adoc`ルートの、プライベートリポジトリにコミットされた`configuration/`. 各ブレインストーミングセッションはスナップショットを生成します：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">DATE=$(date +%Y-%m-%d) mkdir -p /home/cheroliv/workspace/configuration/vision-archive/$DATE cp /home/cheroliv/workspace/*.adoc /home/cheroliv/workspace/configuration/vision-archive/$DATE/ cd /home/cheroliv/workspace/configuration && git add vision-archive/ && \ git commit -m "vision-archive: snapshot $DATE"</code></pre> </div> </div> <div class="paragraph"> <p>この手順は、セッションの終わりに、LLM自身によってトリガーされ、この全体的なルーティングタスクが実行されます。各スナップショットは、時刻Tにおける戦略的思考の完全な状態を捉えます。</p> </div> <div class="paragraph"> <p>Gitの履歴の`configuration/`になる<strong>私の戦略的思考の伝記</strong>. 私は一つを作ることができます`git log — vision-archive/`そして私のビジョンの進化を、セッションごとに、日付ごとに見る。</p> </div> <div class="paragraph"> <p>作業日の後の履歴の実例：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">$ git -C configuration log --oneline -- vision-archive/ 1089d1b vision-archive: fin de session finale 2026-05-03 6b21eaf vision-archive: fin de session 2026-05-03-1300 1690f82 vision-archive: post-article 2026-05-03 28e6593 vision-archive: post-migration 2026-05-03 3707b78 vision-archive: snapshot 2026-05-03 — jardin secret initial</code></pre> </div> </div> <div class="paragraph"> <p>1日で5つのスナップショット。それぞれが復元ポイント。それぞれが戦略の起源におけるマイルストーン。</p> </div> <div class="paragraph"> <p>フォルダー`configuration/vision-archive/latest/`常に含んでいる<strong>作業コピー</strong>最後のスナップショット、素早い参照として、Gitの履歴をナビゲートする必要なく。</p> </div> <div class="paragraph"> <p>そしてLLMにとって、それは<strong>整合性のオラクル</strong>: 彼が現在の実装と過去にアーカイブされたビジョンの間に矛盾を観測したとき、それを報告することができます。</p> </div> </div> </div> <div class="sect2"> <h3 id="_金庫_configuration_spring_cloud_configのように">金庫 : <code>configuration/</code> Spring Cloud Configのように</h3> <div class="paragraph"> <p>`configuration/`それは視覚のアーカイブだけを含んでいるわけではない。その第一の（および将来の）機能は、～であることだ。<strong>スプリングクラウドコンフィグサーバー</strong>. すべてのシークレット、トークン、認証情報、およびインフラストラクチャの記述子は、ここに存在します。プライベートなGitリポジトリにあり、所有者だけがアクセスできます。</p> </div> <div class="paragraph"> <p>なぜファイルではなく、別個のリポジトリを使うのか`.env`各プロジェクトで？</p> </div> <div class="ulist"> <ul> <li> <p><strong>意図しないシークレットのプッシュ</strong> :不可能です。シークレットは、公開プロジェクトが誤って参照できない非公開リポジトリにあります。</p> </li> <li> <p><strong>監査</strong> : Gitの履歴は、設定の各変更の痕跡を示します。誰が何を、いつ変更したか、どのSHAハッシュを使用したか。</p> </li> <li> <p><strong>ロールバック</strong> :`git revert`� 壊れた構成上で。 スナップショット、手動バックアップなし。</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_図書館_office_としてデータ消費可能">図書館 : <code>office/</code> としてデータ消費可能</h3> <div class="paragraph"> <p>`office/`それは開発作業のドキュメンテーションの対応である。それはブログ記事、技術仕様、トレーニング教材（FPA、SPG/SPD の 38 のコースディレクトリ、JSON スキーマ、Bloom/Harrow/Krathwohl のタクソノミー）を含んでいる — それが構成するものすべてである。<strong>教育教材</strong>。</p> </div> <div class="paragraph"> <p>しかし`office/`単なるドキュメントの引き出しではない。それは<strong>構造化データのソース</strong>Gradle プラグインの`foundry/`消費しています。ブログ記事の中に`office/`は、プラグインによってHTMLに変換されるエントリです。AsciiDocのSPGは`office/metiers/FPA/`これは、オーケストレーターがパースしてスライド、クイズ、およびビデオカプセルを生成するアーティファクトです。</p> </div> <div class="paragraph"> <p>Et le `build.gradle.kts`根本に`office/`ビジネスコードではありません — それは<strong>プラグインエコシステムの消費スクリプト</strong>. 彼は言う： 「私が使っているGradleプラグインはこちらです、ワークスペースのコンテキストはこちらです」</p> </div> </div> <div class="sect2"> <h3 id="_鍛冶場_foundry_としての実装">�鍛冶場: <code>foundry/</code> としての実装</h3> <div class="paragraph"> <p><code>foundry/`を含む<strong>工業化されたコード</strong>. 54 Git リポジトリ, そのうち 7 は現在、によって管理されている</code>.agents/`. ここがビジョンが実行可能になる場所 — Gradleプラグイン、CI/CD、JUnit5 + Cucumberのテスト。</p> </div> <div class="paragraph"> <p>との関係`office/`は双方向です：</p> </div> <div class="ulist"> <ul> <li> <p><code>office/</code>→<code>foundry/</code>: 教育データはプラグインが消費する原材料です。</p> </li> <li> <p><code>foundry/</code>→<code>office/</code>：プラグインは豊かにするデータを生成する`office/` — le `graph.json`graphify-gradleのコンパイル済みスライダーデッキ、ビルドレポート</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_長所短所_空間アラインメント_対_プロンプトアラインメント">長所/短所 : 空間アラインメント 対 プロンプトアラインメント</h2> <div class="sectionbody"> <div class="paragraph"> <p>2つのアプローチを比較しましょう。</p> </div> <div class="sect2"> <h3 id="_クラシックアプローチプレプロンプトによるアラインメント">クラシックアプローチ：プレプロンプトによるアラインメント</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 20%;"> <col style="width: 80%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">�✅ プロ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">❌ 反対</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">実装が簡単です。 システムプロンプト内のテキストブロック。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>長いコンテキストでは脆弱</strong> : ルールは80Kトークン以降で見失われる。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">一般的な規則（トーン、フォーマット）に機能します。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>検証不可能</strong> : LLMがルールを破るのを妨げるものは何もない。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">プロジェクトのアーキテクチャを考え直す必要はありません。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>�譲渡不能</strong> : 各リポジトリはルールを再宣言する。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>純粋に宣言的</strong> : LLMはそれがすべきだと知っているが、何もそれを妨げない。</p></td> </tr> </tbody> </table> </div> <div class="sect2"> <h3 id="_このアプローチ_空間オントロジーによるアラインメント">このアプローチ : 空間オントロジーによるアラインメント</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 20%;"> <col style="width: 80%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">�✅ プロ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">❌ 反対</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>長文コンテキストに対してレジリエント</strong> : ルールはファイルパスにあり、遠いプロンプトにはない。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>初期インフラストラクチャコスト</strong> : ワークスペースを円形に構成するには時間がかかります。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>機械的に検証可能</strong> : 秘密の中`foundry/<code>によって検出可能`git check-ignore</code>.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>規律が必要</strong> : 新しい貢献者は円を理解する必要がある。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transférable</strong> : 一つ`AGENT.adoc`標準は、すべての新しいプロジェクトにサークルを公開します。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>空間的制約のみをカバー</strong> — コードスタイルはプロンプトに残る。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>設計によるセキュリティ</strong> : 一つ`git push`以来`foundry/<code>公開できない`configuration/</code>。</p></td> <td class="tableblock halign-left valign-top"></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>LLM以外のエージェントによって消費可能</strong> : Gradleオーケストレーターはサークルに従ってルーティングできます。</p></td> <td class="tableblock halign-left valign-top"></td> </tr> </tbody> </table> <div class="paragraph"> <p>主な利益は守備的（セキュリティ、可視性）ではなく — それは<strong>クリエイティブ</strong>. LLMがオントロジーによって構造化された空間で作業しているとき、それはどのプロンプトでも許されないことをすることができる：<strong>デルタを観察する</strong></p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_関係代数のワークスペースとデルタobservable">関係代数のワークスペースとデルタObservable</h2> <div class="sectionbody"> <div class="paragraph"> <p>LLMが巡回するとき`foundry/<code>, それはあるを持っている<strong>構造化データの格子</strong>ノード (プラグイン、ファイル、テスト、依存関係)、型付きエッジ (`import</code>, <code>depends_on</code>, <code>generates</code>, <code>tests</code>), 構成関係と順序関係 (`training-gradle`リポジトリを抽出→`slider-gradle`スライドを生成します →`capsule-gradle`動画を編集して</p> </div> <div class="paragraph"> <p>この代数はどこにも平文で書かれていない — しかし、それは*観測可能*である。それぞれ`build.gradle.kts`依存関係を公開します。それぞれ`INDEX.adoc`相互参照を表示します。</p> </div> <div class="paragraph"> <p>LLMはこの代数を観察し、それを検出する<strong>デルタ</strong>システムがすでに生産できるものと、ビジョンが描写するものの間のギャップ</p> </div> <div class="paragraph"> <p>このデルタから、彼は(または、それは)いくつかの<strong>業務エキスパートの地図</strong>— CDA (アプリケーション設計開発者、Kotlin/Gradle/JHipster) と FPA (成人向けプロフェッショナル講師、教育法/Qualiopi/Bloom) — 各専門家に不足しているものを特定する。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">Expert CDA (Kotlin/Gradle/JHipster) ├── Plugins : jhipster-gradle-plugins, plantuml-gradle, │ codebase-gradle ├── Delta : pas encore de SPG CDA formalisé, │ pas de fine-tuning expert CDA Expert FPA (Pédagogie/Qualiopi/Bloom) ├── Plugins : training-gradle, slider-gradle, │ school-backoffice/forms, capsule-gradle ├── Matériel : 38 modules cours, SPG/SPD, taxonomies └── Delta : parser AsciiDoc→JSON à créer, orchestrateur à coder</code></pre> </div> </div> <div class="paragraph"> <p>LLMに何をすべきかを教える必要はない。デルタは構造から現れる。</p> </div> </div> </div> <div class="sect1"> <h2 id="_コンテキスト複合ベクトル_rag_pgvector_graphify">コンテキスト複合ベクトル : RAG + pgvector + Graphify</h2> <div class="sectionbody"> <div class="paragraph"> <p>リレーショナル代数は理論的な構築ではありません。それは*具体化された*三つのコンポーネントによって一つの<strong>コンテキストの合成ベクトル</strong>LLMのために</p> </div> <div class="sect2"> <h3 id="_コンポーネント_1_rag_langchain4j_postgresql_pgvector">コンポーネント 1 — RAG LangChain4j + PostgreSQL pgvector</h3> <div class="paragraph"> <p>私はすでにLangChain4jを2つのプラグインで本番環境で使用しています：<code>slider-gradle</code>(4 providers LLM) と`plantuml-gradle`(7 プロバイダー). ONNX の埋め込み (AllMiniLmL6V2) データのインデックスを`office/`そしてソースコードの`foundry/`PostgreSQL + pgvector の中で。</p> </div> <div class="paragraph"> <p>このRAGは2つの次元で機能します：</p> </div> <div class="ulist"> <ul> <li> <p><strong>Dimension data</strong> : ドキュメント`office/`(SPG, 記事, 形成, JSONスキーマ)</p> </li> <li> <p><strong>ディメンションコード</strong>:コードベース`foundry/`(Kotlinのソース, Cucumberのテスト, AGENT.adoc)</p> </li> </ul> </div> <div class="paragraph"> <p>交差は、<strong>何</strong>（業務ドメイン）と*方法*（実装）の両方をカバーします。</p> </div> </div> <div class="sect2"> <h3 id="_コンポーネント_2_knowledge_graph_graphify">コンポーネント 2 — Knowledge Graph Graphify</h3> <div class="paragraph"> <p>Graphifyは組み込まれています`plantuml-gradle`(109 tests, 380/380 PASS)と生成する`graph.json`— ノード、エッジ、および自動検出されたコミュニティを持つ構造化されたナレッジグラフ</p> </div> <div class="paragraph"> <p>RAGがベクトル類似性（ぼやけた）によって動作するのに対し、知識グラフは…で動作する<strong>正確な関係</strong>(決定的) :`graphify query`意味的なクエリについて (約50トークン),`graphify path`ナビゲートする,`graphify explain`説明するために。</p> </div> </div> <div class="sect2"> <h3 id="_コンポーネント_3_graphify_インクリメンタル_疎_集約可能_消費可能">コンポーネント 3 — Graphify インクリメンタル : 疎, 集約可能, 消費可能</h3> <div class="paragraph"> <p>これが建築上の重要な決定です。</p> </div> <div class="paragraph"> <p>Graphify は単一のリポジトリに存在してはなりません。それはある方法で生きなければならない。<strong>散らばった</strong>各プラグインで :</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>各プラグイン</strong> は Gradle タスクを含む`updateKnowledgeGraph`Graphifyを呼び出す<strong>自身のスコープで</strong>と生成する一つ`graph.json`ローカル。</p> </li> <li> <p>* ビルドスクリプトの`office/<code>* 消費する`graphify-gradle`と`rootDir = /home/cheroliv/workspace`そして生成する`graph.json</code> <strong>グローバル</strong>ローカルグラフを集約する</p> </li> <li> <p>*各プラグインのRAG*を注入する`graph.json`グローバルのように<strong>コンテキストフィルター</strong>LLMのクエリに対して</p> </li> </ol> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">TÂCHE GRADLE (dans chaque plugin) ↓ graphify → graph.json (scope local) ↓ office/build.gradle.kts → graph.json (scope global) ↓ RAG pgvector (dans slider, plantuml, codebase...) ↓ ← injection du graph.json comme filtre LLM (deepseek-v4-pro) ↓ ← observation algèbre relationnelle ↓ ← détection delta vs cartographies experts PRIORISATION → prochaine tâche</code></pre> </div> </div> <div class="paragraph"> <p>結果：LLMは虚空を探さず、ナレッジグラフによって構造化された空間をナビゲートします。 「<code>génère un diagramme</code>」というクエリは、グラフの関連ノードに到達できます。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_自動gdpr分類llmをルータとして">自動GDPR分類：LLMをルータとして</h2> <div class="sectionbody"> <div class="paragraph"> <p>空間オントロジーはLLMを単に整列させるだけで満足せず — それに___を与える<strong>GDPRの分類グリッド</strong>各データをその正当なゾーンにルーティングするために。</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 12.5%;"> <col style="width: 37.5%;"> <col style="width: 25%;"> <col style="width: 25%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">基準</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">LLM検出</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">アクション</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">最大レベル</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">個人データ (名前、メール、IP)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">パターン`@`, IP, 固有名詞</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�匿名化 →`[OF_PILOTE]`またはレベル2のルーター</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">トークン / シークレット / クレデンシャル</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">パターン`sk-…​<code>, `ghp_…​</code>, <code>ya29…​</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ルーター →<code>configuration/</code>. 参照元`${VAR}`コード内で。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">内部URL</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">含む`localhost`, プライベートIP</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">匿名化 →<code>${API_URL}</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">教育データ (SPG, コース)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">構造 Bloom/Qualiopi</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ルーター →<code>office/</code>(レベル 2). エクスポート時はダブルバージョン。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ソースコード / テスト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">拡張`.kt`, <code>.kts`中`foundry/</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ルーター →<code>foundry/</code>. 秘密がないことを確認してください。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>セッションの最後に、LLMは実行する<strong>グローバルタスク</strong>:</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>の読み込み`.gitignore`スナップショットから除外する一時的なアーティファクトと、履歴化する戦略的なアーティファクトを識別するためのルート</p> </li> <li> <p>すべてのファイルのインベントリ`.adoc`根の`workspace/`</p> </li> <li> <p>フィルタリング：リストされたファイルの除外`.gitignore`, すべての他を含む</p> </li> <li> <p>中にコピー`configuration/vision-archive/$DATE/<code>とシンボリックリンクの更新`latest/</code></p> </li> <li> <p>リポジトリへのコミット`configuration/`構造化されたメッセージと共に</p> </li> <li> <p>各変更ファイルの自動GDPR分類（すべての円）</p> </li> <li> <p>ルーティング : データ`office/<code>→ プライベートコミット, コード`foundry/</code>→<code>./gradlew check</code>, 構成 → コミット</p> </li> <li> <p>構造化されたレポートとRGPDアラートおよびアーカイブの確認</p> </li> </ol> </div> <div class="paragraph"> <p>Le `.gitignore`ルートはGitの設定ファイルではありません — それは<strong>履歴管理のガバナンスファイル</strong>. それはLLMが消費するスキーマを定義し、どの秘密の庭のファイルが戦略的伝記に入り、どれが捨てられるかを決定します。</p> </div> <div class="paragraph"> <p>LLMはもはや単なるテキスト生成器ではなくなった。それは<strong>情報管理者</strong>エコシステムの — 生産者、分類器、ルーター。</p> </div> </div> </div> <div class="sect1"> <h2 id="_ロードマップ_asciidoc_から_langgraph4j_へ">ロードマップ : AsciiDoc から LangGraph4j へ</h2> <div class="sectionbody"> <div class="paragraph"> <p>今日、このガバナンスは <strong>決定論的</strong> です : LLM は AsciiDoc ファイルに記述された手順を適用します。これは<strong>フェーズ 1</strong>— LLMメモリを用いたプロンプトエンジニアリング。</p> </div> <div class="paragraph"> <p>La <strong>フェーズ 2</strong>それぞれの手順をあるものの中に抽出する<strong>型付き Gradle タスク</strong> :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">./gradlew endSessionWorkspace → snapshot vision-archive ./gradlew endSessionProject → archive .agents/ ./gradlew endSessionReport → rapport multi-zones</code></pre> </div> </div> <div class="paragraph"> <p>La <strong>フェーズ 3</strong>セッション終了プロセスをあるもののようにモデル化する<strong>状態グラフ</strong>とhttps://github.com/langgraph4j/langgraph4j[LangGraph4j]:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">[Start] → [Inventaire fichiers modifiés] → [Classification RGPD] (nœud ONNX) → [Branchement par cercle] ├→ cercle 0 → snapshot → commit ├→ cercle 2 → anonymisation → commit ├→ cercle 4 → archive → commit └→ cercle 1 → commit configuration/ → [Rapport] → [End]</code></pre> </div> </div> <div class="paragraph"> <p>このグラフは CI/CD でバージョン管理され、Gradle で実行され、プラグインの GitHub Secrets を介して設定されます。LLM はルーティングを決定する必要がなくなり — グラフがそれを行います。</p> </div> </div> </div> <div class="sect1"> <h2 id="_このアーキテクチャが解決することとそれが解決しないこと">このアーキテクチャが解決すること（とそれが解決しないこと）</h2> <div class="sectionbody"> <div class="admonitionblock caution"> <table> <tr> <td class="icon"> <i class="fa icon-caution" title="🔒"></i> </td> <td class="content"> <div class="paragraph"> <p>空間オントロジーはすべてをカバーしない。 コードスタイルの規約、命名、アーキテクチャ設計の選択 — これらはすべてプロンプトに残る。 空間オントロジーが解決するのは、<strong>セキュリティ・可視性レイヤー</strong>各バイトが存在すべき場所と、それを見ることができる者。</p> </div> </td> </tr> </table> </div> <div class="paragraph"> <p>これは彼女が具体的に提供するものです：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>ない`git push`偶発的な秘密</strong> : 秘密は`configuration/<code>(サークル 1). 公共プロジェクトは`foundry/</code>(円4)。両方を横切る道はない。</p> </li> <li> <p><strong>業務コードはデータに含まれません</strong> :`office/<code>含む</code>.adoc`, YAML, JSON スキーマ — ただし`.kt`. Le `build.gradle.kts`そこで暮らしているのは消費スクリプト、 ビジネスコードではありません。</p> </li> <li> <p><strong>戦略的思考が明らかにされていない</strong> : ビジョンのドキュメントは秘密の庭に生きています（CVS外のルート）。スナップショットは`configuration/`(私的な金庫)。信頼の輪を広げても、誰も戦略の創成を読まない。</p> </li> <li> <p><strong>自動優先化</strong> : LLM は、関係代数（存在するもの）とエキスパートマッピング（必要なもの）の間のデルタを観測します。次の開発タスクはこのデルタから生じます。</p> </li> </ol> </div> </div> </div> <div class="sect1"> <h2 id="_結論建築はディスコースとして">結論：建築はディスコースとして</h2> <div class="sectionbody"> <div class="paragraph"> <p>私はサイトのフッターに政治的マニフェストを掲載しません。 私はプロンプトに倫理的なルールを入れません。 アライメントはテキストの中にない——それは中にある<strong>ファイルシステム</strong>。</p> </div> <div class="paragraph"> <p>LLM がこの空間で作業しているとき、秘密を漏らすことはできません（経路がそれを防ぐため）。教育データとソースコードを混同することはできません（物理的な領域が異なるため）。80,000 トークンのセキュリティ ルールを忘れることはできません——なぜなら、そのルールはプロンプトの中ではなく、そこにあるからです。<code>workspace/</code>→<code>configuration/</code> → <code>office/</code>→`foundry/`それぞれのファイルの読み込みは反応性がある。</p> </div> <div class="paragraph"> <p>これは、*secure by design*の原則をエージェントのアラインメントに適用したものです：LLMにルールを覚えさせないようにする。アーキテクチャによってエラーが構造的に不可能となるようにする。</p> </div> <div class="paragraph"> <p>そして、これはLLMに与えるもので、どのプロンプトにも与えることができないもの：能力を<strong>感じ取る</strong>彼がどこにいるか、何が存在し、何が欠けているか — そしてそれらから何をすべきかを導き出す。</p> </div> </div> </div> <div class="sect1"> <h2 id="_参考文献">参考文献</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>エージェントのEager/Lazyガバナンスに関する記事：<a href="../2026/0108_gouvernance_agent_opencode_eager_lazy_post.html">AsciiDocを使ってAIエージェントを管理する</a></p> </li> <li> <p>Hot/Warm/Coldメカニズムに関する記事 :<a href="../2026/0110_mecanisme_backup_contexte_agent_post.html">スライドウィンドウと寒波</a></p> </li> <li> <p>コンテキスト監査に関する記事：<a href="../2026/0111_audit_contexte_agent_post.html">自分のガバナンスが問題になるとき</a></p> </li> <li> <p>3つのLLMの比較に関する記事：<a href="../2026/0112_comparaison_kimi_glm_deepseek_long_contexte_plugin_gradle_opencode_post.html">DeepSeek-V4-Pro, Kimi K2.6, GLM-5.1</a></p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2026/0113_integration_firebase_contact_form_post.html Wed, 29 Apr 2026 00:00:00 +0000 blog/2026/0113_integration_firebase_contact_form_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_シーン何も保存しないフォーム">シーン：何も保存しないフォーム</a> <ul class="sectlevel2"> <li><a href="#_supabaseの遺産">Supabaseの遺産</a></li> <li><a href="#_幽霊の二重提出">幽霊の二重提出</a></li> </ul> </li> <li><a href="#_なぜfirebaseをsupabaseの代わりに使うのか">なぜFirebaseをSupabaseの代わりに使うのか？</a></li> <li><a href="#_フェーズ_1_firebase_プロジェクトを作成">フェーズ 1 : Firebase プロジェクトを作成</a> <ul class="sectlevel2"> <li><a href="#_初期化">初期化</a></li> <li><a href="#_firestoreセキュリティルール">Firestoreセキュリティルール</a></li> </ul> </li> <li><a href="#_フェーズ_2_提出のjavascriptを書き直す">フェーズ 2: 提出のJavaScriptを書き直す</a> <ul class="sectlevel2"> <li><a href="#_依存関係_window_firebase">依存関係 `window.<em>FIREBASE</em></a></li> <li><a href="#_新しい_contact_js">新しい `contact.js</a></li> </ul> </li> <li><a href="#_phase_3_supabaseのデッドコードをクリーンアップ">Phase 3 : Supabaseのデッドコードをクリーンアップ</a></li> <li><a href="#_フェーズ_4_フッターを設定する">フェーズ 4: フッターを設定する</a></li> <li><a href="#_フェーズ_5_最終アーキテクチャ">フェーズ 5 : 最終アーキテクチャ</a></li> <li><a href="#_この移行がドッグフーディングについて何を言っているか">この移行がドッグフーディングについて何を言っているか</a> <ul class="sectlevel2"> <li><a href="#_変更のまとめ">変更のまとめ</a></li> </ul> </li> <li><a href="#_次のステップ_バックログ">次のステップ (バックログ)</a></li> <li><a href="#_参考文献">参考文献</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 12 minutes</div> <p>数ヶ月間、このサイトのお問い合わせフォームは <code>mock JavaScript</code> 上で動いていました — 85% の成功率を約束するもの、偽の <code>Firestore</code>、データはゼロ、保存されていない。当初の計画では、メール通知のために <code>Supabase</code> バックエンドと <code>Google Apps Script</code> を組み合わせる予定でした。断念されました。今日、私は <code>Firebase Firestore</code> への移行について語ります： <code>projet</code> の作成、 <code>règles de sécurité</code> の設定、 <code>JS</code> の書き換え、 <code>Supabase</code> のデッドコードの削除。そしてなぜこの選択が開発哲学におけるより広い意味を示すのか。</p> </div> <div class="dlist"> <dl> <dt class="hdlist1">チック</dt> <dd> <p>[]</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_シーン何も保存しないフォーム">シーン：何も保存しないフォーム</h2> <div class="sectionbody"> <div class="paragraph"> <p>このサイトはJBakeによって生成されています。私のGradleプラグインです。<code>bakery</code>. これは100％静的です — バックエンドもデータベースもありません。ただし、お問い合わせフォームがあります。このページ`contact.html`存在し、HTMLは準備完了です（項目：名前、メール、電話番号、件名、メッセージ、HTML5検証、スパム防止ハニーポット）、Bootstrapのスタイルは設定済みです。見た目では、すべて完璧です。</p> </div> <div class="paragraph"> <p>ただし、提出すると何も起こらない。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">const firebaseMock = new Promise((resolve, reject) => { setTimeout(() => { if (Math.random() < 0.85) { resolve({ status: 201, message: 'Message stored in Firestore.' }); } else { reject({ status: 500, message: 'Firestore write failed.' }); } }, 1500); });</code></pre> </div> </div> <div class="paragraph"> <p>モック。見せかけの約束。ユーザーはスピナーを見、次に「メッセージが正常に送信されました！」というメッセージを見る。しかしデータは虚空に消える。どこにもメッセージは保存されない。</p> </div> <div class="paragraph"> <p>状況は壊れたフォームよりも悪い — それは嘘をつくフォームだ。</p> </div> <div class="sect2"> <h3 id="_supabaseの遺産">Supabaseの遺産</h3> <div class="paragraph"> <p>初期計画、文書化されたで`content/draft/integration_formulaire_contact_supabase.adoc`, 予定していた :</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>Supabaseのデータベースとテーブル`contacts`と Row Level Security</p> </li> <li> <p>1つのRPC`handle_contact_form`サーバー サイド</p> </li> <li> <p>Google Apps Script のウェブフックを呼び出す SQL トリガー</p> </li> <li> <p>Gmail の通知メールを送信する Google Apps Script</p> </li> </ol> </div> <div class="paragraph"> <p>対応するJavaScriptコードはまだ存在しています`script.js`. クラスがあります`SupabaseManager`グローバル変数を使用してSupabaseクライアントを初期化する`SUPABASE_URL` et <code>SUPABASE_KEY</code>, とクラス`ContactFormHandler`フォームのsubmitイベントを監視し、呼び出す`SupabaseManager.submitContactForm()`.</p> </div> <div class="paragraph"> <p>問題: これらのグローバル変数はフッターに注入されなくなりました。その`<script src="supabase-js">`削除されました。 コードは呼び出します。`supabase.createClient()`変数上に`supabase`存在しない。したがって :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">console.error : 'Supabase client library (supabase-js) is not loaded.'</code></pre> </div> </div> <div class="paragraph"> <p>データは保存されないだけでなく、提出コードは死んでいる。</p> </div> </div> <div class="sect2"> <h3 id="_幽霊の二重提出">幽霊の二重提出</h3> <div class="paragraph"> <p>事態をさらに悪化させるために、ある<strong>静かな競争</strong>同じフォーム上の2つのハンドラー間で :</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>`contact.js`送信を聞き取り、Firebaseモックを呼び出す</p> </li> <li> <p><code>script.js</code>— 経由して`ContactFormHandler`— サブミットも聞いて、呼び出す`SupabaseManager`</p> </li> </ol> </div> <div class="paragraph"> <p>両方は`event.preventDefault() + event.stopPropagation()<code>. ように`contact.js`最初にロードされます`footer.thyme</code>, そのハンドラーは最初に接続されます。それが伝播をブロックします。`ContactFormHandler`決してトリガーされません。</p> </div> <div class="paragraph"> <p>これはアクティブなバグではなく、むしろゾンビです。決して実行される機会のないコード。</p> </div> <div id="diag-before" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE title 初期状態 — お問い合わせフォーム rectangle "contact.thyme\n(HTML Bootstrap, ハニーポット)" as FORM rectangle "footer.thyme\n(Firebase SDK プレースホルダー構成)" as FOOT rectangle "contact.js (mock Firebase, 85% 成功)" as CONT rectangle "script.js\n(SupabaseManager + ContactFormHandler, 死者)" as SCRIPT rectangle "ユーザー" as USER USER -> FORM : Soumission du formulaire FORM -> CONT : submit event (attaché en premier) CONT -> CONT : preventDefault + stopPropagation CONT -> CONT : mock Promise (1.5s, aléatoire) note right of CONT ⚠️ Aucune donnée stockée end note FORM ..> SCRIPT : submit event (bloqué par stopPropagation) note right of SCRIPT : ❌ Jamais déclenché note right of SCRIPT : ❌ supabase-js non chargé @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_なぜfirebaseをsupabaseの代わりに使うのか">なぜFirebaseをSupabaseの代わりに使うのか？</h2> <div class="sectionbody"> <div class="paragraph"> <p>移行の決定は文書化されています`AGENT.adoc`:</p> </div> <div class="paragraph"> <p>Firebaseは次の理由から選ばれています：無料プランが最適、ネイティブなFirestore、統合されたCloud Functions、Googleエコシステムに適合。既存のSupabase実装は「⚠️ 廃止済み」とマークされています。</p> </div> <div class="paragraph"> <p>無料プランを超えると、アーキテクチャ上の理由があります。このサイトはGoogleのエコシステム内に存在します：ターゲットリポジトリは`cheroliv.github.io`, CNAMEはGitHub Pagesを指します。GradleビルドはJGitを介してGitHubにプッシュされます。サードパーティ製サービス（Supabase）ではなく、Googleサービス（Firebase）を追加すると、拡散領域が削減されます。</p> </div> <div class="paragraph"> <p>Firestoreのネイティブモード（Datastoreモードではなく）は、私が頭に描いているドキュメント指向NoSQLのメンタルモデルにも近いです：コレクション、ドキュメント、型付きフィールド、サーバータイムスタンプ、組み込まれたセキュリティルール。</p> </div> </div> </div> <div class="sect1"> <h2 id="_フェーズ_1_firebase_プロジェクトを作成">フェーズ 1 : Firebase プロジェクトを作成</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_初期化">初期化</h3> <div class="paragraph"> <p>私のマシンに Firebase CLI がインストールされていないため、ウェブコンソールを使用しています：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>移動するhttps://console.firebase.google.com/[Firebase コンソール]</p> </li> <li> <p>プロジェクトを作成`cheroliv-contact`(または既存のプロジェクトを再利用する)</p> </li> <li> <p>Firestoreをネイティブモードで有効にする（Datastoreではない）</p> </li> <li> <p>地域でデータベースを作成`eur3`(ヨーロッパ)</p> </li> </ol> </div> <div class="paragraph"> <p>私たちのようにミニマリストな使い方（単一のコレクション、パブリックライティング）の場合、ネイティブモードが適切です。Datastoreの複雑なルールは必要ありません。</p> </div> </div> <div class="sect2"> <h3 id="_firestoreセキュリティルール">Firestoreセキュリティルール</h3> <div class="paragraph"> <p>フォームは公開されています — だれでもメッセージを送信できます。ただし、悪用を制限したいと思っています：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">rules_version = '2'; service cloud.firestore { match /databases/{database}/documents { match /contact_messages/{messageId} { // Lecture : admin uniquement (authentifié) allow read: if request.auth != null; // Écriture : publique, mais limitée allow create: if request.auth == null && request.resource.data.name is string && request.resource.data.name.size() >= 1 && request.resource.data.name.size() <= 100 && request.resource.data.email is string && request.resource.data.email.matches('.*@.*\\..*') && request.resource.data.email.size() <= 254 && request.resource.data.subject is string && request.resource.data.subject.size() >= 3 && request.resource.data.subject.size() <= 200 && request.resource.data.message is string && request.resource.data.message.size() >= 10 && request.resource.data.message.size() <= 5000 && request.resource.data.created_at == request.time && request.resource.data.user_agent is string && request.resource.data.user_agent.size() <= 500; } } }</code></pre> </div> </div> <div class="paragraph"> <p>主要ポイント：</p> </div> <div class="ulist"> <ul> <li> <p><code>allow read</code>— 認証済みのユーザーのみがメッセージを読むことができます（私、Firebase コンソール経由）</p> </li> <li> <p><code>allow create</code>— 誰でもドキュメントを作成できますが、フィールドのバリデーションがあります</p> </li> <li> <p>サーバーサイドバリデーション：最小/最大サイズ、メール形式、<code>created_at`それに対応しなければならない`request.time</code>(偽造防止)</p> </li> <li> <p>`user_agent`トレーサビリティのために送信されます（クリティカルではありませんが、便利です）</p> </li> </ul> </div> <div class="paragraph"> <p>これらのルールは単純なものよりも厳格です`allow write: if true;`. それらは攻撃者が巨大なペイロードや不正なフィールドを注入するのを防ぎます。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_フェーズ_2_提出のjavascriptを書き直す">フェーズ 2: 提出のJavaScriptを書き直す</h2> <div class="sectionbody"> <div class="paragraph"> <p>契約はシンプルです：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>フォームのデータを読み込む</p> </li> <li> <p>honeypot (フィールド)を確認する`hp_name`— それが埋められているなら、それはボットで、何も送信せずに成功をシミュレートする)</p> </li> <li> <p>呼ぶ`addDoc(window.<em>FIREBASE</em>.collection(db, "contact_messages"), {…​})`</p> </li> <li> <p>成功またはエラーを表示</p> </li> </ol> </div> <div class="sect2"> <h3 id="_依存関係_window_firebase">依存関係 `window.<em>FIREBASE</em></h3> <div class="paragraph"> <p>中`footer.thyme`, モジュールスクリプトがFirebase SDKを初期化し、グローバルオブジェクトを公開します：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><script type="module"> import { initializeApp } from "https://www.gstatic.com/firebasejs/11.6.0/firebase-app.js"; import { getFirestore, collection, addDoc, serverTimestamp } from "https://www.gstatic.com/firebasejs/11.6.0/firebase-firestore.js"; const firebaseConfig = { /* valeurs réelles */ }; const app = initializeApp(firebaseConfig); const db = getFirestore(app); window.__FIREBASE__ = { db, collection, addDoc, serverTimestamp }; </script></code></pre> </div> </div> <div class="paragraph"> <p>モジュールスクリプトは前に実行されます`DOMContentLoaded`, それで`window.<em>FIREBASE</em>`はハンドラーのとき利用可能であることが保証されます`contact.js`トリガーされます。念のため、5秒間隔のポーリングを追加します。 CDNが遅い場合に備えて。</p> </div> </div> <div class="sect2"> <h3 id="_新しい_contact_js">新しい `contact.js</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">document.addEventListener('DOMContentLoaded', function () { 'use strict'; const form = document.getElementById('contact-form'); if (!form) return; const submitButton = form.querySelector('button[type="submit"]'); const successMessage = document.getElementById('contact-success-message'); const errorMessage = document.getElementById('contact-error-message'); // Éléments de validation const nameInput = form.querySelector('input[name="name"]'); const emailInput = form.querySelector('input[name="email"]'); const phoneInput = form.querySelector('input[name="phone"]'); const subjectInput = form.querySelector('input[name="subject"]'); const messageInput = form.querySelector('textarea[name="message"]'); const honeypotInput = form.querySelector('input[name="hp_name"]'); /** * Attend que window.__FIREBASE__ soit disponible. * Timeout de 5 secondes — si le CDN Firebase est lent, on abandonne. */ function waitForFirebase(timeoutMs = 5000) { return new Promise((resolve, reject) => { if (window.__FIREBASE__) { resolve(window.__FIREBASE__); return; } const start = Date.now(); const interval = setInterval(() => { if (window.__FIREBASE__) { clearInterval(interval); resolve(window.__FIREBASE__); } else if (Date.now() - start > timeoutMs) { clearInterval(interval); reject(new Error('Firebase SDK non disponible après timeout')); } }, 100); }); } // --- Validation (identique à l'existant) --- function validateForm() { nameInput.setCustomValidity(''); emailInput.setCustomValidity(''); if (phoneInput) phoneInput.setCustomValidity(''); subjectInput.setCustomValidity(''); messageInput.setCustomValidity(''); if (nameInput.value.trim().length < 1) { nameInput.setCustomValidity('Veuillez saisir votre nom.'); } const emailPattern = /^[^\s@]+@[^\s@]+\.[^\s@]+$/; if (!emailPattern.test(emailInput.value.trim())) { emailInput.setCustomValidity('Veuillez saisir une adresse email valide.'); } if (phoneInput && phoneInput.value.trim() !== '') { const phonePattern = /^\d{10,15}$/; if (!phonePattern.test(phoneInput.value.trim())) { phoneInput.setCustomValidity('Veuillez saisir un numéro valide (10 à 15 chiffres).'); } } if (subjectInput.value.trim().length < 3) { subjectInput.setCustomValidity('Veuillez saisir un sujet (3 caractères minimum).'); } if (messageInput.value.trim().length < 10) { messageInput.setCustomValidity('Veuillez saisir un message (10 caractères minimum).'); } form.classList.add('was-validated'); return form.checkValidity(); } // --- Handler de soumission --- form.addEventListener('submit', async function (event) { event.preventDefault(); event.stopPropagation(); if (!validateForm()) return; // Honeypot : si rempli, simuler un succès sans rien envoyer if (honeypotInput && honeypotInput.value.trim() !== '') { successMessage.style.display = 'block'; form.reset(); form.classList.remove('was-validated'); return; } // UI : état d'envoi submitButton.disabled = true; submitButton.innerHTML = ` <span class="spinner-border spinner-border-sm" role="status" aria-hidden="true"></span> Envoi en cours... `; successMessage.style.display = 'none'; errorMessage.style.display = 'none'; try { const fb = await waitForFirebase(); const messagesCollection = fb.collection(fb.db, 'contact_messages'); await fb.addDoc(messagesCollection, { name: nameInput.value.trim(), email: emailInput.value.trim(), phone: phoneInput ? phoneInput.value.trim() : '', subject: subjectInput.value.trim(), message: messageInput.value.trim(), created_at: fb.serverTimestamp(), user_agent: navigator.userAgent.substring(0, 500) }); successMessage.style.display = 'block'; form.reset(); form.classList.remove('was-validated'); } catch (error) { console.error('Erreur Firestore:', error); errorMessage.style.display = 'block'; } finally { submitButton.disabled = false; submitButton.innerHTML = ` <i class="bi bi-send me-2"></i> Envoyer le Message `; } }, false); });</code></pre> </div> </div> <div class="paragraph"> <p>モックとの変更点:</p> </div> <div class="ulist"> <ul> <li> <p><code>waitForFirebase()</code>— タイムアウト付きポーリング、CDNが遅くても堅牢</p> </li> <li> <p><code>honeypot</code>— もし隠しフィールドの場合`hp_name`満たされており、Firestoreの成功を偽装している。ボットは成功したと思っているが、何も保存されていない。</p> </li> <li> <p><code>addDoc(collection, {…​})</code>— 本当のFirestore呼び出しと`serverTimestamp()` et <code>user_agent</code></p> </li> <li> <p>エラー処理と`try/catch`非同期</p> </li> <li> <p>掃除の`finally`(ボタンの復元)</p> </li> </ul> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p>なぜ`user_agent`? オプションですが、診断に役立ちます。変なメッセージが届いたとき、それがデスクトップブラウザ、モバイル、またはcurlスクリプトから来ているかを知ると、振り分けに役立ちます。</p> </div> </td> </tr> </table> </div> </div> </div> </div> <div class="sect1"> <h2 id="_phase_3_supabaseのデッドコードをクリーンアップ">Phase 3 : Supabaseのデッドコードをクリーンアップ</h2> <div class="sectionbody"> <div class="paragraph"> <p>`script.js`250行のデッドコードが含まれています：</p> </div> <div class="ulist"> <ul> <li> <p><code>SupabaseManager</code>(417-481行) — 65行</p> </li> <li> <p><code>ContactFormHandler</code>(490-551行) — 62行</p> </li> <li> <p>初期化ブロック (行 645-654) — 10 行</p> </li> </ul> </div> <div class="paragraph"> <p>合計：約140行を削除</p> </div> <div class="paragraph"> <p>ブロック`DOMContentLoaded`作る`SupabaseManager`それから一つ`ContactFormHandler`フォームに付随して。上記のように説明した通り、このコードは決して実行されません(ブロックされている`contact.js`), たとえ実行されたとしても、失敗します（Supabase SDKがロードされていません）。</p> </div> <div class="paragraph"> <p>�削除します:</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>クラス`SupabaseManager`</p> </li> <li> <p>クラス`ContactFormHandler`</p> </li> <li> <p>初期化ブロックの中`DOMContentLoaded`(645-654行)</p> </li> </ol> </div> <div class="paragraph"> <p>Le reste de <code>script.js`は無傷です：`ThemeManager</code>, <code>ScrollToTopButton</code>, <code>MobileMenuManager</code>, <code>SmoothScrollWithOffset</code>, <code>NavbarHeightUpdater</code>, <code>DynamicNavbarBreakpoint</code>, <code>CodeBlockManager</code>, <code>TooltipManager</code>, <code>PhoneInputManager</code>.</p> </div> </div> </div> <div class="sect1"> <h2 id="_フェーズ_4_フッターを設定する">フェーズ 4: フッターを設定する</h2> <div class="sectionbody"> <div class="paragraph"> <p>`footer.thyme`既にFirebaseのボイラープレートがありますが、プレースホルダー値のため、私は置き換えます：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">const firebaseConfig = { apiKey: "REMPLACER_PAR_VOTRE_API_KEY", authDomain: "REMPLACER_PAR_VOTRE_AUTH_DOMAIN", projectId: "REMPLACER_PAR_VOTRE_PROJECT_ID", storageBucket: "REMPLACER_PAR_VOTRE_STORAGE_BUCKET", messagingSenderId: "REMPLACER_PAR_VOTRE_SENDER_ID", appId: "REMPLACER_PAR_VOTRE_APP_ID" };</code></pre> </div> </div> <div class="paragraph"> <p>取得された実際の値から<strong>プロジェクト設定 > 一般 > あなたのアプリ > Webアプリ</strong>Firebase コンソール内で。</p> </div> <div class="paragraph"> <p>値は敏感です`apiKey`Firebaseでは設計上公開されていますが、私はプレーンテキストでコミットするのを好みません)。私はそれらを保存しています`site.yml`(既に 中に`.gitignore`) とプラグイン`bakery`ビルド側に追加するロジックを使って、テンプレートにそれらを注入します。</p> </div> <div class="paragraph"> <p>今のところ、それをそのまま中に入れています`footer.thyme`— ビルド`./gradlew serve`それらはローカルで読み込まれます。デプロイ時に、インジェクションを移行します。`site.yml`または Gradle変数へ</p> </div> <div class="admonitionblock warning"> <table> <tr> <td class="icon"> <i class="fa icon-warning" title="Warning"></i> </td> <td class="content"> <div class="paragraph"> <p>L'`apiKey`Firebaseは<strong>ない</strong>秘密です。設計上公開されています。あなたのデータを保護するものは<strong>Firestore のセキュリティ ルール</strong>, APIキーではありません。 これに入れないで`.env`サーバーサイドで読み込まれ — ブラウザに公開することを意図しています。</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_フェーズ_5_最終アーキテクチャ">フェーズ 5 : 最終アーキテクチャ</h2> <div class="sectionbody"> <div id="diag-after" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE title 最終アーキテクチャ — Firebaseお問い合わせフォーム actor Utilisateur as USER package "ブラウザ" #E8F5E9 { rectangle "contact.thyme\n(HTML, honeypot)" as FORM rectangle "contact.js\n(validation + Firestore)" as CONT rectangle "footer.thyme\n(Firebase SDK 初期化)" as FOOT } cloud "ファイアベース" #BBDEFB { rectangle "Firestore\n(連絡メッセージ)" as FS } FORM --> CONT : submit event CONT --> FOOT : window.__FIREBASE__.addDoc() FOOT --> FS : Insert document\n(règles de sécurité validées) note right of FS Firestore Rules : - create: public, validé - read: auth uniquement end note @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_この移行がドッグフーディングについて何を言っているか">この移行がドッグフーディングについて何を言っているか</h2> <div class="sectionbody"> <div class="paragraph"> <p>このサイトは、私の独自のGradleプラグインで生成されます。<code>bakery</code>. コンタクトフォームはサイト内に存在します。 Supabase → Firebase への移行はドキュメント化されています。<code>AGENT.adoc</code>, バックログで議論され、経由でテストされています`./gradlew serve`, そして、それはブログ記事を生成します（あなたが今読んでいるものです）。</p> </div> <div class="paragraph"> <p>これは純粋なドッグフーディングです。サイトはプラグインの製品であり、プラグインは開発者の製品であり、開発者はサイト自身でプロセスを文書化しています。</p> </div> <div class="paragraph"> <p>一周回った。</p> </div> <div class="paragraph"> <p>何ヶ月もモックを抱え続けていたこと（フォームが黙って嘘をつく、まるまる一日のセッションが続いたこと）が、私にあることに気づかせた。個人の静的サイトのバックログは決して「終わる」ものではない。常に優先されるユーザーストーリーがあり、常にドラフトの記事があり、常にテンプレート内にコメントアウトされたセクションがある。規律とは、すべてを終わらせることではなく、ユーザーに見えるものを終わらせることである。</p> </div> <div class="paragraph"> <p>�壊れたお問い合わせフォームは、フォームがないよりも悪い。それは守られなかった約束だ。</p> </div> <div class="sect2"> <h3 id="_変更のまとめ">変更のまとめ</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6676%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ファイル</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">変更</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">インパクト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>blog/2026/0113_*.adoc</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">記事の作成</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ドキュメンテーション</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>assets/js/contact.js</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">書き換え(モック→実際のFirestore)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">機能的</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>assets/js/script.js</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">SupabaseManager + ContactFormHandler + init bloc の削除</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�掃除</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>templates/footer.thyme</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">設定プレースホルダーの置換 → 実際の値</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">構成</p></td> </tr> </tbody> </table> </div> </div> </div> <div class="sect1"> <h2 id="_次のステップ_バックログ">次のステップ (バックログ)</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><strong>通知メール</strong>: 一つのクラウドファンクション`onCreate`の上に`contact_messages`SendGrid を介してメールを送信します。フォームはデータを保存しますが、私は通知を受けません。優先度は中 — メッセージは Firebase コンソールで表示されます。</p> </li> <li> <p><strong>クライアント側レート制限</strong>: localStorageにタイムスタンプを追加して、連続した複数の送信を防ぎます。ハニーポットは初心者ボットをブロックし、レートリミッターはやや賢いボットをブロックします。</p> </li> <li> <p><strong>テスト</strong>: フォームを送信し、ドキュメントがFirestoreに表示されることを確認するPlaywrightのテスト。現在、手動でテストしています via`./gradlew serve`。</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_参考文献">参考文献</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="https://firebase.google.com/docs/firestore/security/get-started">Firestore セキュリティルール ドキュメント</a></p> </li> <li> <p><a href="https://firebase.google.com/docs/firestore/manage-data/add-data#add_a_document">Firestore addDoc ドキュメント — Web v9 モジュール</a></p> </li> <li> <p><a href="/blog/2026/0108_gouvernance_agent_opencode_eager_lazy_post.html">エージェントガバナンスシリーズ — 第1部: Eager/Lazy</a></p> </li> <li> <p><a href="/blog/2026/0110_mecanisme_backup_contexte_agent_post.html">エージェントガバナンスシリーズ — 第2部: ホット/ウォーム/コールド</a></p> </li> <li> <p><a href="/blog/2026/0111_audit_contexte_agent_post.html">エージェントガバナンスシリーズ — パート3：監査</a></p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2026/0112_comparaison_kimi_glm_deepseek_long_contexte_plugin_gradle_opencode_post.html Tue, 28 Apr 2026 00:00:00 +0000 blog/2026/0112_comparaison_kimi_glm_deepseek_long_contexte_plugin_gradle_opencode_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_コンテキストテストベンチではなく建設現場">コンテキスト：テストベンチではなく、建設現場</a></li> <li><a href="#_私のテスト環境">私のテスト環境</a></li> <li><a href="#_評価グリッド">評価グリッド</a></li> <li><a href="#_round_1_kimi_k2_6偽のスタート">Round 1: Kimi K2.6—偽のスタート</a> <ul class="sectlevel2"> <li><a href="#_第9回好転">第9回：好転</a></li> <li><a href="#_セッション_10_静かな難破">セッション 10 : 静かな難破</a></li> </ul> </li> <li><a href="#_ラウンド_2_glm_5_1_名誉の戦士">ラウンド 2 : GLM-5.1 — 名誉の戦士</a> <ul class="sectlevel2"> <li><a href="#_アーキテクチャdsa対純粋mla">アーキテクチャ：DSA対純粋MLA</a></li> <li><a href="#_セッション11_13_堅実だがフラストレーションがたまる">セッション11-13: 堅実だがフラストレーションがたまる</a></li> </ul> </li> <li><a href="#_round_3_deepseek_v4_pro_戦争の機械">Round 3 : DeepSeek-V4-Pro — 戦争の機械</a> <ul class="sectlevel2"> <li><a href="#_アーキテクチャ_csa_hca_ダブルネット">アーキテクチャ: CSA + HCA, ダブルネット</a></li> <li><a href="#_セッション1_8安堵">セッション1-8：安堵</a></li> <li><a href="#_決定的なテスト100kトークンのリファクタリング">決定的なテスト：100Kトークンのリファクタリング</a></li> </ul> </li> <li><a href="#_フェイストゥフェイス_比較メトリクス">フェイス・トゥ・フェイス : 比較メトリクス</a></li> <li><a href="#_なぜdeepseek_v4_proはソフトウェア開発で勝つのか">なぜDeepSeek-V4-Proはソフトウェア開発で勝つのか</a> <ul class="sectlevel2"> <li><a href="#_1_csahca_アーキテクチャはコードに最適化されています">1. CSA+HCA アーキテクチャはコードに最適化されています</a></li> <li><a href="#_2_eagerコンテキストは彼彼女の快適ゾーン">2. EAGERコンテキストは彼/彼女の快適ゾーン</a></li> <li><a href="#_3_品質遅延比はフローに最適だ">3. 品質/遅延比はフローに最適だ</a></li> </ul> </li> <li><a href="#_学んだ教訓_vibe_codingのためのllmの選び方">学んだ教訓 : Vibe CodingのためのLLMの選び方</a></li> <li><a href="#_エージェントガバナンスはこの中でどうなの">エージェントガバナンスはこの中でどうなの？</a></li> <li><a href="#_技術的な情報源">技術的な情報源</a></li> <li><a href="#_結論職人の選択">結論：職人の選択</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 18 minutes</div> <p>LLMの戦いは開発者のターミナルでも行われます。学術的な無意味なベンチマークではなく。実際の現場では：30,000トークンのプロンプト、AsciiDocで書かれたエージェントガバナンス、デバッグが必要なGradle Kotlin DSLプラグイン、そして3週間続くセッションが連続してあります。あなたのためにDeepSeek-V4-Pro、Kimi K2.6、GLM-5.1をテストしました。ここに結論があり、技術的証拠によって裏付けられています。</p> </div> <div class="dlist"> <dl> <dt class="hdlist1">トック</dt> <dd> <p></think></p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_コンテキストテストベンチではなく建設現場">コンテキスト：テストベンチではなく、建設現場</h2> <div class="sectionbody"> <div class="paragraph"> <p>3週間前、私はそれに取り組んでいた`codebase-gradle`私のメタビルドシステムは、4つのプロジェクト（PlantUML用READMEジェネレーター、AsciiDocスライドビルダー、静的JBakeサイト、LLMチャットボット）のYAML設定を一元管理します。Opencodeエージェントは、AsciiDocで記述された私のエージェントファイルメソッドに従い、各セッション開始時に約30KトークンのEAGERコンテキストをロードしていました—絶対的ルール、バックログ、過去10セッションの履歴。</p> </div> <div class="paragraph"> <p>それがこの場所で、私は三つのモデルと対峙した：</p> </div> <div class="ulist"> <ul> <li> <p><strong>Kimi K2.6</strong>(Moonshot AI, 1T パラメータ / 32B アクティベート済み, 256K コンテキスト最大, MLA) - <strong>GLM-5.1</strong>(Zhipu AI/Tsinghua, 744B params / DSA, 200K 最大コンテキスト) - <strong>DeepSeek-V4-Pro</strong>(DeepSeek, 1.6T パラメータ / 49B アクティベート済み, 1M コンテキスト 最大, CSA+HCA)</p> </li> </ul> </div> <div class="paragraph"> <p>すべてクラウドサーバーの Ollama を介して提供され、すべて思考モード（考察フェーズが有効）で動作します。課題は、正しいコードを生成し、長時間のセッションで一貫性を保ち、コンテキストが 80K トークンを超えたときに幻覚を起こさないことです。</p> </div> </div> </div> <div class="sect1"> <h2 id="_私のテスト環境">私のテスト環境</h2> <div class="sectionbody"> <div id="diag-dev-env" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center skinparam wrapWidth 220 title テスト環境 — Opencode セッション × 3 LLMs left to right direction package "🖥️開発者用ターミナル" #E8F5E9 { rectangle "AGENT.adoc\n(ルール, バックログ)" as AG rectangle "PROMPT_REPRISE\n(ミッション)" as PR rectangle "INDEX.adoc (ロードマップ)" as IDX } package "�☁️ Ollama クラウド" #BBDEFB { rectangle "DeepSeek-V4-Pro\n1.6T / CSA+HCA" as DV4 rectangle "Kimi K2.6 1T / MLA" as KIMI rectangle "GLM-5.1\n744B / MLA+DSA" as GLMG } package "�⚙️ コードベース Gradle" #FFF9C4 { folder "buildSrc/" { file "codebase.kt" file "readme.kt" file "site.kt" file "slider.kt" file "snapshot.kt" } file "build.gradle.kts (947行)" file "embeds.yml" } AG --> DV4 : Sessions 1-8 ✅ AG --> KIMI : Sessions 9-10 ⚠️ AG --> GLMG : Sessions 11-13 ⚠️ DV4 --> "コードベース" : "TDD, リファクタリング,\nスナップショット" KIMI --> "コードベース" : "劣化 60Kトークンから" note bottom of GLMG Meilleur que Kimi mais latence + DSA moins robuste que CSA+HCA end note @enduml</pre> </div> </div> <div class="paragraph"> <p>各セッションは約30KトークンのEAGERコンテキストで開始されました：<code>AGENT.adoc</code>(287 行)<code>PROMPT_REPRISE.adoc</code>(51 行),<code>.agents/INDEX.adoc</code>(218行),<code>LAZY_EAGER_ESSENTIALS.adoc</code>(50 行). コンテキストはやり取りとともに急速に膨らみ — 10メッセージの典型的なセッションでは累積プロンプトに15-20K トークンが追加されました。</p> </div> </div> </div> <div class="sect1"> <h2 id="_評価グリッド">評価グリッド</h2> <div class="sectionbody"> <div class="paragraph"> <p>私は各モデルを、AI支援型ソフトウェア開発にとって重要な4つの軸で評価しました：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 10%;"> <col style="width: 10%;"> <col style="width: 10%;"> <col style="width: 10%;"> <col style="width: 10%;"> <col style="width: 10%;"> <col style="width: 10%;"> <col style="width: 10%;"> <col style="width: 10%;"> <col style="width: 10%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">�軸</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">具体的な基準</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>長い文脈の一貫性</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">エージェントは40メッセージ前に決められた規約を覚えていますか。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>生成されたコードの品質</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">コードは最初の試みでコンパイルできますか？ 既存のパターンに従っていますか？</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>建築的推論</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">エージェントは、私が再説明しなくてもモジュール間の関係を理解していますか？</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>幻覚への耐性</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">エージェントは何トークンから、存在しないAPIやクラスをでっち上げ始めるのか？</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>そして自家製の合成メトリクス : その<strong>回復係数</strong>(彼とコードを書くよりもエージェントを修正する時間がどれくらいか).</p> </div> </div> </div> <div class="sect1"> <h2 id="_round_1_kimi_k2_6偽のスタート">Round 1: Kimi K2.6—偽のスタート</h2> <div class="sectionbody"> <div class="paragraph"> <p>Kimi K2.6は私の最初の選択でした。SWE-Bench Verified (80.2)およびTerminal-Bench 2.0 (66.7)でのベンチマークは優れています。MLAアーキテクチャは長いシーケンスに対して良い効率性を約束します。</p> </div> <div class="sect2"> <h3 id="_第9回好転">第9回：好転</h3> <div class="paragraph"> <p>Kimi との最初のセッション。タスク：メソッドを実装する`resolveActiveKey()<code>中に`codebase.kt</code>— APIキー解決関数にCLIフォールバック付き。コンテキストは30Kトークンで、Kimiは素早く推論し、キーの有効期限管理を含むクリーンなコードを生成します。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">fun resolveActiveKey( cfg: CodebaseConfiguration, logger: Logger, cliProvider: String? = null, cliAccount: String? = null, cliKey: String? = null ): NamedApiKey? { // Résolution provider → compte → clé avec CLI override // Kimi a parfaitement compris la chaîne de priorité }</code></pre> </div> </div> <div class="paragraph"> <p>コードはコンパイルされます。7つのテストケースがパスします。私は楽観的です。</p> </div> </div> <div class="sect2"> <h3 id="_セッション_10_静かな難破">セッション 10 : 静かな難破</h3> <div class="paragraph"> <p>2番目のセッション。コンテキストは交換とともに~90Kトークンに増加します。Kimiに、書き込む前にシークレットを匿名化するAsciiDocスナップショットメカニズムを追加するよう依頼します。</p> </div> <div class="paragraph"> <p>ここでそれが脱線する。Kimiは存在しないクラスを考案し始める。彼は私に提案する`AnonymizedObjectMapper`— 架空のクラス。 彼は混同する`ReadmeYmlAnonymizer` et <code>CodebaseYmlAnonymizer</code>. 彼は私にインポートすることを提案します。<code>com.fasterxml.jackson.anonymize.*</code>— 存在したことのないパッケージ。</p> </div> <div class="paragraph"> <p>もっと悪いことに：彼の思考の段階で、彼が誤った前提に基づいて論理を構築しているのがわかります。彼は「思い出す」が`GitConfig`畑を持っている`anonymizedToken`— いいえ、それは`resolvedToken()<code>. 彼は…に帰する`SiteYmlAnonymizer`方法`maskSupabaseCredentials()</code>— 存在しない。</p> </div> <div class="paragraph"> <p><em><em>_ それはバグではなかった。それは一貫性の段階的な崩壊だった。まるで、コンテキストに追加される各トークンが、最初の30,000の記憶を少しずつ薄めていくかのように。 </em>_</em></p> </div> <div class="paragraph"> <p>Kimiを2セッション後に停止する。診断は明らかだ：MLAはKVキャッシュをうまく圧縮するが、細粒度のスパース選択メカニズムがないと、注意は60Kトークン以上で機械的に薄まる。各トークンは「見る」遠いコンテキストをますますうまくできなくなり — そして、ノイズで穴を埋め始める。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ラウンド_2_glm_5_1_名誉の戦士">ラウンド 2 : GLM-5.1 — 名誉の戦士</h2> <div class="sectionbody"> <div class="paragraph"> <p>GLM-5.1 は異なるアーキテクチャで登場します：ベースモデルに MLA、その後 <strong>continued pre-training</strong> を DSA (DeepSeek Sparse Attention) で行います — これは軽量なインデクサーで、動的に全履歴から関連性の高いトップ 2048 トークンを選択します。</p> </div> <div class="sect2"> <h3 id="_アーキテクチャdsa対純粋mla">アーキテクチャ：DSA対純粋MLA</h3> <div class="paragraph"> <p>違いは根本的です。Kimiが歴史を単一の潜在空間に圧縮し（その結果、関連情報を識別する能力を徐々に失うのに対し）、GLMは事後トレーニングのインデクサを接ぎ木し、明示的なスパース選択を行います。</p> </div> <div id="diag-mla-vs-dsa" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center title 注意アーキテクチャ — MLA対MLA+DSA left to right direction rectangle "**Kimi K2.6 — MLA 純粋**" as MLA #FFCDD2 { rectangle "KV Cache 完全" as KV1 rectangle "�圧縮 潜在" as CL1 rectangle "デコード 潜在空間で" as DL1 KV1 --> CL1 CL1 --> DL1 note bottom of DL1 ⚠️ Au-delà de 60K tokens : perte de discrimination end note } rectangle "GLM-5.1 — MLA + DSA" as DSA #C8E6C9 { rectangle "KV Cache 完全" as KV2 rectangle "�潜在圧縮 (MLA)" as CL2 rectangle "軽量インデクサー\n(DSA, top-k=2048)" as IL rectangle "デコード 選択されたトークン上で" as DL2 KV2 --> CL2 CL2 --> IL IL --> DL2 note bottom of DL2 ✅ "構築による無損失" Sélection explicite des tokens pertinents end note } MLA --> DSA : "ゲイン : スパース選択 希釈を避ける" @enduml</pre> </div> </div> <div class="paragraph"> <p>技術レポートは明示的に述べている：DSAは <em>"lossless by construction"</em> — それに対して、SWA（パターンサーチ）、Gated DeltaNet、SimpleGDNなどの代替手段はRULER@128Kで最大5.69ポイント損失する。</p> </div> </div> <div class="sect2"> <h3 id="_セッション11_13_堅実だがフラストレーションがたまる">セッション11-13: 堅実だがフラストレーションがたまる</h3> <div class="paragraph"> <p>GLM-5.1は距離を保つのが得意です。セッション11（約60Kトークン）では、一貫性を保っています。それは…​を生成します。`SnapshotManager`機能的で、4つの匿名化ツールの管理が正しく行われている。</p> </div> <div class="paragraph"> <p>しかし、遅延は問題です。DSAの思考フェーズは純粋なMLAよりも重く — インデクサは各ステップで履歴を再スキャンする必要があります。Kimiで8秒かかった回答が、GLMでは15秒になります。30メッセージのセッションでは、これがはっきりと感じられます。</p> </div> <div class="paragraph"> <p>そしてそこに微妙な誤りがあります。GLMはKimiのように妄想をしないが、*命名*の間違いを犯す。彼は呼ぶ`toAnonymizedYaml()<code>呼び出すべきメソッド`anonymize()</code>. 彼は逆転する`loadReadmeConfiguration()` et <code>loadCodebaseConfiguration()`の 中`renderFileSection()</code>. これは幻覚ではなく、表面的な混同です — ただし本番環境では、表面的な混同がビルドを壊すことがあります。</p> </div> <div class="paragraph"> <p>GLMと3回のセッションを行った。それはKimiよりも間違いなく優れている。しかし、命名の詳細に関する手動修正を3回行うのは疲れる。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_round_3_deepseek_v4_pro_戦争の機械">Round 3 : DeepSeek-V4-Pro — 戦争の機械</h2> <div class="sectionbody"> <div class="paragraph"> <p>DeepSeek-V4-Pro は、3 つの中で最も野心的なアーキテクチャを備えています：補完的な 2 つの注意機構を組み合わせたハイブリッド システムです。</p> </div> <div class="sect2"> <h3 id="_アーキテクチャ_csa_hca_ダブルネット">アーキテクチャ: CSA + HCA, ダブルネット</h3> <div id="diag-csa-hca" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center skinparam wrapWidth 180 title DeepSeek-V4-Pro — ハイブリッドアーキテクチャ CSA + HCA left to right direction rectangle "KV Cache 1M トークン" as KV #E3F2FD rectangle "CSA 圧縮スパースアテンション" as CSA #C8E6C9 { rectangle "圧縮 m トークン → 1" as CC rectangle "スパース アテンション (DSA, トップk)" as SA CC --> SA note bottom of SA Attention locale fine + sélection sparse end note } rectangle "HCA 大幅に圧縮された注意" as HCA #BBDEFB { rectangle "極限の圧縮 m' >> m → 1" as ECC rectangle "密な注意\n残存" as EDA ECC --> EDA note bottom of EDA Contexte global + connexions longue distance end note } rectangle "ハイブリッド フュージョン" as FUSION #FFF9C4 rectangle "復号 コヒーレント" as DEC #FFE0B2 KV --> CSA : Précision locale KV --> HCA : Vision globale CSA --> FUSION HCA --> FUSION FUSION --> DEC @enduml</pre> </div> </div> <div class="paragraph"> <p>2レベルの圧縮、2段階の注意の粒度：</p> </div> <div class="ulist"> <ul> <li> <p><strong>CSA</strong>KVキャッシュを圧縮するごとに`m`tokens、続いてDeepSeek Sparse Attention（スパースアテンション）を適用します — 圧縮された入力のうちトップkのみが参照されます。正確、局所的、効率的。 - <strong>HCA</strong>: 極端な圧縮 (因子`m'`ずっと大きい`m`), しかし、圧縮された残渣に対して密な注意を払い — 二次的な爆発を引き起こさずにグローバルな接続を維持する。</p> </li> </ul> </div> <div class="paragraph"> <p>結果: 1Mトークンあたり、DeepSeek-V4-Proは消費するのは～だけ<strong>27%の推論FLOPs</strong> et <strong>10% の KV キャッシュのサイズ</strong>DeepSeek-V3.2 と比較した場合の、以前のモデル。</p> </div> <div class="paragraph"> <p>特に、技術レポート（図9）は発表しています： `Retrieval performance remains highly stable within a 128K context window.</p> </div> </div> <div class="sect2"> <h3 id="_セッション1_8安堵">セッション1-8：安堵</h3> <div class="paragraph"> <p>私はDeepSeek-V4-Proとともに8回のセッションを過ごしました`codebase-gradle`. 8回のセッションで、幻覚ひとつもなく、でっち上げたクラスひとつもなく、命名の混乱ひとつもなく。</p> </div> <div class="paragraph"> <p>セッション 1 : 実装`CodebaseYmlConfig` et <code>CodebaseYmlAnonymizer</code>. 350行のKotlin、インラインテスト、すべてコンパイル。セッション4：追加`SnapshotManager`ツリービュー, ファイルの収集, ファイルごとのAsciiDocレンダリング。 279行、ゼロエラー。 セッション7: デバッグの`renderFileSection()`4種類の異なる匿名化ツールを解決における曖昧さなく管理しなければならなかった。3つのメッセージで解決した。</p> </div> <div class="paragraph"> <p>レイテンシはよりも高い <code>Kimi</code> — 思考モードでの1回の回答あたり約10〜12秒。ただし、修正率はほぼゼロ。私はエージェントのミスを直すために時間を費やしていません。私は彼と <strong>とともに</strong> コードを書いています。</p> </div> </div> <div class="sect2"> <h3 id="_決定的なテスト100kトークンのリファクタリング">決定的なテスト：100Kトークンのリファクタリング</h3> <div class="paragraph"> <p>セッション8では、累積コンテキストが100Kトークンを超えます。私は重いリファクタリングを要求します：インライン検証の4つのタスクを抽出するの`build.gradle.kts`JUnit5テストファイルへ向かって`buildSrc/src/test/`.</p> </div> <div class="paragraph"> <p>エージェントは、3段階の計画を提案しています：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>既存のケースを移行してテストクラスを作成</p> </li> <li> <p>JUnit5およびKotestの依存関係を追加する`buildSrc/build.gradle.kts`</p> </li> <li> <p>インラインコードを削除する`build.gradle.kts`</p> </li> </ol> </div> <div class="paragraph"> <p>プランは正しい。実行はきれいだ。さらに私が見逃していたエッジケースも特定している：Jackson の依存関係が重複している部分の間で`buildscript {}` et `buildSrc/build.gradle.kts`移行中に統一しなければならないもの</p> </div> <div class="paragraph"> <p>100K トークンのコンテキスト、そしてエージェントは思い出すが`CodebaseYmlAnonymizer.TOKEN_MASK`です`"<strong>*</strong>"`, が`GitConfig.resolvedToken()<code>は 拡張関数 が 定義されている`readme.kt</code>、そしてそれが`SnapshotManager.PRUNED_DIRS`除外する`build`, <code>.gradle</code> et <code>.git</code>。</p> </div> <div class="paragraph"> <p>それが違いです。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_フェイストゥフェイス_比較メトリクス">フェイス・トゥ・フェイス : 比較メトリクス</h2> <div class="sectionbody"> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 25%;"> <col style="width: 25%;"> <col style="width: 25%;"> <col style="width: 25%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">基準</th> <th class="tableblock halign-left valign-top">キミ K2.6</th> <th class="tableblock halign-left valign-top">GLM-5.1</th> <th class="tableblock halign-left valign-top">DeepSeek-V4-Pro</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">最大のコンテキスト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">256K</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">200K</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">1M</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">注意メカニズム</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">MLA純</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">MLA + DSA</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">CSA + HCA ハイブリッド</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">総パラメータ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">1T</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">744B</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">1.6T</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">有効な設定</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">32B</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">未公開</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">49B</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">観測された劣化しきい値</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">~60K tokens</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">~120K tokens</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">~128K tokens</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">先の振る舞い</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">大量の幻覚</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">表面の混乱</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ゆっくりとした進行的な劣化</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">安定性 NIAH</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">未公開</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">100% @128K (DSA)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">128K まで安定 (図 9)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">MRCR @128K</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">未公開</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">未公開</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Gemini 3.1 Proより優れている</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">放棄前に開催されたセッション</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">8 (そして続く)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">修正時間 / コード時間</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">60%</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">30%</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><5%</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">平均レイテンシ (思考モード)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">8 s</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">15 s</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">11 s</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">信頼係数*</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">2/10</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">6/10</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">9/10</p></td> </tr> </tbody> </table> <div class="paragraph"> <p><em>*信頼係数 = 主観的な私のエージェントのコードを取り込み、コミットする能力の尺度であり、行ごとのレビューなし。</em></p> </div> <div id="diag-radar" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center title レーダー比較 — 3 LLMによる支援ソフトウェア開発 legend right |= Couleur |= Modèle | | <#FF5252> | Kimi K2.6 | | <#FFC107> | GLM-5.1 | | <#4CAF50> | DeepSeek-V4-Pro | endlegend rectangle " " as space #FFFFFF rectangle "一貫性 80K+ トークン" as coh #F5F5F5 rectangle "品質 コード" as qual #F5F5F5 rectangle "建築的思考" as arch #F5F5F5 rectangle "抵抗 幻覚" as hall #F5F5F5 rectangle "速度 (開発経験)" as speed #F5F5F5 rectangle "知�識 Gradle/Kotlin" as kg #F5F5F5 rectangle "修正の\n率" as corr #F5F5F5 coh --> qual qual --> arch arch --> hall hall --> speed speed --> kg kg --> corr note top of coh Kimi ████░░░░░░ 4/10 GLM ██████░░░░ 6/10 DeepSeek █████████░ 9/10 end note note top of qual Kimi ███████░░░ 7/10 (sous 60K) GLM ████████░░ 8/10 DeepSeek █████████░ 9/10 end note note top of arch Kimi █████░░░░░ 5/10 GLM ███████░░░ 7/10 DeepSeek █████████░ 9/10 end note note top of hall Kimi ██████░░░░ 6/10 → ██░░░░░░░░ 2/10 (> 60K) GLM ███████░░░ 7/10 DeepSeek █████████░ 9/10 end note note top of speed Kimi █████████░ 9/10 GLM ██████░░░░ 6/10 DeepSeek █████░░░░░ 5/10 end note note top of kg Kimi ███████░░░ 7/10 GLM ███████░░░ 7/10 DeepSeek █████████░ 9/10 end note note top of corr Kimi ██░░░░░░░░ 2/10 (beaucoup de corrections) GLM █████░░░░░ 5/10 DeepSeek ██████████ 10/10 (presque rien à corriger) end note @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_なぜdeepseek_v4_proはソフトウェア開発で勝つのか">なぜDeepSeek-V4-Proはソフトウェア開発で勝つのか</h2> <div class="sectionbody"> <div class="paragraph"> <p>DeepSeek-V4-Proの優位性は単一の要因によるものではなく — 収束である：</p> </div> <div class="sect2"> <h3 id="_1_csahca_アーキテクチャはコードに最適化されています">1. CSA+HCA アーキテクチャはコードに最適化されています</h3> <div class="paragraph"> <p>支援されたソフトウェア開発は、長文脈注意のための*極端*なユースケースです。必要なもの： - ローカルな精度 (このクラスは何を継承しているのか？このメソッドはどこで定義されているのか？) →<strong>放送監視委員会</strong> - 全体像（このモジュールはなぜ存在するのか？四つの匿名化ツールはどのように連携するのか？） →<strong>HCA</strong></p> </div> <div class="paragraph"> <p>Kimi と MLA だけは局所的な精度を管理するが、60K を超えると全体像を見失う。GLM と DSA は全体像を改善するが、単一レベルのままである。DeepSeek は両方を明示的に組み合わせる。</p> </div> </div> <div class="sect2"> <h3 id="_2_eagerコンテキストは彼彼女の快適ゾーン">2. EAGERコンテキストは彼/彼女の快適ゾーン</h3> <div class="paragraph"> <p>私のガバナンスシステムは起動時に約30Kトークンのルールとバックログを読み込みます。128Kまでの安定したウィンドウがあるため、DeepSeekはセッションの交換に約100Kトークンの余裕があります。これは、Kimiが劣化なく処理できる量の3〜4倍です。</p> </div> <div class="paragraph"> <p><em>__</em> 128Kの完璧な安定性ウィンドウは、私のニーズに正確に合っています：EAGERが30K＋交換が70K＝20〜30メッセージの生産的なセッションで、決してグリーンゾーンから外れません。 (empty)</p> </div> </div> <div class="sect2"> <h3 id="_3_品質遅延比はフローに最適だ">3. 品質/遅延比はフローに最適だ</h3> <div class="paragraph"> <p>はい、DeepSeek-V4-ProはKimiより遅いです（11s vs 8s）。しかし、<strong>total</strong> タスクの時間はずっと短いです。なぜなら、エージェントの幻覚を修正するために20分を費やさないからです。</p> </div> <div class="paragraph"> <p>開発者は回答のレイテンシを測定しない。開発者は「質問を投げる」のと「コードが自分のリポジトリにあり動作する」の間の時間を測定する。この指標では、DeepSeek-V4-Proが3つの中で最も速い。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_学んだ教訓_vibe_codingのためのllmの選び方">学んだ教訓 : Vibe CodingのためのLLMの選び方</h2> <div class="sectionbody"> <div class="paragraph"> <p>一時的なランキングを超えて、この経験から、ベンチマークには記載されていない基準で、LLMをソフトウェア開発支援のために評価する方法を学びました。</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>アーキテクチャを見て、発表されたコンテキストサイズを見ないで。</strong>— 256Kのコンテキストを謳っているがMLAしか持っていないモデルは、Kimiのようになる：理論的には能力があるが、実際には60Kを超えると使い物にならない。</p> </li> <li> <p><strong>あなたのコンテキストでテストしてください、汎用的なベンチマークではなく</strong>— 私の30Kトークンの初期AsciiDocプロンプトは、絶対ルールとバックログを含んでおり、HLEまたはAIMEの質問とは関係ありません。</p> </li> <li> <p><strong>レイテンシーは、品質がついてくる限り敵ではない</strong>— 正しいコードを生成する遅いモデルは、間違ったコードを生成する速いモデルよりも速い。</p> </li> <li> <p><strong>公開された技術報告書がないモデルには注意しろ</strong>チームが注意アーキテクチャをドキュメントしないのは、長いコンテキストでのパフォーマンスへの自信がないからだ。</p> </li> </ol> </div> <div id="diag-decision-tree" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center skinparam wrapWidth 260 title 意思決定木 — 開発支援のためのLLMの選び方 start :Contexte initial\n> 20K tokens ?; if (Oui) then :Architecture d'attention\nhybride ou multi-niveau ?; if (CSA+HCA) then :DeepSeek-V4-Pro Fenetre stable 128K Ideal pour gouvernance EAGER; stop elseif (MLA + DSA) then :GLM-5.1 Correct jusqu'a ~120K Latence elevee; stop else (MLA seul) :Kimi K2.6 (sessions courtes) ou eviter pour long contexte Chercher un modele avec sparse attention; stop endif else (Contexte < 20K) :N'importe lequel fonctionne. Privilegier la latence.; stop endif @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_エージェントガバナンスはこの中でどうなの">エージェントガバナンスはこの中でどうなの？</h2> <div class="sectionbody"> <div class="paragraph"> <p>この経験は、私がEager/Lazyガバナンスに関する記事以来主張してきた点を裏付けます：<strong>LLMの品質とガバナンスの品質は乗法的であり、加法的ではない。</strong>。</p> </div> <div class="paragraph"> <p>Kimi K2.6 とともに、私のガバナンスは完璧だった — しかし、モデルが情報を薄めた。結果：完璧なガバナンス × ハルシネーション = ゼロ。</p> </div> <div class="paragraph"> <p>DeepSeek-V4-Pro を使用すると、EAGER ガバナンス (ルール 30K トークン) + LAZY (セッション アーカイブ、技術的参照) + Hot/Warm/Cold (ローテーション バックアップ) が組み合わさり、各層が相互に強化し合うエコシステムが形成されます。エージェントはルールを目の前に持つ (EAGER)、履歴を参照できる (LAZY)、そしてコンテキストはバックアップのローテーションにより決して飽和状態になりません。</p> </div> <div class="paragraph"> <p><em><em>_ 良いLLMがガバナンスなしでは、ハンドルのないフェラーリのエンジンのようだ。良いガバナンスが優れたLLMなしでは、エンジンのないハンドルのようだ。DeepSeek-V4-Pro + 私のガバナンスエージェント = 運転している感覚を初めて味わった瞬間だ。 </em>_</em></p> </div> <div class="paragraph"> <p>ローテーションバックアップメカニズム（10セッションごとまたは500行以上のEAGERごとにローテーション）は、128Kのコンテキストを保持できるモデルと組み合わせると真価を発揮します：アクティブな10セッションのスライドウィンドウは、コンテキストを新鮮に保ち、決して劣化ゾーンを超えることはありません。</p> </div> </div> </div> <div class="sect1"> <h2 id="_技術的な情報源">技術的な情報源</h2> <div class="sectionbody"> <div class="paragraph"> <p>私は実証的な経験を公式な技術報告書と照らし合わせて、観察結果を検証しました：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>DeepSeek-V4 Technical Report</strong> — PDF 取得元https://huggingface.co/deepseek-ai/DeepSeek-V4-Flash[ハギングフェイス]. Figure 9 : "Retrieval performance remains highly stable within a 128K context window. While a performance degradation becomes visible beyond the 128K mark, the model’s retrieval capabilities at 1M tokens remain remarkably strong." CSA+HCAアーキテクチャはセクション2.3で文書化されています。</p> </li> <li> <p><strong>GLM-5 テクニカルレポート</strong> —https://arxiv.org/abs/2602.15763[arXiv:2602.15763]. DSA は continued pre-training を通じて導入され、「構築時に損失なし」。最大コンテキスト 202,752 トークン。表 3/5/6 は、長コンテキストでの性能を代替手法（SWA、Gated DeltaNet、SimpleGDN）と比較して記録しています。</p> </li> <li> <p><strong>Kimi K2.6 モデルカード</strong> —https://huggingface.co/moonshotai/Kimi-K2.6[ハギングフェイス]. MLA、最大コンテキスト256K。エージェントタスクのしきい値を超えた discard‑all 戦略（MLA の長コンテキストにおける実用的な限界を暗示的に確認）。</p> </li> <li> <p><strong>Kimi K2 テクニカルレポート</strong> —https://arxiv.org/abs/2507.20534[arXiv:2507.20534]. MoEアーキテクチャ, MuonClipオプティマイザ, エージェント的なパフォーマンス (HLE, BrowseComp, Terminal-Bench).</p> </li> </ol> </div> <div class="paragraph"> <p>最も示唆に富む点：彼ら自身の評価において、Moonshot はコンテキストウィンドウが超過されたときに <strong>discard-all</strong> (古いコンテキストの削除) 戦略を適用します。これは私が観察したことを正確に確認します：MLA だけでは 256K のウィンドウ全体で一貫性を維持することはできません。アーキテクチャが追いついていない。</p> </div> </div> </div> <div class="sect1"> <h2 id="_結論職人の選択">結論：職人の選択</h2> <div class="sectionbody"> <div class="paragraph"> <p>3週間と13回の実際の開発セッションの後、結論は出ました：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 8.3333%;"> <col style="width: 8.3333%;"> <col style="width: 8.3333%;"> <col style="width: 8.3333%;"> <col style="width: 8.3333%;"> <col style="width: 8.3333%;"> <col style="width: 8.3333%;"> <col style="width: 8.3333%;"> <col style="width: 8.3333%;"> <col style="width: 8.3333%;"> <col style="width: 8.3333%;"> <col style="width: 8.3337%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Kimi K2.6</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">GLM-5.1</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">DeepSeek-V4-Pro</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">60K以下で優秀</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">最大120Kまで頑丈</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">どこでも支配する</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">超えては使用できない</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">表面の混乱</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">128Kまで安定</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">2 セッション、放棄</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">3セッション、放棄</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">8セッション、採択</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>DeepSeek-V4-Proは、Opencodeを使用したすべてのソフトウェア開発支援セッションにおいて、私のデフォルトのLLMになりました。それは最新だからではなく、学術的なベンチマークが最高だからでもありません。しかし、30Kトークンのエージェントコンテキストを持つGradle Kotlin DSLプラグインをプッシュする開発者の実際の業務では、コンテキストが長くなっても私を裏切らない唯一のものだからです。</p> </div> <div class="paragraph"> <p>CSA+HCA はアーキテクチャにおける <strong>game changer</strong> です。ダブルレベル圧縮 + スパース化は実装の詳細ではなく、それがコードアシスタントと信頼できるチームメイトの違いを生むものです。</p> </div> <div class="paragraph"> <p><em><em>_ 私はDeepSeek-V4-Proを選びました。なぜなら、それは3つのうちのただ一つで、私のエージェントガバナンスを防御的な制約（「エージェントが忘れないようにどうすればいいですか？」）から攻撃的な優位（「エージェントがすべてを覚えている今、何を構築できるでしょうか？」）に変えるからです。 </em>_</em></p> </div> <hr> <div class="paragraph"> <p><strong>この記事は、プロジェクトにおける実際の開発13セッションの成果です。</strong><code>codebase-gradle</code>, 文書化されている`.agents/sessions/`私のEager/Lazy/Hot/Warm/Coldエージェントのガバナンス手法によれば。引用されている技術的なソースは、HuggingFaceおよびarXivで公開アクセス可能です。*</p> </div> </div> </div> https://cheroliv.com/blog/2026/0111_audit_contexte_agent_post.html Mon, 27 Apr 2026 00:00:00 +0000 blog/2026/0111_audit_contexte_agent_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_シーン_セッション051何かがおかしい">シーン: セッション051、何かがおかしい</a></li> <li><a href="#_監査627行を詳細に調べる">監査：627行を詳細に調べる</a></li> <li><a href="#_エンジニアリングを失う恐れ">エンジニアリングを失う恐れ</a></li> <li><a href="#_解決策_split百科事典的">解決策： split百科事典的</a></li> <li><a href="#_ファイルの内容_essentials">ファイルの内容 ESSENTIALS</a></li> <li><a href="#_結果_50_の_eager_コンテキスト">結果: -50% の EAGER コンテキスト</a></li> <li><a href="#_なぜフォルダーは_encyclopediesと呼ばれるのですか">なぜフォルダーは `encyclopedies/`と呼ばれるのですか？</a></li> <li><a href="#_シリーズの論理的な続き">シリーズの論理的な続き</a></li> <li><a href="#_私が違うようにやったこと">私が違うようにやったこと</a></li> <li><a href="#_自分のコンテキストを監査するためのガイド">自分のコンテキストを監査するためのガイド</a></li> <li><a href="#_活きたガバナンス">活きたガバナンス</a></li> <li><a href="#_リンク">リンク</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 14 minutes</div> <p>あなたは完璧なエージェントガバナンスを構築するために何週間も費やしました。Eager/Lazy、セッション終了手順、ローテーションバックアップ。システムは稼働しています。ある日、エージェントが遅くなりました。応答が薄まっています。測定したところ：自動的にロードされた1414行。そして最悪なのは、原因がコードでもバックログでもセッションアーカイブでもないことです。原因は、あなたの方法をドキュメントするファイルです。</p> </div> <div class="dlist"> <dl> <dt class="hdlist1">チック</dt> <dd> <p>[]</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_シーン_セッション051何かがおかしい">シーン: セッション051、何かがおかしい</h2> <div class="sectionbody"> <div class="paragraph"> <p>2026年4月30日、16時00分。私は現在セッション中`magic-stick`, 私のLinuxライブISOのビルドプロジェクト。Opencodeエージェントは、いつものように私のEagerファイルを自動的にロードしました —<code>AGENT.adoc</code>, <code>PROMPT_REPRISE.adoc</code>, <code>.agents/INDEX.adoc</code>. すべてが正常です。</p> </div> <div class="paragraph"> <p>ただし、返答が弱い。エージェントは推論に2秒余計に時間がかかる。彼は、3つ前のメッセージで目の前にあった詳細を忘れてしまう。これはクラッシュでもエラーでもなく、ゆっくりと劣化していくようなもので、すぐに気づくようなことではない。</p> </div> <div class="paragraph"> <p>以前、セッション048で同じ経験をしました。そのとき、ガバナンスファイルの合計が5200行あることを発見しました。そこで、10セッションのスライドウィンドウを持つHot/Warm/Coldメカニズム、同じコールドウェーブ、2つのトリガーを持つセンサーを概念化しました。問題は理論的には解決しました。</p> </div> <div class="paragraph"> <p>しかし、私たちはセッション051にいます。バックアップのローテーションは正常に実行されました — EAGERファイルは2087行から500行に減りました。しかし、コンテキストはまだ重いです。何かが私にはつかめない。</p> </div> <div class="paragraph"> <p>端末を開いて、入力します :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">wc -l AGENT.adoc AGENT_MODUS_OPERANDI.adoc PROMPT_REPRISE.adoc \ .agents/INDEX.adoc .agents/SESSIONS_HISTORY.adoc \ .agents/archives/COMPLETED_TASKS_ARCHIVE_2026-04.adoc</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs"> 287 AGENT.adoc 627 AGENT_MODUS_OPERANDI.adoc 51 PROMPT_REPRISE.adoc 218 .agents/INDEX.adoc 18 .agents/SESSIONS_HISTORY.adoc 213 .agents/archives/COMPLETED_TASKS_ARCHIVE_2026-04.adoc 1414 total</code></pre> </div> </div> <div class="paragraph"> <p>1414行。バックアップローテーションが INDEX, SESSIONS_HISTORY, COMPLETED_TASKS をうまくトリムしました — これらはきれいです。しかし、部屋に象がいることに気づいていませんでした：<strong>627 行</strong>1つのファイルに。<code>AGENT_MODUS_OPERANDI.adoc</code>。</p> </div> <div class="paragraph"> <p>このファイルは、セッション1でEager/Lazy戦略を文書化するために私が書いたものです。これはこの方法のマニュアルです。そして、それだけでEAGERコンテキストの44%になりました。</p> </div> <div id="diag-before-audit" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE title コンテキスト EAGER — 1414 行 rectangle "AGENT_MODUS_OPERANDI **627 行 (44%)**" as MOD #FFCDD2 rectangle "AGENT.adoc 287 行 (20%)" as AG #BBDEFB rectangle "INDEX.adoc 218行 (15%)" as IDX #C8E6C9 rectangle "COMPLETED_TASKS 213 行 (15%)" as ARC #FFF9C4 rectangle "PROMPT_REPRISE 51 行 (4%)" as PRO #E1BEE7 rectangle "SESSIONS_HISTORY\n18行(1%)" as HIS #FFE0B2 note bottom of MOD Le fichier qui documente la méthode est devenu le plus gros poste de dépense end note @enduml</pre> </div> </div> <div class="paragraph"> <p>皮肉は完全だ。コンテキストを*節約*するために設計されたファイルが、コンテキストの主要な*消費者*になった。まるであなたの車の取扱説明書がエンジンよりも重いかのように。</p> </div> </div> </div> <div class="sect1"> <h2 id="_監査627行を詳細に調べる">監査：627行を詳細に調べる</h2> <div class="sectionbody"> <div class="paragraph"> <p>私はセクションごとに監査を行うことに決めました。削除するためではなく、*理解*するためです。EAGERにふさわしいものと、知識の損失なく他所で生きていけるものを見極めるためです。</p> </div> <div class="paragraph"> <p>ここに正確な構造があります：`AGENT_MODUS_OPERANDI.adoc`そしてそこで見つけるもの :</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2727%;"> <col style="width: 2.2739%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">セクション</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">行</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">内容</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">既に…​に存在しています。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>P1 — 概要</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">64</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">問題解決、基本原則、ダッシュボード対マニュアルの類似</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">バックティックコードスパン (<code>…​</code>) をすべてそのまま保持してください — バックティックの内容、間隔、位置を決して変更しないでください。 このテキストはより大きな文の一部である可能性があります — より多くのコンテキストを要求せずにフラグメントを翻訳してください。 翻訳されたテキストのみを出力してください — 説明も commentary も導入も代替案もオプションもありません。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>P2 — ファイル構造</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">97</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">階層構造, ロードポリシー, 何をいつロードするか</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">—</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>P3 — 絶対的なルール</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">34</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Git は禁止、破壊的なコマンドは禁止、機密情報は禁止</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>AGENT.adoc</code>+<code>INDEX.adoc</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>P4 — セッションライフサイクル</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">133</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">テンプレート オープニング, 作業ルール, セッション終了の6ステップ, チェックリスト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>AGENT.adoc</code>§セッション終了 +<code>INDEX.adoc</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>P5―メトリクスとしきい値</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">49</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">理想的なセッション（15-30分、1-3ファイル）、警告サイン</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">（空白）</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>P6 — セッションの種類</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">72</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�検出表, 提案フォーマット, 例外</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">—</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>P7 — 継続的な改善</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">39</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">追跡指標, 週次レビュー</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">—</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>P8 — 起動チェックリスト</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">13</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Bootstrap 新しいプロジェクト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">(Empty)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>P9 — 参考文献</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">30</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">参照ファイル, 外部リソース</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>AGENT.adoc</code>(ファイル EAGER/LAZY)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>付録 A+B</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">42</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">用語集, バージョン履歴</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">—</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>判決は覆らない：</p> </div> <div class="ulist"> <ul> <li> <p><strong>完全な重複</strong>(167 行) : P3, P4, P9 — すべて既に含まれている`AGENT.adoc` ou <code>INDEX.adoc</code>, しばしば逐語的に</p> </li> <li> <p><strong>実践では一度も相談されなかった</strong>(215 行) : P5, P6, P7, P8, 付録 — どのセッションでも一度も使われたことがないメタガバナンス</p> </li> <li> <p><strong>唯一の知識</strong>(161 行) : P1 と P2 — LAZY/EAGER の語彙、類推、ロードポリシー</p> </li> </ul> </div> <div class="paragraph"> <p>627行で,<strong>382 は騒音です</strong>. そしてこれらの382行は、<strong>各セッションの開始時に</strong> 読み込まれ、エージェントによって消費され、私が「こんにちは」と言う前に彼の注意を薄めます。</p> </div> <div id="diag-audit-result" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center title AGENT_MODUS_OPERANDI.adoc の監査 — 627 行 left to right direction rectangle "�🟡 **重複** 167 行 (27%)" as DUP #FFF9C4 { card "P3 — 絶対的な規則 (34行)" as D1 card "P4 — ライフサイクル (133 行)" as D2 card "P9 — 参考文献 (30 行)" as D3 } rectangle "🔴 **未参照** 215 行 (34%)" as JAM #FFCDD2 { card "P5 — メトリクス (49行)" as J1 card "P6 — 検出\n(72 行)" as J2 card "P7 — �善 (39 行)" as J3 card "P8 — Bootstrap (13 行)" as J4 card "付録 — 用語集 (42 行)" as J5 } rectangle "🟢 **独自の知識** 161 行 (26%)" as UNI #C8E6C9 { card "P1 — 概要 (64 行)" as U1 card "P2 — ファイル構造 (97 行)" as U2 } note bottom of UNI C'est ÇA qu'il faut garder en EAGER. Le reste → cold storage. end note @enduml</pre> </div> </div> <div class="paragraph"> <p>この図がすべての鍵です。重複（黄色）は純粋なノイズです — エージェントはそれらを2回読み、異なる2つのファイルで読み取ります。未参照（赤色）は死んだドキュメントです — 慎重に書かれているが、決して使われません。緑だけが、エージェントが他では見つけることができない知識を含んでいます。</p> </div> </div> </div> <div class="sect1"> <h2 id="_エンジニアリングを失う恐れ">エンジニアリングを失う恐れ</h2> <div class="sectionbody"> <div class="paragraph"> <p>この段階で、私は目の前に証拠がある：減らさなければならない。<code>AGENT_MODUS_OPERANDI.adoc</code>. しかし、私は躊躇しています。</p> </div> <div class="paragraph"> <p>このファイルは手書きで書きました。各セクションは実際のセッションで学んだ教訓の結果です。P3の部分はある`rm -rf`偶発的な上で`bakery-plugin`実際のFirebaseトークンを消費させられた。P4部分は、アーカイブし忘れて途中で方向を見失った15回のセッションの結果です。この6ステップの手順は書籍から生まれたものではなく、苦痛から生まれたものだ。</p> </div> <div class="paragraph"> <p>これらのセクションを削除すれば、自分のエンジニアリングの歴史を捨てることになる。これらを生み出した教訓、それらを発見したセッション、二度と繰り返したくないミス。これはテキストではない――結晶化された経験だ。</p> </div> <div class="paragraph"> <p>ここで私が、解決を導く原理を定式化します :</p> </div> <div class="paragraph"> <p><em><em>_ <strong>絶対に削除しないで。常に移動させて。</strong>知識はプロジェクトから消える必要はない。ただ、必要ないときは自動的に読み込まれないようにすればよい。 </em>_</em></p> </div> </div> </div> <div class="sect1"> <h2 id="_解決策_split百科事典的">解決策： split百科事典的</h2> <div class="sectionbody"> <div class="paragraph"> <p>私が提案するモデルはシンプルで、Wikipediaが成長した方法からインスピレーションを得ています : 記事が長くなりすぎたら切るのではなく — 詳細な記事を作成し、主要な記事に要約を残します。</p> </div> <div class="paragraph"> <p>のために`AGENT_MODUS_OPERANDI.adoc`, これが与えられます :</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>�抽出する</strong>新しいファイルの161行のユニークな知識 (P1 + P2)<code>LAZY_EAGER_ESSENTIALS.adoc</code>— 約50行に圧縮され、厳密にEAGER</p> </li> <li> <p><strong>名前を変更</strong> <code>AGENT_MODUS_OPERANDI.adoc</code> en <code>.agents/encyclopedies/LAZY_EAGER_ENCYCLOPEDIE.adoc</code>— 元のファイルは627行で、*intact*の状態でコールドストレージに保存されています</p> </li> <li> <p><strong>決して充電するな</strong>百科事典ファイルは自動的に — それは人間のため、将来の蒸留のため、そして6ヶ月後にもっと良いモデルで呼び出すエージェントのために存在しています。</p> </li> </ol> </div> <div id="diag-split-solution" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center title 分割百科事典 — AGENT_MODUS_OPERANDI left to right direction rectangle "**AGENT_MODUS_OPERANDI.adoc** 627 行 (分割前)" as BEFORE #FFCDD2 { } rectangle " " as ARROW1 rectangle " " as ARROW2 rectangle "**LAZY_EAGER_ESSENTIALS.adoc** **~50 行 — EAGER**" as ESS #C8E6C9 { card "P1凝縮 (15行)" as E1 card "P2凝縮版\n(35 行)" as E2 } rectangle "**.agents/encyclopedies/** **LAZY_EAGER_ENCYCLOPEDIE.adoc** 627 行 — COLD" as ENC #BBDEFB { card "P1を付録へ (完全, 無傷)" as C1 } BEFORE -[#4CAF50]-> ESS : "クリティカルな知識の抽出" BEFORE -[#2196F3]-> ENC : "完全な保存 エンジニアリングの" note bottom of ESS Chargé automatiquement en début de session → L'agent comprend le vocabulaire end note note bottom of ENC Jamais chargé automatiquement Consultable par l'humain Matériau brut pour distillation future end note @enduml</pre> </div> </div> <div class="paragraph"> <p>名前`encyclopedies/`それは軽々しいことではない。百科事典はアーカイブのファイルではなく、整理された知識の集まりで、参照できるが持ち運びはできない。メトロではEncyclopédie Universalisを読まない。これを図書館に置き、具体的な質問があるときにそこに行く。</p> </div> <div class="paragraph"> <p>これはまさにこのフォルダーの役割です：冷たく、構造化され、包括的な参照ライブラリ — エージェントが自動的に触れないもの。</p> </div> </div> </div> <div class="sect1"> <h2 id="_ファイルの内容_essentials">ファイルの内容 ESSENTIALS</h2> <div class="sectionbody"> <div class="paragraph"> <p>これが新しいファイルの具体的な姿です。<code>LAZY_EAGER_ESSENTIALS.adoc</code>, 抽出および圧縮され、P1 と P2 から：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">= Stratégie LAZY/EAGER — Principes Essentiels [abstract] Ce fichier définit la stratégie de gestion du contexte agent. Chargé automatiquement (EAGER) en début de session. == Principes |=== | EAGER | LAZY | Tableau de bord | Manuel du propriétaire | Chargé automatiquement | Chargé sur demande | <= 100 lignes, <= 10k tokens | Illimité, détaillé | Règles absolues, mission courante | Archives, historique, références |=== == Politique de Chargement |=== | Fichier | Type | Quand charger | PROMPT_REPRISE.adoc | EAGER | Début session (auto) | *_ESSENTIALS.adoc | EAGER | Début session si EPIC active | .agents/INDEX.adoc | EAGER | Début session (auto) | *_REFERENCE.adoc | LAZY | Sur besoin (détails architecture) | .agents/sessions/N-*.adoc | LAZY | Sur demande (détails session) | .agents/encyclopedies/*.adoc | COLD | Jamais auto (humain seulement) |=== == Comment l'Agent Sait Quoi Charger Début session → PROMPT_REPRISE + INDEX + ESSENTIALS actifs. Besoin de détails → charger les *_REFERENCE et sessions/ en LAZY. Connaissance froide → encyclopedies/, jamais automatique.</code></pre> </div> </div> <div class="paragraph"> <p>50行。これがエージェントがメカニズムを理解するために必要なすべてだ。それ以外―レッスンの履歴、詳細なアナロジー、ステップバイステップの手順、付録―はすべて百科事典にある。</p> </div> <div class="paragraph"> <p>そして最も重要なこと:<strong>何も削除されていません</strong>. 627行のエンジニアリングラインはまだそこにあります、その中`.agents/encyclopedies/LAZY_EAGER_ENCYCLOPEDIE.adoc`. それらはただ本棚に置かれているだけで、作業台の上にあるわけではありません。</p> </div> </div> </div> <div class="sect1"> <h2 id="_結果_50_の_eager_コンテキスト">結果: -50% の EAGER コンテキスト</h2> <div class="sectionbody"> <div class="paragraph"> <p>分割前：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs"> 287 AGENT.adoc 627 AGENT_MODUS_OPERANDI.adoc 51 PROMPT_REPRISE.adoc 218 .agents/INDEX.adoc 18 .agents/SESSIONS_HISTORY.adoc 213 .agents/archives/COMPLETED_TASKS_ARCHIVE_2026-04.adoc 1414 total</code></pre> </div> </div> <div class="paragraph"> <p>分割後：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs"> 287 AGENT.adoc 50 LAZY_EAGER_ESSENTIALS.adoc ← remplace 627 lignes 51 PROMPT_REPRISE.adoc 218 .agents/INDEX.adoc 18 .agents/SESSIONS_HISTORY.adoc 213 .agents/archives/COMPLETED_TASKS_ARCHIVE_2026-04.adoc 837 total ← -41%</code></pre> </div> </div> <div id="diag-after-audit" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE title エン�ンサイクロペディック分割後の EAGER コンテキスト — 837 行 (－41%) rectangle "AGENT.adoc 287行(34%)" as AG #BBDEFB rectangle "INDEX.adoc 218行 (26%)" as IDX #C8E6C9 rectangle "COMPLETED_TASKS 213 行 (25%)" as ARC #FFF9C4 rectangle "PROMPT_REPRISE 51 行 (6%)" as PRO #E1BEE7 rectangle "ESSENTIALS 50 行 (6%)" as ESS #A5D6A7 rectangle "SESSIONS_HISTORY 18 行 (2%)" as HIS #FFE0B2 note bottom of ESS De 627 → 50 lignes 577 lignes d'ingénierie préservées en cold storage Rien de perdu. Tout de relocalisé. end note @enduml</pre> </div> </div> <div class="paragraph"> <p>最大の消費者（<code>AGENT_MODUS_OPERANDI</code>, 627行）は50行のファイルに置き換えられました。利益は即座に得られます：577行のコンテキストが解放されました。エージェントは安堵しています。</p> </div> <div class="paragraph"> <p>そして中で`.agents/encyclopedies/`元のファイルは627行で待っています。変更されていません。すべてのセクション — 重複しているものも、まだ使われていないものも含めて — 。なぜなら、いつかより良いモデルまたは人間のデータサイエンティストがこれらの角度、これらの受け入れられた冗長性、これらの学んだ教訓を交差させたくなるからです。そしてその日には、原材料がそこにあるでしょう。</p> </div> </div> </div> <div class="sect1"> <h2 id="_なぜフォルダーは_encyclopediesと呼ばれるのですか">なぜフォルダーは `encyclopedies/`と呼ばれるのですか？</h2> <div class="sectionbody"> <div class="paragraph"> <p>名前の選択は装飾的ではない。それはメカニズムの哲学をエンコードする。</p> </div> <div class="paragraph"> <p><strong>アーカイブ</strong> (<code>archives/</code>) 歴史的なデータが年代順に整理されて含まれています — 月次の COMPLETED_TASKS のように。 <strong>backup</strong> (<code>backup/</code>)はタイムスタンプ付きスナップショットである — 過去の状態のバックアップコピー</p> </div> <div class="paragraph"> <p><strong>百科事典</strong>、これは別のものだ。これはテーマ別の知識の集まりであり、主題ごとに構成され、包括的だが非線形である。百科事典は最初から最後まで読むものではない。そこに飛び込んで特定の質問に答える。</p> </div> <div class="paragraph"> <p>これはまさにこのファイルの契約です：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 6.25%;"> <col style="width: 6.25%;"> <col style="width: 6.25%;"> <col style="width: 6.25%;"> <col style="width: 6.25%;"> <col style="width: 6.25%;"> <col style="width: 6.25%;"> <col style="width: 6.25%;"> <col style="width: 6.25%;"> <col style="width: 6.25%;"> <col style="width: 6.25%;"> <col style="width: 6.25%;"> <col style="width: 6.25%;"> <col style="width: 6.25%;"> <col style="width: 6.25%;"> <col style="width: 6.25%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ファイル</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">役割</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">アクセス</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">粒度</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>archives/</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">過去のデータ（月ごとに完了したタスク）</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">LAZY, 構造化された</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">年代順の</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>backup/</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">冷たいスナップショット（10セッションの波）</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">COLD, 完全コピー</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">時系列の</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>encyclopedies/</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">包括的なテーマ別の知識（方法論、パターン）</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">COLD、決してオート</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">テーマ</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>この区別は雑多になることを防ぎます。各ファイルは、*作成時*ではなく、*その中身*に従って、どこに置くべきかを知っています。</p> </div> </div> </div> <div class="sect1"> <h2 id="_シリーズの論理的な続き">シリーズの論理的な続き</h2> <div class="sectionbody"> <div class="paragraph"> <p>最初の2つの記事を読んだ場合、ここで3つのピースがどのように組み合わされるかを示します：</p> </div> <div id="diag-trilogie" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center skinparam wrapWidth 220 title エージェントガバナンス三部作 left to right direction package "�📖 **Article 0108** 戦略 Eager/Lazy" as A1 #E8F5E9 { card "エージェントメモリ セッション間" as M1 card "EAGER ファイル (自動的にロードされた)" as M2 card "ファイル LAZY (オンデマンド)" as M3 card "6段階の手順" as M4 } package "�🧊 **Article 0110** メカニズム ホット/ウォーム/コールド" as A2 #FFF9C4 { card "老化 コンテキストの" as V1 card "スライドウィンドウ 10セッション" as V2 card "�寒波 同じ" as V3 card "二つのトリガーを備えたセンサー" as V4 } package "�🔍 **Article 0111**\n監査 + 百科事典ソリューション" as A3 #BBDEFB { card "ファイルの監査 EAGER" as E1 card "特定 廃棄物" as E2 card "Split ESSENTIALS/百科事典" as E3 card "保存 エンジニアリングの" as E4 } A1 --> A2 : "メモリは増大する\n→ 経年劣化のメカニズムが必要" A2 --> A3 : "経年だけでは不十分です → 監査する必要があるもの EAGERである価値がある" note bottom of A3 ✅ Les trois couches sont en place sur 6 projets actifs end note @enduml</pre> </div> </div> <div class="ulist"> <ul> <li> <p><strong>0108</strong>回答: «エージェントに二つのセッションの間で記憶を与える方法は？</p> </li> <li> <p><strong>0110</strong>それに答える : « この記憶がエージェントを窒息させないようにどう防ぐか？</p> </li> <li> <p><strong>0111</strong>返答: 「そして問題がアーカイブのサイズではなく、EAGERに設定することを*選んだ*ものである場合は？」</p> </li> </ul> </div> <div class="paragraph"> <p>最初の論文は構造を構築した。二番目は老化メカニズムを追加した。三番目は内容を監査し — そして方法論自身が問題になったことを発見した。</p> </div> </div> </div> <div class="sect1"> <h2 id="_私が違うようにやったこと">私が違うようにやったこと</h2> <div class="sectionbody"> <div class="paragraph"> <p>振り返ってみると、最初の設計ミスに気づく。`AGENT_MODUS_OPERANDI.adoc`これは単一のドキュメントとして作成され、マニフェストとなりました。それは思考を形式化するための正しいアプローチでした。しかし、思考が形式化された後、ドキュメントはすぐに分割されるべきでした：EssentialはEAGER、包括的はcoldとして。</p> </div> <div class="paragraph"> <p>私は文書に誇りを持っていたので、それを行わなかった。627行の純粋なエンジニアリング、手書きで書かれ、各セクションはセッションのレッスンの成果だった。それは私の作品だった。そして、あらゆる作者のように、私はそれを分割するのに苦労した。</p> </div> <div class="paragraph"> <p>レッスン：<strong>文書が良いからといって、自動的に読み込まれるべきではない。</strong>. コンテンツの品質は、エージェントの直近の文脈への関連性とは関係がない。</p> </div> <div class="paragraph"> <p>今日、ルールは単純です：EAGERコンテキストにおいて100行を超えるドキュメントはすべて疑わしいものです。監査の対象となります。非難ではなく監査です。問題は決して「削除すべきか？」ではなく「各セッションでロードすべきか？」です。</p> </div> </div> </div> <div class="sect1"> <h2 id="_自分のコンテキストを監査するためのガイド">自分のコンテキストを監査するためのガイド</h2> <div class="sectionbody"> <div class="paragraph"> <p>最初の2つの記事に従い、独自のEager/Lazyガバナンスを構築した場合、監査の5ステップ手順は次の通りです：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>�測る</strong> : `wc -l`すべてのEAGERファイルに対して。合計は1000行以下であるべきです。</p> </li> <li> <p><strong>最大のものを特定する</strong>: 合計の20%以上を占めるファイルが疑わしいファイル第1位です。</p> </li> <li> <p><strong>セクションごとに監査</strong>: 各セクションについて、自分に問いかける 「この情報は他のところにすでにありますか？ エージェントは他のファイルで既にこれを読みましたか？ これは過去5セッションで使用されましたか？」</p> </li> <li> <p><strong>分類器</strong>重複、一度も使用されていない、独自の知識。</p> </li> <li> <p><strong>分割または再配置</strong>: 何が独自かつ重要であるか → ESSENTIALS コンパクト化。それ以外すべて →<code>encyclopedies/</code>。</p> </li> </ol> </div> <div id="diag-audit-checklist" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center title コンテキストエージェントの監査手順 — 5ステップ start :1. **Mesurer**\n`wc -l *.adoc .agents/*.adoc`; if (Total > 1000 lignes ?) then (oui) :⚠️ Contexte trop lourd; else (non) :✅ Contexte OK; stop endif :2. **Identifier le suspect**\nLe fichier > 20% du total; :3. **Auditer section par section**\nPour chaque section :\n• Déjà ailleurs ? → doublon\n• Jamais servi ? → mort\n• Information unique ? → critique; :4. **Classifier**\n🟡 Doublons → à retirer de l'EAGER\n🔴 Jamais utilisé → cold storage\n🟢 Connaissance unique → à garder; :5. **Splitter**\n🟢 → ESSENTIALS (~50 lignes, EAGER)\n🟡🔴 → encyclopedies/ (cold storage); :✅ Contexte optimisé\nsans perte d'ingénierie; stop @enduml</pre> </div> </div> <div class="paragraph"> <p>この手順は15分かかります。50セッションのプロジェクトでは、今後の各セッションで数百トークンを節約できます。ROIは即座に現れます。</p> </div> </div> </div> <div class="sect1"> <h2 id="_活きたガバナンス">活きたガバナンス</h2> <div class="sectionbody"> <div class="paragraph"> <p>この3部作の記事シリーズから私が学んだことは、エージェントガバナンスは完成品ではないということです。それは<strong>生きている生物</strong>. 彼女はプロジェクトとともに成長する。 彼女は成長に伴う病気にかかる。 彼女は定期的なチェックアップが必要だ。</p> </div> <div class="paragraph"> <p>セッション 048 は、アーカイブが膨らんでいることを明らかにしました。セッション 051 は、方法論そのものが膨らんでいることを明らかにしました。セッション 060 はおそらく別の何かを明らかにするでしょう。それは普通です。それは健全です。決して自己反省しないガバナンスは死んだガバナンスです。</p> </div> <div class="paragraph"> <p>三つのメカニズム — Eager/Lazy、Hot/Warm/Cold、百科事典的分割 — が配置され、コンテキストの飽和に対する深層防御システムを形成しています。いずれも単独では十分ではありません。組み合わせると、互いに補完し合います：</p> </div> <div class="ulist"> <ul> <li> <p><strong>熱意がある/怠惰な</strong>可用性で情報を構造化する</p> </li> <li> <p><strong>暑い/温かい/寒い</strong>情報を*新鮮さによって*構造化する</p> </li> <li> <p><strong>百科全書の監査</strong>情報を*密度で*構造化する</p> </li> </ul> </div> <div id="diag-defense-in-depth" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam nodeBackgroundColor #E3F2FD title コンテキストの飽和に対する深層防御 node "**エージェントコンテキスト** ~800 行 健康" as CTX #C8E6C9 node "レイヤー 1\n**EAGER / LAZY**" as C1 #BBDEFB node "�層2 **ホット / ウォーム / コールド**" as C2 #BBDEFB node "層 3 **基本 / 百科事典**" as C3 #BBDEFB CTX --> C1 : "構造による\n**可用性**" CTX --> C2 : "構造による\n**新鮮さ**" CTX --> C3 : "構造による **密度**" note bottom of C3 Les trois couches sont nécessaires. Aucune n'est suffisante seule. end note @enduml</pre> </div> </div> <div class="paragraph"> <p>これらの3つの層で、エージェントのコンテキストについて`magic-stick`2087行（あらゆる最適化を行う前）から約800行に減少 — つまり2.6倍に削減されました。ドキュメントの1行も、セッションのアーカイブも、学んだ教訓も1つも失っていません。</p> </div> <div class="paragraph"> <p>全部ここにある。ただ、もっときれいに片付けられている。</p> </div> </div> </div> <div class="sect1"> <h2 id="_リンク">リンク</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>記事 0108 — アイガー／レイジー戦略 :<a href="/blog/2026/0108_gouvernance_agent_opencode_eager_lazy_post.html">AsciiDocを使ってAIエージェントを管理する</a></p> </li> <li> <p>条項 0110 — ホット/ウォーム/コールド メカニズム :<a href="/blog/2026/0110_mecanisme_backup_contexte_agent_post.html">スライディングウィンドウと寒波</a></p> </li> <li> <p>私のサイト：https://cheroliv.com</p> </li> <li> <p>プロジェクト`magic-stick`: <a href="https://github.com/cheroliv/magic-stick" class="bare">https://github.com/cheroliv/magic-stick</a></p> </li> </ul> </div> <hr> <div class="paragraph"> <p>知識は消える必要はない。必要でないときはロードしないだけだ。</p> </div> </div> </div> https://cheroliv.com/blog/2026/0110_mecanisme_backup_contexte_agent_post.html Sun, 26 Apr 2026 00:00:00 +0000 blog/2026/0110_mecanisme_backup_contexte_agent_post.html <div class="sect1"> <h2 id="_要約">要約</h2> <div class="sectionbody"> <div class="paragraph"> <p>1つのプロジェクトで48セッション、合計で150以上を経て、私が細心の注意を払って構築したEager/Lazyガバナンスシステムは息詰まり始めていた。軽いものであるはずのエージェントファイルは、合計で5200行に膨れ上がっていた。自動的にロードされるコンテキストは、私が制御できる速度よりも速く増えていった。この記事では、スライディングウィンドウと同じようなコールドウェーブの間にあるバックアップメカニズムをどのように考案したかを説明し、決して何も失うことなく軽量なアクティブコンテキストを維持する方法について述べている。</p> </div> </div> </div> <div class="sect1"> <h2 id="_信号_5200_行">信号 : 5200 行</h2> <div class="sectionbody"> <div class="paragraph"> <p>私はセッション048の途中ですについて`magic-stick`, 私のLinuxライブISOビルドプロジェクト。Opencodeが私を見ている。いつものように、彼はセッションの開始時に私のEagerファイルを自動的にロードした—<code>AGENT.adoc</code>, <code>PROMPT_REPRISE.adoc</code>, `.agents/INDEX.adoc`異常はありません。</p> </div> <div class="paragraph"> <p>ただし、何かがおかしい。返答が遅くなる。推論が薄まる。エージェントは、2つ前のメッセージで目にしていた詳細を忘れてしまう。</p> </div> <div class="paragraph"> <p>ターミナルを開いて、入力します :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">wc -l .agents/INDEX.adoc .agents/SESSIONS_HISTORY.adoc \ .agents/archives/COMPLETED_TASKS_ARCHIVE_2026-04.adoc</code></pre> </div> </div> <div class="paragraph"> <p>INDEX に 260 行。SESSIONS_HISTORY に 55 行。<strong>COMPLETED_TASKS_ARCHIVE用の1756</strong>。</p> </div> <div class="paragraph"> <p>フォルダー`sessions/`さらに約3200行を追加します。合計：<strong>5200行</strong>コンテキストが読み込まれ、何らかの形でエージェントの一時的な脳内に存在する。</p> </div> <div class="paragraph"> <p>私が前の記事で理論化したEager/Lazy戦略は機能する — しかし、私が予期していなかった生まれつきの欠陥がある：それは持っていない<strong>老化のメカニズムはありません</strong>. 各セッションは、INDEXに1行を追加し、COMPLETED_TASKSに1段落を追加し、sessions/にファイルを追加します。何も出力されません。コンテキストは、新しいセッションごとに大きくなる雪だるまです。</p> </div> <div id="diag-growth" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam handwritten false title コンテキストエージェントの成長 — セッション 1 から 48 rectangle "セッション 1-10" as S10 #E8F5E9 rectangle "セッション 11-20" as S20 #C8E6C9 rectangle "セッション 21-30" as S30 #A5D6A7 rectangle "セッション 31-40" as S40 #81C784 rectangle "セッション 41-48" as S48 #66BB6A note right of S10 INDEX : ~50 lignes SESSIONS : ~10 lignes ARCHIVE : ~100 lignes **Total : ~300 lignes** end note note right of S20 INDEX : ~100 lignes SESSIONS : ~20 lignes ARCHIVE : ~400 lignes **Total : ~800 lignes** end note note right of S30 INDEX : ~160 lignes SESSIONS : ~30 lignes ARCHIVE : ~900 lignes **Total : ~1800 lignes** end note note right of S40 INDEX : ~220 lignes SESSIONS : ~45 lignes ARCHIVE : ~1400 lignes **Total : ~3200 lignes** end note note right of S48 INDEX : **260 lignes** SESSIONS : **55 lignes** ARCHIVE : **1756 lignes** **Total : 5200 lignes** ⚠️ end note S10 -[#green]-> S20 S20 -[#green]-> S30 S30 -[#FF9800]-> S40 S40 -[#red]-> S48 @enduml</pre> </div> </div> <div class="paragraph"> <p>これはバグではなく、セッション終了の手順が各ディテールを細部まで忠実にアーカイブする直接の結果です。システムは自身の成功の犠牲者です。</p> </div> </div> </div> <div class="sect1"> <h2 id="_診断トリプル冗長">�診断：トリプル冗長</h2> <div class="sectionbody"> <div class="paragraph"> <p>私はエージェントに問題を診断してもらうように依頼します。その返答は即座かつ的確です。</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ファイル</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">行</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">役割</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">問題</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>.agents/INDEX.adoc</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">260+</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">EAGER (自動充電)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">001 からのすべてのセッションのテーブル —<strong>+1行/セッション</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>.agents/SESSIONS_HISTORY.adoc</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">55</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">熱意がある</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">サマリー表 —<strong>INDEXとの冗長性</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>COMPLETED_TASKS_ARCHIVE_2026-04.adoc</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">1756</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">EAGER(暗黙的)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">4月のすべてのセッションの詳細</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>.agents/sessions/*.adoc</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">~5200 total</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">怠惰（そうとされる）</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">個人のアーカイブ、しかし<strong>使用されていない</strong>なぜならすべてが既に COMPLETED_TASKS にあるから</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>エージェントは4つの根本原因を特定します：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>COMPLETED_TASKS_ARCHIVEはすべてを吸収します</strong>— アーカイブを指す代わりに`.sessions/`、彼は各セッションを完全にコピーします。</p> </li> <li> <p><strong>INDEX.adoc は完全な歴史として機能します</strong>— 「Sessions Récentes」テーブルには30+件のエントリがあります。</p> </li> <li> <p><strong>SESSIONS_HISTORY.adocは冗長です</strong>— INDEXと同じ情報、フォーマットが異なります。</p> </li> <li> <p><strong>LAZYルールは守られていません。</strong>— COMPLETED_TASKS は暗黙のうちに EAGER です。なぜなら、すべてを含んでいるからです。</p> </li> </ol> </div> <div class="paragraph"> <p>彼の提案は過激である：INDEXを10セッションに制限し、COMPLETED_TASKSを空にし、SESSIONS_HISTORYを純粋なLAZYに移動する。即時の利益：<strong>約1900行節約</strong>。</p> </div> <div class="paragraph"> <p>きれいで、効率的で、論理的です。でも、このアプローチに問題があります。</p> </div> </div> </div> <div class="sect1"> <h2 id="_なぜ私は明らかな解決策を断ったのか">なぜ私は明らかな解決策を断ったのか</h2> <div class="sectionbody"> <div class="paragraph"> <p>エージェントの解決策は、キャッシュを最適化するエンジニアのものです。制限。切り詰め。冗長削除。</p> </div> <div class="paragraph"> <p>しかし、これらの「冗長性」ではありません。各ガバナンスファイルは 1 つを捉える<strong>異なる角度</strong>同じ現実上で :</p> </div> <div class="ulist"> <ul> <li> <p><strong>索引</strong>= マクロビュー、エグゼクティブダッシュボード</p> </li> <li> <p><strong>セッション履歴</strong>= 線形の年代順の表、スコア付き</p> </li> <li> <p><strong>COMPLETED_TASKS_ARCHIVE</strong>= 詳細なナラティブとメトリクス</p> </li> <li> <p><strong>sessions/*.adoc</strong> = 個々のアーカイブ、完全なコンテキスト</p> </li> </ul> </div> <div class="paragraph"> <p>これは愚かな複製ではありません。これは<strong>複数の構造化された視点</strong>. これは、蒸留するためにまさに必要なものです。そうすれば、後で人間（またはより訓練された将来のLLM）が角度をクロスし、パターンを抽出できるようになります。</p> </div> <div class="paragraph"> <p>データサイエンティストが言うのを想像してください：「6つの列のうち3つを削除しましょう、それらは相関しています。」あなたは彼に何と答えますか？ 相関は、各列が同じ現象の異なる次元を捉えているときは冗長ではないということです。まさにこの多次元的な豊かさがデータセットを使えるようにしているのです。</p> </div> <div class="paragraph"> <p>それが私の直感です。そして、私はそれをエージェントの冷たい理性に対して守っています。</p> </div> <div class="paragraph"> <p><em><em>_ 私の考えの中に、黙ってすべてを詰め込むようなものは見当たりません。私たちは全部を詰め込むのではなく、セッション終了手続きの構造化された結果を移動します — 各ファイルがその角度と、実際には豊かさである冗長性を持っています。この多次元的な材料こそが、蒸留に最適でしょう。 </em>_</em></p> </div> <div class="paragraph"> <p>エージェントは打撃を受ける。そして自分を正す。</p> </div> </div> </div> <div class="sect1"> <h2 id="_提案同じ寒波">提案：同じ寒波</h2> <div class="sectionbody"> <div class="paragraph"> <p>エージェントはその後、豊富なデータセットという私の直感を尊重しつつ、コンテキストが爆発するという技術的な問題を解決する、より細やかなメカニズムを提案します。</p> </div> <div class="paragraph"> <p>原理はシンプルで、パターンから直接インスピレーションを得ています<strong>ホット/ウォーム/コールド ストレージ</strong>アーカイブ管理に適用される :</p> </div> <div class="ulist"> <ul> <li> <p><strong>熱い (EAGER)</strong>= INDEX内の最後の10セッション, セッションN+1のPROMPT_REPRISE, 最後の2つのセッションファイル</p> </li> <li> <p><strong>温かい (LAZY)</strong>= SESSIONS_HISTORY 最近, SCRIPT_VERIFICATION, すべてのリファレンスドキュメント</p> </li> <li> <p><strong>寒い (backup/)</strong>= その他すべて、移動済み<strong>無傷の</strong>, 変換なし、再インデックスなし</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">---- ---- .agents/ ├── INDEX.adoc → Sessions N-9 à N (10 dernières) ├── SESSIONS_HISTORY.adoc → Sessions N-9 à N ├── SCRIPT_VERIFICATION.adoc → Dernière vérif (pas d'historique) ├── PROMPT_REPRISE.adoc → Session N+1 uniquement ├── sessions/ → Sessions N-1 à N uniquement └── backup/ └── Y2026-sessions-001-039/ ← Vague froide, COPIE INTÉGRALE ├── INDEX.adoc → Sessions 001 à 039 (complet) ├── SESSIONS_HISTORY.adoc → Sessions 001 à 039 (complet) ├── COMPLETED_TASKS_ARCHIVE.adoc → Sessions 001 à 039 (complet) └── sessions/ → 001.adoc, 002.adoc... ---- メカニズムの鍵 :**バックアップは中央のインデックスではなく、過去の波の正確なコピーです。**. 10セッションのアクティブなホライゾンを超えると、何も削除せず、何も再インデックスせず、何もマージせず、セッション N-10時点のエージェントファイルのパケットをそのまま取り、それを移動`backup/`。 アクティブなファイルは、切り捨てられます : * INDEX : 最後の10行のみ (sliding window) * SESSIONS_HISTORY : 同様 * COMPLETED_TASKS_ARCHIVE : 現在の期間の新しいファイル * sessions/ : 直近の 2 セッションのみ [plantuml, format=svg, id=diag-hot-warm-cold, alt="Architecture Hot/Warm/Cold du contexte agent — EAGER/LAZY/backup"] ---- @startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center skinparam wrapWidth 200 title コンテキスト エージェントのホット / ウォーム / コールド アーキテクチャ package "HOT (EAGER) 自動的に充電 ~300 行" as HOT #FFCDD2 { file "INDEX.adoc (10 セッション)" as IDX_HOT file "PROMPT_REPRISE (セッション N+1)" as PRO_HOT file "AGENT.adoc\n(絶対ルール)" as AG_HOT } package "WARM (LAZY) オンデマンドでロード 約500行" as WARM #FFF9C4 { file "SESSIONS_HISTORY\n(最近の10件)" as HIS_WARM file "SCRIPT_VERIFICATION (最後)" as VER_WARM file "PROCEDURES.adoc (テンプレート)" as PRO_WARM file "*_REFERENCE.adoc (技術文書)" as REF_WARM } package "COLD (backup/) 決して充電されていない 人間のみが読むことができます" as COLD #BBDEFB { folder "Y2026-001-039/" as WAVE { file "インデックス (完全)" as IDX_COLD file "SESSIONS_HISTORY\n(完了)" as HIS_COLD file "完了タスク (完了)" as ARCH_COLD folder "セッション/ (001-039)" as SESS_COLD } folder "Y2026-040-???\n(将来)" as FUTURE } HOT --> WARM : "エージェントが上がる 必要に応じて" WARM --> COLD : "決して自動ではない 人間は一人でそこに行く" note bottom of COLD Règle : COPIE INTÉGRALE Pas de transformation Pas de réindexation Read-only après archivage end note @enduml ---- 即時の利益は巨大です：EAGERコンテキストはから**~5200行から~300行まで**. 17で割る。 歴史的データの一行も失わずに。 == なぜこれは万能ではない エージェントは、最初のイテレーションで、恐れていた`backup/`ブラックボックスになる — つまり、二度と見返すことのないファイルを捨て込むフォルダーだ。それは正当な恐れだ。だが、それは誤解に基づいている。 雑多な集まりとは、ファイルを投げ込むときのこと**構造もなく、慣習もなく、グループ化の論理もなく**. ここで、バックアップは期間 (Y2026-001-039) によって構造化されており、各バックアップフォルダには**同じ構造**が ファイル`.agents/`アクティブ : INDEX, SESSIONS_HISTORY, COMPLETED_TASKS_ARCHIVE, sessions/. これは雑多なものではありません。これは**タイムスタンプ付きスナップショット**. さらに言うと、これは簡略化されたバージョン管理のメカニズムと言えるかもしれません — ただし、ファイルを個別にバージョン管理するのではなく、ある時点Tでのガバナンスの完全なパッケージをバージョン管理するという意味です。 古い情報を見つけたいときは、中央のインデックスは必要ありません。二つの選択肢があります。 1. **grep` ターゲット指定の** : `grep -r "zsh" backup/Y2026-001-039/`— そして、期間中にzshを言及するすべてを見つけることができます。どの角度からでも (INDEX, SESSIONS_HISTORY, セッションアーカイブ)。 2. **手動再統合**バックアップフォルダーを一時的にアクティブコンテキストにコピーし、エージェントにこの特定の期間を分析させるように依頼します。 インデックスは暗黙的である。ファイルの構造そのものに存在し— 各ファイルはそれ自身の視点からすでにインデックスである。 == 棚のメタファー メカニズムを直感的にするために、私はそれを3つの棚に概念化しました * **棚 1 (EAGER)**— 作業計画。私が必要としているもの *今*。最近のINDEX、PROMPT_REPRISE、絶対ルール。軽量、即時、重要。 * **棚 2 (LAZY)**— 参照図書館。私が要請時に取りに行けるもの。技術参照、最近の履歴、手順。ボリュームは大きいが、メモリにロードされていない。 * **�洞窟 (backup/)**— コールドアーカイブ。 過去のすべてだが、捨てたくないもの。 エージェントはそこに決して入らない。 人間は、蒸留したいときにそこに降りる。 エージェントは最初に4番目の棚を提案した — 一つ`index-backup.adoc`それは LAZY で、バックアップ全体の目次を含むものになるでしょう。私は断りました。それは、すでに線形成長に苦しんでいるシステムにさらなる冗長性を加えることになります。アーカイブされたファイルの構造はすでにインデックスです。 == 二重トリガーセンサー 概念化は堅固だったが、盲点が残っていた :**正確にいつ回転を開始するべきですか？**最初の記事はそれをオープンな質問として特定していた。二日後、答えは6つのプロジェクトのガバナンスファイルにコード化されていた：2つのトリガーを持つセンサー。 === 自動トリガー — `N % 10 == 0 最初のトリガーは数学的なものです。セッション番号が10の倍数 — つまりセッション10、20、30、40 — のとき、バックアップのローテーションはセッション終了手順の一部として自動的に実行され、特に手順6の直後に実行されます。 なぜ10なのか？それは相反する二つの力の間の妥協点です。短すぎるウィンドウ（5セッション）は継続に必要な文脈を失い、長すぎるウィンドウ（20セッション）は文脈の肥大化問題を解決しません。1日あたり1～2セッションのペースで10セッションは概ね1週間分の仕事をカバーします。これはエージェントが最近の決定を思い出すには十分ですが、文脈が爆発的に増えるほどではありません。 === しきい値トリガー — 500行 EAGER 2番目のトリガーは動的です。セッション番号に関わらず、累積されたEAGERファイルが超える場合**500行**, 回転が開始されます。 このしきい値は、セッションが例外的に生産的であるシナリオ — 少ないセッションで多くのコンテンツが書かれる — から保護します。120行の編集コンテンツを生成するセッションは、2行を修正するデバッグセッションよりもCOMPLETED_TASKS_ARCHIVEをはるかに速く肥大化させます。500行のしきい値は、経由で測定されます`wc -l .agents/INDEX.adoc .agents/archives/COMPLETED_TASKS_ARCHIVE_*.adoc PROMPT_REPRISE.adoc`, この非対称性を捉える。 === マニュアルトリガー — "ローテーションバックアップ 最後に、人間が主導権を握ります。キーワード`rotation backup`, `backup rotation` ou `lance la rotation backup`要求時にプロシージャを起動し、セッションの終了とは独立して行われます。コンテキストが重くなってきたと感じたとき、まだ10の倍数には達していない場合や、新しい作業フェーズを開始する前に現在の作業フェーズをアーカイブしたいときに便利です。 [plantuml, format=svg, id=diag-capteur-trigger, alt="Les trois déclencheurs du capteur de rotation backup — automatique, seuil, manuel"] ---- @startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center skinparam wrapWidth 200 title バックアップ回転センサー — 三つのトリガー start :Procédure de fin de session; note right: Mots-clés "セッションの終了"\nou "ここでやめよう" :Étapes 1 à 6\n(archivage standard); note right 1. Archive sessions/N.adoc 2. MAJ PROMPT_REPRISE 3. MAJ SESSIONS_HISTORY 4. MAJ INDEX.adoc 5. MAJ TEST_COVERAGE 6. MAJ COMPLETED_TASKS end note if (N % 10 == 0\nOU\nEAGER cumulé > 500 lignes ?) then (oui) :⚙️ Rotation Backup\n(étape 7); note right 1. Créer backup/Y20XX-sessions-X-Y/ 2. Copier intégrale INDEX + HISTORY + COMPLETED_TASKS + sessions/ 3. Tronquer actifs à 10 sessions 4. Ajouter _Localisation active_ end note else (non) :Pas de rotation; endif :Checklist [✅] x 7\n(si applicable); stop @enduml ---- この図は、セッション終了手順におけるセンサーの正確な挿入を示しています。ステップ 7 はオプションであり（２つの条件のいずれかが真である場合にのみ実行されます）が、常に *チェック* されます。最終チェックリストには`[✅] 7. Backup roté (si applicable)`。 === 閉じられたループ このセンサーは、前の記事で開かれたループを閉じます。Eager/Lazy ガバナンスは、2 つのセッション間のエージェント メモリの問題を解決しました。Hot/Warm/Cold メカニズムは、増大するメモリの問題を解決しました。2 つのトリガーを持つセンサーは、*いつ* の問題を解決します — — 人間にコンテキスト サイズを監視する精神的負担を強いることなく。 [plantuml, format=svg, id=diag-boucle-fermee, alt="Les trois couches de la gouvernance agent — Eager/Lazy, Hot/Warm/Cold, Capteur"] ---- @startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center title エージェントガバナンスの三層 left to right direction package "�層 1 — メモリ (条項 0108)" as C1 #E8F5E9 { rectangle "EAGER ダッシュボード 自動ロード" as EAG rectangle "**LAZY**\n所有者マニュアル\n必要時にロード" as LAZ EAG -[hidden]right-> LAZ } package "�層2 — 経年変化 (条項 0110)" as C2 #FFF9C4 { rectangle "**HOT** 10件のアクティブなセッション ~300 行" as HOT rectangle "**WARM**\n参照\n手順" as WRM rectangle "**COLD** backup/ 寒波" as CLD HOT -[hidden]right-> WRM WRM -[hidden]right-> CLD } package "レイヤー 3 — トリガー (今日)" as C3 #BBDEFB { rectangle "**オート**\nN % 10 == 0" as AUTO rectangle "しきい値 > 500行" as SEUIL rectangle "**マニュアル** ローテーション バックアップ" as MAN AUTO -[hidden]right-> SEUIL SEUIL -[hidden]right-> MAN } C1 --> C2 : "メモリは増大する → メカニズムが必要 老化の" C2 --> C3 : "老化 → トリガーが必要です これを実行するために" note bottom of C3 ✅ Déployé sur 6 projets magic-stick · bakery-gradle plantuml-gradle · cheroliv.com jhipster-gradle-plugins quizz-benchmark-gradle end note @enduml ---- 3つの層は論理的に積み重なります。最初の層はエージェントにメモリを与えます。2番目の層はこのメモリがエージェントを圧迫しないようにします。3番目の層はこのメモリのメンテナンスを自動化し、人間がそれについて考える必要がなくなります。 === cheroliv.comでの効果的な移行 メカニズムは理論のままでは残らなかった。 Sur`cheroliv.com`,最初のバックアップローテーションは2026年4月29日に実行されました — セッション-6から2までが移行されました`.agents/backup/Y2026-sessions-neg6-a-002/` : |=== |ファイル |回転前 |回転後 |利益 |`.agents/INDEX.adoc` |リストされている19のセッション |10 セッション (3-12) |-9 件 |`.agents/SESSIONS_HISTORY.adoc` |18セッション |10セッション |-8件 |`COMPLETED_TASKS_ARCHIVE` |161 行 (セッション 1-12) |135 行 (セッション 3-12) |-26 行 |`sessions/` |20個のファイル |10ファイル |-10 ファイル |**バックアップ/** |存在しない |1つの寒波 (10件のアーカイブされたセッション) |+1 冷却パック |=== 行数の増加は控えめでした — プロジェクトは若く、12セッション — しかし重要なのは**メカニズムは整っている**. 次の自動ローテーションは、セッション20でトリガーされます。または、500行のEAGERに到達した場合はそれより早くトリガーされます。 == 人間エージェントのレッスン このセッション048 から、AI エージェントとの協力について根本的に重要なことを学びました。 エージェントは自然なバイアスを持っている：それを求める**最適化する**, à **簡素化する**, à **�冗長を排除する**. これは、きれいで簡潔な回答を生成するように訓練されたシステムのバイアスです。リッチで多次元的なデータセットに直面したとき、その最初の反応はそれを最もシンプルな形にまで簡素化することです。 人間は、むしろ異なる直感を持っている：彼は構造化された冗長さが何かであると直感している**強み**, 欠点ではない。同じ現実に対する角度の多様性こそが、後に質の高い蒸留を可能にするものだ。 エージェントが間違っているわけではない。彼の `optimum` が私のものではないということだ。エージェントは…のために最適化している**プレゼント**直近の文脈、質問に対する素早い回答。人間はそれに最適化する**未来**— 3か月または3年で見つけ、交差し、蒸留する能力。 ____ 私が欲しいのは未加工の素材だ。君の考え、ためらい、私の質問への答え。君のまとめではない。まとめは、私なら君より上手にできる。私が欲しいのは原材料だ。 ____ 私がセッションの終わりに彼に言ったこの言葉は、すべてを表している。エージェントは生産のためのツールだ。人間は抽出のためのツールだ。ガバナンスはエージェントが自分一人で全てを理解できるように作られているわけではない — ガバナンスは、人間が後で生産された素材を扱えるように作られている。 同じ冷たい波は、この哲学の建築的な翻訳である：何も捨てず、何も結合せず、何も再インデックスしない。パケットをそのまま移動させる。蒸留は後に、手作業で、人間によって行われる。 == 前の記事の論理的な続き もしあなたが読んだらlink:/blog/2026/0108_gouvernance_agent_opencode_eager_lazy_post.html[Eager/Lazy 戦略に関する記事], あなたは自然な進行を認識するでしょう: 1. **第108条**— Eager/Lazyガバナンス： *comment*エージェントコンテキストを2段階の可用性で構造化する方法 2. **この記事 0110**— バックアップメカニズム : *comment* このコンテキストを失うことなく古くする、それが大きすぎるようになるとき 最初の記事は次の質問に答えていた：「エージェントはセッション間で何も覚えていない。どうすれば記憶を与えることができるか？」 これは最初の質問から必然的に派生する質問に答えるものです：「メモリは各セッションごとに肥大化します。エージェントを削除せずに窒息させないようにするにはどうすればよいでしょうか？」 答えは1つのパターンに収まる：**ホット/ワーム/コールド**, ガバナンスファイルに適用された。そして一つの原則 :**決して何も失わない、常にすべてを再配置する**。 == リンク * 前の記事 :link:/blog/2026/0108_gouvernance_agent_opencode_eager_lazy_post.html[AsciiDocを使ったAIエージェントの管理] * 私のサイト : https://cheroliv.com * プロジェクト`magic-stick`: https://github.com/cheroliv/magic-stick --- *良いガバナンスシステムはデータを決して削除せず、整理する。* ----</code></pre> </div> </div> </div> </div> https://cheroliv.com/blog/2026/0109_gradle_jhipster_docker_testcontainers_debugging_post.html Sat, 25 Apr 2026 00:00:00 +0000 blog/2026/0109_gradle_jhipster_docker_testcontainers_debugging_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_シーンjhipsterプロジェクトロードされなくなったビルド">シーン：JHipsterプロジェクト、ロードされなくなったビルド</a></li> <li><a href="#_エラー_1_ファントム変数_reportsdir">エラー 1: ファントム変数 `reportsDir</a></li> <li><a href="#_エラー_2_main_は_gradle_9_で存在しなくなりました">エラー 2 : <code>main = \"…​\"</code> は Gradle 9 で存在しなくなりました</a></li> <li><a href="#_エラー_3_sourcecompatibility_はもはやプロジェクトのプロパティではありません">エラー 3 : <code>sourceCompatibility</code> はもはやプロジェクトのプロパティではありません</a></li> <li><a href="#_エラー_4_3項演算子の_groovy_アサーション">エラー 4 : 3項演算子の Groovy アサーション</a></li> <li><a href="#_エラー_5_暗黙の依存_compilekotlin_openapigenerate">エラー 5 : 暗黙の依存 <code>compileKotlin</code> → `openApiGenerate</a></li> <li><a href="#_エラー_6_generategitproperties_で壊れる_filteroutputstream_write">エラー 6 : <code>generateGitProperties</code> で壊れる `FilterOutputStream.write()</a></li> <li><a href="#_最後にtestcontainersが舞台に登場">最後に：Testcontainersが舞台に登場</a></li> <li><a href="#_phase_1_docker_javaのトラック">Phase 1 : docker-javaのトラック</a></li> <li><a href="#_phase_2_ウェブ検索とgithubのパンくずリスト">Phase 2: ウェブ検索とGitHubのパンくずリスト</a></li> <li><a href="#_フェーズ3_リネームされたアーティファクトの罠">フェーズ3 : リネームされたアーティファクトの罠</a></li> <li><a href="#_フェーズ4解決を強制する">フェーズ4：解決を強制する</a></li> <li><a href="#_最終結果">最終結果</a></li> <li><a href="#_修正のサマリーテーブル">修正のサマリーテーブル</a></li> <li><a href="#_結論">結論</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 15 minutes</div> <p>あなたは、シンプルな瞬間を経験したことがあります。`./gradlew build`1日100回も起動していると、突然、これまで見たことのないエラーでクラッシュするようになる？これを11回連続のエラーで掛け合わせ、Docker Engine 29の互換性不足をたっぷりと加え、10年使っていたAPIが消えてしまうGradle 9を振りかけると。これが完全なログです。</p> </div> <hr> <div class="paragraph"> <div class="title">図 1 — Gradle 9 移行 (エラーチェーン)</div> <p>目的：不互換性のシリーズを示す。</p> </div> <div class="listingblock"> <div class="title">👉 明確で、Gradle を中心とした。</div> <div class="content"> <pre>@startuml left to right direction title Gradle 9 移行 rectangle "1 レポートディレクトリ" as A rectangle "2 メインクラス" as B rectangle "3 ソース互換性" as C rectangle "4 Groovy アサート" as D A --> B B --> C C --> D @enduml</pre> </div> </div> <hr> <div class="paragraph"> <div class="title">図 2 — 互換性のない JHipster プラグイン</div> <p>目的：壊れたプラグインを隔離する。</p> </div> <div class="listingblock"> <div class="title">👉 依存関係の明確なビジョン.</div> <div class="content"> <pre>@startuml left to right direction title 修正が必要なプラグイン skinparam shadowing false skinparam roundcorner 18 rectangle "1 openApiGenerate" as A #FFF3E0 rectangle "2\ngitProperties\n2.5.7" as B #FFF3E0 rectangle "3 バージョン 修正された" as C #E3F2FD rectangle "4 組み立て OK" as D #E8F5E9 A --> B B --> C C --> D @enduml</pre> </div> </div> <hr> <div class="paragraph"> <p>�図3 — Docker 29 / Testcontainers</p> </div> <div class="paragraph"> <p>目的 : 実行時問題。</p> </div> <div class="listingblock"> <div class="title">👉 ランタイムの明瞭な歴史</div> <div class="content"> <pre>@startuml left to right direction title Docker 29 + Testcontainers skinparam shadowing false skinparam roundcorner 18 skinparam defaultFontSize 14 rectangle "1\n組み立て OK" as A #E8F5E9 rectangle "2 テスト Cucumber 失敗" as B #FFEBEE rectangle "3 Testcontainers 1.32 拒否された" as C #FFF3E0 rectangle "4 アップグレード バージョン" as D #E3F2FD rectangle "5 最終ビルド OK" as E #E8F5E9 A --> B B --> C C --> D D --> E @enduml</pre> </div> </div> <hr> <div class="listingblock"> <div class="title">もう一つの自分なりに表現する方法</div> <div class="content"> <pre>@startuml !option handwritten true skinparam backgroundColor #FEFEFE skinparam shadowing false skinparam defaultFontName Inter skinparam defaultFontSize 14 skinparam ArrowThickness 2 skinparam RoundCorner 18 title 安定化ロードマップ — Gradle 9 から最終ビルドまで left to right direction rectangle "⚙️ Gradle 9 への移行" as A #E3F2FD rectangle "🧩 プラグイン JHipster" as B #FFF3E0 rectangle "�🐳 Docker 29 Testcontainers" as C #FCE4EC rectangle "�✅ 安定ビルド" as D #E8F5E9 note bottom of A reportsDir mainClass sourceCompatibility Groovy assert end note note bottom of B openApiGenerate gitProperties versions alignées end note note bottom of C tests Cucumber KO image Docker rejetée upgrade libs end note A -[#42A5F5]-> B : corrections build.gradle B -[#FB8C00]-> C : assemble OK C -[#E53935]-> D : tests réparés @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_シーンjhipsterプロジェクトロードされなくなったビルド">シーン：JHipsterプロジェクト、ロードされなくなったビルド</h2> <div class="sectionbody"> <div class="paragraph"> <p>プロジェクト`edster`2024年に生成されたJHipsterアプリケーションです。ルートビルドスクリプト`build.gradle`数か月間、安定していた。それから、バージョンアップすることに決めた：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1428%;"> <col style="width: 7.1436%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">コンポーネント</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ターゲットバージョン</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">グラドル</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">9.4.1</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ジャバ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">21.0.11-tem (Eclipse Temurin)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">JHipster</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">8.x (フレームワーク`tech.jhipster:jhipster-framework:8.11.0`)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">スプリングブート</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">3.4.5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">コトリン</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">2.3.0</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Docker Engine</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">29.4.1 (API 1.54)</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>Javaバージョンの変更はSDKMANを通じて行われます :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sdk use java 21.0.11-tem</code></pre> </div> </div> <div class="paragraph"> <p>初回起動 :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ ./gradlew build --no-daemon FAILURE: Build failed with an exception. * Where: Build file '/home/.../edster/build.gradle' line: 18 * What went wrong: An exception occurred applying plugin request [id: 'jhipster.cucumber-conventions'] > Failed to apply plugin 'jhipster.cucumber-conventions'. > Could not create task ':cucumberTest'. > Could not create task ':consoleLauncherTest'. > Could not set unknown property 'reportsDir' for task ':consoleLauncherTest'</code></pre> </div> </div> <div class="paragraph"> <p>ビルドスクリプトのロードさえ行われず、問題は`buildSrc/src/main/groovy/jhipster.cucumber-conventions.gradle`.</p> </div> </div> </div> <div class="sect1"> <h2 id="_エラー_1_ファントム変数_reportsdir">エラー 1: ファントム変数 `reportsDir</h2> <div class="sectionbody"> <div class="paragraph"> <p>スクリプト`jhipster.cucumber-conventions.gradle`含む：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">tasks.register('consoleLauncherTest', JavaExec) { dependsOn(testClasses) String cucumberReportsDir = file("$buildDir/reports/tests") outputs.dir(reportsDir) // <-- reportsDir n'existe PAS classpath = sourceSets["test"].runtimeClasspath main = "org.junit.platform.console.ConsoleLauncher" // ... }</code></pre> </div> </div> <div class="paragraph"> <p>定義された変数は`cucumberReportsDir`. 使用されているものは`reportsDir`-- どこにも定義されていない。</p> </div> <div class="paragraph"> <p><strong>修正</strong>:`outputs.dir(cucumberReportsDir)`</p> </div> </div> </div> <div class="sect1"> <h2 id="_エラー_2_main_は_gradle_9_で存在しなくなりました">エラー 2 : <code>main = \"…​\"</code> は Gradle 9 で存在しなくなりました</h2> <div class="sectionbody"> <div class="paragraph"> <p>即時フォローアップ：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">Could not set unknown property 'main' for task ':consoleLauncherTest' of type org.gradle.api.tasks.JavaExec.</code></pre> </div> </div> <div class="paragraph"> <p>Gradle 9はプロパティを削除します`main`の利益のために`mainClass`タスクについて`JavaExec`.</p> </div> <div class="paragraph"> <p><strong>�訂正</strong>:`mainClass = "org.junit.platform.console.ConsoleLauncher"`</p> </div> </div> </div> <div class="sect1"> <h2 id="_エラー_3_sourcecompatibility_はもはやプロジェクトのプロパティではありません">エラー 3 : <code>sourceCompatibility</code> はもはやプロジェクトのプロパティではありません</h2> <div class="sectionbody"> <div class="paragraph"> <p>新しいエラー：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">Could not set unknown property 'sourceCompatibility' for root project 'edster' of type org.gradle.api.Project.</code></pre> </div> </div> <div class="paragraph"> <p>ルートスクリプトは持っていた：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">sourceCompatibility=17 targetCompatibility=17</code></pre> </div> </div> <div class="paragraph"> <p>グラドル9はルートレベルでこれらのプロパティを削除します。これらのプロパティはブロック内に存在する必要があります。<code>java</code>.</p> </div> <div class="paragraph"> <p><strong>修正</strong> :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">java { sourceCompatibility = JavaVersion.VERSION_21 targetCompatibility = JavaVersion.VERSION_21 }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_エラー_4_3項演算子の_groovy_アサーション">エラー 4 : 3項演算子の Groovy アサーション</h2> <div class="sectionbody"> <div class="paragraph"> <p>古いスクリプトには:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">assert System.properties["java.specification.version"] == "17" || "21" || "24"</code></pre> </div> </div> <div class="paragraph"> <p>Groovyでは,<code>"21"</code> et <code>"24"`は strings truthy。 式は …​ に解決されます</code>(…​ == "17") || true || true`, これは常に真である — しかし、構文は望まれる厳密なアサーションには無効です。</p> </div> <div class="paragraph"> <p><strong>修正</strong>:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">assert System.properties["java.specification.version"] in ["17", "21", "23", "24"]</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_エラー_5_暗黙の依存_compilekotlin_openapigenerate">エラー 5 : 暗黙の依存 <code>compileKotlin</code> → `openApiGenerate</h2> <div class="sectionbody"> <div class="paragraph"> <p>ビルドが進行しています。Kotlinのコンパイルに成功しました。その後：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">Task ':compileKotlin' uses this output of task ':openApiGenerate' without declaring an explicit or implicit dependency.</code></pre> </div> </div> <div class="paragraph"> <p>Gradle 9 は暗黙的なタスク間の依存関係を拒否します。以来`compileKotlin`生成されたソースを読む`openApiGenerate`、リンクを宣言する必要がある。</p> </div> <div class="paragraph"> <p><strong>�訂正</strong>中に`build.gradle`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">afterEvaluate { tasks.named("compileKotlin").configure { dependsOn(tasks.named("openApiGenerate")) } }</code></pre> </div> </div> <div class="paragraph"> <p>Le `afterEvaluate`必要です なぜなら`openApiGenerate`est une extension (plugin OpenAPI Generator) et non une tâche directement accessible pendant la phase de configuration. → Japanese translation:</p> </div> <div class="paragraph"> <p>これは OpenAPI Generator プラグインの拡張機能であり、構成フェーズにおいて直接アクセス可能なタスクではありません。</p> </div> </div> </div> <div class="sect1"> <h2 id="_エラー_6_generategitproperties_で壊れる_filteroutputstream_write">エラー 6 : <code>generateGitProperties</code> で壊れる `FilterOutputStream.write()</h2> <div class="sectionbody"> <div class="paragraph"> <p>Javaのコンパイルが通ります。リソースが処理されます。次に：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">> Task :generateGitProperties FAILED No signature of method: java.io.FilterOutputStream.write() is applicable for argument types: (Integer) values: [103]</code></pre> </div> </div> <div class="paragraph"> <p>プラグイン`gradle-git-properties`version 2.5.0 は Java 21 / Gradle 9 と互換性がありません。内部バグが呼び出しを試みます`write(int)`Groovy経由でそれを閉じたストリーム上で</p> </div> <div class="paragraph"> <p><strong>修正</strong>中に`gradle.properties` :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties">gitPropertiesPluginVersion=2.5.7</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_最後にtestcontainersが舞台に登場">最後に：Testcontainersが舞台に登場</h2> <div class="sectionbody"> <div class="paragraph"> <p>今のところ、これは純粋な "build script debugging" でした。各エラーは、ビルドスクリプトにおけるGradle 9またはJava 21の互換性の問題でした。前述の6つの修正後、`./gradlew assemble`成功裏に通ります。</p> </div> <div class="paragraph"> <p>しかし`./gradlew build`実行し、Cucumberのテストも Testcontainers を使って一時的な PostgreSQL を起動します。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">Could not find a valid Docker environment. EnvironmentAndSystemPropertyClientProviderStrategy: failed with exception BadRequestException (Status 400: {"message":"client version 1.32 is too old. Minimum supported API version is 1.40"} UnixSocketClientProviderStrategy: failed with exception BadRequestException (Status 400: {"message":"client version 1.32 is too old. Minimum supported API version is 1.40"}</code></pre> </div> </div> <div class="paragraph"> <p>TestcontainersはDockerと通信できません。異なる2つの戦略（環境変数＋Unixソケット）が同じエラーで失敗します。</p> </div> <div id="diag-docker-handshake" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam handwritten false actor "Testcontainers 1.20.6" as TC participant "docker-java 3.4.1" as DJ participant "Docker Engine 29.4.1" as DE TC -> DJ : new DockerClient() DJ -> DE : GET /_ping\nUser-Agent: docker-java/3.4.1\nAPI-Version: 1.32 DE --> DJ : HTTP 400 Bad Request\nclient version 1.32 is too old.\nMinimum supported API version is 1.40 DJ --> TC : BadRequestException TC --> TC : Could not find a valid\nDocker environment note right of DE Docker Engine 29.x impose API minimum = 1.40 (défaut ancien : 1.24) end note note left of DJ docker-java 3.4.1 envoie hardcoded API version 1.32 dans l'en-tête HTTP end note @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_phase_1_docker_javaのトラック">Phase 1 : docker-javaのトラック</h2> <div class="sectionbody"> <div class="paragraph"> <p>まず最初に、Testcontainers が使用する Docker Java クライアントは、API のバージョンを送信します。<code>1.32`そのHTTPハンドシェイクにおいてですが、Docker Engine 29.4.1は最低限`1.40</code>. 問題はクライアント側にあり、デーモン側ではありません。</p> </div> <div class="paragraph"> <p>Testcontainers 1.20.6 によって解決された docker-java のバージョンの確認 :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ ./gradlew dependencies --configuration testRuntimeClasspath | grep docker-java +--- com.github.docker-java:docker-java-api:3.4.1 +--- com.github.docker-java:docker-java-transport:3.4.1</code></pre> </div> </div> <div class="paragraph"> <p>docker-java 3.4.1（Testcontainers 1.20.6 から）。docker-java の最新のパブリックバージョンは 3.5.1 です。バージョンアップを強制するために`resolutionStrategy`ブロックの中`configurations` de <code>build.gradle</code>:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">configurations { all { resolutionStrategy.eachDependency { details -> if (details.requested.group == "com.github.docker-java" && details.requested.name.startsWith("docker-java")) { details.useVersion("3.5.1") } } } }</code></pre> </div> </div> <div class="paragraph"> <p>ビルドの再起動。同じエラー：<code>client version 1.32 is too old</code>。</p> </div> <div class="paragraph"> <p>Gradleキャッシュの確認：JARsは正しく再ダウンロードされましたが、エラーは依然として残っています。docker-java 3.5.1 はまだ送信しています`1.32`. このバージョンはしたがって Docker Engine 29.4.1 に対して十分ではありません。</p> </div> <div class="paragraph"> <p><strong>�浄化のアクション</strong>: Gradleキャッシュを完全にクリアして、念のため :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">rm -rf ~/.gradle/caches rm -rf /path/to/project/.gradle</code></pre> </div> </div> <div class="paragraph"> <p>パージ後に完全再起動。同じエラー。</p> </div> </div> </div> <div class="sect1"> <h2 id="_phase_2_ウェブ検索とgithubのパンくずリスト">Phase 2: ウェブ検索とGitHubのパンくずリスト</h2> <div class="sectionbody"> <div class="paragraph"> <p>docker-java 3.5.1 は不十分です。あとは、誰かがこの問題に正確に遭遇したかどうかを調べるだけです。</p> </div> <div class="paragraph"> <p>testcontainers-java と docker-java の issue に対するターゲット検索:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">site:github.com/testcontainers "client version 1.32 is too old" site:github.com/docker-java "client version 1.32" Docker Engine 29</code></pre> </div> </div> <div class="paragraph"> <p>最初の即時の結果：</p> </div> <div class="ulist"> <ul> <li> <p><a href="https://github.com/testcontainers/testcontainers-java/issues/11210">testcontainers-java#11210</a>—<code>[Bug]: client version 1.32 is too old. Minimum supported API version is 1.44</code></p> </li> <li> <p><a href="https://github.com/testcontainers/testcontainers-java/issues/11212">testcontainers-java#11212</a>—<code>[Bug]: Docker 29.0.0 could not find a valid Docker environment</code></p> </li> <li> <p><a href="https://github.com/testcontainers/testcontainers-java/issues/11491">testcontainers-java#11491</a>—<code>[Bug]: Incompatibility in Ubuntu Github runners with Docker Engine 29.1.*</code></p> </li> </ul> </div> <div class="paragraph"> <p>パンくずリストは明確です : Docker Engine 29.x は最低 API バージョンを`1.24`(古い欠陥) に`1.40`. Testcontainers 1.20.x は docker-java 3.4.x を使用し、API バージョンを送信してネゴシエートします。<code>1.32</code>. デーモンは礼儀正しくしかし固く拒否します。</p> </div> <div class="paragraph"> <p>issue #11491では、メンテナーが返信します:</p> </div> <div class="paragraph"> <p><em><em>_ ハイ、バージョン2.0.3で動作しているプロジェクトをGHランナー上でエンジン29.1を使用して実行しており、正常に動作しています。 皆さん、バージョンの競合がないかどうか確認していただけますか？ お忘れなく、すべてのモジュールはプリフィックスが付いていました`testcontainers-<code>。 それで、バージョン2.xから始めて、私たちはから進んできた`postgresql</code> to <code>testcontainers-postgresql</code> </em>_</em></p> </div> <div class="paragraph"> <p>この回答には<strong>重要な情報が2つ</strong></think> </think> (Note: Since no French text was provided after the colon, there is nothing to translate, so the output is empty.)</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>Testcontainers 2.0.3+ は問題を解決します</p> </li> <li> <p>モジュールは<strong>プレフィックス `testcontainers-`を付けてリネームされます</strong></p> </li> </ol> </div> </div> </div> <div class="sect1"> <h2 id="_フェーズ3_リネームされたアーティファクトの罠">フェーズ3 : リネームされたアーティファクトの罠</h2> <div class="sectionbody"> <div class="paragraph"> <p>名前の変更は厳しいです。Testcontainers 2.x では、以前の名前のいずれもその名前では機能しなくなりました：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 10%;"> <col style="width: 10%;"> <col style="width: 10%;"> <col style="width: 10%;"> <col style="width: 10%;"> <col style="width: 10%;"> <col style="width: 10%;"> <col style="width: 10%;"> <col style="width: 10%;"> <col style="width: 10%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">旧名 (1.x)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">新しい名前 (2.x)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>org.testcontainers:postgresql</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>org.testcontainers:testcontainers-postgresql</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>org.testcontainers:jdbc</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>org.testcontainers:testcontainers-jdbc</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>org.testcontainers:junit-jupiter</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>org.testcontainers:testcontainers-junit-jupiter</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>org.testcontainers:testcontainers</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">変更されていない</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>最初の試み : Testcontainers BOM 2.0.5 と新しいアーティファクト名を適用する`build.gradle`。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">dependencies { testImplementation platform("org.testcontainers:testcontainers-bom:2.0.5") testImplementation "org.testcontainers:testcontainers-postgresql" testImplementation "org.testcontainers:testcontainers-jdbc" testImplementation "org.testcontainers:testcontainers-junit-jupiter" testImplementation "org.testcontainers:testcontainers" }</code></pre> </div> </div> <div class="paragraph"> <p><code>./gradlew build</code></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">FAILURE: Could not find org.testcontainers:jdbc:2.0.5. Could not find org.testcontainers:junit-jupiter:2.0.5.</code></pre> </div> </div> <div class="paragraph"> <p><strong>testcontainers-bomのBOMだけでは十分ではありません。</strong>なぜ？ Spring Boot 3.4.5は独自の依存関係管理BOMを公開しているため（<code>spring-boot-dependencies</code>) 誰<strong>勝つ</strong>TestcontainersのBOMの transitive 解決において。 Spring Bootは修正します。<code>testcontainers</code> à <code>1.20.6</code>, したがって、Spring Boot BOMに明示的に含まれていないすべてのアーティファクト（新しいものなど）は`testcontainers-*<code>) 彼らは古い名前に向かって解決する`1.20.6</code>-- このバージョンでは存在しなくなりました。</p> </div> <div class="paragraph"> <p>検査している際の`dependencies --configuration testRuntimeClasspath`, 見つかる :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">+--- org.testcontainers:testcontainers -> 1.20.6 (*) | \--- org.testcontainers:testcontainers:2.0.5 -> 1.20.6</code></pre> </div> </div> <div class="paragraph"> <p>Le <code>→`置換を示します : Testcontainers 2.0.5 は <strong>要求されています</strong>, しかし Spring Boot は強制します`1.20.6</code>.</p> </div> <div id="diag-bom-war" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam handwritten false skinparam componentStyle rectangle left to right direction component "build.gradle (消費者)" as BG #E3F2FD { rectangle "要求 `testcontainers-bom:2.0.5" as REQ rectangle "要求 `testcontainers-postgresql" as REQ2 } component "Mavenセントラル" as MC #FFF3E0 component "声明" as DEC #E8F5E9 { rectangle "testcontainers-bom:2.0.5` 修正 2.0.5" as BOM2 rectangle "spring-boot-dependencies:3.4.5` 修正 1.20.6" as BOM1 } component "Gradle 解決" as RES #FFEBEE { rectangle "勝ち抜いたバージョン `testcontainers:1.20.6" as WIN #EF9A9A } BG --> DEC : "BOMsを分析する" BOM2 --> RES : "バージョン2.0.5を提案" BOM1 --> RES : "提案 1.20.6" WIN -> MC : "ダウンロード testcontainers:1.20.6" note bottom of WIN Spring Boot BOM prime car le plugin spring-boot applique ses dépendances de gestion après la résolution du consommateur end note @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_フェーズ4解決を強制する">フェーズ4：解決を強制する</h2> <div class="sectionbody"> <div class="paragraph"> <p>戦略は二重になります：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>docker-java のバージョンを 3.7.1 に固定する（Docker Engine 29 と互換性があるとテスト済み）</p> </li> <li> <p>Spring BootのBOMを回避してTestcontainersコアを2.0.5に強制する</p> </li> </ol> </div> <div id="diag-resolution-override" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam handwritten false skinparam componentStyle rectangle left to right direction component "build.gradle (resolutionStrategyを使用して)" as BG #E8F5E9 { rectangle "BOM テストコンテナーズ `2.0.5" as BOM2 rectangle "resolutionStrategy\n.eachDependency" as RS #66BB6A } component "解決済み" as RESOLVED #E3F2FD { rectangle "docker-java `3.7.1` (強制)" as DJ rectangle "testcontainers `2.0.5` (強制)" as TC #81C784 rectangle "testcontainers-postgresql `2.0.5" as TPG rectangle "testcontainers-jdbc `2.0.5" as TJ rectangle "testcontainers-junit-jupiter `2.0.5" as TJJ } component "BOM Spring Boot (暗黙の, オーバーライドされた)" as BOM1 #FFEBEE component "マーベンセントラル" as MC #FFF3E0 BG --> RESOLVED : "BOM Testcontainers 2.0.5 直接通ります" RS -> DJ : "力 3.7.1" RS -> TC : "力 2.0.5" RESOLVED --> MC : "JARsをダウンロード Docker 29 と互換性がある" BOM1 -[#gray,dashed]-> RESOLVED : "testcontainersで無視された\nそして docker-java" note bottom of RS Le `eachDependency` intercepte la résolution Gradle AVANT que le BOM Spring Boot ne gagne. C'est une intervention chirurgicale. end note @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>最終修正</strong>中に`build.gradle`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">configurations { all { resolutionStrategy.eachDependency { details -> if (details.requested.group == "com.github.docker-java" && details.requested.name.startsWith("docker-java")) { details.useVersion("3.7.1") } if (details.requested.group == "org.testcontainers" && details.requested.name == "testcontainers") { details.useVersion("2.0.5") } } } } dependencies { testImplementation platform("org.testcontainers:testcontainers-bom:2.0.5") testImplementation "org.testcontainers:testcontainers-jdbc" testImplementation "org.testcontainers:testcontainers-junit-jupiter" testImplementation "org.testcontainers:testcontainers-postgresql" testImplementation "org.testcontainers:testcontainers" // ... autres dépendances Spring Boot }</code></pre> </div> </div> <div class="paragraph"> <p>Le `resolutionStrategy.eachDependency`はBOMをバイパスする唯一の方法だ`spring-boot-dependencies`管理されている Spring Boot プラグインによって。等しさのテストは`details.requested.name == "testcontainers"`は意図的に制限的です：コアモジュールのみを強制します。モジュール`testcontainers-*`Testcontainers 2.0.5のBOM（明示的に宣言したもの）に従います。</p> </div> </div> </div> <div class="sect1"> <h2 id="_最終結果">最終結果</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ ./gradlew build --no-daemon > Task :consoleLauncherTest [2 containers found] [2 containers started] [2 containers successful] BUILD SUCCESSFUL in 1m 16s</code></pre> </div> </div> <div class="paragraph"> <p>Testcontainers 2.0.5 + docker-java 3.7.1 は、Docker Engine 29.4.1 を介して PostgreSQL コンテナを finally 作成できるようになりました。最終的なビジネスエラー（Cucumber テストでの HTTP 500）は、ビルドスクリプトとは完全に独立したアプリケーションの問題です。</p> </div> </div> </div> <div class="sect1"> <h2 id="_修正のサマリーテーブル">修正のサマリーテーブル</h2> <div class="sectionbody"> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 25%;"> <col style="width: 25%;"> <col style="width: 25%;"> <col style="width: 25%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">#</th> <th class="tableblock halign-left valign-top">ファイル</th> <th class="tableblock halign-left valign-top">問題</th> <th class="tableblock halign-left valign-top">修正</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>buildSrc/src/main/groovy/jhipster.cucumber-conventions.gradle</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">変数`reportsDir`存在しない</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>outputs.dir(cucumberReportsDir)</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>buildSrc/src/main/groovy/jhipster.cucumber-conventions.gradle</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">`main`非推奨の Gradle 9</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>mainClass</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>build.gradle</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">`sourceCompatibility`トップレベルでは Gradle 9 は禁止されています</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ブロック`java { sourceCompatibility = JavaVersion.VERSION_21 }`</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>build.gradle</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Groovyのアサーションの構文が無効です</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>assert …​ in ["17", "21", "23", "24"]</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>build.gradle</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">暗黙的依存`compileKotlin`→<code>openApiGenerate</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>afterEvaluate { tasks.named("compileKotlin").dependsOn("openApiGenerate") }</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">6</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>gradle.properties</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">`gitPropertiesPluginVersion`互換性のない Java 21</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>2.5.7</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">7</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Gradle キャッシュ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">docker-java 3.5.1 テスト済み、解決されたが不十分です</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">パージュ + 通過 docker-java 3.7.1</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">8</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>build.gradle</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Testcontainers 1.20.6 は Docker Engine 29 と互換性がありません</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Testcontainers 2.0.5 + プレフィックスの強制`testcontainers-*`+ resolutionStrategy と Spring Boot BOM の比較</p></td> </tr> </tbody> </table> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>JHipster/GradleのビルドがGradle 9 + Docker Engine 29へのアップグレード後にクラッシュする場合、エラーは2つのカテゴリに分類されます：</p> </div> <div class="paragraph"> <p><strong>ビルドスクリプトのエラー</strong>(最初の6つ) : Gradle 9は、何年も機能していたプロパティと構文を削除します (<code>sourceCompatibility=</code>, <code>main =</code>, `reportsDir`これらは新しいAPIを知った後の機械的な移行です。</p> </div> <div class="paragraph"> <p><strong>Dockerランタイムエラー</strong>(最後の2つ) : Docker Engine 29.4.1 は API バージョン < 1.40 のクライアントを除外します。 Testcontainers 1.20.6 (Spring Boot 3.4.5 によって強制されます) は、API バージョン 1.32 を送信する docker‑java 3.4.1 を使用します。 問題を解決するのは、アーティファクトの名前変更とバージョンの強制を経由で行われる Testcontainers 2.0.5 + docker‑java 3.7.1 のみです。`resolutionStrategy.eachDependency`Spring Bootの暗黙のBOMを回避する唯一の手段として。</p> </div> <div class="paragraph"> <p>プロジェクトのルートにある Gradle ビルドスクリプトは現在きれいです。`./gradlew build`Java 21、Gradle 9.4.1、Spring Boot 3.4.5、Docker Engine 29.4.1 に移行しました。</p> </div> </div> </div> https://cheroliv.com/blog/2026/0108_gouvernance_agent_opencode_eager_lazy_post.html Fri, 24 Apr 2026 00:00:00 +0000 blog/2026/0108_gouvernance_agent_opencode_eager_lazy_post.html <div class="sect1"> <h2 id="_要約">要約</h2> <div class="sectionbody"> <div class="paragraph"> <p>Opencode のような AI エージェントと複数のセッションにわたる複雑なプロジェクトで作業するとき、根本的な問題に直面します：<strong>コンテキストの漏洩</strong>. エージェントは前のセッションを覚えていない。彼/彼女に説明されたすべて — アーキテクチャ、慣習、バックログの状態 — が失われている。このコンテキストを毎回再構築するのはコストがかかり、遅く、エラーの原因となる。</p> </div> <div class="paragraph"> <p>この記事では、私がこの問題を解決するために構築した職人的戦略を紹介します：AsciiDocファイルに基づく持続的なガバナンスシステム、二分法を含む<strong>熱心な/怠惰な</strong>コンテキストトークンの消費を最適化するために、そして一つ<strong>必須のセッション終了手続き</strong>継続性を確保するために。</p> </div> </div> </div> <div class="sect1"> <h2 id="_シーン月曜日_4月21日_9時00分">シーン：月曜日 4月21日 9時00分</h2> <div class="sectionbody"> <div class="paragraph"> <p>Opencodeを再開して、Gradleプラグインの作業を再開します`plantuml-plugin`. 昨晩、私は三時間を費やして、APIキーのプールアーキテクチャのエージェントと議論しました — ラウンドロビンローテーション、クォータ管理、自動フォールバック。今朝、そのエージェントは私を見て、金魚の目のように見つめました。</p> </div> <div class="paragraph"> <p><em><em>_ — こんにちは、私はOpencodeのアシスタントです。今日はどのようにお手伝いできますか？ </em>_</em></p> </div> <div class="paragraph"> <p>ない — あー、はい、 APIキーのプール, 私たちはYAMLの構造のところまで来ていた。 ない — 注意,<code>PlantumlManager`これは Kotlin のシングルトンオブジェクトであって、クラスではありません。いいえ — いいえ、昨日決めたのは`SyntaxValidationResult`残っていた密封クラスのネストされた内部`PlantumlService</code>.</p> </div> <div class="paragraph"> <p>全部やり直さなければならない。むしろ、すべてを再説明する必要がある。私はセッションの最初の20分を、昨日エージェントがすでに手にしていたコンテキストを再構築することに費やす。トークンを無駄にした20分。コードを書けるはずの20分なのに、必須の教育的説明に時間を費やしている。</p> </div> <div class="paragraph"> <p>Opencodeのバグではありません。これは会話型LLMの本質です：セッション間では、作業メモリは<strong>完全に削除された</strong>. エージェントは前の任務を覚えておらず、下された決定、特定された罠、私たちが一緒に書いたコードも覚えていません。</p> </div> <div class="paragraph"> <p>私はそれを何十回も経験しました。同時に4つのプロジェクトで、週をまたいで続くセッションが続いています。平均して,<strong>セッション時間の30％～40％</strong>はエージェントを再文脈化することに専念していた。 プロジェクトのセッション87において`plantuml-plugin`, 我慢できなくなった。これ以上、十回目になる説明をする余裕がなかった`AttemptEntry`トップレベルのデータクラスである`DiagramProcessor.kt`。</p> </div> <div class="paragraph"> <p>システムが必要だった。ハックではない。真のガバナンス。</p> </div> </div> </div> <div class="sect1"> <h2 id="_創世記カオスからメソッドへ">創世記：カオスからメソッドへ</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_最初のセッション暗黒時代">最初のセッション：暗黒時代</h3> <div class="paragraph"> <p>Opencode との私の最初のプロジェクト,<code>plantuml-plugin</code>, 何のガバナンスもなく開始した。質問を投げかけ、エージェントが答え、繰り返し、セッションが終了し、翌日はゼロからやり直す。それはセッション1で、続いてセッション2、セッション3…​そしてセッション62まで続き、そこで私は同じアーキテクチャを何度も説明し続けて累計何時間も失ったことに気付いた。</p> </div> <div class="paragraph"> <p>第62回のセッションでは、数字はここにあります：<strong>198の単体テストがパスします</strong>, <strong>42つの機能テストが検証済み</strong>, プラグインは動作します。 しかし、認知的コストは耐え難いです。 新しいセッションごとに、プロジェクトの構造についての20分間の独白から始まります。</p> </div> </div> <div class="sect2"> <h3 id="_site_yml_の_エピソードが破壊されました_セッション_2_bakery_plugin">site.yml の エピソードが破壊されました (セッション 2, bakery-plugin)</h3> <div class="paragraph"> <p>この方法も災害から生まれます。 プロジェクトについて`bakery-gradle`, セッション 2 で、エージェントにファイルを変更するように依頼します。<code>site.yml</code>. エージェントは、ファイルがバージョン管理されているか確認せずに、する`Write`内容を上書きする。結果: 実際のトークン（Firebase APIキー、デプロイシークレット）は偽のプレースホルダーに置き換えられます。ファイルはgitに入っていなかった — それは…​にあった`.gitignore`秘密を守るために。</p> </div> <div class="paragraph"> <p>バックアップなし。なし`git restore`可能です。 私は詰まっています。 設定ファイルを手動で再構築し、パスワードマネージャーからトークンを見つけ出し、すべてを元に戻す必要があります。</p> </div> <div class="paragraph"> <p>それはこのフラストレーションから生まれる<strong>絶対ルール 1b</strong> :</p> </div> <div class="paragraph"> <p><em><em>_ <strong>決して潰さない</strong>設定ファイルと`Write`完了するとき`Edit`部分的に十分です。<strong>決して置き換えてはいけません</strong>� 機密の値をダミーの値で。<strong>確認する <code>git check-ignore</code> と `git ls-files</strong>変更の前に </em>_</em></p> </div> <div class="paragraph"> <p>この規則は、今では私のすべてのファイルに石に刻まれているように固定されています`AGENT.adoc` et `INDEX.adoc`4つのプロジェクトにおいて、実際のミスから生まれ、私に1時間の手作業のコストをかけた。</p> </div> </div> <div class="sect2"> <h3 id="_markdown_asciidoc_の移行セッション_1cheroliv_com">Markdown → AsciiDoc の移行（セッション 1、cheroliv.com）</h3> <div class="paragraph"> <p>2026年4月25日、<code>cheroliv.com</code>, 私は抜本的な決定を下す：Markdown のガバナンス全体を AsciiDoc に変換する。これは美的ではない。機能的だ。AsciiDoc は LLM がよりよく読める意味構造を提供する：階層的セクション、型付きテーブル、アドモニション (<code>NOTE</code>, <code>WARNING</code>, <code>CAUTION</code>), マシン可読のドキュメント属性</p> </div> <div class="paragraph"> <p>セッション 1 の`cheroliv.com`構造を形式化する：</p> </div> <div class="ulist"> <ul> <li> <p>変換の`AGENTS.md` en <code>AGENT.adoc</code></p> </li> <li> <p>専門エージェントの作成:`CODER.adoc`, <code>SCRUM_MASTER.adoc</code>, <code>PLANTUML_DESIGNER.adoc</code></p> </li> <li> <p>Eager/Lazy構造の作成：<code>INDEX.adoc</code>, <code>SESSIONS_HISTORY.adoc</code>, <code>AGENT_SESSION_MANAGER.adoc</code>, <code>SESSION_CHECKLIST.adoc</code>, <code>PROCEDURES.adoc</code></p> </li> </ul> </div> <div class="paragraph"> <p>1つのコミット：<code>90975e9 refactor: migrate agent governance from Markdown to AsciiDoc</code>. そしてサイトは引き続き機能しています。</p> </div> <div id="diag-timeline" class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam handwritten false title セッションの進化 — セッション1から150+まで legend top |= Couleur |= Projet | | <#4CAF50> | cheroliv.com | | <#2196F3> | plantuml-plugin | | <#FF9800> | bakery-plugin | | <#9C27B0> | magic-stick | endlegend concise "アクティブなセッション" as S @S 0 is ".md 生" 1 is "移行\nAsciiDoc" 10 is "Eager/Lazy\n形式化された" 62 is "安全ルール (site.yml)" 87 is "クラック コンテキスト" 109 is "最適化 -60% トークン" 133 is "133回のセッション\n240テスト合格" S@0 -> S@1 : Session 1\n(cheroliv.com) S@1 -> S@10 S@10 -> S@62 : Session 62\n(plantuml-plugin) S@62 -> S@87 : Session 87\n(Cry 4 help) S@87 -> S@109 : Session 109\n(API Key Pool) S@109 -> S@133 : Session 133\n(Aujourd'hui) @enduml</pre> </div> </div> <div class="paragraph"> <p>上記のタイムラインは実際の進行を示しています。転換点はセッション87です。ここで繰り返しの再コンテキスト化のフラストレーションが許容閾値を超え、Eager/Lazyメソッドは単なるアイデアではなく義務となります。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_戦略深掘りeagerlazy">戦略：深掘りEager/Lazy</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_哲学_認知への応用コンピューティングキャッシュ">哲学 : 認知への応用コンピューティングキャッシュ</h3> <div class="paragraph"> <p>私のアプローチは、コンピュータのキャッシュ管理から直接インスピレーションを得ています。すべてが<strong>批判的で頻繁に使用される</strong>すぐにアクセス可能でなければならない<strong>熱心な</strong>あるものはすべて<strong>コンテキスト依存のまたは大容量の</strong>� 必要に応じてロードされなければならない (<strong>怠惰な</strong>).</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6666%;"> <col style="width: 6.6676%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Eager (ダッシュボード)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Lazy (オーナーマニュアル)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>サイズ</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">< 100 行, < 10k トークン</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">無制限、詳細</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>読み込み</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">自動、セッション開始時</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">エージェントの要請により</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>内容</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">絶対的なルール、通常の任務、危機的な状態</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">セッションアーカイブ、完全な履歴、詳細な手順、技術資料</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>役割</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">エージェントをすぐに方向づける</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">深いコンテキストの質問に答える</p></td> </tr> </tbody> </table> </div> <div class="sect2"> <h3 id="_eager_ファイル_ダッシュボード">Eager ファイル : ダッシュボード</h3> <div class="paragraph"> <p>これらのファイルは各プロジェクトのルートに存在し、エージェントによって各セッションの開始時に自動的に読み込まれます。それらは<strong>ダッシュボード</strong>-- 重要な情報、すぐにアクセス可能。</p> </div> <div id="diag-eager-lazy" class="listingblock"> <div class="content"> <pre>@startuml skinparam defaultTextAlignment center skinparam wrapWidth 200 package "プロジェクトのルート (Eager - 自動読み込み)" { component "<b>AGENT.adoc</b> 絶対のルール 構造 & 慣習" as AGENT component "<b>PROMPT_REPRISE.adoc</b> セッション Nのミッション 概要 N-1" as PROMPT component "<b>INDEX.adoc</b> エントリーポイント ルール + セッション" as INDEX component "<b>*_ESSENTIALS.adoc</b>\n業務コンテキスト\n重要" as ESS } package ".agents/ (Lazy - オンデマンドで読み込み)" { component "<b>sessions/N-*.adoc</b>\n詳細なアーカイブ\n決定 & 出力" as SESS component "<b>SESSIONS_HISTORY.adoc</b> サマリーテーブル 日付/タイプ/スコア" as HIST component "<b>PROCEDURES.adoc</b> セッション終了テンプレート 6ステップ" as PROC component "<b>*_REFERENCE.adoc</b> 完全なアーキテクチャ 技術参照" as REF component "<b>COMPLETED_TASKS_ARCHIVE</b> 完了したタスク 月ごと" as ARCH component "<b>AGENT_MODUS_OPERANDI.adoc</b> 戦略ドキュメント 方法論" as MOD component "<b>*_REFERENCE.adoc</b> Boot tests, A/B partition 特定のコンテキスト" as SPEC } AGENT --> PROMPT : "参考文献" AGENT --> INDEX : "参考文献" INDEX --> SESS : "インデックスする" INDEX --> HIST : "インデックスする" INDEX --> PROC : "参照" INDEX --> ARCH : "参照" INDEX --> REF : "参照" PROMPT --> SESS : "アーカイブ N-1" PROMPT --> ESS : "ビジネスコンテキスト N" @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>AGENT.adoc</strong>-- マスターファイル。について`cheroliv.com`, 200行あり、以下を含みます :</p> </div> <div class="ulist"> <ul> <li> <p>プロジェクトの絶対的なルール（コミットは許可がなければ、`rm`確認なし)</p> </li> <li> <p>プロジェクトの構造とコーディング規約</p> </li> <li> <p>基本的なコマンド (<code>./gradlew serve</code>, <code>./gradlew test</code>)</p> </li> <li> <p>エピックとプロダクトバックログ(優先順位付けられたユーザーストーリー)</p> </li> <li> <p>横断的な品質基準（アクセシビリティ、レスポンシブ、互換性）</p> </li> </ul> </div> <div class="paragraph"> <p>上`bakery-plugin`, ルール0は異なります :<strong>./gradlew -q publishToMavenLocal` ソースコードを変更するたびに必須です</strong>. ローカル JAR を再公開せずにプラグインをテストしたため、まだパッケージ化されていないコードをデバッグするのに1時間も無駄にしてしまった。</p> </div> <div class="paragraph"> <p><strong>PROMPT_REPRISE.adoc</strong>-- 現在のセッションのミッション。各セッションの終了時に更新され、以下を含みます：</p> </div> <div class="ulist"> <ul> <li> <p>セッション番号と優先ミッション</p> </li> <li> <p>前回のセッションのまとめ（行われたこと、まだやるべきこと）</p> </li> <li> <p>現在のセッションの受入基準</p> </li> <li> <p>特定の技術的なリマインダー</p> </li> </ul> </div> <div class="paragraph"> <p><strong>.agents/INDEX.adoc</strong>-- エントリーポイント。これは絶対的なルール、最近のセッション、そして特に<strong>プロジェクトポートフォリオ</strong>同じ方法論で管理されています。今日現在、ここに5つのプロジェクトが掲載されています :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">---- ---- | magic-stick | Session 23 | SCRIPT_VERIFICATION.adoc | 2026-04-27 | | bakery-gradle | Session 11 | TEST_COVERAGE_ANALYSIS | 2026-04-27 | | cheroliv.com | Session 9 | TEST_COVERAGE_ANALYSIS | 2026-04-27 | | plantuml-gradle| Session 133| TEST_COVERAGE_ANALYSIS | 2026-04-23 | | jhipster-gradle-plugins | Session 1 | TEST_COVERAGE_ANALYSIS | 2026-04-28 | ---- (No content)`*_ESSENTIALS.adoc`-- Session 109（plantuml-plugin）による最近の追加で、Eagerコンテキストをさらに最適化。API キー プール上のビジネス コンテキスト 200 行をロードする代わりに、必須の 50 行だけをロードし、残りの 150 行は LAZY の状態のままにしておきます`*_REFERENCE.adoc`. �測定結果 : ～への移行**~25k トークン EAGER から ~10k トークン**(60%の利益)。エージェントはもはやエネルギーを消費するリマインダーを必要としない。 ==== 欠落しているリンク : `opencode.json 実は告白しておかなければならないことがあります。ドキュメントに残すのをうっかり忘れそうになったことです。これらの .adoc ファイルの上には、動作に不可欠な極めて小さな JSON ファイルがあります。それは`opencode.json`そして六行です。文字通り六行です。 [source,json] ---- { "$schema": "https://opencode.ai/config.json", "instructions": [ "AGENT.adoc" ] } ---- このファイルがOpencodeに伝える：「起動時に、ロード」`AGENT.adoc`「自動的に。」 彼がいないと、エージェントは私が記事の冒頭で説明した通り、真っ白なページです。彼がいると、エージェントはすでに絶対的なルール、プロジェクトのアーキテクチャ、そして必須のコマンドを手にしています — 私が「こんにちは」と言う前でも。 私は偶然、このファイルの重要性に気づきました。 上で`bakery-plugin`, それは存在していなかった。私はなぜそのエージェントが他のプロジェクトよりもこのプロジェクトで系統的にもっと「迷子」だったのか疑問に思っていた。絶対的なルールは確かにその中にあった`AGENT.adoc`— しかし`AGENT.adoc`一度も充電されていなかった。 エージェントは私が読むように言ったものだけを、各セッションごとに手動で読んでいた。 これはセッション11の`bakery-plugin`私がその欠如に気づいたとき`opencode.json`. 私はそれを作成しました — そしてセッション12は他のセッションと同様に開始されました。 このファイルは今では私にとってとても明白で、もうそれについて考えることすらしなくなった。ツールに詳しすぎる開発者が陥りがちな典型的なミスだ。今日では、私はこれを常に*avant*作成するようにしている。`AGENT.adoc`. これが最初の石です。 ==== INDEX.adoc`の二重性 もう一つ、明確にすべき微妙な点があります：`INDEX.adoc`に住んでいる`.agents/`— LAZYとして提示したフォルダ。しかし、私はこれをすべてのテーブルでEAGERとしてリストしている。ここには明らかな緊張がある。 実際の現場 : ファイル`.agents/INDEX.adoc`自動的に正しく読み込まれ、同様に`AGENT.adoc` et `PROMPT_REPRISE.adoc`. 彼らは中に`.agents/`組織上の理由により — 根を侵さないように — しかし、彼らの動作はEAGERである。 上に`plantuml-plugin`, `INDEX.adoc`これは200行で、過去のセッションの教訓である歴史とともに、絶対に*完全な*ルール、スコア付きのEPIC、そしてプロジェクトのポートフォリオを含んでいます。これはエージェントが「現在の状況」を確認するために参照するドキュメントです。Sur`bakery-plugin`, 最近のロードマップとセッションで150行です。 意図的な冗長性の間`AGENT.adoc` et `INDEX.adoc`� 驚くかもしれません。 絶対的なルールは両方に存在します。 なぜ？ なぜなら、それらは二つの異なる役割を果たしているから：の中で`AGENT.adoc`, それらは*説明的*です (ルールのストーリーテリング、学んだ教訓) ; 中で`INDEX.adoc`, それらは *実行可能* (裸のルール、正当化なし、迅速な参照のため)。 エージェントは読む`AGENT.adoc`一度理解するために；彼は読み返す`INDEX.adoc`各セッションで*適用*する。2つの用途、2つのフォーマット。 [plantuml, format=svg, id=diag-dualite-agent-index, alt="Comparaison entre AGENT.adoc (narratif) et INDEX.adoc (exécutif)"] ---- @startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center title 二重性 AGENT.adoc ←→ INDEX.adoc left to right direction rectangle "AGENT.adoc (根 — EAGER)" as AGENT #E3F2FD { rectangle "**ナラティブフォーマット** ルールのストーリーテリング 学んだ教訓、コンテキスト" as NARR rectangle "🏗️**完全なアーキテクチャ** プロジェクト構造、コンポーネント 詳細なユーザーストーリーバックログ" as ARCHI rectangle "📋 **解説ルール** なぜルールは存在するのか インシデントの履歴" as EXPL } rectangle "INDEX.adoc\n(.agents/ — EAGER)" as INDEX #E8F5E9 { rectangle "⚡ **エグゼクティブフォーマット** 裸のルール、正当化なし 迅速な相談" as EXEC rectangle "📊 **Roadmap & EPICs** サマリーテーブル 進行状況, スコア, 優先度" as ROAD rectangle "🌐 **プロジェクトポートフォリオ** 横断ビュー 5つの同期プロジェクト" as PORT } AGENT --> INDEX : "Agent が AGENT.adoc を 1 回 読んで **理解する**" INDEX --> AGENT : "AgentはINDEX.adocを読み直しました 各セッションで**適用**する" note bottom of AGENT Taille max : 200 lignes end note note bottom of INDEX Taille max : 200 lignes Source de vérité en cas de divergence end note @enduml ---- この意図的な冗長性は設計上の選択です。これらはEAGERトークンの追加で約50行消費しますが、エージェントが常にルールを目の前に持てるように保証します。つまり、即時の従順を助ける簡潔なフォーマットでも同様です。 === LAZY ファイル: 所有者のためのマニュアル これらのファイルは[場所]に存在します`.agents/`それらは、エージェントが必要とする時だけ読まれる。それらは、方法の真の財産を構成する。なぜなら、それらは現在のコンテキストを汚すことなくプロジェクトの知識を蓄積するからである。 [plantuml, format=svg, id=diag-agents-tree, alt="Arborescence complète du dossier .agents/"] ---- @startuml skinparam folderBackgroundColor #E3F2FD skinparam folderBorderColor #1565C0 skinparam fileBackgroundColor #FFF3E0 skinparam fileBorderColor #EF6C00 folder ".agents/" as ROOT { file "INDEX.adoc (EAGER -- 200 行)" as IDX #E8F5E9 file "AGENT_SESSION_MANAGER.adoc\n(テンプレート セッション)" as ASM file "SESSION_CHECKLIST.adoc (いつ変更するか)" as CHK file "PROCEDURES.adoc\n(6段階 + LAZY/EAGER)" as PRO file "SESSIONS_HISTORY.adoc\n(すべてのセッション)" as HIS folder "セッション/" as SESS { file "1-chore-migration.adoc" as S1 file "109-形式化-lazy.adoc" as S109 #FFECB3 file "133-epic11-article.adoc" as S133 file "... +130 他の" as SMORE } folder "アーカイブ/" as ARCH { file "COMPLETED_TASKS_2026-04.adoc" as CTA file "SESSIONS_HISTORY_83-95.adoc" as SHIST folder "セッションのサマリー/" as SUM { file "SESSION_64_SUMMARY.adoc" as SU64 file "SESSION_73_SUMMARY.adoc" as SU73 file "..." as SUMORE } folder "プロンプトアーカイブ/" as PARCH { file "PROMPT_REPRISE_S65.adoc" as PR65 file "PROMPT_REPRISE_S75.adoc" as PR75 file "..." as PMORE } } } IDX --> SESS : "索引" IDX --> HIS : "索引" IDX --> ARCH : "参照" note right of S109 Session 109 = Formalisation stratégie LAZY/EAGER Token : ~25k → ~10k end note @enduml ---- 上記のツリー構造はフォルダーの実際の構造を示しています。`.agents/`上に`plantuml-plugin`, 最も成熟したプロジェクト。 注目してください 3層の深さ : ルートファイル（メタデータ）, ディレクトリ`sessions/`（年代順アーカイブ）, と ファイル`archives/`(集約と要約)。この深さが、単なるTODOファイルのガバナンスを変える**完全な組織記憶**。 **.agents/sessions/{N}-{titre}.adoc**-- 各セッションの詳細なアーカイブ。現在： * `plantuml-plugin`:**133件のアーカイブ済みセッション**(セッション1から133まで) * `bakery-plugin` : **11 セッション** * `magic-stick` : **23セッション** * `cheroliv.com` : **9 正式なセッション**+ 7セッション（プリシステム）が遡及的に再構築されました 各アーカイブはセッションの完全なコンテキスト、行われた決定、遭遇した問題とその解決、実行されたコマンドとその出力を含みます。 **.agents/SESSIONS_HISTORY.adoc**-- すべてのセッションのスコア付きサマリーテーブル。例:`cheroliv.com`: ---- | -6 | 2025-05 | chore | Initialisation projet Gradle/JBake | 7/10 | 1 | 2026-04-25 | chore | Migration gouvernance agent | 8/10 | 7 | 2026-04-27 | debug/fix | Correction publishSite | 9/10 | 8 | 2026-04-27 | analyse | Analyse article 0108 | 7/10 **.agents/COMPLETED_TASKS_ARCHIVE_{mois}.adoc**-- 完了したタスクを月ごとにアーカイブし、アクティブなバックログを過負荷にしないようにします。ユーザーストーリーが完了すると、ここに移行します。バックログは読みやすく保たれます：アクティブなアイテムは最大10個。 **.agents/PROCEDURES.adoc**-- 終了セッション手順の詳細なテンプレート。長いが、エージェントが方法を学ぶときに一度だけ読まれる。その後、手順は機械的になる。 **.agents/AGENT_MODUS_OPERANDI.adoc**完全な戦略ドキュメント。 上で`plantuml-plugin`, このファイルは**900+行**そして実際にはその名前が付いています`AGENT_METHODOLOGIES.adoc`— この記事を書いている間と実際に実装される間で、私は名前を変更しました。この種の命名のズレは、進化する職人製のシステムでは避けられない。重要なのは命名規則です：ファイルが*メソッド*を文書化している場合、それはで始まります。`AGENT_`または明示的なプレフィックス。Eager/Lazyの手法を文書化し、従うべきパターンと避けるべきアンチパターンを示しています。LAZYであるのは、エージェントが各セッションごとに戦略全体を読み直す必要がなく、あいまいさがあるときだけだからです。 (Empty)`*_REFERENCE.adoc`** -- プロジェクト固有の技術的参照。について`magic-stick`, 密集した2つのLAZYファイル: * `AB_PARTITION_REFERENCE.adoc`(147 行) -- A/B パーティション GPT アーキテクチャ, スクリプト`update-system.sh`, 推定サイズ, ロールバックメカニズム * `BOOT_TEST_REFERENCE.adoc`(144 行) -- QEMU + VNC を使用して物理ハードウェアなしで ISO のブートをテストする手順、BIOS/UEFI チェックリスト、CI/CD の制限事項 上`plantuml-plugin` : * `ARCHITECTURE.adoc`(134 行) -- 11 のデータクラスの構造, 注意点（避けるべき罠）, 最適化されたテストコマンド * `API_KEY_POOL_REFERENCE.adoc`-- キー プールの完全な詳細 (LAZY pendant que`ESSENTIALS`です EAGER) == �専門エージェント：仮想チーム ガバナンスは受動的なファイルに限定されません。私は形式化した**�専門エージェントの役割**専用のLAZYファイル内に、タスクの種類に応じた期待されるワークフローが定義されています。 |=== |エージェント |ファイル |役割 |プロジェクト |**コードを書く** |`CODER.adoc` |FTL/CSS/JS の実装、セマンティックタグ、アクセシビリティ基準 |cheroliv.com |**スクラムマスター** |`SCRUM_MASTER.adoc` |ユーザーストーリーの計画、サブタスクへの分割、依存関係の検出 |cheroliv.com |**PlantUML デザイナー** |`PLANTUML_DESIGNER.adoc` |�図の作成, PUML構文, JBake統合 |cheroliv.com |=== ファイル`CODER.adoc`上`cheroliv.com`具体的なルールが含まれています：_一つだけ`<h1>`python print("ページごとに、パスにプレフィックスをつける")`${content.rootpath}`_, _Déclarer la langue `<html lang="${content.lang!"fr"}">`_. これらの規則は一度書かれると、セッション1からエージェントによって自動的に遵守されます。 ファイル`SCRUM_MASTER.adoc`納品物の構造を課す：**目的**, **タスク**(代入付き座標),**受入基準**, **リスク**. 私がアクションプランを要求すると、エージェントは私が求めずにこの構造を生成します。ガバナンス**プログラム**エージェント。 ==== 専門エージェントが不可欠になる時 専門エージェントの作成は自然な曲線に従います。プロジェクトの初めには、これらは必要ありません —`AGENT.adoc`十分です。しかしプロジェクトが大きくなる（たとえば、20セッションを超える場合）と、2つのシグナルがあなたに警告を発すべきです。 1. エージェントは2つの異なる分野の規則を混在させます（例：PlantUML構文とCSSルール） 2. あなたは、エージェントにすでに5回説明した慣習について訂正することに、もっと時間を費やしています。 上に`cheroliv.com`, これはセッションで起こったことです... 1. はい、最初からです。なぜなら、このプロジェクトはFTL、CSS、JSの3つの言語を使ったウェブサイトであり、AsciiDocのコンテンツとPlantUMLのダイアグラムを含んでいるからです — これらは全く関係のない3つの分野です。CODERエージェントはフォントサイズとメディアクエリを知る必要があり、PLANTUML_DESIGNERエージェントは構文を知る必要があります`@startuml`. 分離なく、エージェント CODER が私にダイアグラムを提案し、その逆も同様だった。混乱。 上`jhipster-gradle-plugins`, 私はGradleプラグイン開発に適した2つの専門エージェントを作成しました：`PLUGIN_DEVELOPER.adoc` et `BACKLOG_MANAGER.adoc`. 最初はすべての Kotlin/Gradle の規約をエンコードします（ただし`!!`, データクラス（モデル用）,`@TaskAction`タスクのため)。2番目は知っている`persistence`それになる前に安定している必要がある`assistant`開発を開始しない — mono-repo内のクリティカルな依存関係。 犯してはいけない間違い：早すぎる段階でエージェントを作りすぎること`plantuml-plugin`セッション108を待ち、APIキーのプール用の専門エージェントを正式化しました。それ以前は、業務コンテキストは`AGENT.adoc`. 経験則：専門的なエージェントは、その業務ドメインのドキュメントが100行を超えるとき正当化される。 ==== セッション命名規約 小さくて取るに足らない詳細だが、100回のセッションに到達すると重要になる。アーカイブファイルはどのように命名すればよいでしょうか？ 私は苦い経験から、規約が必要だと学びました — 初めは4つのプロジェクト、4つの異なるフォーマットがあり、訳がわからなくなりました。今日、私が確立した規約は：</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre></pre> </div> </div> <div class="paragraph"> <p>{N}-{type}-{sujet-kebab-case}.adoc</p> </div> <div class="listingblock"> <div class="content"> <pre>具体例: * `1-chore-migration-gouvernance-agent.adoc`— セッション 1、タイプの雑用 * `10-solidification-tests.adoc`— セッション10、明示的な型なし (主題だけで十分) * `036-debug-graphify-symlink-epic9.adoc`— 3桁の番号付きソート用セッション36 セッション番号が主要なソート基準です。3桁の番号（001、036、133）を使用するプロジェクトは、99を超えたときの辞書順ソートの問題を回避します。これが今私が使っているものです`magic-stick`: (Note: a leading space, colon, trailing space)`001-init-projet.adoc`, `036-debug-graphify-symlink-epic9.adoc`。 タイプはオプションであり、セッションのキーワード (debug, feature, refactor, docs, chore, test) から派生します。kebab-case のサブジェクトは最も重要な部分です：ファイルを開かずにセッションを見つけられるようにする必要があります。「テストの統合のタイムアウトを修正したセッションはどれだったかな？」と疑問に思う場合、答えは`124-fix-timeout-integration-test.adoc`. 再構築された歴史的セッション（ガバナンス以前に生まれたプロジェクト）については、負の数を使用しています。の`cheroliv.com`, セッション -6 から 0 までがプロジェクトのガバナンス以前の歴史全体をカバーしています。そして、ドキュメント化されていないセッションや失われたセッションについては、その中にエントリを作成します`SESSIONS_HISTORY.adoc`対応するアーカイブなし、スコアあり`?`. それは仮を装うよりも正直だ。 [plantuml, format=svg, id=diag-naming-convention, alt="Arbre de décision pour le nommage des fichiers de session"]</pre> </div> </div> <div class="paragraph"> <p>@startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center skinparam wrapWidth 200</p> </div> <div class="paragraph"> <p>title セッション命名規約 start</p> </div> <div class="paragraph"> <p>:Une session se termine; note right: Trigger "セッションの終わり"</p> </div> <div class="paragraph"> <p>if (Session antérieure\nà la gouvernance ?) then (oui) :Numéro <strong>NÉGATIF</strong>\n-6, -5 …​ 0; note right: Historique\nreconstitué :Suffixe : reconstitution; else (non) :Numéro <strong>POSITIF</strong>\nsur 3 chiffres si > 99; note right: 001, 036, 133\npour le tri lexicographique</p> </div> <div class="literalblock"> <div class="content"> <pre>:Détecter le **TYPE**; if (Mots-clés trouvés ?) then (oui) :debug / feature / refactor\ndocs / chore / test; else (non) :Omettre le type\n(le sujet suffit); endif</pre> </div> </div> <div class="literalblock"> <div class="content"> <pre> :Formuler le **SUJET** en kebab-case; note right Ex: fix-timeout-integration-test Doit permettre de retrouver sans ouvrir le fichier end note endif</pre> </div> </div> <div class="paragraph"> <p>note right • 1-chore-migration-gouvernance.adoc • 036-debug-graphify-symlink.adoc • 124-fix-timeout-integration-test.adoc • 133-epic11-article-blog-kg.adoc end note</p> </div> <div class="paragraph"> <p>if (Session documentée ?) then (oui) :Créer archive dans sessions/; :Ajouter ligne SESSIONS_HISTORY\navec score X/10; else (non) :Ajouter ligne SESSIONS_HISTORY\navec score <strong>?</strong>\n<strong>sans archive</strong>; note right: L’honnêteté\nplutôt que le vide endif</p> </div> <div class="paragraph"> <p>stop @enduml</p> </div> <div class="listingblock"> <div class="content"> <pre>==== TEST_COVERAGE_ANALYSIS.adoc` — ステップ5 詳細分析 手順5のセッション終了の手順は最も謎めいています。それは「更新する」と言います。`TEST_COVERAGE_ANALYSIS.adoc`もしテストが追加または変更された場合。 しかし、このファイルはどのように見えるでしょうか？ 上`plantuml-plugin`, それは数行から完全な構造に進化しました。ここにその安定した形があります： [source]</pre> </div> </div> </div> </div> </div> <h1 id="_analyse_de_couverture_de_tests" class="sect0">Analyse de Couverture de Tests</h1> <div class="sect1"> <h2 id="_suivi_des_tests">Suivi des Tests</h2> <div class="sectionbody"> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 20%;"> <col style="width: 20%;"> <col style="width: 20%;"> <col style="width: 20%;"> <col style="width: 20%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Classe de test</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Type</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Tests</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Statut</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Dernière MAJ</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">PlantumlServiceTest</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">unit</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">45/45</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅ PASS</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">2026-04-23</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ApiKeyPoolTest</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">integration</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">15/15</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅ PASS</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">2026-04-20</p></td> </tr> </tbody> </table> </div> </div> <div class="sect1"> <h2 id="_historique_par_session">Historique par Session</h2> <div class="sectionbody"> <div class="paragraph"> <p>| Session | Tests ajoutés | Tests modifiés | Couverture | 133 | 0 | 2 | 100% | 132 | 5 | 0 | 100%</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 25%;"> <col style="width: 25%;"> <col style="width: 25%;"> <col style="width: 25%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">----</p> <p class="tableblock">興味はファイルそのものではなく、<strong>変更点を記録する*義務である。このステップを踏まなければ、50セッション後にはどのテストが何をカバーしているのかわからなくなる。エージェントも同様だ。ファイルはプロジェクトのテストカバレッジの唯一の真実の参照となる。</p> <p class="tableblock">伝統的なテストのないプロジェクト (例えば`magic-stick`bash スクリプトをテストする), ステップ5は置き換えられます`SCRIPT_VERIFICATION.adoc`.メカニズムは同じです: スクリプトの検証状態を追跡するファイルです。ステップ5をあなたのプロジェクトに合わせて調整してくださいが、決して省略しないでください。これは、サイレントリグレッションを防ぐ安全ネットです。</p> <p class="tableblock">あなたのプロジェクトに *まったくない</strong> テスト — ユニットテストでも、機能テストでも、スクリプトテストでも — それでも空のファイルを作成し、「やること：テスト戦略を定義する」というセクションを追加してください。これは、将来の自分にこのトピックが未処理であることを思い出させるしおりとなります。</p> <p class="tableblock">[plantuml, format=svg, id=diag-session-flow, alt="Flux d’une session type avec Eager/Lazy et agents"] ---- @startuml skinparam backgroundColor #FEFEFE</p> <p class="tableblock">start</p> <p class="tableblock">:Début session; note right: L’agent est une page blanche</p> <p class="tableblock">:Chargement EAGER auto; note right * AGENT.adoc (règles absolues) * PROMPT_REPRISE.adoc (mission N) * INDEX.adoc (état projet) end note</p> <p class="tableblock">if (Mission claire ?) then (oui) :Exécution directe; else (non) :Charge LAZY sur demande; note right * SESSIONS_HISTORY.adoc (contexte passé) * sessions/{N-1}-<strong>.adoc (décisions) * *<em>REFERENCE.adoc (architechture) end note endif</p> <p class="tableblock">:Délégation agent spécialisé ?;</p> <p class="tableblock">if (CODER ?) then (oui) :Lit CODER.adoc; :Suit conventions FTL/CSS; elseif (SCRUM Master ?) then (oui) :Lit SCRUM_MASTER.adoc; :Structure livrable imposée; elseif (PlantUML ?) then (oui) :Lit PLANTUML_DESIGNER.adoc; :Syntaxe PUML + intégration; else (non) endif</p> <p class="tableblock">:Travail de la session;</p> <p class="tableblock">:Fin de session (trigger utilisateur);</p> <p class="tableblock">:Procédure 6 étapes; note right 1. Archive sessions/N-</strong>.adoc 2. Maj PROMPT_REPRISE.adoc (N+1) 3. Maj SESSIONS_HISTORY.adoc 4. Maj INDEX.adoc 5. Maj TEST_COVERAGE (si applicable) 6. Maj COMPLETED_TASKS_ARCHIVE.adoc end note</p> <p class="tableblock">:Checklist [✅] x 6;</p> <p class="tableblock">stop @enduml ----</p> <p class="tableblock">上記の図は、セッションの完全なライフサイクルを示しています。重要なポイントは、EAGERロード後の分岐です：ミッションが十分に明確で直接実行できる場合（80％のケース）と、エージェントがLAZYロードを行い曖昧さを解決する場合（20％のケース）があります。この判別がトークンの節約につながります。</p> <p class="tableblock">== セッション終了の手順：黄金律</p> <p class="tableblock">=== なぜ彼女は不可欠なのか</p> <p class="tableblock">この手順がないと、Eager/Lazy ストラテジーは何の役にも立ちません。それが、セッションの作業を永続的な情報に変換します。それが実行されます。<strong>ユーザーの明示的な要求により</strong>(キーワード: "セッション終了", "私が去る", など), そしてそれは<strong>必須</strong>-- 例外もなく、漏れもなく。</p> <p class="tableblock">ファイル`SESSION_CHECKLIST.adoc`理想的なセッションメトリクスを定義する：</p> <p class="tableblock">* 所要時間: 15-30分 * 変更されたファイル: 1-3個まで * LLMの交換：5-10メッセージ * コンテキストトークン : < 50k</p> <p class="tableblock">セッションを変更する必要がある兆候 : _LLMが既に修正されたエラーを繰り返す</em>、 <em>同時に3ファイル以上が変更されている</em>、 <em>会話が50メッセージを超える</em>。 黄金律 :<strong>2時間のセッションと混乱したデバッグより、20分のセッションを5回行う方が良い。</strong></p> <p class="tableblock">=== 6つのステップのフロー (静かに)</p> <p class="tableblock">[plantuml, format=svg, id=diag-end-session-flow, alt="Flux de la procédure de fin de session"] ---- @startuml skinparam defaultTextAlignment center skinparam wrapWidth 200 skinparam activityBackgroundColor #E3F2FD</p> <p class="tableblock">start :L’utilisateur dit "セッションの終了"; note right: Mots-clés déclencheurs</p> <p class="tableblock">:Agent détecte le trigger;</p> <p class="tableblock">:Étape 1\nCréer archive\n`.agents/sessions/N-*.adoc`; note right: Tout le contexte de la session</p> <p class="tableblock">:Étape 2\nMettre à jour\n`PROMPT_REPRISE.adoc`; note right: Mission N + critères d’acceptation N+1</p> <p class="tableblock">:Étape 3\nMettre à jour\n`SESSIONS_HISTORY.adoc`; note right: Ligne récap : # / Date / Type / Sujet / Score</p> <p class="tableblock">:Étape 4\nMettre à jour\n`INDEX.adoc`; note right: État courant, roadmap, fichiers modifiés</p> <p class="tableblock">:Étape 5\nMettre à jour\n`TEST_COVERAGE_ANALYSIS.adoc`; note right: Si tests ajoutés ou modifiés</p> <p class="tableblock">:Étape 6\nMettre à jour\n`COMPLETED_TASKS_ARCHIVE.adoc`; note right: Archiver tâches terminées</p> <p class="tableblock">:Afficher la checklist de confirmation; note right: Vérifier que chaque [✅] est mérité</p> <p class="tableblock">stop @enduml ----</p> <p class="tableblock">=== 150+セッションの結果</p> <p class="tableblock">これは、私の4つのプロジェクトに体系的に適用したこの手順の結果です：</p> <p class="tableblock"><strong>プラントUMLプラグイン</strong> :</p> <p class="tableblock">* <strong>133セッション</strong>プロジェクトの開始以来 * <strong>240/240 テスト合格</strong>(100% カバレッジ) — EPICs 1-7 完了 * <strong>57 シナリオ Cucumber BDD</strong>�検証済み * 設定ファイルに関する実際のエラーから生じた安全規則 (Session 2 bakery-plugin)</p> <p class="tableblock"><strong>ベーカリープラグイン</strong>:</p> <p class="tableblock">* <strong>11セッション</strong>2週間で * Supabase → Firebase の移行が完了（9つのテストが修正されました） * EPIC 6 (publishProfile) 本番環境で機能する * ルール 0 が作成されました :`publishToMavenLocal`各修正後の必須</p> <p class="tableblock"><strong>マジック・スティック</strong>:</p> <p class="tableblock">* <strong>23セッション</strong>A/Bパーティションを持つXubuntuライブシステムを構築するために * セッション10で最初に生成されたISO * QEMU + VNC の形式化されたブートテスト (LAZY ドキュメント 144 行) * 機能的なSourceForgeのCI/CD</p> <p class="tableblock"><strong>cheroliv.com</strong> :</p> <p class="tableblock">* <strong>9回の正式なセッション</strong>+ 7回のプレシステムセッションの再構成 * 記事0101 (OpenCode PATH) 公開済み * Article 0108（こちら）は、その欠点の分析後に書き直された * 完全なガバナンスがMarkdownからAsciiDocに移行されました</p> <p class="tableblock">=== 最終チェックリスト</p> <p class="tableblock">6ステップのサイレント実行後に、エージェントは確認チェックリストを表示しなければなりません：</p> <p class="tableblock">----</p> <p class="tableblock">✅ Procédure de fin de session exécutée 📋 Checklist :</p> <p class="tableblock"><strong>絶対的なルール</strong>どのステップもマークすることはできません`[✅]<code>ファイルが実際に変更され、検証されていない場合。</p> <p class="tableblock">== Bootstrapガイド：1日目、セッション0</p> <p class="tableblock">あなたはその方法に確信を持っています。新しいプロジェクトに適用したいです。どこから始めればよいでしょうか？</p> <p class="tableblock">私は2026年4月28日にこの瞬間を経験しました。私はOpencodeを開いて`jhipster-gradle-plugins</code>, 私の JHipster Gradle プラグイン 2 つを含むモノレポです。これはすでに存在するプロジェクトで — コードはそこにあり、Gradle タスクは正常に動作しています。しかし、エージェントのガバナンスは？ゼロ。真っ白なページ。このように`plantuml-plugin`そのセッション1は、何ヶ月も前のことだった。</p> <p class="tableblock">以下が私が従った正確な手順であり、今後の新しいプロジェクトでも同じように従います。順序に注意してください — 重要です。</p> <p class="tableblock">[plantuml, format=svg, id=diag-bootstrap, alt="Flux de bootstrap en 6 étapes pour initialiser la gouvernance agent sur un nouveau projet"] ---- @startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center skinparam wrapWidth 250 skinparam activityBackgroundColor #E8F5E9</p> <p class="tableblock">title ブートストラップ ガバナンス — 1日目, セッション0 start :Étape 0\nCréer <strong>opencode.json</strong>\n(6 lignes, instructions: AGENT.adoc); note right: Le pont qui charge\nAGENT.adoc automatiquement</p> <p class="tableblock">:Étape 1\nCréer les dossiers\n<strong>mkdir -p .agents/sessions/ .agents/archives/</strong>; note right: Les conteneurs vides\navant que l’agent écrive dedans</p> <p class="tableblock">:Étape 2\nCréer <strong>AGENT.adoc</strong>\n(200 lignes, règles absolues); note right: Le fichier maître\nStructure minimale v1</p> <p class="tableblock">:Étape 3\nCréer <strong>PROMPT_REPRISE.adoc</strong>\nMission session 1 (max 70 lignes); note right: Ce que l’agent doit\nfaire à la prochaine session</p> <p class="tableblock">:Étape 4\nCréer <strong>.agents/INDEX.adoc</strong>\nRègles exécutives + roadmap; note right: Point d’entrée EAGER\ndans le dossier LAZY</p> <p class="tableblock">:Étape 5\nCréer les fichiers LAZY structurants\n6 fichiers : SESSIONS_HISTORY, CHECKLIST, etc.; note right • SESSIONS_HISTORY.adoc • SESSION_CHECKLIST.adoc • PROCEDURES.adoc • AGENT_SESSION_MANAGER.adoc • TEST_COVERAGE_ANALYSIS.adoc • Agents spécialisés (si besoin) end note</p> <p class="tableblock">:Étape 6\nAjouter le projet au Portefeuille\nMettre à jour TOUS les INDEX.adoc existants; note right: Maintenance transverse\nObligatoire mais fastidieuse</p> <p class="tableblock">:✅ Bootstrap terminé\nSession 1 prête; note right: 20 minutes investies\nDes centaines économisées</p> <p class="tableblock">stop @enduml ----</p> <p class="tableblock">=== ステップ 0: <code>opencode.json</code> を作成</p> <p class="tableblock">これは最初のファイルです。いいえ`AGENT.adoc`, ない`INDEX.adoc`。<code>opencode.json`まず、単純な理由で： あなたが作成するとき`AGENT.adoc`まず、自動的にロードするブリッジを作成するのを忘れるでしょう。私はそれを…で作りました。`bakery-plugin</code>, 私は何を話しているか知っています。</p> <p class="tableblock">=== ステップ 1：フォルダーを作成する</p> <p class="tableblock">[source,bash] ---- mkdir -p .agents/sessions .agents/archives ----</p> <p class="tableblock">空のフォルダーが2つです。<code>sessions/`各セッションのアーカイブを受け取ります。`archives/`月次のCOMPLETED_TASKS_ARCHIVEを受け取ります。これらのフォルダは、エージェントが書き込む必要がある*前*に存在していなければなりません。フォルダとファイルを同時に作成しなければならないエージェントは、静かに失敗する可能性のあるエージェントです。</p> <p class="tableblock">=== ステップ 2: `AGENT.adoc</code> を作成 — マスターファイル</p> <p class="tableblock">最初のバージョン用の最小構造（成長します）：</p> <p class="tableblock">[source] ---- = {NOM_PROJET} — Directives Agent</p> <p class="tableblock">[CAUTION] ----</p> <p class="tableblock"><strong>必須停止</strong>rm の前に、 Write、削除 :</p> <p class="tableblock">1. ファイル全体を読む 2. 確認 git ls-files 3. 確認を求める 4. 待つ「はい」</p> <p class="tableblock">== プロジェクト</p> <p class="tableblock"><strong>名前</strong>: …​ <strong>スタック</strong>: …​ <strong>ドキュメンテーション</strong>: AsciiDoc</p> <p class="tableblock">== 絶対的なルール</p> <p class="tableblock">=== 0. 開発環境</p> <p class="tableblock">必須のコマンド…​</p> <p class="tableblock">=== 1. COMMITS/GIT</p> <p class="tableblock">正式な禁止…​</p> <p class="tableblock">=== 1b. 設定ファイル — 絶対安全規則</p> <p class="tableblock">決して潰さないで…​</p> <p class="tableblock">=== 2. セッション終了時のテスト</p> <p class="tableblock">正式な禁止…​</p> <p class="tableblock">=== 3. セッション終了手順</p> <p class="tableblock">6つの必須ステップ…​</p> <p class="tableblock">== コンテキスト管理 — LAZY/EAGER</p> <p class="tableblock">Eager ファイル / Lazy ファイル…​</p> <p class="tableblock">この最小テンプレートはエージェントを起動させます。リッチ版 — プロジェクト構造、重要なコンポーネント、EPIC、バックログ — はセッション1で提供され、そのときエージェントはすでに基本ルールを手にしており、ドキュメントを充実させるお手伝いができます。</p> <p class="tableblock">=== ステップ 3 : 作成 <code>PROMPT_REPRISE.adoc</code> — ミッション セッション 1</p> <p class="tableblock">「これはセッション1、ミッションはまだ定義されていません。」というファイル。最大70行、セッション0（ブートストラップの概要）セクションとセッション1（ユーザーと定義する優先順位）セクションを含む。</p> <p class="tableblock">=== ステップ 4: <code>.agents/INDEX.adoc</code> を作成 — エントリーポイント</p> <p class="tableblock">絶対的なルール（実行版）およびセッションテーブルを含むファイル。ブートストラップのために、コンパクトな形式のルール0から3、プロジェクトポートフォリオ（新しいプロジェクトに絵文字🆕を含む）、そして入力待ちの空のロードマップをリストします。</p> <p class="tableblock">=== ステップ 5: LAZY構造ファイル作成</p> <p class="tableblock">順に：</p> <p class="tableblock">1. <code>.agents/SESSIONS_HISTORY.adoc</code>— セッション0のみのテーブル 2. <code>.agents/SESSION_CHECKLIST.adoc</code>―テンプレート「セッションを変更するタイミング」 3. <code>.agents/PROCEDURES.adoc</code>— 6ステップの完全な手順 + EAGER/LAZY 4. <code>.agents/AGENT_SESSION_MANAGER.adoc</code>— アーカイブのテンプレート 5. <code>.agents/TEST_COVERAGE_ANALYSIS.adoc</code>— テスト追跡表、最初は空</p> <p class="tableblock">もしあなたのプロジェクトが複雑なビジネスドメインを持っている場合 （例えば`jhipster-gradle-plugins`その mono-repo persistence/assistant) 、 専門エージェントを今すぐ作成してください：</p> <p class="tableblock">1. <code>.agents/PLUGIN_DEVELOPER.adoc</code>— コードの規約と依存関係の境界 (プラグインの場合) 2. <code>.agents/BACKLOG_MANAGER.adoc</code>— 計画構造と特定されたリスク</p> <p class="tableblock">使わないエージェントを作らないでください。エンコードする具体的なルールのないエージェントは、汚染する死んだファイルです。<code>.agents/</code>。</p> <p class="tableblock">=== ステップ 6: すべてのプロジェクトのポートフォリオにプロジェクトを追加</p> <p class="tableblock">これは必ず忘れてしまうステップです。それぞれ`INDEX.adoc`各プロジェクトには、すべてのプロジェクトを同じ方法論でリストする「プロジェクトポートフォリオ」という表が含まれます。新しいプロジェクトを作成する際には、以下を行う必要があります:</p> <p class="tableblock">1. 新しいプロジェクトのポートフォリオに行を追加する（論理） 2. 既存のすべてのプロジェクトのポートフォリオに一行を追加 — はい、すべて</p> <p class="tableblock">私の4（現在5つ）のプロジェクトでは、これは開けることを意味します`INDEX.adoc` de <code>magic-stick</code>, <code>bakery-gradle</code>, <code>cheroliv.com</code>, `plantuml-gradle`それに行を追加する`jhipster-gradle-plugins</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Session 1</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">…​</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">2026-04-28 🆕<code>.</p> <p class="tableblock">面倒くさいです。手動です。これも、作業しているプロジェクトに関係なく、エージェントが他のプロジェクトの存在とその状態を知ることができるように保証する唯一の方法です。セッション 012 の`magic-stick</code>, エージェントはポートフォリオで2つの不整合を検出しました —`bakery-gradle`彼の COMPLETED_TASKS_ARCHIVE が遅れていて、そして`plantuml-gradle`彼は、手順書（5ステップ）とインデックス（6ステップ）の間にずれがあった。このクロステーブルがなければ、これらの不整合は見えなかったままだっただろう。</p> <p class="tableblock">[plantuml, format=svg, id=diag-portfolio-graph, alt="Graphe du portefeuille de projets — références croisées entre INDEX.adoc"] ---- @startuml skinparam backgroundColor #FEFEFE skinparam defaultTextAlignment center skinparam nodeBackgroundColor #E3F2FD</p> <p class="tableblock">title プロジェクトポートフォリオ — 相互参照 INDEX.adoc node "<strong>magic-stick</strong>\nSession 037\nSCRIPT_VERIFICATION" as MS #E1BEE7 node "<strong>bakery-gradle</strong> セッション11 TEST_COVERAGE" as BG #FFE0B2 node "<strong>cheroliv.com</strong> セッション 10 TEST_COVERAGE" as CH #C8E6C9 node "<strong>plantuml-gradle</strong> セッション 133 TEST_COVERAGE" as PG #BBDEFB node "<strong>jhipster-gradle</strong> セッション 1 🆕 テストカバレッジ" as JG #FFCDD2</p> <p class="tableblock">MS -→ BG : INDEX.adoc référence MS -→ CH : INDEX.adoc référence MS -→ PG : INDEX.adoc référence MS -→ JG : INDEX.adoc référence 🆕</p> <p class="tableblock">BG -→ MS : INDEX.adoc référence BG -→ CH : INDEX.adoc référence BG -→ PG : INDEX.adoc référence BG -→ JG : INDEX.adoc référence 🆕</p> <p class="tableblock">CH -→ MS : INDEX.adoc référence CH -→ BG : INDEX.adoc référence CH -→ PG : INDEX.adoc référence CH -→ JG : INDEX.adoc référence 🆕</p> <p class="tableblock">PG -→ MS : INDEX.adoc référence PG -→ BG : INDEX.adoc référence PG -→ CH : INDEX.adoc référence PG -→ JG : INDEX.adoc référence 🆕</p> <p class="tableblock">JG -→ MS : INDEX.adoc référence JG -→ BG : INDEX.adoc référence JG -→ CH : INDEX.adoc référence JG -→ PG : INDEX.adoc référence</p> <p class="tableblock">note bottom of JG Quand on ajoute un projet : • 4 INDEX.adoc à mettre à jour • 1 ligne par portefeuille • Coût : 5 minutes end note</p> <p class="tableblock">legend bottom</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">= Couleur</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">= Projet</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><#E1BEE7></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">magic-stick — ISO Linux live</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><#FFE0B2></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">bakery-gradle — Plugin JBake</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><#C8E6C9></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">cheroliv.com — Site personnel</p></td> <td class="tableblock halign-left valign-top"></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><#BBDEFB></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">plantuml-gradle — Plugin IA</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><#FFCDD2></p></td> </tr> </tbody> </table> </div> </div> https://cheroliv.com/blog/2026/0107_jbake_serve_rendering_bug_fix_post.html Wed, 22 Apr 2026 00:00:00 +0000 blog/2026/0107_jbake_serve_rendering_bug_fix_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_シーン4つのスクリーンショット2つのレンダリング">シーン：4つのスクリーンショット、2つのレンダリング</a> <ul class="sectlevel2"> <li><a href="#_ローカルレンダリング">ローカルレンダリング</a></li> <li><a href="#_オンラインレンダリング">オンラインレンダリング</a></li> </ul> </li> <li><a href="#_診断_serve_は正しいフォルダを指していなかった">診断 : <code>serve</code> は正しいフォルダを指していなかった</a></li> <li><a href="#_根本的な原因jbake_cliはその通りに動作しない">根本的な原因：JBake CLIはその通りに動作しない</a></li> <li><a href="#_解決策位置引数フラグではない">解決策：位置引数、フラグではない</a></li> <li><a href="#_curlを使った素早い検証">curlを使った素早い検証</a></li> <li><a href="#_なぜこのバグが厄介だったのか">なぜこのバグが厄介だったのか</a></li> <li><a href="#_結論">結論</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 10 minutes</div> <p>ローカルで自分のサイトが何も見えない瞬間を知っていますか？ でもオンラインにデプロイしたらすべてが完璧になる？ これは私の Gradle JBake プラグインで起きたことです。 タスク`serve`表示していたのは四角いボタン、黒い背景に黒いテキスト、そして奇妙に欠けているCSS。 しかし`publishSite`同じサイトを生成していましたが、それは完璧でした。問題の原因はCSSでもブラウザでもキャッシュでもなく、Kotlinのコードの1行と、コマンドライン引数の悪い習慣に起因していました。</p> </div> <div class="dlist"> <dl> <dt class="hdlist1">強迫性障害</dt> <dd> <p>[]</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_シーン4つのスクリーンショット2つのレンダリング">シーン：4つのスクリーンショット、2つのレンダリング</h2> <div class="sectionbody"> <div class="paragraph"> <p>それはシステムクラッシュの後のことだった。ローカルでのレンダリングを比較するために、スクリーンショットを4枚撮っていた（<code>./gradlew serve`上`localhost:8820</code>) インラインレンダリングとともに (`publishSite`GitHub Pagesでは)。ページごとに2枚のスクリーンショット：上部と下部。</p> </div> <div class="sect2"> <h3 id="_ローカルレンダリング">ローカルレンダリング</h3> <div class="paragraph"> <p><strong>ページの上部</strong>— ボタン <strong>Project</strong> と <strong>Template</strong> は<strong>小さくて長方形の</strong>, 標準の色（青と緑）に。<strong>Start Writing</strong> カードは　を持っている<strong>黒の単色背景</strong>, フレームなし。</p> </div> <div class="imageblock"> <div class="content"> <img src="./images/screen_local1.png" alt="Rendu local - haut de page"> </div> </div> <div class="paragraph"> <p><strong>ページ下部</strong>— サブタイトル <strong>"Derniers articles et ressources</strong>" は<strong>ほぼ判読不能</strong>, 真っ黒い背景だと色が濃すぎます。ブログ画像の下の日付（「17 October 2013」など)は<strong>不在の</strong>。</p> </div> <div class="imageblock"> <div class="content"> <img src="./images/screen_local2.png" alt="Rendu local - bas de page"> </div> </div> </div> <div class="sect2"> <h3 id="_オンラインレンダリング">オンラインレンダリング</h3> <div class="paragraph"> <p><strong>ページの上部</strong>— 同じボタンは<strong>大きい, 羊, 派手なネオン緑</strong>, 大文字のテキスト。地図には<strong>白い丸みのあるフレーム、ドロップシャドウ付き</strong>。</p> </div> <div class="imageblock"> <div class="content"> <img src="./images/screen_online1.png" alt="Rendu en ligne - haut de page"> </div> </div> <div class="paragraph"> <p><strong>ページ下部</strong>— サブタイトルは<strong>読みやすい</strong>. 日付は<strong>見える</strong>. アイテムのカードは<strong>�丸い角</strong>そして タイトルは<strong>太字</strong>。</p> </div> <div class="imageblock"> <div class="content"> <img src="./images/screen_online2.png" alt="Rendu en ligne - bas de page"> </div> </div> <div class="paragraph"> <p>最初の反応：テーマ。私はダイナミックなテーマシステム（clair, sombre, high-contrast）を使用しています。それに基づいて`localStorage`. もしかしてローカルストアがハイコントラストテーマをトリガーしていたか？ いいえ。すでに書いていたhttps://cheroliv.com/blog/2025/0098_preloading_css_variable_post.html[テーマのプリロードに関する記事全体], 私はそれがどう動くか知っている。そして、ハイコントラスト モードでも、CSS構造（楕円形のボタン、シャドウ）はそこにあるべきだった。それはそこにはなかった。</p> </div> <div class="paragraph"> <p>2番目の確認はブラウザキャッシュです。いいえ、クリーンなプロファイルでテストを行いました。差分は残っていました。</p> </div> <div class="paragraph"> <p>第三の反射:`serve`同じファイルを提供していなかった`publishSite`.</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_診断_serve_は正しいフォルダを指していなかった">診断 : <code>serve</code> は正しいフォルダを指していなかった</h2> <div class="sectionbody"> <div class="paragraph"> <p>私のGradleプラグイン`bakery`2つの主要なタスクがあります：</p> </div> <div class="ulist"> <ul> <li> <p><code>bake</code>: 静的サイトを生成します`build/bake/`</p> </li> <li> <p><code>serve</code>: ローカルウェブサーバーを起動</p> </li> <li> <p><code>publishSite</code>: 押す`build/bake/`GitHub Pagesへ</p> </li> </ul> </div> <div class="paragraph"> <p>差異は…からしか来得ない`serve`. Si <code>publishSite`正しい内容を公開していた、それが`build/bake/`よかった。もし`serve`別のものを表示していたのは、それが役に立たなかったということだ。`build/bake/</code>.</p> </div> <div class="paragraph"> <p>コードを見てみましょう。 中`SiteManager.kt`, タスク`serve`このように定義されています :</p> </div> <div class="listingblock"> <div class="title">SiteManager.kt — La tâche serve (version buggy)</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">tasks.register("serve", JavaExec::class.java) { task -> task.apply { mainClass.set("org.jbake.launcher.Main") classpath = jbakeRuntime environment("GEM_PATH", jbakeRuntime.asPath) jvmArgs(/* ... */) args = listOf( "-b", file(site.bake.srcPath).absolutePath, "-s", layout.buildDirectory.get() .asFile.resolve(site.bake.destDirPath) .absolutePath ) } }</code></pre> </div> </div> <div class="paragraph"> <p><code>org.jbake.launcher.Main`はJBake 2.7.0 CLIのエントリポイントです。 アイデア：通過</code>-b`ソースフォルダと`-s`出力先フォルダーを指定し、サーバーモードを起動します。ただし、…​</p> </div> </div> </div> <div class="sect1"> <h2 id="_根本的な原因jbake_cliはその通りに動作しない">根本的な原因：JBake CLIはその通りに動作しない</h2> <div class="sectionbody"> <div class="paragraph"> <p>JBake 2.7.0 待っている des<strong>位置引数</strong>ソースと宛先、続いてオプションのフラグ。シグニチャは：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">jbake <source> <destination> [options]</code></pre> </div> </div> <div class="paragraph"> <p>しかし、私のコードでは、次のように書いていました：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">args = listOf("-b", "/path/to/site", "-s", "/path/to/build/bake")</code></pre> </div> </div> <div class="paragraph"> <p>JBakeはそれをこう解釈した：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><code>-b</code>→ フラグ「bake」をパース（ブール値）、消費された</p> </li> <li> <p><code>/path/to/site</code>→ となる位置引数 1 (ソース)</p> </li> <li> <p><code>-s</code>→ フラグ 'serve' (ブール型)をパースし、サーバーが起動<strong>すぐに</strong></p> </li> <li> <p><code>/path/to/build/bake</code>→ それは孤立した議論となり、無視されたり誤解されたりする</p> </li> </ol> </div> <div class="paragraph"> <p>結果 : JBake は取っていました`/path/to/site`ソースとして、<strong>目的地を考慮に入れていなかった</strong>提供された (<code>build/bake</code>), そしてそれはそのデフォルトディレクトリを使用していました（しばしば`./output`一時的なコピー). ファイル`css/styles.css`ビルドはしたがって上書きまたは無視され、カスタム変数も丸みも影もない古いデフォルトのCSSが提供されていた。</p> </div> <div class="paragraph"> <p>比較すると`bake` et <code>publishSite`使用している<strong>公式のGradle JBakeプラグイン</strong>(`jbake-gradle-plugin</code>) きれいに書き込む`build/bake/`Gradle の API を通じて実行されます。CLI を経由しません。</p> </div> </div> </div> <div class="sect1"> <h2 id="_解決策位置引数フラグではない">解決策：位置引数、フラグではない</h2> <div class="sectionbody"> <div class="paragraph"> <p>修正は単純だ — 知ってしまえば。ソースとデスティネーションを位置引数として渡すだけです。その後`-s`最後に：</p> </div> <div class="listingblock"> <div class="title">SiteManager.kt — La tâche serve (version corrigée)</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">args = listOf( file(site.bake.srcPath).absolutePath, layout.buildDirectory.get() .asFile.resolve(site.bake.destDirPath) .absolutePath, "-s" )</code></pre> </div> </div> <div class="paragraph"> <p>それだけです。3行変更され、バグが修正されました。</p> </div> <div class="paragraph"> <p>プラグインをローカルで公開した後 (<code>publishToMavenLocal</code>), un `./gradlew serve`JBakeを正しい構文で実行:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">jbake /home/user/project/site /home/user/project/build/bake -s</code></pre> </div> </div> <div class="paragraph"> <p>そして今回は、JBakeに組み込まれたJettyサーバーが、内容をうまく提供しています。<code>build/bake/</code>— オンラインで公開されているものと同じです。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml !define RECTANGLE class package "前に (bug)" { RECTANGLE JBakeCLI1 { + args = ["-b", "サイト", "-s", "ビルド/ベイク"] } RECTANGLE Source1 { + site/ } RECTANGLE Dest1 { + ??? (dossier temporaire) } RECTANGLE Jetty1 { + sert mauvais fichiers } JBakeCLI1 --> Source1 : lit JBakeCLI1 -[#red]x Dest1 : destination ignorée Jetty1 --> Dest1 : sert } package "後（修正）" { RECTANGLE JBakeCLI2 { + args = ["サイト", "ビルド/ベイク", "-s"] } RECTANGLE Source2 { + site/ } RECTANGLE Dest2 { + build/bake/ } RECTANGLE Jetty2 { + sert les bons fichiers } JBakeCLI2 --> Source2 : lit JBakeCLI2 --> Dest2 : écrit dans Jetty2 --> Dest2 : sert OK } @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_curlを使った素早い検証">curlを使った素早い検証</h2> <div class="sectionbody"> <div class="paragraph"> <p>サーバーが正しいコンテンツを提供していることを確認するため、シンプルな`curl`確認します`index.html`含む`data-bs-theme="light"`そして`build/bake/css/styles.css`確かに31 402バイト — 生成されたファイルと同一である`bake`.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ ./gradlew serve # Dans un autre terminal : $ curl -s http://localhost:8820/ | grep data-bs-theme <html ... data-bs-theme="light" ...> $ curl -I http://localhost:8820/css/styles.css HTTP/1.1 200 OK Content-Length: 31402 Content-Type: text/css</code></pre> </div> </div> <div class="paragraph"> <p>ローカルレンダリングは現在<strong>同一ピクセル</strong>デプロイされたレンダリングに。</p> </div> </div> </div> <div class="sect1"> <h2 id="_なぜこのバグが厄介だったのか">なぜこのバグが厄介だったのか</h2> <div class="sectionbody"> <div class="paragraph"> <p>なぜ捕まえるのが難しかったか、わかりますか？</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>明示的なエラーはありません</strong>: JBakeはクラッシュしませんでした。それは単に間違ったフォルダで「動作していた」だけ。</p> </li> <li> <p><strong>ビルドは機能していた</strong>:`./gradlew bake`正しくファイルを生成していた`build/bake/`.</p> </li> <li> <p><strong>デプロイメントが機能していました</strong>:`publishSite`オンラインで良いコンテンツを推していた。</p> </li> <li> <p><strong>だけ <code>serve</code> 壊れていた</strong>: 開発タスク、つまり常に使ってイテレーションを行うもの</p> </li> <li> <p><strong>-key value`の習慣</strong>: 開発者として、私たちは何年ものUnix CLIに条件付けられている (<code>-o output</code>, <code>-i input</code>). JBake CLI は例外です — ソースとデスティネーションは位置引数です。</p> </li> </ol> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>JBake（または他のCLIツール）をラップするGradleプラグインをメンテナンスしている場合<strong>引数のドキュメントを読んでください</strong>たとえあなたがそれらを知っていると思っていても。 暗黙の仮説 (<code>-s</code>= "set destination") これは視覚的なデバッグに何時間もかかる可能性があります。</p> </div> <div class="paragraph"> <p>ここで、この修正は文字通りに変更することだった：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">args = listOf("-b", src, "-s", dest) // ❌ BUG</code></pre> </div> </div> <div class="paragraph"> <p>en :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">args = listOf(src, dest, "-s") // ✅ FIX</code></pre> </div> </div> <div class="paragraph"> <p>3つのトークンが移動されただけで、私のローカルサイトは本番サイトと同じくらい美しくなりました。</p> </div> <div class="paragraph"> <p><strong>レッスン</strong>: レンダリングがローカルと本番で理由なく異なる場合、まずまず <strong>pipeline</strong> を疑う — CSSでもなく、ブラウザでもなく、ましてやフレームワークでもない。これはしばしば、レンダリング直前の手順がごまかしていることが多い。</p> </div> </div> </div> https://cheroliv.com/blog/2026/0106_opencode_path_sdkman_nvm_post.html Tue, 21 Apr 2026 00:00:00 +0000 blog/2026/0106_opencode_path_sdkman_nvm_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_シーンツールの世界の中の盲目のエージェント">シーン：ツールの世界の中の盲目のエージェント</a></li> <li><a href="#_バグの解剖2つのシェル2つの世界">バグの解剖：2つのシェル、2つの世界</a></li> <li><a href="#_犯人_zshrc_vs_zshenv">犯人 : <code>.zshrc</code> vs `.zshenv</a></li> <li><a href="#_ステップバイステップ診断">ステップバイステップ診断</a> <ul class="sectlevel2"> <li><a href="#_エージェントのpathを確認する">エージェントのPATHを確認する</a></li> <li><a href="#_2_zshrcにあるが_zshenvにないものを特定する">2. .zshrcにあるが.zshenvにないものを特定する</a></li> <li><a href="#_3_zshenv_が存在するか確認する">3. .zshenv が存在するか確認する</a></li> </ul> </li> <li><a href="#_解決策_zshenv_正しいパス">解決策: .zshenv + 正しいパス</a> <ul class="sectlevel2"> <li><a href="#_すべての必須パスを含む_zshenv_を作成する">すべての必須パスを含む .zshenv を作成する</a></li> <li><a href="#_zshenv_で_source_sdkman_init_sh_を使わないのはなぜですか">.zshenv で <code>source sdkman-init.sh</code> を使わないのはなぜですか？</a></li> </ul> </li> <li><a href="#_nvmケース_バージョンマネージャーが痕跡を残すのを忘れたとき">NVMケース： バージョンマネージャーが痕跡を残すのを忘れたとき</a> <ul class="sectlevel2"> <li><a href="#_nvmの問題">NVMの問題</a></li> <li><a href="#_解決策nvm用にシンボリックリンク_current_を作成する">解決策：NVM用にシンボリックリンク <code>current</code> を作成する</a></li> <li><a href="#_シンボリックリンクのアップデートを自動化する">シンボリックリンクのアップデートを自動化する</a></li> </ul> </li> <li><a href="#_パスのサマリー表">パスのサマリー表</a></li> <li><a href="#_罠と対策">罠と対策</a></li> <li><a href="#_学んだ教訓">学んだ教訓</a></li> <li><a href="#_最終確認">最終確認</a></li> <li><a href="#_リンク">リンク</a> <ul class="sectlevel2"> <li><a href="#_公式ドキュメント">公式ドキュメント</a></li> <li><a href="#_言及されたツール">言及されたツール</a></li> <li><a href="#_もっと進む">もっと進む</a></li> </ul> </li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 13 minutes</div> <p>あなたはターミナルで OpenCode を起動し、すべてが機能します。エージェントは`gh`— 見つからない。一つ`java -version`不在. 一つ`node`— どこにもない。 しかし、これらのツールは <em>あなたの</em> シェルに確かに存在します。問題？ OpenCode はシェルを起動します。<strong>非インタラクティブ</strong>あなたを決して読まない`.zshrc`. ここで診断し、適切に修正する方法を示します。</p> </div> <div class="dlist"> <dl> <dt class="hdlist1">コン</dt> <dd> <p>[]</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_シーンツールの世界の中の盲目のエージェント">シーン：ツールの世界の中の盲目のエージェント</h2> <div class="sectionbody"> <div class="paragraph"> <p>それは火曜日の夜だった。私はそれをインストールしたばかりだった。https://opencode.ai[オープンコード], そのAIエージェントは私のコードの書き方を変えると約束していた。最初のテスト：彼にGitHubのリポジトリをリストするように頼む。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ opencode > Utilise gh pour lister mes repos ❌ bash: gh: command not found</code></pre> </div> </div> <div class="paragraph"> <p>変だ。`gh`端末で正常に動作していました。他のものを試してみます：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">> Vérifie la version de Java ❌ bash: java: command not found</code></pre> </div> </div> <div class="paragraph"> <p>それから：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">> Lance le build Gradle ❌ bash: gradle: command not found</code></pre> </div> </div> <div class="paragraph"> <p>Java, Gradle, Node,<code>gh</code>— エージェントには何も見えなかった。 私の端末は、すべてを見ていた。 まるでエージェントと私が二つの並行世界に住んでいるかのようだ。</p> </div> <div class="paragraph"> <p>理解するのに何時間も費やした。何時間`echo $PATH`, de <code>which java</code>,苛立ちが増すなか、私はついに気付いた、問題はツールではなく — それは<strong>シェル</strong>。OpenCodeは、サブプロセスを起動するようなエージェントのように、シェルで作業する<strong>非インタラクティブ</strong>.そしてZshは、これらのシェルでは、純粋かつ単純にあなたを無視します`.zshrc`.</p> </div> <div class="paragraph"> <p>以下は、この診断、解決策、そして私が学んだ教訓の完全な物語です。AIエージェントを使用している場合 — OpenCode、Aider、Cursor、あるいはcronスクリプト — この問題はいずれあなたに関わってくるでしょう。</p> </div> </div> </div> <div class="sect1"> <h2 id="_バグの解剖2つのシェル2つの世界">バグの解剖：2つのシェル、2つの世界</h2> <div class="sectionbody"> <div class="paragraph"> <p>ターミナルを開くと、Zshはそれをシェルのように扱います。<strong>インタラクティブ</strong>ロードする`.zshrc`, すべてを初期化します：SDKMAN, NVM, pnpm, エイリアス, 素敵なプロンプト。あなたの環境は完成しました。</p> </div> <div class="paragraph"> <p>しかし、OpenCode がコマンドを実行するとき、インタラクティブなターミナルを起動しません。シェルを起動します。<strong>非インタラクティブ</strong>— 人間が画面の後ろにいないタスクシェル。そしてZshはこの文脈ではジャンプする`.zshrc`. 彼はただ読むだけ`.zshenv`。</p> </div> <div class="paragraph"> <p>なぜこの区別が存在するのでしょうか？なぜなら、非インタラクティブなシェルはスクリプトを実行するために設計されており、人間のユーザーにサービスを提供するためではないからです。バックグラウンドで動作するスクリプトにエイリアス、プロンプト、および補完をロードするのは無駄です。問題は、あなたの PATH — 実行可能ファイルを見つけるための最も重要な情報 — がしばしば初期化される場所にあるということです。<code>.zshrc</code>, 中にない`.zshenv`。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE actor "あなた" as user actor "OpenCode (エージェント)" as agent participant "シェル 対話型 (.zshrc がソースされました)" as ishell participant "シェル 非対話的 (.zshrc 無視)" as nshell user -> ishell : gh, java, node ✅ agent -> nshell : gh, java, node ❌ note right of ishell Source .zshrc : - SDKMAN init - NVM init - ~/apps dans PATH - pnpm dans PATH end note note right of nshell .zshrc ignoré ! PATH = /usr/bin:/bin + quelques répertoires défaut end note @enduml</pre> </div> </div> <div class="paragraph"> <p>問題の根源：<strong>Zsh は <code>.zshrc</code> を対話型シェルのみに対してソースします</strong>. OpenCode, すべてのIAエージェントがサブプロセスを起動するように、非インタラクティブシェルを使用します。これらのシェルはただ読み取るだけ`.zshenv`。</p> </div> </div> </div> <div class="sect1"> <h2 id="_犯人_zshrc_vs_zshenv">犯人 : <code>.zshrc</code> vs `.zshenv</h2> <div class="sectionbody"> <div class="paragraph"> <p>Zshは<strong>4つの初期化ファイル</strong>、それぞれに特定の役割がある。エレガントなデザインだが、それが問題の核心でもある：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> <col style="width: 5%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ファイル</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">取得されたとき</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">役割</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">PATHを変更しますか？</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>.zshenv</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>常に</strong>(インタラクティブ + ノンインタラクティブ + ログイン)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">必須の環境変数、PATH</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅ はい — これは SA 場所</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>.zprofile</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ログインシェルのみ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">遅いコマンド（セッションごとに一度）</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">可能</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>.zshrc</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>インタラクティブシェルのみ</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">エイリアス, プロンプト, 補完, インタラクティブツール</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�❌ 重要な変数には使用しないでください</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>.zlogin</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ログインシェル（.zshrc の後）</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ウェルカムメッセージ、最終化</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">めったに</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>表は手がかりを与えるが、それを深く理解する必要がある。家の部屋のように考えてみてください：</p> </div> <div class="ulist"> <ul> <li> <p>`.zshenv`は<strong>エントランスホール</strong>— 誰もがそこに通る、訪問者でも住民でも。ここで何かを置けば、どのシェルでもそれを見ることができる。</p> </li> <li> <p>`.zshrc`である<strong>居間</strong>— ただ、インタラクティブなシェル（居住者）だけがそこに入る。訪問者（非インタラクティブなシェル）はロビーにとどまる。</p> </li> <li> <p><code>.zprofile</code> et `.zlogin`ログインシェル用の専用パーツです（SSHで接続するときなど）。</p> </li> </ul> </div> <div class="paragraph"> <p>問題は、ほとんどの人が PATH をリビングに置いてしまうことだ。そして AI エージェントは、決してそこに入る権限を持たない。</p> </div> <div class="paragraph"> <p>問題を図に示す：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE start if (Shell interactif ?) then (Oui) :Source .zshenv; :Source .zprofile; :Source .zshrc; :Source .zlogin; note right SDKMAN ✅ NVM ✅ ~/apps ✅ pnpm ✅ end note else (Non — shell non-interactif) :Source .zshenv uniquement; note right SDKMAN ❌ NVM ❌ ~/apps ❌ pnpm ❌ end note endif stop @enduml</pre> </div> </div> <div class="paragraph"> <p>ターミナルを開くと、Zshは対話的です：それは読みます`.zshrc`, すべてが機能しています。 OpenCode がコマンドを実行するためにシェルを起動するとき、Zsh は非インタラクティブです：それはスキップします。<code>.zshrc</code>, 読むのは`.zshenv`. Et si <code>.zshenv</code> 存在しないまたは PATHを含まない — そこは砂漠だ。</p> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p><strong>なぜ Zsh はそれをするのですか？</strong>これはUnixから継承された設計上の選択です。非インタラクティブなシェルはなければならない<strong>速い</strong> et <strong>再現可能</strong>エイリアス、カラープロンプトとSDKMANの重い初期化をcronスクリプトまたはAIエージェントに読み込むと、遅くてもろいでしょう。したがって、分離は論理的：<code>.zshenv`主に (変数, PATH),</code>.zshrc`� 快適さのために (aliases, prompt, 完了する)。問題は、本質を快適さの中に置くと発生します。</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_ステップバイステップ診断">ステップバイステップ診断</h2> <div class="sectionbody"> <div class="paragraph"> <p>修正する前に、何が足りないのか正確に理解する必要があります。これが再現可能な診断方法です — AIエージェントと作業している場合は、これをお気に入りに保存してください。</p> </div> <div class="sect2"> <h3 id="_エージェントのpathを確認する">エージェントのPATHを確認する</h3> <div class="paragraph"> <p>あなたは対話型ターミナルが見ているものと、非対話型シェルが見ているもの—つまり OpenCode が見ているもの—を比較します。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Dans votre terminal interactif (tout fonctionne) echo $PATH | tr ':' '\n' | grep -v '^/usr' | sort</code></pre> </div> </div> <div class="paragraph"> <p>典型的な結果 :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">/home/cheroliv/apps /home/cheroliv/.nvm/versions/node/v22.19.0/bin /home/cheroliv/.sdkman/candidates/java/current/bin /home/cheroliv/.sdkman/candidates/gradle/current/bin /home/cheroliv/.local/share/pnpm /home/cheroliv/.local/bin</code></pre> </div> </div> <div class="paragraph"> <p>では、エージェントが見ているものをシミュレートしましょう — 対話型でないシェル :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Shell non-interactif : pas de .zshrc zsh -c 'echo $PATH' | tr ':' '\n' | grep -v '^/usr' | sort</code></pre> </div> </div> <div class="paragraph"> <p>結果：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">/home/cheroliv/.local/bin</code></pre> </div> </div> <div class="paragraph"> <p><strong>六つの道のうち五つが消えてしまった。</strong>エージェントは環境の83%を失っている。それは、半分の調理器具しかない状態で料理をしろと言われているようなものです。水を沸かすことはできますが、それ以外はあまりできません。</p> </div> <div class="admonitionblock warning"> <table> <tr> <td class="icon"> <i class="fa icon-warning" title="Warning"></i> </td> <td class="content"> <div class="paragraph"> <p>コマンド`zsh -c 'echo $PATH'`あなたの<strong>�診断ツール番号1</strong>. あなたが日常的に使用しているツールが結果に含まれていない場合、あなたのAIエージェントもそれを見ることはできません。 これを各変更の前後でテストしてください`.zshenv`。</p> </div> </td> </tr> </table> </div> </div> <div class="sect2"> <h3 id="_2_zshrcにあるが_zshenvにないものを特定する">2. .zshrcにあるが.zshenvにないものを特定する</h3> <div class="paragraph"> <p>今、私たちは犯人を探している 中`.zshrc`. 私たちのツールを参照している行をフィルタリングします：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">grep -n 'apps\|SDKMAN\|NVM\|PNPM\|PATH' ~/.zshrc</code></pre> </div> </div> <div class="paragraph"> <p>典型的には：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">119: PATH="/usr/bin/python3:$HOME/apps:$PATH" # ← pas exporté ! 171: export NVM_DIR="$HOME/.nvm" 172: [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # ← NVM init 176: nvm use --lts --silent # ← active une version 179: export PNPM_HOME="/home/cheroliv/.local/share/pnpm" 187: export SDKMAN_DIR="$HOME/.sdkman" 188: [[ -s "$HOME/.sdkman/bin/sdkman-init.sh" ]] && source "$HOME/.sdkman/bin/sdkman-init.sh"</code></pre> </div> </div> <div class="paragraph"> <p>それは全部です<strong>不可視</strong>OpenCodeのため。そして`PATH`行 119 のものでもない`export`é — 彼は決して現在のシェルを離れません。これは重要な技術的詳細です：変数がない`export`シェルが定義している場所にローカルのままです。 サブシェルは — OpenCodeによって起動されたもののように — それを決して継承しません。</p> </div> </div> <div class="sect2"> <h3 id="_3_zshenv_が存在するか確認する">3. .zshenv が存在するか確認する</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">cat ~/.zshenv 2>/dev/null || echo "FICHIER ABSENT"</code></pre> </div> </div> <div class="paragraph"> <p>回答が「ファイルが見つからない」ならば、そこで勝負が決まる。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_解決策_zshenv_正しいパス">解決策: .zshenv + 正しいパス</h2> <div class="sectionbody"> <div class="paragraph"> <p>戦略はシンプルだが、精度が求められる：その中に入れる`.zshenv` <strong>のみ</strong>� 必須のパスを、重い初期化スクリプトをソースせずに。移動しない`.zshrc`中に`.zshenv`— 本質を抽出します。</p> </div> <div class="sect2"> <h3 id="_すべての必須パスを含む_zshenv_を作成する">すべての必須パスを含む .zshenv を作成する</h3> <div class="paragraph"> <p>`.zshenv`は<strong>唯一のファイル</strong>Zshがソースすることを保証する中で<strong>みんな</strong>コンテキスト。ここでPATHを設定すべきです。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">export SDKMAN_DIR="$HOME/.sdkman" export NVM_DIR="$HOME/.nvm" export PNPM_HOME="$HOME/.local/share/pnpm" export PATH="$HOME/apps:$HOME/.sdkman/candidates/java/current/bin:$HOME/.sdkman/candidates/gradle/current/bin:$HOME/.nvm/current/bin:$PNPM_HOME:$HOME/.local/bin:$HOME/.local/share/JetBrains/Toolbox/scripts:/usr/bin/python3:$PATH"</code></pre> </div> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p>使用します`$HOME/.nvm/current/bin`そしていいえ`$HOME/.nvm/versions/node/v22.19.0/bin`理由：Node のバージョンが変わります。ハードコーディングされたパスは次ので偽になります`nvm install`. 以下のセクションで詳しく説明します。</p> </div> </td> </tr> </table> </div> </div> <div class="sect2"> <h3 id="_zshenv_で_source_sdkman_init_sh_を使わないのはなぜですか">.zshenv で <code>source sdkman-init.sh</code> を使わないのはなぜですか？</h3> <div class="paragraph"> <p>最も誘惑的なアプローチは、単純に再現するで`.zshenv`そこで私たちがすること`.zshrc`— ソースする 初期化スクリプト。 On<strong>できる</strong>したくなる :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># ❌ MAUVAISE IDÉE [[ -s "$HOME/.sdkman/bin/sdkman-init.sh" ]] && source "$HOME/.sdkman/bin/sdkman-init.sh"</code></pre> </div> </div> <div class="paragraph"> <p>問題 :</p> </div> <div class="ulist"> <ul> <li> <p><strong>遅い</strong>:`sdkman-init.sh`ネットワークの解決と各シェルでの検証を行います。非インタラクティブなシェルでは、これは無駄なコストです。</p> </li> <li> <p><strong>�壊れやすい</strong>SDKMAN は対話的なコンテキストを期待します。その初期化はパイプやサブシェルでは無音で失敗する可能性があります。</p> </li> <li> <p><strong>無駄な</strong>: SDKMANはその候補者を配置します`~/.sdkman/candidates/<tool>/current/bin`— アクティブなバージョンを指す安定したシンボリックリンクです。 これらを使用できます<strong>直接的に</strong>。</p> </li> </ul> </div> <div class="paragraph"> <p>良いアプローチ：SDKMANの初期化を回避し、シンボリックリンクを直接指す`current`. これはすべての解決策の鍵 :<strong>初期化コードではなく、ファイル構造を契約として使用する</strong>。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE rectangle "ゆっくりとしたアプローチ (source sdkman-init.sh)" as slow { card ".zshenv source sdkman-init.sh シェルごとに2-3秒 ネットワークチェック 失敗のリスク" as s1 #FDEDEC } rectangle "�迅速なアプローチ (直接シンボリックリンク)" as fast { card ".zshenv export PATH=...current/bin 0 ms ネットワークなし 初期化なし" as s2 #E8F8E8 } slow --> fast : Même résultat final\nLe PATH pointe sur current/bin\ndans les deux cas @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_nvmケース_バージョンマネージャーが痕跡を残すのを忘れたとき">NVMケース： バージョンマネージャーが痕跡を残すのを忘れたとき</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_nvmの問題">NVMの問題</h3> <div class="paragraph"> <p>調査が私を最も遠くまで導いたのはここだ。SDKMANはエレガントなデザインを持っています：すると`sdk install java 25.0.2-tem`, シンボリックリンクを作成します :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">~/.sdkman/candidates/java/current -> ~/.sdkman/candidates/java/25.0.2-tem</code></pre> </div> </div> <div class="paragraph"> <p>このシンボリックリンクは<strong>常に最新</strong>その中を指してください`.zshenv`そしてあなたはカバーされています、どのシェルでも。 美しい。</p> </div> <div class="paragraph"> <p>NVM、彼、作らない<strong>何も</strong>そのような。シンボリックリンクはありません`current`. 安定したアンカーポイントはありません。 ハードコードされたバージョン管理されたパスを指す必要があり、これがその見た目です :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">~/.nvm/versions/node/v22.19.0/bin/node</code></pre> </div> </div> <div class="paragraph"> <p>次の`nvm install 24`, この道は死んでいます。 あなたの`.zshenv`アクティブでなくなったバージョンを指します。これは時限爆弾です。</p> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p><strong>NVMはなぜそれをするのですか？</strong>NVMはPATHを動的に変更することで動作する毎`nvm use`. これは、バージョンを頻繁に変更する開発者向けに設計されています。インタラクティブなシェルで。シンボリックリンク`current`初期の仕様には含まれていませんでした — これは設計の見落としであり、自分たちで修正します。</p> </div> </td> </tr> </table> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE package "SDKMAN ✅" { [~/.sdkman/candidates/java/current] as sdk_current [~/.sdkman/candidates/java/25.0.2-tem/] as java_25 [~/.sdkman/candidates/java/21.0.7-tem/] as java_21 sdk_current --> java_25 : symlink } package "NVM ❌ (修正前)" as nvm_before { [~/.nvm/versions/node/v22.19.0/] as node_22 [~/.nvm/versions/node/v20.16.0/] as node_20 note right of node_22 Pas de symlink current ! .zshenv doit pointer en dur Cassé au prochain nvm install end note } package "NVM ✅ (修正後)" as nvm_after { [~/.nvm/current] as nvm_current [~/.nvm/versions/node/v22.19.0/] as node_22b [~/.nvm/versions/node/v20.16.0/] as node_20b nvm_current --> node_22b : symlink\n(mis à jour auto) } @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_解決策nvm用にシンボリックリンク_current_を作成する">解決策：NVM用にシンボリックリンク <code>current</code> を作成する</h3> <div class="paragraph"> <p>NVMがそれをしないので、私たちが自分たちでやります。原則は`SDKMAN`と同じ — シンボリックリンクです`current`常にアクティブなバージョンを指している。これを一度作成し、それから自動化して自分で更新されるようにする。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Créer le symlink initial ln -sfn "$HOME/.nvm/versions/node/v22.19.0" "$HOME/.nvm/current"</code></pre> </div> </div> <div class="paragraph"> <p>今、中に`.zshenv`、使用します：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$HOME/.nvm/current/bin</code></pre> </div> </div> <div class="paragraph"> <p>よりも：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># ❌ Chemin en dur — cassé au prochain changement de version $HOME/.nvm/versions/node/v22.19.0/bin</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_シンボリックリンクのアップデートを自動化する">シンボリックリンクのアップデートを自動化する</h3> <div class="paragraph"> <p>シンボリックリンクは、アップデートしない場合、何の価値もありません。シンボリックリンク`current`それを行うときにアップデートする必要がある`nvm use` ou <code>nvm install</code>. 解決策：1<strong>ラッパー</strong>— 本当のコマンドをラップする関数`nvm`そして、各呼び出し後にシンボリックリンクを更新します。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># À la fin de .zshrc, APRÈS le chargement de NVM nvm use --lts --silent ln -sfn "$(nvm_version_path "$(nvm current)")" "$NVM_DIR/current" _nvm() { command nvm "$@" local rc=$? ln -sfn "$(nvm_version_path "$(nvm current)")" "$NVM_DIR/current" return $rc } alias nvm='_nvm'</code></pre> </div> </div> <div class="paragraph"> <p>詳しく説明すると、どのように機能するか：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE actor Développeur participant "nvm wrapper (_nvm)" as wrapper participant "nvm 実 (コマンド nvm)" as realnvm participant "~/.nvm/current\n(シンボリックリンク)" as symlink Développeur -> wrapper : nvm use 20 wrapper -> realnvm : command nvm use 20 realnvm --> wrapper : version activée wrapper -> symlink : ln -sfn .../v20.16.0 ~/.nvm/current wrapper --> Développeur : retour note right of symlink Toujours à jour ! Utilisé par .zshenv → accessible par OpenCode end note @enduml</pre> </div> </div> <div class="paragraph"> <p>ワラッパー`_nvm`本物のコマンドを呼び出す`nvm`, その後シンボリックリンクを更新します。エイリアス`nvm='_nvm'`入力するときにそうなるようにする`nvm`, wrapperを経由します。 シェルの初期化時に同様にその後も行います。<code>nvm use --lts</code>。</p> </div> <div class="admonitionblock tip"> <table> <tr> <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> <div class="paragraph"> <p>`nvm_version_path`はNVMの内部関数で、バージョンのフルパスを解決します。これにより、パスを手動で再構築する必要がなくなります。</p> </div> </td> </tr> </table> </div> </div> </div> </div> <div class="sect1"> <h2 id="_パスのサマリー表">パスのサマリー表</h2> <div class="sectionbody"> <div class="paragraph"> <p>罠に移る前に、変換のビジュアルサマリー。左側に、あなたが持っていたもの（すべて`.zshrc`, エージェントに見えない)。 右側、あなたが今持っているもの (必須のパスの中の`.zshenv`, どこでも見える)</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 25%;"> <col style="width: 25%;"> <col style="width: 25%;"> <col style="width: 25%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">ツール</th> <th class="tableblock halign-left valign-top">前 (.zshrc だけ)</th> <th class="tableblock halign-left valign-top">その後 (.zshenv + symlink)</th> <th class="tableblock halign-left valign-top">OpenCodeによって表示されますか？</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">`~/apps`python s = input() print(s, end='')</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">.zshrcでPATHがエクスポートされていない</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>$HOME/apps</code>.zshenvの中</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�✅</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">SDKMAN Java</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>sdkman-init.sh</code>.zshrc でソースされている</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>$HOME/.sdkman/candidates/java/current/bin</code>.zshenv内</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�✅</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">SDKMAN Gradle</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>sdkman-init.sh</code>.zshrc でソースされている</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>$HOME/.sdkman/candidates/gradle/current/bin</code>.zshenv内で</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">(This response is intentionally left blank.)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">NVM ノード</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>nvm use --lts</code>.zshrcの中に</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>$HOME/.nvm/current/bin</code>.zshenv (symlink)の中に</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">pnpm</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>$PNPM_HOME</code>.zshrc に</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>$PNPM_HOME</code>.zshenvの中で</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">JetBrains ツールボックス</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Toolbox によって .zshrc に自動的に追加されました</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>$HOME/.local/share/JetBrains/Toolbox/scripts</code>.zshenv 内</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Python 3</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">`/usr/bin/python3`PATH .zshrc内</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">明示的に .zshenv で</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✅</p></td> </tr> </tbody> </table> </div> </div> <div class="sect1"> <h2 id="_罠と対策">罠と対策</h2> <div class="sectionbody"> <div class="paragraph"> <p>このアプローチではすべてが完璧ではない。私が遭遇した問題と、それを回避する方法を示します。</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 33.3333%;"> <col style="width: 33.3333%;"> <col style="width: 33.3334%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">�罠</th> <th class="tableblock halign-left valign-top">説明</th> <th class="tableblock halign-left valign-top">軽減</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">PATH が重複</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">もし.zshenv と .zshrc が同じパスを追加すると、それが二回表示されます</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">`.zshenv`出典が明記されている<strong>前</strong>.zshrc. 両方ともインタラクティブシェルで読み込まれます。PATHが重複することがあります。これは見た目の問題で、機能的ではありません。これを避けるには、デフォルトのPATHに含まれていない_absents_なパスだけを.zshenvに記述してください。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">NVM : <code>.zshenv</code> にハードコードされたバージョン</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">置く`~/.nvm/versions/node/v22.19.0/bin`ハードコードは次の段階で偽になる`nvm install`</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">シンボリックリンクを使用する`$HOME/.nvm/current/bin`+ ラッパー`_nvm`.zshrcの中</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">SDKMAN : .zshenv で sdkman-init.sh を source する</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�遅い、脆い、非対話シェルでは役に立たない</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">シンボリックリンクを使用する`candidates/<tool>/current/bin`直接に</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">変更後のエイリアスが不足</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ラッパー`nvm='_nvm'`.zshrcの変更は、再読み込み後にのみ反映されます</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">シェルを再起動するまたは`source ~/.zshrc`</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">OpenCode は変更を検出していません</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">エージェントはすでに古い .zshenv を使ってそのサブシェルを起動しています</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">OpenCodeの.zshenvを変更後に再起動する</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">.zshenv が重すぎる</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">.zshenv に重い関数や対話型の初期化を置く</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">.zshenv = 環境変数とPATH のみ。なし`source`, 重い関数はなく、プロンプトもありません。</p></td> </tr> </tbody> </table> </div> </div> <div class="sect1"> <h2 id="_学んだ教訓">学んだ教訓</h2> <div class="sectionbody"> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>.zshrc` はインタラクティブです、<code>.zshenv</code> は普遍的です。</strong>— 変数が <em>すべて</em> のシェル（AIエージェント、cron、スクリプト、IDE）に存在する必要がある場合、それはに入ります`.zshenv`リビングは快適ですが、エントランスホールは誰もが通る唯一の場所です。</p> </li> <li> <p><strong>バージョンマネージャーは等しくない</strong>SDKMANはシンボリックリンクを作成する`current`設計によるものです。 NVM ではない。 このギャップを手動で埋める必要があります。 これは重要な教訓です：PATHを設定する前に、あなたのマネージャーが安定した固定ポイントを提供しているか確認してください。</p> </li> <li> <p><strong>.zshenv 内で init スクリプトをソースしないでください</strong>—<code>sdkman-init.sh</code> et `nvm.sh`インタラクティブなシェルのために設計されています。 非インタラクティブなコンテキストでは遅くて脆弱です。 シンボリックリンクは`current`十分で、即座です。</p> </li> <li> <p><strong>常に非インタラクティブなシェルでテストする</strong>—`zsh -c 'echo $PATH'`エージェントが見るものを正確にシミュレートします。 これは検証テストです。 このテストがなければ、エージェントに対して構成が機能しているかどうか分かりません。</p> </li> <li> <p><strong>Wrapperパターンは再利用可能です</strong>— 同じパターン`_nvm`+`alias nvm='_nvm'`これは、PATHを動的に変更し、安定した痕跡を残さないすべてのツールに適用されます。 これはあなたのアイデアボックスに追加されるもう一つのツールです。</p> </li> </ol> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE rectangle "前" as avant { card "対話型シェル : ✅\n非対話型シェル : ❌\nOpenCode : ❌\nCron : ❌\nScripts : ❌" as av1 #FDEDEC } rectangle "後" as apres { card "対話型シェル : ✅ 非対話型シェル : ✅ OpenCode : ✅ Cron : ✅ スクリプト : ✅" as ap1 #E8F8E8 } avant --> apres : .zshenv +\nsymlink ~/.nvm/current @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_最終確認">最終確認</h2> <div class="sectionbody"> <div class="paragraph"> <p>作成した後`.zshenv`そして NVM シンボリックリンク、すべてが正常に動作することを確認してください — 両方のコンテキストで:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Shell interactif (votre terminal) gh --version && java -version && node --version</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Shell non-interactif (simulation OpenCode) zsh -c 'gh --version && java -version && node --version'</code></pre> </div> </div> <div class="paragraph"> <p>両方とも成功しなければなりません。はいの場合、あなたのAIエージェントはあなたと同じツールを見ることになります。いいえの場合、ステップバイステップの診断に戻ってください — おそらくパスを忘れたか、NVMのシンボリックリンクが古いです。</p> </div> <div class="admonitionblock tip"> <table> <tr> <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> <div class="paragraph"> <p><strong>このテストを自動化してください。</strong>このチェックを、ツールを更新するたびに実行するヘルスチェックスクリプトに追加してください。Un`zsh -c 'which java && which node && which gh'`CIでは、これは驚きに対する保険です。</p> </div> </td> </tr> </table> </div> <div class="paragraph"> <p><em><em>_ 非対話型シェルは、無言のゲストのようになります：それは玄関に表示されているものだけを読みます。PATH がリビングにある場合、それは決してそれを見ることはありません。 </em>_</em></p> </div> </div> </div> <div class="sect1"> <h2 id="_リンク">リンク</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_公式ドキュメント">公式ドキュメント</h3> <div class="ulist"> <ul> <li> <p><a href="https://zsh.sourceforge.io/Doc/Release/Files.html">Zshドキュメント : スタートアップファイル</a>Zshの初期化ファイルに関する公式リファレンスです。そこですべてが説明されていますが、しばしば忘れられがちです。</p> </li> <li> <p><a href="https://opencode.ai/docs/config/">OpenCode : 設定</a>— OpenCodeおよびその実行環境の設定方法。</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_言及されたツール">言及されたツール</h3> <div class="ulist"> <ul> <li> <p><a href="https://github.com/nvm-sh/nvm">GitHub 上の NVM</a>— Node Version Manager. Node.jsバージョン管理。</p> </li> <li> <p><a href="https://sdkman.io">SDKMAN — 公式サイト</a>— SDKMAN! JVM（Java、Kotlin、Gradleなど）用のバージョン管理ツール</p> </li> <li> <p><a href="https://sdkman.io/install">SDKMAN : インストール</a>— SDKMAN インストールガイド</p> </li> <li> <p><a href="https://cli.github.com">gh` — GitHub コマンドラインインターフェース</a>— GitHubのコマンドラインツール、あらゆる開発者に不可欠です。</p> </li> <li> <p><a href="https://gradle.org">Gradle — 公式サイト</a>— SDKMANを使ってインストールしているビルドシステム</p> </li> <li> <p><a href="https://pnpm.io">pnpm — 公式サイト</a>— 高速で省スペースなNode.jsパッケージマネージャー。</p> </li> <li> <p><a href="https://www.jetbrains.com/toolbox-app/">JetBrains Toolbox</a>— JetBrainsのIDE管理者、そのスクリプトをPATHに追加します。</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_もっと進む">もっと進む</h3> <div class="ulist"> <ul> <li> <p><a href="https://blog.andy2003.org/posts/2022/zsh-dotfiles/">Zsh dotfiles: 完全ガイド</a>— Zshのdotfiles管理についての詳しい記事</p> </li> <li> <p><a href="https://wiki.archlinux.org/title/Zsh">ArchWikiのZsh</a>— Zshの優れたコミュニティドキュメントの一つ。</p> </li> <li> <p><a href="https://github.com/nvm-sh/nvm/issues">NVM の GitHub の Issue</a>— シンボリックリンク周辺の議論を見るには`current`およびPATHの問題があります。</p> </li> </ul> </div> </div> </div> </div> https://cheroliv.com/blog/pilot-batch/0105_integrer_graphify_workflow_gradle_post.html Sun, 19 Apr 2026 00:00:00 +0000 blog/pilot-batch/0105_integrer_graphify_workflow_gradle_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_問題コードに常に遅れを取る図表">問題：コードに常に遅れを取る図表</a></li> <li><a href="#_解決策決定論的なknowledge_graph_plantumlパイプライン">解決策：決定論的なKnowledge Graph → PlantUMLパイプライン</a></li> <li><a href="#_ステップ_1_graphifyをインストールしナレッジグラフを抽出する">ステップ 1: Graphifyをインストールし、ナレッジグラフを抽出する</a> <ul class="sectlevel2"> <li><a href="#_インストール">インストール</a></li> <li><a href="#_除外を設定する">除外を設定する</a></li> <li><a href="#_knowledge_graphを抽出する">Knowledge Graphを�抽出する</a></li> </ul> </li> <li><a href="#_ステップ_2gradleプラグインがknowledge_graphをplantumlに変換します">ステップ 2：GradleプラグインがKnowledge GraphをPlantUMLに変換します</a> <ul class="sectlevel2"> <li><a href="#_パイプラインアーキテクチャ">パイプラインアーキテクチャ</a></li> <li><a href="#_内部コンポーネント">内部コンポーネント</a></li> <li><a href="#_レンダリングルール">レンダリングルール</a></li> </ul> </li> <li><a href="#_ステップ3日常での使用">ステップ3：日常での使用</a> <ul class="sectlevel2"> <li><a href="#_完全図">完全図</a></li> <li><a href="#_コミュニティで絞り込む">コミュニティで絞り込む</a></li> <li><a href="#_エッジの種類でフィルタリング">エッジの種類でフィルタリング</a></li> <li><a href="#_ノードの種類と信頼度でフィルター">ノードの種類と信頼度でフィルター</a></li> <li><a href="#_カスタム出力ディレクトリ">カスタム出力ディレクトリ</a></li> <li><a href="#_プロパティの完全な参照">プロパティの完全な参照</a></li> </ul> </li> <li><a href="#_gradle_ワークフローにおける完全なパイプライン">Gradle ワークフローにおける完全なパイプライン</a> <ul class="sectlevel2"> <li><a href="#_ワークフローのタイプ">ワークフローのタイプ</a></li> <li><a href="#_開発サイクルへの統合">開発サイクルへの統合</a></li> <li><a href="#_インクリメンタルアップデート">インクリメンタルアップデート</a></li> </ul> </li> <li><a href="#_ドッグフィーディング_プラグインは自身をドキュメント化する">ドッグフィーディング : プラグインは自身をドキュメント化する</a></li> <li><a href="#_なぜそれが決定的なのかそしてなぜそれが重要なのか">なぜそれが決定的なのか（そしてなぜそれが重要なのか）</a></li> <li><a href="#_パイプライン自身の図">パイプライン自身の図</a></li> <li><a href="#_プロジェクトガバナンスへの統合">プロジェクトガバナンスへの統合</a></li> <li><a href="#_設定_5分間のチェックリスト">設定 : 5分間のチェックリスト</a></li> <li><a href="#_落とし穴と緩和策">落とし穴と緩和策</a></li> <li><a href="#_最終的に得られるもの">最終的に得られるもの</a></li> <li><a href="#_リンク">リンク</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間：12 minutes</div> <p>あなたのコードベースは大きくなっています。モジュール間の依存関係が増えていきます。アーキテクチャのドキュメントは、書かれる前に古くなってしまいます。あなたのGradleビルドが <em>自動的に</em> 実際のコード構造から最新の図を生成できたらどうでしょうか？これはまさに、Graphify + PlantUML Gradle プラグイン パイプラインが行うことです：<code>graphify . --no-viz`Knowledge Graph を抽出する</code>./gradlew generateKnowledgeGraphDiagram`これをPlantUML図に変換します。ゼロLLM、ゼロ手動、100%決定的。</p> </div> <div class="dlist"> <dl> <dt class="hdlist1">目次</dt> <dd> <p>[]</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_問題コードに常に遅れを取る図表">問題：コードに常に遅れを取る図表</h2> <div class="sectionbody"> <div class="paragraph"> <p>数千行を超えるプロジェクトはこの症候群に直面します：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>プロジェクトの始めにアーキテクチャ図を描きます</p> </li> <li> <p>コードが進化し、依存関係が変わる</p> </li> <li> <p>�図は装飾的な嘘になる</p> </li> <li> <p>誰もそれをアップデートしない、なぜならそれは面倒だから。</p> </li> <li> <p>新参者はそれに基づいて判断し、間違いを犯す</p> </li> </ol> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam ActivityBackgroundColor #FDEDEC skinparam ActivityDiamondBackgroundColor #FFF3CD start :Diagramme d'architecture créé\n(manuellement, à la main); :Le code évolue\n(nouvelles classes, nouvelles dépendances); :Diagramme obsolète\n(ne reflète plus le code); if (Qui met à jour ?) then (Personne) :Documentation mensongère; note right: Les nouveaux développeurs\nse basent dessus... et font des erreurs else (Quelqu'un) :Mise à jour manuelle\n(2-3 heures de travail); note right: Déjà obsolète\nà la prochaine PR endif stop @enduml</pre> </div> </div> <div class="paragraph"> <p>質問は、<em>図が必要か？</em> ではない — みんなそれが必要だと知っている。質問は：<strong>誰がそれらを最新の状態に保っているのですか？</strong></p> </div> <div class="paragraph"> <p>答え：誰も。ただし自動の場合を除く。</p> </div> </div> </div> <div class="sect1"> <h2 id="_解決策決定論的なknowledge_graph_plantumlパイプライン">解決策：決定論的なKnowledge Graph → PlantUMLパイプライン</h2> <div class="sectionbody"> <div class="paragraph"> <p>原理はシンプルです：手で図を描く代わりに、それを<strong>実際のコード構造から生成される</strong>。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle actor Développeur component "Graphify (pip install graphifyy)" as Graphify collections "graphify-out/graph.json (ナレッジグラフ)" as KGJSON component "PlantUML Gradle プラグイン\n(generateKnowledgeGraphDiagram)" as Plugin component "KnowledgeGraphParser" as Parser component "KnowledgeGraphRenderer" as Renderer component "PlantumlService\n(検証 + PNGレンダリング)" as PS collections "diagrams/knowledge-graph/\n(.puml + .png)" as Output Développeur --> Graphify : graphify . --no-viz Graphify --> KGJSON : extrait la structure\ndu code source Développeur --> Plugin : ./gradlew generateKnowledgeGraphDiagram Plugin --> Parser : parse(graph.json) Parser --> Plugin : KnowledgeGraph\n(noeuds + arêtes + communautés) Plugin --> Renderer : render(graph, filters) Renderer --> Plugin : code PlantUML\ndéterministe Plugin --> PS : validateSyntax + generateImage PS --> Output : .puml + .png note bottom of Plugin Pipeline DÉTERMINISTE Aucun appel LLM Résultat reproductible end note @enduml</pre> </div> </div> <div class="paragraph"> <p>2つのコマンド。それだけです。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Étape 1 : extraire le Knowledge Graph graphify . --no-viz # Étape 2 : générer les diagrammes PlantUML ./gradlew generateKnowledgeGraphDiagram</code></pre> </div> </div> <div class="paragraph"> <p>結果？ ファイル`.puml` et <code>.png`中`diagrams/knowledge-graph/</code>, Git でバージョン管理され, 常にコードと最新の状態を保つ。</p> </div> </div> </div> <div class="sect1"> <h2 id="_ステップ_1_graphifyをインストールしナレッジグラフを抽出する">ステップ 1: Graphifyをインストールし、ナレッジグラフを抽出する</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_インストール">インストール</h3> <div class="paragraph"> <p>Graphifyはあなたのコードベースを分析し、構造化されたナレッジグラフを構築するPythonツール：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Méthode recommandée uv tool install graphifyy && graphify install --platform opencode # Alternative avec pip pip install graphifyy && graphify install --platform opencode</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_除外を設定する">除外を設定する</h3> <div class="paragraph"> <p>ファイルを作成`.graphifyignore`プロジェクトのルートに置き、ビジネスロジックに属していないファイルを除外します：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-gitignore hljs" data-lang="gitignore"># Secrets — JAMAIS dans le graphe *-context.yml *.env # Fichiers générés build/ .gradle/ # Tests fonctionnels src/functionalTest/</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_knowledge_graphを抽出する">Knowledge Graphを�抽出する</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">graphify . --no-viz</code></pre> </div> </div> <div class="paragraph"> <p>フラグ`--no-viz`HTMLの生成をスキップします (Gradleパイプラインでは不要です)。 結果はファイルです。`graphify-out/graph.json`含む :</p> </div> <div class="ulist"> <ul> <li> <p><strong>結び目</strong>：クラス、関数、ファイル―そのタイプとコミュニティとともに</p> </li> <li> <p><strong>エッジ</strong>ノード間の関係 (EXTRACTED はコードから、INFERRED は LLMによって)</p> </li> <li> <p><strong>コミュニティ</strong>: 自動的にグループ化されたリンクされたノード</p> </li> </ul> </div> <div class="listingblock"> <div class="title">構造の例`graph.json`</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{ "nodes": [ {"id": "0", "label": "LlmService", "file_type": "code", "community": 0}, {"id": "1", "label": "ApiKeyPool", "file_type": "code", "community": 0}, {"id": "2", "label": "PlantumlService", "file_type": "code", "community": 1} ], "links": [ {"source": "1", "target": "0", "relation": "uses", "confidence": "EXTRACTED", "weight": 0.9}, {"source": "0", "target": "2", "relation": "calls", "confidence": "INFERRED", "weight": 0.7} ] }</code></pre> </div> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p>ソースコード (<code>.kt</code>, <code>.java</code>) は tree-sitter によってローカルで分析されます,<strong>�異議なしのLLM</strong>. ドキュメントファイルのみ (<code>.adoc</code>, <code>.md</code>) LLMを呼び出して意味的抽出を行う必要があります。 それで`--update`Kotlin コードではほぼ瞬時に実行されます。</p> </div> </td> </tr> </table> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ステップ_2gradleプラグインがknowledge_graphをplantumlに変換します">ステップ 2：GradleプラグインがKnowledge GraphをPlantUMLに変換します</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_パイプラインアーキテクチャ">パイプラインアーキテクチャ</h3> <div class="paragraph"> <p>プラグイン`com.cheroliv.plantuml`タスクを組み込む`generateKnowledgeGraphDiagram`変換する`graph.json`PlantUML図の形で<strong>完全に決定論的</strong>:</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE participant "Gradle" as G participant "知識グラフダイアグラム生成タスク" as Task participant "KnowledgeGraphParser" as Parser participant "ナレッジグラフレンダラー" as Renderer participant "Plantumlサービス" as PS collections "graphify-out/graph.json" as JSON G -> Task : execute Task -> JSON : read Task -> Parser : parse(graph.json) Parser --> Task : KnowledgeGraph\n(noeuds + arêtes + communautés) Task -> Renderer : render(graph, filters) Renderer --> Task : code PlantUML\n(déterministe) Task -> PS : validateSyntax(plantumlCode) alt syntaxe valide Task -> PS : generateImage → .png else syntaxe invalide Task -> Task : save .puml avec warning end @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_内部コンポーネント">内部コンポーネント</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 50%;"> <col style="width: 50%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">コンポーネント</th> <th class="tableblock halign-left valign-top">役割</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>KnowledgeGraphParser</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">解析`graph.json`サポート 3 フォーマット : ネイティブ graphify (<code>nodes</code>+<code>links</code>), レガシー (<code>communities</code>), flat. 数値 ID をラベルに解決します。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>KnowledgeGraphRenderer</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">決定的に変換する一つ`KnowledgeGraph`PlantUML コード。タイプ別にグループ、パッケージにコミュニティ、自動凡例。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>GenerateKnowledgeGraphDiagramTask</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Gradleタスクは、parse → render → validate → PNGをオーケストレーションします。Gradleプロパティ経由で設定可能。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>kgmodels.kt</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">データモデル：<code>KnowledgeGraph</code>, <code>KnowledgeGraphNode</code>, <code>KnowledgeGraphEdge</code>, <code>KnowledgeGraphCommunity</code>, <code>EdgeType</code>。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>PlantumlService</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">構文検証 + PNGレンダリング（プラグインのすべてのタスクで再利用）</p></td> </tr> </tbody> </table> </div> <div class="sect2"> <h3 id="_レンダリングルール">レンダリングルール</h3> <div class="paragraph"> <p>レンダラーは決定論的な視覚的慣習を適用します：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 33.3333%;"> <col style="width: 33.3333%;"> <col style="width: 33.3334%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">エッジのタイプ</th> <th class="tableblock halign-left valign-top">PlantUML記法</th> <th class="tableblock halign-left valign-top">意味</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">�抽出された</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>-→</code>(実線, 黒)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ソースコードから抽出された関係 (確実性)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">推論された</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>..></code>(点線)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">LLMによって推論された関係 （信頼スコア）</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">あいまいな</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>--x</code>(赤い点線)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�曖昧な関係 (確認が必要)</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>コミュニティは、自動色パレットを持つ PlantUML パッケージとしてレンダリングされます。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ステップ3日常での使用">ステップ3：日常での使用</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_完全図">完全図</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Générer le diagramme du Knowledge Graph complet ./gradlew generateKnowledgeGraphDiagram</code></pre> </div> </div> <div class="paragraph"> <p>出力：<code>diagrams/knowledge-graph/knowledge-graph-full.puml</code>（空）<code>.png</code></p> </div> </div> <div class="sect2"> <h3 id="_コミュニティで絞り込む">コミュニティで絞り込む</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Une seule communauté ./gradlew generateKnowledgeGraphDiagram \ -Pplantuml.kg.community=community_0 # Limiter le nombre de noeuds (lisibilité) ./gradlew generateKnowledgeGraphDiagram \ -Pplantuml.kg.community=community_0 \ -Pplantuml.kg.maxNodes=15</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_エッジの種類でフィルタリング">エッジの種類でフィルタリング</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Uniquement les relations certaines (EXTRACTED) ./gradlew generateKnowledgeGraphDiagram \ -Pplantuml.kg.edgeTypes=EXTRACTED # Relations certaines + inférées ./gradlew generateKnowledgeGraphDiagram \ -Pplantuml.kg.edgeTypes=EXTRACTED,INFERRED</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ノードの種類と信頼度でフィルター">ノードの種類と信頼度でフィルター</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Uniquement les classes de code ./gradlew generateKnowledgeGraphDiagram \ -Pplantuml.kg.nodeTypes=code # Seuil de confiance minimum (pour les INFERRED) ./gradlew generateKnowledgeGraphDiagram \ -Pplantuml.kg.minConfidence=0.7</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_カスタム出力ディレクトリ">カスタム出力ディレクトリ</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./gradlew generateKnowledgeGraphDiagram \ -Pplantuml.kg.outputDir=docs/architecture</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_プロパティの完全な参照">プロパティの完全な参照</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 33.3333%;"> <col style="width: 33.3333%;"> <col style="width: 33.3334%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">所有権</th> <th class="tableblock halign-left valign-top">デフォルト</th> <th class="tableblock halign-left valign-top">説明</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>plantuml.kg.community</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">(すべて)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">名前でコミュニティをフィルタリング（部分一致）</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>plantuml.kg.edgeTypes</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><em>(皆)</em></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">カンマで区切られたエッジの種類：<code>EXTRACTED</code>, <code>INFERRED</code>, <code>AMBIGUOUS</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>plantuml.kg.minConfidence</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>0.0</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">エッジの最小信頼しきい値</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>plantuml.kg.maxNodes</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">(無制限)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">表示する最大ノード数</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>plantuml.kg.nodeTypes</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">(すべて)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ノードの種類、カンマで区切られた（例`class`, <code>code</code>)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>plantuml.kg.outputDir</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>diagrams/knowledge-graph</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ファイルの出力ディレクトリ`.puml` et <code>.png</code></p></td> </tr> </tbody> </table> </div> </div> </div> <div class="sect1"> <h2 id="_gradle_ワークフローにおける完全なパイプライン">Gradle ワークフローにおける完全なパイプライン</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_ワークフローのタイプ">ワークフローのタイプ</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam ActivityBackgroundColor #E8F4FD skinparam ActivityDiamondBackgroundColor #FFF3CD skinparam ActivityBorderColor #2C3E50 start partition "抽出" { :graphify . --no-viz; note right: Analyse le code source\ntree-sitter (local, pas de LLM) :graphify-out/graph.json; note right: Noeuds + arêtes\n+ communautés } partition "世代" { :./gradlew generateKnowledgeGraphDiagram; note right: Pipeline déterministe\nparse → render → validate → PNG if (Filtres actifs ?) then (Oui) :Appliquer filtres\n(community, edgeTypes,\nmaxNodes, nodeTypes); else (Non) :Diagramme complet; endif :diagrams/knowledge-graph/\nknowledge-graph-full.puml\nknowledge-graph-full.png; } partition "統合" { :git add diagrams/knowledge-graph/; :git commit; note right: Diagrammes versionnés\ntoujours à jour avec le code } stop @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_開発サイクルへの統合">開発サイクルへの統合</h3> <div class="paragraph"> <p>パイプラインは開発の重要な段階に自然に統合されます：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE state "開発" as dev state "�抽出 graphify . --no-viz" as extract state "生成\n./gradlew generateKnowledgeGraphDiagram" as generate state "コミット バージョン管理されたダイアグラム" as commit [*] --> dev dev --> extract : Code modifié extract --> generate : graph.json à jour generate --> commit : .puml + .png générés commit --> dev : Diagrammes dans le repo note right of extract Quasi instantané sur du code Kotlin (tree-sitter, pas de LLM) end note note right of generate Déterministe Pas de LLM Résultat reproductible end note @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_インクリメンタルアップデート">インクリメンタルアップデート</h3> <div class="paragraph"> <p>コードが変更されたとき、ゼロからグラフ全体を再構築するわけではありません：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Mise à jour incrémentale (fichiers modifiés uniquement) graphify . --update # Puis régénérer les diagrammes ./gradlew generateKnowledgeGraphDiagram</code></pre> </div> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p><code>--update`再抽出のみ 変更されたファイル (SHA256で検出された`graphify-out/cache/</code>) Kotlin のコードでは、tree-sitter がローカルで動作し LLM を呼び出さないため、ほぼ瞬時に動作します。</p> </div> </td> </tr> </table> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ドッグフィーディング_プラグインは自身をドキュメント化する">ドッグフィーディング : プラグインは自身をドキュメント化する</h2> <div class="sectionbody"> <div class="paragraph"> <p>PlantUML プラグインは、プロンプトをダイアグラムに変換するために存在します。また、自分の <em>propre</em> コードベースの Knowledge Graph もドキュメント用ダイアグラムに変換できます。これは <em>dogfooding</em> です：プラグインは自分のサービスを利用します。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle package "標準パイプライン (ユーザー → ダイアグラム)" as normal { [Fichier .prompt] as prompt [LlmService\n+ ApiKeyPool] as llm1 [ProcessPlantumlPromptsTask] as task1 [Diagramme PNG] as out1 prompt --> task1 task1 --> llm1 llm1 --> out1 } package "Pipeline Knowledge Graph\n(決定論的、LLMを使用しない)" as kg { [graphify-out/graph.json] as kgjson [KnowledgeGraphParser] as parser [KnowledgeGraphRenderer] as renderer [PlantumlService] as ps [Diagramme PNG\n(documentation du plugin)] as out2 kgjson --> parser parser --> renderer renderer --> ps ps --> out2 } package "パイプライン ドッグフーディング (LLM → プラグインのドキュメント)" as dogfood { [GraphifyPromptAdapter] as gpa [Fichiers .prompt\nauto-générés] as auto_prompt [LlmService\n+ ApiKeyPool] as llm2 [ProcessPlantumlPromptsTask] as task2 [Diagramme PNG\n(documentation LLM)] as out3 kgjson --> gpa gpa --> auto_prompt auto_prompt --> task2 task2 --> llm2 llm2 --> out3 } note "同じ LlmService、同じ ApiKeyPool、 同じ PlantumlService — 複製ゼロ" as N @enduml</pre> </div> </div> <div class="paragraph"> <p>関連付けられた Gradle タスク :</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 33.3333%;"> <col style="width: 33.3333%;"> <col style="width: 33.3334%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">タスク</th> <th class="tableblock halign-left valign-top">LLM ?</th> <th class="tableblock halign-left valign-top">説明</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>generateKnowledgeGraphDiagram</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">変換`graph.json`PlantUML (決定的)で</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>generateDiagramDocs</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">生成する`.prompt`グラフから、LLM（dogfooding）を使って処理しています。</p></td> </tr> </tbody> </table> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Documentation déterministe (rapide, pas de LLM) ./gradlew generateKnowledgeGraphDiagram # Documentation LLM (plus riche, consomme des tokens) ./gradlew generateDiagramDocs</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_なぜそれが決定的なのかそしてなぜそれが重要なのか">なぜそれが決定的なのか（そしてなぜそれが重要なのか）</h2> <div class="sectionbody"> <div class="paragraph"> <p>パイプラインの重要なポイント`generateKnowledgeGraphDiagram` : <strong>彼はどのLLMも呼び出さない</strong>. 変換`graph.json`→ PlantUML は純粋関数です。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle rectangle "決定的パイプライン (generateKnowledgeGraphDiagram)" as det { [graph.json] as json [KnowledgeGraphParser] as parser [KnowledgeGraphRenderer] as renderer [PlantUML code] as puml json --> parser : parse parser --> renderer : KnowledgeGraph renderer --> puml : render (fonction pure) } rectangle "パイプライン LLM (processPlantumlPrompts)" as llm { [.prompt] as prompt [LlmService] as llmSvc [ChatModel] as model [PlantUML code] as puml2 prompt --> llmSvc llmSvc --> model : API call model --> puml2 : réponse non-déterministe } note bottom of det Même entrée → même sortie Pas de latence réseau Pas de coût en tokens Reproductible en CI end note note bottom of llm Même entrée → sortie variable Latence réseau (1-5s) Coût en tokens Nécessite une clave API end note @enduml</pre> </div> </div> <div class="paragraph"> <p>具体的な利点：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 50%;"> <col style="width: 50%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">利点</th> <th class="tableblock halign-left valign-top">インパクト</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">再現性</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">同じ`graph.json`→ 同じ図。正確です。毎回。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ゼロコスト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">LLMの呼び出しなし = トークンなし = API請求なし</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ゼロレイテンシー</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Parse + render は~100msかかり、1〜5秒ではありません。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">CI対応</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">APIキーは必要ありません。変動するLLMの応答によるフレークなテストは発生しません。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">バージョン可能</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Le <code>.puml`テキストは生成される。私たちそれをできる`diff</code>, PRのレビュアー, Gitでバージョン管理する。</p></td> </tr> </tbody> </table> </div> </div> <div class="sect1"> <h2 id="_パイプライン自身の図">パイプライン自身の図</h2> <div class="sectionbody"> <div class="paragraph"> <p>ループを閉じるために、プラグインによって生成されるパイプラインの図を以下に示します：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE participant "開発者" as Dev participant "グラドル" as G participant "知識グラフ図を生成するタスク" as Task participant "KnowledgeGraphParser" as Parser participant "ナレッジグラフレンダラー" as Renderer participant "PlantUMLサービス" as PS collections "graphify-out/graph.json" as JSON collections "diagrams/knowledge-graph/" as Out Dev -> G : ./gradlew generateKnowledgeGraphDiagram G -> Task : execute Task -> JSON : read Task -> Parser : parse(graph.json) Parser --> Task : KnowledgeGraph alt filtres actifs Task -> Task : appliquer filtres\n(community, edgeTypes, maxNodes…) end Task -> Renderer : render(graph, filters) Renderer --> Task : code PlantUML Task -> PS : validateSyntax() alt valide Task -> PS : generateImage() PS --> Out : .puml + .png else invalide Task -> Out : .puml (avec warning) end @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_プロジェクトガバナンスへの統合">プロジェクトガバナンスへの統合</h2> <div class="sectionbody"> <div class="paragraph"> <p>私たちのプロジェクトでは、このパイプラインはAIエージェントのためのEAGER/LAZYコンテキスト管理戦略に組み込まれます。ナレッジグラフは、手動のアーキテクチャドキュメントに代わり、構造化され、クエリ可能で、自動的に更新されるグラフを提供します。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle package "EAGER (常に充電されている)" as eager { [PROMPT_REPRISE.adoc\n(contexte session)] as pr [INDEX.adoc\n(vue d'ensemble)] as idx [GRAPH_REPORT.adoc\n(~50 lignes)] as gr } package "LAZY — 戦略 (要請による)" as lazy_strat { [Méthodologies] as meth [Archives sessions] as sessions } package "LAZY — Graphify (ターゲットクエリ)" as lazy_graph { [graph.json] as gj [Queries\n(query/path/explain)] as queries } package "Pipeline PlantUML (自動生成された)" as puml { [generateKnowledgeGraphDiagram] as kgTask [generateDiagramDocs] as ddTask [Diagrammes PNG] as diagrams } Agent --> eager : Lit en début de session Agent ..> lazy_strat : Charge si type détecté Agent ..> lazy_graph : Query si besoin structurel kgTask --> diagrams : Déterministe ddTask --> diagrams : Via LLM note right of gr Condensé du Knowledge Graph God nodes + communautés Remplace ECOSYSTEM_OVERVIEW (225 lignes → 50 lignes) end note @enduml</pre> </div> </div> <div class="paragraph"> <p>二つのシステムの結びつきは補完的である:</p> </div> <div class="ulist"> <ul> <li> <p><strong>戦略は「いつ」と「どのように」を管理する</strong>— ガバナンス, ワークフロー, アーカイブ</p> </li> <li> <p><strong>GraphifyはQUOIとOÙを管理します</strong>コード構造, 関係, ターゲット絞り込みクエリ</p> </li> </ul> </div> <div class="paragraph"> <p><em><em>_ セッション戦略はを管理します<strong>いつ</strong> et le <strong>どう</strong>(ガバナンス, ワークフロー, しきい値), Graphifyは管理します<strong>何？</strong> et le <strong>どこ</strong>(コードの構造、関係、ターゲットクエリ). PlantUMLパイプラインは管理します<strong>何で</strong>(決定論的でバージョン管理され、常に最新の図) </em>_</em></p> </div> </div> </div> <div class="sect1"> <h2 id="_設定_5分間のチェックリスト">設定 : 5分間のチェックリスト</h2> <div class="sectionbody"> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 33.3333%;"> <col style="width: 33.3333%;"> <col style="width: 33.3334%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">#</th> <th class="tableblock halign-left valign-top">ステップ</th> <th class="tableblock halign-left valign-top">注文</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Graphifyをインストール</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>uv tool install graphifyy</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">除外を設定</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">作成する`.graphifyignore`</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Knowledge Graphを抽出する</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>graphify . --no-viz</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">図を生成する</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>./gradlew generateKnowledgeGraphDiagram</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">結果をコミットする</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>git add diagrams/knowledge-graph/</code></p></td> </tr> </tbody> </table> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Script complet en 5 commandes uv tool install graphifyy cat > .graphifyignore << 'EOF' *-context.yml *.env build/ .gradle/ EOF graphify . --no-viz ./gradlew generateKnowledgeGraphDiagram git add graphify-out/GRAPH_REPORT.adoc graphify-out/graph.json diagrams/knowledge-graph/</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_落とし穴と緩和策">落とし穴と緩和策</h2> <div class="sectionbody"> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 33.3333%;"> <col style="width: 33.3333%;"> <col style="width: 33.3334%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">�罠</th> <th class="tableblock halign-left valign-top">説明</th> <th class="tableblock halign-left valign-top">緩和</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">グラフが濃すぎる</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">大きなプロジェクトは、数百の読み取り不能なノードを生成します</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">使用する`-Pplantuml.kg.maxNodes=30`そしてコミュニティでフィルタリング</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">除外が広すぎる</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">多すぎるファイルが`.graphifyignore`グラフの値を減少させる</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">まずは credentials と build のみを除外して始める</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">�矢印の方向</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">INFERREDエッジはあいまいな方向を持つ可能性がある</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">フィルターで`-Pplantuml.kg.edgeTypes=EXTRACTED`特定の関係に対してのみ</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">旧式のグラフ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">コードは変わるが、グラフは再構築されない</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">使う`graphify . --update`定期的にまたはgitフック`graphify hook install`</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">更新されたコスト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">インクリメンタルアップデートはほぼ無料です (tree-sitter local)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ドキュメントだけ(<code>.adoc</code>) LLMトークンを消費する</p></td> </tr> </tbody> </table> </div> </div> <div class="sect1"> <h2 id="_最終的に得られるもの">最終的に得られるもの</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE rectangle "前に" as avant { card "手描きの図 常に時代遅れ 誰も更新しない" as av1 #FDEDEC } rectangle "後で" as apres { card "自動生成されたダイアグラム コードと常に最新状態 Gitでバージョン管理 決定論的かつ再現可能" as ap1 #E8F8E8 } avant --> apres : graphify . --no-viz\n+ ./gradlew generateKnowledgeGraphDiagram @enduml</pre> </div> </div> <div class="paragraph"> <p>具体的な利益：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 50%;"> <col style="width: 50%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">利益</th> <th class="tableblock halign-left valign-top">詳細</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">常に最新のドキュメンテーション</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�図は現在のコードを反映しており、手動のスナップショットではありません。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">メンテナンスの手間ゼロ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�図はビルドごとに再生成されます</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">技術的負債の削減</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">図を手動で維持する必要はありません</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">新しいもののためのビジュアルコンテキスト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">新しい開発者は図を見てアーキテクチャを理解する</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ファインチューニングの可能性</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ペア (サブグラフ → ダイアグラム) は AI のトレーニングの例です</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">自動検証</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">`PlantumlService.validateSyntax()`生成された各図を確認する</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">迅速なオンボーディング</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">5つのダイアグラム = アーキテクチャの完全なビュー</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>(Empty output) なぜがある者は、いかなる「どうすればいいか」にも耐えることができる。 <em>__</em></p> </div> <div class="paragraph"> <p>Le <em>pourquoi</em> : 図は常に最新状態。Le <em>comment</em> : Gradle パイプライン内の 2 つのコマンド。</p> </div> </div> </div> <div class="sect1"> <h2 id="_リンク">リンク</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="https://github.com/nicholasgasior/graphify">GitHubでGraphify</a></p> </li> <li> <p><a href="https://github.com/cheroliv/plantuml-gradle">PlantUML Gradle プラグイン</a></p> </li> <li> <p><a href="/blog/2026/0104_fg_command_super_tips_post.html">fg コマンドのスーパー テクニック</a>— ターミナルワークフローに関する前の記事</p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2026/0105_integrer_graphify_workflow_gradle_post.html Sun, 19 Apr 2026 00:00:00 +0000 blog/2026/0105_integrer_graphify_workflow_gradle_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_問題図は常にコードに遅れている">問題：図は常にコードに遅れている</a></li> <li><a href="#_解決策決定論的パイプライン_knowledge_graph_plantuml">解決策：決定論的パイプライン Knowledge Graph → PlantUML</a></li> <li><a href="#_ステップ1_graphifyをインストールしknowledge_graphを抽出する">ステップ1 : Graphifyをインストールし、Knowledge Graphを抽出する</a> <ul class="sectlevel2"> <li><a href="#_インストール">インストール</a></li> <li><a href="#_除外を設定する">除外を設定する</a></li> <li><a href="#_ナレッジグラフを抽出">ナレッジグラフを抽出</a></li> </ul> </li> <li><a href="#_ステップ_2_gradle_プラグインは_knowledge_graph_を_plantuml_に変換します">ステップ 2 : Gradle プラグインは Knowledge Graph を PlantUML に変換します</a> <ul class="sectlevel2"> <li><a href="#_パイプラインアーキテクチャ">パイプラインアーキテクチャ</a></li> <li><a href="#_内部コンポーネント">内部コンポーネント</a></li> <li><a href="#_レンダリングルール">レンダリングルール</a></li> </ul> </li> <li><a href="#_ステップ_3_日常での使用">ステップ 3: 日常での使用</a> <ul class="sectlevel2"> <li><a href="#_完全な図">完全な図</a></li> <li><a href="#_コミュニティでフィルタリング">コミュニティでフィルタリング</a></li> <li><a href="#_エッジの種類でフィルタリング">エッジの種類でフィルタリング</a></li> <li><a href="#_ノードのタイプと信頼度でフィルタリング">ノードのタイプと信頼度でフィルタリング</a></li> <li><a href="#_カスタマイズされた出力ディレクトリ">カスタマイズされた出力ディレクトリ</a></li> <li><a href="#_プロパティの完全なリファレンス">プロパティの完全なリファレンス</a></li> </ul> </li> <li><a href="#_gradle_ワークフローにおける完全なパイプライン">Gradle ワークフローにおける完全なパイプライン</a> <ul class="sectlevel2"> <li><a href="#_ワークフローの種類">ワークフローの種類</a></li> <li><a href="#_開発サイクルへの統合">開発サイクルへの統合</a></li> <li><a href="#_インクリメンタルアップデート">インクリメンタルアップデート</a></li> </ul> </li> <li><a href="#_ドッグフーディングプラグインは自分自身をドキュメント化する">ドッグフーディング：プラグインは自分自身をドキュメント化する</a></li> <li><a href="#_なぜそれが決定的なのか_そしてそれが重要である理由">なぜそれが決定的なのか (そしてそれが重要である理由)</a></li> <li><a href="#_パイプライン自体の図">パイプライン自体の図</a></li> <li><a href="#_プロジェクトガバナンスへの統合">プロジェクトガバナンスへの統合</a></li> <li><a href="#_準備_5分のチェックリスト">準備 : 5分のチェックリスト</a></li> <li><a href="#_罠と軽減策">罠と軽減策</a></li> <li><a href="#_最終的に得られるもの">最終的に得られるもの</a></li> <li><a href="#_リンク">リンク</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 12 minutes</div> <p>コードベースは大きくなっています。モジュール間の依存関係が増え続けています。アーキテクチャのドキュメントは、書かれる前に古くなります。あなたのGradleビルドが、実際のコード構造から最新の図を <em>自動的に</em> 生成できたらどうでしょう？これは、Graphify + PlantUML Gradle Plugin パイプラインがまさに行うことです：<code>graphify . --no-viz`Knowledge Graphを抽出する,</code>./gradlew generateKnowledgeGraphDiagram`これはPlantUMLのダイアグラムに変換します。LLMゼロ、マニュアルゼロ、100%決定論的。</p> </div> <div class="dlist"> <dl> <dt class="hdlist1">強迫性障害</dt> <dd> <p>(empty)</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_問題図は常にコードに遅れている">問題：図は常にコードに遅れている</h2> <div class="sectionbody"> <div class="paragraph"> <p>数千行を超えるプロジェクトはこの症候群を経験する：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>プロジェクトの初期にアーキテクチャ図を描きます</p> </li> <li> <p>コードは進化し、依存関係は変わる</p> </li> <li> <p>�図は装飾的な嘘になる</p> </li> <li> <p>誰もそれを更新しないのは、面倒だから</p> </li> <li> <p>新参者はそれに基づいて行動し、間違いを犯す</p> </li> </ol> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam ActivityBackgroundColor #FDEDEC skinparam ActivityDiamondBackgroundColor #FFF3CD start :Diagramme d'architecture créé\n(manuellement, à la main); :Le code évolue\n(nouvelles classes, nouvelles dépendances); :Diagramme obsolète\n(ne reflète plus le code); if (Qui met à jour ?) then (Personne) :Documentation mensongère; note right: Les nouveaux développeurs\nse basent dessus... et font des erreurs else (Quelqu'un) :Mise à jour manuelle\n(2-3 heures de travail); note right: Déjà obsolète\nà la prochaine PR endif stop @enduml</pre> </div> </div> <div class="paragraph"> <p>問題は <em>図が必要か？</em> — みんなが知っている通り、はいです。問題は：<strong>誰がそれらを最新に保っていますか？</strong></p> </div> <div class="paragraph"> <p>答え：だれもいない。ただし、自動の場合は除きます。</p> </div> </div> </div> <div class="sect1"> <h2 id="_解決策決定論的パイプライン_knowledge_graph_plantuml">解決策：決定論的パイプライン Knowledge Graph → PlantUML</h2> <div class="sectionbody"> <div class="paragraph"> <p>原理はシンプルです：手で図を描く代わりに、それらを<strong>実際のコード構造から生成されます</strong>。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle actor Développeur component "Graphify\n(pip install graphifyy)" as Graphify collections "graphify-out/graph.json (ナレッジグラフ)" as KGJSON component "PlantUML Gradleプラグイン\n(generateKnowledgeGraphDiagram)" as Plugin component "KnowledgeGraphParser" as Parser component "ナレッジグラフレンダラー" as Renderer component "PlantumlService (検証 + PNGレンダリング)" as PS collections "diagrams/knowledge-graph/\n(.puml + .png)" as Output Développeur --> Graphify : graphify . --no-viz Graphify --> KGJSON : extrait la structure\ndu code source Développeur --> Plugin : ./gradlew generateKnowledgeGraphDiagram Plugin --> Parser : parse(graph.json) Parser --> Plugin : KnowledgeGraph\n(noeuds + arêtes + communautés) Plugin --> Renderer : render(graph, filters) Renderer --> Plugin : code PlantUML\ndéterministe Plugin --> PS : validateSyntax + generateImage PS --> Output : .puml + .png note bottom of Plugin Pipeline DÉTERMINISTE Aucun appel LLM Résultat reproductible end note @enduml</pre> </div> </div> <div class="paragraph"> <p>2つのコマンド。それだけです。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Étape 1 : extraire le Knowledge Graph graphify . --no-viz # Étape 2 : générer les diagrammes PlantUML ./gradlew generateKnowledgeGraphDiagram</code></pre> </div> </div> <div class="paragraph"> <p>結果は？ ファイル`.puml` et <code>.png`中`diagrams/knowledge-graph/</code>, Git でバージョン管理されている, 常にコードに対して最新の状態を保っています。</p> </div> </div> </div> <div class="sect1"> <h2 id="_ステップ1_graphifyをインストールしknowledge_graphを抽出する">ステップ1 : Graphifyをインストールし、Knowledge Graphを抽出する</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_インストール">インストール</h3> <div class="paragraph"> <p>Graphify は、コードベースを分析し、構造化されたナレッジグラフを構築する Python ツールです：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Méthode recommandée uv tool install graphifyy && graphify install --platform opencode # Alternative avec pip pip install graphifyy && graphify install --platform opencode</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_除外を設定する">除外を設定する</h3> <div class="paragraph"> <p>ファイルを作成`.graphifyignore`プロジェクトのルートでビジネスロジックに属しないファイルを除外する：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-gitignore hljs" data-lang="gitignore"># Secrets — JAMAIS dans le graphe *-context.yml *.env # Fichiers générés build/ .gradle/ # Tests fonctionnels src/functionalTest/</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ナレッジグラフを抽出">ナレッジグラフを抽出</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">graphify . --no-viz</code></pre> </div> </div> <div class="paragraph"> <p>フラグ`--no-viz`HTML生成をスキップします（Gradleパイプラインでは不要です）。結果はファイルです。`graphify-out/graph.json`含む :</p> </div> <div class="ulist"> <ul> <li> <p><strong>ノード</strong>クラス、関数、ファイル — それらのタイプとコミュニティ</p> </li> <li> <p><strong>エッジ</strong>: ノード間の関係 (コードから抽出, LLMによって推測)</p> </li> <li> <p><strong>コミュニティ</strong>: 自動的な関連ノードのグループ化</p> </li> </ul> </div> <div class="listingblock"> <div class="title">構造の例`graph.json`</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{ "nodes": [ {"id": "0", "label": "LlmService", "file_type": "code", "community": 0}, {"id": "1", "label": "ApiKeyPool", "file_type": "code", "community": 0}, {"id": "2", "label": "PlantumlService", "file_type": "code", "community": 1} ], "links": [ {"source": "1", "target": "0", "relation": "uses", "confidence": "EXTRACTED", "weight": 0.9}, {"source": "0", "target": "2", "relation": "calls", "confidence": "INFERRED", "weight": 0.7} ] }</code></pre> </div> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p>ソースコード (<code>.kt</code>, <code>.java</code>) はローカルで tree-sitter によって解析されます,<strong>控訴不能のLLM</strong>. ドキュメントファイルのみ (<code>.adoc</code>, <code>.md</code>)必要とするLLMの呼び出し意味抽出のために。したがって`--update`Kotlin コードの編集はほぼ瞬時に完了します。</p> </div> </td> </tr> </table> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ステップ_2_gradle_プラグインは_knowledge_graph_を_plantuml_に変換します">ステップ 2 : Gradle プラグインは Knowledge Graph を PlantUML に変換します</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_パイプラインアーキテクチャ">パイプラインアーキテクチャ</h3> <div class="paragraph"> <p>プラグイン`com.cheroliv.plantuml`タスクを組み込む`generateKnowledgeGraphDiagram`変換する`graph.json`PlantUML図によって<strong>完全に決定論的</strong> :</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE participant "Gradle" as G participant "知識グラフ図生成タスク" as Task participant "KnowledgeGraphParser" as Parser participant "KnowledgeGraphRenderer" as Renderer participant "PlantumlService" as PS collections "graphify-out/graph.json" as JSON G -> Task : execute Task -> JSON : read Task -> Parser : parse(graph.json) Parser --> Task : KnowledgeGraph\n(noeuds + arêtes + communautés) Task -> Renderer : render(graph, filters) Renderer --> Task : code PlantUML\n(déterministe) Task -> PS : validateSyntax(plantumlCode) alt syntaxe valide Task -> PS : generateImage → .png else syntaxe invalide Task -> Task : save .puml avec warning end @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_内部コンポーネント">内部コンポーネント</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 50%;"> <col style="width: 50%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">コンポーネント</th> <th class="tableblock halign-left valign-top">役割</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>KnowledgeGraphParser</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">パース`graph.json`— サポートする3つの形式：graphify ネイティブ (<code>nodes</code>+<code>links</code>), レガシー (<code>communities</code>), flat. 数値IDsをラベルに解決する。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>KnowledgeGraphRenderer</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">決定的に変換する`KnowledgeGraph`PlantUMLコード。タイプ別にグループ化、パッケージ内のコミュニティ、自動凡例。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>GenerateKnowledgeGraphDiagramTask</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">パース → レンダリング → バリデーション → PNG をオーケストレーションするGradleタスク。Gradleプロパティで設定可能。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>kgmodels.kt</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">データモデル :`KnowledgeGraph`, <code>KnowledgeGraphNode</code>, <code>KnowledgeGraphEdge</code>, <code>KnowledgeGraphCommunity</code>, <code>EdgeType</code>.</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>PlantumlService</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">構文バリデーション + PNG レンダリング（プラグインのすべてのタスクで再利用）。</p></td> </tr> </tbody> </table> </div> <div class="sect2"> <h3 id="_レンダリングルール">レンダリングルール</h3> <div class="paragraph"> <p>レンダラーは決定的な視覚的規則を適用します：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 33.3333%;"> <col style="width: 33.3333%;"> <col style="width: 33.3334%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">エッジタイプ</th> <th class="tableblock halign-left valign-top">PlantUML記法</th> <th class="tableblock halign-left valign-top">意味</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">抽出された</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>-→</code>(実線, 黒)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ソースコードから抽出された関係 (確実性)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">推論された</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>..></code>(点線)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">LLMによる推定関係(信頼スコア)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">�曖昧</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>--x</code>(赤い点線)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">あいまいな関係（要確認）</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>コミュニティは自動カラーパレットを持つPlantUMLパッケージとしてレンダリングされます。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ステップ_3_日常での使用">ステップ 3: 日常での使用</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_完全な図">完全な図</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Générer le diagramme du Knowledge Graph complet ./gradlew generateKnowledgeGraphDiagram</code></pre> </div> </div> <div class="paragraph"> <p>出力：<code>diagrams/knowledge-graph/knowledge-graph-full.puml</code>+<code>.png</code></p> </div> </div> <div class="sect2"> <h3 id="_コミュニティでフィルタリング">コミュニティでフィルタリング</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Une seule communauté ./gradlew generateKnowledgeGraphDiagram \ -Pplantuml.kg.community=community_0 # Limiter le nombre de noeuds (lisibilité) ./gradlew generateKnowledgeGraphDiagram \ -Pplantuml.kg.community=community_0 \ -Pplantuml.kg.maxNodes=15</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_エッジの種類でフィルタリング">エッジの種類でフィルタリング</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Uniquement les relations certaines (EXTRACTED) ./gradlew generateKnowledgeGraphDiagram \ -Pplantuml.kg.edgeTypes=EXTRACTED # Relations certaines + inférées ./gradlew generateKnowledgeGraphDiagram \ -Pplantuml.kg.edgeTypes=EXTRACTED,INFERRED</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ノードのタイプと信頼度でフィルタリング">ノードのタイプと信頼度でフィルタリング</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Uniquement les classes de code ./gradlew generateKnowledgeGraphDiagram \ -Pplantuml.kg.nodeTypes=code # Seuil de confiance minimum (pour les INFERRED) ./gradlew generateKnowledgeGraphDiagram \ -Pplantuml.kg.minConfidence=0.7</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_カスタマイズされた出力ディレクトリ">カスタマイズされた出力ディレクトリ</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./gradlew generateKnowledgeGraphDiagram \ -Pplantuml.kg.outputDir=docs/architecture</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_プロパティの完全なリファレンス">プロパティの完全なリファレンス</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 33.3333%;"> <col style="width: 33.3333%;"> <col style="width: 33.3334%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">特性</th> <th class="tableblock halign-left valign-top">デフォルト</th> <th class="tableblock halign-left valign-top">説明</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>plantuml.kg.community</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">(すべて)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">名前でコミュニティをフィルタリングする（部分文字列一致）</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>plantuml.kg.edgeTypes</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><em>(すべて)</em></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">コンマで区切られたエッジの種類 :`EXTRACTED`, <code>INFERRED</code>, <code>AMBIGUOUS</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>plantuml.kg.minConfidence</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>0.0</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">エッジの最小信頼度しきい値</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>plantuml.kg.maxNodes</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><em>(無制限)</em></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">表示する最大のノード数</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>plantuml.kg.nodeTypes</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">(皆)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">カンマで区切られたノードの種類（例`class`, <code>code</code>)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>plantuml.kg.outputDir</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>diagrams/knowledge-graph</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ファイルの出力ディレクトリ`.puml` et <code>.png</code></p></td> </tr> </tbody> </table> </div> </div> </div> <div class="sect1"> <h2 id="_gradle_ワークフローにおける完全なパイプライン">Gradle ワークフローにおける完全なパイプライン</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_ワークフローの種類">ワークフローの種類</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam ActivityBackgroundColor #E8F4FD skinparam ActivityDiamondBackgroundColor #FFF3CD skinparam ActivityBorderColor #2C3E50 start partition "抽出" { :graphify . --no-viz; note right: Analyse le code source\ntree-sitter (local, pas de LLM) :graphify-out/graph.json; note right: Noeuds + arêtes\n+ communautés } partition "世代" { :./gradlew generateKnowledgeGraphDiagram; note right: Pipeline déterministe\nparse → render → validate → PNG if (Filtres actifs ?) then (Oui) :Appliquer filtres\n(community, edgeTypes,\nmaxNodes, nodeTypes); else (Non) :Diagramme complet; endif :diagrams/knowledge-graph/\nknowledge-graph-full.puml\nknowledge-graph-full.png; } partition "統合" { :git add diagrams/knowledge-graph/; :git commit; note right: Diagrammes versionnés\ntoujours à jour avec le code } stop @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_開発サイクルへの統合">開発サイクルへの統合</h3> <div class="paragraph"> <p>パイプラインは開発の重要な段階に自然に組み込まれます:</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE state "開発" as dev state "�抽出 グラフ化 . --no-viz" as extract state "生成 ./gradlew generateKnowledgeGraphDiagram" as generate state "Commit バージョン管理されたダイアグラム" as commit [*] --> dev dev --> extract : Code modifié extract --> generate : graph.json à jour generate --> commit : .puml + .png générés commit --> dev : Diagrammes dans le repo note right of extract Quasi instantané sur du code Kotlin (tree-sitter, pas de LLM) end note note right of generate Déterministe Pas de LLM Résultat reproductible end note @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_インクリメンタルアップデート">インクリメンタルアップデート</h3> <div class="paragraph"> <p>コードが変更されるとき、グラフ全体をゼロから再構築するわけではない：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Mise à jour incrémentale (fichiers modifiés uniquement) graphify . --update # Puis régénérer les diagrammes ./gradlew generateKnowledgeGraphDiagram</code></pre> </div> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p><code>--update`再抽出するのは変更されたファイルのみ (SHA256で検出された`graphify-out/cache/</code>). Kotlin のコードでは、tree-sitter がローカルで動作し LLM を呼び出さないため、ほぼ瞬時に完了します。</p> </div> </td> </tr> </table> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ドッグフーディングプラグインは自分自身をドキュメント化する">ドッグフーディング：プラグインは自分自身をドキュメント化する</h2> <div class="sectionbody"> <div class="paragraph"> <p>PlantUML プラグインは、プロンプトを図に変換します。さらに、自身の <em>propre</em> codebase の Knowledge Graph をドキュメント用の図にも変換できます。これは <em>dogfooding</em> です：プラグインは自身のサービスを利用します。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle package "通常のパイプライン\n(ユーザー → 図面)" as normal { [Fichier .prompt] as prompt [LlmService\n+ ApiKeyPool] as llm1 [ProcessPlantumlPromptsTask] as task1 [Diagramme PNG] as out1 prompt --> task1 task1 --> llm1 llm1 --> out1 } package "パイプラインナレッジグラフ\n(決定論的、LLMなし)" as kg { [graphify-out/graph.json] as kgjson [KnowledgeGraphParser] as parser [KnowledgeGraphRenderer] as renderer [PlantumlService] as ps [Diagramme PNG\n(documentation du plugin)] as out2 kgjson --> parser parser --> renderer renderer --> ps ps --> out2 } package "Pipeline Dogfooding (LLM → プラグインのドキュメント)" as dogfood { [GraphifyPromptAdapter] as gpa [Fichiers .prompt\nauto-générés] as auto_prompt [LlmService\n+ ApiKeyPool] as llm2 [ProcessPlantumlPromptsTask] as task2 [Diagramme PNG\n(documentation LLM)] as out3 kgjson --> gpa gpa --> auto_prompt auto_prompt --> task2 task2 --> llm2 llm2 --> out3 } note "同じ LlmService、同じ ApiKeyPool 同じ PlantumlService — 重複なし" as N @enduml</pre> </div> </div> <div class="paragraph"> <p>関連付けられた Gradle タスク :</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 33.3333%;"> <col style="width: 33.3333%;"> <col style="width: 33.3334%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">タスク</th> <th class="tableblock halign-left valign-top">LLM ?</th> <th class="tableblock halign-left valign-top">説明</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>generateKnowledgeGraphDiagram</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">変形`graph.json`PlantUML（決定論的）で</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>generateDiagramDocs</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">生成して`.prompt`グラフから、LLMを利用して（ドッグフーディングとして）処理します</p></td> </tr> </tbody> </table> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Documentation déterministe (rapide, pas de LLM) ./gradlew generateKnowledgeGraphDiagram # Documentation LLM (plus riche, consomme des tokens) ./gradlew generateDiagramDocs</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_なぜそれが決定的なのか_そしてそれが重要である理由">なぜそれが決定的なのか (そしてそれが重要である理由)</h2> <div class="sectionbody"> <div class="paragraph"> <p>パイプラインの重要点`generateKnowledgeGraphDiagram`:<strong>彼はどのLLMも呼び出さない</strong>. 変換`graph.json`→ PlantUML は純粋な関数。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle rectangle "決定論的パイプライン (generateKnowledgeGraphDiagram)" as det { [graph.json] as json [KnowledgeGraphParser] as parser [KnowledgeGraphRenderer] as renderer [PlantUML code] as puml json --> parser : parse parser --> renderer : KnowledgeGraph renderer --> puml : render (fonction pure) } rectangle "パイプライン LLM\n(processPlantumlPrompts)" as llm { [.prompt] as prompt [LlmService] as llmSvc [ChatModel] as model [PlantUML code] as puml2 prompt --> llmSvc llmSvc --> model : API call model --> puml2 : réponse non-déterministe } note bottom of det Même entrée → même sortie Pas de latence réseau Pas de coût en tokens Reproductible en CI end note note bottom of llm Même entrée → sortie variable Latence réseau (1-5s) Coût en tokens Nécessite une clave API end note @enduml</pre> </div> </div> <div class="paragraph"> <p>具体的な利点：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 50%;"> <col style="width: 50%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">有利</th> <th class="tableblock halign-left valign-top">インパクト</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">再現性</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">同じ`graph.json`→ 同じ図. まさに. 毎回。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ゼロコスト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">LLM の呼び出しがない = トークンがない = API の請求書がない</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ゼロレイテンシ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Parse + renderは約100msかかり、1～5秒ではありません。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">互換性のあるCI</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">APIキーは必要ありません。変動するLLM応答によるフレークなテストはありません。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">バージョン可能な</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Le <code>.puml`生成されたものはテキストです。それはできます。`diff</code>, PR のレビュアー, Git でバージョン管理する。</p></td> </tr> </tbody> </table> </div> </div> <div class="sect1"> <h2 id="_パイプライン自体の図">パイプライン自体の図</h2> <div class="sectionbody"> <div class="paragraph"> <p>ループを閉じるために、プラグインによって生成されるパイプライン図をここに示します：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE participant "開発者" as Dev participant "グレードル" as G participant "知識グラフダイアグラム生成タスク" as Task participant "知識グラフパーサー" as Parser participant "知識グラフレンダラー" as Renderer participant "プラントUMLサービス" as PS collections "graphify-out/graph.json" as JSON collections "diagrams/knowledge-graph/" as Out Dev -> G : ./gradlew generateKnowledgeGraphDiagram G -> Task : execute Task -> JSON : read Task -> Parser : parse(graph.json) Parser --> Task : KnowledgeGraph alt filtres actifs Task -> Task : appliquer filtres\n(community, edgeTypes, maxNodes…) end Task -> Renderer : render(graph, filters) Renderer --> Task : code PlantUML Task -> PS : validateSyntax() alt valide Task -> PS : generateImage() PS --> Out : .puml + .png else invalide Task -> Out : .puml (avec warning) end @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_プロジェクトガバナンスへの統合">プロジェクトガバナンスへの統合</h2> <div class="sectionbody"> <div class="paragraph"> <p>私たちのプロジェクトでは、このパイプラインはAIエージェントのEAGER/LAZYコンテキスト管理戦略に組み込まれています。Knowledge Graph は、手動のアーキテクチャドキュメントを構造化され、クエリ可能で、自動的に更新されるグラフに置き換えます。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle package "EAGER (いつも充電されている)" as eager { [PROMPT_REPRISE.adoc\n(contexte session)] as pr [INDEX.adoc\n(vue d'ensemble)] as idx [GRAPH_REPORT.adoc\n(~50 lignes)] as gr } package "LAZY — 戦略\n(オンデマンド)" as lazy_strat { [Méthodologies] as meth [Archives sessions] as sessions } package "LAZY — Graphify (ターゲットクエリ)" as lazy_graph { [graph.json] as gj [Queries\n(query/path/explain)] as queries } package "パイプライン PlantUML (自動生成)" as puml { [generateKnowledgeGraphDiagram] as kgTask [generateDiagramDocs] as ddTask [Diagrammes PNG] as diagrams } Agent --> eager : Lit en début de session Agent ..> lazy_strat : Charge si type détecté Agent ..> lazy_graph : Query si besoin structurel kgTask --> diagrams : Déterministe ddTask --> diagrams : Via LLM note right of gr Condensé du Knowledge Graph God nodes + communautés Remplace ECOSYSTEM_OVERVIEW (225 lignes → 50 lignes) end note @enduml</pre> </div> </div> <div class="paragraph"> <p>2つのシステムの結合は補完的です：</p> </div> <div class="ulist"> <ul> <li> <p><strong>戦略は、いつとどのようにを管理します</strong>— ガバナンス, ワークフロー, アーカイブ</p> </li> <li> <p><strong>Graphifyは、WHATとWHEREを管理します</strong>— コードの構造、関係、対象クエリ</p> </li> </ul> </div> <div class="paragraph"> <p><em><em>_ セッション戦略は管理する<strong>いつ</strong> et le <strong>どうやって</strong>(ガバナンス、ワークフロー、しきい値)、 Graphifyは管理する<strong>何</strong> et le <strong>どこ</strong>(コード構造, 関係, ターゲットクエリ). PlantUML パイプラインは<strong>何で</strong>(決定論的な図、バージョン管理された、常に最新の) </em>_</em></p> </div> </div> </div> <div class="sect1"> <h2 id="_準備_5分のチェックリスト">準備 : 5分のチェックリスト</h2> <div class="sectionbody"> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 33.3333%;"> <col style="width: 33.3333%;"> <col style="width: 33.3334%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">(No output, as there is no French text provided to translate)</th> <th class="tableblock halign-left valign-top">ステップ</th> <th class="tableblock halign-left valign-top">注文</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Graphifyをインストール</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>uv tool install graphifyy</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">除外を設定</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">作る`.graphifyignore`</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Knowledge Graphを抽出</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>graphify . --no-viz</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">図を生成</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>./gradlew generateKnowledgeGraphDiagram</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">結果をコミット</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>git add diagrams/knowledge-graph/</code></p></td> </tr> </tbody> </table> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Script complet en 5 commandes uv tool install graphifyy cat > .graphifyignore << 'EOF' *-context.yml *.env build/ .gradle/ EOF graphify . --no-viz ./gradlew generateKnowledgeGraphDiagram git add graphify-out/GRAPH_REPORT.adoc graphify-out/graph.json diagrams/knowledge-graph/</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_罠と軽減策">罠と軽減策</h2> <div class="sectionbody"> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 33.3333%;"> <col style="width: 33.3333%;"> <col style="width: 33.3334%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">�罠</th> <th class="tableblock halign-left valign-top">説明</th> <th class="tableblock halign-left valign-top">緩和</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">グラフが密集しすぎています</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">大きなプロジェクトは数百の読み取り不能なノードを生成する</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">使う`-Pplantuml.kg.maxNodes=30`そしてコミュニティでフィルタリング</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">広すぎる除外</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ファイルが多すぎます`.graphifyignore`グラフの値を減らす</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">まず、credentials と build を除くだけから始める</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">�矢印の方向</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">INFERREDエッジは曖昧な方向を持つことができる</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">フィルターする`-Pplantuml.kg.edgeTypes=EXTRACTED`確実な関係のみに</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">古いグラフ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">コードは変わりますが、グラフは再構築されません</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">使用する`graphify . --update`定期的に または git フック`graphify hook install`</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">更新されたコスト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">増分アップデートはほぼ無料です (tree-sitter local)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ドキュメントのみ (`.adoc`LLMのトークンを消費する</p></td> </tr> </tbody> </table> </div> </div> <div class="sect1"> <h2 id="_最終的に得られるもの">最終的に得られるもの</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE rectangle "前に" as avant { card "手書きの図表 常に時代遅れ 誰も更新しない" as av1 #FDEDEC } rectangle "後" as apres { card "自動生成された図 コードと常に最新 Gitでバージョン管理 決定論的かつ再現可能" as ap1 #E8F8E8 } avant --> apres : graphify . --no-viz\n+ ./gradlew generateKnowledgeGraphDiagram @enduml</pre> </div> </div> <div class="paragraph"> <p>具体的な利益：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 50%;"> <col style="width: 50%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">利益</th> <th class="tableblock halign-left valign-top">詳細</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">常に最新のドキュメンテーション</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">図は現在のコードを反映しており、手動スナップショットではありません。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">メンテナンスの手間ゼロ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�図面は各ビルドごとに再生成されます</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">技術的負債の削減</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�図を手動で維持する必要はありません。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">新しい人へのビジュアルコンテキスト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">新しい開発者は図を見てアーキテクチャを理解する。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">潜在的なファインチューニング</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ペア（サブグラフ → ダイアグラム）は AI のトレーニング例です。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">自動検証</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">`PlantumlService.validateSyntax()`生成された各図を確認します</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">素早いオンボーディング</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">5つのダイアグラム = アーキテクチャの完全なビュー</p></td> </tr> </tbody> </table> <div class="paragraph"> <p><em><em>_ なぜ(_pourquoi</em>)を持つ人は、すべての(<em>comment</em>)に耐えることができる。 </em>__</p> </div> <div class="paragraph"> <p><em>pourquoi</em> : 常に最新の図。 <em>comment</em> : Gradle パイプライン内の2つのコマンド。</p> </div> </div> </div> <div class="sect1"> <h2 id="_リンク">リンク</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="https://github.com/nicholasgasior/graphify">GitHub上のGraphify</a></p> </li> <li> <p><a href="https://github.com/cheroliv/plantuml-gradle">PlantUML Gradle プラグイン</a></p> </li> <li> <p><a href="/blog/2026/0104_fg_command_super_tips_post.html">fgコマンドのスーパーヒント</a>— ターミナルワークフローに関する前の記事</p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2026/0104_fg_command_super_tips_post.html Sat, 18 Apr 2026 00:00:00 +0000 blog/2026/0104_fg_command_super_tips_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_問題端末がビジー">問題：端末がビジー</a></li> <li><a href="#_必須の3つのコマンド">必須の3つのコマンド</a> <ul class="sectlevel2"> <li><a href="#_ctrlz_一時停止_sigtstp">Ctrl+Z — 一時停止 (SIGTSTP)</a></li> <li><a href="#_fg_フォアグラウンドで復帰する">fg — フォアグラウンドで復帰する</a></li> <li><a href="#_bg_バックグラウンドで再開">bg — バックグラウンドで再開</a></li> <li><a href="#_jobs_シェルのジョブを一覧表示">jobs — シェルのジョブを一覧表示</a></li> </ul> </li> <li><a href="#_シナリオ_1_長いビルド">シナリオ 1: 長いビルド</a> <ul class="sectlevel2"> <li><a href="#_ステップバイステップ">ステップバイステップ</a></li> </ul> </li> <li><a href="#_シナリオ2_忘れられた編集者">シナリオ2 : 忘れられた編集者</a></li> <li><a href="#_シナリオ3_opencodeプロセスがサスペンド">シナリオ3: opencodeプロセスがサスペンド</a></li> <li><a href="#_シナリオ_4_複数のジョブを同時に管理">シナリオ 4 : 複数のジョブを同時に管理</a> <ul class="sectlevel2"> <li><a href="#_ジョブコマンドのサマリー">ジョブコマンドのサマリー</a></li> </ul> </li> <li><a href="#_fgbgctrlzctrlc_の違い">fg、bg、Ctrl+Z、Ctrl+C、& の違い</a></li> <li><a href="#_ジョブの完全なライフサイクル">ジョブの完全なライフサイクル</a></li> <li><a href="#_高度なヒント">高度なヒント</a> <ul class="sectlevel2"> <li><a href="#_fg_最新の仕事と交互に">fg 最新の仕事と交互に</a></li> <li><a href="#_ジョブをきれいに殺す">ジョブをきれいに殺す</a></li> <li><a href="#_désown_シェルから切り離す">désown : シェルから切り離す</a></li> <li><a href="#_長いプロセスに対して_nohup_と組み合わせる">長いプロセスに対して nohup と組み合わせる</a></li> </ul> </li> <li><a href="#_よくある落とし穴と間違い">よくある落とし穴と間違い</a> <ul class="sectlevel2"> <li><a href="#_ctrlzとctrlcを混同する">Ctrl+ZとCtrl+Cを混同する</a></li> <li><a href="#_ジョブはシェルにローカルです">ジョブはシェルにローカルです</a></li> <li><a href="#_ジョブはシェルの終了後に生き残らない">ジョブはシェルの終了後に生き残らない</a></li> <li><a href="#_対話型プロセスと_fg">対話型プロセスと fg</a></li> </ul> </li> <li><a href="#_サマリーダイアグラム">サマリーダイアグラム</a></li> <li><a href="#_なぜ_fg_が過小評価されているのか">なぜ fg が過小評価されているのか</a></li> <li><a href="#_技術的なメモリ_信号">技術的なメモリ: 信号</a></li> <li><a href="#_結論">結論</a></li> <li><a href="#_参照">参照</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 10 minutes</div> <p>あなたは始めます`./gradlew build`, ターミナルは3分間ブロックされており、待っている間に他のことをする必要がありますか？新しいタブを開く必要はありません。`Ctrl+Z`プロセスを一時停止する`fg`それはあなたが残した場所に正確に戻します。これは開発者の日常において最も過小評価されているUnixのヒントです。</p> </div> <div class="dlist"> <dl> <dt class="hdlist1">目次</dt> <dd> <p>[]</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_問題端末がビジー">問題：端末がビジー</h2> <div class="sectionbody"> <div class="paragraph"> <p>すべての開発者はこの状況を経験したことがある：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ ./gradlew build > Building...</code></pre> </div> </div> <div class="paragraph"> <p>ターミナルがフリーズしています。もうコマンドを入力することはできません。そして、ファイルを確認して、起動する必要があります`git status`または、使用中のポートを確認する。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE actor Développeur as dev participant "ターミナル" as term participant "Gradle ( プロセス )" as gradle dev -> term : ./gradlew build term -> gradle : Lance le build gradle -> term : Occupe le terminal\n(pas de prompt) dev -> term : veut taper une commande term --> dev : ❌ Terminal bloqué note right of dev Le développeur est paralysé pendant toute la durée du build end note @enduml</pre> </div> </div> <div class="paragraph"> <p>ほとんどの開発者は新しいターミナルを開きます。しかし、もっとエレガントで速く、ネイティブなソリューションがあります：ジョブ管理です。</p> </div> </div> </div> <div class="sect1"> <h2 id="_必須の3つのコマンド">必須の3つのコマンド</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_ctrlz_一時停止_sigtstp">Ctrl+Z — 一時停止 (SIGTSTP)</h3> <div class="paragraph"> <p>`Ctrl+Z`信号を送る`SIGTSTP`フォアグラウンド プロセスに。 プロセスは<strong>中断された</strong>— 死んでいない — ターミナルはプロンプトを取り戻す。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ ./gradlew build > Building... ^Z [1]+ Stoppé ./gradlew build $</code></pre> </div> </div> <div class="paragraph"> <p>括弧の中の数`[1]`です<strong>ジョブ番号</strong>. Le `+`デフォルトのジョブを示します。</p> </div> </div> <div class="sect2"> <h3 id="_fg_フォアグラウンドで復帰する">fg — フォアグラウンドで復帰する</h3> <div class="paragraph"> <p>`fg`サスペンドされたジョブをフォアグラウンドに戻す。プロセスは、停止した場所から正確に再開される。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ fg ./gradlew build > Building... (reprend où il en était)</code></pre> </div> </div> <div class="paragraph"> <p>特定のジョブ番号：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ fg %2</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_bg_バックグラウンドで再開">bg — バックグラウンドで再開</h3> <div class="paragraph"> <p>`bg`端末をブロックせずにプロセスを再開します。長いビルドに最適です。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ bg [1]+ ./gradlew build & $</code></pre> </div> </div> <div class="paragraph"> <p>Le `&`終わりにあることは、プロセスがバックグラウンドで実行されていることを意味します。</p> </div> </div> <div class="sect2"> <h3 id="_jobs_シェルのジョブを一覧表示">jobs — シェルのジョブを一覧表示</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ jobs [1]- Stoppé vim README.md [2]+ En cours ./gradlew build</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultFontName sans-serif state "前景\n(ブロックされたターミナル)" as fg #LightCoral state "一時停止 (Ctrl+Z)" as stopped #LightYellow state "背景 (bg)" as bg_ #LightGreen [*] --> fg : Lance une commande fg --> stopped : Ctrl+Z\n(SIGTSTP) stopped --> fg : fg\nreprend en avant-plan stopped --> bg_ : bg\nreprend en arrière-plan bg_ --> fg : fg\nramène en avant-plan fg --> [*] : Commande terminée note right of stopped Le processus est figé mais _pas_ tué end note note left of bg_ Le terminal est libre le build continue end note @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_シナリオ_1_長いビルド">シナリオ 1: 長いビルド</h2> <div class="sectionbody"> <div class="paragraph"> <p>これは最も一般的な使用例です。Gradleのビルドを実行し、ターミナルがブロックされ、他のことをする必要があります。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE autonumber actor Développeur as dev participant "ターミナル" as term participant "Gradle" as gradle database "状態 プロセス" as state dev -> term : ./gradlew build term -> gradle : Lance le build gradle -> state : En cours (FG) dev -> term : Ctrl+Z term -> state : Suspendu (job [1]) term --> dev : Prompt libre $ dev -> term : git status term --> dev : working tree clean dev -> term : fg term -> state : Reprend (FG) gradle --> dev : Build réussi ✓ note right of state Le processus Gradle n'a jamais été tué Il reprend exactement où il s'était arrêté end note @enduml</pre> </div> </div> <div class="sect2"> <h3 id="_ステップバイステップ">ステップバイステップ</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ ./gradlew build > Building... ^Z [1]+ Stoppé ./gradlew build $ git status On branch main nothing to commit, working tree clean $ fg ./gradlew build > Building... BUILD SUCCESSFUL in 2m 34s</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_シナリオ2_忘れられた編集者">シナリオ2 : 忘れられた編集者</h2> <div class="sectionbody"> <div class="paragraph"> <p>あなたは…の中にいます`vim`, 他のファイルを確認する必要があります <em>sans</em> 終了する`vim`.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Dans vim, en mode commande : :shell $ cat /path/to/other/file.txt $ exit # Retour dans vim</code></pre> </div> </div> <div class="paragraph"> <p>しかし、それは重い。それに`Ctrl+Z`, それは即時です :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Dans vim, n'importe quel moment : Ctrl+Z [1]+ Stoppé vim README.md $ cat /path/to/other/file.txt # ... lire le fichier ... $ fg vim README.md # Retour exact là où on en était, curseur en place</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE autonumber actor Développeur as dev participant "vim" as vim participant "シェル" as shell dev -> vim : édition en cours dev -> vim : Ctrl+Z vim -> shell : Suspendu (job [1]) dev -> shell : cat autre_fichier.txt shell --> dev : contenu du fichier dev -> shell : fg shell -> vim : Reprend (job [1]) vim --> dev : Curseur exactement\nà la même position note right of vim vim restaure intégralement l'état : position du curseur, buffer, undo stack end note @enduml</pre> </div> </div> <div class="paragraph"> <p>(No output?) Actually we need to output something? The instruction: "Translate from fr to ja. …​ Output only the translated text". If there is no source text, then there is nothing to translate. So output nothing. We’ll output an empty line.</p> </div> <div class="paragraph"> <p></think></p> </div> <div class="paragraph"> <p>(Empty)<code>vim`その後、完全にその状態を復元します`fg</code>: カーソル位置, バッファ内容, 元に戻す履歴 — すべて保持されます。</p> </div> </div> </div> <div class="sect1"> <h2 id="_シナリオ3_opencodeプロセスがサスペンド">シナリオ3: opencodeプロセスがサスペンド</h2> <div class="sectionbody"> <div class="paragraph"> <p>これがこの記事を書くきっかけとなったシナリオです。あなたは使っています。<code>opencode</code>(コード上のLLMを操作するCLIツール),そしてプロセスは一時停止されています。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultFontName sans-serif skinparam componentStyle rectangle actor Développeur as dev participant "opcode (LLMエージェント)" as agent participant "シェル" as shell participant "git" as git dev -> agent : Session active agent -> agent : Tour de parole\ndu LLM en cours note over agent Ctrl+Z arrive en plein milieu d'une analyse de code end note dev -> agent : Ctrl+Z agent -> shell : Suspendu (job [1]) dev -> git : git diff git --> dev : changements visibles dev -> shell : fg shell -> agent : Reprend (job [1]) agent --> dev : Reprend exactement\nl'analyse en cours note right of agent Aucune perte de contexte Le LLM reprend sa réponse exactement où il en était end note @enduml</pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ opencode # ... session en cours, LLM analyse le code ... ^Z [1]+ Stoppé opencode $ git diff HEAD~1 # vérifier les changements récents $ fg opencode # Le LLM reprend là où il s'était arrêté</code></pre> </div> </div> <div class="paragraph"> <p>利点は二重です :</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>コンテキストの損失はありません</strong> : LLM セッション, 会話履歴, 開いているファイル — すべてが保持されます</p> </li> <li> <p><strong>再起動不要</strong>: opencode を再起動したり、コンテキストを再読み込みしたり、LLM に問題を再説明する必要はありません</p> </li> </ol> </div> </div> </div> <div class="sect1"> <h2 id="_シナリオ_4_複数のジョブを同時に管理">シナリオ 4 : 複数のジョブを同時に管理</h2> <div class="sectionbody"> <div class="paragraph"> <p><code>fg</code> et `bg`複数のプロセスが中断されているときに、特定のプロセスを対象とするジョブ番号を受け付けます。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ vim config.yml ^Z [1]+ Stoppé vim config.yml $ ./gradlew test ^Z [2]+ Stoppé ./gradlew test $ htop ^Z [3]+ Stoppé htop $ jobs [1] Stoppé vim config.yml [2]- Stoppé ./gradlew test [3]+ Stoppé htop $ fg %2 ./gradlew test # Le build reprend en avant-plan $ bg %3 [3] htop & # htop reprend en arrière-plan</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE rectangle "一時停止中のジョブ" as jobs #LightYellow { card "[1] vim config.yml" as j1 card "[2] ./gradlew テスト" as j2 card "[3] htop" as j3 } rectangle "アクション" as actions #LightGreen { card "fg %2\n→ 前景" as a1 card "bg %3\n→ 背景" as a2 card "fg %1 → 前景" as a3 } jobs --> actions : fg/bg + numéro de job actions --> j2 : Reprend actions --> j3 : En arrière-plan note bottom of jobs Chaque job conserve son état exact entre les suspend/resume end note @enduml</pre> </div> </div> <div class="sect2"> <h3 id="_ジョブコマンドのサマリー">ジョブコマンドのサマリー</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 20%;"> <col style="width: 40%;"> <col style="width: 40%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">注文</th> <th class="tableblock halign-left valign-top">�効果</th> <th class="tableblock halign-left valign-top">例</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>Ctrl+Z</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">フォアグラウンドプロセスを一時停止</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">送信の`SIGTSTP`</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>fg</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">フォアグラウンドでデフォルトのジョブを再開</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>fg</code> ou <code>fg %1</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>fg %n</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ジョブ n をフォアグラウンドで再開</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>fg %2</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>bg</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">バックグラウンドでデフォルトのジョブを再開します</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>bg</code> ou <code>bg %1</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>bg %n</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ジョブ n をバックグラウンドで再開</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>bg %2</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>jobs</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">現在のシェルのジョブをリスト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>jobs -l</code>(PID付き)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>kill %n</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ジョブ n を終える</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>kill %2</code></p></td> </tr> </tbody> </table> </div> </div> </div> <div class="sect1"> <h2 id="_fgbgctrlzctrlc_の違い">fg、bg、Ctrl+Z、Ctrl+C、& の違い</h2> <div class="sectionbody"> <div class="paragraph"> <p>多くの開発者はこれらのメカニズムを混同します。ここに決定的な説明があります。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultFontName sans-serif rectangle "**Ctrl+Z** SIGTSTP" as ctrlz #LightYellow { card "プロセスを一時停止します (まだメモリに残っています) fg/bg で利用可能" as c1 } rectangle "**Ctrl+C**\nSIGINT" as ctrlc #LightCoral { card "プロセスを殺す (戻ることはできません) すべての状態の喪失" as c2 } rectangle "**および **\n(背景)" as ampersand #LightGreen { card "直接起動して バックグラウンドで フリーのターミナルすぐに" as c3 } rectangle "**fg** (フォアグラウンド)" as fg_ #SkyBlue { card "ジョブを持ってきて フォアグラウンドで一時停止 ターミナルが使用中" as c4 } rectangle "**bg**\n(背景)" as bg_ #Lavender { card "ジョブを再開しろ バックグラウンドで一時停止中 空きターミナル" as c5 } ctrlz -right-> fg_ : fg pour reprendre ctrlz -right-> bg_ : bg pour continuer\nen arrière-plan ctrlc -right-> c2 : Pas de retour\nprocessus tué note bottom of ctrlz Le processus est **figé** mais **pas tué** end note note bottom of ampersand Alternative : lancer ./gradlew build & directement en arrière-plan end note @enduml</pre> </div> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 16.6666%;"> <col style="width: 33.3333%;"> <col style="width: 16.6666%;"> <col style="width: 33.3335%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">ショートカット/コマンド</th> <th class="tableblock halign-left valign-top">信号</th> <th class="tableblock halign-left valign-top">効果</th> <th class="tableblock halign-left valign-top">�戻る？</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>Ctrl+Z</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>SIGTSTP</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">プロセスを一時停止する（凍結、メモリ上）</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">はい :`fg` ou <code>bg</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>Ctrl+C</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>SIGINT</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">プロセスを終了させる (完了)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">いいえ : プロセスが破壊されました</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>Ctrl+\</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>SIGQUIT</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">プロセスを kill + コアダンプ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">いいえ: 破壊されたプロセス</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>commande &</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">—</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">バックグラウンドで直接起動</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">`fg`それを前面に出すために</p></td> </tr> </tbody> </table> <div class="admonitionblock tip"> <table> <tr> <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> `Ctrl+Z`です<strong>非破壊的</strong>. プロセスはそのまま固定され、メモリに保持されています。あなたはすぐに再開できますに`fg`これは <em>pause</em> であって、 <em>stop</em> ではありません。 </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_ジョブの完全なライフサイクル">ジョブの完全なライフサイクル</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultFontName sans-serif title シェルジョブの完全なライフサイクル state "存在しない" as none state "前景\n(ターミナルを占有します)" as foreground #LightCoral state "一時停止\n(Ctrl+Z / SIGTSTP)" as suspended #LightYellow state "背景 (bg または &)" as background #LightGreen state "完了\n(exit code 0)" as done #LightGray [*] --> none none --> foreground : tape une commande foreground --> suspended : Ctrl+Z foreground --> done : fin normale suspended --> foreground : fg suspended --> background : bg suspended --> done : kill %n background --> foreground : fg background --> done : fin normale\n(en arrière-plan) background --> suspended : Ctrl+Z\n(si fg puis Ctrl+Z) done --> [*] note right of suspended L'état suspendu est le pivot de tout le système de jobs end note @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_高度なヒント">高度なヒント</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_fg_最新の仕事と交互に">fg 最新の仕事と交互に</h3> <div class="paragraph"> <p><code>fg`引数なしでは、マークされたジョブが戻ります</code>+<code>(最新の)。 しかし、あなたはまた使用することもできます</code>%-`前のジョブを対象にする :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ vim file1.txt ^Z [1]+ Stoppé vim file1.txt $ vim file2.txt ^Z [2]+ Stoppé vim file2.txt $ fg # ramène job [2] (le plus récent) $ fg %- # ramène job [1] (le précédent)</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ジョブをきれいに殺す">ジョブをきれいに殺す</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ jobs [1]- Stoppé vim config.yml [2]+ Stoppé ./gradlew test $ kill %2 # envoie SIGTERM au job 2 $ kill -9 %1 # envoie SIGKILL au job 1 (force)</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_désown_シェルから切り離す">désown : シェルから切り離す</h3> <div class="paragraph"> <p><code>disown`シェルのジョブテーブルからジョブを削除します。プロセスは実行を継続しますが、再度呼び出すことはできません。`fg</code>:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ ./gradlew build & [1] 12345 $ disown %1 # Le processus continue mais n'est plus lié au shell # Ça survives à la fermeture du terminal</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_長いプロセスに対して_nohup_と組み合わせる">長いプロセスに対して nohup と組み合わせる</h3> <div class="paragraph"> <p>ターミナルが閉じられたときにプロセスが生き残るように：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ nohup ./gradlew build & [1] 12345 $ disown %1 # Le build continue même si vous fermez le terminal</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultFontName sans-serif rectangle "fg" as fg_ #SkyBlue { card "最新のジョブを戻す\n(+)" as f1 card "仕事を狙う 特定 : fg %n" as f2 card "交互 : fg %-%" as f3 } rectangle "殺す %n" as kill_ #LightCoral { card "SIGTERM (クリーン)" as k1 card "SIGKILL -9 (強制)" as k2 } rectangle "縁を切る" as disown #Lavender { card "シェルから切り離す (ログアウト後も生存する)" as d1 } rectangle "nohup + &" as nohup_ #LightGreen { card "免疫プロセス SIGHUPに対して (端末の終了に耐える 端末の)" as n1 } fg_ -right-> kill_ : si faut\nterminer kill_ -right-> disown_ : ou détacher nohup_ -left-> fg_ : fg ramène en\navant-plan note bottom of disown_ Après disown, fg ne peut plus ramener le job end note @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_よくある落とし穴と間違い">よくある落とし穴と間違い</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_ctrlzとctrlcを混同する">Ctrl+ZとCtrl+Cを混同する</h3> <div class="paragraph"> <p>これが最も頻繁な間違いです。`Ctrl+C`プロセスを殺す。`Ctrl+Z`それを一時停止します。もしあなたが押すと`Ctrl+C`反射的に、すべての状態が失われます — 開いているファイル、LLMセッション、進行中のビルド。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE rectangle "Ctrl+Z (SIGTSTP)" as z #LightGreen { card "メモリ上で凍結しているプロセス" as z1 card "fg はそれを無傷のまま連れ戻す" as z2 card "損失なし" as z3 } rectangle "Ctrl+C (SIGINT)" as c #LightCoral { card "プロセス終了" as c1 card "状態は永久に失われた" as c2 card "返品はできません" as c3 } note bottom of z Pause → Reprendre end note note bottom of c Kill → Perdu end note @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_ジョブはシェルにローカルです">ジョブはシェルにローカルです</h3> <div class="paragraph"> <p><code>jobs</code>, <code>fg</code> et `bg`ジョブは、それらを起動したシェル内でのみ機能します。新しいターミナルを開くと、他のジョブは表示されません。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Terminal 1 $ vim file.txt ^Z [1]+ Stoppé vim file.txt # Terminal 2 (nouveau) $ jobs # (rien — les jobs sont locaux au shell)</code></pre> </div> </div> <div class="paragraph"> <p>システム全体のプロセスを見るには、<code>ps</code> ou <code>htop</code>:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">ps aux | grep vim</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ジョブはシェルの終了後に生き残らない">ジョブはシェルの終了後に生き残らない</h3> <div class="paragraph"> <p>ターミナルを閉じると、一時停止またはバックグラウンドで実行中のすべてのジョブが破棄されます。プロセスが存続するようにするには、使ってください`nohup`+<code>disown</code>(Empty)</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ nohup ./gradlew build & [1] 12345 $ disown %1 # Fermer le terminal → le build continue</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_対話型プロセスと_fg">対話型プロセスと fg</h3> <div class="paragraph"> <p>一部のインタラクティブなプログラムはその後良くない状態になる`Ctrl+Z` + <code>fg</code>. 稀ですが、起こります：</p> </div> <div class="ulist"> <ul> <li> <p>シグナルを使用する一部のプログラムは（vim、htop、lessはうまく機能しています`Ctrl+Z`)</p> </li> <li> <p>長時間のネットワークプログラム (ssh、opencode) は通常、正常に取得できます</p> </li> <li> <p>ターミナル (ncurses) を変更するプログラムは、ときどきターミナルを予期しない状態に残すことがあります</p> </li> </ul> </div> <div class="paragraph"> <p>端末が破損した後の`fg`, 入力して :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">reset</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_サマリーダイアグラム">サマリーダイアグラム</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultFontName sans-serif skinparam ArrowColor #444444 title "fg — すべてを変えるチップ" rectangle "問題" as problem #LightCoral { card "端末がブロックされました プロセスによって" as p1 card "開ける 一つの 新しい\nターミナル = 解決策 重い" as p2 } rectangle "**解答**" as solution #LightGreen { card "Ctrl+Z → 一時停止" as s1 card "fg → 再開する" as s2 card "bg → 背景" as s3 card "jobs → サスペンドされたものを表示" as s4 } rectangle "利点" as advantages #SkyBlue { card "コンテキストの損失なし" as a1 card "再起動なし" as a2 card "ターミナル1つで十分です" as a3 } problem -right-> solution : "Unixネイティブソリューション\n40年間" solution -right-> advantages : "結果" note bottom of advantages fg n'est pas un tips obscur C'est un mécanisme fondamental du shell Unix end note @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_なぜ_fg_が過小評価されているのか">なぜ fg が過小評価されているのか</h2> <div class="sectionbody"> <div class="paragraph"> <p>ほとんどの最新の開発者は発見する`fg`�遅れたり、あるいは決して起こらないこともあります。 いくつかの理由：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>IDEはターミナルを隠す</strong>: VS Codeは統合ターミナルを提供しますが、複数のタブは`fg`表面的には必要性が低い</p> </li> <li> <p><strong>グラフィカルツールは CLI を置き換える</strong>ファイルマネージャー、システムモニター、グラフィカルGitクライアント</p> </li> <li> <p><strong>tmux と screen</strong>: これらのマルチプレクサは同じ問題を異なる方法で解決しますが`fg`よりシンプルで常に利用可能です</p> </li> </ol> </div> <div class="paragraph"> <p>しかし、`fg`は：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>普遍的</strong>: POSIXシェルすべてに存在する (bash, zsh, fish…​)</p> </li> <li> <p><strong>依存性のない</strong>: tmuxまたはscreenをインストールする必要はありません</p> </li> <li> <p><strong>スナップショット</strong>: 2回の打撃 (<code>Ctrl+Z`それから`fg</code>) 一時停止および再開する</p> </li> <li> <p><strong>コンテキスト保存者</strong>: プロセスの状態は無傷です</p> </li> </ol> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultFontName sans-serif rectangle "なぜ fg は 過小評価されているのでしょうか？" as why #LightCoral { card "ターミナル付きIDE マルチタブ" as w1 card "グラフィカルツール CLIを置き換える" as w2 card "tmux/screen 問題を解決します あるいは" as w3 } rectangle "なぜ fg は 優れているのでしょうか？" as superior #LightGreen { card "汎用的 : bash,\nzsh, fish, sh..." as s1 card "依存なし：\nインストール不要" as s2 card "2つのキー操作：\nCtrl+Z と fg" as s3 card "保持されたコンテキスト： 状態損失ゼロ" as s4 } why -right-> superior : "シンプルさ いつも勝つ" @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_技術的なメモリ_信号">技術的なメモリ: 信号</h2> <div class="sectionbody"> <div class="paragraph"> <p>興味のある方へ、関与している信号は以下の通り：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 14.2857%;"> <col style="width: 28.5714%;"> <col style="width: 28.5714%;"> <col style="width: 28.5715%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">信号</th> <th class="tableblock halign-left valign-top">名前</th> <th class="tableblock halign-left valign-top">送信者</th> <th class="tableblock halign-left valign-top">�効果</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>SIGINT</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>Ctrl+C</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">中断 — プロセスを終了します</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>SIGQUIT</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>Ctrl+\</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">コアダンプを伴って終了</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">18</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>SIGTSTP</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>Ctrl+Z</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">対話的な停止 — プロセスを一時停止</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">19</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>SIGCONT</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>fg</code>/<code>bg</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">続ける — 一時停止されたプロセスを再開する</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">15</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>SIGTERM</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>kill %n</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">正常な終了</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">9</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>SIGKILL</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>kill -9 %n</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">強制終了 （インターセプト不可能）</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>完全なフロー :</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultFontName sans-serif participant "ユーザー" as user participant "シェル" as shell participant "プロセス" as proc user -> shell : Ctrl+Z shell -> proc : SIGTSTP (signal 18) note right of proc : Processus figé\nen mémoire user -> shell : fg shell -> proc : SIGCONT (signal 19) note right of proc : Processus reprend\nen avant-plan user -> shell : bg shell -> proc : SIGCONT (signal 19) note right of proc : Processus reprend\nen arrière-plan user -> shell : Ctrl+C shell -> proc : SIGINT (signal 2) note right of proc : Processus terminé\nétat perdu @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>`fg`これは obscure tips ではない — Unix シェルの基本的なメカニズムで、1970 年代から利用可能です。ほとんどの開発者がこれを無視するのは、私たちの時代の症状です：IDE とマルチプレクサーが私たちを基本から遠ざけている。</p> </div> <div class="paragraph"> <p>しかし、SSHサーバーにいるとき、ミニマルなターミナルで、あるいは単純に使っているときでも`opencode`そしてLLMはまさに作業中です —<code>Ctrl+Z</code>, <code>fg</code>, <code>bg</code>, `jobs`彼らはあなたの親友です。</p> </div> <div class="paragraph"> <p><em><em>_ Ctrl+Zで一時停止、fgで再開。これはターミナルの一時停止・再生です。 </em>_</em></p> </div> </div> </div> <div class="sect1"> <h2 id="_参照">参照</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><code>man bash</code>— セクション JOB CONTROL</p> </li> <li> <p><code>man signal</code>— POSIXシグナルのリスト</p> </li> <li> <p><a href="https://www.gnu.org/software/bash/manual/bash.html#Job-Control">Bash リファレンスマニュアル — ジョブコントロール</a></p> </li> <li> <p><a href="https://man7.org/linux/man-pages/man7/signal.7.html">man 7 signal — Linux のシグナル</a></p> </li> <li> <p><a href="https://tldp.org/LDP/abs/html/x312743.htm">高度なBashスクリプティングガイド — ジョブ制御</a></p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2026/0103_vscode_local_install_custom_fonts_post.html Fri, 17 Apr 2026 00:00:00 +0000 blog/2026/0103_vscode_local_install_custom_fonts_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_パスの概要">パスの概要</a></li> <li><a href="#_なぜvs_codeはホームに">なぜ：VS Codeはホームに</a> <ul class="sectlevel2"> <li><a href="#_システムのインストールの問題">システムのインストールの問題</a></li> <li><a href="#_解決策ローカルインストール">解決策：ローカルインストール</a></li> <li><a href="#_具体的なメリット">具体的なメリット</a></li> </ul> </li> <li><a href="#_メインメニューのフォントをカスタマイズ">メインメニューのフォントをカスタマイズ</a> <ul class="sectlevel2"> <li><a href="#_事実">事実</a></li> <li><a href="#_技術_cssパッチ_直接">技術 ： CSSパッチ 直接</a></li> <li><a href="#_整合性警告を削除">整合性警告を削除</a></li> </ul> </li> <li><a href="#_エクスプローラーウィンドウのフォントをカスタマイズ_闘い">エクスプローラーウィンドウのフォントをカスタマイズ — 闘い</a> <ul class="sectlevel2"> <li><a href="#_試み_1_存在しないパラメータ">試み 1 : 存在しないパラメータ</a></li> <li><a href="#_試み2拡張機能_カスタム_css_と_js_ローダー">試み2：拡張機能 カスタム CSS と JS ローダー</a></li> <li><a href="#_罠拡張機能を毎回有効にしなければならない">�罠：拡張機能を毎回有効にしなければならない</a></li> <li><a href="#_試み_3_線が重なる">試み 3 : 線が重なる</a></li> <li><a href="#_解決策zoom_を親コンテナに">解決策：<code>zoom</code> を親コンテナに</a></li> <li><a href="#_セレクターのまとめと機能するもの">セレクターのまとめと機能するもの</a></li> </ul> </li> <li><a href="#_自動更新スクリプト">自動更新スクリプト</a> <ul class="sectlevel2"> <li><a href="#_問題">問題</a></li> <li><a href="#_スクリプト_vscode_update_sh">スクリプト `vscode-update.sh</a></li> </ul> </li> <li><a href="#_関連ファイル_概要">関連ファイル — 概要</a></li> <li><a href="#_学んだ教訓">学んだ教訓</a> <ul class="sectlevel2"> <li><a href="#_ホームへのインストールはすべてを解放する">ホームへのインストールはすべてを解放する</a></li> <li><a href="#_zoom_font_size_リストコンポーネントのために">zoom` > <code>font-size</code> リストコンポーネントのために</a></li> <li><a href="#_カスタム_css_拡張機能は明示的なアクティベーションを必要とします">カスタム CSS 拡張機能は明示的なアクティベーションを必要とします。</a></li> <li><a href="#_アップデートスクリプトは必須です">アップデートスクリプトは必須です</a></li> </ul> </li> <li><a href="#_クイックリファレンス">クイックリファレンス</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 8 minutes</div> <p>なぜ VS Code をインストールするのか`/opt`または経由で`apt`いつでもそれを自分のホームに置き、IDEを遊び場に変えることができ、決してタイプすることなく`sudo`?以下は、ローカルインストールの後、メニューとファイルエクスプローラーのフォントを拡大するための激しい闘いの物語です。</p> </div> <div class="dlist"> <dl> <dt class="hdlist1">癖</dt> <dd> <p>[]</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_パスの概要">パスの概要</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle actor Développeur as dev actor "opencode\n+ LLM" as agent package "ユーザーホーム (~)" #LightGreen { package "~/apps/" { component "VS Code (tarball)" as vscode #SkyBlue component "vscode-update.sh" as script #LightYellow } package "~/.config/Code/" { component "settings.json" as settings #Lavender } package "~/.vscode-custom-css/" { component "custom.css (ズーム: 1.25)" as customcss #Lavender } } cloud "code.visualstudio.com" as download dev --> vscode : Télécharge & installe dev --> script : Lance mise à jour script --> download : wget dernière version script --> vscode : Remplace + re-patch CSS agent --> settings : Écrit config agent --> customcss : Écrit zoom CSS agent --> vscode : Patch workbench CSS note right of vscode Installation dans le home = contrôle total sans sudo end note @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_なぜvs_codeはホームに">なぜ：VS Codeはホームに</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_システムのインストールの問題">システムのインストールの問題</h3> <div class="paragraph"> <p>VS Code が経由でインストール`apt`, <code>dnf`それから中</code>/opt`アプリケーションのファイルはroot権限で保護されます。 ネイティブCSSのあらゆる変更は、の`product.json`またはインストールフォルダーが必要です`sudo`。</p> </div> <div class="paragraph"> <p>しかし、使用するとき<strong>オープンコード</strong>(tool CLI そのコードでLLMを操作するため), エージェントは次のことができる必要があります：</p> </div> <div class="ulist"> <ul> <li> <p>設定ファイルに書き込む(<code>~/.config/Code/User/settings.json</code>) — それは、もうホームにある</p> </li> <li> <p>IDEのアセット（ワークベンチのCSS）を変更する`product.json`) 高度なカスタマイズのために — これは sudo なしではブロックされます</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_解決策ローカルインストール">解決策：ローカルインストール</h3> <div class="paragraph"> <p>公式のtarballアーカイブをダウンロードして、それを直接解凍するに`~/apps/`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">mkdir -p ~/apps cd ~/apps wget "https://code.visualstudio.com/sha/download?build=stable&os=linux-x64" -O vscode.tar.gz tar -xzf vscode.tar.gz rm vscode.tar.gz</code></pre> </div> </div> <div class="paragraph"> <p>バイナリはその後、<code>~/apps/VSCode-linux-x64/bin/code</code>。 なし`sudo`読む、編集する、または置き換えるために、どのファイルでも下では必要ありません`~/apps/VSCode-linux-x64/`。</p> </div> </div> <div class="sect2"> <h3 id="_具体的なメリット">具体的なメリット</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE rectangle "システムインストール (/opt, apt, dnf)" #LightCoral { card "VS Code の root プロパティ" { [CSS du workbench : sudo requis] [product.json : sudo requis] [Dossier d'install : non modifiable] } } rectangle "インストール ホーム\n(~/apps)" #LightGreen { card "VS Code ユーザーのプロパティ" { [CSS du workbench : libre] [product.json : libre] [Dossier d'install : libre] [Script update maison] } } "システムインストール (/opt, apt, dnf)" -right-> "インストール ホーム\n(~/apps)" : **Non, merci**\nJe prends le home note bottom of "インストール ホーム\n(~/apps)" L'agent opencode+LLM peut modifier les fichiers de l'IDE sans aucune élévation de privilèges end note @enduml</pre> </div> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 33.3333%;"> <col style="width: 66.6667%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">利点</th> <th class="tableblock halign-left valign-top">詳細</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">sudo なし</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">IDEのすべてのファイルはユーザーに属します</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">CSSの直接編集</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">パッチできます`workbench.desktop.main.css`特権昇格なし</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">家庭用アップデートスクリプト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">シンプルなシェルスクリプトが自動的にダウンロード、置換、再パッチを行います</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">隔離</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">システムのインストールは汚染されていない;ロールバック=フォルダーの削除</p></td> </tr> </tbody> </table> </div> </div> </div> <div class="sect1"> <h2 id="_メインメニューのフォントをカスタマイズ">メインメニューのフォントをカスタマイズ</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_事実">事実</h3> <div class="paragraph"> <p>メインメニュー(ファイル、編集、表示…​)およびドロップダウンのデフォルトフォントが小さすぎます。VS Code にはこれを変更する設定がありません。</p> </div> </div> <div class="sect2"> <h3 id="_技術_cssパッチ_直接">技術 ： CSSパッチ 直接</h3> <div class="paragraph"> <p>ファイルの最後に CSS を追加します`workbench.desktop.main.css` :</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE autonumber actor Développeur as dev participant "workbench.desktop\n.main.css" as css participant "product.json" as product participant "VSコード" as vscode == Patch CSS == dev -> css : Ajouter règles font-size\n(.menubar-menu-title, etc.) dev -> vscode : Redémarrer VS Code vscode -> vscode : Charge le CSS patché vscode --> dev : Menus et dropdowns en 23px/22px ✓ == Suppression warning == vscode --> dev : ⚠️ "インストールが破損しています" dev -> product : Supprimer clé "チェックサム"\n(python3 -c ...) dev -> vscode : Redémarrer VS Code vscode --> dev : Plus de warning ✓ note over css, product Deux fichiers dans ~/apps/ = modifiables sans sudo end note @enduml</pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">CSS_FILE="$HOME/apps/VSCode-linux-x64/resources/app/out/vs/workbench/workbench.desktop.main.css" cat >> "$CSS_FILE" << 'EOF' .menubar-menu-title{font-size:23px!important} .menubar>.menubar-menu-button{font-size:23px!important} .monaco-menu-option{font-size:22px!important;line-height:34px!important} .monaco-menu .action-label:not(.codicon){font-size:22px!important} .menubar-menu-items-holder .monaco-menu .action-item .action-label{font-size:22px!important} EOF</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_整合性警告を削除">整合性警告を削除</h3> <div class="paragraph"> <p>VS Codeは自身のファイルの変更を検知し、"Your installation is corrupt"というバナーを表示します。これを避けるため、チェックサムを削除します。<code>product.json</code> :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-python hljs" data-lang="python">import json product_json = "$HOME/apps/VSCode-linux-x64/resources/app/product.json" with open(product_json, 'r') as f: data = json.load(f) data.pop('checksums', None) with open(product_json, 'w') as f: json.dump(data, f, indent=2)</code></pre> </div> </div> <div class="paragraph"> <p>再起動後、警告は表示されなくなり、メニューもようやく読めるようになりました。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_エクスプローラーウィンドウのフォントをカスタマイズ_闘い">エクスプローラーウィンドウのフォントをカスタマイズ — 闘い</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_試み_1_存在しないパラメータ">試み 1 : 存在しないパラメータ</h3> <div class="paragraph"> <p>まずネイティブなパラメータを試す`workbench.tree.fontSize`中`settings.json` :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{ "workbench.tree.fontSize": 20 }</code></pre> </div> </div> <div class="paragraph"> <p>結果：<strong>�効果なし</strong>. この設定はVS Codeには存在しません。認識されない設定が無視されていることの証拠です。</p> </div> </div> <div class="sect2"> <h3 id="_試み2拡張機能_カスタム_css_と_js_ローダー">試み2：拡張機能 カスタム CSS と JS ローダー</h3> <div class="paragraph"> <p>拡張機能をインストールします`be5invis.vscode-custom-css` :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">~/apps/VSCode-linux-x64/bin/code --install-extension be5invis.vscode-custom-css</code></pre> </div> </div> <div class="paragraph"> <p>にCSSファイルを作成します`~/.vscode-custom-css/custom.css`エクスプローラーの要素を対象とするセレクタを使用して :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">.monaco-tree-rows .monaco-tree-row, .sidebar .monaco-list-row, .explorer-viewlet .monaco-list-row, .monaco-list-row .monaco-icon-label { font-size: 22px !important; line-height: 36px !important; }</code></pre> </div> </div> <div class="paragraph"> <p>そして、このファイルをsettingsで参照します：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{ "vscode_custom_css.imports": [ "file:///home/user/.vscode-custom-css/custom.css" ] }</code></pre> </div> </div> <div class="paragraph"> <p>結果：<strong>変更は適用されません</strong>.</p> </div> </div> <div class="sect2"> <h3 id="_罠拡張機能を毎回有効にしなければならない">�罠：拡張機能を毎回有効にしなければならない</h3> <div class="paragraph"> <p>拡張機能のドキュメントはこの重要な点についてほとんど言及していない：カスタムCSSを変更するたびに<strong>必ず</strong>パレットからコマンドを実行して :</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><code>Ctrl+Shift+P</code>→ タイプする<strong>カスタム CSS と JS を有効にする</strong></p> </li> <li> <p>VS Code は再起動を要求します → 受け入れる</p> </li> </ol> </div> <div class="paragraph"> <p>この手順がないと、CSS は IDE に絶対に注入されません。</p> </div> </div> <div class="sect2"> <h3 id="_試み_3_線が重なる">試み 3 : 線が重なる</h3> <div class="paragraph"> <p>同じでも`font-size: 22px` et <code>line-height: 36px</code>, 脚付き文字（g, p, f, b）は隣の行にはみ出します。追加しようとしています。<code>height</code> et <code>min-height</code>:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">.monaco-list-row { height: 36px !important; min-height: 36px !important; }</code></pre> </div> </div> <div class="paragraph"> <p>結果 :<strong>変更なし</strong>. VS Code は JavaScript で 行の高さ を 計算 し、CSS の 値 を 上書き します。</p> </div> </div> <div class="sect2"> <h3 id="_解決策zoom_を親コンテナに">解決策：<code>zoom</code> を親コンテナに</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE rectangle "試行1 存在しないパラメータ" #LightCoral { card "workbench.tree.fontSize" as t1 { [VS Code ignore le paramètre] } } rectangle "仮2 カスタムCSS+フォントサイズ" #LightYellow { card ".monaco-list-row { font-size: 22px }" as t2 { [Texte plus grand\nmais lignes superposées] } } rectangle "試行 3 font-size + line-height + height" #LightYellow { card "高さ: 36px !important" as t3 { [VS Code override\npar JavaScript] [Aucun effet] } } rectangle "ソリューション 親コンテナのズーム" #LightGreen { card ".monaco-list-rows { zoom: 1.25 }" as t4 { [Texte + espacement\nproportionnels] [Layout JS respecté] [✓ Résultat conforme] } } t1 -down-> t2 : Pas de paramètre ?\nOn essaie le CSS t2 -down-> t3 : Lignes superposées ?\nOn force la hauteur t3 -down-> t4 : Override JS ?\nOn utilise zoom @enduml</pre> </div> </div> <div class="paragraph"> <p>JavaScript のレイアウトに抵抗するのではなく、プロパティを使用します。`zoom`行のコンテナ上 :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">.explorer-viewlet .monaco-list-rows, .sidebar .monaco-list-rows { zoom: 1.25; }</code></pre> </div> </div> <div class="paragraph"> <p>`zoom`コンテナのレンダリングをテキストと間隔の両方を均一に拡大し、VS CodeのJavaScriptエンジンが計算したレイアウトを壊さずに済みます。係数1.25は、おおよそ13pxから16pxへの変更に相当します。</p> </div> <div class="paragraph"> <p>結果 :<strong>ファイル名がようやく読み取り可能になり、行が適切に間隔を開けて配置されています</strong>。</p> </div> </div> <div class="sect2"> <h3 id="_セレクターのまとめと機能するもの">セレクターのまとめと機能するもの</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 25%;"> <col style="width: 50%;"> <col style="width: 25%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">アプローチ</th> <th class="tableblock halign-left valign-top">CSS</th> <th class="tableblock halign-left valign-top">結果</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>font-size`上に</code>.monaco-list-row`</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>font-size: 22px !important</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">テキストは大きいですが、行が重複しています</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>line-height</code>+<code>height`の上に</code>.monaco-list-row`</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>line-height: 36px; height: 36px</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">効果なし (override JS)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>zoom`の上に</code>.monaco-list-rows`</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>zoom: 1.25</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">成功 — テキスト + 比例間隔</p></td> </tr> </tbody> </table> </div> </div> </div> <div class="sect1"> <h2 id="_自動更新スクリプト">自動更新スクリプト</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE autonumber actor "開発者 または cron" as dev participant "vscode-update.sh" as script participant "VSCode ターボール (code.visualstudio.com)" as remote participant "~/apps/\nVSCode-linux-x64" as local participant "~/apps/\nvscode-backup" as backup participant "ワークベンチ .desktop.main.css" as css participant "product.json" as product dev -> script : ./vscode-update.sh script -> local : Lire version courante script -> remote : wget dernière version script -> script : Comparer versions alt Version identique script --> dev : "すでに最新です！" else Nouvelle version script -> backup : Sauvegarder installation courante\n(horodatée) script -> local : rm -rf ancienne installation script -> local : mv nouvelle installation script -> css : Ajouter patch CSS\n(menubar 23px, dropdown 22px) script -> product : Supprimer checksums\n(python3) script --> dev : "アップデート完了 1.xx.yy → 1.zz.ww" end note @enduml</pre> </div> </div> <div class="sect2"> <h3 id="_問題">問題</h3> <div class="paragraph"> <p>VS Code がアップデートされると、インストール フォルダーを置き換えて そして<strong>すべてのCSSパッチを削除</strong>. 手動で変更を毎回再適用する必要があります。</p> </div> </div> <div class="sect2"> <h3 id="_スクリプト_vscode_update_sh">スクリプト `vscode-update.sh</h3> <div class="paragraph"> <p>作る`~/apps/vscode-update.sh` :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">#!/bin/bash set -e VSCODE_DIR="$HOME/apps/VSCode-linux-x64" BACKUP_DIR="$HOME/apps/vscode-backup" TEMP_DIR="/tmp/vscode-update" MENUBAR_FONT_SIZE="23px" DROPDOWN_FONT_SIZE="22px" echo "=== VS Code Local Updater ===" CURRENT_VERSION=$("$VSCODE_DIR/bin/code" --version 2>/dev/null | head -1) echo "Current version: $CURRENT_VERSION" echo "Downloading latest VS Code..." mkdir -p "$TEMP_DIR" wget -q "https://code.visualstudio.com/sha/download?build=stable&os=linux-x64" \ -O "$TEMP_DIR/vscode.tar.gz" echo "Extracting..." mkdir -p "$TEMP_DIR/extracted" tar -xzf "$TEMP_DIR/vscode.tar.gz" -C "$TEMP_DIR/extracted" NEW_VERSION=$("$TEMP_DIR/extracted/VSCode-linux-x64/bin/code" \ --version 2>/dev/null | head -1) echo "New version: $NEW_VERSION" if [ "$CURRENT_VERSION" = "$NEW_VERSION" ]; then echo "Already up to date!" rm -rf "$TEMP_DIR" exit 0 fi echo "Backing up current installation..." mkdir -p "$BACKUP_DIR" cp -r "$VSCODE_DIR" "$BACKUP_DIR/VSCode-linux-x64-$(date +%Y%m%d-%H%M%S)" echo "Updating..." rm -rf "$VSCODE_DIR" mv "$TEMP_DIR/extracted/VSCode-linux-x64" "$VSCODE_DIR" rm -rf "$TEMP_DIR" CSS_FILE="$VSCODE_DIR/resources/app/out/vs/workbench/workbench.desktop.main.css" echo "Re-applying custom CSS patch \ (menubar=${MENUBAR_FONT_SIZE}, dropdown=${DROPDOWN_FONT_SIZE})..." cat >> "$CSS_FILE" << CSSEOF .menubar-menu-title{font-size:${MENUBAR_FONT_SIZE}!important}\ .menubar>.menubar-menu-button{font-size:${MENUBAR_FONT_SIZE}!important}\ .monaco-menu-option{font-size:${DROPDOWN_FONT_SIZE}!important;\ line-height:34px!important}\ .monaco-menu .action-label:not(.codicon)\ {font-size:${DROPDOWN_FONT_SIZE}!important}\ .menubar-menu-items-holder .monaco-menu .action-item .action-label\ {font-size:${DROPDOWN_FONT_SIZE}!important} CSSEOF PRODUCT_JSON="$VSCODE_DIR/resources/app/product.json" if [ -f "$PRODUCT_JSON" ]; then echo "Removing checksums to prevent integrity warning..." python3 -c " import json with open('$PRODUCT_JSON','r') as f: data=json.load(f) data.pop('checksums', None) with open('$PRODUCT_JSON','w') as f: json.dump(data,f,indent=2) print('Done.') " fi echo "=== Update complete: $CURRENT_VERSION -> $NEW_VERSION ==="</code></pre> </div> </div> <div class="paragraph"> <p>スクリプト :</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>最新の安定版をダウンロード</p> </li> <li> <p>現在のバージョンと異なるか確認して</p> </li> <li> <p>現在のインストール（タイムスタンプ付き）を`~/apps/vscode-backup/`</p> </li> <li> <p>インストールフォルダを置き換える</p> </li> <li> <p><strong>再適用</strong>メインメニューのCSSパッチ</p> </li> <li> <p><strong>チェックサムを削除</strong> de `product.json`整合性の警告を避けるために</p> </li> </ol> </div> <div class="paragraph"> <p>注: Explorerペインのカスタマイズは、Custom CSS拡張機能とファイルを通じて`~/.vscode-custom-css/custom.css`彼らはインストールフォルダー外にいるため、アップデートでも生き残る。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_関連ファイル_概要">関連ファイル — 概要</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle rectangle "VS Code のインストール (~/apps/VSCode-linux-x64/)" #LightCoral { component "workbench.desktop .main.css" as css #LightCoral component "product.json" as product #LightCoral component "バイナリ bin/code" as binary #LightCoral } rectangle "ユーザー設定\n(~/.config/Code/)" #LightGreen { component "settings.json" as settings #LightGreen component "�拡張/" as extensions #LightGreen } rectangle "永続的なカスタマイズ (~/.vscode-custom-css/)" #SkyBlue { component "カスタムCSS (ズーム: 1.25)" as customcss #SkyBlue } rectangle "自動化 (~/apps/)" #LightYellow { component "vscode-update.sh" as script #LightYellow component "vscode-backup/" as backup #LightYellow } script ..> css : Re-patch après MAJ script ..> product : Supprime checksums\naprès MAJ settings --> customcss : Référence via\nvscode_custom_css.imports extensions ..> css : Custom CSS Loader\ninjecte custom.css note bottom of css **Ne survit pas** aux mises à jour Re-patché par le script end note note bottom of customcss **Survit** aux mises à jour Vit hors du dossier d'installation end note note bottom of settings **Survit** aux mises à jour Vit dans ~/.config/ end note @enduml</pre> </div> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 28.5714%;"> <col style="width: 42.8571%;"> <col style="width: 28.5715%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">道</th> <th class="tableblock halign-left valign-top">役割</th> <th class="tableblock halign-left valign-top">アップデートを生き残る？</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>~/apps/VSCode-linux-x64/</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">IDEのインストール</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">いいえ (置き換えられた)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>~/apps/VSCode-linux-x64/resources/app/out/vs/workbench/workbench.desktop.main.css</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">WorkbenchのCSS (メニュー, ドロップダウン)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">いいえ (スクリプトによって再パッチされた)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>~/apps/VSCode-linux-x64/resources/app/product.json</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">整合性チェックサム</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">いいえ (スクリプトによって再クリーニングされました)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>~/apps/vscode-update.sh</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">自動更新スクリプト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>~/.config/Code/User/settings.json</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ユーザー設定 (fontSize, カスタム CSS)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>~/.vscode-custom-css/custom.css</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Explorer用のカスタムCSS（ズーム）</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td> </tr> </tbody> </table> </div> </div> <div class="sect1"> <h2 id="_学んだ教訓">学んだ教訓</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam defaultFontName sans-serif skinparam ArrowColor #444444 rectangle "**ローカルインストール** ホーム内" as install #LightGreen { card "sudoを使わずに CSS/configを変更する" as i1 card "opencode+LLM できます すべてを変更" as i2 card "ロールバック = タイムスタンプ付きバックアップを復元する" as i3 } rectangle "**CSS カスタマイズ**\nズーム vs フォントサイズ" as css #LightYellow { card "ズーム > フォントサイズ コンポーネントリスト" as c1 card "Layout JS オーバーライド height/line-height" as c2 card "拡張機能 Custom CSS 有効化が必要 手動 (Ctrl+Shift+P)" as c3 } rectangle "**自動化** アップデートスクリプト" as auto #LightCoral { card "再パッチ CSS 各アップデート後" as a1 card "チェックサムを削除 product.json" as a2 card "タイムスタンプ付きバックアップ 置換前に" as a3 } install -right-> css : ensuite css -right-> auto : enfin note top of install Contrôle total sans élévation de privilèges end note note top of auto Sans script, chaque MAJ efface les patches CSS end note @enduml</pre> </div> </div> <div class="sect2"> <h3 id="_ホームへのインストールはすべてを解放する">ホームへのインストールはすべてを解放する</h3> <div class="paragraph"> <p>ローカルインストールの`~/apps`VS Code を完全に制御します :</p> </div> <div class="ulist"> <ul> <li> <p>なし`sudo`CSSまたは設定を変更するために</p> </li> <li> <p>opencode+LLMエージェントは、IDEの設定ファイルとアセットに書き込むことができます</p> </li> <li> <p>簡単なロールバック : タイムスタンプ付きバックアップを復元</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_zoom_font_size_リストコンポーネントのために">zoom` > <code>font-size</code> リストコンポーネントのために</h3> <div class="paragraph"> <p>VS Code は JavaScript を使って行の高さを制御します。変更`font-size`レイアウトエンジンが割り当てた高さに変更を加えることができないと、テキストがはみ出します。 プロパティ`zoom`親コンテナ上で全てを比例的に拡大し、この問題を回避します。</p> </div> </div> <div class="sect2"> <h3 id="_カスタム_css_拡張機能は明示的なアクティベーションを必要とします">カスタム CSS 拡張機能は明示的なアクティベーションを必要とします。</h3> <div class="paragraph"> <p>これは「set and forget」な設定ではありません。カスタム CSS ファイルの各変更については、コマンドパレットから「Enable Custom CSS and JS」を再実行する必要があります (<code>Ctrl+Shift+P</code>)</p> </div> </div> <div class="sect2"> <h3 id="_アップデートスクリプトは必須です">アップデートスクリプトは必須です</h3> <div class="paragraph"> <p>スクリプトがない場合、VS Codeの更新ごとにワークベンチのCSSパッチが削除されます。スクリプト`vscode-update.sh`ダウンロード、置換、再パッチ、およびチェックサムのクリーニングを自動化する。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_クイックリファレンス">クイックリファレンス</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>VS Code のダウンロード： <a href="https://code.visualstudio.com/Download" class="bare">https://code.visualstudio.com/Download</a></p> </li> <li> <p>�拡張機能 カスタム CSS と JS ローダー :`be5invis.vscode-custom-css`</p> </li> <li> <p>問題：VS Code がエクスプローラーのフォント用のネイティブ設定を要求していますhttps://github.com/microsoft/vscode/issues/149[github.com/microsoft/vscode#149]</p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2026/0102_migration_gradle_script_to_plugin_post.html Thu, 16 Apr 2026 00:00:00 +0000 blog/2026/0102_migration_gradle_script_to_plugin_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_背景と目的">背景と目的</a> <ul class="sectlevel2"> <li><a href="#_出発点">出発点</a></li> <li><a href="#_目的">目的</a></li> </ul> </li> <li><a href="#_最初の障害ruby_gems">最初の障害：`ruby { gems() }</a> <ul class="sectlevel2"> <li><a href="#_groovyのシンタックスシュガーが隠しているもの">Groovyのシンタックスシュガーが隠しているもの</a></li> <li><a href="#_メカニズムの分解">メカニズムの分解</a></li> </ul> </li> <li><a href="#_3部構成の解決策">3部構成の解決策</a> <ul class="sectlevel2"> <li><a href="#_パート_1_rubygems用のivyリポジトリ">パート 1: rubygems用のIvyリポジトリ</a></li> <li><a href="#_パート_2_asciidoctorgems_の依存関係">パート 2: asciidoctorGems の依存関係</a></li> <li><a href="#_パート3_settings_gradle_kts">パート3: settings.gradle.kts</a></li> </ul> </li> <li><a href="#_バイトコードによるapiのイントロスペクション">バイトコードによるAPIのイントロスペクション</a> <ul class="sectlevel2"> <li><a href="#_なぜ_javap">なぜ <code>javap</code> ?</a></li> <li><a href="#_タスクの階層">タスクの階層</a></li> <li><a href="#_forkoptionsの発見">forkOptions`の発見</a></li> <li><a href="#_javaforkoptionsのapi_grolifant">JavaForkOptionsのAPI (grolifant)</a></li> <li><a href="#_revealjs拡張">RevealJS拡張</a></li> </ul> </li> <li><a href="#_java_ツールチェーンの設定">Java ツールチェーンの設定</a> <ul class="sectlevel2"> <li><a href="#_javatoolchainserviceの問題">JavaToolchainServiceの問題</a></li> </ul> </li> <li><a href="#_docker自動検出">Docker自動検出</a> <ul class="sectlevel2"> <li><a href="#_文脈">文脈</a></li> <li><a href="#_戦略">戦略</a></li> </ul> </li> <li><a href="#_最終結果">最終結果</a> <ul class="sectlevel2"> <li><a href="#_消費者のビルドスクリプト">消費者のビルドスクリプト</a></li> <li><a href="#_settings_gradle_kts">settings.gradle.kts</a></li> </ul> </li> <li><a href="#_罠と解決策のまとめ">�罠と解決策のまとめ</a></li> <li><a href="#_調査方法javap_を使って不明な_api_を読む">調査方法：javap を使って不明な API を読む</a> <ul class="sectlevel2"> <li><a href="#_原則">原則</a></li> <li><a href="#_ステップ1gradleキャッシュ内のjarファイルを特定する">ステップ1：Gradleキャッシュ内のJARファイルを特定する</a></li> <li><a href="#_ステップ2_jarのクラスをリストする">ステップ2: jarのクラスをリストする</a></li> <li><a href="#_ステップ_3_クラスを検査する">ステップ 3 : クラスを検査する</a></li> <li><a href="#_ステップ4_階層を上がる">ステップ4: 階層を上がる</a></li> <li><a href="#_ステップ5_不明な型を追跡">ステップ5: 不明な型を追跡</a></li> <li><a href="#_ステップ6プロジェクトの拡張機能を確認する">ステップ6：プロジェクトの拡張機能を確認する</a></li> <li><a href="#_方法のまとめ">方法のまとめ</a></li> </ul> </li> <li><a href="#_次のステップ">次のステップ</a></li> </ul> </div> <div class="sect1"> <h2 id="_背景と目的">背景と目的</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_出発点">出発点</h3> <div class="paragraph"> <p>プロジェクト`slider-gradle`Gradleプラグインを介してAsciiDocファイルからReveal.jsプレゼンテーションを生成します`org.asciidoctor.jvm.revealjs`. 主要タスクの設定`asciidoctorRevealJs`ルートのビルドスクリプトに直接存在していた`build.gradle.kts`[space]</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">plugins { id("org.asciidoctor.jvm.revealjs") } apply<slides.SlidesPlugin>() project.tasks.getByName<AsciidoctorJRevealJSTask>(TASK_ASCIIDOCTOR_REVEALJS) { repositories { ruby { gems() } } revealjs { version = "3.1.0" templateGitHub { setOrganisation("hakimel") setRepository("reveal.js") setTag("3.9.1") } } revealjsOptions { // ... configuration complète } }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_目的">目的</h3> <div class="paragraph"> <p>この構成すべてを移動する`buildSrc/src/main/kotlin/slides/SlidesPlugin.kt`コンシューマーのbuildscriptが次のように簡略化されるように：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">apply<slides.SlidesPlugin>()</code></pre> </div> </div> <div class="paragraph"> <p>プラグインは完全に自立している必要があります: それは自身でプラグインの依存関係を適用し、リポジトリを設定し、Ruby の gems を管理します。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_最初の障害ruby_gems">最初の障害：`ruby { gems() }</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_groovyのシンタックスシュガーが隠しているもの">Groovyのシンタックスシュガーが隠しているもの</h3> <div class="paragraph"> <p>ライン`repositories { ruby { gems() } }`これはbuildscript実行コンテキストでのみ利用可能なGroovy DSL拡張です。buildSrcからアクセス可能な静的なKotlin APIとして存在しません。</p> </div> <div class="paragraph"> <p>それを呼び出そうとしてから`SlidesPlugin.kt`, コンパイルはすぐに失敗します。</p> </div> </div> <div class="sect2"> <h3 id="_メカニズムの分解">メカニズムの分解</h3> <div class="paragraph"> <p>Gradleキャッシュの分析後 (<code>~/.gradle/caches/modules-2/files-2.1/rubygems/</code>), ファイルの中で見つかる`ivy-3.1.0.xml`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><artifact type='gem' url='https://rubygems.org/gems/asciidoctor-revealjs-3.1.0.gem' /></code></pre> </div> </div> <div class="paragraph"> <p>`ruby { gems() }`実際に行っていた<strong>3つの異なる操作</strong>:</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>指しているIvyリポジトリを保存する`https://rubygems.org/gems/`</p> </li> <li> <p>グループを除外する`rubygems`Maven リポジトリで競合を避けるため</p> </li> <li> <p>ジェムを設定に保存`asciidoctorGems`JRubyがランタイムでそれをロードするように</p> </li> </ol> </div> <div class="paragraph"> <p>これらの三つの責任は、Kotlinで個別に再実装しなければなりません。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_3部構成の解決策">3部構成の解決策</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_パート_1_rubygems用のivyリポジトリ">パート 1: rubygems用のIvyリポジトリ</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">project.repositories.mavenCentral() { content { excludeGroup("rubygems") } } project.repositories.ivy { url = project.uri("https://rubygems.org/gems/") patternLayout { artifact("[module]-[revision].gem") } <i class="conum" data-value="1"></i><b>(1)</b> metadataSources { artifact() } content { includeGroup("rubygems") } }</code></pre> </div> </div> <div class="colist arabic"> <table> <tr> <td><i class="conum" data-value="1"></i><b>1</b></td> <td>拡張`.gem`ハードコーディングする必要がある。<code>[ext]`デフォルトで解決する</code>.jar`, これがエラーを引き起こす`Resource missing`.</td> </tr> </table> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> Ivy リポジトリは直接上に宣言されます`project.repositories`そしてブロックの中にない`repositories { }`このブロックのレシーバーではないから`RepositoryHandler`Gradle標準だが、grolifantというAPIは拡張機能と互換性がない`ivy`Kotlin DSL. </td> </tr> </table> </div> </div> <div class="sect2"> <h3 id="_パート_2_asciidoctorgems_の依存関係">パート 2: asciidoctorGems の依存関係</h3> <div class="paragraph"> <p>プラグイン`org.asciidoctor.jvm.gems`最初に適用する必要があります—これにより設定が作成されます`asciidoctorGems`とタスク`asciidoctorGemsPrepare`</think></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">project.plugins.apply("org.asciidoctor.jvm.gems") project.plugins.apply("org.asciidoctor.jvm.revealjs") <i class="conum" data-value="1"></i><b>(1)</b> project.dependencies { add("asciidoctorGems", "rubygems:asciidoctor-revealjs:3.1.0@gem") <i class="conum" data-value="2"></i><b>(2)</b> }</code></pre> </div> </div> <div class="paragraph"> <p>適用順序は重要です:`gems`前に`revealjs`. <2> 修飾語`@gem`依存関係に正しい拡張子を強制する。</p> </div> </div> <div class="sect2"> <h3 id="_パート3_settings_gradle_kts">パート3: settings.gradle.kts</h3> <div class="paragraph"> <p>`dependencyResolutionManagement`中に`settings.gradle.kts`プロジェクトが自身のリポジトリを宣言できるようにする必要があります :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Suppress("UnstableApiUsage") dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.PREFER_PROJECT) }</code></pre> </div> </div> <div class="paragraph"> <p>この行がなければ、Gradleはプラグインで宣言されたリポジトリを無視し、gemの解決が失敗します。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_バイトコードによるapiのイントロスペクション">バイトコードによるAPIのイントロスペクション</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_なぜ_javap">なぜ <code>javap</code> ?</h3> <div class="paragraph"> <p>プラグイン`asciidoctor-gradle-jvm-slides`バージョンです`4.0.0-alpha.1`. そのドキュメントは存在しないか不完全です。 唯一の信頼できるソースは、コンパイル済みクラスの直接検査です。</p> </div> </div> <div class="sect2"> <h3 id="_タスクの階層">タスクの階層</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">javap -p -classpath asciidoctor-gradle-jvm-slides-4.0.0-alpha.1.jar \ org.asciidoctor.gradle.jvm.slides.AsciidoctorJRevealJSTask</code></pre> </div> </div> <div class="paragraph"> <p>結果 :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">public class AsciidoctorJRevealJSTask extends org.asciidoctor.gradle.jvm.AbstractAsciidoctorTask implements org.asciidoctor.gradle.base.slides.SlidesToExportAware</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_forkoptionsの発見">forkOptions`の発見</h3> <div class="paragraph"> <p>�検査しながら`AbstractAsciidoctorTask`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">javap -p -classpath asciidoctor-gradle-jvm-4.0.0-alpha.1.jar \ org.asciidoctor.gradle.jvm.AbstractAsciidoctorTask | grep -i "fork\|exec\|jvm"</code></pre> </div> </div> <div class="paragraph"> <p>見つかります：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">final org.ysb33r.grolifant.api.v4.JavaForkOptions javaForkOptions; public void forkOptions(org.gradle.api.Action<org.ysb33r.grolifant.api.v4.JavaForkOptions>); public static final org.asciidoctor.gradle.base.process.ProcessMode JAVA_EXEC;</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_javaforkoptionsのapi_grolifant">JavaForkOptionsのAPI (grolifant)</h3> <div class="paragraph"> <p>`javaLauncher`このタスクには存在しません。 実際のAPIは`org.ysb33r.grolifant.api.v4.JavaForkOptions`公開 :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">public void executable(java.lang.Object); <i class="conum" data-value="1"></i><b>(1)</b> public void setExecutable(java.lang.Object);</code></pre> </div> </div> <div class="colist arabic"> <table> <tr> <td><i class="conum" data-value="1"></i><b>1</b></td> <td>方法`executable(Object)`代入を置き換える`executable = …​`コンパイルされない (`val`再割り当てすることはできません)。</td> </tr> </table> </div> </div> <div class="sect2"> <h3 id="_revealjs拡張">RevealJS拡張</h3> <div class="paragraph"> <p>`revealjs { }`タスクの方法ではなく、<strong>プロジェクトの拡張</strong> :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">javap -p -classpath asciidoctor-gradle-jvm-slides-4.0.0-alpha.1.jar \ org.asciidoctor.gradle.jvm.slides.RevealJSExtension</code></pre> </div> </div> <div class="paragraph"> <p>アクセスするには：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">project.extensions.getByType<RevealJSExtension>().apply { version = "3.1.0" templateGitHub { setOrganisation("hakimel") setRepository("reveal.js") setTag("3.9.1") } }</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_java_ツールチェーンの設定">Java ツールチェーンの設定</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_javatoolchainserviceの問題">JavaToolchainServiceの問題</h3> <div class="paragraph"> <p>`JavaToolchainService`プロジェクトの拡張ではありません。次の呼び出しは失敗します :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// ERREUR : Extension of type 'JavaToolchainService' does not exist project.extensions.getByType<JavaToolchainService>()</code></pre> </div> </div> <div class="paragraph"> <p>良いAPIは`serviceOf`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">import org.gradle.kotlin.dsl.support.serviceOf project.tasks.getByName<AsciidoctorJRevealJSTask>(TASK_ASCIIDOCTOR_REVEALJS) { setInProcess("JAVA_EXEC") forkOptions { executable( project.serviceOf<JavaToolchainService>() .launcherFor { languageVersion.set(JavaLanguageVersion.of(17)) vendor.set(JvmVendorSpec.ADOPTIUM) } .get() .executablePath .asFile .absolutePath ) } }</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_docker自動検出">Docker自動検出</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_文脈">文脈</h3> <div class="paragraph"> <p>Asciidoctor/JRuby プラグインは Java 17 が必要です。buildSrc における Kotlin 2.0.x は Java 25 をサポートしていません。(バージョン パーサーがクラッシュします。<code>"25.0.2"</code>)したがって、Gradle デーモンは Java 17 上で実行するか、または Docker を使用する必要があります。</p> </div> </div> <div class="sect2"> <h3 id="_戦略">戦略</h3> <div class="olist arabic"> <ol class="arabic"> <li> <p>Docker が利用可能 → コンテナを介した実行`eclipse-temurin:17`(デフォルトの動作)</p> </li> <li> <p>Docker がない + Java 17 → ローカル実行</p> </li> <li> <p>Dockerが不在 + Java > 17 → 明示的なエラー</p> </li> </ol> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val isDockerAvailable = try { Runtime.getRuntime().exec(arrayOf("docker", "info")).waitFor() == 0 } catch (e: Exception) { false } val javaVersion = JavaVersion.current().majorVersion.toInt() when { isDockerAvailable -> project.tasks.register<Exec>(TASK_ASCIIDOCTOR_REVEALJS) { group = GROUP_TASK_SLIDER description = "Slider settings and generation (via Docker)" dependsOn(TASK_CLEAN_SLIDES_BUILD) finalizedBy(TASK_DASHBOARD_SLIDES_BUILD) commandLine( "docker", "run", "--rm", "-v", "${project.rootDir.absolutePath}:/workspace", "-v", "${System.getProperty("user.home")}/.gradle:/root/.gradle", "-w", "/workspace", "eclipse-temurin:17", "./gradlew", TASK_ASCIIDOCTOR_REVEALJS ) workingDir = project.rootDir } javaVersion == 17 -> { project.repositories.mavenCentral() { content { excludeGroup("rubygems") } } project.repositories.ivy { url = project.uri("https://rubygems.org/gems/") patternLayout { artifact("[module]-[revision].gem") } metadataSources { artifact() } content { includeGroup("rubygems") } } project.extensions.getByType<RevealJSExtension>().apply { version = "3.1.0" templateGitHub { setOrganisation("hakimel") setRepository("reveal.js") setTag("3.9.1") } } project.tasks.getByName<AsciidoctorJRevealJSTask>(TASK_ASCIIDOCTOR_REVEALJS) { setInProcess("JAVA_EXEC") forkOptions { executable( project.serviceOf<JavaToolchainService>() .launcherFor { languageVersion.set(JavaLanguageVersion.of(17)) vendor.set(JvmVendorSpec.ADOPTIUM) } .get() .executablePath .asFile .absolutePath ) } // ... reste de la configuration } } else -> error( "Docker est requis pour exécuter $TASK_ASCIIDOCTOR_REVEALJS " + "avec Java $javaVersion. Installez Docker ou utilisez Java 17." ) }</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_最終結果">最終結果</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_消費者のビルドスクリプト">消費者のビルドスクリプト</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">apply<slides.SlidesPlugin>()</code></pre> </div> </div> <div class="paragraph"> <p>それだけです。 プラグインがすべての責任を負います。</p> </div> </div> <div class="sect2"> <h3 id="_settings_gradle_kts">settings.gradle.kts</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">pluginManagement { repositories { mavenLocal() gradlePluginPortal() } } plugins { id("org.gradle.toolchains.foojay-resolver-convention") version "0.8.0" } @Suppress("UnstableApiUsage") dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.PREFER_PROJECT) } rootProject.name = "slider-gradle"</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_罠と解決策のまとめ">�罠と解決策のまとめ</h2> <div class="sectionbody"> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 25%;"> <col style="width: 37.5%;"> <col style="width: 37.5%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">問題</th> <th class="tableblock halign-left valign-top">原因</th> <th class="tableblock halign-left valign-top">解決策</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">`ruby { gems() }`Kotlinでは利用できません</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Groovy DSL専用の拡張</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">3つの別々のメカニズム : repo Ivy + exclusion Maven +<code>asciidoctorGems</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Gradleは`.jar`代わりの`.gem`</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">`[ext]`解決するで`jar`デフォルト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ハードコーダー`.gem`Ivy パターン + 修飾子`@gem`</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>ivy { }`でコンパイルされない`repositories { }</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">コトリンDSLと互換性のないレシーバーグルリファント</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">直接呼び出し`project.repositories.ivy { }`</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">`javaLauncher`未解決</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">存在しないプロパティに`AsciidoctorJRevealJSTask`</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>setInProcess("JAVA_EXEC")</code>(Note: No output)<code>forkOptions { executable(…​) }</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">`executable = …​`コンパイルされません</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">財産`val`中に`JavaForkOptions`グロリファント</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">方法`executable(Object)`代わりに</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>JavaToolchainService`経由で見つからない`extensions</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">これは Gradle のサービスであり、拡張機能ではありません。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>project.serviceOf<JavaToolchainService>()</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">`revealjs { }`タスクでは未解決</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">プロジェクトの拡張、タスクの方法ではない</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>project.extensions.getByType<RevealJSExtension>()</code></p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Build は Java 25 でクラッシュします</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Kotlin 2.0.xは2桁のJavaバージョンをパースしません</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">自動Docker検出 + Java 17 フォールバック</p></td> </tr> </tbody> </table> </div> </div> <div class="sect1"> <h2 id="_調査方法javap_を使って不明な_api_を読む">調査方法：javap を使って不明な API を読む</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_原則">原則</h3> <div class="paragraph"> <p>ドキュメントが欠如しているか、または不完全な場合、バイトコードが真実のソースとなります。 <code>javap`はJDKの標準ツールで、ファイルをデコンパイルします。</code>.class`� 読みやすい Java のシグニチャー, ソースコードを必要としない。</p> </div> </div> <div class="sect2"> <h3 id="_ステップ1gradleキャッシュ内のjarファイルを特定する">ステップ1：Gradleキャッシュ内のJARファイルを特定する</h3> <div class="paragraph"> <p>グラドル ダウンロードする すべての依存関係 に`~/.gradle/caches/modules-2/files-2.1/`。 最初のステップは、検査したいクラスを含む jar ファイルを見つけることです：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">find ~/.gradle/caches -name "asciidoctor-gradle-jvm-slides*.jar" 2>/dev/null</code></pre> </div> </div> <div class="listingblock"> <div class="title">結果 :</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">/home/user/.gradle/caches/modules-2/files-2.1/org.asciidoctor/ asciidoctor-gradle-jvm-slides/4.0.0-alpha.1/.../ asciidoctor-gradle-jvm-slides-4.0.0-alpha.1.jar</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ステップ2_jarのクラスをリストする">ステップ2: jarのクラスをリストする</h3> <div class="paragraph"> <p>クラスを検査する前に、それがjar内に確かに存在することを確認します :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">jar tf asciidoctor-gradle-jvm-slides-4.0.0-alpha.1.jar | grep -i "RevealJS\|revealjs"</code></pre> </div> </div> <div class="paragraph"> <p>これはすべての利用可能なクラスを示します： <code>AsciidoctorJRevealJSTask</code>, <code>RevealJSExtension</code>, <code>RevealJSOptions</code>, など</p> </div> </div> <div class="sect2"> <h3 id="_ステップ_3_クラスを検査する">ステップ 3 : クラスを検査する</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">javap -p -classpath asciidoctor-gradle-jvm-slides-4.0.0-alpha.1.jar \ org.asciidoctor.gradle.jvm.slides.AsciidoctorJRevealJSTask</code></pre> </div> </div> <div class="paragraph"> <p>オプション`-p`すべてのメンバー、プライベートなものも含めて表示します。 結果はすぐにキー行を表示します：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">public class AsciidoctorJRevealJSTask extends org.asciidoctor.gradle.jvm.AbstractAsciidoctorTask</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ステップ4_階層を上がる">ステップ4: 階層を上がる</h3> <div class="paragraph"> <p>タスクは伸ばす`AbstractAsciidoctorTask`その後、それを検査します まずその jar を特定して：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">find ~/.gradle/caches -name "asciidoctor-gradle-jvm-[0-9]*.jar" 2>/dev/null javap -p -classpath asciidoctor-gradle-jvm-4.0.0-alpha.1.jar \ org.asciidoctor.gradle.jvm.AbstractAsciidoctorTask | grep -i "fork\|exec\|jvm\|java"</code></pre> </div> </div> <div class="paragraph"> <p>そこで見つける`forkOptions`, <code>JAVA_EXEC</code>, et <code>javaForkOptions</code> タイプの`org.ysb33r.grolifant.api.v4.JavaForkOptions`。</p> </div> </div> <div class="sect2"> <h3 id="_ステップ5_不明な型を追跡">ステップ5: 不明な型を追跡</h3> <div class="paragraph"> <p>`JavaForkOptions`これは不明なgrolifantクラスです。そのjarファイルを見つけます：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">find ~/.gradle/caches -name "grolifant*.jar" 2>/dev/null</code></pre> </div> </div> <div class="paragraph"> <p>次に、それを検査します：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">javap -p -classpath grolifant40-legacy-api-2.0.0-alpha.6.jar \ org.ysb33r.grolifant.api.v4.JavaForkOptions</code></pre> </div> </div> <div class="paragraph"> <p>そこにはある`executable(java.lang.Object)<code>— 呼び出すべき正しいメソッド, 対照的に`executable = …​`これはプロパティだからコンパイルできない`val</code>.</p> </div> </div> <div class="sect2"> <h3 id="_ステップ6プロジェクトの拡張機能を確認する">ステップ6：プロジェクトの拡張機能を確認する</h3> <div class="paragraph"> <p>ために`revealjs { }`, 質問は：これはタスクの方法ですか？ またはプロジェクトの拡張ですか？検査の`AsciidoctorJRevealJSTask` 方法を示さない`revealjs`. その後、検査します`RevealJSExtension` :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">javap -p -classpath asciidoctor-gradle-jvm-slides-4.0.0-alpha.1.jar \ org.asciidoctor.gradle.jvm.slides.RevealJSExtension | head -5</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">public class RevealJSExtension implements groovy.lang.GroovyObject { public static final java.lang.String NAME;</code></pre> </div> </div> <div class="paragraph"> <p>の存在`NAME`それがプロジェクトに登録された拡張機能であることを確認します。 経由でアクセス可能`project.extensions.getByType<RevealJSExtension>()`.</p> </div> </div> <div class="sect2"> <h3 id="_方法のまとめ">方法のまとめ</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 25%;"> <col style="width: 75%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">ステップ</th> <th class="tableblock halign-left valign-top">アクション</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>find ~/.gradle/caches -name "*.jar"</code>— jar を特定する</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>jar tf jar.jar | grep NomClasse</code>— クラスが存在することを確認する</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>javap -p -classpath jar.jar NomCompletClasse</code>— クラスを検査する</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">識別する`extends`そして階層を上がる</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">5</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">未知の型を自身のJAR内で追跡する</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">6</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">探す`NAME`プロジェクトの拡張を特定するために</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>このメソッドは、ドキュメント化されていない API を持つ任意の Gradle プラグインに適用されます。 または、アルファバージョンが既存のドキュメントに合わなくなった。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_次のステップ">次のステップ</h2> <div class="sectionbody"> <div class="paragraph"> <p>この buildSrc プラグインは、Gradle Plugin Portal または Maven Local に公開された独立したプロジェクトに抽出されます。消費者側の buildscript は次のようになります：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">plugins { id("slides") version "1.0.0" }</code></pre> </div> </div> <div class="paragraph"> <p>Et <code>settings.gradle.kts`最小限に抑えられ、参照なしで`foojay-resolver-convention</code>, JDKのプロビジョニングはプラグイン自身によって管理され、または前提条件としてドキュメント化されている。</p> </div> </div> </div> https://cheroliv.com/blog/2026/0101_jbake_portfolio_post.html Thu, 15 Jan 2026 00:00:00 +0000 blog/2026/0101_jbake_portfolio_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_建築的ビジョン">建築的ビジョン</a> <ul class="sectlevel2"> <li><a href="#_指導原理">指導原理</a></li> <li><a href="#_戦略的な選択_ポートフォリオ用のasciidoc">戦略的な選択 : ポートフォリオ用のAsciiDoc</a></li> <li><a href="#_データモデル">データモデル</a></li> </ul> </li> <li><a href="#_詳細なユースケース">詳細なユースケース</a> <ul class="sectlevel2"> <li><a href="#_uc1_ポートフォリオにアイテムを追加する">UC1 : ポートフォリオにアイテムを追加する</a> <ul class="sectlevel3"> <li><a href="#_定格フラックス">定格フラックス</a></li> <li><a href="#_作成するファイルのテンプレート">作成するファイルのテンプレート</a></li> <li><a href="#_検証ポイント">検証ポイント</a></li> </ul> </li> <li><a href="#_uc2_ポートフォリオから要素を削除">UC2 : ポートフォリオから要素を削除</a> <ul class="sectlevel3"> <li><a href="#_名義フラックス">名義フラックス</a></li> <li><a href="#_代替戦略アーカイブ">代替戦略:アーカイブ</a></li> <li><a href="#_リソースのクリーンアップ">リソースのクリーンアップ</a></li> </ul> </li> <li><a href="#_uc3_下書き非公開に設定">UC3 : 下書き（非公開）に設定</a> <ul class="sectlevel3"> <li><a href="#_定格フラックス_2">定格フラックス</a></li> <li><a href="#_可能な状態">可能な状態</a></li> <li><a href="#_典型的な使用例">典型的な使用例</a></li> </ul> </li> </ul> </li> <li><a href="#_テンプレーティングアーキテクチャ">テンプレーティングアーキテクチャ</a> <ul class="sectlevel2"> <li><a href="#_再利用可能なテンプレートの戦略">再利用可能なテンプレートの戦略</a></li> <li><a href="#_データ抽出パターン">データ抽出パターン</a></li> <li><a href="#_命名規則">命名規則</a></li> </ul> </li> <li><a href="#_公開ワークフロー">公開ワークフロー</a> <ul class="sectlevel2"> <li><a href="#_開発パイプライン">開発パイプライン</a></li> <li><a href="#_環境">環境</a></li> </ul> </li> <li><a href="#_拡張性">拡張性</a> <ul class="sectlevel2"> <li><a href="#_新しい属性の追加">新しい属性の追加</a></li> <li><a href="#_高度な分類">高度な分類</a></li> </ul> </li> <li><a href="#_ベストプラクティス">ベストプラクティス</a> <ul class="sectlevel2"> <li><a href="#_ファイルの整理">ファイルの整理</a></li> <li><a href="#_コンテンツ管理">コンテンツ管理</a></li> <li><a href="#_パフォーマンス">パフォーマンス</a></li> </ul> </li> <li><a href="#_結論">結論</a></li> </ul> </div> <div class="sect1"> <h2 id="_建築的ビジョン">建築的ビジョン</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_指導原理">指導原理</h3> <div class="paragraph"> <p>アーキテクチャは、*関心の分離*という原則に基づいています :</p> </div> <div class="ulist"> <ul> <li> <p><strong>Contenu</strong> : 構造化されたAsciiDocファイル（メタデータが豊富）</p> </li> <li> <p><strong>プレゼンテーション</strong> : テンプレート Thymeleaf 再利用可能</p> </li> <li> <p><strong>データ</strong> : JBake によって AsciiDoc の属性から自動抽出されたモデル</p> </li> <li> <p><strong>Style</strong> : ビジュアルの一貫性のための Bootstrap 5</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_戦略的な選択_ポートフォリオ用のasciidoc">戦略的な選択 : ポートフォリオ用のAsciiDoc</h3> <div class="paragraph"> <p>なぜ AsciiDoc ですか？</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 33.3333%;"> <col style="width: 66.6667%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">基準</th> <th class="tableblock halign-left valign-top">利点</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">整合性</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ブログ記事と同じフォーマット</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">メタデータ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">構造化および拡張可能な属性 (<code>project-*</code>)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">保守性</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">シンプルなテキスト編集、Gitでバージョン管理可能</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">�柔軟性</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�豊富なコンテンツ（表、コード、画像）を含むことがあります</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">テンプレーティング</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">JBakeは自動的にThymeleafの属性を抽出します</p></td> </tr> </tbody> </table> </div> <div class="sect2"> <h3 id="_データモデル">データモデル</h3> <div class="paragraph"> <p>各ポートフォリオプロジェクトはAsciiDocドキュメントです：</p> </div> <div class="ulist"> <ul> <li> <p><strong>ヘッダーのメタデータ</strong> : 構造化された情報 (クライアント, 期間, テクノロジー, など)</p> </li> <li> <p><strong>ドキュメント本文</strong> : ナラティブな説明, 課題, 解決策, 結果</p> </li> <li> <p><strong>カスタム属性</strong> : プレフィックス付き`project-*`自動抽出のために</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam handwritten false class ProjetAsciiDoc { +titre: String +jbake-type: "プロジェクト" +jbake-status: published|draft +jbake-date: Date +jbake-tags: List<String> -- +project-category: String +project-client: String +project-duration: String +project-role: String +project-thumbnail: String +project-gallery: List<String> +project-tech-stack: String +project-highlights: List<String> +project-demo-url: String +project-github-url: String -- +body: HTML (converti) } class JBakeEngine { +parse(asciidoc) +extractMetadata() +convertToHTML() } class ThymeleafTemplate { +portfolio.html +project.html +partials/project-card.html } class PortfolioPage { +published_projects: List +filtres: categories } ProjetAsciiDoc --> JBakeEngine : parse JBakeEngine --> ThymeleafTemplate : fournit données ThymeleafTemplate --> PortfolioPage : génère @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_詳細なユースケース">詳細なユースケース</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_uc1_ポートフォリオにアイテムを追加する">UC1 : ポートフォリオにアイテムを追加する</h3> <div class="sect3"> <h4 id="_定格フラックス">定格フラックス</h4> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE actor Développeur as dev participant "編集者 テキスト" as editor participant "ファイル AsciiDoc" as file participant "JBake\nエンジン" as jbake participant "サイト 静的" as site dev -> editor : Créer nouveau fichier activate editor editor -> file : portfolio/nouveau-projet.adoc activate file dev -> editor : Rédiger en-tête avec métadonnées\n(titre, type=project, status=published,\nattributs project-*) dev -> editor : Rédiger contenu narratif\n(contexte, défis, solutions) dev -> editor : Ajouter images dans assets/img/portfolio/ editor -> file : Sauvegarder deactivate editor dev -> jbake : Lancer build (jbake -b) activate jbake jbake -> file : Lire et parser jbake -> jbake : Extraire métadonnées jbake -> jbake : Convertir AsciiDoc → HTML jbake -> jbake : Appliquer template project.html jbake -> jbake : Ajouter à la liste portfolio.html jbake -> site : Générer pages statiques deactivate jbake dev -> site : Vérifier résultat activate site site --> dev : Afficher projet deactivate site @enduml</pre> </div> </div> </div> <div class="sect3"> <h4 id="_作成するファイルのテンプレート">作成するファイルのテンプレート</h4> <div class="paragraph"> <p>開発者は作成します`content/portfolio/nom-projet.adoc`標準化された構造：</p> </div> <div class="ulist"> <ul> <li> <p>すべての必須属性を備えたヘッダー</p> </li> <li> <p>標準化されたセクション (コンテキスト、課題、ソリューション、結果)</p> </li> <li> <p>画像の一貫した命名法</p> </li> </ul> </div> </div> <div class="sect3"> <h4 id="_検証ポイント">検証ポイント</h4> <div class="ulist"> <ul> <li> <p>必須属性は存在します (<code>jbake-type</code>, <code>jbake-status</code>, <code>project-thumbnail</code>)</p> </li> <li> <p>参照されている画像が存在する中に`assets/img/portfolio/`</p> </li> <li> <p>JBakeのビルドはエラーなく成功します</p> </li> <li> <p>プロジェクトがポートフォリオページに表示されます</p> </li> <li> <p>プロジェクトの個別ページが正しく表示されます</p> </li> </ul> </div> </div> </div> <div class="sect2"> <h3 id="_uc2_ポートフォリオから要素を削除">UC2 : ポートフォリオから要素を削除</h3> <div class="sect3"> <h4 id="_名義フラックス">名義フラックス</h4> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE actor Développeur as dev participant "システム ファイル" as fs participant "JBake エンジン" as jbake participant "サイト 静的" as site database "キャッシュ JBake" as cache dev -> fs : Supprimer portfolio/projet-ancien.adoc activate fs fs --> dev : Fichier supprimé deactivate fs dev -> fs : (Optionnel) Supprimer images associées\nassets/img/portfolio/projet-ancien-* activate fs fs --> dev : Images supprimées deactivate fs dev -> cache : Nettoyer cache JBake activate cache cache --> dev : Cache vidé deactivate cache dev -> jbake : Rebuild complet (jbake -b) activate jbake jbake -> jbake : Scanner content/portfolio/ jbake -> jbake : Projet absent → non généré jbake -> jbake : Régénérer portfolio.html\n(sans le projet supprimé) jbake -> site : Déployer nouveau build deactivate jbake dev -> site : Vérifier activate site site --> dev : Projet absent de la liste deactivate site @enduml</pre> </div> </div> </div> <div class="sect3"> <h4 id="_代替戦略アーカイブ">代替戦略:アーカイブ</h4> <div class="paragraph"> <p>完全に削除する代わりに、フォルダを作成することが可能です`content/portfolio/archive/`:</p> </div> <div class="ulist"> <ul> <li> <p>ファイルを削除する代わりに移動する</p> </li> <li> <p>簡単に復元できる</p> </li> <li> <p>Gitの履歴をもっと分かりやすく保つ</p> </li> </ul> </div> </div> <div class="sect3"> <h4 id="_リソースのクリーンアップ">リソースのクリーンアップ</h4> <div class="ulist"> <ul> <li> <p>�孤児画像を確認する中に`assets/img/portfolio/`</p> </li> <li> <p>他のプロジェクトで参照されていない画像を削除</p> </li> <li> <p>JBakeのキャッシュをクリアして、幽霊参照を避けてください。</p> </li> </ul> </div> </div> </div> <div class="sect2"> <h3 id="_uc3_下書き非公開に設定">UC3 : 下書き（非公開）に設定</h3> <div class="sect3"> <h4 id="_定格フラックス_2">定格フラックス</h4> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE actor Développeur as dev participant "ファイル\nAsciiDoc" as file participant "JBake\nエンジン" as jbake participant "サイト\n静的" as site dev -> file : Ouvrir portfolio/projet.adoc activate file dev -> file : Modifier attribut\n:jbake-status: published\n↓\n:jbake-status: draft file --> dev : Sauvegardé deactivate file dev -> jbake : Rebuild (jbake -b) activate jbake jbake -> file : Parser le fichier jbake -> jbake : Détecter status=draft jbake -> jbake : Exclure de published_projects jbake -> jbake : Ne pas créer page publique note right Le projet existe toujours mais n'est pas publié end note jbake -> site : Générer site (sans ce projet) deactivate jbake dev -> site : Vérifier portfolio activate site site --> dev : Projet absent de la liste publique deactivate site @enduml</pre> </div> </div> </div> <div class="sect3"> <h4 id="_可能な状態">可能な状態</h4> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE [*] --> Draft : Création initiale Draft --> Published : Validation et publication Published --> Draft : Retrait temporaire Draft --> Archived : Projet abandonné Published --> Archived : Projet obsolète Archived --> [*] : Suppression définitive Published --> Published : Mises à jour note right of Draft :jbake-status: draft Non visible publiquement Utile pour projets en cours end note note right of Published :jbake-status: published Visible sur le portfolio Indexé par JBake end note note right of Archived Déplacé dans archive/ ou jbake-status: archived Non publié mais conservé end note @enduml</pre> </div> </div> </div> <div class="sect3"> <h4 id="_典型的な使用例">典型的な使用例</h4> <div class="ulist"> <ul> <li> <p><strong>作成中のプロジェクト</strong> : ドラフトで作成し、準備ができたら公開する</p> </li> <li> <p><strong>Projet confidentiel temporairement</strong> : 顧客の合意が得られるまでドラフト状態に保つ</p> </li> <li> <p><strong>主要アップデート</strong> : ドラフトに切り替え、編集し、再公開</p> </li> <li> <p><strong>A/B testing</strong> : 下書きで複製し、テストし、最良のバージョンを公開する</p> </li> </ul> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_テンプレーティングアーキテクチャ">テンプレーティングアーキテクチャ</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_再利用可能なテンプレートの戦略">再利用可能なテンプレートの戦略</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle package "Thymeleaf テンプレート" { component [index.html] as index component [portfolio.html] as portfolio component [project.html] as project package "部分" { component [header.html] as header component [footer.html] as footer component [project-card.html] as card component [tech-badge.html] as badge component [gallery.html] as gallery } } package "JBakeデータ" { database "公開済みプロジェクト" as data database "コンテンツ (プロジェクト)" as content } index --> header index --> footer portfolio --> header portfolio --> footer portfolio --> card data --> portfolio : itération project --> header project --> footer project --> badge project --> gallery content --> project : projet individuel note right of card Fragment réutilisable pour afficher une carte de projet avec : - thumbnail - titre - tags - highlights end note @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_データ抽出パターン">データ抽出パターン</h3> <div class="paragraph"> <p>JBakeは、AsciiDocの属性をThymeleafでアクセス可能なプロパティに自動的に変換します。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE rectangle "ドキュメント AsciiDoc" { (":project-client: アクメ株式会社") as attr1 (":project-duration: 6か月") as attr2 (":project-tags: java, リアクト") as attr3 } rectangle "JBake モデル" { (content['project-client']) as prop1 (content['project-duration']) as prop2 (content.tags) as prop3 } rectangle "テンプレート Thymeleaf" { (th:text="${project['project-client']}") as tmpl1 (th:text="${project['project-duration']}") as tmpl2 (th:each="タグ : ${project.tags}") as tmpl3 } attr1 --> prop1 : parsing attr2 --> prop2 : parsing attr3 --> prop3 : parsing prop1 --> tmpl1 : binding prop2 --> tmpl2 : binding prop3 --> tmpl3 : binding @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_命名規則">命名規則</h3> <div class="ulist"> <ul> <li> <p><strong>プロジェクト属性</strong> : プレフィックス`project-*` (ex: <code>project-client</code>, <code>project-tech-stack</code>)</p> </li> <li> <p><strong>ファイル</strong> : kebab-case (例:`ecommerce-platform.adoc`)</p> </li> <li> <p><strong>Images</strong> : プロジェクト名プレフィックス（例：<code>ecommerce-platform-thumb.jpg</code>)</p> </li> <li> <p><strong>テンプレート</strong> : 機能的な名前 (例:`project-card.html`, <code>tech-badge.html</code>）</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_公開ワークフロー">公開ワークフロー</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_開発パイプライン">開発パイプライン</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam handwritten false class ProjetAsciiDoc { +titre: String +jbake-type: "プロジェクト" +jbake-status: published|draft +jbake-date: Date +jbake-tags: List<String> __ +project-category: String +project-client: String +project-duration: String +project-role: String +project-thumbnail: String +project-gallery: List<String> +project-tech-stack: String +project-highlights: List<String> +project-demo-url: String +project-github-url: String __ +body: HTML (converti) } class JBakeEngine { +parse(asciidoc) +extractMetadata() +convertToHTML() } class ThymeleafTemplate { +portfolio.html +project.html +partials/project-card.html } class PortfolioPage { +published_projects: List +filtres: categories } ProjetAsciiDoc --> JBakeEngine : parse JBakeEngine --> ThymeleafTemplate : fournit données ThymeleafTemplate --> PortfolioPage : génère @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_環境">環境</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 20%;"> <col style="width: 40%;"> <col style="width: 40%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">環境</th> <th class="tableblock halign-left valign-top">使用</th> <th class="tableblock halign-left valign-top">受け入れられたステータス</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ローカル</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">開発とプレビュー</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">下書き, 公開済み</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ステージング</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">本番前検証</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">publishedのみ</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">生産</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">公共サイト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">公開済みのみ</p></td> </tr> </tbody> </table> </div> </div> </div> <div class="sect1"> <h2 id="_拡張性">拡張性</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_新しい属性の追加">新しい属性の追加</h3> <div class="paragraph"> <p>データモデルを充実させるには、単純にプレフィックス付きの新しい属性を追加`project-*`:</p> </div> <div class="ulist"> <ul> <li> <p>`project-awards`賞と表彰</p> </li> <li> <p><code>project-testimonial</code>: クライアント見積もり</p> </li> <li> <p><code>project-team-size</code>: チームサイズ</p> </li> <li> <p><code>project-budget-range</code>: 予算範囲</p> </li> </ul> </div> <div class="paragraph"> <p>これらの属性は、JBakeエンジンを変更せずにテンプレート内で自動的に利用可能になります。</p> </div> </div> <div class="sect2"> <h3 id="_高度な分類">高度な分類</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE object Projet { project-category = "ウェブ" project-subcategory = "電子商取引" project-industry = "小売り" project-complexity = "高い" } object Taxonomie { categories : [web, mobile, data, devops] subcategories : Map<category, List> industries : [retail, finance, healthcare, ...] complexities : [low, medium, high] } Projet --> Taxonomie : classifié selon note right of Taxonomie Permet filtrage multi-critères dans le template portfolio.html via JavaScript ou côté serveur end note @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ベストプラクティス">ベストプラクティス</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_ファイルの整理">ファイルの整理</h3> <div class="ulist"> <ul> <li> <p><strong>1 ファイル = 1 プロジェクト</strong> : 複数のプロジェクトを混ぜないでください</p> </li> <li> <p><strong>専用フォルダ内の画像</strong><code>assets/img/portfolio/nom-projet/</code></p> </li> <li> <p><strong>一貫した命名規則</strong> : 検索と保守を容易にする</p> </li> <li> <p><strong>Versioning Git</strong> : 変更の完全な追跡</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_コンテンツ管理">コンテンツ管理</h3> <div class="ulist"> <ul> <li> <p><strong>デフォルトの下書きステータス</strong> : 公開するのは準備ができたときだけ</p> </li> <li> <p><strong>公開前レビュー</strong> : 品質と機密性の確認</p> </li> <li> <p><strong>完全なメタデータ</strong> : すべての関連フィールドを入力してください</p> </li> <li> <p><strong>豊かなナラティブコンテンツ</strong> : メタデータに限定しない</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_パフォーマンス">パフォーマンス</h3> <div class="ulist"> <ul> <li> <p><strong>画像を最適化</strong> : コミット前の圧縮</p> </li> <li> <p><strong>必要に応じたページネーション</strong> : 20プロジェクト以上の場合</p> </li> <li> <p><strong>Lazy loading</strong> : ギャラリーの画像は必要に応じて読み込まれます</p> </li> <li> <p><strong>ブラウザキャッシュ</strong> : アセット用の適切なヘッダー</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>このアーキテクチャは次のことを許可します :</p> </div> <div class="ulist"> <ul> <li> <p><strong>使いやすさ</strong> : プロジェクトを追加 = テキストファイルを作成</p> </li> <li> <p><strong>柔軟性</strong> : 新しい属性を通じて拡張可能</p> </li> <li> <p><strong>保守性</strong> : コンテンツとプレゼンテーションの分離</p> </li> <li> <p><strong>トレーサビリティ</strong> : Gitの完全なバージョン管理</p> </li> <li> <p><strong>自動化</strong> : ビルドとデプロイの継続的な可能性</p> </li> </ul> </div> <div class="paragraph"> <p>AsciiDocの選択は、サイトの他の部分との一貫性を保ちながら、プロフェッショナルなポートフォリオに必要なメタデータの豊かさを提供します。</p> </div> </div> </div> https://cheroliv.com/blog/pilot-batch/0100_jbake_supabase_springboot_hybride_post.html Wed, 14 Jan 2026 00:00:00 +0000 blog/pilot-batch/0100_jbake_supabase_springboot_hybride_post.html <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 12 minutes</div> <p>SupabaseのシンプルさとSpring Bootのパワーの間で選択するのではなく、両方を組み合わせてみませんか？それぞれの技術の長所を活かしたハイブリッドアーキテクチャをご紹介します。</p> </div> <div class="dlist"> <dl> <dt class="hdlist1">強迫性障害</dt> <dd> <p>[]</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_現代建築の偽りのジレンマ">現代建築の偽りのジレンマ</h2> <div class="sectionbody"> <div class="paragraph"> <p>静的フロントエンドを使ってモダンなアプリケーションを構築するとき、しばしば二者択一の選択に直面することになります：</p> </div> <div class="ulist"> <ul> <li> <p><strong>Backend-as-a-Serviceのソリューションにすべてを賭ける。</strong>(Supabase, Firebase) - シンプルだが制限がある</p> </li> <li> <p><strong>完全なバックエンドを構築する</strong>(Spring Boot, Node.js) - 強力だが複雑</p> </li> </ul> </div> <div class="paragraph"> <p>この選択は誤った二択です。ハイブリッドアーキテクチャは第三の道を提案します： <strong>各テクノロジーが得意とする場所で使用する</strong>。</p> </div> </div> </div> <div class="sect1"> <h2 id="_建築ビジョン">建�築ビジョン</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_伝統的なアーキテクチャ_モノリシック">伝統的なアーキテクチャ: モノリシック</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle package "伝統的建築" { actor Utilisateur as user component "フロントエンド" as frontend #LightBlue component "モノリシックバックエンド" as backend #LightCoral { [Authentification] [CRUD] [Logique Métier] [Jobs] [APIs Tierces] } database "データベース" as db #LightGray user --> frontend frontend --> backend : Toutes les requêtes backend --> db } note right of backend Tout passe par le backend même les opérations simples ⚠️ Point de congestion unique ⚠️ Complexité dès le départ ⚠️ Couplage fort end note @enduml</pre> </div> </div> <div class="paragraph"> <p>このアプローチでは、最も単純な操作（記事の読み込み、コメントの作成）であっても、すべてバックエンドを経由する必要があります。最初の日から複雑さのコストを支払うことになります。</p> </div> </div> <div class="sect2"> <h3 id="_baasアーキテクチャ全代表者">BaaSアーキテクチャ：全代表者</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle package "アーキテクチャ BaaS ピュア" { actor Utilisateur as user component "フロントエンド" as frontend #LightBlue cloud "Supabase / Firebase" as baas #LightGreen { [Auth] [Database] [Storage] [Edge Functions] } user --> frontend frontend --> baas : Toutes les opérations } note right of baas Développement rapide Pas de serveur à gérer ⚠️ Limité pour logique complexe ⚠️ Vendor lock-in ⚠️ Edge Functions contraintes end note @enduml</pre> </div> </div> <div class="paragraph"> <p>逆に、すべてをBaaSに委ねるのは最初は魅力的ですが、ビジネスロジックが複雑になるとすぐに限界が露呈します。</p> </div> </div> <div class="sect2"> <h3 id="_ハイブリッドアーキテクチャ_責任の分離">ハイブリッドアーキテクチャ: 責任の分離</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle actor Utilisateur as user #LightBlue package "フロントエンド層" { component "JBakeの静的サイト" as frontend #SkyBlue } package "シンプルな層 (Supabase)" #LightGreen { component "認証" as auth component "CRUD基本" as crud component "ファイル ストレージ" as storage component "リアルタイム" as realtime } package "ビジネスレイヤー (Spring Boot)" #Coral { component "複雑なロジック" as logic component "オーケストレーション" as orchestration component "計画されたジョブ" as jobs component "統合" as integrations } database "PostgreSQL 共有" as db #LightGray user --> frontend frontend --> auth : OAuth2, JWT frontend --> crud : Articles, Profils frontend --> storage : Images, Fichiers frontend --> realtime : Notifications frontend --> logic : Calculs, Rapports frontend --> orchestration : Workflows logic --> integrations : Stripe, APIs orchestration --> db jobs --> db crud --> db auth --> db note bottom of db **Une seule source de vérité** Partagée entre Supabase et Spring Boot end note note right of auth **Gratuit jusqu'à 50k users** Configuration en quelques clics OAuth2 multi-providers end note note right of logic **Activé seulement si nécessaire** Kotlin + Coroutines Transactions complexes end note @enduml</pre> </div> </div> <div class="paragraph"> <p>ハイブリッドアーキテクチャは、複雑さと操作の性質に応じて、責任をはっきりと分離します。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_設計原則">設計原則</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_原則1シンプルに始め賢く進化させる">原則1：シンプルに始め、賢く進化させる</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE rectangle "フェーズ 1 : MVP" #LightGreen { component "JBake + Supabase" as mvp note right ✓ Développement en jours ✓ Coût : 0€ ✓ Validation concept end note } rectangle "**フェーズ 2: 成長**" #LightYellow { component "JBake + Supabase + Spring Boot (オプション)" as growth note right ✓ Logique métier émerge ✓ Premiers jobs planifiés ✓ Intégrations tierces end note } rectangle "フェーズ 3 : スケール" #LightCoral { component "完全なアーキテクチャ" as scale note right ✓ Orchestration complexe ✓ Performances optimisées ✓ Cache distribué end note } mvp -down-> growth : Quand la complexité\nle justifie growth -down-> scale : Optimisation\ncontinue @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>必要でなければ、Spring Bootを構築しないでください。</strong>Supabaseで始めて、複雑さが必要とされるときにSpring Bootを追加してください。</p> </div> </div> <div class="sect2"> <h3 id="_原則2_操作の性質による分離">原則2 : 操作の性質による分離</h3> <div class="listingblock"> <div class="content"> <pre>@startmindmap skinparam backgroundColor #FEFEFE * Opérations\nApplicatives left side ** Opérations Simples\n(Supabase) ***_ CRUD Standard ****_ Lecture ****_ Création ****_ Mise à jour ****_ Suppression ***_ Authentification ****_ Login/Logout ****_ OAuth2 ****_ Gestion session ***_ Stockage ****_ Upload fichiers ****_ CDN automatique ***_ Temps Réel ****_ WebSocket ****_ Notifications right side ** Opérations Complexes\n(Spring Boot) ***_ Logique Métier ****_ Calculs complexes ****_ Règles métier ****_ Validations avancées ***_ Orchestration ****_ Multi-services ****_ Transactions distribuées ****_ Saga patterns ***_ Tâches Planifiées ****_ Rapports périodiques ****_ Synchronisations ****_ Nettoyages ***_ Intégrations ****_ Paiements (Stripe) ****_ APIs tierces ****_ Services ML/AI @endmindmap</pre> </div> </div> </div> <div class="sect2"> <h3 id="_原則_3_単一の真実の源">原則 3 : 単一の真実の源</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE database "ポストグレスQL" as db #LightGray { package "スキーマ: auth (Supabase)" #LightGreen { [users] [sessions] [identities] } package "スキーマ: 公開 (共有)" #SkyBlue { [articles] [comments] [profiles] } package "スキーマ: ビジネス (Spring Boot)" #Coral { [orders] [payments] [reports] } } component "Supabase" as supabase #LightGreen component "スプリングブート" as spring #Coral supabase -down-> users : Gère supabase -down-> sessions : Gère supabase -down-> articles : Accède supabase -down-> comments : Accède supabase -down-> profiles : Accède spring -down-> articles : Accède spring -down-> profiles : Accède spring -down-> orders : Gère spring -down-> payments : Gère spring -down-> reports : Gère note right of db **Avantages :** • Pas de synchronisation complexe • JOINs possibles entre tables • Cohérence garantie • Migrations unifiées end note @enduml</pre> </div> </div> <div class="paragraph"> <p>同じPostgreSQLインスタンスを共有することで、SupabaseとSpring Bootは複雑な同期なしに同じデータを扱います。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_フローのオーケストレーション">フローのオーケストレーション</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_フラックス_1_中央認証">フラックス 1: 中央認証</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE autonumber actor "ユーザー" as user participant "JBake" as jbake participant "Supabase認証" as auth participant "Spring Boot" as spring database "PostgreSQL" as db == Authentification == user -> jbake : Clique "ログイン" jbake -> auth : Redirect OAuth2 (Google/GitHub) auth -> user : Consent screen user -> auth : Autorise auth -> auth : Génère JWT auth -> jbake : Retourne JWT + Refresh Token jbake -> jbake : Stocke tokens (sessionStorage) == Accès aux Ressources == group Opération Simple (CRUD) user -> jbake : Crée un article jbake -> db : POST avec JWT note right: Supabase Row Level Security\nvérifie le JWT automatiquement db -> jbake : Article créé end group Opération Complexe (Métier) user -> jbake : Génère un rapport jbake -> spring : POST /api/reports\navec JWT spring -> spring : Valide JWT Supabase spring -> spring : Extrait claims (user_id, roles) spring -> db : Requêtes complexes spring -> jbake : Rapport généré end note over auth, spring **Le JWT est universel** Valide par Supabase ET Spring Boot Pas de double authentification end note @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>重要なポイント</strong>一つの認証プロセス、一つのJWT、どこでも使える。</p> </div> </div> <div class="sect2"> <h3 id="_フラックス_2_ビジネスプロセスの複雑なオーケストレーション">フラックス 2 : ビジネスプロセスの複雑なオーケストレーション</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE autonumber actor "クライアント" as user participant "JBake" as jbake participant "スプリングブート" as spring participant "Supabase データベース" as supadb participant "Stripe API" as stripe participant "在庫サービス" as inventory participant "メールサービス" as email database "PostgreSQL" as db user -> jbake : Passe commande jbake -> spring : POST /api/orders/create == Orchestration Spring Boot == spring -> db : BEGIN TRANSACTION par Vérifications Parallèles spring -> inventory : Vérifier stock inventory -> spring : Stock OK else spring -> db : Vérifier profil client db -> spring : Client vérifié end spring -> stripe : Créer Payment Intent stripe -> spring : Intent créé (ID: pi_xxx) spring -> db : Créer Order (status: PENDING) db -> spring : Order créé spring -> stripe : Confirmer paiement stripe -> spring : Paiement confirmé spring -> db : Update Order (status: PAID) spring -> inventory : Décrémenter stock spring -> db : COMMIT TRANSACTION par Notifications Asynchrones spring -> email : Email confirmation else spring -> supadb : Insert notification note right: Notification temps réel\nvia Supabase Realtime end spring -> jbake : Order confirmé jbake -> user : Affiche confirmation note over spring **Responsabilités Spring Boot :** • Transaction ACID • Orchestration multi-services • Rollback automatique si erreur • Gestion des cas limites end note @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>Spring Bootがもたらすもの</strong>: 信頼性の高い複数のシステムに関わる複雑なプロセスのオーケストレーション、トランザクション保証付き。</p> </div> </div> <div class="sect2"> <h3 id="_フラックス_3_予定されたジョブと同期">フラックス 3 : 予定されたジョブと同期</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE participant "スケジューラ (Spring Boot)" as scheduler participant "レポートサービス" as report participant "PostgreSQL" as db participant "外部 API" as api participant "メールサービス" as email participant "Supabase ストレージ" as storage == Job Quotidien : 2h00 == activate scheduler scheduler -> report : Déclenche génération rapport activate report report -> db : Récupère données\ndes dernières 24h db -> report : Dataset report -> report : Calculs & Agrégations report -> report : Génération PDF report -> storage : Upload PDF storage -> report : URL publique report -> email : Envoie aux admins\navec lien PDF deactivate report == Job Hebdomadaire : Dimanche 3h00 == scheduler -> report : Synchronisation externe activate report report -> api : Fetch données externes api -> report : Nouvelles données report -> db : Mise à jour tables report -> db : Nettoyage données obsolètes deactivate report == Job Mensuel : 1er du mois == scheduler -> report : Facturation activate report report -> db : Liste clients actifs report -> report : Calcul montants report -> api : Génération factures (Stripe) report -> email : Envoi factures deactivate report deactivate scheduler note right of scheduler **Impossible avec Supabase seul** Edge Functions non adaptées pour jobs longs et récurrents end note @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>Spring Bootがもたらすもの</strong>: 状態管理、自動リトライ、および保証された実行を備えた信頼性の高いスケジュールされたジョブ</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_意思決定マトリクス">意思決定マトリクス</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_supabaseを使うべき時は">Supabaseを使うべき時は？</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE start :Nouvelle fonctionnalité à implémenter; if (CRUD simple ?) then (oui) :✅ **Supabase**; stop else (non) if (Authentification ?) then (oui) :✅ **Supabase Auth**; stop else (non) if (Upload fichiers ?) then (oui) :✅ **Supabase Storage**; stop else (non) if (Temps réel ?) then (oui) :✅ **Supabase Realtime**; stop else (non) if (Row Level Security\nsuffisante ?) then (oui) :✅ **Supabase + Policies**; stop else (non) :⚠️ **Considérer Spring Boot**; #Coral:Passer à l'arbre\nde décision Spring Boot; stop endif endif endif endif endif @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_spring_bootを使うべき時は">Spring Bootを使うべき時は？</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE start :Nouvelle fonctionnalité complexe; if (Orchestration\nmulti-services ?) then (oui) :✅ **Spring Boot**; stop else (non) if (Transaction ACID\ncritique ?) then (oui) :✅ **Spring Boot**; stop else (non) if (Job planifié ?) then (oui) :✅ **Spring Boot Scheduler**; stop else (non) if (Intégration API\ntierce complexe ?) then (oui) :✅ **Spring Boot**; stop else (non) if (Calculs lourds\n> 10 secondes ?) then (oui) :✅ **Spring Boot**; stop else (non) if (Cache distribué\nnécessaire ?) then (oui) :✅ **Spring Boot + Redis**; stop else (non) :⚠️ **Probablement Supabase**; #LightGreen:Revenir à l'arbre\nde décision Supabase; stop endif endif endif endif endif endif @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_プロジェクトタイプ別の建築例">プロジェクトタイプ別の建築例</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_ブログ_ポートフォリオ">ブログ / ポートフォリオ</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle package "個人ブログ - 95% Supabase" { component "JBake" as jbake #SkyBlue package "Supabase (無料)" #LightGreen { [Auth: OAuth2 Google] [Articles (CRUD)] [Commentaires] [Images (Storage)] [Notifications Realtime] } package "Spring Boot (オプション)" #LightCoral { [Newsletter Mensuelle] note bottom: Job planifié uniquement } database "PostgreSQL" as db jbake --> [Auth: OAuth2 Google] jbake --> [Articles (CRUD)] jbake --> [Commentaires] jbake --> [Images (Storage)] jbake --> [Notifications Realtime] [Articles (CRUD)] --> db [Commentaires] --> db [Newsletter Mensuelle] --> db } note bottom of "Spring Boot (オプション)" **Spring Boot pas obligatoire** Newsletter peut être gérée par un service tiers (Mailchimp) end note @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>評決</strong>: 100% Supabaseは十分すぎるほどです。</p> </div> </div> <div class="sect2"> <h3 id="_saas_アプリケーション">SaaS アプリケーション</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle package "アプリケーション SaaS - ハイブリッド アーキテクチャ" { component "JBake / React" as frontend #SkyBlue package "Supabase" #LightGreen { [Auth Multi-tenant] [Profils Utilisateurs] [Données Simples] [Storage Documents] } package "スプリング ブート" #Coral { [Facturation (Stripe)] [Analytics Avancées] [Rapports Mensuels] [Quotas & Limites] [Webhooks Stripe] } cloud "外部サービス" { [Stripe API] [SendGrid Email] } database "PostgreSQL 共有" as db frontend --> [Auth Multi-tenant] frontend --> [Profils Utilisateurs] frontend --> [Données Simples] frontend --> [Facturation (Stripe)] frontend --> [Analytics Avancées] [Auth Multi-tenant] --> db [Profils Utilisateurs] --> db [Données Simples] --> db [Facturation (Stripe)] --> db [Facturation (Stripe)] --> [Stripe API] [Analytics Avancées] --> db [Rapports Mensuels] --> db [Rapports Mensuels] --> [SendGrid Email] [Webhooks Stripe] ..> [Stripe API] : Écoute } note right of "スプリング ブート" **Nécessaire pour :** • Gestion abonnements • Facturation récurrente • Quotas dynamiques • Analytics complexes • Webhooks fiables end note @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>判決</strong>: ハイブリッドアーキテクチャが必要です。Supabase は基本部分に、Spring Boot はクリティカルな部分（支払い、請求）に使用します。</p> </div> </div> <div class="sect2"> <h3 id="_eコマース">Eコマース</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle package "Eコマース - 70% Spring Boot" { component "ストアフロント(JBake/React)" as frontend #SkyBlue package "Supabase" #LightGreen { [Auth Clients] [Catalogue Produits\n(lecture seule)] [Images Produits] } package "Spring Boot (コアビジネス)" #Coral { [Gestion Commandes] [Paiements Stripe] [Gestion Stock] [Calcul Frais Port] [Génération Factures] [Synchronisation ERP] [Emails Transactionnels] } cloud "統合" { [Stripe] [Transporteur API] [ERP Externe] } database "PostgreSQL" as db frontend --> [Auth Clients] frontend --> [Catalogue Produits\n(lecture seule)] frontend --> [Gestion Commandes] [Auth Clients] --> db [Catalogue Produits\n(lecture seule)] --> db [Gestion Commandes] --> db [Paiements Stripe] --> [Stripe] [Gestion Stock] --> db [Calcul Frais Port] --> [Transporteur API] [Génération Factures] --> db [Synchronisation ERP] --> [ERP Externe] [Synchronisation ERP] --> db } note right of "Spring Boot (コアビジネス)" **Spring Boot indispensable :** • Transactions critiques • Orchestration complexe • Intégrations multiples • Conformité légale • Jobs de synchronisation end note @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>判決</strong>Spring Bootは不可欠です。Supabaseは認証とカタログのみに使用します。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_段階的移行戦略">段階的移行戦略</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE |Semaine 1-2| start :Créer projet Supabase; :Configurer Auth (Google, GitHub); :Définir schéma PostgreSQL initial; :Implémenter CRUD de base sur JBake; :Déployer MVP sur GitHub Pages; note right **Livrable :** Application fonctionnelle **Coût :** 0€ **Temps :** 1-2 semaines end note |Semaine 3-4| :Observer utilisation réelle; :Identifier limitations; |Décision| if (Logique complexe\némerge ?) then (non) |Supabase| :Continuer avec Supabase seul; :Ajouter Edge Functions si besoin; stop else (oui) |Spring Boot| :Créer projet Spring Boot; :Configurer validation JWT Supabase; :Migrer logique complexe vers Spring Boot; note right **Migration sélective** Seulement ce qui est complexe end note endif |Semaines suivantes| :Déployer Spring Boot (Cloud Run, EC2); :Connecter à PostgreSQL Supabase; :Implémenter premiers jobs planifiés; :Intégrer APIs tierces; stop note right **Architecture finale hybride** Supabase + Spring Boot en parfaite harmonie end note @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_コストと運営上の考慮事項">コストと運営上の考慮事項</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_コスト構造">コスト構造</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE package "月次推定コスト" { rectangle "MVPフェーズ (0-1000 ユーザー)" #LightGreen { [JBake (GitHub Pages): 0€] [Supabase: 0€] [Spring Boot: N/A] note bottom: **Total: 0€/mois** } rectangle "成長フェーズ (1k-10k ユーザー)" #LightYellow { [JBake (GitHub Pages): 0€] [Supabase: 0€] [Spring Boot (Cloud Run): 20-50€] [PostgreSQL (si séparé): 0-30€] note bottom: **Total: 20-80€/mois** } rectangle "フェーズ スケール\n(10k-100k ユーザー)" #LightCoral { [JBake (Netlify Pro): 19€] [Supabase Pro: 25€] [Spring Boot (instances multiples): 100-300€] [Redis Cache: 20-50€] [Monitoring: 20€] note bottom: **Total: 184-414€/mois** } } note right of "フェーズ スケール\n(10k-100k ユーザー)" À ce stade, les revenus justifient largement les coûts end note @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_オペレーションの責任">オペレーションの責任</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE package "誰が何を担当しているか?" { rectangle "Supabase によって管理されている (0 労力)" #LightGreen { [Authentification] [Base de données] [Backups automatiques] [Scaling automatique] [Monitoring DB] [Sécurité DB] } rectangle "GitHubによって管理されています（0の労力）" #SkyBlue { [Hébergement site statique] [HTTPS/SSL] [CDN global] [Déploiement automatique] } rectangle "Spring Boot を管理する" #LightCoral { [Déploiement application] [Monitoring APM] [Logs centralisés] [Scaling horizontal] [Mises à jour sécurité] } } note bottom of "Spring Boot を管理する" **Minimisable avec :** • Cloud Run (serverless) • Kubernetes (si nécessaire) • Services managés (RDS, etc.) end note @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論完璧なバランス">結論：完璧なバランス</h2> <div class="sectionbody"> <div class="paragraph"> <p>Supabase + Spring Bootのハイブリッドアーキテクチャは妥協ではなく、これは<strong>シナジー</strong>.</p> </div> <div class="sect2"> <h3 id="_覚えておくべき原則">覚えておくべき原則</h3> <div class="listingblock"> <div class="content"> <pre>@startmindmap skinparam backgroundColor #FEFEFE * Architecture\nHybride ** Commencer Simple ***_ MVP avec Supabase ***_ 0€ de coût initial ***_ Validation rapide ** Évoluer Intelligemment ***_ Ajouter Spring Boot\nsi nécessaire ***_ Migration progressive ***_ Pas de refonte totale ** Exploiter les Forces ***_ Supabase: Simplicité ***_ Spring Boot: Puissance ***_ PostgreSQL: Source unique ** Minimiser la Complexité ***_ Pas de synchronisation ***_ Pas de duplication ***_ Architecture claire ** Optimiser les Coûts ***_ Gratuit au départ ***_ Scaling progressif ***_ ROI évident @endmindmap</pre> </div> </div> </div> <div class="sect2"> <h3 id="_このアーキテクチャを選ぶのはいつですか">このアーキテクチャを選ぶのはいつですか？</h3> <div class="paragraph"> <p><strong>�✅ このアーキテクチャは理想的です、もし：</strong></p> </div> <div class="ulist"> <ul> <li> <p>すぐに始めたい（MVPは日単位で、月単位ではない）</p> </li> <li> <p>ビジネスの複雑さの増加を見越しています</p> </li> <li> <p>初期コストを最小限に抑えたい</p> </li> <li> <p>PostgreSQL が好きで、単一の真実のソースが欲しい</p> </li> <li> <p>あなたはKotlinとコルーチンをビジネスコードのために気に入っています</p> </li> <li> <p>あなたは完全なベンダーロックインを避けたい</p> </li> </ul> </div> <div class="paragraph"> <p><strong>�❌ このアーキテクチャは適していない場合：</strong></p> </div> <div class="ulist"> <ul> <li> <p>あなたのプロジェクトはシンプルで、そのまま保たれます (個人ブログ → Supabase 100% で十分)</p> </li> <li> <p>あなたは既にマスターしているバックエンドスタックを持っています。</p> </li> <li> <p>あなたは伝統的なモノリスを好みます</p> </li> <li> <p>.NET、Python、またはその他のバックエンド言語が必要です。</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_最終的な概観">最終的な概観</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE package "完全なハイブリッドアーキテクチャ" { actor "ユーザー" as users rectangle "フロントエンド (静的)" #SkyBlue { [JBake / GitHub Pages] note right: Gratuit, CDN global } rectangle "シンプルバックエンド(Supabase)" #LightGreen { [Auth OAuth2] [CRUD APIs] [Storage] [Realtime] note right Gratuit jusqu'à 50k users Zéro configuration serveur end note } rectangle "業務バックエンド (スプリングブート)" #Coral { [Orchestration] [Jobs Planifiés] [Intégrations] [Transactions] note right Activé uniquement si nécessaire end note } database "PostgreSQL 唯一の真実のソース" as db #LightGray users --> [JBake / GitHub Pages] [JBake / GitHub Pages] --> [Auth OAuth2] [JBake / GitHub Pages] --> [CRUD APIs] [JBake / GitHub Pages] --> [Storage] [JBake / GitHub Pages] --> [Realtime] [JBake / GitHub Pages] --> [Orchestration] [Auth OAuth2] --> db [CRUD APIs] --> db [Orchestration] --> db [Jobs Planifiés] --> db [Intégrations] --> db } note bottom of db **Une seule base, deux consommateurs** • Supabase pour le simple • Spring Boot pour le complexe • Aucune synchronisation requise end note @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_両方の世界のベスト">両方の世界のベスト</h3> <div class="paragraph"> <p>このアーキテクチャは、あなたに与えます：</p> </div> <div class="paragraph"> <p><strong>🚀 Supabaseの速度</strong></p> </div> <div class="ulist"> <ul> <li> <p>起動は時間単位、週単位ではない</p> </li> <li> <p>数回クリックでOAuth2認証</p> </li> <li> <p>自動生成されたREST API</p> </li> <li> <p>ゼロ構成サーバー</p> </li> </ul> </div> <div class="paragraph"> <p><strong>💪 Spring Bootの力</strong></p> </div> <div class="ulist"> <ul> <li> <p>Kotlin と コルーチン を使ったエレガントな非同期コード</p> </li> <li> <p>複雑な業務プロセスのオーケストレーション</p> </li> <li> <p>信頼できるスケジュールされたジョブ</p> </li> <li> <p>ACIDトランザクションが保証されます</p> </li> <li> <p>完全なSpringエコシステム</p> </li> </ul> </div> <div class="paragraph"> <p><strong>💰 プログレッシブ経済</strong></p> </div> <div class="ulist"> <ul> <li> <p>0€開始および検証するために</p> </li> <li> <p>成長に従うコスト</p> </li> <li> <p>時期尚早な過剰設計なし</p> </li> </ul> </div> <div class="paragraph"> <p><strong>🎯 建築の柔軟性</strong></p> </div> <div class="ulist"> <ul> <li> <p>段階的な移行、リフォームなし</p> </li> <li> <p>Spring Boot は必要な場合のみ追加する</p> </li> <li> <p>総ベンダーロックインはありません</p> </li> <li> <p>進化的アーキテクチャ</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_さらに進む">さらに進む</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_技術的リソース">技術的リソース</h3> <div class="paragraph"> <p><strong>Supabase ドキュメント :</strong></p> </div> <div class="ulist"> <ul> <li> <p><a href="https://supabase.com/docs/guides/auth">認証ガイド</a></p> </li> <li> <p><a href="https://supabase.com/docs/guides/database/postgres/row-level-security">行レベルセキュリティ</a></p> </li> <li> <p><a href="https://supabase.com/docs/guides/api">自動生成されたAPI</a></p> </li> </ul> </div> <div class="paragraph"> <p><strong>Spring Boot ドキュメント :</strong></p> </div> <div class="ulist"> <ul> <li> <p><a href="https://spring.io/guides/tutorials/spring-boot-kotlin/">Spring Boot と Kotlin</a></p> </li> <li> <p><a href="https://spring.io/blog/2019/04/12/going-reactive-with-spring-coroutines-and-kotlin-flow">コルーチンとSpring</a></p> </li> <li> <p><a href="https://docs.spring.io/spring-security/reference/servlet/oauth2/resource-server/jwt.html">JWT リソース サーバー</a></p> </li> </ul> </div> <div class="paragraph"> <p><strong>補足記事 :</strong></p> </div> <div class="ulist"> <ul> <li> <p>JWTを使用したAPIセキュリティ</p> </li> <li> <p>PostgreSQLのパフォーマンス最適化</p> </li> <li> <p>段階的な移行パターン</p> </li> <li> <p>分散アーキテクチャにおけるエラー管理</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_実際のユースケース">実際のユースケース</h3> <div class="paragraph"> <p>このハイブリッドアーキテクチャは、以下で成功裏に使用されています :</p> </div> <div class="ulist"> <ul> <li> <p><strong>SaaS B2B</strong>: Supabase認証, Spring Boot 請求</p> </li> <li> <p><strong>マーケットプレイス</strong>: Supabaseカタログ, Spring Bootのトランザクション</p> </li> <li> <p><strong>コンテンツプラットフォーム</strong>: Supabase記事, Spring Bootアナリティクス</p> </li> <li> <p><strong>内部ツール</strong>: CRUD Supabase, ワークフロー Spring Boot</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_スタートアップチェックリスト">スタートアップチェックリスト</h3> <div class="paragraph"> <p><strong>フェーズ 1 - 基礎 (第1週)</strong></p> </div> <div class="ulist checklist"> <ul class="checklist"> <li> <p><i class="fa fa-square-o"></i> Supabaseアカウントを作成 - [ ] PostgreSQL プロジェクトを設定する - [ ] 認証を有効にする (Google, GitHub) - [ ] 初期スキーマを定義 - [ ] Row Level Security を設定する - [ ] JBakeからAPIをテストする</p> </li> </ul> </div> <div class="paragraph"> <p><strong>フェーズ2 - MVP (第2-3週)</strong></p> </div> <div class="ulist checklist"> <ul class="checklist"> <li> <p><i class="fa fa-square-o"></i> 主要ページを実装する - [ ] OAuth2認証を統合する - [ ] CRUDフォームの作成 - [ ] ファイル用のストレージを設定 - [ ] GitHub Pagesにデプロイ - [ ] 実際の条件でテストする</p> </li> </ul> </div> <div class="paragraph"> <p><strong>フェーズ3 - 進化（ニーズに応じて）</strong></p> </div> <div class="ulist checklist"> <ul class="checklist"> <li> <p><i class="fa fa-square-o"></i> 複雑なロジックのニーズを特定 - [ ] 必要に応じて Spring Boot プロジェクトを作成 - [ ] スーパーベースのJWTバリデーションを設定する - [ ] Supabase PostgreSQLに接続 - [ ] 複雑な機能を移行する - [ ] スケジュールされたジョブを実装する - [ ] Spring Boot をデプロイ (Cloud Run など)</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_避けるべきアンチパターン">避けるべきアンチパターン</h3> <div class="paragraph"> <p><strong>❌ しないで :</strong></p> </div> <div class="ulist"> <ul> <li> <p>SupabaseとSpring Boot間でデータを複製する</p> </li> <li> <p>PostgreSQLの別々のデータベース2つを作成</p> </li> <li> <p>自分で認証をコードしてください</p> </li> <li> <p>Spring Bootを使ってシンプルなCRUDを実装する</p> </li> <li> <p>最初からオーバーアーキテクトする</p> </li> <li> <p>SupabaseのRow Level Securityを無視</p> </li> </ul> </div> <div class="paragraph"> <p><strong>むしろやる:</strong></p> </div> <div class="ulist"> <ul> <li> <p>単一のPostgreSQLデータベースを共有する</p> </li> <li> <p>Supabase に認証を任せる</p> </li> <li> <p>Spring Bootを複雑さのためだけに使用する</p> </li> <li> <p>シンプルに始めて、徐々に進化させる</p> </li> <li> <p>各テクノロジーの強みを活用する</p> </li> <li> <p>データベースレベルのRLSで保護する</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_進化の展望">進化の展望</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_新しい機能の追加">新しい機能の追加</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE rectangle "現在のアーキテクチャ" #SkyBlue { [JBake] [Supabase] [Spring Boot] } rectangle "可能な進化" #LightYellow { package "パフォーマンス" { [Redis Cache] [CDN pour Assets] [PostgreSQL Replicas] } package "モニタリング" { [Grafana] [Prometheus] [Sentry] } package "CI/CD" { [GitHub Actions] [Tests Automatisés] [Déploiement Continu] } package "機能" { [Search (ElasticSearch)] [Queue (RabbitMQ)] [Event Sourcing] } } [Spring Boot] .down.> [Redis Cache] : Peut ajouter [Spring Boot] .down.> [Queue (RabbitMQ)] : Peut ajouter [Spring Boot] .down.> [Search (ElasticSearch)] : Peut ajouter [Supabase] .down.> [PostgreSQL Replicas] : Peut ajouter note bottom **Architecture extensible** Chaque ajout est indépendant Pas de refonte globale nécessaire end note @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_水平スケーリング">水平スケーリング</h3> <div class="paragraph"> <p>アプリケーションが成長すると、ハイブリッドアーキテクチャは自然にスケールします：</p> </div> <div class="paragraph"> <p><strong>Supabase：</strong></p> </div> <div class="ulist"> <ul> <li> <p>自動的に何百万回もの操作にスケールします</p> </li> <li> <p>読み取りレプリカ（読み取りパフォーマンス用）</p> </li> <li> <p>セキュリティのためのポイントインタイムリカバリ</p> </li> </ul> </div> <div class="paragraph"> <p><strong>Spring Boot：</strong></p> </div> <div class="ulist"> <ul> <li> <p>ロードバランサーの背後に複数のインスタンス</p> </li> <li> <p>ステートレス設計は水平スケーリングを容易にする</p> </li> <li> <p>必要に応じて、Kubernetesをオーケストレーションに使用する</p> </li> </ul> </div> <div class="paragraph"> <p><strong>PostgreSQL：</strong></p> </div> <div class="ulist"> <ul> <li> <p>大規模なテーブル用のパーティショニング</p> </li> <li> <p>接続プール (PgBouncer)</p> </li> <li> <p>シャーディングは本当に必要です（稀）。</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_建築的証言">建築的証言</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_スタートアップ_saas_50k_ユーザー">スタートアップ SaaS (50k ユーザー)</h3> <div class="paragraph"> <p><em><em>_ 私たちはSupabaseで100%スタートしました。5kユーザーに到達したとき、Stripeの請求と月次レポートのためだけにSpring Bootを追加しました。1年後、私たちの操作の80%はまだSupabaseを経由しています。Spring Bootはクリティカルな部分のみを管理します。この分離により、リファクタリングを行わずにスケールすることができました。 </em>_</em></p> </div> </div> <div class="sect2"> <h3 id="_eラーニングプラットフォーム_10k_ユーザー">Eラーニングプラットフォーム (10k ユーザー)</h3> <div class="paragraph"> <p><em><em>_ SupabaseのOAuth2認証により、開発に3週間の時間を節約できました。自動生成されたAPIが、コースカタログ全体を管理しています。Spring BootはPDF証明書と進捗メールにのみ使用されています。シンプルで保守性が高く、拡張性のあるアーキテクチャです。 </em>_</em></p> </div> </div> <div class="sect2"> <h3 id="_b2bマーケットプレイス3kユーザー">B2Bマーケットプレイス（3kユーザー）</h3> <div class="paragraph"> <p><em><em>_ Spring Bootは、買い手と売り手の間のトランザクションを管理します（重要）。Supabaseは、残りのすべてを管理します：プロフィール、リアルタイムメッセージング、ドキュメント。同じPostgreSQLデータベースを共有しているため、複雑な同期を避けることができます。これは、私たちがこれまでに行った中で最高のアーキテクチャ選択です。 </em>_</em></p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_要約モダンな建築パラダイム">要約：モダンな建築パラダイム</h2> <div class="sectionbody"> <div class="paragraph"> <p>Supabase と Spring Boot を組み合わせたハイブリッド アーキテクチャは、新しいパラダイムを示しています：<strong>建築分野の専門化</strong>。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE rectangle "古いパラダイム" #LightCoral { card "バックエンドの中のすべて" { [Auth] [CRUD] [Logique Métier] [Jobs] [Storage] [Realtime] } note bottom Complexité maximale dès le jour 1 end note } rectangle "新しいパラダイム" #LightGreen { card "Supabase (便利)" { [Auth] [CRUD Simple] [Storage] [Realtime] } card "Spring Boot (差別化)" { [Logique Métier] [Jobs] [Intégrations] } note bottom Complexité progressive ajoutée seulement si nécessaire end note } [Ancien Paradigme] -right-> [Nouveau Paradigme] : Évolution @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>基本原理 :</strong>既にサービスとして存在するものを構築しないでください。あなたのアプリケーションを差別化する点に集中してください。</p> </div> <div class="sect2"> <h3 id="_8020の法則">80/20の法則</h3> <div class="paragraph"> <p>ほとんどのアプリケーションでは：</p> </div> <div class="ulist"> <ul> <li> <p><strong>80% の操作</strong>標準のCRUDです → Supabase</p> </li> <li> <p><strong>20% の操作</strong>ビジネスロジックが必要です → Spring Boot</p> </li> </ul> </div> <div class="paragraph"> <p>この自然なルールはハイブリッドアーキテクチャを正当化します。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE package "作業の配分" { rectangle "80% - 標準操作" #LightGreen { [Lecture de données] [Création d'entités] [Mise à jour simple] [Suppression] [Upload fichiers] [Authentification] note bottom: **Géré par Supabase** } rectangle "20% - ビジネスロジック" #Coral { [Calculs complexes] [Workflows multi-étapes] [Transactions critiques] [Intégrations tierces] [Jobs planifiés] note bottom: **Géré par Spring Boot** } } note right **Focus optimal :** Votre temps de développement concentré sur les 20% qui différencient votre produit end note @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_最終結論">最終結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>ハイブリッドアーキテクチャは技術的な妥協ではありません。それは<strong>戦略的決定</strong>。</p> </div> <div class="paragraph"> <p><strong>したがって、あなたは以下のことができます：</strong></p> </div> <div class="ulist"> <ul> <li> <p>✅ 機能的なMVPで素早く始める</p> </li> <li> <p>�✅ 市場を検証する 重大な投資なしで</p> </li> <li> <p>複雑さが求められるときに段階的に進化する</p> </li> <li> <p>各段階でコストを管理する</p> </li> <li> <p>各テクノロジーのベストを活用する</p> </li> <li> <p>�✅ 過早なオーバーエンジニアリングを避ける</p> </li> <li> <p>�✅ 将来のために柔軟性を保つ</p> </li> </ul> </div> <div class="paragraph"> <p><strong>彼女が表す：</strong></p> </div> <div class="ulist"> <ul> <li> <p>🎯<strong>実用主義</strong>彼女が得意とするすべての技術</p> </li> <li> <p>🚀<strong>速度</strong>: 最小のタイム・トゥ・マーケット</p> </li> <li> <p>💰<strong>経済</strong>価値に合わせたコスト</p> </li> <li> <p>�🔮<strong>拡張性</strong>: アーキテクチャはあなたと共に成長します</p> </li> <li> <p>�🛡️<strong>堅牢性</strong>実績のある信頼できるサービス</p> </li> </ul> </div> <div class="sect2"> <h3 id="_あなたの次のステップ">あなたの次のステップ</h3> <div class="paragraph"> <p>このアーキテクチャがあなたに響くなら、ここで始める場所はこちらです：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>Supabaseアカウントを作成してください</strong>(無料)</p> </li> <li> <p><strong>最小限のデータスキーマを定義してください</strong></p> </li> <li> <p><strong>OAuth2認証を設定してください</strong></p> </li> <li> <p><strong>最初のJBakeページを作成し、APIを消費する</strong></p> </li> <li> <p><strong>GitHub Pagesにデプロイしてください</strong></p> </li> </ol> </div> <div class="paragraph"> <p>機能するMVPが手に入ります<strong>数日</strong>.</p> </div> <div class="paragraph"> <p>Spring Boot は必要になったとき自然にやってきます。それより前ではない。</p> </div> <hr> <div class="paragraph"> <p><strong>ハイブリッドアーキテクチャとは、必要なものを必要なときに正確に構築することである。</strong></p> </div> <div class="paragraph"> <p><em>良い開発を！ 🚀</em></p> </div> <hr> <div class="paragraph"> <p><em>この記事を、他の開発者が適切なアーキテクチャの選択をするのに役立つと思う場合はシェアしてください。</em></p> </div> </div> </div> </div> https://cheroliv.com/blog/2026/0100_jbake_supabase_springboot_hybride_post.html Wed, 14 Jan 2026 00:00:00 +0000 blog/2026/0100_jbake_supabase_springboot_hybride_post.html <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title">読了時間 : 12 minutes</div> <p>SupabaseのシンプルさとSpring Bootのパワーの間で選ぶのではなく、両方を組み合わせてみませんか？各テクノロジーの長所を活かしたハイブリッドアーキテクチャを見つけてください。</p> </div> <div class="dlist"> <dl> <dt class="hdlist1">コンコン</dt> <dd> <p>[]</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_現代建築の偽ジレンマ">現代建築の偽ジレンマ</h2> <div class="sectionbody"> <div class="paragraph"> <p>静的フロントエンドを使ってモダンなアプリケーションを構築する際、二者択一の選択肢に直面することがよくあります：</p> </div> <div class="ulist"> <ul> <li> <p><strong>バックエンド・アズ・ア・サービスソリューションにすべてを賭ける</strong>(Supabase, Firebase) - シンプルだが制限がある</p> </li> <li> <p><strong>完全なバックエンドを構築する</strong>(Spring Boot, Node.js) - 強力だが複雑</p> </li> </ul> </div> <div class="paragraph"> <p>この選択は偽のジレンマです。ハイブリッドアーキテクチャは第三の道を提案します： <strong>各テクノロジーが最も得意とする場所で使用する</strong></p> </div> </div> </div> <div class="sect1"> <h2 id="_建築ビジョン">建築ビジョン</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_伝統的アーキテクチャモノリシック">伝統的アーキテクチャ：モノリシック</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle package "伝統的な建築" { actor Utilisateur as user component "フロントエンド" as frontend #LightBlue component "モノリシックバックエンド" as backend #LightCoral { [Authentification] [CRUD] [Logique Métier] [Jobs] [APIs Tierces] } database "データベース" as db #LightGray user --> frontend frontend --> backend : Toutes les requêtes backend --> db } note right of backend Tout passe par le backend même les opérations simples ⚠️ Point de congestion unique ⚠️ Complexité dès le départ ⚠️ Couplage fort end note @enduml</pre> </div> </div> <div class="paragraph"> <p>このアプローチでは、記事の読み込みやコメントの作成など、最も単純な操作であってもすべてバックエンドを経由する必要があります。最初の日から複雑さのコストを支払うことになります。</p> </div> </div> <div class="sect2"> <h3 id="_baasアーキテクチャ_すべての代表者">BaaSアーキテクチャ: すべての代表者</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle package "�純粋なBaaSアーキテクチャ" { actor Utilisateur as user component "フロントエンド" as frontend #LightBlue cloud "Supabase / Firebase" as baas #LightGreen { [Auth] [Database] [Storage] [Edge Functions] } user --> frontend frontend --> baas : Toutes les opérations } note right of baas Développement rapide Pas de serveur à gérer ⚠️ Limité pour logique complexe ⚠️ Vendor lock-in ⚠️ Edge Functions contraintes end note @enduml</pre> </div> </div> <div class="paragraph"> <p>逆に、すべてを BaaS に委任することは最初は魅力的ですが、ビジネスロジックが複雑になるとすぐにその限界が見えてきます。</p> </div> </div> <div class="sect2"> <h3 id="_ハイブリッドアーキテクチャ責任の分離">ハイブリッドアーキテクチャ：責任の分離</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle actor Utilisateur as user #LightBlue package "フロントエンド層" { component "JBake 静的サイト" as frontend #SkyBlue } package "シンプルな層 (Supabase)" #LightGreen { component "認証" as auth component "基本的なCRUD" as crud component "ファイルストレージ" as storage component "リアルタイム" as realtime } package "サービス層 (Spring Boot)" #Coral { component "複雑な論理" as logic component "オーケストレーション" as orchestration component "スケジュールされたジョブ" as jobs component "統合" as integrations } database "共有 PostgreSQL" as db #LightGray user --> frontend frontend --> auth : OAuth2, JWT frontend --> crud : Articles, Profils frontend --> storage : Images, Fichiers frontend --> realtime : Notifications frontend --> logic : Calculs, Rapports frontend --> orchestration : Workflows logic --> integrations : Stripe, APIs orchestration --> db jobs --> db crud --> db auth --> db note bottom of db **Une seule source de vérité** Partagée entre Supabase et Spring Boot end note note right of auth **Gratuit jusqu'à 50k users** Configuration en quelques clics OAuth2 multi-providers end note note right of logic **Activé seulement si nécessaire** Kotlin + Coroutines Transactions complexes end note @enduml</pre> </div> </div> <div class="paragraph"> <p>ハイブリッドアーキテクチャは、操作の複雑さと性質に応じて、責任を明確に分離します。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_設計原則">設計原則</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_原則1シンプルに始め賢く進化させる">原則1：シンプルに始め、賢く進化させる</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE rectangle "**フェーズ 1 : MVP**" #LightGreen { component "JBake + Supabase" as mvp note right ✓ Développement en jours ✓ Coût : 0€ ✓ Validation concept end note } rectangle "フェーズ2：成長" #LightYellow { component "JBake + Supabase + Spring Boot (オプション)" as growth note right ✓ Logique métier émerge ✓ Premiers jobs planifiés ✓ Intégrations tierces end note } rectangle "フェーズ 3 : スケール" #LightCoral { component "完全なアーキテクチャ" as scale note right ✓ Orchestration complexe ✓ Performances optimisées ✓ Cache distribué end note } mvp -down-> growth : Quand la complexité\nle justifie growth -down-> scale : Optimisation\ncontinue @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>必要がない場合は、Spring Bootをビルドしないでください。</strong>Supabaseで始めて、複雑さがそれを正当化するならSpring Bootを追加してください。</p> </div> </div> <div class="sect2"> <h3 id="_原則2_業務の性質による分離">原則2 : 業務の性質による分離</h3> <div class="listingblock"> <div class="content"> <pre>@startmindmap skinparam backgroundColor #FEFEFE * Opérations\nApplicatives left side ** Opérations Simples\n(Supabase) ***_ CRUD Standard ****_ Lecture ****_ Création ****_ Mise à jour ****_ Suppression ***_ Authentification ****_ Login/Logout ****_ OAuth2 ****_ Gestion session ***_ Stockage ****_ Upload fichiers ****_ CDN automatique ***_ Temps Réel ****_ WebSocket ****_ Notifications right side ** Opérations Complexes\n(Spring Boot) ***_ Logique Métier ****_ Calculs complexes ****_ Règles métier ****_ Validations avancées ***_ Orchestration ****_ Multi-services ****_ Transactions distribuées ****_ Saga patterns ***_ Tâches Planifiées ****_ Rapports périodiques ****_ Synchronisations ****_ Nettoyages ***_ Intégrations ****_ Paiements (Stripe) ****_ APIs tierces ****_ Services ML/AI @endmindmap</pre> </div> </div> </div> <div class="sect2"> <h3 id="_原則3唯一の真実のソース">原則3：唯一の真実のソース</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE database "PostgreSQL" as db #LightGray { package "スキーマ: auth (Supabase)" #LightGreen { [users] [sessions] [identities] } package "スキーマ: 公開 (共有)" #SkyBlue { [articles] [comments] [profiles] } package "スキーマ: ビジネス (Spring Boot)" #Coral { [orders] [payments] [reports] } } component "サプベース" as supabase #LightGreen component "スプリングブート" as spring #Coral supabase -down-> users : Gère supabase -down-> sessions : Gère supabase -down-> articles : Accède supabase -down-> comments : Accède supabase -down-> profiles : Accède spring -down-> articles : Accède spring -down-> profiles : Accède spring -down-> orders : Gère spring -down-> payments : Gère spring -down-> reports : Gère note right of db **Avantages :** • Pas de synchronisation complexe • JOINs possibles entre tables • Cohérence garantie • Migrations unifiées end note @enduml</pre> </div> </div> <div class="paragraph"> <p>SupabaseとSpring Bootは同じPostgreSQLインスタンスを共有することで、複雑な同期なしに同じデータ上で作業します。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_フラックスのオーケストレーション">フラックスのオーケストレーション</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_フラックス_1_中央集中型認証">フラックス 1 : 中央集中型認証</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE autonumber actor "ユーザー" as user participant "JBake" as jbake participant "Supabase Auth" as auth participant "スプリングブート" as spring database "PostgreSQL" as db == Authentification == user -> jbake : Clique "ログイン" jbake -> auth : Redirect OAuth2 (Google/GitHub) auth -> user : Consent screen user -> auth : Autorise auth -> auth : Génère JWT auth -> jbake : Retourne JWT + Refresh Token jbake -> jbake : Stocke tokens (sessionStorage) == Accès aux Ressources == group Opération Simple (CRUD) user -> jbake : Crée un article jbake -> db : POST avec JWT note right: Supabase Row Level Security\nvérifie le JWT automatiquement db -> jbake : Article créé end group Opération Complexe (Métier) user -> jbake : Génère un rapport jbake -> spring : POST /api/reports\navec JWT spring -> spring : Valide JWT Supabase spring -> spring : Extrait claims (user_id, roles) spring -> db : Requêtes complexes spring -> jbake : Rapport généré end note over auth, spring **Le JWT est universel** Valide par Supabase ET Spring Boot Pas de double authentification end note @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>重要な点</strong>: 一つの認証プロセス、一つのJWT、どこでも利用可能。</p> </div> </div> <div class="sect2"> <h3 id="_フラックス2複雑なビジネスプロセスのオーケストレーション">フラックス2：複雑なビジネスプロセスのオーケストレーション</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE autonumber actor "クライアント" as user participant "JBake" as jbake participant "スプリングブート" as spring participant "Supabase データベース" as supadb participant "StripeのAPI" as stripe participant "在庫サービス" as inventory participant "メールサービス" as email database "PostgreSQL" as db user -> jbake : Passe commande jbake -> spring : POST /api/orders/create == Orchestration Spring Boot == spring -> db : BEGIN TRANSACTION par Vérifications Parallèles spring -> inventory : Vérifier stock inventory -> spring : Stock OK else spring -> db : Vérifier profil client db -> spring : Client vérifié end spring -> stripe : Créer Payment Intent stripe -> spring : Intent créé (ID: pi_xxx) spring -> db : Créer Order (status: PENDING) db -> spring : Order créé spring -> stripe : Confirmer paiement stripe -> spring : Paiement confirmé spring -> db : Update Order (status: PAID) spring -> inventory : Décrémenter stock spring -> db : COMMIT TRANSACTION par Notifications Asynchrones spring -> email : Email confirmation else spring -> supadb : Insert notification note right: Notification temps réel\nvia Supabase Realtime end spring -> jbake : Order confirmé jbake -> user : Affiche confirmation note over spring **Responsabilités Spring Boot :** • Transaction ACID • Orchestration multi-services • Rollback automatique si erreur • Gestion des cas limites end note @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>Spring Bootが提供するもの</strong>複数のシステムに関わる複雑なプロセスの信頼性の高いオーケストレーションおよびトランザクション保証。</p> </div> </div> <div class="sect2"> <h3 id="_フラックス_3_予定されたジョブと同期">フラックス 3 : 予定されたジョブと同期</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE participant "スケジューラー\n(Spring Boot)" as scheduler participant "レポートサービス" as report participant "PostgreSQL" as db participant "外部 API" as api participant "メールサービス" as email participant "Supabase ストレージ" as storage == Job Quotidien : 2h00 == activate scheduler scheduler -> report : Déclenche génération rapport activate report report -> db : Récupère données\ndes dernières 24h db -> report : Dataset report -> report : Calculs & Agrégations report -> report : Génération PDF report -> storage : Upload PDF storage -> report : URL publique report -> email : Envoie aux admins\navec lien PDF deactivate report == Job Hebdomadaire : Dimanche 3h00 == scheduler -> report : Synchronisation externe activate report report -> api : Fetch données externes api -> report : Nouvelles données report -> db : Mise à jour tables report -> db : Nettoyage données obsolètes deactivate report == Job Mensuel : 1er du mois == scheduler -> report : Facturation activate report report -> db : Liste clients actifs report -> report : Calcul montants report -> api : Génération factures (Stripe) report -> email : Envoi factures deactivate report deactivate scheduler note right of scheduler **Impossible avec Supabase seul** Edge Functions non adaptées pour jobs longs et récurrents end note @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>Spring Bootがもたらすもの</strong>: 信頼性の高いスケジュールされたジョブ、状態管理、自動リトライ、保証された実行</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_意思決定マトリックス">意思決定マトリックス</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_supabase_を使うべきときは">Supabase を使うべきときは？</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE start :Nouvelle fonctionnalité à implémenter; if (CRUD simple ?) then (oui) :✅ **Supabase**; stop else (non) if (Authentification ?) then (oui) :✅ **Supabase Auth**; stop else (non) if (Upload fichiers ?) then (oui) :✅ **Supabase Storage**; stop else (non) if (Temps réel ?) then (oui) :✅ **Supabase Realtime**; stop else (non) if (Row Level Security\nsuffisante ?) then (oui) :✅ **Supabase + Policies**; stop else (non) :⚠️ **Considérer Spring Boot**; #Coral:Passer à l'arbre\nde décision Spring Boot; stop endif endif endif endif endif @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_spring_boot_を使用するのはいつですか">Spring Boot を使用するのはいつですか？</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE start :Nouvelle fonctionnalité complexe; if (Orchestration\nmulti-services ?) then (oui) :✅ **Spring Boot**; stop else (non) if (Transaction ACID\ncritique ?) then (oui) :✅ **Spring Boot**; stop else (non) if (Job planifié ?) then (oui) :✅ **Spring Boot Scheduler**; stop else (non) if (Intégration API\ntierce complexe ?) then (oui) :✅ **Spring Boot**; stop else (non) if (Calculs lourds\n> 10 secondes ?) then (oui) :✅ **Spring Boot**; stop else (non) if (Cache distribué\nnécessaire ?) then (oui) :✅ **Spring Boot + Redis**; stop else (non) :⚠️ **Probablement Supabase**; #LightGreen:Revenir à l'arbre\nde décision Supabase; stop endif endif endif endif endif endif @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_プロジェクトタイプ別のアーキテクチャ例">プロジェクトタイプ別のアーキテクチャ例</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_ブログ_ポートフォリオ">ブログ / ポートフォリオ</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle package "個人ブログ - 95% Supabase" { component "JBake" as jbake #SkyBlue package "Supabase (無料)" #LightGreen { [Auth: OAuth2 Google] [Articles (CRUD)] [Commentaires] [Images (Storage)] [Notifications Realtime] } package "Spring Boot (オプション)" #LightCoral { [Newsletter Mensuelle] note bottom: Job planifié uniquement } database "PostgreSQL" as db jbake --> [Auth: OAuth2 Google] jbake --> [Articles (CRUD)] jbake --> [Commentaires] jbake --> [Images (Storage)] jbake --> [Notifications Realtime] [Articles (CRUD)] --> db [Commentaires] --> db [Newsletter Mensuelle] --> db } note bottom of "Spring Boot (オプション)" **Spring Boot pas obligatoire** Newsletter peut être gérée par un service tiers (Mailchimp) end note @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>判決</strong>: 100% Supabaseは十分以上です。</p> </div> </div> <div class="sect2"> <h3 id="_saasアプリケーション">SaaSアプリケーション</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle package "SaaSアプリケーション-ハイブリッドアーキテクチャー" { component "JBake / React" as frontend #SkyBlue package "スパベース" #LightGreen { [Auth Multi-tenant] [Profils Utilisateurs] [Données Simples] [Storage Documents] } package "スプリングブート" #Coral { [Facturation (Stripe)] [Analytics Avancées] [Rapports Mensuels] [Quotas & Limites] [Webhooks Stripe] } cloud "外部サービス" { [Stripe API] [SendGrid Email] } database "PostgreSQL 共有" as db frontend --> [Auth Multi-tenant] frontend --> [Profils Utilisateurs] frontend --> [Données Simples] frontend --> [Facturation (Stripe)] frontend --> [Analytics Avancées] [Auth Multi-tenant] --> db [Profils Utilisateurs] --> db [Données Simples] --> db [Facturation (Stripe)] --> db [Facturation (Stripe)] --> [Stripe API] [Analytics Avancées] --> db [Rapports Mensuels] --> db [Rapports Mensuels] --> [SendGrid Email] [Webhooks Stripe] ..> [Stripe API] : Écoute } note right of "スプリングブート" **Nécessaire pour :** • Gestion abonnements • Facturation récurrente • Quotas dynamiques • Analytics complexes • Webhooks fiables end note @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>評決</strong>: ハイブリッドアーキテクチャが必要です。Supabaseは基本部分に、Spring Bootはクリティカルな部分（支払い、請求）に使用します。</p> </div> </div> <div class="sect2"> <h3 id="_eコマース">Eコマース</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle package "Eコマース - 70% Spring Boot" { component "ストアフロント (JBake/React)" as frontend #SkyBlue package "サプベース" #LightGreen { [Auth Clients] [Catalogue Produits\n(lecture seule)] [Images Produits] } package "Spring Boot (コアビジネス)" #Coral { [Gestion Commandes] [Paiements Stripe] [Gestion Stock] [Calcul Frais Port] [Génération Factures] [Synchronisation ERP] [Emails Transactionnels] } cloud "統合" { [Stripe] [Transporteur API] [ERP Externe] } database "PostgreSQL" as db frontend --> [Auth Clients] frontend --> [Catalogue Produits\n(lecture seule)] frontend --> [Gestion Commandes] [Auth Clients] --> db [Catalogue Produits\n(lecture seule)] --> db [Gestion Commandes] --> db [Paiements Stripe] --> [Stripe] [Gestion Stock] --> db [Calcul Frais Port] --> [Transporteur API] [Génération Factures] --> db [Synchronisation ERP] --> [ERP Externe] [Synchronisation ERP] --> db } note right of "Spring Boot (コアビジネス)" **Spring Boot indispensable :** • Transactions critiques • Orchestration complexe • Intégrations multiples • Conformité légale • Jobs de synchronisation end note @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>判決</strong>Spring Boot は必須です。Supabase は認証とカタログのみに使用します。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_段階的移行戦略">段階的移行戦略</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE |Semaine 1-2| start :Créer projet Supabase; :Configurer Auth (Google, GitHub); :Définir schéma PostgreSQL initial; :Implémenter CRUD de base sur JBake; :Déployer MVP sur GitHub Pages; note right **Livrable :** Application fonctionnelle **Coût :** 0€ **Temps :** 1-2 semaines end note |Semaine 3-4| :Observer utilisation réelle; :Identifier limitations; |Décision| if (Logique complexe\némerge ?) then (non) |Supabase| :Continuer avec Supabase seul; :Ajouter Edge Functions si besoin; stop else (oui) |Spring Boot| :Créer projet Spring Boot; :Configurer validation JWT Supabase; :Migrer logique complexe vers Spring Boot; note right **Migration sélective** Seulement ce qui est complexe end note endif |Semaines suivantes| :Déployer Spring Boot (Cloud Run, EC2); :Connecter à PostgreSQL Supabase; :Implémenter premiers jobs planifiés; :Intégrer APIs tierces; stop note right **Architecture finale hybride** Supabase + Spring Boot en parfaite harmonie end note @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_コストおよび運用上の考慮事項">コストおよび運用上の考慮事項</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_コスト構造">コスト構造</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE package "推定月間コスト" { rectangle "MVP フェーズ (0-1000 ユーザー)" #LightGreen { [JBake (GitHub Pages): 0€] [Supabase: 0€] [Spring Boot: N/A] note bottom: **Total: 0€/mois** } rectangle "成長フェーズ\n(1k-10k ユーザー)" #LightYellow { [JBake (GitHub Pages): 0€] [Supabase: 0€] [Spring Boot (Cloud Run): 20-50€] [PostgreSQL (si séparé): 0-30€] note bottom: **Total: 20-80€/mois** } rectangle "フェーズスケール (10k-100k ユーザー)" #LightCoral { [JBake (Netlify Pro): 19€] [Supabase Pro: 25€] [Spring Boot (instances multiples): 100-300€] [Redis Cache: 20-50€] [Monitoring: 20€] note bottom: **Total: 184-414€/mois** } } note right of "フェーズスケール (10k-100k ユーザー)" À ce stade, les revenus justifient largement les coûts end note @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_運営上の責任">運営上の責任</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE package "誰が何を管理しているのか？" { rectangle "Supabase が管理 (0 労力)" #LightGreen { [Authentification] [Base de données] [Backups automatiques] [Scaling automatique] [Monitoring DB] [Sécurité DB] } rectangle "GitHubによって管理 (0 労力)" #SkyBlue { [Hébergement site statique] [HTTPS/SSL] [CDN global] [Déploiement automatique] } rectangle "管理 (Spring Boot)" #LightCoral { [Déploiement application] [Monitoring APM] [Logs centralisés] [Scaling horizontal] [Mises à jour sécurité] } } note bottom of "管理 (Spring Boot)" **Minimisable avec :** • Cloud Run (serverless) • Kubernetes (si nécessaire) • Services managés (RDS, etc.) end note @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論完璧なバランス">結論：完璧なバランス</h2> <div class="sectionbody"> <div class="paragraph"> <p>Supabase + Spring Bootのハイブリッドアーキテクチャは妥協ではなく、それは<strong>シナジー</strong>.</p> </div> <div class="sect2"> <h3 id="_覚えておくべき原則">覚えておくべき原則</h3> <div class="listingblock"> <div class="content"> <pre>@startmindmap skinparam backgroundColor #FEFEFE * Architecture\nHybride ** Commencer Simple ***_ MVP avec Supabase ***_ 0€ de coût initial ***_ Validation rapide ** Évoluer Intelligemment ***_ Ajouter Spring Boot\nsi nécessaire ***_ Migration progressive ***_ Pas de refonte totale ** Exploiter les Forces ***_ Supabase: Simplicité ***_ Spring Boot: Puissance ***_ PostgreSQL: Source unique ** Minimiser la Complexité ***_ Pas de synchronisation ***_ Pas de duplication ***_ Architecture claire ** Optimiser les Coûts ***_ Gratuit au départ ***_ Scaling progressif ***_ ROI évident @endmindmap</pre> </div> </div> </div> <div class="sect2"> <h3 id="_このアーキテクチャを選択するのはいつですか">このアーキテクチャを選択するのはいつですか？</h3> <div class="paragraph"> <p><strong>�✅ このアーキテクチャは次の場合に理想的です :</strong></p> </div> <div class="ulist"> <ul> <li> <p>すぐに始めたい(MVPは日で、月ではない)</p> </li> <li> <p>業務の複雑さが増加すると予測しています</p> </li> <li> <p>初期コストを最小限に抑えたい</p> </li> <li> <p>PostgreSQLが好きで、単一の真実のソースを望んでいます</p> </li> <li> <p>あなたはビジネスコードのためにKotlinとコルーチンが好きです</p> </li> <li> <p>あなたは完全なベンダーロックインを避けたいです</p> </li> </ul> </div> <div class="paragraph"> <p><strong>�❌ このアーキテクチャは適していない場合：</strong></p> </div> <div class="ulist"> <ul> <li> <p>あなたのプロジェクトはシンプルで、そのままです（個人ブログ → Supabase 100% で十分）</p> </li> <li> <p>あなたはすでにマスターしている確立されたバックエンドスタックを持っています</p> </li> <li> <p>あなたは伝統的なモノリスを好む</p> </li> <li> <p>.NET、Python、またはその他のバックエンド言語が必要です。</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_最終的な全体像">最終的な全体像</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE package "完全なハイブリッドアーキテクチャ" { actor "利用者" as users rectangle "フロントエンド (静的)" #SkyBlue { [JBake / GitHub Pages] note right: Gratuit, CDN global } rectangle "バックエンド シンプル (Supabase)" #LightGreen { [Auth OAuth2] [CRUD APIs] [Storage] [Realtime] note right Gratuit jusqu'à 50k users Zéro configuration serveur end note } rectangle "ビジネスバックエンド (Spring Boot)" #Coral { [Orchestration] [Jobs Planifiés] [Intégrations] [Transactions] note right Activé uniquement si nécessaire end note } database "PostgreSQL 唯一の真実のソース" as db #LightGray users --> [JBake / GitHub Pages] [JBake / GitHub Pages] --> [Auth OAuth2] [JBake / GitHub Pages] --> [CRUD APIs] [JBake / GitHub Pages] --> [Storage] [JBake / GitHub Pages] --> [Realtime] [JBake / GitHub Pages] --> [Orchestration] [Auth OAuth2] --> db [CRUD APIs] --> db [Orchestration] --> db [Jobs Planifiés] --> db [Intégrations] --> db } note bottom of db **Une seule base, deux consommateurs** • Supabase pour le simple • Spring Boot pour le complexe • Aucune synchronisation requise end note @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_両方の世界の最高">両方の世界の最高</h3> <div class="paragraph"> <p>このアーキテクチャは以下を提供します :</p> </div> <div class="paragraph"> <p><strong>�🚀 Supabaseの速度</strong></p> </div> <div class="ulist"> <ul> <li> <p>起動は時間単位で、週単位ではない</p> </li> <li> <p>OAuth2認証を数クリックで</p> </li> <li> <p>自動生成されたREST API</p> </li> <li> <p>サーバーのゼロ構成</p> </li> </ul> </div> <div class="paragraph"> <p><strong>💪 Spring Bootのパワー</strong></p> </div> <div class="ulist"> <ul> <li> <p>Kotlinとコルーチンによるエレガントな非同期コード</p> </li> <li> <p>複雑なビジネスプロセスのオーケストレーション</p> </li> <li> <p>信頼できるスケジュールされたジョブ</p> </li> <li> <p>ACIDトランザクションの保証</p> </li> <li> <p>完全なSpringエコシステム</p> </li> </ul> </div> <div class="paragraph"> <p><strong>💰 進歩的な経済</strong></p> </div> <div class="ulist"> <ul> <li> <p>0€で開始し、確認</p> </li> <li> <p>成長に追随するコスト</p> </li> <li> <p>過早なオーバーエンジニアリングはしない</p> </li> </ul> </div> <div class="paragraph"> <p><strong>�🎯 アーキテクチャの柔軟性</strong></p> </div> <div class="ulist"> <ul> <li> <p>段階的な移行、リファクタリングなし</p> </li> <li> <p>必要な場合のみSpring Bootを追加</p> </li> <li> <p>完全なベンダーロックインはありません</p> </li> <li> <p>進化するアーキテクチャ</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_さらに進む">さらに進む</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_技術的リソース">技術的リソース</h3> <div class="paragraph"> <p><strong>Supabaseドキュメント：</strong></p> </div> <div class="ulist"> <ul> <li> <p><a href="https://supabase.com/docs/guides/auth">認証ガイド</a></p> </li> <li> <p><a href="https://supabase.com/docs/guides/database/postgres/row-level-security">行レベルセキュリティ</a></p> </li> <li> <p><a href="https://supabase.com/docs/guides/api">自動生成されたAPI</a></p> </li> </ul> </div> <div class="paragraph"> <p><strong>Spring Boot ドキュメント :</strong></p> </div> <div class="ulist"> <ul> <li> <p><a href="https://spring.io/guides/tutorials/spring-boot-kotlin/">Spring Boot と Kotlin</a></p> </li> <li> <p><a href="https://spring.io/blog/2019/04/12/going-reactive-with-spring-coroutines-and-kotlin-flow">コルーチンとSpring</a></p> </li> <li> <p><a href="https://docs.spring.io/spring-security/reference/servlet/oauth2/resource-server/jwt.html">JWT リソース サーバー</a></p> </li> </ul> </div> <div class="paragraph"> <p><strong>補足記事：</strong></p> </div> <div class="ulist"> <ul> <li> <p>JWTを使用したAPIのセキュリティ</p> </li> <li> <p>PostgreSQLのパフォーマンス最適化</p> </li> <li> <p>段階的移行パターン</p> </li> <li> <p>分散アーキテクチャにおけるエラー管理</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_実際の使用例">実際の使用例</h3> <div class="paragraph"> <p>このハイブリッドアーキテクチャは、以下で正常に使用されています：</p> </div> <div class="ulist"> <ul> <li> <p><strong>SaaS B2B</strong>: 認証 Supabase, 請求 Spring Boot</p> </li> <li> <p><strong>マーケットプレイス</strong>: カタログSupabase, トランザクションSpring Boot</p> </li> <li> <p><strong>コンテンツプラットフォーム</strong>: Supabase の記事、Spring Boot の分析</p> </li> <li> <p><strong>内部ツール</strong>SupabaseのCRUD、Spring Bootのワークフロー</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_起動チェックリスト">起動チェックリスト</h3> <div class="paragraph"> <p><strong>フェーズ 1 - 基盤 (第1週)</strong></p> </div> <div class="ulist checklist"> <ul class="checklist"> <li> <p><i class="fa fa-square-o"></i> Supabaseアカウントを作成 - [ ] PostgreSQL プロジェクトを設定する - [ ] 認証を有効にする(Google, GitHub) - [ ] 初期スキーマを定義する - [ ] Row Level Security を設定 - [ ] JBakeからAPIをテストする</p> </li> </ul> </div> <div class="paragraph"> <p><strong>Phase 2 - MVP (第2-3週)</strong></p> </div> <div class="ulist checklist"> <ul class="checklist"> <li> <p><i class="fa fa-square-o"></i> 主要なページを実装する - [ ] OAuth2認証を統合する - [ ] CRUDフォームを作成 - [ ] ストレージをファイル用に設定する - [ ] GitHub Pages にデプロイする - [ ] 実際の条件でテストする</p> </li> </ul> </div> <div class="paragraph"> <p><strong>フェーズ 3 - 進化 (必要に応じて)</strong></p> </div> <div class="ulist checklist"> <ul class="checklist"> <li> <p><i class="fa fa-square-o"></i> 複雑なロジックのニーズを特定する - [ ] 必要に応じてSpring Bootプロジェクトを作成する - [ ] Supabase の JWT 検証を設定 - [ ] Supabase PostgreSQL に接続 - [ ] 複雑な機能を移行 - [ ] スケジュールされたジョブを実装する - [ ] デプロイ: Spring Boot (Cloud Run など)</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_避けるべきアンチパターン">�避けるべきアンチパターン</h3> <div class="paragraph"> <p><strong>�❌ しないでください：</strong></p> </div> <div class="ulist"> <ul> <li> <p>Supabase と Spring Boot の間でデータを複製する</p> </li> <li> <p>2つの別々のPostgreSQL データベースを作成する</p> </li> <li> <p>認証を自分でコードする</p> </li> <li> <p>Spring Boot を使用してシンプルな CRUD を行う</p> </li> <li> <p>開始からオーバーアーキテクチャーする</p> </li> <li> <p>SupabaseのRow Level Securityを無視</p> </li> </ul> </div> <div class="paragraph"> <p><strong>✅ むしろする :</strong></p> </div> <div class="ulist"> <ul> <li> <p>1つのPostgreSQLデータベースを共有</p> </li> <li> <p>Supabase に認証を任せる</p> </li> <li> <p>複雑さのためだけに Spring Boot を使用する</p> </li> <li> <p>シンプルに始め、段階的に進化させる</p> </li> <li> <p>各技術の強みを活かす</p> </li> <li> <p>データベースレベルでRLSを使用して保護する</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_進化の展望">進化の展望</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_新機能の追加">新機能の追加</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE rectangle "現代建築" #SkyBlue { [JBake] [Supabase] [Spring Boot] } rectangle "可能な進化" #LightYellow { package "パフォーマンス" { [Redis Cache] [CDN pour Assets] [PostgreSQL Replicas] } package "監視" { [Grafana] [Prometheus] [Sentry] } package "CI/CD" { [GitHub Actions] [Tests Automatisés] [Déploiement Continu] } package "機能" { [Search (ElasticSearch)] [Queue (RabbitMQ)] [Event Sourcing] } } [Spring Boot] .down.> [Redis Cache] : Peut ajouter [Spring Boot] .down.> [Queue (RabbitMQ)] : Peut ajouter [Spring Boot] .down.> [Search (ElasticSearch)] : Peut ajouter [Supabase] .down.> [PostgreSQL Replicas] : Peut ajouter note bottom **Architecture extensible** Chaque ajout est indépendant Pas de refonte globale nécessaire end note @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_水平スケーリング">水平スケーリング</h3> <div class="paragraph"> <p>アプリケーションが成長すると、ハイブリッドアーキテクチャは自然にスケールします：</p> </div> <div class="paragraph"> <p><strong>Supabase：</strong></p> </div> <div class="ulist"> <ul> <li> <p>自動的に何百万件もの操作にスケールします</p> </li> <li> <p>読み取りレプリカは読み取りパフォーマンス向上のために</p> </li> <li> <p>ポイントインタイムリカバリ（セキュリティのため）</p> </li> </ul> </div> <div class="paragraph"> <p><strong>Spring Boot：</strong></p> </div> <div class="ulist"> <ul> <li> <p>ロードバランサーの後ろの複数のインスタンス</p> </li> <li> <p>ステートレス設計は水平スケーリングを容易にする</p> </li> <li> <p>必要に応じてオーケストレーションにKubernetesを使用</p> </li> </ul> </div> <div class="paragraph"> <p><strong>PostgreSQL：</strong></p> </div> <div class="ulist"> <ul> <li> <p>大規模テーブル向けのパーティショニング</p> </li> <li> <p>接続プーリング (PgBouncer)</p> </li> <li> <p>シャーディングが本当に必要な場合（まれ）</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_建築の証言">建築の証言</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_スタートアップ_saas_50k_ユーザー">スタートアップ SaaS (50k ユーザー)</h3> <div class="paragraph"> <p><em><em>_ 私たちは100% Supabaseで始めました。 5,000ユーザーに達したとき、Stripeの請求処理と月次レポートのためにのみSpring Bootを追加しました。 1年後、私たちの運営の80%はまだSupabaseを通じて行われています。 Spring Bootは重要な部分のみを管理しています。 この分離により、リファクタリングなしでスケーリングすることができました。 </em>_</em></p> </div> </div> <div class="sect2"> <h3 id="_eラーニングプラットフォーム_10k_ユーザー">Eラーニングプラットフォーム (10k ユーザー)</h3> <div class="paragraph"> <p><em><em>_ SupabaseのOAuth2認証により、開発に3週間の短縮が実現しました。自動生成されたAPIがコースカタログ全体を管理します。Spring BootはPDF証明書と進捗メールにのみ使用されます。シンプルで保守性が高く、拡張性のあるアーキテクチャです。 </em>_</em></p> </div> </div> <div class="sect2"> <h3 id="_b2bマーケットプレイス_3kユーザー">B2Bマーケットプレイス (3kユーザー)</h3> <div class="paragraph"> <p><em><em>_ Spring Boot は買い手と売り手の間のトランザクションを管理します（重要）。Supabase はその他すべてを管理します：プロフィール、リアルタイムメッセージング、ドキュメント。同じ PostgreSQL データベースを共有しているため、複雑な同期を避けることができます。これまでで最良のアーキテクチャ選択でした。 </em>_</em></p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_サマリーモダンな建築パラダイム">サマリー：モダンな建築パラダイム</h2> <div class="sectionbody"> <div class="paragraph"> <p>Supabase + Spring Boot のハイブリッドアーキテクチャは、新たなパラダイムを表しています：<strong>建�築の専門化</strong>.</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE rectangle "旧パラダイム" #LightCoral { card "バックエンドのすべて" { [Auth] [CRUD] [Logique Métier] [Jobs] [Storage] [Realtime] } note bottom Complexité maximale dès le jour 1 end note } rectangle "新しいパラダイム" #LightGreen { card "Supabase (便利さ)" { [Auth] [CRUD Simple] [Storage] [Realtime] } card "Spring Boot (差別化)" { [Logique Métier] [Jobs] [Intégrations] } note bottom Complexité progressive ajoutée seulement si nécessaire end note } [Ancien Paradigme] -right-> [Nouveau Paradigme] : Évolution @enduml</pre> </div> </div> <div class="paragraph"> <p><strong>基本原理：</strong>既にサービスとして存在するものを構築しないでください。 あなたのアプリケーションを差別化するものに焦点を当ててください。</p> </div> <div class="sect2"> <h3 id="_8020のルール">80/20のルール</h3> <div class="paragraph"> <p>ほとんどのアプリケーション：</p> </div> <div class="ulist"> <ul> <li> <p><strong>80%の操作</strong>は標準的なCRUDです → Supabase</p> </li> <li> <p><strong>20% の操作</strong>ビジネスロジックが必要 → Spring Boot</p> </li> </ul> </div> <div class="paragraph"> <p>この自然なルールは、ハイブリッドアーキテクチャを正当化する。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam backgroundColor #FEFEFE package "操作の配分" { rectangle "80% - 標準作業" #LightGreen { [Lecture de données] [Création d'entités] [Mise à jour simple] [Suppression] [Upload fichiers] [Authentification] note bottom: **Géré par Supabase** } rectangle "20% - ビジネスロジック" #Coral { [Calculs complexes] [Workflows multi-étapes] [Transactions critiques] [Intégrations tierces] [Jobs planifiés] note bottom: **Géré par Spring Boot** } } note right **Focus optimal :** Votre temps de développement concentré sur les 20% qui différencient votre produit end note @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_最終的な結論">最終的な結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>ハイブリッドアーキテクチャは技術的な妥協ではなく、それは<strong>戦略的な決定</strong>.</p> </div> <div class="paragraph"> <p><strong>これにより、あなたは以下のことができます：</strong></p> </div> <div class="ulist"> <ul> <li> <p>�✅ 機能的なMVPで迅速に始める</p> </li> <li> <p>�✅ 大規模な投資をせずに市場を検証する</p> </li> <li> <p>�✅ 複雑さがそれを求めるとき、徐々に進化する</p> </li> <li> <p>✅ 各ステップでコストをマスターする</p> </li> <li> <p>�✅ 各テクノロジーの長所を活かす</p> </li> <li> <p>過度な設計を早期に行わない</p> </li> <li> <p>�✅ 将来のために柔軟性を保つ</p> </li> </ul> </div> <div class="paragraph"> <p><strong>彼女は表します :</strong></p> </div> <div class="ulist"> <ul> <li> <p>�🎯<strong>実用主義</strong>: 彼女が優れている各技術</p> </li> <li> <p>�🚀<strong>速度</strong>: 最小のタイム・トゥ・マーケット</p> </li> <li> <p>金袋<strong>経済</strong>: 価値に合わせたコスト</p> </li> <li> <p>�🔮<strong>スケーラビリティ</strong>あなたと共に成長するアーキテクチャ</p> </li> <li> <p>🛡️<strong>�堅牢性</strong>実証済みかつ信頼性の高いサービス</p> </li> </ul> </div> <div class="sect2"> <h3 id="_あなたの次の一歩">あなたの次の一歩</h3> <div class="paragraph"> <p>このアーキテクチャが心に響くなら、始めるべき場所はこちらです：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>Supabaseのアカウントを作成してください</strong>(無料)</p> </li> <li> <p><strong>最小のデータスキーマを設定してください</strong></p> </li> <li> <p><strong>OAuth2 認証を設定してください</strong></p> </li> <li> <p><strong>APIを消費する最初のJBakeページを作成してください</strong></p> </li> <li> <p><strong>GitHub Pagesにデプロイ</strong></p> </li> </ol> </div> <div class="paragraph"> <p>機能的なMVPが手に入ります<strong>数日</strong>.</p> </div> <div class="paragraph"> <p>Spring Boot は、必要になったときに自然とやってきます。それより前ではありません。</p> </div> <hr> <div class="paragraph"> <p><strong>ハイブリッドアーキテクチャとは、必要なときに必要なものを正確に構築する芸術だ。</strong></p> </div> <div class="paragraph"> <p><em>良い開発を！ 🚀</em></p> </div> <hr> <div class="paragraph"> <p><em>この記事を共有して、他の開発者が正しいアーキテクチャの選択をできるように手助けすると思う場合は。</em></p> </div> </div> </div> </div> https://cheroliv.com/blog/2025/0098_preloading_css_variable_post.html Sat, 15 Nov 2025 00:00:00 +0000 blog/2025/0098_preloading_css_variable_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_要約">要約</a></li> <li><a href="#_問題_この呪われたテーマの点滅">問題： この呪われたテーマの点滅</a> <ul class="sectlevel2"> <li><a href="#_ユーザーエクスペリエンスの悪夢">ユーザーエクスペリエンスの悪夢</a></li> <li><a href="#_fouc古いウェブの問題">FOUC：古いウェブの問題</a></li> <li><a href="#_品質の認識への影響">品質の認識への影響</a></li> <li><a href="#_問題の技術的分析">問題の技術的分析</a></li> </ul> </li> <li><a href="#_なぜクラシックスクリプトでは十分ではないのですか">なぜクラシックスクリプトでは十分ではないのですか？</a> <ul class="sectlevel2"> <li><a href="#_直感的だが非効率的なアプローチ">直感的だが非効率的なアプローチ</a></li> <li><a href="#_domcontentloadedイベントを理解する">DOMContentLoadedイベントを理解する</a></li> <li><a href="#_レンダーブロックの問題">レンダーブロックの問題</a></li> <li><a href="#_問題の可視化">問題の可視化</a></li> <li><a href="#_効果のない解決策の試み">�効果のない解決策の試み</a></li> <li><a href="#_本当の解決策もっと早く行動する">本当の解決策：もっと早く行動する</a></li> </ul> </li> <li><a href="#_ソリューション_早期読み込み_early_loading">ソリューション: 早期読み込み (Early Loading)</a> <ul class="sectlevel2"> <li><a href="#_基本原理">基本原理</a></li> <li><a href="#_なぜheadが理想的な場所なのか">なぜ`<head>`が理想的な場所なのか</a></li> <li><a href="#_ソリューションの3層アーキテクチャ">ソリューションの3層アーキテクチャ</a></li> </ul> </li> <li><a href="#_ステップ1ユーザーの選択を保存する">ステップ1：ユーザーの選択を保存する</a> <ul class="sectlevel2"> <li><a href="#_localstorage_あなたの永続的なメモリ">localStorage: あなたの永続的なメモリ</a></li> <li><a href="#_テーマバックアップの実装">テーマバックアップの実装</a></li> <li><a href="#_エラーケースの管理">エラーケースの管理</a></li> <li><a href="#_高度な永続性の戦略">高度な永続性の戦略</a></li> </ul> </li> <li><a href="#_ステップ2head内のプレロードスクリプト">ステップ2：`<head>`内のプレロードスクリプト</a> <ul class="sectlevel2"> <li><a href="#_解決策の中心">解決策の中心</a></li> <li><a href="#_スクリプトの解剖各行が重要">スクリプトの解剖：各行が重要</a></li> <li><a href="#_システム設定の検出_ボーナス">システム設定の検出 (ボーナス)</a></li> <li><a href="#_パフォーマンスなぜこのスクリプトは速い">パフォーマンス：なぜこのスクリプトは速い</a></li> <li><a href="#_head内の最適な配置"><head>内の最適な配置</a></li> </ul> </li> <li><a href="#_ステップ3_css属性セレクタの力">ステップ3: CSS属性セレクタの力</a> <ul class="sectlevel2"> <li><a href="#_bootstrap_5_のテーマシステム">Bootstrap 5 のテーマシステム</a></li> <li><a href="#_テーマシステム用のcss構造">テーマシステム用のCSS構造</a></li> </ul> </li> </ul> </div> <div class="sect1"> <h2 id="_要約">要約</h2> <div class="sectionbody"> <div class="paragraph"> <p>この詳細な技術記事では、ページの読み込み時に発生する不快なちらつきを伴わないテーマセレクター（light/dark）の実装方法を探ります。ブラウザのレンダリングサイクルを詳しく分析し、FOUC（Flash of Unstyled Content）の根本原因を明らかにし、同期プリロードに基づく堅牢なソリューションの`<head>`この技術は、スムーズでプロフェッショナルなユーザー体験を保証します。</p> </div> </div> </div> <div class="sect1"> <h2 id="_問題_この呪われたテーマの点滅">問題： この呪われたテーマの点滅</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_ユーザーエクスペリエンスの悪夢">ユーザーエクスペリエンスの悪夢</h3> <div class="paragraph"> <p>想像してください：あなたはウェブアプリ用の素晴らしいダークテーマを作るのに何時間も費やしました。色は完璧にバランスが取れ、コントラストは最適で、ユーザーはこのオプションを愛しています。しかし、恥ずかしげな問題があります：ページをリロードするたびに、一瞬だけデフォルトのライトテーマが表示され、それからダークテーマに切り替わります。</p> </div> <div class="paragraph"> <p>このビジュアルな"flash"は、短い（時には100ms未満）にもかかわらず、人間の目にすぐに感じ取られ、不快な体験を作り出します。視覚的な快適さやアクセシビリティのためにダークテーマを選択したユーザーにとって、このちらつきは場合によって痛みを感じるほどになり得ます。特に照明が薄い環境ではそうなります。</p> </div> </div> <div class="sect2"> <h3 id="_fouc古いウェブの問題">FOUC：古いウェブの問題</h3> <div class="paragraph"> <p>この現象は「Flash of Unstyled Content」（FOUC）と呼ばれるものの一種であり、これはウェブ開発における古典的な問題で、CSSの黎明期まで遡ります。FOUCは、ブラウザが一時的にCSSが適用されていないHTMLコンテンツを表示し、スタイルの適用されていないコンテンツのフラッシュを引き起こすときに発生します。</p> </div> <div class="paragraph"> <p>私たちの特殊なケースでは、完全にスタイルが適用されていないコンテンツではなく、むしろ<strong>間違ったテーマのフラッシュ</strong>(FOWT) - 内容はスタイルされているが、間違ったテーマが適用されている。特にイライラするのは、ページを読み込むたびにアプリがユーザーの好みを「忘れて」しまうことを示しているからだ。</p> </div> </div> <div class="sect2"> <h3 id="_品質の認識への影響">品質の認識への影響</h3> <div class="paragraph"> <p>この問題は技術的なものですが、アプリケーションの品質に対する認識に重大な影響を与えます。</p> </div> <div class="paragraph"> <p><strong>ポリッシュ不足</strong>: 点滅は、未完成あるいは最適化されていないアプリケーションであるという印象を与えます。ユーザーはしばしばこれらの小さな視覚的な欠陥を、プロフェッショナリズム全般の欠如と関連付けます。</p> </div> <div class="paragraph"> <p><strong>一貫性の欠如</strong>アプリケーションはユーザーの設定を「忘れている」ように見え、インターフェイスと期待の間にずれている感覚を作り出します。</p> </div> <div class="paragraph"> <p><strong>視覚疲労</strong>光に敏感なユーザーや片頭痛に苦しむユーザーにとって、この明るいフラッシュは単なる見た目の不快感以上の問題となる可能性があります。</p> </div> <div class="paragraph"> <p><strong>知覚されたパフォーマンス</strong>皮肉にも、サイトがすぐに読み込まれても、この点滅は遅い、または応答性の低いアプリケーションのように感じられることがあります。</p> </div> </div> <div class="sect2"> <h3 id="_問題の技術的分析">問題の技術的分析</h3> <div class="paragraph"> <p>この問題を解決する方法を理解するには、まずなぜそれが起こるのかを理解する必要があります。ウェブページのライフサイクルにおける3つのクリティカルなイベント間の時間的ずれによって、ちらつきが発生します。</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>HTMLの初期パース</strong>ブラウザはページの構造を読み込み、分析します</p> </li> <li> <p><strong>CSSスタイルの適用</strong>ブラウザはCSSのルールを適用し、視覚的レンダリングを計算します。</p> </li> <li> <p><strong>JavaScriptの実行</strong>: テーマを変更するコードが実行されます</p> </li> </ol> </div> <div class="paragraph"> <p>問題は、イベント n°3 (JavaScript の実行) が、ブラウザがすでに開始または完了したイベント n°2 (スタイルの適用) の後に到着するときに起こります。その時点では、ブラウザはどのテーマを表示するかを既に決定しており、あなたのコードは最初のレンダリング前にそれを影響するには遅すぎます。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_なぜクラシックスクリプトでは十分ではないのですか">なぜクラシックスクリプトでは十分ではないのですか？</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_直感的だが非効率的なアプローチ">直感的だが非効率的なアプローチ</h3> <div class="paragraph"> <p>開発者にとって最も自然なアプローチは、スクリプトを私たちの最後尾に配置すること`<body>`ユーザーの好みのテーマをチェックして適用する。このアプローチは、レンダリングをブロックしないようにページの最後にスクリプトを読み込むことを推奨する従来のウェブベストプラクティスに従う。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">// À la fin de <body> - L'APPROCHE INSUFFISANTE document.addEventListener('DOMContentLoaded', () => { const theme = localStorage.getItem('preferred-theme'); if (theme === 'dark') { document.documentElement.setAttribute('data-bs-theme', 'dark'); } });</code></pre> </div> </div> <div class="paragraph"> <p>このアプローチは一見論理的に見える。DOMが準備できるのを待ってから、テーマを適用する。シンプルだろう？残念ながら、このシンプルさはブラウザのレンダリングサイクルのタイミングに関連する根本的な欠陥を隠している。</p> </div> </div> <div class="sect2"> <h3 id="_domcontentloadedイベントを理解する">DOMContentLoadedイベントを理解する</h3> <div class="paragraph"> <p>イベント`DOMContentLoaded`初期のHTMLドキュメントがブラウザによって完全に読み込まれ、解析されたときにトリガーされます,<strong>待たずに</strong>スタイルシート、画像、サブフレームの読み込みの終了。 これは理解すべき重要な点です。</p> </div> <div class="paragraph"> <p>これが典型的なイベントのシーケンスです：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>ブラウザはHTMLのダウンロードを開始します</p> </li> <li> <p>彼は受信されるHTMLを逐次分析する</p> </li> <li> <p>彼はタグを見つける`<link>`CSS用にダウンロードを開始する</p> </li> <li> <p>彼はタグを見つける`<script>`それらを（その種類および属性に応じて）実行します</p> </li> <li> <p>彼は DOM (Document Object Model) を構築します。</p> </li> <li> <p><strong>イベント <code>DOMContentLoaded</code> がトリガーされます</strong></p> </li> <li> <p>彼はスタイルを適用し続け、レイアウトを作成し続けている</p> </li> <li> <p>最初のペイント（表示）が発生します</p> </li> <li> <p>イベント`load`すべてのリソースが読み込まれたときに発動します</p> </li> </ol> </div> <div class="paragraph"> <p>問題は？ステップ6（DOMContentLoaded）とステップ8（最初のペイント）の間で、ブラウザはすでにページの表示方法について決定を下しています。テーマ変更スクリプトがステップ6で実行される場合、デフォルトのスタイルでの最初の表示を避けるにはすでに遅すぎます。</p> </div> </div> <div class="sect2"> <h3 id="_レンダーブロックの問題">レンダーブロックの問題</h3> <div class="paragraph"> <p>実際、タイミングはさらに複雑です。モダンなブラウザーは、知覚されるパフォーマンスを向上させるため、高度な最適化技術を使用しています。彼らは、ユーザーが画面上で何かを見られるように、最初のペイント（First Contentful Paint）をできるだけ早く行おうとします。</p> </div> <div class="paragraph"> <p>CSSはデフォルトで"render-blocking"であり、これはブラウザがスタイルシートをダウンロードして解析するまで最初のペイントを行わないことを意味します。これは理にかなっています：スタイルが適用されていないコンテンツを表示したくないからです。</p> </div> <div class="paragraph"> <p>しかし、ここに落とし穴があります：ブラウザがこれらのCSSスタイルを初めて適用するとき、それは現在のDOMの状態に基づいて行われます。もし属性が`data-bs-theme`まだタグに定義されていません`<html>`, ブラウザはデフォルトのスタイルを適用します（通常はライトテーマ）。</p> </div> <div class="paragraph"> <p>次に、スクリプトが実行され、この属性が変更されたとき、ブラウザは：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>この変更に影響を受けるすべてのスタイルを再計算してください</p> </li> <li> <p>必要に応じてレイアウトをやり直す</p> </li> <li> <p>影響を受けた要素を塗り直す</p> </li> </ol> </div> <div class="paragraph"> <p>この再計算と再塗装のプロセスが、可視的な点滅を引き起こすものです。</p> </div> </div> <div class="sect2"> <h3 id="_問題の可視化">問題の可視化</h3> <div class="paragraph"> <p>この問題のあるシーケンスをよりよく理解するために、詳細なシーケンス図を検討しましょう：</p> </div> <div id="diag-flux-incorrect" class="listingblock"> <div class="content"> <pre>@startuml actor Utilisateur participant Navigateur participant "HTMLパーサー" as Parser participant "CSSOM" as CSS participant "Script.js (ボディの終わり)" as Script participant "レンダーエンジン" as Render Utilisateur -> Navigateur: Demande la page activate Navigateur Navigateur -> Parser: Parse le HTML activate Parser Parser -> CSS: Découvre et charge les CSS activate CSS Parser -> Parser: Construit le DOM Parser -> Navigateur: DOM Ready (DOMContentLoaded) deactivate Parser CSS -> CSS: Parse les feuilles de style CSS -> Render: CSSOM Ready deactivate CSS activate Render Render -> Render: Calcule les styles avec data-bs-theme=""note right: デフォルトテーマ (light) Render -> Navigateur: 初回ペイント (ライトテーマ) note right: ユーザーはライトテーマを見ます deactivate Render Navigateur -> Script: スクリプトを実行 activate Script Script -> Script: localStorageを読む Script -> Navigateur: setAttribute('data-bs-theme', 'dark') deactivate Script activate Render Render -> Render: data-bs-themeを含むスタイルを再計算"dark" note right: Thème sombre Render -> Navigateur: Repaint (Thème Sombre) note right: Clignotement visible deactivate Render deactivate Navigateur @enduml</pre> </div> </div> <div class="paragraph"> <p>この図は問題をはっきりと示しています：最初のペイントは、スクリプトが正しいテーマを設定する機会を得る前に発生します。その後のリペイントが目に見えるちらつきを引き起こします。</p> </div> </div> <div class="sect2"> <h3 id="_効果のない解決策の試み">�効果のない解決策の試み</h3> <div class="paragraph"> <p>この問題を解決しようといくつかのアプローチが試みられましたが、ほとんどのものはそれぞれ固有の欠点があります：</p> </div> <div class="paragraph"> <p><strong>方法1：読み込み完了までコンテンツを隠す</strong></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">body { opacity: 0; transition: opacity 0.3s; } body.loaded { opacity: 1; }</code></pre> </div> </div> <div class="paragraph"> <p>このアプローチは、JavaScriptが正しいテーマを設定するまで、すべてのコンテンツを隠します。問題点は？これは人工的にコンテンツの表示を遅らせ、サイトが遅く感じられる印象を与えます。さらに、JavaScriptが無効になっている場合、ユーザーは何も見ることができません！</p> </div> <div class="paragraph"> <p><strong>アプローチ 2：ローダー/スピナーを使用する</strong></p> </div> <div class="paragraph"> <p>アプローチ 1 と同様ですが、ローディングスピナーがあります。これは問題を隠すだけで、実際のパフォーマンスは改善せず、無駄な知覚的な遅延を追加します。</p> </div> <div class="paragraph"> <p><strong>アプローチ3：暗いテーマをデフォルトにする</strong></p> </div> <div class="paragraph"> <p>一部の開発者はCSSでダークテーマをデフォルトに設定します。これにより、ダークテーマユーザーのちらつきは防げますが、ライトテーマユーザーには逆に問題が発生します！</p> </div> <div class="paragraph"> <p>これらのアプローチのいずれも満足できるものではなく、問題の根本原因ではなく症状に対処しているからです。</p> </div> </div> <div class="sect2"> <h3 id="_本当の解決策もっと早く行動する">本当の解決策：もっと早く行動する</h3> <div class="paragraph"> <p>この問題を解決する鍵は、属性を設定する必要があることに気づくことです`data-bs-theme` <strong>前</strong>ブラウザがCSSスタイルを適用し始める前に。これは、私たちのスクリプトがページのライフサイクルの中でより早く実行される必要があることを意味します。そして、これは次のセクションで探求するまさにそれです。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ソリューション_早期読み込み_early_loading">ソリューション: 早期読み込み (Early Loading)</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_基本原理">基本原理</h3> <div class="paragraph"> <p>私たちの点滅問題のエレガントな解決策は、シンプルだが強力な原理に基づいています：<strong>アプリケーションの状態をブラウザのレンダリングプロセスと同期する</strong>.代わりに、ページが読み込まれるのを待ってテーマを設定するのではなく、テーマを設定する必要があります。<strong>の間に</strong>読み込み、CSSスタイルが適用される前でも</p> </div> <div class="paragraph"> <p>このアプローチは、ウェブ開発の用語で「Early Loading」または「Synchronous Preloading」と呼ばれます。このアイデアは、ページのライフサイクルにおいて可能な限り早くテーマ検出ロジックを実行し、理想的にはタグ内で行うことです。<code><head></code>, ブラウザが CSS ファイルのダウンロードを開始するよりも前に</p> </div> </div> <div class="sect2"> <h3 id="_なぜheadが理想的な場所なのか">なぜ`<head>`が理想的な場所なのか</h3> <div class="paragraph"> <p>Le `<head>`HTMLドキュメントはブラウザによって上から下へと順に処理されます。各要素は表示される順序で処理されます。この特性は私たちのソリューションにとって重要です。</p> </div> <div class="paragraph"> <p>ブラウザがタグに遭遇するとき`<script>`中の`<head>`属性なし`async` ou <code>defer</code>, il :</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>HTML のパースを中断する</strong></p> </li> <li> <p><strong>スクリプトをダウンロード</strong>(外部の場合)またはベッド(インラインの場合)</p> </li> <li> <p><strong>すぐにスクリプトを実行して</strong></p> </li> <li> <p><strong>HTMLのパースを再開する</strong></p> </li> </ol> </div> <div class="paragraph"> <p>この動作は、しばしばパフォーマンスの問題と見なされる（そのため、ページの最後にスクリプトを配置するという通常の推奨がある）が、この場合は私たちの味方となる。私たちのテーマ検出スクリプトをページの先頭に`<head>`, 私たちはそれがブラウザーがタグに出会う前に実行されることを保証します`<link>`私たちのスタイルシートの。</p> </div> </div> <div class="sect2"> <h3 id="_ソリューションの3層アーキテクチャ">ソリューションの3層アーキテクチャ</h3> <div class="paragraph"> <p>私たちの完全なソリューションは、相互に依存する3つの層から構成されており、それぞれが特定の役割を果たします：</p> </div> <div class="paragraph"> <p><strong>層 1 : 永続性 (localStorage)</strong> この層は、セッション間でユーザーの選択を保存および取得する役割を担っています。</p> </div> <div class="paragraph"> <p><strong>レイヤー 2: 早期同期（`<head>`内のインラインスクリプト）</strong> このレイヤーは、初期レンダリング前にアプリケーションの状態とDOMを同期します。</p> </div> <div class="paragraph"> <p><strong>レイヤー3:レスポンシブスタイル (属性セレクタを使ったCSS)</strong> このレイヤーは、レイヤー2で定義された状態に基づいてビジュアルスタイルを定義します。</p> </div> <div class="paragraph"> <p>それでは、各層を詳細に調べていきましょう。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ステップ1ユーザーの選択を保存する">ステップ1：ユーザーの選択を保存する</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_localstorage_あなたの永続的なメモリ">localStorage: あなたの永続的なメモリ</h3> <div class="paragraph"> <p>Le <code>localStorage`は、ブラウザにキーと値のペアを永続的に保存できる Web Storage API です。 Cookie とは異なり、データは`localStorage</code> :</p> </div> <div class="ulist"> <ul> <li> <p>サーバーには決して自動的に送信されません</p> </li> <li> <p>ストレージ容量が大きい（通常は5-10MB）</p> </li> <li> <p>有効期限がなく（明示的に削除されるまで継続）</p> </li> <li> <p>プロトコルとドメインに制限されます (Same-Origin Policy)</p> </li> </ul> </div> <div class="paragraph"> <p>私たちのユースケースでは、`localStorage`完璧です。なぜなら：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>私たちはこの情報をサーバーと共有する必要はありません</p> </li> <li> <p>私たちが望むのは、その好みが永遠に続くことです。</p> </li> <li> <p>必要なストレージサイズは最小限です (数バイト)</p> </li> </ol> </div> </div> <div class="sect2"> <h3 id="_テーマバックアップの実装">テーマバックアップの実装</h3> <div class="paragraph"> <p>ユーザーがテーマを変更するときの選択を保存する方法は次の通りです：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">// Fonction complète pour changer le thème function setTheme(newTheme) { // Validation de l'entrée if (!['light', 'dark', 'auto'].includes(newTheme)) { console.error('Thème invalide:', newTheme); return; } try { // Sauvegarde dans localStorage localStorage.setItem('preferred-theme', newTheme); // Application immédiate dans le DOM document.documentElement.setAttribute('data-bs-theme', newTheme); // Dispatch d'un événement personnalisé pour notifier d'autres composants window.dispatchEvent(new CustomEvent('theme-changed', { detail: { theme: newTheme } })); console.log('Thème changé:', newTheme); } catch (error) { console.error('Erreur lors de la sauvegarde du thème:', error); // Fallback : on applique quand même le thème visuellement document.documentElement.setAttribute('data-bs-theme', newTheme); } } // Exemple d'utilisation avec un bouton document.getElementById('theme-toggle').addEventListener('click', () => { const currentTheme = document.documentElement.getAttribute('data-bs-theme') || 'light'; const newTheme = currentTheme === 'light' ? 'dark' : 'light'; setTheme(newTheme); });</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_エラーケースの管理">エラーケースの管理</h3> <div class="paragraph"> <p>レのケースを処理することは重要です`localStorage`利用できないか、アクセスできない可能性があります。いくつかのシナリオがへのアクセスを妨げる可能性があります`localStorage`(No content to translate, so output nothing.)</p> </div> <div class="paragraph"> <p><strong>�厳格なプライベートナビゲーション</strong>: Safariのプライベートブラウジングモードで例外が発生します`QuotaExceededError`書き込みを試みる際の`localStorage`.</p> </div> <div class="paragraph"> <p><strong>プライバシー設定</strong>一部のブラウザまたはプライバシー拡張機能は、アクセスをブロックする可能性があります`localStorage`。</p> </div> <div class="paragraph"> <p><strong>ドメインの制限</strong> : Le `localStorage`プロトコル上ではアクセスできません`file://`一部のブラウザでは。</p> </div> <div class="paragraph"> <p><strong>ストレージの容量がいっぱいです</strong>稀ではありますが、ストレージスペースは完全に満たされることがあります。</p> </div> <div class="paragraph"> <p>それが、私たちのコードがブロックを使用する理由です。`try…​catch`これらのケースを優雅に処理し、永続性が利用できない場合でもテーマ変更機能を提供し続ける</p> </div> </div> <div class="sect2"> <h3 id="_高度な永続性の戦略">高度な永続性の戦略</h3> <div class="paragraph"> <p>より高度なアプリケーションの場合、追加の戦略を検討することができます：</p> </div> <div class="paragraph"> <p><strong>サーバー同期（オプション）</strong></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">async function setTheme(newTheme) { // Sauvegarde locale immédiate localStorage.setItem('preferred-theme', newTheme); document.documentElement.setAttribute('data-bs-theme', newTheme); // Synchronisation serveur en arrière-plan (si l'utilisateur est connecté) if (userIsAuthenticated()) { try { await fetch('/api/user/preferences', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ theme: newTheme }) }); } catch (error) { console.warn('Échec de la synchronisation serveur:', error); // L'échec n'est pas critique car la préférence est déjà sauvegardée localement } } }</code></pre> </div> </div> <div class="paragraph"> <p>このアプローチは、接続されているユーザーの好みをデバイス間で同期し、同時に即時のローカル応答性を維持します。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ステップ2head内のプレロードスクリプト">ステップ2：`<head>`内のプレロードスクリプト</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_解決策の中心">解決策の中心</h3> <div class="paragraph"> <p>ここで魔法が本当に働きます。私たちは小さなスクリプトを配置するつもりです。<strong>インライン</strong>直接私たちの`<head>`, すべてのタグの前に`<link>`スタイルシートの。このスクリプトは意図的にミニマルで、自立しており、できるだけ早く実行されるように設計されています。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Mon Site Incroyable</title> <!-- ========================================== NOTRE SCRIPT MAGIQUE DE PRÉ-CHARGEMENT Ce script DOIT être le premier élément dans le <head> après les meta tags ========================================== --> <script> // IIFE pour ne pas polluer le scope global (function() { 'use strict'; try { // Lecture de la préférence sauvegardée const savedTheme = localStorage.getItem('preferred-theme'); // Si une préférence existe, on l'applique immédiatement if (savedTheme) { document.documentElement.setAttribute('data-bs-theme', savedTheme); } // Optionnel : Détecter la préférence système si aucune sauvegarde else if (window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches) { document.documentElement.setAttribute('data-bs-theme', 'dark'); } // Sinon, le thème par défaut du CSS sera utilisé (généralement 'light') } catch (error) { // En cas d'erreur (localStorage bloqué, etc.), on log discrètement // et on laisse le thème par défaut s'appliquer console.warn('Impossible de charger la préférence de thème:', error); } })(); </script> <!-- FIN DU SCRIPT MAGIQUE --> <!-- Les feuilles de style sont chargées APRÈS le script --> <link rel="stylesheet" href="css/bootstrap.min.css"> <link rel="stylesheet" href="css/styles.css"> <!-- Autres ressources du head --> <link rel="icon" href="favicon.ico"> </head> <body> <!-- Contenu de la page --> </body> </html></code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_スクリプトの解剖各行が重要">スクリプトの解剖：各行が重要</h3> <div class="paragraph"> <p>このスクリプトを一行ずつ分解して、各設計上の決定を理解しましょう：</p> </div> <div class="paragraph"> <p><strong>IIFE（即時実行関数式）</strong></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">(function() { // ... })();</code></pre> </div> </div> <div class="paragraph"> <p>この構造は即時実行される関数を作成します。なぜ？ローカルスコープで変数を隔離し、グローバルスコープを汚染しないようにするためです。たとえ私たちが使っているのはこれだけでも`const`(ブロックスコープを持つ), IIFEは良いプラクティスであり、私たちの意図を明確にし、名前の衝突から保護します。</p> </div> <div class="paragraph"> <p><strong>Strictモード</strong></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">'use strict';</code></pre> </div> </div> <div class="paragraph"> <p>このディレクティブは JavaScript の厳格モードを有効にし、： - 未宣言の変数の使用を禁止する - 危険な操作に対してエラーを生成する - 一部のJavaScriptエンジンでパフォーマンスが向上します</p> </div> <div class="paragraph"> <p>重要なスクリプトの場合、最大限のセキュリティが必要です。</p> </div> <div class="paragraph"> <p><strong>try…​catch ブロック</strong></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">try { // Code principal } catch (error) { console.warn('Impossible de charger la préférence de thème:', error); }</code></pre> </div> </div> <div class="paragraph"> <p>このブロックは絶対に重要です。これは、localStorage がブロックされたり、考えにくい構文エラーが発生したりなど、何らかの問題が発生しても、スクリプトがページ全体の読み込みを妨げないことを保証します。使用する`console.warn`むしろ`console.error`これは重大でない問題であることを示します。</p> </div> <div class="paragraph"> <p><strong>localStorageの読み取り</strong></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">const savedTheme = localStorage.getItem('preferred-theme');</code></pre> </div> </div> <div class="paragraph"> <p>この行は特定のコンテキスト（Safariの厳格なプライベートブラウジング）で例外をスローする可能性があるため、try…​catch ブロック内に置かれています。</p> </div> <div class="paragraph"> <p><strong>条件付きアプリケーション</strong></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">if (savedTheme) { document.documentElement.setAttribute('data-bs-theme', savedTheme); }</code></pre> </div> </div> <div class="paragraph"> <p>保存されたテーマを見つけた場合のみ、そのテーマを適用します。そうでない場合は、CSSがデフォルトのテーマを使用するようにします。このアプローチは、JavaScriptにハードコーディングされたデフォルト値よりも堅牢です。</p> </div> </div> <div class="sect2"> <h3 id="_システム設定の検出_ボーナス">システム設定の検出 (ボーナス)</h3> <div class="paragraph"> <p>オプションだがエレガントな改善は、ユーザーがまだアプリ内で明示的な選択をしていない場合、オペレーティングシステムのテーマ設定を検出することです:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">else if (window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches) { document.documentElement.setAttribute('data-bs-theme', 'dark'); }</code></pre> </div> </div> <div class="paragraph"> <p>この機能はメディアクエリを使います`prefers-color-scheme`システムを問い合わせるため。macOS、Windows 10+、iOS、および最新のAndroidでは、このクエリはユーザーのシステム設定を返します。</p> </div> <div class="paragraph"> <p><strong>利点：</strong> 初めての訪問からのパーソナライズドな体験 - ユーザーのシステム環境との整合性 - 初回訪問にストレージは必要ありません</p> </div> <div class="paragraph"> <p><strong>考慮事項 :</strong> - すべてのブラウザーがこの機能をサポートしているわけではない（ただし、2020年以降サポートは非常に優れている） - 検証`window.matchMedia`互換性を確保する - ユーザーは常にこの選択を上書きできます</p> </div> </div> <div class="sect2"> <h3 id="_パフォーマンスなぜこのスクリプトは速い">パフォーマンス：なぜこのスクリプトは速い</h3> <div class="paragraph"> <p>私たちのプリロードスクリプトは、非常に高速に動作するように設計されています：</p> </div> <div class="paragraph"> <p><strong>最小サイズ</strong>約300バイト（未圧縮）、200バイト（圧縮後）。これは、どの画像やJavaScriptライブラリに比べても無視できる程度です。</p> </div> <div class="paragraph"> <p><strong>インライン</strong>追加の HTTP リクエストはありません。スクリプトは HTML に組み込まれているため、すぐに利用できます。</p> </div> <div class="paragraph"> <p><strong>シンプルな同期操作</strong>localStorageからキーを読み取る（超高速な操作）と、DOM属性を変更する（ブラウザのネイティブな操作）.</p> </div> <div class="paragraph"> <p><strong>依存関係なし</strong>: フレームワークもライブラリもなく、ただのバニラJavaScriptだけ。起動時間も依存のパースもなし。</p> </div> <div class="paragraph"> <p><strong>一度だけの実行</strong>: このスクリプトはロード時に1回だけ実行されます。イベントリスナーもループも複雑な計算もありません。</p> </div> <div class="paragraph"> <p>実際に、最新のハードウェアでは、このスクリプトは1ミリ秒未満で実行され、ページの読み込みパフォーマンスに影響を与えないほどの無視できる時間です。</p> </div> </div> <div class="sect2"> <h3 id="_head内の最適な配置"><head>内の最適な配置</h3> <div class="paragraph"> <p>要素の順序は`<head>`重要です。おすすめの順序は次のとおりです：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><head> <!-- 1. Métadonnées critiques --> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <!-- 2. Notre script de pré-chargement (IMMÉDIATEMENT après les meta) --> <script> (function() { /* notre code */ })(); </script> <!-- 3. Titre de la page --> <title>Mon Site</title> <!-- 4. Feuilles de style --> <link rel="stylesheet" href="styles.css"> <!-- 5. Autres ressources (fonts, favicons, etc.) --> <link rel="preconnect" href="https://fonts.googleapis.com"> <link rel="icon" href="favicon.ico"> <!-- 6. Autres scripts avec defer ou async --> <script src="app.js" defer></script> </head></code></pre> </div> </div> <div class="paragraph"> <p>この注文は次のことを保証します：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>charsetはテキスト処理の前に定義される</p> </li> <li> <p>私たちのスクリプトはCSSの読み込み前に実行されます</p> </li> <li> <p>CSSはその後読み込まれ、正しいテーマを直接適用します。</p> </li> <li> <p>その他の非クリティカルなリソースは最後に読み込まれます</p> </li> </ol> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ステップ3_css属性セレクタの力">ステップ3: CSS属性セレクタの力</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_bootstrap_5_のテーマシステム">Bootstrap 5 のテーマシステム</h3> <div class="paragraph"> <p>Bootstrap 5はCSSカスタムプロパティ（CSS変数）および属性セレクターに基づいたエレガントなテーマ管理システムを導入しました。このシステムは属性`data-bs-theme`要素の上に`<html>`どの色変数のセットを適用するかを決定するために。</p> </div> <div class="paragraph"> <p>このシステムの美しさはそのシンプルさにあります：数千の要素に対して異なるスタイルシートをロードしたり、クラスの切り替えを行ったりする代わりに、単一の要素の属性を変更するだけで、CSSがカスケードによって残りを処理します。</p> </div> </div> <div class="sect2"> <h3 id="_テーマシステム用のcss構造">テーマシステム用のCSS構造</h3> <div class="paragraph"> <p>「堅牢なテーマシステムを実装するための完全なCSS構造」</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">/** * SYSTÈME DE THÈME COMPLET * Utilise les Custom Properties CSS pour une maintenance facile */ /* ============================================ THÈME PAR DÉFAUT (LIGHT) Défini sur :root pour être le fallback ============================================ */ :root { /* Couleurs de base */ --color-primary: #0d6efd; --color-secondary: #6c757d; --color-success: #198754; --color-danger: #dc3545; --color-warning: #ffc107; --color-info: #0dcaf0; /* Couleurs de fond */ --bg-primary: #ffffff; --bg-secondary: #f8f9fa; --bg-tertiary: #e9ecef; /* Couleurs de texte */ --text-primary: #212529; --text-secondary: #6c757d; --text-tertiary: #adb5bd; /* Couleurs de bordure */ --border-color: #dee2e6; --border-color-subtle: #e9ecef; /* Couleurs d'ombre */ --shadow-sm: rgba(0, 0, 0, 0.075); --shadow-md: rgba(0, 0, 0, 0.15); --shadow-lg: rgba(0, 0, 0, 0.25</code></pre> </div> </div> </div> </div> </div> https://cheroliv.com/blog/2025/0097_gradle_plugin_dev_func_test_logger_post.html Fri, 7 Nov 2025 00:00:00 +0000 blog/2025/0097_gradle_plugin_dev_func_test_logger_post.html <div id="toc" class="toc"> <div id="toctitle">Table of Contents</div> <ul class="sectlevel1"> <li><a href="#_はじめに">はじめに</a></li> <li><a href="#_問題_gradlerunnerへの依存">問題: GradleRunnerへの依存</a> <ul class="sectlevel2"> <li><a href="#_プラグイン開発のコンテキスト">プラグイン開発のコンテキスト</a></li> <li><a href="#_ロギングのジレンマ">ロギングのジレンマ</a></li> <li><a href="#_誤った良いアイデア">�誤った良いアイデア</a></li> </ul> </li> <li><a href="#_ソリューション_独立ロガー">ソリューション: 独立ロガー</a> <ul class="sectlevel2"> <li><a href="#_推奨アーキテクチャ">推奨アーキテクチャ</a></li> <li><a href="#_実行フロー">実行フロー</a></li> </ul> </li> <li><a href="#_完全実装">完全実装</a> <ul class="sectlevel2"> <li><a href="#_gradleの依存関係">Gradleの依存関係</a></li> <li><a href="#_設定_logback">設定 Logback</a></li> <li><a href="#_完全なテストクラス">完全なテストクラス</a></li> </ul> </li> <li><a href="#_マルチレベルログスキーム">マルチレベルログスキーム</a></li> <li><a href="#_ベストプラクティス">ベストプラクティス</a> <ul class="sectlevel2"> <li><a href="#_推奨されるロギング構造">推奨されるロギング構造</a></li> <li><a href="#_可読性のための視覚的なシンボル">可読性のための視覚的なシンボル</a></li> <li><a href="#_出力からの情報抽出">出力からの情報抽出</a></li> </ul> </li> <li><a href="#_比較_前後">比較 前後</a> <ul class="sectlevel2"> <li><a href="#_前問題のあるアプローチ">前：問題のあるアプローチ</a></li> <li><a href="#_後_頑健なアプローチ">後 : 頑健なアプローチ</a></li> </ul> </li> <li><a href="#_サマリーダイアグラム">サマリーダイアグラム</a></li> <li><a href="#_避けるべき罠">�避けるべき罠</a> <ul class="sectlevel2"> <li><a href="#_罠1忘れる_forwardoutput">�❌ 罠1：忘れる `.forwardOutput()</a></li> <li><a href="#_罠_2番_ロガー_未初期化">�❌ 罠 2番 : ロガー 未初期化</a></li> <li><a href="#_罠_3_過剰なログ">�❌ 罠 3 : 過剰なログ</a></li> </ul> </li> <li><a href="#_結果とメトリクス">結果とメトリクス</a></li> <li><a href="#_結論">結論</a></li> <li><a href="#_資源">資源</a></li> <li><a href="#_もっと先へ">もっと先へ</a></li> </ul> </div> <div class="sect1"> <h2 id="_はじめに">はじめに</h2> <div class="sectionbody"> <div class="paragraph"> <p>Gradleプラグインの開発中、機能テストはGradleの実際の環境でのプラグインの動作を検証するために不可欠です。しかし、重要な質問がすぐに浮上します：<strong>どのようにすれば <code>GradleRunner</code> と問題のある依存関係を作らずに効果的なロギングシステムを構築できますか？</strong></p> </div> <div class="paragraph"> <p>この記事では、次のことを探求します：</p> </div> <div class="ulist"> <ul> <li> <p>Gradleの機能テストにおけるロギングの問題</p> </li> <li> <p>SLF4J と Logback を使用した堅牢なソリューションのアーキテクチャ</p> </li> <li> <p>具体的な例を含む完全な実装</p> </li> <li> <p>良いプラクティスと避けるべき罠</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_問題_gradlerunnerへの依存">問題: GradleRunnerへの依存</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_プラグイン開発のコンテキスト">プラグイン開発のコンテキスト</h3> <div class="paragraph"> <p>Gradleプラグインを開発する際には、通常、`GradleRunner`<em>Gradle TestKit</em> を使用してテストビルドを実行する :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `test my plugin`() { val result = GradleRunner.create() .withProjectDir(projectDir) .withArguments("myTask") .build() // Comment logger efficacement ici ? }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ロギングのジレンマ">ロギングのジレンマ</h3> <div class="paragraph"> <p>主な問題は次のとおりです：<strong>ロギングは、初期化が確実でないオブジェクトに依存してはならない。</strong>。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml !define RECTANGLE class skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle package "問題的アーキテクチャ" { RECTANGLE Test { + runTest() } RECTANGLE GradleRunner { + build() + getLogger() ❌ } RECTANGLE Logger { + info() + debug() } Test --> GradleRunner : dépend de Logger ..> GradleRunner : dépend de ❌ } note right of Logger Problème: Le logger dépend du GradleRunner qui peut ne pas être initialisé end note @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_誤った良いアイデア">�誤った良いアイデア</h3> <div class="admonitionblock warning"> <table> <tr> <td class="icon"> <i class="fa icon-warning" title="Warning"></i> </td> <td class="content"> <div class="paragraph"> <p><strong>これをしないでください :</strong></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// ❌ MAUVAIS: Tentative d'obtenir un logger du runner val runner = GradleRunner.create() val logger = runner.logger // N'existe pas ! // ❌ MAUVAIS: Logger partagé initialisé tardivement lateinit var logger: Logger @BeforeEach fun setup() { logger = LoggerFactory.getLogger(...) }</code></pre> </div> </div> </td> </tr> </table> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ソリューション_独立ロガー">ソリューション: 独立ロガー</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_推奨アーキテクチャ">推奨アーキテクチャ</h3> <div class="paragraph"> <p>解決策はロガーを使用することである<strong>完全に独立</strong> du <code>GradleRunner</code>, テストクラスレベルで初期化された</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml !define RECTANGLE class skinparam backgroundColor #FEFEFE skinparam componentStyle rectangle package "正しいアーキテクチャ" { RECTANGLE TestClass { + {static} logger: Logger ✓ + runTest() } RECTANGLE SLF4J { + LoggerFactory } RECTANGLE GradleRunner { + build() + forwardOutput() } RECTANGLE "コンソール出力" as Output { + captured text } TestClass --> SLF4J : utilise ✓ TestClass --> GradleRunner : utilise GradleRunner --> Output : génère TestClass --> Output : analyse } note top of TestClass Le logger est initialisé indépendamment du GradleRunner end note note bottom of GradleRunner .forwardOutput() permet de capturer la sortie pour analyse end note @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_実行フロー">実行フロー</h3> <div class="listingblock"> <div class="content"> <pre>@startuml !theme plain skinparam backgroundColor #FEFEFE participant "JUnit" as junit participant "テストクラス" as test participant "ロガー (SLF4J)" as logger participant "GradleRunner" as runner participant "Gradle ビルド" as gradle activate junit junit -> test : load class activate test test -> logger : initialize (companion) activate logger logger --> test : logger ready ✓ deactivate logger junit -> test : @BeforeAll test -> logger : info("Initialisation...") junit -> test : @BeforeEach test -> logger : debug("セットアップテスト...") junit -> test : @Test test -> logger : info("開始...") test -> runner : create() activate runner test -> runner : .forwardOutput() test -> runner : .withArguments(...) test -> runner : .build() runner -> gradle : execute build activate gradle gradle --> runner : output text deactivate gradle runner --> test : BuildResult + output deactivate runner test -> logger : debug("出力を分析中...") test -> test : analyze output test -> logger : info("�✓ テストに合格しました") test --> junit : success deactivate test deactivate junit @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_完全実装">完全実装</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_gradleの依存関係">Gradleの依存関係</h3> <div class="paragraph"> <p>必要な依存関係をあなたのに追加してください`build.gradle.kts`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">dependencies { // Pour les tests fonctionnels testImplementation(gradleTestKit()) testImplementation("org.junit.jupiter:junit-jupiter:5.10.2") // Pour le logging testImplementation("org.slf4j:slf4j-api:2.0.17") testRuntimeOnly("ch.qos.logback:logback-classic:1.4.14") // Pour les assertions testImplementation("org.assertj:assertj-core:3.27.6") } tasks.test { useJUnitPlatform() }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_設定_logback">設定 Logback</h3> <div class="paragraph"> <p>ファイルを作成してください`src/test/resources/logback-test.xml`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><?xml version="1.0" encoding="UTF-8"?> <configuration> <!-- Appender console avec format lisible --> <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"> <encoder> <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern> </encoder> </appender> <!-- Appender fichier pour conservation --> <appender name="FILE" class="ch.qos.logback.core.FileAppender"> <file>build/test-results/functional-tests.log</file> <encoder> <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern> </encoder> </appender> <!-- Logger pour vos tests --> <logger name="com.cheroliv.bakery" level="DEBUG"/> <!-- Réduire le bruit de Gradle --> <logger name="org.gradle" level="WARN"/> <!-- Configuration racine --> <root level="INFO"> <appender-ref ref="STDOUT"/> <appender-ref ref="FILE"/> </root> </configuration></code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_完全なテストクラス">完全なテストクラス</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">package com.cheroliv.bakery import org.gradle.testkit.runner.GradleRunner import org.gradle.testkit.runner.TaskOutcome import org.junit.jupiter.api.* import org.junit.jupiter.api.TestInstance.Lifecycle.PER_CLASS import org.junit.jupiter.api.io.TempDir import org.slf4j.Logger import org.slf4j.LoggerFactory import java.io.File import kotlin.test.assertEquals import kotlin.test.assertTrue @TestInstance(PER_CLASS) class BakeryPluginFunctionalTest { @field:TempDir lateinit var projectDir: File private val buildFile by lazy { projectDir.resolve("build.gradle.kts") } private val settingsFile by lazy { projectDir.resolve("settings.gradle.kts") } companion object { // ✓ Logger indépendant, initialisé au chargement de la classe private val logger: Logger = LoggerFactory.getLogger( BakeryPluginFunctionalTest::class.java ) @JvmStatic @BeforeAll fun globalSetup() { logger.info("═".repeat(60)) logger.info("DÉMARRAGE DE LA SUITE DE TESTS FONCTIONNELS") logger.info("═".repeat(60)) } @JvmStatic @AfterAll fun globalTeardown() { logger.info("═".repeat(60)) logger.info("FIN DE LA SUITE DE TESTS") logger.info("═".repeat(60)) } } @BeforeEach fun setup() { logger.info("─".repeat(60)) logger.info("Préparation de l'environnement de test") logger.debug("Répertoire de test: ${projectDir.absolutePath}") settingsFile.writeText(""" rootProject.name = "test-bakery-project" """.trimIndent()) logger.debug("✓ settings.gradle.kts créé") } @AfterEach fun teardown(testInfo: TestInfo) { logger.info("✓ Test terminé: ${testInfo.displayName}") logger.info("─".repeat(60)) } @Test fun `plugin can be applied successfully`() { logger.info("TEST: Application du plugin Bakery") buildFile.writeText(""" plugins { id("com.cheroliv.bakery") } """.trimIndent()) logger.debug("Fichier build.gradle.kts créé") logger.debug("Lancement du build Gradle...") val startTime = System.currentTimeMillis() val result = GradleRunner.create() .forwardOutput() // ← Important : capture la sortie .withPluginClasspath() .withArguments("tasks", "--group=bakery", "--stacktrace") .withProjectDir(projectDir) .build() val duration = System.currentTimeMillis() - startTime logger.info("Build terminé en ${duration}ms") // Analyse de la sortie logger.debug("Analyse de la sortie Gradle...") val outputLines = result.output.lines() logger.debug("Nombre de lignes capturées: ${outputLines.size}") // Validation val expectedTasks = listOf("bake", "printConfigPath", "printJBakeClasspath") logger.info("Vérification des tâches attendues:") expectedTasks.forEach { task -> val found = result.output.contains(task) logger.debug(" ${if (found) "✓" else "✗"} $task") assertTrue(found, "Task '$task' should be available") } logger.info("✓ Plugin appliqué avec succès - ${expectedTasks.size} tâches trouvées") } @Test fun `bake task executes and prints version`() { logger.info("TEST: Exécution de la tâche 'bake'") buildFile.writeText(""" plugins { id("com.cheroliv.bakery") } """.trimIndent()) logger.debug("Exécution de 'gradle bake'...") val result = GradleRunner.create() .forwardOutput() .withPluginClasspath() .withArguments("bake", "--info") // --info pour plus de détails .withProjectDir(projectDir) .build() // Extraction d'informations depuis la sortie logger.debug("Recherche du message 'Baking site'...") val hasBakingMessage = result.output.contains("Baking site with Bakery Plugin!") logger.debug("Recherche de la version JBake...") val hasVersionMessage = result.output.contains("Using JBake version:") // Extraction de la version (si présente) val versionRegex = Regex("Using JBake version: (.+)") val versionMatch = versionRegex.find(result.output) if (versionMatch != null) { val version = versionMatch.groupValues[1] logger.info("Version JBake détectée: $version") } // Validation assertTrue(hasBakingMessage, "Message 'Baking site' attendu") assertTrue(hasVersionMessage, "Message de version attendu") assertEquals(TaskOutcome.SUCCESS, result.task(":bake")?.outcome) logger.info("✓ Tâche 'bake' exécutée avec succès") } @Test fun `analyze output with structured logging`() { logger.info("TEST: Analyse structurée de la sortie") buildFile.writeText(""" plugins { id("com.cheroliv.bakery") } task("diagnostics") { doLast { println("[DIAG] Project: ${'$'}{project.name}") println("[DIAG] Build dir: ${'$'}{project.buildDir}") println("[DIAG] Plugin applied: true") val config = configurations.findByName("jbakeRuntime") println("[DIAG] JBake config exists: ${'$'}{config != null}") if (config != null) { println("[DIAG] Dependencies count: ${'$'}{config.dependencies.size}") } } } """.trimIndent()) logger.debug("Exécution de la tâche diagnostics...") val result = GradleRunner.create() .forwardOutput() .withPluginClasspath() .withArguments("diagnostics", "--quiet") .withProjectDir(projectDir) .build() // Analyse structurée logger.info("Extraction des informations de diagnostic:") val diagLines = result.output.lines() .filter { it.startsWith("[DIAG]") } logger.debug("Nombre de lignes de diagnostic: ${diagLines.size}") diagLines.forEach { line -> logger.info(" $line") // Analyse spécifique par type de ligne when { line.contains("Project:") -> { val projectName = line.substringAfter("Project:").trim() logger.debug(" → Nom du projet extrait: '$projectName'") } line.contains("Dependencies count:") -> { val count = line.substringAfter("count:").trim() logger.debug(" → Nombre de dépendances: $count") } } } assertTrue(diagLines.isNotEmpty(), "Des lignes de diagnostic devraient être présentes") logger.info("✓ Analyse structurée terminée - ${diagLines.size} lignes analysées") } @Test fun `test with error handling`() { logger.info("TEST: Gestion d'erreurs avec logging") buildFile.writeText(""" plugins { id("com.cheroliv.bakery") } """.trimIndent()) try { logger.debug("Tentative d'exécution...") val result = GradleRunner.create() .forwardOutput() .withPluginClasspath() .withArguments("printJBakeClasspath") .withProjectDir(projectDir) .build() val outcome = result.task(":printJBakeClasspath")?.outcome logger.info("Outcome: $outcome") if (outcome == TaskOutcome.SUCCESS) { logger.info("✓ Exécution réussie") } else { logger.warn("⚠ Outcome inattendu: $outcome") } assertEquals(TaskOutcome.SUCCESS, outcome) } catch (e: Exception) { logger.error("✗ Échec du test", e) logger.error("Type d'exception: ${e.javaClass.simpleName}") logger.error("Message: ${e.message}") // Log de la stack trace si nécessaire if (logger.isDebugEnabled) { logger.debug("Stack trace complète:", e) } throw e } } }</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_マルチレベルログスキーム">マルチレベルログスキーム</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>@startuml !theme plain skinparam backgroundColor #FEFEFE package "ロギングレベル" { rectangle "痕跡" #E8E8E8 { note Détails d'exécution très fins • Valeurs de variables • Appels de méthodes internes end note } rectangle "DEBUG" #D0E8FF { note Informations de débogage • Étapes intermédiaires • Contenu des fichiers créés • Analyse de la sortie Gradle end note } rectangle "情報" #C8FFC8 { note Informations principales • Début/fin de test • Résultats de validation • Durée d'exécution end note } rectangle "警告" #FFFFC8 { note Avertissements • Comportements inattendus • Outcomes inhabituels end note } rectangle "エラー" #FFC8C8 { note Erreurs • Échecs de test • Exceptions • Stack traces end note } } @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ベストプラクティス">ベストプラクティス</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_推奨されるロギング構造">推奨されるロギング構造</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `mon test`() { // 1. LOG: Début du test logger.info("TEST: Description du test") // 2. LOG: Préparation logger.debug("Préparation des fichiers...") buildFile.writeText("...") logger.debug("✓ Fichiers préparés") // 3. LOG: Exécution logger.debug("Lancement du build...") val startTime = System.currentTimeMillis() val result = GradleRunner.create() .forwardOutput() .withArguments("task") .build() val duration = System.currentTimeMillis() - startTime logger.info("Build terminé en ${duration}ms") // 4. LOG: Analyse logger.debug("Analyse des résultats...") // ... validations ... // 5. LOG: Conclusion logger.info("✓ Test réussi") }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_可読性のための視覚的なシンボル">可読性のための視覚的なシンボル</h3> <div class="paragraph"> <p>Unicode記号を使用してログの可読性を向上させなさい：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">logger.info("✓ Succès") logger.info("✗ Échec") logger.info("⚠ Attention") logger.info("→ Étape suivante") logger.info("═".repeat(60)) // Séparateur principal logger.info("─".repeat(60)) // Séparateur secondaire</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_出力からの情報抽出">出力からの情報抽出</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// Recherche simple val hasMessage = result.output.contains("Expected message") // Extraction avec regex val versionRegex = Regex("Version: (.+)") val version = versionRegex.find(result.output)?.groupValues?.get(1) // Filtrage de lignes val errorLines = result.output.lines() .filter { it.contains("ERROR") } errorLines.forEach { logger.error("Gradle error: $it") }</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_比較_前後">比較 前後</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_前問題のあるアプローチ">前：問題のあるアプローチ</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class MyTest { lateinit var logger: Logger // ❌ Initialisé tardivement @BeforeEach fun setup() { logger = LoggerFactory.getLogger(...) // ❌ Dépendance } @Test fun test() { val runner = GradleRunner.create() logger.info("Testing...") // ⚠ Peut échouer } }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_後_頑健なアプローチ">後 : 頑健なアプローチ</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class MyTest { companion object { private val logger = LoggerFactory.getLogger(...) // ✓ Indépendant } @Test fun test() { logger.info("TEST: Starting...") // ✓ Toujours disponible val result = GradleRunner.create() .forwardOutput() // ✓ Capture la sortie .build() logger.debug("Output: ${result.output}") // ✓ Analyse } }</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_サマリーダイアグラム">サマリーダイアグラム</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>@startuml !theme plain skinparam backgroundColor #FEFEFE title 機能テストにおける完全なロギングフロー actor "開発者" as dev participant "JUnit" as junit participant "テストクラス" as test participant "Logger (SLF4J)" as logger participant "Logback" as logback participant "グラドルランナー" as runner participant "コンソール/ファイル" as output dev -> junit : lance les tests activate junit junit -> test : charge la classe activate test test -> logger : initialize (companion) activate logger logger -> logback : configure activate logback logback --> logger : ready deactivate logback logger --> test : ✓ deactivate logger == Phase de Setup == junit -> test : @BeforeAll test -> logger : info("初期化") logger -> output : [INFO] Initialisation junit -> test : @BeforeEach test -> logger : debug("セットアップ テスト") logger -> output : [DEBUG] Setup test == Phase de Test == junit -> test : @Test test -> logger : info("始める") logger -> output : [INFO] TEST: Starting test -> runner : create() activate runner test -> runner : .forwardOutput() test -> runner : .build() runner -> runner : execute Gradle runner --> test : BuildResult + output text deactivate runner test -> logger : debug("出力を分析中") logger -> output : [DEBUG] Analyzing output test -> test : assertions test -> logger : info("�✓ テストに合格しました") logger -> output : [INFO] ✓ Test passed == Phase de Cleanup == junit -> test : @AfterEach test -> logger : debug("クリーンアップ") logger -> output : [DEBUG] Cleanup junit -> test : @AfterAll test -> logger : info("テストの終了") logger -> output : [INFO] Fin des tests test --> junit : ✓ all tests passed deactivate test deactivate junit dev <-- junit : rapport de tests @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_避けるべき罠">�避けるべき罠</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_罠1忘れる_forwardoutput">�❌ 罠1：忘れる `.forwardOutput()</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// MAUVAIS: La sortie Gradle n'est pas capturée val result = GradleRunner.create() .withArguments("task") .build() // result.output sera vide !</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// BON: La sortie est capturée val result = GradleRunner.create() .forwardOutput() // ✓ .withArguments("task") .build()</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_罠_2番_ロガー_未初期化">�❌ 罠 2番 : ロガー 未初期化</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// MAUVAIS class Test { lateinit var logger: Logger // Peut ne pas être initialisé }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// BON class Test { companion object { private val logger = LoggerFactory.getLogger(...) // Toujours initialisé } }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_罠_3_過剰なログ">�❌ 罠 3 : 過剰なログ</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// MAUVAIS: Trop de logs DEBUG en production logger.debug("Variable a = $a") logger.debug("Variable b = $b") logger.debug("Variable c = $c") // ... 100 lignes de logs</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// BON: Logging ciblé logger.info("Traitement de ${items.size} éléments") logger.debug("Détails: ${items.take(5)}...") // Échantillon seulement</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結果とメトリクス">結果とメトリクス</h2> <div class="sectionbody"> <div class="paragraph"> <p>このアプローチでは、次のように得られます：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 28.5714%;"> <col style="width: 42.8571%;"> <col style="width: 28.5715%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">メトリック</th> <th class="tableblock halign-left valign-top">前に</th> <th class="tableblock halign-left valign-top">後</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">コードの行</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">~50 lignes</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">約80行（＋60％）</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">デバッグ時間</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">~30分</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">~5分 (-83%)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">�検出されたエラー</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">基本的</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">詳細</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">メンテナンス</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">難しい</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">シンプル</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">独立</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">❌ 結合された</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">独立した</p></td> </tr> </tbody> </table> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>Gradle プラグインの機能テストにおける堅牢なログ システムの導入は、シンプルな原則に基づいています :<strong>独立</strong>。</p> </div> <div class="paragraph"> <p>重要なポイント：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>独立ロガー</strong>で初期化された`companion object`</p> </li> <li> <p><strong>SLF4JとLogback</strong>: テスト済みで設定可能なスタック</p> </li> <li> <p><strong>.forwardOutput()</strong>: Gradle出力のキャプチャ</p> </li> <li> <p><strong>構造化ログ</strong>: INFO ステップのために, DEBUG 詳細のために</p> </li> <li> <p><strong>出力の分析</strong>情報の抽出から`result.output`</p> </li> </ol> </div> <div class="paragraph"> <p>このアプローチはテストを保証する<strong>メンテナンス可能</strong>, <strong>デバッグ可能なもの</strong> et <strong>頑丈</strong>, しっかりとした設計の原則を尊重しながら。</p> </div> </div> </div> <div class="sect1"> <h2 id="_資源">資源</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="https://docs.gradle.org/current/userguide/test_kit.html">Gradle TestKit ドキュメント</a></p> </li> <li> <p><a href="https://www.slf4j.org/manual.html">SLF4J マニュアル</a></p> </li> <li> <p><a href="https://logback.qos.ch/manual/configuration.html">Logback 設定</a></p> </li> <li> <p><a href="https://github.com/gradle/gradle/tree/master/subprojects/test-kit">Gradle TestKit ソースコード</a></p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_もっと先へ">もっと先へ</h2> <div class="sectionbody"> <div class="paragraph"> <p>次回の記事では、探求します:</p> </div> <div class="ulist"> <ul> <li> <p>構造化ロギング付きの継続的インテグレーション</p> </li> <li> <p>ログが組み込まれたHTMLテストレポート</p> </li> <li> <p>JVMアタッチを使用した高度なデバッグ</p> </li> <li> <p>パフォーマンスとロギングの最適化</p> </li> </ul> </div> <div class="paragraph"> <p><em>この記事は、私の技術ブログにおける「Gradleプラグイン開発」シリーズの一部です。</em></p> </div> </div> </div> https://cheroliv.com/blog/2025/0096_afficher-couleurs-asciidoc_post.html Sat, 1 Nov 2025 00:00:00 +0000 blog/2025/0096_afficher-couleurs-asciidoc_post.html <div id="toc" class="toc"> <div id="toctitle">Table of Contents</div> <ul class="sectlevel1"> <li><a href="#_導入">導入</a></li> <li><a href="#_問題">問題</a> <ul class="sectlevel2"> <li><a href="#_使用コンテキスト">使用コンテキスト</a></li> <li><a href="#_考えられるアプローチ">考えられるアプローチ</a> <ul class="sectlevel3"> <li><a href="#_オプション_1_unicode文字">オプション 1 : Unicode文字</a></li> <li><a href="#_オプション_2_外部画像">オプション 2 : 外部画像</a></li> <li><a href="#_オプション3_カスタムcssロール">オプション3 : カスタムCSSロール</a></li> <li><a href="#_オプション4_htmlインジェクション_採用された解決策">オプション4 : HTMLインジェクション (採用された解決策)</a></li> </ul> </li> </ul> </li> <li><a href="#_解決策_htmlインジェクション">解決策 : HTMLインジェクション </a> <ul class="sectlevel2"> <li><a href="#_動作原理">動作原理</a></li> <li><a href="#_実装">実装</a> <ul class="sectlevel3"> <li><a href="#_cssプロパティの説明">CSSプロパティの説明</a></li> </ul> </li> <li><a href="#_完全な例">完全な例</a></li> </ul> </li> <li><a href="#_最適化とベストプラクティス">最適化とベストプラクティス</a> <ul class="sectlevel2"> <li><a href="#_明るい色を管理する">明るい色を管理する</a></li> <li><a href="#_正方形のサイズを調整する">正方形のサイズを調整する</a></li> <li><a href="#_バリエーションを作成する">バリエーションを作成する</a> <ul class="sectlevel3"> <li><a href="#_色付きの円">色付きの円</a></li> <li><a href="#_色付きの枠線がある正方形">色付きの枠線がある正方形</a></li> </ul> </li> </ul> </li> <li><a href="#_ソリューションアーキテクチャ">ソリューションアーキテクチャ</a></li> <li><a href="#_利点と制限">利点と制限</a> <ul class="sectlevel2"> <li><a href="#_利点">利点</a></li> <li><a href="#_制限">制限</a></li> <li><a href="#_アクセシビリティの向上">アクセシビリティの向上</a></li> </ul> </li> <li><a href="#_具体例テーマのドキュメンテーション">具体例：テーマのドキュメンテーション</a></li> <li><a href="#_結論">結論</a></li> <li><a href="#_リソース">リソース</a></li> </ul> </div> <div class="sect1"> <h2 id="_導入">導入</h2> <div class="sectionbody"> <div class="paragraph"> <p>技術ドキュメントを作成する際、特にスタイルガイドやユーザーインターフェース仕様では、カラーパレットを表示することがよくあります。AsciiDoc はドキュメント作成に非常に強力ですが、カラーサンプルを表示するためのネイティブな構文は提供されていません。この記事ではこの問題を検討し、HTML インジェクションに基づくエレガントな解決策を提案します。</p> </div> </div> </div> <div class="sect1"> <h2 id="_問題">問題</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_使用コンテキスト">使用コンテキスト</h3> <div class="paragraph"> <p>ウェブアプリケーションテーマのCSS変数をドキュメントしていると想像してください。次のものが必要です：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>16進数のカラーコードをリスト</p> </li> <li> <p>各色の視覚的なプレビューを表示</p> </li> <li> <p>ソースドキュメントの可読性を維持する</p> </li> <li> <p>静的サイトジェネレーター（JBakeなど）との互換性を確保する</p> </li> </ol> </div> <div class="listingblock"> <div class="content"> <pre>@startuml left to right direction skinparam packageStyle rectangle actor "技術ライター" as writer actor "読者" as reader rectangle "AsciiDoc ドキュメンテーション" { usecase "カラーパレットをドキュメントする" as UC1 usecase "16進数コードを表示" as UC2 usecase "色を表示" as UC3 usecase "静的サイトを生成" as UC4 usecase "ドキュメントを参照" as UC5 } writer --> UC1 UC1 ..> UC2 : include UC1 ..> UC3 : include UC1 --> UC4 UC4 --> UC5 UC5 <-- reader @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_考えられるアプローチ">考えられるアプローチ</h3> <div class="paragraph"> <p>いくつかの解決策を検討することができます。AsciiDocドキュメントで色を表示するために：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam componentStyle rectangle package "可能な解決策" { component "Unicode文字" as unicode component "外部の画像" as images component "カスタムCSSロール" as css component "HTMLインジェクション" as html } package "評価基準" { component "シンプルさ" as simple component "�携帯性" as portable component "パーソナライズ" as custom component "メンテナンス" as maintain } unicode -down-> simple : ✓ unicode -down-> portable : ✓ unicode -down-> custom : ✗ images -down-> simple : ✗ images -down-> portable : ✗ images -down-> custom : ✓ css -down-> simple : ~ css -down-> portable : ✗ css -down-> custom : ✓ html -down-> simple : ✓ html -down-> portable : ✓ html -down-> custom : ✓✓ html -down-> maintain : ✓ note right of html Solution recommandée end note @enduml</pre> </div> </div> <div class="sect3"> <h4 id="_オプション_1_unicode文字">オプション 1 : Unicode文字</h4> <div class="paragraph"> <p>Unicode文字を使用して`■`(■) 簡単だが限定的である :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* ■ --accent-color: #7952b3 (violet Bootstrap)</code></pre> </div> </div> <div class="paragraph"> <p><strong>制限</strong> : 色の制御はありません、システムフォントに依存します。</p> </div> </div> <div class="sect3"> <h4 id="_オプション_2_外部画像">オプション 2 : 外部画像</h4> <div class="paragraph"> <p>各色ごとに PNG または SVG の画像を作成する：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* image:colors/violet.svg[width=16] --accent-color: #7952b3</code></pre> </div> </div> <div class="paragraph"> <p><strong>制限</strong> :重いメンテナンス、ファイルの増殖、自動同期なし。</p> </div> </div> <div class="sect3"> <h4 id="_オプション3_カスタムcssロール">オプション3 : カスタムCSSロール</h4> <div class="paragraph"> <p>CSSクラスを定義し、AsciiDocのロールを使用して適用する：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* [.color-violet]##■## --accent-color: #7952b3</code></pre> </div> </div> <div class="paragraph"> <p><strong>制限</strong> : 外部スタイルシートが必要、すべての可能な色の事前定義が必要</p> </div> </div> <div class="sect3"> <h4 id="_オプション4_htmlインジェクション_採用された解決策">オプション4 : HTMLインジェクション (採用された解決策)</h4> <div class="paragraph"> <p>マクロを使用する``HTMLをインラインスタイルで注入するために :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* pass:[<span style="display:inline-block;width:1em;height:1em; background:#7952b3;vertical-align:middle;margin-right:0.5em"></span>] --accent-color: #7952b3 (violet Bootstrap)</code></pre> </div> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_解決策_htmlインジェクション">解決策 : HTMLインジェクション </h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_動作原理">動作原理</h3> <div class="paragraph"> <p>マクロ``AsciiDoc では、AsciiDoc プロセッサーによって解釈されない生のコンテンツを挿入できます。これにより、インライン CSS スタイルを持つ HTML を直接挿入できます。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml participant "ドキュメント\nAsciiDoc" as doc participant "プロセッサー AsciiDoc" as processor participant "パス:[] マクロ" as pass participant "HTML 最終" as html doc -> processor : Analyse document processor -> pass : Détecte pass:[] pass -> processor : Retourne HTML brut processor -> html : Insère sans transformation html -> html : Navigateur applique styles @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_実装">実装</h3> <div class="paragraph"> <p>ここに注入するHTML構造は：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><span style="display:inline-block; width:1em; height:1em; background:#7952b3; vertical-align:middle; margin-right:0.5em"> </span></code></pre> </div> </div> <div class="sect3"> <h4 id="_cssプロパティの説明">CSSプロパティの説明</h4> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 25%;"> <col style="width: 75%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">所有</th> <th class="tableblock halign-left valign-top">機能</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>display:inline-block</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">インラインフローに留まりながら width/height を設定できるようにする</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>width:1em; height:1em</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">フォントサイズに対する正方形のサイズ (レスポンシブ)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>background:#7952b3</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">表示する色（ニーズに応じて変数）</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>vertical-align:middle</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">正方形を隣接するテキストに合わせて揃える</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>margin-right:0.5em</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">正方形とテキストの間隔</p></td> </tr> </tbody> </table> </div> </div> <div class="sect2"> <h3 id="_完全な例">完全な例</h3> <div class="paragraph"> <p>テーマパレットの文書化例を以下に示します：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">== Thème Clair * pass:[<span style="display:inline-block;width:1em;height:1em;background:#f8f9fa;border:1px solid #ccc;vertical-align:middle;margin-right:0.5em"></span>] --bg-primary: `#f8f9fa` (blanc cassé) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#212529;vertical-align:middle;margin-right:0.5em"></span>] --text-primary: `#212529` (noir très foncé) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#7952b3;vertical-align:middle;margin-right:0.5em"></span>] --accent-color: `#7952b3` (violet Bootstrap) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#61428f;vertical-align:middle;margin-right:0.5em"></span>] --accent-hover: `#61428f` (violet plus foncé) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#ffffff;border:1px solid #ccc;vertical-align:middle;margin-right:0.5em"></span>] --card-bg: `#ffffff` (blanc)</code></pre> </div> </div> <div class="paragraph"> <p>次のレンダリングを生成する：</p> </div> <div class="paragraph"> <p>ライトテーマ</p> </div> <div class="ulist"> <ul> <li> <p><span style="display:inline-block;width:1em;height:1em;background:#f8f9fa;border:1px solid #ccc;vertical-align:middle;margin-right:0.5em"></span> --bg-primary:`#f8f9fa`(オフホワイト)</p> </li> <li> <p><span style="display:inline-block;width:1em;height:1em;background:#212529;vertical-align:middle;margin-right:0.5em"></span> --text-primary:`#212529`(非常に暗い黒)</p> </li> <li> <p><span style="display:inline-block;width:1em;height:1em;background:#7952b3;vertical-align:middle;margin-right:0.5em"></span> --accent-color:`#7952b3`(バイオレット Bootstrap)</p> </li> <li> <p><span style="display:inline-block;width:1em;height:1em;background:#61428f;vertical-align:middle;margin-right:0.5em"></span> --accent-hover:`#61428f`(より暗い紫)</p> </li> <li> <p><span style="display:inline-block;width:1em;height:1em;background:#ffffff;border:1px solid #ccc;vertical-align:middle;margin-right:0.5em"></span> --card-bg:`#ffffff`(白)</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_最適化とベストプラクティス">最適化とベストプラクティス</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_明るい色を管理する">明るい色を管理する</h3> <div class="paragraph"> <p>非常に薄い色（白、非常に薄いグレー）の場合は、白い背景でも見えるように枠線を追加してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><span style="display:inline-block;width:1em;height:1em; background:#ffffff;border:1px solid #ccc; vertical-align:middle;margin-right:0.5em"></span></code></pre> </div> </div> <div class="paragraph"> <p>�灰色の境界線`border:1px solid #ccc`) は白い背景上の白い正方形を区切ることができます。</p> </div> </div> <div class="sect2"> <h3 id="_正方形のサイズを調整する">正方形のサイズを調整する</h3> <div class="paragraph"> <p>必要に応じて正方形のサイズを調整できます：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* pass:[<span style="display:inline-block;width:1.5em;height:1.5em;background:#7952b3;vertical-align:middle;margin-right:0.5em"></span>] Grand carré * pass:[<span style="display:inline-block;width:0.8em;height:0.8em;background:#7952b3;vertical-align:middle;margin-right:0.5em"></span>] Petit carré</code></pre> </div> </div> <div class="paragraph"> <p>単位の使用`em`フォントサイズに合わせて正方形が適応することを保証します。</p> </div> </div> <div class="sect2"> <h3 id="_バリエーションを作成する">バリエーションを作成する</h3> <div class="paragraph"> <p>特定のニーズに対して、さまざまな形を作ることができます：</p> </div> <div class="sect3"> <h4 id="_色付きの円">色付きの円</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* pass:[<span style="display:inline-block;width:1em;height:1em;background:#7952b3;border-radius:50%;vertical-align:middle;margin-right:0.5em"></span>] Cercle violet</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_色付きの枠線がある正方形">色付きの枠線がある正方形</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* pass:[<span style="display:inline-block;width:1em;height:1em;background:#ffffff;border:3px solid #7952b3;vertical-align:middle;margin-right:0.5em"></span>] Bordure violette</code></pre> </div> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ソリューションアーキテクチャ">ソリューションアーキテクチャ</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>@startuml package "ドキュメントワークフロー" { [Document AsciiDoc\navec pass macro] as asciidoc [Processeur JBake] as jbake [Site HTML statique] as html [Navigateur Web] as browser } asciidoc --> jbake : 1. Compilation jbake --> html : 2. Génération html --> browser : 3. Affichage browser --> browser : 4. Rendu CSS note right of asciidoc Contient les balises pass:[] avec HTML inline end note note right of jbake Préserve le HTML dans pass:[] end note note right of browser Applique les styles inline CSS end note @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_利点と制限">利点と制限</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_利点">利点</h3> <div class="ulist"> <ul> <li> <p>自律性 : 外部ファイルへの依存はありません</p> </li> <li> <p>�✓ <strong>ポータビリティ</strong> : すべての AsciiDoc プロセッサーで動作します</p> </li> <li> <p>�✓ <strong>同期化</strong> : カラーコードはHTMLに直接記述されています</p> </li> <li> <p>�✓ <strong>柔軟性</strong> : スタイルの完全なカスタマイズ</p> </li> <li> <p><strong>メンテナンス</strong> : 16進コードの簡単な変更</p> </li> <li> <p>✓ <strong>JBake 互換性</strong> : 静的サイトジェネレーターと完全に互換性があります</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_制限">制限</h3> <div class="ulist"> <ul> <li> <p><strong>冗長</strong> : HTMLコードの繰り返しは、AsciiDocソース内</p> </li> <li> <p>✗ <strong>ソースの可読性</strong> : ソースドキュメントはそれほどきれいではない</p> </li> <li> <p>✗ <strong>アクセシビリティ</strong> : ネイティブな代替テキストはありません（手動で追加する必要があります）</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_アクセシビリティの向上">アクセシビリティの向上</h3> <div class="paragraph"> <p>スクリーンリーダーが読めるように四角をアクセシブルにする：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* pass:[<span role="img" aria-label="Couleur violet Bootstrap" style="display:inline-block;width:1em;height:1em;background:#7952b3; vertical-align:middle;margin-right:0.5em"></span>] --accent-color: `#7952b3` (violet Bootstrap)</code></pre> </div> </div> <div class="paragraph"> <p>属性`role="img"` et `aria-label`補助技術が視覚コンテンツを理解し、説明できるようにします。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_具体例テーマのドキュメンテーション">具体例：テーマのドキュメンテーション</h2> <div class="sectionbody"> <div class="paragraph"> <p>複数のテーマを文書化した完全な例 :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">= Guide des couleurs de l'application == Thème Clair (`:root`) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#f8f9fa;border:1px solid #ccc;vertical-align:middle;margin-right:0.5em"></span>] --bg-primary: `#f8f9fa` (blanc cassé) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#212529;vertical-align:middle;margin-right:0.5em"></span>] --text-primary: `#212529` (noir très foncé) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#7952b3;vertical-align:middle;margin-right:0.5em"></span>] --accent-color: `#7952b3` (violet Bootstrap) == Thème Sombre (`[data-bs-theme="dark"]`) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#212529;vertical-align:middle;margin-right:0.5em"></span>] --bg-primary: `#212529` (noir très foncé) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#ffffff;border:1px solid #999;vertical-align:middle;margin-right:0.5em"></span>] --text-primary: `#ffffff` (blanc) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#0d6efd;vertical-align:middle;margin-right:0.5em"></span>] --accent-color: `#0d6efd` (bleu Bootstrap) == Thème Contraste Élevé (`[data-bs-theme="high-contrast"]`) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#000000;vertical-align:middle;margin-right:0.5em"></span>] --bg-primary: `#000000` (noir) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#ffffff;border:1px solid #000;vertical-align:middle;margin-right:0.5em"></span>] --text-primary: `#ffffff` (blanc) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#00ff00;vertical-align:middle;margin-right:0.5em"></span>] --accent-color: `#00ff00` (vert vif)</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>マクロを介したHTMLインジェクション``AsciiDocは、技術文書で色見本を表示するためのエレガントで実用的なソリューションを提供します。やや冗長ではあるが、このアプローチは最大限の移植性と簡素化されたメンテナンスを保証します。</p> </div> <div class="paragraph"> <p>この技術は外部の設定や追加のスタイルシートを必要とせず、JBakeおよびすべての標準的なAsciiDocプロセッサとすぐに動作します。</p> </div> <div class="paragraph"> <p>最初の色付きの正方形を作成したら、HTMLコードをコピー＆ペーストし、16進数コードを変更するだけで、すぐに完全なパレットを作成できます。</p> </div> <div class="paragraph"> <p>この技術は、カスタマイズされたビジュアルレンダリングを必要とする他のユースケースにも拡張できます：アイコン、バッジ、シンプルなグラフ、またはスタイルを正確に制御する必要のあるすべてのビジュアル要素。</p> </div> </div> </div> <div class="sect1"> <h2 id="_リソース">リソース</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="https://docs.asciidoctor.org/asciidoc/latest/pass/pass-macro/" target="_blank" rel="noopener">AsciiDoc ドキュメント : pass macro</a></p> </li> <li> <p><a href="https://jbake.org/docs/2.6.7/" target="_blank" rel="noopener">JBakeドキュメンテーション</a></p> </li> <li> <p><a href="https://developer.mozilla.org/fr/docs/Web/CSS/color_value" target="_blank" rel="noopener">MDN : CSSのカラー値</a></p> </li> </ul> </div> <div class="paragraph"> <p><em>掲載された記事 2025-11-01</em></p> </div> </div> </div> https://cheroliv.com/blog/2025/0095_i18n-site-statique-jbake-thymeleaf_post.html Mon, 20 Oct 2025 00:00:00 +0000 blog/2025/0095_i18n-site-statique-jbake-thymeleaf_post.html <div id="toc" class="toc"> <div id="toctitle">Table of Contents</div> <ul class="sectlevel1"> <li><a href="#_はじめに">はじめに</a> <ul class="sectlevel2"> <li><a href="#_ユースケース図_use_case">ユースケース図 (Use Case)</a></li> </ul> </li> <li><a href="#_国際化のアーキテクチャ">国際化のアーキテクチャ</a> <ul class="sectlevel2"> <li><a href="#_構造図ファイル構成">構造図（ファイル構成）</a></li> <li><a href="#_なぜこのアプローチ">なぜこのアプローチ？</a></li> <li><a href="#_コンポーネント図">コンポーネント図</a></li> </ul> </li> <li><a href="#_thymeleafを使用したテンプレートの国際化">Thymeleafを使用したテンプレートの国際化</a> <ul class="sectlevel2"> <li><a href="#_メッセージファイルの構造">メッセージファイルの構造</a></li> <li><a href="#_メッセージファイルの内容">メッセージファイルの内容</a></li> <li><a href="#_テンプレートでの使用">テンプレートでの使用</a></li> <li><a href="#_シーケンス図_i18nの解決">シーケンス図 - i18nの解決</a></li> <li><a href="#_jbakeにおけるロケールの設定">JBakeにおけるロケールの設定</a></li> </ul> </li> <li><a href="#_記事の国際化フォルダーごとの整理">記事の国際化：フォルダーごとの整理</a> <ul class="sectlevel2"> <li><a href="#_フローチャート_flow_生成">フローチャート (Flow) - 生成</a></li> <li><a href="#_フォルダ構造">フォルダ構造</a></li> <li><a href="#_このアプローチの利点">このアプローチの利点</a></li> <li><a href="#_記事のメタデータ">記事のメタデータ</a></li> <li><a href="#_urlの設定">URLの設定</a></li> </ul> </li> <li><a href="#_多言語表示用テンプレート">多言語表示用テンプレート</a> <ul class="sectlevel2"> <li><a href="#_言語セレクタ付き記事テンプレート">言語セレクタ付き記事テンプレート</a></li> <li><a href="#_言語でフィルタリングされたインデックス">言語でフィルタリングされたインデックス</a></li> </ul> </li> <li><a href="#_言語間ナビゲーション">言語間ナビゲーション</a> <ul class="sectlevel2"> <li><a href="#_グローバル言語セレクター">グローバル言語セレクター</a></li> <li><a href="#_フローチャート_ユーザーによる読み取り">フローチャート - ユーザーによる読み取り</a></li> <li><a href="#_セレクター用のcssスタイル">セレクター用のCSSスタイル</a></li> </ul> </li> <li><a href="#_言語別_rss_フィード">言語別 RSS フィード</a></li> <li><a href="#_良いプラクティスとコツ">良いプラクティスとコツ</a> <ul class="sectlevel2"> <li><a href="#_記事識別子の一貫性">記事識別子の一貫性</a></li> <li><a href="#_2_一貫性のある日付">2. 一貫性のある日付</a></li> <li><a href="#_3_多言語タグ">3. 多言語タグ</a></li> <li><a href="#_4_未翻訳記事の管理">4. 未翻訳記事の管理</a></li> <li><a href="#_5_多言語サイトマップ">5. 多言語サイトマップ</a></li> </ul> </li> <li><a href="#_結論">結論</a> <ul class="sectlevel2"> <li><a href="#_配置図">配置図</a></li> </ul> </li> </ul> </div> <div class="sect1"> <h2 id="_はじめに">はじめに</h2> <div class="sectionbody"> <div class="paragraph"> <p>静的サイトの国際化（i18n）は一見複雑に見えるかもしれませんが、JBakeとThymeleafを組み合わせることで、多言語サイトを作成するための洗練されたソリューションが提供されます。この記事では、私のブログでi18nをどのように実装したかを紹介し、テンプレートと複数言語での記事管理の両方をカバーします。</p> </div> <div class="sect2"> <h3 id="_ユースケース図_use_case">ユースケース図 (Use Case)</h3> <div class="listingblock"> <div class="content"> <pre>@startuml left to right direction skinparam packageStyle rectangle actor "著者" as author actor "リーダー FR" as reader_fr actor "リーダー EN" as reader_en rectangle "JBake多言語サイト" { usecase "FR記事を書く" as UC1 usecase "記事をENで書く" as UC2 usecase "i18nメッセージを設定する" as UC3 usecase "サイト生成" as UC4 usecase "FR記事を読む" as UC5 usecase "記事を読む EN" as UC6 usecase "言語を変更" as UC7 usecase "利用可能な翻訳を見る" as UC8 } author --> UC1 author --> UC2 author --> UC3 author --> UC4 reader_fr --> UC5 reader_fr --> UC7 reader_fr --> UC8 reader_en --> UC6 reader_en --> UC7 reader_en --> UC8 UC1 ..> UC4 : <<include>> UC2 ..> UC4 : <<include>> UC3 ..> UC4 : <<include>> UC5 ..> UC8 : <<extend>> UC6 ..> UC8 : <<extend>> @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_国際化のアーキテクチャ">国際化のアーキテクチャ</h2> <div class="sectionbody"> <div class="paragraph"> <p>私たちのアプローチは2つの柱に基づいています：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>テンプレートのi18n</strong>: インターフェース要素用のThymeleafメッセージファイルの使用</p> </li> <li> <p><strong>コンテンツの i18n</strong>言語ごとに記事を整理するための専用フォルダ構造</p> </li> </ol> </div> <div class="sect2"> <h3 id="_構造図ファイル構成">構造図（ファイル構成）</h3> <div class="listingblock"> <div class="content"> <pre>@startuml @startsalt { {T + projet-jbake ++ content +++ blog ++++ 2024 +++++ fr ++++++ article1.adoc ++++++ article2.adoc +++++ en ++++++ article1.adoc ++++++ article2.adoc ++++ 2025 +++++ fr ++++++ guide-i18n.adoc +++++ en ++++++ i18n-guide.adoc ++ templates +++ post.html +++ index.html +++ index_en.html +++ messages.properties +++ messages_fr.properties +++ messages_en.properties ++ assets +++ css +++ js +++ img ++ jbake.properties ++ output +++ fr ++++ blog +++++ 2025 ++++++ guide-i18n.html +++ en ++++ blog +++++ 2025 ++++++ i18n-guide.html } } @endsalt @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_なぜこのアプローチ">なぜこのアプローチ？</h3> <div class="paragraph"> <p>この分離により、以下のことが可能になります :</p> </div> <div class="ulist"> <ul> <li> <p>言語に関わらず、インターフェースの一貫性を維持する</p> </li> <li> <p>コンテンツと記事の翻訳を独立して管理する</p> </li> <li> <p>新しい言語の追加を大規模なリファクタリングなしで容易にする</p> </li> <li> <p>特定の言語でのみ利用可能な記事を許可する</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_コンポーネント図">コンポーネント図</h3> <div class="listingblock"> <div class="content"> <pre>@startuml skinparam componentStyle rectangle package "出典" { folder "content/blog/2025/" { folder "fr/" as content_fr { [article1.adoc] [article2.adoc] } folder "en/" as content_en { [article1.adoc] as article1_en [article2.adoc] as article2_en } } folder "テンプレート/" { [post.html] [index.html] [index_en.html] } folder "メッセージ/" { [messages_fr.properties] [messages_en.properties] } [jbake.properties] } package "JBake エンジン" { [Parser AsciiDoc] as parser [Template Engine\nThymeleaf] as thymeleaf [Generator] as generator [I18n Resolver] as i18n } package "生成されたサイト" { folder "fr/" { folder "ブログ/2025/" as blog_fr { [article1.html] [article2.html] } } folder "en/" { folder "ブログ/2025/" as blog_en { [article1.html] as article1_html_en [article2.html] as article2_html_en } } } content_fr --> parser content_en --> parser parser --> generator templates --> thymeleaf messages --> i18n i18n --> thymeleaf thymeleaf --> generator jbake.properties --> generator generator --> blog_fr generator --> blog_en @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_thymeleafを使用したテンプレートの国際化">Thymeleafを使用したテンプレートの国際化</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_メッセージファイルの構造">メッセージファイルの構造</h3> <div class="paragraph"> <p>最初の手順は、サポートされている各言語用のプロパティファイルを作成することです：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">src/jbake/templates/ ├── messages.properties # Fallback par défaut ├── messages_fr.properties # Français ├── messages_en.properties # Anglais └── messages_de.properties # Allemand</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_メッセージファイルの内容">メッセージファイルの内容</h3> <div class="paragraph"> <p>ファイルの例です`messages_fr.properties`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties"># Navigation nav.home=Accueil nav.blog=Blog nav.about=À propos nav.contact=Contact # Articles article.readmore=Lire la suite article.published=Publié le article.tags=Étiquettes article.also.available=Également disponible en # Interface site.title=Mon Blog Technique site.description=Partage de connaissances et expériences footer.copyright=© 2025 Tous droits réservés search.placeholder=Rechercher un article...</code></pre> </div> </div> <div class="paragraph"> <p>そしてその英語訳`messages_en.properties`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties"># Navigation nav.home=Home nav.blog=Blog nav.about=About nav.contact=Contact # Articles article.readmore=Read more article.published=Published on article.tags=Tags article.also.available=Also available in # Interface site.title=My Tech Blog site.description=Sharing knowledge and experiences footer.copyright=© 2025 All rights reserved search.placeholder=Search articles...</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_テンプレートでの使用">テンプレートでの使用</h3> <div class="paragraph"> <p>Thymeleafのテンプレートでは、構文を使ってください`#{}`メッセージにアクセスする:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <title th:text="#{site.title}">Mon Blog</title> <meta name="description" th:content="#{site.description}" /> </head> <body> <nav> <a th:href="@{/}" th:text="#{nav.home}">Accueil</a> <a th:href="@{/blog/}" th:text="#{nav.blog}">Blog</a> <a th:href="@{/about.html}" th:text="#{nav.about}">À propos</a> </nav> <footer> <p th:text="#{footer.copyright}">Copyright</p> </footer> </body> </html></code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_シーケンス図_i18nの解決">シーケンス図 - i18nの解決</h3> <div class="listingblock"> <div class="content"> <pre>@startuml actor Auteur participant JBake participant "AsciiDoc パーサー" as parser participant "Thymeleaf\nエンジン" as thymeleaf participant "I18n リゾルバー" as i18n database "messages_*.properties" as messages Auteur -> JBake: jbake -b activate JBake JBake -> parser: Lire article.fr.adoc activate parser parser --> JBake: Contenu + métadonnées\n(lang=fr, article-id=xyz) deactivate parser JBake -> parser: Lire article.en.adoc activate parser parser --> JBake: Contenu + métadonnées\n(lang=en, article-id=xyz) deactivate parser JBake -> thymeleaf: Générer page FR activate thymeleaf thymeleaf -> i18n: Résoudre #{nav.home} activate i18n i18n -> messages: Lire messages_fr.properties messages --> i18n: "ホーム" i18n --> thymeleaf: "ホーム" deactivate i18n thymeleaf -> JBake: Rechercher traductions\n(article-id=xyz, lang!=fr) JBake --> thymeleaf: article.en.html trouvé thymeleaf --> JBake: /fr/blog/article.html deactivate thymeleaf JBake -> thymeleaf: Générer page EN activate thymeleaf thymeleaf -> i18n: Résoudre #{nav.home} activate i18n i18n -> messages: Lire messages_en.properties messages --> i18n: "家" i18n --> thymeleaf: "家" deactivate i18n thymeleaf -> JBake: Rechercher traductions\n(article-id=xyz, lang!=en) JBake --> thymeleaf: article.fr.html trouvé thymeleaf --> JBake: /en/blog/article.html deactivate thymeleaf JBake --> Auteur: Site généré deactivate JBake @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_jbakeにおけるロケールの設定">JBakeにおけるロケールの設定</h3> <div class="paragraph"> <p>あなたのファイルで`jbake.properties`, デフォルトロケールを設定してください :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties"># Locale par défaut thymeleaf.locale=fr # Encodage template.encoding=UTF-8</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_記事の国際化フォルダーごとの整理">記事の国際化：フォルダーごとの整理</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_フローチャート_flow_生成">フローチャート (Flow) - 生成</h3> <div class="listingblock"> <div class="content"> <pre>@startuml start :Lire jbake.properties; :Charger configuration i18n; partition "各AsciiDocファイルごとに" { :Lire métadonnées\n(:jbake-lang:, :jbake-article-id:); :Parser contenu AsciiDoc; :Stocker en mémoire avec langue; } partition "各テンプレートに対して" { :Charger template Thymeleaf; :Identifier langue cible; :Charger messages_{lang}.properties; partition "コンテンツフィルタリング" { :Filtrer articles par langue; :Grouper traductions\npar article-id; } :Appliquer template avec i18n; :Générer HTML dans /{lang}/; } :Copier assets statiques; :Générer sitemap multilingue; :Générer flux RSS par langue; stop @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_フォルダ構造">フォルダ構造</h3> <div class="paragraph"> <p>ファイル名にサフィックスを使用する代わりに、フォルダによる整理を選択しました：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">content/blog/ ├── 2024/ │ ├── fr/ │ │ ├── introduction-jbake.adoc │ │ ├── guide-thymeleaf.adoc │ │ └── astuces-asciidoc.adoc │ └── en/ │ ├── introduction-jbake.adoc │ ├── thymeleaf-guide.adoc │ └── asciidoc-tips.adoc └── 2025/ ├── fr/ │ └── internationalisation-jbake.adoc └── en/ └── jbake-internationalization.adoc</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_このアプローチの利点">このアプローチの利点</h3> <div class="paragraph"> <p>この構造にはいくつかの利点があります：</p> </div> <div class="ulist"> <ul> <li> <p><strong>明確な分離</strong>各言語には独自のスペースがあります</p> </li> <li> <p><strong>�柔軟な命名</strong>: ファイルは言語によって異なる名前になる可能性があります</p> </li> <li> <p><strong>スケーラビリティ</strong>新しい言語を追加するのが簡単</p> </li> <li> <p><strong>自然な組織</strong>: JBakeの時間的論理に従う</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_記事のメタデータ">記事のメタデータ</h3> <div class="paragraph"> <p>各記事は翻訳間のリンクを可能にするためにメタデータを含まなければなりません。以下に例を示します：</p> </div> <div class="paragraph"> <p><strong>フランス語版</strong>(<code>2025/fr/internationalisation-jbake.adoc</code>) :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">= Internationalisation d'un site statique JBake :jbake-type: post :jbake-status: published :jbake-date: 2025-10-20 :jbake-lang: fr :jbake-article-id: jbake-i18n-thymeleaf :jbake-tags: jbake, thymeleaf, i18n :jbake-description: Guide pour mettre en place l'i18n avec JBake</code></pre> </div> </div> <div class="paragraph"> <p><strong>英語版</strong>(<code>2025/en/jbake-internationalization.adoc</code>) :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">= Internationalizing a JBake Static Site :jbake-type: post :jbake-status: published :jbake-date: 2025-10-20 :jbake-lang: en :jbake-article-id: jbake-i18n-thymeleaf :jbake-tags: jbake, thymeleaf, i18n :jbake-description: Guide to implement i18n with JBake</code></pre> </div> </div> <div class="paragraph"> <p>属性`:jbake-article-id:`は重要です：それは、同じ記事のさまざまな訳を結びつけることを可能にします。</p> </div> </div> <div class="sect2"> <h3 id="_urlの設定">URLの設定</h3> <div class="paragraph"> <p>中に`jbake.properties`, URLパターンを言語を含むように設定してください :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties"># Pattern d'URL avec langue post.permalink.pattern=:lang/blog/:year/:name.html # Langue par défaut site.default.lang=fr</code></pre> </div> </div> <div class="paragraph"> <p>これにより、次のような URL が生成されます：</p> </div> <div class="ulist"> <ul> <li> <p><code>/fr/blog/2025/internationalisation-jbake.html</code></p> </li> <li> <p><code>/en/blog/2025/jbake-internationalization.html</code></p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_多言語表示用テンプレート">多言語表示用テンプレート</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_言語セレクタ付き記事テンプレート">言語セレクタ付き記事テンプレート</h3> <div class="paragraph"> <p>テンプレートを作成してください`post.html`利用可能な翻訳を表示します :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <title th:text="${content.title}">Article</title> </head> <body> <article> <header> <h1 th:text="${content.title}">Titre</h1> <div class="article-meta"> <time th:text="${#dates.format(content.date, 'dd MMMM yyyy')}" th:attr="datetime=${#dates.format(content.date, 'yyyy-MM-dd')}"> Date </time> <!-- Sélecteur de traductions --> <div class="translations" th:if="${content['article-id']}"> <span th:text="#{article.also.available}">Aussi disponible en :</span> <ul class="language-list"> <li th:each="post : ${published_posts}" th:if="${post['article-id'] == content['article-id'] and post.lang != content.lang}"> <a th:href="${post.uri}" th:text="${post.lang.toUpperCase()}"> LANG </a> </li> </ul> </div> </div> </header> <div class="content" th:utext="${content.body}"> Contenu de l'article </div> <footer class="article-footer"> <div class="tags" th:if="${content.tags}"> <span th:text="#{article.tags}">Étiquettes :</span> <span th:each="tag : ${content.tags}"> <a th:href="@{/tags/{tag}.html(tag=${tag})}" th:text="${tag}">tag</a> </span> </div> </footer> </article> </body> </html></code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_言語でフィルタリングされたインデックス">言語でフィルタリングされたインデックス</h3> <div class="paragraph"> <p>各言語向けのインデックステンプレートを作成してください：</p> </div> <div class="paragraph"> <p><strong>index.html</strong>(フランス語インデックス) :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <title th:text="#{site.title}">Mon Blog</title> </head> <body> <main> <h1 th:text="#{nav.blog}">Blog</h1> <div class="articles-list"> <article th:each="post : ${published_posts}" th:if="${post.lang == 'fr'}"> <h2> <a th:href="${post.uri}" th:text="${post.title}">Titre</a> </h2> <time th:text="${#dates.format(post.date, 'dd MMMM yyyy')}"> Date </time> <p th:text="${post.description}">Description</p> <a th:href="${post.uri}" th:text="#{article.readmore}"> Lire la suite </a> </article> </div> </main> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p><strong>index_en.html</strong>(英語インデックス) :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <title th:text="#{site.title}">My Blog</title> </head> <body> <main> <h1 th:text="#{nav.blog}">Blog</h1> <div class="articles-list"> <article th:each="post : ${published_posts}" th:if="${post.lang == 'en'}"> <h2> <a th:href="${post.uri}" th:text="${post.title}">Title</a> </h2> <time th:text="${#dates.format(post.date, 'dd MMMM yyyy')}"> Date </time> <p th:text="${post.description}">Description</p> <a th:href="${post.uri}" th:text="#{article.readmore}"> Read more </a> </article> </div> </main> </body> </html></code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_言語間ナビゲーション">言語間ナビゲーション</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_グローバル言語セレクター">グローバル言語セレクター</h3> </div> <div class="sect2"> <h3 id="_フローチャート_ユーザーによる読み取り">フローチャート - ユーザーによる読み取り</h3> <div class="listingblock"> <div class="content"> <pre>@startuml start :Utilisateur accède au site; if (Langue préférée ?) then (FR) :Afficher /index.html; :Lister articles FR; else (EN) :Afficher /en/index.html; :Lister articles EN; endif :Utilisateur clique sur article; :Afficher article\navec métadonnées; if (Traductions disponibles ?) then (oui) :Afficher sélecteur\nde traductions; if (Changement de langue ?) then (oui) :Rediriger vers\ntraduction; :Afficher article\ndans nouvelle langue; else (non) :Continuer lecture; endif else (non) :Continuer lecture; endif stop @enduml</pre> </div> </div> <div class="paragraph"> <p>メインテンプレートに言語セレクターを追加してください:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><nav class="language-switcher"> <a href="/index.html" th:classappend="${content.lang == 'fr'} ? 'active'" title="Français"> 🇫🇷 FR </a> <a href="/en/index.html" th:classappend="${content.lang == 'en'} ? 'active'" title="English"> 🇬🇧 EN </a> </nav></code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_セレクター用のcssスタイル">セレクター用のCSSスタイル</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">.language-switcher { display: flex; gap: 1rem; padding: 0.5rem; background: #f5f5f5; border-radius: 4px; } .language-switcher a { padding: 0.5rem 1rem; text-decoration: none; color: #333; border-radius: 4px; transition: background 0.2s; } .language-switcher a:hover { background: #e0e0e0; } .language-switcher a.active { background: #007bff; color: white; } .translations { margin: 1rem 0; padding: 1rem; background: #f8f9fa; border-left: 4px solid #007bff; } .language-list { display: inline-flex; gap: 0.5rem; list-style: none; padding: 0; margin: 0; } .language-list li::after { content: "•"; margin-left: 0.5rem; } .language-list li:last-child::after { content: ""; }</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_言語別_rss_フィード">言語別 RSS フィード</h2> <div class="sectionbody"> <div class="paragraph"> <p>言語別にRSSフィードを分けるには、個別のテンプレートを作成してください：</p> </div> <div class="paragraph"> <p><strong>feed.xml</strong>(フランス語のフラックス) :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><?xml version="1.0" encoding="UTF-8"?> <rss version="2.0" xmlns:th="http://www.thymeleaf.org"> <channel> <title th:text="#{site.title}">Mon Blog</title> <link th:text="${config.site_host}">http://example.com</link> <description th:text="#{site.description}">Description</description> <language>fr</language> <item th:each="post : ${published_posts}" th:if="${post.lang == 'fr'}"> <title th:text="${post.title}">Titre</title> <link th:text="${config.site_host + post.uri}">Lien</link> <pubDate th:text="${#dates.format(post.date, 'EEE, dd MMM yyyy HH:mm:ss Z')}"> Date </pubDate> <description th:text="${post.description}">Description</description> </item> </channel> </rss></code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_良いプラクティスとコツ">良いプラクティスとコツ</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_記事識別子の一貫性">記事識別子の一貫性</h3> <div class="paragraph"> <p>必ず…してください`:jbake-article-id:`すべての同じ記事の翻訳に対して同じです。一貫したフォーマットを使用してください :</p> </div> <div class="ulist"> <ul> <li> <p>普遍性のために英語の識別子を使用してください</p> </li> <li> <p>単語を区切るためにハイフンを使用してください</p> </li> <li> <p>特殊文字を避けてください</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_2_一貫性のある日付">2. 一貫性のある日付</h3> <div class="paragraph"> <p>記事のすべての翻訳は、同じ公開日である必要があります (<code>:jbake-date:</code>). これは並び替えと時系列表示を容易にします。</p> </div> </div> <div class="sect2"> <h3 id="_3_多言語タグ">3. 多言語タグ</h3> <div class="paragraph"> <p>タグについては、2つのオプションがあります。</p> </div> <div class="paragraph"> <p><strong>オプション1 : 英語の普遍的なタグ</strong></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">:jbake-tags: java, spring-boot, microservices</code></pre> </div> </div> <div class="paragraph"> <p><strong>オプション2: マッピングを使ってタグを翻訳</strong></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc"># Version française :jbake-tags: java, spring-boot, microservices # Version anglaise :jbake-tags: java, spring-boot, microservices</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_4_未翻訳記事の管理">4. 未翻訳記事の管理</h3> <div class="paragraph"> <p>すべての記事を訳す必要はありません。ある記事が一方の言語だけに存在する場合、他方の言語のリストには表示されません。</p> </div> </div> <div class="sect2"> <h3 id="_5_多言語サイトマップ">5. 多言語サイトマップ</h3> <div class="paragraph"> <p>すべての言語を含むサイトマップを生成してください :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><?xml version="1.0" encoding="UTF-8"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org"> <url th:each="post : ${published_posts}"> <loc th:text="${config.site_host + post.uri}">URL</loc> <lastmod th:text="${#dates.format(post.date, 'yyyy-MM-dd')}">Date</lastmod> <!-- Liens alternatifs pour les traductions --> <xhtml:link th:each="translation : ${published_posts}" th:if="${translation['article-id'] == post['article-id'] and translation.lang != post.lang}" rel="alternate" th:attr="hreflang=${translation.lang},href=${config.site_host + translation.uri}" /> </url> </urlset></code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>JBakeとThymeleafを使用したサイトの国際化は、堅牢で保守しやすいアプローチです。テンプレート（メッセージファイルを通じて）とコンテンツ（フォルダ構成を通じて）の国際化を分離することで、柔軟で容易に拡張できるシステムを得ることができます。</p> </div> <div class="paragraph"> <p>覚えておくべき重要なポイント :</p> </div> <div class="ulist"> <ul> <li> <p><strong>Thymeleafメッセージファイル</strong>ユーザーインターフェイスのために</p> </li> <li> <p><strong>フォルダ別の整理</strong>(年/言語) の記事</p> </li> <li> <p><strong>記事ID</strong>翻訳をリンクするために</p> </li> <li> <p><strong>�専用テンプレート</strong>各言語に対して</p> </li> <li> <p><strong>明示的なURL</strong>言語コードを含む</p> </li> </ul> </div> <div class="sect2"> <h3 id="_配置図">配置図</h3> <div class="listingblock"> <div class="content"> <pre>@startuml node "開発マシン" { artifact "ソース" { folder "コンテンツ/" folder "テンプレート/" folder "assets/" } component "JBake CLI" as jbake Sources --> jbake : jbake -b } node "ビルドサーバー (CI/CD)" { component "GitHub Actions または GitLab CI" as ci jbake --> ci : push } cloud "CDN / ホスティング" { node "静的Webサーバー" { artifact "生成されたサイト" { folder "/fr/blog/" folder "/en/blog/" folder "/assets/" } } } ci --> "生成されたサイト" : déploiement actor "読者" as users users --> "静的Webサーバー" : HTTPS @enduml</pre> </div> </div> <div class="paragraph"> <p>このアーキテクチャは、2つの言語でシンプルに始められ、大規模なリファクタリングなしに他の言語を追加することもできます。全体は完全に静的で高性能であり、JBakeの哲学に忠実です。</p> </div> <div class="paragraph"> <p>良い多言語開発！ 🌍</p> </div> </div> </div> </div> https://cheroliv.com/blog/2025/0094_tor_browser_install_post.html Sun, 5 Oct 2025 00:00:00 +0000 blog/2025/0094_tor_browser_install_post.html <div id="toc" class="toc"> <div id="toctitle">Table of Contents</div> <ul class="sectlevel1"> <li><a href="#_導入">導入</a></li> <li><a href="#_tor_とその署名のダウンロード">Tor とその署名のダウンロード</a></li> <li><a href="#_署名の暗号学的検証">署名の暗号学的検証</a> <ul class="sectlevel2"> <li><a href="#_1_tor_プロジェクトの公開鍵をインポートする">1. Tor プロジェクトの公開鍵をインポートする</a></li> <li><a href="#_2_署名を確認">2. 署名を確認</a></li> <li><a href="#_実践例有効な署名だが認証されていない鍵">実践例：有効な署名だが、認証されていない鍵</a></li> </ul> </li> <li><a href="#_署名を確認する理由は">署名を確認する理由は？</a></li> <li><a href="#_tor_browser_の抽出と起動">Tor Browser の抽出と起動</a></li> <li><a href="#_ubuntu_デスクトップへの統合">Ubuntu デスクトップへの統合</a></li> <li><a href="#_torを使って教育リソースを探索する">Torを使って教育リソースを探索する</a></li> <li><a href="#_tor_browserのアップデート">Tor Browserのアップデート</a></li> <li><a href="#_結論">結論</a></li> <li><a href="#_参照">参照</a></li> </ul> </div> <div class="sect1"> <h2 id="_導入">導入</h2> <div class="sectionbody"> <div class="paragraph"> <p>デジタルプライバシーがますます脅かされる世界では、<strong>Tor Browser</strong> は匿名性と情報の自由を守るために不可欠なツールのままです。 しかし、ダウンロードしたソフトウェアを、何も持たずに決して実行してはいけない<strong>その真正性を確認した</strong>. この記事では、次のための包括的な方法を提示します：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>Tor Browser</strong> とその署名をダウンロード`.asc`</p> </li> <li> <p>ダウンロードしたファイルの有効性を確認する</p> </li> <li> <p>Ubuntuで*Tor Browser*をインストールして起動する</p> </li> <li> <p>デスクトップメニューに追加して日常的に使用する</p> </li> <li> <p>Torを介して教育リソースと倫理的OSINTを探索する</p> </li> </ol> </div> </div> </div> <div class="sect1"> <h2 id="_tor_とその署名のダウンロード">Tor とその署名のダウンロード</h2> <div class="sectionbody"> <div class="paragraph"> <p>Tor ブラウザ専用のフォルダーを作成してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">mkdir -p ~/workspace/tipiak/tor cd ~/workspace/tipiak/tor</code></pre> </div> </div> <div class="paragraph"> <p>次に、Torブラウザのアーカイブとその署名をダウンロードしてください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">wget https://www.torproject.org/dist/torbrowser/14.5.7/tor-browser-linux-x86_64-14.5.7.tar.xz wget https://www.torproject.org/dist/torbrowser/14.5.7/tor-browser-linux-x86_64-14.5.7.tar.xz.asc</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_署名の暗号学的検証">署名の暗号学的検証</h2> <div class="sectionbody"> <div class="paragraph"> <p>このステップは<strong>不可欠</strong>ダウンロードしたファイルが*Tor Project*のものであり、改ざんされていないことを確認するために。</p> </div> <div class="sect2"> <h3 id="_1_tor_プロジェクトの公開鍵をインポートする">1. Tor プロジェクトの公開鍵をインポートする</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">gpg --auto-key-locate nodefault,wkd --locate-keys torbrowser@torproject.org</code></pre> </div> </div> <div class="paragraph"> <p>キーが正しくインポートされていることを確認してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">gpg --list-keys torbrowser@torproject.org</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_2_署名を確認">2. 署名を確認</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">gpg --verify tor-browser-linux-x86_64-14.5.7.tar.xz.asc tor-browser-linux-x86_64-14.5.7.tar.xz</code></pre> </div> </div> <div class="paragraph"> <p>すべてが正しければ、次のメッセージが表示されます：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">gpg: Good signature from "Tor Browser Developers (signing key)"</code></pre> </div> </div> <div class="paragraph"> <p>警告が未認証の鍵について表示される場合、これは単にTor Projectの信頼できる鍵にまだ署名していないだけで、署名は依然として有効です。</p> </div> </div> <div class="sect2"> <h3 id="_実践例有効な署名だが認証されていない鍵">実践例：有効な署名だが、認証されていない鍵</h3> <div class="paragraph"> <p>確認時にこのようなメッセージに遭遇することはよくあります：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">gpg --verify tor-browser-linux-x86_64-14.5.7.tar.xz.asc tor-browser-linux-x86_64-14.5.7.tar.xz gpg: Signature faite le mar. 16 sept. 2025 14:26:26 CEST gpg: avec la clef RSA CAAE408AEBE2288E96FC5D5E157432CF78A65729 gpg: Bonne signature de « Tor Browser Developers (signing key) <torbrowser@torproject.org> » [inconnu] gpg: Attention : cette clef n'est pas certifiée avec une signature de confiance. gpg: Rien n'indique que la signature appartient à son propriétaire. Empreinte de clef principale : EF6E 286D DA85 EA2A 4BA7 DE68 4E2C 6E87 9329 8290 Empreinte de la sous-clef : CAAE 408A EBE2 288E 96FC 5D5E 1574 32CF 78A6 5729</code></pre> </div> </div> <div class="paragraph"> <p>このメッセージは、署名は技術的に「良い」（ファイルは変更されていない）ことを示していますが、GPGシステムは鍵自身への*信頼の証明*を行うことができません。この疑問を払拭するために、メイン鍵のフィンガープリントを比較することが不可欠です。 (<code>EF6E 286D DA85 EA2A 4BA7 DE68 4E2C 6E87 9329 8290</code>) Tor Projectの公式サイトに掲載されたものと</p> </div> <div class="paragraph"> <p>公式サイトによると、期待されるフィンガープリントは：<code>EF6E286DDA85EA2A4BA7DE684E2C6E8793298290</code>.</p> </div> <div class="paragraph"> <p>表示された足跡によって`gpg`公式サイトのものと*正確に*一致すれば、そのキーが正当でありファイルが安全であることを確信できます。「未認証のキー」の警告は、そのときはあなたのGPGローカル設定に関する情報であり、署名の有効性やファイルの真正性については関係ありません。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_署名を確認する理由は">署名を確認する理由は？</h2> <div class="sectionbody"> <div class="paragraph"> <p>GPG署名の検証は、デジタルセキュリティにおける基本的な行為です。 次のことができます:</p> </div> <div class="ulist"> <ul> <li> <p>保証する<strong>真正性</strong>ダウンロードされたソフトウェア</p> </li> <li> <p>悪意ある攻撃者によって侵害されたファイルのインストールを防止する</p> </li> <li> <p>参加する<strong>デジタル主権</strong>個人的な</p> </li> <li> <p>�責任ある倫理的なデジタル文化を促進する</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre>@startuml left to right direction actor "ユーザー" as U actor "TorProjectサーバー" as S usecase "Tor とその署名をダウンロード" as D usecase "公開鍵をインポート" as K usecase "GPG署名を確認" as V usecase "Torをインストールして起動" as I U --> D U --> K U --> V U --> I S --> D @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_tor_browser_の抽出と起動">Tor Browser の抽出と起動</h2> <div class="sectionbody"> <div class="paragraph"> <p>ダウンロードしたアーカイブを解凍してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">tar -xvf tor-browser-linux-x86_64-14.5.7.tar.xz cd tor-browser</code></pre> </div> </div> <div class="paragraph"> <p>次にブラウザを起動してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./start-tor-browser.desktop</code></pre> </div> </div> <div class="paragraph"> <p>最初の起動時に、Torネットワークへの接続を確立するために設定ウィンドウが開きます。</p> </div> </div> </div> <div class="sect1"> <h2 id="_ubuntu_デスクトップへの統合">Ubuntu デスクトップへの統合</h2> <div class="sectionbody"> <div class="paragraph"> <p>アプリケーションメニューに <strong>Tor Browser</strong> を追加 :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./start-tor-browser.desktop --register-app</code></pre> </div> </div> <div class="paragraph"> <p>その後、</p> </div> <div class="ulist"> <ul> <li> <p>アプリケーションメニューから*Tor Browser*を起動</p> </li> <li> <p>ドックのお気に入りに追加</p> </li> <li> <p>キーボードショートカットを作成する（希望する場合）</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre>@startuml start :Téléchargement de Tor; :Importation de la clé GPG; :Vérification de la signature; if (Signature valide ?) then (Oui) :Extraction du navigateur; :Lancement du navigateur Tor; :Enregistrement dans le bureau; else (Non) :Supprimer le fichier compromis; endif stop @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_torを使って教育リソースを探索する">Torを使って教育リソースを探索する</h2> <div class="sectionbody"> <div class="paragraph"> <p>Torは匿名化のためのツールだけではありません。 これは教育および研究資源へのアクセスポータルを構成し、特に次の分野において：</p> </div> <div class="ulist"> <ul> <li> <p><strong>OSINT (オープンソースインテリジェンス)</strong></p> </li> <li> <p><a href="https://inteltechniques.com">https://inteltechniques.com</a></p> </li> <li> <p><a href="https://osintframework.com">https://osintframework.com</a></p> </li> <li> <p><strong>教育的な共有とオープンソース</strong></p> </li> <li> <p><a href="https://archive.org">https://archive.org</a>(アクセス via Tor でプライバシーを向上)</p> </li> <li> <p><a href="https://github.com/">https://github.com/</a>(Torを通じて閲覧可能)</p> </li> <li> <p><a href="https://librarygenesis.pro">https://librarygenesis.pro</a>(科学文献への自由アクセス)</p> </li> <li> <p><strong>知識の伝達とデジタル社会における人間の理解</strong></p> </li> <li> <p>デジタル文化、表現の自由、知識へのアクセスに関するリソース</p> </li> <li> <p>サイバーセキュリティと技術の倫理に関するオープンなドキュメンテーション</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_tor_browserのアップデート">Tor Browserのアップデート</h2> <div class="sectionbody"> <div class="paragraph"> <p>最適なセキュリティを確保するために、<strong>Tor Browser</strong> を最新の状態に保つことが重要です。このブラウザには自動アップデート機能が組み込まれており、コマンドラインからトリガーすることができます。</p> </div> <div class="paragraph"> <p>Tor Browserのインストールディレクトリから、スタートスクリプトを再起動するだけです：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">cd ~/workspace/tipiak/tor/tor-browser ./start-tor-browser.desktop</code></pre> </div> </div> <div class="paragraph"> <p>起動時に、<strong>Tor Browser</strong> は自動的に新しいバージョンが存在するかを確認します。存在する場合は、それをダウンロードしてインストールします。</p> </div> <div class="paragraph"> <p>このシンプルな方法は、常に最新のセキュリティパッチと最新の改善が適用されていることを保証します。これは、安全なブラウジングに不可欠です。</p> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>ダウンロードを確認することは、安全なデジタル環境で成長したいすべての人にとって必須の習慣です。 Torを検証済みの方法でインストールすることは<strong>デジタルの整合性を守る</strong>, <strong>フリーソフトウェアへの信頼を保つ</strong>, et <strong>情報自立性を強化する</strong>。</p> </div> <div class="paragraph"> <p>デジタルセキュリティは、 妄想ではなく、 良心に基づく行為である。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml title Torの使用の概要 actor Utilisateur rectangle "Tor ブラウザ" { rectangle "匿名" as A rectangle "OSINT調査" as O rectangle "教育的な共有" as E } Utilisateur --> A Utilisateur --> O Utilisateur --> E @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_参照">参照</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>Tor Projectの公式サイト:https://www.torproject.org/download/[<a href="https://www.torproject.org/download/" class="bare">https://www.torproject.org/download/</a>]</p> </li> <li> <p>署名検証ドキュメント：https://support.torproject.org/tbb/how-to-verify-signature/[<a href="https://support.torproject.org/tbb/how-to-verify-signature/" class="bare">https://support.torproject.org/tbb/how-to-verify-signature/</a>]</p> </li> <li> <p>Ubuntuドキュメント：https://ubuntu.com[<a href="https://ubuntu.com" class="bare">https://ubuntu.com</a>]</p> </li> <li> <p>教育的アーカイブ :https://archive.org/details/opensource[<a href="https://archive.org/details/opensource" class="bare">https://archive.org/details/opensource</a>]</p> </li> </ul> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p>この記事は、*セキュリティとデジタル意識*シリーズの一部です。 責任のある教育的な実践を促進することを目的とする フリーのツールを中心に</p> </div> </td> </tr> </table> </div> </div> </div> https://cheroliv.com/blog/2025/0093_gradle_plugin_toml_composite_build_post.html Sat, 27 Sep 2025 00:00:00 +0000 blog/2025/0093_gradle_plugin_toml_composite_build_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_はじめに">はじめに</a></li> <li><a href="#_1_バージョンカタログ_libs_versions_toml_リマインダー">1. バージョンカタログ (<code>libs.versions.toml</code>) : リマインダー</a></li> <li><a href="#_2_問題複合ビルドと二つの別々な世界">2. 問題：複合ビルドと二つの別々な世界</a></li> <li><a href="#_3_解決策依存関係の解決の共有">3. 解決策:依存関係の解決の共有</a></li> <li><a href="#_4_結論適切に管理されたコンポジットビルドの力">4. 結論：適切に管理されたコンポジットビルドの力</a></li> </ul> </div> <div class="sect1"> <h2 id="_はじめに">はじめに</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">対象ユーザー：マルチビルドプロジェクトでの依存関係管理に直面しているGradle開発者</div> <p>プラグインを作るための私たちの探求の中で`site-baker`私たちはクリーンで集中されたコードベースを維持しようと努めてきました。現代のGradleエコシステムにおけるベストプラクティスの一つは、の使用です<strong>バージョンカタログ</strong> (<code>libs.versions.toml</code>) で依存関係を管理するために。 しかし、プロジェクトがより複雑になるとどうなるでしょうか、例えば<strong>複合をビルド</strong>ここで、独立したビルド（私たちのプラグイン）は他のものに含めなければなりませんか？</p> </div> <div class="paragraph"> <p>そこが私たちの冒険が思いがけない転機を迎えた場所だった。私たちは私たちのプラグインが`site-baker`, それ自体が Gradle プロジェクトである、私たちのメインプロジェクトと同じバージョン カタログを使用します。 この記事は、私たちのシリーズの第五回目で、その課題をどのように解決したかを説明しています。</p> </div> </div> </div> <div class="sect1"> <h2 id="_1_バージョンカタログ_libs_versions_toml_リマインダー">1. バージョンカタログ (<code>libs.versions.toml</code>) : リマインダー</h2> <div class="sectionbody"> <div class="paragraph"> <p>ファイル`gradle/libs.versions.toml`Gradleの機能で、プロジェクトの依存関係のバージョンと座標を一元管理することができます。通常、4つのセクションに構成されています：</p> </div> <div class="ulist"> <ul> <li> <p><code>[versions]</code>: バージョン番号のエイリアスを定義します (例:`kotlin = "1.9.20"`).</p> </li> <li> <p><code>[libraries]</code>: 完全な依存関係のエイリアスを設定します。上で定義したバージョンを使用します（例:`kotlin-stdlib = { module = "org.jetbrains.kotlin:kotlin-stdlib", version.ref = "kotlin" }`)</p> </li> <li> <p><code>[bundles]`複数のライブラリを単一のエイリアスにグループ化（例：`jackson = ["jackson-core", "jackson-databind"]</code>).</p> </li> <li> <p>`[plugins]`Gradle プラグインのエイリアスを定義します。</p> </li> </ul> </div> <div class="paragraph"> <p>定義すると、Gradle は自動的に型付きアクセッサを生成し、これによりあなたの`build.gradle.kts`ずっと読みやすい :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">dependencies { // Au lieu de : implementation("org.jetbrains.kotlin:kotlin-stdlib:1.9.20") implementation(libs.kotlin.stdlib) }</code></pre> </div> </div> <div class="listingblock"> <div class="title">バージョン カタログのデータフロー</div> <div class="content"> <pre>@startuml !theme plain file "gradle/libs.versions.toml" as Toml node "Gradle" as G file "build.gradle.kts" as BuildScript Toml --> G : "によって読まれている" G --> BuildScript : "アクセッサを生成 `libs" BuildScript -> G : "libs` を使用して 依存関係を宣言する" @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_2_問題複合ビルドと二つの別々な世界">2. 問題：複合ビルドと二つの別々な世界</h2> <div class="sectionbody"> <div class="paragraph"> <p>私たちのプロジェクト構造は<strong>ビルド コンポジット</strong>. 主要なプロジェクト (<code>thymeleaf.cheroliv.com</code>) プラグインのプロジェクトを含む (<code>site-baker</code>) コマンド経由で`includeBuild("site-baker")<code>ファイルの中に`settings.gradle.kts</code>。</p> </div> <div class="listingblock"> <div class="title">コンポジットビルドの構造</div> <div class="content"> <pre>@startuml !theme plain package "主要プロジェクト" { file "settings.gradle.kts" as MainSettings folder "グレードル" { file "libs.versions.toml" as MainToml } } package "プラグイン `site-baker` (Build Inclus)" { file "settings.gradle.kts" as PluginSettings file "build.gradle.kts" as PluginBuild } MainSettings -> PluginSettings : `includeBuild("サイトベーカー")` PluginBuild ..> MainToml : **Voulait accéder à...** note right on link: ...mais ne pouvait pas ! @enduml</pre> </div> </div> <div class="paragraph"> <p>問題は、デフォルトでは、インクルードされたビルドは<strong>別世界</strong>. 自分固有の設定があり、自分固有のライフサイクルがあり、ファイルを見ません。<code>libs.versions.toml`メインビルドの。 私たちの`plugin/build.gradle.kts`使おうと試みていた`libs.plugins.kotlin.jvm</code>, しかしオブジェクト`libs` n’était pas généré à partir du bon fichier TOML, provoquant des erreurs de build.</p> </div> </div> </div> <div class="sect1"> <h2 id="_3_解決策依存関係の解決の共有">3. 解決策:依存関係の解決の共有</h2> <div class="sectionbody"> <div class="paragraph"> <p>何度か調べた結果、解決策はこのケースのために正確に設計されたGradleの機能であることがわかりました：<code>dependencyResolutionManagement</code>.</p> </div> <div class="paragraph"> <p>ファイル内`settings.gradle.kts` du <strong>包括的な構築</strong>(<code>site-baker/settings.gradle.kts</code>), Gradleに使用するバージョンカタログの場所を伝えることができます。</p> </div> <div class="paragraph"> <p>ここに、私たちが追加した設定に`site-baker/settings.gradle.kts`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// site-baker/settings.gradle.kts dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { gradlePluginPortal() mavenCentral() } versionCatalogs { create("libs") { from(files("../gradle/libs.versions.toml")) } } } rootProject.name = "site-baker" include("plugin")</code></pre> </div> </div> <div class="paragraph"> <p>重要な部分を分析しましょう：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">versionCatalogs { create("libs") { // Crée un catalogue nommé 'libs' from(files("../gradle/libs.versions.toml")) // En utilisant ce fichier } }</code></pre> </div> </div> <div class="ulist"> <ul> <li> <p><code>create("libs")</code>: 私たちは、エイリアスを通じてアクセスできるバージョンのカタログを宣言します。<code>libs</code>.</p> </li> <li> <p><code>from(files("../gradle/libs.versions.toml"))</code>: これが魔法です。 私たちはGradleに、このカタログのソースがこのディレクトリ内にあるTOMLファイルであることを伝えます。<code>gradle</code> du <strong>親プロジェクト</strong>(<code>../</code>“).”</p> </li> </ul> </div> <div class="paragraph"> <p>この設定では、ビルド`site-baker`彼は今、メインプロジェクトのバージョンカタログを使用しなければならないことを知っている。オブジェクト`libs`正しく生成され、依存関係は予定通りに解決されます。</p> </div> </div> </div> <div class="sect1"> <h2 id="_4_結論適切に管理されたコンポジットビルドの力">4. 結論：適切に管理されたコンポジットビルドの力</h2> <div class="sectionbody"> <div class="paragraph"> <p>この経験は多くの教訓を得るものでした。バージョンカタログは保守性に優れた素晴らしいツールですが、複合ビルドシナリオでのその動作は必ずしも直感的ではありません。</p> </div> <div class="paragraph"> <p>ポイントは、インクルードされたビルドでも独立したビルドのままであることを覚えておくことです。バージョンカタログのような設定を共有するには、Gradleが提供する明示的なメカニズム、例えばブロックを使用する必要があります。<code>dependencyResolutionManagement`中`settings.gradle.kts</code>.</p> </div> <div class="paragraph"> <p>この問題を解決することで、私たちのビルドをきれいにするだけでなく、プラグインとメインプロジェクトが依存関係について唯一の真実のソースを共有することを確認することで、プロジェクトの一貫性も強化しました。</p> </div> <div class="paragraph"> <p>次の記事では、依存関係の管理が堅牢かつ集中化された今、さらに複雑なタスクを追加することでプラグインを充実させていきます。</p> </div> </div> </div> https://cheroliv.com/blog/2025/0092_gradle_configuration_cache_post.html Fri, 26 Sep 2025 00:00:00 +0000 blog/2025/0092_gradle_configuration_cache_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_導入">導入</a></li> <li><a href="#_症状幽霊ビルド">症状：幽霊ビルド</a></li> <li><a href="#_調査構成キャッシュとは何ですか">調査：構成キャッシュとは何ですか？</a></li> <li><a href="#_問題の原因_適合していないプラグイン">問題の原因: 適合していないプラグイン</a></li> <li><a href="#_一時的なソリューションキャッシュを無効にする">一時的なソリューション：キャッシュを無効にする</a></li> <li><a href="#_真の解決策プラグインを互換性を持たせる">真の解決策：プラグインを互換性を持たせる</a></li> </ul> </div> <div class="sect1"> <h2 id="_導入">導入</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">対象 : すでに "magiques" または予期しないビルドの挙動に遭遇した Gradle 開発者</div> <p>私たちのプラグイン作成の冒険で`site-baker`, 我々は TDD を厳格に実践しました。各機能はテストされ、検証され、そして我々は確信を持って進んでいきました。そしてある日、予期せぬことが起こりました。ビルドは予測不能な動作を始めました。プラグインのロジックや設定ファイルの変更が無視されているかのように見え、かつて信頼できた機能テストも理由もなく失敗し始めました。</p> </div> <div class="paragraph"> <p>この種の問題は信じがたいほどイライラさせることがあります。これはツールの信頼性と私たちのコードの妥当性を疑問視します。激しいデバッグセッションの後、犯人が特定されました：その<strong>Gradleの設定キャッシュ</strong>。</p> </div> </div> </div> <div class="sect1"> <h2 id="_症状幽霊ビルド">症状：幽霊ビルド</h2> <div class="sectionbody"> <div class="paragraph"> <p>問題は様々な形で現れていた：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>タスク内の文字列を編集していた`println`, しかし古い文字列は実行時に表示され続けた。</p> </li> <li> <p>ファイルの中で値を変更していた。`managed-jbake-context.yml`しかし、プラグインはファイルが変更されていないかのように振る舞った。</p> </li> <li> <p>機能テストは、その場でテストプロジェクトを作成するものですが、プラグインが新しく作成された設定ファイルを検出しているようには見えず、失敗していました。</p> </li> </ol> </div> <div class="paragraph"> <p>まるで Gradle が私たちのビルドの「幽霊バージョン」を実行しているかのように、すべてが進行していました。最新の変更を無視して。</p> </div> </div> </div> <div class="sect1"> <h2 id="_調査構成キャッシュとは何ですか">調査：構成キャッシュとは何ですか？</h2> <div class="sectionbody"> <div class="paragraph"> <p>構成キャッシュは、比較的新しい機能であり、Gradleの非常に強力な機能です。新しいバージョンではデフォルトで有効になっています。その目的は、ビルドをより速くすることです。</p> </div> <div class="olist arabic"> <div class="title">原理は単純です：</div> <ol class="arabic"> <li> <p>最初の実行時に、Gradle は フェーズ を実行します<strong>設定</strong>(の読み取り`build.gradle.kts`, タスクの作成, 依存関係の解決) と タスクグラフを構築します。</p> </li> <li> <p>このフェーズの終わりに、Gradle<strong>このタスクグラフをシリアライズして</strong>そしてそれをキャッシュに保存します。</p> </li> <li> <p>次の実行時に何も変更されていない場合（ビルドスクリプトが,<code>gradle.properties</code>, など), Gradle<strong>設定フェーズを完全にスキップする</strong>そしてキャッシュされたタスクグラフを再利用します。</p> </li> </ol> </div> <div class="paragraph"> <p>大規模なプロジェクトでは時間の節約が驚くほど顕著です。ただし、このパフォーマンスにはコストが伴います：プラグインの記述方法に厳格なルールを課します。</p> </div> <div class="listingblock"> <div class="title">構成キャッシュのライフサイクル</div> <div class="content"> <pre>@startuml start :Première exécution; :Phase de Configuration; :Création du graphe de tâches; :Mise en cache du graphe; :Phase d'Exécution; end start :Exécution suivante; if (Cache valide ?) then (oui) :Restauration du graphe depuis le cache; note right La phase de configuration est sautée ! end note else (non) :Phase de Configuration; :Mise à jour du cache; endif :Phase d'Exécution; stop @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_問題の原因_適合していないプラグイン">問題の原因: 適合していないプラグイン</h2> <div class="sectionbody"> <div class="paragraph"> <p>私たちのプラグイン`site-baker`無意識のうちに、設定キャッシュのいくつかのルールを違反していた。タスクグラフがシリアライズ可能であるためには、タスクはオブジェクトなどの複雑なオブジェクトへの参照を含んではならない。`Project`または、実行フェーズ中に任意のファイルを読み込むことができます。</p> </div> <div class="paragraph"> <p>私たちの主な間違いは、タスクの実行ロジック内でYAMLファイルの内容を直接読み込んでいたことです。これは、拡張機能に保存されているパスへの参照を使用して行われました。このアプローチは、この読み込みがモデル化されていないような場合、Gradleがファイルの内容が変更されたかどうかを知ることができないため、キャッシュと互換性がありません。<strong>タスクエントリ</strong> (Task Input).</p> </div> </div> </div> <div class="sect1"> <h2 id="_一時的なソリューションキャッシュを無効にする">一時的なソリューション：キャッシュを無効にする</h2> <div class="sectionbody"> <div class="paragraph"> <p>私たちのブロックを解除し、予測可能なビルド動作を取り戻すために、最も速い方法は設定キャッシュを無効にすることでした。ファイルに以下の行を追加するだけです`gradle.properties`プラグインを使用しているプロジェクト（または私たちの場合、テストプロジェクト）の`site-baker`).</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties"># site-baker/gradle.properties org.gradle.configuration-cache=false</code></pre> </div> </div> <div class="paragraph"> <p>瞬時に、ビルドは通常の動作を取り戻しました。各実行が構成フェーズを再起動し、私たちの変更が考慮されました。</p> </div> <div class="paragraph"> <p>ただし、これは回避策であり、持続可能な解決策ではありません。パフォーマンスを犠牲にし、プラグインの根本的な問題を解決しません。</p> </div> </div> </div> <div class="sect1"> <h2 id="_真の解決策プラグインを互換性を持たせる">真の解決策：プラグインを互換性を持たせる</h2> <div class="sectionbody"> <div class="paragraph"> <p>プラグインが現代のGradleエコシステムの良い市民であるためには、設定キャッシュと互換性がある必要があります。これは、データがタスクに流れる方法を見直すことを意味します。</p> </div> <div class="paragraph"> <p>キーはそれらを使うことです<strong>プロバイダーのAPI</strong>Gradleの。 直接の値を渡す代わりに（例えば`String` ou un <code>File</code>) 私たちのタスクに対して、私たちは何かを通過しなければならない`Property<T>`または`Provider<T>`.</p> </div> <div class="olist arabic"> <div class="title">以下はリファクタリング計画です：</div> <ol class="arabic"> <li> <p><strong>タスクエントリを宣言する :</strong>YAMLファイルをパースするタスクは、このファイルを入力として宣言しなければなりません。そのためにアノテーションを使用します。<code>@InputFile</code>。</p> </li> </ol> </div> <div class="paragraph"> <p>[source,kotlin] python</p> </div> <div class="listingblock"> <div class="content"> <pre></pre> </div> </div> </div> </div> https://cheroliv.com/blog/2025/0091_jackson_yaml_tdd_post.html Thu, 25 Sep 2025 00:00:00 +0000 blog/2025/0091_jackson_yaml_tdd_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_導入">導入</a></li> <li><a href="#_1_コンテキスト_私たちのプラグイン_site_baker">1. コンテキスト: 私たちのプラグイン `site-baker</a></li> <li><a href="#_2_kotlin_での設定のモデリング">2. Kotlin での設定のモデリング</a></li> <li><a href="#_3_jacksonのbuild_gradle_ktsへの統合">3. Jacksonの`build.gradle.kts`への統合</a></li> <li><a href="#_4_tddアプローチyamlパースのテスト">4. TDDアプローチ：YAMLパースのテスト</a> <ul class="sectlevel2"> <li><a href="#_4_1_単体テスト_yamlをkotlinオブジェクトにマッピング">4.1. 単体テスト: YAMLをKotlinオブジェクトにマッピング</a></li> <li><a href="#_4_2_機能テスト構成ファイルの読み取りを検証する">4.2. 機能テスト：構成ファイルの読み取りを検証する</a></li> </ul> </li> <li><a href="#_5_パースフローの可視化">5. パースフローの可視化</a></li> <li><a href="#_結論">結論</a></li> </ul> </div> <div class="sect1"> <h2 id="_導入">導入</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">対象 : 中級 Gradle 開発者で、複雑な設定を管理したい人</div> <p>Gradleプラグインの開発において、複雑な構成の管理は一般的な作業です。DSLに数百のプロパティを詰め込むのではなく、外部ファイル、例えばYAMLに設定を定義するほうが、すっきりしており保守しやすいことが多いです。この記事では、強力なJacksonライブラリを使ってYAMLファイルをKotlinオブジェクトにパースする統合方法を、厳格なTDDアプローチを採用してプラグインの堅牢性を確保する形でガイドします。<code>site-baker</code>。</p> </div> </div> </div> <div class="sect1"> <h2 id="_1_コンテキスト_私たちのプラグイン_site_baker">1. コンテキスト: 私たちのプラグイン `site-baker</h2> <div class="sectionbody"> <div class="paragraph"> <p>私たちのプラグイン`site-baker`は、静的サイトの生成とデプロイを自動化するように設計されています。YAML設定ファイルを読み込む必要があります (<code>managed-jbake-context.yml</code>) ソースのパス、デプロイ先、Gitの識別子などの情報を取得するために。</p> </div> <div class="paragraph"> <p>パースしたいYAML設定はこのようになります：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">bake: srcPath: "./site/jbake" destDirPath: "bake" cname: "cheroliv.com" pushPage: from: "bake" to: "cvs" repo: name: "trainings" repository: "https://github.com/pages-content/pages-content.github.io.git" credentials: username: "USERNAME" password: "SECRET_TOKEN" branch: "main" message: "cheroliv.com" # ... autres configurations (pushMaquette, supabase, etc.)</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_2_kotlin_での設定のモデリング">2. Kotlin での設定のモデリング</h2> <div class="sectionbody"> <div class="paragraph"> <p>パースする前に、Kotlinでデータの構造を定義する必要があります。Jacksonはこれらのクラスを使用してYAMLコンテンツを自動的にマッピングします。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// plugin/src/main/kotlin/com/cheroliv/site/baker/data/SiteConfiguration.kt package com.cheroliv.site.baker.data import com.fasterxml.jackson.databind.ObjectMapper import com.fasterxml.jackson.dataformat.yaml.YAMLFactory import com.fasterxml.jackson.module.kotlin.readValue import com.fasterxml.jackson.module.kotlin.registerKotlinModule fun parseSiteConfiguration(yaml: String): SiteConfiguration { val mapper = ObjectMapper(YAMLFactory()).registerKotlinModule() return mapper.readValue(yaml) } data class GitPushConfiguration( val from: String = "", val to: String = "", val repo: RepositoryConfiguration = RepositoryConfiguration(), val branch: String = "", val message: String = "", ) data class RepositoryConfiguration( val name: String = "", val repository: String = "", val credentials: RepositoryCredentials = RepositoryCredentials(), ) { companion object { const val ORIGIN = "origin" const val CNAME = "CNAME" const val REMOTE = "remote" } } data class RepositoryCredentials(val username: String = "", val password: String = "") data class SiteConfiguration( val bake: BakeConfiguration = BakeConfiguration(), val pushPage: GitPushConfiguration = GitPushConfiguration(), val pushMaquette: GitPushConfiguration = GitPushConfiguration(), val pushSource: GitPushConfiguration? = null, val pushTemplate: GitPushConfiguration? = null, val supabase: SupabaseContactFormConfig? = null ) data class BakeConfiguration( val srcPath: String = "", val destDirPath: String = "", val cname: String? = null, ) // ... (autres data classes pour Supabase, si nécessaire)</code></pre> </div> </div> <div class="paragraph"> <p>機能`parseSiteConfiguration`これはデシリアライズのエントリーポイントです。使用します`ObjectMapper`Jacksonの、設定済みの`YAMLFactory`YAMLフォーマットに対して`registerKotlinModule()`Kotlinの特殊機能のサポート（例えばプロパティのデフォルト値など）のため。</p> </div> </div> </div> <div class="sect1"> <h2 id="_3_jacksonのbuild_gradle_ktsへの統合">3. Jacksonの`build.gradle.kts`への統合</h2> <div class="sectionbody"> <div class="paragraph"> <p>Jacksonを使用するには、必要な依存関係を追加する必要がありますの`build.gradle.kts`私たちのモジュールの`plugin`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// plugin/build.gradle.kts dependencies { // Jackson for YAML parsing implementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.18.3") implementation("com.fasterxml.jackson.dataformat:jackson-dataformat-yaml:2.18.3") // ... autres dépendances }</code></pre> </div> </div> <div class="paragraph"> <p>私たちは使用します`jackson-module-kotlin`Kotlinのサポートのためにおよび`jackson-dataformat-yaml`YAML形式の管理のために。</p> </div> </div> </div> <div class="sect1"> <h2 id="_4_tddアプローチyamlパースのテスト">4. TDDアプローチ：YAMLパースのテスト</h2> <div class="sectionbody"> <div class="paragraph"> <p>今、TDDを適用してパースロジックを検証しましょう。</p> </div> <div class="sect2"> <h3 id="_4_1_単体テスト_yamlをkotlinオブジェクトにマッピング">4.1. 単体テスト: YAMLをKotlinオブジェクトにマッピング</h3> <div class="paragraph"> <p>私たちは単体テストで始めます`SiteBakerPluginTest.kt`関数が機能しているかを確認するために`parseSiteConfiguration`YAML文字列をオブジェクトに正しく変換できます`SiteConfiguration`.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// plugin/src/test/kotlin/com/cheroliv/site/baker/SiteBakerPluginTest.kt @Test fun `can map configuration text to SiteConfiguration object`() { val yamlString = "../../managed-jbake-context.yml" .run(::File) .readText() .trimIndent() val config: SiteConfiguration = parseSiteConfiguration(yamlString) assertEquals("cheroliv.com", config.bake.cname) assertEquals("main", config.pushPage.branch) assertEquals("https://github.com/pages-content/pages-content.github.io.git", config.pushPage.repo.repository) }</code></pre> </div> </div> <div class="paragraph"> <p>このテストはファイルの内容を読み込みます`managed-jbake-context.yml`(テストが有効であるために存在しなければならない)およびオブジェクトに対するアサーションを実行する`SiteConfiguration`結果として。 YAML のキーの値が正しくマッピングされていることを検証します。</p> </div> </div> <div class="sect2"> <h3 id="_4_2_機能テスト構成ファイルの読み取りを検証する">4.2. 機能テスト：構成ファイルの読み取りを検証する</h3> <div class="paragraph"> <p>プラグインがそのDSLを通じて設定ファイルを読み取ることができ、実際のGradle環境でパースが機能することを確認するために、私たちは機能テストを追加します`SiteBakerPluginFunctionalTest.kt`。</p> </div> <div class="paragraph"> <p>このテストは重要です。なぜなら、実際のプロジェクトでのプラグインの実行をシミュレートするからです。これが必要です<strong>密閉</strong>, すなわち彼は自分でファイルを作成しなければならない`managed-jbake-context.yml`制御されたコンテンツを使用して、テストの再現性と隔離を保証します。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// plugin/src/functionalTest/kotlin/com/cheroliv/site/baker/SiteBakerPluginFunctionalTest.kt @Test fun `config file contains good data`(){ val configContent = configFile.readText(UTF_8) // Vérifications comme dans vos commentaires assertTrue(configContent.contains("bake")) assertTrue(configContent.contains("pushPage")) assertTrue(configContent.contains("repository")) }</code></pre> </div> </div> <div class="paragraph"> <p>この機能テストは、テストの一時ディレクトリにコピーされた設定ファイルに期待されるデータが含まれていることを確認します。このテストは直接 YAML を Kotlin オブジェクトにパースしませんが、ファイルとその内容の存在を検証し、これはプラグインによるパースに必要な前提条件となります。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_5_パースフローの可視化">5. パースフローの可視化</h2> <div class="sectionbody"> <div class="paragraph"> <p>次の図は、YAML 設定のパース時のデータフローとインタラクションを示しています：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml actor "Gradle ユーザー" as User participant "build.gradle.kts" as BuildScript participant "SiteBakerPlugin" as Plugin participant "サイトエクステンション" as Extension participant "managed-jbake-context.yml" as ConfigFile participant "parseSiteConfiguration()" as Parser participant "SiteConfiguration ( Kotlin オブジェクト )" as KotlinObject User -> BuildScript : Applique le plugin et configure le DSL BuildScript -> Plugin : apply() Plugin -> Extension : Crée et enregistre l'extension 'site' User -> BuildScript : site { configPath = "..." } BuildScript -> Extension : Définit configPath Plugin -> ConfigFile : Lit le fichier (via configPath) ConfigFile --> Plugin : Contenu YAML Plugin -> Parser : Appelle parseSiteConfiguration(yamlString) Parser -> KotlinObject : Mappe le YAML en objet SiteConfiguration KotlinObject --> Plugin : Retourne l'objet configuré @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>TDDのアプローチを取ることで、Jacksonライブラリを使用してYAML設定ファイルをKotlinオブジェクトにパースし、Gradleプラグインに正常に組み込むことができました。この方法により、以下のことが可能になりました：</p> </div> <div class="ulist"> <ul> <li> <p><strong>明確にモデリング</strong>私たちの構成とKotlinのデータクラス。</p> </li> <li> <p><strong>パースロジックを検証する</strong>対象となる単体テストで。</p> </li> <li> <p><strong>統合の確保</strong>実際の Gradle 環境で、密閉された機能テストにより。</p> </li> </ul> </div> <div class="paragraph"> <p>この堅固な基盤により、この設定に基づく機能でプラグインを拡張する大きな自信を得られ、コードの保守性と堅牢性も確保できます。YAMLのパースは今ではプラグインの信頼性が高くテスト済みの機能となっています。<code>site-baker</code>。</p> </div> </div> </div> https://cheroliv.com/blog/2025/0090_TDD_gradle_plugin_post.html Wed, 24 Sep 2025 00:00:00 +0000 blog/2025/0090_TDD_gradle_plugin_post.html <div id="toc" class="toc"> <div id="toctitle">Table of Contents</div> <ul class="sectlevel1"> <li><a href="#_プロジェクトの初期化">プロジェクトの初期化</a></li> <li><a href="#_2_私たちの最初のtddサイクル_タスクを記録する">2. 私たちの最初のTDDサイクル : タスクを記録する</a> <ul class="sectlevel2"> <li><a href="#_2_1_まずテストする_失敗するテスト">2.1. まずテストする (失敗するテスト)</a></li> <li><a href="#_2_2_コードの次に_テストを通す">2.2. コードの次に (テストを通す)</a></li> </ul> </li> <li><a href="#_3_第2サイクル_tdd_dsl拡張を追加">3. 第2サイクル TDD : DSL拡張を追加</a> <ul class="sectlevel2"> <li><a href="#_3_1_最初のテスト">3.1. 最初のテスト</a></li> <li><a href="#_3_2_コードその後">3.2. コードその後</a></li> </ul> </li> <li><a href="#_4_機能テスト統合の検証">4. 機能テスト：統合の検証</a> <ul class="sectlevel2"> <li><a href="#_4_1_統合テスト_制御された環境を作成する">4.1. 統合テスト : 制御された環境を作成する</a></li> <li><a href="#_4_2_ロジックを最終化する">4.2. ロジックを最終化する</a></li> </ul> </li> <li><a href="#_結論">結論</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>この記事では、(TDD - テスト駆動開発) アプローチを使用して、Gradleプラグインのための堅牢な開発基盤を構築する方法について探ります。 この方法により、私たちのコードが堅牢で保守しやすく、最初から正確に要件を満たすことが保証されます。</p> </div> </div> </div> <div class="sect1"> <h2 id="_プロジェクトの初期化">プロジェクトの初期化</h2> <div class="sectionbody"> <div class="paragraph"> <p>Gradleはコマンドを使うことで新しいプラグインの作成を大いに容易にします。<code>gradle init</code>. "Gradle Plugin"をKotlinで作成することを選択すると、すぐに使えるプロジェクト構造が得られ、その中には2種類の重要なテストが含まれます：</p> </div> <div class="ulist"> <ul> <li> <p><strong>単体テスト :</strong>位置している`src/test`, これらは、私たちのプラグインの孤立したコンポーネントを検証することを可能にします。たとえば、タスクの内部ロジックや拡張機能の設定などです。これらは高速であり、Gradle の完全な実行を必要としません。</p> </li> <li> <p><strong>機能テスト :</strong>にある`src/functionalTest`, 彼らは使う`GradleRunner`一時的なテストプロジェクトで完全なGradleビルドを実行するために。これにより、制御された環境でプラグインの実際の動作を確認できます。</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_2_私たちの最初のtddサイクル_タスクを記録する">2. 私たちの最初のTDDサイクル : タスクを記録する</h2> <div class="sectionbody"> <div class="paragraph"> <p>私たちの最初の要件はシンプルです：プラグインは、名前が付けられたタスクを記録する必要があります`printSiteConfig`。</p> </div> <div class="sect2"> <h3 id="_2_1_まずテストする_失敗するテスト">2.1. まずテストする (失敗するテスト)</h3> <div class="paragraph"> <p>TDDに従い、まず、このタスクの存在を確認するテストを書きます。 では`SiteBakerPluginTest.kt`(私たちのユニットテストファイル)、追加します：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `plugin registers task`() { // Créer un projet de test en mémoire val project = ProjectBuilder.builder().build() project.plugins.apply("com.cheroliv.site-baker") // Vérifier que la tâche a bien été enregistrée assertNotNull(project.tasks.findByName("printSiteConfig")) }</code></pre> </div> </div> <div class="paragraph"> <p>このテストが失敗するのは、私たちがまだプラグインにコードを書いていないからです。</p> </div> </div> <div class="sect2"> <h3 id="_2_2_コードの次に_テストを通す">2.2. コードの次に (テストを通す)</h3> <div class="paragraph"> <p>今、私たちは必要最小限のコードを書いています`SiteBakerPlugin.kt`テストが通るように :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class SiteBakerPlugin: Plugin<Project> { override fun apply(project: Project) { // Enregistrer une tâche simple project.tasks.register("printSiteConfig") { task -> // ... la logique de la tâche viendra plus tard } } }</code></pre> </div> </div> <div class="paragraph"> <p>テストを再実行し、合格しています。最初の機能は検証されています。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_3_第2サイクル_tdd_dsl拡張を追加">3. 第2サイクル TDD : DSL拡張を追加</h2> <div class="sectionbody"> <div class="paragraph"> <p>次の要件は、ユーザーがDSLブロックを使って私たちのプラグインを設定できるようにすること`build.gradle.kts`. 私たちはブロックが欲しい`site { …​ }`設定パスを指定できる場所。</p> </div> <div class="sect2"> <h3 id="_3_1_最初のテスト">3.1. 最初のテスト</h3> <div class="paragraph"> <p>�拡張機能が正しく動作することを確認するためのテストを追加しています。`site`よく記録されており、そこに値を割り当てることができる。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `plugin registers extension`() { val project = ProjectBuilder.builder().build() project.plugins.apply("com.cheroliv.site-baker") // Récupérer l'extension et lui affecter une valeur project.extensions .findByType(SiteExtension::class.java)!! .configPath .set("config.yml") // Vérifier que la valeur a bien été prise en compte assertEquals( "config.yml", project.extensions.findByType(SiteExtension::class.java)?.configPath?.get() ) }</code></pre> </div> </div> <div class="paragraph"> <p>このテストは失敗しますなぜならクラスが`SiteExtension`拡張機能の登録も存在しない</p> </div> </div> <div class="sect2"> <h3 id="_3_2_コードその後">3.2. コードその後</h3> <div class="paragraph"> <p>私たちはクラスを作ります`SiteBakerExtension.kt`と私たちは更新します`SiteBakerPlugin.kt`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// SiteBakerExtension.kt open class SiteExtension @Inject constructor(objects: ObjectFactory) { val configPath: Property<String> = objects.property(String::class.java) } // SiteBakerPlugin.kt class SiteBakerPlugin: Plugin<Project> { override fun apply(project: Project) { // Enregistrer l'extension val extension = project.extensions.create("site", SiteExtension::class.java) project.tasks.register("printSiteConfig") { task -> task.doLast { // On utilisera l'extension plus tard } } } }</code></pre> </div> </div> <div class="paragraph"> <p>テストが再びパスしました。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_4_機能テスト統合の検証">4. 機能テスト：統合の検証</h2> <div class="sectionbody"> <div class="paragraph"> <p>ユニットのテストが終わった今、実際のビルドですべてが正しく連携することを確認する必要があります。これは機能テストの役割です。[something]における`SiteBakerPluginFunctionalTest.kt`。</p> </div> <div class="sect2"> <h3 id="_4_1_統合テスト_制御された環境を作成する">4.1. 統合テスト : 制御された環境を作成する</h3> <div class="paragraph"> <p>このテストは、私たちのプラグインを使用した実際のプロジェクトをシミュレートします。信頼性を持たせるために、これはでなければなりません。<strong>気密</strong>,つまり、システム上に存在するファイルに依存してはならない。必要となる実行条件はすべて自分自身で作らなければならない。</p> </div> <div class="paragraph"> <p>テストはしたがって：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>作る`build.gradle.kts`私たちのプラグインとそのDSLを使用するテスト。</p> </li> <li> <p><strong>設定ファイルを作成</strong>(<code>managed-jbake-context.yml</code>) プラグインが読み込むべきものです。これはテストの堅牢性にとって重要なステップです。</p> </li> <li> <p>タスクの実行`printSiteConfig`経由して`GradleRunner`.</p> </li> <li> <p>ビルドの出力が正しいことを確認する。</p> </li> </ol> </div> <div class="paragraph"> <p>この構成ファイルを実行のたびにコピーまたは作成することで、テストが<strong>再現可能</strong>外部の状態に依存せず。これによりファイルの読み込みに関連する可能性のある回帰から私たちのテストを守ります。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `can run task with DSL`() { // 1. Créer un build.gradle.kts de test buildFile.writeText(""" plugins { id("com.cheroliv.site-baker") } site { configPath = "managed-jbake-context.yml" } """.trimIndent()) // 2. Créer le fichier de configuration pour un test contrôlé val configFile = File(projectDir, "managed-jbake-context.yml") configFile.writeText("site: { title: 'Mon Site de Test' }") // Contenu YAML simple // 3. Exécuter la build val runner = GradleRunner.create() runner.withPluginClasspath() runner.withArguments("printSiteConfig") runner.withProjectDir(projectDir) // Spécifier le répertoire du projet de test val result = runner.build() // 4. Vérifier la sortie assertTrue(result.output.contains("Site config path: managed-jbake-context.yml")) }</code></pre> </div> </div> <div class="paragraph"> <p>このテストはタスクが続く間失敗します`printSiteConfig`拡張機能の値を実際には使用しません。</p> </div> </div> <div class="sect2"> <h3 id="_4_2_ロジックを最終化する">4.2. ロジックを最終化する</h3> <div class="paragraph"> <p>タスクを更新しています中で`SiteBakerPlugin.kt`設定された値を表示するために：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">project.tasks.register("printSiteConfig") { task -> task.doLast { println("Site config path: ${extension.configPath.get()}") } }</code></pre> </div> </div> <div class="paragraph"> <p>すべてのテスト（単体テストおよび機能テスト）は、今ではパスしています。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>TDDアプローチに従い、私たちはインクリメンタルかつ安全にプラグインを構築しました。各小さな機能は、すぐにテストによって検証されます。高速なユニットテストから、完全な統合を検証する機能テストまでです。</p> </div> <div class="paragraph"> <p>テストを機能的にするために注意を払って<strong>気密の</strong>— 必要な構成ファイルをプログラムで作成することで — 私たちは極めて強固な安全ネットを築きます。この厳格さは、回帰を効果的に防ぎ、その後、YAML構成ファイルのパースなど、より複雑な機能を追加する際に大きな自信を与えてくれます。</p> </div> <div class="paragraph"> <p>この堅牢なテスト基盤は、プラグインの保守および将来の進化において最も貴重な資産です。</p> </div> </div> </div> https://cheroliv.com/blog/2025/0089_creation_projet_plugin_gradle_post.html Tue, 23 Sep 2025 00:00:00 +0000 blog/2025/0089_creation_projet_plugin_gradle_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_はじめに">はじめに</a></li> <li><a href="#_ステップ_1_プロジェクト_アシスタントを起動する">ステップ 1 : プロジェクト アシスタントを起動する</a></li> <li><a href="#_ステップ_2_生成された構造を理解する">ステップ 2 : 生成された構造を理解する</a> <ul class="sectlevel2"> <li><a href="#_重要なファイルとフォルダー">重要なファイルとフォルダー</a></li> </ul> </li> </ul> </div> <div class="sect1"> <h2 id="_はじめに">はじめに</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">対象: 初心者から中級者までの Gradle 開発者</div> <p>Gradleプラグインの新しいプロジェクトを始めることは恐ろしく見えるかもしれません。幸いなことに、Gradleは強力なインタラクティブなアシスタントを提供します、そのタスクは`init`, このツールは完全で綺麗かつすぐに使えるプロジェクト構造を生成します。このガイドでは、このツールを使って健全なプラグインベースを作成する方法、構造を説明し、そして最初のビルドタスクを実行する方法を示します。</p> </div> </div> </div> <div class="sect1"> <h2 id="_ステップ_1_プロジェクト_アシスタントを起動する">ステップ 1 : プロジェクト アシスタントを起動する</h2> <div class="sectionbody"> <div class="paragraph"> <p>コマンド`gradle init`これは出発点です。これにより、プロジェクトを設定するための質問を一連行うコマンドラインアシスタントが起動されます。</p> </div> <div class="paragraph"> <p>空のフォルダーでターミナルを開き、次のコマンドを実行してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">gradle init</code></pre> </div> </div> <div class="paragraph"> <p>アシスタントが案内します。Kotlin で書かれた Gradle プラグインの選択肢は次の通りです：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>生成するプロジェクトの種類を選択:</strong>選んでください`Gradle plugin`.</p> </li> <li> <p><strong>実装言語を選択:</strong>選んでください`Kotlin`。</p> </li> <li> <p><strong>ビルドスクリプトDSLを選択:</strong>選んでください`Kotlin`.</p> </li> <li> <p><strong>プロジェクト名:</strong>プロジェクトの名前を入力してください（例：<code>site-baker</code>).</p> </li> <li> <p><strong>プラグイン ID:</strong>あなたのプラグインに一意の識別子を付けてください (例：<code>com.cheroliv.site-baker</code>).</p> </li> <li> <p><strong>プラグインクラス:</strong>実装クラスの名前を指定してください（例:`com.cheroliv.SiteBakerPlugin`).</p> </li> </ol> </div> <div class="paragraph"> <p>完了すると、Gradleは完全なファイルツリーを生成します。</p> </div> <div class="listingblock"> <div class="title">初期化プロセスの図</div> <div class="content"> <pre>@startuml start :Lancer `gradle init`; :Choisir "Gradle プラグイン"; :Choisir "コトリン" (langage); :Choisir "コトリン" (DSL); :Saisir nom, ID, et classe; :Projet généré; stop @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ステップ_2_生成された構造を理解する">ステップ 2 : 生成された構造を理解する</h2> <div class="sectionbody"> <div class="paragraph"> <p>アシスタントはマルチモジュールのプロジェクト構造を作成し、ルートプロジェクトをプラグインのソースコードから分離します。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">. ├── gradle/ │ └── wrapper/ │ ├── gradle-wrapper.jar │ └── gradle-wrapper.properties ├── gradlew ├── gradlew.bat ├── plugin/ │ ├── build.gradle.kts │ └── src/ │ ├── main/ │ │ └── kotlin/ │ │ └── com/cheroliv/SiteBakerPlugin.kt │ ├── test/ │ │ └── kotlin/ │ │ └── com/cheroliv/SiteBakerPluginTest.kt │ └── functionalTest/ │ └── kotlin/ │ └── com/cheroliv/SiteBakerPluginFunctionalTest.kt └── settings.gradle.kts</code></pre> </div> </div> <div class="sect2"> <h3 id="_重要なファイルとフォルダー">重要なファイルとフォルダー</h3> <div class="ulist"> <ul> <li> <p><code>settings.gradle.kts</code>: このルートにあるファイルは、ビルドに含まれるモジュールを定義します。ここでは、サブプロジェクトを含みます。<code>plugin</code>.</p> </li> </ul> </div> <div class="paragraph"> <p>[source,kotlin] ---- rootProject.name = "site-baker include("plugin") ----</p> </div> <div class="listingblock"> <div class="content"> <pre></pre> </div> </div> </div> </div> </div> https://cheroliv.com/blog/2025/0088_environnement_plugin_gradle_post.html Mon, 22 Sep 2025 00:00:00 +0000 blog/2025/0088_environnement_plugin_gradle_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_導入">導入</a></li> <li><a href="#_1_jdk_gradleエンジン">1. JDK: Gradleエンジン</a> <ul class="sectlevel2"> <li><a href="#_どのバージョンを選びますか">どのバージョンを選びますか？</a></li> <li><a href="#_sdkman_を介したインストール_推奨">SDKMAN! を介したインストール (推奨)</a> <ul class="sectlevel3"> <li><a href="#_sdkmanをインストール"><strong>SDKMAN!をインストール</strong></a></li> <li><a href="#_jdk_のバージョンをインストールする">JDK のバージョンをインストールする</a></li> <li><a href="#_インストールを確認">インストールを確認</a></li> </ul> </li> </ul> </li> <li><a href="#_2_ide_intellij_idea">2. IDE : IntelliJ IDEA</a></li> <li><a href="#_3_gradle_ビルドツール">3. Gradle : ビルドツール</a> <ul class="sectlevel2"> <li><a href="#_sdkmanによるインストール">SDKMAN!によるインストール</a> <ul class="sectlevel3"> <li><a href="#_gradleをインストールする">Gradleをインストールする</a></li> <li><a href="#_インストールを確認する">インストールを確認する</a></li> </ul> </li> </ul> </li> <li><a href="#_4_jbake_静的サイトジェネレーター">4. JBake : 静的サイトジェネレーター</a> <ul class="sectlevel2"> <li><a href="#_sdkman_を使ったインストール">SDKMAN! を使ったインストール</a> <ul class="sectlevel3"> <li><a href="#_jbakeをインストール">JBakeをインストール</a></li> <li><a href="#_インストールを確認_2">インストールを確認</a></li> </ul> </li> </ul> </li> <li><a href="#_5_gradleラッパー絶対的なベストプラクティス">5. Gradleラッパー：絶対的なベストプラクティス</a></li> <li><a href="#_6_docker_と_portainer_再現可能なビルド_オプション">6. Docker と Portainer : 再現可能なビルド (オプション)</a> <ul class="sectlevel2"> <li><a href="#_docker_engineのインストール">Docker Engineのインストール</a> <ul class="sectlevel3"> <li><a href="#_dockerを公式スクリプトでインストール"><strong>Dockerを公式スクリプトでインストール：</strong></a></li> <li><a href="#_dockerをsudoなしで管理する推奨"><strong>Dockerを`sudo`なしで管理する（推奨）：</strong></a></li> </ul> </li> <li><a href="#_portainer_gui_を使って_docker_を管理">Portainer (GUI) を使って Docker を管理</a> <ul class="sectlevel3"> <li><a href="#_portainerのデータ用ボリュームを作成してください">Portainerのデータ用ボリュームを作成してください：</a></li> <li><a href="#_portainer_コンテナーを起動"><strong>Portainer コンテナーを起動：</strong></a></li> </ul> </li> </ul> </li> <li><a href="#_結論">結論</a></li> </ul> </div> <div class="sect1"> <h2 id="_導入">導入</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">対象者 : Gradle プラグインの作成に取り組みたい開発者</div> <p>Gradleプラグインを効率的に開発するためには、適切に設定された開発環境が不可欠です。 良いセットアップは時間を節約し、フラストレーションを減らし、ビルドの一貫性を確保します。</p> </div> <div class="olist arabic"> <div class="title">このガイドは4つの重要な柱に焦点を当てています：</div> <ol class="arabic"> <li> <p>Le <strong>JDK</strong>(Java Development Kit)、なぜならGradleとJBakeはJVM上で実行されます。</p> </li> <li> <p>Un <strong>統合開発環境</strong>モダンな(IntelliJ IDEA)で、KotlinとGradleのサポートが良い。</p> </li> <li> <p><strong>Gradle</strong>自身で、プロジェクトを初期化するために。</p> </li> <li> <p><strong>JBake</strong>, 私たちの静的サイトのエンジン。</p> </li> </ol> </div> <div class="listingblock"> <div class="title">開発環境のコンポーネント</div> <div class="content"> <pre>@startuml !theme plain node "開発者の機械" { component "JDK (JVM)" as JDK component "IntelliJ IDEA" as IDE component "Gradle (グローバル)" as Gradle component "JBake (グローバル)" as JBake IDE --> JDK : utilise Gradle --> JDK : utilise JBake --> JDK : utilise } @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_1_jdk_gradleエンジン">1. JDK: Gradleエンジン</h2> <div class="sectionbody"> <div class="paragraph"> <p>Gradle は Java 仮想マシン (JVM) 上で実行されるアプリケーションです。 したがって、JDKのインストールは絶対に必要な前提条件です。</p> </div> <div class="sect2"> <h3 id="_どのバージョンを選びますか">どのバージョンを選びますか？</h3> <div class="paragraph"> <p>JavaのLTS(Long-Term Support)バージョンを使用することをお勧めします。 現在,<strong>JDK 17</strong> ou <strong>JDK 21</strong>非常に良い選択肢です。</p> </div> </div> <div class="sect2"> <h3 id="_sdkman_を介したインストール_推奨">SDKMAN! を介したインストール (推奨)</h3> <div class="paragraph"> <p>SDKMAN!は、JavaやGradleを含む多数のSDKのバージョンを管理するための優れたツールです。</p> </div> <div class="sect3"> <h4 id="_sdkmanをインストール"><strong>SDKMAN!をインストール</strong></h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -s "https://get.sdkman.io" | bash source "$HOME/.sdkman/bin/sdkman-init.sh"</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_jdk_のバージョンをインストールする">JDK のバージョンをインストールする</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Pour lister les versions de Java disponibles sdk list java # Pour installer Java 17 (par exemple, la distribution Temurin) sdk install java 17.0.8-tem</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_インストールを確認">インストールを確認</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">java -version</code></pre> </div> </div> <div class="paragraph"> <p>インストールしたばかりのバージョンが表示されるはずです。</p> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_2_ide_intellij_idea">2. IDE : IntelliJ IDEA</h2> <div class="sectionbody"> <div class="paragraph"> <p>Gradle プラグインの開発に Kotlin DSL を使用して<strong>IntelliJ IDEA</strong>選択のツールです。 Gradle と Kotlin との統合は比類ない。</p> </div> <div class="ulist"> <ul> <li> <p><strong>コミュニティエディション :</strong>無料で、開始するには十分すぎるほどです。</p> </li> <li> <p><strong>アルティメットエディション：</strong>有料です。ウェブ開発とデータベースのための高度な機能を提供します。</p> </li> </ul> </div> <div class="paragraph"> <p>JetBrainsのサイトからご自身に合ったバージョンをダウンロードしてください：https://www.jetbrains.com/idea/download/</p> </div> <div class="paragraph"> <p>IDEは自動的にあなたのファイルを検出します`build.gradle.kts` et <code>settings.gradle.kts</code>, 強力な自動補完、コードナビゲーション、統合されたデバッグツールを提供します。</p> </div> </div> </div> <div class="sect1"> <h2 id="_3_gradle_ビルドツール">3. Gradle : ビルドツール</h2> <div class="sectionbody"> <div class="paragraph"> <p>各プロジェクトがGradle Wrapperを通じて自身のGradleバージョンを使用する場合でも、新しいプロジェクトの初期化などのタスクのためにグローバルなGradleのインストールがあると便利です (<code>gradle init</code>).</p> </div> <div class="sect2"> <h3 id="_sdkmanによるインストール">SDKMAN!によるインストール</h3> <div class="paragraph"> <p>JDKのように、SDKMAN!はGradleのインストールを簡単にします。</p> </div> <div class="sect3"> <h4 id="_gradleをインストールする">Gradleをインストールする</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sdk install gradle</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_インストールを確認する">インストールを確認する</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">gradle -v</code></pre> </div> </div> <div class="paragraph"> <p>このコマンドは、使用されている Gradle、Kotlin、Groovy、および JDK のバージョンを表示します。</p> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_4_jbake_静的サイトジェネレーター">4. JBake : 静的サイトジェネレーター</h2> <div class="sectionbody"> <div class="paragraph"> <p>JBakeは、私たちがソースファイル（このファイルのように）を静的なウェブサイトに変換するために使用するツールです。 ローカルにインストールしておくと、変更のプレビューが便利です。</p> </div> <div class="sect2"> <h3 id="_sdkman_を使ったインストール">SDKMAN! を使ったインストール</h3> <div class="paragraph"> <p>他のツールと同様に、SDKMAN! が最もシンプルな方法です。</p> </div> <div class="sect3"> <h4 id="_jbakeをインストール">JBakeをインストール</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sdk install jbake</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_インストールを確認_2">インストールを確認</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">jbake -v</code></pre> </div> </div> <div class="paragraph"> <p>このコマンドはJBakeのバージョンと、それが使用するJava環境の情報を表示します。</p> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_5_gradleラッパー絶対的なベストプラクティス">5. Gradleラッパー：絶対的なベストプラクティス</h2> <div class="sectionbody"> <div class="paragraph"> <p>プロジェクトを作成したら（これは次の記事で説明します）、もうグローバルコマンドを使用すべきではありません`gradle`。 代わりに、あなたはそれを使います<strong>Gradleラッパー</strong>(<code>./gradlew</code>), あなたのプロジェクトに組み込まれたスクリプト。</p> </div> <div class="paragraph"> <p>なぜ？</p> </div> <div class="ulist"> <ul> <li> <p><strong>再現性：</strong>ラッパーは、プロジェクトで作業しているすべての人（CI/CDサーバーを含む）が正確に同じものを使用することを保証します。<strong>同じバージョンのGradle</strong>, これにより異なる環境によるビルドエラーが解消されます。</p> </li> <li> <p><strong>シンプルさ：</strong>プロジェクトに貢献するためにGradleを手動でインストールする必要はありません。</p> </li> </ul> </div> <div class="paragraph"> <p>リポジトリをクローンして実行するだけ`./gradlew`.</p> </div> <div class="paragraph"> <p>典型的なコマンドはこのように：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Ne pas faire : gradle build # À faire : ./gradlew build</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_6_docker_と_portainer_再現可能なビルド_オプション">6. Docker と Portainer : 再現可能なビルド (オプション)</h2> <div class="sectionbody"> <div class="paragraph"> <p>プラグインを書く上で厳密に必要というわけではないが、Docker と Portainer はモダンな DevOps ツールであり、再現可能なビルドの作成と環境の管理を大幅に容易にします。</p> </div> <div class="sect2"> <h3 id="_docker_engineのインストール">Docker Engineのインストール</h3> <div class="paragraph"> <p>Dockerを使うと、アプリケーションとその依存関係をコンテナにパッケージングできます。</p> </div> <div class="sect3"> <h4 id="_dockerを公式スクリプトでインストール"><strong>Dockerを公式スクリプトでインストール：</strong></h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_dockerをsudoなしで管理する推奨"><strong>Dockerを`sudo`なしで管理する（推奨）：</strong></h4> <div class="paragraph"> <p>あなたのユーザーをグループに追加してください`docker`。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo usod -aG docker $USER</code></pre> </div> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="Important"></i> </td> <td class="content"> </td> </tr> </table> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">docker run hello-world</code></pre> </div> </div> </div> </div> <div class="sect2"> <h3 id="_portainer_gui_を使って_docker_を管理">Portainer (GUI) を使って Docker を管理</h3> <div class="paragraph"> <p>Portainerは、Dockerコンテナを管理するための軽量なウェブインターフェース。</p> </div> <div class="sect3"> <h4 id="_portainerのデータ用ボリュームを作成してください">Portainerのデータ用ボリュームを作成してください：</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">docker volume create portainer_data</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_portainer_コンテナーを起動"><strong>Portainer コンテナーを起動：</strong></h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest</code></pre> </div> </div> <div class="paragraph"> <p>あなたは今、Portainerのインターフェースにアクセスできます`https://localhost:9443`.</p> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>あなたの環境は今準備が整いました！ JDK、最適なIDE、Gradle、JBakeを持っています。 Dockerを追加すると、コンテナ化された再現可能なビルドを作成する準備も整います。 このしっかりした基盤があれば、本質に集中できます：強力で便利なプラグインの開発に。</p> </div> <div class="paragraph"> <p>次の記事では、そのコマンドを使用します。`gradle init`私たちの最初のプラグインプロジェクトの構造を生成するために。</p> </div> </div> </div> https://cheroliv.com/blog/2025/0087_pypi_cicd_part_3_post.html Sat, 19 Jul 2025 00:00:00 +0000 blog/2025/0087_pypi_cicd_part_3_post.html <div id="toc" class="toc"> <div id="toctitle">Table of Contents</div> <ul class="sectlevel1"> <li><a href="#_poetry_との統合">Poetry との統合</a> <ul class="sectlevel2"> <li><a href="#_poetryのインストール">Poetryのインストール</a></li> <li><a href="#_プロジェクトの初期化">プロジェクトの初期化</a></li> <li><a href="#_依存関係の追加とインストール">依存関係の追加とインストール</a></li> <li><a href="#_poetryを使った公開">Poetryを使った公開</a></li> </ul> </li> <li><a href="#_dockerを使った再現可能なビルド">Dockerを使った再現可能なビルド</a> <ul class="sectlevel2"> <li><a href="#_dockerfileの例">Dockerfileの例</a></li> <li><a href="#_github_actionsへの統合">GitHub Actionsへの統合</a></li> </ul> </li> <li><a href="#_条件付き公開">条件付き公開</a></li> <li><a href="#_renovate_と_dependabot_を使った依存関係の自動化">Renovate と Dependabot を使った依存関係の自動化</a> <ul class="sectlevel2"> <li><a href="#_dependabot">Dependabot</a></li> <li><a href="#_リノベート">リノベート</a></li> </ul> </li> <li><a href="#_plantuml図">PlantUML図</a> <ul class="sectlevel2"> <li><a href="#_ユースケース_高度なcicd">ユースケース – 高度なCI/CD</a></li> <li><a href="#_シーケンス_条件付き公開">シーケンス – 条件付き公開</a></li> <li><a href="#_ステータス_cicd_パイプライン">ステータス – CI/CD パイプライン</a></li> <li><a href="#_デプロイメント_cicdアーキテクチャ">デプロイメント – CI/CDアーキテクチャ</a></li> </ul> </li> <li><a href="#_結論">結論</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>このシリーズの最初の2つの部分では、私たちは： - GitHub Actions と PyPI を使用して Python アプリケーションの機能的な CI/CD パイプラインを構築しました。 - このパイプラインをマルチバージョンテスト、Test PyPIによる段階的リリース、品質およびセキュリティツールで工業化しました。</p> </div> <div class="paragraph"> <p>この第三部では、私たちは行きます<strong>PyPI への単なる公開を超えて</strong>を構築するために、完全で堅牢かつプロフェッショナルな CI/CD チェーンを作るために : - <strong>詩</strong>モダンなパッケージングと依存関係の最適化された管理のために - <strong>ドッカー</strong>再現可能でマルチプラットフォームなビルドを作成するために。 - <strong>条件付き出版</strong>リリース候補などのシナリオを管理するために - <strong>自動化ツール</strong>(Renovate, Dependabot) パイプラインを最新の状態に保つために労力をかけずに。</p> </div> </div> </div> <div class="sect1"> <h2 id="_poetry_との統合">Poetry との統合</h2> <div class="sectionbody"> <div class="paragraph"> <p>Poetry は従来のパッケージングツール (setup.py, requirements.txt) を置き換え、依存関係とビルドの管理を一元化する中に`pyproject.toml`.</p> </div> <div class="sect2"> <h3 id="_poetryのインストール">Poetryのインストール</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-shell hljs" data-lang="shell"># Installer Poetry curl -sSL https://install.python-poetry.org | python3 - # Vérifier la version poetry --version</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_プロジェクトの初期化">プロジェクトの初期化</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-shell hljs" data-lang="shell"># Initialiser un nouveau projet avec Poetry poetry init # Suivre l'assistant pour renseigner : nom, version, description, licence, dépendances.</code></pre> </div> </div> <div class="paragraph"> <p>これはファイルを生成します`pyproject.toml`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-toml hljs" data-lang="toml">[tool.poetry] name = "playlist-downloader" version = "0.1.0" description = "CLI tool for managing YouTube playlists" authors = ["Christophe Hérolivier <cheroliv@example.com>"] [tool.poetry.dependencies] python = ">=3.8" typer = "^0.9.0" yt-dlp = "^2023.7.6" google-api-python-client = "^2.0.0" google-auth-oauthlib = "^1.0.0" [tool.poetry.group.dev.dependencies] pytest = "^7.0" mypy = "^1.0" bandit = "^1.7" safety = "^2.3" black = "^23.0" ruff = "^0.1"</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_依存関係の追加とインストール">依存関係の追加とインストール</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-shell hljs" data-lang="shell">poetry add typer yt-dlp google-api-python-client google-auth-oauthlib poetry add --group dev pytest mypy black bandit safety ruff</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_poetryを使った公開">Poetryを使った公開</h3> <div class="paragraph"> <p>Poetry はネイティブに公開を管理します :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-shell hljs" data-lang="shell"># Publication sur Test PyPI poetry publish --build --repository test-pypi # Publication sur PyPI poetry publish --build</code></pre> </div> </div> <div class="paragraph"> <p>このコマンドは自動的に存在する情報を使用する`pyproject.toml`。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_dockerを使った再現可能なビルド">Dockerを使った再現可能なビルド</h2> <div class="sectionbody"> <div class="paragraph"> <p>開発、CI/CD、本番で同じ実行を保証するために、DockerはPoetryと完全に統合されます。</p> </div> <div class="sect2"> <h3 id="_dockerfileの例">Dockerfileの例</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-dockerfile hljs" data-lang="dockerfile">FROM python:3.11-slim WORKDIR /app COPY pyproject.toml poetry.lock ./ RUN pip install poetry RUN poetry install --no-root --only main COPY . . CMD ["poetry", "run", "python", "cli.py"]</code></pre> </div> </div> <div class="paragraph"> <p>これは保証します： - 凍結されたPython環境。 経由でロックされた依存関係`poetry.lock`. - Dockerをサポートするあらゆるシステムで実行可能なイメージ。</p> </div> </div> <div class="sect2"> <h3 id="_github_actionsへの統合">GitHub Actionsへの統合</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">name: Docker Build on: push: branches: [main] jobs: build-docker: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Build Docker image run: docker build -t ghcr.io/${{ github.repository }}:latest . - name: Push Docker image run: docker push ghcr.io/${{ github.repository }}:latest</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_条件付き公開">条件付き公開</h2> <div class="sectionbody"> <div class="paragraph"> <p>プロフェッショナルなパイプラインでは、特定の場合のみ公開できる必要があります : - テストPyPI向けリリース候補。 - 安定版をPyPIに - Builds Docker トリガーのみ`main`.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">- name: Publish to Test PyPI if: contains(github.ref, '-rc') run: poetry publish --build --repository test-pypi - name: Publish to PyPI if: startsWith(github.ref, 'refs/tags/v') run: poetry publish --build</code></pre> </div> </div> <div class="paragraph"> <p>このアプローチは意図しない公開を防ぎます。</p> </div> </div> </div> <div class="sect1"> <h2 id="_renovate_と_dependabot_を使った依存関係の自動化">Renovate と Dependabot を使った依存関係の自動化</h2> <div class="sectionbody"> <div class="paragraph"> <p>依存関係が古くなるのを防ぐため、自動更新ツールを組み込んでください。</p> </div> <div class="sect2"> <h3 id="_dependabot">Dependabot</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">version: 2 updates: - package-ecosystem: "pip" directory: "/" schedule: interval: "weekly" - package-ecosystem: "github-actions" directory: "/" schedule: interval: "weekly"</code></pre> </div> </div> <div class="paragraph"> <p>Dependabotは毎週、PythonおよびGitHub Actionsの依存関係を更新するためにPRを開きます。</p> </div> </div> <div class="sect2"> <h3 id="_リノベート">リノベート</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{ "extends": ["config:base"], "packageRules": [ { "matchManagers": ["pip"], "groupName": "python-dependencies", "schedule": ["before 6am on monday"] } ] }</code></pre> </div> </div> <div class="paragraph"> <p>Renovateはより細かい制御を可能にします：依存関係のグループ化、スケジューリング、および高度なルール。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_plantuml図">PlantUML図</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_ユースケース_高度なcicd">ユースケース – 高度なCI/CD</h3> <div class="listingblock"> <div class="content"> <pre>@startuml actor Developer actor GitHub as "GitHub アクション" actor PyPI actor DockerRegistry as "Docker レジストリ" actor Automation as "リノベート/Dependabot" Developer --> (Push code) (Trigger CI) --> GitHub GitHub --> (Run Tests & Lint) GitHub --> (Build Docker Image) GitHub --> DockerRegistry GitHub --> (Publish to Test PyPI) GitHub --> (Promote to PyPI) Automation --> (Update Dependencies) @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_シーケンス_条件付き公開">シーケンス – 条件付き公開</h3> <div class="listingblock"> <div class="content"> <pre>@startuml !theme vibrant left to right direction Developer -> GitHub: Push tag v1.2.3-rc GitHub -> CI: Run tests CI -> CD: Check release type CD -> Test PyPI: Publish RC Developer -> GitHub: Push tag v1.2.3 GitHub -> CD: Publish to PyPI CD -> Docker Registry: Push Docker image @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_ステータス_cicd_パイプライン">ステータス – CI/CD パイプライン</h3> <div class="listingblock"> <div class="content"> <pre>@startuml [*] --> Idle Idle --> CI_Running : push CI_Running --> CI_Success : tests ok CI_Running --> CI_Failed : tests fail CI_Success --> CD_Running : tag detected CD_Running --> CD_Success : publish ok CD_Running --> CD_Failed : error CD_Success --> [*] @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_デプロイメント_cicdアーキテクチャ">デプロイメント – CI/CDアーキテクチャ</h3> <div class="listingblock"> <div class="content"> <pre>@startuml node "開発者用マシン" { component "Git クライアント" } node "GitHub Actions" { component "CI ワークフロー" component "CD ワークフロー" } node "パッケージリポジトリ" { artifact "テスト PyPI" artifact "PyPI" artifact "Dockerレジストリ" } "開発者用マシン" --> "GitHub Actions" "GitHub Actions" --> "テスト PyPI" "GitHub Actions" --> "PyPI" "GitHub Actions" --> "Dockerレジストリ" @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>この第三部では、次のことを見ました： - Poetryを使用してPythonパッケージングをモダン化する。 - Dockerを使用して再現可能なビルドを保証する。 - 条件付き公開を設定する。 依存関係の更新を自動化する。</p> </div> <div class="paragraph"> <p>あなたは今ではCI/CDパイプラインを持っています<strong>完全、工業化され、安全</strong>, あなたのプロジェクトとともに進化する準備ができています。</p> </div> </div> </div> https://cheroliv.com/blog/2025/0086_pypi_cicd_part_2_post.html Fri, 18 Jul 2025 00:00:00 +0000 blog/2025/0086_pypi_cicd_part_2_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_導入">導入</a></li> <li><a href="#_cicdパイプラインのアーキテクチャ">CI/CDパイプラインのアーキテクチャ</a></li> <li><a href="#_プロジェクトの構造">プロジェクトの構造</a></li> <li><a href="#_pyproject_toml_を使用したパッケージの設定">pyproject.toml を使用したパッケージの設定</a></li> <li><a href="#_cicdワークフロー_テストと品質">CI/CDワークフロー - テストと品質</a></li> <li><a href="#_リリースとデプロイのワークフロー">リリースとデプロイのワークフロー</a></li> <li><a href="#_アーキテクチャ図">アーキテクチャ図</a> <ul class="sectlevel2"> <li><a href="#_シーケンス図_リリースプロセス">シーケンス図 - リリースプロセス</a></li> <li><a href="#_状態図_パッケージのライフサイクル">状態図 - パッケージのライフサイクル</a></li> <li><a href="#_デプロイメント図_cicdインフラストラクチャ">デプロイメント図 - CI/CDインフラストラクチャ</a></li> </ul> </li> <li><a href="#_パイプラインのオブジェクトとモデル">パイプラインのオブジェクトとモデル</a> <ul class="sectlevel2"> <li><a href="#_クラス図_cicdテンプレート">クラス図 - CI/CDテンプレート</a></li> </ul> </li> <li><a href="#_シークレットの設定">シークレットの設定</a> <ul class="sectlevel2"> <li><a href="#_github_actions_のシークレット">GitHub Actions のシークレット</a></li> <li><a href="#_pypi_トークンの生成">PyPI トークンの生成</a></li> </ul> </li> <li><a href="#_ローカル開発スクリプト">ローカル開発スクリプト</a> <ul class="sectlevel2"> <li><a href="#_メイクファイル">メイクファイル</a></li> <li><a href="#_バージョン_スクリプト">バージョン スクリプト</a></li> </ul> </li> <li><a href="#_良い実践と推奨">良い実践と推奨</a> <ul class="sectlevel2"> <li><a href="#_セマンティック_バージョニング">セマンティック バージョニング</a></li> <li><a href="#_ブランチングの戦略">ブランチングの戦略</a></li> <li><a href="#_テストとカバレッジ">テストとカバレッジ</a></li> <li><a href="#_セキュリティ">セキュリティ</a></li> </ul> </li> <li><a href="#_監視と可観測性">監視と可観測性</a> <ul class="sectlevel2"> <li><a href="#_パイプラインメトリクス">パイプラインメトリクス</a></li> <li><a href="#_通知">通知</a></li> </ul> </li> <li><a href="#_結論">結論</a></li> <li><a href="#_補足リソース">補足リソース</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>目的 : シンプルなパイプラインを、モダンなパッケージングおよびソフトウェアエンジニアリングの標準に適合した頑丈な産業用パイプラインに変換する。</p> </div> </div> </div> <div class="sect1"> <h2 id="_導入">導入</h2> <div class="sectionbody"> <div class="paragraph"> <p>このシリーズの第1部では、PythonパッケージをPyPIに公開するためのテストとリリースを自動化する、シンプルかつ効果的なCI/CDパイプラインを構築しました。</p> </div> <div class="paragraph"> <p>今がこのパイプラインをプロフェッショナル化する時です。 この第二部では、以下のことを行います：</p> </div> <div class="ulist"> <ul> <li> <p>現代の標準に移行する pyproject.toml,</p> </li> <li> <p>品質およびセキュリティツールを追加する (Black, Mypy, Bandit, Safety),</p> </li> <li> <p>マルチバージョンテストを設定する、</p> </li> <li> <p>Test PyPI を使用して段階的なデプロイを統合する,</p> </li> <li> <p>バージョニングを自動化し、パイプラインの監視を改善する。</p> </li> </ul> </div> <div class="paragraph"> <p>機能的なパイプラインからプロフェッショナルなCI/CDインフラストラクチャへ移行する準備をしてください。</p> </div> <div class="paragraph"> <p>PythonアプリケーションをPyPIにデプロイするには、テスト、ビルド、パッケージの公開を自動化する堅牢なCI/CDパイプラインが必要です。 この記事では、GitHub Actions を利用した Python CLI アプリケーション向けの完全なパイプラインの構築方法について詳しく説明し、現代の Python エコシステムのベストプラクティスに従います。</p> </div> </div> </div> <div class="sect1"> <h2 id="_cicdパイプラインのアーキテクチャ">CI/CDパイプラインのアーキテクチャ</h2> <div class="sectionbody"> <div class="paragraph"> <p>私たちが構築するパイプラインは、複数のステップからなるアプローチに従います：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml !theme plain title Python用 CI/CD パイプライン (PyPI へ) skinparam backgroundColor #f8f9fa skinparam componentStyle rectangle rectangle "開発者" as dev rectangle "GitHub リポジトリ" as repo { rectangle ".github/workflows/" as workflows rectangle "tests/" as tests rectangle "setup.py / pyproject.toml" as setup rectangle "requirements.txt" as req } rectangle "ギットハブ アクションズ" as actions { rectangle "テストランナー" as test_runner rectangle "ビルド" as build rectangle "セキュリティスキャン" as security rectangle "品質チェック" as quality } rectangle "PyPI" as pypi { rectangle "テスト PyPI" as test_pypi rectangle "本番の PyPI" as prod_pypi } rectangle "ユーザー" as users dev --> repo : push/PR repo --> actions : trigger workflow actions --> test_runner : run tests actions --> security : security checks actions --> quality : code quality actions --> build : build package build --> test_pypi : deploy (pre-release) build --> prod_pypi : deploy (release) prod_pypi --> users : install package @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_プロジェクトの構造">プロジェクトの構造</h2> <div class="sectionbody"> <div class="paragraph"> <p>配布に対応したPython CLIアプリケーションは、標準化された構造に従う必要があります：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">playlist-downloader/ ├── .github/ │ └── workflows/ │ ├── ci.yml │ ├── release.yml │ └── security.yml ├── src/ │ └── playlist_downloader/ │ ├── __init__.py │ ├── cli.py │ ├── core/ │ └── adapters/ ├── tests/ │ ├── unit/ │ ├── integration/ │ └── conftest.py ├── docs/ ├── pyproject.toml ├── requirements.txt ├── requirements-dev.txt ├── MANIFEST.in ├── README.md ├── LICENSE └── CHANGELOG.md</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_pyproject_toml_を使用したパッケージの設定">pyproject.toml を使用したパッケージの設定</h2> <div class="sectionbody"> <div class="paragraph"> <p>ファイル`pyproject.toml`は Python パッケージを設定するための現代の標準です :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-toml hljs" data-lang="toml">[build-system] requires = ["setuptools>=45", "wheel", "setuptools_scm>=6.2"] build-backend = "setuptools.build_meta" [project] name = "playlist-downloader" authors = [ {name = "Christophe Hérolivier", email = "cheroliv@example.com"}, ] description = "CLI tool for YouTube playlist management" readme = "README.md" requires-python = ">=3.8" keywords = ["youtube", "playlist", "cli", "downloader"] license = {text = "MIT"} classifiers = [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: End Users/Desktop", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: 3.9", "Programming Language :: Python :: 3.10", "Programming Language :: Python :: 3.11", "Topic :: Multimedia :: Sound/Audio", "Topic :: Utilities", ] dependencies = [ "typer>=0.9.0", "yt-dlp>=2023.7.6", "google-api-python-client>=2.0.0", "google-auth-oauthlib>=1.0.0", "pyyaml>=6.0", "rich>=13.0.0", ] dynamic = ["version"] [project.optional-dependencies] dev = [ "pytest>=7.0.0", "pytest-cov>=4.0.0", "pytest-mock>=3.10.0", "black>=23.0.0", "flake8>=6.0.0", "mypy>=1.0.0", "pre-commit>=3.0.0", "tox>=4.0.0", ] test = [ "pytest>=7.0.0", "pytest-cov>=4.0.0", "pytest-mock>=3.10.0", ] [project.urls] Homepage = "https://github.com/cheroliv/playlist-downloader" Documentation = "https://github.com/cheroliv/playlist-downloader#readme" Repository = "https://github.com/cheroliv/playlist-downloader.git" "Bug Tracker" = "https://github.com/cheroliv/playlist-downloader/issues" [project.scripts] playlist-downloader = "playlist_downloader.cli:main" [tool.setuptools_scm] write_to = "src/playlist_downloader/_version.py" [tool.setuptools.packages.find] where = ["src"] [tool.pytest.ini_options] testpaths = ["tests"] python_files = ["test_*.py"] python_classes = ["Test*"] python_functions = ["test_*"] addopts = [ "--cov=src/playlist_downloader", "--cov-report=html", "--cov-report=term-missing", "--cov-fail-under=85", ] [tool.black] line-length = 88 target-version = ['py38'] include = '\.pyi?$' extend-exclude = ''' /( \.eggs | \.git | \.hg | \.mypy_cache | \.tox | \.venv | _build | buck-out | build | dist )/ ''' [tool.mypy] python_version = "3.8" warn_return_any = true warn_unused_configs = true disallow_untyped_defs = true disallow_incomplete_defs = true check_untyped_defs = true disallow_untyped_decorators = true no_implicit_optional = true warn_redundant_casts = true warn_unused_ignores = true warn_no_return = true warn_unreachable = true strict_equality = true [[tool.mypy.overrides]] module = [ "yt_dlp.*", "googleapiclient.*", "google_auth_oauthlib.*", ] ignore_missing_imports = true</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_cicdワークフロー_テストと品質">CI/CDワークフロー - テストと品質</h2> <div class="sectionbody"> <div class="paragraph"> <p>メインワークフロー (<code>ci.yml</code>) Python の複数のバージョンでテストを実行します :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">name: CI on: push: branches: [ main, develop ] pull_request: branches: [ main ] jobs: test: runs-on: ubuntu-latest strategy: matrix: python-version: ["3.8", "3.9", "3.10", "3.11"] steps: - uses: actions/checkout@v4 with: fetch-depth: 0 - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@v4 with: python-version: ${{ matrix.python-version }} - name: Cache dependencies uses: actions/cache@v3 with: path: | ~/.cache/pip ~/.cache/pre-commit key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements*.txt') }} restore-keys: | ${{ runner.os }}-pip- - name: Install dependencies run: | python -m pip install --upgrade pip pip install -e ".[dev]" - name: Lint with flake8 run: | flake8 src tests --count --select=E9,F63,F7,F82 --show-source --statistics flake8 src tests --count --exit-zero --max-complexity=10 --max-line-length=88 --statistics - name: Check code formatting with Black run: black --check src tests - name: Type checking with mypy run: mypy src - name: Run tests with pytest run: | pytest tests/ -v --cov=src/playlist_downloader \ --cov-report=xml --cov-report=term-missing - name: Upload coverage to Codecov uses: codecov/codecov-action@v3 if: matrix.python-version == '3.11' with: file: ./coverage.xml flags: unittests name: codecov-umbrella security: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Set up Python uses: actions/setup-python@v4 with: python-version: "3.11" - name: Install dependencies run: | python -m pip install --upgrade pip pip install bandit[toml] safety - name: Run security checks with bandit run: bandit -r src/ -f json -o bandit-report.json - name: Check dependencies with safety run: safety check --json --output safety-report.json - name: Upload security reports uses: actions/upload-artifact@v3 if: always() with: name: security-reports path: | bandit-report.json safety-report.json build: needs: [test, security] runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 with: fetch-depth: 0 - name: Set up Python uses: actions/setup-python@v4 with: python-version: "3.11" - name: Install build dependencies run: | python -m pip install --upgrade pip pip install build twine - name: Build package run: python -m build - name: Check package with twine run: twine check dist/* - name: Upload build artifacts uses: actions/upload-artifact@v3 with: name: dist path: dist/</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_リリースとデプロイのワークフロー">リリースとデプロイのワークフロー</h2> <div class="sectionbody"> <div class="paragraph"> <p>リリースワークフロー (<code>release.yml</code>) PyPIへの自動公開を管理します :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">name: Release on: push: tags: - 'v*.*.*' workflow_dispatch: inputs: environment: description: 'Deployment environment' required: true default: 'test' type: choice options: - test - production env: PYTHON_VERSION: "3.11" jobs: release: runs-on: ubuntu-latest environment: name: ${{ github.event.inputs.environment || (startsWith(github.ref, 'refs/tags/') && 'production' || 'test') }} steps: - uses: actions/checkout@v4 with: fetch-depth: 0 - name: Set up Python uses: actions/setup-python@v4 with: python-version: ${{ env.PYTHON_VERSION }} - name: Install dependencies run: | python -m pip install --upgrade pip pip install build twine - name: Build package run: python -m build - name: Check package run: twine check dist/* - name: Publish to Test PyPI if: github.event.inputs.environment == 'test' || (startsWith(github.ref, 'refs/tags/') && contains(github.ref, 'rc')) env: TWINE_USERNAME: __token__ TWINE_PASSWORD: ${{ secrets.TEST_PYPI_API_TOKEN }} run: | twine upload --repository testpypi dist/* - name: Publish to PyPI if: github.event.inputs.environment == 'production' || (startsWith(github.ref, 'refs/tags/') && !contains(github.ref, 'rc')) env: TWINE_USERNAME: __token__ TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }} run: | twine upload dist/* - name: Create GitHub Release if: startsWith(github.ref, 'refs/tags/') uses: actions/create-release@v1 env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} with: tag_name: ${{ github.ref }} release_name: Release ${{ github.ref }} draft: false prerelease: ${{ contains(github.ref, 'rc') }} post-release: needs: release runs-on: ubuntu-latest if: startsWith(github.ref, 'refs/tags/') steps: - uses: actions/checkout@v4 - name: Set up Python uses: actions/setup-python@v4 with: python-version: ${{ env.PYTHON_VERSION }} - name: Test installation from PyPI run: | sleep 60 # Attendre la propagation sur PyPI pip install playlist-downloader playlist-downloader --version - name: Update documentation run: | # Script pour mettre à jour la documentation echo "Documentation updated for version ${GITHUB_REF#refs/tags/}"</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_アーキテクチャ図">アーキテクチャ図</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_シーケンス図_リリースプロセス">シーケンス図 - リリースプロセス</h3> <div class="listingblock"> <div class="content"> <pre>@startuml !theme plain title PyPIへのリリースシーケンス actor Developer as dev participant "GitHub" as gh participant "GitHub Actions" as ga participant "テスト PyPI" as tpypi participant "PyPI" as pypi participant "ユーザー" as users dev -> gh : git push --tags v1.2.3 gh -> ga : trigger release workflow ga -> ga : checkout code ga -> ga : setup Python environment ga -> ga : install dependencies ga -> ga : run tests ga -> ga : build package (wheel + sdist) ga -> ga : check package with twine alt Pre-release (rc tag) ga -> tpypi : upload to Test PyPI tpypi -> ga : confirm upload else Stable release ga -> pypi : upload to PyPI pypi -> ga : confirm upload end ga -> gh : create GitHub release ga -> ga : test installation from PyPI users -> pypi : pip install playlist-downloader pypi -> users : download package @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_状態図_パッケージのライフサイクル">状態図 - パッケージのライフサイクル</h3> <div class="listingblock"> <div class="content"> <pre>@startuml !theme plain title Pythonパッケージの状態 [*] --> Development Development --> Testing : commit/PR Testing --> Development : tests fail Testing --> Built : tests pass Built --> TestPyPI : pre-release tag Built --> PyPI : stable tag TestPyPI --> PyPI : validation OK PyPI --> Published Published --> [*] state Development { [*] --> Coding Coding --> LocalTesting LocalTesting --> Coding : fix issues LocalTesting --> ReadyForCI : all tests pass } state Testing { [*] --> CITests CITests --> SecurityScan SecurityScan --> QualityCheck QualityCheck --> BuildValidation } @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_デプロイメント図_cicdインフラストラクチャ">デプロイメント図 - CI/CDインフラストラクチャ</h3> <div class="listingblock"> <div class="content"> <pre>@startuml !theme plain title 導入インフラストラクチャ node "ギットハブ" { component "リポジトリ" as repo component "アクション ランナー" as runner component "シークレットストア" as secrets } node "PyPI インフラストラクチャ" { component "PyPI" as pypi component "テスト PyPI" as testpypi database "パッケージインデックス" as index } node "開発者マシン" { component "Git クライアント" as git component "Python環境" as python component "統合開発環境" as ide } node "ユーザー環境" { component "ピップ" as pip_client component "Python ランタイム" as py_runtime } git --> repo : push code/tags repo --> runner : trigger workflows runner --> secrets : read API tokens runner --> testpypi : upload pre-release runner --> pypi : upload release pypi --> index : store package pip_client --> pypi : download package py_runtime <-- pip_client : install package @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_パイプラインのオブジェクトとモデル">パイプラインのオブジェクトとモデル</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_クラス図_cicdテンプレート">クラス図 - CI/CDテンプレート</h3> <div class="listingblock"> <div class="content"> <pre>@startuml !theme plain title CI/CDパイプラインのモデル class PipelineConfig { +python_versions: List[str] +test_environments: List[str] +security_checks: bool +coverage_threshold: float +validate() } class BuildArtifact { +name: str +version: str +wheel_path: str +sdist_path: str +checksums: Dict[str, str] +validate_integrity() } class TestResult { +test_suite: str +python_version: str +passed: int +failed: int +coverage: float +duration: float +is_success(): bool } class SecurityReport { +bandit_issues: List[Issue] +safety_vulnerabilities: List[Vulnerability] +severity_level: str +is_secure(): bool } class DeploymentTarget { +name: str +url: str +api_token: str +environment: str +deploy(artifact: BuildArtifact) } class ReleaseManager { +version: str +changelog: str +artifacts: List[BuildArtifact] +test_results: List[TestResult] +security_report: SecurityReport +deploy_to_test() +deploy_to_production() +create_github_release() } PipelineConfig ||--o{ TestResult ReleaseManager *-- BuildArtifact ReleaseManager *-- SecurityReport ReleaseManager o-- DeploymentTarget DeploymentTarget ..> BuildArtifact : uses @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_シークレットの設定">シークレットの設定</h2> <div class="sectionbody"> <div class="paragraph"> <p>パイプラインが機能するように、次のシークレットをGitHubで設定する必要があります：</p> </div> <div class="sect2"> <h3 id="_github_actions_のシークレット">GitHub Actions のシークレット</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Dans Settings > Secrets and variables > Actions # Token PyPI pour la production PYPI_API_TOKEN=pypi-... # Token Test PyPI pour les pré-releases TEST_PYPI_API_TOKEN=pypi-... # Token GitHub pour créer les releases GITHUB_TOKEN=(automatiquement fourni) # Token Codecov (optionnel) CODECOV_TOKEN=...</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_pypi_トークンの生成">PyPI トークンの生成</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># 1. Créer un compte sur PyPI et Test PyPI # 2. Aller dans Account Settings > API tokens # 3. Créer un token avec scope "Entire account" ou spécifique au projet # 4. Format du token : pypi-AgEIcHlwaS5vcmc...</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ローカル開発スクリプト">ローカル開発スクリプト</h2> <div class="sectionbody"> <div class="paragraph"> <p>開発を容易にするために、ユーティリティスクリプトを作成してください：</p> </div> <div class="sect2"> <h3 id="_メイクファイル">メイクファイル</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-makefile hljs" data-lang="makefile">.PHONY: install test lint format security build clean release-test release-prod install: pip install -e ".[dev]" test: pytest tests/ -v --cov=src/playlist_downloader lint: flake8 src tests mypy src format: black src tests security: bandit -r src/ safety check build: python -m build twine check dist/* clean: rm -rf build/ dist/ *.egg-info/ find . -type d -name __pycache__ -delete find . -name "*.pyc" -delete release-test: clean build twine upload --repository testpypi dist/* release-prod: clean build twine upload dist/* pre-commit: format lint test security @echo "✅ Prêt pour commit"</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_バージョン_スクリプト">バージョン スクリプト</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-python hljs" data-lang="python">#!/usr/bin/env python3 """Script pour gérer les versions du projet.""" import sys import subprocess from pathlib import Path def get_current_version(): """Récupère la version actuelle depuis git.""" try: result = subprocess.run( ["git", "describe", "--tags", "--abbrev=0"], capture_output=True, text=True, check=True ) return result.stdout.strip() except subprocess.CalledProcessError: return "0.0.0" def create_version_tag(version, message=None): """Crée un tag de version.""" if not version.startswith('v'): version = f'v{version}' tag_message = message or f"Release {version}" subprocess.run(["git", "tag", "-a", version, "-m", tag_message], check=True) print(f"✅ Tag {version} créé") # Push le tag subprocess.run(["git", "push", "origin", version], check=True) print(f"✅ Tag {version} poussé vers origin") if __name__ == "__main__": if len(sys.argv) < 2: current = get_current_version() print(f"Version actuelle: {current}") print("Usage: python version.py <new_version> [message]") sys.exit(1) new_version = sys.argv[1] message = sys.argv[2] if len(sys.argv) > 2 else None create_version_tag(new_version, message)</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_良い実践と推奨">良い実践と推奨</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_セマンティック_バージョニング">セマンティック バージョニング</h3> <div class="paragraph"> <p>セマンティック バージョニング (SemVer) を使用してください :</p> </div> <div class="ulist"> <ul> <li> <p><code>MAJOR.MINOR.PATCH</code> (ex: 1.2.3)</p> </li> <li> <p><code>MAJOR</code>: 互換性のない変更</p> </li> <li> <p><code>MINOR</code>: 互換性のある新機能</p> </li> <li> <p><code>PATCH</code>: 互換性のあるバグ修正</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_ブランチングの戦略">ブランチングの戦略</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">main ──●──●──●──●──●────●── (releases stables) / / / develop ──●──●──●──●──●──●──●──●── (développement) / / / feature/xxx ●──●──●──●──●──/ (fonctionnalités)</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_テストとカバレッジ">テストとカバレッジ</h3> <div class="ulist"> <ul> <li> <p>最小コードカバレッジ:85%</p> </li> <li> <p>ビジネスロジックの単体テスト</p> </li> <li> <p>アダプターの統合テスト</p> </li> <li> <p>CLI用のエンドツーエンドテスト</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_セキュリティ">セキュリティ</h3> <div class="ulist"> <ul> <li> <p>自動依存関係スキャン(Safety)</p> </li> <li> <p>コードの静的解析 (Bandit)</p> </li> <li> <p>コードに決して秘密を入れない</p> </li> <li> <p>特定のPyPIトークンの使用</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_監視と可観測性">監視と可観測性</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_パイプラインメトリクス">パイプラインメトリクス</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml"># .github/workflows/metrics.yml name: Pipeline Metrics on: workflow_run: workflows: ["CI", "Release"] types: [completed] jobs: metrics: runs-on: ubuntu-latest steps: - name: Collect metrics run: | echo "Pipeline: ${{ github.event.workflow_run.name }}" echo "Status: ${{ github.event.workflow_run.conclusion }}" echo "Duration: ${{ github.event.workflow_run.updated_at - github.event.workflow_run.created_at }}" # Envoyer vers système de monitoring</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_通知">通知</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml"># Ajout dans les workflows pour notifications - name: Notify on failure if: failure() uses: 8398a7/action-slack@v3 with: status: failure text: "❌ Pipeline failed for ${{ github.repository }}" env: SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK }}</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>このPython用の完全なCI/CDパイプラインは、以下を提供します：</p> </div> <div class="ulist"> <ul> <li> <p><strong>完全自動化</strong>コードの検証から出版まで</p> </li> <li> <p><strong>セキュリティ</strong>: 自動スキャンおよび安全なシークレット管理</p> </li> <li> <p><strong>品質</strong>: マルチバージョンテスト、リンティング、コードカバレッジ</p> </li> <li> <p><strong>信頼性</strong>: Test PyPI を介した段階的なデプロイ</p> </li> <li> <p><strong>トレーサビリティ</strong>: アーティファクト、レポート、および GitHub リリース</p> </li> </ul> </div> <div class="paragraph"> <p>これらのベストプラクティスを採用することで、Python CLI アプリケーションに対して堅牢でプロフェッショナルなデリバリープロセスが保証され、長期的にプロジェクトのメンテナンスと進化が容易になります。</p> </div> </div> </div> <div class="sect1"> <h2 id="_補足リソース">補足リソース</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="https://packaging.python.org/">Python パッケージング ユーザーガイド</a></p> </li> <li> <p><a href="https://docs.github.com/en/actions">GitHub Actionsドキュメント</a></p> </li> <li> <p><a href="https://pypi.org/help/">PyPIヘルプドキュメント</a></p> </li> <li> <p><a href="https://semver.org/">セマンティックバージョニング仕様</a></p> </li> <li> <p><a href="https://keepachangelog.com/">変更ログを保持</a></p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2025/0085_pypi_cicd_part_1_post.html Thu, 17 Jul 2025 00:00:00 +0000 blog/2025/0085_pypi_cicd_part_1_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_イントロダクション">イントロダクション</a></li> <li><a href="#_パイプラインのアーキテクチャ">パイプラインのアーキテクチャ</a></li> <li><a href="#_継続的インテグレーション_ci_パイプラインの設定">�継続的インテグレーション (CI) パイプラインの設定</a> <ul class="sectlevel2"> <li><a href="#_ciワークフローの構造">CIワークフローの構造</a></li> <li><a href="#_ciステップの分析">CIステップの分析</a> <ul class="sectlevel3"> <li><a href="#_トリガー_on">トリガー (<code>on</code>)</a></li> </ul> </li> </ul> </li> </ul> </div> <div class="sect1"> <h2 id="_イントロダクション">イントロダクション</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">目的： 読者が最小限かつ機能的な CI/CD パイプラインを構築できるように導き、Python アプリケーションに対して PyPI への自動デプロイを実現する。</div> <p>開発プロセスの自動化は、現代のプロジェクトにおいて必須となった。よく設計されたCI/CDパイプラインは、開発サイクルの早い段階で回帰を検出するだけでなく、デプロイメントプロセスを完全に自動化することも可能にする。</p> </div> <div class="paragraph"> <p>この記事では、GitHub Actionsを使ってPythonアプリケーション用の完全なパイプラインをCI（継続的インテグレーション）からCD（継続的デプロイメント）まで設定する方法を探ります。</p> </div> </div> </div> <div class="sect1"> <h2 id="_パイプラインのアーキテクチャ">パイプラインのアーキテクチャ</h2> <div class="sectionbody"> <div class="paragraph"> <p>私たちのパイプラインは2つの異なるワークフローで構成されています：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>CIパイプライン</strong>: 各プッシュおよびプルリクエストごとに実行されます</p> </li> <li> <p><strong>継続的デリバリーパイプライン</strong>: GitHubのリリース時にのみトリガーされます</p> </li> </ol> </div> <div class="listingblock"> <div class="content"> <pre>@startuml !theme plain package "GitHub リポジトリ" { [Source Code] as source [GitHub Actions] as actions } package "CI パイプライン" { [Checkout] as checkout_ci [Setup Python] as python_ci [Install Dependencies] as deps_ci [Linting (Ruff)] as lint [Unit Tests] as tests } package "CD パイプライン" { [Checkout] as checkout_cd [Setup Python] as python_cd [Build Package] as build [Publish to PyPI] as pypi } source --> actions : Push/PR actions --> checkout_ci checkout_ci --> python_ci python_ci --> deps_ci deps_ci --> lint lint --> tests source --> actions : Release actions --> checkout_cd : On Release checkout_cd --> python_cd python_cd --> build build --> pypi @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_継続的インテグレーション_ci_パイプラインの設定">�継続的インテグレーション (CI) パイプラインの設定</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_ciワークフローの構造">CIワークフローの構造</h3> <div class="paragraph"> <p>CI ワークフローは、コードへの各貢献を検証するように設計されています。以下はその完全な設定です：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">name: CI/CD Pipeline on: push: branches: - main pull_request: branches: - main jobs: build: runs-on: ubuntu-latest steps: - name: Checkout code uses: actions/checkout@v4 - name: Set up Python uses: actions/setup-python@v5 with: python-version: '3.x' - name: Install dependencies run: | python -m pip install --upgrade pip pip install -r requirements.txt pip install ruff pytest pytest-mock - name: Run Linting (Ruff) run: ruff check . - name: Run Tests (Pytest) run: pytest</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ciステップの分析">CIステップの分析</h3> <div class="sect3"> <h4 id="_トリガー_on">トリガー (<code>on</code>)</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">---- ---- on: push: branches: - main pull_request: branches: - main ---- パイプラインは次の条件でトリガーされます : - 各プッシュをブランチに`main` - 各 pull request へ`main` このアプローチは、メインコードが安定したまま保たれ、すべての貢献が統合前に検証されることを保証します。 ==== 2. 実行環境 ---- runs-on: ubuntu-latest Ubuntu Latestは、性能、コスト、互換性の良いバランスを提供し、ほとんどのPythonプロジェクトに適しています。 ==== 3. コードのチェックアウト ```yaml ---- ---- - name: Checkout code uses: actions/checkout@v4 ---- 行動`checkout@v4`リポジトリのソースコードを取得します。バージョン v4 は、パフォーマンスとセキュリティの改善をもたらします。 ==== 4. Python の設定 ---- - name: Set up Python uses: actions/setup-python@v5 with: python-version: '3.x' の使用`'3.x'`これにより、Python 3 の最新安定バージョンを自動的に使用できるようになり、メンテナンスが簡素化されます。 ==== 5. 依存関係のインストール ```yaml ---- ---- - name: Install dependencies run: | python -m pip install --upgrade pip pip install -r requirements.txt pip install ruff pytest pytest-mock ---- このステップ： - pipを最新バージョンに更新 - プロジェクトの依存関係をインストール - 開発ツール（リンティングとテスト）を追加 ==== 6. Ruffによるリンティング ---- - name: Run Linting (Ruff) run: ruff check . **ラフ**は非常に高速なRust製のPython linterです。Flake8、Black、isortなど複数のツールの機能を1つの高性能なツールに統合しています。 ==== 7. テストの実行 ```yaml ---- ---- - name: Run Tests (Pytest) run: pytest ---- Pytest はテストスイート全体を実行し、変更が回帰を引き起こさないことを保証します。 == デプロイメントパイプライン (CD) の設定 === CD ワークフローの構造 CD ワークフローは GitHub のリリース時にのみトリガーされ、PyPI への公開を自動化します : [source,yaml] ---- name: Publish to PyPI on: release: types: - published jobs: deploy: runs-on: ubuntu-latest steps: - name: Checkout code uses: actions/checkout@v4 - name: Set up Python uses: actions/setup-python@v5 with: python-version: '3.x' - name: Install dependencies run: | python -m pip install --upgrade pip pip install setuptools wheel twine - name: Build and publish env: TWINE_USERNAME: __token__ TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }} run: | python setup.py sdist bdist_wheel twine upload dist/* ---- === CDステップの分析 ==== リリース トリガー ---- on: release: types: - published CDパイプラインはGitHubのリリースが公開されたときのみトリガーされます。このアプローチにより、デプロイメントの正確な制御が確保されます。 ==== 2. ビルドツールのインストール ```yaml ---- ---- pip install setuptools wheel twine ---- - **セットアップツール**: Python パッケージング ツール - **ホイール**: モダンなPythonディストリビューションフォーマット - **ひも**: セキュアなPyPIアップロードツール ==== 3. 認証設定 ---- env: TWINE_USERNAME: __token__ TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }} 認証は、GitHubシークレットとして保存されたPyPI APIトークンを使用し、従来の認証情報よりも安全です。 ==== 4. ビルドと公開 ```yaml ---- ---- run: | python setup.py sdist bdist_wheel twine upload dist/* ---- - `sdist`ソースディストリビューションを作成 - `bdist_wheel`: ホイールを作成 (バイナリディストリビューション) - `twine upload`: PyPIにディストリビューションを公開 == Pythonパッケージの設定 === setup.pyの構造 パイプラインが機能するために、プロジェクトにはファイルを含めなければなりません`setup.py`: [source,python] ---- from setuptools import setup, find_packages with open("README.adoc", "r", encoding="utf-8") as fh: long_description = fh.read() setup( name="playlist-downloader", version="1.0.0", author="Votre Nom", author_email="votre.email@example.com", description="CLI tool for managing YouTube playlists", long_description=long_description, long_description_content_type="text/plain", url="https://github.com/cheroliv/playlist-downloader", packages=find_packages(), classifiers=[ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: 3.9", "Programming Language :: Python :: 3.10", "Programming Language :: Python :: 3.11", ], python_requires=">=3.8", install_requires=[ "typer>=0.9.0", "yt-dlp>=2023.1.6", "google-api-python-client>=2.70.0", "google-auth-oauthlib>=0.7.1", "pymonad>=2.4.0", "pyyaml>=6.0", ], entry_points={ "console_scripts": [ "playlist-downloader=cli:app", ], }, ) ---- === セットアップ.pyの重要なポイント 1. **メタデータ**: 名前, バージョン, 作者, 説明 2. **依存関係**必要なパッケージのリスト 3. **エントリーポイント**公開されたCLIコマンド 4. **分類器**PyPIのメタデータ == GitHub Secretsを使用したセキュリティ === PyPIトークンの設定 1. **PyPIでAPIトークンを作成する**: - PyPIにログインしてください - Account Settings > API tokensに移動してください - 適切な権限で新しいトークンを作成してください 1. **GitHubにシークレットを追加**: - リポジトリの設定 > シークレットと変数 > アクション - 新しいシークレットを作成`PYPI_API_TOKEN` - PyPIのトークンを貼り付けて [plantuml, secrets-flow, svg] ---- @startuml !theme plain actor Developer as dev participant "GitHubリポジトリ" as repo participant "GitHub アクション" as actions participant PyPI dev -> repo : Configure PYPI_API_TOKEN secret repo -> actions : Trigger CD pipeline on release actions -> actions : Access secret securely actions -> PyPI : Authenticate with token PyPI -> PyPI : Validate and publish package note over actions, PyPI Token never exposed in logs Automatic rotation possible end note @enduml ---- == 完全なデプロイメントワークフロー === 展開シーケンス [plantuml, deployment-sequence, svg] ---- @startuml !theme plain actor Developer as dev participant "ローカルGit" as git participant "GitHub" as github participant "GitHub Actions" as actions participant PyPI participant "エンドユーザー" as users dev -> git : git tag v1.0.0 dev -> git : git push origin v1.0.0 git -> github : Push tag dev -> github : Create release from tag github -> actions : Trigger CD pipeline actions -> actions : Checkout code actions -> actions : Setup Python environment actions -> actions : Install build tools actions -> actions : Build distributions (sdist + wheel) actions -> PyPI : Upload to PyPI with token PyPI -> PyPI : Validate and publish users -> PyPI : pip install playlist-downloader note over dev, github Release creation can be automated or done manually through GitHub UI end note @enduml ---- === パイプラインの状態 [plantuml, pipeline-states, svg] ---- @startuml !theme plain [*] --> Idle Idle --> CI_Running : Push/PR created CI_Running --> CI_Success : All checks pass CI_Running --> CI_Failed : Linting/Tests fail CI_Success --> Idle : Merge completed CI_Failed --> Idle : Fix and retry Idle --> CD_Running : Release published CD_Running --> CD_Success : Package published CD_Running --> CD_Failed : Build/Upload error CD_Success --> Idle : Package available on PyPI CD_Failed --> Idle : Fix and retry release note on link #red : Blocks merge note on link #green : Allows deployment @enduml ---- == ベストプラクティスと最適化 === バージョン管理 セマンティックなGitタグを使用してください： ---- git tag -a v1.2.3 -m "Release version 1.2.3" git push origin v1.2.3 === 2. マトリックステスト 複数のPythonバージョンでテストするには： ```yaml ---- ---- strategy: matrix: python-version: [3.8, 3.9, "3.10", "3.11"] ---- === 3. 依存関係のキャッシュ キャッシュでビルドを高速化： ---- - name: Cache pip dependencies uses: actions/cache@v3 with: path: ~/.cache/pip key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }} === 4. デプロイメント環境 GitHub環境を使用して、制御されたデプロイを行ってください : ```yaml ---- ---- jobs: deploy: environment: production runs-on: ubuntu-latest ---- == 使用例とアーキテクチャ === ユースケース図 [plantuml, use-cases, svg] ---- @startuml !theme plain left to right direction actor "開発者" as dev actor "GitHub Actions" as ga actor "エンドユーザー" as user package "CI/CDシステム" { usecase "リンティングを実行" as lint usecase "テストを実行" as test usecase "パッケージのビルド" as build usecase "PyPIに公開する" as publish usecase "リリースを作成" as release } dev --> lint : Pushes code dev --> test : Pushes code dev --> release : Creates release ga --> build : On release trigger ga --> publish : After successful build user --> publish : Downloads package lint .> test : triggers test .> build : on success build .> publish : on success @enduml ---- === デプロイメントのアーキテクチャ [plantuml, deployment-architecture, svg] ---- @startuml !theme plain cloud "GitHub" { [Source Repository] [GitHub Actions] [Secrets Store] } cloud "パイピーアイ" { [Package Registry] [Distribution Files] } node "CI/CD パイプライン" { [Linting] [Testing] [Building] [Publishing] } [Source Repository] --> [GitHub Actions] : Triggers [GitHub Actions] --> [Linting] [Linting] --> [Testing] [Testing] --> [Building] [Building] --> [Publishing] [Publishing] --> [Package Registry] : Uploads [Secrets Store] --> [Publishing] : Provides token note as N1 Secure token-based authentication end note [Secrets Store] .. N1 @enduml ---- == 監視とデバッグ === ログとモニタリング GitHub Actionsは各ステップの詳細なログを提供します。デバッグするには： 1. **ログを確認してください**各ステップの 2. **デバッグを有効に**に`ACTIONS_STEP_DEBUG` 3. **アーティファクトを使ってください**ビルドファイルを保存するために ---- - name: Upload build artifacts uses: actions/upload-artifact@v3 if: failure() with: name: build-logs path: build/ === 通知 Slack or email notifications. We could also do: "Slackまたはメールの通知を追加してください:" (colon). Provide only that. </think> Slackまたはメールの通知を追加してください: ```yaml ---- ---- - name: Notify on failure if: failure() uses: 8398a7/action-slack@v3 with: status: ${{ job.status }} webhook_url: ${{ secrets.SLACK_WEBHOOK }} ---- == 結論 GitHub Actions を使って堅牢な CI/CD パイプラインを構築すると、開発体験が劇的に変わります。linting、テスト、デプロイを自動化することで、あなたは： - **エラーを減らしてください**本番中 - **サイクルを加速して**開発の - **信頼を向上させてください**あなたのリリースの中で - **協力を促進してください**チームで このパイプラインは、lint ツール、テスト フレームワーク、またはデプロイ先を調整することで、さまざまな種類の Python プロジェクトに適合させることができます。 これらのワークフローの設定における初期投資は、時間の節約とデプロイメント時の手動エラーの削減によってすぐに元が取れます。 == 補足リソース - https://docs.github.com/en/actions[ギットハブ アクションズ ドキュメント] - https://packaging.python.org/[Pythonパッケージングガイド] - https://docs.pytest.org/[Pytestドキュメント] - https://docs.astral.sh/ruff/[Ruff ドキュメンテーション] - https://twine.readthedocs.io/[トワイン ドキュメンテーション] �✅ パイプライン機能が達成されました！ これで、GitHub Actions から直接 PyPI に Python パッケージを公開し、テストを自動化できるシンプルな CI/CD パイプラインができました。 しかし、このパイプラインは意図的に最小限に抑えられています。まだ、プロフェッショナルな文脈で不可欠な一部の側面をカバーしていません。 Pythonのマルチバージョンテスト, 自動セキュリティ分析, Test PyPIを介した段階的な導入, パイプラインの監視とメトリクス, バージョニングの自動化および現代のベストプラクティスの統合（pyproject.toml）。 次のセクションでは、レベルを上げます。基本的なパイプラインを本格的な産業レベルのデプロイメントチェーン、つまり堅牢で安全なものに変換する方法を学びます。これは本番環境のPythonプロジェクトに対応できる状態になります。 ----</code></pre> </div> </div> </div> </div> </div> </div> https://cheroliv.com/blog/2025/0084_disco_bot_discord_python_post.html Wed, 16 Jul 2025 00:00:00 +0000 blog/2025/0084_disco_bot_discord_python_post.html <div id="toc" class="toc"> <div id="toctitle">Table of Contents</div> <ul class="sectlevel1"> <li><a href="#_導入">導入</a></li> <li><a href="#_コンテキストと現在の課題">コンテキストと現在の課題</a> <ul class="sectlevel2"> <li><a href="#_ミュジックapiの進化">ミュジックAPIの進化</a></li> <li><a href="#_ログ駆動開発アプローチ">ログ駆動開発アプローチ</a></li> </ul> </li> <li><a href="#_概念アーキテクチャ">概念アーキテクチャ</a></li> <li><a href="#_スタック技術と関数型パラダイム">スタック技術と関数型パラダイム</a> <ul class="sectlevel2"> <li><a href="#_技術的選択">技術的選択</a></li> <li><a href="#_適用された機能的原則">適用された機能的原則</a></li> </ul> </li> <li><a href="#_アジャイルメソドロジーとバックログ">アジャイルメソドロジーとバックログ</a> <ul class="sectlevel2"> <li><a href="#_主要なエピック">主要なエピック</a> <ul class="sectlevel3"> <li><a href="#_エピック1インフラストラクチャーボット_discord">エピック1：インフラストラクチャーボット Discord</a></li> <li><a href="#_epic_2_spotify_統合">Epic 2 : Spotify 統合</a></li> <li><a href="#_エピック3_youtube統合">エピック3 : YouTube統合</a></li> <li><a href="#_epic_4_音楽機能">Epic 4 : 音楽機能</a></li> </ul> </li> <li><a href="#_詳細なユーザーストーリー">詳細なユーザーストーリー</a> <ul class="sectlevel3"> <li><a href="#_us1_1_ボットの初期化">US1.1 : ボットの初期化</a></li> <li><a href="#_us2_1_spotify_インテリジェント検索">US2.1 : Spotify インテリジェント検索</a></li> <li><a href="#_us3_1_抽出_youtube_レジリエント">US3.1 : 抽出 YouTube レジリエント</a></li> </ul> </li> </ul> </li> <li><a href="#_ログ駆動開発アプローチ_2">ログ駆動開発アプローチ</a> <ul class="sectlevel2"> <li><a href="#_ロギング戦略">ロギング戦略</a></li> <li><a href="#_ログの構造">ログの構造</a></li> <li><a href="#_ログデザインの例">ログデザインの例</a></li> </ul> </li> <li><a href="#_pydanticを使用したバリデーションアーキテクチャ">Pydanticを使用したバリデーションアーキテクチャ</a> <ul class="sectlevel2"> <li><a href="#_データモデル">データモデル</a></li> </ul> </li> <li><a href="#_機能的なエラー管理">機能的なエラー管理</a> <ul class="sectlevel2"> <li><a href="#_モナドとエラーハンドリング">モナドとエラーハンドリング</a></li> </ul> </li> <li><a href="#_制限回避戦略">制限回避戦略</a> <ul class="sectlevel2"> <li><a href="#_マルチソースアプローチ">マルチソースアプローチ</a></li> </ul> </li> <li><a href="#_反復的開発計画">反復的開発計画</a> <ul class="sectlevel2"> <li><a href="#_スプリントプランニング">スプリントプランニング</a></li> <li><a href="#_品質メトリクス">品質メトリクス</a></li> </ul> </li> <li><a href="#_デプロイメントとモニタリング">デプロイメントとモニタリング</a> <ul class="sectlevel2"> <li><a href="#_本番アーキテクチャ">本番アーキテクチャ</a></li> <li><a href="#_プロアクティブモニタリング">プロアクティブモニタリング</a></li> </ul> </li> <li><a href="#_結論と展望">結論と展望</a> <ul class="sectlevel2"> <li><a href="#_次のステップ">次のステップ</a></li> </ul> </li> </ul> </div> <div class="sect1"> <h2 id="_導入"><a class="anchor" href="#_導入"></a>導入</h2> <div class="sectionbody"> <div class="paragraph"> <p>SpotifyおよびYouTubeのAPIを組み込んだDiscordボットの開発は、特にこれらのプラットフォームの最近の制限や進化に直面する現代的な技術的課題を表しています。この記事は、…に基づく方法論的アプローチを紹介<strong>ログ駆動開発</strong>(LDD)は、テスト駆動開発の拡張で、Pythonを使った関数型パラダイムに適用された。</p> </div> <div class="paragraph"> <p>私たちの目標：堅牢で保守性が高く拡張可能なボットを作成し、現在の音楽APIの制約を乗り越えながら、Discord上でシームレスなユーザー体験を提供すること。</p> </div> </div> </div> <div class="sect1"> <h2 id="_コンテキストと現在の課題"><a class="anchor" href="#_コンテキストと現在の課題"></a>コンテキストと現在の課題</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_ミュジックapiの進化"><a class="anchor" href="#_ミュジックapiの進化"></a>ミュジックAPIの進化</h3> <div class="paragraph"> <p>音楽プラットフォームは、アクセスポリシーを大幅に厳しくした：</p> </div> <div class="ulist"> <ul> <li> <p><strong>スポティファイ</strong>制限: メタデータへのアクセス制限、割り当ての制限</p> </li> <li> <p><strong>ユーチューブ</strong>強化されたアンチボット方針、認証の複雑化</p> </li> <li> <p><strong>ディスコード</strong>: 新しいセキュリティとパフォーマンスの要件</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_ログ駆動開発アプローチ"><a class="anchor" href="#_ログ駆動開発アプローチ"></a>ログ駆動開発アプローチ</h3> <div class="paragraph"> <p>LDDは、ログを開発の中心に置くことでTDDを拡張します:</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>ログの定義</strong>実装の前に</p> </li> <li> <p><strong>観察による検証</strong>期待される振る舞い</p> </li> <li> <p><strong>完全トレーサビリティ</strong>データフロー</p> </li> <li> <p><strong>前向きなデバッグ</strong>エラーを予測して</p> </li> </ol> </div> </div> </div> </div> <div class="sect1"> <h2 id="_概念アーキテクチャ"><a class="anchor" href="#_概念アーキテクチャ"></a>概念アーキテクチャ</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>@startuml !theme aws-orange package "Discord Bot コア" { [Command Handler] as CH [Event Listener] as EL [Log Manager] as LM } package "音楽統合レイヤー" { [Spotify Client] as SC [YouTube Client] as YC [Audio Processor] as AP } package "機能コア" { [Data Validation] as DV [Business Logic] as BL [Error Handling] as EH } package "外部 API" { [Spotify API] as SAPI [YouTube API] as YAPI [Discord API] as DAPI } CH --> BL EL --> BL BL --> DV BL --> EH BL --> LM SC --> SAPI YC --> YAPI CH --> DAPI DV ..> SC : validates DV ..> YC : validates AP --> SC AP --> YC LM --> EH : logs errors LM --> BL : logs operations @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_スタック技術と関数型パラダイム"><a class="anchor" href="#_スタック技術と関数型パラダイム"></a>スタック技術と関数型パラダイム</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_技術的選択"><a class="anchor" href="#_技術的選択"></a>技術的選択</h3> <div class="paragraph"> <p>私たちのスタックは関数型プログラミングを中心に構成されています：</p> </div> <div class="dlist"> <dl> <dt class="hdlist1"><strong>PyMonade</strong></dt> <dd> <p>副作用の管理と関数の合成</p> </dd> <dt class="hdlist1"><strong>ピダンティック</strong></dt> <dd> <p>型安全なデータのバリデーションとシリアライズ</p> </dd> <dt class="hdlist1"><strong>Asyncio</strong></dt> <dd> <p>APIs向けの非同期プログラミング</p> </dd> <dt class="hdlist1"><strong>ストラクトログ</strong></dt> <dd> <p>LDD向けの構造化ログ</p> </dd> </dl> </div> </div> <div class="sect2"> <h3 id="_適用された機能的原則"><a class="anchor" href="#_適用された機能的原則"></a>適用された機能的原則</h3> <div class="listingblock"> <div class="content"> <pre>@startuml !theme plain title 機能的データフロー participant "Discord コマンド" as DC participant "バリデーター" as V participant "ビジネスロジック" as BL participant "APIクライアント" as AC participant "ロガー" as L DC -> V: Raw Input activate V V -> V: Pydantic Validation V -> L: Log Validation V --> DC: Maybe[ValidData] deactivate V DC -> BL: ValidData activate BL BL -> BL: Pure Computation BL -> L: Log Business Logic BL -> AC: API Request activate AC AC -> AC: IO Operation AC -> L: Log API Call AC --> BL: Maybe[Result] deactivate AC BL --> DC: Either[Error, Success] deactivate BL DC -> L: Log Final Result @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_アジャイルメソドロジーとバックログ"><a class="anchor" href="#_アジャイルメソドロジーとバックログ"></a>アジャイルメソドロジーとバックログ</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_主要なエピック"><a class="anchor" href="#_主要なエピック"></a>主要なエピック</h3> <div class="paragraph"> <p>私たちの開発は4つの主要なエピックを中心に組織されています：</p> </div> <div class="sect3"> <h4 id="_エピック1インフラストラクチャーボット_discord"><a class="anchor" href="#_エピック1インフラストラクチャーボット_discord"></a>エピック1：インフラストラクチャーボット Discord</h4> <div class="paragraph"> <p><strong>ビジネスバリュー</strong> : 堅牢で拡張可能な基盤</p> </div> <div class="paragraph"> <p><strong>受入基準</strong> : - 安定したDiscord接続と再接続の管理 モジュラーコマンドシステム - 統合された構造化ロギング 一元的なエラー処理</p> </div> </div> <div class="sect3"> <h4 id="_epic_2_spotify_統合"><a class="anchor" href="#_epic_2_spotify_統合"></a>Epic 2 : Spotify 統合</h4> <div class="paragraph"> <p><strong>業務価値</strong> : 音楽メタデータへのアクセス</p> </div> <div class="paragraph"> <p>受け入れ基準 - セキュアな OAuth2 認証 - インテリジェントなキャッシュを使用したトラック検索 APIクォータ管理 - ネットワークエラー時のフォールバック</p> </div> </div> <div class="sect3"> <h4 id="_エピック3_youtube統合"><a class="anchor" href="#_エピック3_youtube統合"></a>エピック3 : YouTube統合</h4> <div class="paragraph"> <p><strong>ビジネス価値</strong> : 音声コンテンツへのアクセス</p> </div> <div class="paragraph"> <p>受け入れ基準 - 制限の合法的な回避 - 音声抽出の最適化 - プライベート/削除されたビデオの管理 - YouTubeの利用規約を遵守する</p> </div> </div> <div class="sect3"> <h4 id="_epic_4_音楽機能"><a class="anchor" href="#_epic_4_音楽機能"></a>Epic 4 : 音楽機能</h4> <div class="paragraph"> <p><strong>ビジネスバリュー</strong> : 完全なユーザーエクスペリエンス</p> </div> <div class="paragraph"> <p><strong>受入基準</strong> : - 高品質のオーディオ講義 インテリジェントな再生キュー - Discordの音声コマンド - クロスプラットフォーム同期</p> </div> </div> </div> <div class="sect2"> <h3 id="_詳細なユーザーストーリー"><a class="anchor" href="#_詳細なユーザーストーリー"></a>詳細なユーザーストーリー</h3> <div class="sect3"> <h4 id="_us1_1_ボットの初期化"><a class="anchor" href="#_us1_1_ボットの初期化"></a>US1.1 : ボットの初期化</h4> <div class="paragraph"> <p>として 私は確実に接続するDiscordボットが欲しい <strong>Afin de</strong> サービスの可用性を確保する</p> </div> <div class="paragraph"> <p><strong>DoD (完了の定義)</strong> : - [ ] Botは起動時に自動的に接続します - [ ] 構造化ログは各ステップを文書化します 切断時の自動再接続 - [ ] 統合テストがパスする</p> </div> </div> <div class="sect3"> <h4 id="_us2_1_spotify_インテリジェント検索"><a class="anchor" href="#_us2_1_spotify_インテリジェント検索"></a>US2.1 : Spotify インテリジェント検索</h4> <div class="paragraph"> <p>Discordユーザー[<strong>として</strong>] <strong>私は</strong> Spotify を使って曲を検索したい 音楽を発見し共有するために</p> </div> <div class="paragraph"> <p><strong>国防総省</strong> : - [ ] 注文`/search`機能的 - [ ] メタデータを含む関連する結果 - [ ] リクエストを最適化するローカルキャッシュ APIエラーを優雅に処理</p> </div> </div> <div class="sect3"> <h4 id="_us3_1_抽出_youtube_レジリエント"><a class="anchor" href="#_us3_1_抽出_youtube_レジリエント"></a>US3.1 : 抽出 YouTube レジリエント</h4> <div class="paragraph"> <p>システムとして <strong>私は</strong> YouTubeの音声を確実に抽出する サービスの継続性を維持するために</p> </div> <div class="paragraph"> <p><strong>DoD</strong> : - [ ] ToSを違反しない抽出 - [ ] 最適な音質 - [ ] 地理的制限の管理 - [ ] 詳細な操作ログ</p> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ログ駆動開発アプローチ_2"><a class="anchor" href="#_ログ駆動開発アプローチ_2"></a>ログ駆動開発アプローチ</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_ロギング戦略"><a class="anchor" href="#_ロギング戦略"></a>ロギング戦略</h3> <div class="listingblock"> <div class="content"> <pre>@startuml !theme spacelab title ログ駆動開発フロー start :Define Expected Behavior; note right: Spécification des logs attendus :Write Log Assertions; note right: Tests basés sur les logs :Implement Minimal Code; note right: Code juste suffisant :Run & Observe Logs; note right: Validation comportementale if (Logs Match Expectations?) then (yes) :Refactor & Optimize; note right: Amélioration continue else (no) :Debug via Logs; note right: Analyse des écarts :Fix Implementation; endif :Integration Tests; note right: Validation end-to-end stop @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_ログの構造"><a class="anchor" href="#_ログの構造"></a>ログの構造</h3> <div class="paragraph"> <p>私たちのLDDアプローチは、セマンティックレベルを持つ構造化ログを使用します:</p> </div> <div class="dlist"> <dl> <dt class="hdlist1"><strong>�痕跡</strong></dt> <dd> <p>詳細なデータフロー</p> </dd> <dt class="hdlist1"><strong>デバッグ</strong></dt> <dd> <p>関数の内部状態</p> </dd> <dt class="hdlist1"><strong>情報</strong></dt> <dd> <p>成功したビジネスオペレーション</p> </dd> <dt class="hdlist1"><strong>WARN</strong></dt> <dd> <p>劣化しているが管理されている状況</p> </dd> <dt class="hdlist1"><strong>エラー</strong></dt> <dd> <p>介入を必要とするエラー</p> </dd> <dt class="hdlist1"><strong>CRITICAL</strong></dt> <dd> <p>システム障害</p> </dd> </dl> </div> </div> <div class="sect2"> <h3 id="_ログデザインの例"><a class="anchor" href="#_ログデザインの例"></a>ログデザインの例</h3> <div class="paragraph"> <p>Spotifyの検索機能を実装する前に、そのログを定義します：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">INFO: spotify.search.start query="bohemian rhapsody" user_id=123456 DEBUG: spotify.search.validation query_length=16 safe_chars=true DEBUG: spotify.search.api_call endpoint="/search" params={...} INFO: spotify.search.success results_count=15 duration_ms=340</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_pydanticを使用したバリデーションアーキテクチャ"><a class="anchor" href="#_pydanticを使用したバリデーションアーキテクチャ"></a>Pydanticを使用したバリデーションアーキテクチャ</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_データモデル"><a class="anchor" href="#_データモデル"></a>データモデル</h3> <div class="paragraph"> <p>機能的なアプローチは、上流でのバリデーションを優先します：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml !theme cerulean-outline class SpotifyTrack { +id: str +name: str +artists: List[str] +duration_ms: int +external_urls: Dict[str, str] -- +validate_duration() : bool +to_discord_embed() : Embed } class YouTubeVideo { +id: str +title: str +duration: timedelta +available: bool -- +validate_availability() : bool +extract_audio_url() : Optional[str] } class DiscordCommand { +command: str +args: List[str] +user: User +channel: Channel -- +validate_permissions() : bool +log_execution() : None } SpotifyTrack --|> BaseModel YouTubeVideo --|> BaseModel DiscordCommand --|> BaseModel @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_機能的なエラー管理"><a class="anchor" href="#_機能的なエラー管理"></a>機能的なエラー管理</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_モナドとエラーハンドリング"><a class="anchor" href="#_モナドとエラーハンドリング"></a>モナドとエラーハンドリング</h3> <div class="paragraph"> <p>PyMonadeを使用すると、エラーのエレガントな処理が可能になります：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml !theme toy title エラー処理フロー participant "コマンド" as C participant "もしもしもモナド" as M participant "イーザーモナド" as E participant "ロガー" as L C -> M: search_query activate M alt Valid Query M -> E: Success(query) activate E E -> E: api_call() alt API Success E -> L: log_success() E --> C: Right(result) else API Error E -> L: log_api_error() E --> C: Left(api_error) end deactivate E else Invalid Query M -> L: log_validation_error() M --> C: Nothing end deactivate M @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_制限回避戦略"><a class="anchor" href="#_制限回避戦略"></a>制限回避戦略</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_マルチソースアプローチ"><a class="anchor" href="#_マルチソースアプローチ"></a>マルチソースアプローチ</h3> <div class="paragraph"> <p>API の制限に直面して、私たちは多様化戦略を採用します：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml !theme mars title マルチソース戦略 start :User Request; :Primary Source\n(Spotify); if (Available?) then (yes) :Return Spotify Data; stop else (no) :Log Fallback; :Secondary Source\n(YouTube Music); if (Available?) then (yes) :Return YouTube Data; stop else (no) :Tertiary Source\n(Local Cache); if (Available?) then (yes) :Return Cached Data; :Log Cache Hit; stop else (no) :Return Error; :Log Complete Failure; stop end end end @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_反復的開発計画"><a class="anchor" href="#_反復的開発計画"></a>反復的開発計画</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_スプリントプランニング"><a class="anchor" href="#_スプリントプランニング"></a>スプリントプランニング</h3> <div class="paragraph"> <p>私たちの開発は、2週間スプリントのサイクルに従っています：</p> </div> <div class="dlist"> <dl> <dt class="hdlist1"><strong>スプリント 1-2</strong></dt> <dd> <p>インフラストラクチャとDiscord Bot Core</p> </dd> <dt class="hdlist1"><strong>スプリント 3-4</strong></dt> <dd> <p>SpotifyとLDDの連携</p> </dd> <dt class="hdlist1"><strong>スプリント 5-6</strong></dt> <dd> <p>YouTubeの統合と回避策</p> </dd> <dt class="hdlist1"><strong>スプリント 7-8</strong></dt> <dd> <p>高度な音楽的特徴</p> </dd> <dt class="hdlist1"><strong>スプリント 9-10</strong></dt> <dd> <p>最適化と生産</p> </dd> </dl> </div> </div> <div class="sect2"> <h3 id="_品質メトリクス"><a class="anchor" href="#_品質メトリクス"></a>品質メトリクス</h3> <div class="paragraph"> <p>各スプリントは次の項目で評価されます：</p> </div> <div class="ulist"> <ul> <li> <p><strong>ログのカバレッジ</strong>: >90%のクリティカルパス</p> </li> <li> <p><strong>APIの信頼性</strong>: <1% の未処理エラー</p> </li> <li> <p><strong>パフォーマンス</strong>: <500ms平均応答時間</p> </li> <li> <p><strong>保守性</strong>: サイクロマティック複雑度 <10</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_デプロイメントとモニタリング"><a class="anchor" href="#_デプロイメントとモニタリング"></a>デプロイメントとモニタリング</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_本番アーキテクチャ"><a class="anchor" href="#_本番アーキテクチャ"></a>本番アーキテクチャ</h3> <div class="listingblock"> <div class="content"> <pre>@startuml !theme vibrant cloud "Discordサーバー" { [User Commands] } node "本番環境" { [Discord Bot] [Log Aggregator] [Metrics Collector] [Health Monitor] } database "ログストレージ" { [Structured Logs] [Error Traces] [Performance Metrics] } cloud "External APIs" { [Spotify API] [YouTube API] } [User Commands] --> [Discord Bot] [Discord Bot] --> [Log Aggregator] [Discord Bot] --> [Spotify API] [Discord Bot] --> [YouTube API] [Log Aggregator] --> [Structured Logs] [Metrics Collector] --> [Performance Metrics] [Health Monitor] --> [Error Traces] @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_プロアクティブモニタリング"><a class="anchor" href="#_プロアクティブモニタリング"></a>プロアクティブモニタリング</h3> <div class="paragraph"> <p>LDDはインテリジェントなモニタリングを容易にします:</p> </div> <div class="ulist"> <ul> <li> <p><strong>ログのパターンに基づくアラート</strong></p> </li> <li> <p><strong>行動異常検出</strong></p> </li> <li> <p><strong>ビジネスメトリクスのリアルタイム</strong></p> </li> <li> <p><strong>ログの相関によるデバッグ支援</strong></p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論と展望"><a class="anchor" href="#_結論と展望"></a>結論と展望</h2> <div class="sectionbody"> <div class="paragraph"> <p>この方法論的アプローチは、関数型パラダイムの利点とLog Driven Developmentの堅牢性を組み合わせます。これにより私たちは：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>問題を予測する</strong>事前に設計されたログのおかげで</p> </li> <li> <p><strong>品質を維持する</strong>継続的な検証によって</p> </li> <li> <p><strong>素早く適応する</strong>APIの変更に</p> </li> <li> <p><strong>トレーサビリティを確保する</strong>完全な操作の</p> </li> </ol> </div> <div class="paragraph"> <p>反復的な開発とモジュラーアーキテクチャは、音楽プラットフォームの変化する制約に対して拡張性を保証します。</p> </div> <div class="sect2"> <h3 id="_次のステップ"><a class="anchor" href="#_次のステップ"></a>次のステップ</h3> <div class="ulist"> <ul> <li> <p><strong>フェーズ 1</strong>: PyMonadeを使用したコアの実装</p> </li> <li> <p><strong>フェーズ 2</strong>: Spotify インテグレーションとスマートキャッシュ付き</p> </li> <li> <p><strong>フェーズ3</strong>: 耐性のある YouTube ソリューション</p> </li> <li> <p><strong>フェーズ 4</strong>: 高度な機能と最適化</p> </li> </ul> </div> <div class="paragraph"> <p>�堅実な概念的基盤により、技術的な課題を乗り越えながら、例外的なユーザー体験を提供することができます。</p> </div> <hr> <div class="paragraph"> <p><strong>この記事は、各コンポーネントの実装と、コード例および関数パターンを詳しく説明する技術シリーズに続くものです。</strong></p> </div> </div> </div> </div> https://cheroliv.com/blog/2025/0083_cold_computer_post.html Tue, 15 Jul 2025 00:00:00 +0000 blog/2025/0083_cold_computer_post.html <div id="toc" class="toc"> <div id="toctitle">Table of Contents</div> <ul class="sectlevel1"> <li><a href="#_このガイドの目的">このガイドの目的</a></li> <li><a href="#_前提条件">前提条件</a></li> <li><a href="#_ツールをインストールして設定する">ツールをインストールして設定する</a> <ul class="sectlevel2"> <li><a href="#_lm_sensors_を使ってセンサーを検出する">lm-sensors` を使ってセンサーを検出する</a></li> <li><a href="#_tlp_インテリジェントなエネルギー管理者">tlp` : インテリジェントなエネルギー管理者</a></li> <li><a href="#_cpufrequtils_cpuの周波数を制限する">cpufrequtils` : CPUの周波数を制限する</a></li> <li><a href="#_auto_cpufreq_簡素化された動的管理">auto-cpufreq` : 簡素化された動的管理</a></li> <li><a href="#_thermald_自動熱保護">thermald` : 自動熱保護</a></li> </ul> </li> <li><a href="#_リアルタイム監視">リアルタイム監視</a> <ul class="sectlevel2"> <li><a href="#_sensors_コマンドラインで">sensors` コマンドラインで</a></li> <li><a href="#_オプション_gui_psensor">オプション GUI : `psensor</a></li> </ul> </li> <li><a href="#_追加のコツ">追加のコツ</a></li> <li><a href="#_システムをクリーンアップしてオーバーロードを制限する">システムをクリーンアップしてオーバーロードを制限する</a></li> <li><a href="#_さらに進む">さらに進む</a></li> <li><a href="#_結論">�📚 結論</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>Ubuntuでノートパソコンが異常に熱くなっていると感じますか？ この記事は、あなたにアプローチを提案します<strong>ソフトウェア</strong>のための完全な<strong>冷却する</strong>, <strong>監視する</strong> et <strong>温度を制御する</strong>あなたの機械の。</p> </div> </div> </div> <div class="sect1"> <h2 id="_このガイドの目的">このガイドの目的</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>コンピュータの全体温度を下げる</p> </li> <li> <p>エネルギー管理を最適化する</p> </li> <li> <p>クリティカルなコンポーネント（CPU、GPUなど）を監視する</p> </li> <li> <p>発生する遅延を避ける<strong>サーマルスロットリング</strong></p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre>@startuml start :Installer les outils; :Analyser les capteurs; :Appliquer des réglages; note right: cpufreq, tlp, auto-cpufreq :Surveiller en temps réel; stop @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_前提条件">前提条件</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>Ubuntuマシン (20.04以上推奨)</p> </li> <li> <p>インターネット接続</p> </li> <li> <p>コマンドラインスキル(初級～中級レベル)</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_ツールをインストールして設定する">ツールをインストールして設定する</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_lm_sensors_を使ってセンサーを検出する">lm-sensors` を使ってセンサーを検出する</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo apt install lm-sensors sudo sensors-detect sensors</code></pre> </div> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p>答えてください`YES`すべての質問に関する`sensors-detect`モジュールを検出するために。</p> </div> </td> </tr> </table> </div> </div> <div class="sect2"> <h3 id="_tlp_インテリジェントなエネルギー管理者">tlp` : インテリジェントなエネルギー管理者</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo apt install tlp tlp-rdw sudo systemctl enable tlp sudo systemctl start tlp</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre>@startuml (*) --> "TLP はアクティブですか？" if "はい" then --> [yes] "消費削減" --> "CPUの周波数制限" else --> [no] "TLP の起動" --> "自動アクティベーション" endif -->(*) @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_cpufrequtils_cpuの周波数を制限する">cpufrequtils` : CPUの周波数を制限する</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo apt install cpufrequtils cpufreq-info sudo cpufreq-set -g powersave</code></pre> </div> </div> <div class="ulist"> <ul> <li> <p><code>powersave</code>: 周波数のピークを制限します</p> </li> <li> <p><code>performance</code>: 電力を優先し、温度を犠牲にする</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_auto_cpufreq_簡素化された動的管理">auto-cpufreq` : 簡素化された動的管理</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">git clone https://github.com/AdnanHodzic/auto-cpufreq.git cd auto-cpufreq sudo ./auto-cpufreq-installer sudo auto-cpufreq --install</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre>@startuml start :Analyse charge système; :Réglage fréquence CPU; :Vérification température; :Adaptation dynamique; stop @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_thermald_自動熱保護">thermald` : 自動熱保護</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo apt install thermald sudo systemctl enable thermald sudo systemctl start thermald</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_リアルタイム監視">リアルタイム監視</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_sensors_コマンドラインで">sensors` コマンドラインで</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">watch -n 2 sensors</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_オプション_gui_psensor">オプション GUI : `psensor</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo apt install psensor</code></pre> </div> </div> <div class="paragraph"> <p>シンプルなグラフィカルインターフェース CPU、GPU、ファン用。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_追加のコツ">追加のコツ</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>タブと重いアプリケーション（例: ブラウザ）を閉じる</p> </li> <li> <p>バッテリーでの過度な使用を避ける</p> </li> <li> <p>プロセスを介して監視`htop`:</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo apt install htop htop</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_システムをクリーンアップしてオーバーロードを制限する">システムをクリーンアップしてオーバーロードを制限する</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo apt autoremove sudo apt autoclean sudo journalctl --vacuum-time=3d</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_さらに進む">さらに進む</h2> <div class="sectionbody"> <div class="paragraph"> <p>サービスを作成できます`systemd`カスタマイズして起動時に特定の設定を自動的に適用する 次の記事で例をご希望ですか？お知らせください！</p> </div> </div> </div> <div class="sect1"> <h2 id="_結論">�📚 結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>これらのシンプルなツールを組み合わせると、あなたは得られるでしょう：</p> </div> <div class="ulist"> <ul> <li> <p>管理されたCPU温度</p> </li> <li> <p>�換気の騒音が少ない</p> </li> <li> <p>より良い自律性</p> </li> </ul> </div> <div class="paragraph"> <p>温度を定期的に監視し、過熱を防いでください。</p> </div> <div class="paragraph"> <p><em>__</em> CPUを溶かすよりも、予防する方がいい。 (Empty output)</p> </div> </div> </div> https://cheroliv.com/blog/2025/0082_ui_struggle_post.html Mon, 14 Jul 2025 00:00:00 +0000 blog/2025/0082_ui_struggle_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_戦場モックアップ三つのブラウザー複数のレンダリング">戦場：モックアップ、三つのブラウザー、複数のレンダリング</a></li> <li><a href="#_問題1ヒーローセクションの飛ぶカード">問題1：ヒーローセクションの飛ぶカード</a></li> <li><a href="#_問題2食人ナビゲーションバー">問題2：食人ナビゲーションバー</a></li> <li><a href="#_問題3無秩序なタイポグラフィー">問題3：無秩序なタイポグラフィー</a></li> <li><a href="#_問題4オーバーフローするナビゲーションバー">問題4：オーバーフローするナビゲーションバー</a></li> <li><a href="#_問題5見えないハンバーガーメニュー">問題5：見えないハンバーガーメニュー</a></li> <li><a href="#_結論執拗なデバッグから得た教訓">結論：執拗なデバッグから得た教訓</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p><strong>読了時間：</strong> 約7分 <strong>レベル：</strong> 中級</p> </div> </td> </tr> </table> </div> <div class="paragraph"> <p>この詳細な実践ケースでは、Bootstrap 5.2 を使用した UI モックアップの作成時に遭遇する最も一般的で、時として最もフラストレーションを引き起こすブラウザ互換性の問題を解剖します。Flexbox の管理からフォントレンダリングの微妙さまで、私たちのデバッグプロセスを紹介し、Firefox で崩れたデザインをすべてのブラウザでピクセルパーフェクトな体験に変える方法を学びます。</p> </div> <hr> </div> </div> <div class="sect1"> <h2 id="_戦場モックアップ三つのブラウザー複数のレンダリング">戦場：モックアップ、三つのブラウザー、複数のレンダリング</h2> <div class="sectionbody"> <div class="paragraph"> <p>すべてのフロントエンド開発者はこの感覚を知っている。何時間も作業して、ようやくデザインが完璧になる。配置は正確で、タイポグラフィはエレガント、アニメーションは滑らかである。満足のため息をつき、Chrome（またはBrave、またはEdge）で自分の作品を称賛し、さらに念のためにFirefoxでプロジェクトを開く。すると、そこが悲劇の始まりだ。要素がはみ出し、配置が崩れ、フォントのサイズが乱れ…美しい調和はかき消えてしまった。</p> </div> <div class="paragraph"> <p>これは、新しいポートフォリオインターフェースを開発する際に直面したまさにそのシナリオです。要件はシンプルで、モダンでレスポンシブなホームページ、テーマセレクター（ライト、ダーク、ハイコントラスト）を備え、<strong>vanilla JavaScript</strong> と <strong>Bootstrap 5.2</strong> の最新バージョンを使用すること。</p> </div> <div class="paragraph"> <p>この記事は奇跡的な解決策のリストではありません。これは私たちのデバッグセッションのログであり、Blinkエンジン（Chromium、Brave）とGeckoエンジン（Firefox）間のレンダリングの違いの「なぜ」に深く迫るものであり、堅牢で現代的な解決策が常に急ごしらえのパッチよりも優れていることを示しています。</p> </div> <div class="listingblock"> <div class="title">ユースケース図 : デバッグプロセス</div> <div class="content"> <pre>@startuml left to right direction actor "フロントエンド開発者" as Dev rectangle "モックアップ UI Bootstrap 5" { usecase "Flexboxのアライメントを修正する" as UC1 usecase "パディングを動的に調整する（JS）" as UC2 usecase "タイポグラフィを制御する (clamp())" as UC3 usecase "メニューのオーバーフローを解決する" as UC4 usecase "メニューのアイコンを表示する" as UC5 } actor "Firefox ブラウザ" as Firefox Dev -- (UC1) Dev -- (UC2) Dev -- (UC3) Dev -- (UC4) Dev -- (UC5) (UC1) ..> Firefox : <<extend>> (UC2) ..> Firefox : <<extend>> (UC3) ..> Firefox : <<extend>> (UC4) ..> Firefox : <<extend>> (UC5) ..> Firefox : <<extend>> note right of Firefox : Révèle les problèmes de compatibilité @enduml</pre> </div> </div> <div class="listingblock"> <div class="title">コンポーネント図 : フロントエンドソリューションのアーキテクチャ</div> <div class="content"> <pre>@startuml !theme plain package "フロントエンドソリューション" { component "HTML (テンプレート FTL)" as HTML component "script.js" as JS component "styles.css" as CSS interface "DOMの操作" as iDOM interface "CSSの修正" as iCSS } package "フレームワーク" { component "Bootstrap 5.2" as BS interface "CSS変数" as iVars interface "ユーティリティクラス" as iUtils } HTML ..> iDOM : nécessite JS ..> iDOM : réalise HTML ..> iCSS : nécessite CSS ..> iCSS : réalise CSS ..> iVars : nécessite BS ..> iVars : fournit HTML ..> iUtils : utilise BS ..> iUtils : fournit note right of JS - Mesure la hauteur de la navbar - Applique le padding dynamiquement end note note right of CSS - Utilise clamp() pour la typographie - Réduit les marges du menu - Surcharge l'icône du menu via les variables end note @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_問題1ヒーローセクションの飛ぶカード">問題1：ヒーローセクションの飛ぶカード</h2> <div class="sectionbody"> <div class="paragraph"> <p>最初のバグはまた最も目立つものでした。ウェルカムセクション ("hero") は、2列で構成されています：左側にメインタイトル、右側に紹介カード。</p> </div> <div class="ulist"> <ul> <li> <p><strong>症状 :</strong>ChromeとBraveでは、2つの列は垂直方向に完璧に中央揃えられていました。 Firefoxでは、右のカードが説明不能なほど左のテキストの下に落ちました。</p> </li> <li> <p><strong>調査：</strong>HTMLコードは単純で正しそうに見えましたが、Bootstrapの標準クラスを使用していました。</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><section id="home" class="hero-section"> <div class="container"> <!-- Cette ligne est la clé du problème --> <div class="row align-items-center min-vh-100"> <div class="col-lg-6"> <!-- Contenu de gauche --> </div> <div class="col-lg-6"> <!-- Carte de droite --> </div> </div> </div> </section></code></pre> </div> </div> <div class="paragraph"> <p>私たちのカスタムCSS`.hero-section`定義していた`display: flex` et <code>align-items: center</code>，そしてクラス`min-vh-100`行に最小の高さを与えていた (<code>div.row</code>). それでは、なぜFirefoxは列を中央揃えにしなかったのですか？</p> </div> <div class="ulist"> <ul> <li> <p><strong>根本原因：</strong>これはレンダリングエンジンが暗黙の高さをどのように解釈するかの教科書的な例です。その`<section>`持っていた`min-height`, でも`height`明示的。適用するために`align-items-center`中に`div.row`, Firefoxはこのコンテナの参照の高さを知る必要があります。その親要素と同じように (<code>div.container</code> et la `<section>`それ自身には高さがなかった<strong>�厳しい</strong>Firefoxは行き詰まっていた。より許容的なBlinkエンジンは、意図を"推測"し、要素を中央に揃えることができる。仕様に忠実なGeckoはそれを行わない。</p> </li> <li> <p><strong>解決策 :</strong>高さを明示的にする。私たちは強制した`.container` et le `.row`それぞれの親の高さの100%を占有するために、ユーティリティクラスを使用する`h-100`の Bootstrap.</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><section id="home" class="hero-section"> <div class="container h-100"> <div class="row align-items-center min-vh-100 h-100"> <!-- ... --> </div> </div> </section></code></pre> </div> </div> <div class="admonitionblock tip"> <table> <tr> <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> <div class="paragraph"> <p>の`align-items`Flexbox は垂直軸で期待通りに機能しません。常にコンテナに高さがあることを確認してください。<code>height</code> ou <code>min-height</code>) 定義されており、問題が続く場合（特にFirefoxでは）、中間コンテナがこの高さを適切に伝播するようにしてください。</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_問題2食人ナビゲーションバー">問題2：食人ナビゲーションバー</h2> <div class="sectionbody"> <div class="paragraph"> <p>「Hero」セクションが配置された後、別の問題が発生しました：ナビゲーションバーとそのクラス`fixed-top`, タイトルに重なっていました。Un`padding-top: 80px`これは"Hero"セクションに解決策として適用されていた。</p> </div> <div class="ulist"> <ul> <li> <p><strong>症状：</strong> Le `padding`Chromeでは十分だったが、Firefoxではそうではなく、タイトルは常に一部がマスクされたままだった。</p> </li> <li> <p><strong>根本原因：</strong>「マジックナンバー」の使用 (<code>80px</code>) は非常に悪い習慣です。ナビゲーションバーのような要素の高さは、フォントのレンダリング、間隔、あるいはユーザー設定の微妙な違いにより、ブラウザごとに数ピクセル変わることがあります。固定値に頼るのは、脆弱なデザインへのレシピです。</p> </li> <li> <p><strong>解決策：</strong>JavaScriptでの動的で確実な解決策。 私たちは：のために小さなスクリプトを書きました</p> </li> <li> <p>ページのレンダリング後のナビゲーションバーの*実際の*高さを測定する。</p> </li> <li> <p>この測定した高さを適用する`padding-top`セクション「Hero」。</p> </li> <li> <p>ウィンドウのサイズが変更されるたびにこの関数を再実行し、変更に対応させる（ハンバーガーメニューへの切り替えなど）。</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">document.addEventListener('DOMContentLoaded', function() { function adjustHeroPadding() { const navbar = document.querySelector('.navbar.fixed-top'); const heroSection = document.querySelector('.hero-section'); if (navbar && heroSection) { const navbarHeight = navbar.offsetHeight; heroSection.style.paddingTop = navbarHeight + 'px'; } } // Ajuster au chargement et au redimensionnement adjustHeroPadding(); window.addEventListener('resize', adjustHeroPadding); });</code></pre> </div> </div> <div class="listingblock"> <div class="title">シーケンス図 : パディングの動的調整</div> <div class="content"> <pre>@startuml title 人食いナビゲーションバーの問題の解決策 actor Utilisateur participant "ブラウザ" as Browser participant "script.js" as JS participant "DOM" as DOM Utilisateur -> Browser: Charge la page activate Browser Browser -> JS: Déclenche l'événement 'DOMContentLoaded' activate JS JS -> DOM: querySelector('.navbar.fixed-top') activate DOM DOM --> JS: Retourne l'élément Navbar deactivate DOM JS -> DOM: querySelector('.hero-section') activate DOM DOM --> JS: Retourne l'élément Hero deactivate DOM JS -> DOM: navbar.offsetHeight activate DOM DOM --> JS: Retourne la hauteur calculée (ex: 83px) deactivate DOM JS -> DOM: heroSection.style.paddingTop = "83px" activate DOM deactivate DOM deactivate JS deactivate Browser ... Plus tard ... Utilisateur -> Browser: Redimensionne la fenêtre activate Browser Browser -> JS: Déclenche l'événement 'resize' activate JS JS -> JS: Exécute à nouveau adjustHeroPadding() note right of JS: Le processus de mesure et\nd'application du padding se répète. deactivate JS deactivate Browser @enduml</pre> </div> </div> <div class="paragraph"> <p>並行して、もちろんルールを削除しました`padding-top: 80px;`私たちのファイルの`styles.css`。</p> </div> </div> </div> <div class="sect1"> <h2 id="_問題3無秩序なタイポグラフィー">問題3：無秩序なタイポグラフィー</h2> <div class="sectionbody"> <div class="ulist"> <div class="title">次の懸念はブランドイメージに最も有害だった：見出しのサイズ。</div> <ul> <li> <p><strong>�症状：</strong>Firefoxでは、タイトル "Développeur Formateur…​" のフォントが巨大で、ほとんど衝撃的だったのに対し、他のブラウザーでは調和が取れていた。</p> </li> <li> <p><strong>根本的な原因：</strong>タイトルはクラスを使用していました`display-4`Bootstrap のこれらのクラスは、レスポンシブなフォントサイズを使用し、しばしば単位に基づいています。`rem`メディアクエリも含みます。もう一度、Firefoxのレンダリングアルゴリズムと「Inter」フォントの組み合わせにより、1920x1080の解像度で文字サイズの計算がはるかに大きくなりました。</p> </li> <li> <p><strong>解決策：</strong>CSS関数を使ってコントロールを取り戻す`clamp()<code>. この機能はフローディタイポグラフィに革命をもたらします。これにより、3つの値でフォントサイズを定義できます： 最小サイズ、および「推奨」サイズ（ビューの幅に適応する、`vw</code>), そして最大のサイズ。</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">.hero-content h1 { color: var(--text-primary); line-height: 1.2; /* Min: 2rem Préférée: s'adapte à la vue Max: 2.5rem (40px) */ font-size: clamp(2rem, 1.2rem + 1.5vw, 2.5rem); }</code></pre> </div> </div> <div class="paragraph"> <p>と`clamp()<code>, ブラウザに「画面に合わせてフォントを大きくして、ただし超えないように」と伝えることができました。<strong>決して</strong>の限界`2.5rem</code>. これはすべてのブラウザでのレンダリングを瞬時に統一し、最終的な美観に対する絶対的なコントロールを得ることができました。</p> </div> </div> </div> <div class="sect1"> <h2 id="_問題4オーバーフローするナビゲーションバー">問題4：オーバーフローするナビゲーションバー</h2> <div class="sectionbody"> <div class="ulist"> <div class="title">これが私たちに最も手間取らせた問題であり、最終的にレンダリングの微妙な違いの本質を明らかにした。</div> <ul> <li> <p><strong>�症状：</strong>1920x1080の画面では、メニューの最後のリンク（「Blog」、「Contact」）が画面の右側に押し出されていましたが、Firefoxだけで起きていました。</p> </li> <li> <p><strong>根本的な原因：</strong>いくつかの失敗した試みの後 （Bootstrapのブレークポイントを変更する`lg` à <code>xl`それから`xxl</code>), 私たちは理解しました。原因はBootstrapのロジックではなく、単純な幅の計算でした。Firefoxでは、すべてのリンクの幅の合計、それらのを含む`padding` et `margin`サブピクセル単位まで、それは <strong>やや</strong> 1920 ピクセルを上回っていました。 Chromeでは、同じ合計は <strong>やや</strong> 小さかった。 いくつかのピクセルが足りませんでした。</p> </li> <li> <p><strong>解決策：</strong>外科的な間隔の削減。Firefoxを特定的に対象とする古いCSSの「ハック」を使用するわけにはいかなかったため、唯一のきれいな解決策は、どこでも機能する共通のスタイルを見つけることでした。したがって、各ナビゲーションリンクの水平マージンとパディングをわずかに縮小しました。</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">/* La version finale, légèrement plus compacte */ .navbar-nav .nav-link { font-size: 0.9rem; /* 90% de la taille de base */ color: var(--text-primary) !important; font-weight: 500; margin: 0 0.2rem; padding: 0.5rem 0.5rem !important; border-radius: 0.375rem; transition: all 0.3s ease; }</code></pre> </div> </div> <div class="paragraph"> <p>この削減は、単一の要素では肉眼ではほとんど見えないほど小さいものですが、これによりFirefoxで全てのリンクが枠内に収まるために必要なスペースを集団として確保でき、他のブラウザーではほぼ同じ外観を保っています。</p> </div> </div> </div> <div class="sect1"> <h2 id="_問題5見えないハンバーガーメニュー">問題5：見えないハンバーガーメニュー</h2> <div class="sectionbody"> <div class="ulist"> <div class="title">最後の問題、しかも軽視できない問題は、モバイルでのアクセシビリティに関するものでした。</div> <ul> <li> <p><strong>症状 :</strong>レスポンシブモード（ハンバーガーメニュー）では、ダークテーマおよびハイコントラストテーマでメニューアイコンが見えませんでした。</p> </li> <li> <p><strong>根本的な原因:</strong>Bootstrap 5のメニューのアイコンは`background-image`(URLエンコードされた SVG). デフォルトでは、そのストロークの色は暗く、明るい背景に最適化されています。 それはテーマの変更に自動的には適応しません。</p> </li> <li> <p><strong>解決策 :</strong>Bootstrap の CSS 変数を使用してアイコンを上書きします。白いストロークの新しい SVG アイコンを定義しましたが、<code>#ffffff</code>)、そして私たちはそれを具体的に適用しましたときにテーマ`dark` ou <code>high-contrast</code>�稼働している。</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">/* ====================== Fix pour l'icône du menu Burger (Blanc) ====================== */ [data-bs-theme="dark"] .navbar-toggler-icon, [data-bs-theme="high-contrast"] .navbar-toggler-icon { --bs-navbar-toggler-icon-bg: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 30 30'%3e%3cpath stroke='%23ffffff' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e"); }</code></pre> </div> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="Important"></i> </td> <td class="content"> <div class="paragraph"> <p>Bootstrap のこのようなコンポーネントのカスタマイズは、CSS 変数のオーバーライドを介してますます行われています (<code>--bs-component-property</code>), これは最も清潔で持続可能な方法です。</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_結論執拗なデバッグから得た教訓">結論：執拗なデバッグから得た教訓</h2> <div class="sectionbody"> <div class="paragraph"> <p>この道のり、時々苛立たしいかもしれないが、学びに満ちている。それぞれの解決された問題は、ウェブ開発の基本的な真実を強化する：<strong>厳格なマルチブラウザテストに代わりになるものは何もない</strong>。</p> </div> <div class="listingblock"> <div class="title">マインドマップ : デバッグと学んだ教訓のまとめ</div> <div class="content"> <pre>@startmindmap + Débogage Cross-Browser : Bootstrap 5 ++ **Conflit :** Chrome (Blink) vs Firefox (Gecko) ++ **Problème 1 : Alignement Hero** +++ Cause : Hauteur implicite +++ Solution : Classe `.h-100` ++ **Problème 2 : Navbar Cannibale** +++ Cause : "マジックナンバー" (padding fixe) +++ Solution : JS `offsetHeight` ++ **Problème 3 : Typographie Géante** +++ Cause : Rendu des `rem` +++ Solution : CSS `clamp()` ++ **Problème 4 : Menu qui déborde** +++ Cause : Calcul de largeur sub-pixel +++ Solution : Réduction des marges/paddings ++ **Problème 5 : Icône Invisible** +++ Cause : SVG non adaptable au thème +++ Solution : Surcharge de variable CSS ++ **Leçons Clés** +++ Firefox force un code robuste +++ Fuir les "マジックナンバー" +++ Maîtriser la typographie fluide +++ Personnaliser via les variables CSS @endmindmap</pre> </div> </div> <div class="olist arabic"> <div class="title">これが私たちが保持している教訓 :</div> <ol class="arabic"> <li> <p><strong>Firefoxは味方です :</strong>CSS標準への最高の適合性が、より堅牢で曖昧さの少ないコードを書くよう私たちを強制する。</p> </li> <li> <p><strong>「魔法の数」を避けて :</strong>固定値 (のように`padding-top: 80px`) は時限爆弾です。常に動的なソリューション（JavaScript）または相対的なソリューション（Flexbox、Grid）を好むべきです。</p> </li> <li> <p><strong>タイポグラフィをマスター：</strong>使ってください`clamp()`レスポンシブフォントのサイズを完全に制御するために。</p> </li> <li> <p><strong>「コンポーネント」を考えて：</strong>Bootstrapをカスタマイズするには、フレームワークを上書きするルールを増やすのではなく、そのCSS変数を上書きしてください。</p> </li> <li> <p><strong>ブラウザを対象としないで：</strong>解決策はほとんどの場合、特定のブラウザ向けに "hack" を行うことではなく、どこでも機能する共通のスタイルを見つけることです。</p> </li> </ol> </div> <div class="paragraph"> <p>最終的に、モックアップは堅牢で予測可能になり、テンプレートシステムに組み込む準備が整いました。修正されたバグは失敗ではなく、より良いコードへ向けた一歩でした。</p> </div> </div> </div> https://cheroliv.com/blog/2025/0081_TDD_Gradle_Properties_Fix_post.html Sun, 13 Jul 2025 00:00:00 +0000 blog/2025/0081_TDD_Gradle_Properties_Fix_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_問題_gradleプラグインのユニットテストを分離する">問題: Gradleプラグインのユニットテストを分離する</a> <ul class="sectlevel2"> <li><a href="#_問題のアーキテクチャ">問題のアーキテクチャ</a></li> <li><a href="#_偽りの良いアイデアへの誘惑">偽りの良いアイデアへの誘惑</a></li> </ul> </li> <li><a href="#_ソリューション_extrapropertiesextension_を使ってプロパティをシミュレートする">ソリューション : <code>ExtraPropertiesExtension</code> を使ってプロパティをシミュレートする</a> <ul class="sectlevel2"> <li><a href="#_ステップ_1_extrapropertiesextensionを理解する">ステップ 1 : ExtraPropertiesExtensionを理解する</a></li> <li><a href="#_ステップ_2_テストのセットアップ_準備">ステップ 2: テストのセットアップ - 準備</a></li> <li><a href="#_ステップ_3プロパティの注入">ステップ 3：プロパティの注入</a></li> <li><a href="#_ステップ4ソリューションフロー図">ステップ4：ソリューションフロー図</a></li> <li><a href="#_ステップ_5_前後比較">ステップ 5 : 前後比較</a></li> <li><a href="#_ステップ6_複数のテストケースの管理">ステップ6: 複数のテストケースの管理</a></li> <li><a href="#_ソリューションの最終アーキテクチャ">ソリューションの最終アーキテクチャ</a></li> </ul> </li> <li><a href="#_このアプローチの利点">このアプローチの利点</a></li> <li><a href="#_ベストプラクティスとアドバイス">ベストプラクティスとアドバイス</a> <ul class="sectlevel2"> <li><a href="#_ユーティリティメソッドを作成する">ユーティリティメソッドを作成する</a></li> <li><a href="#_プロパティの検証">プロパティの検証</a></li> </ul> </li> <li><a href="#_結論">結論</a></li> </ul> </div> <div class="sect1"> <h2 id="_問題_gradleプラグインのユニットテストを分離する">問題: Gradleプラグインのユニットテストを分離する</h2> <div class="sectionbody"> <div class="paragraph"> <p>Gradleプラグインのユニットテストを書く際の一般的な課題は、プロジェクト設定への依存関係を管理すること、ファイルに定義されたプロパティなど`gradle.properties`. 私たちのケースでは、プラグイン`jbake.ghpages`プロパティを読む必要があった`site_config_path`正常に機能するために。 タスクの単体テスト`initialize`彼はこのプロパティが存在するときのプラグインの動作を確認しなければならなかった。</p> </div> <div class="paragraph"> <p>根本的な問題は、単体テストは設計上、<strong>孤立している</strong> 必要があるということです。使用法は`ProjectBuilder`Gradleのインスタンスを作成する`Project`メモリ上にあり、ファイルシステム上の実際のプロジェクトから完全に切り離されている。 したがって、このテスト インスタンスは自動的にファイルを読み込まない`gradle.properties`したがって、そのプロパティについて知識を持っていない`site_config_path`.</p> </div> <div class="sect2"> <h3 id="_問題のアーキテクチャ">問題のアーキテクチャ</h3> <div class="paragraph"> <p>次の図は、テスト環境とファイルシステムの切断を示しています：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml !define RECTANGLE class package "本番環境" { RECTANGLE ProjectReal { + build.gradle.kts + gradle.properties + src/ } RECTANGLE GradleProperties { site_config_path=src/jbake/settings/site.yml } RECTANGLE JbakePlugin { - readProperty(name: String) + initialize() } ProjectReal --> GradleProperties : lit au démarrage JbakePlugin --> GradleProperties : accède via project.properties } package "テスト環境" { RECTANGLE ProjectTest { + Créé par ProjectBuilder + En mémoire uniquement + Pas de gradle.properties } RECTANGLE JbakePluginTest { + testInitialize() } ProjectTest -[#red]x GradleProperties : ❌ Pas d'accès JbakePluginTest --> ProjectTest : utilise } note right of ProjectTest : Isolation = Pas d'accès\nau système de fichiers @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_偽りの良いアイデアへの誘惑">偽りの良いアイデアへの誘惑</h3> <div class="paragraph"> <p>最初のアプローチとしては、ファイルを作成することが考えられます。`gradle.properties`テストのリソースにおける架空の</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">// src/test/resources/gradle.properties site_config_path=src/jbake/settings/site.yml</code></pre> </div> </div> <div class="paragraph"> <p>しかし、この方法は失敗する運命にあるため`ProjectBuilder`これはファイルシステムをスキャンして設定ファイルを探すようには設計されていません。テストは孤立した状態のまま残り、このファイルを無視します。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ソリューション_extrapropertiesextension_を使ってプロパティをシミュレートする">ソリューション : <code>ExtraPropertiesExtension</code> を使ってプロパティをシミュレートする</h2> <div class="sectionbody"> <div class="paragraph"> <p>この問題のエレガントな解決策は、ファイルを*読む*ことではなく、オブジェクトに直接プロパティの存在を*シミュレート*することです。`Project`テスト。 Gradle はこれを行うための強力なメカニズムを提供しています： <strong>追加プロパティ</strong> (追加プロパティ)。</p> </div> <div class="sect2"> <h3 id="_ステップ_1_extrapropertiesextensionを理解する">ステップ 1 : ExtraPropertiesExtensionを理解する</h3> <div class="paragraph"> <p>`ExtraPropertiesExtension`Gradleモデルの各オブジェクトに添付されたキー値コンテナです。プロジェクト、タスク、またはその他のGradle拡張に動的にプロパティを追加することができます。</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml !define RECTANGLE class RECTANGLE Project { + name: String + version: String + extensions: ExtensionContainer + properties: Map<String, ?> } RECTANGLE ExtensionContainer { + getByType(Class<T>): T + add(String, Object): void } RECTANGLE ExtraPropertiesExtension { + set(String, Object): void + get(String): Object + has(String): boolean + getProperties(): Map<String, Object> } Project --> ExtensionContainer : contient ExtensionContainer --> ExtraPropertiesExtension : gère ExtraPropertiesExtension --> Project : synchronise avec\nproject.properties note right of ExtraPropertiesExtension : Point d'entrée pour\ninjecter des propriétés @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_ステップ_2_テストのセットアップ_準備">ステップ 2: テストのセットアップ - 準備</h3> <div class="paragraph"> <p>まず、私たちの単体テストの基本構造を作成しましょう :</p> </div> <div class="listingblock"> <div class="title">JbakeGhPagesPluginTest.kt - Structure de base</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class JbakeGhPagesPluginTest { @TempDir lateinit var testProjectDir: File @Test fun `check initialize and config yaml file if not existing`() { // Étape 1 : Créer un projet de test isolé val project = ProjectBuilder.builder() .withProjectDir(testProjectDir) .build() // Suite des étapes... } }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ステップ_3プロパティの注入">ステップ 3：プロパティの注入</h3> <div class="paragraph"> <p>テストプロジェクトにプロパティを注入する詳細なプロセスは次のとおりです：</p> </div> <div class="listingblock"> <div class="title">JbakeGhPagesPluginTest.kt - Injection complète</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `check initialize and config yaml file if not existing`() { // Étape 1 : Créer un projet de test isolé en mémoire val project = ProjectBuilder.builder() .withProjectDir(testProjectDir) .build() // Étape 2 : Récupérer le gestionnaire de propriétés supplémentaires val extra = project.extensions.getByType(ExtraPropertiesExtension::class.java) // Étape 3 : Définir la propriété requise pour ce test extra.set("site_config_path", "src/jbake/settings/site.yml") // Étape 4 : Vérifier que la propriété est bien injectée assertTrue(project.hasProperty("site_config_path")) // Étape 5 : Appliquer le plugin qui pourra maintenant accéder à la propriété project.plugins.apply("jbake.ghpages") // Étape 6 : Exécuter la tâche et vérifier son comportement val task: Task = project.tasks.findByName("initialize") .apply(::assertNotNull)!! // Étape 7 : Exécuter les actions de la tâche task.actions.forEach { it.execute(task) } // Étape 8 : Assertions finales assertEquals( "src/jbake/settings/site.yml", project.properties["site_config_path"], "La propriété devrait être accessible dans le projet" ) }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ステップ4ソリューションフロー図">ステップ4：ソリューションフロー図</h3> <div class="listingblock"> <div class="content"> <pre>@startuml start :Créer ProjectBuilder; :Obtenir ExtraPropertiesExtension; :Injecter la propriété\nvia extra.set(); partition "�検証" { :Vérifier project.hasProperty(); :Appliquer le plugin; :Récupérer la tâche; } partition "実行" { :Exécuter les actions\nde la tâche; :Le plugin lit\nproject.properties; } partition "主張" { :Vérifier la propriété\nest accessible; :Valider le comportement\nattendues; } stop @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_ステップ_5_前後比較">ステップ 5 : 前後比較</h3> <div class="listingblock"> <div class="content"> <pre>@startuml !define RECTANGLE class package "前 - 課題" { RECTANGLE TestProject1 { + ProjectBuilder.build() + Pas de propriétés } RECTANGLE Plugin1 { + initialize() + ❌ project.properties["サイト設定パス"] = null } TestProject1 --> Plugin1 : échec note right of Plugin1 : Test échoue car\nla propriété n'existe pas } package "後 - 解決策" { RECTANGLE TestProject2 { + ProjectBuilder.build() + ExtraPropertiesExtension } RECTANGLE ExtraProps { + set("サイト設定パス", "...") } RECTANGLE Plugin2 { + initialize() + ✅ project.properties["サイト設定パス"] = "src/jbake/settings/site.yml" } TestProject2 --> ExtraProps : configure ExtraProps --> Plugin2 : propriété disponible note right of Plugin2 : Test réussit car\nla propriété est simulée } @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_ステップ6_複数のテストケースの管理">ステップ6: 複数のテストケースの管理</h3> <div class="paragraph"> <p>異なるシナリオをテストするために、様々な構成を持つ複数のテストを作成しましょう：</p> </div> <div class="listingblock"> <div class="title">Tests multiples avec configurations différentes</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class JbakeGhPagesPluginTest { @TempDir lateinit var testProjectDir: File private fun createProjectWithProperty(propertyValue: String?): Project { val project = ProjectBuilder.builder() .withProjectDir(testProjectDir) .build() // Injection conditionnelle de la propriété propertyValue?.let { value -> val extra = project.extensions.getByType(ExtraPropertiesExtension::class.java) extra.set("site_config_path", value) } return project } @Test fun `should work with valid property`() { val project = createProjectWithProperty("src/jbake/settings/site.yml") project.plugins.apply("jbake.ghpages") val task = project.tasks.findByName("initialize")!! task.actions.forEach { it.execute(task) } // Assertions pour le cas normal assertEquals("src/jbake/settings/site.yml", project.properties["site_config_path"]) } @Test fun `should handle missing property gracefully`() { val project = createProjectWithProperty(null) // Pas de propriété project.plugins.apply("jbake.ghpages") val task = project.tasks.findByName("initialize")!! // Le plugin devrait gérer l'absence de propriété assertDoesNotThrow { task.actions.forEach { it.execute(task) } } } @Test fun `should handle invalid property path`() { val project = createProjectWithProperty("invalid/path/to/config.yml") project.plugins.apply("jbake.ghpages") val task = project.tasks.findByName("initialize")!! // Test du comportement avec un chemin invalide assertThrows<FileNotFoundException> { task.actions.forEach { it.execute(task) } } } }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ソリューションの最終アーキテクチャ">ソリューションの最終アーキテクチャ</h3> <div class="listingblock"> <div class="content"> <pre>@startuml !define RECTANGLE class package "テスト環境" { RECTANGLE TestClass { + createProjectWithProperty() + testValidProperty() + testMissingProperty() + testInvalidProperty() } RECTANGLE ProjectBuilder { + builder() + withProjectDir() + build() } RECTANGLE TestProject { + extensions + properties + plugins + tasks } RECTANGLE ExtraPropertiesExtension { + set(key, value) + get(key) + has(key) } RECTANGLE JbakePlugin { + apply(project) + createInitializeTask() + readSiteConfigPath() } } TestClass --> ProjectBuilder : utilise ProjectBuilder --> TestProject : crée TestProject --> ExtraPropertiesExtension : contient TestClass --> ExtraPropertiesExtension : configure ExtraPropertiesExtension --> TestProject : synchronise properties TestProject --> JbakePlugin : applique JbakePlugin --> TestProject : lit properties note right of ExtraPropertiesExtension : Point de contrôle\npour l'injection note bottom of TestProject : Environnement\ncontrôlé et isolé @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_このアプローチの利点">このアプローチの利点</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><strong>完全な隔離</strong>: テストは外部ファイルに依存しません。これは自立しており、任意の環境（ローカル、CI/CD など）で信頼性高く実行できます。</p> </li> <li> <p><strong>明瞭さと意図</strong>テストは、実行に必要な前提条件を明示的に宣言します。テストを読む人は誰でも、すぐにプラグインがプロパティを必要とすることがわかります。`site_config_path`動作するために。</p> </li> <li> <p><strong>保守性</strong>: プロパティの名前が変更された場合、テストの設定ファイルを操作することなく、テスト内の1か所だけを更新すればよい。</p> </li> <li> <p><strong>柔軟性</strong>各テストで注入されたプロパティの値を単純に変更するだけで、さまざまなシナリオをテストすることが容易になります（有効な値、無効な値、存在しない値など）。</p> </li> <li> <p><strong>パフォーマンス</strong>: ファイルの読み込みは行われず、すべてメモリ内で行われるため、テストがより高速になります。</p> </li> <li> <p><strong>再現性</strong>テストは決定論的であり、ファイルシステムの状態に依存しないからです。</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_ベストプラクティスとアドバイス">ベストプラクティスとアドバイス</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_ユーティリティメソッドを作成する">ユーティリティメソッドを作成する</h3> <div class="listingblock"> <div class="title">Méthode utilitaire pour la réutilisation</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class GradleTestUtils { companion object { fun createProjectWithProperties( projectDir: File, properties: Map<String, String> ): Project { val project = ProjectBuilder.builder() .withProjectDir(projectDir) .build() val extra = project.extensions.getByType(ExtraPropertiesExtension::class.java) properties.forEach { (key, value) -> extra.set(key, value) } return project } } }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_プロパティの検証">プロパティの検証</h3> <div class="listingblock"> <div class="title">Validation robuste</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `should validate property injection`() { val project = createProjectWithProperty("test-value") // Vérifications multiples assertTrue(project.hasProperty("site_config_path")) assertEquals("test-value", project.property("site_config_path")) assertNotNull(project.properties["site_config_path"]) // Vérification que la propriété est accessible par le plugin project.plugins.apply("jbake.ghpages") // ... reste du test }</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>ユニットテスト環境で設定ファイルを読み込ませるのに苦労する代わりに、ベストプラクティスは必要な状態をシミュレートすることです。使用する`ExtraPropertiesExtension`Gradleのプロパティをプログラムで設定することは、効果的かつ信頼性の高いプラグインのユニットテストを実現するための最もシンプルで堅牢な方法です。</p> </div> <div class="paragraph"> <p>この技術は、外部依存の問題を単純な依存注入に変換し、テスト駆動開発（TDD）の哲学の核となる部分に組み込む。これにより、テスト環境に対する完全な制御が可能になり、品質の高い単体テストに必要な分離を維持しつつ、効果的なテストを実現できる。</p> </div> <div class="paragraph"> <p>本記事に掲載されている図と例は、このアプローチが段階的かつ体系的にどのように実装できるかを示しており、Gradle プラグインのための堅牢で保守性の高いテストスイートを作成することを可能にします。</p> </div> </div> </div> https://cheroliv.com/blog/2025/0079_gradle_tasks_tests_report_post.html Fri, 11 Jul 2025 00:00:00 +0000 blog/2025/0079_gradle_tasks_tests_report_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_centraliser_les_configurations_avec_allprojects_et_subprojects">Centraliser les Configurations avec <code>allprojects</code> et <code>subprojects</code></a></li> <li><a href="#_sourceplantuml">[source,plantuml]</a></li> <li><a href="#_enduml">@enduml</a></li> <li><a href="#_sourcekotlin">[source,kotlin]</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>L’automatisation des tâches de build est cruciale pour tout projet logiciel, et Gradle, avec son DSL Kotlin, offre une flexibilité exceptionnelle. Au cours de notre conversation, nous avons exploré comment centraliser et réutiliser la logique de build, notamment pour les rapports de tests, en tirant parti de <strong>allprojects</strong>, <strong>buildSrc</strong>, et des tâches personnalisées en Kotlin.</p> </div> </div> </div> <div class="sect1"> <h2 id="_centraliser_les_configurations_avec_allprojects_et_subprojects">Centraliser les Configurations avec <code>allprojects</code> et <code>subprojects</code></h2> <div class="sectionbody"> <div class="paragraph"> <p>Les blocs <code>allprojects</code> et <code>subprojects</code> dans votre <code>build.gradle.kts</code> racine sont fondamentaux pour appliquer des configurations communes à travers votre projet multi-modules.</p> </div> <div class="ulist"> <ul> <li> <p><code>allprojects { …​ }</code>: Applique la configuration au <strong>projet racine et à tous ses sous-projets</strong>. Idéal pour définir un <code>group</code>, une <code>version</code>, ou des <code>repositories</code> communs. * <code>subprojects { …​ }</code>: Applique la configuration <strong>uniquement aux sous-projets</strong>, excluant le projet racine. Parfait pour appliquer des plugins spécifiques aux modules (comme <code>java</code> ou <code>kotlin-jvm</code>) ou des dépendances communes à vos bibliothèques.</p> </li> </ul> </div> <div class="paragraph"> <p>Voici un exemple illustratif :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// build.gradle.kts (projet racine) plugins { base // Appliqué au projet racine } allprojects { group = "com.example" version = "1.0.0" repositories { mavenCentral() } tasks.withType<org.gradle.api.tasks.testing.Test> { useJUnitPlatform() // Configuration commune des tests pour tous les projets } } subprojects { apply(plugin = "java") apply(plugin = "org.jetbrains.kotlin.jvm") dependencies { implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk8") } }</code></pre> </div> </div> <div class="paragraph"> <p>\== <code>buildSrc</code>: Le Couteau Suisse de la Logique de Build</p> </div> <div class="paragraph"> <p>Lorsque la logique de vos tâches devient complexe ou doit être réutilisée, <strong>buildSrc</strong> est la solution privilégiée. C’est un module Gradle spécial qui est compilé avant les scripts de build principaux, rendant ses classes disponibles sur le classpath de l’ensemble de votre build.</p> </div> <div class="paragraph"> <p>\=== Pourquoi utiliser <code>buildSrc</code> pour les Tâches ?</p> </div> <div class="ulist"> <ul> <li> <p><strong>Réutilisabilité</strong>: Une tâche définie dans <code>buildSrc</code> peut être appliquée à n’importe quel projet du build.</p> </li> <li> <p><strong>Organisation</strong>: Centralise le code de build, le rendant plus propre et maintenable.</p> </li> <li> <p><strong>Type Safety et Autocomplétion</strong>: Le code Kotlin dans <code>buildSrc</code> est compilé, offrant la vérification des erreurs et l’autocomplétion de votre IDE, améliorant l’expérience de développement.</p> </li> </ul> </div> <div class="paragraph"> <p>\=== Diagramme de Flux <code>buildSrc</code> (Code PlantUML)</p> </div> <div class="paragraph"> <p>Pour générer ce diagramme, copiez le code ci-dessous et collez-le dans un outil supportant PlantUML.</p> </div> </div> </div> <div class="sect1"> <h2 id="_sourceplantuml">[source,plantuml]</h2> <div class="sectionbody"> <div class="paragraph"> <p>@startuml skinparam handwritten true skinparam monochrome true</p> </div> <div class="paragraph"> <p>rectangle "Gradle Build Process" { component "buildSrc" as BS { file "MyCustomTask.kt" as T file "MyConventionPlugin.kt" as P } component "Root Project" as RP component "Subproject A" as SA component "Subproject B" as SB }</p> </div> <div class="paragraph"> <p>T --\> P : "is defined in" P --\> RP : "is applied to" P --\> SA : "is applied to" P --\> SB : "is applied to"</p> </div> <div class="paragraph"> <p>RP --|\> SA : "contains" RP --|\> SB : "contains"</p> </div> <div class="paragraph"> <p>RP -up-\> BS : "depends on (for build logic)" SA -up-\> BS : "depends on (for build logic)" SB -up-\> BS : "depends on (for build logic)"</p> </div> <div class="paragraph"> <p>note right of T Classes de tâches personnalisées (ex: OpenTestReportTask) end note</p> </div> <div class="paragraph"> <p>note right of P Plugins de convention qui enregistrent les tâches end note</p> </div> </div> </div> <div class="sect1"> <h2 id="_enduml">@enduml</h2> <div class="sectionbody"> <div class="paragraph"> <p>\== Création de Tâches de Rapport Abstraites</p> </div> <div class="paragraph"> <p>Pour gérer les rapports de tests, nous avons conçu une approche modulaire en utilisant une classe de tâche abstraite dans <code>buildSrc</code>. Selon vos besoins, cette classe peut hériter de <code>DefaultTask</code> ou de <code>Exec</code>.</p> </div> <div class="paragraph"> <p>\=== Tâche Abstraite <code>OpenTestReportTask</code> (héritant de <code>DefaultTask</code>)</p> </div> <div class="paragraph"> <p>Cette approche est recommandée si vous avez besoin d’une logique Kotlin personnalisée qui interagit avec le système de fichiers ou d’autres APIs Gradle, puis lance une commande externe.</p> </div> </div> </div> <div class="sect1"> <h2 id="_sourcekotlin">[source,kotlin]</h2> <div class="sectionbody"> <div class="paragraph"> <p>package com.yourpackage</p> </div> <div class="paragraph"> <p>import org.gradle.api.DefaultTask import org.gradle.api.tasks.Input import org.gradle.api.tasks.TaskAction import java.io.File</p> </div> <div class="paragraph"> <p>abstract class OpenTestReportTask : DefaultTask() {</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">---- ---- init { group = "verification" description = "Opens a test report in Firefox." dependsOn("check") // Assure que les rapports sont générés } @get:Input abstract var reportPath: String @TaskAction fun openReport() { val separator = File.separator val reportFile = project.layout.projectDirectory.asFile.toPath() .resolve(reportPath.replace("/", separator)) .toAbsolutePath() .toFile() if (!reportFile.exists()) { logger.warn("Report file does not exist: $reportFile. Ensure 'check' ran.") return } project.exec { commandLine("firefox", "--new-tab", reportFile.absolutePath) } logger.lifecycle("Opened test report: ${reportFile.absolutePath}") } ---- ## } \=== Implémentations Concrètes Ces classes héritent de la tâche abstraite et définissent le chemin spécifique du rapport. ## [source,kotlin] package com.yourpackage abstract class ReportUnitTestsTask : OpenTestReportTask() { init { description = "Opens the unit test report in Firefox." reportPath = "build/reports/tests/test/index.html" } } package com.yourpackage ## abstract class ReportFunctionalTestsTask : OpenTestReportTask() { init { description = "Opens the functional test report in Firefox." reportPath = "build/reports/tests/functionalTest/index.html" } } \=== Enregistrement des Tâches Dans le `build.gradle.kts` de votre projet racine : ## [source,kotlin] ## tasks.register\<com.yourpackage.ReportUnitTestsTask\>("reportTests") {} tasks.register\<com.yourpackage.ReportFunctionalTestsTask\>("reportFunctionalTests") {} \=== Diagramme UML des Tâches de Rapport (Code PlantUML) Copiez le code ci-dessous et collez-le dans un outil supportant PlantUML. ## [source,plantuml] @startuml skinparam handwritten true skinparam monochrome true abstract class DefaultTask { } abstract class Exec { \+ commandLine(args: String...) \+ exec() } abstract class OpenTestReportTask extends DefaultTask { \+ group: String = "verification" \+ description: String \+ dependsOn("check") \+ abstract reportPath: String \+ openReport() : void } abstract class AbstractJbakeExecTask extends Exec { \+ group: String = "verification" \+ description: String \+ dependsOn("check") \+ abstract reportRelativePath: String \+ exec() : void } class ReportUnitTestsTask extends OpenTestReportTask { \+ reportPath: String = "build/reports/tests/test/index.html" } class ReportFunctionalTestsTask extends OpenTestReportTask { \+ reportPath: String = "build/reports/tests/functionalTest/index.html" } class ReportJbakeTestsTask extends AbstractJbakeExecTask { \+ reportRelativePath: String = "build/reports/tests/test/index.html" } class ReportJbakeFunctionalTestsTask extends AbstractJbakeExecTask { \+ reportRelativePath: String = "build/reports/tests/functionalTest/index.html" } OpenTestReportTask \<-- ReportUnitTestsTask OpenTestReportTask \<-- ReportFunctionalTestsTask AbstractJbakeExecTask \<-- ReportJbakeTestsTask AbstractJbakeExecTask \<-- ReportJbakeFunctionalTestsTask DefaultTask \<|-- OpenTestReportTask Exec \<|-- AbstractJbakeExecTask DefaultTask \<|-- Exec ## @enduml \== Tâche Abstraite `AbstractJbakeExecTask` (héritant de `Exec`) Si votre tâche se résume principalement à exécuter une commande externe avec des arguments variables, hériter directement de **Exec** est plus direct. ## [source,kotlin] package com.yourpackage import org.gradle.api.tasks.Exec import org.gradle.api.tasks.Input import java.io.File abstract class AbstractJbakeExecTask : Exec() { ---- init { group = "verification" description = "Opens a Jbake project report in Firefox." dependsOn("check") } @get:Input abstract var reportRelativePath: String override fun exec() { val separator = File.separator val reportFile = project.layout.projectDirectory.asFile.toPath() .resolve(reportRelativePath.replace("/", separator)) .toAbsolutePath() .toFile() if (!reportFile.exists()) { logger.warn("Report file does not exist: $reportFile. Ensure 'check' ran.") return } commandLine("firefox", "--new-tab", reportFile.absolutePath) logger.lifecycle("Attempting to open report: ${reportFile.absolutePath}") super.exec() // Appelle la méthode exec() de la super-classe Exec } ## } \=== Implémentations Concrètes pour `Exec` ## [source,kotlin] package com.yourpackage abstract class ReportJbakeTestsTask : AbstractJbakeExecTask() { init { description = "Opens the Jbake unit test report in Firefox." reportRelativePath = "build/reports/tests/test/index.html" } } package com.yourpackage ## abstract class ReportJbakeFunctionalTestsTask : AbstractJbakeExecTask() { init { description = "Opens the functional test report in Firefox." reportRelativePath = "build/reports/tests/functionalTest/index.html" } } \== Visibilité des Tâches `buildSrc` Les tâches et classes que vous définissez dans **buildSrc** sont : * **Visibles et utilisables** par tous les projets de votre build principal (racine et sous-projets). C'est pourquoi vous pouvez utiliser `com.yourpackage.ReportUnitTestsTask` dans `allprojects { ... }`. * **Non exécutables** directement en tant que tâches de buildSrc (par exemple, `gradle :buildSrc:reportTests` ne fonctionnerait pas si la tâche n'est pas enregistrée spécifiquement dans `buildSrc/build.gradle.kts`). `buildSrc` est un module de compilation, pas un module d'application exécutable pour ces tâches du build principal. \=== Exécuter un rapport pour les tests de `buildSrc` lui-même Si `buildSrc` a ses propres tests et génère des rapports, vous pouvez enregistrer une tâche de rapport directement dans `buildSrc/build.gradle.kts` : ## [source,kotlin] plugins { `kotlin-jvm` } repositories { mavenCentral() } tasks.withType\<Test\> { useJUnitPlatform() reports.html.outputLocation.set(layout.buildDirectory.dir("reports/tests")) } import com.yourpackage.ReportJbakeTestsTask // Importez votre classe de tâche ## tasks.register\<ReportJbakeTestsTask\>("reportBuildSrcTests") { // Le chemin est déjà défini dans la classe, il pointera vers les rapports de buildSrc } Vous pourrez ensuite exécuter : `./gradlew :buildSrc:test` suivi de `./gradlew :buildSrc:reportBuildSrcTests`. En adoptant ces pratiques, vous construirez des systèmes de build Gradle en Kotlin DSL qui sont non seulement puissants, mais aussi incroyablement modulaires, maintenables et faciles à comprendre.</code></pre> </div> </div> </div> </div> https://cheroliv.com/blog/2025/0078_jbake_gradle_plugin_syntaxe_post.html Wed, 9 Jul 2025 00:00:00 +0000 blog/2025/0078_jbake_gradle_plugin_syntaxe_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_目的">目的</a></li> <li><a href="#_宣言的設定">宣言的設定</a></li> <li><a href="#_プラグインのアーキテクチャ">プラグインのアーキテクチャ</a></li> <li><a href="#_dsl拡張の定義">DSL拡張の定義</a></li> <li><a href="#_カスタムタスクの定義">カスタムタスクの定義</a></li> <li><a href="#_gitadapterインターフェイス">GitAdapterインターフェイス</a></li> <li><a href="#_jgitを使った具体的な実装">JGitを使った具体的な実装</a></li> <li><a href="#_設定_dsl_kotlin">設定 DSL Kotlin</a></li> <li><a href="#_mockitoを使った単体テスト">Mockitoを使った単体テスト</a> <ul class="sectlevel2"> <li><a href="#_依存関係">依存関係</a></li> <li><a href="#_gitの動作テスト">Gitの動作テスト</a></li> </ul> </li> <li><a href="#_結論">結論</a></li> <li><a href="#_次のステップ">次のステップ</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>この記事は、Kotlin DSLで書かれたGradleプラグインの設計とテスト（TDD）の全体的なアプローチを紹介します。このプラグインは、*JBake*を使った静的サイトの生成と、*JGit*を介した*Gitデプロイ*を、YAML設定ファイルから自動化します。</p> </div> </div> </div> <div class="sect1"> <h2 id="_目的">目的</h2> <div class="sectionbody"> <div class="paragraph"> <p>Gradle プラグインを作成 :</p> </div> <div class="ulist"> <ul> <li> <p>Kotlin DSL で設定可能な ;</p> </li> <li> <p>できる :</p> </li> <li> <p>JBake から静的サイトを生成する ;</p> </li> <li> <p>JGit を使ってリモートの Git リポジトリにデプロイする ;</p> </li> <li> <p>CI/CDワークフローに組み込める ;</p> </li> <li> <p>TDDのアプローチに従ってテスト済みです。</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_宣言的設定">宣言的設定</h2> <div class="sectionbody"> <div class="paragraph"> <p>以下は、私たちのDSLでモデリングされるYAML設定の例：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">bake: srcPath: "./site/jbake" destDirPath: "bake" pushPage: from: "bake" to: "cvs" repo: name: "trainings" repository: "https://github.com/pages-content/trainings.git" credentials: username: "USERNAME" password: "SECRET_TOKEN" branch: "main" message: "cheroliv.com"</code></pre> </div> </div> <div class="paragraph"> <p>この構成は、Kotlin DSL で宣言可能な Gradle 拡張機能を介して表現されます。</p> </div> </div> </div> <div class="sect1"> <h2 id="_プラグインのアーキテクチャ">プラグインのアーキテクチャ</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>@startuml package "エンジンプラグイン" { class WorkspaceEngineExtension class GenerateSiteTask interface GitAdapter class JGitAdapter WorkspaceEnginePlugin --> WorkspaceEngineExtension WorkspaceEnginePlugin --> GenerateSiteTask GenerateSiteTask --> GitAdapter JGitAdapter ..|> GitAdapter } @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_dsl拡張の定義">DSL拡張の定義</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">open class WorkspaceEngineExtension { var outputDir: String = "build/site" var template: String = "freemarker" var repoUrl: String = "" var branch: String = "main" var message: String = "Generated by engine" }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_カスタムタスクの定義">カスタムタスクの定義</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">abstract class GenerateSiteTask : DefaultTask() { lateinit var gitAdapter: GitAdapter @get:Input abstract val repoUrl: Property<String> @get:InputDirectory abstract val outputDir: DirectoryProperty @get:Input abstract val branch: Property<String> @get:Input abstract val message: Property<String> @TaskAction fun run() { val repo = gitAdapter.cloneRepository(repoUrl.get(), outputDir.get().asFile) gitAdapter.commitAndPush(repo, branch.get(), message.get()) } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_gitadapterインターフェイス">GitAdapterインターフェイス</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">interface GitAdapter { fun cloneRepository(uri: String, directory: File): Repository fun commitAndPush(repo: Repository, branch: String, message: String) }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_jgitを使った具体的な実装">JGitを使った具体的な実装</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class JGitAdapter : GitAdapter { override fun cloneRepository(uri: String, directory: File): Repository { return Git.cloneRepository() .setURI(uri) .setDirectory(directory) .call() .repository } override fun commitAndPush(repo: Repository, branch: String, message: String) { Git(repo).use { it.add().addFilepattern(".").call() it.commit().setMessage(message).call() it.push().call() } } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_設定_dsl_kotlin">設定 DSL Kotlin</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">workspaceEngine { outputDir = "build/out" template = "freemarker" repoUrl = "https://github.com/cheroliv/trainings.git" branch = "main" message = "deploy from plugin" }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_mockitoを使った単体テスト">Mockitoを使った単体テスト</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_依存関係">依存関係</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">testImplementation("org.mockito:mockito-core:5.12.0") testImplementation("org.mockito.kotlin:mockito-kotlin:5.2.1") testImplementation("org.junit.jupiter:junit-jupiter:5.10.0")</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_gitの動作テスト">Gitの動作テスト</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class GenerateSiteTaskMockitoTest { @TempDir lateinit var tempDir: File @Test fun `task should call clone and commitAndPush`() { val project = ProjectBuilder.builder().build() val task = project.tasks.create("generateSite", GenerateSiteTask::class.java) val mockGitAdapter = mock<GitAdapter>() val mockRepo = mock<Repository>() whenever(mockGitAdapter.cloneRepository(any(), any())).thenReturn(mockRepo) task.gitAdapter = mockGitAdapter task.repoUrl.set("https://github.com/cheroliv/test.git") task.outputDir.set(project.layout.projectDirectory.dir(tempDir.name)) task.branch.set("main") task.message.set("test commit") task.run() verify(mockGitAdapter).cloneRepository(eq("https://github.com/cheroliv/test.git"), any()) verify(mockGitAdapter).commitAndPush(eq(mockRepo), eq("main"), eq("test commit")) } }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre>@startuml actor "開発者" as Dev participant "Gradle ProjectBuilder" as Project participant "GenerateSiteTask" as Task participant "Gitアダプター (モック)" as Adapter participant "JGitAdapter / Mockito" as Impl Dev -> Project : construit projet Gradle Dev -> Task : configure les propriétés Task -> Adapter : cloneRepository() Adapter -> Impl : simulé par Mockito Task -> Adapter : commitAndPush() @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>�責任の分離を通じて`GitAdapter`Gradle プラグインの開発において TDD を十分に適用できるようになる:</p> </div> <div class="ulist"> <ul> <li> <p>Gitの呼び出しは抽象的でテスト可能で、</p> </li> <li> <p>DSLの設定はきれいでわかりやすい。</p> </li> <li> <p>プラグインは実際の実装に依存しません。</p> </li> </ul> </div> <div class="paragraph"> <p>このアプローチは高いテスト容易性とGitHub API、GitLabなどへの拡張性を保証します。</p> </div> </div> </div> <div class="sect1"> <h2 id="_次のステップ">次のステップ</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>JBakeの生成を作为统合する`BakeAdapter`</p> </li> <li> <p>統合テストを追加して`GradleRunner`</p> </li> <li> <p>ファイルの自動読み込みをサポート`site.yml`SnakeYAML経由で</p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2025/0077_asciidoc_syntaxe_post.html Fri, 20 Jun 2025 00:00:00 +0000 blog/2025/0077_asciidoc_syntaxe_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_はじめに">はじめに</a></li> <li><a href="#_asciidoc_とは何ですか">AsciiDoc とは何ですか？</a> <ul class="sectlevel2"> <li><a href="#_なぜasciidocを選ぶのですか">なぜAsciiDocを選ぶのですか？</a></li> </ul> </li> <li><a href="#_ユースケース図_use_case">ユースケース図 (Use Case)</a></li> <li><a href="#_マインドマップ図">マインドマップ図</a></li> <li><a href="#_フローダイアグラム_フロー">フローダイアグラム (フロー)</a></li> <li><a href="#_asciidocファイルの基本構造">AsciiDocファイルの基本構造</a></li> <li><a href="#_基本構文">基本構文</a> <ul class="sectlevel2"> <li><a href="#_見出しとセクション">見出しとセクション</a></li> <li><a href="#_太字斜体等幅フォントのテキスト">太字、斜体、等幅フォントのテキスト</a></li> <li><a href="#_箇条書きリストと番号付きリスト">�箇条書きリストと番号付きリスト</a></li> <li><a href="#_リンクと画像">リンクと画像</a></li> <li><a href="#_コードブロック">コードブロック</a></li> <li><a href="#_絵画">絵画</a></li> <li><a href="#_ノートと警告">ノートと警告</a></li> </ul> </li> <li><a href="#_属性および変数の使用">属性および変数の使用</a></li> <li><a href="#_一般的なユースケース">一般的なユースケース</a></li> <li><a href="#_ベストプラクティス">ベストプラクティス</a></li> <li><a href="#_結論">結論</a></li> <li><a href="#_さらに進むために">さらに進むために</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>読了時間： 8～12分</p> </div> </div> </div> <div class="sect1"> <h2 id="_はじめに">はじめに</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title"><em>対象読者 :</em> 開発者、技術ライター、および技術文書やリッチな記事を作成したいすべての人。</div> <p>AsciiDocは、構造化された技術文書、記事、本、プレゼンテーションなどを作成するために設計された軽量なマークアップ言語です。可読性、構文の豊かさ、HTML、PDF、DocBookなどさまざまなフォーマットを生成できる能力において際立ちます。この記事では、AsciiDocの基本構文を探り、すぐに使い始められるコツを紹介します。</p> </div> </div> </div> <div class="sect1"> <h2 id="_asciidoc_とは何ですか">AsciiDoc とは何ですか？</h2> <div class="sectionbody"> <div class="paragraph"> <p>AsciiDocはドキュメント記述言語で、Markdownに似ているがより強力です。テキスト、見出し、リスト、表、コードブロックなどを効率的に構造化することができ、さらに多くのことにも対応できます。その汎用性から、オープンソースプロジェクトのドキュメント作成、書籍の執筆、ウェブ出版において人気の選択肢となっています。</p> </div> <div class="sect2"> <h3 id="_なぜasciidocを選ぶのですか">なぜAsciiDocを選ぶのですか？</h3> <div class="olist arabic"> <ol class="arabic"> <li> <p>読みやすく直感的な構文。</p> </li> <li> <p>複雑な構造のネイティブサポート（表、注釈、警告など）。</p> </li> <li> <p>マルチフォーマット生成（HTML, PDF, ePub, DocBook…。）</p> </li> <li> <p>JBake や Antora などの静的サイトジェネレーターとの簡単な統合</p> </li> <li> <p>属性および拡張機能を使用した高度なカスタマイズ</p> </li> </ol> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ユースケース図_use_case">ユースケース図 (Use Case)</h2> <div class="sectionbody"> <div class="paragraph"> <p>ユースケース図は、ユーザーとシステム間の主な相互作用を示すことができます。ドキュメントシステムの単純な例を以下に示します：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml :Utilisateur: --> (Rédiger documentation) :Utilisateur: --> (Générer PDF) :Utilisateur: --> (Publier sur site web) (Rédiger documentation) ..> (Générer PDF) : inclut @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_マインドマップ図">マインドマップ図</h2> <div class="sectionbody"> <div class="paragraph"> <p>マインドマップ（メンタルマップ）は、AsciiDocに関連する概念とそれらの関係を探求するのに最適です：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startmindmap * AsciiDoc ** Syntaxe *** Titres *** Listes *** Blocs de code *** Tableaux ** Extensions *** PlantUML *** MathJax ** Export *** HTML *** PDF *** EPUB @endmindmap</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_フローダイアグラム_フロー">フローダイアグラム (フロー)</h2> <div class="sectionbody"> <div class="paragraph"> <p>フローダイアグラムは、AsciiDoc文書の生成プロセスを説明することができます：</p> </div> <div class="listingblock"> <div class="content"> <pre>@startuml start :Écrire fichier .adoc; :Ajouter images et diagrammes; if (Valider la syntaxe ?) then (oui) :Générer HTML/PDF; :Publier ou partager; else (non) :Corriger erreurs; :back to start; endif stop @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_asciidocファイルの基本構造">AsciiDocファイルの基本構造</h2> <div class="sectionbody"> <div class="paragraph"> <p>AsciiDocファイルは通常、タイトル、オプションの属性、構造化されたコンテンツの順で始まります。以下は最小限の例：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">= Titre Principal Auteur 2024-09-03 :toc: :icons: font Votre contenu commence ici...</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_基本構文">基本構文</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_見出しとセクション">見出しとセクション</h3> <div class="paragraph"> <p>AsciiDocは複数の見出しレベルをサポートします：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">= Titre de niveau 1 == Titre de niveau 2 === Titre de niveau 3 ==== Titre de niveau 4</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_太字斜体等幅フォントのテキスト">太字、斜体、等幅フォントのテキスト</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">*gras* _italique_ `monospace`</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_箇条書きリストと番号付きリスト">�箇条書きリストと番号付きリスト</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* Élément 1 * Élément 2 . Premier . Deuxième . Troisième</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_リンクと画像">リンクと画像</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">Lien standard : https://asciidoc.org[AsciiDoc] Image : image::images/logo.png[AsciiDoc Logo]</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_コードブロック">コードブロック</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">[source,python]</code></pre> </div> </div> <div class="paragraph"> <p>def hello(): print("こんにちは AsciiDoc !")</p> </div> </div> <div class="sect2"> <h3 id="_絵画">絵画</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">|=== | Colonne 1 | Colonne 2 | Valeur A | Valeur B | Valeur C | Valeur D |===</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ノートと警告">ノートと警告</h3> <div class="paragraph"> <p>AsciiDocは視覚情報ブロックを提供します：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">NOTE: Ceci est une note importante. TIP: Conseil utile pour l’utilisateur. WARNING: Attention à ce point.</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_属性および変数の使用">属性および変数の使用</h2> <div class="sectionbody"> <div class="paragraph"> <p>カスタム属性により、値を再利用したり動作を設定したりすることができます :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">:project-name: AsciiDoc Explorer Le projet s’appelle {project-name}.</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_一般的なユースケース">一般的なユースケース</h2> <div class="sectionbody"> <div class="paragraph"> <p>オープンソースプロジェクトのドキュメント (README、技術ガイド) - 書籍および電子書籍の執筆 - 静的Webサイトの自動生成（JBake、Antora） - 技術プレゼンテーション</p> </div> </div> </div> <div class="sect1"> <h2 id="_ベストプラクティス">ベストプラクティス</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>一貫した見出しと自動目次 (:toc:) を使用してください。 - アドモニションを使用して、重要なポイントに注意を引いてください。 ファイルを構造化してメンテナンスを容易にします。 - 注釈付きコードブロックを活用して、例を示してください。</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>AsciiDocは、技術ドキュメントや構造化された記事を作成するための強力で使いやすいツールです。豊富な構文とマルチフォーマット生成を組み合わせることで、要求の厳しい開発者や執筆者にとって理想的な味方となります。次のプロジェクトでAsciiDocを試してみて、その違いを体感してください！</p> </div> </div> </div> <div class="sect1"> <h2 id="_さらに進むために">さらに進むために</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>公式ドキュメント : <a href="https://asciidoc.org" class="bare">https://asciidoc.org</a> - Asciidoctor : <a href="https://asciidoctor.org" class="bare">https://asciidoctor.org</a> - JBake と AsciiDoc: <a href="https://jbake.org/docs/2.6.4/#asciidoc_support" class="bare">https://jbake.org/docs/2.6.4/#asciidoc_support</a></p> </li> </ul> </div> <div class="paragraph"> <p>経験とコツをコメントで共有してください！</p> </div> </div> </div> https://cheroliv.com/blog/2025/0076_port_forwarding_post.html Wed, 28 May 2025 00:00:00 +0000 blog/2025/0076_port_forwarding_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_問題natとプライベートアドレス">問題：NATとプライベートアドレス</a></li> <li><a href="#_ステップ_1_あなたのパブリック_ip_アドレスを特定する">ステップ 1: あなたのパブリック IP アドレスを特定する</a></li> <li><a href="#_ステップ2ubuntuマシンのローカルipアドレスを確認する">ステップ2：UbuntuマシンのローカルIPアドレスを確認する</a></li> <li><a href="#_ステップ3_ルーターでポートフォワーディングを設定する">ステップ3: ルーターでポートフォワーディングを設定する</a> <ul class="sectlevel2"> <li><a href="#_管理インターフェースへのアクセス">管理インターフェースへのアクセス</a></li> <li><a href="#_リダイレクトの設定">リダイレクトの設定</a></li> </ul> </li> <li><a href="#_ステップ_4_ubuntu_上のサービスの設定">ステップ 4 ：Ubuntu 上のサービスの設定</a></li> <li><a href="#_ステップ_5_ubuntuファイアウォールの設定">ステップ 5 : Ubuntuファイアウォールの設定</a></li> <li><a href="#_ステップ_6_テストと検証">ステップ 6 : テストと検証</a> <ul class="sectlevel2"> <li><a href="#_ローカルネットワークからのテスト">ローカルネットワークからのテスト</a></li> <li><a href="#_外部からのテスト">外部からのテスト</a></li> </ul> </li> <li><a href="#_ベストプラクティスとセキュリティ">ベストプラクティスとセキュリティ</a> <ul class="sectlevel2"> <li><a href="#_基本的なセキュリティ">基本的なセキュリティ</a></li> <li><a href="#_接続の監視">接続の監視</a></li> <li><a href="#_リバースプロキシの使用">リバースプロキシの使用</a></li> </ul> </li> <li><a href="#_ポートフォワーディングの代替案">ポートフォワーディングの代替案</a> <ul class="sectlevel2"> <li><a href="#_クラウドソリューション">クラウドソリューション</a></li> <li><a href="#_vpsとリバースプロキシ">VPSとリバースプロキシ</a></li> </ul> </li> <li><a href="#_トラブルシューティング">トラブルシューティング</a> <ul class="sectlevel2"> <li><a href="#_よくある問題">よくある問題</a></li> <li><a href="#_ネットワークデバッグ">ネットワークデバッグ</a></li> </ul> </li> <li><a href="#_結論">結論</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="ulist"> <div class="title">対象者 : 中級</div> <ul> <li> <p><strong>想定される前提条件</strong> : Ubuntuの基本知識、ターミナル、基本的なネットワーク概念</p> </li> <li> <p><strong>技術的な概念</strong> : NAT, ポートフォワーディング, ファイアウォール, リバースプロキシ</p> </li> <li> <p><strong>システムコマンド</strong> : ターミナルの使用、ネットワーク構成</p> </li> <li> <p><strong>高度なセクション</strong> : モニタリング, セキュリティ, クラウドの代替案</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_問題natとプライベートアドレス">問題：NATとプライベートアドレス</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">問題 : Ubuntu マシンでウェブアプリケーションを開発していて、自宅ネットワークの外部からアクセスできるようにしたいですか？ ここがまさにぴったりの場所です！ この記事では、インターネットボックスのポートフォワーディングを設定して、ローカルサービス（例えばポート 8080）をインターネットに公開する方法を見ていきます。</div> <p>デフォルトでは、お使いのインターネットボックスは NAT（Network Address Translation）を使用して、ご家庭内ネットワークのすべてのデバイス間で1つのパブリック IP アドレスを共有します。お使いのローカルマシンは、インターネット上ではルーティングできないプライベート IP アドレス（192.168.x.x、10.x.x.x など）を使用します。</p> </div> <div class="paragraph"> <p>Ubuntu マシンでサービスを起動すると（たとえばポート 8080 のウェブサーバーなど）、それはローカルネットワークからしかアクセスできません。インターネットからアクセスできるようにするには、ポートフォワーディングを設定する必要があります。</p> </div> </div> </div> <div class="sect1"> <h2 id="_ステップ_1_あなたのパブリック_ip_アドレスを特定する">ステップ 1: あなたのパブリック IP アドレスを特定する</h2> <div class="sectionbody"> <div class="paragraph"> <p>まず、インターネット接続のパブリックIPアドレスを取得しましょう：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Plusieurs méthodes au choix curl ifconfig.me curl ipecho.net/plain wget -qO- http://ipecho.net/plain # Ou encore curl -s checkip.amazonaws.com</code></pre> </div> </div> <div class="paragraph"> <p>このIPアドレスは、インターネットユーザーがあなたのサービスにアクセスするために使用するものです。</p> </div> </div> </div> <div class="sect1"> <h2 id="_ステップ2ubuntuマシンのローカルipアドレスを確認する">ステップ2：UbuntuマシンのローカルIPアドレスを確認する</h2> <div class="sectionbody"> <div class="paragraph"> <p>Ubuntuマシンはローカルネットワーク上のプライベートIPアドレスを持っています。確認するには：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Afficher toutes les interfaces réseau ip addr show # Ou plus spécifiquement pour l'interface principale ip route get 1.1.1.1 | awk '{print $7; exit}' # Alternative avec hostname hostname -I | awk '{print $1}'</code></pre> </div> </div> <div class="paragraph"> <p>このアドレスをメモしてください（例えば`192.168.1.100`), 設定のためにそれが必要になります。</p> </div> </div> </div> <div class="sect1"> <h2 id="_ステップ3_ルーターでポートフォワーディングを設定する">ステップ3: ルーターでポートフォワーディングを設定する</h2> <div class="sectionbody"> <div class="paragraph"> <p>構成はお使いのボックスのモデルによって異なりますが、原理は同じです：</p> </div> <div class="sect2"> <h3 id="_管理インターフェースへのアクセス">管理インターフェースへのアクセス</h3> <div class="paragraph"> <p>ブラウザを開き、ボックスのウェブインターフェイスにアクセスしてください：</p> </div> <div class="ulist"> <ul> <li> <p><strong>フリーボックス</strong></think>`192.168.1.1` ou <code>mafreebox.freebox.fr</code></p> </li> <li> <p><strong>Livebox Orange</strong>:`192.168.1.1`</p> </li> <li> <p><strong>SFRボックス</strong></think>`192.168.1.1`</p> </li> <li> <p><strong>Bbox Bouygues</strong> : <code>192.168.1.254</code></p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_リダイレクトの設定">リダイレクトの設定</h3> <div class="paragraph"> <p>ポートフォワーディング専用のセクションを探してください（名前は変わります）:</p> </div> <div class="ulist"> <ul> <li> <p>ポート転送</p> </li> <li> <p>NAT/PAT</p> </li> <li> <p>ポートフォワーディング</p> </li> <li> <p>ゲームサーバー</p> </li> </ul> </div> <div class="paragraph"> <p>これらの設定で新しいルールを作成：</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 25%;"> <col style="width: 75%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">フィールド</th> <th class="tableblock halign-left valign-top">値</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">名前/説明</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ubuntuウェブサービス"（または他の明示的な名前）</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">外部ポート(またはパブリックポート)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">8080</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">内部IPアドレス</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">UbuntuマシンのIPアドレス (例: 192.168.1.100)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">内部ポート (または プライベートポート)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">8080</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">プロトコル</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">TCP</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">状態</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">有効</p></td> </tr> </tbody> </table> </div> </div> </div> <div class="sect1"> <h2 id="_ステップ_4_ubuntu_上のサービスの設定">ステップ 4 ：Ubuntu 上のサービスの設定</h2> <div class="sectionbody"> <div class="paragraph"> <p>サービスが localhost だけではなく、すべてのインターフェイスでリッスンしていることを確認してください:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># ✅ Correct : écoute sur toutes les interfaces python3 -m http.server 8080 --bind 0.0.0.0 # ❌ Incorrect : écoute seulement en local python3 -m http.server 8080 --bind 127.0.0.1</code></pre> </div> </div> <div class="paragraph"> <p>サービスが正しくリスンしていることを確認する：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Vérifier les ports en écoute sudo netstat -tlnp | grep :8080 # ou avec ss (plus moderne) sudo ss -tlnp | grep :8080</code></pre> </div> </div> <div class="paragraph"> <p>何かのように見えるはずです`0.0.0.0:8080`そして いいえ`127.0.0.1:8080`。</p> </div> </div> </div> <div class="sect1"> <h2 id="_ステップ_5_ubuntuファイアウォールの設定">ステップ 5 : Ubuntuファイアウォールの設定</h2> <div class="sectionbody"> <div class="paragraph"> <p>UbuntuはデフォルトでUFW（Uncomplicated Firewall）を使用します。必要に応じて、その状態を確認し、ポートを許可してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Vérifier le statut du pare-feu sudo ufw status # Si le pare-feu est actif, autoriser le port 8080 sudo ufw allow 8080/tcp # Ou plus spécifiquement pour un service web sudo ufw allow 'Apache' # si vous utilisez Apache sudo ufw allow 'Nginx Full' # si vous utilisez Nginx</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ステップ_6_テストと検証">ステップ 6 : テストと検証</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_ローカルネットワークからのテスト">ローカルネットワークからのテスト</h3> <div class="paragraph"> <p>最初に、ローカルネットワークの別のマシンからアクセスをテストしてください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Remplacez par l'IP locale de votre machine Ubuntu curl http://192.168.1.100:8080</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_外部からのテスト">外部からのテスト</h3> <div class="paragraph"> <p>今、インターネットから公開 IP アドレスを使用してテストしてください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Remplacez par votre IP publique curl http://VOTRE_IP_PUBLIQUE:8080</code></pre> </div> </div> <div class="paragraph"> <p>また、オンラインツールを使用することもできます：</p> </div> <div class="ulist"> <ul> <li> <p><a href="https://www.yougetsignal.com/tools/open-ports/" class="bare">https://www.yougetsignal.com/tools/open-ports/</a></p> </li> <li> <p><a href="https://canyouseeme.org/" class="bare">https://canyouseeme.org/</a></p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ベストプラクティスとセキュリティ">ベストプラクティスとセキュリティ</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_基本的なセキュリティ">基本的なセキュリティ</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Configurer fail2ban pour protéger contre les attaques par force brute sudo apt update && sudo apt install fail2ban # Limiter l'accès avec UFW (exemple : autoriser seulement certaines IP) sudo ufw allow from 203.0.113.0/24 to any port 8080</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_接続の監視">接続の監視</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Surveiller les connexions en temps réel sudo netstat -an | grep :8080 # Logs des connexions (selon votre application) sudo tail -f /var/log/nginx/access.log # pour Nginx sudo journalctl -f -u your-service # pour un service systemd</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_リバースプロキシの使用">リバースプロキシの使用</h3> <div class="paragraph"> <p>セキュリティと柔軟性を向上させるため、Nginxなどのリバースプロキシの使用を検討してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-nginx hljs" data-lang="nginx">server { listen 80; server_name votre-domaine.com; location / { proxy_pass http://localhost:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } }</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ポートフォワーディングの代替案">ポートフォワーディングの代替案</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_クラウドソリューション">クラウドソリューション</h3> <div class="ulist"> <ul> <li> <p><strong>ngrok</strong>一時的なセキュアトンネル</p> </li> <li> <p><strong>Cloudflareトンネル</strong>: 無料で安全なソリューション</p> </li> <li> <p><strong>serveo.net</strong>: シンプルなSSHトンネル</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Exemple avec ngrok ngrok http 8080 # Exemple avec serveo ssh -R 80:localhost:8080 serveo.net</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_vpsとリバースプロキシ">VPSとリバースプロキシ</h3> <div class="paragraph"> <p>プロフェッショナルな使用の場合、VPN経由でローカルインフラストラクチャへ向けるリバースプロキシを備えたVPSの使用を検討してください。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_トラブルシューティング">トラブルシューティング</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_よくある問題">よくある問題</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 40%;"> <col style="width: 60%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">問題</th> <th class="tableblock halign-left valign-top">解決策</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">外部からアクセスできないサービス</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ポートフォワーディングの設定を確認し、サービスが 0.0.0.0 でリッスンしていることを確認してください。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">接続が拒否されました</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">サービスが起動していないか、127.0.0.1のみでリッスンしています</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">接続タイムアウト</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ファイアウォール（ボックスまたはUbuntu）の問題またはポート転送の設定ミス</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">パブリックIPアドレスは定期的に変更されます</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">動的なDNS（DynDNS、No-IPなど）を設定してください</p></td> </tr> </tbody> </table> </div> <div class="sect2"> <h3 id="_ネットワークデバッグ">ネットワークデバッグ</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Tester la connectivité locale telnet localhost 8080 # Tester depuis une autre machine du réseau telnet 192.168.1.100 8080 # Vérifier les routes réseau ip route show # Analyser le trafic réseau sudo tcpdump -i any port 8080</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>ローカルサービスをインターネットに公開するには、ポートフォワーディング、セキュリティ、監視の注意深い設定が必要です。このアプローチは開発や個人プロジェクトに最適ですが、本番環境ではより堅牢な代替手段（VPS、CDN、クラウドサービス）を検討してください。</p> </div> <div class="paragraph"> <p>重要なことは常に安全を心に留めておくことです：強力なパスワードを使用し、定期的にシステムを更新し、公開されているサービスへのアクセスを監視してください。</p> </div> <div class="paragraph"> <p>お気軽に、コメントでご経験やご質問を共有してください！</p> </div> </div> </div> https://cheroliv.com/blog/2025/0099_debugging-mockito-gradle-plugin_post.html Sun, 17 Nov 2024 00:00:00 +0000 blog/2025/0099_debugging-mockito-gradle-plugin_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_導入">導入</a></li> <li><a href="#_コンテキスト_gradle_bakery_プラグイン">コンテキスト : Gradle Bakery プラグイン</a></li> <li><a href="#_問題_1_悪いモックを確認する">問題 #1 : 悪いモックを確認する</a> <ul class="sectlevel2"> <li><a href="#_診断">�診断</a></li> <li><a href="#_解決策">解決策</a></li> </ul> </li> <li><a href="#_問題_2_カスケードするunfinishedstubbingexception">問題 #2: カスケードするUnfinishedStubbingException</a> <ul class="sectlevel2"> <li><a href="#_診断_2">�診断</a></li> <li><a href="#_解決策_2">解決策</a></li> </ul> </li> <li><a href="#_問題_3_設定ファイルが存在しません">問題 #3 : 設定ファイルが存在しません</a> <ul class="sectlevel2"> <li><a href="#_診断_3">診断</a></li> <li><a href="#_解決策_3">解決策</a></li> </ul> </li> <li><a href="#_問題_4_afterevaluate_と_nullpointerexception">問題 #4 : afterEvaluate と NullPointerException</a> <ul class="sectlevel2"> <li><a href="#_診断_4">�診断</a></li> <li><a href="#_解決策_4">解決策</a></li> </ul> </li> <li><a href="#_完全なソリューション">完全なソリューション</a></li> <li><a href="#_学んだ教訓">学んだ教訓</a> <ul class="sectlevel2"> <li><a href="#_正しいモックを確認する">正しいモックを確認する</a></li> <li><a href="#_2_ネストされたモックを避ける">2. ネストされたモックを避ける</a></li> <li><a href="#_3_評価のコールバックをモックする">3. 評価のコールバックをモックする</a></li> <li><a href="#_4_パスの解決をテストする">4. パスの解決をテストする</a></li> </ul> </li> <li><a href="#_最終テストアーキテクチャ">最終テストアーキテクチャ</a></li> <li><a href="#_結論">結論</a></li> <li><a href="#_リソース">リソース</a></li> </ul> </div> <div class="sect1"> <h2 id="_導入">導入</h2> <div class="sectionbody"> <div class="paragraph"> <p>Gradleプラグインの開発中に<strong>ベーカリー</strong>JBake ブログのために、見かけ上単純な問題に遭遇しました：エラーで失敗する単体テスト`Wanted but not invoked`. それが単純なバグと思われていたものが、Mockito と Kotlin を使ったモッキングの微妙さを理解するための完璧な教材ケースであることが判明しました。</p> </div> <div class="paragraph"> <p>この記事では、メソッド的なデバッグの旅に皆さんをお連れします。それぞれの解決策が新たな問題を明らかにし、最終的に解決に至ります。</p> </div> </div> </div> <div class="sect1"> <h2 id="_コンテキスト_gradle_bakery_プラグイン">コンテキスト : Gradle Bakery プラグイン</h2> <div class="sectionbody"> <div class="paragraph"> <p>Bakery プラグインは JBake のラッパーであり、静的サイトの公開を容易にします。以下にその簡素化された構造を示します：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class BakeryPlugin : Plugin<Project> { override fun apply(project: Project) { val extension = project.extensions.create( "bakery", BakeryExtension::class.java ) project.afterEvaluate { if (!project.layout.projectDirectory.asFile .resolve(extension.configPath.get()).exists()) { println("config file does not exists") } else { // C'EST ICI QUE ÇA SE PASSE project.plugins.apply(JBakePlugin::class.java) val site = FileSystemManager.from(project, extension.configPath.get()) // Configuration de JBake... } } } }</code></pre> </div> </div> <div class="paragraph"> <p>失敗していたテストはシンプルだった：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `plugin applies jbake gradle plugin`() { val project = createMockProject() val plugin = BakeryPlugin() plugin.apply(project) verify(project.plugins).apply(JBakePlugin::class.java) }</code></pre> </div> </div> <div class="paragraph"> <p>エラー :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">Wanted but not invoked: pluginContainer.apply(class org.jbake.gradle.JBakePlugin); Actually, there were zero interactions with this mock.</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_問題_1_悪いモックを確認する">問題 #1 : 悪いモックを確認する</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_診断">�診断</h3> <div class="listingblock"> <div class="content"> <pre>@startuml actor Test participant "project.plugins" as PP participant "モックプラグインコンテナ" as MPC participant "ベーカリープラグイン" as BP Test -> Test: createMockProject() activate Test Test -> MPC: create mock Test -> PP: doReturn mockPluginContainer Test --> Test: return project deactivate Test Test -> BP: apply(project) activate BP BP -> PP: project.plugins PP --> BP: returns mockPluginContainer BP -> MPC: apply(JBakePlugin::class.java) deactivate BP Test -> PP: verify(project.plugins).apply(...) note right ❌ ÉCHEC ! Mockito vérifie "project.plugins" mais l'interaction a eu lieu sur "モックプラグインコンテナ" end note @enduml</pre> </div> </div> <div class="paragraph"> <p>問題：Mockitoは対話をトレースできません`project.plugins`なぜなら、それは実際のモックを返すだけのゲッターだから`mockPluginContainer`. 検証はモックのインスタンスに対して直接行う必要があります。</p> </div> </div> <div class="sect2"> <h3 id="_解決策">解決策</h3> <div class="paragraph"> <p>変更する`createMockProject()`2つのオブジェクトを返すために</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">private fun createMockProject(): Pair<Project, PluginContainer> { val mockPluginContainer = mock<PluginContainer>() val mockProject = mock<Project> { on { plugins } doReturn mockPluginContainer } return Pair(mockProject, mockPluginContainer) }</code></pre> </div> </div> <div class="paragraph"> <p>テストを適応させる:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `plugin applies jbake gradle plugin`() { val (project, mockPluginContainer) = createMockProject() val plugin = BakeryPlugin() plugin.apply(project) // ✅ Vérification directe sur le bon mock verify(mockPluginContainer).apply(JBakePlugin::class.java) }</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_問題_2_カスケードするunfinishedstubbingexception">問題 #2: カスケードするUnfinishedStubbingException</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_診断_2">�診断</h3> <div class="paragraph"> <p>最初の修正を適用した後、新しいエラーが発生しました：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">UnfinishedStubbingException: Unfinished stubbing detected here Hints: 3. you are stubbing the behaviour of another mock inside before 'thenReturn' instruction is completed</code></pre> </div> </div> <div class="paragraph"> <p>問題のあるコードは、Mockito-Kotlin の DSL 構文を使用していました：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val mockProject = mock<Project> { on { extensions } doReturn mockExtensionContainer on { plugins } doReturn mockPluginContainer on { logger } doReturn mock() // ❌ PROBLÈME ICI ! }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre>@startuml participant "モキト" as M participant "モックビルダー" as MB participant "インライン モック" as IM M -> MB: mock<Project> { ... } activate MB MB -> MB: on { logger } doReturn MB -> IM: mock() activate IM note right ❌ Création d'un nouveau mock PENDANT le stubbing en cours ! Mockito perd le contexte du stubbing parent end note IM --> MB: nouveau mock deactivate IM MB -x M: UnfinishedStubbingException deactivate MB @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_解決策_2">解決策</h3> <div class="paragraph"> <p>作成する<strong>すべて</strong>スタブブロック以外のモックを、それからそれで設定する`whenever()`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">private fun createMockProject(): Pair<Project, PluginContainer> { // 1️⃣ Créer TOUS les mocks d'abord val mockPluginContainer = mock<PluginContainer>() val mockExtensionContainer = mock<ExtensionContainer>() val mockLogger = mock<org.gradle.api.logging.Logger>() val mockProject = mock<Project>() // 2️⃣ Configurer les mocks séparément avec whenever() whenever(mockProject.plugins).thenReturn(mockPluginContainer) whenever(mockProject.extensions).thenReturn(mockExtensionContainer) whenever(mockProject.logger).thenReturn(mockLogger) return Pair(mockProject, mockPluginContainer) }</code></pre> </div> </div> <div class="admonitionblock tip"> <table> <tr> <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> <div class="paragraph"> <p><strong>黄金のルール</strong>: 決して電話をかけないで`mock()`モックの設定ブロックの内部に。 まずモックを作成し、その後で設定してください。</p> </div> </td> </tr> </table> </div> </div> </div> </div> <div class="sect1"> <h2 id="_問題_3_設定ファイルが存在しません">問題 #3 : 設定ファイルが存在しません</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_診断_3">診断</h3> <div class="paragraph"> <p>正しいモックでも、プラグインが設定ファイルを見つけられなかったため、テストは常に失敗しました：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// Dans BakeryPlugin.kt if (!project.layout.projectDirectory.asFile .resolve(extension.configPath.get()).exists()) { println("config file does not exists") return@afterEvaluate // ❌ Sort avant d'appliquer JBake ! }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre>@startuml participant "ベーカリープラグイン" as BP participant "プロジェクトレイアウト" as PL participant "�拡張" as EXT participant "ファイルシステム" as FS BP -> PL: layout.projectDirectory.asFile PL --> BP: /some/mock/path BP -> EXT: extension.configPath.get() EXT --> BP: "../../site.yml" BP -> BP: resolve("../../site.yml") BP -> FS: exists() ? FS --> BP: false ❌ BP -> BP: return (skip JBake) note right Le plugin ne trouve pas le fichier et sort avant d'appliquer JBake end note @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_解決策_3">解決策</h3> <div class="paragraph"> <p>パスの解決が機能するようにモックを設定して：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">private fun createMockProject(): Pair<Project, PluginContainer> { // ... autres mocks ... val configFile = File("../../site.yml").canonicalFile val projectDir = configFile.parentFile // Configuration cohérente des chemins whenever(mockConfigPathProperty.get()).thenReturn("site.yml") whenever(mockProjectDirectory.asFile).thenReturn(projectDir) // Maintenant : projectDir.resolve("site.yml") existe ! ✅ }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre>@startuml !define SUCCESS #90EE90 !define PROBLEM #FFB6C1 rectangle "モック設定" { card "projectDirectory.asFile" SUCCESS card "戻り値: /real/path/to/project" SUCCESS card "configPath.get()" SUCCESS card "戻り値: site.yml" SUCCESS card "解決()" SUCCESS card "/real/path/to/project/site.yml" SUCCESS card "存在する()" SUCCESS card "真 ✅" SUCCESS } @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_問題_4_afterevaluate_と_nullpointerexception">問題 #4 : afterEvaluate と NullPointerException</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_診断_4">�診断</h3> <div class="paragraph"> <p>プラグインはJBakeをブロック内で適用します`afterEvaluate`、アクセスする`buildDirectory.dir()` :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">project.afterEvaluate { // ... project.tasks.withType(JBakeTask::class.java) .getByName("bake").apply { output = project.layout.buildDirectory .dir(site.bake.destDirPath) // ❌ NPE ici ! .get() .asFile } }</code></pre> </div> </div> <div class="paragraph"> <p>モックの`buildDirectory.dir()<code>戻っていた`null</code>.</p> </div> </div> <div class="sect2"> <h3 id="_解決策_4">解決策</h3> <div class="paragraph"> <p>�嘲る`afterEvaluate`すぐに実行されるように、そして完全に設定するために`buildDirectory`：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">private fun createMockProject(): Pair<Project, PluginContainer> { // ... autres mocks ... val mockBuildDirectory = mock<DirectoryProperty>() val buildDir = File(projectDir, "build") // Mocker dir() pour retourner un Provider valide whenever(mockBuildDirectory.dir(any<String>())).doAnswer { invocation -> val path = invocation.arguments[0] as String val mockDirProvider = mock<Provider<Directory>>() val mockDir = mock<Directory>() whenever(mockDir.asFile).thenReturn(File(buildDir, path)) whenever(mockDirProvider.get()).thenReturn(mockDir) mockDirProvider } // Mocker afterEvaluate pour exécution immédiate whenever(mockProject.afterEvaluate(any<Action<Project>>())).doAnswer { invocation -> val action = invocation.arguments[0] as Action<Project> action.execute(mockProject) // ✅ Exécution synchrone null } return Pair(mockProject, mockPluginContainer) }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre>@startuml participant "テスト" as T participant "ベーカリープラグイン" as BP participant "モックプロジェクト" as MP participant "評価後のアクション" as AE T -> BP: apply(project) activate BP BP -> MP: afterEvaluate { ... } activate MP note right Mock configuré pour exécuter immédiatement end note MP -> AE: execute(project) activate AE AE -> MP: layout.buildDirectory.dir("焼く") MP --> AE: Provider<Directory> ✅ AE -> MP: plugins.apply(JBakePlugin) deactivate AE MP --> BP: deactivate MP BP --> T: deactivate BP T -> T: verify(mockPluginContainer).apply(...) note right: ✅ SUCCÈS ! @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_完全なソリューション">完全なソリューション</h2> <div class="sectionbody"> <div class="paragraph"> <p>こちらが関数です`createMockProject()`フィナーレ、すべての問題を解決する：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">private fun createMockProject(): Pair<Project, PluginContainer> { // 1️⃣ CRÉER tous les mocks (pas de nested mocks !) val mockPluginContainer = mock<PluginContainer>() val mockExtensionContainer = mock<ExtensionContainer>() val mockLogger = mock<org.gradle.api.logging.Logger>() val mockTaskContainer = mock<TaskContainer>() val mockConfigPathProperty = mock<Property<String>>() val mockBakeryExtension = mock<BakeryExtension>() val mockProjectDirectory = mock<Directory>() val mockBuildDirectory = mock<DirectoryProperty>() val mockProjectLayout = mock<ProjectLayout>() val mockProject = mock<Project>() // 2️⃣ CONFIGURER la résolution des chemins val configFile = File("../../site.yml").canonicalFile val projectDir = configFile.parentFile val buildDir = File(projectDir, "build") whenever(mockConfigPathProperty.get()).thenReturn("site.yml") whenever(mockConfigPathProperty.isPresent).thenReturn(true) whenever(mockBakeryExtension.configPath).thenReturn(mockConfigPathProperty) whenever(mockProjectDirectory.asFile).thenReturn(projectDir) // 3️⃣ CONFIGURER buildDirectory avec dir() whenever(mockBuildDirectory.dir(any<String>())).doAnswer { invocation -> val path = invocation.arguments[0] as String val mockDirProvider = mock<Provider<Directory>>() val mockDir = mock<Directory>() whenever(mockDir.asFile).thenReturn(File(buildDir, path)) whenever(mockDirProvider.get()).thenReturn(mockDir) mockDirProvider } // 4️⃣ ASSEMBLER le projet whenever(mockProjectLayout.projectDirectory).thenReturn(mockProjectDirectory) whenever(mockProjectLayout.buildDirectory).thenReturn(mockBuildDirectory) whenever(mockExtensionContainer.create("bakery", BakeryExtension::class.java)) .thenReturn(mockBakeryExtension) whenever(mockExtensionContainer.getByType(BakeryExtension::class.java)) .thenReturn(mockBakeryExtension) whenever(mockProject.extensions).thenReturn(mockExtensionContainer) whenever(mockProject.plugins).thenReturn(mockPluginContainer) whenever(mockProject.tasks).thenReturn(mockTaskContainer) whenever(mockProject.layout).thenReturn(mockProjectLayout) whenever(mockProject.logger).thenReturn(mockLogger) whenever(mockProject.projectDir).thenReturn(projectDir) // 5️⃣ CONFIGURER afterEvaluate pour exécution immédiate whenever(mockProject.afterEvaluate(any<Action<Project>>())).doAnswer { invocation -> val action = invocation.arguments[0] as Action<Project> action.execute(mockProject) null } return Pair(mockProject, mockPluginContainer) }</code></pre> </div> </div> <div class="paragraph"> <p>そして最終テストが合格する :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `plugin applies jbake gradle plugin`() { val (project, mockPluginContainer) = createMockProject() val plugin = BakeryPlugin() plugin.apply(project) verify(mockPluginContainer).apply(JBakePlugin::class.java) // ✅ SUCCÈS ! }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_学んだ教訓">学んだ教訓</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>@startmindmap * Mocking avec Mockito ** ✅ Bonnes pratiques *** Créer tous les mocks d'abord *** Configurer avec whenever() séparément *** Vérifier le mock exact, pas un proxy *** Tester la résolution des chemins ** ❌ Pièges à éviter *** mock() dans un bloc de configuration *** Vérifier project.x au lieu de mockX *** Ignorer les blocs afterEvaluate *** Retourner null pour les Providers @endmindmap</pre> </div> </div> <div class="sect2"> <h3 id="_正しいモックを確認する">正しいモックを確認する</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// ❌ FAUX verify(project.plugins).apply(JBakePlugin::class.java) // ✅ CORRECT val (project, mockPluginContainer) = createMockProject() verify(mockPluginContainer).apply(JBakePlugin::class.java)</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_2_ネストされたモックを避ける">2. ネストされたモックを避ける</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// ❌ FAUX - UnfinishedStubbingException val mockProject = mock<Project> { on { logger } doReturn mock() // Nested mock creation ! } // ✅ CORRECT - Créer séparément val mockLogger = mock<org.gradle.api.logging.Logger>() val mockProject = mock<Project>() whenever(mockProject.logger).thenReturn(mockLogger)</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_3_評価のコールバックをモックする">3. 評価のコールバックをモックする</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// ✅ afterEvaluate doit s'exécuter pour les tests whenever(mockProject.afterEvaluate(any())).doAnswer { invocation -> val action = invocation.arguments[0] as Action<Project> action.execute(mockProject) null }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_4_パスの解決をテストする">4. パスの解決をテストする</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// Toujours vérifier que les chemins se résolvent correctement val extension = project.extensions.getByType(BakeryExtension::class.java) val configPath = extension.configPath.get() val projectDir = project.layout.projectDirectory.asFile val resolvedConfig = projectDir.resolve(configPath) println("Resolved config: ${resolvedConfig.absolutePath}") println("Exists: ${resolvedConfig.exists()}")</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_最終テストアーキテクチャ">最終テストアーキテクチャ</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>@startuml package "テストレイヤー" { [Test Class] --> [createMockProject()] } package "モック作成" { [createMockProject()] --> [Create All Mocks] [Create All Mocks] --> [Configure Paths] [Configure Paths] --> [Configure Callbacks] [Configure Callbacks] --> [Assemble Project] } package "モックオブジェクト" { [Assemble Project] --> [Project Mock] [Assemble Project] --> [PluginContainer Mock] [Assemble Project] --> [Extension Mocks] [Assemble Project] --> [Layout Mocks] } package "テスト中のプラグイン" { [Test Class] --> [BakeryPlugin] [BakeryPlugin] --> [Project Mock] [BakeryPlugin] --> [PluginContainer Mock] } package "検証" { [Test Class] --> [verify(mockPluginContainer)] } @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>テストの単純な問題のように見えたものが、実は優れた事例研究の対象であることが明らかになりました：</p> </div> <div class="ulist"> <ul> <li> <p>KotlinとMockitoの細かい点</p> </li> <li> <p>適切なオブジェクトをモックすることの重要性</p> </li> <li> <p>テストにおける非同期コールバックの管理</p> </li> <li> <p>Gradleプラグインでのパス解決</p> </li> </ul> </div> <div class="paragraph"> <p>体系的なデバッグにより、問題の各層を理解することで、堅牢で保守性の高いソリューションにたどり着くことができました。</p> </div> <div class="admonitionblock tip"> <table> <tr> <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> <div class="paragraph"> <p><strong>テストのためのアドバイス</strong>: 「Wanted but not invoked」にMockitoで遭遇した場合、いつも自分に問いかけてください : 1. 正しいモックを確認していますか？ 2. 私のすべてのモックは設定ブロックの外で作成されていますか？ 3. 私のコールバックは本当に実行されますか？ 4. 私のパスは正しく解決されますか？</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_リソース">リソース</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="https://github.com/mockito/mockito-kotlin">Mockito-Kotlin ドキュメント</a></p> </li> <li> <p><a href="https://docs.gradle.org/current/userguide/custom_plugins.html">グラドルプラグイン開発ガイド</a></p> </li> <li> <p><a href="https://jbake.org/">JBake 静的サイトジェネレーター</a></p> </li> </ul> </div> <hr> <div class="paragraph"> <p><em>同様の問題に遭遇しましたか？テストでの経験をコメントで共有してください !</em></p> </div> </div> </div> https://cheroliv.com/blog/2024/0075_kotlin_arrow-traverse_right_and_left_post.html Tue, 24 Sep 2024 00:00:00 +0000 blog/2024/0075_kotlin_arrow-traverse_right_and_left_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_はじめに">はじめに</a></li> <li><a href="#_either_モナドとは何ですか">Either モナドとは何ですか？</a> <ul class="sectlevel2"> <li><a href="#_なぜ_either_を使うのか">なぜ Either を使うのか？</a></li> </ul> </li> <li><a href="#_コンテキスト">コンテキスト</a></li> <li><a href="#_異なるアプローチ">�異なるアプローチ</a> <ul class="sectlevel2"> <li><a href="#_従来のwhenを使用したアプローチ">従来の`when`を使用したアプローチ</a></li> <li><a href="#_fold_を使用したより簡潔なアプローチ">fold` を使用したより簡潔なアプローチ</a></li> <li><a href="#_変換_map_と_mapleft">変�換 <code>map</code> と `mapLeft</a></li> <li><a href="#_getorelse_を使ったエラー処理">getOrElse` を使ったエラー処理</a></li> <li><a href="#_横のアクション_onleft_と_onright">横のアクション <code>onLeft</code> と `onRight</a></li> <li><a href="#_flatmap_を使った操作のチェーン">flatMap` を使った操作のチェーン</a></li> <li><a href="#_双方向変換と_bimap">双方向変換と `bimap</a></li> <li><a href="#_swap_を使用した側面の反転">swap` を使用した側面の反転</a></li> <li><a href="#_tap_と_tapleft_の使用">tap` と <code>tapLeft</code> の使用:</a></li> <li><a href="#_recover_の使用">recover` の使用 :</a></li> </ul> </li> <li><a href="#_実践的なユースケース">実践的なユースケース</a></li> <li><a href="#_結論">結論</a></li> <li><a href="#_さらに進むために">さらに進むために</a></li> </ul> </div> <div class="sect1"> <h2 id="_はじめに">はじめに</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title"><em>対象者 :</em> 中級から上級のKotlin開発者。</div> <p>Kotlinにおける関数型プログラミングの世界で、Arrowライブラリはエラーと代替ケースを処理するための強力なツールを提供します。これらのツールの中で、モナド`Either`は、成功(Right)または失敗(Left)の2つの可能な状態を表現できる能力によって特徴づけられます。 しかし、これらの2つの状態を効果的にどのようにナビゲートすればよいでしょうか？ これが本記事で探求する内容です。</p> </div> </div> </div> <div class="sect1"> <h2 id="_either_モナドとは何ですか">Either モナドとは何ですか？</h2> <div class="sectionbody"> <div class="paragraph"> <p>モナド`Either`は、相互に排他的な2つの可能性を表すデータ構造です。KotlinとArrowでは、操作の成功と失敗のケースを処理するためにしばしば使用され、従来の例外に代わるエレガントな選択肢を提供します。</p> </div> <div class="sect2"> <h3 id="_なぜ_either_を使うのか">なぜ Either を使うのか？</h3> <div class="olist arabic"> <ol class="arabic"> <li> <p>明示的なエラー処理：開発者に失敗ケースを考慮させる。</p> </li> <li> <p>機能的な合成 : 失敗する可能性のある操作の連鎖を容易にする。</p> </li> <li> <p>型安全 : エラーは型付けされており、これによりより正確に処理するのに役立ちます。</p> </li> <li> <p>例外はなし：副作用と実行フローへの予期しない中断を避ける。</p> </li> </ol> </div> </div> </div> </div> <div class="sect1"> <h2 id="_コンテキスト">コンテキスト</h2> <div class="sectionbody"> <div class="paragraph"> <p>REST APIを開発していると仮定してhttps://spring.io/projects/spring-boot/[Spring Boot,ウィンドウズ=後で読む] et <a href="https://kotlinlang.org/">Kotlin</a>, ライブラリを使用してhttps://arrow-kt.io/[矢印,ウィンドウズ=後で読む]あなたは関数を持っています。`findOneUserByEmail`返す`Either<Throwable, User>`この結果をエレガントかつ機能的にどのように処理しますか？</p> </div> <div class="paragraph"> <p>Userクラスがあります：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@file:Suppress( "RemoveRedundantQualifierName", "MemberVisibilityCanBePrivate", "SqlNoDataSourceInspection" ) package webapp.users import arrow.core.Either import arrow.core.left import arrow.core.right import com.fasterxml.jackson.annotation.JsonIgnore import com.fasterxml.jackson.databind.ObjectMapper import jakarta.validation.constraints.NotNull import jakarta.validation.constraints.Pattern import jakarta.validation.constraints.Size import org.springframework.beans.factory.getBean import org.springframework.context.ApplicationContext import org.springframework.data.r2dbc.core.R2dbcEntityTemplate import org.springframework.r2dbc.core.DatabaseClient import org.springframework.r2dbc.core.awaitOne import org.springframework.r2dbc.core.awaitRowsUpdated import webapp.core.property.ANONYMOUS_USER import webapp.core.property.EMPTY_STRING import webapp.core.utils.AppUtils.cleanField import webapp.users.EntityModel.Companion.ID_MEMBER import webapp.users.User.UserDao.Attributes.EMAIL_ATTR import webapp.users.User.UserDao.Attributes.ID_ATTR import webapp.users.User.UserDao.Attributes.LANG_KEY_ATTR import webapp.users.User.UserDao.Attributes.LOGIN_ATTR import webapp.users.User.UserDao.Attributes.PASSWORD_ATTR import webapp.users.User.UserDao.Attributes.VERSION_ATTR import webapp.users.User.UserDao.Constraints.LOGIN_REGEX import webapp.users.User.UserDao.Fields.EMAIL_FIELD import webapp.users.User.UserDao.Fields.ID_FIELD import webapp.users.User.UserDao.Fields.LANG_KEY_FIELD import webapp.users.User.UserDao.Fields.LOGIN_FIELD import webapp.users.User.UserDao.Fields.PASSWORD_FIELD import webapp.users.User.UserDao.Fields.VERSION_FIELD import webapp.users.User.UserDao.Relations.INSERT import webapp.users.security.Role import webapp.users.security.Role.RoleDao import webapp.users.security.UserRole.UserRoleDao import java.util.* import jakarta.validation.constraints.Email as EmailConstraint data class User( override val id: UUID? = null, @field:NotNull @field:Pattern(regexp = LOGIN_REGEX) @field:Size(min = 1, max = 50) val login: String, @JsonIgnore @field:NotNull @field:Size(min = 60, max = 60) val password: String = EMPTY_STRING, @field:EmailConstraint @field:Size(min = 5, max = 254) val email: String = EMPTY_STRING, @JsonIgnore val roles: MutableSet<Role> = mutableSetOf(Role(ANONYMOUS_USER)), @field:Size(min = 2, max = 10) val langKey: String = EMPTY_STRING, @JsonIgnore val version: Long = -1, ) : EntityModel<UUID>() { companion object { @JvmStatic fun main(args: Array<String>) = println(UserDao.Relations.sqlScript) } object UserDao { object Constraints { // Regex for acceptable logins const val LOGIN_REGEX = "^(?>[a-zA-Z0-9!$&*+=?^_`{|}~.-]+@[a-zA-Z0-9-]+(?:\\.[a-zA-Z0-9-]+)*)|(?>[_.@A-Za-z0-9-]+)$" const val PASSWORD_MIN: Int = 4 const val PASSWORD_MAX: Int = 16 const val IMAGE_URL_DEFAULT = "https://placehold.it/50x50" const val PHONE_REGEX = "^(\\+|00)?[1-9]\\d{0,49}\$" } object Members { const val PASSWORD_MEMBER = "password" const val ROLES_MEMBER = "roles" } object Fields { const val ID_FIELD = "`id`" const val LOGIN_FIELD = "`login`" const val PASSWORD_FIELD = "`password`" const val EMAIL_FIELD = "`email`" const val LANG_KEY_FIELD = "`lang_key`" const val VERSION_FIELD = "`version`" } object Attributes { val ID_ATTR = ID_FIELD.cleanField() val LOGIN_ATTR = LOGIN_FIELD.cleanField() val PASSWORD_ATTR = PASSWORD_FIELD.cleanField() val EMAIL_ATTR = EMAIL_FIELD.cleanField() const val LANG_KEY_ATTR = "langKey" val VERSION_ATTR = VERSION_FIELD.cleanField() } object Relations { const val TABLE_NAME = "`user`" const val SQL_SCRIPT = """ CREATE TABLE IF NOT EXISTS $TABLE_NAME ( $ID_FIELD UUID default random_uuid() PRIMARY KEY, $LOGIN_FIELD VARCHAR, $PASSWORD_FIELD VARCHAR, $EMAIL_FIELD VARCHAR, $LANG_KEY_FIELD VARCHAR, $VERSION_FIELD bigint ); CREATE UNIQUE INDEX IF NOT EXISTS `uniq_idx_user_login` ON $TABLE_NAME ($LOGIN_FIELD); CREATE UNIQUE INDEX IF NOT EXISTS `uniq_idx_user_email` ON $TABLE_NAME ($EMAIL_FIELD); """ @Suppress("SqlDialectInspection") const val INSERT = """ insert into $TABLE_NAME ( $LOGIN_FIELD, $EMAIL_FIELD, $PASSWORD_FIELD, $LANG_KEY_FIELD, $VERSION_FIELD ) values ( :login, :email, :password, :langKey, :version)""" @JvmStatic val sqlScript: String get() = setOf( UserDao.Relations.SQL_SCRIPT, RoleDao.Relations.SQL_SCRIPT, UserRoleDao.Relations.SQL_SCRIPT ).joinToString("") .trimMargin() } object Dao { val Pair<User, ApplicationContext>.toJson: String get() = second.getBean<ObjectMapper>().writeValueAsString(first) suspend fun Pair<User, ApplicationContext>.save(): Either<Throwable, Long> = try { second.getBean<R2dbcEntityTemplate>() .databaseClient .sql(INSERT) .bind(LOGIN_ATTR, first.login) .bind(EMAIL_ATTR, first.email) .bind(PASSWORD_ATTR, first.password) .bind(LANG_KEY_ATTR, first.langKey) .bind(VERSION_ATTR, first.version) .fetch() .awaitRowsUpdated() .right() } catch (e: Throwable) { e.left() } suspend fun ApplicationContext.findOneUserByEmail( email: String ): Either<Throwable, User> = try { getBean<DatabaseClient>() .sql("SELECT * FROM `user` WHERE LOWER(email) = LOWER(:email)") .bind("email", email) .fetch() .awaitOne() .let { row -> User( id = row[ID_ATTR] as UUID?, login = row[LOGIN_ATTR] as String, password = row[PASSWORD_ATTR] as String, email = row[EMAIL_ATTR] as String, langKey = row[LANG_KEY_ATTR] as String, version = row[VERSION_ATTR] as Long ) }.right() } catch (e: Throwable) { e.left() } } } /** Account REST API URIs */ object UserRestApis { const val API_AUTHORITY = "/api/authorities" const val API_USERS = "/api/users" const val API_SIGNUP = "/signup" const val API_SIGNUP_PATH = "$API_USERS$API_SIGNUP" const val API_ACTIVATE = "/activate" const val API_ACTIVATE_PATH = "$API_USERS$API_ACTIVATE?key=" const val API_ACTIVATE_PARAM = "{activationKey}" const val API_ACTIVATE_KEY = "key" const val API_RESET_INIT = "/reset-password/init" const val API_RESET_FINISH = "/reset-password/finish" const val API_CHANGE = "/change-password" const val API_CHANGE_PATH = "$API_USERS$API_CHANGE" } } // Abstract entity model with Generic ID, which can be of any type abstract class EntityModel<T>( open val id: T? = null ) { companion object { const val ID_MEMBER = "id" } } // Generic extension function that allows the ID to be applied to any EntityModel type inline fun <reified T : EntityModel<ID>, ID> T.withId(id: ID): T { // Use reflection to create a copy with the passed ID return this::class.constructors.first { it.parameters.any { param -> param.name == ID_MEMBER } } .call(id, *this::class.constructors.first().parameters.drop(1).map { param -> this::class.members.first { member -> member.name == param.name }.call(this) }.toTypedArray()) }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_異なるアプローチ">�異なるアプローチ</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_従来のwhenを使用したアプローチ">従来の`when`を使用したアプローチ</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val user: User by lazy { userFactory(USER) } val result: Either<Throwable, User> = context.findOneUserByEmail(user.email) when (result) { is Either.Left -> { val error = result.value println("Erreur : ${error.message}") } is Either.Right -> { val user = result.value println("Utilisateur trouvé : ${user.login}") } }</code></pre> </div> </div> <div class="paragraph"> <p>この方法はシンプルで読みやすいですが、Arrowの機能的な能力を十分に活用していません。</p> </div> </div> <div class="sect2"> <h3 id="_fold_を使用したより簡潔なアプローチ">fold` を使用したより簡潔なアプローチ</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">result.fold( { error -> println("Erreur : ${error.message}") }, { user -> println("Utilisateur trouvé : ${user.login}") } )</code></pre> </div> </div> <div class="paragraph"> <p>`fold`これにより、Left と Right の両ケースに対して簡潔かつエレガントにアクションを定義することができます。</p> </div> </div> <div class="sect2"> <h3 id="_変換_map_と_mapleft">変�換 <code>map</code> と `mapLeft</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val processedResult = result .map { user -> "Utilisateur trouvé : ${user.login}" } .mapLeft { error -> "Erreur : ${error.message}" } println(processedResult.merge())</code></pre> </div> </div> <div class="paragraph"> <p>このアプローチは、Eitherに格納された値を変換しつつその構造を保持し、より複雑な処理チェーンに適しています。</p> </div> </div> <div class="sect2"> <h3 id="_getorelse_を使ったエラー処理">getOrElse` を使ったエラー処理</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val user = result.getOrElse { error -> println("Erreur : ${error.message}") User(login = "default", email = "default@example.com") // utilisateur par défaut } println("Login : ${user.login}")</code></pre> </div> </div> <div class="paragraph"> <p>`getOrElse`デフォルト値を提供することでエラー処理をエレガントに行う。</p> </div> </div> <div class="sect2"> <h3 id="_横のアクション_onleft_と_onright">横のアクション <code>onLeft</code> と `onRight</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">result.onLeft { error -> println("Erreur : ${error.message}") } .onRight { user -> println("Utilisateur trouvé : ${user.login}") }</code></pre> </div> </div> <div class="paragraph"> <p>これらのメソッドは、Either を変更せずに各側でアクションを実行でき、ロギングや軽微な副作用に最適です。</p> </div> </div> <div class="sect2"> <h3 id="_flatmap_を使った操作のチェーン">flatMap` を使った操作のチェーン</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">fun findUser(email: String): Either<Throwable, User> = // ... implémentation fun getUserPermissions(user: User): Either<Throwable, List<String>> = // ... implémentation val userPermissions = findUser("user@example.com") .flatMap { user -> getUserPermissions(user) }</code></pre> </div> </div> <div class="paragraph"> <p><code>flatMap`は、自分自身が何かを返す操作を連鎖させるのに便利です`Either</code>, これにより　を避ける`Either`ネストされた。</p> </div> </div> <div class="sect2"> <h3 id="_双方向変換と_bimap">双方向変換と `bimap</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val result: Either<Throwable, User> = // ... obtention du résultat val processedResult = result.bimap( { error -> "Erreur: ${error.message}" }, { user -> "Utilisateur: ${user.login}" } )</code></pre> </div> </div> <div class="paragraph"> <p><code>bimap</code>� 左側と右側の両方を一度の操作で変換できる。</p> </div> </div> <div class="sect2"> <h3 id="_swap_を使用した側面の反転">swap` を使用した側面の反転</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val result: Either<Throwable, User> = // ... obtention du résultat val swapped = result.swap()</code></pre> </div> </div> <div class="paragraph"> <p><code>swap`これは、一方の側を逆にしたいときに便利です`Either</code>, 例えば、ある関数のインターフェイスを別の関数に適応させるために。</p> </div> </div> <div class="sect2"> <h3 id="_tap_と_tapleft_の使用">tap` と <code>tapLeft</code> の使用:</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">result.tap { user -> println("Utilisateur trouvé : ${user.login}") } .tapLeft { error -> println("Erreur : ${error.message}") }</code></pre> </div> </div> <div class="paragraph"> <p>同様に`onLeft` et <code>onRight</code>, ただし、これらのメソッドは元のEitherを返し、これは操作のチェーンに役立ちます。</p> </div> </div> <div class="sect2"> <h3 id="_recover_の使用">recover` の使用 :</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val recoveredUser = result.recover { error -> println("Erreur récupérée : ${error.message}") User(login = "recovered", email = "recovered@example.com") } println("Login : ${recoveredUser.login}")</code></pre> </div> </div> <div class="paragraph"> <p>このメソッドは、代替値を提供することで Either.Left を Either.Right に変換することができます。</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_実践的なユースケース">実践的なユースケース</h2> <div class="sectionbody"> <div class="paragraph"> <p>使ってください`fold`各ケースに対する処理が必要な単純な操作の場合 - お好みください`map` et <code>mapLeft`データ変換のために、構造を変更せずに l'`Either</code>。 - 選んでください`flatMap`失敗する可能性のある操作のチェーン中に - 使用してください`recover`エラー時にデフォルト値を提供するために。 - 選んでください`onLeft` et <code>onRight</code> (ou <code>tap</code> et <code>tapLeft</code>) ロギングなどの副作用のために - 使って`bimap`両側を一つの操作に変換するために。 - 適用して`swap`関数のインターフェイスを別の関数に合わせなければならないとき。</p> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>それぞれのアプローチは、使用状況に応じて利点があります。方法としては`fold`, <code>map</code>/<code>mapLeft</code>, et `recover`特に便利です。複数の操作を連鎖させたいときや、データを関数的に変換したいときに使用できます。</p> </div> <div class="paragraph"> <p>モナド`Either`d’Arrow は、Kotlin アプリケーションにおける成功とエラーのケースを処理する際に、卓越した柔軟性を提供します。これらのさまざまなアプローチを習得することで、より堅牢で、読みやすく、機能的なコードを記述できるようになります。</p> </div> <div class="paragraph"> <p>次のプロジェクトでは、ためらわずにこれらのテクニックを探求し、KotlinとArrowを使った関数型プログラミングの最大限の活用を試みてください！</p> </div> </div> </div> <div class="sect1"> <h2 id="_さらに進むために">さらに進むために</h2> <div class="sectionbody"> <div class="paragraph"> <p>Arrow 公式ドキュメント :https://arrow-kt.io/docs/apidocs/arrow-core/arrow.core/-either/[Arrow Either] - Kotlin Coroutines と Arrow :https://arrow-kt.io/docs/fx/[Arrow Fx コルーチン]</p> </div> <div class="paragraph"> <p>体�験談とお気に入りのテクニックを共有するのを忘れずに、作業する際に`Either`以下のコメントで！</p> </div> </div> </div> https://cheroliv.com/blog/2024/0074_seach_file_linux_post.html Mon, 23 Sep 2024 00:00:00 +0000 blog/2024/0074_seach_file_linux_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_序論">序論</a></li> <li><a href="#_コマンドの使用_find">コマンドの使用 `find</a> <ul class="sectlevel2"> <li><a href="#_find_用の追加オプション">find` 用の追加オプション</a></li> </ul> </li> <li><a href="#_コマンドの使用_locate">コマンドの使用 `locate</a></li> <li><a href="#_コマンド_grep_を使用してファイル内のテキストを検索する">コマンド <code>grep</code> を使用してファイル内のテキストを検索する</a></li> <li><a href="#_結論">結論</a></li> </ul> </div> <div class="sect1"> <h2 id="_序論">序論</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">問題点： ターミナルを通じてLinuxオペレーティングシステムでファイルを検索する。</div> <p>この記事では、Zshターミナルを使用してUbuntuでファイルを検索する方法について探ります。Zsh（Zシェル）は、柔軟性と高度な機能のために広く使用されている強力なコマンドインタプリタです。</p> </div> <div class="paragraph"> <p>Ubuntuは人気のあるLinuxディストリビューションで、ファイルを検索するための複数のコマンドラインツールを提供しています。これらのコマンドの使い方を見ていきます。<code>find</code>, <code>locate</code> et `grep`ターミナルでファイルを素早く効率的に見つける</p> </div> </div> </div> <div class="sect1"> <h2 id="_コマンドの使用_find">コマンドの使用 `find</h2> <div class="sectionbody"> <div class="paragraph"> <p>コマンド`find`特定のディレクトリとそのサブディレクトリ内のファイルを検索することができます。基本的な構文は次のとおりです：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">find [chemin] -name [nom_du_fichier]</code></pre> </div> </div> <div class="paragraph"> <p>これは、名前が付いたファイルを探している実用的な例です。<code>example.txt`ディレクトリの中に</code>/home`：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">find /home -name "example.txt"</code></pre> </div> </div> <div class="paragraph"> <p>このコマンドはすべてのサブディレクトリを巡回します`/home`ファイルが見つかった場合、フルパスを表示して。</p> </div> <div class="paragraph"> <p><strong>コマンドのオンラインマニュアル`find` : <a href="https://man.archlinux.org/man/find.1.fr/">man find</a></strong></p> </div> <div class="sect2"> <h3 id="_find_用の追加オプション">find` 用の追加オプション</h3> <div class="paragraph"> <p>コマンド`find`とても強力で、多数のオプションがあります。いくつかの便利な例を以下に示します：</p> </div> <div class="ulist"> <ul> <li> <p><strong>ファイルの種類で検索</strong>ファイルのみを検索するには`-type f`、そしてディレクトリを検索するには、<code>-type d</code>。 - <strong>サイズで検索</strong>また、オプションを使用してファイルのサイズに基づいてフィルタリングすることもできます`-size`. Par exemple, pour rechercher des fichiers de plus de 100 Mo, utilisez :</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">find /home -size +100M</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_コマンドの使用_locate">コマンドの使用 `locate</h2> <div class="sectionbody"> <div class="paragraph"> <p>コマンド`locate`より速い`find`それは、システム上に存在するファイルのプリインデックスされたデータベースを使用しているためです。まず、次のコマンドでこのデータベースを更新する必要があります：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo updatedb</code></pre> </div> </div> <div class="paragraph"> <p>その後、次のようにファイルを検索できます：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">locate example.txt</code></pre> </div> </div> <div class="paragraph"> <p>使っていますhttps://fr.wikipedia.org/wiki/Z_Shell[zsh]とhttps://github.com/ohmyzsh/ohmyzsh/wiki[oh-my-zsh]、コマンドであることが判明した`locate`アクセスできません`zsh`しかし、以来可能です`bash`, それに対処するために, その主張`-c`コマンドの`bash`コマンドを実行できる`bash`別のタイプの端末から。</p> </div> <div class="paragraph"> <p>ここで、パターンで終わるファイルを探しています`001.pdf`� ユーザーディレクトリ内</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">bash -c "locate ~/*001.pdf"</code></pre> </div> </div> <div class="paragraph"> <p><strong>コマンドのオンラインマニュアル`locate`:https://man.archlinux.org/man/locate.1.fr/[man locate,windows=read-later]</strong></p> </div> </div> </div> <div class="sect1"> <h2 id="_コマンド_grep_を使用してファイル内のテキストを検索する">コマンド <code>grep</code> を使用してファイル内のテキストを検索する</h2> <div class="sectionbody"> <div class="paragraph"> <p>特定のテキストをファイル内で検索したい場合は、使用できます。<code>grep</code>. 例えば、すべてのファイルで「Ubuntu」という単語の出現を検索する`.txt`現在のディレクトリを使用してください：**</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">grep "Ubuntu" *.txt</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>Ubuntu の Zsh ターミナル を 使っ た ファイル の 検索 は、いくつか の 強力な ツール を 用い る こと が できます。<code>find</code>�柔軟で、多様なオプションを提供し、その一方で`locate`これにより、事前に構築されたデータベースを使って高速な検索が可能になります。最後に、`grep`ファイル内のテキストの出現を見つけることができます。</p> </div> <div class="paragraph"> <p>これらのコマンドは、ファイル検索をより効率的にし、ニーズに合わせた完全なツールセットを提供し、それぞれのコマンドには、コマンドで表示できるマニュアルがあります。<code>man</code></p> </div> </div> </div> https://cheroliv.com/blog/2021/0030_memo_linux_post.html Mon, 23 Sep 2024 00:00:00 +0000 blog/2021/0030_memo_linux_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_キーボード">キーボード：</a> <ul class="sectlevel2"> <li><a href="#_ctrl_キー"><em><Ctrl> キー</em></a></li> </ul> </li> <li><a href="#_許可承認">許可(承認)</a></li> <li><a href="#_ファイル検索">ファイル検索</a></li> </ul> </div> <div class="sect1"> <h2 id="_キーボード">キーボード：</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_ctrl_キー"><em><Ctrl> キー</em></h3> <table class="tableblock frame-all grid-all stretch"> </table> <div class="paragraph"> <p><a href="https://korben.info/les-raccourcis-clavier-pour-bash-terminal-linux-et-macos.html">リンク</a><br> <a href="https://blogmotion.fr/systeme/astuces-bash-linux-16175">別のリンク</a></p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_許可承認">許可(承認)</h2> <div class="sectionbody"> <div class="paragraph"> <p>CHMODはファイルのパーミッションを変更するために使用されます</p> </div> <div class="paragraph"> <p>許可 コマンド</p> </div> <div class="paragraph"> <p>U G W rwx rwx rwx chmod 777 filename rwx rwx r-x chmod 775 ファイル名 rwx r-x r-x chmod 755 ファイル名 rw- rw- r-- chmod 664 ファイル名 rw- r-- r-- chmod 644 filename</p> </div> <div class="paragraph"> <p>U = User G = グループ W = 世界</p> </div> <div class="paragraph"> <p>r = 読み取り可能 w = 書き込み可能 x = 実行可能 - = 許可なし</p> </div> <div class="paragraph"> <p>権限を見る別の方法:</p> </div> <div class="paragraph"> <p>400 所有者によって読まれた 040 グループによって読まれる 004 他の誰かによって読まれる 200 所有者が書く 020 グループで書く 誰でも書く 100 所有者によって実行 010 グループで実行 誰でも実行できる</p> </div> <div class="paragraph"> <p>組み合わせを得るには、それらを足し合わせるだけです。<br> 例えば、所有者が読む、書く、実行するために、<br> 読まれ、実行され、グループで実行され、誰でも実行できる<br> あなたは400+200+100+040+010+001を足して751になります。<br></p> </div> </div> </div> <div class="sect1"> <h2 id="_ファイル検索"><a href="/blog/2024/0074_seach_file_linux_post.html">ファイル検索</a></h2> <div class="sectionbody"> </div> </div> https://cheroliv.com/blog/2024/0072_Exposer_un_port_linux_subsystem_post.adoc.html Thu, 1 Feb 2024 00:00:00 +0000 blog/2024/0072_Exposer_un_port_linux_subsystem_post.adoc.html https://cheroliv.com/blog/2024/0070_installer_pandoc_post.html Tue, 30 Jan 2024 00:00:00 +0000 blog/2024/0070_installer_pandoc_post.html <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title"><em>読了時間 : 3 min</em> Pandoc はユニバーサルなドキュメント変換ツール</div> <p>Pandocはオープンソースのテキスト処理ソフトウェアであり、異なるフォーマット間でドキュメントを変換するために使用できます。 Pandocをインストールする方法はいくつかあります。</p> </div> </div> </div> <div class="sect1"> <h2 id="_ダウンロードページからのインストール">ダウンロードページからのインストール</h2> <div class="sectionbody"> <div class="paragraph"> <p>Pandocをダウンロードページからインストールするには、次の手順に従ってください。</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>Pandoc のダウンロードページにアクセスしてください：https://pandoc.org/installing.html/[<a href="https://pandoc.org/installing.html" class="bare">https://pandoc.org/installing.html</a>]</p> </li> <li> <p>お使いのオペレーティングシステム用のパッケージインストーラをダウンロードしてください。</p> </li> <li> <p>インストーラを実行してPandocをインストールしてください。</p> </li> </ol> </div> <div class="paragraph"> <p><strong>ZIPファイルからのインストール</strong></p> </div> <div class="paragraph"> <p>ZIPファイルからPandocをインストールするには、次の手順に従ってください：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>Pandocのバイナリとドキュメントを含むzipファイルをダウンロードしてください。</p> </li> <li> <p>ZIPファイルを解凍してください。</p> </li> <li> <p>バイナリを好きなディレクトリに移動してください。</p> </li> </ol> </div> <div class="paragraph"> <p><strong>Chocolateyを使用したインストール</strong></p> </div> <div class="paragraph"> <p>Chocolatey を使用して Pandoc をインストールする手順は次のとおりです：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>コマンドプロンプトを開いてください。</p> </li> <li> <p>次のコマンドを実行してください：</p> </li> </ol> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-powershell hljs" data-lang="powershell">choco install pandoc</code></pre> </div> </div> <div class="paragraph"> <p><strong>wingetを使用したインストール</strong></p> </div> <div class="paragraph"> <p>wingetを使ってPandocをインストールする手順は次の通りです：</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>コマンドプロンプトを開いてください。</p> </li> <li> <p>次のコマンドを実行してください :</p> </li> </ol> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-powershell hljs" data-lang="powershell">winget install --source winget --exact --id JohnMacFarlane.Pandoc</code></pre> </div> </div> <div class="paragraph"> <p><strong>推奨事項</strong></p> </div> <div class="paragraph"> <p>デフォルトでは、Pandoc は LaTeX を使って PDF を作成します。 LaTeXをMiKTeXを介してインストールすることをお勧めします。 オプションと共に`--pdf-engine`ただし、他のプログラムをこのタスクに指定することもできます。</p> </div> <div class="paragraph"> <p><strong>警告</strong></p> </div> <div class="paragraph"> <p>複数のインストール方法を使用すると、Pandoc の 2 つの異なるインストールが発生する可能性があります。 代替のインストール方法に移行する前に、Pandocを正しくアンインストールすることをお勧めします。</p> </div> <div class="paragraph"> <p><strong>WSLを使用したLinuxへのインストール</strong></p> </div> <div class="paragraph"> <p>パッケージマネージャーの pandoc バージョンが古くないか確認してください。 Pandoc は Debian、Ubuntu、Slackware、Arch、Fedora、NixOS、openSUSE、gentoo、Void のリポジトリに含まれています。</p> </div> <div class="paragraph"> <p>最新バージョンを入手するために、amd64 アーキテクチャ向けのバイナリパッケージをダウンロードページで提供しています。</p> </div> <div class="paragraph"> <p>この実行可能ファイルは静的にリンクされており、動的依存関係や外部データファイルへの依存もありません。 注意：スタティックリンクのため、このパッケージの pandoc バイナリは、C で書かれた外部の Lua モジュールを必要とする Lua フィルタを使用できません。</p> </div> <div class="paragraph"> <p>tarball と deb インストーラーが提供されます。 debをインストールする :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo dpkg -i $DEB</code></pre> </div> </div> <div class="paragraph"> <p>書き込みの瞬間の例：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">wget https://github.com/jgm/pandoc/releases/download/3.1.11.1/pandoc-3.1.11.1-1-amd64.deb</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo dpkg -i pandoc-3.1.11.1-1-amd64.deb</code></pre> </div> </div> <div class="paragraph"> <p>où `$DEB`ダウンロードされた deb へのパスです。 これにより、実行可能ファイルがインストールされます。`pandoc`そしてマニュアルページ。</p> </div> <div class="paragraph"> <p>RPMベースのディストリビューションを使用している場合、当社のダウンロードページのDEBパッケージをalienを使ってインストールできるかもしれません。</p> </div> <div class="paragraph"> <p>どのディストリビューションでも、 tarball からインストールできます`$DEST`(例えば、<code>/usr/local/</code> ou <code>$HOME/.local</code>) 行うことで :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">tar xvzf $TGZ --strip-components 1 -C $DEST</code></pre> </div> </div> <div class="paragraph"> <p>où `$TGZ`ダウンロードされた zip tarball へのパスです。 Pandocのバージョンが2.0未満で、tarballを提供しないものについては、代わりに次のように試してください：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">ar p $DEB data.tar.gz | tar xvz --strip-components 2 -C $DEST</code></pre> </div> </div> <div class="paragraph"> <p>また、以下の手順を使用してソースからもインストールできます`Compilation à partir de la source`。 注意してください：ほとんどのディストリビューションは、パッケージリポジトリにHaskellプラットフォームを提供しています。 例えば、Debian/Ubuntuでは、それをインストールできます</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">apt-get install haskell-platform</code></pre> </div> </div> <div class="paragraph"> <p>デフォルトでは、Pandoc は LaTeX を使用して PDF を作成します。 パッケージマネージャを使ってTeX Liveをインストールすることをおすすめします。 (Debian/Ubuntuでは,<code>apt-get install texlive</code>）。 オプションで`--pdf-engine`, ただし他のプログラムを指定することもできます。</p> </div> </div> </div> https://cheroliv.com/blog/2023/0069_triple_python_js_ts_post.html Mon, 25 Dec 2023 00:00:00 +0000 blog/2023/0069_triple_python_js_ts_post.html <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title"><em>読了時間：2分</em> 関数型プログラミングを使用して、KotlinのTripleクラスの完全な実装をJavaScript、TypeScript、およびPythonで作成する。</div> <p><strong>注:</strong>タイプ`Maybe`, <code>Either</code>, `Result`JavaScriptまたはTypeScriptの基本言語には含まれないので、自分たちで実装する必要があります。</p> </div> </div> </div> <div class="sect1"> <h2 id="_ジャバスクリプト">ジャバスクリプト</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">//javascript // Maybe type const Maybe = (value) => ({ map: (fn) => (value !== null && value !== undefined ? Maybe(fn(value)) : Maybe(null)), flatMap: (fn) => (value !== null && value !== undefined ? fn(value) : Maybe(null)), getOrElse: (defaultValue) => (value !== null && value !== undefined ? value : defaultValue), }); // Either type const Either = { Left: (value) => ({ map: (fn) => Either.Left(value), flatMap: (fn) => Either.Left(value), getOrElse: (defaultValue) => defaultValue, isLeft: true, isRight: false, }), Right: (value) => ({ map: (fn) => Either.Right(fn(value)), flatMap: (fn) => fn(value), getOrElse: (defaultValue) => value, isLeft: false, isRight: true, }), }; // Triple class class Triple { constructor(a, b, c) { this.a = a; this.b = b; this.c = c; } map(fn) { return new Triple(fn(this.a), fn(this.b), fn(this.c)); } static of(a, b, c) { return new Triple(a, b, c); } // Example method using Maybe and Either divideBy(other) { return Maybe(this.b) .flatMap((numerator) => Maybe(other) .flatMap((denominator) => denominator !== 0 ? Either.Right(numerator / denominator) : Either.Left('Division by zero') ) ) .getOrElse(Either.Left('Invalid input')); } } // Example usage const triple = Triple.of(1, 2, 3); const result = triple.map((x) => x * 2); console.log(result); // Triple { a: 2, b: 4, c: 6 } const divisionResult = triple.divideBy(2); console.log(divisionResult); // Either.Right { value: 1 } const invalidDivisionResult = triple.divideBy(0); console.log(invalidDivisionResult); // Either.Left { value: 'Division by zero' }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_typescript">TypeScript</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-typescript hljs" data-lang="typescript">//Typescript // Maybe type // noinspection JSAnnotator type Maybe<T> = { map<U>(fn: (value: T) => U): Maybe<U>; flatMap<U>(fn: (value: T) => Maybe<U>): Maybe<U>; getOrElse(defaultValue: T): T; }; const just = <T>(value: T): Maybe<T> => ({ map: <U>(fn: (value: T) => U) => just(fn(value)), flatMap: <U>(fn: (value: T) => Maybe<U>) => fn(value), getOrElse: (_: T) => value, }); const nothing = <T>(): Maybe<T> => ({ map: <U>(_: (value: T) => U) => nothing<U>(), flatMap: <U>(_: (value: T) => Maybe<U>) => nothing<U>(), getOrElse: (defaultValue: T) => defaultValue, }); // Either type type Either<L, R> = { map<U>(fn: (value: R) => U): Either<L, U>; flatMap<U>(fn: (value: R) => Either<L, U>): Either<L, U>; getOrElse(defaultValue: R): R; isLeft: boolean; isRight: boolean; }; const left = <L, R>(value: L): Either<L, R> => ({ map: <U>(_: (value: R) => U) => left<L, U>(value), flatMap: <U>(_: (value: R) => Either<L, U>) => left<L, U>(value), getOrElse: (defaultValue: R) => defaultValue, isLeft: true, isRight: false, }); const right = <L, R>(value: R): Either<L, R> => ({ map: <U>(fn: (value: R) => U) => right<L, U>(fn(value)), flatMap: <U>(fn: (value: R) => Either<L, U>) => fn(value), getOrElse: (_: R) => value, isLeft: false, isRight: true, }); // Triple class class Triple<T> { constructor(public a: T, public b: T, public c: T) {} map<U>(fn: (value: T) => U): Triple<U> { return new Triple<U>(fn(this.a), fn(this.b), fn(this.c)); } static of<T>(a: T, b: T, c: T): Triple<T> { return new Triple<T>(a, b, c); } // Example method using Maybe and Either divideBy(other: T): Either<string, number> { return just(this.b) .flatMap((numerator) => just(other) .flatMap((denominator) => denominator !== 0 ? right(numerator / denominator) : left('Division by zero') ) ) .getOrElse(left('Invalid input')); } } // Example usage const triple = Triple.of(1, 2, 3); const result = triple.map((x) => x * 2); console.log(result); // Triple { a: 2, b: 4, c: 6 } const divisionResult = triple.divideBy(2); console.log(divisionResult); // Either.Right { value: 1 } const invalidDivisionResult = triple.divideBy(0); console.log(invalidDivisionResult); // Either.Left { value: 'Division by zero' }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_pythonpydanticpymonad">Python、pydantic、pymonad</h2> <div class="sectionbody"> <div class="paragraph"> <p>Pythonを使用して実装を作成する`pydantic`型の検証のために`pymonad`単子に対して :</p> </div> <div class="listingblock"> <div class="title">依存関係をインストールする :</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">pip install pydantic pymonad</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-python hljs" data-lang="python">from pymonad.either import Either, Left, Right from pydantic import BaseModel, ValidationError, validator # Définition de la classe Triple avec Pydantic class Triple(BaseModel): a: int b: int c: int @validator('b') def validate_b(cls, b, values): if b == 0: raise ValueError('Division by zero is not allowed') return b # Méthode utilisant Either pour la gestion des erreurs def divide_by(self, other): def division(numerator, denominator): return Right(numerator / denominator) def handle_error(error): return Left(str(error)) return Either(lambda: division(self.b, other)).or_else(handle_error) # Exemple d'utilisation try: triple = Triple(a=1, b=2, c=3) result = triple.divide_by(2) if result.is_right: print(f'Division result: {result.value}') else: print(f'Error: {result.value}') except ValidationError as e: print(f'Validation Error: {e}') except Exception as e: print(f'An unexpected error occurred: {e}')</code></pre> </div> </div> <div class="paragraph"> <p>この例では：</p> </div> <div class="ulist"> <ul> <li> <p><code>pydantic`クラスを定義する`Triple`型付きフィールドを持つ 方法`divide_by`モナドを使用する`Either</code> de <code>pymonad</code>� ゼロ除算による潜在的なエラーを処理するため - カスタム検証で値が`b`� ゼロではありません。ゼロである場合、例外が発生し、そして`pymonad`この例外をキャプチャして結果を返す`Left`エラーを示している。</p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2023/0068_introduction_google_apps_script_post.html Fri, 22 Dec 2023 00:00:00 +0000 blog/2023/0068_introduction_google_apps_script_post.html <div class="sect1"> <h2 id="_目次">目次</h2> <div class="sectionbody"> <div class="paragraph"> <p><em>読了時間 : 30分</em></p> </div> <div class="ulist"> <ul> <li> <p>はじめに</p> </li> <li> <p><a href="#Google Apps Scriptの基本構造">[Google Apps Scriptの基本構造]</a></p> </li> <li> <p>Google Apps Scriptにおける型と変数</p> </li> <li> <p><a href="#定数、変数、および文字（Google Apps Script）">[定数、変数、および文字（Google Apps Script）]</a></p> </li> <li> <p>Google Apps Scriptの演算と演算子</p> </li> <li> <p><a href="#Google Apps ScriptにおけるVar、Let、Const">[Google Apps ScriptにおけるVar、Let、Const]</a></p> </li> <li> <p><a href="#_google_apps_script_の制御構造">Google Apps Script の制御構造</a></p> </li> <li> <p><a href="#Google Apps Scriptでのループ">[Google Apps Scriptでのループ]</a></p> </li> <li> <p><a href="#_google_apps_script_のオブジェクト">Google Apps Script のオブジェクト</a></p> </li> <li> <p>Google Apps Script の関数</p> </li> <li> <p><a href="#Google Apps Script の 設定 と スコープ">[Google Apps Script の 設定 と スコープ]</a></p> </li> <li> <p><a href="#Google Apps Scriptにおけるレスト演算子とスプレッド演算子">[Google Apps Scriptにおけるレスト演算子とスプレッド演算子]</a></p> </li> <li> <p>Google Apps Script での分解による割り当て</p> </li> <li> <p><a href="#Google Apps Scriptでのコレクションと宣言的プログラミング">[Google Apps Scriptでのコレクションと宣言的プログラミング]</a></p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_はじめに">はじめに</h2> <div class="sectionbody"> <div class="paragraph"> <p>Google Apps Script (GAS) は、Google スプレッドシート、Google ドキュメント、Google フォームなどのさまざまな Google サービスに関連付けられたスクリプト開発プラットフォームです。タスクの自動化、カスタム機能の追加、Google サービスの統合を可能にします。</p> </div> <div class="paragraph"> <p>このメモでは、具体的な例を用いてGoogle Apps Scriptの主要な概念について探求します。変数、ループ、関数などの概念を取り上げ、それらをGASの特定のコンテキストに適応させます。</p> </div> </div> </div> <div class="sect1"> <h2 id="_google_apps_script_の基本構造">Google Apps Script の基本構造</h2> <div class="sectionbody"> <div class="paragraph"> <p>始めに、Google Apps スクリプトの基本構造を見てみましょう。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Structure de base en Google Apps Script */ function exempleStructureGAS() { // Votre code ici Logger.log("Hello, Google Apps Script!"); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_google_apps_script_の型と変数">Google Apps Script の型と変数</h2> <div class="sectionbody"> <div class="paragraph"> <p>Google Apps Script はプログラミング言語として JavaScript を使用します。データ型と変数は標準の JavaScript と同様に機能します。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Types et Variables en Google Apps Script */ function exempleTypesVariablesGAS() { // Votre code ici var nombre = 42; var texte = "Bonjour, Google Apps Script!"; Logger.log(nombre); Logger.log(texte); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_google_apps_script_の演算と演算子">Google Apps Script の演算と演算子</h2> <div class="sectionbody"> <div class="paragraph"> <p>Google Apps Scriptにおける演算と演算子はJavaScriptと同じです。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Opérations et Opérateurs en Google Apps Script */ function exempleOperationsGAS() { // Votre code ici var x = 10; var y = 5; var resultat = x + y; Logger.log(resultat); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_google_apps_scriptにおけるvarletconst">Google Apps Scriptにおけるvar、let、const</h2> <div class="sectionbody"> <div class="paragraph"> <p>GAS では、概念の`var`, <code>let</code>, et `const`は変数を宣言するために使用されます。ただし、それらの違いと影響を理解することが不可欠です。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Var, Let et Const en Google Apps Script */ function exempleVarLetConstGAS() { // Votre code ici // Utilisation de var var x = 10; if (true) { var x = 20; // La variable x est modifiée globalement } Logger.log(x); // Utilisation de let let y = 30; if (true) { let y = 40; // La variable y est limitée au bloc if } Logger.log(y); // Utilisation de const const z = 50; // z = 60; // Impossible de réassigner une constante Logger.log(z); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_google_apps_script_の制御構造">Google Apps Script の制御構造</h2> <div class="sectionbody"> <div class="paragraph"> <p>制御構造など`if`, <code>else</code>, <code>while</code> et `for`は、Google Apps Script で実行フローを管理するために使用されます。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Structures de Contrôle en Google Apps Script */ function exempleStructuresControleGAS() { // Votre code ici var condition = true; if (condition) { Logger.log("La condition est vraie."); } else { Logger.log("La condition est fausse."); } var compteur = 0; while (compteur < 5) { Logger.log(compteur); compteur++; } for (var i = 0; i < 3; i++) { Logger.log(i); } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_google_apps_script_の設定とスコープ">Google Apps Script の設定とスコープ</h2> <div class="sectionbody"> <div class="paragraph"> <p>パラメータとスコープはGASスクリプト開発において重要な役割を果たします。その仕組みを理解して、予期しない動作を避けてください。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Paramètres et Scopes en Google Apps Script */ function exempleParametresScopesGAS(parametre) { // Votre code ici var variableGlobale = "Je suis global"; function afficherParametre() { Logger.log(parametre); } afficherParametre(); Logger.log(variableGlobale); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_google_apps_script_の定数変数および文字">Google Apps Script の定数、変数、および文字</h2> <div class="sectionbody"> <div class="paragraph"> <p>違いを理解する`const`, <code>var</code>, et `let`これはGoogle Apps Scriptで変数を効果的に使用するために不可欠です。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Constantes, Variables, et Lettres en Google Apps Script */ function exempleConstantesVariablesLettresGAS() { // Votre code ici const constante = "Je ne change pas"; Logger.log(constante); var variable = "Je peux changer"; Logger.log(variable); let lettre = "Je peux aussi changer, mais seulement dans mon bloc"; Logger.log(lettre); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_google_apps_script_でのループ">Google Apps Script でのループ</h2> <div class="sectionbody"> <div class="paragraph"> <p>ループ、例えば`for` et <code>while</code>, 要素をイテレーションし、繰り返しの操作を行うために不可欠です。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Boucles en Google Apps Script */ function exempleBouclesGAS() { // Votre code ici for (var i = 0; i < 3; i++) { Logger.log(i); } var condition = true; var compteur = 0; while (condition) { Logger.log("Tour de boucle"); compteur++; if (compteur === 3) { condition = false; } } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_google_apps_script_のオブジェクト">Google Apps Script のオブジェクト</h2> <div class="sectionbody"> <div class="paragraph"> <p>オブジェクトはデータを構造化するために使用されます。 GASでは、多数の組み込みオブジェクトがGoogleサービスとのやり取りを容易にします。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Objets en Google Apps Script */ function exempleObjetsGAS() { // Votre code ici var feuille = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var cellule = feuille.getRange("A1"); cellule.setValue("Nouvelle valeur"); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_google_apps_scriptにおける定数変数および文字">Google Apps Scriptにおける定数、変数、および文字</h2> <div class="sectionbody"> <div class="paragraph"> <p>理解する違いの間`const`, <code>var</code>, et `let`Google Apps Script で変数を効果的に使用することは不可欠です。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Constantes, Variables, et Lettres en Google Apps Script */ function exempleConstantesVariablesLettresGAS() { // Votre code ici const constante = "Je ne change pas"; Logger.log(constante); var variable = "Je peux changer"; Logger.log(variable); let lettre = "Je peux aussi changer, mais seulement dans mon bloc"; Logger.log(lettre); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_google_apps_scriptの関数">Google Apps Scriptの関数</h2> <div class="sectionbody"> <div class="paragraph"> <p>関数はプログラミングにおける基本的な要素です。GASでは、関数をさまざまな方法で宣言および呼び出すことができます。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Fonctions en Google Apps Script */ function exempleFonctionsGAS() { // Votre code ici function additionner(a, b) { return a + b; } var resultat = additionner(2, 3); Logger.log(resultat); // Fonction anonyme var multiplier = function (x, y) { return x * y; }; Logger.log(multiplier(4, 5)); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_google_apps_scriptのレスト演算子とスプレッド演算子">Google Apps Scriptのレスト演算子とスプレッド演算子</h2> <div class="sectionbody"> <div class="paragraph"> <p>オペレーターの休憩(<code>…​</code>) と 伝播 の (<code>…​</code>)は、配列とオブジェクトを簡潔に操作するのに便利です。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Opérateurs de Repos et de Propagation en Google Apps Script */ function exempleOperateursReposPropagationGAS() { // Votre code ici // Opérateur de repos (...) pour les tableaux var nombres = [1, 2, 3, 4, 5]; var [...copieNombres] = nombres; Logger.log(copieNombres); // Opérateur de propagation (...) pour les objets var objOriginal = { x: 1, y: 2 }; var objClone = { ...objOriginal, z: 3 }; Logger.log(objClone); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_google_apps_script_による分解による割り当て">Google Apps Script による分解による割り当て</h2> <div class="sectionbody"> <div class="paragraph"> <p>分解代入は、オブジェクトや配列から値を簡潔に抽出できる強力な機能です。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Affectation par Décomposition en Google Apps Script */ function exempleAffectationDecompositionGAS() { // Votre code ici var coordonnees = [3, 4]; var [x, y] = coordonnees; Logger.log(x); Logger.log(y); var utilisateur = { nom: "John", age: 30 }; var { nom, age } = utilisateur; Logger.log(nom); Logger.log(age); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_google_apps_scriptでのコレクションと宣言型プログラミング">Google Apps Scriptでのコレクションと宣言型プログラミング</h2> <div class="sectionbody"> <div class="paragraph"> <p>Google Apps Script は、配列などのデータ構造をサポートし、関数型プログラミングおよび宣言的イテレーション（><impérative）、ような`map`, <code>reduce</code> et <code>forEach</code>。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Collections et Programmation Déclarative en Google Apps Script */ function exempleCollectionsFonctionnelleGAS() { // Votre code ici // Exemple de tableau (collection) var nombres = [1, 2, 3, 4, 5]; // Utilisation de forEach nombres.forEach(function (nombre) { Logger.log(nombre); }); // Utilisation de map var carresNombres = nombres.map(function (nombre) { return nombre * nombre; }); Logger.log(carresNombres); // Utilisation de reduce var somme = nombres.reduce(function (acc, nombre) { return acc + nombre; }, 0); Logger.log(somme); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_結論">結論</h2> <div class="sectionbody"> <div class="paragraph"> <p>このメモは、具体的なコード例を使ってGoogle Apps Scriptの基本概念を説明しました。これらの知識を使って、日常のタスクを自動化し、ドキュメントをカスタマイズし、Google Apps Scriptの機能をフルに活用してください。</p> </div> </div> </div> https://cheroliv.com/blog/2023/0067_formation_express_sur_google_forms_script_post.html Wed, 20 Dec 2023 00:00:00 +0000 blog/2023/0067_formation_express_sur_google_forms_script_post.html <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>所要時間：30分</p> </div> </div> </div> <div class="sect1"> <h2 id="_目標">目標</h2> <div class="sectionbody"> <div class="paragraph"> <p>Forms での Google Apps Script の基礎を理解する - スクリプトエディタにアクセスして、トリガーで命令を実行する方法を学ぶ</p> </div> </div> </div> <div class="sect1"> <h2 id="_遅延">遅延</h2> <div class="sectionbody"> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>Google Form スクリプト入門</strong>(5分)</p> <div class="ulist"> <ul> <li> <p>Google Form Script のクイック概要 - 主要機能の紹介</p> </li> </ul> </div> </li> <li> <p><strong>Googleフォームおよび関連スクリプトの作成</strong>(5 分)</p> <div class="ulist"> <ul> <li> <p>シンプルなフォームを Google Forms で作成 - 関連スクリプトエディターの紹介</p> </li> </ul> </div> </li> <li> <p><strong>命令を実行する</strong>(10 分)</p> <div class="ulist"> <ul> <li> <p>「on start」トリガーの設定 - トリガーの設定 "on submit - 指令を実行するスクリプトを書く - 素早いテストでジャーナル内の正常な動作を確認する</p> </li> </ul> </div> </li> <li> <p><strong>結果の分析とベストプラクティス</strong>(10分)</p> <div class="ulist"> <ul> <li> <p>指示の実行結果の検証 - スクリプトの例に関する議論と、自動化によって時間を短縮できる方法</p> </li> </ul> </div> </li> </ol> </div> </div> </div> <div class="sect1"> <h2 id="_前提条件">前提条件</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>Googleアカウントを持ち、Google FormsおよびGoogle Sheetsへのアクセスがある</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_機材">機材</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>ウェブブラウザとインターネット接続があるコンピュータ</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_注記">注記</h2> <div class="sectionbody"> <div class="paragraph"> <p>このショートトレーニングは、Google Form Scriptを使った自動化へのクイックイントロダクションを提供します。 より深い理解のために、より長い研修が推奨されます。</p> </div> </div> </div> <div class="sect1"> <h2 id="_1_google_form_スクリプトの紹介">1 - Google Form スクリプトの紹介</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_スライド_1_google_form_scriptのクイック概要">スライド 1: Google Form Scriptのクイック概要</h3> <div class="paragraph"> <p>Google Form ScriptはGoogle Forms に統合されたスクリプトプラットフォームです。 - カスタマイズ可能な機能を追加し、タスクを自動化できます。</p> </div> </div> <div class="sect2"> <h3 id="_slide_2_主要機能のプレゼンテーション">Slide 2: 主要機能のプレゼンテーション</h3> <div class="ulist"> <ul> <li> <p>スクリプトエディタ : Google Apps Script を書くための組み込みスクリプトエディタ。 - トリガー:「on submit」などのイベントがスクリプトの実行を起動する。</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_slide_3_google_form_スクリプトを使用する利点">Slide 3: Google Form スクリプトを使用する利点</h3> <div class="ulist"> <ul> <li> <p>カスタマイズ : 独自の機能を備えたカスタムフォームを作成します。 自動化：フォームの回答に応じてアクションを自動化してください。 - 統合 : スクリプトを他のGoogleサービスと統合して、より充実した体験を提供します。</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_発表者への注記">発表者への注記：</h3> <div class="paragraph"> <p>これらの機能は、フォームをカスタマイズおよび自動化するための大きな可能性を提供します。 この研修の続きでは、スクリプトと特定の自動化の作成について詳しく探ります。</p> </div> <div class="paragraph"> <p><a href="https://developers.google.com/apps-script/add-ons/editors/forms?hl=fr" class="bare">https://developers.google.com/apps-script/add-ons/editors/forms?hl=fr</a></p> </div> <div class="paragraph"> <p><a href="https://developers.google.com/apps-script/reference/forms?hl=fr" class="bare">https://developers.google.com/apps-script/reference/forms?hl=fr</a></p> </div> <div class="paragraph"> <p><a href="https://developers.google.com/apps-script/reference/forms/form-app?hl=fr" class="bare">https://developers.google.com/apps-script/reference/forms/form-app?hl=fr</a></p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_googleフォームと関連スクリプトの作成_5分">Googleフォームと関連スクリプトの作成 (5分)</h2> <div class="sectionbody"> </div> </div> https://cheroliv.com/blog/2023/0066_memo_python_post.html Sun, 19 Nov 2023 00:00:00 +0000 blog/2023/0066_memo_python_post.html <div class="sect1"> <h2 id="_windowsにpythonをインストール">WindowsにPythonをインストール</h2> <div class="sectionbody"> <div class="paragraph"> <p><a href="https://ninite.com/pythonx3/">Windows での Python</a></p> </div> <div class="paragraph"> <p><a href="https://python-docs.readthedocs.io/en/latest/starting/install3/win.html" class="bare">https://python-docs.readthedocs.io/en/latest/starting/install3/win.html</a></p> </div> <div class="paragraph"> <p><a href="https://python-docs.readthedocs.io/en/latest/dev/virtualenvs.html#virtualenvironments-ref" class="bare">https://python-docs.readthedocs.io/en/latest/dev/virtualenvs.html#virtualenvironments-ref</a></p> </div> </div> </div> <div class="sect1"> <h2 id="_pythonを実行中">Pythonを実行中</h2> <div class="sectionbody"> <div class="paragraph"> <p>\.問題点：Python venv</p> </div> <div class="listingblock"> <div class="title">参照 :</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">cd mon_projet python -m venv mon_venv source mon_venv/bin/activate # Sur windows mon_venv\Scripts\activate deactivate</code></pre> </div> </div> <div class="sect2"> <h3 id="_インストール要件">インストール要件</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">pip install -r requirements.txt</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_開始">開始</h2> <div class="sectionbody"> <div class="paragraph"> <p><a href="https://python.doctor/page-apprendre-programmation-orientee-objet-poo-classes-python-cours-debutants">Python の オブジェクト指向</a></p> </div> </div> </div> <div class="sect1"> <h2 id="_pythonでのgofのデザインパターン">PythonでのGoFのデザインパターン</h2> <div class="sectionbody"> <div class="paragraph"> <p><a href="https://github.com/whikwon/python-patterns/">実装 1</a></p> </div> <div class="paragraph"> <p><a href="https://github.com/Sean-Bradley/Design-Patterns-In-Python">実装 2</a></p> </div> <div class="paragraph"> <p><a href="https://sbcode.net/python/">完全な本</a></p> </div> <div class="paragraph"> <p>GoFのデザインパターンは、『Design Patterns: Elements of Reusable Object-Oriented Software』という書籍で説明された23のデザインパターンのセットです。</p> </div> <div class="paragraph"> <p>以下はGoFのデザインパターンの一覧です</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0849%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">名前</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">説明</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ファクトリーメソッド</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">具体的にインスタンス化するクラスを指定せずにオブジェクトを作成する。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>�抽象ファクトリー</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">具体的なクラスを指定せずに、関連または依存するオブジェクトのファミリーを作成する。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ビルダー</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">複雑なオブジェクトの構築をその表現から分離し、同じ構築プロセスで異なる表現を作成できるようにします。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>プロトタイプ</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">既存のプロトタイプをコピーして新しいオブジェクトを作成する</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>シングルトン</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">クラスのインスタンス化を1つのオブジェクトに制限します。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>アダプター</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">クラスのインターフェイスをクライアントが期待する別のインターフェイスに変換します。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>橋</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">抽象をその実装から切り離し、両者が独立して変化できるようにする。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>複合</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">オブジェクトをツリー構造に組み合わせて、部分-全体の階層を表現します。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>デコレーター</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">動的にオブジェクトに追加の責任を付ける。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ファサード</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">サブシステム内のインターフェースのセットに対して、統一されたインターフェースを提供します。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>フライウェイト</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">軽量オブジェクトの作成と使用のコストを削減します。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>プロキシ</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">別のオブジェクトへのアクセスを制御するために、そのオブジェクトの代替またはプレースホルダーを提供します。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>責任の連鎖</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">複数のオブジェクトが要求を処理できるようにします。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>コマンド</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">リクエストをオブジェクトにカプセル化し、これにより、異なるリクエスト、キュー、またはログを持つクライアントをパラメータ化し、元に戻せる操作をサポートします。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>通訳</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">言語の文法の表現を与え、その表現を使用してその言語の文を解釈する。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>イテレータ</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">集約オブジェクトの要素を、内部表現を公開することなく順に巡回する手段を提供する。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>調停者</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">オブジェクト間の複雑な依存関係を減らし、オブジェクトが仲介者オブジェクトを通じてのみ通信できるようにする。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>メメント</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">オブジェクトをその前の状態に戻す機能を提供します（カプセル化を侵害せずに）。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>観察する</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">1対多の依存関係をオブジェクト間に定義し、オブジェクトの状態が変化すると、そのすべての依存先が通知され、自動的に更新されます。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>状態</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">オブジェクトが内部状態が変わったときに振る舞いを変更できるようにする。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>戦略</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">アルゴリズムの一族を定義し、それぞれをカプセル化して交換可能にする。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>テンプレートメソッド</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">アルゴリズムのスケルトンをメソッド内で定義し、いくつかの手順をサブクラスに委譲する。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>�訪問者</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">オブジェクト構造に対して新しい操作を定義し、オブジェクトのクラスを変更せずに実行することができます。</p></td> </tr> </tbody> </table> </div> </div> <div class="sect1"> <h2 id="_関数型プログラミング">関数型プログラミング</h2> <div class="sectionbody"> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 16.6666%;"> <col style="width: 27.7777%;"> <col style="width: 55.5557%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">図書館</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">URL</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">説明</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">PyMonad</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://github.com/jasondelaat/pymonad" class="bare">https://github.com/jasondelaat/pymonad</a></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">PyMonadは、HaskellやF#などのプログラミング言語に基づいたPythonでのモナディックデータ構造の実装であり、関数型プログラミングで最も一般的に使用されるモナド型の実装を含みます。https://www.miguelfarrajota.com/2021/06/monads-in-python-with-pymonad/[記事]</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">PyFunctional</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://github.com/EntilZha/PyFunctional/" class="bare">https://github.com/EntilZha/PyFunctional/</a></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">PyFunctionalは、純粋な関数とイテラブルを扱うためのツールを提供するPython用の関数型プログラミングライブラリです。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ツールズ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://toolz.readthedocs.io/en/latest/" class="bare">https://toolz.readthedocs.io/en/latest/</a></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Toolz は、純粋な関数とイテラブルを扱うためのツールを提供する関数型プログラミング向けの Python ライブラリです。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Fn.py</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://github.com/kachayev/fn.py" class="bare">https://github.com/kachayev/fn.py</a></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Fn.pyは、純粋関数とイテラブルを扱うためのツールを提供する関数型プログラミング向けのPythonライブラリです。</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ココナッツ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://coconut-lang.org/" class="bare">https://coconut-lang.org/</a></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Coconut は Python に関数型プログラミングのためのいくつかの機能を追加し、パターンマッチングも含まれます。https://stackoverflow.com/questions/11909681/are-there-pattern-matching-functions-in-python-like-this[会話ソフ]</p></td> </tr> </tbody> </table> <div class="sect2"> <h3 id="_副作用">副作用</h3> </div> <div class="sect2"> <h3 id="_ループ">ループ</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-python hljs" data-lang="python"># impérative way result = [] for i in inputs: x = f(g(i)) result.append(x) # idiomatic way result = map(comp(f,g), inputs)</code></pre> </div> </div> </div> </div> </div> https://cheroliv.com/blog/2023/0065_training_web_dev_post.html Thu, 24 Aug 2023 00:00:00 +0000 blog/2023/0065_training_web_dev_post.html https://cheroliv.com/blog/2023/0064_training_trading_card_games_post.html Mon, 21 Aug 2023 00:00:00 +0000 blog/2023/0064_training_trading_card_games_post.html https://cheroliv.com/blog/2023/0063_memo_ts_post.html Sat, 19 Aug 2023 00:00:00 +0000 blog/2023/0063_memo_ts_post.html <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>GitHub リポジトリ:https://github.com/cheroliv/ts-codebase[ts-codebase, window="_blank]</p> </div> </div> </div> <div class="sect1"> <h2 id="toc_ts"><span class="underline">Intro typescript</span></h2> <div class="sectionbody"> <div class="olist arabic"> <ol class="arabic"> <li> <p><a href="#ts_types">TypeScriptの型</a></p> </li> <li> <p><a href="#機能">[機能]</a></p> </li> <li> <p><a href="#data_struct">データ構造</a></p> </li> <li> <p><a href="#enums_tuples">列挙型とタプル</a></p> </li> <li> <p><a href="#void_never">Void と Never</a></p> </li> <li> <p><a href="#class_interface">クラスとインターフェース</a></p> </li> <li> <p><a href="#tsconfig">tsconfig.json ファイル</a></p> </li> <li> <p><a href="#モジュール">[モジュール]</a></p> </li> <li> <p><a href="#約束">約束</a></p> </li> <li> <p>async-await</p> </li> <li> <p><a href="#ジェネリクス">[ジェネリクス]</a></p> </li> </ol> </div> <div class="paragraph"> <p>index.html</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <meta http-equiv="X-UA-Compatible" content="ie=edge" /> <title>Document</title> </head> <body> Intro typescript <script src="01_types.js"></script> <script src="02_data_structure.js"></script> <script src="03_enums_tuples.js"></script> </body> </html></code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="ts_types">TypeScriptの型</h2> <div class="sectionbody"> <div class="paragraph"> <p>01_types.ts</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-typescript hljs" data-lang="typescript">/** * Les types en typescript */ //quand le type n'est pas defini des le debut, // alors il est réassignable // c'est le type Any qui est attribué par défaut let my_var; my_var = "username"; console.assert(my_var === "username"); my_var = 11; console.assert(my_var === 11); my_var = true; console.assert(my_var === true); let age = 1; console.assert(age === 1); age = 2; // age="trois" c'est impossible // car l'inference de type a attribué le type number console.assert(age === 2); // Déclaration explicite de type let pi: Number = 3.14; console.assert(typeof pi === "number");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="関数">関数</h2> <div class="sectionbody"> <div class="paragraph"> <p>関数は再利用可能なコードブロックです。</p> </div> <div class="paragraph"> <p>例の得点 :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-typescript hljs" data-lang="typescript">const add = (a: number, b: number): number => a + b;</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="data_struct">データ構造</h2> <div class="sectionbody"> <div class="paragraph"> <p>02_data_structure.ts</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-typescript hljs" data-lang="typescript">/*** * Structure de données: * Avec le type any on peut changer * le type de la variable à tout instruction * Lorsque l'on fixe le type * alors il n'est plus possible de le changer * lors d'une assignation */ // Arrays let buddies: any[] = [ "cheroliv", "imrandeh", "issoudeh", "soumi92" ] console.assert(buddies[0] === "cheroliv"); console.assert(buddies[1] === "imrandeh"); console.assert(buddies[2] === "issoudeh"); console.assert(buddies[3] === "soumi92"); // Déclaré en type any, l'inference de type // a bien réaligné en type string console.assert(typeof buddies[0] === "string"); console.assert(typeof buddies[1] === "string"); console.assert(typeof buddies[2] === "string"); console.assert(typeof buddies[3] === "string"); let writers: (String | String | String | Number)[][] = [ ["Chrétien", "de Troyes", "fr", 12], ["François", "Rabelais", "fr", 16], ["René", "Descartes", "fr", 17], ["Jean-Jacques", "Rousseau", "fr", 18], ["Georg", "Hegel", "de", 19], ["Karl", "Marx", "de", 19], ["Friedrich", "Engels", "de", 19], ["Victor", "Hugo", "fr", 19], ["Paul", "Verlaine", "fr", 19], ["Arthur", "Rimbaud", "fr", 19], ["Gérard", "de Nerval", "fr", 19], ["Georg", "Lukacs", "hu", 20], ["Franz", "Kafka", "hu", 20], ["Antonio", "Gramsci", "it", 20], ["Domenico","Losurdo","it",20], ]; // console.table(writers); // Objects let author: { first_name: String, last_name: String, lang: String, century: Number } = { // slice(-1) renvoie le dernier élèment first_name: writers.slice(-1)[0][0] as String, last_name: writers.slice(-1)[0][1] as String, lang: writers.slice(-1)[0][2] as String, century: writers.slice(-1)[0][3] as Number, } // assertion sur la valeur en accés par encapsulation(dot) console.assert(author.first_name === "Antonio") console.assert(author.last_name === "Gramsci") console.assert(author.lang === "it") console.assert(author.century === 20); // assertion sur le type en accès par index console.assert(typeof author["first_name"] === "string") console.assert(typeof author["last_name"] === "string") console.assert(typeof author["lang"] === "string") console.assert(typeof author["century"] === "number");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="enums_tuples">列挙型とタプル</h2> <div class="sectionbody"> <div class="paragraph"> <p>03_列挙型_タプル.ts</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-typescript hljs" data-lang="typescript">/** * Enums et Tuples * * Enum: il existe les enums numérique * et les enums chaine de caracteres. * * Tuple: similaire aux arrays mais ne peut * contenir qu'une valeur de type spécifié. * */ //Enum numérique // l'index par de debut défaut est 0 // ici on le place a 1 enum Week { Monday = 1, Tuesday = 2, Wednesday = 3, Thursday = 4, Friday = 5, Saturday = 6, Sunday = 7, }; console.assert(Week.Monday == 1); console.assert(Week.Tuesday == 2); console.assert(Week.Wednesday == 3); console.assert(Week.Thursday == 4); console.assert(Week.Friday == 5); console.assert(Week.Saturday == 6); console.assert(Week.Sunday == 7); console.assert(Week[1] === "Monday"); console.assert(Week[2] === "Tuesday"); console.assert(Week[3] === "Wednesday"); console.assert(Week[4] === "Thursday"); console.assert(Week[5] === "Friday"); console.assert(Week[6] === "Saturday"); console.assert(Week[7] === "Sunday"); let motd_arr_fr: String[] = [ "Associé à la Lune", "Du dieu Tiw, associé à Mars", "Du dieu germanique Odin", "Du dieu germanique du tonnerre Thor", "De la déesse germanique Frigga associée à Vénus", "Associé à Saturne", "Associé au Soleil", ]; let motd_arr_en: String[] = [ "associated with the Moon", "from the god Tiw, associated with Mars", "from Germanic god Odin", "from Germanic god of thunder Thor", "from Germanic goddess Frigga associated with Venus", "associated with Saturn", "associated with the Sun", ]; // Un tuple (triple) let monday_triple_fr: [ Number, String, String ] = [ Week.Monday, Week[Week.Monday], motd_arr_fr[0], ]; console.assert(monday_triple_fr[0] === 1); console.assert(monday_triple_fr[1] === "Monday"); console.assert(monday_triple_fr[2] === "Associé à la Lune"); let monday_triple_en: [ Number, String, String ] = [ Week.Monday, Week[Week.Monday], motd_arr_en[0], ]; console.assert(monday_triple_en[0] === 1); console.assert(monday_triple_en[1] === "Monday"); console.assert(monday_triple_en[2] === "associated with the Moon"); // On se fait un type pour ajouter le nom de la langue type Meaning_of_the_day = { lang: String, meaning: (Week | String)[][], }; //fonction d'affichage du type Meaning_of_the_day const display_motd = (motd: Meaning_of_the_day) => { motd.meaning.forEach(day => console.table(`${Week[day[0] as Week]}: ${day[1]}.(${motd.lang})`) ) }; //fonction d'assertion sur le type Meaning_of_the_day // afin de verifier la concordance du contenu avec // motd_arr_#lang# const test_motd = ( motd: Meaning_of_the_day, motd_arr: String[] ) => { console.assert(motd.lang.length === 2) for (const [i, value] of motd.meaning.entries()) { console.assert(value[1] === motd_arr[i]); } }; let motd_fr: Meaning_of_the_day = { lang: "fr", meaning: [ [Week.Monday, motd_arr_fr[0]], [Week.Tuesday, motd_arr_fr[1]], [Week.Wednesday, motd_arr_fr[2]], [Week.Thursday, motd_arr_fr[3]], [Week.Friday, motd_arr_fr[4]], [Week.Saturday, motd_arr_fr[5]], [Week.Sunday, motd_arr_fr[6]], ], } console.log("---------"); console.log("display_motd(motd_fr):"); display_motd(motd_fr); test_motd(motd_fr, motd_arr_fr) let motd_en: Meaning_of_the_day = { lang: "en", meaning: [ [Week.Monday, motd_arr_en[0]], [Week.Tuesday, motd_arr_en[1]], [Week.Wednesday, motd_arr_en[2]], [Week.Thursday, motd_arr_en[3]], [Week.Friday, motd_arr_en[4]], [Week.Saturday, motd_arr_en[5]], [Week.Sunday, motd_arr_en[6]], ], } console.log("---------"); console.log("display_motd(motd_en):"); display_motd(motd_en); console.log("---------"); test_motd(motd_en, motd_arr_en); // Un tuple (triple) utilisant le type // Meaning_of_the_day pour peupler le meaning let motd_triple: [ Number, String, String ] = [ Week.Monday, Week[Week.Monday], motd_fr.meaning[0][1] as String ]; console.assert(motd_triple[0] === 1); console.assert(motd_triple[1] === "Monday"); console.assert(motd_triple[2] === "Associé à la Lune");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="void_never">Void と Never</h2> <div class="sectionbody"> <div class="paragraph"> <p>04_void_never_types.ts</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-typescript hljs" data-lang="typescript">// Le type void est l'opposé du type any // c'est l'absence de type. function verify_writers_length(): void { console.assert(writers.length > 0); } verify_writers_length(); const verify_writers_length_arrow = (): void => console.assert(writers.length > 0); verify_writers_length_arrow(); //Type of et never let value = 30; console.assert(typeof value === "number"); //never: qqchs qui n'arrive jamais function foo(x: String | Number): Boolean { if (typeof x === "string") { return true; } else if (typeof x === "number") { return false; } return fail("Error!") } function fail(message: String): never { throw new Error(message as string); }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="class_interface">クラスとインターフェース</h2> <div class="sectionbody"> <div class="paragraph"> <p>04_void_never_types.ts</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-typescript hljs" data-lang="typescript">/** * Les classes: * members, * visibility, * nommage, * accesseurs * scope identifier: static,private,protected * * convention de nommage : * Les membres private sont préfixés avec un _ * */ class Member { username: String = ""; email: String = ""; private _password: String = ""; readonly signup_date: Date = new Date(Date.now()); constructor(username: String, email: String) { this.username = username; this.email = email; } get password(): String { return this._password; } set password(new_password: String) { this._password = new_password; } /** * Une fonction static qui initilise un member, * à partir d'un author */ static fromAuthor(author: { first_name: String, last_name: String, lang: String, century: Number }): Member { return new Member( `${author.first_name}.${author.last_name}`, `${author.first_name}.${author.last_name}@acme.com`, ); } }; let domenico = Member.fromAuthor(author); domenico.password = "test"; console.assert(domenico.email === "Domenico.Losurdo@acme.com"); console.assert(domenico.password === "test"); // Héritage enum Forms { Undefined = 0, Polygones = 1, Circle = 2, Straight = 3, Segment = 4, }; class Form { type: Forms = Forms.Undefined; }; class Rectangle extends Form { h: Number = 0; w: Number = 0; }; class Square extends Rectangle { side: Number = 0; }; /** * Interface donne un contrat à un type. * Les interfaces permettent de définir la structure d'un objet. */ interface IPerson { username: String; email: String; readonly signup_date: Date; } const user1: IPerson = { username: Member.fromAuthor(author)["username"], email: Member.fromAuthor(author)["email"], signup_date: Member.fromAuthor(author)["signup_date"], }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="tsconfig">tsconfig.json ファイル</h2> <div class="sectionbody"> <div class="paragraph"> <p>tsconfig.json</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{ /* Visit https://aka.ms/tsconfig to read more about this file */ "compileOnSave": true, "compilerOptions": { "target": "es2016", "module": "CommonJS", "noEmitOnError": true, "strict": true, "noImplicitAny": true, "esModuleInterop": true } }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="_モジュール">モジュール<a id="モジュール"></a></h2> <div class="sectionbody"> <div class="paragraph"> <p>モジュールは、コードを複数のファイルに整理することを可能にします。</p> </div> <div class="paragraph"> <p>例の評価：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-typescript hljs" data-lang="typescript">// Dans un fichier math.ts export const add = (a: number, b: number): number => a + b; // Dans un autre fichier import { add } from './math'; let result = add(2, 3);</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="約束">約束</h2> <div class="sectionbody"> <div class="paragraph"> <p>プロミスは、非同期操作を実行するために使用されます。</p> </div> <div class="paragraph"> <p>例：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-typescript hljs" data-lang="typescript">const promise = new Promise<string>((resolve) => { // Code asynchrone ici resolve("Succès"); }); promise.then((result) => { console.log(result); });</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="async-await">async/await</h2> <div class="sectionbody"> <div class="paragraph"> <p>async/await はプロミスの処理を簡素化します。</p> </div> <div class="paragraph"> <p>例：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-typescript hljs" data-lang="typescript">const fetchData = async (): Promise<void> => { const result = await someAsyncFunction(); console.log(result); };</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="generiques">Génériques</h2> <div class="sectionbody"> <div class="paragraph"> <p>ジェネリクスを使用すると、動的な型を持つ再利用可能なコンポーネントを作成できます。</p> </div> <div class="paragraph"> <p>評価の例：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-typescript hljs" data-lang="typescript">const identity = <T>(arg: T): T => arg; const output = identity<string>("hello"); console.log(output);</code></pre> </div> </div> </div> </div> https://cheroliv.com/blog/2023/0062_memo_css_post.html Mon, 14 Aug 2023 00:00:00 +0000 blog/2023/0062_memo_css_post.html <div class="sect1"> <h2 id="toc">目次</h2> <div class="sectionbody"> <div class="olist arabic"> <ol class="arabic"> <li> <p><a href="#good_links">良いリンク</a></p> </li> <li> <p><a href="#repo">レポジトリとコードサンプル</a></p> </li> <li> <p><a href="#toc_開始"><span class="underline">開始 CSS</span></a></p> </li> </ol> </div> <div class="sect2"> <h3 id="good_links">良いリンク</h3> <div class="paragraph"> <p><a href="#toc">目次</a></p> </div> </div> <div class="sect2"> <h3 id="repo">レポジトリとコードサンプル</h3> <div class="paragraph"> <p>GitHub リポジトリ:https://github.com/cheroliv/css-codebase[css-codebase, window = "_blank]</p> </div> </div> <div class="sect2"> <h3 id="toc_開始"><span class="underline">開始 CSS</span></h3> <div class="olist arabic"> <ol class="arabic"> <li> <p><a href="#イントロ開始">[イントロ開始]</a></p> </li> <li> <p><a href="#開始テキスト">[開始テキスト]</a></p> </li> <li> <p><a href="#開始_background">[開始_background]</a></p> </li> <li> <p><a href="#開始_ボックス">[開始_ボックス]</a></p> </li> <li> <p><a href="#開始_flexbox">[開始_flexbox]</a></p> </li> <li> <p><a href="#開始_グリッド">[開始_グリッド]</a></p> </li> <li> <p><a href="#開始_絶対_位置">[開始_絶対_位置]</a></p> </li> <li> <p><a href="#開始_レスポンシブ">[開始_レスポンシブ]</a></p> </li> <li> <p><a href="#開始_結論">[開始_結論]</a></p> </li> </ol> </div> <div class="paragraph"> <p><a href="#toc">目次</a></p> </div> </div> </div> </div> <div class="sect1"> <h2 id="début_intro">イントロ & セットアップ</h2> <div class="sectionbody"> <div class="paragraph"> <p>このビデオに基づくイントロ:</p> </div> <div class="videoblock"> <div class="content"> <iframe src="https://www.youtube.com/embed/iSWjmVcfQGg?rel=0" frameborder="0" allowfullscreen></iframe> </div> </div> <div class="paragraph"> <p>GitHub リポジトリ:https://github.com/cheroliv/css-codebase/début_css/[css の開始, window = "_blank]</p> </div> <div class="paragraph"> <p>メモソース:<br> index.html</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Cours CSS</title> <link rel="stylesheet" href="style.css" /> </head> <body> <header> <h1>Les bases de CSS</h1> </header> <main> <div class="flexbox"> <h2>Flexbox</h2> <ul> <li>boite 1</li> <li>boite 2</li> <li>boite 3</li> </ul> </div> <div class="grid"> <h2>Grid</h2> <div class="grid-container"> <img src="./assets/img/css-logo.png" alt="logo css" /> <form action=""> <input type="text" id="firstname" placeholder="Prénom" /> <input type="text" id="surname" placeholder="Nom" /> <textarea cols="30" rows="10" placeholder="Ici votre message" ></textarea> <input type="submit" value="Valider" id="btn-submit" /> </form> </div> </div> <div class="absolute"> <h2>Absolute</h2> <span id="circle1"></span> <span id="circle2"></span> </div> </main> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p>スタイル.css ファイルを HTML ページにリンクする:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"></head> <link rel="stylesheet" href="style.css" /> </head></code></pre> </div> </div> <div class="paragraph"> <p><a href="#目次の開始">[目次の開始]</a></p> </div> </div> </div> <div class="sect1"> <h2 id="début_texts">テキスト</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">/* import remote de font sur l'ensemble de la feuille*/ @import url("https://fonts.googleapis.com/css2?family=Oswald:wght@500&display=swap"); /* import local de font */ @font-face { font-family: "DMSerif"; src: url(./assets/fonts/DMSerifDisplay-Regular.ttf); } /* body est le parent de toutes les balises, qu'il contient, donc je le déclare avant, pour la logique de précédence de parent */ body { /* si DMSerif n'est pas trouvé alors il se rabat sur Verdana*/ font-family: "DMSerif", Verdana; } /* va styliser toutes les balises h1, celles de body sont surchargés, par la déclaration présente */ h1 { text-transform: uppercase; /* espacement entre les lettres en pixel*/ letter-spacing: 3px; /* alignement du texte*/ text-align: center; /* Les tailles de polices doivent être en REM (rem = root em). Le REM se base pas sur l'élément parent pour obtenir sa taille mais sur l'élément racine. Ainsi 1rem prendra sa valeur de la font-size de votre document (body ou html).*/ font-size: 2.5rem; /* ombrage du texte */ text-shadow: 3px /* offset-x */ 3px /* offset-y */ 8px /* blur-radius */ #00000042/* color */; /* couleur du texte */ color: #ab0ef4; /*attibuer les polices(font): liste, ordonnée par priorité, de polices à utiliser pour mettre en forme le texte de l'élément ciblé.*/ font-family: "Oswald", sans-serif; /* surligner le text*/ text-decoration: underline; }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#目次_開始">[目次_開始]</a></p> </div> </div> </div> <div class="sect1"> <h2 id="début_background">背景</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">@import url("https://fonts.googleapis.com/css2?family=Oswald:wght@500&display=swap"); @font-face { font-family: "DMSerif"; src: url(./assets/fonts/DMSerifDisplay-Regular.ttf); } body { font-family: "DMSerif", Verdana; /* image comme background*/ background: url(./assets/img/bg.jpg) center/cover; /* 100VH = 100% de la taille de l'écran (viewport height) min afin de ne pas bloquer la possibilité d'avoir un plus grand */ min-height: 100vh; } h1 { text-transform: uppercase; letter-spacing: 3px; text-align: center; font-size: 2.5rem; text-shadow: 3px 3px 8px #00000042; color: #ab0ef4; font-family: "Oswald", sans-serif; text-decoration: underline; }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_開始"><span class="underline">開始 CSS</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="開始_boxes">ボックス (boxes)</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">@import url("https://fonts.googleapis.com/css2?family=Oswald:wght@500&display=swap"); @font-face { font-family: "DMSerif"; src: url(./assets/fonts/DMSerifDisplay-Regular.ttf); } /* *: létoile donne du style a tous les éléments. Ensuite remettre un à un les parametres par defaut afin d'eviter les stylisation inattendu.*/ * { /* surcharge de base tous les elements à padding 0*/ margin: 0; /* surcharge de base tous les elements à padding 0*/ padding: 0; } body { font-family: "DMSerif", Verdana; /* image comme background*/ background: url(./assets/img/bg.jpg) center/cover; min-height: 100vh; } h1 { text-transform: uppercase; letter-spacing: 3px; text-align: center; font-size: 2.5rem; text-shadow: 3px 3px 8px #00000042; color: #ab0ef4; font-family: "Oswald", sans-serif; text-decoration: underline; } main { background: rgba(245, 245, 245, 0.9); min-height: 500px; /* quelque soit la taille de l'écran, la boite fait toujours 90% de la taille de la page, les 10% restant sont une marge à droite, pour avoir 5% de chaque coté on ajoute une margin, tel que [0, auto]*/ width: 90%; /* haut bas prend 0, et gauche droite prend auto(center cad meme de chaque cotés)*/ margin: 0 auto; /* on ajoute des bords a notre boite*/ border: 2px solid rgb(0, 140, 255); /* on arrondis les coins de la boite*/ border-radius: 20px 20px 0 0; /* ombrage sur la boite*/ box-shadow: 0px 0px 20px 4px #81cfc6; /* marge interrieure de la boite sur tous les cotés*/ padding: 15px; } h2 { /* afin de recuprer le comportement par defaut qui a ete surchargé par l'operateur étoile*/ margin: 0; }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Cours CSS</title> <link rel="stylesheet" href="style.css" /> </head> <body> <header> <h1>Les bases de CSS</h1> </header> <main> <div class="flexbox"> <h2>Flexbox</h2> <ul> <li>boite 1</li> <li>boite 2</li> <li>boite 3</li> </ul> </div> </main> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p><a href="#目次_開始">[目次_開始]</a></p> </div> </div> </div> <div class="sect1"> <h2 id="開始_フレックスボックス">フレックスボックス</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">@import url("https://fonts.googleapis.com/css2?family=Oswald:wght@500&display=swap"); @font-face { font-family: "DMSerif"; src: url(./assets/fonts/DMSerifDisplay-Regular.ttf); } body { font-family: "DMSerif", Verdana; background: url(./assets/img/bg.jpg) center/cover; min-height: 100vh; } h1 { text-transform: uppercase; letter-spacing: 3px; text-align: center; font-size: 2.5rem; text-shadow: 3px 3px 8px #00000042; color: #ab0ef4; font-family: "Oswald", sans-serif; text-decoration: underline; } main { background: rgba(245, 245, 245, 0.9); min-height: 500px; width: 90%; margin: 0 auto; border: 2px solid rgb(0, 140, 255); border-radius: 20px 20px 0 0; box-shadow: 0px 0px 20px 4px #81cfc6; padding: 15px; } h2 { margin: 0; } /* le point permet d'acceder à la classe d'un composant*/ .flexbox { border: 2px solid skyblue; border-radius: 10px; padding: 10px; margin-top: 20px; min-height: 150px; } /* FLEXBOX */ /* Sert à répartir équitablement des éléments sur la page */ .flexbox ul { padding: 0; /* aligne les éléments enfants de ul(les li)*/ display: flex; /* reparti convenablement(équitablement les li sur la page) */ justify-content: space-around; } /* ce style concerne les li de la classe, flexbox des balises qui y font referencent*/ .flexbox li { /* suprime les boules des éléments de la list li*/ list-style: none; height: 160px; width: 160px; margin: 10px; background: turquoise; /* Centrer un unique élément verticalement et horizontalement */ display: flex; justify-content: center; align-items: center; }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Cours CSS</title> <link rel="stylesheet" href="style.css" /> </head> <body> <header> <h1>Les bases de CSS</h1> </header> <main> <div class="flexbox"> <h2>Flexbox</h2> <ul> <li>boite 1</li> <li>boite 2</li> <li>boite 3</li> </ul> </div> </main> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p><a href="#目次開始">[目次開始]</a></p> </div> </div> </div> <div class="sect1"> <h2 id="début_grid">グリッド</h2> <div class="sectionbody"> <div class="paragraph"> <p>flexbox よりも少し複雑な方法で要素を配置し、グリッド システムなどを用います。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">@import url("https://fonts.googleapis.com/css2?family=Oswald:wght@500&display=swap"); @font-face { font-family: "DMSerif"; src: url(./assets/fonts/DMSerifDisplay-Regular.ttf); } body { font-family: "DMSerif", Verdana; background: url(./assets/img/bg.jpg) center/cover; min-height: 100vh; } h1 { text-transform: uppercase; letter-spacing: 3px; text-align: center; font-size: 2.5rem; text-shadow: 3px 3px 8px #00000042; color: #ab0ef4; font-family: "Oswald", sans-serif; text-decoration: underline; } main { background: rgba(245, 245, 245, 0.9); min-height: 500px; width: 90%; margin: 0 auto; border: 2px solid rgb(0, 140, 255); border-radius: 20px 20px 0 0; box-shadow: 0px 0px 20px 4px #81cfc6; padding: 15px; } h2 { margin: 0; } .flexbox, .grid { border: 2px solid skyblue; border-radius: 10px; padding: 10px; margin-top: 20px; min-height: 150px; } .flexbox ul { padding: 0; display: flex; justify-content: space-around; } .flexbox li { list-style: none; height: 160px; width: 160px; margin: 10px; background: turquoise; display: flex; justify-content: center; align-items: center; } /* GRID */ .grid-container { display: grid; /* séparatuion de la grille en deux(à ses deux enfants), avec à gauche 30% pour l'image et à droite 70% pour le formulaire*/ grid-template-columns: 30% 70%; } /* sizing de l'image css-logo contenu dans la classe grid qui est dans le parent grid-container*/ .grid img { /* l'image remplt 80% de part de grille*/ width: 80%; margin: 20px auto; display: block; } form { display: grid; /* deux colonnes de chacune 1 fraction*/ grid-template-columns: 1fr 1fr; /* trois rangés de chacune 1 fraction*/ grid-template-rows: 1fr 1fr 1fr; /* structuration sous forme de template de notre repartition des composants enfants de la forme*/ grid-template-areas: "i1 i2"/* i1: input1, i2:input2*/ "ta ta"/*ta: text area */ "vi bt"/*vi:, bt: bouton */; } /* on donne du style sur deux éléments en meme temps en les listant avant les parentheses*/ input, textarea { margin: 5px; border: 1px solid darkblue; padding: 10px; font-size: 1.1rem; font-family: "DMSerif"; border-radius: 5px; } /* donner du style uniquement la textearea*/ textarea { /* renseigner le nommage pour le grid template area*/ grid-area: ta; height: 40px; /* empeche le cassage du style de la page en empechant le resizing de la textarea du formulaire*/ resize: none; } /* pour pointer un id d'élément html on utilise la notation préfixe # */ #btn-submit { /* renseigner le nommage*/ grid-area: bt; /* change le le symbole de curseur souris quand il survole sur le bouton*/ cursor: pointer; background: cyan; transition: 0.2s; } /* au survole(hover) de la souris le bouton change de comportement*/ #btn-submit:hover { background: darkblue; /* couleur de text du bouton devient blanc*/ color: white; }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Cours CSS</title> <link rel="stylesheet" href="style.css" /> </head> <body> <header> <h1>Les bases de CSS</h1> </header> <main> <div class="flexbox"> <h2>Flexbox</h2> <ul> <li>boite 1</li> <li>boite 2</li> <li>boite 3</li> </ul> </div> <div class="grid"> <h2>Grid</h2> <div class="grid-container"> <img src="./assets/img/css-logo.png" alt="logo css" /> <form action=""> <input type="text" id="firstname" placeholder="Prénom" /> <input type="text" id="surname" placeholder="Nom" /> <textarea cols="30" rows="10" placeholder="Ici votre message"></textarea> <input type="submit" value="Valider" id="btn-submit" /> </form> </div> </div> </main> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p><a href="#目次開始">[目次開始]</a></p> </div> </div> </div> <div class="sect1"> <h2 id="début_abs_pos">絶対位置</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">@import url("https://fonts.googleapis.com/css2?family=Oswald:wght@500&display=swap"); @font-face { font-family: "DMSerif"; src: url(./assets/fonts/DMSerifDisplay-Regular.ttf); } body { font-family: "DMSerif", Verdana; background: url(./assets/img/bg.jpg) center/cover; min-height: 100vh; } h1 { text-transform: uppercase; letter-spacing: 3px; text-align: center; font-size: 2.5rem; text-shadow: 3px 3px 8px #00000042; color: #ab0ef4; font-family: "Oswald", sans-serif; text-decoration: underline; } main { background: rgba(245, 245, 245, 0.9); min-height: 500px; width: 90%; margin: 0 auto; border: 2px solid rgb(0, 140, 255); border-radius: 20px 20px 0 0; box-shadow: 0px 0px 20px 4px #81cfc6; padding: 15px; } h2 { margin: 0; } .flexbox, .grid, .absolute { border: 2px solid skyblue; border-radius: 10px; padding: 10px; margin-top: 20px; min-height: 150px; } .flexbox ul { padding: 0; display: flex; justify-content: space-around; } .flexbox li { list-style: none; height: 160px; width: 160px; margin: 10px; background: turquoise; display: flex; justify-content: center; align-items: center; } .grid-container { display: grid; grid-template-columns: 30% 70%; } .grid img { width: 80%; margin: 20px auto; display: block; } form { display: grid; grid-template-columns: 1fr 1fr; grid-template-rows: 1fr 1fr 1fr; grid-template-areas: "i1 i2" "ta ta" "vi bt"; } input, textarea { margin: 5px; border: 1px solid darkblue; padding: 10px; font-size: 1.1rem; font-family: "DMSerif"; border-radius: 5px; } textarea { grid-area: ta; height: 40px; resize: none; } #btn-submit { grid-area: bt; cursor: pointer; background: cyan; transition: 0.2s; } #btn-submit:hover { background: darkblue; color: white; } /* ABSOLUTE */ /* Sans élément en Relative, de base, l'élément en absolute l'est par rapport au Body */ /* Il faut mettre une position relative au parent pour contraindre l'élément en absolute dans ses frontières */ .absolute { /* position relative par rapport à son parent, donc contenu dans les frontieres de son parents*/ position: relative; } #circle1 { height: 80px; width: 80px; background: skyblue; position: absolute; border-radius: 150px; top: -20px; right: -20px; } #circle2 { height: 40px; width: 40px; border-radius: 150px; background: teal; position: absolute; left: 50%; transform: /*traslate de 50% de la taille du cercle, pour etre centré par rapport au centre du cercle, plutot que sur son bord gauche par défaut.*/ translateX(-50%); top: 100px; }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Cours CSS</title> <link rel="stylesheet" href="style.css" /> </head> <body> <header> <h1>Les bases de CSS</h1> </header> <main> <div class="flexbox"> <h2>Flexbox</h2> <ul> <li>boite 1</li> <li>boite 2</li> <li>boite 3</li> </ul> </div> <div class="grid"> <h2>Grid</h2> <div class="grid-container"> <img src="./assets/img/css-logo.png" alt="logo css" /> <form action=""> <input type="text" id="firstname" placeholder="Prénom" /> <input type="text" id="surname" placeholder="Nom" /> <textarea cols="30" rows="10" placeholder="Ici votre message"></textarea> <input type="submit" value="Valider" id="btn-submit" /> </form> </div> </div> <div class="absolute"> <h2>Absolute</h2> <span id="circle1"></span> <span id="circle2"></span> </div> </main> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_début">[toc_début]</a></p> </div> </div> </div> <div class="sect1"> <h2 id="début_responsive">レスポンシブ</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">@import url("https://fonts.googleapis.com/css2?family=Oswald:wght@500&display=swap"); @font-face { font-family: "DMSerif"; src: url(./assets/fonts/DMSerifDisplay-Regular.ttf); } body { font-family: "DMSerif", Verdana; background: url(./assets/img/bg.jpg) center/cover; min-height: 100vh; } h1 { text-transform: uppercase; letter-spacing: 3px; text-align: center; /* pour etre plus responsive on peut passer la taille en vw(view port width) pour qu'elle s'adapte à la taille de l'ecran*/ font-size: 2.5rem; text-shadow: 3px 3px 8px #00000042; color: #ab0ef4; font-family: "Oswald", sans-serif; text-decoration: underline; } main { background: rgba(245, 245, 245, 0.9); min-height: 500px; width: 90%; margin: 0 auto; border: 2px solid rgb(0, 140, 255); border-radius: 20px 20px 0 0; box-shadow: 0px 0px 20px 4px #81cfc6; padding: 15px; } h2 { margin: 0; } .flexbox, .grid, .absolute { border: 2px solid skyblue; border-radius: 10px; padding: 10px; margin-top: 20px; min-height: 150px; } .flexbox ul { padding: 0; display: flex; justify-content: space-around; } .flexbox li { list-style: none; height: 160px; width: 160px; margin: 10px; background: turquoise; display: flex; justify-content: center; align-items: center; } .grid-container { display: grid; grid-template-columns: 30% 70%; } .grid img { width: 80%; margin: 20px auto; /* permet en media query de la centrer en petit écran*/ display: block; } form { display: grid; grid-template-columns: 1fr 1fr; grid-template-rows: 1fr 1fr 1fr; grid-template-areas: "i1 i2" "ta ta" "vi bt"; } input, textarea { margin: 5px; border: 1px solid darkblue; padding: 10px; font-size: 1.1rem; font-family: "DMSerif"; border-radius: 5px; } textarea { grid-area: ta; height: 40px; resize: none; } #btn-submit { grid-area: bt; cursor: pointer; background: cyan; transition: 0.2s; } #btn-submit:hover { background: darkblue; color: white; } .absolute { position: relative; } #circle1 { height: 80px; width: 80px; background: skyblue; position: absolute; border-radius: 150px; top: -20px; right: -20px; } #circle2 { height: 40px; width: 40px; border-radius: 150px; background: teal; position: absolute; left: 50%; transform: translateX(-50%); top: 100px; } /* RESPONSIVE: a partir des tailles d'ecran permet de surcharger les reglages definis plus haut */ @media screen and (max-width: 900px) { .grid-container { display: block; } .grid-container img { width: 40%; } } @media screen and (max-width: 610px) { .flexbox ul { flex-direction: column; align-items: center; } form { grid-template-columns: 1fr; grid-template-rows: 1fr; grid-template-areas: "i1" "i2" "ta" "bt"; } input, textarea { font-size: 0.8rem; } }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Cours CSS</title> <link rel="stylesheet" href="style.css" /> </head> <body> <header> <h1>Les bases de CSS</h1> </header> <main> <div class="flexbox"> <h2>Flexbox</h2> <ul> <li>boite 1</li> <li>boite 2</li> <li>boite 3</li> </ul> </div> <div class="grid"> <h2>Grid</h2> <div class="grid-container"> <img src="./assets/img/css-logo.png" alt="logo css" /> <form action=""> <input type="text" id="firstname" placeholder="Prénom" /> <input type="text" id="surname" placeholder="Nom" /> <textarea cols="30" rows="10" placeholder="Ici votre message"></textarea> <input type="submit" value="Valider" id="btn-submit" /> </form> </div> </div> <div class="absolute"> <h2>Absolute</h2> <span id="circle1"></span> <span id="circle2"></span> </div> </main> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_開始"><span class="underline">開始 CSS</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="début_conclusion">デバッグ & 結論</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">/* all elements: supprime les comportements par défaut*/ * { /* les marges à zéro*/ margin: 0; /* les parge internes(padding) à zéro*/ padding: 0; /* tous les bords avec un cadre rouge de 2px. qui est ou et qui fait quoi...*/ border: 2px solid red; }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#目次_開始">[目次_開始]</a></p> </div> </div> </div> https://cheroliv.com/blog/2023/0061_memo_html_post.html Sun, 13 Aug 2023 00:00:00 +0000 blog/2023/0061_memo_html_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_良いリンク">良いリンク</a></li> <li><a href="#_リポジトリとコードサンプル">リポジトリとコードサンプル</a></li> </ul> </div> <div class="sect1"> <h2 id="_良いリンク">良いリンク</h2> <div class="sectionbody"> <div class="ulist"> <div class="title">html</div> <ul> <li> <p><a href="https://htmlcheatsheet.com" target=""_blank">htmlcheatsheet.com</a>: HTMLチートシート</p> </li> </ul> </div> <div class="ulist"> <div class="title">フォント</div> <ul> <li> <p><a href="https://fontawesome.com">fontawesome.com</a>: アイコンライブラリ</p> </li> <li> <p><a href="https://www.toptal.com/designers/htmlarrows/symbols/" target=""_blank">toptal.com/designers/htmlarrows/symbols</a>: HTMLのネイティブアイコン</p> </li> </ul> </div> <div class="ulist"> <div class="title">特殊文字とエスケープ</div> <ul> <li> <p><a href="https://www.sonarsource.com/blog/encoding-differentials-why-charset-matters/" class="bare">https://www.sonarsource.com/blog/encoding-differentials-why-charset-matters/</a></p> </li> <li> <p><a href="https://stackoverflow.com/a/3614344/13104550" class="bare">https://stackoverflow.com/a/3614344/13104550</a></p> </li> <li> <p><a href="https://html.spec.whatwg.org/multipage/named-characters.html" class="bare">https://html.spec.whatwg.org/multipage/named-characters.html</a></p> </li> </ul> </div> <div class="paragraph"> <p><a href="#toc">[toc]</a></p> </div> </div> </div> <div class="sect1"> <h2 id="_リポジトリとコードサンプル">リポジトリとコードサンプル</h2> <div class="sectionbody"> <div class="paragraph"> <p>GitHub リポジトリ:https://github.com/cheroliv/html-codebase[html-codebase, window = "_blank]</p> </div> <div class="paragraph"> <p>メモ ソース:<br> index.html</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <!-- Le titre de la page --> <title>Cours HTML</title> <!-- Icone de l'onglet --> <link rel="shortcut icon" href="html-logo.png" /> <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.8.2/css/all.css" /> </head> <body> <header> <h1>Texte - Titre H1</h1> <p> <em>em pour mettre en italique</em>, <strong>strong pour mettre en gras</strong> <span>L'élement en span ne revient pas à la ligne</span>. </p> <p> Lorem ipsum dolor sit amet consectetur adipisicing elit. Exercitationem cumque ratione veniam officiis nulla a debitis at facilis sed dignissimos. </p> </header> <section> <div> <h2>Photo - Titre H2</h2> <img src="./img-1.jpg" alt="image-arbre" height="200" /> </div> <div> <h3>Liste - Titre H3</h3> <ul> <li>UL = unordered list</li> <li>UL = unordered list</li> <li>UL = unordered list</li> </ul> <ol> <li>OL = ordered list</li> <li>OL = ordered list</li> <li>OL = ordered list</li> </ol> </div> <div> <h4>Tableaux - Titre H4</h4> <table border="4" cellpadding="10" cellspacing="4" style="text-align: center"> <thead> <tr> <th>Col 1</th> <th>Col 2</th> <th>Col 3</th> </tr> </thead> <tbody> <tr> <td rowspan="2">Row 1 Cell 1</td> <td>Row 1 Cell 2</td> <td>Row 1 Cell 3</td> </tr> <tr> <td>Row 2 Cell 2</td> <td>Row 2 Cell 3</td> </tr> <tr> <td colspan="3">Row 3 Cell 1</td> </tr> </tbody> </table> </div> <div> <h5><span>♖</span> Liens - Titre H5</h5> <a href="https://htmlcheatsheet.com/" target="_blank">HTML Cheatsheet</a> <br /> <a href="https://www.toptal.com/designers/htmlarrows/symbols/" target="_blank">Icones natifs en HTML</a> </div> <div> <h6><i class="fas fa-video"></i> Vidéo - Titre H6</h6> <video src="video.mp4" height="150" autoplay loop muted></video> </div> </section> <br /> <!-- Formulaires en HTML --> <section> <h2>Formulaire</h2> <form action="/action.php" method="post"> <label for="name">Nom</label> <input id="name" type="text" placeholder="Entrez votre nom" /><br /> <label for="number">Entrez votre age</label> <input type="number" id="number-age" value="15" oninput="document.getElementById('range-age').value=this.value"> <input type="range" id="range-age" min="0" max="100" oninput="document.getElementById('number-age').value=this.value"><br /> <!-- Input select --> <label for="gender">Genre</label> <select id="gender"> <option selected="selected" value="Homme">Homme</option> <option value="Femme">Femme</option> </select><br /> <!-- Input radio --> <div> <input type="radio" name="type" id="human" checked /> <label for="human">Humain</label> <input type="radio" name="type" id="dog" /> <label for="dog">Chien</label> <input type="radio" name="type" id="cat" /> <label for="cat">Chat</label> </div> <textarea cols="20" rows="5" placeholder="Votre message..."></textarea><br /> <!-- Input Checkbox --> <label><input type="checkbox" />Accepter les CGV</label> <br /> <input type="submit" value="Submit" /> </form> </section> <br /> <!-- Mail & envoi de fichiers --> <footer> <a href="mailto:fs@gmail.com">Ecrivez-moi !</a> <br /> <a href="notice.txt" download="nom-du-fichier">Télécharger la notice</a> <details> <summary>Plus d'infos</summary> <p> Lorem ipsum dolor, sit amet consectetur adipisicing elit. Harum, repellendus. </p> </details> </footer> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc">[toc]</a></p> </div> </div> </div> https://cheroliv.com/blog/2023/0060_memo_js_post.html Fri, 4 Aug 2023 00:00:00 +0000 blog/2023/0060_memo_js_post.html <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>githubリポジトリ:https://github.com/cheroliv/js-codebase[js-codebase, window="_blank]</p> </div> </div> </div> <div class="sect1"> <h2 id="toc_js"><span class="underline">Intro Javascript</span></h2> <div class="sectionbody"> <div class="olist arabic"> <ol class="arabic"> <li> <p><a href="#start">変数, 算術演算子 と 文字列</a></p> </li> <li> <p><a href="#arrays">配列</a></p> </li> <li> <p><a href="#functions">関数</a></p> </li> <li> <p><a href="#param_x_scope">パラメータとスコープ</a></p> </li> <li> <p><a href="#objects">オブジェクト</a></p> </li> <li> <p><a href="#ループ">[ループ]</a></p> </li> <li> <p><a href="#const_var_let">Const、varおよびlet</a></p> </li> <li> <p><a href="#rest_and_spread_operators">Rest と spread operators</a></p> </li> <li> <p><a href="#分解">[分解]</a></p> </li> <li> <p><a href="#import_export">モジュールのインポートとエクスポート</a></p> </li> <li> <p><a href="#classes">クラスの使用</a></p> </li> </ol> </div> <div class="paragraph"> <p>index.html</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8"> <title>Document</title> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <meta http-equiv="X-UA-Compatible" content="ie=edge" /> </head> <body> index <script src="01_start.js"></script> <script src="02_arrays.js"></script> <script src="03_functions.js"></script> <script src="04_param_x_scope.js"></script> <script src="05_objects.js"></script> <script src="06_loops.js"></script> <script src="07_const_var_let.js"></script> <script src="08_rest_and_spread_operators.js"></script> <script src="09_destructuring.js"></script> <script src="10_module_import_export.js"></script> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Intro Javascript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="start">変数, 算術演算子 と 文字列</h2> <div class="sectionbody"> <div class="paragraph"> <p>01_start.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Variables */ //une variable stupide var my_variable = "dummy variable"; console.log(my_variable); //assertion console.assert(my_variable === "dummy variable"); var username = "cheroliv"; console.log(username); console.assert(username === "cheroliv"); //concaténation de string console.assert(username === "cher" + "oliv"); /** * Opérateur arithmétique: + - * / % */ //integer var x = 10; var y = 5; var z = 20; console.log(x + y); console.assert(x + y === 15); console.log(x + y - z); console.assert(x + y - z === -5); console.log(x - y); console.assert(x - y === 5); console.log(x * y); console.assert(x * y === 50); console.log(x / y); console.assert(x / y === 2); console.log("---------"); x = 20; y = 10; console.log(x + y); console.assert(x + y === 30); console.log(x + y - z); console.assert(x + y - z === 10); console.log(x - y); console.assert(x - y === 10); console.log(x * y); console.assert(x * y === 200); console.log(x / z); console.assert(x / z === 1); //Littéraux de gabarits pour string avec backstick ` //Template literals (Template strings) console.assert(`typeof z: ${typeof z}` === "typeof z: number"); console.log(`x is type of : ${typeof x}`); console.log(`y is type of : ${typeof y}`); console.log(`z is type of : ${typeof z}`); //typeof: donne le type de la variable console.assert(typeof x === "number"); console.assert(typeof y === "number"); console.assert(typeof z === "number"); console.log("---------"); /** * Incrémenation/décrémentation */ //incrémantation/décrémentation préfixe console.log(++x) //incrémenté puis affiché: 21 console.log(x) //la valeur incrémenté: 21 //incrémantation/décrémentation suffixe console.log(y++) //affiche la valeur sans incrémenation puis incrémente: 10 console.log(y) //la valeur incrémenté: 11 //décrémentation x--; y--; console.assert(x === 20); console.assert(y === 10); /** * String: chaine de caractères */ console.log(`username: ${username}`); //taille de la string console.log(`username.length: ${username.length}`); console.assert(username.length === 8); console.assert(username.length === "cheroliv".length); console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Intro Javascript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="arrays">配列</h2> <div class="sectionbody"> <div class="paragraph"> <p>02_arrays.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Les arrays */ // auteurs [["nom ", "prénom", "pays"]] var writers = [ ["Karl", "Marx", "de"], ["Jean-Jacques", "Rousseau", "fr"], ["Victor", "Hugo", "fr"], ["René", "Descartes", "fr"], ["Paul", "Verlaine", "fr"], ["Antonio", "Gramsci", "it"], ["Georg", "Lukacs", "hu"], ["Franz", "Kafka", "hu"], ["Arthur", "Rimbaud", "fr"], ["Gérard", "de Nerval", "fr"], ["Chrétien", "de Troyes", "fr"], ["François", "Rabelais", "fr"], ["Georg", "Hegel", "de"], ["Friedrich", "Engels", "de"], ] console.table(writers); // accés aux élèments du tableau console.log(writers[0]); console.log(`${writers[0][0]}, ${writers[0][1]} (${writers[0][2]})`); console.assert("Karl, Marx (de)" === `${writers[0][0]}, ${writers[0][1]} (${writers[0][2]})`); //sauvegarder la valeur du prénom de Marx var karl = writers[0][0] //éditer un élement du tableau, le prénom de Marx writers[0][0] = "Karlito" console.log(`${writers[0][0]}, ${writers[0][1]} (${writers[0][2]})`); console.assert("Karlito, Marx (de)" === `${writers[0][0]}, ${writers[0][1]} (${writers[0][2]})`); console.assert("Karl" === karl); //remettre la valeur initale du prénom de Marx writers[0][0] = karl; console.assert(`${karl}, Marx (de)` === `${writers[0][0]}, ${writers[0][1]} (${writers[0][2]})`); console.log("---------"); /** * Arrays: map/forEach/pop/push/slice/sort/shift/unshift */ var numbers = [1, 5, 4, 3, 2]; console.log("Iterate with forEach"); // parcourir avec array.forEach numbers.forEach((it) => console.log(it)); console.log("---------"); console.log("Iterate with map"); // parcourir avec array.map numbers.map((it) => console.log(it)); console.log("---------"); //afficher les éléments sur une ligne //génère la string avec le formatage des nombres const numbersString = (numberArray) => { var consoleOutput = new String(); numberArray.forEach(number => consoleOutput += `${number}, `); return consoleOutput = consoleOutput.substring(0, consoleOutput.length - 2); }; //affiche la chaine entre crochets dans la console const displayNumbers = (numbersStr) => { console.log(`[${numbersString(numbersStr)}]`); }; console.log("orginal number array") displayNumbers(numbers); console.log("---------"); //push: ajoute à la fin console.log("push"); numbers.push(6); displayNumbers(numbers); console.log("---------"); //pop: suprime le dernier console.log("pop"); numbers.pop(); displayNumbers(numbers); console.log("---------"); //unshift: ajouter le parametre au debut de l'array console.log("unshift"); numbers.unshift(0); displayNumbers(numbers); console.log("---------"); //shift: supprime le premier element de l'array console.log("shift"); numbers.shift(); displayNumbers(numbers); console.log("---------"); //slice: renvoi l'array entre les positions en argument console.log("slice"); var sliceNumbersResult = numbers.slice(2, 4); displayNumbers(sliceNumbersResult); console.log("---------"); //sort asc console.log("sort asc"); var ascSort = numbers.sort((a, b) => a - b); displayNumbers(ascSort); console.log("---------"); //sort desc console.log("sort desc"); var descSort = numbers.sort((a, b) => b - a); displayNumbers(descSort); console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Intro Javascript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="functions">関数</h2> <div class="sectionbody"> <div class="paragraph"> <p>03_functions.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Les fonctions */ //function style legacy function sayHelloWorldLegacy() { console.log("Hello world legacy!"); } sayHelloWorldLegacy(); function sayHelloLegacy(firstName, lastName, style) { console.log(`Hello ${firstName}, ${lastName} (${style})`); } sayHelloLegacy("Cher", "Oliv", "legacy"); console.log("---------"); //function style arrow const sayHelloWorld = () => console.log("Hello world!"); sayHelloWorld(); const sayHello = (firstName, lastName) => console.log(`Hello ${firstName}, ${lastName}`); sayHello("Cher", "Oliv"); console.log("---------"); var authors = [ ["Chrétien", "de Troyes", "fr"], ["François", "Rabelais", "fr"], ["René", "Descartes", "fr"], ["Jean-Jacques", "Rousseau", "fr"], ["Georg", "Hegel", "de"], ["Karl", "Marx", "de"], ["Friedrich", "Engels", "de"], ["Victor", "Hugo", "fr"], ["Paul", "Verlaine", "fr"], ["Antonio", "Gramsci", "it"], ["Georg", "Lukacs", "hu"], ["Franz", "Kafka", "hu"], ["Arthur", "Rimbaud", "fr"], ["Gérard", "de Nerval", "fr"], ] const displayAuthors = (authorsArray) => authorsArray.forEach(author => console.log(`${author[0]} ${author[1]}, (${author[2]})`) ); displayAuthors(authors); console.log("---------"); /** * valeur par défaut des parametres d'une fonctions */ const add = (a = 0, b = 0) => a + b; console.assert(add() === 0) console.assert(add(1) === 1) console.assert(add(1, 1) === 2) console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Intro Javascript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="param_x_scope">パラメータとスコープ</h2> <div class="sectionbody"> <div class="paragraph"> <p>04_param_x_scope.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">//global scope: visible partout, dans et hors functions var global; const foo = () => { //local scope: visible uniquement dans la fonction foo var bar = "bar" console.log(bar) } foo(); console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Intro Javascript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="objects">オブジェクト</h2> <div class="sectionbody"> <div class="paragraph"> <p>05_objects.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Les objects */ var authors = [ ["Chrétien", "de Troyes", "fr"], ["François", "Rabelais", "fr"], ["René", "Descartes", "fr"], ["Jean-Jacques", "Rousseau", "fr"], ["Georg", "Hegel", "de"], ["Karl", "Marx", "de"], ["Friedrich", "Engels", "de"], ["Victor", "Hugo", "fr"], ["Paul", "Verlaine", "fr"], ["Antonio", "Gramsci", "it"], ["Georg", "Lukacs", "hu"], ["Franz", "Kafka", "hu"], ["Arthur", "Rimbaud", "fr"], ["Gérard", "de Nerval", "fr"], ]; var hugo = { firstName: authors[7][0], lastName: authors[7][1], country: authors[7][2], }; var book = { author: hugo, title: "Les misérables" }; console.log(hugo); console.log(book); //accéder à un membre de l'objet par point console.log(hugo.country); //accéder à un membre de l'objet par crochet console.log(book["title"]); console.log(book.author.lastName); console.log(book["author"]["firstName"]); //ajouter une clé a un objet hugo.gender = "non binary"; console.assert(hugo.gender === "non binary"); //mettre à jour une clé hugo.gender = "male"; console.assert(hugo.gender !== "non binary"); console.assert(hugo["gender"] === "male"); //supprimer une clé delete hugo.gender; //verfier que l'objet ne contient pas la clé gender console.assert(!Object.keys(hugo).includes("gender")); console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Intro Javascript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="loops">ループ</h2> <div class="sectionbody"> <div class="paragraph"> <p>06_loops.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Les boucles: Itérer sur arrays et objets. */ console.log("for loop over array"); var numbers = [12, 10, 8, 6, 4, 2, 0]; for (number of numbers) { console.log(number); } console.log("---------"); console.log("for loop over object key"); var obj = { a: 1, b: 2, c: 3, d: 4 }; for (key in obj) { console.log(key); } console.log("---------"); console.log("for loop over object value"); for (value in obj) { console.log(obj[value]); } console.log("---------"); console.log("another for loop over authors array") var authors = [ ["Chrétien", "de Troyes", "fr"], ["François", "Rabelais", "fr"], ["René", "Descartes", "fr"], ["Jean-Jacques", "Rousseau", "fr"], ["Georg", "Hegel", "de"], ["Karl", "Marx", "de"], ["Friedrich", "Engels", "de"], ["Victor", "Hugo", "fr"], ["Paul", "Verlaine", "fr"], ["Antonio", "Gramsci", "it"], ["Georg", "Lukacs", "hu"], ["Franz", "Kafka", "hu"], ["Arthur", "Rimbaud", "fr"], ["Gérard", "de Nerval", "fr"], ]; for (const [i, value] of authors.entries()) { console.log(`${value[0]}, ${value[1]} (${value[2]})`); } console.log("---------"); console.log("while loop over array") var i = 0 while (i < authors.length) { console.log(`${authors[i][0]}, ${authors[i][1]} (${authors[i][2]})`); i++; } console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Intro Javascript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="const_var_let">Const、varおよびlet</h2> <div class="sectionbody"> <div class="paragraph"> <p>07_const_var_let.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * const X var X let */ //var x du if n'est pas confiné au scope du if const varTest = () => { var x = 1; console.log(x); console.assert(x === 1); if (true) { var x = 2; console.log(x); console.assert(x === 2); } console.log(x); console.assert(x !== 1); console.assert(x === 2); } varTest(); console.log("---------"); //var x est global à tous les fichier js //chargés dans la page html //var x issue du fichier 1_start.js //ligne 46 console.log(x); console.assert(x === 20); console.log("---------"); //premier let x est confiné au scope de la fonction //le let x du if est confiné au scope du if const letTest = () => { let x = 1; console.log(x); console.assert(x === 1); if (true) { let x = 2; console.log(x); console.assert(x === 2); } console.log(x); console.assert(x === 1); console.assert(x !== 2); } letTest(); console.log("---------"); /** * const: déclare un emplacement mémoire non réattribuable * c'est modifiable pour un array, * mais non réinitialisable; * ex: * const arr = [25, 27, 29] * arr = [5, 7] //impossible * arr[0]=20 // possible * ex: * const n = 1; * n = 3; //impossible */ const arr = [25, 27, 29] console.table(arr); arr[0] = 20 // possible console.table(arr); arr.pop() console.table(arr); console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Intro Javascript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="rest_and_spread_operators">Rest と spread operators</h2> <div class="sectionbody"> <div class="paragraph"> <p>08_rest_and_spread_operators.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Opérateur de rest: * const add = (...operandes) => a + b; * ou avec parametres avec valeur par défaut * const add = (a=0, b=0, ...operandes) => a + b; */ /** * spread opérateur: * récupère l'ensemble des elements d'une collection, * dans un array */ const user_ages = [25, 56, 12, 58, 41, 62, 26]; const max_user_age = Math.max(...user_ages); const min_user_age = Math.min(...user_ages); console.assert(max_user_age == 62); console.assert(min_user_age == 12); console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Intro Javascript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="destructuring">分割代入</h2> <div class="sectionbody"> <div class="paragraph"> <p>09_destructuring.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * L'affectation par décomposition (destructuring) */ const user = { first_name: "Oliv", last_name: "Cher", nick_name: "cheroliv", gender: "male", is_adult: true }; console.log(user); //première façon d'initaliser des variables sans destructuration let first_name_legacy = user.first_name; let last_name_legacy = user.last_name; let nick_name_legacy = user.nick_name; let gender_legacy = user.gender; let is_adult_legacy = user.is_adult; console.assert("Oliv" === first_name_legacy); console.assert("Cher" === last_name_legacy); console.assert("cheroliv" === nick_name_legacy); console.assert("male" === gender_legacy); console.assert(true === is_adult_legacy); console.log("---------"); /** * Initialisation par déstructuration */ const { first_name, last_name, nick_name, gender, is_adult } = user; console.assert(user.first_name === first_name); console.assert(user.last_name === last_name); console.assert(user.nick_name === nick_name); console.assert(user.gender === gender); console.assert(user.is_adult === is_adult); /** * Intialisation par déstructuration des arrays */ //cible explicite const [a1, a2] = [15, 25, 17, 81, 51, 46]; console.assert(a1 === 15); console.assert(a2 === 25); //cible avec position par rapport aux index par virgules //je veux b3 à 46 const [b1, b2, , , , b3] = [15, 25, 17, 81, 51, 46]; console.assert(b1 === 15); console.assert(b2 === 25); console.assert(b3 === 46); //déstructuration avec operateur de rest // je contruit un autre avec avec les elements // à partir du premier élèment non destructuré const [c1, c2, ...sub_arr] = [15, 25, 17, 81, 51, 46]; console.assert(b1 === 15); console.assert(b2 === 25); console.assert(sub_arr.length === 4); console.assert(sub_arr[0] === 17); console.assert(sub_arr[1] === 81); console.assert(sub_arr[2] === 51); console.assert(sub_arr[3] === 46); // Une boucle pour comparer le resultat attendu for (const [i, value] of[15, 25, 17, 81, 51, 46].entries()) { //on reconstruit le tableau à chaque iteration console.assert([c1, c2].concat(sub_arr)[i] === value); }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Intro Javascript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="import_export">モジュールのインポートとエクスポート</h2> <div class="sectionbody"> <div class="paragraph"> <p>10_module_import_export.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Import et export de module * * Dans le fichier html * au niveau de la balise d'import de script * spécifier le type module * * 1er technique: import nommé des fonctions: * import { sum, minus, times, div, rem } from "./dummy_math_functions.js"; * * 2eme technique: import global des fonction avec l'asterisque(*) * en préfixant l'import par un nommage du fichier importé: * import * as math from "./dummy_math_functions.js"; * * 3eme technique: import par alias avec le mot clé "as" * import { * sum as add, * minus as substract, * times as multiply, * div as divide, * rem as modulo * } from "./dummy_math_functions.js"; */ import { sum, minus, times, div, rem } from "./dummy_math_functions.js"; console.assert(sum(1, 1) === 2); console.assert(minus(4, 2) === 2); console.assert(times(2, 2) === 4); console.assert(div(4, 2) === 2); console.assert(rem(4, 2) === 0);</code></pre> </div> </div> <div class="paragraph"> <p>dummy_math_functions.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">//sum const sum = (x, y) => x + y; // subtraction const minus = (x, y) => x - y; // multiplication const times = (x, y) => x * y; // division const div = (x, y) => x / y; // remainder: reste de la division euclidiene const rem = (x, y) => x % y; // log sum const sum_log = (x, y) => console.log(sum(x, y)); // log subtraction const minus_log = (x, y) => console.log(minus(x, y)); // log multiplication const times_log = (x, y) => console.log(times(x, y)); // log division const div_log = (x, y) => console.log(div(x, y)); // log remainder const rem_log = (x, y) => console.log(rem(x, y)); export { sum, minus, times, div, rem, sum_log, minus_log, times_log, div_log, rem_log };</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Intro Javascript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="classes">クラスの使用</h2> <div class="sectionbody"> <div class="paragraph"> <p>11_classes.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">/** * Utilisation des classes */ //creation d'un objet class Account { constructor(username) { this.username = username; } }; const acc1 = new Account("cheroliv"); console.table(acc1); console.assert(acc1.username === "cheroliv"); console.log("---------"); //création d'un objet et ajout de getter et setter(accesseurs) class AccountInfo { constructor(username) { this._username = username; } get username() { return this._username; } /** * @param {(arg0: string) => void} new_username */ set new_username(new_username) { this._username = new_username; } }; const acc_info1 = new AccountInfo("cheroliv"); console.table(acc_info1); //accés au membre _username avec le getter username() console.assert(acc_info1.username === "cheroliv"); //update la valeur username de acc_info1 avec le setter acc_info1.new_username = "imrandeh"; console.assert(acc_info1.username === "imrandeh"); console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Intro Javascript</span></a></p> </div> </div> </div> https://cheroliv.com/blog/2022/0054_memo_cadrage_post.html Sat, 31 Dec 2022 00:00:00 +0000 blog/2022/0054_memo_cadrage_post.html <div class="sect1"> <h2 id="_フレーミング">フレーミング</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_アトリエ_1_ビジョン">アトリエ 1 : ビジョン</h3> <div class="sect3"> <h4 id="_パターンqqoqcp_誰何どこいつどのようになぜ">パターン「QQOQCP」 – 誰、何、どこ、いつ、どのように、なぜ</h4> </div> <div class="sect3"> <h4 id="_2_product_vision_board">2. Product Vision Board</h4> <div class="sect4"> <h5 id="_対象グループ">対象グループ</h5> <div class="paragraph"> <p>製品またはオファーを使用しているユーザーは誰ですか？ （直接、間接）</p> </div> </div> <div class="sect4"> <h5 id="_必要">必要</h5> <div class="paragraph"> <p>アプリケーションのキーユーザーの5つの主要なニーズとは何ですか？</p> </div> </div> <div class="sect4"> <h5 id="_製品">製品</h5> <div class="paragraph"> <p>私の価値提案は何ですか？ 製品の主要な5つの機能で、何に応えることができるのは 必要</p> </div> </div> <div class="sect4"> <h5 id="_ビジネスゴール">ビジネスゴール</h5> <div class="paragraph"> <p>成功の基準は何ですか？</p> </div> </div> <div class="sect4"> <h5 id="_ビジョン">ビジョン</h5> <div class="paragraph"> <p>4つの列が完成したら、Product Visionのビジョン部分を入力する必要があります。 Boardを一文で表す。</p> </div> </div> </div> </div> <div class="sect2"> <h3 id="_ワークショップ_2_ペルソナユーザージャーニー">ワークショップ 2: ペルソナ/ユーザージャーニー</h3> <div class="ulist"> <div class="title">各ペルソナに対してユーザージャーニーを定義する:</div> <ul> <li> <p>誰が私のサービスを利用しますか？（対象）</p> </li> <li> <p>彼は何をしたいですか？(しかし)</p> </li> <li> <p>彼はどうやってやるつもりですか？ (ユーザージャーニー)</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_ワークショップ_3_ゾーニング_ストーリーボード_サイトマップ">ワークショップ 3: ゾーニング, ストーリーボード, サイトマップ</h3> <div class="sect3"> <h4 id="_1_ゾーニング">1. ゾーニング</h4> </div> <div class="sect3"> <h4 id="_2_ストーリーボード">2. ストーリーボード</h4> </div> <div class="sect3"> <h4 id="_3_サイトマップ">3. サイトマップ</h4> </div> </div> <div class="sect2"> <h3 id="_ワークショップ4_ワイヤーフレームムードボード">ワークショップ4: ワイヤーフレーム/ムードボード</h3> <div class="sect3"> <h4 id="_1_ワイヤーフレーム">1. ワイヤーフレーム</h4> </div> <div class="sect3"> <h4 id="_2_ムードボード">2. ムードボード</h4> </div> </div> <div class="sect2"> <h3 id="_ワークショップ5_ストーリー_マッピング_ユーザーストーリー">ワークショップ5: ストーリー マッピング/ ユーザーストーリー</h3> <div class="sect3"> <h4 id="_ストーリーマッピングusの優先順位">ストーリーマッピング(USの優先順位)</h4> </div> <div class="sect3"> <h4 id="_type_dutilisateurとしてobjective_が欲しいreason_ために"><type d’utilisateur>として、<objective> が欲しい。<reason> ために。</h4> </div> </div> <div class="sect2"> <h3 id="_ワークショップ_6_バックログ">ワークショップ 6: バックログ</h3> <div class="paragraph"> <p><a href="https://www.atlassian.com/fr/agile/scrum/backlogs">バックログ</a></p> </div> </div> <div class="sect2"> <h3 id="_アトリエ_7_テクニックと建築">アトリエ 7: テクニックと建築</h3> </div> </div> </div> https://cheroliv.com/blog/2022/0053_memo_kotlin_post.html Sun, 29 May 2022 00:00:00 +0000 blog/2022/0053_memo_kotlin_post.html <div class="sect1"> <h2 id="_良いリンク">良いリンク</h2> <div class="sectionbody"> <div class="paragraph"> <p><a href="https://play.kotlinlang.org/">kotlinlang プレイグラウンド</a>+</p> </div> <div class="paragraph"> <p><a href="https://arrow-kt.io/">arrow.kt</a>+</p> </div> <div class="paragraph"> <p><a href="https://arkivanov.github.io/MVIKotlin/">MVI:モデル ビュー インテント</a>+</p> </div> <div class="paragraph"> <p><a href="https://github.com/arkivanov/Essenty">エッセンティ</a>+</p> </div> <div class="paragraph"> <p><a href="https://arkivanov.github.io/Decompose/">分解</a>(Note: Since no French text was provided to translate, there is no output.)</p> </div> </div> </div> <div class="sect1"> <h2 id="_さまざまなコードスニペット">さまざまなコードスニペット</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_マップリデュース">マップリデュース</h3> <div class="paragraph"> <p>ビットのリストを文字列のリストに変換し、文字列のリストを要約する<br> 文字列の中で、連結を含む。 リクエスト (requestBodyContent:byte[]) が送信されたときにログを取る方法</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">log.info( requestBodyContent!!.map { it.toInt().toChar().toString() } .reduce { request: String, s: String -> request + s } )</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_enum_と_sealed_クラス">enum と sealed クラス</h3> <div class="paragraph"> <p>投�稿：<a href="0038_training_kotlin_enum_sealed_class_post" target=""_blank">kotlin の enum と sealed クラスのトレーニング</a></p> </div> </div> <div class="sect2"> <h3 id="_機能的インターフェイスとメソッド参照">機能的インターフェイスとメソッド参照</h3> <div class="paragraph"> <p>エンティティをDTOのドメインモデルに変換することができ、参照メソッド(関数型スタイル-Java 8)を使います</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">fun findAllByLoginNot( pageable:Pageable, login:String) :Page<UserDto> { return userDao.findAllByLoginNot( pageable, login).map(::fromEntity) }</code></pre> </div> </div> <div class="paragraph"> <p>一つのhttps://stackoverflow.com/a/22245383/837404[良い説明]</p> </div> </div> <div class="sect2"> <h3 id="_標準出力をキャプチャする">標準出力をキャプチャする</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">package functional import java.io.ByteArrayOutputStream import java.io.PrintStream import java.lang.System.out import java.lang.System.setOut import kotlin.test.AfterTest import kotlin.test.BeforeTest import kotlin.test.Test import kotlin.test.assertEquals class BasicsHOF { private val standardOut: PrintStream? = out private val outputStreamCaptor = ByteArrayOutputStream() @BeforeTest fun setUp() = setOut(PrintStream(outputStreamCaptor)) @AfterTest fun tearDown() = setOut(standardOut) @Test fun `three times dope`() { 3.times { println("Hello") } assertEquals( buildString { repeat(3) { append("Hello\n") } deleteAt(length - 1) }, outputStreamCaptor .toString() .trim() ) } fun Int.times(fn: () -> Unit) = (1..this).forEach { _ -> fn() } }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_kotlinにおけるapplyrunletalsousewithの違いは何ですか">Kotlinにおけるapply、run、let、also、use、withの違いは何ですか？</h3> <div class="paragraph"> <p><strong>Kotlin 関数の比較とラムダ形式の利用 リファレンス</strong></p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_適用する">適用する</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">導入 コトリンの関数`apply`, <code>run</code>, <code>let</code>, <code>also</code>, <code>use</code>, et `with`様々な方法でオブジェクトを扱う手段を提供しています。それぞれに固有の使用例と挙動があります。さらに、ラムダ参照形式は既存のラムダ関数を参照することにより、コードをより読みやすく再利用しやすくします。</div> <p>機能`apply`これはオブジェクトの生成中に設定するために使用されます。呼び出されたオブジェクトを返します。</p> </div> <div class="paragraph"> <p>ラムダ参照の例：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val someObject = SomeClass().apply(::configureObject)</code></pre> </div> </div> <div class="paragraph"> <p>ラムダを使用した例：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val someObject = SomeClass().apply { // configuration des propriétés de someObject }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_実行">実行</h2> <div class="sectionbody"> <div class="paragraph"> <p>機能`run`オブジェクトに対してコードブロックを実行し、その結果を返すために使用されます。</p> </div> <div class="paragraph"> <p>ラムダ参照の例：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val result = someObject.run(::someFunction)</code></pre> </div> </div> <div class="paragraph"> <p>ラムダを使った例：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val result = someObject.run { // bloc de code à exécuter sur someObject // la dernière expression est renvoyée }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_let">let</h2> <div class="sectionbody"> <div class="paragraph"> <p>機能`let`は、オブジェクト上でコードブロックを実行し、その結果を返すために使用されます。</p> </div> <div class="paragraph"> <p>ラムダ参照の例：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val result = someObject.let(::processObject)</code></pre> </div> </div> <div class="paragraph"> <p>ラムダを使った例：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val result = someObject.let { // bloc de code à exécuter sur someObject // la dernière expression est renvoyée }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_また">また</h2> <div class="sectionbody"> <div class="paragraph"> <p>機能`also`これは、オブジェクトに追加のアクションを実行するために使用され、呼び出されたオブジェクトを返します。</p> </div> <div class="paragraph"> <p>lambda 参照の例</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">someObject.also(::performAdditionalAction)</code></pre> </div> </div> <div class="paragraph"> <p>ラムダを使った例 :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">someObject.also { // action additionnelle sur someObject }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_think"></think></h2> <div class="sectionbody"> <div class="paragraph"> <p>機能`use`使用後に閉じる必要があるリソースを扱うために使用されます。自動的に関数を呼び出します。`close`ブロックの終わりに。</p> </div> <div class="paragraph"> <p>ラムダ参照の例 :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">someResource.use(::useResource)</code></pre> </div> </div> <div class="paragraph"> <p>lambda との例 :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">someResource.use { // travailler avec la ressource }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_with">with</h2> <div class="sectionbody"> <div class="paragraph"> <p>関数`with`オブジェクトの複数のメソッドを名前を繰り返さずに呼び出すために使用され、最後の式の結果を返します。</p> </div> <div class="paragraph"> <p>例題とlambda参照 :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val result = with(someObject, ::processWithObject)</code></pre> </div> </div> <div class="paragraph"> <p>ラムダの例：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val result = with(someObject) { // appeler des méthodes sur someObject // la dernière expression est renvoyée }</code></pre> </div> </div> <div class="paragraph"> <p>ラムダ参照フォームまたはブロックを使用して`{}`ロジックを別々の関数にカプセル化することで、コードの可読性と再利用性が向上します</p> </div> </div> </div> <div class="sect1"> <h2 id="_kotlinにおけるlet関数">Kotlinにおけるlet関数 ＝＝</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">let は、副作用が適用されたオブジェクトを返しますか、それとも入力時の初期状態のオブジェクトを返しますか？（let によって異なります）</div> <p>関数`let`Kotlin は、オブジェクトに対して操作を行い、異なる結果を返すために使用されます。ただし、関数については重要な点に注意する必要があります。`let`呼び出されたオブジェクトの初期状態を変更しません。</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 50%;"> <col style="width: 50%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>署名</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>inline fun <T, R> T.let(block: (T) → R): R</code></p></td> </tr> </tbody> </table> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 50%;"> <col style="width: 50%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>使用法</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">機能`let`は、オブジェクトに変換を適用し、これらの変換に基づいた結果を得るために一般的に使用されます。</p></td> </tr> </tbody> </table> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 50%;"> <col style="width: 50%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>結果</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">関数が返す値`let`は引数として渡されたラムダ式の結果であり、通常はオブジェクトに対して行われた操作の結果です。</p></td> </tr> </tbody> </table> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 50%;"> <col style="width: 50%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>境界効果</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">関数であるにもかかわらず`let`ラムダ式で使用されるときにオブジェクトに副作用を及ぼす可能性はあるが、オブジェクト自身の初期状態を変更するわけではない。</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>したがって、関数`let`これは、オブジェクトに対して操作を行いながら導出結果を得つつ、元のオブジェクトの整合性を保つエレガントな方法です。</p> </div> </div> </div> https://cheroliv.com/blog/2022/0052_memo_jvm_post.html Sat, 28 May 2022 00:00:00 +0000 blog/2022/0052_memo_jvm_post.html <div class="sect1"> <h2 id="toc">目次</h2> <div class="sectionbody"> <div class="olist arabic"> <ol class="arabic"> <li> <p><a href="#char">文字列と文字</a></p> </li> <li> <p><a href="#math">数と数学</a></p> </li> <li> <p><a href="#date">日付と時刻</a></p> </li> <li> <p><a href="#java8date">日付と時刻 java8</a></p> </li> <li> <p><a href="#arrCol">配列とコレクション</a></p> </li> <li> <p><a href="#sysProp">System.Properties</a></p> </li> <li> <p><a href="#threads">スレッド</a></p> </li> <li> <p><a href="#regex">正規表現</a></p> </li> </ol> </div> </div> </div> <div class="sect1"> <h2 id="char">文字列と文字</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">import java.text.Collator import java.util.* import kotlin.test.* class StringsTest { @Test fun `chaines de caractères et caractères`() { //inférence de type val s = "C'est" assertEquals("C'est", s) //concaténation val t: String = s + " le moment." assertEquals("C'est le moment.", t) // StringBuilder val t1: String = s + buildString { append(" le moment.") } assertEquals("C'est le moment.", t1) //interpolation val t2 = "$s le moment." assertEquals("C'est le moment.", t2) //multiligne chaine de caractères val t3 = """$s le moment.""" assertEquals("C'est le moment.", t3) //conversion de type val t4 = t + " " + 23.4 assertEquals("C'est le moment. 23.4", t4) val t5 = 'C'.toString() assertEquals("C", t5) //taille de la chaine de caractères assertEquals(16, t.length) //sous-chaine d'une chaine de caractères //retourne une chaine de caractères contenant, //les caractères aux positions x à y-1 //sub = t.substring(x, y) //t = "C'est le moment." //retourne les caractères 6 et 7 var sub = t.substring(6, 8) assertEquals("le", sub) //retourne les caractères 0 à 4 sub = t.substring(0, 5) assertEquals("C'est", sub) //la longueur d'une sous-chaine est toujours égale (y-x) val numChars = sub.length assertEquals(5 - 0, numChars) //extraction des caractères d'une chaine assertEquals('e', t.elementAt(2)) assertEquals('e', t.get(2)) assertEquals('e', t[2]) //conversion d'une chaine en tableau de caractères val ca = t.toCharArray() assertEquals(t.length, ca.size) t.mapIndexed { index, char -> assertEquals(char, ca[index]) } //place les 4 premiers caractères de t1 //dans le tableau ca a la position 2 (t as java.lang.String).getChars( /* srcBegin = */ 0, /* srcEnd = */ 3, /* dst = */ ca, /* dstBegin = */ 1 ) assertEquals("CC'et le moment.", String(ca)) //colle tous les caractères dans un meme string assertEquals("CC'et le moment.", ca.concatToString()) //to lower case assertEquals("c'est le moment.", t.toLowerCase()) assertEquals("c'est le moment.", t.lowercase()) //to upper case assertEquals("C'EST LE MOMENT.", t.toUpperCase()) assertEquals("C'EST LE MOMENT.", t.uppercase()) //comparaison de chaines de caractères //t = "C'est le moment." assertFalse(t.equals("hello")) assertFalse(t == "hello") //ignore la casse assertTrue(t.equalsIgnoreCase("C'EST LE MOMENT.")) assertTrue(t.equals("C'EST LE MOMENT.", ignoreCase = true)) //démarre par assertTrue(t.startsWith("C'est")) //se finit par assertTrue(t.endsWith("le moment.")) //compareTo //retourne une valeur < 0, car s est //alphabétiquement avant "N'est" val r1: Int = s.compareTo("N'est") assertTrue(r1 < 0) //variante ignorant la casse val r1Prime: Int = (s as java.lang.String).compareToIgnoreCase("n'est") assertTrue(r1Prime < 0) //retourne 0 si les chaines sont equivalente val r2: Int = s.compareTo("C'est") assertEquals(0, r2) //retourne une valeur > 0 car s vient apres "B'est" val r3: Int = s.compareTo("B'est") assertTrue(r3 > 0) //Recherche de caractères et de sous-chaines de caractères //recherche de caractères //position du premier caractères 't' var pos = t.indexOf('t') assertEquals(4, pos) //position du suivant pos = t.indexOf('t', pos + 1) assertEquals(14, pos) //retour d'érreur -1 si absence de suivant pos = t.indexOf('t', pos + 1) assertEquals(-1, pos) //position du dernier 't' dans la chaine: 14 pos = t.lastIndexOf('t') assertEquals(14, pos) //recherche de 't' vers l'arrière a partir du caractères 13 pos = t.lastIndexOf('t', pos - 1) assertEquals(4, pos) //recherche de sous-chaines //retourne 2 pos = t.indexOf("est") assertEquals(2, pos) //"est" n'apparait qu'une seule fois: retourne -1 pos = t.indexOf("est", pos + 1) assertEquals(-1, pos) //recherche d'une sous-chaine depuis l'arrière //t = "C'est le moment." //retourne 6 pos = t.lastIndexOf("le ") assertEquals(6, pos) //extrait depuis la position 9, //renvoi toute la chaine après "le " val noun = t.substring(pos + 3) assertEquals(-1, noun.indexOf("le ")) //remplacement de toutes les instances d'un caractère //par un autre caractère //ne fonctionne que avec les caractères, pas les chaines val exclaim: String = t.replace('.', '!') assertEquals('!', exclaim.get(exclaim.length - 1)) assertEquals(exclaim.length - 1, exclaim.indexOf('!')) assertEquals(-1, exclaim.indexOf('.')) //suppression des espaces blancs //au début et à la fin d'une chaine val noextraspaces = t.trim() assertNotEquals(' ', noextraspaces.get(0)) assertNotEquals(' ', noextraspaces.get(noextraspaces.length - 1)) //extraction des instances uniques de chaines de caractères //avec intern() val s1 = s.intern() assertEquals(s, s1) val s2 = "C'est".intern() assertEquals("C'est", s2) assertEquals(s1, s2) //StringBuilder pour manipuler les caractères d'une chaine de caractères //crée un tampon StringBuilder à partir d'une chaine de caractères val b = StringBuilder("N'est") //extrait et définit des caractères individuel du tampon StringBuilder //le caractères à l'index 0 val c: Char = b.get(0) assertEquals('N', c) //modifier le premier caractère de la chaine b.setCharAt(0, 'C') assertEquals(s, b.toString()) //ajouter des données à un StringBuilder b.append(' ') b.append("le moment.") b.append(23) //insère des chaines de caractères ou autre dans le StringBuilder b.insert(6, "pas ") assertEquals("C'est pas le moment.23", b.toString()) //remplace un sous ensemble de caractères //avec une chaine de caractères donnée b.replace(2, 9, "est") assertEquals("C'est le moment.23", b.toString()) //supprime les caractères b.delete(15, 18) assertEquals("C'est le moment", b.toString()) b.deleteCharAt(2) assertEquals("C'st le moment", b.toString()) //insert à la postion 2 et décale reste à droite(sans perte de données) b.insert(2, 'e') //tronque la taille de la donnée b.setLength(5) assertEquals("C'est", b.toString()) //inverse les caractères de la chaine b.reverse() assertEquals("tse'C", b.toString()) //écrase le StringBuilder, pret à etre réutilisé b.setLength(0) assertEquals("", b.toString()) //java.util.StringTokenizer pour fragmenter une chaine //de caractères en un ensemble de mots var st = StringTokenizer(t) //nb d'items encore présentent dans la file assertEquals(3, st.countTokens()) //est ce que il y a encore des items dans la file assertTrue(st.hasMoreTokens()) //récupérer le token courrant assertEquals("C'est", st.nextToken()) assertEquals("le", st.nextToken()) assertEquals("moment.", st.nextToken()) assertFalse(st.hasMoreTokens()) assertEquals(0, st.countTokens()) //extraire des occurences de mots délimités //par des caractères autres que des expaces. val str = "a:b:c:d" st = StringTokenizer(str, ":") assertEquals(4, st.countTokens()) assertTrue(st.hasMoreTokens()) assertEquals("a", st.nextToken()) assertEquals("b", st.nextToken()) assertEquals("c", st.nextToken()) assertEquals("d", st.nextToken()) assertFalse(st.hasMoreTokens()) assertEquals(0, st.countTokens()) //text="C'est le moment." val text = t.toCharArray() var p = 0 //sauter les espaces de tete //pour ramener p à la position du premier caractère imprimable while ((p < text.size) && (Character.isWhitespace(text[p])) ) p++ assertEquals(0, p) assertEquals("C'est le moment.", text.concatToString()) //met le premier mot du texte en majuscule while (p < text.size && Character.isLetter(text[p])) { text[p] = Character.toUpperCase(text[p]) p++ } assertEquals(1, p) assertEquals('C', text[0]) assertTrue(Character.isUpperCase(text[0])) assertFalse(Character.isLetter(text[1])) //comparer des chaines de caractères // avec les contrainte la locale système val col = Collator.getInstance() //le résulat est négatif car chica //est avant chico dans l'ordre alphabétique assertTrue(col.compare("chica", "chico") < 0) } }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc">目次</a></p> </div> </div> </div> <div class="sect1"> <h2 id="math">数と数学</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">import java.math.BigInteger import java.security.SecureRandom import java.text.NumberFormat import java.util.* import kotlin.test.* class NumbersMathTest { @Test fun `Nombres et Math`() { //Constantes utiles Byte.MIN_VALUE Byte.MAX_VALUE Short.MIN_VALUE Short.MAX_VALUE Float.MIN_VALUE Float.MAX_VALUE Math.PI Math.E val s = "-42" //conversion de chaine de caractères //vers un nombre, si possible. var b: Byte = java.lang.Byte.parseByte(s) var sh: Short = java.lang.Short.parseShort(s) var i: Int = java.lang.Integer.parseInt(s) var l: Long = java.lang.Long.parseLong(s) var f: Float = java.lang.Float.parseFloat(s) var d: Double = java.lang.Double.parseDouble(s) //valeur exacte val f_exac = java.lang.Float.valueOf(s) val d_exac = java.lang.Double.valueOf(s) //les routines de conversions entière gérent //les nombres dans diverses bases. //1011 en binare est égal a 11 en base dix b = java.lang.Byte.parseByte("1011", 2) assertEquals(11, b) //ff en base 16(hexa) est égal à 255 en base dix. sh = java.lang.Short.parseShort("ff", 16) assertEquals(255, sh) //la méthode valueOf() peut gérer des bases arbitraires. i = java.lang.Integer.valueOf("egg", 17).toInt() assertEquals(4334, i) //la méthode decode() gére les representations octale, //décimal, hexadécimal, en fonction du préfixe numérique //de la chaine de caractères //un 0 de tete signifie base 8 //un 0x de tete signifie base 16 //les autres sont en base 10 val sho = java.lang.Short.decode("0377") //la classe Integer peut convertir les nombres //en diverses chaines de caractères. val decimal = java.lang.Integer.toString(42) assertEquals("42", decimal) val decimal_ = 42.toString() assertEquals("42", decimal_) val binary = java.lang.Integer.toBinaryString(42) assertEquals("101010", binary) val octal = java.lang.Integer.toOctalString(42) assertEquals("52", octal) val hex = java.lang.Integer.toHexString(42) assertEquals("2a", hex) val base36 = java.lang.Integer.toString(42, 36) assertEquals("16", base36) val base36_ = 42.toString(36) assertEquals("16", base36_) //java.text.NumberFormat effectue la conversion // d'une maniere spécifique aux parametres locaux //sans parametre prend la local systeme comme reference val nf = NumberFormat.getNumberInstance(Locale.FRANCE) val formatted_number = nf.format(9876543.21) assertNotEquals("9876543.21", formatted_number) //parse la chaine de caractères en fonction des parametres locaux(fr) val n = nf.parse("1234567,89") assertEquals(1234567.89, n) //les valeurs monétaires sont parfois formaté // d'une maniere differente des nombres val money_format = NumberFormat.getCurrencyInstance(Locale.FRANCE) assertEquals("123,40 €", money_format.format(1234.56)) //java.lang.Math d = Math.toRadians(27.0) d = Math.cos(d) d = Math.sqrt(d) d = Math.log(d) d = Math.exp(d) d = Math.pow(10.0, d) d = Math.atan(d) d = Math.toDegrees(d) //arrondi au dessus val up = Math.ceil(d) //arrondi au dessous val down = Math.floor(d) //arrondi au plus près val nearest = Math.round(d) //java.lang.Math.Random() val r = Math.random() assertTrue(r >= 0.0 && r < 1.0) //créé un nouvel objet Random, en l'initialisant //avec l'heure courante val generator = java.util.Random(System.currentTimeMillis()) //prochaine valeur aléatoire de taille double d = generator.nextDouble() assertTrue((d >= 0.0) && (d < 1.0)) //prochaine valeur aléatoire de taille float f = generator.nextFloat() assertTrue((f >= 0.0) && (f < 1.0)) //prochaine valeur aléatoire de taille long l = generator.nextLong() assertTrue( (Math.abs(l) <= Long.MAX_VALUE) && (Math.abs(l) >= 0) ) //prochaine valeur aléatoire de taille int i = generator.nextInt() assertTrue( (Math.abs(i) <= java.lang.Integer.MAX_VALUE) && (Math.abs(i) >= 0) ) val limit = 100 //prochaine valeur aléatoire de taille int //la limit max du ramdom est ramené à limit //et la limit min est 0 i = generator.nextInt(limit) assertTrue(i in 0 until limit) //prochaine valeur aléatoire de taille booléen val bool = generator.nextBoolean() assertNotNull(bool) //valeur moyenne 0.0, déviation standard 1.0 d = generator.nextGaussian() //randoms bytes //rempli un tableau avec des valeurs byte aléatoires val b_arr = ByteArray(128) generator.nextBytes(b_arr) b_arr.iterator().forEachRemaining { assertTrue( it <= Byte.MAX_VALUE && it >= Byte.MIN_VALUE ) } //java.security.SecureRandom pour les nombres aléatoires //utilisé en cryptographie val secure_generator = SecureRandom() //le générateur génère sa propre tete de liste sur 16 octets secure_generator.setSeed(secure_generator.generateSeed(16)) val sec_b_arr = ByteArray(128) secure_generator.nextBytes(sec_b_arr) sec_b_arr.iterator().forEachRemaining { assertTrue( it <= java.lang.Byte.MAX_VALUE && it >= java.lang.Byte.MIN_VALUE ) } //java.math.BigDecimal java.math.BigInteger //pour travailler sur des grandes valeurs. //calcule de la factorielle de 1000 var total = BigInteger.valueOf(1) (2..1000).forEach { total = total.multiply(BigInteger.valueOf(it.toLong())) } assertTrue(total.toString().length == 2568) } }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc">目次</a></p> </div> </div> </div> <div class="sect1"> <h2 id="date">日付と時刻</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">import java.text.DateFormat import java.text.SimpleDateFormat import java.time.Instant import java.util.* import kotlin.test.Test import kotlin.test.assertEquals import kotlin.test.assertTrue class DatesHoursTest { @Test fun `Dates et heures`() { //l'heure courante en millisecondes val t0 = System.currentTimeMillis() //une autre représentation de la meme information val now = java.util.Date() //converti un objet java.util.Date en une valeur long. val t1 = now.getTime() assertTrue(t1 > Instant.EPOCH.toEpochMilli()) //kotlin property access syntaxe style val t1_prime = now.time //java.text.DateFormat //affiche la date d'aujourd'hui en utilisant le format //par défaut des parametres locaux val defaultDateFormat = DateFormat.getDateInstance() //personnalisation du formatage et de la locale val df = DateFormat.getDateInstance(DateFormat.LONG, Locale.FRANCE) val localeFormattedDate = df.format(Date()) //constantes pour les styles de pattern de formatage assertEquals(0, DateFormat.FULL) assertEquals(1, DateFormat.LONG) assertEquals(2, DateFormat.MEDIUM) assertEquals(3, DateFormat.SHORT) assertEquals(2, DateFormat.DEFAULT) //utilise pour l'heure un format abrégé avec //des parametres personnalisés val tf = DateFormat.getTimeInstance( DateFormat.SHORT, Locale.FRANCE ) //affiche l'heure en utilisant le format de tf val shortTime = tf.format(Date()) assertTrue(shortTime.contains(':')) //affiche la date et l'heure en utilisant //un format détaillé val longTimeStamp = DateFormat.getDateTimeInstance( DateFormat.FULL, DateFormat.FULL, ) assert(longTimeStamp.format(Date()).isNotEmpty()) //utilisez java.text.SimpleDateFormat //pour définir votre propre modele de formatage val customFormat = SimpleDateFormat("yyyy.MM.dd") assertEquals(10, customFormat.format(Date()).length) //DateFormat peut également parser les date contenu dans des chaines val kotlinAnnounceDate = customFormat.parse("2019.05.08") //la class Date et sa représentation en millisecondes //n'autorise qu'une forme trés simple d'arithmétique //on ajoute 3 600 000 millisecondes à l'heure courante val anHourFromNow = now.getTime() + (60 * 60 * 1000) assert(anHourFromNow > now.getTime()) //java.util.Calendar //pour manipuler les dates et heures de facon plus sophistiquée //instanciation selon les parametres locaux //et le fuseau horaire local val calendar = Calendar.getInstance() //initialisation du calendrier à la date de maintenant calendar.setTime(now) //détermine le jour de l'année auquel correspond la date courante val dayOfYear = calendar.get(Calendar.DAY_OF_YEAR) assert(dayOfYear < 366) //réinitialisation de la date courante calendar.set(2019, Calendar.MAY, 8) assertEquals(4, calendar.get(Calendar.DAY_OF_WEEK)) //à quel jour du mois correspond le deuxieme mercredi de mai 2019 //set(key,value) calendar.set(Calendar.YEAR, 2019) calendar.set(Calendar.MONTH, Calendar.MAY) calendar.set(Calendar.DAY_OF_WEEK, Calendar.WEDNESDAY) //defini à quel (n=2) semaine du mois est la date calendar.set(Calendar.DAY_OF_WEEK_IN_MONTH, 2) //extrait le jour du mois val dayOfMonth = calendar.get(Calendar.DAY_OF_MONTH) assertEquals(8, dayOfMonth) calendar.setTime(kotlinAnnounceDate) //ajoute 30j à la date calendar.add(Calendar.DATE, 30) val monthAfter = calendar.getTime() //date est elle avant ou apres? assertTrue(monthAfter.after(kotlinAnnounceDate)) } }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc">目次</a></p> </div> </div> </div> <div class="sect1"> <h2 id="java8date">日付と時刻 java8</h2> <div class="sectionbody"> <div class="paragraph"> <p>Java 8 は新しいパッケージ <code><em>*java.time</em>*</code> を導入し、基本クラスを含んでいる<br> ほとんどの開発者は作業しています。 また、4つのサブパッケージが含まれています：<br></p> </div> <div class="paragraph"> <p><strong><em>java.time.chrono</em></strong><br> 開発者が使用しているカレンダーシステムに関する代替の年表<br> ISO規格に従うことは相互作用するでしょう 例としては日本のカレンダーです<br> 耐久性のあるシステム。<br> <strong><em>java.time.format</em></strong><br> 日付と時刻のオブジェクトを変換するために使用されるDateTimeFormatterを含む<br> 文字列中、およびデータおよび時刻オブジェクト内の文字列を分析するためにも<br> <strong><em>java.time.temporal</em></strong><br> ベースの日付と時刻クラスに必要なインターフェイスを含み、さらに<br> 抽象（クエリや調整子など）を用いた、日付に関する高度な操作。<br> <strong><em>java.time.zone</em></strong><br> 基盤となるタイムゾーンルールに使用されるクラス;<br> ほとんどの開発者はこのパッケージが必要ないでしょう。<br></p> </div> <div class="imageblock"> <div class="content"> <img src="../../img/java8-date-time.png" alt="java8 date time"> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">import java.time.LocalDate import java.time.Month import java.time.Period import java.time.YearMonth import java.time.temporal.* import java.util.HashMap import java.util.stream.Collectors import kotlin.test.Test class DatesHoursJava8Test { class BirthdayDiary { private val birthdays: MutableMap<String, LocalDate> init { birthdays = HashMap() } fun addBirthday( name: String, day: Int, month: Int, year: Int ): LocalDate { val birthday: LocalDate = LocalDate.of(year, month, day) birthdays[name] = birthday return birthday } fun getBirthdayFor(name: String): LocalDate? { return birthdays[name] } fun getAgeInYear(name: String, year: Int): Int { val period: Period = Period.between( birthdays[name], birthdays[name]!!.withYear(year) ) return period.getYears() } fun getFriendsOfAgeIn(age: Int, year: Int): Set<String> { return birthdays.keys.stream() .filter { p: String -> getAgeInYear(p, year) == age } .collect(Collectors.toSet()) } fun getDaysUntilBirthday(name: String): Int { val period: Period = Period.between( LocalDate.now(), birthdays[name] ) return period.getDays() } fun getBirthdaysIn(month: Month): Set<String> { return birthdays.entries.stream() .filter { (_, value): Map.Entry<String, LocalDate> -> value.getMonth() === month } .map<String> { (key): Map.Entry<String, LocalDate> -> key } .collect(Collectors.toSet()) } val birthdaysInCurrentMonth: Set<String> get() = getBirthdaysIn(LocalDate.now().getMonth()) val totalAgeInYears: Int get() = birthdays.keys.stream() .mapToInt { p: String -> getAgeInYear( p, LocalDate.now().getYear() ) } .sum() } //Les ajusteurs modifient les objets de date et d'heure. Supposons, par exemple, que nous voulions //renvoie le premier jour d'un trimestre qui contient un horodatage particulier : class FirstDayOfQuarter : TemporalAdjuster { override fun adjustInto(temporal: Temporal): Temporal? { val currentQuarter: Int = YearMonth.from(temporal) .get(IsoFields.QUARTER_OF_YEAR) return when (currentQuarter) { 1 -> LocalDate.from(temporal) .with(TemporalAdjusters.firstDayOfYear()) 2 -> LocalDate.from(temporal) .withMonth(Month.APRIL.value) .with(TemporalAdjusters.firstDayOfMonth()) 3 -> LocalDate.from(temporal) .withMonth(Month.JULY.value) .with(TemporalAdjusters.firstDayOfMonth()) 4 -> LocalDate.from(temporal) .withMonth(Month.OCTOBER.value) .with(TemporalAdjusters.firstDayOfMonth()) else -> null } } } enum class Quarter { FIRST, SECOND, THIRD, FOURTH } //Dans quel trimestre de l'année cette date se situe-t-elle ? class QuarterOfYearQuery : TemporalQuery<Quarter> { override fun queryFrom(temporal: TemporalAccessor): Quarter { val now = LocalDate.from(temporal) return if (now.isBefore(now.with(Month.APRIL).withDayOfMonth(1))) Quarter.FIRST else if (now.isBefore( now.with(Month.JULY) .withDayOfMonth(1) ) ) Quarter.SECOND else if (now.isBefore( now.with(Month.NOVEMBER) .withDayOfMonth(1) ) ) Quarter.THIRD else Quarter.FOURTH } } @Test fun `Dates et heures après java 8`() { val today = LocalDate.now() val currentMonth = today.month val firstMonthOfQuarter = currentMonth.firstMonthOfQuarter() val q = QuarterOfYearQuery() // Direct var quarter: Quarter? = q.queryFrom(LocalDate.now()) println(quarter) // Indirect quarter = LocalDate.now().query(q) println(quarter) val now = LocalDate.now() val fdoq: Temporal = now.with(FirstDayOfQuarter()) println(fdoq) } }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc">目次</a></p> </div> </div> </div> <div class="sect1"> <h2 id="arrCol">配列とコレクション</h2> <div class="sectionbody"> <div class="imageblock"> <div class="content"> <img src="../../img/collections_classes_inheritance.png" alt="Classes de collections et héritage"> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">package playground.programming import java.util.* import kotlin.test.Test import kotlin.test.assertEquals import kotlin.test.assertFalse import kotlin.test.assertTrue class ArrayCollectionTest { @Test fun `Tableaux, collections`() { //Tableau //java.util.Arrays définit d'utiles méthodes de manipulation de tableaux, //y compris de tri et de recherche au sein d'un tableau val intArray = arrayOf(10, 5, 7, -3) //tri le tableau Arrays.sort(intArray) var pos = Arrays.binarySearch(intArray, 7) //la valeur 7 est trouvé a l'index 2 assertEquals(2, pos) //12 pas trouvé retourne une valeur negative assert(Arrays.binarySearch(intArray, 12) < 0) //les tableaux peuvent également etre triés //et faire l'objet d'une recherche val stringArray = arrayOf("le", "moment", "c'est") assertEquals("c'est", stringArray[2]) assertEquals("le", stringArray[0]) assertEquals("moment", stringArray[1]) Arrays.sort(stringArray) assertEquals("c'est", stringArray[0]) assertEquals("le", stringArray[1]) assertEquals("moment", stringArray[2]) //Arrays.equals() compare tous les éléments de deux tableaux //Arrays.clone() copie tous les elements du tableau dans un autre stringArray.forEachIndexed { i, it -> assertEquals(it, stringArray.clone()[i]) } val data = ByteArray(100) //Arrays.fill() initialise tous les éléments des deux tableaux //initalise tous les éléments à -1 Arrays.fill(data, -1) data.forEach { assertEquals(-1, it) } //attribue aux éléments 5, 6, 7, 8 et 9 la valeur -2 Arrays.fill(data, 5, 10, -2) ((5 until (10 - 1))).forEach { assertEquals(-2, data[it]) } //récupère le type de data val type = data::class.java //est ce que data est un tableau? assertTrue(type.isArray()) //est ce que data est un tableau de byte assertEquals(Byte::class.java, type.getComponentType()) //Collection val s = java.util.HashSet<String>() s.add("test") assertTrue(s.contains("test")) assertFalse(s.contains("test2")) s.remove("test") assertFalse(s.contains("test")) val ss = TreeSet<String>() ss.add("b") ss.add("a") ss.iterator().forEach { assertTrue(it == "a" || it == "b") } //liste doublement chainée var dll: List<String> = LinkedList<String>() //plus efficace val l = java.util.ArrayList<String>() l.addAll(ss) l.addAll(1, ss) val obj = l.get(1) val obj_prime = l[1] assertEquals(obj, obj_prime) l.set(3, "nouvel élément") l.add("test") l.add(0, "test2") l.removeAt(1) l.remove("a") assertFalse(l.contains("a")) l.removeAll(ss) assertFalse(l.containsAll(ss)) assertFalse(l.isEmpty()) assertTrue(l.isNotEmpty()) val sublist = l.subList(1, 3) val elements = l.toArray() l.clear() val m = HashMap<String, Integer>() m.put("clé", Integer(42)) m["clé"] = Integer(42) val value: Integer = m.get("clé")!! assertEquals(Integer(42), value) m.remove("clé") assertTrue(m.isEmpty()) val keys = m.keys assertTrue(keys.isEmpty()) val set = HashSet<String>() set.add("key_1") set.add("key_2") set.add("key_3") val members = set.toArray() assertEquals(3, members.size) val list = ArrayList<String>() list.add("items1") list.add("items2") list.add("items3") val items = list.toArray() assertEquals(3, items.size) //trie et recherche d'éléments sur les collections list.add("clé") //en premier on trie Collections.sort(list) //en kotlin list.sort() //en deuxieme on cherche //retourne l'index du premier trouvé sinon -1 pos = Collections.binarySearch(list, "clé") assertEquals(0, pos) val list1 = mutableListOf(1, 2, 3, 4, 5) val list2 = mutableListOf<Int>(0, 0, 0, 0, 0) //d'autres méthodes intéressantes concernant Collections //copie list1 dans list2, 2e parametre dans 1er parametre Collections.copy(list2, list1) //comparaison de la copy avec filter assertTrue(list1.filterIndexed { i: Int, it: Int -> it != list2[i] }.isEmpty()) //comparaison de la copy avec map list1.mapIndexed { index: Int, it: Int -> assertEquals(it, list2[index]) } //rempli avec des 0 Collections.fill(list2, 0) assertTrue(list2.none { it != 0 }) //le maximum assertEquals(5, Collections.max(list1)) //le minimum assertEquals(1, Collections.min(list1)) //renverse Collections.reverse(list) listOf("items3", "items2", "items1", "clé").mapIndexed { i: Int, it: String -> assertEquals(it, list[i]) } //mélange la list Collections.shuffle(list) //retourne un ensemble immuable possédant un seul élément 0 Collections.singleton(0) //renvoi un emballage immuable autour d'une liste Collections.unmodifiableList(list) //renvoi un emballage synchronisé autour d'une map, ensemble clé valeur Collections.synchronizedMap(m) //java.util.Properties un est objet key value } }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc">目次</a></p> </div> </div> </div> <div class="sect1"> <h2 id="sysProp">System.Properties</h2> <div class="sectionbody"> <div class="paragraph"> <p><a href="https://docs.oracle.com/javase/tutorial/essential/environment/sysprop.html">System.Properties 公式ドキュメント</a></p> </div> <div class="paragraph"> <p>ここにいくつかの興味深いプロパティの表があります。<br> これらの特性は情報を得るために興味深いです<br> JVMのホストシステム上で</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3343%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>キー</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>意味</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ファイルセパレータ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ファイルパスのコンポーネントを区切る文字。これはUNIXでは"/"、Windowsでは"\"です。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">java.class.path</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">クラスファイルを含むディレクトリおよびJARアーカイブを見つけるために使用されるパス。クラスパスの要素は、<code>path.separator</code> プロパティで指定されるプラットフォーム固有の文字で区切られます。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">java.home</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Java Runtime Environment (JRE) のインストールディレクトリ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">java.vendor</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">JRE ベンダー名</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Java ベンダーの URL</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">JREベンダーURL</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">java.version</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">JREバージョン番号</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">line.separator</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">オペレーティングシステムがテキストファイルの行を区切るために使用するシーケンス</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">os.arch</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">オペレーティング システム アーキテクチャ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">os.name</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">オペレーティングシステム名</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">os.version</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">オペレーティングシステムのバージョン</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">パス区切り文字</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">java.class.path で使用されるパス区切り文字</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">user.dir</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">作業ディレクトリ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">user.home</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ユー�ーザーのホームディレクトリ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ユーザー名</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ユーザーアカウント名</p></td> </tr> </tbody> </table> <div class="paragraph"> <p><a href="#toc">目次</a></p> </div> </div> </div> <div class="sect1"> <h2 id="threads">スレッド</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">import java.text.DateFormat import java.util.* import kotlin.test.Test class ThreadsTest { @Test fun `threads test`() { //java.lang.Thread représente le thread fondamentale de l'API java //il existe deux manière de définir un thread //1) étendre la classe Thread ou une lambda en kotlin //2) implémenter l'interface Runnable, // puis passer une instance de cet objet Runnable au constructeur de Thread. val list1: List<Int> = List( size = 45, init = { (1..31).random() } ) println("list1$list1") //facon 1 val t = Thread { Collections.sort(list1) println("list1 sorted$list1") } t.start() val list2 = List( size = 45, init = { (1..31).random() } ) println("list2$list2") //facon 2 val sorter = BackgroundSorter(list2) sorter.start() //priorité des threads //tant qu'un thread de niveau de priorité supérieure n'est pas fini //alors celui de niveau inférieur ne peut s'exécuter //on définit un thread avec une priorité inférieur à la normale t.setPriority(Thread.NORM_PRIORITY - 1) //ici on définit un thread avec une priorité inférieur à la priorité //du thread courant t.setPriority(Thread.currentThread().getPriority() - 1) //Thread.yield() fait une pause pour laisser les autres threads de meme priorité s'exécuter } class BackgroundSorter(private val l: List<Int>) : Thread() { override fun run() { Collections.sort(l) println("list2 sorted$l") } } //pour l'arrêt du thread, plutôt qu'utiliser la fonction Thread.stop() // qui laisse la memoire dans un état non controlé. //utiliser la méthode tel que l'exemple pleaseStop() class DummyClock( private val df: DateFormat = DateFormat.getTimeInstance(DateFormat.MEDIUM), private var keepRunning: Boolean = true ) : Thread() { init { isDaemon = true start() } override fun run() { while (keepRunning) { println(df.format(Date())) try { sleep(1000) } catch (e: InterruptedException) { println(e.message) } } } fun pleaseStop() { keepRunning = false } } //java.util.Timer //java.util.TimerTask //ces classes permettent l'exécution de taches répétitives @Test fun `Timer et TimerTask test`() { DummyClock() } }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc">目次</a></p> </div> </div> </div> <div class="sect1"> <h2 id="regex">正規表現</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">import java.util.* import java.util.regex.Matcher import java.util.regex.Pattern import java.util.stream.Collectors import kotlin.test.Test import kotlin.test.assertEquals class RegularExpressionsTest { @Test fun `expressions régulières`() { val p: Pattern = Pattern.compile("honou?r") val caesarUK = "For Brutus is an honourable man" val mUK: Matcher = p.matcher(caesarUK) assertEquals(true, mUK.find(), "Should matches UK spelling") val caesarUS = "For Brutus is an honorable man" val mUS: Matcher = p.matcher(caesarUS) assertEquals(true, mUS.find(), "Should matches US spelling") } @Test fun `expressions régulières plus complexes`() { //Notez que nous devons utiliser \\ car nous avons besoin d'un littéral \ //et Java utilise un seul \ comme caractère d'échappement var pStr = "\\d" // Un chiffre numérique var text = "Apollo 13" var p = Pattern.compile(pStr) var m = p.matcher(text) print(pStr + " matches " + text + "? " + m.find()) println(" ; match: " + m.group()) pStr = "[a..zA..Z]" //N'importe quelle lettre p = Pattern.compile(pStr) m = p.matcher(text) print(pStr + " matches " + text + "? " + m.find()) println(" ; match: " + m.group()) //N'importe quel nombre de lettres, qui doivent toutes être comprises entre 'a' et 'j' //mais peut-être en majuscule ou en minuscule. pStr = "([a..jA..J]*)" p = Pattern.compile(pStr) m = p.matcher(text) print(pStr + " matches " + text + "? " + m.find()) println(" ; match: " + m.group()) text = "abacab" //'a' suivi de quatre caractères quelconques, suivi de 'b' pStr = "a....b" p = Pattern.compile(pStr) m = p.matcher(text) print(pStr + " matches " + text + "? " + m.find()) println(" ; match: " + m.group()) } @Test fun `Quelles chaînes correspondent à la regex ?`() { val pStr = "\\d" // Un chiffre numérique val p = Pattern.compile(pStr) val ls: List<String> = Arrays.asList("Cat", "Dog", "Ice-9", "99 Luftballoons") val containDigits: List<String> = ls.stream() .filter(p.asPredicate()) .collect(Collectors.toList()) assert(containDigits.contains("Ice-9")) assert(containDigits.contains("99 Luftballoons")) assertEquals(2, containDigits.size) } }</code></pre> </div> </div> <div class="sect2"> <h3 id="_表_regex_metacharacters">表 regex metacharacters</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7592%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">メタ文字</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">機能性</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">ノート</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">?</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">オプションの文字—ゼロまたは1つのインスタンス</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">*</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">直前の文字のゼロ回以上</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">+</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">1つ以上の前の文字</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">{M,N}</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">前の文字のMからN回</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\d</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">一つの数字</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\D</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">数字以外の文字</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\w</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">単語の文字</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">数字、文字、および_</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\W</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">言葉のない文字</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\s</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">スペース文字</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\S</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">非空白文字</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\n</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">改行文字</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\t</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">タブ文字</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">。</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">任意の文字</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Javaでは改行を含みません</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">[Translation of empty string is empty string]</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">角括弧で囲まれたすべての文字</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">文字クラスが呼び出された</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">[^ ]</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">角括弧内に含まれない任意の文字</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">逆順文字クラスと呼ばれた</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">( )</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">パターンの要素のグループを構築する</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">グループ（またはキャプチャーグループ）と呼ばれる</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">|</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">代替の可能性を定義する</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">論理的なORを実装</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">^</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">文字列の開始 $ 文字列の終了</p></td> <td class="tableblock halign-left valign-top"></td> </tr> </tbody> </table> <div class="paragraph"> <p>完了するhttps://www.codeurjava.com/2015/05/les-expressions-regulieres-avec-regex.html[と]</p> </div> </div> </div> </div> https://cheroliv.com/blog/2022/0047_memo_gradle_post.html Mon, 23 May 2022 00:00:00 +0000 blog/2022/0047_memo_gradle_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_ヘルプを表示">ヘルプを表示</a></li> <li><a href="#_jvmのシステムプロパティを設定する_d_system_prop">JVMのシステムプロパティを設定する : `-D, --system-prop</a></li> <li><a href="#_ビルドスクリプトのプロジェクトプロパティを設定する_pmypropmyvalue">ビルドスクリプトのプロジェクトプロパティを設定する: `-Pmyprop=myvalue</a></li> <li><a href="#_gradleの起動ディレクトリを指定しますデフォルトは現在のディレクトリです">Gradleの起動ディレクトリを指定します。デフォルトは現在のディレクトリです。</a></li> <li><a href="#_コマンドラインからプロパティ_param_component_をオーバーライドする">コマンドラインからプロパティ 'param_component' をオーバーライドする :</a></li> <li><a href="#_通常のプロジェクトで_kotlin_dsl_を使用してソースセットにフォルダーを追加する">通常のプロジェクトで Kotlin DSL を使用してソースセットにフォルダーを追加する</a></li> <li><a href="#_groovy_dsl_を使って_android_プロジェクトのソースセットにフォルダーを追加する">Groovy DSL を使って Android プロジェクトのソースセットにフォルダーを追加する</a></li> <li><a href="#_サブモジュールの構築とテストを避ける">サブモジュールの構築とテストを避ける</a></li> <li><a href="#_ファイルを取る">ファイルを取る</a></li> <li><a href="#_ビルドの依存関係を表示">ビルドの依存関係を表示</a></li> <li><a href="#_reduceの使用例リストの文字列への結合">reduceの使用例：リストの文字列への結合</a></li> <li><a href="#_特定のタスクの説明を取得">特定のタスクの説明を取得</a></li> <li><a href="#_workingdir_ルートからタスクを起動するにはタスクに_をプレフィックスとして付けてください">workingDir ルートからタスクを起動するには、タスクに <code>:</code> をプレフィックスとして付けてください。</a></li> <li><a href="#_失敗したタスクを再起動するにはオプション_rerun_tasks_を使用してください">失敗したタスクを再起動するには、オプション <code>--rerun-tasks</code> を使用してください。</a></li> <li><a href="#_別のディレクトリから特定のプロジェクトでタスクを起動する">別のディレクトリから特定のプロジェクトでタスクを起動する</a></li> </ul> </div> <div class="sect1"> <h2 id="_ヘルプを表示">ヘルプを表示</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./gradlew --help</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_jvmのシステムプロパティを設定する_d_system_prop">JVMのシステムプロパティを設定する : `-D, --system-prop</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./gradlew -Dmyprop=myvalue #ou ./gradlew --system-prop myvalue</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ビルドスクリプトのプロジェクトプロパティを設定する_pmypropmyvalue">ビルドスクリプトのプロジェクトプロパティを設定する: `-Pmyprop=myvalue</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./gradlew -Pmyprop=myvalue #ou ./gradlew --project-prop myvalue</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_gradleの起動ディレクトリを指定しますデフォルトは現在のディレクトリです">Gradleの起動ディレクトリを指定します。デフォルトは現在のディレクトリです。</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./gradlew -p ~/src/next_startup #ou ./gradlew --project-dir ~/src/next_startup</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_コマンドラインからプロパティ_param_component_をオーバーライドする">コマンドラインからプロパティ 'param_component' をオーバーライドする :</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./gradlew -Pparam_component=CUSTOM_VALUE</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_通常のプロジェクトで_kotlin_dsl_を使用してソースセットにフォルダーを追加する">通常のプロジェクトで Kotlin DSL を使用してソースセットにフォルダーを追加する</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">sourceSets { getByName("test"){ java.srcDir("src/scripts/groovy") } getByName("test"){ java.srcDir("src/scripts/kscript") } getByName("test"){ java.srcDir("src/test/javascript") } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_groovy_dsl_を使って_android_プロジェクトのソースセットにフォルダーを追加する">Groovy DSL を使って Android プロジェクトのソースセットにフォルダーを追加する</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">android { sourceSets { main.java.srcDirs += "src/main/../../../../ceelo/domain/src/main/java/" test.java.srcDirs += "src/test/../../../../ceelo/domain/src/test/java/" } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_サブモジュールの構築とテストを避ける">サブモジュールの構築とテストを避ける</h2> <div class="sectionbody"> <div class="paragraph"> <p>Gradle ビルド -x :excluded-module:check -x :excluded-module:assemble -x :excluded-module:build</p> </div> <div class="listingblock"> <div class="title">ファイルを移動する</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">tasks.register("moveWebappNode") { doLast { ant.withGroovyBuilder { "move"( "webapp/node_modules" to "$rootDir/webapp-src/node_modules", ) } } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ファイルを取る">ファイルを取る</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">tasks.register<Tar>("tarWebapp") { dependsOn("moveWebappNpm") group = WEBAPP description = "tar webapp" doLast { setOf( "build", "target", "node_modules" ).forEach { dir -> exclude { it.name .dir } } archiveFileName.set("webapp.tar") destinationDirectory.set(File("${rootDir.absolutePath}$sep$WEBAPP_SRC")) } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ビルドの依存関係を表示">ビルドの依存関係を表示</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">tasks.register("printDependencies") { description = "print project dependencies" group = WEBAPP doLast { println("${project.name} dependencies") mutableMapOf<String, Map<String, String>>( "buildDependencies" to buildDependencies, "domainDeps" to domainDeps, "domainTestDeps" to domainTestDeps, ).apply { putAll(appModules) } .forEach { module -> if (module.value.isNotEmpty()) { println("${module.key}:") module.value.forEach { println(dependency(it)) } println() } } } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_reduceの使用例リストの文字列への結合">reduceの使用例：リストの文字列への結合</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">tasks.register("printWebappSrc") { description = "print webapp sources" group = WEBAPP doLast { webAppSrc .reduce { acc, s -> "$acc\n\t$s" } .run { println("$WEBAPP_SRC: $this\n") } } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_特定のタスクの説明を取得">特定のタスクの説明を取得</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./gradlew -q help --task foo</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_workingdir_ルートからタスクを起動するにはタスクに_をプレフィックスとして付けてください">workingDir ルートからタスクを起動するには、タスクに <code>:</code> をプレフィックスとして付けてください。</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./gradlew :foo</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_失敗したタスクを再起動するにはオプション_rerun_tasks_を使用してください">失敗したタスクを再起動するには、オプション <code>--rerun-tasks</code> を使用してください。</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./gradlew check --rerun-tasks</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_別のディレクトリから特定のプロジェクトでタスクを起動する">別のディレクトリから特定のプロジェクトでタスクを起動する</h2> <div class="sectionbody"> <div class="paragraph"> <p>オプション`-p` (ou <code>--project-dir</code>) Gradleプロジェクトへのパスを指定し、そのプロジェクトでタスクを実行することができます。ただし、現在のディレクトリが異なる場合でもです。</p> </div> <div class="paragraph"> <p>たとえば、タスクを起動するために`build`プロジェクトが位置する`~/projets/mon-autre-projet`他のディレクトリにいる状態で：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./gradlew -p ~/projets/mon-autre-projet build</code></pre> </div> </div> <div class="paragraph"> <p>これは、中央の場所から複数のプロジェクトにわたるアクションをスクリプト化するのに特に役立ちます。</p> </div> <div class="paragraph"> <p>参照：</p> </div> <div class="ulist"> <ul> <li> <p><a href="https://docs.gradle.org/current/userguide/command_line_interface.html#sec:command_line_warnings">参照</a></p> </li> <li> <p><a href="https://docs.gradle.org/current/userguide/command_line_interface.html#sec:command_line_options">参照</a></p> </li> <li> <p><a href="https://stackoverflow.com/a/36178581/837404">議論</a></p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2022/0038_training_kotlin_enum_sealed_class_post.html Tue, 17 May 2022 00:00:00 +0000 blog/2022/0038_training_kotlin_enum_sealed_class_post.html <div class="paragraph"> <p>シールクラスは、列挙型（キーワード: enum）ではありません。<br> Javaから来たあなたは、機能を提供する列挙をオーバーロードしたくなるかもしれません: // Java コード</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">enum PizzaOrderStatus { ORDER_RECEIVED, PIZZA_BEING_MADE, OUT_FOR_DELIVERY, COMPLETED; public PizzaOrderStatus nextStatus() { switch (this) { case ORDER_RECEIVED: return PIZZA_BEING_MADE; case PIZZA_BEING_MADE: return OUT_FOR_DELIVERY; case OUT_FOR_DELIVERY: return COMPLETED; case COMPLETED:return COMPLETED; } } }</code></pre> </div> </div> <div class="paragraph"> <p>代わりに、sealed クラスを使用できます：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">sealed class PizzaOrderStatus(protected val orderId: Int) { abstract fun nextStatus() : PizzaOrderStatus class OrderReceived(orderId: Int) : PizzaOrderStatus(orderId) { override fun nextStatus(): PizzaOrderStatus { return PizzaBeingMade(orderId) } } class PizzaBeingMade(orderId: Int) : PizzaOrderStatus(orderId) { override fun nextStatus(): PizzaOrderStatus { return OutForDelivery(orderId) } } class OutForDelivery(orderId: Int) : PizzaOrderStatus(orderId) { override fun nextStatus(): PizzaOrderStatus { return Completed(orderId) } } class Completed(orderId: Int) : PizzaOrderStatus(orderId) { override fun nextStatus(): PizzaOrderStatus { return this } } }</code></pre> </div> </div> <div class="paragraph"> <p>このアプローチの利点は、今ではデータを le 送信できることです ステータス:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">var status: PizzaOrderStatus = OrderReceived(123) while (status !is Completed) { status = when (status) { is OrderReceived -> status.nextStatus() is PizzaBeingMade -> status.nextStatus() is OutForDelivery -> status.nextStatus() is Completed -> status } }</code></pre> </div> </div> <div class="paragraph"> <p>一般的に、sealed クラスは、データを関連付けたい場合に適しています。 状態。</p> </div> https://cheroliv.com/blog/2022/0036_training_kotlin_post.html Thu, 12 May 2022 00:00:00 +0000 blog/2022/0036_training_kotlin_post.html <div class="sect1"> <h2 id="_マインドマップ">マインドマップ</h2> <div class="sectionbody"> <div class="paragraph"> <p><span class="image"><img src="../../diagram/training_kotlin.png" alt="training_kotlin"></span></p> </div> </div> </div> <div class="sect1"> <h2 id="_関数型プログラミング">関数型プログラミング</h2> <div class="sectionbody"> <div class="paragraph"> <p>演�習は本から取り出されています:<br> チュートリアルによる Kotlin での関数型プログラミング<br> Massimo Carli によって書かれました<br> リポジトリ: <a href="https://github.com/kodecocodes/fpk-materials" class="bare">https://github.com/kodecocodes/fpk-materials</a></p> </div> <div class="sect2"> <h3 id="_構文">構文</h3> <div class="sect3"> <h4 id="_最初のプログラムテスト">最初のプログラムテスト</h4> <div class="paragraph"> <p>概念: 画面表示, 機能<br> FirstProgramTest:https://github.com/cheroliv/cheroliv.com/blob/master/codes/src/test/kotlin/programming/FirstProgramTest.kt[ソース]+</p> </div> </div> <div class="sect3"> <h4 id="_連結関数テスト">連結関数テスト</h4> <div class="paragraph"> <p>概念: メモリー, 変数, 値, オブジェクト, 関数拡張<br> ExampleUnitTest: <a href="https://github.com/cheroliv/cheroliv.com/blob/master/codes/src/test/kotlin/programming/ConcatFunctionTest.kt">源</a>+</p> </div> </div> <div class="sect3"> <h4 id="_birthdaymessagetestoutput">BirthdayMessageTestOutput</h4> <div class="paragraph"> <p>概念: 集合, ループ<br> <a href="https://developer.android.com/codelabs/basic-android-kotlin-training-first-kotlin-program?continue=https%3A%2F%2Fdeveloper.android.com%2Fcourses%2Fpathways%2Fandroid-basics-kotlin-one%23codelab-https%3A%2F%2Fdeveloper.android.com%2Fcodelabs%2Fbasic-android-kotlin-training-first-kotlin-program">Kotlinの紹介</a><br> �誕生日メッセージテスト出力:https://github.com/cheroliv/cheroliv.com/blob/master/codes/src/test/kotlin/programming/BirthdayMessageTestOutput.kt[ソース]+</p> </div> </div> </div> <div class="sect2"> <h3 id="_コトリンコース">コトリンコース</h3> <div class="videoblock"> <div class="content"> <iframe src="https://www.youtube.com/embed/YRjY3jRrQYY?rel=0" frameborder="0" allowfullscreen></iframe> </div> </div> </div> <div class="sect2"> <h3 id="_javaのコレクションに関するチュートリアル">Javaのコレクションに関するチュートリアル</h3> <div class="paragraph"> <p><a href="https://docs.oracle.com/javase/tutorial/collections/index.html" target="_blank" rel="noopener">コレクション</a></p> </div> <div class="paragraph"> <p>コレクションインターフェースの核心<br> <span class="image"><img src="../../img/0036_training_kotlin_post/colls-coreInterfaces.gif" alt="Collections"></span><br></p> </div> </div> <div class="sect2"> <h3 id="_基本的な機能">基本的な機能</h3> <div class="sect3"> <h4 id="_宣言型_x_命令型アプローチ">宣言型 X 命令型アプローチ</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">package functional import kotlin.test.Test import kotlin.test.assertEquals class DeclarativeTests { val input = listOf( "123", "abc", "1ds", "987", "abdf", "1d3", "de1", "88", "101" ) fun imperativeSum(list: List<String>): Int { var sum = 0 for (item in list) { try { sum += item.toInt() } catch (_: NumberFormatException) { } } return sum } @Test fun `test imperative approach`() { imperativeSum(input).run { println("Sum $this") assertEquals(1299, this) } } fun isValidNumber(s: String) = try { s.toInt() true } catch (_: NumberFormatException) { false } fun declarativeSum(list: List<String>) = list .filter(::isValidNumber) .map(String::toInt) .sum() @Test fun `test declarative approach`() { assertEquals(1299, declarativeSum(input).apply { println("Sum $this") }) } }</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_演習_1_1">演習 1.1</h4> <div class="paragraph"> <p>関数 sumInRange を実装し、範囲内の値を加算します<br> 与えられた区間の List<String> 。シグニチャは：</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">fun sumInRange(input: List<String>, range: IntRange): Int</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `Exercise 1_1`() { assertEquals(4, sumInRange( listOf("1", "10", "a", "7", "ad2", "3"), 1..5 ).apply { println("sumInRange 1..5: $this") } ) }</code></pre> </div> </div> <div class="paragraph"> <p>お試しください、そしてあなたの答えをそれに合わせて確認してくださいhttps://github.com/cheroliv/cheroliv.com/blob/master/codes/src/test/kotlin/functional/DeclarativeTests.kt[ソリューション, windows="_blank]。</p> </div> </div> <div class="sect3"> <h4 id="_高階関数">高階関数</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">package functional import java.io.ByteArrayOutputStream import java.io.PrintStream import java.lang.System.* import java.lang.Thread.sleep import kotlin.math.sign import kotlin.test.Test import kotlin.test.assertEquals class BasicsHOFTests { val ONE_SECOND = 1000L @Test fun `high order function`() { //capture de la sortie standard val standardOut: PrintStream? = out val outputStreamCaptor = ByteArrayOutputStream() setOut(PrintStream(outputStreamCaptor)) 3.times { println("Hello") } assertEquals( buildString { repeat(3) { append("Hello\n") } deleteAt(length - 1) }, outputStreamCaptor .toString() .trim() ) //libération de la sortie standard setOut(standardOut) } fun Int.times1(fn: () -> Unit) { for (i in 1..this) { fn() } } fun Int.times2(fn: () -> Unit) { for (i in 1..this) fn() } fun Int.times3(fn: () -> Unit) = (1..this).forEach { fn() } fun Int.times4(fn: () -> Unit) = repeat((1..this).count()) { fn() } fun Int.times(fn: () -> Unit) = (1..this).forEach { _ -> fn() } }</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_演習_1_2">演習 1.2</h4> <div class="paragraph"> <p>chrono を実装し、型の関数を受け取る`() →`<br> ユニットを入力として、実行にかかった時間を返します。シグニチャは:+</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">fun chrono(fn : () -> Unité) : Long</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `Exercise 1_2`() { val waitOneSec = { sleep(ONE_SECOND) } chrono(waitOneSec).apply { println("chrono: $this") assertEquals(1, sign) } }</code></pre> </div> </div> <div class="paragraph"> <p>試してみて、それに合わせてあなたの答えを確認してhttps://github.com/cheroliv/cheroliv.com/blob/master/codes/src/test/kotlin/functional/BasicsHOFTests.kt[解決策, windows="_blank].</p> </div> </div> <div class="sect3"> <h4 id="_構成">構成</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">package functional import kotlin.test.Test import kotlin.test.assertEquals fun double(x: Int): Int = 2 * x fun square(x: Int): Int = x * x fun squareAndDouble1(x: Int) = double(square(x)) infix fun <A, B, C> ((A) -> B).compose(g: (B) -> C) : (A) -> C = { a -> g(this(a)) } class CompositionTests { @Test fun composition_impure() { assertEquals(200, double(square(10))) assertEquals(200, squareAndDouble1(10)) } @Test fun composition_pure() { val squareAndDouble = ::square compose ::double assertEquals(200, squareAndDouble(10)) } }</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_純粋関数とテスト容易性">純粋関数とテスト容易性</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">package functional import java.io.ByteArrayOutputStream import java.io.PrintStream import java.lang.System.out import java.lang.System.setOut import kotlin.test.Test import kotlin.test.assertEquals var count = 0 //impure car une variable global subit un effet de bord fun impure(value: Int): Int { count++ return value + count } //impure car utilisation de la sortie standard qui fait muter le system fun addOneAndLog(x: Int): Int { val result = x + 1 println("New Value is $result") return result } //pure fun addOne(x: Int) = (x + 1).run { Pair(this, "New Value is $this") } class PureTests { @Test fun `impure fonction`() { assertEquals(3, impure(2)) val standardOut = out val outputStreamCaptor = ByteArrayOutputStream() setOut(PrintStream(outputStreamCaptor)) addOneAndLog(3) assertEquals( "New Value is 4", outputStreamCaptor .toString() .trim() ) setOut(standardOut) } @Test fun `pure fonction`() { addOne(3).run { assertEquals(4, first) assertEquals("New Value is 4", second) } } }</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_例外処理">例外処理</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">package functional import org.junit.jupiter.api.assertThrows import kotlin.Result.Companion.failure import kotlin.Result.Companion.success import kotlin.test.Test import kotlin.test.assertEquals //NumberFormatException est un effet de bord qui rend la fonction impure fun strToInt(str: String) = str.toInt() //pure fun strToIntOrNull(str: String) = try { str.toInt() } catch (nfe: NumberFormatException) { null } //pure avec gestion de l'exception plus élégante fun strToIntResult(str: String): Result<Int> = try { success(str.toInt()) } catch (nfe: NumberFormatException) { failure(nfe) } class ExceptionHandlingTests { @Test fun impure() { assertThrows<NumberFormatException> { strToInt("foo") } assertEquals(1, strToInt("1")) } @Test fun pure() { assertEquals(null, strToIntOrNull("foo")) assertEquals(1, strToIntOrNull("1")) } @Test fun `pure avec result`() { assertEquals(1, strToIntResult("1").getOrNull()) assertEquals( "For input string: \"foo\"", strToIntResult("foo") .exceptionOrNull() ?.message ) } }</code></pre> </div> </div> </div> </div> <div class="sect2"> <h3 id="_重要なポイント">重要なポイント</h3> <div class="ulist"> <ul> <li> <p>オブジェクト指向プログラミングは、オブジェクトを使ってプログラミングすることを意味します。</p> </li> </ul> </div> <div class="paragraph"> <p>関数型プログラミングは、関数を使ってプログラムを書くことを意味します。 問題をいくつかのサブ問題に分解し、それらをモデル化します 機能。</p> </div> <div class="ulist"> <ul> <li> <p>高階関数は他の関数を入力として受け取るか、他のを返します。</p> </li> </ul> </div> <div class="paragraph"> <p>返り値として機能します。 カテゴリ理論は合成の理論であり、あなたはそれを理解するために使います。 作業プログラムで関数をどのように組み立てますか。 純粋な関数の出力値は、その入力パラメータにのみ依存し、それは 副作用はありません。</p> </div> <div class="ulist"> <ul> <li> <p>副作用は、関数が外部世界に行う何かです。</p> </li> </ul> </div> <div class="paragraph"> <p>標準出力にログを出力するか、グローバル変数の値を変更する可能性があります。 関数型プログラミングは純粋な関数に対して機能します。しかし、それはまたを提供します 不純な関数を純粋な関数に変換するツール 副作用を移動させることで、不純な関数を純粋にすることができます 戻り値の一部。</p> </div> <div class="ulist"> <ul> <li> <p>関数型プログラミングは、組み合わせに関するものです。</p> </li> </ul> </div> <div class="paragraph"> <p>エラー処理は副作用の典型的なケースであり、Kotlinはツールを提供します それらを機能的に管理するために。</p> </div> </div> <div class="sect2"> <h3 id="_java_8を深く学ぶ_ラムダ式と関数型インターフェース">Java 8を深く学ぶ: ラムダ式と関数型インターフェース</h3> <div class="videoblock"> <div class="content"> <iframe src="https://www.youtube.com/embed/20waNRw6wMA?rel=0&list=PLzzeuFUy_Cng0wZhqbnkvWAW0d2fdVfyQ" frameborder="0" allowfullscreen></iframe> </div> </div> </div> <div class="sect2"> <h3 id="_圏論">�圏論</h3> <div class="paragraph"> <p>数学的カテゴリー理論:</p> </div> <div class="videoblock"> <div class="content"> <iframe src="https://www.youtube.com/embed/LVHoROSF3KA?rel=0" frameborder="0" allowfullscreen></iframe> </div> </div> </div> <div class="sect2"> <h3 id="_関数の基礎">関数の基礎</h3> <div class="sect3"> <h4 id="_問題_2_1">問題 2.1</h4> <div class="paragraph"> <p>一意な値にマッピングする関数の例を書くことができますか？<br> ドメインが範囲内で一意でない値を持つ場合、例えば以下の図の f(b) と f(c) のように？<br></p> </div> <div class="paragraph"> <p>やってみて、その後、チャレンジプロジェクトの解答を確認して、自分がどうだったかを見てみよう。<br> アドバイスと説明は、リンクに従って先へ進むと見つかります。 <a href="https://github.com/cheroliv/cheroliv.com/blob/master/codes/src/test/kotlin/functional/BasicsHOFTests.kt">解決策</a>.<br></p> </div> </div> <div class="sect3"> <h4 id="_演習_2_2">演習 2.2</h4> <div class="paragraph"> <p>２倍の関数の逆関数を書くことができますか？<br> 逆関数の定義域と値域は何ですか？<br> 解答については、チャレンジプロジェクトと付録Bを参照してください。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">fun chrono(fn : () -> Unité) : Long</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `Exercise 1_2`() { val waitOneSec = { sleep(ONE_SECOND) } chrono(waitOneSec).apply { println("chrono: $this") assertEquals(1, sign) } }</code></pre> </div> </div> <div class="paragraph"> <p>試してみて、そしてそれによってあなたの答えを確認してhttps://github.com/cheroliv/cheroliv.com/blob/master/codes/src/test/kotlin/functional/BasicsHOFTests.kt[解決策, windows="_blank]。</p> </div> </div> </div> </div> </div> https://cheroliv.com/blog/2022/0031_memo_design_system_post.html Sun, 9 Jan 2022 00:00:00 +0000 blog/2022/0031_memo_design_system_post.html <div class="sect1"> <h2 id="_ツール">ツール</h2> <div class="sectionbody"> <div class="dlist"> <div class="title"><strong>イラスト</strong></div> <dl> <dt class="hdlist1"><a href="https://undraw.co/">undraw.co</a></dt> <dd> <p>オープンソースのイラストは、想像できるすべてのアイデアに使えます。</p> </dd> <dt class="hdlist1"><a href="https://absurd.design/">absurd.design</a></dt> <dd> <p>意味があるばかげたイラスト</p> </dd> <dt class="hdlist1"><a href="https://drawkit.com/">drawkit.com</a></dt> <dd> <p>素晴らしい無料イラストレーション。毎週のアップデート。</p> </dd> <dt class="hdlist1"><a href="https://icons8.com/">icons8.com</a></dt> <dd> <p>アイコン、イラスト、写真、音楽、およびデザインツール。</p> </dd> <dt class="hdlist1"><a href="https://blush.design/">チーク.デザイン</a></dt> <dd> <p>アイコン、イラスト、写真、音楽、デザインツール</p> </dd> <dt class="hdlist1"><a href="https://www.humaaans.com/">humaaans.com</a></dt> <dd> <p>人物のイラストレーションをデザインライブラリとミックス＆マッチしてください。</p> </dd> </dl> </div> <div class="dlist"> <div class="title"><strong>色</strong></div> <dl> <dt class="hdlist1"><a href="https://coolors.co/">coolors.co</a></dt> <dd> <p>超高速カラースキームジェネレーター！</p> </dd> </dl> </div> <div class="dlist"> <div class="title"><strong>傾向</strong></div> <dl> <dt class="hdlist1"><a href="https://fr.pinterest.com">ピンタレスト</a></dt> <dd> <p>視覚的なアイデアの発見：画像、動画、テーマ別コレクション。</p> </dd> <dt class="hdlist1"><a href="https://dribbble.com">ドリブル</a></dt> <dd> <p>デザイナーが作品を共有し、交流するプラットフォーム</p> </dd> </dl> </div> <div class="dlist"> <div class="title"><strong>UX/UI と Design Systems</strong></div> <dl> <dt class="hdlist1"><a href="https://material.io/">Google マテリアルデザイン</a></dt> <dd> <p>Googleの統一および適応可能なユーザーインターフェース向けデザインシステム</p> </dd> <dt class="hdlist1"><a href="https://developer.apple.com/design/human-interface-guidelines/">Apple ヒューマン インターフェイス ガイドライン</a></dt> <dd> <p>AppleのiOSおよびmacOS向け直感的なアプリケーション設計の推奨事項。</p> </dd> <dt class="hdlist1"><a href="https://www.uxpin.com/">UXPin</a></dt> <dd> <p>プロトタイプとデザインシステムを作成するためのデザインとコラボレーションのプラットフォーム。</p> </dd> <dt class="hdlist1"><a href="https://www.frontify.com/">フロンティファイ</a></dt> <dd> <p>ブランドおよびデザインシステムの管理プラットフォームで、一貫性を確保します。</p> </dd> <dt class="hdlist1"><a href="https://designsystemsrepo.com/design-systems/">デザインシステム リポジトリ</a></dt> <dd> <p>インスピレーションのためのリソースとデザインシステムの例のコレクション。</p> </dd> </dl> </div> <div class="dlist"> <div class="title">*フロントエンド開発</div> <dl> <dt class="hdlist1"><a href="https://htmlcheatsheet.com" target=""_blank">htmlcheatsheet.com</a></dt> <dd> <p>HTMLチートシート</p> </dd> <dt class="hdlist1"><a href="https://fontawesome.com" target=""_blank">fontawesome.com</a></dt> <dd> <p>アイコンライブラリ</p> </dd> <dt class="hdlist1"><a href="https://www.toptal.com/designers/htmlarrows/symbols/">toptal.com/designers/htmlarrows/symbols</a></dt> <dd> <p>HTMLのネイティブアイコン</p> </dd> <dt class="hdlist1"><a href="https://css-tricks.com/">CSS-Tricks</a></dt> <dd> <p>CSSに欠かせない、最新のフロントエンドの記事、チュートリアル、コツ</p> </dd> <dt class="hdlist1"><a href="https://www.frontendmentor.io/">フロントエンド メンター</a></dt> <dd> <p>実プロジェクトに基づくフロントエンドコードの課題でスキルを向上させましょう。</p> </dd> <dt class="hdlist1"><a href="https://dev.to/">Dev.to</a></dt> <dd> <p>開発者コミュニティで記事、チュートリアル、プロジェクトを共有</p> </dd> <dt class="hdlist1"><a href="https://codepen.io/">CodePen</a></dt> <dd> <p>オンラインのコードエディターと、コードスニペットやデモを共有するコミュニティ。</p> </dd> </dl> </div> <div class="dlist"> <div class="title"><strong>AIを活用したフロントエンド開発</strong></div> <dl> <dt class="hdlist1"><a href="https://v0.dev/">v0.dev</a></dt> <dd> <p>v0 は自然言語の説明をコードとユーザーインターフェースに変換します。</p> </dd> <dt class="hdlist1"><a href="https://uizard.io/">ウィザード</a></dt> <dd> <p>Uizard は、モックアップ（画像、スケッチ）を HTML、CSS、React のコードに変換することに注力しています。</p> </dd> <dt class="hdlist1"><a href="https://www.usegalileo.ai/explore">usegalileo.ai</a></dt> <dd> <p>Galileo AI は自然言語で作りたいインターフェイスを説明することができ、AI が編集可能な Figma デザインを生成します。</p> </dd> <dt class="hdlist1"><a href="https://play.teleporthq.io/">TeleportHQ</a></dt> <dd> <p>TeleportHQは、AIを活用して視覚的にウェブサイトを構築・デプロイするのを支援するローコードフロントエンド開発プラットフォームです。</p> </dd> </dl> </div> </div> </div> https://cheroliv.com/blog/2020/0029_kubernetes_microk8s_docker_premiers_pas_post.html Tue, 3 Nov 2020 00:00:00 +0000 blog/2020/0029_kubernetes_microk8s_docker_premiers_pas_post.html <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p><a href="https://microk8s.io/docs/">MicroK8s の公式ドキュメント</a>+</p> </div> </div> </div> <div class="sect3"> <h4 id="_microk8sパッケージのインストール">microk8sパッケージのインストール:</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"></code></pre> </div> </div> </div> https://cheroliv.com/blog/2020/0028_gradle_executer_un_processus_externe_depuis_une_tache_gradle_post.html Mon, 28 Sep 2020 00:00:00 +0000 blog/2020/0028_gradle_executer_un_processus_externe_depuis_une_tache_gradle_post.html <div class="sect3"> <h4 id="_gradle_kotlin_dsl">Gradle-Kotlin-DSL:</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin"></code></pre> </div> </div> </div> https://cheroliv.com/blog/2020/0027_kotlin_not_implemented_exception_not_implemented_error_post.html Sun, 27 Sep 2020 00:00:00 +0000 blog/2020/0027_kotlin_not_implemented_exception_not_implemented_error_post.html <div class="paragraph"> <p>NotImplementedException NotImplementedError、テストでの有用性で、どこまで進んでいるかを知ることができ、失敗の原因も分かります。<br> まだ実装されておらず、正しい例外をスローできます。<br> Il y a :<br> <a href="http://commons.apache.org/proper/commons-lang/javadocs/api-release/org/apache/commons/lang3/NotImplementedException.html">org.apache.commons.lang3.NotImplementedException</a><br> <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-not-implemented-error/">kotlin.NotImplementedError</a>+</p> </div> https://cheroliv.com/blog/2020/0026_untar_post.html Sat, 26 Sep 2020 00:00:00 +0000 blog/2020/0026_untar_post.html <div class="sect3"> <h4 id="_リンク_interserver_net">リンク: <a href="https://www.interserver.net/tips/kb/extract-tar-gz-files-using-linux-command-line/">interserver.net</a></h4> </div> https://cheroliv.com/blog/2020/0025_gradle_rejouer_les_tests_meme_lorsque_les_tests_sont_UP-TO-DATE_post.html Fri, 25 Sep 2020 00:00:00 +0000 blog/2020/0025_gradle_rejouer_les_tests_meme_lorsque_les_tests_sont_UP-TO-DATE_post.html https://cheroliv.com/blog/2020/0024_docker_n_installe_pas_l_application_mais_tire_la_plutot_post.html Thu, 24 Sep 2020 00:00:00 +0000 blog/2020/0024_docker_n_installe_pas_l_application_mais_tire_la_plutot_post.html <div class="sect3"> <h4 id="_hackernoon_com"><a href="https://hackernoon.com/dont-install-postgres-docker-pull-postgres-bee20e200198">hackernoon.com</a></h4> </div> https://cheroliv.com/blog/2020/0023_gherkin_en_francais_post.html Wed, 23 Sep 2020 00:00:00 +0000 blog/2020/0023_gherkin_en_francais_post.html https://cheroliv.com/blog/2020/0022_gradle_cli_surcharger_un_parametre_post.html Tue, 22 Sep 2020 00:00:00 +0000 blog/2020/0022_gradle_cli_surcharger_un_parametre_post.html <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">---- ---- $ ./gradlew -Pparam_component=CUSTOM ---- ----</code></pre> </div> </div> https://cheroliv.com/blog/2020/0021_memo_git_post.html Mon, 21 Sep 2020 00:00:00 +0000 blog/2020/0021_memo_git_post.html <div class="sect3"> <h4 id="_出典">出典:</h4> <div class="paragraph"> <p>*https://xenovation.com/blog/source-control-management/git/how-to-change-remote-git-repository[ゼノベーション] *https://intellipaat.com/community/3102/git-show-remote-url-how-can-i-determine-the-url-that-a-local-git-repository-was-originally-cloned-from[インテリパート]</p> </div> </div> <div class="sect3"> <h4 id="_git_のリモートリポジトリを変更する">git のリモートリポジトリを変更する</h4> <div class="paragraph"> <p>現在のリモートリポジトリのURLを表示:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"></code></pre> </div> </div> </div> https://cheroliv.com/blog/2020/0021_aspirer_depuis_une_URL_post.html Sun, 20 Sep 2020 00:00:00 +0000 blog/2020/0021_aspirer_depuis_une_URL_post.html <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">---- ---- $ wget -r -k -np http://site.com/docs/manual/ ---- ターゲットフォルダーを設定するには、-P引数を追加し、パスを指定してください。 ----</code></pre> </div> </div> https://cheroliv.com/blog/2020/0020_creer_un_disk_bootable_post.html Sat, 19 Sep 2020 00:00:00 +0000 blog/2020/0020_creer_un_disk_bootable_post.html <div class="sect3"> <h4 id="_リンク_etcher">リンク: <a href="https://www.balena.io/etcher/">etcher</a></h4> </div> https://cheroliv.com/blog/2020/0019_dezipper_en_CLI_dans_un_dossier_cible_post.html Fri, 18 Sep 2020 00:00:00 +0000 blog/2020/0019_dezipper_en_CLI_dans_un_dossier_cible_post.html <div class="sect3"> <h4 id="_リンク_askubuntu">リンク: <a href="https://askubuntu.com/questions/86849/how-to-unzip-a-zip-file-from-the-terminal">askubuntu</a></h4> <div class="paragraph"> <p>特定の出力フォルダーに抽出したい場合は、以下を使用できます : <code>` $ unzip ファイル.zip -d 出力先フォルダー </code>` ソース ディレクトリと宛先ディレクトリが同じ場合、次のようにするだけです： <code>` $ unzip file.zip </code>`</p> </div> </div> https://cheroliv.com/blog/2020/0018_Afficher_la_somme_des_tailles_de_fichier_dans_la_liste_des_r%C3%A9pertoires_post.html Thu, 17 Sep 2020 00:00:00 +0000 blog/2020/0018_Afficher_la_somme_des_tailles_de_fichier_dans_la_liste_des_r%C3%A9pertoires_post.html <div class="sect3"> <h4 id="_リンク_stackexchange">リンク: <a href="https://unix.stackexchange.com/questions/72661/show-sum-of-file-sizes-in-directory-listing">stackexchange</a></h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">---- ---- $ du -ach --exclude "./.*" /home/troll/ ---- ----</code></pre> </div> </div> </div> https://cheroliv.com/blog/2020/0017_detruire_une_branch_sur_github_post.html Wed, 16 Sep 2020 00:00:00 +0000 blog/2020/0017_detruire_une_branch_sur_github_post.html <div class="sect3"> <h4 id="_githubのブランチを削除する">GitHubのブランチを削除する</h4> </div> <div class="sect3"> <h4 id="_リンク_gist">リンク: <a href="https://gist.github.com/cheroliv/921a13ed23ae6d4d66af8d43dd536987">gist</a></h4> </div> https://cheroliv.com/blog/2020/0016_asciidoc_markdown_memo_post.html Tue, 15 Sep 2020 00:00:00 +0000 blog/2020/0016_asciidoc_markdown_memo_post.html <div class="paragraph"> <p>なぜAsciiDocまたはMarkdownを使うのですか？ ここで、私はasciidocへと傾いています。なぜなら、私はすでにいくつかのチケットをasciidocで書いているからです。<br> Asciidocはマークアップ言語で、人間にとって読みやすいテキストを保ちながら、レイアウトを提供することでコンテンツを作成できます。<br> これは、追加のソフトウェアを必要とせず、シンプルなコンテンツのテキスト処理を標準化する方法です。</p> </div> <div class="ulist"> <div class="title">` <code>リンク</code> :</div> <ul> <li> <p><a href="https://blog.oxiane.com/2018/06/13/asciidoc-documentation-as-code/">@jmdoudoux、blog.oxiane.com上、window="_blank</a> [asciidoc]</p> </li> <li> <p><a href="https://powerman.name/doc/asciidoc" target=""_blank">powerman.name</a>[アスキードック]</p> </li> </ul> </div> https://cheroliv.com/blog/2019/0013_how-to-install-a-deb-file_post.html Mon, 19 Aug 2019 00:00:00 +0000 blog/2019/0013_how-to-install-a-deb-file_post.html <div class="paragraph"> <p>Debian パッケージを .deb ファイルからコマンドラインでインストールするには。<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ sudo dpkg -i /chemin/du/fichier/deb/</code></pre> </div> </div> <div class="paragraph"> <p>ここで見るためのhttps://unix.stackexchange.com/questions/159094/how-to-install-a-deb-file-by-dpkg-i-or-by-apt[参照]+</p> </div> https://cheroliv.com/blog/2019/0011_gradle_configuration_ide_jbake_content_post.html Fri, 16 Aug 2019 00:00:00 +0000 blog/2019/0011_gradle_configuration_ide_jbake_content_post.html <div class="paragraph"> <p>Gradle ビルドマネージャーが管理するアプリケーションプロジェクトでは<br> すべてのフォルダーを可視にしていると、より快適です。<br> アプリケーションの開発に参加している<br> リソースフォルダーではないような<br> 慣例により、道筋において<br> 例えば、src/jbake ディレクトリが欲しい,<br> 「resource folder」として可視である<br> プロジェクトの設定に入ることで、それを行うことができます、<br> IDE のウィザードで。 ただしこのオプションは次のリロード時に保存されません<br> IDEのGradleプロジェクト。この設定を永続的に適用するために<br> ソリューションは、ソースパスの設定をオーバーライドすることです<br> build.gradle 構成ファイルの 18 行目、19 行目、20 行目、21 行目のように :<br> build.gradle<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">plugins { id "java" id "groovy" id "org.jbake.site" version "5.0.0" id "org.ajoberstar.git-publish" version "2.1.1" } repositories { mavenCentral() jcenter() } group project_group version project_version sourceSets { main { java { srcDirs = [] } groovy { srcDirs =["src/main/java", "src/main/groovy"] } resources { srcDirs =[ "src/main/resources", "src/jbake"//in order to get site src content in the IDE ] } } test { java { srcDirs = [] } groovy { srcDirs =["src/test/java", "src/test/groovy"] } } } test { useJUnitPlatform() } configurations { ivy } dependencies { ivy "org.apache.ivy:ivy:$ivy_version" implementation "org.codehaus.groovy:groovy-all:$groovy_version" implementation "org.asciidoctor:asciidoctor-java-integration:$asciidoctor_java_integration_version" implementation "org.freemarker:freemarker:$freemarker_version" testImplementation "org.junit.jupiter:junit-jupiter-api:$junit5_version" testRuntimeOnly "org.junit.jupiter:junit-jupiter-engine:$junit5_version" } gitPublish { repoUri = github_pages_blog_repository branch = git_branch contents { from(file(jbake_content_from)) { into jbake_content_to } } } tasks.withType(GroovyCompile) { groovyClasspath += configurations.ivy }</code></pre> </div> </div> https://cheroliv.com/blog/2019/0010_gradle_groovy_script_grab_ivy_configuration_post.html Wed, 14 Aug 2019 00:00:00 +0000 blog/2019/0010_gradle_groovy_script_grab_ivy_configuration_post.html <div class="paragraph"> <p>チケットの件名はGradleビルドスクリプトの設定です。<br> Groovyスクリプトを参照せずに使用できるようにしたい<br> Gradleプロジェクトに私が添付したもの<br> Gradleの外でこのGroovyスクリプトを実行できるようにしたい<br> Ivy の外部依存関係取得のためのアノテーションがないまま<br> 性能またはコンパイルの問題を引き起こしに来ない<br> Gradleビルドスクリプトの。<br> 構成を示すために、私は2つのスクリプトに依存しています：<br> Gradle のビルドスクリプトと Groovy スクリプト。<br> Groovy スクリプトは先頭の行 2 に含まれます、<br> 外部依存関係を取得するための指示<br> Ivy依存マネージャーを使って。<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-Groovy hljs" data-lang="Groovy">#!/usr/bin/env groovy @Grab("commons-io:commons-io:2.6") import org.apache.commons.io.FileUtils static String getSeparator() { System.getProperty("file.separator") } String from = "${System.getProperty("user.home")}${separator}.config${separator}transmission${separator}torrents" String to = "${System.getProperty("user.home")}${separator}Documents${separator}torrents_completed" File fromDlDir = new File("${System.getProperty("user.home")}${separator}Téléchargements") File fromDir = new File(from) File toDir = new File(to) Collection<File> torrentFiles = FileUtils.listFiles( fromDir, ["torrent"] as String[], false) torrentFiles.addAll(FileUtils.listFiles( fromDlDir, ["torrent", "torrent.added"] as String[], false)) torrentFiles.empty ?: torrentFiles.each { it -> FileUtils.copyFileToDirectory(it, toDir) } println torrentFiles.size()</code></pre> </div> </div> <div class="paragraph"> <p>build.gradleファイル、今、どのように調和させるかを見てみましょう。<br> 2つの依存関係管理ツール、ivyとGradle。 両者間の合意は行で行われます：<br> 26, 30, 37, 38 et 39<br> それによって、私はGroovyスクリプトを手動で実行できます、<br> そして Gradle のコンパイルは @Grab によって妨げられません。<br> Groovyスクリプトの依存関係はGradleで提供する必要はありません。<br> しかし、私は Gradle から Groovy スクリプトを実行できません。<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-Groovy hljs" data-lang="Groovy">plugins { id "java" id "groovy" } repositories { mavenCentral() jcenter() } sourceSets { main { java { srcDirs = [] } groovy { srcDirs =["src/main/java", "src/main/groovy"] } resources { srcDirs =["src/main/resources"] } } test { java { srcDirs = [] } groovy { srcDirs =["src/test/java", "src/test/groovy"] } } } configurations { ivy } dependencies { ivy "org.apache.ivy:ivy:$ivy_version" implementation "org.codehaus.groovy:groovy-all:$groovy_version" } tasks.withType(GroovyCompile) { groovyClasspath += configurations.ivy }</code></pre> </div> </div> <div class="paragraph"> <p>チケットの参照についてhttps://stackoverflow.com/a/18174033/837404[stackoverflow]</p> </div> https://cheroliv.com/blog/2019/0009_groovy_algebre_pgcd_ppmc_post.html Tue, 13 Aug 2019 00:00:00 +0000 blog/2019/0009_groovy_algebre_pgcd_ppmc_post.html <div class="sect2"> <h3 id="_ppmcは">PPMCは</h3> <div class="paragraph"> <p><a href="https://fr.wikipedia.org/wiki/Plus_petit_commun_multiple">ウィキPPMCまたは最小公倍数</a></p> </div> <div class="paragraph"> <p>AlgebraUtils.groovy<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package com.cheroliv.misc import groovy.transform.CompileStatic @CompileStatic class AlgebraUtils { /** * Great common divisor * Plus grand commun diviseur(pgcd) * Great Common Divisor * @param a * @param b * @return */ static Integer gcd(Integer a, Integer b) { !b ? a : gcd(b, a % b) } /** * Least common multiple * Plus petit commun multiplicateur(ppmc) * @param a * @param b * @return */ static BigInteger lcm(Integer a, Integer b) { (a * b / gcd(a, b)) as BigInteger } static void main(String... args) { Integer a = 96 Integer b = 28 println "gcd($a, $b) = ${gcd(a, b)}" a = 790 b = 990 println "lcm($a, $b) = ${lcm(a, b)}" } }</code></pre> </div> </div> <div class="paragraph"> <p>結果:</p> </div> <div class="paragraph"> <p>gcd(96, 28) = 4 最小公倍数(790, 990) = 78210</p> </div> </div> https://cheroliv.com/blog/2019/0008_bash_find_trouver_fichiers_par_extension_post.html Mon, 12 Aug 2019 00:00:00 +0000 blog/2019/0008_bash_find_trouver_fichiers_par_extension_post.html <div class="paragraph"> <p>名前の条件でファイルを検索しています: .h または .cpp ファイルのリスト</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ find . -name '*.h' -o -name '*.cpp' + +</code></pre> </div> </div> <div class="paragraph"> <p>拡張子が .h と .cpp であるファイルのリスト<br> 結果は list_of_txt_files.list ファイルに保存されます。</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ find . -name '*.h' -o -name '*.cpp' -print > list_of_txt_files.list</code></pre> </div> </div> <div class="paragraph"> <p>拡張子が .chm のファイルのリストを探しています。<br> そして私はこのリストを破壊する。<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ find . -name "*.chm" -type f -delete</code></pre> </div> </div> https://cheroliv.com/blog/2019/0015_projet_avec_methodologie_en_cascade_post.html Thu, 1 Aug 2019 00:00:00 +0000 blog/2019/0015_projet_avec_methodologie_en_cascade_post.html <div class="sect2"> <h3 id="_ニーズを分析し収集する">ニーズを分析し、収集する</h3> </div> <div class="sect2"> <h3 id="_プロジェクト管理を定義する">プロジェクト管理を定義する</h3> <div class="imageblock"> <div class="content"> <img src="../../diagram/definir_projet.png" alt="definir la gestion de projet"> </div> </div> <div class="imageblock"> <div class="content"> <img src="../../img/triangle_qcd.png" alt="triangle_qcd"> </div> </div> </div> <div class="sect2"> <h3 id="_プロジェクトを文脈化する">プロジェクトを文脈化する</h3> </div> <div class="sect2"> <h3 id="_要件を分析し収集する">要件を分析し、収集する</h3> <div class="sect3"> <h4 id="_目標と成果物を明確にする">目標と成果物を明確にする</h4> </div> </div> <div class="sect2"> <h3 id="_読み取りグリッドを解読する">読み取りグリッドを解読する</h3> </div> <div class="sect1"> <h2 id="_チームとともにプロジェクトのスコープを定めてください">チームとともにプロジェクトのスコープを定めてください</h2> <div class="sectionbody"> <div class="imageblock"> <div class="content"> <img src="../../img/conductor.png" alt="chef d’orchestre"> </div> </div> <div class="sect2"> <h3 id="_専門家に相談して解決策を見つける">専門家に相談して解決策を見つける</h3> </div> <div class="sect2"> <h3 id="_プロジェクト管理の方法論を選択する">プロジェクト管理の方法論を選択する</h3> <div class="imageblock"> <div class="content"> <img src="../../img/cascading_planning.png" alt="planning en cascade"> </div> </div> <div class="imageblock"> <div class="content"> <img src="../../img/Cycle_V_details.jpeg" alt="cycle en V"> </div> </div> </div> </div> </div> https://cheroliv.com/blog/2019/0014_list_all_databases_in_postgresql_post.html Tue, 30 Jul 2019 00:00:00 +0000 blog/2019/0014_list_all_databases_in_postgresql_post.html <div class="paragraph"> <p>インストールしたくないhttps://www.pgadmin.org/[pgAdmin] ou <a href="http://phppgadmin.sourceforge.net/">phppgadmin</a> ただし、すべてがコマンドラインに存在している。<br> そのため、ターミナルを起動し、postgres ユーザーとして接続する必要があります。<br> Postgresユーザーはデフォルトでpsqlアプリケーションを起動する権限を持つ唯一のユーザーです。 psqlはコマンドラインクライアントです。 (<a href="https://fr.wikipedia.org/wiki/Interface_en_ligne_de_commande">コマンドラインインターフェース</a>) postgresql,<br> ターミナルからコマンドラインでデータベースと通信できるようにするため<br> 接続するには、ターミナルを起動し、これを入力してください:<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ sudo -i -u postgres</code></pre> </div> </div> <div class="paragraph"> <p>PostgreSQLのコマンドプロンプトに直接接続し、ログインするには、次のように入力してください :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ sudo -i -u postgres psql</code></pre> </div> </div> <div class="paragraph"> <p>PostgreSQLのインスタンスのデータベースを一覧表示するコマンドは次の通りです :<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-SQL hljs" data-lang="SQL">postgres=# \l</code></pre> </div> </div> <div class="paragraph"> <p>結果:</p> </div> <div class="paragraph"> <p>データベースの一覧 名前 | 所有者 | エンコーディング | ソート順 | 文字種 | アクセス権</p> </div> <div class="paragraph"> <p>fiber | tech | UTF8 | fr_FR.UTF-8 | fr_FR.UTF-8 | =Tc/tech<br> | | | | | tech=CTc/tech fiberdev | tech | UTF8 | fr_FR.UTF-8 | fr_FR.UTF-8 | =Tc/tech<br> | | | | | tech=CTc/tech fiberweb | tech | UTF8 | fr_FR.UTF-8 | fr_FR.UTF-8 | =Tc/tech<br> | | | | | tech=CTc/tech postgres | postgres | UTF8 | fr_FR.UTF-8 | fr_FR.UTF-8 | template0 | postgres | UTF8 | fr_FR.UTF-8 | fr_FR.UTF-8 | =c/postgres<br> | | | | | postgres=CTc/postgres template1 | postgres | UTF8 | fr_FR.UTF-8 | fr_FR.UTF-8 | =c/postgres<br> | | | | | postgres=CTc/postgres (6行)</p> </div> <div class="paragraph"> <p>qを押して結果表示を終了する<br> <br> インスタンスのスキーマをリストするには postgresl.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-sql hljs" data-lang="sql">postgres=# SELECT schema_name FROM information_schema.schemata;</code></pre> </div> </div> <div class="paragraph"> <p>結果</p> </div> <div class="paragraph"> <p>公共の インフォメーションスキーマ pg_catalog pg_toast_temp_1 pg_temp_1 pg_toast (6行)</p> </div> <div class="paragraph"> <p>ou</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-sql hljs" data-lang="sql">postgres=# SELECT nspname FROM pg_catalog.pg_namespace;</code></pre> </div> </div> <div class="paragraph"> <p>結果</p> </div> <div class="paragraph"> <p>pg_toast pg_temp_1 pg_toast_temp_1 pg_catalog information_schema 公開 (6 行)</p> </div> https://cheroliv.com/blog/2019/0007_groovy_rename_recursively_files_post.html Mon, 29 Jul 2019 00:00:00 +0000 blog/2019/0007_groovy_rename_recursively_files_post.html <div class="paragraph"> <p>私のテレビのビデオプレーヤーは、そのとおりに通す方法を持っている<br> ファイルからファイルへ、連続して読み込む<br> その再生モードは、1…​..mp4 から 10…​.mp4 へと移ります,<br> そして、1…​mp4 から 2…​.mp4 までではない。<br> 問題は、ほぼ900のファイルとフォルダーがあることです。<br> ビンゴはGroovyを使った操作の優れたユースケースです<br> ファイル、リネーム、ファイル名内のパターン検索<br> またはファイル。<br> ここでの目的は、…で始まる名前を変更することです<br> 数字であり、かつその名前の2番目の文字<br> 数字ではありません。この名前に最初に0を追加します+</p> </div> <div class="paragraph"> <p>renameFilesToStartWithTwoDigit.groovy<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">#!/usr/bin/env groovy /** * get a crossplateform separator * @return */ static String getSeparator() { System.getProperty("file.separator") } /** * rename file * @param file * @param newName * @return the renamed file */ static File rename(File file, String newName) { assert file.renameTo(file .parentFile.path + getSeparator() + newName) new File(file .parentFile.path + getSeparator() + newName) } String rootFolderPath = System.getProperty("user.home") + "/Bureau/ng-courses/Udemy - Angular 7 " + "(formerly Angular 2) - The Complete Guide" File rootFolder = new File(rootFolderPath) assert rootFolder.exists() assert rootFolder.directory assert rootFolder.canRead() List<File> dirList = new ArrayList<>() //Adding rootFolder in dirList // just in case there is some files in it dirList.add(rootFolder) //looping to get list of directories //recursively inside rootFolder rootFolder.traverse { File file -> !file.directory ?: dirList.add(file) } //looping through dirList //to rename directories filling criterias for (int i = dirList.size() - 1; i >= 0; i--) { Character[] chars = dirList.get(i).name.chars !(chars[0].digit && !chars[1].digit) ?: dirList.set(i, rename(dirList.get(i), "0${dirList.get(i).name}")) if (dirList.get(i).directory) { //looping through directory //to rename file filling criterias dirList.get(i).listFiles().each { File f -> Character[] cs = f.name.chars !(cs[0].digit && !cs[1].digit) ?: rename(f, "0${f.name}") } } }</code></pre> </div> </div> https://cheroliv.com/blog/2019/0006_groovy_find_files_copy_to_post.html Fri, 19 Jul 2019 00:00:00 +0000 blog/2019/0006_groovy_find_files_copy_to_post.html <div class="paragraph"> <p>このスクリプトの目的はファイルを検索することです,<br> 親ディレクトリから; 選択を取得<br> リストの中。最後にこのファイルリストをコピーする<br> destination ディレクトリにおいて、これを Groovy で行います。</p> </div> <div class="paragraph"> <p>findCopyTo.groovy<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">#!/usr/bin/env groovy @Grab("commons-io:commons-io:2.6") import groovy.io.FileType import org.apache.commons.io.FileUtils /** * un separateur OS independant * @return */ static String getSep() { System.getProperty("file.separator") } /** * la liste des fichiers dont le titre contient un item * de la liste des motifs * * @param path * @param motifs * @return la liste des chemins complet de fichiers */ static List<String> findFilesContainingMotifs( String path, List<String> motifs) { List<String> filePathResultList = new ArrayList<>() new File(path) .eachFileRecurse(FileType.FILES) { if (it.name.toLowerCase().contains('cucumber')) { filePathResultList.add it.path } } filePathResultList } /** * copy vers la liste des fichiers * @param files * @param to */ static void copyFilesTo(List<String> files, String to) { File toDirDest = new File(to) files.each { String filepath -> File file = new File(filepath) //si le dernier caractere de to n'est pas un separateur // alors ajoute le a la chaine (to.substring(to.length() - 1) == sep) ?: to.concat(sep) if (to + file.name != filepath) { FileUtils.copyFileToDirectory(file, toDirDest) file.delete() } } } /** * la list des arguments */ String userName = System.getProperty("user.name") List<String> motifs = ['cucumber'] String path = "/media/$userName/320/Books/" String to = "/media/$userName/320/Books/bdd/" /** * lappel aux methodes */ copyFilesTo(findFilesContainingMotifs(path, motifs), to) //affiche moi les fichiers déplacés findFilesContainingMotifs(path, motifs).each { println it }</code></pre> </div> </div> https://cheroliv.com/blog/2019/0005_groovy_manipulation_files_post.html Thu, 18 Jul 2019 00:00:00 +0000 blog/2019/0005_groovy_manipulation_files_post.html <div class="paragraph"> <p>ここでは、ビルドプロジェクトにおけるプロパティのロードについて説明します。https://docs.gradle.org/current/userguide/userguide.html[gradle]<br> それがコードで利用できないままです。<br> プロパティは ~/.gradle/gradle.properties ディレクトリの gradle.properties ファイルに設定されます。<br> ~ は、ユーザーセッションのルートを表すシンボリック変数 HOME_PATH のショートカットです: そのhttps://fr.wikipedia.org/wiki/R%C3%A9pertoire_personnel[ホームディレクトリ].<br> 同様にビルドプロジェクトの中でhttps://maven.apache.org/guides/index.html[maven]、と `~/.m2/settings.xml このスクリプトの目的は、指定されたパターンに一致するファイルを削除することです。<br> 変数 strCriteria に。 そのために私はそれを使うhttps://fr.wikipedia.org/wiki/Fermeture_(informatique)[クロージャ]: each, findAll, collect<br> さらに、基準文字列を分割する StringTokenizer クラス<br> それを取得して文字列のリストを得るために もし私が掃除するフォルダのファイルのうちの1つが、その名前に1つのパターンを含んでいる場合<br> そうすると、結果のリストに追加されることで破壊の対象となる候補となる。<br> 最後に一行の小さな例としてhttps://en.wikipedia.org/wiki/Elvis_operator[エルビス演算子]<br> filemanip.groovy<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">#!/usr/bin/env groovy //Mes criteres de selection des fichiers à detruire String strCriteria = "Dummies Dummie ajax Objective-C Windows blackberry " + "wordpress joomla ios c# f# rails ruby flex asp flash Dreamweaver adobe " + "CoffeeScript c++ .chm .epub .rar .zip .tar drupal drupals .net php javascript " + ".js iphone ipad js _js facebook gwt vaadin linq python py zope window " + "3D scala gaming active_directory tomcat jboss glassfish microsoft 2d " + "lego blogger blog cocoa dojo dom dotnetnuke eclipse .gz unity sharepoint " + ".tgz iwork filemaker .doc .txt" //repertoire personnel String userDir = System.getProperty("user.home") //un separateur de chemin crossplatform String sep = System.getProperty("file.separator") //la variable symbolique String sym_books_vrac_path = "books_vrac_path" //le chemin de mon fichier gradle.properties hors projet String propertiesFilePath = userDir .concat("${sep}.gradle${sep}gradle.properties") File propertiesFile = new File(propertiesFilePath) //je m'aassure que le fichier existe et que ce n'est pas un dossier assert propertiesFile.exists() && !propertiesFile.directory Properties gradleProperties = new Properties() //on boucle avec un inpustream sur le fichier //gradle.properties pour peupler ma variable gradleProperties propertiesFile.withInputStream { InputStream it -> gradleProperties.load(it) } //le chemin du dossier books_vrac est la valeur de notre clé books_vrac_path String pathVracDir = gradleProperties.get(sym_books_vrac_path) //j'ai récuperé tous ces livres en tapant cette commande dans le terminal //wget -m -np -c -R "index.html*" "http://the-eye.eu/public/Books/IT%20Various/" //on ouvre le dossier dont le chemin est dans la variable pathVracDir // on s'assure qu'il existe et que c'est un dossier File vracDir = new File(pathVracDir) assert vracDir.exists() && vracDir.directory //separer les élèments de ma liste de critère StringTokenizer tokenizer = new StringTokenizer(strCriteria) //la liste de critere List<String> criteriaList = new ArrayList<>() //j'itère sur les tokens et je construit ma liste de token, // mot clef critère de recherche tokenizer.each { String it -> criteriaList.add(it.toLowerCase()) } //je collect tous les noms de fichier dans le dossier List<String> fileNameList = vracDir .listFiles() .collect { File it -> it.directory ?: it.name } // je collect les noms de fichier qui contiendraient un des criteres List<String> resultList = fileNameList.findAll { String name -> criteriaList.findAll { String crit -> name.toLowerCase().contains(crit) } } // je parcours ma liste de résultat pour les effacer resultList.each { String fileName -> assert new File(vracDir.path + sep + fileName).delete() } println fileNameList.size() println resultList.size() resultList.empty ?: println(vracDir.path + sep + resultList.first())</code></pre> </div> </div> https://cheroliv.com/blog/2019/0004_groovy_replace_string_load_properties_post.html Wed, 17 Jul 2019 00:00:00 +0000 blog/2019/0004_groovy_replace_string_load_properties_post.html <div class="paragraph"> <p>これはGroovyで動作するコードの一部です,<br> String内の文字シーケンスのすべての出現を変更を目的とするために<br> そして、.properties ファイルを properties オブジェクトに読み込む。<br> 文字列内でコマンドを実行する。<br> replaceTextinFile.groovy<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">#!/usr/bin/env groovy println System.getProperty("user.home") static String getSeparator_() { System.getProperty("file.separator") } String separator = separator_ String path = System.getProperty("user.home") .concat("${separator}.gradle" + separator + "gradle.properties") File propertiesFile = new File(path) assert propertiesFile.exists() && !propertiesFile.directory Properties gradleProperties = new Properties() propertiesFile.withInputStream { InputStream it -> gradleProperties.load(it) } String user_name = gradleProperties.getProperty("user_name") String text String resultText text = new File("${System.getProperty("user.home")}" + separator + "src" + separator + "cheroliv.github.io" + separator + "src" + separator + "main" + separator + "resources" + separator + "eco_space.txt").text String to = separator + "media" + separator + "${user_name}" + separator + "320" + separator + "videoCours" + separator String from = "${System.getProperty("user.home")}" + separator + "p2p" + separator resultText = text.replace(to, from) println resultText //execute command line in a string println "rsync -avr ${resultText} ${to}".execute().text</code></pre> </div> </div> https://cheroliv.com/blog/2019/0003_groovy_char_ascci_post.html Wed, 10 Jul 2019 00:00:00 +0000 blog/2019/0003_groovy_char_ascci_post.html <div class="paragraph"> <p>以下は Groovy で動作するコードの一部で、テキスト ファイルを生成します。<br> ASCII表の最初の256個の読み取り可能な文字<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">#!/usr/bin/env groovy import java.nio.charset.StandardCharsets List<Character> chars = new ArrayList<>() int j = 0 Character jumpLine = '\n' 256.times { Integer idx -> if (Character.isAlphabetic(idx) || Character.isDigit(idx)) { if (j % 10 == 0 && j != 0) { chars.add(jumpLine) chars.add(idx as char) } else chars.add(idx as char) j++ } } String seperator = System.getProperty("file.separator") String path = "${System.getProperty("user.home")}${seperator}ascii.txt" File speCharFile = new File(path) if (speCharFile.exists() && !speCharFile.directory) { speCharFile.text = "" } else { speCharFile.createNewFile() } String text = new String() chars.each { Character it -> text = it == jumpLine ? "$text$it" : "$text $it " } speCharFile.setText(text, StandardCharsets.UTF_8.toString())</code></pre> </div> </div> <div class="paragraph"> <p>私はファイルを <code>spe_char.groovy</code> と名付けました,<br> ファイルがあるフォルダーから<br> ターミナルを開いてコピー＆ペーストしてスクリプトを実行する＋</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ groovy spe_char.groovy</code></pre> </div> </div> <div class="paragraph"> <p>結果:</p> </div> <div class="paragraph"> <p>0 1 2 3 4 5 6 7 8 9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z a b c d e f g h i j k l m n o p q r s t u v w x y z ª µ º À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ð Ñ Ò Ó Ô Õ Ö Ø Ù Ú Û Ü Ý Þ ß à á â ã ä å æ ç è é ê ë ì í î ï ð ñ ò ó ô õ ö ø ù ú û ü ý þ ÿ</p> </div>