docs: install via git clone only, never publish to PyPI
- README/README_CN: replace pip install with clone + pipx install flow - document direct 'pipx install git+URL' alternative and browser extra - user-level skill prerequisite points at repo install path
This commit is contained in:
+24
-4
@@ -8,12 +8,32 @@
|
||||
|
||||
## 安装
|
||||
|
||||
本项目**不发布到 PyPI**——通过克隆仓库安装(推荐先用 [pipx](https://pipx.pypa.io/) 隔离环境;或用 venv + pip):
|
||||
|
||||
```bash
|
||||
pip install hy3d # 纯 API 客户端
|
||||
pip install "hy3d[browser]" # 额外安装浏览器工具(登录/抓包/浏览器自动化)
|
||||
# 1. 克隆仓库
|
||||
git clone https://gitea.akasei.top/KawasakiAkasei/hy3d.git
|
||||
cd hy3d
|
||||
|
||||
# 2. 安装(pipx 装进独立 venv,hy3d 命令进 PATH)
|
||||
pipx install ".[browser]"
|
||||
|
||||
# 3. 验证
|
||||
hy3d auth status
|
||||
```
|
||||
|
||||
不安装也能用——克隆仓库后直接用源码跑(无需 `pip install`):
|
||||
不想保留仓库副本也能直接装:
|
||||
|
||||
```bash
|
||||
pipx install "git+https://gitea.akasei.top/KawasakiAkasei/hy3d.git"
|
||||
```
|
||||
|
||||
> **「browser」扩展**提供登录/抓包/浏览器自动化(cloakbrowser + playwright);
|
||||
> 只调用 API 可以省略。已装过纯客户端、想补 browser 扩展:
|
||||
> `cd hy3d && pipx install --force ".[browser]"`。
|
||||
> **私有仓库**场景:clone 用 SSH —— `git clone git@gitea.akasei.top:KawasakiAkasei/hy3d.git`;git 直装同理。
|
||||
|
||||
不安装也能用——直接以源码方式运行(无需 pip install):
|
||||
|
||||
```bash
|
||||
cd hy3d
|
||||
@@ -137,7 +157,7 @@ CLI 等价写法:`hy3d --cookies /path/to/cookies.txt quota`,或环境变量
|
||||
| `hy3d-sniffer` | API 请求/响应抓包(`api_requests.log.json`) |
|
||||
| `hy3d-generate <img> [wait]` | 浏览器内图生 3D(走浏览器签名,适合对照验证) |
|
||||
|
||||
需要 `pip install "hy3d[browser]"`(cloakbrowser + playwright)。
|
||||
需要 browser 扩展(安装时加 `[browser]`,见上文安装节)。
|
||||
|
||||
## 配置与目录
|
||||
|
||||
|
||||
Reference in New Issue
Block a user