智能微秘书-插件版 Docker镜像文档

镜像概述

本镜像基于Wechaty构建，是一款个人开源智能微信机器人解决方案。通过将闲置微信号转化为智能微秘书，提供个人日常提醒、情侣互动、群管理等功能，支持非web版微信登录（突破传统web微信登录限制）。项目采用Wechaty面板插件实现，源码可参考wechaty-web-panel。

核心功能与特性

个人秘书功能

• 定时任务系统：支持当日提醒（例："提醒 我 18:00 下班带物品"）、每日提醒（例："提醒 我 每天 7:00 起床"）、指定日期提醒（例："提醒 我 2024-12-25 8:00 圣诞节"）
• 多对象每日说：支持向多个联系人定时发送个性化消息（含天气、每日一句等），满足情侣互动需求
• 纪念日管理：重要日期提醒功能

***管理功能

• 群定时任务：群资讯定时发送、群规则定时提醒
• 群机器人交互：支持群内聊天互动、消息自动回复
• 群特色工具：群合影生成、多群消息同步

实用查询工具

• 生活服务：天气查询、垃圾分类（例："?香蕉皮"）、老黄历查询
• 趣味功能：土情话查询、顺口溜生成、神回复、表情包获取、美女图查询
• 知识工具：名人名言、姓氏起源（例："姓陈"）、星座运势（例："*双子座"）

系统特性

• 配置自动更新：发送指定关键词（默认"更新"）即可拉取新配置，支持自定义关键词
• 主动管理能力：主动发送消息、同步好友/群列表、更新配置
• 跨平台支持：兼容Windows、Mac、Centos系统

使用场景

• 个人日常管理：日程提醒、纪念日跟踪、***惯养成
• 情侣互动：每日天气+情话定时发送、重要日期提醒
• 社群运营：群规则提醒、行业资讯定时推送、群互动增强
• 效率工具：快速查询天气、垃圾分类、生活常识

前置准备

1. 注册智能微秘书管理账号

1. 访问智能微秘书注册页完成注册
2. 登录后进入"小助手配置->基础配置"完成初始化设置并保存
3. 在"个人中心"获取APIKEY和APISECRET（后续配置必需）

2. 注册天行数据账号

大部分资讯和接口依赖天行数据，需注册并申请接口权限：

• 必选接口：天行机器人、天气、新闻、垃圾分类
• 可选接口：土味情话、名人名言、星座运势、姓氏起源（使用天行机器人时可不单独申请） 注册地址：天行数据

Docker部署指南

推荐：直接拉取镜像

Step 1: 拉取镜像

shell
docker pull aibotk/wechat-assistant

Step 2: 配置API信息

1. 在本地创建src目录，新建index.js文件
2. 在文件中配置APIKEY和APISECRET（从智能微秘书个人中心获取）

Step 3: 启动容器

选择以下任一方式启动：

前台运行（查看实时日志）：

shell
docker run --name=wechatBot --volume="$(pwd)/src/":/bot/src aibotk/wechat-assistant

后台运行：

shell
docker run -d --name=wechatBot --volume="$(pwd)/src/":/bot/src aibotk/wechat-assistant

首次启动会下载puppet组件，可能较慢，请耐心等待。查看日志可参考Docker日志查看方法

可选：自行构建镜像（不推荐）

1. 配置src/index.js中的APIKEY和APISECRET
2. 构建镜像：

shell
docker build -t wechat-assistant .

3. 运行容器：

shell
docker run wechat-assistant

功能配置与使用

1. 容器启动后，终端会显示登录***，扫码登录微信
2. 登录智能微秘书管理面板配置所需功能
3. 向登录的微信发送"更新"关键词（或自定义更新关键词）拉取最新配置
4. 开始使用各项功能（如发送"上海天气"测试天气查询，或设置定时任务）

常见问题

• 登录问题：支持非web版微信登录，若提示登录失败请检查网络或重新扫码
• 功能不生效：确认已发送"更新"关键词同步配置，或检查天行数据接口权限
• Docker日志：使用docker logs wechatBot查看运行日志，docker logs -f wechatBot实时跟踪

免责声明

本项目基于Wechaty开源项目开发，仅供个人学和非商业用途。使用时请遵守国家及微信使用条款，严禁用于非法活动。任何因违规使用导致的账号风险或责任，均由使用者自行承担。

更多资源

• 功能详情：智能微秘书功能介绍
• 更新日志：CHANGELOG
• 交流群：添加微信小助手（扫描项目文档***）获取进群方式