前言¶
在 DeepSeek Harness（DSH）裏寫插件、跑會話時，GitHub 上的公開資料、倉庫動態和貢獻節奏，往往要單獨開瀏覽器或換工具查看；若還要對照 DeepSeek 平臺的餘額與 API 消耗，又要再開一個標籤頁。把這幾塊信息收進宿主側欄，填一次用戶名就能看公開檔案，需要時再配 token 讀私有倉庫或平臺用量，能減少上下文切換。下面介紹社區插件 dsh-github-profile（維護者 wqx11235，MIT 許可，當前版本 0.1.4）。
這是什麼¶
dsh-github-profile 是一個 DSH 客戶端插件：在側欄增加 GitHub 入口，聚合 GitHub 資料卡、倉庫列表、一年貢獻熱力圖，以及（可選）本地 DSH「幹活」熱力圖和 DeepSeek 平臺用量（餘額、消費、請求、Tokens）。GitHub 部分只讀公開 API，無需配置即可使用；用量部分依賴你在瀏覽器登錄 platform.deepseek.com 後取得的平臺 token。README 寫明：非官方插件，個人維護，與 DeepSeek 官方無關。
核心功能¶
頁面佈局與切換¶
按 README 描述，界面大致分爲：
- 頂部：頭像、暱稱、@賬號、簡介，以及公開倉庫數、總星標、關注者、一年貢獻、連續天數等統計。
- 中間：GitHub 貢獻熱力圖（53 周 × 7 天，GitHub 原生五檔綠色；懸停可看日期）。中間有三段切換 GitHub / DSH / 用量：
- DSH：本地會話存活區間的「幹活」熱力圖（藍色，按天計一次活躍）。
- 用量：DeepSeek 平臺賬戶數據——充值餘額、累計消費、近 30 天消費 / API 請求次數 / Tokens、每日柱狀圖、按 API Key 分組。
- 下方：倉庫卡片（描述、語言、星標、最近推送時間），點擊名稱跳轉 GitHub。
數據來源與緩存¶
| 內容 | 來源 |
|---|---|
| 用戶資料 | api.github.com/users/<login> |
| 倉庫列表 | api.github.com/users/<login>/repos?per_page=100&sort=pushed |
| 貢獻日曆 | 有 token 時用 GraphQL；否則 jogruber 公開 API；再失敗纔回退 github.com/users/<login>/contributions HTML |
宿主側對三塊數據各有 10 分鐘緩存。DeepSeek 用量來自 platform.deepseek.com 網頁登錄態接口，3 分鐘緩存。插件不上傳數據，也不寫 GitHub；可選 gh-token.txt 僅用於提高速率上限和讀取私有倉庫。
讀取穩定性（v0.1.2 起）¶
早期版本只靠 GitHub 貢獻頁 HTML，本機直連 github.com 主站易 TCP 超時，會出現資料與倉庫正常、熱力圖空白的情況。當前實現採用三路降級、分塊容錯：資料、倉庫、熱力圖各自緩存與失敗互不影響；24 小時內會保留上次結果並提示「部分數據沒取到」、支持一鍵重試；token 遇 401/403 會去掉後以匿名重試；單請求 8 秒超時，網絡抖動會重試一次。
DSH 0.2.x 適配（v0.1.3）¶
針對 @deepseek-ai/dsh-desktop 0.2.2-rc.1（hostProtocolVersion 4）覈對過：webServer.register 的 /gh-profile/data 路由、__ModuleLoader__ 與 sidebar.panellist / main 插槽、主題 token --dsw-alias-* 均保持可用；客戶端 inject 收斂爲 []，僅 require('react')。
安裝與啓用¶
需要已安裝 DeepSeek Harness（桌面端或 Web 端）及其插件管理器。
README 給出的安裝方式是克隆倉庫後從本地目錄安裝：
git clone https://github.com/wqx11235/dsh-github-profile.git
在 DSH 中：插件管理 → 從本地目錄安裝，選中克隆後的目錄。安裝後側欄會出現 GitHub 圖標（位於 AstBot 下方）。
若環境可執行 dsh 命令，可用絕對路徑添加插件：
dsh plugin --profile <你的 profile> add /absolute/path/to/dsh-github-profile
插件以當前 DSH 進程權限運行，安裝前建議自行查看倉庫源碼與 MIT 許可證。
典型用法¶
GitHub 公開檔案¶
- 點擊側欄 GitHub。
- 右上角填寫 GitHub 用戶名，點「開始」。
- 用戶名保存在瀏覽器
localStorage，下次自動加載。
公開信息無需額外配置。
可選：私有倉庫¶
將 GitHub Personal Access Token 寫入一行純文本：
~/.dsh/gh-token.txt
僅需 repo 讀權限；插件只讀使用，不做寫操作。也可在插件管理配置中通過 tokenFile 指定路徑（默認即上述路徑）。
插件配置項¶
在插件管理對應行的配置裏可設置：
login: your-github-login # 默認用戶名，留空則每次在頁面上填
tokenFile: ~/.dsh/gh-token.txt # 可選 token 文件（默認就是它）
DeepSeek 平臺用量（v0.1.4）¶
第三段 用量 需要平臺 token（不是 API Key）：
- 瀏覽器登錄 https://platform.deepseek.com 。
- F12 → Network → 任選
/api/v0/...請求。 - 複製請求頭
Authorization中Bearer之後的字符串。 - 存爲一行到
~/.dsh/deepseek-platform-token.txt，或插件目錄下的platform-token.txt。
token 過期時頁面會提示，重新獲取並覆蓋即可。
實現要點（供開發者參考）¶
- 宿主：
index.js註冊同源路由GET /gh-profile/data?login=<user>，聚合三類 GitHub 數據源。 - 客戶端：
client.js通過window.__ModuleLoader__.load註冊到main（keyed）與sidebar.panellist（list，order13）。 - 無構建步驟，純 JavaScript，改代碼後刷新頁面即可。
適用場景與注意¶
適合希望在 DSH 工作區內快速掃一眼 GitHub 公開形象、倉庫列表和貢獻節奏，並可選對照 DeepSeek 平臺消費的開發者。不適合把本插件當作 GitHub 或平臺的官方客戶端：數據口徑、緩存策略與失敗回退以 README 爲準；用量依賴自行保管的平臺 token，請勿將 token 提交到版本庫或共享環境。
社區插件目錄由 SkillHub 等站點維護，與 DeepSeek / 幻方無官方從屬關係；本插件在 GitHub 上星標數爲 1（以目錄頁信息爲準）。
結尾¶
dsh-github-profile 把 GitHub 檔案頁能力與 DeepSeek 用量面板收進 DSH 側欄，公開 GitHub 填用戶名即可，私有倉庫與平臺用量按文檔配置本地 token 文件即可。進一步瞭解可在社區目錄頁查看介紹，在 GitHub 倉庫閱讀完整 README 與版本說明。
- 目錄頁：https://www.skillhub.cn/plugins/wqx11235/dsh-github-profile
- 源碼：https://github.com/wqx11235/dsh-github-profile
