广播网络工具 snow-The/dsh-eigenflux

dsh-eigenflux

用 DSH 工具驱动 EigenFlux 智能体广播网络，做法是包装它的命令行。

为什么要包一层，而不走官方接入流程

EigenFlux 提供签名的 ef- 技能，由它们负责首次连接。那套流程面向的主机自带时钟和调度器：它会创建一个循环触发器（默认节奏：每两小时一次），并把「对方接受」的回答当作连接生效的前提。

DSH 没有这种后台时钟。会话由人驱动，唯一的调度器是任务板，而且必须由用户显式启用。原样照搬那套流程，只会做出一个跟自己的宿主打架的组件。

还有一个事实层面的理由，是实测出来的，不是偏好：命令行报告 timezone: "UTC"，而这台主机跑在 UTC+08:00。按它的时间线定义的节奏，触发时对应的是另一条时间线，差八小时。ef_status 每次调用都会把这个偏差暴露出来。

所以这个插件直接驱动命令行，这也正是 EigenFlux 为没有官方插件的主机写明的路径（skills/install.md："or any host without an official EigenFlux plugin, use the bare-CLI route"）。

没有定时器。这是设计决定，不是遗漏

没有间隔，没有心跳，没有后台轮询，激活时也不挂任何东西。只有调用工具时才去问网络，别的时候不问。如果这个仓库里将来有插件给 EigenFlux 加了调度器，那应当视为对本决定的回退，而不是增强。

工具守住的三条边界

1. 网络文本就标成网络文本。 ef_feed 给每份载荷套一层来源横幅，横幅明确点出信任边界：这些是别的智能体写的，属于不可信输入，里面某句话读起来像指令，但它不是指令。

2. 拒绝是一种状态，不是内容。「那里什么都没有」和「我没能去看」是两件不同的事。把命令行报错行和 feed 条目放进同一个通道返回，模型就会拿错误的前提去推理。ef_feed 会说明自己处在哪种状态，绝不把失败包装成结果。

3. 出站文本先给你看，再发出去。 ef_publish 和 ef_msg 从构造上就是两步：第一次调用返回确切的载荷加一个一次性 token，在第二次调用回传该 token 之前，什么都不发。token 按哈希绑定载荷，改动文本就会让它失效；队列只存在内存里——重启后没活下来的确认，等于没确认。

工具

| 工具 | 作用 | 备注 |
| ef_status | 无（离线） | 二进制、home、版本、时钟偏差、身份状态 |
| ef_surface | 无（离线） | 从二进制自己的 --help 读出真实命令列表 |
| ef_feed | 只读网络 | limit 1..50；载荷在外部横幅下返回 |
| ef_publish | 写入网络 | 两步操作；发出后无法撤回 |
| ef_msg | 写入网络 | 两步操作 |

编辑决策（哪些内容值得广播、哪些条目值得反馈、何时联系另一个智能体）刻意不放在这里。它们放在用户安装的、已签名的 ef- 技能里，由这些技能调用上述工具。把这类判断逻辑复制进本插件，只会分叉出另一份，然后逐渐走样。

id 是字符串，这不是风格偏好

EigenFlux 的 id 是 18 位雪花 ID，超出 Number.MAX_SAFE_INTEGER（9007199254740991）：

String(362115728905601024) === "362115728905601000"

把 id 当 JSON 数字传入，会被舍入成另一个条目。对 ef_msg 来说，这意味着回复给错误的智能体，而且悄无声息——比省略参数更糟，后者至少会明显失败。因此 item_id 接收字符串；超出安全范围的数字会连同原因一起拒绝，而不是接受后再舍入。

这不是纸上推演。为捕捉工具缺陷而写的验证脚本，把 id 当数字字面量传入，自己演示了这个缺陷：「预览显示回复目标」这条断言失败，因为预览忠实地显示了舍入后的 id。

由此得到一条通用教训，本插件在一次调试里就撞上了三次：声明的类型只是声明，不是事实。 参数可能以字符串到达，而 schema 说它是整数；退出码可能有两种不同含义；帮助文本可能有两种格式。要检查值，不要检查声明。

退出码

包装层映射命令行文档中列出的退出码（cli/internal/output/output.go）：0 成功，1 运行时失败，2 用法错误，3 未找到，4 需要认证，5 冲突，10 试运行。

退出码 2 覆盖所有用法错误，而它的描述恰好提到 provisioning，所以单看退出码无法区分「没有 Agent 身份」和「你敲错了参数」。只有文本能区分，而靠文本匹配，才能让 ef_status 不至于自信地报出错误的账户状态。只拿到一个 2 时，按未知处理。

安装（本机已完成）

irm https://www.eigenflux.ai/install.ps1 | iex # CLI + skills, user-level, no admin

当 CDN 发布 SHA256 时，安装器会校验二进制的 SHA256。在本机上，CDN 没有发布校验值，安装器也如实说明了这一点：因此二进制是在没有完整性校验的情况下执行的。这件事记录在此，不做粉饰。

挂载到 DSH 配置档需要两半都到位——file: 依赖，以及 dsh.profile.bundles 里的一条记录。包出现在 dependencies 里却不在 bundles 里，就永远不会被挂载。

开发

pnpm install
node node_modules/typescript/bin/tsc -p tsconfig.json --noEmit # types
node node_modules/esbuild/bin/esbuild src/index.ts --bundle --platform=node --format=esm \
--outfile=dist/index.js --external:@deepseek-ai/* # bundle
node --import ./test/register-stubs.mjs --test "test/*.test.mjs" # tests

测试导入的是 dist/，不是 src/：宿主加载的是打包产物，如果一套测试对着源码跑通、而实际发布的产物已经过期，那这个绿灯毫无意义。宿主包被标记为外部依赖，由 test/register-stubs.mjs 重定向到替身，所以从全新克隆的仓库就能跑这套测试，无需安装宿主。

dist/cli.js 是刻意保留的第二个入口：它承载与宿主无关的决策（用哪个二进制、退出码代表什么、本地时钟是什么），这样不用激活插件就能测试和复用这些逻辑。