零基础装通 Claude Code：30 分钟造出你的第一个文件整理助手

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

# macOS（已装 Homebrew）
brew install --cask claude-code

# Windows（已装 WinGet）
winget install Anthropic.ClaudeCode

# 先确认 Node 版本 >= 18
node --version

# 没有 Node？用 nvm 装一份长期支持版
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install --lts

# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

claude --version
# 例如输出：1.0.x (Claude Code)

claude

claude login

# 注意等号两边不要有空格
export ANTHROPIC_API_KEY="sk-ant-你的密钥"
claude

claude doctor

mkdir my-file-organizer && cd my-file-organizer
git init
touch README.md        # 给一个非空起点，Claude Code 工作得更稳

claude

在项目根目录创建一个 CLAUDE.md，说明这是一个 Node.js 写的命令行文件整理工具，
技术栈：纯 Node.js 标准库、不依赖第三方包；命令用 npm start 运行。

# 项目：文件整理助手（file-organizer）

一个纯 Node.js 实现的命令行工具，按扩展名把凌乱目录里的文件归类到子文件夹。

## 技术栈
- Node.js 18+，仅用标准库（fs / path），不引入第三方依赖

## 常用命令
- `node organize.js [目录] [--dry-run]` —— 整理指定目录；--dry-run 为预演模式
- `npm start -- ./messy --dry-run` —— 通过 npm 调用

## 规则
- 所有新函数都写注释
- 处理文件时优先考虑安全性：重名自动加序号，绝不覆盖
- 错误信息要中文、可读

用 Node.js 标准库写一个文件整理脚本 organize.js：
1. 接收一个目标目录（默认当前目录）作为参数；
2. 扫描该目录下的文件（不递归子目录），按扩展名分类：
   图片/文档/视频/音频/压缩包/代码/其他；
3. 把每类文件移动到同名的子文件夹里；
4. 文件名冲突时自动加 _1、_2 序号，绝不覆盖；
5. 最后打印一份"整理报告"，显示每类移动了多少个；
6. 加一个 --dry-run 预演模式，只打印将要做什么、不真正移动文件。

#!/usr/bin/env node
// 文件整理助手 organize.js —— 按扩展名把凌乱目录归类到子文件夹
const fs = require('fs');
const path = require('path');

// 分类规则：分类名 -> 包含的扩展名
const RULES = {
  '图片':   ['.jpg', '.jpeg', '.png', '.gif', '.bmp', '.webp', '.svg'],
  '文档':   ['.pdf', '.doc', '.docx', '.txt', '.md', '.xls', '.xlsx', '.ppt', '.pptx', '.csv'],
  '视频':   ['.mp4', '.mov', '.avi', '.mkv', '.flv'],
  '音频':   ['.mp3', '.wav', '.flac', '.aac', '.m4a'],
  '压缩包': ['.zip', '.rar', '.7z', '.tar', '.gz'],
  '代码':   ['.js', '.ts', '.py', '.java', '.c', '.cpp', '.go', '.rs', '.html', '.css', '.json'],
};

// 扩展名 -> 分类名 的反向索引，O(1) 查表
const EXT_TO_CATEGORY = {};
for (const [cat, exts] of Object.entries(RULES)) {
  for (const e of exts) EXT_TO_CATEGORY[e] = cat;
}

function classify(filename) {
  const ext = path.extname(filename).toLowerCase();
  return EXT_TO_CATEGORY[ext] || '其他';
}

function main() {
  const target = path.resolve(process.argv[2] || '.');      // 第一个参数：目录
  const dryRun = process.argv.includes('--dry-run');          // 预演开关

  if (!fs.existsSync(target) || !fs.statSync(target).isDirectory()) {
    console.error(`✗ 目标不是有效目录: ${target}`);
    process.exit(1);
  }

  console.log(`▶ 整理目录: ${target}  ${dryRun ? '(预演模式，不真正移动)' : ''}\n`);

  const moved = {};            // 分类 -> 移动数量
  const skipped = [];          // 未分类文件名
  const entries = fs.readdirSync(target, { withFileTypes: true });

  for (const ent of entries) {
    if (!ent.isFile()) continue;                              // 跳过子目录
    if (ent.name === path.basename(__filename)) continue;     // 跳过脚本自身

    const category = classify(ent.name);
    if (category === '其他') { skipped.push(ent.name); continue; }

    const destDir = path.join(target, category);
    const src = path.join(target, ent.name);

    moved[category] = (moved[category] || 0) + 1;

    if (dryRun) { console.log(`  [预演] ${ent.name} -> ${category}/`); continue; }

    if (!fs.existsSync(destDir)) fs.mkdirSync(destDir);

    // 重名自动加序号：a.png 存在则改为 a_1.png，再存在则 a_2.png……
    let final = path.join(destDir, ent.name), i = 1;
    while (fs.existsSync(final)) {
      const base = path.basename(ent.name, path.extname(ent.name));
      final = path.join(destDir, `${base}_${i}${path.extname(ent.name)}`);
      i++;
    }
    fs.renameSync(src, final);
    console.log(`  ✓ ${ent.name} -> ${category}/`);
  }

  console.log('\n── 整理报告 ────────────────');
  for (const [cat, n] of Object.entries(moved)) console.log(`  ${cat}: ${n} 个`);
  console.log(`  其他(未分类): ${skipped.length} 个`);
  console.log('────────────────────────────');
}

main();

# 回到项目根目录，建一个测试用的凌乱文件夹
mkdir -p messy
cd messy
touch photo.jpg avatar.png report.pdf notes.txt song.mp3 clip.mp4 \
      backup.zip hello.js data.json weirdfile.xyz
cd ..

node organize.js ./messy --dry-run

▶ 整理目录: /.../my-file-organizer/messy  (预演模式，不真正移动)

  [预演] photo.jpg -> 图片/
  [预演] avatar.png -> 图片/
  [预演] report.pdf -> 文档/
  [预演] notes.txt -> 文档/
  [预演] song.mp3 -> 音频/
  [预演] clip.mp4 -> 视频/
  [预演] backup.zip -> 压缩包/
  [预演] hello.js -> 代码/
  [预演] data.json -> 代码/

── 整理报告 ────────────────
  图片: 2 个
  文档: 2 个
  音频: 1 个
  视频: 1 个
  压缩包: 1 个
  代码: 2 个
  其他(未分类): 1 个
────────────────────────────

node organize.js ./messy

messy/
├── 图片/   avatar.png, photo.jpg
├── 文档/   notes.txt, report.pdf
├── 音频/   song.mp3
├── 视频/   clip.mp4
├── 压缩包/ backup.zip
├── 代码/   data.json, hello.js
└── weirdfile.xyz          ← 未分类，原地保留

# 迭代①：新增功能——把每次整理结果写成 manifest.json，支持回滚
给 organize.js 增加一个 manifest.json 记录每次移动的 原路径->新路径，
并加一个 --undo 参数，能根据 manifest.json 把文件移回原位。

# 迭代②：配置外置——分类规则搬到单独文件
把 RULES 抽到 rules.json，启动时读取，方便用户自定义扩展名归属。

# 迭代③：可观测性——加日志
每次移动写入 organize.log，格式：[时间] 文件 -> 目标。

# 迭代④：健壮性——加测试
用 Node 内置的 node:test 给 classify() 和重名加序号逻辑各写一组单测。

flowchart TD
    A[安装 claude<br/>claude --version] --> B[登录认证<br/>claude login / API Key]
    B --> C[建目录 + git init<br/>安全网]
    C --> D[启动 claude<br/>Shift+Tab 进 Plan 模式]
    D --> E[写 CLAUDE.md<br/>项目记忆]
    E --> F[下具体需求<br/>列清行为约束]
    F --> G{审计划}
    G -->|不满意| F
    G -->|满意| H[Claude Code 写文件]
    H --> I[--dry-run 预演<br/>node --test 验证]
    I --> J{通过?}
    J -->|否| K[一句话提改进<br/>继续迭代]
    K --> I
    J -->|是| L[git commit<br/>固化成果]
    L --> M[下一轮需求]
    M --> F