SuperAPI AI 工具集

pp-plane

编程与开发

查看项目

更新于 10-16 01:32

技能介绍

用途:通过 plane-pp-cli 二进制驱动 Plane 工作区,覆盖资产、邀请、问题、成员、项目、便签、用户、工作项等管理操作,并支持语义搜索与离线本地 SQLite 缓存。

主要能力:relations 支持列出、创建、删除工作项关联(blocking、blocked_by、duplicate、relates_to、temporal);module 提供模块归属助手,因 Plane 问题 API 不返回模块归属,sync 会在本地缓存尾部补全;attach-file 一步完成本地文件附件(presign、upload、mark)。

使用方式:先安装并验证。

npx -y @mvanhorn/printing-press-library install plane --cli-only plane-pp-cli --version

若 npx 不可用,可回退 Go 安装(需 Go 1.26.6+):

go install github.com/mvanhorn/printing-press-library/library/project-management/plane/cmd/plane-pp-cli@latest

认证:plane-pp-cli auth setup,然后 export PLANE_API_KEY_AUTHENTICATION="<your-key>";持久化用 plane-pp-cli auth set-token <token>;用 plane-pp-cli doctor 验证。

工作区定位:API 按工作区作用域,base_url 保持为 https://<host>/api/v1/workspaces/{slug},slug 由用户从浏览器 URL 提供。优先级为 --workspace > PLANE_SLUG > default_workspace。可用 init 或 workspaces add/use/list/current 管理本地注册表。若遇 403 或空结果,先 echo $PLANE_SLUG 排查环境变量覆盖。

代理模式:任意命令加 --agent 展开为 --json --compact --no-input --no-color --yes;可用 --select 裁剪字段、--dry-run 预览;输出包裹在 meta/ results 信封中。

限制:命令清单与行为以官方文档 developers.plane.so 为准;本工具不改变 REST API 的权限模型,工作区无法通过 API 枚举,需用户提供 slug;部分高级学习与路径重定位行为依赖本地状态目录。其他收费、价格或平台细节暂未提供。