终于把 Komari 通知模板改顺眼了：手把手教你自定义美化

玩 NAS 或者跑脚本的小伙伴，对消息通知这事儿肯定不陌生。不管是下载完成、系统告警还是脚本运行结果，咱们都希望能第一时间收到推送。但是，很多工具默认的通知模板简直让人一言难尽——要么排版乱七八糟，要么关键信息不突出，甚至还有一堆多余的代码字符露出来，看着就头疼。

最近我在用 Komari 的时候，也遇到了同样的烦恼。它的默认通知模板虽然功能完备，但美观度确实差点意思。作为一个对审美有追求的极客，忍不了！于是我结合社区大佬分享的参考代码，再让 AI 辅助润色，终于把这个通知模板改得顺眼多了。今天就来把这套“整容术”分享给大家。

为什么默认模板总是差点意思？

Komari 默认的通知模板样式，信息较为杂乱

其实这也不怪开发者，默认模板通常追求的是“通用性”和“稳定性”。为了兼容各种接收端（邮件、Telegram、Server酱、Pushover 等），开发者往往会使用最基础的文本格式，避免因为特殊标签导致某些渠道解析失败。

但作为普通用户，我们更关心的是“可读性”。比如：

• 标题党化：我希望一眼就能看出是“下载成功”还是“硬盘报警”，而不是看到一串 Notification from Komari。
• 重点突出：文件名、耗时、错误信息这些关键数据，能不能加粗或者用点颜色？
• 排版整洁：别让参数挤成一团空格，适当换行心里才舒服。

改造思路：借力 AI + 参考案例

由于我不太精通复杂的 HTML/CSS 嵌入逻辑，直接从头写容易把通知搞坏。我的策略是“抄作业 + 迭代”：

1. 寻找基准：先在社区里找到了之前有大神发过的 Komari 通知美化代码。这个默认代码已经解决了一部分换行和加粗的问题。
2. 提出需求：我把原始的变量列表和参考的代码扔给 AI（比如 GPT-4 或 Claude），告诉它我的具体需求。
   • “帮我改一下 HTML 模板，要加一个显眼的 emoji 图标。”
   • “把错误信息标成红色，成功信息标成绿色。”
   • “整体布局要像一个卡片，左边是状态，右边是详情。”
3. 多次调试：AI 生成的代码有时候会因为语法问题显示不全，这时候需要把报错信息回传给它，让它自己修正。经过三四个回合的拉扯，一个完美的模板就诞生了。

实操步骤： Komari 模板修改指南

虽然我不会直接贴出大段的代码（因为每个人的接收渠道和审美都不一样），但我会告诉你怎么去操作，这才是授人以渔。

第一步：找到配置入口

在 Komari 的设置面板中，找到“通知”或者“消息模板”相关的选项。通常这里会允许你自定义不同类型事件的模板，比如“任务完成”、“任务失败”、“系统心跳”等。

第二步：了解变量与语法

改造后的通知效果，排版整洁，重点突出

这是最关键的一步。你需要知道 Komari 提供了哪些变量供你调用。通常常见的变量会有：

• {{.TaskName}}：任务名称
• {{.Status}}：执行状态（成功/失败）
• {{.Message}}：详细信息或日志
• {{.Timestamp}}：时间戳

仔细阅读官方文档或模板注释，确认这些变量名，不然改半天全是 {{.Variable}} 原样输出就尴尬了。

第三步：构建你的 HTML 结构

现在的通知渠道（特别是像 Telegram、飞书、微信这类支持富文本的）基本都支持 HTML 标签。大胆地用 <b>、<span>、<div> 甚至 <table> 来构建你的布局吧。

一个小技巧：如果你想让消息在不同客户端都保持一定的格式，尽量使用简单的块级元素，少用复杂的 CSS 浮动和绝对定位。

第四步：注入逻辑美化

比如我想做一个简单的状态区分，可以在模板里加入简单的逻辑（伪代码示例）：

<!-- 只有当状态是失败时，才显示红色的警告框 -->
{{if eq .Status "failed"}}
<div style="color:red; background:#ffebee; padding:10px; border-radius:5px;">
  <b>❌ 任务执行失败</b>
  <p>{{.Message}}</p>
</div>
{{else}}
<div style="color:green; background:#e8f5e9; padding:10px; border-radius:5px;">
  <b>✅ 任务执行成功</b>
  <p>{{.TaskName}} has been completed.</p>
</div>
{{end}}

通过这种方式，你的通知就不再是机械的文本，而是一份会根据情况变色的“智能简报”。

效果对比与体验提升

修改完成后，我发送了几条测试通知。效果简直立竿见影！

• 以前：手机震一下，点亮屏幕，看到一行密密麻麻的英文和乱码，还没反应过来发生了什么就把屏幕关了。
• 现在：手机震一下，看到一条绿底黑字的卡片消息，大大的 ✅ 和标题醒目地告诉我“HD 电影下载完成”，下面甚至还贴心地列出了文件大小。这种掌控感，真的是谁用谁知道。

结语

折腾这些看似不起眼的小功能，其实也是 NAS 玩家和自建服务爱好者的乐趣所在。不需要你是编程大神，只要善用工具，把别人现成的逻辑拿来揉碎了重组，再借助 AI 的力量，你也能打造出最适合自己的数字生活环境。

如果你也有 Komari 或者其他工具的美化心得，欢迎在评论区交流，咱们一起把“强迫症”治愈到底！