文字翻译接入规则¶
动态、评论/回复及私密明信片继续使用各自的独立接口;本页只维护共用规则,不提供任意正文翻译入口。
目标语言与回退¶
targetLanguage可省略、null或空白。默认目标由后台按顺序决定:
- 原始Accept-Language中的App界面四语,按权重选择,排除q=0和通配符。
- 当前Bearer所属用户的spokenLanguage,不读取作者语言或learningLanguage。
- 两项均无有效值时使用en。
显式非空targetLanguage优先于上述默认规则,兼容已有调用方的明确选择;去首尾空白后最多35字符,采用字母、数字和短横线组成的合法语言标签。非法或未支持值返回400 BAD_REQUEST,不静默回退。旧版动态/评论“省略即中文”改为本规则;明信片也允许省略目标。
最终规范目标为zh-CN、en、ja、ko、es、fr、pt、de、ar、hi,与资料语言目录对应;zh及中文地区变体统一为简体zh-CN,en-US/ja-JP/ko-KR/pt-BR等归一到语言代码。目标必须是字符串,数字、布尔值、数组及对象不接受。
App默认传当前实际生效的界面语种;没有可用值时省略目标,并保留该请求语言头的缺失状态,不能先补英文而跳过本人语言回退。不需新增一次资料请求。成功/错误message仍按HTTP四语约定,正文实际目标以data.targetLanguage为准;App界面四语没有扩展为十语。
模型与内容范围¶
固定DeepSeek官方deepseek-flash、thinking.type=disabled、非流式JSON输出,初始temperature=0.2。提示词要求忠实原意、自然口语,保留肯否、不确定性、情绪、礼貌和亲密程度,不额外润色或回答原文问题。
原文及上下文只从后台已授权、已审核且仍可见的记录取得;客户端不传原文、身份、上下文、供应商地址或密钥。动态直接翻译正文;评论可附当前可见父动态及直接回复对象;明信片正文/问题同次翻译且分别返回,回信可附同卡已审首信。参考上下文最多2000个UTF-16代码单元,不发送无关账号资料。
sourceLanguage继续是原记录保存的语言标签,可能为und或其他合法BCP47标签,不是模型置信度或检测结果,也不限制为十个目标语种。原文已为目标语言、品牌或表情时,真实结果可能与原文相同。
返回与客户端状态¶
现有成功响应结构不变;译文为普通文本,不当作HTML或执行指令,也不覆盖原文和人工审核状态。返回前重新核验内容可见性及原文/上下文,等待期间删除、下架、屏蔽或来源变化不返回旧译文。
配置缺失返回503 TRANSLATION_UNAVAILABLE;供应商状态错误、网络失败、超时、空白、JSON错字段、拒绝或截断返回503 TRANSLATION_FAILED,不返回部分译文或原文伪装成功。连接时限3秒、完整响应总时限15秒、供应商响应最多32KiB、译文合计最多8000个UTF-16代码单元。一次业务请求只调用一次供应商,不自动重试;既有翻译小时额度保持每用户60次。
App仅主动点击时请求,合并相同内容在途操作,保留原文和失败重试入口。切语言、退出/换号后隔离迟到响应;显式目标按规范值核对,默认回退接受后台实际目标,并用内容、会话和实际目标区分译文缓存。
接口与验证范围¶
2026-11-11正式部署环境已部署(上线前阶段)DeepSeek非思考翻译。完整隔离回归后,对最终改动及最新运行基线重新执行相关clean verify;按每套件最新结果合计1167项,0失败、错误和跳过。16次真实供应商调用覆盖十语、本人语言回退、父文评论、俚语、指令原文及明信片首信/回信,均取得完整有效译文;这不代表所有文本的语义质量均已人工验收。
Flutter动态/评论24项专项及格式、分析、AST检查通过;对已部署后端完成9次真实Dio翻译(动态/评论中英日韩及缺失语言回退)和400/404两项失败边界,测试会话已注销且服务端复核无活动会话。现有iOS模拟器已验证主动翻译、显示译文和返回原文,并恢复原页面及账号;物理真机未验收。客户端全仓1853项通过、43项条件跳过、4处既有非翻译断言失败,不标记全仓通过。
明信片App目前仍为静态首页,本轮未扩展收寄页面,其翻译后端验证不代表客户端已接入。