TE 文档检索 APK

各品牌开启“未知来源”通用入口：

• 华为 / HarmonyOS：设置 → 安全 → 更多安全设置 → 安装未知应用（或 设置 → 系统和更新 → 纯净模式 关闭）。
• 小米 / Redmi（MIUI / HyperOS）：设置 → 隐私保护 → 特殊权限设置 → 安装未知应用。
• OPPO / realme（ColorOS）：设置 → 其他设置 → 设备与隐私 → 安装未知应用；或 设置 → 密码与安全 → 系统安全 → 安装未知应用。
• vivo（OriginOS）：设置 → 应用与权限 → 权限管理 → 安装未知应用。
• 三星（One UI）：设置 → 生物识别和安全性 → 安装未知应用。

安装后：桌面生成“TE文档检索APK”图标；首次打开即可直接检索，无需注册或登录。

1. 使用流程

• 在首页输入框输入 文档编号（例如 114-18025）或 产品编号（例如 7-1452668-3），点“检索”——两者共用同一输入框；输入单行 = 单个检索，输入多行 = 批量检索，App 自动识别（无需切换模式）。
• 产品编号（主通道）：App 先读取官网产品详情页，直接给出产品图纸 / 产品规格 / CAD 文件(STP)、产品图（缩略图 + 高清原图）与产品状态徽章（有效／试产…）——与浏览器插件同一套逻辑。
• 产品页未列出图纸时（如部分试产件），自动掐头去尾取核心号（7-2359439-3 → 2359439）二次检索文档编号；命中即出结果，绝不空手而归。
• 支持批量：每行一个编号（文档号或产品号均可），点“检索”即按批量处理，结果可一键「下载全部文档」。
• 结果卡中每份文档显示原文档名称（如 ENG_CD_929454_C29.pdf），并标注类别／语言／格式标签，一眼看清文件是什么。
• 图框 SPEC 识别（V0.5.0 新增）：检索到产品图纸时，App 会自动读取图纸右下角图框里的 PRODUCT SPEC / APPLICATION SPEC 档案编号（如 108-18030），据此只保留命中的产品规格文档（并在文档行挂上「规格编号 + SPEC 类型」徽章），未命中的规格自动过滤；若产品页一条规格都没有，则改用识别到的编号去官网补全规格文档。识别结果会在结果卡上以一行说明如实展示。
• 下载文件落入手机 Download/<默认保存路径>/<编号>/（默认保存路径 TE Web Download，可在设置页修改），由系统下载器管理（通知栏看进度、点通知直接打开）。

2. 检索规则

• 文档编号形如 108-xxxxx / 114-xxxxx / 501- / 411-：直接走官方文档接口（api.te.com.cn），不经二次检索。
• 产品编号（含两段及以上，如 7-1452668-3）：走官网产品页通道；产品页打不开（404 / 网络失败）时无条件按核心号走文档编号通道二次检索，产品页正常但没有图纸时（且仍勾选「产品图纸」）同样二次检索——与浏览器插件触发条件完全一致。
• 无连字符的纯数字编号（如 928999）：同样先走产品页；产品页返回 404 后立即进入二次检索，无需掐头去尾（本身即文档编号），直接以原编号在文档编号通道检索。V0.9.2 起支持——此前这类编号在产品页失败后会被直接判为「未找到」，而插件一直可以搜到（实测 928999 命中 ENG_CD_928999_A1.pdf）。
• 掐头去尾规则（与插件一致）：2-2378904-1 → 2378904（掐头去尾取中间）、1897009-2 → 1897009（去掉尾巴）、2378904 → 2378904（开头无 "-"，不换算）。
• 二次检索命中多个文档时只保留 PDF：TE 对同一图纸常同时给出 .tif 与 .pdf（如 ENG_CD_928999_A1 两种格式各一份），而 .tif 无法用系统渲染器预览，因此只保留 PDF；只命中一份时则原样保留。
• 两次通道均访客态免登录、毫秒~百毫秒级返回；材料声明类文档官网要求登录，访客态返回空属正常。

3. 数据策略（隐私优先）

• 仅向 TE 官方域名请求数据；不索取账号、不采集设备标识、不上报任何使用数据。
• 检索历史仅保存在本机 WebView 的 localStorage，不上传。

4. 兼容范围

• 支持 Android 8.0 – 16，并兼容 HarmonyOS 2.0 – 4.x（AOSP 底座）。
• 不支持 HarmonyOS NEXT（5.0+，已移除 AOSP，无法安装 APK）。

5. 预览、全屏、放大与存相册（V0.8.0 / V0.9.0 / V0.9.1 升级）

• 产品图：结果卡标题行最右侧显示小缩略图，点开进入灯箱可左右滑动或点箭头浏览全部张，并自动换成高清原图。该编号官网无产品图时，同一位置显示「未发现 产品图」浅灰占位框（与插件一致）。
• PDF 图纸／规格：点「预览」用系统原生渲染引擎（Android PdfRenderer）输出高清图，秒开、不依赖插件、不受 WebView 版本影响；多页 PDF 左右滑动或点箭头翻页（状态条显示「第 N / M 页」，固定在标题下方不遮挡图面）。
• 两条去向，别混淆：蓝色按钮 「保存相册/本页」「保存相册/全部(N)」「保存相册/此图」 写入手机相册（Pictures/TE DocAgent，图库立即可见）；灰色带 ↓ 的按钮 「↓ 下载文档」「↓ 下载此图」「↓ 下载全部(N)」 写入下载目录（Download/<保存路径>/<编号>/）。文档行的「存相册」按钮保存该文档第 1 页。
• 相册入库质量：PDF 的「保存相册/全部(N)」一次把整本逐页渲染成高清 PNG（最长边最高 3400px）后整本写入相册；产品图的「保存相册/全部(N)」逐张入库。全部经 MediaStore.Images 由系统托管（Android 10+ 零额外权限）。
• 放大缩小（V0.8.0 新增）：右下角 ＋ / − / 适应 按钮、双指捏合、双击（1× ↔ 2×）三种方式，放大后单指拖动查看细节。PDF 会按倍率静默补渲更高清的一档（2600 → 3000 → 3600 → 4200 像素），因此放大后线条与尺寸标注依旧清晰；同一页同一档只渲一次（翻页、缩放来回切换都不重复渲染），大图内存不足时自动降级、不会崩。
• 翻页方式（V0.8.0 调整）：以左右滑动翻页为主；箭头缩小为半透明悬浮条（不再占用画面宽度），静止 1.8 秒后箭头与右下角工具组自动淡出、触碰即显形。放大状态下单指滑动＝平移图片（不翻页），此时请用箭头翻页，避免误操作。
• 全屏查看（V0.9.0 新增）：右下角 「全屏」 按钮点一次进入沉浸式全屏——隐藏系统状态栏与导航栏，PDF / 产品图画面铺满整屏（挖孔/刘海屏按 shortEdges 铺入安全区），此时按钮变为高亮的「退出全屏」，再点一次即可退出。全屏时其左侧新增「横竖屏」按钮，可在竖屏 ⇄ 横屏之间切换，方便横向铺开看宽幅图纸；退出全屏后默认恢复竖屏（列表页始终竖屏可用），且「横竖屏」按钮隐藏并置灰不可用。「全屏」按钮与箭头、缩放工具共用同一套静止 1.8 秒自动淡出、触碰显形的特性；全屏时按手机返回键会优先退出全屏（而不是关闭 App）。
• 沉浸浮层与全淡出（V0.9.1 新增）：顶部标题栏、状态条与底部操作栏全部改为悬浮在画面之上（不再占用布局高度），因此 PDF / 产品图是真正铺满整屏、上下不再被两栏挤掉一截；灯箱底色改为不透明，原先透出背后检索结果的半透明重影彻底消失。全屏查看时所有按钮与标题静止 1.8 秒一并淡出（含标题、关闭、状态条、保存/下载按钮、箭头、工具组），只留纯图面；轻触屏幕任意处立即显形——因淡出时按钮已不接收点击，首次轻触只负责唤出、不会误触下方的下载/相册按钮。渲染中 / 保存中不会淡出，进度与错误提示始终可见。提示：A4 图纸比例（1:1.414）与手机屏幕比例（约 1:2.17）不同，按宽度铺满后上下会有纯黑留白；想更满可点 ＋ 或双指放大。

6. 图框 SPEC 识别（V0.5.0 新增，与浏览器插件同口径）

• 它解决什么问题：TE 的图纸右下角图框里写着本料号引用的产品规格档案编号。之前的 APK 只能把产品页列出的规格全部铺开，无法判断哪几份才是这张图纸真正引用的。
• 怎么做的：App 抓取图纸 PDF，解析其内容流（Tm / Td / TJ 等文本操作符 + 坐标），在图框区域内定位整格等于 PRODUCT SPEC(IFICATION) / APPLICATION SPEC 的标签，再取其正下方同列最近一格，提取其中的 108-/114-/501-/411- 档案编号。
• 结果怎么用：只保留编号命中的产品规格（并挂「规格编号 + SPEC 类型」徽章），未命中者过滤；一条规格都没有时（受限件 / 试产件等）改为按识别到的编号去官网补全规格文档。图纸 / 3D / 其它类型原样保留，不受影响。
• 取哪张图纸：同一料号有多张图纸时，按「设置 → 产品图纸语言优先」的顺序（默认 英文 → 中文 → 德语 → 日语 → 最后一张）依次尝试，取第一个能读出编号的（与插件一致；语言优先级可在设置中调整）。
• 已知限制（插件同样存在，非 bug）：① 图纸是矢量轮廓（无文字层）时读不出编号，App 会如实提示「未识别到规格编号」；② 依赖浏览器版本的 FlateDecode 解压已放到系统原生层完成，因此不受 WebView 版本影响。
• 该功能不落盘图纸原文，只在内存中解析，用完即弃。

7. 结果卡布局与下载归档（V0.7.0 对齐插件）

• 标题行布局与插件完全一致：「编号 ｜ 状态徽章 ｜ 全部下载（N 份）｜ …… ｜ 缩略图」——「全部下载」按钮在编号/徽章右侧，产品图缩略图或「未发现 产品图」占位框贴齐最右；编号行按图框识别结果着色（淡黄=默认、淡绿=识别到编号且命中、淡红=已读图纸未识别到编号）。
• 按钮文案分行：「下载全部文档」「下载全部产品图」的计数另起一行（如「下载全部文档」/「（10 份 / 2 组）」），窄屏也不会溢出。
• 清空＝双击确认：点「清空」先变为「再次点击确认清空」，3 秒内再点一次才真正清空；超时自动还原（与插件同一套防误触逻辑）。
• 按编号新建文件夹：所有文档与产品图统一落 Download/<保存路径>/<编号>/——产品页取自产品编号，二次检索与图框补全的文档也归入原始产品编号文件夹；同名文件自动加 (1)(2) 后缀，不会互相覆盖。

8. 设置与更新（复刻浏览器插件）

• 点标题栏右侧「设置」打开设置面板，分为保存与下载 / 下载选项 / 文档筛选 / 应用更新 / 关于。
• 默认保存路径：显示当前路径（Download/<子目录>），点「修改」可改为任意 Download 目录下的子目录（支持多级，如 TE Web Download/2026-10）；下载的文档与产品图会落到该路径下的 <编号>/ 子文件夹。
• 打开下载目录：一键跳转到手机的下载文件夹（优先直接定位到本应用子目录，机型不支持时回退到系统「下载」界面）。
• 下载选项：显示产品图预览（是/否，关掉后标题行不再显示缩略图与占位框）、下载产品图数量（全部/首张）、解压CAD文件STP（是/否——「是」时下载 STP 压缩包会自动解压，把内部 3D 文件逐个放进编号文件夹，与插件一致）。
• 文档筛选：文档类型筛选（产品图纸 / 产品规格 / CAD文件(STP)，选项来自当前结果）、产品图纸语言优先与产品规格语言优先（优先英文 / 优先德语 / 优先日语 / 全部——同一编号有多语言版本时保留首选语言；无该语言时保留全部）、图框识别规格编号筛选（开启=按图框编号过滤产品规格，与插件默认一致；关闭=保留全部规格）。
• 应用更新：点「检查更新」自动访问本页（apk.html）解析最新版 APK 地址——有新版本即下载并拉起系统安装器（需在系统弹窗确认，首次可能需在设置中允许本应用「安装未知应用」）；已是最新版本会明确提示，不会重复下载。
• 以上设置全部保存在本机（键名与浏览器插件一致），下次启动自动生效。

安装与检索在所有版本都正常（minSdk 26）；下载在 V0.1.0 修复前于全版本失败，病因分两段，修复后全版本恢复：

为什么 OEM 定制系统（MIUI / HyperOS、ColorOS / OriginOS、One UI）也受影响？ 分区存储是 AOSP 框架层强制规则，与是否带有 Google 服务无关；国产 ROM 只是在外面套壳，存储模型完全一致，因此同样落入“下载失败”区间，修复后同样恢复。

修复方案（已采用，方案 A）： Android 10+ 用 MediaStore.Downloads 先建条目、再交给系统下载器写入——零额外权限；Android 8/9 在首次下载时弹窗申请一次存储权限；Android 13+ 额外申请通知权限以显示下载进度。该路线是 Google 官方长期方向，Android 17+ 也不会失效。

① 权限清单审计

• INTERNET：联网检索所必需。
• WRITE_EXTERNAL_STORAGE：仅 Android 9 及以下声明（maxSdkVersion=28），Android 10+ 不再申请。
• POST_NOTIFICATIONS：仅 Android 13+ 用于下载进度通知。
• REQUEST_INSTALL_PACKAGES（V0.6.0 新增）：仅用于 App 内「检查更新」——把从本站下载的最新版 APK 交给系统安装器；安装确认弹窗与「允许安装未知应用」开关始终由系统掌控，App 无法绕过。不用于任何其它目的。
• 无任何通讯录 / 定位 / 相册 / 通话 / 短信等敏感权限。

② 网络审计

• 仅请求 api.te.com.cn（文档接口）与 www.te.com.cn（产品详情页 / 产品图 DAM）官方域名；访客态、无账号、无 Cookie 追踪。
• 网络请求经原生 HttpURLConnection 发出（页面 fetch 受 te.com.cn 无 CORS 头限制，必须由原生出网）。

③ 存储审计

• “下载”仅写入 Download/<默认保存路径>/<编号>/（默认保存路径可在设置页修改，仅限 Download 目录下的子路径），不访问其它目录。
• “存相册”写入 Pictures/TE DocAgent/，经 MediaStore.Images 由系统托管（Android 10+ 零额外权限），并广播媒体扫描让图库立即可见。产品图与 PDF 首页图走同一入口。
• PDF 预览的中间产物只落在 App 私有缓存目录（cacheDir）的临时文件，用完即删，不驻留用户可见空间。
• Android 10+ 经 MediaStore 由系统托管，零额外权限；App 不持有文件流，无内存溢出风险。

④ 渲染审计

• PDF 预览与「PDF 存相册」由 Android 系统 android.graphics.pdf.PdfRenderer 完成（系统组件，非第三方库），不执行文档内脚本、不联网、不落盘原文；已内置最长边像素上限（预览 2600px / 存相册 3400px）防止超大图纸 OOM。
• V0.4.0 已移除内置 pdf.js（约 1.4 MB），APK 体积降至 0.9 MB 级，同时消除 file:// 下 Web Worker 与 WebView 版本差异带来的不确定性。

⑤ 更新通道审计（V0.6.0）

• 「检查更新」按内置候选列表依次尝试 te.app.workbuddy.host/apk.html 与 te-drawing-agent.app.workbuddy.host/apk.html（首个可用站点胜出），解析最新版 APK 直链，不请求任何其他第三方地址。
• 下载到的安装包先做 PK 头校验（拒绝错误页/被拦截页当作安装包），存放于 App 私有缓存 cacheDir/update/；每次更新前清空旧包，安装后由系统托管。
• 安装包经零依赖自实现的只读 Provider（exported=false + 一次性 URI 授权）交给系统安装器，并做文件名目录穿越防护；不引入任何第三方库。

⑥ 图框识别审计（V0.5.0）

• 识别只在获取到的图纸 PDF 字节上做纯结构解析（扫 stream…endstream → 解压 → 读文本操作符），不执行 PDF 内任何脚本、不渲染、不联网。
• 解压由系统组件 java.util.zip.Inflater 完成（原生层），无第三方解析库、无体积膨胀；对单份 PDF（≤16 MB）、流数量（≤80）、单流长度均设上限，异常文件直接跳过而非卡死。
• 图纸原文不落盘：只存在于内存与必要的临时缓冲中，解析完成即释放。

⑦ 下载与归档审计

• 使用系统 DownloadManager，文件落盘由系统负责，断点 / 重试 / 进度通知均为系统能力。
• 目标路径为 Download/<保存路径>/<编号>/，中间目录由系统 DownloadProvider 递归创建；文件名重名自动加 (1)(2) 后缀，绝不覆盖已有文件。
• 「解压CAD文件STP」（V0.7.0）由系统组件 java.util.zip.ZipInputStream 解压（原生层，无第三方库）：先做 PK 头校验拒绝非 zip 内容，并做条目名目录穿越过滤（只取文件名、丢弃路径），单个条目为空或异常时跳过；解压产物与普通下载写入同一编号文件夹。
• ⑨ 预览渲染审计（V0.8.0）：放大后按需补渲的图片最长边硬顶 4200px（约 51 MB ARGB 缓冲，低端机安全上限），并对 OutOfMemoryError 做捕获——失败时自动降回上一档清晰度而非崩溃；同一页同一档位只渲染一次并缓存（翻页或缩放回切不再重复下载/渲染）；放大状态下的单指滑动只做平移，绝不会误触翻页。
• ⑩ 屏幕方向审计（V0.8.0）：横竖屏切换经原生 Activity.requestedOrientation 实现，不注入任何脚本；清单已解除竖屏锁定并声明 configChanges（orientation / screenSize / smallestScreenSize / keyboardHidden / screenLayout / uiMode），旋转时 Activity 不重建，WebView 内容与预览状态保持不变；关闭预览自动回落竖屏。
• ⑪ 全屏查看审计（V0.9.0）：进入/退出全屏只调用原生 WindowInsetsController.hide/show（Android 11+）或 View.systemUiVisibility（Android 8–10）隐藏与恢复系统栏——不改动窗口尺寸、不注入脚本、不申请任何新权限；沉浸采用 IMMERSIVE_STICKY，用户划出系统栏后自动再隐藏，回到前台在 onWindowFocusChanged 补一次 apply。退出全屏、关闭灯箱、按返回键三条路径都会恢复系统栏并回落竖屏，不存在“退出后系统栏不回来”的残留状态。
• ⑫ 灯箱沉浸浮层审计（V0.9.1）：顶栏 / 状态条 / 底部堆栈改为 position:absolute 浮层、画面 inset:0 独占整屏，属纯 CSS 布局调整——不涉及权限、网络或脚本注入；浮层容器设 pointer-events:none、仅内部控件开启，保证空白处点击穿透到画面；自动淡出只切换灯箱根节点的一个类名（.lb-idle），以 opacity + pointer-events 实现「不可见即不可点」，杜绝淡出后误触保存 / 下载按钮；底色由半透明 rgba(.97) 改为不透明，不再透出下层检索结果。渲染中 / 保存中依据状态条 .is-loading 暂缓淡出，并设 4 轮兜底上限（约 8 秒），避免异常长任务把界面永久钉在可见态。
• ⑬ 检索通道审计（V0.9.2）：本版只调整前端两条既有通道的编排顺序与取舍规则，不新增任何域名、接口、权限或第三方库——产品详情页（www.te.com.cn）与文档元数据接口（api.te.com.cn）均为既有通道。二次检索的触发条件相较旧版是收紧而非放宽：产品页请求失败（非 2xx）才无条件补查，产品页正常时仅在仍勾选「产品图纸」且该页没有图纸时补查；「命中多份只保留 PDF」是对返回结果的本地过滤（不发起新请求）；原生 netGet / netGetBase64 改为非 2xx 不回传 body，只减少数据搬运、不改变任何成功路径的行为，因此隐私面没有扩大。

⑧ 隐私审计

• 不采集设备标识、不读取用户文件、不上报任何使用数据；检索历史与全部设置项仅存本机。