@geminilight/mindos 0.6.57 → 0.6.59

package/app/components/ask/SessionHistory.tsx

@@ -1,7 +1,7 @@
 'use client';
 
 import { useState, useRef, useEffect, useCallback } from 'react';
-import { Trash2, Pencil } from 'lucide-react';
+import { Trash2, Pencil, Pin, PinOff } from 'lucide-react';
 import type { ChatSession } from '@/lib/types';
 import { sessionTitle } from '@/hooks/useAskSession';
 
@@ -11,11 +11,25 @@ interface SessionHistoryProps {
   onLoad: (id: string) => void;
   onDelete: (id: string) => void;
   onRename: (id: string, title: string) => void;
+  onTogglePin: (id: string) => void;
   onClearAll: () => void;
   labels: { title: string; clearAll: string; confirmClear: string; noSessions: string; rename: string };
 }
 
-export default function SessionHistory({ sessions, activeSessionId, onLoad, onDelete, onRename, onClearAll, labels }: SessionHistoryProps) {
+function formatRelativeTime(date: Date): string {
+  const now = Date.now();
+  const diff = now - date.getTime();
+  const mins = Math.floor(diff / 60000);
+  if (mins < 1) return 'just now';
+  if (mins < 60) return `${mins}m ago`;
+  const hours = Math.floor(mins / 60);
+  if (hours < 24) return `${hours}h ago`;
+  const days = Math.floor(hours / 24);
+  if (days < 7) return `${days}d ago`;
+  return date.toLocaleDateString(undefined, { month: 'short', day: 'numeric' });
+}
+
+export default function SessionHistory({ sessions, activeSessionId, onLoad, onDelete, onRename, onTogglePin, onClearAll, labels }: SessionHistoryProps) {
   const [confirmClearAll, setConfirmClearAll] = useState(false);
   const clearTimerRef = useRef<ReturnType<typeof setTimeout>>(undefined);
   const [editingId, setEditingId] = useState<string | null>(null);
@@ -60,78 +74,90 @@ export default function SessionHistory({ sessions, activeSessionId, onLoad, onDe
   }, []);
 
   return (
-    <div className="border-b border-border px-4 py-2.5 max-h-[190px] overflow-y-auto">
-      <div className="flex items-center justify-between mb-2">
-        <span className="text-xs text-muted-foreground">{labels.title}</span>
+    <div className="border-b border-border/40 px-4 py-3 max-h-[220px] overflow-y-auto">
+      <div className="flex items-center justify-between mb-2.5">
+        <span className="text-xs font-medium text-muted-foreground">{labels.title}</span>
         {sessions.length > 1 && (
           <button
             type="button"
             onClick={handleClearAll}
-            className={`text-2xs px-1.5 py-0.5 rounded transition-colors ${
+            className={`text-2xs px-2 py-0.5 rounded-md transition-colors ${
               confirmClearAll
                 ? 'bg-error/10 text-error font-medium'
-                : 'text-muted-foreground hover:text-error hover:bg-muted'
+                : 'text-muted-foreground/60 hover:text-error hover:bg-muted'
             }`}
           >
             {confirmClearAll ? labels.confirmClear : labels.clearAll}
           </button>
         )}
       </div>
-      <div className="flex flex-col gap-1.5">
+      <div className="flex flex-col gap-1">
         {sessions.length === 0 && (
-          <div className="text-xs text-muted-foreground/70">{labels.noSessions}</div>
+          <div className="text-xs text-muted-foreground/50 py-2 text-center">{labels.noSessions}</div>
         )}
-        {sessions.map((s) => (
-          <div key={s.id} className="group flex items-center gap-1">
-            <button
-              type="button"
-              onClick={() => onLoad(s.id)}
-              onDoubleClick={() => startRename(s)}
-              className={`flex-1 text-left px-2 py-1.5 rounded text-xs transition-colors min-w-0 ${
-                activeSessionId === s.id
-                  ? 'bg-accent text-foreground'
-                  : 'text-muted-foreground hover:bg-muted hover:text-foreground'
-              }`}
-            >
-              {editingId === s.id ? (
-                <input
-                  ref={inputRef}
-                  type="text"
-                  value={editValue}
-                  onChange={(e) => setEditValue(e.target.value)}
-                  onBlur={commitRename}
-                  onKeyDown={(e) => {
-                    if (e.key === 'Enter') { e.preventDefault(); commitRename(); }
-                    if (e.key === 'Escape') { e.preventDefault(); cancelRename(); }
-                  }}
-                  onClick={(e) => e.stopPropagation()}
-                  className="w-full bg-transparent border-b border-[var(--amber)] outline-none text-xs text-foreground"
-                />
-              ) : (
-                <div className="truncate">{sessionTitle(s)}</div>
-              )}
-              {editingId !== s.id && (
-                <div className="text-2xs opacity-60">{new Date(s.updatedAt).toLocaleString()}</div>
-              )}
-            </button>
-            <button
-              type="button"
-              onClick={() => startRename(s)}
-              className="p-1 rounded text-muted-foreground hover:text-foreground hover:bg-muted opacity-0 group-hover:opacity-100 transition-opacity"
-              title={labels.rename}
-            >
-              <Pencil size={11} />
-            </button>
-            <button
-              type="button"
-              onClick={() => onDelete(s.id)}
-              className="p-1 rounded text-muted-foreground hover:text-error hover:bg-muted opacity-0 group-hover:opacity-100 transition-opacity"
-              title="Delete session"
-            >
-              <Trash2 size={12} />
-            </button>
-          </div>
-        ))}
+        {sessions.map((s) => {
+          const isActive = activeSessionId === s.id;
+          return (
+            <div key={s.id} className="group flex items-center gap-0.5">
+              {s.pinned && <Pin size={10} className="shrink-0 text-[var(--amber)]/50 -rotate-45 ml-1" />}
+              <button
+                type="button"
+                onClick={() => onLoad(s.id)}
+                onDoubleClick={() => startRename(s)}
+                className={`flex-1 text-left px-2.5 py-2 rounded-lg text-xs transition-colors min-w-0 ${
+                  isActive
+                    ? 'bg-[var(--amber)]/8 text-foreground border border-[var(--amber)]/15'
+                    : 'text-muted-foreground hover:bg-muted hover:text-foreground border border-transparent'
+                }`}
+              >
+                {editingId === s.id ? (
+                  <input
+                    ref={inputRef}
+                    type="text"
+                    value={editValue}
+                    onChange={(e) => setEditValue(e.target.value)}
+                    onBlur={commitRename}
+                    onKeyDown={(e) => {
+                      if (e.key === 'Enter') { e.preventDefault(); commitRename(); }
+                      if (e.key === 'Escape') { e.preventDefault(); cancelRename(); }
+                    }}
+                    onClick={(e) => e.stopPropagation()}
+                    className="w-full bg-transparent border-b border-[var(--amber)] outline-none text-xs text-foreground"
+                  />
+                ) : (
+                  <div className="truncate font-medium">{sessionTitle(s)}</div>
+                )}
+                {editingId !== s.id && (
+                  <div className="text-2xs text-muted-foreground/50 mt-0.5">{formatRelativeTime(new Date(s.updatedAt))}</div>
+                )}
+              </button>
+              <button
+                type="button"
+                onClick={() => onTogglePin(s.id)}
+                className={`p-1.5 rounded-lg transition-opacity opacity-0 group-hover:opacity-100 ${s.pinned ? 'text-[var(--amber)] hover:text-muted-foreground' : 'text-muted-foreground hover:text-[var(--amber)]'}`}
+                title={s.pinned ? 'Unpin' : 'Pin'}
+              >
+                {s.pinned ? <PinOff size={11} /> : <Pin size={11} />}
+              </button>
+              <button
+                type="button"
+                onClick={() => startRename(s)}
+                className="p-1.5 rounded-lg text-muted-foreground hover:text-foreground hover:bg-muted opacity-0 group-hover:opacity-100 transition-opacity"
+                title={labels.rename}
+              >
+                <Pencil size={11} />
+              </button>
+              <button
+                type="button"
+                onClick={() => onDelete(s.id)}
+                className="p-1.5 rounded-lg text-muted-foreground hover:text-error hover:bg-error/5 opacity-0 group-hover:opacity-100 transition-opacity"
+                title="Delete session"
+              >
+                <Trash2 size={11} />
+              </button>
+            </div>
+          );
+        })}
       </div>
     </div>
   );

package/app/components/ask/SessionTabBar.tsx

@@ -19,48 +19,56 @@ export default function SessionTabBar({
 }: SessionTabBarProps) {
   const { t } = useLocale();
   const visibleSessions = sessions.slice(0, maxTabs);
+  const hasMore = sessions.length > maxTabs;
 
   if (visibleSessions.length === 0) return null;
 
   return (
-    <div className="flex items-center border-b border-border shrink-0 bg-background/50">
+    <div className="flex items-center border-b border-border/60 shrink-0 bg-background/50" role="tablist">
       <div className="flex flex-1 min-w-0">
         {visibleSessions.map((s) => {
           const isActive = s.id === activeSessionId;
           const title = sessionTitle(s);
           return (
-            <button
-              key={s.id}
-              type="button"
-              onClick={() => onLoad(s.id)}
-              className={`group relative flex items-center gap-1 min-w-0 max-w-[160px] px-3 py-2 text-xs transition-colors
-                ${isActive
-                  ? 'text-foreground border-b-2 border-[var(--amber)] bg-card'
-                  : 'text-muted-foreground hover:text-foreground hover:bg-muted/50 border-b-2 border-transparent'
-                }`}
-              title={title}
-            >
-              <span className="truncate">{title === '(empty session)' ? t.hints.newChat : title}</span>
+            <div key={s.id} className="group relative flex items-center min-w-0 max-w-[160px]">
+              <button
+                type="button"
+                role="tab"
+                aria-selected={isActive}
+                onClick={() => onLoad(s.id)}
+                className={`flex-1 min-w-0 px-3 py-2.5 text-xs transition-colors truncate
+                  ${isActive
+                    ? 'text-foreground border-b-2 border-[var(--amber)] bg-card font-medium'
+                    : 'text-muted-foreground hover:text-foreground hover:bg-muted/50 border-b-2 border-transparent'
+                  }`}
+                title={title}
+              >
+                {title === '(empty session)' ? t.hints.newChat : title}
+              </button>
               {visibleSessions.length > 1 && (
-                <span
-                  role="button"
-                  tabIndex={0}
+                <button
+                  type="button"
                   onClick={(e) => { e.stopPropagation(); onDelete(s.id); }}
-                  onKeyDown={(e) => { if (e.key === 'Enter') { e.stopPropagation(); onDelete(s.id); } }}
-                  className="shrink-0 p-0.5 rounded opacity-0 group-hover:opacity-100 hover:bg-muted hover:text-error transition-opacity"
+                  className="absolute right-0.5 top-1/2 -translate-y-1/2 shrink-0 p-0.5 rounded opacity-100 md:opacity-0 md:group-hover:opacity-100 hover:bg-muted hover:text-error transition-opacity"
                   title={t.hints.closeSession}
+                  aria-label={`${t.hints.closeSession}: ${title}`}
                 >
                   <X size={10} />
-                </span>
+                </button>
               )}
-            </button>
+            </div>
           );
         })}
+        {hasMore && (
+          <span className="flex items-center px-2 text-2xs text-muted-foreground/60">
+            +{sessions.length - maxTabs}
+          </span>
+        )}
       </div>
       <button
         type="button"
         onClick={onNew}
-        className="shrink-0 p-2 text-muted-foreground hover:text-foreground hover:bg-muted/50 transition-colors"
+        className="shrink-0 p-2 text-muted-foreground hover:text-foreground hover:bg-muted/50 transition-colors rounded-lg"
         title={t.hints.newChat}
       >
         <Plus size={13} />

package/app/components/ask/ThinkingBlock.tsx

@@ -16,11 +16,12 @@ export default function ThinkingBlock({ text, isStreaming }: ThinkingBlockProps)
   if (!text && !isStreaming) return null;
 
   return (
-    <div className="my-1 rounded-md border border-border/40 bg-muted/20 text-xs">
+    <div className="my-1.5 rounded-lg border border-border/30 bg-muted/15 text-xs">
       <button
         type="button"
         onClick={() => setExpanded(v => !v)}
-        className="w-full flex items-center gap-1.5 px-2 py-1.5 text-left hover:bg-muted/30 transition-colors rounded-md"
+        aria-expanded={expanded}
+        className="w-full flex items-center gap-1.5 px-2.5 py-2 text-left hover:bg-muted/30 transition-colors rounded-lg"
       >
         {expanded ? (
           <ChevronDown size={12} className="shrink-0 text-muted-foreground" />
@@ -35,17 +36,17 @@ export default function ThinkingBlock({ text, isStreaming }: ThinkingBlockProps)
           )}
         </span>
         {!expanded && text && (
-          <span className="text-muted-foreground/60 truncate flex-1 ml-1">
+          <span className="text-muted-foreground/50 truncate flex-1 ml-1">
             {text.slice(0, 80)}{text.length > 80 ? '...' : ''}
           </span>
         )}
       </button>
       {expanded && (
-        <div className="px-2 pb-2 pt-0.5 border-t border-border/30">
+        <div className="px-2.5 pb-2.5 pt-1 border-t border-border/20">
           <div className="text-muted-foreground whitespace-pre-wrap leading-relaxed">
             {text}
             {isStreaming && (
-              <span className="inline-block w-1 h-3 bg-muted-foreground/40 ml-0.5 align-middle animate-pulse rounded-sm" />
+              <span className="inline-block w-1 h-3 bg-muted-foreground/40 ml-0.5 align-middle animate-pulse rounded-full" />
             )}
           </div>
         </div>

package/app/components/ask/ToolCallBlock.tsx

@@ -101,15 +101,16 @@ export default function ToolCallBlock({ part }: { part: ToolCallPart }) {
     : formatInput(part.input);
 
   return (
-    <div className={`my-1 rounded-md border text-xs font-mono ${
+    <div className={`my-1.5 rounded-lg border text-xs font-mono ${
       isDestructive
         ? 'border-[var(--amber)]/30 bg-background/60'
-        : 'border-border/50 bg-background/60'
+        : 'border-border/40 bg-background/50'
     }`}>
       <button
         type="button"
         onClick={() => setManualToggle(v => v === null ? !expanded : !v)}
-        className="w-full flex items-center gap-1.5 px-2 py-1.5 text-left hover:bg-muted/30 transition-colors rounded-md"
+        aria-expanded={expanded}
+        className="w-full flex items-center gap-1.5 px-2.5 py-2 text-left hover:bg-muted/30 transition-colors rounded-lg"
       >
         {expanded ? <ChevronDown size={12} className="shrink-0 text-muted-foreground" /> : <ChevronRight size={12} className="shrink-0 text-muted-foreground" />}
         {isDestructive && <AlertTriangle size={11} className="shrink-0 text-[var(--amber)]" />}
@@ -161,19 +162,19 @@ export default function ToolCallBlock({ part }: { part: ToolCallPart }) {
             </div>
           ) : (
             /* Fallback: show input (always), output when available */
-            <div className="px-2 pb-2 pt-1 space-y-1">
+            <div className="px-2.5 pb-2.5 pt-1.5 space-y-1.5">
               {part.state === 'running' && (
-                <div className="text-muted-foreground/60 text-2xs flex items-center gap-1">
+                <div className="text-muted-foreground/60 text-2xs flex items-center gap-1.5">
                   <Loader2 size={10} className="animate-spin" /> Running...
                 </div>
               )}
-              <div className="text-muted-foreground">
-                <span className="font-semibold">Input: </span>
+              <div className="text-muted-foreground leading-relaxed">
+                <span className="font-semibold text-foreground/70">Input: </span>
                 <span className="break-all whitespace-pre-wrap">{JSON.stringify(part.input, null, 2)}</span>
               </div>
               {part.output !== undefined && part.output !== '' && (
-                <div className="text-muted-foreground">
-                  <span className="font-semibold">Output: </span>
+                <div className="text-muted-foreground leading-relaxed">
+                  <span className="font-semibold text-foreground/70">Output: </span>
                   <span className="break-all whitespace-pre-wrap">{part.output.length > 500 ? part.output.slice(0, 500) + '…' : part.output}</span>
                 </div>
               )}

package/app/components/settings/SettingsContent.tsx

@@ -66,7 +66,7 @@ export default function SettingsContent({ visible, initialTab, variant, onClose
 
     if (justOpened) {
       apiFetch<SettingsData>('/api/settings').then(d => { setData(d); dataLoaded.current = true; }).catch(() => setStatus('load-error'));
-      setFont(localStorage.getItem('prose-font') === 'geist' ? 'inter' : localStorage.getItem('prose-font') ?? 'lora');
+      setFont(localStorage.getItem('prose-font') === 'geist' ? 'inter' : localStorage.getItem('prose-font') ?? 'ibm-plex-sans');
       setFontSize(localStorage.getItem('prose-font-size') ?? '15px');
       setContentWidth(localStorage.getItem('content-width') ?? '780px');
       const stored = localStorage.getItem('theme');

package/app/data/skills/mindos/SKILL.md

@@ -1,21 +1,33 @@
 ---
 name: mindos
 description: >
-  Operate a MindOS knowledge base: update notes, search, organize files, execute SOPs/workflows,
-  retrospective, append CSV, cross-agent handoff, route unstructured input to the right files,
-  distill experience, sync related docs. 更新笔记, 搜索知识库, 整理, 执行SOP, 复盘, 追加CSV, 交接, 路由到文件, 提炼经验.
-  Use when the task targets files inside the user's MindOS KB (mindRoot).
+  The user's shared knowledge base — persistent across sessions and agents. MindOS stores decisions,
+  meeting notes, SOPs, debugging lessons, architecture choices, research findings, and preferences.
+  更新笔记, 搜索知识库, 整理文件, 执行SOP/工作流, 复盘, 追加CSV, 跨Agent交接,
+  路由非结构化输入到对应文件, 提炼经验, 同步关联文档.
   NOT for editing app source, project docs, or paths outside the KB.
   Core concepts: Space, Instruction (INSTRUCTION.md), Skill (SKILL.md); notes can embody both.
-  Trigger when user asks to: save or record a note, search their knowledge base, update or edit
-  a file, organize notes, run a workflow or SOP, capture decisions from a session, append rows
-  to a table or CSV, hand off context to another agent — or says "帮我记下来" / "搜一下我的笔记" /
-  "更新知识库" / "整理文件" / "执行工作流".
+
+  Trigger on: save or record anything, search for prior notes or context, update or edit a file,
+  organize notes, run a workflow or SOP, capture decisions, append rows to a table or CSV,
+  hand off context to another agent, check if something was discussed before, look up a past
+  decision, distill lessons learned, prepare context for a meeting, quick-capture to staging area,
+  organize inbox, check knowledge health, detect conflicts or contradictions, find stale content.
+  Chinese triggers: 帮我记下来, 搜一下笔记, 更新知识库, 整理文件, 复盘, 提炼经验,
+  保存, 记录, 交接, 查一下之前的, 有没有相关笔记, 把这个存起来, 放到暂存台,
+  整理暂存台, 知识健康检查, 检测知识冲突.
+
+  Proactive behavior — do not wait for the user to mention MindOS:
+  (1) When user's question implies stored context may exist (past decisions, previous discussions,
+  meeting records) → search MindOS first, even if they don't explicitly mention it.
+  (2) After completing valuable work (bug fixed, decision made, lesson learned, architecture chosen,
+  meeting summarized) → offer to save it to MindOS for future reference.
+  (3) After a long or multi-topic conversation → suggest persisting key decisions and context.
 ---
 
 # MindOS Skill
 
-<!-- version: 3.0.0 — CLI-first, MCP optional -->
+<!-- version: 3.2.0 — CLI-first, MCP optional -->
 
 ## CLI commands
 
@@ -80,6 +92,7 @@ npm install -g @geminilight/mindos
 - **Space** — Knowledge partitions organized the way you think. Agents follow the same structure.
 - **Instruction** — A rules file (`INSTRUCTION.md`) all connected agents obey.
 - **Skill** — Teaches agents how to read, write, and organize the KB.
+- **Inbox** — The `Inbox/` directory is a staging area for quick capture. Files land here when there's no obvious home yet. They get organized later — by the user manually or via AI-assisted batch organization.
 
 Notes can embody both Instruction and Skill — they're just Markdown files in the tree.
 
@@ -94,9 +107,13 @@ User request
   │   └─ [Read-only]: search → read → answer with citations. No writes.
   │
   ├─ Save / record / update / organize specific content?
-  │   ├─ Single file → [Single-file edit]
+  │   ├─ Know where it goes → [Single-file edit]
+  │   ├─ Don't know where it goes → [Inbox path] — save to Inbox/, classify later
   │   └─ Multiple files or unclear → [Multi-file routing] — plan first
   │
+  ├─ Organize inbox / classify staged files?
+  │   └─ [Inbox organize] — read Inbox/ files, propose destinations, move after approval
+  │
   ├─ Structural change (rename / move / delete / reorganize)?
   │   └─ [Structural path] — check backlinks before and after
   │
@@ -106,6 +123,9 @@ User request
   ├─ Retrospective / distill / handoff?
   │   └─ [Retrospective path]
   │
+  ├─ Knowledge health check / detect conflicts?
+  │   └─ [Health check path] — read references/knowledge-health.md
+  │
   └─ Ambiguous?
       └─ ASK. Propose 2-3 specific options based on KB state.
 ```
@@ -115,13 +135,14 @@ User request
 ## Judgment heuristics
 
 **Save intent boundary:**
-- "帮我记下来" / "保存" = write
-- "搜一下" / "总结" = read-only
-- "整理一下" → ask: display only, or write back?
+- "save this" / "record" / "write down" = write
+- "search" / "summarize" / "look up" = read-only
+- "organize" → ask: display only, or write back?
 
 **File location uncertainty:**
-- Can't decide in 5 seconds → use nearest existing directory, inform user
-- "Just put it somewhere" → inbox, propose classification after
+- Can't decide in 5 seconds → save to `Inbox/`, inform user, propose classification later
+- "Just put it somewhere" / "先放着" → save to `Inbox/`
+- User drags files or pastes unstructured content without specifying location → `Inbox/`
 
 **Scope creep:**
 - Input routes to >5 files → pause, confirm scope
@@ -154,6 +175,42 @@ When user expresses a standing preference → read [references/preference-captur
 
 When creating/rewriting an SOP → read [references/sop-template.md](./references/sop-template.md).
 
+## Inbox (staging area)
+
+The `Inbox/` directory is the KB's quick-capture zone. It has its own `INSTRUCTION.md` that governs behavior.
+
+**When to use Inbox:**
+- User says "just save it" / "先放着" / "放到暂存台" without specifying a location
+- Content doesn't clearly fit any existing Space or directory
+- Batch import of multiple files that need individual classification
+
+**How to save to Inbox:**
+```bash
+mindos file create "Inbox/<filename>.md" --content "..."
+```
+
+**How to organize Inbox:**
+1. List Inbox files: `mindos file list Inbox/`
+2. Read each file to understand its content
+3. For each file, propose the best destination directory based on KB structure
+4. Present the full routing plan to user for approval
+5. Move files: `mindos file rename "Inbox/<file>" "<target-dir>/<file>"`
+6. After moving, check if the target directory's README needs updating
+
+**Aging reminder:** Files in Inbox older than 7 days are considered "aging". If you notice aging files during bootstrap, mention it: "You have N files in Inbox that have been sitting there for over a week. Want me to help organize them?"
+
+## Knowledge health check
+
+When user asks to check knowledge health, detect conflicts, audit quality, or says "知识健康检查" / "检测冲突" → read [references/knowledge-health.md](./references/knowledge-health.md) for the full procedure.
+
+Quick summary of what gets checked:
+- **Contradictions**: conflicting facts across files on the same topic
+- **Broken links**: references to files that no longer exist
+- **Stale content**: files with outdated date markers or untouched for >6 months
+- **Duplicates**: two files covering the same ground without cross-referencing
+- **Orphan files**: files with zero backlinks, hard to discover
+- **Structural issues**: wrong directory, missing READMEs, aging Inbox files
+
 ---
 
 ## Error handling (CLI)

package/app/data/skills/mindos-zh/SKILL.md

@@ -1,16 +1,34 @@
 ---
 name: mindos-zh
 description: >
-  操作 MindOS 知识库：更新笔记, 搜索知识库, 整理文件, 执行SOP/工作流, 复盘, 追加CSV, 跨Agent交接,
-  路由非结构化输入到对应文件, 提炼经验, 同步关联文档. update notes, search knowledge base, organize,
-  SOP, retrospective, CSV, handoff, route notes, distill experience.
-  仅 mindRoot 知识库内任务。不用于：改代码仓库/项目文档/KB 外路径。
+  用户的共享知识库——跨会话、跨 Agent 持久存在。MindOS 存储决策记录、会议纪要、SOP、
+  排错经验、架构选型、调研结论和偏好设置。
+  仅 mindRoot 知识库内任务。不用于：改代码仓库、项目源码、KB 外路径。
   核心概念：空间、指令(INSTRUCTION.md)、技能(SKILL.md)；笔记可承载指令与技能。
+
+  触发场景：保存或记录任何内容、搜索历史笔记或上下文、更新或编辑文件、整理或重组文件结构、
+  执行SOP或工作流、捕获对话中的决策、复盘或总结经验、追加表格或CSV数据、跨Agent交接上下文、
+  提炼经验教训、同步关联文档、查找之前是否讨论过某事、查询历史决策、查找模板或SOP、
+  为会议准备上下文、快速暂存到暂存台、整理暂存台、知识健康检查、检测知识冲突或矛盾、
+  查找过期内容。
+  触发词：帮我记下来、搜一下我的笔记、更新知识库、整理文件、执行工作流、保存到知识库、
+  记录一下、整理笔记、复盘、提炼经验、同步文档、查一下之前的记录、有没有相关的笔记、
+  我之前写过什么、把这个存起来、总结一下保存、交接给其他Agent、追加到表格、
+  放到暂存台、整理暂存台、知识健康检查、检测知识冲突。
+  English triggers: save, record, search notes, organize, retrospective, handoff, lessons learned,
+  inbox, staging, knowledge health, detect conflicts.
+
+  主动行为——不要等用户提到 MindOS：
+  (1) 用户的问题暗示可能存在历史记录（过去的决策、之前的讨论、会议纪要）→ 先搜 MindOS，
+  即使没有明确提到知识库。
+  (2) 完成有价值的工作后（修了 bug、做了决策、总结了经验、选定了架构、开完了会）→
+  主动提议保存到 MindOS，方便以后查阅。
+  (3) 经历了较长或多主题的对话后 → 建议把关键决策和上下文持久化。
 ---
 
 # MindOS 技能
 
-<!-- version: 3.0.0 — CLI 优先，MCP 可选 -->
+<!-- version: 3.2.0 — CLI 优先，MCP 可选 -->
 
 ## CLI 命令
 
@@ -75,6 +93,7 @@ npm install -g @geminilight/mindos
 - **空间 (Space)** — 按你的思维方式组织的知识分区。Agent 遵循相同结构。
 - **指令 (Instruction)** — `INSTRUCTION.md`，所有连接的 Agent 都遵守的规则文件。
 - **技能 (Skill)** — 教 Agent 如何读写和整理知识库。
+- **暂存台 (Inbox)** — `Inbox/` 目录是快速捕获区。内容暂时找不到归属时先放这里，之后再统一整理——用户手动或 AI 辅助批量归类。
 
 笔记可以同时承载指令和技能——它们只是目录树中的 Markdown 文件。
 
@@ -89,9 +108,13 @@ npm install -g @geminilight/mindos
   │   └─ [只读路径]：搜索 → 读取 → 带引用回答。不写入。
   │
   ├─ 保存 / 记录 / 更新 / 整理具体内容？
-  │   ├─ 单文件 → [单文件编辑]
+  │   ├─ 知道放哪 → [单文件编辑]
+  │   ├─ 不知道放哪 → [暂存台路径] — 存到 Inbox/，之后再归类
   │   └─ 多文件或不确定 → [多文件路由] — 先出方案
   │
+  ├─ 整理暂存台 / 归类暂存文件？
+  │   └─ [暂存台整理] — 读 Inbox/ 文件，提议目标位置，获批后移动
+  │
   ├─ 结构变更（重命名 / 移动 / 删除 / 重组）？
   │   └─ [结构路径] — 变更前后检查反向链接
   │
@@ -101,6 +124,9 @@ npm install -g @geminilight/mindos
   ├─ 复盘 / 提炼 / 交接？
   │   └─ [复盘路径]
   │
+  ├─ 知识健康检查 / 检测冲突？
+  │   └─ [健康检查路径] — 读取 references/knowledge-health.md
+  │
   └─ 模糊？
       └─ 提问。基于知识库状态提出 2-3 个具体选项。
 ```
@@ -115,8 +141,9 @@ npm install -g @geminilight/mindos
 - "整理一下" → 先问：仅展示，还是写回知识库？
 
 **文件位置不确定：**
-- 5 秒内定不了 → 用最近的现有目录，告知用户
-- "随便放哪" → 收件箱，之后提议分类
+- 5 秒内定不了 → 存到 `Inbox/`，告知用户，之后提议归类
+- "随便放哪" / "先放着" → 存到 `Inbox/`
+- 用户拖拽文件或粘贴非结构化内容但没指定位置 → `Inbox/`
 
 **范围蔓延：**
 - 输入路由到 >5 个文件 → 暂停确认
@@ -149,6 +176,44 @@ npm install -g @geminilight/mindos
 
 创建/重写工作流 SOP 时 → 读取 [references/sop-template.md](./references/sop-template.md)。
 
+## 暂存台 (Inbox)
+
+`Inbox/` 目录是知识库的快速捕获区，有自己的 `INSTRUCTION.md` 约束行为。
+
+**何时使用暂存台：**
+- 用户说"先存着" / "放到暂存台" / "随便放哪"，没指定具体位置
+- 内容明显不属于任何现有空间或目录
+- 批量导入多个文件，需要逐个归类
+
+**如何存到暂存台：**
+```bash
+mindos file create "Inbox/<文件名>.md" --content "..."
+```
+
+**如何整理暂存台：**
+1. 列出暂存文件：`mindos file list Inbox/`
+2. 读取每个文件，理解其内容
+3. 根据知识库结构，为每个文件提议最佳目标目录
+4. 向用户展示完整路由方案，获批后执行
+5. 移动文件：`mindos file rename "Inbox/<文件>" "<目标目录>/<文件>"`
+6. 移动后检查目标目录的 README 是否需要更新
+
+**老化提醒：** Inbox 中超过 7 天的文件视为"老化"。如果在 bootstrap 时发现老化文件，主动提醒：
+"暂存台有 N 个文件已经放了一周以上了，要我帮你整理一下吗？"
+
+## 知识健康检查
+
+用户要求检查知识库健康度、检测冲突、审计质量，或说"知识健康检查" / "检测冲突" / "check knowledge health" 时
+→ 读取 [references/knowledge-health.md](./references/knowledge-health.md) 获取完整流程。
+
+检查维度速览：
+- **矛盾/冲突**：同一主题的不同文件说法互相矛盾
+- **断裂链接**：引用了不存在的文件
+- **过期内容**：带有过期日期标记的文件，或超过 6 个月未更新的活跃主题
+- **重复内容**：两个文件覆盖同一主题且没有互相引用
+- **孤立文件**：零反向链接，难以被发现
+- **结构问题**：文件放错目录、缺少 README、暂存台老化文件
+
 ---
 
 ## 错误处理（CLI）