[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-HugeCatLab--ChatTutor":3,"tool-HugeCatLab--ChatTutor":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",145895,2,"2026-04-08T11:32:59",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108111,"2026-04-08T11:23:26",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":72,"owner_avatar_url":73,"owner_bio":74,"owner_company":75,"owner_location":75,"owner_email":75,"owner_twitter":75,"owner_website":75,"owner_url":76,"languages":77,"stars":106,"forks":107,"last_commit_at":108,"license":109,"difficulty_score":110,"env_os":111,"env_gpu":111,"env_ram":111,"env_deps":112,"category_tags":124,"github_topics":125,"view_count":32,"oss_zip_url":75,"oss_zip_packed_at":75,"status":17,"created_at":131,"updated_at":132,"faqs":133,"releases":169},5578,"HugeCatLab\u002FChatTutor","ChatTutor","👨‍🏫 ChatTutor: Visual and Interactive AI Tutor","ChatTutor 是一款兼具可视化与交互能力的 AI 智能导师，旨在突破传统聊天机器人仅靠文字交流的局限。在现实课堂中，教师借助黑板、图表等工具能更生动地讲解知识，而普通 AI 在处理数学推导、科学原理等 STEM 学科内容时，往往因缺乏视觉辅助而显得力不从心。ChatTutor 创造性地为 AI 赋予了使用“电子白板”的能力，使其不仅能对话，还能实时绘制数学公式画布、生成思维导图，将抽象概念转化为直观的视觉呈现，从而大幅提升学习效率与理解深度。\n\n这款工具特别适合有深度学习需求的学生、需要辅导孩子的家长，以及希望探索多模态教学场景的教育工作者。对于开发者而言，ChatTutor 提供了开放的架构，支持对接 OpenAI、Anthropic、DeepSeek 等多种主流大模型，并具备完善的数据库与对象存储配置选项，便于二次开发与私有化部署。其核心亮点在于将“教学工具链”完整引入 AI 交互流程，让机器真正像人类老师一样“边讲边画”，实现了从单纯问答到沉浸式教学的跨越。无论是攻克复杂的几何难题，还是梳理庞大的知识体系，ChatTutor 都能成为您身边得力的可视化学习伙伴。","\u003Cdiv align=\"right\">\n  \u003Cspan>[\u003Ca href=\".\u002FREADME.md\">English\u003C\u002Fa>]\u003Cspan>\n  \u003C\u002Fspan>[\u003Ca href=\".\u002FREADME_CN.md\">简体中文\u003C\u002Fa>]\u003C\u002Fspan>\n\u003C\u002Fdiv>  \n\n\u003Cdiv align=\"center\">\n\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FHugeCatLab_ChatTutor_readme_c3b7485f9026.png\" alt=\"ChatTutor\" width=\"150\" height=\"150\" \u002F>\n\n  \u003Ch1>ChatTutor\u003C\u002Fh1>\n\n  \u003Cp>Visual and Interactive AI Tutor\u003C\u002Fp>\n  \n  \u003Cdiv align=\"center\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fpackage-json\u002Fv\u002FHugeCatLab\u002FChatTutor\" alt=\"Version\" \u002F>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002FHugeCatLab\u002FChatTutor\" alt=\"License\" \u002F>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FHugeCatLab\u002FChatTutor?style=social\" alt=\"Stars\" \u002F>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002FHugeCatLab\u002FChatTutor?style=social\" alt=\"Forks\" \u002F>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002FHugeCatLab\u002FChatTutor\" alt=\"Last Commit\" \u002F>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002FHugeCatLab\u002FChatTutor\" alt=\"Issues\" \u002F>\n  \u003C\u002Fdiv>\n  \n\u003C\u002Fdiv>\n\n---\n\n> [!NOTE]\n>\n> Online Website: ChatTutor is available at [https:\u002F\u002Fchattutor.app](https:\u002F\u002Fchattutor.app), please set your own API key and models in the settings. ([https:\u002F\u002Fchattutor.app\u002Fsettings](https:\u002F\u002Fchattutor.app\u002Fsettings))\n\nChatTutor is an AI teacher equipped with the ability to use an electronic whiteboard.\n\nTraditional chatbots interact with users primarily through text, which is sufficient in most scenarios. However, with the development of LLM in recent years, more and more people are using AI to assist their learning. In a real-world classroom, teachers have many teaching tools—chalk, computers, blackboards, and other teaching aids—that help students better understand knowledge. But for a chatbot, text can convey very limited information, especially in STEM subjects.\n\nChatTutor effectively solves this problem by bringing all the teaching tools used in real-world educational scenarios to the forefront, allowing users to interact with them through electronic devices. We've empowered AI with the ability to use these tools, enabling AI to become a truly hands-on teacher.\n\n## Features\n\n##### Math Canvas\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd>\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FHugeCatLab_ChatTutor_readme_9d23eb95b8a7.png\" alt=\"Math Canvas\" width=\"100%\" \u002F>\n    \u003C\u002Ftd>\n    \u003Ctd>\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FHugeCatLab_ChatTutor_readme_13ef480a4030.png\" alt=\"Math Canvas\" width=\"100%\" \u002F>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd>\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FHugeCatLab_ChatTutor_readme_a26e5b8a0654.png\" alt=\"Math Canvas\" width=\"100%\" \u002F>\n    \u003C\u002Ftd>\n    \u003Ctd>\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FHugeCatLab_ChatTutor_readme_ad88e0859126.png\" alt=\"Math Canvas\" width=\"100%\" \u002F>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n##### Mindmap\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd>\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FHugeCatLab_ChatTutor_readme_7fdda06e4425.png\" alt=\"Mindmap\" width=\"100%\" \u002F>\n    \u003C\u002Ftd>\n    \u003Ctd>\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FHugeCatLab_ChatTutor_readme_d287ec67900e.png\" alt=\"Mindmap\" width=\"100%\" \u002F>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## Quick Start\n\n\u003Cdetails>\u003Csummary>Environment Variables\u003C\u002Fsummary>\n\n### Database Configuration\n- `DATABASE_URL`: PostgreSQL connection string\n\n### Server & Client\n- `VITE_API_BASE_URL`: Base URL for the API server (e.g., `http:\u002F\u002Flocalhost:8002`)\n- `CLINET_BASE_URL`: Base URL for the client application (e.g., `http:\u002F\u002Flocalhost:8001`)\n\n### AI Configuration\n- `MODEL_API_KEY`: Your API key for the AI service (e.g., `your_api_key_here`)\n- `MODEL_BASE_URL`: Base URL for the AI service (optional, defaults to OpenAI)\n- `AGENT_MODEL`: Model for the main agent that chats with users (e.g., `gpt-4`)\n- `AGENT_MODEL_PROVIDER`: Model provider (options: refer to [Provider Enum](#provider-enum))\n- `TITLE_MODEL`: Model for generating chat titles (optional, defaults to `AGENT_MODEL`)\n- `TITLE_MODEL_PROVIDER`: Model provider for title generation (optional, defaults to `AGENT_MODEL_PROVIDER`, refer to [Provider Enum](#provider-enum))\n\n#### Provider Enum\n- OpenAI: `openai`\n- Anthropic: `anthropic`\n- DeepSeek: `deepseek`\n\n### OSS Configuration\n- `OSS_ENDPOINT`: OSS endpoint URL (if not set, image upload will be unavailable)\n- `OSS_ACCESS_KEY`: OSS access key\n- `OSS_SECRET_KEY`: OSS secret key\n- `OSS_BUCKET`: OSS bucket name\n- `OSS_REGION`: OSS region\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\u003Csummary>Run with Docker\u003C\u002Fsummary>\n\n### Environment\n\n> - Docker >= 24.0.0\n> - Docker Compose >= 2.22.0\n\n### Setup\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FHugeCatLab\u002FChatTutor.git\ncd ChatTutor\ncp .env.example .env\n```\n\n### Run\n\n```bash\ncd docker\ndocker compose up -d\n```\n\u003C\u002Fdetails>\n\n\u003Cdetails>\u003Csummary>Run with Node & Bun\u003C\u002Fsummary>\n\n### Environment\n\n> - Node.js >= 20\n> - Bun >= 1.2\n> - pnpm >= 9.1.0\n\n### Setup\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FHugeCatLab\u002FChatTutor.git\ncd ChatTutor\npnpm i\n```\n\n### Development\n\n```bash\npnpm dev\n```\n\nOr:\n\n```bash\npnpm client:dev\npnpm web:dev\n```\n\n### Build\n\n```bash\npnpm build\npnpm client:start\npnpm web:start\n```\n\n\u003C\u002Fdetails>\n\n\n## Tech Stacks\n\n- [Geogebra](https:\u002F\u002Fwww.geogebra.org\u002F)\n- [Vue](https:\u002F\u002Fvuejs.org\u002F)\n- [Vite](https:\u002F\u002Fvitejs.dev)\n- [ElysiaJs](https:\u002F\u002Fhttps:\u002F\u002Felysiajs.com\u002F)\n- [AI SDK](https:\u002F\u002Fai-sdk.dev\u002F)\n\n## Sponsors\nOur sponsors are listed as follows (in no particular order):\n\n- [AiHubMix](https:\u002F\u002Faihubmix.com\u002F): Open model hub for AI.\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FHugeCatLab_ChatTutor_readme_e02c545d5954.png)](https:\u002F\u002Fwww.star-history.com\u002F#HugeCatLab\u002FChatTutor&type=date&legend=top-left)\n\n---\n**AGPL v3 License**\n\n*Copyright (c) 2025 Acbox, All rights reserved.*","\u003Cdiv align=\"right\">\n  \u003Cspan>[\u003Ca href=\".\u002FREADME_CN.md\">简体中文\u003C\u002Fa>]\u003Cspan>\n  \u003C\u002Fspan>[\u003Ca href=\".\u002FREADME.md\">English\u003C\u002Fa>]\u003C\u002Fspan>\n\u003C\u002Fdiv>  \n\n\u003Cdiv align=\"center\">\n\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FHugeCatLab_ChatTutor_readme_c3b7485f9026.png\" alt=\"ChatTutor\" width=\"150\" height=\"150\" \u002F>\n\n  \u003Ch1>ChatTutor\u003C\u002Fh1>\n\n  \u003Cp>可视化与交互式AI辅导老师\u003C\u002Fp>\n  \n  \u003Cdiv align=\"center\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fpackage-json\u002Fv\u002FHugeCatLab\u002FChatTutor\" alt=\"版本\" \u002F>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002FHugeCatLab\u002FChatTutor\" alt=\"许可证\" \u002F>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FHugeCatLab\u002FChatTutor?style=social\" alt=\"星标\" \u002F>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002FHugeCatLab\u002FChatTutor?style=social\" alt=\"叉子\" \u002F>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002FHugeCatLab\u002FChatTutor\" alt=\"最近一次提交\" \u002F>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002FHugeCatLab\u002FChatTutor\" alt=\"问题\" \u002F>\n  \u003C\u002Fdiv>\n  \n\u003C\u002Fdiv>\n\n---\n\n> [!NOTE]\n>\n> 在线网站：ChatTutor 已在 [https:\u002F\u002Fchattutor.app](https:\u002F\u002Fchattutor.app) 上线，请在设置中配置您自己的 API 密钥和模型。([https:\u002F\u002Fchattutor.app\u002Fsettings](https:\u002F\u002Fchattutor.app\u002Fsettings))\n\nChatTutor 是一款具备电子白板功能的 AI 辅导老师。\n\n传统的聊天机器人主要通过文本与用户互动，在大多数场景下已足够。然而，随着近年来大语言模型的发展，越来越多的人开始使用 AI 来辅助学习。在真实的课堂环境中，教师会使用粉笔、电脑、黑板等多种教学工具来帮助学生更好地理解知识。但对于聊天机器人而言，仅靠文本传递的信息非常有限，尤其是在 STEM 学科领域。\n\nChatTutor 有效地解决了这一问题，它将现实教育场景中的各种教学工具引入到线上平台，使用户能够通过电子设备与这些工具进行交互。我们赋予了 AI 使用这些工具的能力，从而使 AI 成为一位真正可动手操作的老师。\n\n## 功能\n\n##### 数学画布\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd>\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FHugeCatLab_ChatTutor_readme_9d23eb95b8a7.png\" alt=\"数学画布\" width=\"100%\" \u002F>\n    \u003C\u002Ftd>\n    \u003Ctd>\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FHugeCatLab_ChatTutor_readme_13ef480a4030.png\" alt=\"数学画布\" width=\"100%\" \u002F>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd>\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FHugeCatLab_ChatTutor_readme_a26e5b8a0654.png\" alt=\"数学画布\" width=\"100%\" \u002F>\n    \u003C\u002Ftd>\n    \u003Ctd>\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FHugeCatLab_ChatTutor_readme_ad88e0859126.png\" alt=\"数学画布\" width=\"100%\" \u002F>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n##### 思维导图\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd>\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FHugeCatLab_ChatTutor_readme_7fdda06e4425.png\" alt=\"思维导图\" width=\"100%\" \u002F>\n    \u003C\u002Ftd>\n    \u003Ctd>\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FHugeCatLab_ChatTutor_readme_d287ec67900e.png\" alt=\"思维导图\" width=\"100%\" \u002F>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## 快速入门\n\n\u003Cdetails>\u003Csummary>环境变量\u003C\u002Fsummary>\n\n### 数据库配置\n- `DATABASE_URL`: PostgreSQL 连接字符串\n\n### 服务器与客户端\n- `VITE_API_BASE_URL`: API 服务器的基础 URL（例如 `http:\u002F\u002Flocalhost:8002`）\n- `CLINET_BASE_URL`: 客户端应用的基础 URL（例如 `http:\u002F\u002Flocalhost:8001`）\n\n### AI 配置\n- `MODEL_API_KEY`: 您的 AI 服务 API 密钥（例如 `your_api_key_here`）\n- `MODEL_BASE_URL`: AI 服务的基础 URL（可选，默认为 OpenAI）\n- `AGENT_MODEL`: 用于与用户对话的主要代理模型（例如 `gpt-4`）\n- `AGENT_MODEL_PROVIDER`: 模型提供商（选项参见 [Provider Enum](#provider-enum)）\n- `TITLE_MODEL`: 用于生成对话标题的模型（可选，默认为 `AGENT_MODEL`）\n- `TITLE_MODEL_PROVIDER`: 标题生成的模型提供商（可选，默认为 `AGENT_MODEL_PROVIDER`，参见 [Provider Enum](#provider-enum)）\n\n#### Provider Enum\n- OpenAI: `openai`\n- Anthropic: `anthropic`\n- DeepSeek: `deepseek`\n\n### OSS 配置\n- `OSS_ENDPOINT`: OSS 端点 URL（若未设置，图片上传将不可用）\n- `OSS_ACCESS_KEY`: OSS 访问密钥\n- `OSS_SECRET_KEY`: OSS 秘密密钥\n- `OSS_BUCKET`: OSS 存储桶名称\n- `OSS_REGION`: OSS 区域\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\u003Csummary>使用 Docker 运行\u003C\u002Fsummary>\n\n### 环境\n\n> - Docker >= 24.0.0\n> - Docker Compose >= 2.22.0\n\n### 设置\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FHugeCatLab\u002FChatTutor.git\ncd ChatTutor\ncp .env.example .env\n```\n\n### 运行\n\n```bash\ncd docker\ndocker compose up -d\n```\n\u003C\u002Fdetails>\n\n\u003Cdetails>\u003Csummary>使用 Node 和 Bun 运行\u003C\u002Fsummary>\n\n### 环境\n\n> - Node.js >= 20\n> - Bun >= 1.2\n> - pnpm >= 9.1.0\n\n### 设置\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FHugeCatLab\u002FChatTutor.git\ncd ChatTutor\npnpm i\n```\n\n### 开发\n\n```bash\npnpm dev\n```\n\n或者：\n\n```bash\npnpm client:dev\npnpm web:dev\n```\n\n### 构建\n\n```bash\npnpm build\npnpm client:start\npnpm web:start\n```\n\n\u003C\u002Fdetails>\n\n\n## 技术栈\n\n- [Geogebra](https:\u002F\u002Fwww.geogebra.org\u002F)\n- [Vue](https:\u002F\u002Fvuejs.org\u002F)\n- [Vite](https:\u002F\u002Fvitejs.dev)\n- [ElysiaJs](https:\u002F\u002Felysiajs.com\u002F)\n- [AI SDK](https:\u002F\u002Fai-sdk.dev\u002F)\n\n## 赞助商\n我们的赞助商名单如下（不分先后）：\n\n- [AiHubMix](https:\u002F\u002Faihubmix.com\u002F)：开放的 AI 模型中心。\n\n## 星标历史\n\n[![星标历史图表](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FHugeCatLab_ChatTutor_readme_e02c545d5954.png)](https:\u002F\u002Fwww.star-history.com\u002F#HugeCatLab\u002FChatTutor?type=date&legend=top-left)\n\n---\n**AGPL v3 许可证**\n\n*版权所有 © 2025 Acbox，保留所有权利。*","# ChatTutor 快速上手指南\n\nChatTutor 是一款具备电子白板能力的可视化交互式 AI 导师。它突破了传统聊天机器人仅通过文本交互的限制，让 AI 能够像真实教师一样使用数学画布（Math Canvas）和思维导图（Mindmap）等工具进行教学，特别适用于 STEM 领域的学习辅助。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n### 方案一：使用 Docker（推荐）\n- **Docker**: >= 24.0.0\n- **Docker Compose**: >= 2.22.0\n\n### 方案二：使用 Node.js & Bun\n- **Node.js**: >= 20\n- **Bun**: >= 1.2\n- **pnpm**: >= 9.1.0\n- **数据库**: PostgreSQL (需自行准备连接字符串)\n\n> **注意**：您需要准备一个 AI 服务 API Key（支持 OpenAI, Anthropic, DeepSeek 等）。\n\n## 安装步骤\n\n### 1. 获取源码\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FHugeCatLab\u002FChatTutor.git\ncd ChatTutor\n```\n\n### 2. 配置环境变量\n复制示例配置文件并根据实际情况修改：\n```bash\ncp .env.example .env\n```\n**关键配置项说明**（编辑 `.env` 文件）：\n- `DATABASE_URL`: PostgreSQL 连接字符串\n- `MODEL_API_KEY`: 您的 AI 服务 API Key\n- `AGENT_MODEL`: 主对话模型名称 (例如 `gpt-4`)\n- `AGENT_MODEL_PROVIDER`: 模型提供商 (`openai`, `anthropic`, 或 `deepseek`)\n- `OSS_*`: 对象存储配置（若未配置将无法上传图片）\n\n### 3. 启动服务\n\n#### 方式 A：使用 Docker 启动（最简单）\n```bash\ncd docker\ndocker compose up -d\n```\n\n#### 方式 B：使用 Node\u002FBun 本地开发\n安装依赖：\n```bash\npnpm i\n```\n\n启动开发服务器：\n```bash\npnpm dev\n```\n*或者分别启动客户端和服务端：*\n```bash\npnpm client:dev\npnpm web:dev\n```\n\n生产环境构建与运行：\n```bash\npnpm build\npnpm client:start\npnpm web:start\n```\n\n## 基本使用\n\n1. **访问应用**\n   - 启动成功后，通常在浏览器访问 `http:\u002F\u002Flocalhost:8001` (具体端口请参考启动日志或 `.env` 中的 `CLINET_BASE_URL`)。\n   - 如果是 Docker 部署，请检查 `docker-compose.yml` 中映射的端口。\n\n2. **配置模型**\n   - 进入应用后，前往设置页面 (Settings)。\n   - 输入您的 `API Key` 并选择对应的模型提供商和模型名称。\n\n3. **开始互动教学**\n   - 在对话框中输入问题，例如：“请帮我讲解勾股定理”或“画出神经网络的思维导图”。\n   - **数学画布**：AI 将自动调用 GeoGebra 引擎，在右侧画布上绘制函数图像或几何图形进行演示。\n   - **思维导图**：AI 可生成 Mermaid 格式的思维导图，帮助您梳理知识脉络。\n\n现在，您可以像拥有私人助教一样，享受可视化的 AI 教学体验了。","一名高中生正在备战数学竞赛，面对复杂的解析几何大题，他急需一位能像真人老师一样在草稿纸上边画图边推导的辅导者。\n\n### 没有 ChatTutor 时\n- **纯文字描述抽象难懂**：AI 只能用枯燥的文字描述“过点 A 做垂线”，学生必须在脑海中自行构建几何图形，极易产生理解偏差。\n- **推导过程断裂**：遇到多步骤计算时，传统聊天机器人无法保留中间演算痕迹，学生一旦走神就很难跟上逻辑链条。\n- **缺乏互动反馈**：学生无法直接在解题过程中标记疑问点，只能被动阅读大段文本，难以进行针对性的即时提问。\n- **思维结构混乱**：对于需要梳理知识点的复习场景，仅靠文字列表难以直观展示概念间的层级与关联，记忆效率低下。\n\n### 使用 ChatTutor 后\n- **可视化白板演示**：ChatTutor 直接调用电子画布，实时绘制精准的几何图形并动态标注辅助线，让抽象题目瞬间变得直观清晰。\n- **手把手分步推导**：AI 像在黑板板书一样，一步步写出公式变换和计算过程，学生可随时暂停查看任意步骤的细节，逻辑连贯无断点。\n- **交互式深度研讨**：学生可以直接在画布上圈出不懂的步骤，ChatTutor 会立即针对该区域进行专项讲解，实现真正的“指哪讲哪”。\n- **自动生成思维导图**：在复习阶段，ChatTutor 能一键将零散的知识点转化为结构化的思维导图，帮助学生快速建立完整的知识体系。\n\nChatTutor 通过将“电子白板”与\"AI 大脑”深度融合，把单向的文字问答升级为沉浸式的互动课堂，真正实现了因材施教的个性化辅导。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FHugeCatLab_ChatTutor_9d23eb95.png","HugeCatLab","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FHugeCatLab_d25b8d3c.png","Meow~",null,"https:\u002F\u002Fgithub.com\u002FHugeCatLab",[78,82,86,90,94,98,102],{"name":79,"color":80,"percentage":81},"Vue","#41b883",58.6,{"name":83,"color":84,"percentage":85},"TypeScript","#3178c6",34.5,{"name":87,"color":88,"percentage":89},"CSS","#663399",3.7,{"name":91,"color":92,"percentage":93},"Dockerfile","#384d54",1.9,{"name":95,"color":96,"percentage":97},"Shell","#89e051",0.7,{"name":99,"color":100,"percentage":101},"JavaScript","#f1e05a",0.4,{"name":103,"color":104,"percentage":105},"HTML","#e34c26",0.2,989,136,"2026-04-07T08:19:39","AGPL-3.0",4,"未说明",{"notes":113,"python":111,"dependencies":114},"该项目主要基于 Node.js\u002FBun 运行，而非 Python。支持通过 Docker 或直接使用 Node.js\u002FBun 部署。需要配置 PostgreSQL 数据库。需自行设置 AI 模型提供商（如 OpenAI、Anthropic、DeepSeek）的 API Key。若需图片上传功能，必须配置对象存储（OSS）相关参数。",[115,116,117,118,119,120,79,121,122,123],"Node.js >= 20","Bun >= 1.2","pnpm >= 9.1.0","Docker >= 24.0.0","Docker Compose >= 2.22.0","PostgreSQL","Vite","ElysiaJs","AI SDK",[14,35,13,15],[126,127,128,129,130],"ai","ai-education","education","llm","stem","2026-03-27T02:49:30.150509","2026-04-08T23:42:51.476485",[134,139,144,149,154,159,164],{"id":135,"question_zh":136,"answer_zh":137,"source_url":138},25296,"配置了官网地址、BaseURL 和 Key 后，程序一直加载（转圈圈）没有反应怎么办？","这种情况大多是由于所选的大模型能力较差，几乎每次都会输出错误的绘图语法，导致前端无法渲染而看似卡死。强烈建议将模型切换为 Claude 或 Gemini 等高性能模型来解决此问题。","https:\u002F\u002Fgithub.com\u002FHugeCatLab\u002FChatTutor\u002Fissues\u002F27",{"id":140,"question_zh":141,"answer_zh":142,"source_url":143},25295,"为什么 Mermaid 或 JSXGraph 绘图功能无法渲染图片，一直转圈或报错？","这通常是因为当前使用的模型能力不足，导致生成的语法错误从而无法渲染。建议更换为能力更强的模型（如 Claude 或 Gemini）。如果问题依旧，可以尝试开启一个新的对话窗口，并排除 Mermaid 页面进行测试。此外，确保网络请求正常，若使用特定模型出现 'Invalid tool_calls' 错误，也请切换模型尝试。","https:\u002F\u002Fgithub.com\u002FHugeCatLab\u002FChatTutor\u002Fissues\u002F14",{"id":145,"question_zh":146,"answer_zh":147,"source_url":148},25297,"使用 Docker Compose 启动项目时，报错提示找不到 packages\u002Fmermaid 或 packages\u002Fpkg 目录怎么办？","这是 Dockerfile 中的路径配置错误导致的。你可以暂时不使用 Docker，改为通过本地环境运行：\n1. 安装依赖：`pnpm i`\n2. 初始化数据库：`pnpm db:init`\n3. 启动开发服务器：`pnpm dev`\n维护者已修复该路径问题，若必须使用 Docker 请拉取最新代码。","https:\u002F\u002Fgithub.com\u002FHugeCatLab\u002FChatTutor\u002Fissues\u002F37",{"id":150,"question_zh":151,"answer_zh":152,"source_url":153},25298,"侧边栏历史记录中出现了不属于我的聊天内容，这是正常的吗？","这是预期行为。目前项目尚未实现多用户账户隔离功能，所有用户的聊天记录是共享的。因此你会看到其他人产生的历史会话条目。","https:\u002F\u002Fgithub.com\u002FHugeCatLab\u002FChatTutor\u002Fissues\u002F30",{"id":155,"question_zh":156,"answer_zh":157,"source_url":158},25299,"Painter Agent（绘图智能体）是否可以使用小模型来降低成本？","经过测试，直接使用小模型效果不佳，除非对小模型进行专门的微调（Fine-tuning）。因为绘图任务虽然逻辑不复杂，但对生成代码指令的精确性要求极高，普通小模型难以胜任。目前的建议是分步骤产出（大纲->画面描述->具体内容），或在特定场景下配置独立 Prompt，但核心仍推荐大模型。","https:\u002F\u002Fgithub.com\u002FHugeCatLab\u002FChatTutor\u002Fissues\u002F15",{"id":160,"question_zh":161,"answer_zh":162,"source_url":163},25300,"项目计划重构并弃用 Nuxt，主要原因是什么？","重构主要基于两点考虑：\n1. 当前项目的可维护性较低，有必要重写以提升代码质量。\n2. 团队有计划开发移动端应用，独立的 API 服务器架构（新架构中将 API 与 Web 分离）更便于后续与移动端对接。","https:\u002F\u002Fgithub.com\u002FHugeCatLab\u002FChatTutor\u002Fissues\u002F42",{"id":165,"question_zh":166,"answer_zh":167,"source_url":168},25301,"如何联系项目作者或加入讨论群？","目前项目没有公开的群组。你可以通过以下方式联系作者：\n- Telegram: @acboxawa 或 @keykms9\n- 邮箱：通过 GitHub 个人资料或 Issue 回复获取联系方式。\n- 微信：acboxlol（需私下沟通添加）","https:\u002F\u002Fgithub.com\u002FHugeCatLab\u002FChatTutor\u002Fissues\u002F1",[170,174],{"id":171,"version":172,"summary_zh":75,"released_at":173},159841,"v0.1.0","2026-01-03T08:54:28",{"id":175,"version":176,"summary_zh":177,"released_at":178},159842,"v0.0.1","# 发布说明 - v0.0.1\n\n## ✨ 新功能\n- ✨ 几何画板渲染\n- ✨ (代理): 生成几何画板\n- ✨ 几何画板小应用\n- ✨ 笔记解析器\n- ✨ 在主应用和 DSL 演示环境中添加暗黑模式支持，并修复移动端布局 (#32)\n- ✨ Mermaid 现在由 LLM 直接输出 (#25)\n- ✨ 文档站点\n- ✨ 当属性值未设置时自动转换为 true\n- ✨ 让代理能够控制响应式变量 (#24)\n- ✨ vitest\n- ✨ 优化提示词，使代理仅在笔记中列出关键点，详细解释保留在普通聊天中\n- ✨ 自定义 API 设置\n- ✨ 添加绘图加载动画\n- ✨ 图片上传\n- ✨ 更多消息类型\n- ✨ 标题生成\n- ✨ 请求状态\n- ✨ 为每个画布页面提供独立的代理上下文\n- ✨ 支持移动端\n- ✨ 添加图片选项\n- ✨ 使用 OSS 上传文件\n- ✨ mermaid\n- ✨ 笔记板\n- ✨ 元素\n- ✨ \\`use\\` 语法糖\n- ✨ 改进提示词\n- ✨ 添加画布元素\n- ✨ 数学画布坐标轴与网格选择\n- ✨ 页面切换器\n- ✨ 聊天历史\n- ✨ 加载历史\n- ✨ 数学画布渲染\n- ✨ 基本聊天功能\n- ✨ 添加部分元素\n- ✨ 系统提示词\n- ✨ 基本代理逻辑\n- ✨ 添加欢迎页面\n- ✨ 聊天 UI\n- ✨ 画布模块\n- ✨ 基础 UI\n- ✨ 基础类型\n\n## 🐛 Bug 修复\n- 🐛 块解析器\n- 🐛 部分移动设备上的暗黑模式 (#33)\n- 🐛 标签与 LaTeX\n- 🐛 访问已完成聊天时重新发送\n- 🐛 Docker 入口点 CRLF 问题 (#23)\n- 🐛 vitest\n- 🐛 设置\n- 🐛 设置定时器\n- 🐛 将 \\`crypto\\` 替换为 \\`uuid.v4\\`\n","2025-12-09T18:34:02"]