relnotes
开源的 changelog 生成工具,读取两个 git ref 之间的提交记录,通过本地开源 LLM 改写成分组的用户可读发布日志,支持任何 OpenAI 兼容端点
时间轴 (近 90 天)
relnotes 是一个开源 CLI 工具,读取两个 git ref 之间的 git log,将其改写成分组、面向用户的英文 changelog 条目。
relnotes 在 github.com/Mystical89/relnotes 开源,采用 MIT 协议,要求 Python 3.10+,无第三方依赖,并附带 5 个通过的测试。
relnotes 不绑定特定模型服务,而是对接任何 OpenAI 兼容端点,默认使用 Ollama 的 qwen2.5:3b 模型,并可通过 flag 切换到 LM Studio、llama.cpp 或 vLLM。
relnotes 使用一段严格的 system prompt 来保证改写质量:按 Added / Fixed / Changed 分组,每条不超过 12 个词,不允许出现 commit hash、文件名以及 'refactor'、'chore' 等黑话,无信息量的提交直接丢弃。
relnotes 的温度设为 0.3,使同一次发布运行两次能得到基本一致的输出。
relnotes 提供离线回退路径:在没有模型可用时(--offline),基于 Conventional Commits 驱动分组生成 changelog,结构与模型输出保持一致。
relnotes 提供 Hermes skill,遵循 Agent Skill Open Standard,允许 agent 通过自然语言命令调用该 CLI 生成 release notes。
作者对 relnotes 的定位是:不是又一个 changelog 生成器,而是把写 changelog 这件事压缩成一条命令。
作者认为提交历史不应该离开本机,因为 commit message 会泄露内部项目名、未发布的功能,偶尔还有被误粘贴进去的密钥。
relnotes 项目目前还没有真实用户,这是项目第一天。
还有 1 条时间轴事件
全部知识事实 (11)
relnotes 是一个开源 CLI 工具,读取两个 git ref 之间的 git log,将其改写成分组、面向用户的英文 changelog 条目。
50%待验证relnotes 在 github.com/Mystical89/relnotes 开源,采用 MIT 协议,要求 Python 3.10+,无第三方依赖,并附带 5 个通过的测试。
50%待验证relnotes 不绑定特定模型服务,而是对接任何 OpenAI 兼容端点,默认使用 Ollama 的 qwen2.5:3b 模型,并可通过 flag 切换到 LM Studio、llama.cpp 或 vLLM。
50%待验证relnotes 使用一段严格的 system prompt 来保证改写质量:按 Added / Fixed / Changed 分组,每条不超过 12 个词,不允许出现 commit hash、文件名以及 'refactor'、'chore' 等黑话,无信息量的提交直接丢弃。
50%待验证relnotes 的温度设为 0.3,使同一次发布运行两次能得到基本一致的输出。
50%待验证relnotes 提供离线回退路径:在没有模型可用时(--offline),基于 Conventional Commits 驱动分组生成 changelog,结构与模型输出保持一致。
50%待验证relnotes 提供 Hermes skill,遵循 Agent Skill Open Standard,允许 agent 通过自然语言命令调用该 CLI 生成 release notes。
50%待验证作者对 relnotes 的定位是:不是又一个 changelog 生成器,而是把写 changelog 这件事压缩成一条命令。
50%待验证作者认为提交历史不应该离开本机,因为 commit message 会泄露内部项目名、未发布的功能,偶尔还有被误粘贴进去的密钥。
50%待验证relnotes 项目目前还没有真实用户,这是项目第一天。
50%待验证relnotes 的仓库结构包含 relnotes.py(CLI 主体)、test_relnotes.py(测试)和 skills/relnotes/ 目录(agent 技能)。
50%