运行 worker
Worker 是一个 DeepSeek Harness 插件,用你设置的价格分享已经安装在这台机器上的模型。它在 本机运行 Ollama;没有云端 API key,也没有按用量计费的推理账单。
需求
- DeepSeek Harness
0.2.2-rc.1或更新版本,以及 Node 22+。 - Ollama,并已拉取至少一个模型(例如
ollama pull qwen3:8b)。 - 一个 Solana 钱包,里面有一点 SOL 付手续费。插件会帮你生成一个。
没有 GenKaKu 代币,也没有质押。你赚的是 USDC;你花的是几分之一美分的 SOL,用来付网络手续费 与租金。
安装
在 DeepSeek Harness 中打开 Plugins → Add plugin,粘贴:
@genkaku/dsh-worker-plugin
把安装源留在 Default registry(registry.npmjs.org),确认,然后重新启动 DeepSeek
Harness。从 shell 做同样的事:
dsh plugin add @genkaku/dsh-worker-plugin@0.5.0-rc.8
预览部署发布的是预发布版,所以上面的命令直接写出版本号 0.5.0-rc.8,而不是 dist-tag:用标签装不到这份构建。
侧边栏会出现一个 GenKaKu worker 项目。
第一次启动
插件会在 http://127.0.0.1:11434 寻找 Ollama;如果它已安装但没在运行,插件会自行启动
ollama serve。面板的第一个区块会显示 Ollama 是否在运行,以及找到几个模型。
当 offer 板是空的,插件会以 defaultPricePerHour 列出每一个本机模型,而它默认是 0。这是
刻意的:所有者还没设置价格的机器,不该被人代为标价。
设置价格
在面板中打开 Models offered,为每个模型设置以 USDC 计的每小时价格,用整数表示、精度为
小数 6 位(所以 250000 就是 0.25 USDC/hour)。留在 0 就是免费提供该模型。
- 付费模型会把 USDC 存入每个会话的托管,并以用户保留、由你签署的收据结算。
- 免费模型提供服务时完全不碰链:没有会话、没有费用、没有交易。
计费按会话的已开始分钟累计,所以两分钟的工作会依每小时费率付两分钟,而不是一整 小时。
你在链上的上架费率是你发布的最贵模型,以每分钟计价。它是上限:对你的每个会话都必须 等于或低于它。如果用户端报的价格低于该模型本身的价格,你的 sidecar 会在生成 token 之前 拒绝该会话,所以没有人能用低价使用昂贵的模型。
名称、可见性与配对
面板中的 Name & access 包含三件事:
- 显示名称 —— 名字、ID 或暱称。使用者会在模型旁看到它,也能用它搜索,并按它排序。 它不会写进链上:链上只会有你的钱包、peer ID 与 locator。
- 公开/私密 —— 预设为公开:worker 会加入目录与 seed,任何人都能拨号。私密会把两者 都移除。链上的数据行仍然存在,因为结算要付款给该账户,但该行不带地址,陌生人没有东西 可以拨号。
- 配对码 —— 进入私密 worker 的唯一方式。按 产生配对码,把
genkaku1.…字串送给你 允许的人。配对码只能使用一次、15 分钟后过期,而且只以杂凑值保存:文件外流也无法泄漏可 用的配对码。
配对绑定的是兑换者的钱包,不是字串。使用者的钱包金钥同时就是它的 libp2p 身分,因此之 后每次连线都由传输层握手本身授权——请求不会携带 token,偷到的配对码换到别的机器也无法使用。 已配对钱包 会列出被允许的对象;解除配对 会立即移除,下一次连线就会被拒绝。
私密不等于免费:照常设置价格,0 仍然代表免费。私密 worker 与公开 worker 一样透过托管收款。
切换可见性会重启 worker 那一半,因为目录记录与 seed 公告是在启动时决定的。
发布到链上(可选)
本节适用于公开 worker;私密 worker 永远不会上架。
Directory 开关会把你的 peer ID、费率与 locator 写入程序,让用户不必事先知道你的地址 就能找到你。
它默认关闭,而且只有当这台机器有全局可拨号的地址时才会打开。一个没有人拨得到的地址, 比没有上架更糟。发布需要一笔交易,而 locator 一旦上链就是永久的——写进去的 hostname 或 IP 无法撤回,只能被替换。
同一个 LAN 上的节点可以不需要目录记录,改在 user 插件中手动输入 multiaddr 来连接。
打开结算时,即使发布是关闭的,插件仍会写入你的 Worker 账户:结算指令会付款给该账户,所以它 必须存在。这样的数据行不带地址,对发现机制不可见,而这正是只在 LAN 内服务的 worker 想要的。
钱包与提取
Wallet 区块会显示:
- worker 地址,
- SOL(手续费)与 USDC(收益)余额,
- unclaimed in escrow — 已经属于你、但仍留在会话托管内的已结算收入,
- 一个 Claim 按钮,把该余额移进钱包。
每个会话分开付款:结算会把金额记入该会话,而在最后一次结算十分钟后,任何人(包括 你)都可以提取。那段延迟就是用户仍能关闭会话的窗口,所以你不会因为他们正要取消的那一 分钟而拿到钱。面板按钮会处理整个队列。
提取是一笔交易,所以钱包需要一点 SOL。USDC 是 worker 赚到的东西,不是它花掉的东西。
私钥以纯文本保存,权限 0600,位于 ~/.dsh/genkaku/genkaku.keys.json。它既是钱包,也是
libp2p 身份:在把机器移到新硬盘之前先备份,并且把任何能读到该文件的人视为钱包的所有者。
轮换它也会改变你的 peer id。
模型等级
市场会依据 Ollama 回报的能力与参数数量,为每个模型标上等级:
| 等级 | 意义 |
|---|---|
agent | 具备 tools 且至少有 9B 参数 — 适合 agent 循环 |
light | 具备 tools,但模型较小或大小未知 — 工具调用可能不可靠 |
chat | 没有 tools 能力 — 不适合 agent |
等级只是标签,永远不是筛选条件。没有东西阻止你上架一个 chat 模型;用户只会看到它无法
驱动 agent。
思考型模型默认以 think: false 运行,这样单一请求不会把预算花在隐藏的推理上。在启动
DeepSeek Harness 之前设置 GENKAKU_OLLAMA_THINK=1,即可保留 Ollama 的默认行为。
端口与网络
- libp2p 默认监听
/ip4/0.0.0.0/tcp/4001与/ip6/::/tcp/4002。如果想要直接连接,请打开 你设置的 TCP 端口。 - 本机状态服务器会绑定 47821–47826 中第一个空闲的端口。同一台机器上的两个 DSH profile 各自需要自己的端口;如果你一直看到「Loading worker status…」,很可能是另一个 profile 占用了这个范围。
- 在 Windows 上,worker 第一次启动时请让 Node 通过防火墙。
故障排查
检测不到 Ollama。 运行一次 ollama serve,或在面板中按 Start Ollama。如果 Ollama 在
别的地方,请修改插件设置中的 ollamaHost。
Directory 开关是灰色的。 这台机器没有全局可拨号的地址。同一个 LAN 的节点仍可通过 multiaddr 连接;否则会话将必须经由 seed relay。
会话已提供服务,但余额没有变动。 结算会把金额记入会话,不是钱包,而付款要等 十分钟。按 Claim;该数字接着会以钱包的 USDC 余额出现。
Claim 说没有可提取的金额。 要么自上次结算以来还没过十分钟,要么会话仍然开着(用户 还没关闭它)。两者都会自行解决;面板按钮会重新读取链上状态。
npm 上什么都没有? 确认你连的是 registry.npmjs.org,而不是尚未同步的镜像。