双心宝项目开发者上手指南 (DKU 新生特别版)

写在前面：欢迎加入双心宝（Double Heart Treasure）项目！🎉

无论你是编程零基础的大一新生，还是想挑战硬核技术的极客，这里都有适合你的成长路径。 我们采用 “双轨制” 开发模式：

1. Vibe Coding (氛围感编程)：适合新手，用自然语言指挥 AI，快速出成果。
2. LangChain 工程化开发：适合进阶，学习业界最主流的 AI 框架，构建可扩展的系统。

1. 项目极简介绍：我们在做什么？

双心宝 = 心血管疾病 + 心理健康 + AI 智能助手

很多心脏病患者其实同时伴有焦虑、抑郁等心理问题（这叫“双心病”），但心脏科医生可能不懂心理，心理科医生不懂心脏。我们的目标是做一个 AI 实习医生，它既懂心脏病知识（基于权威指南），又懂心理安抚（基于 CBT/正念疗法），能 24 小时陪伴患者。

2. 核心概念扫盲

• Agent (智能体)：像一个聪明的实习生。它不仅能回答问题，还能根据情况决定是“查书”（查指南）还是“说话”（安抚情绪）。
• RAG (检索增强生成)：就像“开卷考试”。AI 先去翻阅我们提供的医学文档，找到答案后再回答，防止它胡编乱造。
• Chain (链)：把处理流程串联起来（比如：接收问题 -> 查库 -> 生成答案 -> 格式化输出）。
• Vibe Coding：你负责想清楚“做什么”，AI 负责写代码。你的核心能力是“清晰描述需求”。

3. 你的成长路线图 (Timeline & Quests)

为了帮助大家快速上手，我们设计了从入门到进阶的 4 个阶段任务清单。请根据你的节奏“打怪升级”。

🌱 第一阶段：快速上手 (Week 1)

目标：消除对技术的恐惧，跑通第一个“无代码”Demo。 核心技能：Prompt Engineering,由于 FastGPT/Dify 等低代码工具。

• 任务 Lv1: 环境搭建
  • 注册 GitHub 账号。
  • 阅读 /resources/toolkits/tools-kit-101，安装 Qoder 或 Cursor。
  • 用 AI 工具生成一个简单的网页（如“番茄钟”或“Hello World”）。
• 任务 Lv2: 知识库初体验
  • 在 FastGPT/Dify 上创建知识库，上传一份测试用的医学文档。
  • 测试提问：“我刚做完支架，心里很慌怎么办？”
• 任务 Lv3: 提示词工程师
  • 修改 System Prompt，把 AI 从“冷漠机器人”变成“温暖的护士长”。
  • 【产出物】：一个可以分享给同学体验的 H5 聊天链接，具备基础的医学问答能力。

🌿 第二阶段：Hello LangChain (Week 2)

目标：脱离低代码平台，开始接触真正的代码开发。 核心技能：Python 基础, LangChain 基础概念。

• 任务 Lv4: 环境准备
  • 安装 Python 环境 (pip install langchain langchain-openai)。
  • 申请 API Key (OpenAI 或 智谱 GLM)。
• 任务 Lv5: 第一个脚本
  • 写一个 Python 脚本，利用 LangChain 调用大模型。
  • 【产出物】：一个自动生成脚本 —— 输入疾病名称（如“冠心病”），自动生成一篇 500 字的科普文章。

🌳 第三阶段：RAG 工程化实战 (Week 3-4)

目标：用代码构建专业的知识库系统（这是双心宝的核心）。 核心技能：Document Loaders, Vector Database (向量数据库)。

• 任务 Lv6: 数据处理
  • 学习 Text Splitters，编写代码把长的 PDF 文档切分成小块。
  • 使用 ChromaDB 或 FAISS 把切分好的文本存起来。
• 任务 Lv7: 构建 QA 系统
  • 编写一条 RetrievalQA Chain，实现“对文档提问”。
  • 【产出物】：一个基于 Python 的命令行工具，输入问题，它能从本地文档中检索答案并回答。

🏰 第四阶段：Agent 架构师 (长期)

目标：打造会用工具的智能医生。 核心技能：Tool Use (工具调用), LangGraph。

• 任务 Lv8: 自定义工具
  • 编写一个 Python 函数 get_patient_bp(id) (模拟查询患者血压)。
  • 让 Agent 学会调用这个函数。
• 任务 Lv9: 智能决策
  • 实现逻辑：当 Agent 发现血压过高时，自动触发“发送警报”工具；当血压正常时，给予“继续保持”的建议。
  • 【产出物】：一个具备“感知-决策-行动”能力的双心智能医生 Demo。

4. 推荐学习资源

必看资源

1. [工具箱] /resources/toolkits/tools-kit-101：仓库内文档，包含所有推荐工具的下载链接。
2. [视频课] LangChain for LLM Application Development：吴恩达 x LangChain 创始人主讲，最权威的入门课。
3. [实战参考] LangChain-Chatchat：GitHub 上著名的开源项目，看看别人是怎么写生产级代码的。

遇到困难怎么办？

1. Vibe Coding 秘籍：把报错直接复制给 Cursor/Qoder，问它“怎么解决”。
2. 社区求助：在微信群或 GitHub Issue 提问，记得带上报错截图。
3. 找 Mentor：不要在这个阶段卡太久，随时摇人！

加油！从写下第一行 Prompt 开始，你就在改变世界。🚀