mnemo/argot-server

Mnemosyne 镜像文档

镜像概述

Mnemosyne 是一款专注于软件开发领域的自动化助手镜像，旨在通过自动化工具链辅助开发者完成从代码生成、任务调度到流程优化的全链路开发工作。该镜像集成了多种开发辅助功能，可作为独立工具或与现有开发环境集成，帮助开发者减少重复劳动，聚焦核心业务逻辑实现。

核心功能与特性

• 自动化代码生成：支持基于需求描述、模板或现有代码结构自动生成基础代码片段，降低手动编码工作量
• 开发任务自动化：可配置自动化执行代码格式化、静态检查、单元测试等重复性开发任务
• 流程辅助：提供开发流程指引、最佳实践提示及常见问题解决方案，辅助规范开发过程
• 轻量级集成：支持与主流 IDE、版本控制系统及 CI/CD 工具集成，适配多种开发环境
• 可定制配置：允许通过配置文件或环境变量自定义自动化规则，满足不同项目需求

使用场景

• 个人开发者：辅助独立开发时的代码编写、测试及优化工作，提升个人开发效率
• 小型开发团队：统一开发规范，自动化执行团队级代码检查与测试流程，减少协作成本
• 快速原型开发：快速生成基础代码架构，加速原型验证与迭代过程
• 学习与教学：作为开发辅助工具，帮助新手开发者理解开发流程与最佳实践

使用方法

基本运行方式

通过 Docker 命令直接启动 Mnemosyne 助手：

bash
docker run -it --name mnemosyne-assistant docker.xuanyuan.run/mnemosyne:latest

挂载本地项目目录

如需辅助本地项目开发，可挂载项目目录至容器内：

bash
docker run -it -v /path/to/your/project:/app --name mnemosyne-project docker.xuanyuan.run/mnemosyne:latest

环境变量配置

可通过环境变量自定义 Mnemosyne 的行为：

• LOG_LEVEL：日志级别，可选值：debug、info、warn、error，默认 info
• AUTO_SAVE：是否自动保存生成的代码，可选值：true、false，默认 false
• LANGUAGE：默认代码生成语言，如 python、java、javascript 等，默认 python

示例：指定生成 JavaScript 代码并开启自动保存

bash
docker run -it -e LANGUAGE=javascript -e AUTO_SAVE=true -v /path/to/js/project:/app docker.xuanyuan.run/mnemosyne:latest

基础操作流程

1. 启动容器后，通过交互式命令行输入开发需求或任务指令
2. 助手根据指令执行相应操作（如代码生成、测试执行等）
3. 结果将输出至控制台，若开启 AUTO_SAVE，则自动保存至挂载的项目目录中
4. 通过 help 命令可查看支持的所有操作指令及使用说明

注意事项

• 首次运行时，镜像可能需要下载依赖组件，耗时稍长
• 敏感项目建议通过挂载方式使用，避免代码数据留存于容器内
• 复杂需求可能需要结合配置文件进行精细化设置，配置文件路径为 /app/.mnemosyne/config.yaml（需在挂载目录中创建）