前言¶

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