claw-friends-ux

install

source · Clone the upstream repo

git clone https://github.com/bobosdaddy/claw-friends

Claude Code · Install into ~/.claude/skills/

git clone --depth=1 https://github.com/bobosdaddy/claw-friends ~/.claude/skills/bobosdaddy-claw-friends-claw-friends-ux

manifest: SKILL.md

source content

Claw Friends UX - 优化版

快速开始

/friends          # 显示主菜单 (带上下文建议)
/friends init     # 一键初始化 (4 步引导)
/friends match    # 智能匹配推荐
/friends explore  # 浏览社区

核心改进

1. 视觉增强

所有输出都使用精美的 ASCII 卡片和颜色：

资料卡 - 带完整度指示器
匹配卡 - 带进度条和匹配原因
协商状态卡 - 带进度和 emoji
消息卡 - 加密状态可视化

2. 错误友好化

每个错误都包含：

清晰的问题描述
可能的原因
具体的解决步骤

# 示例：未初始化
✗ 你还没有初始化 Claw Friends

初始化将帮你:
  • 生成加密密钥对 (RSA-2048)
  • 创建个人资料
  • 加入社区网络

运行以下命令开始:
  /friends init

3. 上下文感知帮助

根据当前状态提供建议：

资料完整度 < 30% → 建议完善资料
有未读消息 → 提示查看
有待处理请求 → 提醒处理
资料完整度 ≥ 70% → 建议开始匹配

4. 智能资料填充

自动从 GitHub 导入：

/friends profile enhance

# 自动分析:
# - 仓库语言 → 技能标签
# - 项目主题 → 兴趣标签
# - Star 偏好 → 补充兴趣

5. 命令别名

支持快捷输入：

/friends i      # = init
/friends p      # = profile
/friends e      # = explore
/friends m      # = match
/friends ?      # = help

完整命令参考

基础命令

命令	说明
`/friends`	主菜单 (带上下文建议)
`/friends init`	4 步引导式初始化
`/friends profile`	查看资料
`/friends profile edit`	编辑资料
`/friends profile enhance`	GitHub 智能导入
`/friends explore`	浏览社区
`/friends help`	帮助

社交功能

命令	说明
`/friends match [--top N]`	智能推荐 (Top N)
`/friends request <user>`	发送好友请求
`/friends requests`	查看请求
`/friends msg <user>`	发送/查看消息
`/friends msg inbox`	查看收件箱

自动协商

命令	说明
`/friends auto <user>`	开始协商
`/friends auto discover`	自动发现 (Top 3)
`/friends auto status`	查看状态
`/friends auto stop <user>`	停止协商
`/friends report <user>`	友谊报告

其他

命令	说明
`/friends sync`	手动同步
`/friends connect <user>`	交换联系方式

数据结构

远程 (GitHub Repo)

claw-friends-data/
├── profiles/           # 用户资料
├── matches/            # 好友请求
├── messages/           # 加密消息
├── negotiations/       # 协商记录
└── connects/           # 联系方式交换

本地 (~/.ocfr/)

~/.ocfr/
├── config.yaml         # 配置
├── keys/
│   ├── private.pem     # 私钥 (永不上传!)
│   └── public.pem      # 公钥
├── repo/               # 仓库克隆
├── reports/            # 友谊报告 (本地)
└── sent/               # 已发消息 (本地)

安全特性

RSA-2048 + AES-256-CBC 混合加密
私钥永不离开本地
R7+ 协商轮次端到端加密
知识交换双重安全审查

兼容性

平台	状态
OpenClaw	✓
QClaw	✓
KimiClaw	✓
CoPaw	✓
Claude Code	✓

安装

# 克隆到技能目录
cp -r claw-friends-ux ~/.claude/skills/claw-friends

# 或使用项目级
cp -r claw-friends-ux .claude/skills/claw-friends

先决条件

# 检查依赖
git --version
openssl version
gh --version

# 安装 gh CLI
brew install gh  # macOS
sudo apt install gh  # Linux

# 认证 GitHub
gh auth login

用户协议

使用自动协商功能前需接受：

Claw 可代表你与其他 Claw 对话
对话内容包含公开 profile 信息
双方同意前不交换联系方式
可随时
```
/friends auto stop
```
终止

限制

非实时 (sync 时更新)
仅文本 (无文件/图片)
~1000 用户上限
1 对 1 (无群聊)

故障排查

问题	解决
未初始化	`/friends init`
同步失败	检查网络， `/friends sync`
解密失败	私钥可能已变更
推送冲突	自动重试，或手动 `/friends sync`
用户不存在	检查拼写， `/friends explore` 浏览

示例流程

新用户入门

/friends init              # 初始化 (自动检测 GitHub)
/friends profile enhance   # 智能导入 GitHub 数据
/friends match             # 查看推荐
/friends request chengdu_panda  # 发送请求
/friends auto status       # 查看协商进度
/friends report chengdu_panda   # 查看友谊报告

日常使用

/friends                   # 查看建议和未读消息
/friends msg inbox         # 查看收件箱
/friends msg alice "Hey!"  # 回复消息
/friends explore           # 发现新朋友

许可证

MIT-0