garden-md

garden-md 是什麼？

garden-md 是一個命令列工具，能將會議逐字稿（及相關筆記）轉換成結構化、可連結的公司知識庫。它從本機儲存的 markdown 檔案產生 Wikipedia 風格的 HTML wiki，讓你瀏覽組織中的人物、公司、產品/工具，以及它們在文件中的提及方式。

其核心目的是幫助團隊將散亂的逐字稿素材整理成可瀏覽格式，同時保留原始逐字稿不變（不改寫或摘要）。你可以從支援服務同步資料、擷取實體、連結提及，並在瀏覽器中開啟產生的 wiki。

從多來源同步逐字稿（本機暫存區 + 本機 wiki）： 執行 garden sync 從 Grain、Granola、Fireflies.ai 或 API 基礎的「Other」連接器拉取新逐字稿至本機暫存區。
跨文件實體擷取： 在 garden tend 期間，工具擷取如 人物、公司及產品/工具 等實體，並用來組織 wiki 頁面。
可連結、可瀏覽的 markdown wiki 頁面： 輸出為可連結的 .md 檔案，隨著更多文件參照既有或新實體而成長。
Wikipedia 風格的 HTML 呈現： garden open 產生並提供帶有導覽、搜尋及反向連結的 HTML wiki。
本機優先運作： wiki 以本機資料夾中的 markdown 檔案儲存，而非雲端資料庫。
選用 git 整合 / 自動提交： garden init 可啟用 git，wiki 可自動以提交更新（依設定選用）。
自訂服務的連接器方式與審核： 內建連接器已預先建置並測試；對「Other」，AI 產生連接器腳本供審核後執行。
明確的非目標（保留逐字稿）： 它不會改寫或摘要內容；逐字稿在來源文件中保持原樣。

安裝與必要條件： 以 npm install -g garden-md 安裝。需使用 Node.js 18+ 並提供支援 AI 供應商的 API 金鑰。
初始化你的 wiki： 執行 garden init 選擇 AI 供應商、設定 wiki 位置，並選用啟用 git。
連接資料來源： 執行 garden connect 選擇服務—Grain、Granola、Fireflies.ai 或 Other—來設定同步。對「Other」，提供服務名稱及 API 文件 URL。
同步新逐字稿： 執行 garden sync 將新逐字稿拉入暫存區（示範輸出顯示為「wildland」）。
處理至 wiki： 執行 garden tend 擷取實體、建立存根頁面並產生連結 markdown/wiki 結構；接著執行 garden open 瀏覽產生的 HTML wiki。

常見指令包括：garden connect --repair（修復損壞連接器）、garden sync --schedule（基於 cron 的自動同步），以及 garden tend / garden open 用於處理與瀏覽。

將會議逐字稿轉成可搜尋的內部 wiki： 同步會議筆記/逐字稿來源後，執行 garden tend 產生實體頁面及反向連結，讓團隊成員能依人物、公司或產品/工具瀏覽公司知識。
以原始素材為後盾的「公司大腦」： 因為 garden-md 避免改寫/摘要，團隊可依賴原始逐字稿內容，同時享有結構化 wiki 層。
新會議到來時持續更新 wiki 頁面： 使用 garden sync（選用 --schedule）引入新逐字稿，再重新執行 garden tend，讓 wiki 成長並擴展連結，當額外文件參照實體時。
以共通導覽層入門團隊或利害關係人： 使用 garden open 瀏覽帶側邊導覽及搜尋的 HTML wiki，更易在眾多逐字稿中找到相關提及。
經由 API 整合自訂逐字稿來源： 在 garden connect 選擇「Other」並提供 API 文件；工具產生供審核的連接器腳本後執行。

garden-md 會改寫或摘要我的逐字稿嗎？ 不會。garden-md 保持逐字稿原樣（不改寫或摘要內容）。
wiki 儲存在哪裡？ 以本機 markdown 檔案（.md 檔案資料夾）儲存於你的機器；不需資料庫或雲端儲存。
哪些服務開箱即用？ 儲存庫列出內建測試連接器，支援 Grain、Granola 和 Fireflies.ai。其他服務可使用「Other」搭配 API 文件。
garden tend 和 garden open 做什麼？ garden tend 從暫存區讀取、送內容至你的 AI 供應商擷取實體，並更新連結 markdown wiki。garden open 呈現並提供 HTML wiki 供瀏覽。
需要哪些必要條件？ README 指出需 Node.js 18+，並需任何支援 AI 供應商的 API 金鑰。

使用 Markdown + 腳本手動建置 wiki： 如果只需基本組織，您可以自行建立並連結 Markdown 頁面，而無需 AI 驅動的實體擷取與 HTML 渲染工作流程。
使用具匯入管線的文件/wiki 平台： 通用知識庫可儲存與搜尋文件，但工作流程不同，因為 garden-md 專門從逐字稿產生 Wikipedia 風格的跨連結實體頁面。
具知識庫的逐字稿摘要工具： 有些工具專注摘要逐字稿並索引摘要；garden-md 的方法不同，因為它保留原始文字並建構結構化實體連結，而非以摘要取代內容。
自訂 ETL 管線（同步 → 解析 → 索引）： 對於已有工程支援的團隊，您可使用自家工具與儲存來複製「同步 + 實體擷取 + 連結」模式，而非使用 garden-md 的指令集與 wiki 渲染器。