Skip to content

pc035860/threads-history

Repository files navigation

脆足跡 Threads History

Threads History

自動記錄你在 Threads 瀏覽過的貼文


這是什麼?

「脆足跡」是一個 Chrome 瀏覽器擴充功能。當你在 Threads.com 滑貼文時,它會自動幫你記住看過哪些內容。

功能特色

  • 自動記錄 — 瀏覽時自動儲存,不需要手動操作
  • 快速搜尋 — 輸入關鍵字即時過濾,支援多關鍵字搜尋(空格分隔)
    • 搜尋結果會自動高亮顯示關鍵字
    • 智慧截取包含關鍵字的內容段落
  • 深色模式 — 跟隨系統設定,保護你的眼睛
  • 匯出資料 — 支援 JSON 和 CSV 格式,方便備份
  • 隱私優先 — 資料只存在你的電腦,不會上傳到任何伺服器

安裝方式

方法一:從 Chrome 線上應用程式商店安裝

https://chromewebstore.google.com/detail/threads-history/eefmjghkfjnkcaopgpepfeokdbhdicoj

方法二:手動安裝

  1. 下載擴充功能

    • 點擊本頁面的綠色「Code」按鈕
    • 選擇「Download ZIP」
    • 解壓縮下載的檔案
  2. 開啟 Chrome 擴充功能頁面

    • 在網址列輸入 chrome://extensions
    • 按 Enter 進入
  3. 開啟開發人員模式

    • 在頁面右上角,打開「開發人員模式」開關
  4. 載入擴充功能

    • 點擊「載入未封裝項目」按鈕
    • 選擇剛才解壓縮的資料夾中的 dist 資料夾
  5. 完成!

    • 你會在瀏覽器右上角看到擴充功能的圖示
    • 現在可以開始使用了!

注意:手動安裝需要先建置專案。如果 dist 資料夾不存在,請參考下方「開發者資訊」章節。

使用方式

  1. 正常瀏覽 Threads

    • 像平常一樣滑 Threads
    • 擴充功能會自動記錄你看過的貼文
  2. 查看記錄

    • 點擊瀏覽器右上角的擴充功能圖示
    • 會顯示你最近瀏覽過的貼文列表
  3. 搜尋貼文

    • 在搜尋框輸入關鍵字
    • 支援搜尋作者名稱和貼文內容
    • 支援多關鍵字搜尋(用空格分隔)
    • 搜尋結果會高亮顯示關鍵字
  4. 匯出資料

    • 點擊「匯出」按鈕
    • 選擇 JSON 或 CSV 格式
  5. 調整設定

    • 點擊齒輪圖示開啟設定
    • 可以調整保留的貼文數量(預設 1000 篇)

常見問題

Q: 我的資料會被上傳嗎?

不會。 所有資料都只存在你的電腦本機,不會傳送到任何伺服器。

Q: 可以記錄多少篇貼文?

預設可以記錄最近的 1000 篇貼文。你可以在設定中調整這個數字(100 到 10000 之間)。

Q: 為什麼有些貼文沒有被記錄?

擴充功能只會記錄「真正出現在畫面上」的貼文。如果你滑太快,可能會漏掉一些。

Q: 更新擴充功能後資料會遺失嗎?

不會。 資料儲存在瀏覽器的 IndexedDB 中,更新擴充功能不會影響已儲存的貼文。第一次使用新版本時,系統會自動將舊版資料遷移到新的儲存格式。

Q: 如何刪除所有記錄?

目前可以透過「匯出」功能備份後,到 Chrome 擴充功能頁面移除並重新安裝擴充功能來清除資料。

Q: 支援其他瀏覽器嗎?

目前只支援 Chrome。理論上也可以在 Edge、Brave 等基於 Chromium 的瀏覽器使用。

Q: 為什麼有時候擴充功能會突然失效?

這是因為 Threads 網站的特殊性質:

Threads 不像一般網站,它沒有提供穩定的資料抓取方式。為了提取貼文內容,這個擴充功能需要:

  • 分析 Threads 的頁面結構(DOM)
  • 根據連結格式和排列方式來「猜」哪個是貼文
  • 過濾掉干擾元素(按鈕文字、時間顯示、引用內容等)

這些方法都很脆弱—只要 Threads 更新網站設計(改變頁面結構、調整 CSS class 名稱、修改互動方式),擴充功能就可能無法正確識別貼文。

如果遇到這種情況:

可以在 GitHub Issues 回報問題

感謝你的耐心與支持!🙏

開發者資訊

如果你想參與開發或自行建置:

# 安裝依賴(需要先安裝 Bun)
bun install

# 建置專案
bun run build

# 執行測試
bun test

# 發布新版本
bun run release:patch   # 錯誤修復 (1.0.0 -> 1.0.1)
bun run release:minor   # 新功能 (1.0.0 -> 1.1.0)
bun run release:major   # 破壞性變更 (1.0.0 -> 2.0.0)
bun run release:dry     # 預覽發布變更

建置完成後,dist 資料夾就是可以載入的擴充功能。

Release 流程

執行 bun run release:patch 會自動完成以下步驟:

  1. 更新版本號(package.json + public/manifest.json
  2. 建立 git commit 和 tag
  3. 執行 build 並打包到 packing/chrome-vX.X.X.zip

接著只需推送到遠端並上傳 zip 檔到 Chrome Web Store。

授權

MIT License

About

自動記錄你在 Threads 瀏覽過的貼文

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors