@sanqianx/project-knowledge 5.0.19 → 5.0.20

package/docs/assets/architecture.svg

@@ -1,182 +1,182 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1180 620" role="img" aria-label="Architecture">
-  <defs>
-    <linearGradient id="card" x1="0" y1="0" x2="0" y2="1">
-      <stop offset="0" stop-color="#1a2330"/>
-      <stop offset="1" stop-color="#141c26"/>
-    </linearGradient>
-    <linearGradient id="cardHover" x1="0" y1="0" x2="0" y2="1">
-      <stop offset="0" stop-color="#1f2a3a"/>
-      <stop offset="1" stop-color="#192331"/>
-    </linearGradient>
-    <marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse">
-      <path d="M 0 0 L 10 5 L 0 10 z" fill="#7492a5"/>
-    </marker>
-  </defs>
-
-  <rect width="1180" height="620" fill="#0c1118"/>
-
-  <!-- Title -->
-  <text x="590" y="42" text-anchor="middle" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="17" font-weight="600" fill="#e3ebf5" letter-spacing="-0.2">How project-knowledge works</text>
-  <text x="590" y="62" text-anchor="middle" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="11.5" fill="#94a3b8">Local-first pipeline · every byte stays under your home directory</text>
-
-  <!-- Layer labels -->
-  <g font-family="ui-monospace, Consolas, monospace" font-size="9.5" fill="#64748b" letter-spacing="1.5" font-weight="600">
-    <text x="28" y="150">USER · UI</text>
-    <text x="28" y="282">SERVER</text>
-    <text x="28" y="438">DATA · GIT</text>
-    <text x="28" y="582">EXTERNAL</text>
-  </g>
-
-  <!-- Layer 1: User-facing -->
-  <g transform="translate(120,86)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif">
-    <g>
-      <rect width="252" height="116" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
-      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Browser Dashboard</text>
-      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">127.0.0.1:5757</text>
-      <g font-size="10.5" fill="#94a3b8">
-        <text x="16" y="60">· Project sidebar</text>
-        <text x="16" y="76">· Supervision cards</text>
-        <text x="16" y="92">· Runs / Drafts review</text>
-        <text x="16" y="108">· Claude workbench</text>
-      </g>
-    </g>
-
-    <g transform="translate(264,0)">
-      <rect width="252" height="116" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
-      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">CLI daemon</text>
-      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">start · stop · status · --fg</text>
-      <g font-size="10.5" fill="#94a3b8">
-        <text x="16" y="60">· Port fallback 5757–5776</text>
-        <text x="16" y="76">· PID file in os.tmpdir()</text>
-        <text x="16" y="92">· Auto-open browser</text>
-        <text x="16" y="108">· Survives terminal close</text>
-      </g>
-    </g>
-
-    <g transform="translate(528,0)">
-      <rect width="252" height="116" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
-      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Post-commit hook</text>
-      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">.git/hooks/post-commit</text>
-      <g font-size="10.5" fill="#94a3b8">
-        <text x="16" y="60">· Fires on git commit</text>
-        <text x="16" y="76">· Triggers scan + analysis</text>
-        <text x="16" y="92">· Injects KB reading rule</text>
-        <text x="16" y="108">  into project's CLAUDE.md</text>
-      </g>
-    </g>
-
-    <g transform="translate(792,0)">
-      <rect width="252" height="116" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
-      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Claude Code / agents</text>
-      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">reads KB indexes first</text>
-      <g font-size="10.5" fill="#94a3b8">
-        <text x="16" y="60">· Reads GOAL.md</text>
-        <text x="16" y="76">· Reads modules/00-index.md</text>
-        <text x="16" y="92">· Reads changes/00-index.md</text>
-        <text x="16" y="108">· Opens only top-matched files</text>
-      </g>
-    </g>
-  </g>
-
-  <!-- Layer 2: Server -->
-  <g transform="translate(120,220)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif">
-    <rect width="1044" height="124" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
-    <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Local HTTP server · Node.js · 127.0.0.1 only</text>
-
-    <g font-size="10">
-      <g transform="translate(16,40)">
-        <rect width="148" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
-        <text x="74" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">scanner.js</text>
-        <text x="74" y="26" font-size="9" fill="#64748b" text-anchor="middle">git state walker</text>
-      </g>
-      <g transform="translate(176,40)">
-        <rect width="170" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
-        <text x="85" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">analysis-orchestrator</text>
-        <text x="85" y="26" font-size="9" fill="#64748b" text-anchor="middle">commit / initial</text>
-      </g>
-      <g transform="translate(358,40)">
-        <rect width="160" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
-        <text x="80" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">context-pack-builder</text>
-        <text x="80" y="26" font-size="9" fill="#64748b" text-anchor="middle">prompt assembly</text>
-      </g>
-      <g transform="translate(530,40)">
-        <rect width="132" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
-        <text x="66" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">kb-framework</text>
-        <text x="66" y="26" font-size="9" fill="#64748b" text-anchor="middle">layout / validate</text>
-      </g>
-      <g transform="translate(674,40)">
-        <rect width="120" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
-        <text x="60" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">draft-apply</text>
-        <text x="60" y="26" font-size="9" fill="#64748b" text-anchor="middle">review / merge</text>
-      </g>
-      <g transform="translate(806,40)">
-        <rect width="222" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
-        <text x="111" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">github-team-store</text>
-        <text x="111" y="26" font-size="9" fill="#64748b" text-anchor="middle">Gitea OAuth · sparse checkout</text>
-      </g>
-    </g>
-    <text x="16" y="100" font-size="10" font-family="ui-monospace, Consolas, monospace" fill="#64748b">REST + WebSocket on a single port · SPA shell from _site/index.html</text>
-  </g>
-
-  <!-- Layer 3: Data + git -->
-  <g transform="translate(120,376)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif">
-    <g>
-      <rect width="252" height="124" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
-      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">~/.project-knowledge/</text>
-      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">or $KB_DATA_DIR</text>
-      <g font-size="10.5" font-family="ui-monospace, Consolas, monospace" fill="#94a3b8">
-        <text x="16" y="62">projects.json</text>
-        <text x="16" y="78">ai-profiles.json</text>
-        <text x="16" y="94">knowledge-store.json</text>
-        <text x="16" y="110">logs/  ·  _ai/  ·  projects/</text>
-      </g>
-    </g>
-    <g transform="translate(264,0)">
-      <rect width="252" height="124" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
-      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Your Git projects</text>
-      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">local paths · local repos</text>
-      <g font-size="10.5" font-family="ui-monospace, Consolas, monospace" fill="#94a3b8">
-        <text x="16" y="62">git status / log / branch</text>
-        <text x="16" y="78">HEAD metadata</text>
-        <text x="16" y="94">.git/hooks/post-commit</text>
-        <text x="16" y="110">CLAUDE.md (managed block)</text>
-      </g>
-    </g>
-    <g transform="translate(528,0)">
-      <rect width="636" height="124" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
-      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Generated knowledge base (per project)</text>
-      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">bilingual · module + change docs · reviewed drafts only</text>
-      <g font-size="10.5" font-family="ui-monospace, Consolas, monospace" fill="#94a3b8">
-        <text x="16" y="62">  &lt;kbPath&gt;/GOAL.md</text>
-        <text x="16" y="78">  modules/00-index.md  ·  changes/00-index.md</text>
-        <text x="16" y="94">  modules/&lt;area&gt;.md  ·  changes/release-v*.md</text>
-        <text x="16" y="110">  drafts/&lt;pending&gt;.md  (reviewable before apply)</text>
-      </g>
-    </g>
-  </g>
-
-  <!-- Layer 4: External -->
-  <g transform="translate(120,520)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif">
-    <rect width="1044" height="44" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
-    <text x="16" y="20" font-size="12" font-weight="600" fill="#cbd5e1">Anthropic-compatible LLM API</text>
-    <text x="200" y="20" font-size="10.5" fill="#94a3b8" font-family="ui-monospace, Consolas, monospace">Claude · GLM · DeepSeek · Kimi · self-hosted — any provider exposing the Anthropic Messages API shape</text>
-    <text x="200" y="36" font-size="9.5" fill="#64748b">Keys stored locally in ai-profiles.json · never leave your machine except in the request body itself</text>
-  </g>
-
-  <!-- Connectors -->
-  <g stroke="#7492a5" stroke-width="1.2" fill="none" marker-end="url(#arrow)" opacity="0.55">
-    <!-- User -> Server -->
-    <line x1="246" y1="202" x2="246" y2="216"/>
-    <line x1="510" y1="202" x2="510" y2="216"/>
-    <line x1="774" y1="202" x2="774" y2="216"/>
-    <!-- Server -> Data -->
-    <line x1="246" y1="344" x2="246" y2="372"/>
-    <line x1="510" y1="344" x2="510" y2="372"/>
-    <line x1="774" y1="344" x2="774" y2="372"/>
-    <!-- Server -> External -->
-    <line x1="640" y1="344" x2="640" y2="516"/>
-    <!-- User agents <-> Server (read KB) -->
-    <line x1="918" y1="202" x2="918" y2="216"/>
-    <line x1="918" y1="468" x2="918" y2="496" stroke-dasharray="3,3" opacity="0.4"/>
-  </g>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1180 620" role="img" aria-label="Architecture">
+  <defs>
+    <linearGradient id="card" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="#1a2330"/>
+      <stop offset="1" stop-color="#141c26"/>
+    </linearGradient>
+    <linearGradient id="cardHover" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="#1f2a3a"/>
+      <stop offset="1" stop-color="#192331"/>
+    </linearGradient>
+    <marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#7492a5"/>
+    </marker>
+  </defs>
+
+  <rect width="1180" height="620" fill="#0c1118"/>
+
+  <!-- Title -->
+  <text x="590" y="42" text-anchor="middle" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="17" font-weight="600" fill="#e3ebf5" letter-spacing="-0.2">How project-knowledge works</text>
+  <text x="590" y="62" text-anchor="middle" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="11.5" fill="#94a3b8">Local-first pipeline · every byte stays under your home directory</text>
+
+  <!-- Layer labels -->
+  <g font-family="ui-monospace, Consolas, monospace" font-size="9.5" fill="#64748b" letter-spacing="1.5" font-weight="600">
+    <text x="28" y="150">USER · UI</text>
+    <text x="28" y="282">SERVER</text>
+    <text x="28" y="438">DATA · GIT</text>
+    <text x="28" y="582">EXTERNAL</text>
+  </g>
+
+  <!-- Layer 1: User-facing -->
+  <g transform="translate(120,86)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif">
+    <g>
+      <rect width="252" height="116" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Browser Dashboard</text>
+      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">127.0.0.1:5757</text>
+      <g font-size="10.5" fill="#94a3b8">
+        <text x="16" y="60">· Project sidebar</text>
+        <text x="16" y="76">· Supervision cards</text>
+        <text x="16" y="92">· Runs / Drafts review</text>
+        <text x="16" y="108">· Claude workbench</text>
+      </g>
+    </g>
+
+    <g transform="translate(264,0)">
+      <rect width="252" height="116" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">CLI daemon</text>
+      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">start · stop · status · --fg</text>
+      <g font-size="10.5" fill="#94a3b8">
+        <text x="16" y="60">· Port fallback 5757–5776</text>
+        <text x="16" y="76">· PID file in os.tmpdir()</text>
+        <text x="16" y="92">· Auto-open browser</text>
+        <text x="16" y="108">· Survives terminal close</text>
+      </g>
+    </g>
+
+    <g transform="translate(528,0)">
+      <rect width="252" height="116" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Post-commit hook</text>
+      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">.git/hooks/post-commit</text>
+      <g font-size="10.5" fill="#94a3b8">
+        <text x="16" y="60">· Fires on git commit</text>
+        <text x="16" y="76">· Triggers scan + analysis</text>
+        <text x="16" y="92">· Injects KB reading rule</text>
+        <text x="16" y="108">  into project's CLAUDE.md</text>
+      </g>
+    </g>
+
+    <g transform="translate(792,0)">
+      <rect width="252" height="116" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Claude Code / agents</text>
+      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">reads KB indexes first</text>
+      <g font-size="10.5" fill="#94a3b8">
+        <text x="16" y="60">· Reads GOAL.md</text>
+        <text x="16" y="76">· Reads modules/00-index.md</text>
+        <text x="16" y="92">· Reads changes/00-index.md</text>
+        <text x="16" y="108">· Opens only top-matched files</text>
+      </g>
+    </g>
+  </g>
+
+  <!-- Layer 2: Server -->
+  <g transform="translate(120,220)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif">
+    <rect width="1044" height="124" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+    <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Local HTTP server · Node.js · 127.0.0.1 only</text>
+
+    <g font-size="10">
+      <g transform="translate(16,40)">
+        <rect width="148" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
+        <text x="74" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">scanner.js</text>
+        <text x="74" y="26" font-size="9" fill="#64748b" text-anchor="middle">git state walker</text>
+      </g>
+      <g transform="translate(176,40)">
+        <rect width="170" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
+        <text x="85" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">analysis-orchestrator</text>
+        <text x="85" y="26" font-size="9" fill="#64748b" text-anchor="middle">commit / initial</text>
+      </g>
+      <g transform="translate(358,40)">
+        <rect width="160" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
+        <text x="80" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">context-pack-builder</text>
+        <text x="80" y="26" font-size="9" fill="#64748b" text-anchor="middle">prompt assembly</text>
+      </g>
+      <g transform="translate(530,40)">
+        <rect width="132" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
+        <text x="66" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">kb-framework</text>
+        <text x="66" y="26" font-size="9" fill="#64748b" text-anchor="middle">layout / validate</text>
+      </g>
+      <g transform="translate(674,40)">
+        <rect width="120" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
+        <text x="60" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">draft-apply</text>
+        <text x="60" y="26" font-size="9" fill="#64748b" text-anchor="middle">review / merge</text>
+      </g>
+      <g transform="translate(806,40)">
+        <rect width="222" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
+        <text x="111" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">github-team-store</text>
+        <text x="111" y="26" font-size="9" fill="#64748b" text-anchor="middle">Gitea OAuth · sparse checkout</text>
+      </g>
+    </g>
+    <text x="16" y="100" font-size="10" font-family="ui-monospace, Consolas, monospace" fill="#64748b">REST + WebSocket on a single port · SPA shell from _site/index.html</text>
+  </g>
+
+  <!-- Layer 3: Data + git -->
+  <g transform="translate(120,376)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif">
+    <g>
+      <rect width="252" height="124" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">~/.project-knowledge/</text>
+      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">or $KB_DATA_DIR</text>
+      <g font-size="10.5" font-family="ui-monospace, Consolas, monospace" fill="#94a3b8">
+        <text x="16" y="62">projects.json</text>
+        <text x="16" y="78">ai-profiles.json</text>
+        <text x="16" y="94">knowledge-store.json</text>
+        <text x="16" y="110">logs/  ·  _ai/  ·  projects/</text>
+      </g>
+    </g>
+    <g transform="translate(264,0)">
+      <rect width="252" height="124" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Your Git projects</text>
+      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">local paths · local repos</text>
+      <g font-size="10.5" font-family="ui-monospace, Consolas, monospace" fill="#94a3b8">
+        <text x="16" y="62">git status / log / branch</text>
+        <text x="16" y="78">HEAD metadata</text>
+        <text x="16" y="94">.git/hooks/post-commit</text>
+        <text x="16" y="110">CLAUDE.md (managed block)</text>
+      </g>
+    </g>
+    <g transform="translate(528,0)">
+      <rect width="636" height="124" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Generated knowledge base (per project)</text>
+      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">bilingual · module + change docs · reviewed drafts only</text>
+      <g font-size="10.5" font-family="ui-monospace, Consolas, monospace" fill="#94a3b8">
+        <text x="16" y="62">  &lt;kbPath&gt;/GOAL.md</text>
+        <text x="16" y="78">  modules/00-index.md  ·  changes/00-index.md</text>
+        <text x="16" y="94">  modules/&lt;area&gt;.md  ·  changes/release-v*.md</text>
+        <text x="16" y="110">  drafts/&lt;pending&gt;.md  (reviewable before apply)</text>
+      </g>
+    </g>
+  </g>
+
+  <!-- Layer 4: External -->
+  <g transform="translate(120,520)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif">
+    <rect width="1044" height="44" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+    <text x="16" y="20" font-size="12" font-weight="600" fill="#cbd5e1">Anthropic-compatible LLM API</text>
+    <text x="200" y="20" font-size="10.5" fill="#94a3b8" font-family="ui-monospace, Consolas, monospace">Claude · GLM · DeepSeek · Kimi · self-hosted — any provider exposing the Anthropic Messages API shape</text>
+    <text x="200" y="36" font-size="9.5" fill="#64748b">Keys stored locally in ai-profiles.json · never leave your machine except in the request body itself</text>
+  </g>
+
+  <!-- Connectors -->
+  <g stroke="#7492a5" stroke-width="1.2" fill="none" marker-end="url(#arrow)" opacity="0.55">
+    <!-- User -> Server -->
+    <line x1="246" y1="202" x2="246" y2="216"/>
+    <line x1="510" y1="202" x2="510" y2="216"/>
+    <line x1="774" y1="202" x2="774" y2="216"/>
+    <!-- Server -> Data -->
+    <line x1="246" y1="344" x2="246" y2="372"/>
+    <line x1="510" y1="344" x2="510" y2="372"/>
+    <line x1="774" y1="344" x2="774" y2="372"/>
+    <!-- Server -> External -->
+    <line x1="640" y1="344" x2="640" y2="516"/>
+    <!-- User agents <-> Server (read KB) -->
+    <line x1="918" y1="202" x2="918" y2="216"/>
+    <line x1="918" y1="468" x2="918" y2="496" stroke-dasharray="3,3" opacity="0.4"/>
+  </g>
 </svg>

package/docs/assets/logo.svg

@@ -1,50 +1,50 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 560 160" role="img" aria-label="project-knowledge logo">
-  <defs>
-    <linearGradient id="bg" x1="0" y1="0" x2="560" y2="160" gradientUnits="userSpaceOnUse">
-      <stop offset="0" stop-color="#0c1118"/>
-      <stop offset="1" stop-color="#141c26"/>
-    </linearGradient>
-    <linearGradient id="core" x1="80" y1="40" x2="120" y2="120" gradientUnits="userSpaceOnUse">
-      <stop offset="0" stop-color="#dff8ff"/>
-      <stop offset=".55" stop-color="#7dd3fc"/>
-      <stop offset="1" stop-color="#2f7d64"/>
-    </linearGradient>
-    <linearGradient id="book" x1="78" y1="92" x2="148" y2="128" gradientUnits="userSpaceOnUse">
-      <stop offset="0" stop-color="#f8fafc"/>
-      <stop offset="1" stop-color="#b8c6d8"/>
-    </linearGradient>
-    <filter id="glow" x="-40%" y="-40%" width="180%" height="180%">
-      <feGaussianBlur stdDeviation="3.5"/>
-    </filter>
-  </defs>
-  <rect width="560" height="160" rx="18" fill="url(#bg)"/>
-  <!-- Logo mark -->
-  <g transform="translate(36,28)">
-    <!-- Glow halo -->
-    <circle cx="60" cy="52" r="42" fill="#7492a5" opacity="0.18" filter="url(#glow)"/>
-    <!-- Book base -->
-    <path d="M22 78 L98 78 L98 118 Q60 110 22 118 Z" fill="url(#book)" opacity="0.92"/>
-    <path d="M60 84 L60 116" stroke="#7492a5" stroke-width="1.2" opacity="0.55"/>
-    <!-- Core orb -->
-    <circle cx="60" cy="52" r="26" fill="url(#core)"/>
-    <!-- Orbiting nodes -->
-    <circle cx="60" cy="14" r="4.5" fill="#7dd3fc"/>
-    <circle cx="100" cy="36" r="4.5" fill="#75b798"/>
-    <circle cx="100" cy="68" r="4.5" fill="#c5a15d"/>
-    <circle cx="20" cy="36" r="4.5" fill="#60a5fa"/>
-    <circle cx="20" cy="68" r="4.5" fill="#d36d6d"/>
-    <!-- Connectors -->
-    <g stroke="#7492a5" stroke-width="1.1" opacity="0.55" fill="none">
-      <line x1="60" y1="14" x2="60" y2="26"/>
-      <line x1="100" y1="36" x2="84" y2="46"/>
-      <line x1="100" y1="68" x2="84" y2="58"/>
-      <line x1="20" y1="36" x2="36" y2="46"/>
-      <line x1="20" y1="68" x2="36" y2="58"/>
-    </g>
-  </g>
-  <!-- Wordmark -->
-  <g transform="translate(184,52)" fill="#e3ebf5" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif">
-    <text x="0" y="28" font-size="34" font-weight="700" letter-spacing="-0.5">project-knowledge</text>
-    <text x="2" y="58" font-size="15" font-weight="500" fill="#7492a5" letter-spacing="0.5">Local KB · Git-aware · AI-reviewed</text>
-  </g>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 560 160" role="img" aria-label="project-knowledge logo">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="560" y2="160" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#0c1118"/>
+      <stop offset="1" stop-color="#141c26"/>
+    </linearGradient>
+    <linearGradient id="core" x1="80" y1="40" x2="120" y2="120" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#dff8ff"/>
+      <stop offset=".55" stop-color="#7dd3fc"/>
+      <stop offset="1" stop-color="#2f7d64"/>
+    </linearGradient>
+    <linearGradient id="book" x1="78" y1="92" x2="148" y2="128" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#f8fafc"/>
+      <stop offset="1" stop-color="#b8c6d8"/>
+    </linearGradient>
+    <filter id="glow" x="-40%" y="-40%" width="180%" height="180%">
+      <feGaussianBlur stdDeviation="3.5"/>
+    </filter>
+  </defs>
+  <rect width="560" height="160" rx="18" fill="url(#bg)"/>
+  <!-- Logo mark -->
+  <g transform="translate(36,28)">
+    <!-- Glow halo -->
+    <circle cx="60" cy="52" r="42" fill="#7492a5" opacity="0.18" filter="url(#glow)"/>
+    <!-- Book base -->
+    <path d="M22 78 L98 78 L98 118 Q60 110 22 118 Z" fill="url(#book)" opacity="0.92"/>
+    <path d="M60 84 L60 116" stroke="#7492a5" stroke-width="1.2" opacity="0.55"/>
+    <!-- Core orb -->
+    <circle cx="60" cy="52" r="26" fill="url(#core)"/>
+    <!-- Orbiting nodes -->
+    <circle cx="60" cy="14" r="4.5" fill="#7dd3fc"/>
+    <circle cx="100" cy="36" r="4.5" fill="#75b798"/>
+    <circle cx="100" cy="68" r="4.5" fill="#c5a15d"/>
+    <circle cx="20" cy="36" r="4.5" fill="#60a5fa"/>
+    <circle cx="20" cy="68" r="4.5" fill="#d36d6d"/>
+    <!-- Connectors -->
+    <g stroke="#7492a5" stroke-width="1.1" opacity="0.55" fill="none">
+      <line x1="60" y1="14" x2="60" y2="26"/>
+      <line x1="100" y1="36" x2="84" y2="46"/>
+      <line x1="100" y1="68" x2="84" y2="58"/>
+      <line x1="20" y1="36" x2="36" y2="46"/>
+      <line x1="20" y1="68" x2="36" y2="58"/>
+    </g>
+  </g>
+  <!-- Wordmark -->
+  <g transform="translate(184,52)" fill="#e3ebf5" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif">
+    <text x="0" y="28" font-size="34" font-weight="700" letter-spacing="-0.5">project-knowledge</text>
+    <text x="2" y="58" font-size="15" font-weight="500" fill="#7492a5" letter-spacing="0.5">Local KB · Git-aware · AI-reviewed</text>
+  </g>
 </svg>

package/docs/fresh-v5-start.md

@@ -1,42 +1,42 @@
-# v5 从头开始
-
-本版按用户确认不再迁移以前的知识库数据。旧文件留在原位置，但新版不会读取它们；没有对用户代码仓库或旧知识目录执行删除。
-
-## 更新
-
-```bash
-project-knowledge stop
-npm install -g @sanqianx/project-knowledge@latest --registry=https://registry.npmjs.org/
-project-knowledge-integrations update
-project-knowledge
-```
-
-需要 Node ≥22 和 Git。默认使用 `~/.project-knowledge-v5`，四模块的托管数据也在此目录内。若环境变量 `KB_DATA_DIR` 仍指向旧目录，请取消该设置或改为新的空目录。不要把旧 `projects.json`、设置或引擎状态复制进新目录。
-
-5.0.6 修复首次启动被未登记的旧工作台会话误拦截：仅有日志、默认提示词及孤立会话的目录可以创建空的新登记，孤立会话保留原字节但不会恢复或触发任务。实际旧项目、设置、引擎状态或维护任务仍拒绝迁移，错误列出具体目录和冲突项。后台启动命令等待 HTTP 就绪后才报成功；启动失败直接在终端显示原因并返回非零退出码，不提前打开浏览器。
-
-在“系统状态”重新配置模型与后台默认模型、embedding 和知识根目录，然后在“领域与项目”导入代码目录及新的空知识目录。原代码目录无需移动。若残留旧知识库托管 Hook，导入预检会要求明确确认替换；不会覆盖第三方 Hook。导入建立 HEAD 基线，不分析已有历史。
-
-如果模块是自己独立启动的旧进程，请在它原来的终端中停止后重启新版外壳。外壳不会擅自杀死其他服务；版本或运行期鉴权不一致时显示具体连接阶段，不接管旧服务数据。
-
-5.0.1 修复旧版 Git 的项目导入失败（日志中的路径包含
-`--path-format=absolute` 和换行）。升级 5.0.0 → 5.0.1 不需要清空新版数据或
-重新配置模型。失败项目可以直接重试导入；原代码、第三方 Hook 与旧知识文件不删除。
-导入失败会在弹窗保留错误码和操作 ID，系统诊断默认查询“系统与所有项目”，
-可按操作 ID 查找导入事务的真实失败阶段和原始错误。
-
-## 解绑与恢复
-
-5.0.7 的命令不区分大小写，`STOP` 与 `stop` 相同。未知命令不会误启动。
-`status` 和 `stop` 默认只控制当前数据目录；`status --all` 查看可控制的本机实例，
-`stop --port 5804` 指定停止目标，`--data "D:/data/knowledge"` 明确选择数据目录。
-停止通过本机控制通道等待外壳及其托管模块退出，不再使用共享临时 PID 或盲杀。
-未验证或正在启动的实例不会误报已停止，独立启动的模块也不会被结束。
-
-“解绑并保留数据”从项目列表移除登记、取消未开始任务并卸下本项目托管 Hook，保留代码、知识、会话及证据。实际分析或索引写入尚未结束时仍禁止解绑，防止丢失写入状态。队列本身不再被当成正在运行。
-
-删除的是旧版本兼容路径，不是新版的故障恢复能力：v5 自身的重启恢复、提交去重、并发限制、失败重试和索引修复仍有效。`upgrade-recovery` 不再存在。
-
-## 回归范围
-
-旧格式迁移专用测试随旧实现删除，替换为旧目录拒绝且原字节不变、空状态启动、连接失败诊断与恢复、旧托管 Hook 的显式替换和回滚测试。真实提交链路继续由引擎 Git/Hook/journal/晋升/索引回归和五服务网页回归覆盖。模型替身和真实模型的结果分开记录；旧版本真实调用记录不计为本版通过。
+# v5 从头开始
+
+本版按用户确认不再迁移以前的知识库数据。旧文件留在原位置，但新版不会读取它们；没有对用户代码仓库或旧知识目录执行删除。
+
+## 更新
+
+```bash
+project-knowledge stop
+npm install -g @sanqianx/project-knowledge@latest --registry=https://registry.npmjs.org/
+project-knowledge-integrations update
+project-knowledge
+```
+
+需要 Node ≥22 和 Git。默认使用 `~/.project-knowledge-v5`，四模块的托管数据也在此目录内。若环境变量 `KB_DATA_DIR` 仍指向旧目录，请取消该设置或改为新的空目录。不要把旧 `projects.json`、设置或引擎状态复制进新目录。
+
+5.0.6 修复首次启动被未登记的旧工作台会话误拦截：仅有日志、默认提示词及孤立会话的目录可以创建空的新登记，孤立会话保留原字节但不会恢复或触发任务。实际旧项目、设置、引擎状态或维护任务仍拒绝迁移，错误列出具体目录和冲突项。后台启动命令等待 HTTP 就绪后才报成功；启动失败直接在终端显示原因并返回非零退出码，不提前打开浏览器。
+
+在“系统状态”重新配置模型与后台默认模型、embedding 和知识根目录，然后在“领域与项目”导入代码目录及新的空知识目录。原代码目录无需移动。若残留旧知识库托管 Hook，导入预检会要求明确确认替换；不会覆盖第三方 Hook。导入建立 HEAD 基线，不分析已有历史。
+
+如果模块是自己独立启动的旧进程，请在它原来的终端中停止后重启新版外壳。外壳不会擅自杀死其他服务；版本或运行期鉴权不一致时显示具体连接阶段，不接管旧服务数据。
+
+5.0.1 修复旧版 Git 的项目导入失败（日志中的路径包含
+`--path-format=absolute` 和换行）。升级 5.0.0 → 5.0.1 不需要清空新版数据或
+重新配置模型。失败项目可以直接重试导入；原代码、第三方 Hook 与旧知识文件不删除。
+导入失败会在弹窗保留错误码和操作 ID，系统诊断默认查询“系统与所有项目”，
+可按操作 ID 查找导入事务的真实失败阶段和原始错误。
+
+## 解绑与恢复
+
+5.0.7 的命令不区分大小写，`STOP` 与 `stop` 相同。未知命令不会误启动。
+`status` 和 `stop` 默认只控制当前数据目录；`status --all` 查看可控制的本机实例，
+`stop --port 5804` 指定停止目标，`--data "D:/data/knowledge"` 明确选择数据目录。
+停止通过本机控制通道等待外壳及其托管模块退出，不再使用共享临时 PID 或盲杀。
+未验证或正在启动的实例不会误报已停止，独立启动的模块也不会被结束。
+
+“解绑并保留数据”从项目列表移除登记、取消未开始任务并卸下本项目托管 Hook，保留代码、知识、会话及证据。实际分析或索引写入尚未结束时仍禁止解绑，防止丢失写入状态。队列本身不再被当成正在运行。
+
+删除的是旧版本兼容路径，不是新版的故障恢复能力：v5 自身的重启恢复、提交去重、并发限制、失败重试和索引修复仍有效。`upgrade-recovery` 不再存在。
+
+## 回归范围
+
+旧格式迁移专用测试随旧实现删除，替换为旧目录拒绝且原字节不变、空状态启动、连接失败诊断与恢复、旧托管 Hook 的显式替换和回滚测试。真实提交链路继续由引擎 Git/Hook/journal/晋升/索引回归和五服务网页回归覆盖。模型替身和真实模型的结果分开记录；旧版本真实调用记录不计为本版通过。