Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions plugins/baidu-translate/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
node_modules/
src-ztools/dist/
*.log
.env*
.DS_Store
Thumbs.db
27 changes: 27 additions & 0 deletions plugins/baidu-translate/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# 更新日志

## 1.1.2 - 2026-11-05

- 修复发布包内端点常量引用错误导致的"网络请求失败"
- 网络请求优先走 Electron net 模块(跟随系统代理),node https 兜底
- 网络错误提示附带真实原因(DNS / 连接 / HTTP 状态),便于排查

## 1.1.1 - 2026-11-05

- 网络请求增加 User-Agent,避免被目标服务误拦截

## 1.1.0 - 2026-11-05

- 布局改为上下结构:顶部语言栏,下方左右分栏(左输入 / 右结果)
- 输入自动翻译(600ms 防抖,中文输入法组合期不触发)
- 单词查询词典卡片:多词性含义、音标、词形变化(复数 / 过去式等)、考试标签、英英释义与例句
- 变形词(claims 等)自动查原形词典择优合并
- 智能方向:中文 → 英文,英文 / 日语 / 韩语等 → 中文
- 最近 50 条翻译历史,点击回看重翻
- 译文逐段 / 整体复制

## 1.0.0 - 2026-11-05

- 初次发布:基于百度翻译开放平台通用翻译 API 的 ZTools 翻译插件
- 密钥本地 AES-256-GCM 加密存储,secretKey 不出 preload,不上传任何第三方服务器
- 源语言自动检测,28 种语言互译,语言方向互换
59 changes: 59 additions & 0 deletions plugins/baidu-translate/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
# 百度翻译(ZTools 插件)

基于百度翻译开放平台通用翻译 API 的 ZTools 翻译插件。只接百度翻译,无其他厂商。

## 功能

- 输入自动翻译(600ms 防抖),Enter 立即翻译,Shift+Enter 换行
- 智能方向:输入中文 → 译成英文;输入英文/日语/韩语等 → 译成中文(也可手动指定语言)
- 左右分栏:左侧原文,右侧结果
- 单词查询显示词典卡片:多词性含义、音标、词形变化(复数/过去式等)、考试标签、英英释义与例句;变形词自动查原形补全
- 译文逐段/整体复制,最近 50 条历史可回看
- 在 ZTools 主输入框输入文字回车进插件,自动带入并翻译

## 密钥配置与安全

1. 到[百度翻译开放平台](https://fanyi-api.baidu.com/)注册并开通通用翻译(标准版免费,单次 q ≤ 6000 字节);
2. 在插件「⚙ 设置」中填入 **APPID** 与 **密钥(Secret Key)**,保存。

安全设计(密钥不离开本机):

- 密钥经 **AES-256-GCM** 加密后存入宿主 dbStorage;
- 加密用主密钥是首次保存时随机生成的 32 字节值,落盘在宿主 `userData/baidu-translate.key`,与密文分离存放;
- **secretKey 只进不出**:preload 对渲染层只暴露 `{ appId, hasSecret }`,签名(MD5)与 HTTPS 请求全部在 preload(Node 侧)完成;
- 插件不向百度翻译 API 之外的任何地址发送数据。

「清除密钥」会同时删除密文与主密钥文件。

词典卡片需在开放平台控制台免费开通「词典资源」后才会返回数据,未开通时仅显示译文。

## 开发

```bash
npm install
npm run dev # 浏览器调试(无 preload,自动走 mock:假翻译 + localStorage 存密钥)
npm run build # 产物输出到 src-ztools/dist
```

目录:

```
src/ 渲染层(Vue 3 + TS)
App.vue 翻译主视图
components/SettingsPanel.vue 密钥设置
api.ts 宿主/preload 封装 + 浏览器 mock
baidu.ts 语言表、错误码映射
src-ztools/
plugin.json 插件清单(feature: baidu-translate,关键词:百度翻译/翻译/fy…)
preload/services.js 密钥加密存取 + 百度 API 请求(Node 侧)
logo.png
scripts/make-logo.cjs logo 生成脚本(零依赖 PNG 绘制)
```

## 常见错误码

报错卡片会给出中文提示,对应百度 `error_code`:52003 APPID 无效、54001 签名错误(核对密钥)、54003/54005 频率受限、54004 余额不足、58001 语言方向不支持、58003 超过 6000 字节。

## 作者

yhx
12 changes: 12 additions & 0 deletions plugins/baidu-translate/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>百度翻译</title>
</head>
<body>
<div id="app"></div>
<script type="module" src="/src/main.ts"></script>
</body>
</html>
Loading
Loading