一个人的项目文件整理术

先画出项目边界

一个项目对应一个根文件夹。把代码、文档、公开图片和本地配置放在同一边界内；另一个产品、练习或客户任务另建文件夹。这样 Agent 打开工作区时，不会把无关资料当成当前项目的一部分。

如果一张图片只属于一个网站，就跟着这个网站走；如果它是你所有产品共用的头像原件，可以单独保留一份，再按需要复制导出的版本。不要让正式页面引用某个临时下载目录里的文件。

选择存放位置

Windows 可以在空间充足的非系统盘建立 D:\Projects；macOS 可以在用户目录建立 ~/Projects，或放在已纳入备份的专用磁盘。桌面可以暂放待处理文件，不适合作为长期项目仓库；Windows 桌面通常仍位于系统盘的用户目录。

1. 先选根目录。所有项目从一个固定入口找得到，不再散落在桌面、下载和聊天附件目录。
2. 按项目命名。用简短、稳定的名称，例如 layman-site；不要用“最终版2_真的最终版”。
3. 只打开需要的工作区。让 AI 工具只在当前项目目录内工作。需要读取其他位置时，先明确说明用途与范围。

一套够用的目录

项目不需要一开始就有十几层目录。下面这套结构足够容纳网页、设计稿和交接说明；没有内容的目录可以暂时不建。

Projects/
  my-site/                  # 一个项目只有一个根目录
    README.md               # 它是什么、怎样运行、在哪里部署
    src/                    # 程序源码
    public/                 # 确定可以公开的图片与文件
    assets/                 # 原始设计稿、可编辑素材
    docs/                   # 需求、决策与交接说明
    .env.example            # 变量名示例，不放真实密码
    .env.local              # 本机密钥；加入 .gitignore
    .gitignore              # 不需要提交的文件
  experiments/
    small-test/             # 一次性练习与正式项目分开

public 只放允许访客直接取得的内容。身份证件、客户文件、付费资料原件和 API Key 不属于这里。assets 存可编辑原稿，导出后的网页资源再放入 public。框架自己生成的 node_modules、构建目录通常不必手动搬运或提交到 Git。

命名与素材归档

文件名要能在搜索结果里独立说明自己。用“对象—用途—版本或日期”比用“新建文件(7)”更有用，例如 home-hero-desktop-2026-09.webp、interview-notes-2026-09-20.md。日期推荐采用年-月-日，排序时自然按时间排列。

密钥与账号分开

API Key、数据库密码、邮件授权码和服务器私钥不是“项目素材”。开发时用本机环境变量文件或工具的密钥设置保存；仓库只放列出变量名的 .env.example，并确认真实配置被 .gitignore 排除。不要把密钥粘贴进截图、教程、Issue 或前端代码。

公开链接和密钥也要分开：域名、项目介绍可以写进 README；密码和私钥只放在受保护的位置。若不小心提交过密钥，删除文件并不等于密钥失效，还需要到服务商处撤销旧密钥。

版本与备份

Git 记录代码如何变化，备份负责在磁盘损坏、误删或账号无法登录时取回资料，两者不能互相替代。至少区分三类：可从仓库重建的代码、必须单独备份的数据库与用户上传文件、需要安全保存的配置和密钥。

1. 每完成一个可用阶段，保存一次版本。提交说明写“增加资料筛选”，比“update”更容易找回。
2. 备份放在项目目录以外。同一块磁盘里的副本不能应对磁盘损坏。重要项目至少有另一处可恢复的副本。
3. 定期试着恢复。抽取一份备份到临时目录，确认能读到所需文件；只看到“备份成功”的提示还不够。

交接与迁移

想换电脑、换 Agent 或隔一段时间再回来时，先让 README 回答：项目解决什么问题、怎么安装和启动、线上在哪里、哪些变量必须配置、数据在哪里。这样下一次打开项目不用重读全部聊天记录。

# [项目名]

一句话说明：[它帮谁解决什么问题]
状态：[练习中 / 开发中 / 已上线 / 已归档]

## 在本地运行
1. 安装依赖：[填写命令]
2. 复制 .env.example 为 .env.local，并在本机填写变量
3. 启动：[填写命令]
4. 预览：[填写本地地址]

## 关键位置
- 页面或功能：[目录]
- 图片与素材：[目录]
- 需求与决策：docs/
- 线上地址：[如有]

## 注意
- 需要保留的数据和上传文件在哪里？
- 备份在哪里，最近一次恢复验证是什么时候？

迁移前先在新位置复制项目，按 README 跑通本地预览，再核对数据库和上传文件。确认新位置可用后，才清理旧副本。不要直接把正在运行的网站目录当作唯一备份。

清理与删除

一个练习项目如果没有独立数据、没有对外服务，确认素材和代码不再需要后，删除整个文件夹即可释放空间。正式项目则先分清“代码副本”和“唯一数据”：仓库能重新拉取代码，但数据库、用户上传文件、域名和服务配置未必能重新生成。

三份可复制模板

从今天开始只做三件事：建统一的 Projects 目录、给正在做的项目补 README、用清单处理不再需要的项目。前面的目录范例和 README 模板已经可复制，下面是删除前的最后一道检查。

准备清理：[项目文件夹的完整路径]

[ ] 确认它不是当前正在运行或已经上线的项目
[ ] 查看 README 与 Git 状态，确认最新修改已保存
[ ] 导出要保留的数据库、上传文件和原创素材
[ ] 确认备份能打开，并记下备份位置
[ ] 先移动到“待删除”目录，观察几天
[ ] 确认不再需要后，再删除项目目录
[ ] 如密钥曾泄露，去服务商处撤销并重新生成