@geminilight/mindos 0.5.5 → 0.5.7

package/README.md

@@ -14,11 +14,12 @@
 
 <p align="center">
   <a href="https://tianfuwang.tech/MindOS"><img src="https://img.shields.io/badge/Website-MindOS-0ea5e9.svg?style=for-the-badge" alt="Website"></a>
-  <a href="https://deepwiki.com/GeminiLight/MindOS"><img src="https://img.shields.io/badge/DeepWiki-MindOS-blue.svg?style=for-the-badge" alt="DeepWiki"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
+  <a href="https://www.npmjs.com/package/@geminilight/mindos"><img src="https://img.shields.io/npm/v/@geminilight/mindos.svg?style=for-the-badge&color=f59e0b" alt="npm version"></a>
+  <a href="#wechat"><img src="https://img.shields.io/badge/WeChat-Group-07C160.svg?style=for-the-badge&logo=wechat&logoColor=white" alt="WeChat"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-6366f1.svg?style=for-the-badge" alt="MIT License"></a>
 </p>
 
-MindOS is a **Human-AI Collaborative Mind System**—a local-first knowledge base that ensures your notes, workflows, and personal context are both human-readable and directly executable by AI Agents. **Globally sync your mind for all agents: transparent, controllable, and evolving symbiotically.**
+MindOS is a **Human-AI Collaborative Mind System**—a local-first knowledge base that ensures your notes, workflows, and personal context are both human-readable and directly executable by Agents. **One shared memory layer for all Agents — auditable, correctable, and smarter with every use.**
 
 ---
 
@@ -49,7 +50,7 @@ MindOS is a **Human-AI Collaborative Mind System**—a local-first knowledge bas
 
 ## 🧠 Core Value: Human-AI Shared Mind
 
-**1. Global Sync — Break Mind Silos**
+**1. Global Sync — Break Memory Silos**
 
 Traditional notes are scattered across tools and APIs, so agents miss your real context when it matters. MindOS turns your local knowledge into one MCP-ready source, so every agent can sync your Profile, SOPs, and live working memory.
 
@@ -57,9 +58,9 @@ Traditional notes are scattered across tools and APIs, so agents miss your real
 
 Most assistant memory lives in black boxes, leaving humans unable to inspect or correct how decisions are made. MindOS writes retrieval and execution traces into local plain text, so you can audit, intervene, and improve continuously.
 
-**3. Symbiotic Evolution — Dynamic Instruction Flow**
+**3. Symbiotic Evolution — Experience Flows Back as Instructions**
 
-Static documents are hard to synchronize and weak as execution systems in real human-agent collaboration. MindOS makes notes prompt-native and reference-linked, so daily writing naturally becomes executable workflows that evolve with you.
+Static documents are hard to synchronize and weak as execution systems in real human-agent collaboration. MindOS makes notes agent-ready and reference-linked, so daily writing naturally becomes executable workflows that evolve with you.
 
 > **Foundation:** Local-first by default - all data stays in local plain text for privacy, ownership, and speed.
 
@@ -374,10 +375,10 @@ graph LR
 
 **Who is this for?**
 
-- **AI Independent Developer** — Store personal SOPs, tech stack preferences, and project context in MindOS. Any Agent instantly inherits your work habits.
+- **Independent Developer** — Store personal SOPs, tech stack preferences, and project context in MindOS. Any Agent instantly inherits your work habits.
 - **Knowledge Worker** — Manage research materials with bi-directional links. Your AI assistant answers questions grounded in your full context, not generic knowledge.
 - **Team Collaboration** — Share a MindOS knowledge base across team members as a single source of truth. Humans and Agents read from the same playbook, keeping everyone aligned.
-- **Automated Agent Operations** — Write standard workflows as Prompt-Driven documents. Agents execute directly, humans audit the results.
+- **Automated Agent Operations** — Write standard workflows as Agent-Ready documents. Agents execute directly, humans audit the results.
 
 ---
 
@@ -470,6 +471,18 @@ MindOS/
 
 ---
 
+## 💬 Community <a name="wechat"></a>
+
+Join our WeChat group for early access, feedback, and AI workflow discussions:
+
+<p align="center">
+  <img src="assets/images/wechat-qr.png" alt="WeChat Group QR Code" width="200" />
+</p>
+
+> Scan the QR code or ask an existing member to invite you.
+
+---
+
 ## 📄 License
 
 MIT © GeminiLight

package/README_zh.md

@@ -14,11 +14,12 @@
 
 <p align="center">
   <a href="https://tianfuwang.tech/MindOS"><img src="https://img.shields.io/badge/Website-MindOS-0ea5e9.svg?style=for-the-badge" alt="Website"></a>
-  <a href="https://deepwiki.com/GeminiLight/MindOS"><img src="https://img.shields.io/badge/DeepWiki-MindOS-blue.svg?style=for-the-badge" alt="DeepWiki"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
+  <a href="https://www.npmjs.com/package/@geminilight/mindos"><img src="https://img.shields.io/npm/v/@geminilight/mindos.svg?style=for-the-badge&color=f59e0b" alt="npm version"></a>
+  <a href="#wechat"><img src="https://img.shields.io/badge/WeChat-群聊-07C160.svg?style=for-the-badge&logo=wechat&logoColor=white" alt="WeChat"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-6366f1.svg?style=for-the-badge" alt="MIT License"></a>
 </p>
 
-MindOS 是一个**人机协同心智系统**——基于本地优先的协作知识库，让你的笔记、工作流、个人上下文既对人类阅读友好，也能直接被 AI Agent 调用和执行。**为所有 Agents 全局同步你的心智，透明可控，共生演进。**
+MindOS 是一个**人机协同心智系统**——基于本地优先的协作知识库，让你的笔记、工作流、个人上下文既对人类阅读友好，也能直接被 Agent 调用和执行。**让所有 Agent 共享一个记忆层——可审计、可修正、越用越聪明。**
 
 ---
 
@@ -49,7 +50,7 @@ MindOS 是一个**人机协同心智系统**——基于本地优先的协作知
 
 ## 🧠 核心价值：人机共享心智
 
-**1. 全局同步 — 打破心智孤岛**
+**1. 全局同步 — 打破记忆割裂**
 
 传统笔记分散在不同工具和接口中，Agent 在关键时刻拿不到你的真实上下文。MindOS 把本地知识统一为 MCP 可读的单一来源，让所有 Agent 同步你的 Profile、SOP 与实时记忆。
 
@@ -57,9 +58,9 @@ MindOS 是一个**人机协同心智系统**——基于本地优先的协作知
 
 多数助手记忆封闭在黑箱里，人类难以审查和纠正决策过程。MindOS 将检索与执行轨迹沉淀为本地纯文本，让你可以持续审计、干预与优化。
 
-**3. 共生演进 — 动态指令流转**
+**3. 共生演进 — 经验回流为指令**
 
-静态文档难同步，也难在真实人机协作中承担执行系统角色。MindOS 以 Prompt-Native 与引用链接组织知识，让日常记录自然变成可执行工作流并持续进化。
+静态文档难同步，也难在真实人机协作中承担执行系统角色。MindOS 让笔记天然成为 Agent 可执行的指令，通过引用链接组织知识，日常记录自然变成可执行工作流并持续进化。
 
 > **底层原则：** 默认本地优先，全部数据以本地纯文本保存，兼顾隐私、主权与性能。
 
@@ -379,7 +380,7 @@ graph LR
 - **AI 独立开发者** — 将个人 SOP、技术栈偏好、项目上下文存入 MindOS，任何 Agent 即插即用你的工作习惯。
 - **知识工作者** — 用双链笔记管理研究资料，AI 助手基于你的完整上下文回答问题，而非泛泛而谈。
 - **团队协作** — 团队成员共享同一个 MindOS 知识库作为 Single Source of Truth，人与 Agent 读同一份剧本，保持对齐。
-- **Agent 自动运维** — 将标准流程写成 Prompt-Driven 文档，Agent 直接执行，人类审计结果。
+- **Agent 自动运维** — 将标准流程写成笔记即指令的文档，Agent 直接执行，人类审计结果。
 
 ---
 
@@ -473,6 +474,18 @@ MindOS/
 
 ---
 
+## 💬 社区 <a name="wechat"></a>
+
+加入微信内测群，抢先体验、反馈建议、交流 AI 工作流：
+
+<p align="center">
+  <img src="assets/images/wechat-qr.png" alt="微信群二维码" width="200" />
+</p>
+
+> 扫码加入，或请群内成员邀请你。
+
+---
+
 ## 📄 License
 
 MIT © GeminiLight

package/app/app/api/mcp/agents/route.ts

@@ -1,14 +1,16 @@
 export const dynamic = 'force-dynamic';
 import { NextResponse } from 'next/server';
-import { MCP_AGENTS, detectInstalled } from '@/lib/mcp-agents';
+import { MCP_AGENTS, detectInstalled, detectAgentPresence } from '@/lib/mcp-agents';
 
 export async function GET() {
   try {
     const agents = Object.entries(MCP_AGENTS).map(([key, agent]) => {
       const status = detectInstalled(key);
+      const present = detectAgentPresence(key);
       return {
         key,
         name: agent.name,
+        present,
         installed: status.installed,
         scope: status.scope,
         transport: status.transport,

package/app/app/api/mcp/install-skill/route.ts

@@ -2,8 +2,11 @@ export const dynamic = 'force-dynamic';
 import { NextRequest, NextResponse } from 'next/server';
 import { execSync } from 'child_process';
 import path from 'path';
+import fs from 'fs';
 
-/* ── Agent classification ──────────────────────────────────────── */
+/* ── Constants ────────────────────────────────────────────────── */
+
+const GITHUB_SOURCE = 'GeminiLight/MindOS';
 
 // Universal agents read directly from ~/.agents/skills/ — no symlink needed.
 const UNIVERSAL_AGENTS = new Set([
@@ -15,7 +18,6 @@ const UNIVERSAL_AGENTS = new Set([
 const SKILL_UNSUPPORTED = new Set(['claude-desktop']);
 
 // MCP agent key → npx skills agent name (for non-universal agents)
-// Keys not listed here and not in UNIVERSAL/UNSUPPORTED will use the key as-is.
 const AGENT_NAME_MAP: Record<string, string> = {
   'claude-code': 'claude-code',
   'windsurf': 'windsurf',
@@ -24,7 +26,35 @@ const AGENT_NAME_MAP: Record<string, string> = {
   'codebuddy': 'codebuddy',
 };
 
-/* ── POST handler ──────────────────────────────────────────────── */
+/* ── Helpers ──────────────────────────────────────────────────── */
+
+/** Fallback: find local skills directory for offline installs */
+function findLocalSkillsDir(): string | null {
+  const candidates = [
+    path.resolve(process.cwd(), 'data/skills'),   // app/data/skills/
+    path.resolve(process.cwd(), '..', 'skills'),   // project-root/skills/
+  ];
+  for (const dir of candidates) {
+    if (fs.existsSync(dir)) return dir;
+  }
+  return null;
+}
+
+function buildCommand(
+  source: string,
+  skill: string,
+  additionalAgents: string[],
+): string {
+  // Each agent needs its own -a flag (skills CLI does NOT accept comma-separated)
+  const agentFlags = additionalAgents.length > 0
+    ? additionalAgents.map(a => `-a ${a}`).join(' ')
+    : '-a universal';
+  // Quote source if it looks like a local path (contains / or \)
+  const quotedSource = /[/\\]/.test(source) ? `"${source}"` : source;
+  return `npx skills add ${quotedSource} --skill ${skill} ${agentFlags} -g -y`;
+}
+
+/* ── POST handler ─────────────────────────────────────────────── */
 
 interface SkillInstallRequest {
   skill: 'mindos' | 'mindos-zh';
@@ -40,52 +70,53 @@ export async function POST(req: NextRequest) {
       return NextResponse.json({ error: 'Invalid skill name' }, { status: 400 });
     }
 
-    // Source path: project root `skills/` directory
-    const source = path.resolve(process.cwd(), 'skills');
-
-    // Non-universal, skill-capable agents need explicit `-a` for symlink creation
     const additionalAgents = (agents || [])
       .filter(key => !UNIVERSAL_AGENTS.has(key) && !SKILL_UNSUPPORTED.has(key))
       .map(key => AGENT_NAME_MAP[key] || key);
 
-    let cmd: string;
-    if (additionalAgents.length > 0) {
-      // Any -a command will also copy to ~/.agents/skills/ (Universal coverage)
-      cmd = `npx skills add "${source}" -s ${skill} -a ${additionalAgents.join(',')} -g -y`;
-    } else {
-      // Fallback: only install to ~/.agents/skills/ for Universal agents
-      cmd = `npx skills add "${source}" -s ${skill} -a universal -g -y`;
-    }
+    // Try GitHub source first, fall back to local path
+    const sources = [GITHUB_SOURCE];
+    const localDir = findLocalSkillsDir();
+    if (localDir) sources.push(localDir);
+
+    let lastCmd = '';
+    let lastStdout = '';
+    let lastStderr = '';
 
-    let stdout = '';
-    let stderr = '';
-    try {
-      stdout = execSync(cmd, {
-        encoding: 'utf-8',
-        timeout: 30_000,
-        env: { ...process.env, NODE_ENV: 'production' },
-        stdio: 'pipe',
-      });
-    } catch (err: unknown) {
-      const e = err as { stdout?: string; stderr?: string; message?: string };
-      stdout = e.stdout || '';
-      stderr = e.stderr || e.message || 'Unknown error';
-      return NextResponse.json({
-        ok: false,
-        skill,
-        agents: additionalAgents,
-        cmd,
-        stdout,
-        stderr,
-      });
+    for (const source of sources) {
+      const cmd = buildCommand(source, skill, additionalAgents);
+      lastCmd = cmd;
+      try {
+        lastStdout = execSync(cmd, {
+          encoding: 'utf-8',
+          timeout: 30_000,
+          env: { ...process.env, NODE_ENV: 'production' },
+          stdio: 'pipe',
+        });
+        // Success — return immediately
+        return NextResponse.json({
+          ok: true,
+          skill,
+          agents: additionalAgents,
+          cmd,
+          stdout: lastStdout.trim(),
+        });
+      } catch (err: unknown) {
+        const e = err as { stdout?: string; stderr?: string; message?: string };
+        lastStdout = e.stdout || '';
+        lastStderr = e.stderr || e.message || 'Unknown error';
+        // Try next source
+      }
     }
 
+    // All sources failed
     return NextResponse.json({
-      ok: true,
+      ok: false,
       skill,
       agents: additionalAgents,
-      cmd,
-      stdout: stdout.trim(),
+      cmd: lastCmd,
+      stdout: lastStdout,
+      stderr: lastStderr,
     });
   } catch (e) {
     return NextResponse.json(

package/app/app/api/restart/route.ts

@@ -7,14 +7,38 @@ export async function POST() {
   try {
     // process.cwd() is the Next.js app directory; cli.js is one level up at project root/bin/
     const cliPath = resolve(process.cwd(), '../bin/cli.js');
-    const child = spawn(process.execPath, [cliPath, 'start'], {
+    // Use 'restart' (stop all → wait for ports free → start) instead of bare
+    // 'start' which would fail assertPortFree because the current process and
+    // its MCP child are still holding the ports.
+    //
+    // IMPORTANT: Strip MINDOS_* env vars so the child's loadConfig() reads
+    // the *updated* config file instead of inheriting stale values from this
+    // process.  Without this, changing ports in the GUI has no effect on the
+    // restarted server — it would start on the old ports.
+    //
+    // Pass the current (old) ports via MINDOS_OLD_* so the restart command
+    // can clean up processes still listening on the previous ports.
+    const childEnv = { ...process.env };
+    const oldWebPort = childEnv.MINDOS_WEB_PORT;
+    const oldMcpPort = childEnv.MINDOS_MCP_PORT;
+    delete childEnv.MINDOS_WEB_PORT;
+    delete childEnv.MINDOS_MCP_PORT;
+    delete childEnv.MIND_ROOT;
+    delete childEnv.AUTH_TOKEN;
+    delete childEnv.WEB_PASSWORD;
+    if (oldWebPort) childEnv.MINDOS_OLD_WEB_PORT = oldWebPort;
+    if (oldMcpPort) childEnv.MINDOS_OLD_MCP_PORT = oldMcpPort;
+    const child = spawn(process.execPath, [cliPath, 'restart'], {
       detached: true,
       stdio: 'ignore',
-      env: process.env,
+      env: childEnv,
     });
     child.unref();
-    // Give a brief moment for the response to be sent before exiting
-    setTimeout(() => process.exit(0), 500);
+    // Give a brief moment for the response to be sent before exiting.
+    // The spawned 'restart' command will handle stopping this process via
+    // stopMindos() (kill by PID + port cleanup), so process.exit here is
+    // just a safety net in case the parent isn't killed cleanly.
+    setTimeout(() => process.exit(0), 1500);
     return NextResponse.json({ ok: true });
   } catch (err) {
     return NextResponse.json({ error: String(err) }, { status: 500 });

package/app/app/view/[...path]/ViewPageClient.tsx

@@ -13,7 +13,7 @@ import Breadcrumb from '@/components/Breadcrumb';
 import MarkdownEditor, { MdViewMode } from '@/components/MarkdownEditor';
 import TableOfContents from '@/components/TableOfContents';
 import FindInPage from '@/components/FindInPage';
-import { resolveRenderer } from '@/lib/renderers/registry';
+import { resolveRenderer, isRendererEnabled } from '@/lib/renderers/registry';
 import { encodePath } from '@/lib/utils';
 import '@/lib/renderers/index'; // registers all renderers
 
@@ -47,6 +47,8 @@ export default function ViewPageClient({
   );
 
   const [useRaw, setUseRaw] = useRendererState<boolean>('_raw', filePath, false);
+  // Global graph mode — shared across all md files (not per-file)
+  const [graphMode, setGraphMode] = useRendererState<boolean>('_graphMode', '_global', false);
   const router = useRouter();
   const [editing, setEditing] = useState(initialEditing || content === '');
   const [editContent, setEditContent] = useState(content);
@@ -70,9 +72,21 @@ export default function ViewPageClient({
     setUseRaw(prev => !prev);
   }, [setUseRaw]);
 
-  const renderer = resolveRenderer(filePath, extension);
+  const handleToggleGraph = useCallback(() => {
+    setGraphMode(prev => !prev);
+  }, [setGraphMode]);
+
+  const effectiveGraphMode = hydrated ? graphMode : false;
+
+  // Resolve renderer: for md files, graph mode overrides normal resolution
+  const registryRenderer = resolveRenderer(filePath, extension);
+  const graphRenderer = extension === 'md' && effectiveGraphMode
+    ? resolveRenderer(filePath, extension, 'graph')
+    : undefined;
+  const renderer = graphRenderer || registryRenderer;
   const isCsv = extension === 'csv';
-  const showRenderer = !editing && !effectiveUseRaw && !!renderer;
+  // Graph mode overrides Raw — when graph is active, always show the renderer
+  const showRenderer = !editing && !!renderer && (!effectiveUseRaw || !!graphRenderer);
 
   // Lazily resolve the renderer component for code-splitting
   const LazyComponent = useMemo(() => {
@@ -208,8 +222,24 @@ export default function ViewPageClient({
               <span className="text-xs text-red-400 hidden sm:inline">{saveError}</span>
             )}
 
-            {/* Renderer toggle — only shown when a custom renderer exists */}
-            {renderer && !editing && !isDraft && (
+            {/* Graph toggle — only for md files, hidden when graph plugin is disabled */}
+            {extension === 'md' && !editing && !isDraft && isRendererEnabled('graph') && (
+              <button
+                onClick={handleToggleGraph}
+                className="flex items-center gap-1.5 px-3 py-1.5 rounded-md text-xs font-medium transition-colors font-display"
+                style={{
+                  background: effectiveGraphMode ? `${'var(--amber)'}22` : 'var(--muted)',
+                  color: effectiveGraphMode ? 'var(--amber)' : 'var(--muted-foreground)',
+                }}
+                title={effectiveGraphMode ? 'Switch to document view' : 'Switch to Wiki Graph'}
+              >
+                <span>🕸️</span>
+                <span className="hidden sm:inline">Graph</span>
+              </button>
+            )}
+
+            {/* Renderer toggle — only shown when a custom renderer exists (excludes graph-mode override) */}
+            {registryRenderer && !editing && !isDraft && !graphRenderer && (
               <button
                 onClick={handleToggleRaw}
                 className="flex items-center gap-1.5 px-3 py-1.5 rounded-md text-xs font-medium transition-colors font-display"
@@ -217,10 +247,10 @@ export default function ViewPageClient({
                   background: effectiveUseRaw ? 'var(--muted)' : `${'var(--amber)'}22`,
                   color: effectiveUseRaw ? 'var(--muted-foreground)' : 'var(--amber)',
                 }}
-                title={effectiveUseRaw ? `Switch to ${renderer.name}` : 'View raw'}
+                title={effectiveUseRaw ? `Switch to ${registryRenderer?.name}` : 'View raw'}
               >
                 <LayoutTemplate size={13} />
-                <span className="hidden sm:inline">{effectiveUseRaw ? renderer.name : 'Raw'}</span>
+                <span className="hidden sm:inline">{effectiveUseRaw ? registryRenderer.name : 'Raw'}</span>
               </button>
             )}
 

package/app/components/HomeContent.tsx

@@ -62,7 +62,9 @@ export default function HomeContent({ recent, existingFiles }: { recent: RecentF
 
   const formatTime = (mtime: number) => relativeTime(mtime, t.home.relativeTime);
 
-  const renderers = getAllRenderers();
+  // Only show renderers with an entryPath on the home page grid.
+  // Opt-in renderers (like Graph) have no entryPath and are toggled from the view toolbar.
+  const renderers = getAllRenderers().filter(r => r.entryPath);
 
   const lastFile = recent[0];
 

package/app/components/SetupWizard.tsx

@@ -36,6 +36,7 @@ interface PortStatus {
 interface AgentEntry {
   key: string;
   name: string;
+  present: boolean;
   installed: boolean;
   hasProjectScope: boolean;
   hasGlobalScope: boolean;
@@ -511,7 +512,7 @@ function Step5({
     return agentTransport;
   };
 
-  const getStatusBadge = (key: string, installed: boolean) => {
+  const getStatusBadge = (key: string, agent: AgentEntry) => {
     const st = agentStatuses[key];
     if (st) {
       if (st.state === 'installing') return (
@@ -533,16 +534,22 @@ function Step5({
         </span>
       );
     }
-    if (installed) return (
+    if (agent.installed) return (
       <span className="text-[11px] px-1.5 py-0.5 rounded"
         style={{ background: 'rgba(34,197,94,0.12)', color: '#22c55e' }}>
         {settingsMcp.installed}
       </span>
     );
+    if (agent.present) return (
+      <span className="text-[11px] px-1.5 py-0.5 rounded"
+        style={{ background: 'rgba(245,158,11,0.12)', color: '#f59e0b' }}>
+        {s.agentDetected ?? 'detected'}
+      </span>
+    );
     return (
       <span className="text-[11px] px-1.5 py-0.5 rounded"
         style={{ background: 'rgba(100,100,120,0.1)', color: 'var(--muted-foreground)' }}>
-        {s.agentNotInstalled}
+        {s.agentNotFound ?? s.agentNotInstalled}
       </span>
     );
   };
@@ -581,7 +588,7 @@ function Step5({
                   style={{ background: 'rgba(100,100,120,0.08)', color: 'var(--muted-foreground)' }}>
                   {getEffectiveTransport(agent)}
                 </span>
-                {getStatusBadge(agent.key, agent.installed)}
+                {getStatusBadge(agent.key, agent)}
               </label>
             ))}
           </div>
@@ -936,7 +943,7 @@ export default function SetupWizard() {
           if (data.agents) {
             setAgents(data.agents);
             setSelectedAgents(new Set(
-              (data.agents as AgentEntry[]).filter(a => a.installed).map(a => a.key)
+              (data.agents as AgentEntry[]).filter(a => a.installed || a.present).map(a => a.key)
             ));
           }
         })

package/app/components/renderers/graph/manifest.ts

@@ -8,7 +8,8 @@ export const manifest: RendererDefinition = {
   icon: '🕸️',
   tags: ['graph', 'wiki', 'links', 'visualization'],
   builtin: true,
-  entryPath: 'README.md',
-  match: ({ extension }) => extension === 'md',
+  // No entryPath — Graph is a global toggle, not bound to a specific file.
+  // Graph is opt-in via a global toggle; never auto-match in the registry.
+  match: () => false,
   load: () => import('./GraphRenderer').then(m => ({ default: m.GraphRenderer })),
 };

package/app/components/settings/McpTab.tsx

@@ -22,6 +22,7 @@ interface McpStatus {
 interface AgentInfo {
   key: string;
   name: string;
+  present: boolean;
   installed: boolean;
   scope?: string;
   transport?: string;
@@ -231,7 +232,9 @@ function AgentInstall({ agents, t, onRefresh }: { agents: AgentInfo[]; t: any; o
                 <span className="text-[10px] text-muted-foreground">{agent.scope}</span>
               </>
             ) : (
-              <span className="text-[10px] text-muted-foreground">{m?.notInstalled ?? 'Not installed'}</span>
+              <span className="text-[10px] text-muted-foreground">
+                {agent.present ? (m?.detected ?? 'Detected') : (m?.notFound ?? 'Not found')}
+              </span>
             )}
             {/* Scope selector */}
             {selected.has(agent.key) && agent.hasProjectScope && agent.hasGlobalScope && (

package/app/lib/i18n.ts

@@ -197,6 +197,8 @@ export const messages = {
         global: 'Global',
         installed: 'Installed',
         notInstalled: 'Not installed',
+        detected: 'Detected',
+        notFound: 'Not found',
         transportStdio: 'stdio (recommended)',
         transportHttp: 'http',
         transportAuto: 'auto (recommended)',
@@ -325,6 +327,8 @@ export const messages = {
       agentNoneSelected: 'No agents selected — you can configure later in Settings → MCP.',
       agentSkipLater: 'Skip — configure later',
       agentNotInstalled: 'not installed',
+      agentDetected: 'detected',
+      agentNotFound: 'not found',
       agentStatusOk: 'configured',
       agentStatusError: 'failed',
       agentInstalling: 'Configuring…',
@@ -566,6 +570,8 @@ export const messages = {
         global: '全局',
         installed: '已安装',
         notInstalled: '未安装',
+        detected: '已检测',
+        notFound: '未找到',
         transportStdio: 'stdio（推荐）',
         transportHttp: 'http',
         transportAuto: '自动（推荐）',
@@ -694,6 +700,8 @@ export const messages = {
       agentNoneSelected: '未选择 agent — 可稍后在 设置 → MCP 中配置。',
       agentSkipLater: '跳过 — 稍后配置',
       agentNotInstalled: '未安装',
+      agentDetected: '已检测到',
+      agentNotFound: '未找到',
       agentStatusOk: '已配置',
       agentStatusError: '失败',
       agentInstalling: '配置中…',