You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* docs: rewrite Beginner cookbook with step-by-step self-guided flow
- Replace Hub-centric 'run the samples' approach with self-guided
'write-your-own' flow: Client → Upgrade → Tools → Server → verify
- Add bilibili video embed (BV12P9dBiEEh) and ASCII update flow diagram
- Client code: only 3 secrets in UpdateRequest — all identity fields
(MainAppName, ClientVersion, UpdateAppName, etc.) are auto-discovered
by AppMetadataDiscoverer from generalupdate.manifest.json
- Upgrade code: AppType.Upgrade, no SetConfig — params via encrypted IPC
- Phase 4 (Tools): use Config tab, not Patch tab; steps match actual UI
(.csproj path → Analyze → Generate Sample)
- Fix directory structure: Upgrade.exe lives in update/ subdirectory per
manifest's updatePath, not alongside Client
- Manifest JSON example reflects actual ManifestInfo field names and
omits secrets (they belong in code)
- Sync all three locales: zh (default), zh-Hans, en
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* fix: replace react-player import with bilibili iframe embed
react-player is not a project dependency, causing Docusaurus build
to fail with 'Module not found'. Use bilibili's native iframe embed
instead, which requires no extra npm package.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* fix: address Copilot review — diagram endpoint path and curl -X POST
- ASCII diagram: POST /Verification -> POST /Upgrade/Verification
- Troubleshooting table: add missing -X POST to curl command
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: remove 部署与运维 (Deployment & Operations) guide section
Delete the guide directory and its three locale files. Remove the
autogenerated category from sidebars.js. Fix dangling links in
Bowl, Differential, and Extension component docs across all locales.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: component table cleanup, cookbook UAC notes, contact page, i18n fixes
- Remove 返回值 (return value) column from instance method tables in all 5
component docs (Core, Differential, Drivelution, Bowl, Extension) across
default zh-Hans and zh-Hans i18n versions
- Add installation directory UAC/permission notes to Beginner cookbook in
all 3 locales (zh-Hans default, zh-Hans i18n, en i18n)
- Create /contact page with QQ group (748744489) and email contact info,
supporting both Chinese and English
- Add '联系方式 / Contact' navbar item on the right side
- Fix homepage to respect locale: translate hero subtitle, feature cards,
tech stack title, and page meta to English when viewing in en mode
- Fix homepage CTA button (开始探索 / Get Started) to link to cookbook
instead of GeneralSpacestation
- Translate 2026-05-20 releaselog entry from Chinese to English in en i18n
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: website/i18n/en/docusaurus-plugin-content-docs/current/quickstart/Beginner cookbook.md
+19-1Lines changed: 19 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -373,8 +373,26 @@ After this flow works, read these pages in order:
373
373
3.[GeneralUpdate.Bowl](../doc/GeneralUpdate.Bowl): crash monitoring, backup, and failure recovery
374
374
4.[GeneralUpdate.Tools](./GeneralUpdate.PacketTool): complete guides for patches, hashes, OSS config, and simulation
375
375
376
-
## Sample repositories
376
+
## Installation directory notes
377
+
378
+
The update process requires read/write access to the application directory. To avoid Windows UAC (User Account Control) prompts, install your application in one of the following non-system-protected directories:
379
+
380
+
| Recommended directory | Example path |
381
+
| --- | --- |
382
+
| User AppData (recommended) |`C:\Users\<username>\AppData\Local\<YourApp>\`|
383
+
| User home directory |`C:\Users\<username>\<YourApp>\`|
384
+
| Custom non-system drive |`D:\<YourApp>\`|
377
385
386
+
**Not recommended:**
387
+
388
+
-`C:\Program Files\` — requires administrator privileges to write
389
+
-`C:\Program Files (x86)\` — requires administrator privileges to write
390
+
-`C:\Windows\` — system directory, write-protected
391
+
- System drive root (e.g. `C:\`) — may trigger permission restrictions
392
+
393
+
> **Tip**: If you encounter "Access Denied" or UAC prompts during updates, check whether the application is installed in a non-recommended directory. Moving the application to a user directory usually resolves the issue.
-**GeneralUpdate.Core**: Unified`GeneralUpdateBootstrap`entry point, merging original ClientCore and Core capabilities; added `SetSource()`lightweight config entry and `generalupdate.manifest.json`minimal setup; refactored download subsystem into replaceable 5-layer model (Source/Policy/Executor/Pipeline/Orchestrator); extension points increased to 10 replaceable interfaces
13
+
-**GeneralUpdate.Bowl**: `BowlContext`configuration API stabilized; optimized Windows/Linux/macOS ProcDump integration
0 commit comments