尧图网页设计 
LunaTranslator 内置网络服务完全指南HTTP API 与 WebSocket 的页面路由、接口协议与源码实现【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 除了桌面 GUI 外还内置了一套轻量级网络服务它以本机 TCP 服务的形式提供 Web 控制页面主界面同步、翻译历史、词典查询、翻译/OCR/TTS 演示页和一套可直接调用的 HTTP/WebSocket API方便外部程序、浏览器脚本乃至 Agent 把这款视觉小说翻译器当作一个可编程的翻译/OCR/词典后端来使用。读完本文你将掌握全部页面路由与 API 端点的请求格式、返回结构、配置方法以及这些能力在 tcpservice.py 与 servicecollection.py 中的底层实现原理。一、服务概览一个自带 Web 界面的本地 TCP 服务该网络服务并不是独立进程而是随 LunaTranslator 主程序运行的内嵌 TCP 服务。从源码结构看它由三层组成传输层tcpservice.py 中的TCPService负责监听端口、解析 HTTP 请求头与 body、按路径分发到具体 Handler同时内置了一个极简 WebSocket 服务端WSHandler。路由层servicecollection.py 中的registerall(service)一次性注册了全部 20 个路由8 个 Web 页面、8 个 HTTP API、4 个 WebSocket见registerall函数末尾的注册清单。应用层各 Handler 直接复用gobject.base中的翻译、词典、OCR、TTS、MeCab 解析等核心能力。服务在 LunaTranslator.py 的serviceinit()中启动self.service.stop() if globalconfig.get(networktcpenable, False): try: self.service.init(globalconfig.get(networktcpport, 2333)) except OSError: gobject.base.portconflict.emit(端口冲突)两个关键结论服务默认关闭networktcpenable默认False默认端口为 2333如果端口被占用界面会弹出端口冲突提示。TCP 层绑定的是0.0.0.0见 tcpservice.py即监听本机全部网卡地址。1.1 请求分发与响应模型TCPService.handle_client对每个连接做以下处理解析请求行与头部得到RequestInfo含path与解析后的query字典若路径命中globalconfig[network_service_disabled_paths]默认空列表见 config.json直接返回 404根据请求头是否包含Upgrade: websocket区分 WebSocket 握手与普通 HTTP 请求再遍历已注册 Handler 匹配path未命中任何路由则返回 404。响应统一由ResponseInfo构造它对不同 body 类型自动设置响应头tcpservice.pybody 类型Content-Type说明strtext/html; charsetutf-8页面文本dict/list/tupleapplication/json; charsetutf-8JSON 响应bytes需自行带ResponseWithHeader指定二进制数据如音频FileResponse由 MIME 助手按扩展名推断静态页面文件RedirectResponseLocation头 302重定向GeneratorTypetext/event-stream; charsetutf-8SSE 流式输出另外所有响应都带Access-Control-Allow-Origin: *因此浏览器跨域调用 API 时无需额外配置。二、Web 页面路由把翻译器的界面搬到浏览器以下 8 个页面路由在文档 docs/ja/apiservice.md 中有详细说明它们对应的实际页面文件位于 htmlcode/service 目录。2.1/—— 导航页返回 index.html内含指向其余页面的链接相当于服务主页导航页。2.2/page/mainui—— 主界面文本同步与主窗口TextBrowser显示的文本内容实时同步。实现上它返回的是渲染文本所用的同一套页面TextBrowser.loadex_()见 servicecollection.py数据推送则依赖内部 WebSocket见第五节。在浏览器里打开该页面看到的即是游戏内抽取文本的镜像视图支持点击单词查词典。2.3/page/transhist—— 翻译历史同步与翻译历史窗口wvtranshist显示的文本内容实时同步返回wvtranshist.loadex_()生成的页面servicecollection.py。2.4/page/dictionary—— 单词搜索页单词搜索页面。在/page/mainui中点击单词发起搜索时本页面负责展示结果。它的特殊之处在于支持word查询参数不带参数返回静态页面 dictionary.html带word参数由PageSearchWord处理会先对单词做原型还原WordSegResult.from_dict→word.prototype若原型与原文不同则 302 重定向到原型词的查询 URLservicecollection.py确保词典以词原型命中。2.5/page/manyinone—— 三合一集成页将上述主界面、翻译历史、词典三个页面集成到一个窗口的页面对应 manyinone.html。其实现非常巧妙用三个object内嵌/page/transhist、/page/dictionary、/page/mainui?__internal1并用 JavaScript 覆写 mainui iframe 的window.openobject data/page/mainui?__internal1 ... idmainui/object script const iframe document.getElementById(mainui) iframe.contentWindow.open(url){ document.getElementById(searchword).dataurl } /script效果正如文档所述在主界面子区块点击单词搜索时不会打开新窗口而是在当前页面的词典子区块内展示搜索结果。2.6/page/translate、/page/ocr、/page/tts分别是翻译接口、OCR 接口、TTS 接口的 Web 演示页返回 translate.html、ocr.html、tts.html。它们通常在前端用 JavaScript 调用下面第三、四节对应的 HTTP API。三、HTTP API把翻译器变成可编程后端3.1GET /api/translate—— 文本翻译必填查询参数text待翻译文本。可选参数id翻译器 ID。指定id时使用该翻译器进行翻译未指定id时走默认翻译流程从可用翻译器中选择结果返回。返回application/json包含翻译器 IDid、名称name、翻译结果result。源码实现servicecollection.pyAPITranslate.parse通过gobject.base.textgetmethod(text, False, waitforresultcallback..., waitforresultcallbackenginetsid, waitforresultcallbackengine_forceTrue)触发完整翻译管线含预处理、翻译、后处理并以threading.Event同步等待结果。错误时返回{error: ..., id: ..., name: ...}成功时返回{ id: 翻译器ID, name: 翻译器名称, result: 翻译结果文本 }id与name的映射分别由dynamicapiname()与国际化表_TR解析。未指定id时翻译器的选择顺序由配置项fix_translate_rank_rank默认空列表见 config.json决定。3.2GET /api/dictionary—— 词典查询必填查询参数word要查询的单词。可选参数id词典 ID。分两种行为指定id只查询该词典返回单个 JSON 对象含词典 IDid、词典名称name、HTML 内容result查询失败时返回空对象{}。源码对应 servicecollection.py 的APISearchWord.parse分支。未指定id并行查询全部已启用词典gobject.base.cishus返回SSEtext/event-stream流每个事件是一个 JSON 对象词典 IDid、名称name、HTML 内容result。这就是文档中返回event/text-stream的含义。实现细节iterhelper是一个生成器servicecollection.py对每个词典调用cishu.safesearch(...)异步搜索用threading.Semaphore收集结果并逐个yieldResponseInfo识别生成器类型后设置text/event-stream并在 tcpservice.py 中以data: {json}\n\n的 SSE 帧格式逐条发送。3.3GET /api/mecab—— MeCab 分词解析必填查询参数text。返回text的 MeCab 解析结果servicecollection.py内部调用gobject.base.parsehira(text)把每个词的解析结果原型、读音、词性等字段以 JSON 数组形式返回等价于界面上的日语假名/分词标注功能。3.4GET /api/tts—— 语音合成必填查询参数text。返回音频二进制数据非 JSON。源码servicecollection.py调用gobject.base.reader.ttscallback(text, callback)走当前 TTS 引擎通过ResponseWithHeader携带音频的content-type如audio/mpeg、audio/wav等 MIME来自TTSResult.mime与content-length返回若合成出错则返回{error: ...}。3.5POST /api/ocr—— 图片文字识别与其它端点不同本接口要求POST 方法请求体为 JSON{image: base64 编码的图片数据}。源码servicecollection.py先base64.b64decode解码再用QImage.loadFromData载入最后调用ocr_run(qi)见 myutils/ocrutil.py执行当前 OCR 引擎返回识别结果的 JSON含文本、置信度与各识别块坐标等信息具体结构取决于所用 OCR 引擎。3.6GET /api/list/dictionary与GET /api/list/translator—— 可用引擎清单分别列出当前可用的词典与翻译器返回元素为{id: ..., name: ...}的 JSON 数组servicecollection.py/api/list/dictionary遍历globalconfig[cishuvisrank]中已实例化的词典gobject.base.cishusname由dynamiccishuname_TR国际化得到/api/list/translator遍历globalconfig[fix_translate_rank_rank]中已实例化的翻译器gobject.base.translators。这两个接口可与/api/translate、/api/dictionary配合使用先拉取清单获取id再按id精确调用形成枚举引擎 → 定向调用的完整工作流。3.7GET /api/textinput—— 文本输入注入必填查询参数text。把文本注入 LunaTranslator 的翻译管线servicecollection.py等价于从剪贴板或游戏文本源送入一段文本的效果is_auto_runFalse表示不触发自动执行而是走普通流程。适用于把外部文本源如其它工具抓取的文本接入翻译器的场景。四、WebSocket 服务实时文本流输出WebSocket 部分提供两个端点用于把游戏文本持续实时推送给客户端配合内置的 WebSocket 文本输出器使用端点用途/api/ws/text/origin持续输出抽取到的全部原文文本/api/ws/text/trans持续输出全部翻译结果它们由 textio/textoutput/websocket.py 驱动Outputer.dispatch(text, isorigin)在收到文本时根据isorigin区分原文/译文遍历wsoutputsave列表中的连接调用对应WSHandler.send_text(text)推送def dispatch(self, text: str, isorigin: bool): def __(handle): if isorigin and isinstance(handle, TextOutputOrigin): handle.send_text(text) elif (not isorigin) and isinstance(handle, TextOutputTrans): handle.send_text(text) WSForEach(wsoutputsave, __)也就是说任何连接到/api/ws/text/origin的客户端都会持续收到一条条原文文本帧连接到/api/ws/text/trans的客户端则收到翻译结果帧。该输出器可以在设置中作为文本输出方式启用对应配置项textoutputer.websocket见 config.json。4.1 内置 WebSocket 服务端实现服务端握手与帧协议均在WSHandlertcpservice.py中自实现握手校验Upgrade: websocket头与Sec-WebSocket-Key按 RFC 6455 用Sec-WebSocket-Key 258EAFA5-E914-47DA-95CA-C5AB0DC85B11做 SHA-1 Base64 得到Sec-WebSocket-Accept返回 101 状态码帧解析支持 FIN/opcode 解析、掩码异或解码、扩展长度126→2 字节、127→8 字节、文本帧opcode 0x1、Ping0x9/Pong0xA、关闭帧0x8发送send_text以文本帧发送 UTF-8 负载服务端发送无需掩码。同一套 WSHandler 还支撑了 GUI 内部的实时同步通道/__internalservice/mainuiws、/__internalservice/transhistws用于主界面与翻译历史页面的 JS ↔ Python 双向通信页面/page/mainui、/page/transhist的内容推送正是经由mainuiwsoutputsave、transhistwsoutputsave列表完成见 servicecollection_1.py。五、配置与使用开启服务、设置端口与常见场景服务开关与端口在 GUI 的文本输入设置页中配置gui/setting/textinput.py开启开关对应配置networktcpenable默认False开启/关闭都会触发serviceinit()立即重启服务端口号对应networktcpport取值范围 065535默认 2333修改后同样即时生效端口冲突时界面提示端口冲突打开按钮直接调用系统默认浏览器打开http://127.0.0.1:{port}即跳到导航页/。5.1 快速上手示例在设置页打开网络服务开关保持默认端口 2333浏览器访问http://127.0.0.1:2333/进入导航页或在设置页点击打开按钮打开/page/mainui即可看到与主窗口同步的文本点击单词可在/page/dictionary查词直接用命令行或脚本调用 API# 翻译未指定引擎 curl http://127.0.0.1:2333/api/translate?textこんにちは # 指定翻译器 ID 翻译先用 /api/list/translator 获取 id curl http://127.0.0.1:2333/api/translate?textこんにちはid翻译器ID # 查询全部词典SSE 流 curl http://127.0.0.1:2333/api/dictionary?word猫 # 指定词典查询 curl http://127.0.0.1:2333/api/dictionary?word猫id词典ID # MeCab 分词 curl http://127.0.0.1:2333/api/mecab?textすもももももものうち # TTS 合成保存音频 curl -o out.mp3 http://127.0.0.1:2333/api/tts?textこんにちは # OCRPOST 提交 base64 图片 curl -X POST http://127.0.0.1:2333/api/ocr \ -H Content-Type: application/json \ -d {image: base64图片数据}5.2 实时文本流WebSocket示例// 接收翻译结果流 const ws new WebSocket(ws://127.0.0.1:2333/api/ws/text/trans); ws.onmessage (e) console.log(译文:, e.data); // 接收原文流 const ws2 new WebSocket(ws://127.0.0.1:2333/api/ws/text/origin); ws2.onmessage (e) console.log(原文:, e.data);5.3 场景与限制说明本地自动化可作为本地翻译/词典/OCR/TTS 的 RPC 后端供浏览器插件、脚本或其它程序调用且所有响应带Access-Control-Allow-Origin: *浏览器跨域调用无障碍安全边界服务绑定0.0.0.0且默认无鉴权在局域网中任何可访问该端口的主机都能调用 API。如果只是本机使用建议不要对外暴露端口或通过系统防火墙限制访问可用性依赖/api/translate、/api/dictionary、/api/tts、/api/ocr均依赖当前已启用且配置正确的对应引擎实际可用的引擎 ID 以两个 list 接口返回为准关闭指定路由可通过配置项network_service_disabled_paths禁用任意路径命中即返回 404默认值为空列表。六、小结LunaTranslator 的内置网络服务是一套麻雀虽小、五脏俱全的自研轻量后端8 个 Web 页面路由让你在浏览器中复用主界面、翻译历史、词典、翻译/OCR/TTS 演示能力8 个 HTTP API 覆盖翻译、词典含 SSE 流式多词典查询、MeCab 分词、TTS 音频、OCR 识别、引擎清单与文本注入2 个 WebSocket 端点则提供原文/译文实时流输出配合文本输出器可支撑外部实时消费场景。结合 servicecollection.py、tcpservice.py 与 htmlcode/service 目录下的页面源码你既可以按本文的接口协议直接集成也可以参照其 Handler 写法理解路由注册、SSE 流式响应与 WebSocket 帧协议等实现细节。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 LunaTranslator 内置网络服务完全指南：HTTP API 与 WebSocket 的页面路由、接口协议与源码实现
LunaTranslator 内置网络服务完全指南HTTP API 与 WebSocket 的页面路由、接口协议与源码实现【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 除了桌面 GUI 外还内置了一套轻量级网络服务它以本机 TCP 服务的形式提供 Web 控制页面主界面同步、翻译历史、词典查询、翻译/OCR/TTS 演示页和一套可直接调用的 HTTP/WebSocket API方便外部程序、浏览器脚本乃至 Agent 把这款视觉小说翻译器当作一个可编程的翻译/OCR/词典后端来使用。读完本文你将掌握全部页面路由与 API 端点的请求格式、返回结构、配置方法以及这些能力在 tcpservice.py 与 servicecollection.py 中的底层实现原理。一、服务概览一个自带 Web 界面的本地 TCP 服务该网络服务并不是独立进程而是随 LunaTranslator 主程序运行的内嵌 TCP 服务。从源码结构看它由三层组成传输层tcpservice.py 中的TCPService负责监听端口、解析 HTTP 请求头与 body、按路径分发到具体 Handler同时内置了一个极简 WebSocket 服务端WSHandler。路由层servicecollection.py 中的registerall(service)一次性注册了全部 20 个路由8 个 Web 页面、8 个 HTTP API、4 个 WebSocket见registerall函数末尾的注册清单。应用层各 Handler 直接复用gobject.base中的翻译、词典、OCR、TTS、MeCab 解析等核心能力。服务在 LunaTranslator.py 的serviceinit()中启动self.service.stop() if globalconfig.get(networktcpenable, False): try: self.service.init(globalconfig.get(networktcpport, 2333)) except OSError: gobject.base.portconflict.emit(端口冲突)两个关键结论服务默认关闭networktcpenable默认False默认端口为 2333如果端口被占用界面会弹出端口冲突提示。TCP 层绑定的是0.0.0.0见 tcpservice.py即监听本机全部网卡地址。1.1 请求分发与响应模型TCPService.handle_client对每个连接做以下处理解析请求行与头部得到RequestInfo含path与解析后的query字典若路径命中globalconfig[network_service_disabled_paths]默认空列表见 config.json直接返回 404根据请求头是否包含Upgrade: websocket区分 WebSocket 握手与普通 HTTP 请求再遍历已注册 Handler 匹配path未命中任何路由则返回 404。响应统一由ResponseInfo构造它对不同 body 类型自动设置响应头tcpservice.pybody 类型Content-Type说明strtext/html; charsetutf-8页面文本dict/list/tupleapplication/json; charsetutf-8JSON 响应bytes需自行带ResponseWithHeader指定二进制数据如音频FileResponse由 MIME 助手按扩展名推断静态页面文件RedirectResponseLocation头 302重定向GeneratorTypetext/event-stream; charsetutf-8SSE 流式输出另外所有响应都带Access-Control-Allow-Origin: *因此浏览器跨域调用 API 时无需额外配置。二、Web 页面路由把翻译器的界面搬到浏览器以下 8 个页面路由在文档 docs/ja/apiservice.md 中有详细说明它们对应的实际页面文件位于 htmlcode/service 目录。2.1/—— 导航页返回 index.html内含指向其余页面的链接相当于服务主页导航页。2.2/page/mainui—— 主界面文本同步与主窗口TextBrowser显示的文本内容实时同步。实现上它返回的是渲染文本所用的同一套页面TextBrowser.loadex_()见 servicecollection.py数据推送则依赖内部 WebSocket见第五节。在浏览器里打开该页面看到的即是游戏内抽取文本的镜像视图支持点击单词查词典。2.3/page/transhist—— 翻译历史同步与翻译历史窗口wvtranshist显示的文本内容实时同步返回wvtranshist.loadex_()生成的页面servicecollection.py。2.4/page/dictionary—— 单词搜索页单词搜索页面。在/page/mainui中点击单词发起搜索时本页面负责展示结果。它的特殊之处在于支持word查询参数不带参数返回静态页面 dictionary.html带word参数由PageSearchWord处理会先对单词做原型还原WordSegResult.from_dict→word.prototype若原型与原文不同则 302 重定向到原型词的查询 URLservicecollection.py确保词典以词原型命中。2.5/page/manyinone—— 三合一集成页将上述主界面、翻译历史、词典三个页面集成到一个窗口的页面对应 manyinone.html。其实现非常巧妙用三个object内嵌/page/transhist、/page/dictionary、/page/mainui?__internal1并用 JavaScript 覆写 mainui iframe 的window.openobject data/page/mainui?__internal1 ... idmainui/object script const iframe document.getElementById(mainui) iframe.contentWindow.open(url){ document.getElementById(searchword).dataurl } /script效果正如文档所述在主界面子区块点击单词搜索时不会打开新窗口而是在当前页面的词典子区块内展示搜索结果。2.6/page/translate、/page/ocr、/page/tts分别是翻译接口、OCR 接口、TTS 接口的 Web 演示页返回 translate.html、ocr.html、tts.html。它们通常在前端用 JavaScript 调用下面第三、四节对应的 HTTP API。三、HTTP API把翻译器变成可编程后端3.1GET /api/translate—— 文本翻译必填查询参数text待翻译文本。可选参数id翻译器 ID。指定id时使用该翻译器进行翻译未指定id时走默认翻译流程从可用翻译器中选择结果返回。返回application/json包含翻译器 IDid、名称name、翻译结果result。源码实现servicecollection.pyAPITranslate.parse通过gobject.base.textgetmethod(text, False, waitforresultcallback..., waitforresultcallbackenginetsid, waitforresultcallbackengine_forceTrue)触发完整翻译管线含预处理、翻译、后处理并以threading.Event同步等待结果。错误时返回{error: ..., id: ..., name: ...}成功时返回{ id: 翻译器ID, name: 翻译器名称, result: 翻译结果文本 }id与name的映射分别由dynamicapiname()与国际化表_TR解析。未指定id时翻译器的选择顺序由配置项fix_translate_rank_rank默认空列表见 config.json决定。3.2GET /api/dictionary—— 词典查询必填查询参数word要查询的单词。可选参数id词典 ID。分两种行为指定id只查询该词典返回单个 JSON 对象含词典 IDid、词典名称name、HTML 内容result查询失败时返回空对象{}。源码对应 servicecollection.py 的APISearchWord.parse分支。未指定id并行查询全部已启用词典gobject.base.cishus返回SSEtext/event-stream流每个事件是一个 JSON 对象词典 IDid、名称name、HTML 内容result。这就是文档中返回event/text-stream的含义。实现细节iterhelper是一个生成器servicecollection.py对每个词典调用cishu.safesearch(...)异步搜索用threading.Semaphore收集结果并逐个yieldResponseInfo识别生成器类型后设置text/event-stream并在 tcpservice.py 中以data: {json}\n\n的 SSE 帧格式逐条发送。3.3GET /api/mecab—— MeCab 分词解析必填查询参数text。返回text的 MeCab 解析结果servicecollection.py内部调用gobject.base.parsehira(text)把每个词的解析结果原型、读音、词性等字段以 JSON 数组形式返回等价于界面上的日语假名/分词标注功能。3.4GET /api/tts—— 语音合成必填查询参数text。返回音频二进制数据非 JSON。源码servicecollection.py调用gobject.base.reader.ttscallback(text, callback)走当前 TTS 引擎通过ResponseWithHeader携带音频的content-type如audio/mpeg、audio/wav等 MIME来自TTSResult.mime与content-length返回若合成出错则返回{error: ...}。3.5POST /api/ocr—— 图片文字识别与其它端点不同本接口要求POST 方法请求体为 JSON{image: base64 编码的图片数据}。源码servicecollection.py先base64.b64decode解码再用QImage.loadFromData载入最后调用ocr_run(qi)见 myutils/ocrutil.py执行当前 OCR 引擎返回识别结果的 JSON含文本、置信度与各识别块坐标等信息具体结构取决于所用 OCR 引擎。3.6GET /api/list/dictionary与GET /api/list/translator—— 可用引擎清单分别列出当前可用的词典与翻译器返回元素为{id: ..., name: ...}的 JSON 数组servicecollection.py/api/list/dictionary遍历globalconfig[cishuvisrank]中已实例化的词典gobject.base.cishusname由dynamiccishuname_TR国际化得到/api/list/translator遍历globalconfig[fix_translate_rank_rank]中已实例化的翻译器gobject.base.translators。这两个接口可与/api/translate、/api/dictionary配合使用先拉取清单获取id再按id精确调用形成枚举引擎 → 定向调用的完整工作流。3.7GET /api/textinput—— 文本输入注入必填查询参数text。把文本注入 LunaTranslator 的翻译管线servicecollection.py等价于从剪贴板或游戏文本源送入一段文本的效果is_auto_runFalse表示不触发自动执行而是走普通流程。适用于把外部文本源如其它工具抓取的文本接入翻译器的场景。四、WebSocket 服务实时文本流输出WebSocket 部分提供两个端点用于把游戏文本持续实时推送给客户端配合内置的 WebSocket 文本输出器使用端点用途/api/ws/text/origin持续输出抽取到的全部原文文本/api/ws/text/trans持续输出全部翻译结果它们由 textio/textoutput/websocket.py 驱动Outputer.dispatch(text, isorigin)在收到文本时根据isorigin区分原文/译文遍历wsoutputsave列表中的连接调用对应WSHandler.send_text(text)推送def dispatch(self, text: str, isorigin: bool): def __(handle): if isorigin and isinstance(handle, TextOutputOrigin): handle.send_text(text) elif (not isorigin) and isinstance(handle, TextOutputTrans): handle.send_text(text) WSForEach(wsoutputsave, __)也就是说任何连接到/api/ws/text/origin的客户端都会持续收到一条条原文文本帧连接到/api/ws/text/trans的客户端则收到翻译结果帧。该输出器可以在设置中作为文本输出方式启用对应配置项textoutputer.websocket见 config.json。4.1 内置 WebSocket 服务端实现服务端握手与帧协议均在WSHandlertcpservice.py中自实现握手校验Upgrade: websocket头与Sec-WebSocket-Key按 RFC 6455 用Sec-WebSocket-Key 258EAFA5-E914-47DA-95CA-C5AB0DC85B11做 SHA-1 Base64 得到Sec-WebSocket-Accept返回 101 状态码帧解析支持 FIN/opcode 解析、掩码异或解码、扩展长度126→2 字节、127→8 字节、文本帧opcode 0x1、Ping0x9/Pong0xA、关闭帧0x8发送send_text以文本帧发送 UTF-8 负载服务端发送无需掩码。同一套 WSHandler 还支撑了 GUI 内部的实时同步通道/__internalservice/mainuiws、/__internalservice/transhistws用于主界面与翻译历史页面的 JS ↔ Python 双向通信页面/page/mainui、/page/transhist的内容推送正是经由mainuiwsoutputsave、transhistwsoutputsave列表完成见 servicecollection_1.py。五、配置与使用开启服务、设置端口与常见场景服务开关与端口在 GUI 的文本输入设置页中配置gui/setting/textinput.py开启开关对应配置networktcpenable默认False开启/关闭都会触发serviceinit()立即重启服务端口号对应networktcpport取值范围 065535默认 2333修改后同样即时生效端口冲突时界面提示端口冲突打开按钮直接调用系统默认浏览器打开http://127.0.0.1:{port}即跳到导航页/。5.1 快速上手示例在设置页打开网络服务开关保持默认端口 2333浏览器访问http://127.0.0.1:2333/进入导航页或在设置页点击打开按钮打开/page/mainui即可看到与主窗口同步的文本点击单词可在/page/dictionary查词直接用命令行或脚本调用 API# 翻译未指定引擎 curl http://127.0.0.1:2333/api/translate?textこんにちは # 指定翻译器 ID 翻译先用 /api/list/translator 获取 id curl http://127.0.0.1:2333/api/translate?textこんにちはid翻译器ID # 查询全部词典SSE 流 curl http://127.0.0.1:2333/api/dictionary?word猫 # 指定词典查询 curl http://127.0.0.1:2333/api/dictionary?word猫id词典ID # MeCab 分词 curl http://127.0.0.1:2333/api/mecab?textすもももももものうち # TTS 合成保存音频 curl -o out.mp3 http://127.0.0.1:2333/api/tts?textこんにちは # OCRPOST 提交 base64 图片 curl -X POST http://127.0.0.1:2333/api/ocr \ -H Content-Type: application/json \ -d {image: base64图片数据}5.2 实时文本流WebSocket示例// 接收翻译结果流 const ws new WebSocket(ws://127.0.0.1:2333/api/ws/text/trans); ws.onmessage (e) console.log(译文:, e.data); // 接收原文流 const ws2 new WebSocket(ws://127.0.0.1:2333/api/ws/text/origin); ws2.onmessage (e) console.log(原文:, e.data);5.3 场景与限制说明本地自动化可作为本地翻译/词典/OCR/TTS 的 RPC 后端供浏览器插件、脚本或其它程序调用且所有响应带Access-Control-Allow-Origin: *浏览器跨域调用无障碍安全边界服务绑定0.0.0.0且默认无鉴权在局域网中任何可访问该端口的主机都能调用 API。如果只是本机使用建议不要对外暴露端口或通过系统防火墙限制访问可用性依赖/api/translate、/api/dictionary、/api/tts、/api/ocr均依赖当前已启用且配置正确的对应引擎实际可用的引擎 ID 以两个 list 接口返回为准关闭指定路由可通过配置项network_service_disabled_paths禁用任意路径命中即返回 404默认值为空列表。六、小结LunaTranslator 的内置网络服务是一套麻雀虽小、五脏俱全的自研轻量后端8 个 Web 页面路由让你在浏览器中复用主界面、翻译历史、词典、翻译/OCR/TTS 演示能力8 个 HTTP API 覆盖翻译、词典含 SSE 流式多词典查询、MeCab 分词、TTS 音频、OCR 识别、引擎清单与文本注入2 个 WebSocket 端点则提供原文/译文实时流输出配合文本输出器可支撑外部实时消费场景。结合 servicecollection.py、tcpservice.py 与 htmlcode/service 目录下的页面源码你既可以按本文的接口协议直接集成也可以参照其 Handler 写法理解路由注册、SSE 流式响应与 WebSocket 帧协议等实现细节。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考