# @hypernewbie/phi-code 中文文档

规范地址：https://npmcn.com/package/%40hypernewbie/phi-code/

版本：0\.31\.0
npm 元数据更新时间：2026-11-01T07:42:30.456Z
中文译文更新时间：2026-11-01T10:06:38.869Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：8.7 kB，5 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-07-01T14:47:21.455Z
- 最新版本发布：2026-11-01T07:42:30.179Z
- 已发布版本数：77（近 12 个月 77 个）

## 中文简介

终端多路复用器和AI编码助手控制中心

## 安装

```sh
npm install @hypernewbie/phi-code
```

也可以使用：`pnpm add @hypernewbie/phi-code`、`yarn add @hypernewbie/phi-code`、`bun add @hypernewbie/phi-code`

## README

## 这个npm包里有什么

这个npm包故意很小——它是一个 **发射器存根**，而不是。 完整的应用程序:

```
package/
  package.json     # allowScripts, version, repo metadata
  README.md        # this file
  scripts/install.js   # downloads the platform-native binary from GitHub releases
  bin/phi          # node shim that spawns the downloaded binary
```

真正的Go二进制，web UI(包括 `help.md` 和 `changelog.md`)， 所有的资源都在GitHub上发布 `install.js` 下载。这个 二进制嵌入 `web/` 目录通过 `//go:embed all:web` 所以它起到了作用 `help.md` 和 `changelog.md` 直接在运行时-没有单独的托管 需要的。

## NPM v12安装时安全性

从npm v12开始([https://github.blog/changelog/2026-07-08-npm-install-time-security-and-gat-bypass2fa-deprecation/](https://github.blog/changelog/2026-07-08-npm-install-time-security-and-gat-bypass2fa-deprecation/))， **`postinstall` 默认情况下，脚本不再运行**。这个包的 `postinstall` （`scripts/install.js`)从GitHub版本下载平台原生Go二进制文件 -没有它， `phi` 不会安装。

### 项目范围安装

这 `package.json` 船的 `allowScripts` 自动批准脚本的条目：

```json
"allowScripts": { "@hypernewbie/phi-code": true }
```

所以 `npm install @hypernewbie/phi-code` (或 `--save`)刚刚好。

### 全局安装(`npm install -g`）

没有项目 `package.json` 在全局模式下，所以NPM v12不能读取 白名单。npm v12+的最终用户将需要以下其中一个：

```sh
npm install -g @hypernewbie/phi-code --allow-scripts
```

或者坚持一次：

```sh
npm config set allow-scripts=@hypernewbie/phi-code --location=user
npm install -g @hypernewbie/phi-code
```

(或使用 `--ignore-scripts` 和运行 `npx --yes @hypernewbie/phi-code` 去取 按需二进制。)

## 可信发布（OIDC）

发布工作流程(`.github/workflows/release.yml`)被配置为 npm与OIDC的可信发布流程： `npm-publish` 工作 `id-token: write` 权限和呼叫 `npm publish --provenance`。完成 迁移:

1.  在npmjs.com→package `@hypernewbie/phi-code` → **发布访问** → **信任的出版商** → **添加可信发布者**：
    -   老板: `hypernewbie`
    -   存储库: `phi`
    -   工作流文件名: `release.yml`
2.  删除 `NPM_TOKEN` 一旦你确认了一个标记的发布，Repo的秘密 仅通过OIDC就能成功发布 `NODE_AUTH_TOKEN: ''` 在 工作流临时测试)。

在完成这两项工作之前，工作流程会退回到遗留的工作 `NPM_TOKEN` 的秘密。

## 常见问题

### @hypernewbie/phi-code 是什么？

终端多路复用器和AI编码助手控制中心

### 如何安装 @hypernewbie/phi-code？

在项目目录运行 npm install @hypernewbie/phi-code，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 phi、phic，可以用 npx phi 直接运行。

### @hypernewbie/phi-code 支持 TypeScript 吗？

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

### @hypernewbie/phi-code 可以商用吗？

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

### @hypernewbie/phi-code 还在维护吗？

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