docs: polish product-style README

Author: liqi3333

README.md

@@ -1,52 +1,128 @@
 <div align="center">
   <h1>Thyroid TNM Tool</h1>
-  <p><strong>Standalone PC and mobile web app for thyroid cancer TNM staging and treatment planning.</strong></p>
+  <p><strong>Product-style PC and mobile web app for thyroid cancer TNM staging, treatment planning, and follow-up reference.</strong></p>
   <p><a href="README.zh-CN.md">简体中文</a> | <strong>English</strong></p>
+
   <p>
     <a href="https://github.com/liqi3333/thyroid/releases/latest"><img alt="Latest Release" src="https://img.shields.io/github/v/release/liqi3333/thyroid?display_name=tag&label=release" /></a>
+    <a href="https://github.com/liqi3333/thyroid/releases"><img alt="Downloads" src="https://img.shields.io/github/downloads/liqi3333/thyroid/total?label=downloads" /></a>
     <a href="https://github.com/liqi3333/thyroid/actions/workflows/build-html.yml"><img alt="Build HTML" src="https://github.com/liqi3333/thyroid/actions/workflows/build-html.yml/badge.svg" /></a>
     <a href="https://github.com/liqi3333/thyroid/actions/workflows/release.yml"><img alt="Release HTML" src="https://github.com/liqi3333/thyroid/actions/workflows/release.yml/badge.svg" /></a>
   </p>
+
   <p>
-    <a href="https://liqi3333.github.io/thyroid/"><img alt="Open Online" src="https://img.shields.io/badge/Open-Online%20Page-0ea5e9?style=for-the-badge" /></a>
+    <a href="https://liqi3333.github.io/thyroid/"><img alt="Open PC Web" src="https://img.shields.io/badge/Open-PC%20Web-0ea5e9?style=for-the-badge" /></a>
     <a href="https://liqi3333.github.io/thyroid/mobile.html"><img alt="Open Mobile Web" src="https://img.shields.io/badge/Open-Mobile%20Web-f59e0b?style=for-the-badge" /></a>
-    <a href="https://github.com/liqi3333/thyroid/releases/latest"><img alt="Download HTML" src="https://img.shields.io/badge/Download-Latest%20HTML-10b981?style=for-the-badge" /></a>
+    <a href="https://github.com/liqi3333/thyroid/releases/latest"><img alt="Download Latest HTML" src="https://img.shields.io/badge/Download-Latest%20HTML-10b981?style=for-the-badge" /></a>
   </p>
 </div>
 
 ## Overview
 
-This project packages both a standalone desktop HTML page and a separate mobile-optimized HTML page for thyroid cancer TNM staging, treatment planning, and follow-up suggestions into a shareable GitHub repository with release automation and GitHub Pages deployment.
+Thyroid TNM Tool packages a single-file clinical HTML interface into a deliverable product with a public GitHub repository, standalone HTML downloads, GitHub Pages deployment, and automated releases.
+
+It now provides two separate web entry points:
+
+- **PC web version**: preserves the original desktop-style layout
+- **Mobile web version**: a separate `mobile.html` optimized for phone browsers
+
+## Why this project is useful
+
+- Fast AJCC 8th edition thyroid cancer staging lookup
+- Treatment planning and follow-up suggestions in the same screen
+- No backend, no installation required for web usage
+- Can be opened online or downloaded as a standalone HTML file
+- Keeps PC and mobile experiences separate instead of forcing one responsive compromise
 
 ## Access
 
 - GitHub repository: <https://github.com/liqi3333/thyroid>
-- Online PC page: <https://liqi3333.github.io/thyroid/>
-- Online mobile page: <https://liqi3333.github.io/thyroid/mobile.html>
+- PC web page: <https://liqi3333.github.io/thyroid/>
+- Mobile web page: <https://liqi3333.github.io/thyroid/mobile.html>
 - Latest release: <https://github.com/liqi3333/thyroid/releases/latest>
+- All releases: <https://github.com/liqi3333/thyroid/releases>
+
+## Delivery formats
+
+The repository currently ships these forms:
+
+- `index.html`, original PC web version
+- `mobile.html`, separate phone-optimized version
+- Release asset: `Thyroid-TNM-Tool-1.0.1.html`
+- Release asset: `Thyroid-TNM-Tool-mobile-1.0.1.html`
+
+## Quick Start
+
+### Use online
+
+- Open the PC page: <https://liqi3333.github.io/thyroid/>
+- Open the mobile page: <https://liqi3333.github.io/thyroid/mobile.html>
+
+### Download standalone HTML
 
-## Local usage
+Download the latest files from:
 
-Open `index.html` directly in a browser, or generate the release-ready HTML file:
+- <https://github.com/liqi3333/thyroid/releases/latest>
+
+Then open either HTML file directly in a browser.
+
+### Build locally
 
 ```bash
 npm run build:html
 ```
 
-Output:
+Build outputs:
 
 ```text
 dist-html/Thyroid-TNM-Tool-1.0.1.html
 dist-html/Thyroid-TNM-Tool-mobile-1.0.1.html
 ```
 
-## Automation
+## Product highlights
+
+- Thyroid cancer TNM staging interface
+- Treatment plan and follow-up recommendation panel
+- Standalone offline-friendly HTML distribution
+- Separate PC and mobile web entry points
+- Public GitHub Pages deployment
+- Automated GitHub Actions build and release workflow
+- Bilingual project documentation
+
+## Release automation
+
+This repository includes GitHub Actions workflows for delivery automation.
+
+- Push to `main`: build validation and upload HTML artifacts
+- Push a tag such as `v1.0.1`: generate desktop and mobile standalone HTML files, then publish them to GitHub Releases
+- GitHub Pages serves both `index.html` and `mobile.html`
+
+Example:
 
-- Push to `main`: run HTML build and upload desktop + mobile workflow artifacts
-- Push a tag like `v1.0.1`: build both desktop/mobile HTML files and publish them to GitHub Releases
-- GitHub Pages serves `index.html` and `mobile.html`
+```bash
+git tag v1.0.1
+git push origin v1.0.1
+```
+
+## Project structure
+
+```text
+.
+├── docs/
+│   └── RELEASE_TEMPLATE.md
+├── scripts/
+│   └── build-html-release.js
+├── index.html
+├── mobile.html
+├── package.json
+├── README.md
+├── README.zh-CN.md
+└── .github/workflows/
+    ├── build-html.yml
+    └── release.yml
+```
 
 ## Notes
 
-- This repository currently focuses on the web version only
+- This repository currently focuses on web delivery only, not EXE packaging
 - Medical content is for informational use only and does not replace formal clinical decision-making

README.zh-CN.md

@@ -1,52 +1,128 @@
 <div align="center">
   <h1>Thyroid TNM Tool</h1>
-  <p><strong>甲状腺癌 TNM 分期与治疗计划网页工具，含 PC 原版与独立手机版</strong></p>
+  <p><strong>更像产品页展示的甲状腺癌 TNM 分期网页工具，含 PC 原版与独立手机版。</strong></p>
   <p><strong>简体中文</strong> | <a href="README.md">English</a></p>
+
   <p>
     <a href="https://github.com/liqi3333/thyroid/releases/latest"><img alt="最新版本" src="https://img.shields.io/github/v/release/liqi3333/thyroid?display_name=tag&label=release" /></a>
+    <a href="https://github.com/liqi3333/thyroid/releases"><img alt="下载次数" src="https://img.shields.io/github/downloads/liqi3333/thyroid/total?label=downloads" /></a>
     <a href="https://github.com/liqi3333/thyroid/actions/workflows/build-html.yml"><img alt="构建 HTML" src="https://github.com/liqi3333/thyroid/actions/workflows/build-html.yml/badge.svg" /></a>
     <a href="https://github.com/liqi3333/thyroid/actions/workflows/release.yml"><img alt="发布 HTML" src="https://github.com/liqi3333/thyroid/actions/workflows/release.yml/badge.svg" /></a>
   </p>
+
   <p>
-    <a href="https://liqi3333.github.io/thyroid/"><img alt="在线打开" src="https://img.shields.io/badge/在线打开-网页-0ea5e9?style=for-the-badge" /></a>
+    <a href="https://liqi3333.github.io/thyroid/"><img alt="打开 PC 网页" src="https://img.shields.io/badge/打开-PC%20网页-0ea5e9?style=for-the-badge" /></a>
     <a href="https://liqi3333.github.io/thyroid/mobile.html"><img alt="打开手机版网页" src="https://img.shields.io/badge/打开-手机版网页-f59e0b?style=for-the-badge" /></a>
-    <a href="https://github.com/liqi3333/thyroid/releases/latest"><img alt="下载 HTML" src="https://img.shields.io/badge/下载-最新%20HTML-10b981?style=for-the-badge" /></a>
+    <a href="https://github.com/liqi3333/thyroid/releases/latest"><img alt="下载最新 HTML" src="https://img.shields.io/badge/下载-最新%20HTML-10b981?style=for-the-badge" /></a>
   </p>
 </div>
 
 ## 项目简介
 
-这个项目把甲状腺癌 TNM 分期、治疗计划与随访建议工具，整理成了一个同时提供 PC 原版网页和独立手机版网页的 GitHub 项目。
+Thyroid TNM Tool 现在不只是一个单文件 HTML，而是已经整理成一个可公开访问、可自动发布、可在线使用的产品化网页项目。
+
+当前提供两个明确分开的入口：
+
+- **PC 网页版**：保留原始桌面布局与阅读体验
+- **手机版网页**：单独的 `mobile.html`，专门为手机浏览器优化
 
-## 入口
+## 这个项目现在有什么价值
+
+- 可快速查看甲状腺癌 AJCC 第 8 版 TNM 分期
+- 在同一页面查看治疗计划与随访建议
+- 无需后端，无需安装，网页可直接打开
+- 既可在线使用，也可下载独立 HTML 离线打开
+- 不强行做成同一套响应式，而是把 PC 和手机体验拆开做
+
+## 访问入口
 
 - GitHub 仓库：<https://github.com/liqi3333/thyroid>
-- 在线 PC 页面：<https://liqi3333.github.io/thyroid/>
-- 在线手机版页面：<https://liqi3333.github.io/thyroid/mobile.html>
+- PC 在线页面：<https://liqi3333.github.io/thyroid/>
+- 手机在线页面：<https://liqi3333.github.io/thyroid/mobile.html>
 - 最新 Release：<https://github.com/liqi3333/thyroid/releases/latest>
+- 全部 Releases：<https://github.com/liqi3333/thyroid/releases>
+
+## 当前交付形态
+
+仓库目前提供以下交付方式：
+
+- `index.html`，PC 原版网页
+- `mobile.html`，独立手机版网页
+- Release 附件：`Thyroid-TNM-Tool-1.0.1.html`
+- Release 附件：`Thyroid-TNM-Tool-mobile-1.0.1.html`
+
+## 快速开始
+
+### 直接在线使用
+
+- 打开 PC 网页：<https://liqi3333.github.io/thyroid/>
+- 打开手机版网页：<https://liqi3333.github.io/thyroid/mobile.html>
+
+### 下载独立 HTML
 
-## 本地使用
+从这里下载最新版本：
 
-直接用浏览器打开 `index.html` 即可，或者运行构建命令生成发布版 HTML：
+- <https://github.com/liqi3333/thyroid/releases/latest>
+
+下载后，直接用浏览器打开任意 HTML 文件即可。
+
+### 本地构建
 
 ```bash
 npm run build:html
 ```
 
-产物：
+构建产物：
 
 ```text
 dist-html/Thyroid-TNM-Tool-1.0.1.html
 dist-html/Thyroid-TNM-Tool-mobile-1.0.1.html
 ```
 
-## 自动化流程
+## 产品亮点
+
+- 甲状腺癌 TNM 分期界面
+- 治疗计划与随访建议面板
+- 可独立分发的 HTML 版本
+- PC 与手机分开的双入口网页
+- GitHub Pages 在线部署
+- GitHub Actions 自动构建与自动发布
+- 中英文双语文档
+
+## 自动发布流程
+
+仓库已内置 GitHub Actions 自动化交付流程。
+
+- 推送到 `main`：执行构建检查，并上传 HTML artifact
+- 推送形如 `v1.0.1` 的标签：自动生成 PC + 手机版独立 HTML，并发布到 GitHub Releases
+- GitHub Pages 同时托管 `index.html` 与 `mobile.html`
+
+示例：
 
-- 推送到 `main`：自动构建 HTML，并上传 PC + 手机版 artifact
-- 推送形如 `v1.0.1` 的标签：自动生成 PC/手机版独立 HTML 文件并发布到 GitHub Releases
-- GitHub Pages 直接托管 `index.html` 和 `mobile.html`
+```bash
+git tag v1.0.1
+git push origin v1.0.1
+```
+
+## 项目结构
+
+```text
+.
+├── docs/
+│   └── RELEASE_TEMPLATE.md
+├── scripts/
+│   └── build-html-release.js
+├── index.html
+├── mobile.html
+├── package.json
+├── README.md
+├── README.zh-CN.md
+└── .github/workflows/
+    ├── build-html.yml
+    └── release.yml
+```
 
-## 说明
+## 注意事项
 
-- 当前仓库只做网页版本，不含 EXE
+- 当前仓库只做网页交付，不含 EXE
 - 医学内容仅供信息参考，不替代正式临床决策