dsh-aliyun-coupon

DSH PLUGIN会话与消息

仓库 fvvef121-cell/dsh-aliyun-coupon

会话与消息 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

在 DeepSeek Harness 侧栏显示阿里云代金券余额(BSS OpenAPI 只读查询,凭据只留宿主进程)

一句话选型结论

按资料字段整理

dsh-aliyun-coupon 是会话与消息类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类会话与消息 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 1 复刻 0 · 未关闭 issue 0
最近更新 2026-10-28 创建于 2026-10-28
README 7.7 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:fvvef121-cell/dsh-aliyun-coupon#v0.1.1
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

会话与消息
字段来自项目仓库与公开索引,中文说明由本站标注

上游标签

aliyuncoupondeepseek-harnessdshdsh-pluginsidebar

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在会话与消息场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-aliyun-coupon当前 L5 · 运行验证通过 低风险 1 未标注 有
dsh-desktop L3 · 安装规范通过 低风险 3.0 万 未标注 无
openpets L4 · 沙盒安装通过 低风险 1,274 未标注 有
deeptide L4 · 沙盒安装通过 低风险 1,104 0.1.1-rc.2 有
jingyun-dsh L3 · 安装规范通过 低风险 1,004 未标注 有
study-mate 未做沙盒验证 未标注 856 未标注 无

仓库档案

会话与消息
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方fvvef121-cell仓库 dsh-aliyun-coupon · 默认分支 main
分类会话与消息client
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言未标注仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue1 / 0 / 0收录时的数值,非实时
创建 / 更新2026-10-28 · 2026-10-28最后推送 2026-10-28
本站收录2026-10-30首次进入本站目录的时间

README 全文

7.7 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-aliyun-coupon

在 DeepSeek Harness(DSH)Web GUI 的侧栏页脚(sidebar.footer.action,即 dsh-cost-meter 余额/预算图框原来的位置)显示
阿里云卡券(代金券)的剩余余额、已用额度与到期时间。面向云工开物学生专属代金券这类账户券,也适用于任意阿里云代金券/抵用券。

  • 数据源:阿里云官方 BSS OpenAPI 只读接口——首选 DescribeCoupon(2023-09-30,新费用中心「卡券」页同源数据),
    失败或返回空结果时自动回退 QueryCashCoupons(2017-12-14)。
  • 凭据:只读 RAM AccessKey(LTAI…,不是百炼/DashScope 的 sk- Key),只在宿主进程里用于签名。
    浏览器只能拿到:掩码 ID(LTAI5t...IjKl)、余额数字、脱敏券号(1234****9012)、~ 形式的文件路径。
  • 路由:GET /api/dsh-aliyun-coupon/overview、POST /api/dsh-aliyun-coupon/refresh,仅回环地址可访问;
    带 X-Forwarded-For 等代理头的请求、以及跨站请求同样被拒。

> 第一次装? 从零到出数大约 5 分钟。建只读 RAM 用户、写 AK 文件、配置项、常见问题排查,
> 全在 使用说明(docs/usage.zh-CN.md) 里,本文只讲重点。

<!-- 截图:维护者可在 docs/screenshot.png 放一张侧栏图后在此处引用;本文件暂不引用不存在的图片。 -->

它显示什么

位置 内容
标题行 图框标题(默认「阿里云代金券」,可用 label 改)+剩余余额,如 ¥123.46
进度条 已用 / 面值
第二行 面值 ¥500 · 已用 ¥376.54
第三行 到期 2027-12-31 + 刷新提示 / 错误行
悬停 券号、券类型、面值、余额、到期时间;多张券逐条列出
侧栏收起态 只显示金额(¥123.5)

安装

方式一:插件页安装(推荐,桌面端也能用)

DSH 的 desktop profile 由桌面 App 独占,dsh CLI 拒绝改动它,所以桌面端请在 插件 页安装本包
(添加本地目录或 GitHub 源),装好后刷新页面。

方式二:CLI(非 desktop profile)

dsh plugin --profile  add github:fvvef121-cell/dsh-aliyun-coupon

> 新建的 profile 只有 @deepseek-ai/dsh-base,没有 webServer,插件会停在
> pending (waiting for service: webServer)。请先用 dsh --from-default-profile web 建出带 Web 层的 profile。

本地开发

dsh plugin --profile  add link:/path/to/dsh-aliyun-coupon

装完重启/刷新后,侧栏页脚会出现图框;此时尚未配置 AccessKey,图框会显示配置提示。

配置 AccessKey

优先级:环境变量 → AK 文件。任一路径给全 akId + akSecret 即可。

方式一(默认,推荐):写进 ~/.dsh/aliyun-coupon.json

{
&quot;akId&quot;: &quot;LTAI5t...&quot;,
&quot;akSecret&quot;: &quot;...&quot;
}

可选字段:stsToken(STS 临时凭据)、endpoint(国际站填 business.ap-southeast-1.aliyuncs.com)。
兼容别名:aliyunAkId / aliyunAkSecret / AccessKeyId / AccessKeySecret。
记事本保存的 UTF-8 BOM 会被自动削掉;该文件不要进 git,也不要贴进聊天。

方式二:环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID / ALIBABA_CLOUD_ACCESS_KEY_SECRET
(别名 ALIYUN_AK_ID / ALIYUN_AK_SECRET),可选 ALIBABA_CLOUD_SECURITY_TOKEN、ALIYUN_BSS_ENDPOINT。

RAM 权限(最小授权)

建一个 RAM 用户,只挂下面两个只读 Action(自定义策略即可),不要用主账号 AccessKey:

{
&quot;Version&quot;: &quot;1&quot;,
&quot;Statement&quot;: [
{ &quot;Effect&quot;: &quot;Allow&quot;, &quot;Action&quot;: [&quot;bss:DescribeCoupon&quot;, &quot;bss:DescribeCoupons&quot;], &quot;Resource&quot;: [&quot;*&quot;] }
]
}
调用 Action
DescribeCoupon bss:DescribeCoupon
QueryCashCoupons bss:DescribeCoupons

嫌麻烦也可以直接挂系统策略 AliyunBSSReadOnlyAccess(读权限更多,但一样花不了钱、开不了资源)。
若返回 NotApplicable,说明该身份不适用于此接口——那种情况才需要主账号 AccessKey。

可选配置

在 profile 的 cordis.patch.yml 里按 id: aliyun-coupon 覆盖:

- id: aliyun-coupon
config:
refreshMinutes: 10
label: 云工开物券
键 默认 含义
refreshMinutes 10 宿主轮询间隔(1–1440 分钟)
akFile ~/.dsh/aliyun-coupon.json AK 文件路径
endpoint business.aliyuncs.com BSS 端点(国际站换 business.ap-southeast-1.aliyuncs.com)
label 空 图框标题
fullCouponNumbers false 是否把完整券号下发到浏览器(默认脱敏)

数据与接口

  • DescribeCoupon(BssOpenApi 2023-09-30,business.aliyuncs.com,ACS3-HMAC-SHA256 签名):
    返回 Amount(面值)、RemainAmount(余额)、Status、EndTime、Currency、ItemNames。
  • QueryCashCoupons(2017-12-14,RPC 签名 V1.0,HMAC-SHA1):返回 NominalValue、Balance、Status、ExpiryTime。
  • 只把 Status === Available 的券计入总计;一张可用的都没有时退回全量,避免把「已过期」误报成 0。
  • 余额按接口原样保留(阿里云给到小数点后 10 位),界面显示两位小数,悬停可见原值。

交互

  • 卡片每 60 秒(页面可见时)拉一次宿主快照;点击卡片立即触发一次查询(刷新中显示「正在刷新…」)。
  • 查询失败时保留上一次的数值,并在卡片上显示错误行,不会突然变成 0。

隐私与安全

  • AccessKey 只留在宿主进程:仅用于对阿里云端点签名,不写日志、不进响应体。
  • 浏览器只收到最小集:掩码 AK ID(LTAI5t...IjKl)、余额数字、脱敏券号(1234****9012)、~ 形式文件路径。
    需要完整券号时才显式打开 fullCouponNumbers。
  • 端点白名单:只允许 *.aliyuncs.com。配置里的 endpoint 若被改成别的域名,插件直接退回默认端点——
    绝不把 AccessKey ID / 签名 / STS Token 发到陌生地址。
  • 路由三层拦截:非回环地址 403;带 X-Forwarded-For / Forwarded / X-Real-Ip(反向代理、隧道、端口转发)403;
    Sec-Fetch-Site: cross-site 的跨站请求 403。响应带 no-store 与 nosniff,不发 CORS 头。
  • 错误信息脱敏:不回显阿里云返回的 Message(可能含账号、RequestId、余额),只保留错误码与本地提示。
  • 插件只联系你配置的 BSS 端点(默认 business.aliyuncs.com),没有任何遥测。

卸载

在「插件」页停用/移除,或删掉 profile 里的 aliyun-coupon 行后重启 DSH。AK 文件不会被自动删除——要清干净请自行删除 ~/.dsh/aliyun-coupon.json。

开发自检

npm test        # 等价于 node tools/selfcheck.mjs:签名串、解析、汇总、掩码,不联网

致谢

  • @fvvef121-cell —— 需求提出、概念把关,以及在真实账号上做验收:余额与阿里云控制台逐位核对、指出接口口径(券余额 ≠ 账户可用金),并推动修复了初版的隐私与安全问题。
  • DeepSeek Harness 中的 AI 结对(DeepSeek V4.1 Flash) —— 初版实现:宿主/客户端两半代码、BSS 接口选型(DescribeCoupon 优先 + QueryCashCoupons 回退)与 ACS3/RPC 签名、离线自检、文档。

> 所有提交均由仓库所有者审阅后发布。AI 不持有任何凭据,也无法访问维护者的阿里云账号;本插件读取的 AccessKey 只由使用者自己写入本机文件。

许可

MIT,见 LICENSE。

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
dsh-aliyun-coupon 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:fvvef121-cell/dsh-aliyun-coupon#v0.1.1` 即可。

dsh-aliyun-coupon 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-aliyun-coupon 安全吗?

低风险。

dsh-aliyun-coupon 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-aliyun-coupon 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

1 条
不同作者的仓库分开列,请确认你要装的是哪一个
会话与消息
按星标排序,可作替代方案

dsh-desktop

dsh-desktop

为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」,桌面本身也是「插件」。

L3 · 安装规范通过 3.0 万 星

openpets

openpets

L4 · 沙盒安装通过 1,274 星

deeptide

deeptide

L4 · 沙盒安装通过 1,104 星

jingyun-dsh

jingyun-dsh

井云 DSH 客户端插件,为 DeepSeek Harness 注入会员登录、订阅支付、算力管控与应用市场,让智能体和技能快速变成可交易商品

L3 · 安装规范通过 1,004 星

study-mate

study-mate

StudyMate 是 DSH 的「学习模式」预设与技能包,为数学、计算机科目定制学习路线、讲解课件与练习评估,跨科目共享记忆。

未标注验证等级 856 星

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 —。