物联网后端【免费下载链接】OctoPrintOctoPrint is the snappy web interface for your 3D printer!项目地址https://gitcode.com/gh_mirrors/oc/OctoPrint点击查看免费下载OctoPrint 提供了多语言支持允许用户通过语言包language pack为 Web 界面安装不同的翻译。在官方 JavaScript 客户端库中这一能力被封装为OctoPrintClient.languages组件对应 docs/jsclientlib/languages.rst 所描述的list、upload、delete三个方法。本文将围绕这三个方法结合前端客户端实现 client/languages.js 与后端 REST API 实现 server/api/languages.py讲解其调用方式、返回数据模型、后端校验逻辑与权限要求帮助你直接在浏览器控制台、自研插件或第三方前端中管理 OctoPrint 的界面语言。前置条件方法调用需要管理员权限使用OctoPrintClient.languages下的所有方法要求当前使用的 API Token 或已有浏览器会话具备管理员权限。这一点与底层 Languages API 的权限设定一致——服务端每个路由都通过Permissions.SETTINGS.require(403)进行鉴权见 languages.py无权限时返回 HTTP 403。因此在实际使用前请确认通过new OctoPrintClient({baseurl: ..., apikey: ...})构造客户端时传入的 apikey 属于具有管理员权限的用户或当前浏览器会话已登录管理员账号客户端会自动携带会话凭证第一次运行first run尚未完成设置向导时相关请求会被no_firstrun_access拦截languages.py因此应先完成初始配置。客户端组件注册与访问方式OctoPrintClient.languages并不是内置在核心客户端对象上的方法而是一个通过组件注册机制挂载的独立子客户端。在 client/languages.js 末尾可以看到OctoPrintClient.registerComponent(languages, OctoPrintLanguagesClient);registerComponent定义于 client/base.js它通过Object.defineProperty在OctoPrintClient.prototype上定义一个惰性 getter首次访问时才实例化组件。因此只要你拿到了一个OctoPrintClient实例官方页面中通常就是全局的OctoPrint即可直接通过OctoPrint.languages访问该组件且每个实例只会创建一次子客户端var client new OctoPrintClient({baseurl: http://localhost:5000, apikey: abcdef...}); client.languages.list(); // 列出已安装语言包 client.languages.upload(file); // 上传语言包 client.languages.delete(de, _core); // 删除指定语言包该子客户端内部把 URL 固定为api/languageslanguages.js所有方法最终都委托给基础客户端的get/upload/delete请求助手向服务器发起对应的 HTTP 请求。list(opts)列出已安装的语言包OctoPrintClient.languages.list(opts)用于检索当前已安装的语言包列表这是三个方法中最常用、也是整个语言管理流程的入口。方法签名与实现OctoPrintLanguagesClient.prototype.list function (opts) { return this.base.get(url, opts); };optsobject可选请求的附加选项如 headers、timeout 等会原样传递给底层 jQuery AJAX 配置返回值一个jQuery Promise对应请求的响应可通过.done()/.fail()链式处理。底层对应服务端的GET /api/languages。服务端处理函数getInstalledLanguagePacks()languages.py会扫描settings().getBaseFolder(translations)目录顶层每个子目录代表一个核心语言包_plugins子目录下每个插件目录代表一个插件的语言包集合每个语言包读取其meta.yaml元数据并利用flask_babel.Locale.parse生成规范化的 locale 字符串、本地化显示名与英文名。若last_update是 datetime 类型会被转换为 Unix 时间戳languages.py。返回数据结构响应体是一个 JSON 对象核心字段为language_packs——一个以组件标识符为键的映射。键_core代表核心 OctoPrint其余键为插件标识符。完整数据模型见 docs/api/languages.rst层级字段类型说明顶层language_packsmap按组件标识符索引的组件列表映射组件列表identifierstring_core或插件标识符组件列表displaystring组件显示名核心为Core插件为插件名组件列表languageslist该组件的语言包元数据列表语言包元数据localestring语言包的 locale如de语言包元数据locale_displaystringlocale 的本地化显示名如Deutsch语言包元数据locale_englishstringlocale 的英文表示如German语言包元数据last_updateint可选语言包最近更新时间戳语言包元数据authorstring可选语言包作者一个典型响应示例{ language_packs: { _core: { identifier: _core, display: Core, languages: [] }, some_plugin: { identifier: some_plugin, display: Some Plugin, languages: [ { locale: de, locale_display: Deutsch, locale_english: German, last_update: 1474574597, author: Gina Häußge }, { locale: it, locale_display: Italiano, locale_english: Italian, last_update: 1470859680, author: The italian Transifex Team } ] } } }官方前端中的实际用法OctoPrint 自带的设置对话框正是通过该 API 拉取语言包列表的。在 viewmodels/settings.js 中self.requestTranslationData function () { return OctoPrint.languages.list().done(self.fromTranslationResponse); };fromTranslationResponse会把language_packs映射按 locale 重新分组并将_core排在每个 locale 下所有插件语言包之前最终渲染到外观 → 管理语言包对话框中。这意味着你完全可以用同样的数据在自定义 UI 中重建语言管理界面。upload(file)上传并安装语言包OctoPrintClient.languages.upload(file)用于向 OctoPrint 上传一个新的语言包归档。方法签名与实现OctoPrintLanguagesClient.prototype.upload function (file) { return this.base.upload(url, file); };fileobject 或 string要上传的文件。其语义与OctoPrint.upload完全一致——可以是File对象也可以是与某个input typefile关联的 jQuery 元素/选择器字符串还可以是包含name与path的文件描述对象。上传采用multipart/form-data编码表单字段名为file返回值jQuery Promise成功时同样解析为已安装语言包列表与list()的响应结构相同因为服务端在上传完成后会直接复用getInstalledLanguagePacks()返回最新列表languages.py。支持的归档格式与校验流程底层对应POST /api/languages。服务端uploadLanguagePack()languages.py会依次执行以下校验请求必须包含file表单字段否则返回 400No file included文件名必须以.zip、.tar.gz、.tgz或.tar结尾否则返回 400注意虽然扩展名校验同时接受这四种但后续安装逻辑实际只处理 zip 归档见下条文件必须是合法的 zip 归档zipfile.is_zipfile否则返回 400调用_validate_and_install_language_pack()验证并安装失败则返回 400Invalid language pack archive。_validate_and_install_language_pack()languages.py的核心逻辑值得注意路径穿越防护解压前会检查归档内所有条目确保解压后都位于临时目录之内防止恶意归档覆盖任意路径languages.py目录结构校验通过_validate_and_install_translations()languages.py逐个检查顶层目录一个合法的语言包目录必须同时满足目录名可被babel.core.Locale.parse解析为合法 locale目录内存在meta.yaml元数据文件目录内存在LC_MESSAGES/子目录且其中有messages.mo编译后的翻译文件满足上述条件后目录会被移动到 translations 根目录下安装到_core插件语言包如果归档内还包含_plugins/目录其下的每个插件子目录会被递归安装到_plugins/插件标识/下languages.py。因此一个可被成功上传的核心语言包 zip 归档结构应为my-language-pack.zip └── de/ # 顶层目录名即 locale ├── meta.yaml # 元数据可含 last_update、author 等 └── LC_MESSAGES/ └── messages.mo # gettext 编译产物官方前端的文件上传交互在设置对话框中官方前端使用 jQuery File Upload 插件绑定上传控件viewmodels/settings.jsmaxNumberOfFiles: 1、autoUpload: false用户选择文件后点击开始上传按钮才调用data.submit()提交表单。上传完成后同样通过fromTranslationResponse刷新列表。你自己实现上传时可以直接构造File对象调用OctoPrint.languages.upload(file)无需关心表单细节。delete(locale, pack, opts)删除语言包OctoPrintClient.languages.delete(locale, pack, opts)用于删除指定 locale 下的某个语言包。方法签名与实现OctoPrintLanguagesClient.prototype.delete function (locale, pack, opts) { var packUrl url / locale / pack; return this.base.delete(packUrl, opts); };localestring必填要删除的语言包的 locale例如de、itpackstring必填要删除的语言包标识。可以是_core删除核心翻译也可以是插件标识符删除该插件的翻译optsobject可选请求附加选项返回值jQuery Promise成功时解析为最新的已安装语言包列表。服务端行为底层对应DELETE /api/languages/locale/pack。服务端deleteInstalledLanguagePack()languages.py根据pack是否为_core决定目标路径pack _core删除translations/locale/目录否则删除translations/_plugins/pack/locale/目录。若目标目录存在则递归删除随后同样返回最新语言包列表。删除是目录级操作——会移除该 locale 下整个语言包目录含meta.yaml与LC_MESSAGES/。在官方设置对话框中删除操作由 settings.js 中的deleteLanguagePack触发self.deleteLanguagePack function (locale, pack) { OctoPrint.languages.delete(locale, pack).done(self.fromTranslationResponse); };三个方法与 HTTP 端点映射一览客户端方法HTTP 请求后端处理函数主要行为languages.list(opts)GET /api/languagesgetInstalledLanguagePacks列出已安装语言包languages.upload(file)POST /api/languagesmultipart/form-datauploadLanguagePack校验并安装语言包归档languages.delete(locale, pack, opts)DELETE /api/languages/locale/packdeleteInstalledLanguagePack删除指定 locale 下的语言包三个方法均要求SETTINGS权限除upload使用 multipart 表单外其余均为常规 JSON 请求。所有方法成功后返回的语言包列表结构一致方便在前端用同一套渲染逻辑刷新界面。完整可运行示例浏览器控制台实战下面是一个可直接粘贴到浏览器控制台需处于已登录管理员的 OctoPrint 页面中的完整示例覆盖查询 → 上传 → 再次查询 → 删除全流程// 1. 列出当前已安装语言包 OctoPrint.languages.list().done(function (response) { console.log(已安装语言包, response.language_packs); }); // 2. 上传一个语言包以 File 对象为例 var input document.createElement(input); input.type file; input.accept .zip; input.onchange function () { var file input.files[0]; if (!file) return; OctoPrint.languages.upload(file) .done(function (response) { console.log(上传成功最新语言包列表, response.language_packs); }) .fail(function (xhr) { console.error(上传失败, xhr.status, xhr.responseJSON); }); }; input.click(); // 3. 删除核心翻译中的德语语言包 OctoPrint.languages.delete(de, _core).done(function (response) { console.log(删除成功最新语言包列表, response.language_packs); });常见错误与排查思路现象可能原因排查建议请求返回 403API Token 或会话缺少SETTINGS权限确认使用管理员账号的 apikey上传返回 400No file included请求缺少file表单字段确认传入的文件对象/选择器有效上传返回 400 扩展名错误文件名不以 zip/tar.gz/tgz/tar 结尾检查文件扩展名上传返回 400Invalid language pack archive归档不是 zip或缺少meta.yaml/LC_MESSAGES/messages.mo对照上文归档结构校验目录布局上传返回 400No zip file included文件内容不是合法 zip确认文件未损坏、确实是 zip 格式总结OctoPrintClient.languages用三个方法完整覆盖了 OctoPrint 语言包的生命周期list查询已安装语言包含核心与各插件翻译的元数据、upload上传并安装语言包归档服务端会做扩展名、zip 格式、目录结构与路径穿越多重校验、delete按 locale 与包标识删除翻译目录。前端实现位于 client/languages.js后端逻辑集中在 server/api/languages.py完整的 HTTP 语义与数据模型可进一步参考 docs/api/languages.rst。对于需要为 OctoPrint 构建自定义语言管理界面或批量同步翻译的开发者这套客户端 API 是最直接、最受官方支持的入口。赞分享物联网后端【免费下载链接】OctoPrintOctoPrint is the snappy web interface for your 3D printer!项目地址https://gitcode.com/gh_mirrors/oc/OctoPrint点击查看免费下载相关推荐FastEmbed终极指南5分钟掌握高速向量嵌入技术FastEmbed终极指南5分钟掌握高速向量嵌入技术 你是否曾经为生成文本向量而苦恼于复杂的配置和缓慢的运行速度是否在寻找一个既轻量又高效的嵌入生成解决方案如何用Automated YouTube Channel打造24/7自动运行的YouTube频道终极指南如何用Automated YouTube Channel打造24/7自动运行的YouTube频道终极指南 Automated YouTube Channel是物联网后端SaramaGo语言Kafka客户端完整指南SaramaGo语言Kafka客户端完整指南 想象一下当你需要在Go应用中集成Kafka消息队列时面对复杂的协议细节和性能优化挑战是否曾感到无从下手S消息队列后端上一篇Flask开源项目赏析基于awesome-flask的10个优秀案例研究下一篇Roo Code深度解析如何将整个AI开发团队装进你的代码编辑器创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考