前言¶
DeepSeek Harness(DSH)采用插件化架构,让用户可以根据需要扩展功能。对于需要对接第三方服务的智能体开发者,手动维护 API 调用逻辑会增加维护成本。下面介绍一个用于获取爱发电(Afdian)数据,并提供图形化配置界面的 DSH 插件。
插件定位¶
dtyg123/dsh-afdian 是一个为 DeepSeek Harness 提供爱发电数据查询能力的插件。它通过 GUI 界面帮助用户管理 API 凭证,并支持查询订单列表和赞助者列表。插件以 Node.js >= 22.19 运行,依赖 DSH 环境。
核心功能¶
插件提供以下功能:
- GUI 设置界面:通过 DSH 设置 → 插件 → dsh-afdian 打开配置页面
- 查询订单列表:获取订单的金额、赞助者、状态、时间等信息
- 查询赞助者列表:查看赞助方案、累计金额、本月月数等数据
- API 连接测试:验证签名是否有效,确保 API 配置正确
安装与启用¶
方式一:从 npm 安装(推荐)¶
在 DSH 配置目录安装:
npm install -g dsh-afdian
方式二:从 GitHub 安装¶
克隆到 DSH 插件目录:
git clone https://github.com/dtyg123/dsh-afdian.git ~/.dsh/profiles/web-desktop/node_modules/dsh-afdian
方式三:手动安装¶
- 下载插件 ZIP 文件
- 解压到
~/.dsh/profiles/web-desktop/node_modules/dsh-afdian - 在
~/.dsh/profiles/web-desktop/cordis.patch.yml中添加:
- insert:
- id: dsh-afdian
name: 'dsh-afdian'
- 重启 DSH
配置使用¶
获取凭证¶
- 打开 https://ifdian.net/dashboard/dev
- 获取 API Token 和 User ID
图形化界面配置¶
- 打开 DSH 设置,切换到「模型」标签页
- 在页面底部的「🍉 爱发电 API 配置」卡片中填写:
- API Token: 从爱发电开发者后台获取
- User ID: 您的爱发电用户 ID(32 位十六进制) - 点击「测试连接」验证签名是否有效
- 点击「查询订单」或「查询赞助」查看数据
命令行配置¶
通过 DSH HTTP API 配置:
curl -X PATCH http://127.0.0.1:64117/plugins/dsh-afdian/config -H "Content-Type: application/json" -d '{"token": "YOUR_TOKEN", "userId": "YOUR_USER_ID"}'
API 端点¶
| 端点 | 方法 | 说明 |
|---|---|---|
/plugins/dsh-afdian/config |
GET/PATCH | 读取/保存配置 |
/plugins/dsh-afdian/test |
POST | 测试 API 连接 |
/plugins/dsh-afdian/query?type=order |
GET | 查询订单列表 |
/plugins/dsh-afdian/query?type=sponsor |
GET | 查询赞助者列表 |
/afdian-settings |
GET | 独立设置页面 |
查询参数¶
查询订单¶
GET /plugins/dsh-afdian/query?type=order&page=1&perPage=10
查询赞助¶
GET /plugins/dsh-afdian/query?type=sponsor&page=1&perPage=10
安全说明¶
- Token 存储在
~/.dsh/afdian-config.json - 建议不要在公共仓库中提交配置文件
- 配置文件已加入
.gitignore
适用场景与注意¶
该插件适合需要查询爱发电赞助数据、统计赞助者信息的 DSH 用户。使用前应检查插件源码与许可证,确认符合使用要求。插件以当前 dsh 进程权限运行,请确保对目标数据有访问权限。
总结¶
dtyg123/dsh-afdian 为 DeepSeek Harness 提供了爱发电数据查询能力,通过 GUI 界面简化了配置流程,适合需要对接爱发电 API 的智能体开发者。更多细节可参考 GitHub 仓库。