开源了!专治＂写长文档写到崩溃＂的AI神器

写招投标技术方案、维修技术手册、临床试验报告、施工图设计说明……很多行业都有一个共同的痛点：要产出大量结构复杂、必须严格遵循行业规范的长文档。

翻规范、查案例、写初稿、来回校审，整起来挺费劲的。

之前有客户找到我们，问能不能用 AI 帮他们提提效。我们试着用 ChatGPT、通义千问这些通用大模型对接了一版，结果都差不多——写个千把字的短文还行，一旦涉及几万字的专业长文档，要么上下文丢失前后矛盾，要么胡编乱造不符合规范，根本没法交付。

客户的痛点是真实的，但市面上没有现成的工具能解决。

所以我们决定自己做一个，这就是 OpenSpec。

专业长文档，为什么通用 AI 搞不定？

核心矛盾在于：专业长文档不是”写作”，而是”工程”。

不管是投标方案还是技术手册，每一章都可能要引用对应的国标、行标条文，前后章节的参数必须一致，术语表述要符合行业惯例。这不是大模型”自由发挥”能解决的问题。

通用 AI 的上下文窗口有限，写到第 50 页的时候，早就忘了第 5 页写的什么。更关键的是，它没有你的知识库，不知道你们公司用的是哪版规范、哪些设计参数。

OpenSpec 的解法：RAG + 多智能体 + 人机协作

OpenSpec 是一个开源的企业级 AI 长文档生成平台，专门解决这个问题。技术架构上做了三件事：

第一，智能检索（RAG）。 接入你自己的知识库——规范文件、历史案例、参考资料，AI 在生成每一章内容时，都会先从知识库中检索相关条文，确保有据可依。

第二，多智能体协作。 基于 LangGraph 构建了 Researcher + Auditor 等多个智能体工作流。Researcher 负责研究和撰写，Auditor 负责审核和纠错，就像团队里一个人写、一个人审，互相把关。

第三，人机协作编辑。 AI 生成的内容支持逐章校审、改写、补充。不是让 AI 全自动出稿，而是让 AI 干 80% 的重活，人来把控 20% 的关键决策。

哪些场景能用？

只要你的工作涉及”基于知识库生成结构化长文档”，OpenSpec 都能用：

• 招投标：投标技术方案、招标文件编制
• 汽车维修：维修技术手册、故障诊断报告
• 医疗健康：临床试验报告、诊疗规范文档
• 建筑设计：施工图设计说明、可行性研究报告

本质上，任何需要”查规范、写长文、反复审”的场景，都是 OpenSpec 的用武之地。

技术栈一览

前端 Vue 3 + TypeScript，后端 Spring Boot 3 + Java 17，AI 工作流用 Python + LangGraph + LangChain，数据库 PostgreSQL，支持 Docker 一键部署。

集成了 Langfuse 做 LLM 调用追踪和成本分析，知识库检索基于 RAGFlow。整套架构模块化设计，方便二次开发和定制。

5 分钟跑起来

git clone https://github.com/zhuzhaoyun/OpenSpec.gitcd OpenSpeccp deploy/docker/.env.example deploy/docker/.env# 编辑 .env 填入配置cd deploy/dockerdocker compose up -d

不想本地部署？也可以直接在线体验：https://archspec.aizzyun.com/

新年，新的生产力工具

大年初一分享这个项目，不是因为它已经完美，而是因为我相信这个方向是对的——AI 不应该只是聊天机器人，它应该成为专业工作者的生产力引擎。

OpenSpec 采用 GPLv3 协议开源，欢迎 Star、Fork、提 Issue，也欢迎各行业的朋友一起探索 AI + 专业文档的更多可能。

GitHub 地址：https://github.com/zhuzhaoyun/OpenSpec

如果你也在被长文档折磨，不妨试试。