# wordmemory

**Repository Path**: stone4j/wordmemory

## Basic Information

- **Project Name**: wordmemory
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-24
- **Last Updated**: 2026-04-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# wordmemory

`wordmemory` 是一个词汇学习项目仓库，当前主要包含 HarmonyOS 客户端代码。

从现有代码看，这个应用的核心方向是：

- 背单词与复习
- 词书选择与已选词管理
- AI 阅读
- 签到、等级、单词上限、购买等个人中心能力

## 当前仓库状态

- `harmonyos/`：已存在较完整的 HarmonyOS 工程代码，是当前仓库的主实现。
- `flutter/`：当前仓库快照中未见实际 Flutter 应用源码，可视为预留目录。
- `output/analysis/`：保存了对 HarmonyOS 代码结构和功能的分析文档。

## 已实现的主要功能

根据当前 HarmonyOS 代码，已经落地或接入的模块包括：

- 手机验证码登录
- AGConnect 登录初始化
- 本地数据库初始化与内置词库恢复
- 背词主流程
- 记忆评级与复习统计
- 例句查看、自建例句、新增/编辑例句
- 收藏单词
- 词书/分类/已选单词管理
- AI 阅读场景选择与内容生成
- 签到与签到日历
- 个人中心
- 等级特权、单词上限、商品购买、购买历史

说明：

- 单选题、填空题页面目前仍是占位页。
- 部分运营能力已经接入，但整体工程结构还没有完全收口。

## 目录结构

```text
wordmemory/
+-- harmonyos/               # HarmonyOS 主工程
|   +-- AppScope/            # 应用级配置、资源、内置数据库、AGConnect 配置
|   +-- entry/               # 主模块
|   |   +-- src/main/ets/    # ArkTS 源码
|   |   |   +-- api/         # 后端接口封装
|   |   |   +-- db/          # 本地数据库、DAO、KVStore、Preferences
|   |   |   +-- pages/       # 页面与组件
|   |   |   +-- service/     # 部分业务服务层
|   |   |   +-- model/       # 数据模型
|   |   |   \-- algorithm/   # 记忆算法
|   \-- ...
+-- flutter/                 # 预留目录，当前快照未见实际应用源码
+-- output/
|   \-- analysis/            # 代码分析文档
+-- tmp/                     # 本地临时产物，不提交
+-- README.md
\-- README.en.md
```

## HarmonyOS 运行方式

当前仓库适合通过 DevEco Studio 打开并运行 HarmonyOS 工程。

### 运行前提

- 已安装 DevEco Studio
- 已安装对应 HarmonyOS SDK
- 本地具备签名与运行环境

### 打开方式

1. 用 DevEco Studio 打开 `harmonyos/`
2. 等待工程索引和依赖恢复
3. 选择 `entry` 模块
4. 在模拟器或真机上运行

### 说明

仓库中未提交以下本地环境文件：

- `harmonyos/local.properties`
- `harmonyos/build-profile.json5`

这是有意为之，因为它们通常包含：

- 本地 SDK 路径
- 本地签名文件路径
- 本地签名密码或相关敏感配置

如果你要在新环境运行，需要自行补齐这些本地配置。

## 本地数据与资源

HarmonyOS 客户端当前依赖以下本地资源：

- 内置数据库：
  - `harmonyos/AppScope/resources/rawfile/recite_words_rdb_init.db`
- AGConnect 配置：
  - `harmonyos/AppScope/resources/rawfile/agconnect-services.json`

应用启动时会将内置数据库恢复到本地沙箱，再通过 DAO 和 service 使用。

## 关键文档

- HarmonyOS 代码分析文档：
  - [output/analysis/harmonyos_code_analysis.md](./output/analysis/harmonyos_code_analysis.md)

该文档包含：

- 功能拆解
- 页面到接口映射
- 接口到本地表调用链
- 模块完成度判断
- 风险点与后续重构建议

## 当前已知情况

在目前代码中，可以明确观察到以下工程特点：

- 业务功能较多，主链路已经存在
- 分层不完全统一，部分页面直接调用 API 或 DAO
- 存在适合后续重构的问题点，例如：
  - DAO 注册键冲突风险
  - 支付/商品模块重复追加数据风险
  - 部分功能仍为占位实现

当前仓库先以“代码归档和功能沉淀”为主，后续再逐步重构更合适。

## 提交说明

仓库根目录已配置忽略规则，默认不会提交以下内容：

- `tmp/`
- `output/pdf/`
- `harmonyos/build-profile.json5`

这样可以避免把临时文件、生成产物和本地签名配置直接提交进仓库。