@wangzhenmax/projectmanagement-cli

ProjectManagement CLI

项目管理系统只读查询 CLI。安装后可以用 pm-cli 查询项目组、任务、Bug、成员、仓库、commit 和周报。

这个包只包含命令行客户端，只调用已部署的 HTTP API，不包含 Next.js、Prisma 或数据库连接代码。

可以获取哪些数据

数据	命令	说明
当前登录信息	pm-cli whoami	查看当前 token 对应的系统用户
所有项目组	pm-cli groups	返回项目组、绑定仓库、开发成员、协作成员、禅道产品
项目组任务	pm-cli tasks --group-id 1	查询指定项目组任务
多个项目组任务	pm-cli tasks --group-ids 1,2,3	查询多个项目组任务
指定成员任务	pm-cli tasks --user-id 12 / --gitee-user-id 9988 / --member 张三	查询成员所有任务
项目组 Bug	pm-cli bugs --group-id 1	查询项目组绑定禅道产品下的 Bug
多个项目组 Bug	pm-cli bugs --group-ids 1,2	查询多个项目组的 Bug
成员 Bug	pm-cli bugs --member 张三	按禅道指派人或创建人匹配
所有仓库	pm-cli repos	查询公司仓库、仓库地址、默认分支、项目组绑定
所有成员	pm-cli members --source all	查询系统成员和 Gitee 成员
系统成员	pm-cli members --source system	查询系统用户和其 Gitee 绑定
Gitee 成员	pm-cli members --source gitee	查询组织同步到的 Gitee 成员
Gitee token	pm-cli members --include-tokens true	返回成员 Gitee 授权 token
成员 commit	pm-cli commits --user-id 12	查询指定成员 commit
成员周报	pm-cli weekly-reports --user-id 12	查询成员周报
合并周报	pm-cli weekly-reports --source global --report-kind MERGED	查询合并后的周报

快速开始

安装：

npm install -g @wangzhenmax/projectmanagement-cli

登录：

pm-cli login --account 13800000000 --password your-password

默认服务域名是：

https://rd-mgt.vertu.cn/

连接其他环境时显式传入 --base-url：

pm-cli login --base-url https://rd-mgt.vertu.cn/ --account 13800000000 --password your-password

登录成功后 token 会保存到：

~/.projectmanagement-cli/config.json

退出：

pm-cli logout

命令总览

所有读取命令输出 JSON，并支持：

--page 1
--page-size 50

项目组

查询所有项目组：

pm-cli groups

搜索项目组：

pm-cli groups --q projectmanagement

任务

查询所有任务：

pm-cli tasks

查询指定项目组任务：

pm-cli tasks --group-id 1

查询多个项目组任务：

pm-cli tasks --group-ids 1,2,3

查询某一天任务：

pm-cli tasks --date 2026-07-20

查询指定成员任务：

pm-cli tasks --user-id 12
pm-cli tasks --gitee-user-id 9988
pm-cli tasks --member 张三

按状态或关键词过滤：

pm-cli tasks --status DONE
pm-cli tasks --q 登录

Bug

查询所有项目组 Bug：

pm-cli bugs

查询指定项目组 Bug：

pm-cli bugs --group-id 1

查询多个项目组 Bug：

pm-cli bugs --group-ids 1,2

查询成员相关 Bug：

pm-cli bugs --member 张三
pm-cli bugs --user-id 12
pm-cli bugs --gitee-user-id 9988

按状态或关键词过滤：

pm-cli bugs --status active
pm-cli bugs --q 支付

成员

查询所有成员：

pm-cli members --source all

只查系统成员：

pm-cli members --source system

只查 Gitee 成员：

pm-cli members --source gitee

查询成员详情并带 Gitee 授权 token：

pm-cli members --include-tokens true

注意：include-tokens true 会返回 accessToken 和 refreshToken，只能在可信服务端环境使用。

仓库

查询所有仓库：

pm-cli repos

搜索仓库：

pm-cli repos --q projectmanagement

Commit

查询所有 commit：

pm-cli commits

查询指定成员 commit：

pm-cli commits --user-id 12
pm-cli commits --gitee-user-id 9988
pm-cli commits --member 张三

查询指定日期或日期范围：

pm-cli commits --date 2026-07-20
pm-cli commits --start-date 2026-07-01 --end-date 2026-07-20

查询指定仓库：

pm-cli commits --repo-full-name chengdu-xiaochen/projectmanagement

周报

查询所有周报：

pm-cli weekly-reports

查询某个成员周报：

pm-cli weekly-reports --user-id 12

查询某一周：

pm-cli weekly-reports --period-id 2026-W30

查询个人项目组周报：

pm-cli weekly-reports --source global --report-kind PERSONAL

查询合并后的周报：

pm-cli weekly-reports --source global --report-kind MERGED

输出格式

列表命令统一返回：

{
  "data": {
    "items": [],
    "pagination": {
      "page": 1,
      "pageSize": 50,
      "total": 0,
      "totalPages": 0
    }
  }
}

错误返回：

{
  "ok": false,
  "error": "错误信息"
}

安全边界

• CLI 登录只用于认证调用方。
• 服务端 /api/cli/* 接口是全量只读数据出口，不按登录账号的页面权限缩小范围。
• CLI 不提供创建、修改、删除、完成任务、同步仓库或刷新 token 的能力。
• 数据能力来自项目管理系统服务端，使用前必须先部署包含 /api/cli/* 的服务端版本。

常见问题

为什么不用传 base-url？

默认使用 https://rd-mgt.vertu.cn/。只有连接测试环境或本地环境时才需要 --base-url。

为什么 npm 页面还显示旧文档？

npm 页面展示的是已经发布版本里的 README。修改 README 后必须发布新版本，npm 页面才会更新。

怎么查看当前版本？

npm view @wangzhenmax/projectmanagement-cli version

怎么升级已安装的 CLI？

npm install -g @wangzhenmax/projectmanagement-cli@latest

发布

发布新版本：

cd packages/projectmanagement-cli
npm publish --access public