logr

logr

个人作品集 + AI 上下文层。 大多数人都有 LinkedIn，但没有人拥有结构化、机器可读、可查询的个人经历版本，能与任何 AI 工具配合使用。logr 填补了这一空白——它是一份编辑式人生日志，既便于人们阅读，也便于 AI 查询。

你只需记录一次个人经历，就能得到三种呈现形式：

• logr.it/you 上的时间线——按年份分组，悬停即可展开，可从 9 种配色 × 8 种布局中选择；
• 任何 AI Agent 都能读取的机器可读 Markdown 上下文——这是真正的护城河；以及
• 有据可依的 AI 聊天组件，访客可以在其中提问，答案严格基于你的日志。

请参阅 ROADMAP.md，了解已实现的功能和后续计划。

功能

• 多用户——使用 Google 登录，在 /welcome 认领用户名，在 /dashboard 中编辑并实时预览。
• AI 导入——粘贴个人经历、上传简历（PDF/DOCX），或提供 URL；AI 会将内容整理为时间线事件，供你审核确认后再保存。
• 有据可依的聊天——访客聊天使用与公共路由相同的完整 Markdown 上下文作为提示词，通过 OpenRouter 流式响应，并设有速率限制。只提供事实：日志中没有的内容，它会如实说明。
• 主题——9 种配色（含深色主题 ink）× 8 种布局（timeline、journal、magazine、terminal、feed、card、centered、polaroid），按个人资料保存，并可实时预览。
• 置顶事件——在控制面板的事件标签页中最多置顶 7 个事件（置顶对话框）；这些事件会替代侧栏中的“最近事件”（以及 OG 图片中的侧栏），并在 Markdown 上下文中标记。
• 媒体——图片上传（S3，开发环境中使用本地文件系统）、视频/推文嵌入、自动展开的链接卡片，以及每份个人资料对应的动态 OG 图片。

聊天、S3 和 Google 身份验证分别由对应的环境变量控制；未设置时，应用会妥善降级运行。

路由

路由	用途
/	产品介绍页
/[username]	公开时间线（例如 /koshik）
/[username]/ask	独立、可分享的有据可依聊天页面
/[username]/llms.txt	主要 Markdown 上下文；个人资料过大时会提供精简版本
/[username]/llms-full.txt	完整、未删减的 Markdown 上下文
/[username].md	与公开个人资料对应的纯 Markdown 版本
/[username]/llm.txt	兼容旧版的完整上下文 URL
/mcp	全局 MCP 服务（Streamable HTTP）——Agent 可查询任意公开个人资料；所有者写入操作需通过 OAuth 授权
/oauth/authorize	MCP 写入权限的 OAuth 2.1 授权页面（以及 /api/oauth/token、/api/oauth/register、/.well-known/* 发现端点）
/api/[username]/chat	流式、有据可依的聊天 API
/dashboard	所有者编辑器（需通过身份验证）——个人资料 · 事件 · 外观 · 导入
/welcome	入门引导——认领用户名，创建时间线初始内容
/login	Google 登录

技术栈

Next.js 16（App Router）· React 19 · TypeScript · Postgres（Supabase）+ Prisma 6 · Auth.js（NextAuth v5，Google OAuth）· 通过 OpenRouter 使用 Vercel AI SDK · AWS S3（开发环境中使用本地文件系统）· Tailwind v4 + 由主题令牌驱动的作用域 CSS · Source Serif 4 + JetBrains Mono · Vercel。

本地运行

npm install
cp .env.example .env     # fill in the values below
npx prisma migrate dev   # applies migrations to your Postgres
npm run db:seed          # loads a demo profile + ~18 events
npm run dev              # http://localhost:3000

.env（详情请参阅 .env.example）：

• DATABASE_URL / DIRECT_URL — Supabase Postgres；运行时使用事务连接池（:6543、?pgbouncer=true），prisma migrate 使用会话连接（:5432）。
• AUTH_SECRET + AUTH_GOOGLE_ID / AUTH_GOOGLE_SECRET — 为 /dashboard 和入门引导启用 Google 登录。
• OPENROUTER_API_KEY — 可选；启用访客聊天和 AI 导入（可通过 OPENROUTER_MODEL 覆盖默认模型）。
• ANTHROPIC_API_KEY — 可选的 OpenRouter 替代方案；直接调用 Anthropic API，同时设置两者时优先使用此项（ANTHROPIC_MODEL，默认为 claude-haiku-4-5）。
• AWS_* — 可选；用于 S3 图片存储（未设置时回退到 ./public/uploads）。

项目结构

design/                     # design handoff — visual source of truth (not shipped)
prisma/
  schema.prisma             # Profile, User/Account/Session, Event, Media, ChatMessage
  seed.ts                   # demo profile + events
src/
  auth.ts                   # NextAuth (Google + Prisma adapter)
  app/
    page.tsx                    # marketing landing
    [username]/page.tsx         # public timeline (SSR)
    [username]/llms.txt/route.ts # primary machine-readable context
    [username]/opengraph-image.tsx
    dashboard/page.tsx          # owner editor (auth-gated)
    welcome/page.tsx            # onboarding / handle claim
    api/[username]/chat/route.ts# streaming grounded chat
    api/upload/route.ts         # image upload
  components/
    Portfolio.tsx, ChatWidget.tsx, ShareModal.tsx, ...
    admin/                      # dashboard: forms, theme editor, events, import dialogs
    onboarding/, marketing/, ui/
  lib/
    actions.ts                  # all server actions
    chat.ts, narrate.ts, import.ts, llmtxt.ts, profile.ts, theme.ts, storage.ts, ...

类 JSON 字段（socials、theme、事件 link）以序列化字符串的形式存储，以确保架构具有可移植性。对用户提供的 URL 发起的出站请求会通过 lib/import.ts 中受 SSRF 防护的客户端发送。

域名

产品域名为 logr.it；作品集位于 logr.it/<handle>。主要 Agent 上下文位于 logr.it/<handle>/llms.txt；完整 Markdown 位于 logr.it/<handle>/llms-full.txt 和 logr.it/<handle>.md。