人机协作新范式：让AI从零构思到代码生成shit journal.org项目

最新推荐文章于 2026-04-06 11:08:38 发布

原创最新推荐文章于 2026-04-06 11:08:38 发布 · 724 阅读

本内容遵循CC 4.0 BY-SA版权协议

最近在构思一个叫“shit journal.org”的小项目，想法很简单，就是想做一个能让我随时随地、毫无压力地记录那些一闪而过、不成体系甚至有点“乱七八糟”想法的地方。它不需要多精美，但求私密、快速、无负担。为了把这个想法快速落地，我尝试了一种新的开发方式——让AI作为我的编程搭档，从零开始辅助我完成整个项目。整个过程下来，感觉像是打开了一扇新世界的大门，这里就把这个人机协作的实践过程记录下来。

从模糊想法到清晰蓝图：AI辅助需求分析与规划 最开始，我只有一个“记录碎片想法”的模糊概念。我向AI助手描述了“shit journal.org”的核心诉求：一个私人的、鼓励随意记录的在线空间。AI没有直接写代码，而是先扮演了产品经理和技术架构师的角色。它帮我梳理并输出了一个详细的功能特性列表，比如：用户注册登录与鉴权、支持纯文本的日记创建/编辑/删除、按时间线或标签查看所有记录、简单的搜索功能、数据完全私有化存储、以及一个极简主义的UI界面。这让我原本混沌的想法瞬间变得条理清晰。接着，AI根据这些功能点，给出了技术选型建议：前端用Vue 3 + TypeScript + Pinia状态管理，搭配Tailwind CSS快速构建UI；后端用Go语言搭配Gin框架提供RESTful API，并使用SQLite作为轻量级数据库。这个建议非常中肯，Vue的响应式和组件化适合快速开发前端交互，Go的高效和简洁能保证后端服务的稳定，而SQLite则免去了部署独立数据库的麻烦，特别适合个人小项目。这一步让我意识到，在项目初期，AI能有效帮助开发者将创意结构化，避免一开始就陷入技术细节的泥潭。
骨架与血肉：AI生成核心代码与逻辑注释 确定了技术栈，下一步就是动手实现。我让AI根据我们讨论出的方案，生成主要的代码文件。它很快输出了前后端的关键代码结构。在前端部分，它生成了Vue 3的单文件组件，包括登录页、日记列表页和日记编辑页的骨架，并集成了Pinia来管理用户状态和日记数据。在后端部分，它创建了Go的main.go入口文件、定义数据模型的结构体、以及处理用户认证和日记CRUD操作的路由控制器。最让我惊喜的是，AI在生成代码的同时，为许多关键函数和复杂逻辑块添加了清晰的解释性注释。例如，在后端的JWT令牌生成函数旁，它会注明该函数的作用、参数含义以及令牌的有效期设置；在前端处理表单提交的函数前，它会说明数据验证的流程和与后端的交互步骤。这些注释就像一位耐心的同事在旁讲解，极大地降低了后续阅读和理解代码的成本，尤其对于项目中那些涉及安全或核心业务逻辑的部分，注释的存在让我感到格外安心。
代码审查与优化：AI作为第二双眼睛 代码生成完毕，并不意味着工作结束。我请AI扮演代码审查员的角色，对已生成的代码进行检查，并提出优化建议。这一步收获颇丰。在性能方面，AI指出后端API在查询日记列表时，如果记录数量很大，一次性全量返回可能影响响应速度，建议加入分页查询逻辑。在安全性方面，它强调了几个关键点：用户密码必须使用bcrypt等算法进行哈希存储，绝不可明文保存；所有用户输入的数据（如日记标题、内容）在存入数据库前都需要进行适当的清理和转义，以防止XSS攻击；对于涉及用户个人数据的API端点，必须严格校验JWT令牌的有效性和权限。此外，AI还建议为Go的后端服务添加更完善的错误处理中间件，确保即使程序内部出错，也能给前端返回友好的错误信息，而不是暴露堆栈详情。这些建议非常专业，很多是我在初始开发中可能忽略的细节，AI的“火眼金睛”帮我提前规避了潜在的技术债和安全风险。
协作模式反思：从工具到伙伴 通过这个完整的“shit journal.org”项目实践，我对AI辅助开发有了更深的理解。它不再只是一个简单的代码补全工具，而是一个能够贯穿需求分析、技术选型、代码实现、甚至代码审查等多个环节的协作伙伴。它的优势在于能够快速将自然语言描述的需求转化为结构化的技术方案和可执行的代码，极大地提升了从想法到原型的验证速度。同时，它的注释和审查功能，对于新手学习、团队知识传递以及代码质量保障都有积极意义。当然，当前的AI并非万能，它生成的代码有时需要根据具体上下文进行调整，其架构建议也需要开发者结合自身经验进行判断。但不可否认，这种“人类主导创意与决策，AI负责高效执行与建议”的人机协作新模式，正在成为提升个人及小团队开发效率的一把利器。

整个项目从构思到形成可运行的代码框架，速度非常快。为了让这个“shit journal.org”能真正在线访问和体验，我把它放到了InsCode(快马)平台。这个平台用起来很省心，它本身也集成了多种AI模型，能辅助完成很多开发环节。最让我满意的是，对于像我这样有前后端、需要持续运行提供网页服务的项目，InsCode提供了一键部署的功能。我只需要把代码传上去，它就能自动配置好运行环境，并生成一个可公开访问的链接，彻底省去了自己购买服务器、配置Nginx、搞HTTPS这些繁琐的步骤。

示例图片