合订本.jpg

Gemfile

@@ -1,4 +1,10 @@
 source "https://rubygems.org/"
 gem "jekyll-remote-theme"
-
+gem "webrick"
+gem "csv"
 gem "github-pages", group: :jekyll_plugins
+
+group :jekyll_plugins do
+    gem 'jekyll-commonmark-ghpages'
+end
+

Gemfile.lock

@@ -23,6 +23,7 @@ GEM
     commonmarker (0.23.10)
     concurrent-ruby (1.3.3)
     connection_pool (2.4.1)
+    csv (3.3.0)
     dnsruby (1.72.1)
       simpleidn (~> 0.2.1)
     drb (2.2.1)
@@ -276,6 +277,7 @@ GEM
       concurrent-ruby (~> 1.0)
     unicode-display_width (1.8.0)
     uri (0.13.0)
+    webrick (1.8.1)
 
 PLATFORMS
   aarch64-linux
@@ -293,8 +295,11 @@ PLATFORMS
   x86_64-linux-musl
 
 DEPENDENCIES
+  csv
   github-pages
+  jekyll-commonmark-ghpages
   jekyll-remote-theme
+  webrick
 
 BUNDLED WITH
    2.5.11

Makefile

@@ -10,7 +10,7 @@ clean:
 	@bundle exec jekyll clean
 
 build: clean
-	@${DEBUG} bundle exec jekyll build --profile --config _config.yml,.debug.yml
+	@${DEBUG} bundle exec jekyll build --profile --config _config.yml
 
 server: clean
-	@${DEBUG} bundle exec jekyll server --livereload --config _config.yml,.debug.yml
+	@${DEBUG} bundle exec jekyll server --livereload --config _config.yml

README.md

@@ -8,9 +8,15 @@
 
 Mower 是为长期运行设计的、开源的明日方舟脚本。
 
+初次使用，建议阅读《[Mower 简明教程](https://blog.zhaozuohong.vip/2024/05/10/mower-guide/tutorial/)》；提出建议、反馈 Bug 或交流基建知识，欢迎加入 QQ 频道 [ArkMower（频道号：2r118jwue4）](https://pd.qq.com/s/5t91c3gx9)。
+
+## [安装](./start/download/)
+
+Mower 支持 Windows、macOS 与 Linux 平台。Windows 用户推荐使用[更新器](./start/download/#updater)下载运行；macOS 与 Linux 用户请参考《[从源码运行 arknights-mower](https://blog.zhaozuohong.vip/2023/08/02/run-arknights-mower-from-source/)》。
+
 ## 功能介绍
 
-- 基建：跑单、按心情动态换班；
+- [基建](./start/riic/)：跑单、按心情动态换班；
 - 森空岛：签到、仓库读取；
 - 日常：公招、邮件、线索、清理智；
 - 大型任务：生息演算、隐秘战线；
@@ -23,11 +29,3 @@ Mower 是为长期运行设计的、开源的明日方舟脚本。
 ![settings](./img/settings.png)
 ![plan-editor](./img/plan-editor.png)
 ![riic-report](./img/riic-report.png)
-
-## 下载与安装
-
-Mower 支持 Windows、macOS 与 Linux 平台。Windows 用户推荐从 [mower 下载站](https://mower.zhaozuohong.vip/)下载运行；macOS 与 Linux 用户请参考《[从源码运行 arknights-mower](https://blog.zhaozuohong.vip/2023/08/02/run-arknights-mower-from-source/)》。
-
-初次使用，建议阅读《[Mower 简明教程](https://blog.zhaozuohong.vip/2024/05/10/mower-guide/tutorial/)》。
-
-提出建议、反馈 Bug 或交流基建知识，欢迎加入 QQ 频道 ArkMower（频道号：2r118jwue4）。

_config.yml

@@ -10,6 +10,11 @@ remote_theme: ZhaoZuohong/jekyll-rtd-theme
 readme_index:
   with_frontmatter: true
 
+markdown: CommonMarkGhPages
+commonmark:
+  options: ["UNSAFE", "SMART", "FOOTNOTES"]
+  extensions: ["strikethrough", "autolink", "table", "tagfilter"]
+
 exclude:
   - Makefile
   - CNAME

conf/README.md

@@ -1,5 +1,5 @@
 ---
-sort: 2
+sort: 3
 ---
 # 配置指南
 - [设置](./1.setting.html)

noun/README.md

@@ -1,5 +1,5 @@
 ---
-sort: 3
+sort: 5
 ---
 # 其他说明
 - [名词释义](./1.explanation.html)

qa/README.md

@@ -1,5 +1,5 @@
 ---
-sort: 2
+sort: 4
 ---
 # 常见问题 Q&A
 

start/README.md

@@ -0,0 +1,8 @@
+---
+sort: 1
+---
+
+# 快速开始
+
+1. [安装与更新](./download/)
+2. [基建功能介绍](./riic/)

start/download.md

@@ -0,0 +1,59 @@
+---
+sort: 1
+---
+
+# 安装与更新
+
+**注意**：Mower 使用 Python 3.12，故不支持 Windows 7 及更早的 Windows 版本。
+
+## 版本
+
+自 2024 年 5 月起，mower 采取新的版本发布周期与命名规范：每年以春节、周年、夏活、半周年四个活动为节点，共发布四个版本，版本号以“年份+月份”命名。每个版本的支持周期为 6 个月，前 3 个月作为测试分支，开发新功能；后 3 个月作为稳定分支，只进行必要的维护与错误修复。
+
+当前，稳定分支为 2024.02，测试版为 2024.05。
+
+```mermaid
+gantt
+
+dateFormat YYYY.MM
+axisFormat %Y.%m
+title Mower 版本发布周期
+
+v3.4.4  :done,   2023.11, 2024.05
+2024.02 :active, 2024.05, 2024.08
+2024.05 :active, 2024.05, 2024.11
+2024.08 :done,   2024.08, 2025.02
+2024.11 :done,   2024.11, 2025.05
+```
+
+## 下载
+
+Mower 仅为 Windows 提供可执行文件。Linux 与 macOS 用户需要[从源码运行](#run-from-source)。
+
+<h3 id="updater">更新器</h3>
+
+更新器有两个版本：
+
+- 新版更新器（[Funny-ppt/MowerUpdater](https://github.com/Funny-ppt/MowerUpdater)），由 [Funny-ppt](https://github.com/Funny-ppt/) 维护。
+- 旧版更新器（[ArkMowers/updater](https://github.com/ArkMowers/updater)），由 [ZhaoZuohong](https://github.com/ZhaoZuohong/) 维护。
+
+更新器从 [Mower 下载站](https://mower.zhaozuohong.vip/) 下载文件，既可全新安装，也可用于升级、降级。
+
+新版更新器可检查并自动安装 mower 运行所需依赖。若新版更新器无法使用，可尝试旧版更新器。
+
+### 直接下载
+
+- GitHub：稳定版可从 [Releases](https://github.com/ArkMowers/arknights-mower/releases) 下载；测试版可从 [Actions](https://github.com/ArkMowers/arknights-mower/actions) 下载。
+- 下载站：从 <https://mower.zhaozuohong.vip/> 直接下载 Zip 压缩包。
+
+下载后解压运行即可。
+
+如果 mower 无法正常运行（如窗口白屏、无法从带有二维码的图片导入排班表等），可尝试安装以下依赖：
+
+- Microsoft Visual C++ 2013 Redistributable：<https://aka.ms/highdpimfc2013x64enu>
+- Microsoft Visual C++ 2015-2022 Redistributable：<https://aka.ms/vs/17/release/vc_redist.x64.exe>
+- Microsoft Edge WebView2：<https://go.microsoft.com/fwlink/p/?LinkId=2124703>
+
+<h2 id="run-from-source">从源码运行</h2>
+
+参照《[从源码运行 arknights-mower](https://blog.zhaozuohong.vip/2023/08/02/run-arknights-mower-from-source/)》。