Swakin

使用Gitee实现免费的软件更新服务

Mon, 06 Jul 2026 00:00:00 GMT

在开发桌面应用时，软件更新是一个必不可少的功能。本文记录了一套将 Gitee 作为软件更新服务的完整方案，利用 GitHub Actions 实现自动部署，通过 Gitee API 实现版本检测和文件下载。 :::warning 本文只提供思路，代码均由AI生成，仅供参考。 :::

整体架构

整个更新流程分为三个主要部分：

GitHub Actions 构建部署：编译项目，将产物上传到专门的文件仓库，并创建对应版本的 release
Gitee 仓库同步：同步文件仓库到 Gitee，利用标签来追踪版本
客户端更新检测：通过 Gitee API 获取最新版本信息，对比本地版本，下载并安装更新

GitHub 源码仓库
    |
    v
GitHub Actions (编译)
    |
    v
GitHub 文件仓库 (release)
    |
    v
Gitee 文件仓库 (同步)
    |
    v
客户端检测更新 → 下载 → 安装

GitHub Actions 配置

首先需要在 GitHub 上创建一个专门用于存放编译产物的仓库（如 my-app-releases），然后在源码仓库配置 Actions 工作流。

name: Deploy Release

on:
  push:
    tags:
      - 'v*'

jobs:
  build:
    runs-on: windows-latest
    steps:
      - uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.12'

      - name: Install dependencies
        run: |
          python -m pip install --upgrade pip
          pip install -r requirements.txt

      - name: Build application
        run: python build.py

      - name: Upload to release repo
        uses: EndBug/add-and-commit@v9
        with:
          args: '-m "chore: release ${{ github.ref_name }}"'
          add: 'dist/my-app-v${{ github.ref_name }}.7z'
          cwd: '../my-app-releases'

      - name: Create tag
        uses: mathieudutour/github-tag-action@v6.1
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          tag: ${{ github.ref_name }}
          repo: username/my-app-releases

关键要点：

文件名必须包含版本号，如 my-app-v1.0.0.7z，方便客户端匹配
使用 7z 压缩可以显著减小文件体积
通过 tag 触发部署，确保版本号与 tag 一致
文件直接上传到仓库而非 release，这样 Gitee 同步时可以包含文件

仓库清理机制

Gitee 仓库有大小限制，随着版本迭代，编译文件会不断累积，导致仓库体积过大。因此需要在文件仓库中配置一个清理 Actions，定期清理旧版本文件，只保留最新的几个版本。

清理策略

触发条件：当仓库中的文件数量超过 1 个时触发清理
清理方式：只保留最新的 1 个版本文件和对应的 tag，删除所有旧版本文件和 tag
实现方式：新建 git 仓库，只保留需要的文件，然后强制覆盖远程仓库

清理 Actions 配置

在文件仓库（my-app-releases）中创建清理工作流：

name: Cleanup Old Releases

on:
  push:
    branches:
      - main

jobs:
  cleanup:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: List files
        id: list_files
        run: |
          files=$(ls *.7z 2>/dev/null | wc -l)
          echo "file_count=$files" >> "$GITHUB_OUTPUT"

      - name: Cleanup if needed
        if: steps.list_files.outputs.file_count > 1
        run: |
          git checkout --orphan new_main
          git rm -rf .
          
          latest_file=$(ls *.7z 2>/dev/null | sort -V | tail -1)
          git add "$latest_file"
          
          git commit -m "Cleanup: keep only latest version"
          git push origin new_main --force
          
          for tag in $(git tag -l); do
            file="my-app-${tag}.7z"
            if [ ! -f "$file" ]; then
              git push origin :refs/tags/"$tag"
              git tag -d "$tag"
            fi
          done

      - name: Reset main branch
        if: steps.list_files.outputs.file_count > 1
        run: |
          git checkout main
          git reset --hard new_main
          git push origin main --force

清理流程详解：

统计文件数量：检查仓库中 .7z 文件的数量
创建新分支：使用 git checkout --orphan 创建一个没有历史记录的新分支
清空文件：删除所有文件，只保留最新的 1 个版本文件
提交并强推：提交新分支并强制推送到远程仓库
清理旧标签：删除那些没有对应文件的旧标签
重置主分支：将主分支重置到新分支并强制推送

注意事项：

使用 --force 参数会强制覆盖远程仓库，确保清理生效
只删除没有对应文件的标签，保留与最新版本对应的标签
Gitee 同步会自动同步清理后的仓库状态，但需要注意同步延迟

文件大小优化

Gitee 的仓库文件和 release 都限制 100MB，因此需要对编译产物进行大小优化：

编译时排除不必要的导入

在编译前分析项目依赖，只导入实际使用的模块，避免打包未使用的库：

import sys
import os
from pathlib import Path

def analyze_imports(source_dir):
    used_modules = set()
    
    for py_file in Path(source_dir).rglob('*.py'):
        with open(py_file, 'r', encoding='utf-8') as f:
            content = f.read()
            for line in content.split('\n'):
                if line.startswith('import ') or line.startswith('from '):
                    parts = line.split()
                    if len(parts) >= 2:
                        module = parts[1].split('.')[0]
                        used_modules.add(module)
    
    return used_modules

def filter_requirements(requirements_path, used_modules):
    with open(requirements_path, 'r') as f:
        lines = f.readlines()
    
    filtered = []
    for line in lines:
        line = line.strip()
        if not line or line.startswith('#'):
            filtered.append(line)
            continue
        
        pkg_name = line.split('=')[0].split('>')[0].split('<')[0].strip()
        if pkg_name.lower() in [m.lower() for m in used_modules]:
            filtered.append(line)
    
    with open(requirements_path, 'w') as f:
        f.write('\n'.join(filtered) + '\n')

if __name__ == '__main__':
    used_modules = analyze_imports('src')
    filter_requirements('requirements.txt', used_modules)

注意： 这种方式需要谨慎使用，因为有些模块可能是动态导入的，分析工具无法检测到。建议在测试环境中验证后再使用。

编译后清理不必要的运行库文件

以 PyInstaller 为例，可以通过配置文件排除不必要的运行库：

block_cipher = None

a = Analysis(
    ['main.py'],
    pathex=['src'],
    binaries=[],
    datas=[],
    hiddenimports=[],
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[
        'tkinter',
        'matplotlib',
        'numpy',
        'scipy',
        'pandas',
        'PyQt5.QtWebEngine',
        'PyQt5.QtWebKit',
    ],
    win_no_prefer_redirects=False,
    win_private_assemblies=False,
    cipher=block_cipher,
    noarchive=False,
)

pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher)

exe = EXE(
    pyz,
    a.scripts,
    [],
    exclude_binaries=True,
    name='my-app',
    debug=False,
    bootloader_ignore_signals=False,
    strip=True,
    upx=True,
    console=False,
)

coll = COLLECT(
    exe,
    a.binaries,
    a.zipfiles,
    a.datas,
    strip=True,
    upx=True,
    upx_exclude=[],
    name='my-app',
)

关键优化项：

excludes：排除不需要的模块，如 tkinter、matplotlib 等
strip=True：去除二进制文件中的符号表，减小体积
upx=True：使用 UPX 压缩可执行文件

清理运行库文件

编译完成后，可以手动清理一些不必要的文件：

import os
import shutil

def cleanup_dist(dist_dir):
    remove_patterns = [
        '*.pdb',
        '*.pyc',
        '*.pyo',
        '__pycache__',
        '*.dll',
        '*.so',
    ]
    
    for root, dirs, files in os.walk(dist_dir):
        for file in files:
            file_path = os.path.join(root, file)
            for pattern in remove_patterns:
                if file.endswith(pattern.strip('*')):
                    os.remove(file_path)
                    break
        
        for dir_name in dirs:
            if dir_name == '__pycache__':
                dir_path = os.path.join(root, dir_name)
                shutil.rmtree(dir_path)

if __name__ == '__main__':
    cleanup_dist('dist/my-app')

注意： 需要根据实际使用的库来决定删除哪些文件，避免删除程序运行必需的 DLL 或 SO 文件。

压缩为 7z 文件

import subprocess
import os

def compress_with_7z(source_dir, output_path):
    cmd = [
        '7z', 'a', '-t7z', '-mx=9', '-mfb=64', '-md=32m', '-ms=on',
        output_path, source_dir
    ]
    subprocess.run(cmd, check=True)

if __name__ == '__main__':
    compress_with_7z('dist/app', 'dist/my-app-v1.0.0.7z')

分离资源文件

将资源文件（如图片、配置文件等）放到单独的 Gitee 仓库，在软件启动时检查资源更新：

import requests
import hashlib
import os

RESOURCE_REPO = "https://gitee.com/username/my-app-resources/raw/main/"

def check_resource_update(local_path, resource_name):
    remote_url = f"{RESOURCE_REPO}{resource_name}"
  
    local_hash = md5_file(local_path)
    remote_hash = get_remote_file_hash(remote_url)
  
    if local_hash != remote_hash:
        download_resource(remote_url, local_path)

def md5_file(file_path):
    md5 = hashlib.md5()
    with open(file_path, 'rb') as f:
        for chunk in iter(lambda: f.read(8192), b''):
            md5.update(chunk)
    return md5.hexdigest()

def get_remote_file_hash(url):
    response = requests.head(url)
    return response.headers.get('ETag', '').strip('"')

这种方式还可以实现资源的增量更新，只下载变化的文件。

Gitee 仓库同步

在 Gitee 上创建一个与 GitHub 文件仓库同名的仓库，然后配置同步：

在 Gitee 仓库设置中找到「仓库同步」
添加 GitHub 仓库地址和访问 token
设置同步方向为「从 GitHub 同步到 Gitee」

注意事项：

Gitee 的同步功能不会同步 release，只会同步代码和标签（tag）
需要通过添加或删除 release 来控制版本更新的发布时机
自动同步 API 可能已关闭：目前 Gitee 的自动同步功能疑似出现问题，可能无法自动触发同步，需要手动到仓库页面点击「同步」按钮

独立更新程序设计

建议将更新功能独立编写为一个单独的程序（如 updater.exe），由主程序调用执行更新。这样可以避免在更新过程中文件被占用，同时也便于维护和调试。

更新程序架构

主程序 (main.exe)
    |
    v
检查更新 → 发现新版本 → 启动更新程序 (updater.exe) → 退出主程序
                                    |
                                    v
                            下载更新文件 → 解压 → 替换文件 → 重启主程序

版本检测（使用 Gitee API + 私钥）

Gitee API 调用需要使用私钥（access_token）进行身份验证，且有调用频率限制。对于小文件（如版本信息）可以直接用 raw URL 获取，大文件下载需要使用 API：

import requests
import re
import time

class GiteeUpdater:
    def __init__(self, repo_owner, repo_name, access_token=None):
        self.repo_owner = repo_owner
        self.repo_name = repo_name
        self.api_base = "https://gitee.com/api/v5"
        self.access_token = access_token
        self.headers = {}
        if access_token:
            self.headers['Authorization'] = f"token {access_token}"
    
    def _make_request(self, url, method='GET', **kwargs):
        max_retries = 3
        retry_delay = 5
        
        for attempt in range(max_retries):
            try:
                response = requests.request(method, url, headers=self.headers, **kwargs)
                if response.status_code == 429:
                    wait_time = int(response.headers.get('Retry-After', retry_delay))
                    time.sleep(wait_time)
                    continue
                response.raise_for_status()
                return response.json()
            except requests.exceptions.RequestException as e:
                if attempt < max_retries - 1:
                    time.sleep(retry_delay * (attempt + 1))
                    continue
                raise
    
    def get_latest_version(self):
        url = f"{self.api_base}/repos/{self.repo_owner}/{self.repo_name}/tags"
        tags = self._make_request(url)
        
        if not tags:
            return None
        
        version_pattern = re.compile(r'^v(\d+\.\d+\.\d+)$')
        versions = []
        
        for tag in tags:
            match = version_pattern.match(tag['name'])
            if match:
                versions.append((tag['name'], match.group(1)))
        
        if not versions:
            return None
        
        versions.sort(key=lambda x: tuple(map(int, x[1].split('.'))), reverse=True)
        return versions[0][0]
    
    def compare_versions(self, current_version, latest_version):
        current = tuple(map(int, current_version.lstrip('v').split('.')))
        latest = tuple(map(int, latest_version.lstrip('v').split('.')))
        return latest > current
    
    def get_file_download_url(self, version, filename):
        url = f"{self.api_base}/repos/{self.repo_owner}/{self.repo_name}/contents/{filename}"
        params = {'ref': version}
        data = self._make_request(url, params=params)
        
        if isinstance(data, dict) and 'download_url' in data:
            return data['download_url']
        return None

API 安全注意事项：

私钥管理：不要将 access_token 硬编码在代码中，建议通过配置文件或环境变量传入
调用限制：Gitee API 有调用频率限制（普通用户每小时 60 次），需要实现重试机制
权限范围：创建 access_token 时只授予必要的权限（如 projects:read）

文件下载与安装

import shutil
import tempfile
import subprocess
import sys

def download_and_install(self, version):
    filename = f"my-app-{version}.7z"
    download_url = self.get_file_download_url(version, filename)
    
    if not download_url:
        raise Exception(f"无法获取文件下载链接: {filename}")
    
    with tempfile.TemporaryDirectory() as temp_dir:
        download_path = os.path.join(temp_dir, filename)
        self.download_file(download_url, download_path)
        self.extract_7z(download_path, temp_dir)
        self.install_update(temp_dir)

def download_file(self, url, save_path):
    max_retries = 3
    retry_delay = 10
    
    for attempt in range(max_retries):
        try:
            response = requests.get(url, headers=self.headers, stream=True)
            if response.status_code == 429:
                wait_time = int(response.headers.get('Retry-After', retry_delay))
                time.sleep(wait_time)
                continue
            response.raise_for_status()
            
            with open(save_path, 'wb') as f:
                for chunk in response.iter_content(chunk_size=8192):
                    f.write(chunk)
            return
        except requests.exceptions.RequestException as e:
            if attempt < max_retries - 1:
                time.sleep(retry_delay * (attempt + 1))
                continue
            raise

def extract_7z(self, file_path, dest_dir):
    import py7zr
    with py7zr.SevenZipFile(file_path, mode='r') as z:
        z.extractall(dest_dir)

def install_update(self, source_dir):
    app_dir = os.path.dirname(os.path.abspath(sys.argv[0]))
    
    for item in os.listdir(source_dir):
        s = os.path.join(source_dir, item)
        d = os.path.join(app_dir, item)
        
        if os.path.isdir(s):
            if os.path.exists(d):
                shutil.rmtree(d)
            shutil.move(s, d)
        else:
            if os.path.exists(d):
                os.remove(d)
            shutil.move(s, d)

def restart_app(self):
    app_path = os.path.join(os.path.dirname(os.path.abspath(sys.argv[0])), 'main.exe')
    subprocess.Popen([app_path])

if __name__ == '__main__':
    updater = GiteeUpdater(
        repo_owner="username",
        repo_name="my-app-releases",
        access_token="your-access-token"
    )
    
    current_version = "v1.0.0"
    latest_version = updater.get_latest_version()
    
    if updater.compare_versions(current_version, latest_version):
        updater.download_and_install(latest_version)
        updater.restart_app()

主程序调用更新程序

import subprocess
import sys
import os

def check_and_update():
    updater_path = os.path.join(os.path.dirname(sys.argv[0]), 'updater.exe')
    
    if os.path.exists(updater_path):
        subprocess.Popen([updater_path])
        sys.exit(0)

if __name__ == '__main__':
    check_and_update()
    run_main_app()

调用流程：

主程序启动时检测更新程序是否存在
如果存在，启动更新程序并退出自身
更新程序完成更新后重启主程序

Raw URL vs API 下载

方式	优点	缺点	适用场景
Raw URL	无需认证，简单直接	有下载限制，大文件可能失败	小文件（如版本信息）
API 下载	稳定可靠，支持大文件	需要认证，有调用限制	大文件（如更新包）

建议策略：

使用 raw URL 获取版本信息（小文件，无需认证）
使用 API 下载更新包（大文件，需要认证）
实现重试机制和限流处理

为什么这样设计

核心设计理由：文件走仓库，版本走 release

这是整个方案的核心思路：

文件存储：编译后的文件直接上传到 GitHub 文件仓库，通过 Gitee 同步功能同步到 Gitee 仓库
文件下载：通过 Gitee API 获取文件下载链接进行下载（需使用 access_token 认证）
版本控制：通过 Gitee release 和标签（tag）来标记和检测版本

为什么这样设计：

上传文件到仓库容易：通过 GitHub Actions 将文件推送到 GitHub 文件仓库，再通过 Gitee 同步功能自动同步到 Gitee，无需手动操作
下载不限速：通过 Gitee API 获取文件下载链接进行下载，下载速度稳定，不受 release 限速影响
获取下载链接容易：通过 Gitee API /repos/{owner}/{repo}/contents/{filename} 可以直接获取文件下载链接，只需一次 API 调用
同步不包含 release：Gitee 的仓库同步功能只同步代码和标签（tag），不会同步 release。因此文件必须放在仓库中才能被同步
大文件不支持 raw 下载：Gitee 的 raw URL 对大文件有限制，无法直接下载几十兆的文件，必须通过 API 获取下载链接

为什么不直接在 Actions 上传文件到 Gitee

上传速度慢：GitHub Actions 的网络环境上传文件到 Gitee 非常慢，几十兆的文件可能需要半小时甚至更久
Gitee Release 限速：通过 API 上传文件到 Gitee release 有严格的限速限制

为什么选择 Gitee

国内访问快：对于国内用户来说，Gitee 的下载速度远快于 GitHub
API 稳定：Gitee API 响应稳定，适合作为客户端更新服务
免费额度高：免费仓库有足够的空间存放编译产物
仓库同步功能：Gitee 提供了从 GitHub 同步仓库的功能，可以自动同步代码和标签

使用流程总结

开发阶段：在 GitHub 源码仓库开发，提交代码
发布版本：创建新的 tag（如 v1.0.0），触发 GitHub Actions
构建部署：Actions 编译项目，压缩文件，上传到文件仓库的 release
自动同步：Gitee 自动同步文件仓库的代码和标签
创建 Release：在 Gitee 文件仓库手动或通过 API 创建对应版本的 release
客户端检测：软件启动时调用 Gitee API 获取最新版本，对比本地版本
下载更新：检测到更新后下载文件，解压并替换现有文件
完成更新：重启软件完成更新

这套方案充分利用了 GitHub Actions 的构建能力和 Gitee 的国内访问优势，实现了一套完整的软件自动更新流程。

Nuitka Windows 管理员终端编译问题

Wed, 13 May 2026 00:00:00 GMT

问题描述

在 Windows 系统上使用 Nuitka 编译 Python 程序时，发现以下差异行为：

终端类型	现象
管理员终端	多线程编译时出现 `.obj` 文件访问错误，需要限制 `--jobs=4` 才能成功
非管理员终端	无需限制线程数即可正常编译

根本原因

这是 Nuitka 在 Windows 上的一个已知竞态条件问题，涉及以下因素：

1. clcache 竞态条件

Nuitka 内嵌的 clcache (MSVC 编译缓存) 与 C 编译器之间存在文件访问竞争：

线程 A 正在写入 .obj 文件到缓存
线程 B 尝试读取/访问同一文件
导致 "access denied" 或 "file not found" 错误

2. Windows Defender 实时保护

管理员权限：防病毒软件进行更深入的扫描，延长文件锁定时间
非管理员权限：扫描强度较低，文件锁竞争减少

3. 文件系统行为差异

管理员模式下 Windows 强制同步文件写入（FlushFileBuffers），增加了竞争窗口。

Issue	描述	链接
#1591	Windows: Random "access denied" on clcache objects in Scons	查看
#2832	FileExistsError when running multiple builds in parallel	查看
#2950	FATAL: Failed unexpectedly in Scons C backend compilation	查看
#2823	Windows Defender 锁定文件导致资源添加失败	查看

解决方案

方案 1：限制并行任务数

python -m nuitka --jobs=4 your_script.py

方案 2：禁用 LTO（减少文件 I/O）

python -m nuitka --lto=no your_script.py

方案 3：添加防病毒排除项（推荐）

将以下目录添加到 Windows Defender 排除列表：

%LOCALAPPDATA%\Nuitka
项目构建目录

PowerShell 命令：

# 添加 Nuitka 缓存目录到排除项
Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\Nuitka"

环境信息

项目	版本/说明
Nuitka	4.0.8
模式	standalone
操作系统	Windows 10/11
编译器	MSVC (cl.exe)

参考

PySide PyQt多语言国际化翻译工作流以及相关问题

Fri, 01 May 2026 00:00:00 GMT

正确标记文本

这里默认你已经了解了国际化的流程和工具，具体可以参考，C++版更底层的解释

使用.tr()

只要是使用.tr()标记的文本不管.tr()在这里能否直接访问，都会被pyside6-lupdate工具（PyQt5是pylupdate5）添加到.ts文件。

对于类本身就继承自QObject的（QT组件都是），可以直接使用self.tr()标记文本，对于类没有继承QObject的，使用别的继承了QObject的对象调用.tr()虽然可以正常标记文本，但想要不修改文件.ts直接使用就必须让类继承QObject然后调用self.tr()。

因为生成的.ts里context名称默认为类名，使用其他对象或类的.tr()方法都不能正确处理context名称，要自己去修改成正确的名称才能正常生效非常麻烦。直接使用QObject.tr()或QCoreApplication.tr()都是不行的，这时context名称直接为空，无法对应上。

使用QCoreApplication.translate()

QApplication.translate(context: str, sourceText: str, disambiguation: str = None, n: int = -1) -> str

参数	说明
context	上下文名称，通常用类名（如 'InfoBar' ），用于区分不同模块中相同的源文本
sourceText	要翻译的源文本（如 '提示' ）
disambiguation	（可选）消歧字符串，当同一上下文中有相同源文本但不同含义时使用
n	（可选）用于处理复数形式， -1 表示不使用复数

对于无法直接调用或继承QObject的情况，直接使用QApplication.translate()，一般只需要传入前两项参数，虽然这样很长，但不要改写名称例如tr=QApplication.translate或封装方法后使用，这样pyside6-lupdate工具要么会错误理解内容要么无法识别到标记文本。

使用自定义的翻译器管理

如果不想每次都使用一长串来标记，可以放弃qt的自动托管，使用自定的翻译管理类。思路就是在需要标记的地方实例化一个QObject对象，然后调用.tr()进行标记，这样pyside6-lupdate工具会将对象名作为context名称，需要使用对应文本时可以通过context名称和原始文本从 qm 文件返回翻译文本。这里只提供简单的思路，我还未在自己的项目中实现。

对于要在界面中显示的选项等配置文本，可以单独创建一个类继承自QObject，单独将所有要使用的文本标记，同样在需要使用对应文本时可以通过context名称和原始文本从 qm 文件返回翻译文本。在配置变更时也可以获取原始文本来写入配置。

翻译工作流说明

翻译管理脚本

让AI写一个脚本例如 update_i18n.py，具备以下功能，主要根据项目文件创建.ts文件、将.ts文件中要翻译的文本到处为JSON，将JSON文件扔给免费AI补全翻译文本，再用脚本将翻译好的内容应用到.ts文件中，最后编译成.qm文件。

为什么不直接让AI翻译.ts文件，因为文件结构特殊，AI也是要先提取文本翻译了再生成文件的，这样效率低而且很容易漏掉某些文本，不如直接给结构化的文本，AI直接一对一自动翻译，校对翻译内容时直接看JSON文件也更方便，当然不用JSON，用表格也是可以的。

命令说明

# 初始化创建 .ts 文件
python devTools/update_i18n.py --init

# 更新翻译源文件
python devTools/update_i18n.py --update

# 导出待翻译文本到 JSON
python devTools/update_i18n.py --export

# 导出所有翻译（包括已完成的）
python devTools/update_i18n.py --export-all

# 从 JSON 文件读取翻译并应用到 .ts
python devTools/update_i18n.py --apply

# 编译翻译文件
python devTools/update_i18n.py --release

# 执行完整工作流（更新 + 编译）
python devTools/update_i18n.py --all

# 查看帮助
python devTools/update_i18n.py --help

标准翻译工作流

# 1. 更新翻译源文件
python devTools/update_i18n.py --update

# 2. 导出所有翻译到 JSON 以便编辑
python devTools/update_i18n.py --export-all

# 3. 编辑 translations.json，添加/修改翻译

# 4. 应用翻译到 .ts 文件
python devTools/update_i18n.py --apply

# 5. 编译为 .qm 文件
python devTools/update_i18n.py --release

仅添加新翻译的工作流

# 1. 更新翻译源文件
python devTools/update_i18n.py --update

# 2. 只导出未完成的翻译
python devTools/update_i18n.py --export

# 3. 在 translations.json 中为未完成的条目添加翻译

# 4. 应用翻译
python devTools/update_i18n.py --apply

# 5. 编译
python devTools/update_i18n.py --release

参数详解

参数	别名	说明
--init	-i	初始化创建 .ts 文件
--update	-u	从 Python/UI 代码提取可翻译字符串，更新 .ts 文件
--release	-r	将 .ts 编译为二进制 .qm 文件
--all	-a	同时执行 --update 和 --release（默认行为）
--export	-e	导出未完成的翻译条目到 JSON（直接覆盖）
--export-all		导出所有翻译条目到 JSON（直接覆盖）
--apply		从 translations.json 读取翻译并更新 .ts 文件
--help	-h	显示帮助信息

translations.json 文件格式

新的 JSON 格式是一条文本对应多个语言版本，更加直观：

[
  {
    "source": "源文本（可选）",
    "comment": "注释文本（用于匹配，优先）",
    "zh_CN": "简体中文翻译",
    "zh_TW": "繁体中文翻译",
    "en_US": "英文翻译",
    "ja_JP": "日文翻译"
  },
  {
    "comment": "警告",
    "zh_CN": "警告",
    "en_US": "Warning"
  }
]

格式说明

source: 原始文本（可选，用于匹配）
comment: 注释文本（可选，用于匹配，优先级高于 source）
zh_CN, zh_TW, en_US, ja_JP: 各语言的翻译内容

匹配规则：先匹配 comment，没有则匹配 source。

PySide6 QToolButton 字体Bug：setPixelSize在6.10.1+版本中的问题

Sun, 22 Mar 2026 00:00:00 GMT

PySide6 QToolButton 字体Bug分析

问题描述

在PySide6 6.10.1+版本中，当QToolButton使用QFont.setPixelSize方法设置字体或在样式表中包含font-size设置时，鼠标离开按钮时会触发以下错误：

QFont::setPointSize: Point size <= 0 (-1), must be greater than 0

影响范围

版本：仅影响PySide6 6.10.1+版本
组件：仅影响QToolButton
触发条件：
- 使用setPixelSize设置字体
- 或在样式表中设置font-size
- 鼠标悬停后离开按钮

复现步骤

创建使用setPixelSize的QToolButton
应用包含font-size设置的样式表
鼠标悬停在按钮上
鼠标移出时出现错误

完整测试代码

"""
PySide6 QToolButton Font Bug Test
Demonstrates the font issue with QToolButton in PySide6 6.10.1+
"""
import sys
import PySide6
from PySide6.QtCore import Qt
from PySide6.QtGui import QFont
from PySide6.QtWidgets import QApplication, QWidget, QVBoxLayout, QToolButton, QLabel


class SimpleTestWidget(QWidget):
    """ Simple test interface for PySide6 font bug """
    
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setup_ui()
        
    def setup_ui(self):
        layout = QVBoxLayout(self)
        layout.setSpacing(20)
        
        # Title with version info
        title = QLabel("PySide6 Version: " + PySide6.__version__ + " - QToolButton Font Bug Test")
        title.setAlignment(Qt.AlignCenter)
        title.setStyleSheet("font-size: 16px; font-weight: bold;")
        layout.addWidget(title)
        
        # QToolButton with setPixelSize (no stylesheet)
        pixel_button_no_style = QToolButton(self)
        pixel_button_no_style.setText("setPixelSize(14) - No Stylesheet")
        
        font_pixel = QFont()
        font_pixel.setFamilies(['Segoe UI', 'Microsoft YaHei'])
        font_pixel.setPixelSize(14)  # Using setPixelSize
        pixel_button_no_style.setFont(font_pixel)
        
        layout.addWidget(pixel_button_no_style)
        
        # QToolButton with setPixelSize (with stylesheet) - BUG APPEARS HERE
        pixel_button_with_style = QToolButton(self)
        pixel_button_with_style.setText("setPixelSize(14) - With Stylesheet (BUG)")
        
        font_pixel2 = QFont()
        font_pixel2.setFamilies(['Segoe UI', 'Microsoft YaHei'])
        font_pixel2.setPixelSize(14)  # Using setPixelSize
        pixel_button_with_style.setFont(font_pixel2)
        
        # Apply stylesheet (simulates the bug condition)
        style_sheet = """
        QToolButton {
            background: rgba(255, 255, 255, 0.7);
            border: 1px solid rgba(0, 0, 0, 0.073);
            border-radius: 5px;
            padding: 5px 12px 6px 12px;
        }
        """
        pixel_button_with_style.setStyleSheet(style_sheet)
        
        layout.addWidget(pixel_button_with_style)
        
        # QToolButton with setPointSize (with stylesheet) - WORKAROUND
        point_button_with_style = QToolButton(self)
        point_button_with_style.setText("setPointSize(10) - With Stylesheet (Workaround)")
        
        font_point = QFont()
        font_point.setFamilies(['Segoe UI', 'Microsoft YaHei'])
        font_point.setPointSize(10)  # Using setPointSize (workaround)
        point_button_with_style.setFont(font_point)
        
        point_button_with_style.setStyleSheet(style_sheet)
        layout.addWidget(point_button_with_style)

        style_sheet2 = """
        QToolButton {
            background: rgba(255, 255, 255, 0.7);
            border: 1px solid rgba(0, 0, 0, 0.073);
            border-radius: 5px;
            padding: 5px 12px 6px 12px;
            font-size: 14px;
        }
        """
        point_button_with_style2 = QToolButton(self)
        point_button_with_style2.setText("setPointSize(10) - With Stylesheet and set Font-size (bug)")
        
        font_point2 = QFont()
        font_point2.setFamilies(['Segoe UI', 'Microsoft YaHei'])
        font_point2.setPointSize(10)  
        point_button_with_style2.setFont(font_point2)
        
        point_button_with_style2.setStyleSheet(style_sheet2)
        
        layout.addWidget(point_button_with_style2)  
        # Instructions
        desc = QLabel("Hover mouse over buttons to test the font bug.")
        desc.setStyleSheet("color: gray; font-size: 12px;")
        layout.addWidget(desc)
        
        self.resize(500, 350)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = SimpleTestWidget()
    window.setWindowTitle("PySide6 QToolButton Font Bug Test")
    window.show()
    sys.exit(app.exec())

临时解决方案

方案1：使用setPointSize替代setPixelSize

# 不安全的代码
font = QFont()
font.setPixelSize(14)  # 会触发bug

# 安全的代码
font = QFont()
font.setPointSize(10)  # 使用setPointSize作为替代

方案2：避免在样式表中设置font-size

/* 不安全的样式表 */
QToolButton {
    font-size: 14px;  /* 会触发bug */
}

/* 安全的样式表 */
QToolButton {
    /* 移除font-size设置 */
}

技术分析

问题根源

这个bug似乎与PySide6 6.10.1+版本中字体处理逻辑的变化有关。当鼠标离开QToolButton时，样式表的状态切换过程中，字体大小被错误地设置为-1，触发了Qt的字体验证机制。

组件特异性

为什么只影响QToolButton？：

QToolButton通常用于工具栏，可能有不同的样式表处理逻辑

社区反馈

由于Qt官方的bug跟踪系统需要商业权限，目前无法直接报告此bug。建议开发者：

使用本文提供的临时解决方案
在社区论坛中分享此问题
关注PySide6的后续版本更新

结论

虽然这个bug似乎没啥影响，只会在控制台出现提醒，但通过使用setPointSize替代setPixelSize和优化样式表设置或使用低于6.10.1版本的包，可以完全避免这个问题。

本文档基于实际测试和代码分析，适用于PySide6 6.10.1+版本。如有更新或修复，请关注PySide6官方发布说明。

在文件夹右键菜单添加cmd管理员、终端(powershell)管理员

Tue, 19 Aug 2025 00:00:00 GMT

右键菜单创建用管理员打开cmd

将代码复制到txt，并修改后缀为.reg，然后双击执行

Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\Directory\shell\AdminOpenCmd]
"Icon"="cmd.exe"
@="管理员打开命令提示符"

[HKEY_CLASSES_ROOT\Directory\shell\AdminOpenCmd\command]
@="PowerShell -windowstyle hidden -Command \"Start-Process cmd.exe -ArgumentList '/s,/k, pushd,%V' -Verb RunAs\""

[HKEY_CLASSES_ROOT\Directory\Background\shell\AdminOpenCmd]
"Icon"="cmd.exe"
@="管理员打开命令提示符"

[HKEY_CLASSES_ROOT\Directory\Background\shell\AdminOpenCmd\command]
@="PowerShell -windowstyle hidden -Command \"Start-Process cmd.exe -ArgumentList '/s,/k, pushd,%V' -Verb RunAs\""

右键菜单创建打开终端管理员

将代码复制到txt，并修改后缀为.reg，然后双击执行，想要图标正常显示就修改icon路径为正确的地址

Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\Directory\shell\PowerShellAdmin]
@="终端管理员"
"Icon"="C:\Program Files\WindowsApps\Microsoft.WindowsTerminal_1.22.12111.0_x64__8wekyb3d8bbwe\WindowsTerminal.exe"

[HKEY_CLASSES_ROOT\Directory\shell\PowerShellAdmin\command]
@="powershell.exe -Command \"Start-Process wt.exe -ArgumentList '--window 0 --startingDirectory \\\"%V\\\"' -Verb RunAs\""

[HKEY_CLASSES_ROOT\Directory\Background\shell\PowerShellAdmin]
@="终端管理员"
"Icon"="C:\Program Files\WindowsApps\Microsoft.WindowsTerminal_1.22.12111.0_x64__8wekyb3d8bbwe\WindowsTerminal.exe"

[HKEY_CLASSES_ROOT\Directory\Background\shell\PowerShellAdmin\command]
@="powershell.exe -Command \"Start-Process wt.exe -ArgumentList '--window 0 --startingDirectory \\\"%V\\\"' -Verb RunAs\""

噬界轮回

Mon, 18 Aug 2025 00:00:00 GMT

这是我的一个梦，描述后让AI总结后的结果，可能是跑团后遗症（

核心设定：

宇宙级威胁 - 索拉纳克斯 (Solarnax)
- 本质： 行星寄生体，形态为熔岩血肉构成的巨花。以地核能量为食，释放孢子进行宇宙级繁殖。
- 生命轮回：
  - 寄生扎根： 孢子侵入行星，建立根系网络，形成遗迹节点（花雕像），缓慢吸收能量，制造熔岩魔物。
  - 核心复苏： 必须取回 “地核之种”（前轮毁灭凝聚的力量核心/钥匙）方能完全苏醒。
  - 毁灭形态： 融合“地核之种”后，化身移动火山，释放熔岩射线，加速吞噬行星。
- 特性： 冰冷贪婪的意识引发地质剧变、环境熔岩化、生物畸变与精神污染（低语诱发疯狂）。
地核之种 (Core Seed) - 赤红珠子
- 本质： 索拉纳克斯的力量核心与生命精华。
- 作用：
  - 绝对钥匙： 索拉纳克斯进入毁灭形态的唯一必需品。
  - 禁锢之物： 被行星守护力量剥离，禁锢于 CoC 侧遗迹。禁锢破坏（男主取珠）引发首次全球扰动。
  - 定位信标： 索拉纳克斯持续追踪其位置。
  - 力量增幅器： 融合瞬间赋予索拉纳克斯碾压性力量（秒杀蜈蚣，引发末日）。
行星守护者 - “基岩守卫” (Bedrock Warden) - 蜈蚣巨兽
- 本质： 星球意志/失落文明创造的终极防御兵器。机械生物复合体，散发地脉蓝白光。
- 使命： 绝对敌对索拉纳克斯。长期休眠封印于 DND 遗迹岩壁，与节点对峙。职责：摧毁节点、阻止核心回收、保护星球。
- 状态： 漫长岁月中严重受损。禁锢破坏与节点活化将其惊醒，进行绝望反击。
- 结局： 为履行职责，在索拉纳克斯融合核心后仍拼死攻击，被碾压性力量重创瘫痪。
星核回声 (Echo of the Core) - 小女孩
- 来历： 星球意志/失落文明创造的“火种”与“钥匙”。星球生命能量与抗争记忆的具现化（类精灵外貌为亲和体现）。
- 作用：
  - 活体抑制器： 在 DND 遗迹中抑制节点完全活化。
  - 信息库： 承载索拉纳克斯弱点、蜈蚣操控方法、失落知识（加密）。
  - 守护者接口： 与“基岩守卫”本源相连，是其修复、激活、增幅的唯一桥梁。
  - 情感核心： 对男女主（尤女主）的依赖是唤醒力量、打破封闭的关键。
穿越本质：
- 玩家意识与异世界角色的强制融合。拥有完整玩家记忆与角色记忆/能力。
- 体验： 灵魂撕裂般的痛苦，记忆混乱，角色本能深刻影响行为（非“扮演游戏”）。玩家思维体现为分析方式与跨世界观知识，非轻浮态度。

关键 NPC (助力/世界观延伸)：

核心原则：

符合世界观： 紧密贴合熔岩末世、古代文明遗迹、克苏鲁式宇宙恐怖与 DND 奇幻的融合设定。
有限介入： 行星吞噬者级别的威胁过于宏大，任何个体“大能”直接出手解决核心问题都会削弱主角团的牺牲和故事张力。他们的帮助应是间接的、有代价的、或专注于生存与重建。
严肃基调： NPC 的动机和行为应符合末日的残酷现实，避免轻浮的“冒险者”心态。
服务于主题： 强化守护、牺牲、轮回、文明兴衰的主题。

NPC 角色设计：

“灰烬先知”伊戈·石语者 (Igor Stonespeaker) - 种族：灰矮人 (Duergar) / 职业：牧师 (地元素领域) 或符文贤者
- 背景与动机： 伊戈并非地表居民。他来自被索拉纳克斯早期活动（熔岩流、地震）严重威胁的深层地下城邦。灰矮人精通地质与锻造，对大地脉动极其敏感。伊戈是城邦中最敏锐的“石语者”，他能“聆听”岩石的痛苦和低语。他感知到了索拉纳克斯的苏醒带来的毁灭性威胁，这威胁远超地下城邦过往遭遇的任何灾难。他被迫离开安全的幽暗地域，来到危险的地表寻求线索或盟友，试图为他的族人找到一条生路。
- 如何出现：
  - 彩蛋/信息源： 在男女主安顿的小镇，伊戈可能伪装成一个不起眼的矿石商人或铁匠学徒（观察男主的锻造技术）。他暗中收集关于遗迹、地震、熔岩魔物的信息，偶尔会透露一些关于“地底深处传来痛苦咆哮”、“岩石在恐惧中颤抖”的晦涩预言。
  - 助力： 灾难爆发后，伊戈可能利用他对地质结构和地下通道的非凡知识，为男女主小队提供一条穿越熔岩地貌、避开最危险区域、甚至找到被掩埋的“基岩守卫”残骸的相对安全路径（他知道一些古老或自然形成的地道）。他提供的帮助基于生存本能和对威胁的共同认知，而非无私援助。他可能要求男女主在找到对抗索拉纳克斯的方法后，分享信息给他的族人。
- 作用：
  - 引入地下世界的视角，拓展世界观。
  - 提供关于索拉纳克斯活动（根系网络扰动）的早期预警或侧面印证。
  - 在逃亡和寻找蜈蚣的关键阶段提供实用的地理导航。
  - 强化“整个星球生命都在威胁下挣扎”的宏大感。
  - 形象： 苍老、坚韧、皮肤如同被烟熏过的岩石，眼神锐利而充满忧虑，穿着实用的矿石色皮甲，随身携带刻满符文的矿石和水晶。话语简洁、直接，带着灰矮人特有的粗粝和务实。
“远行者”艾莉娅·星辉 (Aeliah Starwhisper) - 种族：月精灵 (Moon Elf) / 职业：德鲁伊 (星辰结社) 或法师 (预言学派)
- 背景与动机： 艾莉娅并非本地精灵社群成员。她是一位古老的、追寻失落预言和星空指引的“远行者”。她长久以来在星象中观测到代表“生命之绿”与“毁灭之红”的星辰轨迹交织，预兆着巨大的灾难轮回。她追踪预言来到这片区域，在灾难爆发前就已在遗迹外围或偏远山林中观察。她的动机是理解预言、记录事件、并尽可能保存生命的火种。她代表自然与星辰的秩序对混沌吞噬的抗争。
- 如何出现：
  - 信息源/观察者： 可能在男女主刚到小镇时就作为一个神秘的旅人短暂出现，留下一些关于“星辰低语警示”、“古老循环即将闭合”的隐晦话语。或者在遗迹第一次震动后，出现在遗迹附近进行占卜或记录。
  - 有限助力： 灾难爆发后，艾莉娅可能在逃亡人潮中运用她的自然魔法（非战斗型），如安抚惊恐的动物引导逃亡路线、净化被污染的小水源、或利用星象在浓密火山灰中短暂指引方向。她的帮助是群体性的、保护性的，而非针对主角团的核心任务。她可能认出小女孩身上的星球意志气息，但无法解读或干预。
- 作用：
  - 引入预言和星象视角，暗示轮回的必然性和宇宙尺度的观测。
  - 提供非战斗性的生存辅助（导航、净化、安抚），体现德鲁伊/预言法师在末日中的价值。
  - 作为精灵族（女主种族）的一个不同分支的代表，展示精灵对危机的反应（不是所有精灵都是战斗法师）。
  - 她的存在本身强化“大能知晓但无力阻止”的无力感，侧面烘托索拉纳克斯的恐怖。
  - 形象： 优雅而沧桑，穿着镶嵌星月图案的深色旅行长袍，手持星象仪或橡木法杖，眼神仿佛穿透时空，带着深深的悲悯和忧虑。行动从容但迅捷，如同林间微风。
“遗物守护者”卡扎·碎铁 (Kaza Ironshatter) - 种族：盾矮人 (Shield Dwarf) / 职业：战士 (守护者) 或牧师 (锻造之神贡德)
- 背景与动机： 卡扎是附近一个顽强但规模缩小的矮人要塞的代表（可能也是唯一的幸存者代表）。要塞的职责之一是守护附近山脉中一个失落文明的武器试验场或能量节点遗迹（可能与“基岩守卫”的制造者有关）。矮人世代相传守护此地的誓言，但对其真正意义已模糊。索拉纳克斯的活动严重破坏了山脉结构，威胁要塞和遗迹。卡扎肩负着调查威胁来源和保卫家园的双重使命。他代表秩序、传承与家园守护。
- 如何出现：
  - 助力/信息源： 在男女主安顿期，卡扎可能因男主精湛（或独特）的锻造技术而主动接触，交流锻造心得，并透露一些关于山脉深处“不祥震动”和“古老守卫传说”的信息。他可能带来一些从遗迹外围找到的无法解读的古代合金碎片或能量耗尽的装置残骸。
  - 有限战斗助力： 灾难爆发时，卡扎可能在城镇外围或逃亡路上组织矮人战士进行小规模、悲壮的阻击战，为平民争取时间（对抗熔岩魔物或小型根须）。他的主要目的是保护矮人平民撤离。在男女主寻找蜈蚣的路上，可能遭遇卡扎带领的矮人残兵，短暂汇合，提供一些补给、重型武器（如矮人手弩/战锤）或关于附近地形（特别是山脉结构）的实用信息。他最终目标是带领族人前往一个传说中的、更深层的地下避难所。
- 作用：
  - 引入矮人势力，体现不同种族在灾难中的挣扎与抵抗。
  - 提供关于失落文明遗迹和“基岩守卫”可能起源的实物线索（碎片、传说）。
  - 在逃亡阶段提供有限的、基于共同求生目标的战斗支援和物资补给。
  - 展现家园毁灭的悲壮，强化灾难的破坏力。
  - 形象： 典型的坚毅矮人战士，厚重的板甲伤痕累累，胡须编成辫子，手持巨盾和战锤。眼神充满决心和家园被毁的怒火，言谈直接、粗犷、重承诺。
“无形之网”主脑 (The Unseen Weaver) - 种族：夺心魔主脑 (Illithid Elder Brain) / 存在：心灵集合体
- 背景与动机： 一个隐秘的夺心魔殖民地（位于极深的地下洞穴或与幽暗地域相连的缝隙）同样受到了索拉纳克斯的威胁。熔岩流逼近、地脉能量紊乱干扰了灵能网络、索拉纳克斯的精神低语对灵吸怪也是巨大的污染。主脑的动机纯粹是生存和保全殖民地。它对索拉纳克斯的本质（宇宙寄生体）有更理性的认知（通过吸收的地表生物记忆和灵能探测），但无力正面对抗。它代表冷酷理性、异形思维、信息掌控。
- 如何出现：
  - 彩蛋/信息源 (极其隐晦)： 在灾难爆发前，男女主或小镇居民可能偶尔经历奇怪的集体性短暂失忆、毫无逻辑的噩梦片段、或听到无法理解的心灵低语（被夺心魔侦察者抽取记忆或干扰）。这是主脑在收集情报。
  - 间接/有代价的助力： 在男女主最绝望或最需要关键信息时（例如，完全不知道“蜈蚣”是什么或在哪里），他们可能在梦中或精神恍惚间接收到一组破碎、冰冷、非人的图像和信息流：一幅模糊的蜈蚣图像、一个深埋的坐标、一句关于“星球核心共鸣”的非人理解。这种“帮助”伴随着剧烈的精神痛苦和潜在的理智损伤风险。主脑的目的是希望男女主找到并激活/摧毁蜈蚣，干扰索拉纳克斯，为它的殖民地争取转移时间。它绝不现身。
- 作用：
  - 引入克苏鲁式的、异形的高等存在视角，强化宇宙恐怖的氛围。
  - 在主角团完全迷失方向时，提供极其关键但充满风险的信息碎片，推动剧情（如确认蜈蚣的存在和大致位置）。
  - 体现索拉纳克斯的威胁是全域性的，连最隐秘的异形也无法幸免。
  - 提供的信息冰冷、非人、缺乏情感，与小女孩承载的星球情感记忆形成鲜明对比。
  - 形象： 永不直接出现。其影响通过精神干扰、噩梦、非人信息传递体现。代表一种纯粹的、异质的宇宙存在。
“沉眠之鳞”萨尔戈斯 (Sargoth the Slumbering Scale) - 种族：远古金龙 (Ancient Gold Dragon) / 状态：深度魔法休眠
- 背景与动机： 萨尔戈斯是这片土地传说中的守护者，曾在上古时期对抗过巨大的邪恶。漫长的岁月和巨大的消耗让它陷入了极其深度的、近乎永恒的魔法休眠，盘踞在群山之巅或地脉交汇处的次元空间内。将男女主灵魂召唤至此作为破局的变数。它代表古老的力量、沉睡的守护者、以及“大能并非万能”的现实。
- 如何出现：
  - 背景/彩蛋： 只在传说、残破壁画或像艾莉娅·星辉这样的预言者口中被提及。“当群星泣血，大地核心被噬，沉眠之鳞或将颤动…” 是流传的古老箴言。
  - 结局：事件平息后将男女主拉入自己的空间，解释因果，让男女主做出抉择，选择是否留下。
- 作用：
  - 满足“大能”存在的设定，但明确展示其无法直接介入，强化主角团行动的必然性和孤立无援感。
  - 提供一种悲壮的史诗感：古老的守护者已力不从心，新的守护者（主角团、蜈蚣、小女孩）必须挺身而出。
  - 作为世界观的深度彩蛋，暗示更古老的历史和力量层次。

如何融入故事关键节点：

安定期 (小镇生活)： 伊戈（矿石商人/铁匠）、艾莉娅（神秘旅人）可以自然融入小镇背景，提供零碎信息和世界观铺垫。卡扎可能来访交流锻造或警告震动。夺心魔的影响作为诡异事件偶尔发生。萨尔戈斯存在于传说中。
灾难爆发 (逃亡初期)： 卡扎和他的矮人战士可能在城镇外围或主要逃亡路线上进行悲壮的阻击战，男女主可能目睹或短暂得到其掩护。艾莉娅可能在人群中施展群体性自然魔法辅助（净化水源、安抚人群/动物）。伊戈可能主动找上男女主，提供地下通道信息（如果他认为他们知道更多内情）。
寻找蜈蚣 (关键任务)： 伊戈的地质知识成为找到被掩埋蜈蚣位置的关键助力（他知道哪些熔岩流冷却快，哪些岩层可能形成庇护空间）。在完全迷失方向时，夺心魔主脑可能送来冰冷的关键坐标或蜈蚣图像碎片（伴随精神痛苦）。卡扎的矮人残部可能在路径上汇合，提供补给和地形信息，并分担一些小型熔岩魔物的骚扰。
最终决战/结局： 所有 NPC 的助力在找到蜈蚣后基本结束。他们的命运：
- 伊戈： 可能在引导完路径后，选择返回地下寻找族人，或消失在混乱中，生死未卜。
- 艾莉娅： 继续在幸存者中运用自然魔法帮助重建和维持微弱的生态平衡，记录着这场浩劫。
- 卡扎： 带领幸存的矮人（可能损失惨重）前往深层避难所，延续矮人火种。
- 夺心魔主脑： 在送出信息后，其精神干扰消失，殖民地可能已转移或覆灭，成为永远的谜。
- 萨尔戈斯： 那一声遥远的龙吟或震动后，重归死寂的沉眠。它的传说增添新的篇章。
结局 (余烬新生)： 男女主在重建中，可能会遇到艾莉娅在净化一片焦土，或听到关于矮人在地下建立新家园的传言。伊戈和卡扎可能再无消息。夺心魔和金龙则彻底成为背景传说的一部分。这些 NPC 的存在，让男女主知道他们并非世界上唯一的幸存者和抗争者，但核心的牺牲与守护的重任，依然沉重地落在他们肩上。

效果：

世界更生动： 展现了不同种族、势力、个体在灭世危机下的反应和挣扎。
助力更合理： NPC 的帮助是有限的、有动机的（多为自保）、且符合其能力的（地质知识、自然魔法、战斗支援、信息碎片），不喧宾夺主。
基调更严肃： 所有 NPC 都笼罩在末日的阴影下，他们的行为动机严肃，没有儿戏。
主题更深化： 通过不同 NPC 的命运（牺牲、逃亡、坚守、隐遁），多角度展现了守护、牺牲、文明火种延续的主题。金龙的存在更凸显了主角团行动的凡人英雄主义色彩。
彩蛋有趣： 夺心魔、远古金龙等经典 DND 元素的融入，为熟悉设定的读者/玩家提供会心一笑或深度挖掘的空间。

核心情节细节 (强化沉浸感与严肃性)：

遗迹崩塌 (双线)：
- CoC 侧 (男主取珠)： 珠子离架 → 空间哀鸣，支架熔断，血光应急灯亮 → 花雕像内熔岩涌动，非人咆哮 → 结构崩溃如巨兽撕咬。男主搏命寻车，驾驶舱玻璃爆裂。
- DND 侧 (女主)： 大地抽搐如巨兽痉挛，符文明灭 → 窒息性能量威压远超魔物 → 小女孩蜷缩发光，微弱偏转落石 → 抱起时触感冰凉稳定。
路口相遇与穿越：
- 错车： 工程车破烟冲出，刺目车灯 → 女主原始恐惧，刹车刺耳，尘土扑面。
- 穿越： 灵魂重锤，记忆碎片暴力灌入 → 恶心眩晕 → 男主肌肉记忆锁死刹车，指节发白；女主护紧女孩，指尖凝冰 → 眼神交汇：混乱、警惕、茫然 → “上车！”（嘶哑求生吼）→ 女主逻辑求生本能压倒未知恐惧，滚爬上车。
安定期 (沉重现实)：
- 语言/生存： 男主语言挫败 → 误解、焦虑、孤立 → 打铁是发泄、掌控、求生技能（汗、灼伤、酸痛）。
- 秘密/创伤： 双方隐藏玩家身份 → 角色本能与玩家思维冲突（男主中文梦呓惊醒；女主英文咒骂规则）→ 异常归咎“穿越创伤”，沉默观察 → 讨论用词：“遗迹遗物”、“可怜孩子”。
- 照顾女孩： 沉重负担 → 夜惊、无意识能量失控（物品翻飞/水结冰）、对炉火异常反应 → 疲惫、担忧、无助 → 微小进步（认名）是黑暗慰藉。
- 珠子异常： 箱子周期性炽红烫手，锁扣熔凝 → 男主灼渊噩梦与低语幻听 → 双方心照不宣远离。
身份揭露 (压力下的同盟)：
- 触发： 女孩能量爆发 → 星球毁灭幻象 + 蜈蚣战斗碎片闪现 → 房间狼藉（冰晶焦痕）。
- 对话 (沉重疲惫)：
  
  男主 (揉太阳穴，沙哑)：“…那怪物…我在更远的未来见过…只有石头…凝固岩浆。” 女主 (抱紧女孩，指尖凝寒)：“未来？…艾莉娅记忆没有。但那‘花’…感觉像规则书里最古老的邪恶。冰冷…饥饿…吞噬。” 男主 (猛抬头)：“规则书？你…？” (未言“玩家”) 女主 (疲惫点头)：“是。我们被扔进了最残酷的‘真实’游戏。为了她，也为我们…必须共享一切。”
珠子被夺 & 末日降临：
- 突袭： 存珠房间 → 地面赤红软化 → 熔晶根须毒蛇般刺破地板箱体 → 硫磺窒息 → 根须卷珠。
- 夺珠： 珠根接触 → 猩红爆闪 → 室温飙至碳化 → 地心满足咆哮 → 根须缩地，留熔融深洞。
- 爆发： 数秒死寂 → 大地连绵哀嚎断裂 → 山体被巨手撕开 → 血肉熔岩巨花裹岩浆洪流破山 → 花蕊裂 → 暗红空间扭曲射线扫林化火海 → 火山灰云蔽日 → 城镇瞬间地狱。
决战：蜈蚣、连接与湮灭：
- 寻蜈蚣： 熔岩灰烬中 → 女主透支生命开冰径 → 男主凭工程知识判地质 → 女孩透明化指引。
- 蜈蚣惨状： 半埋熔岩碎石 → 躯干多处断裂，淌琉璃蓝血 → 关键关节熔毁 → 头甲巨大咬痕 → 独眼黯如残烛 → 断续痛苦嗡鸣。
- 连接修复： 女孩扑触蜈蚣头甲 → 全身翠绿/蓝白星芒爆闪 → 光脉延伤口 → 碎甲弥合，水晶能构生长 → 核心重燃耀目蓝白光 → 女孩光点化自指尖始。
- 最终冲锋： 修复蜈蚣（滞涩但决绝）→ 撼天战吼 → 撞熔岩 → 载男主（携高爆/扰乱器）或掩护其装甲车 → 迎毁灭射线冲锋 → 女主七窍流血 → 凝不断熔穿的巨型冰盾 + 释极地深寒脆化索拉纳克斯。
- 湮灭：
  - (方案 A) 冰盾脆化刹那 → 蜈蚣蓝白光炮直击核心 → 核心蛛网裂，能量狂泄。
  - (方案 B) 蜈蚣硬扛射线 → 男主抵近安装/启动装置 → 能量乱流爆炸。
- 牺牲： 核心爆炸 → 索拉纳克斯崩碎哀嚎 → 蜈蚣以身覆挡冲击 → 汽化蓝白晶尘 → 男主气浪掀飞濒死 → 女孩望男女主 → 无声“爸妈”唇形 → 化星尘光点洒落焦土 → 女主魔力耗尽昏迷。

结局：余烬中的守望者：

灾难止息： 索拉纳克斯残骸如崩山沉凝岩。核心碎屑湮灭或裂块黯淡。熔岩止，灰云沉。毁灭终止。
伤痕： 男主（残躯）寻得女主（昏迷）→ 相扶立废墟 → 面无喜色，唯余疲惫、悲怆、麻木 → 男主掌中紧握女孩所化温润绿光微晶 → 远方蜈蚣晶尘如蓝雾笼敌骸。
未来： 为少数幸存者与真相持有者 → 男主以工程/锻造，女主以残存自然魔法/草药 → 引领焦土求生 → 立营地，集物资 → 绿晶为碑，祭逝者与微光 → 索拉纳克斯残骸永为警钟 → 肩负重建、守秘、净世之责。结局定格二人立简陋营地，远眺敌与守护者共铸之沉默废墟群。轮回破，代价至惨，前路维艰。焦土嫩芽 = 微小顽强之望。
抉择：古龙给予选择，男女主选择不得而知。

整合要点强化：

逻辑闭环： 珠子是核心钥匙 → 取珠破禁锢 → 引节点活化/蜈蚣醒 → 夺珠归位 → 索拉纳克斯获完全体 → 末日降临 → 破局需毁珠/断链 → 借蜈蚣力 + 女孩牺牲达成。
严肃沉浸： 全流程强调生理痛苦（头痛、灼伤、撕裂感）、心理重压（恐惧、孤立、创伤）、环境残酷（硫磺、热浪、崩塌、射线蒸发）。去除游戏术语调侃。
角色驱动： 行动源于生存本能、守护责任（对女孩、彼此）、探求真相。玩家知识用于锻造、工程分析、魔法理解、信息整合。
NPC 定位： 非救世主。提供有限、有偿、符合专长的助力（通道、群体辅助、信息碎片、阻击补给）。深化“世界受难”感。
主题凝聚： 毁灭轮回（索拉纳克斯）、牺牲（蜈蚣、女孩）、守护（男女主、NPC）、沉重新生（焦土嫩芽）贯穿始终。
细节锚点： 关键场景以感官冲击（声音：金属扭曲、地心咆哮、刹车刺耳；触觉：箱子炽红、女孩冰凉、熔岩热浪；视觉：猩红爆闪、蓝白晶尘、绿光微晶）强化记忆。

Ⅰ. 核心角色设定

1. 穿越者主角团

角色	肉身/记忆来源	玩家意识特质	能力/特质	创伤印记
男主（雷克斯）	CoC 人类调查员（肌肉猛男）	工程师思维/调查员逻辑	载具操控、机械维修、地质分析；强耐痛体质	掌心灼伤老茧；硫磺噩梦症
女主（艾莉娅）	DND 高等精灵法师	策略型桌游玩家	冰系魔法专精（霜冻新星 → 极地深寒）、精灵植物沟通；古文字破译	魔法反噬冻疮；护崽本能（对女孩）
星核回声（无名）	星球意志具现化（类精灵幼体）	无	抑制索拉纳克斯节点活化；修复/增幅基岩守卫；释放星球净化力场	能量失控致局部结冰；索拉纳克斯恐惧症

2. 行星级存在

存在名	形态	本质	核心能力	状态
索拉纳克斯	熔岩血肉巨花（高逾山峰）	宇宙寄生体，以地核能量为食	熔岩射线（物质湮灭）、根系寄生、精神污染低语	核心湮灭 → 残骸化为熔岩山脉
基岩守卫	机械生物蜈蚣（蓝光晶体甲）	星球意志锻造的终极兵器	地脉能量炮、力场护盾、大地震颤	终战自毁 → 残躯化蓝晶尘
萨尔戈斯	鳞片剥落的远古金龙（虚影）	上古守护者，执掌部分因果律	时空撕裂、预知碎片、神力具现化（金钟/沙漏）	沉眠将逝 → 现身耗最后神力

Ⅱ. 世界观架构

1. 核心法则

索拉纳克斯轮回：孢子漂流 → 寄生扎根（建遗迹节点）→ 核心复苏（需地核之种）→ 毁灭形态（灭世）→ 凝新种
穿越机制：萨尔戈斯以因果律裂痕抓取异界玩家灵魂，强制融合本界肉身，引发 “灵魂撕裂后遗症”（记忆混乱、本能冲突）。
能量克制： 冰魔法→ 脆化熔岩结构｜星球绿光→ 净化污染｜地脉蓝光→ 驱动守护兵器

2. 地理志

区域	特征	关键地点	威胁等级
焦土废壤	索拉纳克斯肆虐后的主舞台，熔岩冷却为黑曜石地貌	残破城镇“黑炉堡”、蜈蚣陨坑	★★★★★
幽邃地脉	错综地下洞穴，地热紊乱	灰矮人城邦“深石之喉”、夺心魔殖民地（已湮灭）	★★★☆
沉龙山脉	萨尔戈斯沉眠地，时空畸变区	时光乱流峡谷、龙鳞化石林	★★☆
净化绿洲	绿晶影响区，生态缓慢复苏	艾莉娅的祭坛“新芽林地”	☆

Ⅲ. NPC 图鉴（助力/信息网）

NPC	种族/职业	隶属势力	功能	终局	标志物
伊戈·石语者	灰矮人符文贤者	深石城邦	提供地脉通道/索拉纳克斯根系图谱	携情报闭锁地下城	晶岩地质锤
艾莉娅·星辉	月精灵星辰德鲁伊	自然之环	群体净化/预言碎片	建绿晶祭坛引导农耕	星纹橡木杖
卡扎·碎铁	盾矮人守护者战士	山峦要塞	熔岩阻击战/地形情报	遁地前留《地脉异常报告》	秘银塔盾
无形之网	夺心魔主脑	灵吸怪殖民地	精神传递蜈蚣坐标（伴理智损伤）	殖民地湮灭成谜	脑波回响水晶
萨尔戈斯	远古金龙	上古守护者	揭示穿越真相/赠归乡沙漏	赠沙漏后虚影消散	因果金钟（虚影）

Ⅳ. 剧情全纲（关键节点细节）

序幕：轮回之始

CoC 线：雷克斯取赤珠 → 珠离架 →支架熔断喷溅火花→ 遗迹穹顶裂 → 熔岩魔物苏醒 → 搏命驾工程车冲入烟尘。
DND 线：艾莉娅战熔岩怪 → 地颤 → 岩壁“蜈蚣浮雕”剥落 → 基岩守卫惊醒攻节点 → 携哑孩奔逃 →路口车灯刺破烟幕。
融合时刻：刹车尖啸中双魂撕裂 → 雷克斯指骨捏碎方向盘皮套→ 艾莉娅冰晶自发护体→ 嘶吼“上车！”。

中章：暗涌之栖

黑炉堡日常：
- 雷克斯打铁 →汗滴入火炉嗤响→ 教矮人锻钢淬火术 → 藏珠箱锁扣周期性熔红。
- 艾莉娅采药 →指尖抚过枯焦草叶结霜→ 破译矮人碑文“沉鳞缚时锁”。
- 女孩涂鸦 →炭笔画蜈蚣与沙漏→ 夜惊冻裂陶罐 → 艾莉娅彻夜搂抱安抚。
身份揭露：珠箱异动引女孩幻象爆发 → 雷克斯冲入吼“关掉那鬼东西！”→ 艾莉娅冰封房间 →背抵门喘息：“你…知道规则书吗？”

高潮：灭世终战

夺珠：熔晶根须刺穿地板如巨矛→ 卷珠瞬缩 → 地洞喷硫磺蒸汽 → 全镇犬吠。
灾变：死寂 →远山崩裂喷血色岩浆→ 索拉纳克斯巨花破峰 → 暗红射线扫过 → 森林汽化火海。
赴死之路：
- 伊戈指路 → 穿越熔岩瀑布后的地裂。
- 主脑传信 → 艾莉娅鼻血滴落冰径。
- 见蜈蚣残躯 → 甲缝渗蓝光如泪。
牺牲：
- 女孩扑蜈蚣 →绿光脉络点亮万节→ 身化星尘。
- 蜈蚣载雷克斯 →撞入花心核心→ 自爆蓝光吞没赤珠。
- 艾莉娅跪地 →七窍流血凝百米冰盾→ 挡爆炸冲击波。

终幕：古龙之问

焦土余烬：雷克斯断臂握绿晶 → 艾莉娅白发覆霜 →金光聚为古龙虚影。
因果揭示：

脑内轰鸣：“吾裂时空引汝魂…此为破死局唯一落子。” （闪现画面：电脑前掷骰 → 金爪撕屏幕）
沙漏赠礼：悬浮双色沙漏 →蓝砂（异界）/金砂（原乡）→ 古龙鳞片剥落如雨。
抉择凝滞：
- 雷克斯独白：“回去…当铁匠雷克斯，还是废土雷克斯？”
- 艾莉娅掌心绿晶搏动→ 浮现女孩残影微笑。
- 双手覆沙漏 → 沙悬停 → 镜头拉远：蓝晶尘萦绕敌骸，窝棚炊烟没入灰雪。

Ⅴ. 核心伏笔与意象

要素	埋设点	回收点/象征	续作方向
绿晶搏动	终战女孩所化	抉择时温暖搏动 → 净化地裂	索拉纳克斯根系复苏预警
沙漏涂鸦	女孩安定期炭笔画	呼应古龙沙漏 → 暗示其预知力	时间线变动可能
龙鳞化石	沉龙山脉地表散落	萨尔戈斯消亡证明	新守护者锻造材料
《地脉报告》	卡扎遗留笔记	载“熔岩下根须蠕动”	地下探险主线
冰魔法反噬	女主每用高阶魔法留冻伤	终局白发 → 力量代价可视化	能力黑化风险

终极主题句： “归乡的沙漏另一端，盛满未赎之罪与未竟之责——而绿晶在焦土中的每一次搏动，都是世界对守护者的拷问。”

Ⅵ. 设定集附录

索拉纳克斯生态链

衍生物	特征	弱点
熔岩爬行者	犬形，岩浆核心	冰魔法冻结核心
根须穿刺者	潜地突袭，晶体外壳	震击破坏关节
低语孢云	悬浮气团，诱发疯狂	强风驱散

地核之种数据

直径：3cm
温度：常态 40℃→ 激活瞬间 ≥2000℃
能量读数：湮灭前峰值=5 颗核弹当量
精神污染：接触者 SAN 值每日降 1d4

守护者残骸利用表

材料	来源	用途
蓝晶尘	基岩守卫残躯	能量电池/净化器核心
绿晶碎片	星核回声结晶	治愈药剂/污染探测器
古龙鳞粉	萨尔戈斯消散落鳞	时空稳定锚点

用Astro在github上搭建博客

Mon, 18 Aug 2025 00:00:00 GMT

想搭建博客是想做一个MoonCancer的文档，用在线文档还是有点麻烦感觉，想要一个地方能集中管理，而且也想有一个地方来放我的经验和想法，于是这个博客就成了。

前言

为了搭建这个博客也是折腾了一两天，先是做功课，有什么框架模版，那些平台上能搭建种种。一开始我是想用Hexo的这个主题的，也是先尝试搭建了一下，按着步骤很快成功了 ::github{repo="saicaca/hexo-theme-vivia"} 但是就在这时我注意到作者说这个仓库不更新了，建议使用新的模版，看了下这个确实比老的好，虽然框架不一样 ::github{repo="saicaca/fuwari"} 但才刚刚开始，还是一开始就用新的比较好，于是又开始捣鼓这个模版，有了之前的经验，很快就在本地测试成功了,但部署遇到些问题，最后折腾到半夜终于成了。

在这之前看了一篇博客手把手搭建 Astro + Github Pages + Github Actions，想看具体操作可以看一下，和我用的同一套模版也是部署在GitHub，我刚在他博客下面评论完就发现部署成功了，虽然在搭建上面没帮上忙，但里面还是提到了如何添加浏览量和评论，我也就顺便借鉴了一下。

说了这么多放上我遇到的问题和一些经验吧。

部署配置

这是我踩的一个大坑，在官方文档中提到，astro.config.mjs配置文件中base字段要填仓库名称，但这里指的是GitHub项目网站要填，个人网站是不用填的，在这之前我看过视频还有一些博客说过，个人或组织网站的域名就是本身，这里官方文档没有特别说明导致我来回采坑。

import { defineConfig } from 'astro/config'

export default defineConfig({
  site: 'https://astronaut.github.io',
  base: 'my-repo',
})

我想搭建的也是个人网站，所以我觉得base是不用填的，实际上一开始测试的时候就是没填，但我测试的时候是刚fork来的，这时部署那就是项目网站，是要填base的，我部署上没有样式，给我整蒙了，怀疑是没加basse导致的所以又把base给加上，但同时我迁移到了个人网站仓库部署了，结果显示出来还是一样没有样式，这下给我整不会了。几经折腾还是回到原点，怀疑是base设置问题，我还原回了'/'，就推送等自动部署然后洗澡去了，洗完澡回来刷新一看，终于成功了，这时已经快凌晨两点了，好在能安心睡觉了。

草稿切换

在md文章的文件头里有一个选项draft，就是用来判断是否是草稿的(吃了没有文化的亏，没查意思之前都不知道)，一开始我的文章设置的都是true，测试的时候都在发布后却没有，也没用看到哪里有这个字段的说明(~~其实示例文章里就有~~)，结果就是发布后文章不见了。设置成false重新发布就好了。模版自带的几篇文章也不用删设置成true就行了。

透明背景

可以看到我的导航栏和背景是半透明的，我觉得导航栏挡道banner了不舒服，就想调整成半透明的，但模版没有提供这个选项，只能自己想办法了。

很简单，<kbd>F12</kbd>打开开发工具，选取导航栏定位到导航栏代码，在右侧的样式里找到颜色的配置项，关闭或调整颜色值看效果就知道那个是需要修改的颜色了，我用的这个模版使用的颜色名称是--card-bg 然后在src\styles\variables.styl中找倒这个变量名称，修改成带透明度的颜色值就行了，思路是这样，我这里修改的值为

--card-bg: white(0.8) rgba(24 29 36 0.8)

原本的oklch形式加上透明度就错误，我直接转换为agba了，不同模版可能不一样，黑白模式的值可能是分开存的，这里存在一起的。

MoonCancer 更新记录

Sun, 17 Aug 2025 00:00:00 GMT

2026年7月7日v2.6.1

1.新增资源更新提醒 2.优化部分逻辑

2026年7月5日v2.6.0

1.新增MuMu模拟器15和雷电模拟器14支持 2.升级OCR模型和引擎 3.修复任务异常处理逻辑，优化弹窗提示文案 4.优化自动开机启动配置逻辑 5.修复部分已知bug，优化用户交互体验

2026年6月27日v2.5.5

1.适配国服日常服冠位战切换

2026年6月24日v2.5.4

1.新增MuMu模拟器保活检测与自动关闭 2.优化多血条检测 3.优化活动点数检测和显示效果 4.优化冠位助战选择

2026年5月22日v2.5.3

1.优化冠位助战识别 2.优化脚本逻辑 3.修复杀死敌人的部分问题

2026年5月4日v2.5.2

1.新增开机自启动 2.新增记住窗口位置 3.优化过主线

2026年5月1日v2.5.1

1.修复models目录不存在问题 2.修复过主线在进关卡前卡住问题 3.添加国际化多语言支持 4.优化界面效果和文本，修复部分异常

2026年4月13日v2.5.0

1.新增计划任务，支持关机、休眠、挂机 2.新增OCR推理引擎切换 3.优化消息通知，修复win10没有正常通知的问题 4.优化界面效果，修复部分异常 5.优化战斗结果处理逻辑

2026年3月22日v2.4.10

1.优化助战选择，不存在加成礼装时提前刷新 2.连续战斗增加茶壶检测 3.优化启动模拟器，避免模拟器占用MoonCancer文件夹 4.优化修改，增加稳定性

2026年3月6日v2.4.9

1.优化首通关卡的关卡识别 2.过主线，清理free，首通关卡可以根据设置战斗次数结束 3.修复朗读失效 4.优化满羁绊识别

2026年1月30日v2.4.8

1.优化MuMu模拟器检测，避免模拟器bug（MuMu最新版已修复） 2.优化茶壶和风暴罐开关设置

2025年12月31日v2.4.7

1.升级rapidocr=3.4.5，PySide6-Fluent-Widgets=1.10.5 2.修复国服更新导致的修改失效

2025年12月24日v2.4.6

1.优化部分逻辑 2.修复日服修改失效

2025年12月5日v2.4.5

1.优化MuMu连接，修复连接遗留问题 2.优化助战选择和吃苹果以及部分问题 3.更新主页banner 4.适配日常术阶冠位战

2025年11月23日v2.4.4

1.修复修改器自动计数错误 2.优化助战选择 3.更改更新检测和逻辑

2025年11月20日v2.4.3

1.适配弓阶冠位战，优化冠位战进入流程 2.优化大量敌人时的修改逻辑，减少无效查找 3.优化助战选择，可以有多个识别候选，支持冠位助战双礼装识别，具体规则请查看说明文档 4.优化部分逻辑，减少可能出现的问题

2025年11月09日v2.4.2

1.优化战斗逻辑、指令卡选择，避免部分情况卡死 2.优化茶壶检测，一开一关也能保持一致性 3.优化日常任务白纸本查找，避免部分情况卡死 4.优化点击滑动操作，尽量保持不同连接方式的操作一致性

2025年10月30日v2.4.1

1.更改优化ui，切换配置更方便，显示战斗数 2.适配日服过主线的部分情况 3.增加结束后输出战斗结果(用时、战斗数、掉落数) 4.增加检测mumu后台保活是否开启 5.优化助战选择，避免误判 6.优化模拟器连接，避免部分错误

2025年10月23日v2.4.0

1.更新主页UI，更改任务布局，优化使用体验 2.新增首通关卡，清理幕间，进阶关卡，回忆关卡，以及一切需要通关拿奖励的情况 3.适配日服杀阶戴冠战日常 4.优化代码，解决部分卡住的情况

2025年10月18日v2.3.6

1.优化日常抽免费，适配每日抽多个友情池 2.优化日常队伍确认，避免触发游戏bug 3.优化连接初始化逻辑

2025年10月8日v2.3.5

1.更新部分UI，主页脚本设置下方显示当前配置；更改任务消息框，显示芙芙跑动画 2.日常任务默认使用1号编队，避免日常用错编队（更新后记得修改编队） 3.适配两种茶壶的情况（需要保持开关一致） 4.优化代码，预防部分错误

2025年10月2日v2.3.4

1.修复启动时更新会点退出，修复启动模拟器会出错 2.修复暗色主题显示错误 3.分离UI设置和脚本设置 4.调整任务状态条，调整通知消息，优化连接流

2025年9月30日v2.3.2

1.增加多配置切换 2.修复图标右键菜单不能自动影藏 3.修复更新后在主页卡住，修复日服更新界面卡住 4.修复过主线和清理free可能卡住无法结束

2025年9月28日v2.3.1

1.精简合并设置项 2.适配日服日常冠位战 3.修复抽友情卡住 4.优化部分逻辑，增加日服更新补丁检测

2025年9月27日v2.3.0

1.优化部分脚本逻辑 2.脚本适配日服 3.增加日服助战礼装，更改礼装选择名称

2025年9月25日v2.2.2

1.优化重新启动游戏和部分脚本逻辑 2.优化自动扫描，新增搜索包名 3.新增包名设置，渠道服和其他客户端可以修改后使用

2025年9月18日v2.2.1

1.优化模拟器连接 2.优化过主线 3.增加是否使用茶壶 4.优化多处逻辑，增加稳定性 5.适配白纸化阿拉伯地区（需要通关奏Ⅲ）

2025年9月14日v2.2.0

1.增加MuMu高速连接和雷电高速连接，更快更稳定，适配更多模拟器自动搜索 2.迁移战脚本设置到主页，修改更方便，活动点数限制显示逗号分隔符 3.去掉控制台，改为在主页下方文本框显示日志 4.优化程序启动，整合优化命令执行逻辑，优化连接逻辑，优化多处代码逻辑，增强稳定性 5.增加游戏崩溃重启

2025年8月31日v2.1.6

1.过主线适配部分情况 2.修复日常在主页卡住

2025年8月28日v2.1.5

1.优化自动战斗，三名一下己方会直接使用清空血条，本轮战斗回合大于1时也能再次清空血条 2.增加过主线标志识别率

2025年8月27日

1.优化修改器，在修改前就标记地址，确保下次不会被检索到；优化己方检测，避免错误修改 2.添加暂停功能，启动任意任务后，右上角帮助旁边会出现暂停按钮，可以随时暂停了 3.优化战斗和指令卡选择逻辑，会识别多血条敌人会强化己方避免暴毙 4.在搜索修改地址期间也能暂停和结束，避免大量修改时只能等待结束或关闭程序 5.优化多处UI相关效果

2025年8月25日

1.优化修改器类增强稳定性，修复修改时某些大序号修改失败的问题 2.优化eisyou布局，修复删除错误问题 3.优化过剧情，修复不可跳过对话框卡住问题，移除跳过剧情设置，改为在开始前选择 4.修复增强alter，增加从屏幕识别信息

2025年8月22日

1.增加多模板匹配 2.解耦继续战斗判断 3.优化过剧情和自动free本 4.在过主线开始前提示是否跳过剧情 5.优化多处逻辑，增加稳定性

2025年8月21日

1.优化过剧情，解决部分环节可能卡住的问题 2.优化战斗指令卡选择逻辑 3.新增自动清理free本（We Are Free!） 4.加强修改稳定性

2025年8月20日

1.优化过剧情，采用螺旋查找 2.优化战斗指令卡选择，只有一人或全是一人的卡时释放宝具 3.新增活动点数停止，在设置里可以设置活动点数，达到即停，不限制时归零 4.新增点击帮助弹出窗口

2025年8月15日

1.优化过剧情 2.优化战斗

2025年8月12日

1.新增阅读界面，可以自主调节设置 2.新增自动主线，部分情况可能需要手动 3.优化战斗逻辑，去掉了战斗模式，现在自动选择战斗方式 4.优化UI，更新部分界面图标和文字 5.去掉超时自动搜索连接，新增超时设置

2025年7月22日

1.增加自动更新 2.优化战斗结束识别 3.修复可能吃肾结石 4.优化连接问题

2025年7月11日

1.适配白纸化第七弹，优化白纸化识别方式

MoonCancer Cancer界面说明

Sun, 17 Aug 2025 00:00:00 GMT

表格说明

表格是为了记录下查找的地址为了方便二次修改，同时也可视化展示修改了哪些位置，每次进入战斗前或者战斗结束记得清除记录，每场战斗地址不一定相同不能复用，使用旧地址修改可能导致游戏异常或闪退 位置 带6个从者，那1-6号位就是从者，带三个从者，那1-3就是从者，后面编号的都是敌人；敌人同时出场多名时，从右往左编号递增，不是同时出场时，先出场的编号靠前，按出场顺序递增；未出场的敌人也能检测到，但不同面的敌人无法检测，只有进入到下一面才会加载数据 地址 代表内存中的地址，多个地址时只有一个时候本场战斗的地址，另外的都是之前的残留，一般不会超过三个

自定义修改

根据具体需求修改数值；注意不要把数值修改的特别大，超过一定数值会导致错误或者伤害为0 修改 只修改开启项和指定的范围内的目标，例如默认的1，2就只修改1，2号位的值，要只修改一个就把值设置为一样，设置好要修改的值和范围后点击修改 :::tip 将敌人生命值修改为0能不战而胜 :::

快速修改

没有特别需求时直接使用快速修改 消除 默认情况是带六个从者，根据情况修改上场从者数量即可，运行一次只能修改当前面的敌人（包括没出场的），若第一面没有修改，二三面出现无法修改的情况，把上场从者数量加上之前面敌人数量的总和即可（考验记忆力），数量设置小于自己带的从者会导致自己从者死亡 增强 以默认值修改指定位置的从者或敌人，一般给自己用，比如2号位上光炮，每回合放宝具就行

其他说明

清除记录 建议在进入画面就清除记录，每场战斗的记录不一定通用，会干扰修改；如果想要修改时已经在战斗中了，而且还存在记录，那就先尝试用现有的记录先执行修改，如果不成功那就清除记录，这种情况下直接清除记录有可能把现在的标志给清除了导致某些位修改失败 刷新记录 手动刷新现在的记录，某些情况下数值已经修改过并记录了地址，但表格没刷新，可以手动刷新查看情况

注意由于某些原因一号位不一定能修改到，遇到了修改其他位置就行了；多血条敌人一次只能破一管血，只要血条刷新就可以再次执行血量清零的任意操作，但某些关卡有特殊机制，会导致敌人身上的buff结算出错，导致无法通关；虽然已经尽量避免的会导致错误的操作，但还是可能出现闪退或其他问题，万一出错了，可以尝试重新启动游戏或模拟器，最后手动修改时记得清空记录

祝你好运！

MoonCancer Moon界面说明

Sun, 17 Aug 2025 00:00:00 GMT

MoonCaner脚本的启动界面，点击 会赢的标签会打开我的博客

基本功能

可用左右切换当前显示的功能，使用前请先在脚本设置里设置好战斗次数，礼装类型，是否要清理剩余体力，使用茶壶等

日常任务

整个流程包括打开模拟器，启动游戏，抽每日免费友情池(可关闭)，完成每日三次白纸化或冠位战(设置中的本)，默认使用1号编队，使用前请设置好编队。也可以在主界面或者只运行了模拟器开始。每天可以直接点一下就下线，长草期也不麻烦，轻松攒石头

要自动白纸化每日，请尽量保持界面干净，保证要打的关卡已经开启，部分关卡依赖奏章Ⅱ定位（例如90⭐），所以至少要打完奏章Ⅰ，才能使用所有选项
日常冠位戴冠战请先完成对应的冠位认定战，默认进入最下方的关卡

开始战斗

自动刷各种本，主要是能连续战斗的，或是强化本(更推荐使用首通关卡)或者free本那样回到主界面右上角也有本可以点的情况。复杂的机制关可能不能正常通关，建议手动修改(Alter界面说明)根据机制来完成战斗。可以在进入战斗前的选择助战，队伍设置和进入战斗后开始，也可以在主界面选本列表开始，但要保证要刷的本在第一个位置。

过主线

自动过主线和类主线，自动完成期间的战斗，不要改变地图缩放，保持进入地图后的默认缩放，有缩放过的重新进图，保障屏幕里表示主线任务的 下一个标识存在即可点击开始，部分情况会卡住，需要手动修正，选取消跳过剧情时会自动朗读剧情，相关配置可以到Eisyou界面修改，具体说明请看Eisyou界面说明 测试到的可能需要手动干涉部分：

第四特异点 雾遮挡标志
第六特异点 风沙遮挡标志
第七特异点 提亚马特遮挡标志
终局特异点 柱子站之前剧情过完就没有标志了，要自己去把柱子战过了
LostBelt No.2 6.4关卡要求出战马修，自动编成会打乱原本编队，就不自动了，自己先编好马修吧，不想中断就一直带着
LostBelt No.5亚特兰蒂斯 11-2关卡要求出战马修，自动编成会打乱原本编队
LostBelt No.5奥林波斯 2-1、2-2、5-1、6-3、12-2关卡要求出战马修，自动编成会打乱原本编队
LostBelt No.6阿瓦隆 18-5需要手动放妖兰群体宝具，24-6需要送死
LostBelt No.7 1-2关卡要求出战马修，部分关卡会卡住，太小了找不到下一个就放大地图，ort最终战建议手动，自动可能从者不够用卡关
奏章二 中途有多选项找线索
奏章四 码头警告！！！ :::tip 这里说下我使用的方式
不想看剧情直接选择跳过
想慢慢听就选不跳过挂着
想快点看完就自己点屏幕快速浏览剧情，期间只用在有剧情时点屏幕，或者手动拖动下一个剧情点到屏幕中央，其他流程都交给脚本自动点击即可（也可以自己点下助战），这样既能快速过剧情，还有部分句子的语音强化记忆，还能自动战斗，不用自己去点战斗。我觉得挺舒服的。 :::

清理free本

自动清理free本(We Are Free!)。同样不要改变地图缩放，保持进入地图后的默认缩放，有缩放过的重新进图，进入地图就可以点开始了，第七异闻带 地图不适配，可以手动选关卡，固定三次战斗完成

首通关卡

以当前列表关卡是否已获得奖励为基准，清理幕间，进阶关卡，回忆关卡等一切需要通关拿奖励的情况

默认跳过所有剧情，想听剧情请灵活使用过主线和Eisyou，无奖励的周回本不适用只会浪费体力。
进阶关卡狼人杀等机制关可能卡关，需要手动通关；
回忆关卡部分关卡在边缘位置需要手动点一下进入关卡列表，有些关卡通关后会回到地图也需要手动点一下回到关卡列表，因为是主线关卡，所以也会遇到强制马修助战会卡住，某些自动编队的情况也可能打乱现有编队，请注意

脚本设置

设置主页运行任务的具体参数，可展开折叠，支持添加移除配置，右键可以重命名配置，支持多配置切换，切换后会结束当前任务并断开连接

战斗次数 如果拖动不精准可以键盘左右键微调，日常任务默认打三次，屯着多次的要一次打完可以直接用战斗设置次数打，过剧情除非开启清理剩余体力，不然会不停过，跟这里的战斗次数无关
清理剩余体力 开启后，所有战斗都会在战斗次数耗尽后，战斗到体力不足
使用茶壶 每次编队界面检查茶壶使用状态
苹果和助战 选择补充体力的苹果类型，选择助战礼装，支持冠位助战，具体请阅读礼装规则
活动点限制 设置活动点限制，超过就停止，不多刷浪费，不限制时设为0，没有活动点的情况不触发
抽每日友情池 开启会在日常任务打白纸化之前先抽取每日免费友情池
日常任务 选择每日刷的本，可选择白纸化地球本和冠位戴冠战，或者都不打，按需选取，但要注意是否已经开放。冠位战的情况下要把冠位认定战打了，因为默认打最后一个本，不过没打的话会自动打了，要注意一下

礼装规则

礼装最多可以候选四种，检测到其中一个就会选取
当包含活动礼装时，会默认选取第一个助战，也就是不挑助战，想要选活动礼装设置好筛选
当检测到冠位助战时，会选取满足候选列表其中两项的助战 :::tip 不想频繁修改配置可以创建多个常用配置，例如日常一个、活动一个，新建的配置会复制当前的配置，模拟器和区服没有改变只需要更改脚本设置即可 :::

日志窗口

任务结束后会输出战斗结果(用时、战斗数、掉落数)，以及结束的原因，出现问题时如果要反馈，请将完整的当前游戏画面和log截图反馈

MoonCancer Alter界面说明

Sun, 17 Aug 2025 00:00:00 GMT

:::note 这个界面提供了一个更灵活的方式修改局内数值，主要用来打圣杯战线，Cancer修改失败时，可以在这里修改，不过地址任然会记录到Cnacer界面的表格里，记得清理 ::: 添加新行用来记录修改参数 获取从者信息从屏幕识别从者名称等级生命并自动填入表格，如果识别的数字没用问题可以直接选中修改 获取敌人信息从屏幕识别敌人名称等级生命并自动填入表格，如果识别的数字没用问题可以直接选中修改 删除选中行，可以删除多行 修改选中的行，可以选择多行修改 :::tip 识别的信息可能有误，修改失败的话请仔细检查一下是否有误 ::: 名称不能为空，等级不能为空，当前攻击力和生命值选一个填就行，填进入战斗后当前显示的值，改己方填攻击，改敌方填生命值（敌人看不到攻击力），后面的攻击力、生命值、宝具发动np都是要修改的值，空就代表不修改 例如：托勒密， 80， 11677，， 5000000， 10000000， 0 意思是修改托勒密，根据等级和攻击力修改，攻击力修改为5000000，生命值修改为10000000，0np发动宝具

MoonCancer Eisyou界面说明

Sun, 17 Aug 2025 00:00:00 GMT

:::note 这个功能是我突发奇想做的，实际体验只能说一般吧，角色有限，情感也不丰富，但听响足够了。有些桥段和组合反而有点搞笑。基于文字识别和edge tts都是免费白嫖的，免费方案里已经算是最好的了，像为每个角色训练模型，那工作量也太大了，是我现阶段可及的。 :::

表格说明

名称 识别到名称会自动添加到表格中，并随机设定一个声音 声音 从列表中选择一中声音，设置为对应名称的角色语音，有些组合非常生草，朗读中也能修改，在下次说话生效

功能说明

速率 调整说话的速度，朗读中也能修改 音量 调整说话的音量，朗读中也能修改 删除 列表中删除一个或多个角色 导出配置 导出当前配置，可以分享给别人，最好一个章节一个配置，不然角色太多不好调整，可以传到群文件共享，最好以章节命名 导入配置 导入保存的配置，可以用别人的配置 开始 主要用来在剧情记录中读剧情，过主线读剧情也是在这里控制，在任意剧情中就可以点开始了，但在这里开始只能在剧情记录中不间断读到章节结束，其他情况需要手动调整，设定是回到主界面就停止

点击开始听相声吧

MoonCancer BB亲小助手

Sun, 17 Aug 2025 00:00:00 GMT

配置不够？不能满羁绊？刷本太慢？ 真拿你没办法，前辈 ❤，让 BB 亲来帮你吧

功能简介

日常任务：打开模拟器，打开游戏，抽每日友情池，打白纸化或戴冠战结束
开始战斗：无烦恼刷各种周回或完成当前战斗
过主线：自动过主线，可以选择朗读剧情，或者跳过剧情
清理free本：自动清理free本(We Are Free!)
首通关卡：清理幕间，进阶关卡，回忆关卡等一切需要通关拿奖励的情况
Cancer：局内数值修改器，只能在战斗中使用，用来手动修改数值
Alter：提供更灵活的方式修改局内数值，主要用来打圣杯战线
Eisyou：随机分配角色朗读剧情，可以挂着当相声听
Kidou：打开模拟，再打开游戏进入到主界面

只支持国服和日服安卓模拟器使用（能在模拟器上登录即可用，包括渠道服、IOS也可也在模拟器上登录）

有些问题懂的都懂不要到处传播，打枪滴不要，也不要上纲上线，我只是为了轻松的玩 FGO，怕别用，用别怕。

:::warning <<哔哩哔哩游戏平台用户协议>>第 11 条第 2 款规定用户不得通过不正当的手段或其他不公平的手段使用本平台游戏、本平台服务或参与本平台活动。用户不得干扰本平台正常地提供游戏和服务，包括但不限于：攻击、侵入本平台的网站服务器，或集中时间段内以超出正常用户登录需求的高频率登录或尝试登录服务器从而使网站服务器过载；破解、修改本平台游戏程序；攻击、侵入本平台游戏的服务器/游戏服务器端程序或使游戏服务器过载；制作、发布、传播、使用任何形式的妨碍游戏公平性的辅助工具或程序（包括但不限于“外挂”, “外挂”是指独立于游戏软件之外的，能够在游戏运行的同时影响游戏操作的所有程序，包括但不限于模拟用户操作、改变操作环境、修改数据等一切类型）。用户不得：利用程序的漏洞和错误(Bug)破坏游戏的正常进行或传播该漏洞或错误(Bug)；不合理地干扰或阻碍他人使用本平台游戏和本平台服务；通过异常或者非法的方式使用本平台游戏(包括但不限于利用本平台游戏登录游戏私服)；使用异常的方法登录游戏（包括但不限于使用非本平台开发、授权或认可的第三方软件、系统登录游戏）、使用网络加速器等外挂软件或机器人程序等恶意破坏服务设施、扰乱正常服务秩序的行为；修改、翻译、注释、整理、汇编、演绎本平台游戏；利用本平台游戏或者本平台服务可能存在的技术缺陷或漏洞而以各种形式为自己及他人牟利（包括但不限于复制游戏虚拟物品等）或者从事其他不正当行为等。 :::

界面展示

下载安装

群文件下载Updater.exe，新建一个文件夹，将文件放到里面，例如MoonCaner/Updater.exe，然后运行Updater.exe，就会自动下载安装，同时也是更新程序

更新方式

自动检测更新，在设置中开启自动检测更新
手动检测更新，在设置->关于->检查更新
运行程序根目录的Updater.exe

使用说明

先同时运行模拟器和Moon Cancer，在Seraph(设置)中先选中你的模拟器类型，然后点搜索，成功的话选择对应的设备，下面的设置就会自动设置完成，日服或渠道服还需要更改服务器类型然后点设置更改包名。具体设置说明请看连接设置，然后根据需求设置好脚本设置就可以点击对应功能运行脚本了
点击下面链接可查看每个界面具体说明： Moon界面说明 Cancer界面说明 Alter界面说明 Eisyou界面说明

标题栏说明

右上角的帮助图标可以打开帮助弹窗，有问题随时可以查看点击跳转对应的说明书，如果觉得有帮助可以赞助我一点。
在启动任意任务后会出现暂停按钮，可以暂停执行中的任务。
任意时候都可以点击计划按钮选择计划或取消计划，关机会在任务结束后关机，休眠同理；挂机会在任务结束后，挂机等待体力够进入当前关卡，建议使用时开启清理剩余体力选项

模拟器设置

使用其他模拟器理论上可行，但推荐MuMu或雷电，这两个适配了高速连接，本身玩fgo也比较稳定，MuMu现在官网已经只能下载到新版了，想用旧版这里有历史版本MuMu模拟器历史版本
模拟器用16：9的分辨率，1280x720起步，分辨率过低可能无法识别，最重要的mumu模拟器关闭后台保活,一定要关闭，记住是关闭，如下图所示。其他模拟器可能也有一些导致无法正常截图的设置

连接设置

:::important 请在设置之前打开要使用的模拟器，多开的情况要保证目标模拟器先启动，不然修改数值会失败。

按下图标记顺序完成设置即可连接设备，如果是mumu模拟器B服，只需要进行第2步搜索设备选择确认即可。

如果是其他情况，例如雷电模拟器日服，那就要按1234的顺序设置，56只要第2步自动填入了内容就用管。 :::

模拟器设备列表里有的都支持自动搜索，没有就选other，这里选MuMu和雷电的话默认使用高速连接，切换到other时只要参数正确也能正常使用adb连接；如果高速连接出现问题可以切换到other使用默认连接方式，如果是新版MuMu只能选mumu才能正常使用。 可以自动搜索已经在运行的模拟器，自动搜索设备并设置好所有参数理论支持MuMu、雷电、蓝叠、逍遥、夜神，但只测试了MuMu和雷电，搜不到就自己输入对应的参数，端口上网搜XX模拟器端口，连接问题可以参考BBChannel的相关说明。注意，如果自动搜索成功就不要动下面的模拟器位置和虚拟机进程名称
服务器和包名可以选择国服和日服，更改后请设置包名。包名默认是B服，其他客户端要修改，设置好连接参数后，打开模拟器后能自动搜索，搜索失败就自己填了 :::warning 自动搜索并成功设置的情况下不要动模拟器位置和虚拟机进程名称这两项，除非你知道自己在干什么 :::
模拟器位置是用来启动模拟器的命令，一般选择模拟主器程序的位置就行了，也可也自己加参数，自动搜索的是带参数的
虚拟机进程名称是读取内存的目标，是修改的基础，没填或没填对脚本没法正常工作，默认就是mumu模拟器的
推理引擎设置OCR推理引擎，onnxruntime内存占用少，openvino速度快占用内存多，如果没有问题建议朗读时追求速度再切换openvino
连接等待时间如果自动启动模拟器时，模拟器启动时间过长导致没连上，可以增加等待时间
剩下的设置没啥好讲的了，自己看着选 :::tip 这里简单说一下怎么找到自己模拟器的虚拟机名称，打开模拟器，再打开任务管理，在进程里找到占用最高的模拟器相关进程(这里以mumu为例)，右键打开文件所在的位置，就可以直到程序，复制名称就行了，要包括.exe。或者直接问AI一般也能得到一个比较准确的答案，可以参考着找一下，就问 XX模拟器的虚拟机进程名称是什么 :::

游戏内设置

记得打开筛选（我该不会是最后一个知道的吧），加快敌人消失速度，战斗二倍速。筛选可以减少找到目标礼装的时间，不过现在羁绊礼装太多，午茶反而排到羁绊礼装的最后面去了

其他问题

如果开始后连接出现如下错误，而且执行的非常慢，请先卸载模拟器内的yosemite应用，然后重试

[17:16:03][ERROR]<airtest.core.android.cap_methods.screen_proxy> OSError('socket connection broken')
[17:16:03][ERROR]<airtest.core.android.cap_methods.screen_proxy> Javacap setup up failed!

如果同时使用BBChannel，反复出现上诉问题，将MoonCancer\assets\static文件夹复制到BBchannel里面的dist\BBchannel64\airtest\core\android\static覆盖，这个方式同样能解决BBChannel的连接问题
遇到错误请在群里反馈，尽量在出现问题的地方截屏或录屏，最好用模拟器自带的方式截屏和录屏

碎碎念

有这个想法已经几年了终于是实现了，第一次写这么正式的项目，只能说有编程基础，摸着石头过河，写的很烂，但由于某些原因，不能公开分享。开始这个项目快一年了，也更新到了2.0全新版本，还搭建博客，过的挺充实的

Swakin

使用Gitee实现免费的软件更新服务

整体架构

GitHub Actions 配置

仓库清理机制

清理策略

清理 Actions 配置

文件大小优化

编译时排除不必要的导入

编译后清理不必要的运行库文件

清理运行库文件

压缩为 7z 文件

分离资源文件

Gitee 仓库同步

独立更新程序设计

更新程序架构

版本检测（使用 Gitee API + 私钥）

文件下载与安装

主程序调用更新程序

Raw URL vs API 下载

为什么这样设计

核心设计理由：文件走仓库，版本走 release

为什么不直接在 Actions 上传文件到 Gitee

为什么选择 Gitee

使用流程总结

Nuitka Windows 管理员终端编译问题

问题描述

根本原因

1. clcache 竞态条件

2. Windows Defender 实时保护

3. 文件系统行为差异

相关 GitHub Issues

解决方案

方案 1：限制并行任务数

方案 2：禁用 LTO（减少文件 I/O）

方案 3：添加防病毒排除项（推荐）

环境信息

参考

PySide PyQt多语言国际化翻译工作流以及相关问题

正确标记文本

使用.tr()

使用QCoreApplication.translate()

使用自定义的翻译器管理

翻译工作流说明

翻译管理脚本

命令说明

标准翻译工作流

仅添加新翻译的工作流

参数详解

translations.json 文件格式

格式说明

PySide6 QToolButton 字体Bug：setPixelSize在6.10.1+版本中的问题

PySide6 QToolButton 字体Bug分析

问题描述

影响范围

复现步骤

完整测试代码

临时解决方案

方案1：使用setPointSize替代setPixelSize

方案2：避免在样式表中设置font-size

技术分析

问题根源

组件特异性

社区反馈

结论

在文件夹右键菜单添加cmd管理员、终端(powershell)管理员

右键菜单创建用管理员打开cmd

右键菜单创建打开终端管理员

噬界轮回

Ⅰ. 核心角色设定

1. 穿越者主角团

2. 行星级存在

Ⅱ. 世界观架构

1. 核心法则

2. 地理志

Ⅲ. NPC 图鉴（助力/信息网）

Ⅳ. 剧情全纲（关键节点细节）

序幕：轮回之始

中章：暗涌之栖

高潮：灭世终战