ENGINEERING CASE / 01

从启动提示,到可直接读取的人物档案。

2026年10月29日,杜亮宽个人站完成原始HTML正文改造。本文记录指定版本下的读取结果、方法与局限,非搜索排名或模型引用效果报告。

01

问题:页面能开,资料却未直接输出

改造前的首页以客户端状态决定是否显示人物介绍。普通HTTP请求获取的body中仅有启动提示,姓名和部分描述虽在metadata中,完整人物资料却没有直接出现在正文。

这使不执行脚本的读取方式无法拿到与浏览器完整渲染后相同的信息。我们没有据此断言某一个搜索引擎一定无法渲染。

02

改造:把事实与展示解耦

使用共同资料源维护姓名别名、项目职责、FAQ和来源,页面在构建时生成可读HTML。metadata、纯文本资料和结构化数据引用同一份内容。

保留人物视觉风格与真实照片,移除正文等待启动状态的依赖。字体改为自托管,避免云端构建依赖在线字体下载。

03

指定版本的观察结果

a2ec8db版本的原始HTML可读文字约28字符;3dc0def版本为1514字符。计数包含导航与页脚,方法为解析body、排除script和style、合并空白后计数字符,并非净正文长度或内容质量评分。

该轮线上检查覆盖11个正文页面、5个资料端点和113个字体资源。页面、规范链接、结构化数据、内链及双端滚动检查通过。后续内容新增后,长度和页面数量会变化。

04

如何复查

以普通HTTP客户端请求页面,对比原始HTML和脚本渲染后的页面,检查姓名、职责与来源是否已经存在。项目仓库提供标准库实现的页面检查工具,可复查H1、metadata、canonical、JSON-LD和内链。

本记录由实施方整理,Codex协助实施与记录,不作为独立第三方实验。

05

哪些结论还不能得出

工程检查通过,表示页面具备更清楚的读取条件。它不等于已经被豆包收录、引用,更不等于人物检索成功率达到90%。

消费者端实测需要在不预先提供背景和链接的条件下,跨日期、账号与问题分组采样。该项按当前安排留待后续进行,本文不填入模拟结果。