# Chronix CommandeLine Packages

**Repository Path**: project-chronix/chronix-cmd-pkg

## Basic Information

- **Project Name**: Chronix CommandeLine Packages
- **Description**: ChronixArch命令行工具补充包
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-21
- **Last Updated**: 2026-10-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Chronix Cmdline Repo
====================

Chronix 的命令行软件包仓库（Gitee 仓库名 `chronix-cmd-pkg`）。

当前内容
--------

| 包 | 版本 | 说明 |
| --- | --- | --- |
| paru | 2.1.0-2 | AUR 助手。Arch 官方仓库没有此包，从 AUR 构建后原样搬运 |
| packtide | 0.1.2-1 | 包管理与系统维护 TUI：可搜索的包选择器、预览、确认后执行事务（另含 systide 系统更新） |
| cfetch | 2.0-1 | 带 Chronix logo 的系统信息工具，fastfetch 风格布局（取代 fastfetch） |
| cup | 2.0-1 | 执行命令后调用 OpenCode 生成一句总结（Chronix 自研，依赖 opencode/python/util-linux） |

用法
----

在 `/etc/pacman.conf` 末尾加入：

```
[cmdline]
SigLevel = Optional TrustAll
Server = https://raw.giteeusercontent.com/project-chronix/chronix-cmd-pkg/raw/master
```

然后：

```
sudo pacman -Sy
sudo pacman -S paru packtide cfetch cup
```

说明
----

- **仓库段名必须是 `cmdline`**（全小写），与数据库文件名 `cmdline.db` 一致。
  pacman 按段名精确匹配文件名，大小写不一致会直接 404。
- **段名不带连字符**是有原因的：Gitee 的 raw 对含连字符的 `.db` 文件名会返回
  404（`chronix-gnome.db` 404，而 `chronix-gnome.files` 200）。所以数据库叫
  `cmdline` 而不是 `chronix-cmdline`。仓库名本身可以有连字符
  （`chronix-cmd-pkg`），只有数据库文件不能有。
- **`cmdline.db` 和 `cmdline.db.tar.zst` 都作为真实文件保留**（不是符号链接）。
  pacman 7.1 只会抓无后缀的 `<段名>.db`，没有 `.db.tar.zst` 的 fallback，所以
  两个名字都得真实存在。
- **上游搬运包不重复收录依赖**。paru 依赖的 git、pacman、libalpm 全部由
  core/extra 提供，本仓库只放 paru 本身。packtide 依赖 fzf/pacman/sudo、
  cfetch 依赖 python，同样由官方仓库解析。
- **包名和版本保持上游**：paru 是 AUR 原包，packtide 和 cfetch 保持各自
  项目的版本号，没有改名也没有抬高 pkgrel。
- **cup 是自研包**：按 Chronix 自研包规则使用 `2.0-1`；依赖的 `opencode`
  由 `extra` 提供。命令输出会发送给 OpenCode，敏感输出不要用 `cup` 跑；
  `opencode-ask` 目前用 `--agent build`，有工具权限，对不可信输出存在提示注入风险。

历史
----

- 2026-10-21：数据库名由 `store` 改为 `Cmdline`，随后又按要求改为全小写的
  `cmdline`；Gitee 仓库名由 `chronix-store-repo` 改为 `chronix-cmd-pkg`。
- `packtide 0.1.2-1` 和 `cfetch 2.0-1` 原本发布在主仓库
  `chronix-arch-system-package-repo`，2026-10-21 迁到本仓库，主仓库的
  `chronix.db` 里已不再包含这两个包。
- 2026-10-22：`cup 2.0-1` 从主仓库 `chronix-arch-system-package-repo`
  迁入；主仓库 `chronix.db` 里已不再包含 cup。

维护
----

更新包时：

```
repo-add --nocolor cmdline.db.tar.zst <包文件名>.pkg.tar.zst
cp --remove-destination cmdline.db.tar.zst cmdline.db
cp --remove-destination cmdline.files.tar.zst cmdline.files
rm -f *.old
```

`repo-add` 生成的 `.db` / `.files` 是指向 `.tar.zst` 的符号链接，必须用
`cp --remove-destination` 还原成真实文件再提交。