ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Memoh开发者环境搭建指南:基于mise与Docker的本地开发全流程

Memoh开发者环境搭建指南:基于mise与Docker的本地开发全流程 Memoh开发者环境搭建指南基于mise与Docker的本地开发全流程【免费下载链接】Memoh✨ The open-source multi-agent platform. Every agent gets its own computer, desktop, network, and long-term memory. You can bring your own key, or host your coding agent like Claude Code, Codex and so on.项目地址: https://gitcode.com/gh_mirrors/me/MemohMemoh 是一个开源的多智能体multi-agent平台每个 Agent 都拥有自己独立的云端电脑——独立文件系统、桌面、浏览器、网络与长期记忆还能托管 Claude Code、Codex 等编码智能体。想在本地把Memoh 开发者环境跑起来并不复杂项目官方使用mise 管理工具链 Docker Compose 拉起容器化服务按本文步骤操作约 10 分钟即可在浏览器中打开开发中的 Web 界面。一、为什么用 mise Docker 搭建 Memoh 开发环境Memoh 是一个 Go 后端 Vue 前端 Rust 辅助工具的 monorepo涉及 Go 1.25、Node.js 25、pnpm 10、sqlc 等多种工具版本。项目用 mise.toml 把所有工具版本钉死在配置里[tools] go 1.25.6 node 25 pnpm 10 sqlc 1.31.1 golangci-lint 2.10.1 rust 1.90这意味着你不需要手动逐个安装这些工具——mise 会自动下载并切换到正确版本。而 PostgreSQL、pgvector、server、channel、web 等运行时服务则全部通过 Docker Compose 编排见 devenv/docker-compose.yml开发环境与宿主机环境完全隔离。二、开始搭建前的准备工作安装 Docker需要带 Compose 插件的 Docker Desktop或 Linux 下的 Docker Engine。安装 mise在项目根目录执行官方安装命令curl https://mise.run | sh拉取代码含子模块UI 库packages/ui以子模块形式存在git clone --recurse-submodules https://gitcode.com/gh_mirrors/me/Memoh cd Memoh 完整开发说明可查阅 docs/development.md所有mise run任务都定义在根目录 mise.toml 中。三、快速搭建四条命令启动 Memoh 开发环境1. 安装工具链mise installmise 会读取 mise.toml 并下载 Go、Node、pnpm、Rust 等全部依赖版本。2. 初始化项目mise run setup该任务会自动执行依赖初始化见 mise.toml 的tasks.setup定义运行pnpm install安装前端依赖自动先初始化子模块执行go mod download下载 Go 依赖运行sqlc-generate根据 db/postgres/queries/ 中的 SQL 重新生成数据库访问代码3. 启动开发环境mise run dev首次运行会自动构建并导出 workspace 镜像Agent 沙箱容器镜像然后由 scripts/dev-compose.sh 拉起整套容器化服务。4. 打开浏览器服务就绪后访问开发版 Web 界面http://localhost:18082Server APIhttp://localhost:18080四、看懂开发环境的容器化服务mise run dev实际加载的是 devenv/docker-compose.yml各服务分工与端口如下服务作用宿主机端口postgres主数据库PostgreSQL 1815432pgvector向量数据库Agent 长期记忆15433migrate启动时自动执行数据库迁移—server核心后端Go使用air 热重载改代码即重编译18080channel消息渠道进程Telegram、Discord 等18081webVue 前端Vite 开发服务器带 HMR18082connect-it连接器网关凭据托管18421开发配置来自 devenv/app.dev.tomlGo 模块缓存与构建缓存都放在 Docker 卷里二次启动速度会明显加快。五、常用 mise 任务命令速查命令用途mise run dev启动开发环境全部服务mise run dev:down停止开发环境mise run dev:logs实时查看服务日志mise run dev:restart -- server重启单个服务mise run dev:selinux在 SELinux 系统上启动mise run lint/lint:fix运行 Go ESLint 检查含自动修复mise run db-up初始化并迁移数据库mise run sqlc-generate修改 SQL 后重新生成代码mise run swagger-generate重新生成 Swagger 接口文档mise run sdk-generate重新生成 TypeScript SDK六、如何验证环境搭建成功看端口http://localhost:18080/health返回健康检查通过说明 server 已就绪。看界面打开http://localhost:18082能看到会话列表与聊天面板即前端代理与后端已打通。看配置页进入 Bot 的 MCP 设置页可以测试host.docker.internal等容器网络端点连通性这是排查开发网络问题的直观手段。七、常见问题排查SELinux 系统挂载失败改用mise run dev:selinux它叠加加载 devenv/docker-compose.selinux.yml 处理目录上下文。启动缓慢首次dev需要构建 workspace 镜像约 1GB 级别导入可用mise run dev:workspace-image:rebuild强制刷新输入未变化时会自动跳过。日志排查mise run dev:logs跟踪全部服务怀疑单服务问题时用mise run dev:restart -- 服务名。数据库重置mise run db-down删除数据库mise run db-up重建并迁移。八、从开发环境到生产部署开发环境验证完成后生产部署使用根目录的 docker-compose.yml服务为 postgres、pgvector、migrate、server、channel、web访问地址http://localhost:8082并支持docker/docker-compose.cn.yml等国内镜像加速方案详见 DEPLOYMENT.md 与 docker/docker-compose.yml。总结搭建 Memoh 开发者环境的核心流程可以浓缩为一句话装好 mise 与 Docker克隆仓库后依次执行mise install→mise run setup→mise run dev即可在localhost:18082得到一个带热重载、数据库自动迁移、Agent 沙箱镜像齐备的完整开发环境。祝开发顺利 【免费下载链接】Memoh✨ The open-source multi-agent platform. Every agent gets its own computer, desktop, network, and long-term memory. You can bring your own key, or host your coding agent like Claude Code, Codex and so on.项目地址: https://gitcode.com/gh_mirrors/me/Memoh创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表