1

docs/technical/NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md

@@ -11,17 +11,18 @@
 - 承接运行时鉴权
 - 承接运行时持久化
 - 承接运行时 AI 接口
+- 承接编辑器写盘与资产生成工具接口
 - 为 Vite 前端提供开发期代理目标
 
 当前不再使用：
 
-- Vite 本地 API 插件 `scripts/dev-server/`
+- Vite 本地 API 插件 `scripts/dev-server/` 作为当前接口入口
 
 ## 2. 技术栈
 
 - HTTP 框架：`Express`
 - 语言与构建：`TypeScript` + `tsx` + `esbuild`
-- 数据库：`better-sqlite3`
+- 数据库：`PostgreSQL`
 - JWT：`jose`
 - 密码哈希：`@node-rs/argon2`
 - 日志：`pino` + `pino-http` + `pino-roll`
@@ -31,12 +32,13 @@
 推荐命令：
 
 ```bash
-npm run dev:node
+npm run dev
 ```
 
 相关脚本：
 
-- 根目录联调：`npm run dev:node`
+- 根目录联调：`npm run dev` / `npm run dev:node`
+- 仅前端开发：`npm run dev:web`
 - 单独启动后端开发模式：`npm run server-node:dev`
 - 构建后端：`npm run server-node:build`
 - 运行后端测试：`npm run server-node:test`
@@ -57,6 +59,9 @@ npm run dev:node
 
 - `server-node/src/routes/authRoutes.ts`
 - `server-node/src/routes/runtimeRoutes.ts`
+- `server-node/src/modules/editor/editorRoutes.ts`
+- `server-node/src/modules/assets/characterAssetRoutes.ts`
+- `server-node/src/modules/assets/qwenSpriteRoutes.ts`
 
 基础设施：
 
@@ -102,8 +107,12 @@ JWT 现状：
 
 当前数据库：
 
-- 默认 SQLite 文件：`server-node/data/genarrative.sqlite`
-- 可通过 `SQLITE_PATH` 覆盖
+- 当前运行时持久化已切换到 `PostgreSQL`
+- 连接信息由后端 `DATABASE_URL` 环境变量注入
+- 不再以本地 `SQLite` 文件作为正式运行时数据库
+- 后端测试默认使用 `pg-mem` 作为内存级 PostgreSQL 兼容实现
+- 基础表初始化通过 `schema_migrations` 基线管理
+- 可通过 `npm run server-node:db:migrate` 主动校验并补齐数据库基线
 
 当前核心表：
 
@@ -153,6 +162,33 @@ JWT 现状：
 - `POST /api/runtime/items/runtime-intent`
 - `POST /api/runtime/quests/generate`
 
+编辑器工具：
+
+- `GET /api/editor/catalog/items`
+- `GET /api/editor/json/:resourceId`
+- `POST /api/editor/json/:resourceId`
+
+资产工具：
+
+- `POST /api/assets/character-visual/generate`
+- `POST /api/assets/character-visual/publish`
+- `GET /api/assets/character-visual/jobs/:taskId`
+- `POST /api/assets/character-animation/generate`
+- `POST /api/assets/character-animation/publish`
+- `GET /api/assets/character-animation/jobs/:taskId`
+- `POST /api/assets/character-animation/import-video`
+- `GET /api/assets/character-animation/templates`
+- `POST /api/assets/qwen-sprite/master`
+- `POST /api/assets/qwen-sprite/sheet`
+- `POST /api/assets/qwen-sprite/frame-repair`
+- `POST /api/assets/qwen-sprite/save`
+
+编辑器与资产接口门禁：
+
+- `EDITOR_API_ENABLED` 控制 `/api/editor/*`
+- `ASSETS_API_ENABLED` 控制 `/api/assets/*`
+- 非生产环境默认开启，生产环境默认关闭
+
 ## 8. Story 与 Custom World 现状
 
 Story：
@@ -179,6 +215,13 @@ Custom World：
 - `src/services/storageService.ts`
 - `src/services/aiService.ts`
 
+编辑器与资产工具层：
+
+- `src/editor/shared/editorApiClient.ts`
+- `src/editor/shared/useJsonSave.ts`
+- `src/components/preset-editor/characterAssetStudioPersistence.ts`
+- `src/tools/qwenSpriteSheetToolPersistence.ts`
+
 ## 10. 当前 Vite 角色
 
 Vite 当前只负责代理，不再提供本地 API 插件。
@@ -187,8 +230,12 @@ Vite 当前只负责代理，不再提供本地 API 插件。
 
 - `/api/auth`
 - `/api/runtime`
+- `/api/editor`
+- `/api/assets`
 - `/api/llm`
 - `/api/custom-world/scene-image`
 - `/api/ws`
 
 全部转发到 Node 后端。
+
+旧 `scripts/dev-server/**` 文件仅保留为迁移参考，不再由 `vite.config.ts` 注入。