Files
2026-03-20 14:26:24 +08:00

4.6 KiB
Raw Permalink Blame History

学习助手 (Learning Assistant)

一个基于AI知识的交互式学习工具,通过生成多种形式的内容帮助你快速掌握知识点。

功能特性

  • 🎓 多形式学习内容:为知识点生成5种不同形式的学习内容

    • 📊 Mermaid图表:知识结构可视化,自动复制到剪切板
    • 🎭 郭德纲式讲解:幽默风趣的知识讲解
    • ✍️ 十道考核题:带解析的选择题,检验学习效果
    • 📝 记忆卡片:结构化的关键知识点总结
    • 🏗️ 工程场景:实际应用案例和代码示例
  • 🖥️ 交互式TUI界面:使用Bubble Tea构建的终端用户界面

    • Tab切换查看不同内容
    • 键盘导航(←/→翻页,↑/↓滚动)
    • 流畅的用户体验
  • 🤖 AI驱动:基于硅基流动AI服务,使用DeepSeek模型

安装

前置要求

  • Go 1.25.6 或更高版本
  • 硅基流动API密钥

安装步骤

  1. 克隆仓库
git clone https://github.com/yourusername/learning-assistant.git
cd learning-assistant
  1. 安装依赖
go mod tidy
  1. 构建程序
go build -o learning.exe cmd/main.go
  1. 设置API密钥
export SILICON_API_KEY=your_api_key_here

使用方法

基本使用

./learning.exe

操作流程

  1. 程序启动后,输入你想学习的知识点
  2. 按 Enter 键开始生成
  3. 等待AI生成完成(后台并发生成5种内容)
  4. 使用 ←/→ 键切换不同的Tab查看内容
  5. 使用 ↑/↓ 键滚动长内容
  6. 按 q 或 Ctrl+C 退出程序

键盘快捷键

按键 功能
Enter 确认输入/开始生成
← 切换到上一个Tab
→ 切换到下一个Tab
↑ 向上滚动内容
↓ 向下滚动内容
q 退出程序
Ctrl+C 退出程序

配置文件

配置文件位于 config/config.yaml:

api:
  endpoint: "https://api.siliconflow.cn/v1"
  model: "deepseek-ai/DeepSeek-V3"
  timeout: 120
  max_retries: 3

ui:
  width: 100
  height: 30
  colors:
    primary: "#7D56F4"
    secondary: "#04B575"
    text: "#FAFAFA"
    background: "#232323"
    border: "#586069"

项目结构

learning-assistant/
├── cmd/
│   └── main.go                    # 程序入口
├── internal/
│   ├── ai/                        # AI集成层
│   │   ├── client.go              # 硅基流动API客户端
│   │   ├── prompt.go              # 提示词管理
│   │   ├── prompts/               # 提示词模板
│   │   └── generators/            # 内容生成器
│   ├── clipboard/                 # 剪切板操作
│   └── tui/                       # TUI界面层
│       ├── model.go               # TUI模型
│       ├── view.go                # 视图渲染
│       └── update.go              # 事件处理
├── config/
│   └── config.yaml                # 配置文件
├── go.mod
├── go.sum
└── README.md

技术栈

示例

输入示例

🎓 学习助手
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

请输入您想学习的知识点: Redis缓存策略

输出示例

程序会生成以下内容:

  1. Mermaid图表 - 显示Redis缓存策略的思维导图
  2. 郭德纲式讲解 - 用幽默的方式讲解缓存策略
  3. 十道考核题 - 测试对Redis缓存的理解
  4. 记忆卡片 - 总结核心知识点
  5. 工程场景 - 展示实际应用案例

常见问题

Q: 如何获取硅基流动API密钥?

A: 访问 硅基流动官网 注册并获取API密钥。

Q: 生成失败怎么办?

A: 检查以下几点:

  1. API密钥是否正确设置
  2. 网络连接是否正常
  3. API额度是否充足

Q: 如何更改UI主题颜色?

A: 编辑 config/config.yaml 文件中的 ui.colors 配置项。

开发

运行开发版本

go run cmd/main.go

构建

go build -o learning.exe cmd/main.go

依赖管理

go mod tidy
go mod verify

许可证

MIT License

贡献

欢迎提交Issue和Pull Request!

致谢