Skip to content

feat: 将落地页升级为可体验的功能学习平台 #1

Description

@ceilf6

背景

当前仓库只有营销落地页(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 协议/光合作用"完整讲解

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions