这是千秋的个人主页与写作空间，使用 Astro 构建。网站以「墨光书房」为视觉契约——界画四原则（统一纸底、左上光源、边缘墨化、墨分五色）、朱砂印章与书体题字，组织项目、技术实践、阅读随笔、游戏观察与仍在成形的想法，并支持响应式布局和昼宣/夜墨双主题。
- 持续场景式个人房间：首页以 4K 2.5D 排练室容纳写作、工程与生活，点击物件会在同一空间里自然推近并把真实内容落入显示器或工作台。
- 昼宣 · 夜墨双主题：同一构图的两种光——夜墨灯下读、昼宣纸上读，切换时以墨晕收拢转场，并记住用户选择、消除加载闪烁（FOUC）。
- 界画视觉系统：墨分五色承担层级、朱砂印章落款、书体题字签名、「显影」入场动效与乌丝栏卷轴排版贯穿全站。
- 动态博客系统：基于 Astro 6.0 Content Collections 构建，支持 Markdown 编写并自动生成 SEO Meta 头和站点地图。
- 长文动态目录：博客文章页支持滚动联动目录，并针对中文长文、代码块、表格和图片优化阅读体验。
- 真实内容驱动：房间内直接读取最新文章和重点项目，场景入口、无 JavaScript hash 落点与既有内容路由互相衔接。
- 性能优化：使用 Astro 原生图像优化（
astro:assets）、书体子集（11KB）和极低的 CSS 与 JS 体积，秒级加载。
本项目使用 Astro 构建，本地运行非常简单：
项目要求 Node.js 22（最低 22.12.0），并通过根目录的 mise.toml 固定为 22.23.1。推荐安装
mise 后在仓库目录运行：
mise install
node --versionmise 会按项目切换 Node 版本，不会覆盖其他项目各自声明的版本。也可以自行安装符合要求的 Node.js 22。
- 克隆本仓库到本地：
git clone https://github.com/qianqiulp/qianqiulp.github.io.git cd qianqiulp.github.io - 安装项目依赖：
npm install
-
本地预览开发服务器：
npm run dev
启动后，在浏览器访问
http://localhost:4321即可预览站点，修改文件后浏览器将实时热更新（HMR）。 -
项目打包构建：
npm run build
该命令会验证 TypeScript 和编译所有 Astro 页面，在本地生成打包后的静态文件，存放在
dist目录中。 -
预览打包后站点：
npm run preview
- 站点维护说明：本地启动、新增文章、新增项目、字段边界和 Codex UI 改动前置阅读清单。
- 墨光书房设计契约：现行视觉契约——界画四原则、昼宣夜墨、色彩/字体/印章/动效边界与防漂移清单。
- 人本房间与编辑工作台设计契约（已废止，留档）：房间叙事与内容边界的原始决策。
- 场景资产提示词：首页房间场景图的再生成提示词与过审清单。
- Visual QA Checklist：UI 改动后的手动检查项，覆盖设计系统、首页、博客、文章页、项目页、双主题、移动端、键盘焦点和图片稳定性。
qianqiulp.github.io/
├── .github/
│ ├── ISSUE_TEMPLATE/ # GitHub 反馈模板 (Bug, Feature)
│ ├── PULL_REQUEST_TEMPLATE.md # GitHub PR 预填模板
│ └── workflows/ # GitHub Actions CI 自动化部署工作流
├── src/
│ ├── assets/ # 博客封面及插图等静态媒体资产
│ ├── components/ # 公共 Astro 页面组件
│ ├── content/ # Markdown 技术博客文章源文件
│ │ └── posts/ # 博客 markdown 文件
│ ├── layouts/ # 站点整体页面布局架构
│ ├── pages/ # 站点路由页面 (index.astro, projects.astro)
│ └── styles/ # 站点全局及局部公共样式
├── public/ # 存放在站点的全局非编译资产 (favicon 等)
├── astro.config.mjs # Astro 项目配置文件
├── CONTRIBUTING.md # 贡献者协作指引手册
├── CHANGELOG.md # Keep a Changelog 标准更新历史
├── LICENSE # MIT 开源许可证协议
└── package.json # 项目依赖及运行指令配置
如果你想为我提供建议、发现 Bug 或者想提交代码：
- 请先阅读我们的 CONTRIBUTING.md 以了解我们的开发准则和提交流程。
- 欢迎通过 Issue 与我沟通！
本项目基于 MIT 许可证开源，任何人均可自由地获取、修改和使用本仓库的代码，但须保留版权声明与免责声明。