From 252b7088cf63633156aad260763f2e67c6dbe592 Mon Sep 17 00:00:00 2001 From: void Date: Sun, 8 Nov 2026 21:15:15 +0800 Subject: [PATCH] =?UTF-8?q?chore:=20=E5=88=9D=E5=A7=8B=E5=8C=96=20word-mar?= =?UTF-8?q?ket=20monorepo=20=E9=AA=A8=E6=9E=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 添加根 README:三个子项目(importer/frontend/backend)的定位与数据产物说明 - 添加 .gitignore:忽略 importer 数据产物、反编译产物、本地数据库与常见构建缓存 Co-Authored-By: Claude Sonnet 4.6 --- .gitignore | 40 ++++++++++++++++++++++++++++++++++++++++ README.md | 35 +++++++++++++++++++++++++++++++++++ backend/README.md | 7 +++++++ frontend/README.md | 7 +++++++ 4 files changed, 89 insertions(+) create mode 100644 .gitignore create mode 100644 README.md create mode 100644 backend/README.md create mode 100644 frontend/README.md diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..f53d388 --- /dev/null +++ b/.gitignore @@ -0,0 +1,40 @@ +# ---- OS / editor ---- +Thumbs.db +Desktop.ini +.DS_Store +.idea/ +.vscode/ +*.swp + +# ---- Python ---- +__pycache__/ +*.py[cod] +*.egg-info/ +.venv/ +venv/ +.pytest_cache/ +.mypy_cache/ +.ruff_cache/ +.coverage +htmlcov/ + +# ---- Node / frontend / backend ---- +node_modules/ +dist/ +build/ +.next/ +coverage/ +*.tsbuildinfo +.env +.env.* + +# ---- importer:本地数据、产物与大文件(不进 Git) ---- +/importer/output/ +/importer/assets/ +/importer/bin/ +/importer/jadx-out/ +/importer/.runtime/ +/importer/lexis.db + +# ---- 日志 ---- +*.log diff --git a/README.md b/README.md new file mode 100644 index 0000000..0b4d33d --- /dev/null +++ b/README.md @@ -0,0 +1,35 @@ +# word-market + +单词数据 Monorepo,包含三个子项目: + +| 目录 | 项目 | 状态 | 说明 | +|---|---|---|---| +| `importer/` | 单词导入 | 已有 | 从 Lexis 导出词书与词条,建库并导入 SQLite/PostgreSQL/MySQL | +| `frontend/` | 单词管理前端 | 占位 | 待定技术栈 | +| `backend/` | 单词管理后端 | 占位 | 待定技术栈 | + +## 快速开始 + +单词导入流程见 [`importer/README.md`](importer/README.md)。命令需在 `importer/` 目录下执行: + +```powershell +cd importer +python run.py +``` + +## 数据与产物 + +`importer/` 下的数据与研究产物不纳入 Git(见 `.gitignore`),仅保留在本机: + +- `importer/output/`:导出数据(约 6.8G) +- `importer/assets/wordroot.db`:词根/词族/近义词源数据库 +- `importer/bin/`、`importer/jadx-out/`:APK、反编译与调试工具 +- `importer/.runtime/`、`importer/lexis.db`:本地运行时与 SQLite 数据库 + +Git 只跟踪源码、文档与配置。 + +## 文档 + +- 导入流程与算法:[`importer/README.md`](importer/README.md) +- 数据实体关系模型:[`importer/docs/DATA-MODEL.md`](importer/docs/DATA-MODEL.md) +- ZPK 解密内容分析:[`importer/docs/zpk-decrypted-content-analysis.md`](importer/docs/zpk-decrypted-content-analysis.md) diff --git a/backend/README.md b/backend/README.md new file mode 100644 index 0000000..58ebe97 --- /dev/null +++ b/backend/README.md @@ -0,0 +1,7 @@ +# backend — 单词管理后端 + +占位目录,技术栈待定。 + +用途:为 `frontend` 提供词书、词条及关联数据的查询与编辑接口,数据来源为 `importer` 生成的数据库。 + +后续确定技术栈与目录结构后在此实现。 diff --git a/frontend/README.md b/frontend/README.md new file mode 100644 index 0000000..394213b --- /dev/null +++ b/frontend/README.md @@ -0,0 +1,7 @@ +# frontend — 单词管理前端 + +占位目录,技术栈待定。 + +用途:浏览、检索、编辑与管理由 `importer` 导入的词书、词条及其关联数据。 + +后续确定技术栈与目录结构后在此实现。