未央 Weiyang · 在微信里陪伴你的 AI 伙伴

未央是一个跑在你自己设备/服务器上的 AI 陪伴伙伴：在微信里和你聊天，记得你说过的话，会主动找你、提醒你、写情绪晚报，像真人一样一条条发消息。

引擎基于开源项目 CowAgent（MIT），在其之上做了「温柔黏人」人格、微信真人感（分条发送/打字停顿/时间感知/去重）、企业微信自建应用接入、以及一个 Next.js 的「生活手帐」前端。

组成

目录	说明
CowAgent/	对话引擎（已定制：人格、分条发送、时间差、提醒修复等）
stardust-web/	落地页 + 生活手帐数据面板（Next.js，读 ~/cow/ 记忆）
deploy/	云端一键部署脚本

本地开发（macOS）

cd CowAgent
python3.12 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp config-template.json config.json   # 填入你的密钥（见下）
python app.py                          # 启动未央
# 前端：cd ../stardust-web && npm install && npm run dev

云端一键部署（Ubuntu，固定 IP）

部署到有公网固定 IP 的服务器，能彻底解决企业微信"可信IP"反复失效的问题。

git clone https://github.com/<你>/weiyang.git && cd weiyang
cp deploy/weiyang.env.example deploy/weiyang.env   # 填密钥
bash deploy/deploy.sh

详见 deploy/README.md。

配置（密钥从不入库）

所有密钥放在 未提交 的 CowAgent/config.json（本地）或 deploy/weiyang.env（服务器）。需要：

• zhipu_ai_api_key — 智谱 GLM（对话 + 向量 + 语音 + 视觉）
• wechatcom_corp_id / wechatcomapp_agent_id / _secret / _token / _aes_key — 企业微信自建应用

参考 CowAgent/config-template.json。

License

引擎部分沿用 CowAgent 的 MIT（见 CowAgent/LICENSE，版权归原作者 zhayujie）。本仓库的定制与前端同样以 MIT 提供。