基于 case01 金融投资场景的价值形成与专家治理演示平台。
双击根目录的 启动OpenValue.cmd，默认打开 http://127.0.0.1:8878/；实际地址读取根目录 .env。
当前 .env 中 Ollama 使用本机 11434 端口；本地投资顾问使用 qwen3:8b，背景检索使用 qwen3-embedding:0.6b-q8_0。
Ethan 使用已配置的外部模型。模型权重目录由 .env 的 OLLAMA_MODELS 指定；默认 ~/.ollama/models，不在本项目内。
| 目录 | 内容 |
|---|---|
app/web/ |
当前网站：前端页面、样式、Python 后台和 MAVIS 接口 |
vendor/mavis-platform/ |
MAVIS 平台 Git 子模块，对应 hellobs/provenance |
vendor/mavis-framework/ |
MAVIS 仿真框架 Git 子模块，对应 hellobs/mavis |
.env、.env.example |
本机私有运行配置、可提交的配置模板 |
config/ |
配置说明；不再保存另一套运行参数 |
data/website/ |
账号、治理数据库、配置提交及网站运行日志 |
data/mavis/ |
仿真记录、原始输出、检查点 |
data/cloud/、data/ollama/ |
连接状态及本地模型服务日志 |
scripts/deployment/ |
服务器上传、更新及模型连接工具 |
scripts/models/ |
本地模型配置、下载及检查工具 |
tests/ |
平台测试脚本 |
docs/ |
使用手册、检查报告及界面截图 |
releases/ |
当前已生成的部署包：独立部署及 Qwen 8B 连接版本 |
archive/ |
旧发布包、设计原稿、旧源码和一次性开发工具 |
.venv/ |
当前 Python 虚拟环境 |
.cache/ |
可再生成的工具缓存 |
常规开发修改 app/web；MAVIS 的 Git 更新在 vendor 对应仓库进行。
历史包归档于 archive/releases；它们不参与当前网站运行。
MAVIS 运行仅使用 vendor/mavis-platform 和 vendor/mavis-framework；仿真记录位于 data/mavis，模型密钥由项目根目录 .env 读取。
根目录 部署OpenValue到服务器.cmd 调用当前云端更新和 Qwen 8B 连接入口。
服务器地址、SSH 用户名、端口和公网访问地址读取根目录 .env 的 OPENVALUE_DEPLOY_* 字段。
执行时由你本人输入 SSH 密码，连接窗口需要保持打开；主机指纹仅保存在本机 data/cloud。
仅连接模型可运行 scripts/deployment/ConnectOpenValueQwen8B.cmd；仅更新网站可运行 scripts/deployment/UpdateOpenValueLatest.cmd。
本次目录整理没有上传服务器，也没有发起模型模拟。
现有 .venv 已可用。需要重建环境时使用 Python 3.12，并在根目录执行：
python -m venv .venv --system-site-packages
.\.venv\Scripts\python.exe -m pip install -r requirements-dev.txt
.\.venv\Scripts\python.exe -m pytest tests/test_configured_mavis.py tests/test_model_routing.py tests/test_local_ollama_runtime.py tests/test_cloud_advisor_bridge.py -q网站账号及治理数据位于 data/website/，MAVIS 记录位于 data/mavis/runs/ 和 data/mavis/raw/。
Python 虚拟环境直接引用 vendor/ 源码；测试临时文件位于 .cache/tests/。
原 C 盘任务目录只保留普通启动脚本，脚本直接调用本项目的真实入口。
DeepSeek 密钥保存在项目根目录的 .env，字段为 DEEPSEEK_API_KEY。
后端启动时按项目真实路径读取该文件，MAVIS 子进程继承配置；修改后需重启后端。
本机 .env 的字段优先于继承的环境变量。没有 .env 时保留服务器已有的环境配置。
模型名称、服务端口、程序和权重目录等参数均在 .env 配置，字段说明见 运行配置。
新建配置可复制 .env.example；实际 .env、其备份及变体不提交 Git，也不进入部署包。
主项目通过 .gitmodules 和两个 gitlink 记录 MAVIS 的远端地址与指定提交，不把上游源码复制进主仓库历史。
首次克隆时使用：
git clone --recurse-submodules git@github.com:hellobs/OpenValue.git已有主项目时，在项目根目录执行：
git pull --recurse-submodules
git submodule update --init --recursive这些操作会同步主项目指定的 MAVIS 版本。开发者要主动更新到上游新版本时，执行：
git submodule update --remote -- vendor/mavis-platform vendor/mavis-framework
git add vendor/mavis-platform vendor/mavis-framework
git commit -m "Update MAVIS submodules"测试通过后推送主项目，其他人拉取即可使用相同依赖版本。如果修改了 MAVIS 源码，应先向对应上游仓库提交并推送，再提交主项目中的子模块指针。
实际 .env、模型权重、运行数据和本地虚拟环境均保持忽略，.env.example 可提交。