“爬蓝湖原型目录结构”是一段运行在蓝湖网页中的用户脚本。它读取当前原型的目录层级，为每个页面生成“接口开发、页面开发、接口联调”三类任务，并导出 CSV，方便导入飞书多维表格继续分工和跟踪。
它解决了什么问题
原型评审结束后，团队通常还要把页面拆成任务、补充负责人、排期和联调状态。如果靠手动复制，目录层级容易丢失，同一页面对应的前后端任务也容易遗漏。
这段脚本把机械工作缩短为：
- 在蓝湖中打开需要整理的产品原型。
- 展开希望导出的目录，确认页面名称和层级。
- 点击页面右侧的“导出原型目录 CSV”按钮。
- 检查文件内容，再导入飞书多维表格或其他表格工具。
当前实现
Greasy Fork 上公开的版本为 1.0.5，适用于 lanhuapp.com/web/*。脚本会：
- 从蓝湖页面 DOM 中读取目录节点和父级路径。
- 忽略名称中包含“废弃”的节点。
- 为每个有效页面展开三种默认任务类型。
- 输出任务名称、任务类型、所属模块、开发人员、进展、日期、延期、完成情况和备注等列。
- 允许拖动导出按钮，并在当前页面会话中保存按钮位置。
- 使用 SheetJS 将中间表格转换为 CSV，然后由浏览器下载到本地。
安装
- 先安装可信的用户脚本管理器，例如 Tampermonkey 或 Violentmonkey。
- 打开上面的 Greasy Fork 页面。
- 在安装前检查脚本的
@match、@require和源码。 - 安装后刷新蓝湖页面。
用户脚本有读取和修改匹配页面的能力。即使脚本由自己编写，也应该定期复查权限范围和外部依赖；不要在来源不明的镜像站安装。
导入飞书多维表格
在飞书新建多维表格后，选择“导入 Excel/CSV”，再上传导出的文件。导入前建议先做三项检查：
- 目录是否全部展开，是否存在未加载的懒加载节点。
- “所属模块”是否符合团队对模块边界的定义。
- 页面是否真的都需要三种任务，删除不适用的行后再分配负责人。
已知边界
这不是蓝湖官方 API 集成，而是基于页面 DOM 的自动化脚本。因此：
- 蓝湖调整类名或目录结构后，脚本可能导出空数据或层级错误。
- 脚本只能处理浏览器中已经渲染出来的内容，导出结果必须人工核对。
- 默认任务模型是我的团队实践，不一定适合所有项目。
- CSV 适合交换数据，但字段类型、成员列和日期列通常要在飞书中重新设置。
- 脚本不会理解页面复杂度、接口复用关系或真实排期，不能代替任务拆解评审。
如何按团队需要调整
源码中的 columnOptions 控制默认任务类型：
const columnOptions = ['接口开发', '页面开发', '接口联调']
可以改成团队自己的阶段，例如“视觉验收、埋点、测试用例”。列定义集中在 column 数组中，也可以增加测试负责人、需求链接或风险等级。
修改后应重点测试中文逗号、引号、换行和特殊字符。CSV 不是简单地用逗号拼接字符串；使用成熟的表格库统一转义，能避免导入时出现错列。
适合继续演进的方向
- 在导出前提供任务类型和忽略规则配置，而不是要求用户改源码。
- 对未展开目录、空结果和重复页面给出明确提示。
- 为字段增加稳定标识，支持二次导入时合并，而不是重复创建任务。
- 如果蓝湖未来提供合适的开放 API，优先迁移到结构化数据接口，降低 DOM 变化带来的维护成本。
这个脚本的价值不是“自动完成项目管理”，而是把原型目录转换成一个可编辑的任务初稿。最终范围、负责人和验收标准仍应由团队共同确认。