# learn-map **Repository Path**: markets2022/learn-map ## Basic Information - **Project Name**: learn-map - **Description**: 成长地图 · 家长亲子学习导航(基于 Marble Skill Taxonomy) - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-08-30 - **Last Updated**: 2026-10-31 ## Categories & Tags **Categories**: Uncategorized **Tags**: 小程序, 微信小程序 ## README # 成长地图 · learn-map > 家长 × 孩子学习导航小程序 · 基于 Marble Skill Taxonomy(知识分类法) > 微信小程序 · 1590 个知识点全量中文 + 中 / 英 / 双语 UI ## 项目简介 「成长地图」是一款面向 **家长与孩子** 的微信小程序。它把庞杂的知识体系按 **Marble Skill Taxonomy** 分类法组织成一张可探索的「技能地图」,让家长清楚看到 孩子当前掌握的知识点、它依赖哪些前置能力(前置追溯),以及下一步该解锁什么。 - **1590 个知识点**,全量中文翻译,每条保留 `{{占位符}}` 模板。 - **中 / 英 / 双语** 三种界面语言,可一键切换(数据层 `x||原文` 回退英文)。 - **依赖图引擎**:根据知识点之间的先修关系,自动算出「前置能力链」与「可解锁集合」。 ## 功能 | 页面 | 说明 | | --- | --- | | 欢迎页 `pages/welcome` | 主包入口,选择语言后进入地图 | | 知识地图首页 `map/pages/index` | 按领域展示知识点,点击进入详情 | | 领域 `map/pages/domain` | 单个领域下的知识点总览 | | 知识点列表 `map/pages/topiclist` | 某领域知识点清单 | | 知识点详情 `map/pages/concept` | 知识点释义、前置 / 后继关系 | ## 技术架构 ### 分包结构(规避微信包体限制) 微信对代码包有硬性限制:**主包 < 1.5MB**(代码质量扫描)、**分包 < 2MB**。 总数据约 2.6MB,因此采用「主包 + 单分包」拆分: ``` learn-map/ ├── app.js / app.json / app.wxss # 小程序入口、全局配置、全局样式 ├── project.config.json # 项目配置(packOptions.ignore 排除 work/build) ├── pages/welcome/ # 主包:欢迎页(必须在主包) ├── data/topicsA.min.js # 主包数据:前 795 条(~1MB,主包预载到 globalData) ├── map/ # 分包 root │ ├── pages/{index,domain,topiclist,concept}/ │ ├── graph.js # 依赖图引擎(建索引 + 前置追溯 + 解锁遍历) │ ├── utils/ # i18n / lang 等跨页同步逻辑 │ └── data/ # 分包数据:topicsB / dependencies / clusters ├── build/ # 数据处理脚本(Node 运行,详见下文) └── work/ # 开发中间产物(已被 .gitignore 排除,不上传) ``` - **主包**仅放欢迎页 + `topicsA`(795 条),约 1.0MB。 - **分包**放地图四个页面 + `topicsB / dependencies / clusters`,约 1.6MB。 - 主包在 `app.js` 启动预载 `topicsA` 到 `globalData`,分包 `graph.js` 从 `globalData` 读取并拼接 `topicsB` 建索引(**不能跨包 `require` 主包 JSON**,故走 globalData 桥接)。 ### 数据层 四个数据文件均为 **`.js` 模块**(`module.exports = {...}`),因为微信 `require()` **只加载 `.js`,不加载 `.json`**(直接 `require('x.json')` 会报 `module 'x.json.js' is not defined`)。 | 文件 | 位置 | 内容 | 体积 | | --- | --- | --- | --- | | `data/topicsA.min.js` | 主包 | 前 795 个知识点(含中文 `nC/deC/evC/apC` 字段) | ~1MB | | `map/data/topicsB.min.js` | 分包 | 后 795 个知识点 | ~1.1MB | | `map/data/dependencies.min.json` → `.js` | 分包 | 先修依赖边(3221 条) | ~450KB | | `map/data/clusters.min.js` | 分包 | 领域聚类(183 条) | ~73KB | 知识点双语字段:`nC` 名称(中) / `deC` 描述(中) / `evC` 示例(中) / `apC` 应用(中); 原文为英文 `name/description/examples/application`,中文缺失时 UI 回退英文。 ### graph.js 依赖图引擎 - `getGraph()`:延迟加载(首次进入地图页 `setTimeout` 解析 2.6MB 数据),避免同步卡死。 - `getDirectPrereqs(id)` / `getAncestors(id)`:前置追溯。 - `getDomains(name)`:领域查询。 ## 本地构建 / 数据处理(build/) 这些脚本在 **Node.js** 环境运行(不是小程序运行时),用于生成 / 拆分数据: | 脚本 | 作用 | | --- | --- | | `build/_datautil.js` | 统一读写 `.js` 数据模块的辅助函数 | | `build/split_topics.js` | 将全集拆为 `topicsA`(主包) / `topicsB`(分包) | | `build/merge.js` | 合并依赖 / 聚类数据 | | `build/compact.js` | ⚠️ 已废弃:会从英文原始重生「仅英文」数据顶爆主包,**不要运行** | | `build/inject.js` | 向知识点注入中文翻译 | | `build/translate.js` | 翻译批处理 | | `build/fix_missing.js` | 补全缺失字段 | | `build/size_check.js` | 测算主包 / 分包体积(排除 work/build/node_modules) | ## 运行 / 部署 1. 微信开发者工具 → 导入项目 → 选择本目录(AppID:`wxfcab669405be6d9c` 或测试号)。 2. 首次运行务必点 **「清缓存并重新编译」**,避免 devtools 缓存旧的 `.json` 引用。 3. 真机预览 / 上传:主包 ~1.0MB、分包 ~1.6MB,均符合微信限制。 ## 注意事项 - 微信 `require()` 只认 `.js`:数据文件一律 `.js`,不要改回 `.json`。 - 分包不能跨包 `require` 主包资源:主包数据走 `app.globalData` 桥接。 - `project.config.json` 的 `packOptions.ignore` 已排除 `work/`、`build/`,仅作用于微信上传包,不影响 git。 - `build/compact.js` 已废弃,运行会破坏数据,勿用。 ## 仓库状态 - **私有仓库**,不对外开源。 - 所有者:`markets2022`(盛通教育 / 盘古云鼎 课程资源账号)。 --- © 2026 盛通教育 · 超能 AI 工坊