@lsfcy/pi-auto-session-name
Automatically name new Pi terminal sessions from the first user message
Package details
Install @lsfcy/pi-auto-session-name from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@lsfcy/pi-auto-session-name- Package
@lsfcy/pi-auto-session-name- Version
0.2.0- Published
- Nov 11, 2026
- Downloads
- 348/mo · 348/wk
- Author
- lsfcy
- License
- MIT
- Types
- extension
- Size
- 24.5 KB
- Dependencies
- 0 dependencies · 2 peers
Pi manifest JSON
{
"extensions": [
"./extensions/auto-session-name.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
Pi Auto Session Name
从新 TUI 会话的首条用户消息异步生成标题。另提供 /autoname 手动补命名,不覆盖已有名称。
- 默认在当前会话的 provider 内按目录价格选择最便宜的文本模型,思考档取该模型支持的最低档。
- 额外发送首问最多 1000 个 Unicode 字符;不发送助手回复、工具结果或系统提示。
- 每个新会话自动尝试一次,30 秒超时,不自动重试。模型或认证缺失时不回退。
- 使用 Pi 已有认证;本包不包含凭据。标题与安全分类记录会写入会话。
- 仅 TUI 生效;已在 Pi 1.4.0 验证。需要 Node.js 22.19+。
配置
可选文件 ~/.pi/agent/auto-session-name.json,位置遵循 PI_CODING_AGENT_DIR。键名与 pi-composer-predictions 相同,改模型不必改代码:
{
"model": "provider/model-id",
"thinkingLevel": "low"
}
model:可选,完整模型名provider/id,id自身可含/(如provider/vendor/model-id)。省略或null表示自动:只在当前 provider 内按目录价格选择最便宜的文本模型,跨 provider 不自动挑选;明确指定时可以跨 provider。thinkingLevel:可选,支持off、minimal、low、medium、high、xhigh、max。省略时取模型支持的最低档;off表示不向提供方发送思考参数;模型不支持指定档位时停止本次命名,不偷偷降档。- 不提供
enabled(与预测插件不同):停用请用pi remove,避免多出一种「配置关闭但扩展仍加载」的状态。未知键一律视为配置非法。 - 文件不存在即用默认值(自动选择)。文件存在但内容非法(未知键、类型错误、超过 16KB)时本次不命名并提示检查文件,不回退到猜测的配置,也不把文件内容写入会话或终端。
- 配置在每次命名时读取:编辑后下一个新会话即生效,无需
/reload。已经命名或已结束的会话不会被改写。 /autoname的确认框会显示实际使用的模型与思考档。
安装
通过 npm 安装:
pi install npm:@lsfcy/pi-auto-session-name
然后在正在运行的 Pi 中执行 /reload,或新开会话。
本地开发
在本包目录执行:
npm ci --ignore-scripts
pi install "$PWD"
npm run check
随后在 Pi 中执行 /reload。宿主依赖由 Pi 提供,无需安装第二份 Pi。
停用
通过 npm 安装时执行 pi remove npm:@lsfcy/pi-auto-session-name;本地路径安装时在包目录执行 pi remove "$PWD"。随后 /reload;本地源码不会被删除。配置文件 auto-session-name.json 需自行删除。
本包以 MIT 许可证公开,源码随 npm 包发布。额外调用与隐私边界见上文;标题与分类记录会写入会话。
维护者为目录所有者。Pi 原生支持同等命名能力或不再使用时,移除 Pi 登记并删除本包;全部不再需要时删除本仓库即可。本包替代原先散落在 agent 目录中的脚本与测试,不新增同步服务或后台任务。