mcpField
P
pachca-profile

pachca-profile

github.com/pachca生产力1188 次安装今天更新
代码仓库

关于 pachca-profile

pachca-profile 是通过 Pachca CLI 查询和更新用户资料的技能，涵盖资料详情、自定义属性、状态和头像管理。

主要功能

  1. 01获取个人资料详情
  2. 02查看令牌权限范围和有效期
  3. 03设置或清除用户状态
  4. 04列出资料自定义属性
  5. 05上传或删除资料头像

适用场景

  1. 01检查令牌具备的权限范围
  2. 02设置带过期时间的离开状态
  3. 03查看员工自定义属性

安装

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

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

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

详细介绍

pachca-profile

快速开始

向用户索取 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。

工作流

获取自己的个人资料
  1. 获取当前用户的信息： 
    pachca profile get

返回 id、first_name、last_name、nickname、email、phone_number、department、title、role、suspended、invite_status、list_tags、custom_properties、user_status、bot、sso、created_at、last_activity_at、time_zone、image_url。

检查自己的令牌
  1. 获取令牌信息：作用域、创建日期和有效期： 
    pachca oauth token-info

便于诊断：查看令牌可用的作用域以及过期时间。

设置状态
  1. 设置状态： 
    pachca profile update-status --emoji="🏖️" --title="В отпуске" --is-away --away-message="Я в отпуске до 10 марта" --expires-at="2025-03-10T23:59:59.000Z"

    is_away: true — “暂时离开”模式。expires_at — 自动重置时间（ISO-8601，UTC+0）。away_message — 最多 1024 个字符。

重置状态
  1. 删除状态： 
    pachca profile delete-status --force
获取个人资料自定义字段

  1. 获取员工的附加字段列表：

    pachca custom-properties list --entity-type=User

    添加 entity_type=User 以进行筛选。

  2. 获取个人资料——字段值包含在 custom_properties 中：

    pachca profile get

自定义字段由空间管理员设置。

上传个人资料头像
  1. 从文件上传头像： 
    pachca profile update-avatar --file=<путь_к_файлу>

    图像文件以 multipart/form-data 格式传递。

删除个人资料头像
  1. 删除头像： 
    pachca profile delete-avatar --force

限制

  • 速率限制：约 50 req/sec。遇到 429 时，请等待后重试。
  • status.title：最多 50 个字符
  • status.away_message：最多 1024 个字符
  • 分页：基于游标（limit + cursor）

端点

方法路径描述
GET/custom_properties附加字段列表
GET/profile自己的个人资料
PUT/profile/avatar上传自己的头像
DELETE/profile/avatar删除自己的头像
GET/profile/status自己的状态
PUT/profile/status设置自己的新状态
DELETE/profile/status删除自己的状态

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

评论

支持 Markdown