$ cat ~/map/pi-nushell.md

pi-nushell

pi 的 Nushell 工具扩展：shell 命令流式输出、取消与超时。

extensions✓ 9月10日

事实速查

安装

pi install npm:pi-nushell

## 速览

为 pi 新增 nu 工具的扩展，可执行 nushell 命令，行为与内置 bash 工具一致：会话工作目录、合并流式输出、取消与可选超时，非零退出码按工具错误上报。

$在当前会话工作目录中以 nushell 的命令字符串模式运行——不会加载 config.nu 之类的配置文件。
$合并流式输出 stdout 与 stderr，支持取消与可选的按次超时（以秒计，无默认超时）。
$非零退出码按工具错误上报；输出截取末尾 2000 行或 50 KB，发生截断时把完整输出存入临时文件。
$向命令暴露 PI_SESSION_ID、PI_SESSION_FILE、PI_PROVIDER、PI_MODEL、PI_REASONING_LEVEL，与内置 bash 工具的约定一致。
$工具输入为必填的 nushell 语法命令与可选的秒数超时；开发时可用 pi -e ./index.ts 直接加载扩展。

Q nu 工具会加载我的 nushell 配置吗？

不会——它使用 nushell 的命令字符串模式，config.nu 之类的配置文件不会被加载。

Q pi-nushell 有什么依赖要求？

需要安装 nushell；扩展包装 nushell 命令，工具行为与 pi 内置的 bash 工具保持一致。