From 22767fb489316e5d58ba5b41df96d12fec61e809 Mon Sep 17 00:00:00 2001 From: DZXH-TX Date: Sat, 22 Aug 2026 01:14:24 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=90=8C=E6=AD=A5=E5=BE=AE=E8=BD=AF?= =?UTF-8?q?=E5=95=86=E5=BA=97=E6=AD=A3=E5=BC=8F=E7=89=88=E4=BF=A1=E6=81=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.en.md | 25 ++++++++++++++++++++----- README.md | 25 ++++++++++++++++++++----- 2 files changed, 40 insertions(+), 10 deletions(-) diff --git a/README.en.md b/README.en.md index cd1b1a4..ca0cf69 100644 --- a/README.en.md +++ b/README.en.md @@ -20,7 +20,7 @@ Rust 1.97.1 Windows 10 1809+ WinUI 3 - Development Preview + Microsoft Store v1.0.0

@@ -31,6 +31,12 @@ Legacy Forge

+

+ Get it free from Microsoft Store + · + GitHub Release v1.0.0 +

+

Project Overview · Core Capabilities · @@ -43,7 +49,7 @@ > [!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 @@ -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 | | --- | --- | @@ -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: @@ -194,7 +209,7 @@ The MCP stdio Host exposes only `system.context` and `cli.propose`, not `cli.exe

MSIX package status -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. diff --git a/README.md b/README.md index 96cfbca..1565059 100644 --- a/README.md +++ b/README.md @@ -20,7 +20,7 @@ Rust 1.97.1 Windows 10 1809+ WinUI 3 - 开发预览版 + Microsoft Store v1.0.0

@@ -31,6 +31,12 @@ Legacy Forge

+

+ 从 Microsoft Store 免费获取 + · + GitHub Release v1.0.0 +

+

项目概览 · 核心能力 · @@ -43,7 +49,7 @@ > [!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，无需安装开发测试证书。 ## 项目概览 @@ -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）。 + +### 开发环境要求 | 依赖 | 版本或说明 | | --- | --- | @@ -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： @@ -194,7 +209,7 @@ MCP stdio Host 只暴露 `system.context` 与 `cli.propose`，不暴露 `cli.exe

MSIX 程序包状态 -当前 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`，并只读检查仍已注册的旧包重定向数据。确认新版本工作正常后再卸载旧开发包。