tribucket

安装指南

安装 tribucket CLI 后，使用 tribucket install <name> 安装软件包。

# Homebrew (macOS / Linux)
brew install sixiang-world/tribucket/tribucket

# Scoop (Windows)
scoop bucket add tribucket https://github.com/sixiang-world/tribucket
scoop install tribucket

使用 Homebrew 直接安装单个软件包（macOS / Linux）。

brew tap sixiang-world/tribucket
brew install <package-name>

例如：

brew tap sixiang-world/tribucket
brew install ripgrep

使用 Scoop 直接安装单个软件包（Windows）。

scoop bucket add tribucket https://github.com/sixiang-world/tribucket
scoop install <package-name>

例如：

scoop bucket add tribucket https://github.com/sixiang-world/tribucket
scoop install fzf

一键安装脚本，适用于任意平台。

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/sixiang-world/tribucket/main/scripts/bootstrap.sh | bash

更新日志

v3.3.0软件源网站（EdgeOne 部署）
- 新增 `website/` 静态网站构建系统：`website/build.ts`（Bun 脚本）读取 `packages/*.json` + `CHANGELOG.md`，注入 `website/templates/index.html` 模板，生成纯静态 HTML，无需前端框架
- 网页内容：Hero + 版本徽章、安装指南（Homebrew / Scoop / CLI / 一键脚本四个 Tab，命令一键复制）、可搜索的软件包列表（107 个包实时过滤）、CLI 命令参考表、更新日志
- 简洁技术文档风格：`website/styles/main.css`，白底、响应式布局、移动端友好
- 产物结构：`dist/` 下同时包含 `index.html`（网页）、`Formula/*.rb`（Homebrew tap）、`bucket/*.json`（Scoop bucket）、`styles/main.css`，部署到边缘函数后 `tribucket.hunluan.space` 提供「网页 + 软件源」一体化访问
- 新增 `npm run build:web` / `bun run website/build.ts`：构建命令，CI 可直接调用
- 新增 `edgeone.json`：EdgeOne 边缘部署配置（构建命令 `npm run build:web`、输出目录 `dist`、Node 22.11.0），含缓存与安全响应头策略（主页 5 分钟短缓存，Formula/bucket 1 小时 must-revalidate，CSS 一年强缓存；X-Frame-Options/X-Content-Type-Options/Referrer-Policy 安全头）
- 更新日志独立化：从 README 迁出到独立的 `CHANGELOG.md`，README 仅保留链接。`website/build.ts` 直接解析 `CHANGELOG.md` 的 `## vX.Y.Z` 条目（自动过滤文档 H1 标题，解析 `加粗` 与版本 tag）
- `.gitignore` 新增 `dist/`（构建产物不入库）
v3.2.5Bugfix
- 修复安装版本永远为 `0.0.0`（根因）：`install.ts` 中 `const version` 阻止了从 release tag 提取版本号的赋值，改为 `let version`。`tribucket.json` 中 `version` 和 `fallback_version` 现在正确写入真实版本号
- 修复 SHA256 验证重试风暴：校验和文件下载（best-effort 操作）不再使用 5 次重试刷屏，改为单次尝试且静默模式
- `httpGet` 新增 `silent` 选项：`silent: true` 时重试只写 `log()` 不写 `status()`，适合 best-effort 调用
- `install.sh` 仅在非 Windows 平台生成
v3.2.4中文日志 + 网络错误诊断
- 中文日志本地化：自动检测系统语言（`LANG`/`LC_ALL`/`LANGUAGE` 环境变量），中文环境自动切换为中文输出（`→ 正在解析包: ccx`、`→ 下载完成: 29.2 MB` 等）。支持 `TRIBUCKET_LANG=en|zh` 强制覆盖
- 网络错误详情：`Network error` 重试提示现在显示错误代码（如 `ECONNREFUSED`、`ETIMEDOUT`），方便诊断网络问题。完整错误信息可通过 `TRIBUCKET_VERBOSE=1` 查看
- 修复安装版本为 `0.0.0`：当包定义无 `version` 字段时，安装后不再显示 `0.0.0`，而是从 GitHub release tag 中提取真实版本号
v3.2.3CLI 用户体验优化（进度提示 + 启动加速）
- 新增 `status()` 输出原语：`src/utils/log.ts` 新增始终可见的 `status(msg)` 函数（带 `→` 前缀），与 verbose-only 的 `log()` 分离
- Install 逐步提示：`→ Resolving package → Fetching latest release → Testing mirrors → Downloading → Verifying checksum → Extracting → ✓ Installed`，每一步清晰可见
- Update 逐步提示：与 install 一致，增加 `→ Fetching latest release for ` 和 `→ Using mirror/direct download` 提示
- 下载进度条增强：进度条增加文件名显示；下载开始和完成时显示 `→ Downloading...` / `→ Download complete: X MB`
- 镜像选择可视化：`→ Testing mirrors...` + `→ Mirror selected: hunluan (120ms)`，用户知道正在探测和选择了哪个镜像
- HTTP 重试可见：网络错误/限流/服务器 5xx 重试时显示 `→ Rate limited/Server error/Network error, retrying (2/5)...`
- 启动加速：`cleanupOldTmp()` 改为 `setImmediate()` 后台执行，不再阻塞命令启动
- 新增覆盖 `src/__tests__/download.test.ts`：起本地 HTTP 服务器（完整实现 RFC 7233 Range），实测两条续传分支：
- 206 + append：截断文件到一半 → `downloadFile` 发送 `Range: bytes=N-` → 服务器返回 206 → 追加剩余字节 → 最终 SHA256 与完整下载一致；同时断言服务器确实收到 Range 头且响应 206（避免用代理信号冒充实测）
- 200 fallback：服务器忽略 Range（模拟 raw.githubusercontent.com 行为）→ 重写整个文件 → SHA256 仍一致
- 测试总数 19 → 21，全套通过
v3.2.1测试覆盖补齐 + dry-run 修复
- 修复 `update --dry-run` 崩溃（`checkPackage` 未传 options，解引用 `options.localOnly` 报 TypeError）
- 新增覆盖：`--proxy`、`--mirror direct/auto`、`install --dir/--force`、`update --no-backup`、系统目录防护（`/usr`/`/etc`/`C:\Windows`）、`update --dry-run`、`NO_COLOR`、文件锁（acquire/release/stale PID/live PID）、损坏 config 降级、`clean` 清理 stale、`info` —— Windows 与 Linux 双端全绿。
v3.2.0跨平台稳定性大修
- 下载 URL：不再硬编码 `v` 版本前缀，使用 release 的原始 tag（修复 jq `jq-1.8.1`、ripgrep `15.1.0` 等 404）
- 资源解析：`asset_pattern` 现在对真实 release 资源列表做匹配（字面量 / glob `*` / 后缀），`fzf-*`、`x86_64-pc-windows-msvc.zip` 等模式均能解析
- Linux 解压：移除 GNU tar 不支持的 `--no-absolute-names`（之前导致所有 tar 包解压崩溃）
- Windows 二进制：安装时自动补 `.exe` 后缀；版本检测使用 `resolveBinaryPath` 探测 `.exe`
- `--json` 输出：修复被全局同名选项遮蔽的问题（`check --json` / `list --json` 现输出正确 JSON）
- `--all`：按包名而非 repo key 迭代，修复 `check/update --all` 的路径误判
- 版本比较：`versionFromTag` 从任意 tag 提取可比较的版本号；缓存读取自愈归一化
- 网络韧性：HTTP 重试 3→5 次 + jitter 退避，403/429 限流也重试
- 更新后校验：版本探测带重试，Windows 跳过不可靠的 `X_OK`，不再误报 `Version mismatch`
- 清理仓库根目录误建的 `NUL` 文件并加入 `.gitignore`

安装指南

软件包列表

CLI 命令参考

更新日志