AI二开Tigshop流程（Codex）

Tigshop AI 二次开发操作手册

案例：后台新增“客服微信号”配置，并在商城页脚显示。

这份手册给第一次做二次开发的 Tigshop 用户使用。主流程是：确认需求、进行开发、由 AI 打包并部署上线。

路径、字段、权限、数据库影响、前后台联通、打包和部署检查，都应该让 AI 一次性完成，不需要用户拆成很多轮重复确认。

本手册保留 01 到 06 号已有过程截图，用于说明打开项目、确认需求、备份和开发结果；部署上线完成后不要求额外提供成果截图。

使用前提

本教程默认客户已经准备好以下条件：

有可用的服务器，并已安装宝塔面板；
宝塔中已经建好正式站点、目录、数据库和必要的运行环境；
项目需要的 Java、Node.js、数据库、缓存、反向代理等环境已经按项目要求配置；
已准备好后台账号、正式商城访问地址，以及宝塔或服务器登录授权；
如果要让 AI 直接部署，准备临时的服务器地址、宝塔地址、账号和密码。

本教程不负责从零安装服务器、宝塔和项目运行环境。环境不完整时，先让 AI 检查缺少什么，补齐后再进行打包部署。

一、打开源码包

从 Tigshop 官网下载并解压源码包。在 Codex 首页点击“项目”右侧的加号，选择“本地”，点击“下一步”，再选择解压后的源码文件夹。

打开项目后，直接进入下一步确认需求。

二、确认需求

这是我下载的 Tigshop 源码。我想在后台加一个“客服微信号”的设置，填好后显示在商城底部，没填就不显示。
你先熟悉项目，看看系统里有没有类似功能；如果没有，帮我整理成一份需求。
有不清楚的地方先问我，先不要开始改代码。

完成后应看到：AI 用中文复述功能，并询问必要的业务问题。

确认规则后发送：

就叫“客服微信号”，由管理员修改。除了微信号，也可以填手机号或一句说明。
保存后刷新商城就能看到，清空后就隐藏，其他设置照旧。
帮我把这些要求记成一份文档，再写一下开发完成后如何打包并部署上线。

完成后应看到：AI 整理好的功能规则和上线确认步骤。

三、进行开发

需求确认了，现在开始开发。
改之前先留一份可恢复的版本：能建功能分支就建分支，没有版本管理就备份整个项目。

请按需求完成“客服微信号”功能：后台可以填写并提交，商城页脚可以读取并显示，清空后自动隐藏。
开发完成后，请一次性告诉我：
1. 后台从哪个菜单进入，字段叫什么，点哪个按钮保存；
2. 商城在哪里查看，显示格式是什么；
3. 是否需要改数据库，如果需要，把脚本和影响说明写清楚；
4. 这次改了哪些关键文件；
5. 前端、后台和数据库是否需要分别打包；
6. 如何把开发成果打包并部署到正式宝塔站点，以及上线后从哪里查看。

不要把已经完成的功能拆成多轮重复确认；能从源码和配置中检查的请直接检查，发现问题先修好再汇报。

开发前应看到：AI 确认分支或备份已完成。

开发完成后应看到：AI 说明“客服微信号”功能已完成，并给出后台客服设置入口、填写保存方式、商城页脚查看位置，以及前后台配置读取链路已经接通的结论。

本案例中后台菜单路径为“客服 → 系统设置 → 客服设置”，当前实际路由为
/customer-service/settings/general；字段名称为“客服微信号”，可填写微信号、手机号或任意文字说明。
填写后点击页面底部“提交”，保存成功会提示“修改成功”。只有具备客服设置菜单权限
kefuSetting 和编辑权限 saveSettingKefuManage 的后台账号可以修改；商城用户没有修改入口。

四、打包并部署上线

功能开发完成后，让 AI 把成果整理并部署到正式宝塔站点。服务器登录信息只用于本次部署，不要写入代码、配置文件或发布包。

服务器、宝塔面板和项目运行环境已经准备好。下面请把这次“客服微信号”开发成果打包并部署到正式站点。

请一次性完成：
1. 检查前端、后台、数据库和运行环境是否具备打包条件；
2. 按项目实际结构构建前端和后台，处理构建报错；
3. 整理本次需要部署的文件和发布说明，不要把密码、令牌和无关文件放入项目或发布包；
4. 如果需要数据库脚本，单独列出脚本、影响和恢复方法；
5. 部署前先备份正式站点、当前程序和需要修改的数据库；
6. 使用我提供的服务器地址、宝塔地址、账号和密码完成上传、替换、数据库处理、服务重启和站点检查；
7. 部署完成后检查后台入口和商城首页是否可以正常访问；
8. 完成后告诉我部署结果、正式访问地址、后台入口、备份位置和数据库处理结果。

遇到无法连接、权限不足、目录不确定或数据库脚本有风险时，先停下来告诉我，不要猜测操作。
发现打包或部署问题先修好，再告诉我结果。

如果 AI 确认当前可以连接服务器，再单独发送本次部署使用的临时授权：

下面是本次部署使用的临时授权，请只用于刚才确认的正式站点部署，完成后不要保留：
服务器地址：……
宝塔地址：……
登录账号：……
临时密码：……

部署前先确认目标站点、备份位置和需要更新的目录，确认无误后再执行。

不要发送长期使用的最高权限账号。优先创建临时账号、临时密码或临时 SSH/API 授权；部署完成并确认网站正常后，立即修改服务器密码、宝塔密码和临时账号密码，并回收临时授权。

AI 完成后应说明：

部署的是正式站点；
前端、后台和数据库处理是否与当前源码版本一致；
正式访问地址和后台入口；
备份位置、数据库是否变更以及恢复方法；
部署过程中是否遇到异常。

五、上线后确认

打开 AI 返回的正式商城地址和后台地址，按下面步骤确认：

进入“客服 → 系统设置 → 客服设置”，填写“客服微信号”并点击“提交”；
打开商城首页，确认页脚显示“客服微信：填写的内容”；
修改“客服微信号”并再次提交，刷新商城，确认显示最新内容；
清空“客服微信号”并提交，刷新商城，确认“客服微信”这一行隐藏；
检查原有页脚、登录、商品、购物车、订单和其他客服设置没有变化。

上线后发现问题，直接把页面现象告诉 AI，不需要自己找代码：

我在正式站点后台填了“abc123”，提示保存成功，但刷新商城底部还是看不到。
请检查正式站点的部署结果和运行日志，修复后重新打包并部署，完成后告诉我，我再确认。

如果想调整样式，也直接描述希望看到的效果：

正式站点里客服微信号已经能显示了，不过字有点小。
请调成和旁边联系方式一样的字号和颜色，重新打包并部署，我再查看效果。

确认功能正常后，立即修改服务器密码、宝塔面板密码和本次使用的临时账号密码；如果使用了 SSH 密钥、API 令牌或其他临时授权，也一并回收。

本教程不要求提供部署截图。AI 部署完成后，直接返回正式访问地址、后台入口、备份位置和部署结果即可。

六、通用中文提问模板

我想在【页面】加一个【功能】，主要是为了【解决什么问题】。
希望能做到【想要的效果】。
你先看看现在有没有类似功能，再帮我整理需求，有不清楚的问我，确认后再开始做。