最终目标:
bin/gf pi可以替代 pi coding agent 的脚本模式(print 模式与 JSON 模式)——用户在脚本与管道中原来写pi -p "..."、pi --mode json "..."的地方,直接换成bin/gf pi ...即可,行为兼容、配置复用(~/.pi/agent/)。配置文件目录(config-dir):
~/.gf/agent/存在时优先使用其中的 JSON 配置文件, 否则回退~/.pi/agent/;会话目录(sessions/)始终在~/.pi/agent/sessions/。本文档由真实冒烟测试验证整理:标注【可用】的示例均在开发机上实际运行通过; 尚不能运行的用法收入文末 TODO,随迭代更新。 更新方式:探索新的用法并实际验证后,把示例从 TODO 移入正文并注明验证日期。
# 构建
timeout 600 xmake b goldfish
# 配置复用 JSON 配置文件目录(config-dir):~/.gf/agent/ 存在时优先,否则 ~/.pi/agent/
# settings.json(defaultProvider/defaultModel/httpProxy/retry)、
# auth.json(api_key / ANTHROPIC_AUTH_TOKEN 等环境变量兜底)、models-store.json(刷新同步快照,运行时不再读取)
# models/providers.json + <provider>.json + <provider>/<model>.json(provider 与模型配置,见下节)
# 会话目录不受影响:始终 ~/.pi/agent/sessions/
# HTTP 代理(per-provider):--proxy > models/<provider>.json httpProxy > HTTPS_PROXY/ALL_PROXY 环境变量 > settings.json httpProxy > 直连
# 重试:可重试 provider 错误(429/5xx/408/409/网络错误)使用 retry.provider.maxRetries 预算
# (本机=12),未配置该嵌套节时回退 retry.maxRetries(缺省 3)bin/gf pi 把目录分为两类:
| 类别 | 目录 | 内容 |
|---|---|---|
| 配置文件目录(config-dir) | ~/.gf/agent/(存在时)否则 ~/.pi/agent/ |
settings.json、auth.json、models/providers.json、models/<provider>.json、models/<provider>/<model>.json、models-store.json、web-search.json 等 JSON 配置文件 |
| 会话 / 扩展目录(agent-dir) | ~/.pi/agent/ |
sessions/(会话记录)、extensions/(用户扩展) |
优先级:GF_CONFIG_DIR > PI_CODING_AGENT_DIR 环境变量(测试与调试用) > ~/.gf/agent/
(存在时) > ~/.pi/agent/。即:只要 ~/.gf/agent/ 目录存在,bin/gf pi 就从该目录读取全部
JSON 配置文件;会话记录仍然写入 ~/.pi/agent/sessions/。
任意 Scheme 代码可直接导入 (liii pi code config) 调用 (gf-get-config-dir) 获得该目录(返回 path 对象):
(import (liii pi code config))
(gf-get-config-dir) ; => #<path "/home/user/.gf/agent">(存在时),否则 #<path "/home/user/.pi/agent"># 独立配置目录:把 ~/.pi/agent/ 复制为 ~/.gf/agent/ 后即自动生效
mkdir -p ~/.gf/agent && cp ~/.pi/agent/settings.json ~/.pi/agent/auth.json ~/.gf/agent/
# 临时用其它目录(覆盖 ~/.gf/agent 与 ~/.pi/agent)
GF_CONFIG_DIR=/tmp/my-config-dir bin/gf pi -p "hello"
# PI_CODING_AGENT_DIR 同样可用(兼容 pi 既有约定)
PI_CODING_AGENT_DIR=/tmp/my-agent-dir bin/gf pi -p "hello"配置拆成三层小文件,每层都是白名单 array,文件只负责补充与覆盖:
~/.gf/agent/
models/ ← provider 与模型配置统一放这个子目录
providers.json ← 哪些 provider 启用(json array,顺序即展示顺序)
schema: resources/providers.schema.json
google.json ← provider 层:端点、代理、模型白名单(文件名即 provider id)
schema: resources/provider.schema.json
google/
gemini-3.8-flash.json ← 模型层:单模型条目,文件名即模型 id(可选)
schema: resources/model.schema.json
auth.json ← API key 只在这里(支持 ${VAR} 环境变量模板)
schema: resources/auth.schema.json
models-store.json ← 刷新同步的目录快照(仅供参考,运行时不再读取)
详细字段定义、缺省值、校验规则与示例见各 schema 文件(tools/pi/liii/pi/code/resources/)。
要点:
- models/providers.json:provider id 白名单 array;缺失或空数组 = 全部内置 provider(供应商与模型全部激活)
(google / kimi-coding / deepseek / minimax-cn / zai-coding-cn);
语法错 / 非字符串 / 重复 id 报错拒启(唯一致命文件,其余文件坏一个忽略一个);
白名单 id 需有内置定义或
models/<id>.json,否则告警忽略(防拼写错位); 旧位置providers.json(配置目录顶层)仍兼容,models/providers.json优先 - models/.json:字段级合并,未写字段回落内置默认;
models为模型 id 白名单 array(缺省不过滤);httpProxy为 per-provider 代理 (--proxy> 本字段 >HTTPS_PROXY/ALL_PROXY> settings.jsonhttpProxy) - models//.json:字段集与旧版
models.json模型条目一致; 合并优先级<model>.json > 内置目录(按字段逐项补缺) - auth.json:key 唯一存放处,provider 文件不含密钥
// 最小配置示例
["kimi-coding"] // models/providers.json:只用 kimi
{ "baseUrl": "https://mirror.example.com/coding" } // models/kimi-coding.json:换镜像
{ "httpProxy": "http://127.0.0.1:7890" } // models/google.json:仅 google 走代理
{ "name": "Kimi K3.1 Pro" } // models/kimi-coding/k3.1-pro.json旧版 models.json 已删除(自定义 baseUrl → models/<provider>.json,自定义模型条目 →
models/<provider>/<model>.json);models-store.json 仅作刷新同步快照,运行时不再读取,
模型可用性完全由 models/providers.json + models/ + 内置目录决定。
ranger 风格三列只读 TUI,用来查看当前配置与模型可用性:
bin/gf pi config┌ providers 5/5 on ┐┌ models · google ┐┌ preview · gemini-3.8-flash ┐
│ ● google ││ ● gemini-3.8-flash ││ usable yes │
│ ● kimi-coding ││ × deep-research-preview-04-... ││ id gemini-3.8-flash │
│ ● minimax-cn * ││ × gemini-2.5-flash ││ api google-generative-ai │
│ ● zai-coding-cn ││ × gemini-2.5-pro ││ context 1M │
└────────────────────┘└────────────────────────────────┘└──────────────────────────────┘
/home/da/.gf/agent · 5/5 providers · 6/46 models · default minimax-cn/MiniMax-M3.1-Flash
↑↓/jk 移动 · →/Enter 进入 · ←/h 返回 · Tab 切列 · g/G 首尾 · q 退出
- 三列展示全部 provider 与模型(含内置目录,不只看已配置的)
●= 可用(provider 在models/providers.json白名单、模型在models白名单内)×= 不可用(被白名单过滤,或被禁用的 provider 下的模型)*= 当前默认模型;右列显示选中模型的 api / baseUrl / 上下文 / 代理 / key 来源 / 配置文件- key 只显示来源(
auth.json或$ENV_NAME),不回显密钥 - v1 只读:不写任何配置文件
# 一次性运行:最终 assistant 文本写 stdout 后退出
timeout 300 bin/gf pi -p "用一句话说明这个仓库是做什么的"
# 管道输入(stdin 非终端时自动读入,与 prompt 无分隔符拼接)
git diff | timeout 300 bin/gf pi -p "Review this change"
echo "Goldfish Scheme 是一个 Scheme 解释器" | timeout 300 bin/gf pi -p "把这句话翻译成英文,只输出译文"
# @文件:文件内容包裹为 <file name="..."> 块注入 prompt(支持 ~ 展开)
timeout 300 bin/gf pi -p @CLAUDE.md "这个项目的提交信息格式是什么?"# JSON 模式:JSONL 事件流写 stdout(默认走流式路径,含 message_update 增量事件)
timeout 300 bin/gf pi --mode json "列出当前目录结构" > events.jsonl
# 事件类型序列
jq -r .type events.jsonl
# session / agent_start / turn_start / message_start / message_update... / message_end / turn_end / agent_end / agent_settled
# 工具执行事件
jq -r 'select(.type=="tool_execution_start") | "\(.toolName) \(.args)"' events.jsonl# 默认激活 read/bash/edit/write/web_search;grep/find/ls 需显式开启
# (web_search 由 web-search 扩展注册时声明 :default-active? #t 并入默认集,核心不写死)
timeout 300 bin/gf pi -p --tools read,bash,grep,find,ls "统计 tests/ 下测试文件数量"
# web_search 已默认启用,无需 --tools 指定(详见内置扩展章节)
timeout 280 bin/gf pi -p "搜索 Goldfish Scheme 最新版本并给出引用来源"
# 临时关闭 web_search(黑名单或增量均可)
timeout 280 bin/gf pi -p --exclude-tools web_search "只回答:1+1等于几"
timeout 280 bin/gf pi -p --tools "-web_search" "只回答:1+1等于几"
# 黑名单排除工具:从默认工具集或指定工具集中排除(快速变为只读审计模式)
timeout 300 bin/gf pi -p --exclude-tools bash,write,edit "你有哪些可用工具?列出工具名称"
# 白名单与黑名单共存时排除优先(--tools 与 --exclude-tools 组合)
timeout 300 bin/gf pi -p --tools read,bash,edit --exclude-tools bash "你有哪些可用工具?列出工具名称"
# 彻底关闭工具调用,变为纯文本对话模式(--no-tools 与 --no-builtin-tools 等价)
timeout 300 bin/gf pi -p --no-tools "1+1等于几?直接回答数字"
timeout 300 bin/gf pi -p --no-builtin-tools "1+1等于几?直接回答数字"
# 与 --tools / --exclude-tools 组合时以关闭优先
timeout 300 bin/gf pi -p --tools read,bash --no-tools "1+1等于几?直接回答数字"
# bash 工具多轮调用
timeout 300 bin/gf pi -p --tools bash "运行 echo hello 并把输出原样告诉我"
# write + read 往返(write 自动创建父目录)
timeout 300 bin/gf pi -p --tools read,bash,edit,write "在 /tmp/demo/ 下写 hello.txt 内容为 hi,然后读回来告诉我"
# 长输出截断:bash 输出保尾部 2000 行 / 50KB
timeout 300 bin/gf pi -p --tools bash "运行 seq 1 5000 并告诉我最后 4 行"# 默认持久化会话(session JSONL)
timeout 300 bin/gf pi -p "记住暗号:金鱼42号"
# 继续上一会话(--continue / -c),可多级连续
timeout 300 bin/gf pi -c -p "刚才的暗号是什么?"
timeout 300 bin/gf pi -c -p "继续上一轮的话题"
# 选择并恢复历史会话(--resume / -r):默认当前目录,Tab 切换全部项目;
# 输入模糊搜索,Enter 恢复,ESC 取消;Ctrl+N 仅看命名会话,
# Ctrl+P 显示文件路径,Ctrl+S 切换最近时间/相关度排序。
bin/gf pi --resume
# 指定会话存储目录(优先级:--session-dir > PI_CODING_AGENT_SESSION_DIR
# > settings.json 的 sessionDir > 默认 <agent-dir>/sessions/<encoded-cwd>/)
timeout 300 bin/gf pi --session-dir ~/my-sessions -p "记住暗号:金鱼42号"
timeout 300 bin/gf pi --session-dir ~/my-sessions -c -p "刚才的暗号是什么?"
# 纯内存运行,不写盘
timeout 300 bin/gf pi --no-session -p "一次性问题"交互式 TUI(bin/gf pi 无参进入)中,整行以 ! 开头的输入不发给模型,
而是直接经 bash 执行,输出显示在绿色边框卡片内(Ctrl+O 展开/折叠):
!ls -la # 执行并显示;命令与输出作为 user 消息注入后续 LLM 上下文
!!git status --short # 仅执行显示(暗色卡片),不注入上下文(excludeFromContext)
! # 命令为空时回退为普通消息提交
注入格式对齐 pi 的 bashExecutionToText:Ran \cmd`+ 围栏输出 + 非零退出码行;长输出复用 bash 工具的保尾 2000 行 / 50KB 截断策略。 会话文件以bashExecution 角色落盘(--continue` / 压缩摘要同样生效)。
agent 正在流式输出时结果延迟落盘,下一条消息才可见(对齐 pi 的 pending 语义)。
同一 TUI 运行内复用同一会话文件,跨消息保持上下文连续。
bin/gf pi 无参进入交互式 TUI 时,默认使用 备用屏(alt screen)全屏渲染:
整个终端屏幕由 TUI 独占,退出后主屏内容原样恢复(对齐上游 pi 的
tuiMode: "fullscreen" 默认值)。
屏幕布局(自上而下):
┌──────────────────────────────┐
│ 对话记录视口(可滚动,跟随末尾)│
│ │
├──────────────────────────────┤
│ 输入区(多行,busy 时显示动画) │
├──────────────────────────────┤
│ 页脚(路径/分支、用量、上下文占比、模型)│
└──────────────────────────────┘
| 按键 | 作用 |
|---|---|
PageUp / PageDown |
对话记录整页上翻/下翻 |
Ctrl+Shift+Up / Ctrl+Shift+Down |
对话记录单行上翻/下翻 |
Ctrl+Home / Ctrl+End |
跳到对话记录顶部/末尾(末尾恢复跟随) |
Ctrl+C |
清空输入框(不退出、不中断任务) |
Ctrl+D |
输入框为空时退出 TUI |
ESC |
busy 时中断任务并把排队消息撤回到输入框;空闲时撤回排队消息到输入框 |
Alt+Up |
仅把排队消息(steering / follow-up)撤回到输入框,不中断运行中任务 |
Enter(busy 时) |
steering:插话注入当前运行中的任务(工具批次结束后、下次请求前生效) |
Option+Enter(macOS)/ Alt+Enter(Linux)/ Alt+Q(Windows) |
follow-up:排队到当前任务自然结束后再执行;空闲时等同 Enter |
Ctrl+O |
展开/折叠工具与 bash 输出 |
Ctrl+V |
读取外部系统剪贴板并粘贴到输入框(Linux 支持 Wayland/X11) |
Shift+Tab |
循环切换 thinking level |
| 鼠标滚轮 | 上下滚动对话记录(单次滚轮 1 行,快速连续滚动自动加速,最多 6 行/次) |
对齐上游 pi 的两种排队机制(steer() / followUp()):
- steering(busy 时
Enter):消息经专用通道送到后台 worker,run-agent-loop在当前 assistant 轮的全部工具调用结束后、下一次 LLM 请求前注入为 user 消息;一次轮询注入一条(one-at-a-time), 多条排队消息在后续轮次依次注入。 - follow-up(busy 时 macOS 用
Option+Enter,Linux 用Alt+Enter,Windows 用Alt+Q):消息在任务自然结束(无更多 工具调用且无 steering)时才注入并驱动新一轮,然后继续。 - 硬退出不消费:ESC 中止、请求 error/aborted、max-turns、会话超时 结算时不轮询任何队列,消息保留在通道里,由下一个任务继续消费。
- 待处理区:busy 时输入区上方分组展示全部排队消息
(两空格缩进的 dim 行
Steering: .../Follow-up: ...,无方括号与Queued前缀) 与撤回提示行↳ Option+Up to edit all queued messages(Linux/Windows 下显示↳ Alt+Up to edit all queued messages);worker 消费时 上屏正式用户卡片并同步移除待处理项。 - 撤回:
ESC(中止 + 撤回)或Alt+Up(仅撤回), 按 steering → follow-up 顺序合并回输入框。
Windows 控制台层(src/liii_os.cpp 的 pump_console_input)已为
Alt+方向键/Home/End/PageUp/PageDown/Delete/Insert 保留 Alt 修饰位,
编码为 DOS 101 键扩展码表的 Alt 行专属码,与 Linux/macOS 的
pty 路径(ESC[1;3A 等 CSI 序列)行为一致:
Alt+Up与 follow-up 快捷键Alt+Q在 Windows Terminal、conhost 上使用。- 为避免部分 Windows 终端将
Alt+Enter用作全屏切换,Windows 的 follow-up 使用Alt+Q;macOS 仍使用Option+Enter,Linux 仍使用Alt+Enter。 Ctrl+Alt+方向键按优先级识别为Ctrl语义(沿用 Ctrl 码段)。Ctrl+C在 Windows Terminal、conhost、Git Bash (mintty) 下统一为清空输入框/中断语义,不再直接退出进程;退出请使用Ctrl+D(输入框为空时)。
实现分层:(liii pi agent queue) 提供 pi-pending-queue 双粒度队列;
(liii pi agent loop) 的 run-agent-loop 经 config 的
get-steering-messages / get-follow-up-messages 回调轮询;
TUI 层由 app.scm / worker.scm / app-events.scm 经 go channel
跨线程接线。
对话记录未跟随末尾(已向上翻页)时,视口底部会叠加一行提示:
↓ Jump to latest message · Ctrl+End
按 Ctrl+End 即可回到最新消息。
退出备用屏后,会把本次会话的 对话记录打印回主屏(对齐上游 pi 的
fullscreenExitOutput: "transcript"),退出前的终端输出不会被清空。
注:
bin/gf pi --resume的会话选择器仍使用行内(inline)渲染, 与上游 pi 的 startup TUI 行为一致;进入会话后的主界面同样是全屏模式。
bin/gf pi 引入了与原生 pi 概念模型全面对齐的 轻量纯 Scheme Extension 机制。
无需引入 Node.js 运行时或外部进程,扩展全部由 Goldfish Scheme 编写,自包含且轻量。
用户与开发者只要把相关的 .scm 插件文件(或带有 index.scm 的目录)放在对应目录下,启动时自动扫描发现并加载,无需手动注册:
| 扩展类型 | 存放位置 | 说明 |
|---|---|---|
| 仓库内置扩展 | tools/pi/extensions/ |
随 Goldfish 安装包直接分发内置(安装到 share/goldfish/tools/),开箱即用 |
| 用户全局扩展 | ~/.pi/agent/extensions/*.scm 或 */index.scm |
用户所有项目通用的全局插件 |
| 项目局部扩展 | .pi/extensions/*.scm 或 */index.scm |
仅在当前项目生效的定制插件 |
| 显式指定加载 | bin/gf pi -e /path/to/my-ext.scm |
命令行 -e / --extension 快速调试单个插件脚本 |
为保证日常编码体验的高效与开箱即用,最常用的 3 个插件随 Goldfish 安装包内置:
web-search:注册web_search工具(联网搜索,默认启用,实现移植自 ttttmr/pi-web-search);simplify:审查未提交代码的清晰度与可维护性,提供代码简化建议与--apply应用;code-review:审查工作区或暂存区的代码变更并输出结构化审查清单。
# simplify:代码简化审查
timeout 300 bin/gf pi -p --simplify
timeout 300 bin/gf pi -p --simplify --staged
# code-review:代码审查
timeout 300 bin/gf pi -p --code-review
timeout 300 bin/gf pi -p --code-review --staged移植自 ttttmr/pi-web-search,以内置扩展形式提供
web_search 工具(extensions/web-search.scm 注册,实现库 (liii pi web-search))。
默认启用(扩展注册时声明 :default-active? #t 并入默认集,核心默认集不写死扩展
工具名),无需 --tools 指定;--exclude-tools web_search 可关闭;
settings.json 显式 defaultTools 完整列表时以用户配置为准(不合并扩展默认)。
# 默认已启用,直接联网搜索(Gemini Google Search grounding,回答附 Sources 引用)
timeout 280 bin/gf pi -p "搜索 Goldfish Scheme 最新版本并给出引用来源"
# JSON 模式事件:tool_execution_start(query/urls)→ tool_execution_end(sources/details)
timeout 280 bin/gf pi --mode json -p "搜索 R7RS-small 与 R7RS-large 的区别" | grep tool_execution后端与凭据(优先级:显式参数 > web-search.json > 环境变量 > config):
| 后端 | 凭据 | base-url | 说明 |
|---|---|---|---|
google(默认) |
GOOGLE_API_KEY/GEMINI_API_KEY 或 auth.json 的 google 条目 |
GOOGLE_BASE_URL/GEMINI_BASE_URL/GF_PI_BASE_URL |
Gemini Search Grounding(默认模型 gemini-2.5-flash) |
deepseek |
DEEPSEEK_API_KEY 或 auth.json 的 deepseek 条目 |
DEEPSEEK_BASE_URL |
独立 Search + Fetch API,支持 urls 附带页面拉取 |
# 全局后端切换:~/.pi/agent/web-search.json(可用 PI_WEB_SEARCH_CONFIG 指定路径)
# {"provider": "deepseek", "model": "gemini-2.5-flash"}
echo '{"provider": "deepseek"}' > ~/.pi/agent/web-search.json
# 或环境变量切换(不落盘)
GF_PI_WEB_SEARCH_PROVIDER=deepseek timeout 280 bin/gf pi -p "搜索 DeepSeek V4 的发布日期"工具参数:query(必填,搜索词)与 urls(可选,随搜索一并分析的 URL,最多 20 个)。
代理优先级:显式 --proxy > web-search.json httpProxy > 对应 provider(如 models/google.json)httpProxy > HTTPS_PROXY/ALL_PROXY > settings.json httpProxy;Gemini 搜索会自动复用 google provider 已配置的代理。
baseUrl 优先级:显式 :base-url > web-search.json baseUrl > provider 专属环境变量(如 GOOGLE_BASE_URL) > 会话与 provider 本地配置(models-store、models/<provider>.json) > 全局 GF_PI_BASE_URL > 官方默认端点;Gemini/DeepSeek 搜索会自动复用对应 provider 已配置的自定义 baseUrl。
审查未提交(或指定 ref)的代码变更,输出可维护性/清晰度改进建议(只读,不改代码)。
# 审查工作区未提交变更
timeout 300 bin/gf pi -p --simplify
# 审查已暂存变更(git diff --cached)
timeout 300 bin/gf pi -p --simplify --staged
# 审查相对某个 ref 的变更
timeout 300 bin/gf pi -p --simplify --ref origin/main
# 建议确认后,在变更行范围内自动应用简化(写回文件)
timeout 300 bin/gf pi -p --simplify --apply约束:--apply 需与 --simplify 同用;--staged/--ref 需与 --simplify 或
--code-review 之一同用;与 --code-review 互斥。
对工作区(或暂存区、指定 ref)的变更逐文件输出结构化审查清单(问题等级与位置)。
# 审查工作区未提交变更
timeout 300 bin/gf pi -p --code-review
# 审查已暂存变更
timeout 300 bin/gf pi -p --code-review --staged
# 审查相对某个 ref 的变更
timeout 300 bin/gf pi -p --code-review --ref HEAD~3
# 交互注入:write/edit 后自动追加当前语言的审查清单到系统提示词
# (--auto-review,与 --code-review 互斥)
timeout 600 bin/gf pi -p --auto-review "修复 src/app.scm 里的空指针问题"约束:--staged/--ref 需与 --code-review 或 --simplify 之一同用;
--auto-review 与 --code-review 互斥。
支持通过 pi install 命令一键安装社区或第三方的 Git 扩展仓库:
# 默认安装至全局扩展目录(~/.pi/agent/extensions/<name>),安装即生效
timeout 180 bin/gf pi install https://gitee.com/xxx/my-pi-extension.git
# 安装至当前项目局部目录(.pi/extensions/<name>)
timeout 180 bin/gf pi install --local https://gitee.com/xxx/my-project-extension.git# 默认走 settings.defaultProvider + settings.defaultModel(本机 google / gemini-3.8-flash)
timeout 300 bin/gf pi -p "hi"同一 provider 切换不同模型(均已实测成功;完整模型清单见内置目录,bin/gf pi --provider google --list-models):
# flash 系列(不同版本)
timeout 120 bin/gf pi -p --model gemini-3.8-flash "只回复:ok" # 默认模型
timeout 120 bin/gf pi -p --model gemini-3.5-flash "只回复:ok" # ✅ 实测通过
timeout 240 bin/gf pi -p --model gemini-3.1-pro-preview "只回复:ok" # ✅ pro 系列,实测通过
# 模型元数据解析(任务 034 起):--model 必须在选定 provider 的目录中命中
# (内置目录 + provider/model 文件合并目录),不匹配或查无此模型均报错退出码 1
# (不再 warning + fallback 兜底)不同 provider 切换(均已实测成功):
# google(Gemini,默认 provider;同样可显式指定)
timeout 300 bin/gf pi -p --provider google "只回复:google-ok"
# Anthropic(支持 ANTHROPIC_BASE_URL 兼容网关与 ANTHROPIC_AUTH_TOKEN 环境变量;
# 凭据缺失时明确报错退出码 1)
timeout 300 bin/gf pi -p --provider anthropic "只回复:anthropic-ok"
timeout 300 bin/gf pi -p --provider anthropic --tools bash "用 bash 运行 echo ok 并告诉我输出"
# kimi-coding(支持 auth.json 中 api_key 凭据与 KIMI_API_KEY 环境变量,已实测通过)
timeout 60 bin/gf pi --provider kimi-coding -p "请回复:kimi-ok"
timeout 120 bin/gf pi --provider kimi-coding --tools bash -p "用 bash 运行 echo kimi-ok 并告诉我输出"
# glm(智谱 GLM,基于 Anthropic 兼容网关,已实测通过)
timeout 60 bin/gf pi --provider glm -p "请回复:glm-ok"
timeout 120 bin/gf pi --provider glm --tools bash -p "用 bash 运行 echo glm-ok 并告诉我输出"
# deepseek(DeepSeek,基于兼容网关,已实测通过)
timeout 60 bin/gf pi --provider deepseek -p "请回复:deepseek-ok"
timeout 120 bin/gf pi --provider deepseek --tools bash -p "用 bash 运行 echo deepseek-ok 并告诉我输出"注意:API 侧已对新增用户下线的模型会返回 404(如 gemini-2.5-pro),此时 stderr 输出人可读的 404 详情、退出码 1——这是正确的错误路径而非缺陷。
# 覆盖代理(socks5h:// 域名解析也走代理;http/https 代理亦可)
timeout 300 bin/gf pi -p --proxy socks5h://127.0.0.1:1080 "hi"# 轮数上限(默认 200,0 不限);bash 工具与单次 HTTP 超时秒数(bash 默认取此值)
timeout 600 bin/gf pi -p --max-turns 20 --timeout 60 "遍历 goldfish/ 给出模块清单"
# bash 工具超时生效后模型可自主以更长 timeout 重试
timeout 300 bin/gf pi -p --tools bash --timeout 5 "用 bash 运行 sleep 30 然后告诉我结果"
# 会话级累计超时(默认 0,即不设上限;正数按需开启兜底)
timeout 7200 bin/gf pi -p --session-timeout 7000 "长任务执行(最多 7000 秒)"
bin/gf pi -p "长任务执行(默认不设会话超时)"
# 系统提示词:替换 preamble / 追加附加节(可重复)
timeout 300 bin/gf pi -p --system-prompt "You are a Scheme expert." "解释 call/cc"
timeout 300 bin/gf pi -p --append-system-prompt "回答末尾必须加上 [goldfish-ok]" "只回答两个字:好的"
# 帮助
bin/gf pi --help# 罗列全部模型并标注激活状态(包含 on、provider、model、context、max-out、thinking、images 列)
# - on 列:已激活为 ●,未激活为 ×
# - 排序:已激活行全部置顶在未激活行之前,各组内部按 provider、model 字典序排序
# - 终端有色渲染:● 绿色前景(SGR 32),× 及未激活行整行暗显前景(SGR 2)
# - 颜色降级:stdout 非 tty 或设置 NO_COLOR=1 时输出纯文本无转义序列;FORCE_COLOR=1 强制有色
timeout 30 bin/gf pi --list-models
# 指定 provider 过滤(支持内置未激活 provider,罗列全部模型并标记 ×;未知 provider 报错退出码 1)
timeout 30 bin/gf pi --provider google --list-models
timeout 30 bin/gf pi --provider minimax-cn --list-models
# 可选搜索过滤词(在全量行集上进行模糊/子串匹配)
timeout 30 bin/gf pi --list-models flash
# 列出全部 provider 的模型(--provider all 与缺省语义一致)
timeout 30 bin/gf pi --provider all --list-models# @文件不存在:stderr 人可读报错(含路径与原因),退出码 1
timeout 60 bin/gf pi -p @/nonexistent-file "hi" # Error: cannot read @/nonexistent-file: No such file or directory
# 连接失败:stderr 人可读摘要,退出码 1
timeout 90 bin/gf pi -p --proxy socks5h://127.0.0.1:9 "hi"
# 模型不存在或不属于该 provider(任务 034 起):配置层直接报错,退出码 1,不发 HTTP
timeout 120 bin/gf pi -p --model totally-fake-model "hi"
# → Error: Unknown model "totally-fake-model": not found in any configured provider model catalog...
# 服务商返回 HTTP 429 且属确定性失败:不做退避重试,直接报错,退出码 1
# 智谱(zai-coding-cn)按 error.code 判定:
# 1308 5 小时额度耗尽、1310 每周/每月额度耗尽、1311 当前订阅套餐未开放该模型权限
# 1302 并发槽满、1303/1305 短时频率、1312 模型拥堵属瞬时故障,仍按配置退避重试
# stderr 为 provider 前缀加服务商官方原文,例如:
# → Error: zai-coding-cn: 当前订阅套餐暂未开放GLM-5.2-Highspeed权限# 全量构建系统文档索引
timeout 120 bin/gf doc --build-json
# 若需检索 tools/pi 下的工具函数文档,带上 -I tools/pi:
timeout 120 bin/gf -I tools/pi doc --build-json
timeout 30 bin/gf -I tools/pi doc "pi-event-session" # 查看函数源码与测试参照 pi 源码(~/git/pi)的三层包结构设计——packages/ai(provider 层)、
packages/agent(循环层)、packages/coding-agent(应用层);goldfish 对齐为
tools/pi/liii/ 下的多级子库(同 (liii datetime xxx) 先例):
tools/pi/liii/
pi.scm # (liii pi) 门面:公开 API 再导出
pi/
cli.scm # (liii pi cli) CLI 入口(gfproject.json 注册指向)
types.scm # (liii pi types) 类型门面与再导出
message.scm # (liii pi message) 消息 record 与类型定义(message/record.scm, message/types.scm)
event.scm # (liii pi event) 事件 record 与类型定义(event/record.scm, event/types.scm)
tools.scm # (liii pi tools) 工具 record 与类型定义(tools/record.scm, tools/types.scm)
config.scm # (liii pi config) 配置 record 与类型定义(config/record.scm, config/types.scm)
extension.scm # (liii pi extension) 扩展机制门面(API、注册容器、生命周期分发)
extension/ # 扩展机制子模块(api, registry, discovery, loader, hooks)
extensions/ # ★ 内置轻量扩展(随包分发:web-search, simplify, code-review)
models.scm # (liii pi models) 模型目录解析与表格输出(models/list.scm)
gemini.scm # (liii pi gemini) Gemini provider(gemini/core, request, stream, stream-parse)
anthropic.scm # (liii pi anthropic) Anthropic provider(anthropic/core, request, stream, stream-parse)
kimi.scm # (liii pi kimi) Kimi provider(kimi/core, msg, request, stream, stream-parse)
deepseek.scm # (liii pi deepseek) DeepSeek provider(兼容网关路径与 OpenAI 协议)
provider.scm # (liii pi provider) Provider 统一分发调度(含 glm 路由至 anthropic 链路)
auth.scm # (liii pi auth) 凭据解析(auth.json + 环境变量 fallback)
retry.scm # (liii pi retry) 指数退避重试(≈ ai/src/utils/retry)
agent.scm # (liii pi agent) Agent 循环与事件发射(≈ packages/agent)
prompt.scm # (liii pi prompt) 系统提示词与项目上下文(≈ core/system-prompt.ts)
session.scm # (liii pi session) 会话持久化与恢复(≈ core/session-manager.ts)
args.scm # (liii pi args) 参数解析与输入组装(≈ cli/)
modes.scm # (liii pi modes) print/json 输出模式(≈ modes/print-mode + json-event)
read.scm # (liii pi read) read 工具
write.scm # (liii pi write) write 工具
edit.scm # (liii pi edit) edit 工具
bash.scm # (liii pi bash) bash 工具
grep.scm # (liii pi grep) grep 工具
find.scm # (liii pi find) find 工具
ls.scm # (liii pi ls) ls 工具
truncate.scm # (liii pi truncate) 输出截断
help.scm # (liii pi help) 帮助信息
time.scm # (liii pi time) 时间辅助
template.scm # (liii pi template) 模板辅助
无平铺族:(liii pi-xxx) 形式的模块一律不存在——CLI 入口也是多级子库
(liii pi cli),所有代码只以 (liii pi) 与 (liii pi xxx) 两种形式组织。
分层与拆分规则:二级子库(如 (liii pi gemini))是导出函数的层面——
对外公开该域的 API;单文件 300 行放不下就把实现继续拆到下一层子文件
(如 pi/gemini/request.scm、pi/gemini/stream.scm,由 (liii pi gemini) 统一
导出),与 bin/gf check 的 300 行硬约束一致。
函数文档放哪:goldfish 的函数文档 = 测试文件本身(<函数名>-test.scm,
gf doc 从中提取源码与用法)。测试目录镜像源码库结构——(liii pi gemini)
的函数测试在 tools/pi/tests/liii/pi/gemini/<函数名>-test.scm,更深层子文件
(pi/gemini/request.scm)的在其同名子目录下,以此类推。
进度(2026-10-19):
- ✅ 任务 001:文件物理归口
tools/pi/liii/ - ✅ 任务 002:测试迁至
tools/pi/tests/liii/pi/,doc 索引重建 - ✅ 任务 003:模块名与目录统一,彻底消除平铺模块,二级子库全部落位
- ✅ 任务 004-007:事件、消息、配置、工具全面 record 化(保持外部兼容)
- ✅ 任务 008:Kimi provider 完整支持(非流式、流式、工具调用与错误处理)
- ✅ 任务 015:record 化收尾全量真实冒烟通过
- ✅ 任务 017:测试去除对计划文档(Agents.md)的硬依赖
- ✅ 任务 018:
--list-models命令支持与对齐格式化输出 - ✅ 任务 019:GLM provider 完整支持(复用 Anthropic 兼容网关链路)
- ✅ 任务 020:DeepSeek provider 完整支持(独立子库与兼容网关支持)
- ✅ 任务 021:PR 1141 CI 跨平台全绿门禁修复(macOS/Linux/Windows)
-
GLM 5.3 系列接入【可用】(任务 028 已验收):重点支持 GLM 5.3 系列,具备 100 万超长上下文窗口并原生支持思考模式与工具调用。推荐模型:
glm-5.3(1M 上下文旗舰主力)、glm-5.3-flash(1M 上下文轻量高速版)、glm-5-turbo(200K 上下文日常开发)、glm-4.5-air。已实测用法:# 使用 GLM-5.3 主力模型提问(实测 2026-10-19,退出码 0) timeout 120 bin/gf pi --provider glm --model glm-5.3 -p "用一句话解释 Scheme 的 continuation" # 使用 GLM-5.3-Flash 高速模型执行 Bash 工具任务(实测工具调用) timeout 180 bin/gf pi --provider glm --model glm-5.3-flash --tools bash -p "统计 tests/ 目录下的测试用例总数" # 列出全部 glm 模型(6 条:5.3/5.3-flash/5-turbo/4.5-air/4.5/4-flash) bin/gf pi --provider glm --list-models
注:glm 模型目录的合并逻辑零改动覆盖,用户自定义目录改由
<provider>.json/<provider>/<model>.json提供;验收脚本tools/pi/devel/028.scm41/41 全绿。 -
DeepSeek v4 系列接入【可用】(任务 029 已验收):经由
https://api.deepseek.com/anthropic端点接入。推荐模型:deepseek-v4-flash(1M 上下文旗舰版,支持深度思考链与代码工具调用)、deepseek-chat(通用对话)、deepseek-reasoner(强化推理版)。已实测用法:# 使用 DeepSeek V4 Flash 进行代码问答(实测 2026-10-19,退出码 0) timeout 120 bin/gf pi --provider deepseek --model deepseek-v4-flash -p "解释尾递归优化的原理" # 使用 DeepSeek V4 Flash 配合 Bash 工具审查变更(实测管道+工具调用) git diff | timeout 180 bin/gf pi --provider deepseek --model deepseek-v4-flash --tools bash -p "审查当前 git diff 并提出改进建议" # 列出全部 deepseek 模型(5 条:chat/flash/reasoner/v4-flash/v4-pro) bin/gf pi --provider deepseek --list-models
注:模型目录来自用户自定义配置(
<provider>.json模型白名单 +<provider>/<model>.json模型文件)。 -
MiniMax 中国大陆版接入【可用】(任务 030 已验收):复用 auth.json 中的
sk-cp-...凭据,接入https://api.minimaxi.com/anthropic。模型:MiniMax-M3.1-Flash(1M 上下文、524K 最大输出,轮换池主力——特别快)、MiniMax-M3(1M/512K 多模态旗舰)、MiniMax-M2.7(204.8K)与MiniMax-M2.7-highspeed(高速版)。已实测用法:# 使用 MiniMax-M3.1-Flash 主力模型提问(实测 2026-10-19,秒回) timeout 120 bin/gf pi --provider minimax-cn --model MiniMax-M3.1-Flash -p "用 Scheme 实现快速排序" # 使用 MiniMax-M3 调用 Bash 与读写工具处理实际任务(实测工具调用) timeout 180 bin/gf pi --provider minimax-cn --model MiniMax-M3 --tools read,bash,write -p "运行 git status 并总结当前工作区状态" # 大陆站别名 provider 与模型目录 bin/gf pi --provider minimax-cn --list-models
注:minimax 与 minimax-cn 双 provider 均可用;环境变量 MINIMAX_API_KEY / MINIMAX_BASE_URL 可覆盖(任务 035 env 优先体系)。
-
4 字节 UTF-8 + '<' 挂起:prompt 同时含 4 字节 UTF-8 字符(如 🚀、𠀀)与
<时进程静默挂起且连 HTTP 300s 超时都不生效(复现:timeout 60 bin/gf pi -p '🚀 <')。【待重做】 -
thinking 内容:思考级别的请求与解析。预期用法(实现时以 pi 实际 CLI 为准):
# 指定思考级别(off / minimal / low / medium / high / xhigh / max;未指定时取 settings.defaultThinkingLevel) timeout 300 bin/gf pi -p --thinking high "分析这段递归的时间复杂度并优化" # JSON 事件流中出现 thinking 增量块(assistantMessageEvent type 区分 text/thinking) timeout 300 bin/gf pi --mode json --thinking low "证明:任意三角形内角和为180度" > t.jsonl
实现要点:请求侧 Gemini 走
generationConfig.thinkingConfig(含includeThoughts), Anthropic 走 thinking block;响应侧 thinking part 解析进消息结构但 print 模式 默认只输出 text 块。 -
图片输入:
@文件扩展支持图片。预期用法:# @路径指向图片时作为图像 part 注入(而非文本 file block) timeout 300 bin/gf pi -p @screenshot.png "这张截图里的报错是什么?" timeout 300 bin/gf pi -p "对比这两个界面" @ui-v1.png @ui-v2.png
实现要点:按扩展名/MIME 判断图片类型,Gemini 走
inlineDatapart(base64), Anthropic 走imagesource block;不支持的格式明确报错。 -
交互式 TUI 终端模式(第二阶段重点任务):基于刚刚合入主干的通用终端 UI 库
(liii tui)(PR #1159),实现与原生 pi 深度对齐的原生交互模式。预期用法:# 缺省无参时自动进入基于 (liii tui) 的交互终端界面 bin/gf pi # 指定 provider / model 进入交互会话 bin/gf pi --provider google --model gemini-3.8-flash
实现要点:
- 核心事件循环与
(liii tui terminal)非阻塞按键轮询(081/082); - 底部多行 Prompt 输入框(集成
(liii tui editor),支持单行/多行编辑、光标移动、历史记录上下翻阅)(083); - 响应式多分区视口与窗口 Resize 动态自适应(084);
- 历史消息自然折行排版(全面支持 CJK 汉字与 Emoji 2 列视觉显示宽度)与流式 SSE 增量文本行差分无闪烁实时打字(085/086);
- Thinking 深度思考过程折叠/展开组件(087);
- 工具调用动态看板(带多帧动画 Spinner 与原地完成态覆盖)(088);
- Slash 命令悬浮弹出与自动补全菜单(089);
- 人在回路敏感工具调用(write/edit/bash)模态交互确认弹窗(090);
- 全局快捷键(Ctrl+C 中断、Ctrl+L 清屏、/help 手册)(091);
- 基于虚拟终端
(make-virtual-terminal)的 100% 确定性自动化 CI 回归测试(092)。
- 核心事件循环与
不做项:
- RPC 模式(IDE 跨进程 JSONL over stdio,非当前核心需求)
- 项目级
.pi/settings.json读取(首期只读全局 settings.json,暂不引入 trust 门控概念)
基于 Gemini 原生 Search Grounding(或 DeepSeek Search/Fetch API),与 pi 本尊
pi-web-search 扩展行为对齐。已剥离为内置扩展(extensions/web-search.scm,
实现库 (liii pi web-search))且默认启用:无需 --tools 指定,
--exclude-tools web_search 可关闭;后端切换与配置详见「常用内置扩展」章节。
# 默认已启用,直接搜索(无需 --tools web_search)
timeout 280 bin/gf pi -p "搜索 Goldfish Scheme 最新版本并给出引用来源"
# JSON 模式事件:tool_execution_start(query/urls)→ tool_execution_end(sources/details)
timeout 280 bin/gf pi --mode json -p "..."实现要点:googleSearch 节注入(幂等/与 functionDeclarations 共存)、groundingMetadata 三要素解析(webSearchQueries/groundingChunks/groundingSupports,对齐 extractGoogleSearchDetails)、 Sources/Additional Results 拼装、7 类错误路径(401/403/超时/非 JSON/空 candidates 等)。
本节由自举试验的差距分析维护:每次
bin/gf pi尝试执行真实任务失败时, 分析它与 pi(node 版)的差距并登记在此,作为bin/gf pi改进的规划依据。
| # | 差距 | 证据(失败的任务/场景) | 状态 |
|---|---|---|---|
| 1 | < 组合导致请求挂起 |
阶段五冒烟 '🚀 <'(pi 正常处理同类 prompt) |
✅ 已修复(任务 014:会话级超时兜底) |
| 2 | 无 --mode rpc(pi 有 JSONL over stdio 的 RPC 模式,IDE/长会话集成需要) |
pi docs/rpc.md;bin/gf pi 仅 print/json | 未规划(Non-goal 暂缓) |
| 3 | OAuth 类凭据不消费(pi 支持 oauth 轮换) | auth.json 的 oauth 条目 | 不做(用户裁定:维护费劲;当前各 provider 均用 api_key/环境变量) |
| 4 | thinking 内容不请求不解析 | --thinking 用法在 TODO |
远期(任务 012) |
| 5 | 图片输入不支持 | @图片 用法在 TODO |
不做(用户裁定 2026-10-19:任务 013 取消) |
| 6 | --model 不跨 provider 自动路由:bin/gf pi 只在当前 provider(--provider 或 defaultProvider)内解析模型 ID;pi 的 model-resolver 会在全部 provider 模型目录中搜索 ID,命中即隐式选定 provider(如 pi -p --model k3 自动路由到 kimi) |
实测:bin/gf pi -p --model k3 把 k3 发给 Google 得 HTTP 404,而 pi 正常路由 |
✅ 已修复(任务 022) |
| 7 | Windows 下 bash 工具挂死:子进程 spawn 方式在 Windows 不可用,bash 工具执行任何命令均挂到超时(纯文本对话正常);bin/gf pi 因此无法跑 git/测试命令,是自举(CLAUDE §5.5)的前置缺陷 | 实测(2026-10-19):timeout 180 bin/gf pi --mode json --tools bash "用 bash 工具运行命令 echo win-bash-ok" → tool_execution_end "Command timed out after 120 seconds" isError:true |
修复中(任务 026,优先) |
| 8 | 会话级超时兜底(任务 014,默认 600s)无法从 CLI 放宽:args.scm 无 --session-timeout 选项,--timeout 只管 bash/HTTP;自举执行大体量开发任务必在 ~10 分钟被 Session timeout exceeded 打断(pi 无此硬上限)。注:012/022 曾误判为 --timeout 7000 解决,实为任务恰好在 600s 内完成 |
实测(2026-10-19):任务 025/031 开发阶段自举均运行 ~10 分钟被会话兜底终止 | ✅ 已修复(任务 031:--session-timeout <秒>,0 关闭兜底) |
| 9 | retry.provider 嵌套节 |
可重试 provider 错误(429/5xx/408/409/网络错误)现使用 retry.provider.maxRetries 预算(本机=12),未配置嵌套节时回退 retry.maxRetries(缺省 3),与 pi 的 SDK maxRetries 语义对齐 |
✅ 已修复(任务 032:TDD 覆盖嵌套解析/缺省回退/stub server 429 预算窗口 3.5b/3.5c) |
| 10 | KIMI_API_KEY 环境变量兜底未生效:auth 解析只读 auth.json 的 kimi-coding 条目,env 被忽略——假 key 也返回周配额 403(而非 401),证明请求从未携带 env key;阻塞三把 kimi key 分摊配额 |
实测(2026-10-19):KIMI_API_KEY=sk-bogus bin/gf pi --provider kimi-coding --model k3 返回周配额 403;对照:同 hongwei key KIMI_API_KEY=... pi --provider kimi-coding --model k3 本尊返回 ok(pi 源码 env-api-keys.ts 同名变量、env 优先) |
✅ 已修复(任务 035:env > auth.json 统一五个 provider;修复后假 key 实测返回 401;验收脚本 035.scm 27/27) |
| 11 | deepseek 首轮 tool_use 参数解析崩溃:Error: (value-error (("input") " must be null, pair, or list with at least 2 elements"))——会话记录仅 2 行(session+user),崩溃发生在首轮 API 响应解析(未执行任何工具);037 开发两次拉起同点确定性复现(030/033/036 用 deepseek 未触发,疑与 deepseek 某类 tool_use 参数形状相关,如 input 为 JSON 字符串/嵌套形状) |
实测(2026-10-20):037 开发第 1/2 次拉起均在加载 Agents.md 首轮响应后秒崩,会话 jsonl 取证 | ✅ 已修复(任务 050:根因 C++ json_write_object_entry 对单元素 list 约束 + 空参数 cons 退化;anthropic-normalize-input/parse-tool-arguments 多形态兼容;deepseek 工具调用实测恢复) |
| 12 | deepseek 流式间歇性 HTTP 400 stream error:验收阶段大上下文拉起偶发连续中断(非每次——039 文档/开发、040 文档/开发均 deepseek 成功;039 验收×2 与 040 验收×1 连续遇到)——疑 deepseek 网关对某类大 prompt 流式响应的偶发拒绝;未定位到请求体差异 |
实测(2026-10-20):三次同错(/tmp/pi-goldfish-run.log 取证),换模型即恢复 | 观察中(复现频繁时登记修复任务;当前以换模型规避) |
| 13 | goldfish2 快照同步盲区:任务改动主库 goldfish/liii/ 且未 commit 时,git 同步拿不到工作区改动,执行器(goldfish2 bin/gf)加载工作区 pi 代码报 unbound variable ~S in ~S(052 改 date-time 主库两次触发);修复:同步时 diff 主库并拷贝未提交文件 |
实测(2026-10-20):052 验收两次秒崩,cp date-time.scm 后恢复;附带发现错误消息 ~S 占位符未替换的 cosmetic bug(观察中) | ✅ 已修复(同步时 diff 主库并拷贝未提交文件) |
| 14 | working 状态下用户消息只能等整轮结束:无 steering(工具批次后插话)、无 follow-up(排队到自然结束)区分,待处理区也只显示队首一条;pi 本尊两者均有且分组展示全部排队消息 | 实测(2026-10-24):busy 回车的消息只能等 agent_settled 后作为新任务消费;参考 pi 本尊 agent.steer/followUp + pendingMessagesContainer | ✅ 已修复(任务 1193:pi-pending-queue 双粒度队列 + run-agent-loop 双轮询钩子 + go channel 跨线程接线 + Alt+Enter/Alt+Up 键位与分组展示,详见「steering 与 follow-up」章节) |
目前已支持五大 Provider:
- google(Gemini):官方原生 API(流式 SSE、function calling、思考能力预留)
- kimi-coding(Kimi):Moonshot AI 官方编码模型(OpenAI Chat Completions 协议兼容)
- deepseek(DeepSeek):DeepSeek 官方模型(基于兼容网关路径与 OpenAI 协议)
- glm(智谱 GLM):智谱大模型(基于 Anthropic Messages 兼容网关)
OAuth 不做(用户裁定):OAuth 类凭据(access/refresh 轮换、token 过期刷新)
整体不做——维护起来比较费劲(各家刷新端点与协议不同、token 生命周期管理持续
消耗精力)。凭据一律走 type:"api_key" 或环境变量;auth.json 中 type:"oauth"
的条目不消费。Anthropic 官方 OAuth 同理不做(本机无官方访问权限,其兼容网关
能力已被 glm 复用)。
- anthropic(Anthropic):Anthropic 协议与兼容网关(凭据缺失明确报错,支持环境变量配置)
tools/pi(bin/gf pi)及其相关测试用例采用 MIT License 授权开源。
tools/pi(bin/gf pi)及支撑库 (liii pi) 的核心架构、控制流、提示词工程与扩展模式,主要由 Node.js / TypeScript 生态中的 upstream pi 核心仓库及周边开源插件移植(Porting)而来。在此特别鸣谢以下开源原作者及项目贡献者的卓越工作:
- Mario Ortiz Manero / Earendil Works:pi 核心库
@earendil-works/pi-coding-agent - Matt Devy:pi 官方周边扩展生态
MattDevy/pi-extensions(涵盖pi-code-review、pi-simplify、pi-red-green、pi-blueprint与pi-compass) - ttttmr:联网搜索插件
pi-web-search
以上上游项目均基于宽松的 MIT 许可证发布。本项目作为跨语言演绎作品,完整保留了原作者的版权声明与许可证说明。详细的版权清单与许可证全文,请参阅 tools/pi/LICENSE。