# @cprecioso/paseo-gh-stack 中文文档

规范地址：https://npmcn.com/package/%40cprecioso/paseo-gh-stack/

版本：0\.2\.2
npm 元数据更新时间：2026-10-09T08:22:30.397Z
中文译文更新时间：2026-11-14T11:40:07.746Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cprecioso/paseo-gh-stack
原文对照：https://npmcn.com/package/%40cprecioso/paseo-gh-stack/?lang=original
项目主页：https://github.com/cprecioso/paseo-gh-stack
源码仓库：https://github.com/cprecioso/paseo-gh-stack

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：30.6 kB，12 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-10-08T09:31:14.224Z
- 最新版本发布：2026-10-09T08:22:29.958Z
- 近 30 天下载量：2063（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

GitHub 堆叠式 PRs 的 Paseo 工作空间面板 : 见您的分支所属的 gh 堆叠并切换其分支之间的工作空间 .

## 安装

```sh
npm install @cprecioso/paseo-gh-stack
```

也可以使用：`pnpm add @cprecioso/paseo-gh-stack`、`yarn add @cprecioso/paseo-gh-stack`、`bun add @cprecioso/paseo-gh-stack`

## README

# 纸袋

A 类 [帕西奥](https://paseo.sh/) 用于 [GitHub 堆叠式公关](https://github.com/github/gh-stack)它显示 `gh stack` 工作空间的分支属于其中的分支之间并切换工作空间.

![The Stack panel next to an agent, listing three stacked branches with their PR numbers above the trunk](https://npmcn.com/package/%40cprecioso/paseo-gh-stack/images/stack-panel.png)

## 特征

-   **堆叠面板**: 工作空间标签( 也可以在 Explorer 中找到) 列出从上到后干线的堆栈。 每个分支都显示其PR编号,以及它是否被合并,排队,或者是否需要再基. 拍出一个分行 在工作空间检查出来.
-   **GitHub 上的堆栈**: 当树枝没有被跟踪 `gh stack` 在本地,面板在 GitHub 的堆栈中查看其拉动请求,并提供一个 **检查堆栈** 运行的按钮 `gh stack checkout <number>`。 。 。 .
-   **指挥中心** (⌘K / Ctrl+K):
    -   `Open stack`
    -   `Stack: check out branch above`
    -   `Stack: check out branch below`

面板每15秒刷新一次,因此由终端或由代理人员自行出动的分机改变.

## 所需资源

在守护进程主机上 :

-   这个 [GitHub 缩写](https://cli.github.com/) (单位:千美元)`gh`(中文(简体) )
-   Gh-stack 扩展: `gh extension install github/gh-stack`

## 安装

需要Paseo 0.10.3 或晚点.

```bash
paseo plugin install npm:@cprecioso/paseo-gh-stack
```

或者来自GitHub:

```bash
paseo plugin install github:cprecioso/paseo-gh-stack
```

然后从工作空间的新tab菜单打开面板,或者运行 **打开堆栈** 从指挥中心.

## 限制

-   切换运行 `git switch <branch>` 在工作空间目录中。 Git 拒绝当未承诺的更改会被覆盖, 或者当分支已被检查出另一个工作树时; 错误被显示为祝酒词 .
-   切换分支会改变工作空间中运行的任何代理下的文件. 面板警告你 当一个代理运行.
-   在 GitHub 上发现的堆栈,只有在当前分支有拉取请求,而堆栈仍然有未合并的PR时被检测出.
-   检查 GitHub 堆栈失败, 与本地堆栈冲突时不提示; 用它解决 `gh stack checkout` 在终端.

## 许可证

麻省理工学院

## 常见问题

### @cprecioso/paseo-gh-stack 是什么？

GitHub 堆叠式 PRs 的 Paseo 工作空间面板 : 见您的分支所属的 gh 堆叠并切换其分支之间的工作空间 \.

### 如何安装 @cprecioso/paseo-gh-stack？

在项目目录运行 npm install @cprecioso/paseo-gh-stack，或使用 pnpm add / yarn add / bun add。

### @cprecioso/paseo-gh-stack 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cprecioso\_\_paseo-gh-stack 是否存在。

### @cprecioso/paseo-gh-stack 可以商用吗？

@cprecioso/paseo-gh-stack 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @cprecioso/paseo-gh-stack 的下载量有多少？

根据 npm 官方下载统计，@cprecioso/paseo-gh-stack 在 2026/10/11 – 2026/11/09 这 30 天内被下载 2,063 次，日均约 69 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cprecioso/paseo-gh-stack 还在维护吗？

最新版本 0\.2\.2 发布于 2026/10/09（1 个月前）；至今共发布 5 个版本，其中过去 12 个月发布了 5 个；首次发布于 2026/10/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。