Skip to content

Latest commit

 

History

History
92 lines (66 loc) · 3.89 KB

File metadata and controls

92 lines (66 loc) · 3.89 KB

F0RCE 网站维护协议

这个仓库是 F0RCE 团队首页。维护目标是让它作为一个 agent-first 的静态作品集网站长期可改、可验、可替换内容,而不是过早变成需要后台、账号、数据库和上传系统的小产品。

维护原则

  • 默认语言是中文。导航、按钮、标题、说明、辅助标签、meta description 都应优先使用中文;GitHub、AI、CLI、Next.js 这类技术名词可以保留英文。
  • 这个站优先展示项目和团队气质,不做营销式落地页。第一屏要有记忆点,项目区要易浏览。
  • 不要新建管理面板,除非用户明确要求并说明需要账号、权限、草稿、审核或高频非技术维护。
  • 当前阶段优先保持静态站形态:index.htmlstyles.cssscript.jsassets/
  • 如果要做内容数据化,优先用本地 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
  • 图片要能说明项目长什么样,不要只放抽象背景

Agent 工作流

每次维护前:

  1. 先读 AGENTS.md
  2. 快速查看 index.htmlstyles.cssscript.jsassets/
  3. 明确用户这次是要改内容、改视觉、改交互,还是要重构维护方式。

改动时:

  • 只改和任务有关的文件,不顺手重构无关部分。
  • 保持中文默认,不要把页面文案改回英文。
  • 不要引入框架或构建工具,除非用户明确要求。
  • 不要添加后台、CMS、数据库、登录、上传系统,除非用户明确进入这一阶段。
  • 对项目列表的较大改动,优先考虑抽成 data/projects.js 再渲染,但要保持 file:// 可用。

完成前必须验证:

node --check script.js

如果改了视觉或布局,还要用浏览器或 Playwright 截图检查:

  • 桌面视口
  • 手机视口
  • 首屏
  • 项目区
  • 页脚

检查重点:

  • 中文没有溢出、重叠或被遮挡
  • 导航和按钮在手机上能正常换行/横向滚动
  • Logo 没有白底贴片感
  • 项目筛选按钮仍能工作
  • 颜色没有滑回咖啡色、棕色、米色、蓝紫渐变

未来升级路线

优先级从低成本到高复杂度:

  1. 把项目卡片抽到 data/projects.js,由 script.js 渲染。
  2. 增加 README.md,写给团队成员看,说明怎么替换项目和截图。
  3. 增加项目截图目录和真实项目数据。
  4. 如果非技术成员频繁维护,再接 Notion、Airtable、Google Sheet、Decap CMS 或 GitHub Issues 作为内容源。
  5. 最后才考虑自研管理面板。

除非用户明确要求,现在不要跳到第 4 或第 5 步。