pyamber 0.1.2

人格工坊 - 让任何人都能用自然语言创造有灵魂、会记忆、能理解、有底线的数字人格

🧡 Amber - 人格工坊

让任何人都能用自然语言创造有灵魂、会记忆、能理解、有底线的数字人格。

✨ 特性

• 🎭 四种创建模式 - 快速模式/AI脑补/动态问卷/专家问卷
• 🧠 有情绪 - 会开心、会难过、会记仇、会原谅
• 📝 会记忆 - 记住你说过的话，形成态度
• 🛡️ 有底线 - 话题边界，不可逾越
• 🤝 开源协作 - Fork、改进、PR，像GitHub一样
• 🔒 隐私保护 - 参数层与记忆层分离

提示：人格市场仅为示例，无明显实际功能，仅支持局域网。

🚀 快速开始

# 安装
pip install pyamber

# 创建人格（快速模式，指定名称）
amber create "傲娇的高中生" --quick --name 浅浅

# 创建人格（动态问卷，推荐）
amber create --dynamic

# 创建服务型人格
amber create "技术面试官" --type service --name 张老师

# 运行对话
amber run 浅浅

📖 文档

文档	说明
安装指南	安装和配置
快速开始	5分钟上手
CLI命令	完整命令参考
人格创建	四种创建模式详解
对话交互	如何与人格对话
记忆系统	记忆的工作原理
情绪系统	情绪变化机制
边界系统	话题边界控制
Fork协作	像GitHub一样协作
版权保护	签名、水印、防盗版
Web界面	图形化问卷
API参考	编程接口
示例代码	代码示例
常见问题	FAQ
更新日志	查看完整更新日志

🎯 四种创建模式

模式	命令	说明
快速模式	amber create "描述" --quick --name 名称	AI直接脑补，可指定名称
智能模式	amber create "描述"	基础问卷 + AI问题 + 自定义
动态问卷	amber create --dynamic --name 名称	推荐 - 智能跳题，第三人称
专家模式	amber create --expert	25题基础问卷

💬 示例对话

$ amber run 林夏

你: 你好
林夏: 嗯。想喝什么？

你: 推荐一下
林夏: 今天有耶加雪菲。酸的，不苦。

你: 你真温柔
林夏: [沉默 2秒]
林夏: ...

你: 我最近好累
林夏: 嗯~ 喝杯咖啡吧。

你: 你对我真好
林夏: 少来。[把茶推过来] 快喝，凉了涩。

你: exit
✅ 人格 '林夏' 已保存

🔧 配置LLM（推荐）

# Windows PowerShell
$env:AMBER_LLM_PROVIDER="deepseek"
$env:AMBER_LLM_API_KEY="your-api-key"
$env:AMBER_LLM_MODEL="deepseek-v4-pro"

# Linux/Mac
export AMBER_LLM_PROVIDER="deepseek"
export AMBER_LLM_API_KEY="your-api-key"
export AMBER_LLM_MODEL="deepseek-v4-pro"

📦 依赖

• Python 3.10+
• click>=8.0.0
• numpy>=1.24.0
• pyyaml>=6.0
• cryptography>=41.0.0

📄 许可证

GPL-3.0

👤 作者

GraceFox - [e-mail]

🙏 致谢

感谢以下工具和服务：

• DeepSeek - 提供代码补全、文档撰写和技术支持