派单啦平台命令行工具

痛点：逃离 UI，把运营动作塞进脚本

在派单啦平台上配置报名表单、分发渠道和生成海报通常依赖 Web 界面。当你需要批量操作、接入 CI/CD 流程或与内部系统联动时，GUI 就成了阻碍。这个技能提供了一个名为 pdlctl 的命令行工具，直接对接平台底层 API（/api/v1/*），让你能用标准的 shell 命令管理表单、渠道、海报与数据提交。

核心机制与能力

pdlctl 最大的特点是零依赖。它是一个纯 Python 3 标准库实现的脚本，首次执行时自动落盘到本地缓存。所有输出统一为格式化 JSON（stdout），错误信息走 stderr，非常利于管道解析。

1. 认证与环境
支持 API Key（适合 CI）与登录会话（适合交互）。需要注意，API Key 的管理接口本身是锁定的，必须通过登录会话才能创建或吊销 Key。

2. 表单与渠道联动
你可以用 JSON 定义表单结构（支持 text/phone/select 字段），并配合渠道（Channel）进行分发。海报生成是核心功能之一，必须绑定一个 active 状态的渠道。背景图支持三种模式：上传图片、使用 AI Prompt 生成（支持 template 和 ai_poster 两种模式）或默认白底。

工程化避坑指南

状态锁与不可逆操作：一旦表单有了提交数据，字段结构将被永久锁定（FIELDS_LOCKED），只能修改标题和描述。此外，渠道停用是不可逆的，停用后已分发的二维码虽能填写，但数据会归入“未知渠道”。

生产环境慎用：命令默认指向生产环境。执行建表单、删渠道等破坏性操作前，务必确认。

PII 数据安全：提交数据包含姓名和手机号，属于敏感信息。除非必要，不建议导出到公开场合。