2251 lines
76 KiB
JSON
2251 lines
76 KiB
JSON
{
|
||
"generatedAt": "2026-04-20T14:26:38.663Z",
|
||
"manifestVersion": "2026-04-20",
|
||
"generatedCommand": "npm run server-node:manifest:backend",
|
||
"outputTargets": {
|
||
"json": "server-node/manifests/backend-capability-index.json",
|
||
"markdown": "docs/technical/NODE_BACKEND_MODULE_AND_API_INDEX.md"
|
||
},
|
||
"summary": {
|
||
"surfaceCount": 6,
|
||
"routeCount": 96,
|
||
"moduleCount": 12,
|
||
"publicRouteCount": 10,
|
||
"jwtRouteCount": 69,
|
||
"envSwitchRouteCount": 17,
|
||
"streamRouteCount": 6
|
||
},
|
||
"surfaces": [
|
||
{
|
||
"id": "assets",
|
||
"title": "资产生成工具面",
|
||
"mounts": [
|
||
{
|
||
"entryFile": "server-node/src/app.ts",
|
||
"mountPath": "/api/assets",
|
||
"routeFactory": "createCharacterAssetRoutes"
|
||
},
|
||
{
|
||
"entryFile": "server-node/src/app.ts",
|
||
"mountPath": "/api/assets/qwen-sprite",
|
||
"routeFactory": "createQwenSpriteRoutes"
|
||
}
|
||
],
|
||
"responsibilities": [
|
||
"生成角色主形象、动作、动作模板与工作流缓存。",
|
||
"承接 Qwen 精灵表主图、整表、修帧与保存链路。",
|
||
"把产物发布到 `public/generated-*` 目录并落地局部 manifest。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"负责对接 DashScope、Ark 等外部媒体供应商，但不维护 runtime 快照与业务状态。",
|
||
"统一受 `ASSETS_API_ENABLED` 开关控制，产物以文件与 JSON manifest 形式落在仓库工作区。"
|
||
],
|
||
"relatedModuleIds": [
|
||
"assets"
|
||
],
|
||
"routeCount": 14,
|
||
"routeIds": [
|
||
"assets.characterAnimationGenerate",
|
||
"assets.characterAnimationImportVideo",
|
||
"assets.characterAnimationJobGet",
|
||
"assets.characterAnimationPublish",
|
||
"assets.characterAnimationTemplatesList",
|
||
"assets.characterVisualGenerate",
|
||
"assets.characterVisualJobGet",
|
||
"assets.characterVisualPublish",
|
||
"assets.characterWorkflowCacheSave",
|
||
"assets.characterWorkflowCacheGet",
|
||
"assets.qwenSpriteFrameRepairGenerate",
|
||
"assets.qwenSpriteMasterGenerate",
|
||
"assets.qwenSpriteAssetSave",
|
||
"assets.qwenSpriteSheetGenerate"
|
||
]
|
||
},
|
||
{
|
||
"id": "auth",
|
||
"title": "鉴权与会话面",
|
||
"mounts": [
|
||
{
|
||
"entryFile": "server-node/src/app.ts",
|
||
"mountPath": "/api/auth",
|
||
"routeFactory": "createAuthRoutes"
|
||
}
|
||
],
|
||
"responsibilities": [
|
||
"承接本地账号、短信验证码与微信登录流程。",
|
||
"管理 refresh session、用户信息、会话吊销、审计日志与风险拦截。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"HTTP 层只做 schema 校验、请求上下文拼装与 Cookie 管理，核心鉴权逻辑统一收口到 `server-node/src/auth/*`。",
|
||
"用户、身份、会话、风控与短信事件等持久化职责全部下沉到 repository 层，避免路由直接碰数据库细节。"
|
||
],
|
||
"relatedModuleIds": [],
|
||
"routeCount": 17,
|
||
"routeIds": [
|
||
"auth.auditLogs",
|
||
"auth.entry",
|
||
"auth.loginOptions",
|
||
"auth.logout",
|
||
"auth.logoutAll",
|
||
"auth.me",
|
||
"auth.phoneChange",
|
||
"auth.phoneLogin",
|
||
"auth.phoneSendCode",
|
||
"auth.refresh",
|
||
"auth.riskBlocks",
|
||
"auth.riskBlocksLift",
|
||
"auth.sessions",
|
||
"auth.sessionRevoke",
|
||
"auth.wechatBindPhone",
|
||
"auth.wechatCallback",
|
||
"auth.wechatStart"
|
||
]
|
||
},
|
||
{
|
||
"id": "editor",
|
||
"title": "编辑器工具面",
|
||
"mounts": [
|
||
{
|
||
"entryFile": "server-node/src/app.ts",
|
||
"mountPath": "/api/editor",
|
||
"routeFactory": "createEditorRoutes"
|
||
}
|
||
],
|
||
"responsibilities": [
|
||
"读取编辑器资源 JSON。",
|
||
"回写编辑器覆盖文件。",
|
||
"枚举 `public/Icons` 下的物品图标资源。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"只对工作区文件系统与 `public` 目录负责，不参与运行时数据库存储。",
|
||
"统一受 `EDITOR_API_ENABLED` 开关控制，生产环境可按需关闭。"
|
||
],
|
||
"relatedModuleIds": [
|
||
"editor"
|
||
],
|
||
"routeCount": 3,
|
||
"routeIds": [
|
||
"editor.catalogItems",
|
||
"editor.resourceRead",
|
||
"editor.resourceWrite"
|
||
]
|
||
},
|
||
{
|
||
"id": "health",
|
||
"title": "基础健康检查",
|
||
"mounts": [
|
||
{
|
||
"entryFile": "server-node/src/app.ts",
|
||
"mountPath": "/healthz",
|
||
"routeFactory": "createApp"
|
||
}
|
||
],
|
||
"responsibilities": [
|
||
"提供 Node 后端进程级健康探针。",
|
||
"给反向代理、部署平台和本地联调提供最小可用状态确认。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"只返回服务静态信息，不触达数据库、鉴权或外部模型供应商。"
|
||
],
|
||
"relatedModuleIds": [],
|
||
"routeCount": 1,
|
||
"routeIds": [
|
||
"health.check"
|
||
]
|
||
},
|
||
{
|
||
"id": "runtime-main",
|
||
"title": "运行时主能力面",
|
||
"mounts": [
|
||
{
|
||
"entryFile": "server-node/src/app.ts",
|
||
"mountPath": "/api",
|
||
"routeFactory": "createRuntimeRoutes"
|
||
},
|
||
{
|
||
"entryFile": "server-node/src/routes/runtimeRoutes.ts",
|
||
"mountPath": "/runtime/custom-world/agent",
|
||
"routeFactory": "createCustomWorldAgentRoutes"
|
||
}
|
||
],
|
||
"responsibilities": [
|
||
"承接运行时资料库、公开画廊、存档、设置与个人档案接口。",
|
||
"承接剧情生成、聊天流、任务生成、运行时物品意图与自定义世界链路。",
|
||
"承接 Custom World Agent 会话、消息流和操作回放。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"HTTP contract 收口在 `runtimeRoutes.ts`，真正的世界生成、剧情、聊天、任务和资源逻辑继续下沉到 `services/*` 与 `src/modules/*`。",
|
||
"除公开画廊外，运行时接口统一走 JWT 鉴权，并依赖 `runtimeRepository`、session store 与 LLM client 执行。"
|
||
],
|
||
"relatedModuleIds": [
|
||
"ai",
|
||
"custom-world",
|
||
"quest",
|
||
"runtime",
|
||
"runtime-item",
|
||
"story"
|
||
],
|
||
"routeCount": 59,
|
||
"routeIds": [
|
||
"runtime.customWorldCoverImage",
|
||
"runtime.customWorldCoverUpload",
|
||
"runtime.customWorldEntity.primary",
|
||
"runtime.customWorldSceneImage",
|
||
"runtime.customWorldSceneNpc.primary",
|
||
"runtime.llmChatCompletionsProxy",
|
||
"runtime.profileBrowseHistoryDelete.primary",
|
||
"runtime.profileBrowseHistoryGet.primary",
|
||
"runtime.profileBrowseHistoryPost.primary",
|
||
"runtime.profileDashboard.primary",
|
||
"runtime.profilePlayStats.primary",
|
||
"runtime.profileSaveArchivesList.primary",
|
||
"runtime.profileSaveArchivesResume.primary",
|
||
"runtime.profileWalletLedger.primary",
|
||
"runtime.characterReplyStream",
|
||
"runtime.characterSuggestions",
|
||
"runtime.characterSummary",
|
||
"runtime.npcDialogueStream",
|
||
"runtime.npcRecruitStream",
|
||
"runtime.npcTurnStream",
|
||
"runtime.customWorldGalleryList",
|
||
"runtime.customWorldGalleryDetail",
|
||
"runtime.customWorldLibraryList",
|
||
"runtime.customWorldLibraryDelete",
|
||
"runtime.customWorldLibraryUpsert",
|
||
"runtime.customWorldLibraryPublish",
|
||
"runtime.customWorldLibraryUnpublish",
|
||
"runtime.customWorldAgentCreateSession",
|
||
"runtime.customWorldAgentGetSession",
|
||
"runtime.customWorldAgentExecuteAction",
|
||
"runtime.customWorldAgentGetCardDetail",
|
||
"runtime.customWorldAgentSendMessage",
|
||
"runtime.customWorldAgentStreamMessage",
|
||
"runtime.customWorldAgentGetOperation",
|
||
"runtime.customWorldEntity.compat",
|
||
"runtime.customWorldSceneNpc.compat",
|
||
"runtime.customWorldSessionCreate",
|
||
"runtime.customWorldSessionGet",
|
||
"runtime.customWorldSessionAnswer",
|
||
"runtime.customWorldSessionGenerateStream",
|
||
"runtime.customWorldWorksList",
|
||
"runtime.itemsIntent",
|
||
"runtime.profileBrowseHistoryDelete.compat",
|
||
"runtime.profileBrowseHistoryGet.compat",
|
||
"runtime.profileBrowseHistoryPost.compat",
|
||
"runtime.profileDashboard.compat",
|
||
"runtime.profilePlayStats.compat",
|
||
"runtime.profileSaveArchivesList.compat",
|
||
"runtime.profileSaveArchivesResume.compat",
|
||
"runtime.profileWalletLedger.compat",
|
||
"runtime.questsGenerate",
|
||
"runtime.snapshotDelete",
|
||
"runtime.snapshotGet",
|
||
"runtime.snapshotPut",
|
||
"runtime.settingsGet",
|
||
"runtime.settingsPut",
|
||
"runtime.storyContinue",
|
||
"runtime.storyInitial",
|
||
"runtime.wsHealth"
|
||
]
|
||
},
|
||
{
|
||
"id": "runtime-story-action",
|
||
"title": "运行时 Story Action 面",
|
||
"mounts": [
|
||
{
|
||
"entryFile": "server-node/src/app.ts",
|
||
"mountPath": "/api/runtime/story",
|
||
"routeFactory": "createStoryActionRoutes"
|
||
}
|
||
],
|
||
"responsibilities": [
|
||
"把前端 story choice 动作解析为新的运行时状态。",
|
||
"查询指定 story session 的可恢复状态。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"路由层只做鉴权与 schema 校验，真正的动作分发与跨模块协作集中在 `storyActionService.ts`。",
|
||
"Story Action 会联动 quest、inventory、runtime-item、npc 等内部模块，但对前端只暴露 story 这一条稳定入口。"
|
||
],
|
||
"relatedModuleIds": [
|
||
"story",
|
||
"quest",
|
||
"inventory",
|
||
"runtime-item",
|
||
"npc",
|
||
"progression",
|
||
"combat",
|
||
"runtime"
|
||
],
|
||
"routeCount": 2,
|
||
"routeIds": [
|
||
"storyAction.resolve",
|
||
"storyAction.stateGet"
|
||
]
|
||
}
|
||
],
|
||
"modules": [
|
||
{
|
||
"id": "ai",
|
||
"title": "AI 编排模块",
|
||
"directory": "server-node/src/modules/ai",
|
||
"exposedBySurfaceIds": [
|
||
"runtime-main"
|
||
],
|
||
"responsibilities": [
|
||
"统一剧情、多轮聊天与自定义世界编排器的 prompt 构造与输出归一化。",
|
||
"屏蔽前端对不同 AI 链路的直接拼装细节。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"专注提示词与编排，不负责持久化与 HTTP 传输。",
|
||
"通过 `services/llmClient.ts` 与外部模型交互，由路由与 service 层决定何时调用。"
|
||
],
|
||
"keyFiles": [
|
||
"server-node/src/modules/ai/chatOrchestrator.ts",
|
||
"server-node/src/modules/ai/customWorldOrchestrator.ts",
|
||
"server-node/src/modules/ai/storyOrchestrator.ts"
|
||
],
|
||
"routeCount": 23,
|
||
"routeIds": [
|
||
"runtime.customWorldEntity.primary",
|
||
"runtime.customWorldSceneNpc.primary",
|
||
"runtime.llmChatCompletionsProxy",
|
||
"runtime.characterReplyStream",
|
||
"runtime.characterSuggestions",
|
||
"runtime.characterSummary",
|
||
"runtime.npcDialogueStream",
|
||
"runtime.npcRecruitStream",
|
||
"runtime.npcTurnStream",
|
||
"runtime.customWorldAgentCreateSession",
|
||
"runtime.customWorldAgentGetSession",
|
||
"runtime.customWorldAgentExecuteAction",
|
||
"runtime.customWorldAgentGetCardDetail",
|
||
"runtime.customWorldAgentSendMessage",
|
||
"runtime.customWorldAgentStreamMessage",
|
||
"runtime.customWorldAgentGetOperation",
|
||
"runtime.customWorldEntity.compat",
|
||
"runtime.customWorldSceneNpc.compat",
|
||
"runtime.customWorldSessionGenerateStream",
|
||
"runtime.itemsIntent",
|
||
"runtime.questsGenerate",
|
||
"runtime.storyContinue",
|
||
"runtime.storyInitial"
|
||
]
|
||
},
|
||
{
|
||
"id": "assets",
|
||
"title": "资产工具模块",
|
||
"directory": "server-node/src/modules/assets",
|
||
"exposedBySurfaceIds": [
|
||
"assets"
|
||
],
|
||
"responsibilities": [
|
||
"承接角色资产与 Qwen 精灵表的生成、查询、发布和保存。",
|
||
"维护资产流程需要的缓存、草稿与产物 manifest。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"以文件系统和外部媒体模型为主要边界，不碰 runtimeRepository。",
|
||
"对外暴露稳定 HTTP 路径，对内通过私有 helper 处理媒体编码、任务轮询与写盘。"
|
||
],
|
||
"keyFiles": [
|
||
"server-node/src/modules/assets/characterAssetRoutes.ts",
|
||
"server-node/src/modules/assets/qwenSpriteRoutes.ts"
|
||
],
|
||
"routeCount": 18,
|
||
"routeIds": [
|
||
"assets.characterAnimationGenerate",
|
||
"assets.characterAnimationImportVideo",
|
||
"assets.characterAnimationJobGet",
|
||
"assets.characterAnimationPublish",
|
||
"assets.characterAnimationTemplatesList",
|
||
"assets.characterVisualGenerate",
|
||
"assets.characterVisualJobGet",
|
||
"assets.characterVisualPublish",
|
||
"assets.characterWorkflowCacheSave",
|
||
"assets.characterWorkflowCacheGet",
|
||
"assets.qwenSpriteFrameRepairGenerate",
|
||
"assets.qwenSpriteMasterGenerate",
|
||
"assets.qwenSpriteAssetSave",
|
||
"assets.qwenSpriteSheetGenerate",
|
||
"runtime.customWorldCoverImage",
|
||
"runtime.customWorldCoverUpload",
|
||
"runtime.customWorldSceneImage",
|
||
"runtime.customWorldAgentExecuteAction"
|
||
]
|
||
},
|
||
{
|
||
"id": "combat",
|
||
"title": "战斗结算模块",
|
||
"directory": "server-node/src/modules/combat",
|
||
"exposedBySurfaceIds": [
|
||
"runtime-story-action"
|
||
],
|
||
"responsibilities": [
|
||
"提供运行时战斗结算与数值变更能力。",
|
||
"为 story action 里的战斗型交互提供纯计算服务。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"聚焦状态推导与结果计算，不负责 transport 与持久化。"
|
||
],
|
||
"keyFiles": [
|
||
"server-node/src/modules/combat/combatResolutionService.ts"
|
||
],
|
||
"routeCount": 1,
|
||
"routeIds": [
|
||
"storyAction.resolve"
|
||
]
|
||
},
|
||
{
|
||
"id": "custom-world",
|
||
"title": "自定义世界运行时模块",
|
||
"directory": "server-node/src/modules/custom-world",
|
||
"exposedBySurfaceIds": [
|
||
"runtime-main"
|
||
],
|
||
"responsibilities": [
|
||
"规范 creator intent、世界运行时类型与 profile compile。",
|
||
"把世界创作输入整理成运行时可消费的数据结构。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"偏纯领域建模与 compile，不直接做 HTTP、数据库查询或模型调用。"
|
||
],
|
||
"keyFiles": [
|
||
"server-node/src/modules/custom-world/creatorIntentRuntime.ts",
|
||
"server-node/src/modules/custom-world/runtimeProfile.ts",
|
||
"server-node/src/modules/custom-world/runtimeTypes.ts"
|
||
],
|
||
"routeCount": 26,
|
||
"routeIds": [
|
||
"runtime.customWorldCoverImage",
|
||
"runtime.customWorldCoverUpload",
|
||
"runtime.customWorldEntity.primary",
|
||
"runtime.customWorldSceneImage",
|
||
"runtime.customWorldSceneNpc.primary",
|
||
"runtime.customWorldGalleryList",
|
||
"runtime.customWorldGalleryDetail",
|
||
"runtime.customWorldLibraryList",
|
||
"runtime.customWorldLibraryDelete",
|
||
"runtime.customWorldLibraryUpsert",
|
||
"runtime.customWorldLibraryPublish",
|
||
"runtime.customWorldLibraryUnpublish",
|
||
"runtime.customWorldAgentCreateSession",
|
||
"runtime.customWorldAgentGetSession",
|
||
"runtime.customWorldAgentExecuteAction",
|
||
"runtime.customWorldAgentGetCardDetail",
|
||
"runtime.customWorldAgentSendMessage",
|
||
"runtime.customWorldAgentStreamMessage",
|
||
"runtime.customWorldAgentGetOperation",
|
||
"runtime.customWorldEntity.compat",
|
||
"runtime.customWorldSceneNpc.compat",
|
||
"runtime.customWorldSessionCreate",
|
||
"runtime.customWorldSessionGet",
|
||
"runtime.customWorldSessionAnswer",
|
||
"runtime.customWorldSessionGenerateStream",
|
||
"runtime.customWorldWorksList"
|
||
]
|
||
},
|
||
{
|
||
"id": "editor",
|
||
"title": "编辑器资源模块",
|
||
"directory": "server-node/src/modules/editor",
|
||
"exposedBySurfaceIds": [
|
||
"editor"
|
||
],
|
||
"responsibilities": [
|
||
"提供编辑器资源目录枚举与 JSON 读写入口。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"只负责工作区文件输入输出，不参与运行时业务计算。"
|
||
],
|
||
"keyFiles": [
|
||
"server-node/src/modules/editor/editorRoutes.ts"
|
||
],
|
||
"routeCount": 3,
|
||
"routeIds": [
|
||
"editor.catalogItems",
|
||
"editor.resourceRead",
|
||
"editor.resourceWrite"
|
||
]
|
||
},
|
||
{
|
||
"id": "inventory",
|
||
"title": "背包与物品变更模块",
|
||
"directory": "server-node/src/modules/inventory",
|
||
"exposedBySurfaceIds": [
|
||
"runtime-story-action"
|
||
],
|
||
"responsibilities": [
|
||
"维护背包变更、NPC 背包交互与 story action 里的物品副作用。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"对运行时状态做局部变更，不直接暴露 HTTP 路由。"
|
||
],
|
||
"keyFiles": [
|
||
"server-node/src/modules/inventory/inventoryMutationService.ts",
|
||
"server-node/src/modules/inventory/inventoryStoryActionService.ts",
|
||
"server-node/src/modules/inventory/npcInventoryStoryActionService.ts"
|
||
],
|
||
"routeCount": 1,
|
||
"routeIds": [
|
||
"storyAction.resolve"
|
||
]
|
||
},
|
||
{
|
||
"id": "npc",
|
||
"title": "NPC 交互模块",
|
||
"directory": "server-node/src/modules/npc",
|
||
"exposedBySurfaceIds": [
|
||
"runtime-story-action",
|
||
"runtime-main"
|
||
],
|
||
"responsibilities": [
|
||
"维护 NPC 互动规则、任务 primitive 与关系变更逻辑。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"专注 NPC 侧状态推导，供 story action 与聊天/任务链路复用。"
|
||
],
|
||
"keyFiles": [
|
||
"server-node/src/modules/npc/npcInteractionService.ts",
|
||
"server-node/src/modules/npc/npcTask6Primitives.ts"
|
||
],
|
||
"routeCount": 6,
|
||
"routeIds": [
|
||
"runtime.customWorldSceneNpc.primary",
|
||
"runtime.npcDialogueStream",
|
||
"runtime.npcRecruitStream",
|
||
"runtime.npcTurnStream",
|
||
"runtime.customWorldSceneNpc.compat",
|
||
"storyAction.resolve"
|
||
]
|
||
},
|
||
{
|
||
"id": "progression",
|
||
"title": "成长与关卡进程模块",
|
||
"directory": "server-node/src/modules/progression",
|
||
"exposedBySurfaceIds": [
|
||
"runtime-story-action",
|
||
"runtime-main"
|
||
],
|
||
"responsibilities": [
|
||
"提供角色成长、敌对等级、章节推进与 benchmark 逻辑。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"只做成长数值与章节进度计算，由 runtime hydrate 与 story action 复用。"
|
||
],
|
||
"keyFiles": [
|
||
"server-node/src/modules/progression/playerProgressionService.ts",
|
||
"server-node/src/modules/progression/hostileProgressionService.ts",
|
||
"server-node/src/modules/progression/chapterProgressionPlanner.ts"
|
||
],
|
||
"routeCount": 3,
|
||
"routeIds": [
|
||
"runtime.snapshotGet",
|
||
"runtime.snapshotPut",
|
||
"storyAction.resolve"
|
||
]
|
||
},
|
||
{
|
||
"id": "quest",
|
||
"title": "任务运行时模块",
|
||
"directory": "server-node/src/modules/quest",
|
||
"exposedBySurfaceIds": [
|
||
"runtime-main",
|
||
"runtime-story-action"
|
||
],
|
||
"responsibilities": [
|
||
"生成任务意图、维护任务日志与处理任务进度信号。",
|
||
"为运行时 quest 接口与 story action 提供统一任务语义。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"领域逻辑以 quest module 为中心，AI 生成只是一种输入来源。",
|
||
"不直接处理 HTTP 响应，统一由 routes/service 层调用。"
|
||
],
|
||
"keyFiles": [
|
||
"server-node/src/modules/quest/runtimeQuestModule.ts",
|
||
"server-node/src/modules/quest/questProgressionService.ts",
|
||
"server-node/src/modules/quest/questStoryActionService.ts"
|
||
],
|
||
"routeCount": 4,
|
||
"routeIds": [
|
||
"runtime.questsGenerate",
|
||
"runtime.snapshotGet",
|
||
"runtime.snapshotPut",
|
||
"storyAction.resolve"
|
||
]
|
||
},
|
||
{
|
||
"id": "runtime",
|
||
"title": "运行时状态基座模块",
|
||
"directory": "server-node/src/modules/runtime",
|
||
"exposedBySurfaceIds": [
|
||
"runtime-main",
|
||
"runtime-story-action"
|
||
],
|
||
"responsibilities": [
|
||
"定义运行时状态 primitive、经济与装备规则。",
|
||
"负责存档 hydration、兼容迁移与状态归一化。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"是 runtimeRepository 与 story action 的共同状态基座，不承担 HTTP 入口职责。"
|
||
],
|
||
"keyFiles": [
|
||
"server-node/src/modules/runtime/runtimeSnapshotHydration.ts",
|
||
"server-node/src/modules/runtime/runtimeStatePrimitives.ts",
|
||
"server-node/src/modules/runtime/runtimeEquipmentModule.ts"
|
||
],
|
||
"routeCount": 32,
|
||
"routeIds": [
|
||
"runtime.profileBrowseHistoryDelete.primary",
|
||
"runtime.profileBrowseHistoryGet.primary",
|
||
"runtime.profileBrowseHistoryPost.primary",
|
||
"runtime.profileDashboard.primary",
|
||
"runtime.profilePlayStats.primary",
|
||
"runtime.profileSaveArchivesList.primary",
|
||
"runtime.profileSaveArchivesResume.primary",
|
||
"runtime.profileWalletLedger.primary",
|
||
"runtime.customWorldGalleryList",
|
||
"runtime.customWorldGalleryDetail",
|
||
"runtime.customWorldLibraryList",
|
||
"runtime.customWorldLibraryDelete",
|
||
"runtime.customWorldLibraryUpsert",
|
||
"runtime.customWorldLibraryPublish",
|
||
"runtime.customWorldLibraryUnpublish",
|
||
"runtime.customWorldWorksList",
|
||
"runtime.profileBrowseHistoryDelete.compat",
|
||
"runtime.profileBrowseHistoryGet.compat",
|
||
"runtime.profileBrowseHistoryPost.compat",
|
||
"runtime.profileDashboard.compat",
|
||
"runtime.profilePlayStats.compat",
|
||
"runtime.profileSaveArchivesList.compat",
|
||
"runtime.profileSaveArchivesResume.compat",
|
||
"runtime.profileWalletLedger.compat",
|
||
"runtime.snapshotDelete",
|
||
"runtime.snapshotGet",
|
||
"runtime.snapshotPut",
|
||
"runtime.settingsGet",
|
||
"runtime.settingsPut",
|
||
"storyAction.resolve",
|
||
"storyAction.stateGet",
|
||
"runtime.wsHealth"
|
||
]
|
||
},
|
||
{
|
||
"id": "runtime-item",
|
||
"title": "运行时物品模块",
|
||
"directory": "server-node/src/modules/runtime-item",
|
||
"exposedBySurfaceIds": [
|
||
"runtime-main",
|
||
"runtime-story-action"
|
||
],
|
||
"responsibilities": [
|
||
"生成运行时物品意图、物品奖励与剧情指纹。",
|
||
"维护宝藏与物品解析逻辑。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"聚焦物品领域编译与奖励拼装，由 route/service 选择具体触发时机。"
|
||
],
|
||
"keyFiles": [
|
||
"server-node/src/modules/runtime-item/runtimeItemModule.ts",
|
||
"server-node/src/modules/runtime-item/runtimeItemResolutionService.ts",
|
||
"server-node/src/modules/runtime-item/treasureStoryActionService.ts"
|
||
],
|
||
"routeCount": 2,
|
||
"routeIds": [
|
||
"runtime.itemsIntent",
|
||
"storyAction.resolve"
|
||
]
|
||
},
|
||
{
|
||
"id": "story",
|
||
"title": "故事会话模块",
|
||
"directory": "server-node/src/modules/story",
|
||
"exposedBySurfaceIds": [
|
||
"runtime-main",
|
||
"runtime-story-action"
|
||
],
|
||
"responsibilities": [
|
||
"维护运行时故事会话状态与 action 分发。",
|
||
"为 story resolve、story state 查询提供统一入口。"
|
||
],
|
||
"primaryServiceBoundaries": [
|
||
"story 模块是 runtime 主循环的编排层，必要时再向 quest、inventory、combat 等领域模块分发。"
|
||
],
|
||
"keyFiles": [
|
||
"server-node/src/modules/story/runtimeSession.ts",
|
||
"server-node/src/modules/story/storyActionRoutes.ts",
|
||
"server-node/src/modules/story/storyActionService.ts"
|
||
],
|
||
"routeCount": 10,
|
||
"routeIds": [
|
||
"runtime.characterReplyStream",
|
||
"runtime.characterSuggestions",
|
||
"runtime.characterSummary",
|
||
"runtime.npcDialogueStream",
|
||
"runtime.npcRecruitStream",
|
||
"runtime.npcTurnStream",
|
||
"storyAction.resolve",
|
||
"runtime.storyContinue",
|
||
"runtime.storyInitial",
|
||
"storyAction.stateGet"
|
||
]
|
||
}
|
||
],
|
||
"routes": [
|
||
{
|
||
"id": "assets.characterAnimationGenerate",
|
||
"group": "assets-character-animation",
|
||
"method": "POST",
|
||
"path": "/api/assets/character-animation/generate",
|
||
"operation": "assets.character.animation.generate",
|
||
"access": "开关: ASSETS_API_ENABLED",
|
||
"responseMode": "json",
|
||
"summary": "生成角色动作草稿。",
|
||
"domainModuleIds": [
|
||
"assets"
|
||
],
|
||
"sourceHint": "assets.character.animation.generate",
|
||
"surfaceId": "assets",
|
||
"sourceFile": "server-node/src/modules/assets/characterAssetRoutes.ts"
|
||
},
|
||
{
|
||
"id": "assets.characterAnimationImportVideo",
|
||
"group": "assets-character-animation",
|
||
"method": "POST",
|
||
"path": "/api/assets/character-animation/import-video",
|
||
"operation": "assets.character.animation.importVideo",
|
||
"access": "开关: ASSETS_API_ENABLED",
|
||
"responseMode": "json",
|
||
"summary": "导入动作参考视频并转为可消费素材。",
|
||
"domainModuleIds": [
|
||
"assets"
|
||
],
|
||
"sourceHint": "assets.character.animation.importVideo",
|
||
"surfaceId": "assets",
|
||
"sourceFile": "server-node/src/modules/assets/characterAssetRoutes.ts"
|
||
},
|
||
{
|
||
"id": "assets.characterAnimationJobGet",
|
||
"group": "assets-character-animation",
|
||
"method": "GET",
|
||
"path": "/api/assets/character-animation/jobs/:taskId",
|
||
"operation": "assets.character.animation.job.get",
|
||
"access": "开关: ASSETS_API_ENABLED",
|
||
"responseMode": "json",
|
||
"summary": "查询角色动作生成任务状态。",
|
||
"domainModuleIds": [
|
||
"assets"
|
||
],
|
||
"sourceHint": "assets.character.animation.job.get",
|
||
"surfaceId": "assets",
|
||
"sourceFile": "server-node/src/modules/assets/characterAssetRoutes.ts"
|
||
},
|
||
{
|
||
"id": "assets.characterAnimationPublish",
|
||
"group": "assets-character-animation",
|
||
"method": "POST",
|
||
"path": "/api/assets/character-animation/publish",
|
||
"operation": "assets.character.animation.publish",
|
||
"access": "开关: ASSETS_API_ENABLED",
|
||
"responseMode": "json",
|
||
"summary": "发布角色动作帧集到 public 目录。",
|
||
"domainModuleIds": [
|
||
"assets"
|
||
],
|
||
"sourceHint": "assets.character.animation.publish",
|
||
"surfaceId": "assets",
|
||
"sourceFile": "server-node/src/modules/assets/characterAssetRoutes.ts"
|
||
},
|
||
{
|
||
"id": "assets.characterAnimationTemplatesList",
|
||
"group": "assets-character-animation",
|
||
"method": "GET",
|
||
"path": "/api/assets/character-animation/templates",
|
||
"operation": "assets.character.animation.templates.list",
|
||
"access": "开关: ASSETS_API_ENABLED",
|
||
"responseMode": "json",
|
||
"summary": "列出内置角色动作模板。",
|
||
"domainModuleIds": [
|
||
"assets"
|
||
],
|
||
"sourceHint": "assets.character.animation.templates.list",
|
||
"surfaceId": "assets",
|
||
"sourceFile": "server-node/src/modules/assets/characterAssetRoutes.ts"
|
||
},
|
||
{
|
||
"id": "assets.characterVisualGenerate",
|
||
"group": "assets-character-visual",
|
||
"method": "POST",
|
||
"path": "/api/assets/character-visual/generate",
|
||
"operation": "assets.character.visual.generate",
|
||
"access": "开关: ASSETS_API_ENABLED",
|
||
"responseMode": "json",
|
||
"summary": "生成角色主形象候选图。",
|
||
"domainModuleIds": [
|
||
"assets"
|
||
],
|
||
"sourceHint": "assets.character.visual.generate",
|
||
"surfaceId": "assets",
|
||
"sourceFile": "server-node/src/modules/assets/characterAssetRoutes.ts"
|
||
},
|
||
{
|
||
"id": "assets.characterVisualJobGet",
|
||
"group": "assets-character-visual",
|
||
"method": "GET",
|
||
"path": "/api/assets/character-visual/jobs/:taskId",
|
||
"operation": "assets.character.visual.job.get",
|
||
"access": "开关: ASSETS_API_ENABLED",
|
||
"responseMode": "json",
|
||
"summary": "查询角色主形象生成任务状态。",
|
||
"domainModuleIds": [
|
||
"assets"
|
||
],
|
||
"sourceHint": "assets.character.visual.job.get",
|
||
"surfaceId": "assets",
|
||
"sourceFile": "server-node/src/modules/assets/characterAssetRoutes.ts"
|
||
},
|
||
{
|
||
"id": "assets.characterVisualPublish",
|
||
"group": "assets-character-visual",
|
||
"method": "POST",
|
||
"path": "/api/assets/character-visual/publish",
|
||
"operation": "assets.character.visual.publish",
|
||
"access": "开关: ASSETS_API_ENABLED",
|
||
"responseMode": "json",
|
||
"summary": "发布选中的角色主形象到 public 目录。",
|
||
"domainModuleIds": [
|
||
"assets"
|
||
],
|
||
"sourceHint": "assets.character.visual.publish",
|
||
"surfaceId": "assets",
|
||
"sourceFile": "server-node/src/modules/assets/characterAssetRoutes.ts"
|
||
},
|
||
{
|
||
"id": "assets.characterWorkflowCacheSave",
|
||
"group": "assets-character-cache",
|
||
"method": "POST",
|
||
"path": "/api/assets/character-workflow-cache",
|
||
"operation": "assets.character.workflowCache.save",
|
||
"access": "开关: ASSETS_API_ENABLED",
|
||
"responseMode": "json",
|
||
"summary": "保存角色资产工作流缓存。",
|
||
"domainModuleIds": [
|
||
"assets"
|
||
],
|
||
"sourceHint": "assets.character.workflowCache.save",
|
||
"surfaceId": "assets",
|
||
"sourceFile": "server-node/src/modules/assets/characterAssetRoutes.ts"
|
||
},
|
||
{
|
||
"id": "assets.characterWorkflowCacheGet",
|
||
"group": "assets-character-cache",
|
||
"method": "GET",
|
||
"path": "/api/assets/character-workflow-cache/:characterId",
|
||
"operation": "assets.character.workflowCache.get",
|
||
"access": "开关: ASSETS_API_ENABLED",
|
||
"responseMode": "json",
|
||
"summary": "按角色读取角色资产工作流缓存。",
|
||
"domainModuleIds": [
|
||
"assets"
|
||
],
|
||
"sourceHint": "assets.character.workflowCache.get",
|
||
"surfaceId": "assets",
|
||
"sourceFile": "server-node/src/modules/assets/characterAssetRoutes.ts"
|
||
},
|
||
{
|
||
"id": "assets.qwenSpriteFrameRepairGenerate",
|
||
"group": "assets-qwen",
|
||
"method": "POST",
|
||
"path": "/api/assets/qwen-sprite/frame-repair",
|
||
"operation": "assets.qwenSprite.frameRepair.generate",
|
||
"access": "开关: ASSETS_API_ENABLED",
|
||
"responseMode": "json",
|
||
"summary": "对单帧做 Qwen 修复。",
|
||
"domainModuleIds": [
|
||
"assets"
|
||
],
|
||
"sourceHint": "assets.qwenSprite.frameRepair.generate",
|
||
"surfaceId": "assets",
|
||
"sourceFile": "server-node/src/modules/assets/qwenSpriteRoutes.ts"
|
||
},
|
||
{
|
||
"id": "assets.qwenSpriteMasterGenerate",
|
||
"group": "assets-qwen",
|
||
"method": "POST",
|
||
"path": "/api/assets/qwen-sprite/master",
|
||
"operation": "assets.qwenSprite.master.generate",
|
||
"access": "开关: ASSETS_API_ENABLED",
|
||
"responseMode": "json",
|
||
"summary": "生成 Qwen 精灵主图。",
|
||
"domainModuleIds": [
|
||
"assets"
|
||
],
|
||
"sourceHint": "assets.qwenSprite.master.generate",
|
||
"surfaceId": "assets",
|
||
"sourceFile": "server-node/src/modules/assets/qwenSpriteRoutes.ts"
|
||
},
|
||
{
|
||
"id": "assets.qwenSpriteAssetSave",
|
||
"group": "assets-qwen",
|
||
"method": "POST",
|
||
"path": "/api/assets/qwen-sprite/save",
|
||
"operation": "assets.qwenSprite.asset.save",
|
||
"access": "开关: ASSETS_API_ENABLED",
|
||
"responseMode": "json",
|
||
"summary": "保存 Qwen 精灵资产到 public 目录。",
|
||
"domainModuleIds": [
|
||
"assets"
|
||
],
|
||
"sourceHint": "assets.qwenSprite.asset.save",
|
||
"surfaceId": "assets",
|
||
"sourceFile": "server-node/src/modules/assets/qwenSpriteRoutes.ts"
|
||
},
|
||
{
|
||
"id": "assets.qwenSpriteSheetGenerate",
|
||
"group": "assets-qwen",
|
||
"method": "POST",
|
||
"path": "/api/assets/qwen-sprite/sheet",
|
||
"operation": "assets.qwenSprite.sheet.generate",
|
||
"access": "开关: ASSETS_API_ENABLED",
|
||
"responseMode": "json",
|
||
"summary": "生成 Qwen 精灵表。",
|
||
"domainModuleIds": [
|
||
"assets"
|
||
],
|
||
"sourceHint": "assets.qwenSprite.sheet.generate",
|
||
"surfaceId": "assets",
|
||
"sourceFile": "server-node/src/modules/assets/qwenSpriteRoutes.ts"
|
||
},
|
||
{
|
||
"id": "auth.auditLogs",
|
||
"group": "auth-audit",
|
||
"method": "GET",
|
||
"path": "/api/auth/audit-logs",
|
||
"operation": "auth.audit_logs",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "查询当前账号的鉴权审计日志。",
|
||
"domainModuleIds": [],
|
||
"sourceHint": "/audit-logs",
|
||
"surfaceId": "auth",
|
||
"sourceFile": "server-node/src/routes/authRoutes.ts"
|
||
},
|
||
{
|
||
"id": "auth.entry",
|
||
"group": "auth-entry",
|
||
"method": "POST",
|
||
"path": "/api/auth/entry",
|
||
"operation": "auth.entry",
|
||
"access": "公开",
|
||
"responseMode": "json",
|
||
"summary": "用户名密码登录；不存在则创建本地账号。",
|
||
"domainModuleIds": [],
|
||
"sourceHint": "/entry",
|
||
"surfaceId": "auth",
|
||
"sourceFile": "server-node/src/routes/authRoutes.ts"
|
||
},
|
||
{
|
||
"id": "auth.loginOptions",
|
||
"group": "auth-entry",
|
||
"method": "GET",
|
||
"path": "/api/auth/login-options",
|
||
"operation": "auth.login_options",
|
||
"access": "公开",
|
||
"responseMode": "json",
|
||
"summary": "返回当前启用的登录方式与入口配置。",
|
||
"domainModuleIds": [],
|
||
"sourceHint": "/login-options",
|
||
"surfaceId": "auth",
|
||
"sourceFile": "server-node/src/routes/authRoutes.ts"
|
||
},
|
||
{
|
||
"id": "auth.logout",
|
||
"group": "auth-session",
|
||
"method": "POST",
|
||
"path": "/api/auth/logout",
|
||
"operation": "auth.logout",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "退出当前会话并清理 refresh cookie。",
|
||
"domainModuleIds": [],
|
||
"sourceHint": "/logout",
|
||
"surfaceId": "auth",
|
||
"sourceFile": "server-node/src/routes/authRoutes.ts"
|
||
},
|
||
{
|
||
"id": "auth.logoutAll",
|
||
"group": "auth-session",
|
||
"method": "POST",
|
||
"path": "/api/auth/logout-all",
|
||
"operation": "auth.logout_all",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "退出当前账号的全部会话。",
|
||
"domainModuleIds": [],
|
||
"sourceHint": "/logout-all",
|
||
"surfaceId": "auth",
|
||
"sourceFile": "server-node/src/routes/authRoutes.ts"
|
||
},
|
||
{
|
||
"id": "auth.me",
|
||
"group": "auth-profile",
|
||
"method": "GET",
|
||
"path": "/api/auth/me",
|
||
"operation": "auth.me",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "读取当前登录用户的鉴权资料。",
|
||
"domainModuleIds": [],
|
||
"sourceHint": "/me",
|
||
"surfaceId": "auth",
|
||
"sourceFile": "server-node/src/routes/authRoutes.ts"
|
||
},
|
||
{
|
||
"id": "auth.phoneChange",
|
||
"group": "auth-phone",
|
||
"method": "POST",
|
||
"path": "/api/auth/phone/change",
|
||
"operation": "auth.phone.change",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "已登录用户更换绑定手机号。",
|
||
"domainModuleIds": [],
|
||
"sourceHint": "/phone/change",
|
||
"surfaceId": "auth",
|
||
"sourceFile": "server-node/src/routes/authRoutes.ts"
|
||
},
|
||
{
|
||
"id": "auth.phoneLogin",
|
||
"group": "auth-phone",
|
||
"method": "POST",
|
||
"path": "/api/auth/phone/login",
|
||
"operation": "auth.phone.login",
|
||
"access": "公开",
|
||
"responseMode": "json",
|
||
"summary": "手机号验证码登录。",
|
||
"domainModuleIds": [],
|
||
"sourceHint": "/phone/login",
|
||
"surfaceId": "auth",
|
||
"sourceFile": "server-node/src/routes/authRoutes.ts"
|
||
},
|
||
{
|
||
"id": "auth.phoneSendCode",
|
||
"group": "auth-phone",
|
||
"method": "POST",
|
||
"path": "/api/auth/phone/send-code",
|
||
"operation": "auth.phone.send_code",
|
||
"access": "公开",
|
||
"responseMode": "json",
|
||
"summary": "发送手机号登录或绑定验证码。",
|
||
"domainModuleIds": [],
|
||
"sourceHint": "/phone/send-code",
|
||
"surfaceId": "auth",
|
||
"sourceFile": "server-node/src/routes/authRoutes.ts"
|
||
},
|
||
{
|
||
"id": "auth.refresh",
|
||
"group": "auth-session",
|
||
"method": "POST",
|
||
"path": "/api/auth/refresh",
|
||
"operation": "auth.refresh",
|
||
"access": "公开",
|
||
"responseMode": "json",
|
||
"summary": "使用 refresh session 刷新 JWT。",
|
||
"domainModuleIds": [],
|
||
"sourceHint": "/refresh",
|
||
"surfaceId": "auth",
|
||
"sourceFile": "server-node/src/routes/authRoutes.ts"
|
||
},
|
||
{
|
||
"id": "auth.riskBlocks",
|
||
"group": "auth-risk",
|
||
"method": "GET",
|
||
"path": "/api/auth/risk-blocks",
|
||
"operation": "auth.risk_blocks",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "查询当前用户命中的风控封禁。",
|
||
"domainModuleIds": [],
|
||
"sourceHint": "/risk-blocks",
|
||
"surfaceId": "auth",
|
||
"sourceFile": "server-node/src/routes/authRoutes.ts"
|
||
},
|
||
{
|
||
"id": "auth.riskBlocksLift",
|
||
"group": "auth-risk",
|
||
"method": "POST",
|
||
"path": "/api/auth/risk-blocks/:scopeType/lift",
|
||
"operation": "auth.risk_blocks.lift",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "请求解除指定维度的风控拦截。",
|
||
"domainModuleIds": [],
|
||
"sourceHint": "/risk-blocks/:scopeType/lift",
|
||
"surfaceId": "auth",
|
||
"sourceFile": "server-node/src/routes/authRoutes.ts"
|
||
},
|
||
{
|
||
"id": "auth.sessions",
|
||
"group": "auth-session",
|
||
"method": "GET",
|
||
"path": "/api/auth/sessions",
|
||
"operation": "auth.sessions",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "列出当前账号的活跃会话。",
|
||
"domainModuleIds": [],
|
||
"sourceHint": "/sessions",
|
||
"surfaceId": "auth",
|
||
"sourceFile": "server-node/src/routes/authRoutes.ts"
|
||
},
|
||
{
|
||
"id": "auth.sessionRevoke",
|
||
"group": "auth-session",
|
||
"method": "POST",
|
||
"path": "/api/auth/sessions/:sessionId/revoke",
|
||
"operation": "auth.sessions.revoke",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "吊销指定会话。",
|
||
"domainModuleIds": [],
|
||
"sourceHint": "/sessions/:sessionId/revoke",
|
||
"surfaceId": "auth",
|
||
"sourceFile": "server-node/src/routes/authRoutes.ts"
|
||
},
|
||
{
|
||
"id": "auth.wechatBindPhone",
|
||
"group": "auth-wechat",
|
||
"method": "POST",
|
||
"path": "/api/auth/wechat/bind-phone",
|
||
"operation": "auth.wechat.bind_phone",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "为已登录微信账号绑定手机号。",
|
||
"domainModuleIds": [],
|
||
"sourceHint": "/wechat/bind-phone",
|
||
"surfaceId": "auth",
|
||
"sourceFile": "server-node/src/routes/authRoutes.ts"
|
||
},
|
||
{
|
||
"id": "auth.wechatCallback",
|
||
"group": "auth-wechat",
|
||
"method": "GET",
|
||
"path": "/api/auth/wechat/callback",
|
||
"operation": "auth.wechat.callback",
|
||
"access": "公开",
|
||
"responseMode": "redirect",
|
||
"summary": "处理微信回调并重定向回前端。",
|
||
"domainModuleIds": [],
|
||
"sourceHint": "/wechat/callback",
|
||
"surfaceId": "auth",
|
||
"sourceFile": "server-node/src/routes/authRoutes.ts"
|
||
},
|
||
{
|
||
"id": "auth.wechatStart",
|
||
"group": "auth-wechat",
|
||
"method": "GET",
|
||
"path": "/api/auth/wechat/start",
|
||
"operation": "auth.wechat.start",
|
||
"access": "公开",
|
||
"responseMode": "json",
|
||
"summary": "发起微信登录并返回授权 URL。",
|
||
"domainModuleIds": [],
|
||
"sourceHint": "/wechat/start",
|
||
"surfaceId": "auth",
|
||
"sourceFile": "server-node/src/routes/authRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldCoverImage",
|
||
"group": "runtime-custom-world-assets",
|
||
"method": "POST",
|
||
"path": "/api/custom-world/cover-image",
|
||
"operation": "runtime.customWorld.coverImage",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "生成自定义世界封面图。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"assets"
|
||
],
|
||
"sourceHint": "/custom-world/cover-image",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldCoverUpload",
|
||
"group": "runtime-custom-world-assets",
|
||
"method": "POST",
|
||
"path": "/api/custom-world/cover-upload",
|
||
"operation": "runtime.customWorld.coverUpload",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "上传并落地自定义世界封面图。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"assets"
|
||
],
|
||
"sourceHint": "/custom-world/cover-upload",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldEntity.primary",
|
||
"group": "runtime-custom-world-assets",
|
||
"method": "POST",
|
||
"path": "/api/custom-world/entity",
|
||
"operation": "runtime.customWorld.entity",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "按世界 profile 生成单个角色或地标实体。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"ai"
|
||
],
|
||
"sourceHint": "/custom-world/entity",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldSceneImage",
|
||
"group": "runtime-custom-world-assets",
|
||
"method": "POST",
|
||
"path": "/api/custom-world/scene-image",
|
||
"operation": "runtime.customWorld.sceneImage",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "生成自定义世界场景图。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"assets"
|
||
],
|
||
"sourceHint": "/custom-world/scene-image",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldSceneNpc.primary",
|
||
"group": "runtime-custom-world-assets",
|
||
"method": "POST",
|
||
"path": "/api/custom-world/scene-npc",
|
||
"operation": "runtime.customWorld.sceneNpc",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "按地标生成场景 NPC。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"ai",
|
||
"npc"
|
||
],
|
||
"sourceHint": "/custom-world/scene-npc",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "editor.catalogItems",
|
||
"group": "editor-catalog",
|
||
"method": "GET",
|
||
"path": "/api/editor/catalog/items",
|
||
"operation": "editor.catalog.items.list",
|
||
"access": "开关: EDITOR_API_ENABLED",
|
||
"responseMode": "json",
|
||
"summary": "列出 `public/Icons` 下的物品图标资源。",
|
||
"domainModuleIds": [
|
||
"editor"
|
||
],
|
||
"sourceHint": "/api/editor/catalog/items",
|
||
"surfaceId": "editor",
|
||
"sourceFile": "server-node/src/modules/editor/editorRoutes.ts"
|
||
},
|
||
{
|
||
"id": "editor.resourceRead",
|
||
"group": "editor-json",
|
||
"method": "GET",
|
||
"path": "/api/editor/json/:resourceId",
|
||
"operation": "editor.resource.read",
|
||
"access": "开关: EDITOR_API_ENABLED",
|
||
"responseMode": "json",
|
||
"summary": "读取指定编辑器资源 JSON。",
|
||
"domainModuleIds": [
|
||
"editor"
|
||
],
|
||
"sourceHint": "/api/editor/json/:resourceId",
|
||
"surfaceId": "editor",
|
||
"sourceFile": "server-node/src/modules/editor/editorRoutes.ts"
|
||
},
|
||
{
|
||
"id": "editor.resourceWrite",
|
||
"group": "editor-json",
|
||
"method": "POST",
|
||
"path": "/api/editor/json/:resourceId",
|
||
"operation": "editor.resource.write",
|
||
"access": "开关: EDITOR_API_ENABLED",
|
||
"responseMode": "json",
|
||
"summary": "回写指定编辑器资源 JSON。",
|
||
"domainModuleIds": [
|
||
"editor"
|
||
],
|
||
"sourceHint": "/api/editor/json/:resourceId",
|
||
"surfaceId": "editor",
|
||
"sourceFile": "server-node/src/modules/editor/editorRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.llmChatCompletionsProxy",
|
||
"group": "runtime-proxy",
|
||
"method": "POST",
|
||
"path": "/api/llm/chat/completions",
|
||
"operation": "runtime.llm.chatCompletionsProxy",
|
||
"access": "JWT",
|
||
"responseMode": "proxy",
|
||
"summary": "把聊天补全请求透传到上游模型。",
|
||
"domainModuleIds": [
|
||
"ai"
|
||
],
|
||
"sourceHint": "/llm/chat/completions",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.profileBrowseHistoryDelete.primary",
|
||
"group": "runtime-profile",
|
||
"method": "DELETE",
|
||
"path": "/api/profile/browse-history",
|
||
"operation": "profile.browseHistory.clear",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "清空平台浏览历史。",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "routeCompatPaths('/profile/browse-history')",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.profileBrowseHistoryGet.primary",
|
||
"group": "runtime-profile",
|
||
"method": "GET",
|
||
"path": "/api/profile/browse-history",
|
||
"operation": "profile.browseHistory.list",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "读取平台浏览历史。",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "routeCompatPaths('/profile/browse-history')",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.profileBrowseHistoryPost.primary",
|
||
"group": "runtime-profile",
|
||
"method": "POST",
|
||
"path": "/api/profile/browse-history",
|
||
"operation": "profile.browseHistory.upsert",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "写入或批量同步平台浏览历史。",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "routeCompatPaths('/profile/browse-history')",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.profileDashboard.primary",
|
||
"group": "runtime-profile",
|
||
"method": "GET",
|
||
"path": "/api/profile/dashboard",
|
||
"operation": "profile.dashboard.get",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "读取运行时个人主页汇总。",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "routeCompatPaths('/profile/dashboard')",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.profilePlayStats.primary",
|
||
"group": "runtime-profile",
|
||
"method": "GET",
|
||
"path": "/api/profile/play-stats",
|
||
"operation": "profile.playStats.get",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "读取个人游玩统计。",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "routeCompatPaths('/profile/play-stats')",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.profileSaveArchivesList.primary",
|
||
"group": "runtime-save",
|
||
"method": "GET",
|
||
"path": "/api/profile/save-archives",
|
||
"operation": "profile.saveArchives.list",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "列出个人存档摘要。",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "routeCompatPaths('/profile/save-archives')",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.profileSaveArchivesResume.primary",
|
||
"group": "runtime-save",
|
||
"method": "POST",
|
||
"path": "/api/profile/save-archives/:worldKey",
|
||
"operation": "profile.saveArchives.resume",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "恢复指定世界的最近存档。",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "'/profile/save-archives/:worldKey'",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.profileWalletLedger.primary",
|
||
"group": "runtime-profile",
|
||
"method": "GET",
|
||
"path": "/api/profile/wallet-ledger",
|
||
"operation": "profile.walletLedger.list",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "列出个人资产流水。",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "routeCompatPaths('/profile/wallet-ledger')",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.characterReplyStream",
|
||
"group": "runtime-chat",
|
||
"method": "POST",
|
||
"path": "/api/runtime/chat/character/reply/stream",
|
||
"operation": "runtime.chat.character.replyStream",
|
||
"access": "JWT",
|
||
"responseMode": "stream",
|
||
"summary": "流式生成角色回复。",
|
||
"domainModuleIds": [
|
||
"ai",
|
||
"story"
|
||
],
|
||
"sourceHint": "/runtime/chat/character/reply/stream",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.characterSuggestions",
|
||
"group": "runtime-chat",
|
||
"method": "POST",
|
||
"path": "/api/runtime/chat/character/suggestions",
|
||
"operation": "runtime.chat.character.suggestions",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "生成角色聊天建议语。",
|
||
"domainModuleIds": [
|
||
"ai",
|
||
"story"
|
||
],
|
||
"sourceHint": "/runtime/chat/character/suggestions",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.characterSummary",
|
||
"group": "runtime-chat",
|
||
"method": "POST",
|
||
"path": "/api/runtime/chat/character/summary",
|
||
"operation": "runtime.chat.character.summary",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "生成角色聊天摘要。",
|
||
"domainModuleIds": [
|
||
"ai",
|
||
"story"
|
||
],
|
||
"sourceHint": "/runtime/chat/character/summary",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.npcDialogueStream",
|
||
"group": "runtime-chat",
|
||
"method": "POST",
|
||
"path": "/api/runtime/chat/npc/dialogue/stream",
|
||
"operation": "runtime.chat.npc.dialogueStream",
|
||
"access": "JWT",
|
||
"responseMode": "stream",
|
||
"summary": "流式生成 NPC 对话。",
|
||
"domainModuleIds": [
|
||
"ai",
|
||
"npc",
|
||
"story"
|
||
],
|
||
"sourceHint": "/runtime/chat/npc/dialogue/stream",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.npcRecruitStream",
|
||
"group": "runtime-chat",
|
||
"method": "POST",
|
||
"path": "/api/runtime/chat/npc/recruit/stream",
|
||
"operation": "runtime.chat.npc.recruitStream",
|
||
"access": "JWT",
|
||
"responseMode": "stream",
|
||
"summary": "流式生成招募 NPC 对话。",
|
||
"domainModuleIds": [
|
||
"ai",
|
||
"npc",
|
||
"story"
|
||
],
|
||
"sourceHint": "/runtime/chat/npc/recruit/stream",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.npcTurnStream",
|
||
"group": "runtime-chat",
|
||
"method": "POST",
|
||
"path": "/api/runtime/chat/npc/turn/stream",
|
||
"operation": "runtime.chat.npc.turnStream",
|
||
"access": "JWT",
|
||
"responseMode": "stream",
|
||
"summary": "流式生成 NPC 单回合发言。",
|
||
"domainModuleIds": [
|
||
"ai",
|
||
"npc",
|
||
"story"
|
||
],
|
||
"sourceHint": "/runtime/chat/npc/turn/stream",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldGalleryList",
|
||
"group": "runtime-gallery",
|
||
"method": "GET",
|
||
"path": "/api/runtime/custom-world-gallery",
|
||
"operation": "runtime.customWorldGallery.list",
|
||
"access": "公开",
|
||
"responseMode": "json",
|
||
"summary": "列出公开的自定义世界画廊。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"runtime"
|
||
],
|
||
"sourceHint": "/runtime/custom-world-gallery",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldGalleryDetail",
|
||
"group": "runtime-gallery",
|
||
"method": "GET",
|
||
"path": "/api/runtime/custom-world-gallery/:ownerUserId/:profileId",
|
||
"operation": "runtime.customWorldGallery.detail",
|
||
"access": "公开",
|
||
"responseMode": "json",
|
||
"summary": "读取指定公开世界作品详情。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"runtime"
|
||
],
|
||
"sourceHint": "/runtime/custom-world-gallery/:ownerUserId/:profileId",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldLibraryList",
|
||
"group": "runtime-custom-world-library",
|
||
"method": "GET",
|
||
"path": "/api/runtime/custom-world-library",
|
||
"operation": "runtime.customWorldLibrary.list",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "列出当前账号的自定义世界资料库。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"runtime"
|
||
],
|
||
"sourceHint": "/runtime/custom-world-library",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldLibraryDelete",
|
||
"group": "runtime-custom-world-library",
|
||
"method": "DELETE",
|
||
"path": "/api/runtime/custom-world-library/:profileId",
|
||
"operation": "runtime.customWorldLibrary.delete",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "删除指定自定义世界 profile。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"runtime"
|
||
],
|
||
"sourceHint": "/runtime/custom-world-library/:profileId",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldLibraryUpsert",
|
||
"group": "runtime-custom-world-library",
|
||
"method": "PUT",
|
||
"path": "/api/runtime/custom-world-library/:profileId",
|
||
"operation": "runtime.customWorldLibrary.upsert",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "写入或更新指定自定义世界 profile。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"runtime"
|
||
],
|
||
"sourceHint": "/runtime/custom-world-library/:profileId",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldLibraryPublish",
|
||
"group": "runtime-custom-world-library",
|
||
"method": "POST",
|
||
"path": "/api/runtime/custom-world-library/:profileId/publish",
|
||
"operation": "runtime.customWorldLibrary.publish",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "发布指定世界到公开画廊。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"runtime"
|
||
],
|
||
"sourceHint": "/runtime/custom-world-library/:profileId/publish",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldLibraryUnpublish",
|
||
"group": "runtime-custom-world-library",
|
||
"method": "POST",
|
||
"path": "/api/runtime/custom-world-library/:profileId/unpublish",
|
||
"operation": "runtime.customWorldLibrary.unpublish",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "撤回指定世界的公开发布状态。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"runtime"
|
||
],
|
||
"sourceHint": "/runtime/custom-world-library/:profileId/unpublish",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldAgentCreateSession",
|
||
"group": "runtime-custom-world-agent",
|
||
"method": "POST",
|
||
"path": "/api/runtime/custom-world/agent/sessions",
|
||
"operation": "runtime.customWorldAgent.createSession",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "创建 Custom World Agent 会话。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"ai"
|
||
],
|
||
"sourceHint": "/sessions",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/customWorldAgent.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldAgentGetSession",
|
||
"group": "runtime-custom-world-agent",
|
||
"method": "GET",
|
||
"path": "/api/runtime/custom-world/agent/sessions/:sessionId",
|
||
"operation": "runtime.customWorldAgent.getSession",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "读取 Agent 会话快照。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"ai"
|
||
],
|
||
"sourceHint": "/sessions/:sessionId",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/customWorldAgent.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldAgentExecuteAction",
|
||
"group": "runtime-custom-world-agent",
|
||
"method": "POST",
|
||
"path": "/api/runtime/custom-world/agent/sessions/:sessionId/actions",
|
||
"operation": "runtime.customWorldAgent.executeAction",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "执行 Agent 卡片生成、资产同步或发布动作。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"ai",
|
||
"assets"
|
||
],
|
||
"sourceHint": "/sessions/:sessionId/actions",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/customWorldAgent.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldAgentGetCardDetail",
|
||
"group": "runtime-custom-world-agent",
|
||
"method": "GET",
|
||
"path": "/api/runtime/custom-world/agent/sessions/:sessionId/cards/:cardId",
|
||
"operation": "runtime.customWorldAgent.getCardDetail",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "读取 Agent 卡片详情。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"ai"
|
||
],
|
||
"sourceHint": "/sessions/:sessionId/cards/:cardId",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/customWorldAgent.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldAgentSendMessage",
|
||
"group": "runtime-custom-world-agent",
|
||
"method": "POST",
|
||
"path": "/api/runtime/custom-world/agent/sessions/:sessionId/messages",
|
||
"operation": "runtime.customWorldAgent.sendMessage",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "向 Agent 会话提交一条创作消息。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"ai"
|
||
],
|
||
"sourceHint": "/sessions/:sessionId/messages",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/customWorldAgent.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldAgentStreamMessage",
|
||
"group": "runtime-custom-world-agent",
|
||
"method": "POST",
|
||
"path": "/api/runtime/custom-world/agent/sessions/:sessionId/messages/stream",
|
||
"operation": "runtime.customWorldAgent.streamMessage",
|
||
"access": "JWT",
|
||
"responseMode": "stream",
|
||
"summary": "流式提交 Agent 消息并实时接收回执。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"ai"
|
||
],
|
||
"sourceHint": "/sessions/:sessionId/messages/stream",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/customWorldAgent.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldAgentGetOperation",
|
||
"group": "runtime-custom-world-agent",
|
||
"method": "GET",
|
||
"path": "/api/runtime/custom-world/agent/sessions/:sessionId/operations/:operationId",
|
||
"operation": "runtime.customWorldAgent.getOperation",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "查询 Agent 后台操作状态。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"ai"
|
||
],
|
||
"sourceHint": "/sessions/:sessionId/operations/:operationId",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/customWorldAgent.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldEntity.compat",
|
||
"group": "runtime-custom-world-assets",
|
||
"method": "POST",
|
||
"path": "/api/runtime/custom-world/entity",
|
||
"operation": "runtime.customWorld.entity.compat",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "按世界 profile 生成单个角色或地标实体（兼容路径）。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"ai"
|
||
],
|
||
"sourceHint": "/runtime/custom-world/entity",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldSceneNpc.compat",
|
||
"group": "runtime-custom-world-assets",
|
||
"method": "POST",
|
||
"path": "/api/runtime/custom-world/scene-npc",
|
||
"operation": "runtime.customWorld.sceneNpc.compat",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "按地标生成场景 NPC（兼容路径）。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"ai",
|
||
"npc"
|
||
],
|
||
"sourceHint": "/runtime/custom-world/scene-npc",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldSessionCreate",
|
||
"group": "runtime-custom-world-session",
|
||
"method": "POST",
|
||
"path": "/api/runtime/custom-world/sessions",
|
||
"operation": "runtime.customWorldSession.create",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "创建传统自定义世界问答会话。",
|
||
"domainModuleIds": [
|
||
"custom-world"
|
||
],
|
||
"sourceHint": "/runtime/custom-world/sessions",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldSessionGet",
|
||
"group": "runtime-custom-world-session",
|
||
"method": "GET",
|
||
"path": "/api/runtime/custom-world/sessions/:sessionId",
|
||
"operation": "runtime.customWorldSession.get",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "读取传统自定义世界问答会话。",
|
||
"domainModuleIds": [
|
||
"custom-world"
|
||
],
|
||
"sourceHint": "/runtime/custom-world/sessions/:sessionId",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldSessionAnswer",
|
||
"group": "runtime-custom-world-session",
|
||
"method": "POST",
|
||
"path": "/api/runtime/custom-world/sessions/:sessionId/answers",
|
||
"operation": "runtime.customWorldSession.answer",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "回答传统自定义世界问答题目。",
|
||
"domainModuleIds": [
|
||
"custom-world"
|
||
],
|
||
"sourceHint": "/runtime/custom-world/sessions/:sessionId/answers",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldSessionGenerateStream",
|
||
"group": "runtime-custom-world-session",
|
||
"method": "GET",
|
||
"path": "/api/runtime/custom-world/sessions/:sessionId/generate/stream",
|
||
"operation": "runtime.customWorldSession.generateStream",
|
||
"access": "JWT",
|
||
"responseMode": "stream",
|
||
"summary": "流式编译传统自定义世界 profile。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"ai"
|
||
],
|
||
"sourceHint": "/runtime/custom-world/sessions/:sessionId/generate/stream",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.customWorldWorksList",
|
||
"group": "runtime-custom-world-library",
|
||
"method": "GET",
|
||
"path": "/api/runtime/custom-world/works",
|
||
"operation": "runtime.customWorldWorks.list",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "列出当前账号的自定义世界作品汇总。",
|
||
"domainModuleIds": [
|
||
"custom-world",
|
||
"runtime"
|
||
],
|
||
"sourceHint": "/runtime/custom-world/works",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.itemsIntent",
|
||
"group": "runtime-loot",
|
||
"method": "POST",
|
||
"path": "/api/runtime/items/runtime-intent",
|
||
"operation": "runtime.items.intent",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "生成运行时物品意图。",
|
||
"domainModuleIds": [
|
||
"runtime-item",
|
||
"ai"
|
||
],
|
||
"sourceHint": "/runtime/items/runtime-intent",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.profileBrowseHistoryDelete.compat",
|
||
"group": "runtime-profile",
|
||
"method": "DELETE",
|
||
"path": "/api/runtime/profile/browse-history",
|
||
"operation": "profile.browseHistory.clear.compat",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "清空平台浏览历史。（兼容路径）",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "routeCompatPaths('/profile/browse-history')",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.profileBrowseHistoryGet.compat",
|
||
"group": "runtime-profile",
|
||
"method": "GET",
|
||
"path": "/api/runtime/profile/browse-history",
|
||
"operation": "profile.browseHistory.list.compat",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "读取平台浏览历史。（兼容路径）",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "routeCompatPaths('/profile/browse-history')",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.profileBrowseHistoryPost.compat",
|
||
"group": "runtime-profile",
|
||
"method": "POST",
|
||
"path": "/api/runtime/profile/browse-history",
|
||
"operation": "profile.browseHistory.upsert.compat",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "写入或批量同步平台浏览历史。（兼容路径）",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "routeCompatPaths('/profile/browse-history')",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.profileDashboard.compat",
|
||
"group": "runtime-profile",
|
||
"method": "GET",
|
||
"path": "/api/runtime/profile/dashboard",
|
||
"operation": "profile.dashboard.get.compat",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "读取运行时个人主页汇总。（兼容路径）",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "routeCompatPaths('/profile/dashboard')",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.profilePlayStats.compat",
|
||
"group": "runtime-profile",
|
||
"method": "GET",
|
||
"path": "/api/runtime/profile/play-stats",
|
||
"operation": "profile.playStats.get.compat",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "读取个人游玩统计。（兼容路径）",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "routeCompatPaths('/profile/play-stats')",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.profileSaveArchivesList.compat",
|
||
"group": "runtime-save",
|
||
"method": "GET",
|
||
"path": "/api/runtime/profile/save-archives",
|
||
"operation": "profile.saveArchives.list.compat",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "列出个人存档摘要。（兼容路径）",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "routeCompatPaths('/profile/save-archives')",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.profileSaveArchivesResume.compat",
|
||
"group": "runtime-save",
|
||
"method": "POST",
|
||
"path": "/api/runtime/profile/save-archives/:worldKey",
|
||
"operation": "profile.saveArchives.resume.compat",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "恢复指定世界的最近存档（兼容路径）。",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "'/runtime/profile/save-archives/:worldKey'",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.profileWalletLedger.compat",
|
||
"group": "runtime-profile",
|
||
"method": "GET",
|
||
"path": "/api/runtime/profile/wallet-ledger",
|
||
"operation": "profile.walletLedger.list.compat",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "列出个人资产流水。（兼容路径）",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "routeCompatPaths('/profile/wallet-ledger')",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.questsGenerate",
|
||
"group": "runtime-quest",
|
||
"method": "POST",
|
||
"path": "/api/runtime/quests/generate",
|
||
"operation": "runtime.quests.generate",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "按当前遭遇生成任务候选。",
|
||
"domainModuleIds": [
|
||
"quest",
|
||
"ai"
|
||
],
|
||
"sourceHint": "/runtime/quests/generate",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.snapshotDelete",
|
||
"group": "runtime-save",
|
||
"method": "DELETE",
|
||
"path": "/api/runtime/save/snapshot",
|
||
"operation": "runtime.snapshot.delete",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "删除当前用户的运行时存档。",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "/runtime/save/snapshot",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.snapshotGet",
|
||
"group": "runtime-save",
|
||
"method": "GET",
|
||
"path": "/api/runtime/save/snapshot",
|
||
"operation": "runtime.snapshot.get",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "读取当前用户的运行时存档。",
|
||
"domainModuleIds": [
|
||
"runtime",
|
||
"progression",
|
||
"quest"
|
||
],
|
||
"sourceHint": "/runtime/save/snapshot",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.snapshotPut",
|
||
"group": "runtime-save",
|
||
"method": "PUT",
|
||
"path": "/api/runtime/save/snapshot",
|
||
"operation": "runtime.snapshot.put",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "保存并归一化当前运行时存档。",
|
||
"domainModuleIds": [
|
||
"runtime",
|
||
"progression",
|
||
"quest"
|
||
],
|
||
"sourceHint": "/runtime/save/snapshot",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.settingsGet",
|
||
"group": "runtime-settings",
|
||
"method": "GET",
|
||
"path": "/api/runtime/settings",
|
||
"operation": "runtime.settings.get",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "读取运行时设置。",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "/runtime/settings",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.settingsPut",
|
||
"group": "runtime-settings",
|
||
"method": "PUT",
|
||
"path": "/api/runtime/settings",
|
||
"operation": "runtime.settings.put",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "更新运行时设置。",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "/runtime/settings",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "storyAction.resolve",
|
||
"group": "story-action",
|
||
"method": "POST",
|
||
"path": "/api/runtime/story/actions/resolve",
|
||
"operation": "runtime.story.actions.resolve",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "解析前端 story choice 动作为新的运行时结果。",
|
||
"domainModuleIds": [
|
||
"story",
|
||
"quest",
|
||
"inventory",
|
||
"runtime-item",
|
||
"npc",
|
||
"progression",
|
||
"combat",
|
||
"runtime"
|
||
],
|
||
"sourceHint": "/actions/resolve",
|
||
"surfaceId": "runtime-story-action",
|
||
"sourceFile": "server-node/src/modules/story/storyActionRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.storyContinue",
|
||
"group": "runtime-story-generation",
|
||
"method": "POST",
|
||
"path": "/api/runtime/story/continue",
|
||
"operation": "runtime.story.continue",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "生成下一段故事内容。",
|
||
"domainModuleIds": [
|
||
"story",
|
||
"ai"
|
||
],
|
||
"sourceHint": "/runtime/story/continue",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.storyInitial",
|
||
"group": "runtime-story-generation",
|
||
"method": "POST",
|
||
"path": "/api/runtime/story/initial",
|
||
"operation": "runtime.story.initial",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "生成首段故事内容。",
|
||
"domainModuleIds": [
|
||
"story",
|
||
"ai"
|
||
],
|
||
"sourceHint": "/runtime/story/initial",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "storyAction.stateGet",
|
||
"group": "story-action",
|
||
"method": "GET",
|
||
"path": "/api/runtime/story/state/:sessionId",
|
||
"operation": "runtime.story.state.get",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "读取指定 story session 的运行时状态。",
|
||
"domainModuleIds": [
|
||
"story",
|
||
"runtime"
|
||
],
|
||
"sourceHint": "/state/:sessionId",
|
||
"surfaceId": "runtime-story-action",
|
||
"sourceFile": "server-node/src/modules/story/storyActionRoutes.ts"
|
||
},
|
||
{
|
||
"id": "runtime.wsHealth",
|
||
"group": "runtime-diagnostics",
|
||
"method": "GET",
|
||
"path": "/api/ws/health",
|
||
"operation": "runtime.ws.health",
|
||
"access": "JWT",
|
||
"responseMode": "json",
|
||
"summary": "保留给未来实时链路的占位健康检查。",
|
||
"domainModuleIds": [
|
||
"runtime"
|
||
],
|
||
"sourceHint": "/ws/health",
|
||
"surfaceId": "runtime-main",
|
||
"sourceFile": "server-node/src/routes/runtimeRoutes.ts"
|
||
},
|
||
{
|
||
"id": "health.check",
|
||
"surfaceId": "health",
|
||
"group": "health",
|
||
"method": "GET",
|
||
"path": "/healthz",
|
||
"operation": "health.check",
|
||
"access": "公开",
|
||
"responseMode": "json",
|
||
"summary": "返回 Node 后端进程健康状态。",
|
||
"domainModuleIds": [],
|
||
"sourceFile": "server-node/src/app.ts",
|
||
"sourceHint": "/healthz"
|
||
}
|
||
],
|
||
"maintenanceRules": [
|
||
"新增 `server-node/src/modules/*` 目录时，必须先补充 manifest 里的模块说明，再重新生成产物。",
|
||
"新增或下线路由时，先更新 manifest 里的路由清单，再运行生成命令同步 JSON 与文档。",
|
||
"如果路由来自兼容路径或中间件派生路径，`sourceHint` 需要指向源代码里的真实表达式，确保生成脚本能做最小校验。"
|
||
]
|
||
}
|