新手编程建站项目全维度维护手册（AI永久复用版·完整终极模板）

新手编程/建站项目全维度维护手册（AI永久复用版·完整终极模板）

规范MDv1.0

# 新手编程/建站项目全维度维护手册（AI永久复用版·完整终极模板）

核心定位（专为新手+长期AI维护设计）

解决新手最大痛点：隔几天就忘代码逻辑、改坏原有功能、找不到修改位置、换AI窗口无法接续项目、迭代无依据、报错无存档、项目交接/复盘无资料。本模板记录项目所有底层信息、修改轨迹、报错方案、AI生成规则、环境配置，任意时间新开AI窗口，直接粘贴本文档，AI即可100%接续项目开发与维护。

一、项目基础固定信息（永久不变，首次搭建必填）

作用：新开AI窗口优先读取，让AI快速认识项目整体架构，不用重复解释项目基础情况

项目基础字段	详细填写内容
项目名称
项目类型	例：静态网站/前端可视化页面/小程序/桌面软件/后台管理系统
核心技术栈	例：HTML+CSS+JS / Vue3 / Python / PHP / 原生开发
运行环境	例：本地浏览器/Windows系统/Linux服务器/虚拟环境
项目核心功能概述	简单写清项目是做什么的、核心用途、目标效果，方便AI全局认知
项目文件结构	例：index.html（主页面）/css/style.css（样式文件）/js/main.js（功能文件）
禁止修改区域	记录项目底层固定代码、核心架构、不能改动的代码段，防止AI改错底层逻辑

作用：后续所有AI生成代码、修改代码，均遵循此规则，不用每次重复叮嘱AI，统一代码风格和开发标准

适用场景：所有AI生成代码、功能新增、bug修复、样式调整、逻辑修改、版本迭代，全部记录，AI可直接读取复盘

序号	迭代版本	修改模块/页面	迭代前问题/旧效果	本次迭代目标	AI完整提示词（Prompt）	具体修改内容	精准代码位置	测试结果	当前状态	AI复用/迭代备注
1	V1.0 初始版本	例：网站首页	无初始功能/页面空白/样式缺失	搭建首页基础结构、完善基础样式	粘贴本次完整AI指令（核心！后续可直接复用生成同款代码）	AI搭建页面骨架、编写基础CSS样式、新增核心展示模块	index.html 全部结构、style.css 全局样式	本地测试正常，无报错	已上线生效	后续修改样式无需重构骨架，仅微调CSS即可
2	V1.1 迭代优化								AI生成中/测试中/已生效/待优化
3	V1.2 迭代优化								AI生成中/测试中/已生效/待优化

核心作用：重复报错不用重复问AI，存档后AI可直接匹配历史解决方案，秒修复同类问题

报错时间	报错场景	完整报错信息	报错原因分析	AI给出的解决方案	修复状态	预防备注
	例：页面打开空白/按钮点击无反应/代码控制台报错	粘贴完整报错文字、截图文字信息	例：代码语法错误、路径错误、函数未定义	记录完整修复步骤、修改的代码段	已修复/临时修复/未解决	后续编写此类功能需规避该问题

适用场景：改文字、调颜色、微调间距等无需详细迭代的小修改

序号	日期	修改位置	微调内容	效果结果	简易备注
1

新开AI窗口继续维护本项目，直接复制以下话术，AI可无缝接续：

你现在需要接续维护我的项目，先通读以上【项目基础信息+迭代记录+报错存档】，严格遵循全局开发规则。所有修改只优化指定模块、保留全部原有正常功能、不新增无关内容。修改完成后，标注精准修改位置、修改逻辑，并同步更新迭代记录。

（注：部分内容可能由 AI 生成）