Esperi/dsh-uispec

README 摘要

UISpec Generator 作者（？）碎碎念[必看] 这是一个高度依赖Deepseek v4 Flash进行开发的项目，从需求书、开发计划书到实际的执行和修改——甚至这个README的主体部分——几乎全部由AI完成，我在里面只起到了一个灵感提供者的作用——甚至不是思路提供者，因为我对前端和后端都不熟，谈何思路呢。 因此，如果您在这个项目里发现各种逻辑混乱、架构不稳、或者其他什么AI屎山——请原谅，这毕竟只是一个对于写程序有那么一点点兴趣的文科生为了满足自己粗劣的“想写点有用的东西”的愿望，从而借助AI工具搞出来的自己也不一定看得懂的黑箱罢了。 虽然这么说，但我也尽力验证了它的基本功能是能跑的通的——写一个.uispec文件，告诉AI这个文件的地址，让它帮你生成一个.html文件以做预览，从而确认文件本身能让AI理解如何布局游戏UI。这也是我一开始想要做的：一个给帮我做游戏的Agent用来理解我脑子里飞着的那些UI布局的工具。至少目前看来，这个功能是实现了。 以上。再次请求您的原谅。即使要喷，也请轻喷。虽然做得这么烂的东西，真的有人会正眼看一下吗，更不用说喷了…… 规格驱动的 UI 原型生成插件，运行于 DeepSeek Harness（DSH）。 用一份 YAML 描述界面（设计令牌、布局、组件、交互），插件完成 解析 → 校验 → LLM 生成 → 落盘 全流程，输出自包含的 HTML 原型： 功能简介 能力 说明 触发方式 YAML 解析 自写子集解析器，语法错误带 行列号 定位 /uispec parse 校验 结构/类型/颜色/引用完整性检查，错误聚合输出，引用问题为警告不阻断 /uispec validate LLM 生成 流式调用（思考统计、token 用量、截断检测），提示词模板可配置 /uispec llm 一键生成 完整流水线并写入 preview.html /uispec generate 模型工具 Agent 可直接调用，无需人工输入命令 模型工具 uispec generate 文件监听 轮询 + 防抖， .uispec 变更自动重新生成 /uispec watch 诊断 展示路径解析基准与目录条目，排查"找不到文件" /uispec diag 特点 ： - 零 npm 运行时依赖：解析器与校验器为纯 JS 自写（约 800 行），错误信息面向使用者； - 设计令牌（颜色/字体/间距/圆角）自动映射为 CSS 变量，生成结果稳定可控； - 输出为可再生构建产物，命名规则 inventory.uispec → inventory preview.html 。 UISpec 语法简介 顶层结构 支持的 YAML 子集（v1.0） 支持：块映射、块序列（ - item ）、单行 flow 映射/序列（ { a: b } 、 [x, y…

分类