检查 shell 前缀与会话环境
在两条命令路径中检查 shellCommandPrefix,然后检查只有面向模型的 shell 才会收到的会话变量。
使用 Pi 1.0.4 和它的内置 Bash 工具。你会把模型的命令和你自己的 ! 命令作比较。下面的配置和手动命令是对现有第 9 章测试的教学性改编;测试仍然是规范的可执行证据。
配置一个可见的前缀
把这个片段合并进 <project>/.pi/settings.json,然后运行 /reload:
{
"shellCommandPrefix": "export FROM_PREFIX=yes"
}Pi 把这个前缀加在它的内置 bash 工具和用户输入的 ! 或 !! 命令之前。它会在每条命令之前重新运行一次。在原生 Windows 上,使用 Git Bash;如有需要,把 shellPath 设为 C:\Program Files\Git\bin\bash.exe,反斜杠在 JSON 中要转义。不要把它指向一个交互式配置文件。
让模型运行这个检查
把下面整条命令复制下来,然后让 Pi:用内置的 bash 工具运行它,并原样展示输出。
echo "prefix=$FROM_PREFIX"
echo "id=[$PI_SESSION_ID] provider=[$PI_PROVIDER] model=[$PI_MODEL]"
echo "level=[$PI_REASONING_LEVEL] file=[$PI_SESSION_FILE]"比较你自己的命令
把这个输入 Pi 的编辑器(开头的 ! 属于 Pi,不属于 shell 脚本):
!echo "prefix=$FROM_PREFIX id=[$PI_SESSION_ID]"预期结果
| 路径 | 前缀 | 会话变量 |
|---|---|---|
模型调用内置的 bash |
prefix=yes |
Pi 注入当前会话和选定模型的值 |
你输入 ! 或 !! |
prefix=yes |
Pi 不注入那五个会话变量 |
在一个干净的父环境里,用户输入的命令预期会打印:
prefix=yes id=[]面向模型的输出包含一个非空的会话 ID。provider、模型、推理级别和持久化的会话路径取决于你的会话;临时会话没有会话文件值。**这些是预期的读者结果,不是你的机器的转录记录。**如果你的父环境已经导出了某个 PI_* 变量,一条用户命令可能继承它;不注入并不保证继承来的变量不存在。
机制与限制
**有文档记载:**锁定的 shell-aliases.md 规定了前缀和全新的非交互式 shell。environment-variables.md 规定了那五个变量,以及工具调用与 ! / !! 之间的区别。**已观察:**规范的 ch09-shell/shell.test.ts 用一个脚本化的 provider 驱动真实的 Bash 工具和 executeBash;它的断言覆盖两条路径中的前缀、面向模型的注入、临时会话,以及实时推理级别变化。这些测试在当前的验证环境中使用 Windows 上的 Git Bash。
一个替换 Bash 的扩展控制它自己的设置,可能绕过这个前缀。为模型选择 PowerShell 并不会让你的 ! 命令使用 PowerShell。这个示例不演示真实模型对你运行这个检查的请求的遵从。
规范测试 。
Understand this example
Copy this prompt into your AI tool. No code runs here.
Apply this example
Copy this prompt into your AI tool. No code runs here.