Show HN: Brodocs 深度本地知识采集器
1 分•作者: BroTechLead•6 个月前
Hi HN，
分享一个本地版本的 Markdown 知识收集和发布工具 <a href="https://brodocs.io" rel="nofollow">https://brodocs.io</a>。它能让你轻松地从多个 Git 仓库（如微服务/纳米服务、Terraform 模块、Ansible 角色、架构文档）搭建内部技术文档门户。
开始使用只需：docker run -it --rm --name brodocs -p20000:20000 ghcr.io/brodocsdev/brodocs:0.14.0
然后从 Git 仓库初始化一些站点：curl -X POST 'http://localhost:20000/api/sites/init' -F "repo=<a href="https://github.com/brodocsdev/docs.git" rel="nofollow">https://github.com/brodocsdev/docs.git</a>"
然后访问：http://localhost:20000/10b0eb6e1dc27c0babd/docs/README.html
已实现的功能：
- 添加更多仓库进行初始化，使用 -F "repo=url" -F "repo=url2" ...
- 如果需要密钥：-F "key=..."，它会被加密存储在容器中
- 每 5 分钟检查一次更改，因此无需设置 CI/CD 管道，只需将其部署在虚拟机或 Kubernetes 上
- 内置 PlantUML 转换，无需提交图片（仍缺少 Mermaid，因为它需要 Chrome，容器大小超过 1GB）
- 构建跨团队站点，带有顶部菜单：<a href="https://brodocs.io/d248c24a335845277b6/docs/Multisites%20with%20top%20menu.html" rel="nofollow">https://brodocs.io/d248c24a335845277b6/docs/Multisites%20wit...</a>
欢迎提出关于在 MCP 上公开哪些操作以及如何构建 llm.txt 的建议。
查看原文
Hi HN,<p>Sharing onprem version of markdown knowledge harvester and publisher <a href="https://brodocs.io" rel="nofollow">https://brodocs.io</a>. It should make easy setting up internal tech docs portals from multiple git repos like micro/nano services, terraform modules, ansible roles, arch docs.<p>To start just: docker run -it --rm --name brodocs -p20000:20000 ghcr.io/brodocsdev/brodocs:0.14.0<p>then init some site from git repository: curl -X POST 'http://localhost:20000/api/sites/init' -F "repo=<a href="https://github.com/brodocsdev/docs.git" rel="nofollow">https://github.com/brodocsdev/docs.git</a>"<p>then go to: http://localhost:20000/10b0eb6e1dc27c0babd/docs/README.html<p>Features already built:<p>- add more repos to init with -F "repo=url" -F "repo=url2" ...<p>- if key is needed: -F "key=...", it is stored encrypted in container<p>- it will check for changes every 5 minutes, so no need to setup ci/cd pipilines, just drop it on vm or k8s<p>- PlantUML conversion built-in, no need to commit image (mermaid still missing since it needs chrome, container size goes over 1GB),<p>- building cross team sites with top menu: <a href="https://brodocs.io/d248c24a335845277b6/docs/Multisites%20with%20top%20menu.html" rel="nofollow">https://brodocs.io/d248c24a335845277b6/docs/Multisites%20wit...</a><p>Any suggestions what operations expose on MCP, how to construct llm.txt, are welcome.