# Scriptables

**Repository Path**: im3x/Scriptables

## Basic Information

- **Project Name**: Scriptables
- **Description**: iOS14神器Scriptable桌面组件插件原创分享（仅同步用）
- **Primary Language**: JavaScript
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: https://github.com/im3x/Scriptables
- **GVP Project**: No

## Statistics

- **Stars**: 50
- **Forks**: 17
- **Created**: 2020-10-09
- **Last Updated**: 2024-05-07

## Categories & Tags

**Categories**: ios-modules

**Tags**: None

## README

# Scriptables
iOS14桌面组件神器（Scriptable）原创框架，脚本开发教程、精美作品分享！    
本项目的框架和插件代码，都是本人手机上一个一个字符屏幕敲出来，一行一行代码调试的用心作品    
如果能得到您的喜欢，欢迎点个 ★ Star ★ 给予小支持，感谢您的使用，也同时欢迎大家一起参与改进完善 ❤️    

## 官方小程序
> 开发者可在上边发布/出售自己的原创作品（内测中）  
![「小件件」](https://i.loli.net/2020/10/23/f4X13xhH652VJ7g.png)    

开发者交流群：https://x.im3x.cn/images/qun1.jpeg


👉 [点击查看 5 分钟演示视频](https://v.qq.com/txp/iframe/player.html?chid=17&vid=c31599njg4i&autoplay=true&full=true&show1080p=true)

![screenshot.jpg](https://i.loli.net/2020/10/13/hTVMr3EWO1xCNGL.jpg)

# 快速使用
1. iPhone 上下载 [Scriptable](https://apps.apple.com/cn/app/scriptable/id1405459188) App（确保你的系统已更新为 iOS14+）    
2. Safari点击下载：[国内Gitee源，推荐](https://im3x.cn/scriptables/Loader.Gitee.scriptable)、[GitHub版源](https://im3x.cn/scriptables/Loader.Github.scriptable)，然后点击下载的文件，用`Scriptable` App打开
2. 手动版：打开App，点击右上角 + 号，复制项目中对应的 [loader.github.js](loader.github.js) 或 [loader.gitee.js](loader.gitee.js) 代码    
3. 长按桌面，添加组件，选择 `Scriptable`，然后点击组件配置，选择刚刚保存的脚本，下方的参数格式为：`插件名@版本号:自定义参数`     
例如，我要显示`one`每日图文组件，配置下方输入`one`或`one@latest`即可（显示昨天的文章输入配置`one:1`，依此类推）。    

![](https://i.loli.net/2020/10/12/xf5utXvBWdC3F1g.jpg)

**更多插件的配置参数，请查阅插件目录的`README.md`说明**

# 组件列表
> 参数的意思，就是添加桌面组件时，选择加载器，然后下方参数中输入的内容    
> 更多参数配置，可以进入项目代码库中组件的目录，有更详细说明    

|名称|说明|示例参数|
|---|---|---|
|[one](one/)|韩寒ONE·一个图文|`one`|
|[v2ex](v2ex/)|V2EX 最新、最热文章|`v2ex@api`|
|[bing](bing/)|Bing 每日必应壁纸|`bing`|
|[zhihu](zhihu/)|知乎热榜等 |`zhihu`|
|[weibo](weibo/)|微博热搜榜|`weibo`|
|[一言](一言/)|随机更新一句话|`一言`|
|[毒鸡汤](毒鸡汤/)|随机更新一条毒鸡汤|`毒鸡汤`|
|[彩云天气](彩云天气/)|显示当前位置的天气预报情况|`彩云天气`|
|[彩票开奖](彩票开奖/)|展示最近一起开奖内容|`彩票开奖`|
|[支付宝盒子](支付宝盒子/)|展示、打开支付宝常用功能|`支付宝盒子`|
|[微信扫一扫](微信扫一扫/)|展示、打开微信扫一扫功能|`微信扫一扫`|
|[知乎日报](知乎日报/)|显示知乎日报文章信息|`知乎日报`|
|[网易云音乐](网易云音乐/)|网易云音乐热评等|`网易云音乐@热评`|
|[bilibili](bilibili/)|哔哩哔哩粉丝数|`bilibili@fans:446791792`|
|[今天是周五吗](今天是周五吗/)|即刻今天是周五吗|`今天是周五吗`|
|[锦囊妙计](锦囊妙计/)|锦囊妙计 一个包含众多骚话的插件|`锦囊妙计` 或 `锦囊妙计:舔狗日记` 或 `锦囊妙计:网抑云` ...|

## 框架优势
1. 简单方便，无需像其他组件一样，一个个复制代码编辑保存添加。框架直接添加一个加载器，后续全靠灵活的配置    
2. 灵活更新，插件有新功能，直接在线更新最新版本，而无需再手动复制代码保存等操作    
3. 功能强劲，经过多次的代码重构，解决了无数个坑的经验，保证了插件的更稳定运行环境    
4. 开发速度，直接套用模板，获取数据、展示数据，非常的简单， **插件代码还可以直接单独脱离框架执行**

## 插件开发
每一个项目，都创建一个文件夹，可以是中英文，最好不要有其他特殊符号。    
文件夹中存放该项目的版本号等文件，比如：    
1. `latest.js` 最新版本代码文件    
2. `README.md` 插件说明使用文档    
3. `v2.0.0.js` 其他版本或功能区分文件    

测试的时候，添加桌面组件，选择加载器，然后参数输入格式：`项目文件夹名@版本号:参数`，比如`v2ex`项目中有个`api.js`代码文件，传递：`v2ex@api:hot`类似格式的配置，也可以直接输入项目名即可（版本号默认latest，参数默认脚本定义）

插件代码，请直接复制项目中的`template.sample.js`模板编辑


**2020/10/13 17:00更新：加载器支持输入第三方开发者的插件配置**    

比如开发者 `user-a`， fork 了本项目到自己的仓库，编辑了 `welcome/latest.js` 组件脚本，那么用户在添加桌面组件时，输入参数：`user-a/welcome@latest` 即可加载第三方开发者仓库的组件代码。    

> 注意：由于用户可能使用的是`Gitee`源加载器，所以你应该也需要前往 [Gitee](https://gitee.com)，创建同名用户+仓库，同步 github 仓库项目

（和之前的参数区别就是前边多了 `用户名/` 格式）

开发者可以直接复制 [template.sample.js](template.sample.js) 代码，打开 Scriptable 应用，添加粘贴代码，然后根据底部的注释取消注释相关代码，即可进行测试、独立运行操作。     
待测试完毕，可直接上传到自己的仓库项目中，然后根据上边方法进行远程加载测试。

如果测试都没问题，可以直接向本项目PR更改，谢谢每一位参与研究的开发者！

## 教程系列
> 公众号集合文章：[#scriptable](https://mp.weixin.qq.com/mp/appmsgalbum?__biz=MzI5NTIwMDQxOA==&action=getalbum&album_id=1546917207903928321&scene=173#wechat_redirect)

1. [Scriptable 神器试玩，创建一个显示自定义标题内容的 iOS14桌面组件](https://mp.weixin.qq.com/s?__biz=MzI5NTIwMDQxOA==&mid=2247484293&idx=1&sn=128fd10f72e8bf0778d9e7575fa85c4a&chksm=ec567048db21f95eb223ad4504405de12612b94f5caa4c4cd611c448ee3b374a059d66c7acbe&scene=178#rd)
2. [Scriptable 神器实战2 —— 给桌面组件添加自定义背景图片](https://mp.weixin.qq.com/s?__biz=MzI5NTIwMDQxOA==&mid=2247484299&idx=1&sn=cddb9bc6af87eb8b63fb2b893e382111&chksm=ec567046db21f950b700d5845fe3778099c3888983ffd0a173f3f2dde7092bf3f862161add90&scene=178#rd)
3. [Scriptable 神器实战3 —— 夜间模式动态展示](https://mp.weixin.qq.com/s?__biz=MzI5NTIwMDQxOA==&mid=2247484312&idx=1&sn=967781d268224b794a21ddb940324f77&chksm=ec567055db21f943979e092ebb4195864590212393b1b8f7f5b3d4ea84f7fdf11eec7f56b48f&scene=178#rd)
4. [Scriptable 神器实战4 —— 获取桌面组件的大小以自动展示内容](https://mp.weixin.qq.com/s?__biz=MzI5NTIwMDQxOA==&mid=2247484324&idx=1&sn=b7bc2a4a513f719ce6e6423d03ba6803&chksm=ec567069db21f97ff3407d053aa708d408058c525d1cb9fc80a64ce9ca0e6b9133f4568a20e0&scene=178#rd)
5. [Scriptable 神器实战5 —— 给桌面组件添加一个渐变色背景](https://mp.weixin.qq.com/s?__biz=MzI5NTIwMDQxOA==&mid=2247484331&idx=1&sn=82802dd0d11fee43587f71cac6ce6109&chksm=ec567066db21f970ac13bf9ff902cee43475919a9e136a16eb2766c9cef5a6518b6d14bcab57&scene=178#rd)
6. [Scriptable神器实战6 —— 给背景图片加上半透明遮罩](https://mp.weixin.qq.com/s?__biz=MzI5NTIwMDQxOA==&mid=2247484345&idx=1&sn=7ebaa57bdf09ca5517b9ca58a12f88b8&chksm=ec567074db21f96234bd0591530b02c0c9bb3c951923fee19ebbb877e52aac56d5b8bd4d27af&scene=178#rd)
7. [Scriptable神器实战7 —— 获取用户添加组件时的自定义参数](https://mp.weixin.qq.com/s?__biz=MzI5NTIwMDQxOA==&mid=2247484350&idx=1&sn=f4c5b25b2d9f7e66bdfbe9150e234864&chksm=ec567073db21f965a5164e2ab27bacfc2b246e4be31ca3a4f23fb96e9c5d543e4ac97310b7bc&token=1302596105&lang=zh_CN#rd)
8. **[Scriptable 实战之 —— 桌面组件交互之王](https://mp.weixin.qq.com/s?__biz=MzI5NTIwMDQxOA==&mid=2247484386&idx=1&sn=c88ddafedad97a3bcfed50f92d16ac5a&chksm=ec56702fdb21f939a3b45305a7a9056fd25bbcb41b69d6f9c7ced34ff46f5f32a913d40ba1ae&scene=178#rd)**.   
9. [Scriptable神器实战 8 —— 本地存储 Keychain 用法](https://mp.weixin.qq.com/s?__biz=MzI5NTIwMDQxOA==&mid=2247484386&idx=2&sn=1b481bb66e0c373d8fd39dfede72575a&chksm=ec56702fdb21f939f07701aeead4375abc02450177565c96d937f9bfa0262ed12e378bca108a&scene=178#rd)    
10. [Scriptable神器实战 9 —— Base64 数据编码/解码操作](https://mp.weixin.qq.com/s?__biz=MzI5NTIwMDQxOA==&mid=2247484392&idx=1&sn=957336092b12715d60261fda1b6f1d4b&chksm=ec567025db21f9338f0d7659a589cac8cf7a286ec1a940fb960cae63da038d29a0f5ee0fdc91&scene=178#rd)    
11. [Scriptable神器实战 10 —— MD5 加密字符串](https://mp.weixin.qq.com/s?__biz=MzI5NTIwMDQxOA==&mid=2247484403&idx=1&sn=9c8e97fa311ed83d4b5e6763d7f7fd07&chksm=ec56703edb21f9288ff6058c170f1423b9a996d6e776eaf86e6c0df7839b28261f87eef08d40&scene=178#rd)
12. [Scriptable神器实战 11 —— 利用弹窗输入设计一个用户登录系统](https://mp.weixin.qq.com/s?__biz=MzI5NTIwMDQxOA==&mid=2247484411&idx=1&sn=5c31328b145391bd5ef3328658e6acb5&chksm=ec567036db21f92086f851a5ad26f28ea47652cbde197c375a13d7647abc005a458605c7ecac&scene=178&cur_album_id=1546917207903928321#rd)
13. [Scriptable神器实战 12 —— 剪贴板复制粘贴操作](https://mp.weixin.qq.com/s?__biz=MzI5NTIwMDQxOA==&mid=2247484419&idx=1&sn=4ea1aad4f038fb26666e38f7cf396c2f&chksm=ec5677cedb21fed88e4e8ef02d481d3971fc177a7ffff101f0d5f57d9bf37556183e66cbc905&scene=178&cur_album_id=1546917207903928321#rd)    
14. [Scriptable神器实战 13 —— FileManager 文件操作管理指南](https://mp.weixin.qq.com/s?__biz=MzI5NTIwMDQxOA==&mid=2247484425&idx=1&sn=48f85af1b29ee2cd29a7a492abbf18ce&chksm=ec5677c4db21fed293eacaaa736a70aa5aa6d14704d924aa76048ec48b76472a520a3ff67742&token=1720312716&lang=zh_CN#rd)

更多文章连载更新中，扫一扫关注【古人云】公众号，第一时间获取更新：    
![](https://i.loli.net/2020/10/13/9hXdRNUg5qSreHk.jpg)