dsh-web3

English | 中文

面向 DeepSeek Harness (DSH) 的 Agent 安全 EVM 钱包，以 DSH bundle 的形式发布。

概要

让 Agent 帮你查余额、转代币、签 Permit、支付 x402 账单，而私钥永远不会出现在对话里。密钥只加密保存在本机。每一笔操作在签名前都要经过签名策略、硬性限额和安全检查（黑名单、制裁名单、交易模拟），有风险的操作会等你确认。DSH 设置里的 Web3 钱包页面负责账户、备份、PIN、限额和黑名单。

目录

• 使用
• 实现原理
• 模型体验
• 已知限制
• 延伸阅读

使用

环境要求

• DSH 0.2.x（bundle 声明了 @deepseek-ai/dsh-typert-protocol 的 peer 版本范围，DSH 在安装和启动时会检查）
• Node.js 20 或更高
• macOS 上使用钥匙串保存口令（其他平台使用 DSH 凭据存储）

安装

dsh plugin --profile web add dsh-web3

也可以在 DSH Web 侧边栏的插件页面安装 dsh-web3。bundle 自带的 cordis.patch.yml 会以 web3 这一行挂载插件；开启 HMR 时（默认的 web profile）立即生效，否则重启 DSH。

然后打开 设置 → Web3 钱包：创建或导入钱包、备份助记词、设置 PIN。

配置

在 profile 的 cordis.patch.yml 里覆盖 web3 这一行，所有字段都可选：

- id: web3
  config:
    vaultPath: ~/.dsh-web3       # 保险库目录（默认 ~/.dsh-web3）
    autoLockMs: 900000           # 闲置 15 分钟后锁定
    passphrase:
      mode: auto                 # auto | env | manual
    secretStore: auto            # auto（macOS 上用钥匙串）| keychain | none
    chains:
      rpc:                       # 按链覆盖 RPC
        1: https://my-eth-rpc.example
      tokens:                    # 额外显示余额的代币
        8453:
          - address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
            symbol: USDC
    disableTools: false          # true = 只提供服务，不注册 wallet_* 工具
    disableHttp: false
    unsafeAllowModelSecretReveal: false   # 不要开启：密钥会进入对话记录

设置面板

凡是降低保护或涉及密钥的操作——放宽预设或限额、加入白名单、关闭某项安全检查、从黑名单移除地址、查看助记词、导出、删除账户——都需要输入 PIN。收紧设置不需要。

安全模式

硬性限额（稳定币和原生币上限、转账白名单）以及严重级别的安全检查发现，即使你在审批框点了同意也会拒绝。

服务 API（ctx.wallet）

其他插件可以使用和工具相同的流程：

const prepared = await ctx.wallet.prepareTransfer({ account: 'main', chainId: 8453, to: 'alice', amount: '25', token: 'USDC' });
// prepared.summary、prepared.security.findings、prepared.willRequire
const result = await ctx.wallet.executePrepared(prepared.preparedId, approvalGateway, { toolName: 'my-plugin' });

await ctx.wallet.checkAddress({ address: '0x…', chainId: 1 });   // 黑名单、制裁名单、相似地址
await ctx.wallet.signTypedData({ account, domain, types, value }, approvalGateway);
await ctx.wallet.authorizeX402({ account, challenge }, approvalGateway);

实现原理

prepare  解析收款人 / 代币 / 金额 → 填充 nonce、gas、手续费
         → 解码意图 → 预检（会否回滚、余额）→ 策略试算
         → 安全检查 → 决策升级 → 一次性 preparedId（15 分钟有效）
execute  按账户加锁 → 刷新 nonce / 手续费 → 策略 → 安全复查
         → 保险库锁定状态 + 每日 PIN → 人工审批（`ask` 时）→ 签名
         → 写日志 → 广播

模型体验

钱包工具

模型看到什么

30 个 wallet_* 函数工具，主要的有：

结果都带 status、next 提示和结构化的 security.findings；失败统一为 { ok: false, code, message, hint }，错误码稳定。在 DSH 聊天里，每次调用都会显示原生工具卡片，例如 25 USDC → 0x7099…79C8 · Base。

Token 影响

插件加载期间，工具声明会给每次请求增加约 18,000 字符（约 5–6 千 token）。每次调用会追加它的 JSON 结果；带模拟的预览最大，通常 1–3 千 token。

KV Cache 影响

工具声明是静态的，会和其余工具列表一起被缓存。安装、移除或禁用插件会改变工具列表，使缓存前缀失效一次。

内置 skill

模型看到什么

dsh-web3-wallet skill 在会话的 skill 目录里只占一行（约 350 字符，含中英文触发词），把钱包、转账、代币、签名、x402 和钱包策略相关请求路由到 wallet_* 工具，优先于 shell 脚本或其他钱包 skill。加载后得到完整操作手册：意图路由、铁律、标准流程、状态处理，以及如何转达安全检查结果。

Token 影响

目录里的一行始终存在；skill 正文（约 11,000 字符）只在模型加载时才进入上下文。

KV Cache 影响

目录行是静态的。加载后的 skill 正文像普通工具结果一样追加到对话中。

已知限制

• 同用户边界。 以你的系统用户身份运行的任何程序——包括拥有不受限 shell 权限的 Agent——都可以无提示地从登录钥匙串读出保险库口令并解密密钥文件。请把它当作只放小额资产的热钱包，并且不要在使用它的会话里给 Agent 不受限的 shell 权限。
• 策略、限额和安全检查只对经过本插件的签名生效；密钥一旦被盗，这些保护都会被绕过。
• 暂不支持硬件钱包和智能账户（会话密钥）。
• 威胁情报仅限 OFAC、ScamSniffer、制裁预言机和可选的 GoPlus。
• 部分 RPC（例如 Avalanche 官方公共节点）不支持 eth_simulateV1，在这些链上预览会注明没有进行模拟。
• 代码尚未经过外部安全审计。

发现漏洞请按 SECURITY.md 私下报告。

延伸阅读

• dsh-web3-core——本插件依赖的保险库、策略、意图解码、模拟与黑名单库。
• 钱包设计文档——功能地图、威胁模型和变更记录。
• 内置 skill——模型加载的操作手册。
• 更新日志

许可证

MIT