用途
这是一个 Zenkit 集成技能，用于管理 Zenkit 中的数据、记录并自动化工作流。适用于用户希望与 Zenkit 数据进行交互的场景。Zenkit 本身是一个项目管理与协作平台，结合了任务管理、思维导图和数据库能力，被团队和个人用来灵活、可定制地组织项目、追踪任务和管理信息。
主要能力
该技能通过 Membrane CLI 与 Zenkit 交互，Membrane 自动处理身份验证和凭证刷新，因此可以把精力集中在集成逻辑上，而不用处理认证管道。
Zenkit 涉及的对象和视图包括：
- 工作区（Workspace）
- 集合（Collection）
- 列表视图（List View）
- 表格视图（Table View）
- 日历视图（Calendar View）
- 甘特视图（Gantt View）
- 看板视图（Kanban View）
- 思维导图视图（Mindmap View）
- Wiki 视图（Wiki View）
- 条目（Item）
- 评论（Comment）
- 报告（Report）
- 个人资料（Profile）
- 订阅（Subscription）
操作时按需使用相应的操作名称和参数。
使用方式
安装 CLI
在终端中以全局方式安装 Membrane CLI：
npm install -g @membranehq/cli@latest
身份验证
membrane login --tenant --clientName=<agentType>
该命令会根据是否支持交互模式，打开浏览器进行认证，或在控制台打印授权 URL。
无头环境：此命令会打印一个授权 URL。请用户在浏览器中打开它。当用户在完成登录后看到验证码时，使用以下命令完成登录：
membrane login complete <code>
可在任意命令后添加 --json 以获得机器可读的 JSON 输出。
Agent 类型包括：claude、openclaw、codex、warp、windsurf 等。这些类型会用于调整工具，以便最好地配合你的运行框架。
连接到 Zenkit
使用 membrane connection ensure 通过应用 URL 或域名查找或创建连接：
membrane connection ensure "https://zenkit.com" --json
用户在浏览器中完成身份验证。输出包含新的连接 id。
这是获取连接最快的方式。URL 会被规范化到域名，并与已知应用匹配。如果未找到应用，则会创建一个应用并自动构建连接器。
如果返回的连接状态为 "READY"，则直接跳到步骤 2。
1b. 等待连接就绪
如果连接处于 BUILDING 状态，则轮询直到就绪：
npx @membranehq/cli connection get <id> --wait --json
--wait 标志会进行长轮询（最多 --timeout 秒，默认 30 秒），直到状态发生变化。持续轮询，直到状态不再是 BUILDING。
最终状态会告诉你下一步该做什么：
- READY — 连接已完全设置好。跳到步骤 2。
- CLIENT_ACTION_REQUIRED — 用户或 agent 需要执行某些操作。
clientAction对象描述了所需操作：clientAction.type— 所需操作的类型："connect"— 用户需要认证（OAuth、API key 等）。这涵盖初始认证以及断开连接的重新认证。"provide-input"— 需要更多信息（例如连接到哪个应用）。
clientAction.description— 对所需操作的通俗说明。clientAction.uiUrl（可选）— 一个预构建 UI 的 URL，用户可在其中完成操作。存在时请展示给用户。clientAction.agentInstructions（可选）— 供 AI agent 以编程方式继续操作的说明。
在用户完成操作（例如在浏览器中认证）后，再次使用 membrane connection get <id> --json 进行轮询，检查状态是否已变为 READY。
- CONFIGURATION_ERROR 或 SETUP_FAILED — 出现了问题。请查看
error字段了解详情。
搜索操作
使用对你想要做的事情的自然语言描述进行搜索：
membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json
应当始终在特定连接的上下文中搜索操作。
每个结果包含 id、name、description、inputSchema（该操作接受哪些参数）以及 outputSchema（它返回什么）。
常用操作：
npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json
运行操作
membrane action run <actionId> --connectionId=CONNECTION_ID --json
传入 JSON 参数：
membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json
结果位于响应的 output 字段中。
代理请求
当可用操作无法覆盖使用场景时，可以通过 Membrane 的代理直接向 Zenkit API 发送请求。Membrane 会自动把你提供的路径追加到基础 URL 上，并注入正确的认证头——包括在凭证过期时透明刷新。
membrane request CONNECTION_ID /path/to/endpoint
常用选项：
-X, --method：HTTP 方法（GET、POST、PUT、PATCH、DELETE）。默认为 GET-H, --header：添加请求头（可重复），例如-H "Accept: application/json"-d, --data：请求体（字符串）--json：简写，用于发送 JSON 请求体并设置Content-Type: application/json--rawData：原样发送请求体，不做任何处理--query：查询字符串参数（可重复），例如--query "limit=10"--pathParam：路径参数（可重复），例如--pathParam "id=123"
适用场景
适用于需要以编程或 agent 方式与 Zenkit 交互的场景，例如读取或写入 Zenkit 中的工作区、集合、条目、评论、报告等数据，或自动化相关的工作流。
限制与注意事项
- 该技能依赖 Membrane CLI 以及 Membrane 服务完成认证和请求转发。
- 需要通过
membrane login进行身份验证；在无头环境中需要用户手动在浏览器中打开授权 URL 并回填验证码。 - 具体可用的操作取决于 Membrane 针对该连接所提供的操作列表；需要先搜索再使用。
- 官方文档：https://developers.zenkit.com/