https://ningop.com/categories/%E6%8A%80%E6%9C%AF%E5%AE%9E%E5%BD%95/Recent content in 技术实录 on NFYHugozhSun, 06 Sep 2026 20:04:05 +0800https://ningop.com/posts/2026-09-06-notion-kb-cron-integration-migration/Sun, 06 Sep 2026 19:45:00 +0800https://ningop.com/posts/2026-09-06-notion-kb-cron-integration-migration/<p><img alt="featured" loading="lazy" src="https://ningop.com/images/posts/2026-09-06-notion-kb-cron-integration-migration.jpg"></p> <h2 id="问题背景hermes-cron-gateway-的-systemd-限制">问题背景：Hermes Cron Gateway 的 systemd 限制</h2> <p>Hermes 的 cron 系统依赖 <code>systemd-run --user --scope</code> 启动隔离 worker。当前环境（容器/权限受限）报错：</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl">Restart-safe cron worker dispatch failed: cannot create restart-safe systemd scope for gateway child: systemd-run --user --scope is unavailable </span></span></code></pre></div><p>导致 18 个 Hermes cron jobs 全部失败，无法执行任何定时任务。</p> <h2 id="解决方案迁移到系统级-crontab">解决方案：迁移到系统级 crontab</h2> <p>直接编写 <code>/root/.hermes/cron/system-crontab</code> 并 <code>crontab /root/.hermes/cron/system-crontab</code> 安装，绕过 Hermes gateway，由系统 cron 直接调用 Python 脚本。</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># 安装</span> </span></span><span class="line"><span class="cl">crontab /root/.hermes/cron/system-crontab </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># 查看</span> </span></span><span class="line"><span class="cl">crontab -l </span></span></code></pre></div><h2 id="核心脚本">核心脚本</h2> <h3 id="1-notion-kb-每日全量同步-sync-notion-kbpy">1. Notion KB 每日全量同步 (<code>sync-notion-kb.py</code>)</h3> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"><span class="line"><span class="cl"><span class="ch">#!/usr/bin/env python3</span> </span></span><span class="line"><span class="cl"><span class="c1"># 使用 Notion API 直连，拉取「人生规划」页面及其子页面</span> </span></span><span class="line"><span class="cl"><span class="c1"># 环境变量：NOTION_API_KEY</span> </span></span><span class="line"><span class="cl"><span class="c1"># 输出：/root/.hermes/kb/notion/*.md + LIVE-INDEX.txt + UNIFIED-INDEX.txt</span> </span></span></code></pre></div><ul> <li>运行时间：<code>0 3 * * *</code> (每日 03:00)</li> <li>结果：33/33 页面成功，LIVE-INDEX 93 行，UNIFIED-INDEX 427 行</li> <li>日志：<code>/root/.hermes/cron/system-logs/sync-notion-kb.log</code></li> </ul> <h3 id="2-双向写回模块-writeback_notionpy">2. 双向写回模块 (<code>writeback_notion.py</code>)</h3> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"><span class="line"><span class="cl"><span class="c1"># 支持三种模式</span> </span></span><span class="line"><span class="cl"><span class="n">writeback</span><span class="p">(</span><span class="n">page_id</span><span class="p">,</span> <span class="n">title</span><span class="p">,</span> <span class="n">content</span><span class="p">,</span> <span class="n">mode</span><span class="o">=</span><span class="s1">&#39;date-toggle&#39;</span><span class="p">)</span> </span></span><span class="line"><span class="cl"><span class="c1"># date-toggle: 同一天同标题创建 toggle 块，后续追加到 children</span> </span></span><span class="line"><span class="cl"><span class="c1"># append: 直接追加</span> </span></span><span class="line"><span class="cl"><span class="c1"># overwrite: 覆盖</span> </span></span></code></pre></div><p>4 个 preset 配置：</p>