First Sentence Title

保存笔记时，自动把「正文第一句」或「标题行」填成文件名（Obsidian 的标题就是文件名）。

很多笔记软件都有这个能力：写完第一句话，文件名就自动变成这句话。本插件把这个体验带到 Obsidian，而且是自动的——你正常写、正常保存（或自动保存），标题自己就填好了，不需要任何手动操作。

它能做什么

新建 / 粘贴笔记后，满足下面任一条件就会自动重命名文件（即设置标题）：

1. 第一句以句号结尾：正文里出现第一个「。」，就取「。」之前的内容作为文件名。
2. 标题行 + 回车换行：正文第一行（会自动忽略 # 标题语法）较短、且后面还跟着正文——比如你从别处粘贴了一份带标题的报告，第一行那句标题就会直接变成文件名。

重命名通过 Obsidian 原生 fileManager.renameFile 完成，指向这篇笔记的 [[双链]] 会自动同步更新，不会断链。

设计上的几个防误触

• 不会半句就改名：第一句规则只在出现「。」后才触发；标题行规则要求第一行「短 + 后面有正文」，所以你正在打一个长段落时不会 premature 改名。
• 同名保护：目标文件名已存在时放弃重命名，不会覆盖别人的笔记。
• 可跳过目录：默认跳过 .obsidian、.workbuddy、copilot、对话稿/原始ai对话txt，可在设置里增删。
• 非法字符清洗：文件名里的 \ / : * ? " < > | # ^ [ ] 会自动去掉，符合 Windows 命名规则。

设置项

设置	说明
启用	总开关
标题最大长度	最终文件名截断到的字符数（默认 60）
标题行最大长度	第一行短于此值且后面有正文时，直接用该行做标题；设为 0 可关闭「标题行 + 换行」规则（默认 40）
跳过目录	逗号分隔，从 vault 根算起

另外，命令面板里还有一条 「对当前笔记立即执行（第一句/标题行→标题）」，可对任意已存在的笔记手动触发一次。

安装

方式一：BRAT（推荐，立即可用，无需等上架）

1. 在 Obsidian 社区插件市场安装并启用 BRAT。
2. 命令面板运行 BRAT: Add a beta plugin for testing。
3. 填入本仓库地址（把下面的 <用户名> 换成实际地址）： https://github.com/<用户名>/first-sentence-title，确认添加并启用。

方式二：官方社区插件商店（上架后）

待本插件在 Obsidian 社区目录 审核通过后，直接在 设置 → 第三方插件 → 浏览 里搜索 First Sentence Title 安装即可。

方式三：手动侧载（安卓 / 鸿蒙兼容容器 / 离线）

把本仓库的 main.js 和 manifest.json 两个文件放进 vault 的 .obsidian/plugins/first-sentence-title/ 目录，重启 Obsidian 并在 设置 → 第三方插件 中启用即可。

鸿蒙（HarmonyOS）系统下通过「卓易通」等安卓兼容容器安装的 Obsidian 安卓版，与上述安卓侧载方式完全一致。

许可

MIT License. © 2026 WorkBuddy · 小台