made-bridge

中文文档
0.3.21发布于 2026/11/04MITES Module零依赖

码得(made)独立语音编程设备的电脑侧桥接器:工作台 API、设备接口、任务调度与插件运行时。一条命令启动,配合 ESP32 固件使用,源码在 github.com/jobop/made。

中文使用文档
文档目录3 节
  1. 启动方式
  2. 目录结构
  3. 插件与主题的目录

bridge

电脑侧桥接器。设备 API 在 8788,工作台在 127.0.0.1:8787。

启动方式

npx made-bridge        # 任何机器一条命令(npm 包,Node >= 22)
  • 首次运行会在 ~/.made-bridge/config.local.json 生成配置(含示例项目),编辑 projects 指向你自己的代码仓库后重启。
  • 配置、状态、工作区都在 ~/.made-bridge/,与代码分离——npm 包目录视为只读,缓存被清也不丢数据。
  • 环境变量:VIBE_CONFIG / VIBE_STATE_DIR / VIBE_DATA_DIR 可把三个位置各自指到别处;VIBE_USB_PORT、MADE_HOME 等见 npm run doctor 输出。
  • 云端部署(made-cloud):设置 VIBE_CLOUD_ORIGIN(完整 URL 或裸 host,逗号分隔多个)可把云转发来源加入 /pair/verify 的 Host 授权白名单,仅放行校验,配对 HMAC 挑战不变。
npm start              # 源码仓库运行(本目录);沿用仓库里的 config.local.json
npm run doctor         # 自检:运行环境、依赖命令、接入方式、已装插件

编程助手 CLI(codex / cursor / qoder 等)需要已安装在 PATH 上;刷机用仓库根的 npm run flash,不随 npm 包分发。

目录结构

内部仍是桥接器自己的运行结构:

  • src/:服务、设备接口与内置 agent
  • public/:工作台
  • builtin/:随代码发布的内置插件与主题(builtin/plugins/、builtin/themes/),升级代码即升级内置包
  • examples/:示例
  • tools/:开发工具
  • test/:测试

插件与主题的目录

用户包不在本目录,而是在固定的用户目录里:

  • ~/made/plugins/ —— 管控插件与助手插件
  • ~/made/themes/ —— 主题包

桥接器每次启动扫描这两个目录,市场装到这里即可生效,不需要跟配置文件放在一起。路径可用 MADE_HOME 环境变量或 config.local.json 里的 madeHome 改成别处。

查找顺序是「内置在前、用户目录在后」,同名时用户目录覆盖内置。所以 bridge/builtin/ 里的内置包是只读的:工作台可以启用、停用,但不能移除;想覆盖就在 ~/made/ 放同名目录。

插件市场和专家市场只负责发包,不放在这里。包安装进 ~/made/ 之后,桥接器才会加载。配置文件:源码仓库运行用本目录的 config.local.json;npx made-bridge 运行用 ~/.made-bridge/config.local.json。

在仓库根目录执行 npm start 或 npm test 会转到这里。

版本与发布记录

made-bridge 共发布 27 个版本,首次发布于 2026/10/11;过去 12 个月发布了 27 个版本。

版本发布日期距今
0.3.21latest2026/11/04今天
0.3.202026/11/041 天前
0.3.192026/11/041 天前
0.3.182026/11/031 天前
0.3.172026/11/013 天前
0.3.162026/11/014 天前

关于 made-bridge 的常见问题

made-bridge 是什么?

码得(made)独立语音编程设备的电脑侧桥接器:工作台 API、设备接口、任务调度与插件运行时。一条命令启动,配合 ESP32 固件使用,源码在 github.com/jobop/made。

如何安装 made-bridge?

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

made-bridge 支持 TypeScript 吗?

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

made-bridge 支持 ESM 还是 CommonJS?

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

made-bridge 需要什么版本的 Node.js?

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

made-bridge 可以商用吗?

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

made-bridge 还在维护吗?

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