JOJO
b4030c386e
将前端配色从散落的硬编码/双命名体系（--claude-* / --theme-*）重构为 两层 token 结构（原始层 + 中性语义层），并按"经典抄 Claude、浅色抄 ChatGPT、深色自研"的定位完成三主题填色，同时建立 stylelint 防回退栏杆。 代码大量由 AI 生成的历史遗留配色问题（同语义多值、跨主题塌缩、强调色 撞文字色、fallback 第二真相源等）在此一并收口。 == 一、Token 结构重构（_tokens.scss）== - 重写为两层：原始层 + 语义层；组件只引用中性语义名 （--surface-* / --text-* / --border-* / --accent* / --state-* 等）。 - --claude-* / --theme-* 降级为兼容别名（41 个转发），迁移完成后删除。 - 三主题（classic / light / dark）+ 首屏回退（:root:not([data-theme])， 与经典同值）全部补齐，结构对齐、不再缺项。 == 二、三主题填色 == - 经典 = Claude 官网亮色盘：暖奶油表面阶梯 canvas #faf9f5 < soft #f5f0e8 < card #efe9de < cream-strong #e8e0d2 < 纯白浮起；文字 #141413；hairline #e6dfd8；暖橙 primary #cc785c。 - 浅色 = ChatGPT 亮色盘：冷白 #ffffff / 侧栏 #f9f9f9 / 嵌套 #f3f3f3， 中性灰文字，近黑 primary #181818。 - 深色 = 自研中性灰阶，本轮完全不动（原样保留）。 - 修复塌缩 bug：强调色在 light/dark 原被误填成灰（CTA 失去品牌色）， 现统一回品牌 primary；light 表面原全塌成 #ffffff（过于平面）， 现按灰阶拉开层次。 - 强调色克制（CTA-only voltage）：primary 仅用于发送按钮/logo 等极少 数处；hover / 选中 / 运行态一律走中性灰（运行态指示器从 amber 改灰）。 - 对话区背景从纯白改为暖奶油 canvas；个人空间下拉菜单、git 状态条、 二级菜单等收口到统一语义色。 == 三、全面去半透明 == - 所有实体面板/二级菜单背景改为不透明（surface token 由半透明白改实色， --mobile-menu 三亮色主题改实色）。 - 移除已不透明面板上失效的 backdrop-filter 磨砂（移动端菜单、右键菜单、 模型模式下拉等）。 - 遮罩 scrim（--overlay-scrim）与刻意玻璃质感装饰保留半透明。 == 四、块展开底色统一 == - 思考/工具块展开区底色统一为对话背景色：.collapsible-block 及其 header 背景由 --surface-soft 改 transparent，与堆叠块（stacked-block）一致， 消除"单块奶油底 vs 多块透明"的不一致。 == 五、布局修复 == - 工作区隐藏后残留空白：.workspace-panel--collapsed 补 flex-basis:0 + width/min-width:0，修正 flex-basis:auto 被子元素内容宽度撑开导致内联 width:0 失效、collapsed 后仍占 ~300px 的问题。 == 六、防回退栏杆（新增）== - 新增 .stylelintrc.cjs：三条规则拦截裸 hex / rgb()|hsl() 字面色 / var(--x, fallback) 兜底 / prefers-color-scheme；存量未清理文件用 BASELINE_EXEMPT 临时豁免（现仅剩 5 个 admin 页面，本轮按用户要求不处理）， 清理一个移除一个、不再回退。 - package.json：build 脚本接入 stylelint（tsc → stylelint → vite）， 新增 lint:css 脚本及 stylelint/postcss-scss/postcss-html 依赖。 - 修复 25 处 \!important 笔误（zsh 历史扩展污染导致的无效 CSS）。 == 七、辅助脚本（新增 scripts/）== - lint_check.py：Node 环境不可用时的 stylelint 替身（复刻三规则 + 括号 校验，支持多行声明检测）。 - color_map.py：硬编码色 → token 反查，判定可映射/野色。 - strip_fallback.py：安全剥离已定义 token 的冗余 fallback。 == 八、文档 == - CLAUDE.md / AGENTS.md 前端设计规范更新：颜色规则扩写为三主题定位 + 两层 token + 表面层次 + 强调色克制 + color-mix 派生 + stylelint 栏杆； 新增"实体面板禁止半透明"规则；"禁止边缘光晕"补充"仅在用户明确允许 或要求时才可使用"。 注：前端构建验证（npm run build / lint:css）由用户本机完成；AI 工具 上下文 Node v24 段错误无法运行 node/npm/vite/stylelint。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
83 lines
2.9 KiB
Python
83 lines
2.9 KiB
Python
#!/usr/bin/env python3
|
||
"""
|
||
color_map.py —— 硬编码色值 → token 反查。
|
||
解析 _tokens.scss 各主题真实值，对给定色值判定它等于哪个 token（A类）或无对应（B类）。
|
||
|
||
用法:
|
||
python3 scripts/color_map.py <file> # 分析某文件里所有硬编码色的可映射性
|
||
"""
|
||
import sys, re, os
|
||
from collections import defaultdict
|
||
|
||
TOK = "static/src/styles/base/_tokens.scss"
|
||
|
||
def norm(v):
|
||
"""归一化色值：小写、去多余空格、#abc->#aabbcc、rgb 空格统一。"""
|
||
v = v.strip().lower()
|
||
v = re.sub(r'\s+', '', v)
|
||
m = re.fullmatch(r'#([0-9a-f])([0-9a-f])([0-9a-f])', v)
|
||
if m:
|
||
v = '#' + ''.join(c*2 for c in m.groups())
|
||
return v
|
||
|
||
def load_tokens():
|
||
txt = open(TOK, encoding='utf-8').read()
|
||
# semantic blocks only ([data-theme])
|
||
themes = {}
|
||
for m in re.finditer(r":root\[data-theme='([^']+)'\]\s*\{([^}]*)\}", txt):
|
||
name, body = m.group(1), m.group(2)
|
||
d = {}
|
||
for dm in re.finditer(r'(--[a-z0-9-]+)\s*:\s*([^;]+);', body):
|
||
d[norm(dm.group(2))] = dm.group(1)
|
||
themes[name] = d
|
||
return themes
|
||
|
||
def analyze(path, themes):
|
||
text = open(path, encoding='utf-8').read()
|
||
# only style content for vue
|
||
if path.endswith('.vue'):
|
||
style = '\n'.join(m.group(1) for m in re.finditer(r'<style[^>]*>(.*?)</style>', text, re.S|re.I))
|
||
else:
|
||
style = text
|
||
style = re.sub(r'/\*.*?\*/', '', style, flags=re.S)
|
||
style = re.sub(r'//[^\n]*', '', style)
|
||
vals = re.findall(r'#[0-9a-fA-F]{3,8}\b|rgba?\([0-9 ,.%/]+\)|hsla?\([0-9 ,.%/]+\)', style)
|
||
A = defaultdict(list) # value -> [(theme, token)]
|
||
B = defaultdict(int) # value -> count (no match)
|
||
counts = defaultdict(int)
|
||
for raw in vals:
|
||
n = norm(raw)
|
||
counts[raw] += 1
|
||
hits = []
|
||
for tname, d in themes.items():
|
||
if n in d:
|
||
hits.append((tname, d[n]))
|
||
if hits:
|
||
A[raw] = hits
|
||
else:
|
||
B[raw] += 1
|
||
return counts, A, B
|
||
|
||
def main():
|
||
themes = load_tokens()
|
||
path = sys.argv[1]
|
||
counts, A, B = analyze(path, themes)
|
||
print(f"=== {path} ===")
|
||
print(f"硬编码色值种类: {len(counts)}, 总出现: {sum(counts.values())}")
|
||
print(f"\n--- A类(有 token 对应, 可映射) ---")
|
||
for v in sorted(A, key=lambda x:-counts[x]):
|
||
# 取 classic 优先的 token 名
|
||
toks = {t:tok for t,tok in A[v]}
|
||
cls = toks.get('classic')
|
||
shown = cls or list(toks.values())[0]
|
||
themes_hit = ','.join(sorted(toks.keys()))
|
||
print(f" {counts[v]:3d}× {v:32s} -> {shown:28s} (命中主题: {themes_hit})")
|
||
print(f"\n--- B类(无 token 对应, 野色, 需决策) ---")
|
||
for v in sorted(B, key=lambda x:-B[x]):
|
||
print(f" {B[v]:3d}× {v}")
|
||
if not B:
|
||
print(" (无 — 此文件可全量安全迁移)")
|
||
|
||
if __name__ == '__main__':
|
||
main()
|