Planka CLI

该技能为 plankapy 库提供了一个命令行接口（CLI）封装，用于与 Planka 实例进行交互。

安装配置

1. 通过 Homebrew tap 安装：

   brew tap voydz/homebrew-tap
   brew install planka-cli
   

   若通过源码或 pipx 安装，则需 Python 3.11+ 以兼容 plankapy v2。

2. 配置：
   使用 login 命令保存凭据：

   planka-cli login --url https://planka.example --username alice --password secret
   # 或：python3 scripts/planka_cli.py login --url https://planka.example --username alice --password secret
   

使用方法

运行已安装的 planka-cli 可执行文件：

# 显示帮助信息
planka-cli

# 检查连接状态
planka-cli status

# 登录 Planka 实例
planka-cli login --url https://planka.example --username alice --password secret

# 清除已保存的凭据
planka-cli logout

# 列出所有项目（Projects）
planka-cli projects list

# 列出所有看板（Boards），可选指定项目 ID
planka-cli boards list [PROJECT_ID]

# 列出某一看板中的所有列表（Lists）
planka-cli lists list 

# 列出某一列表中的所有卡片（Cards）
planka-cli cards list 

# 查看某一张卡片详情（包含带 URL 的附件及评论文本）
planka-cli cards show 

# 创建一张新卡片
planka-cli cards create  "卡片标题"

# 更新一张卡片
planka-cli cards update  --name "新标题"
planka-cli cards update  --list-id 
planka-cli cards update  --list-id  --position top

# 删除一张卡片
planka-cli cards delete 

# 通知管理
planka-cli notifications all
planka-cli notifications unread

示例

列出所有看板：

planka-cli boards list

查看列表 ID 为 1619901252164912136 中的所有卡片：

planka-cli cards list 1619901252164912136

查看卡片 ID 为 1619901252164912137 的详细信息：

planka-cli cards show 1619901252164912137

在列表 ID 为 1619901252164912136 中创建一张卡片：

planka-cli cards create 1619901252164912136 "发布 CLI"

将一张卡片移动至另一列表：

planka-cli cards update 1619901252164912137 --list-id 1619901252164912136

将一张卡片移动至另一列表并置顶：

planka-cli cards update 1619901252164912137 --list-id 1619901252164912136 --position top

通过更新卡片名称标记其为已完成：

planka-cli cards update 1619901252164912137 --name "已完成：发布 CLI"