<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <title>Seaslug</title>
  
  
  <link href="https://blog.n1l.dev/atom.xml" rel="self"/>
  
  <link href="https://blog.n1l.dev/"/>
  <updated>2026-11-22T13:54:02.938Z</updated>
  <id>https://blog.n1l.dev/</id>
  
  <author>
    <name>n1lsqn</name>
    
  </author>
  
  <generator uri="https://hexo.io/">Hexo</generator>
  
  <entry>
    <title>VRChat／Unity制作のためのエージェントスキルカタログ ― シェーダーからワールドSDKまで</title>
    <link href="https://blog.n1l.dev/2026/11/skills-vrchat-unity-catalog/"/>
    <id>https://blog.n1l.dev/2026/11/skills-vrchat-unity-catalog/</id>
    <published>2026-11-19T13:01:00.000Z</published>
    <updated>2026-11-22T13:54:02.938Z</updated>
    
    <content type="html"><![CDATA[<p>VRChatのアバター改変やワールド制作をコーディングエージェントに手伝わせると、汎用のUnity知識だけでは足りない場面が多い。シェーダーのプロパティ名、FXコントローラーでのアニメーションのバインディング規則、Udonの同期まわりの作法など、ドメイン固有の決まり事が大量にあるからだ。</p><p>そこで、自分のスキル置き場（複数のAIエージェントで共有している agent-cortex）には、VRChat／Unity系のスキルをまとめて入れてある。今回はそのうち12本を、用途別にカタログとして紹介する。いずれも「どういう知識とルールを外付けしているか」の紹介で、各ツールの解説そのものではない点はご容赦を。</p><span id="more"></span><h2 id="アバターのマテリアルとシェーダー"><a href="#アバターのマテリアルとシェーダー" class="headerlink" title="アバターのマテリアルとシェーダー"></a>アバターのマテリアルとシェーダー</h2><h3 id="liltoon"><a href="#liltoon" class="headerlink" title="liltoon"></a>liltoon</h3><p>VRChatアバターの定番トゥーンシェーダー lilToon を扱うためのスキル。プロパティ名の一覧（<code>_Color</code>、<code>_EmissionColor</code>、<code>_UseEmission</code>、影色、MatCap、リムライト、アウトライン、ディゾルブ、AudioLinkまわり）と、Opaque／Cutout／Transparent／TwoPassといったレンダリングモードの整理が中心になる。実務で効くのはFXコントローラー側のバインディング規則で、Floatやトグルは <code>material._UseEmission</code> のようなパスで書き、色はRGBAチャンネル別に分ける、といった表記法を明文化している。マテリアルをプログラムから生成・変換するためのC#ヘルパーのテンプレートも同梱されている。</p><h3 id="poiyomi"><a href="#poiyomi" class="headerlink" title="poiyomi"></a>poiyomi</h3><p>Poiyomi Toon／Pro向けのスキル。ライティング、影、エミッション、MatCap、リム、溶解などのモジュラーなサブシステム構成とプロパティ名が整理されている。核になるのはThry Editorのマテリアルロック（最適化）の扱いで、「ロックしたマテリアルでアニメーションさせたいプロパティは、事前にAnimatedとして指定しておかないと定数に焼き込まれて動かなくなる」という落とし穴がはっきり書かれている。ギミックで発光や溶解をアニメーションさせる前に必ず確認する類の知識だ。</p><h2 id="アバター改変の仕組み"><a href="#アバター改変の仕組み" class="headerlink" title="アバター改変の仕組み"></a>アバター改変の仕組み</h2><h3 id="modular-avatar"><a href="#modular-avatar" class="headerlink" title="modular-avatar"></a>modular-avatar</h3><p>NDMF（Non-Destructive Modular Framework）ベースの非破壊改変ツール、Modular Avatarのスキル。MergeAnimator、Parameters、MenuItem／MenuInstaller、BlendshapeSync、MergeArmature／BoneProxyといったコンポーネントの役割と設定項目を押さえている。代表的なルールは「MenuItemだけ付けてもダメで、MenuInstallerが併せて必要」というもので、メニューが反映されない系の事故を未然に防ぐ。エディタ拡張を書くときの作法（UndoとSetDirtyを必ず使う）まで含めてあるので、自作ギミックの開発支援に向く。</p><h2 id="ワールド制作"><a href="#ワールド制作" class="headerlink" title="ワールド制作"></a>ワールド制作</h2><h3 id="unity-vrc-world-sdk-3"><a href="#unity-vrc-world-sdk-3" class="headerlink" title="unity-vrc-world-sdk-3"></a>unity-vrc-world-sdk-3</h3><p>ワールド側のシーン構築を担当するスキルで、スクリプトではなくシーン設定・コンポーネント配置・最適化・アップロードが守備範囲。VRC_SceneDescriptorやスポーン地点の設定、レイヤーとコリジョンマトリクス、Quest／Android向けのパフォーマンス予算、ベイクドライティング、Build Panelに出る警告（赤・黄・白）の切り分けまでをカバーする。次のUdonSharpスキルとは「シーンはこっち、コードはあっち」と役割分担が明示されているのが特徴。</p><h3 id="unity-vrc-udon-sharp"><a href="#unity-vrc-udon-sharp" class="headerlink" title="unity-vrc-udon-sharp"></a>unity-vrc-udon-sharp</h3><p>UdonSharp（VRChat SDK 3.10.4を対象として検証）のスクリプティングスキル。このスキルの前提は「UdonSharpは通常のC#に見えて、使えない機能がエラーではなく静かに失敗する」という点にある。<code>List&lt;T&gt;</code> やLINQなどがコンパイルできなかったり、所有権なしに同期変数を書き換えても何も起きなかったりする。そのため、同期モードを選ぶ前に「誰が状態を持つのか」「所有権はいつ移るのか」「後から入った人に何が見えるのか」「所有者が抜けたらどうするのか」という設計判断を先に固める手順が核になっている。ネットワークコードを書く・レビューするときの必読事項集だ。</p><h2 id="モバイル／Quest向けのシェーダー最適化"><a href="#モバイル／Quest向けのシェーダー最適化" class="headerlink" title="モバイル／Quest向けのシェーダー最適化"></a>モバイル／Quest向けのシェーダー最適化</h2><h3 id="mobile-shader-optimization"><a href="#mobile-shader-optimization" class="headerlink" title="mobile-shader-optimization"></a>mobile-shader-optimization</h3><p>モバイルGPUのタイルベースレンダリングを前提に、シェーダーのハードルールを集めたスキル。<code>half</code> 精度をデフォルトにすること、<code>discard</code>（アルファテスト）が早期深度判定を壊すので避けること、テクスチャサンプル数や分岐・ループの制限、スカラーとベクトルの演算順序まで細かく決まっている。Mali／Adreno／PowerVR／AppleといったGPUファミリーごとの注意点や、帯域こそがボトルネックだという考え方が土台にある。Quest向けワールドやモバイル対応のシェーダーを書くときに効く。</p><h3 id="mobile-post-processing"><a href="#mobile-post-processing" class="headerlink" title="mobile-post-processing"></a>mobile-post-processing</h3><p>モバイル向けポストプロセスのスキル。ポストプロセスはパスごとに画面全体の読み書きが発生し、タイル型GPUでは特に高くつく。そこで、ビネットとカラーグレーディングなどを単一パスにまとめる方針と、そのまま使えるシェーダーテンプレートが用意されている。Bloomは最も高コストな部類であること、Motion BlurとDepth of Fieldはモバイルでは使わないという線引き、URPのRenderer Featureとして実装する手順も含む。</p><h3 id="texture-packing-variant-stripping"><a href="#texture-packing-variant-stripping" class="headerlink" title="texture-packing-variant-stripping"></a>texture-packing-variant-stripping</h3><p>テクスチャのチャンネルパッキングと、シェーダーバリアント削減の2本柱のスキル。前者はMask Map（R=Metallic、G=AO、A=Smoothnessなど）のように複数のグレースケールマップを1枚のRGBAに詰める手法で、サンプル数とメモリ帯域を同時に減らす。後者は <code>multi_compile</code> の組み合わせ爆発への対策で、<code>shader_feature</code> との使い分けや、不要なキーワードをビルド時に剥がす方法を扱う。ビルドサイズとシェーダーのコンパイル時間に悩んだときのスキルだ。</p><h2 id="シェーダーを書く"><a href="#シェーダーを書く" class="headerlink" title="シェーダーを書く"></a>シェーダーを書く</h2><h3 id="urp-hlsl-templates"><a href="#urp-hlsl-templates" class="headerlink" title="urp-hlsl-templates"></a>urp-hlsl-templates</h3><p>URPでHLSL／ShaderLabを直接書くときのテンプレート集。SRP Batcher互換のためにプロパティを <code>UnityPerMaterial</code> のCBUFFERに置くこと、URP用のincludeと変換マクロを使うことなど、「URPの作法」をルールとして固定し、UnlitとLitの実用テンプレート、Built-inパイプラインからの変換チートシートを持つ。コードでシェーダーを書く作業の出発点として使う。</p><h3 id="shader-graph-best-practices"><a href="#shader-graph-best-practices" class="headerlink" title="shader-graph-best-practices"></a>shader-graph-best-practices</h3><p>Shader Graph向けのベストプラクティス。モバイルではノード数を100以下に抑えること、グラフ全体の精度をHalfにすること、Sub Graphは整理のためのもので命令数を減らすわけではないこと、複雑な処理はCustom FunctionノードのHLSLに逃がすこと、といった指針が並ぶ。カスタムライティング用のサブグラフ（Cyaniluxのもの）の導入と使い方も扱っている。</p><h3 id="water-fluid-shaders"><a href="#water-fluid-shaders" class="headerlink" title="water-fluid-shaders"></a>water-fluid-shaders</h3><p>水や液体のシェーダーをURPで作るためのスキルで、モバイル最適化が前提。深度による色付け、波打ち際のフォーム、Gerstner波による頂点変位、屈折、コースティクスといった要素を、テクスチャサンプルは4つまで、波の計算は頂点シェーダーで、といった制約と一緒に整理している。機能ごとのコストをTier分けしてあるので、対象デバイスに合わせて引き算しながら組める。最小構成のテンプレート付き。</p><h2 id="テキスト"><a href="#テキスト" class="headerlink" title="テキスト"></a>テキスト</h2><h3 id="optimize-text-mesh-pro"><a href="#optimize-text-mesh-pro" class="headerlink" title="optimize-text-mesh-pro"></a>optimize-text-mesh-pro</h3><p>TextMeshProの最適化スキル。フォントスタックの設計（本体は静的フォントアセット、不足分は動的フォールバックで補う）、動的アトラスのサイズ上限、Paddingとサンプリングポイントサイズの比率をフォント間で揃えること、SDF16の使いどころ、AutoSizeはレイアウト確定後に切ることなど。CJKフォントのサンプリングサイズの目安も含まれる。冒頭に症状別のトリアージ表があり、「メモリ膨張か、品質か、CPUか、ローカライズか」から原因の切り分けに入れる構成になっているのが実務的だ。</p><h2 id="おわりに"><a href="#おわりに" class="headerlink" title="おわりに"></a>おわりに</h2><p>12本を通して見ると、役割は大きく「ドメイン知識の辞書」（liltoon、poiyomi、World SDK）、「失敗パターンの先回り」（UdonSharp、Modular Avatar）、「制約の明文化」（モバイル最適化系）に分かれる。エージェントの生成物が安定するかどうかは、結局のところこの3種類をどれだけ具体的に渡せるかにかかっている、というのが運用してみての実感だ。</p>]]></content>
    
    
    <summary type="html">VRChatのアバター改変とワールド制作をAIエージェントに手伝わせるために外付けしたスキル12本を紹介。lilToon／Poiyomi／Modular Avatar、UdonSharpとWorld SDK、モバイル向けシェーダー最適化、TextMeshProまで。</summary>
    
    
    
    
    <category term="VRChat" scheme="https://blog.n1l.dev/tags/VRChat/"/>
    
    <category term="AI" scheme="https://blog.n1l.dev/tags/AI/"/>
    
    <category term="エージェントスキル" scheme="https://blog.n1l.dev/tags/%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%82%B9%E3%82%AD%E3%83%AB/"/>
    
    <category term="Unity" scheme="https://blog.n1l.dev/tags/Unity/"/>
    
    <category term="シェーダー" scheme="https://blog.n1l.dev/tags/%E3%82%B7%E3%82%A7%E3%83%BC%E3%83%80%E3%83%BC/"/>
    
  </entry>
  
  <entry>
    <title>VRChatワールドのライティング実践メモ ― ライトマップ、LTCGI、動画プレイリスト運用</title>
    <link href="https://blog.n1l.dev/2026/11/vrchat-lighting-ltcgi/"/>
    <id>https://blog.n1l.dev/2026/11/vrchat-lighting-ltcgi/</id>
    <published>2026-11-19T12:58:00.000Z</published>
    <updated>2026-11-22T13:54:02.938Z</updated>
    
    <content type="html"><![CDATA[<p>ワールドのライティングは、設定項目が多く、デフォルトのまま回すとベイクが終わらなかったり、思った明るさにならなかったりしがちだ。ここでは自分のワールド制作で使っている設定値と考え方を、ライトマップ、LTCGI、そして動画プレイリストの運用まわりの小ネタと一緒にメモしておく。数値はあくまで自分の環境での実績値で、ワールドの規模によって調整は要る。</p><span id="more"></span><h2 id="ライトマップベイクは「軽く、十分に」"><a href="#ライトマップベイクは「軽く、十分に」" class="headerlink" title="ライトマップベイクは「軽く、十分に」"></a>ライトマップベイクは「軽く、十分に」</h2><p>UnityのProgressive Lightmapperで最初に見直すのは Lightmap Resolution（解像度）だ。デフォルトの40や、プリセットによっては85といった値はテクセル数が爆発的に増え、GI計算が事実上フリーズする。自分の環境では <strong>10〜20 texels/unit</strong> に落とすのが現実解で、見た目の破綻もほぼない。</p><p>サンプル数も盛りすぎない。<strong>Direct: 32、Indirect: 128〜256、Bounces: 2〜3</strong> で十分に高品質な結果が得られている。ベイク時間は制作のイテレーション速度に直結するので、「品質を上げる前に、まず回せる設定にする」のが大事だと思っている。</p><p>動的なアバターへの光の当たり方については、Unity標準のLight Probesの代替・補完として <strong>VRC Light Volumes</strong> を使っている。<code>Voxels Per Unit</code> は、柔らかい光でよければ <strong>1〜3</strong>、影の細かい部屋では <strong>3〜8</strong> が目安。また <code>Generate Light Probes</code> を有効にしておくと、Light Volumesに非対応のアバター向けのプローブも自動生成されるので、互換性のために入れておくと安心だ。</p><h2 id="LTCGI：画面の光を部屋に染める"><a href="#LTCGI：画面の光を部屋に染める" class="headerlink" title="LTCGI：画面の光を部屋に染める"></a>LTCGI：画面の光を部屋に染める</h2><p>動画プレイヤーなどの「画面」から出る光を周囲にリアルタイムで反映させる仕組みがLTCGIで、ワールドの雰囲気づくりに効く。導入側の要点は2つ。</p><p>まずマテリアル設定。Filamented系（Roughness setup）やStandardRoughnessのマテリアルでは、Inspectorで <strong>LTCGIをON（<code>_LTCGI: 1</code>）</strong> にしないと光を受けない。そして <strong>Roughnessは0.5〜0.8程度のマットな値</strong> にしておくと、光が壁全体に拡散（Diffuse）して綺麗に染まる。逆にRoughnessが0だと鋭い鏡面反射だけになって、光が当たっているのか分かりにくい。</p><p>次に、拡散の方式として <strong>LTC Diffuse</strong> と <strong>Lightmap Diffuse</strong> の使い分けがある。</p><ul><li><strong>LTC Diffuse</strong>：リアルタイムの数学計算（LTC）で光を当てる方式。ベイク不要で即座に反映され、アバターに当たるのと同じくらい強い光が得られる。個室のような小さな空間や、手軽なセットアップに向く。</li><li><strong>Lightmap Diffuse</strong>：Shadowmapのベイクが必要になる代わりに、遮蔽の計算ができる。柱の裏側への光漏れを防ぎたいような場面ではこちら。</li></ul><p>ハマりどころとして、<code>Lightmap Channel</code> が <code>Off (0)</code> の状態で <code>Bake Shadowmap</code> を押すと <strong>「No LTCGI_Screen」警告</strong> が出る。方式を選んだら、チャンネル設定までセットで確認するのが安全だ。</p><h2 id="ベイクとアップロードの「待ち」を音で知らせる"><a href="#ベイクとアップロードの「待ち」を音で知らせる" class="headerlink" title="ベイクとアップロードの「待ち」を音で知らせる"></a>ベイクとアップロードの「待ち」を音で知らせる</h2><p>ライトマップのベイクもアバター／ワールドのアップロードも、それなりに時間がかかる。完了に気づかず放置するのが一番もったいないので、自分はエディタ用の通知ツールを自作して使っている。</p><p>仕組みは単純で、<code>UnityEditor.AudioUtil.PlayPreviewClip</code> をリフレクション経由で呼び、エディタ上で安全に <code>.mp3</code> を再生する。発火タイミングは <code>Lightmapping.bakeCompleted</code>（ベイク完了）と、VRChat SDKのコントロールパネルのイベント（アップロード完了）にフックしている。Unityの表に出ていないAPIを使うのでリフレクションになるが、「完了を音で知る」だけで制作の回転がだいぶ良くなる。小さい工夫だがおすすめだ。</p><h2 id="動画プレイリスト運用：重複は溜まるものとして対策する"><a href="#動画プレイリスト運用：重複は溜まるものとして対策する" class="headerlink" title="動画プレイリスト運用：重複は溜まるものとして対策する"></a>動画プレイリスト運用：重複は溜まるものとして対策する</h2><p>ワールドの動画プレイヤーにはVizVid（VVMW）を使っている。運用していて地味に困るのがプレイリストの重複で、VizVidの標準機能では、YouTubeプレイリストの取り込み、JSONの読み込み、他プレイヤーからの移行の <strong>いずれでも重複URLのチェックは行われず、そのまま末尾に追加される</strong>。プレイリストを育てる運用をしていると、重複は確実に溜まっていく。</p><p>対策として、プレイリスト編集用のエディタ拡張（<code>PlayListEditorWindow</code>）に手を入れた。</p><ul><li>取り込み側（<code>FetchPlayList</code>／<code>LoadEntries</code>）に <code>HashSet&lt;string&gt;</code> を使った重複URLのスキップ処理を入れ、新規追加では重複が入らないようにした。</li><li>既存のプレイリストにも重複が残っているので、下部の操作バーに <strong>「重複削除」ボタン</strong> を追加し、選択中のプレイリストから重複動画を一括で消せるようにした。</li></ul><p>「入る入口で防ぐ」と「溜まった分は一括で掃除できる」の両方を用意しておくと、プレイリスト運用はだいぶ楽になる。</p><h2 id="まとめ"><a href="#まとめ" class="headerlink" title="まとめ"></a>まとめ</h2><ul><li>ライトマップは解像度10〜20、サンプルも控えめに。まず回せる設定にする</li><li>アバターへの光はVRC Light Volumes、密度は空間の細かさで調整する</li><li>LTCGIはマテリアルの有効化とRoughness 0.5〜0.8が肝。拡散方式は遮蔽の要否で選ぶ</li><li>長い待ち時間はエディタ通知で潰す。プレイリストの重複は仕様として対策しておく</li></ul>]]></content>
    
    
    <summary type="html">VRChatワールド制作で蓄積したライティングまわりの実践メモ。ライトマップベイクの現実的な設定値、VRC Light Volumes、画面光を反映するLTCGIの使い分け（LTC DiffuseとLightmap Diffuse）、ベイク完了を音で知らせる小物、VizVidプレイリストの重複対策まで。</summary>
    
    
    
    
    <category term="VRChat" scheme="https://blog.n1l.dev/tags/VRChat/"/>
    
    <category term="Unity" scheme="https://blog.n1l.dev/tags/Unity/"/>
    
    <category term="ライティング" scheme="https://blog.n1l.dev/tags/%E3%83%A9%E3%82%A4%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0/"/>
    
    <category term="LTCGI" scheme="https://blog.n1l.dev/tags/LTCGI/"/>
    
  </entry>
  
  <entry>
    <title>複数AIエージェントで共有する「共通の脳」agent-cortexの設計</title>
    <link href="https://blog.n1l.dev/2026/11/agent-cortex-design/"/>
    <id>https://blog.n1l.dev/2026/11/agent-cortex-design/</id>
    <published>2026-11-19T12:55:00.000Z</published>
    <updated>2026-11-22T13:54:02.938Z</updated>
    
    <content type="html"><![CDATA[<p>AIコーディングエージェントを1つだけ使っているうちは、指示や覚えたことをそのツールの設定に閉じておけば済む。ところが Codex、Gemini CLI、Antigravity を併用し、しかも Windows / Linux / macOS の複数マシンを行き来するようになると、話が変わってくる。あるエージェントに教えた規約を、別のエージェントは知らない。あるマシンで直したルールが、別のマシンでは古いまま残る。</p><p>agent-cortex は、このずれをなくすための個人的なリポジトリだ。README には「エージェントの自律学習データ、コーディング規約、カスタムスキル、およびツール実行の自動承認許可リストを複数マシン間で自動同期するリポジトリ」とある。いわば、エージェント個別の記憶ではなく、エージェントの外側に置いた共通の脳である。</p><p>この記事では、公開できる範囲でその設計の考え方を整理する。設定ファイルの原文や運用の詳細ではなく、構造と思想の部分だけを取り上げる。</p><span id="more"></span><h2 id="入口は薄く保つ"><a href="#入口は薄く保つ" class="headerlink" title="入口は薄く保つ"></a>入口は薄く保つ</h2><p>各エージェントには、それぞれが最初に読む入口ファイルがある。Codex 向けは <code>AGENTS.md</code>、Antigravity 向けは <code>GEMINI.md</code> で、どちらも 1KB 程度の小さなファイルだ。</p><p>中身はルールの本文ではなく、索引に徹している。「常時適用ルールは <code>rules/global_rules.md</code> を読むこと」「プロジェクト作業では現在のワークスペース側の指示を優先すること」「バックアップは必要箇所だけ参照すること」といった、読み込み方そのものの指定が中心になる。</p><p>入口を厚くしない理由は単純で、起動時に毎回読み込むものは、コンテキストをそのまま消費するからだ。本文を入口に詰め込むのではなく、入口は入口として分離し、実体は必要になったときに辿る。この割り切りが全体を通して貫かれている。</p><h2 id="常時適用ルールは1ファイルに絞る"><a href="#常時適用ルールは1ファイルに絞る" class="headerlink" title="常時適用ルールは1ファイルに絞る"></a>常時適用ルールは1ファイルに絞る</h2><p>共通ルールの実体は <code>rules/global_rules.md</code> の1ファイルだけに集約されている。ここに入るのは、どのマシン・どのプロジェクトでも常に効かせたい行動原則だけだ。</p><p>たとえば、質問や相談と編集の許可を区別すること、破壊的な操作を避けて事前に影響と復旧手段を確認すること、推測で機能や抽象化を足さず単純な解法を優先すること、再利用できる訂正だけを記録し履歴を積み上げないこと。いずれも「毎回効いていないと困る」性質のものに限られる。</p><p>逆に、過去の技術レシピや詳細な作法は常時適用から外し、旧版ルールのアーカイブとして <code>knowledge/archive/</code> に退避している。アーカイブは参考資料であって強制標準ではない、という位置づけも明記されている。ルールを増やすことよりも、常時読み込む量を増やさないことの方を優先する設計だ。</p><h2 id="skills-knowledge-projects-の3層構造"><a href="#skills-knowledge-projects-の3層構造" class="headerlink" title="skills / knowledge / projects の3層構造"></a>skills / knowledge / projects の3層構造</h2><p>入口とルールの先は、性質の違う3つの置き場に分かれている。</p><p>1つ目は <code>skills/</code>。再利用できる作業手順をスキル単位で収めた場所で、現在は90を超えるフォルダがある。重要なのは、スキルは起動時に全部読むものではないという点で、使うスキルの <code>SKILL.md</code> だけを、そのときに開く。</p><p>2つ目は <code>knowledge/</code>。技術的な知識やトラブルシュートの記録をトピック別に分けたもので、<code>archive</code>、<code>network</code>、<code>oci</code>、<code>projects</code>、<code>proxmox</code>、<code>vrchat</code> といったフォルダ構成になっている。障害対応の経緯や具体的なレシピは、常時ルールではなくこちらに置く。解決済みの事象をルールに混ぜないための受け皿である。</p><p>3つ目は <code>projects/</code>。各ワークスペースの指示ファイルを自動収集したバックアップ置き場だ。ここは特に扱いが明確で、同期バックアップであり、起動時に読み込むためのものではない。ファイルによっては非常に大きくなるため、まず <code>projects/INDEX.md</code> で章別の索引を引き、該当プロジェクトの必要な passage だけを確認する運用になっている。「Never load all project backups」という注意書きが入口ファイル側にもあるくらい、この点は徹底している。</p><p>つまり、常時読むもの（rules）、必要時に引くもの（knowledge / skills）、非常時の参照用バックアップ（projects）という、読み込み頻度と寿命で層を分けている。</p><h2 id="同期は-Git-とスケジューラで回す"><a href="#同期は-Git-とスケジューラで回す" class="headerlink" title="同期は Git とスケジューラで回す"></a>同期は Git とスケジューラで回す</h2><p>共有の仕組み自体は凝ったものではなく、Git が土台になっている。各マシンでは Windows ならタスクスケジューラ、Linux / macOS なら Cron が定期的に同期スクリプトを回し、ルールや知識やスキルをリモートと揃える。手動で同期したいときのために、同期そのものを担当するスキルも用意されていて、「同期して」「並列化して」といった依頼でスクリプト実行と結果確認までを担う。</p><p>Codex 向けには接続用の仕組みもあり、各マシンの Codex 用指示ファイルに、共有 <code>AGENTS.md</code> を参照するブロックを冪等に追加する。既存の指示は保持され、再実行してもブロックは増えない。入口を各ツールに合わせて薄く用意し、実体は1か所に寄せるための配線である。</p><p>なお、同期されるものの中には権限設定も含まれるが、これはエージェント間で自動的に流用されるわけではない。Antigravity の許可リストが Codex のツール実行を許可するものではない、という線引きも入口に書かれている。共有することと、権限まで共有することとは別だという意識がうかがえる。</p><h2 id="タスク終了時に知識を棚卸しする"><a href="#タスク終了時に知識を棚卸しする" class="headerlink" title="タスク終了時に知識を棚卸しする"></a>タスク終了時に知識を棚卸しする</h2><p>もう1つの柱が、タスク終了時の知識レビューである。Codex の Stop フック、Gemini CLI の AfterAgent フック、Antigravity の Stop フックから、共通スキル <code>knowledge-maintainer</code> をタスクごとに一度だけ呼び出す構成になっている。</p><p>このレビューでやるのは、新しく得た知見のうち「持続するもの」だけを選別することだ。新しい事実、誤っていた前提の訂正、長く効くプロジェクト判断、再利用できる障害対応策が候補になる。一時的なログや時刻、未確認の主張、秘密情報や個人データは捨てる。既存のルールや知識を先に検索して重複を避け、置き場所は性質で振り分ける。横断的な行動原則は共通ルールへ（ただし稀）、プロジェクト固有の現行方針はワークスペースの指示へ、詳細な技術や事象はトピック別の knowledge へ、という具合だ。</p><p>大事なのは、学ぶことがなければ何も保存しないのが正常な結果とされている点と、レビュー自体は読み取り専用で、書き込みは既存の承認ルールの範囲でしか行わない点だ。学習のために勝手にコミットや Push や同期をしてはいけない。知識を増やす仕組みが暴走しないよう、出口にブレーキが付いている。</p><h2 id="まとめ"><a href="#まとめ" class="headerlink" title="まとめ"></a>まとめ</h2><p>agent-cortex の設計を一言でまとめると、「全部覚えさせる」のではなく「読む量を制御する」ための仕組みだと思う。</p><p>入口は薄く、常時ルールは1ファイルに絞り、知識とスキルは必要時にだけ引き、巨大なバックアップは索引経由で部分参照する。そしてタスクの終わりに一度だけ棚卸しをして、残す価値のあるものだけを適切な層へ戻す。</p><p>エージェントの性能が上がるほど、与える情報の量よりも、どの情報をいつ渡すかの設計の方が効いてくる。このリポジトリは、その制御を Git とファイル構成という素朴な手段で実現しようとした試みである。</p>]]></content>
    
    
    <summary type="html">Codex、Gemini CLI、Antigravityと複数マシンで、ルール・知識・スキルを共有する「共通の脳」agent-cortexの設計。入口ファイルを薄く保つ工夫、3層構造、Gitによる自動同期と知識の棚卸しを紹介する。</summary>
    
    
    
    
    <category term="AIエージェント" scheme="https://blog.n1l.dev/tags/AI%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88/"/>
    
    <category term="Codex" scheme="https://blog.n1l.dev/tags/Codex/"/>
    
    <category term="Gemini CLI" scheme="https://blog.n1l.dev/tags/Gemini-CLI/"/>
    
    <category term="Antigravity" scheme="https://blog.n1l.dev/tags/Antigravity/"/>
    
    <category term="Git" scheme="https://blog.n1l.dev/tags/Git/"/>
    
  </entry>
  
  <entry>
    <title>知識を腐らせない仕組み系スキル — knowledge-maintainer、parallelize、ponytail</title>
    <link href="https://blog.n1l.dev/2026/11/skills-knowledge-system/"/>
    <id>https://blog.n1l.dev/2026/11/skills-knowledge-system/</id>
    <published>2026-11-19T12:52:00.000Z</published>
    <updated>2026-11-22T13:54:02.938Z</updated>
    
    <content type="html"><![CDATA[<p>エージェントに知識を覚えさせる仕組みを作ると、だいたい2つの問題にぶつかる。1つは、覚えたはずの知識が各マシンや各エージェントに散らばって同期されなくなること。もう1つは、知識もコードも、足すばかりで削られないために膨らみ続け、やがて古い情報や過剰な仕組みが腐っていくことだ。</p><p>agent-cortex のスキル群の中には、この「保守」側を担う仕組み系のスキルが揃っている。この記事では <code>knowledge-maintainer</code> と <code>parallelize</code>、そして過剰設計を抑える <code>ponytail</code> 系6スキルを取り上げる。いずれも派手な生成系スキルではないが、長く運用するほど効いてくる類のものだ。</p><span id="more"></span><h2 id="knowledge-maintainer：-終わりに一度だけ棚卸しする"><a href="#knowledge-maintainer：-終わりに一度だけ棚卸しする" class="headerlink" title="knowledge-maintainer： 終わりに一度だけ棚卸しする"></a>knowledge-maintainer： 終わりに一度だけ棚卸しする</h2><p><code>knowledge-maintainer</code> は、タスク終了時の知識レビューを担当するスキルだ。Codex、Gemini CLI、Antigravity のいずれでも、メインエージェントのタスクの終わりに一度だけ実行される想定になっている。読み取りだけのタスクでも対象で、「学ぶことがなかった」が正規の結論として認められているのが特徴だ。</p><p>処理の流れはおおむね次の通りである。</p><p>まず、持続する新しい事実、前提の訂正、長く効くプロジェクト判断、再利用できるトラブルシュート策を拾う。逆に、一時的なログ、タイムスタンプ、定型出力、検証できない主張、秘密情報や個人データは最初から捨てる。</p><p>次に、編集前に既存のワークスペースルールと関連する knowledge を検索し、すでに書かれている内容を重複して足さない。巨大なバックアップや大きな指示ファイルを全部読み込むこともしない。</p><p>置き場所は性質で決まる。プロジェクト横断の行動原則は共有の共通ルールへ（ただし稀なケース）、プロジェクトの現行方針はワークスペースの指示へ、詳細な技術や事象の記録はトピック別の knowledge やプロジェクト文書へ。古くなったことが確実な知識は、追記ではなく統合や置き換えで処理する。元の仕様や安全ルール、矛盾する証拠は、決着するまで残すという留保も付いている。</p><p>そして、このレビュー自体は読み取り専用が原則だ。書き込みは、ユーザーの既存の明示的な承認とプロジェクトの承認要件の範囲内でのみ行い、それ以外では「内容と保存先の提案」に留める。学習を理由に自動でコミット、Push、マージ、同期、サービス再起動、SSH 変更をしてはいけない。最後に、学びがなければ「学習: なし」と短く報告し、あれば更新した（あるいは提案する）保存先を名指しする。</p><p>要するに、記憶の入り口に選別と振り分けと承認の3つの関門を置いたスキルである。起動時の指示ファイルをコンパクトに保ち、詳細はオンデマンドで引ける場所へ逃がす、という全体方針の出口側を担っている。</p><h2 id="parallelize：-同期そのものをスキルにする"><a href="#parallelize：-同期そのものをスキルにする" class="headerlink" title="parallelize： 同期そのものをスキルにする"></a>parallelize： 同期そのものをスキルにする</h2><p><code>parallelize</code> は、agent-cortex リポジトリとの同期を担当するスキルだ。「同期して」「並列化して」「最新の記憶を同期」といった依頼や、自動同期のセットアップを求められたときに使う。</p><p>やること自体は素朴で、OS ごとに用意された同期スクリプトを叩く。Windows では PowerShell の同期スクリプト、Linux / macOS では Bash の同期スクリプトが対象になる。自動同期のセットアップでは、Windows ならタスクスケジューラ登録用、Linux / macOS なら Cron 登録用のスクリプトを実行する。</p><p>このスキルの要点は、実行して終わりではなく確認まで含む点にある。同期後に、リモートから新しい知識を取得したか、ローカルの学びをアップロードしたか、スケジュールによるバックグラウンド同期が有効かどうかを報告する。同期という定型作業をスキル化しておくことで、どのエージェントから頼んでも同じ手順・同じ報告形式になる。</p><p><code>knowledge-maintainer</code> が「何を残すか」を決め、<code>parallelize</code> が「残したものをどう全マシンへ配るか」を担う、という分担である。</p><h2 id="ponytail：-怠惰なシニア開発者という型"><a href="#ponytail：-怠惰なシニア開発者という型" class="headerlink" title="ponytail： 怠惰なシニア開発者という型"></a>ponytail： 怠惰なシニア開発者という型</h2><p>ここからは毛色が違う。<code>ponytail</code> は、動作する解法の中で最も怠惰なもの、つまり最も単純で、最も短く、最も小さいものを強制するスキルだ。ドキュメント上、名前の由来は明確には説明されていない。比喩として提示されているのは髪型ではなく、「すべてを見てきたシニア開発者」の人格である。曰く、怠惰とは非効率ではなく効率のことであり、最も良いコードは書かれなかったコードだ、という立場を取る。</p><p>中核にあるのは7段のはしごで、最初に足が掛かった段で止まる。</p><p>1.そもそも存在する必要があるか（YAGNI）<br>2.このコードベースに既にあるものを使えないか<br>3.標準ライブラリでできないか<br>4.プラットフォームのネイティブ機能で賄えないか<br>5.インストール済みの依存で解けないか<br>6.1行で書けないか<br>7.それでも無理なら、動作する最小のコードを書く</p><p>強度は <code>lite</code>、<code>full</code>（デフォルト）、<code>ultra</code> の3段階がある。lite は求められたものを実装しつつ、より怠惰な代替案を1行で添える。full ははしごを強制する。ultra は YAGNI の徹底で、追加より削除を優先し、要件そのものにも異議を唱える。</p><p>ルールも具体的だ。依頼されていない抽象化、将来のための足場作り、ボイラープレートは禁止。追加より削除、賢さより退屈さを選ぶ。意図的に天井のある単純化をした場合（全体ロックや単純なヒューリスティックなど）は、<code>ponytail:</code> コメントで天井と改善の道筋を明記する。出力はコードが先で、説明は最大3行まで。「何を省略したか、いつ足すべきか」だけを書く形式が指定されている。</p><p>一方で、怠惰にしてはいけない範囲も明記されている。信頼境界での入力検証、データ損失を防ぐエラーハンドリング、セキュリティ対策、アクセシビリティの基本は単純化の対象外だ。そして何より、問題の理解については怠けるな、とある。はしごは解法を短くするもので、読む量を減らすものではない。小さい差分を出すために理解を飛ばすのは、最も危険な種類の怠惰だという戒めだ。</p><h2 id="ponytail-の周辺スキル"><a href="#ponytail-の周辺スキル" class="headerlink" title="ponytail の周辺スキル"></a>ponytail の周辺スキル</h2><p>ponytail 本体が「作るときの型」だとすれば、周辺の5スキルは点検と可視化を担う。いずれも一回限りの実行で、勝手に修正を適用しないものが多い。</p><p><code>ponytail-review</code> は、差分（diff）に対する過剰設計専門のレビューだ。正しさのレビューとは分業で、複雑さだけを狩る。指摘は1行形式で、<code>delete:</code>（死んだコードや投機的機能）、<code>stdlib:</code>（標準ライブラリで置き換え可能）、<code>native:</code>（プラットフォーム機能で代替可能）、<code>yagni:</code>（実装が1つしかない抽象化など）、<code>shrink:</code>（同じロジックをより短く）のタグを付ける。最後に「正味で何行減らせるか」だけをスコアとして出す。削るものがなければ、それで終わりと宣言する。</p><p><code>ponytail-audit</code> は、そのリポジトリ全体版である。差分ではなくツリー全体を走査し、削れるものを削減量の大きい順に並べる。単一実装のインターフェース、委譲だけのラッパー、誰も設定しない設定項目などが対象になる。こちらも報告のみで修正はしない。</p><p><code>ponytail-debt</code> は、<code>ponytail:</code> コメントを回収して負債台帳にするスキルだ。本体が「天井と再訪条件をコメントに残す」運用なので、そのコメントを grep で集め、ファイルごとに「何を単純化したか、天井は何か、見直すきっかけは何か」を一覧化する。再訪条件の書かれていないコメントには印を付け、「後で」が「永遠にやらない」に化けるのを防ぐ。</p><p><code>ponytail-gain</code> は、行数・コスト・速度について公開ベンチマークの中央値をスコアボード表示するスキルだ。誠実さの境界線が明記されていて、ベンチマーク値を現在のリポジトリの実績のように見せてはいけないとされる。書かれなかった版は基準にならないため、実数として数えられるのは <code>ponytail-debt</code> の台帳だけだという整理である。</p><p><code>ponytail-help</code> は、レベルや各スキルの呼び出し方、デフォルトモードの設定方法（環境変数、設定ファイル、デフォルトの順に解決される）などをまとめたクイックリファレンスカードだ。困ったときに引く索引として置かれている。</p><h2 id="まとめ"><a href="#まとめ" class="headerlink" title="まとめ"></a>まとめ</h2><p>3系統を並べてみると、役割分担が見えてくる。<code>knowledge-maintainer</code> は知識の入り口で選別し、<code>parallelize</code> は選ばれた知識を全環境へ配り、<code>ponytail</code> 系はそもそも余分なものを生まないことと、生まれた借りを可視化し続けることを担う。</p><p>知識管理というと「どう保存するか」ばかりが話題になりがちだが、実際の運用で先に壊れるのは保存先ではなく、選別と棚卸しの方だと思う。足す仕組みと同じくらい、捨てる仕組みと数える仕組みを用意しておくこと。このスキル群は、その地味な側を型として固定しようとしたものだ。</p>]]></content>
    
    
    <summary type="html">AIエージェントの知識を腐らせないための仕組み系スキルを紹介。タスク終了時に知識を選別・同期するknowledge-maintainerとparallelize、過剰設計を抑えるponytail系スキルの役割と運用。</summary>
    
    
    
    
    <category term="AIエージェント" scheme="https://blog.n1l.dev/tags/AI%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88/"/>
    
    <category term="スキル" scheme="https://blog.n1l.dev/tags/%E3%82%B9%E3%82%AD%E3%83%AB/"/>
    
    <category term="知識管理" scheme="https://blog.n1l.dev/tags/%E7%9F%A5%E8%AD%98%E7%AE%A1%E7%90%86/"/>
    
    <category term="リファクタリング" scheme="https://blog.n1l.dev/tags/%E3%83%AA%E3%83%95%E3%82%A1%E3%82%AF%E3%82%BF%E3%83%AA%E3%83%B3%E3%82%B0/"/>
    
  </entry>
  
  <entry>
    <title>AIにデザインの「味」を教える ― デザイン系エージェントスキルカタログ</title>
    <link href="https://blog.n1l.dev/2026/11/skills-design-catalog/"/>
    <id>https://blog.n1l.dev/2026/11/skills-design-catalog/</id>
    <published>2026-11-19T12:49:00.000Z</published>
    <updated>2026-11-22T13:54:02.938Z</updated>
    
    <content type="html"><![CDATA[<p>コーディングエージェントにUIを作らせると、動くものはすぐ出てくる。ただ、出てくる画面はたいてい「どこかで見たような」無難なものになりがちだ。紫がかったグラデーション、均等に並んだカード、意味のないバッジ。英語圏ではこういう「AI生成っぽい凡庸さ」を slop と呼ぶことがある。</p><p>これへの対策として、判断基準や参照資料を「スキル」としてファイルに外付けし、エージェントに読ませる運用をしている。自分のスキル置き場（複数のAIエージェントで共有している agent-cortex）にはデザイン系のスキルが十数個入っているので、カタログとして紹介してみる。なお、この中には公開されている手法や個人の知見をスキル化したものも多い。ここでは内容の転載ではなく、「どういう観点をスキルにしているか」という紹介にとどめる。</p><span id="more"></span><h2 id="「slopを止める」系"><a href="#「slopを止める」系" class="headerlink" title="「slopを止める」系"></a>「slopを止める」系</h2><h3 id="anti-ui-slop"><a href="#anti-ui-slop" class="headerlink" title="anti-ui-slop"></a>anti-ui-slop</h3><p>「AIエージェントに generic なUIを出させない」ことに特化したスキルで、UIZZE というデザイン参照サービスに由来する。実在するWeb・iOS画面の大規模カタログを参照しながら、対象プロダクト固有のデザインの約束事（デザイン契約）を決め、ローディング・空・エラーといった必要な状態を網羅し、最後に finish gate と呼ばれるチェックを通す、という流れを作業手順として強制する。新規作成から出荷前レビューまで、画面に関わる作業全般で使う。</p><h3 id="taste-skill（design-taste-frontend）"><a href="#taste-skill（design-taste-frontend）" class="headerlink" title="taste-skill（design-taste-frontend）"></a>taste-skill（design-taste-frontend）</h3><p>企業サイトやランディングページを「テンプレートに見えない」水準で作るためのスキル。実在の製品UIや写真を使うこと、セクション構成や余白についての house rule を持つこと、そして実ブラウザでレンダリングして確認するチェッカーと finish gate で担保することが柱になっている。「AIっぽい」「テンプレっぽい」と感じた画面の作り直しにも使う想定のスキル。</p><h3 id="impeccable"><a href="#impeccable" class="headerlink" title="impeccable"></a>impeccable</h3><p>デザイン全般を扱う汎用スキル。設計、リデザイン、批評、監査、ポリッシュ、単純化、モーションの追加まで幅広く、対象もLP、ダッシュボード、フォーム、設定画面、空状態、モバイル画面と広い。観点は階層構造、タイポグラフィ、色、UXコピー、アクセシビリティ、レスポンシブ、エッジケース。特徴的なのは「攻めるための画面では大胆に、管理画面のような実用画面では精密さと抑制で勝負する」というように、画面の性質に応じて力の入れ方を変える思想を持っていること。</p><h2 id="「型」を取り込む系"><a href="#「型」を取り込む系" class="headerlink" title="「型」を取り込む系"></a>「型」を取り込む系</h2><h3 id="apple-design"><a href="#apple-design" class="headerlink" title="apple-design"></a>apple-design</h3><p>AppleのWWDCデザインセッション、とりわけ流体インターフェース（Fluid Interfaces）の考え方をWeb向けに翻訳したスキル。スプリングアニメーション、ジェスチャへの1:1の追従、途中で掴んで反転できるモーション、操作の速度をアニメーションに継承することなど、「触っていて物理的に感じる」UIのための観点を扱う。シートやスワイプのようなジェスチャ駆動のUIを作るときの参照先。</p><h3 id="emil-design-eng"><a href="#emil-design-eng" class="headerlink" title="emil-design-eng"></a>emil-design-eng</h3><p>デザインエンジニア Emil Kowalski の設計哲学をスキル化したもの。「味は生まれつきではなく訓練で身につく」「ユーザーが意識しない細部の積み重ねが体験になる」という立場で、ボタンのプレス状態、ポップオーバーの出現原点、トランジションとキーフレームの使い分けといった、コンポーネントの磨き込みを扱う。レビューの出力形式（Before/Afterを並べた表で出す）まで決まっているのが実務的で面白い。</p><h3 id="frontend-design"><a href="#frontend-design" class="headerlink" title="frontend-design"></a>frontend-design</h3><p>特定の手法ではなく、「デザインリードとしての姿勢」を与えるタイプのスキル。プロダクトの題材――業界、素材、言葉遣い――から視覚的な選択を導くこと、パレットや書体をいつものデフォルトに流れないよう意図的に選ぶこと、といった進め方を扱う。新規UIの方向決めの段階で効く。</p><h2 id="引き出しを提供する系"><a href="#引き出しを提供する系" class="headerlink" title="引き出しを提供する系"></a>引き出しを提供する系</h2><h3 id="ui-ux-pro-max"><a href="#ui-ux-pro-max" class="headerlink" title="ui-ux-pro-max"></a>ui-ux-pro-max</h3><p>観点ではなく「検索できる引き出し」を提供するスキル。スタイル、プロダクト別のカラーパレットとその選定理由、フォントペアリング、UXガイドライン、アイコン、GSAPのプリセット、チャート種別、技術スタック別の指針などがローカルデータとして用意されていて、必要なときに検索して引く。ルールにはアクセシビリティやタッチ操作を上位とする優先順位が付いている。判断に迷ったときの参照先として使う。</p><h2 id="DESIGN-md系-―-設計を文書にして渡す"><a href="#DESIGN-md系-―-設計を文書にして渡す" class="headerlink" title="DESIGN.md系 ― 設計を文書にして渡す"></a>DESIGN.md系 ― 設計を文書にして渡す</h2><h3 id="design-md"><a href="#design-md" class="headerlink" title="design-md"></a>design-md</h3><p>Google Stitch のプロジェクトを解析し、既存画面のHTMLやテーマ情報から DESIGN.md（デザインの正本ドキュメント）を合成するスキル。画面のデザイン言語をいったん文書化して、次の画面生成の入力にするためのもの。</p><h3 id="taste-design"><a href="#taste-design" class="headerlink" title="taste-design"></a>taste-design</h3><p>こちらは Stitch 向けに DESIGN.md を「生成する」側のスキル。雰囲気を密度・レイアウトの非対称性・モーションの量といったスケールで表し、色の調整、タイポグラフィ、コンポーネントの振る舞い、モーションの哲学、そして禁止パターンの明示までを1ファイルに落とす。「やること」だけでなく「やらないこと」を文書に書くのが要点だと思っている。</p><h3 id="learn-taste"><a href="#learn-taste" class="headerlink" title="learn-taste"></a>learn-taste</h3><p>味を「与える」のではなく「蓄積する」スキル。セッション中にユーザーが行ったデザイン修正――明示的な指摘だけでなく、無言の編集や差し戻しも手がかりにする――を拾い、理由付きのルールに変換して DESIGN.md やプロジェクトスキルに残す。可能なら、文章のルールではなく lint チェックのような機械的に検出できる形にする。ユーザーが言っていないルールを足さない、理由を推測で書かない、といった歯止めまで含めて設計されているのがこのスキルの肝。</p><h2 id="日本語とローカライズ"><a href="#日本語とローカライズ" class="headerlink" title="日本語とローカライズ"></a>日本語とローカライズ</h2><h3 id="design-md-jp"><a href="#design-md-jp" class="headerlink" title="design-md-jp"></a>design-md-jp</h3><p>日本語UIのためのタイポグラフィ標準を扱うスキルで、kzhrknt/awesome-design-md-jp を元にしている。和文フォントのフォールバックチェーン、漢字の密度に合わせた行間・字間、プロポーショナル字詰め、禁則処理といった、CJK特有の論点を DESIGN.md 形式で扱えるようにしたもの。WebだけでなくUnityのUIも対象にしている。欧文前提のデザイン指針だけだと日本語画面で静かに崩れる部分を埋める役割。</p><h3 id="nihongo"><a href="#nihongo" class="headerlink" title="nihongo"></a>nihongo</h3><p>デザインそのものではないが、UI文言や文章全般の相方になるスキル。日本語の返答や文章作成を扱い、「その場で日本語話者が自然に書く文になっているか」という観点、相手・媒体・目的に合わせた硬さの選択、資料にない事実を足さないことなどを原則として持つ。UIコピーの自然さもデザインの一部だと思っているので、ここに並べておく。</p><h3 id="localization"><a href="#localization" class="headerlink" title="localization"></a>localization</h3><p>Unity Localization のセットアップを扱うスキル。ロケール、String Table / Asset Table、Addressablesとの連携、CJKフォントの扱いなど、ゲームの多言語対応が対象。日本語フォント周りの配慮という点では design-md-jp と対になる存在。</p><h2 id="まとめ"><a href="#まとめ" class="headerlink" title="まとめ"></a>まとめ</h2><p>並べてみると共通しているのは、「味」を一言の指示ではなく、参照（実在の画面や検索できるデータ）、禁止事項（やらないことの明示）、チェック（finish gateやlint）の形で外付けしていることだ。モデルが世代交代しても、スキル側に残した判断基準はそのまま使い回せる。エージェントの性能に依存しない形で自分の好みを資産化する、というのがこのカタログの裏テーマだと思っている。</p>]]></content>
    
    
    <summary type="html">コーディングエージェントのUI生成にありがちな「AIっぽい凡庸さ」への対策として、デザインの判断基準を外付けしたスキル13本を分類して紹介。slop対策、DESIGN.md系、日本語・ローカライズ系など。</summary>
    
    
    
    
    <category term="AI" scheme="https://blog.n1l.dev/tags/AI/"/>
    
    <category term="エージェントスキル" scheme="https://blog.n1l.dev/tags/%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%82%B9%E3%82%AD%E3%83%AB/"/>
    
    <category term="デザイン" scheme="https://blog.n1l.dev/tags/%E3%83%87%E3%82%B6%E3%82%A4%E3%83%B3/"/>
    
    <category term="UI" scheme="https://blog.n1l.dev/tags/UI/"/>
    
  </entry>
  
  <entry>
    <title>自己ホストGitLabの運用メモ：配置の判断と日々の運用</title>
    <link href="https://blog.n1l.dev/2026/11/self-hosted-gitlab-ops/"/>
    <id>https://blog.n1l.dev/2026/11/self-hosted-gitlab-ops/</id>
    <published>2026-11-19T12:46:00.000Z</published>
    <updated>2026-11-22T13:54:02.938Z</updated>
    
    <content type="html"><![CDATA[<p>自前で運用しているGitLab（gitlab.n1l.dev）の運用メモ。Proxmox上のLXCコンテナの中で、公式Dockerイメージの単一コンテナとして動かしている。ホストを移した経緯と、バージョンアップやCIまわりで決めている運用の型をまとめる。</p><span id="more"></span><h2 id="配置：なぜホストを移したか"><a href="#配置：なぜホストを移したか" class="headerlink" title="配置：なぜホストを移したか"></a>配置：なぜホストを移したか</h2><p>もともとGitLabは別のホスト上のコンテナで動かしていた。ところがある日、そのホストのOS用SSDで書き込みタイムアウトとI/Oエラーが発生し、ext4のジャーナルがabortしてルートファイルシステムが緊急読み取り専用（emergency_ro）に移行した。Dockerコンテナの作成に失敗し、CIがsystem failureで落ち始めた。</p><p>SMARTの全体判定はPASSEDで、SSD本体・接続・コントローラのどこが原因かは切り分けられなかった。再起動後は読み書き可能に戻ったが、「戻った＝直った」ではないので、GitLabは健全なホストへ移すことにした。</p><p>移行方式でも一手間あった。移行元と移行先でストレージ形式が違い（LVM-Thinからディレクトリ型へ）、<code>pct migrate</code> が使えなかったため、コンテナを停止して <code>vzdump</code> の出力をNFS経由で転送し、移行先で <code>pct restore</code> する方式に切り替えた。移行の検証が終わってから移行元と中間コピーは削除し、移行前の完全バックアップは保持している。なお、移行後の書き込みは新しいコンテナにしかないので、古いバックアップへ安易に戻すと移行後の変更が消える。復元するときはこの点を最初に確認する。</p><p>移行先ホストはメモリに余裕がなかったため、同じホストで動いているGPU用VMのメモリ割当を段階的に見直して捻出した（24GiBから18GiBへ）。このとき学んだのは、設定値を変えただけでは適用されたことにならない、ということ。再起動を挟むと古い値のまま起動してしまうことがあるので、<code>qm list</code> や <code>qm config --current</code> で実適用を必ず確認する。</p><p>外部公開は、コンテナ内で動かしているcloudflaredのトンネル経由にしている。</p><h2 id="バージョンアップの型"><a href="#バージョンアップの型" class="headerlink" title="バージョンアップの型"></a>バージョンアップの型</h2><p>GitLabは単一コンテナ構成なので、更新には停止が伴う。「前回許可したから今回も止めていい」とはせず、停止の可否は更新ごとに確認する前提で手順を組んでいる。</p><ol><li>公式のupgrade pathと各バージョンのupgrade notesを確認し、イメージを先にpullしておく</li><li>公式のdatabase-onlyバックアップを取得し、設定・secrets・Composeファイルを別途退避する。バックアップはコンテナの外にもコピーする（DBのみのバックアップはリポジトリやLFS全体のバックアップではない、という区別も記録しておく）</li><li>CIの新規受付を止め、実行中ジョブが0件になってから本体を更新する</li><li>更新後、後述の完了判定を通してからCI受付を戻す</li></ol><p>ロールバックは「旧イメージに差し戻す」だけでは成立しない。DB移行が入るため、対応する旧バージョンのDBバックアップと、設定・暗号化キーのセットが必要になる。</p><p>セキュリティ修正を含むパッチリリースでは、この型のまま前倒しで適用している。CVSS 10.0のcriticalが出たこともあったが、手順が決まっていると、急ぐときほど雑にならずに済む。</p><h2 id="CI-Runnerの止め方・戻し方"><a href="#CI-Runnerの止め方・戻し方" class="headerlink" title="CI Runnerの止め方・戻し方"></a>CI Runnerの止め方・戻し方</h2><p>Runnerは本体とは別ホスト上のサービスとして動かしている。本体更新のときは、Runnerプロセスへ <code>SIGQUIT</code> を送って新規ジョブの受付だけを止め、実行中のジョブは自然終了を待つ。登録全体をpauseしたり削除したりはしない。</p><p>Runnerは通常 <code>Restart=always</code> なので、待機中に勝手に再起動しないよう、一時的なdrop-inで再起動を抑止する。更新が終わったら、自分で作ったdrop-inだけを削除して元に戻し、実際のジョブ受信とログ送信まで確認する。受付を止めたあとも取得済みジョブが残ることがあるので、本体更新に入る前に、DB上のrunningジョブが0件であることも確認している。</p><h2 id="完了判定：healthyだけでは不十分"><a href="#完了判定：healthyだけでは不十分" class="headerlink" title="完了判定：healthyだけでは不十分"></a>完了判定：healthyだけでは不十分</h2><p>Dockerの <code>healthy</code> は当てにならない。初回マイグレーション中は、PumaやSidekiq、NGINXがまだ起動していなくてもhealthy表示になることがあった。そこで完了判定は次のセットにしている。</p><ul><li>コンテナ内部からのreadinessチェック（全項目ok）</li><li><code>gitlab-ctl status</code> で全サービスがrun状態</li><li>公開URLのサインインページがHTTP 200</li><li>CIが実際のジョブを受けて、ログ送信まで通ること</li></ul><p>加えて、新しいバージョンではバックグラウンド移行が追加されることがある。アプリが復旧しても移行が裏で続く場合があるので、次のアップグレード前に完了を確認する。</p><h2 id="容量管理"><a href="#容量管理" class="headerlink" title="容量管理"></a>容量管理</h2><p>GitLabまわりで容量を食うのは、バックアップのTARと、その圧縮中間データだ。最終TARと中間ファイルが同時に存在する時間帯がピークになる。対策として、コンテナのルートを32GiBから48GiBへオンライン拡張した。</p><p>旧バージョンのイメージは、消す前に <code>docker save</code> でコンテナ外へ退避し、gzipの整合性・tarの内容・SHA-256を検証してから、対象タグを指定して削除する。稼働中イメージや永続データを巻き込む一括pruneはしない。</p><p>また、ゲスト内の <code>df</code> の使用率と、ホスト側のLVM-Thinプールの使用率は一致しない。容量アラートを見るときは、コンテナ内・ホスト・thinプールを分けて確認する。</p><h2 id="障害例：Docker更新後にGitLabが起動しない"><a href="#障害例：Docker更新後にGitLabが起動しない" class="headerlink" title="障害例：Docker更新後にGitLabが起動しない"></a>障害例：Docker更新後にGitLabが起動しない</h2><p>Dockerエンジンを更新したあとの再起動で、GitLabコンテナが <code>AlreadyExists</code> エラーで起動しなかったことがある。実際にはGitLabのプロセスは存在せず、containerdのshimだけが残留していた。稼働中コンテナがないことを確認したうえでcontainerdを再起動し、既存コンテナを <code>docker start</code> して復旧した。原因の断定と再発防止策は未確定のままなので、この手順を稼働中コンテナのある環境へ無条件に適用はしない。</p>]]></content>
    
    
    <summary type="html">Proxmox上の単一コンテナで動かす自己ホストGitLab（gitlab.n1l.dev）の運用メモ。ホスト移設の判断、DBのみバックアップと設定の別退避、Runnerの安全な停止・再開など日常運用の型。</summary>
    
    
    
    
    <category term="Proxmox" scheme="https://blog.n1l.dev/tags/Proxmox/"/>
    
    <category term="自宅サーバー" scheme="https://blog.n1l.dev/tags/%E8%87%AA%E5%AE%85%E3%82%B5%E3%83%BC%E3%83%90%E3%83%BC/"/>
    
    <category term="GitLab" scheme="https://blog.n1l.dev/tags/GitLab/"/>
    
  </entry>
  
  <entry>
    <title>Proxmoxで踏んだ障害の記録：LXCのext4破損とホストのディスク枯渇</title>
    <link href="https://blog.n1l.dev/2026/11/proxmox-troubleshooting/"/>
    <id>https://blog.n1l.dev/2026/11/proxmox-troubleshooting/</id>
    <published>2026-11-19T12:43:00.000Z</published>
    <updated>2026-11-22T13:54:02.938Z</updated>
    
    <content type="html"><![CDATA[<p>自宅のProxmox VE環境で、ここ数か月のあいだに踏んだ障害のうち、切り分けと対処の流れを残せそうなものを2件と小ネタ1件まとめる。どちらも「ゲストの中だけ見ていても分からない」タイプの障害だった。</p><span id="more"></span><h2 id="1-LXCのext4ディレクトリ破損でバックアップが失敗する"><a href="#1-LXCのext4ディレクトリ破損でバックアップが失敗する" class="headerlink" title="1. LXCのext4ディレクトリ破損でバックアップが失敗する"></a>1. LXCのext4ディレクトリ破損でバックアップが失敗する</h2><h3 id="症状"><a href="#症状" class="headerlink" title="症状"></a>症状</h3><p>Proxmox Backup Server（PBS）への日次バックアップが <code>TASK ERROR: job errors</code> で落ちるようになった。ログには、対象コンテナ内の一時ディレクトリを指して <code>EBADMSG: Not a data message</code>（OSエラー74）が記録される。コンテナの中でそのディレクトリに <code>ls</code> や <code>rm</code> をしても <code>Bad message</code> で操作できない。ホスト側の <code>dmesg</code> には <code>EXT4-fs error ... Directory block failed checksum</code> と <code>Please run e2fsck -D</code> が出ていた。</p><h3 id="原因"><a href="#原因" class="headerlink" title="原因"></a>原因</h3><p>ext4の特定ディレクトリエントリのハッシュツリーブロック／チェックサムが破損していた。壊れていたのはエディタ関連の一時ステージングディレクトリで実データではなかったが、バックアップクライアントがファイルツリーを走査する途中でこのエラーを踏み、ジョブ全体が中断していた。</p><h3 id="対処"><a href="#対処" class="headerlink" title="対処"></a>対処</h3><p>稼働中のゲストディスクにはfsckできないので、手順の順番が大事だった。</p><ol><li>対象コンテナを停止する</li><li>MMP（Multi-Mount Protection）をクリアしてから <code>e2fsck -f -y -D</code> を実行する。<code>-D</code> はディレクトリの再構築・最適化で、dmesgの案内どおりの指定</li><li><code>e2fsck -fn</code> で読み取り専用チェックを再実行し、エラー0件を確認する</li><li>コンテナを起動し、破損していた一時ディレクトリを削除する</li><li>バックアップを手動でテスト実行し、完走を確認する</li></ol><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line">pct stop &lt;VMID&gt;</span><br><span class="line">tune2fs -f -E clear_mmp /dev/pve/vm-&lt;VMID&gt;-disk-0</span><br><span class="line">e2fsck -f -y -D /dev/pve/vm-&lt;VMID&gt;-disk-0</span><br><span class="line">e2fsck -fn /dev/pve/vm-&lt;VMID&gt;-disk-0   <span class="comment"># エラー0件を確認</span></span><br><span class="line">pct start &lt;VMID&gt;</span><br><span class="line">vzdump &lt;VMID&gt; --storage &lt;PBS&gt; --mode snapshot   <span class="comment"># 手動テスト</span></span><br></pre></td></tr></table></figure><h3 id="教訓"><a href="#教訓" class="headerlink" title="教訓"></a>教訓</h3><ul><li>バックアップ失敗の切り分けは、ホスト側の <code>dmesg</code> を見ると早い。ゲスト内から分かるのは「読めないファイルがある」ことだけだった</li><li>fsckは「停止してアンマウント済み」を確認してから。MMPの解除も、未マウントの確認なしには行わない</li></ul><h2 id="2-ホストのディスク枯渇でVMが止まる"><a href="#2-ホストのディスク枯渇でVMが止まる" class="headerlink" title="2. ホストのディスク枯渇でVMが止まる"></a>2. ホストのディスク枯渇でVMが止まる</h2><h3 id="症状-1"><a href="#症状-1" class="headerlink" title="症状"></a>症状</h3><p><code>qm list</code> ではrunning表示なのに、詳細を見ると <code>qmpstatus: io-error</code>。書き込みに失敗したVMが一時停止状態になっていた。NFSを提供しているVMがこの状態になると、共有先のゲストやバックアップ処理まで応答しなくなる。厄介なのは、LXCゲストの中から見ると空き容量があるように見えるケースで、実際には疎（スパース）なrawディスクを置いているホスト側が満杯だった。</p><p>ext4の予約領域の影響で、物理的には空きがあっても一般ユーザー向けの利用可能容量が0になることもある。予約率の変更は応急措置でしかなく、容量確保の代わりにはならない。</p><h3 id="原因と回収作業"><a href="#原因と回収作業" class="headerlink" title="原因と回収作業"></a>原因と回収作業</h3><p>容量を圧迫していたのは、バックアップの中間ファイルや生成物の蓄積だった。GitLabのバックアップTARがPBS障害のあとに溜まっていたり、データベースのコアダンプが数十GiB積み上がっていたり、Dockerのビルドキャッシュが膨らんでいたりと、発生源はその時々で違う。</p><p>回収の基本形はこうなった。</p><ul><li>稼働中ゲストの空きはTRIMで返す（ホストから <code>pct fstrim</code>、VMはゲスト内で <code>fstrim</code>）</li><li>残すべきファイルは別ストレージへ退避し、SHA-256の一致を確認してから元を削除する</li><li>旧カーネルは、実行中・最新・予備を保持したうえで、対象パッケージだけを削除する</li></ul><h3 id="ハマりどころ"><a href="#ハマりどころ" class="headerlink" title="ハマりどころ"></a>ハマりどころ</h3><ul><li><strong>TRIMの報告量とホストの実回収量は一致しない。</strong> スパースなディスクでは、ゲスト側で数十GiB削除してもホストの空きがすぐには増えないことがある。削除→<code>sync</code>→再TRIMで初めて返ってくるケースもあった。効果はホスト側 <code>df</code> の差で評価する</li><li><strong>自動TRIMのタイムアウトでロックが残る。</strong> 自作の監視スクリプトが <code>pct fstrim</code> をタイムアウトで途中終了させ、<code>lock: fstrim</code> が残留したことがある。解除するときは「実際に走っているTRIMタスクがないこと」を毎回確認してから手動で <code>pct unlock</code> する。自動でunlockする作りにはしない</li><li><strong>ホストが完全満杯だとTRIM自体が失敗する。</strong> その場合は、稼働中ゲストの既存マウントをホスト側から辿って <code>fstrim</code> する手もある</li></ul><h3 id="再発防止"><a href="#再発防止" class="headerlink" title="再発防止"></a>再発防止</h3><ul><li>バックアップの大きな中間ファイルは、ホストのルート領域に置かず、別ストレージ上の作業領域へ分離した</li><li>バックアップ開始前に必要容量を見積もり、不足していれば実行せずに通知するガードを入れた（事前チェックであり、ディスクquotaではない）</li><li>生成したバックアップは、全量読み戻しとSHA-256一致を確認してから元ファイルを消す運用に統一した</li></ul><h2 id="3-小ネタ：PBSのAPI接続拒否"><a href="#3-小ネタ：PBSのAPI接続拒否" class="headerlink" title="3. 小ネタ：PBSのAPI接続拒否"></a>3. 小ネタ：PBSのAPI接続拒否</h2><p>PBSのAPIが接続拒否になってバックアップが失敗したこともある。原因はPBSコンテナ内のランタイムディレクトリの所有者・権限が崩れていて、バックアップ用ユーザーがPIDファイルを作れず、プロキシが起動できていなかった。systemd-tmpfilesの設定で権限を恒久化して復旧。証明書や認証情報の問題ではなかった。「接続拒否＝ネットワークか認証」と決めつけず、サービスがそもそも起動できているかを先に見る、という教訓だった。</p>]]></content>
    
    
    <summary type="html">自宅Proxmox VEで踏んだ障害2件の記録。LXC内のext4破損でPBSバックアップが失敗した件と、ホストのディスク枯渇でVMがio-error停止した件について、症状・原因・対処・再発防止をまとめた。</summary>
    
    
    
    
    <category term="Proxmox" scheme="https://blog.n1l.dev/tags/Proxmox/"/>
    
    <category term="自宅サーバー" scheme="https://blog.n1l.dev/tags/%E8%87%AA%E5%AE%85%E3%82%B5%E3%83%BC%E3%83%90%E3%83%BC/"/>
    
    <category term="障害対応" scheme="https://blog.n1l.dev/tags/%E9%9A%9C%E5%AE%B3%E5%AF%BE%E5%BF%9C/"/>
    
  </entry>
  
  <entry>
    <title>ProxmoxのGPU VMでローカルAI環境を作る ― パススルーとメモリとドライバの話</title>
    <link href="https://blog.n1l.dev/2026/11/proxmox-gpu-vm-ai/"/>
    <id>https://blog.n1l.dev/2026/11/proxmox-gpu-vm-ai/</id>
    <published>2026-11-19T12:40:00.000Z</published>
    <updated>2026-11-22T13:54:02.938Z</updated>
    
    <content type="html"><![CDATA[<p>自宅のProxmox上にGPUパススルーのVMを1台立てて、ローカルLLMの推論環境として使っている。構成自体は平凡なのだが、運用してみると「パススルーVMならでは」のハマりどころがいくつかあったので、メモとして残しておく。</p><span id="more"></span><h2 id="構成"><a href="#構成" class="headerlink" title="構成"></a>構成</h2><ul><li>ホスト：Proxmox、物理メモリ32GiB</li><li>VM：Ubuntu、GeForce GTX 1660 SUPER（VRAM 6GiB）をPCIパススルー</li><li>推論基盤：Docker上の Ollama ＋ Open WebUI</li><li>モデル：Qwen3-8B のGGUF量子化版（q3_K_L、約4.1GiB）</li></ul><h2 id="ハマりどころ1：パススルーVMのメモリは「最大値」で効く"><a href="#ハマりどころ1：パススルーVMのメモリは「最大値」で効く" class="headerlink" title="ハマりどころ1：パススルーVMのメモリは「最大値」で効く"></a>ハマりどころ1：パススルーVMのメモリは「最大値」で効く</h2><p>いちばん効いた教訓がこれ。GPUパススルーを有効にしたVMでは、設定した最大メモリがホスト側でほぼ常駐扱いになる。ゲスト側でバルーニングによって見かけのメモリを減らしても、ホスト側の空きは思ったほど戻ってこない。</p><p>当初は16GiB＋バルーニングで運用していたが、ホストの空きメモリが0.5GiB程度まで圧迫されてしまった。あれこれ試した結果、バルーニングを無効化して8GiB固定にするのが落としどころで、ホストの空きは約7.5GiBまで回復した。ちなみに24GiB設定でもホストはかなり苦しく、32GiBではVM自体が起動しなかった。</p><p>パススルーVMのメモリは「最大値で確保されるもの」と割り切って、ホスト全体の残量から逆算して決めるのが安全だと思う。なお、最大メモリの変更はバルーニングのように動的には効かず、VMの完全な停止→起動が必要になる。</p><h2 id="ハマりどころ2：ドライバのバージョン不整合"><a href="#ハマりどころ2：ドライバのバージョン不整合" class="headerlink" title="ハマりどころ2：ドライバのバージョン不整合"></a>ハマりどころ2：ドライバのバージョン不整合</h2><p>ある日、Open WebUIが起動エラー（HTTP 500）で返ってくるようになった。両方のコンテナ自体は存在していて、一見するとアプリ側の問題に見える。</p><p>実際の原因はNVIDIAドライバのバージョン不整合だった。読み込まれているカーネルモジュールと、ユーザーランド側のライブラリ（NVML）のバージョンがずれており、<code>nvidia-smi</code> 自体が失敗する状態で、OllamaのコンテナがGPUを掴めずに起動できていなかった。ドライバの永続化デーモンの状態も崩れていた。</p><p>対処はVMの再起動で、モジュールとライブラリのバージョンが揃ったところで復旧した。教訓はシンプルで、<strong>コンテナを作り直す前に、まずドライバのバージョンとデーモンの状態を確認する</strong>こと。再起動はゲスト内の全ワークロードが止まるので、やる前に影響範囲の確認は要る。</p><h2 id="モデル選定：VRAM-6GiBが全ての上限"><a href="#モデル選定：VRAM-6GiBが全ての上限" class="headerlink" title="モデル選定：VRAM 6GiBが全ての上限"></a>モデル選定：VRAM 6GiBが全ての上限</h2><p>6GiBというVRAMが、この環境のあらゆる判断の上限になる。現在の常駐モデルはQwen3-8Bの量子化GGUFで、約4.1GiBに収まるものを使っている。</p><p>以前は、もっと大きなMoEモデルを「GPUに載る分＋残りはCPUオフロード」という構成で動かすことも試した。動くには動くのだが、日常的に使うには遅すぎて、結局その構成は撤去した。小さいGPUでは「載るかどうか」より「速度が実用かどうか」で判断した方がいい、というのが今のところの結論。</p><h2 id="GPUの共有：優先順位を先に決めて自動化する"><a href="#GPUの共有：優先順位を先に決めて自動化する" class="headerlink" title="GPUの共有：優先順位を先に決めて自動化する"></a>GPUの共有：優先順位を先に決めて自動化する</h2><p>このGPUは推論専用ではなく、計算用途の常駐ジョブとも共用している。運用ルールは「AIが優先」。推論側の利用を検知したら常駐ジョブを止める、温度が上限に達したら止める、といった制御を管理スクリプト側で回している。</p><p>1枚のGPUを複数の用途で取り合う構成にするなら、優先順位と停止・再開の条件を先に決めて自動化しておくと、後から揉めない。</p><h2 id="ディスクの話：解放量は「報告値」ではなく実測で見る"><a href="#ディスクの話：解放量は「報告値」ではなく実測で見る" class="headerlink" title="ディスクの話：解放量は「報告値」ではなく実測で見る"></a>ディスクの話：解放量は「報告値」ではなく実測で見る</h2><p>不要になったモデルや環境をVMから削除したときのメモ。ゲスト側でTRIMが報告する解放量と、ホスト側で実際に増えた空き容量は一致しないことがある。ファイルシステムの同期（sync）を挟んでからTRIMをやり直すと、実量に近づいた。</p><p>削除作業の成否確認は、ゲスト側の報告値ではなく、ホスト側の空き容量の実バイト数で見るのが確実。</p><h2 id="まとめ"><a href="#まとめ" class="headerlink" title="まとめ"></a>まとめ</h2><p>パススルーVMのAI環境は、作ること自体よりも「ホスト側のリソース勘定」と「ドライバの整合性チェック」という運用の部分が本体だった。逆に言えば、その2点を押さえておけば、6GiB級の古めのGPUでもローカルLLMの置き場としては十分実用になる。</p>]]></content>
    
    
    <summary type="html">ProxmoxのGPUパススルーVMでOllamaとOpen WebUIのローカルLLM環境を作った実践メモ。バルーニングが効かないメモリ、ドライバとNVMLの不整合、VRAM 6GiBでのモデル選びなど、パススルーならではのハマりどころ。</summary>
    
    
    
    
    <category term="Proxmox" scheme="https://blog.n1l.dev/tags/Proxmox/"/>
    
    <category term="GPU" scheme="https://blog.n1l.dev/tags/GPU/"/>
    
    <category term="Ollama" scheme="https://blog.n1l.dev/tags/Ollama/"/>
    
    <category term="ローカルLLM" scheme="https://blog.n1l.dev/tags/%E3%83%AD%E3%83%BC%E3%82%AB%E3%83%ABLLM/"/>
    
  </entry>
  
  <entry>
    <title>Unityの二要素認証を再登録しないとアカウントが停止されるという話</title>
    <link href="https://blog.n1l.dev/2026/11/unity-2fa-reregistration/"/>
    <id>https://blog.n1l.dev/2026/11/unity-2fa-reregistration/</id>
    <published>2026-11-19T12:00:00.000Z</published>
    <updated>2026-11-22T13:54:02.938Z</updated>
    
    <content type="html"><![CDATA[<p>Xで流れてきたのを見て知ったのだが、Unityアカウントの二要素認証（2FA）を再登録しないとアカウントが停止されるらしい。</p><p>期限は <strong>2026年11月19日 13:00 UTC＝日本時間22:00</strong>。24時ではなく22時まで、というのが地味に罠っぽい。自分はもう対応済みだが、手順と調べたことをメモとして残しておく。</p><span id="more"></span><h2 id="なぜ再登録が必要なのか"><a href="#なぜ再登録が必要なのか" class="headerlink" title="なぜ再登録が必要なのか"></a>なぜ再登録が必要なのか</h2><p>2026年4月にUnityのアカウントセキュリティがアップデートされて、2FAの仕組みが変わったのが発端。</p><ul><li><strong>2026年9月1日以降、2FAは認証アプリでのみ設定可能</strong>になった</li><li>SMSによる二要素認証は、新規アカウントでは利用不可になり、既存アカウントでもサポート終了している</li></ul><p>つまり今回の「再登録」は、主にSMS認証など古い方式から認証アプリ方式への切り替えのこと。昔SMSで設定したままの人は対象になる。</p><h2 id="再登録の手順"><a href="#再登録の手順" class="headerlink" title="再登録の手順"></a>再登録の手順</h2><ol><li><a href="https://cloud.unity.com/account/security">Unityアカウントのセキュリティ設定</a> を開く</li><li>「二要素認証」セクションで、「認証アプリ」の横の「設定」を選択</li><li>パスワードを入力して「続行」</li><li>認証アプリ（Google Authenticator、Microsoft Authenticatorなど）でQRコードをスキャン<ul><li>スキャンできない場合は「バーコードをスキャンできませんか？」からセットアップキーを手動入力できる</li></ul></li><li>アプリに表示されたコードを入力して「確認」</li><li><strong>リカバリーコードをダウンロードまたはコピーして、安全な場所に保管</strong></li><li>「リカバリーコードを安全な場所に保存しました」を選択して「完了」</li></ol><p>古い2FA設定が残っていて進めない場合は、同じ画面で一度「削除」してから設定し直せばよい。</p><h2 id="リカバリーコードについて"><a href="#リカバリーコードについて" class="headerlink" title="リカバリーコードについて"></a>リカバリーコードについて</h2><p>設定の最後に発行されるリカバリーコードは、スマホをなくしたり機種変更したりして認証アプリが使えなくなったときに、アカウントへアクセスする唯一の手段になる。スクリーンショットで済ませず、ファイルとして安全な場所に保存しておくのが無難。</p><p>ついでに書いておくと、パスワードや2FAコードをUnityサポートが尋ねることは絶対にないらしい。聞かれたら詐欺だと思った方がいい。</p><h2 id="期限を過ぎて停止されてしまった場合"><a href="#期限を過ぎて停止されてしまった場合" class="headerlink" title="期限を過ぎて停止されてしまった場合"></a>期限を過ぎて停止されてしまった場合</h2><p>停止されても復旧の手続き自体はある。本人確認のため、以下のような情報を添えて、Unityの「アカウントと組織のフォーム」からリクエストを送る形になる。</p><ul><li>Unity組織名、最近購入したAsset Storeアセット名、直近の請求書番号・注文番号、Unity Cloudプロジェクト名のいずれか</li><li>Unityユーザー名（メールアドレスではなくユーザー名）、アカウントに登録されている住所</li></ul><p>確認が取れればアカウントが復旧し、サインインして2FAを再設定できるようになる。ただ、やり取りが発生する分面倒なので、期限内に対応するのが確実ではある。</p><h2 id="まとめ"><a href="#まとめ" class="headerlink" title="まとめ"></a>まとめ</h2><ul><li>期限は11月19日 22:00（日本時間）</li><li>やることは「認証アプリで2FAを設定し直す」だけ</li><li>リカバリーコードの保管を忘れずに</li></ul><hr><h3 id="参考（Unity公式サポート）"><a href="#参考（Unity公式サポート）" class="headerlink" title="参考（Unity公式サポート）"></a>参考（Unity公式サポート）</h3><ul><li><a href="https://support.unity.com/hc/ja/articles/208764976">アカウントで2要素認証（2FA）を設定するにはどうすればよいですか？</a></li><li><a href="https://support.unity.com/hc/ja/articles/360021264872">アカウントから2要素認証（2FA）を削除するにはどうすればよいですか？</a></li><li><a href="https://support.unity.com/hc/ja/articles/54616227806612">二要素認証（2FA）の再設定期限後にUnityアカウントが停止されました。どうすれば復旧できますか？</a></li></ul><p>※期限（2026年11月19日13:00 UTC）は、Unityからユーザーへ送られたお知らせに基づくもの。公式サポート記事側には載っていないので、自分の受信メールもあわせて確認した方がいい。</p>]]></content>
    
    
    <summary type="html">Unityから「二要素認証を再登録しないとアカウントを停止する」というお知らせが来たので対応した。期限は2026年11月19日22時（日本時間）。SMS認証から認証アプリ方式への切り替え手順と、リカバリーコードの保管、停止後の復旧方法のメモ。</summary>
    
    
    
    
    <category term="Unity" scheme="https://blog.n1l.dev/tags/Unity/"/>
    
    <category term="二要素認証" scheme="https://blog.n1l.dev/tags/%E4%BA%8C%E8%A6%81%E7%B4%A0%E8%AA%8D%E8%A8%BC/"/>
    
    <category term="セキュリティ" scheme="https://blog.n1l.dev/tags/%E3%82%BB%E3%82%AD%E3%83%A5%E3%83%AA%E3%83%86%E3%82%A3/"/>
    
  </entry>
  
  <entry>
    <title>VRChat内の動画プレイヤーにおいてYouTubeが再生できない問題の解決法</title>
    <link href="https://blog.n1l.dev/2025/03/vrchat-videoplayer-fix/"/>
    <id>https://blog.n1l.dev/2025/03/vrchat-videoplayer-fix/</id>
    <published>2025-03-26T08:01:04.000Z</published>
    <updated>2026-11-22T13:54:02.938Z</updated>
    
    <content type="html"><![CDATA[<p>VRChat内の動画プレイヤーにおいてYouTubeのみが再生できない問題が発生していて、解決策の備忘録。</p><span id="more"></span><ol><li>管理者権限でコマンドプロンプトを実行</li><li><code>netsh interface ipv6 set prefixpolicy ::ffff:0:0/96 100 4</code> を実行</li><li>PC再起動</li></ol><p>で大半は治るはず。治らないのであれば2のコマンドに</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line">netsh interface ipv6 <span class="built_in">set</span> prefixpolicy ::ffff:0:0/96 50 0</span><br><span class="line">netsh interface ipv6 <span class="built_in">set</span> prefixpolicy ::1/128 40 1</span><br><span class="line">netsh interface ipv6 <span class="built_in">set</span> prefixpolicy ::/0 30 2</span><br><span class="line">netsh interface ipv6 <span class="built_in">set</span> prefixpolicy 2002::/16 20 3</span><br><span class="line">netsh interface ipv6 <span class="built_in">set</span> prefixpolicy ::/96 10 4</span><br></pre></td></tr></table></figure><p>** ※追記 2025/05/08 ** 一度 <code>netsh interface ipv6 reset</code>でリセットしてしまうと、上記のコマンドが動作しなくなるため、resetした場合は</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line">netsh interface ipv6 add prefixpolicy ::ffff:0:0/96 50 0</span><br><span class="line">netsh interface ipv6 add prefixpolicy ::1/128 40 1</span><br><span class="line">netsh interface ipv6 add prefixpolicy ::/0 30 2</span><br><span class="line">netsh interface ipv6 add prefixpolicy 2002::/16 20 3</span><br><span class="line">netsh interface ipv6 add prefixpolicy ::/96 10 4</span><br></pre></td></tr></table></figure><p>を実行してみる。これでも治らなければルーターを再起動するか、そもそもIPv6を無効化してしまう。</p><p>設定 -&gt; ネットワークとインターネット -&gt; ネットワークの詳細設定 -&gt; 変えたいネットワークの右側にある下三角をクリック（大体イーサネット）-&gt; その他のアダプターオプションの編集をクリック -&gt; 上から8番目あたりにある「インターネットプロトコルバージョン6 (TCP/IPv6)」のチェックを外す -&gt; OKをクリック -&gt; 再起動</p><p>で反映されるはず。</p><h1 id="原因"><a href="#原因" class="headerlink" title="原因"></a>原因</h1><p>ここからはあまり読む必要ない。<br>原因として</p><figure class="highlight plain"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">[Video Playback] ERROR: [youtube] K2CU5pwqQy8: Sign in to confirm you fre not a bot. Use --cookies-from-browser or --cookies for the authentication. See  https:&#x2F;&#x2F;github.com&#x2F;yt-dlp&#x2F;yt-dlp&#x2F;wiki&#x2F;FAQ#how-do-i-pass-cookies-to-yt-dlp  for how to manually pass cookies. Also see  https:&#x2F;&#x2F;github.com&#x2F;yt-dlp&#x2F;yt-dlp&#x2F;wiki&#x2F;Extractors#exporting-youtube-cookies  for tips on effectively exporting YouTube cookies</span><br></pre></td></tr></table></figure><p>が起因している。<br>これはYouTubeの動画をダウンロードするためのライブラリである<code>yt-dlp</code>が、YouTubeの認証を通過できておらずVRChatに動画自体を渡すことができていないのが原因。</p>]]></content>
    
    
    <summary type="html">VRChat内の動画プレイヤーでYouTubeだけが再生できない問題の解決法。原因の切り分けと、実際に再生できるようになった対処をまとめた備忘録。</summary>
    
    
    
    
    <category term="VRChat" scheme="https://blog.n1l.dev/tags/VRChat/"/>
    
    <category term="動画プレイヤー" scheme="https://blog.n1l.dev/tags/%E5%8B%95%E7%94%BB%E3%83%97%E3%83%AC%E3%82%A4%E3%83%A4%E3%83%BC/"/>
    
    <category term="VideoPlayer" scheme="https://blog.n1l.dev/tags/VideoPlayer/"/>
    
  </entry>
  
  <entry>
    <title>SteamVRを起動したらモニターの接続を解除してVRChatのパフォーマンスを改善する</title>
    <link href="https://blog.n1l.dev/2024/11/monitor-control/"/>
    <id>https://blog.n1l.dev/2024/11/monitor-control/</id>
    <published>2024-11-01T07:11:30.000Z</published>
    <updated>2026-11-22T13:54:02.927Z</updated>
    
    <content type="html"><![CDATA[<p>最近VR機器を使うことが増えてきており、マルチモニター環境においてSteamVRやVRChat等のVRゲームを起動したときに、モニターの接続を解除してあげるとFPSが自環境では5-10FPSの向上が見られたので備忘録。</p><span id="more"></span><!-- toc --><h1 id="multimonitortoolの準備"><a href="#multimonitortoolの準備" class="headerlink" title="multimonitortoolの準備"></a>multimonitortoolの準備</h1><p><a href="https://www.nirsoft.net/utils/multi_monitor_tool.html">multimonitortool</a>をダウンロード。結構下のほうにあるのでCtrl+FでDownloadと検索したほうが幸せかもしれない。Languageにある日本語化ファイルもダウンロードしておく。</p><h1 id="multimonitortoolでモニターIDの確認"><a href="#multimonitortoolでモニターIDの確認" class="headerlink" title="multimonitortoolでモニターIDの確認"></a>multimonitortoolでモニターIDの確認</h1><div class="figure " style="width:;"><img class="fig-img" src="https://raw.githubusercontent.com/n1lsqn/blog/refs/heads/main/source/_posts/2024/11/monitor-control/{2275EDBB-9E33-4D0F-945F-E54DA39CCF39}.png" alt=""></div><p>起動して、モニターidを取得する。<br>下部分に表示されているウィンドウと照らし合わせながら、モニターを右クリック</p><div class="figure " style="width:;"><img class="fig-img" src="https://raw.githubusercontent.com/n1lsqn/blog/refs/heads/main/source/_posts/2024/11/monitor-control/{82CD15FE-57B8-424B-8C19-6DD341C76DF6}.png" alt=""></div><p>モニターIDをメモしておく</p><h1 id="batファイルの作成"><a href="#batファイルの作成" class="headerlink" title="batファイルの作成"></a>batファイルの作成</h1><p>off時のbat</p><figure class="highlight bat"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br></pre></td><td class="code"><pre><span class="line">@<span class="built_in">echo</span> off</span><br><span class="line"><span class="built_in">setlocal</span></span><br><span class="line"></span><br><span class="line">:: monitor IDs</span><br><span class="line"><span class="built_in">set</span> &quot;MAIN_MONITOR_ID=MONITOR\*******\&#123;*******-****-****-****-************&#125;\****&quot;</span><br><span class="line"><span class="built_in">set</span> &quot;SUB1_MONITOR_ID=MONITOR\*******\&#123;*******-****-****-****-************&#125;\****&quot;</span><br><span class="line"><span class="built_in">set</span> &quot;SUB2_MONITOR_ID=MONITOR\*******\&#123;*******-****-****-****-************&#125;\****&quot;</span><br><span class="line"></span><br><span class="line">:: MultiMonitorToolで切断</span><br><span class="line">&quot;MultiMonitorTool.exe&quot; /disable &quot;<span class="variable">%SUB1_MONITOR_ID%</span>&quot;</span><br><span class="line">&quot;MultiMonitorTool.exe&quot; /disable &quot;<span class="variable">%SUB2_MONITOR_ID%</span>&quot;</span><br><span class="line"></span><br><span class="line">:: 自動的に閉じる</span><br><span class="line">timeout /t <span class="number">3</span> &gt;<span class="built_in">nul</span></span><br></pre></td></tr></table></figure><p>on時のbat</p><figure class="highlight bat"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br></pre></td><td class="code"><pre><span class="line">@<span class="built_in">echo</span> off</span><br><span class="line"><span class="built_in">setlocal</span></span><br><span class="line"></span><br><span class="line">:: Define monitor IDs</span><br><span class="line"><span class="built_in">set</span> &quot;MAIN_MONITOR_ID=MONITOR\*******\&#123;*******-****-****-****-************&#125;\****&quot;</span><br><span class="line"><span class="built_in">set</span> &quot;SUB1_MONITOR_ID=MONITOR\*******\&#123;*******-****-****-****-************&#125;\****&quot;</span><br><span class="line"><span class="built_in">set</span> &quot;SUB2_MONITOR_ID=MONITOR\*******\&#123;*******-****-****-****-************&#125;\****&quot;</span><br><span class="line"></span><br><span class="line">:: MultiMonitorToolで切断</span><br><span class="line">&quot;MultiMonitorTool.exe&quot; /enable &quot;<span class="variable">%SUB1_MONITOR_ID%</span>&quot;</span><br><span class="line">&quot;MultiMonitorTool.exe&quot; /enable &quot;<span class="variable">%SUB2_MONITOR_ID%</span>&quot;</span><br><span class="line"></span><br><span class="line">:: 自動的に閉じる</span><br><span class="line">timeout /t <span class="number">3</span> &gt;<span class="built_in">nul</span></span><br></pre></td></tr></table></figure><p>まず<code>set MAIN_MONITOR_ID</code>、<code>set SUB1_MONITOR_ID</code>、<code>set SUB2_MONITOR_ID</code>でモニターIDを定義、私はトリプル環境のため三つ定義してあるため、各々そこは変更していただきたい。</p><p><code>&quot;MultiMonitorTool.exe&quot;</code>はMultiMonitorTool.exeが配置されている絶対パス(エクスプローラーでexeを指定し右クリック -&gt; パスのコピーで取得)を指定</p><p>これでとりあえず接続/切断は使えるはず。</p><h1 id="autohotkeyの構築"><a href="#autohotkeyの構築" class="headerlink" title="autohotkeyの構築"></a>autohotkeyの構築</h1><p><a href="https://www.autohotkey.com/">autohotkey</a>を使ってSteamVR<code>vrserver.exe</code>が起動したときに切断、終了時に接続というようなことをする。ダウンロードしてインストールしておく。</p><figure class="highlight ahk"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br></pre></td><td class="code"><pre><span class="line"><span class="meta">#Persistent</span></span><br><span class="line"><span class="built_in">SetTimer,</span> CheckSteamVR, <span class="number">1000</span></span><br><span class="line">steamVRStarted := <span class="literal">false</span></span><br><span class="line"><span class="keyword">return</span></span><br><span class="line"></span><br><span class="line"><span class="title">CheckSteamVR:</span></span><br><span class="line"><span class="built_in">Process,</span> Exist, vrserver.exe</span><br><span class="line">if (<span class="built_in">ErrorLevel</span> != <span class="number">0</span> <span class="literal">and</span> !steamVRStarted) &#123;</span><br><span class="line">    <span class="comment">; SteamVR起動時に実行</span></span><br><span class="line"><span class="built_in">    Run,</span> <span class="string">&quot;off.bat&quot;</span></span><br><span class="line">    steamVRStarted := <span class="literal">true</span></span><br><span class="line">&#125;</span><br><span class="line">else if (<span class="built_in">ErrorLevel</span> == <span class="number">0</span> <span class="literal">and</span> steamVRStarted) &#123;</span><br><span class="line">    <span class="comment">; SteamVR終了時に実行</span></span><br><span class="line"><span class="built_in">    Run,</span> <span class="string">&quot;on.bat&quot;</span></span><br><span class="line">    steamVRStarted := <span class="literal">false</span></span><br><span class="line">&#125;</span><br><span class="line"><span class="keyword">return</span></span><br></pre></td></tr></table></figure><p><code>off.bat</code>と<code>on.bat</code>は先ほどのパスをコピーから取得する</p><p>先ほど書いたahkファイルを開くと</p><div class="figure " style="width:;"><img class="fig-img" src="https://raw.githubusercontent.com/n1lsqn/blog/refs/heads/main/source/_posts/2024/11/monitor-control/{C695ED36-8484-413B-809D-B34F37F620CB}.png" alt=""></div> <p>といわれるのではいを選択、now installみたいなウィンドウが出てきたらok。<br>またahkファイルを開いてシステムトレイに追加されてたらok。緑でHと書いてあるロゴがそれ</p><div class="figure " style="width:;"><img class="fig-img" src="https://raw.githubusercontent.com/n1lsqn/blog/refs/heads/main/source/_posts/2024/11/monitor-control/{73A5AC60-1C32-4DA3-8954-42F0548F1215}.png" alt=""></div><p>だいぶ駆け足気味で書いているので、わかんなかったら遠慮なくTwitterのDMまでぜひ</p><h1 id="参考"><a href="#参考" class="headerlink" title="参考"></a>参考</h1><p><a href="https://note.com/ngc_shj/n/n257e2c5b991c">WSL2でマルチディスプレイの接続/切断をCLIで行う</a></p>]]></content>
    
    
    <summary type="html">SteamVR起動時にモニターの接続を自動で解除し、VRChatのFPSを5〜10向上させる方法。マルチモニター環境でVRの負荷を下げる仕組みと設定の備忘録。</summary>
    
    
    
    
    <category term="SteamVR" scheme="https://blog.n1l.dev/tags/SteamVR/"/>
    
    <category term="VRChar" scheme="https://blog.n1l.dev/tags/VRChar/"/>
    
  </entry>
  
  <entry>
    <title>misskeyのdbをバックアップから復元する。</title>
    <link href="https://blog.n1l.dev/2024/02/misskey-migration/"/>
    <id>https://blog.n1l.dev/2024/02/misskey-migration/</id>
    <published>2024-02-27T14:13:21.000Z</published>
    <updated>2026-11-22T13:54:02.927Z</updated>
    
    <content type="html"><![CDATA[<h1 id="pg-dumpでバックアップを取得し、psqlで復元する。"><a href="#pg-dumpでバックアップを取得し、psqlで復元する。" class="headerlink" title="pg_dumpでバックアップを取得し、psqlで復元する。"></a>pg_dumpでバックアップを取得し、psqlで復元する。</h1><p>すでにバックアップは準備できているものとする。</p><span id="more"></span><figure class="highlight sh"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">sudo -u postgres psql</span><br></pre></td></tr></table></figure><figure class="highlight sql"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">CREATE</span> DATABASE mk1 OWNER misskey;</span><br></pre></td></tr></table></figure><p>拡張機能を入れている場合は、拡張機能をインストールする。</p><figure class="highlight sql"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line"><span class="keyword">CREATE</span> EXTENSION pgroonga;</span><br></pre></td></tr></table></figure><h1 id="バックアップから復元する。"><a href="#バックアップから復元する。" class="headerlink" title="バックアップから復元する。"></a>バックアップから復元する。</h1><figure class="highlight sh"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">psql -d mk1 &lt; backup.sql</span><br></pre></td></tr></table></figure>]]></content>
    
    
    <summary type="html">Misskeyのデータベースをバックアップから復元する手順。pg_dumpで取得したバックアップをpsqlでリストアする流れを、実施時のコマンドとともにまとめた。</summary>
    
    
    
    
    <category term="misskey" scheme="https://blog.n1l.dev/tags/misskey/"/>
    
  </entry>
  
  <entry>
    <title>dockerにはコンテナ当たりの容量制限があるという話。</title>
    <link href="https://blog.n1l.dev/2023/12/docker-rimit/"/>
    <id>https://blog.n1l.dev/2023/12/docker-rimit/</id>
    <published>2023-12-02T23:13:33.000Z</published>
    <updated>2026-11-22T13:54:02.927Z</updated>
    
    <content type="html"><![CDATA[<p>知らなかったのだが、Dockerにはコンテナ当たりの容量制限があるらしい。<br>経緯としては、ストレージがあるのにもかかわらず、no space left on deviceというエラーが出てしまうというもの。</p><span id="more"></span><!-- toc --><p><a href="https://unrealcontainers.com/docs/environments/local-windows-10#:~:text=By%20default%2C%20Docker%20Desktop%20for,by%20following%20the%20instructions%20below">Local Development (Windows 10)</a></p><blockquote><p>By default, Docker Desktop for Windows imposes a 20GB size limit on container images, which is too low for building and running Unreal Engine containers. You will need to increase the maximum container disk size to the recommended limit of 300GB by following the instructions below.</p></blockquote><h3 id="設定"><a href="#設定" class="headerlink" title="設定"></a>設定</h3><p>Docker Desktopの設定から、Docker Engineの設定を開き、<code>&quot;defaultKeepStorage&quot;: &quot;20GB&quot;,</code>を<code>&quot;defaultKeepStorage&quot;: &quot;200GB&quot;,</code>に変更する。（各々好きな値で）</p><p>おしまい。</p>]]></content>
    
    
    <summary type="html">Dockerにはコンテナ当たりのストレージ容量制限があり、空きがあるのに no space left on device になることがある。その仕様に遭遇した経緯と対処のメモ。</summary>
    
    
    
    
    <category term="docker" scheme="https://blog.n1l.dev/tags/docker/"/>
    
  </entry>
  
  <entry>
    <title>Misskeyでハイライトやサーバークラウドのアイコンがおかしい問題の対処法</title>
    <link href="https://blog.n1l.dev/2023/11/misskey-redis/"/>
    <id>https://blog.n1l.dev/2023/11/misskey-redis/</id>
    <published>2023-11-20T01:28:06.000Z</published>
    <updated>2026-11-22T13:54:02.927Z</updated>
    
    <content type="html"><![CDATA[<h4 id="問題点"><a href="#問題点" class="headerlink" title="問題点"></a>問題点</h4><ul><li>ハイライトが表示されない</li><li>サーバークラウドのアイコンが表示されない</li></ul><span id="more"></span><!-- toc --><h4 id="原因"><a href="#原因" class="headerlink" title="原因"></a>原因</h4><ul><li>Redisが古いことが原因<br>不確かだが、v7以上が必須のはずがv6が入っていた</li></ul><h4 id="対処法"><a href="#対処法" class="headerlink" title="対処法"></a>対処法</h4><ul><li>Redisを最新版にアップデートする</li></ul><figure class="highlight bash"><figcaption><span>terminal</span></figcaption><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line">sudo apt install -y curl ca-certificates gnupg2 lsb-release</span><br><span class="line"></span><br><span class="line">curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg</span><br><span class="line"></span><br><span class="line"><span class="built_in">echo</span> <span class="string">&quot;deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb <span class="subst">$(lsb_release -cs)</span> main&quot;</span> | sudo tee /etc/apt/sources.list.d/redis.list</span><br><span class="line"></span><br><span class="line">sudo apt update</span><br><span class="line"></span><br><span class="line">sudo apt install -y redis</span><br></pre></td></tr></table></figure><p>これでok。ついでにPostgreSQLも古いバージョンを利用していたためアップデートした</p><h4 id="PostgresSQLのアップデート"><a href="#PostgresSQLのアップデート" class="headerlink" title="PostgresSQLのアップデート"></a>PostgresSQLのアップデート</h4><p><strong>必ずpg_dump等でバックアップを取ってから行うこと</strong></p><figure class="highlight bash"><figcaption><span>terminal</span></figcaption><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">sudo apt install postgresql-15</span><br><span class="line">sudo pg_dropcluster 15 main --stop</span><br><span class="line">sudo pg_upgradecluster -v 15 14 main</span><br></pre></td></tr></table></figure><p><code>pg_updatecluster</code>で自動的にアップデートされ切り替わるので少しビビった</p><h4 id="参考"><a href="#参考" class="headerlink" title="参考"></a>参考</h4><ul><li><a href="https://misskey-hub.net/docs/install/ubuntu-manual.html#%E3%81%9D%E3%81%AE%E4%BB%96%E3%81%AEmisskey%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E6%96%B9%E6%B3%95">Ubuntu版Misskeyインストール方法詳説</a></li><li><a href="https://qiita.com/ynott/items/ca130c4b70533a91d3d3">Ubuntu 22.04 LTS で Postgresql 13から15にアップグレードした話(pg_upgradecluster編)</a></li></ul>]]></content>
    
    
    <summary type="html">Misskeyでハイライトが表示されない、サーバークラウドのアイコンがおかしくなる問題の対処法。原因の切り分けと確認ポイントをまとめた備忘録。</summary>
    
    
    
    
    <category term="misskey" scheme="https://blog.n1l.dev/tags/misskey/"/>
    
    <category term="redis" scheme="https://blog.n1l.dev/tags/redis/"/>
    
  </entry>
  
  <entry>
    <title>Misskey 2023.11.0にmeilisearchを導入する</title>
    <link href="https://blog.n1l.dev/2023/11/misskey-meilisearch/"/>
    <id>https://blog.n1l.dev/2023/11/misskey-meilisearch/</id>
    <published>2023-11-20T01:27:06.000Z</published>
    <updated>2026-11-22T13:54:02.927Z</updated>
    
    <content type="html"><![CDATA[<h3 id="Misskeyにmeilisearchを導入する方法"><a href="#Misskeyにmeilisearchを導入する方法" class="headerlink" title="Misskeyにmeilisearchを導入する方法"></a>Misskeyにmeilisearchを導入する方法</h3><span id="more"></span><!-- toc --><p>読み飛ばしたい人は6まで飛ばすことをお勧めする</p><h4 id="meilisearchのインストール"><a href="#meilisearchのインストール" class="headerlink" title="meilisearchのインストール"></a>meilisearchのインストール</h4><p><a href="https://www.meilisearch.com/docs/learn/cookbooks/running_production">公式ドキュメント</a>をもとに進めていく</p><figure class="highlight bash"><figcaption><span>terminal</span></figcaption><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line">sudo apt update</span><br><span class="line">sudo apt install curl -y</span><br><span class="line">curl -L https://install.meilisearch.com | sh</span><br><span class="line">chmod +x meilisearch</span><br><span class="line">sudo mv ./meilisearch /usr/<span class="built_in">local</span>/bin/</span><br><span class="line">sudo useradd -d /var/lib/meilisearch -b /bin/<span class="literal">false</span> -m -r meilisearch</span><br></pre></td></tr></table></figure><h4 id="設定ファイルの書き換え"><a href="#設定ファイルの書き換え" class="headerlink" title="設定ファイルの書き換え"></a>設定ファイルの書き換え</h4><figure class="highlight bash"><figcaption><span>terminal</span></figcaption><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">curl https://raw.githubusercontent.com/meilisearch/meilisearch/latest/config.toml &gt; meilisearch.toml</span><br><span class="line">nano meilisearch.toml</span><br></pre></td></tr></table></figure><p>master_keyは16バイト以上に必要らしいので、以下のコマンドで生成する</p><figure class="highlight bash"><figcaption><span>terminal</span></figcaption><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">sudo apt install uuid</span><br><span class="line">uuid</span><br></pre></td></tr></table></figure><figure class="highlight toml"><figcaption><span>meilisearch.toml</span></figcaption><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">env</span> = <span class="string">&quot;production&quot;</span></span><br><span class="line"><span class="attr">master_key</span> = <span class="string">&quot;YOUR_MASTER_KEY_VALUE&quot;</span></span><br><span class="line"><span class="attr">db_path</span> = <span class="string">&quot;/var/lib/meilisearch/data&quot;</span></span><br><span class="line"><span class="attr">dump_dir</span> = <span class="string">&quot;/var/lib/meilisearch/dumps&quot;</span></span><br><span class="line"><span class="attr">snapshot_dir</span> = <span class="string">&quot;/var/lib/meilisearch/snapshots&quot;</span></span><br></pre></td></tr></table></figure><p>以上の点を書き換え後、<code>sudo mv meilisearch.toml /etc/meilisearch/</code>で設定ファイルを移動する</p><p>移動後、ディレクトリを生成する</p><figure class="highlight bash"><figcaption><span>terminal</span></figcaption><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">sudo mkdir /var/lib/meilisearch/data /var/lib/meilisearch/dumps /var/lib/meilisearch/snapshots</span><br><span class="line">sudo chown -R meilisearch:meilisearch /var/lib/meilisearch</span><br><span class="line">sudo chmod 750 /var/lib/meilisearch</span><br></pre></td></tr></table></figure><h4 id="サービスの起動"><a href="#サービスの起動" class="headerlink" title="サービスの起動"></a>サービスの起動</h4><p><code>sudo nano /etc/systemd/system/meilisearch.service</code></p><figure class="highlight plain"><figcaption><span>/etc/systemd/system/meilisearch.service</span></figcaption><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br></pre></td><td class="code"><pre><span class="line">[Unit]</span><br><span class="line">Description&#x3D;Meilisearch</span><br><span class="line">After&#x3D;systemd-user-sessions.service</span><br><span class="line"></span><br><span class="line">[Service]</span><br><span class="line">Type&#x3D;simple</span><br><span class="line">WorkingDirectory&#x3D;&#x2F;var&#x2F;lib&#x2F;meilisearch</span><br><span class="line">ExecStart&#x3D;&#x2F;usr&#x2F;local&#x2F;bin&#x2F;meilisearch --config-file-path &#x2F;etc&#x2F;meilisearch.toml</span><br><span class="line">User&#x3D;meilisearch</span><br><span class="line">Group&#x3D;meilisearch</span><br><span class="line"></span><br><span class="line">[Install]</span><br><span class="line">WantedBy&#x3D;multi-user.target</span><br></pre></td></tr></table></figure><figure class="highlight bash"><figcaption><span>terminal</span></figcaption><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">sudo systemctl <span class="built_in">enable</span> meilisearch</span><br><span class="line">sudo systemctl start meilisearch</span><br><span class="line">sudo systemctl status meilisearch</span><br></pre></td></tr></table></figure><h4 id="APIキーの取得"><a href="#APIキーの取得" class="headerlink" title="APIキーの取得"></a>APIキーの取得</h4><figure class="highlight bash"><figcaption><span>terminal</span></figcaption><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">curl \</span><br><span class="line">  -X GET <span class="string">&#x27;http://localhost:7700/keys&#x27;</span> \</span><br><span class="line">  -H <span class="string">&#x27;Authorization: Bearer MASTER_KEY&#x27;</span></span><br></pre></td></tr></table></figure><p><code>MASTER_KEY</code>にはmeilisearch.tomlで設定したmaster_keyを入れる</p><p>次のように返ってくるため</p><figure class="highlight json"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br><span class="line">32</span><br><span class="line">33</span><br><span class="line">34</span><br><span class="line">35</span><br><span class="line">36</span><br><span class="line">37</span><br><span class="line">38</span><br><span class="line">39</span><br><span class="line">40</span><br><span class="line">41</span><br><span class="line">42</span><br><span class="line">43</span><br><span class="line">44</span><br><span class="line">45</span><br><span class="line">46</span><br><span class="line">47</span><br><span class="line">48</span><br><span class="line">49</span><br><span class="line">50</span><br><span class="line">51</span><br><span class="line">52</span><br></pre></td><td class="code"><pre><span class="line">&#123;</span><br><span class="line">  <span class="attr">&quot;results&quot;</span>: [</span><br><span class="line">    &#123;</span><br><span class="line">      <span class="attr">&quot;name&quot;</span>: <span class="string">&quot;Default Search API Key&quot;</span>,</span><br><span class="line">      <span class="attr">&quot;description&quot;</span>: <span class="string">&quot;Use it to search from the frontend&quot;</span>,</span><br><span class="line">      <span class="attr">&quot;key&quot;</span>: <span class="string">&quot;d0552b41536279a0ad88bd595327b96f01176a60c2243e906c52ac02375f9bc4&quot;</span>,</span><br><span class="line">      <span class="attr">&quot;uid&quot;</span>:<span class="string">&quot;74c9c733-3368-4738-bbe5-1d18a5fecb37&quot;</span>,</span><br><span class="line">      <span class="attr">&quot;actions&quot;</span>: [</span><br><span class="line">        <span class="string">&quot;search&quot;</span></span><br><span class="line">      ],</span><br><span class="line">      <span class="attr">&quot;indexes&quot;</span>: [</span><br><span class="line">        <span class="string">&quot;*&quot;</span></span><br><span class="line">      ],</span><br><span class="line">      <span class="attr">&quot;expiresAt&quot;</span>: <span class="literal">null</span>,</span><br><span class="line">      <span class="attr">&quot;createdAt&quot;</span>: <span class="string">&quot;2022-01-01T10:00:00Z&quot;</span>,</span><br><span class="line">      <span class="attr">&quot;updatedAt&quot;</span>: <span class="string">&quot;2022-01-01T10:00:00Z&quot;</span></span><br><span class="line">    &#125;,</span><br><span class="line">    &#123;</span><br><span class="line">      <span class="attr">&quot;name&quot;</span>: <span class="string">&quot;Default Admin API Key&quot;</span>,</span><br><span class="line">      <span class="attr">&quot;description&quot;</span>: <span class="string">&quot;Use it for all other than search operations. Caution! Do not expose it on a public frontend&quot;</span>,</span><br><span class="line">      <span class="attr">&quot;key&quot;</span>: <span class="string">&quot;380689dd379232519a54d15935750cc7625620a2ea2fc06907cb40ba5b421b6f&quot;</span>,</span><br><span class="line">      <span class="attr">&quot;uid&quot;</span>: <span class="string">&quot;20f7e4c4-612c-4dd1-b783-7934cc038213&quot;</span>,</span><br><span class="line">      <span class="attr">&quot;actions&quot;</span>: [</span><br><span class="line">        <span class="string">&quot;*&quot;</span></span><br><span class="line">      ],</span><br><span class="line">      <span class="attr">&quot;indexes&quot;</span>: [</span><br><span class="line">        <span class="string">&quot;*&quot;</span></span><br><span class="line">      ],</span><br><span class="line">      <span class="attr">&quot;expiresAt&quot;</span>: <span class="literal">null</span>,</span><br><span class="line">      <span class="attr">&quot;createdAt&quot;</span>: <span class="string">&quot;2021-08-11T10:00:00Z&quot;</span>,</span><br><span class="line">      <span class="attr">&quot;updatedAt&quot;</span>: <span class="string">&quot;2021-08-11T10:00:00Z&quot;</span></span><br><span class="line">    &#125;,</span><br><span class="line">    &#123;</span><br><span class="line">      <span class="attr">&quot;name&quot;</span>: <span class="literal">null</span>,</span><br><span class="line">      <span class="attr">&quot;description&quot;</span>: <span class="string">&quot;Search patient records key&quot;</span>,</span><br><span class="line">      <span class="attr">&quot;key&quot;</span>: <span class="string">&quot;d0552b41536279a0ad88bd595327b96f01176a60c2243e906c52ac02375f9bc4&quot;</span>,</span><br><span class="line">      <span class="attr">&quot;uid&quot;</span>: <span class="string">&quot;ac5cd97d-5a4b-4226-a868-2d0eb6d197ab&quot;</span>,</span><br><span class="line">      <span class="attr">&quot;actions&quot;</span>: [</span><br><span class="line">        <span class="string">&quot;search&quot;</span></span><br><span class="line">      ],</span><br><span class="line">      <span class="attr">&quot;indexes&quot;</span>: [</span><br><span class="line">        <span class="string">&quot;patient_medical_records&quot;</span></span><br><span class="line">      ],</span><br><span class="line">      <span class="attr">&quot;expiresAt&quot;</span>: <span class="string">&quot;2023-01-01T00:00:00Z&quot;</span>,</span><br><span class="line">      <span class="attr">&quot;createdAt&quot;</span>: <span class="string">&quot;2022-01-01T10:00:00Z&quot;</span>,</span><br><span class="line">      <span class="attr">&quot;updatedAt&quot;</span>: <span class="string">&quot;2022-01-01T10:00:00Z&quot;</span></span><br><span class="line">    &#125;</span><br><span class="line">  ],</span><br><span class="line">  <span class="attr">&quot;offset&quot;</span>:<span class="number">0</span>,</span><br><span class="line">  <span class="attr">&quot;limit&quot;</span>:<span class="number">20</span>,</span><br><span class="line">  <span class="attr">&quot;total&quot;</span>:<span class="number">3</span></span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure><p>Default Admin API Keyの<code>key</code>をコピーする</p><h4 id="Misskeyの設定"><a href="#Misskeyの設定" class="headerlink" title="Misskeyの設定"></a>Misskeyの設定</h4><p>misskeyの設定ファイルを開く</p><figure class="highlight bash"><figcaption><span>terminal</span></figcaption><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">sudo nano /home/misskey/config/default.yaml</span><br></pre></td></tr></table></figure><figure class="highlight yaml"><figcaption><span>/home/misskey/config/default.yaml</span></figcaption><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">meilisearch:</span></span><br><span class="line">  <span class="attr">host:</span> <span class="string">localhost</span></span><br><span class="line">  <span class="attr">port:</span> <span class="number">7700</span></span><br><span class="line">  <span class="attr">apiKey:</span> <span class="string">&#x27;先ほどコピーしたkeyを入れる&#x27;</span></span><br><span class="line"><span class="comment">#  ssl: true</span></span><br><span class="line">  <span class="attr">index:</span> <span class="string">&#x27;misskey&#x27;</span></span><br><span class="line"><span class="comment">#  scope: local</span></span><br></pre></td></tr></table></figure><p>scopeはlocalにすると、ローカルのみ検索できるようになる<br>indexはdomain名が推奨されている模様。今回はmisskeyとした</p><h4 id="indexを張る"><a href="#indexを張る" class="headerlink" title="indexを張る"></a>indexを張る</h4><p>ここからが本番といっても過言ではないだろう。</p><iframe src="https://fedibird.com/@noellabo/111419037137255692/embed" class="mastodon-embed" style="max-width: 100%; border: 0" width="400"></iframe><script src="https://fedibird.com/embed.js" async="async"></script><p>上記の通り、<code>2023.11</code>から<code>createdAt</code>が削除されているのだ。</p><p>そのため、<a href="https://github.com/noellabo/misskey_meilisearch_importer">misskey_meilisearch_importer</a>を使ってindexを張る必要がある。</p><figure class="highlight bash"><figcaption><span>terminal</span></figcaption><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><span class="built_in">cd</span> /home/misskey</span><br><span class="line"></span><br><span class="line">git <span class="built_in">clone</span> https://github.com/noellabo/misskey_meilisearch_importer.git</span><br><span class="line"><span class="built_in">cd</span> misskey_meilisearch_importer</span><br><span class="line"></span><br><span class="line">pnpm install</span><br></pre></td></tr></table></figure><figure class="highlight bash"><figcaption><span>terminal</span></figcaption><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">node importer.js --config /home/misskey/.config/default.yml</span><br></pre></td></tr></table></figure><p>これでindexが張られる。これでaid形式のインポートは終了。<code>misskey -&gt; ダッシュボード -&gt; ロール</code>よりノートの検索を有効にし、検索ができるようになる。</p><h4 id="私の場合"><a href="#私の場合" class="headerlink" title="私の場合"></a>私の場合</h4><p>まず、aidxのため、うまくいかなかった。<br>そのため、forkし、修正したものを使っている。<br><a href="https://github.com/n1lsqn/misskey_meilisearch_importer.git">misskey_meilisearch_importer</a></p><h4 id="参考"><a href="#参考" class="headerlink" title="参考"></a>参考</h4><p><a href="https://fedibird.com/@noellabo/111419037137255692">のえるさんの投稿</a><br><a href="https://www.meilisearch.com/docs/learn/cookbooks/running_production">公式ドキュメント</a></p>]]></content>
    
    
    <summary type="html">Misskey 2023.11.0に検索バックエンドとしてMeilisearchを導入する手順。インデックス作成からaid/aidx形式のノートインポート、検索を有効化するまでの流れと、fork版インポーターを使った対処をまとめた。</summary>
    
    
    
    
    <category term="misskey" scheme="https://blog.n1l.dev/tags/misskey/"/>
    
    <category term="meilisearch" scheme="https://blog.n1l.dev/tags/meilisearch/"/>
    
  </entry>
  
</feed>
