配置资源与平台支持/地图截图与任务资源

本文梳理奇想盒后端中地图、特征截图、任务所用资源的已知位置及其与截图识别、地图操作和任务脚本的关系，并区分项目说明已经确认的事实与尚未取得实现证据的细节。

用途与范围

本页聚焦地图截图与任务资源：资源放在哪里、哪些模块可能使用这些资源，以及运行平台对截图识别的已知约束。项目说明将 whimbox/assets/ 描述为“地图、特征截图、配置文件、文件模板等资源”，将 whimbox/map/ 描述为“小地图识别，大地图操作”，将 whimbox/task/ 描述为“各种功能脚本，供 agent 调用”。这些描述确立了本页的范围，但并不提供资源清单、读取接口或文件格式。

一条龙的具体任务执行、自动跑图路线的录制和编辑、RPC 通信以及模型调用分别属于任务、跑图、交互及 Agent 的独立主题；本页仅说明它们与资源目录的已知边界，不将尚未验证的内部调用关系当作事实。

概览

奇想盒是辅助游玩《无限暖暖》的 AI 智能体。项目说明称当前仓库为后端，负责 RPC 服务、大模型调用和工具调用，使用奇想盒 app 运行；仓库内另有地图模块、交互模块、任务模块与资源目录。其已列出的功能包括每日任务、自动小功能、自动跑图、宏、自动弹琴与 AI 对话。与本页最相关的是自动跑图、截图识别及任务脚本：项目说明分别提到了路线录制与编辑、大世界和星海的自动跑图，以及小地图识别和大地图操作。

需要严格区分两类目录：whimbox/assets/ 在项目结构说明中属于程序资源目录；仓库根目录的 configs/ 存放项目配置，其中 configs/config.json 是项目配置文件、configs/agent_workspace/ 存放 Agent 记忆；scripts/ 是自动跑图和宏的脚本仓库。项目说明没有给出这些目录之间的数据同步、优先级或装载顺序。

架构与资源边界

已描述的路径或模块	项目说明中的职责	与本页的关系	尚未得到证实的细节
`whimbox/assets/`	地图、特征截图、配置文件、文件模板等资源	地图截图与任务资源的已知归属目录	具体子目录、文件名、格式、版本管理、加载方式
`whimbox/interaction/`	截图与操作的交互核心模块	截图来源的模块边界	截图 API、截图尺寸与资源匹配机制
`whimbox/map/`	小地图识别、大地图操作	地图相关识别与操作的模块边界	是否读取 `assets/`、坐标变换和定位算法
`whimbox/task/`	各种供 Agent 调用的功能脚本	任务逻辑的模块边界	各任务依赖的资源、入口和异常处理
`scripts/`	自动跑图和宏的脚本仓库	用户脚本与内置资源需要区分	脚本格式、加载与回放流程
`configs/config.json`	项目配置文件	与资源目录分开存放的运行配置	具体配置键、默认值及覆盖顺序

上述表格仅表示项目说明中明确列出的目录职责，不表示已证实的模块依赖图。目前没有可核实的源码级调用关系，因此不绘制可能误导读者的 Mermaid 组件或时序图。

已知运行流程与限制

从使用者视角，项目说明给出的启动方式是通过奇想盒 app 运行；如需命令行启动一条龙，应先确保通过 app 可以正常运行，再在一条龙配置中勾选“启动奇想盒时，自动运行一条龙”，之后通过命令行启动 whimbox_app.exe。如需任务完成后关闭游戏和奇想盒，还需勾选“一条龙结束后，关闭游戏和奇想盒”。这些是使用说明，不能据此推断资源下载、缓存或任务初始化的实现顺序。

项目说明明确指出：不会修改游戏文件或读写游戏内存，仅截图和模拟鼠标键盘；图像识别会额外消耗 PC 性能，目前仅支持中高配 PC，且游戏仅支持标准 16:9 分辨率运行。对地图与特征截图资源而言，这些是重要的运行约束；但目前没有源码证据说明其他分辨率下是直接拒绝、识别失败还是另有适配路径。自动跑图在说明中标为“暂时只支持大世界和星海”，不应将其他区域视为已支持。

资源、脚本与配置的区别

内置资源：项目结构把地图、特征截图、配置文件和文件模板归入 whimbox/assets/；不能进一步假定所有任务资源都在同一个子目录或使用同一种图片格式。
自动跑图与宏脚本：项目结构把脚本仓库放在 scripts/；它与内置地图、特征截图资源的关系尚未由实现确认。
运行配置：项目结构另列 configs/config.json；不能将其与 whimbox/assets/ 内的“配置文件”合并解释为同一个配置系统。
Agent 记忆：项目结构将其放在 configs/agent_workspace/，并列出 whimbox/agent_workspace/ 为上下文管理模块；没有证据表明这些文件是地图截图资源。

接口、示例与验证状态

No code example available. 当前可用材料仅是项目说明文本及其中的目录职责描述，未取得可用的仓库源码读取工具、实际资源文件内容、测试文件或文件引用基础 URL。因此无法核实资源加载函数签名、任务入口、配置字段、异常类型、并发控制、缓存与重试行为，也无法提供带可靠行号链接的源码示例。为避免将推测写成事实，本页不编造代码块、API 表或配置默认值。

同样，资源是否打包进发行版、是否在首次启动时解压、截图与地图素材如何对齐、失败时如何回退、识别结果是否缓存以及测试是否覆盖不同分辨率，均属于实现细节未在现有材料中找到。扩展地图或任务素材之前，应先检查实际 whimbox/assets/ 内容，追踪 whimbox/map/、whimbox/interaction/ 与 whimbox/task/ 的读取调用，并核对 scripts/ 和 configs/config.json 的真实约定；不要仅凭目录名称更改资源结构。