这个仓库是 F0RCE 团队首页。维护目标是让它作为一个 agent-first 的静态作品集网站长期可改、可验、可替换内容,而不是过早变成需要后台、账号、数据库和上传系统的小产品。
- 默认语言是中文。导航、按钮、标题、说明、辅助标签、meta description 都应优先使用中文;GitHub、AI、CLI、Next.js 这类技术名词可以保留英文。
- 这个站优先展示项目和团队气质,不做营销式落地页。第一屏要有记忆点,项目区要易浏览。
- 不要新建管理面板,除非用户明确要求并说明需要账号、权限、草稿、审核或高频非技术维护。
- 当前阶段优先保持静态站形态:
index.html、styles.css、script.js和assets/。 - 如果要做内容数据化,优先用本地
data/projects.js暴露项目数组,不要用fetch("./projects.json"),这样页面仍可直接通过file://打开。
- 避免咖啡色、棕色、米色、沙色、蓝紫渐变和常见 AI 风格渐变。
- 当前视觉基调是墨绿/黑、冷纸白、荧光黄绿、少量红色点睛。新增样式时应沿用这些 CSS 变量。
- 卡片圆角保持克制,默认不超过 8px;不要把页面 section 做成一层套一层的卡片。
- Logo 处理:
- 页头和页脚使用
assets/f0rce-mark-badge.png,配合.brand-token深色徽章样式。 - 不要把白底 Logo 直接放在深色页头上。
- 第一屏主视觉继续使用
assets/f0rce-logo-dark.png。
- 页头和页脚使用
- 保持项目预览图或视觉占位清晰可见。不要用模糊、暗到看不清、纯氛围的图片替代项目展示。
项目卡片至少包含:
- 项目名称
- 项目类型标签,例如
网页应用、AI 工作流、开源 - 一句话简介
- 技术标签
- 至少一个链接:
访问、GitHub、文档或案例记录 - 预览图或明确的视觉占位
替换示例项目时,不要保留假的 # 链接。没有链接就隐藏对应入口,而不是让用户点到空链接。
新增真实项目截图时:
- 放到
assets/projects/ - 推荐宽高比:16:10 或 4:3
- 文件名使用小写英文和连字符,例如
signal-desk-cover.webp - 图片要能说明项目长什么样,不要只放抽象背景
每次维护前:
- 先读
AGENTS.md。 - 快速查看
index.html、styles.css、script.js和assets/。 - 明确用户这次是要改内容、改视觉、改交互,还是要重构维护方式。
改动时:
- 只改和任务有关的文件,不顺手重构无关部分。
- 保持中文默认,不要把页面文案改回英文。
- 不要引入框架或构建工具,除非用户明确要求。
- 不要添加后台、CMS、数据库、登录、上传系统,除非用户明确进入这一阶段。
- 对项目列表的较大改动,优先考虑抽成
data/projects.js再渲染,但要保持file://可用。
完成前必须验证:
node --check script.js如果改了视觉或布局,还要用浏览器或 Playwright 截图检查:
- 桌面视口
- 手机视口
- 首屏
- 项目区
- 页脚
检查重点:
- 中文没有溢出、重叠或被遮挡
- 导航和按钮在手机上能正常换行/横向滚动
- Logo 没有白底贴片感
- 项目筛选按钮仍能工作
- 颜色没有滑回咖啡色、棕色、米色、蓝紫渐变
优先级从低成本到高复杂度:
- 把项目卡片抽到
data/projects.js,由script.js渲染。 - 增加
README.md,写给团队成员看,说明怎么替换项目和截图。 - 增加项目截图目录和真实项目数据。
- 如果非技术成员频繁维护,再接 Notion、Airtable、Google Sheet、Decap CMS 或 GitHub Issues 作为内容源。
- 最后才考虑自研管理面板。
除非用户明确要求,现在不要跳到第 4 或第 5 步。