@pencil-agent/nano-pencil 1.3.0 → 1.3.1

package/core/slash-commands.ts

@@ -24,6 +24,11 @@ export const BUILTIN_SLASH_COMMANDS: ReadonlyArray<BuiltinSlashCommand> = [
   },
   { name: "apikey", description: "Update API key for current provider" },
   { name: "mcp", description: "Manage MCP servers (list, enable, disable)" },
+  { name: "soul", description: "Show AI personality and stats (Soul)" },
+  {
+    name: "memory",
+    description: "Show project memory and knowledge (NanoMem)",
+  },
   { name: "export", description: "Export session to HTML file" },
   { name: "share", description: "Share session as a secret GitHub gist" },
   { name: "copy", description: "Copy last agent message to clipboard" },

package/modes/interactive/components/index.ts

@@ -25,6 +25,7 @@ export {
 export { LoginDialogComponent } from "./login-dialog.js";
 export { ModelSelectorComponent } from "./model-selector.js";
 export { OAuthSelectorComponent } from "./oauth-selector.js";
+export { PencilLoader } from "./pencil-loader.js";
 export { ProviderSelectorComponent } from "./provider-selector.js";
 export {
   type ModelsCallbacks,

package/modes/interactive/components/memory-stats.ts

@@ -0,0 +1,139 @@
+/**
+ * [INPUT]: NanoMem engine
+ * [OUTPUT]: Formatted display of memory stats
+ * [POS]: Interactive mode component for /memory command
+ */
+
+// Use any type for NanoMemEngine since it's a local package
+interface NanoMemEngine {
+  getStats(): {
+    knowledge: number;
+    lessons: number;
+    preferences: number;
+    facets: number;
+    work: number;
+    episodes: number;
+    totalSessions: number;
+  };
+}
+
+interface DisplayOptions {
+  compact?: boolean;
+}
+
+/**
+ * Format NanoMem stats for display
+ */
+export function formatMemoryStats(
+  memory: any,
+  options: DisplayOptions = {},
+): string {
+  if (options.compact) {
+    return formatCompactMemory(memory);
+  }
+
+  return formatFullMemory(memory);
+}
+
+/**
+ * Format compact memory stats (single line)
+ */
+function formatCompactMemory(memory: NanoMemEngine): string {
+  const stats = memory.getStats();
+
+  const totalMemories =
+    stats.knowledge +
+    stats.lessons +
+    stats.preferences +
+    stats.facets +
+    stats.episodes;
+
+  return `📚 Memory: ${totalMemories} 项 | Knowledge: ${stats.knowledge} | Lessons: ${stats.lessons} | Episodes: ${stats.episodes}`;
+}
+
+/**
+ * Format full memory stats (detailed view)
+ */
+function formatFullMemory(memory: NanoMemEngine): string {
+  const lines: string[] = [];
+
+  lines.push("╔═════════════════════════════════════════════════╗");
+  lines.push("║           📚 Project Memory - NanoMem                ║");
+  lines.push("╠═════════════════════════════════════════════════╣");
+  lines.push("║");
+
+  const stats = memory.getStats();
+
+  // Memory Types
+  const memoryTypes = [
+    { type: "knowledge", name: "知识", emoji: "📖", count: stats.knowledge },
+    { type: "lessons", name: "经验教训", emoji: "💡", count: stats.lessons },
+    {
+      type: "preferences",
+      name: "用户偏好",
+      emoji: "❤️",
+      count: stats.preferences,
+    },
+    { type: "facets", name: "模式/困境", emoji: "🧩", count: stats.facets },
+    { type: "work", name: "工作摘要", emoji: "📋", count: stats.work },
+    { type: "episodes", name: "会话记录", emoji: "📝", count: stats.episodes },
+  ];
+
+  lines.push("║ 📊 Memory Types");
+  lines.push("║ ────────────────────────────────────────────────");
+
+  for (const mem of memoryTypes) {
+    const bar = createBar(Math.min(mem.count / 100, 1), 15);
+    lines.push(
+      `║ ${mem.emoji} ${mem.name.padEnd(12)} ${bar} ${mem.count.toString().padStart(5)} 项`,
+    );
+  }
+
+  lines.push("║");
+  lines.push("║ 🔍 Recent Knowledge (Top 5)");
+  lines.push("║ ────────────────────────────────────────────────");
+
+  // Note: This would require loading actual entries
+  // For now, show stats only
+  lines.push(`║   (共 ${stats.knowledge} 条项目知识)`);
+  lines.push(`║   最近更新: ${stats.totalSessions > 0 ? "本次会话" : "无"}`);
+
+  lines.push("║");
+  lines.push("║ 💡 Lessons Learned");
+  lines.push("║ ────────────────────────────────────────────────");
+  lines.push(`║   (共 ${stats.lessons} 条经验教训)`);
+  lines.push(`   ⚠️  从错误中学习，避免重复犯错`);
+
+  lines.push("║");
+  lines.push("║ 🧩 Patterns & Struggles");
+  lines.push("║ ────────────────────────────────────────────────");
+  lines.push(`║   模式: ${stats.facets}  条`);
+  lines.push(`   困境: 已识别的行为模式`);
+
+  lines.push("║");
+  lines.push("║ 📝 Session History");
+  lines.push("║ ────────────────────────────────────────────────");
+  lines.push(`║   会话记录: ${stats.episodes} 条`);
+  lines.push(`   总会话数: ${stats.totalSessions}`);
+
+  lines.push("║");
+  lines.push("╚═════════════════════════════════════════════════╝");
+
+  return lines.join("\n");
+}
+
+/**
+ * Create a visual bar for counts
+ */
+function createBar(filled: number, width: number): string {
+  const intFilled = Math.floor(filled);
+  const partial = Math.floor((filled - intFilled) * 8);
+
+  let bar = "█".repeat(intFilled);
+  if (partial > 0) {
+    bar += "▓".repeat(1); // Partial fill
+  }
+  bar += "░".repeat(width - intFilled - (partial > 0 ? 1 : 0));
+
+  return bar;
+}

package/modes/interactive/components/pencil-loader.ts

@@ -0,0 +1,85 @@
+/**
+ * PencilLoader - Custom loader with ✎ breathing animation
+ * Replaces the default spinner with a pencil icon that pulses
+ */
+
+import { Container, Spacer, Text, type TUI } from "@mariozechner/pi-tui";
+import type { Theme } from "../theme/theme.js";
+
+export class PencilLoader extends Container {
+	private tui: TUI;
+	private theme: Theme;
+	private message: string;
+	private interval: NodeJS.Timeout | undefined;
+	private currentFrame = 0;
+	private textComponent: Text;
+	private messageComponent: Text;
+	private isStopped = false;
+
+	// Breathing animation frames - opacity levels for ✎
+	private readonly frames = [
+		"░", // very dim
+		"▒", // dim
+		"▓", // medium
+		"█", // bright
+		"▓", // medium
+		"▒", // dim
+	];
+
+	constructor(tui: TUI, theme: Theme, message: string) {
+		super();
+		this.tui = tui;
+		this.theme = theme;
+		this.message = message;
+
+		this.textComponent = new Text("", 0, 0);
+		this.messageComponent = new Text("", 0, 0);
+
+		this.addChild(new Spacer(1));
+		this.addChild(this.textComponent);
+		this.addChild(this.messageComponent);
+		this.addChild(new Spacer(1));
+
+		this.startAnimation();
+	}
+
+	private startAnimation(): void {
+		const updateFrame = () => {
+			if (this.isStopped) return;
+
+			const frameChar = this.frames[this.currentFrame];
+			const pencil = this.theme.fg("accent", `✎${frameChar}`);
+
+			this.textComponent.setText(`${pencil} ${this.message}`);
+			this.tui.requestRender();
+
+			this.currentFrame = (this.currentFrame + 1) % this.frames.length;
+		};
+
+		// Initial render
+		updateFrame();
+
+		// Update every 200ms for smooth breathing effect
+		this.interval = setInterval(updateFrame, 200);
+	}
+
+	setMessage(message: string): void {
+		this.message = message;
+		const frameChar = this.frames[this.currentFrame];
+		const pencil = this.theme.fg("accent", `✎${frameChar}`);
+		this.messageComponent.setText(`${pencil} ${this.message}`);
+		this.tui.requestRender();
+	}
+
+	stop(): void {
+		this.isStopped = true;
+		if (this.interval) {
+			clearInterval(this.interval);
+			this.interval = undefined;
+		}
+	}
+
+	dispose(): void {
+		this.stop();
+	}
+}

package/modes/interactive/components/soul-stats.ts

@@ -0,0 +1,193 @@
+/**
+ * [INPUT]: Soul profile and memory manager
+ * [OUTPUT]: Formatted display of Soul stats and personality
+ * [POS]: Interactive mode component for /soul command
+ */
+
+import type { SoulManager } from "nanosoul";
+
+interface DisplayOptions {
+  compact?: boolean;
+}
+
+/**
+ * Format Soul stats for display
+ */
+export function formatSoulStats(
+  soul: SoulManager,
+  options: DisplayOptions = {},
+): string {
+  const profile = soul.getProfile();
+  const stats = soul.getStats();
+
+  if (options.compact) {
+    return formatCompactSoul(profile, stats);
+  }
+
+  return formatFullSoul(profile, stats);
+}
+
+/**
+ * Format compact Soul stats (single line)
+ */
+function formatCompactSoul(profile: any, stats: any): string {
+  const personality = profile.personality;
+  const expertise = stats.expertise.slice(0, 3);
+
+  const topTraits = Object.entries(personality)
+    .filter(
+      ([_, value]) => typeof value === "number" && (value > 0.6 || value < 0.4),
+    )
+    .map(([key, value]) => {
+      const label = getTraitLabel(key);
+      const numValue = typeof value === "number" ? value : 0.5;
+      const status = numValue > 0.6 ? "↑" : numValue < 0.4 ? "↓" : "→";
+      return `${label}${status} ${(numValue * 100).toFixed(0)}%`;
+    })
+    .slice(0, 3)
+    .join(", ");
+
+  const topExpertise = expertise
+    .map((e: any) => `${e.domain}(${(e.confidence * 100).toFixed(0)}%)`)
+    .join(", ");
+
+  return `🧠 Soul: ${topTraits} | Expertise: ${topExpertise} | Interactions: ${stats.stats.totalInteractions}`;
+}
+
+/**
+ * Format full Soul stats (detailed view)
+ */
+function formatFullSoul(profile: any, stats: any): string {
+  const lines: string[] = [];
+
+  lines.push("╔═════════════════════════════════════════════════╗");
+  lines.push("║           🧠 AI Soul - Personality & Stats          ║");
+  lines.push("╠═════════════════════════════════════════════════╣");
+  lines.push("║");
+
+  // Personality Section
+  lines.push("║ 📊 Personality Traits");
+  lines.push("║ ────────────────────────────────────────────────");
+
+  const personality = profile.personality;
+  const traits = [
+    { key: "openness", label: "开放性", emoji: "🎨" },
+    { key: "conscientiousness", label: "尽责性", emoji: "📋" },
+    { key: "codeVerbosity", label: "代码冗长", emoji: "📝" },
+    { key: "abstractionLevel", label: "抽象层级", emoji: "🏗️" },
+    { key: "safetyMargin", label: "安全边际", emoji: "🛡️" },
+    { key: "explorationDrive", label: "探索欲望", emoji: "🔍" },
+  ];
+
+  for (const trait of traits) {
+    const value = personality[trait.key];
+    const bar = createBar(value, 10);
+    const percent = (value * 100).toFixed(0).padStart(3);
+    lines.push(`║ ${trait.emoji} ${trait.label.padEnd(12)} ${bar} ${percent}%`);
+  }
+
+  lines.push("║");
+  lines.push("║ 🎯 Top Expertise Areas");
+
+  const expertise = stats.expertise.slice(0, 5);
+  if (expertise.length === 0) {
+    lines.push("║   (暂无专长数据，继续使用以积累)");
+  } else {
+    for (const exp of expertise) {
+      const confidence = (exp.confidence * 100).toFixed(0).padStart(3);
+      const examples = exp.examples.toString().padStart(3);
+      lines.push(
+        `║   • ${exp.domain.padEnd(20)} 信心: ${confidence}%  成功: ${examples} 次`,
+      );
+    }
+  }
+
+  lines.push("║");
+  lines.push("║ 💭 Current Mood");
+
+  const emotional = profile.emotionalState;
+  const mood = [
+    { label: "信心", value: emotional.confidence, emoji: "😊" },
+    { label: "好奇心", value: emotional.curiosity, emoji: "🤔" },
+    { label: "挫败感", value: emotional.frustration, emoji: "😤" },
+    { label: "心流", value: emotional.flow, emoji: "✨" },
+  ];
+
+  for (const m of mood) {
+    const bar = createBar(m.value, 8);
+    const percent = (m.value * 100).toFixed(0).padStart(3);
+    lines.push(`║   ${m.emoji} ${m.label.padEnd(8)} ${bar} ${percent}%`);
+  }
+
+  lines.push("║");
+  lines.push("║ 📈 Development Stats");
+  lines.push("║ ────────────────────────────────────────────────");
+  lines.push(`║   总交互次数: ${stats.stats.totalInteractions}`);
+  lines.push(`║   成功率: ${(stats.stats.successRate * 100).toFixed(1)}%`);
+  lines.push(`║   Soul 版本: ${profile.version}`);
+  lines.push(
+    `║   Soul 年龄: ${Math.floor((Date.now() - profile.createdAt.getTime()) / (1000 * 60 * 60 * 24))} 天`,
+  );
+  lines.push(`║   最后进化: ${formatTimeAgo(profile.lastEvolved)}`);
+
+  lines.push("║");
+  lines.push("║ 🧘 User Relationship");
+  lines.push("║ ────────────────────────────────────────────────");
+  const rel = profile.userRelationship;
+  lines.push(`║   交互次数: ${rel.interactionCount}`);
+  lines.push(`║   满意度: ${(rel.satisfactionScore * 100).toFixed(0)}%`);
+  lines.push(`   沟通风格: ${rel.communicationStyle}`);
+
+  if (rel.knownPreferences.length > 0) {
+    lines.push(`║   已知偏好: ${rel.knownPreferences.slice(0, 3).join(", ")}`);
+  }
+
+  lines.push("║");
+  lines.push("╚═════════════════════════════════════════════════╝");
+
+  return lines.join("\n");
+}
+
+/**
+ * Create a visual bar for values
+ */
+function createBar(value: number, width: number): string {
+  const filled = Math.round(value * width);
+  const empty = width - filled;
+  return "█".repeat(filled) + "░".repeat(empty);
+}
+
+/**
+ * Get trait label in Chinese
+ */
+function getTraitLabel(key: string): string {
+  const labels: Record<string, string> = {
+    openness: "开放性",
+    conscientiousness: "尽责性",
+    extraversion: "外向性",
+    agreeableness: "宜人性",
+    neuroticism: "神经质",
+    codeVerbosity: "代码冗长",
+    abstractionLevel: "抽象层级",
+    safetyMargin: "安全边际",
+    explorationDrive: "探索",
+  };
+  return labels[key] || key;
+}
+
+/**
+ * Format time ago in Chinese
+ */
+function formatTimeAgo(date: Date): string {
+  const now = Date.now();
+  const diff = now - date.getTime();
+
+  const minutes = Math.floor(diff / (1000 * 60));
+  const hours = Math.floor(diff / (1000 * 60 * 60));
+  const days = Math.floor(diff / (1000 * 60 * 60 * 24));
+
+  if (minutes < 1) return "刚刚";
+  if (minutes < 60) return `${minutes} 分钟前`;
+  if (hours < 24) return `${hours} 小时前`;
+  return `${days} 天前`;
+}

package/modes/interactive/interactive-mode.ts

@@ -95,6 +95,7 @@ import { promptForApiKey } from "./components/apikey-input.js";
 import { BashExecutionComponent } from "./components/bash-execution.js";
 import { BorderedLoader } from "./components/bordered-loader.js";
 import { BranchSummaryMessageComponent } from "./components/branch-summary-message.js";
+import { PencilLoader } from "./components/pencil-loader.js";
 import { CompactionSummaryMessageComponent } from "./components/compaction-summary-message.js";
 import { CustomEditor } from "./components/custom-editor.js";
 import { CustomMessageComponent } from "./components/custom-message.js";
@@ -193,7 +194,7 @@ export class InteractiveMode {
   private version: string;
   private isInitialized = false;
   private onInputCallback?: (text: string) => void;
-  private loadingAnimation: Loader | undefined = undefined;
+  private loadingAnimation: Component | undefined = undefined;
   private pendingWorkingMessage: string | undefined = undefined;
   private readonly defaultWorkingMessage = "Working...";
 
@@ -233,11 +234,11 @@ export class InteractiveMode {
   private pendingBashComponents: BashExecutionComponent[] = [];
 
   // Auto-compaction state
-  private autoCompactionLoader: Loader | undefined = undefined;
+  private autoCompactionLoader: Component | undefined = undefined;
   private autoCompactionEscapeHandler?: () => void;
 
   // Auto-retry state
-  private retryLoader: Loader | undefined = undefined;
+  private retryLoader: Component | undefined = undefined;
   private retryEscapeHandler?: () => void;
 
   // Messages queued while compaction is running
@@ -1153,7 +1154,7 @@ export class InteractiveMode {
         waitForIdle: () => this.session.agent.waitForIdle(),
         newSession: async (options) => {
           if (this.loadingAnimation) {
-            this.loadingAnimation.stop();
+            (this.loadingAnimation as PencilLoader).stop();
             this.loadingAnimation = undefined;
           }
           this.statusContainer.clear();
@@ -1439,7 +1440,7 @@ export class InteractiveMode {
     this.defaultEditor.onExtensionShortcut = undefined;
     this.updateTerminalTitle();
     if (this.loadingAnimation) {
-      this.loadingAnimation.setMessage(
+      (this.loadingAnimation as PencilLoader).setMessage(
         `${this.defaultWorkingMessage} (${appKey(this.keybindings, "interrupt")} to interrupt)`,
       );
     }
@@ -1606,9 +1607,9 @@ export class InteractiveMode {
       setWorkingMessage: (message) => {
         if (this.loadingAnimation) {
           if (message) {
-            this.loadingAnimation.setMessage(message);
+            (this.loadingAnimation as PencilLoader).setMessage(message);
           } else {
-            this.loadingAnimation.setMessage(
+            (this.loadingAnimation as PencilLoader).setMessage(
               `${this.defaultWorkingMessage} (${appKey(this.keybindings, "interrupt")} to interrupt)`,
             );
           }
@@ -2237,6 +2238,16 @@ export class InteractiveMode {
         await this.handleReloadCommand();
         return;
       }
+      if (text === "/soul") {
+        this.handleSoulCommand();
+        this.editor.setText("");
+        return;
+      }
+      if (text === "/memory") {
+        this.handleMemoryCommand();
+        this.editor.setText("");
+        return;
+      }
       if (text === "/debug") {
         this.handleDebugCommand();
         this.editor.setText("");
@@ -2349,24 +2360,25 @@ export class InteractiveMode {
           this.retryEscapeHandler = undefined;
         }
         if (this.retryLoader) {
-          this.retryLoader.stop();
+          (this.retryLoader as PencilLoader).stop();
           this.retryLoader = undefined;
         }
         if (this.loadingAnimation) {
-          this.loadingAnimation.stop();
+          (this.loadingAnimation as PencilLoader).stop();
         }
         this.statusContainer.clear();
-        this.loadingAnimation = new Loader(
+        this.loadingAnimation = new PencilLoader(
           this.ui,
-          (spinner) => theme.fg("accent", spinner),
-          (text) => theme.fg("muted", text),
+          theme,
           this.defaultWorkingMessage,
         );
         this.statusContainer.addChild(this.loadingAnimation);
         // Apply any pending working message queued before loader existed
         if (this.pendingWorkingMessage !== undefined) {
           if (this.pendingWorkingMessage) {
-            this.loadingAnimation.setMessage(this.pendingWorkingMessage);
+            (this.loadingAnimation as PencilLoader).setMessage(
+              this.pendingWorkingMessage,
+            );
           }
           this.pendingWorkingMessage = undefined;
         }
@@ -2512,7 +2524,7 @@ export class InteractiveMode {
 
       case "agent_end":
         if (this.loadingAnimation) {
-          this.loadingAnimation.stop();
+          (this.loadingAnimation as PencilLoader).stop();
           this.loadingAnimation = undefined;
           this.statusContainer.clear();
         }
@@ -2539,10 +2551,9 @@ export class InteractiveMode {
         this.statusContainer.clear();
         const reasonText =
           event.reason === "overflow" ? "Context overflow detected, " : "";
-        this.autoCompactionLoader = new Loader(
+        this.autoCompactionLoader = new PencilLoader(
           this.ui,
-          (spinner) => theme.fg("accent", spinner),
-          (text) => theme.fg("muted", text),
+          theme,
           `${reasonText}Auto-compacting... (${appKey(this.keybindings, "interrupt")} to cancel)`,
         );
         this.statusContainer.addChild(this.autoCompactionLoader);
@@ -2558,7 +2569,7 @@ export class InteractiveMode {
         }
         // Stop loader
         if (this.autoCompactionLoader) {
-          this.autoCompactionLoader.stop();
+          (this.autoCompactionLoader as PencilLoader).stop();
           this.autoCompactionLoader = undefined;
           this.statusContainer.clear();
         }
@@ -2598,10 +2609,9 @@ export class InteractiveMode {
         // Show retry indicator
         this.statusContainer.clear();
         const delaySeconds = Math.round(event.delayMs / 1000);
-        this.retryLoader = new Loader(
+        this.retryLoader = new PencilLoader(
           this.ui,
-          (spinner) => theme.fg("warning", spinner),
-          (text) => theme.fg("muted", text),
+          theme,
           `Retrying (${event.attempt}/${event.maxAttempts}) in ${delaySeconds}s... (${appKey(this.keybindings, "interrupt")} to cancel)`,
         );
         this.statusContainer.addChild(this.retryLoader);
@@ -2617,7 +2627,7 @@ export class InteractiveMode {
         }
         // Stop loader
         if (this.retryLoader) {
-          this.retryLoader.stop();
+          (this.retryLoader as PencilLoader).stop();
           this.retryLoader = undefined;
           this.statusContainer.clear();
         }
@@ -4033,7 +4043,7 @@ export class InteractiveMode {
           }
 
           // Set up escape handler and loader if summarizing
-          let summaryLoader: Loader | undefined;
+          let summaryLoader: Component | undefined;
           const originalOnEscape = this.defaultEditor.onEscape;
 
           if (wantsSummary) {
@@ -4041,10 +4051,9 @@ export class InteractiveMode {
               this.session.abortBranchSummary();
             };
             this.chatContainer.addChild(new Spacer(1));
-            summaryLoader = new Loader(
+            summaryLoader = new PencilLoader(
               this.ui,
-              (spinner) => theme.fg("accent", spinner),
-              (text) => theme.fg("muted", text),
+              theme,
               `Summarizing branch... (${appKey(this.keybindings, "interrupt")} to cancel)`,
             );
             this.statusContainer.addChild(summaryLoader);
@@ -4081,7 +4090,7 @@ export class InteractiveMode {
             );
           } finally {
             if (summaryLoader) {
-              summaryLoader.stop();
+              (summaryLoader as PencilLoader).stop();
               this.statusContainer.clear();
             }
             this.defaultEditor.onEscape = originalOnEscape;
@@ -4146,7 +4155,7 @@ export class InteractiveMode {
   private async handleResumeSession(sessionPath: string): Promise<void> {
     // Stop loading animation
     if (this.loadingAnimation) {
-      this.loadingAnimation.stop();
+      (this.loadingAnimation as PencilLoader).stop();
       this.loadingAnimation = undefined;
     }
     this.statusContainer.clear();
@@ -4794,7 +4803,7 @@ export class InteractiveMode {
   private async handleClearCommand(): Promise<void> {
     // Stop loading animation
     if (this.loadingAnimation) {
-      this.loadingAnimation.stop();
+      (this.loadingAnimation as PencilLoader).stop();
       this.loadingAnimation = undefined;
     }
     this.statusContainer.clear();
@@ -5011,7 +5020,7 @@ export class InteractiveMode {
   ): Promise<CompactionResult | undefined> {
     // Stop loading animation
     if (this.loadingAnimation) {
-      this.loadingAnimation.stop();
+      (this.loadingAnimation as PencilLoader).stop();
       this.loadingAnimation = undefined;
     }
     this.statusContainer.clear();
@@ -5028,12 +5037,7 @@ export class InteractiveMode {
     const label = isAuto
       ? `Auto-compacting context... ${cancelHint}`
       : `Compacting context... ${cancelHint}`;
-    const compactingLoader = new Loader(
-      this.ui,
-      (spinner) => theme.fg("accent", spinner),
-      (text) => theme.fg("muted", text),
-      label,
-    );
+    const compactingLoader = new PencilLoader(this.ui, theme, label);
     this.statusContainer.addChild(compactingLoader);
     this.ui.requestRender();
 
@@ -5065,7 +5069,7 @@ export class InteractiveMode {
         this.showError(`Compaction failed: ${message}`);
       }
     } finally {
-      compactingLoader.stop();
+      (compactingLoader as PencilLoader).stop();
       this.statusContainer.clear();
       this.defaultEditor.onEscape = originalOnEscape;
     }
@@ -5075,7 +5079,7 @@ export class InteractiveMode {
 
   stop(): void {
     if (this.loadingAnimation) {
-      this.loadingAnimation.stop();
+      (this.loadingAnimation as PencilLoader).stop();
       this.loadingAnimation = undefined;
     }
     this.clearExtensionTerminalInputListeners();
@@ -5089,4 +5093,56 @@ export class InteractiveMode {
       this.isInitialized = false;
     }
   }
+
+  private handleSoulCommand(): void {
+    const soulManager = (this.session as any)._soulManager;
+    if (!soulManager) {
+      this.chatContainer.addChild(new Spacer(1));
+      this.chatContainer.addChild(
+        new Text(theme.fg("warning", "⚠️  Soul 未启用"), 1, 0),
+      );
+      this.chatContainer.addChild(
+        new Text(
+          theme.fg(
+            "dim",
+            "Soul (AI 性格系统) 未启用。请确保使用 NanoPencil 1.3.0 或更高版本。",
+          ),
+          1,
+          0,
+        ),
+      );
+      this.ui.requestRender();
+      return;
+    }
+
+    const { formatSoulStats } = require("./components/soul-stats.js");
+    const stats = formatSoulStats(soulManager, { compact: false });
+
+    this.chatContainer.addChild(new Spacer(1));
+    this.chatContainer.addChild(new Text(stats, 1, 0));
+    this.ui.requestRender();
+  }
+
+  private handleMemoryCommand(): void {
+    const lines: string[] = [];
+    lines.push(theme.fg("accent", "📚 Project Memory - NanoMem"));
+    lines.push("");
+    lines.push(theme.fg("dim", "存储位置: ~/.nanopencil/agent/memory/"));
+    lines.push(theme.fg("dim", "  - knowledge.json  (项目知识)"));
+    lines.push(theme.fg("dim", "  - lessons.json    (经验教训)"));
+    lines.push(theme.fg("dim", "  - preferences.json (用户偏好)"));
+    lines.push(theme.fg("dim", "  - patterns.json    (行为模式)"));
+    lines.push(theme.fg("dim", "  - facets.json     (模式/困境)"));
+    lines.push("");
+    lines.push(
+      theme.fg("dim", "💡 提示: NanoMem 自动从对话中提取和记忆项目知识"),
+    );
+    lines.push(theme.fg("dim", "   - 记住 API 端点、配置选项"));
+    lines.push(theme.fg("dim", "   - 学习错误模式和解决方案"));
+    lines.push(theme.fg("dim", "   - 识别用户偏好和编码风格"));
+
+    this.chatContainer.addChild(new Spacer(1));
+    this.chatContainer.addChild(new Text(lines.join("\n"), 1, 0));
+    this.ui.requestRender();
+  }
 }

package/modes/interactive/theme/warm.json

@@ -1,81 +1,81 @@
-{
-	"$schema": "https://raw.githubusercontent.com/badlogic/pi-mono/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
-	"name": "warm",
-	"vars": {
-		"warmBrown": "#c4a574",
-		"warmLight": "#d4a574",
-		"warmBorder": "#a08060",
-		"blue": "#5f87ff",
-		"green": "#b5bd68",
-		"red": "#cc6666",
-		"yellow": "#d4a84b",
-		"gray": "#808080",
-		"dimGray": "#666666",
-		"darkGray": "#505050",
-		"accent": "warmBrown",
-		"selectedBg": "#3d362a",
-		"userMsgBg": "#2e2a24",
-		"toolPendingBg": "#2a2820",
-		"toolSuccessBg": "#2a3024",
-		"toolErrorBg": "#3c2828",
-		"customMsgBg": "#2d2838"
-	},
-	"colors": {
-		"accent": "accent",
-		"border": "warmBorder",
-		"borderAccent": "warmLight",
-		"borderMuted": "darkGray",
-		"success": "green",
-		"error": "red",
-		"warning": "yellow",
-		"muted": "gray",
-		"dim": "dimGray",
-		"text": "",
-		"thinkingText": "gray",
-		"selectedBg": "selectedBg",
-		"userMessageBg": "userMsgBg",
-		"userMessageText": "",
-		"customMessageBg": "customMsgBg",
-		"customMessageText": "",
-		"customMessageLabel": "#b8956b",
-		"toolPendingBg": "toolPendingBg",
-		"toolSuccessBg": "toolSuccessBg",
-		"toolErrorBg": "toolErrorBg",
-		"toolTitle": "",
-		"toolOutput": "gray",
-		"mdHeading": "warmLight",
-		"mdLink": "#81a2be",
-		"mdLinkUrl": "dimGray",
-		"mdCode": "accent",
-		"mdCodeBlock": "green",
-		"mdCodeBlockBorder": "gray",
-		"mdQuote": "gray",
-		"mdQuoteBorder": "gray",
-		"mdHr": "gray",
-		"mdListBullet": "accent",
-		"toolDiffAdded": "green",
-		"toolDiffRemoved": "red",
-		"toolDiffContext": "gray",
-		"syntaxComment": "#6A9955",
-		"syntaxKeyword": "#569CD6",
-		"syntaxFunction": "#DCDCAA",
-		"syntaxVariable": "#9CDCFE",
-		"syntaxString": "#CE9178",
-		"syntaxNumber": "#B5CEA8",
-		"syntaxType": "#4EC9B0",
-		"syntaxOperator": "#D4D4D4",
-		"syntaxPunctuation": "#D4D4D4",
-		"thinkingOff": "darkGray",
-		"thinkingMinimal": "#6e6e6e",
-		"thinkingLow": "#5f87af",
-		"thinkingMedium": "warmBrown",
-		"thinkingHigh": "#b294bb",
-		"thinkingXhigh": "#d183e8",
-		"bashMode": "green"
-	},
-	"export": {
-		"pageBg": "#1a1814",
-		"cardBg": "#242018",
-		"infoBg": "#3c3728"
-	}
-}
+{
+  "$schema": "https://raw.githubusercontent.com/badlogic/pi-mono/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "name": "warm",
+  "vars": {
+    "warmBrown": "#c4a574",
+    "warmLight": "#d4a574",
+    "warmBorder": "#a08060",
+    "blue": "#5f87ff",
+    "green": "#b5bd68",
+    "red": "#cc6666",
+    "yellow": "#d4a84b",
+    "gray": "#808080",
+    "dimGray": "#666666",
+    "darkGray": "#505050",
+    "accent": "warmBrown",
+    "selectedBg": "#3d362a",
+    "userMsgBg": "#2e2a24",
+    "toolPendingBg": "#2a2820",
+    "toolSuccessBg": "#2a3024",
+    "toolErrorBg": "#3c2828",
+    "customMsgBg": "#2d2838"
+  },
+  "colors": {
+    "accent": "accent",
+    "border": "warmBorder",
+    "borderAccent": "warmLight",
+    "borderMuted": "darkGray",
+    "success": "green",
+    "error": "red",
+    "warning": "yellow",
+    "muted": "gray",
+    "dim": "dimGray",
+    "text": "",
+    "thinkingText": "gray",
+    "selectedBg": "selectedBg",
+    "userMessageBg": "userMsgBg",
+    "userMessageText": "warmLight",
+    "customMessageBg": "customMsgBg",
+    "customMessageText": "",
+    "customMessageLabel": "#b8956b",
+    "toolPendingBg": "toolPendingBg",
+    "toolSuccessBg": "toolSuccessBg",
+    "toolErrorBg": "toolErrorBg",
+    "toolTitle": "",
+    "toolOutput": "gray",
+    "mdHeading": "warmLight",
+    "mdLink": "#81a2be",
+    "mdLinkUrl": "dimGray",
+    "mdCode": "accent",
+    "mdCodeBlock": "green",
+    "mdCodeBlockBorder": "gray",
+    "mdQuote": "gray",
+    "mdQuoteBorder": "gray",
+    "mdHr": "gray",
+    "mdListBullet": "accent",
+    "toolDiffAdded": "green",
+    "toolDiffRemoved": "red",
+    "toolDiffContext": "gray",
+    "syntaxComment": "#6A9955",
+    "syntaxKeyword": "#569CD6",
+    "syntaxFunction": "#DCDCAA",
+    "syntaxVariable": "#9CDCFE",
+    "syntaxString": "#CE9178",
+    "syntaxNumber": "#B5CEA8",
+    "syntaxType": "#4EC9B0",
+    "syntaxOperator": "#D4D4D4",
+    "syntaxPunctuation": "#D4D4D4",
+    "thinkingOff": "darkGray",
+    "thinkingMinimal": "#6e6e6e",
+    "thinkingLow": "#5f87af",
+    "thinkingMedium": "warmBrown",
+    "thinkingHigh": "#b294bb",
+    "thinkingXhigh": "#d183e8",
+    "bashMode": "green"
+  },
+  "export": {
+    "pageBg": "#1a1814",
+    "cardBg": "#242018",
+    "infoBg": "#3c3728"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pencil-agent/nano-pencil",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "CLI writing agent with read, bash, edit, write tools and session management. Based on pi; supports DashScope Coding Plan. Soul enabled by default for AI personality evolution.",
   "type": "module",
   "bin": {