@geminilight/mindos 0.5.7 → 0.5.9

package/README.md

@@ -48,42 +48,43 @@ MindOS is a **Human-AI Collaborative Mind System**—a local-first knowledge bas
 > Help me execute the XXX SOP from MindOS.
 > ```
 
-## 🧠 Core Value: Human-AI Shared Mind
+## 🧠 Human-AI Shared Mind
 
-**1. Global Sync — Break Memory Silos**
+> No more fragmented memory, no more black-box behavior, no more lost experience.
 
-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.
+**1. Global Sync — Breaking Memory Silos**
 
-**2. Transparent and Controllable — Eliminate Memory Black Boxes**
+Each Agent keeps its own memory — switching tools means manually hauling context. **MindOS lets all Agents share one knowledge base via MCP and Skills — record once, reuse everywhere.**
 
-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.
+**2. Transparent & Controllable — No More Black Boxes**
+
+What did your Agent remember? Is it even correct? You have no way to know. **MindOS saves every read/write as local plain text — humans can audit, correct, and delete in the GUI.**
 
 **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 agent-ready and reference-linked, so daily writing naturally becomes executable workflows that evolve with you.
+All that experience from your conversations — gone the moment you close the window. **MindOS auto-distills conversation experience into Skills/SOPs. Notes are instructions. The knowledge base gets better with use.**
 
-> **Foundation:** Local-first by default - all data stays in local plain text for privacy, ownership, and speed.
+> **Foundation:** Local-first by default — all data stays in local plain text for privacy, ownership, and speed.
 
 ## ✨ Features
 
 **For Humans**
 
-- **GUI Collaboration Workbench**: use one command entry to browse, edit, and search efficiently (`⌘K` / `⌘/`).
-- **Built-in Agent Assistant**: converse in context while edits are captured into managed knowledge.
-- **Plugin Views**: use scenario-focused views like TODO, Kanban, and Timeline.
+- **GUI Workbench**: browse, edit, search notes with unified search + AI entry (`⌘K` / `⌘/`), designed for human-AI co-creation.
+- **Built-in Agent Assistant**: converse with the knowledge base in context; edits seamlessly capture human-curated knowledge.
+- **Plugin Extensions**: multiple built-in renderer plugins — TODO Board, CSV Views, Wiki Graph, Timeline, Agent Inspector, and more.
 
 **For Agents**
 
-- **MCP Server + Skills**: connect any compatible agent to read, write, search, and run workflows.
-- **Structured Templates**: start quickly with Profile, Workflows, and Configurations scaffolds.
-- **Experience Auto-Distillation**: automatically distill daily work into reusable, executable SOP experience.
+- **MCP Server + Skills**: stdio + HTTP dual transport, full-lineup Agent compatible (OpenClaw, Claude Code, Cursor, etc.). Zero-config access.
+- **Structured Templates**: pre-set directory structures for Profiles, Workflows, Configurations, etc., to jumpstart personal context.
+- **Agent-Ready Docs**: everyday notes naturally double as high-quality executable Agent commands — no format conversion needed, write and dispatch.
 
 **Infrastructure**
 
-- **Reference Sync**: keep cross-file status and context aligned via links/backlinks.
-- **Knowledge Graph**: visualize relationships and dependencies across notes.
-- **Git Time Machine**: track every edit, audit history, and roll back safely.
-- **Cross-Device Sync**: auto-commit, push, and pull via Git — edits on one device appear on all others within minutes.
+- **Security**: Bearer Token auth, path sandboxing, INSTRUCTION.md write-protection, atomic writes.
+- **Knowledge Graph**: dynamically parses and visualizes inter-file references and dependencies.
+- **Git Time Machine**: Git auto-sync (commit/push/pull), records every edit by both humans and Agents. One-click rollback, cross-device sync.
 
 <details>
 <summary><strong>Coming Soon</strong></summary>

package/README_zh.md

@@ -48,19 +48,21 @@ MindOS 是一个**人机协同心智系统**——基于本地优先的协作知
 > 帮我执行 MindOS 里的 XXX 工作流。
 > ```
 
-## 🧠 核心价值：人机共享心智
+## 🧠 人机共享心智
+
+> 记忆不再割裂，行为不再黑箱，经验不再断流。
 
 **1. 全局同步 — 打破记忆割裂**
 
-传统笔记分散在不同工具和接口中，Agent 在关键时刻拿不到你的真实上下文。MindOS 把本地知识统一为 MCP 可读的单一来源，让所有 Agent 同步你的 Profile、SOP 与实时记忆。
+多个 Agent 各记各的，切换工具靠人工搬运上下文。**MindOS 通过 MCP 和 Skill 让所有 Agent 共享同一份知识库——一处记录，全局复用。**
 
 **2. 透明可控 — 消除记忆黑箱**
 
-多数助手记忆封闭在黑箱里，人类难以审查和纠正决策过程。MindOS 将检索与执行轨迹沉淀为本地纯文本，让你可以持续审计、干预与优化。
+Agent 记了什么、记对没有，用户无从知晓。**MindOS 将每次读写沉淀为本地纯文本，人类可在 GUI 中审查、修正、删除。**
 
 **3. 共生演进 — 经验回流为指令**
 
-静态文档难同步，也难在真实人机协作中承担执行系统角色。MindOS 让笔记天然成为 Agent 可执行的指令，通过引用链接组织知识，日常记录自然变成可执行工作流并持续进化。
+对话里攒下的经验，关掉窗口就散了。**MindOS 自动将对话经验沉淀为 Skill/SOP，笔记即指令，知识库越用越好。**
 
 > **底层原则：** 默认本地优先，全部数据以本地纯文本保存，兼顾隐私、主权与性能。
 
@@ -68,22 +70,21 @@ MindOS 是一个**人机协同心智系统**——基于本地优先的协作知
 
 **人类侧**
 
-- **GUI 协作工作台**：以统一入口高效浏览、编辑与搜索（`⌘K` / `⌘/`）。
-- **内置 Agent 助手**：在上下文中对话，编辑内容可持续沉淀为可管理知识。
-- **插件视图**：按场景使用 TODO、看板、时间线等视图。
+- **GUI 工作台**：浏览、编辑、搜索笔记，统一搜索 + AI 入口（`⌘K` / `⌘/`），专为人机共创设计。
+- **内置 Agent 助手**：在上下文中与知识库对话，编辑无缝沉淀为可管理知识。
+- **插件扩展**：多种内置渲染器插件——TODO Board、CSV Views、Wiki Graph、Timeline、Agent Inspector 等。
 
 **Agent 侧**
 
-- **MCP Server + Skills**：让兼容 Agent 统一接入读写、搜索与工作流执行。
-- **结构化模板**：通过 Profile、Workflows、Configurations 快速冷启动。
-- **经验自动沉淀**：将日常记录自动化沉淀为可执行 SOP 经验。
+- **MCP Server + Skills**：stdio + HTTP 双传输，全阵容 Agent 兼容（OpenClaw, Claude Code, Cursor 等），零配置接入。
+- **结构化模板**：预置 Profile、Workflows、Configurations 等目录骨架，快速冷启动个人 Context。
+- **笔记即指令**：日常笔记天然就是 Agent 可直接执行的高质量指令——无需额外格式转换，写下即可调度。
 
 **基础设施**
 
-- **引用同步**：通过引用与反向链接保持跨文件状态一致。
-- **知识图谱**：可视化笔记间关系与依赖。
-- **Git 时光机**：记录修改历史，支持审计与安全回滚。
-- **跨设备同步**：通过 Git 自动 commit、push、pull —— 一台设备的编辑几分钟内同步到所有设备。
+- **安全防线**：Bearer Token 认证、路径沙箱、INSTRUCTION.md 写保护、原子写入。
+- **知识图谱**：动态解析并可视化文件间的引用与依赖关系。
+- **Git 时光机**：Git 自动同步（commit/push/pull），记录人类与 Agent 的每次编辑历史，一键回滚，跨设备同步。
 
 <details>
 <summary><strong>即将到来</strong></summary>

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

@@ -20,6 +20,13 @@ export async function GET() {
         preferredTransport: agent.preferredTransport,
       };
     });
+
+    // Sort: installed first, then detected, then not found
+    agents.sort((a, b) => {
+      const rank = (x: typeof a) => x.installed ? 0 : x.present ? 1 : 2;
+      return rank(a) - rank(b);
+    });
+
     return NextResponse.json({ agents });
   } catch (err) {
     return NextResponse.json({ error: String(err) }, { status: 500 });

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

@@ -15,7 +15,7 @@ const UNIVERSAL_AGENTS = new Set([
 ]);
 
 // Agents that do NOT support Skills at all
-const SKILL_UNSUPPORTED = new Set(['claude-desktop']);
+const SKILL_UNSUPPORTED = new Set<string>([]);
 
 // MCP agent key → npx skills agent name (for non-universal agents)
 const AGENT_NAME_MAP: Record<string, string> = {
@@ -24,6 +24,12 @@ const AGENT_NAME_MAP: Record<string, string> = {
   'trae': 'trae',
   'openclaw': 'openclaw',
   'codebuddy': 'codebuddy',
+  'iflow-cli': 'iflow-cli',
+  'pi': 'pi',
+  'augment': 'augment',
+  'qwen-code': 'qwen-code',
+  'trae-cn': 'trae-cn',
+  'roo': 'roo',
 };
 
 /* ── Helpers ──────────────────────────────────────────────────── */

package/app/app/api/setup/check-port/route.ts

@@ -27,29 +27,53 @@ async function isSelfPort(port: number): Promise<boolean> {
   }
 }
 
-async function findFreePort(start: number): Promise<number | null> {
+async function findFreePort(start: number, selfPorts: Set<number>): Promise<number | null> {
   for (let p = start; p <= 65535; p++) {
+    if (selfPorts.has(p)) continue;
     if (!await isPortInUse(p)) return p;
   }
   return null;
 }
 
+/**
+ * The port this MindOS web server is actually listening on.
+ * Derived from the incoming request URL — always reliable, no network round-trip.
+ *
+ * Note: We intentionally do NOT read settings here. Settings contain *configured*
+ * ports (webPort / mcpPort), which may not actually be listening yet (e.g. during
+ * first onboard, or if MCP server hasn't started). Treating configured-but-not-
+ * listening ports as "self" would mask real conflicts.
+ */
+function getListeningPort(req: NextRequest): number {
+  return parseInt(req.nextUrl.port || '0', 10);
+}
+
 export async function POST(req: NextRequest) {
   try {
     const { port } = await req.json() as { port: number };
     if (!port || port < 1024 || port > 65535) {
       return NextResponse.json({ error: 'Invalid port' }, { status: 400 });
     }
+
+    const myPort = getListeningPort(req);
+
+    // Fast path: if checking the port we're currently listening on, skip network round-trip
+    if (myPort > 0 && port === myPort) {
+      return NextResponse.json({ available: true, isSelf: true });
+    }
+
     const inUse = await isPortInUse(port);
     if (!inUse) {
       return NextResponse.json({ available: true, isSelf: false });
     }
-    // Port is occupied — check if it's this MindOS instance
+    // Port is occupied — check if it's another MindOS instance
     const self = await isSelfPort(port);
     if (self) {
       return NextResponse.json({ available: true, isSelf: true });
     }
-    const suggestion = await findFreePort(port + 1);
+    const skipPorts = new Set<number>();
+    if (myPort > 0) skipPorts.add(myPort);
+    const suggestion = await findFreePort(port + 1, skipPorts);
     return NextResponse.json({ available: false, isSelf: false, suggestion });
   } catch (err) {
     return NextResponse.json({ error: String(err) }, { status: 500 });

package/app/app/api/setup/route.ts

@@ -67,17 +67,10 @@ export async function POST(req: NextRequest) {
       return NextResponse.json({ error: `Invalid MCP port: ${mcpPortNum}` }, { status: 400 });
     }
 
-    // Apply template if mindRoot doesn't exist or is empty
+    // Apply template (copyRecursive has skip-existing protection)
     const dirExists = fs.existsSync(resolvedRoot);
-    let dirEmpty = true;
-    if (dirExists) {
-      try {
-        const entries = fs.readdirSync(resolvedRoot).filter(e => !e.startsWith('.'));
-        dirEmpty = entries.length === 0;
-      } catch { /* treat as empty */ }
-    }
 
-    if (template && (!dirExists || dirEmpty)) {
+    if (template) {
       applyTemplate(template, resolvedRoot);
     } else if (!dirExists) {
       fs.mkdirSync(resolvedRoot, { recursive: true });

package/app/app/globals.css

@@ -26,6 +26,8 @@
   --color-input: var(--input);
   --color-border: var(--border);
   --color-destructive: var(--destructive);
+  --color-success: var(--success);
+  --color-error: var(--error);
   --color-accent-foreground: var(--accent-foreground);
   --color-accent: var(--accent);
   --color-muted-foreground: var(--muted-foreground);
@@ -69,10 +71,12 @@ body {
   --destructive: oklch(0.58 0.22 27);
   --border: rgba(28, 26, 23, 0.1);
   --input: rgba(28, 26, 23, 0.12);
-  --ring: rgba(28, 26, 23, 0.3);
+  --ring: var(--amber);
   --radius: 0.5rem;
   --amber: #c8873a;
   --amber-dim: rgba(200, 135, 58, 0.12);
+  --success: #7aad80;
+  --error: #c85050;
   --sidebar: #ede9e1;
   --sidebar-foreground: #1c1a17;
   --sidebar-primary: #1c1a17;
@@ -101,9 +105,11 @@ body {
   --destructive: oklch(0.704 0.191 22.216);
   --border: rgba(232, 228, 220, 0.08);
   --input: rgba(232, 228, 220, 0.1);
-  --ring: rgba(232, 228, 220, 0.2);
+  --ring: var(--amber);
   --amber: #d4954a;
   --amber-dim: rgba(212, 149, 74, 0.12);
+  --success: #7aad80;
+  --error: #c85050;
   --sidebar: #1c1a17;
   --sidebar-foreground: #e8e4dc;
   --sidebar-primary: #d4954a;
@@ -290,6 +296,16 @@ body {
   button, a { -webkit-tap-highlight-color: transparent; }
 }
 
+/* Respect user's reduced-motion preference */
+@media (prefers-reduced-motion: reduce) {
+  *, *::before, *::after {
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.01ms !important;
+    scroll-behavior: auto !important;
+  }
+}
+
 /* Global focus-visible ring for interactive elements */
 button:focus-visible,
 a:focus-visible,

package/app/app/login/page.tsx

@@ -90,7 +90,7 @@ function LoginForm() {
               autoFocus
               autoComplete="current-password"
               required
-              className="w-full px-3 py-2 text-sm bg-background border border-border rounded-lg text-foreground placeholder:text-muted-foreground outline-none focus:ring-1 focus:ring-ring disabled:opacity-50"
+              className="w-full px-3 py-2 text-sm bg-background border border-border rounded-lg text-foreground placeholder:text-muted-foreground outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:opacity-50"
             />
           </div>
 

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

@@ -2,7 +2,7 @@
 
 import { useState, useTransition, useCallback, useEffect, useRef, useSyncExternalStore, useMemo, Suspense } from 'react';
 import { useRouter } from 'next/navigation';
-import { Edit3, Save, X, Loader2, LayoutTemplate, ArrowLeft } from 'lucide-react';
+import { Edit3, Save, X, Loader2, LayoutTemplate, ArrowLeft, Share2, FileText, Code } from 'lucide-react';
 import { lazy } from 'react';
 import MarkdownView from '@/components/MarkdownView';
 import JsonView from '@/components/JsonView';
@@ -213,13 +213,13 @@ export default function ViewPageClient({
 
           <div className="flex items-center gap-1.5 md:gap-2 shrink-0">
             {saveSuccess && (
-              <span className="text-xs flex items-center gap-1.5 font-display" style={{ color: '#7aad80' }}>
-                <span className="w-1.5 h-1.5 rounded-full" style={{ background: '#7aad80' }} />
+              <span className="text-xs flex items-center gap-1.5 font-display" style={{ color: 'var(--success)' }}>
+                <span className="w-1.5 h-1.5 rounded-full" style={{ background: 'var(--success)' }} />
                 <span className="hidden sm:inline">saved</span>
               </span>
             )}
             {saveError && (
-              <span className="text-xs text-red-400 hidden sm:inline">{saveError}</span>
+              <span className="text-xs text-error hidden sm:inline">{saveError}</span>
             )}
 
             {/* Graph toggle — only for md files, hidden when graph plugin is disabled */}
@@ -233,8 +233,8 @@ export default function ViewPageClient({
                 }}
                 title={effectiveGraphMode ? 'Switch to document view' : 'Switch to Wiki Graph'}
               >
-                <span>🕸️</span>
-                <span className="hidden sm:inline">Graph</span>
+                {effectiveGraphMode ? <FileText size={13} /> : <Share2 size={13} />}
+                <span className="hidden sm:inline">{effectiveGraphMode ? 'Doc' : 'Graph'}</span>
               </button>
             )}
 
@@ -244,12 +244,12 @@ export default function ViewPageClient({
                 onClick={handleToggleRaw}
                 className="flex items-center gap-1.5 px-3 py-1.5 rounded-md text-xs font-medium transition-colors font-display"
                 style={{
-                  background: effectiveUseRaw ? 'var(--muted)' : `${'var(--amber)'}22`,
-                  color: effectiveUseRaw ? 'var(--muted-foreground)' : 'var(--amber)',
+                  background: effectiveUseRaw ? `${'var(--amber)'}22` : 'var(--muted)',
+                  color: effectiveUseRaw ? 'var(--amber)' : 'var(--muted-foreground)',
                 }}
                 title={effectiveUseRaw ? `Switch to ${registryRenderer?.name}` : 'View raw'}
               >
-                <LayoutTemplate size={13} />
+                {effectiveUseRaw ? <LayoutTemplate size={13} /> : <Code size={13} />}
                 <span className="hidden sm:inline">{effectiveUseRaw ? registryRenderer.name : 'Raw'}</span>
               </button>
             )}

package/app/components/AskModal.tsx

@@ -310,7 +310,7 @@ export default function AskModal({ open, onClose, currentFile }: AskModalProps)
           )}
 
           {upload.uploadError && (
-            <div className="px-4 pb-1 text-xs text-red-400">{upload.uploadError}</div>
+            <div className="px-4 pb-1 text-xs text-error">{upload.uploadError}</div>
           )}
 
           {/* @-mention dropdown */}

package/app/components/FileTree.tsx

@@ -65,7 +65,7 @@ function NewFileInline({ dirPath, depth, onDone }: { dirPath: string; depth: num
           className="
             flex-1 bg-muted border border-border rounded px-2 py-1
             text-xs text-foreground placeholder:text-muted-foreground
-            focus:outline-none focus:border-blue-500/60
+            focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring
           "
         />
         {isPending
@@ -80,7 +80,7 @@ function NewFileInline({ dirPath, depth, onDone }: { dirPath: string; depth: num
           )
         }
       </div>
-      {error && <p className="text-xs text-red-400 mt-0.5 px-1">{error}</p>}
+      {error && <p className="text-xs text-error mt-0.5 px-1">{error}</p>}
     </div>
   );
 }
@@ -161,7 +161,7 @@ function DirectoryNode({ node, depth, currentPath, onNavigate }: {
             if (e.key === 'Escape') setRenaming(false);
           }}
           onBlur={commitRename}
-          className="w-full bg-muted border border-blue-500/60 rounded px-2 py-0.5 text-xs text-foreground focus:outline-none"
+          className="w-full bg-muted border border-border rounded px-2 py-0.5 text-xs text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
         />
         {isPending && <Loader2 size={12} className="absolute right-3 top-1/2 -translate-y-1/2 animate-spin text-zinc-500" />}
       </div>
@@ -304,7 +304,7 @@ function FileNodeItem({ node, depth, currentPath, onNavigate }: {
             if (e.key === 'Escape') setRenaming(false);
           }}
           onBlur={commitRename}
-          className="w-full bg-muted border border-blue-500/60 rounded px-2 py-0.5 text-xs text-foreground focus:outline-none"
+          className="w-full bg-muted border border-border rounded px-2 py-0.5 text-xs text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
         />
         {isPending && <Loader2 size={12} className="absolute right-3 top-1/2 -translate-y-1/2 animate-spin text-zinc-500" />}
       </div>
@@ -334,7 +334,7 @@ function FileNodeItem({ node, depth, currentPath, onNavigate }: {
         <button onClick={startRename} className="p-0.5 rounded text-muted-foreground hover:text-foreground hover:bg-muted transition-colors" title={t.fileTree.rename}>
           <Pencil size={12} />
         </button>
-        <button onClick={handleDelete} className="p-0.5 rounded text-muted-foreground hover:text-red-400 hover:bg-muted transition-colors" title={t.fileTree.delete}>
+        <button onClick={handleDelete} className="p-0.5 rounded text-muted-foreground hover:text-error hover:bg-muted transition-colors" title={t.fileTree.delete}>
           <Trash2 size={12} />
         </button>
       </div>

package/app/components/HomeContent.tsx

@@ -278,7 +278,7 @@ export default function HomeContent({ recent, existingFiles }: { recent: RecentF
                       className="flex items-center gap-3 px-3 py-2.5 rounded-lg transition-all duration-100 group-hover:translate-x-0.5 hover:bg-muted"
                     >
                       {isCSV
-                        ? <Table size={13} className="shrink-0" style={{ color: '#7aad80' }} />
+                        ? <Table size={13} className="shrink-0" style={{ color: 'var(--success)' }} />
                         : <FileText size={13} className="shrink-0" style={{ color: 'var(--muted-foreground)' }} />
                       }
                       <div className="flex-1 min-w-0">