跳到主要内容

使用网络模型

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 模型。插件会:

  1. 直接拨号 worker,或在无法直接连接时经由 seed relay,
  2. 对付费模型,在第一个 token 之前把十分钟的 USDC 存入该会话的托管,
  3. 在 Ollama 生成 token 时实时流式返回,
  4. 在会话结束时结算并关闭会话,押金没有涵盖的部分会退回。

免费模型(报价 0)完全跳过第 2 与第 4 步:没有会话、没有费用、没有交易。

一次会话的费用​

项目由谁支付
推理你,以 USDC,按已开始分钟
打开的网络手续费你,几分之一美分的 SOL
结算的网络手续费worker
平台费结算金额的 1%,给金库

因此一次付费会话会花掉两笔链上交易,双方各一笔。如果会话在还没有任何已开始分钟 可计费之前就结束,整笔押金都会退回。

计费按已开始分钟:十秒后停止仍然算一分钟,以 worker 的每小时报价除以 60 计算。

支出上限​

钱包是支付前端,不是保险库:agent 本来就应该能在不每次征求你同意的情况下跑完一场会话。 它不能做的,是在没有上限的情况下花钱。面板里的 Budget 卡片就是那个上限,形状参照你 熟悉的 API key 额度。

字段作用默认值
Name 名称出现在拒绝讯息里的标签everyday
Credit limit 额度上限这把 key 在一个周期内最多能花的 USDC10
Reset 重置never、daily(UTC 午夜)、weekly(周一)、monthly(每月 1 日)never
Expires 到期固定日期,之后停止付费会话关闭
Enabled 启用付费会话的开关开启
Per session 单场上限单场会话最多预付的 USDC2
Max price per hour 每小时最高价高于此价的模型不进入选单关闭

离开字段即提交,没有会忘记按的保存键。金额留空表示该字段无上限,不是零。

卡片也会报告已经花掉的钱:总计、今天、本周、本月,按模型分组的表,以及最近 二十场会话与其交易签名。四个时窗由会话日志算出;total 用的是政策自己的终身计数,所以旧 日志被裁掉时它不会往下掉。

被拒的样子​

政策在任何签名之前检查。政策不允许的付费会话会以 HTTP 402 拒绝,JSON 内容写明原因:

code含义
budget_exhausted本期额度不够这笔押金
session_cap单场会话要预付的钱超过单场上限
price_cap模型报价超过每小时上限
policy_disabledEnabled 已关闭
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 的会话,即使 答案被中断,仍会就那两分钟计费——这就是「已开始分钟」的意思。