@decentnetwork/beagle

中文文档
0.1.121发布于 2026/11/01MITTypeScriptES Module

小猎犬- P2P聊天,文件传输和呼叫为普通用户,在体面的网络。不需要管理员权限。

中文使用文档
文档目录4 节
  1. 运行
  2. 调用(web↔Android)
  3. 状态:第一阶段
  4. 布局

小猎犬号

P2P聊天,文件传输和通话over 像样的网络. 没有帐户,没有服务器,没有管理员权限-您的身份是您的 自己的机器,消息是点对点的。

小猎犬是 应用程序. 协议存在于 @decentnetwork/peer (SDK) 和虚拟局域网层 @decentnetwork/lan decentlan是一名开发人员 运营商工具)。Beagle迭代快;这些都是故意让人觉得无聊的。

运行

npm install
npm run build
node dist/cli.js

然后打开 http://localhost:8766.

--port <n>         HTTP port (default 8766)
--host <addr>      bind address (default 127.0.0.1)
--config-dir <p>   identity/config dir (default ~/.agentnet)
--dora-dir <p>     dora roster dir, if this machine runs a dora

端口8766而不是decentlan的8765,所以在过渡期间 agentnet ui 和Beagle可以在一台机器上并排运行。

调用(web↔Android)

在线WebRTC与Android应用程序的使用 载波自举转,而不是。 东京消息传递。看到 文档/ webrtc-android-interop.md 对于故障模式和如何第一次呼叫冷启动是固定的。

状态:第一阶段

小猎犬选了一个 后端 作为承运人的身份。只有一个是活的, 因为一个身份永远不能同时运行两个载波对等体——两个对等体 会话建立时相同的对对竞争并破坏彼此的状态。

后端状态需要根虚拟局域网
daemon -通过IPC与正在运行的decentlan守护进程对话航运没有(守护进程有)是
embedded - Beagle打开自己的对等进程第二阶段否否

如今,Beagle需要一个decentlan守护程序。阶段2添加嵌入式后端,即 Beagle在普通用户权限和decentlan下独立运行的哪一点 变成可选的“我也想要一个虚拟局域网”附加组件。

从 ~/.agentnet 默认情况下,机器已经在运行 Decentlan保持相同的用户id和相同的好友——它是相同的节点, 不是新的。

布局

src/
├── cli.ts        # the `beagle` binary — argument parsing, startup
├── peer-host.ts  # backend abstraction + selection (the split's hinge)
├── ipc.ts        # decentlan daemon wire protocol, client side
├── server.ts     # local HTTP server: /api/* + serves the UI bundle
├── exits.ts      # official exit table (network panel only)
└── desktop/      # the UI itself (JSX, concatenated + esbuild-transpiled)

scripts/build-ui.mjs 包 src/desktop/*.jsx 成 dist/desktop/app.js. UI作为一个连接的脚本运行,与React (UMD)共享全局作用域 没有CDN,没有浏览器内的通天塔。

版本与发布记录

@decentnetwork/beagle 共发布 120 个版本,首次发布于 2026/07/27;过去 12 个月发布了 120 个版本。

版本发布日期距今
0.1.121latest2026/11/012 天前
0.1.1202026/10/313 天前
0.1.1192026/10/2113 天前
0.1.1182026/09/291 个月前
0.1.1172026/09/271 个月前
0.1.1162026/09/271 个月前

关于 @decentnetwork/beagle 的常见问题

@decentnetwork/beagle 是什么?

小猎犬- P2P聊天,文件传输和呼叫为普通用户,在体面的网络。不需要管理员权限。

如何安装 @decentnetwork/beagle?

在项目目录运行 npm install @decentnetwork/beagle,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 beagle,可以用 npx beagle 直接运行。

@decentnetwork/beagle 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@decentnetwork/beagle 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@decentnetwork/beagle 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@decentnetwork/beagle 可以商用吗?

@decentnetwork/beagle 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@decentnetwork/beagle 还在维护吗?

最新版本 0.1.121 发布于 2026/11/01(2 天前);至今共发布 120 个版本,其中过去 12 个月发布了 120 个;首次发布于 2026/07/27。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。