各硬件终端后端接口需求与系统服务梳理
| 主要模块 | 子功能 | 接口与服务逻辑描述 | 系统支持需求 |
|---|---|---|---|
| 网络与基础服务 | 自建WiFi热点服务 | 允许录音卡和手机发现并连接盒子；提供局域网内的固定访问入口。 | WiFi热点模式自动IP分配 |
| 用户认证与权限 | 设备注册接口、安全登录凭证发放、多角色权限管理（管理员/普通社工）、操作日志记录。 | 本地数据库身份验证模块 | |
| 远程安全访问 | 提供VPN虚拟专用网接入服务或专线连接管理，支持社工在外网环境下安全访问本地数据。 | VPN服务加密隧道 | |
| 业务协作服务 | 社工IM通讯 | 提供即时消息传输服务，支持文字、图片、语音消息；支持消息漫游与自动归档；支持局域网/互联网双模切换。 | 消息推送消息数据库 |
| 在线文档编辑 | 支持多人同时编辑Word/Excel文档；提供文档版本管理、批注、预览与格式转换服务。 | 协同编辑引擎文档版本库 | |
| Web配置后台 | 提供浏览器访问的配置页面，支持网络设置、存储管理、用户管理、系统状态监控。 | Web服务器 | |
| 二次开发接口 | 开放标准化API接口，支持第三方系统调用会议、台账、知识库能力；支持自定义模版插件。 | API网关 | |
| 数据中心服务 | 居民台账管理 | 提供台账数据的增删改查接口；支持批量导入/导出；支持字段级权限控制与脱敏输出。 | 加密数据库 |
| 接诉即办本地案例管理 | 对12345工单数据进行本地存储与全流程管理；支持录音、照片与工单的自动关联；支持案例分类与标签化。 | 本地数据库关联引擎 | |
| 数据归集与同步 | 接收来自录音卡的录音、图片上传；支持有线底座高速传输；支持断点续传与文件去重校验。 | 文件系统高速传输 | |
| 全局搜索服务 | 对台账、录音文本、文档进行全文索引；提供跨模块的统一搜索接口。 | 全文检索引擎 | |
| AI 能力服务 | 语音转写 (ASR) | 接收音频文件或流，调用本地模型进行转写；支持方言识别参数配置；返回带时间戳的文本。 | 语音识别引擎AI算力 |
| 声纹识别与分离 | 提取音频声纹特征；与声纹库比对识别发言人身份；支持新声纹注册与标记。 | 声纹模型特征库 | |
| 文书生成 (LLM) | 基于会议纪要或工单记录，调用本地大模型生成公文、总结、办件分析或活动策划方案。 | 大语言模型提示词工程 |
| 主要模块 | 子功能 | 接口与服务逻辑描述 | 系统支持需求 |
|---|---|---|---|
| 文档处理 | 自动入库与解析 | 监控指定文件夹或接收上传；自动识别文件格式；调用文字识别引擎提取内容；自动去除页眉页脚等噪声。 | 文字识别引擎文件存储 |
| 文档切片与向量化入库 | 使用自研切片引擎，根据文件格式（Word/PDF/Excel等）自动进行语义切片，生成文本块；对切片后的文本块调用向量化模型生成向量数据；将向量数据存入向量数据库，构建语义索引。 | 向量化模型向量数据库 | |
| 检索与问答 | 知识检索服务 | 接收自然语言查询；将查询转为向量；在知识库中检索最相关的切片；支持关键词与语义混合检索。 | 向量检索 |
| 智能问答接口 | 构建包含检索上下文的提示词；调用大模型生成最终答案；支持流式输出，逐字显示。 | 大模型推理流式传输 | |
| 系统管理 | 知识库维护 | 支持知识库的创建、删除、清空；支持索引重建；支持问答历史记录与用户反馈收集。 | 任务队列 |
| 主要模块 | 子功能 | 接口与服务逻辑描述 | 系统支持需求 |
|---|---|---|---|
| 硬件控制 | 双模录音控制 | 检测物理开关状态；控制压电传感器（通话内录）与麦克风（现场录音）切换；音频自动增益控制。 | 固件控制 |
| 按键打点逻辑 | 检测按键触发；在音频文件中写入标记点或生成独立的打点日志文件，记录关键时刻时间戳。 | 日志记录 | |
| 连接与传输 | 身份与状态同步 | 连接手机或底座时，进行蓝牙握手确认身份；自动同步系统时间；上报电量与存储状态。 | 时间同步蓝牙协议 |
| 文件传输协议 | 支持USB大容量存储模式（有线直读）；支持蓝牙文件传输协议用于无线导出小文件。 | USB协议蓝牙传输 | |
| 底座识别 | 检测到底座连接信号；自动触发充电模式并切换至高速数据传输模式。 | 硬件中断 | |
| 巡查支持 | 巡查照片存储 | 蓝牙连接手机，作为巡查拍照的外置存储器，照片和语音备注直接存储在录音卡，不占用社工手机内存（可选配置）；支持多端浏览和管理、检索照片。 | 蓝牙传输外置存储 |
| App远程控制 | 通过手机App控制录音卡的录音开关、打点标记；实时查看录音卡电量和存储状态；配置同步策略。 | 蓝牙控制App交互 |