前言¶
在 DeepSeek Harness（DSH）裏做研究和寫代碼時，經常需要順便看一眼持倉：個股現價、成本與盈虧、基金淨值是否在更新。單獨開交易客戶端或再開一個瀏覽器標籤，窗口之間來回切，數據和對話上下文是割裂的。持倉看板（dsh-portfolio）把 A 股實時行情、自選與預警、選股與快訊，以及 HPNY 在上游 SuCriss/dsh-leekbox 基礎上新增的場外基金看板，收進 DSH web profile 左側邊欄的一個入口；行情請求由插件在本機代理，瀏覽器同源訪問 /api/leekbox/*，只監聽 loopback。公開行情接口開箱可用，一般不需要 API key（AI 個股分析除外，模型密鑰由用戶自行配置）。
下面介紹插件定位、核心能力、安裝步驟和典型用法，並說明適用邊界。
這是什麼¶
持倉看板是 maintainer HPNY 維護的 DSH Web 客戶端插件，倉庫爲 HPNY/dsh-portfolio，許可證 MIT；基於 SuCriss/dsh-leekbox 擴展，保留上游能力並新增基金子系統。形態上它不是獨立 App，而是嵌在 AI 工作臺裏的標籤頁集羣：看盤、選股、快訊、AI 分析與基金淨值跟蹤在同一窗口，服務端適配器在 lib/ 中可審計。
- 面向標的：滬深京 A 股、ETF / 場內基金、可轉債、LOF；不含港股、美股、期貨。
- 數據：騰訊財經、東方財富、新浪財經、金十等公開接口，由插件服務端抓取並標準化。
- 本機邊界：寫接口對跨站請求有 Origin / Content-Type 校驗；密鑰類配置僅落盤在服務端，界面顯示脫敏值。
社區目錄頁：skillhub.cn 插件條目（分類：聯網工具）。目錄站爲社區收錄，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
已覈實能力按界面組織如下（裝好後側邊欄爲線框柱狀圖圖標的「持倉看板」入口）。
大盤與情緒¶
上證 / 深成 / 創業板 / 科創50 等指數實時展示；交易時段內約 30～60 秒自動刷新。大盤頁含市場情緒溫度計（綜合寬度、漲停強度、封板率、連板高度等維度），以及漲跌家數、漲跌停、炸板率等指標。
行情、搜索與龍虎榜¶
本地約八千隻標的索引，支持代碼、名稱、拼音首字母毫秒級搜索。行情頁提供多池榜單、板塊榜與龍虎榜；龍虎榜按日期回溯到最近已發佈交易日，不把「當日未發佈」僞裝成無數據。
自選、成本與價格預警¶
自選股支持分組；可填持倉成本並實時計算浮動盈虧與收益率。行內可設「漲到 / 跌破 / 漲跌幅達到」預警，交易時段自動盯盤，觸發後 toast、瀏覽器通知與蜂鳴。數據持久化在 $DSH_HOME/.leekbox-watchlist.json、.leekbox-alerts.json，支持 JSON / CSV 導入導出。
選股與快訊¶
選股含技術信號加權評分與多策略交叉兩種模式。快訊聚合新浪、東財、金十三源，跨源去重，重要資訊高亮。
AI 個股分析（可選）¶
服務端彙總實時行情、近 60 日 K 線與 F10 財務摘要後調用用戶配置的模型，輸出結構化中文分析。全局設置在面板頭部；多服務商與模型列表，配置持久化在 $DSH_HOME/.leekbox-analysis.json。
場外基金（相對上游新增）¶
基金標籤頁跟蹤場外基金淨值與估值：成本與份額內聯編輯，展示盈虧百分比、浮盈與歷史淨值曲線（疊加成本線），彙總基金市值與總浮盈。持久化在 $DSH_HOME/.leekbox-otc-fund.json；披露窗口內按文檔約定分段輪詢，詳見倉庫 docs/otc-fund.md。
交易時段與請求治理¶
交易日曆由指數日 K 反推，非簡單「週一至週五」；非交易時段與頁面不可見時客戶端停止無效輪詢。熱路由走 TTL 緩存與 in-flight 去重，上游抖動時可 stale-if-error。可觀測性：GET /api/leekbox/metrics、/health 等。
個股詳情彈窗含分時、前復權 K 線、主力資金與 F10 摘要等，交互細節見 README「七個標籤頁」表格。
安裝與啓用¶
環境要求：DSH ≥ 0.1.1-rc.1、web profile。倉庫已提交客戶端 bundle，通過官方命令安裝時無需本地構建，dsh plugin add 會處理 manifest 與 cordis 重組合。
一條命令安裝到 web profile：
dsh plugin --profile web add github:HPNY/dsh-portfolio
裝完後刷新瀏覽器，左側邊欄出現「持倉看板」入口。若日後發佈 npm 包，README 說明命令可改爲 dsh plugin --profile web add dsh-portfolio；當前無 npm 包，須使用 github: 前綴。
典型用法¶
1、按上面命令安裝並刷新 DSH Web 界面。
2、在「自選」中添加標的並填寫持倉成本，按需設置價格預警；交易時段保持頁面在前臺即可自動盯盤。
3、在「基金」中錄入場外基金成本與份額，查看淨值、估值徽標與解套進度曲線。
4、若使用「分析」頁，先在全局設置中配置模型服務商與密鑰（僅此功能需要自備 API key）。
5、開發本地副本時，可按 README 將倉庫軟鏈到 $DSH_HOME/profiles/web/node_modules/dsh-portfolio 後刷新（Windows 用 mklink /J，macOS / Linux 用 ln -s）。
適用場景與注意¶
適合誰：已在用 DSH web profile、希望在本機工作臺內完成輕量看盤、持倉記賬與基金淨值跟蹤的開發者或研究者；重視開源可自託管、數據鏈路可對照 lib/ 適配器閱讀的場景。
安裝前建議：插件以當前 DSH 進程權限運行，會代您請求第三方財經接口並讀寫 $DSH_HOME 下 .leekbox-*.json 等文件；安裝前應瀏覽倉庫源碼與 MIT 許可證，並閱讀 README 免責聲明——數據僅供研究參考，不構成投資建議。
分類：社區目錄將其歸爲「聯網工具」，與本地純文件類插件不同，會持續訪問公網數據源（交易時段內尤爲明顯）。
結尾¶
持倉看板把 A 股實時行情、自選預警、選股快訊、可選 AI 分析與場外基金看板收到 DSH 同一側邊欄入口，適合不想在 AI 工作臺與獨立行情客戶端之間來回切換的用戶。進一步瞭解功能細節與常見問題，見 GitHub 倉庫 README 與 SkillHub 目錄頁。
