Samera2022

MouseMacros-1.4.0 Release

Mon, 16 Feb 2026 03:08:00 GMT

::github{repo="Samera2022/MouseMacros"}

[2026-02-16 11:08] 1.4.0 Click here to Release </div>

[Added]

添加了“暂停宏”功能，现在可以在执行宏的过程中暂停和恢复了。

[Changed]

修改了“中止宏”的逻辑，现在点击“中止宏”按钮或按下热键会先暂停宏，再次点击或按下热键才会中止宏。
修改了“执行宏”的逻辑，现在点击“执行宏”按钮或按下热键在暂停状态下会恢复宏的执行。
修改SettingsDialog的实现以降低耦合度，同时引入模块化的分区以更加直观。

[Fixed]

修复了在宏执行过程中重复触发“执行宏”导致重复执行的问题。
修复了部分版本中“跟随系统设置”无法控制“切换语言”与“启用深色模式”的问题。
修复了在宏执行过程中意外触发暂停宏的问题。

[Added]

Added a "Pause Macro" feature, allowing you to pause and resume a macro during execution.

[Changed]

Modified the logic for "Abort Macro": now clicking the "Abort Macro" button or pressing the hotkey will first pause the macro; clicking again or pressing the hotkey again will abort it.
Modified the logic for "Run Macro": now clicking the "Run Macro" button or pressing the hotkey while in a paused state will resume the macro.
Updated the implementation of SettingsDialog to reduce coupling and introduced modular sections for better clarity.

[Fixed]

Fixed an issue where repeatedly triggering "Run Macro" during execution caused it to run multiple times.
Fixed an issue in some versions where "Follow System Settings" could not control "Switch Language" and "Enable Dark Mode".
Fixed an issue where the macro could be unintentionally paused during execution.

saMacros-2.0.0 Release

Thu, 12 Feb 2026 09:46:00 GMT

::github{repo="Samera2022/saMacros"}

[2026-02-12 17:46] 2.0.0 Click here to Release </div>

[Core Change] Project Rebranded to saMacros

MouseMacros has officially evolved into saMacros (Scriptable & Advanced Macros).
Switched license to Apache-2.0 for a more open ecosystem.

[Added]

Scripting Engine: Full support for GraalVM JavaScript, enabling complex logic and automation. See documentation for details.
Modern UI: Integrated FlatLaf with high-DPI support for a more professional look.

[Changed]

Architecture: Significant underlying refactoring. Project split into api and app modules with enhanced Javadoc and Unit Tests.
Runtime: Now targeting Java 21 for better performance and modern language features.

[核心变更] 项目更名为 saMacros

MouseMacros 正式升级为 saMacros (Scriptable & Advanced Macros)。
切换至 Apache-2.0 协议，提供更开放的开发生态。

[新增]

脚本引擎: 完整支持 GraalVM JavaScript 脚本，支持编写复杂的自动化逻辑，详见开发文档。
现代 UI: 集成 FlatLaf，支持高 DPI 缩放，提供更现代化的界面体验。

[优化]

底层架构: 进行大规模底层重构，将项目拆分为 api 与 app 模块，补充了完整的 Javadoc 与单元测试。
运行时: 运行环境升级至 Java 21，提升执行效率并利用现代 Java 特性。

二叉搜索树DFS的三序遍历

Sat, 07 Feb 2026 04:27:00 GMT

二叉搜索树DFS共有三种遍历方式，分别为“前序遍历”、“中序遍历”与“后序遍历”。让我们先考虑以下一种简单的DFS算法：

void order(TreeNode *root) {
    if (root == nullptr)
        return;
    order(root->left);
    order(root->right);
}

显然地，该代码会尝试左侧优先遍历整个二叉树，具体模式如下：

让我们先给出这三种遍历方式的代码：

/* 前序遍历 */
void preOrder(TreeNode *root) {
    if (root == nullptr)
        return;
    // 访问优先级：根节点 -> 左子树 -> 右子树
    vec.push_back(root->val);
    preOrder(root->left);
    preOrder(root->right);
}

/* 中序遍历 */
void inOrder(TreeNode *root) {
    if (root == nullptr)
        return;
    // 访问优先级：左子树 -> 根节点 -> 右子树
    inOrder(root->left);
    vec.push_back(root->val);
    inOrder(root->right);
}

/* 后序遍历 */
void postOrder(TreeNode *root) {
    if (root == nullptr)
        return;
    // 访问优先级：左子树 -> 右子树 -> 根节点
    postOrder(root->left);
    postOrder(root->right);
    vec.push_back(root->val);
}

观察发现三者在代码上较为相似，区别仅体现在将节点数据存入列表时的语句位置略有不同。这说明三者的节点遍历逻辑是完全一致的，仅仅在节点数据存入顺序上存在差异。

让我们进一步对节点存入顺序进行分析，不难发现以下事实：

前序遍历采用数据优先的策略，因而到达每个节点后会直接存入对应数据。
中序遍历采用左侧优先的策略，因而到达每个节点的左侧叶节点 |1->2->4, 1->3->6| 后才会开始存入数据。
后序遍历采用遍历优先的策略，因而到达每个节点的叶节点后才会开始存入数据。

三者在宏观上体现为：

前序遍历存入数据顺序完全符合遍历顺序。
中序遍历存入数据顺序按左叶节点优先，遍历顺序为次存入数据。
后序遍历存入数据顺序按子节点优先，遍历顺序为次存入数据。

该二叉树DFS遍历顺序为： 1 -> 2 -> 4 -> 2 -> 5 -> 2 -> 1 -> 3 -> 6 -> 3 -> 7 -> 3 -> 1

前序遍历存入的顺序为： |1| -> |2| -> |4| -> 2 -> |5| -> 2 -> 1 -> |3| -> |6| -> 3 -> |7| -> 3 -> 1
中序遍历存入的顺序为： 1 -> 2 -> |4| -> |2| -> |5| -> 2 -> |1| -> |3| -> |6| -> 3 -> |7| -> 3 -> 1
后序遍历存入的顺序为： 1 -> 2 -> |4| -> 2 -> |5| -> |2| -> 1 -> 3 -> |6| -> 3 -> |7| -> |3| -> |1|

将回溯纳入考虑，记为井号：该二叉树DFS遍历顺序为： 1 -> 2 -> 4 -# 2 -> 5 -# 2 -# 1 -> 3 -> 6 -# 3 -> 7 -# 3 -# 1

前序遍历存入的顺序为： |1| -> |2| -> |4| -# 2 -> |5| -# 2 -# 1 -> |3| -> |6| -# 3 -> |7| -# 3 -# 1
中序遍历存入的顺序为： 1 -> 2 -> |4| -# |2| -> |5| -# 2 -# |1| -> |3| -> |6| -# 3 -> |7| -# 3 -# 1
后序遍历存入的顺序为： 1 -> 2 -> |4| -# 2 -> |5| -# |2| -# 1 -> 3 -> |6| -# 3 -> |7| -# |3| -# |1|

观察发现：

前序遍历遇到新元素会直接存入列表
中序排列在抵达该节点的左叶节点后遇到新元素会直接存入列表
后序排列较为复杂，在抵达叶节点时直接存入，在左右子叶均抵达后回溯到达非叶节点时直接存入。

进行统一表述，可以得到：

三者在抵达叶节点时均会直接存入

面对新元素 |未存入数据的节点| 的策略：

前序遍历未抵达左侧全体叶节点、未抵达右侧全体叶节点时遇到新元素会直接存入列表
中序排列已抵达左侧全体叶节点、未抵达右侧全体叶节点时遇到新元素会直接存入列表
后序排列已抵达左侧全体叶节点、已抵达右侧全体叶节点时遇到新元素会直接存入列表

:::info 本文中所用到的代码与图片出自Hello算法，地址为：https://www.hello-algo.com/chapter_tree/binary_tree_traversal/#1_1 :::

MouseMacros-1.3.0 Release

Fri, 06 Feb 2026 13:20:00 GMT

::github{repo="Samera2022/MouseMacros"}

[2026-02-06 21:20] 1.3.0 Click here to Release </div>

[Changed]

改为使用updates.json维护更新日志。
开始使用Github Action。
改用maven构建。

Find Us on AlternativeTo - Growing the MouseMacros Community

Thu, 05 Feb 2026 13:40:00 GMT

Another exciting update for today: MouseMacros is now officially listed on AlternativeTo, the premier platform for crowdsourced software recommendations.

Check out our profile and help us grow: MouseMacros on AlternativeTo

Helping Others Discover a Better Choice

AlternativeTo is where users go to find leaner, faster, and more private alternatives to mainstream software. By joining this platform, we are positioning MouseMacros as a viable, open-source alternative to heavy automation suites.

Our listing highlights our core strengths:

Task Automation: Focused on efficiency.
Privacy Focused: 100% local, no telemetry.
Lightweight & Portable: Single executable (EVB-boxed) or MSI.
Ad-Free: Open source as it should be.

How You Can Help

If MouseMacros has helped you automate your workflow or save time in games like Stellaris, please consider:

Liking our page on AlternativeTo.
Leaving a review to share your experience with other users.

Your feedback helps the project gain visibility and shows potential users that there is a trustworthy, lightweight option available for their automation needs.

Stay tuned for more updates, and as always, thank you for being part of this journey!

MouseMacros Awarded "100% Clean" Excellence by Softpedia

Thu, 05 Feb 2026 02:00:00 GMT

I am proud to announce that MouseMacros has been officially reviewed and listed by Softpedia, one of the world's largest and most respected software download hubs.

You can view our official Softpedia page here: MouseMacros on Softpedia

A Badge of Trust

Softpedia is known for its rigorous testing process. We are thrilled to share that MouseMacros has been granted the "100% Free" Softpedia Award. This certification means that their technical team has tested our software and confirmed they are:

Free of Malware, Spyware, and Adware.
Safe to install and run on any Windows environment.

For a tool that interacts with system-level inputs, this third-party validation is invaluable. It serves as another layer of assurance alongside our recent Microsoft Security Intelligence clearance.

Why This Matters

Being listed on Softpedia helps users discover MouseMacros in a trusted environment. Whether you prefer downloading via the Microsoft Store, SourceForge, or now Softpedia, you can be certain that the code is transparent and the app is verified.

MouseMacros Now Available on the Microsoft Store

Tue, 03 Feb 2026 14:27:00 GMT

I’m excited to announce that MouseMacros has expanded its distribution channels. While the software remains a Windows-native tool, you can now get the Store Edition directly from the Microsoft Store, alongside our traditional standalone releases on GitHub and SourceForge.

You can click here to install it directly.

Why the Microsoft Store?

Bringing MouseMacros to the official Store was more than just adding a download link; it was about addressing the most significant hurdle: Trust and Security.

As many of you know, automation tools that use low-level system hooks are often flagged as "False Positives" by antivirus software. By launching on the Microsoft Store, we’ve achieved several critical goals:

Official Security Verification: Every submission is rigorously scanned and manually reviewed by Microsoft to ensure it is free of malware.
Official Code Signing: The Store version is digitally signed by Microsoft. This eliminates the "Unknown Publisher" warnings and those pesky Wacatac AI-based false positives.
Hassle-Free Updates: The Microsoft Store handles all future updates automatically in the background. You’ll always have the latest features and bug fixes without manual downloads.

Security Status Update

We are also proud to share that Microsoft Security Intelligence has officially reviewed our application (Submission ID: 6a2fc083-8db7-43b6-90d7-6f5bb04d4425). Their analysts confirmed that MouseMacros contains no malicious code.

This "clean" determination, combined with our Store presence, provides the highest level of assurance for our users.

Store Edition vs. Standalone Version

I remain committed to the open-source spirit and will continue to provide standalone versions on GitHub and SourceForge. Here is a quick comparison to help you choose:

Feature	Store Edition (MSIX)	Standalone (EXE/MSI)
Source	Microsoft Store	GitHub / SourceForge
Installation	One-click / Integrated	Manual Download
Updates	Automatic	Manual Check
Digital Signature	Signed by Microsoft	In Progress (SignPath)
Portability	Installed in System	Portable EXE available

What's Next?

While the Microsoft Store handles our "official" distribution, I am currently working with the SignPath Foundation to bring commercial-grade digital signatures to our open-source binaries. My goal is to ensure that no matter where you download MouseMacros, your system treats it with the respect and trust it deserves.

Thank You

This project started from a personal need to optimize workflows. Seeing it grow from a small script to an officially published Windows application has been an incredible journey.

Thank you for your continued support, feedback, and patience.

Get MouseMacros on the Microsoft Store: https://apps.microsoft.com/detail/9mx3kfbkmn1h

Join our community on Discord for support and feedback: Samera2022's Channel

MouseMacros Now Available on the SourceForge

Fri, 30 Jan 2026 15:38:00 GMT

As MouseMacros continues to grow, I want to ensure that every user can access our binaries through their preferred platform. Today, I am happy to announce that the project is now officially mirrored on SourceForge.

You can visit our new project page here: https://sourceforge.net/projects/mousemacros/

Why SourceForge?

While GitHub remains our primary home for source code and development, SourceForge offers several unique advantages for a project like ours:

Global Mirror Network: SourceForge provides a robust network of mirrors worldwide, ensuring fast and reliable downloads regardless of your geographic location.
Open Source Tradition: SourceForge has been a cornerstone of the open-source community for decades. Hosting MouseMacros here allows us to reach a broader audience of "Advanced End Users" who value established open-source platforms.
Detailed Analytics: The platform provides excellent download statistics, which helps me better understand our user base and prioritize future feature updates.

What This Means for You

From now on, every stable release of MouseMacros (including the latest v1.2.x series) will be uploaded to both GitHub and SourceForge simultaneously.

For our users, this simply means more choices. Whether you prefer the developer-centric environment of GitHub or the classic software directory feel of SourceForge, the binaries you receive will be identical.

Stay Connected

As always, the project remains fully open-source under the GPL-3.0 License. If you enjoy using the software, consider leaving a review on SourceForge or a Star on GitHub!

If you have any questions or feedback, feel free to join our Discord community: Samera2022's Channel.

Happy Automating!

MouseMacros-1.2.3 Release

Fri, 30 Jan 2026 08:33:00 GMT

::github{repo="Samera2022/MouseMacros"}

[2026-01-30 16:33] 1.2.3 Click here to Release </div>

[Fixed]

修改并补全部分语言的语言文件。
微调ExitDialog的高度补全参数。

L1-036~L1-040的笔记

Sat, 24 Jan 2026 01:42:00 GMT

::github{repo="Samera2022/GPLTNotes"}

P.S. 这份笔记同步发布在我的博客上，建议在博客中查看以享受完整的MD Extended Features. 你可以点此快速跳转到相应页面，我的博客地址为https://samera2022.github.io

L1-036

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int A,B;
    cin>>A>>B;
    cout<<A*B;
    return 0;
}

笔记部分

没有什么好记的。

L1-037

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;
//spec A 2/10

int gcd(int a, int b) {
    while (b != 0) {
        a %= b;
        swap(a, b);
    }
    return a;
}

void solve(int A, int B) {
    cout<<A<<"/"<<(B>=0?to_string(B):("("+to_string(B)+")"))<<"=";
    if (B==0) {
        cout<<"Error";
        return;
    }
    const int multiplier = gcd(abs(A),abs(B));
    A /= multiplier;
    B /= multiplier;
    cout<<fixed<<setprecision(2)<<static_cast<double>(A)/B;
}

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int A, B;
    cin>>A>>B;
    solve(A,B);
    return 0;
}

笔记部分

cout也可以进行格式输出。本段代码所示的为保留两位小数输出，写法为cout<<fixed<<setprecision(2)<<...。
除此之外地，它支持填充字符（123->*****123），写法为cout<<setw(int)<<setfill(char)<<...; 进制转换（255->0xff），写法为cout<<showbase<<hex<<...;
特别地，setw(n)仅对下次输出有效，其他操作符都是全局生效。

L1-038

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    cout<<"Hello World\nHello New World";
    return 0;
}

笔记部分

没有什么好记的。

L1-039

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

void complete(const int N, string& s) {
    const int len = static_cast<int>(s.length());
    const int time = N - len % N;
    for (int i = 1; i <= time; i++) s.append(" ");
}

void solve(const int N, string& s) {
    const int len = static_cast<int>(s.length());
    const int col = ((len%N==0) ? 0 : 1 ) + len / N;
    complete(N,s);
    for (int i = 1; i <= N; i++)
        for (int j = col - 1; j >= 0; j--)
            cout<<s[j * N + i - 1]<<((j==0)?"\n":"");
}

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int N;
    string s;
    cin>>N;
    cin.ignore();
    getline(cin,s);
    solve(N,s);
    return 0;
}

笔记部分

本题需要找一下规律，发现第一行均为len%N==1，第二行均为len%N==2，以此类推，在补空格使得字符串能被N整除之后，根据先前的规律反推即可。

L1-040

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int N;
    cin >> N;
    for (int i = 1; i <= N; i++) {
        char gender;
        double height;
        cin >> gender >> height;
        cout<<fixed<<setprecision(2)<<(gender=='M'?height/1.09:height*1.09)<<"\n";
    }
    return 0;
}

笔记部分

没有什么好记的。

L1-031~L1-035的笔记

Sat, 24 Jan 2026 01:25:00 GMT

::github{repo="Samera2022/GPLTNotes"}

L1-031

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;
//spec A 9/10

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int N;
    cin>>N;
    for (int i = 1; i <= N; i++) {
        int H;
        cin>>H;
        int W;
        cin>>W;
        const double sW = (H-100) * 0.9 * 2;
        const double delta = abs(W-sW);
        if (delta<0.1*sW) cout<<"You are wan mei!\n";
        else if (sW>=W) cout<<"You are tai shou le!\n";
        else if (sW<=W) cout<<"You are tai pang le!\n";
    }
    return 0;
}

笔记部分

采用if else-if的写法能够更加准确地进行判断。如果在else-if中仍然采用1.1*sW<=W和0.9*sW>=W的写法，很容易因为精度误差而发生错误。

L1-032

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int N;
    char delimiter;
    cin>>N>>delimiter;
    string content;
    cin.ignore();
    getline(cin,content);
    if (const int len = static_cast<int>(content.length()); N>=len) {
        for (int i = 1; i <= N-len; i++) cout<<string(1,delimiter);
        cout<<content;
    } else cout<<content.substr(len-N,N);
    return 0;
}

笔记部分

此处是getline()的第二种用法，即读取输入的整行内容到给定的字符串中。有的时候输入的数据中含有空格，却仍然要求读取整行时便会使用这种写法。特别地，由于cin读掉内容之后仍然会留下换行符或者空格，因此如果和cin连用，需要再次使用cin.ignore()或ws(cin)忽略这些空白字符。

L1-033

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

void complete(string& y);
int getTimes(const string &y);
void add(string& y);

set<char> temp;
int times;
int len;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    string y;
    int n;
    cin>>y>>n;
    complete(y);
    while (getTimes(y)!=n) add(y);
    cout<<times<<" "<<y;
    return 0;
}

void complete(string& y) {
    len = static_cast<int>(y.length());
    for (int i = 1; i <= 4-len; i++) y.insert(0,"0");
}

int getTimes(const string& y) {
    len = static_cast<int>(y.length());
    for (int i = 1; i <= len; i++) temp.insert(y[i-1]);
    const int time = static_cast<int>(temp.size());
    temp.clear();
    return time;
}

void add(string& y) {
    times++;
    int time = stoi(y);
    time++;
    y = to_string(time);
    complete(y);
}

笔记部分

这种方法看起来比较臃肿，但是我暂时也没想到更好的方法））
C++中在string的末端添加内容一般使用string.append()方法，而在前端添加内容则需要使用string.insert(0,content)方法。特别地，insert()方法本身是用来在某位置插入某内容的，在此处因为目标在开头所以填入索引为0。
清空set中所有元素的方法为set.clear()

L1-034

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

map<int,int> tagMap;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int times;
    cin>>times;
    for (int i = 1; i <= times; i++) {
        int time;
        cin>>time;
        for (int j = 1; j <= time; j++) {
            int tag;
            cin>>tag;
            tagMap[tag]++;
        }
    }
    int keyM = 0;
    int valM = 0;
    for (auto const& [key, val]: tagMap) {
        if (val>valM) {
            keyM = key;
            valM = val;
        } else if (val==valM) {
            if (key>keyM) {
                keyM = key;
                valM = val;
            }
        }
    }
    cout<<keyM<<" "<<valM;
    return 0;
}

笔记部分

本段代码中使用的是结构化绑定遍历，这种遍历要求类型必须为auto。该写法等价于for (const auto& kv : tagMap) { auto key = kv.first, val = kv.second; }

L1-035

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int time = 0;
    string i2;
    string i14;
    for (;;) {
        string input;
        cin>>input;
        if (input==".") break;
        time++;
        if (time==2) i2 = input;
        if (time==14) i14 = input;
    }
    if (i2.empty()) cout<<"Momo... No one is for you ...";
    else if (i14.empty()) cout<<i2<<" is the only one for you...";
    else cout<<i2<<" and "<<i14<<" are inviting you to dinner...";
    return 0;
}

笔记部分

没有什么好记的。

L1-026~L1-030的笔记

Sat, 24 Jan 2026 00:51:00 GMT

::github{repo="Samera2022/GPLTNotes"}

L1-026

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    cout<<"I\n \nL\no\nv\ne\n \nG\nP\nL\nT";
    return 0;
}

笔记部分

没有什么好记的。

L1-027

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

void solve(const string& tel);

int num[10];

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    string tel;
    cin>>tel;
    solve(tel);
    return 0;
}

void solve(const string& tel) {
    vector<int> used;
    vector<int> index;
    const int len1 = static_cast<int>(tel.length());
    for (int i = 1; i <= len1; i++) num[tel[i-1]-'0']++;
    for (int i = 10; i >= 1; i--) if (num[i-1]!=0) used.push_back(i-1);
    cout<<"int[] arr = new int[]{";
    const int len2 = static_cast<int>(used.size());
    for (int i = 1; i <= len2; i++) cout << used[i-1] << (i == len2 ? "" : ",");
    cout<<"};\n";
    for (int i = 1; i <= len1; i++) if (auto it = find(used.begin(), used.end(), tel[i-1] - '0'); it != used.end()) index.push_back(static_cast<int>(distance(used.begin(),it)));
    cout<<"int[] index = new int[]{";
    const int len3 = static_cast<int>(index.size());
    for (int i = 1; i <= len3; i++) cout << index[i-1] << (i == len3 ? "" : ",");
    cout<<"};\n";
}

笔记部分

    for (int i = 1; i <= len1; i++) 
        if (auto it = find(used.begin(), used.end(), tel[i-1] - '0'); it != used.end()) 
            index.push_back(static_cast<int>(distance(used.begin(),it)));

C++数组中查询某元素的索引写法比较独特，要通过iterator来实现。if (auto it = find(used.begin(), used.end(), tel[i-1] - '0'); it != used.end())这一句是指从vector的开始到结束，查找并返回tel[i-1]-'0''的位置，且当该位置不为最后时，执行如下操作。而后通过distance计算当前迭代器所指的位置和最开始的位置的距离。
一般地，针对普适的遍历，我们只需要: for (auto it = begin(s); it != end(s); it++)即可。

L1-028

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;
//spec A 4/10

const string& isPrime(ll n);
string YES = "Yes";
string NO = "No";

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int N;
    cin>>N;
    for (int i = 1; i <= N; i++) {
        int num;
        cin>>num;
        cout<<isPrime(num)<<"\n";
    }
    return 0;
}

ll llPow(ll a, ll b, const ll mod) {
    ll res = 1;
    a %= mod;
    while (b > 0) {
        if (b % 2 == 1) res = static_cast<ll>(static_cast<__int128_t>(res) * a % mod);;
        a = a * a % mod;
        b /= 2;
    }
    return res;
}

bool mrTest(const ll n, const ll a) {
    if (a % n == 0) return true;
    ll d = n - 1;
    while (d % 2 == 0) d /= 2;
    ll x = llPow(a, d, n);
    if (x == 1 || x == n - 1) return true;
    while (d != n - 1) {
        x = static_cast<ll>(static_cast<__int128_t>(x) * x % n);        d *= 2;
        if (x == n - 1) return true;
        if (x == 1) return false;
    }
    return false;
}


const string& isPrime(const ll n) {
    if (n < 2) return NO;
    if (n == 2 || n == 3) return YES;
    if (n % 2 == 0) return NO;

    static const vector<ll> bases = {2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37};

    for (const ll a : bases) {
        if (n == a) return YES;
        if (!mrTest(n, a)) return NO;
    }
    return YES;
}

笔记部分

本题如果用一般的埃氏筛法，可以拿到6分。剩下的4分需要使用更高效的质数算法：Miller-Rabin素数测试。

L1-029

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int H;
    cin>>H;
    printf("%.1f",(H-100)*0.9*2);
    return 0;
}

笔记部分

没有什么好记的。

L1-030

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int N;
    cin>>N;
    string girls[N/2];
    string boys[N/2];
    string index;
    int curtG = 1;
    int curtB = 1;
    for (int i = 1; i <= N; i++) {
        int gender;
        cin>>gender;
        string name;
        cin>>name;
        if (!gender) {
            girls[curtG-1] = name;
            curtG++;
        } else {
            boys[curtB-1] = name;
            curtB++;
        }
        if (i<=N/2) index.append(to_string(gender));
    }
    curtG = 1;
    curtB = 1;
    for (int i = 1; i <= N/2; i++) {
        if (const int gender = index[i-1]-'0'; !gender) {
            cout<<girls[curtG-1]<<" "<<boys[N/2-curtG]<<"\n";
            curtG++;
        } else {
            cout<<boys[curtB-1]<<" "<<girls[N/2-curtB]<<"\n";
            curtB++;
        }
    }
    return 0;
}

笔记部分

没有什么好记的。

L1-021~L1-025的笔记

Fri, 23 Jan 2026 03:06:00 GMT

::github{repo="Samera2022/GPLTNotes"}

L1-021

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    cout<<"I'm gonna WIN!\n";
    cout<<"I'm gonna WIN!\n";
    cout<<"I'm gonna WIN!\n";
    return 0;
}

笔记部分

没有什么好记的。

L1-022

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int N;
    cin>>N;
    int oddNum = 0;
    for (int i = 1; i <= N; i++) {
        int temp;
        cin>>temp;
        if (temp%2==1) oddNum++;
    }
    cout<<oddNum<<" "<<N-oddNum;
    return 0;
}

笔记部分

没有什么好记的。

L1-023

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int g, p ,l ,t;
    g=p=l=t=0;
    string input;
    cin>>input;
    const int len = static_cast<int>(input.length());
    for (int i = 1; i <= len; i++) {
        switch (input[i-1]) {
            case 'g':
            case 'G':
                g++;
                break;
            case 'p':
            case 'P':
                p++;
                break;
            case 'l':
            case 'L':
                l++;
                break;
            case 't':
            case 'T':
                t++;
                break;
            default:
                break;
        }
    }
    while (g!=0||p!=0||l!=0||t!=0) {
        if (g!=0) {
            cout<<"G";
            g--;
        }
        if (p!=0) {
            cout<<"P";
            p--;
        }
        if (l!=0) {
            cout<<"L";
            l--;
        }
        if (t!=0) {
            cout<<"T";
            t--;
        }
    }
    return 0;
}

笔记部分

没有什么好记的。

L1-024

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int num[] = {3,4,5,6,7,1,2};

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int D;
    cin>>D;
    cout<<num[D-1];
    return 0;
}

笔记部分

没有什么好记的。

L1-025

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;
//spec 1/15

int formatString(const string &a);

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    string a,b,c;
    cin>>a>>b>>c;
    const int numA = formatString(a);
    int numB;
    if (c.empty()) numB = formatString(b);
    else numB = -1;
    cout<<(numA==-1?"?":to_string(numA))<<" + "<<(numB==-1?"?":to_string(numB))<<" = "<<((numA==-1||numB==-1)?"?":to_string(numA+numB));
    return 0;
}

int formatString(const string &a) {
    if (const int aLen = static_cast<int>(a.length()); aLen==4&&a=="1000") return 1000;
    else if (aLen<4&&a!="0")
        for (int i = 1; i <= aLen; i++) {
            if (!isdigit(a[i-1])) return -1;
        }
    else return -1;
    return stoi(a);
}

笔记部分

【再次强调】C++中char转String不能使用to_string(char)。如果已经确定char为数字，则可用char - '0'转为int类型，而后使用to_string(int)，即to_string(char-'0')。如果char未被确定类型（数字也可以），则直接使用string(1,char)即可。

L1-016~L1-020的笔记

Thu, 22 Jan 2026 13:03:00 GMT

::github{repo="Samera2022/GPLTNotes"}

L1-016

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;
//spec A

void solve(const string s[], int size);

int weight[] = {7,9,10,5,8,4,2,1,6,3,7,9,10,5,8,4,2};
char validate[] = "10X98765432";

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int N;
    cin>>N;
    string s[N];
    for (int i = 1; i <= N; i++) {
        string content;
        cin>>content;
        s[i-1] = content;
    }
    solve(s, N);
    return 0;
}

void solve(const string s[], const int size) {
    int errors = 0;
    vector<string_view> vsv;
    for (int i = 1; i <= size; i++) {
        const string &content = s[i-1];
        int temp = 0;
        bool isDigit = true;
        for (int j = 1; j <= 17; j++) {
            if (isdigit(content[j-1]))  temp += (content[j-1]-'0') * weight[j-1];
            else {
                isDigit = false;
                break;
            }
        }
        if (validate[temp%11]!=content[17] || !isDigit) {
            errors++;
            vsv.push_back(content);
        }
    }
    if (vsv.empty()) cout<<"All passed";
    else for (const string_view sv : vsv) cout<<sv<<"\n";
}

笔记部分

string s[]仅在其定义域中能够获取其大小。获取大小的方式有如下两种：①sizeof(s)/sizeof(s[0])通过整个数组占用的字节数除以单个元素占用的字节数; ②begin(s)-end(s)通过指针相减来计算元素个数。说实在话，这两种不如直接使用定义string s[]长度的变量了。
需要注意的是: ①s->length();和s->size();获取的不是s[]的大小，而是s[0]的长度; ②将数组s[]作为参数传入函数后，其会发生指针退化，即数组丢失了其长度信息和数组类型属性，隐式地转换成指向其第一个元素的指针。这导致无法在传入的函数中正确获取其长度。
向vector中压入数据使用的是vector.push_back()，这会将新的元素放在队尾。
string_view是保存string的引用的一个容器，cout方法有对其的兼容。

    for (int i = 1; i <= N; i++) {
        string content;
        cin>>content;
        s[i-1] = content;
    }

针对这一段循环输入，有以下几种简洁的替代方案:
①（定长数组或vector）for (string& content : s) cin >> content;
②（定长数组或vector）copy_n(istream_iterator<string>(cin), N, (定长数组) s | (vector) s.begin()); 需要补充的是: (定长数组) s这里的s是以指向首元素的指针（迭代器）传入的。
③（vector）vector<string> s{istream_iterator<string>(cin), istream_iterator<string>()};
④（vector）重载位右移运算符istream& operator>>(istream& is, vector<T>& v) { for (auto& x : v) is >> x; return is;}而后vector<string> s(N); cin >> s;

L1-017

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

void solve(string& content);

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    string content;
    cin>>content;
    solve(content);
    return 0;
}

void solve(string& content) {
    bool isNegative = false;
    if (!isdigit(content[0])) {
        content.erase(remove(content.begin(),content.end(),'-'),content.end());
        isNegative = true;
    }
    int cnt = 0;
    const int len = static_cast<int>(content.length());
    const bool isEven = (content[len-1]-'0')%2==0;
    for (int i = 1; i <= len; i++) if (content[i-1]=='2') cnt++;
    double res = static_cast<double>(cnt)/len;
    if (isNegative) res *= 1.5;
    if (isEven) res *= 2;
    res *= 100;
    printf("%.2f%%", res);
}

笔记部分

printf()是格式化输出，前面的%.2f指的是以两位小数输出，后面的%%指的是输出一个%符号。
printf()支持以下几种格式说明符: %d(有符号十进制整数) %f(浮点数) %s(字符串) %c(字符) %x(无符号十六进制整数)。
类似的格式说明符也可以用于输入scanf()。
C++17中检测string中是否含有某字符需要通过string.find()来完成。具体地，应为s.find()!=string::npo，表示找到的位置不是npos，即该位置存在。可以通过该方法来查询string中是否出现了负号来判断是否为负数。当然，在本段代码中采用的是isdigit(content[0])来判断是否有负号。

L1-018

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

void solve(const string& content);

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    string time;
    cin>>time;
    solve(time);
    return 0;
}

void solve(const string& content) {
    const string a = content.substr(0,2);
    const string b = content.substr(3,2);
    const int h = stoi(a);
    if (h<12||(h==12&&b=="00")) cout<<"Only "<<content<<".  Too early to Dang.";
    else {
        const int time = stoi(a)-12+(b=="00"?0:1);
        for (int i = 1; i <= time; i++) cout<<"Dang";
    }
}

笔记部分

stoi()只能用于string转int的情况。
【便于记忆】索引是位于字符串中的char之间的。比方说，以string s = "time"为例，其索引为0t 1i 2m 3e。其中，从0开始长度为2即代表0 1 2中的char，即为ti。

L1-019

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int AMax, BMax, time;
    cin>>AMax>>BMax>>time;
    int curtA = 0, curtB = 0;
    for (int i = 1; i <= time; i++) {
        int num[4];
        cin >> num[0] >> num[1] >> num[2] >> num[3];
        const int sum = num[0] + num[2];
        if (num[1]==sum&&num[3]!=sum) curtA++;
        if (num[1]!=sum&&num[3]==sum) curtB++;
        bool isADefeated = curtA == AMax + 1;
        if (isADefeated || curtB == BMax + 1) {
            cout<<(isADefeated?"A":"B")<<"\n"<<(isADefeated?curtB:curtA);
            return 0;
        }
    }
    return 0;
}

笔记部分

这里出现了连续定义的两种形式: ①未初始化的定义int AMax, BMax, time;，此处三个值均未被初始化; ②初始化的定义int curtA = 0, curt B = 0;，此处两个值均被初始化为0。
特别地，考虑以下的情况: ①int& a,b;这种情况应为int &a; int b;; ②int a,b = 1;这种情况应为`int a; int b = 1;。
为处理上一条中的②，我们可以采用C++的链式赋值，即你可以这么操作a=b=1。具体地，在链式赋值中，编译器首先会从最右端开始分组。计算(b=1)后返回b的引用，进而让a= (b=1)，使得a=1。
cin可连续赋值，如cin >> num[0] >> num[1] >> num[2] >> num[3];所示。不过这一点在cout中其实已经用到过了，如之前的cout<<"Only "<<content<<". Too early to Dang."就是连续传入给cout的。

L1-020

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int N;
    cin>>N;
    set<string> s;
    for (int i = 1; i <= N; i++) {
        int K;
        cin>>K;
        for (int j = 1; j <= K; j++) {
            string temp;
            cin>>temp;
            if (K>1)
                s.insert(temp);
        }
    }
    int M;
    cin>>M;
    set<string> res;
    bool isFirst = false;
    for (int i = 1; i <= M; i++) {
        string M1;
        cin>>M1;
        if ((s.count(M1)==0)&&res.count(M1)==0) {
            if (isFirst)
                cout<<" ";
            isFirst = true;
            cout<<M1;
            res.insert(M1);
        }
    }
    if (res.empty()) cout<<"No one is handsome";
    return 0;
}

笔记部分

C++中的set也要求不能出现重复元素，但multiset可以出现重复元素。将元素加入set的方法为set.insert()。
C++17中没有直接检测set中是否存在某元素的方法，只能通过set.count()检查元素出现的次数来曲线救国。

基于偏移截断法的n舍n+1入简单数学分析

Thu, 22 Jan 2026 07:08:00 GMT

本文主要分析C++环境下的偏移截断法。当然，核心的逻辑对于其他语言也适用，本文仅以C++举例。C++的强制转型取整为去尾转型，即抛弃所有小数位数。基于此，我们可以讨论基于偏移的截断。

本文尽力做到通俗且严谨，如有疏漏还望大佬轻喷，不吝赐教！

一、简单解答

法1. 四舍五入的情况（采用实数的规范小数表示证明）

特殊地，我们先考虑四舍五入的情况。

(1) 考虑正数情况

对于正数A.49和B.51我们期望得到A和(B+1)。为得到我们的期望，我们需要至多能给A加0.51，至少要给B加0.49。即，我们至多能给A加(1-0.49)，至少要给B加(1-0.51)。我们需要加入的偏移量Δ应满足(1-0.51)<Δ<(1-0.49)。

我们考虑 $$\forall k\in \mathbb{N}^* $$, $$A.50-10^{-k}<A.50 $$取整为 $$A $$, $$B.50+10^{-k}>B.50 $$取整为 $$B+1 $$. 在这种条件下，我们的Δ应满足 $$1-\left( 0.5+10^{-k} \right) \leq\Delta <1-\left( 0.5-10^{-k} \right) $$.

至此我们可以选择三种方法:

法1.1: 极限的保不等式性质（等价于夹逼定理）

由极限的保不等式性质，对左右两侧不等式分别求极限，可得 $$\lim_{k\rightarrow \infty} \left[ 1-\left( 0.5+10^{-k} \right) \right] \leq \Delta $$, $$ \Delta \leq \lim_{k\rightarrow \infty} \left[ 1-\left( 0.5-10^{-k} \right) \right] $$.

考察两个式子的极限，发现 $$\lim_{k\rightarrow \infty} \left[ 1-\left( 0.5+10^{-k} \right) \right] =\lim_{k\rightarrow \infty} \left[ 1-\left( 0.5-10^{-k} \right) \right] =0.5$$

则有 $$\Delta=0.5 $$.

法1.2: 单调性

我们可研究不等式两边的单调性，发现 $$1-\left( 0.5+10^{-k} \right) $$单调递增, $$1-\left( 0.5-10^{-k} \right) $$单调递减。

考察两个式子的极限，发现 $$\lim_{k\rightarrow \infty} \left[ 1-\left( 0.5+10^{-k} \right) \right] =\lim_{k\rightarrow \infty} \left[ 1-\left( 0.5-10^{-k} \right) \right] =0.5$$

由于 $$1-\left( 0.5+10^{-k} \right) \leq\Delta <1-\left( 0.5-10^{-k} \right) $$ 对 $$\forall k\in \mathbb{N}^* $$ 成立，则取 $$ k \rightarrow \infty $$, 有 $$0.5=\lim_{k\rightarrow \infty} \left[ 1-\left( 0.5+10^{-k} \right) \right] \leq \Delta \leq \lim_{k\rightarrow \infty} \left[ 1-\left( 0.5-10^{-k} \right) \right] =0.5$$, 则 $$\Delta=0.5 $$.

法1.3: 不等式+闭区间套定理

为了构造闭区间以满足区间套定理的要求，我们将开区间放缩为闭区间（这是充分的），由此可得 $$1-\left( 0.5+10^{-k} \right) \leq\Delta \leq 1-\left( 0.5-10^{-k} \right) $$

进而我们可以发现 $$\Delta \in \left[ 1-\left( 0.5+10^{-k} \right) ,1-\left( 0.5-10^{-k} \right) \right] $$.

记 $$a_n=1-\left( 0.5+10^{-k} \right) , b_n=1-\left( 0.5-10^{-k} \right) $$, 则 $$\left{ \left[ a_k,b_k \right] \right} $$ 满足下列条件:

$$\forall k, \left[ a_{k+1},b_{k+1} \right] \subset \left[ a_k,b_k \right] $$
$$\lim_{k\rightarrow \infty} \left( b_k-a_k \right) =\lim_{k\rightarrow \infty} \left( 2\times 10^{-k} \right) =0$$

可见 $$\left{ \left[ a_k,b_k \right] \right} _{k=1}^{\infty}$$ 是一个闭区间套.

由区间套定理, 存在唯一的实数 $$\xi $$, 使得 $$\xi \in \left[ a_k,b_k\right]$$

考察两个式子的极限，发现 $$\lim_{k\rightarrow \infty} \left[ 1-\left( 0.5+10^{-k} \right) \right] =\lim_{k\rightarrow \infty} \left[ 1-\left( 0.5-10^{-k} \right) \right] =0.5$$

则有唯一实数 $$\xi=0.5 $$, 即 $$\Delta=0.5 $$.

(2) 考虑负数情况

对于负数-A.49和-B.51我们期望得到-A和-(B+1)。直接取C=-(-A.49)=A.49, D=-(-B.51)=B.51。则注意到在情况(1)中，我们可得C和D在Δ=0.5时有结果分别为A与B+1。则直接全体取反，可得Δ=-0.5时，满足四舍五入的要求。

法2. 四舍五入的情况（采用ε语言证明）

上文我们直观地感受了一下大概的情况，现在我们进行严谨的考虑。

(1) 考虑正数情况

我们考虑 $$\forall n\in \mathbb{N}^*, \varepsilon>0 $$, $$A.50-\varepsilon<A.50 $$取整为 $$A $$, $$B.50+\varepsilon>B.50 $$取整为 $$B+1 $$. 在这种条件下，我们的Δ应满足 $$1-\left( 0.5+\varepsilon \right) \leq\Delta <1-\left( 0.5-\varepsilon \right) $$, 即 $$0.5-\varepsilon \leq \Delta \leq 0.5+\varepsilon $$.

至此我们选择下列两种方法:

法2.1: 极限的保不等式性质（等价于夹逼定理）

由于 $$\forall \varepsilon >0, \text{均有}0.5-\varepsilon \leq \Delta <0.5+\varepsilon $$, 则对不等式两端同取 $$\varepsilon\rightarrow 0 $$ 的极限，则有 $$\lim_{\varepsilon \rightarrow 0^+} \left( 0.5-\varepsilon \right) \leq \Delta \leq \lim_{\varepsilon \rightarrow 0^+} \left( 0.5+\varepsilon \right) $$. 进而有 $$\Delta=0.5 $$

法2.2: 不等式引理+反证法

先考虑不等式的左侧: $$0.5-\varepsilon \leq \Delta $$.

根据引理 $$\text{若}\forall \varepsilon >0, \text{均有}a<b+\varepsilon , \text{则}a\le b$$, 有 $$0.5 \leq \Delta $$

考虑不等式的右侧: $$\Delta \leq 0.5+\varepsilon$$. 考虑下列命题: $$\forall \varepsilon >0, \text{若}\Delta +\varepsilon <0.5, \text{则}\Delta \leq 0.5 $$

采用反证法: 假设 $$\Delta >0.5 $$, 则 $$\Delta +\varepsilon >0.5+\varepsilon $$, 与题设 $$\Delta +\varepsilon <0.5$$ 矛盾！故有 $$\Delta \leq 0.5$$ 成立! 再由 $$0.5 \leq \Delta $$, 可得 $$\Delta=0.5 $$.

(2) 考虑负数情况

考虑 $$\forall \varepsilon>0 $$, 对于负数-A-0.5+ε和-B-0.5-ε我们期望得到-A和-(B+1)。直接取C=-(-A-0.5+ε)=A+0.5-ε, D=-(-B-0.5-ε)=B+0.5+ε。则注意到在情况(1)中，我们可得C和D在Δ=0.5时有结果分别为A与B+1。则直接全体取反，可得Δ=-0.5时，满足四舍五入的要求。

n舍n+1入的情况

上文中我们对四舍五入的情况给出了5种证明方法，此处我们仅使用ε语言证明+极限的保不等式性质（等价于夹逼定理）证明，其他方法同理。

(1) 考虑正数情况

我们考虑 $$\forall n\in \mathbb{N}^*, \varepsilon>0 $$, $$A+0.1(n+1)-\varepsilon<A+0.1(n+1) $$取整为 $$A $$, $$B+0.1(n+1)+\varepsilon>B+0.1(n+1) $$取整为 $$B+1 $$. 在这种条件下，我们的Δ应满足 $$1-\left( 0.1(n+1)+\varepsilon \right) \leq\Delta <1-\left( 0.1(n+1)-\varepsilon \right) $$, 即 $$0.9-0.1n-\varepsilon \leq \Delta \leq 0.9-0.1n+\varepsilon $$.

由于 $$\forall \varepsilon >0, \text{均有}0.9-0.1n-\varepsilon \leq \Delta \leq 0.9-0.1n+\varepsilon $$, 则对不等式两端同取 $$\varepsilon\rightarrow 0 $$ 的极限，则有 $$\lim_{\varepsilon \rightarrow 0^+} \left( 0.9-0.1n-\varepsilon \right) \leq \Delta \leq \lim_{\varepsilon \rightarrow 0^+} \left( 0.9-0.1n+\varepsilon \right) $$. 进而有 $$\Delta=0.9-0.1n $$

(2) 考虑负数情况

考虑 $$\forall \varepsilon>0 $$, 对于负数-A-0.1(n+1)+ε和-B-0.1(n+1)-ε我们期望得到-A和-(B+1)。直接取C=-(-A-0.1(n+1)+ε)=A+0.1(n+1)-ε, D=-(-B-0.1(n+1)-ε)=B+0.1(n+1)+ε。则注意到在情况(1)中，我们可得C和D在Δ=0.9-0.1n时有结果分别为A与B+1。则直接全体取反，可得Δ=-(0.9-0.1n)时，满足n舍n+1入的要求。

二、复杂解答

定义

在详细的讨论开始前，我们先进行如下定义：

定义截断算子: $$Tr\left( x \right) =sgn \left( x \right) \cdot \lfloor \left| x \right| \rfloor $$. 该算子的物理意义为：抹除实数x的小数部分，仅保留整数。
定义取整准则: 考虑实数 $$X\in \mathbb{R} $$, 其整数部分为 $$I $$, 小数部分为 $$f\in \left[ 0,1 \right) $$. 即满足 $$\left| X \right|=I+f $$. 定义"n舍n+1入"的进位阈值为 $$T\in \left[ 0,1 \right) $$. 则我们期望的取整函数 $$R\left( X,T \right) $$应满足下列条件:

$$R\left( X,T \right) = \left{ \begin{array}{c} I \cdot \text{sgn} \left( X \right) , f<T\ \left( I+1 \right) \cdot \text{sgn} \left( X \right) , f\ge T\ \end{array} \right. $$
定义偏移量: 考虑偏移量 $$\Delta $$, 使得 $$Tr\left( X + \Delta \right) =R\left ( X,T \right)$$

解答

为找到偏移量 $$\Delta $$, 进行下列操作:

(1) 考虑正数域

由于在正数域下，可得: $$\lfloor I + f + \Delta \rfloor = \left{ \begin{array}{c} I, f < T \ I + 1, f \ge T \end{array} \right. $$

又由底函数性质 $$\lfloor I + \alpha \rfloor = I + \lfloor \alpha \rfloor$$, 可得: $$\lfloor f + \Delta \rfloor = \left{ \begin{array}{c} 0, f + \Delta < 1 \ 1, f + \Delta \ge 1 \end{array} \right. $$

欲使阈值点 $$f = T$$ 恰好成为进位临界点，则应有: $$ \begin{cases} T + \Delta \ge 1 \implies \Delta \ge 1 - T \ \lim_{\epsilon \to 0} (T - \epsilon) + \Delta < 1 \implies \Delta \leq 1 - T \end{cases} $$

即得 $$1-T\le \Delta \leq 1-T $$, 则有唯一解为: $$\Delta = 1 - T $$

(2) 考虑负数域

考虑负数 $$-N=-I-f<0 $$, 其中 $$N, I, f>0 $$.

由于在复数域下，可得: $$\lfloor -I-f+\Delta \rfloor =\left{ \begin{array}{c} -I,f<T\ -I-1,f\ge T\ \end{array} \right. $$

即有 $$\lfloor I+f-\Delta \rfloor =\left{ \begin{array}{c} I,f<T\ I+1,f\ge T\ \end{array} \right. $$

令 $$ \Delta_0 = - \Delta $$, 则有 $$\lfloor I+f+\Delta_0 \rfloor =\left{ \begin{array}{c} I,f<T\ I+1,f\ge T\ \end{array} \right. $$

则由情况(1)，可得 $$\Delta_0 = 1 - T $$, 进而有: $$\Delta =-\left( 1-T \right) $$

结论

我们可以得到在n舍n+1入的情况下，偏移量为Δ=1-0.1(n+1)=0.9-0.1n. 由此我们可以快速设计n舍n+1入算法: static_cast<int>(a+(a==0?0:(0.9-0.1*n)*(a>0?1:(-1)))).

考虑到-0.0的存在，我们需要将a==0时的情况改为0.0f: static_cast<int>(a+(a==0?0.0f:(0.9-0.1*n)*(a>0?1:(-1))))

由于计算机存在精度损失，我们需要考虑以下情况: $$2.5+\left( 0.9-0.1\times 4 \right) \xsim{\text{精度损失}}2.5+0.49999999999=2.99999999999\xrightarrow{static_cast}2$$

为修正精度丢失所带来的影响，我们可以引入1e-9项，这使得丢失的精度仍然可以跨过static_cast<int>的阈值。

进而可以变为如下形式: static_cast<int>( a + ( a == 0 ? 0.0f : ( 0.9 - 0.1 * n + 1e-9 ) * ( a > 0 ? 1 : -1))).

特别地，针对四舍五入的情况，可以得到static_cast<int>( a + ( a == 0 ? 0.0f : ( 0.5 + 1e-9 ) * ( a > 0 ? 1 : -1))).

更进一步地，如果能确定数据均为正数或负数，可直接略去三目运算符。

优势和劣势

该方法在通常情况下会比round()函数更快，但由于该语句中三目运算符产生的分支，如果输入的数据中大量出现正负交替的现象，则会由于CPU分支预测器的失效导致严重的性能抖动。
可能存在溢出风险，这需要开发者进行额外的注意（尽管round()函数也会出现溢出就是了）。

L1-011~L1-015的笔记

Thu, 22 Jan 2026 05:11:00 GMT

::github{repo="Samera2022/GPLTNotes"}

L1-011

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

void solve(string& A, string& B);

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    string A;
    getline(cin,A);
    string B;
    getline(cin,B);
    solve(A,B);
    return 0;
}

void solve(string& A, string& B) {
    const int len = static_cast<int>(B.length());
    for (int i = 0; i <= len; i++)
        A.erase(remove(A.begin(),A.end(),B[i-1]), A.end());
    cout<<A;
}

笔记部分

在Java中，我们可以直接通过replace(CharSequence target, "")来快速地删除字符串中全体的某种字符，然而在C++中实现这种操作略微复杂一些。在此我们需要先介绍两个方法：string.erase()和remove()。
关于string.erase(iterator first, iterator last)：该方法会移除从first到last的所有字符。
关于remove(iterator first, iterator last, char target)：该方法会将从first到last的所有非target_char字符向前移动并返回正确新结尾的迭代器，从整体上来看就是把所有的target_char后移了。
尽管C++中没有原生的直接移除字符串中某字符的方法，不过有替换字符串中全体某字符为另外一个字符的方法：对于string s而言，可用replace(s.begin(), s.end(), (char) old_char, (char) new_char)。由于new_char必须是一个char类型，导致不能写''进去……

L1-012

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int n;
    cin>>n;
    cout<<"2^"<<n<<" = "<<pow(2,n);
    return 0;
}

笔记部分

<cmath>包含在<bits/stdc++.h>中，因此在using namespace std时可以直接使用pow(2, n)

L1-013

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

void solve(int N);
int factorial(int n);

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int N;
    cin>>N;
    solve(N);
    return 0;
}

void solve(const int N) {
    int res = 0;
    for (int i = 1; i <= N; i++) res += factorial(i);
    cout<<res;
}

int factorial(const int n) {
    if (n==0) return 1;
    int res = 1;
    for (int i = 1; i <= n; i++) res *= i;
    return res;
}

笔记部分

没有什么好记的。

L1-014

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    cout<<"This is a simple problem.";
    return 0;
}

笔记部分

没有什么好记的。

L1-015

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

void solve(int N, const string& delimiter);

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int N;
    cin>>N;
    string delimiter;
    cin>>delimiter;
    solve(N,delimiter);
    return 0;
}

void solve(const int N, const string& delimiter) {
    const int row = static_cast<int>(round(static_cast<double>(N)/2));
    for (int i = 1; i <= row; i++) {
        for (int j = 1; j <= N; j++) cout<<delimiter;
        cout<<"\n";
    }
}

笔记部分

C++中四舍五入使用的是round(double)方法。特别地，该方法返回的仍然为double类型，需要进一步手动转换。
由于C++的浮点转整数为去尾转换，你也可以借助这个性质来快速转换：考虑double a;，对于正数你可以使用static_cast<int>(a+0.5)，对于负数你可以使用static_cast<int>(a+(-0.5))，对于0而言，为了保持统一性，我们需要使用static_cast<int>(a+0.0f)。因此综合地，你可以使用static_cast<int>( a + ( a == 0 ? 0.0f : ( 0.5 + 1e-9 ) * ( a > 0 ? 1 : -1)))来进行快速四舍五入。类似地，你可以处理五舍六入等情况。关于偏移截断的内容，详见这篇文章或这篇文章
如果你希望返回其他整数类型，可以采用lround(doble)（返回long）和llround(double)（返回long long）。
特别地，C++并不原生支持四舍五入到N位小数，如果你需要这样的操作，需要先乘以eN倍，取整后再除以eN还原回来。

L1-006~L1-010的笔记

Thu, 22 Jan 2026 03:04:00 GMT

::github{repo="Samera2022/GPLTNotes"}

L1-006

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;
//Spec A 2/20 Point

void solve(int N);

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int N;
    cin>>N;
    solve(N);
    return 0;
}

void solve(const int N) {
    //Spec Tip Start
    int crtMax = 1;//连续因数的个数的最大值
    int crt = N;//连续因数最小值，当其为质数时即为其本身
    //Spec Tip End
    for (int i = 2; i<=sqrt(N); i++) {
        if (int n = N; n%i==0) {
            int delta = 0;
            bool valid = n%(i+delta)==0;
            while (valid) {
                n/=i+delta;
                valid = n%(i+delta+1)==0;
                if (valid) delta++;
                else break;
            }
            //Spec Tip Start
            //delta+1代表此时的连续因数长度，此时有更长连续因数长度时，对crt进行同步
            if (delta+1>crtMax) {
                crtMax = delta+1;
                crt = i;
            }
            if (crt==N) crt = i;//需要最小因子序列，因此需要考虑其可分解为两数相乘时，连续因数最小值改为最小因数
            //Spec Tip End
        }
    }
    cout<<crtMax<<"\n";
    for (int i = 0; i < crtMax; i++) {
        cout<<crt+i;
        if (i!=crtMax-1) cout<<"*";
    }
}

笔记部分

没有什么好记的，这题主要是算法上稍微绕了一下。

L1-007

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

void solve(const string& s);

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    string s;
    cin>>s;
    solve(s);
    return 0;
}

void solve(const string& s) {
    string result;
    int len = static_cast<int>(s.length());
    for (int i = 0; i<len; i++) {
        switch (s[i]) {
            case '-':
                result.append("fu");
                break;
            case '1':
                result.append("yi");
                break;
            case '2':
                result.append("er");
                break;
            case '3':
                result.append("san");
                break;
            case '4':
                result.append("si");
                break;
            case '5':
                result.append("wu");
                break;
            case '6':
                result.append("liu");
                break;
            case '7':
                result.append("qi");
                break;
            case '8':
                result.append("ba");
                break;
            case '9':
                result.append("jiu");
                break;
            case '0':
                result.append("ling");
                break;
            default:
                break;
        }
        if (i!=len-1) result.append(" ");
    }
    cout<<result;
}

笔记部分

此处用到了C++风格的强制转型static_cast<int>()，Java中的写法(int)也能用，但是那被称为C风格的强制转型。
C++中的string可以像Java的StringBuilder一样使用append方法。更进一步地，C++的字符串可以直接编辑原处，而Java的字符串由于其不可变导致只能编辑副本，这使得C++的字符串更轻一些。
也许有人会说为啥我写这么长的switch-case都不考虑直接单独处理符号再写个数组来处理0~9，究其根本，我只能说我想试试C++中的switch-case和Java中是否一致））

L1-008

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;
//Spec A 2/10 Point

void solve(int A, int B);
void handle(int num);

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int A;
    cin>>A;
    int B;
    cin>>B;
    solve(A,B);
    return 0;
}

void solve(const int A, const int B) {
    const int total = B - A + 1;
    const int time = total / 5;
    for (int i = 1; i <= time; i++) {
        for (int j = 1; j<=5; j++) handle(A+5*(i-1)+(j-1));
        cout<<"\n";
    }
    //Spec Tip Start
    if (const int rest = total % 5; rest!=0) {
        for (int j = rest - 1; j >= 0; j--) handle(B-j);
        cout<<"\n";
    }
    //Spec Tip End
    cout<<"Sum = "<<((A+B)*total/2);
}

void handle(const int num) {
    string s = to_string(num);
    const int len = static_cast<int>(s.length());
    const int lLen = 5 - len;
    for (int i = 1; i <= lLen; i++) cout<<" ";
    cout<<s;
}

笔记部分

此处的solve方法直接采用了值传递。我们可以发现，值传递时，方法参数的const与否不妨碍其声明中无需写const。声明中的引用传递的const主要是为了确保方法不会修改原来的值，而值传递的情况下修改后和原来也无所谓，所以声明中不能再写const修饰。

L1-009

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;
//Spec A 11/20 Point

pair<ll, ll> split(const string& s, char delimiter);
ll gcd(ll a, ll b);
void simplify(ll& a, ll& b);

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int N;
    cin>>N;
    ll curtNum = 0;
    ll curtDen = 1;
    for (ll i = 1; i <= N; i++) {
        string content;
        cin>>content;
        const auto [Num, Den] = split(content,'/');
        curtNum = curtNum*Den+curtDen*Num;
        curtDen *= Den;
        simplify(curtNum, curtDen);
    }
    const ll res = curtNum/curtDen;
    ll resNum = curtNum%curtDen;
    simplify(resNum,curtDen);
    if (res==0&&resNum!=0) cout<<resNum<<"/"<<curtDen;
    if (res!=0&&resNum==0) cout<<res;
    if (res!=0&&resNum!=0) cout<<res<<" "<<resNum<<"/"<<curtDen;
    if (res==0&&resNum==0) cout<<0;
    return 0;
}

pair<ll,ll> split(const string& s, const char delimiter) {
    pair<ll,ll> tokens;
    if (s.find(string(1,delimiter))!=string::npos) {
        string token;
        stringstream ss(s);
        getline(ss,token, delimiter);
        tokens.first = stoll(token);
        getline(ss, token, delimiter);
        tokens.second = stoll(token);
    } else {
        tokens.first = stoll(s);
        tokens.second = 1;
    }
    return tokens;
}

ll gcd(ll a, ll b) {
    while (b != 0) {
        a %= b;
        swap(a, b);
    }
    return a;
}

void simplify(ll& a, ll& b) {
    const ll multiplier = gcd(a,b);
    a /= multiplier;
    b /= multiplier;
}

笔记部分

我原来写的是先乘出完整的分母，再算出完整的分子，最后直接约分得到结果，但是这题有个小分值的测试点会超long long的范围，导致只能逐步约分了。
也许有人会说为什么我要连着写四个if而不用if else-if else，再或者在每个if的结构体中直接return 0;。究其根本，我只能说这是对称美）））言归正传，这确实会损失少量性能，不过我还是觉得这很美观））
本题中可能出现负数，在实际操作中求最大公约数(gcd)是可以正常处理负数的，但是返回的结果可能需要进一步的操作。因而我直接采用了绝对值计算，这会保险一些。
另记：有人可能会采用递归写法的gcd，需要补充的是，在递归深度达到1e5或1e6时，递归可能导致栈溢出(Stack Overflow)，而循环则不会出现这种问题。此外，递归涉及调用、压栈、弹栈、参数传递等CPU操作，这也使得其常数时间通常比循环要大。
C++中没有现成的split方法，需要你手动进行实现……因此，我们需要清楚getline()的具体作用：首先需要指出的是，这是getline()函数的其中一个作用，另外一个作用等到下一次见到它的时候再说。该函数有三个参数，此处我们填入的是(stringstream, string, char)。getline首先会清空string中原有的内容，而后从stringstream中逐个读取字符，一直读取到char出现时停止读取，此时会将读取到的char之前的字符串存入你提供的string中。如果不填入char，则其会默认读到行末换行（不包含换行符）。由于内容会被存入string，这使得你只能传入左值(L-Value)进去。在这种情况下，getline起到的实际上是字符分割的作用。
另记：左值(L-Value)是一个正常的变量，你可以通过变量名来访问它。右值(R-Value)是一个临时变量，你无法通过变量名来访问它（因为它不存在变量名）。比方说，to_string(num)是一个匿名返回值，你无法用一个变量名来访问它；"42"是一个字面量，你也无法用一个变量名来访问它。这些变量在所在行结束后就会被销毁，因而被算作右值(R-Value)。简单地说，你可以通过“是否有一个变量名”来快速判断左右值。

L1-010

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int A,B,C = 0;
    cin>>A;
    cin>>B;
    cin>>C;
    vector v = {A,B,C};
    sort(v.begin(), v.end());
    for (int i = 1; i <= 3; i++) {
        cout<<v[i-1];
        if (i!=3) cout<<"->";
    }
    return 0;
}

笔记部分

一个比大小的题目，可以用if-else来判断得到排序结果。这里我懒了一下，直接用数组排序了。
C++的vector和Java的ArrayList性质相似，但是在查询元素位置的时候，如果你使用vector.at(i)，其会因为越界检查而比vector[i]要更慢。

L1-001~L1-005的笔记

Wed, 21 Jan 2026 15:40:00 GMT

::github{repo="Samera2022/GPLTNotes"}

L1-001

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main(){
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    cout << "Hello World!";
    return 0;
}

笔记部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

#include属于预处理语句，在编译期会对这些语句进行复制操作。即，将目标文件的内容原封不动地剪切到本文件的这一行。第一句为导入bits/stdc++.h这个头文件，该头文件包含大量常用的#include语句，因此又被称为“万用头”。
using namespace是使用命名空间，在C++中这是为了解决命名冲突而诞生的，在Java中该操作类似于static import的效果。未使用std命名空间时，所有试图调用std的操作都需要通过std::xxx来实现，而使用后则可直接操作。
typedef是起别名，在此例中是将long long全部改名为ll，这使得你的输入更加方便。
另记：C++中int的范围和Java中int的范围一致；long long的范围和Java中long的范围一致。

    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);

ios::sync_with_stdio(false);是关闭C++输入输出流（如cin和cout）和C标准库的输入输出函数（如scanf和printf）的同步状态，这会加快输入输出速度，代价是不能再混合使用cin和scanf 以及 cout和printf，因为他们执行的顺序是不同步的。在这种情况下，建议只使用cin和cout。
cin.tie(nullptr)会取消cin与cout的绑定，进而使用cin时不再会强制刷新cout的缓冲区，进而加快输入输出速度。
cout.tie(nullptr)其实没有什么用，写上这一句大多数出于心理安慰，或者避免极少数情况下cout被意外绑定到其他输出流。
另记：有人认为nullptr空指针是AI才会写的形式，进而推荐直接写0进去。我对此持保留意见，后面的代码仍然会沿用nullptr的写法。

    cout << "Hello World!";
    return 0;

用于cout的<<是一个新的符号，可以认为将右侧的内容推送到左端去，同理用于cin的>>是将左侧的内容推送到右端去。二者属于流插入运算符，是通过重载位左/右移运算符实现的。
return 0中的0是退出状态码，也就是你在IDE下方控制台在最后经常看到的“进程已结束，退出代码为 0”的那个0。在main函数中其实可以省略，因为省略之后编译器会默认采用return 0。对于在线评测系统而言，通常要求返回值必须为0，这导致你在main中写不写返回其实没有影响。
另记：“补全return 0”的操作编译器只会在main函数，即你的入口函数(int main)进行。对于其他的非void的函数，你仍然需要手动写出所有的返回语句。 :::info 这份代码基本是以后所有代码的模板。即，之后的代码基本都会以这样的形式给出。 :::

L1-002

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

void solve(int N, char style);

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int N;
    cin >> N;
    char style;
    cin>>style;
    solve(N, style);
    return 0;
}

void solve(const int N, const char style) {
    const int time = static_cast<int>(pow(((N + 1) / 2), 0.5));
    const int rest = N - (2 * time * time - 1);
    const int max = 2 * time - 1;
    for (int i = 1; i <= time; i++) {
        for (int k = 0; k < i - 1; k++) cout << " ";
        for (int j = 1; j <= max - 2 * (i - 1); j++) cout << style;
        cout << "\n";
    }
    for (int i = 2; i <= time; i++) {
        for (int k = 0; k < time - i; k++) cout << " ";
        for (int j = 1; j <= 2 * i - 1; j++) cout << style;
        cout << "\n";
    }
    cout << rest;
}

笔记部分

C++相较于Java有一点比较独特，如果调用的方法写在下方的话，则需要在在上方先写一个声明以供链接。因此也有不少人选择将solve方法写在main函数的上面。
C++对于只有单语句的循环也可以省略大括号，这一点在Java中是没有的。
我对于所有的常量都加const修饰了，这可能会对C++比较熟练的人造成疑惑。这其实只是我为了不想看见编译器中的黄色弱警告干的）））我知道这种写法比较抽象，可能类似于IDEA中把每一个提示警告的全局的变量都上了一个final修饰一样生草，我也知道可以通过修改编译器显示警告的方案来取消显示这些警告，但是我还是觉得这么写会好一些）））
有的人换行可能会采用endl，不过我还是沿用Java的"\n"。前者会刷新输出缓冲区而后者不会，因此后者的效率也会更高一些。

L1-003

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

void solve(const string& s);

int cnt[10];

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    string s;
    cin >> s;
    solve(s);
    return 0;
}

void solve(const string& s) {
    int len = static_cast<int>(s.length());
    for (int i = 0; i < len; i++) {
        cnt[s.at(i)-'0']++;
    }
    for (int i = 0; i < 10; i++) {
        if (cnt[i]!=0) cout<<i<<":"<<cnt[i]<<"\n";
    }
}

笔记部分

int cnt[10]是C++数组的写法。在开启编译器优化时，读取和写入操作vector(C++的列表)能做到和它一样快。
另记：C++中的数组在局部可变长度，即，你可以在局部声明一个int N填入int cnt[]中，zecnt长度会随N的变化而改变。特别地，在全局你只能声明确定长度的数组。
这里用到了引用&，Java中的参数传递只有值传递，而C++中可以做到引用传递。在方法的参数列表中，在变量名旁边加&即认为是传递引用。特别地，如果传递的是引用，则需要在最上方声明时同样改为引用传递。
指针的大小为8字节，因此在可以选择值/引用传递时，对于基础类型（除long double之外），传入参数时需要使用值传递；对于引用类型，传入参数时需要使用引用传递。如果你的方法本身就需要修改原来变量的值，请继续使用引用传递。如果你的方法本身就希望修改值，但不希望修改原来变量，请继续使用值传递。
另记：常用的基础类型：bool char short int long（←不建议使用） long long float（←不建议使用） double long double。除了long double，其他所有的基础类型大小都小于等于8字节。
另记：特别地，long在Windows中为4字节，在Linux中为8字节，因此请不要使用long，改用long long（全平台均为8字节）更加稳妥。
s.at(i)-'0'是C++中char转int的方式。不要采用stoi(to_string(s.at(i)))！因为C++中的char类型本身即可作为int，这会输出它们的ASCII码。这使得后者输出的即为ASCII，而前者通过减去基准的'0'获得的相对偏移量才是数字本身。
另记：特别地，Java中的char为2字节（UTF-16），而C++中的char为1字节（Unicode），其本质为8位整数，因而C++中的char类型才可以本身即可作为int输出。

L1-004

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

void solve(int F);

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int F;
    cin>>F;
    solve(F);
    return 0;
}

void solve(const int F) {
    cout<<"Celsius = "<<5*(F-32)/9;
}

笔记部分

没有什么好记的。

L1-005

代码部分

#include <bits/stdc++.h>
using namespace std;
typedef long long ll;

int main() {
    ios::sync_with_stdio(false);
    cin.tie(nullptr);
    cout.tie(nullptr);
    int total;
    cin>>total;
    string arr[total+1];//开大一位，方便后面查询
    for (int i = 0; i < total; i++) {
        string s;
        cin>>s;
        int seat1;
        cin>>seat1;
        int seat2;
        cin>>seat2;
        arr[seat1] = s + " " + to_string(seat2);
    }
    int ask_total;
    cin>>ask_total;
    for (int i = 0; i < ask_total; i++) {
        int j;
        cin>>j;
        cout<<arr[j]<<"\n";
    }
    return 0;
}

笔记部分

没有什么好记录的，此处string[]开大一位是因为后面出现了越界，而在这里多开一位是修改量最小的方法。

AdvancedClipboard-0.2.0 Release

Fri, 16 Jan 2026 16:05:00 GMT

::github{repo="Samera2022/AdvancedClipboard"}

[2026-01-17 00:05] 0.2.0 Click here to Release </div>

[Added]

添加鼠标左键托盘图标呼出UI界面的功能。
实现回车确认UI选中项的功能。
托盘右键菜单添加“更新日志”条目。
托盘右键菜单添加“关于作者”条目。

DictionaryViewer-0.2.0 Release

Fri, 16 Jan 2026 13:48:00 GMT

::github{repo="Samera2022/DictionaryViewer"}

[2026-01-16 21:48] 0.2.0 Click here to Release </div>

[Added]

重构了 IH 和 UDL 窗体，提取了通用的 BaseDictionaryFrame 父类，统一了 UI 风格和逻辑。
实现了表格列的排序功能，支持点击表头进行降序/升序切换。
优化了文件打开逻辑，增加了对 .dat 文件类型的检查。
调整了窗体默认尺寸，优化了布局。
新增了“导出”功能，支持将词库导出为 CSV、TXT 和 JSON 格式。
新增了“另存为”功能，支持将当前词库文件另存到其他位置。
新增了“关闭”功能，支持关闭当前打开的词库。
新增了多语言支持（国际化），支持动态切换语言（zh_cn, en_us, ru_ru, jp_ja, fr_fr, es_es），并实现了界面文本的即时刷新。
新增了“其他”菜单，包含“关于作者”和“更新日志”对话框。

[Changed]

删除了最开始的词典修改支持。

IDEA完整修改项目名称的方法

Fri, 16 Jan 2026 08:18:00 GMT

修改流程

首先你需要在文件->项目结构->项目条目下，修改右侧的名称和编译器输出为新的名字。

若需要修改模块名称，则需要在文件->项目结构的项目设置->模块条目下，修改相应的信息。

之后你需要修改项目文件夹根目录的名字，可在主界面左侧的项目界面，右键最上方的模块，选择打开于->资源管理器来快捷跳转。

修改成功后可重启IDEA 或 文件->关闭项目，右键原来的项目，选择从最近的项目中移除...或直接点击右侧的×号。

:::warning 现在仍然不能直接在IDEA中打开修改后的项目文件夹，因为项目目前无法建立正确的索引。直观地来看，表现为左侧只出现.iml和.gitignore，同时无法识别其他的文件（夹）。 :::

然后在资源管理器中打开项目名称/.idea，修改modules.xml。

<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
  <component name="ProjectModuleManager">
    <modules>
      <module fileurl="file://$PROJECT_DIR$/YourProjectOldName.iml" filepath="$PROJECT_DIR$/YourProjectOldName.iml" />
      <module fileurl="file://$PROJECT_DIR$/YourProjectNewName.iml" filepath="$PROJECT_DIR$/YourProjectNewName.iml" />
    </modules>
  </component>
</project>

最后需要修改相应的构建配置。

对于maven构建的项目，需要修改pom.xml中的<artifactId>和<name>（后者决定了IDEA的Maven面板和生成文档时显示的名字）。
对于gradle构建的项目，需要修改settings.gradle或settings.gradle.kts中的rootProject.name。
对于其他方式构建的项目，需要修改相应的配置文件参数和文件->项目结构->工件的相关信息。

至此，项目的重命名就基本完成了。项目此刻应该可以正常被运行和构建。

如果你未经IDEA的重命名功能，手动重命名了包名，则需继续参考以下文章来进行修改。

IDEA手动修改包名的相应措施

常见错误

当你看到IDEA提示Git Repositories Found: The directory [旧路径] is registered as a Git root, but no Git repository was found there.时，这表明你需要更新IDEA中的Git映射。

具体地，你需要在文件->设置->版本控制->目录映射中点击-删除旧路径，并点击+添加新路径。建议启用下方的启用自动映射检测，这会节省一些功夫。

IDEA手动修改包名的相应措施

Fri, 16 Jan 2026 08:18:00 GMT

本文主要讨论未经IDEA的重命名功能情况下，手动修改包名所需要修改的构建文件的位置。

对于maven构建的项目，需要修改pom.xml中的<groupId>和下列代码段（如有）

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <version>3.2.0</version>
    <configuration>
        <archive>
            <manifest>
                <mainClass>com.oldname.Main</mainClass> 
                <mainClass>com.newname.Main</mainClass> 
                <addDefaultImplementationEntries>true</addDefaultImplementationEntries>
            </manifest>
        </archive>
    </configuration>
</plugin>

对于gradle构建的项目，需要修改build.gradle中的group和下列代码段（如有）

application {
    mainClass = 'com.oldname.Main' 
    mainClass = 'com.newname.Main' 
}

如果你手动配置了jar任务，则需修改下列代码段

jar {
    manifest {
        attributes(
            'Main-Class': 'com.oldname.Main' 
            'Main-Class': 'com.newname.Main' 
        )
    }
}

对于其他方式构建的项目，需要修改MANIFEST.MF中的Main-Class。

DictionaryViewer-0.1.0 Release

Thu, 15 Jan 2026 15:53:00 GMT

::github{repo="Samera2022/DictionaryViewer"}

[2026-01-15 23:53] 0.1.0 Click here to Release </div>

[Added]

实现了对微软拼音输入法二进制文件的解析逻辑
创建了基础的 Swing 窗体 (IHMainFrame, UDLMainFrame) 以可视化二进制数据。
实现了对词条的实时关键词过滤功能。
添加了从 Windows %APPDATA% 目录自动定位并加载词典文件的逻辑。
数据显示支持: IH显示“词语”和“词频” ; UDL显示“词条”和“类型”（用户定义/系统学习）。
添加初步的词典修改支持。

AdvancedClipboard-0.0.1 Release

Thu, 15 Jan 2026 07:30:00 GMT

::github{repo="Samera2022/AdvancedClipboard"}

[2026-01-15 15:30] 0.0.1 Click here to Release </div>

[Added]

实现剪贴板历史记录功能 (文本和图片)。
实现系统托盘图标及退出菜单。
实现全局热键 (Ctrl+Up/Down) 弹出历史窗口。
实现从历史窗口选择并恢复到剪贴板的功能。

UnusualChineseChess-2.0.1 Release

Wed, 14 Jan 2026 12:42:00 GMT

::github{repo="Samera2022/UnusualChineseChess"}

[2026-01-14 20:42] 2.0.1 Click here to Release </div>

[Fixed]

修复残局导入的异常。
修复玩家胜利的判断逻辑。
修复正常移动到己方底线的“允许己方底线底线晋升”的棋子转换。

[Warn]

“堆叠棋子”被发现具有很多潜在的问题，但目前尚无法被解决。

UnusualChineseChess-2.0.0 Release

Wed, 14 Jan 2026 06:10:00 GMT

::github{repo="Samera2022/UnusualChineseChess"}

[2026-01-14 14:10] 2.0.0 Click here to Release </div>

[Added]

恢复了先前版本中的“显示提示”勾选框。
将“强制走子”纳入玩法的可选项。

[Changed]

大规模重构底层结构，重点重构了“玩法创建”的相关逻辑。新版本的玩法注册逻辑可参照docs/如何创建新玩法(2.X.X)。
修改了相关玩法的注册名，这使得无法同1.X.X版本的带有玩法的联机进行兼容（1.3.0版本除外）。注：玩法注册名的修改是从1.3.0开始的，这使得1.3.0无法同前面版本进行带有玩法的联机兼容。

UnusualChineseChess-1.3.0 Release

Mon, 12 Jan 2026 16:51:00 GMT

::github{repo="Samera2022/UnusualChineseChess"}

[2026-01-13 00:51] 1.3.0 Click here to Release </div>

[Added]

添加断网重连支持。当其中一方掉线后，其按照地址重新加入即可继续原先的对局！
增加主机切换持方的支持。在对局过程中，主机方可以任意修改自己和对方的持方了！
增加“强制走子”和联机时的“规则改变”到“着法记录”中。现在上述的两个内容将会在客户端和服务端的“着法记录”中显示，并可正常导出到残局中。

[Fixed]

修复联机与本地环境下鼠标左键对于双方“堆叠棋子”的行为。

UnusualChineseChess-1.2.0 Release

Sat, 10 Jan 2026 11:25:00 GMT

::github{repo="Samera2022/UnusualChineseChess"}

[2026-01-10 19:25] 1.2.0 Click here to Release </div>

[Added]

添加“取消对将”的玩法。
添加“死战方休”的玩法。
统一并强化玩法配置管理：全面使用 GameRulesConfig 作为规则单一数据源，减少了模块间耦合。
运行时差分同步：主机修改玩法设置时仅发送发生改动的字段（diff），并在客户端合并应用。
在 UI 端对设置变更做 200ms 去抖合并，减少网络抖动。
增加规则变更监听（支持变更来源），通知执行带超时（500ms）与错误日志，提升稳定性与可调试性。

[Changed]

移除了大量对 GameEngine 的冗余包装 getter，调用方改为直接访问 GameRulesConfig 的 getBoolean/getInt/toJson 接口。
RuleSettingsPanel 的绑定逻辑改为直接读写 GameRulesConfig，并在本地 UI 变更时标记变更来源为 UI。
GameEngine.shutdown() 集成了规则通知器的关闭（集中化资源清理）。
精简版本与更新信息的调用：将对 UpdateInfo 的全限定调用替换为直接导入后使用，简化了网络握手与 UI 显示逻辑的代码可读性。

[Fixed]

补充“对将”这一“将”的移动方式。
修正“帥”和“兵”在左右连通中的表现。
修复局域网对局中“撤销”按钮，现在其可以在联机中正常使用了。
修复堆叠棋子的移动验证逻辑，现在选择不同堆栈层的棋子会正确使用对应棋子的移动规则。
修复“允许背负上方棋子”选项，现在未勾选时选择下方棋子移动不会带走上方棋子。
修复残局导入导出功能，现在可以正确保存和恢复堆叠棋子的状态。
修复点击对方堆叠棋子时的交互，现在会显示堆叠信息对话框。
修复/缓解了规则通知过程中异常被吞掉或阻塞的问题（现在会记录关键错误并对超时 listener 进行取消）。
修复联机设置同步与撤销相关的问题，主机端现在会发送设置快照/差分并避免回环。

UnusualChineseChess-1.2.0-26m01c Release

Sat, 10 Jan 2026 07:11:00 GMT

::github{repo="Samera2022/UnusualChineseChess"}

[2026-01-10 15:11] 1.2.0-26m01c Click here to Release </div>

[Added]

添加“取消对将”的玩法。
添加“死战方休”的玩法。

[Fixed]

补充“对将”这一“将”的移动方式。
修正“帥”和“兵”在左右连通中的表现。
修复局域网对局中“撤销”按钮，现在其可以在联机中正常使用了。
修复堆叠棋子的移动验证逻辑，现在选择不同堆栈层的棋子会正确使用对应棋子的移动规则。
修复“允许背负上方棋子”选项，现在未勾选时选择下方棋子移动不会带走上方棋子。
修复残局导入导出功能，现在可以正确保存和恢复堆叠棋子的状态。
修复点击对方堆叠棋子时的交互，现在会显示堆叠信息对话框。

UnusualChineseChess-1.1.0 Release

Fri, 09 Jan 2026 13:26:00 GMT

::github{repo="Samera2022/UnusualChineseChess"}

[2026-01-09 21:26] 1.1.0 Click here to Release </div>

[Added]

添加了更多的神奇玩法！
添加“更新日志”和“关于作者”的按钮。
添加本地翻转棋盘的功能。
新增: “堆叠棋子”玩法(实验性玩法)，你现在可以将己方棋子堆叠到集中的某个位置了！

[Changed]

大幅修改项目逻辑以降低项目的耦合度，改为采用GameEngine<-GameRulesConfig->MoveValidator进行各项配置的维护。
由于“堆叠棋子”玩法，你现在可能需要使用左键来选择棋子，右键来进行棋子移动了。

[Fixed]

修复“左右连通”的逻辑，它现在应该能够兼容其他模式了。
修复局域网持方的问题，现在局域网能够正常进行对局了！

[Warn]

“堆叠棋子”目前仍然存在一些bug，并未完成。

UnusualChineseChess-1.1.0-26m01b Release

Fri, 09 Jan 2026 09:42:00 GMT

::github{repo="Samera2022/UnusualChineseChess"}

[2026-01-09 17:42] 1.1.0-26m01b Click here to Release </div>

[Added]

新增: “堆叠棋子”玩法，你现在可以将己方棋子堆叠到集中的某个位置了！

[Changed]

大幅修改项目逻辑以降低项目的耦合度，改为采用GameEngine<-GameRulesConfig->MoveValidator进行各项配置的维护。
由于“堆叠棋子”玩法，你现在可能需要使用左键来选择棋子，右键来进行棋子移动了。

[Fixed]

修复“左右连通”的逻辑，它现在应该能够兼容其他模式了。

[Warn]

局域网的持方功能目前仍然存在一些问题，不建议本地主机选择持黑方。
“堆叠棋子”目前仍然存在一些bug，并未完成。

UnusualChineseChess-1.1.0-26m01a Release

Wed, 07 Jan 2026 11:33:00 GMT

::github{repo="Samera2022/UnusualChineseChess"}

[2026-01-07 19:33] 1.1.0-26m01a Click here to Release </div>

[Added]

添加了更多的神奇玩法！
添加“更新日志”和“关于作者”的按钮。
添加本地翻转棋盘的功能。

[Warn]

局域网的持方功能存在一点问题，不建议本地主机选择持黑方。
“左右连通”功能目前和其他玩法可能存在不适配。放心，这不会造成崩溃，只是有些其他玩法的棋子无法做到左右连通的效果。

UnusualChineseChess-1.0.0 Release

Wed, 07 Jan 2026 07:37:00 GMT

::github{repo="Samera2022/UnusualChineseChess"}

[2026-01-07 15:37] 1.0.0 Click here to Release </div>

[Added]

添加了完整的残局功能！你现在可以导出和导入残局了！
添加了局域网对战功能！你现在可以邀请不同玩家来一起玩象棋了！
添加“玩法”功能，你可以打破传统中国象棋中的一些规则，体验更加独特的中国象棋了！

UnusualChineseChess-0.2.0 Release

Tue, 06 Jan 2026 16:18:00 GMT

::github{repo="Samera2022/UnusualChineseChess"}

[2026-01-07 00:18] 0.2.0 Click here to Release </div>

[Added]

美化了象棋棋盘和整体UI布局。

UnusualChineseChess-0.1.0 Release

Tue, 06 Jan 2026 15:54:00 GMT

::github{repo="Samera2022/UnusualChineseChess"}

[2026-01-06 23:54] 0.1.0 Click here to Release </div>

[Added]

支持进行基本的象棋游玩。

MouseMacros-1.2.2 Release

Mon, 05 Jan 2026 13:59:00 GMT

::github{repo="Samera2022/MouseMacros"}

[2026-01-05 21:59] 1.2.2 Click here to Release </div>

[Fixed]

删除了AboutDialog中未被使用的tooltip。

About MouseMacros

Sun, 04 Jan 2026 16:00:00 GMT

::github{repo="Samera2022/MouseMacros"}

你好，这里是Projects/MouseMacros。欢迎收听About MouseMacros，我是主持人Samera2022。今天我们就来聊一聊MouseMacros的一些简单介绍，以及我为什么要开发MouseMacros这个项目。

Why `MouseMacros` is a better choice?

如果你打开github搜索mouse-recorder,auto-clicker,mouse-macro等词条，或者打开google搜索Mouse Macros的话，你很可能会见到雪花般的鼠标宏项目。但是，让我们变得实际一点，这里面的很多项目其实并不适合用户使用。 :::note 首先我想向下文提到的开源作者们致敬，尽管他们的项目可能存在一些问题，但是他们践行了宝贵的开源精神！此外，需要注意的是，我对他们项目的看法也可能并不正确。如果您有别的见解，欢迎来联系我，我们可以进行更加深入的讨论。 ::: :::note 抱歉，我可能会引用别人的仓库。如果您是仓库的作者，并且不希望您的仓库出现在这里，请联系我，我会立刻撤下。 ::: 不妨让我们简单地举出一些例子：

↓该项目不具有Releases，其初衷并非服务用户，这只是自己的开发备份。 ::github{repo="jborza/mouse-macros"} ↓该项目具有Releases，但是相关功能和GUI均比较简陋。 ::github{repo="n43e120/MouseMacro"} ↓该项目具有Releases和较为美观的GUI，但是相关功能较少。 ::github{repo="guinhx/ActionRecorder"} ↓该项目具有Releases，美观的GUI与（和前者相比）比较多的功能，但是文件包过大。 ::github{repo="p6laris/SnapClicker"} :::note 就最后一个项目而言，它的总体功能数比MouseMacros要少很多，但是其文件包大小基本为MouseMacros的两倍。这是我评价其文件包过大的依据。 ::: 这些事情不止发生在这些项目，甚至可以说，你看到的很多项目（包括github以外的，有些甚至还有可能是付费的）很可能都有以上的弊端。而MouseMacros则在功能多-臃肿中取得了一个恰当的平衡。首先MouseMacros是免费的开源项目，其诞生的初衷就是为了服务用户，让用户以一种Straight-forward的方式快捷地享受鼠标宏所带来的便利。因此，常用的功能，我选择直接放在MainFrame中。对于需求简单的用户直接点击“开始”和“结束”就可以了。

而对于要求略高的用户，他们可以选择在SettingsDialog和MacroSettingsDialog中进行更进一步的个性化设置，我也将一些比较常用的功能内置在了这两个设置窗体中。而对于一些“窗体大小”、“关闭方式”、“历史保存地址”等并不那么直接，但又切实显著地影响到使用体验的功能，我选择直接放在cache.json中，由程序自动配置，进而降低用户的信息熵与决策成本。

制作一个鼠标宏是快速的，但是制作一个好用的鼠标宏却并非轻松。制作一个用户友好的鼠标宏则需要更加多的时间投入和精力投入以进行打磨。

Why I chose to develop `MouseMacros`?

这在其他地方没有提到，但我是一个P社Paradox玩家。具体地说，我主要游玩群星Stellaris，并且偏向于其中的一个神奇的流派——智能机械格式塔扩张流派——或者更简单地说，塔械爆铺流。我在里面需要手动操作上百个球，这并非夸张。在我的一个千星存档中，我甚至需要直接操作230个殖民地！这听起来很吓人，实际上也确实是的。不过这么多殖民地也为我带来了巨大的资源收益。言归正传，我对于每种资源都有特定的产出专精模式。用另一种话说，这两百多个殖民地其实共用了相同的几个建筑的模板。而我想要建设这些殖民地，这意味着我需要整整操作230次。当我在漫长的游戏时间中真的完成了这一项工作，我觉得这是非常令人疲劳的。因此我寻找是否有这样一种方便轻松的方式，能够替代我执行相同的动作。

第一时间，我想到了宏鼠标。这是一种昂贵的鼠标，在生产时就预置了鼠标宏的功能。我不想额外花费金钱，因此我选择去互联网寻找功能相似的软件。不幸的是，我在简体中文互联网上寻找到的软件大多具有广告，或者需要付费（不是买断制，是定期订阅）。我又在除简体中文互联网以外的地方寻找，发现情况稍微好些，至少它们的GUI看起来更加现代化，但是仍然存在高昂买断价格的问题。而对于那些免费的软件，他们的功能过于简单，不足以满足我的需求。同时，他们简陋的发布网页和非常简陋GUI界面（注：现代化的GUI是针对昂贵的买断软件而言的），以及他们所在的不知名的小网站，使我害怕我的电脑感染恶意软件。

究其根本，最关键的问题在于免费的软件各个方面都过于简陋以至于我不敢贸然使用而看起来不错的软件价格高昂。更进一步地，当时我在github上并没有发现很多功能相似的仓库，即便有，也几乎没有给出能直接使用的Releases。（后来被证实，这是因为那些仓库用了诸如auto-clicker等其他的标签和名字，以至于我完全没有检索到。）然而，我认为制作一个鼠标宏在技术上是比较清晰的。因此我对于这个现象感到困惑，所以决定尝试自己开发一款MouseMacros的软件，想看看这到底有多困难。事实证明，这相对地是比较轻松的一个工作。好吧，至少和我修改这个基于Astro的网页相比，这个还是较为轻松的。最开始我只是想着自己使用，也没有怎么考虑用户交互的事情。后来考虑到我也从开源社区中下载了很多软件，同时维护这个项目可以使我收获经验，所以我决定顺手将开发的成果贡献回开源社区。这也是我在推出1.0.0后仍然积极维护并推出了很多Releases的原因。

End

MouseMacros花费了我很多的心血，如果这确实帮到您的话，还请您不要吝啬手中的Star，为我点亮那颗星吧。 ::github{repo="Samera2022/MouseMacros"}

MouseMacros Readme

Sun, 04 Jan 2026 16:00:00 GMT

::github{repo="Samera2022/MouseMacros"}

MouseMacros

<p align="center"> <img src="https://raw.githubusercontent.com/Samera2022/MouseMacros/main/docs/images/MouseMacrosIcon.png" alt="MouseMacros Logo" width="120"> <b>A lightweight, cross-platform Java tool for recording and replaying mouse and keyboard macros.</b> <br> </p>

Preview

<p align="center"> <img src="https://raw.githubusercontent.com/Samera2022/MouseMacros/main/docs/images/MouseMacrosMainFrame.png" width="400" alt="Main Interface"> <sub style="font-size: 14px;"><i>The main interface of MouseMacros.</i></sub> </p>

Features

Comprehensive Recording: Capture Mouse Left/Right/Middle clicks, Scroll Wheel movements, and Keyboard inputs seamlessly.
Global Hotkeys: Control the application even when it's minimized. Fully customizable keys for:
- Start/Stop Recording
- Play Macro
- Abort Operation (Emergency stop for runaway macros)
Multi-Language Support: Built-in localization for English (US) and Simplified Chinese, other supported languages includes Japanese, Russian, Korean, Spanish and French.
Theme Engine: Supports Light and Dark modes, with an option to follow system settings automatically.
Persistence: Macros are saved as .mmc (CSV-formatted) files, allowing for easy sharing and manual editing.
Smart Memory: Remembers window sizes, last-used directories, and custom configurations across sessions.
Floating Tooltip: Shows helpful instructions and tips near the cursor for easier operation.

Getting Started

Quick Launch

I. Jar User

Make sure that you have installed JRE 1.8 or above. If not, you can download HERE.
Download the latest .jar file from the Releases page.
Double-click the jar file OR use cmd to run the application:
```
java -jar MouseMacros.jar
```

II. Exe User

Download the latest .exe file from the Releases page.
Click to start! All environments are integrated into one exe file!

Usage

Adjust: The choose of language will determine the words in the frame, thus resulting in some buttons not being displayed in the frame. In this case, you will need to adjust the frame to the appropriate size.
Configure: Open the Settings dialog and Macros Settings dialog to set your preferred hotkeys. For detailed configuration docs, please refer to Configuration.
Record: Press your "Start Recording" hotkey or press this button in the frame and perform the actions.
Save: Use "Save Macros" to export your recording to a .mmc file.
Replay: Use "Load Macro" to load a .mmc file and press "Play Macro".

Configuration

The application stores settings in the user's AppData directory: %USERPROFILE%/AppData/MouseMacros/

File	Description
`config.cfg`	Stores UI language, theme mode, key mappings, and default storage path.
`cache.json`	Stores recent file paths and window dimensions.

Settings Dialog Options

Name	Key	Description
Follow System Settings	`followSystemSettings`(boolean)	Controls whether to follow System default settings or not.
Switch Language	`lang`(String)	If `followSystemSettings` is false, you can use this combo box to choose another display language.
Enable Dark Mode	`enableDarkMode`(boolean)	If `followSystemSettings` is false, you can use this check box to choose whether to enable Dark Mode.
Enable Default Storage	`enableDefaultStorage`(boolean)	Controls whether to enable `defaultMmcStoragePath`. If it is true, the `lastSaveDirectory` and `lastLoadDirectory` in cache.json will be ignored. Every time you open the FileChooserDialog(in "Save Macro" and "Load Macro"), it will automatically open the folder with `defaultMmcStoragePath`. The same applies in reverse.
Default MouseMacros Storage Path	`defaultMmcStoragePath`(String)	If `followSystemSettings` is true, it will determine the default folder everytime you open the FileChooserDialog(in "Save Macro" and "Load Macro"). If the folder in this option doesn't exist, the app will first attempt to create this folder, otherwise it will automatically open the default folder(Your User Document Folder).
Enable Quick Mode	`enableQuickMode`(boolean)	Controls whether to enable no-delay mode. In this mode, MouseMacros will ignore the waiting time between each mouse/keyboard action. It is DANGEROUS, and it is STRONGLY ADVISED to set a proper Abort Operation Hotkey and the Repeat Delay in Macro Settings Dialog before you enable this mode.
Allow Long Tooltip	`allowLongStr`(boolean)	Controls whether to enable LongTooltip Display. If false, MouseMacros will display all tooltips in a given width, otherwise MouseMacros will attempt to display them in a long line unless exceeding the frame (if so, it will wrap lines and display it in two or more long lines).
Readjust Frame Mode	`readjustFrameMode`(String)	Controls the mode to display the window at a 3:2 ratio when there is no cache. If a cache exists, after changing the language, MouseMacros can choose among the three modes from the previous step when processing 'historical window size' and 'recommended window size'. You will get more detailed information in tooltip.

Macro Settings Dialog Options

Name	Key	Description
Enable Custom Macro Settings	`enableCustomMacroSettings`(boolean)	Controls whether to enable custom macro settings.
Execution Repeat Times	`repeatTime`(int)	If `enableCustomMacroSettings` is true, MouseMacros will automatically repeat your Macro at the given times.
Repeat Delay (s)	`repeatDelay`(double)	If `enableCustomMacroSettings` is true, MouseMacros will postpone given time before the next execution. Supports three decimal places(to millisecond) at most.

Development Document

Detailed docs generated by DeepWiki is presented HERE. Notably, it may be outdated, since it was manually compiled by the author from DeepWiki.

For more up-to-date documents, you can refer to Samera2022/MouseMacros | DeepWiki or just click the badge at the top of the article. The website weekly updates this project's docs and provides a "Refresh this wiki" with "Enter email to refresh" button to force update the docs if it hasn't indexed yet.

Others

Contributing

Contributions are welcome! If you find a bug or have a feature request, please open an issue.

Author

Developer: Samera2022

GitHub: @Samera2022

License

This project is licensed under the GNU General Public License v3.0 License - see the LICENSE file for details.

MouseMacros-1.2.1 Release

Sun, 04 Jan 2026 07:45:00 GMT

::github{repo="Samera2022/MouseMacros"}

[2026-01-01 17:15] 1.2.1 Click here to Release </div>

[Fixed]

修正了ExitDialog的退出逻辑，使得不选单选框直接点结束时会直接销毁ExitDialog窗体。
修正打包逻辑，1.2.0的打包结果实际上是1.2.0-26m01a的结果）））

MouseMacros-1.2.0 Release

Fri, 02 Jan 2026 11:03:00 GMT

::github{repo="Samera2022/MouseMacros"}

[2026-01-02 19:03] 1.2.0 Click here to Release </div>

[Added]

为AboutDialog添加了Github跳转按钮。
为SettingsDialog添加了readjustFrameMode选项。
添加“建议窗体大小”功能。MouseMacros会在无cache的情况下尝试采用3:2的比例展示窗体。如果存在cache，那么在修改语言后MouseMacros处理“历史窗体大小”和“建议窗体大小”的过程中可以选择上一条中的三种模式。

[Changed]

修正了打包逻辑，在该版本之前打包的exe应当全部改名为MouseMacros.exe才能正常运行。
修改exe的文件名会导致无法找到启动文件……因此不建议修改发布时的程序名。
修改了SettingsDialog的主界面，使其更加有条理。

MouseMacros-1.2.0-26m01a Release

Thu, 01 Jan 2026 09:15:00 GMT

::github{repo="Samera2022/MouseMacros"}

[2026-01-01 17:15] 1.2.0-26m01a Click here to Release </div>

[Added]

为AboutDialog添加了Github跳转按钮。

[Changed]

修正了打包逻辑，在该版本之前打包的exe应当全部改名为MouseMacros.exe才能正常运行。
修改exe的文件名会导致无法找到启动文件……因此不建议修改发布时的程序名。

MouseMacros-1.1.0 Release

Thu, 01 Jan 2026 04:52:00 GMT

::github{repo="Samera2022/MouseMacros"}

[2026-01-01 12:52] 1.1.0 Click here to Release </div>

[Info]

从此版本开始，将严格按照语义化版本（SemVer）重新编写版号。
在以往版本中，通常采用第三位表示小功能更新，第二位表示重构更新，第一位表示重大更新。现在将采用第三位表示修订更新，第二位表示次版本更新，第一位表示主版本更新。

[Fixed]

修复了1.0.4中的Tooltip长文本显示相关逻辑，使之更加准确地生效。

MouseMacros-1.0.4 Release

Wed, 31 Dec 2025 16:00:00 GMT

::github{repo="Samera2022/MouseMacros"}

[2026-01-01 00:00] 1.0.4 Click here to Release </div>

这是2026年新年的第一个release呢

[Added]

添加了鼠标悬浮窗显示信息。

[Changed]

修改了CacheManager的逻辑，使之和ConfigManager保持一致。

MouseMacros-1.0.3 Release

Wed, 31 Dec 2025 07:45:00 GMT

::github{repo="Samera2022/MouseMacros"}

[2025-12-31 15:45] 1.0.3 Click here to Release </div>

这是2025年的最后一个release了呢

[Added]

给每个窗体都添加上了压缩后的图标，使得程序窗体和任务栏图标不再使用Java的默认图标了。
添加“最小化到系统托盘”的功能，在主窗体(MainFrame)关闭后会自动最小化到系统托盘。
支持了更多的语言，包括西班牙语、法语、日语、韩语、俄语。

[Changed]

修改了语言文件的部分键格式，使之条理更加清晰。

[Fixed]

修正了Abort Operation的效果，使之可以在循环执行中正确地生效。

MouseMacros-1.0.2 Release

Sun, 28 Dec 2025 08:52:00 GMT

::github{repo="Samera2022/MouseMacros"}

[2025-12-28 16:52] 1.0.2 Click here to Release </div>

[Added]

在SettingsDialog添加了QuickMode，现在MouseMacros可以无视鼠标键盘的等待时间，快速执行了。
在MacroSettingsDialog的Enable Custom Macro Settings条目下添加了Execution Repeat Delay (s)，可以在每次重复的执行之中等待指定的秒数。秒数最大支持三位小数（到毫秒）。

[Fixed]

1.0.0中不小心删除了Macro Settings的保存设置按钮，这次重新添加了进去。

MouseMacros-1.0.1 Release

Sat, 27 Dec 2025 15:16:00 GMT

::github{repo="Samera2022/MouseMacros"}

[2025-12-27 23:16] 1.0.1 Click here to Release </div>

[Added]

将窗体大小添加进cache.json，现在MouseMacros将能记忆你的每个窗体的大小。
为Settings添加enable_default_storage的按钮，具体逻辑详见Description。
配置了一键打包的脚本，现在的Release将会提供exe版本的程序下载。
为settings.custom_hotkey界面的TextField添加了鼠标焦点提示。
引入DeepWiki的docs来辅助代码理解。

[Changed]

修改为更加细致的README.md。
文件结构略有修改，主要是lang文件移动到src下。

[Description]

当enable_default_storage为true时，在loadMacros和saveMacros时均只会采用config中的default_mmc_storage_path。且在FileChooser窗体中找到其他目录保存并不会修改cache.json中的lastSaveDirectory和lastLoadDirectory。
当enable_default_storage为false时，在loadMacros和saveMacros时均只会采用cache.json中的lastSaveDirectory和lastLoadDirectory。当二者均为空时为默认目录，当二者其中一者为空时，在选择好文件夹（关闭FileChooser）后会默认将有值的数据复制到空的那一者。

[Fixed]

修复了1.0.0中settings.custom_hotkey的异常。

[To-do]

可能考虑切换UIManager的样式，当前的Metal样式较为简陋且缺乏较多的属性，可能会考虑切换至Nimbus、System或者第三方的FlatLightLaf。

[Note]

源代码大概其实只有1MB左右的大小，但是带上精简的运行环境就需要34.2MB了……
有人可能会说，为什么1.0.0的软件包要2.84MB，而这一次的只要1.05MB了呢？是不是压缩水平提升了？啊其实不是啊，是因为我之前不小心把项目的根目录放进源代码目录里面了……在我编写EVB和Jpackage打包的时候才发现这一点，然后才改过来。

MouseMacros-1.0.0 Release

Wed, 09 Jul 2025 13:31:00 GMT

::github{repo="Samera2022/MouseMacros"}

[2025-07-09 21:31] 1.0.0 Click here to Release </div>

[Added]

添加对鼠标中键，鼠标滚轮和键盘的支持
区分了鼠标左键右键和中键
添加自定义宏设置
添加中止宏按键功能
添加保留上次存储/读取鼠标宏路径的功能

[Warn]

在创建settings.custom_hotkey界面后，不点击任何对话框直接按键盘，将会直接改动start_record的按键设置。
JFileChooser的界面无法应用暗色模式……要重写这个类实在太费劲了。

MouseMacros-0.1.0 Release

Tue, 08 Jul 2025 07:08:00 GMT

::github{repo="Samera2022/MouseMacros"}

[2025-07-08 15:08] 0.1.0 Click here to Release </div>

[Added]

实装配置文件的keyMap

[Changed]

重构项目整体结构，降低代码耦合度

MouseMacros-0.0.2 Release

Sun, 06 Jul 2025 14:51:00 GMT

::github{repo="Samera2022/MouseMacros"}

[2025-07-06 22:51] 0.0.2 Click here to Release </div>

[Added]

添加配置文件功能
添加设置界面
添加"关于作者"功能按钮
添加"更新日志"功能按钮

[Changed]

将自定义热键功能移入"设置"界面

[Detailed]

关于配置文件功能

目前已添加以下可配置项： (boolean)跟随系统设置，(boolean)启用深色模式，(String)切换语言，(String)默认鼠标宏存储地址，未实装，不可用按键映射表，注意："跟随系统设置"与("启用深色模式", "切换语言")存在上位关系。如果选择了"跟随系统设置"，那么后二者就不再接受用户更改，直接读取系统的相应设置。

MouseMacros-0.0.1 Release

Sat, 05 Jul 2025 12:20:00 GMT

::github{repo="Samera2022/MouseMacros"}

[2025-07-05 20:20] 0.0.1 Click here to Release </div>

[Added]

添加开始/停止录制鼠标宏功能
添加保存/读取鼠标宏功能
添加自定义热键功能
添加本地化支持
添加自适应窗体（随按钮长度与系统缩放设置而改变）