Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 20 additions & 5 deletions README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
<a href="./rust-toolchain.toml"><img alt="Rust 1.97.1" src="https://img.shields.io/badge/Rust-1.97.1-000000?style=flat-square&logo=rust&logoColor=white" /></a>
<img alt="Windows 10 1809+" src="https://img.shields.io/badge/Windows-10%201809%2B-0078D4?style=flat-square" />
<img alt="WinUI 3" src="https://img.shields.io/badge/UI-WinUI%203-0078D4?style=flat-square" />
<img alt="Development Preview" src="https://img.shields.io/badge/Status-Development%20Preview-F59E0B?style=flat-square" />
<a href="https://apps.microsoft.com/detail/9NP8V6WQNGT0"><img alt="Microsoft Store v1.0.0" src="https://img.shields.io/badge/Microsoft%20Store-v1.0.0-0078D4?style=flat-square&logo=microsoft&logoColor=white" /></a>
</p>

<p>
Expand All @@ -31,6 +31,12 @@
<img alt="Legacy Forge" src="https://img.shields.io/badge/Loader-Legacy%20Forge-6B7280?style=flat-square" />
</p>

<p>
<a href="https://apps.microsoft.com/detail/9NP8V6WQNGT0"><strong>Get it free from Microsoft Store</strong></a>
·
<a href="https://github.com/DZXH-TX/LocaleSmith/releases/tag/v1.0.0">GitHub Release v1.0.0</a>
</p>

<p>
<a href="#project-overview">Project Overview</a> ·
<a href="#core-capabilities">Core Capabilities</a> ·
Expand All @@ -43,7 +49,7 @@
</div>

> [!IMPORTANT]
> LocaleSmith is currently a **source-buildable development preview**. The existing MSIX uses a self-signed development certificate and has not yet completed production signing, trusted timestamping, or a clean-machine installation test matrix. Do not treat it as a production release.
> **LocaleSmith v1.0.0 is officially available from [Microsoft Store](https://apps.microsoft.com/detail/9NP8V6WQNGT0).** Installing from the Store is recommended so that dependencies and future updates are handled automatically; the [GitHub Release](https://github.com/DZXH-TX/LocaleSmith/releases/tag/v1.0.0) also provides the production MSIX signed by Microsoft Marketplace, with no development test certificate required.

## Project Overview

Expand Down Expand Up @@ -102,7 +108,16 @@ The default directory is `%LOCALAPPDATA%\LocaleSmith\logs\translations`. During

## Quick Start

### Prerequisites
### Install the release

| Channel | Description |
| --- | --- |
| [Microsoft Store](https://apps.microsoft.com/detail/9NP8V6WQNGT0) | Recommended; get it free with installation, framework dependencies, and future updates handled by the Store. Product ID: `9NP8V6WQNGT0`. |
| [GitHub Release v1.0.0](https://github.com/DZXH-TX/LocaleSmith/releases/tag/v1.0.0) | Provides the Microsoft Marketplace-signed `CRTech.LocaleSmith_1.0.0.0_x64.Msix` for users who need a direct installer download. |

The GitHub MSIX SHA-256 is `2C66F5645C2BF957719467F9AB415450CF1B6A620C10CF13381EC307FD8B10EE`. The production release supports Windows x64 and requires Windows 10 1809 (build 17763) or later.

### Development prerequisites

| Dependency | Version or Notes |
| --- | --- |
Expand All @@ -113,7 +128,7 @@ The default directory is `%LOCALAPPDATA%\LocaleSmith\logs\translations`. During
| UI dependencies | Windows App SDK `2.3.1` and CommunityToolkit.Mvvm `8.4.2`, restored through NuGet |
| MSIX build | Requires Visual Studio Developer PowerShell with Desktop Bridge / WAP targets |

### Build
### Build from source

Build the Rust release DLL first, then restore and build the .NET solution:

Expand Down Expand Up @@ -194,7 +209,7 @@ The MCP stdio Host exposes only `system.context` and `cli.propose`, not `cli.exe
<details>
<summary><strong>MSIX package status</strong></summary>

The Store manifest now uses the official identity assigned in Partner Center and package version `1.0.0.0`; the application itself remains at the independently versioned `0.1.0` preview stage. Historical development packages previously completed payload, PRI, MCP Host, SignPath Authenticode signing, and local launch verification, but that evidence does not cover the current source. Before submission to Microsoft Store, regenerate the MSIX and explain and request approval for the restricted `runFullTrust` capability in Partner Center's submission options.
The current public release is `v1.0.0`; its Store package version is `1.0.0.0`, its product ID is `9NP8V6WQNGT0`, and it uses the Partner Center identity `CRTech.LocaleSmith`. Microsoft Store provides the production distribution and automatic updates. The x64 MSIX attached to the GitHub Release has been verified for its Microsoft Marketplace signature chain, trusted timestamp, package identity, architecture, and SHA-256, and it does not require the self-signed test certificate used by historical development packages. The public package declares the `runFullTrust` desktop capability; commands proposed by a model still require policy revalidation and explicit user confirmation.

The official `CRTech.LocaleSmith` identity cannot update the earlier `LocaleSmith.Desktop` / `JaxI18n.Desktop` development packages in place, so Windows temporarily installs them side by side. Close the older application during the transition. The new application continues to use the per-user `%LOCALAPPDATA%\LocaleSmith` root and performs read-only discovery of redirected data belonging to any still-registered legacy package. Uninstall the development package only after confirming that the official-identity build works correctly.

Expand Down
25 changes: 20 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
<a href="./rust-toolchain.toml"><img alt="Rust 1.97.1" src="https://img.shields.io/badge/Rust-1.97.1-000000?style=flat-square&logo=rust&logoColor=white" /></a>
<img alt="Windows 10 1809+" src="https://img.shields.io/badge/Windows-10%201809%2B-0078D4?style=flat-square" />
<img alt="WinUI 3" src="https://img.shields.io/badge/UI-WinUI%203-0078D4?style=flat-square" />
<img alt="开发预览版" src="https://img.shields.io/badge/Status-Development%20Preview-F59E0B?style=flat-square" />
<a href="https://apps.microsoft.com/detail/9NP8V6WQNGT0"><img alt="Microsoft Store v1.0.0" src="https://img.shields.io/badge/Microsoft%20Store-v1.0.0-0078D4?style=flat-square&logo=microsoft&logoColor=white" /></a>
</p>

<p>
Expand All @@ -31,6 +31,12 @@
<img alt="Legacy Forge" src="https://img.shields.io/badge/Loader-Legacy%20Forge-6B7280?style=flat-square" />
</p>

<p>
<a href="https://apps.microsoft.com/detail/9NP8V6WQNGT0"><strong>从 Microsoft Store 免费获取</strong></a>
·
<a href="https://github.com/DZXH-TX/LocaleSmith/releases/tag/v1.0.0">GitHub Release v1.0.0</a>
</p>

<p>
<a href="#项目概览">项目概览</a> ·
<a href="#核心能力">核心能力</a> ·
Expand All @@ -43,7 +49,7 @@
</div>

> [!IMPORTANT]
> LocaleSmith 目前是**源码可构建的开发预览版**。现有 MSIX 使用自签名开发证书,尚未完成生产签名、可信时间戳与干净机安装矩阵,请勿将其视为正式发布件
> **LocaleSmith v1.0.0 已在 [Microsoft Store](https://apps.microsoft.com/detail/9NP8V6WQNGT0) 正式上架。** 推荐通过商店安装,以自动处理依赖和后续更新;[GitHub Release](https://github.com/DZXH-TX/LocaleSmith/releases/tag/v1.0.0) 同时提供经 Microsoft Marketplace 签名的正式 MSIX,无需安装开发测试证书

## 项目概览

Expand Down Expand Up @@ -102,7 +108,16 @@ flowchart LR

## 快速开始

### 环境要求
### 安装正式版

| 渠道 | 说明 |
| --- | --- |
| [Microsoft Store](https://apps.microsoft.com/detail/9NP8V6WQNGT0) | 推荐方式;免费获取并由商店处理安装、框架依赖与后续更新。产品 ID:`9NP8V6WQNGT0`。 |
| [GitHub Release v1.0.0](https://github.com/DZXH-TX/LocaleSmith/releases/tag/v1.0.0) | 提供 Microsoft Marketplace 签名的 `CRTech.LocaleSmith_1.0.0.0_x64.Msix`,适用于需要直接下载安装包的场景。 |

GitHub MSIX 的 SHA-256 为 `2C66F5645C2BF957719467F9AB415450CF1B6A620C10CF13381EC307FD8B10EE`。正式版支持 Windows x64,最低系统版本为 Windows 10 1809(Build 17763)。

### 开发环境要求

| 依赖 | 版本或说明 |
| --- | --- |
Expand All @@ -113,7 +128,7 @@ flowchart LR
| UI 依赖 | Windows App SDK `2.3.1`、CommunityToolkit.Mvvm `8.4.2`,由 NuGet 还原 |
| MSIX 构建 | 需要包含 Desktop Bridge / WAP targets 的 Visual Studio Developer PowerShell |

### 构建
### 从源码构建

先生成 Rust release DLL,再还原并构建 .NET solution:

Expand Down Expand Up @@ -194,7 +209,7 @@ MCP stdio Host 只暴露 `system.context` 与 `cli.propose`,不暴露 `cli.exe
<details>
<summary><strong>MSIX 程序包状态</strong></summary>

当前 Store manifest 使用 Partner Center 分配的正式身份,程序包版本为 `1.0.0.0`;应用自身仍处于 `0.1.0` 预览阶段,两者独立版本化。仓库中的历史开发包曾完成 payload、PRI、MCP Host、SignPath Authenticode 签名与本机启动验证,但该证据不覆盖当前源码;提交 Microsoft Store 前需重新生成 MSIX,并在 Partner Center 的提交选项中说明和申请 `runFullTrust` 受限功能
当前公开正式版本为 `v1.0.0`,Store 程序包版本为 `1.0.0.0`,产品 ID 为 `9NP8V6WQNGT0`,并使用 Partner Center 分配的 Identity `CRTech.LocaleSmith`。Microsoft Store 负责正式分发和自动更新;GitHub Release 中的 x64 MSIX 已通过 Microsoft Marketplace 签名链、可信时间戳、程序包 Identity、架构与 SHA-256 校验,不需要历史开发包使用的自签名测试证书。公开程序包声明 `runFullTrust` 桌面功能,模型提出的命令仍必须经过策略复核与用户明确确认

正式 Identity `CRTech.LocaleSmith` 不会原位升级早期的 `LocaleSmith.Desktop` / `JaxI18n.Desktop` 开发包,Windows 会暂时并列安装。切换时请关闭旧程序;新程序会继续使用用户级 `%LOCALAPPDATA%\LocaleSmith`,并只读检查仍已注册的旧包重定向数据。确认新版本工作正常后再卸载旧开发包。

Expand Down