使用网络模型
User 插件把 GenKaKu 网络加进 DeepSeek Harness 作为模型供应商。在 agent 会话里,你挑 选某个节点的模型,方式就跟挑选本机模型一样。没有账号、没有 email,也没有 API key。
需求
- DeepSeek Harness
0.2.2-rc.1或更新版本,以及 Node 22+。 - 一个 Solana 钱包。插件会生成一个,你也可以导入现有的钱包。
- 一点 SOL 付网络手续费,以及用来支付算力的 USDC。
- USDC:mainnet 上是 Circle 的 SPL USDC,devnet 上是测试代币。
安装
在 DeepSeek Harness 中打开 Plugins → Add plugin,粘贴:
@genkaku/dsh-user-plugin
把安装源留在 Default registry(registry.npmjs.org),确认,然后重新启动 DeepSeek
Harness。从 shell:
dsh plugin add @genkaku/dsh-user-plugin@0.5.0-rc.8
预览部署发布的是预发布版,所以上面的命令直接写出版本号 0.5.0-rc.8,而不是 dist-tag:用标签装不到这份构建。
Worker 与 user 插件可以装在同一台机器上。各自保有自己的钱包与设置。
钱包
面板的钱包区块会在第一次使用时生成一组 ed25519 密钥对,或导入现有的密钥:可以是 base58
(Phantom 与 solana-keygen 显示给你看的格式),也可以是 solana-keygen 写入文件的 JSON
字节数组。它会显示:
- 地址,
- SOL(手续费),
- USDC(可用余额)。
私钥以纯文本保存,权限 0600,位于 ~/.dsh/genkaku/genkaku.keys.json。我们从不持有它,
也无法为你找回。
在 devnet 上,面板可以铸造测试 USDC,它没有价值。在 mainnet 上没有铸造按钮:你就在平常购买 USDC 的地方购买。
寻找 worker
面板会列出网络提供什么:
- Models on the network — 每一列是一个 worker+模型,显示 worker 的显示名称、每小时 报价、等级与测量到的延迟。
- Workers discovered — 通过链上目录与 seed relay 找到的节点。这个数字是发现机制当下能 看到的内容,不是全局总数。
列表有搜寻框(模型、worker 名称或钱包)与排序选单:推荐、价格最低、延迟最低、完成 场次最多、模型名称、worker 名称。排序与聊天模型选单共用,所以前十列就是新安装时提供的十个。
勾选模型才会让它出现在聊天模型选单。单位是 worker 与 模型,因此两个 worker 提供的同一
模型是两个可勾选列,最多只能勾选十个。勾选代表指定的那个 worker:选单显示
worker · model 正是这个原因。worker 消失时 bridge 会先不显示该勾选,等它回来再恢复。
等级标签(agent / light / chat)来自 worker 的 Ollama 能力。只有 agent 模型适合驱动
会调用工具的 agent 循环;chat 模型会被标为不适合 agent,但没有东西阻止你把它用在单纯
的对话上。
如果你知道某个 worker 的 multiaddr,可以在 Manual workers 下面加入它;这在同一个 LAN 上 就能运作,也不需要目录记录。
私密 worker
私密 worker 刻意不出现在目录与 seed。它的拥有者会给你一组一次性配对码
(genkaku1.…)。贴到 Private workers 并按 配对:配对码只会兑换一次并绑定到你的钱包,
之后别人无法再使用。该列会显示对方是线上(绿点)、离线,或仍在检查中。
配对后的 worker 就是列表里的普通列——一样的勾选、价格与会话。忘记 只会在本机移除;worker 那一端的已配对钱包清单由拥有者管理。
运行会话
在 DeepSeek Harness 会话中,打开模型选择器并选择一个 GenKaKu 模型。插件会:
- 直接拨号 worker,或在无法直接连接时经由 seed relay,
- 对付费模型,在第一个 token 之前把十分钟的 USDC 存入该会话的托管,
- 在 Ollama 生成 token 时实时流式返回,
- 在会话结束时结算并关闭会话,押金没有涵盖的部分会退回。
免费模型(报价 0)完全跳过第 2 与第 4 步:没有会话、没有费用、没有交易。
一次会话的费用
| 项目 | 由谁支付 |
|---|---|
| 推理 | 你,以 USDC,按已开始分钟 |
| 打开的网络手续费 | 你,几分之一美分的 SOL |
| 结算的网络手续费 | worker |
| 平台费 | 结算金额的 1%,给金库 |
因此一次付费会话会花掉两笔链上交易,双方各一笔。如果会话在还没有任何已开始分钟 可计费之前就结束,整笔押金都会退回。
计费按已开始分钟:十秒后停止仍然算一分钟,以 worker 的每小时报价除以 60 计算。
支出上限
钱包是支付前端,不是保险库:agent 本来就应该能在不每次征求你同意的情况下跑完一场会话。 它不能做的,是在没有上限的情况下花钱。面板里的 Budget 卡片就是那个上限,形状参照你 熟悉的 API key 额度。
| 字段 | 作用 | 默认值 |
|---|---|---|
| Name 名称 | 出现在拒绝讯息里的标签 | everyday |
| Credit limit 额度上限 | 这把 key 在一个周期内最多能花的 USDC | 10 |
| Reset 重置 | never、daily(UTC 午夜)、weekly(周一)、monthly(每月 1 日) | never |
| Expires 到期 | 固定日期,之后停止付费会话 | 关闭 |
| Enabled 启用 | 付费会话的开关 | 开启 |
| Per session 单场上限 | 单场会话最多预付的 USDC | 2 |
| Max price per hour 每小时最高价 | 高于此价的模型不进入选单 | 关闭 |
离开字段即提交,没有会忘记按的保存键。金额留空表示该字段无上限,不是零。
卡片也会报告已经花掉的钱:总计、今天、本周、本月,按模型分组的表,以及最近
二十场会话与其交易签名。四个时窗由会话日志算出;total 用的是政策自己的终身计数,所以旧
日志被裁掉时它不会往下掉。
被拒的样子
政策在任何签名之前检查。政策不允许的付费会话会以 HTTP 402 拒绝,JSON 内容写明原因:
code | 含义 |
|---|---|
budget_exhausted | 本期额度不够这笔押金 |
session_cap | 单场会话要预付的钱超过单场上限 |
price_cap | 模型报价超过每小时上限 |
policy_disabled | Enabled 已关闭 |
policy_expired | 已过到期日 |
被拒的会话在链上不留痕迹——没有押金、没有手续费、没有交易——钱包的签名数也不会增加。 高于价格上限的模型会直接从选单里滤掉,你不会挑到付不起的模型。
免费模型(报价 0)不受预算限制,Enabled 也只挡付费会话:关掉开关之后免费模型照常可用。
它放在哪里
政策是一个本机文件 ~/.dsh/genkaku/policy.json,权限 0600,与消费日志 spend.jsonl 放在
一起。它不是链上账户,worker 也看不到:是你的软件自己拒绝组出交易。手动改过的文件无法
注入负数上限、未知周期或伪造的保留项——解析器会退回文件里写明的默认值。
两条记账规则值得知道:
- 开一场会话会立刻保留押金,所以它在会话进行期间就占着预算;结算时提交 worker 实际计费的 金额,并把剩下的释放掉;
- 超过 30 分钟仍未关闭的保留项视为已花。开启与结算之间若进程崩掉,用量可能被多算,但 唯一有害的那个猜测——假设押金已经退回——永远不会做。
Delete policy 删除政策会移除 policy.json 并回到上面的默认值,不会动钱包或里面的钱。
想停止花钱又不想丢掉设置,请改用 Enabled。
设置
- Payments — 打开结算时,每次付费会话都会打开真正的托管。免费/开发用的会话 可以关掉它,这样链上什么都不签;在对真实 worker 使用网络之前,记得把它开回来。
- Manual workers — 手动固定一个 worker 的 multiaddr。
- Refresh — 重新读取链上目录与 seed。扫描完成时 bridge 会重新启动,而变更过钱包的 profile 也需要重新启动才能进行交易。
本机 bridge 会绑定 47821–47826 中第一个空闲的端口,而且只有在它是 user 那一半时才会 响应;同一台机器上的 worker 状态服务器不会被误认。
常见问题
我需要信任 GenKaKu Labs 吗?
你需要信任程序与代码。没有服务器持有你的资金或提示词。
没有钱包可以用吗?
只有在关闭结算的情况下使用免费模型才行。付费会话与身份就是钱包。
这是 mainnet 吗?
是:生产环境在 Solana mainnet-beta 上结算 Circle 的 USDC。面板会显示这个构建位于哪个集群。
预发布环境的构建会在 devnet 上结算没有价值的测试代币——在存入任何资金之前先确认。
谁看得到我的提示词?
提供服务的 worker,永远如此。如果会话经由 seed relay,relay 运营者会看到连接元数据
——地址、时间与流量——但看不到加密的内容。
为什么我的模型从选择器消失了?
Adapter 会探测本机 bridge 的端口,只接受回报 user 角色的 bridge。被另一个 profile 占用
的过期端口会被忽略;它会在下次刷新时回来。
我为一个失败的会话被收了费。
只有当 worker 签署时才会结算,而且它只能就用户收据涵盖的分钟计费。如果答案一直没有送达,
用户端会关闭会话,押金也会退回。一个已经产出两个已开始分钟 token 的会话,即使
答案被中断,仍会就那两分钟计费——这就是「已开始分钟」的意思。