feat: 增加客户端授权测试工具说明

docs/guide/client-simulator.md

@@ -0,0 +1,44 @@
+# 客户端授权测试工具 (Client Simulator)
+
+为了方便您快速了解和测试 License Manager SDK（特别是基于 Python 的客户端体验），我们提供了一个基于桌面环境的 **客户端授权测试工具 (Client Simulator)** Demo。该工具主要模拟了机器视觉应用软件等客户端的典型鉴权与管控流程。
+
+您可以在 Python SDK 的 `examples/客户案例1` 目录下找到相关代码与设计文档。
+
+### ⬇️ 下载体验
+
+- **Windows 64位 独立可执行程序**: [LMClientSimulator-win64.exe](https://github.com/cedar-v/license-manager-sdk-python/releases/download/v1.0.1/LMClientSimulator-win64.exe)
+
+## 界面概览
+
+该 Demo 直观展示了设备指纹识别、授权状态、本地激活与云端实时管控的实际运行效果。
+
+![Client Simulator](/images/LMClientSimulator-win64.png)
+
+## 核心功能区
+
+工具界面分为三个主要部分，以保证授权状态的透明与实时性：
+
+### 1. 设备识别与状态显式区 (Top Panel)
+- **设备指纹 (Hardware ID)**: 自动提取当前机器的唯一硬件特征 Hash（实现“一机一码”防滥用）。您可以一键复制该指纹用于后台人工派发离线许可。
+- **当前授权状态**: 通过红绿灯及文字醒目提示当前授权是合法（试用中/已授权）还是异常（未激活/已过期/被封禁）。
+- **设备额度与有效期**: 透明展示当前许可证的使用限制与过期时间。
+
+### 2. 授权操作区 (Middle Panel)
+- **产品激活码输入**: 
+  - **在线激活**: 输入纯 `LIC-xxxx` 格式激活码，联网状态下自动向云端服务器请求下发许可。
+  - **离线侧载**: 针对无外网隔离环境，输入包含 `&` 的完整离线鉴权信封数据，工具会提取信封内容并落盘，实现物理隔离下的极速验证。
+- **清理本地缓存**: 一键删除本地生成的 `license.lic`，快速重置工具为“未授权”状态，方便反复测试。
+
+### 3. 业务模拟与底座日志区 (Bottom Panel)
+- **启动业务检测 (模拟按钮)**: 模拟核心业务（例如机器视觉检测）引擎的启动。点击前触发鉴权：
+  - 若在有效授权期内：成功弹窗。
+  - 若授权无效或被心跳钩子锁定：阻拦执行并警告。
+- **运行控制台日志**: 透明展示底座心跳情况（如每30秒向服务端尝试上报状态）和网络行为。即使网络短暂断开，通过混合鉴权机制也不会卡死业务。
+
+## 高频测试场景建议
+
+我们建议您通过以下几个常见场景测试授权体系的稳健性：
+
+1. **断网环境的秒级验签**：拔掉网线，粘贴包含 `&` 的完整离线鉴权码并激活，验证无网极速通过并成功点击启动模拟业务。
+2. **连接网络下的防白嫖稽核**：恢复网络，此时可以在 SaaS 后台强制踢出该设备绑定的许可或执行解绑操作。
+3. **心跳毫秒级阻断响应**：等待一个心跳周期（工具内默认缩短为30秒用于演示），一旦心跳反馈“被封禁”，无需重启程序，界面秒变红，并自动阻断核心业务的执行。

docs/guide/sdk.md

@@ -4,7 +4,12 @@ License Manager 提供可复用的客户端 SDK，涵盖许可证解析、验签
 
 ## 快速入口
 
-- GitHub 仓库（含 README、示例与 API 说明）：[https://github.com/cedar-v/license-manager-sdk-go](https://github.com/cedar-v/license-manager-sdk-go)
+目前官方提供了以下语言的客户端 SDK 仓库（含 README、示例与 API 说明）：
+
+- **Go SDK**: [https://github.com/cedar-v/license-manager-sdk-go](https://github.com/cedar-v/license-manager-sdk-go)
+- **Python SDK**: [https://github.com/cedar-v/license-manager-sdk-python](https://github.com/cedar-v/license-manager-sdk-python)
+  - PyPI 安装: `pip install cedarv-license-manager-sdk`
+
 - 许可证结构参考：[`/guide/license-token-structure`](/guide/license-token-structure)
 
 > SDK 具体使用方法（安装、配置、代码示例等）请直接参考仓库 README；这里只保留索引，确保信息只维护一份。