@comput/pi-telegram

中文文档
0.6.11发布于 2026/11/09MITES Module构建来源已验证近 30 天下载 3308

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

中文使用文档
文档目录9 节
  1. 尽你所能
  2. 连接
  3. 1. 安装
  4. 2. 添加你的机器人
  5. 3. 打个招呼
  6. 捡起你离开的地方
  7. 几个有用的控制
  8. 私人设计,有明确的界限
  9. 学多点

Pi 电报

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

离终端远点,不要留下编码会话 Pi 电报连接运行 Pi 编码代理 给您的私人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. 安装

在你身边 终端数字 :

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见 设置和恢复指南 寻求帮助.

捡起你离开的地方

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

pi -r

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

新的或预留的会话不会继承机器人. 使用 /telegram-start 故意选择或转移一个。 更多关于 届会和转让。 。 。 .

几个有用的控制

何处命令目的
电报/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或撤销其令牌. 见 完整命令指南 财务报告和审定财务报表 更新/搬运说明。 。 。 .

私人设计,有明确的界限

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

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

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

学多点

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

版本与发布记录

@comput/pi-telegram 共发布 24 个版本,首次发布于 2026/09/10;过去 12 个月发布了 24 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.6.11latest2026/11/091 天前
0.6.102026/11/073 天前
0.6.92026/10/3110 天前
0.6.82026/10/2912 天前
0.6.72026/10/2912 天前
0.6.62026/10/2714 天前

关于 @comput/pi-telegram 的常见问题

@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 和提交记录判断。