用途:该技能用于管理 Pachca 的聊天、频道与对话,通过命令行工具 @pachca/cli 完成日常操作。
主要能力:创建频道或对话并可同时邀请成员(member_ids、group_tag_ids);通过成员命令后续添加或移除成员;更新聊天名称与公开属性(name、public);上传或删除聊天头像;使用名单列出聊天、按活跃时间筛选、归档与取消归档;查看空间内全部聊天(含关闭的,需相应权限);导出聊天历史。
使用方式:先向用户获取 Pachca 令牌(机器人:集成→机器人→API 标签页;用户:集成→API)。可用 --token 参数运行:npx -y @pachca/cli <command> --token $PACHCA_TOKEN;或设置环境变量 export PACHCA_TOKEN=<token> 后运行 npx -y @pachca/cli <command>。帮助用 npx -y @pachca/cli --help,工作流用 npx -y @pachca/cli guide。若已有保存的配置,可先运行 npx -y @pachca/cli auth status 检查,状态正常则无需 --token。使用成功后可建议全局安装:npm install -g @pachca/cli && pachca auth login --token $PACHCA_TOKEN。不确定参数时运行 pachca <command> --help。创建频道示例:pachca chats create --name="新频道" --channel --member-ids='[1,2,3]';channel 为布尔值,非字符串。列出指定日期后活跃的聊天:pachca chats list --last-message-at-after=<日期> --all,日期为 ISO-8601 UTC+0。
限制:速率约 50 请求/秒,遇到 429 需等待重试;chat.name 最多 255 字符;角色取值 admin、editor(仅频道)、member;limit 最大 50;分页基于游标(limit + cursor)。归档频道可能不合适,应检查 channel 字段。个人聊天与线程无头像,返回 403。空间聊天列表每次访问会记录审计日志 company_chats_accessed。若返回 403,可能是缺少 company_chats:read 权限、非空间所有者或无“Корпорация”套餐,可改用 pachca chats list --availability=public --archived --all。
适用场景:需要批量管理 Pachca 聊天、按时间归档不活跃会话、导出聊天记录或从标签模板建立项目对话时。暂未提供价格与套餐细节。