跳到主要内容

运行 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,而不是尚未同步的镜像。