修复行程页面选项切换与排程逻辑,更新说明文档
黄河河南段文化数字档案 · 一轴黄河,一卷千年 把黄河河南段的 5 座城、6 个年代、15 处遗址,铺成一卷可以顺流而下、可以随时发问、可以排成一天行程的时空长卷。 第九届传智杯 · AI 鸿蒙赛道 | HarmonyOS NEXT / OpenHarmony(ArkTS + ArkUI) | API 12 · com.example.helanlu
黄河河南段文化数字档案 · 一轴黄河,一卷千年
把黄河河南段的 5 座城、6 个年代、15 处遗址,铺成一卷可以顺流而下、可以随时发问、可以排成一天行程的时空长卷。
第九届传智杯 · AI 鸿蒙赛道 | HarmonyOS NEXT / OpenHarmony(ArkTS + ArkUI) | API 12 · com.example.helanlu
com.example.helanlu
一个不是列表的文化档案。打开它,你先看到一张立轴;点「开卷」,河从屏幕顶端开始流,向下滑就是顺流而下,五座城依次展开;点任意一处遗址,半屏浮层从底下升起、上方仍露着河;读不懂的地方,问「小录」,它只按馆藏资料作答、每句话都带可点回的出处;想去看,说一句「周六一天,从郑州出发,带 8 岁小孩」,它把三座城排成一条带车程和票价的时间轴。
三件事是同一条河的三层:
[n]
底栏五格,对应”读 / 藏 / 问 / 望 / 行”:
长卷 ──── 读:卷首立轴 → 五城章节 → 卷尾 711 km,河道随屏蜿蜒 收藏 ──── 藏:收藏 / 笔记 / 拓片三栏,按年代筛,跨遗址汇总 小录 ──── 问:BM25 召回 131 段馆藏 → 星火 X2 → 逐字打字机 + 可点引用 文脉 ──── 望:5 城 × 6 代星座图,节点=到过/问过/记过,捏合缩放 + 拖动平移 行程 ──── 行:一句话 → 抽槽位 → 工具检索 → 模型只挑 ID → 本地排程 → 兜底
长卷上还叠着两枚入口:「河的一生」(六次治水叠在同一条河上,河道按史实改道)与 「巡航」(约 20 秒自动走完全卷,讲解词随城切换,可暂停退出)。顶栏是年代筛选 + 检索。
dataChange
distributedKVStore.SingleKVStore
autoSync
on('dataChange')
networkId
distributedDeviceManager
setWindowLayoutFullScreen(true)
getWindowAvoidArea
bindSheet
detents: [MEDIUM, LARGE]
Canvas
CanvasRenderingContext2D
animateTo
pageTransition
curve
preferences
spark-x2.6-1.7b
/v2/chat/completions
temperature=0.2
完整的参数、Prompt、状态机、成本估算与”明确没做的”,见 docs/AI能力说明.md。
docs/AI能力说明.md
┌──────────────────────────── 表现层 · pages/ (11 路由) ────────────────────────────┐ │ Index(长卷) Detail Search Favorites Themes ThemeDetail │ │ KnowledgeGraph Assistant Trip Trace SyncPanel │ │ 组件层:ScrollPrologue / ScrollHud / BottomNav / SiteCard / MileageRuler / │ │ CruiseOverlay / EraPicker / TraceConstellation / FloodTimeline … │ └───────────────────────────────────┬────────────────────────────────────────────────┘ │ 只调静态方法,不碰存储细节 ┌───────────────────────────────────┴────────────────────────────────────────────────┐ │ 能力层 · utils/ │ │ AiClient(星火) · AiConfig · XiaoluBrain(Prompt) · KnowledgeBase(BM25) │ │ TripAgent(状态机) · TripTools(事实表) · Mileage(里程) · RiverCourse(河道几何) │ │ TraceGraph · ThemeGraph · EraPalette(设计令牌) · AppRoute(路由表) · ZoomLevel │ └───────────────────────────────────┬────────────────────────────────────────────────┘ │ ┌───────────────────────────────────┴────────────────────────────────────────────────┐ │ 数据层 · data/ + model/ │ │ KVStoreManager(SingleKVStore) · FavoritesStore · NotesStore · SyncManager │ │ BackupUtils · DataLoader · DataModels │ └───────────────────────────────────┬────────────────────────────────────────────────┘ │ ┌───────────────────────────────────┴────────────────────────────────────────────────┐ │ 离线资源 · rawfile/ │ 分布式设备 │ 云端 │ │ sites.json(15) kb.json(131) │ 手机 ⇄ 平板(同一账号 / 同签名) │ 星火 MaaS │ │ flood_history.json extensions│ │ │ └─────────────────────────────────────────────────────────────────────────────────────┘
一句话技术骨架:长卷不是一张背景图,而是坐标系本身 —— 15 处遗址的横纵位置由「城市 × 年代」唯一确定,里程读数、章节跳转、巡航讲解、星图布点全部共用这一套坐标。改一处坐标,四处同时正确。
hongmeng/ ├── README.md ← 本文件(项目总览与导航) ├── docs/ ← ★ 交付文档(从这里读) │ ├── README.md 文档索引 + 提交要求逐条对照 │ ├── 作品说明文档.md 主文档,7 章(评委必读) │ ├── AI能力说明.md 大模型 / RAG / Agent / 密钥 / 成本 │ ├── 测试说明.md 环境、方法、11 组用例、已知问题 │ ├── 运行与体验说明.md 构建、配置、5 分钟动线、FAQ │ ├── 提交打包说明.md ZIP 结构、打包清单、体积控制 │ └── assets/ 9 张实机截图(1320×2232) ├── A/ ← ★ 唯一的 DevEco 工程根(用 DevEco 打开这一层) │ ├── AppScope/app.json5 bundleName: com.example.helanlu │ ├── build-profile.json5 compatibleSdkVersion 5.0.0(12) │ ├── entry/src/main/ets/ 84 个 .ets,约 2.35 万行 │ │ ├── entryability/ EntryAbility(全屏 + 库初始化) │ │ ├── pages/ 11 个路由页 + FloodTimeline(长卷内浮层) │ │ ├── components/ Scroll/ 与通用组件 │ │ ├── utils/ 能力层(AI / 几何 / 令牌 / 路由) │ │ ├── data/ 分布式 KV / 收藏 / 笔记 / 同步 / 备份 │ │ └── model/ 数据结构 │ ├── entry/src/main/resources/rawfile/ 离线数据与图片 │ └── README.md ★ 主开发文档(设计要点 + 踩坑记录) ├── demo/ 演示视频 ├── tools/ llm-proxy.js / strip-key.sh / package-submission.sh └── B/ 归档:早期原型,已不参与编译与交付
⚠️ 两个易错点: DevEco Studio 要打开 A/ 这一层,不是仓库根(根目录没有 build-profile.json5)。 B/ 与 A/A/ 是历史快照,不参与编译。打包脚本会排除 A/A/ 与 rawfile/_backup/; B/ 保留在 ZIP 内是为了说明数据层的演进,其 README 已标明”勿用”。
⚠️ 两个易错点:
A/
build-profile.json5
B/
A/A/
rawfile/_backup/
# 1. 构建(Windows Git Bash) cd A DEVECO_SDK_HOME="/e/DevEco Studio/sdk" \ node.exe "/e/DevEco Studio/tools/hvigor/bin/hvigorw.js" \ --mode module -p product=default assembleHap --no-daemon # 2. 安装(模拟器或真机) export PATH="/e/DevEco Studio/sdk/default/openharmony/toolchains:$PATH" hdc install -r entry/build/default/outputs/default/entry-default-unsigned.hap # 3. 启动 hdc shell aa start -a EntryAbility -b com.example.helanlu
模型密钥:A/entry/src/main/ets/utils/AiKey.ets,一把讯飞星火 MaaS 的 key(spark-x2.6-1.7b,免费模型)。 默认随包带着,评委装好即可试 AI。若想换形态,详见 docs/运行与体验说明.md §3:
A/entry/src/main/ets/utils/AiKey.ets
docs/运行与体验说明.md
tools/llm-proxy.js
http://<电脑局域网IP>:8787/v2
/v2
/v1
bash tools/strip-key.sh --check # 体检:列出源码里还在的 key(可选) bash tools/package-submission.sh # 一键出 ZIP
更省事的方式:用 DevEco Studio 打开 A/,勾选自动签名,直接 Run。见运行说明 §2.1。
docs/作品说明文档.md
docs/测试说明.md
docs/提交打包说明.md
A/README.md
docs/README.md
写在这里,比写在答辩时被问到更好:
demo/
文档版本 v1.0.0(2026-11-17)。主开发文档与踩坑记录见 A/README.md,交付文档索引见 docs/README.md。
版权所有:中国计算机学会技术支持:开源发展技术委员会 京ICP备13000930号-9 京公网安备 11010802047560号
河澜录
这是什么
一个不是列表的文化档案。打开它,你先看到一张立轴;点「开卷」,河从屏幕顶端开始流,向下滑就是顺流而下,五座城依次展开;点任意一处遗址,半屏浮层从底下升起、上方仍露着河;读不懂的地方,问「小录」,它只按馆藏资料作答、每句话都带可点回的出处;想去看,说一句「周六一天,从郑州出发,带 8 岁小孩」,它把三座城排成一条带车程和票价的时间轴。
三件事是同一条河的三层:
它要解决的三个断点
[n]点回原文,不编造功能地图
底栏五格,对应”读 / 藏 / 问 / 望 / 行”:
长卷上还叠着两枚入口:「河的一生」(六次治水叠在同一条河上,河道按史实改道)与 「巡航」(约 20 秒自动走完全卷,讲解词随城切换,可暂停退出)。顶栏是年代筛选 + 检索。
14 项能力与状态
鸿蒙与 AI 能力
HarmonyOS 原生能力
dataChange实时刷新distributedKVStore.SingleKVStore、autoSync、on('dataChange')networkId做手动 PUSH_PULL 兜底distributedDeviceManagersetWindowLayoutFullScreen(true)、getWindowAvoidAreabindSheet(detents: [MEDIUM, LARGE])Canvas+CanvasRenderingContext2DanimateTo、pageTransition、curvepreferencesAI 能力
spark-x2.6-1.7b,OpenAI 兼容/v2/chat/completions;关思考模式、temperature=0.2[n]角标落地技术架构
一句话技术骨架:长卷不是一张背景图,而是坐标系本身 —— 15 处遗址的横纵位置由「城市 × 年代」唯一确定,里程读数、章节跳转、巡航讲解、星图布点全部共用这一套坐标。改一处坐标,四处同时正确。
仓库结构
快速开始
模型密钥:
A/entry/src/main/ets/utils/AiKey.ets,一把讯飞星火 MaaS 的 key(spark-x2.6-1.7b,免费模型)。 默认随包带着,评委装好即可试 AI。若想换形态,详见docs/运行与体验说明.md§3:tools/llm-proxy.js代理:key 留在环境变量里,包里只有http://<电脑局域网IP>:8787/v2(路径原样转给上游,星火是/v2、DeepSeek 是/v1)文档导航
docs/作品说明文档.mddocs/作品说明文档.md§2 +docs/AI能力说明.mddocs/运行与体验说明.mddocs/测试说明.mddocs/提交打包说明.mdA/README.md(3.x 节,逐条带踩坑原因)docs/README.md§二已知边界
写在这里,比写在答辩时被问到更好:
autoSync+dataChange+ 时间戳仲裁 + 冲突计数 + 手动 PUSH_PULL),但双机复验需要在同一华为账号下的两台设备完成,当前提交的是单机可验部分 + 复验步骤(测试说明 §3.9)。提交物
A/docs/作品说明文档.mddocs/AI能力说明.mddocs/测试说明.mddocs/运行与体验说明.mddemo/数据与素材
文档版本 v1.0.0(2026-11-17)。主开发文档与踩坑记录见
A/README.md,交付文档索引见docs/README.md。