账神AI广告
安装及配置手册

大白话版 · 照着做就能装上、配好、验通 · 给老板和技术一起看

版本 v41 · 配套系统 40.0.0+ 日期 2026-08-08 生产入口 https://agqqs.com/ims/ 工程目录 ag-ims
这本手册教你什么？
教你怎么把「账神AI广告」装到电脑/服务器、怎么接到账神「更多→智能营销」、 怎么改配置（收录、AI、口令、日志）、上版后怎么自测。
蓝标签=老板也能做 橙标签=建议技术人员做 日常怎么点菜单，另看《用户操作使用手册》。

1. 先搞懂：装的是什么

一句话：装的是一个门店营销工作台网站，和账神同域名，老板进店后点「智能营销」就能用。

浏览器
→
Nginx
→
ag-ims
3780
→
店数据
JSON
装好以后你会得到
  • 营销台页面：https://agqqs.com/ims/
  • 健康检查：https://agqqs.com/api/health-ims
  • 账神入口：进店 → 更多 → 智能营销
  • 分享落地页：https://agqqs.com/ims-promo.html（给微信出图文卡）
不糊弄，边界先说清
  • 「一键发全域」= 本系统记发布回执 + 短链，不是自动登录各 AI 官方后台发帖。
  • 收录默认 smart（智能模拟）；真探针要另配 IMS_INDEX_HTTP_URL。
  • AI 改写没配 Key 时用本地模板；配了 Key 才走真模型。

2. 三种人怎么选路径

你是谁目标看哪一章
老板 确认线上能打开、会进自己的店 §5 验收 + 《用户操作手册》
老板+技术 把新版本推到网上 §6 一键部署
技术 本机调试、改配置、查日志 §7 本机 + §8～§17

3. 安装结构对照图

安装结构示意图

图：浏览器 → Nginx → ag-ims(3780) → 数据；左边本机、中间一键上版、右边关键配置

生产营销台截图

图：生产站实时看板（装好后应长这样，版本以健康检查为准）

看板结构

图：左边菜单 + 顶部按钮 + GEO 卡片（对照用）

4. 装之前要准备什么

老板侧

技术侧

项要求
本机代码E:\zbs\zbs_cursor\AG\ag-ims，旁有 ag-app
Node.js建议 18+（能跑 npm start）
生产机已有 VPS（如 root@47.98.18.240），装好 Nginx、pm2、Node
SSH本机可 ssh root@47.98.18.240 / scp
域名证书agqqs.com HTTPS 已通（账神同机）
关键目录别搞混
营销工程：E:\zbs\zbs_cursor\AG\ag-ims
账神工程：E:\zbs\zbs_cursor\AG\ag-app
生产目录：/opt/ag-ims　静态落地页：/var/www/agqqs/

5. 路径 A：生产已上线——只验收 老板

如果技术已经部署过，老板不用装软件，按下面验一遍即可。

打开健康检查：
https://agqqs.com/api/health-ims
应看到 "ok":true 和 "version"（当前应为 40.0.0 或更新）
打开营销台：
https://agqqs.com/ims/?store_id=13810836570_求阙粉店
应看到左边菜单、顶部「分享微信」、实时看板
账神入口：打开 https://agqqs.com → 进店 → 更多 → 智能营销，应打开同域 /ims 并带上当前店
点顶部 分享微信，应弹出推广卡（有二维码）；再点「使用手册」应打开说明页
健康检查示例

图：健康检查返回示例（以线上实时 JSON 为准）

打不开怎么办（老板）
  1. 先看健康检查是不是 ok:true；不是就找技术看 pm2 / Nginx。
  2. 营销台白屏：按 Ctrl+F5 硬刷新；仍不行把网址发给技术。
  3. 店名不对：用带 store_id= 的完整链接，或从账神「更多」进。

6. 路径 B：一键部署到生产（推荐） 技术 老板可旁观

目标：把本机最新代码推到 VPS，重启服务，老板马上能在网上测。

操作步骤

在资源管理器打开：
E:\zbs\zbs_cursor\AG\ag-ims
确认能 SSH 到生产机（首次需配好密钥或密码）
双击 一键部署生产.bat
或命令行执行： 
cd /d E:\zbs\zbs_cursor\AG\ag-ims
一键部署生产.bat
脚本会自动：本地冒烟 → 上传 server/public → VPS 上 npm + pm2 重启 → 重载 Nginx → 可选同步账神静态站桥接
看窗口末尾是否出现健康检查 OK；再按 §5 做老板验收

等价命令（PowerShell）

cd E:\zbs\zbs_cursor\AG\ag-ims
npm run smoke:v36
npm run deploy:vps

部署时上传了什么

本地生产
server/ public/ package.json/opt/ag-ims/
ag-app/public/ims-promo.html/var/www/agqqs/ims-promo.html
ag-app/public/ims-promo-og.jpg/var/www/agqqs/ims-promo-og.jpg
Nginx 片段/etc/nginx/snippets/ag-ims.locations
第一次部署额外确认
VPS 上应有 /opt/ag-ims/.env（没有会从示例复制）。务必含 IMS_UI_BASE=/ims/，否则样式/脚本路径会错。

7. 路径 C：本机 Windows 安装调试 技术

打开命令行，进入工程： 
cd /d E:\zbs\zbs_cursor\AG\ag-ims
安装依赖： 
npm install
灌演示店（求阙粉店）： 
npm run seed
启动服务（默认端口 3780）： 
npm start
浏览器打开： 
http://127.0.0.1:3780/?store_id=13810836570_求阙粉店
本机健康检查： 
http://127.0.0.1:3780/api/health
本机日志 C:\Users\ASUS\AppData\Roaming\ag-ims\logs\ag-ims.log
看 START / 报错就打开这个文件。
本机数据 工程下 data/*.json，按 store_id 隔离。可在账户页导出备份。
端口被占用：换端口启动前设环境变量，例如 PowerShell： 
$env:IMS_PORT=3781
npm start
同时把账神侧打开地址改成对应端口（见 §11）。

8. 环境变量配置大全 技术

生产文件：/opt/ag-ims/.env（可参考 deploy/.env.production.example）

必配（生产）

变量推荐值大白话
IMS_PORT3780服务端口，给 Nginx 反代
IMS_HOST127.0.0.1只监听本机，外网走 Nginx
IMS_UI_BASE/ims/页面挂在 /ims/ 下时必须设，不然 CSS 丢
IMS_PUBLIC_ORIGINhttps://agqqs.com对外域名，拼短链/分享用
IMS_LOG_DIR/var/log/ag-ims生产日志目录

建议配

变量默认大白话
IMS_OPS_TOKENag-ims-ops运维调套餐口令，务必改成自己的强口令
IMS_ATTR_INGEST_TOKENag-ims-attr账神回传「到店/入会」口令，两边要一致
IMS_INDEX_MODEsmart收录：mock / smart / http
IMS_INDEX_HTTP_URL（空）真探针地址；空则不用 http

可选（增强）

变量说明
IMS_AI_API_KEY 或 DASHSCOPE_API_KEY真模型改写；不配=本地模板
IMS_AI_MODEL默认 qwen-plus
IMS_AI_BASE_URLOpenAI 兼容网关
IMS_AI_FORCE_LOCAL设 1 强制本地模板
IMS_EXPIRE_WEBHOOK钉钉/企微机器人，到期提醒
IMS_EXPIRE_WARN_DAYS默认 30 天内算将到期
IMS_EXPIRE_SCAN_MS扫描间隔，默认 6 小时
IMS_ATTR_WINDOW_DAYS归因窗口天数，默认 7

生产 .env 示例（可复制后改）

IMS_PORT=3780
IMS_HOST=127.0.0.1
IMS_UI_BASE=/ims/
IMS_PUBLIC_ORIGIN=https://agqqs.com
IMS_LOG_DIR=/var/log/ag-ims
IMS_OPS_TOKEN=请改成你的运维口令
IMS_ATTR_INGEST_TOKEN=请改成你的归因口令
IMS_INDEX_MODE=smart
# IMS_AI_API_KEY=
# IMS_INDEX_HTTP_URL=
改完 .env 必须重启：pm2 restart ag-ims（或重新跑一键部署）。

9. Nginx / 域名反代 技术

营销台和账神共用 agqqs.com。关键是：/api/ims/ 必须抢在通用 /api/ 前面，否则会进错后端。

必须存在的 location

路径作用
/ims/页面与静态资源 → 3780
/api/ims/接口 → 3780
/api/health-ims对外健康检查
/go/推广短链点击跳转

片段文件：ag-app/nginx/snippets/ag-ims.locations
部署脚本会同步到：/etc/nginx/snippets/ag-ims.locations

改完 Nginx 后

nginx -t
systemctl reload nginx
一键部署已包含 Nginx 同步与 reload。手动改时别忘了 include 进主站 conf。

10. pm2 进程与日志 技术

常用命令（SSH 上 VPS）

pm2 status
pm2 logs ag-ims --lines 80
pm2 restart ag-ims
pm2 describe ag-ims

日志在哪

环境路径
Windows 本机C:\Users\ASUS\AppData\Roaming\ag-ims\logs\ag-ims.log
Linux 生产/var/log/ag-ims/ag-ims.log
pm2 实时pm2 logs ag-ims
正常启动日志里应出现类似：
START | AG账神智能营销 SaaS v40.0.0 ... ui_base=/ims/

11. 接到账神「智能营销」入口

老板怎么用

打开账神 https://agqqs.com，进入自己的门店
点顶部 更多
点 智能营销 → 新开营销台，自动带当前店

技术怎么配

12. 第一家店：灌演示店 / 建店

演示店（推荐先跑通）

cd /d E:\zbs\zbs_cursor\AG\ag-ims
npm run seed

演示店：13810836570_求阙粉店
打开：https://agqqs.com/ims/?store_id=13810836570_求阙粉店

真实门店

从账神进店点「智能营销」（推荐，自动带 store_id / 店名）
或浏览器地址栏拼：?store_id=手机号_店名&store_name=店名
首次进入会 bootstrap 租户；再到「账户」核对套餐/有效期
点 一键开业包 / 补齐11入口账号 做首日配置
演示店首页

图：演示店打开后的首页实拍

13. 配置收录引擎（smart / http） 技术

模式何时用怎么设
mock纯演示、固定结果IMS_INDEX_MODE=mock
smart默认：智能模拟，够老板演示IMS_INDEX_MODE=smart
http接外部真探针mode=http + 填 IMS_INDEX_HTTP_URL

页面里也可在运维相关入口保存「收录引擎」配置（需运维权限/口令）。改完重启或按页面提示保存。

首页诚实条会写明当前是模拟还是真探针——别对外宣称「已官方直连收录」除非你真接了 http 探针。

14. 配置真 AI 改写（可选） 技术

在 .env 写入 IMS_AI_API_KEY=你的密钥（或 DASHSCOPE_API_KEY）
可选：IMS_AI_MODEL=qwen-plus
pm2 restart ag-ims
打开营销台「内容改写」，看提示是否还写「本地模板」——不应再写未配置 Key
没配 Key 也能用：走本地模板改写，不扣外部费用。

15. 运维口令 / 归因回传 / 到期提醒

运维口令

IMS_OPS_TOKEN：调套餐、部分运维接口需要。默认值务必改掉，只给内部。

归因回传

账神把「到店/入会」推给营销台时，请求头带 X-Ims-Attr-Token，值= IMS_ATTR_INGEST_TOKEN。

套餐到期提醒

16. 微信分享落地页与 OG 图

顶栏 分享微信 依赖根站落地页出图文卡：

文件作用
/var/www/agqqs/ims-promo.html分享纯链接落地（带 OG）
/var/www/agqqs/ims-promo-og.jpg微信卡片缩略图
分享缩略图

图：ims-promo-og.jpg（微信链接卡右侧小图）

诚实说明：微信内网页不能直接弹好友列表；可发带二维码图片卡，或配好图文卡后点右上角 ··· 发送。详见 v40 版本文档。

17. 备份、升级、回滚 技术

备份

升级

再跑一遍 一键部署生产.bat 即可（覆盖代码，一般保留 data 与 .env）。

回滚思路

18. 上线验收清单（打勾）

19. 常见问题 FAQ

Q1：页面打开了但没有样式？

多半是 IMS_UI_BASE 没设成 /ims/。改 .env 后重启 pm2，硬刷新浏览器。

Q2：接口 404 或进错系统？

检查 Nginx 是否 include 了 ag-ims.locations，且 /api/ims/ 在通用 /api/ 之前。

Q3：账神点智能营销打不开 / 连本机？

生产应走同域 /ims；重新 build+部署账神静态站。本机联调才用 3780。

Q4：分享只有几个字没有图？

确认 ims-promo.html 与 ims-promo-og.jpg 在根站；微信内用「发图片卡」或右上角分享（见 v40）。

Q5：二维码库网络失败？

v39 已改为本站 /ims/vendor/qrcode.min.js；硬刷新。仍失败看该文件是否 200。

Q6：日志在哪？

本机：%APPDATA%\ag-ims\logs\ag-ims.log；生产：/var/log/ag-ims/ag-ims.log。

20. 一张速查卡

老板三件事 ① 健康检查 OK
② /ims 能开店
③ 账神「更多→智能营销」
技术三件事 ① 一键部署 bat
② .env 含 UI_BASE=/ims/
③ pm2 + nginx 正常
本机三行 npm install
npm run seed
npm start
出问题先看 健康检查 JSON
ag-ims.log
pm2 logs ag-ims

配套文档：
· 使用：账神AI广告营销用户操作使用手册
· 版本脉络：docs/versions/README.md（v1→v41）

账神AI广告 · 安装及配置手册 v41 · 大白话 · 不糊弄 · 照着做就能用
工程：ag-ims　生产：agqqs.com/ims/