docs(readme): add WebView2 runtime note

This commit is contained in:
apale7 2026-04-20 03:22:19 +08:00
parent 63f7de7cb6
commit b00ee4c8dc
3 changed files with 67 additions and 0 deletions

View File

@ -0,0 +1,53 @@
{
"id": "04-20-readme-webview2-note",
"name": "04-20-readme-webview2-note",
"title": "Add WebView2 runtime note to bilingual README",
"description": "Add Windows desktop runtime note to README.md and README_EN.md",
"status": "planning",
"dev_type": null,
"scope": null,
"package": null,
"priority": "P3",
"creator": "OpenCode",
"assignee": "OpenCode",
"createdAt": "2026-04-20",
"completedAt": null,
"branch": null,
"base_branch": "master",
"worktree_path": null,
"current_phase": 0,
"next_action": [
{
"phase": 1,
"action": "brainstorm"
},
{
"phase": 2,
"action": "research"
},
{
"phase": 3,
"action": "implement"
},
{
"phase": 4,
"action": "check"
},
{
"phase": 5,
"action": "update-spec"
},
{
"phase": 6,
"action": "record-session"
}
],
"commit": null,
"pr_url": null,
"subtasks": [],
"children": [],
"parent": null,
"relatedFiles": [],
"notes": "",
"meta": {}
}

View File

@ -87,6 +87,13 @@ Windows 下默认产物路径:
build/bin/ocswitch-desktop.exe
```
提示:
- Windows 11 一般已内置 WebView2 Runtime主流 Windows 10 设备通常也已经安装。
- `ocswitch-desktop.exe` 按单文件产物分发,不需要额外同目录依赖文件。
- 如果桌面应用在 Windows 上无法启动,常见原因之一是系统缺少 WebView2 Runtime这时请先安装 Microsoft Edge WebView2 Runtime 再重试:
https://developer.microsoft.com/microsoft-edge/webview2/
### 开发模式
如果你想本地调试桌面 GUI

View File

@ -55,6 +55,13 @@ On Windows, the default output path is:
build/bin/ocswitch-desktop.exe
```
Note:
- Windows 11 generally includes the WebView2 Runtime, and most mainstream Windows 10 devices already have it installed.
- `ocswitch-desktop.exe` is distributed as a single-file artifact and does not require extra sidecar files in the same directory.
- If the desktop app fails to start on Windows, one common cause is a missing WebView2 Runtime. Install the Microsoft Edge WebView2 Runtime and try again:
https://developer.microsoft.com/microsoft-edge/webview2/
### Development mode
To run the desktop GUI in local development mode: