Ethscriptions commited on
Commit
05eff32
·
verified ·
1 Parent(s): 981118a

docs: mini tool README describes sweet-potato adventure

Browse files
Files changed (1) hide show
  1. miniapp/README.md +2 -2
miniapp/README.md CHANGED
@@ -41,7 +41,7 @@
41
  | 9 | **触感与互动** | 「再抽一张」「收藏」「分享图」点击时触发震动,并有按下回弹动效;挑战里答对轻震、答错连震两下、交卷中震。`buzz(kind)` 依次尝试 `xhs.miniTool.vibrateShort({type})` → `xhs.vibrateShort` → `navigator.vibrate(pattern)`,兼容回调 / Promise,失败静默;40 ms 内防重复。开启「减少动态效果」时关闭回弹。 |
42
  | 8 | **页脚 / 关于** | 页脚:出处与 CC BY 4.0、免责声明、代币声明。关于页:小票怎么读、A/B/C 证据等级原文定义、「性价比极高」口径、出处与许可(作者 eternity4719、仓库、许可证地址、改动说明与数据同步日期)、免责声明、代币声明(「本项目从未发行、也不会发行任何代币或数字资产」)、隐私说明。 |
43
  | 9 | **状态与性能** | 无结果:空白小票 +「无」字印章 + 原因 + 建议词 + 「清空搜索和筛选」;收藏为空有引导。列表分批渲染(首批 14 张,IntersectionObserver 提前 800px 每次追加 30 张)。数据两包:`data.js`(478 KB,首屏字段)同步加载,`data-full.js`(1.79 MB,收益 / 来源 / 备注)`async` 加载,到位后自动补全打开着的详情、重算搜索。 |
44
- | 10 | **挑战(驾校宝典式题库)** | 765 条建议逐条人工改写成 **2005 道题**(判断题 675 · 二选一 690 · 四选一 640),每题有正确答案、解析和原文出处;二选一 / 四选一的选项每次打乱。玩法:**今日挑战**(每天 5 题,按日期固定,连续打卡)· **模拟考试**(20 题 × 5 分,限时 10 分钟,90 分合格,到时自动交卷)· **顺序练习**(记住进度)· **随机练习**(优先出没做过的)· **章节闯关**(34 关,正确率 60 / 80 / 100% 得 1–3 星)· **错题本**(答错自动收入,连续答对 2 次移出)· **收藏题**。答题页:即时判对错(绿 / 红 + 震动)、解析卡 + 原书小票 +「看原文」、答题卡跳题、背题模式、答对自动下一题、左右滑动切题。结果页:分数、称号、合格章、用时、正确率,错题解析 / 错题再练 / 再来一轮,**成绩单分享图**(3:4,存相册 / 发笔记)。建议详情页底部有「考考自己」。所有记录只存本机。题库源文件、出题规范与校验脚本在 `htlb/miniapp/quiz-src/`。 |
45
 
46
  **动效**:卡片进场上浮 + 回弹(`cubic-bezier(0.34,1.56,0.64,1)`,320 ms);印章「盖下」340 ms;抽卡打印 620 ms;浮层滑入 340 ms;抽屉可下拉跟手关闭。`prefers-reduced-motion: reduce` 时全部关闭。
47
 
@@ -69,7 +69,7 @@
69
  - 小红书容器中导出前执行 `getFollowStatus`;未关注则提示并调用 `followAuthor`,关注状态二次确认成功才允许导出。作者本人状态会视为已满足门槛;若预览弹窗显示空白头像,通常是当前预览尚未绑定小红书工具作者身份,需要在小红书平台配置作者账号后再测。普通浏览器不具备关注 API,则直接本地生成 PDF。
70
  - PDF 改为点击时本地生成:工具包只保留轻量数据、生成器和 3:4 封面,不再携带 10 MB 级 PDF 或字体文件。生成的 PDF 使用标准中文字体映射,完成后才写入临时文件并交给 `saveFile` / `openDocument`;不会主动联网。
71
  - 震动改为多级探测(见功能 9),接入再抽、收藏、分享图、PDF 导出 / 分享和挑战答题;不支持时静默降级。分享笔记标签扩展为健康急救、防骗指南、理财避坑、时间管理、开源阅读、安全意识、自我提升等相关主题,���保留 CC BY 4.0 出处和免责声明。
72
- - 「反问」栏目已升级为「挑战」(见功能 10),旧的模板式问题已移除。
73
  - PDF 不再作为静态资源上传;用户导出时本机生成完整 PDF。工具包保留 `cover-3x4.jpg` 作为导出面板预览,生成器另有简洁文字封面,因此不会因为 PDF 或字体文件导致上传包超过 10 MB。
74
 
75
  ## 文件清单与大小
 
41
  | 9 | **触感与互动** | 「再抽一张」「收藏」「分享图」点击时触发震动,并有按下回弹动效;挑战里答对轻震、答错连震两下、交卷中震。`buzz(kind)` 依次尝试 `xhs.miniTool.vibrateShort({type})` → `xhs.vibrateShort` → `navigator.vibrate(pattern)`,兼容回调 / Promise,失败静默;40 ms 内防重复。开启「减少动态效果」时关闭回弹。 |
42
  | 8 | **页脚 / 关于** | 页脚:出处与 CC BY 4.0、免责声明、代币声明。关于页:小票怎么读、A/B/C 证据等级原文定义、「性价比极高」口径、出处与许可(作者 eternity4719、仓库、许可证地址、改动说明与数据同步日期)、免责声明、代币声明(「本项目从未发行、也不会发行任何代币或数字资产」)、隐私说明。 |
43
  | 9 | **状态与性能** | 无结果:空白小票 +「无」字印章 + 原因 + 建议词 + 「清空搜索和筛选」;收藏为空有引导。列表分批渲染(首批 14 张,IntersectionObserver 提前 800px 每次追加 30 张)。数据两包:`data.js`(478 KB,首屏字段)同步加载,`data-full.js`(1.79 MB,收益 / 来源 / 备注)`async` 加载,到位后自动补全打开着的详情、重算搜索。 |
44
+ | 10 | **红薯冒险(答题打怪)** | 题库 2005 题(765 条建议逐条改写、全量复核),难度由决策模型 `lingdt-decision-1.0-27b` 离线逐题评分,按模型分数排序切成 8 级,对应 8 种怪物:泥浆史莱姆 · 毛毛虫 · 冰蛞蝓 · 土豆怪 · 杂草怪 · 强盗乌鸦 · 铲子魔像 · 焦黑土豆王(BOSS)。怪物出题、15 秒作答,作答前主角和怪物都在播放待机动画;答对 → 主角攻击 → 怪物受伤 → 击败动画 →「+N EXP」(N = 怪物等级);答错 / 超时 → 怪物攻击 → 主角受伤、画面抖动 → 扣血(1–2 级怪扣 1,3–4 扣 2,5–6 扣 3,7–8 扣 4),同一只怪换一道同级题。主角 5 级:红薯芽芽 → 红薯小妹 → 红薯少女 → 红薯女武神 → 红薯女王,每级 400 经验,升级有进化画面;主角等级越高越容易遇到高级怪和 BOSS。每天 1 条命 = 10 点血,0 点回满;血量归零后「发图文 / 做成图集 / 发评论」晒战绩即满血复活,不限次数。首页有状态栏(头像、等级、经验条、血量)、今日战绩、进化之路、怪物图鉴(首次击败解锁)、「晒今日战报」(3:4 战报图 + 题卡)。小红书官方能力清单没有排行榜接口,因此不做排行榜。精灵图来自 `素材3/`(47 个动画条),处理脚本见 `htlb/miniapp/sprite-src/`。 |
45
 
46
  **动效**:卡片进场上浮 + 回弹(`cubic-bezier(0.34,1.56,0.64,1)`,320 ms);印章「盖下」340 ms;抽卡打印 620 ms;浮层滑入 340 ms;抽屉可下拉跟手关闭。`prefers-reduced-motion: reduce` 时全部关闭。
47
 
 
69
  - 小红书容器中导出前执行 `getFollowStatus`;未关注则提示并调用 `followAuthor`,关注状态二次确认成功才允许导出。作者本人状态会视为已满足门槛;若预览弹窗显示空白头像,通常是当前预览尚未绑定小红书工具作者身份,需要在小红书平台配置作者账号后再测。普通浏览器不具备关注 API,则直接本地生成 PDF。
70
  - PDF 改为点击时本地生成:工具包只保留轻量数据、生成器和 3:4 封面,不再携带 10 MB 级 PDF 或字体文件。生成的 PDF 使用标准中文字体映射,完成后才写入临时文件并交给 `saveFile` / `openDocument`;不会主动联网。
71
  - 震动改为多级探测(见功能 9),接入再抽、收藏、分享图、PDF 导出 / 分享和挑战答题;不支持时静默降级。分享笔记标签扩展为健康急救、防骗指南、理财避坑、时间管理、开源阅读、安全意识、自我提升等相关主题,���保留 CC BY 4.0 出处和免责声明。
72
+ - 「反问」→「挑战」→ 现已改为游戏「红薯冒险」(见功能 10)。
73
  - PDF 不再作为静态资源上传;用户导出时本机生成完整 PDF。工具包保留 `cover-3x4.jpg` 作为导出面板预览,生成器另有简洁文字封面,因此不会因为 PDF 或字体文件导致上传包超过 10 MB。
74
 
75
  ## 文件清单与大小