.gitignore

@@ -0,0 +1,21 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store

.roadsignrc

@@ -0,0 +1,13 @@
+{
+  "sync": {
+    "region": "goatpedia",
+    "configPath": "roadsign.toml"
+  },
+  "deployments": [
+    {
+      "region": "goatpedia",
+      "site": "goatpedia-web",
+      "path": "dist"
+    }
+  ]
+}

.vscode/extensions.json

@@ -0,0 +1,4 @@
+{
+  "recommendations": ["astro-build.astro-vscode"],
+  "unwantedRecommendations": []
+}

.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}

README.md

@@ -0,0 +1,54 @@
+# Starlight Starter Kit: Basics
+
+[![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)
+
+```
+npm create astro@latest -- --template starlight
+```
+
+[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics)
+[![Open with CodeSandbox](https://assets.codesandbox.io/github/button-edit-lime.svg)](https://codesandbox.io/p/sandbox/github/withastro/starlight/tree/main/examples/basics)
+[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/withastro/starlight&create_from_path=examples/basics)
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fwithastro%2Fstarlight%2Ftree%2Fmain%2Fexamples%2Fbasics&project-name=my-starlight-docs&repository-name=my-starlight-docs)
+
+> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
+
+## 🚀 Project Structure
+
+Inside of your Astro + Starlight project, you'll see the following folders and files:
+
+```
+.
+├── public/
+├── src/
+│   ├── assets/
+│   ├── content/
+│   │   ├── docs/
+│   └── content.config.ts
+├── astro.config.mjs
+├── package.json
+└── tsconfig.json
+```
+
+Starlight looks for `.md` or `.mdx` files in the `src/content/docs/` directory. Each file is exposed as a route based on its file name.
+
+Images can be added to `src/assets/` and embedded in Markdown with a relative link.
+
+Static assets, like favicons, can be placed in the `public/` directory.
+
+## 🧞 Commands
+
+All commands are run from the root of the project, from a terminal:
+
+| Command                   | Action                                           |
+| :------------------------ | :----------------------------------------------- |
+| `npm install`             | Installs dependencies                            |
+| `npm run dev`             | Starts local dev server at `localhost:4321`      |
+| `npm run build`           | Build your production site to `./dist/`          |
+| `npm run preview`         | Preview your build locally, before deploying     |
+| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
+| `npm run astro -- --help` | Get help using the Astro CLI                     |
+
+## 👀 Want to learn more?
+
+Check out [Starlight’s docs](https://starlight.astro.build/), read [the Astro documentation](https://docs.astro.build), or jump into the [Astro Discord server](https://astro.build/chat).

astro.config.mjs

@@ -0,0 +1,33 @@
+// @ts-check
+import { defineConfig } from "astro/config";
+import starlight from "@astrojs/starlight";
+
+// https://astro.build/config
+export default defineConfig({
+  site: "https://kb.solsynth.dev",
+  integrations: [
+    starlight({
+      title: "Goatpedia",
+      defaultLocale: "root",
+      locales: {
+        root: {
+          label: "English",
+          lang: "en",
+        },
+        "zh-cn": {
+          label: "简体中文",
+          lang: "zh-CN",
+        },
+      },
+      social: {
+        github: "https://github.com/Solsynth",
+      },
+      sidebar: [
+        {
+          label: 'Solar Network',
+          autogenerate: { directory: 'solar-network' },
+        },
+      ],
+    }),
+  ],
+});

home.md

@@ -1,11 +0,0 @@
----
-title: Solar Archive
-description: Welcome to Solar Archive, the Knowledge Base from Solsynth  
-published: true
-date: 2024-06-15T12:57:51.480Z
-tags: 
-editor: markdown
-dateCreated: 2024-06-15T12:57:49.177Z
----
-
-Solar Archive, the world biggest knowledge library in the Solar Network System.

package.json

@@ -0,0 +1,17 @@
+{
+  "name": "goatpedia",
+  "type": "module",
+  "version": "0.0.1",
+  "scripts": {
+    "dev": "astro dev",
+    "start": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview",
+    "astro": "astro"
+  },
+  "dependencies": {
+    "@astrojs/starlight": "^0.31.1",
+    "astro": "^5.1.5",
+    "sharp": "^0.32.5"
+  }
+}

public/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128"><path fill-rule="evenodd" d="M81 36 64 0 47 36l-1 2-9-10a6 6 0 0 0-9 9l10 10h-2L0 64l36 17h2L28 91a6 6 0 1 0 9 9l9-10 1 2 17 36 17-36v-2l9 10a6 6 0 1 0 9-9l-9-9 2-1 36-17-36-17-2-1 9-9a6 6 0 1 0-9-9l-9 10v-2Zm-17 2-2 5c-4 8-11 15-19 19l-5 2 5 2c8 4 15 11 19 19l2 5 2-5c4-8 11-15 19-19l5-2-5-2c-8-4-15-11-19-19l-2-5Z" clip-rule="evenodd"/><path d="M118 19a6 6 0 0 0-9-9l-3 3a6 6 0 1 0 9 9l3-3Zm-96 4c-2 2-6 2-9 0l-3-3a6 6 0 1 1 9-9l3 3c3 2 3 6 0 9Zm0 82c-2-2-6-2-9 0l-3 3a6 6 0 1 0 9 9l3-3c3-2 3-6 0-9Zm96 4a6 6 0 0 1-9 9l-3-3a6 6 0 1 1 9-9l3 3Z"/><style>path{fill:#000}@media (prefers-color-scheme:dark){path{fill:#fff}}</style></svg>

roadsign.toml

@@ -0,0 +1,9 @@
+id = "goatpedia"
+
+[[locations]]
+id = "goatpedia"
+hosts = ["kb.solsynth.dev"]
+paths = ["/"]
+[[locations.destinations]]
+id = "goatpedia-web"
+uri = "files:///workdir/goatpedia?fallback=404.html&index=index.html"

src/content.config.ts

@@ -0,0 +1,7 @@
+import { defineCollection } from 'astro:content';
+import { docsLoader } from '@astrojs/starlight/loaders';
+import { docsSchema } from '@astrojs/starlight/schema';
+
+export const collections = {
+	docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
+};

src/content/docs/index.mdx

@@ -0,0 +1,13 @@
+---
+title: Welcome to the Goatpedia!
+description: The official knowledge base about Solsynth's products.
+template: splash
+hero:
+  tagline: All information about Solsynth products is here.
+  image:
+    file: https://solsynth.dev/favicon.png
+  actions:
+    - text: Start exploring
+      link: /solar-network
+      icon: right-arrow
+---

src/content/docs/solar-network/account.mdx

@@ -0,0 +1,53 @@
+---
+title: Solarpass
+description: Sign up for Solarpass and take the first step in exploring the Solar Network.
+sidebar:
+  order: 2
+---
+
+We call our account on Solar Network Solarpass. in order to explore the full Solar Network functionality, you need a Solarpass account.
+
+:::Caution[Did you know?]
+According to our user agreement, a natural person should only be able to register and own one Solarpass account. In addition, transferring, selling or renting Solarpass is not allowed.
+In case of violation of the above, we reserve the right to terminate your Solarpass account.
+:::
+
+## Registration
+
+You need to register for Solarpass via Solian, either using your installed local client or our [web version](https://sn.solsynth.dev/auth/register).
+
+This information may help you when you fill out the form:
+
+- Username: a unique identifier for each account, which cannot be changed after registration, and can be used for logging in and for others to be able to refer to you by `@<username>`. The minimum is 4 characters, only English and Arabic numerals are allowed.
+- Display name: the name to be displayed, any character is allowed, minimum 4 characters or 2 Kanji, Korean, Katakana or Hiragana.
+- Email: The contact information for the account, make sure this field is a real email address, we will verify your email address.
+- Password: One of the verification factors for the account password, make sure this field is secure and at least 4 characters long.
+
+### Troubleshooting
+
+- **(400) Key: 'XXX' Error: Field validation failed on the 'XXX' tag** One or more fields failed during server validation, please check your form against the information above.
+- **(400) ERROR: duplicate key value violates unique constraint "idx_accounts_name" (SQLSTATE 23505)** Your username is a duplicate of an existing user, please consider replacing it with another one!
+
+## Login
+
+You can use your email, username to log into your account.
+
+Solar Network uses unique **multi-factor authentication** to secure your account. When you log in, you will see the number of authentication steps required by the server, balanced by a number of factors.
+You need to pass the corresponding number of authentication factors before you can log in to your account, and you cannot reuse an identical factor in a single login session.
+
+### Troubleshooting
+
+:::note[Did you know?]
+Since version **`+60`**, unconfirmed accounts are no longer blocked from logging in, but they will not be assigned the default permission group, and basically no operations can be performed.
+The default permission group will be assigned after the registration is confirmed. Deleting an account that has not been confirmed for 24 hours will still not change.
+:::
+
+- **(400) account was not found: XXX** The target account was not found, check that your username and email are correct, we don't accept display names to find accounts.
+- **(403) account was not confirmed; check your inbox, there will be an email lead you confirm your registration** Your account has not been activated, check your email inbox, or spam, there will be an There will be an email labeled **[Solarpass]** that will contain a link to help activate your account
+- **(403) account was suspended** Your account has been deactivated by us for some reason, you can check your bundled emails, as a rule our customer service sends an email explaining in detail the basis and reasons for this decision.
+
+## Deleting an account
+
+If you want to delete your account, you can do so by clicking on the Delete button in your account center and confirming your account deletion in the confirmation dialog that pops up.
+
+After that, an email will be sent to your bound email address. You can follow the instructions in the email to complete your deletion.

src/content/docs/solar-network/index.mdx

@@ -0,0 +1,36 @@
+---
+title: Quick Start
+description: Solar Network user manual.
+sidebar:
+  order: 0
+---
+
+import { LinkCard } from '@astrojs/starlight/components';
+
+Welcome to the Solar Network User Manual. This manual is designed to help you get started with Solar Network.
+
+## Basics
+
+Solar Network is an alias for the entire HyperNet project, which is divided into the HyperNet server and the Surface application (aka Solian in the marketplace) that users often use.
+
+You can abbreviate Solar Network as SN in both cases. However, when referring to its applications, please make sure to capitalize the first letter.
+
+- Solian ✅
+- Solar Network ✅
+- SN ✅
+- sn ✅
+- solian ❌
+- SOLIAN ❌
+
+~~I can't do anything about you using SN's name, but it's always good to use the right name to make @littlesheep happy~~
+
+## Getting Started
+
+For End-users, there are several ways to get started with Solar Network:
+
+- [Install Solian Client](./installation) **Most Recommended**
+- [Open Solian in the web version](https://sn.solsynth.dev)
+
+In order to explore the full Solar Network functionality, you need a Solarpass account (a.k.a. Sun Pass).
+
+<LinkCard href="./account" title="Solarpass" description="Learn how to create and manage your Solarpass account" />

src/content/docs/solar-network/installation.mdx

@@ -0,0 +1,97 @@
+---
+title: Installing the Client
+description: Installs the Solian client to use Solar Network.
+sidebar:
+  order: 1
+---
+
+import { LinkCard } from '@astrojs/starlight/components';
+
+There are two ways to install the client, either by using our pre-compiled binary distribution archive or by building from source.
+
+## Pre-compile
+
+You can download the latest version of the pre-compiled package from our official website (in English).
+We offer pre-compiled versions for Android, iOS, macOS, Windows.
+
+*Linux is also supported, but please build it yourself!
+
+<LinkCard title="Download pre-compiled installers" description="Go to the official Capital website" target="_blank" href= "https://solsynth.dev/products/solar-network#download" />
+
+:::note
+Regarding the Windows version, we use GitHub Actions to build every commit in a timely manner, and the version that exists on the official website may not be the most up-to-date.
+You can download the latest Windows build by going to our [GitHub Repo](http://github.com/Solsynth/HyperNet.Surface).
+:::
+
+:::tip[Did you know?]
+You can actually download the Solian desktop version from the Matrix Marketplace as well, although it may not be the latest version.
+:::
+
+The downloaded archive can be installed directly, and the Windows version can be unzipped and used.
+
+## Build it yourself
+
+To build Solian yourself, you need to install the Flutter development environment (for Windows, you need to install VS2019 or above, and check Desktop Development with C++).
+
+- Install Flutter development environment: [Flutter official website](https://flutter.dev/docs/get-started/install)
+
+:::note
+If you are in the People's Republic of China, you may not have a smooth internet connection when using Flutter and its infrastructure (pub.dev).
+Please refer to the official Flutter documentation to work on changing sources.
+:::
+
+Additionally, you will need to install [Git](https://git-scm.com/downloads) to clone our source code.
+
+You can run the following command to check all the dependencies:
+
+```bash
+git --version
+flutter doctor
+```
+
+It should output the following:
+
+```
+# git --version
+git version 2.47.1
+
+# flutter doctor
+Doctor summary (to see all details, run flutter doctor -v).
+[✓] Flutter (Channel stable, 3.27.1, on macOS 15.1.1 24B91).
+    darwin-arm64, locale en-CN)
+[✓] Android toolchain - develop for Android devices (Android SDK
+    version 34.0.0)
+[✓] Xcode - develop for iOS and macOS (Xcode 16.2)
+[✓] Chrome - develop for the web
+[✓] Android Studio (version 2024.2)
+[✓] IntelliJ IDEA Ultimate Edition (version 2024.3.2)
+[✓] Connected device (5 available)
+[✓] Network resources
+
+- No issues found!
+```
+
+Next, we can build
+
+```bash
+# iOS
+flutter build ipa
+# macOS
+flutter build macos
+# Android (apk)
+flutter build apk ---split-abi --release
+# Android (aab)
+flutter build appbundle
+# Windows (aab)
+flutter build windows
+# Linux
+flutter build linux
+# Web
+flutter build web --base-href=/ --release
+```
+
+:::note
+Because of the dependencies used, this project demonstrates that Web WASM builds are not supported.
+:::
+
+Dependencies will be downloaded automatically during the build process, so please wait for a while. After the build is completed, the directory of the build result will be output.

src/content/docs/solar-network/wallet.mdx

@@ -0,0 +1,63 @@
+---
+title: Source Points Wallet
+description: Learn about credits (Source Points) on Solar Network and how to get and use them.
+sidebar:
+  order: 3
+---
+
+:::caution
+Source Points are not associated with real money in any way, our official staff does not sell Source Points, and there are no gift cards of any kind. **Please be aware of scams.**
+:::
+
+:::tip[Did you know?]
+Source Points are not currency or virtual money, but a concept similar to points.
+:::
+
+To get source points, you need to have a wallet first. You can create a new wallet in the Solian client after **`+59`** by opening You > Wallets.
+
+Once you have a wallet, you can see random extra source point rewards in addition to increased experience during your daily check-ins.
+
+## Getting Source Points
+
+Currently there are the following ways to get Source Points on Solar Network:
+
+1. daily check-ins (10-50 Source Points depending on the daily horoscope)
+2. posting a post that has been topped by someone else (a positive response, with a daily credit of 5 credits per post at 12:00 UTC+0, except for your own responses)
+
+## Consuming Source Points
+
+On Solar Network, you can use credits to purchase content, such as additional file upload privileges.
+
+### File uploads
+
+Starting with the **`+59`** version, file upload size is unlimited for all verified users. However, we use stepped storage space billing.
+
+:::caution
+File uploads are paid for with a password-free payment that is automatically deducted, but you will still receive a receipt notice after the deduction. You can view a record of all transactions in You > Wallet.
+:::
+
+:::tip[Did you know?]
+If you don't have a SourcePoint wallet or your wallet balance is low, you will receive a 402 Payment Required error when you need to pay for uploading a file.
+:::
+
+:::tip[Tip].
+All files are billed in MiB, which is equal to 1024 KiB, or 1,048,576 Bytes (1024*1024 Bytes).
+:::
+
+The following table applies to all **private files** (i.e. files in private storage buckets):
+
+| File Size | Source Consumption |
+| --- | --- |
+| x ≤ 50 MiB | 1 source point per MiB |
+| 50 MiB ≤ x | 5 source points per MiB |
+
+Extra, for private attachments, an additional 10 source points service charge per upload.
+
+For content in shared domains such as chats, posts, etc., the following billing method is applied:
+
+| File Size | Source Points Consumption |
+| --- | --- |
+| x ≤ 50 MiB | no charge |
+| 50 MiB ≤ x | 1 source point per MiB |
+
+No service charge for shared domain content.

src/content/docs/zh-cn/index.mdx

@@ -0,0 +1,13 @@
+---
+title: 欢迎来到山羊维基
+description: 关于索尔幸茨的产品的官方知识库。
+template: splash
+hero:
+  tagline: 关于索尔幸茨产品的所有信息，都在这里。
+  image:
+    file: https://solsynth.dev/favicon.png
+  actions:
+    - text: 开始探索
+      link: /solar-network
+      icon: right-arrow
+---

src/content/docs/zh-cn/solar-network/account.mdx

@@ -0,0 +1,53 @@
+---
+title: 太阳通行证
+description: 注册太阳通行证，迈出探索 Solar Network 的第一步吧。
+sidebar:
+  order: 2
+---
+
+我们称 Solar Network 上的帐户为 Solarpass。为了探索完整的 Solar Network 功能，你需要一个 Solarpass 账户。
+
+:::caution[你知道吗？]
+根据我们的用户协议，一个自然人应该只能注册、拥有一个 Solarpass 账号。此外，转让、售卖、租用 Solarpass 的行为都是不允许的。
+如果违反以上的情况，我们有权终止你的 Solarpass 账户。
+:::
+
+## 注册
+
+你需要通过 Solian 来注册 Solarpass，你可以使用你的已经安装的本地客户端，或者我们的 [网页版本](https://sn.solsynth.dev/auth/register)
+
+在你填写表单的时候，这些信息可能会帮助到你：
+
+- 用户名：每个账号的唯一标识，注册之后无法改动，可以用于登录和他人可以通过 `@<username>` 的方式来提及你。最短为 4 个字符，只允许英文和阿拉伯数字出现。
+- 显示名：显示的名称，允许任何字符，最短为 4 个字符或者 2 个汉字、韩文、片假名或平假名。
+- 邮箱：账号的联系方式，确保此字段是真实的电子邮箱，我们会验证你的电子邮箱。
+- 密码：账号密码其中之一的验证因素，确保此字段安全，至少 4 个字符。
+
+### 疑难杂症
+
+- **(400) Key: 'XXX' Error: Field validation failed on the 'XXX' tag** 有一个或多个字段在服务器校验的时候发生了失败，请根据以上的信息检查你的表单。
+- **(400) ERROR: duplicate key value violates unique constraint "idx_accounts_name" (SQLSTATE 23505)** 你的用户名与现有的用户重复了，请考虑更换一个用户名
+
+## 登陆
+
+你可以使用你的电子邮件、用户名来登陆你的帐号。
+
+Solar Network 使用独特的 **多因子验证** 来保护你的帐号安全。你在登陆界面的时候可以看到服务器均衡各方面因素得出的需求验证步数，
+你需要通过对应数量的验证因子才能登陆你的帐号，在一个登陆会话中不能重复使用一个相同的因子。
+
+### 疑难杂症
+
+:::note[你知道吗？]
+自从 **`+60`** 版本之后，未确认的帐号不再阻止登入，但是不会分配默认权限组，基本上无法进行任何操作。
+在确认注册之后会才会分配默认权限组。删除 24 小时未确认的帐号仍然不会改变。
+:::
+
+- **(400) account was not found: XXX** 没有找到目标账户，检查你的用户名和电子邮件时候填写正确，我们不接受显示名来查找帐号
+- **(403) account was not confirmed; check your inbox, there will be an email lead you confirm your registration** 你的帐号还没激活，检查你的电子邮件收件箱，或者是垃圾邮件，会有一份标注 **[Solarpass]** 的电子邮件，里面包含一个连接来帮助激活你的账号
+- **(403) account was suspended** 你的帐号因为某些原因被我们停用了，你可以检查你绑定的邮件，一般情况下我们的客户服务会发送一份邮件来详细解释这项决定的依据和原因。
+
+## 删除帐号
+
+如果你想要删除你的帐号，你可以在你的账号中心中点击删除按钮，并在弹出的确认对话框中确认你的帐号删除。
+
+之后，你绑定的电子邮箱会收到一封电子邮件。你可以根据邮件里的提示来完成你的删除操作。

src/content/docs/zh-cn/solar-network/index.mdx

@@ -0,0 +1,36 @@
+---
+title: 快速入门
+description: Solar Network 用户手册。
+sidebar:
+  order: 0
+---
+
+import { LinkCard } from '@astrojs/starlight/components';
+
+欢迎来到 Solar Network 用户手册。这份手册旨在帮助您开始使用 Solar Network。
+
+## 基础知识
+
+Solar Network 是整个 HyperNet 项目的别称，它分为 HyperNet 服务器和用户经常使用的 Surface 应用（在市场上又名 Solian）。
+
+你可以将 Solar Network 简写为 SN，大小写均可。但是在提及到它的应用程式时，请确保首字母大写。
+
+- Solian ✅
+- Solar Network ✅
+- SN ✅
+- sn ✅
+- solian ❌
+- SOLIAN ❌
+
+~~虽然你乱用 SN 的名字我也不能把你怎样，但是你用对名字总能让小羊看的舒服一点~~
+
+## 开始使用
+
+对于终端用户（End-user），开始使用 Solar Network 有几种方式：
+
+- [安装 Solian 客户端](./installation) **最推荐**
+- [在网页版打开 Solian](https://sn.solsynth.dev)
+
+为了探索完整的 Solar Network 功能，你需要一个 Solarpass 账户（又称太阳通行证）。
+
+<LinkCard href="./account" title="太阳通行证" description="了解如何创建，管理你的 Solarpass 账户" />

src/content/docs/zh-cn/solar-network/installation.mdx

@@ -0,0 +1,97 @@
+---
+title: 安装客户端
+description: 安装 Solian 客户端来使用 Solar Network。
+sidebar:
+  order: 1
+---
+
+import { LinkCard } from '@astrojs/starlight/components';
+
+关于安装客户端，有两种方式，其一是使用我们预编译的二进制分发档案，其二是从源代码构建。
+
+## 预编译
+
+你可以通过我们的官方网站（英文）来下载到最新版本的预编译包裹。
+我们提供 Android, iOS, macOS, Windows 的预编译版本。
+
+*Linux 也在支持列表之中，但是还请自行构建*
+
+<LinkCard title="下载预编译安装包" description="前往 Capital 首都官方网站" target="_blank" href="https://solsynth.dev/products/solar-network#download" />
+
+:::note
+关于 Windows 版本，我们使用 GitHub Actions 对每一个提交进行及时构建，官网存在的版本可能不是最新。
+可以前往我们的 [GitHub Repo](http://github.com/Solsynth/HyperNet.Surface) 下载最新 Windows 构建版本。
+:::
+
+:::tip[你知道吗？]
+你其实也可以在 Matrix Marketplace 下载到 Solian 桌面版本，虽然可能不是最新版。
+:::
+
+下载完成的档案直接安装即可。Windows 版本解压即可使用。
+
+## 自行构建
+
+要自行构建 Solian，你需要安装 Flutter 开发环境（Windows 需要额外安装 VS2019 以上版本，勾选 Desktop Development with C++）。
+
+- 安装 Flutter 开发环境：[Flutter 官网](https://flutter.dev/docs/get-started/install)
+
+:::note
+如果你处于中华人民共和国中，可能使用 Flutter 和其基础设施（pub.dev）时网络连接不会那么顺畅。
+请参考 Flutter 官方文档进行换源工作。
+:::
+
+额外，你还需要安装 [Git](https://git-scm.com/downloads) 来克隆我们的源代码。
+
+你可以执行以下的命令来检查所有的依赖项：
+
+```bash
+git --version
+flutter doctor
+```
+
+它应该会输出如下的信息：
+
+```
+# git --version
+git version 2.47.1
+
+# flutter doctor
+Doctor summary (to see all details, run flutter doctor -v):
+[✓] Flutter (Channel stable, 3.27.1, on macOS 15.1.1 24B91
+    darwin-arm64, locale en-CN)
+[✓] Android toolchain - develop for Android devices (Android SDK
+    version 34.0.0)
+[✓] Xcode - develop for iOS and macOS (Xcode 16.2)
+[✓] Chrome - develop for the web
+[✓] Android Studio (version 2024.2)
+[✓] IntelliJ IDEA Ultimate Edition (version 2024.3.2)
+[✓] Connected device (5 available)
+[✓] Network resources
+
+• No issues found!
+```
+
+接下来，我们就可以正式构建了
+
+```bash
+# iOS
+flutter build ipa
+# macOS
+flutter build macos
+# Android (apk)
+flutter build apk --split-abi --release
+# Android (aab)
+flutter build appbundle
+# Windows
+flutter build windows
+# Linux
+flutter build linux
+# Web
+flutter build web --base-href=/ --release
+```
+
+:::note
+因为使用的依赖关系，本项目展示不支持 Web WASM 的构建。
+:::
+
+编译过程中会自动下载相关依赖，请稍等即可。构建完成后会输出构建结果的目录。

src/content/docs/zh-cn/solar-network/wallet.mdx

@@ -0,0 +1,63 @@
+---
+title: 源点钱包
+description: 了解 Solar Network 上的积分（源点），以及如何获取和使用源点。
+sidebar:
+  order: 3
+---
+
+:::caution[注意]
+源点不会以任何方式关联现实货币，我们官方人员不会售卖源点，也不存在任何形式的礼品卡。**请注意防范诈骗。**
+:::
+
+:::tip[你知道吗？]
+源点不是货币，也不是虚拟货币，而是一种类似积分的概念。
+:::
+
+要获取源点，你需要首先拥有一个钱包。你可以在 **`+59`** 之后的 Solian 客户端中打开「您」>「钱包」中创建一个新的钱包。
+
+在拥有钱包之后，你可以在每日签到的时候看到除了增加经验之外，还有随机的额外源点奖励。
+
+## 获取源点
+
+目前在 Solar Network 上有以下的方式可以获得源点：
+
+1. 每日签到（根据每日运势获得 10-50 不等的源点）
+2. 发帖被他人按顶（指态度为积极的反应，每日 UTC+0 时区 12:00 结算每日的源点，5 源点每顶，自己反应除外）
+
+## 消费源点
+
+在 Solar Network 上，你可以利用源点购买一些内容，比如额外的文件上传权限等。
+
+### 文件上传
+
+从 **`+59`** 版本开始，文件上传大小对所有已验证用户都是无限制。但是我们采用阶梯式存储空间计费。
+
+:::caution[注意]
+文件上传的付费方式为免密支付，自动扣费，但是你仍然会在扣费之后收到一份收据通知。你可以在「您」>「钱包」中查看所有的交易记录。
+:::
+
+:::tip[你知道吗？]
+如果你没有源点钱包或者钱包余额不足，在上传文件需要付费时会收到 402 Payment Required 错误。
+:::
+
+:::tip[提示]
+所有文件计费均以 MiB 为单位，其等于 1024 KiB，或是 1,048,576 Bytes (1024*1024 Bytes)。
+:::
+
+以下表格适用于所有**私有文件**（即在私有存储桶的文件）：
+
+| 文件大小 | 源点消费 |
+| --- | --- |
+| x ≤ 50 MiB | 1 源点每 MiB |
+| 50 MiB ≤ x | 5 源点每 MiB |
+
+额外的，对于私有附件，每次上传额外收取 10 点源点服务费。
+
+对于聊天、帖子等共有领域的内容，应用以下的计费方式：
+
+| 文件大小 | 源点消费 |
+| --- | --- |
+| x ≤ 50 MiB | 不收费 |
+| 50 MiB ≤ x | 1 源点每 MiB |
+
+对于共有领域的内容不收取服务费。

tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "astro/tsconfigs/strict",
+  "include": [".astro/types.d.ts", "**/*"],
+  "exclude": ["dist"]
+}

zh/home.md

@@ -1,15 +0,0 @@
----
-title: 太阳档案馆
-description: Solsynth LLC 全系产品的知识库
-published: true
-date: 2024-06-29T16:04:33.746Z
-tags: 
-editor: markdown
-dateCreated: 2024-06-29T16:04:33.746Z
----
-
-太阳档案馆，现知的最大 Solsynth LLC 产品资料库。由 Solsynth LLC 运营。由社区提供内容及资源，官方监督改正。
-
-我们目前还在修建档案馆，但是未来这里将可以查阅到我们的所有资料。
-
-~~你可以通过 Solarpass 来登入参加我们的修建过程。~~ 由于我们还处于早期阶段，登入后请 DM `@littlesheep` 申请编辑资格。

zh/solar-network.md

@@ -1,15 +0,0 @@
----
-title: Solar Network
-description: 太阳网络
-published: true
-date: 2024-07-24T07:01:07.072Z
-tags: solar network
-editor: markdown
-dateCreated: 2024-06-30T04:15:07.945Z
----
-
-![solian-user-manual.jpeg](/solar-network/solian-user-manual.jpeg)
-
-Solar Network 是 Solsynth LLC 目前的主力产品。旗下包含着多个服务，涉及了你的生活的方方面面。如社交、聊天等等。
-
-现在就将导航模式切换成目录开始探索吧！

zh/solar-network/creator.md

@@ -1,13 +0,0 @@
----
-title: 创作者计划
-description: 欢迎来到 Solar Network 创作者计划，在这里共创美好明天
-published: true
-date: 2024-08-16T17:35:45.391Z
-tags: solar network
-editor: markdown
-dateCreated: 2024-08-14T02:43:01.931Z
----
-
-创作者计划是 Solar Network 为了推动用户创作内容而诞生的一个企划，企划旨在帮助创作者更好的使用 Solar Network 产出更高质量的内容。
-
-加入创作者计划，获得更多官方支持，第一时间使用新功能，为未来的 Solar Network 提出宝贵的建议

zh/solar-network/creator/stickers.md

@@ -1,62 +0,0 @@
----
-title: 贴图及贴图包
-description: Stickers, Emotes 和 Emoji
-published: true
-date: 2024-08-14T03:54:15.435Z
-tags: solar network
-editor: markdown
-dateCreated: 2024-08-14T02:48:10.120Z
----
-
-贴图可以帮助用户通过 Solar Network 更好的表达他们的情绪，这篇文章将会向你介绍如何上传、使用一个贴图
-
-## 贴图包
-
-贴图必须跟随一个贴图包，要创建一个贴图包，你首先需要获得创作者计划的权限，之后利用 cURL 工具向服务器发起一个 POST 请求来创建贴图包。
-
-```http
-POST https://api.sn.solsynth.dev/cgi/files/stickers/packs
-Content-Type: application/json
-Authorization: Bearer <your token here>
-
-{
-    "prefix": "solar",
-    "name": "Solar Network Defaults",
-    "description": "Solar Network official default sticker pack, with a bunch of useful and funny stickers."
-}
-```
-
-这个 API Endpoint 将会返回一个 JSON 对象其中包括了你贴图包的详情信息，其中有一个 `"id"` 字段你需要格外留意，将其记下来。之后会用到。
-
-贴图的其他操作可以使用对应的 PUT 和 DELETE API Endpoint，只是注意在对制定的贴图包进行操作的时候需要在 URL 后面添加 ID 例如 `/cgi/files/stickers/packs/1`
-
-## 贴图
-
-贴图的创建，你首先需要准备内容。建议为一个 512x512 像素大小（最小为 128x128 的大小，否则可能造成效果不佳）的 PNG 或 GIF 图片，透明背景或内容背景均可，但请不要使用纯色填充。大面积的白色填充可能会给暗色模式的用户带来闪光弹。
-
-之后，请下载安装 Solian 或使用网页版，具体请转到 [Solian 介绍页面](/zh/solar-network/solian)。
-
-登陆账号后，在账户页面可以找到一个「贴图」入口，点进去即可看到刚刚创建的贴图包，若没有数据，请检查自己的贴图包创建是否成功。
-
-点击页面下方的加号按钮，完成内容表单，贴图包序号填写上文的 `"id"` 字段。别名需要遵守 CamelCase 规则为最佳。
-
-## 使用
-
-使用贴图，需要在你的内容中键入一个文字占位符，具体的组成为 `:<pack prefix><sticker alias>:`。例如一个贴图包的前缀（`prefix`）为 `solar`，一个该贴图包的的贴图别名（`alias`）为 `Hello`，组成出来的占位符为 `:solarHello:`
-
-不过不明白也别担心，大多数情况我们都有自动提示。只需在 Solian 内文本框键入一个英文冒号，再开始键入占位符的一部分即可。
-
-### 大小变化
-
-在 Solar Network 中，你可能看到大小不同的贴图，这是因为 Smart Resize 在背后发功。具体规则如下。
-
-1. 当仅有一个贴图，将使用 128x128 的大小
-2. 当有三个及一下的题图，将使用 32x32 的大小
-3. 当有三个以上的贴图，或贴图夹杂在文本内时，将使用 20x20 的大小
-
-## FAQ
-
-以下是一些常见问题及解决方案。
-
-Q1: 我创建了贴图，但是发出来对方没有显示\
-A1: 贴图资料的加载是在开屏阶段完成，后续只有在退出贴图管理界面时才会二次刷新，尝试重新启动，如果还是无效，检查贴图时候创建成功

zh/solar-network/open.md

@@ -1,13 +0,0 @@
----
-title: 开放计划
-description: 欢迎来到 Solar Network 开放计划，让我们助力你的应用成长
-published: true
-date: 2024-08-16T17:38:15.514Z
-tags: solar network
-editor: markdown
-dateCreated: 2024-08-16T17:38:15.514Z
----
-
-开放计划是 Solar Network 一系列的开发者友好的 API 和小工具集合。我们坚持不为开发者添堵的规则，非必要不加密参数，永不混淆参数，人性化 API 接口，RESTful API 端点，尽可能的让开发者体验好。
-
-现在就看看侧边栏（浏览模式），看看你能用 Solar Network 做些什么吧！

zh/solar-network/open/api-guide.md

@@ -1,76 +0,0 @@
----
-title: API 准则
-description: 在设计 Solar Network 服务 API 时惯用的准则
-published: true
-date: 2024-08-18T06:09:43.814Z
-tags: solar network
-editor: markdown
-dateCreated: 2024-08-18T05:46:02.121Z
----
-
-这篇文章是关于我们平时在设计 Solar Network API 时的范式是怎样的，能够帮助你更好的调用我们的 API 来进行第二次开发
-
-## 最小化
-
-我们的 API 一般追求极简，不像某些大平台的 API 一样除了数据之外的格式还有一大堆什么状态码、信息、请求 ID 什么的。这些信息我们都选择放在 HTTP 的 Header 部分。HTTP 的响应体就是纯粹的数据，无其他信息（需要分页的数据接口会额外返回一个数据总数）。
-
-## 增删查改
-
-我们的 API 基本上都是遵循 RESTful 设计范式的，如果你不知道什么是 RESTful，可以看以下我们理解的实践的 RESTful
-
-### 请求方法
-
-- `GET` 查询
-- `POST` 创建、进行某种操作
-- `PUT` 更新（虽在 RESTful 中也被定义为创建数据的行为，但是我们不使用）
-- `PATCH` 更新（不常用）
-- `DELETE` 删除
-
-### 路径映射
-
-假如你 POST 了一个地址来创建数据，那么用 GET 方法访问相同的地址大概就是列出数据的列表。
-在其后面加上 `/<id>` 就是单独读取某个数据，将请求方法改成 PUT 便是更新该条数据，改成 DELETE 就是删除该条数据。
-如果在 `/<id>` 再加上东西基本上就是 POST 方法来执行某个操作。
-例如以下是我们帖子的路径映射
-
-*注：`:id` 系路径参数*
-
-- `GET /posts` 获取帖子列表（分页）
-- `GET /posts/:id` 获取单个帖子
-- `GET /posts/:id/replies` 获取单个帖子的回复（分页）
-- `POST /posts` ~~创建帖子~~（于新版本因为引入帖子类型移除，需使用对应类型的创建接口）
-- `PUT /posts/:id` ~~更新帖子~~（于新版本因为引入帖子类型移除，需使用对应类型的更新接口）
-- `DELETE /posts/:id` 删除帖子
-- `POST /posts/:id/pin` 置顶帖子
-- `POST /posts/:id/react` 对帖子作出反应
-
-## 错误处理
-
-我们不理解为什么 HTTP 有给一套完善的状态码系统，其他大厂却仍选择自立门户。关于响应的 HTTP 状态码，以下是一些常用的含义代表。
-
-- `500` 服务器内部错误 —— 你不用管，如果多见记得抛 issue
-- `400` 请求参数错误 —— 看文档，核查请求体
-- `404` 数据不存在或是接口路径不对
-- `403` 没有权限
-- `401` 需要授权 —— 需要授权的 API 但你没有提供 API 令牌
-- `200` 成功
-- `204` 无内容 —— 常见于删除 *虽然后时候写 API 会忘记删除内容时改成这个*
-
-如果响应不是 `2xx` 的状态码，一般我们都不会返回 `application/json` 的数据，而是一个 `plain/text`，一行简单的文字来代表你犯了什么错。
-
-> 如果你是英语白痴，遇到报错别老来问我们，用用翻译好吗？不然我们写报错信息干嘛。
-{.is-warning}
-
-## 超级网关
-
-超级网关指的是我们的 [Hydrogen.Dealer](https://git.solsynth.dev/Hydrogen/Dealer)，一般情况下你都不会直接访问我们的服务，都是走 Dealer 的网关转发的。虽然我们也不知道为什么写了个这个东西。
-
-我们 API 的地址为 `api.sn.solsynth.dev`，怎么用呢？很简单。访问 `/cgi/<service name>` 即可，这样的地址会被转发到对应服务的 `/api` 端点。新版本我们还给这些服务加了点别名，这样你的 URL 可以变得更好看点。
-
-- `/cgi/id` 或 `/cgi/auth` —— 授权服务 [Hydrogen.Passport](https://git.solsynth.dev/Hydrogen/Passport)
-- `/cgi/uc` 或 `/cgi/files` —— 附件服务 [Hydrogen.Paperclip](https://git.solsynth.dev/Hydrogen/Paperclip)
-- `/cgi/co` 或 `/cgi/interactive` —— 帖子服务 [Hydrogen.Interactive](https://git.solsynth.dev/Hydrogen/Interactive)
-- `/cgi/im` 或 `/cgi/messaging` —— 聊天服务 [Hydrogen.Messaging](https://git.solsynth.dev/Hydrogen/Messaging)
-
-> 冷知识：你可能注意到了我们新配置的别名其实就是之前没有超级网关时他们使用的子域名。
-{.is-info}

zh/solar-network/open/embed-widget.md

@@ -1,58 +0,0 @@
----
-title: 嵌入式组件
-description: 使用 iFrame 将 Solar Network 上的内容嵌入到你的网页内
-published: true
-date: 2024-08-18T05:51:05.497Z
-tags: solar network, project open
-editor: markdown
-dateCreated: 2024-08-16T17:51:27.720Z
----
-
-嵌入式组件（Embed Widget）是借助 iFrame 实现的网页小组件，你可以用其展示 Solar Network 上的内容。
-
-## 用途
-
-- 你可以用该组件将你管理的领域嵌入到你的网页，好展示你们领域内的近期活动。
-- 你可以用该组件嵌入一个帖子，作为上下文阐述一个事件
-
-## 用法
-
-<iframe src="https://solsynth.dev/embed/posts/888" width="480" height="640" frameborder="0" style="border:none"></iframe>
-
-以上你可以看见一个 480x640 的小组件里面放 #888 号帖子，讲的是我们使用 Cloudflare 的故事。
-
-这就是嵌入小组件，用法非常简单，上面的事例代码如下
-
-```html
-<iframe src="https://solsynth.dev/embed/posts/888" width="480" height="640" frameborder="0" style="border:none"></iframe>
-```
-
-你可能注意到了嵌入式组件的链接就是一个正常的帖子链接前加上 `/embed`，是的没错，嵌入式组件的命名规则就是如此，页脚的在网站中打开也是在 URL 中去除前缀来工作的。你可以尝试在一个正常链接的前面加上 `/embed` 来看看其时候支持嵌入。如果可以的话，大胆去嵌吧！
-
-## 客制化
-
-部分嵌入式组件支持客制化，你可以在下面看到一些详情，但是部分嵌入式组件可能需要转到其子页面才会显示可用选项，所以还请善用搜索。
-
-### 帖子列表
-
-所有帖子列表组件都支持以下选项，你可以在浏览器内尝试一下。
-
-#### 不显示开头区域
-
-添加参数 `no-title=1`（任意值均可）
-
-<iframe src="https://solsynth.dev/embed/posts?no-title=1" width="480" height="640" frameborder="0" style="border:none"></iframe>
-
-```html
-<iframe src="https://solsynth.dev/embed/posts?no-title=1" width="480" height="640" frameborder="0" style="border:none"></iframe>
-```
-
-#### 自定义标题显示
-
-添加参数 `title` 与 `caption`
-
-<iframe src="https://solsynth.dev/embed/posts?title=岁月史书&caption=翻开这本厚重的岁月史书，去探索岁月的痕迹" width="480" height="640" frameborder="0" style="border:none"></iframe>
-
-```html
-<iframe src="https://solsynth.dev/embed/posts?title=岁月史书&caption=翻开这本厚重的岁月史书，去探索岁月的痕迹" width="480" height="640" frameborder="0" style="border:none"></iframe>
-```

zh/solar-network/solian.md

@@ -1,108 +0,0 @@
----
-title: Solian
-description: Solian（索链）是由 Flutter 编写的全平台支持官方客户端。
-published: true
-date: 2024-07-28T14:51:28.468Z
-tags: solar network, solian
-editor: markdown
-dateCreated: 2024-06-29T16:12:53.290Z
----
-
-Solian 是由 Flutter 编写的全平台 Solar Network 客户端，也是我们目前唯一的前端。
-
-# 使用
-
-想要使用 Solian，你可以下载客户端，也可以直接在浏览器中打开。得益于 Flutter 的全平台支持，你可以在 https://lian.solsynth.dev 访问到 Solian 网页版。但由于浏览器限制，部分功能可能欠缺或受到影响。
-
-## 下载
-
-下载 Solsynth 的方式很多，但一定请从官方认证的渠道下载。
-
-1. 官方仓库发布的正式版本 https://git.solsynth.dev/Hydrogen/Solian/releases
-2. 官方文件托管柜发布的测试版本 https://files.solsynth.dev/production01/solian
-3. 官方 TestFlight (iOS 与少量 macOS) https://testflight.apple.com/join/YJ0lmN6O
-
-<img width="128" height="128" alt="testflight qrcode" src="/testflight_qrcode.png">
-
-Windows 版本系免安装版本，放置于一个您熟悉的目录即可使用。  
-Web 版本同时支持 PWA 渐进式网页应用，可以替代一部分桌面端使用。
-
-## 安装
-
-以下是个平台安装 Solian 的技术要领。
-
-### Android
-
-推荐从**文件托管柜**下载最新测试版，版本最新，修复最全，最稳定。~~测试版比稳定版稳定~~
-
-下载下来的 APK 档案可以直接打开安装。中国版手机可能需要额外步骤验证，但请不要使用自带应用商店搜索下载。
-
-### iOS/macOS
-
-使用 TestFlight 安装。可以点击上方链接首先下载安装 TestFlight App。再点击上方链接的第二部开始测试来参加测试。
-
-TestFlight 的测试名额有限，等到时机成熟我们会将 Solian 发布于非中国区的 App Store，可以前往 App Store 搜索下载。
-
-### Windows
-
-Windows 从任意可信渠道下载后解压到一个目录即可使用。
-
-**注意：** Windows 版本不知是否属于 Flutter 的支持问题，在第一次启动加载时总是会卡好一会才弹出主窗口。不用反复点击，请耐心等待，可能会使用 5 到 30 秒。如果多次点击可能会打开多个窗口。
-
-### Linux
-
-请自行构建。我相信你们可以的，加油哦~
-
-## 自行构建
-
-### 环境准备
-
-构建 Solian 需要使用 Flutter SDK，请在官网下载最新版安装。也可以从中国镜像站下载安装。  
-安装完成 Flutter 请根据官方文档下载其他对应平台需要的开发依赖，例如 Windows 需要 VS2022、Android 需要 Android Studio、iOS/macOS 我劝你还是用官方版本构建的吧。
-
-除开安装 Flutter SDK，我们还需要使用 Rust 做系统级依赖支持。请从 Rust 官方下载最新版本。
-
-现在我们有了 Flutter、Rust，还少一个东西，为了实现聊天及未来的其他模块本地数据库支持。  
-Linux 版本还需要安装对应的 SQLite3 开发依赖。
-
-```sh
-# for ubuntu
-sudo apt-get -y install libsqlite3-0 libsqlite3-dev
-```
-
-Windows 需要下载 [sqlite3.dll](https://github.com/tekartik/sqflite/raw/master/sqflite_common_ffi/lib/src/windows/sqlite3.dll) 放置在运行目录。  
-macOS 及手机端构建不需要其他操作。
-
-### 构建代码
-
-之后就是构建代码的时候了。确保你在构建机器上安装了 `git` 版本管理工具。或者你想直接下载代码压缩档案也不是不行。
-确保 `git` 安装之后可以使用以下命令克隆代码。
-
-```sh
-git clone https://git.solsynth.dev/Hydrogen/Solian.git
-```
-
-之后导航到对应目录，使用以下命令安装依赖。
-
-```sh
-flutter pub get
-```
-
-该操作会从 [pub.dev](https://pub.dev) 上下载依赖，而 pub.dev 是由 Google 托管提供。所以中国大陆的连接性要被打个问号。具体可以参考中国大陆镜像站点查询解决方案。
-
-完成依赖获取后就可编译了，一行命令就搞定。
-
-```sh
-# for windows
-flutter build windows
-# for macos
-flutter build macos
-# for linux
-flutter build linux
-# for ios
-flutter build ipa
-# for android
-flutter build apk
-```
-
-你也可以为 Android 平台构建 `aab` 等其他格式的应用包。但是对应签名素材请自行准备。