update pig 1.5 docs batch 2

Author: Vonng

content/docs/about/sponsor.md

@@ -37,9 +37,9 @@ Pigsty 是由 [**奇绩创坛**](https://www.miracleplus.com/en/) （原 YC 中
 
 感谢我们的赞助者 Vercel，为 Pigsty 网站提供了赞助与网站托管基础设施。
 
-[![Vercel OSS Program](https://vercel.com/oss/program-badge.svg)](https://vercel.com/oss)
+[![Vercel OSS Program](/img/icon/vercel.svg)](https://vercel.com/oss)
 
 
 感谢我们的赞助者 Jet Brains，为 Pigsty 提供了 JetBrains Open Source License 计划的支持。
 
-[![JetBrains logo.](https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.svg)](https://jb.gg/OpenSource)
+[![JetBrains logo.](/img/icon/jetbrains.svg)](https://jb.gg/OpenSource)

content/docs/pig/_index.md

@@ -8,7 +8,7 @@ module: [PIG]
 
 —— **Postgres Install Genius，PostgreSQL 生态中缺失的扩展包管理器**
 
-PIG 包管理器是一个专门用于安装、管理、构建 PostgreSQL 及其扩展的命令行工具，使用 Go 开发，开箱即用，简单易用，小巧玲珑（4MB）。
+PIG 包管理器是一个专门用于安装、管理、构建 PostgreSQL 及其扩展的命令行工具，使用 Go 开发，开箱即用，简单易用，小巧玲珑（约 5MB）。
 PIG 包管理器并非重新发明的土鳖轮子，而是 **依托** （PiggyBack）现有 Linux 发行版包管理器 （`apt`/`dnf`）的一个高级抽象层。
 它屏蔽了不同操作系统，不同芯片架构，以及不同 PG 大版本的管理差异，让您用简单的几行命令，就可以完成 PG 内核与 531 个扩展的安装与管理。
 
@@ -57,10 +57,12 @@ $ pig install -y vector               # 您可以使用扩展名称（vector）
 - [**pig repo**](/docs/pig/repo/)：管理 APT/YUM 软件仓库
 - [**pig ext**](/docs/pig/ext/)：管理 PostgreSQL 扩展
 - [**pig build**](/docs/pig/build/)：从源码构建扩展
+- [**pig install**](/docs/pig/cmd/#pig-install)：通过原生包管理器安装 PostgreSQL 与扩展包
 
 **Pigsty 管理**：
 
 - [**pig sty**](/docs/pig/sty/)：管理 Pigsty 安装
+- [**pig context**](/docs/pig/cmd/#pig-context)：采集主机、PostgreSQL、Patroni、pgBackRest 与扩展上下文
 - [**pig pg**](/docs/pig/pg/)：管理本地 PostgreSQL 服务
 - [**pig pt**](/docs/pig/pt/)：管理 Patroni HA 集群
 - [**pig pb**](/docs/pig/pb/)：管理 pgBackRest 备份

content/docs/pig/build.md

@@ -14,7 +14,7 @@ pig build - Build Postgres Extension
 
 Environment Setup:
   pig build spec                   # init build spec and directory (~ext)
-  pig build repo                   # init build repo (=repo set, with remove+update)
+  pig build repo                   # init build repo (=repo set -ru)
   pig build tool  [mini|full|...]  # init build toolset
   pig build rust  [-y]             # install Rust toolchain
   pig build pgrx  [-v <ver>]       # install & init pgrx (0.19.1)
@@ -31,18 +31,18 @@ Quick Start:
   pig build pkg citus              # build citus extension
 ```
 
-| 命令 | 描述 | 备注 |
-|:---|:---|:---|
-| `build spec` | 初始化构建规范仓库 | |
-| `build repo` | 初始化所需仓库 | 需要 sudo 或 root 权限 |
-| `build tool` | 初始化构建工具 | 需要 sudo 或 root 权限 |
-| `build rust` | 安装 Rust 工具链 | 需要 sudo 或 root 权限 |
-| `build pgrx` | 安装并初始化 pgrx | 需要 sudo 或 root 权限 |
-| `build proxy` | 初始化构建代理 | |
-| `build get` | 下载源代码 tarball | |
-| `build dep` | 安装扩展构建依赖 | 需要 sudo 或 root 权限 |
-| `build ext` | 构建扩展包 | 需要 sudo 或 root 权限 |
-| `build pkg` | 完整构建流程：get、dep、ext | 需要 sudo 或 root 权限 |
+| 命令            | 描述                 | 备注                |
+|:--------------|:-------------------|:------------------|
+| `build spec`  | 初始化构建规范目录          |                   |
+| `build repo`  | 初始化所需仓库            | 需要 sudo 或 root 权限 |
+| `build tool`  | 初始化构建工具            | 需要 sudo 或 root 权限 |
+| `build rust`  | 安装 Rust 工具链        | 需要 sudo 或 root 权限 |
+| `build pgrx`  | 安装并初始化 pgrx        | 需要 sudo 或 root 权限 |
+| `build proxy` | 初始化构建代理            |                   |
+| `build get`   | 下载源代码 tarball      |                   |
+| `build dep`   | 安装扩展构建依赖           | 需要 sudo 或 root 权限 |
+| `build ext`   | 构建扩展包              | 需要 sudo 或 root 权限 |
+| `build pkg`   | 完整构建流程：get、dep、ext | 需要 sudo 或 root 权限 |
 {.full-width}
 
 
@@ -58,8 +58,8 @@ pig build spec
 pig build pkg citus
 
 # 构建的包将位于：
-# - EL: ~/rpmbuild/RPMS/
-# - Debian: ~/
+# - EL: ~/ext/pkg/（同时可从 ~/rpmbuild/RPMS/ 访问）
+# - Debian: ~/ext/pkg/（同时可从 ~/debbuild/DEBS/ 访问）
 ```
 
 更精细的控制方式：
@@ -85,48 +85,60 @@ pig build pkg citus              # get + dep + ext
 ### 目录结构
 
 ```
-~/ext/                           # 默认构建规范目录
-├── Makefile                     # 主构建 makefile
-├── <extension>/                 # 每个扩展的目录
-│   ├── Makefile                # 扩展特定的 makefile
-│   ├── <extension>.spec        # RPM 规范文件（EL）
-│   └── debian/                 # Debian 打包文件
-│       ├── control
-│       ├── rules
-│       └── ...
+~/ext/                           # 真实工作目录
+├── pkg/                         # 构建产物输出目录
+├── src/                         # 源码 tarball 下载目录
+├── log/                         # 构建日志目录
+└── tmp/                         # 临时目录
+
+~/rpmbuild/                      # EL 构建目录
+├── RPMS -> ~/ext/pkg            # RPM 产物软链接
+├── SOURCES -> ~/ext/src         # 源码软链接
+├── SPECS/
+├── BUILD/
+├── BUILDROOT/
+└── SRPMS/
+
+~/debbuild/                      # Debian / Ubuntu 构建目录
+├── DEBS -> ~/ext/pkg            # DEB 产物软链接
+├── SOURCES -> ~/ext/src         # 源码软链接
+├── SPECS/
+└── BUILD/
 ```
 
 **构建输出位置：**
-- **EL 系统**：`~/rpmbuild/RPMS/<arch>/`
-- **Debian 系统**：`~/`（deb 文件）
+- **EL 系统**：`~/ext/pkg/`，并通过 `~/rpmbuild/RPMS/` 软链接访问
+- **Debian 系统**：`~/ext/pkg/`，并通过 `~/debbuild/DEBS/` 软链接访问
 
 
 ## build spec
 
-设置构建规范仓库和目录结构。
+设置构建规范与目录结构。
 
 ```bash
 pig build spec                   # 在默认位置初始化 ~/ext
+pig build spec -f                # 强制重新下载构建规范 tarball
+pig build spec -m                # 优先使用 pigsty.cc 中国镜像
 ```
 
 **功能：**
-1. 克隆或更新扩展构建规范仓库
-2. 创建必要的目录结构
-3. 设置 makefile 和构建脚本
-4. 准备平台特定的打包文件
+1. 下载 RPM 或 DEB 构建规范 tarball
+2. 创建 `~/ext/{pkg,src,log,tmp}` 与平台构建目录
+3. 将 `RPMS/DEBS` 与 `SOURCES` 软链接到 `~/ext/pkg` 和 `~/ext/src`
+4. 通过增量 `rsync` 同步 makefile、spec 与 Debian 打包文件
 
-**仓库位置：** 默认 `~/ext/`，包含 100+ 扩展的构建规范。
+**工作目录：** 默认使用 `~/ext/` 保存源码、产物、日志与临时文件；平台打包目录为 `~/rpmbuild/` 或 `~/debbuild/`。
 
 
 ## build repo
 
 初始化构建扩展所需的包仓库。
 
 ```bash
-pig build repo                   # 等同于：pig repo set（内部执行 remove+update）
+pig build repo                   # 等同于：pig repo set -ru
 ```
 
-**功能：** 移除现有仓库、添加所有必需仓库（pgdg、pigsty、node）、更新包缓存。
+**功能：** 以 `pig repo set -ru` 初始化构建所需仓库：移除旧仓库、添加所需仓库并更新包缓存。
 
 
 ## build tool
@@ -165,7 +177,9 @@ pig build rust -y                # 强制重新安装 Rust 工具链
 
 ```bash
 pig build pgrx                   # 安装最新稳定版 (0.19.1)
-pig build pgrx -v 0.15.0         # 安装特定版本
+pig build pgrx -v 0.19.1         # 安装特定版本
+pig build pgrx --pg 18,17,16     # 为指定 PG 版本初始化 pgrx
+pig build pgrx --pg init         # 只执行 cargo pgrx init，不传 PG 参数
 ```
 
 **前提条件：** 必须先安装 Rust 工具链、PostgreSQL 开发头文件。
@@ -177,8 +191,8 @@ pig build pgrx -v 0.15.0         # 安装特定版本
 
 ```bash
 pig build proxy                  # 交互式设置
-pig build proxy user@host:8080   # 直接配置
-pig build proxy http://proxy.company.com:3128
+pig build proxy user@host:8080   # 使用默认本地端口 127.0.0.1:12345
+pig build proxy user@host:8080 127.0.0.1:1080
 ```
 
 
@@ -189,20 +203,23 @@ pig build proxy http://proxy.company.com:3128
 ```bash
 pig build get citus              # 单个扩展
 pig build get citus pgvector     # 多个扩展
-pig build get all                # 所有可用扩展
-pig build get std                # 标准扩展
 pig build get pdu pgdog          # 使用内置源码 alias
+pig build get citus -f           # 已存在时仍重新下载
+pig build get citus -m           # 优先使用 pigsty.cc 中国镜像
 ```
 
-一些源码包并不直接对应扩展名，`pig build get` 内置了少量特殊 alias 以便直接下载源码。`v1.3.2` 新增了 `pdu` 与 `pgdog` 两个 alias。
+`pig build get` 的参数是扩展名、包名或源码文件名；未知名称会按源码文件名处理。它不会把 `all` 或 `std` 展开为内置集合。需要批量下载时，请显式列出目标包名。
+
+一些源码包并不直接对应扩展名，`pig build get` 内置了特殊 alias 以便直接下载源码。
 
 ```bash
 pig build get pdu                # 下载 pdu-3.0.25.12.tar.gz
 pig build get pgdog              # 下载 pgdog-0.1.32.tar.gz
 pig build get pgedge             # 同时下载 PostgreSQL 与 spock 源码
+pig build get onesparse          # 同时下载 onesparse、graphblas、lagraph
 ```
 
-当前常见的特殊源码 alias 包括：`babelfishpg` / `babelfish`、`agensgraph` / `agens`、`pgedge`、`pdu`、`pgdog`。
+当前常见的特殊源码 alias 包括：`babelfishpg` / `babelfish`、`agensgraph` / `agentsgraph`、`oriolepg` / `orioledb`、`cloudberry`、`pgedge`、`pdu`、`pgdog`、`rdkit`、`onesparse`、`libfepgutils`。
 
 
 ## build dep
@@ -215,6 +232,10 @@ pig build dep citus pgvector     # 多个扩展
 pig build dep citus --pg 17,16   # 为特定 PG 版本
 ```
 
+**选项：**
+
+- `--pg`：指定一个或多个 PostgreSQL 大版本；未指定时按扩展元数据或本机安装自动推断
+
 
 ## build ext
 
@@ -227,6 +248,11 @@ pig build ext citus --pg 17      # 为特定 PG 版本
 pig build ext citus -s           # 包含调试符号（仅 RPM）
 ```
 
+**选项：**
+
+- `--pg`：指定一个或多个 PostgreSQL 大版本
+- `-s|--symbol`：构建调试符号包（仅 RPM）
+
 
 ## build pkg
 
@@ -237,8 +263,15 @@ pig build pkg citus              # 构建单个扩展
 pig build pkg citus pgvector     # 构建多个
 pig build pkg citus --pg 17,16   # 为多个 PG 版本
 pig build pkg citus -s           # 包含调试符号
+pig build pkg citus -m           # 优先使用 pigsty.cc 中国镜像下载源码
 ```
 
+**选项：**
+
+- `--pg`：指定一个或多个 PostgreSQL 大版本
+- `-s|--symbol`：构建调试符号包（仅 RPM）
+- `-m|--mirror`：下载源码时优先使用 `pigsty.cc` 镜像
+
 
 ## 常见工作流
 
@@ -254,8 +287,8 @@ pig build tool
 pig build pkg pg_partman
 
 # 3. 安装构建的包
-sudo rpm -ivh ~/rpmbuild/RPMS/x86_64/pg_partman*.rpm  # EL
-sudo dpkg -i ~/pg_partman*.deb                         # Debian
+sudo rpm -ivh ~/ext/pkg/pg_partman*.rpm  # EL
+sudo dpkg -i ~/ext/pkg/*partman*.deb     # Debian
 ```
 
 ### 工作流 2：构建 Rust 扩展
@@ -329,7 +362,7 @@ export PG_CONFIG=/usr/pgsql-18/bin/pg_config
 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
 
 # 更新 PGRX
-cargo install cargo-pgrx --force
+cargo install --locked cargo-pgrx@0.19.1
 
 # 重新初始化 PGRX
 cargo pgrx init

content/docs/pig/cmd.md

@@ -12,11 +12,13 @@ categories: [参考]
 - [**pig repo**](/docs/pig/repo/)：管理软件仓库
 - [**pig ext**](/docs/pig/ext/)：管理 PostgreSQL 扩展
 - [**pig build**](/docs/pig/build/)：从源码构建扩展
+- **pig install**：使用原生包管理器安装包，并对 PostgreSQL 别名做翻译
 - [**pig sty**](/docs/pig/sty/)：管理 Pigsty 安装
 - [**pig pg**](/docs/pig/pg/)：管理本地 PostgreSQL 服务器
 - [**pig pt**](/docs/pig/pt/)：管理 Patroni HA 集群
 - [**pig pb**](/docs/pig/pb/)：管理 pgBackRest 备份与恢复
-- [**pig pitr**](/docs/pig/pb/)：进行完整 PITR 工作流
+- [**pig pitr**](/docs/pig/pitr/)：进行完整 PITR 工作流
+- **pig context**：输出面向人工和 Agent 的环境上下文快照
 
 
 
@@ -44,12 +46,13 @@ PostgreSQL Extension Manager
 
 Pigsty Management Commands
   do          运行管理任务
-  patroni     使用 patronictl 管理 Patroni 集群
-  pg_exporter 管理 pg_exporter 与监控指标
-  pgbackrest  管理 pgBackRest 备份与恢复
+  pg          管理本地 PostgreSQL 服务器与数据库
+  pt          使用 patronictl 管理 Patroni 集群
+  pb          管理 pgBackRest 备份与恢复
+  pe          管理 pg_exporter 与监控指标
   pitr        编排式时间点恢复
-  postgres    管理本地 PostgreSQL 服务器与数据库
   sty         管理 Pigsty 安装
+  context     显示环境上下文快照
 
 Additional Commands:
   completion  生成指定 shell 的自动补全脚本
@@ -64,9 +67,9 @@ Flags:
   -h, --help               获取帮助信息
   -H, --home string        Pigsty 主目录路径
   -i, --inventory string   配置清单路径
-  -t, --toggle             帮助信息中的占位参数
       --log-level string   日志级别: debug, info, warn, error, fatal, panic (默认 "info")
       --log-path string    日志文件路径，默认为终端输出
+  -o, --output string      输出格式：text, yaml, json, json-pretty（默认 "text"）
 
 使用 "pig [command] --help" 获取命令的详细信息。
 ```
@@ -131,6 +134,20 @@ pig build ext citus              # 构建包
 ```
 
 
+## pig install
+
+使用系统原生包管理器安装软件包，并对 PostgreSQL 内核、扩展及常用别名做包名翻译。需要直接传递系统包名时，可使用 `-n/--no-translation`。
+
+```bash
+pig install pg_duckdb            # 安装扩展并自动翻译包名
+pig install pg18                 # 安装 PostgreSQL 18 内核包组
+pig install nginx htop vim       # 安装多个系统包
+pig install unknown-package -n   # 禁用翻译，按原始包名安装
+pig install pg18 --plan          # 预览安装计划
+pig install pg_vector -y         # 自动确认安装
+```
+
+
 ## pig sty
 
 安装 Pigsty 发行版，详情请参考 [`pig sty`](/docs/pig/sty/)
@@ -143,6 +160,18 @@ pig sty deploy                   # 运行部署 playbook
 ```
 
 
+## pig context
+
+输出环境上下文快照，覆盖主机、PostgreSQL、Patroni、pgBackRest 与已安装扩展。该命令适合排障和自动化脚本快速了解当前节点状态。
+
+```bash
+pig context                      # 文本输出
+pig context -o json              # JSON 输出
+pig context -m postgres          # 只输出 PostgreSQL 模块（默认包含 host）
+pig context -m postgres,!host    # 排除 host 模块
+```
+
+
 ## pig pg
 
 管理本地 PostgreSQL 服务器，详情请参考 [`pig pg`](/docs/pig/pg/)