%SystemRoot%\System32\WSReset.exe 全称：Windows Store Reset Tool，微软应用商店重置工具 定位：系统内置命令行工具，用于重置 Microsoft Store（微软商店）缓存、清除商店运行时状态；修复商店打不开、下载卡住、缓存损坏、UI 异常；无 GUI 界面，控制台静默执行，默认不输出文本；Win10 1709 引入，Win11 内置

WSReset.exe 拆解｜底层原理｜依赖文件｜依赖关系｜配套链｜边界｜自动化流水线

文件路径：%SystemRoot%\System32\WSReset.exe 全称：Windows Store Reset Tool，微软应用商店重置工具 定位：系统内置命令行工具，用于重置 Microsoft Store（微软商店）缓存、清除商店运行时状态；修复商店打不开、下载卡住、缓存损坏、UI 异常；无 GUI 界面，控制台静默执行，默认不输出文本；Win10 1709 引入，Win11 内置。

一、底层原理

WSReset.exe 是轻量外壳可执行程序，本身不实现复杂业务逻辑；不直接操作数据库文件；内部调用 WinRT COM 接口、系统 Runtime API，完成商店组件停止、缓存清理、状态重置，最后重启商店应用。

内部执行完整时序

WSReset.exe 启动（必须本地管理员权限）
    ↓
1. 发送终止信号，停止 Microsoft Store 应用进程（WinStore.App.exe）
    ↓
2. 通过 COM 调用 Windows.AppStore.Runtime 运行时接口
    ├─ 清空 Store 内存缓存会话
    ├─ 删除 %localappdata%\Packages\Microsoft.WindowsStore_8wekyb3d8bbwe\LocalState\Cache 缓存目录
    ├─ 清除商店 HTTP 缓存、图标缓存、元数据缓存文件
    ├─ 重置商店运行时状态，不删除已安装App、不删除用户下载库、不删除账户登录信息
    ↓
3. 重置商店包状态（修复包损坏标记）
    ↓
4. 重新启动 Microsoft Store（WinStore.App.exe）；WSReset.exe 进程退出

关键行为区分：

1. ✅ 删除：商店 UI 缓存、http 资源缓存、临时元数据缓存
2. ❌ 不会卸载已安装 UWP/MSIX 应用
3. ❌ 不会清除登录的微软账号
4. ❌ 不会删除已下载安装包
5. ❌ 不会修改系统注册表中已安装应用列表

WSReset.exe 不操作注册表；缓存全部位于用户配置目录 Packages 下。

权限模型

1. 需要当前用户权限，不需要提升管理员；针对当前登录用户配置文件生效；
2. 多用户环境：WSReset.exe 只重置执行命令的那个用户的商店缓存，不会影响其他用户配置；
3. 如果 %localappdata% 用户配置目录损坏，目录无法访问，WSReset 直接静默失败，无报错输出。

二、依赖文件

文件	路径	作用
WSReset.exe	%SystemRoot%\System32\WSReset.exe	重置工具外壳；进程控制、调用 WinRT COM 组件；无业务逻辑
WinStore.App.exe	%localappdata%\Packages\Microsoft.WindowsStore_8wekyb3d8bbwe\LocalCache\Local\Microsoft.WindowsStore	Microsoft Store 主 UWP 应用进程；WSReset 终止 / 重启该进程
Windows.AppStore.Runtime.dll	系统 WinRT 组件；商店运行时 COM 接口实现，WSReset 核心调用对象
combase.dll	%SystemRoot%\System32\combase.dll	COM/WinRT 运行时；WSReset 调用 WinRT COM 必须依赖
kernelbase.dll	%SystemRoot%\System32\kernelbase.dll	进程控制 API，终止、启动 App 进程
twinapi.dll	%SystemRoot%\System32\twinapi.dll	UWP 应用生命周期管理，启动 / 终止 UWP 包进程

关键数据位置（非注册表）

1. 商店缓存目录

%localappdata%\Packages\Microsoft.WindowsStore_8wekyb3d8bbwe\LocalState\Cache

2. 商店应用包目录

%localappdata%\Packages\Microsoft.WindowsStore_8wekyb3d8bbwe

WSReset 不修改系统注册表项。

三、依赖关系

1. 强依赖 WinRT/COM 运行时 (combase.dll)；combase 异常 WSReset 无法执行重置逻辑。
2. 依赖 TwinAPI UWP 应用框架：用于停止、重启 Microsoft Store UWP 包进程。
3. 依赖用户配置文件正常可用：%localappdata% 必须可读写；用户配置损坏、配置文件挂载失败，WSReset 静默失败。
4. 不依赖系统服务；但 Microsoft Store 依赖：AppX Deployment Service (AppXSvc)；WSReset 本身不启停 AppXSvc 服务。
5. 版本约束：Win10 1709 及以上；Win10 早期版本无 WSReset.exe。
6. 多用户隔离：仅作用于执行命令的用户上下文；不能跨用户重置商店。

典型调用链路

链路：WSReset.exe 完整执行

WSReset.exe
    ↓
kernelbase!TerminateProcess 停止 WinStore.App.exe
    ↓
combase.dll 激活 Windows.AppStore.Runtime COM对象
    ↓
Runtime组件删除Cache目录、清理内存缓存状态
    ↓
twinapi.dll 启动Microsoft Store UWP应用
    ↓
WSReset.exe进程退出；无控制台输出

四、配套链

图形配套

工具	说明
设置 → 应用 → Microsoft Store → 高级选项 → 重置	图形界面重置商店；底层调用同一套 Windows.AppStore.Runtime COM 接口，等价 WSReset.exe；图形界面提供 “修复” 和 “重置” 两个档位。

命令行 & 自动化配套

工具	用途
Get‑AppxPackage	PowerShell；重置商店包的兜底命令，当 WSReset 失效时使用
AppXSvc	AppX 部署服务；UWP/MSIX 安装卸载底层服务，WSReset 不操作该服务
wsreset.exe	直接运行；无任何命令行参数；不支持‑quiet /‑verbose 等参数，不接受参数

上层消费组件

1. Windows 设置应用：高级选项里面的商店重置，复用同一套 COM 运行时
2. WSReset.exe：命令行入口

五、边界（坑点与限制）

1. WSReset.exe 没有任何命令行参数；写 wsreset.exe/s /quiet 全部无效，直接忽略参数，直接执行默认重置。
2. 执行默认无控制台输出；成功 / 失败都不打印文字；你无法直接从 CMD 窗口判断是否成功。只能观察商店窗口是否自动弹出。
3. 只清理缓存；不修复 AppXSvc 服务损坏；当 AppX 部署服务异常，WSReset 执行成功，但商店依旧无法下载应用。
4. 用户配置文件损坏：%localappdata%不可访问，WSReset 静默失败，无报错。
5. 第三方杀毒 / 安全软件锁定 Cache 目录文件：目录无法删除，重置失败，无提示。
6. 多用户场景：管理员运行 wsreset.exe，依旧只重置当前登录用户，不会重置其他账户。
7. WSReset 不会重装 Microsoft Store；如果商店应用包本身损坏，WSReset 无效，需要 PowerShell Get‑AppxPackage重新注册。
8. WSReset 仅针对 Microsoft.WindowsStore；不能重置其他 UWP 应用。
9. 企业环境禁用 Microsoft Store 策略：WSReset 依旧执行缓存清理，但重启后商店无法打开，属于策略限制，不是 WSReset 故障。

六、自动化流水线（WSReset.exe 运维流水线）

wsreset.exe 无返回输出，自动化脚本需要靠进程等待、检测窗口 / 检测缓存目录做判断。

流水线 1：基础手动运维

::直接执行，无参数；执行完成会自动弹出微软商店
wsreset.exe

流水线 2：PowerShell 自动化脚本（WSReset 执行 + 状态校验）

# 启动 WSReset.exe
Start‑Process wsreset.exe -Wait

# 等待进程退出
Start‑Sleep 5

# 校验缓存目录是否被清空
$cachePath = "$env:localappdata\Packages\Microsoft.WindowsStore_8wekyb3d8bbwe\LocalState\Cache"
if(Test‑Path $cachePath){
    Write‑Host "缓存目录存在，重置完成"
}else{
    Write‑Host "缓存目录已清除"
}

流水线 3：WSReset 失效兜底修复流水线（WSReset 无效时）

# 重新注册Microsoft Store包（WSReset无法修复包损坏时使用）
Get‑AppxPackage -AllUsers Microsoft.WindowsStore | Foreach‑Object {
    Add‑AppxPackage -DisableDevelopmentMode -Register "$($_.InstallLocation)\AppXManifest.xml"
}

流水线 4：故障排查 SOP

1. 运行 wsreset.exe，商店不自动弹出：WSReset 执行失败；检查用户配置文件%localappdata%权限。
2. WSReset 执行完成商店依旧下载报错：问题不在缓存，检查 AppXSvc 服务状态；网络、组策略禁用商店。
3. 企业环境：检查组策略 删除 Microsoft Store；策略启用，WSReset 可以跑，但商店无法启动。
4. 第三方安全软件拦截：临时排除 Packages 缓存目录，重试。

核心总结： WSReset.exe 是微软商店缓存重置的轻量外壳工具；依赖 WinRT COM 组件 Windows.AppStore.Runtime；只清理用户侧商店缓存，不卸载应用、不清账号、不改注册表；无命令行参数，无控制台输出；仅修复缓存类故障；应用包损坏场景 WSReset 无效，需要 PowerShell 重新注册 AppX 包；只作用当前登录用户。

---

WSReset.exe 配套链

配套链分为：底层运行依赖组件、目标对象、图形等价工具、命令行 / 脚本配套工具、关联后台服务、数据载体、兜底修复工具七大部分；WSReset 本身只是轻量外壳，不实现业务逻辑，全部能力由 WinRT COM 运行时提供。

1）底层运行依赖组件（必须存在，否则 WSReset 无法执行重置逻辑）

组件	文件路径	配套角色
WSReset.exe	C:\Windows\System32\WSReset.exe	命令行入口外壳，进程启停、参数入口
combase.dll	System32\combase.dll	COM/WinRT 运行时；激活商店 Runtime 对象，核心依赖
twinapi.dll	System32\twinapi.dll	UWP 应用生命周期 API；终止、启动 Microsoft Store UWP 进程
Windows.AppStore.Runtime.dll	系统 WinRT 组件	实际重置逻辑实现主体；清理缓存目录、重置会话状态
kernelbase.dll	System32\kernelbase.dll	进程控制 API，TerminateProcess/CreateProcess

2）操作目标对象（WSReset 直接作用对象）

1. 进程对象：WinStore.App.exe（Microsoft Store UWP 主进程）
   • WSReset 先终止该进程，重置完成后自动拉起该进程
2. 用户缓存数据目录（用户配置隔离，只作用当前登录用户）

   %localappdata%\Packages\Microsoft.WindowsStore_8wekyb3d8bbwe\LocalState\Cache

   • HTTP 资源缓存、图标缓存、商店元数据临时文件；WSReset 删除该目录内容
3. 内存会话状态：Windows.AppStore.Runtime 内存级商店会话缓存；不碰磁盘上已安装 App、账户登录凭据、下载库、AppX 包注册信息。

⚠️ WSReset不修改注册表，不启停任何系统服务。

3）图形界面配套（等价能力，底层复用同一套 WinRT COM 接口）

1. 设置 → 应用 → 已安装应用 → Microsoft Store → 高级选项
   • 修复：仅修复损坏，不清理全部缓存
   • 重置：图形版 WSReset，清理缓存 + 重置运行状态；行为与 WSReset.exe 对齐Microsoft ...。

4）命令行 & PowerShell 脚本配套（故障分级兜底工具链）

WSReset 只解决缓存损坏；当商店包本身损坏，WSReset 无效，使用下面配套工具链做逐级修复。

工具	用途	和 WSReset 的配套关系
Get‑AppxPackage / Add‑AppxPackage PowerShell	重新注册 Microsoft Store 应用包	WSReset 失效后的兜底手段；修复 UWP 包注册损坏
sfc.exe	系统文件完整性校验	修复 combase、twinapi 等系统运行时 DLL 损坏
DISM.exe	修复 Windows 系统映像	WinRT 组件、系统组件损坏场景
icacls.exe	权限重置 Packages 目录 ACL	缓存目录权限锁定导致 WSReset 静默失败时修复目录权限

5）关联后台服务（WSReset 本身不调用、不启停，但商店业务依赖）

WSReset 运行不需要这些服务；但重置完成后商店下载 / 更新功能依赖它们，属于业务配套链，非 WSReset 运行依赖。

服务名	服务显示名称	角色
AppXSvc	AppX 部署服务	UWP/MSIX 包安装更新；WSReset 不操作该服务
BrokerInfrastructure	基础结构代理服务	UWP 应用代理运行基础
wuauserv	Windows Update	商店应用更新下载
BITS	后台智能传输服务	商店后台下载传输

6）数据载体配套

• 用户配置文件 %LOCALAPPDATA%：缓存目录父容器；用户配置文件损坏，WSReset 静默失败。
• Microsoft.WindowsStore_8wekyb3d8bbwe 整个 Package 目录：商店用户数据根目录；WSReset 只操作其中 Cache 子目录，其余不动。

7）完整配套链路调用时序

WSReset.exe（外壳入口）
    ↓
combase.dll 激活 Windows.AppStore.Runtime COM对象
    ↓
twinapi.dll 终止 WinStore.App.exe
    ↓
Runtime组件：清理Cache目录，清空内存会话缓存
    ↓
twinapi.dll 重新启动 WinStore.App.exe
    ↓
WSReset.exe进程退出

> 后续商店下载更新 → 依赖 AppXSvc / BITS / wuauserv（不属于WSReset执行链路）

8）配套链边界（关键区分）

1. 运行依赖 vs 业务依赖区分
   • ✅运行依赖：combase.dll、twinapi.dll、Windows.AppStore.Runtime.dll；缺失 WSReset 直接失效。
   • ❌AppXSvc、BITS、wuauserv：不是 WSReset 运行依赖；WSReset 可以正常跑完；只是重置完商店依旧不能下载应用。
2. WSReset 配套链严格用户隔离：只作用执行命令的当前用户；管理员运行也不能跨用户重置商店缓存。
3. WSReset 配套链只针对Microsoft.WindowsStore；不能重置其他 UWP 应用；其他 UWP 应用重置需要在设置高级选项或者 PowerShell。

---

WSReset.exe 命令行 / 脚本配套工具

WSReset.exe 本身不支持任何命令行参数，无 -help、‑quiet、‑verbose、‑log；传入参数全部被忽略；执行无控制台输出，仅靠行为现象判断结果。 配套工具分为三类：直接调用工具、同级修复工具（替代 / 增强 WSReset）、兜底修复工具（WSReset 失效场景）、诊断排查工具。

一、直接调用 WSReset.exe

CMD

:: 直接运行，无参数，执行完毕自动弹出微软商店
wsreset.exe

• 进程会短暂运行几秒后退出；成功标志：Microsoft Store 自动弹出窗口。
• 无返回码可以判断缓存是否清理成功，只能通过检测缓存目录、检测进程做间接判断。

PowerShell

# 等待执行完成再继续脚本
Start‑Process wsreset.exe -Wait

局限性：无法获取成功 / 失败状态码；失败时静默，不会抛异常。

---

二、同级替代工具：图形界面等价（可脚本间接调用）

设置应用内「重置 Microsoft Store」，底层复用同一套 Windows.AppStore.Runtime WinRT COM。

• 不提供独立 exe 命令行；只能 PowerShell 调用 WinRT COM 接口实现等价重置逻辑，替代 wsreset.exe。

三、兜底脚本配套工具（WSReset.exe 失效场景）

WSReset 只清理缓存目录 + 内存会话；遇到 UWP 包注册损坏、清单损坏、权限损坏，WSReset 无效，使用下面工具链。

1. Get‑AppxPackage / Add‑AppxPackage（PowerShell，最核心兜底）

作用：重新注册 Microsoft Store 应用包，修复包注册损坏，WSReset 搞不定时使用。

# 当前用户重新注册商店
Get‑AppxPackage Microsoft.WindowsStore | Foreach‑Object {
    Add‑AppxPackage -DisableDevelopmentMode -Register "$($_.InstallLocation)\AppXManifest.xml"
}

# 全部用户（管理员权限）
Get‑AppxPackage -AllUsers Microsoft.WindowsStore | Foreach‑Object {
    Add‑AppxPackage -DisableDevelopmentMode -Register "$($_.InstallLocation)\AppXManifest.xml"
}

• 对比 WSReset：WSReset 只清缓存；这套命令重新加载 UWP 应用清单，修复应用包本体损坏。

2. Remove‑AppxPackage + Add‑AppxPackage：重装商店

极端故障，先卸载用户侧包，再重新注册。

Get‑AppxPackage Microsoft.WindowsStore | Remove‑AppxPackage
Get‑AppxPackage -AllUsers Microsoft.WindowsStore | Foreach‑Object {
    Add‑AppxPackage -DisableDevelopmentMode -Register "$($_.InstallLocation)\AppXManifest.xml"
}

3. icacls.exe：修复 Packages 目录权限

场景：安全软件锁定缓存目录、ACL 权限异常，WSReset 静默失败删不掉 Cache 文件夹。

:: 修复当前用户Packages目录权限
icacls %localappdata%\Packages /reset /t /q

4. sfc.exe 系统文件检查器

修复 combase.dll、twinapi.dll 等 WSReset 依赖系统组件损坏。

sfc /scannow

5. DISM.exe 修复系统映像

WinRT/COM 运行时组件存储损坏，sfc 修复失败时使用。

DISM /Online /Cleanup‑Image /RestoreHealth

6. 服务管控脚本（业务配套，不是 WSReset 运行依赖）

WSReset 运行不需要这些服务；但重置完成后商店下载、更新功能依赖；故障排查脚本中经常配套启停。

# AppXSvc UWP部署服务
sc query AppXSvc
sc start AppXSvc

# BITS后台传输服务（商店下载）
sc query BITS
sc start BITS

四、诊断 & 校验脚本配套（判断 WSReset 执行效果）

WSReset 没有输出，脚本只能通过文件系统做校验。

# 校验商店缓存目录
$cachePath = "$env:LOCALAPPDATA\Packages\Microsoft.WindowsStore_8wekyb3d8bbwe\LocalState\Cache"
if(Test‑Path $cachePath){
    Write‑Output "缓存目录存在"
}else{
    Write‑Output "缓存目录已清除"
}

五、配套工具链使用流水线（故障分级）

1. 一级：wsreset.exe → 仅缓存异常场景
2. 二级：WSReset 无效 → PowerShell Add‑AppxPackage 重新注册商店包
3. 三级：权限报错 → icacls 修复 Packages 目录 ACL
4. 四级：系统组件损坏 → sfc /scannow
5. 五级：系统映像损坏 → DISM /Online /Cleanup‑Image /RestoreHealth
6. 六级：全部无效 → Remove‑AppxPackage 完全重装商店

六、边界说明

1. WSReset.exe 配套脚本工具中，只有 WSReset 本身是系统专门针对商店缓存的工具；其余 PowerShell、sfc、icacls 是通用系统工具，不是专门为 WSReset 开发。
2. AppXSvc/BITS/wuauserv 属于商店业务依赖服务，不是 WSReset 运行依赖服务；WSReset 可以正常跑完，但是商店依旧不能下载。
3. WSReset 只作用当前登录用户；PowerShell ‑AllUsers 参数可以处理机器级应用包。

---

WSReset是Windows操作系统中的一个命令行工具，它用于重置Windows Store应用商店的缓存和设置。

具体来说，WSReset代表Windows Store Reset，它的功能是清除Windows Store应用商店的临时文件、缓存和设置。当你遇到Windows Store应用商店相关问题时，例如无法下载或更新应用程序、无法打开应用商店等，使用WSReset可以尝试解决这些问题。

使用WSReset命令非常简单，只需按照以下步骤操作：

打开运行对话框：按下Win + R组合键，打开运行对话框。

输入命令：在运行对话框中输入"wsreset.exe"，然后按下Enter键。

等待运行：执行该命令后，会弹出一个命令窗口，并自动执行WSReset的操作。请耐心等待命令执行完成，期间可能会有窗口闪烁或消失。

重启系统（可选）：在执行WSReset后，有时需要重新启动计算机才能完全生效。

执行完WSReset命令后，Windows Store的缓存和设置将被重置为初始状态。然后，你可以尝试重新打开Windows Store并进行所需的操作，例如下载、更新或安装应用程序。

需要注意的是，WSReset只能解决与Windows Store应用商店相关的问题，对于其他系统或应用程序的问题无法起作用。如果WSReset无法解决你遇到的问题，可能需要进一步调查和采取其他方法来解决。