docs: 添加中文版README并更新英文版README链接

添加中文版README文档,包含本地预览和开发环境搭建指南
更新英文版README,添加中英文版本切换链接
This commit is contained in:
rionzhao 2025-11-06 19:12:01 +08:00
parent 091d3ae208
commit 3a918509fa
2 changed files with 88 additions and 10 deletions

View File

@ -1,5 +1,7 @@
# apps.apple.com Archive # apps.apple.com Archive
**[中文版本](./README_CN.md)** | **English Version**
## Please star this repo!!! 😭😭😭 ## Please star this repo!!! 😭😭😭
## Ads ## Ads
@ -142,13 +144,3 @@ The source code was obtained from publicly accessible resources through browser
The content in this repository belongs to Apple Inc. If there are any copyright concerns, please contact for removal. The content in this repository belongs to Apple Inc. If there are any copyright concerns, please contact for removal.
---
*Remember: Always disable sourcemaps in production! 😉*
## Related
- [Apple App Store](https://apps.apple.com/)
- [Save All Resources Extension](https://chromewebstore.google.com/detail/save-all-resources/abpdnfjocnmdomablahdcfnoggeeiedb)
![](https://rs2.deno.dev/2u841r/apple)

86
README_CN.md Normal file
View File

@ -0,0 +1,86 @@
# apps.apple.com 归档
---
# 安装与运行(本地预览指南)
这个项目是一份从线上提取的 Svelte/TypeScript 前端归档。仓库同时包含已编译的静态产物(`assets/`、`us/` 等)和源码(`src/`、`shared/`)。下面给出两种常用的本地运行方式:快速静态预览(推荐,零构建)和完整版源码运行(需补齐依赖与私有包)。
---
## 方法 A — 快速静态预览(推荐)
目的:直接预览仓库中已编译的 HTML/CSS/JS无需安装 Node 或构建)。
步骤PowerShell
```powershell
# 进入仓库根目录(示例)
Set-Location -Path 'd:\dragon\page\apps.apple.com-main'
# Mac 用户可以直接在根目录里面运行以下代码!!!!!
# 启动一个简单的静态 HTTP 服务器(在 8080 端口)
python -m http.server 8080
# 在浏览器中打开(示例页面)
# http://localhost:8080/us/iphone/today.html
```
说明:我已在仓库根启动并测试过该静态服务器。如果浏览器仍然报 404可能是 HTML 引用的资源名与 `assets/` 中实际文件名不一致(例如 HTML 请求 `/assets/index~B87DnNzwx-.js` 但磁盘上是 `indexB87DnNzwx-.js`)。为方便本地预览,我已为部分常见的 tilde (~) 变体创建了文件副本,并在仓库根添加了一个最小 `manifest.json`(供 `/manifest.json` 请求使用)。
已创建的兼容文件(示例):
- `assets/index~B87DnNzwx-.js`(从 `assets/indexB87DnNzwx-.js` 复制)
- `assets/index~C-lllyUtRG.css`(从 `assets/indexC-lllyUtRG.css` 复制)
- `manifest.json`(仓库根,最小 PWA manifest
如果你仍然看到 404请在终端中查看服务器日志它会显示缺失的路径。我可以帮你自动为这些引用创建兼容副本或修改 HTML 指向现有文件名(后者有破坏性)。
---
## 方法 B — 从源码运行(开发环境,需构建)
目的:使用 Svelte/TypeScript 源码进行热重载开发或重新构建产物。注意:仓库引用了私有包(例如 `@amp/*`),可能无法直接从公共 registry 安装。
主要步骤(概要):
1. 安装 Node.js建议 v18+)并在 PowerShell 中确认 `node``npm` 可用。
2. 在仓库根创建一个 `package.json`(示例见下)。
3. 安装必要的依赖(例如 `svelte`, `vite`, `typescript`, `sass` 等)并处理 `@amp/*` 私有包(本地 stub、私有 registry 或替换)。
4. 运行 `npm run dev`(或你在 `package.json` 中定义的脚本)。
示例 `package.json`(供参考 — 需要按项目实际情况调整):
```json
{
"name": "appstore-local",
"private": true,
"version": "0.0.0",
"scripts": {
"dev": "vite",
"build": "vite build",
"preview": "vite preview"
},
"devDependencies": {
"vite": "^5.0.0",
"svelte": "^4.0.0",
"@sveltejs/vite-plugin-svelte": "^2.0.0",
"typescript": "^5.0.0",
"sass": "^1.0.0"
}
}
```
重要提示:
- 私有包 `@amp/*`:如果代码中大量 `import '@amp/...'`,你需要一个可访问的 registry 或在 `node_modules` 中放置本地实现stub。我可以帮你生成最小的本地 stub 包来满足构建,但这可能只够让项目启动而不保证所有功能完好。
- 构建时间和依赖大小:安装依赖和首次构建会花时间(取决于网络和硬盘)。
示例安装与启动PowerShell
```powershell
Set-Location -Path 'd:\dragon\page\apps.apple.com-main'
# 如果你已经添加了 package.json
npm install
npm run dev
```