Skip to content

快速使用

适用范围

由于工具箱尚在早期开发阶段,这里的快速使用如无特殊标注,则默认仅针对最新版本哦。

0.2.1之后,工具箱现在需要通过正儿八经的安装程序安装在系统中。您可以从 这里(本文档中的版本列表页面)这里(GitHub的Release页面)这里(帆域上的版本更新记录页面) 下载最新版本的安装包。

登录

工具箱强制要求登录后使用。

通过帆域账户登录

帆域账户登录0.2.3版本开始,工具箱提供两种登录方式,其中建议方式是使用帆域账户登录。

帆域

帆域 是芒果帆帆设计的、基于WordPress+Zibll主题构建的网站,域名是ifanspace.top

通过帆域登录 是由帆域网站作为 Oauth 服务器,由工具箱作为 Oauth 客户端,二者通过 Oauth 2.0 协议实现对用户资料的访问,只有在用户完成授权之后,工具箱才能获取用户的资料,包括有效的电子邮件地址、昵称、头像,与用户在帆域网站上的其他一些资料。

首次使用帆域账户登录时,工具箱将会打开一个内嵌浏览器页面,用户需要在其中完成帆域账户的登录,可能需要输入账号密码,使用第三方(QQ等)登录或使用手机与邮箱进行免密登录。登录完成后,页面会自动关闭,工具箱向帆域请求授权凭证, 凭证会在工具箱的数据目录中明文保存 ,同时使用凭证访问用户资料。

当工具箱的数据目录中存在凭证时,下一次工具箱启动后会自动加载,并尝试向帆域申请刷新授权凭证。此时你可以选择 使用保存的凭证登录 ,无需每次都在新的登录页面中重复一次登录流程。登录凭证的有效期是三天,三天之后将需要重新登录。

当然,如果你从未听说过帆域这个网站,芒果建议先在你自己的浏览器中访问网站,并考虑创建一个账号。如果你并不想这么做,也可以使用下面的另一种登录方式来使用工具箱。

通过电子邮件地址登录

登录窗口 工具箱实现了一个临时的账号登录系统。在重构之后、0.2.2及以前的版本,这是使用工具箱的唯一登录方式。此登录方式不会检查用户提供的邮箱是否可用,因此建议使用帆域账户登录。

  • 邮箱 - 需要一个电子邮件地址,每个账号都与一个邮箱绑定。目前不需要该邮箱实际可用,甚至不会检查该邮箱是否合法。
  • 激活码 - 充当密码的角色,但是并非强制性。如果邮箱账号没有设置激活码,则登录时也无需输入。

使用一个未注册过的邮箱连续登录两次即可注册,以后可以使用该邮箱登录。若邮箱未注册,则第一次登录时会有注册提示。注册时输入的激活码将作为该邮箱账号的激活码。激活码一旦设置就无法取消只能更改。

如果尝试注册时得到登录失败,可能是该邮箱已被使用。目前的系统不会验证邮箱的所属(毕竟只是临时系统),所以随便换个吧……注册完毕后应当会自动登录。下次使用工具箱时,使用邮箱和激活码(如无则留空)登录即可。

目前的用户系统中,可以在工具箱首页更改账号资料,但不支持更改邮箱,不支持撤销已经设置的激活码,不支持删除激活码。

此登录方式下的头像系统使用cravatar.cn,玩网站的朋友萌可能会有所听闻这个头像服务,这意味着如果您使用包含QQ号的QQ邮箱,可以默认加载该QQ的头像。

测试模式

如果您正在从源码启动工具箱,则需要使用测试模式启动工具箱本体。测试模式下您无需登录便可直接打开工具箱,但所有用户系统方面的特性将无法使用。

考虑到登录过程的不确定性以及繁琐性,反复多次地需求登录会让人非常头大,因此我们为以上登录方式制作了保存凭证的功能。如果您正在开发一个工具,需要反复重启工具箱来应用最新的工具源码更新,则请通过源码并启用测试模式。

系统托盘图标

工具箱默认在关闭(从窗口右上角)时不会完全退出,而是保存在系统托盘中。这样可以避免不小心关闭工具箱的情况发生。

窗口左下角的退出按钮会完全退出工具箱。

您可以在设置选项中关闭系统托盘图标特性,关闭之后,下次启动工具箱后再从右上角关闭时就不会保存在系统托盘中,而是正常关闭窗口,工具箱会在所有工具窗口都关闭后退出。

使用工具

使用工具即可。

未来会支持工具的导入、导出与本地编辑工具源码,支持开发调试自己的工具。工具系统与工具箱本体已经处于解耦状态,但目前工具还只能跟随工具箱本体一同更新。

关于&设置

就是关于&设置捏……

贡献者

页面历史

License: GPL-v3. 芒果工具箱与其有关文档均为GPL-v3协议开源。