背景

GitCode 官方 API 2.0.0 在 2026-09-01 快照中新增此操作。当前 GitCode CLI 支持矩阵将其标记为 api-only，尚无专用命令。

• 总跟踪：https://gitcode.com/gitcode-cli/cli/issues/552
• API 文档同步：https://gitcode.com/gitcode-cli/gc-api-doc/merge_requests/5

官方 API

• 标题：创建仓库讨论评论
• 方法：POST
• 路径：/api/v5/repos/{owner}/{repo}/discuss/{number}/comment
• 分类：Discusstion
• 官方文档：https://docs.gitcode.com/docs/apis/post-api-v-5-repos-owner-repo-discuss-number-comment
• 成功响应：200

Path / Query 参数

access_token 是官方 API 参数；CLI 实现必须复用现有认证层，不新增明文 token 参数，也不得在日志或 JSON 输出中回显 token。

Request Body 字段

200 Response 字段

嵌套字段使用点号表示，对象数组使用 [] 表示。字段定义按本次官方 OpenAPI 快照原样记录；疑似文案或类型异常不得在实现中自行猜测修正。

CLI 设计建议

gitcode discussions project comments create <number> -R owner/repo --body-file <file>

• 沿用现有 Discussions 命令树、仓库/组织解析和认证机制。
• 正文类字段支持直接 flag、--body-file 与 stdin，并执行敏感内容扫描。
• 成功结果支持 --json，JSON 字段直接映射 API 响应。
• 写操作应在非 TTY 环境中保持确定性，不得隐式等待输入。
• 参数错误、资源不存在、认证失败和资源冲突遵循统一退出码。

验收标准

• api/ 查询函数严格匹配上述 method、path、参数和 body
• 专用 CLI 命令及帮助文本实现完成
• --json 输出可机器消费且不泄露认证信息
• 单元测试覆盖请求映射、响应解析、参数错误和 API 错误
• 真实命令验证仅使用 infra-test/* 仓库
• 同步 docs/COMMANDS.md 与 gc-api-doc CLI 支持矩阵

风险

risk/medium：新增远端写操作。