NAC_Blockchain/memory/QUICK_REFERENCE.md

NAC记忆系统快速参考卡

🚀 最常用命令

查询知识

cd /home/ubuntu/nac-workspace/memory

# 搜索关键词
python3 tools/query.py --keyword "CBPP"

# 查询术语
python3 tools/query.py --term "Contract"

# 列出所有问题
python3 tools/query.py --type problem

添加记录

# 快速添加问题
python3 tools/add.py problem \
  --title "问题标题" \
  --description "描述" \
  --solution "解决方案"

导出报告

# 导出完整报告
python3 tools/export.py --output report.md

📚 核心原则速查

CBPP共识

• ✅ 参与即共识 - 无需投票机制
• ✅ 规则验证 - 不是节点协商
• ✅ 宪法收据 - 交易合法性证明

术语映射

错误	正确	说明
Token	Asset	强调实物资产支撑
Contract	Certificate	强调合规性和法律效力
Balance	Holdings	强调资产所有权
PoW/PoS	CBPP	NAC原生共识

架构原则

• ✅ 四层架构: L0-L1-L2-L3
• ✅ OpCode命名: 全部UPPER_CASE
• ✅ 哈希算法: 统一使用Blake3
• ✅ 代码保留: 永远不删除代码

⚠️ 常见错误

错误1: 混淆治理投票和共识机制

• 问题: 认为CBPP共识需要投票
• 正确: CBPP共识不需要投票，治理才需要投票
• 参考: P001

错误2: 使用以太坊术语

• 问题: 使用Token、Contract等术语
• 正确: 使用Asset、Certificate等NAC术语
• 参考: principles/terminology.json

错误3: 删除"未使用"的代码

• 问题: 删除暂未使用的接口和函数
• 正确: 保留所有代码，它们是为未来预留的
• 参考: ARCH_004

🔍 快速查找

查找文档

# CBPP白皮书
cat documents/CBPP_WhitePaper_v1.json | jq '.core_concepts'

# 宪政区块链设计
cat documents/Constitutional_Blockchain_Design.json | jq '.core_philosophy'

查找原则

# 共识原则
cat principles/consensus.json | jq '.principles'

# 术语映射
cat principles/terminology.json | jq '.mappings'

# 架构原则
cat principles/architecture.json | jq '.principles'

查找问题

# 所有问题
cat problems/index.json | jq '.problems'

# 特定问题
cat problems/P001_CBPP_Voting_Confusion.json

📝 工作流程检查清单

开始新任务前

• 查询相关文档知识
• 查询相关问题历史
• 查询相关设计决策
• 查询术语映射

阅读新文档后

• 立即记录核心思想
• 补充详细信息
• 建立文档关联

遇到问题时

• 先查询问题库
• 使用已有解决方案
• 解决后立即记录

做重要决策时

• 记录决策内容
• 说明决策理由
• 列出替代方案
• 评估影响范围

🎯 记忆系统目标

避免重复错误 - 每个问题只解决一次 保持知识连续性 - 不因任务切换而遗忘 提高开发效率 - 快速查找历史知识 建立团队共识 - 统一术语和原则

---

快速参考卡 - 打印后贴在显眼位置！