aishifu/ai-shifu-web

AI-Shifu 镜像文档

概述

AI-Shifu 是一款 AI 驱动的个性化内容呈现平台，作为教师、广播员、故事讲述者和向导，能够根据用户的身份、背景、兴趣和偏好，以完全个性化的方式呈现任何文本内容，创造前所未有的阅读体验。其核心价值在于将标准化内容转化为个性化交互体验，广泛应用于教育、内容展示、个性化学习等场景。

核心功能与特性

1. 个性化输出：基于用户身份、背景、兴趣和偏好的全个性化内容输出，媲美一对一人际互动
2. 富媒体支持：支持 Markdown、HTML、Mermaid 图表等多种内容格式，以及嵌入图片和视频
3. 内容安全：通过主脚本控制所有输出，减少幻觉内容，确保内容质量
4. 交互式问答：用户可随时提问，获取上下文相关的智能解答
5. 互动引导：可随时向用户提问，根据用户回答驱动后续流程
6. 脚本编辑器：轻松编辑脚本并实时预览效果

使用场景与适用范围

• 教育平台：提供 AI 引导的课程学习体验，如官方教育平台 AI-Shifu.com
• 企业培训：为员工提供个性化培训内容和交互式学习体验
• 内容展示：定制化呈现产品介绍、技术文档、营销材料等
• 知识传播：通过交互式问答提升知识传递效率和用户参与度

使用方法与配置说明

官方平台使用

访问 AI-Shifu.com 即可体验由人类专家开发的 AI 引导课程，无需本地部署。

自托管部署

源码安装方式请参考 安装手册

环境要求

• 已安装 https://docs.docker.com/get-docker/
• 已安装 https://docs.docker.com/compose/install/

使用 Docker Hub 镜像部署

1. 克隆代码仓库：

   bash
   git clone https://github.com/ai-shifu/ai-shifu.git
   cd ai-shifu/docker
   

2. 配置环境变量：

   bash
   # 最小化配置（仅包含必要变量）
   cp .env.example.minimal .env
   
   # 或完整配置（包含所有可用选项）
   cp .env.example.full .env
   

3. 编辑 .env 文件，配置关键参数：

   • SQLALCHEMY_DATABASE_URI: 数据库连接字符串
   • SECRET_KEY: JWT 签名密钥（可通过 python -c "import secrets; print(secrets.token_urlsafe(32))" 生成）
   • UNIVERSAL_VERIFICATION_CODE: 测试用验证码
   • 至少配置一个 LLM API 密钥（如 OPENAI_API_KEY、ERNIE_API_KEY 等）

4. 启动服务：

   bash
   docker compose up -d
   

从源码构建部署

1. 克隆代码仓库并进入目录：

   bash
   git clone https://github.com/ai-shifu/ai-shifu.git
   cd ai-shifu/docker
   

2. 配置环境变量：

   bash
   # 选择配置模板
   cp .env.example.minimal .env  # 最小化配置
   # 或
   cp .env.example.full .env      # 完整配置
   

3. 编辑 .env 文件设置必要参数（同上）

4. 执行构建脚本：

   bash
   ./dev_in_docker.sh
   

访问服务

服务启动后：

• 用户界面：访问 http://localhost:8080
• 脚本编辑器：访问 http://localhost:8081
• 登录验证：使用任意手机号登录，默认通用验证码为 1024（生产环境中请修改或禁用）

未来规划

• 整体架构重构
• 开发 AI 脚本生成与维护代理
• 知识库功能
• 语音输入输出支持