一个简洁克制的 paper / benchmark / opinion blog，用来沉淀大家平时阅读分享的论文，并输出一些围绕 benchmark 的浅薄观点。
pnpm install
pnpm dev默认通过 Pull Request 投稿。完整规范见 CONTRIBUTING.md，文章模板在 templates。
PR 会自动运行 CI，分成 syntax 和 check 两个 job：syntax 覆盖 workflow / Astro / TypeScript / Worker 语法，check 覆盖 Markdown、内容规范、中文引号配对、资产硬限制、图片建议提示、analytics smoke、生产构建和构建产物检查。中文引号配对属于硬性阻断；构建产物检查会对疑似未渲染的 Markdown 标记输出 warning，并写入 GitHub Actions summary，但不阻塞 CI。CI 成功后，机器人会在 PR comment 里输出带 commit hash 的预览链接。
如果使用 Codex 或 Claude Code 辅助投稿，可以让它读取仓库内的 .agents/skills/lens-frontier-post skill，按统一流程创建文章、检查内容和资产、运行 CI 前校验并准备 PR。
src/content/papers # 论文阅读分享
src/content/benchmarks # benchmark 观察
src/content/opinions # 围绕 benchmark 的观点文章每篇文章使用 Markdown frontmatter 管理元数据。字段 schema 在 src/content.config.ts。站点支持 /zh/ 和 /en/ 两套语言路由，文章通过 lang: "zh" 或 lang: "en" 决定展示在哪个语言下；允许单语发布，不要求同步翻译。后续补译文时，两篇文章可以使用同一个 translationKey，中英切换会优先留在同一篇文章。
常写作者可以登记在 src/data/authors.ts，文章里用 authors: [{ id: "author-id" }] 复用作者资料；一次性投稿也可以继续在文章 frontmatter 里直接写 name / github。
仓库使用 .github/CODEOWNERS 自动请求 @Lens-Frontier/blog-maintainers review 文章、站点、CI 和发布流程改动。
顶部导航保留主要阅读入口：Papers、Benchmarks、Opinions 和 Tags。Timeline、About 和 RSS 放在页脚，避免顶部导航过重。
项目已经包含 .github/workflows/deploy.yml。推到 GitHub 后，在仓库设置里把 Pages source 设为 Deploy from a branch，分支选择 gh-pages / root。
如果仓库名不是 <username>.github.io，配置会在 GitHub Actions 中自动把 base 设置为 /<repo-name>。
自定义域名时：
- 在
public/CNAME写入域名。 - 在 GitHub Actions workflow 里把
SITE_URL改成你的域名。
公开站点只展示文章阅读量，不在 About 页面专门说明统计方案。这里保留配置和隐私口径，方便维护者理解边界。
文章页支持 first-party 阅读量展示。默认不启用；生产环境配置后，文章标题下方会显示阅读量。展示用阅读量按 pageview 计数，刷新页面会增加一次；Worker 后台仍会单独保存按天去重的匿名访客事件，供后续分析使用，但站点不展示这个去重值。
如需开启，先部署 workers/pageviews 里的 Cloudflare Worker + D1，再在生产构建中配置：
PUBLIC_PAGEVIEW_ENDPOINT=https://<worker-domain>/pageview
PUBLIC_PAGEVIEW_COUNT_ENDPOINT=https://<worker-domain>/views
PUBLIC_PAGEVIEW_SITE_ID=lens-frontier不要在 PR preview 配置这些变量，避免预览流量进入正式阅读量。PUBLIC_PAGEVIEW_COUNT_ENDPOINT 可省略，站点会从 /pageview 自动推导 /views。
站点通过 GA4 的 Google tag 接入站点统计。当前生产部署 workflow 使用：
PUBLIC_GA_MEASUREMENT_ID=G-ZK42116ZXB没有配置 Measurement ID 时不会加载 Google Analytics。PR preview 不配置这个变量，避免预览流量进入正式统计。站点只保留这一处 Google tag，不再同时接入 Google Tag Manager，避免重复 pageview。
除 GA4 默认 pageview 外，站点还会发送少量自定义事件，用来观察内容是否被读到、从哪里被发现，以及哪些站点入口有用：
lf_article_scroll_depth：文章页滚动到 25 / 50 / 75 / 90 / 100。lf_article_engaged_read：文章页可见阅读 45 秒且滚动超过 50。lf_content_discovery：首页频道、列表文章等内容发现入口点击。lf_tag_click：标签点击。lf_navigation_click/lf_language_switch：导航、页脚、语言切换点击。lf_article_resource_click/lf_article_body_link_click/lf_outbound_click：文章资源、正文链接和外链点击。lf_article_image_open/lf_article_image_zoom/lf_article_image_close：文章图片预览交互。
事件参数只包含语言、页面类型、文章 collection/id、滚动百分比、链接类型、站内 path 或外链域名等低风险字段，不上传正文、完整外链 URL 或用户标识。
公开展示的阅读量是轻量 pageview 指标，不是严肃审计数据；刷新会增加计数，因此可能被异常流量影响。后台按天去重的匿名访客事件更适合做趋势判断。需要更强防刷时，优先在 Cloudflare Worker 前启用 WAF / rate limiting，而不是在页面端做复杂逻辑。
站点统计只用于理解内容阅读和站点入口表现。当前不会上传文章正文、完整外链 URL、读者账号标识或自定义个人资料字段。
当前内容量较小时，先依赖 Tags、Timeline 和分类页导航。等文章超过约 30 篇，建议接入静态搜索方案，例如 Pagefind；它不需要后端服务，也适合 GitHub Pages。
文章允许后续修订。小的错别字和链接修复可以直接改；影响判断、结论或事实口径的实质性更新，建议在 frontmatter 加 updated: YYYY-MM-DD，并在正文末尾增加简短修订说明。
pnpm dev # 本地开发
pnpm check # Markdown + 内容规范 + 敏感信息 + 资产 + 图片建议 + 语法 + analytics smoke + 构建产物检查
pnpm check:markdown # Markdown 格式检查
pnpm check:content # 文章结构、tag、图片引用、中文引号配对检查；失败会阻塞 CI
pnpm check:sensitive # 常见 token、私钥和敏感文件检查
pnpm check:syntax # Astro/TypeScript 模板 + Worker 语法检查
pnpm check:quality # 内容、敏感信息、资产、图片建议、analytics smoke、构建和 dist 检查
pnpm check:analytics # 临时文章验证 GA4、阅读量脚本和关键 Markdown 渲染
pnpm check:types # Astro 类型和模板检查
pnpm check:worker # 阅读量 Worker 语法和计数行为检查
pnpm check:dist # 构建后页面元信息、站内链接和未渲染 Markdown warning
pnpm images:check # 图片大小、宽度、格式提示
pnpm images:optimize # 压缩文章图片并生成 WebP
pnpm build # 生产构建
pnpm preview # 预览 distpnpm check、pnpm check:syntax 和 pnpm check:quality 会尽量跑完同组内可独立执行的检查，并在最后汇总失败项；构建失败时，依赖构建产物的 dist 检查会跳过，避免读取旧产物。