# @alasano/pi-linear 中文文档

规范地址：https://npmcn.com/package/%40alasano/pi-linear/

版本：0\.5\.0
npm 元数据更新时间：2026-08-08T23:40:12.537Z
中文译文更新时间：2026-11-06T16:36:01.183Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40alasano/pi-linear
原文对照：https://npmcn.com/package/%40alasano/pi-linear/?lang=original
项目主页：https://github.com/alasano/house-of-pi#readme
源码仓库：https://github.com/alasano/house-of-pi

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

- 包体积（解压后）：874 kB，45 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- peer 依赖：@earendil-works/pi-coding-agent \>=0\.79\.9，@earendil-works/pi-tui \>=0\.79\.9，typebox \>=1\.1\.38
- 首次发布：2026-04-03T21:47:37.587Z
- 最新版本发布：2026-08-08T23:40:12.228Z
- 近 30 天下载量：2730（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

Pi 有64+工具、多工作空间认证和每个工具设置的线性集成

## 安装

```sh
npm install @alasano/pi-linear
```

也可以使用：`pnpm add @alasano/pi-linear`、`yarn add @alasano/pi-linear`、`bun add @alasano/pi-linear`

## README

# pi- 线性

![pi-linear settings overlay](https://npmcn.com/package/%40alasano/pi-linear/assets/screenshot.png)

_配置线性工具和设置上覆盖的输出默认值._

* * *

![Human-readable Linear issue list](https://npmcn.com/package/%40alasano/pi-linear/assets/linear_list_issues.png)

_人可读出的问题结果使截图保持干净,而完整的JSON仍然可用Ctrl+O._

线性集成 [毕](https://pi.dev/) 有64+工具,涵盖问题、项目、文件、倡议、评论、关系等。 包括多工作空间认证和每个工具设置覆盖.

## 先决条件

您需要线性 API 密钥 。 要创建一个:

1.  转到 **线性设置 > 账户 > 安全访问 > API**
2.  点击 **创建密钥** 并给其取名(如"pi")
3.  下 **权限**选择 **只选择权限** 与 **读取** 财务报告和审定财务报表 **写入** 启用 。 离开 **管理员** 不受约束.
4.  下 **团队准入**选择 **所有可以进入的队伍** 或特定小组的范围,如果您愿意的话
5.  点击 **创建** 复制密钥

## 安装

```bash
pi install npm:@alasano/pi-linear
```

## 认证

扩展可使用存储的工作空间或 `LINEAR_API_KEY` 环境变量。 默认优先使用存储的工作空间, 因此即使多账户切换 `LINEAR_API_KEY` 在全球设定.

使用 `/linear-auth` 命令来管理工作空间并选择认证偏好 :

| 命令 | 说明 |
| --- | --- |
| `/linear-auth add <name>` | 添加 API 密钥的工作空间( 密钥提示) |
| `/linear-auth remove <name>` | 删除工作空间( 名称省略后显示选择器) |
| `/linear-auth switch <name>` | 切换活动工作空间并选择存储的工作空间 |
| `/linear-auth prefer workspace|env` | 选择存储的工作空间或 `LINEAR_API_KEY` 首先尝试 |
| `/linear-auth status` | 显示认证偏好、 活动源和配置的工作空间 |
| `/linear-auth` | 与地位相同 |

当您添加您的第一个工作空间时, 它会自动活动 。 添加第二个工作空间会促使您切换 。 之后a `/reload` 如果配置了两个或两个以上的工作空间,代理将获得一个 `linear_switch_workspace` 工具,在被询问时可以在它们之间切换.

默认认证解析命令( E)`/linear-auth prefer workspace`:

1.  活动存储的工作空间( 如果配置了任何工作空间)
2.  `LINEAR_API_KEY` 环境变量( 无工作空间活动时返回)
3.  交互式提示( 请您设置密钥)

环境认证解析命令( E)`/linear-auth prefer env`:

1.  `LINEAR_API_KEY` 环境变量
2.  活动存储的工作空间( 当 `LINEAR_API_KEY` 未设置)
3.  交互式提示( 请您设置密钥)

证书和认证首选项保存于 `~/.pi/agent/extensions/linear/credentials.json`。 。 。 .

## 工具设置

运行 `/linear-settings` 打开一个覆盖,您可以选择默认输出视图,并按类别或个人启用或禁用工具。 线性结果默认为可被人读取的视图,完整的JSON可以通过 `Ctrl+O`;如果喜欢,可以将默认翻到全JSON. 被禁用的工具完全从LLM的上下文中去除. 各届会议始终保持优惠.

## 工具(64个)

在工具 schemas 镜像 Linear 中的 Enum 值,排序键,以及过滤值提示 .

### 问题

| 工具 | 说明 |
| --- | --- |
| `linear_list_issues` | 列出过滤器、页码和排序的问题 |
| `linear_get_issue` | 通过标识符(ENG-123)或代号获取完整的发行细节 |
| `linear_create_issue` | 创建一个问题, 并给予充分的问题创造投入支持 |
| `linear_update_issue` | 全面更新一个问题 |
| `linear_delete_issue` | 删除一个问题( 管理员可以永久删除 ) |
| `linear_archive_issue` | 归档或倒置问题 |
| `linear_unarchive_issue` | 恢复存档问题 |
| `linear_search_issues` | 按文本搜索问题, 可选的注释搜索和团队助推 |

### 问题标签

| 工具 | 说明 |
| --- | --- |
| `linear_list_issue_labels` | 带有团队过滤器的列表标签 |
| `linear_create_issue_label` | 创建问题标签 |
| `linear_update_issue_label` | 更新问题标签 |
| `linear_delete_issue_label` | 删除问题标签 |

### 问题状况

| 工具 | 说明 |
| --- | --- |
| `linear_list_issue_statuses` | 列表工作流程状态( 问题状态) |

### 问题关系

| 工具 | 说明 |
| --- | --- |
| `linear_list_issue_relations` | 列表问题关系 |
| `linear_create_issue_relation` | 创建关系( 块、 重复、 关联、 类似) |
| `linear_update_issue_relation` | 更新关系 |
| `linear_delete_issue_relation` | 删除关系 |

### 项目

| 工具 | 说明 |
| --- | --- |
| `linear_list_projects` | 列出带有过滤器、页码和排序的工程 |
| `linear_get_project` | 通过 id 获取全部项目细节 |
| `linear_save_project` | 创建或更新工程 |
| `linear_delete_project` | 删除工程 |
| `linear_archive_project` | 归档或丢弃工程 |
| `linear_unarchive_project` | 恢复存档工程 |

列表和搜索结果包括: `pageInfo` 在用于光标页化的 JSON 输出中。 项目清单结果使用限定范围的摘要选择,以及 `linear_get_project` 加上项目的节省结果包括项目的减记 `content` 躯体.

### 项目标签

| 工具 | 说明 |
| --- | --- |
| `linear_list_project_labels` | 列出项目标签 |
| `linear_create_project_label` | 创建工程标签 |
| `linear_update_project_label` | 更新工程标签 |
| `linear_delete_project_label` | 删除工程标签 |

### 项目关系

| 工具 | 说明 |
| --- | --- |
| `linear_list_project_relations` | 列出项目关系 |
| `linear_create_project_relation` | 创建工程关系 |
| `linear_update_project_relation` | 更新项目关系 |
| `linear_delete_project_relation` | 删除工程关系 |

### 文档

| 工具 | 说明 |
| --- | --- |
| `linear_list_documents` | 列出带有过滤器和页码的文档 |
| `linear_get_document` | 通过 id 获取完整的文档细节 |
| `linear_create_document` | 创建文档 |
| `linear_update_document` | 更新文档 |
| `linear_delete_document` | 删除文档 |
| `linear_unarchive_document` | 恢复存档文档 |

### 评论

| 工具 | 说明 |
| --- | --- |
| `linear_list_comments` | 带有过滤和页码的列表注释 |
| `linear_create_comment` | 创建一个问题的评论,项目更新等. |
| `linear_update_comment` | 更新评论 |
| `linear_delete_comment` | 删除注释 |

### 倡议

| 工具 | 说明 |
| --- | --- |
| `linear_list_initiatives` | 列出带有过滤器、页码和排序的举措 |
| `linear_get_initiative` | 由 id 获得完整倡议细节 |
| `linear_save_initiative` | 创建或更新倡议 |
| `linear_delete_initiative` | 删除主动 |
| `linear_archive_initiative` | 归档倡议 |
| `linear_unarchive_initiative` | 恢复存档的举措 |

### 里程碑

| 工具 | 说明 |
| --- | --- |
| `linear_list_milestones` | 列出项目里程碑 |
| `linear_get_milestone` | 由 id 获取里程碑细节 |
| `linear_save_milestone` | 创建或更新里程碑 |
| `linear_delete_milestone` | 删除一个里程碑 |

### 团队

| 工具 | 说明 |
| --- | --- |
| `linear_list_teams` | 工作流程状态的列表团队 |
| `linear_get_team` | 由 id 获取团队细节 |

### 用户

| 工具 | 说明 |
| --- | --- |
| `linear_list_users` | 列表用户 |
| `linear_get_user` | 通过 id 获取用户细节 |

### 工作空间

| 工具 | 说明 |
| --- | --- |
| `linear_switch_workspace` | 切换活动工作空间( 仅可用 2+ 工作空间) |

### 自定义视图循环( C)

| 工具 | 说明 |
| --- | --- |
| `linear_list_views` | 列出任意类型的自定义视图( 过滤器、 页标、 顺序) |
| `linear_get_view` | 通过 id 或 sattle 获取自定义视图( 包括工程/ 倡议视图) |
| `linear_create_view` | 创建问题/项目/倡议/更新视图 |
| `linear_update_view` | 由 id 更新自定义视图( 名称、 过滤器、 图标、 颜色、 共享) |
| `linear_delete_view` | 用 id 删除自定义视图 |
| `linear_set_view_preferences` | 为自定义视图设置显示偏好( 分组和列) |
| `linear_list_cycles` | 列表周期(按团队过滤,页标,顺序) |
| `linear_get_cycle` | 由 id 或 sult 获取循环细节 |
| `linear_create_cycle` | 为团队创建循环( startsAt / endAt, 可选名称) |
| `linear_update_cycle` | 按 id 更新周期( 名称、 日期、 完成) |
| `linear_archive_cycle` | 通过 id 来存档循环,并解开其指定问题的联系 |

自定义视图显示设置( 按受让人/ 状态/ 优先级分组, 显示估计/ 日期) 每个用户通过 `linear_set_view_preferences`; 打开后视图到 见应用的分组.

## 所需资源

-   Pi 交互模式( 设置覆盖使用部件 API)

## 常见问题

### @alasano/pi-linear 是什么？

Pi 有64\+工具、多工作空间认证和每个工具设置的线性集成

### 如何安装 @alasano/pi-linear？

在项目目录运行 npm install @alasano/pi-linear，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@earendil-works/pi-coding-agent（\>=0\.79\.9）、@earendil-works/pi-tui（\>=0\.79\.9）、typebox（\>=1\.1\.38）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @alasano/pi-linear 支持 TypeScript 吗？

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

### @alasano/pi-linear 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @alasano/pi-linear 可以商用吗？

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

### @alasano/pi-linear 的下载量有多少？

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

### @alasano/pi-linear 还在维护吗？

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