我的 Obsidian 日记与日报方案

虽然我本人不写日记,但是由于工作要求总是要写日报,我就希望能统一管理,于是产生了这个日记模板。
在这之前有过一版非常日常的日程模板:Obsidian动态日程(文档目前已经不再维护),但是说实话很多东西我懒得维护也不会去填。。
在做了许多功能取舍之后,有了现在已经用了小半年的日报方案。

日记主要内容是为了填写工作上的日报,仅这一块我愿意自己写(;
也有些东西每天都差不多,像日期、天气、地点、出勤状态。这套方案把后面这些交给模板处理;
因为已经接入过Activity活动记录,所以还开设了一块回忆碎片,让LLM帮我整理当日的活动并展示

文件仍然是普通 Markdown,图片保存在库内,生成过的文字也直接写进笔记,方便以后查找和整理。

一篇日记是怎样生成的

日记采用 日记-YYYY年M月D日 的命名方式,放在 Private/日记/YYYY年/MM月/ 下。Templater 从文件名解析日期,所以补写旧日记时,天气查询、节假日判断和前后篇链接都会跟着那一天走。创建未来日期的日记会被拦截,模板会尝试将对应文件移入回收站。

创建时,模板先下载一张封面,再查询这一天是工作日、普通周末、节假日还是调班日。工作日和调班日会往前找最近的出勤记录,能继承就少问一次;没有可用记录,再弹出状态和场地选择。

地点确定后,用经纬度获取天气和静态地图,最后根据日期类型生成正文布局:

日期类型日记中出现的内容
工作日、调班日出勤状态、工作项区域;符合条件时显示地图
节假日节日名称,以及生成成功时的节日文案
普通周六随机翻出一篇旧日记,生成一段“回声”
普通周日休息提示,以及本周工作回顾

这些分支看的是接口返回的日期类型。例如周六遇到调班,就按工作日处理;周日如果属于节假日,也会走节假日布局。

日记底部固定保留“记忆碎片”和“回顾记忆”入口。这个部分按需点击生成,与创建日记分开执行。

各个工具负责什么

整套逻辑主要在 Obsidian 桌面端运行。Templater 负责第一次生成,QuickAdd 负责生成后的修改,Dataview 负责把已有记录汇总展示。外部数据通过 Obsidian 的 requestUrl 获取,AI 相关内容则交给本机 OpenCode CLI。

工具或文件用途
日记模板.md日期解析、接口请求、出勤继承、节日文案、周六回声和页面布局
change-attendance.js修改出勤状态和相关布局
change-location.js选择地点,并联动更新天气、地理数据和地图区域
change-day-label.js修改日期栏中的星期显示文字
generate-aw-summary.js启动活动摘要生成,并写回当前日记
generate-aw-summary.md活动摘要提示词,约束查询范围、事实依据和文风
weekly-work.js读取本周日记里的工作项,生成横向回顾视图

要复用这套方案,需要把 QuickAdd 中的 change-attendance、change-location、change-day-label 和 daily-gen 分别绑定到对应脚本。模板中的点击入口使用 obsidian://quickadd?choice=...,名称要与 QuickAdd 配置一致。Dataview 需要能够执行 JavaScript 查询,封面的实际显示则由所用的 Banner 插件或主题处理。

AI 部分还依赖本机 Node.js、OpenCode CLI 和其中配置的模型、MCP。当前代码使用 Windows 下的固定可执行文件路径,并通过 child_process.spawn 启动,所以换电脑时要改路径,移动端也不能直接照搬这一段。

API 怎么接进来

封面:下载后保存在本地

封面地址是 https://t.alcy.cc/fj,模板发送 GET 请求,把响应中的 arrayBuffer 转成二进制内容,保存到:

Resources/pictures/diary/YYYY/MM/diary-YYYYMMDD.jpg

下载后的相对路径写入日记的 banner 属性。这样回看旧日记时,封面来自库内文件。下载失败就把路径留空,后面的日记流程继续执行。

节假日:先判断今天该用哪种布局

模板调用提莫节假日接口:

GET https://timor.tech/api/holiday/info/{YYYY-MM-DD}

当前请求没有携带 Key,主要读取返回值里的 type.type 和 type.name。前者决定日期分支,后者用于节假日名称和节日文案。日期类型的含义如下,接口说明见提莫节假日 API 文档。

type.type含义模板处理
0工作日出勤与工作项
1周末周六回声或周日回顾
2节假日节日展示和文案
3调班日按工作日处理

接口失败时,模板退回星期判断:周一到周五算工作日,周六、周日算周末。日记可以继续生成,但这时无法准确识别调休和补班,出勤状态需要手动核对。

腾讯位置服务:地点、地址和静态地图

定位首先考虑继承已有工作地点,没有有效坐标时才使用 IP 定位。模板中实际调用的是:

GET https://apis.map.qq.com/ws/location/v1/ip?key={TENCENT_KEY}

请求没有显式传入 IP。代码要求业务状态 status 为 0,再读取 result.location.lat、result.location.lng 和 result.ad_info 中的省、市、区信息。IP 定位适合提供一个默认地点;补写旧日记时,它并不能还原那一天的真实位置,需要通过地点入口修正。

修改地点的脚本还使用了地址解析和地点搜索。下面这些是现有代码中的请求形式,参数值在拼接前进行 URL 编码:

操作请求路径与主要参数
根据坐标获取地址/ws/geocoder/v1/?location={lat},{lng}&key={KEY}
根据地址获取坐标/ws/geocoder/v1/?address={地址}&key={KEY}
搜索地点候选/ws/place/v1/suggestion?keyword={关键词}&region=全国&region_fix=0&key={KEY}
生成静态地图/ws/staticmap/v2/?center={lat},{lng}&zoom=12&size=300*300&markers=color:red|{lat},{lng}&key={KEY}

这些请求都使用 https://apis.map.qq.com 作为域名,Key 通过查询参数传入。迁移时需要配置自己的腾讯位置服务 Key;腾讯接口部分依据本地调用代码整理,权限和配额需以控制台实际配置为准。

静态地图下载到 Resources/pictures/diary/staticMap/。创建模板以省、市、经纬度组合命名,文件存在就直接复用。地图可以先生成并缓存,但页面只在工作日或调班日、且状态不是请假和调休时显示。

Open-Meteo:用小时数据概括一天的天气

天气使用两个接口。当前模板对今天和昨天使用预报接口,更早的日期使用历史接口:

https://api.open-meteo.com/v1/forecast
https://archive-api.open-meteo.com/v1/archive

两者在模板中使用相同的一组查询参数:

latitude={lat}
longitude={lng}
start_date={YYYY-MM-DD}
end_date={YYYY-MM-DD}
daily=temperature_2m_max,temperature_2m_min,weather_code
hourly=weather_code,precipitation
timezone=auto

当前请求没有携带 API Key。最高温和最低温取 daily 中对应数组的第一项,天气描述则优先根据 hourly.time、hourly.weather_code 和 hourly.precipitation 计算。字段和天气代码可查阅 Open-Meteo 预报文档及历史天气文档。

这里没有直接把每天的 daily.weather_code 当成最终描述。日记更关心白天大部分时间是什么天气,所以模板取当地时间 07:00 至 22:00 的小时记录,按自己的规则做一次概括:

  1. 遇到雪、冻雨、雷暴、冰雹等显著天气,优先保留这些特征。
  2. 普通降水累计达到 3 个小时,或降水样本累计达到 2 毫米时,再把降水作为当天的主要天气。
  3. 只有短时零星降水时,从非降水时段里选择主要天气。
  4. 统计时先比较晴、多云、雾等大类,再从胜出的大类中选择出现次数最多的具体代码,避免同类天气被拆散计数。

这些阈值是模板自己的日记展示规则。小时数据无法聚合时,才退回 daily.weather_code。此外,早上创建的当天日记仍会包含后续时段的预报,不能把它理解成全天已经发生的观测记录。

天气是当前流程里的必需数据:缺少有效坐标会中断创建;请求失败最多尝试 3 次,前两次失败后分别等待 1 秒、2 秒,仍失败就抛出错误。历史接口的数据可用时间也会影响补写,现有按日期切换接口的方式不代表任意近日期都一定能取得数据。

出勤和地点怎样保留下来

工作日、调班日会向前查找 5 个自然日,读取最近一篇带有有效工作出勤状态的日记。可自动继承的状态只有“出勤、出差、驻场、外勤”,场地文字和有效的地理数据也一起继承。“居家、请假、调休”可以手动选择,但不会作为下一天自动继承的工作记录。

这种处理适合连续几天在同一地点工作的情况。当天有变化,就点击出勤或地点文字修改。出勤状态描述今天以什么方式工作,地理数据负责天气和地图,两者有关联,但仍然各有用途。

地理数据没有只留在页面文字里,还以 JSON 保存在 HTML 注释中,结构类似这样:

<!-- diary:geo:start 
{"name":"示例地点","address":"示例地址","province":"示例省","city":"示例市","district":"示例区","lat":31.2,"lng":121.4} 
diary:geo:end -->

其他可修改区域也有成对标记,比如 diary:attendance、diary:location、diary:weather 和 diary:work-items。阅读时这些注释不显示,脚本则用它们找到需要替换的范围。

修改地点时,脚本先检查地理、地点和天气标记,再准备天气与需要更新的地图数据,成功后一次性修改日记正文。这样一次请求失败时,正文不会出现地点已经改了、天气还留在旧地点的半成品。图片缓存可能已经下载到本地,这与正文写回是两个步骤。

手动整理日记时要保留这些标记,尤其是工作项的起止标记。周回顾依靠它们提取内容,删除以后,文字虽然还在页面上,汇总脚本却找不到它。

特别的日子

有些日子和法定节假日没关系,但还是想单独标一下,比如生日、纪念日,或者某件事情终于告一段落的那一天。日期栏里的星期文字可以点击,选择“🌟 特别的日子”,就能给当天换一个自己的名字。

直接输入 诞生日,日期栏就会显示金色的“🌟诞生日”,默认颜色是 #e3bc37。也可以在名称前加一个颜色值,用空格隔开:

#3fc8ff 诞生日
#abc 纪念日

颜色支持三位或六位 HEX 写法。没有符合格式的颜色前缀时,输入内容会整体作为名称,使用默认金色。想改回来,再次点击标签,选择“↩️ 恢复”即可,脚本会根据文件名中的日期恢复对应的星期名称和颜色。

这部分由 QuickAdd 的 change-day-label 调用 change-day-label.js 完成,只替换 diary:day-label 标记之间的显示内容。它是给当天留一个醒目的记号,工作日、节假日和出勤状态仍按原来的规则处理;也没有自动识别生日或每年重复提醒的逻辑,需要在对应日记里手动设置。

AI 参与的三个地方

节日文案

因为休息日没有日报项,我又懒得写日记,所以为不同的休息日设置了不同的处理逻辑,节假日就会由LLM生成不同主题的文案,放在正文。

只有日期类型是节假日、并且拿到了节日名称时,模板才调用模型生成节日文案。输入包含日期、节日和随机选出的风格,要求输出一个短标题及 40~100 个中文字符的正文。

这里给模型的任务是写节日气氛,提示词明确要求不要虚构当天经历。生成失败就不展示文案,不影响其他日记内容。

周六的旧日记回声

周六的设计是历史日记的回声,随即一篇日记进行LLM总结。

普通周六会从 Private/日记/ 中随机寻找旧日记。代码使用严格早于“日记日期减去 20 天”的条件,所以刚好相隔 20 天的记录不在候选范围内。

候选日记会先去掉属性区、地图和部分格式标记,再提取文字;提取结果不足 20 个字符时继续找下一篇。找到有效内容后,模型根据旧日记写一段约 120~220 字的回望,页面同时保留原日记链接。

提示词会传入实际相隔天数,也明确禁止编造后续经历。希望得到的是重新看到某个普通日子的感觉,比如一个当时反复修改的文件、一件琐碎的工作;输入里没有的项目结果和情绪,不应由模型补出来。

基于 ActivityWatch 的记忆碎片

“回顾记忆”由 generate-aw-summary.js 执行。它先检查当前文件名和日期,最早允许在日记日期的次日 00:05 开始整理,随后读取日记里的出勤状态,填入单独保存的提示词文件。

本地脚本通过下面的参数形式启动 OpenCode,当前配置的模型标识是 deepseek/deepseek-flash:

opencode run --format json --auto --model deepseek/deepseek-flash {prompt}

模型选择和 MCP 连接由 OpenCode 环境提供。日记脚本读取进程标准输出,按行解析 JSON 事件并拼接文本,最后将结果写回日记。它没有直接请求模型 HTTP API,也没有在脚本中直接读取 ActivityWatch HTTP 接口。

提示词要求模型通过 ActivityWatch MCP 执行以下 4 次查询,前三次分别按应用、域名和窗口标题聚合,第四次补充 OCR 关键词:

查询工具及参数要求
应用活动activitywatch_aw_get_activity,group_by=application
网站活动activitywatch_aw_get_activity,group_by=domain
窗口标题activitywatch_aw_get_activity,group_by=title
OCR 信息activitywatch_aw_get_raw_events,bucket_id=aw-watcher-enhanced_Cwl-Notebook,response_format=raw

所有查询的时间范围都要求显式使用北京时间,从 {date}T00:00:00+08:00 到 {date}T23:59:59+08:00。OCR 查询只分析 data.ocr_keywords 非空的事件,应用、域名和标题仍是主要依据。换设备时,除了 CLI 路径,也要核对这里固定写入的 bucket 名称。

模型需要把这些线索写成第一人称、单个自然段,长度约 500~800 个中文字符。窗口标题只能说明曾经查看或处理过某件事,不能据此断言项目已经完成;OCR 也只能补充细节,不能单独撑起一整段经历。

查询次数、事实边界和文风目前主要由提示词约束,脚本没有逐条核验模型的工具调用。生成的文字仍值得自己读一遍,尤其是工作成果、地点和现实经历这些容易被写过头的部分。

周日怎样汇总工作

周日页面通过 dv.view 加载 Resources/script/Dataview/weekly-work.js。脚本从当前日记日期往前取 6 天,得到周一到周日,再逐篇读取 diary:work-items:start 与 diary:work-items:end 之间的内容。

工作项可以继续按普通 Markdown 列表填写:

<!-- diary:work-items:start -->
1. 梳理接口参数,补充异常返回说明。
2. 排查测试环境问题,记录复现条件。
<!-- diary:work-items:end -->

这些只是格式示例,实际内容由当天填写。周回顾会按天横向排列,周一到周五即使没有内容也保留一列,空白显示为 —;周六和周日只有提取到非空工作项时才展示。

当前视图按行展示原文,没有再次调用模型总结,也不会把它改写成周报。它在查看时读取原日记,补充工作项后可以随视图重新执行而更新;这与已经写入文件的 AI 文案不同。

失败时会发生什么

这些功能的失败处理各不相同,使用时需要知道哪里能继续、哪里需要重试。

出问题的环节当前处理方式
封面下载留空,继续创建
节假日查询按星期判断,调休准确性下降
IP 定位先记录失败;没有有效坐标时,后续天气检查会中断创建
静态地图下载不返回有效地图路径,页面可继续生成
天气查询或数据校验最多尝试 3 次,最终失败则中断创建
节日文案、回声生成进程启动失败或非零退出时返回空文案
活动摘要的前三次 MCP 查询提示词要求停止并返回“回顾记忆”入口
OCR 查询提示词允许忽略,继续使用前三次结果
活动摘要进程失败或返回空文本脚本提示失败,但当前代码没有自动恢复已替换的生成中占位文字

AI 子进程目前也没有显式超时处理;如果进程一直不退出,等待时间可能很长。这里的失败返回规则有一部分在脚本里,有一部分在提示词里,两者的约束强度不同。

平时怎么用

创建当天日记后,先看出勤地点是否正确,再把当天要记录的工作逐条写在工作项区域里。默认地点能继承,但出差结束、临时居家或补写旧日记时,需要自己改一下。

第二天有空时,再点前一天的“回顾记忆”,用活动记录补齐容易忘掉的电脑使用片段。周六偶尔翻一篇旧记录,周日看看本周的工作项。日记里的主体内容仍由自己决定,自动化只是省下重复填写和翻找记录的时间。

如果迁移到另一套库,优先核对文件命名、目录、QuickAdd Choice、腾讯 Key、OpenCode 路径及 MCP 配置,再试建一篇日记、修改一次地点、生成一次记忆碎片。本文按现有文件整理,接口是否可达、模型是否能正确调用 MCP,以及最终页面布局,仍以这几步实际运行结果为准。

相关脚本和模板

下面的链接指向分享目录中的对应文件,可以打开后复制或下载。密钥和本机专用配置已替换成填写提示,使用前按下表修改。

模板与脚本文件

文件放到哪里用途
日记模板.mdResources/template/日记模板.md完整的 Templater 模板,包含天气、节假日、出勤继承、页面布局,以及节日文案和周六回声的提示词
change-attendance.jsResources/script/QuickAddScript/修改出勤状态,绑定 QuickAdd Choice change-attendance
change-location.jsResources/script/QuickAddScript/修改地点并更新天气、地图,绑定 change-location
change-day-label.jsResources/script/QuickAddScript/修改日期栏文字,绑定 change-day-label
generate-aw-summary.jsResources/script/QuickAddScript/生成记忆碎片,绑定 daily-gen
weekly-work.jsResources/script/Dataview/周日读取本周工作项,由模板中的 dv.view 加载

提示词文件

活动摘要的完整提示词在 generate-aw-summary.md,需要和 generate-aw-summary.js 放在同一个目录,文件名保持一致。脚本会按自己的位置寻找这份文件,并在运行时替换 {{date}} 和 {{attendance}};这两个变量不需要手动填写。

另外两份提示词直接包含在日记模板的函数中:generateHolidayMessage 负责节日文案,generateEchoMessage 负责旧日记回声。想调整文风时,修改对应函数中的 prompt 即可。模板里的 ${date}、${holiday}、${echoDay.excerpt} 等表达式由 JavaScript 在运行时填入,保留原样。

微光集用到的地方

微光集首页的”星历”,就是读取了库中的日记文件,通过标记获取状态以及banner表情,渲染成不同的日期。
首页模块:个人信息与日常记录

使用前需要替换的配置

分享副本中的提示文字填写内容所在文件
请填写你的腾讯位置服务Key自己的腾讯位置服务 Key,两处保持一致日记模板.md、change-location.js
请填写本机OpenCode可执行文件的绝对路径本机可运行的 OpenCode CLI 路径日记模板.md、generate-aw-summary.js
请填写OpenCode中可用的provider/modelOpenCode 中已经配置好、可以调用 MCP 的模型标识日记模板.md、generate-aw-summary.js
aw-watcher-enhanced_请填写你的设备名ActivityWatch 中实际存在的 OCR bucket 完整 IDgenerate-aw-summary.md

Windows 路径写在 JavaScript 字符串里时,反斜杠需要转义。例如实际路径是 C:\Tools\OpenCode\opencode.exe,代码中应写成:

const opencode = "C:\\Tools\\OpenCode\\opencode.exe";

模板中有两处模型调用,摘要脚本中还有一处,替换模型标识时需要一起检查。模型服务的 API Key 和 ActivityWatch MCP 连接在 OpenCode 中配置,附件不包含这些凭据,也不需要把模型 Key 填进日记模板。

目录沿用本文的 Private/日记/、Private/随想/ 和 Resources/。如果自己的库目录不同,需要同步修改模板、QuickAdd 脚本与周回顾脚本中的对应路径;QuickAdd Choice 名称也要与点击入口一致。配置填写完成后,再把分享副本放到上表中的运行目录,不要将附件目录本身设置成自动执行模板的目录。


星轨图