跳转到主要内容

个人网站

个人网站

English 为准，本页为中文参考。

基于 Astro 和 pnpm 的静态双语 Fieldnotes 个人网站。英文位于 /，中文位于 /zh/。项目、经历与个人介绍通过 Markdown 管理，文章链接到现有博客；独立的 Hugo/OINK 网站展示工程记录。两站均面向 Cloudflare Workers Static Assets 部署。

开发

按开发指南 安装固定版本的环境和依赖。版本及来源见工程基础记录 。

pnpm install --frozen-lockfile
pnpm tools:hugo
pnpm dev --host 127.0.0.1 --port 4321

打开 http://127.0.0.1:4321/，中文版为 /zh/。另开终端执行 pnpm dev:logs，在 4322 端口预览独立日志站。各终端按 Ctrl+C 停止服务。.env.example 说明本地可选的正式网址配置；生产设置见部署指南 。

pnpm exec playwright install chromium
pnpm verify
pnpm deploy:dry-run

验证包括类型、内容、两站构建、生成链接、桌面／手机浏览器行为，以及真实 Markdown 构建场景。浏览器测试直接读取构建文件，不启动服务。输出为 dist/portfolio/ 和 dist/logs/；dry run 不上传。

维护

  • 内容指南 ：修改双语项目、任职经历和个人介绍。
  • 开发流程 与 AGENTS.md ：同级 worktree、选定的独立审查、英文 Conventional Commit，以及每次提交前的预览确认。
  • Fieldnotes 记录 ：选定设计、内容来源、决策和验收。其他设计方案保留在原本地 worktree。
  • 每次改动都须在被忽略的 .local/acceptance/ 提供仅中文的本地验收手册，说明验证步骤及迁移／回退；公开决策与结果保存在双语变更记录中。

文档地图 列出可复用指南。依赖及工具使用固定版本，升级通过明确的 PR。CI 检查 PR，并可在合并后自动部署通过检查的 main 产物。远端分支保护、凭据、域名和部署启用仍需单独设置。

原创内容使用 Apache-2.0 ，主题与图片归属见 NOTICE 。不得提交凭据、原始简历、本地验收文件、构建产物或浏览器运行记录。