garden-md

garden-md 是什么？

garden-md 是一个命令行工具，可将会议转录（及相关笔记）转化为结构化、可互链的公司知识库。它从本地 Markdown 文件生成 Wikipedia 风格的 HTML 维基，便于浏览组织中的人员、公司、产品/工具，以及它们在文档中的提及情况。

其核心目的是帮助团队将分散的转录材料整理成可浏览格式，同时保留原始转录原文（不改写或总结）。您可以从支持的服务同步数据、提取实体、链接提及，并在浏览器中打开生成的维基。

从多个来源同步转录（本地暂存 + 本地维基）： 运行 garden sync 从 Grain、Granola、Fireflies.ai 或基于 API 的“Other”连接器拉取新转录至本地暂存区。
跨文档实体提取： 在 garden tend 期间，工具提取 人员、公司和产品/工具 等实体，并用其组织维基页面。
Markdown 中的互链、可浏览维基页面： 输出为互链的 .md 文件，随着文档引用现有或新实体而逐步增长。
Wikipedia 风格的 HTML 渲染： garden open 生成并提供带导航、搜索和反向链接的 HTML 维基。
本地优先操作： 维基以 Markdown 文件夹形式存储在您的机器上，而非云数据库。
可选 git 集成 / 自动提交： garden init 可启用 git，维基可自动提交更新（按设置可选）。
连接器方法 + 自定义服务审核： 内置连接器已预构建并测试；对于“Other”，AI 生成连接器脚本供审核后再运行。
明确非目标（保留转录原文）： 它不会改写或总结内容；转录在源文档中保持原文。

安装和前提条件： 使用 npm install -g garden-md 安装。需 Node.js 18+ 并提供支持的 AI 提供商的 API 密钥。
初始化维基： 运行 garden init 选择 AI 提供商、配置维基位置，并可选启用 git。
连接数据源： 运行 garden connect 选择服务——Grain、Granola、Fireflies.ai 或 Other——配置同步。对于“Other”，提供服务名称和 API 文档 URL。
同步新转录： 运行 garden sync 将新转录拉入暂存区（演示输出中显示为“wildland”）。
处理进维基： 运行 garden tend 提取实体、创建存根页面并生成互链 Markdown/维基结构；然后运行 garden open 浏览生成的 HTML 维基。

常用命令包括：garden connect --repair（修复损坏连接器）、garden sync --schedule（基于 cron 的自动同步）以及 garden tend / garden open 用于处理和浏览。

将会议转录转为可搜索内部维基： 同步会议笔记/转录来源后，运行 garden tend 生成实体页面和反向链接，便于团队成员按人员、公司或产品/工具浏览公司知识。
维护基于原文的“公司大脑”： 由于 garden-md 避免改写/总结，团队可依赖原始转录内容，同时受益于结构化维基层。
随新会议到来持续更新维基页面： 使用 garden sync（可选 --schedule）引入新转录，然后重新运行 garden tend，使维基增长并扩展链接（当额外文档引用实体时）。
用通用导航层入职团队或利益相关者： 使用 garden open 浏览带侧边栏导航和搜索的 HTML 维基，便于在众多转录中查找相关提及。
通过 API 集成自定义转录源： 在 garden connect 中选择“Other”并提供 API 文档；工具生成连接器脚本供审核后再运行。

garden-md 会改写或总结我的转录吗？ 不会。garden-md 保留转录原文（不改写或总结内容）。
维基存储在哪里？ 作为本地 Markdown 文件（.md 文件夹）存储在您的机器上；无需数据库或云存储。
哪些服务开箱即用？ 仓库列出了内置测试连接器，支持 Grain、Granola 和 Fireflies.ai。对于其他服务，可使用“Other”并提供 API 文档。
garden tend 和 garden open 做什么？ garden tend 从暂存区读取内容、发送至您的 AI 提供商进行实体提取，并更新互链 Markdown 维基。garden open 渲染并提供 HTML 维基供浏览。
需要哪些前提条件？ README 指出需 Node.js 18+，并需从任意支持的 AI 提供商获取 API 密钥。

手动用 Markdown + 脚本构建维基： 如果只需基本组织，可自行创建并链接 Markdown 页面，无需 AI 驱动的实体提取和 HTML 渲染流程。
使用带导入管道的文档/维基平台： 通用知识库可存储和搜索文档，但工作流不同，因为 garden-md 专为转录生成 Wikipedia 风格的互链实体页面。
带知识库的转录摘要工具： 有些工具专注摘要转录并索引摘要；garden-md 的方法不同，它保留原文并构建结构化实体链接，而非用摘要替换内容。
自定义 ETL 管道（同步 → 解析 → 索引）： 对于已有工程支持的团队，可用自有工具和存储复现“同步 + 实体提取 + 链接”模式，而非使用 garden-md 的命令集和维基渲染器。