Zzz11042/assets-upload

项目介绍

asset-dashboard 是一个用 Node.js 本地运行的服务，带单页网页界面，把分散在本机的游戏工程、美术资产、小说连载和短剧项目整理成一份清单。总览页展示资产计数、番茄连载进度和短剧项目状态；资产库按关键词过滤游戏、知识库游戏、可借鉴方案和美术风格；资产查看按多工程加机读标签展示文件实时内容。方案生成把一句话思路转成候选方案，可本地打分，也可回退到在线 LLM。本地扫描会遍历指定根目录，列出可分析项，勾选后导出给 Codex / DSH 等 agent 继续处理。它面向的是素材散落在机器各处的创作者，希望在一个地方盘点、去重并把材料交给 agent 分析。

服务只依赖 Node 标准库，没有 npm 依赖。

快速使用

需要能运行 ES 模块的 Node.js，无需安装依赖：

cd asset-dashboard
node server.mjs            # → http://127.0.0.1:7800
PORT=8080 node server.mjs  # 自定义端口

打开 http://127.0.0.1:7800。本仓库只保留了 asset-dashboard，配套的 game-forge 与 tomato 目录不存在时，相关端点按设计返回空，总览页会显式提示缺失的数据源，需要补回这些目录后才有实际内容。

在线方案生成可选：在网页「设置」里填 API Base、Key 和模型，会写入 settings.json（已从版本库排除）；或设置环境变量 AGNES_API_BASE / AGNES_API_KEY / AGNES_MODEL，settings.json 优先。

本地扫描接口：

GET /api/local-scan?depth=3
GET /api/local-scan?roots=/abs/path,/abs/path2&depth=2

返回根列表、总数、可分析项、类型分布和每项的名称、路径、文件数、大小、标签等。图片去重用 GET /api/dedup?depth=6，只出报告，结合 SHA-1 字节级完全重复与同名跨格式嫌疑两类候选；也可单独用 CLI：

node asset-dashboard/dedup.mjs --roots "a,b" --depth 6 --out dedup-report.json --md dedup-report.md

接入 Agent

服务提供 agent 接入层：GET /api/agent/manifest 做能力发现，POST /api/agent/plan 把需求（requirement、domain?、game?、context?）转成机读方案，GET /api/agent/plan?plan_id= 取回方案，POST /api/record 回传结果。方案中带知识库命中的资产、本机游戏目录、有序执行任务和本机工具路径；标了 assumed:true 的路径需要 agent 先核对。完整端点和 schema 见仓库根目录的 AGENTS.md。

使用约束

• 默认只监听 127.0.0.1，不设 HOST=0.0.0.0 就是本机使用。服务本身不校验访问者身份，公网部署必须在网关或反向代理层加鉴权。
• /api/local-scan、/api/asset-text、/api/dedup、/api/scan-roots 会读取部署机上的文件和目录。公网部署时用 SCAN_ROOTS_ALLOWED 设一个逗号分隔的绝对路径白名单，扫描参数和保存的扫描根都会被限制在白名单内。
• MAX_BODY_BYTES 默认 1 MB，超出的请求体被拒绝；NODE_ENV=production 时静态资源缓存一小时。
• 扫描深度上限 4 层，会跳过 node_modules、.git、__pycache__、profiles、vault 等目录。
• 去重分析只出报告，不移动或删除文件；同名跨格式组需要人工目视确认。
• 设置了 AGENT_TOKEN 后 /api/agent/* 需要请求头 x-agent-token，未设置则开放，只适合本机部署。
• 仓库未声明许可证。

HotRepo 点评

该项目在 2026-11-07 进入 HotRepo 的 JavaScript 新项目榜，约一天的统计窗口内新增 48 Star。真正有信息量的是逐小时 Star 曲线：11 月 6 日至 7 日 UTC 大部分时间停在 114，最后两个采样点才升到 137 和 162，说明记录到的增长集中在窗口末尾，而不是持续累积。全部语言日榜上没有它的名次。技术上值得注意的是，文件系统扫描、只出报告的去重和面向 agent 的方案 schema 被塞进一个零依赖服务里；但仓库已经删掉了配套材料，只有在原本的本地工作区里部署使用，这套工具才完整可用。

项目源码与说明