docs: extract CLI install steps into references/cli-install.md

2026-07-01 15:36:21 +08:00
parent 2624bca7d4
commit dc392a5075
2 changed files with 38 additions and 39 deletions
@@ -0,0 +1,36 @@
+# htsy-cli 安装
+
+仅在本机缺少 `htsy-cli` 时读取本文件。Release 页面：`https://git.ikuban.com/server/htsy-cli/releases`。
+
+附件按 `htsy-cli_<系统>_<架构>` 命名，Windows 带 `.exe`：
+
+| 系统 | 架构 | 附件名 |
+| --- | --- | --- |
+| macOS Intel | x86_64 | `htsy-cli_darwin_amd64` |
+| macOS Apple Silicon | arm64 | `htsy-cli_darwin_arm64` |
+| Linux x86_64 | x86_64 | `htsy-cli_linux_amd64` |
+| Linux arm64 | arm64 | `htsy-cli_linux_arm64` |
+| Windows x86_64 | x86_64 | `htsy-cli_windows_amd64.exe` |
+| Windows arm64 | arm64 | `htsy-cli_windows_arm64.exe` |
+
+Linux/macOS 安装示例：
+
+```bash
+ASSET_URL="从 https://git.ikuban.com/server/htsy-cli/releases 复制对应 htsy-cli_* 附件下载链接"
+mkdir -p "$HOME/.local/bin"
+curl -fL "$ASSET_URL" -o "$HOME/.local/bin/htsy-cli"
+chmod +x "$HOME/.local/bin/htsy-cli"
+"$HOME/.local/bin/htsy-cli" version
+```
+
+Windows PowerShell 安装示例：
+
+```powershell
+$AssetUrl = "从 https://git.ikuban.com/server/htsy-cli/releases 复制 htsy-cli_windows_amd64.exe 下载链接"
+New-Item -ItemType Directory -Force "$HOME\bin" | Out-Null
+Invoke-WebRequest -Uri $AssetUrl -OutFile "$HOME\bin\htsy-cli.exe"
+$env:Path = "$HOME\bin;$env:Path"
+htsy-cli.exe version
+```
+
+如果当前系统或架构没有匹配附件，不要猜测下载地址或改用其他架构，先让用户提供可用 release 附件。