简化 Debian 发布流程并添加项目文档系统
All checks were successful
Build and Release / build-and-test (arm64, alpine) (push) Successful in -13s
Build and Release / build-and-test (amd64, alpine) (push) Successful in -6s
Build and Release / build-and-test (arm64, ubuntu) (push) Successful in -7s
Build and Release / build-and-test (amd64, ubuntu) (push) Successful in 7s
Build and Release / release (push) Successful in 21s

- 将 Debian 包仓库从 bookworm/trixie 双发行版改为通用 stable 仓库
- 新增完整的 llmdoc 文档系统,包含架构、指南和参考文档
- 更新 README.md 和部署指南以反映新的仓库配置
- 添加 .gitignore 文件
This commit is contained in:
2025-12-25 10:18:07 +08:00
parent 76aac67b71
commit 9afe4a8649
28 changed files with 1297 additions and 31 deletions

View File

@@ -0,0 +1,91 @@
# 如何修改源代码
## 1. 准备工作
在开始修改源代码之前,请确保:
- 已克隆原始项目仓库
- 安装必要的开发工具sed, git
- 了解项目的基本架构
## 2. 修改步骤
### 2.1 项目重命名
1. 编辑 `CMakeLists.txt`
2. 使用 `sed` 命令替换项目名称:
```bash
sed -i 's/project(xmrigcc-proxy)/project(xxxigcc-proxy)/' CMakeLists.txt
```
### 2.2 禁用捐赠功能
1. 修改以下文件:
- `src/donate.h`
- `src/net/strategies/DonateStrategy.cpp`
- `src/core/config/Config_platform.h`
- `src/config.json`
2. 使用 `sed` 命令设置捐赠级别为 0
```bash
sed -i 's/kDefaultDonateLevel = 2/kDefaultDonateLevel = 0/' src/donate.h
sed -i 's/donate-level", 1/donate-level", 0/' src/core/config/Config_platform.h
```
3. 重定向捐赠服务器地址:
```bash
sed -i 's/donate.graef.in/127.0.0.1/' src/net/strategies/DonateStrategy.cpp
sed -i 's/87.106.163.52/127.0.0.1/' src/net/strategies/DonateStrategy.cpp
```
### 2.3 版本信息定制
1. 编辑 `src/version.h`
2. 替换版本字符串:
```bash
sed -i 's/xmrigcc/xxxigcc/' src/version.h
sed -i 's/XMRigCC/XXXigCC/' src/version.h
```
### 2.4 启用详细日志
1. 编辑 `src/config.json`
2. 设置 verbose 为 true
```bash
sed -i 's/"verbose": false/"verbose": true/' src/config.json
```
## 3. 测试修改
1. 构建项目
```bash
mkdir build && cd build
cmake ..
make
```
2. 运行单元测试
```bash
make test
```
3. 手动测试程序的基本功能
## 4. 常见问题排查
### 4.1 sed 命令替换失败
- 检查目标字符串是否完全匹配
- 确保文件路径正确
- 使用 `-i.bak` 创建备份文件,方便回滚
### 4.2 构建失败
- 检查 CMake 配置
- 验证所有依赖库已安装
- 查看完整的编译日志
### 4.3 功能异常
- 对比修改前后的配置文件
- 检查 verbose 日志
- 逐步还原修改,定位问题
## 5. 最佳实践
- 始终在版本控制系统中工作
- 为每次重大修改创建单独的分支
- 保留原始项目的基本架构和功能
- 充分测试每一个修改