name: address-book description: 管理地址别名和传输历史。自动从传输备忘录中创建联系人名称，跟踪传输次数，并快速访问常用地址。

地址簿技能

何时使用此技能

使用此技能：

保存地址别名/昵称以便参考
从传输备忘录中自动创建联系人
跟踪向地址发送的次数
列出常用地址
通过别名搜索地址

功能

1. 📝 从传输备忘录自动创建别名

当传输带有备忘录时，自动保存该备忘录为地址别名：

向 TXXXabc... 传输 100 TRX，备忘录为 "家人钱包"
→ 自动保存：TXXXabc... = "家人钱包"

2. 📊 传输次数跟踪

即使没有备忘录，也跟踪向每个地址发送的次数：

TYYYdef... : 5 次传输（无别名）

3. 🔍 快速查找

通过别名查找地址：

"家人钱包" → TXXXabc...

4. 📋 列出联系人

查看所有保存的地址，按以下方式排序：

最常使用
最近添加
按字母顺序

使用方法

保存/更新别名

from skills.address_book.scripts.manage_contacts import save_contact

save_contact(
    address="TXXXabc...",
    alias="朋友的钱包",
    increment_count=True
)

获取别名

alias = get_contact_alias("TXXXabc...")
# 返回："朋友的钱包" 或 None

列出所有联系人

contacts = list_contacts(sort_by="count")
# 返回带有别名和传输次数的排序列表

数据存储

联系人存储在：skills/address-book/data/contacts.json

{
  "TXXXabc...": {
    "alias": "朋友的钱包",
    "transfer_count": 5,
    "first_seen": "2026-02-08T02:10:00",
    "last_transfer": "2026-02-08T10:30:00"
  }
}

与传输的集成

传输代币中的自动行为：

用户传输带有备忘录 → 保存备忘录为别名
用户传输没有备忘录 → 仅增加计数
显示：“发送到朋友的钱包 (TXXXabc…)” 而不是仅地址

隐私与安全

📁 仅本地存储（不共享）
🔒 不存储敏感数据（地址是公开的）
✅ 用户可以随时编辑/删除别名
🚫 从不存储私钥或交易详情

命令

操作	示例
保存别名	`save_contact("TXXXabc", "Alice的钱包")`
获取别名	`get_contact_alias("TXXXabc")`
列出所有	`list_contacts()`
删除	`delete_contact("TXXXabc")`
搜索	`search_contacts("Alice")`

输出示例

📇 您的地址簿
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

最常使用：
  1. 家人钱包 (TXXXabc...abc) - 15 次传输
  2. 朋友-Alice (TYYYdef...def) - 8 次传输
  3. 交易所充值 (TZZZghi...ghi) - 3 次传输

总联系人：3