Files
NotesAgentic/docs/development/主题组件覆盖检查.md
T

3.0 KiB

主题组件覆盖检查(2026-09-05)

本次检查仓库内 3 个内置主题和 3 个社区预设,共扫描 105 个前端源文件的组件与语义样式变量。用户自行导入的第三方 CSS 不在仓库中,不据此声称已验收。

范围与结果

扫描到 70 个颜色、字体、间距、圆角、阴影、动效和行高变量引用,修复后未定义引用数为 0。颜色及控件样式由共享 token、组件样式和主题覆盖共同提供;继承共享样式不等于未适配。新增 themeCoverage.spec.ts 保持全源文件变量引用检查,并检查社区预设的交互色、Markdown 色及 color-scheme。

主题 新版本 修正
Light / Dark 1.1.1 原生表单控件底色及浏览器 color-scheme
Sepia 1.1.1 控件底色、焦点、按下态、柔和悬停色
Ocean Blue 1.3.1 活动态、反色文字、禁用色、Markdown 表格与标记色
Midnight Purple 2.1.1 深色 color-scheme、原生控件及上述交互/Markdown 色
纸间时光 1.6.1 新增分模型统计、缓存说明、数据提示及大图查看样式

MCP JSON 编辑器错误引用的 --font-family-mono 已改为共享 --font-ui-mono。全局原生控件底色使用零优先级选择器,组件和主题仍可覆盖。旧版社区主题需在主题页点击“更新”;不会覆盖用户自行修改的已安装 CSS。

这是全仓库静态样式覆盖和功能回归检查,不是所有屏幕尺寸下的逐页视觉验收,也不把变量有定义等同于对比度全部达标。

用量与交互

柱状图按日期和来源聚合,再以 Provider ID + 模型 ID 分割同柱。模型分段之和与来源总计一致;同一来源使用色彩深浅区分,提供商柱保留斜纹。缺失计数仍显示“未提供”,不补估历史值。

缓存命中率只对同时提供命中和未命中计数的请求计算:命中合计除以这些请求的输入合计;缺少输入时分母使用命中加未命中。本次本地记录检查中的两次 DeepSeek 调用,厂商明确报告命中 0,未命中分别为 1015、1219,写入缺失。没有新增外部模型调用。

AI 对话 Enter 发送,Shift+Enter 换行,输入法确认和长按 Enter 不触发重复发送。Mermaid 普通预览控件在悬停/键盘聚焦时显示,触屏保留按钮;大图可直接滚轮缩放,普通预览需中键启用。滚轮归一化并按时间限制缩放速度,每秒连续输入不会无限叠加瞬时倍率。

下拉与折叠控件补充

编辑器外观行统一为标签、38px 控件、说明三层,避免只有代码主题字段带说明时将其他控件拉偏。补齐所有原生 details 的 ui-disclosure 样式,统一折叠箭头、展开背景和边框。下拉框增加共享箭头、选项配色、焦点及禁用态;支持 appearance: base-select 的浏览器使用可主题化选项面板,其他浏览器保留原生选择行为并应用可支持的颜色。原生系统弹出层的完整装饰不能仅靠 CSS 在所有浏览器中保证。