Skip to content

Commit c5dc8cd

Browse files
newbe36524hagicode-ai
newbe36524
and
hagicode-ai
committed
docs(installation): add Windows Store installation documentation
Add Windows Store installation section with dedicated windows-store.mdx page covering installation steps, first launch behavior, and common limitations. Update installation index pages across all locales (zh-CN, en-US, de-DE, es-ES, fr-FR, ja-JP, ko-KR, pt-BR, ru-RU, zh-Hant) with navigation cards linking to the new Windows Store installation guide. Co-Authored-By: Hagicode <noreply@hagicode.com> Signed-off-by: newbe36524 <newbe36524@qq.com>
1 parent ebc166d commit c5dc8cd

20 files changed

Lines changed: 942 additions & 0 deletions

File tree

‎src/content/docs/installation/index.mdx‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,18 @@ HagiCode 提供多种安装方式。先选适合自己的部署路径，再按
2626
/>
2727
</CardGrid>
2828

29+
## Windows Store
30+
31+
如果你准备在 Windows 上直接通过官方商店安装，可先看这篇专门说明：
32+
33+
<CardGrid>
34+
<LinkCard
35+
title="Windows Store 安装"
36+
href="/installation/windows-store"
37+
description="当前 Windows 桌面入口，说明商店安装步骤、首次启动行为与常见限制。"
38+
/>
39+
</CardGrid>
40+
2941
## 相关软件安装
3042

3143
如果你的工作流需要额外工具或运行时，可以继续阅读这些配套指南：

‎src/content/docs/installation/windows-store.mdx‎

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
---
2+
title: Windows Store 安装
3+
description: 通过 Windows Store 安装 HagiCode for Windows，了解适用场景、安装步骤、首次启动与常见问题。
4+
sidebar_position: 20
5+
---
6+
7+
import { CardGrid, LinkCard } from '@astrojs/starlight/components';
8+
9+
对于 Windows 用户，Windows Store 是当前公开的桌面入口。本文只说明商店安装这条路径；如果你想看通用的 Desktop 下载安装、版本管理与故障排除说明，请继续阅读 [Desktop 安装](/installation/desktop)。
10+
11+
Steam 主应用条目已经退役，当前 Windows 渠道以 Windows Store 为主。相关背景可见 [为什么 HagiCode 没有上架 Steam](/faq/steam-distribution-status/)。
12+
13+
:::tip[适合这条路径的情况]
14+
- 你正在使用 Windows 10 或 Windows 11，并希望直接从系统商店安装
15+
- 你更希望由商店渠道分发应用包，而不是手动处理安装文件
16+
- 你只需要个人本地安装，不打算做 Docker Compose 部署
17+
:::
18+
19+
## 安装前确认
20+
21+
开始前请确认这些条件：
22+
23+
- 设备可以正常打开 [HagiCode for Windows 的 Windows Store 页面](https://apps.microsoft.com/detail/9N3PM0N3SVDW)
24+
- 首次启动时网络可用，因为程序可能还会继续准备运行所需组件
25+
- 某些设备、组织策略或地区设置可能会要求你先登录 Microsoft 账户
26+
- 如果你的公司设备禁用了商店，请改用 [Desktop 安装](/installation/desktop)
27+
28+
## 从 Windows Store 安装
29+
30+
1. 打开 [HagiCode for Windows](https://apps.microsoft.com/detail/9N3PM0N3SVDW) 页面。
31+
2. 点击 `获取`、`安装`，或商店页面中的等效按钮。
32+
3. 等待 Windows Store 完成下载与安装。
33+
4. 安装完成后，从开始菜单或商店页面直接启动 HagiCode。
34+
35+
## 首次启动时会发生什么
36+
37+
安装完成后，HagiCode 仍会进入标准 Desktop 初始化流程。
38+
39+
- 首次启动可能比普通应用更慢，因为还要准备默认本地运行环境
40+
- Windows Store / MSIX 渠道会锁定部分依赖管理或运行时路径设置，这是该分发方式的预期行为
41+
- 软件本体不会独立自更新，应用包更新由安装渠道决定；对于 Store 安装，交付方式取决于 Windows Store 渠道
42+
43+
如果你需要继续完成初始化向导，请直接阅读 [初始化向导设置](/quick-start/wizard-setup)。
44+
45+
## 什么时候改用其他安装方式
46+
47+
以下情况更适合改用别的渠道：
48+
49+
- 你无法访问 Windows Store，或公司设备明确禁止商店安装
50+
- 你需要手动下载 `.exe` 或 `.msix` 包，并自己控制安装文件来源
51+
- 你要部署到服务器、NAS 或团队共享环境，这时应改看 [Docker Compose 部署](/installation/docker-compose)
52+
53+
## 常见问题
54+
55+
### 无法打开 Windows Store 页面
56+
57+
优先确认系统网络、地区设置和 Microsoft Store 登录状态。如果浏览器能打开页面但商店客户端仍不可用，通常说明当前系统策略限制了商店能力，这时请改用 [Desktop 安装](/installation/desktop)。
58+
59+
### 为什么某些设置是灰色的
60+
61+
Store / MSIX 安装会锁定部分依赖管理与运行时数据路径选项。这不是安装异常，而是当前分发渠道的约束。
62+
63+
### 为什么第一次启动还要继续下载或准备内容
64+
65+
商店安装只负责交付桌面应用包。首次启动时，HagiCode 仍可能继续检查版本信息、准备本地组件，或完成默认初始化。请保持网络可用并等待当前步骤结束。
66+
67+
## 下一步
68+
69+
<CardGrid>
70+
<LinkCard
71+
title="初始化向导设置"
72+
href="/quick-start/wizard-setup"
73+
description="完成首次进入后的初始化流程，并继续进入标准快速开始链路。"
74+
/>
75+
<LinkCard
76+
title="Desktop 安装"
77+
href="/installation/desktop"
78+
description="查看通用桌面安装、版本管理、服务启动与更多故障排除说明。"
79+
/>
80+
<LinkCard
81+
title="Steam 渠道状态"
82+
href="/faq/steam-distribution-status"
83+
description="了解 Steam 主应用条目为何退役，以及当前 Windows 分发渠道的背景。"
84+
/>
85+
</CardGrid>

‎src/content/translations/docs/de-DE/installation/index.mdx‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,18 @@ Der aktuell für die Einrichtung relevanteste Bereich der aktiven Agent-CLI-Unte
2626
/>
2727
</CardGrid>
2828

29+
## Windows Store
30+
31+
Wenn Sie unter Windows direkt über den offiziellen Store installieren möchten, lesen Sie zuerst diesen speziellen Leitfaden:
32+
33+
<CardGrid>
34+
<LinkCard
35+
title="Windows Store-Installation"
36+
href="/de-DE/installation/windows-store"
37+
description="Erklärt die Store-Installationsschritte, das Verhalten beim ersten Start und typische Grenzen dieses Windows-Kanals."
38+
/>
39+
</CardGrid>
40+
2941
## Unterstützende Software
3042

3143
Wenn Ihr Setup zusätzliche Tools oder Laufzeiten benötigt, fahren Sie mit diesen Begleithandbüchern fort:

‎src/content/translations/docs/de-DE/installation/windows-store.mdx‎

Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
---
2+
title: Windows Store-Installation
3+
description: Installieren Sie HagiCode for Windows über den Windows Store und verstehen Sie den Erststart, das Kanalverhalten und häufige Probleme.
4+
sidebar_position: 20
5+
---
6+
7+
import { CardGrid, LinkCard } from '@astrojs/starlight/components';
8+
9+
Für Windows-Nutzer ist der Windows Store derzeit der öffentliche Desktop-Einstiegspunkt. Diese Seite behandelt nur den Store-Pfad. Für die allgemeine Desktop-Download-, Versionsverwaltungs- und Fehlerbehebungsanleitung lesen Sie [Desktop Installation](/de-DE/installation/desktop).
10+
11+
Der Haupt-App-Eintrag bei Steam wurde bereits eingestellt. Damit ist der Windows Store jetzt der primäre Windows-Vertriebskanal. Hintergrund dazu finden Sie unter [Why HagiCode is not available on Steam](/de-DE/faq/steam-distribution-status/).
12+
13+
:::tip[Geeignet für diesen Weg]
14+
- Sie verwenden Windows 10 oder Windows 11 und möchten direkt über den System-Store installieren
15+
- Sie bevorzugen Store-gelieferte App-Pakete statt manuell mit Installationsdateien zu arbeiten
16+
- Sie benötigen nur ein lokales persönliches Setup und planen keine Docker-Compose-Bereitstellung
17+
:::
18+
19+
## Vor dem Start
20+
21+
- Das Gerät muss die [Windows-Store-Seite für HagiCode for Windows](https://apps.microsoft.com/detail/9N3PM0N3SVDW) öffnen können
22+
- Beim ersten Start sollte Netzwerkzugang verfügbar sein, da zusätzliche Laufzeitkomponenten vorbereitet werden können
23+
- Je nach Gerät, Region oder Unternehmensrichtlinie kann eine Microsoft-Konto-Anmeldung erforderlich sein
24+
- Wenn der Store auf Ihrem Rechner blockiert ist, wechseln Sie zu [Desktop Installation](/de-DE/installation/desktop)
25+
26+
## Installation aus dem Windows Store
27+
28+
1. Öffnen Sie [HagiCode for Windows](https://apps.microsoft.com/detail/9N3PM0N3SVDW).
29+
2. Klicken Sie auf `Abrufen`, `Installieren` oder die entsprechende Aktion im Store.
30+
3. Warten Sie, bis der Windows Store Download und Installation abgeschlossen hat.
31+
4. Starten Sie HagiCode anschließend über das Startmenü oder direkt aus dem Store.
32+
33+
## Was beim ersten Start passiert
34+
35+
Nach der Installation setzt HagiCode weiterhin den normalen Desktop-Initialisierungsablauf fort.
36+
37+
- der erste Start kann langsamer wirken, weil die lokale Laufzeitumgebung noch vorbereitet wird
38+
- der Windows-Store-/MSIX-Kanal sperrt einige Einstellungen für Abhängigkeitsverwaltung und Laufzeitpfade absichtlich
39+
- die App aktualisiert sich nicht eigenständig; die Paketbereitstellung hängt vom Installationskanal ab, und beim Store-Build erfolgt sie über den Windows-Store-Kanal
40+
41+
Wenn Sie mit dem Onboarding fortfahren möchten, lesen Sie [Wizard Setup](/de-DE/quick-start/wizard-setup).
42+
43+
## Wann ein anderer Installationsweg sinnvoller ist
44+
45+
- Sie können den Windows Store nicht nutzen oder Store-Installationen sind organisatorisch gesperrt
46+
- Sie müssen `.exe`- oder `.msix`-Dateien manuell herunterladen und die Quelle selbst kontrollieren
47+
- Sie stellen für Server, NAS oder Teams bereit; in diesem Fall passt [Docker Compose Deployment](/de-DE/installation/docker-compose) besser
48+
49+
## Fehlerbehebung
50+
51+
### Die Windows-Store-Seite öffnet sich nicht
52+
53+
Prüfen Sie zuerst Netzwerkzugang, Regionseinstellungen und den Microsoft-Store-Anmeldestatus. Wenn der Browser-Link funktioniert, der Store-Client aber nicht verfügbar ist, liegt die Ursache oft an einer lokalen Systemrichtlinie. Wechseln Sie dann zu [Desktop Installation](/de-DE/installation/desktop).
54+
55+
### Einige Einstellungen sind gesperrt
56+
57+
Store-/MSIX-Installationen sperren absichtlich bestimmte Optionen für Abhängigkeitsverwaltung und Laufzeitdatenpfade. Das ist kein Installationsfehler, sondern eine Eigenschaft dieses Vertriebskanals.
58+
59+
### Beim ersten Start werden weitere Inhalte heruntergeladen oder vorbereitet
60+
61+
Das Store-Paket liefert nur das Desktop-Anwendungspaket aus. Beim ersten Start kann HagiCode weiterhin Versionsmetadaten prüfen, lokale Komponenten vorbereiten oder die Standardinitialisierung abschließen. Lassen Sie die Netzwerkverbindung aktiv und warten Sie, bis der aktuelle Schritt beendet ist.
62+
63+
## Nächste Schritte
64+
65+
<CardGrid>
66+
<LinkCard
67+
title="Wizard Setup"
68+
href="/de-DE/quick-start/wizard-setup"
69+
description="Schließen Sie den Erststart-Initialisierungsablauf ab und wechseln Sie dann in den normalen Schnellstart."
70+
/>
71+
<LinkCard
72+
title="Desktop Installation"
73+
href="/de-DE/installation/desktop"
74+
description="Lesen Sie die allgemeine Desktop-Installations-, Versionsverwaltungs-, Service-Start- und Fehlerbehebungsanleitung."
75+
/>
76+
<LinkCard
77+
title="Steam-Status-FAQ"
78+
href="/de-DE/faq/steam-distribution-status"
79+
description="Verstehen Sie, warum der Steam-Haupt-App-Eintrag eingestellt wurde und wie sich der Windows-Vertriebskanal geändert hat."
80+
/>
81+
</CardGrid>

‎src/content/translations/docs/en-US/installation/index.mdx‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,18 @@ The current active Agent CLI support range most relevant to setup is: Claude Cod
2626
/>
2727
</CardGrid>
2828

29+
## Windows Store
30+
31+
If you want the current Windows public entry point through the official store, start with this focused guide:
32+
33+
<CardGrid>
34+
<LinkCard
35+
title="Windows Store Installation"
36+
href="/en-US/installation/windows-store"
37+
description="Covers the Store install steps, first-launch behavior, and channel-specific limits for Windows users."
38+
/>
39+
</CardGrid>
40+
2941
## Supporting Software
3042

3143
If your setup needs extra tooling or runtimes, continue with these companion guides:

‎src/content/translations/docs/en-US/installation/windows-store.mdx‎

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
---
2+
title: Windows Store Installation
3+
description: Install HagiCode for Windows through Windows Store and understand the first-launch flow, channel behavior, and common issues.
4+
sidebar_position: 20
5+
---
6+
7+
import { CardGrid, LinkCard } from '@astrojs/starlight/components';
8+
9+
For Windows users, Windows Store is the current public desktop entry point. This page covers the Store path only. If you need the broader Desktop download, version-management, and troubleshooting guide, continue with [Desktop Installation](/en-US/installation/desktop).
10+
11+
The main Steam app entry has already been retired, so Windows Store is now the primary Windows channel. For background, see [Why HagiCode is not available on Steam](/en-US/faq/steam-distribution-status/).
12+
13+
:::tip[Good fit for this path]
14+
- you are on Windows 10 or Windows 11 and want to install directly from the system store
15+
- you prefer store-delivered app packages instead of handling installer files manually
16+
- you only need a local personal setup and are not planning a Docker Compose deployment
17+
:::
18+
19+
## Before you start
20+
21+
Confirm these conditions first:
22+
23+
- your device can open the [Windows Store page for HagiCode for Windows](https://apps.microsoft.com/detail/9N3PM0N3SVDW)
24+
- network access is available on first launch because the app may still prepare additional runtime components
25+
- some devices, regions, or organization policies may ask you to sign in with a Microsoft account first
26+
- if Store access is blocked on your machine, switch to [Desktop Installation](/en-US/installation/desktop)
27+
28+
## Install from Windows Store
29+
30+
1. Open [HagiCode for Windows](https://apps.microsoft.com/detail/9N3PM0N3SVDW).
31+
2. Click `Get`, `Install`, or the equivalent action shown by the Store page.
32+
3. Wait for Windows Store to finish downloading and installing the app.
33+
4. Launch HagiCode from the Start menu or directly from the Store page.
34+
35+
## What happens on first launch
36+
37+
After installation, HagiCode still continues through the standard Desktop initialization flow.
38+
39+
- first launch can be slower than a typical app because the local runtime still needs to be prepared
40+
- the Windows Store / MSIX channel locks some dependency-management and runtime-path settings by design
41+
- the app does not self-update independently; package delivery depends on the installation channel, and Store delivery is tied to the Windows Store channel
42+
43+
If you want to continue with the onboarding flow, read [Wizard Setup](/en-US/quick-start/wizard-setup).
44+
45+
## When to use another installation path
46+
47+
Another channel is a better fit when:
48+
49+
- you cannot access Windows Store, or your organization blocks Store installation
50+
- you need to download `.exe` or `.msix` files manually and control the installer source yourself
51+
- you are deploying to a server, NAS, or team environment, in which case [Docker Compose Deployment](/en-US/installation/docker-compose) is the better path
52+
53+
## Troubleshooting
54+
55+
### The Windows Store page does not open
56+
57+
Check system network access, region settings, and Microsoft Store sign-in status first. If the browser link opens but the Store client remains unavailable, the usual cause is local system policy. In that case, switch to [Desktop Installation](/en-US/installation/desktop).
58+
59+
### Some settings are locked
60+
61+
Store / MSIX installs intentionally lock some dependency-management and runtime-data path options. That is expected behavior for this distribution channel, not an installation failure.
62+
63+
### First launch still downloads or prepares more content
64+
65+
The Store package only delivers the desktop application package. On first launch, HagiCode may still check version metadata, prepare local components, or continue default initialization. Keep the network available and wait for the current step to finish.
66+
67+
## Next steps
68+
69+
<CardGrid>
70+
<LinkCard
71+
title="Wizard Setup"
72+
href="/en-US/quick-start/wizard-setup"
73+
description="Complete the first-run initialization flow and continue through the standard quick-start path."
74+
/>
75+
<LinkCard
76+
title="Desktop Installation"
77+
href="/en-US/installation/desktop"
78+
description="Read the broader desktop installation, version management, service startup, and troubleshooting guide."
79+
/>
80+
<LinkCard
81+
title="Steam Status FAQ"
82+
href="/en-US/faq/steam-distribution-status"
83+
description="Understand why the Steam main app entry was retired and how the current Windows distribution channel changed."
84+
/>
85+
</CardGrid>

‎src/content/translations/docs/es-ES/installation/index.mdx‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,18 @@ El rango de compatibilidad de CLI del agente activo actual más relevante para l
2626
/>
2727
</CardGrid>
2828

29+
## Windows Store
30+
31+
Si vas a instalar HagiCode en Windows directamente desde la tienda oficial, empieza por esta guía específica:
32+
33+
<CardGrid>
34+
<LinkCard
35+
title="Instalación desde Windows Store"
36+
href="/es-ES/installation/windows-store"
37+
description="Resume los pasos de instalación, el comportamiento del primer arranque y las limitaciones típicas de este canal de Windows."
38+
/>
39+
</CardGrid>
40+
2941
## Software de soporte
3042

3143
Si su configuración necesita herramientas o tiempos de ejecución adicionales, continúe con estas guías complementarias:

0 commit comments

Comments
 (0)