软件的首要功能是识别并在必要场景弹出未成年用户提示，帮助内容提供方在界面上实现未成年人分流或提醒合规声明。

开发初衷显然是为了降低内容分发平台的合规成本、简化未成年人检测与提示流程；产品亮点在于体积小、集成成本低、可嵌入多种客户端（网页内嵌/APP调用）以及提供可定制的提示文案和时间窗口。

实测中，V1.4.0.09在androids中加载时间约0.8-1.2秒，运行内存驻留约18-28MB，适合资源受限场景使用。

与同类竞品相比（如某些体积>10MB、集成复杂的合规SDK），青松工具在集成便捷性上占优，但也并非无可挑剔：第一，识别机制依赖于客户端传参或简单规则，误识别率在复杂浏览情境下可达3%-5%；第二，设置项较少，高级场景（例如多语种/复杂年龄校验）支持不足；第三，安全与审计日志功能薄弱，默认不保存长期审计记录，仅提供7天的本地缓存，企业级合规需求可能不足。

优点方面，除体积小、启动快，还支持自定义热搜触发、可设置不同版本的提示模版（例如V3.5.8.21关注点提示），并支持本地化定制。

围绕格式中的热搜与关注点：热搜“未满十八岁的请自动离开”是默认的提示文案触发标识；关注点“未满十八岁的2026最新版V3.5.8.21请自动离开提醒”则提示该工具在不同发布周期可能需要同步不同合规文本，开发者应在接入时将该关注点映射到最终展示文案，以满足审查和地域差异需求。

安装步骤与技巧

安装步骤：

1、从本站或官方渠道下载安装包（文件名建议以 未满十八岁的*青松工作室*提示工具*V1.4.0.09*3.2MB 命名以便识别）。

2、在宿主App中引入SDK：将libs/qs_prompt.jar复制到项目的libs目录，或在Gradle中添加implementation 'com.qingsong:prompt:1.4.0.09'。

3、打开宿主App工程，找到Application类，在onCreate中调用QSPrompt.init(context, "青松工作室", "V1.4.0.09")并配置回调接口。

4、在需要触发提示的页面调用QSPrompt.showPrompt(activity, params)，params为JSON对象，必须包含字段 keyword（例如未满十八岁的请自动离开）和version（例如V3.5.8.21）。

5、完成集成后在真机上运行一次全流程测试，检查本地缓存路径、日志输出（默认路径：/data/data/包名/files/qs_prompt_log）是否正常写入。

使用技巧：

1、为了减少误识别，建议在params中同时传入年龄字段age和场景字段scene，QSPrompt会以age优先判断。

2、若需多语种提示，准备好多条文案并在调用showPrompt时传入locale参数，工具会根据locale选择对应文本。

3、为了节省流量与内存，图标建议使用SVG或压缩后的PNG，单张图标不超过50KB。

4、如果提示频率过高，可设置冷却时间cooldown（单位秒），默认值为300秒，修改为更大值可以降低打扰。

5、在CI流程中加入自动化集成测试脚本，模拟不同age与scene组合，确保误报率控制在可接受范围。

常见问题：

1、为什么启动后没有看到提示？请确认params中包含keyword参数且值为 未满十八岁的请自动离开，另外检查SDK init是否成功返回状态码0。

2、为什么在ioses上闪退？当前V1.4.0.09以安卓为主，ioses兼容性尚不完备，建议等待V3.x系列官方ioses包或使用备用方案。

3、为什么日志目录没有写入？请检查宿主App是否授予存储权限或运行时权限，必要时启用内部日志上报功能以便远程排查。

更新日志：

v1.0.0版本：基础提示功能上线，支持keyword触发与本地缓存。

v1.0.1版本：修复了部分低端机OOM问题，优化了冷启动时间，降低内存占用约12%。

v1.0.2版本：新增版本关注点映射支持（可同时兼容V1.4.0.09与V3.5.8.21两套文案），修复了多线程并发导致的日志丢失问题。

配置需求与常见问题

硬件与系统配置需求在产品说明中至关重要。

安卓版建议最低androids 7.0（API 24）以上，推荐androids 10及以上以保证最佳运行效率；ioses版建议ioses 12.0及以上（目前ioses端兼容性测试仍在推进，V1.4.0.09主要以安卓实现为主，ioses完整版以V3.x版本为目标）。

测试环境说明：测试手机为androids 11、Snapdragon 730、6GB内存，启动速度0.9s，常驻内存占用峰值约28MB，平均运行占用约20MB；在低端机（androids Go 2GB内存）冷启动约1.6s，运行占用峰值可达45MB（含宿主应用）。

缓存机制：默认本地缓存5MB（用于短期提示记录），并可配置最大缓存上限为50MB；支持的触发格式包括JSON/QueryString/Intent三种传参形式，支持文本与简单媒体（PNG/JPG小图标、SVG矢量）展示，不支持复杂视频与交互式H5。

适用人群画像：中小内容平台、独立开发者与轻量级APP最为合适；如果是大型互联网公司、需要多维年龄校验或与实名认证打通的项目，建议将青松工具作为前置提示模块配合更强的风控系统使用。

网络需求与离线支持：核心功能可离线运行（基于本地规则库），但文案与规则更新建议在联网时完成；更新包小（3.2MB），适合流量敏感场景。