前言¶

DeepSeek Harness（DSH）把能力拆成插件，會話界面、設置頁、工具卡片都可以掛擴展。若你在維護開源插件或 fork 後的衍生項目，常見做法是單獨貼 Patreon、愛發電或鏈上地址——用戶要在 README、Issue、會話外來回找，你也很難在 Harness 內統一展示「誰可以支持、從哪支持」。

dsh-tip-jar（打賞罐）把支持渠道收進工作區根目錄的 sponsors.json，由插件在贊助中心、設置頁等入口渲染；資金走鏈上或第三方平臺，插件不代收、不持私鑰。下面介紹它的定位、能力與接入步驟。

這是什麼¶

dsh-tip-jar 是 DeepSeek Harness 的客戶端類插件，維護者爲 imtokenxinluo。貢獻者在 sponsors.json 裏一次性聲明 USDC（Polygon）、法幣平臺鏈接、訂閱鏈接、可選收款碼與甲方贊助位；用戶在會話視圖「支持」Tab、設置頁「支持貢獻者」等位置一鍵觸達。設計強調純 P2P、隱私默認（化名 + 未驗證標記），當前 npm 包版本爲 0.2.6，許可證 MIT。

核心功能¶

贊助中心與入口¶

• 會話視圖提供「支持」Tab；設置頁提供「支持貢獻者」頁。
• 工具卡片 credits 等入口也可觸達同一套註冊表數據。

三種支持渠道（勿混淆）¶

技術邊界：插件不代收款項、不處理支付、不存儲支付憑據；USDC 爲鏈上直連，插件只讀取公開轉賬記錄做致謝牆統計，不發起交易。倫理與訂閱邊界見倉庫內 ETHICS.md。

USDC（Polygon）與本地二維碼¶

• 收款地址格式校驗爲 0x 加 40 位十六進制。
• 二維碼由宿主本地生成（src/qr.js，懶加載 qrcode 並緩存），不請求第三方 CDN；生成失敗時降級爲「僅地址 + 複製按鈕」。

法幣、訂閱與收款碼¶

• 法幣 / 訂閱：通過 tips.fiat、subscriptions 等字段展示外鏈（兩處按 url 去重合並）。
• 0.2.0 起支持微信 / 支付寶等平臺直付收款碼（tips.qrCodes，可選）。

鏈上到賬雷達與倫理徽章（0.1.5 起）¶

• 監聽 Polygon USDC 的 Transfer 事件（公共 RPC、60s 輪詢、1 區塊確認、自安裝起算），統計每位貢獻者到賬金額、筆數、去重支持人數，用於致謝牆。
• 註冊表 ethics 驅動徽章：自願打賞 / 未確認 / 付費牆；校驗強制，voluntary: true 且 paidWall: false 爲收錄前提。

upstream 與嵌入（0.1.6 起）¶

• 插件條目可聲明 upstream（上游倉庫、作者等），規範見倉庫說明。
• TipJarEmbed 供其他插件一行接入打賞入口，細節見 EMBED.md。

健壯性¶

註冊表缺失、損壞或地址非法時顯示空態或錯誤提示，不拖垮 Harness。

安裝與啓用¶

插件以當前 DSH 進程權限運行；安裝前請自行查看 GitHub 源碼 與 MIT 許可證。需要 Node >= 20（見 package.json 的 engines）。

常駐安裝示例：

dsh plugin --profile <name> add dsh-tip-jar

也可將 "dsh-tip-jar" 加入 profile 的 dsh.profile.bundles（自動應用 cordis.patch.yml）。重啓 Harness 後，各會話加載贊助中心；頁面刷新不丟失。

若從源碼開發，在插件目錄執行 npm install && npm run build 後再按上述方式加入 profile。

典型用法：30 秒接入貢獻者入口¶

開源貢獻者在工作區根目錄維護 sponsors.json（可從包內示例複製後修改）：

# 1. 安裝
dsh plugin --profile <name> add dsh-tip-jar
# 2. 複製示例註冊表，改成你自己的
copy node_modules/dsh-tip-jar/sponsors.example.json sponsors.json
# 3. 編輯 sponsors.json：填 USDC 地址 / 打賞平臺鏈接等
# 4. 重啓 Harness → 會話「支持」Tab 出現打賞入口

copy 爲 README 原文寫法；在 Linux/macOS 上可用 cp node_modules/dsh-tip-jar/sponsors.example.json sponsors.json 達到同樣效果。

註冊表核心結構（字段說明與完整規範見倉庫 QUICKSTART.md、dsh-sponsors/manifest-spec.md）：

{
  "schemaVersion": 1,
  "privacyNote": "貢獻者可僅使用化名；未經認證前標記爲未驗證。",
  "contributors": [{
    "id": "ghost-trader",
    "alias": "ghost_trader",
    "verified": false,
    "bio": "一句話介紹",
    "ethics": {
      "voluntary": true,
      "paidWall": false
    },
    "tips": {
      "usdc": "0x…(40位hex)",
      "fiat": [{ "label": "愛發電", "url": "https://…" }],
      "qrCodes": [{ "label": "微信", "image": "…" }]
    },
    "subscriptions": [{ "label": "Patreon", "url": "https://…" }]
  }],
  "plugins": [{
    "pluginId": "dsh-tip-jar",
    "name": "打賞罐",
    "contributorId": "ghost-trader",
    "upstream": {
      "repo": "https://github.com/…",
      "author": "上游作者名",
      "license": "MIT"
    },
    "sponsors": [{ "name": "甲方", "message": "標語", "url": "https://…" }]
  }]
}

校驗註冊表可在插件包內使用：

npm run validate
# 或 bin：dsh-tip-jar-validate

其他插件若需嵌入打賞條，按 EMBED.md 引用 ./embed 導出。

適用場景與注意¶

適合誰

• 在 DSH 生態發佈插件或工具，希望用戶在 Harness 內而非僅在外部 README 找到支持方式。
• 需要同時展示鏈上 USDC、國內法幣收款碼與 Patreon / 愛發電等訂閱鏈接，並區分「自願打賞」與「訂閱商業交付」。
• 希望在致謝牆展示 Polygon USDC 公開到賬統計（只讀、不經過插件錢包）。

注意

• 社區目錄 SkillHub 插件頁 與 DeepSeek / 幻方無官方從屬關係，屬社區收錄，不是官方應用商店。
• 插件不驗證收款地址歸屬；verified: false 時界面標記爲未驗證，用戶需自行判斷鏈接與地址。
• 鏈上雷達依賴公共 RPC 與輪詢策略，統計範圍自插件安裝後起算，不等同於全歷史鏈上審計。

結尾¶

經過上面的步驟，你可以用一份 sponsors.json 在 DSH 內統一暴露貢獻者支持渠道，並保持資金路徑在鏈上或原有平臺完成。dsh-tip-jar 當前在 GitHub 星標爲 0，文檔與示例較完整，適合作爲「客戶端展示層」接入。

• 目錄頁：https://www.skillhub.cn/plugins/imtokenxinluo/dsh-tip-jar
• 倉庫：https://github.com/imtokenxinluo/dsh-tip-jar