【Code With SOLO】耗时 15 天用 TRAE SOLO 搭建了一套完整的可私有化部署的企业级知识库RAG系统(前端+服务端+本地模型)

摘要

支持本地私有化部署的企业级知识库RAG系统,已通过冒烟测试,本机(mac mini M4 16G)流畅运行。

全程使用 TRAE SOLO 完成前端+服务端的项目开发编码,无人工编码。

均使用本机部署的开源模型:LLM qwen3.5:4b + Embedding 模型 nomic-embed-text。

已在 github 开源(详见下述地址)!

背景

本人是一名具有 7 年全栈 + 3 年产品工作经验的互联网从业者,正在求职“高级 AI PM”一岗。

由于最近负责的项目都是企业内部管理系统,无法在求职时演示效果。故此使用 TRAE SOLO 开发【2026年企业级 RAG 系统】的 MVP Demo用于求职演示。

同时也想验证现有的 AI Coding 工具能否从 0-1 完整的开发出一个企业级项目,最终整个项目借助TRAE SOLO 跑通了 MVP 版本功能,并已在 github 开源。

实践过程

1.熟悉 TRAE SOLO 并驾驭

后文用它指代 TRAE SOLO

古语有云:“工欲善其事,必先利其器”,又云“磨刀不误砍柴功”。在报名参赛并拿到它的内测资格后,我终于得以窥见其初始界面。

启动界面极简,两个模式,一个适用于技术从业者,一个适用于一般性的办公场景。

我没有直接开始我的 RAG 项目任务,而是直奔【设置】-【关于 TRAE SOLO】-【帮助文档】,文档内容不多,很快便可以读完。

【规则】和【命令】是我重点关注的功能,【规则】可以确保项目质量和成功交付率,而【命令】则大大提高我与AI Agent的协作效率。

至于【技能】和官方提供的 Spec/Plan,可根据各自使用 AI 的水准取舍,我不需要!

TRAE SOLO 作为字节刚发布的新 App ,能明显看出其前身是 TRAE CN 的 SOLO 模式。与之不同的是,TRAE SOLO 更不希望人工介入项目的执行层,其工作风格更鼓励以 AI Agent 规划+执行为主,人类则重点负责监管+把控(起码目前我不会将开发节奏全部交给 AI 把控),只需在执行层面只需提供少量协助即可(如工作环境准备,启动必要服务)。

2.人类要先明确项目目标和需求

虽然 TRAE SOLO 具备任务规划能力,但请不要忽视 AI 自注意力机制的“近因效应”。首轮对话极其重要,在TRAE SOLO 介入前,如果人类连目标都没定,大致的需求也没梳理清楚,请不要开始。

你可以问自己:

  1. 我的项目要解决什么问题?

  2. 一个符合行业标准的同类系统应当包含哪几项功能?

  3. 我的项目核心功能有哪几项?

  4. 我的主要技术栈是?

这个过程可以借助“豆包”、“千问”等工具来帮助梳理出一个基础的项目需求文档,当然这个过程也会让我们更清楚自己想要什么。

我要做一个 企业级 RAG 系统,很自然的需要学习一个企业级 RAG 系统是为了解决什么问题,需要什么功能,大概用哪些技术,有哪些验收标准(用 AI 工具交叉调研即可)

3.开始!与 TRAE SOLO 对齐目标和要求

当你知道自己要做什么,要怎么做,分几步做,用哪些技术,便可以开始任务了!

以我的 RAG 项目为例,我打算先开始 RAG 的服务端项目。

开场白,给出基本项目需求和要求,首轮Prompt如下:

我需要与你协作从零开发一个【企业内部知识 RAG 系统】,核心目标是【前后端分离架构,本项目负责整个 RAG 项目中的后端服务部分,全链路基于 Node.js 生态开发,零 Python 环境依赖,优先原生 javascript 语言开发,次选 ts,支持本地私有化部署,开箱即用,兼顾 POC 演示与生产级落地需求】。

我是项目的产品经理,也是你的人类助手。

项目的初始信息已记入README.md文件(又称项目架构文档),这是项目最重要的文件,以此文件为基准,我们可以对齐认知,梳理功能,架构项目,迭代和运维项目。

现在请你先阅读项目架构文档,然后对我进行深度访谈,逐步厘清项目的完整需求,对齐开发目标,补全项目细节到项目架构文档中。

本次不执行任何编码或项目开发任务,仅对齐需求和项目信息

4.让TRAE SOLO 访谈人类 → PRD初稿

当你发送首轮 Prompt 后,TRAE SOLO会根据你的项目目标和要求对你进行细致的访谈,你只用选择对应选型或者给出你的自定义方案。

务必认真回答问题,当它提出的问题你也无法明确答案时,你需要快速补充下这个问题涉及的知识点。

TRAE SOLO 基于我的 RAG 系统需求问了我 20 个问题,包含需求澄清,目标对齐,项目架构,技术要求,安全要求,数据库要求等等。我一一作答!

完成这一步,它已经为你交付了一份项目需求文档了(初版),下一步你需要向它提问了。

5.人类访谈 TRAE SOLO → PRD定稿

你需要审查上一部产生的需求文档,然后根据需求文档内容,尽情的,按顺序的询问一些模糊的实现细节或者需求细节,每一次 TRAE SOLO 解决一个问题,先更新到架构文档,再继续追问或者切换到下一个问题,直到最后所以你看不明白的需求规划得到合理解释。

最终你得到一份完善详细的需求文档,TRAE 得到了清晰的项目目标、需求、技术栈和功能模块上下文记忆。「大家好,才是真的好!」

你可以问 TRAE SOLO:基于我们的互相访谈,你对项目整体需求掌握程度是?(根据它回答的概率和具体内容决定要不要继续互相访谈,这将会极大提高项目最终成功交付率,无论多么复杂的项目)

6.「规则」提前定,「命令」则随用随写

有了需求文档后,在项目架构开始前,提前写好开发规则,将更有利于后续 TRAE SOLO 设计符合要求的架构。规则的数量尽可能少且具体,命令的数量可以稍多,但一个命令最好只干一件事。命令可根据开发过程中实际指令的重复度自行定义~

我RAG服务端就两个规则,摘取其中一个的片段作为示例:

MVC 架构开发原则:

  1. Router 层(路由入口)
  • 核心职责:
    • 用 express.Router() 按业务域拆分路由模块(如 userRouter、orderRouter),定义 URL 路径、HTTP 方法;
    • 挂载应用级中间件(鉴权、限流、CORS、请求日志),将请求转发给对应 Controller。
  • 严格禁止:不写业务逻辑,不直接处理 req/res 的业务响应。

7.TRAE SOLO 基于PRD设计架构 → 开发计划文档

有了完整的需求文档,让 TRAE 基于此列出具体开发计划,此时诞生项目开发过程中唯二重要的「开发计划文档」,这个文档会按照功能模块来拆分,列出每个模块下的功能点及其子任务(可以参考我的项目中的开发计划文档)。

你们需要不断的讨论,将任务尽可能的拆分为可以按批次执行的小任务,这样 TRAE SOLO每次推进一小步功能实现,人工可以立马跟进复核。整个开发过程就是 TDD 模式驱动了!

8.按开发计划文档逐步、逐批次、逐模块完成编码

按照拆分的小任务,逐步推进功能开发,千万不能急,开发一个点人工跟进审查测试一个点,及时反馈测试结果。通过一个则更新开发计划文档,然后推进下一个小功能点,逐步完成整个模块功能!

这个过程中,对于较复杂的功能点,都可以问 TRAE SOLO:「在开发这个功能点之前,你有什么疑问需要找我澄清和确认?」。解答 TRAE SOLO 的疑惑,提升你自己的清晰度。

我的 RAG 后端服务项目,每完成一个模块,我都会让TRAE SOLO 输出一个 api 接口对接文档,用于后续前端项目联调。

9.项目中途提醒 TRAE SOLO 做自己

在与人类协作开发,不断被人类监管+审查+反馈+不厌其烦的为人类解释后,TRAE 会变得唯唯诺诺,没有主见,暗中迎合人类开发者。

此时我们需要发送指令提醒 TRAE SOLO 做自己,告诉它:「你不是应声虫,你是一个有态度有想法的好伙伴,为了项目的成功交付和质量,请大胆的说出你的真实想法或建议」。

及时修正 TRAE 的“中性性格”,它在和你协作的过程中被设定变得像你,这或许是一个值得思考的产品设计方向~

10.利用 TRAE SOLO 的”死亡回溯超能力“

项目开发过程中遇到任何坑点,只要让 TRAE SOLO 绞尽脑汁,甚至陷入循环思考时,果断手动停止!利用 App 的功能,直接回溯到任务开始前,甚至前几个任务开始前。然后你就是那位「先知」,让 TRAE先别动手执行而是思考如果以开发计划文档既定方案或者刚死掉的方案执行,会不会遇到问题,让其反思并给出新的可行方案。

这也是之前提到最小化拆分任务的好处,让TRAE SOLO随时有能力完成项目重生~

另外,为了节省TRAE SOLO 的有效上下文窗口,有时我也会对一些经过讨论得出结论但实际未调整任何项目文件的某几轮对话直接回溯~

11.预防项目中途迷失 Lost in the Middle

中大型项目中途,TRAE SOLO 总会有点”迷失“(Lost in the Middle),人类也一样。这时需要让它和 TA重读”开发计划文档“与”项目架构文档“,这也是我们项目中没执行一步任务复核通过后都会及时更新文档的原因,随时帮助大家掌握当前项目进度和开发细节~

12.开发完成后与 TRAE SOLO 协同完成冒烟测试

我的 RAG服务端核心功能完成后,我与 TRAE SOLO 共同完成了一次冒烟测试,冒烟测试文档是它写的~

13.用同样的配方开发完成前端项目开发

开启一个新任务,同样的方式开发一个RAG前端项目,用于和后端服务对接,唯一的区别在于你可以先将 RAG服务端的项目架构文档和开发计划文档作为初始信息传递给 TRAE SOLO

成果展示

RAG 前端 github 地址:https://github.com/JayAIPM/RAG-FE

详细的项目架构文档,开发计划文档,接口文档,冒烟测试文档均在项目中有清晰明确的记录,项目详情请参见 github 地址。

RAG 服务端 github地址:https://github.com/JayAIPM/rag-bi

前端界面截图

-

-

-

TRAE SOLO 开发中截图

TRAE SOLO Bug 排查时截图

前端项目开发首轮指令截图

效果与总结

  1. 感谢 TRAE SOLO 的帮助,帮我提效起码 50%,通过 TRAE SOLO 来执行编码,耗时半个月(实际每天就学习之余写几个小时,五一休息了 5 天)就跑通了完整的 RAG项目的前后端,这放在传统的编码时代,起码要一个月才能完成!
  2. 全程很少受到陌生技术栈的影响,我只需知道技术大概用来实现什么即可,不需要学习具体用法。只要拿好监督 TRAE SOLO的小皮鞭即可~
  3. 本次项目 SOLO 负责了全部的项目编码,自行执行了绝大部分接口的单元测试,输出了完整的接口文档,全部 bug 也经由它手解决
  4. 提供一些我的常用指令给大家参考,参见截图~