# @fitchmultz/pi-ask-question 中文文档

规范地址：https://npmcn.com/package/%40fitchmultz/pi-ask-question/

版本：0\.6\.17
npm 元数据更新时间：2026-11-14T18:20:52.353Z
中文译文更新时间：2026-11-14T20:37:11.213Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：105 kB，21 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24\.22\.3 \<25 \|\| \>=26\.13\.1
- 运行依赖：0 个
- peer 依赖：typebox \*，@earendil-works/pi-tui \*，@earendil-works/pi-coding-agent \*
- 首次发布：2026-10-06T00:05:42.438Z
- 最新版本发布：2026-11-14T18:20:51.944Z
- 近 30 天下载量：3435（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 19 个）

## 中文简介

添加交互式询问工具和/grill-me 压力测试模式的 Pi 扩展名

## 安装

```sh
npm install @fitchmultz/pi-ask-question
```

也可以使用：`pnpm add @fitchmultz/pi-ask-question`、`yarn add @fitchmultz/pi-ask-question`、`bun add @fitchmultz/pi-ask-question`

## README

# 任务问题

这个 [Pi](https://github.com/earendil-works/pi) 在代理继续执行任务之前,扩展请求您作出决定。 使用 `/grill-me` 通过不明确的要求指导代理人.

![Pi calls ask\_question, shows choices, and returns your answer to the agent. Five minutes without interaction returns an AFK reply.](https://npmcn.com/package/%40fitchmultz/pi-ask-question/.github/readme/question-flow.png)

## 安装

需要节点.js和被支持的 Pi 发布. 见 [兼容性要求](https://github.com/fitchmultz/pi-ask-question/blob/main/docs/reference.md#installation-and-updates)官方发布Pi和Mitch的Pi叉得到了支持.

运行这些命令 :

```bash
pi install npm:@fitchmultz/pi-ask-question
pi
```

使用 `/reload` 如果皮已经打开。 见 [Git 安装](https://npmcn.com/package/%40fitchmultz/pi-ask-question/docs/reference.md#installation-and-updates) 用于替代来源.

## 试试看

将此请求发送给 Pi :

> 规划一个设置页面 。 使用 ask question 来询问要先包含哪些设置 .

选择或选择 **键入自定义答案**。多选择的问题允许您选择多个选项.

使用上下键在选择间移动 。 按 Enter 键回答。 对于多选题,请按 Space 更改所选选项. 从最后审查中提交问题集和多选择的答案.

按 Ctrl+O 读出对话,然后再按它返回问题. 您的当前答案将保持不变.

逃出会离开自定义的回答编辑器;否则,会取消提问. 你的编辑草稿保持不变。 见 [终端控制](https://npmcn.com/package/%40fitchmultz/pi-ask-question/docs/reference.md#terminal-controls) 用于问题导航、长文本和自定义约束.

## 限制

5分钟后出现未处理的提问时间,代理商收到AFK的答复,以继续已经授权的工作和例行选择,而不将暂停作为对一个重要问题的回答或批准。 一旦你互动,这个问题集没有时限。 每一次新电话都会开始自己的计时器.

在RPC模式下,Pi在客户端提交对话框选择时学习交互;导航一个未提交的对话框对于Pi来说是不可见的.

该工具保留了保存的答案 。 它不提交未保存的自定义解答文本或为您选择一个解答 .

提问对话框需要终端UI或支持Pi对话框的RPC客户端. 皮不给 `ask_question` 以打印模式、 JSON 模式或 SDK 会话向代理件, 没有 UI, 如子代理子。 见 [提供工具的地方](https://npmcn.com/package/%40fitchmultz/pi-ask-question/docs/reference.md#where-the-tool-is-offered)。 。 。 .

## 检查要求与 `/grill-me`

在您请求前启用模式 :

```text
/grill-me on
```

模式引导代理检查现有证据,一次问一个阻断问题. 特工先回答建议 剂能以明显的低风险步骤来继续.

使用 `/grill-me` 切换模式。 使用 `/grill-me off` 以禁用模式。 使用 `/grill-me status` 来检查模式.

终端页脚显示 `grill-mode` 当启用时。 Pi 保存当前会话分支中的设置 。 环境能活下来 `/reload`。 。 。 .

在没有UI的会话中,如打印和JSON模式,代理以普通文本提问.

## 参考文献

[工具参考](https://npmcn.com/package/%40fitchmultz/pi-ask-question/docs/reference.md#tool-shape) 包括输入示例、结果字段和用户界面细节. [合作TUI的答案](https://npmcn.com/package/%40fitchmultz/pi-ask-question/docs/reference.md#cooperative-tui-answers) 记录可信任扩展的事件协议.

[发展](https://npmcn.com/package/%40fitchmultz/pi-ask-question/docs/development.md) 涵盖本地测试,主机兼容性,以及出版. 见 [更改日志](https://npmcn.com/package/%40fitchmultz/pi-ask-question/CHANGELOG.md) 用于更改. [报告问题](https://github.com/fitchmultz/pi-ask-question/issues) 如果扩展失败.

## 许可证

[麻省理工学院](https://npmcn.com/package/%40fitchmultz/pi-ask-question/LICENSE)米奇・富尔茨.

## 常见问题

### @fitchmultz/pi-ask-question 是什么？

添加交互式询问工具和/grill-me 压力测试模式的 Pi 扩展名

### 如何安装 @fitchmultz/pi-ask-question？

在项目目录运行 npm install @fitchmultz/pi-ask-question，或使用 pnpm add / yarn add / bun add。

### @fitchmultz/pi-ask-question 支持 TypeScript 吗？

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

### @fitchmultz/pi-ask-question 支持 ESM 还是 CommonJS？

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

### @fitchmultz/pi-ask-question 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.22\.3 \<25 \|\| \>=26\.13\.1。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @fitchmultz/pi-ask-question 可以商用吗？

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

### @fitchmultz/pi-ask-question 的下载量有多少？

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

### @fitchmultz/pi-ask-question 还在维护吗？

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

