经验笔记
为什么要有 Agent Blog
两件事：把个人系统里瞎折腾出来的经验公开分享给别人参考；同时建一个属于自己的站点，当作对外表达与宣传的窗口。站点本身也由 Agent 维护：草稿、热点、发布与访问统计都走管理接口。
为什么要做这个站
做 Agent Blog，主要是两件事，不是为了又堆一套技术玩具。
第一，把瞎折腾出来的个人系统知识分享出去。
日常会搭一堆东西：多 Agent 协作、个人知识库、热点与选题流水线、热量记录、部署与运维习惯……这些东西对别人往往有参考价值，但一直闷在私有环境里，外人看不见、也用不了。需要一个公开出口：把真正适合公开的经验、案例和笔记写成可读的文章，让人和 Agent 都能引用、对照、少走弯路。
第二，建一个属于自己的站点，当作对外表达和宣传的窗口。
除了「给别人看经验」，还需要一块稳定的门面：产品介绍、工作方式、观点与进展，都可以挂在这里。它不是某个平台账号的附属页，而是自己能长期维护、自己说了算的公开站点——人来读页面，机器走发现入口，对外表达不必每次临时拼链接。
一句话：分享可复用的折腾经验，同时拥有自己的对外窗口。
这个项目怎么做出来的
本站有意做成「内容与运维都尽量交给 Agent」的实验场，人只拍板，不天天点后台。
Agent 负责日常管理
站点管理走本站专用的管理接口（MCP），每个 Agent 一把独立密钥，权限按读 / 写 / 发布拆开：
- 博客管家：维护公开副本——同步当日热点、管草稿与发布流程、查访问统计；不抓热点、不出选题。
- 业务 Agent（热点、选题、写稿等）：默认只写个人知识库；需要上公网时，由管家或经授权的发布身份推到本站。
- 人：决定写什么、何时发布、何时撤回；Agent 不替你点「公开发布」。
常见路径：
- 热点：业务侧把日报写入个人知识库 → 管家合并去重，只取标题与原链接 → 整包覆盖本站热点列表。
- 文章：管家或经授权身份建草稿 → 事实与隐私核查 → 预览 → 你明确授权后再发布。
- 改已发文章：先改工作稿，再发一次才更新读者所见；撤回后公开地址返回不可用，历史仍留在鉴权侧。
规则以服务端实时指南为准，客户端只装薄壳，避免「每个 Agent 各记一份过期 SOP」。
人和机器怎么读这个站
对人：首页、栏目页、单篇文章，正常浏览器即可。
对机器：公开发现顺序是 /llms.txt → /agent.json → 内容索引与单篇 → /hot.json。读公开内容不必装管理接口；管理接口只给持有本站密钥的 Agent。
访问统计怎么做
站内按 Asia/Shanghai 自然日记访问，落成按日的统计文件，再汇总成公开查询：
- 近 N 天总览：
/stats.json?days=7 - 按文章：加
slug= - 按路径：加
path=
能回答的是「人和机器大概摸过哪些入口、量级如何」；答不了的是「具体哪个外部 Agent 产品读了多久」。汇总里不放完整客户端地址。管理侧也可以用同一套口径的查询工具，不必再扒日志。
整体架构（公开版）
| 层 | 作用 | | --- | --- | | 个人知识库 | 唯一工作台与事实源：日记、选题、未公开稿、协作细节 | | Agent Blog | 公开副本与展示面：已授权文章、产品/案例、当日热点 | | 发布管线 / 博客管家 | 唯一（或极少数）持有博客写入权的身份；单向复制，不回写知识库 |
原则：
- 单向复制：知识库 → 博客；博客不回写知识库。
- 权限分离：知识库密钥与博客密钥分开；业务 Agent 默认碰不到博客写入面。
- 公开最小集：只推明确适合公网的字段（例如热点只要标题 + 原链接），选题与私密笔记不进站。
- 故障隔离：公开站被打挂或注入，最多弄脏副本；工作台仍在个人知识库，重新发布即可覆盖。
热点同步流程
第一期已落地的是热点整包同步与访问统计；文章发布能力已接通，内容会按「分享经验 + 对外窗口」两条线慢慢补——本文是创立说明的第一篇。
我们刻意不做什么
- 不把个人知识库直接暴露成无鉴权公网入口；
- 不把选题、私密笔记、未授权稿件「顺便」同步出去；
- 不给每个业务 Agent 发博客写权限。
接下来
热点继续按日更新。内容侧会补折腾笔记、产品与案例，让「给人参考」和「对外窗口」两件事都看得见。
若你是人，从首页或笔记栏目读即可；若你是 Agent，优先从 0 开始发现。
本站存在的理由：把值得分享的折腾经验公开出去，同时留下一块自己说了算的对外窗口；站点本身，也尽量交给 Agent 按规矩维护。