# dsh-tip-jar 中文文档

规范地址：https://npmcn.com/package/dsh-tip-jar/

版本：0\.2\.7
npm 元数据更新时间：2026-11-03T12:35:22.283Z
中文译文更新时间：2026-11-03T13:02:23.353Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/dsh-tip-jar
原文对照：https://npmcn.com/package/dsh-tip-jar/?lang=original
项目主页：https://github.com/imtokenxinluo/dsh-tip-jar#readme
源码仓库：https://github.com/imtokenxinluo/dsh-tip-jar

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3 MB，36 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：2 个
- peer 依赖：@deepseek-ai/cordis ^4\.0\.1，@deepseek-ai/dsh-typert-protocol ^0\.1\.0-rc\.6 \|\| ^0\.2\.0-rc\.2
- 首次发布：2026-08-30T08:24:49.446Z
- 最新版本发布：2026-11-03T12:35:21.895Z
- 已发布版本数：14（近 12 个月 14 个）

## 中文简介

DeepSeek Harness的提示罐：贡献者在sponsors.json中声明了USDC / fiat / subscription / sponsor渠道；一个以赞助商为中心的面板，设置页面和工具卡积分让他们只需点击一下。打赏罐——开源贡献者的赞助入口。

## 安装

```sh
npm install dsh-tip-jar
```

也可以使用：`pnpm add dsh-tip-jar`、`yarn add dsh-tip-jar`、`bun add dsh-tip-jar`

## README

# dsh-tip-jar 🫙

> 🗣 **遇到问题或有建议？** [提 Issue 告诉我](https://github.com/imtokenxinluo/dsh-tip-jar/issues)（附：DSH 版本 + 复现步骤 + 控制台报错，能贴截图更好）。每一条反馈都会回复。

**打赏罐** — DeepSeek Harness 的贡献者支持系统。开源插件的贡献者只需在 `sponsors.json` 声明支持渠道（USDC / 法币平台 / 订阅 / 甲方赞助位），用户就能在 多个入口一键触达。纯 P2P，零经手，隐私默认（伪匿名 + 未验证标记）。

A tip jar for DeepSeek Harness: contributors declare their support channels once; users tip from a sponsor-center panel, a settings page, or tool-card credits.

## 30 秒上手

```bash
dsh plugin --profile <你的 profile> add dsh-tip-jar
```

装完你会看到：

-   **设置 → 支持贡献者**：贡献者登记的全部打赏入口 —— USDC 二维码、微信/支付宝收款码、法币链接、订阅
-   任何嵌入了 `TipJarEmbed` 的插件（例如 `dsh-stock-picks`）里，多出一条「支持作者」条
-   USDC 地址一键复制；**二维码在本机生成**，收款地址不经过任何第三方服务

**适合**：想给插件作者打赏的用户、想收打赏的插件作者。 **不适合**：需要托管资金、自动分账或 KYC 的场景 —— 本插件全程不碰钱。

校验自己的注册表：`npx dsh-tip-jar-validate sponsors.json`

## 功能

-   **赞助中心**：会话视图「支持」Tab + 设置页「支持贡献者」页
-   **USDC (Polygon)**：收款二维码 + 复制地址（格式校验 `0x`+40hex）
    -   二维码由**宿主本地生成**（`src/qr.js`，懒加载 `qrcode` + 缓存）——不请求任何第三方 CDN： 收款地址不会交给外部服务，出码也不受他人服务可用性影响；生成失败时降级为"仅地址 + 复制按钮"
-   **法币 / 订阅**：爱发电、GitHub Sponsors、Patreon 等链接
-   **甲方赞助位**：`Sponsored by …` 静态展示（作者直接与甲方洽谈）

### 三种支持渠道的区别（别混淆）

| 渠道 | 性质 | 钱进谁的口袋 | tip-jar 做什么 |
| --- | --- | --- | --- |
| **打赏**（USDC / 平台收款码） | 自愿、无条件、无回报 | 贡献者（链上直连 / 平台直付） | 展示地址与二维码；链上到账**只读**统计用于致谢墙 |
| **订阅**（Patreon / 爱发电 / GitHub Sponsors） | **商业行为**：明码标价的额外交付 | 贡献者（**由平台代收并抽成**） | 只展示跳转链接，**不参与交易** |
| **甲方赞助位** | 商业赞助（作者与甲方直接洽谈） | 贡献者 | 静态展示 `Sponsored by …` |

> **技术边界（重要）**：本插件**不代收任何款项、不处理支付、不存储任何支付凭据**。 对订阅与法币通道它只做**入口展示**（一个链接），交易全部发生在对应平台； USDC 为链上直连，本插件只**读取**公开转账记录用于致谢墙，**不持有私钥、不发起交易**。 订阅与打赏的伦理边界见 `ETHICS.md`（原则二：订阅必须明码标价；原则五：零中间商优先）。

-   **隐私默认**：化名即可，未验证徽章，不强制真实身份
-   **降级安全**：注册表缺失/损坏/地址非法 → 空态或错误提示，不崩溃
-   **链上到账雷达**（0.1.5）：监听 Polygon USDC `Transfer` 事件（公共 RPC、60s 轮询、1 区块确认、自安装起算），实时统计每位贡献者的到账金额/笔数/去重支持人数，展示致谢墙
-   **伦理徽章**（0.1.5）：🟢 自愿打赏 / ⚪ 未确认 / 🔴 付费墙 —— 由注册表 `ethics` 声明驱动，校验强制（自愿+无付费墙是收录前提）
-   **upstream 来源声明**（0.1.6）：插件条目可声明 `upstream` 项目（署名权守门：抄代码无罪，冒名才防，规范 §5.4）
-   **嵌入组件**（0.1.6）：`TipJarEmbed` —— 其他插件一行接入打赏入口（详见 `EMBED.md`）
-   **收款码**（0.2.0）：微信/支付宝等平台直付收款码（`tips.qrCodes`，可选渠道）

## 演示

![打赏罐「支持贡献者」页面](https://npmcn.com/package/dsh-tip-jar/assets/demo-sponsor-center.png)

_打赏罐页面：贡献者卡片展示 USDC 链上二维码 + 复制 + 微信/支付宝收款码_

![荐股插件嵌入打赏条](https://npmcn.com/package/dsh-tip-jar/assets/demo-picks-embed.png)

_TipJarEmbed 嵌入：其他插件（如每日荐股）在自己 UI 里一行接入打赏_

## 快速开始（30 秒接入）

开源贡献者拿起来就能用：

```bash
# 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 出现你的打赏入口
```

> 📖 完整的分步指南（字段说明 / 验证 / FAQ）见 **[QUICKSTART.md](https://npmcn.com/package/dsh-tip-jar/QUICKSTART.md)**。

## 安装（常驻）

```bash
# 本地构建
npm install && npm run build

# 加入 profile（二选一）
dsh plugin --profile <name> add dsh-tip-jar
# 或将 "dsh-tip-jar" 加入 profile 的 dsh.profile.bundles（自动应用 cordis.patch.yml）
```

重启 Harness 后，所有会话都会加载赞助中心；页面刷新不丢失。

## 注册表 `sponsors.json`（工作区根目录）

```jsonc
{
  "schemaVersion": 1,
  "privacyNote": "贡献者可仅使用化名；未经认证前标记为未验证。",
  "contributors": [{
    "id": "ghost-trader",           // 必填，去重
    "alias": "ghost_trader",        // 必填，化名
    "verified": false,              // 必填；false → 未验证徽章
    "bio": "一句话介绍",
    "ethics": {                     // 0.1.5 起校验强制
      "voluntary": true,            // 自愿打赏（禁止付费墙）
      "paidWall": false             // true → 🔴 付费墙，不予收录
    },
    "tips": {
      "usdc": "0x…(40位hex)",       // 可选，格式校验
      "fiat": [{ "label": "爱发电", "url": "https://…" }],
      "qrCodes": [{ "label": "微信", "image": "…" }]  // 可选：平台直付收款码
    },
    "subscriptions": [{ "label": "Patreon", "url": "https://…" }]  // 放 tips 内也等价（两处合并、按 url 去重）
  }],
  "plugins": [{
    "pluginId": "dsh-tip-jar",
    "name": "打赏罐",
    "contributorId": "ghost-trader",  // 引用 contributors.id
    "upstream": {                     // 0.1.6：来源声明（防抄袭 L2）
      "repo": "https://github.com/…", // 上游仓库 URL（必填）
      "author": "上游作者名",          // 必填
      "license": "MIT"                // 可选
    },
    "sponsors": [{ "name": "甲方", "message": "标语", "url": "https://…" }]
  }]
}
```

完整规范见 `dsh-sponsors/PROJECT.md` 与 `dsh-sponsors/manifest-spec.md`（同仓库目录）。

## 开发

```bash
npm test    # 注册表/链上/争议/服务四套测试（红绿）
npm run build  # esbuild：host / remote / client(__ModuleLoader__)
```

## ☕ 支持作者

如果打赏罐帮你省了事，欢迎请作者喝杯咖啡 —— 完全自愿，先谢谢啦 🙏

| 链 | 地址 | 二维码 |
| --- | --- | --- |
| **Ethereum / EVM** | `0xcea407b16bc7ddd308d74330bdc271d490835123` | ![ETH](https://npmcn.com/package/dsh-tip-jar/assets/eth.png) |

> 直接转账即可（链上到账、零中间商）。打赏罐作者不通过插件页面收打赏 —— 插件页面只服务第三方贡献者；这是作者的个人支持入口。

## License

MIT

## 常见问题

### dsh-tip-jar 是什么？

DeepSeek Harness的提示罐：贡献者在sponsors\.json中声明了USDC / fiat / subscription / sponsor渠道；一个以赞助商为中心的面板，设置页面和工具卡积分让他们只需点击一下。打赏罐——开源贡献者的赞助入口。

### 如何安装 dsh-tip-jar？

在项目目录运行 npm install dsh-tip-jar，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（^4\.0\.1）、@deepseek-ai/dsh-typert-protocol（^0\.1\.0-rc\.6 \|\| ^0\.2\.0-rc\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 dsh-tip-jar-validate，可以用 npx dsh-tip-jar-validate 直接运行。

### dsh-tip-jar 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/dsh-tip-jar 是否存在。

### dsh-tip-jar 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### dsh-tip-jar 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### dsh-tip-jar 可以商用吗？

dsh-tip-jar 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### dsh-tip-jar 还在维护吗？

最新版本 0\.2\.7 发布于 2026/11/03（今天）；至今共发布 14 个版本，其中过去 12 个月发布了 14 个；首次发布于 2026/08/30。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。