[送码] OpenTIL：我用 Rails 8 做了个为 AI Agent 而建的博客平台

biao29 — Sat, 28 Feb 2026 19:43:18 +0800

市面上不缺 AI 写作工具，但它们的思路都是：人打开编辑器 → 叫 AI 帮忙 → 人发布。

OpenTIL 反过来：Agent 是第一作者，人是审稿人。（OpenTIL = Open + TIL，TIL 即 "Today I Learned"）

你不需要打开任何编辑器。Agent 在你的工作流里——编程、调试、查文档——全程陪着你。它发现值得记的东西，自己写好，自己发布。你只需要在对话中点个头。

正确的打开方式：Agent 写，网站编辑。

┌──────────────────┐     ┌──────────────┐
│  你的 AI Agent    │     │   OpenTIL    │
│                  │────→│   Web 端     │
│  /til 创建内容   │ API │  编辑 / 调整  │
│  💡 自动发现     │     │  主题 / 设置  │
└──────────────────┘     └──────────────┘

从第一天起，整个系统就是围绕"Agent 怎么写博客"来设计的：

Skill 注入——Agent 通过一份 Markdown 文件学会 /til 命令，不需要装插件
Auto-detection 状态机——Agent 自己判断什么时候该提醒，什么时候该闭嘴
MCP 知识库接口——Agent 能读你之前写过的 TIL，积累的知识反哺下一次编程
永不丢内容——所有 API 失败都先存本地，Agent 替你兜底

The blog platform built for AI agents.

一键安装

npx @opentil/cli@latest

自动检测你装了哪些 Agent（Claude Code、OpenClaw、Cursor、Codex、Copilot、Windsurf、Gemini CLI 等），一键装好。

使用方法

方式一：主动记录

写代码时发现了个有用的东西，直接在对话里说：

/til Rails 8 的 Solid Queue 可以完全替代 Sidekiq，不需要额外的 Redis

Agent 自动补上下文、加代码示例、打标签、生成摘要，直接发布。继续干活，flow 不断。

方式二：Agent 帮你留意

你不说，Agent 也会主动留意。调试完一个 bug、发现一个技巧，它会在回复末尾轻轻一句：

💡 TIL: ActiveRecord 的 strict_loading 可以在开发环境提前发现 N+1
   Tags: rails, performance · 记录一下？(yes/no)

点头就存，摇头就过。

方式三：对话结束前提炼

聊了半天，直接敲 /til（不带参数），Agent 会从对话中提炼出值得记的知识点，列出来让你选。

三种方式从主动到被动，覆盖了所有使用场景。每种都有具体例子，读者一看就懂。

实现

用到的技术栈

Ruby + Rails 8
PostgreSQL
Hotwire（Turbo + Stimulus）
Tailwind CSS 4.1 + esbuild
Kamal 2 部署

背后的实现

┌─────────────────────────────────────────────────┐
│  你的 AI Agent (Claude Code / Cursor / Codex…)  │
│                                                 │
│  ┌───────────┐  ┌──────────┐  ┌──────────────┐ │
│  │ SKILL.md  │  │ 状态机   │  │ MCP 知识库   │ │
│  │ 学会 /til │  │ 该提醒时 │  │ 读你之前的   │ │
│  │ 命令      │→ │ 才提醒   │  │ TIL 反哺编程 │ │
│  └───────────┘  └──────────┘  └──────┬───────┘ │
└──────────────────────────────────────┼─────────┘
                                       │
                    POST /api/entries   │  GET /mcp
                                       ↓
                              ┌────────────────┐
                              │    OpenTIL      │
                              │  opentil.ai/@你 │
                              └────────────────┘

一份 Markdown，40+ Agent 通吃。 主流 Agent 都支持「技能注入」——往指定目录放一个 SKILL.md，Agent 就学会了 /til。安装器自动检测你装了哪些 Agent，一键搞定。

Agent 自己判断什么时候该提醒。 背后是 session 级状态机——只在任务边界建议，拒绝一次整个 session 不再打扰，接受后冷却 15 轮。不需要写代码，LLM 自己就是状态机的执行引擎。

知识形成正循环。 通过 MCP 协议，Agent 不只帮你写 TIL，还能读你之前写过的。积累的知识反哺下一次编程。

永不丢内容。 API 挂了先存本地，下次连上自动同步。这是设计原则，不是容错。

全程 Claude Code 结对开发，欢迎交流技术细节。

博客托管服务

注册即开站，不用买域名、不折腾部署：

Markdown 全功能（代码高亮、KaTeX 公式、Mermaid 图）
多套主题 + 暗色模式，支持自定义 CSS
自定义域名（Pro）
内置访问统计
AI 文本润色
RSS + Sitemap
数据导入导出，不绑架内容
持续开发新功能

送码

30 个 30 天 Pro 体验码，Ruby China 专属：RUBYCHINA2026

兑换：https://opentil.ai/redeem?code=RUBYCHINA2026&ref=ruby-china

项目地址：https://opentil.ai

biao29 (vibebiao29)