资讯动态

run-abroad 润学导航贡献指南:如何在 js/data.js 里新增一条签证路径并通过 validatePathways 自动自检

发布时间:2026/10/30 4:35:09 来源:尧图企业网站定制
【免费下载链接】run-abroad填 10 项基本信息从 71 条签证 / 移民路径里筛出适合你的并告诉你还差什么项目地址https://gitcode.com/gh_mirrors/ru/run-abroad点击查看免费下载本文面向新手讲解开源项目run-abroad润学导航的完整贡献流程在 js/data.js 的PATHWAYS数组里按规范新增一条签证 / 移民路径再用浏览器控制台里的validatePathways()自动自检确保数据无误后提交。无需安装任何依赖克隆仓库、改一行数据、刷新页面即可看到效果。一、先了解项目结构为什么改一个文件就够了run-abroad 是一个纯静态、零依赖的决策工具填 10 项基本信息从 72 条签证 / 移民路径中筛出适合你的并告诉你还差什么。所有计算都在浏览器里完成没有后端。项目刻意不做模块化和打包三个核心 JS 文件按顺序用script引入见 index.html 底部文件作用js/data.js路径数据集本文主角包含PATHWAYS数组与等级编码js/engine.js匹配引擎把你的条件与门槛逐项比对js/app.js表单与结果渲染页面加载时触发数据自检官方字段规范全部写在 CONTRIBUTING.md 里本文是它的可视化补充。二、一键克隆与本地预览仓库是只读的克隆到本地fork 后再修改git clone https://gitcode.com/gh_mirrors/ru/run-abroad cd run-abroad没有构建步骤、没有 npm。直接双击 index.html 打开或起个本地服务器python3 -m http.server 8000 # 浏览器访问 http://localhost:8000 小提示部分浏览器在file://下控制台告警会多一些建议统一用本地服务器预览。三、读懂路径数据结构js/data.js 长什么样打开 js/data.js核心就是 PATHWAYS 数组——每条路径一个对象。以新西兰打工度假签证为例js/data.js#L211-L224{ id: nz-whv, country: 新西兰, flag: , name: 打工度假签证 (WHV), nameEn: Working Holiday Visa, type: workholiday, duration: 12 个月, pr: 本身不通往永居但可在境内转学签或技术工签, req: { age: [18, 30], minDeg: DEG.highschool, minEng: ENG.ielts55, fundsUSD: 3000 }, quota: 中国大陆每年 1000 个名额开放即秒光, cost: 签证费约 NZ$470 机票 押金资金证明, difficulty: 3, notes: 门槛最低的一条「先出去」路线……, official: 政府官网链接, }理解数据前先认识文件头部的等级编码js/data.js#L13-L14门槛字段都引用它们而不是写死文字常量含义取值DEG学历none/highschool/college/bachelor/master/phdENG英语none/daily/ielts55/ielts65/fluentFRA法语none/basic/mid/nclc7单独建模因为法语能打开英语打不开的门req 门槛字段速查req里的字段全是门槛留空 无此要求js/data.js#L202-L208字段说明示例age年龄区间[18, 30]minDeg最低学历DEG.bacheloruniRank院校世界排名档位50/100/200/500gradWithin毕业几年内5minEng/minFrench最低英语 / 法语ENG.ielts55otherLang小语种开关{ code: ja, label: 日语 N2 }code见 LANGSworkExp最低工作年限3jobOffer是否需要当地 offertruefundsUSD资金证明美元3000studyIn学位必须在该地取得hk取值见 STUDY_LOCskills技能方向满足其一即可[tech, science]取值见 SKILLStype必须在 TYPE_LABEL 中已定义共 10 种workholiday打工度假、jobseek毕业生找工作签、talent人才引进、skilled技术移民、work工作签证、study留学转移民、vocational职业教育、nomad数字游民、invest创业 / 投资、soft软着陆 / 落脚点。四、新增签证路径的完整步骤⚠️ 最重要的一条规则没有政府官网来源的修改无法合并。动手前先找到该签证的官方页面。第 1 步确定插入位置。PATHWAYS数组按类型分区如 打工度假区、毕业生找工作签区 js/data.js#L268把新对象加进同类型分区里方便维护。第 2 步复制一个相近的路径对象作模板逐字段改写。注意三个必填项id唯一命名惯例为「国家代码 简称」如nz-whv、uk-hpiofficial必须是政府官网链接notes写别处查不到的实操信息不要复述门槛第 3 步如果新路径涉及一个新国家别漏掉两处同步自检也会检查在 REGION_OF 里把国家归入地区asia/eu/na/oc/latam/other在 INCOME_SOURCE_LOCATIONS 里补充该国家名第 4 步可选补充详情页深度内容。部分路径带有detail字段参考 EB-5 的写法包含timeline、steps办理步骤、docs材料清单、pitfalls坑和links由 js/detail.js 渲染到 pathway.html。这是最有价值的加分项。写 notes 的原则写实操不复述门槛CONTRIBUTING.md 给出的标准✅ 「近年因申请量暴增设置了年度处理上限等待期显著变长市面上大量『包过』中介风险很高」❌ 「这是一个适合年轻人的好签证」没有信息量请用自己的话总结不要大段复制官网原文。五、validatePathways 自动自检提交前最后一道关打开 index.html按F12查看控制台。validatePathways()会在页面加载时自动运行js/app.js#L631-L636结果以[数据校验]前缀打印告警——如果新路径一切正常控制台是干净的什么都没有。这个函数的完整逻辑在 js/data.js#L1373-L1393它检查 5 类问题检查项控制台告警示例怎么修重复id重复 id: nz-whv给新路径换一个唯一id缺失必填字段xx-visa 缺少字段 official补齐country/name/type/duration/notes/official六项type未定义xx-visa 的 type xxx 未定义从 TYPE_LABEL 的 10 个合法值里选新国家未归入地区xx-visa 的国家「XX」未归入地区请补 REGION_OF同步 REGION_OF新国家未加入收入来源选项xx-visa 的国家「XX」未加入 INCOME_SOURCE_LOCATIONS同步 INCOME_SOURCE_LOCATIONS 在控制台里还能直接手动复查输入validatePathways()回车返回值就是问题列表数组空数组[]表示全部通过。六、手动验证别漏写门槛自检只查数据完整性查不出逻辑错误。提交前还要做人工测试在表单里填几组不同的条件如年轻 / 高学历 / 强语言与年长 / 低学历 / 无语言确认新路径出现在合理的分档里符合条件 / 差一点 / 需要长期准备 / 暂时走不通重点确认新路径不会对所有人都显示「符合条件」——这通常意味着req里漏写了某个门槛另外别忘了刷新后页面右上角的路径总数js/app.js#L636 渲染的#total应比原来多 1。七、常见坑清单坑说明用文字写门槛minDeg等字段必须引用DEG/ENG/FRA常量不能写「本科」这样的字符串otherLang的code写错只能从 LANGS 选de/ja/ko/es/nordic复制了旧路径忘记改id会触发「重复 id」告警页面匹配结果也会串数据学生类路径塞进主数据语言学校、互惠生等应进 js/student-data.js独立维护不污染主项目的 72 条路径official指向非官网只接受政府官网链接这是合并的硬性条件结语你的第一条贡献可以很简单整个流程只有三步克隆仓库 → 在 js/data.js 里照模板加一个对象 → 打开页面看控制台。零依赖的设计意味着改一行数据、刷新页面就能看到效果。如果你发现某条路径的数据已经过时移民政策变动极快提 Issue 并附上官网链接同样是最高价值的贡献。更多规范细节见 CONTRIBUTING.md项目基于 MIT License数据和代码都可自由使用。赞分享【免费下载链接】run-abroad填 10 项基本信息从 71 条签证 / 移民路径里筛出适合你的并告诉你还差什么项目地址https://gitcode.com/gh_mirrors/ru/run-abroad点击查看免费下载相关推荐run-abroad 润学导航 72 条路径全解11 大类型 × 32 个国家地区可按条件筛选的签证移民路径清单run abroad 润学导航 72 条路径全解11 大类型 × 32 个国家地区可按条件筛选的签证移民路径清单 开源项目 run abroad润学导航run-abroad 润学导航香港签证专题7 道题横评高才通 A/B/C、IANG 与专才 5 条路径附断签风险run abroad 润学导航香港签证专题7 道题横评高才通 A/B/C、IANG 与专才 5 条路径附断签风险 run abroad润学导航是一款开源run-abroad 润学导航大学生专题14 条学生出国路径打工度假、语言学校、互惠生、船员全解析run abroad 润学导航大学生专题14 条学生出国路径打工度假、语言学校、互惠生、船员全解析 run abroad润学导航是一个免费、开源的出国上一篇基于 ESP-IDF v5.5 安全迁移硬件 SHA 子函数 API 必须显式调用 esp_sha_set_mode下一篇pstack 代码评审 Rubric 深度解读用六个对抗式评审视角系统化发现真实缺陷创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑