docs(*): sort the documents

CLimber-Rong · CLimber-Rong · commit e01d6962ce55 · 2025-03-18T18:36:17.000+08:00
please refer to the work log for details
diff --git a/doc/工作日志/20230727.md b/doc/工作日志/20230727.md
@@ -1,3 +1,5 @@
+# 2023/07/27 工作日志
+
 1. 完成了对AST节点的设计
 2. 创建了基本的目录（后续可能会更改）
 3. 接下来准备编写AST的C++代码实现
diff --git a/doc/工作日志/20230812.md b/doc/工作日志/20230812.md
@@ -243,8 +243,4 @@ setting.json（配置件）->generator.py（生成器）->code.cpp（生成结
 
 ### 7. 接下来要做的事
 1. 完成STVM数据类型的定义
-2. 完成STVM内部数据结构的部分定义
-
-### 后记
-今天早上代码终于写完了，代码格式化、工作日志等等折腾完之后已经下午了 ~~（我真爱死VSCode了）~~ ，在准备git commit的时候突然发现数字字面量的节点类好像有瑕疵，还好抢救过来了。<br><br>
-希望不要提交之后发现代码有瑕疵。
+2. 完成STVM内部数据结构的部分定义
diff --git a/doc/工作日志/20230825.md b/doc/工作日志/20230825.md
@@ -62,15 +62,4 @@ data_type
 
 ### 5. 接下来要做的事
 1. 完成STVM的内部数据结构
-2. 对代码进行测试
-
-### 6. 后记
-本次提交的内容其实不算复杂，但是因为数据类型定义的设计会影响到后面的很多架构，所以我需要谨慎思考。
-<br><br>
-本次提交还着重更改了依赖库，事实上，依赖库的设计也是让我比较头疼的。
-<br><br>
-本次提交的数据类型定义可能注释并不全面，我将会在后续继续提交注释。
-<br><br>
-~~这种简单的代码还需要写注释~~
-<br><br>
-值得注意的是，从项目第一次提交到现在，我没有对代码进行过一次调试，接下来我会对我写过的代码进行简单的调试。
+2. 对代码进行测试
diff --git a/doc/工作日志/20231202.md b/doc/工作日志/20231202.md
@@ -66,11 +66,4 @@ SequenceType* d = man.MallocObject<SequenceType>(10);
 
 1. 定义字节码执行器的数据结构
 2. 编写字节码执行器的简单算法
-3. 完成虚拟机的SFN功能
-
-### 后记
-写了三个月，可以说是完成了一件大事，真累，但是感觉好爽。
-<br><br>
-我一直致力于把文档写简单、干练、透彻。但是接下来项目难度骤增，文档也会更加复杂。（其实这篇文档就已经开始变复杂了）
-<br><br>
-写完文档之后，对着它审而又审，最后准备郑重地提交。
+3. 完成虚拟机的SFN功能
diff --git a/doc/工作日志/20240131.md b/doc/工作日志/20240131.md
@@ -69,10 +69,6 @@ Lexer在分析前，应当先把源码分解成逐行的文本，然后从第一
 
 如果你想要编译运行测试样例，请将测试样例中的``test.cpp``覆盖到``test/test.cpp``当中，然后使用Makefile调试。
 
-### 给Stamon设计了Logo
-
-怎么说呢，这个logo有点简陋？
-
 ### 怎样编译运行测试代码
 
 无论是调试你自己编写的测试代码，抑或是调试测试样例，都至少需要配置好以下工具：
@@ -92,17 +88,4 @@ Lexer在分析前，应当先把源码分解成逐行的文本，然后从第一
 
 * ``make build``：编译项目，生成一个``test.exe``，即项目可执行文件
 * ``make run``：运行项目
-* ``make zip``：将项目可执行文件进行压缩 **（该指令需要用到strip和upx）**
-
-***
-
-### 后记
-
-这次的更新比以往所有的更新都更加全面，并且该项目的开发方针也进行了大幅度的改善。
-
-之所以变动会这么大，是因为我要在二月份参加一个重要的创新比赛，这也就意味着我必须在二月份开发出一个能运行的语言。
-
-再加上我的学业（临近中考），所以我会变得很忙。
-
-最后...祝大家中国新年快乐！
-
+* ``make zip``：将项目可执行文件进行压缩 **（该指令需要用到strip和upx）**
diff --git a/doc/工作日志/20240207.md b/doc/工作日志/20240207.md
@@ -62,10 +62,4 @@ Parser在分析该源码的过程中，如果要导入新的文件，会把这
 1. 编写AST的解释器
 2. 编写Token和AST的保存功能
 3. 完成SFN功能
-4. 编写AST的O1优化器
-
-### 后记
-
-本文档采用语音转文字编写，出现个别错别字请谅解。
-
-但是不得不说语音转文字写文档就是快。
+4. 编写AST的O1优化器
diff --git a/doc/工作日志/20240510.md b/doc/工作日志/20240510.md
@@ -2,9 +2,7 @@
 
 ### 好久不见！
 
-在二月份的时候，本项目就已经开发完成，并投稿至一个科创比赛。令人震惊的是：现在本项目已经一路过关斩将参与国家级评选了。
-
-为了让项目准备更充分，我决定进行更新。
+在二月份的时候，本项目就已经开发完成，为了让项目准备更充分，我决定进行更新。
 
 本次的更新将会从语法分析器直接跳跃到完整的编译器、虚拟机。
 
@@ -194,7 +192,7 @@ AstIRGenerator类用于将Ast数据生成为AstIR（同时兼任着AstIR转Runni
 
 SFN机制在本项目原所在仓库中有提及，这里再次摘抄：
 
-> SFN，全程Stamon For Native（~~真的不是So Fck NVIDIA~~）。是StamonVM的一个调用外部功能的机制。你可以用它与解释器交互。
+> SFN，全称Stamon For Native。是StamonVM的一个调用外部功能的机制。你可以用它与解释器交互。
 
 用不太准确但方便理解的说法是：SFN和JNI类似，都是一种本地库调用机制。
 
@@ -345,10 +343,4 @@ RetStatus excute(
 1. 编写AST的解释器
 2. 编写词法分析的保存功能
 3. 编写AST的O1优化器
-4. 完善标准库
-
-### 后记
-
-这一次的文档编写花费了我将近两天的时间，现在回过头来，回想项目成立之初的7月份，我压根没敢想象现在的盛况，无数次的实践都让我有了一丝向前看的底气。
-
-这个项目此时并不是一次练习、一个发明了，而是一种态度。
+4. 完善标准库
diff --git a/doc/工作日志/20240616.md b/doc/工作日志/20240616.md
@@ -105,8 +105,4 @@ Stamon目前支持以下指令：
 2. 编写词法分析的保存功能
 3. 编写AST的O1优化器
 4. 完善标准库
-5. 支持编译为平面字节码
-
-### 后记
-
-总算是正式支持Linux了，这也极大的证明了Stamon的可移植性......
+5. 支持编译为平面字节码
diff --git a/doc/工作日志/20240707.md b/doc/工作日志/20240707.md
@@ -13,7 +13,4 @@
 3. 编写词法分析的保存功能
 4. 编写AST的O1优化器
 5. 完善标准库
-6. 编写AST的解释器
-
-### 后记
-本项目成功进入了某科创比赛的国赛！
+6. 编写AST的解释器
diff --git a/doc/工作日志/20240730.md b/doc/工作日志/20240730.md
@@ -13,8 +13,4 @@
 3. 编写词法分析的保存功能
 4. 编写AST的O1优化器
 5. 完善标准库
-6. 编写AST的解释器
-
-### 后记
-
-随着越来越多人为Stamon做贡献，我认为我应该做一份代码编写规范。
+6. 编写AST的解释器
diff --git a/doc/工作日志/20240801.md b/doc/工作日志/20240801.md
@@ -28,7 +28,4 @@ print(a);
 3. 编写词法分析的保存功能
 4. 编写AST的O1优化器
 5. 完善标准库
-6. 编写AST的解释器
-
-### 后记
-不出意料的话，Stamon for Web（stamon-playground）马上就要与大家见面了！
+6. 编写AST的解释器
diff --git a/doc/工作日志/20240821.md b/doc/工作日志/20240821.md
@@ -34,8 +34,4 @@ MemoryPool提供了内存池功能，加快运行速度的同时增加了内存
 3. 编写词法分析的保存功能
 4. 编写AST的O1优化器
 5. 完善标准库
-6. 编写AST的解释器
-
-### 后记
-
-Stamon Playground已经正式实现，点击[这里](https://stamon-playground.github.io/)即可在网页上使用Stamon！
+6. 编写AST的解释器
diff --git a/doc/工作日志/20240908.md b/doc/工作日志/20240908.md
@@ -20,11 +20,4 @@
 3. 编写词法分析的保存功能
 4. 编写AST的O1优化器
 5. 完善标准库
-6. 编写AST的解释器
-
-### 后记
-
-随着项目的发展，Stamon的流言蜚语越来越多，甚至还有人企图控制Stamon。
-我认为这是正常的，我只想做我想要做的。
-
-我将会发布各种规范，以此限制住一些素质低下的人的行径。
+6. 编写AST的解释器
diff --git a/doc/工作日志/20241004.md b/doc/工作日志/20241004.md
@@ -35,14 +35,4 @@
 3. 编写词法分析的保存功能
 4. 编写AST的O1优化器
 5. 完善标准库
-6. 编写AST的解释器
-
-### 后记
-
-``工作日志/20240908.md``当中提到了关于学术道德的问题。为此，我决定加入MOSPP（开源项目保护宣言）。
-这是我编写的一个规范，只具有道德约束力，不能当作法律依据。
-我没有能力去妥善的用法律约束力解决学术道德与开源软件的矛盾，因此只能使用道德约束力去平衡。
-
-我和其他人透露“我决定加入开源项目保护宣言”的想法之后，很多人抗议“这不符合自由软件运动的宗旨”。显然他们没有理解“道德约束力”的含义，我并没有绝对反对自由软件运动的精神（因此所谓“FreeStamon”这样企图扣帽子来哗众取宠的项目可以中止了）。
-
-**MOSPP只具有道德约束力！**
+6. 编写AST的解释器
diff --git a/doc/工作日志/20241029.md b/doc/工作日志/20241029.md
@@ -17,14 +17,4 @@
 
 首先是新增了``代码速览指南.md``，用于向开发者澄清此项目的一些误区，也提升了项目的教程性。
 
-接着是一些平面字节码的规范，我将会开始慢慢推进平面字节码的工作进程。
-
-### 后记
-
-最近忙着参加奥赛，很少维护Stamon。
-
-但是我已经在筹备Stamon的重构工作了，我提交了两份平面字节码的设计规范，这算是重构的开端。
-
-近日我也开发了Stamon的中文版（斯塔蒙，又名sitameng），其基本原理就是用Python将中文关键字、标识符和全角符号词法分析，输出成和Stamon同一标准的Token，最后交给Stamon编译。
-
-需要声明：斯塔蒙和Stamon隶属于两个不同的项目仓库，斯塔蒙具有一定的实验性，我会把更多精力放在Stamon的维护上。
+接着是一些平面字节码的规范，我将会开始慢慢推进平面字节码的工作进程。
diff --git a/doc/工作日志/20241202.md b/doc/工作日志/20241202.md
@@ -4,7 +4,7 @@
 
 ### 好久不见！
 
-由于其他赛事的原因，外加学业繁忙，最近的更新以维护为主。但由于此项目入围了市级竞赛，故将近来的更新全部提交。
+由于其他原因，外加学业繁忙，最近的更新以维护为主。
 
 我预计在寒假开始编写一些新功能。
 
@@ -34,13 +34,4 @@ XMake构建方法已经更新到``编译发行版指南``。
 3. 编写词法分析的保存功能
 4. 编写AST的O1优化器
 5. 完善标准库
-6. 编写AST的解释器
-
-### 后记
-
-目前stamon有三个周边项目：
-* stamon2-highlight（VSCode高亮插件，已完工）
-* 斯塔蒙（中文处理器已完工，等待对接中）
-* STPM（Stamon Package Manager，Stamon包管理器，正在建设中）
-
-我将会逐步推进它们，以此达成一个周边生态。
+6. 编写AST的解释器
diff --git a/doc/工作日志/20250127.md b/doc/工作日志/20250127.md
@@ -64,10 +64,4 @@
 1. 优化``ArrayList.hpp``的标准C实现
 2. 开发Stamon的安装工具
 3. 推进Stamon包管理器的开发
-4. 支持文件处理库
-
-### 后记
-
-最近我在大量整合代码，为未来的重构做准备。
-
-春节快乐！
+4. 支持文件处理库
diff --git a/doc/工作日志/20250222.md b/doc/工作日志/20250222.md
@@ -23,11 +23,4 @@
 4. 开发Stamon的安装工具
 5. 推进Stamon包管理器的开发
 6. 推进斯塔蒙的开发
-7. 支持文件处理库
-
-### 后记
-
-这个月的工作量不小，但是表面上的成效不多。
-很多人开始对我的项目进行无端的质疑和抨击，这是正常的，我也应该摆好心态，不受干扰的安排未来的项目规划。
-如果什么事情都听别人的意见，最后是什么都做不成的，而且提出意见的人也不会承担责任，我已经看到太多这样的例子了。
-内存安全一直是我心里难以越过的一道坎，我想我要开始着手解决它。
+7. 支持文件处理库
diff --git a/doc/工作日志/20250228.md b/doc/工作日志/20250228.md
@@ -28,8 +28,4 @@ CMakeList.txt具有被弃用的可能性。
 4. 开发Stamon的安装工具
 5. 推进Stamon包管理器的开发
 6. 推进斯塔蒙的开发
-7. 支持文件处理库
-
-### 后记
-
-Github Action编译出来的程序貌似有点问题，我已经修复了它。
+7. 支持文件处理库
diff --git a/doc/工作日志/20250302.md b/doc/工作日志/20250302.md
@@ -19,8 +19,4 @@
 4. 开发Stamon的安装工具
 5. 推进Stamon包管理器的开发
 6. 推进斯塔蒙的开发
-7. 支持文件处理库
-
-### 后记
-
-因为一个本地环境变量的问题，我排查了一个周末，因此没有做出一些实质性的东西。
+7. 支持文件处理库
diff --git a/doc/工作日志/20250303.md b/doc/工作日志/20250303.md
@@ -27,10 +27,4 @@
 4. 开发Stamon的安装工具
 5. 推进Stamon包管理器的开发
 6. 推进斯塔蒙的开发
-7. 支持文件处理库
-
-### 后记
-
-更新可能会变得更加频繁。
-我重构虚拟机的意向从未如此强烈。
-我认为是时候付诸行动了，让一些带有错误认知的人重新认识这个项目。
+7. 支持文件处理库
diff --git a/doc/工作日志/20250308.md b/doc/工作日志/20250308.md
@@ -28,9 +28,4 @@ main函数应该是简洁的，因此我把参数解析的代码封装到了源
 4. 开发Stamon的安装工具
 5. 推进Stamon包管理器的开发
 6. 推进斯塔蒙的开发
-7. 支持文件处理库
-
-### 后记
-
-为了准备省级的比赛，我必须在短时间内实现更多有趣的，创新的小功能。
-整合这些代码，这样可以为接下来的开发做准备。
+7. 支持文件处理库
diff --git a/doc/工作日志/20250318.md b/doc/工作日志/20250318.md
@@ -0,0 +1,19 @@
+# 2025/03/18 工作日志
+
+本次提交没有发布新功能。
+本次提交规范化了日志和文档。
+
+### 规范了日志和文档
+
+我规范化了工作日志的格式，并将工作日志中与技术无关的“后记”部分统一迁移至``工作日志后记集.md``。
+我还删除了文档当中一些不合适的内容。
+
+### 接下来要做的事
+
+1. 将``TokenFileWriter``和``TokenFileReader``进行调试
+2. 为重构虚拟机做准备工作
+3. 实现分步行动机制
+4. 开发Stamon的安装工具
+5. 推进Stamon包管理器的开发
+6. 推进斯塔蒙的开发
+7. 支持文件处理库
diff --git a/doc/工作日志后记集.md b/doc/工作日志后记集.md
diff --git a/doc/编译器开发文档.md b/doc/编译器开发文档.md
