🌸 TagMesh

零文件夹 · 无标题 · 标签编织的 Markdown 笔记系统，兼具黏土拟态美学与无服务器边缘计算

告别文件夹和标题。在边缘通过 #hashtags 有机地编织思绪。

🇬🇧 English • 🇨🇳 简体中文

✨ 核心特性

• 🏷️ 零标题、零文件夹：将笔记视为流动的 Markdown 流。分类完全依赖 #hashtags，并自动提取首行作为摘要。

• 🎨 触感黏土拟态美学：圆润的黏土药丸、立体浮雕阴影、听觉音景、粒子迸发，以及 6 套精选心情主题。

• 💬 跨设备共享弹幕广场：手机上的思绪实时飞过桌面显示器，支持同步点赞爱心与权威遥测。

• 🧭 6 种多维画廊：Bento 网格、3D 空间轮播、星系网格图、拍立得墙、时间线流和自由画布。

• 🤖 原生无服务器 MCP 接口：边缘原生模型上下文协议（JSON-RPC 2.0）接口，提供 8 个生产级工具，适用于 Claude Desktop 和 Cursor。

Related MCP server: ai-journal

⚡ 常用快捷键

🚀 本地快速开发

# 1. Clone repo & install dependencies
git clone https://github.com/SaulGoodManC99/TagMesh.git
cd TagMesh
npm install

# 2. Start frontend dev server (with LAN access on 0.0.0.0:5173)
npm run dev

# 3. Start Cloudflare Worker backend locally
npm run worker:dev

☁️ Cloudflare 部署指南

TagMesh 运行在 Cloudflare Workers + D1 SQLite 数据库 之上：

1. 创建 D1 数据库

前往 Cloudflare Dashboard -> D1 SQL Database -> Create database（命名为 tagmesh-db），复制你的 Database ID，并将 schema.sql 的内容粘贴到其 Console 中以初始化数据表。

2. 配置 GitHub Actions 自动部署（推荐）

在你的 GitHub 仓库 Settings -> Secrets and variables -> Actions 中添加 3 个密钥：

• CLOUDFLARE_API_TOKEN：Cloudflare API 令牌

• CLOUDFLARE_ACCOUNT_ID：Cloudflare 账户 ID

• CLOUDFLARE_D1_DATABASE_ID：步骤 1 中的 D1 数据库 ID

现在每次 git push 到 main 分支都会在约 30 秒内自动构建并部署到 Cloudflare 边缘！

3. 本地 CLI 部署（可选）

npx wrangler login
npm run db:init:remote
npm run build
npm run worker:deploy

🤖 MCP（模型上下文协议）集成

在你的 Claude Desktop 配置（claude_desktop_config.json）中添加：

{
  "mcpServers": {
    "tagmesh": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-fetch",
        "https://your-domain.com/mcp"
      ]
    }
  }
}

可用工具：search_by_tag、search_fulltext、read_note、create_or_update_note、append_to_note、delete_note、list_tags、get_workspace_stats。

📄 许可证

基于 MIT License 分发。

由 SaulGoodManC99 以 💖 和黏土魔法精心打造