Imported from GuiXiaoOfficial/personal-website (AGENTS.md). Install upstream with npx skills add GuiXiaoOfficial/personal-website. Copyright stays with the author.

AGENTS.md — 项目规则与协议

本文件供开发助手（AI Agent）和协作者阅读，规定本项目的技术栈、规则与禁止事项。

1. 项目概述

个人技术作品集与个人主页（第一版）：昵称「鬼骁」，南京信息工程大学网络工程本科生。网站用于展示个人介绍、项目、摄影、技术随笔、Windows 软件推荐与新设备配置指南，并提供 GitHub、B 站、邮箱入口。纯静态多页站点，无后端。

2. 技术栈

• HTML5
• CSS3（原生 CSS，使用 CSS 变量管理配色）
• JavaScript（原生 ES，无框架、无构建工具）
• 无 Node.js / npm / 打包器依赖
• 无后端、无数据库、无第三方框架库

3. 项目结构（6 个页面）

personal website/
├── index.html          # 首页
├── about.html          # 关于我
├── projects.html       # 项目展示
├── photography.html    # 摄影
├── notes.html          # 技术随笔
├── toolbox.html        # 工具与指南
├── assets/
│   ├── css/style.css   # 公共样式（基于现有 style.css 扩展）
│   ├── js/main.js      # 公共脚本（导航、交互）
│   └── images/         # 头像、摄影作品、项目截图
├── REQUIREMENTS.md
├── CONTENT_CHECKLIST.md
├── DEVELOPMENT_PLAN.md
├── TASKS.md
└── AGENTS.md

第一版明确为 6 个主要页面，不设独立联系页，不设友情链接页。

导航结构（6 项）：首页 · 关于我 · 项目 · 摄影 · 技术随笔 · 工具与指南

联系方式放置位置（不设独立页面）：首页 CTA、关于我页、公共页脚。

4. 视觉规范（已确认的最终方案）

风格：黑灰背景 + 青蓝强调色的混合方案，深色、克制、技术感、摄影友好。

设计约束：

• 禁止霓虹堆叠、粒子背景和复杂动画。
• 圆角卡片（12~16px）、柔和低对比阴影。
• 摄影区域使用近纯色背景隔离视觉干扰，图片为主、文案极少。
• 文字对比度满足基本可读性，焦点样式清晰（无障碍）。
• 页面层级清楚，首页不堆积过多内容。

5. 核心规则

1. 页面：第一版共 6 个静态页面，多页模式（每页一个独立 HTML 文件）。
2. 公共元素：所有页面共享同一套顶部导航栏和底部页脚；导航需标记当前页高亮。
3. 样式：统一使用 assets/css/style.css；配色使用 CSS 变量（见第 4 节）；遵循 REQUIREMENTS.md 视觉方向。
4. 脚本：交互逻辑（汉堡菜单、随笔展开等）放在公共脚本中，页面通过 id 或 class 定位元素。
5. 内容来源：页面文字、图片、链接以 CONTENT_CHECKLIST.md 和用户确认的内容为准。
6. 图片：统一放入 assets/images/；头像为正方形；摄影作品横图优先（16:9 或 3:2），开发前压缩（建议 WebP，单张 <500KB）。
7. 响应式：三档断点 —— 桌面（≥1024px）、平板（768~1024px）、手机（<768px）；最低适配宽度 360px；手机端使用汉堡菜单。
8. SEO：每个页面必须有 <title> 和 <meta name="description">。
9. 联系方式：第一版只公开主邮箱 defuddled@outlook.com（mailto 引导）；备用邮箱 guixiaoofficial@gmail.com 不公开；GitHub 与 B 站链接为唯一社交外链；知乎 / X / 洛谷标记"待补充"，不得编造 URL。
10. 注释：HTML/CSS/JS 中的注释使用简体中文。

6. 文案与状态表述规范

1. 克制表述：不得使用"精通""熟练掌握"等夸大词汇。允许"学习中 / 训练中 / 探索中 / 构思中 / 尝试中 / 关注中 / 接触过"。
2. 个人网站项目：状态=正在开发。页面描述统一使用"第一版计划包含"，不得写成"当前包含 6 个页面"。
3. 实时 Live2D 智能角色项目：状态=构思中。全部表述用"构想 / 可能使用 / 计划 / 路线图"，不得出现"已完成""已实现""已上线"类措辞。
4. 未实现的功能不得描述为已实现（如账号注册、登录、评论、下载管理等）。

7. 合规约束

• 所有安装、激活、配置指南必须基于合法、官方的软件获取方式。
• 不得提供破解、绕过授权或盗版激活内容。
• 软件链接必须为官方 HTTPS 来源。
• 未提供的社交链接一律标记"待补充"，不得编造 URL。

8. 交互约束

• 不使用复杂动画、视差滚动、loading 动画。
• 不使用霓虹堆叠、粒子背景。
• 不使用 Live2D、AI 对话、评论系统（第一版网站本身）。
• 不引入第三方 JS 库（jQuery、Vue、React 等均不允许）。
• 图标优先使用内联 SVG 或 Unicode 字符，不引入图标库依赖。

9. 禁止事项

• ❌ 不创建后端服务、不连接数据库、不引入登录注册。
• ❌ 不安装 npm 依赖、不使用构建工具。
• ❌ 不修改现有 cline-test.txt（测试文件，保持原样）。
• ❌ 未经用户确认，不执行 git add / git commit / git push。
• ❌ 不引入外链字体、CDN 依赖（除非用户明确同意）。
• ❌ 不创建独立联系页 / 友情链接页（第一版为 6 页结构）。
• ❌ 不在第一版加入暗色模式切换（第一版本身即深色）。
• ❌ 不编造任何未提供的链接、截图或用户经历。

10. 文档优先级

以下文档共同约束本项目：

当文档之间存在冲突时，以 REQUIREMENTS.md 为准；涉及用户明确的主动决定时，以用户最新指示为准。

11. 开发流程约定

1. 开发前先确认 CONTENT_CHECKLIST.md 素材状态（里程碑一只需必备项）。
2. 按 DEVELOPMENT_PLAN.md 的里程碑顺序推进，先里程碑一（可上线骨架），再里程碑二（内容完善）。
3. 每项任务应能在一次独立 Agent 任务中完成，完成后更新 TASKS.md 勾选状态。
4. 交付前验证：所有页面可打开、无死链、无控制台报错、360px 以上响应式正常。