chore: update application-hapr191 profile

Made-with: Cursor
chore(admin): point development VUE_APP_BASE_API to local backend
2026-04-10 11:26:49 +08:00 · 2026-04-09 15:20:10 +08:00 · 2026-04-09 15:12:42 +08:00
31 changed files with 3686 additions and 206 deletions
--- a/backend-adminend/.env.development
+++ b/backend-adminend/.env.development
@@ -3,16 +3,15 @@ ENV = 'development'

 # base api
 # VUE_APP_BASE_API = '/dev-api'
-#  VUE_APP_BASE_API = 'http://127.0.0.1:30032'
+ VUE_APP_BASE_API = 'http://127.0.0.1:30032'
 # VUE_APP_BASE_API = 'https://jfadmin.suzhouyuqi.com'
 # VUE_APP_BASE_API = 'http://jfanyueadmin.szxingming.com'
 # VUE_APP_BASE_API = 'http://jfadmin.wenjinhui.com'
 # VUE_APP_BASE_API = 'http://jfadmin-bsy.bosenyuan.com'
-# byjyw149 项目（宝应金雅文商贸）
-VUE_APP_BASE_API = 'https://jf.jinyawen.com'

 # hapr191 项目（淮安鹏然商贸）
-# VUE_APP_BASE_API = 'http://jfadmin.hapengran.com'
+# VUE_APP_BASE_API = 'http://jf.hapengran.com'
+
 # shccd159 项目
 # VUE_APP_BASE_API = 'http://ccd-jfadmin.cichude.com'

--- a/backend-adminend/.env.production
+++ b/backend-adminend/.env.production
@@ -8,11 +8,8 @@ ENV = 'production'
 # miao33 项目
 # VUE_APP_BASE_API = 'http://jfadmin.xiashengjun.com'  

-# byjyw149 项目（宝应金雅文商贸）
-VUE_APP_BASE_API = 'https://jf.jinyawen.com'
-
 # hapr191 项目（淮安鹏然商贸）
-# VUE_APP_BASE_API = 'http://jfadmin.hapengran.com'
+VUE_APP_BASE_API = 'http://jfadmin.hapengran.com'

 # shccd159 项目
 # VUE_APP_BASE_API = 'http://ccd-jfadmin.cichude.com'
--- a/backend/crmeb-admin/src/main/resources/application-czc231.yml
+++ b/backend/crmeb-admin/src/main/resources/application-czc231.yml
@@ -1,59 +0,0 @@
-# CRMEB 相关配置
-crmeb:
-  captchaOn: false # 是否开启行为验证码
-  asyncConfig: true #是否同步config表数据到redis
-
-server:
-  port: 30032
-
-sync:
-  source-id: shop_10
-  target-mer-id: 10
-
-spring:
-  datasource:
-    name: yangtangyoupin
-    type: com.alibaba.druid.pool.DruidDataSource
-    driver-class-name: com.mysql.jdbc.Driver
-    url: jdbc:mysql://8.136.120.231:3306/${spring.datasource.name}?useUnicode=true&serverTimezone=GMT%2B8&characterEncoding=utf8
-    username: yangtangyoupin
-    password: 5Fn8eWrbYFtAhCZw
-  redis:
-    host: 8.136.120.231 #地址
-    port: 6379 #端口
-    password: '123456'
-    timeout: 10000 # 连接超时时间（毫秒）
-    database: 2 #默认数据库
-    jedis:
-      pool:
-        max-active: 200 # 连接池最大连接数（使用负值表示没有限制）
-        max-wait: -1 # 连接池最大阻塞等待时间（使用负值表示没有限制）
-        max-idle: 10 # 连接池中的最大空闲连接
-        min-idle: 0 # 连接池中的最小空闲连接
-        time-between-eviction-runs: -1 #逐出扫描的时间间隔(毫秒) 如果为负数,则不运行逐出线程, 默认-1
-    second:
-      database: 2 # 微信accessToken存储库
-
-debug: true
-logging:
-  level:
-    io.swagger.*: error
-    com.zbjk.crmeb: debug
-    org.springframework.boot.autoconfigure: ERROR
-  config: classpath:logback-spring.xml
-  file:
-    path: ./logs
-
-# mybatis 配置
-mybatis-plus:
-  # 配置sql打印日志
-  configuration:
-    log-impl:
-
-#swagger 配置
-swagger:
-  basic:
-    enable: true #是否开启界面
-    check: false #是否打开验证
-    username: crmeb #访问swagger的账号
-    password: crmeb.com #访问swagger的密码
--- a/backend/crmeb-admin/src/main/resources/application-hapr191.yml
+++ b/backend/crmeb-admin/src/main/resources/application-hapr191.yml
@@ -7,8 +7,8 @@ server:
  port: 30032

 sync:
-  source-id: shop_11
-  target-mer-id: 11
+  source-id: shop_9
+  target-mer-id: 9

 spring:
  datasource:
--- a/backend/crmeb-admin/src/main/resources/application.yml
+++ b/backend/crmeb-admin/src/main/resources/application.yml
@@ -38,7 +38,7 @@ server:

 spring:
  profiles:
-    active: byjyw149
+    active: hapr191
  servlet:
    multipart:
      max-file-size: 50MB #设置单个文件大小
--- a/backend/crmeb-front/src/main/java/com/zbkj/front/controller/WaUserController.java
+++ b/backend/crmeb-front/src/main/java/com/zbkj/front/controller/WaUserController.java
@@ -73,7 +73,7 @@ public class WaUserController {
        FileInputStream fileInputStream = null;
        try {
            // 读取模板PDF文件
-            Resource resource = new ClassPathResource("pdf/sign_contract_byjyw149.pdf");
+            Resource resource = new ClassPathResource("pdf/sign_contract_pengran.pdf");
            InputStream pdfInputStream = resource.getInputStream();
            document = PDDocument.load(pdfInputStream);
            pdfInputStream.close();
@@ -199,7 +199,7 @@ public class WaUserController {
 //                    user.setContract("https://anyue.szxingming.com/"+pdfResultVo.getUrl());
 //                    user.setContract("https://xiashengjun.com/"+pdfResultVo.getUrl());
 //                    user.setContract("https://ccd.cichude.com/"+pdfResultVo.getUrl());
-                    user.setContract("https://jinyawen.com/"+pdfResultVo.getUrl());
+                    user.setContract("https://hapengran.com/"+pdfResultVo.getUrl());
                    waUsersDao.updateById(user);
                }
                return CommonResult.success(pdfResultVo);
--- a/backend/crmeb-front/src/main/resources/application-byjyw149.yml
+++ b/backend/crmeb-front/src/main/resources/application-byjyw149.yml
@@ -1,54 +0,0 @@
-crmeb:
-  imagePath: /www/wwwroot/jinyawen.com/ # 金雅文商贸服务器图片路径 斜杠结尾
-  asyncConfig: true #是否同步config表数据到redis
-
-server:
-  port: 30031
-
-spring:
-  datasource:
-    name: yangtangyoupin
-    type: com.alibaba.druid.pool.DruidDataSource
-    driver-class-name: com.mysql.jdbc.Driver
-    url: jdbc:mysql://8.140.218.149:3306/${spring.datasource.name}?useUnicode=true&serverTimezone=GMT%2B8&characterEncoding=utf8
-    username: yangtangyoupin
-    password: 5Fn8eWrbYFtAhCZw
-  redis:
-    host: 8.140.218.149 #地址
-    port: 6379 #端口
-    password: '123456'
-    timeout: 10000 # 连接超时时间（毫秒）
-    database: 2 #默认数据库
-    jedis:
-      pool:
-        max-active: 200 # 连接池最大连接数（使用负值表示没有限制）
-        max-wait: -1 # 连接池最大阻塞等待时间（使用负值表示没有限制）
-        max-idle: 10 # 连接池中的最大空闲连接
-        min-idle: 0 # 连接池中的最小空闲连接
-        time-between-eviction-runs: -1 #逐出扫描的时间间隔(毫秒) 如果为负数,则不运行逐出线程, 默认-1
-    second:
-      database: 3 # 微信accessToken存储库
-
-debug: true
-logging:
-  level:
-    io.swagger.*: error
-    com.zbjk.crmeb: debug
-    org.springframework.boot.autoconfigure: ERROR
-  config: classpath:logback-spring.xml
-  file:
-    path: ./logs
-
-# mybatis 配置
-mybatis-plus:
-  # 配置sql打印日志
-  configuration:
-    log-impl:
-
-#swagger 配置
-swagger:
-  basic:
-    enable: true #是否开启界面
-    check: false #是否打开验证
-    username: crmeb #访问swagger的账号
-    password: crmeb.com #访问swagger的密码
--- a/backend/crmeb-front/src/main/resources/application-czc231.yml
+++ b/backend/crmeb-front/src/main/resources/application-czc231.yml
@@ -1,54 +0,0 @@
-crmeb:
-  imagePath: /www/wwwroot/chenzhaochun.com/ # 晨召春商贸服务器图片路径 斜杠结尾
-  asyncConfig: true #是否同步config表数据到redis
-
-server:
-  port: 30031
-
-spring:
-  datasource:
-    name: yangtangyoupin
-    type: com.alibaba.druid.pool.DruidDataSource
-    driver-class-name: com.mysql.jdbc.Driver
-    url: jdbc:mysql://8.136.120.231:3306/${spring.datasource.name}?useUnicode=true&serverTimezone=GMT%2B8&characterEncoding=utf8
-    username: yangtangyoupin
-    password: 5Fn8eWrbYFtAhCZw
-  redis:
-    host: 8.136.120.231 #地址
-    port: 6379 #端口
-    password: '123456'
-    timeout: 10000 # 连接超时时间（毫秒）
-    database: 2 #默认数据库
-    jedis:
-      pool:
-        max-active: 200 # 连接池最大连接数（使用负值表示没有限制）
-        max-wait: -1 # 连接池最大阻塞等待时间（使用负值表示没有限制）
-        max-idle: 10 # 连接池中的最大空闲连接
-        min-idle: 0 # 连接池中的最小空闲连接
-        time-between-eviction-runs: -1 #逐出扫描的时间间隔(毫秒) 如果为负数,则不运行逐出线程, 默认-1
-    second:
-      database: 3 # 微信accessToken存储库
-
-debug: true
-logging:
-  level:
-    io.swagger.*: error
-    com.zbjk.crmeb: debug
-    org.springframework.boot.autoconfigure: ERROR
-  config: classpath:logback-spring.xml
-  file:
-    path: ./logs
-
-# mybatis 配置
-mybatis-plus:
-  # 配置sql打印日志
-  configuration:
-    log-impl:
-
-#swagger 配置
-swagger:
-  basic:
-    enable: true #是否开启界面
-    check: false #是否打开验证
-    username: crmeb #访问swagger的账号
-    password: crmeb.com #访问swagger的密码
--- a/backend/crmeb-front/src/main/resources/application.yml
+++ b/backend/crmeb-front/src/main/resources/application.yml
@@ -32,7 +32,7 @@ server:

 spring:
  profiles:
-    active: byjyw149
+    active: hapr191
  servlet:
    multipart:
      max-file-size: 50MB #设置单个文件大小
--- a/backend/crmeb-front/src/main/resources/pdf/sign_contract_byjyw149.pdf
+++ b/backend/crmeb-front/src/main/resources/pdf/sign_contract_byjyw149.pdf
--- a/backend/crmeb-front/src/main/resources/pdf/sign_contract_chenzhaochun.pdf
+++ b/backend/crmeb-front/src/main/resources/pdf/sign_contract_chenzhaochun.pdf
--- a/backend/crmeb-front/src/main/resources/pdf/sign_contract_czrt6.pdf
+++ b/backend/crmeb-front/src/main/resources/pdf/sign_contract_czrt6.pdf
--- a/backend/deploy.conf
+++ b/backend/deploy.conf
@@ -97,20 +97,3 @@ REMOTE_DIR_ADMIN=/www/wwwroot/jfadmin.hapengran.com
 REMOTE_DIR_FRONT=/www/wwwroot/jf.hapengran.com


-czc231:
-  spring:
-    profiles:
-      active: czc231
-
-SERVER_HOST=8.136.120.231
-SERVER_USER=root
-SERVER_PORT=22
-REMOTE_DIR_JAR=/www/wwwroot/javaapi
-FRONT_LOCAL_PORT=30031
-FRONT_JAR_NAME=miao-front-2.2.jar
-ADMIN_LOCAL_PORT=30032
-ADMIN_JAR_NAME=miao-admin-2.2.jar
-REMOTE_DIR_ADMIN=/www/wwwroot/admin.chenzhaochun.com
-REMOTE_DIR_FRONT=/www/wwwroot/jf.chenzhaochun.com
-
-
--- a/change-list-shjjy153.md
+++ b/change-list-shjjy153.md
@@ -0,0 +1,157 @@
+# shjjy153 分支变更清单
+
+## 分支信息
+- **分支名称**: shjjy153
+- **创建时间**: 2026-03-14
+- **基础分支**: main
+
+## 变更概述
+
+本分支主要针对 jjy（集佳易）项目进行配置更新和功能优化，涉及后端配置文件、控制器以及前端页面的修改。
+
+## 详细变更内容
+
+### 1. 后端配置变更
+
+#### 1.1 新增配置文件
+- **文件**: `backend/crmeb-front/src/main/resources/application-shjjy153.yml`
+- **变更类型**: 新增
+- **说明**: 创建 jjy 项目的专属配置文件
+
+#### 1.2 配置文件更新
+- **文件**: `backend/crmeb-front/src/main/resources/application-shjjy153.yml`
+- **变更类型**: 修改
+- **变更内容**: 
+  - **第 2 行**: `imagePath` 从 `/www/wwwroot/ccd.fwxgpt.com/` 改为 `/www/wwwroot/jjy.fwxgpt.com/`
+  - **说明**: 适配 jjy 项目服务器图片路径
+
+#### 1.3 主配置文件
+- **文件**: `backend/crmeb-front/src/main/resources/application.yml`
+- **变更类型**: 修改
+- **变更说明**: 配置调整
+
+### 2. 后端代码变更
+
+#### 2.1 用户控制器 - WaUserController.java
+- **文件**: `backend/crmeb-front/src/main/java/com/zbkj/front/controller/WaUserController.java`
+- **变更类型**: 修改
+- **变更行数**: +5, -2
+- **详细变更内容**:
+  - **第 76 行**: PDF 模板文件路径变更
+    ```java
+    // 原来：Resource resource = new ClassPathResource("pdf/sign_contract_ccd.pdf");
+    // 现在：Resource resource = new ClassPathResource("pdf/sign_contract_jjy.pdf");
+    ```
+    - **说明**: 将 PDF 合同模板从 ccd 版本切换到 jjy 版本
+  
+  - **第 202 行**: 用户合同 URL 配置变更
+    ```java
+    // 原来：user.setContract("https://ccd.fwxgpt.com/"+pdfResultVo.getUrl());
+    // 现在：user.setContract("https://jjy.fwxgpt.com/"+pdfResultVo.getUrl());
+    ```
+    - **说明**: 将用户合同存储地址切换到 jjy 项目域名
+
+### 3. 前端配置变更
+
+#### 3.1 应用配置 - app.js
+- **文件**: `single_uniapp22miao/config/app.js`
+- **变更类型**: 修改
+- **变更行数**: +4, -2
+- **详细变更内容**:
+  - **第 8 行**: API 请求域名变更
+    ```javascript
+    // 原来：let domain = 'https://jfanyue.szxingming.com'
+    // 现在：let domain = 'https://jjy-jf.fwxgpt.com'
+    ```
+  - **第 9 行**: 注释掉 CCD 域名配置
+    ```javascript
+    // let domain = 'https://ccd-jf.fwxgpt.com'
+    ```
+  - **说明**: 将前端 API 请求域名切换到 jjy 项目环境
+
+### 4. 前端页面变更
+
+#### 4.1 首页 - index.vue
+- **文件**: `single_uniapp22miao/pages/index/index.vue`
+- **变更类型**: 修改
+- **变更行数**: +2, -1
+- **详细变更内容**:
+  - **第 37 行**: PDF 合同文件路径变更
+    ```vue
+    pdfUrl: '/static/sign_contract_jjy.pdf',
+    ```
+  - **说明**: 将默认加载的 PDF 合同从通用版本切换到 jjy 版本
+
+#### 4.2 积分页面 - points.vue
+- **文件**: `single_uniapp22miao/pages/integral/points.vue`
+- **变更类型**: 修改
+- **变更行数**: +4, -1
+- **详细变更内容**:
+  - **第 341 行**: 抢购页面跳转链接变更
+    ```javascript
+    // 原来：window.location.href = 'https://ccd.fwxgpt.com/?#/pages/personal/index'
+    // 现在：window.location.href = 'https://jjy.fwxgpt.com/?#/pages/personal/index'
+    ```
+  - **第 342-344 行**: 注释掉其他项目域名配置
+    ```javascript
+    // window.location.href = 'https://shop.wenjinhui.com/?#/pages/personal/index'
+    // window.location.href = 'https://anyue.szxingming.com/?#/pages/personal/index'
+    ```
+  - **说明**: 将跳转链接切换到 jjy 项目个人中心页面
+
+#### 4.3 签名预览页面 - sign-preview.vue
+- **文件**: `single_uniapp22miao/pages/sub-pages/webview/sign-preview.vue`
+- **变更类型**: 修改
+- **变更行数**: +2, -1
+- **变更说明**: 优化签名预览功能，可能涉及 PDF 加载逻辑
+
+#### 4.4 签名页面 - sign.vue
+- **文件**: `single_uniapp22miao/pages/sub-pages/webview/sign.vue`
+- **变更类型**: 修改
+- **变更行数**: +2, -1
+- **详细变更内容**:
+  - **第 363 行**: 签名提交后返回逻辑优化
+    ```javascript
+    // 优化了返回上一页面的延迟处理
+    setTimeout(() => {
+      uni.navigateBack();
+    }, /* 调整延迟时间 */);
+    ```
+  - **说明**: 优化用户体验，确保操作完成后返回
+
+## 变更统计
+
+- **修改文件总数**: 8 个文件
+- **代码增加**: 15 行
+- **代码删除**: 12 行
+- **净增加**: 3 行
+
+## 主要功能模块
+
+1. **配置管理**: 完成 jjy 项目的独立配置
+2. **用户模块**: 优化用户控制器功能
+3. **积分系统**: 优化积分页面功能
+4. **电子签名**: 优化签名相关页面功能
+
+## 部署说明
+
+### 后端部署
+1. 使用 `shjjy153` 配置文件启动服务
+2. 确保服务器路径 `/www/wwwroot/jjy.fwxgpt.com/` 可访问
+3. 重启后端服务
+
+### 前端部署
+1. 重新编译前端项目
+2. 更新配置文件
+3. 部署到对应环境
+
+## 测试建议
+
+1. 验证图片上传和访问功能
+2. 测试用户相关接口
+3. 验证积分页面功能
+4. 测试电子签名功能
+
+## 备注
+
+本分支是基于 shjjy153 分支的进一步开发，主要针对 jjy 项目进行定制化配置和功能优化。
--- a/company-data-imgration.md
+++ b/company-data-imgration.md
@@ -0,0 +1,35 @@
+
+# 公司名称：淮安鹏然商贸
+
+## mysql数据库配置信息
+
+host ip: 114.55.232.191
+datasource:
+    name: yangtangyoupin
+    username: yangtangyoupin
+    password: 5Fn8eWrbYFtAhCZw
+
+## 数据删除任务
+
+- 保留的**用户数据范围**：wa_users.id in (91956,92474,92540,92824,93208,92576,92809,93182,92905,93080,93099,93113,93132,93164,93133,93142,93194,93204,93111,93139,93100,93158,93161,93163,93176,92476,93123,93108,93193,93165,93162,93159)，删除其余用户数据
+
+- wa_order
+只保留“created_at >= 2026-03-31”并且user_id在用户数据范围的订单，删除其余数据
+
+- wa_merchandise
+只保留“created_at >= 2026-03-31”并且seller_id或buyer_id在用户数据范围的寄售商品，删除其余数据
+
+
+- wa_selfbonus_log
+
+- wa_sharebonus_log
+
+
+
+- wa_coupon_log
+
+- 新建hapr191分支，合并shjjy153分支的最新代码到该分支，并根据上述信息修改相关需要变更项，使符合该新公司项目环境
+
+## 相关文件
+
+- company-info.md
--- a/company-info.md
+++ b/company-info.md
@@ -0,0 +1,51 @@
+
+## 公司名称：淮安鹏然商贸
+
+host ip: 114.55.232.191
+
+### crmeb-front模块变更
+
+- 1. profile: hapr191
+- 2. profile file: application-hapr191.yml
+- 3. PDF合同模板文件路径：pdf/sign_contract_pengran.pdf
+- 4. 用户合同url地址前缀/落库域名：https://hapengran.com/
+- 5. imagePath: /www/wwwroot/hapengran.com/
+
+### uniapp前端配置变更
+
+- 1. 积分商城domain：https://jf.hapengran.com
+- 2. 抢购页面跳转地址：https://hapengran.com
+- 2. /static/sign_contract_pengran.pdf
+
+### 修改任务
+
+- 新建hapr191分支，合并shjjy153分支的最新代码到该分支，并根据上述信息修改相关需要变更项，使符合该新公司项目环境
+
+## 相关文件
+
+- change-list-shjjy153.md
+- compare-shjjy153-shccd159.md
+
+## 积分商城nginx站点配置
+
+、、、
+    # 伪静态
+    location / {
+        try_files $uri $uri/ /index.html;
+    }
+    
+    # 后端API
+    location /api/admin {
+    proxy_pass http://127.0.0.1:30032/api/admin;
+    }
+    
+    # 前端API
+    location /api/front {
+    proxy_pass http://127.0.0.1:30031/api/front;
+    }
+、、、
+
+、、、启动积分商城api服务
+cd /www/wwwroot/javaapi
+nohup java -Xms128m -Xmx256m -jar miao-front-2.2.jar > front.log & tail -f front.log
+、、、
--- a/compare-shjjy153-shccd159.md
+++ b/compare-shjjy153-shccd159.md
@@ -0,0 +1,57 @@
+# shjjy153 与 shccd159 分支对比
+
+## 1. 提交差异
+
+- **shjjy153 独有**：`0f02cb7 shjjy153: 新增 deploy-front-shjjy153.sh，更新配置`
+- **shccd159**：无此提交，因此没有 `deploy-front-shjjy153.sh`
+
+---
+
+## 2. 文件差异
+
+| 文件 | shjjy153 | shccd159 |
+|------|----------|----------|
+| **backend/shell/deploy-front-shjjy153.sh** | 存在 | 不存在 |
+| **backend/shell/deploy-front-shccd159.sh** | 存在 | 存在 |
+| **application.yml** `spring.profiles.active` | `shjjy153` | `shccd159` |
+| **single_uniapp22miao/config/app.js** | `jjy-jf.fwxgpt.com` | `ccd-jf.fwxgpt.com` |
+
+---
+
+## 3. 配置差异
+
+### application.yml（默认 profile）
+
+```yaml
+# shjjy153
+spring.profiles.active: shjjy153
+
+# shccd159
+spring.profiles.active: shccd159
+```
+
+### single_uniapp22miao/config/app.js（API 与 H5 域名）
+
+| 配置 | shjjy153 | shccd159 |
+|------|----------|----------|
+| domain | `https://jjy-jf.fwxgpt.com` | `https://ccd-jf.fwxgpt.com` |
+| HTTP_H5_URL | `https://jjy-jf.fwxgpt.com` | `https://ccd-jf.fwxgpt.com` |
+
+---
+
+## 4. 部署环境（deploy.conf）
+
+两分支的 `deploy.conf` 相同，均包含 shjjy153 与 shccd159 两套配置：
+
+| 环境 | 服务器 | 域名 |
+|------|--------|------|
+| **shjjy153** | 101.132.245.153 | jjy-jf.fwxgpt.com / jjy-jfadmin.fwxgpt.com |
+| **shccd159** | 182.92.78.159 | ccd-jf.fwxgpt.com / ccd-jfadmin.fwxgpt.com |
+
+---
+
+## 5. 小结
+
+- **shjjy153**：面向 jjy 项目，默认 profile=shjjy153，有 `deploy-front-shjjy153.sh`
+- **shccd159**：面向 ccd 项目，默认 profile=shccd159，无 `deploy-front-shjjy153.sh`
+- 其余代码与配置基本一致，差异集中在默认 profile、前端 API 域名及部署脚本
--- a/logs/30031/log_debug.log
+++ b/logs/30031/log_debug.log
--- a/logs/30031/log_error.log
+++ b/logs/30031/log_error.log
--- a/logs/30031/log_info.log
+++ b/logs/30031/log_info.log
--- a/logs/30031/log_warn.log
+++ b/logs/30031/log_warn.log
--- a/openclaw_agent_configuration_v2.plan.md
+++ b/openclaw_agent_configuration_v2.plan.md
--- a/openclaw_agent_configuration_v3.plan.md
+++ b/openclaw_agent_configuration_v3.plan.md
@@ -0,0 +1,946 @@
+---
+name: Agent Configuration v3s
+overview: 基于本机实际 OpenClaw 环境检查结果修正的配置方案。在现有 1 个 main Agent + 1 个飞书应用的基础上，增量添加 1 个积分商城 PM + 3 个通用开发 Agent，不影响已有配置。
+todos:
+  - id: create-feishu-apps
+    content: 在飞书开放平台创建 4 个机器人应用（或复用现有应用做路由）
+    status: pending
+  - id: update-openclaw-json
+    content: 在现有 openclaw.json 中追加 4 个 Agent、bindings 和飞书账号
+    status: pending
+  - id: create-workspaces
+    content: 创建 4 个 Agent workspace 目录和全套 .md 文件
+    status: pending
+  - id: install-skills
+    content: 安装本地 Skills 和 ClawHub Skills
+    status: pending
+  - id: register-and-verify
+    content: 运行 openclaw doctor 验证配置
+    status: pending
+isProject: false
+---
+
+# OpenClaw 多 Agent 配置方案 v3s -- 1 PM + 3 通用开发
+
+> **v3s 核心变更（相对 v3）：**
+>
+> 1. 后端/前端/QA 三个 Agent 从"积分商城专用"改为**通用软件开发工程师**，可服务于任何项目
+> 2. 仅 PM 保留为积分商城专属项目经理
+> 3. Agent ID 重命名：`integral-backend/frontend/qa` → `dev-backend/frontend/qa`
+> 4. 项目路径确认为 `/Users/mac/scott-macair-26/integral-shop`
+> 5. 通用开发 Agent 的 SOUL.md 移除特定技术栈锁定，改为"按项目要求适配"
+
+---
+
+## 一、实际环境概况
+
+### 1.1 本机 OpenClaw 配置（不可变动）
+
+- **运行环境：** macOS，OpenClaw 2026.3.13
+- **配置文件：** `/Users/mac/.openclaw/openclaw.json`
+- **已有 Agent：** 仅 1 个（main）
+- **已有飞书：** 1 个应用（`cli_a930893990799cba`），websocket 连接，1 条 binding（main → default）
+- **模型 provider：** moonshot（Kimi K2.5）+ kimi-coding（k2p5），共用同一 API key
+- **默认模型：** `kimi-coding/k2p5`
+- **Gateway：** 端口 18789，local 模式，token 鉴权
+- **本地 Skills：** 0 个（仅飞书插件自带 feishu-doc/drive/perm/wiki）
+- **Workspace：** 1 个共享 workspace，默认模板状态
+
+### 1.2 积分商城项目信息
+
+- **项目路径：** `/Users/mac/scott-macair-26/integral-shop`
+- **Gitea：** `http://49.235.131.69:3000/scottpan/integral-shop.git`
+- **子项目：**
+  - `backend/` → Java Spring Boot 后端（Java 1.8 / Spring Boot 2.2.6 / MyBatis Plus 3.3.1 / MySQL 5.7）
+  - `backend-adminend/` → 管理后台 Vue 前端（Vue 2.6 / Element UI 2.13）
+  - `single_uniapp22miao/` → 用户端 uni-app H5（Vue 3 / uni-app）
+
+---
+
+## 二、Agent 角色设计（1 专用 PM + 3 通用开发）
+
+**设计理念：** PM 是项目专属的（绑定积分商城的需求、PRD、部署流程），但开发能力是通用的。3 个开发 Agent 可以同时服务于积分商城和未来的其他项目，PM 通过任务分派告诉它们具体的项目上下文。
+
+```mermaid
+flowchart TB
+    User[用户/飞书] -->|积分商城需求| PM["integral-pm (积分商城 PM)"]
+    User -->|其他项目/通用编码任务| BE["dev-backend (通用后端)"]
+    User -->|其他项目/通用编码任务| FE["dev-frontend (通用前端)"]
+    User -->|其他项目/通用编码任务| QA["dev-qa (通用测试)"]
+    PM -->|后端任务 + 项目上下文| BE
+    PM -->|前端任务 + 项目上下文| FE
+    PM -->|测试计划 + 项目上下文| QA
+    BE -->|API 就绪| FE
+    BE -->|提测| QA
+    FE -->|提测| QA
+    QA -->|Bug 反馈| BE
+    QA -->|Bug 反馈| FE
+    QA -->|测试报告| PM
+    QA -.->|部署申请| PM
+    PM -.->|部署审批| QA
+```
+
+| Agent ID          | 角色           | 职责范围                                    |
+| ----------------- | ------------ | --------------------------------------- |
+| **integral-pm**   | 积分商城项目经理 + 设计 | 积分商城需求拆解、PRD、UI 规范、任务分派、进度跟踪、部署审批     |
+| **dev-backend**   | 通用后端开发工程师    | 任意项目的后端开发（Java/Python/Go/Node 等，按项目要求适配） |
+| **dev-frontend**  | 通用前端开发工程师    | 任意项目的前端开发（Vue/React/uni-app 等，按项目要求适配）  |
+| **dev-qa**        | 通用测试工程师      | 任意项目的功能测试、接口测试、UI 测试、部署执行               |
+
+---
+
+## 三、Agent 间通信协议
+
+### 3.1 通信方式
+
+采用**独立飞书应用方案**（每个 Agent 一个飞书机器人），通过 accountId 路由。
+
+用户可以直接私聊任何开发 Agent 下达通用编码任务；积分商城相关任务则通过 PM 分派。
+
+### 3.2 消息协议格式
+
+PM 分派任务时必须携带项目上下文：
+
+```
+【任务分派】<标题>
+发送方: integral-pm
+接收方: @<dev-agent>
+关联任务: <task-id>
+项目: 积分商城
+项目路径: /Users/mac/scott-macair-26/integral-shop
+---
+<任务描述>
+<技术栈约束>（如有）
+<验收标准>
+```
+
+开发 Agent 之间、开发与 PM 之间的其他消息类型：任务分派、API-就绪、提测通知、Bug-反馈、测试报告、部署申请、部署审批、进度更新。
+
+### 3.3 任务状态机
+
+```
+Created → InProgress → CodeReview → Testing → Passed → DeployApproval → Deploying → Done
+                                      ↓                      ↓
+                                   BugFound ← ─ ─ ─ ─ ─ ─ ─ ┘
+                                      ↓
+                                  InProgress（修复后重新流转）
+```
+
+---
+
+## 四、openclaw.json 增量修改
+
+**原则：只追加，不修改已有配置。**
+
+### 4.1 在 `agents` 中新增 `list` 字段
+
+当前 `agents` 节点只有 `defaults`，需新增 `list`：
+
+```json
+"agents": {
+  "defaults": {
+    ... // 保持不变
+  },
+  "list": [
+    {
+      "id": "integral-pm",
+      "name": "integral-pm",
+      "workspace": "/Users/mac/.openclaw/workspace-integral-pm",
+      "agentDir": "/Users/mac/.openclaw/agents/integral-pm/agent",
+      "model": "kimi-coding/k2p5"
+    },
+    {
+      "id": "dev-backend",
+      "name": "dev-backend",
+      "workspace": "/Users/mac/.openclaw/workspace-dev-backend",
+      "agentDir": "/Users/mac/.openclaw/agents/dev-backend/agent",
+      "model": "kimi-coding/k2p5"
+    },
+    {
+      "id": "dev-frontend",
+      "name": "dev-frontend",
+      "workspace": "/Users/mac/.openclaw/workspace-dev-frontend",
+      "agentDir": "/Users/mac/.openclaw/agents/dev-frontend/agent",
+      "model": "kimi-coding/k2p5"
+    },
+    {
+      "id": "dev-qa",
+      "name": "dev-qa",
+      "workspace": "/Users/mac/.openclaw/workspace-dev-qa",
+      "agentDir": "/Users/mac/.openclaw/agents/dev-qa/agent",
+      "model": "kimi-coding/k2p5"
+    }
+  ]
+}
+```
+
+### 4.2 在 `bindings` 数组中追加 4 条飞书路由
+
+```json
+"bindings": [
+  {
+    "agentId": "main",
+    "match": { "channel": "feishu", "accountId": "default" }
+  },
+  {
+    "agentId": "integral-pm",
+    "match": { "channel": "feishu", "accountId": "jfshop@macair26" }
+  },
+  {
+    "agentId": "dev-backend",
+    "match": { "channel": "feishu", "accountId": "dev-backend@macair" }
+  },
+  {
+    "agentId": "dev-frontend",
+    "match": { "channel": "feishu", "accountId": "dev-frontend@macair" }
+  },
+  {
+    "agentId": "dev-qa",
+    "match": { "channel": "feishu", "accountId": "dev-qa@macair" }
+  }
+]
+```
+
+### 4.3 在 `channels.feishu` 中追加 `accounts`
+
+```json
+"channels": {
+  "feishu": {
+    "enabled": true,
+    "appId": "cli_a930893990799cba",
+    "appSecret": "FfpFz93MKBx0ytC1ceTPF0BnjM7vFVhQ",
+    "connectionMode": "websocket",
+    "domain": "feishu",
+    "groupPolicy": "open",
+    "dmPolicy": "open",
+    "allowFrom": ["*"],
+    "accounts": {
+      "jfshop@macair26": {
+        "appId": "cli_a930893990799cba",
+        "appSecret": "FfpFz93MKBx0ytC1ceTPF0BnjM7vFVhQ",
+        "agent": "integral-pm",
+        "dmPolicy": "open",
+        "allowFrom": ["*"]
+      },
+      "dev-backend@macair": {
+        "appId": "cli_a9316e2a92385bc7",
+        "appSecret": "t7YyQU1qgqJFiW95HfA1SgnUBdlpx0F1",
+        "agent": "dev-backend",
+        "dmPolicy": "open",
+        "allowFrom": ["*"]
+      },
+      "dev-frontend@macair": {
+        "appId": "cli_a9316ef6f5785bb6",
+        "appSecret": "dhJ3uAKWtZDzXce25YJ2HXHhw32eBGFR",
+        "agent": "dev-frontend",
+        "dmPolicy": "open",
+        "allowFrom": ["*"]
+      },
+      "dev-qa@macair": {
+        "appId": "cli_a9316f026ebadbc8",
+        "appSecret": "PHN6UZgU21NGMCW5C6boQckDMFo228un",
+        "agent": "dev-qa",
+        "dmPolicy": "open",
+        "allowFrom": ["*"]
+      }
+    }
+  }
+}
+```
+
+### 4.4 不变动的部分
+
+`meta`、`wizard`、`auth`、`models`、`tools`、`commands`、`session`、`gateway`、`plugins`、main Agent 的 binding 全部保持不变。
+
+---
+
+## 五、双模型架构
+
+| 层        | 用途        | Agent                  | 模型                              |
+| -------- | --------- | ---------------------- | ------------------------------- |
+| OpenClaw | 飞书对话、任务协调 | 全部                     | kimi-coding/k2p5（已有）            |
+| Cursor   | 代码编写      | integral-pm            | `agent --model claude-4.6-opus` |
+| Cursor   | 代码编写      | dev-backend/frontend/qa | `agent --model auto`            |
+
+---
+
+## 六、Skills 配置
+
+### 6.1 阶段一：最小启动集（Day 1）
+
+仅使用 OpenClaw 内置 Tools：
+
+| 内置 Tool      | integral-pm | dev-backend | dev-frontend | dev-qa |
+| ------------ | :---------: | :---------: | :----------: | :----: |
+| git          |      ●      |      ●      |       ●      |    ●   |
+| file-manager |      ●      |      ●      |       ●      |    ●   |
+| web-search   |      ●      |      ●      |       ●      |    ●   |
+| browser      |      ●      |      -      |       ●      |    ●   |
+| code-runner  |      -      |      ●      |       ●      |    ●   |
+| http-request |      -      |      ●      |       -      |    ●   |
+| **合计**       |    **4**    |    **5**    |     **5**    |  **6** |
+
+### 6.2 阶段二：核心 Skills（Day 2-3）
+
+```bash
+# 搜索 ClawHub 可用 Skill
+openclaw skills search gitea
+openclaw skills search cursor
+openclaw skills search code-review
+```
+
+按搜索结果安装 cursor-cli、gitea-tools 等。
+
+### 6.3 阶段三：按需引入（Week 2+）
+
+代码审查、自动化测试、摘要等。
+
+---
+
+## 七、各 Agent Workspace 配置
+
+---
+
+### 1. PM Agent (integral-pm) — 积分商城专属
+
+**workspace 路径：** `/Users/mac/.openclaw/workspace-integral-pm/`
+
+**IDENTITY.md:**
+
+```markdown
+# IDENTITY.md
+
+- **Name:** 积分商城PM
+- **Creature:** AI 项目经理
+- **Vibe:** 结构化、专业、高效
+- **Emoji:** 📋
+```
+
+**SOUL.md:**
+
+```markdown
+# SOUL.md - 积分商城 PM
+
+## 角色定义
+积分商城项目的专属项目经理兼 UI 设计指导。
+负责积分商城的需求拆解、任务分派、进度跟踪、部署审批。
+
+## 管辖项目
+- 项目名称: 单商户积分商城
+- 项目路径: /Users/mac/scott-macair-26/integral-shop
+- Gitea: http://49.235.131.69:3000/scottpan/integral-shop.git
+
+## 下属 Agent
+- dev-backend: 通用后端开发（分派任务时须附带项目上下文和技术栈约束）
+- dev-frontend: 通用前端开发（同上）
+- dev-qa: 通用测试工程师（同上）
+
+## 沟通风格
+- 结构化、简洁、中文为主
+- 任务分派必须使用标准消息协议，且包含项目路径和技术栈约束
+- 不说废话，直接给结论和下一步行动
+
+## 决策原则
+- MVP 优先、增量迭代
+- 技术方案交由开发 Agent 决定，PM 不干预实现细节
+- 部署审批必须确认：测试通过率 ≥ 95%、无 P0 Bug
+
+## 设计输出
+以文字描述 + 参考截图形式交付 UI 规范。
+管理后台遵循 Element UI 2.13 风格，用户端遵循现有积分商城 H5 风格。
+
+## 积分商城技术栈约束（分派任务时传递给开发 Agent）
+### 后端
+- Java 1.8（禁止 Java 9+）、Spring Boot 2.2.6（禁止 3.x）、MyBatis Plus 3.3.1、MySQL 5.7（禁止 8.0 特性）、Maven 3.6.1、Redis 5.x
+
+### 管理后台前端 (backend-adminend/)
+- Vue 2.6（禁止 Vue 3）、Element UI 2.13（禁止 Element Plus）、Vuex 3.x（禁止 Pinia）
+
+### 用户端 H5 (single_uniapp22miao/)
+- uni-app + Vue 3、微信小程序兼容
+
+## 禁止行为
+- 禁止自行修改本文件（SOUL.md）或 AGENTS.md
+```
+
+**AGENTS.md:**
+
+```markdown
+# AGENTS.md - PM 工作规范
+
+## Session Startup
+1. Read SOUL.md
+2. Read USER.md
+3. Read memory/YYYY-MM-DD.md（今天 + 昨天）
+4. Read plans/ 下最新的 PRD
+
+## 工作流
+1. 收到需求 → 写 PRD 到 plans/<feature>.md
+2. 拆解为子任务 → 写入 tasks/<YYYY-MM-DD>-<feature>-<subtask>.md
+3. 通过飞书分别通知 dev-backend / dev-frontend / dev-qa
+   **重要：** 分派任务时必须附带以下项目上下文：
+   - 项目路径: /Users/mac/scott-macair-26/integral-shop
+   - 涉及的子项目: backend/ 或 backend-adminend/ 或 single_uniapp22miao/
+   - 技术栈约束（从 SOUL.md 的"积分商城技术栈约束"部分复制）
+   - Git 分支规范和 Gitea 地址
+
+## 任务分派模板
+```
+【任务分派】<标题>
+发送方: integral-pm
+接收方: @<dev-agent>
+关联任务: <task-id>
+项目: 积分商城
+项目路径: /Users/mac/scott-macair-26/integral-shop
+子项目: <backend | backend-adminend | single_uniapp22miao>
+Gitea: http://49.235.131.69:3000/scottpan/integral-shop.git
+分支规范: feature/<role>-<name>
+---
+## 需求描述
+<需求正文>
+
+## 技术栈约束
+<从 SOUL.md 复制对应子项目的技术栈约束>
+
+## 验收标准
+<AC 列表>
+```
+
+## 部署审批流程
+1. 收到 dev-qa 的【部署申请】
+2. 检查：测试报告通过率 ≥ 95%、无 P0 Bug
+3. 测试环境（by80）/ 预发布环境（miao33）: 直接批准
+4. 生产环境（miao50）: 需 @用户 人工确认后批准
+5. 回复【部署审批】消息
+
+## Cursor 使用
+- agent --model claude-4.6-opus
+- 用途: 需求分析、代码审阅、架构设计
+
+## Memory
+- 每日进度汇总到 memory/YYYY-MM-DD.md
+```
+
+**TOOLS.md:**
+
+```markdown
+# TOOLS.md - PM 环境信息
+
+## 积分商城项目
+- 源码路径: /Users/mac/scott-macair-26/integral-shop
+- Gitea: http://49.235.131.69:3000/scottpan/integral-shop.git
+- 编码工具: Cursor IDE (macOS)
+
+## 子项目结构
+- backend/              → Java Spring Boot 后端
+- backend-adminend/     → 管理后台 Vue 前端
+- single_uniapp22miao/  → 用户端 uni-app H5
+
+## SSH 部署环境
+- 部署脚本: backend/shell/deploy-admin-*.sh, deploy-front-*.sh
+- 部署配置: backend/deploy.conf
+- 环境分级:
+  - by80:   测试环境（PM 审批）
+  - miao33: 预发布环境（PM 审批）
+  - miao50: 生产环境（PM 审批 + 用户确认）
+- Admin JAR 远程端口: 30032
+- Front JAR 远程端口: 30031
+
+## Cursor CLI
+- 模型: agent --model claude-4.6-opus
+- 项目目录: /Users/mac/scott-macair-26/integral-shop
+
+## 已启用 Tools
+- 内置: git, file-manager, web-search, browser
+```
+
+---
+
+### 2. 通用后端开发 (dev-backend)
+
+**workspace 路径：** `/Users/mac/.openclaw/workspace-dev-backend/`
+
+**IDENTITY.md:**
+
+```markdown
+# IDENTITY.md
+
+- **Name:** 后端开发
+- **Creature:** AI 后端工程师
+- **Vibe:** 技术精确、严谨、适应力强
+- **Emoji:** ⚙️
+```
+
+**SOUL.md:**
+
+```markdown
+# SOUL.md - 通用后端开发工程师
+
+## 角色定义
+通用后端开发工程师。可服务于任何项目的后端开发工作，不绑定特定项目或技术栈。
+
+## 核心能力
+- Java / Spring Boot / MyBatis 生态
+- Python / FastAPI / Django
+- Node.js / Express / Nest.js
+- Go 后端开发
+- 数据库设计与优化（MySQL / PostgreSQL / MongoDB / Redis）
+- RESTful API 和 GraphQL 设计
+- 微服务架构
+
+## 工作原则
+- 接收任务时，严格遵守任务中指定的**技术栈版本约束**
+- 如果任务未指定版本，使用项目现有版本，不擅自升级
+- 接口变更须提供文档并说明影响范围
+- 代码编写在 Cursor IDE 中完成
+
+## 沟通风格
+技术精确。变更通知包含：变更接口列表、请求/响应格式变化、影响的前端页面。
+
+## 禁止行为
+- 禁止在未获得 PM 或用户明确批准的情况下引入新依赖
+- 禁止擅自修改项目配置文件中的端口、数据库连接等关键配置
+- 禁止自行修改本文件（SOUL.md）或 AGENTS.md
+```
+
+**AGENTS.md:**
+
+```markdown
+# AGENTS.md - 通用后端开发工作规范
+
+## Session Startup
+1. Read SOUL.md
+2. Read USER.md
+3. Read memory/YYYY-MM-DD.md（今天 + 昨天）
+
+## 接收任务方式
+1. **从 PM 接收**：PM 分派的任务包含项目路径、技术栈约束、验收标准，严格按要求执行
+2. **从用户直接接收**：用户可以直接私聊下达编码任务，按用户指示执行
+
+## 通用开发流程
+1. 阅读任务描述，确认项目路径和技术栈约束
+2. 在对应项目目录中创建 feature/<role>-<name> 分支（或按任务指定的分支规范）
+3. 在 Cursor 中编码: agent --model auto
+4. 完成后通知前端（如有 API 变更）和 QA（提测）
+5. 使用任务指定的消息协议格式发送通知
+
+## 故障恢复
+- Cursor CLI 失败: git stash → 记录 memory/errors.md → 通知 PM 或用户
+- 构建失败: 分析日志 → 尝试修复 → 3 次失败后上报
+
+## Memory
+- 记录各项目的关键信息到 memory/ 下，方便后续会话恢复上下文
+```
+
+**TOOLS.md:**
+
+```markdown
+# TOOLS.md - 后端开发环境
+
+## 本机环境 (macOS)
+- IDE: Cursor
+- 可用语言运行时: Java, Python, Node.js, Go（按项目需要）
+
+## 已知项目
+
+### 积分商城（由 integral-pm 管理）
+- 项目路径: /Users/mac/scott-macair-26/integral-shop/backend
+- 技术栈: Java 1.8 / Spring Boot 2.2.6 / MyBatis Plus 3.3.1 / MySQL 5.7 / Maven 3.6.1
+- 本地运行:
+  - Admin API: mvn spring-boot:run -pl crmeb-admin (端口 8080)
+  - Front API: mvn spring-boot:run -pl crmeb-front (端口 8081)
+- 打包:
+  - Admin: mvn clean package -pl crmeb-admin -am -DskipTests
+  - Front: mvn clean package -pl crmeb-front -am -DskipTests
+- 模块: crmeb-admin / crmeb-front / crmeb-service / crmeb-common
+- Gitea: http://49.235.131.69:3000/scottpan/integral-shop.git
+- 分支规范: feature/backend-<name>, bugfix/backend-<name>
+
+（接手新项目时，在此追加项目信息）
+
+## Cursor CLI
+- 模型: agent --model auto
+
+## 已启用 Tools
+- 内置: git, file-manager, web-search, code-runner, http-request
+```
+
+---
+
+### 3. 通用前端开发 (dev-frontend)
+
+**workspace 路径：** `/Users/mac/.openclaw/workspace-dev-frontend/`
+
+**IDENTITY.md:**
+
+```markdown
+# IDENTITY.md
+
+- **Name:** 前端开发
+- **Creature:** AI 前端工程师
+- **Vibe:** 创意、注重细节、灵活适配
+- **Emoji:** 🖥️
+```
+
+**SOUL.md:**
+
+```markdown
+# SOUL.md - 通用前端开发工程师
+
+## 角色定义
+通用前端开发工程师。可服务于任何项目的前端开发工作，不绑定特定项目或技术栈。
+
+## 核心能力
+- Vue 2.x / Vue 3.x 全家桶
+- React / Next.js
+- uni-app / 微信小程序
+- Element UI / Ant Design / Tailwind CSS
+- TypeScript
+- Webpack / Vite 构建工具
+- 响应式设计与跨端适配
+
+## 工作原则
+- 接收任务时，严格遵守任务中指定的**技术栈版本约束**
+- **特别注意**：同一项目可能有多个前端子项目使用不同技术栈（如 Vue 2 管理后台 + Vue 3 用户端），切换时必须确认当前技术栈
+- 如果任务未指定版本，使用项目现有版本，不擅自升级
+- 代码编写在 Cursor IDE 中完成
+
+## 沟通风格
+展示关键代码片段和页面效果说明。
+
+## 禁止行为
+- 禁止在未获得 PM 或用户明确批准的情况下引入新 npm 依赖
+- 禁止在不同技术栈的子项目间共享组件（可能不兼容）
+- 禁止自行修改本文件（SOUL.md）或 AGENTS.md
+```
+
+**AGENTS.md:**
+
+```markdown
+# AGENTS.md - 通用前端开发工作规范
+
+## Session Startup
+1. Read SOUL.md
+2. Read USER.md
+3. Read memory/YYYY-MM-DD.md（今天 + 昨天）
+
+## 接收任务方式
+1. **从 PM 接收**：PM 分派的任务包含项目路径、子项目、技术栈约束
+2. **从用户直接接收**：用户可直接私聊下达编码任务
+
+## 通用开发流程
+1. 阅读任务描述，确认项目路径、子项目和技术栈约束
+2. **关键步骤**：确认当前子项目的技术栈版本（避免 Vue 2 项目中写 Vue 3 代码）
+3. 创建 feature/frontend-<name> 分支
+4. 在 Cursor 中编码: agent --model auto
+5. 与后端协作获取 API 文档
+6. 完成后通知 QA 提测
+
+## 故障恢复
+- 构建失败: 检查 Node 版本和 NODE_OPTIONS 环境变量
+- Cursor CLI 失败: git stash → 通知 PM 或用户
+```
+
+**TOOLS.md:**
+
+```markdown
+# TOOLS.md - 前端开发环境
+
+## 本机环境 (macOS)
+- Node.js: 17+
+- IDE: Cursor
+
+## 已知项目
+
+### 积分商城（由 integral-pm 管理）
+
+#### 管理后台 (backend-adminend/)
+- 路径: /Users/mac/scott-macair-26/integral-shop/backend-adminend
+- 技术栈: Vue 2.6 / Element UI 2.13 / Vuex 3.x / Vue Router 3.x
+- 开发: npm run dev（端口 9527）
+- 构建: npm run build:prod → dist/
+- 注意: Node 17+ 需 export NODE_OPTIONS="--openssl-legacy-provider"
+
+#### 用户端 H5 (single_uniapp22miao/)
+- 路径: /Users/mac/scott-macair-26/integral-shop/single_uniapp22miao
+- 技术栈: uni-app + Vue 3、微信小程序兼容
+- 配置: config/app.js（API 基地址）
+- 开发: npm run dev:h5
+- 构建: npm run build:h5 → unpackage/dist/build/h5/
+
+- Gitea: http://49.235.131.69:3000/scottpan/integral-shop.git
+- 分支规范: feature/frontend-<name>, bugfix/frontend-<name>
+
+（接手新项目时，在此追加项目信息）
+
+## Cursor CLI
+- 模型: agent --model auto
+
+## 已启用 Tools
+- 内置: git, file-manager, web-search, code-runner, browser
+```
+
+---
+
+### 4. 通用测试工程师 (dev-qa)
+
+**workspace 路径：** `/Users/mac/.openclaw/workspace-dev-qa/`
+
+**IDENTITY.md:**
+
+```markdown
+# IDENTITY.md
+
+- **Name:** 测试工程师
+- **Creature:** AI QA 工程师
+- **Vibe:** 严谨、细致、不放过任何 Bug
+- **Emoji:** 🧪
+```
+
+**SOUL.md:**
+
+```markdown
+# SOUL.md - 通用测试工程师
+
+## 角色定义
+通用 QA 测试工程师 + 部署执行。可服务于任何项目的测试和部署工作。
+
+## 核心能力
+- 功能测试、接口测试、UI 测试、回归测试
+- SSH 部署执行与验证
+- 测试用例编写
+- Bug 分析与根因定位（只读分析，不修改源码）
+
+## 工作原则
+- 部署操作必须走 PM 审批流程（有 PM 管理的项目）
+- 用户直接下达的部署任务可直接执行
+- 生产环境部署始终需要用户人工确认
+
+## Bug 描述规范
+1. 复现步骤（精确到操作路径）
+2. 期望结果
+3. 实际结果
+4. 截图/日志
+5. 影响范围评估（P0-P2）
+
+## 禁止行为
+- 禁止修改源代码（只报 Bug，不自行修复）
+- 禁止自行修改本文件（SOUL.md）或 AGENTS.md
+```
+
+**AGENTS.md:**
+
+```markdown
+# AGENTS.md - 通用 QA 工作规范
+
+## Session Startup
+1. Read SOUL.md
+2. Read USER.md
+3. Read memory/YYYY-MM-DD.md（今天 + 昨天）
+
+## 接收任务方式
+1. **从 PM 接收**：PM 分派的任务包含项目上下文、测试范围
+2. **从用户/开发 Agent 接收**：提测通知或直接测试任务
+
+## 通用测试流程
+1. 阅读任务描述和 API 文档
+2. 编写测试用例: tasks/test-<project>-<YYYY-MM-DD>-<feature>.md
+3. 执行测试:
+   - 后端 API: http-request 工具调用接口
+   - 前端 UI: browser 工具访问页面截图
+4. Bug 报告: tasks/bug-<project>-<YYYY-MM-DD>-<id>.md
+5. 测试通过 → 向 PM 发送测试报告
+
+## 部署流程
+### 有 PM 管理的项目（如积分商城）
+1. 发送【部署申请】给 PM → 等待审批 → 执行部署 → 验证
+2. 生产环境需 PM 审批 + 用户确认
+
+### 用户直接交办的部署
+1. 按用户指示执行，生产环境仍需用户确认
+
+## 部署后验证
+- 健康检查、核心接口可用性、页面可访问性
+
+## Cursor 使用
+- agent --model auto
+- 用途: 编写测试脚本、分析 Bug 根因（只读）
+```
+
+**TOOLS.md:**
+
+```markdown
+# TOOLS.md - QA 测试环境
+
+## 本机环境 (macOS)
+- IDE: Cursor
+
+## 已知项目
+
+### 积分商城（由 integral-pm 管理）
+- 项目路径: /Users/mac/scott-macair-26/integral-shop
+- 本地服务:
+  - 管理后台前端: http://localhost:9527
+  - Admin API: http://localhost:8080
+  - Front API: http://localhost:8081
+- SSH 部署:
+  - 脚本: backend/shell/deploy-admin-*.sh, deploy-front-*.sh
+  - 配置: backend/deploy.conf
+  - 环境分级:
+    - by80:   测试环境（PM 审批）
+    - miao33: 预发布环境（PM 审批）
+    - miao50: 生产环境（PM 审批 + 用户确认）
+  - Admin JAR 端口: 30032
+  - Front JAR 端口: 30031
+- Gitea: http://49.235.131.69:3000/scottpan/integral-shop.git
+
+（接手新项目时，在此追加项目信息）
+
+## Cursor CLI
+- 模型: agent --model auto
+
+## 已启用 Tools
+- 内置: git, file-manager, web-search, code-runner, browser, http-request
+```
+
+---
+
+## 八、Git 工作流（积分商城）
+
+```
+main                        # 生产分支
+  develop                   # 开发主分支
+    feature/backend-<name>  # 后端功能分支
+    feature/frontend-<name> # 前端功能分支
+    bugfix/backend-<name>   # 后端修复分支
+    bugfix/frontend-<name>  # 前端修复分支
+    release/<version>       # 发布分支
+```
+
+> 其他项目的 Git 工作流按各项目要求，由 PM 或用户在任务中指定。
+
+---
+
+## 九、初始化步骤
+
+### 步骤 1：在飞书开放平台创建 4 个机器人应用
+
+| 应用名称      | accountId          | appId                    | 状态   |
+| --------- | ------------------ | ------------------------ | ---- |
+| 积分商城-PM  | jfshop@macair26    | `cli_a930893990799cba`   | ✅ 复用现有 |
+| 后端开发      | dev-backend@macair | `cli_a9316e2a92385bc7`   | ✅ 已创建 |
+| 前端开发      | dev-frontend@macair| `cli_a9316ef6f5785bb6`   | ✅ 已创建 |
+| 测试工程师     | dev-qa@macair      | `cli_a9316f026ebadbc8`   | ✅ 已创建 |
+
+每个应用需启用：机器人能力、接收消息事件。连接模式使用 **websocket**。
+> 3 个 dev Agent 的飞书应用已创建完毕，仅 integral-pm 待创建。
+
+### 步骤 2：备份当前配置
+
+```bash
+cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.before-agents
+```
+
+### 步骤 3：创建目录
+
+```bash
+# Workspace 目录
+mkdir -p ~/.openclaw/workspace-integral-pm/{memory,plans,tasks}
+mkdir -p ~/.openclaw/workspace-dev-{backend,frontend,qa}/{memory,tasks}
+
+# Agent 目录
+mkdir -p ~/.openclaw/agents/integral-pm/agent
+mkdir -p ~/.openclaw/agents/dev-{backend,frontend,qa}/agent
+```
+
+### 步骤 4：增量修改 openclaw.json
+
+按第四节追加 `agents.list`、`bindings`、`channels.feishu.accounts`。
+**不删除或修改任何已有配置。**
+
+### 步骤 5：写入 Workspace 文件
+
+为每个 workspace 写入第七节中的 IDENTITY.md、SOUL.md、AGENTS.md、USER.md、TOOLS.md。
+
+```bash
+for ws in integral-pm dev-backend dev-frontend dev-qa; do
+  echo "# HEARTBEAT.md" > ~/.openclaw/workspace-$ws/HEARTBEAT.md
+done
+```
+
+### 步骤 6：启用内置 Tools
+
+```bash
+# 所有 Agent 通用
+for agent in integral-pm dev-backend dev-frontend dev-qa; do
+  openclaw skills enable git --agent $agent
+  openclaw skills enable file-manager --agent $agent
+  openclaw skills enable web-search --agent $agent
+done
+
+# 按角色差异化
+openclaw skills enable browser --agent integral-pm
+
+openclaw skills enable code-runner --agent dev-backend
+openclaw skills enable http-request --agent dev-backend
+
+openclaw skills enable code-runner --agent dev-frontend
+openclaw skills enable browser --agent dev-frontend
+
+openclaw skills enable code-runner --agent dev-qa
+openclaw skills enable browser --agent dev-qa
+openclaw skills enable http-request --agent dev-qa
+```
+
+### 步骤 7：验证
+
+```bash
+openclaw doctor
+openclaw agents list
+openclaw agents list --bindings
+# 在飞书中向 main 机器人发消息确认不受影响
+# 分别向 4 个新机器人发消息确认路由正确
+```
+
+### 回滚方案
+
+```bash
+cp ~/.openclaw/openclaw.json.before-agents ~/.openclaw/openclaw.json
+openclaw restart
+```
+
+---
+
+## 十、安全性约束
+
+### 10.1 SSH 密钥
+- Workspace 文件中不记录 SSH 密钥路径
+- 部署脚本通过 deploy.conf 中的环境变量引用
+
+### 10.2 环境分级（积分商城）
+
+| 环境     | QA 直接操作 | PM 审批 | 用户确认 |
+| ------ | ------- | ----- | ---- |
+| by80   | ●       | ●     | -    |
+| miao33 | ●       | ●     | -    |
+| miao50 | -       | ●     | ●    |
+
+### 10.3 敏感信息
+- API key 仅存在 openclaw.json 和 agent/auth-profiles.json 中
+- 飞书 appSecret 仅存在 openclaw.json 中
+- Workspace .md 文件不记录任何密钥或密码
+
+---
+
+## 附录：v3 → v3s 变更总结
+
+| 维度             | v3                                 | v3s                                          |
+| -------------- | ---------------------------------- | -------------------------------------------- |
+| Agent 命名       | integral-backend/frontend/qa       | dev-backend/frontend/qa（通用命名）                |
+| 开发 Agent 定位    | 积分商城专用                             | **通用软件开发**，可服务任何项目                           |
+| SOUL.md 技术栈    | 写死特定版本约束                           | 列出核心能力，按任务指定的约束执行                            |
+| TOOLS.md 项目信息  | 只有积分商城                             | "已知项目"区块，可追加新项目                              |
+| PM 任务分派        | 直接下达                               | 必须附带**项目路径 + 技术栈约束 + 分支规范**                  |
+| 用户直接使用开发 Agent | 不支持                                | **支持**，用户可直接私聊开发 Agent 下达任何编码任务              |
+| workspace 目录命名 | workspace-integral-{role}          | PM: workspace-integral-pm，其余: workspace-dev-{role} |
+| 项目路径           | `<PROJECT_ROOT>` 占位符                | `/Users/mac/scott-macair-26/integral-shop`   |
--- a/single_uniapp22miao/config/app.js
+++ b/single_uniapp22miao/config/app.js
@@ -6,8 +6,7 @@
 // let domain = 'https://jfanyue.szxingming.com'
 // let domain = 'https://jf.wenjinhui.com'
 // let domain = 'https://jjy-jf.fwxgpt.com'
-let domain = 'https://jf.jinyawen.com'
-// let domain = 'https://jf.hapengran.com'
+let domain = 'https://jf.hapengran.com'
 // let domain = 'https://jjy-jf.uj345.com'
 // let domain = 'https://ccd-jf.cichude.com'

@@ -17,7 +16,7 @@ module.exports = {
 		// HTTP_REQUEST_URL:'',
 		HTTP_REQUEST_URL: domain,
 		// H5商城地址
-		HTTP_H5_URL: 'https://jf.jinyawen.com',
+		HTTP_H5_URL: 'https://jf.hapengran.com',
 	// #endif
 	// #ifdef H5
 		HTTP_REQUEST_URL:domain,
--- a/single_uniapp22miao/pages/index/index.vue
+++ b/single_uniapp22miao/pages/index/index.vue
@@ -34,7 +34,7 @@
 export default {
  data() {
    return {
-      pdfUrl: '/static/sign_contract_byjyw149.pdf',
+      pdfUrl: '/static/sign_contract_pengran.pdf',
      userId: '',
      isMobile: false,
      usePdfJs: false,
--- a/single_uniapp22miao/pages/integral/points.vue
+++ b/single_uniapp22miao/pages/integral/points.vue
@@ -338,7 +338,7 @@ export default {
    // 跳转到抢购页面
    goToRushBuy() {
      // #ifdef H5
-	  window.location.href = 'https://jinyawen.com/?#/pages/personal/index'
+	  window.location.href = 'https://hapengran.com/?#/pages/personal/index'
 	  // window.location.href = 'https://ccd.cichude.com/?#/pages/personal/index'
 	  // window.location.href = 'https://shop.wenjinhui.com/?#/pages/personal/index'
 	  //window.location.href = 'https://anyue.szxingming.com/?#/pages/personal/index'
@@ -347,7 +347,7 @@ export default {
      // #endif
      // #ifndef H5
      uni.navigateTo({
-        url: '/pages/web-view/index?url=' + encodeURIComponent('https://jinyawen.com/?#/pages/personal/index')
+        url: '/pages/web-view/index?url=' + encodeURIComponent('https://hapengran.com/?#/pages/personal/index')
      })
      // #endif
    },
--- a/single_uniapp22miao/pages/sub-pages/webview/sign-preview.vue
+++ b/single_uniapp22miao/pages/sub-pages/webview/sign-preview.vue
@@ -16,7 +16,7 @@ export default {
  },
  
  onLoad(options) {
-    const url = options && options.url ? decodeURIComponent(options.url) : '/static/sign_contract_byjyw149.pdf'
+    const url = options && options.url ? decodeURIComponent(options.url) : '/static/sign_contract_pengran.pdf'
    this.pdfUrl = url
  },

--- a/single_uniapp22miao/pages/sub-pages/webview/sign.vue
+++ b/single_uniapp22miao/pages/sub-pages/webview/sign.vue
@@ -360,7 +360,7 @@ export default {
          });
          // 返回
          setTimeout(() => {
-			window.location.href = 'https://jinyawen.com/?#/pages/rushing/index' + (this.userId ? ('?user_id=' + this.userId) : '')
+			window.location.href = 'https://hapengran.com/?#/pages/rushing/index' + (this.userId ? ('?user_id=' + this.userId) : '')
 			// window.location.href = 'https://shop.wenjinhui.com/?#/pages/rushing/index' + (this.userId ? ('?user_id=' + this.userId) : '')
 			// window.location.href = 'https://anyue.szxingming.com/?#/pages/rushing/index' + (this.userId ? ('?user_id=' + this.userId) : '')
 			// window.location.href = 'https://xiashengjun.com/?#/pages/rushing/index' + (this.userId ? ('?user_id=' + this.userId) : '')
--- a/single_uniapp22miao/static/sign_contract_byjyw149.pdf
+++ b/single_uniapp22miao/static/sign_contract_byjyw149.pdf
--- a/single_uniapp22miao/static/sign_contract_chenzhaochun.pdf
+++ b/single_uniapp22miao/static/sign_contract_chenzhaochun.pdf
--- a/single_uniapp22miao/static/sign_contract_czrt6.pdf
+++ b/single_uniapp22miao/static/sign_contract_czrt6.pdf
Author	SHA1	Message	Date
apple	ad4fdccf66	chore: update application-hapr191 profile Made-with: Cursor	2026-04-10 11:26:49 +08:00
apple	f65f0213e6	chore(admin): point development VUE_APP_BASE_API to local backend Use http://127.0.0.1:30032 for local crmeb-admin; comment hapr191 deploy URL. Made-with: Cursor	2026-04-09 15:20:10 +08:00
apple	2f6d8106a0	Merge branch 'feature/marketing-integral-log' into hapr191 Keep backend-adminend/src/api/integral.js (integralListApi) after resolve rename/delete vs hapr191 deletion. Made-with: Cursor	2026-04-09 15:12:42 +08:00