vwork

VWork 是一款现场服务管理软件，面向拥有移动作业人员的企业，用于排班、派遣技术人员并跟踪进度。本技能通过 Membrane CLI 与 VWork 交互，由 Membrane 自动处理认证与凭证刷新。\n\n主要能力：可操作 VWork 中的 Task、Comment、Project、User、Time Entry、Client、Invoice 等对象，用于管理数据、记录并自动化工作流。\n\n使用方式：先安装 CLI，运行 npm install -g @membranehq/cli@latest；再通过 membrane login --tenant --clientName=<agentType> 登录，无交互环境下命令会输出授权 URL，用户完成登录后用 membrane login complete <code> 结束。连接 VWork 可用 membrane connection ensure "https://www.vworkapp.com/" --json，若状态为 BUILDING 则用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY；若为 CLIENT_ACTION_REQUIRED 需按提示完成认证或输入。搜索动作用 membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json，运行动作用 membrane action run <actionId> --connectionId=CONNECTION_ID --json，可加 --input '{"key": "value"}' 传参。当现有动作不覆盖需求时，可用 membrane request CONNECTION_ID /path/to/endpoint 直接代理请求 VWork API，Membrane 会自动拼接基础 URL 并注入认证头。任意命令可加 --json 获取机器可读输出。\n\n适用场景：需要以编程方式读取或写入 VWork 的现场服务数据、自动化调度与工单相关工作流时。\n\n限制：资料未提供具体动作清单、各对象字段细节、权限范围、速率限制、收费与价格信息；实际可用动作需通过 action list 查询确认。官方文档见 https://vworkapp.com/api-docs/。