dsh-cait 1.0.3 → 1.0.4

package/icon.svg

@@ -1,8 +1,8 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" fill="none" role="img" aria-label="CAIT">
-  <title>CAIT</title>
-  <path d="M6.3 5.8H15.2C17 5.8 18.4 7.2 18.4 9V14.8C18.4 16.6 17 18 15.2 18H9.3L5.9 21.6V18H6.3C4.5 18 3.1 16.6 3.1 14.8V9C3.1 7.2 4.5 5.8 6.3 5.8Z" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/>
-  <path d="M5.4 16.4 9.2 8.5 13 16.4M6.8 13.4h4.8" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"/>
-  <path d="M17.4 14.2H27.4C29 14.2 30.2 15.4 30.2 17V22.2C30.2 23.8 29 25 27.4 25H27.2L27 28.8 23.2 25H17.4C15.8 25 14.6 23.8 14.6 22.2V17C14.6 15.4 15.8 14.2 17.4 14.2Z" fill="var(--dsw-alias-bg-base, #ffffff)" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/>
-  <circle cx="23" cy="17.2" r="1.4" fill="currentColor"/>
-  <path d="M18.6 20.6H27.4M23 20.6l-4.2 4.2M23 20.6l4.2 4.2" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
-</svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" fill="none" role="img" aria-label="CAIT">
+  <title>CAIT</title>
+  <path d="M6.3 5.8H15.2C17 5.8 18.4 7.2 18.4 9V14.8C18.4 16.6 17 18 15.2 18H9.3L5.9 21.6V18H6.3C4.5 18 3.1 16.6 3.1 14.8V9C3.1 7.2 4.5 5.8 6.3 5.8Z" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M5.4 16.4 9.2 8.5 13 16.4M6.8 13.4h4.8" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M17.4 14.2H27.4C29 14.2 30.2 15.4 30.2 17V22.2C30.2 23.8 29 25 27.4 25H27.2L27 28.8 23.2 25H17.4C15.8 25 14.6 23.8 14.6 22.2V17C14.6 15.4 15.8 14.2 17.4 14.2Z" fill="var(--dsw-alias-bg-base, #ffffff)" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/>
+  <circle cx="23" cy="17.2" r="1.4" fill="currentColor"/>
+  <path d="M18.6 20.6H27.4M23 20.6l-4.2 4.2M23 20.6l4.2 4.2" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/index.js

@@ -1,45 +1,45 @@
-import { homedir } from 'node:os'
-import path from 'node:path'
-import Schema from '@deepseek-ai/schemastery'
-import { CatStore } from './lib/store.js'
-import { registerCatTools } from './lib/tools.js'
-import { registerCatApi } from './lib/api.js'
-import { createMtRuntime } from './lib/mt.js'
-
-export const name = 'dsh-cait'
-
-// Cordis has no optional injection: every entry in this array is a required
-// service. CAIT targets the Web/Desktop composition, where all three exist.
-export const inject = ['tools', 'webServer', 'connection']
-
-export const Config = Schema.object({
-  dataDir: Schema.string()
-    .default('')
-    .description(
-      'CAIT 数据目录。留空时使用 DSH 用户数据目录下的 cait 子目录（$DSH_HOME/cait）。支持绝对路径、相对路径和 ~。',
-    ),
-})
-
-function expandHome(value) {
-  if (value === '~') return homedir()
-  if (value.startsWith('~/') || value.startsWith('~\\')) return path.join(homedir(), value.slice(2))
-  return value
-}
-
-export function resolveDataDir(configured) {
-  const custom = String(configured ?? '').trim()
-  if (custom) return path.resolve(expandHome(custom))
-
-  const dshHome = String(process.env.DSH_HOME ?? '').trim()
-  return path.join(path.resolve(dshHome || path.join(homedir(), '.dsh')), 'cait')
-}
-
-export function apply(ctx, config = {}) {
-  const store = new CatStore({
-    dataDir: resolveDataDir(config?.dataDir),
-    mtRuntime: createMtRuntime(ctx),
-  })
-
-  ctx.effect(() => registerCatTools(ctx, store))
-  ctx.effect(() => registerCatApi(ctx, store))
-}
+import { homedir } from 'node:os'
+import path from 'node:path'
+import Schema from '@deepseek-ai/schemastery'
+import { CatStore } from './lib/store.js'
+import { registerCatTools } from './lib/tools.js'
+import { registerCatApi } from './lib/api.js'
+import { createMtRuntime } from './lib/mt.js'
+
+export const name = 'dsh-cait'
+
+// Cordis has no optional injection: every entry in this array is a required
+// service. CAIT targets the Web/Desktop composition, where all three exist.
+export const inject = ['tools', 'webServer', 'connection']
+
+export const Config = Schema.object({
+  dataDir: Schema.string()
+    .default('')
+    .description(
+      'CAIT 数据目录。留空时使用 DSH 用户数据目录下的 cait 子目录（$DSH_HOME/cait）。支持绝对路径、相对路径和 ~。',
+    ),
+})
+
+function expandHome(value) {
+  if (value === '~') return homedir()
+  if (value.startsWith('~/') || value.startsWith('~\\')) return path.join(homedir(), value.slice(2))
+  return value
+}
+
+export function resolveDataDir(configured) {
+  const custom = String(configured ?? '').trim()
+  if (custom) return path.resolve(expandHome(custom))
+
+  const dshHome = String(process.env.DSH_HOME ?? '').trim()
+  return path.join(path.resolve(dshHome || path.join(homedir(), '.dsh')), 'cait')
+}
+
+export function apply(ctx, config = {}) {
+  const store = new CatStore({
+    dataDir: resolveDataDir(config?.dataDir),
+    mtRuntime: createMtRuntime(ctx),
+  })
+
+  ctx.effect(() => registerCatTools(ctx, store))
+  ctx.effect(() => registerCatApi(ctx, store))
+}

package/lib/api.js

@@ -1,223 +1,223 @@
-import { CatError } from './store.js'
-import { CAIT_VERSION } from './store-utils.js'
-
-const API_PREFIX = '/cait/api'
-const MAX_BODY = 32 * 1024 * 1024
-
-const MUTATIONS = new Set([
-  'createDocument',
-  'deleteDocument',
-  'openDocument',
-  'closeDocument',
-  'importFile',
-  'importTmx',
-  'loadDemo',
-  'selectSegment',
-  'saveDraft',
-  'confirmSegment',
-  'moveSegment',
-  'addTM',
-  'importTM',
-  'clearTM',
-  'addGlossary',
-  'updateGlossary',
-  'deleteGlossary',
-  'importGlossary',
-  'clearGlossary',
-  'createLibrary',
-  'setMounts',
-  'saveSettings',
-])
-
-function sendJson(res, status, payload) {
-  if (res.headersSent) return
-  const body = JSON.stringify(payload)
-  res.writeHead(status, {
-    'Content-Type': 'application/json; charset=utf-8',
-    'Content-Length': Buffer.byteLength(body),
-    'Cache-Control': 'no-store',
-    'X-Content-Type-Options': 'nosniff',
-  })
-  res.end(body)
-}
-
-function readBody(req) {
-  return new Promise((resolve, reject) => {
-    const chunks = []
-    let size = 0
-    let settled = false
-
-    const fail = (error) => {
-      if (settled) return
-      settled = true
-      req.removeListener('data', onData)
-      req.removeListener('end', onEnd)
-      req.removeListener('error', onError)
-      req.resume()
-      reject(error)
-    }
-
-    const onData = (chunk) => {
-      size += chunk.length
-      if (size > MAX_BODY) {
-        fail(new CatError('BODY_TOO_LARGE', '请求体过大。', 413))
-        return
-      }
-      chunks.push(chunk)
-    }
-    const onEnd = () => {
-      if (settled) return
-      settled = true
-      resolve(Buffer.concat(chunks).toString('utf8'))
-    }
-    const onError = (error) => {
-      if (settled) return
-      settled = true
-      reject(error)
-    }
-
-    req.on('data', onData)
-    req.on('end', onEnd)
-    req.on('error', onError)
-  })
-}
-
-function confirmDangerous(fn) {
-  return (params) => {
-    if (params?.confirm !== true) {
-      throw new CatError('CONFIRMATION_REQUIRED', '该操作需要二次确认。', 409)
-    }
-    return fn(params)
-  }
-}
-
-function createHandlers(store) {
-  return {
-    bootstrap: () => store.bootstrap(),
-    listMtRoutes: (params) => store.listMtRoutes(params),
-    createDocument: (params) => store.createDocument(params),
-    deleteDocument: (params) => store.deleteDocument(params),
-    openDocument: (params) => store.openDocument(params),
-    closeDocument: (params) => store.closeDocument(params),
-    importFile: (params) => store.importFile(params),
-    importTmx: (params) => store.importTmx(params),
-    loadDemo: () => store.loadDemo(),
-    selectSegment: (params) => store.selectSegment(params),
-    saveDraft: (params) => store.saveDraft(params),
-    confirmSegment: (params) => store.confirmSegment(params),
-    moveSegment: (params) => store.moveSegment(params),
-
-    lookupTM: (params) => {
-      const result = store.lookupTM(params)
-      return { ...result, count: result.matches.length }
-    },
-    addTM: (params) => store.addTM(params),
-    importTM: (params) => store.importTM(params),
-    clearTM: confirmDangerous((params) => store.clearTM(params)),
-
-    addGlossary: (params) => store.addGlossary(params),
-    updateGlossary: (params) => store.updateGlossary(params),
-    deleteGlossary: (params) => store.deleteGlossary(params),
-    importGlossary: (params) => store.importGlossary(params),
-    clearGlossary: confirmDangerous((params) => store.clearGlossary(params)),
-
-    createLibrary: (params) => store.createLibrary(params),
-    setMounts: (params) => store.setMounts(params),
-    saveSettings: (params) => store.saveSettings(params),
-    mtSuggest: (params) => store.mtSuggest(params),
-    exportDocument: (params) => {
-      const result = store.exportDocument(params)
-      if (result && Buffer.isBuffer(result.content)) {
-        return { ...result, content: result.content.toString('base64'), encoding: 'base64' }
-      }
-      return result
-    },
-  }
-}
-
-export function registerCatApi(ctx, store) {
-  let webServer
-  let connection
-  try {
-    webServer = ctx.webServer
-    connection = ctx.connection
-  } catch {
-    return () => {}
-  }
-  if (!webServer || !connection) return () => {}
-
-  const handlers = createHandlers(store)
-
-  const handler = async (req, res) => {
-    try {
-      const rejection = connection.requestRejection(req)
-      if (rejection) {
-        sendJson(res, rejection, {
-          ok: false,
-          error: { code: 'UNAUTHORIZED', message: 'CAIT API 仅接受本机同源请求。' },
-        })
-        return
-      }
-
-      const url = new URL(req.url || '/', 'http://cait.local')
-      if (url.pathname === `${API_PREFIX}/health`) {
-        if (req.method !== 'GET') {
-          sendJson(res, 405, { ok: false, error: { code: 'METHOD_NOT_ALLOWED', message: '只支持 GET。' } })
-          return
-        }
-        sendJson(res, 200, { ok: true, data: { name: 'cait', version: CAIT_VERSION } })
-        return
-      }
-
-      if (url.pathname !== `${API_PREFIX}/rpc`) {
-        sendJson(res, 404, { ok: false, error: { code: 'NOT_FOUND', message: '接口不存在。' } })
-        return
-      }
-
-      if (req.method !== 'POST') {
-        sendJson(res, 405, { ok: false, error: { code: 'METHOD_NOT_ALLOWED', message: '只支持 POST。' } })
-        return
-      }
-      if (!String(req.headers['content-type'] || '').toLowerCase().includes('application/json')) {
-        sendJson(res, 415, { ok: false, error: { code: 'UNSUPPORTED_MEDIA_TYPE', message: '请求必须为 JSON。' } })
-        return
-      }
-
-      const raw = await readBody(req)
-      let payload
-      try {
-        payload = JSON.parse(raw || '{}')
-      } catch {
-        throw new CatError('INVALID_JSON', '请求 JSON 解析失败。')
-      }
-
-      const method = String(payload?.method ?? '')
-      if (!Object.hasOwn(handlers, method)) {
-        throw new CatError('UNKNOWN_METHOD', `未知的 CAIT 方法: ${method || '(empty)'}`, 404)
-      }
-
-      const params = payload.params && typeof payload.params === 'object' ? payload.params : {}
-      const result = await handlers[method](params)
-      const data = MUTATIONS.has(method)
-        ? { ...(result ?? {}), state: store.bootstrap() }
-        : result
-      sendJson(res, 200, { ok: true, data })
-    } catch (error) {
-      const status = error instanceof CatError ? error.status : 500
-      const code = error instanceof CatError ? error.code : 'INTERNAL_ERROR'
-      const message = error instanceof CatError
-        ? error.message
-        : 'CAIT 服务发生内部错误。'
-      if (!(error instanceof CatError)) {
-        try {
-          ctx.logger?.('cait')?.error?.(error)
-        } catch {
-          // logging must never mask the response
-        }
-      }
-      sendJson(res, status, { ok: false, error: { code, message } })
-    }
-  }
-
-  return webServer.register({ kind: 'prefix', path: API_PREFIX, handler })
-}
+import { CatError } from './store.js'
+import { CAIT_VERSION } from './store-utils.js'
+
+const API_PREFIX = '/cait/api'
+const MAX_BODY = 32 * 1024 * 1024
+
+const MUTATIONS = new Set([
+  'createDocument',
+  'deleteDocument',
+  'openDocument',
+  'closeDocument',
+  'importFile',
+  'importTmx',
+  'loadDemo',
+  'selectSegment',
+  'saveDraft',
+  'confirmSegment',
+  'moveSegment',
+  'addTM',
+  'importTM',
+  'clearTM',
+  'addGlossary',
+  'updateGlossary',
+  'deleteGlossary',
+  'importGlossary',
+  'clearGlossary',
+  'createLibrary',
+  'setMounts',
+  'saveSettings',
+])
+
+function sendJson(res, status, payload) {
+  if (res.headersSent) return
+  const body = JSON.stringify(payload)
+  res.writeHead(status, {
+    'Content-Type': 'application/json; charset=utf-8',
+    'Content-Length': Buffer.byteLength(body),
+    'Cache-Control': 'no-store',
+    'X-Content-Type-Options': 'nosniff',
+  })
+  res.end(body)
+}
+
+function readBody(req) {
+  return new Promise((resolve, reject) => {
+    const chunks = []
+    let size = 0
+    let settled = false
+
+    const fail = (error) => {
+      if (settled) return
+      settled = true
+      req.removeListener('data', onData)
+      req.removeListener('end', onEnd)
+      req.removeListener('error', onError)
+      req.resume()
+      reject(error)
+    }
+
+    const onData = (chunk) => {
+      size += chunk.length
+      if (size > MAX_BODY) {
+        fail(new CatError('BODY_TOO_LARGE', '请求体过大。', 413))
+        return
+      }
+      chunks.push(chunk)
+    }
+    const onEnd = () => {
+      if (settled) return
+      settled = true
+      resolve(Buffer.concat(chunks).toString('utf8'))
+    }
+    const onError = (error) => {
+      if (settled) return
+      settled = true
+      reject(error)
+    }
+
+    req.on('data', onData)
+    req.on('end', onEnd)
+    req.on('error', onError)
+  })
+}
+
+function confirmDangerous(fn) {
+  return (params) => {
+    if (params?.confirm !== true) {
+      throw new CatError('CONFIRMATION_REQUIRED', '该操作需要二次确认。', 409)
+    }
+    return fn(params)
+  }
+}
+
+function createHandlers(store) {
+  return {
+    bootstrap: () => store.bootstrap(),
+    listMtRoutes: (params) => store.listMtRoutes(params),
+    createDocument: (params) => store.createDocument(params),
+    deleteDocument: (params) => store.deleteDocument(params),
+    openDocument: (params) => store.openDocument(params),
+    closeDocument: (params) => store.closeDocument(params),
+    importFile: (params) => store.importFile(params),
+    importTmx: (params) => store.importTmx(params),
+    loadDemo: () => store.loadDemo(),
+    selectSegment: (params) => store.selectSegment(params),
+    saveDraft: (params) => store.saveDraft(params),
+    confirmSegment: (params) => store.confirmSegment(params),
+    moveSegment: (params) => store.moveSegment(params),
+
+    lookupTM: (params) => {
+      const result = store.lookupTM(params)
+      return { ...result, count: result.matches.length }
+    },
+    addTM: (params) => store.addTM(params),
+    importTM: (params) => store.importTM(params),
+    clearTM: confirmDangerous((params) => store.clearTM(params)),
+
+    addGlossary: (params) => store.addGlossary(params),
+    updateGlossary: (params) => store.updateGlossary(params),
+    deleteGlossary: (params) => store.deleteGlossary(params),
+    importGlossary: (params) => store.importGlossary(params),
+    clearGlossary: confirmDangerous((params) => store.clearGlossary(params)),
+
+    createLibrary: (params) => store.createLibrary(params),
+    setMounts: (params) => store.setMounts(params),
+    saveSettings: (params) => store.saveSettings(params),
+    mtSuggest: (params) => store.mtSuggest(params),
+    exportDocument: (params) => {
+      const result = store.exportDocument(params)
+      if (result && Buffer.isBuffer(result.content)) {
+        return { ...result, content: result.content.toString('base64'), encoding: 'base64' }
+      }
+      return result
+    },
+  }
+}
+
+export function registerCatApi(ctx, store) {
+  let webServer
+  let connection
+  try {
+    webServer = ctx.webServer
+    connection = ctx.connection
+  } catch {
+    return () => {}
+  }
+  if (!webServer || !connection) return () => {}
+
+  const handlers = createHandlers(store)
+
+  const handler = async (req, res) => {
+    try {
+      const rejection = connection.requestRejection(req)
+      if (rejection) {
+        sendJson(res, rejection, {
+          ok: false,
+          error: { code: 'UNAUTHORIZED', message: 'CAIT API 仅接受本机同源请求。' },
+        })
+        return
+      }
+
+      const url = new URL(req.url || '/', 'http://cait.local')
+      if (url.pathname === `${API_PREFIX}/health`) {
+        if (req.method !== 'GET') {
+          sendJson(res, 405, { ok: false, error: { code: 'METHOD_NOT_ALLOWED', message: '只支持 GET。' } })
+          return
+        }
+        sendJson(res, 200, { ok: true, data: { name: 'cait', version: CAIT_VERSION } })
+        return
+      }
+
+      if (url.pathname !== `${API_PREFIX}/rpc`) {
+        sendJson(res, 404, { ok: false, error: { code: 'NOT_FOUND', message: '接口不存在。' } })
+        return
+      }
+
+      if (req.method !== 'POST') {
+        sendJson(res, 405, { ok: false, error: { code: 'METHOD_NOT_ALLOWED', message: '只支持 POST。' } })
+        return
+      }
+      if (!String(req.headers['content-type'] || '').toLowerCase().includes('application/json')) {
+        sendJson(res, 415, { ok: false, error: { code: 'UNSUPPORTED_MEDIA_TYPE', message: '请求必须为 JSON。' } })
+        return
+      }
+
+      const raw = await readBody(req)
+      let payload
+      try {
+        payload = JSON.parse(raw || '{}')
+      } catch {
+        throw new CatError('INVALID_JSON', '请求 JSON 解析失败。')
+      }
+
+      const method = String(payload?.method ?? '')
+      if (!Object.hasOwn(handlers, method)) {
+        throw new CatError('UNKNOWN_METHOD', `未知的 CAIT 方法: ${method || '(empty)'}`, 404)
+      }
+
+      const params = payload.params && typeof payload.params === 'object' ? payload.params : {}
+      const result = await handlers[method](params)
+      const data = MUTATIONS.has(method)
+        ? { ...(result ?? {}), state: store.bootstrap() }
+        : result
+      sendJson(res, 200, { ok: true, data })
+    } catch (error) {
+      const status = error instanceof CatError ? error.status : 500
+      const code = error instanceof CatError ? error.code : 'INTERNAL_ERROR'
+      const message = error instanceof CatError
+        ? error.message
+        : 'CAIT 服务发生内部错误。'
+      if (!(error instanceof CatError)) {
+        try {
+          ctx.logger?.('cait')?.error?.(error)
+        } catch {
+          // logging must never mask the response
+        }
+      }
+      sendJson(res, status, { ok: false, error: { code, message } })
+    }
+  }
+
+  return webServer.register({ kind: 'prefix', path: API_PREFIX, handler })
+}