经 AI Skill Hub 精选评估，重命名工具 获评「推荐使用」。这款AI工具在功能完整性、社区活跃度和易用性方面表现出色，AI 评分 7.5 分，适合有一定技术背景的用户使用。
📚 深度解析
**为什么要使用开源工具而非商业 SaaS？**
对于个人开发者和有隐私需求的用户，本地部署的开源工具意味着数据不离本机，不受第三方服务商的数据政策约束。同时，开源工具通常没有使用次数限制和月度费用，一次安装即可长期使用，对于高频使用场景的总拥有成本（TCO）远低于订阅制商业工具。
**安装与环境准备**
重命名工具 依赖 Python 运行环境。建议通过 pyenv（Python）或 nvm（Node.js）管理 Python 版本，避免全局环境污染。对于新手用户，推荐先创建虚拟环境（python -m venv venv && source venv/bin/activate），再安装依赖，这样即使出现问题也可以随时删除虚拟环境重新开始，不影响系统稳定性。
**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues（已关闭的问题），大多数常见问题都已有解答。遇到 Bug 时，提供 pip list 的输出、完整错误堆栈和最小可复现示例，能显著提高开发者响应速度。AI Skill Hub 将持续追踪 重命名工具 的版本更新，及时通知重要功能变化。
📋 工具概览
重命名工具 是一款基于 Python 开发的开源工具，专注于 ai、ai-tools、python 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
📖 中文文档
重命名工具 是一款基于 Python 开发的开源工具，专注于 ai、ai-tools、python 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
# 方式一：pip 安装（推荐）
pip install rename
# 方式二：虚拟环境安装（推荐生产环境）
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install rename
# 方式三：从源码安装（获取最新功能）
git clone https://github.com/study8677/rename
cd rename
pip install -e .
# 验证安装
python -c "import rename; print('安装成功')"
- 访问 GitHub 仓库页面
- 按照 README 文档完成依赖安装
- 根据系统环境完成初始化配置
- 参考官方示例或文档开始使用
- 遇到问题可在 GitHub Issues 中查找解答
# 命令行使用
rename --help
# 基本用法
rename input_file -o output_file
# Python 代码中调用
import rename
# 示例
result = rename.process("input")
print(result)
# rename 配置文件示例（config.yml） app: name: "rename" debug: false log_level: "INFO" # 运行时指定配置文件 rename --config config.yml # 或通过环境变量配置 export RENAME_API_KEY="your-key" export RENAME_OUTPUT_DIR="./output"
简介
支持的工具
| 工具 | 读取 | 写入 | 状态 |
|---|---|---|---|
| **Claude Code** | ~/.claude/projects/**/<id>.jsonl | 追加一行 ai-title（纯追加——最安全的写法） | ✅ 稳定 |
| **Codex** | ~/.codex/state_*.sqlite + rollout 文件 | UPDATE threads SET title | ✅ 稳定 |
| **Cursor** | state.vscdb（composerHeaders + composerData） | 同时更新两处标题字段 | ⚠️ 实验性 |
| **Antigravity** *(Google)* | IDE: state.vscdb（antigravityUnifiedStateSync.trajectorySummaries）— Companion: ~/.gemini/antigravity/agyhub_summaries_proto.pb | 重写对应 CascadeTrajectorySummary 的 summary 字段（Companion 走原子 rename 重写文件） | ⚠️ 实验性 — [看说明](#antigravity-说明) |
| **Continue** *(continue.dev)* | ~/.continue/sessions/<id>.json | 改写 title + 原子 rename | ⚠️ 实验性 |
| **Zed** *(zed.dev Assistant)* | ~/Library/Application Support/Zed/conversations/<uuid>.json 等 | 改写 summary / title + 原子 rename | ⚠️ 实验性 — schema 随 Zed 版本变 |
| **Windsurf** *(Codeium)* | state.vscdb(Cursor 分支布局) | 复用 Cursor 的写入路径,只换路径 | ⚠️ 实验性 |
| **Aider** | .aider.chat.history.md(每个项目一份) | 写到 .aider.chat.history.md.title 旁路文件(Aider 本身只读) | ⚠️ 实验性 — 只读 |
关于「应用开着时写入」。 Codex、Cursor 和 Antigravity 都把数据存在正在使用的 SQLite 数据库里。rename写入很谨慎（读取走只读连接、写入设了busy_timeout），而且只碰 空闲会话。但宿主 App 会把对话缓存在内存里，所以你在磁盘上改的标题，可能在你重新打开 那个对话时被运行中的 App 覆盖。想让结果最可靠，就在 App 关闭时让rename跑。Claude Code 的纯追加格式没有这个顾虑。
安装
brew install study8677/rename/rename
pipx install git+https://github.com/study8677/rename.git
uv tool install git+https://github.com/study8677/rename.git无需 API key,零运行时依赖。支持 macOS、Linux 和 Windows。
<br>
使用
rename status # 检测到了什么
rename list # 预览新标题(不写入)
rename once # 跑一轮然后退出
rename install # 永久后台运行后台每分钟醒一次,找空闲 ≥ 5 分钟、内容自上次改名后有变化的会话改名。 没变化的不会重写,重复运行无副作用。
<br>
---
<br>
配置
rename config 会创建并打印 ~/.config/rename/config.toml：
```toml idle_seconds = 300 # 空闲 5 分钟后改名 poll_seconds = 60 # 每分钟扫一次 batch_size = 25 # 每次扫描最多改 N 个（0 = 不限） tools = ["claude-code", "codex", "cursor"] namer = "heuristic" # heuristic | claude | codex | anthropic | openai max_age_days = 7 # 忽略超过一周未活动的会话 min_user_messages = 1 # 至少要有这么多条真实消息 dry_run = false
[anthropic] model = "claude-haiku-4-5"
命名后端（namer）—— 无需 API key
默认的 auto 完全不需要 API key：rename 直接复用你已经登录的 claude 或 codex 命令行来生成高质量标题；两个都没装时，退回完全离线的启发式。你一个字 的 key 都不用填。
namer | 作用 | 要 API key 吗？ |
|---|---|---|
auto | 用你已登录的 claude / codex CLI，否则 heuristic | **不要** · 默认 |
heuristic | 把你最近一条消息清洗成标题；即时、离线 | 不要 |
claude | 始终用 claude CLI（默认快速的 Haiku 模型） | 不要——复用登录 |
codex | 始终用 codex CLI（gpt-5-codex） | 不要——复用登录 |
anthropic | 直连 Anthropic API,用**你自己的 key** | api_key 或 ANTHROPIC_API_KEY |
openai | 直连 OpenAI API,用**你自己的 key** | api_key 或 OPENAI_API_KEY |
开箱即用、零配置、不用粘贴任何 key，你就能得到 LLM 质量的标题（花的是你已有的 额度）。想要零成本/完全离线？设 namer = "heuristic"。
用自己的 API key。 想用自己的 Anthropic / OpenAI 账号而不是已登录的 CLI?把 namer 设为 "anthropic"(或 "openai"),然后在 config.toml 对应的小节里填上 api_key = "sk-...",或导出 ANTHROPIC_API_KEY / OPENAI_API_KEY 环境变量。在桌面 app 里就是 设置 → Namer:选好服务商、把 key 粘进去即可。key 只会写进你本机的 config.toml(权限锁成 chmod 600,只有你能读),对话摘录也只发给你选的那家服务商。
rename status # 会显示 auto 实际解析到了谁，例如 "namer=auto → claude"---
api_key = "sk-ant-..." # 你自己的 key(或设 ANTHROPIC_API_KEY)
[openai] model = "gpt-4o-mini"
api_key = "sk-..." # 你自己的 key(或设 OPENAI_API_KEY)
```
任何字段都能在单次运行时覆盖：rename run --idle 600 --namer anthropic --tool cursor。
常见问题
会和工具自带的自动命名打架吗? 不会。工具只命名一次就停了；rename 只在会话空闲后才动手，两者不会同时写。
会覆盖我自己设的标题吗? 不会——除非你给那个会话发了新消息。在对话真正往前走之前，人工标题都会被尊重。
需要填 API key 吗? 不需要。默认会复用你已登录的 claude / codex CLI（不用粘贴任何 key），花的是你 已有的额度；想零成本就设 namer = "heuristic"（完全离线）。
一直开着安全吗? 安全——这就是它的设计目标。见工作原理。唯一的注意点是「Cursor 开着时改它的数据库」（见上文）。
装上 rename 之后，我之前那些旧聊天会怎么样? 默认什么都不会发生。首次运行会记一个基线时间戳，后台只会改"基线之后才活跃" 的会话。想把积压的历史也跑一遍？点 dashboard 上的 "改名历史会话"， 或者跑 rename once --historical --dry-run 先预览，没问题再去掉 --dry-run。
rename 是一个用于自动更名的工具，支持多种工具和命名算法，旨在提高用户体验和安全性。
rename 支持多种工具，包括 Claude Code、Codex、Cursor 和 Antigravity，能够读取和写入相应的数据文件，提供稳定和实验性功能。
rename 不需要任何环境依赖或系统要求，支持 macOS、Linux 和 Windows。
安装 rename 可以使用 brew、pipx 或 Git 来获取源码，支持 macOS、Linux 和 Windows，零运行时依赖，且无需 API key。
rename 的使用包括检测、预览、新标题、安装和后台运行，支持 macOS、Linux 和 Windows，零运行时依赖，且无需 API key。
rename 的配置文件位于 ~/.config/rename/config.toml，包含 idle_seconds、poll_seconds、batch_size、tools、namer、max_age_days 和 min_user_messages 等参数。
rename 的命名后端（namer）支持 auto、heuristic、anthropic 和 openai 等算法，无需 API key，直接复用已登录的 claude 或 codex 命令行生成高质量标题。
rename 的常见问题包括不会和工具自带的自动命名打架、不会覆盖自己设的标题、不需要填 API key 等，安全且零成本。
实用性工具，简化AI代码会话管理
- 构建多智能体协作系统的 Agent 开发者
- 跨境业务、多语言内容运营团队
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- Python 依赖冲突：建议用 venv / uv 隔离环境
- CLI：直接 npm install -g / pip install，命令行调用
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
⚡ 核心功能
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 构建多智能体协作系统的 Agent 开发者
- 跨境业务、多语言内容运营团队
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- Python 依赖冲突：建议用 venv / uv 隔离环境
👥 适合人群
🎯 使用场景
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
⚖️ 优点与不足
- +MIT 协议，可免费商用
- +完全开源免费，无授权费用
- +本地部署，数据完全自主可控
- +开发者社区支持，遇问题可查可问
- −安装和初始配置可能需要一定技术基础
- −功能完整性通常不如成熟商业产品
- −技术支持主要依赖开源社区，响应速度不稳定
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
✅ MIT 协议 — 最宽松的开源协议之一，可自由商用、修改、分发，仅需保留版权声明。
🔗 相关工具推荐
❓ 常见问题 FAQ
AI Skill Hub 点评：重命名工具 的核心功能完整，质量良好。对于AI 技术爱好者来说，这是一个值得纳入个人工具库的选择。建议先在非生产环境试用，再逐步推广。
| 原始名称 | rename |
| 原始描述 | 开源AI工具：Keep your AI coding sessions named after what they actually became — Claude Code。⭐13 · Python |
| Topics | aiai-toolspython |
| GitHub | https://github.com/study8677/rename |
| License | MIT |
| 语言 | Python |
收录时间：2026-06-05 · 更新时间：2026-06-06 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。