gitcode-cli 0.11.0__py3-none-any.whl → 0.12.0__py3-none-any.whl

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.11.0"
+__version__ = "0.12.0"
 __author__ = "GitCode CLI Contributors"
 __all__ = ["__version__", "main"]
 

{gitcode_cli-0.11.0.dist-info → gitcode_cli-0.12.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcode-cli
-Version: 0.11.0
+Version: 0.12.0
 Summary: GitCode CLI - Command line tool for GitCode
 Author-email: GitCode CLI Contributors <support@gitcode.com>
 Maintainer-email: GitCode CLI Contributors <support@gitcode.com>
@@ -67,7 +67,39 @@ GitCode CLI 把仓库、Issue、PR、Release 和 Actions 带回终端，让开
 
 ## 安装
 
-推荐只让一个全局安装渠道拥有 `gc` / `gitcode`。Windows 普通用户和 Node/AI 环境优先使用 npm；macOS 优先 Homebrew；Debian/Ubuntu 优先 DEB；RHEL/Fedora 优先 RPM。Python wheel 建议放入 `pipx` 或虚拟环境，CI 建议固定版本并校验 checksum。
+推荐只让一个全局安装渠道拥有 `gc` / `gitcode`。已安装 Node.js/npm 的 Windows、Linux、macOS 与 AI 环境优先使用下方 npm bootstrap；没有 Node.js 时再选择 Homebrew、DEB/RPM 或隔离的 Python wheel。CI 建议固定版本并校验 checksum。
+
+### 推荐：npm 一行 bootstrap（跨平台）
+
+已安装 Node.js/npm 时，安装或升级 CLI 的首选入口是：
+
+```bash
+npx -y @gitcode-cli/cli@latest install
+gitcode version
+```
+
+短命令适合用户主目录等可信环境，会继承当前目录与用户的 npm 配置。CI、审计、不可信项目目录或自定义 npm registry 环境请使用完整加固命令：
+
+```bash
+npx --yes --ignore-scripts --registry=https://registry.npmjs.org --@gitcode-cli:registry=https://registry.npmjs.org @gitcode-cli/cli@latest install
+```
+
+CI、审计或版本复现可固定版本：
+
+```bash
+npx --yes --ignore-scripts --registry=https://registry.npmjs.org --@gitcode-cli:registry=https://registry.npmjs.org @gitcode-cli/cli@0.12.0 install
+```
+
+不要使用 `npm i @gitcode-cli/cli` 或 `npm install @gitcode-cli/cli` 安装全局 CLI；这两条命令只会把包加入当前项目的 `node_modules`，不会更新 PATH 中已有的 `gitcode`。需要由 npm global prefix 管理入口时，可改用：
+
+```bash
+npm install -g --ignore-scripts --registry=https://registry.npmjs.org --@gitcode-cli:registry=https://registry.npmjs.org @gitcode-cli/cli@latest
+gitcode version
+```
+
+一行 bootstrap 会把平台二进制安装到全局 bin 目录；Linux/macOS 同时配置 bash/zsh/fish 补全，Windows 跳过 shell 补全。Windows 会在用户显式执行 `install` 后把安装目录置于持久 User PATH 前面并去重；如不希望修改，传入 `--no-modify-path`。由于 `npx` 子进程无法刷新已经打开的 PowerShell，安装完成后会用中文给出当前窗口立即生效的 `$env:Path` 命令和重开终端说明。它不会修改 Machine PATH、删除或重写其他 PATH 条目，也不会调用其他包管理器卸载软件。显式 `--target-dir` 会替换该目录内的同名常规文件，不要将它指向 Python Scripts、npm prefix 等由其他包管理器持有的目录。
+
+Linux/macOS 上若存在历史同目录 `gitcode -> gc` 别名，会在安全校验和事务保护下自动迁移；无需先卸载 PyPI 包或手工删除链接。命令显式固定 generic 与 scoped 官方 registry，并禁用 npm lifecycle scripts，避免继承当前目录或用户 npm 配置中的非官方包来源。
 
 安装或升级后可离线检查实际命令来源和全部 PATH 候选：
 
@@ -111,10 +143,10 @@ export PATH="$HOME/.local/bin:$PATH"
 
 ```bash
 # 从 Releases 下载 .deb 包
-wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.11.0/gc_0.11.0_amd64.deb
+wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.12.0/gc_0.12.0_amd64.deb
 
 # 安装
-sudo dpkg -i gc_0.11.0_amd64.deb
+sudo dpkg -i gc_0.12.0_amd64.deb
 ```
 
 DEB/RPM packages install both `gc` and `gitcode`; on Linux they are equivalent.
@@ -123,10 +155,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.11.0/gc-0.11.0-1.x86_64.rpm
+wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.12.0/gc-0.12.0-1.x86_64.rpm
 
 # 安装
-sudo rpm -i gc-0.11.0-1.x86_64.rpm
+sudo rpm -i gc-0.12.0-1.x86_64.rpm
 ```
 
 DEB/RPM packages install both `gc` and `gitcode`; on Linux they are equivalent.
@@ -142,7 +174,7 @@ source .venv/bin/activate  # Linux/macOS
 # .\.venv\Scripts\Activate.ps1  # Windows PowerShell
 
 # 安装（一行命令）
-pip install https://gitcode.com/gitcode-cli/cli/releases/download/v0.11.0/gitcode_cli-0.11.0-py3-none-any.whl
+pip install https://gitcode.com/gitcode-cli/cli/releases/download/v0.12.0/gitcode_cli-0.12.0-py3-none-any.whl
 
 # Windows PowerShell 中推荐使用 gitcode，避免 gc 被内置 Get-Content 别名覆盖
 gitcode version
@@ -172,7 +204,7 @@ source .venv/bin/activate  # Linux/macOS
 # .\.venv\Scripts\Activate.ps1  # Windows PowerShell
 
 # 固定版本安装，避免 PyPI 尚未同步时安装旧版本
-python -m pip install -i https://pypi.org/simple/ gitcode-cli==0.11.0
+python -m pip install -i https://pypi.org/simple/ gitcode-cli==0.12.0
 
 # Windows PowerShell 中推荐使用 gitcode
 gitcode version
@@ -241,22 +273,9 @@ brew upgrade gc
 shell 补全（bash/zsh/fish）随安装自动配置，无需额外操作。
 Homebrew 同时提供 `gc` 与 `gitcode`；升级后可运行 `gitcode doctor install` 检查是否仍被 pip/npm 旧入口遮蔽。
 
-### npm (跨平台)
-
-一行 bootstrap（无需全局 npm 安装，自动装二进制 + 补全）：
-
-```bash
-npx @gitcode-cli/cli@latest install
-```
-
-或全局安装：
-
-```bash
-npm install -g @gitcode-cli/cli
-gitcode version
-```
+### npm 更新与 PATH 诊断
 
-如果 `gitcode version` 仍显示旧的 pip/wheel 版本，先直接调用 npm 安装目录中的新入口诊断，不必先卸载 pip：
+如果 `gitcode version` 仍显示旧版本，先直接调用 npm 安装目录中的新入口诊断，不必先卸载 pip 或手工删除旧入口：
 
 ```powershell
 # Windows PowerShell
@@ -269,6 +288,7 @@ gitcode version
 ```
 
 包内置 Linux/macOS/Windows 多平台二进制。Windows bootstrap 同时安装 `gc.exe` 和 `gitcode.exe`，PowerShell 请使用 `gitcode`，避免内置 `gc`/`Get-Content` alias。
+Linux/macOS bootstrap 会自动迁移历史安装遗留的同目录 `gitcode -> gc` 别名；该迁移参与安装事务，失败时恢复原链接，并继续拒绝指向其他位置的符号链接。
 
 npm global 与 npm bootstrap 默认使用 `notify` 模式：命令本身立即执行，24 小时 TTL 到期后在后台检查 stable `latest`，发现新版后在下一次启动提示 `gitcode update`，不会自动安装，也不会改变刚完成命令的退出码。需要自动应用的用户可明确启用 `auto`；该模式具有跨进程锁、版本健康检查和失败回滚。
 

gitcode_cli-0.12.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+gc_cli/__init__.py,sha256=s_JhW74Hhs-ifWLqNAciwWIFvrKdNrke3oaHQImuX7s,243
+gc_cli/__main__.py,sha256=fqZ9iOh0ac8K_B9WmHydaxokzIivd5QBPJoNqgXnugo,154
+gc_cli/wrapper.py,sha256=Q_NathDiUKF5C4D-TEQd5Ky_y2GN88pqS2IybKKOkRs,3155
+gc_cli/bin/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gc_cli/bin/gc-darwin-amd64,sha256=JZ7mZdBfWazWXjpJLNxEtwH4i8lo41edhn-vxw_SwPs,10001616
+gc_cli/bin/gc-darwin-arm64,sha256=KgF-6U92dPXXaTm0h8ek4Q9GNB4u6xT01ML9SotOcs8,9626450
+gc_cli/bin/gc-linux-amd64,sha256=NV70H30MgHsSFLAw-PxzPHxxo0Pwn8AKg0YEVaHStdQ,9097368
+gc_cli/bin/gc-linux-arm64,sha256=6Ao2zmwl97fx0F92YaaHINg_z0S8kL8VEHUKfFiboCQ,8650904
+gc_cli/bin/gc-windows-amd64.exe,sha256=52afGvwW-y9zt7BBLNcVlHPyxDZ2QWqbqk1thsv5QpI,9399808
+gitcode_cli-0.12.0.dist-info/licenses/LICENSE,sha256=dViNRlgMSkfn1udYjx-DEm8D6e182mc47gnLUMNjI24,1254
+gitcode_cli-0.12.0.dist-info/METADATA,sha256=cd6fwwbeaLHOwBVBRM-0YC1cwTVR3abFaxMwVB4jIVQ,19295
+gitcode_cli-0.12.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+gitcode_cli-0.12.0.dist-info/entry_points.txt,sha256=DresfT5jkpwU3fPn8n0MTao1m5QZi3XEulKFbQ8BYYY,73
+gitcode_cli-0.12.0.dist-info/top_level.txt,sha256=2fSmR3kQ-XhdgFQdVvWmZcEyERJKVZVxOhk7tna1Sus,7
+gitcode_cli-0.12.0.dist-info/RECORD,,

gitcode_cli-0.11.0.dist-info/RECORD

@@ -1,15 +0,0 @@
-gc_cli/__init__.py,sha256=SRx6SgapEnoX7KGX9Vs50Nmsjj_irrC6hWn8Dn5WaL8,243
-gc_cli/__main__.py,sha256=fqZ9iOh0ac8K_B9WmHydaxokzIivd5QBPJoNqgXnugo,154
-gc_cli/wrapper.py,sha256=Q_NathDiUKF5C4D-TEQd5Ky_y2GN88pqS2IybKKOkRs,3155
-gc_cli/bin/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-gc_cli/bin/gc-darwin-amd64,sha256=mbmV5HoqO8AK1pSnlJ6Hg6T5p1BMOrSsCAb7QflX6aw,9839120
-gc_cli/bin/gc-darwin-arm64,sha256=_PDFZsQ4kIkUFrs3sq2IoKqwCZPd4WKVdwyrU-uxgfs,9462706
-gc_cli/bin/gc-linux-amd64,sha256=Xp89s4iDL9aDo4kEwxIByLncnsg-mECgm2zdaqLCT5I,8954008
-gc_cli/bin/gc-linux-arm64,sha256=4xay9PYrQvyfVNJGgDRqtm1SY4apR_HxjtsKivGHZY8,8519832
-gc_cli/bin/gc-windows-amd64.exe,sha256=JXFMgV4-NswXeeK7ZUFkRUesk75IOHC3YYePjsisFpI,9246720
-gitcode_cli-0.11.0.dist-info/licenses/LICENSE,sha256=dViNRlgMSkfn1udYjx-DEm8D6e182mc47gnLUMNjI24,1254
-gitcode_cli-0.11.0.dist-info/METADATA,sha256=4B5olNklTItcWbRlHY4o57Ur3oWNA8ZpEQhesDF21_E,17045
-gitcode_cli-0.11.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-gitcode_cli-0.11.0.dist-info/entry_points.txt,sha256=DresfT5jkpwU3fPn8n0MTao1m5QZi3XEulKFbQ8BYYY,73
-gitcode_cli-0.11.0.dist-info/top_level.txt,sha256=2fSmR3kQ-XhdgFQdVvWmZcEyERJKVZVxOhk7tna1Sus,7
-gitcode_cli-0.11.0.dist-info/RECORD,,