本機外掛

v1.1.9

下載並安裝

在自己的電腦管理影片圖書館：貼連結、上傳、AI 分析與搜尋。不必登入雲端圖書館；資料寫在你家硬碟。下面步驟用一般用語說明，不懂技術也能跟著做。

先選你的電腦系統：

下載 Mac（.dmg）下載 Windows（.exe）
  • Mac — 適用 Apple 晶片（M1／M2／M3…）· 約 153 MB
  • Windows — 64 位元電腦 · 約 115 MB
  • 目前 Mac 安裝包以 Apple 晶片為主；較舊的 Intel Mac 可能不相容。
重要：外掛安裝後不會開成一般大視窗 App。請到選單列（Mac）或右下角通知區（Windows）找「原子」小圖示，點它才能「開啟本機圖書館」。

Mac 若提示「已損毀／無法打開」

這是尚未代碼簽名造成，不是檔案壞掉。可擇一處理：

  1. 打開「終端機」（應用程式 → 工具程式 → 終端機），貼上下面兩行後按 Enter（會要求輸入登入密碼，輸入時螢幕可能不顯示字元，屬正常）：
sudo xattr -cr "/Applications/Vidbrary Agent.app"
open "/Applications/Vidbrary Agent.app"

或：在「應用程式」對 Vidbrary Agent 按住 Control 再點一下→ 選「打開」→ 再按一次「打開」。完整步驟見 Mac 安裝。Windows 若遇 SmartScreen →「其他資訊」→「仍要執行」。

這是什麼？

裝在你家電腦上的「影片圖書館」：貼連結或上傳後，AI 幫你整理摘要、章節與工具筆記，之後搜得到。

我需要準備什麼？

一台 Mac（Apple 晶片）或 Windows 電腦、網路，以及至少一組 AI Key（例如 Google Gemini）。LINE 為選配。

大概要多久？

下載與安裝約幾分鐘；第一次填帳密與 Key 再幾分鐘。之後貼連結就能邊做事邊等分析完成。

從頭到尾

第一次使用：五步

建議依序完成。前四步就能在電腦上分析影片；第五步只有要用手機 LINE 傳片才需要。

  1. 1

    下載並安裝

    上方依你的電腦選 Mac 或 Windows。安裝後請打開「Vidbrary Agent」。

  2. 2

    填本機帳密

    會跳出設定小視窗。Email 與密碼是「只給這台電腦用的登入資料」，不必是真實信箱；密碼至少 8 個字。其他欄位可先維持預設。

  3. 3

    儲存並開圖書館

    按「儲存並開啟本機庫」。瀏覽器會打開本機頁面（網址像 http://127.0.0.1:3000），用剛剛填的 Email／密碼登入。

  4. 4

    設定 AI 再貼片

    登入後到左側「模型委員會」填入至少一組 AI Key（例如 Gemini），存檔後再貼影片連結或上傳檔案。沒有 Key 就無法完成分析。

  5. 5

    （選配）連接 LINE

    只有要用手機傳片時才做。在設定填中繼網址與註冊令牌 → 外掛圖示顯示 8 位配對碼 → 傳給官方 LINE 帳號。詳見下方「連接 LINE」。

安裝細節

依系統安裝

裝好後請記得找「原子」圖示。圖書館畫面永遠在瀏覽器裡。

Mac（Apple 晶片）

  1. 點上方「下載 Mac」，等檔案下完（副檔名 .dmg）。
  2. 在「下載項目」資料夾雙擊該檔，會開一個小視窗。
  3. 把「Vidbrary Agent」圖示拖進右邊的「應用程式」資料夾。
  4. 到「應用程式」裡雙擊 Vidbrary Agent 開啟。
  5. 若系統說「已損毀」或「無法驗證」：不是檔案壞掉，是因為尚未代碼簽名。請看下方黃框處理方式。
  6. 開啟成功後：畫面上方選單列、靠近時鐘的地方會出現「原子」小圖示。外掛本身沒有傳統大視窗——圖書館是在瀏覽器裡開的。
sudo xattr -cr "/Applications/Vidbrary Agent.app"
open "/Applications/Vidbrary Agent.app"

Windows

  1. 點上方「下載 Windows」，等檔案下完（副檔名 .exe）。
  2. 雙擊安裝程式，依畫面提示完成安裝。
  3. 若出現「Windows 已保護你的電腦」：點「其他資訊」，再點「仍要執行」。（未簽名軟體的常見提示，不是病毒警報的唯一依據。）
  4. 從「開始」選單開啟 Vidbrary Agent。
  5. 圖示會出現在畫面右下角通知區域（時鐘旁邊；若看不到，點 ^ 向上箭頭展開隱藏圖示）。同樣：沒有大視窗，點圖示才能開圖書館。

設定視窗

第一次開啟要填什麼？

首次啟動會出現「本機影片圖書館」設定視窗。新手只需填 Email 與密碼，其餘維持預設即可。

本機登入 Email（必填）
自訂一個帳號名稱即可，例如 mylibrary@local。之後打開圖書館都用這組登入。
本機密碼（必填）
至少 8 個字。請自己記住；遺失可到外掛選單改設定，但建議寫在安全處。
本機圖書館位址
新手請維持預設 http://127.0.0.1:3000，不要改。
專案目錄 VIDBRARY_HOME
用官方安裝包時請留空。只有自己從原始碼開發時才填。
下方三個勾選
建議維持預設：自動開啟圖書館、使用內建資料庫。不懂 Docker 就不要改。

填完按 「儲存並開啟本機庫」。若瀏覽器沒自動開，再點外掛圖示 →「開啟本機圖書館」。

用法

打開之後怎麼用

日常怎麼打開圖書館

Mac：點選單列原子圖示 →「開啟本機圖書館」。Windows：點右下角原子圖示 → 同樣選項。瀏覽器開起後，用設定時的 Email／密碼登入。

設定 AI（模型委員會）

左側選「模型委員會」，貼上 Gemini／Agnes／OpenAI／Claude 或本機 Ollama 等 Key，並指定偏好的分析引擎。存檔後再貼連結。有 Gemini 時，YouTube／本機檔可跑較完整的分析。

貼連結入庫

在首頁貼上 YouTube、Bilibili、Instagram、Facebook 等影片網址，送出後頂部會顯示「分析中」。完成後點卡片看摘要、章節、工具與專有名詞。

上傳本機影片

用上傳選擇 mp4／mov 等檔案（單一檔約 ≤16MB）。更大檔請用連結入庫或分段。

收藏與搜尋

詳情裡可收藏；側欄「★ 收藏」可篩選。搜尋列可找標題與內容（有 embedding Key 時語意搜尋較準）。

選配

連接 LINE（要用手機傳片才做）

配對成功後，可在 LINE 傳影片檔或貼網址，內容會進你這台電腦的圖書館。電腦需開機且外掛在線。也可在 LINE 說「有哪些影片」、或「刪除 編號」→「確認刪除」；重複連結可回「確認重分析」。

  1. 確認本機外掛已用帳密設定完成，且能打開圖書館。
  2. 再打開設定，在「選填 · LINE 中繼」填：
    • 中繼網址（RELAY_URL）：https://viobrary.uk
    • 裝置註冊令牌（DEVICE_REGISTER_TOKEN）：須與官網中繼站相同。若安裝包／說明未附帶此值，請向官方取得後再填；留空就無法產生配對碼。
  3. 儲存後，點外掛圖示 →「複製配對碼」（8 位）。約 30 分鐘內有效；過期可「重新整理配對碼」。
  4. 手機 LINE 加入官方帳號，把這 8 位碼傳給 Bot，應收到「已與本機外掛配對」。
  5. 之後傳 mp4 或貼 YouTube／B 站等連結即可。請保持電腦外掛執行中。
在 LINE 加好友

疑難

安裝時最常卡住的地方

多數問題其實是「系統安全提示」或「找不到圖示」，不是軟體壞掉。可先對照下表，再看下方詳細說明。

你看到的狀況先試這個
已損毀／無法打開（Mac）黃框 xattr 或 Control＋打開
SmartScreen（Windows）其他資訊 → 仍要執行
沒有大視窗找原子圖示，不是當一般 App
圖書館打不開等 1–3 分鐘；退出重開；檢查 3000 埠
分析一直失敗先設定模型委員會 AI Key
沒有 LINE 配對碼填中繼網址＋註冊令牌

詳細說明

為什麼打開後沒有大視窗？
這是設計如此，不是安裝失敗。外掛在背景執行，圖示在 Mac 上方選單列（時鐘旁）或 Windows 右下角通知區。點原子圖示 →「開啟本機圖書館」。
Mac 一直說「已損毀／無法驗證」？
因為安裝包尚未代碼簽名，系統會阻擋。請用本頁黃框的兩種方法之一（終端機兩行指令，或對 App 按住 Control 再點 → 打開）。這不代表檔案壞掉。
Windows 出現「已保護你的電腦」？
點「其他資訊」→「仍要執行」。若被防毒軟體隔離，請在防毒軟體裡允許 Vidbrary Agent 後再安裝一次。
下載後雙擊沒反應，或開不起來？
確認選對系統（Mac 用 .dmg、Windows 用 .exe）。Mac 需為 Apple 晶片；較舊 Intel Mac 可能不相容。也請確認磁碟空間足夠（建議預留 1GB 以上）。
說已經在執行，但找不到圖示？
Mac：看螢幕最上方右側；Windows：看右下角，必要時點 ^ 展開隱藏圖示。仍沒有：從「活動監視器／工作管理員」結束 Vidbrary 後再重新開啟一次。
按了「儲存並開啟本機庫」卻進不去？
第一次啟動常需 1–3 分鐘建立本機資料庫，請稍候再點圖示 →「開啟本機圖書館」。超過 5 分鐘仍失敗：完全退出外掛重開；並確認沒有其他程式占用 3000 埠。
瀏覽器顯示連線失敗／拒絕連線？
代表本機圖書館服務還沒就緒或已關閉。先確認原子圖示還在，再重試開啟。可把網址核對成 http://127.0.0.1:3000（不要改成別人的網站）。
登入時說帳密錯誤？
圖書館登入必須與設定視窗填的 Email／密碼相同；Email 需含 @（例如 my@local）。可從外掛選單再打開設定，重設後用新密碼登入。
貼了連結卻一直分析失敗？
請先到左側「模型委員會」存至少一組可用的 AI Key（例如 Gemini）再重試。沒有 Key 無法完成分析。
LINE 沒有出現 8 位配對碼？
需在設定填中繼網址 https://viobrary.uk 與正確的裝置註冊令牌。兩者缺一就不會發碼。只用電腦收片可跳過 LINE。
LINE 傳了配對碼卻失敗／過期？
配對碼約 30 分鐘有效。請到外掛圖示「重新整理配對碼」後立刻貼到 LINE；並確認電腦外掛在線、中繼網址正確。
資料存在哪裡？會上傳到雲端嗎？
在你使用者資料夾下的 .vidbrary。官網／LINE 中繼只在你選用 LINE 時短暫轉送，不當雲端主資料庫。

進階

給熟悉電腦的人

一般使用者可略過本區。設定檔在使用者目錄下的 .vidbrary/config.env；安裝包已內建可攜式 Postgres（含向量搜尋），不必自己裝 Docker。

LOCAL_API=http://127.0.0.1:3000
LOCAL_EMAIL=you@mail.com
LOCAL_PASSWORD=至少8碼
# 選填 LINE
# RELAY_URL=https://viobrary.uk
# DEVICE_REGISTER_TOKEN=
  • 開發用 zip 啟動腳本： vidbrary-agent-mac-win.zip（非正式安裝包，新手請用上方 .dmg／.exe）
  • 安裝包託管： GitHub Releases v1.1.9
  • v1.1.9：LINE 查片／編號刪除（含確認）、WhatsApp 路徑移除。
  • AI：自備 Key 可用；官方訂閱代付尚未上線。
下載本機外掛 — Vidbrary