social-agent 4.0.3

社交关系AI管家 - 独立 CLI 工具，自动追踪社交关系，帮你拟消息、记待办、维护人脉

社交关系AI管家

本地运行的AI管家，自动追踪所有社交关系中「最近干了什么」和「下一步该干什么」。

安装

pip（推荐）

pip install social-agent

npm

npx @farmost/social-agent status

一键脚本

bash <(curl -sL https://raw.githubusercontent.com/farmost-beep/social-agent/main/install.sh)

已配置 Claude Code（~/.claude/settings.json）的用户无需额外设置，CLI 自动复用系统 LLM 配置。未配置则三选一：

# Claude（默认，无需额外设置 engine）
export ANTHROPIC_API_KEY=sk-ant-...

# OpenAI
export LLM_ENGINE=openai
export OPENAI_API_KEY=sk-...

# MiniMax
export LLM_ENGINE=openai
export OPENAI_API_KEY=...
export OPENAI_BASE_URL=https://api.minimaxi.com/v1

命令

social status                  # 联系人状态总览
social todos                   # 待办列表
social advise                  # 该联系谁+为什么+聊什么
social draft -m "上下文" -c 张三  # AI 拟稿
social chat "消息"              # 直接对话
social anchor                  # 目标锚定（联系人↔六维目标）
social outcomes                # 兑现追踪
social config show             # 查看配置

数据

本地 JSON 存储，不上云：

文件	说明
data/contacts.json	联系人库
data/timeline.json	互动时间线
data/todos.json	待办队列

文档

• 设计规约 · v4 架构 · 配置指南
• 版本日志 · 迁移指南

许可证

MIT