展开本页目录
开始前准备什么
- 项目规则必须是 .mdc；alwaysApply=true 会忽略 globs，需按任务选择附加方式。
- 规则是上下文指导，不是不可绕过的静态检查器；仍需 diff 审查和实际渲染。
- 模型访问与计费依当前 Cursor 订阅；不复用旧 Pro 固定价格描述。
- 先看三页和弹窗的共同主题结构
- 建立正确的 mdc 项目规则
- 在匹配上下文中明确调用规则
- 实现用户选择优先于系统
- 把弹窗纳入同一令牌系统
- 跨页刷新与系统切换实测
- 交付规则、diff 和主题证据
原创输入、提示词、原生配置、参考源码、实际结果和验收说明；不含模型账号或运行缓存。
按独立目录运行，原生代理会话需由自己另行执行。
1. 先看三页和弹窗的共同主题结构
先打开 before/page1.html、before/page2.html、before/page3.html 的错误样稿：深色页面仍有白色卡片/弹窗，选择浅色后刷新又回系统。根目录 page1/page2/page3 是已验证的人工修复参考；实际代理应先改错误样稿，再对照参考验收。
2. 建立正确的 mdc 项目规则
放入 .cursor/rules/theme.mdc，填写 description、globs 与 alwaysApply:false。普通 .md 不是等价配置；alwaysApply:true 会忽略 globs，不能一边写全局始终附加，一边声称只作用于样式文件。
3. 在匹配上下文中明确调用规则
在对应前端文件上下文中让 Cursor 读取 theme 规则，要求组件用 token、不新增字面颜色、保持用户偏好。检查实际附加规则和 diff，规则是指导上下文，并不自动变成不可绕过的 lint。
4. 实现用户选择优先于系统
用户选 light/dark 时使用固定值，选 system 才跟随 matchMedia；localStorage 存用户选择而不是解析后的颜色。这样下次系统变化仍可正确响应，刷新也不会丢用户意图。
5. 把弹窗纳入同一令牌系统
dialog、main、card 使用相同 surface/text。打开真实弹窗检查背景、文字与按钮；只改 body 背景会留下白色弹窗，这是本题明确要覆盖的边界。
本地练习命令
python3 -m http.server 4384 --bind 127.0.0.16. 跨页刷新与系统切换实测
本站 Playwright 设系统深色，验证 system 解析为 dark；用户选 light 后刷新和跳到第二、第三页仍为 light；再选 system 切换系统偏好，查看页面和弹窗实际计算样式。
7. 交付规则、diff 和主题证据
保存 .mdc、三个页面与弹窗明暗截图及 browser-result.json。不能把规则文件存在当作改造通过；验收要落到实际背景/文字、偏好优先级和刷新结果。
怎样确认已经完成
- 三页与弹窗实际主题/持久化应能按 README 在独立目录重现。
- 旧文约束 Decimal 金额算法或回归手机菜单；本题用 Cursor 规则限制样式修改范围，产物是多页面主题令牌改造和偏好优先级验证。
- 目标代理真实结果须另存；人工参考、原生会话和官方示例分别识别。
常见问题
Cursor 规则怎样只管前端样式文件？
在对应前端文件上下文中让 Cursor 读取 theme 规则，要求组件用 token、不新增字面颜色、保持用户偏好。检查实际附加规则和 diff，规则是指导上下文，并不自动变成不可绕过的 lint。
深色模式有一块还是白底，能按规则统一改吗？
本站 Playwright 设系统深色，验证 system 解析为 dark；用户选 light 后刷新和跳到第二、第三页仍为 light；再选 system 切换系统偏好，查看页面和弹窗实际计算样式。
本题哪些结果已经实际运行？
已运行的是三页与弹窗实际主题/持久化。原生功能操作按官方文档编排，目标代理未调用；英文检索可用“Cursor rules mdc globs theme tokens light dark system”定位对应术语，但这不是搜索量或热榜声明。