# @comput/pi-telegram 中文文档

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

版本：0\.6\.11
npm 元数据更新时间：2026-11-08T16:19:32.072Z
中文译文更新时间：2026-11-10T14:17:31.655Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：476 kB，48 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.9\.0
- 运行依赖：2 个
- peer 依赖：typebox \*，@earendil-works/pi-coding-agent \*
- 首次发布：2026-09-10T06:37:56.760Z
- 最新版本发布：2026-11-08T16:19:31.770Z
- 近 30 天下载量：3308（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 24 个）

## 中文简介

你的皮会,无论你在哪里。 通过 Telegram 发送请求、共享截图并获取答复和文件—— 而不丢失您的工程上下文 .

## 安装

```sh
npm install @comput/pi-telegram
```

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

## README

# Pi 电报

**你的皮会,无论你在哪里.**

离终端远点,不要留下编码会话 Pi 电报连接运行 [Pi 编码代理](https://pi.dev/) 给您的私人Telegram bot, 这样您就可以发送请求, 询问后续问题并从您的手机中接收回复和文件 .

同一会. 相同的项目背景。 另一种与皮合作的方式.

## 尽你所能

-   **继续谈话.** 询问您的项目, 或给代理人下一个任务, 而不返回您的办公桌 .
-   **从您的手机中发送上下文 .** 共享一个截图或文档, 并为代理机提供指令 .
-   **得到有用的答案回来.** 接收格式化的回复、代码、文件和图像, 不仅仅是通知您检查终端 .
-   **在聊天中做出选择.** 代理商可以为提问和下一步提供按钮.
-   **当它重要的时候,请看进展.** 明确进度信息,临时解答预览和一个工作指标帮助代理员向您通报情况. 0.6.4版本在显示相应钩子的主机上添加了原生上下文比对通知;早期暂停可能保持沉默.
-   **复入同会.** 恢复您的持续 Pi 会话 和它的指定bot 重新连接 .

例如:

> 解释认证如何在这个工程中工作. 先别变相.

> 这是虫子的截图 帮我找出什么是错的.

> 把刚刚生成的报告给我.

Pi Telegram 是一个 **pi 会话的前端**,而不是一个主机代理或Pi的终端接口的替换. 您的 Pi 进程必须保持运行 。 代理回复和进度使用明确的Telegram工具;终端对口和工具输出不会被自动映射到聊天中.

## 连接

您需要 Pi 0.84.4 或 后期配置的模型/提供者, 节点 22. 19. 0 或后期(或 您的 Pi 版本的更高要求), 以及 Telegram 账户 。 候选人通过Pi 1.3.0测试;标准 `*` Pi同位素范围不是一个通用相容性主张. 在您信任的工程中开始: 代理机保留其读取文件和运行命令的正常能力.

### 1\. 安装

在你身边 **终端**数字 :

```bash
pi install npm:@comput/pi-telegram
cd /path/to/your/project
pi
```

已经运行了 Pi ? 使用 `/reload` 内 **本地 Pi** 安装后.

### 2\. 添加你的机器人

1.  单位 **电报**打开 **@ 父爱 @ info**发送 `/newbot`,并遵循其指示.
2.  单位 **本地 Pi**运行 `/telegram-start` → **添加一个机器人..** → **添加瓶装父体**。 。 。 .
3.  在本地设置的 UI 中输入 bot 的确切用户名和令牌 。 托肯入口被蒙上面具. **永远不要将信使贴入代理对话,Telegram聊天或发行.**
4.  打开 **你的机器人的私人电报聊天**按钮 **开始**,并发送用 Pi 显示的精确的一次性配对代码。 密码在3分钟后失效.
5.  检查本地 Pi 中的连接 `/telegram-status`。在0.6.2候选人中,启动是沉默的:发送 `/ping` 在电报中 `Pong · project · vLoadedVersion` (已公布的0.6.1仍发出连接通知).

如果设置要求删除一个 Webhook 或从另一个会话中传输一个机器人, 请仅在您打算接管此连接时确认 .

### 3\. 打个招呼

发送到 **您的机器人在电报**数字 :

> 回答这里的“连接工程”。 不读取文件, 更改任何东西或运行命令 .

你准备好了,当代理答复。 如果没有, 请检查本地 Pi 是否有模型/ 提供者出错并运行 `/telegram-status`见 [设置和恢复指南](https://npmcn.com/package/%40comput/pi-telegram/docs/user-guide.md#botfather-setup-and-recovery) 寻求帮助.

## 捡起你离开的地方

一个机器人属于 **一次连续的皮会**,不是在项目文件夹中每次会话。 关闭后,返回项目并恢复原会话:

```bash
pi -r
```

或使用 `pi -c` 继续该项目最近一届会议。 其指定的bot在会话复会时重新连接.

新的或预留的会话不会继承机器人. 使用 `/telegram-start` 故意选择或转移一个。 更多关于 [届会和转让](https://npmcn.com/package/%40comput/pi-telegram/docs/user-guide.md#sessions-transfers-and-safe-recovery)。 。 。 .

## 几个有用的控制

| 何处 | 命令 | 目的 |
| --- | --- | --- |
| 电报 | `/ping` (0.6.2 候选人) | 检查没有模型的连接、工程和加载版本 |
| 本地 Pi | `/telegram-status` | 检查连接和任务 |
| 本地 Pi | `/telegram-release` | 断开此会话, 保存 bot 证书 |
| 本地 Pi | `/telegram-remove-bot` | 删除一个机器人的本地项目证书 |
| 终端 | `pi update npm:@comput/pi-telegram` | 更新软件包;然后 `/reload` 本地 Pi 语法 |

本地证书的删除不会在Telegram上删除bot或撤销其令牌. 见 [完整命令指南](https://npmcn.com/package/%40comput/pi-telegram/docs/user-guide.md#commands) 财务报告和审定财务报表 [更新/搬运说明](https://npmcn.com/package/%40comput/pi-telegram/docs/user-guide.md#updates-and-removal)。 。 。 .

## 私人设计,有明确的界限

-   只有配对业主的私人信息被接受.
-   配对需要您本地 Pi 设置中显示的短命代码 .
-   代理内容被明确发送,而不是自动转发终端输出或私人推理.
-   文件发送仅限于允许的项目文件,证书和寄存器-内部路径被屏蔽. 这些检查不会任意扫描文件内容以获取机密或恶意软件.

**Telegram bot聊天不是端到端加密的.** Pi扩展有完整的系统访问,所存储的符是平正文本,所请求的ping/status回复包括项目/版本或主机细节. 保护您的本地设置和备份, 并使用一个机器人 仅与项目和信息 您自在通过Telegram访问.

停止是受要求约束的;它不是每个工人或子进程终止的保证。 必要时在当地检查正在进行的工作.

## 学多点

-   [用户指南](https://npmcn.com/package/%40comput/pi-telegram/docs/user-guide.md) ——命令,文件,恢复,会话转移和高级设置.
-   [代理/工具指南](https://npmcn.com/package/%40comput/pi-telegram/docs/agent-tools.md) ——明确信息传递,预览,进步和可选使用技能.
-   [从0.5.0升级](https://npmcn.com/package/%40comput/pi-telegram/docs/agent-tools.md#migration-from-050) ——向明确的后/草稿/编辑/活动工具迁移.
-   [更改日志](https://npmcn.com/package/%40comput/pi-telegram/CHANGELOG.md) ——放行说明,包括待修改.
-   [发展状况](https://npmcn.com/package/%40comput/pi-telegram/docs/development-status.md) ——论证证据和已知的局限性.
-   [安全报告](https://github.com/comput-sh/pi-telegram/blob/main/SECURITY.md) • 妇女 [麻省理工学院许可证](https://npmcn.com/package/%40comput/pi-telegram/LICENSE)

此退出准备 **0.6.2 (中文(简体) )**,尚未公布; 公众释放基线仍保留 **0.6.1 (中文(简体) )**。候选人增加了静态启动,本地 `/ping`,缩小范围的新电话运行时间 `/reload` 和无记录的惰性收音机。 不支持进程重新启动和实例跟踪任务 。 当地验证和安全审计通过;见证据发展情况和现场测试的其余限制.

## 常见问题

### @comput/pi-telegram 是什么？

你的皮会,无论你在哪里。 通过 Telegram 发送请求、共享截图并获取答复和文件—— 而不丢失您的工程上下文 \.

### 如何安装 @comput/pi-telegram？

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

### @comput/pi-telegram 支持 TypeScript 吗？

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

### @comput/pi-telegram 支持 ESM 还是 CommonJS？

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

### @comput/pi-telegram 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.9\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @comput/pi-telegram 可以商用吗？

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

### @comput/pi-telegram 的下载量有多少？

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

### @comput/pi-telegram 还在维护吗？

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