@muyichengshayu/promptx 0.1.13 → 0.1.15

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.1.15
+
+- 修复右侧编辑区在输入、自动保存和后台状态刷新同时发生时，偶发被旧数据覆盖导致尾字丢失的问题；当前任务只要仍处于编辑态，就以本地输入为准。
+- 调整编辑区 block 渲染标识，改用稳定 key，减少插入图片、导入文件或删除前置 block 后的焦点跳动、光标丢失与输入状态抖动。
+- 优化编辑区滚动策略：输入过程中不再强制把内容区推到底部，长内容中间编辑时视口更稳定，只在需要时把当前输入框保持在可视区域内。
+- 新增浏览器级 E2E，覆盖编辑中防覆盖、自动保存后防覆盖、空闲后恢复同步、长内容中间输入不跳底，以及删除前置 block 后焦点与内容稳定等真实场景。
+
+## 0.1.14
+
+- 工作台、设置、项目管理、代码变更、编辑任务等核心界面补齐中英双语支持，并新增前端 `i18n` 基础设施，后续扩展语言成本更低。
+- 服务端错误返回补齐稳定的 `messageKey`，前端优先按 key 翻译；同时把 Relay 诊断、自动化通知、任务设置等动态文本一并接入 locale，减少英文界面穿透中文的问题。
+- 优化英文界面的文案长度与布局细节，收短 `Changes`、`Projects` 等标题，调整项目列表与代码变更面板在英文场景下的换行与排布表现。
+- 补齐多语言相关自动化验证：修复前端错误格式化回归，更新页面级 E2E 基座，并验证最新 turn 展开、历史执行过程加载和滚动跟随等关键流程未受影响。
+
 ## 0.1.13
 
 - 加固 Relay 登录链路：登录与管理登录改为 `POST`，并新增登录限流，降低暴力尝试与口令暴露风险。

package/README.en.md

@@ -60,15 +60,15 @@ promptx stop
 
 ### Workspace
 
-![PromptX workspace](docs/assets/workbench-overview.jpg)
+![PromptX workspace](docs/assets/readme-workbench-glass.png)
 
 ### Settings
 
-![PromptX settings](docs/assets/settings-panel.jpg)
+![PromptX settings](docs/assets/readme-settings-theme-glass.png)
 
 ### Mobile
 
-![PromptX mobile](docs/assets/mobile-remote.jpg)
+![PromptX mobile](docs/assets/readme-mobile-remote-glass.png)
 
 ## Why It Helps
 

package/README.md

@@ -60,15 +60,15 @@ promptx stop
 
 ### 工作台
 
-![PromptX 工作台](docs/assets/workbench-overview.jpg)
+![PromptX 工作台](docs/assets/readme-workbench-glass.png)
 
 ### 设置
 
-![PromptX 设置](docs/assets/settings-panel.jpg)
+![PromptX 设置](docs/assets/readme-settings-theme-glass.png)
 
 ### 手机端
 
-![PromptX 手机端](docs/assets/mobile-remote.jpg)
+![PromptX 手机端](docs/assets/readme-mobile-remote-glass.png)
 
 ## 为什么好用
 

package/apps/server/src/apiErrors.js

@@ -0,0 +1,29 @@
+export function createApiError(messageKey, message, statusCode = 400, extras = {}) {
+  const error = new Error(String(message || '请求失败。'))
+  error.statusCode = Math.max(400, Number(statusCode) || 400)
+  if (messageKey) {
+    error.messageKey = String(messageKey)
+  }
+  Object.assign(error, extras)
+  return error
+}
+
+export function getApiErrorPayload(error, fallback = {}) {
+  const payload = error?.payload && typeof error.payload === 'object' ? error.payload : {}
+  const messageKey = String(
+    error?.messageKey
+    || payload?.messageKey
+    || fallback.messageKey
+    || ''
+  ).trim()
+  const message = String(
+    error?.message
+    || payload?.message
+    || fallback.message
+    || '请求失败。'
+  ).trim() || '请求失败。'
+
+  return messageKey
+    ? { ...payload, messageKey, message }
+    : { ...payload, message }
+}

package/apps/server/src/assetRoutes.js

@@ -3,6 +3,7 @@ import path from 'node:path'
 import { pipeline } from 'node:stream/promises'
 import { Jimp } from 'jimp'
 import { nanoid } from 'nanoid'
+import { createApiError } from './apiErrors.js'
 
 function registerAssetRoutes(app, options = {}) {
   const {
@@ -17,10 +18,10 @@ function registerAssetRoutes(app, options = {}) {
   app.post('/api/uploads', async (request, reply) => {
     const part = await request.file()
     if (!part) {
-      return reply.code(400).send({ message: '没有收到上传文件。' })
+      return reply.code(400).send({ messageKey: 'errors.uploadFileMissing', message: '没有收到上传文件。' })
     }
     if (!String(part.mimetype || '').startsWith('image/')) {
-      return reply.code(400).send({ message: '只支持上传图片文件。' })
+      return reply.code(400).send({ messageKey: 'errors.uploadImageOnly', message: '只支持上传图片文件。' })
     }
 
     const tempPath = createTempFilePath(tmpDir, part.filename)
@@ -58,13 +59,13 @@ function registerAssetRoutes(app, options = {}) {
   app.post('/api/imports/pdf', async (request, reply) => {
     const part = await request.file()
     if (!part) {
-      return reply.code(400).send({ message: '没有收到 PDF 文件。' })
+      return reply.code(400).send({ messageKey: 'errors.pdfFileMissing', message: '没有收到 PDF 文件。' })
     }
 
     const fileName = normalizeUploadFileName(part.filename, 'task.pdf')
     const mimetype = String(part.mimetype || '').toLowerCase()
     if (mimetype !== 'application/pdf' && !fileName.toLowerCase().endsWith('.pdf')) {
-      return reply.code(400).send({ message: '只支持导入 PDF 文件。' })
+      return reply.code(400).send({ messageKey: 'errors.pdfOnly', message: '只支持导入 PDF 文件。' })
     }
 
     const tempPath = createTempFilePath(tmpDir, fileName, '.pdf')
@@ -80,7 +81,10 @@ function registerAssetRoutes(app, options = {}) {
 
       if (!imported.blocks.length) {
         removeAssetFiles(createdAssets)
-        return reply.code(422).send({ message: '没有从 PDF 中提取到可导入的文本或图片。' })
+        return reply.code(422).send({
+          messageKey: 'errors.pdfNoImportableContent',
+          message: '没有从 PDF 中提取到可导入的文本或图片。',
+        })
       }
 
       return reply.code(201).send({
@@ -90,7 +94,10 @@ function registerAssetRoutes(app, options = {}) {
       })
     } catch (error) {
       removeAssetFiles(error.createdAssets || createdAssets)
-      throw error
+      throw createApiError(error?.messageKey || '', error?.message || 'PDF 导入失败。', error?.statusCode || 500, {
+        createdAssets: error?.createdAssets || createdAssets,
+        cause: error,
+      })
     } finally {
       fs.rmSync(tempPath, { force: true })
     }

package/apps/server/src/codexRoutes.js

@@ -102,7 +102,7 @@ function registerCodexRoutes(app, options = {}) {
   app.get('/api/codex/sessions/:sessionId/files/tree', async (request, reply) => {
     const session = getPromptxCodexSessionById(request.params.sessionId)
     if (!session) {
-      return reply.code(404).send({ message: '没有找到对应的 PromptX 项目。' })
+      return reply.code(404).send({ messageKey: 'errors.sessionNotFound', message: '没有找到对应的 PromptX 项目。' })
     }
 
     return listWorkspaceTree(session.cwd, {
@@ -114,7 +114,7 @@ function registerCodexRoutes(app, options = {}) {
   app.get('/api/codex/sessions/:sessionId/files/search', async (request, reply) => {
     const session = getPromptxCodexSessionById(request.params.sessionId)
     if (!session) {
-      return reply.code(404).send({ message: '没有找到对应的 PromptX 项目。' })
+      return reply.code(404).send({ messageKey: 'errors.sessionNotFound', message: '没有找到对应的 PromptX 项目。' })
     }
 
     return searchWorkspaceEntries(session.cwd, {
@@ -134,7 +134,7 @@ function registerCodexRoutes(app, options = {}) {
   app.patch('/api/codex/sessions/:sessionId', async (request, reply) => {
     const session = updatePromptxCodexSession(request.params.sessionId, request.body || {})
     if (!session) {
-      return reply.code(404).send({ message: '没有找到对应的 PromptX 项目。' })
+      return reply.code(404).send({ messageKey: 'errors.sessionNotFound', message: '没有找到对应的 PromptX 项目。' })
     }
 
     broadcastServerEvent('sessions.changed', {
@@ -145,13 +145,16 @@ function registerCodexRoutes(app, options = {}) {
 
   app.delete('/api/codex/sessions/:sessionId', async (request, reply) => {
     if (getRunningCodexRunBySessionId(request.params.sessionId)) {
-      return reply.code(409).send({ message: '当前项目正在执行中，请先停止后再删除。' })
+      return reply.code(409).send({
+        messageKey: 'errors.currentProjectDeleteWhileRunning',
+        message: '当前项目正在执行中，请先停止后再删除。',
+      })
     }
 
     const affectedTaskSlugs = clearTaskCodexSessionReferences(request.params.sessionId)
     const session = deletePromptxCodexSession(request.params.sessionId)
     if (!session) {
-      return reply.code(404).send({ message: '没有找到对应的 PromptX 项目。' })
+      return reply.code(404).send({ messageKey: 'errors.sessionNotFound', message: '没有找到对应的 PromptX 项目。' })
     }
 
     broadcastServerEvent('sessions.changed', {
@@ -176,7 +179,7 @@ function registerCodexRoutes(app, options = {}) {
   app.post('/api/codex/runs/:runId/stop', async (request, reply) => {
     const runRecord = getCodexRunById(request.params.runId)
     if (!runRecord) {
-      return reply.code(404).send({ message: '没有找到对应的执行记录。' })
+      return reply.code(404).send({ messageKey: 'errors.runNotFound', message: '没有找到对应的执行记录。' })
     }
 
     const stopResult = await runDispatchService.requestRunStop(request.params.runId, {
@@ -199,7 +202,7 @@ function registerCodexRoutes(app, options = {}) {
   app.get('/api/codex/runs/:runId/events', async (request, reply) => {
     const runRecord = getCodexRunById(request.params.runId)
     if (!runRecord) {
-      return reply.code(404).send({ message: '没有找到对应的执行记录。' })
+      return reply.code(404).send({ messageKey: 'errors.runNotFound', message: '没有找到对应的执行记录。' })
     }
 
     return {
@@ -213,7 +216,7 @@ function registerCodexRoutes(app, options = {}) {
   app.get('/api/codex/runs/:runId/stream', async (request, reply) => {
     const runRecord = getCodexRunById(request.params.runId)
     if (!runRecord) {
-      return reply.code(404).send({ message: '没有找到对应的执行记录。' })
+      return reply.code(404).send({ messageKey: 'errors.runNotFound', message: '没有找到对应的执行记录。' })
     }
 
     reply.hijack()

package/apps/server/src/codexSessions.js

@@ -4,11 +4,10 @@ import { nanoid } from 'nanoid'
 import { normalizeAgentEngine } from '../../../packages/shared/src/index.js'
 import { all, get, run, transaction } from './db.js'
 import { assertAgentRunner } from './agents/index.js'
+import { createApiError } from './apiErrors.js'
 
 function createHttpError(message, statusCode = 400) {
-  const error = new Error(message)
-  error.statusCode = statusCode
-  return error
+  return createApiError('', message, statusCode)
 }
 
 function toCodexSession(row) {
@@ -45,7 +44,7 @@ function ensureAgentRunnerAvailable(engine) {
   try {
     assertAgentRunner(engine)
   } catch (error) {
-    throw createHttpError(error.message || '当前执行引擎不可用。')
+    throw createApiError('errors.agentEngineUnavailable', error.message || '当前执行引擎不可用。')
   }
 }
 
@@ -62,17 +61,17 @@ function normalizeTitle(input = '', cwd = '') {
 export function normalizeCwd(input = '') {
   const cwd = String(input || '').trim()
   if (!cwd) {
-    throw createHttpError('请先填写工作目录。')
+    throw createApiError('errors.cwdRequired', '请先填写工作目录。')
   }
 
   const resolved = path.resolve(cwd)
   if (!fs.existsSync(resolved)) {
-    throw createHttpError('工作目录不存在，请重新确认。')
+    throw createApiError('errors.cwdNotFound', '工作目录不存在，请重新确认。')
   }
 
   const stats = fs.statSync(resolved)
   if (!stats.isDirectory()) {
-    throw createHttpError('工作目录必须是文件夹。')
+    throw createApiError('errors.cwdMustBeDirectory', '工作目录必须是文件夹。')
   }
 
   return resolved
@@ -144,10 +143,10 @@ export function updatePromptxCodexSession(sessionId, patch = {}) {
   ensureAgentRunnerAvailable(nextEngine)
 
   if (existing.started && wantsCwd && nextCwd !== existing.cwd) {
-    throw createHttpError('已启动的 PromptX 项目不能直接修改工作目录。', 409)
+    throw createApiError('errors.startedProjectCwdLocked', '已启动的 PromptX 项目不能直接修改工作目录。', 409)
   }
   if (existing.started && wantsEngine && nextEngine !== existing.engine) {
-    throw createHttpError('已启动的 PromptX 项目不能直接切换执行引擎，请新建项目。', 409)
+    throw createApiError('errors.startedProjectEngineLocked', '已启动的 PromptX 项目不能直接切换执行引擎，请新建项目。', 409)
   }
 
   const title = Object.prototype.hasOwnProperty.call(patch, 'title')

package/apps/server/src/db.js

@@ -183,6 +183,7 @@ function migrateToV1() {
       notification_webhook_url TEXT NOT NULL DEFAULT '',
       notification_secret TEXT NOT NULL DEFAULT '',
       notification_trigger_on TEXT NOT NULL DEFAULT 'completed',
+      notification_locale TEXT NOT NULL DEFAULT 'zh-CN',
       notification_message_mode TEXT NOT NULL DEFAULT 'summary',
       notification_last_status TEXT NOT NULL DEFAULT '',
       notification_last_error TEXT NOT NULL DEFAULT '',
@@ -338,6 +339,7 @@ function applyAdditiveSchemaPatches() {
     `ALTER TABLE tasks ADD COLUMN notification_webhook_url TEXT NOT NULL DEFAULT ''`,
     `ALTER TABLE tasks ADD COLUMN notification_secret TEXT NOT NULL DEFAULT ''`,
     `ALTER TABLE tasks ADD COLUMN notification_trigger_on TEXT NOT NULL DEFAULT 'completed'`,
+    `ALTER TABLE tasks ADD COLUMN notification_locale TEXT NOT NULL DEFAULT 'zh-CN'`,
     `ALTER TABLE tasks ADD COLUMN notification_message_mode TEXT NOT NULL DEFAULT 'summary'`,
     `ALTER TABLE tasks ADD COLUMN notification_last_status TEXT NOT NULL DEFAULT ''`,
     `ALTER TABLE tasks ADD COLUMN notification_last_error TEXT NOT NULL DEFAULT ''`,

package/apps/server/src/index.js

@@ -76,7 +76,8 @@ import {
   registerInternalRunnerRoutes,
   registerRealtimeRoutes,
 } from './internalRoutes.js'
-import { registerAssetRoutes } from './assetRoutes.js'
+import { registerAssetRoutes } from './assetRoutes.js'
+import { getApiErrorPayload } from './apiErrors.js'
 import { registerWebAppRoutes } from './webAppRoutes.js'
 import { createTempFilePath, normalizeUploadFileName } from './upload.js'
 import { importPdfBlocks } from './pdf.js'
@@ -417,11 +418,13 @@ registerWebAppRoutes(app, {
   webDistDir,
 })
 
-app.setErrorHandler((error, request, reply) => {
-  request.log.error(error)
-  const message = error.statusCode === 413 ? '文件太大了。' : error.message || '发生了意外错误。'
-  reply.code(error.statusCode || 500).send({ message })
-})
+app.setErrorHandler((error, request, reply) => {
+  request.log.error(error)
+  const payload = getApiErrorPayload(error, error.statusCode === 413
+    ? { messageKey: 'errors.fileTooLarge', message: '文件太大了。' }
+    : { messageKey: 'errors.unexpectedServerError', message: error.message || '发生了意外错误。' })
+  reply.code(error.statusCode || 500).send(payload)
+})
 
 purgeExpiredContent(true)
 

package/apps/server/src/relayClient.js

@@ -33,10 +33,14 @@ function createDisabledStatus() {
     lastHeartbeatAt: '',
     lastCloseCode: 0,
     lastCloseReason: '',
+    lastCloseReasonCode: '',
     lastError: '',
+    lastErrorKey: '',
+    lastErrorParams: null,
     reconnectCount: 0,
     reconnectPaused: false,
     reconnectPausedReason: '',
+    reconnectPausedReasonCode: '',
     nextReconnectDelayMs: 0,
     recentEvents: [],
   }
@@ -244,10 +248,12 @@ function createRelayClient({
     updateStatus({
       reconnectPaused: true,
       reconnectPausedReason: reason || String(rawReason || '').trim(),
+      reconnectPausedReasonCode: String(rawReason || '').trim(),
       nextReconnectDelayMs: 0,
     })
     appendRecentEvent('reconnect_paused', {
       reason: reason || String(rawReason || '').trim() || 'unknown',
+      reasonCode: String(rawReason || '').trim() || 'unknown',
     })
     logWarn('[relay] 检测到不可重试错误，已暂停自动重连', getLogContext({
       reason: reason || String(rawReason || '').trim() || 'unknown',
@@ -408,6 +414,8 @@ function createRelayClient({
     return connect().catch((error) => {
       updateStatus({
         lastError: error?.message || 'Relay 连接失败。',
+        lastErrorKey: 'connect_failed',
+        lastErrorParams: null,
       })
       appendRecentEvent('connect_failed', {
         source,
@@ -463,8 +471,11 @@ function createRelayClient({
     updateStatus({
       reconnectPaused: false,
       reconnectPausedReason: '',
+      reconnectPausedReasonCode: '',
       nextReconnectDelayMs: 0,
       lastError: '',
+      lastErrorKey: '',
+      lastErrorParams: null,
     })
     pendingReconnectSource = source
     appendRecentEvent('reconnect_requested', {
@@ -598,6 +609,9 @@ function createRelayClient({
           lastCloseCode: 0,
           lastCloseReason: '',
           lastError: '',
+          lastCloseReasonCode: '',
+          lastErrorKey: '',
+          lastErrorParams: null,
         })
         appendRecentEvent('auth_ok', {
           tenantKey: String(message?.tenantKey || '').trim(),
@@ -651,16 +665,26 @@ function createRelayClient({
       const reconnectSource = pendingReconnectSource
       pendingReconnectSource = ''
       const { rawReason, closeReason } = parseCloseReason(reason)
+      const rawReasonCode = String(rawReason || '').trim()
       const nextError = closeReason && closeReason !== '配置已更新，正在重连'
         ? `${wasAuthenticated ? 'Relay 已断开' : 'Relay 连接被拒绝'}：${closeReason}`
         : (!wasAuthenticated && code && code !== 1000 ? `Relay 连接已关闭（code=${code}）` : '')
+      const nextErrorKey = closeReason && closeReason !== '配置已更新，正在重连'
+        ? (wasAuthenticated ? 'disconnected' : 'rejected')
+        : (!wasAuthenticated && code && code !== 1000 ? 'closed_with_code' : '')
+      const nextErrorParams = nextErrorKey === 'closed_with_code'
+        ? { code: Number(code || 0) }
+        : (nextErrorKey ? { reasonCode: rawReasonCode || closeReason || '', code: Number(code || 0) } : null)
 
       updateStatus({
         connected: false,
         lastDisconnectedAt: nowIso(),
         lastCloseCode: Number(code || 0),
         lastCloseReason: closeReason,
-        ...(nextError ? { lastError: nextError } : {}),
+        lastCloseReasonCode: rawReasonCode,
+        ...(nextError
+          ? { lastError: nextError, lastErrorKey: nextErrorKey, lastErrorParams: nextErrorParams }
+          : { lastErrorKey: '', lastErrorParams: null }),
       })
       appendRecentEvent('close', {
         code: Number(code || 0),
@@ -699,6 +723,8 @@ function createRelayClient({
       }
       updateStatus({
         lastError: error?.message || 'Relay 连接失败。',
+        lastErrorKey: 'connect_failed',
+        lastErrorParams: null,
       })
       appendRecentEvent('error', {
         error: error?.message || String(error || ''),
@@ -746,6 +772,8 @@ function createRelayClient({
       updateStatus({
         connected: false,
         nextReconnectDelayMs: 0,
+        lastErrorKey: '',
+        lastErrorParams: null,
       })
       appendRecentEvent('stopped')
       logInfo('[relay] 已停止', getLogContext())
@@ -759,8 +787,11 @@ function createRelayClient({
       syncStatusFromConfig()
       updateStatus({
         lastError: '',
+        lastErrorKey: '',
+        lastErrorParams: null,
         reconnectPaused: false,
         reconnectPausedReason: '',
+        reconnectPausedReasonCode: '',
         nextReconnectDelayMs: 0,
       })
       appendRecentEvent('config_updated', {

package/apps/server/src/repository.js

@@ -12,6 +12,7 @@ import {
   normalizeTaskAutomationConcurrencyPolicy,
   normalizeTaskAutomationTimezone,
   normalizeTaskNotificationChannel,
+  normalizeTaskNotificationLocale,
   normalizeTaskNotificationMessageMode,
   normalizeTaskNotificationTrigger,
   normalizeExpiry,
@@ -65,6 +66,7 @@ function toTask(row, blocks = [], options = {}) {
       webhookUrl: String(row.notification_webhook_url || ''),
       secret: String(row.notification_secret || ''),
       triggerOn: normalizeTaskNotificationTrigger(row.notification_trigger_on),
+      locale: normalizeTaskNotificationLocale(row.notification_locale),
       messageMode: normalizeTaskNotificationMessageMode(row.notification_message_mode),
       lastStatus: String(row.notification_last_status || ''),
       lastError: String(row.notification_last_error || ''),
@@ -90,6 +92,7 @@ function mapTaskNotificationSummary(row) {
     enabled: Boolean(Number(row.notification_enabled) || 0),
     channelType: normalizeTaskNotificationChannel(row.notification_channel_type),
     triggerOn: normalizeTaskNotificationTrigger(row.notification_trigger_on),
+    locale: normalizeTaskNotificationLocale(row.notification_locale),
     lastStatus: String(row.notification_last_status || ''),
     lastSentAt: String(row.notification_last_sent_at || ''),
   }
@@ -122,6 +125,7 @@ function normalizeNotificationInput(input = {}, fallback = {}) {
     webhookUrl: enabled ? clampText(input?.webhookUrl || '', 2000).trim() : '',
     secret: enabled ? clampText(input?.secret || '', 200).trim() : '',
     triggerOn: normalizeTaskNotificationTrigger(input?.triggerOn || fallback.triggerOn),
+    locale: normalizeTaskNotificationLocale(input?.locale || fallback.locale),
     messageMode: normalizeTaskNotificationMessageMode(input?.messageMode || fallback.messageMode),
     lastStatus: clampText(input?.lastStatus || fallback.lastStatus || '', 32).trim(),
     lastError: clampText(input?.lastError || fallback.lastError || '', 500).trim(),
@@ -359,7 +363,7 @@ export function listTasks(limit = 30) {
   const rows = all(
     `SELECT id, slug, title, auto_title, last_prompt_preview, todo_items_json, codex_session_id,
             automation_enabled, automation_cron, automation_timezone, automation_concurrency_policy, automation_last_triggered_at, automation_next_trigger_at,
-            notification_enabled, notification_channel_type, notification_webhook_url, notification_secret, notification_trigger_on, notification_message_mode, notification_last_status, notification_last_error, notification_last_sent_at,
+            notification_enabled, notification_channel_type, notification_webhook_url, notification_secret, notification_trigger_on, notification_locale, notification_message_mode, notification_last_status, notification_last_error, notification_last_sent_at,
             visibility, expires_at, created_at, updated_at
      FROM tasks
      ORDER BY created_at DESC, id DESC
@@ -388,7 +392,7 @@ export function getTaskBySlug(slug) {
   const row = get(
     `SELECT id, slug, title, auto_title, last_prompt_preview, todo_items_json, codex_session_id,
             automation_enabled, automation_cron, automation_timezone, automation_concurrency_policy, automation_last_triggered_at, automation_next_trigger_at,
-            notification_enabled, notification_channel_type, notification_webhook_url, notification_secret, notification_trigger_on, notification_message_mode, notification_last_status, notification_last_error, notification_last_sent_at,
+            notification_enabled, notification_channel_type, notification_webhook_url, notification_secret, notification_trigger_on, notification_locale, notification_message_mode, notification_last_status, notification_last_error, notification_last_sent_at,
             visibility, expires_at, created_at, updated_at
      FROM tasks
      WHERE slug = ?`,
@@ -424,10 +428,10 @@ export function createTask(input = {}) {
       `INSERT INTO tasks (
         slug, edit_token, title, auto_title, last_prompt_preview, todo_items_json, codex_session_id,
         automation_enabled, automation_cron, automation_timezone, automation_concurrency_policy, automation_last_triggered_at, automation_next_trigger_at,
-        notification_enabled, notification_channel_type, notification_webhook_url, notification_secret, notification_trigger_on, notification_message_mode, notification_last_status, notification_last_error, notification_last_sent_at,
+        notification_enabled, notification_channel_type, notification_webhook_url, notification_secret, notification_trigger_on, notification_locale, notification_message_mode, notification_last_status, notification_last_error, notification_last_sent_at,
         visibility, expires_at, created_at, updated_at
       )
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)` ,
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)` ,
       [
         slug,
         editToken,
@@ -447,6 +451,7 @@ export function createTask(input = {}) {
         notification.webhookUrl,
         notification.secret,
         notification.triggerOn,
+        notification.locale,
         notification.messageMode,
         notification.lastStatus,
         notification.lastError,
@@ -469,7 +474,7 @@ export function updateTask(slug, input = {}) {
   const existing = get(
     `SELECT id, edit_token, title, auto_title, last_prompt_preview, todo_items_json, codex_session_id,
             automation_enabled, automation_cron, automation_timezone, automation_concurrency_policy, automation_last_triggered_at, automation_next_trigger_at,
-            notification_enabled, notification_channel_type, notification_webhook_url, notification_secret, notification_trigger_on, notification_message_mode, notification_last_status, notification_last_error, notification_last_sent_at,
+            notification_enabled, notification_channel_type, notification_webhook_url, notification_secret, notification_trigger_on, notification_locale, notification_message_mode, notification_last_status, notification_last_error, notification_last_sent_at,
             visibility, expires_at
      FROM tasks
      WHERE slug = ?`,
@@ -524,6 +529,7 @@ export function updateTask(slug, input = {}) {
         webhookUrl: existing.notification_webhook_url,
         secret: existing.notification_secret,
         triggerOn: existing.notification_trigger_on,
+        locale: existing.notification_locale,
         messageMode: existing.notification_message_mode,
         lastStatus: existing.notification_last_status,
         lastError: existing.notification_last_error,
@@ -535,6 +541,7 @@ export function updateTask(slug, input = {}) {
         webhookUrl: existing.notification_webhook_url,
         secret: existing.notification_secret,
         triggerOn: existing.notification_trigger_on,
+        locale: existing.notification_locale,
         messageMode: existing.notification_message_mode,
         lastStatus: existing.notification_last_status,
         lastError: existing.notification_last_error,
@@ -551,7 +558,7 @@ export function updateTask(slug, input = {}) {
       `UPDATE tasks
        SET title = ?, auto_title = ?, last_prompt_preview = ?, todo_items_json = ?, codex_session_id = ?,
            automation_enabled = ?, automation_cron = ?, automation_timezone = ?, automation_concurrency_policy = ?, automation_last_triggered_at = ?, automation_next_trigger_at = ?,
-           notification_enabled = ?, notification_channel_type = ?, notification_webhook_url = ?, notification_secret = ?, notification_trigger_on = ?, notification_message_mode = ?, notification_last_status = ?, notification_last_error = ?, notification_last_sent_at = ?,
+           notification_enabled = ?, notification_channel_type = ?, notification_webhook_url = ?, notification_secret = ?, notification_trigger_on = ?, notification_locale = ?, notification_message_mode = ?, notification_last_status = ?, notification_last_error = ?, notification_last_sent_at = ?,
            visibility = ?, expires_at = ?, updated_at = ?
        WHERE slug = ?`,
       [
@@ -571,6 +578,7 @@ export function updateTask(slug, input = {}) {
         notification.webhookUrl,
         notification.secret,
         notification.triggerOn,
+        notification.locale,
         notification.messageMode,
         notification.lastStatus,
         notification.lastError,
@@ -742,7 +750,7 @@ export function listAutomationEnabledTasks(limit = 200) {
   const rows = all(
     `SELECT id, slug, title, auto_title, last_prompt_preview, codex_session_id,
             automation_enabled, automation_cron, automation_timezone, automation_concurrency_policy, automation_last_triggered_at, automation_next_trigger_at,
-            notification_enabled, notification_channel_type, notification_webhook_url, notification_secret, notification_trigger_on, notification_message_mode, notification_last_status, notification_last_error, notification_last_sent_at,
+            notification_enabled, notification_channel_type, notification_webhook_url, notification_secret, notification_trigger_on, notification_locale, notification_message_mode, notification_last_status, notification_last_error, notification_last_sent_at,
             visibility, expires_at, created_at, updated_at
      FROM tasks
      WHERE automation_enabled = 1

package/apps/server/src/runDispatchService.js

@@ -2,6 +2,7 @@ import {
   extractRunnerDispatchPatch,
   reconcileRunAfterRunnerDispatchError,
 } from './runnerDispatch.js'
+import { createApiError } from './apiErrors.js'
 
 export function createRunDispatchService(options = {}) {
   const runnerClient = options.runnerClient
@@ -23,28 +24,28 @@ export function createRunDispatchService(options = {}) {
     const promptBlocks = Array.isArray(payload.promptBlocks) ? payload.promptBlocks : []
 
     if (!normalizedTaskSlug) {
-      throw new Error('任务不存在。')
+      throw createApiError('errors.taskNotFound', '任务不存在。', 404)
     }
     if (!normalizedSessionId) {
-      throw new Error('请先选择一个 PromptX 项目。')
+      throw createApiError('errors.sessionRequired', '请先选择一个 PromptX 项目。')
     }
     if (!normalizedPrompt) {
-      throw new Error('没有可发送的提示词。')
+      throw createApiError('errors.noPromptToSend', '没有可发送的提示词。')
     }
 
     const task = getTaskBySlug(normalizedTaskSlug)
     if (!task || task.expired) {
-      throw new Error('任务不存在。')
+      throw createApiError('errors.taskNotFound', '任务不存在。', 404)
     }
 
     const session = getPromptxCodexSessionById(normalizedSessionId)
     if (!session) {
-      throw new Error('没有找到对应的 PromptX 项目。')
+      throw createApiError('errors.sessionNotFound', '没有找到对应的 PromptX 项目。', 404)
     }
 
     const runningRunOnSession = getRunningCodexRunBySessionId(normalizedSessionId)
     if (runningRunOnSession) {
-      throw new Error('当前项目正在执行中，请等待完成后再发送。')
+      throw createApiError('errors.currentProjectRunning', '当前项目正在执行中，请等待完成后再发送。', 409)
     }
 
     const runRecord = createCodexRun({

package/apps/server/src/runnerClient.js

@@ -1,4 +1,5 @@
 import { buildInternalAuthHeaders } from './internalAuth.js'
+import { createApiError } from './apiErrors.js'
 
 const DEFAULT_RUNNER_HTTP_TIMEOUT_MS = Math.max(
   500,
@@ -16,10 +17,12 @@ function getDefaultRunnerBaseUrl() {
 }
 
 function createHttpError(status, payload, fallbackMessage) {
-  const error = new Error(String(payload?.message || fallbackMessage || `HTTP ${status}`))
-  error.statusCode = status
-  error.payload = payload
-  return error
+  return createApiError(
+    payload?.messageKey || '',
+    String(payload?.message || fallbackMessage || `HTTP ${status}`),
+    status,
+    { payload }
+  )
 }
 
 function createRequestAbortController(timeoutMs, upstreamSignal) {
@@ -73,9 +76,17 @@ export function createRunnerClient(options = {}) {
     } catch (error) {
       abortController.cleanup()
       if (abortController.wasTimeout()) {
-        throw createHttpError(504, { message: `runner 请求超时（>${timeoutMs}ms）。` }, 'runner 请求超时。')
+        throw createHttpError(
+          504,
+          { messageKey: 'errors.runnerRequestTimeout', message: `runner 请求超时（>${timeoutMs}ms）。` },
+          'runner 请求超时。'
+        )
       }
-      throw createHttpError(503, { message: error.message || '无法连接 runner 服务。' }, '无法连接 runner 服务。')
+      throw createHttpError(
+        503,
+        { messageKey: 'errors.runnerServiceUnavailable', message: error.message || '无法连接 runner 服务。' },
+        '无法连接 runner 服务。'
+      )
     }
 
     const text = await response.text()