ambleloft

接入 Node / npm 生态

复用熟悉的 JavaScript 工具,把专业能力带进 AI 工作流。

实践指南

完成后:把需要的 Node 依赖随插件一起交付。

前置条件:按本页具体步骤准备所需文件与工具;学习路线中的上一页不自动构成依赖。

本页内容

01使用本地工具包开发

按插件入门指南安装同批本地 SDK、CLI 和 core 包。运行依赖仍须打包到最终插件。

代码示例
npm install zod
# 在后端代码中使用依赖后,重新构建
npm run build
npm run validate
npm run pack
查看完整案例与运行说明

02随扩展交付运行代码

将依赖 bundle 到后台产物,或明确放入安装目录的 node_modules。宿主使用自己的 Node 运行时,不会在加载扩展时安装依赖或执行 npm 生命周期脚本。

03注意运行边界

原生模块需要单独验证操作系统、CPU 架构与宿主 ABI。浏览器页面不能直接使用 Node API;通过声明过的操作与后台通信。SDK 不会替代宿主权限与信任流程。

04使用内部 SDK 开发

先按插件入门指南安装同批本地 SDK、CLI 和 core。版本号不代表正式发行,运行依赖仍须打包到最终插件。

检查结果与排错

把需要的 Node 依赖随插件一起交付。

按本页的验证步骤核对实际结果。涉及业务服务时,分别检查界面提交、工具回执与服务端记录。

打开错误代码与排错 →
SDK / CLI 0.1.0-alpha.9 · 接口基线 兼容性与预览说明 · 案例源码