Metadata-Version: 2.1
Name: social-agent
Version: 4.0.1
Summary: 社交关系AI管家 - 独立 CLI 工具，自动追踪社交关系，帮你拟消息、记待办、维护人脉
Home-page: https://github.com/farmost-beep/social-agent
Author: 陈颖芳
Author-email: farmost@gmail.com
License: UNKNOWN
Project-URL: Source, https://github.com/farmost-beep/social-agent
Project-URL: Bug Tracker, https://github.com/farmost-beep/social-agent/issues
Project-URL: Documentation, https://github.com/farmost-beep/social-agent/blob/main/docs/SPEC_v3.md
Project-URL: Changelog, https://github.com/farmost-beep/social-agent/blob/main/docs/CHANGELOG.md
Keywords: social-relationship ai-assistant wechat claude llm cli
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyyaml (>=6.0)
Requires-Dist: httpx (>=0.24)
Provides-Extra: web
Requires-Dist: flask (>=2.0) ; extra == 'web'

# 社交关系AI管家

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

[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Version](https://img.shields.io/badge/version-4.0.1-blue.svg)](docs/CHANGELOG.md)

## 安装

**pip（推荐）**

```bash
pip install -e .
```

**npm**

```bash
npx @farmost/social-agent status
```

**一键脚本**

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

安装后设置 API Key（三选一）：

```bash
export ANTHROPIC_API_KEY=sk-ant-...                    # Claude（默认）
export OPENAI_API_KEY=sk-...                           # OpenAI
export OPENAI_API_KEY=... OPENAI_BASE_URL=https://api.minimaxi.com/v1  # MiniMax
```

## 命令

```bash
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` | 待办队列 |

## 文档

- [设计规约](docs/SPEC.md) · [v4 架构](docs/SPEC_v4.md) · [配置指南](docs/CONFIG.md)
- [版本日志](docs/CHANGELOG.md) · [迁移指南](docs/MIGRATION.md)

## 许可证

MIT


