前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。對於需要跟蹤技術資訊、博客動態或社區更新的開發者來說，直接在 DSH 環境內完成訂閱、閱讀和整理是常見需求。dsh-rss-reader 是一個內嵌的 RSS / Atom 閱讀器插件，它將訂閱源管理、內容瀏覽、翻譯整理等功能集成在 DSH 的 Web profile 界面中，無需跳轉至外部應用。
界面與閱讀體驗¶
插件提供兩種呈現形態，滿足不同的佈局需求。
中間主區域（三欄佈局）
點擊左側欄的 RSS 圖標，可在主區域打開三欄閱讀界面：左側爲訂閱源列表，中間爲條目流，右側爲正文閱讀區。
右側邊欄（單欄形態）
插件同時註冊爲一個原生右側邊欄 tab。入口位於左側欄底部的“RSS 閱讀器”按鈕或右側邊欄的“+”面板選擇器。該欄較窄，採用單欄形態：頂部爲訂閱源膠囊條（顯示源名與未讀數），下方爲條目列表。點擊條目後，詳情頁會替換列表位置，無需跳轉新標籤頁。
閱讀體驗經過優化。詳情頁採用 position: sticky 的返回按鈕，滾動時始終停留在頂部，無需手動滾回列表。插件會記憶上次讀到的源、條目位置和滾動進度，再次打開時自動恢復。切換訂閱源時，會自動回到列表視圖。正文支持 Markdown 渲染，圖片默認摺疊在原位，支持一鍵翻譯。
訂閱源管理¶
訂閱源管理支持自由排序和右鍵操作。在面板內可拖拽訂閱源調整順序，或在設置頁使用 ↑ / ↓ 按鈕精確調整。取消訂閱需要通過右鍵菜單進入二次確認，防止誤刪。
訂閱源欄在右側邊欄模式下支持收起，以騰出更多空間給內容。摺疊狀態是偏好設置，重啓後仍然有效。
內容發現與處理¶
支持探索 RSSHub 路由表和粘貼網頁發現訂閱源。對於只提供近期內容的源，支持通過歸檔頁抓取更早的文章。支持增量抓取（ETag/Last-Modified）和可選後臺刷新。
正文支持一鍵翻譯，複用 DSH 中配置的翻譯模型。譯文同樣以 Markdown 渲染，支持在原文/譯文/對照之間切換。
安裝¶
插件以依賴的形式裝進某個 profile。需要 DSH ≥ 0.2.0-rc.1，且 PATH 中需包含 pnpm（dsh plugin 是 pnpm 的轉發器）。
安裝命令如下：
dsh plugin --profile web add github:FYKANG/dsh-rss-reader
安裝完成後，左側欄會出現 RSS 入口，點擊可在主區域打開三欄面板；左側欄底部會出現“RSS 閱讀器”按鈕，點擊可在右側邊欄打開單欄面板。
使用¶
- 添加訂閱：點擊面板中的“+”或直接粘貼網頁地址（支持智能發現
rel=alternate），點“添加並獲取”。 - 閱讀：在中間三欄或右側單欄中點擊條目閱讀。右上角有“譯”按鈕可一鍵翻譯。
- 管理：在訂閱源列表上右鍵可進行刷新、標記已讀或取消訂閱操作（需二次確認）。
注意事項¶
- 依賴：必須滿足 DSH ≥ 0.2.0-rc.1 且 PATH 中有 pnpm。
- 數據存儲：訂閱數據存儲在
$DSH_HOME/rss-reader/feeds.json。卸載插件不會刪除此文件。 - 手動掛載：插件安裝時會自動追加到
dsh.profile.bundles。如需手動掛載，需修改cordis.patch.yml，但兩者二選一即可。 - 後臺刷新：需在設置中開啓
refreshMinutes才能生效。
