@cnife/pi-auto-naming-session

Auto-generate and refresh session titles at turn boundaries

Packages

Package details

extension

Install @cnife/pi-auto-naming-session from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@cnife/pi-auto-naming-session
Package
@cnife/pi-auto-naming-session
Version
0.4.2
Published
Jul 29, 2026
Downloads
163/mo · 18/wk
Author
cnife
License
MIT
Types
extension
Size
22 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@cnife/pi-auto-naming-session

在 pi 中自动生成并周期性刷新会话标题，让标题反映对话的全貌。

功能

  • 首条消息后立即生成初始标题，无需等待 agent 回合
  • 每 N 个 turn 周期刷新，综合整段对话重新提炼标题
  • 手动改名后自动停止覆盖
  • 标题语言可配置

安装

pi install npm:@cnife/pi-auto-naming-session

配置

配置文件位于 ~/.pi/agent/cnife-auto-naming-session.json（<agent-dir> 由 PI_CODING_AGENT_DIR 决定，默认 ~/.pi/agent），首次加载时自动生成默认值：

{
  "auto_refresh_turns": 10,
  "model": null,
  "language": "english"
}
字段 默认值 说明
auto_refresh_turns 10 每 N turn 自动刷新标题，null 禁用自动刷新
model null 指定模型 "provider/modelId"，null 用当前会话模型
language "english" 标题语言

使用

  • 首标题：第一条 user message 到达后立即生成（message_end 事件），不等待 agent 回合。
  • 周期刷新：agent_end 时统计自上次命名以来的 user+assistant 消息数，达阈值则综合整段对话重新生成标题。
  • 全弧线综合：每次刷新遍历整个会话分支，收集所有 user/assistant 消息文本喂给 LLM，让标题反映会话全貌而非最近片段。
  • 手动保护：检测到用户手动改过标题后，停止自动覆盖。