@geminilight/mindos 0.6.30 → 0.6.31

package/README_zh.md

@@ -162,11 +162,15 @@ npx skills add https://github.com/GeminiLight/MindOS --skill mindos-zh -g -y   #
 
 - **GUI 工作台**：浏览、编辑、搜索笔记，统一搜索 + AI 入口（`⌘K` / `⌘/`），专为人机共创设计。
 - **内置 Agent 助手**：在上下文中与知识库对话，编辑无缝沉淀为可管理知识。
-- **插件扩展**：多种内置渲染器插件——TODO Board、CSV Views、Wiki Graph、Timeline、Agent Inspector 等。
+- **一键导入**：拖拽文件即可导入，Inline AI Organize 自动分析、分类、写入知识库，支持进度追踪和撤销。
+- **新手引导**：首次使用的分步引导体验，帮助新用户快速搭建知识库并连接第一个 Agent。
+- **插件扩展**：多种内置渲染器插件——TODO Board、CSV Views、Wiki Graph、Timeline、Workflow Editor、Agent Inspector 等。
 
 **Agent 侧**
 
-- **MCP Server + Skills**：stdio + HTTP 双传输，全阵容 Agent 兼容（OpenClaw, Claude Code, Cursor 等），零配置接入。
+- **MCP Server + Skills**：stdio + HTTP 双传输，全阵容 Agent 兼容（Claude Code, Cursor, Gemini CLI 等），零配置接入。
+- **ACP / A2A 协议**：Agent 间通信协议，支持 Agent 发现、任务委派与编排。Phase 1 已上线：Agent Card 发现 + JSON-RPC 消息通信。
+- **Workflow 编排**：基于 YAML 的可视化工作流编辑器 + 步骤执行引擎，定义、编辑、运行多步 Agent 工作流。
 - **结构化模板**：预置 Profile、Workflows、Configurations 等目录骨架，快速冷启动个人 Context。
 - **笔记即指令**：日常笔记天然就是 Agent 可直接执行的高质量指令——无需额外格式转换，写下即可调度。
 
@@ -175,15 +179,17 @@ npx skills add https://github.com/GeminiLight/MindOS --skill mindos-zh -g -y   #
 - **安全防线**：Bearer Token 认证、路径沙箱、INSTRUCTION.md 写保护、原子写入。
 - **知识图谱**：动态解析并可视化文件间的引用与依赖关系。
 - **反向链接视图**：展示所有引用当前文件的反向链接，理解笔记在知识网络中的位置。
+- **Agent 审计面板**：将 Agent 操作日志渲染为可筛选的时间线，审查每次工具调用的详情。
 - **Git 时光机**：Git 自动同步（commit/push/pull），记录人类与 Agent 的每次编辑历史，一键回滚，跨设备同步。
 - **桌面客户端**：原生 macOS/Windows/Linux 应用，系统托盘、开机自启、本地进程管理。
 
 <details>
 <summary><strong>即将到来</strong></summary>
 
-- [ ] ACP（Agent Communication Protocol）：连接外部 Agent（如 Claude Code、Cursor），让知识库成为多 Agent 协作的中枢
 - [ ] RAG 深度集成：基于知识库内容的检索增强生成，让 AI 回答更精准、更有上下文
-- [ ] Agent 审计面板（Agent Inspector）：将 Agent 操作日志渲染为可筛选的时间线，审查每次工具调用的详情
+- [ ] ACP / A2A Phase 2：深度多 Agent 协作，支持任务委派、共享上下文、工作流链式执行
+- [ ] 经验编译器：从 Agent 交互中自动提取纠正和偏好，沉淀为可复用的 Skills/SOP
+- [ ] 知识库健康度仪表盘：可视化认知复利指标——已积累规则数、Agent 复用次数、知识新鲜度
 
 </details>
 

package/app/app/api/ask/route.ts

@@ -520,15 +520,20 @@ export async function POST(req: NextRequest) {
     const requestStartTime = Date.now();
     const stream = new ReadableStream({
       start(controller) {
+        let streamClosed = false;
         function send(event: MindOSSSEvent) {
+          if (streamClosed) return;
           try {
             controller.enqueue(encoder.encode(`data:${JSON.stringify(event)}\n\n`));
-          } catch (err) {
-            if (err instanceof TypeError) {
-              console.error('[ask] SSE send failed (serialization):', (err as Error).message, 'event type:', (event as { type?: string }).type);
-            }
+          } catch {
+            streamClosed = true;
           }
         }
+        function safeClose() {
+          if (streamClosed) return;
+          streamClosed = true;
+          try { controller.close(); } catch { /* already closed */ }
+        }
 
         let hasContent = false;
         let lastModelError = '';
@@ -700,7 +705,7 @@ export async function POST(req: NextRequest) {
                 await closeSession(acpSessionId).catch(() => {});
               }
             }
-            controller.close();
+            safeClose();
           } else {
             // Route to MindOS agent (existing logic)
             await session.prompt(lastUserContent, lastUserImages ? { images: lastUserImages } : undefined);
@@ -710,7 +715,7 @@ export async function POST(req: NextRequest) {
             } else {
               send({ type: 'done' });
             }
-            controller.close();
+            safeClose();
           }
         };
 
@@ -718,7 +723,7 @@ export async function POST(req: NextRequest) {
           metrics.recordRequest(Date.now() - requestStartTime);
           metrics.recordError();
           send({ type: 'error', message: err instanceof Error ? err.message : String(err) });
-          controller.close();
+          safeClose();
         });
       },
     });

package/app/app/api/export/route.ts

@@ -0,0 +1,105 @@
+import { NextRequest, NextResponse } from 'next/server';
+import path from 'path';
+import archiver from 'archiver';
+import { Readable, PassThrough } from 'stream';
+import { getMindRoot } from '@/lib/fs';
+import { readFile } from '@/lib/core/fs-ops';
+import { markdownToHTML, collectExportFiles } from '@/lib/core/export';
+
+export async function GET(req: NextRequest) {
+  const { searchParams } = req.nextUrl;
+  const filePath = searchParams.get('path');
+  const format = searchParams.get('format') ?? 'md';
+
+  if (!filePath) {
+    return NextResponse.json({ error: 'Missing path parameter' }, { status: 400 });
+  }
+
+  // Path traversal defense-in-depth
+  if (filePath.includes('..') || filePath.startsWith('/')) {
+    return NextResponse.json({ error: 'Invalid path' }, { status: 400 });
+  }
+
+  const mindRoot = getMindRoot();
+
+  try {
+    // ── Single file export ──
+    if (format === 'md') {
+      const content = readFile(mindRoot, filePath);
+      const fileName = path.basename(filePath);
+      return new NextResponse(content, {
+        headers: {
+          'Content-Type': 'text/markdown; charset=utf-8',
+          'Content-Disposition': `attachment; filename="${encodeURIComponent(fileName)}"`,
+        },
+      });
+    }
+
+    if (format === 'html') {
+      const content = readFile(mindRoot, filePath);
+      const title = path.basename(filePath, '.md');
+      const html = await markdownToHTML(content, title, filePath);
+      const fileName = path.basename(filePath, '.md') + '.html';
+      return new NextResponse(html, {
+        headers: {
+          'Content-Type': 'text/html; charset=utf-8',
+          'Content-Disposition': `attachment; filename="${encodeURIComponent(fileName)}"`,
+        },
+      });
+    }
+
+    // ── Directory/Space ZIP export ──
+    if (format === 'zip' || format === 'zip-html') {
+      const files = collectExportFiles(mindRoot, filePath);
+      if (files.length === 0) {
+        return NextResponse.json({ error: 'No exportable files found' }, { status: 404 });
+      }
+
+      const spaceName = path.basename(filePath);
+      const date = new Date().toISOString().slice(0, 10);
+      const zipName = `${spaceName}-${date}.zip`;
+
+      // Create archive
+      const archive = archiver('zip', { zlib: { level: 6 } });
+      const passThrough = new PassThrough();
+      archive.pipe(passThrough);
+
+      if (format === 'zip-html') {
+        // Convert each MD file to HTML
+        for (const file of files) {
+          if (file.relativePath.endsWith('.md')) {
+            const title = path.basename(file.relativePath, '.md');
+            const html = await markdownToHTML(file.content, title, file.relativePath);
+            const htmlPath = file.relativePath.replace(/\.md$/, '.html');
+            archive.append(html, { name: htmlPath });
+          } else {
+            archive.append(file.content, { name: file.relativePath });
+          }
+        }
+      } else {
+        for (const file of files) {
+          archive.append(file.content, { name: file.relativePath });
+        }
+      }
+
+      // Pipe archive errors to the passthrough stream
+      archive.on('error', (err) => passThrough.destroy(err));
+      void archive.finalize();
+
+      // Convert Node stream to Web ReadableStream
+      const readable = Readable.toWeb(passThrough) as ReadableStream;
+
+      return new NextResponse(readable, {
+        headers: {
+          'Content-Type': 'application/zip',
+          'Content-Disposition': `attachment; filename="${encodeURIComponent(zipName)}"`,
+        },
+      });
+    }
+
+    return NextResponse.json({ error: `Unsupported format: ${format}` }, { status: 400 });
+  } catch (err) {
+    const message = err instanceof Error ? err.message : 'Export failed';
+    return NextResponse.json({ error: message }, { status: 500 });
+  }
+}

package/app/app/globals.css

@@ -166,10 +166,10 @@ body {
   font-family: var(--prose-font-override, 'Lora', Georgia, serif);
   color: var(--prose-body);
   line-height: 1.85;
-  font-size: 0.95rem;
+  font-size: var(--prose-font-size-override, 0.95rem);
 }
 @media (min-width: 640px) {
-  .prose { font-size: 1rem; }
+  .prose { font-size: var(--prose-font-size-override, 1rem); }
 }
 .prose h1, .prose h2, .prose h3, .prose h4 {
   font-family: 'IBM Plex Sans', sans-serif;

package/app/app/trash/page.tsx

@@ -0,0 +1,7 @@
+import { listTrashAction } from '@/lib/actions';
+import TrashPageClient from '@/components/TrashPageClient';
+
+export default async function TrashPage() {
+  const items = await listTrashAction();
+  return <TrashPageClient initialItems={items} />;
+}

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, Share2, FileText, Code } from 'lucide-react';
+import { Edit3, Save, X, Loader2, LayoutTemplate, ArrowLeft, Share2, FileText, Code, MoreHorizontal, Copy, Pencil, Trash2, Star, Download } from 'lucide-react';
 import { lazy } from 'react';
 import MarkdownView from '@/components/MarkdownView';
 import JsonView from '@/components/JsonView';
@@ -17,6 +17,11 @@ import { resolveRenderer, isRendererEnabled } from '@/lib/renderers/registry';
 import { encodePath } from '@/lib/utils';
 import { useLocale } from '@/lib/LocaleContext';
 import DirPicker from '@/components/DirPicker';
+import { renameFileAction, deleteFileAction } from '@/lib/actions';
+import { ConfirmDialog } from '@/components/agents/AgentsPrimitives';
+import { buildLineDiff } from '@/components/changes/line-diff';
+import { usePinnedFiles } from '@/lib/hooks/usePinnedFiles';
+import ExportModal from '@/components/ExportModal';
 
 interface ViewPageClientProps {
   filePath: string;
@@ -42,6 +47,9 @@ export default function ViewPageClient({
   createDraftAction,
 }: ViewPageClientProps) {
   const { t } = useLocale();
+  const { isPinned, togglePin } = usePinnedFiles();
+  const pinned = isPinned(filePath);
+  const [exportOpen, setExportOpen] = useState(false);
   const hydrated = useSyncExternalStore(
     () => () => {},
     () => true,
@@ -55,18 +63,85 @@ export default function ViewPageClient({
   const [editing, setEditing] = useState(initialEditing || content === '');
   const [editContent, setEditContent] = useState(content);
   const [savedContent, setSavedContent] = useState(content);
+
+  // Sync savedContent when server re-renders with new content (e.g. after router.refresh)
+  useEffect(() => {
+    if (!editing) {
+      setSavedContent(content);
+    }
+  }, [content, editing]);
   const [isPending, startTransition] = useTransition();
   const [saveError, setSaveError] = useState<string | null>(null);
   const [saveSuccess, setSaveSuccess] = useState(false);
   const [mdViewMode, setMdViewMode] = useState<MdViewMode>('wysiwyg');
   const [findOpen, setFindOpen] = useState(false);
   const contentRef = useRef<HTMLDivElement>(null);
+  const [moreOpen, setMoreOpen] = useState(false);
+  const moreRef = useRef<HTMLButtonElement>(null);
+  const moreMenuRef = useRef<HTMLDivElement>(null);
+  const [showDeleteConfirm, setShowDeleteConfirm] = useState(false);
+  const [renaming, setRenaming] = useState(false);
+  const [renameValue, setRenameValue] = useState('');
+  const [, startRenameTransition] = useTransition();
 
   const inferredName = filePath.split('/').pop() || 'Untitled.md';
   const [showSaveAs, setShowSaveAs] = useState(isDraft);
   const [saveDir, setSaveDir] = useState('');
   const [saveName, setSaveName] = useState(inferredName);
 
+  // Close more menu on outside click
+  useEffect(() => {
+    if (!moreOpen) return;
+    const handler = (e: MouseEvent) => {
+      if (
+        moreRef.current && !moreRef.current.contains(e.target as Node) &&
+        moreMenuRef.current && !moreMenuRef.current.contains(e.target as Node)
+      ) setMoreOpen(false);
+    };
+    const keyHandler = (e: KeyboardEvent) => { if (e.key === 'Escape') setMoreOpen(false); };
+    document.addEventListener('mousedown', handler);
+    document.addEventListener('keydown', keyHandler);
+    return () => { document.removeEventListener('mousedown', handler); document.removeEventListener('keydown', keyHandler); };
+  }, [moreOpen]);
+
+  const handleCopyPath = useCallback(() => {
+    navigator.clipboard.writeText(filePath).catch(() => {});
+    setMoreOpen(false);
+  }, [filePath]);
+
+  const handleStartRename = useCallback(() => {
+    setMoreOpen(false);
+    const name = filePath.split('/').pop() ?? '';
+    setRenameValue(name);
+    setRenaming(true);
+  }, [filePath]);
+
+  const handleCommitRename = useCallback(() => {
+    const newName = renameValue.trim();
+    if (!newName || newName === filePath.split('/').pop()) { setRenaming(false); return; }
+    startRenameTransition(async () => {
+      const result = await renameFileAction(filePath, newName);
+      setRenaming(false);
+      if (result.success && result.newPath) {
+        router.push(`/view/${encodePath(result.newPath)}`);
+        router.refresh();
+        window.dispatchEvent(new Event('mindos:files-changed'));
+      }
+    });
+  }, [renameValue, filePath, router]);
+
+  const handleConfirmDelete = useCallback(() => {
+    setShowDeleteConfirm(false);
+    startTransition(async () => {
+      const result = await deleteFileAction(filePath);
+      if (result.success) {
+        router.push('/');
+        router.refresh();
+        window.dispatchEvent(new Event('mindos:files-changed'));
+      }
+    });
+  }, [filePath, router]);
+
   // Keep first paint deterministic between server and client to avoid hydration mismatch.
   const effectiveUseRaw = hydrated ? useRaw : false;
 
@@ -202,6 +277,65 @@ export default function ViewPageClient({
     return () => window.removeEventListener('keydown', handler);
   }, [editing, handleSave, handleEdit, handleCancel]);
 
+  // Auto-refresh when AI agent modifies files + compute changed lines for highlight
+  const [fileUpdated, setFileUpdated] = useState(false);
+  const [changedLines, setChangedLines] = useState<number[]>([]);
+  const prevContentRef = useRef(content);
+  const aiTriggeredRef = useRef(false);
+  const highlightTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+  const updatedTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+
+  // When content prop changes after an AI-triggered refresh, compute diff highlights
+  useEffect(() => {
+    if (!editing && aiTriggeredRef.current && content !== prevContentRef.current && prevContentRef.current !== '') {
+      aiTriggeredRef.current = false;
+      const diff = buildLineDiff(prevContentRef.current, content);
+      const lines: number[] = [];
+      let lineNum = 1;
+      for (const row of diff) {
+        if (row.type === 'insert') {
+          lines.push(lineNum);
+          lineNum++;
+        } else if (row.type === 'equal') {
+          lineNum++;
+        }
+      }
+      if (lines.length > 0) {
+        setChangedLines(lines);
+        // Clear previous timer if any
+        if (highlightTimerRef.current) clearTimeout(highlightTimerRef.current);
+        highlightTimerRef.current = setTimeout(() => setChangedLines([]), 6000);
+        // Auto-scroll to change banner
+        setTimeout(() => {
+          const el = document.querySelector('[data-highlight-line]');
+          if (el) el.scrollIntoView({ block: 'center', behavior: 'smooth' });
+        }, 100);
+      }
+    }
+    prevContentRef.current = content;
+  }, [content, editing]);
+
+  useEffect(() => {
+    let debounceTimer: ReturnType<typeof setTimeout> | null = null;
+    const handler = () => {
+      if (editing) return;
+      // Debounce rapid file changes (AI may write multiple files in sequence)
+      if (debounceTimer) clearTimeout(debounceTimer);
+      debounceTimer = setTimeout(() => {
+        aiTriggeredRef.current = true;
+        router.refresh();
+        setFileUpdated(true);
+        if (updatedTimerRef.current) clearTimeout(updatedTimerRef.current);
+        updatedTimerRef.current = setTimeout(() => setFileUpdated(false), 3000);
+      }, 300);
+    };
+    window.addEventListener('mindos:files-changed', handler);
+    return () => {
+      window.removeEventListener('mindos:files-changed', handler);
+      if (debounceTimer) clearTimeout(debounceTimer);
+    };
+  }, [editing, router]);
+
   return (
     <div className="flex flex-col min-h-screen">
       {/* Top bar */}
@@ -219,6 +353,12 @@ export default function ViewPageClient({
           </div>
 
           <div className="flex items-center gap-1.5 md:gap-2 shrink-0">
+            {fileUpdated && !editing && (
+              <span className="text-xs flex items-center gap-1.5 text-[var(--amber)] animate-in fade-in-0 duration-200">
+                <span className="w-1.5 h-1.5 rounded-full bg-[var(--amber)]" />
+                <span className="hidden sm:inline">updated</span>
+              </span>
+            )}
             {saveSuccess && (
               <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)' }} />
@@ -297,6 +437,54 @@ export default function ViewPageClient({
                 </button>
               </>
             )}
+
+            {/* More menu (rename, copy path, delete) */}
+            {!isDraft && (
+              <div className="relative">
+                <button
+                  type="button"
+                  onClick={() => togglePin(filePath)}
+                  className="p-1.5 rounded-md text-muted-foreground hover:text-foreground hover:bg-muted transition-colors"
+                  title={pinned ? t.fileTree.removeFromFavorites : t.fileTree.pinToFavorites}
+                >
+                  <Star size={16} className={pinned ? 'fill-[var(--amber)] text-[var(--amber)]' : ''} />
+                </button>
+                <button
+                  type="button"
+                  onClick={() => setExportOpen(true)}
+                  className="p-1.5 rounded-md text-muted-foreground hover:text-foreground hover:bg-muted transition-colors"
+                  title={t.fileTree.export}
+                >
+                  <Download size={16} />
+                </button>
+                <button
+                  ref={moreRef}
+                  type="button"
+                  onClick={() => setMoreOpen(v => !v)}
+                  className="p-1.5 rounded-md text-muted-foreground hover:text-foreground hover:bg-muted transition-colors"
+                  title="More"
+                >
+                  <MoreHorizontal size={16} />
+                </button>
+                {moreOpen && (
+                  <div
+                    ref={moreMenuRef}
+                    className="absolute right-0 top-full mt-1 z-50 min-w-[160px] rounded-lg border border-border bg-card shadow-lg py-1"
+                  >
+                    <button className="w-full flex items-center gap-2 px-3 py-2 text-sm text-foreground hover:bg-muted transition-colors text-left" onClick={handleCopyPath}>
+                      <Copy size={14} className="shrink-0" /> Copy Path
+                    </button>
+                    <button className="w-full flex items-center gap-2 px-3 py-2 text-sm text-foreground hover:bg-muted transition-colors text-left" onClick={handleStartRename}>
+                      <Pencil size={14} className="shrink-0" /> Rename
+                    </button>
+                    <div className="my-1 border-t border-border/50" />
+                    <button className="w-full flex items-center gap-2 px-3 py-2 text-sm text-error hover:bg-error/10 transition-colors text-left" onClick={() => { setMoreOpen(false); setShowDeleteConfirm(true); }}>
+                      <Trash2 size={14} className="shrink-0" /> Delete
+                    </button>
+                  </div>
+                )}
+              </div>
+            )}
           </div>
         </div>
       </div>
@@ -375,7 +563,7 @@ export default function ViewPageClient({
               <JsonView content={savedContent} />
             ) : (
               <>
-                <MarkdownView content={savedContent} />
+                <MarkdownView content={savedContent} highlightLines={changedLines} onDismissHighlight={() => setChangedLines([])} />
                 <TableOfContents content={savedContent} />
               </>
             )}
@@ -383,6 +571,50 @@ export default function ViewPageClient({
           </div>
         )}
       </div>
+
+      {/* Inline rename dialog */}
+      {renaming && (
+        <div className="fixed inset-0 z-50 flex items-center justify-center bg-background/60 backdrop-blur-sm">
+          <div className="bg-card border border-border rounded-lg shadow-lg p-4 w-80">
+            <h3 className="text-sm font-medium mb-2">Rename</h3>
+            <input
+              autoFocus
+              value={renameValue}
+              onChange={e => setRenameValue(e.target.value)}
+              onKeyDown={e => {
+                if (e.key === 'Enter') handleCommitRename();
+                if (e.key === 'Escape') setRenaming(false);
+              }}
+              className="w-full bg-muted border border-border rounded-md px-3 py-1.5 text-sm text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
+            />
+            <div className="flex justify-end gap-2 mt-3">
+              <button onClick={() => setRenaming(false)} className="px-3 py-1.5 rounded-md text-xs bg-muted text-muted-foreground hover:bg-accent transition-colors">Cancel</button>
+              <button onClick={handleCommitRename} className="px-3 py-1.5 rounded-md text-xs bg-[var(--amber)] text-[var(--amber-foreground)] transition-colors">Rename</button>
+            </div>
+          </div>
+        </div>
+      )}
+
+      {/* Delete confirm */}
+      <ConfirmDialog
+        open={showDeleteConfirm}
+        title="Delete"
+        message={`Delete "${filePath.split('/').pop()}"? This cannot be undone.`}
+        confirmLabel="Delete"
+        cancelLabel="Cancel"
+        variant="destructive"
+        onCancel={() => setShowDeleteConfirm(false)}
+        onConfirm={handleConfirmDelete}
+      />
+
+      {/* Export modal */}
+      <ExportModal
+        open={exportOpen}
+        onClose={() => setExportOpen(false)}
+        filePath={filePath}
+        isDirectory={false}
+        fileName={filePath.split('/').pop() ?? filePath}
+      />
     </div>
   );
 }