mcpField
P
pachca-forms

pachca-forms

github.com/pachca开发1188 次安装今天更新
代码仓库

关于 pachca-forms

pachca-forms 是使用 Pachca CLI 打开交互式表单并处理提交的技能。它要求使用 Bot 令牌，并说明支持的表单块类型及响应时限。

主要功能

  1. 01打开模态表单
  2. 02使用 11 种表单块
  3. 03处理表单提交
  4. 04遵守提交响应时限

适用场景

  1. 01向用户展示交互式表单
  2. 02开展员工调查
  3. 03通过申请表收集请求

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/pachca/openapi --skill pachca-forms

安装后在 Claude Code 中输入/pachca-forms确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
employee-survey-via-form.md
handle-form-submission-viewsubmission.md
requestapplication-form.md
show-interactive-form-to-user.md

详细介绍

pachca-forms

快速入门

请向用户索取 Pachca 令牌（机器人：Integrations → Bots 中机器人的 API 选项卡；用户：Integrations → API）。 仅限机器人令牌——用户令牌不可用。

使用 --token 标志，通过 npx -y @pachca/cli 运行命令：

npx -y @pachca/cli <command> --token $PACHCA_TOKEN

或者设置 PACHCA_TOKEN 环境变量：

export PACHCA_TOKEN=<token>
npx -y @pachca/cli <command>

帮助：npx -y @pachca/cli --help | 工作流：npx -y @pachca/cli guide

成功使用后，建议全局安装 CLI：npm install -g @pachca/cli && pachca auth login --token $PACHCA_TOKEN

开始之前

  1. 如果用户已有已保存的个人资料，请检查：

    npx -y @pachca/cli auth status

    如果正常，则不带 --token 运行命令。

  2. 如果尚未配置个人资料，请索取令牌并使用 --token：

    npx -y @pachca/cli auth status --token $PACHCA_TOKEN

  3. 如果不清楚参数，请运行 pachca <command> --help。

表单区块

共有 11 种区块类型：header、plain_text、markdown、divider、input、select、radio、checkbox、date、time、file_input。字段级参考资料——包含每种区块的参数、限制和默认值——位于 https://dev.pachca.com/guides/forms/blocks.md，且仅在此处维护。

通过 file_input 上传的文件，可通过 data.<field>[].url 中的 URL 访问，时效为两小时；文件本身会保留一天。收到提交后立即下载，不要延后。

限制

  • 速率限制：约 50 req/sec。遇到 429 时，请等待后重试。
  • 410：trigger_id 已过期或未找到。trigger_id 的有效期为 3 秒。通过点击按钮获取新的 trigger_id（webhook）
  • 410：在 POST /views/{view_id}/submit_response 上出现 submit_expired。响应窗口为表单提交后的 5 秒内，且只能接受一次响应。请及时读取事件历史记录，以便按时回复
  • 404：在 POST /views/{view_id}/submit_response 上出现 view_not_found。请从 view_submit 事件负载中获取 view_id，并使用打开该视图的同一机器人令牌回复
  • type：允许的值——modal（模态窗口）
  • private_metadata：最多 3000 个字符
  • callback_id：最多 255 个字符
  • view.title：最多 24 个字符
  • view.close_text：最多 24 个字符
  • view.submit_text：最多 24 个字符

端点

方法路径描述
POST/views/open打开视图
POST/views/{view_id}/submit_response回复表单提交

高级工作流

如需了解高级工作流，请阅读 references/ 中的文件： references/show-interactive-form-to-user.md — 向用户显示交互式表单 references/handle-form-submission-viewsubmission.md — 处理表单提交（view_submission） references/employee-survey-via-form.md — 通过表单进行员工调查 references/requestapplication-form.md — 请求／申请表单

如果不确定如何完成任务，请阅读 references/ 中对应的文件。

评论

支持 Markdown