AI 编程 · Agentic 审阅工作流
Claude Code 与 Cursor 写了一堆 plan.md?
开发者的本地轻量审阅工作流
当日常开发变成 Claude Code 在终端自主推演、Cursor 在后台执行任务时,项目根目录和 .notes/ 很快就会堆满各类 Markdown 文件:plan.md、AGENTS.md、CLAUDE.md 以及架构 RFC。
AI 写方案越来越快,但人类作为把关人(Human-in-the-loop),如何优雅、快速地审查和微调这些计划,成了新的效率卡点。
在浏览器中直接打开本地项目目录,免安装审阅 plan.md →
一、审阅 AI 计划文档的传统痛点
在放行 Agent 执行写代码之前,仔细检查 plan.md 是防止破坏性变更的关键。然而常见的查看方式各有摩擦:
- 终端命令行(cat/less):遇到长篇包含任务列表、表格和 Mermaid 架构图的计划时,终端纯文本滚动困难,缺乏大纲层级感;
- IDE 窗口过载:Cursor / VS Code 已经开满了代码、调试控制台和侧边栏,强行挤入 Markdown 预览分栏让屏幕拥挤不堪;
- 重型桌面笔记软件(Obsidian/Typora):为了临时扫一眼几千字的文件特意启动数百兆的客户端,还要处理 Vault 配置与插件冲突;
- 云端粘贴工具:将包含内部系统架构的技术方案上传到第三方网页,带来隐私与数据泄露隐患。
二、基于浏览器原生文件 API 的解法
现代 Chromium 浏览器(Chrome、Edge、Arc 等)原生提供了 File System Access API。无需安装扩展或桌面客户端,网页就能在经用户授权后,安全、直接地读写本地指定文件夹。
基于这一底层特性,轻量网页工具 NoteLoom(app.noteloom.cc)提供了一种零门槛的协同姿势:
- 3 秒挂载工程目录:在浏览器中点击「打开我的文件夹」,选中你的工程根目录或
docs/目录; - 全格式即时排版:左侧完整呈现项目文件树,右侧将
plan.md的大纲标题、任务复选框- [ ]、代码高亮与架构图完美渲染; - 实时双向回写:发现方案有疏漏,直接在网页里改字,按
Ctrl+S实时存回磁盘原文件,终端里的 Agent 立即读取最新指令。
三、推荐的双屏日常协同姿势
许多开发者采用的优雅布局是:
- 主屏幕:Cursor / VS Code 负责全屏沉浸式编写核心代码与终端构建;
- 副屏幕(或常驻浏览器标签页):保持
app.noteloom.cc打开,挂载项目文档区,像仪表盘一样随时审阅 Agent 生成的计划与架构文档。
常见问题(FAQ)
为什么不直接在 Cursor 或 VS Code 里分栏预览 Markdown?
在复杂项目中,IDE 往往已经开满了多列代码、终端面板和 AI 对话侧边栏。再分一栏给 Markdown 预览会严重挤占视野,且在大文件或长计划下容易造成编辑器快捷键冲突或渲染延迟。
为什么不把 plan.md 复制到在线大模型或云端文档里看?
AI 生成的技术计划和 PRD 包含深度的业务上下文、数据表结构和系统边界,复制到第三方云端有严重的代码与商业泄密风险;且拷进拷出会彻底打断本地文件的连续迭代链路。
NoteLoom 是怎么做到不上传文件就能在浏览器里读写的?
NoteLoom 依赖现代浏览器(Chrome、Edge 等)原生的 File System Access API。经你授权后,它直接读写你本地磁盘上的真实文件,所有解析和渲染都在本地浏览器沙盒内完成。打开、编辑、保存这些 .md 文件这条链路上没有上传动作。
我在网页端修改了 plan.md,终端里的 Claude Code 能立刻读到吗?
能。在 NoteLoom 里按 Ctrl+S 是直接写回你磁盘上的原文件,没有中间缓存。终端里的 Claude Code 或 Cursor 在执行下一步时,直接读取该文件即为你刚刚修改后的最新内容。
这个轻量工作流支持哪些浏览器?
需要支持 File System Access API 的 Chromium 内核桌面浏览器。NoteLoom 在 Google Chrome、Microsoft Edge、Arc 上验证过。
NoteLoom 的 AI 对话面板会把我的 plan.md 发出去吗?
只有你打开面板并发出消息时才会。发出去的是对话内容,加上模型通过工具调用真正读到的笔记正文,每次读取都会显示一张卡片,标出文件路径和读取的字符数。免费额度用内置的 GLM-5.3-Flash,请求发往 chat.noteloom.cc;你也可以在网页端填自己的 DeepSeek 或智谱 GLM 密钥,这时请求由浏览器直连对应厂商。打开、编辑、保存 .md 文件本身是另一条链路,仍然只发生在你的磁盘上。面板默认停在「逐次批准」权限档,改写文件前会先问你。
在浏览器独立视窗中审阅 AI 计划
无需把长篇 plans 挤在满是代码标签的 IDE 分栏里。用 Chrome / Edge 打开 NoteLoom,挂载项目目录,以渲染排版审阅 plan.md,改完自动存回磁盘,文件全程留在本地。
免安装挂载工作区审阅计划 →发布于