规范与标准

全站统一执行标准 · 不可绕过

代码规范

设计规范

部署规范

强制 CSS规范

var(--fire-primary) · 正确：使用CSS自定义属性

#C75A3A · 错误：硬编码色值

var(--base-divider) · 边框统一用base-divider

1px solid #DDD5CB · 硬编码边框色

var(--radius) · 圆角统一8px基准

所有颜色引用必须来自:root变量

间距使用原子：--space-xs(4) sm(8) md(16) lg(24) xl(32) 2xl(48) 3xl(80)

强制 HTML规范

首页og:url必须为https://os.zgscrh.com/

每页必须包含meta description

favicon链接：<link rel="icon" href="assets/favicon.ico">

所有链接使用相对路径（page.html）或根路径（/page.html）

禁止包含内部术语、五行描述、产品代号

强制 JS规范

生产环境禁止console.log

API密钥不得硬编码在HTML中，使用window.API_KEY || ''

JS文件禁止注入颜色/样式（通过CSS变量实现）

飞轮导流由nav-inject.html统一注入·不单独嵌入

建议命名规范

HTML文件：小写+连字符 compute-market.html user-guide.html

CSS类名：小写+连字符 .page-hero .svc-card

JS函数：驼峰 switchTab() validateForm()

API路径：/api/{domain}/{action} /api/leads /api/guard/validate

强制八字色板

火(用神)

--fire-primary

火·交互

--fire-hover

土(喜神)

--earth-gold

土·辅助

--earth-secondary

土·点缀

--gold-light

基底

--base-white

分割

--base-divider

正文/深底

--base-dark

用法：background:var(--fire-primary) · 导航激活/主按钮/Hero背景

用法：color:var(--fire-hover) · 按钮hover/提示/CTA强调

用法：border-color:var(--earth-gold) · 卡片hover边框/次要按钮

强制间距系统

基准：8px · 所有间距必须是8的倍数

--space-xs:4px · 极小间距（标签内边距）

--space-sm:8px · 小间距（元素内边距）

--space-md:16px · 中间距（区块内边距）

--space-lg:24px · 大间距（卡片间距·网格gap）

--space-xl:32px · 超大间距（卡片内padding）

--space-2xl:48px · 区块间距（section底部margin）

--space-3xl:80px · section padding-top/bottom

强制圆角/阴影/字体

圆角：--radius-sm(4) --radius(8) --radius-lg(12) --radius-xl(20)

阴影：--shadow-card:0 8px 30px rgba(61,58,54,.1) --shadow-btn:0 4px 16px rgba(199,90,58,.2)

字体：--font-display:42px --font-h2:28px --font-h3:17px --font-body:14px

字重：--weight-extrabold:800 --weight-bold:700 --weight-normal:400

建议组件规范

卡片：background:var(--base-white) + border:1px solid var(--base-divider) + border-radius:var(--radius-lg)

主按钮：background:var(--fire-primary) + color:var(--base-white) + border-radius:var(--radius)

Hero区：padding:120px 24px 80px + 深色渐变底 + 浅色文字

稳定商务 · 大留白 · 零emoji · 信任>花哨

强制部署Checklist

1 确认修改文件列表 + 依赖关系
2 读 deploy.js → 取 HOST/PASS/PATH（不凭记忆）
3 SFTP上传到 /www/wwwroot/os.zgscrh.com/
4 如修改 server.js → PM2 restart os-platform
5 如仅HTML/CSS → 无需重启·直接生效
6 agent-browser截图验证 → 至少3个核心页
7 全站grep检查 → 无302断链·无残留错误
8 今日日志记录 → 部署了什么·验证结果

强制服务器信息

生产服务器：59.110.20.87 · 路径：/www/wwwroot/os.zgscrh.com/

PM2进程：os-platform · 重启命令：pm2 restart os-platform

凭据位置：G:\WorkBuddy\Claw\.workbuddy\deploy.js · 密码第8行

旧服务器（101.43.120.193）密码不同·不可混用

强制部署后验证

1 HTTP 200验证：首页 + 3个核心页面
2 agent-browser截图：首页 + 2个修改页面
3 色板合规：无蓝色(#4xxx)、无绿色(#3xxx/#0x8x)
4 飞轮bar存在：子页面底部8节点栏
5 og:url = os.zgscrh.com（非裸域）
6 全站crawl：0个302跳转

参考紧急回滚

本地保留.html.bak备份 → 如部署后异常 → 立即回传备份文件

PM2日志：pm2 logs os-platform --lines 50 查看运行时错误

健康检查：curl https://os.zgscrh.com/health 确认服务状态