feat(services): 新增 QQ OneBot 适配器 (services/qq-bot)

pnpm-workspace.yaml

@@ -49,6 +49,7 @@ catalog:
   '@iconify-json/ph': ^1.2.2
   '@iconify-json/tabler': ^1.2.33
   '@intlify/core': ^11.3.2
+  '@libsql/client': ^0.15.15
   '@modelcontextprotocol/sdk': ^1.29.0
   '@moeru/eslint-config': 0.1.0-beta.15
   '@moeru/eventa': 1.0.0-beta.3
@@ -97,6 +98,7 @@ catalog:
   embla-carousel-vue: 9.0.0-rc02
   es-toolkit: 1.43.0
   get-port-please: ^3.2.0
+  gpt-tokenizer: ^3.4.0
   histoire: 1.0.0-beta.1
   hono: 4.11.3
   hono-rate-limiter: ^0.5.3
@@ -116,6 +118,8 @@ catalog:
   pinia: ^3.0.4
   posthog-js: 1.306.1
   splitpanes: ^4.0.4
+  sql.js: ^1.13.0
+  sqlite-vec: ^0.1.7-alpha.2
   std-env: ^4.0.0
   superjson: ^2.2.6
   tsdown: ^0.21.8

services/qq-bot/.github/copilot-instructions.md

@@ -0,0 +1,65 @@
+# Copilot instructions for `services/qq-bot`
+
+## Build, test, and lint commands
+
+Run commands from repo root (`airi`) unless noted.
+
+- Install workspace deps: `pnpm install`
+- Run this service once: `pnpm -F @proj-airi/qq-bot start`
+- Run this service in watch mode: `pnpm -F @proj-airi/qq-bot dev`
+- Typecheck this service: `pnpm -F @proj-airi/qq-bot typecheck`
+
+Repository-level commands (used when validating broader impact):
+
+- Lint all workspaces: `pnpm lint`
+- Auto-fix lint/format: `pnpm lint:fix`
+- Run all tests: `pnpm test:run`
+
+Single test command pattern:
+
+- `pnpm exec vitest run <path/to/test-file>`
+- Example: `pnpm exec vitest run services/qq-bot/src/some-feature.test.ts`
+
+## High-level architecture
+
+This package is a QQ OneBot adapter scaffold built around NapLink and a staged message pipeline.
+
+- `src/config.ts` is the configuration center:
+  - defines `BotConfigSchema` with Valibot,
+  - exports all config types via `v.InferOutput`,
+  - loads YAML and applies env fallback for LLM fields (`LLM_API_BASE_URL`, `LLM_API_KEY`, `LLM_MODEL`).
+- `src/client.ts` is the runtime composition root:
+  - builds `NapLink` client,
+  - wires `Dispatcher -> PipelineRunner`,
+  - normalizes incoming `message.group` / `message.private` events,
+  - runs graceful shutdown (`SIGINT` / `SIGTERM`).
+- `src/types/*` defines protocol-safe internal contracts:
+  - `event.ts`: normalized `QQMessageEvent` and `sessionId` format (`qq:{type}:{id}`),
+  - `context.ts`: pipeline blackboard (`PipelineContext`) and `StageResult`,
+  - `message.ts`: typed message segments with input/output separation,
+  - `response.ts`: discriminated union payloads + fail-fast factory helpers.
+- `src/pipeline/stage.ts` defines the stage base contract and timing/error wrapper.
+- `src/pipeline/extensions.ts` reserves a strongly-typed cross-stage extension area.
+- `src/utils/logger.ts` + `src/utils/naplink-logger-adapter.ts` provide unified logging and NapLink logger bridging.
+
+Design reference for the intended 7-stage pipeline (`Filter -> Wake -> RateLimit -> Session -> Process -> Decorate -> Respond`) is in:
+
+- `Project AIRI — QQ OneBot 适配器设计文档 ... .md`
+
+Current repository status to keep in mind while coding:
+
+- Treat the checked-in source tree as the source of truth.
+
+## Key conventions in this codebase
+
+- Keep config as a single source of truth in Valibot schemas; derive TS types from schemas instead of parallel interfaces.
+- Use explicit discriminated unions (`kind`, `action`, `type`) for pipeline flow and payloads; avoid loosely typed records.
+- Preserve the input/output message segment split:
+  - input may contain `reply` segments,
+  - output payloads must not contain `reply`; use `replyTo` and let dispatch layer inject reply segments.
+- Use `PipelineContext` as the shared stage blackboard; cross-stage extra data belongs in `context.extensions` with typed fields, not ad-hoc metadata.
+- Follow fail-fast helpers in `src/types/response.ts` (throw on invalid empty payloads) instead of silent fallbacks.
+- Keep session identity format consistent: `qq:{sourceType}:{groupId|userId}`.
+- Prefer factory-based assembly for runtime wiring (`createBot`, `createDispatcher`, normalizers, runner) and keep orchestration in composition roots.
+- Route all logs through `createLogger(...)`/`initLoggers(...)`; do not introduce standalone logging patterns.
+- Use `pnpm` workspace filters (`pnpm -F ...`) for service-scoped runs in this monorepo.

services/qq-bot/.gitignore

@@ -0,0 +1,3 @@
+# Ignore the config file and data directory
+config.yaml
+data/*

services/qq-bot/Dockerfile

@@ -0,0 +1,34 @@
+FROM node:22-alpine AS builder
+
+WORKDIR /app
+
+RUN corepack enable
+
+COPY pnpm-lock.yaml pnpm-workspace.yaml package.json tsconfig.json ./
+COPY services/qq-bot/package.json services/qq-bot/tsconfig.json ./services/qq-bot/
+COPY services/qq-bot/src ./services/qq-bot/src
+COPY packages/server-sdk/package.json packages/server-sdk/tsconfig.json ./packages/server-sdk/
+COPY packages/server-sdk/src ./packages/server-sdk/src
+COPY packages/server-shared/package.json packages/server-shared/tsconfig.json ./packages/server-shared/
+COPY packages/server-shared/src ./packages/server-shared/src
+
+RUN pnpm install --frozen-lockfile
+RUN pnpm --filter @proj-airi/qq-bot build
+
+FROM node:22-alpine AS production
+
+WORKDIR /app
+
+RUN corepack enable
+
+COPY pnpm-lock.yaml pnpm-workspace.yaml package.json ./
+COPY services/qq-bot/package.json ./services/qq-bot/package.json
+COPY packages/server-sdk/package.json ./packages/server-sdk/package.json
+COPY packages/server-sdk/src ./packages/server-sdk/src
+COPY packages/server-shared/package.json ./packages/server-shared/package.json
+COPY packages/server-shared/src ./packages/server-shared/src
+COPY --from=builder /app/services/qq-bot/dist ./services/qq-bot/dist
+
+RUN pnpm install --frozen-lockfile --prod
+
+CMD ["node", "services/qq-bot/dist/index.js"]