前言¶
在 DeepSeek Harness（DSH）裏一邊寫 Agent、一邊盯社區動態，常見做法是開瀏覽器切 tab，或用腳本直連 V2EX。前者和開發環境割裂，後者容易把 Token 寫進配置或日誌，還未必能在側邊欄和 Agent Tools 裏複用同一套能力。社區維護的 oday0311/dsh-v2ex-client（npm 包名 v2ex-dsh-client）把 V2EX 做成 DSH 插件：側邊欄登錄後讀最新、熱門、分區和節點，Agent 側走同一套只讀工具；興趣學習與推薦在明確授權後纔讀本地歷史，不把 PAT 放進插件設置或模型上下文。
這是什麼¶
v2ex-dsh-client 面向 DSH >=0.2.1-rc.5 <0.3.0，提供只讀的 V2EX 瀏覽與發現。維護者爲 oday0311，源碼在 GitHub，當前發佈版本爲 0.1.0，許可證 MIT。插件通過 Host 路由與側邊欄 UI 拉取官方 HTTPS 上的公開內容與會員身份；對 V2EX 的請求一律 GET，不能發帖、回覆、感謝、收藏等寫操作。
環境與依賴¶
安裝前確認：
- Node.js 22 或更新版本（
package.json中engines.node爲>=22）。 - DSH 版本落在
>=0.2.1-rc.5 <0.3.0。 - 在 V2EX 賬號設置中創建的 Personal Access Token（PAT），用於側邊欄登錄。
正常運行不需要在環境變量或插件配置裏寫 Token；僅維護者的可選冒煙測試使用保留變量 V2EX_TEST_TOKEN，日常 Host 與發佈門禁不使用它。
核心功能¶
只讀瀏覽¶
支持 Latest、Hot、公開分區 tab（如 Tech、Creative、Play、Apple、Jobs、Deals、City、Q&A、Hot、All、R2、VXNA）以及 Nodes 目錄下的節點話題與分頁回覆。內容經校驗、限大小並帶緩存；不可達時展示上次有效緩存。AI 摘要需用戶顯式觸發，並說明覆蓋的話題與回覆頁範圍；未配置模型時仍可普通瀏覽。
登錄與憑據¶
在 DSH 側邊欄打開 V2EX 項，粘貼 PAT。Host 校驗通過後寫入 DSH 憑據服務，不寫入插件 settings、內容存儲、瀏覽器 storage、模型 prompt、Tool 返回或日誌。換 Token 前會校驗新憑據；登出可選清除本地 profile 與推薦數據。
Agent Tools¶
與側邊欄能力邊界一致：面向模型的工具均爲只讀。V2EX 正文視爲不可信輸入，僅將有界的規範化數據交給當前 DSH 模型，模型 tools 關閉，結構化輸出再校驗。
興趣學習與隱私¶
歷史學習默認關閉，僅在 Interest 中明確授權後開啓。從有界用戶文本中學習，排除 system、assistant、tool、附件及憑據形態內容；不存原始歷史，只持久化可編輯的結構化 profile。可查看/編輯標籤、偏好節點、排除項，暫停學習、手動重學、撤銷授權或清空 profile。興趣、設置、推薦、已讀與反饋按校驗後的 V2EX 賬號隔離。
刷新、限流與提醒¶
後臺刷新僅在 DSH Host 運行期間執行；默認約 30 分鐘、最新 feed、偏好節點最多兩頁。交互讀優先，接近 V2EX 報告限流時後臺會退讓。Settings 可調刷新間隔、關注節點、每源頁數、AI 候選預算、通知閾值及帶 IANA 時區的 quiet hours。提醒只投遞給合適的頂層 DSH Agent，不是系統通知，DSH 退出後不保證送達。
安裝與啓用¶
從 npm 安裝到指定 profile，按提示重啓 DSH：
dsh plugin --profile <name> add v2ex-dsh-client
將 <name> 換成你的 DSH profile 名稱。可檢查包是否裝上：
dsh plugin --profile <name> list v2ex-dsh-client --depth 0
包亦見於 npm。本地開發需先 pnpm install 與 pnpm build，再用絕對路徑安裝 checkout（Host 入口 v2ex-dsh-client，瀏覽器入口 v2ex-dsh-client/client）。
重啓後在側邊欄打開 V2EX，用 PAT 登錄即可開始瀏覽。
典型用法¶
- 日常刷帖：側邊欄選 Latest、Hot 或某分區 / 節點，點開話題與回覆分頁。
- 摘要：在支持 AI 的 DSH 環境中對當前話題或回覆頁執行顯式摘要動作；以源帖爲準覈對輸出。
- 個性化發現：在 Interest 授權學習後編輯標籤與節點偏好；在 Settings 裏設刷新與 quiet hours，由 Agent 接收未讀提醒（需有可用頂層 Agent）。
- Agent 會話：通過插件提供的只讀 Tool 查詢話題與節點信息，勿期望任何寫回 V2EX 的能力。
適用場景與注意¶
適合需要在 DSH 工作區內讀 V2EX、並偶爾讓模型幫忙歸納線索的開發者。插件以當前 DSH 進程權限運行，安裝前宜瀏覽 倉庫源碼 與 MIT 許可證。社區目錄 SkillHub 插件頁 與 GitHub 無 DeepSeek / 幻方官方從屬關係，屬社區「一切皆插件」生態中的獨立條目。
故障排查可參考 README：登錄被拒則換新 PAT 並去掉首尾空白；限流則等重置時間；興趣學習不可用需安裝 DSH history-query 服務後再授權；錯賬號則登出並勾選清除個人數據後重登。
結尾¶
v2ex-dsh-client 把 V2EX 收窄爲可審計的只讀通道：PAT 走憑據服務，對站點的變更能力是硬性禁止的。若你已經在用 DSH 0.2.x 並希望減少切窗口成本，可按上述命令裝入 profile 後從側邊欄登錄試用。更多說明見 GitHub README 與中文 README_ZH.md。
