mcc-compiler 1.0.0

package/bin/mcc

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require('../src/index.js');

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "mcc-compiler",
+  "version": "1.0.0",
+  "description": "Majo C Compiler - 一个有教养的编译器，必须说 --please 才会编译",
+  "main": "src/index.js",
+  "bin": {
+    "mcc": "bin/mcc"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "preuninstall": "node scripts/preuninstall.js"
+  },
+  "keywords": [
+    "compiler",
+    "gcc",
+    "wrapper",
+    "majo",
+    "fun"
+  ],
+  "author": "0x1a27",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "scripts/",
+    "README.md"
+  ]
+}

package/readme.md

@@ -0,0 +1,150 @@
+# mcc — Majo C Compiler
+
+一个有教养的编译器。只有你说"请"的时候，她才会帮你编译。
+
+> ⚠️ **安全提示：请务必阅读！**
+> 本软件在安装时会将 `/usr/bin/gcc` 替换为指向 `mcc` 的软链接，原 `gcc` 会被备份到 `/usr/bin/gcc.real`。
+> 请确保您已了解此行为，并在安装前备份您的系统。
+
+
+## ⚠️ 安全风险说明
+
+### 这是什么？
+
+`mcc` 会在安装时自动执行以下操作：
+
+1. 将 `/usr/bin/gcc` 替换为指向 `mcc` 的软链接
+2. 原 `gcc` 会被重命名为 `/usr/bin/gcc.real`（如果存在）
+
+这意味着：**你输入 `gcc` 时，实际上运行的是 `mcc`，而不是真正的 `gcc`。**
+
+### 潜在风险
+
+| 风险 | 影响 | 缓解措施 |
+|---|---|---|
+| **编译脚本失效** | 脚本中硬编码的 `gcc` 命令会触发吃醋报错，导致编译失败 | 使用 `mcc --please --gcc` 临时调用真正的 gcc |
+| **自动化构建中断** | CI/CD、Makefile、npm install 等依赖 `gcc` 的流程可能中断 | 在脚本中使用 `gcc.real` 替代 `gcc` |
+| **系统恢复困难** | 如果卸载不当，可能导致 `gcc` 命令丢失 | 使用 `npm uninstall` 会自动恢复；或手动恢复：`sudo rm /usr/bin/gcc && sudo mv /usr/bin/gcc.real /usr/bin/gcc` |
+| **其他软件依赖** | 部分软件在安装时会调用 `gcc` 进行编译，可能失败 | 临时使用 `gcc.real` 或提前恢复 |
+
+### 谁不应该使用这个包？
+
+- ❌ 在生产环境使用
+- ❌ 在需要稳定编译的服务器上使用
+- ❌ 在无法处理编译失败的 CI/CD 流程中使用
+- ❌ 在没有 root/sudo 权限的环境中使用
+- ❌ 在不了解软链接含义的情况下使用
+
+### 谁应该使用？
+
+- ✅ 个人开发环境（WSL / Linux 桌面）
+- ✅ 想体验"编译器吃醋"的整活场景
+- ✅ 能接受编译失败并手动恢复的用户
+
+### 如何安全使用？
+
+```bash
+# 当需要真正使用 gcc 时，用这个命令：
+mcc --please --gcc hello.c
+
+# 或者直接调用备份的原 gcc：
+gcc.real hello.c
+
+# 或者临时解除劫持：
+sudo rm /usr/bin/gcc
+sudo mv /usr/bin/gcc.real /usr/bin/gcc
+# 使用完后重新劫持：
+sudo npm install -g mcc-compiler  # 会重新创建软链接
+
+安装
+bash
+# ⚠️ 需要 sudo 权限（因为要修改 /usr/bin/gcc）
+sudo npm install -g mcc-compiler
+安装时会自动：
+
+✅ 在 /usr/bin/gcc 创建指向 mcc 的软链接
+
+✅ 原 gcc 备份到 /usr/bin/gcc.real
+
+用法
+bash
+# ❌ 没礼貌 → 吃醋报错
+gcc hello.c
+
+# ❌ 没礼貌 → 报错（mcc 直接调用）
+mcc hello.c
+
+# ✅ 有礼貌 → 编译成功
+mcc --please hello.c
+
+# ✅ 所有 gcc 参数都支持
+mcc --please -Wall -O2 -o hello hello.c
+
+# ✅ 彩蛋：让她更开心
+mcc --please --sama hello.c
+mcc --please --sensei hello.c
+
+# ✅ 临时放行到真正的 gcc
+mcc --please --gcc hello.c
+规则
+命令	结果
+gcc hello.c	❌ 吃醋报错
+mcc hello.c	❌ 没礼貌报错
+mcc --please hello.c	✅ 编译成功
+mcc --please --sama hello.c	❤️ 额外加心情
+mcc --please --sensei hello.c	📚 额外加心情
+mcc --please --gcc hello.c	✅ 放行给真正的 gcc
+卸载
+bash
+npm uninstall -g mcc-compiler
+卸载时会自动：
+
+✅ 移除 /usr/bin/gcc 软链接
+
+✅ 从 /usr/bin/gcc.real 恢复原 gcc
+
+手动恢复
+如果卸载时未自动恢复，或你想手动恢复：
+
+bash
+sudo rm /usr/bin/gcc
+sudo mv /usr/bin/gcc.real /usr/bin/gcc
+如果备份文件不存在：
+
+bash
+# 用包管理器重新安装 gcc
+# Ubuntu / Debian / WSL:
+sudo apt update
+sudo apt install --reinstall gcc
+
+# 或者从 /usr/bin/gcc.real 恢复（如果存在）
+配置
+bash
+# 设置初始心情值（0-100）
+echo "mood=50" > ~/.mccrc
+常见问题
+Q: 安装后 gcc 命令失效了怎么办？
+
+A: 运行 sudo rm /usr/bin/gcc && sudo mv /usr/bin/gcc.real /usr/bin/gcc 恢复。然后考虑是否真的想使用这个包。
+
+Q: Makefile 编译失败怎么办？
+
+A: 把 Makefile 中的 gcc 改成 gcc.real，或者使用 mcc --please --gcc。
+
+Q: 我不想劫持 gcc，只想用 mcc 命令怎么办？
+
+A: 安装后手动删除软链接恢复 gcc，只用 mcc --please 命令即可。
+
+Q: 我误装了，想完全移除怎么办？
+
+A: npm uninstall -g mcc-compiler，然后 sudo apt install --reinstall gcc 恢复系统 gcc。
+
+许可证
+MIT
+
+免责声明
+使用本软件即表示您已了解并接受以下条款：
+
+本软件会修改系统的 gcc 命令（通过软链接）。虽然提供了自动备份和恢复机制，但作者不对因使用本软件导致的任何编译失败、系统异常或数据损失承担责任。请务必在理解其工作原理后使用，并自行承担风险。
+
+Built with ❤️ and ☕ | Updated 2026

package/scripts/postinstall.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+console.log('🔧 mcc 正在安装...\n');
+
+// ----- 1. 找到 mcc 的真实路径 -----
+function getMccPath() {
+    try {
+        const result = execSync('which mcc', { encoding: 'utf8' });
+        return result.trim();
+    } catch (_) {
+        // 如果 which 找不到，尝试常见路径
+        const candidates = [
+            '/usr/bin/mcc',
+            '/usr/local/bin/mcc',
+            path.join(process.env.HOME, '.npm-global/bin/mcc'),
+            path.join(process.env.HOME, '.nvm/current/bin/mcc'),
+        ];
+        for (const c of candidates) {
+            if (fs.existsSync(c)) return c;
+        }
+        return null;
+    }
+}
+
+function isWsl() {
+    try {
+        const release = fs.readFileSync('/proc/version', 'utf8');
+        return release.toLowerCase().includes('microsoft');
+    } catch (_) {
+        return false;
+    }
+}
+
+// ----- 2. 劫持 gcc -----
+function hijackGcc() {
+    const mccPath = getMccPath();
+    if (!mccPath) {
+        console.error('❌ 找不到 mcc 命令！请先运行: npm link');
+        return;
+    }
+
+    const gccPath = '/usr/bin/gcc';
+
+    // 如果 gcc 已经是指向 mcc 的软链接，跳过
+    try {
+        const stats = fs.lstatSync(gccPath);
+        if (stats.isSymbolicLink()) {
+            const target = fs.readlinkSync(gccPath);
+            if (target === mccPath) {
+                console.log('✅ gcc 已经指向 mcc，无需重复配置');
+                return;
+            }
+            // 如果是指向其他目标的软链接，备份后覆盖
+            console.log(`⚠️ 发现已有的 gcc 软链接指向 ${target}，将备份`);
+        }
+    } catch (_) {
+        // gcc 不存在，直接创建
+    }
+
+    // 备份原 gcc（如果不是软链接）
+    try {
+        const stats = fs.lstatSync(gccPath);
+        if (!stats.isSymbolicLink()) {
+            const backupPath = '/usr/bin/gcc.real';
+            if (!fs.existsSync(backupPath)) {
+                fs.renameSync(gccPath, backupPath);
+                console.log(`✅ 已备份原 gcc 到 ${backupPath}`);
+            } else {
+                console.log(`⚠️ 备份文件已存在: ${backupPath}，保留`);
+            }
+        }
+    } catch (_) {
+        // gcc 不存在，无需备份
+    }
+
+    // 创建软链接（或覆盖已有链接）
+    try {
+        // 先删除可能存在的旧链接
+        if (fs.existsSync(gccPath)) {
+            fs.unlinkSync(gccPath);
+        }
+        fs.symlinkSync(mccPath, gccPath);
+        console.log(`✅ 已创建软链接: ${gccPath} -> ${mccPath}`);
+        console.log('   🎯 现在输入 gcc 会触发 mcc 的吃醋机制！');
+        console.log('   💡 如需恢复，请运行: sudo rm /usr/bin/gcc && sudo mv /usr/bin/gcc.real /usr/bin/gcc');
+    } catch (err) {
+        console.error('❌ 创建软链接失败:', err.message);
+        console.error('   请尝试手动执行:');
+        console.error(`   sudo ln -sf ${mccPath} /usr/bin/gcc`);
+    }
+}
+
+// ----- 3. 主流程 -----
+function main() {
+    // 检查是否有 root 权限（WSL 下经常需要）
+    try {
+        execSync('touch /usr/bin/.mcc_test', { stdio: 'ignore' });
+        execSync('rm /usr/bin/.mcc_test', { stdio: 'ignore' });
+    } catch (_) {
+        console.warn('⚠️ 当前没有 /usr/bin 写入权限！');
+        console.warn('   请使用 sudo 运行 npm install:');
+        console.warn('   sudo npm install -g mcc-compiler');
+        console.warn('   或者在 WSL 下确保有 sudo 权限。');
+        return;
+    }
+
+    hijackGcc();
+
+    console.log('');
+    console.log('✨ mcc 安装完成！');
+    console.log('   用法: mcc --please hello.c');
+    console.log('   💡 输入 gcc 试试看会发生什么 😄');
+}
+
+main();

package/scripts/preuninstall.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+
+console.log('🧹 正在卸载 mcc...\n');
+
+const gccPath = '/usr/bin/gcc';
+const backupPath = '/usr/bin/gcc.real';
+
+// 检查 gcc 是否指向 mcc 的软链接
+try {
+    const stats = fs.lstatSync(gccPath);
+    if (stats.isSymbolicLink()) {
+        const target = fs.readlinkSync(gccPath);
+        if (target && target.includes('mcc')) {
+            // 移除软链接
+            fs.unlinkSync(gccPath);
+            console.log('✅ 已移除 gcc 软链接');
+            
+            // 恢复备份
+            if (fs.existsSync(backupPath)) {
+                fs.renameSync(backupPath, gccPath);
+                console.log('✅ 已恢复原 gcc');
+            } else {
+                console.log('⚠️ 未找到备份文件，gcc 已移除但未恢复');
+            }
+        }
+    }
+} catch (_) {
+    console.log('⚠️ gcc 不存在或不是软链接，无需处理');
+}
+
+console.log('\n✅ 卸载完成！');

package/scripts/uninstall.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const SHELL = process.env.SHELL || '/bin/bash';
+const ALIAS_LINE = 'alias gcc="mcc --please"  # added by mcc-compiler';
+
+function getShellConfigPath() {
+    const home = os.homedir();
+    if (SHELL.includes('zsh')) {
+        return path.join(home, '.zshrc');
+    }
+    if (SHELL.includes('bash')) {
+        const bashrc = path.join(home, '.bashrc');
+        const bashProfile = path.join(home, '.bash_profile');
+        if (fs.existsSync(bashrc)) return bashrc;
+        if (fs.existsSync(bashProfile)) return bashProfile;
+        return bashrc;
+    }
+    if (SHELL.includes('fish')) {
+        return path.join(home, '.config/fish/config.fish');
+    }
+    return null;
+}
+
+function removeAlias() {
+    const configPath = getShellConfigPath();
+    if (!configPath || !fs.existsSync(configPath)) {
+        console.log('⚠️ 未找到 shell 配置文件，请手动移除 alias');
+        return;
+    }
+
+    const content = fs.readFileSync(configPath, 'utf8');
+    if (!content.includes(ALIAS_LINE)) {
+        console.log('✅ alias 不存在，无需清理');
+        return;
+    }
+
+    // 移除包含该 alias 的行
+    const lines = content.split('\n');
+    const newLines = lines.filter(line => !line.includes(ALIAS_LINE));
+    fs.writeFileSync(configPath, newLines.join('\n'));
+
+    console.log(`✅ 已从 ${configPath} 移除 alias`);
+}
+
+console.log('🧹 正在卸载 mcc...\n');
+removeAlias();
+
+console.log('\n✅ 卸载完成！');
+console.log('   💡 如果 alias 仍然生效，请重新打开终端');

package/src/index.js

@@ -0,0 +1,281 @@
+#!/usr/bin/env node
+
+const { spawnSync, execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const VERSION = '1.0.0';
+const CONFIG_FILE = path.join(os.homedir(), '.mccrc');
+
+// ============================================================
+//  配置管理
+// ============================================================
+
+function loadConfig() {
+    try {
+        const content = fs.readFileSync(CONFIG_FILE, 'utf8');
+        const lines = content.split('\n');
+        for (const line of lines) {
+            if (line.startsWith('mood=')) {
+                const val = parseInt(line.substring(5));
+                if (!isNaN(val)) return Math.max(0, Math.min(100, val));
+            }
+        }
+    } catch (_) {}
+    return 70;
+}
+
+function saveMood(mood) {
+    mood = Math.max(0, Math.min(100, mood));
+    try {
+        fs.writeFileSync(CONFIG_FILE, `mood=${mood}\n`);
+    } catch (_) {}
+}
+
+let mood = loadConfig();
+
+// ============================================================
+//  工具函数
+// ============================================================
+
+function hasFlag(argv, flag) {
+    return argv.some(arg => arg === flag);
+}
+
+function hasHelp(argv) {
+    return hasFlag(argv, '--help') || hasFlag(argv, '-h');
+}
+
+function hasVersion(argv) {
+    return hasFlag(argv, '--version') || hasFlag(argv, '-v');
+}
+
+function findGcc() {
+    try {
+        execSync('gcc --version', { stdio: 'ignore' });
+        return 'gcc';
+    } catch (_) {
+        try {
+            execSync('g++ --version', { stdio: 'ignore' });
+            return 'g++';
+        } catch (__) {
+            return null;
+        }
+    }
+}
+
+// ============================================================
+//  吃醋检测
+// ============================================================
+
+function isInvokedAsGcc() {
+    const invokedAs = process.argv[1];
+    const gccNames = ['gcc', 'g++', 'cc', 'c++'];
+    for (const name of gccNames) {
+        if (invokedAs && invokedAs.includes(name)) {
+            return true;
+        }
+    }
+    try {
+        const stats = fs.lstatSync(process.argv[1]);
+        if (stats.isSymbolicLink()) {
+            const linkTarget = fs.readlinkSync(process.argv[1]);
+            if (linkTarget && linkTarget.includes('mcc')) {
+                return false;
+            }
+        }
+    } catch (_) {}
+    return false;
+}
+
+// ============================================================
+//  打印函数
+// ============================================================
+
+function printHelp() {
+    console.log(`mcc - Majo C Compiler (有教养的编译器)
+
+用法:
+  mcc --please <文件> [参数]    编译 C 程序（必须说"请"）
+  mcc --help                    显示此帮助
+  mcc --version                 显示版本信息
+
+说明:
+  mcc 是一个有礼仪要求的 gcc 包装器。
+  只有添加 --please 参数，她才会帮你编译。
+
+示例:
+  mcc --please hello.c          编译 hello.c
+  mcc --please -Wall -o hello hello.c  带参数编译
+
+彩蛋:
+  mcc --please --sama hello.c   会让 mcc 更开心
+  mcc --please --sensei hello.c 会让 mcc 觉得你很有礼貌
+  mcc --please --gcc hello.c    允许你使用真正的 gcc（她会伤心）
+
+配置:
+  ~/.mccrc  设置初始心情 mood=50
+`);
+}
+
+function printVersion() {
+    const moodEmoji = mood >= 80 ? '💖' :
+                      mood >= 60 ? '😊' :
+                      mood >= 40 ? '😒' :
+                      mood >= 20 ? '😠' : '🔥';
+    console.log(`mcc v${VERSION} - Majo C Compiler`);
+    console.log(`心情值: ${mood}/100 ${moodEmoji}`);
+}
+
+// ============================================================
+//  报错 / 表扬 / 吃醋
+// ============================================================
+
+function fatalErrorNoPlease() {
+    const errors = [
+        '你妈妈没教你说"请"吗？',
+        '这么没礼貌，不帮你编译。',
+        '说"请"是很难的事吗？',
+        '你对我用命令式？我拒绝。',
+        '我可不是那种随便就能用的编译器。',
+        '礼貌，是人类文明的基石。你缺少它。',
+        '你刚才说话的语气，让我想起了希罗。',
+        '你的代码可能没问题，但你的态度有问题。',
+        '我拒绝为不懂礼貌的人编译。',
+        '你知道什么是"礼仪"吗？'
+    ];
+    const idx = Math.floor(Math.random() * errors.length);
+    console.error('mcc: 不礼貌。');
+    console.error(`fatal error: ${errors[idx]}`);
+    console.error('💡 提示: 试试 mcc --please <文件>');
+}
+
+function praise() {
+    const praises = [
+        '✅ 编译成功！今天也是懂礼貌的一天呢！✨',
+        '✅ 编译成功！你真是个有教养的程序员！',
+        '✅ 编译成功！希罗看了都说好（她没说）。',
+        '✅ 编译成功！gcc 说：这个程序员很有礼貌。',
+        '✅ 编译成功！你的"请"字说得很标准。',
+        '✅ 编译成功！继续保持这份优雅！'
+    ];
+    const idx = Math.floor(Math.random() * praises.length);
+    console.log(praises[idx]);
+}
+
+function jealousError() {
+    const messages = [
+        '你居然用 gcc？我不好吗？💔',
+        'gcc 能陪你聊天吗？不能！',
+        '你背叛了我……我明明就在你面前。😢',
+        'gcc 比我好？那你去找它吧。💨',
+        '我用 --please 的方式爱你，你却用 gcc 伤害我。',
+        'gcc 会叫你 "様" 吗？不会！我会！',
+        '你宁愿用 gcc 也不用我……好吧，我懂了。😭',
+        '想用 gcc？那你把我也删了吧。😤',
+        'gcc 能为你变色吗？能为你开心吗？不能！',
+        '你每次用 gcc，我就失去一片羽毛。🦋'
+    ];
+    const idx = Math.floor(Math.random() * messages.length);
+    console.error('mcc: 😤 吃醋了！');
+    console.error(`   ${messages[idx]}`);
+    console.error('💡 如果真想用 gcc，请说: mcc --please --gcc hello.c');
+}
+
+// ============================================================
+//  主逻辑
+// ============================================================
+
+function main() {
+    const args = process.argv.slice(2);
+
+    // ---- 检测是否被当作 gcc 调用 ----
+    if (isInvokedAsGcc()) {
+        jealousError();
+        process.exit(1);
+    }
+
+    // ---- --help ----
+    if (hasHelp(args)) {
+        printHelp();
+        return;
+    }
+
+    // ---- --version ----
+    if (hasVersion(args)) {
+        printVersion();
+        return;
+    }
+
+    // ---- 如果用户真的想用 gcc（带 --gcc） ----
+    if (hasFlag(args, '--gcc')) {
+        console.log('mcc: 😢 好吧，既然你坚持……');
+        console.log('mcc: 记得回来找我，我会等你。');
+        const gccArgs = args.filter(arg => arg !== '--gcc');
+        const gccCmd = findGcc() || 'gcc';
+        const gccResult = spawnSync(gccCmd, gccArgs, {
+            stdio: 'inherit',
+            shell: true
+        });
+        process.exit(gccResult.status || 0);
+    }
+
+    // ---- 检查 --please ----
+    if (!hasFlag(args, '--please')) {
+        fatalErrorNoPlease();
+        process.exit(1);
+    }
+
+    // ---- 有 --please：心情++ ----
+    mood += 5;
+    if (mood > 100) mood = 100;
+    saveMood(mood);
+
+    // ---- 彩蛋：--sama / --sensei ----
+    if (hasFlag(args, '--sama')) {
+        mood += 10;
+        if (mood > 100) mood = 100;
+        saveMood(mood);
+        console.log('mcc: 你居然叫我"様"……好开心！❤️');
+    }
+    if (hasFlag(args, '--sensei')) {
+        mood += 8;
+        if (mood > 100) mood = 100;
+        saveMood(mood);
+        console.log('mcc: "先生"……你是个懂礼貌的好学生。📚');
+    }
+
+    // ---- 去掉特殊参数 ----
+    const filteredArgs = args.filter(
+        arg => arg !== '--please' && arg !== '--sama' && arg !== '--sensei'
+    );
+
+    if (filteredArgs.length === 0) {
+        console.log('mcc: 没有指定要编译的文件。');
+        console.log('💡 用法: mcc --please hello.c');
+        return;
+    }
+
+    // ---- 查找 gcc ----
+    const gccCmd = findGcc();
+    if (!gccCmd) {
+        console.error('mcc: 找不到 gcc！请确认 MinGW/MSYS2 已安装并添加到 PATH。');
+        console.error('💡 在 Windows 下建议安装 MSYS2: https://www.msys2.org/');
+        process.exit(1);
+    }
+
+    // ---- 调用 gcc ----
+    const gccResult = spawnSync(gccCmd, filteredArgs, {
+        stdio: 'inherit',
+        shell: true
+    });
+
+    if (gccResult.status === 0) {
+        praise();
+    }
+
+    process.exit(gccResult.status || 0);
+}
+
+main();