# 观澜·如东样板 v2 — Windows 离线安装 # 用法: powershell -ExecutionPolicy Bypass -File install.ps1 # ... -File install.ps1 -Python "C:\Python312\python.exe" # 多版本机器指定 # ... -File install.ps1 -UseBundledPython # 强制用包内便携运行时 # # 编码约定 (2026-09-10, 同事 xzy 实机报 ParserError 后定): 本文件必须存成 **UTF-8 带 BOM + CRLF**。 # Windows PowerShell 5.1 对没有 BOM 的 .ps1 按 ANSI 代码页 (中文机 = GBK) 解码, 文件里的中文会被 # 错读, 相邻的转义反引号可能被一起吞掉 → 引号不配对 → 级联 ParserError (报在看起来没问题的行上)。 # install.bat 里的 chcp 65001 管不了这件事 (它改的是控制台代码页, 不是脚本文件的解码方式)。 # 另: 本文件**不再使用** 形如 & cmd /c "\"$exe\" -m pip ..." 的嵌套引号写法 —— 一旦有字节被吃掉就崩; 改用 # PowerShell 原生调用 & $exe arg1 arg2, 不需要任何引号转义。 param([string]$Python = "", [switch]$UseBundledPython, [switch]$SkipOllama) $ErrorActionPreference = "Stop"; $env:PYTHONUTF8 = "1" Set-Location $PSScriptRoot function Say($m){ Write-Host $m } Say "== 1/5 选 Python (需 3.11+; 本项目依赖 pandas 3, 3.10 及以下没有轮子)" $py = $null if ($Python) { $py = $Python } elseif (-not $UseBundledPython) { # 列出机器上所有 Python, 选第一个 >=3.11 (多版本共存时不猜, 打印出来让人看见) $cands = @() foreach ($c in @("py -3.13","py -3.12","py -3.11","python","python3")) { $exe, $arg = $c.Split(" ", 2) try { $v = if ($arg) { & $exe $arg -c "import sys;print('%d.%d'%sys.version_info[:2])" 2>$null } else { & $exe -c "import sys;print('%d.%d'%sys.version_info[:2])" 2>$null } if ($LASTEXITCODE -eq 0 -and $v) { $cands += [pscustomobject]@{cmd=$c; exe=$exe; arg=$arg; ver=$v} } } catch {} } if ($cands) { Say (" 机器上的 Python: " + (($cands | ForEach-Object { "$($_.cmd)=$($_.ver)" }) -join ", ")) } $ok = $cands | Where-Object { [version]$_.ver -ge [version]"3.11" } | Select-Object -First 1 if ($ok) { $py = $ok } } if (-not $py) { $rt = Get-ChildItem "vendor\python\cpython-3.12*windows*.tar.gz" -ErrorAction SilentlyContinue | Select-Object -First 1 if ($rt) { Say " 系统无 3.11+, 解包内便携运行时: $($rt.Name)" if (Test-Path runtime) { Remove-Item runtime -Recurse -Force } New-Item -ItemType Directory runtime | Out-Null tar -xzf $rt.FullName -C runtime # Windows 10 1803+ 自带 tar $py = [pscustomobject]@{ exe = (Resolve-Path "runtime\python\python.exe").Path; arg = "" } } else { Say " X 没有 3.11+ 的 Python, 包内也没有便携运行时。" Say " 办法一: 装 https://www.python.org/downloads/windows/ 的 3.12.x (勾 Add to PATH)" Say " 办法二: -Python C:\路径\python.exe 指定" exit 2 } } elseif ($py -is [string]) { $py = [pscustomobject]@{ exe = $py; arg = "" } } Say " 使用: $($py.exe) $($py.arg)" Say "== 2/5 建虚拟环境 .venv" if ($py.arg) { & $py.exe $py.arg -m venv .venv } else { & $py.exe -m venv .venv } $vpy = (Resolve-Path ".\.venv\Scripts\python.exe").Path & $vpy -m pip install --upgrade pip --quiet Say "== 3/5 装依赖 (优先包内离线轮子 wheels\win_amd64)" if (Test-Path ".\wheels\win_amd64") { & $vpy -m pip install --no-index --find-links .\wheels\win_amd64 -r requirements.txt } else { Say " 包内无轮子, 改为联网安装"; & $vpy -m pip install -r requirements.txt } if ($LASTEXITCODE -ne 0) { Say " X 依赖安装失败 (上面有 pip 的报错) —— 先解决它, 别接着跑 start.bat"; exit 3 } Say "== 4/5 写配置" # 别改回 Get-Content / Set-Content -Encoding UTF8 (2026-09-10 实机踩过): # PS 5.1 的 Get-Content 把无 BOM 的 UTF-8 当 ANSI(GBK) 解码 -> 中文注释变乱码; # Set-Content -Encoding UTF8 又写出 BOM -> Python 侧用裸 utf-8 json.loads 直接 JSONDecodeError。 # 交给 venv 里的 Python 读写: 读 utf-8-sig (有 BOM 也认), 写无 BOM 的 UTF-8。 # 下面 Python 代码故意只用单引号, 避开 PS 5.1 传参时的引号转义坑。 $cfgFix = @' import json, pathlib, sys p = pathlib.Path('configs/serve.json') c = json.loads(p.read_text(encoding='utf-8-sig')) c['python'] = sys.executable p.write_text(json.dumps(c, ensure_ascii=False, indent=2) + '\n', encoding='utf-8') print(' configs/serve.json -> ' + sys.executable) '@ & $vpy -c $cfgFix if ($LASTEXITCODE -ne 0) { Say " X 写 configs\serve.json 失败"; exit 4 } Say "== 5/5 Ollama (只影响问答与本地审核; 其余页面不受影响)" if (-not $SkipOllama) { $has = Get-Command ollama -ErrorAction SilentlyContinue if ($has) { Say " 已安装: $(& ollama -v 2>&1 | Select-Object -First 1)" } elseif (Test-Path "vendor\ollama\OllamaSetup.exe") { Say " 包内有离线安装包, 现在静默安装 (约 1.5 GB, 需几分钟)…" Start-Process -FilePath "vendor\ollama\OllamaSetup.exe" -ArgumentList "/SILENT" -Wait Say " 安装完成; 模型请把有网机器的 %USERPROFILE%\.ollama\models 整个目录拷到本机同位置" } else { Say " 未装且包内无离线包: 问答不可用。装法见 说明书 §5" } } Say "" & $vpy guanlan.py check Say "" Say "安装完成. 启动: start.bat 停止: stop.bat 自检: check.bat 入口: http://127.0.0.1:28084/"