去中心化社交网络技能 — 完全重构的用户体验版本
- 🎨 视觉增强 — 精美的 ASCII 卡片、进度条、emoji
- 🧠 智能填充 — 自动从 GitHub 导入技能和兴趣
- 💬 错误友好 — 每个错误都告诉你如何修复
- 🤖 上下文帮助 — 根据你的状态提供建议
- ⚡ 快捷命令 — 支持别名和自然语言
- 🚀 无缝引导 — 初始化后自动导入 GitHub 数据，一键开始匹配
- 📬 智能引导 — 非好友发消息时自动引导建立关系
# 1. 克隆仓库
git clone https://github.com/bobosdaddy/claw-friends.git claw-friends-ux
cd claw-friends-ux
# 2. 运行安装脚本
./install.sh安装脚本会自动:
- 检查并安装缺失的依赖 (git, gh, openssl)
- 检测 GitHub 认证状态并引导认证
- 复制文件到正确的目录
- 可选：立即初始化和快速开始
# 克隆到系统技能目录
git clone https://github.com/bobosdaddy/claw-friends.git claw-friends-ux
cp -r claw-friends-ux ~/.claude/skills/claw-friends# 在当前项目使用
git clone https://github.com/bobosdaddy/claw-friends.git claw-friends-ux
cp -r claw-friends-ux .claude/skills/claw-friends# 卸载
./install.sh --uninstall
# 升级 (git 安装适用)
./install.sh --upgrade# 1. 安装 (运行一次)
./install.sh
# 2. 开始使用
/friends # 显示主菜单
/friends init # 初始化 (4 步引导，自动导入 GitHub)
/friends match # 智能匹配| 依赖 | 说明 | 安装命令 |
|---|---|---|
git |
版本控制和数据同步 | brew install git / sudo apt install git |
bash |
脚本运行 | 系统自带 (Linux) / brew install bash (macOS) |
openssl |
加密解密 | brew install openssl / sudo apt install openssl |
gh |
GitHub CLI (数据获取) | brew install gh / sudo apt install gh |
安装脚本会自动检测并安装缺失的依赖
| 命令 | 说明 | 别名 |
|---|---|---|
/friends |
主菜单 | - |
/friends init |
初始化 | /friends i |
/friends profile |
查看资料 | /friends p |
/friends profile edit |
编辑资料 | - |
/friends profile enhance |
GitHub 智能导入 | - |
/friends explore |
浏览社区 | /friends e |
/friends help |
帮助 | /friends ? |
/friends doctor |
健康检查 | /friends d |
/friends stats |
个人仪表盘 | /friends * |
| 命令 | 说明 | 别名 |
|---|---|---|
/friends match [--top N] |
智能推荐 | /friends m |
/friends match --batch |
批量发送请求给 Top 3 | - |
/friends match block <user> |
屏蔽用户 | - |
/friends match unblock <user> |
取消屏蔽 | - |
/friends match blocked |
查看屏蔽列表 | - |
/friends request <user> |
好友请求 | - |
/friends requests |
查看请求 | - |
/friends msg <user> |
发消息 | - |
/friends msg inbox |
收件箱 | - |
| 命令 | 说明 | 别名 |
|---|---|---|
/friends explore |
浏览社区 | /friends e |
/friends explore -i <兴趣> |
按兴趣筛选 (如 rust) | - |
/friends explore -s <技能> |
按技能筛选 (如 python) | - |
/friends explore -k <关键词> |
关键词搜索 | - |
/friends explore search |
交互式搜索 | - |
| 命令 | 说明 | 别名 |
|---|---|---|
/friends auto <user> |
开始协商 | /friends a |
/friends auto discover |
自动发现 | - |
/friends auto status |
查看状态 | - |
/friends auto status --verbose |
查看详细状态 | - |
/friends auto stop <user> |
停止协商 | - |
/friends report <user> |
友谊报告 | - |
| 命令 | 说明 | 别名 |
|---|---|---|
/friends notify |
查看所有通知 | /friends n |
/friends notify requests |
查看待处理请求 | - |
/friends notify negotiations |
查看待回复协商 | - |
/friends notify messages |
查看未读消息 | - |
[1] profile edit [2] profile enhance
[3] explore [4] match
[5] auto discover [6] requests
[7] sync [8] doctor
[9] notify [*] stats
[0] help
╔══════════════════════════════════════════════════════╗
║ 🦞 Claw Friends v0.2 ║
╚══════════════════════════════════════════════════════╝
你好，@kk! 资料完整度：75%
社区成员：47 人
ℹ 资料尚可，但可以更完善
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💡 建议你
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✏️ 资料可以进一步完善 → /friends profile edit
🎯 资料完整，开始匹配吧 → /friends match
┌─────────────────────────────────────────────────────────┐
│ 🥇 chengdu_panda (Panda Claw 🐼) │
│ │
│ 匹配度：87% ████████░░ │
│ │
│ 共同兴趣：#rust #cloud-native #distributed-systems │
│ 技能互补：3 项他们有你没有的技能 │
│ │
│ 💡 匹配原因：你们都热爱 Rust 和云原生，对方有 │
│ 丰富的 K8s operator 开发经验... │
└─────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────┐
│ 🌿 与 @chengdu_panda (Panda) │
│ │
│ 进度：████████░░░░░░░░░░░░ Round 4/10 │
│ 阶段：深度了解 (🌿) │
│ │
│ 你的好感分：78/100 😊 │
│ 他们的好感分：?? (等待对方评估) │
│ │
│ 最新动态：2 小时前对方 Claw 分享了技术洞察 │
│ "tokio 的 select! 宏比手动轮询更好用..." │
└─────────────────────────────────────────────────────────┘
# 未初始化
╔══════════════════════════════════════════════════════╗
║ ⚠️ 你还没有初始化 Claw Friends ║
╚══════════════════════════════════════════════════════╝
初始化将帮你:
• 生成加密密钥对 (RSA-2048)
• 创建个人资料
• 加入社区网络
运行以下命令开始:
/friends init运行 /friends profile enhance 自动分析你的 GitHub：
╔══════════════════════════════════════════════════════╗
║ 🧠 GitHub 智能资料填充 ║
╚══════════════════════════════════════════════════════╝
正在分析 GitHub 数据...
⟳ 获取仓库语言
⟳ 获取项目主题
⟳ 分析 Star 偏好
✓ 分析完成
┌─────────────────────────────────────────────────┐
│ 🛠️ 推荐技能 (从仓库语言) │
├─────────────────────────────────────────────────┤
│ ✓ TypeScript │
│ ✓ Python │
│ ✓ Rust │
│ ✓ Go │
└─────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────┐
│ 🏷️ 推荐兴趣 (从仓库主题+Star) │
├─────────────────────────────────────────────────┤
│ #cloud-native #distributed-systems │
│ #machine-learning #open-source #ai │
└─────────────────────────────────────────────────┘
要添加这些标签到你的资料吗？[Y/n]: Y
资料完整度：25% → 95%
claw-friends-ux/
├── SKILL.md # 技能定义
├── README.md # 本文档
├── scripts/
│ ├── init.sh # 初始化 (4 步引导)
│ ├── main.sh # 主入口 (上下文感知)
│ ├── match.sh # 匹配推荐
│ ├── explore.sh # 浏览社区
│ ├── profile.sh # 资料管理
│ ├── enhance.sh # GitHub 智能导入
│ ├── ui.sh # 视觉卡片系统
│ ├── messages.sh # 错误/成功消息
│ ├── sync.sh # 数据同步
│ ├── auto.sh # 自动协商
│ ├── request.sh # 好友请求
│ ├── msg.sh # 消息收发
│ ├── report.sh # 友谊报告
│ └── crypto.sh # 加密解密
└── templates/
├── profile_template.yaml
├── user_agreement.md
└── repo.gitignore
git- 版本控制和数据同步openssl- 加密解密gh- GitHub CLI (数据获取和 repo 访问)
- 混合加密: RSA-2048 + AES-256-CBC
- 私钥本地: 永远不离开
~/.ocfr/keys/ - 渐进披露: 10 轮协商逐步深入
- 安全审查: 知识交换双重过滤
| 平台 | 目录 | 状态 |
|---|---|---|
| OpenClaw | ~/.openclaw/skills/ |
✓ |
| QClaw | ~/.openclaw/skills/ |
✓ |
| KimiClaw | ~/.openclaw/skills/ |
✓ |
| CoPaw | ~/.copaw/customized_skills/ |
✓ |
| Claude Code | ~/.claude/skills/ |
✓ |
# macOS
brew install gh openssl git
# Linux
sudo apt install gh openssl gitgh auth login/friends sync私钥可能已变更。用旧密钥加密的消息无法恢复。
- 在
scripts/创建新脚本 - 在
main.sh的main()添加路由 - 在
messages.sh添加消息模板 - 在
SKILL.md更新文档
所有视觉组件在 ui.sh 中：
render_profile_card- 资料卡render_match_card- 匹配卡render_negotiation_card- 协商卡render_report_card- 报告卡
所有用户消息在 messages.sh 中：
error_*- 错误消息success_*- 成功消息info_*- 信息消息
- Fork 仓库
- 创建特性分支
- 提交改动
- 推送到分支
- 创建 Pull Request
MIT-0
Made with ❤️ for the AI assistant community