TRANSMISSION_002: 个人网站第一次大更新 - 草案留档
TRANSMISSION_002: 个人网站第一次大更新 - 草案留档
本文件仅作为开发留档，不作为日后开发方向参考。
特别鸣谢：GPT-5.3-Codex, Gemini 3 Pro, Gemini 3.1 Pro
更新日期：2026-03-24（v0.0.5） 适用范围：sec0nd_state / self_s1de / neuro_link
如何选择
请回复你要的选项编号（可多选），例如：A + C + F。
我会按你选的方向给出分阶段执行方案，并直接开始改。
[已完成] A. 安全优先（先把 PAT 前端暴露风险降下来）
状态：已完成（分支：feat/a-security）
目标：把“浏览器直连 GitHub + sessionStorage 保存 PAT”改成更安全的访问模式。
改动内容：
- 增加服务端代理 API，前端不直接持有长期 PAT。
- 引入短时会话或一次性访问令牌。
- 统一处理 token 过期、撤销和错误提示。
预期收益：
- 明显降低凭据泄露风险。
- 后续可扩展权限控制（按目录/按角色）。
成本与风险：
- 改动中等，需要调整现有数据拉取逻辑。
- 本地开发和部署配置会比现在复杂一些。
建议优先级：最高
[已完成] B. 性能优先（首屏更快，交互更轻）
状态：已完成并合并到 dev（分支：feat/b-performance）
完成记录：
- 首页岛改为延迟水合，减轻首屏阻塞。
- 首页传给前端的 posts 数据精简，减少序列化负担。
- 去除不必要的渲染调用。
- 说明：neuro_link 索引加载慢属于独立子问题，后续在单独分支继续优化。
目标：减少首页首屏负担与不必要水合。
改动内容：
- 首页 React 岛由 client:load 调整为按需水合（如 client:visible 或分段加载）。
- 列表与搜索拆分，首屏只展示轻量内容。
- 内容摘要提取优化，减少运行时处理。
预期收益：
- 首屏渲染更快，移动端体验更稳。
- 降低 JS 体积和 hydration 压力。
成本与风险：
- 改动中等，需要对交互时机做验证。
- 部分动画或即时交互会后置触发。
建议优先级：高
[已完成] C. 视觉系统重构（主题从“补丁”变“体系”）
状态：已完成（分支：feat/c-theme-system）
完成记录：
- 语义化主题令牌与语义类已落地（替代大部分通配覆盖）。
- 主要页面与组件已迁移到语义样式用法。
- 已补充使用规范文档：sec0nd_state/THEME_SYSTEM_GUIDE.md。
- 提交记录：82efceb、73a9a92。
目标：把当前颜色覆盖规则整理成可维护的语义化设计令牌。
改动内容：
- 建立语义变量：surface/text/border/accent 的 3-5 层级。
- 减少全局 !important 和 class*= 覆盖。
- 为三块站点定义统一主题规范。
预期收益：
- 新页面迭代时不容易样式冲突。
- 深浅色一致性更好，后续维护成本更低。
成本与风险：
- 改动中等偏大，需回归验证多个页面。
- 短期看不如功能改造“立竿见影”。
建议优先级：高
D. 信息架构优化（让首次访客更快看懂你）
目标：提升“第一次访问就能理解你是谁、做什么、怎么联系”。
改动内容：
- 首页前两屏重排：定位、代表作、行动入口（简历/项目/联系）。
- 三个站点边界说明与互链策略。
- 增加面向招聘方的快读入口。
- 考虑将
zhangzw0170.github.io做 301/302 跳转到主站sec0nd-state.vercel.app，统一品牌入口与 SEO 权重。
预期收益：
- 提升转化效率（尤其是招聘场景）。
- 降低信息迷航。
成本与风险：
- 改动中等，偏内容与结构设计。
- 需要你确认个人定位文案。
建议优先级：高
[已完成] E. SEO 与可访问性修复（基础分数补齐）
状态：已完成并合并到 dev（分支：feat/e-seo-a11y）
完成记录：
- Layout 支持动态 lang。
- 补充 robots、theme-color、og:locale 等基础元信息。
- 增加 Skip to content 跳转和 focus-visible 样式。
- 主要页面已传入对应 lang。
目标：修复影响搜索与可访问的基础问题。
改动内容：
- 动态 lang 与多语言语义标记。
- 标题层级、meta 描述、Open Graph 规范化。
- 键盘可达性、焦点可视化、色彩对比度系统验证。
预期收益：
- 搜索展示更稳定。
- 可访问性和专业度提升。
成本与风险：
- 改动小到中等，风险低。
建议优先级：中高
[已完成] F. 内容运营工作流（写作发布更顺手）
状态：已完成并合并到 dev（分支：feat/f-content-workflow）
完成记录：
- 新增内容工作流脚本：发布前检查、摘要建议、标签建议、自动归档。
- 新增写作模板：
templates/post-template.md。 - 新增命令：
content:check/content:summary/content:summary:write/content:archive。 - 首页结构与内容发现能力同步增强：Timeline + Tag System。
目标：让“写-发-归档”流程标准化并省时。
改动内容：
- 统一 frontmatter 模板和分类规则。
- 自动摘要、标签建议、更新日志自动归档。
- 发布前检查脚本（链接、格式、图片尺寸）。
预期收益：
- 稳定输出节奏。
- 内容质量一致性更高。
成本与风险：
- 改动小到中等，工程风险低。
建议优先级：中
[已完成] G. 观测与反馈（知道用户如何使用）
状态：已完成并合并到 dev
完成记录：
- 已接入最小可用匿名埋点内核（页面访问、停留时长、关键点击）。
- 支持两种上报方式：Google Analytics（可选）与自定义上报端点（可选）。
- 已对首页关键入口、模块入口、外链入口、标签入口加埋点标记。
- 已新增
/privacy隐私说明页，明确采集范围与用途。 - 已新增
/feedback1 分钟反馈入口，并接入反馈提交事件埋点。 - 下拉框深色适配（select option 主题同步）。
目标：建立最小可用的数据反馈闭环。
改动内容：
- 页面访问、入口点击、停留时长等匿名统计。
- 关键页面事件埋点（简历下载、项目点击）。
- 简单反馈入口（1 分钟表单）。
预期收益：
- 决策从“感觉”变成“数据 + 感觉”。
- 更快验证改版效果。
成本与风险：
- 改动小，需注意隐私告知。
建议优先级：中
[已完成] H. 型号与可访问性微调（视觉细节打磨）
状态：已完成并合并到 dev
当前进展：
- 字体整体升级：从 JetBrains Mono 切到 JetBrainsMapleMono（中文特化）。
- 颜色对比度升级至 WCAG AA 标准（最低 4.5:1），深色和浅色模式都改进。
- 修复主题切换时背景和字体的同步问题（禁用过渡以确保原子性）。
目标：提升视觉舒适度与可访问性。
改动内容：
- 引入 Maple Mono 字体并配置 font-face。
- 调整前景色（深色
#e5e7eb、浅色#1e293b）和弱文本颜色。 - 优化主题切换时的渲染同步性。
预期收益：
- 中文字重更自然，阅读舒适度提升。
- 深浅模式下文字清晰度满足可访问性标准。
- 主题切换流畅无跳变。
成本与风险：
- 改动小，字体文件额外 ~36MB（接受范围内）。
建议优先级：中
[已完成] I. 评论系统接入（社区互动与反馈入口）
状态：已完成并合并到 dev（分支：feat/i-comments-sqlite）
完成记录：
- 已落地 SQLite 评论系统：
posts、comments、comment_events。 - 已新增 API：
/api/comments、/api/comments/admin、/api/comments/stats。 - 已新增审核后台并接入 Nexus：通过
/nexus进入comments_admin。 - 鉴权改为 Nexus token（
x-nexus-token），不再保留独立入口流程。 - 已补齐管理脚本与文档：
COMMENTS_SYSTEM_GUIDE.md。
目标：建立基础读者反馈入口，可控可追踪。
改动内容：
- 服务端审核流 + 基础反垃圾策略（关键词、频率、重复检测）。
- 评论状态机（
pending/approved/rejected/spam）与审核事件日志。 - 评论模块视觉主题切为 yellow 体系并并入 Nexus。
- 保持简洁轻量，无多余 JS 依赖。
- 渲染方式：不依赖第三方 iframe，完全自主掌控。
预期收益：
- 识别高质量读者，积累宝贵反馈。
成本与风险：
- 改动中等，需后端调试。
建议优先级：低
你的选择模板
请直接回复：
- 选择的选项：
- 你最在意的结果（例如：更快、更新稳、更利于求职）：
- 可接受周期（例如：本周先做 2 天量级）：
- 是否允许我分支提交（是/否）：