1. 项目概述
Brainstorming Dev 是一个由 AI 驱动的交互式需求文档生成工具。用户只需输入一个初步的创意想法，系统便会通过一系列引导性问题，帮助用户逐步澄清愿景、识别边缘情况与约束条件、定义技术需求，最终生成一份结构完整、包含功能需求、数据模型、UI/UX 规范等内容的 Markdown 格式需求文档。该文档可直接用于 AI 编码代理或作为开发团队的技术规格说明书，显著提升项目启动效率。
项目档案应用项目
Brainstorming Dev：AI驱动的交互式需求文档生成工具 - 快速将模糊创意转化为结构化技术规格说明书
Brainstorming Dev 是一款基于 AI 的交互式需求文档生成工具，通过引导式问答帮助开发者、产品经理将模糊创意转化为完整的技术规格说明书。本文介绍其核心功能、安装部署步骤、使用流程、技术栈实现以及多语言支持等详细信息。
AI 总结
Brainstorming Dev 是一个 AI 驱动的需求文档生成工具，通过交互式问答将模糊想法转化为结构化的技术规格说明书，为 AI 编码代理和开发团队提供清晰、可执行的项目输入。
中文项目介绍
Brainstorming Dev 是一个 AI 驱动的需求文档生成工具，通过交互式问答会话引导用户将模糊的创意想法逐步细化为结构完整、可直接执行的技术规格说明书。
该工具解决了项目启动阶段需求不明确、文档缺失的常见痛点，帮助用户快速产出专业级的需求文档，为后续的 AI 编码代理或开发团队提供清晰、无歧义的输入。
它适用于开发者进行项目启动前的需求梳理、产品经理编写详细产品需求文档、个人创业者或技术爱好者将零散想法系统化，以及团队协作中统一需求理解与文档化等场景。
基于 Next.js 16 (App Router) 和 TypeScript 构建，前端采用 React 19 与 Tailwind CSS 4，后端集成 Anthropic Claude API 并通过 Server-Sent Events (SSE) 实现流式响应。支持多语言界面（中文/英文），内置 Turnstile 反滥用机制，并可兼容任何 Anthropic 兼容的 API 服务以降低成本。
详细信息与使用说明
2. 核心价值
该工具的核心价值在于将模糊的创意快速转化为可执行的技术规格。传统需求文档编写耗时耗力且容易遗漏关键细节，而 Brainstorming Dev 利用 AI 的上下文理解能力，通过结构化对话自动补全需求盲点，确保文档的完整性与专业性。生成的文档包含可勾选的功能清单、代码片段示例、明确的边界定义，为后续开发或 AI 辅助编码提供高质量输入，减少沟通成本与返工风险。
3. 目标用户
主要面向三类用户群体：一是独立开发者或小团队在项目启动前进行快速需求梳理；二是产品经理需要产出标准化、详细的产品需求文档（PRD）；三是个人创业者或技术爱好者希望将零散想法系统化。此外，该工具也适合用于团队协作场景，帮助所有成员在同一份结构化文档基础上达成共识，确保需求理解的一致性。
4. 安装部署
项目基于 Next.js 构建，安装过程简单直接。首先使用 Git 克隆仓库到本地，然后使用 pnpm 安装依赖包。接着复制环境变量模板文件并配置必要的 ANTHROPIC_API_KEY。最后运行开发服务器即可在浏览器中访问应用。项目支持 Docker 部署，并提供了生产环境配置选项如 Turnstile 反滥用验证。详细的脚本命令包括开发、构建、代码检查与测试等，满足不同阶段的需求。
5. 使用流程
使用流程分为三步：第一步在首页输入初始想法，例如"我想做一个独特的贪吃蛇游戏"；第二步跟随 AI 引导回答一系列问题，涵盖技术栈选择、功能特性、约束条件等；第三步系统自动生成结构化的需求文档，用户可在线预览、编辑 Markdown 内容并复制使用。整个会话过程会被保存，用户可在历史记录中查看、恢复之前的会话，支持多语言界面切换。
6. 技术实现
项目采用现代 Web 技术栈：Next.js 16 App Router 提供服务器组件与流式渲染能力，TypeScript 确保类型安全，React 19 与 Tailwind CSS 4 构建响应式 UI。AI 集成通过 @anthropic-ai/sdk 调用 Claude 模型，使用 Server-Sent Events 实现实时问答流。数据验证依赖 Zod 库，状态管理与会话引擎自定义 Hook 实现。反滥用机制集成 Cloudflare Turnstile，默认禁用以方便本地开发。项目支持多语言（i18n），并包含完整的 E2E 测试套件。
思维导图
Brainstorming Dev
核心功能
交互式问答
需求文档生成
多语言支持
技术栈
前端框架
样式方案
AI 服务
数据验证
主要模块
会话引擎
AI 集成
文档生成
历史管理
反滥用验证
部署与运行
环境配置
开发命令
生产构建
常见问题
如何获取 Anthropic API Key？
访问 Anthropic 官方平台注册账号并创建 API Key，将其配置到项目的 .env 文件中的 ANTHROPIC_API_KEY 变量即可。项目也支持任何 Anthropic 兼容的 API 服务，如 Kimi 或 GLM，可相应修改 ANTHROPIC_BASE_URL。
是否支持本地运行？
完全支持。克隆仓库后执行 pnpm install 安装依赖，配置环境变量，然后运行 pnpm dev 即可在本地启动开发服务器，通过 http://localhost:3000 访问。Turnstile 反滥用验证默认禁用，确保本地开发顺畅。
生成的需求文档格式是什么？
生成的是结构化的 Markdown 文档，包含概述与技术栈、功能需求清单（带复选框）、数据模型代码片段、UI/UX 规范、边缘情况与约束条件、范围外内容等章节。用户可在线预览、编辑并复制使用。
是否支持其他 AI 模型？
是的，项目设计为支持任何 Anthropic 兼容的 API。除了默认的 Claude 模型，您可以使用 Kimi K2.5、GLM 4.7 等其他服务，只需修改 .env 文件中的 ANTHROPIC_BASE_URL 和 ANTHROPIC_MODEL 配置即可，有助于降低使用成本。
如何部署到生产环境？
项目支持 Docker 部署，next.config.ts 已配置 output: "standalone"。生产环境建议启用 Turnstile 反滥用验证，设置 NEXT_PUBLIC_ENABLE_TURNSTILE=true 并配置相应的 Site Key 和 Secret Key。运行 pnpm build 构建后，使用 pnpm start 启动生产服务器。