辛苦完成项目、提交代码后，却发现 README.md 依然空白——这种尴尬许多开发者都深有体会。Fitten Code 内置的 AI 文档生成工具正好填补了这一短板：它能根据项目结构及代码内容，自动生成包含安装步骤、使用示例、技术栈说明等完整信息的 README 文档，彻底告别手动整理的繁琐流程。

先明确几个必备条件：要使用该功能，Fitten Code 桌面端版本需为 2.4.0 或更高，已登录账号并完成 AI 服务授权。若右下角状态栏显示“AI 未就绪”，则需按照指引绑定 OpenAI 或 Claude 的 API 密钥。关键操作：完成密钥保存后务必重启编辑器，否则所有 AI 功能均无法正常激活。

一切就绪后，在项目根目录右键选择“Generate README with AI”，弹出窗口中确认当前工作区路径无误，然后点击“Start Analysis”。此步骤将扫描项目中的 .py、.js、.ts、.go 等主要语言文件，以及 requirements.txt、package.json、pyproject.toml 等配置文件，耗时约 3 至 8 秒，具体视项目规模而定。

启用 Fitten Code 的 AI 自动生成 README 功能

需要说明的是，初次使用时容易忽略一个细节：扫描完成后并不会直接输出完整文档，而是提供三种生成路径，可根据实际需求灵活选择。

方法一：聚焦单个入口文件生成

在编辑区打开 main.py 或 index.ts 等主启动文件，按 Ctrl+Shift+A（Windows）或 Cmd+U（Mac）唤出 AI 对话框，然后输入指令，例如：“基于当前文件逻辑与项目结构，生成中文 README.md，重点突出 CLI 参数说明和错误处理机制”。此方式适合仅需针对核心模块生成文档的场景。

方法二：引用整个项目上下文

在对话框中输入 #Folder，待右侧出现“Project context loaded”提示后，再发送更详细的请求，比如：“生成含‘快速开始’‘环境变量’‘测试命令’三节的 README，忽略贡献指南”。特别提醒：若未看到上下文加载成功的提示，生成内容会严重缺失依赖信息，最终结果可能不够理想。

方法三：修补已有 README

如果项目中已存在一个半成品的 README 文件，无需完全推倒重来。打开现有 README.md，全选内容复制到 AI 对话框，然后追加指令，例如：“重写‘API 接口’章节，从 src/api/ 目录下所有 TS 文件中提取 @GET/@POST 路由及参数类型，用表格呈现”。这种方式效率最高，能精准补全缺失的部分。

导出与验证生成结果

AI 输出完成后，切忌直接复制粘贴——验证环节的重要性怎么强调都不为过。

第一步，检查是否包含可执行的命令。例如 pip install -e . 或 npm run dev 这类真正能运行的指令；若出现 pip install mypackage==1.0.0 等硬编码版本号，需手动改为 pip install -e . 或直接移除版本锁定。

第二步，点击右上角的“Preview in Markdown”按钮，查看渲染效果。重点检查代码块语法高亮是否正确——比如 Python 代码块应为 ```python，而非 ```py；同时确认链接是否指向项目内的真实路径，例如：[配置说明](docs/config.md) 不应写作 [配置说明](./config.md)。

第三步，将生成内容全选，粘贴到项目根目录下的 README.md，保存文件。如果项目有 docs/book.toml 配置，可在终端执行 mdbook serve；否则直接用浏览器打开 README.md 验证本地渲染效果。准确、完整、可校验——这是最终文档的核心底线。