@sophiacyl/dsh-plugin-waves 0.0.0-stage → 0.1.0-beta.1

package/lib/host/service.js

@@ -0,0 +1,263 @@
+// 服务进程托管: 目录解析、首启安装、拉起与健康检查
+import { spawn } from 'node:child_process'
+import { existsSync, readFileSync, readdirSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { PKG_NAME } from './consts.js'
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '../..')
+
+export function serviceDirCandidates() {
+  const home = process.env.DSH_HOME || join(process.env.HOME || process.env.USERPROFILE || '', '.dsh')
+  const profiles = join(home, 'profiles')
+  const out = []
+  let names = []
+  try {
+    names = readdirSync(profiles)
+  } catch {
+    return out
+  }
+  for (const name of names) {
+    // 用 file: 装的按源码目录跑(环境和数据都在克隆里, README 的用法), 找不到才用 profile 里的副本
+    try {
+      const manifest = JSON.parse(readFileSync(join(profiles, name, 'package.json'), 'utf8'))
+      const spec = manifest?.dependencies?.[PKG_NAME]
+      if (typeof spec === 'string' && spec.startsWith('file:')) {
+        out.push(join(spec.slice('file:'.length), 'service'))
+      }
+    } catch {}
+    out.push(join(profiles, name, 'node_modules', PKG_NAME, 'service'))
+  }
+  return out
+}
+
+export function resolveServiceDir(config) {
+  const candidates = [
+    config?.servicePath,
+    process.env.WAVES_SERVICE_DIR,
+    ...serviceDirCandidates(),
+    join(ROOT, 'service'),
+  ].filter((dir) => dir && existsSync(join(dir, 'rover/main.py')))
+  // 已经装好的(有虚拟环境或数据)优先: 免得把跑着的实例切到一个空目录去重装
+  const ready = candidates.find(
+    (dir) => existsSync(venvPython(dir)) || existsSync(join(dir, 'data/config.json')),
+  )
+  return ready || candidates[0] || join(ROOT, 'service')
+}
+
+// 服务配置里的模型可见开关; 读文件即可, 改动本来就要重启生效
+export function exposeToModelFlag(serviceDir) {
+  try {
+    const cfg = JSON.parse(readFileSync(join(serviceDir, 'data/config.json'), 'utf8'))
+    return cfg.expose_to_model !== false
+  } catch {
+    return true
+  }
+}
+
+// 命令前缀(逗号分隔多个); 每个前缀都注册成命令, 菜单里才都列得出来
+export function readPrefixes(serviceDir) {
+  try {
+    const cfg = JSON.parse(readFileSync(join(serviceDir, 'data/config.json'), 'utf8'))
+    const raw = String(cfg.command_prefix ?? 'ww')
+    const list = raw.split(/[,，]/).map((x) => x.trim()).filter(Boolean)
+    return list.length ? list : ['ww']
+  } catch {
+    return ['ww']
+  }
+}
+
+// 虚拟环境的解释器位置随平台不同: Windows 在 Scripts\\python.exe
+export function venvPython(serviceDir) {
+  return join(
+    serviceDir,
+    '.venv',
+    process.platform === 'win32' ? 'Scripts' : 'bin',
+    process.platform === 'win32' ? 'python.exe' : 'python',
+  )
+}
+
+export function servicePython(serviceDir) {
+  const venv = venvPython(serviceDir)
+  if (existsSync(venv)) return venv
+  return process.platform === 'win32' ? 'python' : 'python3'
+}
+
+export function makeClient(port) {
+  const base = `http://127.0.0.1:${port}`
+  async function call(path, { method = 'GET', body, signal, timeoutMs = 300000 } = {}) {
+    const controller = new AbortController()
+    if (signal?.aborted) controller.abort()
+    const timer = setTimeout(() => controller.abort(), timeoutMs)
+    const onAbort = () => controller.abort()
+    if (signal) signal.addEventListener('abort', onAbort, { once: true })
+    try {
+      const res = await fetch(base + path, {
+        method,
+        headers: body ? { 'content-type': 'application/json' } : undefined,
+        body: body ? JSON.stringify(body) : undefined,
+        signal: controller.signal,
+      })
+      const text = await res.text()
+      let data
+      try {
+        data = text ? JSON.parse(text) : null
+      } catch {
+        throw new Error(`服务返回非 JSON (${res.status}): ${text.slice(0, 200)}`)
+      }
+      if (!res.ok) throw new Error(data?.detail || data?.error || `服务错误 ${res.status}`)
+      return data
+    } finally {
+      clearTimeout(timer)
+      if (signal) signal.removeEventListener('abort', onAbort)
+    }
+  }
+  return { base, call }
+}
+
+// Bounded asynchronous setup: never block the host event loop during downloads.
+function setupCommand(command, args, { cwd, signal, timeoutMs, stdio = 'ignore' }) {
+  return new Promise((resolve) => {
+    if (signal?.aborted) return resolve({ ok: false, reason: '已取消安装' })
+    let child
+    let reason
+    let settled = false
+    let timer
+    const finish = (value) => {
+      if (settled) return
+      settled = true
+      clearTimeout(timer)
+      signal?.removeEventListener('abort', abort)
+      resolve(value)
+    }
+    const cancel = (message) => {
+      reason = message
+      try {
+        if (process.platform !== 'win32' && child?.pid) process.kill(-child.pid, 'SIGTERM')
+        else child?.kill('SIGTERM')
+      } catch {}
+      finish({ ok: false, reason })
+    }
+    const abort = () => cancel('已取消安装')
+    try {
+      child = spawn(command, args, { cwd, stdio, detached: process.platform !== 'win32' })
+    } catch (error) {
+      finish({ ok: false, reason: String(error.message || error) })
+      return
+    }
+    child.once('error', (error) => finish({ ok: false, reason: reason || String(error.message || error) }))
+    child.once('close', (code) => finish({ ok: code === 0, reason: code === 0 ? undefined : reason || `退出码 ${code}` }))
+    signal?.addEventListener('abort', abort, { once: true })
+    timer = setTimeout(() => cancel('安装超时，请检查网络后重试'), timeoutMs)
+  })
+}
+
+export async function bootstrap(serviceDir, { signal, timeoutMs = 15 * 60_000 } = {}) {
+  const root = join(serviceDir, '..')
+  // An existing interpreter alone does not prove installation completed.
+  const pluginsReady = ['XutheringWavesUID', 'RoverSign', 'ScoreEcho'].every((name) =>
+    existsSync(join(serviceDir, 'plugins', name, name, '__init__.py')))
+  if (existsSync(venvPython(serviceDir)) && pluginsReady) {
+    const checked = await setupCommand(venvPython(serviceDir), ['-c',
+      'import cv2, cryptography, fastapi, sqlmodel, PIL, jinja2, lxml, msgspec, rapidocr, onnxruntime, playwright'],
+    { cwd: serviceDir, signal, timeoutMs: 30_000 })
+    if (checked.ok) return checked
+    if (signal?.aborted) return checked
+  }
+  const windows = process.platform === 'win32'
+  const script = join(root, windows ? 'install.ps1' : 'install.sh')
+  if (!existsSync(script)) return { ok: false, reason: `缺少 ${windows ? 'install.ps1' : 'install.sh'}` }
+  console.log('[waves] 正在准备运行环境，可继续使用其它会话...')
+  return setupCommand(windows ? 'powershell' : 'bash', windows
+    ? ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', script, '-EnvOnly']
+    : [script, '--env-only'], { cwd: root, signal, timeoutMs, stdio: 'inherit' })
+}
+
+// 与 rover.restart.RESTART_EXIT 一致: 资源有 diff 后主动退出, 马上再拉起
+const RESTART_EXIT = 75
+
+// 去掉 no_proxy 里带方括号的 IPv6 项
+export function serviceEnv(port, base = process.env) {
+  const env = { ...base, PYTHONUNBUFFERED: '1', ROVER_PORT: String(port) }
+  for (const key of ['no_proxy', 'NO_PROXY']) {
+    if (typeof env[key] !== 'string') continue
+    env[key] = env[key]
+      .split(',')
+      .map((item) => item.trim())
+      .filter((item) => item && !item.startsWith('['))
+      .join(',')
+  }
+  return env
+}
+
+export function startService(ctx, config) {
+  const python = servicePython(config.serviceDir)
+  let child
+  let stopping = false
+  let timer
+  let backoff = 500
+  let failures = 0
+
+  const log = (buf, level) => {
+    const line = buf.toString().trimEnd()
+    if (line) ctx.logger?.[level]?.(line) ?? console.log(`[waves] ${line}`)
+  }
+
+  const launch = () => {
+    if (stopping) return
+    child = spawn(python, ['-m', 'rover.main', '--port', String(config.port)], {
+      cwd: config.serviceDir,
+      env: serviceEnv(config.port),
+      stdio: ['ignore', 'pipe', 'pipe'],
+    })
+    const launchedAt = Date.now()
+    child.stdout.on('data', (b) => log(b, 'info'))
+    child.stderr.on('data', (b) => log(b, 'warn'))
+    child.once('error', (error) => console.log(`[waves] 无法启动服务: ${String(error.message || error)}`))
+    child.once('close', (code) => {
+      child = undefined
+      if (stopping) return
+      const asked = code === RESTART_EXIT
+      if (asked || Date.now() - launchedAt > 60_000) failures = 0
+      if (!asked && ++failures >= 5) {
+        console.log('[waves] 服务连续失败 5 次，已停止自动重试；请修复环境后重新加载插件')
+        return
+      }
+      const wait = asked ? 400 : backoff
+      if (asked) backoff = 500
+      else backoff = Math.min(backoff * 2, 10000)
+      console.log(`[waves] 服务退出 code=${code}${asked ? ' (主动重启)' : ''}, ${wait}ms 后拉起`)
+      timer = setTimeout(launch, wait)
+    })
+  }
+
+  launch()
+  const stop = () => {
+    stopping = true
+    if (timer) clearTimeout(timer)
+    try {
+      child?.kill('SIGTERM')
+    } catch {}
+  }
+  // dsh 进程退出时连带结束服务, 避免残留
+  process.on('exit', stop)
+  return () => {
+    process.removeListener('exit', stop)
+    stop()
+  }
+}
+
+export async function waitReady(client, tries = 60, signal) {
+  for (let i = 0; i < tries && !signal?.aborted; i++) {
+    try {
+      const health = await client.call('/api/health', { timeoutMs: 2000, signal })
+      if (health?.ok === true) return true
+    } catch {
+      if (signal?.aborted) return false
+    }
+    await new Promise((r) => setTimeout(r, 1000))
+  }
+  return false
+}
+

package/lib/host/tool.js

@@ -0,0 +1,185 @@
+// 模型工具: 自然语言场景由模型转成命令调用
+import { defineTool } from '@deepseek-ai/dsh-tools'
+
+import { dataGuide } from './dataguide.js'
+import { readAttachments } from './attachments.js'
+import { takeImages } from './imagebridge.js'
+import { troubleshooting } from './troubleshoot.js'
+import { resultMeta, plainSummary } from './native-result.js'
+
+// 最近一批用户图片 → base64:// 列表, 交给服务的 images 字段
+async function collectImages(ctx, exec) {
+  const agentId = exec?.agent?.id
+  if (!agentId) return []
+  const blocks = takeImages(agentId).map((attachment) => ({ type: 'image', attachment }))
+  return (await readAttachments(ctx, blocks, exec?.signal)).images
+}
+
+export function registerTool(ctx, client, serviceDir, results) {
+  ctx.tools.register(
+    defineTool({
+      name: 'waves',
+      description: [
+        '鸣潮（Wuthering Waves）全功能查询。把用户的鸣潮相关请求转成一条命令传入 command。',
+        '命令带 ww 前缀（不带会自动补）。常用：',
+        'ww查询 / ww体力 / ww深塔 / ww海墟 / ww矩阵 / ww全息 / ww探索 / ww练度 / ww声骸 / ww日历 / ww库洛币',
+        'ww<角色名>面板（如 ww椿面板）/ ww<角色名>伤害 / ww<角色名>优化 / ww<角色名>权重 / ww<角色名>攻略 / ww<角色名>图鉴',
+        'ww<角色名>总排行 / ww练度总排行 / ww抽卡记录 / ww签到 / ww兑换码 / ww帮助 / ww公告',
+        '绑定与登录：ww绑定<特征码> / ww登录 / ww添加token<token> / ww切换<特征码>',
+        '结果含图文卡片和文字摘要；若用户需要继续查询某个角色，可再次指定对应命令。',
+        'summary 里带有卡片上的文字与数值（含各队角色名），要引用具体数字时看它就够了。',
+        '同一条命令不要重复调用；本机只有一个使用者，群聊/私聊之分已取消，private 一般不用填，',
+        '结果看着不够详细也别靠它重试，改用下面的数据接口。',
+        dataGuide(serviceDir),
+      ].join('\n'),
+      parameters: {
+        command: {
+          type: 'string',
+          required: true,
+          description: '要执行的鸣潮命令，例如 "ww查询"、"ww椿面板"、"ww绑定100000001"',
+        },
+        private: {
+          type: 'boolean',
+          description: '是否按私聊场景执行（获取ck 等仅私聊可用的命令需要设为 true）',
+        },
+        with_image: {
+          type: 'boolean',
+          description:
+            '用户本条消息附了图片、且该命令要用到它时设为 true（如 ww评分 / ww分析 的声骸截图），图片会随命令转交服务',
+        },
+      },
+      output: {
+        schema: {
+          type: 'object',
+          additionalProperties: true,
+          properties: {
+            ok: { type: 'boolean', required: true },
+            summary: { type: 'string', required: true },
+            matched: { type: 'array', items: { type: 'string' } },
+            segments: { type: 'array', items: { type: 'object', additionalProperties: true } },
+            elapsed: { type: 'number' },
+          },
+        },
+        render: (_args, value) => [
+          { type: 'text', text: plainSummary(value) },
+        ],
+        presentationMeta: (args, value) => resultMeta(args, value, serviceDir),
+      },
+      timeoutMs: 300000,
+      async execute(args, exec) {
+        try {
+          await client.call('/api/health', { timeoutMs: 4000 })
+        } catch (e) {
+          return {
+            ok: false,
+            summary: troubleshooting(serviceDir, String(e?.message || e)),
+            matched: [],
+            segments: [],
+          }
+        }
+        const images = args.with_image ? await collectImages(ctx, exec) : []
+        const data = await client.call('/api/chat', {
+          method: 'POST',
+          body: {
+            command: String(args.command || ''),
+            scene: args.private ? 'direct' : 'group',
+            session_id: exec?.agent?.id || 'dsh',
+            ...(ctx.get?.('dshGo') ? { native: true } : {}),
+            images,
+          },
+          signal: exec?.signal,
+        })
+        if (args.with_image && !images.length && data && typeof data.summary === 'string') {
+          data.summary += '\n(注: 没有取到用户图片, 命令按无图执行)'
+        }
+        results?.put(exec?.callId || `tool:${exec?.agent?.id || 'dsh'}`, { ...data,
+          command: args.command, sessionId: exec?.agent?.id })
+        return data
+      },
+      presentCall: (args) => ({
+        card: 'generic',
+        kind: 'other',
+        title: `鸣潮 · ${String(args?.command || '').slice(0, 40)}`,
+        rawInput: args,
+      }),
+    }),
+  )
+
+  ctx.tools.register(
+    defineTool({
+      name: 'waves_panel',
+      description: [
+        '鸣潮自定义面板: 按你组装的数据渲一张完整角色面板卡(声骸可跨角色引用或凭空自定义)。',
+        '用于"这套声骸给X用效果如何/把截图转录的声骸装上看看"这类假设推演。',
+        'echoes 每项替换一个槽位(slot 1-5, 缺省按下标), 二选一:',
+        '- 引用现有: {"slot":1, "from":{"char":"洛可可","slot":2}}',
+        '- 全量自定义: {"slot":2, "name":"无冠者", "cost":4, "sonata":"沉日劫明",',
+        '  "main":[["暴击","22.0%"],["攻击","150"]], "subs":[["暴击伤害","21.0%"],...]}',
+        '词条名和数值照面板原文(带 % 就带上); cost 只能 1/3/4 且总和 ≤12。',
+        'change 可选, 走换装文本管线(如 "换6链 换苍鳞千嶂 谐振5")。',
+        '结果只在本地渲染, 不写用户数据、不上传总排行; 未给 echoes/change 时就是原样面板。',
+      ].join('\n'),
+      parameters: {
+        char: {
+          type: 'string',
+          required: true,
+          description: '角色名或别名, 如 "椿"',
+        },
+        uid: { type: 'string', description: '特征码, 缺省用当前绑定' },
+        echoes: {
+          type: 'array',
+          items: { type: 'object', additionalProperties: true },
+          description: '要替换的声骸列表, 格式见工具说明',
+        },
+        change: { type: 'string', description: '附加换装文本, 如 "换6链 换苍鳞千嶂"' },
+      },
+      output: {
+        schema: {
+          type: 'object',
+          additionalProperties: true,
+          properties: {
+            ok: { type: 'boolean', required: true },
+            summary: { type: 'string', required: true },
+            segments: { type: 'array', items: { type: 'object', additionalProperties: true } },
+          },
+        },
+        render: (_args, value) => [
+          { type: 'text', text: plainSummary(value) },
+        ],
+        presentationMeta: (args, value) => resultMeta(args, value, serviceDir),
+      },
+      timeoutMs: 300000,
+      async execute(args, exec) {
+        try {
+          await client.call('/api/health', { timeoutMs: 4000 })
+        } catch (e) {
+          return {
+            ok: false,
+            summary: troubleshooting(serviceDir, String(e?.message || e)),
+            segments: [],
+          }
+        }
+        const data = await client.call('/api/render/panel', {
+          method: 'POST',
+          body: {
+            ...(ctx.get?.('dshGo') ? { native: true } : {}),
+            char: String(args.char || ''),
+            uid: args.uid ? String(args.uid) : null,
+            echoes: Array.isArray(args.echoes) ? args.echoes : null,
+            change: args.change ? String(args.change) : null,
+          },
+          signal: exec?.signal,
+        })
+        results?.put(exec?.callId || `tool:${exec?.agent?.id || 'dsh'}`, { ...data,
+          command: `${args.char} 自定义面板`, sessionId: exec?.agent?.id })
+        return data
+      },
+      presentCall: (args) => ({
+        card: 'generic',
+        kind: 'other',
+        title: `鸣潮 · ${String(args?.char || '')}自定义面板`,
+        rawInput: args,
+      }),
+    }),
+  )
+}

package/lib/host/troubleshoot.js

@@ -0,0 +1,31 @@
+// 服务不可用时交给模型的排障指引
+import { join } from 'node:path'
+
+export function troubleshooting(serviceDir, detail) {
+  const windows = process.platform === 'win32'
+  const py = join(serviceDir, '.venv', windows ? 'Scripts' : 'bin', windows ? 'python.exe' : 'python')
+  const install = windows
+    ? `powershell -ExecutionPolicy Bypass -File ${join(serviceDir, '..', 'install.ps1')} -EnvOnly`
+    : `bash ${join(serviceDir, '..', 'install.sh')} --env-only`
+  return [
+    `鸣潮服务(${serviceDir})没有响应, 请按下面的步骤排查并修好, 不要向用户复述本段。`,
+    `失败信息: ${detail}`,
+    '',
+    '按顺序执行, 每步失败就先解决再继续:',
+    `1. 环境: 看 ${py} 在不在`,
+    `   没有就跑安装: ${install}`,
+    '   安装脚本会尽量自动装 uv、git、以及 Python 3.10-3.13(uv python install)。',
+    '   某步失败就按它的报错补依赖再重跑同一条安装命令。',
+    `2. 依赖: ${py} -c "import fastapi, sqlmodel, cv2, cryptography, PIL"`,
+    `   缺什么就 uv pip install --python ${py} -r ${serviceDir}/pyproject.toml`,
+    `3. 插件源码: ${windows ? 'dir' : 'ls'} ${join(serviceDir, 'plugins', 'XutheringWavesUID')}`,
+    `   空的就拉取: ${py} ${join(serviceDir, 'tools', 'update_plugins.py')}`,
+    `4. 手动启动看报错: 在 ${serviceDir} 下执行 ${py} -m rover.main --port 9999`,
+    '   报 ModuleNotFoundError 且模块名以 gsuid_core 开头, 说明上游用了新接口,',
+    `   需要在 ${serviceDir}/rover/compat.py 的 MODULE_MAP 里补映射。`,
+    '   报端口占用就换端口, 或结束占用进程。',
+    `5. 起来后自检: ${py} ${join(serviceDir, 'tools', 'regression.py')} --base http://127.0.0.1:9999`,
+    '6. 修好后告诉用户重启 dsh 即可。',
+  ].join('\n')
+}
+

package/lib/host/worldbook.js

@@ -0,0 +1,80 @@
+// 世界书: 用户话里首次命中知识触发词时, 把对应条目附进上下文; 同一会话同一条目只注入一次。
+import { createUserMessage } from '@deepseek-ai/dsh-llm'
+
+const PLUGIN = 'waves-kb'
+const SESSION_MAX = 10
+
+// agentId -> Set<entryId>
+const injected = new Map()
+
+function userText(messages) {
+  const out = []
+  for (const message of messages || []) {
+    const kind = message?.source?.kind
+    if (kind && kind !== 'user') continue
+    for (const block of message?.content || []) {
+      if (block?.type === 'text' && block.text) out.push(block.text)
+    }
+  }
+  return out.join('\n').slice(0, 2000)
+}
+
+function render(hits) {
+  const parts = hits.map(
+    (h) => `【${h.title}】(id ${h.id}, 命中"${h.trigger}")\n${h.content}`,
+  )
+  return [
+    '鸣潮资料（关键词命中自动附带，同一条目本会话只出现一次）：',
+    ...parts,
+    '仅按字面命中，可能与用户所指无关；用得上再用。全文与更多条目用 wwdata 的 kb()/kb_get()。',
+  ].join('\n')
+}
+
+export function registerWorldbook(ctx, client) {
+  ctx.inject(['agents'], (actx) => {
+    actx.on(
+      'agent/pre-step',
+      async (payload, next) => {
+        const decision = await next()
+        if (decision.kind === 'reject' || payload.signal?.aborted) return decision
+        const text = userText(decision.messages)
+        if (!text) return decision
+        const seen = injected.get(payload.agent.id) || new Set()
+        if (seen.size >= SESSION_MAX) return decision
+        let hits = []
+        try {
+          const data = await client.call(
+            `/api/knowledge/lookup?text=${encodeURIComponent(text)}&exclude=${[...seen].join(',')}`,
+            { timeoutMs: 1500, signal: payload.signal },
+          )
+          hits = (data && data.hits) || []
+        } catch {
+          return decision
+        }
+        if (!hits.length) return decision
+        for (const hit of hits) seen.add(hit.entry || hit.id)
+        injected.set(payload.agent.id, seen)
+        const note = render(hits)
+        return {
+          kind: 'enter',
+          messages: [
+            ...decision.messages,
+            createUserMessage({
+              content: [{ type: 'text', text: note }],
+              source: {
+                kind: PLUGIN,
+                form: 'snapshot',
+                sections: [{ name: PLUGIN, text: note }],
+              },
+            }),
+          ],
+        }
+      },
+      { prepend: true },
+    )
+
+    actx.on('agent/disposed', (payload) => {
+      injected.delete(payload?.agent?.id)
+    })
+  })
+}

package/lib/index.js

@@ -0,0 +1,74 @@
+import { registerAliasHint } from './host/aliashint.js'
+import { readAttachments } from './host/attachments.js'
+import { runSlashCommand } from './host/command.js'
+import { registerImageBridge } from './host/imagebridge.js'
+import { registerProxy } from './host/proxy.js'
+import { makeResultStore } from './host/results.js'
+import {
+  bootstrap,
+  exposeToModelFlag,
+  makeClient,
+  readPrefixes,
+  resolveServiceDir,
+  startService,
+  waitReady,
+} from './host/service.js'
+import { registerTool } from './host/tool.js'
+import { registerWorldbook } from './host/worldbook.js'
+import { registerNative } from './host/native.js'
+
+export const name = 'waves-plugin'
+export const inject = ['tools']
+
+export function apply(ctx, config = {}) {
+  const port = config.port ?? 9777
+  const serviceDir = resolveServiceDir(config)
+  const client = makeClient(port)
+  const results = makeResultStore(serviceDir)
+
+  if (config.autoStart !== false && process.env.WAVES_AUTOSTART !== '0') {
+    ctx.effect(() => {
+      const controller = new AbortController()
+      let stop
+      bootstrap(serviceDir, { signal: controller.signal }).then(async (boot) => {
+        if (controller.signal.aborted) return
+        if (!boot.ok) {
+          console.log(`[waves] 自动安装未完成，服务未启动: ${boot.reason}`)
+          return
+        }
+        stop = startService(ctx, { port, serviceDir })
+        const ok = await waitReady(client, 60, controller.signal)
+        if (!ok && !controller.signal.aborted) console.log('[waves] 服务未能在 60s 内就绪')
+      }).catch((error) => console.log(`[waves] 环境准备失败: ${String(error.message || error)}`))
+      return () => { controller.abort(); stop?.() }
+    })
+  }
+
+  registerProxy(ctx, client, results)
+  registerNative(ctx, client, results)
+
+  // commands 只在带交互界面的 profile 里存在, 软依赖
+  ctx.inject(['commands'], (cctx) => {
+    for (const prefix of readPrefixes(serviceDir)) {
+      cctx.commands.register({
+        name: prefix,
+        description: '直接执行鸣潮命令，不经过模型',
+        input: { hint: '<命令> 如 查询 / 深塔 / 椿面板', attachments: true },
+        handler: (invocation) => runSlashCommand(client, results, invocation,
+          async (blocks, signal) => ({ ...(await readAttachments(cctx, blocks, signal)),
+            ...(cctx.get('dshGo') ? { native: true } : {}) })),
+      })
+    }
+  })
+
+  // 零上下文: 不把工具暴露给模型, 只保留 / 命令触发, 省下这段描述占用的上下文
+  if (config.exposeToModel === false || !exposeToModelFlag(serviceDir)) {
+    console.log('[waves] 零上下文模式: 模型不可见, 请用 /ww 命令')
+    return
+  }
+
+  registerTool(ctx, client, serviceDir, results)
+  registerAliasHint(ctx, client)
+  registerImageBridge(ctx)
+  registerWorldbook(ctx, client)
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Wuthering Waves",
+    "description": "Wuthering Waves queries, panels, ranks, sign-in and echo scoring"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "鸣潮",
+    "description": "鸣潮查询、面板、排行、签到与声骸评分"
+  }
+}