PLANS.md

SCSWiki 首轮构建计划

本文件用于追踪 CODEX_BOOTSTRAP.md 中定义的首轮 MVP 构建任务。每完成一个阶段后更新对应复选框。

前置要求

• 检查当前仓库内容，不删除已有有效文件
• 创建 PLANS.md
• 创建 AGENTS.md

阶段 A：仓库基础

• 初始化 pnpm、TypeScript、VitePress
• 建立基础目录结构
• 配置基础脚本
• 安装依赖并生成锁文件
• 确认可执行生产构建

阶段 B：网站和信息架构

• 实现首页、导航、侧边栏
• 启用 VitePress 本地搜索并本地化文案
• 支持浅色和深色主题
• 创建 404 页面
• 创建分类索引和首批内容页面

阶段 C：可信度系统

• 定义 Front Matter Schema
• 实现内容验证脚本
• 实现内容元数据展示组件
• 实现过期、经验、草稿、待核验、归档提示
• 添加对应单元测试

阶段 D：质量检查和 CI

• 配置 Prettier
• 配置 Markdown lint
• 配置 TypeScript 类型检查
• 实现内部链接检查
• 串联 pnpm check
• 创建 GitHub Actions CI

阶段 E：协作和部署

• 创建 Issue Forms
• 创建 PR 模板
• 创建 CODEOWNERS 模板
• 完成 README、CONTRIBUTING、CONTENT_GUIDE、SECURITY 等治理文档
• 创建 GitHub Pages 部署 workflow
• 写明需要管理员手动配置的 GitHub 设置

阶段 F：最终自查

• 查看 git diff
• 检查是否有虚构学校特定信息
• 检查是否有秘密、个人信息或不应提交的绝对路径
• 运行 pnpm check
• 运行 pnpm build
• 核对 README 命令和实际脚本
• 更新本计划
• 输出最终总结