请问大家的企业对外的技术文档,产品文档所用的管理和展示框架是什么,是否接入了 AI?

2025 年 6 月 4 日
 Anivial

因为最近要了解下企业文档的管理和展示的方案,并且预期是要接入 AI 的功能,将文档内容做成 RAG 知识库,然后通过问答的方式给出快速的解决方案。

现在主要有两个问题:

  1. 对文档的自定义展示要求比较高,包括内容展现和展示风格、样式这些基本内容都要自定义。
  2. 文档的管理后台,基本上应该是内容管理这一套,不过考虑更多的应该是内容修改和新增都需要关联进 RAG 知识库,也就是文档切片和 embedding 这些都会嵌入这个后台管理中,或许是定时或许是手动操作、自动更新之类的。

现在查询了一些方案,大多数情况这两块都是分开的,并没有一体的解决方案。不同于飞书、企业微信或者其他的一些文档协作,这类文档一般都是对外客户展示的,所以对于修改内容的要求不是很高。只是文档 md ,docx 转为 html 之后的样式效果有自定义的要求,并且管理后台需要结合 RAG 知识库。

希望有做过或者现在已经成熟运行的老哥们分享下解决方案,万分感谢

1571 次点击
所在节点    程序员
7 条回复
he110te4m
2025 年 6 月 4 日
产品文档一般都是 word 或者 pdf 吧?技术文档是指类似 VuePress 之类的 markdown 转 HTML 的?但是这类方案一般也没有管理后台吧?

所以我感觉你想要的,应该是类似 WordPress 的东西?再找几个 WordPress 的 AI 插件?自定义展示可以使用 WordPress 主题,后台管理 WordPress 自带,RAG 切片可以从 SQL 里面查数据,感觉应该是这样
Anivial
2025 年 6 月 5 日
@he110te4m 确实有点像 vuepress ,不过 wordpress 后台自定义功能应该很少吧
Kirkcong
2025 年 6 月 5 日
https://www.oxygenxml.com/
用这个,然后 git 管理,或者 cms 系统
Kirkcong
2025 年 6 月 5 日
oxygen xml editor 可以以 dita 源码的形式发布文档,发布的文档格式支持 html ,pdf ,md ,一堆一堆。如果你会调整 xml 配置文件,你甚至可以决定 pdf 的封面,字体,样式,等等等等。

哦对了,我前前公司和阿里有合作,所以知道阿里那边的文档就是用这套写的。
Kirkcong
2025 年 6 月 5 日
oxygen 是荷兰的软件,不便宜,但是有开心版
Kirkcong
2025 年 6 月 5 日
编译软件用的是 dita-ot ,这个和 oxygen 的关系就好像 gcc 和 vscode 一样。
https://www.dita-ot.org/
Anivial
2025 年 6 月 5 日
@Kirkcong 好的我去研究一下,万分感谢

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://study.congcong.us/t/1136294

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX