Code Review Notes for AI

在 VS Code 中选中代码、添加 Review 评论，跨文件汇总为可复制给 Code Agent 的 Prompt。每次“重新Review”都会归档当前轮并清空代码中的评论。

安装

要求 VS Code 1.90 或更新版本。

也可以通过命令行安装：

code --install-extension ga0sh3n.vsc-review

本地构建的安装包仍可通过扩展面板右上角 … → 从 VSIX 安装…，选择 vsc-review-0.1.0.vsix 安装，或在本项目目录执行：

code --install-extension ./vsc-review-0.1.0.vsix

如果曾安装发布者为 local-review 的本地测试版，请先禁用或卸载旧版，避免两个扩展使用相同命令。商店版是新的扩展身份；旧版的评论与历史不会自动迁移。

在编辑器选中一段代码，右键选择 添加 Review 评论。输入问题，点击 保存评论。也可以通过代码行号旁的评论入口创建评论。

可以在多个文件里重复操作。每条评论保存文件路径、选区起止位置、选中代码原文、问题描述和时间。右侧行内评论支持编辑、取消编辑和删除；左侧 Review 侧栏按文件显示本轮问题，点击即可定位。

命令面板中也可以执行 Code Review: 添加 Review 评论。

点击 Review 侧栏中的 反馈给AI处理，或者使用侧栏标题栏的复制图标。

插件会汇总本轮所有文件的评论，生成 Markdown Prompt，自动复制到剪贴板并在编辑器中打开。检查后粘贴给你使用的 Code Agent。

Prompt 包含：

生成 Prompt 后本轮评论继续保留，可以补充问题后再次生成。

点击 重新Review，或者侧栏标题栏的刷新图标。插件先保存本轮历史，再清除代码窗口中的全部评论和未提交草稿，创建新一轮。

历史记录显示在侧栏的 历史记录 中，点击某一轮即可打开并复制该轮 Prompt。空轮次不会生成历史。

当前轮和历史保存在 VS Code 的工作区私有存储中，关闭或重载窗口后恢复。不向项目目录写评论文件。不同工作区分别管理自己的记录；多根工作区的路径包含根目录名称。

行号和代码原文采用评论时的快照。 插件不自动追踪后续代码移动、文件改名或 Git 分支切换。Agent 修改代码前应核实快照与当前文件是否一致；修改完成后点击“重新Review”开始下一轮。原文件不存在时，快照和评论仍然保留。

评论保存失败时会显示错误，并保留已有数据；修正存储问题后可以重试。

npm ci
npm test
npm run test:host
npm run package

npm test：编译并运行数据、Prompt 和保存边界测试。
npm run test:host：在独立临时工作区和用户数据目录中启动 VS Code，测试真实原生评论、复制 Prompt、归档和关闭后恢复。macOS 优先使用 /Applications/Visual Studio Code.app；也可通过 VSCODE_EXECUTABLE_PATH 指定 VS Code 可执行文件，其他环境使用测试工具下载的 VS Code。
npm run package：生成 vsc-review-0.1.0.vsix。

在 VS Code 中打开本项目，按 F5，选择 运行 Code Review 插件，即可启动扩展开发窗口；在新窗口里打开要测试的文件夹。

插件没有运行时第三方依赖；TypeScript、类型定义、测试和打包工具仅用于开发。