RAILWISE · VISUAL GLOSSARY
Vibe Coding
可视化图鉴
不用背术语。通过界面状态、执行顺序和技术关系,看懂 AI 编程里真正发生了什么。
SEARCH BY YOUR WORDS
先说你想做什么
推荐从这些高频概念开始,也可以直接输入日常表达。
用户在浏览器里直接看到并操作的界面部分。
前端与界面浏览器负责获取网页资源、执行脚本并把页面画出来的应用。
前端与界面HTML描述网页内容结构和语义的标记语言。
前端与界面CSS控制页面布局、颜色、间距和响应式表现的样式规则。
前端与界面JavaScript让网页能够处理数据、响应操作并动态更新的编程语言。
前端与界面DOM浏览器把 HTML 解析成的可读取、可修改的页面对象树。
前端与界面组件把一块界面及其行为封装成可复用单元。
前端与界面Props父组件传给子组件的只读输入。
前端与界面状态会随操作或数据变化并影响界面结果的信息。
前端与界面事件用户或浏览器发生某个动作时发出的可监听信号。
前端与界面按钮与链接按钮执行当前页面动作,链接把用户带到另一个地址。
前端与界面输入与表单输入控件收集单项信息,表单组织并提交一组信息。
前端与界面Checkbox、Radio 与 Switch复选框可多选,单选框在一组中选一个,开关立即切换布尔设置。
前端与界面Select 与 AutoCompleteSelect 从有限选项中选择,AutoComplete 边输入边给候选。
前端与界面表单验证在提交前后检查输入是否完整、格式是否正确、业务规则是否满足。
前端与界面Table、List 与 Card表格适合对齐比较,列表适合顺序浏览,卡片适合独立对象概览。
前端与界面Modal 与 DrawerModal 居中打断当前任务,Drawer 从边侧展开并保留更多页面上下文。
前端与界面Toast 与 NotificationToast 短暂提示即时结果,Notification 承载更重要或可追溯的消息。
前端与界面Tooltip 与 PopoverTooltip 解释简短标签,Popover 可承载少量操作或结构化内容。
前端与界面导航与路由导航帮助用户选择去向,路由把地址映射到对应页面或视图。
前端与界面响应式与断点同一内容根据可用宽度调整布局,而不是简单缩小桌面页面。
前端与界面加载、空状态与错误状态界面必须说明正在等待、确实没有数据,还是请求失败。
前端与界面无障碍与焦点让键盘、读屏和不同能力的用户都能理解并操作界面。
前端与界面客户端与服务端渲染客户端渲染在浏览器组装页面,服务端渲染先生成 HTML 再交给浏览器。
前端与界面Button 按钮触发一个明确动作的可点击控件。
前端与界面Link 链接把用户带到另一个页面、位置或资源的导航入口。
前端与界面Input 输入框接收一行短文本、数字或密码的表单控件。
前端与界面Textarea 多行输入接收段落、说明和长文本的可伸缩输入区域。
前端与界面Checkbox 复选框允许用户独立选择零个、一个或多个选项。
前端与界面Radio 单选框从一组互斥选项中选择且只选择一个。
前端与界面Switch 开关立即打开或关闭一个二元设置。
前端与界面Select 下拉选择从预设列表中选择一个或多个值。
前端与界面AutoComplete 自动补全用户输入时根据关键词推荐可能的完整值。
前端与界面DatePicker 日期选择器用日历或时间面板选择规范化日期。
前端与界面Upload 文件上传把本地文件传到服务器或对象存储。
前端与界面Label 表单标签说明一个输入控件在收集什么以及是否必填。
前端与界面Table 表格按行列展示可比较的结构化数据。
前端与界面List 列表按相同结构连续展示一组同类项目。
前端与界面Card 卡片把一个可独立理解的对象及其操作组织在有限区域内。
前端与界面Tag 与 Badge用短标签表达分类,用小徽标表达数量或状态提醒。
前端与界面Avatar 头像用人像、Logo 或首字母帮助识别用户或组织。
前端与界面Tabs 标签页在同一上下文中切换少量并列内容视图。
前端与界面Collapse 折叠面板按标题展开或收起补充内容,降低一次性信息密度。
前端与界面Modal 模态框在当前页面上方临时阻断流程,要求用户完成或取消一个任务。
前端与界面Drawer 抽屉从屏幕边缘滑出一个保持主页面上下文的辅助面板。
前端与界面Toast 轻提示短暂显示操作结果,不要求用户立即回应。
前端与界面Notification 通知承载较完整、可稍后处理的系统消息。
前端与界面Tooltip 工具提示悬停或聚焦时解释一个简短控件或术语。
前端与界面Popover 气泡面板由某个控件触发、承载少量交互内容的浮层。
前端与界面Breadcrumb 面包屑显示当前页面在信息层级中的位置及返回路径。
前端与界面Pagination 分页把大量结果切成稳定页次,允许定位与返回。
前端与界面Dropdown 下拉菜单从按钮或导航项展开一组相关命令。
前端与界面Hero 首屏主视觉页面进入时用主标题、核心说明和主要操作建立第一印象。
前端与界面CTA 行动入口引导用户完成页面最重要的下一步。
前端与界面Header 与 Navbar在页面顶部承载品牌、主导航和全局操作。
前端与界面Footer 页脚在页面末尾提供法律、联系与辅助导航信息。
前端与界面Flexbox 弹性布局沿一个主轴排列、分配和对齐一组元素的 CSS 布局方式。
前端与界面CSS Grid 网格布局用明确的行列轨道组织二维页面结构。
后端与数据服务器持续接收请求、运行程序并返回数据或页面的计算环境。
后端与数据API不同程序按照约定交换数据或调用能力的接口。
后端与数据HTTP 请求与响应浏览器或程序发出请求,服务器用状态码、头和内容做出响应。
后端与数据REST围绕资源和标准 HTTP 方法组织接口的一种常见风格。
后端与数据JSON用键、值、数组和对象表达结构化数据的文本格式。
后端与数据数据库与数据结构数据库保存可查询的数据,数据结构规定字段、类型和关系。
后端与数据CRUD创建、读取、更新和删除数据的四类基本操作。
后端与数据身份认证与权限认证确认你是谁,权限判断你能做什么。
后端与数据Session 与 TokenSession 由服务端保存会话,Token 把可验证凭据交给客户端携带。
后端与数据CORS浏览器用跨源规则限制网页调用另一个域名的接口。
后端与数据Endpoint 接口端点一个 API 对外提供具体能力的地址与方法组合。
后端与数据HTTP 状态码用三位数字概括一次 HTTP 请求的处理结果。
后端与数据Webhook 回调当某个事件发生时,由服务端主动向另一个系统发送 HTTP 通知。
后端与数据WebSocket 长连接客户端与服务端保持双向连接,双方都能随时发送消息。
后端与数据GraphQL客户端按结构声明所需字段,由统一端点返回对应数据。
后端与数据OpenAPI 规范用机器可读文件描述 HTTP API 的路径、参数、模型和响应。
后端与数据Cookie浏览器按域名保存并随请求发送的小段状态数据。
后端与数据Cache 缓存把计算或获取过的结果暂存起来,减少重复工作与等待。
后端与数据Rate Limit 速率限制限制单位时间内允许的请求数量,保护服务资源。
后端与数据文件与对象存储把图片、文档等二进制内容存到文件系统或对象存储,并在数据库记录引用。
后端与数据SQL用于查询和修改关系型数据库的结构化语言。
后端与数据NoSQL 数据库不以传统关系表为唯一模型的一类数据库方案。
后端与数据关系型数据库用表、行、列和关系约束组织结构化数据。
后端与数据数据库索引为常用查询建立额外的数据结构,减少扫描范围。
后端与数据Transaction 事务把多次数据操作作为一个不可分割的整体提交或回滚。
后端与数据数据库迁移用可版本化脚本逐步改变数据库结构或基础数据。
后端与数据消息队列与后台任务把耗时或可异步处理的工作排队,由独立执行器消费。
后端与数据服务端分页由服务端只查询并返回当前一页数据,而不是把全部记录交给浏览器。
技术栈与运行环境技术栈完成一个产品所使用的语言、框架、运行时、数据库和部署工具组合。
技术栈与运行环境框架与库库由代码主动调用,框架规定整体组织方式并在合适时机调用代码。
技术栈与运行环境运行时真正执行程序并提供文件、网络、计时器等基础能力的环境。
技术栈与运行环境包管理器负责下载、锁定、升级和运行项目依赖的工具。
技术栈与运行环境依赖当前项目运行或开发时需要的外部代码包。
技术栈与运行环境终端与 CLI终端是输入命令的界面,CLI 是通过命令和参数操作的软件。
技术栈与运行环境开发服务器为本地开发提供页面、热更新和调试信息的临时服务。
技术栈与运行环境构建与打包把源代码、样式和资源转换成浏览器或服务器可发布产物。
技术栈与运行环境环境变量由运行环境注入、用来区分配置而不写死在源码里的键值。
技术栈与运行环境部署与托管部署把可发布产物交付到运行环境,托管负责持续提供访问。
技术栈与运行环境TypeScript在 JavaScript 上增加静态类型检查,帮助更早发现接口和数据错误。
技术栈与运行环境模块系统把代码拆成可导入、可导出的独立单元并管理依赖关系。
技术栈与运行环境Monorepo 单仓库在一个版本库中管理多个应用或共享包。
技术栈与运行环境Lockfile 锁定文件记录依赖解析后的精确版本,保证不同环境安装结果一致。
技术栈与运行环境语义化版本用主版本、次版本和修订号表达兼容性与变更范围。
技术栈与运行环境Lint 与格式化用自动规则检查潜在代码问题,并统一排版风格。
技术栈与运行环境容器把应用和运行依赖封装成可重复启动的隔离环境。
技术栈与运行环境Docker用于构建、分发和运行容器镜像的一套工具与运行方式。
技术栈与运行环境CI/CD 持续集成与交付每次改动自动执行检查、构建,并按规则发布到目标环境。
技术栈与运行环境域名与 DNS域名是易读地址,DNS 负责把它解析到服务器或服务节点。
技术栈与运行环境CDN 内容分发网络把静态内容缓存到离用户更近的节点,降低延迟和源站压力。
技术栈与运行环境反向代理由入口服务器接收请求,再转发到内部应用或静态资源。
技术栈与运行环境日志与监控日志记录事件细节,监控聚合指标并在异常时告警。
技术栈与运行环境Feature Flag 功能开关用配置控制功能是否对某环境或用户群开放,而不重新改代码。
AI、Agent 与上下文大语言模型根据已有上下文预测并生成文本或结构化输出的模型。
AI、Agent 与上下文模型与服务商模型是能力本身,服务商负责提供接口、计费、限额和运行保障。
AI、Agent 与上下文Prompt给模型的任务说明、上下文、约束和输出要求。
AI、Agent 与上下文System Prompt由应用放在更高优先级、规定角色和长期行为边界的指令。
AI、Agent 与上下文上下文窗口模型单次能够共同处理的指令、历史和资料总量。
AI、Agent 与上下文Token模型读取和生成文字时使用的计量片段,不等同于字或字符。
AI、Agent 与上下文多模态同一模型或流程能够处理文字、图片、音频等多种输入。
AI、Agent 与上下文Agent围绕目标自行规划步骤、调用工具并检查结果的执行流程。
AI、Agent 与上下文工具调用模型按结构化参数请求外部程序执行查询或操作。
AI、Agent 与上下文MCP让 AI 应用用统一协议发现并调用外部工具、资源和提示模板。
AI、Agent 与上下文Embedding 与 RAGEmbedding 把内容映射成可比较向量,RAG 先检索资料再让模型基于资料回答。
AI、Agent 与上下文幻觉与评估幻觉是模型生成了看似合理但无依据的内容,评估用于系统检查质量。
AI、Agent 与上下文Temperature 与采样控制模型从候选词中选择结果时的随机程度,而不是控制事实正确率。
AI、Agent 与上下文Structured Output 结构化输出让模型按预先定义的 JSON 结构返回数据,便于程序可靠读取。
AI、Agent 与上下文Few-shot 示例提示在提示中给出少量输入输出示例,让模型模仿格式和判断口径。
AI、Agent 与上下文Reasoning Model 推理模型在回答前投入更多计算处理多步骤问题的模型类型。
AI、Agent 与上下文Agent Loop 智能体循环Agent 在观察、计划、行动和检查之间循环,直到完成或需要人工介入。
AI、Agent 与上下文Agent Memory 记忆把跨轮次有价值的信息保存为可检索状态,减少反复说明。
AI、Agent 与上下文Guardrails 护栏在模型输入、工具权限和输出结果周围设置可执行的限制与检查。
AI、Agent 与上下文Prompt Injection 提示注入外部内容试图改变 Agent 原有指令、窃取信息或诱导执行越权动作。
AI、Agent 与上下文向量数据库按语义向量的距离检索相似内容,而不只匹配相同关键词。
AI、Agent 与上下文Chunking 文档切分把长文档切成可检索且保留语义的较小片段。
AI、Agent 与上下文Reranking 重排序在初次召回后,用更精细模型重新判断候选与问题的相关性。
AI、Agent 与上下文Grounding 与引用让模型结论建立在给定资料上,并保留可核验的来源位置。
AI、Agent 与上下文Model Routing 模型路由根据任务类型、风险、成本和速度选择不同模型或处理链。
AI、Agent 与上下文Evaluation Dataset 评测集用一组有期望结果和评分规则的代表性任务持续衡量 AI 质量。
Git 与协作Git 与 GitHubGit 在本地记录版本,GitHub 托管仓库并提供协作流程。
Git 与协作仓库保存项目文件、版本历史和 Git 配置的工作目录。
Git 与协作工作区与暂存区工作区是正在编辑的文件,暂存区是准备进入下一次提交的改动。
Git 与协作Commit把一组有明确目的的暂存改动保存成带说明的版本节点。
Git 与协作Branch指向一条提交历史的可移动分支,用来隔离不同工作。
Git 与协作Merge 与 RebaseMerge 保留分叉并产生合并结果,Rebase 把提交重新放到新基线后。
Git 与协作Fetch、Pull 与 PushFetch 只获取远程信息,Pull 获取并整合,Push 把本地提交发送到远程。
Git 与协作冲突与回退冲突需要人工决定两边改动如何共存,回退让项目恢复到已知状态。
Git 与协作Clone 克隆仓库把远程仓库的历史、分支和工作文件复制到本地。
Git 与协作Remote 与 OriginRemote 是远程仓库别名,origin 通常是克隆时自动创建的默认别名。
Git 与协作.gitignore 忽略规则声明哪些未跟踪文件不应进入 Git 版本历史。
Git 与协作Diff 差异逐行显示两个版本、提交或工作状态之间的变化。
Git 与协作Stash 暂存工作把尚未提交的本地改动临时收起,稍后再恢复。
Git 与协作Tag 与 ReleaseTag 固定指向一个历史版本,Release 在此基础上附加说明和制品。
Git 与协作Pull Request 合并请求把一个分支的改动提交给团队讨论、检查并合并。
Git 与协作Code Review 代码审查由他人或自动工具检查改动的正确性、风险和可维护性。
设计与体验视觉层级用大小、位置、颜色和对比度告诉用户先看什么、再看什么。
设计与体验留白与间距留白是让内容呼吸的空区域,间距用稳定规律表达元素关系。
设计与体验网格与对齐网格提供稳定列和基线,对齐让不同元素形成可扫描的秩序。
设计与体验排版通过字体、字号、行高、字重和行长组织阅读体验。
设计与体验颜色与对比度颜色表达品牌和状态,对比度确保文字与控件看得清。
设计与体验一致性与设计系统设计系统用共享规则、组件和变量保持产品在不同页面表现一致。
设计与体验可供性与交互反馈可供性让用户看得出能怎么操作,反馈说明操作是否发生和结果如何。
设计与体验响应式信息密度与可用性不同屏幕应重新安排内容密度和操作方式,而不是机械缩放。
设计与体验Design Token 设计变量用命名变量集中表达颜色、间距、字号和圆角等设计决策。
设计与体验Iconography 图标系统用一致的图形语言表达常见对象、状态和动作。
设计与体验Border Radius 圆角控制元素边角弧度,影响组件边界和整体气质。
设计与体验Shadow 阴影用明暗和模糊模拟元素层级或悬浮关系。
设计与体验Opacity 透明度控制元素整体与背景混合的程度。
设计与体验Gradient 渐变在两个或多个颜色停靠点之间平滑过渡。
设计与体验Spacing Scale 间距尺度用有限的一组间距值控制组件内外留白,形成稳定节奏。
设计与体验Hover、Active 与 Focus分别表示指针悬停、正在按下或选中,以及键盘焦点所在状态。
设计与体验Disabled 禁用状态表示当前控件不可操作,并说明需要满足什么条件。
设计与体验Transition 界面过渡用短暂动画解释元素从一个状态到另一个状态的变化。
设计与体验Easing 缓动曲线决定动画在开始、中间和结束阶段的速度变化。
设计与体验Microcopy 微文案按钮、提示、错误和空状态中的短文字,帮助用户理解下一步。
设计与体验Empty State 空状态设计当没有数据时解释原因,并提供合理的下一步。
设计与体验Progressive Disclosure 渐进披露先展示最常用信息,需要时再展开高级细节。
产品与需求User Story 用户故事用“谁、为什么、要做什么”描述用户需要获得的结果。
产品与需求Jobs to Be Done 待办任务从用户要完成的进步或任务出发,而不是从产品功能出发。
产品与需求Persona 用户角色基于真实研究总结的一类典型用户及其目标、能力和限制。
产品与需求User Flow 用户流程描述用户从入口到完成目标经过的页面、动作和分支。
产品与需求Wireframe 线框图用低细节结构草图确定页面信息和操作位置。
产品与需求Prototype 交互原型用可点击或可运行的模型模拟关键流程和状态。
产品与需求MVP 最小可行产品用最小完整范围验证核心价值,而不是发布一个残缺页面。
产品与需求Acceptance Criteria 验收标准用可观察、可重复的条件定义一个需求何时算完成。
产品与需求Roadmap 与 BacklogRoadmap 表达阶段目标,Backlog 保存按优先级排列的候选工作。
产品与需求Analytics Event 行为事件按统一名称记录用户在产品中的关键动作及必要上下文。
质量、安全与性能Unit Test 单元测试隔离验证一个函数、类或小组件在给定输入下的行为。
质量、安全与性能Integration Test 集成测试验证多个模块、数据库或服务连接在一起时是否正确协作。
质量、安全与性能E2E 端到端测试从用户入口出发,在真实浏览器中验证完整业务流程。
质量、安全与性能Regression Test 回归测试在修改后重新验证曾经正常或曾经出错的功能没有退化。
质量、安全与性能Core Web Vitals 核心体验指标用加载、交互和布局稳定性指标衡量网页真实用户体验。
质量、安全与性能XSS 与 CSRFXSS 注入恶意脚本,CSRF 借已登录身份诱导浏览器发送非预期请求。
质量、安全与性能Secrets Management 密钥管理安全保存、分发、轮换 API Key、密码和证书等敏感配置。
质量、安全与性能Accessibility Testing 无障碍测试用自动检查与键盘、读屏人工验证界面是否可被不同用户使用。
EIGHT DOMAINS
八个领域,建立完整技术地图
每个领域都从用户语言出发,再连接到机制、边界与可验收结果。
LEARNING PATHS
不从目录学,从目标开始
每条路径都以一个真实任务收束,学完就能把需求说清楚并检查 Agent 的结果。
从页面结构开始,理解浏览器如何显示并运行一个网页。
8 个步骤 02让首页重点清晰把模糊的“高级一点”拆成层级、排版、留白和响应式验收。
9 个步骤 03做好表单和交互反馈让输入、选择、校验、提交和结果反馈形成完整链路。
11 个步骤 04连接前端与 API看懂网页如何请求后端、处理状态并展示数据。
10 个步骤 05理解登录与权限区分身份、会话和具体操作权限,避免只做前端假保护。
9 个步骤 06使用 Git 与 Agent 安全协作让 Agent 在明确仓库、分支和提交范围内工作并保留回退能力。
12 个步骤 07看懂 Agent、MCP 与 RAG理解模型如何接收上下文、调用工具和引用外部知识。
14 个步骤 08构建、部署并验收线上网站从依赖安装到正式构建、上线、检查和回滚走完整流程。
13 个步骤AGENT SKILL
让 Agent 直接调用 RailWise 知识
安装 railwise-kb,在同一入口检索图鉴、工程知识和产品文档,并保留公开来源。
