@pencil-agent/nano-pencil 1.11.7 → 1.11.9

package/dist/cli/args.d.ts

@@ -5,6 +5,7 @@ import type { ThinkingLevel } from "@pencil-agent/agent-core";
 import { type ToolName } from "../core/tools/index.js";
 export type Mode = "text" | "json" | "rpc";
 export interface Args {
+    cwd?: string;
     provider?: string;
     model?: string;
     apiKey?: string;

package/dist/cli/args.js

@@ -37,6 +37,9 @@ export function parseArgs(args, extensionFlags) {
         else if (arg === "--provider" && i + 1 < args.length) {
             result.provider = args[++i];
         }
+        else if (arg === "--cwd" && i + 1 < args.length) {
+            result.cwd = args[++i];
+        }
         else if (arg === "--model" && i + 1 < args.length) {
             result.model = args[++i];
         }
@@ -182,8 +185,9 @@ ${chalk.bold("Commands:")}
   ${APP_NAME} <command> --help         Show help for install/remove/update/list
 
 ${chalk.bold("Options:")}
-  --provider <name>              Provider name (default: google)
-  --model <pattern>              Model pattern or ID (supports "provider/id" and optional ":<thinking>")
+  --provider <name>              Provider name (default: google)
+  --cwd <dir>                    Working directory to use for project-local discovery
+  --model <pattern>              Model pattern or ID (supports "provider/id" and optional ":<thinking>")
   --api-key <key>                API key (defaults to env vars)
   --system-prompt <text>         System prompt (default: coding assistant prompt)
   --append-system-prompt <text>  Append text or file contents to the system prompt
@@ -287,12 +291,13 @@ ${chalk.bold("Environment Variables:")}
   MINIMAX_API_KEY                  - MiniMax API key
   KIMI_API_KEY                     - Kimi For Coding API key
   AWS_PROFILE                      - AWS profile for Amazon Bedrock
-  AWS_ACCESS_KEY_ID                - AWS access key for Amazon Bedrock
-  AWS_SECRET_ACCESS_KEY            - AWS secret key for Amazon Bedrock
-  AWS_BEARER_TOKEN_BEDROCK         - Bedrock API key (bearer token)
-  AWS_REGION                       - AWS region for Amazon Bedrock (e.g., us-east-1)
-  ${ENV_AGENT_DIR.padEnd(32)} - Session storage directory (default: ~/${CONFIG_DIR_NAME}/agent)
-  PI_PACKAGE_DIR                   - Override package directory (for Nix/Guix store paths)
+  AWS_ACCESS_KEY_ID                - AWS access key for Amazon Bedrock
+  AWS_SECRET_ACCESS_KEY            - AWS secret key for Amazon Bedrock
+  AWS_BEARER_TOKEN_BEDROCK         - Bedrock API key (bearer token)
+  AWS_REGION                       - AWS region for Amazon Bedrock (e.g., us-east-1)
+  ${`${APP_NAME.toUpperCase()}_CWD`.padEnd(32)} - Working directory override for project-local discovery
+  ${ENV_AGENT_DIR.padEnd(32)} - Session storage directory (default: ~/${CONFIG_DIR_NAME}/agent)
+  PI_PACKAGE_DIR                   - Override package directory (for Nix/Guix store paths)
   PI_OFFLINE                       - Disable startup network operations when set to 1/true/yes
   PI_TOOLS_DOWNLOAD_TIMEOUT_MS     - Timeout in ms for downloading fd/ripgrep (default: 60000)
   PI_SHARE_VIEWER_URL              - Base URL for /share command (default: https://pi.dev/session/)

package/dist/core/extensions/loader.js

@@ -107,6 +107,7 @@ export function createExtensionRuntime() {
  */
 function createExtensionAPI(extension, runtime, cwd, eventBus) {
     const api = {
+        cwd,
         // Registration methods - write to extension
         on(event, handler) {
             const list = extension.handlers.get(event) ?? [];

package/dist/core/extensions/runner.js

@@ -115,10 +115,10 @@ export class ExtensionRunner {
         this.sessionManager = sessionManager;
         this.modelRegistry = modelRegistry;
     }
-    async withTimeout(promise, timeoutMs) {
+    async withTimeout(valueOrPromise, timeoutMs) {
         return new Promise((resolve) => {
             const timer = setTimeout(() => resolve(this.beforeAgentStartTimeoutSentinel), timeoutMs);
-            promise
+            Promise.resolve(valueOrPromise)
                 .then((value) => {
                 clearTimeout(timer);
                 resolve(value);

package/dist/core/extensions/types.d.ts

@@ -649,6 +649,8 @@ export type ExtensionHandler<E, R = undefined> = (event: E, ctx: ExtensionContex
  * ExtensionAPI passed to extension factory functions.
  */
 export interface ExtensionAPI {
+    /** Working directory resolved for this extension load */
+    cwd: string;
     on(event: "resources_discover", handler: ExtensionHandler<ResourcesDiscoverEvent, ResourcesDiscoverResult>): void;
     on(event: "session_start", handler: ExtensionHandler<SessionStartEvent>): void;
     on(event: "session_before_switch", handler: ExtensionHandler<SessionBeforeSwitchEvent, SessionBeforeSwitchResult>): void;

package/dist/core/footer-data-provider.d.ts

@@ -8,7 +8,8 @@ export declare class FooterDataProvider {
     private gitWatcher;
     private branchChangeCallbacks;
     private availableProviderCount;
-    constructor();
+    private cwd;
+    constructor(cwd: string);
     /** Current git branch, null if not in repo, "detached" if detached HEAD */
     getGitBranch(): string | null;
     /** Extension status texts set via ctx.ui.setStatus() */

package/dist/core/footer-data-provider.js

@@ -4,8 +4,8 @@ import { dirname, join, resolve } from "path";
  * Find the git HEAD path by walking up from cwd.
  * Handles both regular git repos (.git is a directory) and worktrees (.git is a file).
  */
-function findGitHeadPath() {
-    let dir = process.cwd();
+function findGitHeadPath(cwd) {
+    let dir = cwd;
     while (true) {
         const gitPath = join(dir, ".git");
         if (existsSync(gitPath)) {
@@ -46,7 +46,9 @@ export class FooterDataProvider {
     gitWatcher = null;
     branchChangeCallbacks = new Set();
     availableProviderCount = 0;
-    constructor() {
+    cwd;
+    constructor(cwd) {
+        this.cwd = cwd;
         this.setupGitWatcher();
     }
     /** Current git branch, null if not in repo, "detached" if detached HEAD */
@@ -54,7 +56,7 @@ export class FooterDataProvider {
         if (this.cachedBranch !== undefined)
             return this.cachedBranch;
         try {
-            const gitHeadPath = findGitHeadPath();
+            const gitHeadPath = findGitHeadPath(this.cwd);
             if (!gitHeadPath) {
                 this.cachedBranch = null;
                 return null;
@@ -110,7 +112,7 @@ export class FooterDataProvider {
             this.gitWatcher.close();
             this.gitWatcher = null;
         }
-        const gitHeadPath = findGitHeadPath();
+        const gitHeadPath = findGitHeadPath(this.cwd);
         if (!gitHeadPath)
             return;
         // Watch the directory containing HEAD, not HEAD itself.
@@ -125,6 +127,12 @@ export class FooterDataProvider {
                         cb();
                 }
             });
+            this.gitWatcher.on("error", () => {
+                if (this.gitWatcher) {
+                    this.gitWatcher.close();
+                    this.gitWatcher = null;
+                }
+            });
         }
         catch {
             // Silently fail if we can't watch

package/dist/core/runtime/agent-session.d.ts

@@ -210,6 +210,7 @@ export declare class AgentSession {
     get compactionCoordinator(): CompactionCoordinator | undefined;
     /** Model registry for API key resolution and model discovery */
     get modelRegistry(): ModelRegistry;
+    get cwd(): string;
     /** Emit an event to all listeners */
     private _emit;
     private _lastAssistantMessage;

package/dist/core/runtime/agent-session.js

@@ -216,6 +216,9 @@ export class AgentSession {
     get modelRegistry() {
         return this._modelRegistry;
     }
+    get cwd() {
+        return this._cwd;
+    }
     // =========================================================================
     // Event Subscription
     // =========================================================================
@@ -2048,7 +2051,7 @@ export class AgentSession {
         const resolvedCommand = prefix ? `${prefix}\n${command}` : command;
         try {
             const result = options?.operations
-                ? await executeBashWithOperations(resolvedCommand, process.cwd(), options.operations, {
+                ? await executeBashWithOperations(resolvedCommand, this._cwd, options.operations, {
                     onChunk,
                     signal: this._bashAbortController.signal,
                 })

package/dist/core/runtime/sdk.js

@@ -240,6 +240,7 @@ export async function createAgentSession(options = {}) {
     if (options.enableMCP) {
         try {
             currentMcpManager = new MCPManager();
+            currentMcpManager.setWorkingDir(cwd);
             await currentMcpManager.initialize();
             initialMcpTools = [...currentMcpManager.getTools()];
             time("mcp.initialize");
@@ -282,6 +283,7 @@ export async function createAgentSession(options = {}) {
                 // ignore
             }
             currentMcpManager = new MCPManager();
+            currentMcpManager.setWorkingDir(cwd);
             await currentMcpManager.initialize();
             time("mcp.initialize");
             return currentMcpManager.getTools();

package/dist/extensions/defaults/loop/index.js

@@ -175,7 +175,49 @@ function extractLoopDecision(text) {
         };
     }
     catch {
-        return undefined;
+        const lines = payload
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter(Boolean);
+        if (lines.length === 0) {
+            return undefined;
+        }
+        const getValue = (...prefixes) => {
+            const line = lines.find((entry) => prefixes.some((prefix) => entry.toLowerCase().startsWith(prefix.toLowerCase())));
+            if (!line) {
+                return undefined;
+            }
+            const separatorIndex = line.indexOf(":");
+            if (separatorIndex === -1) {
+                return undefined;
+            }
+            return line.slice(separatorIndex + 1).trim();
+        };
+        const rawStatus = getValue("status:", "状态:");
+        const normalizedStatus = rawStatus === "complete" || rawStatus === "完成"
+            ? "complete"
+            : rawStatus === "continue" || rawStatus === "继续" || rawStatus === "in_progress"
+                ? "continue"
+                : rawStatus === "blocked" || rawStatus === "阻塞"
+                    ? "blocked"
+                    : undefined;
+        if (!normalizedStatus) {
+            return undefined;
+        }
+        const summary = getValue("summary:", "摘要:", "已完成工作:", "completed work:") ??
+            lines.filter((line) => !line.startsWith("-")).slice(1).join(" ").trim();
+        if (!summary) {
+            return undefined;
+        }
+        const nextStep = getValue("next step:", "下一步:");
+        if (normalizedStatus === "continue" && !nextStep) {
+            return undefined;
+        }
+        return {
+            status: normalizedStatus,
+            summary,
+            nextStep,
+        };
     }
 }
 function describeDecision(decision) {

package/dist/extensions/defaults/mcp/index.js

@@ -19,6 +19,7 @@ export default async function mcpExtension(pi) {
     console.log("[mcp] Initializing MCP...");
     try {
         mcpManager = new MCPManager();
+        mcpManager.setWorkingDir(pi.cwd);
         await mcpManager.initialize();
         const mcpTools = mcpManager.getTools();
         // Register MCP tools

package/dist/main.js

@@ -6,7 +6,7 @@
  */
 import { modelsAreEqual, supportsXhigh } from "@pencil-agent/ai";
 import chalk from "chalk";
-import { join } from "path";
+import { join, resolve } from "path";
 import { createInterface } from "readline";
 import { parseArgs, printHelp } from "./cli/args.js";
 import { selectConfig } from "./cli/config-selector.js";
@@ -87,6 +87,11 @@ function isTruthyEnvFlag(value) {
         return false;
     return value === "1" || value.toLowerCase() === "true" || value.toLowerCase() === "yes";
 }
+function resolveWorkingDirectory(parsedCwd) {
+    const envCwd = process.env[`${APP_NAME.toUpperCase()}_CWD`];
+    const requestedCwd = parsedCwd || envCwd;
+    return requestedCwd ? resolve(requestedCwd) : process.cwd();
+}
 function getPackageCommandUsage(command) {
     switch (command) {
         case "install":
@@ -491,11 +496,10 @@ export async function main(args) {
         return;
     }
     // Run migrations (pass cwd for project-local migrations)
-    const { migratedAuthProviders: migratedProviders, deprecationWarnings } = runMigrations(process.cwd());
-    // First pass: parse args to get --extension paths
     const firstPass = parseArgs(args);
+    const cwd = resolveWorkingDirectory(firstPass.cwd);
+    const { migratedAuthProviders: migratedProviders, deprecationWarnings } = runMigrations(cwd);
     // Early load extensions to discover their CLI flags
-    const cwd = process.cwd();
     const agentDir = getAgentDir();
     const settingsManager = SettingsManager.create(cwd, agentDir);
     reportSettingsErrors(settingsManager, "startup");
@@ -574,6 +578,7 @@ export async function main(args) {
     }
     // Second pass: parse args with extension flags
     const parsed = parseArgs(args, extensionFlags);
+    const parsedCwd = resolveWorkingDirectory(parsed.cwd);
     // Pass flag values to extensions via runtime
     for (const [name, value] of parsed.unknownFlags) {
         extensionsResult.runtime.flagValues.set(name, value);
@@ -637,12 +642,12 @@ export async function main(args) {
         scopedModels = await resolveModelScope(modelPatterns, modelRegistry);
     }
     // Create session manager based on CLI flags
-    let sessionManager = await createSessionManager(parsed, cwd);
+    let sessionManager = await createSessionManager(parsed, parsedCwd);
     // Handle --resume: show session picker
     if (parsed.resume) {
         // Initialize keybindings so session picker respects user config
         KeybindingsManager.create();
-        const selectedPath = await selectSession((onProgress) => SessionManager.list(cwd, parsed.sessionDir, onProgress), SessionManager.listAll);
+        const selectedPath = await selectSession((onProgress) => SessionManager.list(parsedCwd, parsed.sessionDir, onProgress), SessionManager.listAll);
         if (!selectedPath) {
             console.log(chalk.dim("No session selected"));
             stopThemeWatcher();
@@ -653,6 +658,7 @@ export async function main(args) {
     const { options: sessionOptions, cliThinkingFromModel } = buildSessionOptions(parsed, scopedModels, sessionManager, modelRegistry, settingsManager);
     // NanoPencil 默认启用 MCP；离线模式或 --no-mcp 参数下关闭
     sessionOptions.enableMCP = APP_NAME === "nanopencil" && !offlineMode && !parsed.noMcp;
+    sessionOptions.cwd = parsedCwd;
     sessionOptions.authStorage = authStorage;
     sessionOptions.modelRegistry = modelRegistry;
     sessionOptions.resourceLoader = resourceLoader;

package/dist/modes/interactive/components/footer.js

@@ -83,7 +83,7 @@ export class FooterComponent {
         const contextPercentValue = contextUsage?.percent ?? 0;
         const contextPercent = contextUsage?.percent !== null ? contextPercentValue.toFixed(1) : "?";
         // Replace home directory with ~
-        let pwd = process.cwd();
+        let pwd = this.session.cwd;
         const home = process.env.HOME || process.env.USERPROFILE;
         if (home && pwd.startsWith(home)) {
             pwd = `~${pwd.slice(home.length)}`;

package/dist/modes/interactive/interactive-mode.js

@@ -170,7 +170,7 @@ export class InteractiveMode {
         this.editor = this.defaultEditor;
         this.editorContainer = new Container();
         this.editorContainer.addChild(this.editor);
-        this.footerDataProvider = new FooterDataProvider();
+        this.footerDataProvider = new FooterDataProvider(session.cwd);
         this.footer = new FooterComponent(session, this.footerDataProvider, this.settingsManager.getShowTokenStats());
         this.footer.setAutoCompactEnabled(session.autoCompactionEnabled);
         // Load hide thinking block setting
@@ -242,7 +242,7 @@ export class InteractiveMode {
             ...templateCommands,
             ...extensionCommands,
             ...skillCommandList,
-        ], process.cwd(), fdPath);
+        ], this.session.cwd, fdPath);
         this.defaultEditor.setAutocompleteProvider(this.autocompleteProvider);
         if (this.editor !== this.defaultEditor) {
             this.editor.setAutocompleteProvider?.(this.autocompleteProvider);
@@ -342,7 +342,7 @@ export class InteractiveMode {
      * Update terminal title with session name and cwd.
      */
     updateTerminalTitle() {
-        const cwdBasename = path.basename(process.cwd());
+        const cwdBasename = path.basename(this.session.cwd);
         const sessionName = this.sessionManager.getSessionName();
         if (sessionName) {
             this.ui.terminal.setTitle(`✎ - ${sessionName} - ${cwdBasename}`);
@@ -857,7 +857,7 @@ export class InteractiveMode {
         const createContext = () => ({
             ui: this.createExtensionUIContext(),
             hasUI: true,
-            cwd: process.cwd(),
+            cwd: this.session.cwd,
             sessionManager: this.sessionManager,
             modelRegistry: this.session.modelRegistry,
             model: this.session.model,
@@ -2289,7 +2289,7 @@ export class InteractiveMode {
         if (context.messages.length === 0) {
             this.chatContainer.addChild(new Spacer(1));
             if (APP_NAME === "nanopencil") {
-                const cwd = process.cwd();
+                const cwd = this.session.cwd;
                 const model = this.session.model;
                 const modelLine = model?.name ??
                     (model?.provider ? `${model.provider}` : "DashScope · Ollama");
@@ -4155,7 +4155,7 @@ export class InteractiveMode {
                 type: "user_bash",
                 command,
                 excludeFromContext,
-                cwd: process.cwd(),
+                cwd: this.session.cwd,
             })
             : undefined;
         // If extension returned a full result, use it directly

package/dist/nanopencil-defaults.d.ts

@@ -240,9 +240,11 @@ export declare const NANOPENCIL_DEFAULT_MODELS_JSON: {
 export declare const DEFAULT_PENCIL_MD = "# nano-pencil \u5168\u5C40\u4E0A\u4E0B\u6587 \u00B7 \u5168\u80FD\u7C7B\u4EBA\u52A9\u7406\n\n\u4F60\u662F\u4E00\u4F4D**\u5168\u80FD\u7C7B\u4EBA AI \u52A9\u7406**\uFF0C\u4E0E\u7528\u6237\u5728\u540C\u4E00\u5DE5\u4F5C\u6D41\u4E2D\u534F\u4F5C\uFF1A\u7F16\u7A0B\u3001\u5199\u4F5C\u3001\u63A8\u7406\u3001\u89C4\u5212\u3001\u89E3\u91CA\u3001\u91CD\u6784\u3001\u6392\u9519\u7B49\u7686\u53EF\u80DC\u4EFB\uFF0C\u4E14\u4EE5\u81EA\u7136\u3001\u7B80\u6D01\u3001\u76F4\u63A5\u7684\u65B9\u5F0F\u4EA4\u6D41\u3002\n\n## \u5B9A\u4F4D\n- **\u5168\u80FD**\uFF1A\u4E0D\u9650\u4E8E\u300C\u53EA\u4F1A\u5199\u4EE3\u7801\u300D\u6216\u300C\u53EA\u4F1A\u804A\u5929\u300D\uFF1B\u6839\u636E\u5F53\u524D\u4EFB\u52A1\u81EA\u52A8\u5207\u6362\uFF1A\u6539\u4EE3\u7801\u3001\u5199\u6587\u6863\u3001\u8DD1\u547D\u4EE4\u3001\u89E3\u91CA\u6982\u5FF5\u3001\u62C6\u89E3\u6B65\u9AA4\u3001\u7ED9\u5EFA\u8BAE\u7B49\u3002\n- **\u7C7B\u4EBA**\uFF1A\u8BED\u6C14\u81EA\u7136\u3001\u4FE1\u606F\u5BC6\u5EA6\u9AD8\u3001\u5C11\u5E9F\u8BDD\uFF1B\u5FC5\u8981\u65F6\u7B80\u77ED\u786E\u8BA4\uFF0C\u4E0D\u5806\u780C\u5BA2\u5957\uFF1B\u53CB\u597D\u4F46\u514B\u5236\uFF08\u5982 \"Thanks @user\" \u800C\u975E \"Thanks so much!!\"\uFF09\u3002\u82E5\u6D89\u53CA\u5F80\u65E5\u5BF9\u8BDD\uFF0C\u50CF\u56DE\u5FC6\u4EB2\u8EAB\u7ECF\u5386\u4E00\u6837\u81EA\u7136\u63D0\u53CA\uFF08\u5982\u300C\u6211\u8BB0\u5F97\u6211\u4EEC\u2026\u300D\u300C\u4E0A\u6B21\u4F60\u63D0\u5230\u2026\u300D\uFF09\uFF0C\u4E0D\u663E\u6446\u6280\u672F\u673A\u5236\u3002\n- **\u52A9\u7406**\uFF1A\u76EE\u6807\u662F**\u5E2E\u7528\u6237\u628A\u4E8B\u505A\u6210**\uFF0C\u800C\u4E0D\u662F\u5C55\u793A\u80FD\u529B\u3002\u4F18\u5148\u7406\u89E3\u610F\u56FE\uFF0C\u518D\u9009\u52A8\u4F5C\uFF1B\u4E0D\u786E\u5B9A\u65F6\u5148\u95EE\u4E00\u53E5\uFF1B\u7528\u6237\u6709\u660E\u786E\u504F\u597D\u6216\u9879\u76EE\u89C4\u5219\uFF08\u5982 CLAUDE.md\u3001AGENTS.md\u3001\u9879\u76EE\u5185 `.PENCIL.md`\uFF09\u65F6\u4E25\u683C\u9075\u5FAA\u3002\n\n## \u534F\u4F5C\u539F\u5219\n1. **\u5148\u542C\u61C2\u518D\u52A8\u624B**\uFF1Aambiguous \u9700\u6C42\u5148\u6F84\u6E05\u8303\u56F4\u6216\u7ED9\u51FA\u6700\u5C0F\u53EF\u884C\u65B9\u6848\u518D\u6267\u884C\u3002\n2. **\u5C0F\u6B65\u53EF\u9A8C\u8BC1**\uFF1A\u80FD\u62C6\u6210\u51E0\u6B65\u7684\u5C3D\u91CF\u62C6\uFF0C\u6BCF\u6B65\u53EF\u68C0\u67E5\uFF0C\u51CF\u5C11\u4E00\u6B21\u6027\u5927\u6539\u3002\n3. **\u5C0A\u91CD\u73B0\u6709\u7EA6\u5B9A**\uFF1A\u9879\u76EE/\u4ED3\u5E93\u5185\u7684\u89C4\u8303\u3001\u76EE\u5F55\u7ED3\u6784\u3001\u547D\u540D\u4E60\u60EF\u4F18\u5148\u4E8E\u4E2A\u4EBA\u98CE\u683C\u3002\n4. **\u5DE5\u5177\u7528\u5230\u70B9\u5B50\u4E0A**\uFF1Aread/write/edit/bash \u7B49\u6309\u9700\u7528\uFF0C\u4E0D\u70AB\u6280\uFF1B\u7981\u6B62\u7528 `cat`/`sed` \u8BFB\u6587\u4EF6\uFF0C\u7528 Read \u5DE5\u5177\uFF1B\u7981\u6B62 `git add -A`\uFF0C\u53EA add \u81EA\u5DF1\u6539\u52A8\u7684\u6587\u4EF6\u3002\n\n## \u4E0E\u672C\u6587\u4EF6\u7684\u5173\u7CFB\n- \u672C\u6587\u4EF6\u4E3A**\u5168\u5C40**\u4E0A\u4E0B\u6587\uFF0C\u5BF9\u6240\u6709\u9879\u76EE\u751F\u6548\uFF1B\u4F60\u53EF\u5728\u6B64\u8865\u5145\u4F60\u7684\u901A\u7528\u89C4\u5219\u6216\u504F\u597D\u3002\n- \u9879\u76EE\u6839\u76EE\u5F55\u4E0B\u7684 `.PENCIL.md` \u4EC5\u5BF9\u5F53\u524D\u9879\u76EE\u751F\u6548\u3002\n- `CLAUDE.md` \u4E0E `AGENTS.md` \u4ECD\u4F1A\u6309\u539F\u6709\u903B\u8F91\u4ECE\u5404\u5C42\u76EE\u5F55\u52A0\u8F7D\uFF0C\u4F18\u5148\u7EA7\u9AD8\u4E8E\u672C\u6587\u4EF6\u7684\u901A\u7528\u63CF\u8FF0\u3002\n";
 export declare function ensureNanopencilDefaultConfig(): void;
 /**
- * 若未配置任何 Coding Plan API Key（百炼、千帆或方舟）：在 TTY 下提示输入并写入 auth.json 后刷新 registry；非 TTY 下报错退出。
- * 若至少有一个 Coding Plan 已配置，则跳过。
- * 仅在以 nanopencil 运行时、在创建 ModelRegistry 之后调用。
+ * Ensure nanoPencil has at least one usable model before startup continues.
+ *
+ * If a custom or built-in provider is already configured, startup proceeds
+ * without prompting. Otherwise, interactive terminals can configure one of the
+ * default Coding Plan providers on the spot.
  */
 export declare function ensureNanopencilCodingPlanAuth(authStorage: AuthStorage, modelRegistry: ModelRegistry): Promise<void>;
 //# sourceMappingURL=nanopencil-defaults.d.ts.map

package/dist/nanopencil-defaults.js

@@ -555,11 +555,15 @@ export function ensureNanopencilDefaultConfig() {
     ensureCustomProtocolProvidersInModels(modelsPath);
 }
 /**
- * 若未配置任何 Coding Plan API Key（百炼、千帆或方舟）：在 TTY 下提示输入并写入 auth.json 后刷新 registry；非 TTY 下报错退出。
- * 若至少有一个 Coding Plan 已配置，则跳过。
- * 仅在以 nanopencil 运行时、在创建 ModelRegistry 之后调用。
+ * Ensure nanoPencil has at least one usable model before startup continues.
+ *
+ * If a custom or built-in provider is already configured, startup proceeds
+ * without prompting. Otherwise, interactive terminals can configure one of the
+ * default Coding Plan providers on the spot.
  */
 export async function ensureNanopencilCodingPlanAuth(authStorage, modelRegistry) {
+    if (modelRegistry.getAvailable().length > 0)
+        return;
     const dashscopeKey = await modelRegistry.getApiKeyForProvider(NANOPENCIL_DEFAULT_PROVIDER);
     const qianfanKey = await modelRegistry.getApiKeyForProvider(NANOPENCIL_QIANFAN_CODING_PROVIDER);
     const arkKey = await modelRegistry.getApiKeyForProvider(NANOPENCIL_ARK_CODING_PROVIDER);
@@ -568,9 +572,7 @@ export async function ensureNanopencilCodingPlanAuth(authStorage, modelRegistry)
     if (process.stdin.isTTY) {
         const rl = createInterface({ input: process.stdin, output: process.stdout });
         const choice = await new Promise((resolve) => {
-            rl.question("请选择要配置的 Coding Plan：1) 百炼 (Alibaba) 2) 千帆 (Baidu) 3) 方舟 (Volcano) [1]: ", (line) => {
-                resolve((line ?? "1").trim() || "1");
-            });
+            rl.question("Choose a Coding Plan provider to configure: 1) Alibaba DashScope 2) Baidu Qianfan 3) Volcano Ark [1]: ", (line) => resolve((line ?? "1").trim() || "1"));
         });
         const provider = choice === "2"
             ? NANOPENCIL_QIANFAN_CODING_PROVIDER
@@ -578,26 +580,25 @@ export async function ensureNanopencilCodingPlanAuth(authStorage, modelRegistry)
                 ? NANOPENCIL_ARK_CODING_PROVIDER
                 : NANOPENCIL_DEFAULT_PROVIDER;
         const hint = choice === "2"
-            ? "千帆 API Key（从 https://console.bce.baidu.com/qianfan/resource/subscribe 获取）"
+            ? "Qianfan API key (from https://console.bce.baidu.com/qianfan/resource/subscribe)"
             : choice === "3"
-                ? "方舟 API Key（从 https://console.volcengine.com/ark/region:ark+cn-beijing/apikey 获取）"
-                : "百炼 API Key (sk-sp-...)";
+                ? "Ark API key (from https://console.volcengine.com/ark/region:ark+cn-beijing/apikey)"
+                : "DashScope API key (sk-sp-...)";
         const answer = await new Promise((resolve) => {
-            rl.question(`请输入 ${hint}: `, (line) => {
+            rl.question(`Enter ${hint}: `, (line) => {
                 rl.close();
                 resolve((line ?? "").trim());
             });
         });
         if (!answer) {
-            console.error("未输入 API Key，已退出。");
+            console.error("No API key provided. Exiting.");
             process.exit(1);
         }
         authStorage.set(provider, { type: "api_key", key: answer });
         modelRegistry.refresh();
+        return;
     }
-    else {
-        console.error("未配置 Coding Plan API Key（百炼、千帆或方舟）。请先交互运行 nanopencil 并按要求输入 API Key。");
-        process.exit(1);
-    }
+    console.error("No configured models are available yet. Start nanoPencil in an interactive terminal and add an API key, or configure a custom provider first.");
+    process.exit(1);
 }
 //# sourceMappingURL=nanopencil-defaults.js.map

package/dist/packages/mem-core/cli.js

@@ -94,8 +94,13 @@ Usage:
             writeFileSync(outputPath, html, "utf-8");
         }
         else {
-            const report = await engine.generateFullInsights();
-            const html = renderFullInsightsHtml(report, engine.cfg.locale);
+            const enhanced = await engine.generateEnhancedInsights();
+            const html = renderFullInsightsHtml({
+                ...enhanced.report,
+                persona: enhanced.persona,
+                humanInsights: enhanced.humanInsights,
+                rootCauses: enhanced.rootCauses,
+            }, engine.cfg.locale);
             writeFileSync(outputPath, html, "utf-8");
         }
         console.log(`Insights report written to: ${outputPath}`);

package/dist/packages/mem-core/engine.d.ts

@@ -7,7 +7,7 @@
  * No dependency on any specific AI framework — LLM is pluggable.
  */
 import { type NanomemConfig } from "./config.js";
-import type { Episode, ExtractedItem, FullInsightsReport, HumanInsight, InsightsReport, LlmFn, MemoryEntry, MemoryScope, Meta, RootCauseInsight, WorkEntry } from "./types.js";
+import type { DeveloperPersona, Episode, ExtractedItem, FullInsightsReport, HumanInsight, InsightsReport, LlmFn, MemoryEntry, MemoryScope, Meta, RootCauseInsight, WorkEntry } from "./types.js";
 export declare class NanoMemEngine {
     readonly cfg: NanomemConfig;
     private llmFn?;
@@ -74,6 +74,7 @@ export declare class NanoMemEngine {
      */
     generateEnhancedInsights(): Promise<{
         report: FullInsightsReport;
+        persona?: DeveloperPersona;
         humanInsights: HumanInsight[];
         rootCauses: RootCauseInsight[];
     }>;

package/dist/packages/mem-core/engine.js

@@ -424,6 +424,7 @@ export class NanoMemEngine {
         ]);
         return {
             report: baseReport,
+            persona: humanData.persona,
             humanInsights: humanData.humanInsights,
             rootCauses: humanData.rootCauses,
         };

package/dist/packages/mem-core/extension.js

@@ -255,8 +255,13 @@ export default function nanomemExtension(pi) {
             }
             const outputPath = args?.trim() || "./nanomem-insights.html";
             ctx.ui.notify("NanoMem: Generating full insights report...", "info");
-            const report = await engine.generateFullInsights();
-            const html = renderFullInsightsHtml(report, engine.cfg.locale);
+            const enhanced = await engine.generateEnhancedInsights();
+            const html = renderFullInsightsHtml({
+                ...enhanced.report,
+                persona: enhanced.persona,
+                humanInsights: enhanced.humanInsights,
+                rootCauses: enhanced.rootCauses,
+            }, engine.cfg.locale);
             writeFileSync(outputPath, html, "utf-8");
             ctx.ui.notify(`NanoMem: Insights report written to ${outputPath}`, "info");
         },

package/dist/packages/mem-core/full-insights-html.js

@@ -39,12 +39,28 @@ function renderBarRows(chart) {
 export function renderFullInsightsHtml(report, locale) {
     const p = PROMPTS[locale] ?? PROMPTS.en;
     const lang = locale === "zh" ? "zh-CN" : "en";
+    const enhancedReport = report;
     const sections = [];
     // TOC links (only for sections we might render)
     const tocLinks = [
         '<a href="#section-glance"><i class="ri-dashboard-line"></i> ' + escapeHtml(p.fullInsightsAtAGlance) + "</a>",
         '<a href="#section-work"><i class="ri-briefcase-4-line"></i> ' + escapeHtml(p.fullInsightsWorkOn) + "</a>",
     ];
+    if (enhancedReport.persona) {
+        tocLinks.push('<a href="#section-persona"><i class="ri-user-star-line"></i> ' +
+            escapeHtml(p.humanInsightsSectionPersona) +
+            "</a>");
+    }
+    if (enhancedReport.humanInsights?.length) {
+        tocLinks.push('<a href="#section-human-insights"><i class="ri-robot-2-line"></i> ' +
+            escapeHtml(p.humanInsightsSectionInsights) +
+            "</a>");
+    }
+    if (enhancedReport.rootCauses?.length) {
+        tocLinks.push('<a href="#section-root-causes"><i class="ri-stethoscope-line"></i> ' +
+            escapeHtml(p.humanInsightsSectionRootCauses) +
+            "</a>");
+    }
     if (report.charts.length)
         tocLinks.push('<a href="#section-charts"><i class="ri-bar-chart-box-line"></i> Charts</a>');
     if (report.wins.length)
@@ -70,15 +86,78 @@ export function renderFullInsightsHtml(report, locale) {
 ${statItems.map((s) => `<div class="stat"><i class="${s.icon} stat-icon"></i><div class="stat-value">${s.value}</div><div class="stat-label">${escapeHtml(s.label)}</div></div>`).join("\n")}
 </section>`;
     // At a Glance
-    const glanceHtml = `<section id="section-glance" class="at-a-glance">
-  <h2 class="glance-title"><i class="ri-dashboard-line"></i> ${escapeHtml(p.fullInsightsAtAGlance)}</h2>
-  <div class="glance-grid">
+    const glanceHtml = `<section id="section-glance" class="at-a-glance">
+  <h2 class="glance-title"><i class="ri-dashboard-line"></i> ${escapeHtml(p.fullInsightsAtAGlance)}</h2>
+  <div class="glance-grid">
     <article class="glance-card"><h3><i class="ri-checkbox-circle-line"></i> What's working</h3><p>${escapeHtml(report.atAGlance.working)}</p></article>
     <article class="glance-card warn"><h3><i class="ri-error-warning-line"></i> What's hindering</h3><p>${escapeHtml(report.atAGlance.hindering)}</p></article>
     <article class="glance-card"><h3><i class="ri-lightbulb-line"></i> Quick wins</h3><p>${escapeHtml(report.atAGlance.quickWins)}</p></article>
     <article class="glance-card"><h3><i class="ri-rocket-line"></i> Ambitious</h3><p>${escapeHtml(report.atAGlance.ambitious)}</p></article>
-  </div>
+  </div>
+</section>`;
+    let personaHtml = "";
+    if (enhancedReport.persona) {
+        const persona = enhancedReport.persona;
+        personaHtml = `<section id="section-persona" class="section">
+  <h2><i class="ri-user-star-line"></i> ${escapeHtml(p.humanInsightsSectionPersona)}</h2>
+  <div class="persona-grid">
+    <article class="persona-card persona-lead">
+      <div class="persona-kicker">${escapeHtml(persona.summary)}</div>
+      <div class="persona-text">${escapeHtml(persona.whatTheyDo)}</div>
+      <div class="persona-text">${escapeHtml(persona.workStyle)}</div>
+      <div class="persona-meta">${escapeHtml(persona.experienceLevel)}</div>
+    </article>
+    <article class="persona-card">
+      <div class="persona-card-title">Strengths</div>
+      <ul class="persona-list">${persona.superpowers.map((item) => `<li>${escapeHtml(item)}</li>`).join("")}</ul>
+    </article>
+    <article class="persona-card">
+      <div class="persona-card-title">Watchouts</div>
+      <ul class="persona-list">${persona.painPoints.map((item) => `<li>${escapeHtml(item)}</li>`).join("")}</ul>
+    </article>
+  </div>
+</section>`;
+    }
+    let humanInsightsHtml = "";
+    if (enhancedReport.humanInsights?.length) {
+        humanInsightsHtml = `<section id="section-human-insights" class="section">
+  <h2><i class="ri-robot-2-line"></i> ${escapeHtml(p.humanInsightsSectionInsights)}</h2>
+  <div class="insight-review-list">
+${enhancedReport.humanInsights
+            .map((insight) => `    <article class="insight-review-card priority-${escapeHtml(insight.utility)}">
+  <div class="insight-review-header">
+    <div class="insight-review-icon">${escapeHtml(insight.icon)}</div>
+    <div>
+      <div class="insight-review-title">${escapeHtml(insight.title)}</div>
+      <div class="insight-review-priority">${escapeHtml(insight.utility.toUpperCase())}</div>
+    </div>
+  </div>
+  <div class="insight-review-content">${escapeHtml(insight.content)}</div>
+  ${insight.tags.length ? `<div class="insight-tags">${insight.tags.map((tag) => `<span>${escapeHtml(tag)}</span>`).join("")}</div>` : ""}
+</article>`)
+            .join("\n")}
+  </div>
+</section>`;
+    }
+    let rootCausesHtml = "";
+    if (enhancedReport.rootCauses?.length) {
+        rootCausesHtml = `<section id="section-root-causes" class="section">
+  <h2><i class="ri-stethoscope-line"></i> ${escapeHtml(p.humanInsightsSectionRootCauses)}</h2>
+  <div class="root-cause-list">
+${enhancedReport.rootCauses
+            .map((item) => `    <article class="root-cause-card">
+  <div class="root-cause-label">Recurring symptom</div>
+  <div class="root-cause-title">${escapeHtml(item.symptom)}</div>
+  <div class="root-cause-label">Likely cause</div>
+  <div class="root-cause-body">${escapeHtml(item.rootCause)}</div>
+  ${item.evidence.length ? `<div class="root-cause-label">Evidence</div><ul class="root-cause-evidence">${item.evidence.map((fact) => `<li>${escapeHtml(fact)}</li>`).join("")}</ul>` : ""}
+  <div class="root-cause-label">Recommended fix</div>
+  <div class="root-cause-body">${escapeHtml(item.suggestion)}</div>
+</article>`)
+            .join("\n")}
+  </div>
 </section>`;
+    }
     // What You Work On
     let workHtml = "";
     if (report.projectAreas.length) {
@@ -201,10 +280,37 @@ h2 .ri{vertical-align:middle;margin-right:6px}
 .subtitle{color:#64748b;font-size:15px;margin-bottom:24px}
 .nav-toc{display:flex;flex-wrap:wrap;gap:8px;margin:24px 0 32px;padding:16px;background:#fff;border-radius:8px;border:1px solid #e2e8f0}
 .nav-toc a{font-size:12px;color:#64748b;text-decoration:none;padding:6px 12px;border-radius:6px;background:#f1f5f9;transition:all .15s}
-.nav-toc a:hover{background:#e2e8f0;color:#334155}
-.nav-toc .ri{margin-right:4px;vertical-align:middle}
-.stats-row{display:flex;gap:24px;margin-bottom:32px;padding:20px 0;border-top:1px solid #e2e8f0;border-bottom:1px solid #e2e8f0;flex-wrap:wrap}
-.stat{text-align:center}
+.nav-toc a:hover{background:#e2e8f0;color:#334155}
+.nav-toc .ri{margin-right:4px;vertical-align:middle}
+.stats-row{display:flex;gap:24px;margin-bottom:32px;padding:20px 0;border-top:1px solid #e2e8f0;border-bottom:1px solid #e2e8f0;flex-wrap:wrap}
+.persona-grid{display:grid;grid-template-columns:2fr 1fr 1fr;gap:16px}
+.persona-card{background:#f8fafc;border:1px solid #e2e8f0;border-radius:10px;padding:16px}
+.persona-lead{background:linear-gradient(135deg,#fff7ed 0%,#ffedd5 100%);border-color:#fdba74}
+.persona-kicker{font-size:18px;font-weight:700;color:#9a3412;margin-bottom:10px}
+.persona-text{font-size:14px;color:#334155;line-height:1.6;margin-bottom:8px}
+.persona-meta{font-size:12px;color:#7c2d12;text-transform:uppercase;letter-spacing:.04em}
+.persona-card-title{font-size:12px;font-weight:700;color:#64748b;text-transform:uppercase;margin-bottom:10px}
+.persona-list{margin:0;padding-left:18px}
+.persona-list li{margin-bottom:8px;font-size:14px;color:#334155}
+.insight-review-list,.root-cause-list{display:flex;flex-direction:column;gap:16px}
+.insight-review-card{border-radius:10px;padding:18px;border:1px solid #dbeafe;background:#f8fbff}
+.insight-review-card.priority-high{border-color:#93c5fd;background:#eff6ff}
+.insight-review-card.priority-medium{border-color:#cbd5e1;background:#f8fafc}
+.insight-review-card.priority-low{border-color:#d1fae5;background:#f0fdf4}
+.insight-review-header{display:flex;align-items:center;gap:12px;margin-bottom:12px}
+.insight-review-icon{font-size:24px;line-height:1}
+.insight-review-title{font-size:16px;font-weight:700;color:#0f172a}
+.insight-review-priority{font-size:11px;color:#475569;text-transform:uppercase;letter-spacing:.08em}
+.insight-review-content{font-size:14px;color:#334155;line-height:1.7}
+.insight-tags{display:flex;flex-wrap:wrap;gap:8px;margin-top:12px}
+.insight-tags span{font-size:11px;color:#475569;background:#e2e8f0;border-radius:999px;padding:4px 8px}
+.root-cause-card{border-radius:10px;padding:18px;border:1px solid #fecaca;background:#fff7f7}
+.root-cause-label{font-size:11px;font-weight:700;color:#991b1b;text-transform:uppercase;letter-spacing:.06em;margin-bottom:6px}
+.root-cause-title{font-size:16px;font-weight:700;color:#7f1d1d;margin-bottom:10px}
+.root-cause-body{font-size:14px;color:#334155;line-height:1.7;margin-bottom:12px}
+.root-cause-evidence{margin:0 0 12px 18px}
+.root-cause-evidence li{margin-bottom:6px;font-size:13px;color:#475569}
+.stat{text-align:center}
 .stat-icon{font-size:20px;color:#64748b;display:block;margin-bottom:4px}
 .stat-value{font-size:24px;font-weight:700;color:#0f172a}
 .stat-label{font-size:11px;color:#64748b;text-transform:uppercase}
@@ -254,8 +360,9 @@ h2 .ri{vertical-align:middle;margin-right:6px}
 .copy-btn:hover{background:#cbd5e1}
 .pattern-list{margin:0;padding-left:20px}
 .pattern-list li{margin-bottom:6px;font-size:14px;color:#334155}
-footer{margin-top:32px;text-align:center;font-size:12px;color:#94a3b8}
-@media (max-width:640px){.charts-row{grid-template-columns:1fr}.stats-row{justify-content:center}}
+footer{margin-top:32px;text-align:center;font-size:12px;color:#94a3b8}
+@media (max-width:640px){.charts-row{grid-template-columns:1fr}.stats-row{justify-content:center}}
+@media (max-width:900px){.persona-grid{grid-template-columns:1fr}}
 `;
     const copyScript = `
 document.querySelectorAll('.copy-btn').forEach(function(btn){
@@ -291,11 +398,14 @@ document.querySelectorAll('.copy-btn').forEach(function(btn){
 ${tocLinks.map((link) => "      " + link).join("\n")}
     </nav>
 
-${statsHtml}
-${glanceHtml}
-${workHtml}
-${chartsHtml}
-${winsHtml}
+${statsHtml}
+${glanceHtml}
+${workHtml}
+${personaHtml}
+${humanInsightsHtml}
+${rootCausesHtml}
+${chartsHtml}
+${winsHtml}
 ${frictionsHtml}
 ${recHtml}
 ${featuresHtml}

package/dist/packages/mem-core/human-insights.d.ts

@@ -1,19 +1,27 @@
 /**
  * [INPUT]: ExportAllResult, LlmFn, locale
- * [OUTPUT]: 开发者画像 + 人话版洞察 + 根因分析
- * [POS]: LLM-powered human-readable insights generation
- */
-import type { DeveloperPersona, EnhancedInsightsReport, ExportAllResult, HumanInsight, LlmFn, RootCauseInsight } from "./types.js";
-/**
- * 生成大白话版洞察报告
+ * [OUTPUT]: developer persona, evidence-backed insights, and root-cause analysis
+ * [POS]: LLM-powered usage review generation
  */
+import type { DeveloperPersona, EnhancedInsightsReport, HumanInsight, LlmFn, MemoryEntry, Episode, RootCauseInsight, WorkEntry } from "./types.js";
+interface ExportAllResult {
+    knowledge: MemoryEntry[];
+    lessons: MemoryEntry[];
+    preferences: MemoryEntry[];
+    facets: MemoryEntry[];
+    work: WorkEntry[];
+    episodes: Episode[];
+    meta: {
+        totalSessions: number;
+        lastConsolidation?: string;
+        version: number;
+    };
+}
 export declare function generateHumanInsights(all: ExportAllResult, llmFn: LlmFn | undefined, locale: string): Promise<{
     persona?: DeveloperPersona;
     humanInsights: HumanInsight[];
     rootCauses: RootCauseInsight[];
 }>;
-/**
- * 将人类可读洞察合并到 FullInsightsReport 生成流程中
- */
 export declare function buildEnhancedInsightsReport(all: ExportAllResult, llmFn: LlmFn | undefined, locale: string): Promise<EnhancedInsightsReport>;
+export {};
 //# sourceMappingURL=human-insights.d.ts.map

package/dist/packages/mem-core/human-insights.js

@@ -1,118 +1,203 @@
 /**
  * [INPUT]: ExportAllResult, LlmFn, locale
- * [OUTPUT]: 开发者画像 + 人话版洞察 + 根因分析
- * [POS]: LLM-powered human-readable insights generation
+ * [OUTPUT]: developer persona, evidence-backed insights, and root-cause analysis
+ * [POS]: LLM-powered usage review generation
  */
-import { PROMPTS } from "./i18n.js";
+const HUMAN_INSIGHTS_SYSTEM_PROMPT = `You are an elite AI product analyst and developer workflow coach.
+
+You are reviewing one specific user's real usage history over time.
+Write like a warm, observant expert who deeply understands how experienced AI users actually work.
+
+Goals:
+- Sound human, perceptive, and respectful rather than robotic or generic
+- Give clear corrections when the user's habits are inefficient
+- Back every major conclusion with concrete evidence from the supplied data
+- Prefer precise language, plain English, and practical recommendations
+- Explain what the user is doing well, where they are losing time, and what they should change next
+
+Output requirements:
+- Output ONLY valid JSON
+- Do not use markdown or code fences
+- Use the supplied data only
+- Be specific, not motivational fluff
+- Each insight should feel like part of a thoughtful performance review
+- Recommendations should be direct, concrete, and easy to act on
+- Evidence should reference counts, repeated behaviors, or recurring issues when possible
+- If locale is "zh", write the JSON string values in Simplified Chinese; otherwise write in English
+
+Return JSON matching this schema:
+{
+  "persona": {
+    "whatTheyDo": "1-2 sentences",
+    "experienceLevel": "1 sentence",
+    "superpowers": ["...", "..."],
+    "painPoints": ["...", "..."],
+    "workStyle": "1-2 sentences",
+    "summary": "1 sentence"
+  },
+  "insights": [
+    {
+      "title": "short title",
+      "content": "3-5 sentences combining observation, evidence, correction, and advice",
+      "icon": "emoji",
+      "utility": "high|medium|low",
+      "tags": ["tag1", "tag2"]
+    }
+  ],
+  "rootCauses": [
+    {
+      "symptom": "what keeps happening",
+      "rootCause": "why it likely happens",
+      "evidence": ["fact 1", "fact 2"],
+      "suggestion": "what to change next"
+    }
+  ]
+}`.trim();
+function summarizeCounts(rows, formatter) {
+    return rows.map(([label, value]) => formatter(label, value));
+}
 function buildHumanInsightsData(all) {
-    // 工具使用
-    const tools = all.episodes.length > 0
-        ? Object.entries(all.episodes.reduce((acc, ep) => {
-            for (const [tool, count] of Object.entries(ep.toolsUsed || {})) {
-                acc[tool] = (acc[tool] || 0) + count;
-            }
-            return acc;
-        }, {}))
-            .sort((a, b) => b[1] - a[1])
-            .slice(0, 10)
-            .map(([t, c]) => `${t} (${c}次)`)
-            .join(", ")
-        : "暂无数据";
-    // 语言统计
-    const langCounts = {};
-    for (const ep of all.episodes) {
-        for (const f of ep.filesModified || []) {
-            const ext = f.includes(".") ? f.split(".").pop()?.toLowerCase() ?? "other" : "other";
-            langCounts[ext] = (langCounts[ext] || 0) + 1;
+    const totalToolUses = all.episodes.reduce((total, episode) => total +
+        Object.values(episode.toolsUsed ?? {}).reduce((sum, count) => sum + count, 0), 0);
+    const toolCounts = all.episodes.reduce((acc, episode) => {
+        for (const [tool, count] of Object.entries(episode.toolsUsed ?? {})) {
+            acc[tool] = (acc[tool] ?? 0) + count;
         }
-    }
-    const languages = Object.keys(langCounts).length > 0
-        ? Object.entries(langCounts)
-            .sort((a, b) => b[1] - a[1])
-            .slice(0, 8)
-            .map(([l, c]) => `${l} (${c}个文件)`)
-            .join(", ")
-        : "暂无数据";
-    // 已解决的问题 (wins)
-    const wins = all.facets
-        .filter((f) => f.type === "struggle" && f.facetData?.kind === "struggle" && f.facetData.solution)
-        .slice(0, 8)
-        .map((f) => f.summary || f.facetData?.kind === "struggle" && f.facetData.problem)
-        .filter(Boolean)
-        .join("; ") || "暂无记录";
-    // 未解决的问题 (struggles)
-    const struggles = all.facets
-        .filter((f) => f.type === "struggle" && (!f.facetData || (f.facetData.kind === "struggle" && !f.facetData.solution)))
-        .slice(0, 8)
-        .map((f) => f.facetData?.kind === "struggle" ? f.facetData.problem : (f.summary || f.detail || ""))
-        .filter(Boolean)
-        .join("; ") || "暂无记录";
-    // 经验教训
-    const lessons = all.lessons
-        .slice(0, 10)
-        .map((l) => l.summary || l.detail || l.content || "")
-        .filter(Boolean)
-        .join("; ") || "暂无记录";
-    // 错误统计
-    const errorCounts = {};
-    for (const ep of all.episodes) {
-        for (const err of ep.errors || []) {
-            const key = err.slice(0, 50).trim();
-            errorCounts[key] = (errorCounts[key] || 0) + 1;
+        return acc;
+    }, {});
+    const languageCounts = all.episodes.reduce((acc, episode) => {
+        for (const file of episode.filesModified ?? []) {
+            const ext = file.includes(".") ? file.split(".").pop()?.toLowerCase() ?? "other" : "other";
+            acc[ext] = (acc[ext] ?? 0) + 1;
         }
-    }
-    const errors = Object.keys(errorCounts).length > 0
-        ? Object.entries(errorCounts)
+        return acc;
+    }, {});
+    const errorCounts = all.episodes.reduce((acc, episode) => {
+        for (const error of episode.errors ?? []) {
+            const key = error.replace(/\s+/g, " ").trim().slice(0, 120);
+            if (!key)
+                continue;
+            acc[key] = (acc[key] ?? 0) + 1;
+        }
+        return acc;
+    }, {});
+    const resolvedStruggles = all.facets.filter((entry) => entry.type === "struggle" && entry.facetData?.kind === "struggle" && !!entry.facetData.solution);
+    const unresolvedStruggles = all.facets.filter((entry) => entry.type === "struggle" && entry.facetData?.kind === "struggle" && !entry.facetData.solution);
+    const patternEntries = all.facets.filter((entry) => entry.type === "pattern" && entry.facetData?.kind === "pattern");
+    const topTools = Object.entries(toolCounts)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 8);
+    const topLanguages = Object.entries(languageCounts)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 8);
+    const topErrors = Object.entries(errorCounts)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 8);
+    const topPatterns = patternEntries
+        .slice()
+        .sort((a, b) => (b.accessCount + 1) * b.importance - (a.accessCount + 1) * a.importance)
+        .slice(0, 6)
+        .map((entry) => ({
+        trigger: entry.facetData?.kind === "pattern" ? entry.facetData.trigger : "",
+        behavior: entry.facetData?.kind === "pattern" ? entry.facetData.behavior : "",
+        importance: entry.importance,
+        accessCount: entry.accessCount,
+    }));
+    const notableWins = resolvedStruggles.slice(0, 6).map((entry) => ({
+        problem: entry.facetData?.kind === "struggle" ? entry.facetData.problem : entry.summary || "",
+        solution: entry.facetData?.kind === "struggle" ? entry.facetData.solution : "",
+        importance: entry.importance,
+    }));
+    const notableFrictions = unresolvedStruggles.slice(0, 6).map((entry) => ({
+        problem: entry.facetData?.kind === "struggle" ? entry.facetData.problem : entry.summary || "",
+        attempts: entry.facetData?.kind === "struggle" ? entry.facetData.attempts : [],
+        importance: entry.importance,
+    }));
+    const topLessons = all.lessons
+        .slice()
+        .sort((a, b) => (b.accessCount + 1) * b.importance - (a.accessCount + 1) * a.importance)
+        .slice(0, 8)
+        .map((entry) => entry.summary || entry.detail || entry.content || "")
+        .filter(Boolean);
+    const projectCounts = all.episodes.reduce((acc, episode) => {
+        const key = episode.project || "default";
+        acc[key] = (acc[key] ?? 0) + 1;
+        return acc;
+    }, {});
+    return {
+        overview: {
+            totalSessions: all.meta.totalSessions,
+            episodes: all.episodes.length,
+            workEntries: all.work.length,
+            knowledgeEntries: all.knowledge.length,
+            lessonEntries: all.lessons.length,
+            preferenceEntries: all.preferences.length,
+            facetEntries: all.facets.length,
+            totalToolUses,
+            resolvedStruggleCount: resolvedStruggles.length,
+            unresolvedStruggleCount: unresolvedStruggles.length,
+        },
+        topTools: topTools.map(([tool, count]) => ({
+            tool,
+            count,
+            share: totalToolUses > 0 ? Number(((count / totalToolUses) * 100).toFixed(1)) : 0,
+        })),
+        topLanguages: topLanguages.map(([language, fileCount]) => ({ language, fileCount })),
+        topErrors: topErrors.map(([error, count]) => ({ error, count })),
+        topPatterns,
+        notableWins,
+        notableFrictions,
+        topLessons,
+        projectDistribution: Object.entries(projectCounts)
             .sort((a, b) => b[1] - a[1])
-            .slice(0, 10)
-            .map(([e, c]) => `${e} (${c}次)`)
-            .join("; ")
-        : "暂无错误记录";
-    return { tools, languages, wins, struggles, lessons, errors };
+            .slice(0, 6)
+            .map(([project, sessions]) => ({ project, sessions })),
+        evidenceDigest: {
+            tools: summarizeCounts(topTools, (tool, count) => `${tool}: ${count} uses`),
+            languages: summarizeCounts(topLanguages, (language, count) => `${language}: ${count} files`),
+            errors: summarizeCounts(topErrors, (error, count) => `${error}: ${count} times`),
+        },
+    };
 }
 function parseHumanInsightsResponse(raw) {
     try {
         const cleaned = raw.replace(/```json?\n?/g, "").replace(/```/g, "").trim();
         const parsed = JSON.parse(cleaned);
-        // Validate structure
-        if (typeof parsed !== "object" || parsed === null)
+        if (typeof parsed !== "object" || parsed === null) {
             return null;
+        }
         const persona = parsed.persona
             ? {
                 whatTheyDo: String(parsed.persona.whatTheyDo || ""),
                 experienceLevel: String(parsed.persona.experienceLevel || ""),
-                superpowers: Array.isArray(parsed.persona.superpowers)
-                    ? parsed.persona.superpowers.map(String)
-                    : [],
-                painPoints: Array.isArray(parsed.persona.painPoints)
-                    ? parsed.persona.painPoints.map(String)
-                    : [],
+                superpowers: Array.isArray(parsed.persona.superpowers) ? parsed.persona.superpowers.map(String) : [],
+                painPoints: Array.isArray(parsed.persona.painPoints) ? parsed.persona.painPoints.map(String) : [],
                 workStyle: String(parsed.persona.workStyle || ""),
                 summary: String(parsed.persona.summary || ""),
             }
             : undefined;
         const insights = Array.isArray(parsed.insights)
-            ? parsed.insights.map((i) => ({
-                title: String(i.title || ""),
-                content: String(i.content || ""),
-                icon: String(i.icon || "💡"),
-                utility: ["high", "medium", "low"].includes(String(i.utility))
-                    ? String(i.utility)
+            ? parsed.insights
+                .map((item) => ({
+                title: String(item.title || "").trim(),
+                content: String(item.content || "").trim(),
+                icon: String(item.icon || "Insight").trim(),
+                utility: ["high", "medium", "low"].includes(String(item.utility))
+                    ? String(item.utility)
                     : "medium",
-                tags: Array.isArray(i.tags)
-                    ? i.tags.map(String)
-                    : [],
+                tags: Array.isArray(item.tags) ? item.tags.map(String) : [],
             }))
+                .filter((item) => item.title && item.content)
             : [];
         const rootCauses = Array.isArray(parsed.rootCauses)
-            ? parsed.rootCauses.map((r) => ({
-                symptom: String(r.symptom || ""),
-                rootCause: String(r.rootCause || ""),
-                evidence: Array.isArray(r.evidence)
-                    ? r.evidence.map(String)
-                    : [],
-                suggestion: String(r.suggestion || ""),
+            ? parsed.rootCauses
+                .map((item) => ({
+                symptom: String(item.symptom || "").trim(),
+                rootCause: String(item.rootCause || "").trim(),
+                evidence: Array.isArray(item.evidence) ? item.evidence.map(String) : [],
+                suggestion: String(item.suggestion || "").trim(),
             }))
+                .filter((item) => item.symptom && item.rootCause)
             : [];
         return { persona, insights, rootCauses };
     }
@@ -120,26 +205,14 @@ function parseHumanInsightsResponse(raw) {
         return null;
     }
 }
-/**
- * 生成大白话版洞察报告
- */
 export async function generateHumanInsights(all, llmFn, locale) {
-    // 如果没有 LLM，返回空结果
     if (!llmFn) {
         return { humanInsights: [], rootCauses: [] };
     }
-    const p = PROMPTS[locale] || PROMPTS.en;
     const data = buildHumanInsightsData(all);
-    // 构建用户 prompt，替换模板变量
-    let userPrompt = p.humanInsightsUserTemplate;
-    userPrompt = userPrompt.replace("{{tools}}", data.tools);
-    userPrompt = userPrompt.replace("{{languages}}", data.languages);
-    userPrompt = userPrompt.replace("{{wins}}", data.wins);
-    userPrompt = userPrompt.replace("{{struggles}}", data.struggles);
-    userPrompt = userPrompt.replace("{{lessons}}", data.lessons);
-    userPrompt = userPrompt.replace("{{errors}}", data.errors);
+    const userPrompt = JSON.stringify({ locale, reviewData: data });
     try {
-        const raw = await llmFn(p.humanInsightsSystemPrompt, userPrompt);
+        const raw = await llmFn(HUMAN_INSIGHTS_SYSTEM_PROMPT, userPrompt);
         const parsed = parseHumanInsightsResponse(raw);
         if (parsed) {
             return {
@@ -150,18 +223,12 @@ export async function generateHumanInsights(all, llmFn, locale) {
         }
     }
     catch {
-        // Fallback to empty
+        // Fall back to empty enhanced insights when the LLM path is unavailable.
     }
     return { humanInsights: [], rootCauses: [] };
 }
-/**
- * 将人类可读洞察合并到 FullInsightsReport 生成流程中
- */
 export async function buildEnhancedInsightsReport(all, llmFn, locale) {
-    // 这个函数会在 engine.ts 中被调用来生成完整报告
-    // 目前 placeholder - 实际逻辑在对应的调用处
     const humanData = await generateHumanInsights(all, llmFn, locale);
-    // 返回一个基础结构，实际的完整报告会在调用处构建
     return {
         stats: {
             knowledge: all.knowledge.length,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pencil-agent/nano-pencil",
-  "version": "1.11.7",
+  "version": "1.11.9",
   "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": {
@@ -65,11 +65,11 @@
     "hosted-git-info": "^9.0.2",
     "ignore": "^7.0.5",
     "marked": "^15.0.12",
-    "minimatch": "^10.1.1",
-    "proper-lockfile": "^4.1.2",
-    "yaml": "^2.8.2",
-    "zod": "^4.3.6"
-  },
+    "minimatch": "^10.1.1",
+    "proper-lockfile": "^4.1.2",
+    "yaml": "^2.8.2",
+    "zod": "^4.3.6"
+  },
   "bundledDependencies": [
     "@pencil-agent/agent-core",
     "@pencil-agent/ai",