Dabble Me Journal

Dabble Me

通过电子邮件使用的私人日记服务。

Dabble Me 帮助人们记住生活中发生的事。你可以每天、每周甚至每月把它当作轻量级日记使用……由你决定！Dabble Me 会在你选择的时间和日期给你发送电子邮件，你只需回复邮件即可发布日记条目。应用已上线：https://dabble.me。如果你曾使用过 OhLife，它是一个很棒的替代选择。

此应用使用以下 3rd 方服务：

• CloudFlare 托管 DNS + 免费 SSL 支持（基础服务免费）
• Mailgun 用于发送和接收电子邮件（每月 50k 封邮件免费）
• Amazon S3 用于上传和存储照片（免费 1 年）
• Google Analytics 用于流量统计（标准分析服务免费）
• Turnstile 用于防止机器人注册（免费）。
• Sentry 用于报告错误（免费）

你需要设置 Mailgun 来接收邮件，并将邮件转发到应用进行解析。

定时任务（包括每小时发送邮件）由 Sidekiq 工作进程中的 sidekiq-cron 运行。任务计划位于 config/schedule.yml。无需外部调度器。

本地密钥保存在代码库根目录的 .env 文件中。 dotenv-rails 会在开发和测试环境中加载该文件，并且不会覆盖 Shell 或 CI 中已设置的变量。Railway 生产环境使用主机环境中的相同变量名。Railway 上没有 .env 文件。rake db:seed 会创建 [email protected] 账户。

1Password Environments 可以挂载该路径，这样密钥就不会以明文形式存储。.1password/environments.toml 会告知 1Password Cursor hook 验证挂载。

1. 在 1Password 应用中，打开 Developer，然后打开 Environments，并创建一个环境。导入此代码库的 .env，或添加 .env.example 中列出的名称。
2. 导入后删除明文 .env，以便 1Password 可以挂载到该位置。
3. 在 Connect to 下，选择 Local .env file，选中此代码库的 .env 并挂载。
4. 启动 Rails 时请保持 1Password 解锁。首次读取 .env 时，系统会要求你授权。

变量名称列在 .env.example 中。简要版本：

MAIN_DOMAIN=yourdomain.com
SECRET_KEY_BASE=1234..1234
DEVISE_SECRET_KEY=1234..1234
SMTP_DOMAIN=post.yourdomain.com
MAILGUN_API_KEY=api-key
TURNSTILE_SITE_KEY=6Lc6BAAAAAAAAChqRbQZcn_yyyyyyyyyyyyyyyyy
TURNSTILE_SECRET_KEY=6Lc6BAAAAAAAAKN3DRm6VA_xxxxxxxxxxxxxxxxx
GOOGLE_ANALYTICS_4_ID=UA-12345-67
SENTRY_DSN=https://dsn.sentry.io/1234
OPENAI_ACCESS_TOKEN=sk-1234
OPENAI_ORGANIZATION_ID=org-1234
STRIPE_API_KEY=sk_test_1234
STRIPE_SIGNING_SECRET=whsec_1234

你可能想要移除的内容

你可以选择不使用 Turnstile：只需不要添加 TURNSTILE_SITE_KEY 环境变量。

MCP（模型上下文协议）

PRO 账户可以将 Dabble Me 用作远程 MCP 服务，让兼容的客户端（例如 Claude）在完成 OAuth 后搜索、列出、分析和创建日记条目。

要求：PRO 订阅，以及在账户安全设置（/security）中启用密钥或双重身份验证。可在同一页面的已连接的应用下查看并撤销已连接的 OAuth 应用（仅在有应用连接时显示）。

**端点：**位于 https://<MAIN_DOMAIN>/mcp 的 Streamable HTTP 端点（请参阅 .env 中的 MAIN_DOMAIN）。客户端应使用 OAuth：授权元数据发布在 /.well-known/oauth-authorization-server 和 /.well-known/oauth-protected-resource 下（请参阅 Oauth::MetadataController）。

**面向用户的说明：**访问你所在主机上的 /mcp-server 查看 Dabble Me MCP Server。

供助手使用的深层链接：单日页面的网址为 https://<MAIN_DOMAIN>/entries/YYYY/M/D，月份和日期不补零（例如：https://dabble.me/entries/2026/4/21）。网页撰写网址为 https://<MAIN_DOMAIN>/write。

有关在 Claude 中设置通用远程连接器，请参阅 Anthropic 的 使用远程 MCP 开始使用自定义连接器。

注册表元数据：server.json 描述了官方 MCP Registry 的托管 Streamable HTTP 端点。

**WebMCP / AI 客户端发现：**公共页面会公布 /.well-known/webmcp、/mcp/server-card 和 /.well-known/ai-catalog.json。在已登录的浏览器标签页中，WebMCP 还会注册会话日记工具（搜索、列出、分析、打开某一天，以及起草但不提交条目）。搜索、分析和起草功能需要 PRO。/mcp 上的远程 MCP 仍使用 OAuth（PRO + 密钥或 2FA）。对于 WebMCP Challenge，请在提交表单中填写专用的 PRO 演示账户（邮箱/密码，不启用 2FA），不要使用真实日记。

自动化冒烟测试（curl + MCP Inspector CLI）：./script/mcp_inspector_smoke.sh 使用 RAILS_ENV=test，启动短暂运行的 Rails 服务，检查 OAuth 元数据和 /mcp，然后使用 Inspector 测试全部五个工具（tools/list 会执行 initialize + 连接）。符合 Anthropic 的测试你的连接器指南。

测试

应用有完善的测试覆盖，你可以通过以下命令运行：

rake

管理门户

管理员邮箱对应的账户可以使用导航栏中的管理下拉菜单（锁形图标），查看系统中的条目和用户数量等详细信息。

灵感与导入器

如果你想获取一些随机灵感，可以在 Inspiration 表中载入不同的引言，这些引言会显示在“新帖子”页面上方和邮件底部。导入来源通过 Inspiration 类别标记 ———— 可导入 OhLife / Ahhlife / Day One / Trailmix 的行（请参阅 db/seeds.rb），或者 Day One 导入器会在首次使用时创建其类别。

Inspiration.create(category: 'OhLife', body: 'Imported from OhLife')
Inspiration.create(category: 'Day One', body: 'Imported from Day One')

PRO 用户可以在 /entries/import 导入 OhLife（文本 + 照片 ZIP）、Day One（JSON ZIP 导出）、Ahhlife（粘贴 JSON）和 Trailmix.life（上传 JSON）。

=====

当前功能：

• 按月/年阅读过往条目
• 使用简单格式创建新条目
• 导入器：OhLife、Day One、Ahhlife、Trailmix.life
• 邮件：在你选择的星期几通过回复邮件发布新条目（并嵌入随机的过往条目）
• 为特定条目关联 1 张图片
• 搜索并查看与发布相关的基础分析
• 支持使用主题标签标记条目
• 年度回顾
• MCP（PRO）：供外部客户端使用的 OAuth 日记工具