{"id":18496534,"url":"https://github.com/nicejade/nicelinks-quick-app","last_synced_at":"2025-08-27T02:13:23.705Z","repository":{"id":33736947,"uuid":"143499792","full_name":"nicejade/nicelinks-quick-app","owner":"nicejade","description":"🌪Awesome NICE LINKS（倾城之链)  client built with quickapp（快应用）.","archived":false,"fork":false,"pushed_at":"2023-01-06T01:59:43.000Z","size":1787,"stargazers_count":30,"open_issues_count":10,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-23T19:14:21.653Z","etag":null,"topics":["kuai","kuaiyingyong","quickapp","web","webpack"],"latest_commit_sha":null,"homepage":"https://nicelinks.site/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nicejade.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-08-04T05:14:49.000Z","updated_at":"2024-10-28T03:44:59.000Z","dependencies_parsed_at":"2023-01-15T02:30:30.085Z","dependency_job_id":null,"html_url":"https://github.com/nicejade/nicelinks-quick-app","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicejade%2Fnicelinks-quick-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicejade%2Fnicelinks-quick-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicejade%2Fnicelinks-quick-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicejade%2Fnicelinks-quick-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nicejade","download_url":"https://codeload.github.com/nicejade/nicelinks-quick-app/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247940762,"owners_count":21022022,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["kuai","kuaiyingyong","quickapp","web","webpack"],"created_at":"2024-11-06T13:29:54.627Z","updated_at":"2025-04-08T22:32:17.565Z","avatar_url":"https://github.com/nicejade.png","language":"JavaScript","funding_links":[],"categories":["如何访问[「倾城之链」](https://nicelinks.site?utm_source=github.com)"],"sub_categories":["箴言锦语 佳句共赏"],"readme":"\u003ch1 align=\"center\"\u003e\u003ca href=\"https://nicelinks.site?from=github\"\u003e\u003cimg src=\"https://image.nicelinks.site/nice-links-logo.png\" alt=\"倾城之链 | NICE LINKS\"\u003e\u003c/a\u003e\u003c/h1\u003e\n\n\u003ch1 align=\"center\"\u003e倾城之链(快应用版)\u003c/h1\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cstrong\u003e🌪 非凡 \u003ca\u003e快应用 | Quick App\u003c/a\u003e之 \u003ca href=\"https://nicelinks.site/\"\u003e倾城之链 | NICE LINKS\u003c/a\u003e.\u003c/strong\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimage src=\"https://raw.githubusercontent.com/nicejade/nicelinks-quick-app/master/src/assets/images/nicelinks-qrcode-release.png\" width=\"300\" alt=\"倾城之链\" /\u003e\n  \u003cp\u003e您可使用 \u003ccode\u003evivo\u003c/code\u003e、\u003ccode\u003eOPPO\u003c/code\u003e、\u003ccode\u003e小米\u003c/code\u003e、\u003ccode\u003e魅族\u003c/code\u003e等手机，扫如上二维码，即可在手机端体验。\u003c/p\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimage src=\"https://raw.githubusercontent.com/nicejade/nicelinks-quick-app/master/src/assets/images/nicelinks-qrcode.png\" width=\"300\" alt=\"倾城之链\" /\u003e\n  \u003cp\u003e您可使用\u003ccode\u003e\u003ca href=\"https://github.com/nicejade/awesome-quickapp#调试器下载\"\u003e快应用调试器\u003c/a\u003e\u003c/code\u003e扫如上二维码，即可在手机端体验。\u003c/p\u003e\n\u003c/div\u003e\n\n## 目标与哲学\n\n[快应用](https://nicelinks.site/post/5b5fb5bc615bf842b609105f)是基于手机硬件平台的新型应用形态，标准是由主流手机厂商组成的`快应用联盟`联合制定。其标准的诞生将在研发接口、能力接入、开发者服务等层面建设标准平台，以平台化的生态模式对个人开发者和企业开发者全品类开放。[快应用](https://nicelinks.site/post/5b5fb5bc615bf842b609105f)具备传统 APP 完整的应用体验，`无需安装、即点即用`；`覆盖 10 亿设备`，`与操作系统深度集成，探索新型应用场景`。快应用 ── **复杂生活的简单答案，让生活更顺畅**。\n\n此仓库的建立，也是应潮流趋势，为个人作品[倾城之链 | NICE LINKS](https://nicelinks.site/)，所构建的`快应用`；以期提供更为便捷的访问方式，来[倾城之链 | NICE LINKS](https://nicelinks.site/)；同时借此以探索新型应用设计；此外，也是在探索如何构建优质`快应用`，希望可以在此事儿上提供些参考 ── 有写文章一篇：[快应用之开发体验纪要](https://nice.lovejade.cn/zh/article/develop-quick-app-experience-notes.html) (附：[快应用开发文档](https://doc.quickapp.cn/))。\n\n## 组织结构\n\n```\n├── sign                # 存储 rpk 包签名模块;\n│   ├── debug           # 调试环境证书/私钥文件\n│   └── release         # 正式环境证书/私钥文件\n└── src\n│   ├── assets          # 公用的资源(Images/Styles/字体...)\n│   │   ├──images       # 存储 png/jpg/svg 等公共图片资源\n│   │   └──styles       # 存放 less/css/sass 等公共样式资源\n│   ├── helper          # 项目自定义辅助各类工具\n│   │   ├──apis         # 存储与后台请求接口相关(已封装好)\n│   │   ├──ajax.js      # 对系统提供的 fetch api 进行链式封装\n│   │   └──util.js      # 存放项目所需公共工具类方法\n│   ├── pages           # 统一存放项目页面级代码\n│   ├── app.ux          # 应用程序代码的人口文件\n│   └── manifest.json   # 配置应用基本信息\n└── package.json        # 定义项目需要的各种模块及配置信息\n```\n\n```bash\ngit clone https://github.com/nicejade/nicelinks-quick-app.git\ncd nicelinks-quick-app \u0026\u0026 yarn\nyarn start # 推荐 ✅\n\n# 或者运行以下命令\nyarn server \u0026\u0026 yarn watch\n\n# 或者在终端一 Tab 下运行：\nyarn server\n# 在终端另一 Tab 下运行：\nyarn watch\n```\n\n有必要谈及的是，此项目秉承在[高效开发 Web 单页应用解决方案](https://nice.lovejade.cn/zh/article/vue-webpack-boilerplate-template.html)中所传递的理念：为**高效开发**而设计；相比于其内置的简陋 Demo，她具有以下诸多优点：\n\n- [x] **对项目结构进行优化**；如上组织结构所示，将各资源模块，更专业的分门别类，使之可以便捷的去编写、维护、查找，同时也是基于前端开发既定共识去设计，更容易为初接触者所理解 \u0026 上手；\n- [x] **更优雅的处理数据请求**；采用 `Promise` 对系统内置请求 `@system.fetch` 进行封装，并抛出至全局，使得可以极简的进行链式调用，同时便捷地处理返回数据；\n- [x] **内置了样式处理方案**；「快应用」支持 `less`, `sass` 的预编译；这里采取 `less` 方案，并内置了部分变量，以及常用混合方法，使得可以轻松开启样式编写、复用、修改等；\n- [x] **封装了常用方法**；在 `helper/utils` 路径下，有对日期、字符串、系统等常用方法，分别进行封装，统一暴露给 `global.$utils`，使得维护方式更加合理且健壮，同时又可以便捷的使用，高效开发；当然，你也可以根据需要自行增删、抑或扩展；\n- [x] **简化开始开发流程**； 注入 [Concurrently](https://github.com/kimmobrunfeldt/concurrently) 插件，使可以运行 `yarn start` 即可开始开发，而无需更多命令，从而简洁开发流程；\n- [x] **优化本地开发端口设定**；「快应用」默认端口为 `12306`，虽说可自定义端口，但使用体验却不够友好；此处参考 `creat-react-app` 设定，对本地开发地址端口使用进行优化：如果 🈯️ 定端口(默认: `8080`)被占用，则向上递增寻找新的可用端口(如：8081 / 8082 / … )；\n- [x] **浏览器打开调试主页二维码**；运行 `yarn start`，会启动 HTTP 调试服务器，并将该地址在**命令行终端**显示，手机端用快应用调试器扫码，即可下载并运行 rpk 包；当终端积累的信息流多了，就造成扫码不便；故增设在浏览器打开调试主页二维码；如想不使用此功能，在 _command/server.js_ 文件中，将 **autoOpenBrowser** 设置为 `false` 即可；\n- [x] **集成轻粒子统计分析**； [轻粒子](https://nicelinks.site/post/5bdfa8ba9fa22b1b40974f63)作为官方推荐统计方案，此脚手架已做接入；使用时只需修改 [statistics.config.js](https://github.com/nicejade/quickapp-boilerplate-template/blob/master/src/assets/js/statistics.config.js) 中的 `app_key`，为在[轻粒子](http://www.qinglizi.cn/)所申请的快应用 KEY 即可；\n- [x] **添加新增页面命令脚本**；使得可以一键生成新页面，只需运行：`yarn gen YourPageName` （命名推荐统一为大驼峰，将会在 `pages` 路径下新建该页面文件夹）命令即可，当然，也可以根据需要，自行定定制模板：_/command/gen/template.ux_；\n- [x] **集成 [Prettier](https://prettier.io/) \u0026 [Eslint](https://eslint.org/)**；在检测代码中潜在问题的同时，统一团队代码规范、风格（`js`，`less`，`scss`等），从而促使写出高质量代码，以提升工作效率(尤其针对团队开发)。\n- [x] **编写 [prettier-plugin-quickapp](https://github.com/nicejade/prettier-plugin-quickapp) 插件**；为快应用编写 `prettier` 插件，使其可以针对 `.ux`/`.mix` 文件也能很好地工作，从而进一步完善代码风格及规范。\n- [x] **新增文件监听命令**：引入 [onchange](https://github.com/Qard/onchange) 依赖来监听文件变化；使得在开发时，运行 `yarn prettier-watch` 命令，即可对所修改的 `*.md` `*.ux` `*.js` 等文件，进行 **Prettier** 格式化，从而大幅度提升编写效率。\n- [ ] ... ...\n\n## 相关链接\n\n- [**倾城之链**](https://nicelinks.site?from=github)\n- [About Me](https://aboutme.lovejade.cn/?from=github)\n- [个人博客](https://jeffjade.com/nicelinks)\n- [辅助博客](https://blog.lovejade.cn/)\n- [新浪微博](https://weibo.com/jeffjade)\n- [知乎主页](https://www.zhihu.com/people/yang-qiong-pu/)\n- [简书主页](https://www.jianshu.com/u/9aae3d8f4c3d)\n- [SegmentFault](https://segmentfault.com/u/jeffjade)\n- [Twitter](https://twitter.com/jeffjade2)\n- [Facebook](https://www.facebook.com/yang.gang.jade)\n\n| 微信公众号                                             | 前端微信群                                                       | 推荐 Web 应用                                                                              |\n| ------------------------------------------------------ | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |\n| 😉 静晴轩                                              | ✨ 大前端联盟                                                    | 🎉 倾城之链                                                                                |\n| ![静晴轩](https://image.nicelinks.site/qrcode_jqx.jpg) | ![倾城之链](https://image.nicelinks.site/wqycx-weixin.png?ver=1) | \u003cimg src=\"https://image.nicelinks.site/nice-links.png\" width=\"300px\" alt=\"倾城之链\"\u003e\u003c/img\u003e |\n\n## 许可执照\n\n[MIT](http://opensource.org/licenses/MIT)\n\nCopyright (c) 2018-present, [nicejade](https://aboutme.lovejade.cn/?from=github)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicejade%2Fnicelinks-quick-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnicejade%2Fnicelinks-quick-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicejade%2Fnicelinks-quick-app/lists"}