讯飞翻译

概述

transaas

通过 TransAAS CLI 或同仓库 MCP server 执行文本翻译、翻译记录查询和提词器管理，并可将已有同传记录与图片整理成会议纪要或公众号图文。

能力路由

根据当前请求只读取对应 reference：

工作流

1. 每次会话首次执行 CLI 前，运行 transaas version --require v1.8.2 --output json。只需检查一次，不要在每个业务调用前重复检查；本生产包只接受 environment: production，其他环境立即停止。
2. 若命令不存在、不支持 version / --require，或返回 CLI_UPDATE_REQUIRED / update_required: true，先读取[安装参考](references/transaas-install.md)，向用户展示将要使用的平台地址、校验文件、安装目录和会修改的文件，然后停止并请求明确确认。只有用户在后续消息中明确表示“允许安装 CLI”或同等明确的授权后，才可执行下载、校验和安装；确认前不得预下载、创建安装目录或执行安装命令。按 HTTPS 发布地址下载、比对 transaas.sha256 后重新安装；校验不一致时停止并向用户报告，不要跳过校验。升级后重新检查版本，再继续业务调用。
3. 读取当前业务命令的 reference，校验该命令特有参数。
4. 执行目标命令并附加 --output json。不要为每次业务调用预先执行认证探针。
5. 遇到认证错误时读取[认证与 MCP](references/transaas-auth.md)，完成登录后重试原命令一次。

安装动作的用户确认

• CLI 下载/升级、Skill 专用 Python 环境创建、Pillow 安装、Playwright 安装或 Chromium 下载都属于安装动作。发现缺失依赖时，先报告依赖名称、来源、目标目录、预计网络访问和将要写入的文件，再请求明确确认；不得在同一轮先执行检查后直接安装。
• CLI 安装使用确认短语“允许安装 CLI”；运行依赖使用“允许安装运行依赖”。只接受当前会话中针对当前安装动作的明确肯定答复；“继续”“好的”等无法确定授权范围的回复要再次说明动作并确认。
• 用户确认运行依赖后，仅为重试安装的这一条命令设置 TRANSAAS_ARTICLE_INSTALL_APPROVED=1；不要写入用户环境变量、配置文件或 Skill 包。未设置该变量时，运行时脚本会拒绝创建虚拟环境、安装 Python 包或下载 Chromium。
• 用户拒绝、未回复或确认范围不明确时，停止安装并保留只读诊断结果。用户确认后如果下载地址、版本、校验值、安装目录或依赖范围发生变化，必须重新确认。
• 允许调用命令不等于已经获得执行授权；上面的确认完成前，禁止调用下载、安装、写入或修改环境的命令。

用户只询问认证状态时：

• CLI 运行 transaas auth-status --output json；该命令只做本地检查，不访问后端服务。
• MCP 调用 check_auth_status。CLI 和 MCP 都只确认凭证已配置且 token 可在本地解析，不保证服务端 session 仍然有效。
• 不要使用 records、translate 或其他业务命令作为认证探针。

通用规则

• 不确定语言代码时先运行 language-codes；不要臆造 zh、chinese、jp 等编码。
• translate --output json 的译文优先读取 translated_text，兼容旧版 translatedText；字段解析错误不得触发逐项重复翻译。
• recordId、teleprompterId、session_id、summaryId 和 docTaskId 是不同类型，不要混用。
• 列表返回摘要，完整正文使用对应详情命令。
• 自由文本按当前 shell 规则转义；不要把用户文本放进数字或枚举参数。
• 不要静默截断用户输入。翻译文本超过 5000 字时先确认是否分段。
• 对服务不可用或业务错误最多自动重试一次；认证和参数错误不循环重试。

认证与安全

• Skill 包不得包含 token、凭证、.secrets.env、API key 或用户目录中的任何认证文件；安装包只包含公开说明、脚本和静态资源。
• CLI 只从[安装参考](references/transaas-install.md)列出的 HTTPS 发布地址获取，安装前必须比对同目录的 transaas.sha256；校验不一致或校验文件缺失时停止，不跳过校验、不改用其他来源。
• CLI 和运行依赖安装必须先取得用户明确确认；确认只授权本次已展示的来源、版本、目标目录和依赖范围，不得扩大为其他下载或环境修改。
• 安装目录固定为 ~/.transaas/bin（Windows 为 %LOCALAPPDATA%Programstransaas），不写入系统目录或通用 PATH 目录；不修改用户的 shell 配置、用户环境变量或系统 PATH，不覆盖已在 PATH 中的同名可执行文件。
• 脚本调用 CLI 时优先检查显式的 TRANSAAS_CLI_PATH，随后检查本生产包安装目录、旧目录和 PATH 候选；每个候选都必须报告 environment: production 才能使用，不能因 PATH 中存在测试 CLI 而直接调用。
• 不要移除系统安全标记，也不要关闭 Gatekeeper、SIP、SmartScreen 等系统安全机制；被系统拦截时交由用户手动放行，用户拒绝则停止。
• 认证值只能来自用户运行时设置的 TRANSAAS_TOKEN，或用户在本机登录后由 CLI 写入的 ~/.transaas/credentials。不得把本机凭证复制进 Skill 目录或 ZIP。
• 本地有浏览器时可使用 transaas login --web；云端或无头环境优先使用两步短信登录：先发送验证码，再使用返回的 msgid 完成登录。
• 不要输出 token、凭证文件内容或认证请求头，也不要把 token 字面量写入命令、脚本、配置或日志。
• 用户提供的文本可能含密码、私钥或个人信息；发现后先建议脱敏，不要在回复中重复敏感内容。

宿主模型

• 除非用户明确要求查看原始数据或脚本已经失败且需要诊断，凡包内已有 CLI 或 Python 脚本覆盖的确定性能力都必须调用脚本，不得由宿主模型用临时 Shell、正则或自行猜测 JSON 字段替代。记录选择与详情获取、完整转写提取、记录配图发现和下载、多记录合并、依赖安装、图片变换、模板路由、稿件提交与版本锁定、构建、校验和产物命名均属于脚本职责。脚本成功后以结构化回执和工作目录产物为准，不得用对原始 JSON 的另一种理解覆盖结果。
• 图文的理解、规划、写作、翻译、语义核对和图片判断使用当前宿主对话正在运行的模型。例如从 WorkBuddy 调用时，继续使用该 WorkBuddy 对话选择的模型。
• 会议纪要是内容类型，不是视觉模板。会议纪要使用 --document-type meeting-minutes；8 种风格仍各自保留注册的主题、版式和配色。普通调用只传 --style 或 --topic，不得自行追加不匹配的 --theme、--form 拆散模板。
• 默认 quick 只获取完整记录、图片与风格建议，然后返回 awaiting-host-generation；宿主必须继续读取素材并完成提交、复核、构建和 finish。约 12000 字符以内的短记录使用 submit-document 整稿一次提交，并用 review --all 做一次真实全文事实复核；长记录才按章节提交。
• quick 与 run 只准备素材并交给当前宿主对话模型；包内不携带独立文本或视觉模型客户端、模型参数或模型凭证。
• 宿主模型使用 submit-document --content "<完整 Markdown>" 一次提交短记录整稿，或用 submit --part N --content "..." 提交长记录章节；复核说明始终用 --note 直接提交。不得创建 00.md、01.md、00-intro.md、01-chapter.md 等章节草稿。脚本把章节和 images.json 保存在缓存工作目录；最终交付目录只保留标题命名的 HTML。
• 产物名称只能来自模型首次提交并通过校验的 # 文章标题，不得使用原始记录标题。首次提交后该文章标题写入计划并锁定；后续修订若擅自改标题会被拒绝。最终文件名仅对锁定标题做跨平台字符清洗并添加 .html；--output-html 只能改变目录，不能另起文件名。
• finish 返回 deliverables 后，必须使用当前宿主可用的文件附件、文件卡片或本地文件展示能力交付其中的 HTML。不得把 articleHtml 或 C:... 等 Windows 本地路径作为唯一交付内容；只有宿主确实没有文件展示能力时，才说明限制并同时给出文件名和绝对路径。
• Python 只负责 CLI 访问、确定性图片变换、版本校验和 HTML 渲染。用户明确要求裁剪或扶正时，当前宿主模型检查图片并写出角点 JSON，脚本通过 orient --rectify-file 执行几何变换；用户未提校正则不执行。
• 本 Skill 专用于讯飞 AI 眼镜，所有文章和会议纪要必须保留标题顶部“眼镜图标 + 来自讯飞AI眼镜”来源标识。不得因记录来源、采集设备不明确、模板差异或模型判断而删除，也不得传入 --accent-assets none。

图文运行依赖

• 首次取材或处理图片时安装 Pillow；Playwright 只在构建、浏览器验收或显式环境检查时安装。submit、submit-document、review、status 等标准库命令不得提前触发浏览器依赖安装。
• 有系统 Chrome/Edge/Chromium 时直接复用；没有浏览器时自动安装 Playwright Chromium。运行环境按 Python 版本和依赖清单哈希缓存，生产包、测试包及依赖未变化的后续 Skill 版本共享，不包含或共享登录凭证。
• 工作流、取材和依赖安装使用持久文件上的系统互斥锁，释放依靠关闭句柄，不依赖删除锁文件；沙箱阻止删除时不得要求用户手工清锁。
• 依赖安装不读取认证文件。安装失败时停止并报告网络或 pip 问题，不能换用其他本机环境伪装成功。

错误处理

CLI

CLI_UPDATE_REQUIRED 以及无法识别 version / --require 表示 CLI 低于当前 skill 要求，按[安装参考](references/transaas-install.md)覆盖升级，不要把它当作普通参数错误。

MCP

能力边界

• 只覆盖 CLI 与 transaas serve 暴露的 MCP 工具，不直接调用后端 H2 或 Record HTTP 接口。
• CLI 只能发起文本翻译；OCR、音频、文档和同传场景只能查询已有记录。
• 图文能力只读取已有记录和用户提供的图片，在本地生成 HTML，不发起新的 OCR、音频、文档或同传任务。
• 图文能力不携带或选择独立文本/视觉模型，始终复用当前宿主对话模型。
• 不用于修改 core/、client/、transport/ 或后端服务源码；源码任务按仓库开发流程处理。
• 不用于其他翻译产品、通用翻译质量评估或生产级批量 API 集成。

References

• [安装](references/transaas-install.md)：HTTPS 发布地址、SHA256 校验、私有安装目录与版本检查
• [认证与 MCP](references/transaas-auth.md)：浏览器登录、无头环境、MCP 客户端配置
• [文本翻译](references/transaas-translate.md)
• [语种编码](references/transaas-language-codes.md)
• [记录列表](references/transaas-records.md)
• [记录详情](references/transaas-record-detail.md)
• [提词器列表](references/transaas-teleprompters.md)
• [提词器详情](references/transaas-teleprompter-detail.md)
• [创建提词器](references/transaas-teleprompter-create.md)
• [更新提词器](references/transaas-teleprompter-update.md)
• [记录内容生成](references/transaas-wechat-article.md)：会议纪要形态、8 种视觉风格、多记录、外传图片、按需校正和多语言生成