# 小山羊口令 **Repository Path**: xiaoshanyangcode/kouling ## Basic Information - **Project Name**: 小山羊口令 - **Description**: 开源的andorid 2FA 动态令牌软件，轻量，无广告，支持多设备自动同步；对重度使用者友好，一个页面能直接展示10个左右的口令，还可设置不同的颜色备注等。 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2024-12-28 - **Last Updated**: 2024-12-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README #### 软件下载页面 https://gitee.com/xiaoshanyangcode/kouling/releases #### 软件介绍 开源的andorid 2FA 动态令牌软件，轻量，无广告，支持多设备自动同步；对重度使用者友好，一个页面能直接展示10个左右的口令，还可设置不同的颜色备注等。 ### 软件效果展示 ![输入图片说明](README-image/%E6%95%88%E6%9E%9C-new.png) ##### 背景：为什么我要写这个软件？ 1.目前主流的同类软件基本上数据都不掌握在用户手里。 2.添加动态令牌的二维码中，通常包含了平台名称，用户名（如下图红框的内容）。这些用户隐私信息，通常会被软件提供方获取到。 ![输入图片说明](README-image/image-20241228220153298.png) 3.有些同类软件，跨设备同步的逻辑不是很好。 ##### 小山羊口令 实现了什么？ 1.开源（核心加密算法未开源），不获取用户数据，远程数据只加密存储在用户自己创建的gitcode代码仓库中（用于跨设备同步和数据备份）。 2.在添加令牌时，上图红框的2个敏感用户信息可以直接在修改后保存（如下图：名称，备注，颜色都可以修改）。可以保存为只有用户自己能懂的，还可以为不同的口令设备不同的背景色。 ![image-20241228221306054](README-image/image-20241228221306054.png) 3.每次打开软件，会自动同步最新的数据到本设备。无网情况下能正常使用。 4.使用流畅丝滑。 ##### 软件架构 采用tauri2.0框架，主要逻辑是用vue来实现，核心加密逻辑（未开源）用rust代码实现。 ![image-20241228222757521](README-image/image-20241228222757521.png) ##### 目前支持的平台 目前只支持andorid。 原本想开发windows客户端，但是windows的数据存储没有andorid的安全，而且本产品存储的数据很重要。考虑再三，决定不做windows客户端。没接触过ios，所以就没开发ios客户端。 ##### 为什么选用gitcode仓库来同步用户数据 通过github类的平台创建的私有仓库，可以免费的把数据（本软件会先加密数据）存储在云端，实现备份和跨设备同步的功能。 | | github | gitee（码云） | gitcode（CSDN和华为云合作） | coding（腾讯旗下） | 云效（阿里云） | | ---------- | ------ | ------------- | --------------------------- | ------------------ | -------------- | | 网络稳定性 | 差 | 好 | 好 | 好 | 好 | | 接口友好性 | 好 | 好 | 好 | 差 | 好 | | 使用的人数 | 多 | 多 | 相对少 | 不知道 | 不知道 | 从上表可以看出，选用gitee和gitcode都是不错的选择（云效其实也行，未来考虑支持）。有一个问题是，目前gitee和gitcode的访问令牌都是有整个账号所有仓库的权限，因为gitee使用的人更多，本软件需要令牌有读写的权限，从保护用户隐私的逻辑，选择避开gitee。gitcode可以通过手机号和csdn可以快速注册，而且本软件本地也会存储一份数据，不太怕平台出bug和跑路。 #### 使用步骤 ##### 1.创建：gitcode账号 访问https://gitcode.com创建账号（可手机号快速创建账号，用csdn账号也可以创建gitcode账号） ##### 2.创建：仓库地址 访问https://gitcode.com/setting/repo 创建，参考下图 ![image-20241228231300103](README-image/image-20241228231300103.png) 点击上图“创建按钮”会自动跳转到下图的页面 **红框里的就是小山羊口令要用的“仓库地址”** : `https://gitcode.com/hahaha234q24352/kouling` （每个用户的都不一样；注意：最后没斜杠） ![image-20241228231645510](README-image/image-20241228231645510.png) ##### 3.创建：访问令牌 访问 https://gitcode.com/setting/token-classic 创建令牌，可参考下图 ![image-20241228230647806](README-image/image-20241228230647806.png) ##### ##### 4.使用“小山羊口令” 正常使用即可。 **同步和密码相关的使用介绍：** 在“配置同步”中，输入上面步骤创建的“仓库地址”和“访问令牌” 即可实现每次打开软件时自动同步最新到本设备；本设备所有的添加，修改，删除操作也会自动同步到gitcode仓库中（因为要同步，所以添加，修改，删除在保存时会有几秒的等待）。 在"配置密码"中设置的密码，用途是：在做添加，修改，删除操作前需要验证密码，防止误操作。 如果密码忘记，可通过输入"访问令牌"重置密码。 如果"访问令牌"忘记或过期了，重新创建一个"访问令牌"即可。 ![image-20241228233834229](README-image/image-20241228233834229.png)