# 微信 AI 聊天助手

这是一个面向 macOS 微信桌面端的本地优先 AI 助手参考实现，展示从会话读取、上下文处理、模型编排到受控回复提交的完整工程链路。

本仓库由真实项目的可公开代码整理而成。联系人、地点、账号、本机路径、运行记录和个性化消息样本均已替换为通用示例；原始私有仓库及本地运行数据不会公开。

## 核心能力

- 通过 macOS Accessibility 与 Vision OCR 识别目标会话和可见消息。
- 提供只读历史、当前会话和受控发送三类 MCP 入口。
- 使用候选锁定、草稿核验、单次提交和发送读回保障回复幂等性。
- 对会话记忆进行加密存储、分页检索、敏感信息过滤和冲突处理。
- 支持 `dry-run`、`observe`、`supervised-send`、`live` 分阶段运行模式。
- 使用 TypeScript、Zod、Vitest 与 Swift 完成类型约束、业务测试和原生桥接验证。

## 安全边界

- 默认模式为 `observe`，只读且不发送消息。
- 真实发送必须经过明确授权、草稿验证与发送结果读回。
- 密钥、会话数据和个人资料不写入仓库；本地运行目录应保持 `0700` 权限。
- 不提供自动登录、盲坐标点击、验证码处理或绕过系统权限的能力。

## 本地验证

```bash
npm ci
npm run lint
npm run typecheck
npm test
npm run native:test
```

项目要求 Node.js 20，并在 macOS 上使用 Swift 工具链验证原生桥接部分。`npm test` 使用串行文件模式，避免发布事务类测试与清理 `dist/` 的测试并行运行时互相影响。

## 目录

- `src/`：会话、记忆、策略、MCP 与运行时核心逻辑。
- `native/`：macOS OCR、窗口识别和受控输入桥接。
- `tests/`：单元测试、集成测试和边界场景验证。
- `scripts/`：构建、安装和受控发布脚本。
- `config/`：脱敏后的发布权限边界示例配置。
- `assets/`：脱敏后的测试图片素材。
- `prompts/`：不含个人信息的通用提示模板。

## 脱敏说明

公开版使用“示例用户”“示例联系人”“示例城市”等占位数据。仓库不包含原项目的私人联系人、真实地点、聊天记录、运行日志、验证回执、项目记忆或本机凭据。

## 许可

本仓库暂未添加开源许可证，仅作为作品集和技术交流展示；未经作者许可，请勿直接复制、商用或用于真实账号自动化。