zapmyco 0.20.6 → 0.22.1

package/README.md

@@ -140,8 +140,7 @@ ai-typescript-starter/
 | `deno task fmt:check`     | 格式检查                             |
 | `deno task check`         | 类型检查                             |
 | `deno task check:all`     | 完整检查 (fmt + lint + check + test) |
-| `deno task cli`           | 运行 CLI                             |
-| `deno task ai`            | AI 对话模式                          |
+| `deno task cli`           | 运行 CLI（交互模式/一次性任务）      |
 | `deno task release`       | 创建发布                             |
 | `deno task release:dry`   | 发布干运行 (不实际发布)              |
 | `deno task build:npm`     | dnt 构建 npm 包                      |

package/esm/deno.js

@@ -4,16 +4,17 @@ export default {
         "docs/"
     ],
     "name": "@zapmyco/zapmyco",
-    "version": "0.20.6",
+    "version": "0.22.1",
     "description": "基于 Deno 的 AI 驱动命令行工具",
     "exports": "./src/index.ts",
     "tasks": {
-        "cli": "deno run --allow-env --allow-net src/index.ts",
-        "ai": "deno run --allow-env --allow-net src/index.ts ai",
-        "install:global": "deno install -g -n zapmyco --allow-env --allow-net src/index.ts",
-        "dev": "deno run --watch src/index.ts",
-        "test": "deno test --allow-env",
-        "test:coverage": "deno test --allow-env --coverage && deno coverage",
+        "cli": "deno run --allow-env --allow-net --allow-read=$HOME/.zapmyco src/cli.ts",
+        "init": "deno run --allow-env --allow-read --allow-write src/cli.ts init",
+        "settings": "deno run --allow-env --allow-read=$HOME/.zapmyco src/cli.ts settings",
+        "install:global": "deno install -g -n zapmyco --allow-env --allow-net --allow-read --allow-write src/cli.ts",
+        "dev": "deno run --watch src/cli.ts",
+        "test": "deno test --allow-env --allow-read --allow-write",
+        "test:coverage": "deno test --allow-env --allow-read --allow-write --coverage && deno coverage",
         "lint": "deno lint",
         "fmt": "deno fmt",
         "fmt:check": "deno fmt --check",
@@ -55,6 +56,7 @@ export default {
             "CHANGELOG.md",
             "AGENTS.md",
             "src/**/*_test.ts",
+            "src/cli.ts",
             "tools",
             "dist"
         ]

package/esm/src/ai-agent.js

@@ -4,6 +4,8 @@
 import * as dntShim from "../_dnt.shims.js";
 import Anthropic from '@anthropic-ai/sdk';
 import { TextLineStream } from './text-line-stream.js';
+import { loadSettings, resolveEnvRef } from './settings.js';
+import { getModelInfo } from './models.js';
 const DEFAULT_BASE_URL = 'https://api.deepseek.com/anthropic';
 const DEFAULT_MODEL = 'deepseek-v4-flash';
 const DEFAULT_SYSTEM_PROMPT = '你是一个 AI 编程助手，帮助用户解决编程问题。';
@@ -24,6 +26,12 @@ export class AiAgent {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "maxTokens", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "messages", {
             enumerable: true,
             configurable: true,
@@ -36,34 +44,65 @@ export class AiAgent {
             writable: true,
             value: void 0
         });
-        const apiKey = options.apiKey ?? dntShim.Deno.env.get('DEEPSEEK_API_KEY');
+        // 加载 ~/.zapmyco/settings.json（文件不存在时静默降级）
+        const settings = loadSettings();
+        const llm = settings?.llm;
+        // 1. 确定模型配置档名称
+        const profileName = options.modelProfile ?? 'default';
+        // 2. 从配置档解析模型名称
+        const profileModelName = llm?.models?.[profileName];
+        // 3. 最终模型名称：options.model > 配置档模型名 > 默认值
+        const modelName = options.model ?? profileModelName ?? DEFAULT_MODEL;
+        // 4. 从内置注册表查找模型信息
+        const modelInfo = getModelInfo(modelName);
+        // 5. 确定供应商名称：options.provider > 注册表中的供应商 > 'default'
+        const providerName = options.provider ?? modelInfo?.provider ?? 'default';
+        // 6. 解析 apiKey：options > settings.providers[provider].apiKey > 环境变量
+        let apiKey;
+        if (options.apiKey) {
+            apiKey = options.apiKey;
+        }
+        else if (providerName) {
+            const providerCfg = llm?.providers?.[providerName];
+            if (providerCfg?.apiKey) {
+                apiKey = resolveEnvRef(providerCfg.apiKey);
+            }
+        }
         if (!apiKey) {
-            throw new Error('DEEPSEEK_API_KEY 未设置。请通过环境变量 DEEPSEEK_API_KEY 设置 API Key。');
+            apiKey = dntShim.Deno.env.get('DEEPSEEK_API_KEY');
         }
-        this.client = new Anthropic({
-            baseURL: options.baseURL ?? DEFAULT_BASE_URL,
-            apiKey,
-        });
-        this.model = options.model ?? DEFAULT_MODEL;
+        if (!apiKey) {
+            throw new Error('DEEPSEEK_API_KEY 未设置。请运行 `zapmyco init` 或设置环境变量 DEEPSEEK_API_KEY。');
+        }
+        // 7. 确定 baseURL：options > 注册表中的 baseURL > 默认值
+        const baseURL = options.baseURL ?? modelInfo?.baseURL ?? DEFAULT_BASE_URL;
+        // 8. 确定 maxTokens：options > 注册表中的 maxOutputTokens > 默认值 4096
+        this.maxTokens = options.maxTokens ?? modelInfo?.maxOutputTokens ?? 4096;
+        this.client = new Anthropic({ baseURL, apiKey });
+        this.model = modelName;
         this.systemPrompt = options.systemPrompt ?? DEFAULT_SYSTEM_PROMPT;
     }
     /**
-     * 非流式对话 - 发送消息并获取完整回复
+     * 非流式对话（内部使用流式 API） - 发送消息并获取完整回复
      * @param input - 用户输入
      * @returns 完整回复文本
      */
     async chat(input) {
         this.messages.push({ role: 'user', content: input });
-        const response = await this.client.messages.create({
+        // 内部使用流式 API 以避免非流式请求被拒绝或超时
+        let fullContent = '';
+        const stream = this.client.messages.stream({
             model: this.model,
-            max_tokens: 4096,
+            max_tokens: this.maxTokens,
             system: this.systemPrompt,
             messages: this.messages,
         });
-        const firstBlock = response.content[0];
-        const content = firstBlock?.type === 'text' ? firstBlock.text : '';
-        this.messages.push({ role: 'assistant', content });
-        return content;
+        stream.on('text', (text) => {
+            fullContent += text;
+        });
+        await stream.finalMessage();
+        this.messages.push({ role: 'assistant', content: fullContent });
+        return fullContent;
     }
     /**
      * 流式对话 - 发送消息并通过回调逐块获取回复
@@ -75,7 +114,7 @@ export class AiAgent {
         this.messages.push({ role: 'user', content: input });
         const stream = this.client.messages.stream({
             model: this.model,
-            max_tokens: 4096,
+            max_tokens: this.maxTokens,
             system: this.systemPrompt,
             messages: this.messages,
         });

package/esm/src/cli.js

@@ -0,0 +1,281 @@
+#!/usr/bin/env node
+/**
+ * CLI 入口 — 基于 Commander.js 的命令行界面
+ */
+import "../_dnt.polyfills.js";
+import * as dntShim from "../_dnt.shims.js";
+import { Command, CommanderError } from 'commander';
+import { createConfig, greet, VERSION } from './index.js';
+import { AiAgent } from './ai-agent.js';
+function getSettingsPath() {
+    return `${dntShim.Deno.env.get('HOME') ?? '.'}/.zapmyco/settings.json`;
+}
+function getSettingsDir() {
+    return `${dntShim.Deno.env.get('HOME') ?? '.'}/.zapmyco`;
+}
+async function promptUser(question) {
+    const encoder = new TextEncoder();
+    dntShim.Deno.stdout.writeSync(encoder.encode(question));
+    const buf = new Uint8Array(1024);
+    const n = await dntShim.Deno.stdin.read(buf);
+    if (n === null)
+        return '';
+    return new TextDecoder().decode(buf.subarray(0, n)).trim();
+}
+async function handleInitCommand() {
+    const filePath = getSettingsPath();
+    const dir = getSettingsDir();
+    // 检查是否已存在
+    try {
+        dntShim.Deno.statSync(filePath);
+        return {
+            exitCode: 1,
+            stdout: '',
+            stderr: `${filePath} 已存在。如需重新初始化，请先删除该文件。`,
+        };
+    }
+    catch (err) {
+        if (!(err instanceof dntShim.Deno.errors.NotFound)) {
+            return { exitCode: 1, stdout: '', stderr: String(err) };
+        }
+    }
+    // 交互式询问 API Key
+    const apiKey = await promptUser('? DeepSeek API Key（输入密钥，或直接回车使用环境变量 DEEPSEEK_API_KEY）: ');
+    // 写入配置文件（新结构）
+    const settings = {
+        llm: {
+            providers: {
+                deepseek: {
+                    apiKey: apiKey || '${env.DEEPSEEK_API_KEY}',
+                },
+            },
+            models: {
+                advanced: 'deepseek-reasoner',
+                default: 'deepseek-v4-flash',
+                light: 'deepseek-v4-flash',
+            },
+        },
+    };
+    try {
+        dntShim.Deno.mkdirSync(dir, { recursive: true });
+        dntShim.Deno.writeTextFileSync(filePath, JSON.stringify(settings, null, 2) + '\n');
+    }
+    catch (error) {
+        return { exitCode: 1, stdout: '', stderr: String(error) };
+    }
+    return {
+        exitCode: 0,
+        stdout: `已创建 ${filePath}\n请运行 \`zapmyco settings\` 查看配置。`,
+        stderr: '',
+    };
+}
+function maskApiKey(value) {
+    const envRef = value.match(/^\$\{env\.(.+)\}$/);
+    if (envRef) {
+        return `\${env.${envRef[1]}}`;
+    }
+    if (value.length <= 8) {
+        return value.slice(0, 3) + '***';
+    }
+    return value.slice(0, 3) + '***' + value.slice(-4);
+}
+function displaySettings(fileContent) {
+    // 脱敏 apiKey（支持新版和旧版结构）
+    if (fileContent.llm && typeof fileContent.llm === 'object') {
+        const llm = fileContent.llm;
+        // 新版: llm.providers.<name>.apiKey
+        if (llm.providers && typeof llm.providers === 'object') {
+            const providers = llm.providers;
+            for (const cfg of Object.values(providers)) {
+                if (typeof cfg.apiKey === 'string') {
+                    cfg.apiKey = maskApiKey(cfg.apiKey);
+                }
+            }
+        }
+        // 旧版: llm.apiKey
+        if (typeof llm.apiKey === 'string') {
+            llm.apiKey = maskApiKey(llm.apiKey);
+        }
+    }
+    return JSON.stringify(fileContent, null, 2);
+}
+function readSettingsFile(filePath) {
+    try {
+        const content = dntShim.Deno.readTextFileSync(filePath);
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error instanceof dntShim.Deno.errors.NotFound) {
+            throw new Error(`${filePath} 不存在。请运行 \`zapmyco init\` 创建。`);
+        }
+        if (error instanceof Error && error.name === 'NotCapable') {
+            throw new Error(`权限不足: ${filePath}\n请使用 --allow-read 权限运行。`);
+        }
+        if (error instanceof SyntaxError) {
+            throw new Error(`${filePath} JSON 格式错误。`);
+        }
+        throw error;
+    }
+}
+/**
+ * CLI 入口 - 解析参数并执行对应操作
+ * @param args - 命令行参数数组
+ * @returns CLI 执行结果
+ */
+export async function cli(args) {
+    let capturedStdout = '';
+    let capturedStderr = '';
+    const program = new Command();
+    program.exitOverride();
+    program.configureOutput({
+        writeOut: (str) => {
+            capturedStdout += str;
+        },
+        writeErr: (str) => {
+            capturedStderr += str;
+        },
+    });
+    program.name('zapmyco');
+    program.version(`v${VERSION}`, '-v, --version');
+    program.description('基于 Deno 的 AI 驱动命令行工具');
+    program.helpOption('-h, --help', '显示帮助信息');
+    // --- greet ---
+    program.command('greet')
+        .description('向指定名称打招呼')
+        .argument('<name>', '要打招呼的名称')
+        .action((name) => {
+        try {
+            capturedStdout += greet(name);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            capturedStderr += msg;
+            throw new CommanderError(1, 'commander.greetError', msg);
+        }
+    });
+    // --- config ---
+    program.command('config')
+        .description('显示配置信息')
+        .action(() => {
+        const config = createConfig();
+        capturedStdout += JSON.stringify(config, null, 2);
+    });
+    // --- init ---
+    program.command('init')
+        .description('初始化 LLM 配置')
+        .action(async () => {
+        const result = await handleInitCommand();
+        capturedStdout += result.stdout;
+        capturedStderr += result.stderr;
+        if (result.exitCode !== 0) {
+            throw new CommanderError(result.exitCode, 'commander.initError', capturedStderr);
+        }
+    });
+    // --- settings ---
+    program.command('settings')
+        .description('显示 LLM 配置')
+        .argument('[subcommand]', '子命令: path')
+        .action((subcommand) => {
+        if (subcommand === 'path') {
+            capturedStdout += getSettingsPath();
+            return;
+        }
+        if (subcommand && subcommand !== 'show') {
+            capturedStderr += `未知子命令: ${subcommand}\n可用命令: settings, settings path`;
+            throw new CommanderError(1, 'commander.settingsError', capturedStderr);
+        }
+        // settings / settings show
+        const filePath = getSettingsPath();
+        try {
+            const fileContent = readSettingsFile(filePath);
+            capturedStdout += displaySettings(fileContent);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            capturedStderr += msg;
+            throw new CommanderError(1, 'commander.settingsError', msg);
+        }
+    });
+    // --- run ---
+    program.command('run')
+        .description('一次性执行 AI 任务，完成后退出')
+        .option('--profile <name>', '指定模型配置档')
+        .argument('<content...>', '任务描述')
+        .action(async (contentArgs, options) => {
+        const settingsPath = getSettingsPath();
+        try {
+            dntShim.Deno.statSync(settingsPath);
+        }
+        catch {
+            capturedStderr +=
+                `未找到配置文件 ${settingsPath}\n请先运行 \`zapmyco init\` 初始化 LLM 配置。`;
+            throw new CommanderError(1, 'commander.runError', capturedStderr);
+        }
+        try {
+            const agent = new AiAgent({ modelProfile: options.profile });
+            const task = contentArgs.join(' ');
+            const encoder = new TextEncoder();
+            await agent.chatStream(task, (chunk) => {
+                dntShim.Deno.stdout.writeSync(encoder.encode(chunk));
+            });
+            dntShim.Deno.stdout.writeSync(encoder.encode('\n'));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            capturedStderr += message;
+            throw new CommanderError(1, 'commander.runError', capturedStderr);
+        }
+    });
+    // --- 执行 ---
+    try {
+        if (args.length === 0) {
+            // 无参数时直接进入交互模式
+            const settingsPath = getSettingsPath();
+            try {
+                dntShim.Deno.statSync(settingsPath);
+            }
+            catch {
+                capturedStderr +=
+                    `未找到配置文件 ${settingsPath}\n请先运行 \`zapmyco init\` 初始化 LLM 配置。`;
+                return { exitCode: 1, stdout: '', stderr: capturedStderr };
+            }
+            try {
+                const agent = new AiAgent();
+                await agent.startInteractiveChat();
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                capturedStderr += message;
+                return { exitCode: 1, stdout: '', stderr: capturedStderr };
+            }
+            return { exitCode: 0, stdout: '', stderr: '' };
+        }
+        await program.parseAsync(args, { from: 'user' });
+        return { exitCode: 0, stdout: capturedStdout, stderr: capturedStderr };
+    }
+    catch (err) {
+        if (err instanceof CommanderError) {
+            // exitCode === 0 时（如 --help、--version），忽略 commander 内部消息
+            if (err.exitCode === 0) {
+                return { exitCode: 0, stdout: capturedStdout, stderr: '' };
+            }
+            return {
+                exitCode: err.exitCode,
+                stdout: capturedStdout,
+                stderr: capturedStderr || err.message,
+            };
+        }
+        throw err;
+    }
+}
+if (globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).main) {
+    const encoder = new TextEncoder();
+    const result = await cli(dntShim.Deno.args);
+    if (result.stderr) {
+        dntShim.Deno.stderr.writeSync(encoder.encode(result.stderr + '\n'));
+    }
+    if (result.stdout) {
+        dntShim.Deno.stdout.writeSync(encoder.encode(result.stdout + '\n'));
+    }
+    dntShim.Deno.exit(result.exitCode);
+}

package/esm/src/index.js

@@ -3,9 +3,7 @@
  * 专为 AI 辅助开发时代打造
  */
 import "../_dnt.polyfills.js";
-import * as dntShim from "../_dnt.shims.js";
 import denoJson from '../deno.js';
-import { AiAgent } from './ai-agent.js';
 /** 当前库的版本号 */
 export const VERSION = denoJson.version;
 /**
@@ -43,68 +41,6 @@ export function createConfig(options) {
         createdAt: new Date(),
     };
 }
-/**
- * CLI 入口 - 解析参数并执行对应操作
- * @param args - 命令行参数数组
- * @returns CLI 执行结果
- */
-export async function cli(args) {
-    const [command, ...rest] = args;
-    if (command === 'greet') {
-        const name = rest[0];
-        if (!name) {
-            return { exitCode: 1, stdout: '', stderr: '请指定名称' };
-        }
-        return { exitCode: 0, stdout: greet(name), stderr: '' };
-    }
-    if (command === 'config') {
-        return {
-            exitCode: 0,
-            stdout: JSON.stringify(createConfig(), null, 2),
-            stderr: '',
-        };
-    }
-    if (command === 'ai') {
-        try {
-            const agent = new AiAgent();
-            await agent.startInteractiveChat();
-            return { exitCode: 0, stdout: '', stderr: '' };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return { exitCode: 1, stdout: '', stderr: message };
-        }
-    }
-    if (command === '--version' || command === '-v' || command === '-V') {
-        return { exitCode: 0, stdout: `v${VERSION}`, stderr: '' };
-    }
-    const helpText = [
-        `ZapMyCo v${VERSION}`,
-        '',
-        '用法:',
-        '  greet <name>       向指定名称打招呼',
-        '  config             显示配置信息',
-        '  ai                 进入 AI 对话模式',
-        '  --version, -v, -V  显示版本号',
-        '  --help, -h         显示帮助信息',
-    ].join('\n');
-    if (!command || command === '--help' || command === '-h') {
-        return { exitCode: 0, stdout: helpText, stderr: '' };
-    }
-    return {
-        exitCode: 1,
-        stdout: '',
-        stderr: `未知命令: ${command}\n${helpText}`,
-    };
-}
-if (globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).main) {
-    const result = await cli(dntShim.Deno.args);
-    if (result.stderr)
-        console.error(result.stderr);
-    if (result.stdout)
-        console.log(result.stdout);
-    dntShim.Deno.exit(result.exitCode);
-}
 // 默认导出
 export default {
     greet,

package/esm/src/models.js

@@ -0,0 +1,72 @@
+/**
+ * Models - 内置模型注册表
+ *
+ * 集中维护所有内置模型的元信息（供应商归属、baseURL、能力）。
+ * settings.json 中只需引用模型名称，详细信息由此处提供。
+ */
+/** 内置模型注册表 */
+const BUILT_IN_MODELS = {
+    'deepseek-v4-flash': {
+        provider: 'deepseek',
+        baseURL: 'https://api.deepseek.com/anthropic',
+        capabilities: ['text'],
+        contextWindow: 1_000_000,
+        maxOutputTokens: 384_000,
+    },
+    'deepseek-v4-pro': {
+        provider: 'deepseek',
+        baseURL: 'https://api.deepseek.com/anthropic',
+        capabilities: ['text'],
+        contextWindow: 1_000_000,
+        maxOutputTokens: 384_000,
+    },
+    'deepseek-reasoner': {
+        provider: 'deepseek',
+        baseURL: 'https://api.deepseek.com/anthropic',
+        capabilities: ['text'],
+        contextWindow: 128_000,
+        maxOutputTokens: 16_384,
+    },
+    'glm-4-flash': {
+        provider: 'glm',
+        baseURL: 'https://open.bigmodel.cn/api/anthropic',
+        capabilities: ['text'],
+        contextWindow: 128_000,
+        maxOutputTokens: 16_384,
+    },
+    'glm-4v': {
+        provider: 'glm',
+        baseURL: 'https://open.bigmodel.cn/api/anthropic',
+        capabilities: ['text', 'vision'],
+        contextWindow: 128_000,
+        maxOutputTokens: 16_384,
+    },
+    'glm-5v-turbo': {
+        provider: 'glm',
+        baseURL: 'https://open.bigmodel.cn/api/anthropic',
+        capabilities: ['text', 'vision'],
+        contextWindow: 200_000,
+        maxOutputTokens: 128_000,
+    },
+    'glm-5.1': {
+        provider: 'glm',
+        baseURL: 'https://open.bigmodel.cn/api/anthropic',
+        capabilities: ['text'],
+        contextWindow: 200_000,
+        maxOutputTokens: 128_000,
+    },
+};
+/**
+ * 根据模型名称获取内置模型信息
+ * @param name - 模型名称
+ * @returns 模型信息，未找到时返回 undefined
+ */
+export function getModelInfo(name) {
+    return BUILT_IN_MODELS[name];
+}
+/**
+ * 获取所有内置模型名称列表
+ */
+export function getBuiltInModelNames() {
+    return Object.keys(BUILT_IN_MODELS);
+}

package/esm/src/settings.js

@@ -0,0 +1,111 @@
+/**
+ * Settings - ~/.zapmyco/settings.json 配置管理
+ */
+import * as dntShim from "../_dnt.shims.js";
+const SETTINGS_PATH = '.zapmyco/settings.json';
+/**
+ * 将旧版格式转换为新版格式
+ * 旧版: { llm: { apiKey, baseURL, model } }
+ * 新版: { llm: { providers: { default: { apiKey } }, models: { default: model } } }
+ * 只提取字符串类型的值
+ */
+function convertLegacySettings(legacy) {
+    return {
+        providers: {
+            default: {
+                apiKey: typeof legacy.apiKey === 'string' ? legacy.apiKey : undefined,
+            },
+        },
+        models: {
+            default: typeof legacy.model === 'string' ? legacy.model : 'deepseek-v4-flash',
+        },
+    };
+}
+/**
+ * 检测是否为旧版 LLM 配置格式
+ * 要求 apiKey 或 model 为字符串类型
+ */
+function isLegacyFormat(llm) {
+    if (typeof llm !== 'object' || llm === null)
+        return false;
+    return typeof llm.apiKey === 'string' ||
+        typeof llm.model === 'string';
+}
+/**
+ * 解析 ${env.VAR} 引用
+ * - "${env.DEEPSEEK_API_KEY}" → 从环境变量 DEEPSEEK_API_KEY 读取
+ * - "sk-xxx" → 原样返回
+ */
+export function resolveEnvRef(value) {
+    const match = value.match(/^\$\{env\.(.+)\}$/);
+    if (!match)
+        return value;
+    const envVar = match[1];
+    const resolved = dntShim.Deno.env.get(envVar);
+    if (!resolved) {
+        throw new Error(`环境变量 ${envVar} 未设置。请在 ${SETTINGS_PATH} 中配置或设置环境变量 ${envVar}。`);
+    }
+    return resolved;
+}
+/**
+ * 加载 ~/.zapmyco/settings.json
+ * 文件不存在时返回 null，不报错
+ * 自动兼容旧版格式
+ */
+export function loadSettings() {
+    const home = dntShim.Deno.env.get('HOME');
+    if (!home)
+        return null;
+    const filePath = `${home}/${SETTINGS_PATH}`;
+    try {
+        const content = dntShim.Deno.readTextFileSync(filePath);
+        const parsed = JSON.parse(content);
+        const llmRaw = parsed?.llm;
+        if (!llmRaw || typeof llmRaw !== 'object')
+            return {};
+        // 兼容旧版格式
+        if (isLegacyFormat(llmRaw)) {
+            return { llm: convertLegacySettings(llmRaw) };
+        }
+        // 新版格式
+        const llm = llmRaw;
+        const providers = {};
+        if (llm.providers && typeof llm.providers === 'object') {
+            for (const [name, cfg] of Object.entries(llm.providers)) {
+                if (typeof cfg === 'object' && cfg !== null) {
+                    const pc = cfg;
+                    providers[name] = {
+                        apiKey: typeof pc.apiKey === 'string' ? pc.apiKey : undefined,
+                    };
+                }
+            }
+        }
+        const models = {};
+        if (llm.models && typeof llm.models === 'object') {
+            for (const [name, modelName] of Object.entries(llm.models)) {
+                if (typeof modelName === 'string') {
+                    models[name] = modelName;
+                }
+            }
+        }
+        return {
+            llm: {
+                providers: Object.keys(providers).length > 0 ? providers : undefined,
+                models: Object.keys(models).length > 0 ? models : undefined,
+            },
+        };
+    }
+    catch (error) {
+        // 文件不存在
+        if (error instanceof dntShim.Deno.errors.NotFound)
+            return null;
+        // Deno 权限拒绝（NotCapable）
+        if (error instanceof Error && error.name === 'NotCapable')
+            return null;
+        // JSON 解析错误
+        if (error instanceof SyntaxError) {
+            throw new Error(`${filePath} JSON 格式错误: ${error.message}`);
+        }
+        throw error;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zapmyco",
-  "version": "0.20.6",
+  "version": "0.22.1",
   "description": "AI 原生的 TypeScript 启动模板，专为 AI 辅助开发时代打造",
   "repository": {
     "type": "git",
@@ -18,10 +18,16 @@
         "types": "./types/src/index.d.ts",
         "default": "./esm/src/index.js"
       }
+    },
+    "./cli": {
+      "import": {
+        "types": "./types/src/cli.d.ts",
+        "default": "./esm/src/cli.js"
+      }
     }
   },
   "bin": {
-    "zapmyco": "./esm/src/index.js"
+    "zapmyco": "./esm/src/cli.js"
   },
   "publishConfig": {
     "provenance": true,
@@ -29,6 +35,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "0.39",
+    "commander": "14",
     "@deno/shim-deno": "~0.18.0"
   },
   "devDependencies": {

package/types/deno.d.ts

@@ -6,7 +6,8 @@ declare namespace _default {
     let exports: string;
     let tasks: {
         cli: string;
-        ai: string;
+        init: string;
+        settings: string;
         "install:global": string;
         dev: string;
         test: string;

package/types/src/ai-agent.d.ts

@@ -1,11 +1,20 @@
 /** AiAgent 配置选项 */
 export interface AiAgentOptions {
-    /** API Key，默认从 DEEPSEEK_API_KEY 环境变量读取 */
+    /** API Key，默认从 settings.json 或 DEEPSEEK_API_KEY 环境变量读取 */
     apiKey?: string;
-    /** API 基础 URL，默认 https://api.deepseek.com/anthropic */
+    /** API 基础 URL，默认从内置模型注册表读取 */
     baseURL?: string;
-    /** 模型名称，默认 deepseek-v4-flash */
+    /** 模型名称，默认从 modelProfile 或内置模型注册表读取 */
     model?: string;
+    /**
+     * 模型配置档名称（对应 settings.json llm.models 中的 key）
+     * 如 "default"、"advanced"、"light"、"vision"
+     */
+    modelProfile?: string;
+    /** 供应商名称（对应 settings.json llm.providers 中的 key） */
+    provider?: string;
+    /** 最大输出 tokens，默认从内置模型注册表读取 */
+    maxTokens?: number;
     /** 系统提示词 */
     systemPrompt?: string;
 }
@@ -20,11 +29,12 @@ export interface Message {
 export declare class AiAgent {
     private client;
     private model;
+    private maxTokens;
     private messages;
     private systemPrompt;
     constructor(options?: AiAgentOptions);
     /**
-     * 非流式对话 - 发送消息并获取完整回复
+     * 非流式对话（内部使用流式 API） - 发送消息并获取完整回复
      * @param input - 用户输入
      * @returns 完整回复文本
      */

package/types/src/ai-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-agent.d.ts","sourceRoot":"","sources":["../../src/src/ai-agent.ts"],"names":[],"mappings":"AASA,mBAAmB;AACnB,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,WAAW;AACX,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,GAAE,cAAmB;IAgBxC;;;;OAIG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB1C;;;;;OAKG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC9B,OAAO,CAAC,MAAM,CAAC;IAsBlB;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IA0C3C,cAAc;IACd,YAAY,IAAI,IAAI;IAIpB,eAAe;IACf,WAAW,IAAI,SAAS,OAAO,EAAE;CAGlC"}
+{"version":3,"file":"ai-agent.d.ts","sourceRoot":"","sources":["../../src/src/ai-agent.ts"],"names":[],"mappings":"AAWA,mBAAmB;AACnB,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,WAAW;AACX,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,GAAE,cAAmB;IAkDxC;;;;OAIG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsB1C;;;;;OAKG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC9B,OAAO,CAAC,MAAM,CAAC;IAsBlB;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IA0C3C,cAAc;IACd,YAAY,IAAI,IAAI;IAIpB,eAAe;IACf,WAAW,IAAI,SAAS,OAAO,EAAE;CAGlC"}

package/types/src/cli.d.ts

@@ -0,0 +1,22 @@
+/**
+ * CLI 入口 — 基于 Commander.js 的命令行界面
+ */
+import "../_dnt.polyfills.js";
+/**
+ * CLI 执行结果
+ */
+export interface CliResult {
+    /** 退出码 */
+    exitCode: number;
+    /** 标准输出 */
+    stdout: string;
+    /** 错误输出 */
+    stderr: string;
+}
+/**
+ * CLI 入口 - 解析参数并执行对应操作
+ * @param args - 命令行参数数组
+ * @returns CLI 执行结果
+ */
+export declare function cli(args: string[]): Promise<CliResult>;
+//# sourceMappingURL=cli.d.ts.map

package/types/src/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/src/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,sBAAsB,CAAC;AAS9B;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,UAAU;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AA6HD;;;;GAIG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAsJ5D"}

package/types/src/index.d.ts

@@ -48,23 +48,6 @@ export declare function greet(name: string): string;
  * ```
  */
 export declare function createConfig(options?: ConfigOptions): Config;
-/**
- * CLI 执行结果
- */
-export interface CliResult {
-    /** 退出码 */
-    exitCode: number;
-    /** 标准输出 */
-    stdout: string;
-    /** 错误输出 */
-    stderr: string;
-}
-/**
- * CLI 入口 - 解析参数并执行对应操作
- * @param args - 命令行参数数组
- * @returns CLI 执行结果
- */
-export declare function cli(args: string[]): Promise<CliResult>;
 declare const _default: {
     greet: typeof greet;
     createConfig: typeof createConfig;

package/types/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,sBAAsB,CAAC;AAQ9B,cAAc;AACd,eAAO,MAAM,OAAO,EAAE,MAAyB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,eAAe;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW;IACX,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,eAAe;IACf,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,WAAW;IACX,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACvD,WAAW;IACX,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAO5D;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,UAAU;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAsD5D;;;;;;AAUD,wBAIE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,sBAAsB,CAAC;AAK9B,cAAc;AACd,eAAO,MAAM,OAAO,EAAE,MAAyB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,eAAe;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW;IACX,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,eAAe;IACf,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,WAAW;IACX,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACvD,WAAW;IACX,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAO5D;;;;;;AAGD,wBAIE"}

package/types/src/models.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Models - 内置模型注册表
+ *
+ * 集中维护所有内置模型的元信息（供应商归属、baseURL、能力）。
+ * settings.json 中只需引用模型名称，详细信息由此处提供。
+ */
+/** 模型能力 */
+export type ModelCapability = 'text' | 'vision';
+/** 内置模型信息 */
+export interface BuiltInModel {
+    /** 所属供应商标识（对应 settings.json 中 llm.providers 的 key） */
+    provider: string;
+    /** API 基础地址 */
+    baseURL: string;
+    /** 模型能力列表 */
+    capabilities: ModelCapability[];
+    /** 上下文窗口大小（tokens） */
+    contextWindow?: number;
+    /** 最大输出 tokens */
+    maxOutputTokens?: number;
+}
+/**
+ * 根据模型名称获取内置模型信息
+ * @param name - 模型名称
+ * @returns 模型信息，未找到时返回 undefined
+ */
+export declare function getModelInfo(name: string): BuiltInModel | undefined;
+/**
+ * 获取所有内置模型名称列表
+ */
+export declare function getBuiltInModelNames(): string[];
+//# sourceMappingURL=models.d.ts.map

package/types/src/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/src/models.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,WAAW;AACX,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEhD,aAAa;AACb,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa;IACb,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,sBAAsB;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAuDD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEnE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C"}

package/types/src/settings.d.ts

@@ -0,0 +1,32 @@
+/** 供应商配置 */
+export interface ProviderConfig {
+    /** API 密钥，支持 ${env.VAR} 语法 */
+    apiKey?: string;
+}
+/** LLM 配置（新格式） */
+export interface LlmSettings {
+    /** 供应商字典，key 为唯一标识名（如 "deepseek"、"glm"） */
+    providers?: Record<string, ProviderConfig>;
+    /**
+     * 模型配置档字典，key 为配置档名称（如 "default"、"advanced"、"light"、"vision"），
+     * value 为模型名称（对应内置模型注册表中的名称）
+     */
+    models?: Record<string, string>;
+}
+/** 顶层配置 */
+export interface Settings {
+    llm?: LlmSettings;
+}
+/**
+ * 解析 ${env.VAR} 引用
+ * - "${env.DEEPSEEK_API_KEY}" → 从环境变量 DEEPSEEK_API_KEY 读取
+ * - "sk-xxx" → 原样返回
+ */
+export declare function resolveEnvRef(value: string): string;
+/**
+ * 加载 ~/.zapmyco/settings.json
+ * 文件不存在时返回 null，不报错
+ * 自动兼容旧版格式
+ */
+export declare function loadSettings(): Settings | null;
+//# sourceMappingURL=settings.d.ts.map

package/types/src/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/src/settings.ts"],"names":[],"mappings":"AAQA,YAAY;AACZ,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kBAAkB;AAClB,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AASD,WAAW;AACX,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,EAAE,WAAW,CAAC;CACnB;AA+BD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYnD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,QAAQ,GAAG,IAAI,CA6D9C"}