environment.md

运行配置

唯一的本机配置文件：项目根目录 .env。新电脑复制 .env.example 后填写自己的配置。

配置项	用途
DEEPSEEK_API_KEY、CASE01_ETHAN_*	Ethan 的外部模型及凭据
CASE01_LLM_PROVIDER、CASE01_LLM_BASE_URL、CASE01_LLM_MODEL、CASE01_LLM_API_KEY	投资顾问的 Ollama / vLLM 模型路由
CASE01_EMBED_BASE_URL、CASE01_EMBED_MODEL	背景检索模型；空地址使用投资顾问地址
CASE01_OLLAMA_THINK、CASE01_LLM_DISABLE_THINKING、CASE01_LLM_REQUEST_TIMEOUT	思考模式及本地请求超时
OLLAMA_HOST、OLLAMA_MODELS、OLLAMA_EXECUTABLE	Ollama 监听地址、权重目录、程序路径
OLLAMA_CONTEXT_LENGTH、OLLAMA_NUM_PARALLEL、OLLAMA_MAX_LOADED_MODELS、OLLAMA_FLASH_ATTENTION、OLLAMA_KV_CACHE_TYPE	Ollama 资源参数
OPENVALUE_OLLAMA_AUTO_START	桌面启动时是否自动启动本机 Ollama；服务器设为 0
OPENVALUE_WEB_HOST、OPENVALUE_WEB_PORT	网站监听地址与端口
OPENVALUE_MAVIS_HOST、OPENVALUE_MAVIS_PORT、OPENVALUE_MAVIS_HOLD_SECONDS	实时 MAVIS 服务地址及保留时间
OPENVALUE_PLAYBACK_HOST、OPENVALUE_PLAYBACK_PORT	历史记录播放服务地址
OPENVALUE_EXTRA_ORIGINS	额外允许嵌入播放页面的完整 origin，以逗号分隔
OPENVALUE_MODEL_TUNNEL_PORT	云端私有 SSH 模型转发端口
OPENVALUE_DEPLOY_HOST、OPENVALUE_DEPLOY_USER、OPENVALUE_DEPLOY_SSH_PORT	私有服务器地址、SSH 用户名和端口
OPENVALUE_DEPLOY_PUBLIC_URL	部署后的公网访问地址及验收目标
OPENVALUE_DEPLOY_KNOWN_HOSTS	本机 SSH 主机指纹文件；默认 data/cloud/deployment_known_hosts
BASH_EXECUTABLE	发布包检查用 Bash；留空自动查找

网站和场景的 HOST 只允许回环地址，端口范围为 1–65535。配置错误会在启动时指出字段名称。 模型地址可指向远端服务；网页前端不能读取 .env 或密钥，只从后台获取场景地址。

读取顺序是 .env > 进程继承的环境变量 > app/web/environment.py 中统一的兼容默认值。 CASE01_LLM_* 是投资顾问路由的标准字段。旧 OPENVALUE_LOCAL_MODEL* 仅在标准字段缺失时兼容读取。 路径支持 ~ 和相对项目根目录的路径；程序路径留空时自动寻找安装位置。 空 CASE01_LLM_BASE_URL 使用 OLLAMA_HOST；空 Ethan URL/model 使用 MAVIS 上游 provider 默认值。

修改 .env 后重启网站后台，后续 MAVIS 子进程继承更新后的配置。 修改 Ollama 监听地址、权重目录或资源参数后，运行 scripts/models/configure_local_ollama.ps1 重启本机 Ollama。 该脚本只设置自己进程与子进程环境，不写 Windows 用户注册表。 下载与验证脚本同样读取 .env，仅在手动执行时下载或发起推理。

网页表单的场景、角色、提示词、资金及每轮采样参数继续按运行单独传入 MAVIS。 vendor/ 上游源码和历史验证报告中的旧路径不参与本机配置迁移。 实际 .env 及密钥不提交 Git，不打入部署包；可提交 .env.example。

服务器部署配置

部署与模型连接工具也读取根目录 .env。地址和用户名不设具体默认值；未填写时明确提示缺失字段。 .env.example 仅提供空字段，不包含实际服务器身份。SSH 密码继续在运行时交互输入，不保存。 SSH 主机指纹保存在 OPENVALUE_DEPLOY_KNOWN_HOSTS 指定的本地文件中，已加入 Git 忽略规则。 迁移保留已有主机指纹；部署包生成工具不再复制该文件。