@goodandready/dsh-russian-lang 0.2.20 → 0.2.22

package/lib/translator.js

@@ -0,0 +1,303 @@
+import { execFile } from 'node:child_process'
+
+/**
+ * Host-side translation services & LibreTranslate integration
+ * for @goodandready/dsh-russian-lang.
+ */
+
+function execPromise(cmd, args, timeoutMs = 15000) {
+  return new Promise((resolve, reject) => {
+    execFile(cmd, args, { timeout: timeoutMs }, (err, stdout, stderr) => {
+      if (err) return reject(new Error(stderr?.trim() || err.message))
+      resolve(stdout?.trim() || '')
+    })
+  })
+}
+
+function readJsonBody(request, limit = 500_000) {
+  return new Promise((resolve, reject) => {
+    let body = ''
+    request.on('data', (chunk) => {
+      body += chunk
+      if (body.length > limit) {
+        reject(new Error('Payload too large'))
+      }
+    })
+    request.on('end', () => {
+      try {
+        resolve(body ? JSON.parse(body) : {})
+      } catch (err) {
+        reject(err)
+      }
+    })
+    request.on('error', reject)
+  })
+}
+
+export async function getTranslatorStatus(settingsCtx) {
+  const currentSettings = settingsCtx?.settings?.get('russian-lang') || {}
+  const engine = currentSettings.translateEngine || 'off'
+  const localUrl = (currentSettings.localApiUrl || 'http://127.0.0.1:5000').replace(/\/+$/, '')
+
+  let dockerAvailable = false
+  let installed = false
+  let running = false
+  let responsive = false
+
+  try {
+    const statusOut = await execPromise('docker', [
+      'ps', '-a', '--filter', 'name=^libretranslate$', '--format', '{{.Status}}'
+    ], 3000)
+    dockerAvailable = true
+    if (statusOut) {
+      installed = true
+      running = statusOut.toLowerCase().startsWith('up')
+    }
+  } catch (_) {
+    dockerAvailable = false
+  }
+
+  // Ping HTTP endpoint if running or local
+  try {
+    const res = await fetch(`${localUrl}/languages`, { signal: AbortSignal.timeout(1500) })
+    if (res.ok) responsive = true
+  } catch (_) {}
+
+  return {
+    engine,
+    localUrl,
+    dockerAvailable,
+    installed,
+    running,
+    responsive,
+    memory: '~500–700 МБ RAM',
+    recommended: 'libretranslate (CTranslate2 / int8)'
+  }
+}
+
+export async function setupLibreTranslateContainer() {
+  // Check if container exists
+  try {
+    const nameOut = await execPromise('docker', [
+      'ps', '-a', '--filter', 'name=^libretranslate$', '--format', '{{.Names}}'
+    ], 3000)
+    if (nameOut && nameOut.trim() === 'libretranslate') {
+      // Start stopped container
+      await execPromise('docker', ['start', 'libretranslate'], 10000)
+      return { ok: true, action: 'started', message: 'Контейнер libretranslate запущен.' }
+    }
+  } catch (err) {
+    throw new Error('Docker недоступен или нет прав на выполнение: ' + err.message)
+  }
+
+  // Run new container
+  try {
+    await execPromise('docker', [
+      'run', '-d',
+      '--name', 'libretranslate',
+      '--restart', 'unless-stopped',
+      '-p', '127.0.0.1:5000:5000',
+      'libretranslate/libretranslate',
+      '--load-only', 'en,ru,zh'
+    ], 30000)
+    return { ok: true, action: 'created', message: 'Контейнер libretranslate создан и запускается (~600 МБ RAM).' }
+  } catch (err) {
+    throw new Error('Ошибка запуска контейнера libretranslate: ' + err.message)
+  }
+}
+
+async function translateGoogle(text, targetLang = 'ru') {
+  const parts = text.split(/(```[\s\S]*?```)/g)
+  const resultParts = []
+  for (let i = 0; i < parts.length; i++) {
+    if (i % 2 === 1) {
+      resultParts.push(parts[i])
+      continue
+    }
+    const chunk = parts[i]
+    if (!chunk.trim()) {
+      resultParts.push(chunk)
+      continue
+    }
+    const paragraphs = chunk.split(/\n\n+/)
+    const transParas = []
+    for (const para of paragraphs) {
+      const pTrim = para.trim()
+      if (!pTrim) continue
+      const sentences = pTrim.match(/[^.!?\n]+[.!?\n]*/g) || [pTrim]
+      const transSents = []
+      for (const s of sentences) {
+        if (!s.trim()) continue
+        const gurl = 'https://translate.googleapis.com/translate_a/single?client=gtx&sl=auto&tl=' + encodeURIComponent(targetLang) + '&dt=t&q=' + encodeURIComponent(s)
+        try {
+          const res = await fetch(gurl, { signal: AbortSignal.timeout(6000) })
+          if (res.ok) {
+            const data = await res.json()
+            if (Array.isArray(data) && Array.isArray(data[0])) {
+              transSents.push(data[0].map((it) => it[0]).join(''))
+              continue
+            }
+          }
+        } catch (_) {}
+        transSents.push(s)
+      }
+      transParas.push(transSents.join(''))
+    }
+    resultParts.push(transParas.join('\n\n'))
+  }
+  return resultParts.join('')
+}
+
+async function translateLibre(text, targetLang = 'ru', localUrl = 'http://127.0.0.1:5000') {
+  const endpoint = localUrl.replace(/\/+$/, '') + '/translate'
+  const res = await fetch(endpoint, {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({
+      q: text,
+      source: 'auto',
+      target: targetLang,
+      format: 'text'
+    }),
+    signal: AbortSignal.timeout(15000)
+  })
+  if (!res.ok) {
+    const errText = await res.text().catch(() => '')
+    throw new Error(`LibreTranslate HTTP ${res.status}: ${errText}`)
+  }
+  const data = await res.json()
+  return data.translatedText || text
+}
+
+export function registerTranslator(wctx, settingsCtx) {
+  let ws = null
+  try { ws = wctx?.webServer } catch (_) { ws = null }
+  if (!ws || typeof ws.register !== 'function') return () => {}
+
+  const unregs = []
+
+  // 1. Status endpoint: GET /api/dsh-russian-lang/translator/status
+  unregs.push(
+    ws.register({
+      kind: 'exact',
+      path: '/api/dsh-russian-lang/translator/status',
+      handler: async (request, response) => {
+        try {
+          if (request.method !== 'GET') {
+            response.writeHead(405, { 'content-type': 'application/json' })
+            response.end(JSON.stringify({ error: 'Method not allowed' }))
+            return
+          }
+          const status = await getTranslatorStatus(settingsCtx)
+          response.writeHead(200, {
+            'content-type': 'application/json; charset=utf-8',
+            'cache-control': 'no-store'
+          })
+          response.end(JSON.stringify(status))
+        } catch (err) {
+          response.writeHead(500, { 'content-type': 'application/json; charset=utf-8' })
+          response.end(JSON.stringify({ error: String(err) }))
+        }
+      }
+    })
+  )
+
+  // 2. Setup endpoint: POST /api/dsh-russian-lang/translator/setup
+  unregs.push(
+    ws.register({
+      kind: 'exact',
+      path: '/api/dsh-russian-lang/translator/setup',
+      handler: async (request, response) => {
+        try {
+          if (request.method !== 'POST') {
+            response.writeHead(405, { 'content-type': 'application/json' })
+            response.end(JSON.stringify({ error: 'Method not allowed' }))
+            return
+          }
+          const result = await setupLibreTranslateContainer()
+          response.writeHead(200, {
+            'content-type': 'application/json; charset=utf-8',
+            'cache-control': 'no-store'
+          })
+          response.end(JSON.stringify(result))
+        } catch (err) {
+          response.writeHead(500, { 'content-type': 'application/json; charset=utf-8' })
+          response.end(JSON.stringify({ error: String(err) }))
+        }
+      }
+    })
+  )
+
+  // 3. Translation gateway: POST /api/dsh-russian-lang/translate
+  unregs.push(
+    ws.register({
+      kind: 'exact',
+      path: '/api/dsh-russian-lang/translate',
+      handler: async (request, response) => {
+        try {
+          if (request.method !== 'POST') {
+            response.writeHead(405, { 'content-type': 'application/json' })
+            response.end(JSON.stringify({ error: 'Method not allowed' }))
+            return
+          }
+
+          const body = await readJsonBody(request)
+          const text = body.text
+          const target = body.target || 'ru'
+
+          if (!text || typeof text !== 'string') {
+            response.writeHead(400, { 'content-type': 'application/json; charset=utf-8' })
+            response.end(JSON.stringify({ error: 'Параметр "text" обязателен для перевода.' }))
+            return
+          }
+
+          const settings = settingsCtx?.settings?.get('russian-lang') || {}
+          const engine = settings.translateEngine || 'off'
+          const localUrl = settings.localApiUrl || 'http://127.0.0.1:5000'
+
+          if (engine === 'off') {
+            response.writeHead(403, { 'content-type': 'application/json; charset=utf-8' })
+            response.end(JSON.stringify({
+              error: 'Машинный перевод отключен в настройках плагина. Включите локальный сервер (LibreTranslate) или Google Translate в настройках dsh-russian-lang.'
+            }))
+            return
+          }
+
+          let translatedText = ''
+          if (engine === 'local') {
+            try {
+              translatedText = await translateLibre(text, target, localUrl)
+            } catch (err) {
+              response.writeHead(503, { 'content-type': 'application/json; charset=utf-8' })
+              response.end(JSON.stringify({
+                error: 'Локальный переводчик LibreTranslate недоступен (' + err.message + '). Проверьте состояние контейнера в настройках плагина.'
+              }))
+              return
+            }
+          } else if (engine === 'google') {
+            translatedText = await translateGoogle(text, target)
+          } else {
+            response.writeHead(400, { 'content-type': 'application/json; charset=utf-8' })
+            response.end(JSON.stringify({ error: 'Неизвестный движок перевода: ' + engine }))
+            return
+          }
+
+          response.writeHead(200, {
+            'content-type': 'application/json; charset=utf-8',
+            'cache-control': 'no-store'
+          })
+          response.end(JSON.stringify({ translatedText, engine }))
+        } catch (err) {
+          response.writeHead(500, { 'content-type': 'application/json; charset=utf-8' })
+          response.end(JSON.stringify({ error: String(err) }))
+        }
+      }
+    })
+  )
+
+  return () => {
+    for (const unreg of unregs) {
+      try { unreg() } catch (_) {}
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-russian-lang",
-  "version": "0.2.20",
+  "version": "0.2.22",
   "description": "Russian localization for DeepSeek Harness (DSH v0.1.6-alpha.1+) web UI: adds Русский as native language option. 100.0% coverage across 11,295 keys (127 namespaces). Features full DSH v0.1.6-alpha.1 core support (terminal, archive, command palette, Auto review, trajectory, PTC/Creator presets) and complete GoodAndReady plugin catalog (subscriptions, tts, image-gen, voice, key-limits, notify, commandcode, plugin-console).",
   "type": "module",
   "main": "lib/index.js",
@@ -15,7 +15,6 @@
     "cordis.patch.yml",
     "README.md",
     "README.ru.md",
-    "README.zh.md",
     "LICENSE"
   ],
   "dsh": {

package/README.zh.md

@@ -1,102 +0,0 @@
-# 📦 @goodandready/dsh-russian-lang
-
-<div align="center">
-
-<h3>DeepSeek Harness 完整俄语本地化、智能排版与键盘布局自动修复插件</h3>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/@goodandready/dsh-russian-lang"><img src="https://img.shields.io/badge/npm-v0.2.20-6366f1.svg?style=for-the-badge&labelColor=1e1b4b" alt="npm version"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-10b981.svg?style=for-the-badge&color=10b981&labelColor=064e3b" alt="license"></a>
-  <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/DSH-Plugin-8b5cf6.svg?style=for-the-badge&labelColor=2e1065" alt="DSH Plugin"></a>
-  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node-20%2B-f59e0b.svg?style=for-the-badge&labelColor=451a03" alt="Node version"></a>
-</p>
-
-<p align="center">
-  <img src="https://img.shields.io/badge/DSH-v0.1.5--rc.2%2B-blue.svg?style=for-the-badge&labelColor=1e1b4b" alt="DSH v0.1.6-alpha.1+">
-  <img src="https://img.shields.io/badge/覆盖率-100%25-10b981.svg?style=for-the-badge&labelColor=064e3b" alt="覆盖率 100%">
-  <img src="https://img.shields.io/badge/UI词条-11295-6366f1.svg?style=for-the-badge&labelColor=1e1b4b" alt="11295 词条">
-  <img src="https://img.shields.io/badge/人工校验-100%25-0ea5e9.svg?style=for-the-badge&labelColor=082f49" alt="100% 人工校验">
-</p>
-
-<p align="center">
-  <a href="https://goodandready.app/"><img src="https://img.shields.io/badge/作者所有项目-goodandready.app-ff4500.svg?style=for-the-badge&logo=rocket&logoColor=white&labelColor=1a1a2e" alt="作者所有项目"></a>
-</p>
-
-<table align="center">
-  <tr>
-    <td align="center">
-      ⭐ <strong>如果您喜欢这个插件，请在 GitHub 上点个 Star</strong> —— 这能让我知道该插件对您有所帮助，并激励我持续维护和演进。
-      <br><br>
-      🐛 <strong>如果您发现了 Bug 或有任何建议</strong>，欢迎随时在 GitHub 提交 Issue（支持中文、俄文或英文）。
-    </td>
-  </tr>
-</table>
-
-</div>
-
----
-
-## ⚡ 概述
-
-**`dsh-russian-lang`** 是面向 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) Web 界面的全功能俄语本地化增强插件。
-
-本插件不仅覆盖 DSH 核心及社区 70+ 个主流扩展插件的俄语翻译，更针对俄语用户深度定制了智能化人机交互特性：**100% 专家人工审校的技术术语**、**俄语复数语法形式（Plural）**、**屏幕排版自动规范化**（书名号《》、长破折号、不换行空格），以及通过快捷键 <kbd>Alt+L</kbd> 实现的**错误键盘布局文本一键纠正**。
-
----
-
-## ✨ 核心特性
-
-### 1. 🌐 100% 覆盖 DSH 核心 (45+ 命名空间，1780+ 词条)
-完全覆盖终端、会话归档、命令面板、工作区、右侧边栏、模型设置等所有 DSH 原生功能模块。
-
-### 2. 🧩 内置 70+ 社区插件模块化翻译 (9500+ 词条)
-采用按需模块化分发架构（单文件 < 50 KiB），包含市场、看板、定时任务、语音 TTS、模型限额、会话控制等全部热门扩展插件。
-
-### 3. 🔢 俄语复数语法精确匹配 (Plural)
-自动计算俄语特有的数词变格规则（`one`、`few`、`many`），彻底避免机械英汉翻译中的语法违和感。
-
-### 4. ✍️ 智能输入排版增强 (`russian-lang.typography`)
-在输入和渲染时规范排版格式，智能识别单字母连词并在其后插入不换行空格，且绝对保留 Markdown 代码块和行内代码语法不变。
-
-### 5. ⌨️ 误打布局实时纠正 (<kbd>Alt+L</kbd>)
-实时检测英俄误打输入（例如错输入 `ghbdtn` 自动识别为 `привет`），按快捷键即可就地无缝纠正。
-
-### 6. ⚙️ 自定义键值覆写 (`russian-lang.overrides`)
-支持在 **设置 → 插件 → 俄语本地化** 中自定义特定术语翻译，无需修改任何源代码。
-
-### 7. 🔤 DSH 原生架构集成
-原生注册至 **设置 → 通用 → 语言** 菜单，无缝切换 `<html lang="ru-RU">` 并自动激活浏览器拼写检查。
-
----
-
-## 📦 安装方法
-
-在终端运行以下命令：
-
-```bash
-dsh plugin --profile web add @goodandready/dsh-russian-lang
-```
-
-安装完成后，打开 DSH 网页端，前往 **设置 (Settings) → 通用 (General) → 语言 (Language)**，选择 **«Русский»** 即可。
-
----
-
-## ⚙️ 配置说明 (`settings.yaml`)
-
-配置命名空间为 `russian-lang`，所有选项均为可选字段：
-
-```yaml
-russian-lang:
-  enabled: true          # 启用俄语界面
-  typography:
-    enabled: true        # 启用智能排版（引号、破折号、不换行空格）
-    yo: false            # 自动还原字母 «ё»（默认关闭）
-  agentPrompt: false     # 提示智能体优先使用俄语回复
-  overrides: {}          # 针对任意词条的自定义翻译映射
-```
-
----
-
-## 📄 开源许可
-
-MIT License © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)