前言¶
在 Harness 裏寫代碼、跑會話時，常需要一邊盯信息流一邊查資料。把 RSS 集成進 IDE 側欄，比另開瀏覽器或獨立閱讀器少一次上下文切換。常見做法是把訂閱和條目混在插件倉庫裏升級，或把抓取交給遠端服務；gitfeed-native 把程序和閱讀數據拆成兩個倉庫，在 Host 本地跑刷新與同步，並以原生 bundle 形式掛進右側邊欄、主面板和 Agent 工具目錄。
這是什麼¶
gitfeed-native（npm 包名 @zizon/gitfeed-native）是由維護者 zizon 發佈的 DeepSeek Harness 原生插件：個人 RSS 閱讀界面、Host 側定時刷新與已讀狀態同步，以及名爲 gitfeed 的 Agent 工具。包內只有代碼；訂閱列表、抓取條目和已讀/標星狀態存放在單獨的 gitfeed 數據倉庫（README 示例爲 zizon/gitfeed，默認可放在本機 ~/gitfeed），安裝或更新插件不會寫入該數據倉，也不要求爲其配置 token。抓取在 Reader 所在 Host 的 job runner 上執行，沒有需要預先啓用的服務端任務。
核心功能¶
閱讀界面¶
主面板爲三欄：左側文件夾、中間帶摘要的單行條目列表、右側正文。右側邊欄（與 Files、Documents 等同層）提供同一套閱讀器；會話標題欄有 RSS 按鈕，右側邊欄 + 引導裏也有 Feeds 卡片。主面板左側全局欄有 gitfeed 圖標（與 Plugins、Tasks 並列），無會話時也可打開。
條目行展示標題、來源與年齡，以及摘要的一行純文本 digest，便於掃列表而不必逐篇打開。可在顯示偏好中關閉 digest。訂閱源所在分區行提供「移入文件夾」「標記該源已讀」「取消訂閱」等操作；標星在條目行上，無需先打開文章。後臺刷新時，欄位顯示上次運行間隔（進行中顯示 …）；菜單內可查看刷新間隔、上次結果（如 0 new · 35 failed）以及自動 Sync 的間隔與下次運行時間。
雙倉庫分工¶
| 倉庫 | 內容 | 可見性（README 說明） |
|---|---|---|
zizon/gitfeed-native |
插件源碼、bundle 元數據、CLI | public |
zizon/gitfeed |
feeds.json、config.json、data/ 等閱讀數據 |
private，克隆到 ~/gitfeed |
拆分的用意包括：代碼可公開而閱讀記錄可私有；插件 git pull 與閱讀狀態 git pull 互不衝突；數據目錄可隨用戶遷移。若數據目錄是 git checkout，界面上的 Sync 可推送訂閱與已讀狀態。
Harness 內的入口與註冊面¶
| 界面 | 如何進入 |
|---|---|
| 右側邊欄頁 | 會話頭 RSS 按鈕，或右側邊欄 + 中的 Feeds 卡片 |
| 主面板頁 | 左側全局欄 gitfeed 圖標 |
| Agent 工具 | 工具目錄中的 gitfeed |
各界面共用同一客戶端控制器與 Host API，兩處同時打開時已選文章與已讀狀態保持一致。右側邊欄在標籤寬度達到約 680px 時可拆成列表與正文兩欄，分隔條可拖拽，雙擊重置寬度。
Agent 工具與調度¶
插件通過 ctx.tools.register 註冊 gitfeed 工具；API 路由用 ctx.effect 註冊，調度器使用 ctx.timeout 定時器，bundle 卸載時一併清理。mark/star 響應攜帶新的狀態版本號，便於客戶端在樂觀更新後做緊湊輪詢。
安裝與啓用¶
運行環境需 Node 24.9 或更新（與 package.json 中 engines.node 一致，也是 Harness 所要求的下限）。
Harness 通過 plugin_manager 或 Web UI Plugins → Add source 安裝外部 bundle，README 給出兩種目標規格。
從 npm 註冊表安裝（發佈版本後推薦）：
{ "action": "install_bundle", "target": "@zizon/gitfeed-native" }
已發佈的 tarball 自帶 lib/，profile 內無需再裝 devDependencies 或批准構建腳本。
從 Git 安裝（倉庫未發佈到 npm 時可用）：
{ "action": "install_bundle", "target": "git+ssh://git@github.com/zizon/gitfeed-native.git" }
pnpm 會克隆包、安裝 devDependencies 並執行 prepare（node build.mjs）。默認會攔截依賴構建腳本；若首次停在 pendingBuilds，需在 Plugins 中對 @zizon/gitfeed-native@<url>#<commit> 選擇 Allow these scripts and retry，或通過工具的 approvedBuilds 重試。
安裝前請自行查看 GitHub 倉庫 源碼與 MIT 許可證。插件以當前 DSH 進程權限運行，安裝外部 bundle 前應完成安全檢查。
典型用法¶
README 中的快速上手步驟如下（數據倉需由用戶自行準備，勿將私人訂閱放進插件公開倉）：
- 將數據倉庫克隆到
~/gitfeed（或首次激活時由插件生成起步目錄）。 - 按上一節安裝 bundle。
- 打開 Feeds 卡片，訂閱源，執行 Fetch 閱讀；若根目錄是 git checkout，用 Sync 推送訂閱與已讀狀態。
日常可在右側邊欄邊讀邊寫會話，或在主面板無會話模式下集中處理未讀。需要 Agent 參與時，在工具目錄調用 gitfeed。
適用場景與注意¶
適合誰： 希望在 DeepSeek Harness 內完成 RSS 閱讀、並願意用獨立 Git 倉保存訂閱與已讀狀態的開發者；分類上屬於社區目錄中的「聯網工具」類能力。
應注意：
- 數據與代碼分離：你必須擁有或創建數據倉（README 指向
~/gitfeed），插件倉不含真實訂閱。 - 從 Git 安裝需本機具備 SSH 訪問 GitHub 的能力，並可能需批准
build.mjs構建。 - 社區插件目錄 SkillHub 條目 與 DeepSeek / 幻方無官方從屬關係；版本以你安裝的 bundle 爲準（資料中 package 版本爲 3.9.13）。
結尾¶
gitfeed-native 把 RSS 閱讀、本地定時刷新、Git 同步和 gitfeed Agent 工具收進一個 Harness 原生 bundle，並通過雙倉庫把可分享的代碼與私有的閱讀數據拆開。進一步瞭解與安裝說明見 SkillHub 目錄頁 與 GitHub：zizon/gitfeed-native。
