gitcode-cli 0.6.1__tar.gz → 0.9.1__tar.gz

{gitcode_cli-0.6.1 → gitcode_cli-0.9.1}/LICENSE

@@ -25,4 +25,4 @@ SOFTWARE.
 This project is inspired by and references the GitHub CLI (https://github.com/cli/cli),
 which is also licensed under the MIT License.
 
-Copyright (c) 2019 GitHub, Inc.
+Copyright (c) 2019 GitHub, Inc.

{gitcode_cli-0.6.1 → gitcode_cli-0.9.1}/MANIFEST.in

@@ -1,4 +1,4 @@
 include README.md
 include LICENSE
 include pyproject.toml
-recursive-include gc_cli/bin *
+recursive-include gc_cli/bin *

{gitcode_cli-0.6.1/gitcode_cli.egg-info → gitcode_cli-0.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcode-cli
-Version: 0.6.1
+Version: 0.9.1
 Summary: GitCode CLI - Command line tool for GitCode
 Author-email: GitCode CLI Contributors <support@gitcode.com>
 Maintainer-email: GitCode CLI Contributors <support@gitcode.com>
@@ -33,9 +33,11 @@ Dynamic: license-file
 
 [![Go Version](https://img.shields.io/badge/Go-1.22+-00ADD8?style=flat&logo=go)](https://golang.org)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Release](https://img.shields.io/badge/Release-v0.5.9-blue)](https://gitcode.com/gitcode-cli/cli/releases)
+[![Release](https://img.shields.io/badge/Release-latest-blue)](https://gitcode.com/gitcode-cli/cli/releases)
 
-GitCode 命令行工具，为 GitCode 用户提供便捷的命令行操作体验。
+GitCode CLI 把仓库、Issue、PR、Release 和 Actions 带回终端，让开发者减少页面切换，也让脚本与 AI 获得结构化、可审计、带安全边界的 GitCode 执行入口。
+
+[快速了解核心价值与应用场景，并在五分钟内开始使用](./docs/INTRODUCTION.md)。
 
 ## 文档导航
 
@@ -50,6 +52,7 @@ GitCode 命令行工具，为 GitCode 用户提供便捷的命令行操作体验
 
 主要文档：
 
+- [产品介绍与快速上手](./docs/INTRODUCTION.md)
 - [命令手册](./docs/COMMANDS.md)
 - [认证说明](./docs/AUTH.md)
 - [回归说明](./docs/REGRESSION.md)
@@ -99,10 +102,10 @@ export PATH="$HOME/.local/bin:$PATH"
 
 ```bash
 # 从 Releases 下载 .deb 包
-wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.5.9/gc_0.5.9_amd64.deb
+wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.9.1/gc_0.9.1_amd64.deb
 
 # 安装
-sudo dpkg -i gc_0.5.9_amd64.deb
+sudo dpkg -i gc_0.9.1_amd64.deb
 ```
 
 DEB/RPM packages install both `gc` and `gitcode`; on Linux they are equivalent.
@@ -111,10 +114,10 @@ DEB/RPM packages install both `gc` and `gitcode`; on Linux they are equivalent.
 
 ```bash
 # 从 Releases 下载 .rpm 包
-wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.5.9/gc-0.5.9-1.x86_64.rpm
+wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.9.1/gc-0.9.1-1.x86_64.rpm
 
 # 安装
-sudo rpm -i gc-0.5.9-1.x86_64.rpm
+sudo rpm -i gc-0.9.1-1.x86_64.rpm
 ```
 
 DEB/RPM packages install both `gc` and `gitcode`; on Linux they are equivalent.
@@ -127,10 +130,10 @@ DEB/RPM packages install both `gc` and `gitcode`; on Linux they are equivalent.
 # 创建虚拟环境
 python3 -m venv .venv
 source .venv/bin/activate  # Linux/macOS
-# .venv\Scripts\activate   # Windows
+# .\.venv\Scripts\Activate.ps1  # Windows PowerShell
 
 # 安装（一行命令）
-pip install https://gitcode.com/gitcode-cli/cli/releases/download/v0.5.9/gitcode_cli-0.5.9-py3-none-any.whl
+pip install https://gitcode.com/gitcode-cli/cli/releases/download/v0.9.1/gitcode_cli-0.9.1-py3-none-any.whl
 
 # Windows PowerShell 中推荐使用 gitcode，避免 gc 被内置 Get-Content 别名覆盖
 gitcode version
@@ -139,7 +142,8 @@ gitcode version
 说明：
 - wheel 会同时安装 `gc` 和 `gitcode` 两个命令入口，功能相同。
 - DEB/RPM 包也会同时安装 `gc` 和 `gitcode`；Linux 上二者功能相同。
-- Windows PowerShell 预置 `gc` 作为 `Get-Content` 别名；如果 `gc version` 被解析为读取文件，请改用 `gitcode version`、`gc.exe version` 或 `python -m gc_cli version`。
+- Windows 使用 `py -m pip install --user ...` 时，脚本会安装到 Python user scheme 的 `Scripts` 目录。请运行 `py -c "import os, sysconfig; print(sysconfig.get_path('scripts', os.name + '_user'))"` 获取准确路径，将其加入用户 `PATH` 后重新打开终端；配置前可直接运行 `py -m gc_cli version`。
+- Windows PowerShell 预置 `gc` 作为 `Get-Content` 别名；如果 `gc version` 被解析为读取文件，请改用 `gitcode version`、`gc.exe version` 或 `py -m gc_cli version`。
 - Windows PowerShell 中通过 `--body-file -` / `--comment-file -` 管道传入中文或其他非 ASCII 正文时，推荐使用 UTF-8 文件；如果必须直接管道，先设置 `$OutputEncoding = [System.Text.UTF8Encoding]::new($false)`。CLI 会拦截疑似已被 PowerShell 损坏成 `???` 的输入并提示正确用法。
 
 ```powershell
@@ -149,14 +153,16 @@ gitcode issue create -R owner/repo --title "标题" --body-file body.md
 
 ### PyPI（备选）
 
+> PyPI 可能晚于 GitCode Release 同步。固定目标版本可避免静默安装旧版本；目标版本暂不可用时，请使用上方 Release wheel。
+
 ```bash
 # 创建虚拟环境
 python3 -m venv .venv
 source .venv/bin/activate  # Linux/macOS
-# .venv\Scripts\activate   # Windows
+# .\.venv\Scripts\Activate.ps1  # Windows PowerShell
 
-# 安装
-pip install gitcode-cli
+# 固定版本安装，避免 PyPI 尚未同步时安装旧版本
+python -m pip install -i https://pypi.org/simple/ gitcode-cli==0.9.1
 
 # Windows PowerShell 中推荐使用 gitcode
 gitcode version
@@ -183,42 +189,72 @@ gc version
 
 Windows 和 macOS 用户建议使用上方 wheel 包；wheel 内置 Linux、macOS 和 Windows 二进制，并同时提供 `gc` 与 `gitcode` 两个命令入口。
 
+### Docker 镜像
+
+仓库已提供 `Dockerfile`、`docker-compose.yml` 和 Makefile 目标：
+
+```bash
+# 构建并运行
+make docker-build
+make docker-run
+
+# 或使用 docker compose
+docker compose up gc
+```
+
+认证 Token 通过环境变量传入。请在交互终端中静默读取，避免 Token 值进入 shell history：
+
+```bash
+read -rsp "GitCode token: " GC_TOKEN
+export GC_TOKEN
+make docker-run
+unset GC_TOKEN
+```
+
+更多用法参见 Makefile 和 `docker-compose.yml`。
+
+### Homebrew (macOS/Linux)
+
+```bash
+brew install gitcode-cli/homebrew-tap/gc
+```
+
+更新到最新版本：
+
+```bash
+brew upgrade gc
+```
+
+shell 补全（bash/zsh/fish）随安装自动配置，无需额外操作。
+
 ### 规划中的安装方式
 
 以下安装方式正在开发中：
 
-- [ ] Homebrew (macOS/Linux)
 - [ ] Scoop (Windows)
-- [ ] Docker 镜像
 
 ## 快速开始
 
 ### 认证
 
-**方式一：设置环境变量（推荐）**
-
-```bash
-# 设置 Token 环境变量
-export GC_TOKEN="your_gitcode_token"
+以下示例使用安装包提供的 `gitcode` 入口；从源码构建或使用独立二进制时，请将命令名改为 `gc`。
 
-# 或使用备用变量名
-export GITCODE_TOKEN="your_gitcode_token"
+**方式一：打开令牌页面并登录**
 
-# 添加到 shell 配置文件（永久生效）
-echo 'export GC_TOKEN="your_gitcode_token"' >> ~/.bashrc
-source ~/.bashrc
+```bash
+gitcode auth login --web
 ```
 
-**方式二：交互式登录**
+当前 `--web` 会打开 GitCode 的新建访问令牌页面，生成令牌后仍需回到终端粘贴。当前版本不会隐藏输入，因此必须由用户本人在私有、未录制且不由 AI 控制的本地终端中执行。
 
-```bash
-# 交互式登录（需输入 Token）
-gc auth login
+**方式二：交互式 Token 登录**
 
-# 非交互登录（从 stdin 读取 Token）
-echo "YOUR_TOKEN" | gc auth login --with-token
+```bash
+gitcode auth login
 ```
 
+浏览器不可用时，可在同样受控的本地交互终端中输入 Token。不要把 Token 值直接写进命令、shell history 或配置脚本。CI 场景应通过平台 Secret 注入 `GC_TOKEN` 或 `GITCODE_TOKEN`。
+
 当前版本认证优先级：
 
 1. `GC_TOKEN`
@@ -233,43 +269,43 @@ echo "YOUR_TOKEN" | gc auth login --with-token
 
 **获取 Token：**
 1. 登录 [GitCode](https://gitcode.com)
-2. 进入 设置 -> 私人令牌
-3. 点击"生成新令牌"，选择所需权限
+2. 进入 个人设置 -> 访问令牌
+3. 点击“新建访问令牌”，选择所需权限
 4. 复制生成的 Token
 
 **验证认证：**
 
 ```bash
 # 查看认证状态
-gc auth status
+gitcode auth status
 ```
 
 > 详细命令行为和完整示例请查看 [docs/COMMANDS.md](./docs/COMMANDS.md)。
 
 ## 输出格式
 
-`gc` 的只读命令继续以文本输出为默认体验，同时为脚本和代理保留稳定的结构化入口。
+`gitcode` 的只读命令继续以文本输出为默认体验，同时为脚本和代理保留稳定的结构化入口。
 
 ```bash
 # 结构化输出
-gc issue list -R owner/repo --json
-gc issue list -R owner/repo --format json
-gc repo log -R owner/repo --file README.md --branch main --json
-gc pr list -R owner/repo --paginate --per-page 100 --json
+gitcode issue list -R owner/repo --json
+gitcode issue list -R owner/repo --format json
+gitcode repo log -R owner/repo --file README.md --branch main --json
+gitcode pr list -R owner/repo --paginate --per-page 100 --json
 
 # 常规文本与表格
-gc issue list -R owner/repo --format simple
-gc issue list -R owner/repo --format table
+gitcode issue list -R owner/repo --format simple
+gitcode issue list -R owner/repo --format table
 
 # 时间格式切换
-gc issue list -R owner/repo --time-format absolute
-gc issue list -R owner/repo --time-format relative
+gitcode issue list -R owner/repo --time-format absolute
+gitcode issue list -R owner/repo --time-format relative
 
 # 自定义模板输出
-gc issue list -R owner/repo --template '{{range .}}#{{.Number}} {{.Title}}{{"\n"}}{{end}}'
+gitcode issue list -R owner/repo --template '{{range .}}#{{.Number}} {{.Title}}{{"\n"}}{{end}}'
 
-# typed command 尚未覆盖的 API，可用 gc api 读取原始响应
-gc api repos/owner/repo
+# typed command 尚未覆盖的 API，可用 gitcode api 读取原始响应
+gitcode api repos/owner/repo
 ```
 
 `issue view` 和 `pr view` 的文本详情展示也会保持稳定布局，而 `--json` 仍然是面向机器调用的首选入口。
@@ -280,31 +316,58 @@ gc api repos/owner/repo
 
 ```bash
 # 查看仓库
-gc repo view
+gitcode repo view
 
 # 查看文件提交历史
-gc repo log -R owner/repo --file README.md --branch main
+gitcode repo log -R owner/repo --file README.md --branch main
 
 # 创建 Issue
-gc issue create --title "Bug report" --body "Description"
+gitcode issue create --title "Bug report" --body "Description"
 
 # 列出 Issues
-gc issue list --state open
+gitcode issue list --state open
 
 # 创建 PR
-gc pr create --title "New feature" --base main
+gitcode pr create --title "New feature" --base main
 
 # 按提交信息反查 PR
-gc pr list -R owner/repo --commit-message "fix login"
+gitcode pr list -R owner/repo --commit-message "fix login"
 
 # 提交前检查 pre-commit 配置与本地环境
-gc precommit check
+gitcode precommit check
+
+# 查看流水线运行记录
+gitcode actions run list -R owner/repo --status FAILED
+
+# 查看流水线运行详情
+gitcode actions run view <run-id> -R owner/repo
+
+# 列出流水线运行的 jobs
+gitcode actions job list <run-id> -R owner/repo
+
+# 查看工作流 job 详情
+gitcode actions job view <run-id> <job-id> -R owner/repo
+
+# 下载 job 日志归档
+gitcode actions job log <run-id> <job-id> -R owner/repo --output job-log.zip
+
+# 列出仓库 artifacts
+gitcode actions artifact list -R owner/repo
+
+# 查看 artifact 详情
+gitcode actions artifact view <artifact-id> -R owner/repo
+
+# 下载 artifact
+gitcode actions artifact download <artifact-id> -R owner/repo --output artifact.zip
+
+# 删除 artifact
+gitcode actions artifact delete <artifact-id> -R owner/repo --yes
 
 # 调用 GitCode API 原始响应
-gc api repos/owner/repo
+gitcode api repos/owner/repo
 
 # 查看认证状态
-gc auth status
+gitcode auth status
 ```
 
 完整命令说明、参数细节、平台限制和更多示例，请直接查看：
@@ -343,7 +406,7 @@ source ~/.config/fish/config.fish
 
 补充说明：
 
-- `docs/AI-GUIDE.md` 只服务外部项目通过 AI 使用 `gc`
+- `docs/AI-GUIDE.md` 只服务外部项目通过 AI 使用 `gitcode`（或源码构建的 `gc`）
 - gitcode-cli 仓库内部 AI 开发请看 `AGENTS.md`、`CLAUDE.md` 和 `spec/workflows/ai-local-development-workflow.md`
 - `issues-plan/PROGRESS.md` 只作为阶段说明，不作为单个 issue / PR 的实时事实依据
 
@@ -385,5 +448,5 @@ make run
 ## 相关链接
 
 - [GitCode](https://gitcode.com) - GitCode 平台
-- [API 文档](https://gitcode.com/docs/api) - GitCode API 参考
+- [API 文档](https://docs.gitcode.com/docs/apis/) - GitCode API 参考
 - [问题反馈](https://gitcode.com/gitcode-cli/cli/issues) - 提交 Bug 或建议

{gitcode_cli-0.6.1 → gitcode_cli-0.9.1}/README.md

@@ -4,9 +4,11 @@
 
 [![Go Version](https://img.shields.io/badge/Go-1.22+-00ADD8?style=flat&logo=go)](https://golang.org)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Release](https://img.shields.io/badge/Release-v0.5.9-blue)](https://gitcode.com/gitcode-cli/cli/releases)
+[![Release](https://img.shields.io/badge/Release-latest-blue)](https://gitcode.com/gitcode-cli/cli/releases)
 
-GitCode 命令行工具，为 GitCode 用户提供便捷的命令行操作体验。
+GitCode CLI 把仓库、Issue、PR、Release 和 Actions 带回终端，让开发者减少页面切换，也让脚本与 AI 获得结构化、可审计、带安全边界的 GitCode 执行入口。
+
+[快速了解核心价值与应用场景，并在五分钟内开始使用](./docs/INTRODUCTION.md)。
 
 ## 文档导航
 
@@ -21,6 +23,7 @@ GitCode 命令行工具，为 GitCode 用户提供便捷的命令行操作体验
 
 主要文档：
 
+- [产品介绍与快速上手](./docs/INTRODUCTION.md)
 - [命令手册](./docs/COMMANDS.md)
 - [认证说明](./docs/AUTH.md)
 - [回归说明](./docs/REGRESSION.md)
@@ -70,10 +73,10 @@ export PATH="$HOME/.local/bin:$PATH"
 
 ```bash
 # 从 Releases 下载 .deb 包
-wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.5.9/gc_0.5.9_amd64.deb
+wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.9.1/gc_0.9.1_amd64.deb
 
 # 安装
-sudo dpkg -i gc_0.5.9_amd64.deb
+sudo dpkg -i gc_0.9.1_amd64.deb
 ```
 
 DEB/RPM packages install both `gc` and `gitcode`; on Linux they are equivalent.
@@ -82,10 +85,10 @@ DEB/RPM packages install both `gc` and `gitcode`; on Linux they are equivalent.
 
 ```bash
 # 从 Releases 下载 .rpm 包
-wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.5.9/gc-0.5.9-1.x86_64.rpm
+wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.9.1/gc-0.9.1-1.x86_64.rpm
 
 # 安装
-sudo rpm -i gc-0.5.9-1.x86_64.rpm
+sudo rpm -i gc-0.9.1-1.x86_64.rpm
 ```
 
 DEB/RPM packages install both `gc` and `gitcode`; on Linux they are equivalent.
@@ -98,10 +101,10 @@ DEB/RPM packages install both `gc` and `gitcode`; on Linux they are equivalent.
 # 创建虚拟环境
 python3 -m venv .venv
 source .venv/bin/activate  # Linux/macOS
-# .venv\Scripts\activate   # Windows
+# .\.venv\Scripts\Activate.ps1  # Windows PowerShell
 
 # 安装（一行命令）
-pip install https://gitcode.com/gitcode-cli/cli/releases/download/v0.5.9/gitcode_cli-0.5.9-py3-none-any.whl
+pip install https://gitcode.com/gitcode-cli/cli/releases/download/v0.9.1/gitcode_cli-0.9.1-py3-none-any.whl
 
 # Windows PowerShell 中推荐使用 gitcode，避免 gc 被内置 Get-Content 别名覆盖
 gitcode version
@@ -110,7 +113,8 @@ gitcode version
 说明：
 - wheel 会同时安装 `gc` 和 `gitcode` 两个命令入口，功能相同。
 - DEB/RPM 包也会同时安装 `gc` 和 `gitcode`；Linux 上二者功能相同。
-- Windows PowerShell 预置 `gc` 作为 `Get-Content` 别名；如果 `gc version` 被解析为读取文件，请改用 `gitcode version`、`gc.exe version` 或 `python -m gc_cli version`。
+- Windows 使用 `py -m pip install --user ...` 时，脚本会安装到 Python user scheme 的 `Scripts` 目录。请运行 `py -c "import os, sysconfig; print(sysconfig.get_path('scripts', os.name + '_user'))"` 获取准确路径，将其加入用户 `PATH` 后重新打开终端；配置前可直接运行 `py -m gc_cli version`。
+- Windows PowerShell 预置 `gc` 作为 `Get-Content` 别名；如果 `gc version` 被解析为读取文件，请改用 `gitcode version`、`gc.exe version` 或 `py -m gc_cli version`。
 - Windows PowerShell 中通过 `--body-file -` / `--comment-file -` 管道传入中文或其他非 ASCII 正文时，推荐使用 UTF-8 文件；如果必须直接管道，先设置 `$OutputEncoding = [System.Text.UTF8Encoding]::new($false)`。CLI 会拦截疑似已被 PowerShell 损坏成 `???` 的输入并提示正确用法。
 
 ```powershell
@@ -120,14 +124,16 @@ gitcode issue create -R owner/repo --title "标题" --body-file body.md
 
 ### PyPI（备选）
 
+> PyPI 可能晚于 GitCode Release 同步。固定目标版本可避免静默安装旧版本；目标版本暂不可用时，请使用上方 Release wheel。
+
 ```bash
 # 创建虚拟环境
 python3 -m venv .venv
 source .venv/bin/activate  # Linux/macOS
-# .venv\Scripts\activate   # Windows
+# .\.venv\Scripts\Activate.ps1  # Windows PowerShell
 
-# 安装
-pip install gitcode-cli
+# 固定版本安装，避免 PyPI 尚未同步时安装旧版本
+python -m pip install -i https://pypi.org/simple/ gitcode-cli==0.9.1
 
 # Windows PowerShell 中推荐使用 gitcode
 gitcode version
@@ -154,42 +160,72 @@ gc version
 
 Windows 和 macOS 用户建议使用上方 wheel 包；wheel 内置 Linux、macOS 和 Windows 二进制，并同时提供 `gc` 与 `gitcode` 两个命令入口。
 
+### Docker 镜像
+
+仓库已提供 `Dockerfile`、`docker-compose.yml` 和 Makefile 目标：
+
+```bash
+# 构建并运行
+make docker-build
+make docker-run
+
+# 或使用 docker compose
+docker compose up gc
+```
+
+认证 Token 通过环境变量传入。请在交互终端中静默读取，避免 Token 值进入 shell history：
+
+```bash
+read -rsp "GitCode token: " GC_TOKEN
+export GC_TOKEN
+make docker-run
+unset GC_TOKEN
+```
+
+更多用法参见 Makefile 和 `docker-compose.yml`。
+
+### Homebrew (macOS/Linux)
+
+```bash
+brew install gitcode-cli/homebrew-tap/gc
+```
+
+更新到最新版本：
+
+```bash
+brew upgrade gc
+```
+
+shell 补全（bash/zsh/fish）随安装自动配置，无需额外操作。
+
 ### 规划中的安装方式
 
 以下安装方式正在开发中：
 
-- [ ] Homebrew (macOS/Linux)
 - [ ] Scoop (Windows)
-- [ ] Docker 镜像
 
 ## 快速开始
 
 ### 认证
 
-**方式一：设置环境变量（推荐）**
-
-```bash
-# 设置 Token 环境变量
-export GC_TOKEN="your_gitcode_token"
+以下示例使用安装包提供的 `gitcode` 入口；从源码构建或使用独立二进制时，请将命令名改为 `gc`。
 
-# 或使用备用变量名
-export GITCODE_TOKEN="your_gitcode_token"
+**方式一：打开令牌页面并登录**
 
-# 添加到 shell 配置文件（永久生效）
-echo 'export GC_TOKEN="your_gitcode_token"' >> ~/.bashrc
-source ~/.bashrc
+```bash
+gitcode auth login --web
 ```
 
-**方式二：交互式登录**
+当前 `--web` 会打开 GitCode 的新建访问令牌页面，生成令牌后仍需回到终端粘贴。当前版本不会隐藏输入，因此必须由用户本人在私有、未录制且不由 AI 控制的本地终端中执行。
 
-```bash
-# 交互式登录（需输入 Token）
-gc auth login
+**方式二：交互式 Token 登录**
 
-# 非交互登录（从 stdin 读取 Token）
-echo "YOUR_TOKEN" | gc auth login --with-token
+```bash
+gitcode auth login
 ```
 
+浏览器不可用时，可在同样受控的本地交互终端中输入 Token。不要把 Token 值直接写进命令、shell history 或配置脚本。CI 场景应通过平台 Secret 注入 `GC_TOKEN` 或 `GITCODE_TOKEN`。
+
 当前版本认证优先级：
 
 1. `GC_TOKEN`
@@ -204,43 +240,43 @@ echo "YOUR_TOKEN" | gc auth login --with-token
 
 **获取 Token：**
 1. 登录 [GitCode](https://gitcode.com)
-2. 进入 设置 -> 私人令牌
-3. 点击"生成新令牌"，选择所需权限
+2. 进入 个人设置 -> 访问令牌
+3. 点击“新建访问令牌”，选择所需权限
 4. 复制生成的 Token
 
 **验证认证：**
 
 ```bash
 # 查看认证状态
-gc auth status
+gitcode auth status
 ```
 
 > 详细命令行为和完整示例请查看 [docs/COMMANDS.md](./docs/COMMANDS.md)。
 
 ## 输出格式
 
-`gc` 的只读命令继续以文本输出为默认体验，同时为脚本和代理保留稳定的结构化入口。
+`gitcode` 的只读命令继续以文本输出为默认体验，同时为脚本和代理保留稳定的结构化入口。
 
 ```bash
 # 结构化输出
-gc issue list -R owner/repo --json
-gc issue list -R owner/repo --format json
-gc repo log -R owner/repo --file README.md --branch main --json
-gc pr list -R owner/repo --paginate --per-page 100 --json
+gitcode issue list -R owner/repo --json
+gitcode issue list -R owner/repo --format json
+gitcode repo log -R owner/repo --file README.md --branch main --json
+gitcode pr list -R owner/repo --paginate --per-page 100 --json
 
 # 常规文本与表格
-gc issue list -R owner/repo --format simple
-gc issue list -R owner/repo --format table
+gitcode issue list -R owner/repo --format simple
+gitcode issue list -R owner/repo --format table
 
 # 时间格式切换
-gc issue list -R owner/repo --time-format absolute
-gc issue list -R owner/repo --time-format relative
+gitcode issue list -R owner/repo --time-format absolute
+gitcode issue list -R owner/repo --time-format relative
 
 # 自定义模板输出
-gc issue list -R owner/repo --template '{{range .}}#{{.Number}} {{.Title}}{{"\n"}}{{end}}'
+gitcode issue list -R owner/repo --template '{{range .}}#{{.Number}} {{.Title}}{{"\n"}}{{end}}'
 
-# typed command 尚未覆盖的 API，可用 gc api 读取原始响应
-gc api repos/owner/repo
+# typed command 尚未覆盖的 API，可用 gitcode api 读取原始响应
+gitcode api repos/owner/repo
 ```
 
 `issue view` 和 `pr view` 的文本详情展示也会保持稳定布局，而 `--json` 仍然是面向机器调用的首选入口。
@@ -251,31 +287,58 @@ gc api repos/owner/repo
 
 ```bash
 # 查看仓库
-gc repo view
+gitcode repo view
 
 # 查看文件提交历史
-gc repo log -R owner/repo --file README.md --branch main
+gitcode repo log -R owner/repo --file README.md --branch main
 
 # 创建 Issue
-gc issue create --title "Bug report" --body "Description"
+gitcode issue create --title "Bug report" --body "Description"
 
 # 列出 Issues
-gc issue list --state open
+gitcode issue list --state open
 
 # 创建 PR
-gc pr create --title "New feature" --base main
+gitcode pr create --title "New feature" --base main
 
 # 按提交信息反查 PR
-gc pr list -R owner/repo --commit-message "fix login"
+gitcode pr list -R owner/repo --commit-message "fix login"
 
 # 提交前检查 pre-commit 配置与本地环境
-gc precommit check
+gitcode precommit check
+
+# 查看流水线运行记录
+gitcode actions run list -R owner/repo --status FAILED
+
+# 查看流水线运行详情
+gitcode actions run view <run-id> -R owner/repo
+
+# 列出流水线运行的 jobs
+gitcode actions job list <run-id> -R owner/repo
+
+# 查看工作流 job 详情
+gitcode actions job view <run-id> <job-id> -R owner/repo
+
+# 下载 job 日志归档
+gitcode actions job log <run-id> <job-id> -R owner/repo --output job-log.zip
+
+# 列出仓库 artifacts
+gitcode actions artifact list -R owner/repo
+
+# 查看 artifact 详情
+gitcode actions artifact view <artifact-id> -R owner/repo
+
+# 下载 artifact
+gitcode actions artifact download <artifact-id> -R owner/repo --output artifact.zip
+
+# 删除 artifact
+gitcode actions artifact delete <artifact-id> -R owner/repo --yes
 
 # 调用 GitCode API 原始响应
-gc api repos/owner/repo
+gitcode api repos/owner/repo
 
 # 查看认证状态
-gc auth status
+gitcode auth status
 ```
 
 完整命令说明、参数细节、平台限制和更多示例，请直接查看：
@@ -314,7 +377,7 @@ source ~/.config/fish/config.fish
 
 补充说明：
 
-- `docs/AI-GUIDE.md` 只服务外部项目通过 AI 使用 `gc`
+- `docs/AI-GUIDE.md` 只服务外部项目通过 AI 使用 `gitcode`（或源码构建的 `gc`）
 - gitcode-cli 仓库内部 AI 开发请看 `AGENTS.md`、`CLAUDE.md` 和 `spec/workflows/ai-local-development-workflow.md`
 - `issues-plan/PROGRESS.md` 只作为阶段说明，不作为单个 issue / PR 的实时事实依据
 
@@ -356,5 +419,5 @@ make run
 ## 相关链接
 
 - [GitCode](https://gitcode.com) - GitCode 平台
-- [API 文档](https://gitcode.com/docs/api) - GitCode API 参考
+- [API 文档](https://docs.gitcode.com/docs/apis/) - GitCode API 参考
 - [问题反馈](https://gitcode.com/gitcode-cli/cli/issues) - 提交 Bug 或建议

{gitcode_cli-0.6.1 → gitcode_cli-0.9.1}/gc_cli/__init__.py

@@ -4,7 +4,7 @@ GitCode CLI - Command line tool for GitCode.
 This package provides a Python wrapper for the gc binary.
 """
 
-__version__ = "0.6.1"
+__version__ = "0.9.1"
 __author__ = "GitCode CLI Contributors"
 __all__ = ["__version__", "main"]
 

{gitcode_cli-0.6.1 → gitcode_cli-0.9.1/gitcode_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcode-cli
-Version: 0.6.1
+Version: 0.9.1
 Summary: GitCode CLI - Command line tool for GitCode
 Author-email: GitCode CLI Contributors <support@gitcode.com>
 Maintainer-email: GitCode CLI Contributors <support@gitcode.com>
@@ -33,9 +33,11 @@ Dynamic: license-file
 
 [![Go Version](https://img.shields.io/badge/Go-1.22+-00ADD8?style=flat&logo=go)](https://golang.org)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Release](https://img.shields.io/badge/Release-v0.5.9-blue)](https://gitcode.com/gitcode-cli/cli/releases)
+[![Release](https://img.shields.io/badge/Release-latest-blue)](https://gitcode.com/gitcode-cli/cli/releases)
 
-GitCode 命令行工具，为 GitCode 用户提供便捷的命令行操作体验。
+GitCode CLI 把仓库、Issue、PR、Release 和 Actions 带回终端，让开发者减少页面切换，也让脚本与 AI 获得结构化、可审计、带安全边界的 GitCode 执行入口。
+
+[快速了解核心价值与应用场景，并在五分钟内开始使用](./docs/INTRODUCTION.md)。
 
 ## 文档导航
 
@@ -50,6 +52,7 @@ GitCode 命令行工具，为 GitCode 用户提供便捷的命令行操作体验
 
 主要文档：
 
+- [产品介绍与快速上手](./docs/INTRODUCTION.md)
 - [命令手册](./docs/COMMANDS.md)
 - [认证说明](./docs/AUTH.md)
 - [回归说明](./docs/REGRESSION.md)
@@ -99,10 +102,10 @@ export PATH="$HOME/.local/bin:$PATH"
 
 ```bash
 # 从 Releases 下载 .deb 包
-wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.5.9/gc_0.5.9_amd64.deb
+wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.9.1/gc_0.9.1_amd64.deb
 
 # 安装
-sudo dpkg -i gc_0.5.9_amd64.deb
+sudo dpkg -i gc_0.9.1_amd64.deb
 ```
 
 DEB/RPM packages install both `gc` and `gitcode`; on Linux they are equivalent.
@@ -111,10 +114,10 @@ DEB/RPM packages install both `gc` and `gitcode`; on Linux they are equivalent.
 
 ```bash
 # 从 Releases 下载 .rpm 包
-wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.5.9/gc-0.5.9-1.x86_64.rpm
+wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.9.1/gc-0.9.1-1.x86_64.rpm
 
 # 安装
-sudo rpm -i gc-0.5.9-1.x86_64.rpm
+sudo rpm -i gc-0.9.1-1.x86_64.rpm
 ```
 
 DEB/RPM packages install both `gc` and `gitcode`; on Linux they are equivalent.
@@ -127,10 +130,10 @@ DEB/RPM packages install both `gc` and `gitcode`; on Linux they are equivalent.
 # 创建虚拟环境
 python3 -m venv .venv
 source .venv/bin/activate  # Linux/macOS
-# .venv\Scripts\activate   # Windows
+# .\.venv\Scripts\Activate.ps1  # Windows PowerShell
 
 # 安装（一行命令）
-pip install https://gitcode.com/gitcode-cli/cli/releases/download/v0.5.9/gitcode_cli-0.5.9-py3-none-any.whl
+pip install https://gitcode.com/gitcode-cli/cli/releases/download/v0.9.1/gitcode_cli-0.9.1-py3-none-any.whl
 
 # Windows PowerShell 中推荐使用 gitcode，避免 gc 被内置 Get-Content 别名覆盖
 gitcode version
@@ -139,7 +142,8 @@ gitcode version
 说明：
 - wheel 会同时安装 `gc` 和 `gitcode` 两个命令入口，功能相同。
 - DEB/RPM 包也会同时安装 `gc` 和 `gitcode`；Linux 上二者功能相同。
-- Windows PowerShell 预置 `gc` 作为 `Get-Content` 别名；如果 `gc version` 被解析为读取文件，请改用 `gitcode version`、`gc.exe version` 或 `python -m gc_cli version`。
+- Windows 使用 `py -m pip install --user ...` 时，脚本会安装到 Python user scheme 的 `Scripts` 目录。请运行 `py -c "import os, sysconfig; print(sysconfig.get_path('scripts', os.name + '_user'))"` 获取准确路径，将其加入用户 `PATH` 后重新打开终端；配置前可直接运行 `py -m gc_cli version`。
+- Windows PowerShell 预置 `gc` 作为 `Get-Content` 别名；如果 `gc version` 被解析为读取文件，请改用 `gitcode version`、`gc.exe version` 或 `py -m gc_cli version`。
 - Windows PowerShell 中通过 `--body-file -` / `--comment-file -` 管道传入中文或其他非 ASCII 正文时，推荐使用 UTF-8 文件；如果必须直接管道，先设置 `$OutputEncoding = [System.Text.UTF8Encoding]::new($false)`。CLI 会拦截疑似已被 PowerShell 损坏成 `???` 的输入并提示正确用法。
 
 ```powershell
@@ -149,14 +153,16 @@ gitcode issue create -R owner/repo --title "标题" --body-file body.md
 
 ### PyPI（备选）
 
+> PyPI 可能晚于 GitCode Release 同步。固定目标版本可避免静默安装旧版本；目标版本暂不可用时，请使用上方 Release wheel。
+
 ```bash
 # 创建虚拟环境
 python3 -m venv .venv
 source .venv/bin/activate  # Linux/macOS
-# .venv\Scripts\activate   # Windows
+# .\.venv\Scripts\Activate.ps1  # Windows PowerShell
 
-# 安装
-pip install gitcode-cli
+# 固定版本安装，避免 PyPI 尚未同步时安装旧版本
+python -m pip install -i https://pypi.org/simple/ gitcode-cli==0.9.1
 
 # Windows PowerShell 中推荐使用 gitcode
 gitcode version
@@ -183,42 +189,72 @@ gc version
 
 Windows 和 macOS 用户建议使用上方 wheel 包；wheel 内置 Linux、macOS 和 Windows 二进制，并同时提供 `gc` 与 `gitcode` 两个命令入口。
 
+### Docker 镜像
+
+仓库已提供 `Dockerfile`、`docker-compose.yml` 和 Makefile 目标：
+
+```bash
+# 构建并运行
+make docker-build
+make docker-run
+
+# 或使用 docker compose
+docker compose up gc
+```
+
+认证 Token 通过环境变量传入。请在交互终端中静默读取，避免 Token 值进入 shell history：
+
+```bash
+read -rsp "GitCode token: " GC_TOKEN
+export GC_TOKEN
+make docker-run
+unset GC_TOKEN
+```
+
+更多用法参见 Makefile 和 `docker-compose.yml`。
+
+### Homebrew (macOS/Linux)
+
+```bash
+brew install gitcode-cli/homebrew-tap/gc
+```
+
+更新到最新版本：
+
+```bash
+brew upgrade gc
+```
+
+shell 补全（bash/zsh/fish）随安装自动配置，无需额外操作。
+
 ### 规划中的安装方式
 
 以下安装方式正在开发中：
 
-- [ ] Homebrew (macOS/Linux)
 - [ ] Scoop (Windows)
-- [ ] Docker 镜像
 
 ## 快速开始
 
 ### 认证
 
-**方式一：设置环境变量（推荐）**
-
-```bash
-# 设置 Token 环境变量
-export GC_TOKEN="your_gitcode_token"
+以下示例使用安装包提供的 `gitcode` 入口；从源码构建或使用独立二进制时，请将命令名改为 `gc`。
 
-# 或使用备用变量名
-export GITCODE_TOKEN="your_gitcode_token"
+**方式一：打开令牌页面并登录**
 
-# 添加到 shell 配置文件（永久生效）
-echo 'export GC_TOKEN="your_gitcode_token"' >> ~/.bashrc
-source ~/.bashrc
+```bash
+gitcode auth login --web
 ```
 
-**方式二：交互式登录**
+当前 `--web` 会打开 GitCode 的新建访问令牌页面，生成令牌后仍需回到终端粘贴。当前版本不会隐藏输入，因此必须由用户本人在私有、未录制且不由 AI 控制的本地终端中执行。
 
-```bash
-# 交互式登录（需输入 Token）
-gc auth login
+**方式二：交互式 Token 登录**
 
-# 非交互登录（从 stdin 读取 Token）
-echo "YOUR_TOKEN" | gc auth login --with-token
+```bash
+gitcode auth login
 ```
 
+浏览器不可用时，可在同样受控的本地交互终端中输入 Token。不要把 Token 值直接写进命令、shell history 或配置脚本。CI 场景应通过平台 Secret 注入 `GC_TOKEN` 或 `GITCODE_TOKEN`。
+
 当前版本认证优先级：
 
 1. `GC_TOKEN`
@@ -233,43 +269,43 @@ echo "YOUR_TOKEN" | gc auth login --with-token
 
 **获取 Token：**
 1. 登录 [GitCode](https://gitcode.com)
-2. 进入 设置 -> 私人令牌
-3. 点击"生成新令牌"，选择所需权限
+2. 进入 个人设置 -> 访问令牌
+3. 点击“新建访问令牌”，选择所需权限
 4. 复制生成的 Token
 
 **验证认证：**
 
 ```bash
 # 查看认证状态
-gc auth status
+gitcode auth status
 ```
 
 > 详细命令行为和完整示例请查看 [docs/COMMANDS.md](./docs/COMMANDS.md)。
 
 ## 输出格式
 
-`gc` 的只读命令继续以文本输出为默认体验，同时为脚本和代理保留稳定的结构化入口。
+`gitcode` 的只读命令继续以文本输出为默认体验，同时为脚本和代理保留稳定的结构化入口。
 
 ```bash
 # 结构化输出
-gc issue list -R owner/repo --json
-gc issue list -R owner/repo --format json
-gc repo log -R owner/repo --file README.md --branch main --json
-gc pr list -R owner/repo --paginate --per-page 100 --json
+gitcode issue list -R owner/repo --json
+gitcode issue list -R owner/repo --format json
+gitcode repo log -R owner/repo --file README.md --branch main --json
+gitcode pr list -R owner/repo --paginate --per-page 100 --json
 
 # 常规文本与表格
-gc issue list -R owner/repo --format simple
-gc issue list -R owner/repo --format table
+gitcode issue list -R owner/repo --format simple
+gitcode issue list -R owner/repo --format table
 
 # 时间格式切换
-gc issue list -R owner/repo --time-format absolute
-gc issue list -R owner/repo --time-format relative
+gitcode issue list -R owner/repo --time-format absolute
+gitcode issue list -R owner/repo --time-format relative
 
 # 自定义模板输出
-gc issue list -R owner/repo --template '{{range .}}#{{.Number}} {{.Title}}{{"\n"}}{{end}}'
+gitcode issue list -R owner/repo --template '{{range .}}#{{.Number}} {{.Title}}{{"\n"}}{{end}}'
 
-# typed command 尚未覆盖的 API，可用 gc api 读取原始响应
-gc api repos/owner/repo
+# typed command 尚未覆盖的 API，可用 gitcode api 读取原始响应
+gitcode api repos/owner/repo
 ```
 
 `issue view` 和 `pr view` 的文本详情展示也会保持稳定布局，而 `--json` 仍然是面向机器调用的首选入口。
@@ -280,31 +316,58 @@ gc api repos/owner/repo
 
 ```bash
 # 查看仓库
-gc repo view
+gitcode repo view
 
 # 查看文件提交历史
-gc repo log -R owner/repo --file README.md --branch main
+gitcode repo log -R owner/repo --file README.md --branch main
 
 # 创建 Issue
-gc issue create --title "Bug report" --body "Description"
+gitcode issue create --title "Bug report" --body "Description"
 
 # 列出 Issues
-gc issue list --state open
+gitcode issue list --state open
 
 # 创建 PR
-gc pr create --title "New feature" --base main
+gitcode pr create --title "New feature" --base main
 
 # 按提交信息反查 PR
-gc pr list -R owner/repo --commit-message "fix login"
+gitcode pr list -R owner/repo --commit-message "fix login"
 
 # 提交前检查 pre-commit 配置与本地环境
-gc precommit check
+gitcode precommit check
+
+# 查看流水线运行记录
+gitcode actions run list -R owner/repo --status FAILED
+
+# 查看流水线运行详情
+gitcode actions run view <run-id> -R owner/repo
+
+# 列出流水线运行的 jobs
+gitcode actions job list <run-id> -R owner/repo
+
+# 查看工作流 job 详情
+gitcode actions job view <run-id> <job-id> -R owner/repo
+
+# 下载 job 日志归档
+gitcode actions job log <run-id> <job-id> -R owner/repo --output job-log.zip
+
+# 列出仓库 artifacts
+gitcode actions artifact list -R owner/repo
+
+# 查看 artifact 详情
+gitcode actions artifact view <artifact-id> -R owner/repo
+
+# 下载 artifact
+gitcode actions artifact download <artifact-id> -R owner/repo --output artifact.zip
+
+# 删除 artifact
+gitcode actions artifact delete <artifact-id> -R owner/repo --yes
 
 # 调用 GitCode API 原始响应
-gc api repos/owner/repo
+gitcode api repos/owner/repo
 
 # 查看认证状态
-gc auth status
+gitcode auth status
 ```
 
 完整命令说明、参数细节、平台限制和更多示例，请直接查看：
@@ -343,7 +406,7 @@ source ~/.config/fish/config.fish
 
 补充说明：
 
-- `docs/AI-GUIDE.md` 只服务外部项目通过 AI 使用 `gc`
+- `docs/AI-GUIDE.md` 只服务外部项目通过 AI 使用 `gitcode`（或源码构建的 `gc`）
 - gitcode-cli 仓库内部 AI 开发请看 `AGENTS.md`、`CLAUDE.md` 和 `spec/workflows/ai-local-development-workflow.md`
 - `issues-plan/PROGRESS.md` 只作为阶段说明，不作为单个 issue / PR 的实时事实依据
 
@@ -385,5 +448,5 @@ make run
 ## 相关链接
 
 - [GitCode](https://gitcode.com) - GitCode 平台
-- [API 文档](https://gitcode.com/docs/api) - GitCode API 参考
+- [API 文档](https://docs.gitcode.com/docs/apis/) - GitCode API 参考
 - [问题反馈](https://gitcode.com/gitcode-cli/cli/issues) - 提交 Bug 或建议

{gitcode_cli-0.6.1 → gitcode_cli-0.9.1}/pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["setuptools>=61.0", "wheel"]
+requires = ["setuptools==80.9.0", "wheel==0.45.1"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "gitcode-cli"
-version = "0.6.1"
+version = "0.9.1"
 description = "GitCode CLI - Command line tool for GitCode"
 readme = "README.md"
 license = "MIT"