Skip to content

Pointer-ai/PointerAIVibe

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

85 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📚 Pointer.ai - AI驱动的个性化编程学习平台

零后端 · React 19 · AI Native · 多Profile管理
智能化编程教育平台,提供个性化学习路径和AI助手指导

Demo Build Status License

🎯 项目愿景

Pointer.ai 致力于打造下一代AI驱动的编程教育平台。通过深度整合AI技术与教育场景,为每位学习者提供:

  • 🧠 智能能力评估 - AI分析简历/问卷,精准评估技能水平
  • 🎯 个性化目标设定 - 基于能力现状的智能目标推荐
  • 🛤️ 定制学习路径 - AI生成的个性化学习计划
  • 🤖 真实LLM Function Calling - ✅ 完整的大语言模型工具调用系统,支持22个AI工具
  • 📊 可视化路径管理 - 直观的学习目标和路径管理界面
  • 🔍 数据透明化 - 完整的数据检查器,验证AI工具调用
  • 💻 多语言代码环境 - 支持Python、JavaScript、C++在线运行
  • 👥 多Profile管理 - 支持多用户档案,数据完全隔离

🚀 快速开始

安装与运行

# 克隆项目
git clone https://github.com/pointer-ai/PointerAIVibe.git
cd PointerAIVibe

# 安装依赖
npm install
# 或者使用 pnpm(推荐)
pnpm install

# 启动开发环境
npm run dev
# 或者使用 pnpm(推荐)
pnpm dev

# 访问应用
open http://localhost:5173

🔥 开发工作流建议

💡 最佳实践

  • 保持开发服务器运行 - 启动 pnpm dev 后保持运行状态,会自动监听文件变化并热重载
  • 直接访问 5173 端口 - 开发服务器运行期间,直接访问 http://localhost:5173 验证功能
  • 无需重复启动 - 除非服务器崩溃或主动停止,否则无需重新启动

开发者工作流

# 1. 首次启动
pnpm dev

# 2. 保持终端运行,在浏览器中开发和测试
# http://localhost:5173

# 3. 代码修改会自动热重载,无需手动刷新

# 4. 只有在以下情况才需要重启:
#    - 修改了 vite.config.ts
#    - 添加了新的环境变量
#    - 服务器出现错误崩溃

体验完整功能

  1. 🎨 响应式Landing Page - 支持移动端触摸滑动,键盘导航,联系方式角标
  2. 创建用户档案 - 设置你的学习身份
  3. 配置API密钥 - 在Profile设置中配置OpenAI/Claude/通义千问API
  4. 完成能力评估 - 上传简历或完成技能问卷
  5. 体验真实AI对话 - 进入"AI智能对话"开始智能交互
  6. 测试Function Calling - 在"AI系统演示"中体验所有AI工具
  7. 🆕 管理学习路径 - 在"学习路径管理"中可视化管理目标和路径
  8. 🆕 验证数据存储 - 在"数据检查器"中查看AI工具调用结果

🎨 Landing Page 新特性

  • 📱 移动端支持: 完整的触摸滑动支持,手势导航
  • ⌨️ 键盘导航: 使用左右箭头键切换幻灯片
  • 📞 联系方式角标: 右下角浮动按钮,包含创作者信息
  • ✨ 智能暂停: 用户交互时自动暂停轮播,交互结束后自动恢复
  • 🎯 个性化欢迎: 基于登录状态显示不同的行动按钮

联系创作者

📚 详细使用指南

🎯 完整系统指南

详细文档: UNIFIED_LEARNING_SYSTEM_GUIDE.md

包含完整的功能说明、API参考和最佳实践:

  • 🚀 快速开始 - 3步集成和配置指南
  • 🎯 目标管理 - 3个目标激活限制的详细说明
  • 🤖 AI工具系统 - 22个AI工具的完整使用方法
  • 💻 代码环境 - Monaco Editor集成和多语言支持
  • 📊 数据管理 - CoreData架构和Profile管理
  • 🔧 开发扩展 - 添加新功能和自定义组件

📖 快速参考

功能模块 说明 位置
AI智能对话 真实LLM Function Calling Dashboard → "AI智能对话"
目标管理 3个目标激活限制,智能状态管理 Dashboard → "目标设定"
路径管理 可视化学习路径,进度跟踪 Dashboard → "学习路径管理"
能力评估 简历解析,多维度技能分析 Dashboard → "能力评估"
代码环境 Monaco Editor,多语言支持 Dashboard → "代码运行"
系统演示 22个AI工具完整测试 Dashboard → "AI系统演示"

🔧 核心功能模块

📊 智能能力评估系统

  • PDF简历解析 - 自动提取技能信息
  • 多维度评估 - 5大维度30+细分技能
  • 置信度标注 - 区分直接证据与推理结果
  • 可视化报告 - 雷达图展示,支持导出

🤖 AI学习助手系统 ✅ 完全修复

  • ✅ 真实LLM Function Calling - 支持OpenAI GPT-4、Claude 3.5、通义千问
  • ✅ 智能工具调度 - AI自动选择和执行最合适的工具
  • ✅ 22个完整AI工具 - 涵盖学习管理的完整生命周期
  • ✅ 参数智能生成 - AI自动生成正确的工具调用参数
  • ✅ 多工具组合 - 一次对话可调用多个工具获取完整信息
  • ✅ 上下文感知 - 基于用户完整学习档案的个性化建议
  • ✅ 错误处理完善 - 多层次回退机制,确保稳定使用

🔧 Function Calling修复详情

  • Schema验证问题修复 - 完整支持OpenAI strict schema要求
  • Array参数支持 - 正确处理所有数组类型参数的items属性
  • 多模型兼容 - 统一的工具定义转换为不同AI模型的特定格式
  • 实时工具执行 - 工具调用结果实时反馈到AI对话中

🎯 学习路径管理系统 ⭐新功能

位置: Dashboard → "学习路径管理" 卡片

可视化的学习目标和路径管理界面:

核心功能

  • 📋 目标管理: 创建、暂停、恢复、完成学习目标
  • 🛤️ 路径管理: 生成、激活、冻结、归档学习路径
  • 📊 进度跟踪: 实时显示学习节点完成状态
  • 🔄 智能流程控制: 自动化的状态转换和依赖管理

使用流程

  1. 创建目标: 点击"➕ 新建目标"
  2. 生成路径: 选择目标后点击"🛤️ 生成路径"
  3. 管理状态: 使用操作按钮控制目标和路径状态
  4. 查看进度: 观察进度条和完成统计

智能流程控制

  • 🔒 路径冻结: 重新生成路径时,旧路径自动冻结
  • 状态同步: 目标暂停时,相关路径同步暂停
  • 🔄 灵活切换: 支持激活冻结路径或创建新路径

🎯 目标设定页面 ⭐新功能

位置: Dashboard → "目标设定" 卡片

专门的目标管理界面,提供完整的目标生命周期管理:

核心功能

  • 📝 智能表单: 完整的目标创建和编辑表单
  • 📊 状态统计: 实时显示目标状态分布和激活限制
  • 🔄 状态管理: 一键激活、暂停、完成、取消目标
  • 🏷️ 属性丰富: 类别、级别、优先级、技能、成果等详细配置
  • ⚡ 实时反馈: 操作结果即时提示和数据同步

使用流程

  1. 新建目标: 点击"新建目标"打开智能表单
  2. 填写信息: 设置标题、描述、类别、级别等基本信息
  3. 配置技能: 动态添加需要掌握的技能列表
  4. 设定成果: 明确预期的学习成果和目标
  5. 状态管理: 使用右侧操作按钮管理目标状态

智能特性

  • 🎯 激活限制: 最多同时激活3个目标,保持学习专注
  • 📈 智能推荐: 根据能力评估推荐合适的目标级别
  • 🔄 状态同步: 目标状态变化自动同步到相关学习路径
  • 💡 操作指导: 清晰的使用说明和状态管理指南

🏗️ Learning System统一架构 ⭐重大升级

整合: 能力评估 + 目标设定 + 路径规划 + 课程内容的统一管理系统

架构特性

  • 🔄 统一数据流: 所有子环节通过LearningSystemService协调管理
  • 📊 实时状态同步: 任何模块变化都会立即同步到相关模块
  • 🧠 智能决策: 系统自动分析用户所处的学习阶段并提供建议
  • 🎯 模块间协调: 目标状态变化自动影响路径和课程内容

核心组件

用户交互层 (UI Components)
    ↓
Learning System协调层 (LearningSystemService)
    ↓
专业模块层 (GoalSetting, PathPlan, CourseContent)
    ↓
核心数据层 (CoreData Service)
    ↓
数据存储层 (localStorage)

智能管理功能

  • 阶段感知: 系统知道用户处于评估、目标设定、学习还是回顾阶段
  • 个性化建议: 基于完整学习档案的智能操作建议
  • 状态诊断: 主动识别需要完善的环节并提供解决方案
  • 进度追踪: 跨模块的学习进度统一追踪和可视化

🧠 能力评估系统集成 ⭐新完成

完全集成: 能力评估现已完全融入Learning System统一架构

集成特性

  • 🏗️ 统一架构: 与其他模块使用相同的服务层架构模式
  • 📊 状态同步: 评估完成自动触发系统状态更新和阶段转换
  • 🎯 智能引导: 评估完成后提供明确的下一步操作建议
  • 🔄 事件集成: 完整的评估生命周期事件记录和追踪

核心服务

export class AbilityAssessmentService {
  // 执行评估 (通过Learning System)
  async executeAssessment(input: AssessmentInput): Promise<AbilityAssessment>
  
  // 获取能力概述 (统一接口)
  getAbilitySummary()
  
  // 更新评估结果 (状态同步)
  async updateAssessment(updates: Partial<AbilityAssessment>)
  
  // 生成提升计划 (AI集成)
  async generateImprovementPlan()
}

用户体验提升

  • 📈 系统状态显示: 评估页面显示完整的Learning System状态
  • 🎯 智能跳转: 评估完成后一键跳转到目标设定和路径管理
  • 🔄 实时反馈: 评估变化立即反映到整个系统状态
  • 💡 个性化建议: 基于评估结果的针对性下一步操作建议

🔍 数据检查器 ⭐新功能

  • 实时数据监控 - 查看localStorage中的完整数据
  • AI工具验证 - 确认工具调用是否真实生效
  • 数据结构展示 - JSON格式展示所有学习数据
  • 统计信息 - 目标、路径、课程单元数量统计
  • 导出功能 - 一键复制数据到剪贴板

💻 代码运行环境

  • Monaco Editor - VS Code级别的编程体验
  • 多语言支持 - Python(Pyodide) + JavaScript + C++(Wandbox)
  • 智能补全 - 语法高亮、代码片段、错误检测
  • 一键运行 - 前端直接执行,无需服务器

👥 Profile管理系统

  • 多用户支持 - 独立的学习档案和数据存储
  • 密码保护 - 可选的档案加密功能
  • API密钥管理 - 安全的AI服务配置
  • 数据隔离 - 完全独立的学习数据和AI历史
  • 无缝切换 - 一键切换不同学习身份

🎮 AI学习系统使用指南

🔍 AI系统演示 ✅ 完全可用

位置: Dashboard → "AI系统演示" 卡片

体验所有AI功能的测试界面:

  • 🔥 真实LLM Function Calling测试 - ✅ 使用真实大语言模型的完整工具调用体验
  • 🤖 AI智能对话 (真实LLM) - ✅ 个性化学习指导,智能工具自动调度
  • 🧪 自动化测试套件 - ✅ 一键测试5个典型场景,验证系统稳定性
  • 🔧 完整CRUD操作演示 - ✅ 22个AI工具的完整演示和测试
  • 📊 能力评估集成演示 - ✅ 测试能力评估数据与AI系统的完整集成
  • 📚 完整学习流程演示 - ✅ 一键体验从能力评估到课程生成的完整流程

🔑 API密钥集成特性 ✅ 完全支持

  • ✅ 多模型支持: OpenAI GPT-4、Claude 3.5 Sonnet、阿里通义千问
  • ✅ 智能检测: 自动检测API配置状态和可用性
  • ✅ 真实LLM调用: 配置API密钥后使用真实大语言模型进行智能分析
  • ✅ Schema验证: 完整支持OpenAI Function Calling的strict schema要求
  • ✅ 错误处理: API调用失败时提供详细错误信息和解决建议
  • ✅ 状态显示: 清晰显示当前使用的AI模型和调用状态

🛠️ 完整AI工具系统 (22个工具) ✅ 全部可用

学习目标CRUD (5个) ✅:

  • get_learning_goals - 获取学习目标列表
  • get_learning_goal - 获取单个学习目标详情
  • create_learning_goal - 创建新的学习目标
  • update_learning_goal - 更新学习目标属性
  • delete_learning_goal - 删除学习目标

学习路径CRUD (5个) ✅:

  • get_learning_paths - 获取学习路径列表
  • get_learning_path - 获取单个学习路径详情
  • create_learning_path - 创建个性化学习路径
  • update_learning_path - 更新学习路径内容
  • delete_learning_path - 删除学习路径

课程内容CRUD (5个) ✅:

  • get_course_units - 获取课程单元列表
  • get_course_unit - 获取单个课程单元详情
  • create_course_unit - 创建课程教学内容
  • update_course_unit - 更新课程内容
  • delete_course_unit - 删除课程单元

智能分析工具 (7个) ✅:

  • analyze_user_ability - 分析用户能力水平
  • get_learning_context - 获取完整学习上下文
  • get_learning_summary - 生成详细学习报告
  • calculate_skill_gap - 计算技能差距分析
  • generate_path_nodes - 智能生成学习路径节点
  • suggest_next_action - 基于状态建议下一步行动
  • track_learning_progress - 跟踪学习进度统计

学习管理工具 (5个) ✅:

  • adjust_learning_pace - 智能调整学习节奏
  • handle_learning_difficulty - 处理学习困难和阻塞
  • recommend_study_schedule - 推荐个性化学习计划

🎯 学习路径管理 ⭐新功能

位置: Dashboard → "学习路径管理" 卡片

可视化的学习目标和路径管理界面:

核心功能

  • 📋 目标管理: 创建、暂停、恢复、完成学习目标
  • 🛤️ 路径管理: 生成、激活、冻结、归档学习路径
  • 📊 进度跟踪: 实时显示学习节点完成状态
  • 🔄 智能流程控制: 自动化的状态转换和依赖管理

使用流程

  1. 创建目标: 点击"➕ 新建目标"
  2. 生成路径: 选择目标后点击"🛤️ 生成路径"
  3. 管理状态: 使用操作按钮控制目标和路径状态
  4. 查看进度: 观察进度条和完成统计

智能流程控制

  • 🔒 路径冻结: 重新生成路径时,旧路径自动冻结
  • 状态同步: 目标暂停时,相关路径同步暂停
  • 🔄 灵活切换: 支持激活冻结路径或创建新路径

🎯 目标设定页面 ⭐新功能

位置: Dashboard → "目标设定" 卡片

专门的目标管理界面,提供完整的目标生命周期管理:

核心功能

  • 📝 智能表单: 完整的目标创建和编辑表单
  • 📊 状态统计: 实时显示目标状态分布和激活限制
  • 🔄 状态管理: 一键激活、暂停、完成、取消目标
  • 🏷️ 属性丰富: 类别、级别、优先级、技能、成果等详细配置
  • ⚡ 实时反馈: 操作结果即时提示和数据同步

使用流程

  1. 新建目标: 点击"新建目标"打开智能表单
  2. 填写信息: 设置标题、描述、类别、级别等基本信息
  3. 配置技能: 动态添加需要掌握的技能列表
  4. 设定成果: 明确预期的学习成果和目标
  5. 状态管理: 使用右侧操作按钮管理目标状态

智能特性

  • 🎯 激活限制: 最多同时激活3个目标,保持学习专注
  • 📈 智能推荐: 根据能力评估推荐合适的目标级别
  • 🔄 状态同步: 目标状态变化自动同步到相关学习路径
  • 💡 操作指导: 清晰的使用说明和状态管理指南

🔍 数据检查器 ⭐新功能

位置: Dashboard → "数据检查器" 卡片

验证AI工具调用和数据存储的调试界面:

主要功能

  • 📊 实时统计: 显示目标、路径、课程单元数量
  • 🗄️ 数据浏览: 查看完整的JSON数据结构
  • 🔄 即时刷新: 验证AI工具调用后的数据变化
  • 📋 数据导出: 复制JSON数据到剪贴板

验证方法

  1. 执行AI操作: 在AI系统演示中执行任意工具
  2. 切换到检查器: 查看数据是否真实更新
  3. 对比数据: 确认localStorage中的数据变化
  4. 验证一致性: 检查多个界面间的数据同步

💬 AI智能对话 ✅ 真实LLM支持

位置: Dashboard → "AI智能对话" 卡片

与真实大语言模型的智能对话体验:

🔥 核心特性

  • 🤖 真实AI模型: 使用你配置的OpenAI GPT-4、Claude 3.5或通义千问
  • 📚 学习上下文感知: AI完全了解你的能力评估、学习目标、路径等信息
  • 🎯 个性化对话: 基于你的学习状态提供定制化建议和指导
  • 🔧 智能工具调度: 对话中自动识别并调用相关的学习管理工具
  • 💬 连续对话: 支持多轮对话,记住上下文

💡 对话示例

用户: "我想学习前端开发"
AI: [自动调用 create_learning_goal 工具]
回复: "✅ 已为您创建前端开发学习目标!包含React、Vue等技术栈..."

用户: "分析一下我的编程能力"
AI: [自动调用 analyze_user_ability 工具]
回复: "📊 基于您的简历分析:Java能力优秀(90分),前端基础较弱(40分)..."

用户: "我的学习进度如何?"
AI: [自动调用 get_learning_summary, track_learning_progress 工具]
回复: "📈 当前进度:已完成3/10个节点(30%),建议加强..."

🧪 Function Calling测试指南 ✅ 完全升级

🔥 新增专项测试功能

位置: AI系统演示 → "🧪 真实LLM Function Calling测试"

现在提供4种专业测试模式

1. 🧪 基础测试 (5个案例)

验证核心LLM Function Calling功能:

  • 学习目标查询和创建
  • 能力分析和学习报告
  • 学习困难处理和建议
2. 📚 课程内容CRUD (10个专项测试) ⭐ 新增

专门测试5个课程内容管理工具:

# 课程内容查询测试
"显示我现有的所有课程内容单元"
"我想查看理论类型的课程内容"

# 课程内容创建测试  
"为我的前端开发路径创建一个新的课程单元"
"创建一个项目类型的React实战课程单元"
"我需要一个关于算法的理论课程内容"

# 课程内容管理测试
"帮我查看某个具体课程单元的详细内容"
"我想更新一个课程单元的内容"
"更新课程单元的难度和预估时间"
"删除一个不需要的课程单元"
3. 🎯 综合测试 (9个场景) ⭐ 新增

模拟完整学习流程的工具组合调用:

# 完整学习工作流测试
"我想开始学习Python数据分析,请帮我制定完整的学习计划"
"为我刚创建的Python数据分析目标生成详细的学习路径"  
"为学习路径的第一个节点创建具体的课程内容"
"我想看看我的整体学习进度如何"
"我在学习pandas时遇到困难,请帮我处理"
4. 🚀 自定义测试

测试任意自定义消息的智能工具调用

🔧 课程内容工具完整覆盖 ✅

现已集成所有5个课程内容CRUD工具到LLM Agent系统:

工具名称 功能 测试场景
get_course_units 获取课程单元列表 "显示我的课程内容"
get_course_unit 获取单元详情 "查看具体课程单元"
create_course_unit 创建课程内容 "创建新的课程单元"
update_course_unit 更新课程内容 "更新课程难度"
delete_course_unit 删除课程单元 "删除不需要的课程"

📊 智能统计分析 ⭐ 新功能

测试完成后提供详细统计:

  • 成功率统计: 显示测试通过率
  • 工具使用频率: 统计各工具调用次数
  • 工具类型分布: 按目标、路径、课程、分析工具分类
  • 课程工具专项统计: 专门统计课程内容工具的使用情况
  • 平均调用量: 每次对话的平均工具调用数量

快速测试方法

  1. 🔧 配置API密钥:Profile设置 → API配置 → 选择模型并输入API Key
  2. 📚 课程内容测试:AI系统演示 → "📚 课程内容 (10个)" → 专项测试课程CRUD功能
  3. 🎯 综合测试:AI系统演示 → "🎯 综合测试 (9个)" → 测试完整学习工作流
  4. 🔍 验证结果:数据检查器 → 刷新查看数据变化

课程内容测试场景示例 ⭐ 重点

# 场景1: 课程内容查询
"显示我现有的所有课程内容单元"
# 预期: 自动调用 get_course_units 工具

# 场景2: 按类型筛选课程
"我想查看理论类型的课程内容"  
# 预期: 自动调用 get_course_units 工具(带type参数)

# 场景3: 创建课程内容
"为我的JavaScript学习节点生成一个练习类型的课程"
# 预期: 自动调用 create_course_unit 工具

# 场景4: 更新课程属性
"更新课程单元的难度和预估时间"
# 预期: 自动调用 update_course_unit 工具

# 场景5: 删除课程内容
"删除一个不需要的课程单元"
# 预期: 自动调用 delete_course_unit 工具

测试验证要点

  • AI智能选择: 验证AI能根据用户意图自动选择正确的课程工具
  • 参数生成: 确认AI能为工具生成正确的参数
  • 工具组合: 测试AI在复杂场景下的多工具组合调用能力
  • 错误处理: 验证工具调用失败时的错误处理和回退机制
  • 数据同步: 确认工具执行结果正确保存到数据存储中

🛠️ 技术架构

前端技术栈

  • React 19 - 最新版本,支持并发特性
  • TypeScript - 类型安全的开发体验
  • Vite - 极速的开发构建工具
  • Tailwind CSS - 实用优先的CSS框架
  • Lucide React - 现代图标库

AI集成架构 ✅ 完全支持

  • Function Calling API - 支持OpenAI、Claude、通义千问的原生工具调用
  • 智能工具调度 - AI自动选择和组合最合适的工具
  • Schema验证 - 完整支持OpenAI strict schema要求
  • 多模型适配 - 统一接口适配不同AI服务商的API格式
  • 错误恢复 - 多层次回退机制确保系统稳定性

数据管理

  • LocalStorage - 客户端数据持久化
  • 多Profile隔离 - 独立的用户数据空间
  • 实时同步 - 界面与数据的实时同步更新
  • 数据验证 - 完整的数据结构验证和错误处理

代码执行环境

  • Pyodide - 浏览器中的Python运行时
  • Web Workers - 非阻塞的代码执行
  • Monaco Editor - VS Code级别的编辑体验
  • Wandbox API - C++代码在线编译执行

📈 开发路线图

✅ 已完成功能

  • 基础项目架构搭建
  • Profile管理系统
  • 智能能力评估模块
  • 真实LLM Function Calling系统
  • 22个完整AI工具实现
  • 🆕 目标设定页面 - 完整的可视化目标管理界面
  • 🆕 Learning System统一架构 - 所有子环节(能力评估、目标设定、路径规划、课程内容)统一管理
  • 🆕 能力评估系统集成 - 完全集成到Learning System统一架构中
  • 可视化学习路径管理
  • 数据检查器和验证工具
  • 多语言代码运行环境
  • 错误处理和回退机制

🚧 进行中

  • 学习进度可视化图表
  • 学习资源推荐引擎
  • 个性化难度调整算法

🎯 规划中

  • 学习社区和协作功能
  • 更多编程语言支持(Go、Rust)
  • 移动端适配和PWA支持
  • 学习分析Dashboard

🤝 贡献指南

我们欢迎各种形式的贡献!

参与方式

  1. 🐛 报告Bug - 在Issues中详细描述问题
  2. 💡 功能建议 - 分享你的想法和需求
  3. 📝 文档改进 - 帮助完善文档和示例
  4. 🔧 代码贡献 - 提交PR实现新功能或修复问题

开发环境设置

# Fork 项目到你的账户
git clone https://github.com/your-username/PointerAIVibe.git
cd PointerAIVibe

# 安装依赖
npm install
# 或者使用 pnpm(推荐)
pnpm install

# 启动开发服务器
npm run dev
# 或者使用 pnpm(推荐,支持更好的热重载)
pnpm dev

# 运行测试
npm test

# 构建生产版本
npm run build

⚡ 开发效率提升

  • 保持 pnpm dev 运行 - 自动捕获文件变化,无需手动重启
  • 直接验证 http://localhost:5173 - 修改代码后立即在浏览器中查看效果
  • 热重载支持 - 大部分修改会自动刷新页面,无需手动操作
  • 仅在必要时重启 - 只有配置文件变更或服务器崩溃时才需要重新启动

代码规范

  • 使用TypeScript进行类型安全开发
  • 遵循ESLint和Prettier配置
  • 编写有意义的commit message
  • 为新功能添加相应的测试
  • 在新创建的源代码文件头部添加AGPLv3许可证声明(参考 LICENSE_HEADER.txt

AGPLv3许可证头部模板

在新创建的源代码文件开头添加以下许可证声明:

/*
 * Pointer.ai - AI驱动的个性化编程学习平台
 * Copyright (C) 2024 Pointer.ai
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as published
 * by the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program. If not, see <https://www.gnu.org/licenses/>.
 */

📄 许可证 & 版权保护

🛡️ AGPLv3 强力保护

本项目采用 GNU Affero General Public License v3.0 (AGPLv3) 许可证,这是专门为防止开源项目被商业化滥用而设计的强力copyleft许可证。

🔒 核心保护机制

AGPLv3 相比 MIT 的关键优势:

  • 🚫 防止闭源商业化:任何基于本项目的衍生作品都必须开源
  • 🌐 网络服务保护:即使作为网络服务提供,也必须开放源代码
  • 📚 教育领域专属保护:防止直接抄袭用于其他教育产品并收费
  • 🔄 强制回馈社区:所有改进都必须回馈给开源社区

⚖️ 许可证条款要点

✅ 允许的行为:

  • 自由使用、学习、研究本项目
  • 复制、分发本项目(必须保留AGPLv3许可证)
  • 修改和改进代码
  • 个人或内部使用
  • 教育和学术用途

❌ 禁止的行为:

  • 将代码用于闭源商业产品
  • 提供基于本代码的收费网络服务而不开源完整代码
  • 移除或修改许可证声明
  • 声称对本项目拥有专有权利

🔄 强制义务:

  • 任何衍生作品必须同样使用AGPLv3许可证
  • 网络服务必须向用户提供完整源代码下载
  • 必须保留原作者版权信息
  • 修改后的代码必须明确标注修改内容

🎯 专门针对教育领域的保护

这个许可证选择特别针对教育科技领域的以下问题:

  1. 🏢 防止直接商业化:教育公司不能直接拿代码做成收费产品
  2. 🌐 SaaS服务保护:提供在线教育服务时必须开源所有相关代码
  3. 🔄 促进教育创新:确保教育技术的改进能够惠及整个教育社区
  4. ⚖️ 公平竞争环境:商业公司如需使用,必须同样开源回馈社区

📞 商业合作

如果您代表教育机构或公司,希望在不开源的情况下使用本项目:

  • 📧 联系我们: tzion@pointer.ai - 可讨论商业授权或合作事宜
  • 🤝 技术合作: 欢迎以开源方式共同改进项目
  • 💡 定制服务: 可提供基于开源版本的定制开发服务
  • 🎓 教育支持: 为教育机构提供免费技术支持

🔍 License合规检查

为确保合规使用,请检查:

  • 是否保留了完整的AGPLv3许可证文件
  • 是否在衍生作品中声明了基于本项目
  • 网络服务是否提供了源代码下载链接
  • 修改的代码是否标注了修改说明
  • 衍生项目是否同样采用AGPLv3许可证

详细信息请查看 LICENSE 文件。


选择AGPLv3许可证是为了保护开源社区的共同利益,确保优秀的教育技术能够真正服务于教育事业,而不是被少数商业实体垄断。我们欢迎所有形式的开源贡献和合作!

🙏 致谢

感谢所有为这个项目做出贡献的开发者和使用者!

特别感谢:

  • OpenAI、Anthropic、阿里巴巴提供的优秀AI服务
  • React、Vite等开源社区的卓越工具
  • 所有提供反馈和建议的用户

📚 文档导航

📖 核心文档

📁 模块文档

🎯 文档使用建议

新用户推荐阅读顺序

  1. 📖 README.md - 了解项目概况和核心功能
  2. 🎯 UNIFIED_LEARNING_SYSTEM_GUIDE.md - 完整的系统使用指南
  3. 📁 模块文档 - 深入了解特定模块的技术细节

开发者推荐阅读顺序

  1. 🎯 UNIFIED_LEARNING_SYSTEM_GUIDE.md - 了解系统架构和API
  2. 📁 src/modules/coreData/README.md - 掌握数据管理核心
  3. 📁 src/modules/codeRunner/INTEGRATION_GUIDE.md - 代码环境集成
  4. 📁 src/components/AIAssistant/README.md - AI助手技术实现

🎯 Pointer.ai - 让AI真正为编程教育服务,让每个人都能享受个性化的学习体验! 🚀

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages