调整
This commit is contained in:
1 parent
787544eec1
commit
4ff9146910
81 files changed
+18417
-545
No files matched your search
@@ -556,10 +556,10 @@ interface StorageDriver {
|
||||
|---|---|---|
|
||||
| M0 | 脚手架、Tailwind、shadcn PoC(3 个组件)、zod schema、storage 驱动、repo 层 | 能跑的空站 |
|
||||
| M1 | 只读:手机列表/详情、芯片库、搜索筛选 + sitemap、JSON-LD | 可看、可收录的站 |
|
||||
| M2 | 编辑:登录、表单(含字段级徽章)、图片上传、修订记录 | 可维护 |
|
||||
| M3 | AI 分级补全(high 自动 / medium 标黄 / low 阻塞)+ 差异预览 | 录入效率 |
|
||||
| M4 | 对比页(差异高亮、只看差异、条形可视化)、导出导入、备份脚本 | 完整闭环 |
|
||||
| M5 | 动效打磨、OG 图、打印样式、部署上线 | 成品 |
|
||||
| M2 | 编辑:登录、表单(含字段级徽章)、图片上传、修订记录 | 可维护(✅ 已完成,本地验证) |
|
||||
| M3 | AI 分级补全(high 自动 / medium 标黄 / low 阻塞)+ 差异预览 | 录入效率(✅ 已完成,mock + 浏览器验证) |
|
||||
| M4 | 对比页(差异高亮、只看差异、条形可视化)、导出导入、备份脚本 | 完整闭环(✅ 已完成,本地验证) |
|
||||
| M5 | 动效打磨、OG 图、打印样式、部署上线 | 成品(✅ 本地完成,线上部署待执行) |
|
||||
|
||||
---
|
||||
|
||||
@@ -617,7 +617,7 @@ M0 完成标志:**本地 `docker compose up` 能打开首页,`/devices` 与
|
||||
- 筛选与排序:品牌 chip 列表 + 最新发布 / 按型号 / 按品牌三种排序,全部是 GET 链接
|
||||
- 品牌页:`/brands`、`/brands/[brand]`(品牌参数 URL 编码 + `decodeURIComponent`)
|
||||
- SEO:`/sitemap.xml` 动态端点(首页 / 列表 / 详情 / 芯片 / 品牌全覆盖)、`robots.txt`、详情页 `Product` JSON-LD、`site` 固定为 `https://specs.atie.fun`
|
||||
- 详情页补充:上市日期、生命周期、标签、字段级来源列表(按 confidence 着色,low 显示红色)
|
||||
- 详情页补充:上市日期、生命周期、标签、字段级来源列表(只对 low 显示徽章与 hover 说明,high/medium 不常驻标记,见 11.11)
|
||||
- 验证:本地 `pnpm build` 通过;线上 10 个路由与筛选组合均为 200,sitemap 与 JSON-LD 内容正确
|
||||
|
||||
### 11.5 运行环境与踩坑记录(供换机后参考)
|
||||
@@ -647,17 +647,366 @@ M0 完成标志:**本地 `docker compose up` 能打开首页,`/devices` 与
|
||||
- `8430e53` M0 脚手架(已推送)
|
||||
- `0c30c79` M1 只读增强(已推送)
|
||||
- `22aa0ef` 部署方式改为宿主构建 + 挂载(**本地已提交,待 `git push`**)
|
||||
- 当前工作区:M2 编辑后台、M3 AI 补全、M4 对比 / 导入导出(未提交)
|
||||
|
||||
**线上**
|
||||
- `https://specs.atie.fun` 待用户配置反代(目标 `127.0.0.1:3010`)
|
||||
- 可直接访问 `http://<ECS>:3010`(需安全组放行)或内网/Tailscale 地址
|
||||
|
||||
**下一步(M2 起)**
|
||||
1. M2 编辑后台:登录(`ADMIN_PASSWORD` + 签名 cookie)、设备/芯片表单、图片上传(`storage.ts`)、`revisions` 修订记录
|
||||
2. M3 AI 分级补全:`/api/ai/lookup` 返回扁平字段 + 置信度,表单按 high/medium/low 着色,low 阻塞保存
|
||||
3. M4 对比页(差异高亮、只看差异、数值条形化)、`/api/export` + `/admin/import`
|
||||
4. M5 动效打磨、OG 图、打印样式
|
||||
5. 换机续作时先执行 `pnpm install`(注意 `.npmrc` 的 hoisted 配置),再 `pnpm db:seed` 起本地数据
|
||||
**下一步(收尾)**
|
||||
1. 提交并推送 M2–M5,按 `scripts/deploy.sh` 部署到 ECS
|
||||
2. 线上验收:OG 图、打印样式、对比页、导入导出、AI 真实供应商
|
||||
3. 可选增强:对比页增加“复制链接 / 分享”按钮、更多数值字段的归一化评分
|
||||
4. 换机续作时先执行 `pnpm install`(注意 `.npmrc` 的 hoisted 配置),再 `pnpm db:seed` 起本地数据
|
||||
|
||||
### 11.7 M2 实施记录(已完成,本地验证)
|
||||
|
||||
**登录与保护**
|
||||
- `src/lib/auth.ts`:`ADMIN_PASSWORD` 常量时间比较(sha256 后 `timingSafeEqual`),`SESSION_SECRET` 签发 HS256 JWT,7 天有效
|
||||
- Cookie:`HttpOnly` + `SameSite=Lax` + `Path=/`,`COOKIE_SECURE=1` 时加 `Secure`
|
||||
- 登录失败按 IP 限速:1 分钟内 3 次后返回 `?error=rate`
|
||||
- `src/middleware.ts` 拦截 `/admin/**`,未登录跳 `/admin?next=...`
|
||||
- 写接口统一 `guardWrite`:登录态 + 同源校验;`/api/auth/logout` 直接清 cookie
|
||||
|
||||
**页面与接口**
|
||||
- `/admin`:未登录显示登录表单,已登录显示仪表盘(设备/芯片列表、最近修订、新增入口)
|
||||
- `/admin/devices/[slug]`(`new` 为新增)、`/admin/chips/[slug]`:React island 表单
|
||||
- 设备表单:基本信息、SoC 引用、封面图上传、9 个规格分组、前后摄逐颗增删、扬声器单元增删、扩展字段 JSON、字段来源徽章与“已核实”勾选
|
||||
- 芯片表单:基本信息、GPU/NPU/ISP/DSP/基带、内存存储显示支持、编解码;核心簇/跑分/扩展字段用 JSON
|
||||
- `POST /api/devices`、`POST /api/chips`:zod 校验,`?create=1` 时 slug 冲突返回 409,成功返回完整实体
|
||||
- `POST /api/upload`:登录 + 同源,允许 jpg/png/webp/avif,≤10MB,key 形如 `devices/<slug>/<时间戳>-<随机>.<ext>`
|
||||
|
||||
**修订记录**
|
||||
- `saveDevice` / `saveChip` 与 `revisions` 插入放在同一事务;保存失败整体回滚
|
||||
- 修订存保存后的完整快照;编辑页展示最近 10 条(`diff_json` 暂留空,回滚 UI 未做)
|
||||
|
||||
**安全配置**
|
||||
- 关闭 Astro 内置 `security.checkOrigin`:`@astrojs/node` 在未配置 `allowedDomains` 时会把 `request.url` 的 origin 回退到 `localhost`,导致反代后的表单提交被误判跨站
|
||||
- 自实现 `sameOrigin`:把 `Origin` 的 host 与 `Host` / `X-Forwarded-Host` 比对;所有写接口均已接入
|
||||
|
||||
**验证**
|
||||
- `pnpm typecheck`、`pnpm build` 通过
|
||||
- 用独立验证库(`DB_PATH=data/verify.db`、`UPLOADS_DIR=data/verify-uploads`)启动 standalone 产物:`node dist/server/entry.mjs`
|
||||
- 未登录访问编辑页 302 到登录;无 cookie 写接口 401;错误 Origin 403;空 payload 400;重复 slug 409
|
||||
- 登录成功后保存设备/芯片,前台详情同步更新;`revisions` 生成快照;图片上传后 `/uploads/<key>` 返回 200 与正确 content-type
|
||||
- 浏览器端到端:登录 → 仪表盘 → 编辑 Xiaomi 14 → 修改简介 → 保存 → 出现“已保存”
|
||||
- 连续 3 次错误密码后第 4 次正确密码返回 `?error=rate`
|
||||
- 本机受限沙箱内 `astro dev` 首次 SSR 模块读取耗时 90s+ 并触发 `transport invoke timed out`,故本地验证走生产构建产物;普通终端如遇同样问题可用 `pnpm build && node dist/server/entry.mjs`
|
||||
|
||||
### 11.8 M3 实施记录(已完成,mock + 浏览器验证)
|
||||
|
||||
**字段注册表**
|
||||
- 新增 `src/lib/spec-fields.ts`:手机规格分组、摄像头字段、扬声器字段、路径读写(支持 `rearCamera[0].sensorModel` 这类扁平路径)、字段标签、AI 白名单判定
|
||||
- `DeviceEditor` 改为从注册表渲染,不再内嵌字段定义
|
||||
|
||||
**AI 管线(`src/lib/ai/`)**
|
||||
- `search.ts`:Tavily 兼容搜索,取前 5 条(标题 / URL / 内容摘要);未配置 key、无结果、请求失败都降级为模型知识并返回提示
|
||||
- `prompt.ts`:系统提示要求只输出 JSON;用户提示注入品牌、型号、白名单路径、资料正文;明确 high/medium/low 判定与“无资料不得 high”
|
||||
- `lookup.ts`:OpenAI 兼容 `chat/completions`(`response_format: json_object`,120s 超时),解析失败自动修复一轮
|
||||
- 字段校验:只接受注册表白名单;bool / number / list / position 强转;非法路径与类型丢弃;`sourceUrl` 必须命中本次搜索 URL,否则丢来源并把 high 降为 medium;无搜索时 high 统一降 medium;按 high→medium→low 排序,最多 200 项
|
||||
- 缓存:按 `phone|品牌|型号` 写入 `ai_cache`;支持 `force` 绕过并覆盖缓存
|
||||
- `apply.ts`:把扁平字段合入设备 specs(摄像头 / 扬声器单元自动补槽),同步写 `meta[]`(confidence / sourceUrl / verified=false / capturedAt);提供清空字段与展示格式化
|
||||
|
||||
**接口与阻塞**
|
||||
- `POST /api/ai/lookup`:登录 + 同源,参数 zod 校验;未配置返回 503,模型/搜索异常返回 502
|
||||
- 保存接口(设备 / 芯片)新增服务端 low 检查:存在 low 且未核实且有值的字段时返回 400,附带 `path` 列表
|
||||
- 前端保存前同样检查;底部显示待核对清单,可「确认全部 low」「清空全部 low」;来源区支持「全部接受 high」
|
||||
|
||||
**表单交互**
|
||||
- 基本信息后新增 AI 补全区:品牌/型号、忽略缓存、加载态、错误提示
|
||||
- 结果预览逐项显示字段标签、置信度徽章、当前值 → AI 值、是否有变化、来源链接
|
||||
- 默认全选,可逐项取消;应用后写入表单与 meta,字段右侧徽章立即更新
|
||||
|
||||
**验证**
|
||||
- `pnpm typecheck`、`pnpm build` 通过
|
||||
- 本地 mock 服务同时模拟 Tavily `/search` 与 OpenAI `/v1/chat/completions`,用独立验证库跑 standalone 产物
|
||||
- 返回 10 个字段:真实来源的 high 保留;伪造来源的 high 丢来源并降 medium;无来源 high 降 medium;`specs.evil` 被丢弃;`speakers.count` 字符串 "2" 转为数字 2
|
||||
- 第二次请求 `cached=true`;`force=true` 返回 `cached=false`;`ai_cache` 只有一条记录
|
||||
- 无 AI 配置的服务实例返回 503,并列出缺失变量
|
||||
- 种子设备的 low 字段使保存返回 400;把该字段 `verified` 置 true 后保存 200
|
||||
- 浏览器端到端:登录 → Xiaomi 14 → AI 补全 → 预览 high 2 / medium 7 / low 1 → 应用 10 个字段 → 保存被客户端拦截 → 确认全部 low → 保存成功(`?saved=1`,修订 #2)
|
||||
- 保存后核对数据库:刷新率 144Hz、电池 5000mAh、配色数组、`rearCamera[1]` 更新为 tele + S5KJN1、扬声器数量 2,meta 来源与置信度完整
|
||||
|
||||
### 11.9 M4 实施记录(已完成,本地验证)
|
||||
|
||||
**对比页**
|
||||
- `/compare`:无 ids 或不足 2 款时显示选择器;支持 `?ids=a,b` 与重复 `ids=a&ids=b`;校验 2–4 款、同类目、slug 存在
|
||||
- `src/lib/compare.ts` 从字段注册表生成分组;后置影像按位置(主摄/超广角/长焦/潜望/微距/景深/黑白)分组,前置单独;扬声器单元聚合
|
||||
- 差异高亮(圆点 + 行底色),缺失值 `—` 置灰;`?diff=1` 只看差异
|
||||
- 每组 `<details>` 可折叠;首列 sticky;横向滚动
|
||||
- 数值条形:重量、屏幕尺寸、典型/峰值亮度、刷新率、电池容量、有线/无线充电、扬声器数量;宽度按组内最大值归一
|
||||
- 导航加入「对比」,详情页加入「加入对比」,选择器自动预选
|
||||
|
||||
**导出**
|
||||
- `GET /api/export` 公开下载,`formatVersion: 1`,包含 devices / chips / exportedAt / generator
|
||||
- `content-disposition` 文件名带时间戳,`cache-control: no-store`
|
||||
|
||||
**导入**
|
||||
- `POST /api/import`:登录 + 同源;支持 JSON body 或 multipart(`file` / `json` 字段)
|
||||
- 格式 `{formatVersion:1, devices, chips}`;逐条 zod 校验,全部通过才进入事务
|
||||
- `repo.importEntities` 在同一事务内 upsert,任一失败回滚;保留 created_at,更新 updated_at,并写 revisions
|
||||
- 上限 5000 条 / 20MB;错误返回带 `path` 的 issues
|
||||
- `/admin/import` 页面:选择文件或粘贴 JSON、格式化、错误列表、导入结果;仪表盘加入导入/导出入口
|
||||
|
||||
**备份**
|
||||
- 复用 `pnpm backup`:`VACUUM INTO` 生成一致性 DB 快照 + 复制 uploads;本次用验证库跑通并确认快照可查询
|
||||
|
||||
**验证**
|
||||
- `pnpm typecheck`、`pnpm build` 通过
|
||||
- 导出返回 formatVersion=1、devices=1、chips=1
|
||||
- 将导出 JSON 克隆出 Xiaomi 14 Pro(改 slug/型号/尺寸/重量/电池/主摄)后导入,返回 devices=2/chips=1;前台详情与对比页均 200
|
||||
- `/compare`(空 / 1 款)显示选择器;2 款对比页含字段列、差异圆点、数值条、分组;`diff=1` 从 10 项缩到 6 项
|
||||
- 浏览器验证:表头与两款机型、只看差异切换、数值条、分组折叠均通过
|
||||
- 脏数据导入 400(4 处 issue),未写入合法的那一半(`/devices/should-not-exist` 仍 404)
|
||||
- formatVersion=2 返回 400;未登录导入 401
|
||||
- 备份脚本产出 `backups/<时间戳>/app.db` 快照
|
||||
|
||||
### 11.10 M5 实施记录(本地完成,线上部署待执行)
|
||||
|
||||
**动效**
|
||||
- BaseLayout 引入 Astro `<ClientRouter />`,`<main transition:animate="fade">` 做页面淡入
|
||||
- 列表网格加 `.reveal-grid`:CSS `reveal-up` 0.35s + 40ms 级联(最多 8 个),无额外 JS
|
||||
- `prefers-reduced-motion: reduce` 下关闭列表动画与 View Transition 动画;未引入 GSAP / Lenis
|
||||
|
||||
**OG 图**
|
||||
- 新增 `src/pages/og/[slug].png.ts`:设备 slug 生成 1200×630 PNG,`site` 为通用站点卡;未知 slug 404,进程内缓存 5 分钟
|
||||
- `src/lib/og.ts`:SVG 卡片模板 + sharp(density 72)转 PNG;设备卡展示品牌型号、生命周期、SoC / 屏幕 / 电池 / 重量
|
||||
- OG 文字只用 Latin 字符(型号/芯片名含中文时回退 slug,尺寸/电池/重量抽取数字后统一单位),避免容器缺中文字体出现方框
|
||||
- BaseLayout 输出 canonical、`og:type/title/description/url/image`、`og:image:alt`、`twitter:summary_large_image`
|
||||
- 设备详情页传入 `/og/<slug>.png` 与 canonical 路径;其他页面默认 `/og/site.png`
|
||||
|
||||
**打印**
|
||||
- 全局 `@media print`:浅色配色、隐藏 `.print-hidden`(导航、页脚、操作按钮)、取消 sticky / 横向滚动 / 阴影、`break-inside: avoid`
|
||||
- 设备详情页加「打印 / 保存 PDF」按钮,调用 `window.print()`
|
||||
- 对比页的切换按钮与面包屑打印时隐藏
|
||||
|
||||
**主题与交互细节(反馈修正)**
|
||||
- 黑白主题通过 `html[data-theme]` + 同一套语义变量实现;右上角按钮切换,`localStorage` 记忆,首次访问跟随系统
|
||||
- 头部主题脚本在 `<head>` 内联执行,避免首屏闪烁;切换按钮用事件委托,ClientRouter 导航后仍有效
|
||||
- ClientRouter 换页会带入服务端渲染的 `<html data-theme="dark">`,因此监听 `astro:before-swap` / `astro:after-swap` / `astro:page-load`,把 `localStorage` 中的选择重新写回,避免跨页后主题失效
|
||||
- 详情页关键参数卡、影像卡、规格表行增加 hover:行底色 + 字段名切强调色
|
||||
- 修复手机列表卡嵌套 `<a>` 导致的布局错乱:卡片改为单一链接,品牌改为纯文本,卡片恢复紧凑网格布局
|
||||
|
||||
**部署**
|
||||
- `sharp` 升为直接依赖
|
||||
- 标准 Dockerfile runtime 阶段安装 `fontconfig` / `ttf-dejavu`
|
||||
- 宿主构建 + `node:24-slim` 方案在 compose 中只读挂载宿主 `/usr/share/fonts` 与 `/etc/fonts`;线上主机需有 DejaVu 字体
|
||||
|
||||
**验证**
|
||||
- `pnpm typecheck`、`pnpm build` 通过
|
||||
- `/og/site.png`、`/og/xiaomi-14.png` 返回 200 / image/png / 1200×630,未知 slug 返回 404;读取 PNG 确认标题、四个参数卡与底部文字无重叠溢出
|
||||
- 详情页 HTML 含 canonical、`og:type=article`、设备专属 `og:image`、twitter 卡;首页使用 `/og/site.png`
|
||||
- 页面含 `astro-view-transitions-enabled`,列表页含 `.reveal-grid`,构建 CSS 含 `.print-hidden` 与 `reveal-up`
|
||||
- 浏览器验证:首页卡片、手机列表、Xiaomi 14 详情、加入对比与打印按钮均正常;详情标题已去除“Xiaomi Xiaomi”重复
|
||||
- 黑白主题实测:`data-theme` 与 `localStorage` 在 dark/light 间正确切换;手机列表卡恢复为正常紧凑卡片
|
||||
- 跨页主题实测:`/devices` 切到 light 后进入 `/devices/xiaomi-14` 仍为 light,返回列表与整页刷新后也保持
|
||||
- 详情页 hover 实测(dark / light 两套配色):规格行背景高亮、字段名变为强调色
|
||||
- 未执行线上部署:需要先提交/推送代码,并在 ECS 安装/挂载字体后按 `scripts/deploy.sh` 上线
|
||||
|
||||
### 11.11 详情页参数展示改造(反馈修正)
|
||||
|
||||
**顶部参数卡**
|
||||
- 从 6–8 张扩展到 19 张,分多排展示:SoC、屏幕、电池、主摄、超广角、长焦、影像场景、内存、存储、充电、无线充电、系统、马达、扬声器、Wi-Fi、USB、指纹、重量、防护
|
||||
- 屏幕卡同时展示尺寸与分辨率,内存卡展示 RAM + 类型,充电卡展示有线/无线功率,USB 卡展示版本 + 实际速率
|
||||
- 卡片改为 `<a href="#specs-…">`,点击平滑滚动到对应详细分组;分组与 `SoC` 卡均加 `scroll-mt-6`,避免被粘性头部遮挡
|
||||
|
||||
**详细参数**
|
||||
- 分组拆为:外观、屏幕、平台、内存与存储、振动、扬声器、连接、电池与充电、传感器、系统与更新;前后摄单独分组
|
||||
- 屏幕新增面板厂商 `display.vendor`(如 TCL 华星)与技术代号 `display.technology`(如 C8)
|
||||
- 双扬声器按 `speakers.units[].position` 拆成“扬声器(上)/(下)”两行,分别展示型号、尺寸、功率
|
||||
- 振动新增实际体积 `vibration.volume`
|
||||
- 连接新增 `connectivity.bands`、`satellite`、`satelliteProvider`、`satelliteBands`、`usbSpeed`、`usbVideoOut`
|
||||
- 系统新增 `software.currentVersion` 与 `software.updateTimeline`,更新时间线逐条展开为“更新记录 1/2…”
|
||||
- 内存新增 `memory.storageSpeed`
|
||||
|
||||
**Hover 弹层与低置信度标记**
|
||||
- 新增 `HoverInfo.astro`:连接分组内的“移动网络频段(N)”和“卫星通信频段”支持 hover / 键盘聚焦弹出面板;卫星面板显示运营商与频段 chip
|
||||
- 新增 `LowBadge.astro`:只对 `confidence === 'low'` 渲染 `low` 徽章;hover / 聚焦显示字段名、路径、已核实/待核实、来源链接;`high` 与 `medium` 不标记
|
||||
- 顶部卡片、影像字段、规格行与数据来源列表统一使用 `LowBadge`;数据来源列表移除了 high/medium/low 颜色标签,只保留核实状态与 low 徽章
|
||||
|
||||
**数据与后台**
|
||||
- `phoneSpecsSchema` 与 `spec-fields.ts` 同步新增字段;AI 白名单、表单、路径读写自动覆盖
|
||||
- 后台设备表单的 list 字段改用 `ListInput` 提交到 `specs`;`ListInput` 在外部值变化时同步输入框(AI 应用/回填)
|
||||
- 扬声器单元行新增“位置”选择(上/下/左/右)
|
||||
- `scripts/seed.mjs` 更新 Xiaomi 14 示例数据并重新执行 `pnpm db:seed`
|
||||
|
||||
**验证**
|
||||
- `pnpm typecheck`、`pnpm build` 通过
|
||||
- 顶部参数卡布局正常;点击“屏幕”卡后 `#specs-display` 滚动到距顶部约 24px
|
||||
- 屏幕厂商/技术、上/下扬声器型号、马达体积、USB 速率/视频输出、系统更新记录均正确渲染
|
||||
- “移动网络频段(18)”hover 正常显示 18 个频段
|
||||
- 用临时数据库把 Xiaomi 14 改为卫星机型(天通 + T1/T2/T3),hover“卫星通信频段”正常显示运营商与频段 chip;验证后已删除临时库与测试服务器
|
||||
- low 徽章 hover 显示“振动 · 马达型号 待核实”及来源;high 字段不再出现标记
|
||||
|
||||
### 11.12 对照“手机性能排行”补充参数(三扬声器 / 附加说明)
|
||||
|
||||
**数据修正(Xiaomi 14)**
|
||||
- 屏幕比例改为 `20.0:9`,补 OLED 等效 PPI `375`,峰值亮度改称“局部峰值亮度”;屏幕特性补“柔性直屏”“支持类DC调光”
|
||||
- 充电协议补 `QC2.0`
|
||||
- 超广角补 `115°` 视场角;长焦改为 `2.6x 光学(60mm)/ 3.2x(75mm)`,对焦补“10cm 以上”
|
||||
- 设备跑分补 GFXBench 曼哈顿 3.1 High、Aztec Ruins High 与综合效能;备注补玻璃版/素皮版的厚度与重量;补耳机接口说明
|
||||
- SoC 补 `6 MB` 系统缓存
|
||||
|
||||
**新增字段与能力**
|
||||
- 新增 `display.equivalentPpi`、`cameraModule.fov`、`socDetail.systemCache`
|
||||
- 复用 `display.refreshNote` 表达附加说明,如“1-165Hz 自适应刷新率,最高支持 185Hz(185Hz 只在部分游戏场景生效)”
|
||||
- `speakers.units[].label` 支持“上 / 下 / 中置 / 第三单元”等任意标识,`speakers.units` 可超过两个单元
|
||||
|
||||
**验证**
|
||||
- 临时数据库将 Xiaomi 14 改为三扬声器(上 / 下 / 中置)并写入 185Hz `refreshNote`
|
||||
- 页面正确渲染“扬声器(上 / 下 / 中置)”、顶部卡片“3 单元”、刷新附加说明、等效 PPI、视场角、系统缓存、QC2.0、GFXBench、备注与耳机接口
|
||||
- `specs.benchmarks` 的 low 徽章 hover 正常显示说明;`pnpm typecheck`、`pnpm build` 通过;临时库与测试服务已删除
|
||||
|
||||
### 11.13 AI 添加设备与三机型排版优化
|
||||
|
||||
**AI 补全**
|
||||
- `.env` 接入 DeepSeek(`AI_BASE_URL=https://api.deepseek.com/v1`、`AI_MODEL=deepseek-chat`);未配置 Tavily,仍可走模型知识
|
||||
- 实测无参考资料时只返回 8 个泛化字段(且全为 low),不满足最新机型录入
|
||||
- 编辑页「AI 补全」新增“补充参考资料”:官方链接 + 官网参数文本;后端 `sourceText` 随请求进入提示词,并参与缓存键,避免与无资料结果串缓存
|
||||
- 提示词补全 `PHONE_TOP_LEVEL_FIELDS`(手机特点 / 影像功能 / 跑分 / 售价 / 官网),扬声器单元扩展到 `0..4`,要求逐单元用 `label` 区分上 / 下 / 中置 / 低音单元,附加条件写入 `display.refreshNote`
|
||||
- 实测:K90 Pro Max 返回 76 个字段、Find X10 Pro Max 返回 80 个字段,均为 medium;应用后可用人工修正补齐
|
||||
|
||||
**新增设备**
|
||||
- `redmi-k90-pro-max`:第五代骁龙 8 至尊版、6.9 英寸 120Hz、7560mAh、100W + 50W、BOSE 2.1 三扬声器(上 / 下 / 低音炮)、5x 潜望长焦
|
||||
- `oppo-find-x10-pro-max`:天玑 9600 Pro、6.78 英寸 144Hz(1-120Hz 智能切换,144Hz 仅部分游戏)、8000mAh、80W + 50W、三颗 2 亿像素镜头 + 丹霞色彩镜头、冰河散热
|
||||
- 新增 `scripts/seed-devices.json` 保存两台设备的完整规格,`seed.mjs` 改为按 slug 循环 upsert 三台设备
|
||||
|
||||
**排版**
|
||||
- 顶部卡片改为等高、两行截断;电池 / 充电 / Wi-Fi / 相机使用短值,避免长文本溢出
|
||||
- 卡片上方新增分组快捷导航
|
||||
- 详情分区调整为:屏幕与外观 → 性能(SoC + 平台 + 内存 + 跑分)→ 影像 → 电池与充电 → 音频与振动 → 连接与网络 → 传感器 → 系统与更新 → 售价与补充
|
||||
- 分区加编号与分组小标题,表格包进圆角卡片;相机位置改为中文标签,新增 `color`(色彩镜头)枚举与标签
|
||||
- 未关联芯片库的设备显示“芯片库暂未收录”,不再出现空白性能区
|
||||
|
||||
**验证**
|
||||
- 三台设备详情页 200;卡片、快捷导航、分区顺序、K90 三扬声器、OPPO 色彩镜头均正常
|
||||
- K90 / OPPO 数据来源从 76/80 条字段级记录收敛为 1 条整机来源 + 售价记录
|
||||
- `pnpm typecheck`、`pnpm build`、`pnpm db:seed` 通过
|
||||
|
||||
|
||||
### 11.14 AI 多源检索、快速创建与字段级补全
|
||||
|
||||
**多来源检索**
|
||||
- Tavily 仍为优先;未配置 `SEARCH_API_KEY` 时改为 Bing / Baidu 公开检索 + 白名单抓取
|
||||
- 白名单:厂商官网、ZOL、PConline、Kalvo、GSMArena、IT之家、快科技、Notebookcheck、SMZDM、知乎等
|
||||
- 同一域名最多 2 条,避免官网泛化页占满结果;官方 URL 按品牌 / 型号直接猜测(如 `mi.com/prod/{slug}/specs`、OPPO Find X 系列参数页)
|
||||
- Kalvo 搜索作为稳定补充源:`zh.kalvo.com/search?q=型号`,可补到 ZOL / PConline 未覆盖的机型
|
||||
- 检索失败才降级为模型知识;抓到的来源全部进入提示词做交叉验证
|
||||
|
||||
**快速创建流程**
|
||||
- `/admin/devices/new` 只保留 slug 输入 + 单按钮;提交后调用 `POST /api/ai/prospect`
|
||||
- 服务端从 slug 推断品牌 / 型号(redmi-k90-pro-max → Redmi / K90 Pro Max),多源补全后直接创建初稿
|
||||
- 创建成功跳转 `/admin/devices/{slug}?created=1`,进入原有详细编辑页
|
||||
|
||||
**字段级补全**
|
||||
- 每个规格字段(含摄像头字段、扬声器单元、设备补充、振动等)旁新增 `AI` 按钮
|
||||
- 调用 `POST /api/ai/field`,只检索当前字段;字段旁的“补充参考资料”文本也会传入
|
||||
- 适合官网不公开的扬声器单元型号、尺寸、马达型号、体积;实测 K90 Pro Max:
|
||||
- 扬声器单元:`AAC 1115K`
|
||||
- 马达:`瑞声 0809B`
|
||||
- 均以 `medium` 写回,并保留“仅拆解资料提及”的 note
|
||||
|
||||
**稳定性处理**
|
||||
- `max_tokens` 提升到 8192;提示词要求 `note` 只在冲突/必要补充时填写,减少输出体积
|
||||
- 输出被截断时用 `salvageFields` 保留已完整的字段对象,避免整批失败
|
||||
- 多来源 URL 合并为 `sourceUrls`,最多 3 个;`note` 在编辑预览中展示
|
||||
|
||||
**实测**
|
||||
- OPPO Find X10 Pro Max:6 个来源(官网 ×2 / ZOL ×2 / PConline / Kalvo),返回 100 个字段
|
||||
- REDMI K90 Pro Max:5 个来源(ZOL / Kalvo / SMZDM 等),返回 68 个字段
|
||||
- OnePlus 15:公开资料不足,仅 4 个字段,仍可创建初稿后手动补充
|
||||
- 浏览器验证快速创建:输入 `oneplus-15` → 生成初稿 → 自动跳转详细编辑页;每个字段的 `AI` 按钮正常渲染
|
||||
- `pnpm typecheck`、`pnpm build` 通过
|
||||
|
||||
|
||||
### 11.15 中国市场本地化与二次补全修复
|
||||
|
||||
**问题**
|
||||
- OnePlus 16 快速创建只返回 20~41 个字段,大量英文,售价为 `€800`
|
||||
- 编辑页输入官网 URL 二次补全仍缺失;ZOL 参数页正文在导航/概览后约 3600 字符才进入详细参数,3500 字符截断导致只拿到概览
|
||||
|
||||
**修复**
|
||||
- 单来源正文上限 3500 → 9000 字符;ZOL / PConline 详细参数表可完整进入提示词
|
||||
- 提示词新增中国市场规则:文本值简体中文(芯片/协议/接口/传感器代号保留英文),`pricing` 只写国行人民币;只有 EUR / USD / GBP 时直接省略
|
||||
- 服务端对 `pricing` 做二次过滤,含 `€/£/$/EUR/USD/GBP/欧元/美元/英镑` 的条目直接丢弃
|
||||
- 手动补充链接改为真正抓取正文:`fetchManualSources()` 不受白名单限制(仍拒绝内网),支持多行 URL(最多 4 条),并入 `sources` 后按 URL 去重
|
||||
- 纯数字型号的关键词筛选回退为品牌词,避免 OnePlus 16 抓到 iPhone 16 / Meizu 16 / realme 16
|
||||
- Kalvo 站内搜索改用“品牌 型号”,字段级检索同样修正
|
||||
- `officialUrl` 从已抓取来源里按“官方域名 + 路径含型号 + 具体参数页”打分选出,替代模型输出的品牌列表页
|
||||
- AI 缓存键加版本前缀 `v2`,检索/提示词规则变更后不再命中旧结果
|
||||
|
||||
**实测(OnePlus 16)**
|
||||
- 整机检索:6 个来源(官网 / ZOL ×2 / PConline / OPPO shop 等),96 个字段,中文 + 人民币,
|
||||
`officialUrl = https://www.oneplus.com/cn/oneplus-16/specs`
|
||||
- 手动补充官网 + ZOL:93 个字段,官网来源优先,高置信度字段明显增多
|
||||
- 字段级 `specs.vibration.volume` 返回 `null`:官网 / ZOL 不公开马达体积,属于资料缺失而非流程失败
|
||||
- 已用最新结果刷新测试草稿 `oneplus-16`:159 个非空值,售价为 5999 / 6799 / 7499 / 8499 元
|
||||
- `pnpm typecheck`、`pnpm build` 通过;详情页 200,售价、扬声器、官网链接正常渲染
|
||||
|
||||
|
||||
### 11.16 编辑页字段核验与详情页顶部展示带
|
||||
|
||||
**编辑页**
|
||||
- 每个带 `FieldMeta` 的输入框增加「核验」按钮:一次点击把该路径 `verified` 置为 true,low 字段保存阻塞随之解除,无需滚到底部清单
|
||||
- AI 按钮与核验按钮统一放大到 `text-xs` + `px-3 py-1.5`;置信度徽章改为 `text-xs`、带底色,待核 / 已核状态更易读
|
||||
- 摄像头位置、视频模式、扬声器单元等动态路径也接入同一套 AI + 核验按钮
|
||||
|
||||
**详情页**
|
||||
- 标题下方新增 `device-hero` 展示带:配色圆点 + 中文色名;售价按版本拆成卡片,最低价高亮「起售价」
|
||||
- 顶部渐变取自首个配色(`--device-accent`),叠加细网格纹理;浅色主题自动降低透明度,打印时隐藏纹理
|
||||
- 初始售价从底部「售价与补充」移出,该节更名为「发布与补充」;配色从外观表移出
|
||||
- 移除底部「数据来源」字段清单,字段级来源只在编辑页保留;低置信字段仍保留 hover 徽章
|
||||
- 参数卡数值从 15px 提升到 17px 并加粗,标签增加字重;分组标题提升到 20~24px,表格正文 15px,镜头卡标题与分辨率加粗
|
||||
- 详情页卡片网格启用 `reveal-grid` 渐入;打印仍保持浅色且隐藏装饰背景
|
||||
|
||||
**验证**
|
||||
- `pnpm typecheck`、`pnpm build` 通过
|
||||
- 浏览器验证 `oneplus-16`:顶部展示 3 个配色与 4 档售价,底部无「数据来源」清单,卡片数值层级正常
|
||||
|
||||
|
||||
### 11.17 配色推断与字段级 AI 状态修正
|
||||
|
||||
**配色**
|
||||
- 一加 16「明日星光」原先未命中关键词,走哈希色相得到浅蓝;新增「星光 / 星芒 / 星耀」→ 银白 `#d8dce2`
|
||||
- 把绿色关键词组提到黑色之前:「黑暗森林」按森林绿而不是按“黑”取深灰
|
||||
- 未知名称仍用稳定哈希色相兜底
|
||||
|
||||
**字段级 AI**
|
||||
- 原先 `found=false` 也把按钮置为红色 `!`,与真正的接口/解析失败混淆;现在拆成三种状态:
|
||||
- `✓`:成功补全
|
||||
- `无`(黄色)+「无公开数据」:检索到来源但没有明确依据,hover 显示完整 notice
|
||||
- `!`(红色)+「检索失败」:HTTP 错误或模型输出无法解析
|
||||
- 字段补全会复用整机补全缓存里的来源 URL(过滤品牌首页 / 系列页 / 搜索页),即使 Bing / Baidu 临时限流,仍能用 ZOL / PConline / 官网正文
|
||||
- 模型返回 `null` 时抛出 502,不再被误判为“无数据”
|
||||
|
||||
**实测(OnePlus 16)**
|
||||
- 马达型号、扬声器尺寸在复用整机来源后可以补全;马达体积 / 扬声器功率 / 屏幕厂商仍返回「无公开数据」
|
||||
- 字段请求 notice 会写明「复用了整机补全的 4 个来源」以及公开检索结果
|
||||
- `pnpm typecheck`、`pnpm build` 通过;详情页 `--device-accent` 已变为 `#d8dce2`
|
||||
|
||||
|
||||
### 11.18 真实配色字段与区块级 AI 补全
|
||||
|
||||
**配色**
|
||||
- 文字色名无法稳定映射(“黑暗森林”实际为黑色),新增 `specs.body.colorHexes`,与 `colors` 顺序一一对应;AI 依据官方描述、产品图和色名语义给出 #RRGGBB
|
||||
- 展示页优先使用 `colorHexes`,缺失时回退到色名推断;一加 16 实测:
|
||||
- 明日星光 `#E8E8E6`(银白)
|
||||
- 黑暗森林 `#1C1C1E`(近黑)
|
||||
- 火星杰作 `#B5543A`(橙红)
|
||||
- 已刷新 `oneplus-16` 草稿,并补入用户确认的「京东方(BOE)/ X4 发光材料」
|
||||
|
||||
**区块 AI**
|
||||
- 新增 `POST /api/ai/section` 和 `lookupPhoneSection()`:按 `PHONE_SPEC_SECTIONS` 一次补全一个分区(外观、屏幕、平台、内存与存储、振动、连接、电池与传感器等)
|
||||
- 区块 prompt 只列该分区路径,允许跨字段推导(如分辨率 + 尺寸 → PPI),并保留交叉验证与 `colorHexes` 规则
|
||||
- 编辑页分区标题旁新增「区块 AI」按钮;结果以内联预览展示,可勾选后应用
|
||||
- 来源策略:整机缓存来源 + 区块定向检索 + 手动链接,最多 8 个;按主域限流,过滤品牌首页 / 系列页
|
||||
- Baidu 公开检索跳转链接解析从 5 条提升到 8 条并过滤广告位;Bing 中文结果噪声较大时由品牌关键词过滤兜底
|
||||
|
||||
**实测(OnePlus 16)**
|
||||
- 外观区块:8 个字段 + `colorHexes` 三色,medium;屏幕区块:20 个字段,补到边框 1.15mm,但仍未找到面板厂商
|
||||
- 面板厂商 / 发光材料主要出现在新闻稿;公开检索受限时可在「补充参考资料」粘贴对应链接后再跑区块 AI,或人工填写
|
||||
- `pnpm typecheck`、`pnpm build` 通过;详情页 accent 为 `#E8E8E6`,黑暗森林色块显示为近黑
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in new issue
Block a user