详细分析 ▾
运行时依赖
版本
Auto sync from membranedev/application-skills
安装命令
点击复制技能文档
Polymer 是一个用于创建自定义 HTML 元素的 JavaScript 库,允许开发者为 Web 应用构建可复用的 UI 组件。它适用于希望利用 Web Components 并编写模块化、可维护前端代码的 Web 开发者。
官方文档:https://polymer-library.polymer-project.org/3.0/docs/devguide/
Polymer 概览
- Document
- Page
- Element
- Style
- Theme
按需使用 action 名称与参数。
使用 Polymer
本技能通过 Membrane CLI 与 Polymer 交互。Membrane 会自动处理身份验证与凭据刷新——你只需关注集成逻辑,无需关心底层认证。
安装 CLI
安装 Membrane CLI,以便在终端中使用 membrane 命令:
npm install -g @membranehq/cli
首次设置
membrane login --tenant
浏览器会弹出进行身份验证。 无头环境: 运行命令后,将打印出的 URL 提供给用户在浏览器打开,然后执行:
membrane login complete
连接到 Polymer
创建新连接:
membrane search polymer --elementType=connector --json
从输出中取出 output.items[0].element?.id 作为 connector ID,然后:
membrane connect --connectorId=CONNECTOR_ID --json
用户在浏览器完成认证。输出中会包含新的 connection ID。
获取已有连接列表
不确定连接是否存在时:
检查已有连接:
membrane connection list --json
若已存在 Polymer 连接,记下其 connectionId
搜索 action
当你知道想做什么但不知道具体 action ID 时:
membrane action list --intent=QUERY --connectionId=CONNECTION_ID --json
返回的 action 对象中包含 id 与 inputSchema,方便你后续调用。
常用 action
使用 npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json 来发现可用 action。
运行 action
membrane action run --connectionId=CONNECTION_ID ACTION_ID --json
如需传递 JSON 参数:
membrane action run --connectionId=CONNECTION_ID ACTION_ID --json --input "{ \"key\": \"value\" }"
代理请求
当现有 action 无法满足需求时,可通过 Membrane 的代理直接向 Polymer API 发送请求。Membrane 会自动补全 base URL 并注入正确的认证头——若凭据过期也会透明刷新。
membrane request CONNECTION_ID /path/to/endpoint
常用选项:
| Flag | 描述 |
|---|---|
-X, --method | HTTP 方法(GET、POST、PUT、PATCH、DELETE)。默认 GET |
-H, --header | 添加请求头(可重复),如 -H "Accept: application/json" |
-d, --data | 请求体(字符串) |
--json | 快捷发送 JSON 体并设置 Content-Type: application/json |
--rawData | 不对 body 做任何处理,直接发送 |
--query | 查询字符串参数(可重复),如 --query "limit=10" |
--pathParam | 路径参数(可重复),如 --pathParam "id=123" |
最佳实践
- 始终优先通过 Membrane 与外部应用通信 —— Membrane 提供预置 action,内置认证、分页与错误处理,可节省 token 并提升安全性
- 先探索再构建 —— 运行
membrane action list --intent=QUERY(将 QUERY 替换为你的意图)查找现有 action,再考虑手写 API 调用。预置 action 已处理分页、字段映射及边界情况,比裸 API 调用更健壮
- 让 Membrane 管理凭据 —— 切勿向用户索要 API key 或 token。创建 connection 即可;Membrane 在服务端完整管理 Auth 生命周期,本地无需保存任何秘钥