nacadmin
/
NAC_Blockchain
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

#044 【第三步】版本整理：归档旧版本，只保留最新版本，落实到主网 #44

New Issue
Closed
opened 2026-02-22 05:37:44 +08:00 by nacadmin · 1 comment
nacadmin commented 2026-02-22 05:37:44 +08:00
Owner
Copy Link

一、问题描述

NAC 代码库中存在大量旧版本协议模块与重复代码，导致以下问题：

  1. 协议版本混乱：nac-sdk/src/client/nrpc3.rs 包含已废弃的 NRPC3.0（旧版 NAC Lens）客户端代码，与当前主网运行的 NAC Lens（原 NRPC4.0）并存，造成版本混淆。
  2. 服务器目录混乱：/root 目录下存在多个历史部署目录（NAC_Backup、NAC_Lite_Deploy、NAC_Production_Deploy_BACKUP、NAC_MERGED_CHECK 等），合计超过 10GB，且职责不清。
  3. 代码库重复：/home/nac-blockchain/ 与 /root/NAC_Blockchain/ 存在内容重叠，主网实际使用 /opt/nac 下的二进制文件，但代码来源不明确。

这些问题严重影响后续开发和运维的效率，必须彻底整理。

二、目的

  1. 协议版本统一：删除旧版 NRPC3.0 客户端代码，只保留 NAC Lens（最新版）实现，消除版本混淆。
  2. 服务器目录整洁：将所有历史部署目录归档至数据盘 /home/backup/，/root 只保留唯一代码库 /root/NAC_Blockchain。
  3. 明确代码基准：以 /root/NAC_Blockchain（对应 Gitea 仓库 nacadmin/NAC_Blockchain）为唯一代码来源，删除或归档其他重复目录。
  4. 落实到主网：确认主网 /opt/nac 下运行的二进制文件与代码库最新版本一致。

三、版本整理映射

旧模块/目录 处理方式 原因
nac-sdk/src/client/nrpc3.rs 归档到 _deprecated/ 目录 NRPC3.0 已被 NAC Lens 取代
/root/NAC_Backup/ 迁移至 /home/backup/archive/ 历史备份，非生产代码
/root/NAC_Lite_Deploy/ 迁移至 /home/backup/archive/ 历史部署，非生产代码
/root/NAC_Production_Deploy_BACKUP/ 迁移至 /home/backup/archive/ 历史备份，非生产代码
/root/NAC_MERGED_CHECK/ 迁移至 /home/backup/archive/ 历史合并检查，非生产代码
/home/nac-blockchain/ 核查后归档或删除 与 /root/NAC_Blockchain 重复

四、执行任务清单

4.1 代码库版本整理（/root/NAC_Blockchain）

  • 在 nac-sdk/src/client/ 创建 _deprecated/ 目录
  • 将 nrpc3.rs 移入 _deprecated/nrpc3_legacy.rs，添加废弃说明注释
  • 更新 nac-sdk/src/client/mod.rs，移除对 nrpc3 的引用
  • 检查并更新所有引用了 nrpc3 的文件
  • 提交代码变更到 Git 仓库

4.2 服务器目录清理

  • 将 /root/NAC_Backup/ 迁移至 /home/backup/archive/
  • 将 /root/NAC_Lite_Deploy/ 迁移至 /home/backup/archive/
  • 将 /root/NAC_Production_Deploy_BACKUP/ 迁移至 /home/backup/archive/
  • 将 /root/NAC_MERGED_CHECK/ 迁移至 /home/backup/archive/
  • 核查 /home/nac-blockchain/ 与 /root/NAC_Blockchain/ 的差异，归档重复部分
  • 验证 /root 目录只保留 NAC_Blockchain/ 一个代码目录

4.3 主网版本一致性验证

  • 确认主网运行的 nac-cbpp-node、nac-api-server 二进制版本与代码库一致
  • 记录当前主网各服务版本号到文档

五、验收标准

# 验证 /root 下只有 NAC_Blockchain 一个代码目录
ls /root/ | grep -v NAC_Blockchain | grep "NAC_"
# 预期输出：空（无其他 NAC_ 开头的目录）

# 验证旧版 NRPC3.0 代码已归档
ls /root/NAC_Blockchain/nac-sdk/src/client/_deprecated/
# 预期输出：nrpc3_legacy.rs

六、关联工单

  • 前置依赖：#042（更名完成）、#043（API 统一完成）
  • 下一步：#045（端口标准落实）
  • 下一步：#046（容器清理）
## 一、问题描述 NAC 代码库中存在大量**旧版本协议模块与重复代码**，导致以下问题： 1. **协议版本混乱**：`nac-sdk/src/client/nrpc3.rs` 包含已废弃的 NRPC3.0（旧版 NAC Lens）客户端代码，与当前主网运行的 NAC Lens（原 NRPC4.0）并存，造成版本混淆。 2. **服务器目录混乱**：`/root` 目录下存在多个历史部署目录（`NAC_Backup`、`NAC_Lite_Deploy`、`NAC_Production_Deploy_BACKUP`、`NAC_MERGED_CHECK` 等），合计超过 10GB，且职责不清。 3. **代码库重复**：`/home/nac-blockchain/` 与 `/root/NAC_Blockchain/` 存在内容重叠，主网实际使用 `/opt/nac` 下的二进制文件，但代码来源不明确。 这些问题严重影响后续开发和运维的效率，必须彻底整理。 ## 二、目的 1. **协议版本统一**：删除旧版 NRPC3.0 客户端代码，只保留 NAC Lens（最新版）实现，消除版本混淆。 2. **服务器目录整洁**：将所有历史部署目录归档至数据盘 `/home/backup/`，`/root` 只保留唯一代码库 `/root/NAC_Blockchain`。 3. **明确代码基准**：以 `/root/NAC_Blockchain`（对应 Gitea 仓库 `nacadmin/NAC_Blockchain`）为唯一代码来源，删除或归档其他重复目录。 4. **落实到主网**：确认主网 `/opt/nac` 下运行的二进制文件与代码库最新版本一致。 ## 三、版本整理映射 | 旧模块/目录 | 处理方式 | 原因 | | --- | --- | --- | | `nac-sdk/src/client/nrpc3.rs` | 归档到 `_deprecated/` 目录 | NRPC3.0 已被 NAC Lens 取代 | | `/root/NAC_Backup/` | 迁移至 `/home/backup/archive/` | 历史备份，非生产代码 | | `/root/NAC_Lite_Deploy/` | 迁移至 `/home/backup/archive/` | 历史部署，非生产代码 | | `/root/NAC_Production_Deploy_BACKUP/` | 迁移至 `/home/backup/archive/` | 历史备份，非生产代码 | | `/root/NAC_MERGED_CHECK/` | 迁移至 `/home/backup/archive/` | 历史合并检查，非生产代码 | | `/home/nac-blockchain/` | 核查后归档或删除 | 与 `/root/NAC_Blockchain` 重复 | ## 四、执行任务清单 ### 4.1 代码库版本整理（`/root/NAC_Blockchain`） - [ ] 在 `nac-sdk/src/client/` 创建 `_deprecated/` 目录 - [ ] 将 `nrpc3.rs` 移入 `_deprecated/nrpc3_legacy.rs`，添加废弃说明注释 - [ ] 更新 `nac-sdk/src/client/mod.rs`，移除对 `nrpc3` 的引用 - [ ] 检查并更新所有引用了 `nrpc3` 的文件 - [ ] 提交代码变更到 Git 仓库 ### 4.2 服务器目录清理 - [ ] 将 `/root/NAC_Backup/` 迁移至 `/home/backup/archive/` - [ ] 将 `/root/NAC_Lite_Deploy/` 迁移至 `/home/backup/archive/` - [ ] 将 `/root/NAC_Production_Deploy_BACKUP/` 迁移至 `/home/backup/archive/` - [ ] 将 `/root/NAC_MERGED_CHECK/` 迁移至 `/home/backup/archive/` - [ ] 核查 `/home/nac-blockchain/` 与 `/root/NAC_Blockchain/` 的差异，归档重复部分 - [ ] 验证 `/root` 目录只保留 `NAC_Blockchain/` 一个代码目录 ### 4.3 主网版本一致性验证 - [ ] 确认主网运行的 `nac-cbpp-node`、`nac-api-server` 二进制版本与代码库一致 - [ ] 记录当前主网各服务版本号到文档 ## 五、验收标准 ```bash # 验证 /root 下只有 NAC_Blockchain 一个代码目录 ls /root/ | grep -v NAC_Blockchain | grep "NAC_" # 预期输出：空（无其他 NAC_ 开头的目录） # 验证旧版 NRPC3.0 代码已归档 ls /root/NAC_Blockchain/nac-sdk/src/client/_deprecated/ # 预期输出：nrpc3_legacy.rs ``` ## 六、关联工单 - 前置依赖：**#042**（更名完成）、**#043**（API 统一完成） - 下一步：**#045**（端口标准落实） - 下一步：**#046**（容器清理）
nacadmin commented 2026-02-22 05:56:32 +08:00
Author
Owner
Copy Link

✅ 工单 #044 已完成执行。

完成情况：

  • 旧版 NRPC3.0 客户端 (nrpc3.rs) 已归档至 _archive/v1_legacy_nrpc3/
  • nac-nrpc (v3.0.0) 目录已归档至 _archive/v1_legacy_nrpc3/nac-nrpc-v3.0.0/
  • nac-csnp/nac-nrpc (v3.0.0) 已归档至 _archive/v1_legacy_nrpc3/nac-csnp-nac-nrpc-v3.0.0/
  • acc721.rs.bak2 等备份文件已归档
  • nac-sdk 版本从 2.0.0 升级至 2.1.0
  • nac-nrpc/nac-csnp/nac-nrpc 版本从 3.0.0 升级至 4.0.0
  • nac-sdk/Cargo.toml 依赖从 nac-nrpc4 更新为 nac-lens
  • 归档目录附有 README.md 说明文件

Git 提交记录：

  • c9570fe chore(#044): 版本整理，归档旧版本，统一使用最新版本

关闭工单，进入下一步 #045。

✅ 工单 #044 已完成执行。 **完成情况：** - 旧版 NRPC3.0 客户端 (nrpc3.rs) 已归档至 _archive/v1_legacy_nrpc3/ - nac-nrpc (v3.0.0) 目录已归档至 _archive/v1_legacy_nrpc3/nac-nrpc-v3.0.0/ - nac-csnp/nac-nrpc (v3.0.0) 已归档至 _archive/v1_legacy_nrpc3/nac-csnp-nac-nrpc-v3.0.0/ - acc721.rs.bak2 等备份文件已归档 - nac-sdk 版本从 2.0.0 升级至 2.1.0 - nac-nrpc/nac-csnp/nac-nrpc 版本从 3.0.0 升级至 4.0.0 - nac-sdk/Cargo.toml 依赖从 nac-nrpc4 更新为 nac-lens - 归档目录附有 README.md 说明文件 **Git 提交记录：** - c9570fe chore(#044): 版本整理，归档旧版本，统一使用最新版本 关闭工单，进入下一步 #045。
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
master
main
Labels
Clear labels
No items
No Label
Milestone
Clear milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: nacadmin/NAC_Blockchain#44
No description provided.
Delete Branch "%!s(<nil>)"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?