---
title: KnowIsle
canonical_url: "https://www.modelscope.cn/studios/hzttaoo/KnowIsle"
md_url: "https://www.modelscope.cn/studios/hzttaoo/KnowIsle.md"
repository: hzttaoo/KnowIsle
chinese_name: "知屿"
last_updated: 2026-10-23
sdk_type: docker
sdk_version: 6.29.1
downloads: 0
stars: 0
---

# KnowIsle

> KnowIsle - hzttaoo 在 ModelScope 创建的在线 Demo。智能辅助学习助手--知屿KnowIsle是一款面向大学生与自学者、基于 Qwen 大模型搭建的轻量化目标驱动式 AI 学习平台，以智能体认知增强重构学习与科研范式，同时做到陪伴学习。平台整合目标管理、学习规划、英语学习、科研知识库检索、陪伴式学习等能力。用户输入阶段目标后，导师智能体依托通义千问能力自动解析目标类型、学习对象、周期与难度，检索个人及共享知识库内的考试大纲、知识点讲义、错题、科研文献资料，动态生成个性化学习方案，在…

hzttaoo/KnowIsle 是 ModelScope 魔搭社区上的在线可交互 Demo（创空间），基于 docker 6.29.1 构建，中文名为「知屿」。

- **Repository**: hzttaoo/KnowIsle
- **SDK**: docker
- **SDK version**: 6.29.1
- **Downloads**: 0
- **Stars**: 0
- **Last updated**: 2026-10-23

Source: https://www.modelscope.cn/studios/hzttaoo/KnowIsle

---

# 知屿 KnowIsle

> 面向大学生与自学者的目标驱动式 AI 学习平台 · 天猫 AI 黑客松参赛作品

**介绍片 / 作品主页**：`/intro.html`　　
**在线体验**：https://hzttaoo-knowisle.ms.show/app　（登录页点「一键体验演示账号」，无需注册）

输入一个阶段目标，导师智能体解析目标类型、难度与周期，结合知识库生成分阶段计划与今日任务；
完成一个任务即出题，分数回写薄弱点并驱动下一轮计划；陪伴智能体负责日程、督促与情绪，
研究智能体调用 OpenAlex 取真实文献元数据并生成带引用报告。

三个智能体：

- **导师智能体**：目标解析、课程大纲、分步讲题、自动出题、批改与计划迭代
- **陪伴智能体**：日程提醒、情绪安抚、健康习惯督促、任务量动态调整
- **研究智能体**：真实文献检索（OpenAlex）、主题筛选、带 DOI/URL 引用的报告

## 运行

```bash
pip install -r requirements.txt
python server.py
```

本地访问 http://localhost:4173 。魔搭使用 Dockerfile 启动，监听 0.0.0.0:7860。

## 后端环境变量

- `DASHSCOPE_API_KEY`：百炼 API Key，在创空间私密环境变量中配置，不写入仓库。
- `DASHSCOPE_MODEL`：默认 qwen-plus。
- `DASHSCOPE_BASE_URL`：默认 https://dashscope.aliyuncs.com/compatible-mode/v1 。
- `DASHSCOPE_TIMEOUT`：模型请求超时秒数，可设为 90。
- `ADMIN_PASSWORD`：部署者设置的管理员密码，账号 admin；不设置则无法使用预置管理员登录，普通注册不受影响。设置后重启可更新预置管理员密码。
- `APP_DATA_DIR`：数据和检索索引目录。Docker 默认 /mnt/workspace/zhiyu-data；必须确认平台挂载持久卷，普通容器文件系统不保证重建后保留。
- `RESEARCH_WEB_SEARCH`：默认 1，使用 OpenAlex；设为 0 可关闭联网检索。
- `OPENALEX_MAILTO`、`OPENALEX_TIMEOUT`：可选学术检索设置。

没有模型 Key 时，三个智能体使用本地规则兜底。真实 Qwen 调用、论文联网检索取决于后端配置和外部服务可用性。

## 文件与数据

assets、hutao/hutao-all-actions、自习室背景.mp4 为实际页面资源。miniapp 保留微信小程序源码，魔搭网页部署不替代微信小程序发布。

账号、学习记录、知识库和索引写入数据目录；前端只允许读取公开静态资源。应用为单进程 JSON 存储演示版，API 请求采用串行事务保护，长模型调用可能让其他请求等待；规模化使用需迁移数据库和任务队列。

知识库支持 PDF、DOCX、TXT、Markdown 等文本型文档；旧版二进制 `.doc` 需要先另存为 docx 或导出 PDF，扫描版 PDF 仍需先 OCR，沿用原应用的解析边界。向量检索在缺少 Chroma 时自动降级为内置的哈希向量 + 全文混合检索，功能不受影响。

## 验证

```bash
python tests/smoke_api.py
python tests/deployment_checks.py
```

测试覆盖注册登录、学习数据保存、管理员词书、三个智能体的本地兜底、静态文件访问限制、管理员配置和并发注册。