synaplan是采用symfony后端与vue前端的开源ai平台，可连接本地或云端模型，并围绕文档与不同渠道组织助手。本教程按项目当前quickstart说明本地试用方法，适合先了解功能与模型接入，不等同于已经完成生产部署。
项目公开的模型提供商设置界面；原图密钥已遮蔽
准备Docker与本地开发环境
Quickstart要求Docker、Compose v2和至少8GB内存；命令还需要Git与make。先确认这些工具可用，再在准备好的工作目录中执行：
git clone https://github.com/metadist/synaplan.git cd synaplan make up
首次启动需要下载镜像，项目说明给出的时间约为5至15分钟，实际取决于网络与设备。需要查看启动进度时，可按文档检查startup-notes服务日志，不应因页面尚未打开就重复初始化。
打开本地页面并检查模型入口
开发Quickstart的前端入口为http://localhost:5173。文档提供的本地试用账号是admin@synaplan.com，密码为admin123；这组公开默认凭据仅用于本机开发试用，不能当作公网部署凭据。
本地音视频转录整理技能 — 接收音频、视频、播客链接、字幕、原始转写稿或未整理文字，完成 ASR 转录（本地 faster-whisper / mlx-whisper）、文本清洗整理，输出分享式提纯版中文原文到本地 .txt 文件。所有产物保存在本地。
当前README说明首次对话可启用Synaplan Demo，范围为14天、每天40条消息。它是演示服务条件，不等于自建实例永久附送全部模型API。正式使用时应在模型提供商设置中添加自己的有效密钥，或按官方说明启用本地模型。
立即学习“PHP免费学习笔记（深入）”；
区分开发Quickstart与正式部署
根目录make up构建的是开发环境。官方另提供发布镜像Quickstart和Linux生产部署流程，使用不同Compose文件、端口与数据位置。需要上线时应按对应指南固定版本、生成管理员与密钥并配置HTTPS，不直接把本地默认账号和开发端口暴露出去。
