前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在智能體開發或個人投資管理中，通常需要在不同應用間切換：Excel 記錄交易，券商 App 查看行情，數據難以互通。shuiiiiimu/dsh-stock-portfolio 插件將股票持倉管理功能整合進 DSH，通過本地 SQLite 存儲數據，利用對話界面作爲主要交互入口，實現了交易記錄、盈虧統計、日線行情檢索與持倉復盤的一體化。
插件介紹¶
- 名稱：
shuiiiiimu/dsh-stock-portfolio - 維護者：shuiiiiimu
- 分類：記憶
- 定位：DSH 中管理股票持倉的插件，支持交易記錄、盈虧統計、日線行情、離線代碼檢索與持倉復盤。
核心能力¶
該插件將所有數據存儲在本地 SQLite 數據庫中，讀寫同一份數據源。
覆蓋範圍¶
支持 A 股（滬深京）、港股、美股，以及 ETF、指數、可轉債。
三大交互入口¶
- 側邊欄「股票持倉」：位於右側欄「設置」上方，提供概覽、持倉明細、交易管理、分析面板和設置入口。顯示當日盈虧，支持表頭排序。
- 對話中讀寫：通過註冊的 Tool 進行操作。
- 右側欄「持倉提及」：當對話中出現持倉標的的代碼或名稱時，自動展開，顯示走勢與持倉統計。
數據與 Tool¶
插件向會話註冊了七個 Tool，涵蓋讀寫操作：
| Tool | 權限 | 功能 |
|---|---|---|
stock_add_trade |
直接寫入 | 將自然語言轉化爲交易記錄 |
stock_portfolio_overview |
自動讀 | 持倉明細、市值、浮動/已實現/當日盈虧 |
stock_symbol_detail |
自動讀 | 單個標的的本地日線與指標，及持倉歷史 |
stock_analysis |
自動讀 | 按動機或市場的盈虧分佈，標的表現排行 |
stock_portfolio_review |
自動讀 | 組合復盤與未來研究清單 |
stock_search_symbols |
自動讀 | 本地代碼索引檢索（離線） |
stock_list_trades |
需授權 | 單筆交易明細列表 |
安裝與啓用¶
安裝需提供插件的本地絕對路徑。
dsh plugin --profile web add <checkout 的絕對路徑>
典型用法¶
記錄交易¶
在對話中直接輸入，例如“昨天買了 100 騰訊”。若字段缺失，會彈出卡片詢問。系統自動將數據寫入本地 SQLite。
查詢行情¶
直接詢問標的狀況，例如“騰訊最近怎麼樣”。系統會讀取本地 SQLite 回答，無需聯網查詢行情接口。
持倉復盤¶
詢問“我的股票表現怎麼樣”，或直接敲命令 /portfolio-review。系統會基於本地數據計算當下的盈虧、波動等指標，並生成未來一個月的研究清單。
持倉提及¶
對話中出現持倉代碼（如 700 或騰訊控股）時，右側欄自動展開對應的走勢圖與統計卡片。
數據口徑與限制¶
- 數據源：TickFlow。
- 更新頻率：按交易日更新。美股與港股收盤時間不同，面板頂部顯示最新日期。
- 成本計算：移動加權平均，賣出按攤薄成本結轉鎖定已實現盈虧。不含手續費。
- 匯率：基準貨幣默認人民幣，一天取一次。不做匯率的歷史回溯，市值走勢圖使用當前匯率折算。
- 指數代碼：指數類裸代碼有歧義（如
000300），需後綴或搜索。 - 交易明細讀取：每次都需要用戶點一次同意，沒有明確同意則不返回數據。
- 改刪交易：只能在面板裏進行修改或刪除操作，對話中只能新增交易。
開發與調試¶
如需本地開發，可運行以下命令：
- 構建與類型檢查：npm run build、npm run typecheck
- 監聽模式：npm run watch
- 熱重載（無需重啓 DSH）：npm run reload
注意事項¶
- 本插件僅供個人參考，數據來自 TickFlow，不構成任何投資建議，據此操作風險自負。
- DSH 理念爲“一切皆插件”，此插件爲社區維護項目，與 DeepSeek / 幻方無官方從屬關係。
- 安裝前應檢查源碼與許可證（MIT）。
