背景
当前仓库只有营销落地页(Hero/Features/Workflow 等展示组件),评审无法实际体验产品功能。初赛参赛指南要求 Demo 必须是"可交互、可体验"的,需要把 PRD 中描述的核心功能落地为真实可用的页面。
目标
将 KnowledgeFlow 从展示型落地页升级为功能型学习平台,让评审无需 API Key 即可体验完整学习流程。
改动范围
新增功能页面(5 个)
/#/study 智能学习:AI 知识点讲解(七步结构),流式输出,多轮对话
/#/plans 学习计划:AI 生成知识路线,按知识点维度组织
/#/practice 练习测试:AI 出题 + 即时批改
/#/resources 资源管理:文件上传 + 可读化处理
/#/settings 设置:API Key 配置(演示/OpenAI/DeepSeek/自定义)
新增基础设施
src/lib/ai.ts — OpenAI 兼容流式 API 客户端
src/lib/prompts.ts — 系统提示词(派生自 docs/agent-prompts/AGENTS.md)
src/lib/markdown.ts — Markdown 渲染器
src/lib/demo.ts — 演示模式预置回复
src/store/settingsStore.ts — API 配置(zustand + localStorage)
src/store/studyStore.ts — 学习记录(zustand + localStorage)
路由与导航
- HashRouter(GitHub Pages 静态托管兼容)
- AppNav / AppLayout 共享布局
- Nav / CTA 链接更新到功能页
Harness 文档更新
- AGENTS.md / CLAUDE.md:新增 Agent Authority(自主模式)章节
- docs/workflow.md:新增 Agent Authority 与 Review And Merge 更新
验证
- TypeScript 编译通过
- Vite 构建成功
- 演示模式可体验"递归/HTTP 协议/光合作用"完整讲解
背景
当前仓库只有营销落地页(Hero/Features/Workflow 等展示组件),评审无法实际体验产品功能。初赛参赛指南要求 Demo 必须是"可交互、可体验"的,需要把 PRD 中描述的核心功能落地为真实可用的页面。
目标
将 KnowledgeFlow 从展示型落地页升级为功能型学习平台,让评审无需 API Key 即可体验完整学习流程。
改动范围
新增功能页面(5 个)
/#/study智能学习:AI 知识点讲解(七步结构),流式输出,多轮对话/#/plans学习计划:AI 生成知识路线,按知识点维度组织/#/practice练习测试:AI 出题 + 即时批改/#/resources资源管理:文件上传 + 可读化处理/#/settings设置:API Key 配置(演示/OpenAI/DeepSeek/自定义)新增基础设施
src/lib/ai.ts— OpenAI 兼容流式 API 客户端src/lib/prompts.ts— 系统提示词(派生自 docs/agent-prompts/AGENTS.md)src/lib/markdown.ts— Markdown 渲染器src/lib/demo.ts— 演示模式预置回复src/store/settingsStore.ts— API 配置(zustand + localStorage)src/store/studyStore.ts— 学习记录(zustand + localStorage)路由与导航
Harness 文档更新
验证