# sapientis **Repository Path**: blindst/sapientis ## Basic Information - **Project Name**: sapientis - **Description**: 教师备课智能体 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-05 - **Last Updated**: 2026-11-13 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 知课智创 · Sapientis 当前正式版:**v1.0.1**(组件版本 `1.0.1`,Git标签 `v1.0.1`)。本次补丁完善安装运行指南、数据库配置和团队介绍;功能基线沿用 `v1.0`。`master` 为开发主线;初始源码基线为 `v0.1`,原 `v1.0`、`v1.0.0` 标签保留。[正式版交接与证据](docs/competition/current/release-v1.0-handoff.md)记录v1.0功能与课程验证结果。 单机部署的多模态备课工作台。支持五类参考资料、可定位检索、多轮澄清、知识点大纲与详案确认、共同教学节拍、PPT/Word/动画/游戏可选生成,以及定点修改和版本回看。支持本地模型与经许可的远程模型。 当前默认 DeepSeek V4.1 Flash(API ID `deepseek-flash`);Ollama 仅作断网时显式切换的备用。项目远程许可独立生效,同一任务不静默切换模型。 ## 安装与运行 ### 1 获取代码与准备环境 运行环境:Windows、Git、Conda、Python 3.11、Node.js 22.12或以上及pnpm 10;数据库使用PostgreSQL 16和pgvector。视频处理需要FFmpeg,PPT/Word最终预览需要Microsoft Office或已配置的LibreOffice。默认使用DeepSeek API,本地Ollama按需安装。 在已支持Conda的PowerShell中执行: ```powershell git clone https://gitee.com/blindst/sapientis.git cd sapientis conda create -n sapientis python=3.11 -y conda activate sapientis python -m pip install -e ".[probe,test]" conda install -n sapientis -c conda-forge ffmpeg -y pnpm --dir apps/web install --frozen-lockfile pnpm --dir apps/renderer install --frozen-lockfile ``` 已下载源码ZIP时,解压后进入包含本README的目录,从创建Conda环境开始执行即可。Node/pnpm安装与数据库配置详见[部署说明](docs/setup/local-environment.md)。 ### 2 配置数据库与模型 首次安装时复制配置模板,已有`.env`时保留原文件: ```powershell Copy-Item .env.example .env notepad .env ``` 填写`SAPIENTIS_DB_PASSWORD`和自己的`SAPIENTIS_MODEL_API_KEY`;默认模型接口标识为`deepseek-flash`。真实`.env`已被Git忽略。数据库账号/库名默认均为`sapientis`,连接地址为`127.0.0.1:5432`。 数据库二选一,完成其中一种即可: - **WSL PostgreSQL**:按[WSL配置步骤](docs/setup/local-environment.md#wsl数据库)安装PostgreSQL/pgvector,并运行初始化脚本;启动时传入实际发行版名称。 - **Docker PostgreSQL**:按[Docker配置步骤](docs/setup/local-environment.md#docker数据库)启动仓库内的Compose配置;应用启动时加`-SkipDatabase`,复用已启动的容器。 ### 3 迁移并启动 先激活`sapientis`环境,再取得当前解释器路径,命令无需绑定开发者电脑盘符: ```powershell conda activate sapientis $SapientisPython = (Get-Command python).Source & $SapientisPython -m alembic upgrade head # 使用WSL时,以wsl --list --quiet显示的实际名称替换下面的值。 $WslDistribution = 'Ubuntu-24.04' .\scripts\start-all.ps1 -PythonPath $SapientisPython -WslDistribution $WslDistribution # 若使用Docker数据库,以上启动命令改为: # .\scripts\start-all.ps1 -PythonPath $SapientisPython -SkipDatabase .\scripts\health-check.ps1 -RequireWorker -RequireSupervisedWorker -RequireDatabase -RequireModel ``` 打开工作台 `http://127.0.0.1:5173`,API健康检查为 `http://127.0.0.1:8000/api/health`。启动脚本会拉起API、前端和解析/生成双worker监督进程;远程模型模式无需传Ollama模型目录。 ### 4 首次使用与停止 进入工作台后创建备课项目,填写主题、对象和课时;按需上传资料,完成澄清、大纲及详案确认,再选择产物生成。使用远程模型时,还需在项目中确认相应的出站许可。右上角设置可配置模型和界面偏好。 停止应用执行`.\scripts\stop-all.ps1`;运行日志位于`artifacts/runtime/`。更新已有数据库前,先完成活跃任务、备份并停止应用写入,再迁移。环境自检、模型备用、备份恢复及常见故障见[完整部署与排障说明](docs/setup/local-environment.md)。 ## 团队信息 **团队名称:师忧解码** **作品名称:知课智创(Sapientis)** | 成员 | 团队角色 | 主要分工 | | --- | --- | --- | | 王炫倩 | 队长/项目负责人 | 团队统筹、文档编写及部分后端研发 | | 崔颢 | 后端与智能体技术负责人 | 后端研发、Agent与LangGraph工作流设计 | | 李素贞 | 前端与测试负责人 | 前端开发、功能测试与交互验证 | ## 文档 - [当前状态](docs/STATUS.md) · [文档导航](docs/README.md) · [45项需求](docs/product/requirements-matrix.md) - [系统说明](docs/architecture/system-guide.md) · [技术选择理由](docs/architecture/technology-decisions.md) - [目标架构与重构需求](docs/architecture/target-architecture.md)(设计目标)· [当前收尾计划](docs/refactor-plan.md) - [用户流程](docs/ux/user-flow.md) · [重构计划](docs/refactor-plan.md) · [系统审查](docs/evaluation/system-audit.md) ## 开发检查 ```powershell conda run -n sapientis python -m pytest apps/api/tests -q pnpm --dir apps/web build node scripts/check-workspace-state.cjs conda run -n sapientis python scripts/check_requirement_evidence.py ``` 开源采纳增量的集中本机检查(不调用远程模型、Office或主库): ```powershell conda run -n sapientis python scripts/eval_open_source_adoption.py --run ``` 该入口复用后端、Vue、任务读取、工作区和真实浏览器HTML检查;证据写入`artifacts/reuse/acceptance/`。候选解析器需另以`--docling-python`/`--mineru-python`指定已安装的独立环境,离线执行;启动脚本不安装这些候选。 ## 目录与后续协作 - [项目目录说明](docs/project-layout.md):源码、测试、资料、产物和归档的边界。 - [脚本导航](scripts/README.md):运维、回归、内容与文件评测入口。 - [课程评测约定](evals/README.md):固定输入、参照课件、保留集和修订对照。 - 学校课件:`data/private/reference-lessons/school/`,仅本地使用,不进入Git或默认上传远程模型。 - 旧比赛:`data/private/archive/competitions/`,包含原始资料、提交包及赛事专用脚本/证据,退出当前开发入口。 当前交付版本为v1.0.1,课程功能与成品验证沿用v1.0记录。技术、内容、Office视觉、实际教学和独立Windows验收分别记录,详见STATUS。