CodeFlow by Jensen

CodeFlow 是 VS Code 插件，用文件夹整理跨文件的代码阅读路线，并把相关本地文档、文件夹放在同一条链路中。适合记录“LED 链路”“通信链路”等功能的关键步骤。

当前能力

• Flows 标题 +：直接命名，创建根文件夹，不需要打开代码编辑器。
• 文件夹旁 +：捕获当前光标，直接命名并创建小节点；点击小节点跳转。
• 代码加号左侧的文件夹加号：选择添加本地文件或文件夹，默认放在当前目录末尾。
• 资料统一使用蓝色图标；点击打开，右键可重新选择路径或使用系统默认程序打开。
• 文件夹可嵌套；代码节点和资料可混合排序、跨目录移动；文件夹可整体拖动。
• 行内 ×：直接删除对应记录或整个文件夹子树，不删除磁盘文件；没有确认框或撤销。
• 同一项目/工作区关闭重开恢复结构、顺序和绑定；位置不确定时显示原因，可右键“重新绑定到当前光标”。

行内按钮在悬停、选中或聚焦时出现，文件夹折叠/展开均可使用。需要子文件夹时，先通过标题 + 创建，再拖入目标文件夹。

开始使用

1. 在 VS Code 打开项目文件夹，打开活动栏 CodeFlow → Flows。
2. 点击 Flows 标题 +，输入“LED 链路”等名称。
3. 打开已保存的本地代码文件，把光标放在目标行，点击链路旁 +，给代码节点命名。
4. 点击代码加号左侧的文件夹加号，选择“文件”或“文件夹”，再使用选择框添加资料。
5. 点击代码节点返回对应行；点击资料打开文件，文件夹资料在系统文件管理器中打开。
6. 拖动记录调整排列或归属。关闭后重新打开同一工作区，记录会自动恢复。

资料保存的是原路径引用，不会复制文件内容。PDF、Office 等文档交给系统默认程序打开，文本和代码在 VS Code 中打开；路径找不到时记录会保留，可右键重新选择路径。文件夹资料是一个链接，不会在 CodeFlow 内展开磁盘目录。

开发与验证

宿主声明为 VS Code ^1.138.0，清单版本为 0.0.1，尚未标记发布。

1. 在 VS Code 打开此工程，缺依赖时执行 npm ci。
2. 执行 npm run compile、npm run lint；自动化验证用 npm test。
3. 选择 Run Extension，按 F5；在新开的扩展开发宿主中打开一个测试项目文件夹。
4. 打开 CodeFlow → Flows，用标题 + 创建文件夹；打开本地已保存文件，把光标放到目标行，再用文件夹旁 + 添加小节点。
5. 验证点击跳转、拖动排序/嵌套、叉号删除，以及在目标前增删文本后定位。保存测试代码后重载窗口，检查记录恢复。

需要先打开项目文件夹才能新建、删除或重新绑定。请用专用测试记录验证删除，避免误删自己的阅读路线。

保存、定位与拖动边界

记录保存在 VS Code 个人工作区状态中，使用本地绝对路径，不在项目生成共享文件；复制项目、换电脑或更换工作区身份不保证自动携带。

定位结合实时编辑跟踪、目标文本、前后各3行上下文、同文数量及完整原文 SHA256。全文未变时，重复代码也能恢复原位；文件变动后仅在证据足够时恢复，删除或歧义不会随意跳到同文副本。离线改写、跨文件剪切或复杂重构可能需要右键重新绑定，尚无语义分析保证。

拖到文件夹表示移入末尾，拖到小节点表示同级前插，空白根区只接受文件夹。被拖源项以主题灰色淡化；拖影、目标高亮等沿用 VS Code 原生反馈，不能等同于桌面文件管理器的任意前后插入操作。

开发接手从仓库的 docs/1.入口文件.txt 开始；发布操作见 docs/产品工程介绍/4.启动与交互过程/初版发布与更新指南.md。工程文档、源码与测试不包含在安装包中。