前言¶
在使用 DSH 做智能體或工具集成時，一個常見需求是把分散在不同資產體系裏的數據集中起來：鏈上資產在 BTC、EVM、Solana、Hyperliquid L1 等不同鏈路裏，CEX 資產又分散在各交易所。如果只靠手動打開多個頁面，既不利於覈對總數，也不方便後續調用 API。
dsh-crypto-portfolio 是一個 DSH 插件，目標是把鏈上和 CEX 資產統一到同一個自包含的 Web Dashboard 中，同時保留每日快照、趨勢圖和可調用的 JSON API。
這是什麼¶
dsh-crypto-portfolio 是一個免費、100% 自託管的 DSH 插件，用於統一展示鏈上與 CEX 資產。它提供零依賴的 Web Dashboard，覆蓋 BTC / EVM / Solana / Hyperliquid L1 / CEX 資產。
該倉庫位於 0xRabit/dsh-crypto-portfolio，README 明確說明這是非官方項目，由社區成員獨立開發和維護。許可證爲 MIT。
核心能力¶
資產覆蓋與全局篩選¶
插件覆蓋以下資產類型：
- BTC
- EVM
- Solana
- Hyperliquid L1
- CEX 資產
Dashboard 提供全局篩選能力，包括類別、錢包和鏈篩選。篩選結果會同步影響總覽、錢包占比、趨勢、鏈分佈和代幣表等面板。
數據源標識與失敗切換¶
插件對免費和付費數據源做明確標識。EVM 資產使用 DeBank，並提供兩類來源：
- 付費的
debank-pro - 免費且無需 key 的
debank-public回退來源
插件也提供 API provider 自動失敗切換。某個數據源不可用時，會跳過失敗項，並保留最後可用來源的信息。
快照、趨勢與黑名單¶
插件支持定時每日刷新，並展示各數據源最近成功時間。每日快照會保存在 SQLite 中，並可用於生成趨勢圖。
它還提供一鍵代幣黑名單能力。被加入黑名單的代幣會從總數、趨勢和歷史快照中移除。
多 Profile 與界面語言¶
插件支持多 profile 配置，不同 profile 擁有各自獨立的快照歷史。
界面支持亮色 / 暗色主題，並支持英文 / 中文界面。
JSON API¶
除 Web 頁面外，插件還暴露可直接調用的 JSON API，例如：
GET /api/refresh
GET /api/history
GET /api/tokens
安裝與啓用¶
環境要求：
- Python 3.9+
requestspynacl已打包在vendor/目錄中
下面的命令是 README 中給出的本地路徑安裝示例，不是通用的 registry 安裝命令：
dsh plugin --profile demo add /path/to/dsh-crypto-portfolio
dsh --profile demo
啓用後，Dashboard 默認運行在：
http://127.0.0.1:8080
如果需要自定義端口，可以使用 PORTFOLIO_PORT 覆蓋默認端口。
如果不想通過 DSH 啓動，也可以單獨運行：
python3 run.py --init-template --port 8080
該命令會從公開模板初始化默認 profile，並在指定端口啓動 Dashboard。
默認配置與隱私邊界¶
默認 profile 使用公開模板錢包，例如：
vitalik.eth- genesis BTC
- public SOL
同時，shipped config 中 WALLETS = []，API key 爲空。倉庫不包含私鑰、私錢包或餘額數據。
私有錢包和密鑰應放在 git-ignored 的本地 profile 中。CEX 集成使用只讀 API key，key 命名格式爲：
<exchange>_read
適用場景與注意¶
適合以下場景：
- 你希望自託管一個本地 Dashboard
- 你需要把 BTC、EVM、Solana、Hyperliquid L1 和 CEX 資產放在同一頁面查看
- 你需要每日快照、趨勢圖和 JSON API
- 你接受非官方社區項目，並願意自行檢查源碼
需要注意：
- 這是非官方項目，不是 DeepSeek 或幻方的官方應用商店應用。
- 插件會以當前
dsh進程權限運行。安裝前應檢查源碼、依賴和 MIT 許可證。 - 倉庫本身不含私有密鑰和餘額，但私有配置必須保存在本地 profile 中，避免提交到版本庫。
- CEX API key 應使用只讀權限，並按
<exchange>_read的命名方式配置。
參考鏈接¶
- GitHub：https://github.com/0xRabit/dsh-crypto-portfolio
- DSH 社區目錄：在獨立站點中搜索
dsh-crypto-portfolio；當前資料未提供目錄頁 URL。
