🎉 Initial Commit

.gitignore

@@ -0,0 +1,3 @@
+venv
+.cache
+.DS_Store

Makefile

@@ -0,0 +1,2 @@
+serve:
+	venv/bin/mkdocs serve

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.

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 的。

docs/zh/solar-network/.nav.yml

@@ -0,0 +1 @@
+title: Solar Network

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 服务的邮件，
+其中包含一个确认注册的连接。在您使用其连接确认注册之前，您的帐号会缺少权限，
+导致大部份功能无法使用，其产生的报错是正常情况，请勿回报。
+
+<figure markdown="span">
+  ![Solarpass Create Account](/assets/images/solarpass-create.png){ width="300" }
+  <figcaption>创建 Solarpass 的屏幕截图</figcaption>
+</figure>
+
+## 登陆帐号
+
+Solar Network 采用自主研发的多因素验证系统，相比传统的两部验证更加方便，您可以任意挑选您方便的验证因素来登陆。
+
+<figure markdown="span">
+  ![Solarpass Login](/assets/images/solarpass-create.png){ width="300" }
+  <figcaption>登陆 Solarpass 的屏幕截图</figcaption>
+</figure>
+
+<figure markdown="span">
+  ![Solarpass Multifactor](/assets/images/solarpass-multifactor.png){ width="300" }
+  <figcaption>使用多因子验证登陆 Solarpass 的屏幕截图</figcaption>
+</figure>
+
+!!! warning "尚未完成"
+
+    这里在未来将会补充详细的多因子验证的工作原理以及机制，但目前此区域尚未完成。

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 的帐号系统。

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 订阅：
+
+<iframe src="https://afdian.com/leaflet?slug=littlesheep" width="640" scrolling="no" height="200" frameborder="0"></iframe>

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，以便提供生物识别快速验证。
+
+<figure markdown="span">
+  ![Solarpay Example](/assets/images/stellar-solarpay.png){ width="300" }
+  <figcaption>Solarpay 支付的屏幕截图</figcaption>
+</figure>

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

requirements.txt

@@ -0,0 +1 @@
+