@bigduu/lotus-next

中文文档
2026.11.10发布于 2026/11/07MITES Module构建来源已验证近 30 天下载 3580

Standalone Lotus Next frontend assets for the Bamboo runtime and Bodhi shell.

原始使用文档
文档目录7 节
  1. 你可以做什么
  2. 看一个为任务准备好的项目
  3. 从源码试用
  4. 源码、npm 包与桌面版本
  5. 运行时与本地化
  6. 开发与验证
  7. 许可证

Lotus Next

English · 简体中文

Lotus Next 品牌插画:水边一朵发光的莲花,象征清澈与美。

品牌插画,不是软件截图。莲花象征清澈与美。

在浏览器或 Bodhi 桌面应用里跟进 agent 的工作。 Lotus Next 是 Bamboo 的 React 界面,Bamboo 是 Zenith 本地 AI agent 套件的核心。它把会话、工具活动、权限请求和运行时设置放在同一个地方。

如果你已经在运行 Bamboo,可以直接用浏览器界面;也可以安装 Bodhi,用桌面外壳来管理引擎。Lotus Next 只提供界面;agent 由 Bamboo 运行,并连接你配置的模型 provider 和工具。

你可以做什么

  • 实时跟进任务:查看流式回复、推理过程和工具活动,并回应权限确认或提问对话框。
  • 让项目会话井井有条:切换会话、保留草稿,把会话导出为 Markdown 或 PDF。桌面分栏视图支持第二个可交互的对话窗格。
  • 配置会话背后的工具:打开 provider、MCP 服务、插件、技能和权限的设置,以及工作流、定时任务等运行时功能(取决于所连接的 Bamboo 版本是否支持)。
  • 适配不同屏幕尺寸:响应式的桌面/移动布局,浅色/深色/跟随系统主题,以及适合受限环境的图形安全模式。

以上描述的是当前源码,不保证所有连接的后端或较旧的打包应用都具备相同能力。设置界面本身不提供 provider 凭据、MCP 服务或正在运行的调度器。

看一个为任务准备好的项目

Lotus Next 通过 Bamboo 创建一个演示项目,并为新任务选择工作区。

静态图片 · 录制与复现说明

在审计时的源码 pin 上,连接真实 Bamboo 后端录制的真实浏览器画面。使用的是空的临时工作区;没有调用模型,也不代表任务已完成。这是源码行为,不代表已发布桌面应用的验收结果。

从源码试用

要求:Node.js 22.12+、npm,以及兼容的 Bamboo 服务。按照 Bamboo 的安装说明单独启动 Bamboo,让 API 监听 127.0.0.1:9562。然后在本目录中运行:

npm ci
npm run dev -- --host 127.0.0.1

打开 http://127.0.0.1:9563。如果是全新的后端,请先完成 bamboo init;初始设置页会引导你完成后端/桌面配置。如果你的 Bamboo 实例还没有 provider,打开 设置 → 提供方 进行配置。先在示例工作区里做一个小任务,然后跟进工具活动和权限确认。

显式指定 host 参数会让开发服务器只监听回环地址;仓库里不带参数的 npm run dev 会监听网络。Vite 会把 /api 和 /v2 代理到 9562 端口的 Bamboo。后端不可用时,无法执行任务,也无法提供依赖服务端的设置。

构建生产制品:

npm run build
# 在另一个已安装 Bamboo 的终端中:
bamboo serve --static-dir /absolute/path/to/lotus-next/dist --port 9562

Bamboo 就绪后打开 http://127.0.0.1:9562。这样使用的就是你刚构建的前端。发布到 npm 的包只包含前端资源,不是独立的 agent 或 CLI。

源码、npm 包与桌面版本

Lotus Next 是当前 Bamboo/Bodhi 源码使用的标准界面。旧的 Lotus 前端在这些项目中只保留为显式的回滚路径,而不是默认的生产前端。

2026-10-03 核对结果:

层次核实的标识
Zenith pin 和当时观察到的上游 main1131c275cb441694a41f996228d9f91473d920f5
npm latest@bigduu/[email protected],源码 a480e2bb94f5dd08fe4b01b2f8844a2c9ed03245
最新公开的 Bodhi 安装包app-v2026.9.20,锁定 Lotus Next 2026.9.16

源码在这个 npm 制品之后还有改动,包括 actor-stream/continuity 和工作流选择相关的工作。这些源码改动不代表已包含在 2026.9.22 或桌面安装包中。源码 package.json 有意保留 0.0.0;发布和下游采用是独立的步骤。证据见版本审计。

运行时与本地化

界面使用标准的 /api/v1 REST 调用,以及一个共享的 /v2/stream WebSocket(默认 JSON,可选 MessagePack)。浏览器构建和 Tauri 运行时适配器负责选择后端地址;只提供静态文件并不能替代 Bamboo。

VITE_BACKEND_BASE_URL 以及新的浏览器端地址覆盖,接受纯 HTTP(S) origin 或精确的 /api/v1。不要使用旧的 /v1 别名。不要把凭据放进公开的 VITE_* 构建变量。推荐从 Bamboo 的 origin 提供生产界面;远程托管需要相应的后端认证和安全传输配置。

i18next 运行时注册了 en-US、zh-CN、zh-TW、fr-FR、ja-JP 和 hi-IN,按需加载,缺失时回退到 en-US。部分较新的界面仍有硬编码的中文文字;这并不表示本地化已经完整。

开发与验证

npm run type-check
npm run test:run
npm run verify
npx playwright install chromium
npm run test:e2e:built

verify 会检查类型、lint、单元测试、架构、构建和包内容。浏览器测试套件在桌面、平板和手机视口下测试构建产物。它的确定性测试数据与连接真实 Bamboo 的验收流程是分开的;两者都不代表做过实体设备或公网测试。

隔离的真实运行时测试、不可变的已发布制品检查和清单验证,见验证与打包;构建体积的实测背景见包体积基线。这些是给贡献者的检查,不是安装 Bodhi 的前提条件。

许可证

项目自有代码和文档采用 MIT 许可证。第三方组件保留各自的许可证和版权声明。

版本与发布记录

@bigduu/lotus-next 共发布 26 个版本,首次发布于 2026/09/13;过去 12 个月发布了 26 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2026.11.10latest2026/11/071 天前
2026.11.92026/11/071 天前
2026.11.82026/11/061 天前
2026.11.72026/11/062 天前
2026.11.62026/11/062 天前
2026.11.52026/11/062 天前

关于 @bigduu/lotus-next 的常见问题

@bigduu/lotus-next 是什么?

Standalone Lotus Next frontend assets for the Bamboo runtime and Bodhi shell.

如何安装 @bigduu/lotus-next?

在项目目录运行 npm install @bigduu/lotus-next,或使用 pnpm add / yarn add / bun add。

@bigduu/lotus-next 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/bigduu__lotus-next 是否存在。

@bigduu/lotus-next 支持 ESM 还是 CommonJS?

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

@bigduu/lotus-next 需要什么版本的 Node.js?

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

@bigduu/lotus-next 可以商用吗?

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

@bigduu/lotus-next 的下载量有多少?

根据 npm 官方下载统计,@bigduu/lotus-next 在 2026/10/08 – 2026/11/06 这 30 天内被下载 3,580 次,日均约 119 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@bigduu/lotus-next 还在维护吗?

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