agentworkshop 0.2.1

package/shared/config/engine.mjs

@@ -0,0 +1,291 @@
+// ============================================================
+// AgentWorkShop 运行时配置引擎（零框架依赖，CLI / 启动脚本 / Nuxt 配置 / 服务端通用）
+// ------------------------------------------------------------
+// 优先级（低 → 高）：config.yml 默认值 < data/runtime-settings.json 运行时覆盖 < 环境变量
+// 每个可编辑设置项由 shared/config/schema.json 的描述符声明（类型/枚举/范围/生效方式）。
+// 本文件为 .mjs 以便在任意 Node ESM 环境直接运行，不依赖 tsx/构建。
+// ============================================================
+import { readFileSync, writeFileSync, mkdirSync, renameSync, existsSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import YAML from 'js-yaml'
+
+export const SETTINGS_FILENAME = 'runtime-settings.json'
+
+/** 解析 dotted key（'server.dev.port' → ['server','dev','port']） */
+export function keyPath(key) {
+  return String(key).split('.').filter(Boolean)
+}
+
+/** 读取对象深层路径（不存在返回 undefined） */
+export function getPath(obj, key) {
+  let cur = obj
+  for (const seg of keyPath(key)) {
+    if (cur == null || typeof cur !== 'object') return undefined
+    cur = cur[seg]
+  }
+  return cur
+}
+
+/** 设置对象深层路径（返回是否写入） */
+export function setPath(obj, key, value) {
+  const segs = keyPath(key)
+  if (!segs.length) return false
+  let cur = obj
+  for (let i = 0; i < segs.length - 1; i++) {
+    const s = segs[i]
+    if (cur[s] == null || typeof cur[s] !== 'object') cur[s] = {}
+    cur = cur[s]
+  }
+  cur[segs.at(-1)] = value
+  return true
+}
+
+/** 删除对象深层路径 */
+export function unsetPath(obj, key) {
+  const segs = keyPath(key)
+  if (!segs.length) return false
+  const parent = segs.slice(0, -1).reduce((a, s) => (a && typeof a[s] === 'object' ? a[s] : undefined), obj)
+  if (!parent) return false
+  return delete parent[segs.at(-1)]
+}
+
+/** 读取描述符清单（shared/config/schema.json）
+ * 多路径兜底：CLI/脚本按真实文件位置；Nitro dev 外部化同样命中真实路径；
+ * 生产 bundle 后 import.meta.url 指向产物，改用 cwd 相对路径（repo/home 模式下
+ * schema.json 都在运行根附近）。 */
+export function loadDescriptors() {
+  const here = dirname(fileURLToPath(import.meta.url))
+  const candidates = [
+    join(here, 'schema.json'),
+    resolve(process.cwd(), 'shared', 'config', 'schema.json'),
+    resolve(process.cwd(), 'config', 'schema.json'),
+  ]
+  for (const candidate of candidates) {
+    try {
+      if (existsSync(candidate)) {
+        return JSON.parse(readFileSync(candidate, 'utf8')).settings
+      }
+    }
+    catch { /* 继续尝试下一个候选 */ }
+  }
+  throw new Error(`[config] 找不到 schema.json（尝试: ${candidates.join(' | ')}）`)
+}
+
+/** 读取描述符映射（key → descriptor） */
+export function loadDescriptorMap(descriptors = loadDescriptors()) {
+  return Object.fromEntries(descriptors.map(d => [d.key, d]))
+}
+
+/**
+ * 按描述符把字符串值强转为目标类型（CLI / 环境变量传入时使用）。
+ * 无效返回 null（调用方应报错）。
+ */
+export function coerceValue(desc, value) {
+  if (value == null || value === '') return null
+  switch (desc.type) {
+    case 'number': {
+      const n = Number(value)
+      return Number.isFinite(n) ? n : null
+    }
+    case 'boolean': {
+      if (typeof value === 'boolean') return value
+      if (/^(1|true|yes|on)$/i.test(String(value))) return true
+      if (/^(0|false|no|off)$/i.test(String(value))) return false
+      return null
+    }
+    default:
+      return String(value)
+  }
+}
+
+/** 按描述符校验值；返回错误消息数组（空 = 通过） */
+export function validateValue(desc, value) {
+  const errors = []
+  if (value == null) return []
+  switch (desc.type) {
+    case 'string': {
+      if (typeof value !== 'string') return [`${desc.key} 应为字符串`]
+      if (typeof desc.minLength === 'number' && value.length < desc.minLength) errors.push(`长度不足 ${desc.minLength}`)
+      if (typeof desc.maxLength === 'number' && value.length > desc.maxLength) errors.push(`长度超过 ${desc.maxLength}`)
+      break
+    }
+    case 'number': {
+      if (typeof value !== 'number' || !Number.isFinite(value)) return [`${desc.key} 应为数字`]
+      if (typeof desc.min === 'number' && value < desc.min) errors.push(`不能小于 ${desc.min}`)
+      if (typeof desc.max === 'number' && value > desc.max) errors.push(`不能大于 ${desc.max}`)
+      break
+    }
+    case 'boolean': {
+      if (typeof value !== 'boolean') return [`${desc.key} 应为布尔值`]
+      break
+    }
+    case 'color': {
+      if (!/^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(String(value))) errors.push('须为十六进制颜色，如 #35e0a0')
+      break
+    }
+    case 'select': {
+      if (!desc.options?.includes(value)) errors.push(`须为 ${desc.options?.join(' / ')} 之一`)
+      break
+    }
+    default:
+      break
+  }
+  return errors
+}
+
+/** 校验一组覆盖（{key: value}）；返回 { ok, errors: {key: msg[]} } */
+export function validateOverrides(overrides, descriptors = loadDescriptors()) {
+  const map = loadDescriptorMap(descriptors)
+  const errors = {}
+  let ok = true
+  for (const [key, value] of Object.entries(overrides)) {
+    const desc = map[key]
+    if (!desc) {
+      errors[key] = ['未知设置项（不在 schema.json 中）']
+      ok = false
+      continue
+    }
+    const errs = validateValue(desc, value)
+    if (errs.length) {
+      errors[key] = errs
+      ok = false
+    }
+  }
+  return { ok, errors }
+}
+
+/** 向上查找文件（如 config.yml），返回绝对路径或 null */
+export function findUp(startDir, filename) {
+  let dir = resolve(startDir)
+  for (;;) {
+    const candidate = join(dir, filename)
+    if (existsSync(candidate)) return candidate
+    const parent = dirname(dir)
+    if (parent === dir) return null
+    dir = parent
+  }
+}
+
+/** 读取 settings 覆盖文件（不存在返回空对象） */
+export function readSettings(settingsPath) {
+  try {
+    const raw = JSON.parse(readFileSync(settingsPath, 'utf8'))
+    return raw?.overrides && typeof raw.overrides === 'object' ? raw.overrides : {}
+  }
+  catch {
+    return {}
+  }
+}
+
+/**
+ * 原子写入 settings 覆盖文件（tmp + rename）。
+ * 结构：{ version, updatedAt, overrides: { 'key': value } }
+ */
+export function saveSettings(overrides, settingsPath, { version = 1 } = {}) {
+  mkdirSync(dirname(settingsPath), { recursive: true })
+  const payload = {
+    version,
+    updatedAt: new Date().toISOString(),
+    overrides,
+  }
+  const tmp = `${settingsPath}.${process.pid}.tmp`
+  writeFileSync(tmp, `${JSON.stringify(payload, null, 2)}\n`, 'utf8')
+  renameSync(tmp, settingsPath)
+  return payload
+}
+
+/**
+ * 环境变量 → 设置 key 的映射（AW_ 前缀 + 点转下划线，如 AW_SERVER_DEV_PORT）。
+ * 另支持常见惯例：PORT/NITRO_PORT/HOST/NITRO_HOST（launcher 模式下映射到对应 mode 端口）。
+ */
+export function envOverridesFromEnv(env = process.env, descriptors = loadDescriptors(), mode) {
+  const out = {}
+  for (const desc of descriptors) {
+    const varName = `AW_${desc.key.toUpperCase().replace(/\./g, '_')}`
+    if (env[varName] !== undefined) {
+      const coerced = coerceValue(desc, env[varName])
+      if (coerced !== null) out[desc.key] = coerced
+    }
+  }
+  // 端口/主机惯例变量（launcher 才有 mode 意识）
+  if (mode) {
+    const portKey = mode === 'dev' ? 'server.dev.port' : 'server.prod.port'
+    const p = env.PORT ?? env.NITRO_PORT ?? env.NUXT_PORT
+    if (p !== undefined) {
+      const n = Number(p)
+      if (Number.isFinite(n)) out[portKey] = n
+    }
+    const h = env.HOST ?? env.NITRO_HOST
+    if (h !== undefined) out['server.host'] = h
+  }
+  return out
+}
+
+/**
+ * 加载有效配置。返回：
+ * {
+ *   defaults,              // config.yml 原始对象
+ *   overrides,             // 运行时覆盖（flat dotted map）
+ *   envOverrides,          // 环境变量覆盖（flat dotted map）
+ *   effective,             // 逐设置项合并后的有效值（flat dotted map）
+ *   sources,               // key → 'config.yml' | 'runtime' | 'env'
+ *   descriptors,
+ *   configPath, settingsPath
+ * }
+ */
+export function loadEffective({ configPath, settingsPath, env = process.env, mode } = {}) {
+  const descriptors = loadDescriptors()
+  const defaults = configPath && existsSync(configPath)
+    ? (YAML.load(readFileSync(configPath, 'utf8')) ?? {})
+    : {}
+  const overrides = settingsPath ? readSettings(settingsPath) : {}
+  const envOverrides = envOverridesFromEnv(env, descriptors, mode)
+
+  const effective = {}
+  const sources = {}
+  for (const desc of descriptors) {
+    let value
+    let source
+    if (envOverrides[desc.key] !== undefined) {
+      value = envOverrides[desc.key]
+      source = 'env'
+    }
+    else if (overrides[desc.key] !== undefined) {
+      value = overrides[desc.key]
+      source = 'runtime'
+    }
+    else {
+      const fromYaml = getPath(defaults, desc.key)
+      value = fromYaml !== undefined ? fromYaml : desc.default
+      source = 'config.yml'
+    }
+    effective[desc.key] = value
+    sources[desc.key] = source
+  }
+  return { defaults, overrides, envOverrides, effective, sources, descriptors, configPath, settingsPath }
+}
+
+/** 便捷：默认 settings 文件路径（<root>/data/runtime-settings.json） */
+export function settingsPathFor(root) {
+  return join(root, 'data', SETTINGS_FILENAME)
+}
+
+export default {
+  SETTINGS_FILENAME,
+  keyPath,
+  getPath,
+  setPath,
+  unsetPath,
+  loadDescriptors,
+  loadDescriptorMap,
+  coerceValue,
+  validateValue,
+  validateOverrides,
+  findUp,
+  readSettings,
+  saveSettings,
+  envOverridesFromEnv,
+  loadEffective,
+  settingsPathFor,
+}

package/shared/config/home.d.mts

@@ -0,0 +1,48 @@
+// shared/config/home.mjs 的类型声明（供 nuxt 构建期 TS / 服务端引用）
+
+export declare const HOME_DIRNAME: string
+
+/** 配置根：AW_HOME 环境变量 > ~/.AgentWorkShop */
+export declare function awHome(env?: NodeJS.ProcessEnv): string
+
+/** 是否为 AgentWorkShop 项目检出（config.yml + nuxt.config.ts 齐备） */
+export declare function isRepoRoot(dir: string | null | undefined): boolean
+
+/** 从指定目录向上找项目检出根；找不到返回 null */
+export declare function findRepoRoot(startDir?: string): string | null
+
+export interface RunModeInfo {
+  mode: 'repo' | 'home'
+  root: string | null
+  /** 用户级根 ~/.AgentWorkShop（AW_HOME 可重定向） */
+  home: string
+  /** 当前生效配置根（repo=<repo>/.AgentWorkShop; home=~/.AgentWorkShop） */
+  configRoot: string
+  configPath: string
+  settingsPath: string
+  dataDir: string
+}
+
+/** 解析当前运行模式与全部路径（配置/设置/数据的单一判定入口） */
+export declare function resolveRunMode(opts?: {
+  cwd?: string
+  packageRoot?: string
+  env?: NodeJS.ProcessEnv
+}): RunModeInfo
+
+/** 运行数据目录：AW_DATA_DIR > home 模式配置根/data > repo 模式 cwd/.AgentWorkShop/data > cwd/data */
+export declare function dataDirFor(cwd?: string, env?: NodeJS.ProcessEnv): string
+
+/** 确保数据目录存在 + 旧位置(cwd/data、cwd/server/data)运行时文件迁入配置根（幂等） */
+export declare function ensureDataDir(cwd?: string, env?: NodeJS.ProcessEnv): string
+
+declare const _default: {
+  HOME_DIRNAME: string
+  awHome: typeof awHome
+  isRepoRoot: typeof isRepoRoot
+  findRepoRoot: typeof findRepoRoot
+  resolveRunMode: typeof resolveRunMode
+  dataDirFor: typeof dataDirFor
+  ensureDataDir: typeof ensureDataDir
+}
+export default _default

package/shared/config/home.mjs

@@ -0,0 +1,146 @@
+// ============================================================
+// AgentWorkShop 配置根目录（.AgentWorkShop）解析 —— 零依赖，CLI / 启动脚本 /
+// nuxt 构建期 / 服务端通用。类似 Claude Code 的 ~/.claude：全部配置、
+// 数据、自定义指令都收敛在 .AgentWorkShop 文件夹，与当前工作目录和环境无关。
+// ------------------------------------------------------------
+// 两种运行模式（resolveRunMode 判定）：
+//   repo  模式：cwd 向上能找到项目检出（config.yml + nuxt.config.ts）
+//               → 配置根 = <repo>/.AgentWorkShop（运行时覆盖/数据/日志/指令），
+//                 工厂默认 config.yml/.env 留在检出根（git 版本化）
+//   home  模式：npm -g / npx 全局安装后任意目录 → 配置根 = ~/.AgentWorkShop
+//               （AW_HOME 可重定向），应用载荷来自本包
+// ============================================================
+import { copyFileSync, existsSync, mkdirSync, readdirSync, statSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { dirname, join, resolve } from 'node:path'
+
+export const HOME_DIRNAME = '.AgentWorkShop'
+
+/** 配置根：AW_HOME 环境变量 > ~/.AgentWorkShop */
+export function awHome(env = process.env) {
+  if (env.AW_HOME && String(env.AW_HOME).trim()) return String(env.AW_HOME).trim()
+  return join(homedir(), HOME_DIRNAME)
+}
+
+/** 是否为 AgentWorkShop 项目检出（两个标记文件齐备） */
+export function isRepoRoot(dir) {
+  return Boolean(dir) && existsSync(join(dir, 'config.yml')) && existsSync(join(dir, 'nuxt.config.ts'))
+}
+
+/** 从 cwd 向上找项目检出根；找不到返回 null */
+export function findRepoRoot(startDir = process.cwd()) {
+  let dir = resolve(startDir)
+  for (;;) {
+    if (isRepoRoot(dir)) return dir
+    const parent = dirname(dir)
+    if (parent === dir) return null
+    dir = parent
+  }
+}
+
+/**
+ * 解析当前运行模式与全部路径。
+ * 优先级：env.AW_MODE === 'home' 显式强制 home 模式（启动器对全局安装的
+ * 应用载荷注入;否则包目录自身含 config.yml+nuxt.config.ts 会被误判为检出）
+ * > cwd 向上找检出 > home 模式。
+ * @returns {{
+ *   mode: 'repo'|'home',
+ *   root: string,            // repo=检出根; home=应用载荷根(本包)
+ *   home: string,            // 用户级根 ~/.AgentWorkShop(AW_HOME 可重定向;用户级指令/全局配置)
+ *   configRoot: string,      // 当前生效配置根(repo=<repo>/.AgentWorkShop; home=~/.AgentWorkShop)
+ *   configPath: string,      // 生效的 config.yml(工厂默认;repo 在检出根,home 在配置根)
+ *   settingsPath: string,    // 生效的 runtime-settings.json(两种模式都在配置根)
+ *   dataDir: string,         // 运行数据目录(两种模式都在配置根)
+ * }}
+ */
+export function resolveRunMode({ cwd, packageRoot, env = process.env } = {}) {
+  const home = awHome(env)
+  const forceHome = env.AW_MODE === 'home'
+  const repoRoot = forceHome ? null : findRepoRoot(cwd ?? process.cwd())
+  if (repoRoot) {
+    const configRoot = join(repoRoot, HOME_DIRNAME)
+    return {
+      mode: 'repo',
+      root: repoRoot,
+      home,
+      configRoot,
+      configPath: join(repoRoot, 'config.yml'),
+      settingsPath: join(configRoot, 'runtime-settings.json'),
+      dataDir: join(configRoot, 'data'),
+    }
+  }
+  return {
+    mode: 'home',
+    root: packageRoot ?? repoRoot,
+    home,
+    configRoot: home,
+    configPath: existsSync(join(home, 'config.yml')) ? join(home, 'config.yml') : join(packageRoot ?? '', 'config.yml'),
+    settingsPath: join(home, 'runtime-settings.json'),
+    dataDir: join(home, 'data'),
+  }
+}
+
+/**
+ * 运行数据目录（服务端/CLI 通用）：
+ *   AW_DATA_DIR 环境变量 > home 模式(AW_MODE=home) 配置根/data
+ *   > repo 模式(cwd 有 config.yml) cwd/.AgentWorkShop/data > cwd/data 兜底。
+ * 启动器(scripts/start.mjs / dev-guard.mjs)会经 resolveRunMode 注入 AW_DATA_DIR;
+ * 本函数为其兜底(直接 node .output/server/index.mjs 等无启动器场景)。
+ */
+export function dataDirFor(cwd = process.cwd(), env = process.env) {
+  if (env.AW_DATA_DIR && String(env.AW_DATA_DIR).trim()) return resolve(String(env.AW_DATA_DIR).trim())
+  if (env.AW_MODE === 'home') return join(awHome(env), 'data')
+  if (existsSync(join(cwd, 'config.yml'))) return join(cwd, HOME_DIRNAME, 'data')
+  return join(cwd, 'data')
+}
+
+/**
+ * 确保数据目录存在，并把旧位置(cwd/data 与 cwd/server/data)的运行时文件
+ * 迁入配置根（仅复制目标缺失的文件，不删除旧文件;幂等）。
+ * 迁移覆盖 sqlite 主库/-wal/-shm 与 JSON 仓库文件;跳过 .tmp 临时产物。
+ */
+export function ensureDataDir(cwd = process.cwd(), env = process.env) {
+  const dir = dataDirFor(cwd, env)
+  mkdirSync(dir, { recursive: true })
+  if (env.AW_MODE === 'home') return dir
+  const legacyDirs = [join(cwd, 'data'), join(cwd, 'server', 'data')]
+  for (const legacy of legacyDirs) {
+    if (resolve(legacy) === resolve(dir) || !existsSync(legacy)) continue
+    let entries
+    try {
+      entries = readdirSync(legacy)
+    }
+    catch {
+      continue
+    }
+    for (const f of entries) {
+      // 只搬运行时文件(sqlite 主库/-wal/-shm 与 JSON 仓库);.log/.mjs/.png 等杂物不入配置根
+      if (!/\.(sqlite|sqlite-wal|sqlite-shm|json)$/.test(f)) continue
+      const src = join(legacy, f)
+      const dst = join(dir, f)
+      try {
+        if (!existsSync(dst) && statSync(src).isFile()) copyFileSync(src, dst)
+      }
+      catch { /* 单个文件迁移失败不阻断 */ }
+    }
+  }
+  // 运行时覆盖迁入配置根(旧 <repo>/data/runtime-settings.json → <repo>/.AgentWorkShop/)
+  const configRoot = resolve(dir, '..')
+  const legacySettings = join(cwd, 'data', 'runtime-settings.json')
+  const targetSettings = join(configRoot, 'runtime-settings.json')
+  try {
+    if (!existsSync(targetSettings) && existsSync(legacySettings)) copyFileSync(legacySettings, targetSettings)
+  }
+  catch { /* 迁移失败不阻断 */ }
+  return dir
+}
+
+export default {
+  HOME_DIRNAME,
+  awHome,
+  isRepoRoot,
+  findRepoRoot,
+  resolveRunMode,
+  dataDirFor,
+  ensureDataDir,
+}

package/shared/config/schema.json

@@ -0,0 +1,30 @@
+{
+  "version": 1,
+  "comment": "AgentWorkShop 运行时设置描述符（声明式单一来源）。config.yml 提供默认值（source=config.yml），data/runtime-settings.json 提供运行时覆盖（source=runtime），环境变量提供 env 覆盖（source=env）。applies: live=保存即热重载生效; restart=需重启对应模式（aw dev / pnpm start）后生效。",
+  "settings": [
+    { "key": "server.host", "type": "string", "group": "server", "label": "监听地址", "labelKey": "settings.runtime.server.host", "description": "服务绑定的网络接口，0.0.0.0 = 全网卡", "applies": "restart", "default": "0.0.0.0" },
+    { "key": "server.dev.port", "type": "number", "group": "server", "label": "开发端口", "labelKey": "settings.runtime.server.devPort", "description": "pnpm dev / aw dev 启动时使用的端口", "applies": "restart", "default": 3000, "min": 1, "max": 65535 },
+    { "key": "server.prod.port", "type": "number", "group": "server", "label": "生产端口", "labelKey": "settings.runtime.server.prodPort", "description": "pnpm start / aw start 启动时使用的端口", "applies": "restart", "default": 3001, "min": 1, "max": 65535 },
+
+    { "key": "app.title", "type": "string", "group": "app", "label": "应用标题", "labelKey": "settings.runtime.app.title", "description": "浏览器标题与页面头部展示的应用名", "applies": "live", "default": "AgentWorkShop" },
+    { "key": "app.description", "type": "string", "group": "app", "label": "应用描述", "labelKey": "settings.runtime.app.description", "description": "站点描述（SEO meta），SSR 实时生效", "applies": "live", "default": "" },
+
+    { "key": "api.baseURL", "type": "string", "group": "api", "label": "API 基址", "labelKey": "settings.runtime.api.baseURL", "description": "前端 axios 请求基址，一般保持 /api", "applies": "live", "default": "/api" },
+    { "key": "api.timeout", "type": "number", "group": "api", "label": "API 超时(ms)", "labelKey": "settings.runtime.api.timeout", "description": "HTTP 请求超时毫秒数", "applies": "live", "default": 15000, "min": 500, "max": 120000 },
+    { "key": "api.pageSize", "type": "number", "group": "api", "label": "默认分页大小", "labelKey": "settings.runtime.api.pageSize", "description": "服务端 API 默认分页条数", "applies": "live", "default": 20, "min": 1, "max": 1000 },
+    { "key": "api.maxPageSize", "type": "number", "group": "api", "label": "分页大小上限", "labelKey": "settings.runtime.api.maxPageSize", "description": "服务端 API 分页条数上限", "applies": "live", "default": 100, "min": 1, "max": 10000 },
+
+    { "key": "theme.primaryColor", "type": "color", "group": "theme", "label": "主题色", "labelKey": "settings.runtime.theme.primaryColor", "description": "品牌主色（十六进制），保存后全站实时生效；前端设置页的本地强调色偏好优先于它", "applies": "live", "default": "#35e0a0" },
+    { "key": "theme.mode", "type": "select", "group": "theme", "label": "显示模式", "labelKey": "settings.runtime.theme.mode", "description": "全局默认深浅色；用户本地切换偏好优先", "applies": "live", "default": "light", "options": ["light", "dark"] },
+
+    { "key": "i18n.defaultLocale", "type": "select", "group": "i18n", "label": "默认语言", "labelKey": "settings.runtime.i18n.defaultLocale", "description": "未做本地选择时的界面语言", "applies": "live", "default": "zh-CN", "options": ["zh-CN", "en"] },
+
+    { "key": "security.approvalGate", "type": "boolean", "group": "security", "label": "高危操作双人复核", "labelKey": "settings.runtime.security.approvalGate", "description": "R3：开启后写控/删除等高风险操作需另一位管理员批核", "applies": "live", "default": false },
+
+    { "key": "daq.startInfrastructure", "type": "select", "group": "daq", "label": "数采基础设施拉起策略", "labelKey": "settings.runtime.daq.startInfrastructure", "description": "auto=启动探测，不通且有 Docker 则自动拉起；always=仅 Docker 拉起；never=只直连", "applies": "live", "default": "auto", "options": ["auto", "always", "never"] },
+    { "key": "daq.mqtt.host", "type": "string", "group": "daq", "label": "MQTT Broker 地址", "labelKey": "settings.runtime.daq.mqttHost", "description": "数采事件总线 MQTT 主机", "applies": "restart", "default": "127.0.0.1" },
+    { "key": "daq.mqtt.port", "type": "number", "group": "daq", "label": "MQTT Broker 端口", "labelKey": "settings.runtime.daq.mqttPort", "description": "数采事件总线 MQTT 端口", "applies": "restart", "default": 1883, "min": 1, "max": 65535 },
+    { "key": "daq.timescale.host", "type": "string", "group": "daq", "label": "时序库地址", "labelKey": "settings.runtime.daq.tsHost", "description": "TimescaleDB/PostgreSQL 主机", "applies": "restart", "default": "127.0.0.1" },
+    { "key": "daq.timescale.port", "type": "number", "group": "daq", "label": "时序库端口", "labelKey": "settings.runtime.daq.tsPort", "description": "TimescaleDB/PostgreSQL 端口", "applies": "restart", "default": 5432, "min": 1, "max": 65535 }
+  ]
+}