commit b7e7df003cc8ef3ca93fd62ada2d017315c8291a Author: LittleSheep Date: Sun Jul 6 15:13:16 2025 +0800 :tada: Initial Commit diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..af49720 --- /dev/null +++ b/.gitignore @@ -0,0 +1,3 @@ +venv +.cache +.DS_Store diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..33aa3b3 --- /dev/null +++ b/Makefile @@ -0,0 +1,2 @@ +serve: + venv/bin/mkdocs serve diff --git a/docs/assets/images/solarpass-create.png b/docs/assets/images/solarpass-create.png new file mode 100644 index 0000000..2d80c63 Binary files /dev/null and b/docs/assets/images/solarpass-create.png differ diff --git a/docs/assets/images/solarpass-login.png b/docs/assets/images/solarpass-login.png new file mode 100644 index 0000000..1cb4fa1 Binary files /dev/null and b/docs/assets/images/solarpass-login.png differ diff --git a/docs/assets/images/solarpass-multifactor.png b/docs/assets/images/solarpass-multifactor.png new file mode 100644 index 0000000..c4b277b Binary files /dev/null and b/docs/assets/images/solarpass-multifactor.png differ diff --git a/docs/assets/images/stellar-solarpay.png b/docs/assets/images/stellar-solarpay.png new file mode 100644 index 0000000..0d887ee Binary files /dev/null and b/docs/assets/images/stellar-solarpay.png differ diff --git a/docs/en/index.md b/docs/en/index.md new file mode 100644 index 0000000..25f682e --- /dev/null +++ b/docs/en/index.md @@ -0,0 +1,14 @@ +--- +title: Suki +--- + +# Welcome to Suki + +The Suki is stands for **Su**n Wi**ki**pedia. + +!!! note "Fun Fact" + + The Suki is also the word "like" in Japanese (すき). + +Suki contains info about the Solsynth products' user guide and developer docs. +Currently, the docs is mostly about the Solar Network. diff --git a/docs/zh/index.md b/docs/zh/index.md new file mode 100644 index 0000000..0a194e4 --- /dev/null +++ b/docs/zh/index.md @@ -0,0 +1,14 @@ +--- +title: Suki +--- + +# 欢迎来到 Suki + +Suki 的名字是 **Su**n Wi**ki**pedia (太阳维基) 的简写。 + +!!! note "有趣的事实" + + Suki 也是日语中喜欢 (すき) 的单词。小羊花了 0.01s 就想出了这个双关,也是不好说什么 🤔 + +Suki 包含了 Solsynth 用户指南和开发者文档。 +就目前来说,大多数内容都是关于 Solar Network 也就是 SN 的。 diff --git a/docs/zh/solar-network/.nav.yml b/docs/zh/solar-network/.nav.yml new file mode 100644 index 0000000..0d00eb1 --- /dev/null +++ b/docs/zh/solar-network/.nav.yml @@ -0,0 +1 @@ +title: Solar Network diff --git a/docs/zh/solar-network/account.md b/docs/zh/solar-network/account.md new file mode 100644 index 0000000..5816f0c --- /dev/null +++ b/docs/zh/solar-network/account.md @@ -0,0 +1,54 @@ +--- +title: 帐号 +--- + +# Solarpass + +Solar Network 上的帐号又称为 Solarpass,其可以在所有 Solsynth 的产品中使用。 + +!!! warning "注意" + + 根据 Solar Network 用户协议 3.5 条中规定,您不能在 Solar Network 上创建第二个帐号。即「开小号」的行为是违反用户协议的。 + 包括在封禁之后再次创建帐号来躲避处罚也是禁止的。**但删除帐号数据后再次创建帐号不在此列中。** + + > 一个自然人只能注册、拥有一个 Solarpass 帐号,我们有权对其他同用户的子帐号采取删除数据的措施。 + + 事实查证:[Solsynth Term of Service / Basic Law](https://solsynth.dev/terms/basic-law#_3-%E6%9C%8D%E5%8A%A1%E7%9A%84%E6%8F%90%E4%BE%9B%E4%B8%8E%E4%B8%AD%E6%96%AD) + +## 创建帐号 + +您可以在 Solian 中创建帐号,创建一个帐号需要您提供以下信息: + +- 帐号名称:帐号名称可以是英文字母、数字、下划线和连字符。 + 并保持全局唯一。**帐号名称在创建之后除特殊情况联系客户支持服务外不可修改** +- 显示名称:帐号显示名称并无太多限制,任意取 4-32 位字符即可。 +- 邮箱:请提供真实有效的邮箱,后续需要接受相关的确认注册邮件。 + 为落实用户协议中的禁止注册子帐号的政策,这项邮箱必须为全局唯一。 +- 密码:后续用来登陆的账号密码。请确保其安全。 + +在注册帐号之后,您需要在您绑定邮件的收件箱中收取一个来自 Solarpass 服务的邮件, +其中包含一个确认注册的连接。在您使用其连接确认注册之前,您的帐号会缺少权限, +导致大部份功能无法使用,其产生的报错是正常情况,请勿回报。 + +
+ ![Solarpass Create Account](/assets/images/solarpass-create.png){ width="300" } +
创建 Solarpass 的屏幕截图
+
+ +## 登陆帐号 + +Solar Network 采用自主研发的多因素验证系统,相比传统的两部验证更加方便,您可以任意挑选您方便的验证因素来登陆。 + +
+ ![Solarpass Login](/assets/images/solarpass-create.png){ width="300" } +
登陆 Solarpass 的屏幕截图
+
+ +
+ ![Solarpass Multifactor](/assets/images/solarpass-multifactor.png){ width="300" } +
使用多因子验证登陆 Solarpass 的屏幕截图
+
+ +!!! warning "尚未完成" + + 这里在未来将会补充详细的多因子验证的工作原理以及机制,但目前此区域尚未完成。 diff --git a/docs/zh/solar-network/index.md b/docs/zh/solar-network/index.md new file mode 100644 index 0000000..d8ea728 --- /dev/null +++ b/docs/zh/solar-network/index.md @@ -0,0 +1,45 @@ +--- +title: Solar Network +--- + +# Solar Network + +Solar Network 是 Solsynth 的开源社交网络项目。 +秉持着开放、包容、友善的原则运营。自 2023 年立项,2024 年上线至今已经过去近 2 个年头了。 + +你可以在以下的连接了解到 Solar Network 项目的更多信息: + +- [Solian](https://github.com/Solsynth/Solian) Solar Network 项目的主仓库 +- [Dyson Network](https://github.com/Solsynth/DysonNetwork) Solar Network 项目的服务器侧代码 +- [Capital](https://solsynth.dev/products/solar-network) Solar Network 项目的官方网站 + +## 在你开始之前 + +在你开始使用 Solar Network 之前,这里有些信息小羊觉得你有必要了解: + +- 配置好网络:你假若在使用 Clash 等代理工具以自动分流的方式从中国大陆地区访问 Solar Network,可能出现请求延迟高的问题,这是因为我们的服务器位于香港,可能被分配到了代理节点,建议走直连以获取更好的体验。 +- 包容心:Solar Network 名义上是 Solsynth 制作群的项目,但实际上 Solsynth 也只有一个目前还是学生的成员,因此软件中可能发现诸多设计缺陷,功能缺失以及漏洞和报错。还请多多包容。 +- 阅读英语:尽管 Solar Network 大部份都具有本地化,但是大多数服务器返回的报错都是英语的,您可以使用翻译尝试阅读,或是在文档中查询解决方案。最后再前往官方的聊天频道或者 GitHub 反馈问题。 +- 反馈问题:你可已在我们的的 GitHub 主仓库反馈问题,在创建新 Issue 前请搜索以确保没有其他人已经反馈了相关的问题并且已被解决。 + +## 开始使用 + +Solar Network 的官方客户端支持绝大部分平台,你可以从以下的连接下载到: + +- Windows / Linux: + 桌面版的构建交由 GitHub Actions 来自动构建,您需要前往主仓库的 GitHub 页面找到 Actions 标签。 + 选择最新的构建(即使最新的构建失败了您也可以查看一下,可能部份平台的构建出了问题也会显示全部失败) + 在下方的 Artifacts 区域选择对应平台的构建下载。[传送门](https://github.com/Solsynth/Solian/actions) +- iOS / macOS:苹果平台的 Solian 分为两个版本,App Store 的稳定版和 TestFlight 的开发版, + 但是大多数情况来讲,**开发版比稳定版稳定**且有最新的功能。 + 你可以前往 [App Store](https://apps.apple.com/us/app/solian/id6499032345) 获取稳定版, + **但是请注意因为地缘政治原因,中国大陆地区没有 Solian 可用。** + 不过针对这点,您可以前往 + [TestFlight](https://testflight.apple.com/join/YJ0lmN6O) 获取开发版, + 苹果未对 TestFlight 进行分区处理。 +- Android:您可以前往 GitHub + 的 [Release 页面](https://github.com/Solsynth/Solian/releases) 找到最新版本下载, + 小羊会针对每次版本更新手动构建安卓版本。 +- Web:或者说您不希望下载或者您的平台未收支持,您可以前往 [solian.app](https://solian.app) 访问 Solian 的网页版。 + +当您下载完成后,您可以继续阅读章节来了解 Solar Network 的帐号系统。 diff --git a/docs/zh/solar-network/stellar-program.md b/docs/zh/solar-network/stellar-program.md new file mode 100644 index 0000000..9fdd4dd --- /dev/null +++ b/docs/zh/solar-network/stellar-program.md @@ -0,0 +1,63 @@ +--- +title: 恒星计划 +--- + +# Stellar Program + +> *だって僕は星だから Stellar Stellar —— [Stellar Stellar](https://youtu.be/a51VH9BYzZA?si=yuFvOGtfkuU80hwb)* + +!!! warning "正在活跃开发" + + 本章节正在活跃的进行开发,其描述的内容有部份未实现,已经实现的功能也可能面临改变。 + +Stellar Program 又名恒星计划是 Solar Network 的会员系统, +参与其的成员可以获得一些特殊的福利和权限以访问新功能。 + +## 等级 + +Stellar Program 订阅分为三级,分别是 Stellar, Nova 和 Supernova。 +其对应的翻译为「恒星」、「新星」与「超新星」。*亦或是「恒星」、「恒星+」、「恒星++」* + +每一等级都包含上一等级的全部功能,并有相应的扩充。 + +## Perks + +1. 等级「恒星」 + - 炫酷彩色用户名 + - 抢先体验新功能 + - 每月 10 金点 + - 1.5x 经验获得增速 +2. 等级「新星」 + - 等级「恒星」的所有功能 + - 每月 20 金点 + - 优先功能请求 + - 2x 经验获取增速 +3. 等级「超新星」 + - 等级「超新星」的所有功能 + - 每月 30 金点 + - 优先客户服务支持 + - 源码级技术支持 + +## 获得 + +用户有两种方式获得 Stellar Program,**在应用内通过源点购买** 或者 **通过赞助支持 Solar Network 的开发时的赠品**。 + +### 应用内购买 + +应用内通过 Solarpay 来购买需要您提前设置好 PIN Code 以便支付订单。详情请转到 [源点钱包](wallet.md) 章节。 + +在应用内购买的价格为: + +- 等级「恒星」:每月 1200 源点,需要用户等级达到 3 级 +- 等级「新星」:每月 2400 源点,需要用户等级达到 6 级 +- 等级「超新星」:每月 3600 源点,需要用户等级达到 9 级 + +### 赞助开发时的赠品 + +在通过赞助获得 Stellar Program 之前,您需要转到帐号设置中连接您要赞助要通过的平台的帐号,以便自动获取订单状态。 + +尽管在回复购买的时候需要提供订单号,但是您仍需要链接对应的帐号来获得 Stellar Program 订阅。 + +您可以通过以下的方式赞助小羊开发 Solar Network,并且获得 Stellar Program 订阅: + + \ No newline at end of file diff --git a/docs/zh/solar-network/wallet.md b/docs/zh/solar-network/wallet.md new file mode 100644 index 0000000..5eb19a0 --- /dev/null +++ b/docs/zh/solar-network/wallet.md @@ -0,0 +1,24 @@ +--- +title: 源点钱包 +--- + +# 源点钱包 + +源点是 Solar Network 上的虚拟币种,其可以用来支付 Solar Network 上的一些开销。 + +## 钱包 + +您可以在登陆之后在 Solian 中转到「钱包」页面来创建一个源点钱包,在这之前您不会收到任何被动源点收入。 + +同时您也可以在「钱包」页面查看您当前的余额和交易详情。 + +## 支付 + +在支付之前,为了确保是您本人使用的源点钱包来支付,您需要在「帐号设置」中创建一个 PIN Code 验证因素,其的 Trustworthy(可信度)为 `0`,无法用来登陆。只会用来验证身份。 + +Solian 的客户端在第一次输入 PIN Code 之后会在本地安全的情况下存储加密的 PIN Code,以便提供生物识别快速验证。 + +
+ ![Solarpay Example](/assets/images/stellar-solarpay.png){ width="300" } +
Solarpay 支付的屏幕截图
+
diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 0000000..de5d843 --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,33 @@ +# yaml-language-server: $schema=https://squidfunk.github.io/mkdocs-material/schema.json +site_name: Suki +site_url: https://kb.solsynth.dev +theme: + name: material + features: + - navigation.instant + - navigation.instant.progress + - navigation.tabs + - navigation.sections +plugins: + - meta + - social + - search + - awesome-nav + - glightbox + - i18n: + docs_structure: folder + languages: + - locale: en + default: true + name: English + build: true + - locale: zh + name: 简体中文 + build: true +markdown_extensions: + - attr_list + - md_in_html + - pymdownx.blocks.caption + - admonition + - pymdownx.details + - pymdownx.superfences diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/requirements.txt @@ -0,0 +1 @@ +