SuperAPI AI 工具集

redmine-cli

编程与开发

查看项目

更新于 10-15 21:10

技能介绍

用途:在终端中通过 Redmine REST API 管理 Redmine 项目与问题(工单),使用内置的 scripts/redmine_cli.py 脚本,无需外部依赖。认证与配置读取自 ~/.red/config.json,也可用 ./.red/config.json 覆盖。

主要能力:列出项目;列出问题(支持 --json、--limit、--page、--query、--status_id、--sort、--issue-urls、--project 等);查看问题元数据(项目、跟踪标签、状态、优先级);创建问题(可指定 --project-id、--subject、--description、--parent-id、--tracker、--priority-id);查看问题(--journals);列出全部或指派给当前用户的问题;添加、更新、删除日志备注/评论;编辑问题字段(主题、描述、状态、优先级、跟踪标签、父任务、指派对象);管理问题关系(relates、blocks、duplicates、precedes、follows);查看当前用户信息。

使用方式:先在 Redmine 界面(My account -> API access key)创建 API 密钥,再创建 ~/.red/config.json(v1 单实例格式,含 api-key、server 等字段)。验证连通性:python scripts/redmine_cli.py project list --json | head。多实例配置(v2 多服务器结构)可用 --rid 选择服务器,例如 python scripts/redmine_cli.py issue list --rid prod。

适用场景:需要在命令行或脚本中批量查询、创建、编辑 Redmine 工单,以及自动化处理问题关系与评论。

限制:HTTP 401/403 通常表示 API 密钥缺失/无效、REST API 未启用或权限不足;HTTP 404 表示基础 URL 错误(应为 Redmine 根地址,而非 /projects 等子路径);配置未找到需确认 ~/.red/config.json 存在且为有效 JSON。更多端点、载荷与过滤说明见 references/rest-api.md。