核心功能
Planka CLI 是一个围绕 plankapy 库构建的命令行工具,用于与 Planka 自托管看板实例交互。该工具提供完整的 Kanban 工作流管理:
- 项目管理:列出所有项目
- 看板管理:查看各项目下的 Boards
- 列表操作:查看 Board 中的 Lists
- 卡片全生命周期:创建、查看详情(含附件URL和评论)、更新(支持跨列表移动、置顶)、删除
- 通知系统:获取全部或未读通知
显著优点
1. 纯 CLI 体验:适合自动化脚本和服务器环境,无需图形界面
2. 完整 CRUD:覆盖卡片从创建到归档的全部操作
3. 灵活移动:支持跨列表迁移和位置控制(top/bottom)
4. 凭证本地化:login 命令安全存储认证信息,避免重复输入
局限性与风险
| 维度 | 说明 |
|------|------|
| 依赖链 | 需 Python 3.11+ 和 plankapy v2,Homebrew 安装需信任第三方 tap |
| 凭证安全 | 本地存储的明文凭据若设备失窃存在泄露风险 |
| 网络暴露 | 需直连 Planka 实例,公网部署建议配合 VPN/HTTPS |
| 无审计日志 | 操作不留痕,不适合合规要求严格的场景 |
适用人群
- 习惯终端工作流的开发者/DevOps
- 需要批量操作看板数据的自动化场景
- 自托管 Planka 实例的管理员
安全建议
- 优先使用
brew install官方渠道,避免 pipx 来源不明包 - 生产环境建议配置专用只读账号,限制 CLI 权限范围
- 定期检查
~/.config/planka-cli或等效凭证目录权限(建议 600)