**手机证据抓取系统的工程结构与应用入口**

技术文章 01   2026年11月6日   本地主目录代码基准

系统包含 Android 应用、Python 服务和浏览器管理页面。三个部分分别使用 Android 工程、Python 模块和静态 Web 文件组织。本文从目录、组件声明、服务入口和页面资源四个层面说明工程如何组成可运行的应用。

# ![](https://developer.qcloudimg.com/http-save/yehe-12821252/1fd063321a93e0d38c946c13e08162d8.png)  01  工程目录与交付对象

android-agent-v1 目录下，android 保存客户端工程，server 保存 Python 服务，web 保存管理页面，tests 保存测试文件，tools 保存构建和辅助程序，dist 保存安装包等产物。源码目录与产物目录分别承担开发输入和交付输出的职责。修改源文件不会自动改变已经生成的 APK，交付文件也不能单独表示当前源码状态。

Android 工程通过 settings.gradle 声明应用模块，通过 app/build.gradle 设置应用标识、SDK 和版本。服务入口位于 server/run.py，页面由 HTML、CSS、JavaScript 文件组成。阅读同一功能时，界面入口、数据字段与资源引用需要在各自目录中查找。

主目录的构建配置声明 versionName 为 0.12.2，versionCode 为 31。下列配置摘录只表示这份本地工程的构建信息；安装包版本由对应 APK 中的元数据确定。截图为项目保存的客户端页面记录，展示应用页面作为交付对象的外观。

namespace 'cn.zhisou.agent'  
compileSdk 35  
applicationId 'cn.zhisou.agent'  
minSdk 29  
targetSdk 35

代码位置  android/app/build.gradle · 配置项摘录

![](https://developer.qcloudimg.com/http-save/yehe-12821252/00e55e7935e7ca27694d1e56fc2a6928.jpg)

图 1A  工程目录与交付对象流程

![](https://developer.qcloudimg.com/http-save/yehe-12821252/3b3b0970208db9cb16b6ff2fac34568e.jpg)

图 1B  客户端任务记录区域  本地存档截图裁切

目录划分对应不同文件类型，页面中的记录文字属于界面数据。

技术文章 01   手机证据抓取系统的工程结构与应用入口

# ![](https://developer.qcloudimg.com/http-save/yehe-12821252/555d039e0222754a1be154df8ae1e6dd.png)  02  Android 组件声明与页面入口

AndroidManifest.xml 描述应用名称、图标、主题以及 Activity 等组件。系统通过清单识别可启动的组件，应用内部页面通过类名关联实现。主目录使用 cn.zhisou.agent 作为包标识，应用名称为“采集端”，图标资源引用 drawable 目录中的 robot\_arm。

清单中的应用属性与 Java 代码中的界面构造分别承担静态声明和运行时显示职责。MainActivity 的 exported 属性为 false，表示它没有作为可由其他应用直接启动的公开 Activity 声明。界面内部仍可显示首页、任务、设备和设置等页面。

资源标识以 @drawable 或 @style 等形式写入清单，构建时由 Android 工具解析。下列摘录保留应用标签、图标和一个页面声明。图中底部导航属于页面内部控件，与清单中声明一个 Activity 并不冲突。

<application  
    android:label="采集端"  
    android:icon="@drawable/robot\_arm">  
    <activity android:name=".MainActivity"  
        android:exported="false" />  
</application>

代码位置  android/app/src/main/AndroidManifest.xml · 属性摘录

![](https://developer.qcloudimg.com/http-save/yehe-12821252/1d8da229d828af0b8e70055be2a486fe.jpg)

图 2A  Android 组件声明与页面入口流程

![](https://developer.qcloudimg.com/http-save/yehe-12821252/bb36dc665c52d20eb7ceff8c7cc36975.jpg)

图 2B  客户端底部导航  本地存档截图裁切

四个导航标签由同一页面容器管理，清单声明不等于页面数量。

技术文章 01   手机证据抓取系统的工程结构与应用入口

# ![](https://developer.qcloudimg.com/http-save/yehe-12821252/e5073dc5d28c522eac7eb88f0eba315c.png)  03  Python 服务的启动参数

server/run.py 使用 argparse 读取 host、port 和 data 参数，再调用应用工厂创建 FastAPI 应用，最后交由 Uvicorn 运行。host 和 port 决定监听地址与端口；data 指定服务数据目录。参数解析发生在启动阶段，页面访问发生在服务开始监听之后。

默认监听地址为 127.0.0.1，默认端口为 8020。启动参数中的数据目录默认根据模块所在位置计算，避免将当前终端目录直接当作数据目录。调用方可以通过命令行显式传入另一个路径。这里的参数描述对应主目录入口文件。

应用对象与 HTTP 服务进程是两个不同层次。create\_app 返回应用，uvicorn.run 负责把应用接入请求处理循环。页面文件通过服务提供给浏览器后，浏览器再加载样式和脚本。截图中的登录表单是服务提供的一个页面入口。

p.add\_argument('--host', default='127.0.0.1')  
p.add\_argument('--port', type=int, default=8020)  
args = p.parse\_args()  
app = create\_app(args.data)  
uvicorn.run(app, host=args.host, port=args.port)

代码位置  server/run.py · 省略其他参数

![](https://developer.qcloudimg.com/http-save/yehe-12821252/2f1cd358f6fa7faf9a5ca72d281ef716.jpg)

图 3A  Python 服务的启动参数流程

![](https://developer.qcloudimg.com/http-save/yehe-12821252/7394196d902cc13c6faffdfe8afee6a0.jpg)

图 3B  管理页面登录表单  2026年10月29日存档截图裁切

页面可访问与表单操作结果分别由页面请求和后续请求产生。

技术文章 01   手机证据抓取系统的工程结构与应用入口

# ![](https://developer.qcloudimg.com/http-save/yehe-12821252/843e3b55acec58bed251387fd4fe71ef.png)  04  浏览器页面与静态资源

管理页面使用 HTML 定义控件和容器，CSS 定义排版，JavaScript 处理交互。以登录页面为例，login.html 引用 login.css 和 login.js。脚本标签使用 defer，使脚本在文档解析结束后执行，页面节点可以通过既定 ID 取得。

HTML 中的 label 与输入框 ID 建立关联，输入框声明最大长度和必填属性。CSS 负责输入框高度、边距和按钮宽度。脚本监听表单事件并更新页面提示。这三类文件分别保存结构、样式和交互代码，文件名与页面用途对应。

浏览器访问一个 HTML 文件后仍需请求其引用的资源。HTML 成功返回并不表示样式和脚本已全部加载。定位页面问题时，可以分别核对资源地址、响应类型和元素 ID。图中保留空白表单区域，用于对应输入框与按钮的结构。

<link rel="stylesheet" href="/assets/login.css">  
<script src="/assets/login.js" defer></script>  
<label for="username">管理员账号</label>  
<input id="username" maxlength="80" required>

代码位置  web/login.html · 标签摘录

![](https://developer.qcloudimg.com/http-save/yehe-12821252/35a53c0e4f0bc4581e3123a7235222f7.jpg)

图 4A  浏览器页面与静态资源流程

![](https://developer.qcloudimg.com/http-save/yehe-12821252/a126247bb1848952b3b7a5226c9c3d3a.jpg)

图 4B  登录输入控件  2026年10月29日存档截图裁切

静态资源的路径与控件 ID 是页面文件之间的连接点。

系统包含 Android 应用、Python 服务和浏览器管理页面。三个部分分别使用 Android 工程、Python 模块和静态 Web 文件组织。本文从目录、组件声明、服务入口和页面资源四个层面说明工程如何组成可运行的应用。

智叟云集-手机证据抓取系统的工程结构与应用入口

客户端

开发工具

测试

手机证据抓取系统由Android采集端、Python后端服务及浏览器管理页面组成，涵盖工程目录、组件声明、服务启动参数和静态资源管理，形成完整可运行的应用体系。

JavaScript

Android

容器

Python

Agent

Java

让每一个 Agent，都跑在云上

mmdp

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

智叟云集-手机证据抓取系统的工程结构与应用入口-腾讯云开发者社区-腾讯云

智叟云集-手机证据抓取系统的工程结构与应用入口

智叟云集-手机证据抓取系统的工程结构与应用入口

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐