dsh-plugin-readlater:本地解析分享鏈,按需投影到 Obsidian

前言

在 DSH 生態裏做智能體或日常信息整理時,常見做法是:把小紅書、公衆號鏈接丟給在線剪藏或模型摘要,再手動拷進筆記。那條路要麼依賴賬號與雲端,要麼閱讀時仍要聯網。稍後閱讀(dsh-plugin-readlater)走另一條路:粘貼分享鏈接,在本機把正文和圖片拉下來,左側卡片、右側直接讀;需要長期留存時再手動同步到 Obsidian。解析與閱讀不經過任何模型,數據落在本地目錄,沒有數據庫。

下面按定位、功能、安裝、用法和數據路徑說明這款插件。事實來自倉庫 README 與 package.json;插件以當前 DSH 進程的權限運行,安裝前請自行查看源碼與 MIT 許可證。

這是什麼

插件全名 dsh-plugin-readlater,倉庫由 1578361862-art 維護(package.json 作者字段爲 Yee),歸類爲 DSH 社區目錄中的聯網工具。當前 package.json 版本爲 0.1.0,要求 DSH ≥ 0.2.1-rc.5、Node ≥ 20。

一句話:粘一條分享鏈接,正文和圖片落到本地;讀的時候不聯網;想留哪篇再點「同步到 Obsidian」,正文、圖片、標籤、索引一併投影過去。

核心功能

本地解析與離線閱讀

小紅書的圖文、微信公衆號的長文:分享鏈接(或整段分享文案)粘進輸入框後在本機解析。正文抽成乾淨 HTML,圖片和視頻按需緩存;左欄出卡片,右邊直接讀。沒有賬號、沒有云端、沒有模型調用。

分享文案可原樣粘貼,不必自己挑 URL,例如 README 中的小紅書示例:文案裏帶 http://xhslink.com/... 即可。

列表搜索與篩選

列表支持搜索(標題 / 作者 / 站點 / 正文摘要 / 標籤,純本地)和篩選(全部 · 未讀 · 已同步 · 有更新)。「批量」可多選後「同步 N 篇」,或對當前篩選結果「全選」一次投影。

輸入框右側 「緩存視頻」 爲全局開關:默認只存直鏈和封面,勾選後纔會把視頻下到本地。

支持的來源

源 狀態
小紅書 已通:分享鏈 + 無頭 Chrome 讀 __INITIAL_STATE__
微信公衆號 已通:HTTP 優先,撞 verify 殼則瀏覽器渲染 #js_content(連續請求會被限流)
抖音 待接
知乎 待接(純 HTTP 403,需帶 cookie 的瀏覽器)

只支持分享出來的鏈接;裸筆記 URL 會被風控。分享鏈裏的 xsec_token 纔是通行證;寫進 Obsidian 筆記的鏈接是清理過的地址,一次性憑證不會進 vault。

投影到 Obsidian

投影是手動的:解析完先留在本地,再點「同步」。約定與 BookTutor 類似:managed_by: "readlater" / managed: true,生成目錄不要手改。標題會變,條目 id 不變,改標題不會在 vault 裏留下兩個文件。

默認落盤結構(節選):

90.同步/ReadLater/
  閱讀索引.md
  <標題>--<id8>.md
  assets/<id8>/img-01.webp

vault 路徑解析順序:READLATER_VAULT > ~/Data/readlater/config.json 的 vault > 默認 iCloud 路徑。

從別處遷入收藏

支持從 InRead(或任何能導出 JSON 清單的地方)批量導入;失敗可重試,撞限流即停。細節見倉庫 docs/IMPORT.md。

安裝與啓用

安裝 release 包(將 <profile> 換成實際名:DSH Desktop 爲 desktop,dsh web 一般爲 web):

dsh plugin --profile <profile> add https://github.com/1578361862-art/dsh-plugin-readlater/releases/latest/download/dsh-plugin-readlater.tgz

裝完重啓 DSH。也可從源碼安裝(本插件無構建步驟):

dsh plugin --profile <profile> add github:1578361862-art/dsh-plugin-readlater

依賴除 Node ≥ 20 外,還需要可用的 Chrome(微信公衆號正文需渲染一次)。默認查找 /Applications/Google Chrome.app;若沒有,用環境變量 READLATER_CHROME 指向可執行文件。

卸載:

dsh plugin --profile <profile> remove dsh-plugin-readlater

插件移除後 ~/Data/readlater 裏已抓取的內容仍保留;不需要時可自行刪除整個目錄。

典型用法

  1. 左側欄點「稍後閱讀」
  2. 把分享鏈接或整段分享文案粘進輸入框,回車
  3. 解析完成後左邊出卡片、右邊閱讀;要進 Obsidian 再點「同步到 Obsidian」

本地數據根目錄默認爲:

~/Data/readlater/
  library/<platform>-<id>/
    meta.json
    content.html
    assets/
  profile/

可用 READLATER_ROOT 修改存儲根。content.html 爲清洗後正文真源,圖片用相對路徑,整個目錄可原樣遷移。

適用場景與注意

適合:習慣從小紅書、公衆號收集長文,希望在 DSH 裏統一讀、再按需進 Obsidian 的開發者或寫作者;強調本地緩存、離線讀、無模型開銷。

注意:

  • 插件在 DSH 進程權限下運行,會啓動無頭 Chrome 訪問目標站;安裝前請閱讀源碼與 MIT 許可。
  • 微信源連續請求可能被限流;抖音、知乎尚未接通。
  • DSH 社區插件目錄(skillhub.cn)爲獨立站點,與 DeepSeek / 幻方無官方從屬關係;星標與版本以你安裝時 GitHub 頁面爲準(資料抓取時倉庫星標爲 0)。

實現細節(微信爲何走瀏覽器、限流策略、投影取捨)見倉庫 docs/IMPLEMENTATION.md;閱讀頁排版見 docs/DESIGN.md。正文由插件自行拼裝而非存站點 DOM,README 說明因此無 XSS 面、亦不需 sanitizer。

結尾

稍後閱讀把「分享鏈 → 本地圖文卡片 → 可選 Obsidian 投影」串成一條可復現流程:讀時不聯網、不調用模型,適合把 DSH 當作本地閱讀臺再用 vault 做歸檔。

  • 目錄頁:https://www.skillhub.cn/plugins/1578361862-art/dsh-plugin-readlater
  • GitHub:https://github.com/1578361862-art/dsh-plugin-readlater
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜