# bugcli

**Repository Path**: jimonik/bugcli

## Basic Information

- **Project Name**: bugcli
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-28
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# bugcli

`bug.vertu.cn` 的 Python 3.12 终端客户端。目前支持登录、查看本地登录状态和清除本地会话。

## 安装

```bash
conda activate py312
python -m pip install -e .
```

## 使用

```bash
bugcli login -u 你的账号
bugcli status
bugcli logout
```

直接运行工具会从接口列出产品供选择：

```bash
bugcli
```

启动后会显示当前账号和测试分类，并立即列出该分类的 Bug。在 Bug 选择提示中可输入 `c` 切换分类、
`l` 重新登录、`p` 编辑提示词、`r` 重置 Codex 会话或 `q` 退出。测试分类只在首次使用时要求选择，
之后自动复用。

第一次分析会创建 Codex 会话并把 session ID 保存到 SQLite。后续 Bug 使用 `codex exec resume` 继续
同一会话，从而保留此前读取过的代码结构和分析上下文；Bug 文字和图片仍会在每次命令结束后清理。

最终分析报告会保存到当前目录的 `分析/问题编号-标题.md`。可通过 `--analysis-dir` 指定其他目录：

```bash
bugcli 143 --bugs 11554 --analysis-dir ~/Documents/分析
```

每条 Bug 调用 Codex 前都会询问一次性补充提示，可填写关注模块、代码路径或已有线索；直接回车跳过。
补充提示只影响当前 Bug，不会覆盖全局提示词。非交互运行可以使用：

```bash
bugcli 143 --bugs 11554 --hint '重点检查闹钟取消意图和工具参数映射'
```

如果本地没有登录会话，会先提示输入账号和密码；登录成功后自动进入产品选择，无需另行执行
`bugcli login`。

工具会记住最近一次选择的产品。下次进入产品列表时直接按回车，即可继续使用上次的产品。

也可以直接传产品 ID。工具会自动查询该产品中“指派给我”的 Bug：

```bash
bugcli 143
```

旧的 `bugcli analyze 143` 写法仍兼容。

查看、编辑或恢复 Codex 分析提示词：

```bash
bugcli prompt
bugcli prompt edit
bugcli prompt reset
```

编辑时可使用 `{bug_id}`、`{title}`、`{bug_directory}`、`{description_file}` 和 `{images}` 占位符。
可以在提示词中写入项目代码绝对路径、技术栈和需要重点检查的模块。

原来的完整列表 URL 仍然兼容，其中 `recTotal` 和 `recPerPage` 不需要用户维护。

可先用 `--limit 1` 试跑：

```bash
bugcli 143 --limit 1
```

也可非交互指定序号、范围或 Bug ID：

```bash
bugcli 143 --bugs '1,3,5-8'
bugcli 143 --bugs '11562'
```

Bug 文字和图片只写入系统临时目录，分析结果输出到终端；命令结束后会自动清理，不持久化 Bug 数据。

密码通过隐藏输入读取，不会写入 SQLite。登录成功后，账号、站点、会话 Cookie 和登录时间默认保存在
`~/.local/share/bugcli/bugcli.db`，数据库权限设为仅当前用户可读写。可通过 `--db` 或环境变量
`BUGCLI_DB` 指定其他位置。