feat: update changelog and documentation for v2.0.2 release, add debug logging and fix timezone issues

Author: PythonSmall-Q

CHANGELOG.md

@@ -5,6 +5,24 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ---
 
+## [2.0.2] - 2026-07-27
+
+### Added
+
+- **Browser extension debug logging** — the browser extension now emits detailed `[TimeLens API]`, `[TimeLens BG]`, and `[TimeLens Popup]` console logs for connection discovery, cache decisions, session lifecycle, sync attempts, and bridge-signature checks, making it easier to diagnose connection issues in Edge/Chrome DevTools.
+- **Redesigned GitHub Pages documentation site** — rewrote all GitHub Pages HTML docs and added dedicated pages for the two extensions:
+  - `docs/browser-extension/index.html` — Edge/Chrome extension overview, install steps, connection settings (manual port, cache mode, auto fallback scan), and troubleshooting.
+  - `docs/vscode-extension/index.html` — VS Code extension overview, Marketplace/VSIX install, settings, commands, and troubleshooting.
+  - `docs/help/index.html` — user help center with quick start, FAQ, and scenario-based troubleshooting.
+  - Updated `docs/index.html` with v2.0.2 branding and links to the new pages; fixed footer links to use GitHub blob URLs for static-page compatibility.
+
+### Fixed
+
+- **Browser Usage timezone mismatch** — `browser_sessions.ended_at` is stored as UTC RFC3339 from the browser extension, but the desktop Browser Usage page queried by local date. This caused the page to appear empty when local midnight had passed while the session was still recorded on the previous UTC day. Queries in `get_browser_domain_stats`, `get_browser_domain_stats_for_hour`, and `get_browser_domain_today_seconds` now convert `ended_at` to local time (`date(ended_at, 'localtime')`) before comparing with user-facing dates.
+- **Duplicate React keys in Browser Usage** — recent session list keys now use `session.id` when available, falling back to a composite including the array index, preventing the "two children with the same key" warning when the same URL was visited within the same millisecond.
+
+---
+
 ## [2.0.1] - 2026-07-18
 
 ### Changed

docs/browser-extension/index.html

@@ -243,7 +243,7 @@ <h3>网页数据未显示在桌面端</h3>
         </div>
         <div class="trouble-card reveal">
           <h3>端口 49152 被占用</h3>
-          <p>TimeLens v2.0.1 桌面端会在 49152 被占用时自动扫描 <code>49152–50151</code> 并绑定到第一个可用端口。扩展侧也支持自动回退扫描，因此无需手动查找实际端口。</p>
+          <p>TimeLens v2.0.2 桌面端会在 49152 被占用时自动扫描 <code>49152–50151</code> 并绑定到第一个可用端口。扩展侧也支持自动回退扫描，因此无需手动查找实际端口。</p>
         </div>
       </div>
     </div>

docs/help/index.html

@@ -143,7 +143,7 @@ <h2>FAQ</h2>
           </button>
           <div class="faq-answer">
             <div class="faq-answer-inner">
-              <p>TimeLens v2.0.1 已内置端口回退机制：</p>
+              <p>TimeLens v2.0.2 已内置端口回退机制：</p>
               <ul>
                 <li>桌面端启动时若 49152 被 Windows 保留或安全软件拦截，会自动扫描 <code>49152–50151</code> 并绑定第一个可用端口。</li>
                 <li>桌面端的 Browser Usage / VS Code Insights 页面会显示当前实际绑定的本地 API 端口。</li>

docs/index.html

@@ -46,7 +46,7 @@
         <img src="assets/icon.png" alt="TimeLens" class="hero-icon" />
         <span>TimeLens</span>
         <span class="hero-badge-sep">·</span>
-        <span class="hero-badge-version" id="heroVersion">v2.0.1</span>
+        <span class="hero-badge-version" id="heroVersion">v2.0.2</span>
       </div>
       <h1 class="hero-title reveal">
         洞悉每一分桌面时光

docs/vscode-extension/index.html

@@ -282,7 +282,7 @@ <h3>数据未同步</h3>
         </div>
         <div class="trouble-card reveal">
           <h3>端口 49152 被占用</h3>
-          <p>TimeLens v2.0.1 桌面端会在 49152 不可用时自动扫描 <code>49152–50151</code> 并绑定到第一个可用端口。扩展也支持自动回退扫描；如未触发，请检查 <code>timelens.apiBaseUrl</code> 是否留空或正确。</p>
+          <p>TimeLens v2.0.2 桌面端会在 49152 不可用时自动扫描 <code>49152–50151</code> 并绑定到第一个可用端口。扩展也支持自动回退扫描；如未触发，请检查 <code>timelens.apiBaseUrl</code> 是否留空或正确。</p>
         </div>
       </div>
     </div>

package-lock.json

@@ -1,7 +1,7 @@
 {
   "name": "timelens",
   "private": true,
-  "version": "2.0.1",
+  "version": "2.0.2",
   "license": "MIT",
   "authors": [
     "Shan Wenxiao"

package.json

@@ -1,6 +1,6 @@
 [package]
 name = "timelens"
-version = "2.0.1"
+version = "2.0.2"
 description = "A screen time tracker and desktop widget manager"
 authors = ["Shan Wenxiao"]
 license = "MIT"

src-tauri/Cargo.lock

@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "TimeLens",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "identifier": "ShanWenxiao.TimeLens-TimeManagementAppwithWidgets",
   "build": {
     "beforeDevCommand": "npm run dev",