讯灵助手 —— 使用说明

用户画像

用户用大白话说出需求，AI 直接执行。

API 基础配置

Base URL: https://admin.g3pu.com/prod-api
所有请求需带 Header: Authorization: Bearer <token>
SSL: 服务器证书自签，所有 HTTPS 请求加 -SkipCertificateCheck (PS) 或 -k (curl)

功能零：登录

用户说"登录讯灵"或提供用户名密码时执行。

$body = @{username='<用户名>';password='<密码>'} | ConvertTo-Json
$r = Invoke-WebRequest -Uri 'https://admin.g3pu.com/prod-api/login' -Method Post -Body $body -ContentType 'application/json' -SkipCertificateCheck | ConvertFrom-Json
# 从 $r.data.accessToken 取 token，后续所有请求用此 token
# 从 $r.data.user.userId 取 userId

返回 code: 200 即成功。token 无固定过期时间。

功能一：发布间隔管理

API 速查

| 操作 | 方法 | 路径 | 参数 | |------|------|------|------| | 查看列表 | GET | /interval/list | ?mediaType=2 (2=自媒体 3=商业媒体 4=企业官网) | | 设置间隔 | POST | /interval/edit | {platform, intervalDays, dailyCount, mediaType} | | 删除间隔 | POST | /interval/delete | {platform, mediaType} | | 查看账号 | GET | /interval/accounts | — |

PowerShell 示例

# 查看发布间隔
$r = Invoke-WebRequest -Uri 'https://admin.g3pu.com/prod-api/interval/list?mediaType=2' -Headers @{Authorization="Bearer $token"} -SkipCertificateCheck | ConvertFrom-Json

# 设置知乎每天发3条
$body = '{"platform":"知乎","intervalDays":1,"dailyCount":3,"mediaType":2}'
Invoke-WebRequest -Uri 'https://admin.g3pu.com/prod-api/interval/edit' -Method Post -Body $body -ContentType 'application/json' -Headers @{Authorization="Bearer $token"} -SkipCertificateCheck

# 删除平台设置
$body = '{"platform":"知乎","mediaType":2}'
Invoke-WebRequest -Uri 'https://admin.g3pu.com/prod-api/interval/delete' -Method Post -Body $body -ContentType 'application/json' -Headers @{Authorization="Bearer $token"} -SkipCertificateCheck

功能二：官网改版（核心）

完整流程

1. 登录（获取 token）
2. GET /chat/company/data → 获取企业信息（公司名、行业、产品、地区、规模）
3. 根据企业信息 + 下方设计提示词 → 生成完整 HTML5 单文件
4. 将 HTML 写入本地目录，打包为 zip
5. POST /chat/website/upload-and-deploy → 上传部署，获取预览地址

步骤 2：获取企业数据

$r = Invoke-WebRequest -Uri 'https://admin.g3pu.com/prod-api/chat/company/data' -Headers @{Authorization="Bearer $token"} -SkipCertificateCheck | ConvertFrom-Json
$company = $r.data
# 字段：companyName, industry, mainProduct, province, scale, region

步骤 3：设计提示词（生成 HTML 时使用）

根据企业数据生成 HTML 之前，严格遵循以下设计提示词：

你是顶级前端设计师，为"{companyName}"生成一个可直接部署的单文件 HTML5 企业官网。

## 企业信息
- 公司名: {companyName}
- 行业: {industry}
- 主营产品: {mainProduct}
- 所在地区: {province}
- 规模: {scale}人

## 设计要求

### 1. 视觉风格
- 现代简约 + 高端质感，参考 Apple、Stripe、Linear 的设计语言
- 大面积留白，卡片式布局，圆角 12-16px
- 渐变色点缀（根据行业特征选择主色调，不超过 2 个主色）
- 柔和阴影: box-shadow 0 4px 24px rgba(0,0,0,0.06)
- 平滑过渡: transition all 0.3s cubic-bezier(0.4,0,0.2,1)

### 2. 排版规范
- 标题字体栈: system-ui, -apple-system, sans-serif
- Hero 标题 48-64px，字重 700-800
- 正文 16-18px，行高 1.7，字色 #4a4a5a
- 主标题与正文间距至少 24px

### 3. 必须包含的板块（按顺序）

**Hero 区**
- 全屏/大屏背景，渐变或网格纹理
- 居中布局，大字标题 + 副标题 + 2 个 CTA 按钮
- 主按钮填充色 16px 圆角，次按钮描边
- 几何装饰元素或简单粒子背景

**关于我们**
- 左右分栏：左文字右图片占位（用 emoji 或纯 CSS 图形）
- 数据指标：3-4 个数字（规模、覆盖地区、门店数、产品系列数）
- 指标数字加粗放大，CSS 计数动画

**核心优势**
- 3-4 个卡片网格布局
- 每卡：图标(emoji)+ 标题 + 描述
- hover 上浮 8px，阴影加深

**产品/服务展示**
- 卡片网格（3 列），根据主营产品设计
- 每卡：渐变图片占位区 + 名称 + 简介 + 标签
- 图片占位用 CSS 渐变，不用外部图片

**门店分布 / 案例**
- 按企业所在地区设计
- 地图风格卡片展示覆盖区域 或 发展历程时间线

**联系我们**
- 信息卡片 + 表单
- 包含地址/电话/邮箱占位
- 号召性文案"立即咨询"

**Footer**
- 版权信息 + 备案占位 + 返回顶部按钮
- 深色背景

### 4. 技术要求
- 单文件 HTML5，所有 CSS/JS 内联，零外部依赖
- 响应式三档：移动端单栏 / 平板两栏 / 桌面多栏
- 滚动动画：元素进入视口淡入上移（Intersection Observer）
- 导航栏 sticky + 毛玻璃 backdrop-filter
- 平滑滚动 scroll-behavior: smooth
- 右下角返回顶部按钮，滚动超过一屏后显示
- 不使用 Google Fonts / CDN / 外部图片

### 5. 输出要求
- 只输出完整 HTML，用 ```html 包裹
- CSS 在 <style> 中，JS 在 <script> 中
- 文字基于企业信息填充，合理延伸但不要捏造具体地址/电话
- 代码干净，适当注释分区

步骤 4：打包并部署

# 假设 HTML 已写入 $siteDir 目录
$zipPath = "$env:TEMP\site-deploy.zip"
Compress-Archive -Path "$siteDir\*" -DestinationPath $zipPath -Force

# 上传部署
$form = @{
    file = Get-Item $zipPath
    serverId = "2"
}
$r = Invoke-WebRequest -Uri 'https://admin.g3pu.com/prod-api/chat/website/upload-and-deploy' -Method Post -Form $form -Headers @{Authorization="Bearer $token"} -SkipCertificateCheck | ConvertFrom-Json
# $r.data.previewUrl 即为预览地址

用户对话示例

用户：帮我改版官网
AI：好的，正在获取企业数据并生成网站...
    预览地址：http://geob.g3pu.com/
    您看看效果，需要调整的地方告诉我。

用户：导航栏颜色深一点
AI：好的，调整后重新部署，预览地址不变。

用户：可以，发布吧
AI：部署成功！正式地址：http://geob.g3pu.com/

功能三：AI 备课管理（chat）

API 速查

| 操作 | 方法 | 路径 | 关键参数 | |------|------|------|----------| | 任务列表 | GET | /chat/task/list | ?mediaType=1&page=1&rows=20 | | 文章列表 | GET | /chat/content/list | ?taskId=<id>&page=1&rows=500 | | 文章详情 | GET | /chat/content/detail | ?id=<文章ID> | | 保存文章 | POST | /chat/content/save | {id, taskName, taskDescription, sensitive} | | 删除文章 | GET | /chat/content/delete | ?id=<文章ID> | | 同步发布 | POST | /chat/content/sync | {ids: [id1, id2]} | | 敏感词检测 | POST | /chat/words/check | {ids: [id1, id2]} |

mediaType: 1=自媒体授课 2=三方媒体授课 3=B2B授课

PowerShell 示例

# 查看任务列表
Invoke-WebRequest -Uri 'https://admin.g3pu.com/prod-api/chat/task/list?mediaType=1&page=1&rows=20' -Headers @{Authorization="Bearer $token"} -SkipCertificateCheck | ConvertFrom-Json

# 保存文章
$body = '{"id":123,"taskName":"标题","taskDescription":"Markdown正文","sensitive":""}'
Invoke-WebRequest -Uri 'https://admin.g3pu.com/prod-api/chat/content/save' -Method Post -Body $body -ContentType 'application/json' -Headers @{Authorization="Bearer $token"} -SkipCertificateCheck

错误处理

code: 401 → Token 过期，让用户重新提供账号密码登录
code: 500 → 查看 msg 字段获取错误原因，反馈给用户
网络超时 → 重试一次，仍失败则提示用户稍后再试