cx-chat 0.0.1

package/.cursor/rules/i18n-cn-gloss-comments.mdc

@@ -0,0 +1,31 @@
+---
+description: 使用 i18n（t() 或业务 locale 键）时在源码旁写中文对照注释，便于维护
+alwaysApply: true
+---
+
+# i18n 中文对照注释
+
+在 **含国际化** 的 TS/TSX 中生成或修改代码时，**顺手写上中文对照**，方便后人不用翻 locale 也能懂键对应什么文案。
+
+## 写法约定
+
+1. **可安全用行尾 `//` 的地方**（对象字面量、列配置、`showToast(t(...))` 等，行尾不会被截断）  
+   - 在 `t('namespace.key')` 或配置里的 `'namespace.key'` **同一行末尾**加 `// 中文简述` 或 `// 键语义`。  
+   - 例：`title: t('menus.xxx.fields.foo'), // 表名`  
+   - 例：`showToast(t('menus.xxx.preview_failed'), 'error') // 结构预览失败`  
+   - 动态键：`t(\`menus.xxx.rules.${err}\`)` 旁注释 `// 校验文案，键见 locales/zh/.../rules` 等。
+
+2. **JSX 里**（多属性、`label={t(...)}` 等，行尾 `//` 容易误注释后续属性）  
+   - 在对应表单项/区块 **上一行** 用 **`{/* 中文 · 或字段说明 */}`**。  
+   - 例：`{/* 主题 */}` 下一行 `<CxFormItem label={t('...fields.subject')} ...>`。
+
+3. **文件头（可选但推荐）**  
+   - 同一文件大量 `menus.*` 等键时，在模块顶部加一行 **`// i18n 中文：locales/zh/对应路径.ts（namespace）`**，避免每行重复写长路径。
+
+4. **与 `common.*` 混用时**  
+   - `common.no_data`、`common.actions` 等可在注释里写「暂无数据」「操作」，或注明 `common → zh/common.ts`。
+
+## 不要求
+
+- 不在**无 i18n** 的纯逻辑文件强行加注释。  
+- 不为了注释拆成过度冗长的结构；**一行能写完优先一行**（与现有「属性紧凑」风格一致时可同行）。

package/.cursor/rules/list-page-view-pageconfig.mdc

@@ -0,0 +1,32 @@
+---
+description: ListPageView 与 createListPageConfig 必须用同一 pageConfig 引用（与角色页一致）
+globs: src/pages/**/index.tsx
+alwaysApply: false
+---
+
+# ListPageView + `pageConfig` 约定
+
+`ListPageView` 在 `useLayoutEffect` 里会把 **`onDelete`、`onStatusToggle`**（以及包装后的 **`onEdit`**）挂到**传入的 `pageConfig` 对象本身**上。
+
+## 必须遵守
+
+- 使用 **`const pageConfig = useListPageConfig()`**（工厂 hook 返回的那一个对象）。
+- 表格列：**`pageConfig.columns = useMemo(() => [...], [pageConfig, …])`**，操作列里只调用 **`pageConfig.onDelete` / `pageConfig.onStatusToggle` / `pageConfig.onEdit`**。
+- 传给列表：**`<ListPageView pageConfig={pageConfig} />`**，不要再包一层 `{ ...pageConfig, columns }` 作为另一个变量传入。
+- 树重载等扩展字段：写在同一对象上，例如 **`pageConfig.treeReloadSignal = treeReloadSignal`**（每轮渲染赋值即可），不要为 `treeReloadSignal` 再 `useMemo` 出一个新对象替代 `pageConfig`。
+- 自定义编辑：每轮渲染先 **`pageConfig.onEdit = handleDataEdit`**（在 `ListPageView` 包装逻辑之前由父组件写回），编辑按钮 payload 与角色页一致：`{ type: 'edit', data, record }`。
+
+## 反面示例（禁止）
+
+```tsx
+// ❌ 注入挂在 listPageConfig，列里却用 pageConfig
+const pageConfig = useMemo(() => ({ ...base, treeReload }), [...])
+const listPageConfig = useMemo(() => ({ ...pageConfig, columns }), [...])
+<ListPageView pageConfig={listPageConfig} />
+// 列里：pageConfig.onDelete  // 永远是 undefined
+```
+
+## 参考实现
+
+- `src/pages/page-system/role/index.tsx`
+- `src/pages/page-system/dict/index.tsx`（树 + 自定义 onEdit 时同上）

package/.cursor/rules/no-over-defensive-programming.mdc

@@ -0,0 +1,90 @@
+---
+description: 禁止过度防御性编程,TypeScript 类型约束要宽松,删除多余守卫代码
+globs: **/*.{ts,tsx}
+alwaysApply: true
+---
+
+# 禁止过度防御性编程规范
+
+## 核心原则
+**不要写无意义的防御性代码**,避免为了"类型安全"而添加大量冗余判断和严格类型约束。
+
+## 具体规范
+
+### 1. TypeScript 类型定义要宽松
+- ❌ 不要用严格的联合类型限制(如 `'add' | 'edit'`)
+- ✅ 改用 `string` 或 `(string & {})`,让运行时逻辑处理错误值
+
+```typescript
+// ❌ 错误示例 - 过度严格的类型
+type ModalMode = 'add' | 'edit' | 'detail'
+type SubmitMode = 'add' | 'edit'
+
+// ✅ 正确示例 - 宽松类型
+type ModalMode = string
+type SubmitMode = string
+```
+
+### 2. 删除多余的守卫判断
+- 如果函数只在特定场景调用,不要添加不可能触发的条件判断
+- 信任调用方传参,参数错误应该在调用处修复
+
+```typescript
+// ❌ 错误示例 - 多余的守卫
+const handleSubmit = async ({ opeType }) => {
+  if (opeType === 'detail') return  // 详情模式不会调用提交,这个判断多余
+  if (opeType === 'edit') {
+    result = await editAPI(payload)
+  } else {
+    result = await addAPI(payload)
+  }
+}
+
+// ✅ 正确示例 - 简洁直接
+const handleSubmit = async ({ opeType }) => {
+  if (opeType === 'edit') {
+    result = await editAPI(payload)
+  } else {
+    result = await addAPI(payload)
+  }
+}
+```
+
+### 3. 避免冗余的状态管理
+- 不要创建与父组件/Hook 重复的 state
+- 直接从父级解构使用,保持单一数据源
+
+```typescript
+// ❌ 错误示例 - 重复声明 opeId
+const [opeId, setOpeId] = useState<string | undefined>(undefined)
+const modal = useCxModal({
+  onOpen: (payload) => {
+    setOpeId(payload.opeId)
+  },
+})
+
+// ✅ 正确示例 - 从 modal 解构
+const modal = useCxModal({
+  onOpen: (payload) => {
+    const { setOpeId } = modal
+    setOpeId(payload.opeId)
+  },
+})
+const { opeId } = modal  // 直接使用 modal 提供的
+```
+
+### 4. Build 报错优先简化类型
+- 遇到 TypeScript 编译错误时,优先考虑放宽类型约束
+- 不要为了通过编译而添加大量防御性代码
+- 配置错了该报错就行了,不需要在 build 阶段卡死
+
+## 反面案例总结
+
+以下情况都属于**过度防御**,应该避免:
+1. 为不可能出现的值添加类型约束
+2. 在函数内部重复校验调用方应该保证的参数
+3. 创建与父级重复的 state 变量
+4. 添加永远不会触发的条件分支
+5. 为了过编译而写的类型断言和守卫代码
+
+**记住**: 代码应该简洁直观,错了自然会有人改,不要瞎操心。

package/.cursor/rules/requirement-description-for-agent.mdc

@@ -0,0 +1,33 @@
+---
+description: 需求与接口示例的默认理解方式；UI「不可操作」默认不展示入口
+alwaysApply: true
+---
+
+# 需求与接口描述 — Agent 默认约定
+
+用户未单独说明时，Agent **按下述方式理解并执行**，避免过度推断或扩大改动范围。
+
+## 接口 / JSON 示例
+
+- 用户给出响应 JSON 且**未**写「要改拦截器 / 统一 `code`」时：视为**仅说明 `data` 或内层字段形状**，用于对接列表、详情、类型；**不**因示例里的 `code`（如 0 / 200）去改 `src/http/axios` 等全局逻辑。
+- 若需动请求层或全局 `code` 约定，须用户**明确写出**；否则不改。
+
+## UI：「不能再操作」类需求
+
+- 表述如「已 x 不能再 y」且**未**要求保留占位时：**默认不渲染该操作入口**（不显示按钮/项），**不**默认做成 `disabled` + 灰显。
+- 仅当用户明确要求「保留入口但禁用 / 要 tooltip / 要占位」时，才用禁用态。
+
+## 范围与禁忌
+
+- 用户指定了文件或模块时，**不**顺带重构无关代码。
+- 用户写出「不要 xxx」（如不要单独命名转换函数、不要读路由参数）时，**严格遵守**。
+
+## 重构与数据对齐
+
+- 用户描述「目标行为 / 目标数据来源」（如「只认行上的 `metadataId`」）时，按目标改调用链，**不**在未要求时保留旧路径兜底（除非用户要求兼容）。
+
+## 用户可选用的一行模板
+
+用户可在复杂需求末尾附上：
+
+`在【页面】：【行为】。数据按【字段/示例】。不要【动 axios / 禁用占位 等】。`

package/.cursor/rules/use-showToast-not-antd-message.mdc

@@ -0,0 +1,28 @@
+---
+description: 全局提示统一 useToast/showToast，禁止 antd message API
+alwaysApply: true
+---
+
+# 全局提示（Toast）
+
+- **必须**使用 `useToast`（`@/contexts/ToastContext`）的 `showToast`，与 settings、chat、元数据等页面一致。
+- **禁止**使用 antd 的 `message.success` / `message.error` / `message.warning` / `message.info`，以及 `import { message } from 'antd'` 仅为弹全局提示。
+
+```tsx
+// ✅
+import { useToast } from '@/contexts/ToastContext'
+
+const { showToast } = useToast()
+showToast(t('common.operation_success'), 'success')
+showToast(err?.message || t('common.operation_failed'), 'error')
+```
+
+```tsx
+// ❌
+import { message } from 'antd'
+message.success('...')
+```
+
+- **非 React 上下文**（如 axios 拦截器、纯工具函数）不可用 hook 时，使用 `@/utils/toastBridge` 的 `showGlobalToast`（由 `ToastProvider` 挂载时注册）。
+
+- **例外**：antd `Form` / `Form.Item` 的校验规则对象里的字段 **`message:`** 表示校验失败文案，**不是** antd 全局 `message` API，应继续按 antd 规则写法保留。

package/.docker/Dockerfile

@@ -0,0 +1,7 @@
+FROM 10.101.1.128:16666/build-image/nginx:1.23.3-unknow-server
+WORKDIR /app
+COPY ./dist/ /app/dist/
+COPY ./.nginx/nginx.conf /etc/nginx/nginx.conf
+
+ENV LISTEN_PORT ''
+ENV BACKEND_PROXY_PASS ''

package/.env

@@ -0,0 +1,9 @@
+VITE_APP_NAME="Agent Forge"
+VITE_APP_TITLE="Agent Forge - AI Agent Builder"
+VITE_APP_LOGO_URL=
+
+#请求加密
+VITE_APP_ENCRYPTION = true
+
+# 生产构建是否对业务 JS 做混淆（仅 vite build 且 mode=production 时读取）。日常 false，正式发布前改为 true
+BUILD_OBFUSCATE=false

package/.env.development

@@ -0,0 +1,7 @@
+# 开发必须配置；子路径示例: VITE_PUBLIC_PATH=/agent-web/
+VITE_PUBLIC_PATH=/
+
+VITE_API_BASE_URL=api
+
+# 开发默认启用 mock；不需要 mock 时设为 false
+VITE_ENABLE_MOCK=false

package/.env.production

@@ -0,0 +1,7 @@
+# 生产必须配置；CI 可传参: VITE_PUBLIC_PATH=/子路径/ npm run build
+VITE_PUBLIC_PATH='/VUE_APP_PUBLIC_PATH_PLACEHOLDER/'
+
+VITE_API_BASE_URL=agent-server
+
+# 生产包不包含真实 mock；需本地联调 mock 时改为 true 再构建
+VITE_ENABLE_MOCK=false

package/.gitlab-ci/docker-build.yaml

@@ -0,0 +1,28 @@
+docker-build:
+  only:
+    - master
+  stage: docker-build
+  image: 10.101.1.128:16666/gitlab-runner/docker:24.0.5-dind-cx-harbor
+  artifacts:
+    when: always
+    paths:
+      - ${CI_PROJECT_DIR}/image_tag
+  script:
+    - export DOCKER_HOST=$(ip route | grep default | awk '{print $3}')
+     
+    # 生成一个时间戳
+    - export CI_TIMESTAMP=`TZ='Asia/Shanghai' date "+%Y%m%d%H%M%S"`
+    # 保存镜像 tag 通过 gitlab-ci 的 artifacts 功能传递给后续所有 job
+    - echo ${CI_TIMESTAMP}${CI_COMMIT_SHORT_SHA} > image_tag
+
+    # 唯一 tag 的镜像名称
+    - IMAGE_NAME=${CI_REGISTRY}/cxinternet/${CI_PROJECT_PATH}:${CI_TIMESTAMP}${CI_COMMIT_SHORT_SHA}
+    # 生成唯一 tag 镜像
+    - docker build -f ./.docker/Dockerfile -t ${IMAGE_NAME} .
+    # 生成 latest 镜像
+    - docker tag ${IMAGE_NAME} ${CI_REGISTRY}/cxinternet/${CI_PROJECT_PATH}:latest
+
+    # 推送镜像
+    - docker push ${IMAGE_NAME}
+    - docker push ${CI_REGISTRY}/cxinternet/${CI_PROJECT_PATH}:latest
+    - echo "push image success:"${IMAGE_NAME}"  "${CI_REGISTRY}/cxinternet/${CI_PROJECT_PATH}:latest

package/.gitlab-ci/k8s-deploy-dev-master.yaml

@@ -0,0 +1,42 @@
+k8s-deploy-dev-master:
+  only:
+    - master
+  stage: k8s-deploy
+  image: 10.101.1.128:16666/kubernetes/kubectl:1.27.4-dev-kvm
+  script:
+    - |
+      # 前端应用名称
+      APP_NAME="agent-web"
+      # 前端应用端口 后台网关端口 20788
+      APP_PORT=20790
+      # 镜像仓库的命名空间
+      IMAGE_NAMESPACE="cxinternet"
+
+      PROJECT_PATH=${CI_PROJECT_PATH}
+      IMAGE_TAG=$(cat image_tag)
+      cd ./.k8s/
+      mkdir deployment
+      mkdir service
+
+      kubectl apply -f 0-namespace.yaml
+      more ./0-namespace.yaml
+
+      kubectl apply -f 1-configmap-web.yaml
+      more ./1-configmap-web.yaml
+      kubectl apply -f 1-nginx-conf-dev.yaml
+      more ./1-nginx-conf-dev.yaml
+
+      image_name=$CI_REGISTRY"/"$IMAGE_NAMESPACE"/"$PROJECT_PATH":"$IMAGE_TAG
+      deployment="{\"metadata\":{\"name\":\""$APP_NAME"\",\"labels\":{\"app\":\""$APP_NAME"\"}},\"spec\":{\"selector\":{\"matchLabels\":{\"app\":\""$APP_NAME"\"}},\"template\":{\"metadata\":{\"labels\":{\"app\":\""$APP_NAME"\"}},\"spec\":{\"containers\":[{\"name\":\""$APP_NAME"\",\"image\":\""$image_name"\",\"imagePullPolicy\":\"Always\",\"ports\":[{\"name\":\"http\",\"containerPort\":8080,\"protocol\":\"TCP\"}],\"envFrom\":[{\"configMapRef\":{\"name\":\"agent-web-configmap\"}}],\"volumeMounts\":[{\"name\":\"agent-nginx-conf\",\"mountPath\":\"/etc/nginx/nginx.conf\",\"subPath\":\"nginx.conf\"}]}]}}}}"
+      service="{\"metadata\":{\"name\":\""$APP_NAME"\",\"labels\":{\"app\":\""$APP_NAME"\"}},\"spec\":{\"selector\":{\"app\":\""$APP_NAME"\"},\"ports\":[{\"name\":\"http\",\"port\":8080,\"protocol\":\"TCP\",\"targetPort\":8080,\"nodePort\":"$APP_PORT"}],\"type\":\"NodePort\"}}"
+      kubectl patch -f 2-deployment.yaml --dry-run=true --local=true -p $deployment -o yaml >./deployment/$APP_NAME-deployment.yaml
+      kubectl patch -f 3-service.yaml --dry-run=true --local=true -p $service -o yaml >./service/$APP_NAME-service.yaml
+      
+      more ./deployment/$APP_NAME-deployment.yaml
+      more ./service/$APP_NAME-service.yaml
+      
+      kubectl apply -f ./deployment
+      kubectl apply -f ./service
+
+      kubectl apply -f 4-ingress-dev.yaml
+      more ./4-ingress-dev.yaml

package/.gitlab-ci/npm-build.yaml

@@ -0,0 +1,17 @@
+npm-build:
+  only:
+    - master
+  stage: npm-build
+  image: 10.101.1.128:16666/gitlab-runner/node:20.19.2-alpine
+  artifacts:
+    paths:
+      - ${CI_PROJECT_DIR}/dist
+  script:
+    - npm config set prefix /cache${CI_PROJECT_DIR}/node_global
+    - npm config set cache /cache${CI_PROJECT_DIR}/node_cache
+    - npm config set registry http://registry.npm.taobao.org/
+#    - npm install @rollup/rollup-linux-x64-musl --save-optional
+#    - npm install --force
+    - npm ci --prefer-offline --no-audit
+    - export VITE_API_BASE_URL=agent-server
+    - npm run build

package/.gitlab-ci.yml

@@ -0,0 +1,8 @@
+include:
+  - local: '/.gitlab-ci/npm-build.yaml'
+  - local: '/.gitlab-ci/docker-build.yaml'
+  - local: '/.gitlab-ci/k8s-deploy-dev-master.yaml'
+stages:
+  - npm-build
+  - docker-build
+  - k8s-deploy

package/.k8s/0-namespace.yaml

@@ -0,0 +1,6 @@
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: agent
+  labels:
+    product: agent

package/.k8s/1-configmap-web.yaml

@@ -0,0 +1,7 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: agent-web-configmap
+  namespace: agent
+data:
+  VUE_APP_PUBLIC_PATH: dev/agent

package/.k8s/1-nginx-conf-dev.yaml

@@ -0,0 +1,110 @@
+apiVersion: v1
+data:
+  nginx.conf: |+
+    # For more information on configuration, see:
+    #   * Official English Documentation: http://nginx.org/en/docs/
+    #   * Official Russian Documentation: http://nginx.org/ru/docs/
+
+    user nginx;
+    worker_processes auto;
+    error_log /var/log/nginx/error.log;
+    pid /run/nginx.pid;
+
+    # Load dynamic modules. See /usr/share/nginx/README.dynamic.
+    include /usr/share/nginx/modules/*.conf;
+
+    events {
+        worker_connections 1024;
+    }
+
+    http {
+        log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
+                          '$status $body_bytes_sent "$http_referer" '
+                          '"$http_user_agent" "$http_x_forwarded_for"';
+
+        access_log  /var/log/nginx/access.log  main;
+
+        gzip                                    on;
+        gzip_comp_level                          8;
+        gzip_min_length                        256;
+        gzip_proxied                           any;
+        gzip_vary                               on;
+        gzip_types application/javascript text/css;
+
+        sendfile               on;
+        tcp_nopush             on;
+        tcp_nodelay            on;
+        underscores_in_headers on;
+        keepalive_timeout      65;
+        types_hash_max_size    2048;
+        client_max_body_size   100M;
+
+        include             /etc/nginx/mime.types;
+        default_type        application/octet-stream;
+
+        # Load modular configuration files from the /etc/nginx/conf.d directory.
+        # See http://nginx.org/en/docs/ngx_core_module.html#include
+        # for more information.
+
+        server {
+            listen       8080 default_server;
+            listen       [::]:8080 default_server;
+
+            server_name  _;
+            root         /app/dist;
+
+            location /dev/agent/agent-server/chat/stream {
+                proxy_buffering off;
+                proxy_cache off;
+                gzip off; 
+                proxy_http_version 1.1;
+
+                proxy_connect_timeout 10s;   
+                proxy_send_timeout 600s;  
+                proxy_read_timeout 600s;
+
+                add_header 'Access-Control-Allow-Origin' '*';
+                add_header 'Access-Control-Allow-Credentials' 'true';
+                add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
+                add_header 'Access-Control-Allow-Headers' 'DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type';
+                proxy_set_header Cookie $http_cookie;
+                proxy_pass http://agent-server:8080/chat/stream;
+
+                proxy_cookie_path  / /dev/agent/agent-server/chat/stream;
+                proxy_cookie_domain domino.server nginx.server;
+                proxy_redirect off;
+            }
+
+            location / {
+            }
+
+            error_page 404 /404.html;
+                location = /40x.html {
+            }
+
+            error_page 500 502 503 504 /50x.html;
+                location = /50x.html {
+            }
+
+            location /dev/agent {
+                proxy_pass http://agent-web:8080/;
+            }
+
+            location /agent-server/ {
+                add_header 'Access-Control-Allow-Origin' '*';
+                add_header 'Access-Control-Allow-Credentials' 'true';
+                add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
+                add_header 'Access-Control-Allow-Headers' 'DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type';
+                proxy_set_header Cookie $http_cookie;
+                proxy_pass http://agent-server:8080/;
+
+                proxy_cookie_path  / /agent-server/;
+                proxy_cookie_domain domino.server nginx.server;
+                proxy_redirect off;
+            }
+        }
+    }
+kind: ConfigMap
+metadata:
+  name: agent-nginx-conf
+  namespace: agent

package/.k8s/2-deployment.yaml

@@ -0,0 +1,27 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: deployment-name
+  namespace: agent
+  labels:
+    app: label-app
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: selector-name
+  strategy:
+    type: RollingUpdate
+    rollingUpdate:
+      maxSurge: 1
+      maxUnavailable: 1
+  template:
+    metadata:
+      labels:
+        app: pod-template
+    spec:
+      containers: container
+      volumes:
+      - configMap:
+          name: agent-nginx-conf
+        name: agent-nginx-conf

package/.k8s/3-service.yaml

@@ -0,0 +1,16 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: service-name
+  namespace: agent
+  labels:
+    app: label-app
+spec:
+  selector:
+    app: selector-name
+  ports:
+  - name: http
+    port: 8080
+    protocol: TCP
+    targetPort: 8080
+  type: ClusterIP

package/.k8s/4-ingress-dev.yaml

@@ -0,0 +1,30 @@
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  annotations:
+    kubernetes.io/ingress.class: nginx
+    nginx.ingress.kubernetes.io/proxy-body-size: "50m"
+    nginx.ingress.kubernetes.io/client-max-body-size: "50m"
+    nginx.ingress.kubernetes.io/proxy-buffering: "off"
+    nginx.ingress.kubernetes.io/proxy-http-version: "1.1"
+    nginx.ingress.kubernetes.io/configuration-snippet: |
+      proxy_cache off;
+      gzip off;
+    nginx.ingress.kubernetes.io/use-regex: "true"
+    nginx.ingress.kubernetes.io/proxy-connect-timeout: "10"
+    nginx.ingress.kubernetes.io/proxy-read-timeout: "600"
+    nginx.ingress.kubernetes.io/proxy-send-timeout: "600"
+  name: agent-web-dev-irs101-cn
+  namespace: agent
+spec:
+  rules:
+    - host: cx.dev.irs101.cn
+      http:
+        paths:
+          - path: /dev/agent(/|$)(.*)
+            pathType: Prefix
+            backend:
+              service:
+                name: agent-web
+                port:
+                  number: 8080

package/.lingma/rules/use-showToast-not-antd-message.md

@@ -0,0 +1,34 @@
+# 全局提示：使用 showToast，禁止 antd message
+
+**规则类型（请在灵码 IDE / 插件中将本规则设为「始终生效」）**：项目内所有智能会话与行间生成代码均应遵守。
+
+## 要求
+
+1. React 组件中需要全局气泡提示时：
+   - 从 `@/contexts/ToastContext` 引入 `useToast`。
+   - 使用 `const { showToast } = useToast()`。
+   - 调用：`showToast(文案字符串, 类型)`，类型为 `'success' | 'error' | 'info' | 'warning'`，可选第三个参数为停留毫秒数。
+
+2. **不要**为全局提示引入或使用 antd 的 `message`（如 `message.success`、`message.error`）。
+
+3. 不在组件树内、无法使用 hook 的代码（例如 axios 拦截器、独立工具模块）：使用 `@/utils/toastBridge` 的 `showGlobalToast`（与 `ToastProvider` 配套）。
+
+## 例外
+
+- antd `Form` 校验规则里的 **`message:`** 字段表示**校验错误提示文案**，属于规则配置，**必须保留**，与全局 `message` API 无关。
+
+## 示例
+
+```tsx
+// 正确
+import { useToast } from '@/contexts/ToastContext'
+const { showToast } = useToast()
+showToast(t('menus.xxx.saved'), 'success')
+showToast(error?.message || t('common.operation_failed'), 'error')
+```
+
+```tsx
+// 错误 — 不要用 antd 全局 message
+import { message } from 'antd'
+message.success('保存成功')
+```

package/.nginx/nginx.conf

@@ -0,0 +1,52 @@
+# For more information on configuration, see:
+#   * Official English Documentation: http://nginx.org/en/docs/
+#   * Official Russian Documentation: http://nginx.org/ru/docs/
+
+user nginx;
+worker_processes auto;
+error_log /var/log/nginx/error.log;
+pid /run/nginx.pid;
+
+# Load dynamic modules. See /usr/share/nginx/README.dynamic.
+include /usr/share/nginx/modules/*.conf;
+
+events {
+    worker_connections 1024;
+}
+
+http {
+    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
+                      '$status $body_bytes_sent "$http_referer" '
+                      '"$http_user_agent" "$http_x_forwarded_for"';
+
+    access_log  /var/log/nginx/access.log  main;
+
+    sendfile            on;
+    tcp_nopush          on;
+    tcp_nodelay         on;
+    keepalive_timeout   65;
+    types_hash_max_size 2048;
+
+    include             /etc/nginx/mime.types;
+    default_type        application/octet-stream;
+
+    # Load modular configuration files from the /etc/nginx/conf.d directory.
+    # See http://nginx.org/en/docs/ngx_core_module.html#include
+    # for more information.
+
+    server {
+        listen       8080 default_server;
+        listen       [::]:80 default_server;
+
+        server_name  _;
+        root         /app/dist;
+
+        error_page 404 /404.html;
+            location = /40x.html {
+        }
+
+        error_page 500 502 503 504 /50x.html;
+            location = /50x.html {
+        }
+    }
+}

package/.prettierrc

@@ -0,0 +1,9 @@
+{
+  "bracketSameLine": true,
+  "jsxBracketSameLine": true,
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "useTabs": false,
+  "trailingComma": "all"
+}

package/README.md

@@ -0,0 +1 @@
+# Agent Web 端