fp-terminal — 五块卵石终端 REPL

简介

fp-terminal 是五块卵石（Five Pebbles）Agent 框架的交互式命令行界面。它基于 prompt-toolkit 构建，提供了语法高亮、自动补全、多行编辑、历史记录等现代终端体验。

通常通过主包 fp 安装，无需单独安装。

特性

REPL 交互模式 — 实时与 Agent 对话，流式输出响应
命令系统 — 内置 / 命令用于控制会话、加载插件、切换模型等
语法高亮 — 代码块自动识别并着色
自动补全 — 命令与参数 Tab 补全
多行编辑 — 支持粘贴多行文本或代码
会话历史 — 对话历史持久化存储，跨会话可回溯
多彩输出 — 基于 rich 的渲染引擎

安装

pip install fp-terminal

要求 Python >= 3.11。

Windows 用户：推荐安装 Git for Windows（安装时勾选"Git Bash"并添加到 PATH），以获得完整的 Unix 命令支持。未安装时会自动降级到 cmd.exe，仅支持 Windows 原生命令。

快速使用

启动 REPL

fp

或显式调用：

python -m fp_cli

启动后进入交互模式：

╭─ Five Pebbles ───────────────────────────╮
│ 输入 /help 查看可用命令                   │
│ 按 Ctrl+D 或输入 /exit 退出               │
╰──────────────────────────────────────────╯

🤖 你好！我是五块卵石，请告诉我你的问题。

开始对话

>> 请用 Python 写一个快速排序
# 直接输入即发送消息，Agent 会流式输出回复

>> /save session-quicksort
# 保存当前会话

>> /load session-quicksort
# 恢复历史会话

命令列表

命令	别名	说明
`/help`	`/h`	显示帮助信息
`/exit`	`/q`, `/quit`	退出 REPL
`/clear`	`/c`	清屏
`/save <name>`	—	保存当前会话
`/load <name>`	—	加载指定会话
`/list`	`/ls`	列出所有会话
`/delete <name>`	`/rm`	删除指定会话
`/model <name>`	—	切换 LLM 模型
`/plugin list`	—	列出已加载的插件
`/plugin load <name>`	—	动态加载插件
`/tool list`	—	列出可用工具
`/env`	—	查看当前环境配置
`/config <key>=<value>`	—	动态修改配置
`/reset`	—	重置当前会话上下文
`/export <format>`	—	导出会话（json/md）

快捷键

快捷键	功能
`Tab`	自动补全命令/参数
`Ctrl+C`	中断当前输出
`Ctrl+D`	退出 REPL
`Ctrl+L`	清屏
`Ctrl+R`	反向搜索历史
`Up/Down`	浏览历史命令
`Shift+Enter`	换行（多行输入）
`Ctrl+W`	删除前一个词
`Ctrl+U`	删除整行
`Ctrl+K`	删除光标至行尾

配置

通过命令行标志自定义启动行为：

# 指定配置文件
fp --config ./my-config.yaml

# 指定初始模型
fp --model claude-3-opus

# 静默模式（跳过启动横幅）
fp --quiet

# 调试模式
fp --debug

配置文件示例（YAML）：

cli:
  theme: dark          # dark / light
  multi_line: true     # 启用多行编辑
  max_history: 1000    # 历史记录条数
  stream: true         # 流式输出

依赖

依赖	版本	用途
`fp-core`	>= 0.1.0	Agent 核心引擎
`prompt-toolkit`	>= 3.0.40	终端交互框架

许可

MIT © zpb

Development Status
- 4 - Beta
Environment
- Console
Operating System
- OS Independent
Programming Language

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fp_terminal-0.1.10.tar.gz (15.9 kB view details)

Uploaded Jul 27, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

fp_terminal-0.1.10-py3-none-any.whl (15.4 kB view details)

Uploaded Jul 27, 2026 Python 3

File details

Details for the file fp_terminal-0.1.10.tar.gz.

File metadata

Download URL: fp_terminal-0.1.10.tar.gz
Upload date: Jul 27, 2026
Size: 15.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for fp_terminal-0.1.10.tar.gz
Algorithm	Hash digest
SHA256	`ae0d7c035611e48675c00fa0aa47d6a68c8a31eb0c4925e68af1fcbdae167876`
MD5	`c291f6e6e064ba74a5bf064dd84c3bb9`
BLAKE2b-256	`03c6f73929f758f08d815db8c1fbc062443a948496fe889e53789bf0fefbe061`

See more details on using hashes here.

Provenance

The following attestation bundles were made for fp_terminal-0.1.10.tar.gz:

Publisher: release.yml on zpb911km/fp-agent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: fp_terminal-0.1.10.tar.gz
- Subject digest: ae0d7c035611e48675c00fa0aa47d6a68c8a31eb0c4925e68af1fcbdae167876
- Sigstore transparency entry: 2257331616
- Sigstore integration time: Jul 27, 2026
Source repository:
- Permalink: zpb911km/fp-agent@f7caecc2eee77fd7c5e005c0318a62705bf37ef9
- Branch / Tag: refs/tags/0.1.10
- Owner: https://github.com/zpb911km
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f7caecc2eee77fd7c5e005c0318a62705bf37ef9
- Trigger Event: push