哈利哥的寫作工具 / OBSIDIAN 插件

Harry Toolkit讓寫作的大小事,
在筆記裡安頓好。

寫稿、排程、複製貼文,再回看 Threads 成效。
把我每天寫作會用到的小工具,收進同一個 Obsidian 插件。

免費開源 · Obsidian 1.8.7 以上 · 功能可獨立開關

我的寫作工作桌
一篇文章,慢慢完成把閱讀變成自己的語言

記下想法,也替它安排一個
與讀者見面的日子。

草稿 → 已排程
發佈月曆我的一週
一二三四五
21
22閱讀心得
23
24校對初稿
25
✓ 複製為 Facebook 貼文↗ 回看 Threads 成效
功能流程示意,非插件實際畫面
本頁目錄:介紹、安裝與連線

01 / 功能介紹

從寫下來,到回頭看。

四個小工具,各自解決寫作流程裡一件常遇到的事。需要哪個,就開哪個。

01

寫作與校對

內容往前走,視線留在原位。

用快捷鍵讓內容上下移動,游標留在畫面上原來的位置。讀長文、逐段修改時,手不用一直切換滑鼠。

  • 每次移動 1~20 個視覺行,長段落折行也能逐行移動。
  • 支援原始碼模式與即時預覽,可選擇平滑捲動。
  • 快捷鍵由你指定。
02

發佈月曆與待辦

替草稿找到日子,也替待辦留個位置。

把草稿拖進月曆就能排程;文章和待辦放在一起,哪天要發、哪件事還沒做,一眼看得到。

  • 拖曳改期、跨月排程、到期與逾期提醒;發完後手動標記完成。
  • 月曆底部直接瀏覽資料夾、找草稿、釘選常用筆記。
  • 待辦可直接修改與勾選;點日期數字可串接 Obsidian 每日筆記。
  • 月曆可放側邊欄、主編輯區,桌面版也能移至獨立視窗。

這裡負責排程與提醒。文章仍由你到各平台發布,不會自動發文。

03

複製為 Facebook 貼文

寫好的段落,貼出去也好讀。

複製時移除 Markdown 標記,保護空行與連續空格,避免貼到 Facebook 後段落黏在一起。只處理剪貼簿,不改動原筆記。

  • 有選取文字就只複製選取段落,沒有選取則複製整篇。
  • 移除筆記屬性、圖片與私人註解;保留連結網址與 hashtag。
  • 完成後顯示字數,圖片再到 Facebook 自行上傳。
筆記裡
## 今天的閱讀

**少讀一點,想深一點。**
貼文文字

今天的閱讀

少讀一點,想深一點。

04

Threads 數據

回看哪些文字,讓讀者停了下來。

透過官方 API 讀取自己帳號的貼文,把內文和成效存在 vault 裡,直接在 Obsidian 搜尋、比較與回顧。

  • 依瀏覽、讚、回覆、轉發、引用、分享或發佈時間排序。
  • 日常更新最近貼文,必要時全部重抓;抓取途中可手動停止。
  • 可另外開啟自己的回覆抓取,再於面板勾選「含回覆」。
  • 資料預設存到「Threads 數據/posts.json」,移除插件後仍保留。

02 / 安裝插件

先把工具箱裝進 Obsidian。

準備好 Obsidian 1.8.7 或更新版本,就能開始。

  1. 打開社群插件

    進入 Obsidian「設定 → 社群插件」。若尚未啟用社群插件,先依畫面提示開啟。

  2. 搜尋 Harry Toolkit

    按「瀏覽」,輸入 Harry Toolkit。

  3. 安裝,再按啟用

    完成後,在設定側欄找到「Harry Toolkit」。看得到各功能的設定區塊,就安裝成功了。

03 / THREADS 連線 · 選用

把自己的貼文成效帶回來。

只有 Threads 數據需要這段設定。Token(存取權杖)是讓插件讀取你帳號資料的憑證,取得後貼回自己的 Obsidian 即可。

  1. 建立使用 Threads API 的應用程式

    登入 Meta for Developers,建立新應用程式,並在使用案例選擇「存取 Threads API」。名稱只要是你容易辨識的名稱即可,例如「我的 Threads 工具」;不需要命名為「Harry Toolkit」。

    首次使用者還沒有 Meta 開發者帳號?看到建立帳號或「立即開始」時,展開完成 A1~A6。
    OPTIONAL ROUTE

    只有第一次需要。如果你登入後已經看到應用程式清單,可以略過這段,直接往下建立應用程式。

    角色請依自己的情況選擇,不必一定照圖片選「其他」;電子郵件頁面的行銷通知也可以不勾選。

    開發者帳號建立完成。收合這段補充流程,接著建立自己的 Threads API 應用程式。

    MAIN FLOW

    接著建立應用程式已有開發者帳號,或剛完成上方註冊流程,都從這裡繼續。

  2. 把自己的 Threads 帳號加入測試人員

    到 App roles/角色設定,把自己的 Threads 帳號加入 Threads Tester。這一步是讓尚未公開的 App 可以讀取你自己的資料。

  3. 到 Threads 接受邀請

    登入 Threads 網頁版,找到測試人員邀請並接受。

  4. 產生自己的存取權杖

    回到 Meta for Developers,產生存取權杖。

  5. 回到 Harry Toolkit,測試連線

    開啟「設定 → Harry Toolkit → Threads 數據」,在「存取權杖」貼上 Token,按「測試連線」。不用填 App ID 或 App Secret。

    HARRY TOOLKIT
    Harry Toolkit 的 Threads 數據設定:紅框標示存取權杖欄位,下方有測試連線按鈕;權杖內容已隱藏。

    完成判斷:看到「連線成功」與自己的 @帳號。

  6. 同步第一批貼文

    從左側長條圖圖示或「開啟 Threads 數據面板」指令進入面板,按「更新最近貼文」,預設處理最近 30 天的貼文。第一次需要更早的內容時,再使用「全部重抓」。

    若要納入自己的回覆,先確認 Token 有回覆讀取權限,於設定開啟「一併抓取我的回覆」,重新抓取後,再在面板勾選「含回覆」。

    完成判斷:面板出現自己的貼文與成效;最近沒有發文時,可改抓較長期間。

Token 請只留在自己的設定裡

權杖以明文存在 .obsidian/plugins/harry-toolkit/data.json,若這個檔案被同步、備份或上傳 Git,權杖也會一起帶走。分享截圖前請遮住權杖,不要把設定檔公開。

長效 Token 一般有效 60 天;插件在知道到期時間、且剩餘不到 10 天時會嘗試延長。已過期或失效時,回 Meta 重新產生,再貼回設定並測試連線。

04 / 常見問題

使用前後,你可能會想知道。

不連接 Threads,也能用嗎?

可以。捲動、發佈月曆與待辦、Facebook 貼文複製都不需要 Token,也不需連網。只開啟需要的功能即可。

會幫我自動發文嗎?

不會。月曆管理日期與狀態;複製功能把文字放到剪貼簿。你仍需要到 Facebook 或 Threads 自行發布。

手機能使用嗎?

插件允許在手機使用,但月曆拖放需要滑鼠,手機請改用排程指令。獨立視窗僅適用桌面版;捲動快捷鍵也需要合適的鍵盤操作。

測試連線失敗,或有貼文卻沒有成效?

先確認 Token 是否過期、測試邀請是否已接受,以及是否使用同一個 Threads 帳號。成效需要 threads_manage_insights 權限;缺少時重新授權並取得 Token,再測試連線。

為什麼看不到我的回覆?

需要 threads_read_replies 權限、在設定開啟「一併抓取我的回覆」、重新同步,最後在面板勾選「含回覆」。只勾面板上的選項不會自動抓回資料。

同步很久,可以停止嗎?

成效會逐篇抓取,篇數越多時間越長。按「停止」會保留已抓到的部分;關閉面板分頁不會停止。請避免直接關閉 Obsidian 或停用插件,該輪尚未儲存的進度可能遺失。

停用或移除插件,資料會不見嗎?

文章排程存在筆記屬性,待辦是一般 Markdown,Threads 成效存在指定資料夾的 posts.json。停用插件後仍能閱讀這些資料;平常也請一併備份自己的 vault。

怎麼更新?找不到頁面介紹的功能怎麼辦?

在「設定 → 社群插件」檢查更新。本頁以本機開發功能為準,公開下載版可能較舊;請查看 GitHub Releases 的版本說明。切換功能開關後也要重新載入插件。

從下一篇草稿開始,
慢慢整理出自己的寫作節奏。