feat: add Chinese UI, Responses models, and mirrored Windows setup
Localize the web console and persist custom model and capability settings. Use OpenAI Responses exclusively and move runtime limits into environment configuration. Bootstrap uv and the virtual environment on Windows, support optional China mirrors, and package source distributions without environments, build output, or credentials. Update regression tests and repository quality checks for the new behavior.
This commit is contained in:
chenmingxuan committed
1 parent
371aa6df56
commit
2ddec53954
183 files changed
+3427
-11857
No files matched your search
+66
-1
@@ -20,7 +20,7 @@
|
||||
<a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/Python-3.12+-3776AB.svg?logo=python&logoColor=white" alt="Python 3.12+"></a>
|
||||
<a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License: Apache-2.0"></a>
|
||||
<a href="https://modelcontextprotocol.io/"><img src="https://img.shields.io/badge/MCP-Native%20Server-8A2BE2.svg" alt="MCP Native"></a>
|
||||
<a href="https://ai.google.dev/"><img src="https://img.shields.io/badge/Multimodal-Gemini%20%7C%20Claude%20%7C%20GPT--4o%20%7C%20Qwen--VL-4285F4.svg" alt="Multi-Model"></a>
|
||||
<a href="https://developers.openai.com/api/docs/guides/responses"><img src="https://img.shields.io/badge/API-OpenAI%20Responses-4285F4.svg" alt="OpenAI Responses"></a>
|
||||
<a href="https://github.com/google-research/android_world"><img src="https://img.shields.io/badge/AndroidWorld-99%25%2B%20SOTA-success.svg" alt="AndroidWorld SOTA"></a>
|
||||
</p>
|
||||
|
||||
@@ -104,8 +104,73 @@ cd artemis
|
||||
|
||||
> PowerShell 默认不会从当前目录查找可执行脚本，因此必须使用 `.\start.bat`，且命令末尾不要添加 `\`。如果使用传统命令提示符（CMD），则运行 `start.bat`。
|
||||
|
||||
首次启动会检测 uv：已有则复用，缺少则从 Astral 官方安装。随后检查项目 `.venv`，缺少时自动安装所需的 Python 3.12 并创建环境；已有且满足 Python 3.12+ 要求的环境直接复用。依赖与 `uv.lock` 一致时跳过安装，否则只同步缺失或变化的依赖，保留已有开发工具。安装失败会停止启动并显示原因，不会删除已有环境。
|
||||
|
||||
国内网络可直接双击 **`start-cn.bat`**，或在 PowerShell 中运行：
|
||||
|
||||
```powershell
|
||||
.\start-cn.bat
|
||||
# 仅安装 Python 环境，也支持镜像模式
|
||||
.\start-cn.bat -SetupOnly
|
||||
# 与上面的入口等价
|
||||
.\start.bat -Mirror China
|
||||
# 本次使用官方源
|
||||
.\start.bat -Mirror Official
|
||||
```
|
||||
|
||||
下载配置位于 `config/downloads.json`。将 `mode` 改成 `China` 后，普通 `start.bat` 也默认使用国内源；命令行 `-Mirror` 优先。`timeout_seconds` 控制下载超时（默认 180 秒，范围 10～3600 秒）。国内模式使用：
|
||||
|
||||
| 组件 | 下载来源 |
|
||||
| --- | --- |
|
||||
| uv 与 Python 依赖 | 清华 PyPI 镜像；uv 直接从 wheel 提取并校验 SHA256，无需预装 Python |
|
||||
| Python 运行时 | 南京大学 python-build-standalone 镜像 |
|
||||
| Node.js 与 npm 包 | npmmirror |
|
||||
| ADB | 腾讯 Android SDK 镜像 |
|
||||
| FFmpeg | `imageio-ffmpeg` Python 包附带的程序 |
|
||||
| scrcpy | 默认仍使用 GitHub 官方发布，可用下述配置替换 |
|
||||
|
||||
镜像模式从 `uv.lock` 导出固定版本和哈希，再通过所选索引安装，避免锁文件中的官方直链绕过镜像；不会改写锁文件或升级已锁定版本。npm 使用本次启动进程的 registry 配置。所有设置仅影响当前启动进程，不修改用户全局 pip、uv、npm 或 nvm 配置。已有 `UV_DEFAULT_INDEX`（或 `UV_INDEX_URL`）、`UV_PYTHON_INSTALL_MIRROR`、`npm_config_registry` 环境变量优先。
|
||||
|
||||
需要公司内网源或替换不可用镜像时，在 `config/downloads.json` 的 `overrides` 中填写对应 HTTPS 地址；空字符串表示使用所选模式的默认值。`python_index` 是以 `/simple` 结尾的索引，`python_download_mirror` 是 Python 发布目录，`node_mirror` 是包含版本子目录的 Node.js 下载根路径，`adb_url` 和 `scrcpy_url` 是可直接下载的 Windows ZIP 地址。scrcpy 暂无内置国内镜像，GitHub 不可达时请配置可信的 `scrcpy_url` 或预先安装 scrcpy。`uv_installer_url` 只用于没有设置 Python 镜像时的 PowerShell 安装器路径。镜像缺包或下载失败会显示错误；修正地址后重试即可，不会静默切换到官方源。
|
||||
|
||||
镜像说明参考：[清华 PyPI](https://mirrors.tuna.tsinghua.edu.cn/help/pypi/)、[uv 下载镜像配置](https://docs.astral.sh/uv/reference/environment/#uv_python_install_mirror)。
|
||||
|
||||
也可先单独准备 Python 环境，不启动页面、不安装设备工具、不配置 MCP：
|
||||
|
||||
```powershell
|
||||
.\start.bat -SetupOnly
|
||||
# 环境准备好后正常启动
|
||||
.\start.bat
|
||||
# 可选：指定端口、不自动打开浏览器
|
||||
.\start.bat -Port 8001 -NoOpen
|
||||
```
|
||||
|
||||
源码压缩包不携带 `.venv`、`node_modules`、前端编译结果或 APK。解压到可写目录后运行 `start.bat`，首次完整启动会安装所需 Node.js/npm 并构建网页，需要联网；已有构建时跳过。`.env` 不存在时才从 `.env.example` 创建，已有配置不会覆盖。Android 辅助 APK 的源码位于 `packages/artemis-accessibility-helper`，需要该功能时按该目录的构建脚本生成。
|
||||
|
||||
重新打源码包可运行 `uv run --no-sync python scripts/package_source.py`，输出到 `artifacts/`；脚本会排除本地密钥、运行数据、缓存、依赖目录与编译产物，并检查 ZIP 完整性。
|
||||
|
||||
> **提示**：启动后将自动在默认浏览器中打开 Web 控制台（`http://localhost:8000`），提供设备连接向导、实时投屏、任务演练与状态回放面板。你也可以通过命令行直接运行：`uv run artemis run "打开系统设置，找到电池选项并告诉我当前电量" --profile flash`。
|
||||
|
||||
### 网页模型配置与功能开关
|
||||
|
||||
Web 控制台使用简体中文。在首页打开「系统设置与运行准备」，可以修改接口地址、模型名称、API Key、请求超时和重试次数。点击「测试连接」会使用当前表单发送一次真实的 Responses 请求；点击「保存配置」才会写入工作目录的 `.env`。密钥留空会保留现有值，网页不会读取或显示已有密钥。
|
||||
|
||||
所有模型调用统一使用 **OpenAI Responses API**，不再提供 Gemini、Anthropic 或 Chat Completions 调用路径。自定义网关必须实现 `/responses`，接口地址填写根地址（通常以 `/v1` 结尾）。例如：
|
||||
|
||||
```dotenv
|
||||
OPENAI_API_KEY=你的密钥
|
||||
OPENAI_BASE_URL=https://你的网关/v1
|
||||
OPENAI_MODEL=mimo-v2.6-flash
|
||||
OPENAI_TIMEOUT_SECONDS=120
|
||||
OPENAI_MAX_RETRIES=0
|
||||
```
|
||||
|
||||
「功能开关」提供视频分析与录屏、最终报告生成、Flash 步骤摘要压缩，可分别保存。设置对**新任务**生效，重启后保留。环境变量优先于 `.env`；在网页保存时会同时更新当前服务进程的配置，服务的启动环境若显式定义了同名变量，后续重启仍以启动环境为准。手动配置的节点模型或任务级选项优先于全局默认值。
|
||||
|
||||
视频分析通过抽取画面帧调用模型，因此需要支持图片输入的模型。`mimo-v2.6-flash` 已验证文本、图片、工具调用、流式输出及结构化函数调用；对于不支持 `json_schema` 的网关，结构化结果使用 Responses 函数调用并在本地校验。音频输入是否可用取决于端点能力，拒绝音频时视频分析会尝试仅分析画面。
|
||||
|
||||
视频分段时长、分析超时、检查点超时等配置及单位见 [`.env.example`](.env.example)。可选 Cloud Vision OCR 独立于模型调用，未配置 OCR 密钥也可运行。
|
||||
|
||||
<a id="mcp-setup"></a>
|
||||
<a id="mcp"></a>
|
||||
<details>
|
||||
|
||||
Reference in new issue
Block a user