SuperAPI AI 工具集

nsh-design-guides

设计与创作

查看项目

更新于 11-06 03:03

技能介绍

nsh-design-guides 是 Native Shell(NSH)应用的规范性设计指南技能。它的核心定位不是提供灵感,而是提出必须遵循的设计要求,适用于设计或修改任何界面、布局、间距、视觉层级、颜色、密度等内容之前的使用场景。

用途方面,该技能要求在动手做 UI 工作前先阅读捆绑的指南文件 references/design-guides.md,并明确不得依据当前说明页、代码库中已有的界面或训练数据来回答设计问题。指南文件需要相对于技能目录解析,而不是相对于应用目录。若文件缺失,应改为获取 https://nsh.dev/docs/design-guides.md。该指南是该页面的逐字副本,因此指南中出现的相对链接,例如 ./coding-guides.md,表示 https://nsh.dev/docs/coding-guides.md(同样位于 nsh 技能中);../elements/index.md 表示 https://nsh.dev/elements/index.md。

主要能力体现在组织与使用设计规范上。指南包含若干章节,可通过 grep -n '^## ' references/design-guides.md 列出,顺序为:Design thesis、Learning from Shadcn、Start from the task、Visual language、Layout patterns、Components and composition、Interaction states、Feedback and overlays、Motion、Designing data-heavy interfaces、Interface language、Internationalization and platform fit、Guidance for AI-generated interfaces、Accessibility checklist、Design review checklist。阅读策略为:新建屏幕或重设计时通读整个指南;窄范围改动时先读 Design thesis 与 Start from the task,再读与本次改动对应的章节。

使用方式上,应用指南时应限制在用户请求的范围内,并延续应用既有的视觉语言。对于窄范围改动,应保留周边屏幕和组件不变。应使用语义化的 NSH 基础组件,只为其可见部分设置样式;在条件允许时,按请求的外观和视口检查实际结果。行为测试本身不能验证布局或样式,因此当无法进行视觉验证时,需要明确说明。涉及 NSH API 与实现细节时,应使用已安装的 nsh 技能,或查阅文档索引中的相关页面。

适用场景包括 NSH 应用的界面设计、界面改动、布局与视觉规范落实、交互状态与反馈设计、动效、数据密集型界面、界面文案与国际化适配,以及 AI 生成界面的约束和无障碍与设计评审检查。限制在于:本技能不替代 nsh 技能中的 API 与实现文档;指南内容需以实际文件或官方文档为准,不能根据本说明或训练数据推断;无法确认的收费、平台支持、具体界面效果等信息暂未提供。