TraceTime is an Obsidian plugin that tracks and displays the last edited time of every block (paragraph, heading, code block, list, table…) in your notes, with labels aligned to the right of the document area.
Time data lives in <vault>/.obsidian/plugins/tracetime/records/, one MessagePack record per Markdown file. Note content is never stored — only block hashes, the first/last 32 normalized characters of each block, and timestamps.
Copy main.js, manifest.json, styles.css into <vault>/.obsidian/plugins/tracetime/ and enable the plugin in Settings → Community plugins.
Install the BRAT plugin and add the repository QuincySx/obsidian-tracetime.
npm install
npm run dev # watch build
npm run build # type check + production build
npm test # core logic self-tests
npm run pack # package dist/tracetime-<version>.zip
Commit and push the version bump first (npm version patch --no-git-tag-version updates all version files). In GitHub, open Actions → Release Obsidian plugin → Run workflow and choose the branch to release. Leave version empty to use package.json, or enter that same version explicitly without a v prefix.
The workflow validates the version files, runs tests and builds, then creates the tag and a draft release with the plugin files attached. Review the draft and publish it manually. Tags pushed from your terminal continue to use the same release workflow.
TraceTime 是一个 Obsidian 插件:为笔记中的每个块(段落、标题、代码块、列表、表格……)记录并显示"最后编辑时间",标签统一显示在文档区右侧。
时间数据保存在 <库>/.obsidian/plugins/tracetime/records/,每个 Markdown 文件一条 MessagePack 记录,不保存笔记正文(只存块哈希、前后各 32 个标准化字符和时间戳)。
MIT
先更新版本(npm version patch --no-git-tag-version),提交并推送代码。然后在 GitHub 打开 Actions → Release Obsidian plugin → Run workflow,选择要发布的分支;version 留空时读取 package.json,也可填写相同版本号(不加 v 前缀)。
流程会校验版本信息,运行测试和构建,再创建 tag 和带插件文件的草稿 Release。检查草稿后手动发布即可。终端推送 tag 的方式仍然可用。
The localization system supports adding new languages through the locale files in src/locales/.
Locale files use BCP 47 language tags when a regional variant is relevant (for example, pt-BR or es-ES). The locale key, file name, and runtime identifier must match exactly.
For instructions on adding a new language, see src/locales/README.md.
本地化
本地化系统支持通过 src/locales/ 中的语言环境文件添加新语言。
当需要使用区域变体时,语言环境文件应使用 BCP 47 语言标签(例如 pt-BR 或 es-ES)。语言环境键、文件名和运行时标识符必须完全一致。
有关如何添加新语言的说明,请参阅 src/locales/README.md。