Ch1: 搭建骨架

本章我们将创建项目的骨架。不要小看骨架——好的骨架支撑起整个建筑，好的项目结构支撑起后续所有功能的扩展。我们将初始化 Node.js 项目、设置 TypeScript、创建 CLI 入口，最终得到一个能运行的命令行程序。

本章目标

• 理解为什么 CLI 是 AI 编程助手的最佳形态
• 掌握 TypeScript + Node.js 项目初始化
• 创建一个可扩展的 CLI 框架
• 实现基础的配置系统

为什么选择 CLI？

在开始编码之前，让我们思考一个问题：为什么 Claude Code 选择 CLI 而非 GUI？

CLI 的优势：

• 快速启动 — 无需等待 Electron 或浏览器加载
• 低资源占用 — 适合在远程服务器或容器中运行
• 开发者友好 — 与现有工具链（Git、Docker、CI/CD）无缝集成
• 自动化就绪 — 易于脚本化和批处理

项目初始化

第一步：创建目录结构

一个好的项目结构应该让代码的意图一目了然。我们采用按功能分层的方式：

my-ai-coder/
├── src/
│   ├── index.ts          # CLI 入口
│   ├── commands/         # 命令实现
│   ├── config/           # 配置管理
│   └── types/            # 类型定义
├── dist/                 # 编译输出
├── config.json           # 用户配置
└── package.json

第二步：初始化 Node.js 项目

mkdir my-ai-coder
cd my-ai-coder
npm init -y

第三步：安装依赖

npm install typescript tsx @types/node --save-dev
npm install commander chalk

依赖说明：

• commander — 业界标准的 CLI 框架，Express.js 也在用
• chalk — 让终端输出带颜色，提升可读性
• tsx — 开发时直接运行 TypeScript，无需等待编译

TypeScript 配置

创建 tsconfig.json：

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "esModuleInterop": true,
    "strict": true,
    "outDir": "./dist",
    "rootDir": "./src"
  }
}

创建 CLI 入口

CLI 入口是用户与系统交互的第一道门。我们需要：

1. 解析命令行参数
2. 显示帮助信息
3. 路由到对应的命令处理函数

创建 src/index.ts：

#!/usr/bin/env node
import { Command } from 'commander';
import chalk from 'chalk';

const program = new Command();

program
  .name('my-ai-coder')
  .description('AI 编程助手')
  .version('1.0.0');

program
  .command('chat')
  .description('开始对话')
  .action(() => {
    console.log(chalk.cyan('🤖 你好！我是你的 AI 编程助手。'));
    console.log(chalk.gray('提示: 输入 exit 退出'));
  });

program.parse();

添加到 package.json

{
  "bin": {
    "my-ai-coder": "./dist/index.js"
  },
  "scripts": {
    "build": "tsc",
    "dev": "tsx src/index.ts"
  }
}

bin 字段让 npm 知道如何全局安装你的 CLI。

运行测试

开发模式运行：

npm run dev chat

预期输出：

🤖 你好！我是你的 AI 编程助手。
提示: 输入 exit 退出

配置系统基础

一个可配置的 CLI 才能适应不同场景。我们实现一个简单的 JSON 配置：

创建 src/config/index.ts：

import fs from 'fs/promises';
import path from 'path';
import os from 'os';

export interface Config {
  apiKey?: string;
  model: string;
  verbose: boolean;
}

const defaultConfig: Config = {
  model: 'claude-sonnet-4-6',
  verbose: false,
};

export async function loadConfig(): Promise<Config> {
  const configPath = path.join(os.homedir(), '.my-ai-coder.json');

  try {
    const content = await fs.readFile(configPath, 'utf-8');
    const userConfig = JSON.parse(content);
    return { ...defaultConfig, ...userConfig };
  } catch {
    return defaultConfig;
  }
}

本章小结

我们完成了：

• ✅ Node.js + TypeScript 项目初始化
• ✅ CLI 框架搭建
• ✅ 基础配置系统
• ✅ 第一次运行