从前文继续。

前段时间博客关了，而且也没什么时间去写之前那个中国芯比赛的后续。今天用hexo重建了一下，迁移了点以前的东西，就顺便把这个后续也写了。
离那一次去大连已有大约9个月了，记忆略微模糊，只能跟着当时的照片来回忆一下了。在正式讲述之前，我先要说说前情提要。

在收到比赛通知的前几个月，正值八年级的初中黄金时段，万般风貌，空闲时间不少。我参加的是个学剪辑的社团，教的都是我认识的信息老师们。由于我接触编程比较早，便给人一种天赋较好的假象，早在七下左右就参加了机器人的比赛，虽只拿了省二等奖未进国赛，但也算是见了世面并且给这些老师留下了好印象。就在这时，有个叫“xx省（xx市）xx编程大赛”的，就是纯python，像刷leetcode一样那种，我好奇，就去了。
市赛的题目有点难度但不多，我现在只记得两道，一个是用turtle画图的，一个是最后一个得用DFS（海岛种树填湖之类的这种，后来才知道很烂大街的题目）。这属实到了我能力范围之外的，前面那些常识和if、循环我还能应付应付，这些对我这个Vibe Coding专业选手（我还是最早开始使用cc的，当时好像才sonnet 3.7，我注册anyrouter白嫖claude，还疯狂创建github小号并自己拉自己，那时候是好时候，github没啥注册限制，域名邮箱都可以，any也没有限制，我一口气刷了1k多刀，今年才蹬完）实在有点难以应付。于是我灵机一动，发挥优良传统，施展技术才能，直接开始搜索引擎查找“免费chatgpt gpt chatgpt中文网 chatgpt镜像站 claude gemini free”。算那边的人员有点脑子，屏蔽了百度，但是我cn.bing.com完全正常。我直接搜到了一个神秘小网站，把复制的题目丢进去，直接点击回车，对了，别忘记点上thinking，然后飞速的，答案就出来了。再次劳驾一下我的手按下ctrl+v，复制粘贴到比赛系统里，提交。完美！同时，我还用亲爱的必应检查了一下前面一堆常识题的答案，然后不负众望众望所归的拿了市一等奖，直接晋级省赛。

市赛的经验让我意识到这几点：万一断网就玩完了；搜不到ai网站就玩完了（我忘记把url记下来了！大失误大失误）。那我只能来点下下策了。毕竟写过点项目，底子在这，直接开学！先硬把DFS、BFS这些重要东西学会（当时是会了，现在彻底沉浸gpt/claude构筑的乌托邦里了，项目倒是写了不少，star倒是拿了不少，算法倒是退步了不少），然后开始——找ai网站。经过一番搜寻，我找到了metaso.cn这个ai搜索，有思考有搜索，网址好记忆，完美！我把它仔细记下，当作备选方案，心里也有了底。
到了省赛（在江对岸的xx市，坐个轮渡过去，很美好的体验），题目难度反而还没市赛大！前面没有任何难点（在我看来，我看旁边同学都被难住了，20道编程题都没做完一半），倒数第二题由于忘带草稿纸，我只能在那个写代码的系统里面推式子（貌似正确方法是用代码写if和循环之类的，但是我爱数学！），成功解决。最后一题挺新颖，是个什么图像识别的问题，我回忆一下题目：给定一个大的数组，由0、1组成，和一个小数组，要把这个数组覆盖到大数组上，然后给出最大重合1的数量（黑白块，而且有点像CNN里面那个卷积核之类的）。我一开始尝试用一堆循环解决，但是不太成功，于是我打开metaso.cn，输入题目描述，回车，对了，别忘记勾上深度思考，答案直接出来了！我直接复制粘贴run一气呵成，绿啦！无可厚非的省一等奖，直接完美收官（这个比赛是有浏览器页内录屏的，但是我常年网上冲浪，chrome可再熟悉不过了！开个新窗口，他能录到算我输！监考也是个麻烦，我只能一只眼睛放哨一只眼睛看屏幕，加上高速Alt+Tab，也是完美避免了）（还有件好玩的事，旁边那位貌似也搞过代码，就是有点神经质，在考试机上装vscode和python，然后试图运行一个奇怪的脚本，是什么我忘了，然后要用到pip，但是好像不怎么会用shell，至少在pwsh上像个智障，装python还没加path，直接写路径还报错，比如这种：”C:\Users\xxx\xxx\xxx\…\pip.exe” install xxx，报错，试了好久还不停问监考老师，感觉监考老师快翻白眼了，明明前面加个&就能解决的，一直折腾到开始比赛还没好）。总的来说，这次在xxxx职业技术学院的比赛真是欢乐与笑容并存，十分美好。

现在回想，我的这两个一等奖或许真的是巧合。当年貌似是deepseek r1左右，思考模型还比较少见，但是已经出现，LLM的智力跃升已经不远（opus 4/gpt 5/gemini 2.5/3 pro貌似还没出现？）所以对此方面的防范也比较少。可以说，没有这一切的巧合堆起来，就没有这几个奖。说到vibe coding，我倒是最早使用的一批。我在小学五、六年级接触到gpt 3.5并开始利用它写作文（连小学毕业前的最后一篇也是gpt 3.5写的），并在同一时期（此时AGI霞光初显）接触到了编程。在很早的时候我就像现在的人到处疯狂找claude code、codex中转站一样，我也是找并找到了很多免费用gpt 3.5/4的网站，然后开始了AI写代码的生涯。当时还是Web Chat，但是极大的激发了我的兴趣和潜力，但凡我早一点都不会坚持下去因为太困难，晚一点没有资源也是一样的结果。在一段漫无目的之后，我开始写一个项目，好像是一个登录、管理之类的，并在初一、二左右彻底毕业了python语法，并且写（魔改）了几个自己的项目，比如nano-gpt改的古诗词生成系统，学生管理等等练手的项目（交上去还能混几个市一等奖，就是没啥用罢了）。然后接触到了cursor这类，超脱了WebChat拥有了更高的效率。为了进一步提升自己，找了几个开源项目写写pr，并且极大提升了水平、接触了cli工具、思想更加前卫（像我这样把绝大多数代码丢给ai，自己只做架构设计和功能提出，连审核都丢给自动化ai审核的AI阶级维新派「清末李鸿章史称资产阶级维新派，而我这人虽只是苍茫浪潮里的水分子，但且给自己编个派系」极少，大多都不敢，但是经过我的实践没有丝毫问题，效率倒是能成倍翻），并且维护了自己的项目。这些都会在即将到来的初三毕业暑假详细叙述（如果想的起来），这里仅做初回顾。

比较长的前情告一段落，让我们随着航班到达美丽的大连海畔。（以下均为看着照片回忆）2025年7月30日23时46分，少年激动的心时速超过了飞机，提前降落了到前方已经近在咫尺的大连国际机场。次日，到了海边的一个广场（前面忘了名字忘了反正挺晒的），太阳辣辣海鸥翱翔白浪翻涌，乃人生头回见如此美丽的海边。由于走太多，回宾馆养精蓄锐。新月1日，跟着一个旅行团，跨过跨海大桥，心情澎湃，转眼驱车进入动物园，东南沿海人第一次见散养老虎、纯正鸵鸟、正宗黑熊、地道山羊！真是激动涕零，俄而至又一海边，买上火腿肠，套上救生衣，给海中央的海鸥带来了大自然的馈赠，下了船到旁边买一蒸笼的海鲜，满满幸福！（之后还去看了个印象旅顺，爱国主义教育拉满了，就是太困了，纯纯历史课，像是五猖会父亲让讯哥儿背的鉴略，在脑内留不下半点痕迹，在此不详提）回到市区（？暂且这么定义，我也不清楚），到了一个大广场，正好有个啤酒节。啤酒我是没什么兴趣，倒是买了一大包M豆，然后两天吃完了。夜幕降临之后（19:30）开始了大桥灯光秀，那座跨海大桥突然散出熠熠光辉，照耀着人山人海，也在我心里留下了熠熠光辉。
2号，参加比赛。摄影资料较少，仅靠脑内回忆了。貌似是在开发区的一个产业园内一块大地方，进去先是消费，小吃街一样不过是室内的,我买了个炸鸡全当中午饭（以后念念不忘，回来之后还在加点上一包炸鸡，勾上蜂蜜芥末酱，仿佛能短暂地带我回到那个晴朗的夏日）。随后排了一个长队，到里面领上号牌，等了一会。这时候，我看到旁边都是一些看上去比小学生还小的学生，结果手上拿着城市模型你敢信！我当时就懵逼了，转念一想，好嘛，这个比赛纯纯水货，果然便宜没好货，免费来看一堆小学生拿着花几万报的小课班在老师指导下做的作品获奖（这是我从同校另一位选手听来的，他当时是初一，省赛是个什么happycoding，也拿了一等奖被推荐过来「这个比赛不是省赛的延续，但是省赛拿了一等奖可以免初赛、复赛等直接进入决赛且省（复）赛自动一等奖」，他买了个倒车雷达成品，花了700多「我哭笑不得，花了30做的东西来看他们神仙打架来着的」，结果他的答辩老师说是这都是他们培训班的入门水平，小学二年级做的，天啊，GENIUS！）。到了我，结局不必多说，评委说我这作品太简单了，虽然立意够深、愿景够好，但是终究不够复杂（比不上他们的微缩版城市模型——这当然！我一个纯纯折腾后端python的，哪里搞的起来这种层面的硬件技术！况且我的钱、我家里的钱也不允许啊）。后来去看，三等奖，也是意外之喜了，不过结局不太重要，重要的是这次宝贵的经历、硬件的接触和大连的优美风光！（我这样在东南沿海不沿海城市的人，一辈子没怎么旅游，就这么几次：越南、西安、北京、大连，没了，看世界极少，导致小镇做题家风貌显现，还好我及时将更多精力投入编程防止变成做题呆子；教育内卷，疯狂报课，我们班加上我只有区区3人未上补习班；更有甚者一周6节晚上11点多才到家，惨痛不堪！难以想象！很多人只知道豆包、抖音、刷视频，对技术的忽视，家长对电脑的恶毒看法，无一不在扼杀着一个个希望！）结束之后，已而夕阳在山，人影散乱，海风吹过，前往宾馆下的饭店吃顿地道东北菜，又去海边看看海景，有种人生圆满的感觉。3日，上午去了一个极大的院子，看到了从未看到可能将来很少看到的的极地生物比如北极熊、企鹅，海里的王八、鱼们，表演的海豚、室外的鸟、大鹦鹉、鸭子、缆车（是不是混入了什么奇怪的东西）、叫不上名字的长脖子白羽毛的鸟，打开眼界，精彩纷呈。下午，坐着飞机离开了美丽的大连。Ade，美丽活泼的动物们，Ade，洪波涌起的海浪们！（次日下午，还看到了彩虹）

欢乐、美好，除此、无他！多年以后我可能会想起那个海风阵阵的夏日，那有着遗憾的比赛。
部落格重建，以后的叙事会偏向平实，并对往事做出回顾。在毕业后的暑假，我计划对我的童年及义务教育阶段的人生做一次全面的回顾、思考、记录。

等待两天后，快递终于到齐了。实际的操作完全比我想象的简单需要，在网上找几个引脚图，然后一个个接上去就行了。然后再找几个示例，拼接一下代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

// ------------------- 1. 引入库 -------------------
#include <SPI.h>
#include <MFRC522.h>
#include <SoftwareSerial.h>
#include <DFRobotDFPlayerMini.h>

// ------------------- 2. 定义引脚和常量 -------------------
#define RST_PIN 9
#define SS_PIN  10

// ------------------- 3. 创建对象实例 -------------------
MFRC522 mfrc522(SS_PIN, RST_PIN);
SoftwareSerial mySoftwareSerial(2, 3); // RX, TX
DFRobotDFPlayerMini myDFPlayer;

// ------------------- 4. 定义全局变量 -------------------
String lastCardUID = ""; // 用于存储上一个触发播放的卡片UID，防重复的关键
bool dfPlayerInitialized = false; 

// ------------------- 5. setup() 初始化函数 (保持不变) -------------------
void setup() {
  Serial.begin(9600);
  while (!Serial);

  // --- 步骤一: 初始化并检查 MFRC522 ---
  SPI.begin();
  mfrc522.PCD_Init();
  byte version = mfrc522.PCD_ReadRegister(mfrc522.VersionReg);
  if (version == 0x00 || version == 0xFF) {
    Serial.println(F("错误: MFRC522 通信失败! 请检查接线。程序已停止。"));
    while (1);
  }
  Serial.println(F("MFRC522 模块通信正常!"));

  // --- 步骤二: 初始化并检查 DFPlayer ---
  mySoftwareSerial.begin(9600);
  Serial.println(F("正在初始化 DFPlayer Mini 模块..."));
  if (myDFPlayer.begin(mySoftwareSerial)) {
    dfPlayerInitialized = true;
    Serial.println(F("DFPlayer 初始化成功!"));
    myDFPlayer.volume(20);
    myDFPlayer.EQ(DFPLAYER_EQ_NORMAL);
  } else {
    dfPlayerInitialized = false;
    Serial.println(F("DFPlayer 初始化失败! 请检查接线和SD卡。"));
  }
  
  Serial.println(F("\n系统准备就绪，请刷卡..."));
}

// ------------------- 6. loop() 主循环函数 (已修复) -------------------
void loop() {
  // --- 步骤一: 检测是否有新的NFC卡片靠近 ---
  // 如果没有检测到新卡，就将 lastCardUID 清空，这是允许卡片移除后再次触发的关键
  if (!mfrc522.PICC_IsNewCardPresent()) {
    lastCardUID = "";
    return;
  }

  // --- 步骤二: 尝试读取卡片序列号 ---
  // 如果成功检测到但读取失败（比如卡片移动太快），也直接返回
  if (!mfrc522.PICC_ReadCardSerial()) {
    return;
  }

  // --- 步骤三: 格式化读取到的 UID ---
  String currentCardUID = "";
  for (byte i = 0; i < mfrc522.uid.size; i++) {
    if (mfrc522.uid.uidByte[i] < 0x10) {
      currentCardUID += "0";
    }
    currentCardUID += String(mfrc522.uid.uidByte[i], HEX);
    if (i < mfrc522.uid.size - 1) {
      currentCardUID += " ";
    }
  }
  currentCardUID.toUpperCase();
  
  // --- 步骤四: 防重复播放的核心判断 ---
  // 只有当 当前卡片的UID 与 上次触发播放的UID 不同时，才执行操作
  if (currentCardUID != lastCardUID) {
    Serial.print("检测到新标签 UID: ");
    Serial.println(currentCardUID);

    // 更新 lastCardUID 为当前卡的 UID，防止下次循环重复触发
    lastCardUID = currentCardUID;
    
    // 检查DFPlayer并播放音频
    if (dfPlayerInitialized) {
      playAudioForCard(currentCardUID);
    } else {
      Serial.println("检测到标签，但 DFPlayer 尚未就绪，无法播放。");
    }
  }
  
  // --- 步骤五: 让卡片休眠 ---
  // 虽然上面的逻辑已经能防重复，但调用 HaltA 是一个好习惯，
  // 它可以立即让当前卡片进入不活跃状态，使读卡器的状态管理更清晰。
  mfrc522.PICC_HaltA();
  mfrc522.PCD_StopCrypto1();
}

// ------------------- 7. playAudioForCard() 自定义函数 (保持不变) -------------------
void playAudioForCard(String uid) {
  if (uid == "1D 93 C7 0D 0D 10 80") {
    myDFPlayer.playMp3Folder(1);
    Serial.println("正在播放: 音频1");
  } else if (uid == "1D 92 C7 0D 0D 10 80") {
    myDFPlayer.playMp3Folder(2);
    Serial.println("正在播放: 音频2");
  } else if (uid == "1D 91 C7 0D 0D 10 80") {
    myDFPlayer.playMp3Folder(3);
    Serial.println("正在播放: 音频3");
  } else {
    Serial.println("未识别的标签");
  }
}

然后往TF卡里面放一些TTS的音频，就完美解决了。唯一不足的地方就是RFID-RC522模块还需要焊一下。成品：

后续改进

我还买了几个2.4GHz的射频模块，但是需要3.3V的电压。Arduino上的接口不够了，所以我还额外买了一个5V->3.3V的降压模块。这家发货真的快，1h之内就发了，所以我明天就得看是研究无线电了。

额外彩蛋

那几个NFC贴纸还很多，我在手机上用一个叫NFC Writer的软件写了点东西进去，比较好玩的是写一点应用启动。包名推荐：

• com.netease.dwrg.mi
• com.MiHoYo.ys.mi

  我也不知道为什么必须要加.mi后缀，如果不加我的手机搜不到（vivo/iQOO）

或者你也可以写入一个URL：

• http://www.pylindex.top/rick/

明天看看能不能忽悠几个人来试试水。

总结

比赛的就这么多，看来比较简单，估计拿个安慰奖。不过我实在不想再耗费脑细胞了，所以就看Gemini的文字功底了，看看它写的介绍能达到什么高度。拿到降压模块我可能还会改进改进，会的话下回再说。

为了参加那个莫名奇妙被推荐过去的中国‘芯’助力中国梦——全国青少年通信科技创新大赛，我得麻烦一下我的钱包。比赛规则中要求必须使用国产的开发板，所以我还麻烦了我暑假里宝贵的脑细胞想一想应该买什么开发板。一开始我买的是火龙果的一个单片机开发板，然后这个3天不发货，我点进去一看，霍！店铺已打烊！我直接退款举报一套小连招外加马上打开咸鱼。
咸鱼上看了半天，选定了一款ch340g国产芯片的Arduino UNO。卖家说好的第二天上午发货，我晚上问他，他说忘掉了，正式气煞我也。50块钱，说好的给我发6片，又说忘了，只给我了5片，还好知道补发。

曲折终见Arduino

到货已经4天，不过效果非常好。让Gemini给我写了几行亮灯的代码，然后跟着B站一个教程配置好了CLion，C++写起来也比较轻松，不像那个汇编，写着左脑感觉这玩意太抽象，右脑觉得这玩意不能给我点抽象层吗？

我也只能亮个灯

我想该做些什么的时候，偶然间想起了《百年孤独》里面那个失忆的村子，不是贴标签吗，我就一拍即合，打算用NFC实现类似效果，具体的价值见下Claude写的：

1

近年来，我国人口老龄化加速，阿尔茨海默病患者数量持续增长。患者常常无法识别身边的人和物，给家庭带来沉重负担。本项目设计了一款基于Arduino和NFC技术的交互式语音记忆盒子，通过"触碰即播放"的简单交互，帮助患者唤醒记忆。项目选用国产YX5200语音芯片，实现了高性价比的解决方案。经测试，系统响应迅速、操作简单，特别适合认知能力下降的老年人使用。

于是我光速去买配件：

买完之后，就只能等了，现在只能对着板子上仅有的一盏灯看了。剩下的等我东西到了再来叙述。

预知后事如何，且听下回再吹分解

基本概念

extern 引用外部函数：

1
2
3

extern ExitProcess
extern WriteConsoleA
extern GetStdHandle

section .data 标志初始化变量段

初始化变量格式：

1
2
3
4
5

var1 db <var_data>
msg db 'Hello, World', 0xA ;0xA是换行符

var2 equ <expression>
msg_len equ $ - msg ;表示msg变量的长度

section .text 标志可执行代码段

_start 代表程序入口点

常用指令

数据传送指令

mov 指令用于在寄存器之间或寄存器与内存之间移动数据。

1
2

mov rax, 100 ; 将立即数 100 移动到 rax 寄存器
mov rbx, rax ; 将 rax 寄存器的值复制到 rbx 寄存器

算术运算指令

• add: 加法
• sub: 减法
• inc: 递增
• dec: 递减
• xor: 异或 (常用于将寄存器清零)

1
2
3
4
5
6

mov rax, 100
add rax, 50  ; rax = 150
sub rax, 25  ; rax = 125
inc rax      ; rax = 126
dec rax      ; rax = 125
xor rcx, rcx ; rcx = 0

比较与跳转指令

• cmp: 比较两个操作数，并根据结果设置标志位。
• jmp: 无条件跳转。
• jne: 如果不相等则跳转 (jump if not equal)。
• jle: 如果小于或等于则跳转 (jump if less or equal)。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

; if-else 结构
mov rax, 10
mov rbx, 20
cmp rax, rbx
jne else_block ; 如果 rax != rbx, 跳转到 else_block

if_block:
    mov rcx, 1
    jmp end_if

else_block:
    mov rcx, 99

end_if:
    ; ...

; 循环结构
mov rcx, 1
loop_start:
    ; ... 循环体 ...
    inc rcx
    cmp rcx, 10
    jle loop_start ; 如果 rcx <= 10, 跳转到 loop_start

函数与调用约定

函数定义与调用

一个典型的函数包含函数序言、函数体和函数尾声。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

; 定义一个函数
AddTwoNumbers:
    ; 函数序言 (Function Prologue) - 建立栈帧
    push rbp            ; 保存调用者的基指针
    mov rbp, rsp        ; 建立我们自己的基指针

    ; 函数体 (Function Body)
    ; 参数已经由调用者放在了 rcx 和 rdx 中
    mov rax, rcx        ; 把第一个参数 (a) 放入 rax
    add rax, rdx        ; rax = rax + 第二个参数 (b)
    ; 现在计算结果 (a+b) 已经按约定存放在了 rax 中

    ; 函数尾声 (Function Epilogue) - 恢复栈帧
    mov rsp, rbp        ; 释放局部变量空间 (我们这里没有)
    pop rbp             ; 恢复调用者的基指针
    ret                 ; 返回！(跳转到 call 指令留下的返回地址)

; 调用函数
mov rcx, 50 ; 第一个参数
mov rdx, 25 ; 第二个参数
call AddTwoNumbers
; 返回值在 rax 中

参数传递与返回值 (x64 Windows 调用约定)

在x64 Windows调用约定中，函数参数和返回值的传递有明确的规则：

• 参数传递: 前四个整数或指针参数按从左到右的顺序依次放入 rcx, rdx, r8, r9 寄存器。更多的参数则通过栈传递。
• 返回值: 整数或指针类型的返回值通常存储在 rax 寄存器中。

在上面的 AddTwoNumbers 例子中：

1. mov rcx, 50 和 mov rdx, 25 将两个参数放入了正确的寄存器。
2. 函数内部直接从 rcx 和 rdx 读取参数。
3. add rax, rdx 的计算结果（返回值）被存放在 rax 中。
4. 调用 call AddTwoNumbers 之后，主程序通过读取 rax 寄存器来获取函数的返回值。

栈操作与 sub rsp, 40 的重要性

栈的基本操作

push 和 pop 用于在函数调用期间保存和恢复寄存器的状态，确保函数调用不会破坏调用者的寄存器。

1
2
3
4
5
6
7

; 函数序言中保存基指针
push rbp

; ...

; 函数尾声中恢复基指针
pop rbp

sub rsp, 40 与 Shadow Space

在x64 Windows调用约定中，sub rsp, 40 这行代码至关重要。它不仅仅是为局部变量分配空间，更重要的是它遵循了调用约定中的 Shadow Space (影子空间) 规则。

• 什么是Shadow Space?: 调用约定规定，当一个函数（调用者）准备调用另一个函数（被调用者）时，它必须在栈上为被调用者预留一块空间。这块空间被称为 “Shadow Space”。在x64 Windows上，这块空间的大小是32字节（可以容纳4个64位寄存器）。
• 为什么需要它?: 这块空间允许被调用函数在不修改自己栈帧的情况下，方便地保存 rcx, rdx, r8, r9 这四个参数寄存器的值。
• 为什么是40字节?: call 指令会将返回地址（8字节）压入栈中。为了保持栈的16字节对齐（这在x64下是推荐的，可以提高性能），并且为32字节的Shadow Space腾出空间，我们需要分配 32 + 8 = 40 字节。sub rsp, 40 正好满足了这个要求，它为即将到来的 call 指令做好了准备。

总结: sub rsp, 40 是在函数调用前，为满足x64 Windows调用约定而进行的关键栈操作，它分配了32字节的Shadow Space并确保了栈的对齐。

Windows API 调用详解

通过 call 指令调用 extern 声明的外部函数。以下是常用API的参数和返回值说明：

• ExitProcess: 终止当前进程。

  • 接收值: rcx - 进程的退出码 (一个32位无符号整数)。0 通常表示成功。
  • 返回值: 无。

• GetStdHandle: 获取标准输入、输出或错误设备的句柄。

  • 接收值: rcx - 一个指定标准设备的32位整数。常用值包括：
    • -10: 标准输入 (STD_INPUT_HANDLE)
    • -11: 标准输出 (STD_OUTPUT_HANDLE)
    • -12: 标准错误 (STD_ERROR_HANDLE)
  • 返回值: rax - 返回一个句柄。如果失败，返回 INVALID_HANDLE_VALUE (-1)。

• WriteConsoleA: 将一个ASCII字符串写入控制台。

  • 接收值:
    • rcx: 通过 GetStdHandle 获取的控制台输出句柄。
    • rdx: 指向要写入的字符串缓冲区的指针。
    • r8: 要写入的字符数。
    • r9: 指向一个变量的指针，该变量用于接收实际写入的字符数（可以为0，表示不关心）。
    • [rsp+32]: (栈上传递的第五个参数) 必须为0。
  • 返回值: rax - 如果函数成功，返回非零值。如果失败，返回零。

1
2
3
4
5
6
7
8
9
10
11
12

; 示例：打印 "Hello, World!"
mov rcx, -11          ; 获取标准输出句柄
call GetStdHandle

mov rcx, rax          ; 第一个参数：句柄
mov rdx, msg          ; 第二个参数：字符串地址
mov r8, msg_len       ; 第三个参数：字符串长度
mov r9, 0             ; 第四个参数：不关心写入的字符数
sub rsp, 32           ; 为第五个参数在栈上分配空间
mov QWORD [rsp+32], 0 ; 第五个参数：必须为0
call WriteConsoleA
add rsp, 32           ; 清理为第五个参数分配的栈空间

一个脚本

我还写了一个Python脚本用来帮我快速编译asm文件：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

import sys
import os
import subprocess

# ANSI escape codes for colors
class Color:
    RESET = '\033[0m'
    RED = '\033[31m'
    GREEN = '\033[32m'
    YELLOW = '\033[33m'
    BLUE = '\033[34m'
    MAGENTA = '\033[35m'
    CYAN = '\033[36m'

def run_command(command):
    """Runs a command and checks for errors, handling different encodings."""
    print(f"{Color.CYAN}执行命令: {Color.YELLOW}{' '.join(command)}{Color.RESET}")
    # Run command without text decoding to get raw bytes
    result = subprocess.run(command, capture_output=True, shell=True)

    # Try to decode output with gbk, fallback to utf-8
    try:
        stdout = result.stdout.decode('gbk')
        stderr = result.stderr.decode('gbk')
    except UnicodeDecodeError:
        stdout = result.stdout.decode('utf-8', errors='ignore')
        stderr = result.stderr.decode('utf-8', errors='ignore')

    if result.returncode != 0:
        print(f"{Color.RED}错误: 执行命令失败: {' '.join(command)}{Color.RESET}")
        if stdout.strip():
            print(f"{Color.RED}标准输出:\n{stdout.strip()}{Color.RESET}")
        if stderr.strip():
            print(f"{Color.RED}标准错误:\n{stderr.strip()}{Color.RESET}")
        sys.exit(1)
    
    print(f"{Color.GREEN}成功。{Color.RESET}")
    if stdout.strip():
        print(f"{Color.YELLOW}标准输出:\n{stdout.strip()}{Color.RESET}")

def main():
    """Main function to assemble and link the asm file."""
    if len(sys.argv) < 2:
        print(f"{Color.RED}用法: python asmc.py <文件名.asm> [库...]{Color.RESET}")
        sys.exit(1)

    asm_file = sys.argv[1]
    if not asm_file.lower().endswith('.asm'):
        print(f"{Color.RED}错误: 第一个参数必须是 .asm 文件, 但收到的是 {asm_file}{Color.RESET}")
        sys.exit(1)

    base_name = os.path.splitext(asm_file)[0]
    obj_file = base_name + '.obj'
    exe_file = base_name + '.exe'
    
    libs = sys.argv[2:]

    # 1. nasm -f win64 xxx.asm -o xxx.obj
    print(f"\n{Color.MAGENTA}--- 步骤 1: 汇编文件 ---{Color.RESET}")
    nasm_command = ['nasm', '-f', 'win64', asm_file, '-o', obj_file]
    run_command(nasm_command)

    # 2. link xxx.obj /subsystem:console /entry:_start /out:xxx.exe xxx.lib ...
    print(f"\n{Color.MAGENTA}--- 步骤 2: 链接目标文件 ---{Color.RESET}")
    link_command = ['link', obj_file, '/subsystem:console', '/entry:_start', f'/out:{exe_file}'] + libs
    run_command(link_command)

    # 3. del xxx.obj
    print(f"\n{Color.MAGENTA}--- 步骤 3: 清理 ---{Color.RESET}")
    print(f"{Color.CYAN}正在删除: {Color.YELLOW}{obj_file}{Color.RESET}")
    try:
        os.remove(obj_file)
        print(f"{Color.GREEN}成功。{Color.RESET}")
    except OSError as e:
        print(f"{Color.RED}错误: 删除文件 {obj_file} 失败: {e}{Color.RESET}")
        sys.exit(1)

    print(f"\n{Color.GREEN}所有步骤已成功完成！已生成可执行文件: {Color.YELLOW}{exe_file}{Color.RESET}")

if __name__ == "__main__":
    main()

用法：
python asmc.py <your_file.asm> [library1.lib library2.lib …]
例如：
python asmc.py hello.asm kernel32.lib

在我家里，使用了树莓派连接光猫进行拨号上网上网，并且用hostadp进行WiFi共享并分发。However，这个无论如何没法分发ipv6地址。所以，我决定采用一个方法，来让我家里的设备里的服务可以被外网访问。于是乎，我就想到了frp。

第二章 服务端安装

目前frp的最新版本是v0.61.1，我们下载最新版至一个文件夹内：

1

aria2c "https://github.com/fatedier/frp/releases/download/v0.61.1/frp_0.61.1_linux_arm64.tar.gz" -x 16 -o ./frp_0.61.1_linux_arm64.tar.gz

接下来解压这个文件：

1
2
3

tar -xvzf frp_0.61.1_linux_arm64.tar.gz
rm frp_0.61.1_linux_arm64.tar.gz
cd ./frp_0.61.1_linux_arm64

可以看到有以下文件：

1
2
3
4
5

├── frpc
├── frpc.toml
├── frps
├── frps.toml
└── LICENSE

删除无关文件：

1

rm frpc frpc.toml LICENSE frps.toml

接下来编辑start.sh：

1

./frps --bind-port 7000 --dashboard-port 7500 -t 选择一个密码 --dashboard-user 选择一个用户名 --dashboard-pwd 选择一个密码

添加执行权限：

1

chmod +x ./start.sh

新建screen窗口：

1

screen -S frps

开启frps服务：

1

./start.sh

退出screen窗口：

1

按下 Crtl + A，接着按 D

打开Server IP:7500可以进入控制面板，在弹出的输入框里输入用户名和密码，这里未涉及，不再作解释。

第三章 小结

目前，服务端已经搭建好，可以正常使用，地址为Server IP:7000。

** Enjoy It !**