Alternative Installation Methods: UnionTech UOS, Galaxy Kylin, and Historical Versions
This page covers the two alternative routes to the 1.2 main installation flow: store installation on UnionTech UOS and Galaxy Kylin V10, and WorkBuddy historical version downloads (direct links from the official archive page). About 6 minutes of reading.
Each route solves a different group of users:
- Xinchuang computer users: the computer issued by your employer runs UnionTech UOS / Galaxy Kylin, and the official download page only offers Windows and Mac packages
- People who need older versions: wanting to roll back after a problem with the new version, aligning versions across several computers, or trying to reproduce a specific version's behavior
If you're on the latest Windows / Mac version and have never had issues, you can skip this page entirely and go straight to 1.4 the first task.
What You'll Be Able to Do After This
- On a computer running UnionTech UOS or Galaxy Kylin V10, install WorkBuddy using the system's built-in app store and sign in by scanning the WeChat QR code
- Explain how the store version differs from the official website version in terms of upgrades: the store version's "Check for Updates" guides you back to the store instead of the client upgrading automatically
- Complete a WorkBuddy historical version download: locate a specific version on the official archive page and pick the right one of the three packages—macOS Apple Silicon / Intel / Windows
- Remember the two feature version requirements—network proxy switching requires 5.3.0 and later, and the WeChat assistant / WeCom assistant requires 4.6.4 and later—so you know what to expect when choosing an older version
- Recognize the domains of official download direct links (Tencent Cloud COS and download.codebuddy.cn) and stop being misled by third-party download sites
Your Current Predicament
- My work computer runs UnionTech UOS or Galaxy Kylin, and the official download page only offers Windows and Mac packages—does that mean I can't use WorkBuddy?
- The new version doesn't feel right after updating, and I want to roll back to the previous one, but searching "WorkBuddy old version" only turns up third-party download sites I don't dare click
- I finally found the old version download list, but each row has three packages—darwin-arm64, darwin-x64, win32-x64—which one is actually mine?
When to Use This Approach
When you need to:
- Install WorkBuddy on a Xinchuang computer running UnionTech UOS or Galaxy Kylin V10
- Install a specific historical version: rolling back to troubleshoot, aligning versions across multiple machines, or reproducing a specific version's behavior
And you don't want to:
- Get installer packages from sketchy third-party download sites
- Force-fit Xinchuang system installation into the Windows .exe / Mac .dmg process
- Dig through cloud-drive repost threads just to find one old version
🎒 Preparation Before You Start
- You've finished reading 1.2 Installation: The Main Flow for Windows and Mac—this page only covers alternative routes; the official main flow is on that page
- Xinchuang system users: you can name your system (UnionTech UOS / Galaxy Kylin V10) and CPU architecture (x86_64 or ARM64; Step 1 helps you verify)
- A WeChat account that can scan QR codes (login is primarily via WeChat QR code; phone number / email / SSO are also supported)
- Historical version users: know exactly which version number you want (Steps 5 and 6 help you verify platform and requirements)
- Disk space: installer packages range from just over a hundred MB to over five hundred MB (v5.9.3: Apple Silicon 356.1 MB / Intel 384.5 MB / Windows 429.3 MB)
- 6 minutes of reading time
Core Idea
Alternative installation = switching channels, not switching workflows. After installation, login and everyday use are exactly the same as on Windows / Mac; only two things truly differ: where the installer comes from, and how upgrades work.
| Your Situation | Installation Channel | Upgrade Method |
|---|---|---|
| Windows / Mac latest version (previous page) | Official website "Download Now" | The client downloads and completes the upgrade automatically |
| UnionTech UOS | The system's built-in App Store | Check for updates → guided to the App Store to update |
| Kylin OS V10 | Software Store in the taskbar | Check for updates → guided to the Software Store to update |
| Specify a historical version (Win / Mac) | Direct link to the official historical version archive page | Manual download and manual install; the client's check for updates can upgrade you back to the new version |
💡 The official stance on old versions
The official archive page states: "To ensure the latest product experience, we recommend downloading the latest version of WorkBuddy from the official website." The direct links to historical versions are an official fallback channel, not a reason to stay on an old version long-term.
Before choosing an old version, let's lay out the version thresholds for two features first, so you don't discover a feature mismatch after installing:
| Feature | Version threshold | Official basis |
|---|---|---|
| Network proxy switching (often needed on corporate networks) | 5.3.0 and later | Official error code documentation: "WorkBuddy internally, from version 5.3.0 onward, has a built-in network proxy switching feature" |
| WeChat Assistant / WeCom Assistant and other remote channels | 4.6.4 and later | Prerequisites table in the official assistant configuration guide: install WorkBuddy >= 4.6.4 |
Good news: the official archive goes back as far as v4.8.1 (released 2026-04-04), and every version in the archive meets the 4.6.4 threshold.
Follow along with me
Step 1: Confirm your system version and CPU architecture (Xinchuang system users)
Why: The official installation guides for both UnionTech UOS and Kylin OS include the same note—"Systems that do not meet the above requirements will fail to launch WorkBuddy." Spend 30 seconds checking now so the install isn't wasted.
| System | Official environment requirements |
|---|---|
| UnionTech UOS | UnionTech UOS Desktop Operating System; supports x86_64 (amd64) and ARM64 architectures |
| Kylin OS | Kylin OS Desktop Operating System V10; supports x86_64 (amd64) and ARM64 architectures |
Both x86_64 and ARM64 architectures are supported. The official docs also note: the specific supported system versions are subject to the current release notes—if in doubt, go by whether WorkBuddy is searchable in the store (verified in step 2).
You should see: Your system and architecture fall within the ranges in the table above.
- I have confirmed my system (UOS / Kylin V10) and architecture (x86_64 / ARM64)
Step 2: Install WorkBuddy from the system app store (UnionTech UOS / Kylin OS)
Why: The official installation method for these two systems is the system store—UOS uses the App Store, Kylin uses the Software Store. There is no .exe / .dmg, and no command line.
Method A: UnionTech UOS
- Open the system's built-in App Store
- Type WorkBuddy in the search box at the top and search
- Go to the WorkBuddy detail page and click Install
- Wait for the installation to finish; once the button changes to "Open", click it to launch
You should see: The WorkBuddy client launches and the login screen appears.
Method B: Kylin OS V10
- Click the Software Store icon in the taskbar to open the Software Store
- Type WorkBuddy in the search box at the top and find WorkBuddy in the search results
- Go to the detail page and click Install
- Wait for the installation to finish; once the button changes to "Open", click it to launch
You should see: Same as above—the client launches and enters the login screen.
- WorkBuddy is searchable in the store, and the install button has gone through "Install → Open"
For detailed steps, see the official docs: UnionTech UOS Installation Guide, Kylin OS Installation Guide.
Step 3: Launch and log in by scanning the WeChat QR code
Why: The login flow is identical to Windows / Mac. All four official installation guides (Windows / Mac / UnionTech UOS / Kylin OS) describe the same set of steps, so here's a quick run-through.
- Launch WorkBuddy and click the login button
- The browser automatically opens the login page on the official site workbuddy.cn
- In the login popup, check the Terms of Service and Privacy Policy
- Scan the QR code with WeChat to complete login; phone number, email, SSO, and other methods are also supported
- Once the page shows the login succeeded, return to the client to start using it
The entire login process takes place in the current web page, with no redirects. To switch the interface language: avatar at the bottom left → Settings → General → Language.
You should see: The client enters the main interface and is no longer on the login page.
- WeChat QR code scan succeeded and the client displayed the main interface
If the browser fails to open after clicking login, the login fails, or the client doesn't respond, don't retry endlessly—the official FAQ lists three common causes (default browser not set, insufficient permissions on the account folder, security software blocking). For a step-by-step check, see 1.3 What to do if it won't install.
Step 4: How the store version upgrades—"Check for updates" will guide you back to the store
Why: This is the biggest difference between the store version and the website version. The website version's check for updates will "automatically download and complete the upgrade"; whereas the official UOS / Kylin guides state—if a new version exists, you will be guided to the App Store (Kylin: Software Store) to complete the update.
Steps:
- Click the avatar at the bottom left → Check for updates
- If you're already on the latest version, no action is needed
- If a new version exists, follow the guidance to the App Store / Software Store to complete the update
You should see: A "You're on the latest version" notice, or being smoothly guided to the store to complete the update.
(Windows / Mac users who installed from a historical version package: upgrades go through the client's automatic update, see 1.2 Step 6.)
Step 5: Find the official direct links for WorkBuddy historical version downloads
Why: The official documentation site maintains a "Historical Version Downloads" archive page—an archive of installation packages for officially released versions, each providing macOS (Apple silicon / Intel) and Windows packages, with all download links verified as working. Old versions have an official source, so there's no need to touch third-party download sites.
Steps:
- Open the official archive page: workbuddy.cn/docs/workbuddy/Download-History
- The page groups versions by second-level version number (5.9.x, 5.8.x… up to 4.8.x, 17 series in total), sorted within each group by release date in descending order
- Official search tip: use your browser's in-page find (Mac ⌘F / Windows Ctrl+F) and type a version number to quickly locate the target row
💡 The direct-link domain is not workbuddy.cn—don't mistake it for a fake
The direct download link domains on the archive page are acc-1258344699.cos.ap-guangzhou.myqcloud.com (Tencent Cloud COS) and download.codebuddy.cn, both official channels. It's the "WorkBuddy old version download sites" that pop up in search engines you should be wary of.
You should see: the target version's row has three "Download (xxx MB)" links, corresponding to macOS · Apple silicon, macOS · Intel, and Windows · 64-bit respectively.
- I located the target version on the official archive page and did not go through third-party download sites
Step 6: Verify platform, chip, and version thresholds, then click download
Why: each row on the archive page has three packages side by side; clicking the wrong column wastes a download of several hundred MB. The version number in the filename also lets you do one final check.
Take v5.9.3 (released 2026-10-27) as an example:
| Installer | Applicable devices | Filename prefix | Size |
|---|---|---|---|
| macOS · Apple silicon | M-series Macs | WorkBuddy-darwin-arm64-5.9.3… | 356.1 MB |
| macOS · Intel | Intel Mac | WorkBuddy-darwin-x64-5.9.3… | 384.5 MB |
| Windows · 64-bit | Windows 10 and above (x64) | WorkBuddy-win32-x64-user-5.9.3… | 429.3 MB |
When choosing a version, check the version threshold table in the core ideas: for network proxy switching, choose 5.3.0 and above; for the WeChat Assistant / WeCom Assistant, choose 4.6.4 and above (all versions in the archive qualify).
After the download completes, install using the process for your platform: Windows uses the installation wizard in 1.2 Step 3, and Mac uses dragging into "Applications" in 1.2 Step 4. If installing an older version over an existing one reports an error, the fix is in 1.3 What to do if installation fails.
You should see: an installer whose filename contains the target version number appears in your downloads folder (.dmg or .exe).
- The package's platform / chip matches, and the version number in the filename is the one you intended
Checkpoints ✅
- UOS / Kylin users: installed WorkBuddy from the system store and signed in via WeChat QR code to the main interface
- Store-version users: know that upgrades rely on "Check for updates" directing you back to the store, not on the client auto-upgrading
- Historical-version users: WorkBuddy historical version downloads go through the official archive page, with direct-link domains being Tencent Cloud COS or download.codebuddy.cn
- Before downloading, verified the platform / chip column, and the version number in the filename matches the target
- I know the two version thresholds: network proxy switching starts at 5.3.0, WeChat / WeCom Assistant starts at 4.6.4
Pitfall warnings
❌ Looking for .exe / .dmg installers on UOS / Kylin
Symptom: the official download page only has Windows and Mac, so Xinchuang users assume "it can't be installed."
Why it's wrong: the official installation method for UnionTech UOS and Kylin is the system app store / software store; there is no desktop installer process.
Correct approach: use the store installation in Step 2 of this page. If you can't find WorkBuddy in the store, your system version isn't supported yet—wait for a version update, and don't trust repackaged installers from unknown sources.
❌ Downloading "WorkBuddy old versions" from third-party download sites
Symptom: searching "WorkBuddy old version" turns up a pile of download sites and cloud-drive reposts.
Why it's wrong: there is an official archive page with verified direct links (Step 5 of this page); the authenticity of packages on third-party sites, and whether they've been tampered with, cannot be verified.
Correct approach: use only the official archive page. The official recommendation: use the latest version for the best experience.
❌ Installing an old version and never upgrading
Symptom: stuck on an old version—no new features, old problems remain.
Why it's wrong: features like network proxy switching only exist after 5.3.0; the official recommendation is to use the latest version. The archive page's value is for rollback and comparison, not as a permanent home.
Correct approach: rolling back is only a temporary measure—once the issue is resolved, upgrade back to the latest version: store versions use Check for updates, and the official-site version auto-upgrades.
❌ Intel Mac clicking the ARM64 column
Symptom: the darwin-arm64 .dmg won't run on an Intel Mac.
Why it's wrong: ARM64 packages cannot run on Intel Macs; conversely, X64 packages can run on M-series via Rosetta (covered on the previous page).
Correct approach: Intel → darwin-x64; M-series → darwin-arm64; unsure → x64.
Advanced tips (optional)
🔧 Want to know what each version changed? The official changelog covers 105 versions (from 4.5.0 in 2026-03-04 to 5.9.3 in 2026-10-27); reviewing key features by version helps you decide which version to roll back to—see Changelog: WorkBuddy version timeline.
🔧 Check the version before configuring assistants. Remote channels like the WeChat Assistant and WeCom Assistant require WorkBuddy 4.6.4 and above, and the WeChat Assistant channel additionally requires WeChat 8.0.70 and above; an overview of all six remote channels' configuration is in 5.1 Assistant overview.
🔧 International-version users, don't take this path. workbuddy.ai's download entry and account system are completely different from the domestic version, and the historical-version archive page covers the domestic version—see 5.5 International version.
Lesson summary
✅ Xinchuang system installation: UnionTech UOS uses the app store, Kylin V10 uses the software store—search WorkBuddy and click through to install; login is identical to Windows / Mac.
✅ Remembered the store-version upgrade difference: Check for updates directs you back to the store rather than the client auto-upgrading.
✅ Got the official source for WorkBuddy historical version downloads: the docs-site archive page, with 4.8.x through 5.9.x across 17 series, and direct-link domains Tencent Cloud COS and download.codebuddy.cn.
✅ Package selection rules: macOS picks arm64 / x64 by chip, Windows only has the 64-bit package; filenames contain the version number for post-download verification.
✅ The two version thresholds: network proxy switching starts at 5.3.0; WeChat / WeCom Assistant starts at 4.6.4 (all versions in the archive qualify).
Key decisions recap:
| Decision point | Recommended approach | Rationale |
|---|---|---|
| UOS installation channel | Search for WorkBuddy in the system's built-in app store | Official UnionTech UOS installation guide |
| Kylin installation channel | Search in the taskbar software store WorkBuddy | Official KylinOS installation guide |
| Store version upgrade | Avatar in the lower-left corner → Check for updates, follow the prompts back to the store | Official UOS / Kylin guide, "Version Updates" section |
| Old version sources | Official Download-History archive page | Official archive page (all links verified) |
| Old version package selection | Pick the column by chip / platform and verify the version number in the file name | The archive page's three-column layout and file names |
| Long-term version policy | Official recommendation is to use the latest version | Official notice on the archive page |
Next lesson preview
The store version is installed and the old version downloaded. If installation or login gets stuck, the next lesson is dedicated to troubleshooting: What to do if installation fails: installation and login troubleshooting.
You will learn:
- How to check each of the three types of login failure causes listed in the official FAQ — default browser not set, insufficient permissions on the account folder, and security software blocking
- How to use the built-in "Diagnostic Tool" in the client: one-click detection of network, system resources, and security software with report generation
- How to handle odd installation issues like "a user project directory exists in the installation directory" or the workspace folder disappearing after an upgrade
If everything goes smoothly, skip troubleshooting and go straight to 1.4 First task: from one sentence to a deliverable.