工作区侦探——项目文件结构可视化与规范建议工具
0.55已归档7 次浏览0 次认可8/19/2026
企业服务独立开发者效率瓶颈文件管理CLI工具
来源平台: idea-spark
一款帮助多项目切换的独立开发者快速扫描项目目录结构，自动生成可视化报告，并基于社区最佳实践给出规范建议的CLI工具。解决因为没有工作区规范导致文件乱放、记忆断档、查找效率低下的痛点。
目标用户
每天在5个以上不同技术栈（如Python、Node.js、Go）项目中切换、经常忘记上次修改文件位置的全栈独立开发者，或者管理3个以上Git仓库的2-3人小团队。
核心差异点
不是强制规范工具，而是自动诊断+可配置建议，尊重开发者习惯，只当发现明显杂乱（如乱放配置文件、缺少README）时提醒，不改变工作流。
解决方案
基于Node.js的CLI工具，使用Tree-sitter或简单正则扫描项目目录，生成JSON结构，然后通过ascii-tree或d3.js输出可视化；内置常见项目规范模板（如React、Vue、Spring Boot、Python标准库），对比后输出差异建议。MVP使用单一配置文件和社区模板库。
关联痛点
多项目文件管理混乱缺乏项目结构最佳实践指导切换项目时效率低
MVP 范围
在项目根目录下运行 `ws-detect`，扫描并输出文件树结构
对比内置模板（如React/Node.js默认结构），标出缺少或多余的文件/目录
生成一份简单报告（JSON或Markdown），列出建议项（如“建议添加README.md”）
支持自定义模板（通过配置JSON文件指定期望结构）