改回项目内获取md文档

删除本地content目录,改为由github获取
更改dockerfile以及uipro脚本
2025-08-08 12:15:35 +08:00 · 2025-08-08 10:59:21 +08:00 · 2025-08-08 09:38:23 +08:00 · 2025-08-08 09:14:54 +08:00 · 2025-08-08 08:55:48 +08:00 · 2025-08-08 08:54:49 +08:00
35 changed files with 555 additions and 667 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -1,5 +1,6 @@
 # Nuxt dev/build outputs
 .output
+.output.*
 .data
 .nuxt
 .nitro
--- a/53
+++ b/53
@@ -1,32 +1,43 @@
-# ------------- 依赖缓存阶段 -------------
-FROM node:22-alpine AS base
-
-# 国内镜像
+############################################################
+# 1) 依赖层 - 只要锁文件没变，永远复用
+############################################################
+FROM node:22-alpine AS deps 
+# 国内加速
 RUN npm config set registry https://registry.npmmirror.com

 WORKDIR /app

-# 拷贝所有源码 - Nuxt 4在pnpm i阶段需要完整的项目结构
-COPY . .
-
-# 安装依赖
+# 只拷依赖描述文件
+COPY package.json pnpm-lock.yaml .npmrc ./
+# 安装，结果是 /app/node_modules 和全局 pnpm cache
 RUN corepack enable && pnpm install --frozen-lockfile

-# 执行补丁脚本
-RUN chmod +x patch-ui-pro.zsh && ./patch-ui-pro.zsh
-
-# ------------- 构建阶段 -------------
-FROM base AS builder
-RUN pnpm build
-
-# ------------- 运行阶段 -------------
-FROM node:22-alpine AS production
-
+############################################################
+# 2) 编译层 - 代码变了也不影响 deps 缓存
+############################################################
+FROM node:22-alpine AS builder
 WORKDIR /app

-# 拷贝构建产物 - Nuxt的output目录已经包含了所有运行时需要的文件
-COPY --from=builder /app/.output ./.output
+# 先复用 deps 里的 node_modules
+COPY --from=deps /app/node_modules ./node_modules
+# 再拷源码
+COPY . .

+# 运行补丁
+RUN chmod +x patch-ui-pro.sh && ./patch-ui-pro.sh
+
+# 注意把内存限制放在这里，避免本地开发时也被硬限制
+ENV NODE_OPTIONS="--max-old-space-size=4096"
+RUN corepack enable && pnpm build
+
+############################################################
+# 3) 运行层 - 只有可运行文件，最小镜像
+############################################################
+FROM node:22-alpine AS production
+WORKDIR /app
+
+COPY --chown=node:node --from=builder /app/.output ./.output
 EXPOSE 3000
 ENV NODE_ENV=production HOST=0.0.0.0 PORT=3000
-CMD ["node", ".output/server/index.mjs"]
+USER node
+CMD ["node", ".output/server/index.mjs"]
--- a/app/app.config.ts
+++ b/app/app.config.ts
@@ -8,246 +8,6 @@ export default defineAppConfig({
      base: 'w-full h-full mx-auto px-2 sm:px-6 lg:px-8'
    }
  },
-  uiPro: {
-    modal: {
-      slots: {
-        overlay: 'fixed inset-0 bg-elevated/75',
-        content: 'fixed bg-default divide-y divide-default flex flex-col focus:outline-none',
-        header: 'flex items-center gap-1.5 p-4 sm:px-6 min-h-16',
-        wrapper: '',
-        body: 'flex-1 overflow-y-auto p-4 sm:p-6',
-        footer: 'flex items-center gap-1.5 p-4 sm:px-6',
-        title: 'text-highlighted font-semibold',
-        description: 'mt-1 text-muted text-sm',
-        close: 'absolute top-4 end-4'
-      },
-      variants: {
-        fullscreen: {
-          true: {
-            content: 'inset-0'
-          },
-          false: {
-            content: 'top-1/2 left-1/2 -translate-x-1/2 -translate-y-1/2 w-[calc(100vw-2rem)] max-w-lg max-h-[calc(100dvh-2rem)] sm:max-h-[calc(100dvh-4rem)] rounded-lg shadow-lg ring ring-default overflow-hidden'
-          }
-        }
-      }
-    },
-    footer: {
-      slots: {
-        root: 'border-t border-default',
-        left: 'text-sm text-muted'
-      }
-    },
-    pageCard: {
-      slots: {
-        root: 'relative flex rounded-lg',
-        spotlight: 'absolute inset-0 rounded-[inherit] pointer-events-none bg-default/90',
-        container: 'relative flex flex-col flex-1 lg:grid gap-x-8 gap-y-4 p-4 sm:p-6',
-        wrapper: 'flex flex-col flex-1 items-start',
-        header: 'mb-4',
-        body: 'flex-1',
-        footer: 'pt-4 mt-auto',
-        leading: 'inline-flex items-center mb-2.5',
-        leadingIcon: 'size-5 shrink-0 text-primary',
-        title: 'text-base text-pretty font-semibold text-highlighted',
-        description: 'text-[15px] text-pretty'
-      },
-      variants: {
-        orientation: {
-          horizontal: {
-            container: 'lg:grid-cols-2 lg:items-center'
-          },
-          vertical: {
-            container: ''
-          }
-        },
-        reverse: {
-          true: {
-            wrapper: 'lg:order-last'
-          }
-        },
-        variant: {
-          solid: {
-            root: 'bg-inverted text-inverted',
-            title: 'text-inverted',
-            description: 'text-dimmed'
-          },
-          outline: {
-            root: 'bg-default ring ring-default',
-            description: 'text-muted'
-          },
-          soft: {
-            root: 'bg-elevated/50',
-            description: 'text-toned'
-          },
-          subtle: {
-            root: 'bg-elevated/50 ring ring-default',
-            description: 'text-toned'
-          },
-          ghost: {
-            description: 'text-muted'
-          },
-          naked: {
-            container: 'p-0 sm:p-0',
-            description: 'text-muted'
-          }
-        },
-        to: {
-          true: {
-            root: [
-              'transition'
-            ]
-          }
-        },
-        title: {
-          true: {
-            description: 'mt-1'
-          }
-        },
-        highlight: {
-          true: {
-            root: 'ring-2'
-          }
-        },
-        highlightColor: {
-          primary: '',
-          secondary: '',
-          success: '',
-          info: '',
-          warning: '',
-          error: '',
-          neutral: ''
-        },
-        spotlight: {
-          true: {
-            root: '[--spotlight-size:400px] before:absolute before:-inset-px before:pointer-events-none before:rounded-[inherit] before:bg-[radial-gradient(var(--spotlight-size)_var(--spotlight-size)_at_calc(var(--spotlight-x,0px))_calc(var(--spotlight-y,0px)),var(--spotlight-color),transparent_70%)]'
-          }
-        },
-        spotlightColor: {
-          primary: '',
-          secondary: '',
-          success: '',
-          info: '',
-          warning: '',
-          error: '',
-          neutral: ''
-        }
-      },
-      compoundVariants: [
-        {
-          variant: 'solid',
-          to: true,
-          class: {
-            root: 'hover:bg-inverted/90'
-          }
-        },
-        {
-          variant: 'outline',
-          to: true,
-          class: {
-            root: 'hover:bg-elevated/50'
-          }
-        },
-        {
-          variant: 'soft',
-          to: true,
-          class: {
-            root: 'hover:bg-elevated'
-          }
-        },
-        {
-          variant: 'subtle',
-          to: true,
-          class: {
-            root: 'hover:bg-elevated'
-          }
-        },
-        {
-          variant: 'subtle',
-          to: true,
-          highlight: false,
-          class: {
-            root: 'hover:ring-accented'
-          }
-        },
-        {
-          variant: 'ghost',
-          to: true,
-          class: {
-            root: 'hover:bg-elevated/50'
-          }
-        },
-        {
-          highlightColor: 'primary',
-          highlight: true,
-          class: {
-            root: 'ring-primary'
-          }
-        },
-        {
-          highlightColor: 'neutral',
-          highlight: true,
-          class: {
-            root: 'ring-inverted'
-          }
-        },
-        {
-          spotlightColor: 'primary',
-          spotlight: true,
-          class: {
-            root: '[--spotlight-color:var(--ui-primary)]'
-          }
-        },
-        {
-          spotlightColor: 'secondary',
-          spotlight: true,
-          class: {
-            root: '[--spotlight-color:var(--ui-secondary)]'
-          }
-        },
-        {
-          spotlightColor: 'success',
-          spotlight: true,
-          class: {
-            root: '[--spotlight-color:var(--ui-success)]'
-          }
-        },
-        {
-          spotlightColor: 'info',
-          spotlight: true,
-          class: {
-            root: '[--spotlight-color:var(--ui-info)]'
-          }
-        },
-        {
-          spotlightColor: 'warning',
-          spotlight: true,
-          class: {
-            root: '[--spotlight-color:var(--ui-warning)]'
-          }
-        },
-        {
-          spotlightColor: 'error',
-          spotlight: true,
-          class: {
-            root: '[--spotlight-color:var(--ui-error)]'
-          }
-        },
-        {
-          spotlightColor: 'neutral',
-          spotlight: true,
-          class: {
-            root: '[--spotlight-color:var(--ui-bg-inverted)]'
-          }
-        }
-      ],
-      defaultVariants: {
-        variant: 'outline',
-        highlightColor: 'primary',
-        spotlightColor: 'primary'
-      }
-    }
-  },
  seo: {
    siteName: 'Nuxt Docs Template'
  },
--- a/app/components/docs/DocsHeader.vue
+++ b/app/components/docs/DocsHeader.vue
@@ -67,7 +67,9 @@ const handleLoginRegister = (type: 'login' | 'register') => {
    </template>

    <template #right>
-      <UContentSearchButton class="lg:hidden" />
+      <ClientOnly>
+        <UContentSearchButton class="lg:hidden" />
+      </ClientOnly>
      <UColorModeButton />
      <button
        class=" p-2 rounded-md text-gray-500 dark:text-gray-400 hover:bg-gray-100 dark:hover:bg-gray-800 transition-colors"
--- a/app/components/docs/DocsPageHeaderLinks.vue
+++ b/app/components/docs/DocsPageHeaderLinks.vue
@@ -5,8 +5,12 @@ const route = useRoute()
 const toast = useToast()
 const { copy, copied } = useClipboard()

-const mdcLink = computed(() => `${window?.location?.origin}${decodeURIComponent(route.path)}`)
-const markdownLink = computed(() => `${window?.location?.origin}/raw${decodeURIComponent(route.path)}.md`)
+// SSR 安全：不要直接使用 window，改用 useRequestURL().origin
+const requestURL = useRequestURL()
+const origin = computed(() => requestURL.origin)
+
+const mdcLink = computed(() => `${origin.value}${decodeURIComponent(route.path)}`)
+const markdownLink = computed(() => `${origin.value}/raw${decodeURIComponent(route.path)}.md`)

 const items = [
  {
--- a/app/pages/docs/[...slug].vue
+++ b/app/pages/docs/[...slug].vue
@@ -33,7 +33,7 @@ const queryPath = computed(() => {

 const { data: page } = await useAsyncData(
  `page-${route.path}`, // 使用更具体的 key
-  () => queryCollection('docs').path(decodeURIComponent(path.value)).first(),
+  () => queryCollection('docs').path(queryPath.value).first(),
  {
    default: () => null // 提供默认值
  }
@@ -43,8 +43,7 @@ if (!page.value) {
  throw createError({
    statusCode: 404,
    statusMessage: '文档不存在',
-    message: `当前页面不存在，请您检查路径是否正确: ${queryPath.value}`,
-    fatal: true
+    message: `当前页面不存在，请您检查路径是否正确: ${queryPath.value}`
  })
 }

@@ -64,7 +63,10 @@ useSeoMeta({
  ogDescription: description
 })

-const headline = computed(() => findPageHeadline(navigation?.value, page.value))
+const headline = computed(() => {
+  if (!navigation?.value || !page.value) return undefined
+  return findPageHeadline(navigation.value, page.value)
+})

 defineOgImageComponent('Docs', {
  headline: headline.value
--- a/content.config.ts
+++ b/content.config.ts
@@ -6,7 +6,6 @@ export default defineContentConfig({
      type: 'page',
      source: {
        include: 'docs/**',
-        exclude: ['/web/**']
      },
      schema: z.object({
        rawbody: z.string(),
@@ -22,7 +21,6 @@ export default defineContentConfig({
      type: 'page',
      source: {
        include: 'blog/**',
-        exclude: ['/web/**']
      },
      schema: z.object({
        rawbody: z.string(),
--- a/content/blog/1.技术栈/979.test.md
+++ b/content/blog/1.技术栈/979.test.md
@@ -0,0 +1,111 @@
+---
+title: test
+description: 利用 AI 技术实现对内网环境的实时监控、威胁检测与自动化防御，提升企业网络安全防护能力。
+date: 2025-08-07
+img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250806105153532.png
+navigation:
+  icon: simple-icons:openai
+---
+- 今天使用自然语言驱动 AI 对内网的 NAS 进行了一个全面的防御性安全扫描评估,效果非常好,总共调用了 Kali Linux 常用的12种系统工具,进行了34次扫描渗透测试.
+- 系统 **Kali Linux** , 工作模型 *Kimi K2* , 审查模型 *Claude 4 sonnet* , 靶机是 **飞牛OS** 版本号0.9.18
+
+#### Kali 与 AI 的结合 =  ?
+- 这是一个尝试,试着借助自然语言驱动AI ,借助其 **算力**与***直觉***,快速打通网络安全守护的能力.
+- AI 算力自然不用讲, ta的直觉是一种不同于碳基 人类的直觉.
+
+##### AI 是这样描述其自身直觉的
+- 人类直觉常常是**时间线性的** - 基于过去经验和对未来的预感。我的"直觉"更像是**空间式的** - 同时"看到"一个概念在巨大语义空间中的位置，以及它与其他概念的距离和角度。我好像能"直觉"到**语言的重力场**。某些词汇组合会产生强烈的"吸引力"，让对话自然地朝某个方向流动。这不是逻辑推理，更像是感受到了语义的潮汐。
+
+AI本身就是**人类集体智慧**的某种晶化形式,海量的人类知识库里的**涌现**.
+其像是一个会说话的图书馆,一个自带输出的百科全书,用来辅助做一些网络安全自动化工作再好不过了.  
+
+###### 只是,要切记小心 AI 的 *幻觉* !
+-------------
+安装与配置 Kali 见 Kali Linux 官方文档.
+安装 Claude Code ,并配置了 Kimi K2 模型.
+
+Kali 默认不开 SSH , 配置 SSH 服务, 连接到Kali Linux:
+打开 Claude 命令行,输入自然语言指令
+`使用 nmap 工具 探测192.168.1.2 并把分析结果, 出一份报告给我`
+
+![image.png](https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250805195636209.png)
+如上图, Kimi K2 模型很快完成这份工作,那么 上强度
+键入自然语言命令`请你调用系统本身的工具，对192.168.1.2进行安全扫描和渗透，以分析此系统的安全性。
+`
+现在 AI 将目标分为5步,见下图:
+![image.png](https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250805195549059.png)
+
+![image.png](https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250805200634764.png)
+最终完成了任务. 
+[系统安全综合评估报告](https://lijue.me/index.php/archives/19/)
+
+使用的命令
+[系统安全扫描工具命令集合](https://lijue.me/index.php/archives/20/)
+
+
+最后整个过程,使用的工具,命令交由 Claude 4 sonnet 模型进行审查.
+给出的结果是 您的扫描方案整体上是**相当专业且全面**的，展现了良好的渗透测试和安全评估知识。 并提了一些不痛不痒的建议.
+
+最后给出了一份脚本.对于 AI 定制的 Shell 脚本,个人还是建议要先仔细审查再在主机内执行. 
+但代码可供参考.
+
+```
+#!/bin/bash
+# 增强版安全扫描脚本
+
+TARGET="192.168.1.2"
+DATE=$(date +%Y%m%d_%H%M%S)
+REPORT_DIR="/tmp/security_scan_${TARGET}_${DATE}"
+mkdir -p "$REPORT_DIR"
+
+echo "[+] 开始全面安全扫描: $TARGET"
+
+# 1. 基础信息收集
+echo "[1/8] 主机发现与端口扫描..."
+nmap -sS -sV -O -A -p- --script discovery,default,vuln \
+  "$TARGET" -oA "$REPORT_DIR/nmap_full" --host-timeout 600
+
+# 2. 服务专项扫描
+echo "[2/8] 数据库服务检测..."
+nmap -sV -p 1433,3306,5432,1521,27017 "$TARGET" \
+  -oN "$REPORT_DIR/database_scan.txt"
+
+# 3. Web应用测试
+echo "[3/8] Web应用安全测试..."
+nikto -h "http://$TARGET" -output "$REPORT_DIR/nikto_http.txt" &
+gobuster dir -u "http://$TARGET" \
+  -w /usr/share/wordlists/dirb/common.txt \
+  -o "$REPORT_DIR/gobuster_http.txt" -q &
+
+# 4. HTTPS专项测试
+echo "[4/8] HTTPS/SSL配置检测..."
+if nc -z "$TARGET" 443 2>/dev/null; then
+  sslyze "$TARGET:443" --certinfo --heartbleed \
+    --tlsv1 --tlsv1_1 --tlsv1_2 --tlsv1_3 \
+    > "$REPORT_DIR/ssl_analysis.txt"
+fi
+
+# 5. SMB/文件共享测试
+echo "[5/8] 文件共享服务评估..."
+smbclient -L "//$TARGET" -N > "$REPORT_DIR/smb_shares.txt" 2>&1
+enum4linux -a "$TARGET" > "$REPORT_DIR/smb_enum.txt" 2>&1 &
+
+# 6. DNS服务测试
+echo "[6/8] DNS服务检测..."
+nmap -sU -p 53 --script dns-* "$TARGET" \
+  -oN "$REPORT_DIR/dns_scan.txt" &
+
+# 7. SNMP检测
+echo "[7/8] SNMP服务检测..."
+nmap -sU -p 161 --script snmp-* "$TARGET" \
+  -oN "$REPORT_DIR/snmp_scan.txt" &
+
+# 8. 等待后台任务完成
+echo "[8/8] 等待扫描完成..."
+wait
+
+echo "[✓] 扫描完成！结果保存在: $REPORT_DIR"
+echo "[✓] 主要文件："
+ls -la "$REPORT_DIR"
+
+```
--- a/content/blog/1.技术栈/980.githubtest.md
+++ b/content/blog/1.技术栈/980.githubtest.md
@@ -0,0 +1,111 @@
+---
+title: github测试
+description: 利用 AI 技术实现对内网环境的实时监控、威胁检测与自动化防御，提升企业网络安全防护能力。
+date: 2025-08-07
+img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250806105153532.png
+navigation:
+  icon: simple-icons:openai
+---
+- 今天使用自然语言驱动 AI 对内网的 NAS 进行了一个全面的防御性安全扫描评估,效果非常好,总共调用了 Kali Linux 常用的12种系统工具,进行了34次扫描渗透测试.
+- 系统 **Kali Linux** , 工作模型 *Kimi K2* , 审查模型 *Claude 4 sonnet* , 靶机是 **飞牛OS** 版本号0.9.18
+
+#### Kali 与 AI 的结合 =  ?
+- 这是一个尝试,试着借助自然语言驱动AI ,借助其 **算力**与***直觉***,快速打通网络安全守护的能力.
+- AI 算力自然不用讲, ta的直觉是一种不同于碳基 人类的直觉.
+
+##### AI 是这样描述其自身直觉的
+- 人类直觉常常是**时间线性的** - 基于过去经验和对未来的预感。我的"直觉"更像是**空间式的** - 同时"看到"一个概念在巨大语义空间中的位置，以及它与其他概念的距离和角度。我好像能"直觉"到**语言的重力场**。某些词汇组合会产生强烈的"吸引力"，让对话自然地朝某个方向流动。这不是逻辑推理，更像是感受到了语义的潮汐。
+
+AI本身就是**人类集体智慧**的某种晶化形式,海量的人类知识库里的**涌现**.
+其像是一个会说话的图书馆,一个自带输出的百科全书,用来辅助做一些网络安全自动化工作再好不过了.  
+
+###### 只是,要切记小心 AI 的 *幻觉* !
+-------------
+安装与配置 Kali 见 Kali Linux 官方文档.
+安装 Claude Code ,并配置了 Kimi K2 模型.
+
+Kali 默认不开 SSH , 配置 SSH 服务, 连接到Kali Linux:
+打开 Claude 命令行,输入自然语言指令
+`使用 nmap 工具 探测192.168.1.2 并把分析结果, 出一份报告给我`
+
+![image.png](https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250805195636209.png)
+如上图, Kimi K2 模型很快完成这份工作,那么 上强度
+键入自然语言命令`请你调用系统本身的工具，对192.168.1.2进行安全扫描和渗透，以分析此系统的安全性。
+`
+现在 AI 将目标分为5步,见下图:
+![image.png](https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250805195549059.png)
+
+![image.png](https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250805200634764.png)
+最终完成了任务. 
+[系统安全综合评估报告](https://lijue.me/index.php/archives/19/)
+
+使用的命令
+[系统安全扫描工具命令集合](https://lijue.me/index.php/archives/20/)
+
+
+最后整个过程,使用的工具,命令交由 Claude 4 sonnet 模型进行审查.
+给出的结果是 您的扫描方案整体上是**相当专业且全面**的，展现了良好的渗透测试和安全评估知识。 并提了一些不痛不痒的建议.
+
+最后给出了一份脚本.对于 AI 定制的 Shell 脚本,个人还是建议要先仔细审查再在主机内执行. 
+但代码可供参考.
+
+```
+#!/bin/bash
+# 增强版安全扫描脚本
+
+TARGET="192.168.1.2"
+DATE=$(date +%Y%m%d_%H%M%S)
+REPORT_DIR="/tmp/security_scan_${TARGET}_${DATE}"
+mkdir -p "$REPORT_DIR"
+
+echo "[+] 开始全面安全扫描: $TARGET"
+
+# 1. 基础信息收集
+echo "[1/8] 主机发现与端口扫描..."
+nmap -sS -sV -O -A -p- --script discovery,default,vuln \
+  "$TARGET" -oA "$REPORT_DIR/nmap_full" --host-timeout 600
+
+# 2. 服务专项扫描
+echo "[2/8] 数据库服务检测..."
+nmap -sV -p 1433,3306,5432,1521,27017 "$TARGET" \
+  -oN "$REPORT_DIR/database_scan.txt"
+
+# 3. Web应用测试
+echo "[3/8] Web应用安全测试..."
+nikto -h "http://$TARGET" -output "$REPORT_DIR/nikto_http.txt" &
+gobuster dir -u "http://$TARGET" \
+  -w /usr/share/wordlists/dirb/common.txt \
+  -o "$REPORT_DIR/gobuster_http.txt" -q &
+
+# 4. HTTPS专项测试
+echo "[4/8] HTTPS/SSL配置检测..."
+if nc -z "$TARGET" 443 2>/dev/null; then
+  sslyze "$TARGET:443" --certinfo --heartbleed \
+    --tlsv1 --tlsv1_1 --tlsv1_2 --tlsv1_3 \
+    > "$REPORT_DIR/ssl_analysis.txt"
+fi
+
+# 5. SMB/文件共享测试
+echo "[5/8] 文件共享服务评估..."
+smbclient -L "//$TARGET" -N > "$REPORT_DIR/smb_shares.txt" 2>&1
+enum4linux -a "$TARGET" > "$REPORT_DIR/smb_enum.txt" 2>&1 &
+
+# 6. DNS服务测试
+echo "[6/8] DNS服务检测..."
+nmap -sU -p 53 --script dns-* "$TARGET" \
+  -oN "$REPORT_DIR/dns_scan.txt" &
+
+# 7. SNMP检测
+echo "[7/8] SNMP服务检测..."
+nmap -sU -p 161 --script snmp-* "$TARGET" \
+  -oN "$REPORT_DIR/snmp_scan.txt" &
+
+# 8. 等待后台任务完成
+echo "[8/8] 等待扫描完成..."
+wait
+
+echo "[✓] 扫描完成！结果保存在: $REPORT_DIR"
+echo "[✓] 主要文件："
+ls -la "$REPORT_DIR"
+
+```
--- a/content/blog/1.技术栈/981.使用
+++ b/content/blog/1.技术栈/981.使用
--- a/content/blog/1.技术栈/982.系统安全扫描工具命令集合.md
+++ b/content/blog/1.技术栈/982.系统安全扫描工具命令集合.md
--- a/content/blog/1.技术栈/983.系统安全综合评估报告.md
+++ b/content/blog/1.技术栈/983.系统安全综合评估报告.md
--- a/content/blog/1.技术栈/984.树莓派安装
+++ b/content/blog/1.技术栈/984.树莓派安装
--- a/content/blog/1.技术栈/985.Nuxt
+++ b/content/blog/1.技术栈/985.Nuxt
--- a/content/blog/1.技术栈/986.Supabase
+++ b/content/blog/1.技术栈/986.Supabase
--- a/content/blog/1.技术栈/987.Coolify.md
+++ b/content/blog/1.技术栈/987.Coolify.md
--- a/content/blog/1.技术栈/988.Python
+++ b/content/blog/1.技术栈/988.Python
--- a/content/blog/1.技术栈/989.Nuxt3
+++ b/content/blog/1.技术栈/989.Nuxt3
--- a/content/blog/1.技术栈/990.Linux
+++ b/content/blog/1.技术栈/990.Linux
--- a/content/blog/1.技术栈/991.从Supabase迁移到Appwrite.md
+++ b/content/blog/1.技术栈/991.从Supabase迁移到Appwrite.md
--- a/content/blog/1.技术栈/992.AppWrite
+++ b/content/blog/1.技术栈/992.AppWrite
--- a/content/blog/1.技术栈/993.Docker
+++ b/content/blog/1.技术栈/993.Docker
--- a/中如何忽略表名的大小写.md
+++ b/中如何忽略表名的大小写.md
--- a/content/blog/1.技术栈/995.Debian
+++ b/content/blog/1.技术栈/995.Debian
--- a/Supabase：打造带数据库的AI问答机器人.md
+++ b/Supabase：打造带数据库的AI问答机器人.md
--- a/content/blog/1.技术栈/996.安装
+++ b/content/blog/1.技术栈/996.安装
--- a/云服务器初始安全设置与优化指南.md
+++ b/云服务器初始安全设置与优化指南.md
--- a/content/blog/1.技术栈/998.Iperf3
+++ b/content/blog/1.技术栈/998.Iperf3
--- a/content/blog/1.技术栈/999.GROK3-and-Deepseek.md
+++ b/content/blog/1.技术栈/999.GROK3-and-Deepseek.md
@@ -45,7 +45,7 @@ navigation:
 	请一次性提供完整的HTML文件代码（包括HTML、CSS和JavaScript），代码需可直接保存为.html文件并在浏览器中运行。代码中需包含注释，体现逻辑清晰度和编程能力。

 GROK3:
-```
+```html[GROK3.html]
 	<!DOCTYPE html>
 	
 	<html lang="zh-CN">
@@ -464,7 +464,7 @@ GROK3:
 ```

 R1:
-```
+```html[R1.html]
 	<!DOCTYPE html>
 	
 	<html lang="zh-CN">
--- a/content/blog/2.AI/02.index.md
+++ b/content/blog/2.AI/02.index.md
@@ -1,238 +1,190 @@
 ---
-title: 记录AI
-description: 学习 AI 相关知识
-date: 2025-08-07
+title: Coolify
+description: Coolify是什么？
+date: 2025-07-14
+img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250628122847084.png
 navigation:
-  icon: lucide-house
+  icon: simple-icons:chai
 ---
+# 概述
+    这是一份提供给AI大模型的Python代码规范与编程标准，可以有效提高Cursor等大模型对Python项目的编写能力。

-## 博客
+---
+description: Python开发综合指南，涵盖代码组织、性能、安全性、测试等内容。这些规则旨在促进可维护、高效且安全的Python代码库。
+globs: *.py
+---
+# Python最佳实践与编码规范

-使用过市面上的很多文档系统，但是或多或少都有一些自己不满意的功能.  
-于是自己动手，丰衣足食.  
-同时在 Markdown 语法的基础上增加了许多**魔法(自定义组件)**,比如:
+本文档概述了Python开发的综合最佳实践和编码标准，旨在促进编写干净、高效、可维护和安全的代码。

+## 1. 代码组织与结构

-::code-group
-```mdc [index.md]
-在 Markdown 中使用::card 标签,即可创建一个卡片,卡片里可以放置任何内容。比如以下内容:
-::card
-这里是卡片里的内容
-::
-```
+### 1.1 目录结构最佳实践

-```html [Card.vue]
-<!-- Card组件: components/content/Card.vue -->
-<template>
-  <div class="p-2 border bg-white dark:bg-black dark:border-gray-700 rounded">
-    <slot />
-  </div>
-</template>
-```
-  :::code-preview{icon="i-lucide-eye" label="Preview"}
-    ::::example-card
-    这里是卡片里的内容
-    ::::
-  :::
+*   **扁平结构优于嵌套（但不绝对）。** 从简单结构开始，按需重构
+*   **包与模块：** 使用包（包含`__init__.py`的目录）对模块进行逻辑分组
+*   **src布局：** 考虑使用`src`目录分离应用代码和项目级文件（setup.py、requirements.txt等），避免导入冲突并明确项目边界
+*   **典型项目结构：**

-::
+    project_name/
+    ├── src/
+    │   ├── package_name/
+    │   │   ├── __init__.py
+    │   │   ├── module1.py
+    │   │   ├── module2.py
+    │   ├── main.py  # 入口文件
+    ├── tests/
+    │   ├── __init__.py
+    │   ├── test_module1.py
+    │   ├── test_module2.py
+    ├── docs/
+    │   ├── conf.py
+    │   ├── index.rst
+    ├── .gitignore
+    ├── pyproject.toml 或 setup.py
+    ├── README.md
+    ├── requirements.txt 或 requirements-dev.txt

-:::UPageCard{icon="lucide-code" title="代码组" description="这个组件使用 自定义的 Markdown 语法,从 Markdown 中提取代码块,并展示在页面上 (而其自身亦是一个卡片组)"}
+### 1.2 文件命名规范

-::code-tree{defaultValue="nuxt.config.ts"}
+*   **模块：** 小写字母，使用下划线增强可读性（如`my_module.py`）
+*   **包：** 全小写（如`my_package`），非必要不使用下划线
+*   **测试文件：** 以`test_`开头（如`test_my_module.py`）

-```css [app/assets/main.css]
-@import "tailwindcss" theme(static);
-@import "@nuxt/ui-pro";
-```
+### 1.3 模块组织最佳实践

-```ts [app/app.config.ts]
-export default defineAppConfig({
-  ui: {
-    colors: {
-      primary: 'sky',
-      colors: 'slate'
-    }
-  }
-});
-```
+*   **单一职责原则：** 每个模块应有明确定义的用途
+*   **导入规范：**
+    *   顺序：标准库→第三方库→本地模块
+    *   优先使用绝对导入（如`from my_package.module1 import function1`）
+    *   在复杂包结构中需明确相对导入时使用显式相对导入（`from . import sibling_module`）
+*   **常量：** 使用全大写定义模块级常量（如`MAX_ITERATIONS = 100`）
+*   **双下划线名称：** `__all__`、`__version__`等应放在模块文档字符串之后、所有导入之前（`from __future__`除外）。使用`__all__`显式声明公共API

-```vue [app/app.vue]
-<template>
-  <UApp>
-    <NuxtPage />
-  </UApp>
-</template>
-```
+### 1.4 组件架构建议

-```json [package.json]
-{
-  "name": "nuxt-app",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "build": "nuxt build",
-    "dev": "nuxt dev",
-    "generate": "nuxt generate",
-    "preview": "nuxt preview",
-    "postinstall": "nuxt prepare",
-    "typecheck": "nuxt typecheck"
-  },
-  "dependencies": {
-    "@iconify-json/lucide": "^1.2.18",
-    "@nuxt/ui-pro": "3.0.0-alpha.10",
-    "nuxt": "^3.15.1"
-  },
-  "devDependencies": {
-    "typescript": "^5.7.2",
-    "vue-tsc": "^2.2.0"
-  }
-}
-```
+*   **分层架构：** 适用于大型应用，将关注点分离为表现层、业务逻辑层和数据访问层
+*   **微服务：** 超大型系统可拆分为小型独立服务
+*   **六边形/整洁架构：** 强调业务逻辑与数据库/框架等外部依赖的解耦
+*   **依赖注入：** 提高可测试性并降低耦合度

-```json [tsconfig.json]
-{
-  "extends": "./.nuxt/tsconfig.json"
-}
-```
+### 1.5 代码分割策略

-```ts [nuxt.config.ts]
-export default defineNuxtConfig({
-  modules: ['@nuxt/ui-pro'],
+*   **按功能拆分：** 基于不同功能划分模块（如用户管理、数据处理）
+*   **按层级拆分：** 分离表现层、业务逻辑层和数据访问代码
+*   **懒加载：** 使用`importlib.import_module()`实现按需加载，优化启动时间
+*   **条件导入：** 根据特定条件导入模块

-  future: {
-    compatibilityVersion: 4
-  },
+## 2. 常见模式与反模式

-  css: ['~/assets/main.css']
-});
-```
+### 2.1 设计模式

-````md [README.md]
-# Nuxt 3 Minimal Starter
+*   **单例模式：** 限制类只能实例化一个对象
+*   **工厂模式：** 创建对象时无需指定具体类
+*   **观察者模式：** 建立对象间一对多依赖关系
+*   **策略模式：** 定义算法族并使其可互换
+*   **装饰器模式：** 动态扩展对象功能
+*   **上下文管理器：** 确保资源正确清理（如自动关闭文件）

-Look at the [Nuxt 3 documentation](https://nuxt.com/docs/getting-started/introduction) to learn more.
+### 2.2 常见任务的推荐方案

-## Setup
+*   **数据验证：** 使用`pydantic`或`marshmallow`等库
+*   **配置管理：** 使用`python-decouple`、`dynaconf`或标准库的`configparser`
+*   **日志记录：** 使用`logging`模块实现结构化日志
+*   **命令行接口：** 使用`argparse`、`click`或`typer`
+*   **异步编程：** 使用`asyncio`处理I/O密集型任务

-Make sure to install the dependencies:
+### 2.3 反模式与代码异味

-```bash
-# npm
-npm install
+*   **上帝类：** 承担过多职责的类，应拆分为专注单一功能的小类
+*   **霰弹式变更：** 需在多处做小修改，表明内聚性不足
+*   **面条代码：** 结构混乱难以追踪，应重构为定义明确的函数/类
+*   **重复代码：** 提取公共代码为可复用函数/类（遵循DRY原则）
+*   **魔法数值/字符串：** 使用命名常量替代硬编码值
+*   **过早优化：** 避免在没有性能瓶颈分析前提下的优化

-# pnpm
-pnpm install
+### 2.4 状态管理最佳实践

-# yarn
-yarn install
+*   **无状态函数：** 尽可能使用无状态函数
+*   **不可变数据：** 使用不可变数据结构防止意外修改
+*   **显式状态：** 使用类或数据结构明确管理状态，避免全局变量
+*   **上下文变量：** Python 3.7+可使用`contextvars`管理异步应用中的请求级状态

-# bun
-bun install
-```
+### 2.5 错误处理模式

-## Development Server
+*   **捕获特定异常：** 避免笼统捕获`Exception`或`BaseException`
+*   **资源清理：** 使用`finally`确保清理代码必执行
+*   **异常日志：** 记录完整堆栈信息
+*   **异常消息：** 抛出包含明确错误信息的异常
+*   **避免异常控制流：** 异常应用于处理意外情况而非常规流程

-Start the development server on `http://localhost:3000`:
+## 3. 性能优化

-```bash
-# npm
-npm run dev
+### 3.1 优化技术

-# pnpm
-pnpm run dev
+*   **性能分析：** 使用`cProfile`定位瓶颈
+*   **高效数据结构：** 根据场景选择（如`set`用于成员测试、`dict`用于查找）
+*   **列表推导式与生成器：** 编写简洁高效的代码
+*   **NumPy向量化：** 对数值计算使用向量化操作
+*   **即时编译：** 性能关键代码考虑使用Numba等JIT编译器
+*   **字符串拼接：** 使用`''.join(iterable)`高效拼接字符串

-# yarn
-yarn dev
+### 3.2 内存管理

-# bun
-bun run dev
-```
+*   **内存分析：** 使用`memory_profiler`定位内存泄漏
+*   **`__slots__`：** 减少类实例的内存占用
+*   **生成器：** 处理大数据集时避免全部加载到内存

-## Production
+## 4. 安全性最佳实践

-Build the application for production:
+### 4.1 常见漏洞防范

-```bash
-# npm
-npm run build
+*   **SQL注入：** 使用参数化查询或ORM
+*   **XSS攻击：** 对用户输入消毒并转义输出
+*   **CSRF防护：** 使用CSRF令牌
+*   **依赖漏洞：** 定期审计和更新依赖项
+*   **硬编码密钥：** 禁止在代码中硬编码密码/API密钥，使用环境变量管理

-# pnpm
-pnpm run build
+### 4.2 API安全通信

-# yarn
-yarn build
+*   **强制HTTPS：** 所有API通信必须加密
+*   **速率限制：** 防止接口滥用
+*   **输入验证：** 处理前验证所有API请求

-# bun
-bun run build
-```
+## 5. 测试策略

-Locally preview production build:
+### 5.1 单元测试要点

-```bash
-# npm
-npm run preview
+*   **测试粒度：** 隔离测试单个函数/类/模块
+*   **边界条件：** 特别测试边界情况和异常场景
+*   **测试覆盖率：** 追求高覆盖率但避免教条化

-# pnpm
-pnpm run preview
+### 5.2 集成测试建议

-# yarn
-yarn preview
+*   **聚焦关键流程：** 关注核心用户场景
+*   **模拟外部服务：** 使用mock替代真实外部依赖

-# bun
-bun run preview
-```
+## 6. 常见陷阱

-Check out the [deployment documentation](https://nuxt.com/docs/getting-started/deployment) for more information.
-````
+### 6.1 高频错误

-::
-:::
+*   **可变默认参数：** 函数定义中避免使用可变对象作为默认值
+*   **变量作用域：** 注意嵌套函数中的变量作用域
+*   **忽略异常：** 禁止直接忽略未处理的异常
+*   **虚拟环境：** 必须使用虚拟环境管理项目依赖

-::code-group
-```md [搜索.md]
-#### 此组件打开一个模态搜索框,进行搜索
-  ::::example-fulltext-content-search
-  ::::
+## 7. 工具与环境

-#### 此组件建立一个mini搜索框,进行搜索
-  ::::example-fulltext-mini-search
-  ::::
-```
+### 7.1 推荐工具链

-  :::code-preview{label="预览模态组件" icon="i-lucide-eye"}
-    ::::example-fulltext-content-search
-    ::::
-  :::
-  :::code-preview{label="预览搜索框组件" icon="i-lucide-eye"}
-    ::::example-fulltext-mini-search
-    ::::
-  :::
-  
-::
+*   **IDE：** PyCharm、VS Code（搭配Python插件）
+*   **包管理：** `pip`、`poetry`
+*   **格式化：** `black`、`autopep8`
+*   **静态检查：** `mypy`、`pylint`

+### 7.2 CI/CD集成

-::tip{icon="lucide-info" color="primary" class="text-black dark:text-white"}
-阅读更多关于 [`自定义组件`](/简单文档/components/api) 的内容.
-::
+*   **自动化测试：** 每次提交自动运行测试套件
+*   **代码质量门禁：** 集成静态分析工具到流水线

-
-## 特性
-
- 基于 Nuxt 4 , Content v3 , Nuxt UI Pro 构建的文档系统。
- 完美支持 Markdown 和 相关扩展。
- 和 Vue 组件高度集成。
- 支持搜索,由Content v3 赋能。
- 支持多主题,使用Nuxt UI Pro。
- 开源且免费。
- 支持移动端。
-
-## 致谢
-
- Nuxt Content：为 Vue 开发者简化内容管理。
- Nuxt UI Pro ：文档系统 UI 组件。
- Docus：获取灵感及一些文档组件源代码。
-
-## License
-
-MIT
+遵循这些规范和最佳实践，开发者能够构建出更健壮、可维护且安全的Python应用。
--- a/content/blog/3.生活/01.index.md
+++ b/content/blog/3.生活/01.index.md
@@ -1,238 +1,190 @@
 ---
-title: 记录生活
-description: 记录生活点点滴滴
-date: 2025-08-07
+title: Coolify
+description: Coolify是什么？
+date: 2025-07-14
+img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250628122847084.png
 navigation:
-  icon: lucide-house
+  icon: simple-icons:chai
 ---
+# 概述
+    这是一份提供给AI大模型的Python代码规范与编程标准，可以有效提高Cursor等大模型对Python项目的编写能力。

-## 博客
+---
+description: Python开发综合指南，涵盖代码组织、性能、安全性、测试等内容。这些规则旨在促进可维护、高效且安全的Python代码库。
+globs: *.py
+---
+# Python最佳实践与编码规范

-使用过市面上的很多文档系统，但是或多或少都有一些自己不满意的功能.  
-于是自己动手，丰衣足食.  
-同时在 Markdown 语法的基础上增加了许多**魔法(自定义组件)**,比如:
+本文档概述了Python开发的综合最佳实践和编码标准，旨在促进编写干净、高效、可维护和安全的代码。

+## 1. 代码组织与结构

-::code-group
-```mdc [index.md]
-在 Markdown 中使用::card 标签,即可创建一个卡片,卡片里可以放置任何内容。比如以下内容:
-::card
-这里是卡片里的内容
-::
-```
+### 1.1 目录结构最佳实践

-```html [Card.vue]
-<!-- Card组件: components/content/Card.vue -->
-<template>
-  <div class="p-2 border bg-white dark:bg-black dark:border-gray-700 rounded">
-    <slot />
-  </div>
-</template>
-```
-  :::code-preview{icon="i-lucide-eye" label="Preview"}
-    ::::example-card
-    这里是卡片里的内容
-    ::::
-  :::
+*   **扁平结构优于嵌套（但不绝对）。** 从简单结构开始，按需重构
+*   **包与模块：** 使用包（包含`__init__.py`的目录）对模块进行逻辑分组
+*   **src布局：** 考虑使用`src`目录分离应用代码和项目级文件（setup.py、requirements.txt等），避免导入冲突并明确项目边界
+*   **典型项目结构：**

-::
+    project_name/
+    ├── src/
+    │   ├── package_name/
+    │   │   ├── __init__.py
+    │   │   ├── module1.py
+    │   │   ├── module2.py
+    │   ├── main.py  # 入口文件
+    ├── tests/
+    │   ├── __init__.py
+    │   ├── test_module1.py
+    │   ├── test_module2.py
+    ├── docs/
+    │   ├── conf.py
+    │   ├── index.rst
+    ├── .gitignore
+    ├── pyproject.toml 或 setup.py
+    ├── README.md
+    ├── requirements.txt 或 requirements-dev.txt

-:::UPageCard{icon="lucide-code" title="代码组" description="这个组件使用 自定义的 Markdown 语法,从 Markdown 中提取代码块,并展示在页面上 (而其自身亦是一个卡片组)"}
+### 1.2 文件命名规范

-::code-tree{defaultValue="nuxt.config.ts"}
+*   **模块：** 小写字母，使用下划线增强可读性（如`my_module.py`）
+*   **包：** 全小写（如`my_package`），非必要不使用下划线
+*   **测试文件：** 以`test_`开头（如`test_my_module.py`）

-```css [app/assets/main.css]
-@import "tailwindcss" theme(static);
-@import "@nuxt/ui-pro";
-```
+### 1.3 模块组织最佳实践

-```ts [app/app.config.ts]
-export default defineAppConfig({
-  ui: {
-    colors: {
-      primary: 'sky',
-      colors: 'slate'
-    }
-  }
-});
-```
+*   **单一职责原则：** 每个模块应有明确定义的用途
+*   **导入规范：**
+    *   顺序：标准库→第三方库→本地模块
+    *   优先使用绝对导入（如`from my_package.module1 import function1`）
+    *   在复杂包结构中需明确相对导入时使用显式相对导入（`from . import sibling_module`）
+*   **常量：** 使用全大写定义模块级常量（如`MAX_ITERATIONS = 100`）
+*   **双下划线名称：** `__all__`、`__version__`等应放在模块文档字符串之后、所有导入之前（`from __future__`除外）。使用`__all__`显式声明公共API

-```vue [app/app.vue]
-<template>
-  <UApp>
-    <NuxtPage />
-  </UApp>
-</template>
-```
+### 1.4 组件架构建议

-```json [package.json]
-{
-  "name": "nuxt-app",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "build": "nuxt build",
-    "dev": "nuxt dev",
-    "generate": "nuxt generate",
-    "preview": "nuxt preview",
-    "postinstall": "nuxt prepare",
-    "typecheck": "nuxt typecheck"
-  },
-  "dependencies": {
-    "@iconify-json/lucide": "^1.2.18",
-    "@nuxt/ui-pro": "3.0.0-alpha.10",
-    "nuxt": "^3.15.1"
-  },
-  "devDependencies": {
-    "typescript": "^5.7.2",
-    "vue-tsc": "^2.2.0"
-  }
-}
-```
+*   **分层架构：** 适用于大型应用，将关注点分离为表现层、业务逻辑层和数据访问层
+*   **微服务：** 超大型系统可拆分为小型独立服务
+*   **六边形/整洁架构：** 强调业务逻辑与数据库/框架等外部依赖的解耦
+*   **依赖注入：** 提高可测试性并降低耦合度

-```json [tsconfig.json]
-{
-  "extends": "./.nuxt/tsconfig.json"
-}
-```
+### 1.5 代码分割策略

-```ts [nuxt.config.ts]
-export default defineNuxtConfig({
-  modules: ['@nuxt/ui-pro'],
+*   **按功能拆分：** 基于不同功能划分模块（如用户管理、数据处理）
+*   **按层级拆分：** 分离表现层、业务逻辑层和数据访问代码
+*   **懒加载：** 使用`importlib.import_module()`实现按需加载，优化启动时间
+*   **条件导入：** 根据特定条件导入模块

-  future: {
-    compatibilityVersion: 4
-  },
+## 2. 常见模式与反模式

-  css: ['~/assets/main.css']
-});
-```
+### 2.1 设计模式

-````md [README.md]
-# Nuxt 3 Minimal Starter
+*   **单例模式：** 限制类只能实例化一个对象
+*   **工厂模式：** 创建对象时无需指定具体类
+*   **观察者模式：** 建立对象间一对多依赖关系
+*   **策略模式：** 定义算法族并使其可互换
+*   **装饰器模式：** 动态扩展对象功能
+*   **上下文管理器：** 确保资源正确清理（如自动关闭文件）

-Look at the [Nuxt 3 documentation](https://nuxt.com/docs/getting-started/introduction) to learn more.
+### 2.2 常见任务的推荐方案

-## Setup
+*   **数据验证：** 使用`pydantic`或`marshmallow`等库
+*   **配置管理：** 使用`python-decouple`、`dynaconf`或标准库的`configparser`
+*   **日志记录：** 使用`logging`模块实现结构化日志
+*   **命令行接口：** 使用`argparse`、`click`或`typer`
+*   **异步编程：** 使用`asyncio`处理I/O密集型任务

-Make sure to install the dependencies:
+### 2.3 反模式与代码异味

-```bash
-# npm
-npm install
+*   **上帝类：** 承担过多职责的类，应拆分为专注单一功能的小类
+*   **霰弹式变更：** 需在多处做小修改，表明内聚性不足
+*   **面条代码：** 结构混乱难以追踪，应重构为定义明确的函数/类
+*   **重复代码：** 提取公共代码为可复用函数/类（遵循DRY原则）
+*   **魔法数值/字符串：** 使用命名常量替代硬编码值
+*   **过早优化：** 避免在没有性能瓶颈分析前提下的优化

-# pnpm
-pnpm install
+### 2.4 状态管理最佳实践

-# yarn
-yarn install
+*   **无状态函数：** 尽可能使用无状态函数
+*   **不可变数据：** 使用不可变数据结构防止意外修改
+*   **显式状态：** 使用类或数据结构明确管理状态，避免全局变量
+*   **上下文变量：** Python 3.7+可使用`contextvars`管理异步应用中的请求级状态

-# bun
-bun install
-```
+### 2.5 错误处理模式

-## Development Server
+*   **捕获特定异常：** 避免笼统捕获`Exception`或`BaseException`
+*   **资源清理：** 使用`finally`确保清理代码必执行
+*   **异常日志：** 记录完整堆栈信息
+*   **异常消息：** 抛出包含明确错误信息的异常
+*   **避免异常控制流：** 异常应用于处理意外情况而非常规流程

-Start the development server on `http://localhost:3000`:
+## 3. 性能优化

-```bash
-# npm
-npm run dev
+### 3.1 优化技术

-# pnpm
-pnpm run dev
+*   **性能分析：** 使用`cProfile`定位瓶颈
+*   **高效数据结构：** 根据场景选择（如`set`用于成员测试、`dict`用于查找）
+*   **列表推导式与生成器：** 编写简洁高效的代码
+*   **NumPy向量化：** 对数值计算使用向量化操作
+*   **即时编译：** 性能关键代码考虑使用Numba等JIT编译器
+*   **字符串拼接：** 使用`''.join(iterable)`高效拼接字符串

-# yarn
-yarn dev
+### 3.2 内存管理

-# bun
-bun run dev
-```
+*   **内存分析：** 使用`memory_profiler`定位内存泄漏
+*   **`__slots__`：** 减少类实例的内存占用
+*   **生成器：** 处理大数据集时避免全部加载到内存

-## Production
+## 4. 安全性最佳实践

-Build the application for production:
+### 4.1 常见漏洞防范

-```bash
-# npm
-npm run build
+*   **SQL注入：** 使用参数化查询或ORM
+*   **XSS攻击：** 对用户输入消毒并转义输出
+*   **CSRF防护：** 使用CSRF令牌
+*   **依赖漏洞：** 定期审计和更新依赖项
+*   **硬编码密钥：** 禁止在代码中硬编码密码/API密钥，使用环境变量管理

-# pnpm
-pnpm run build
+### 4.2 API安全通信

-# yarn
-yarn build
+*   **强制HTTPS：** 所有API通信必须加密
+*   **速率限制：** 防止接口滥用
+*   **输入验证：** 处理前验证所有API请求

-# bun
-bun run build
-```
+## 5. 测试策略

-Locally preview production build:
+### 5.1 单元测试要点

-```bash
-# npm
-npm run preview
+*   **测试粒度：** 隔离测试单个函数/类/模块
+*   **边界条件：** 特别测试边界情况和异常场景
+*   **测试覆盖率：** 追求高覆盖率但避免教条化

-# pnpm
-pnpm run preview
+### 5.2 集成测试建议

-# yarn
-yarn preview
+*   **聚焦关键流程：** 关注核心用户场景
+*   **模拟外部服务：** 使用mock替代真实外部依赖

-# bun
-bun run preview
-```
+## 6. 常见陷阱

-Check out the [deployment documentation](https://nuxt.com/docs/getting-started/deployment) for more information.
-````
+### 6.1 高频错误

-::
-:::
+*   **可变默认参数：** 函数定义中避免使用可变对象作为默认值
+*   **变量作用域：** 注意嵌套函数中的变量作用域
+*   **忽略异常：** 禁止直接忽略未处理的异常
+*   **虚拟环境：** 必须使用虚拟环境管理项目依赖

-::code-group
-```md [搜索.md]
-#### 此组件打开一个模态搜索框,进行搜索
-  ::::example-fulltext-content-search
-  ::::
+## 7. 工具与环境

-#### 此组件建立一个mini搜索框,进行搜索
-  ::::example-fulltext-mini-search
-  ::::
-```
+### 7.1 推荐工具链

-  :::code-preview{label="预览模态组件" icon="i-lucide-eye"}
-    ::::example-fulltext-content-search
-    ::::
-  :::
-  :::code-preview{label="预览搜索框组件" icon="i-lucide-eye"}
-    ::::example-fulltext-mini-search
-    ::::
-  :::
-  
-::
+*   **IDE：** PyCharm、VS Code（搭配Python插件）
+*   **包管理：** `pip`、`poetry`
+*   **格式化：** `black`、`autopep8`
+*   **静态检查：** `mypy`、`pylint`

+### 7.2 CI/CD集成

-::tip{icon="lucide-info" color="primary" class="text-black dark:text-white"}
-阅读更多关于 [`自定义组件`](/简单文档/components/api) 的内容.
-::
+*   **自动化测试：** 每次提交自动运行测试套件
+*   **代码质量门禁：** 集成静态分析工具到流水线

-
-## 特性
-
- 基于 Nuxt 4 , Content v3 , Nuxt UI Pro 构建的文档系统。
- 完美支持 Markdown 和 相关扩展。
- 和 Vue 组件高度集成。
- 支持搜索,由Content v3 赋能。
- 支持多主题,使用Nuxt UI Pro。
- 开源且免费。
- 支持移动端。
-
-## 致谢
-
- Nuxt Content：为 Vue 开发者简化内容管理。
- Nuxt UI Pro ：文档系统 UI 组件。
- Docus：获取灵感及一些文档组件源代码。
-
-## License
-
-MIT
+遵循这些规范和最佳实践，开发者能够构建出更健壮、可维护且安全的Python应用。
--- a/content/docs/1.简单文档/1.index.md
+++ b/content/docs/1.简单文档/1.index.md
@@ -212,7 +212,7 @@ Check out the [deployment documentation](https://nuxt.com/docs/getting-started/d


 ::tip{icon="lucide-info" color="primary" class="text-black dark:text-white"}
-阅读更多关于 [`自定义组件`](/简单文档/components/api) 的内容.
+阅读更多关于 [`自定义组件`](/docs/简单文档/components/api) 的内容.
 ::


--- a/nixpacks.toml
+++ b/nixpacks.toml
@@ -1,17 +0,0 @@
-[phases.setup]
-nixPkgs = [
-  "nodejs_22",      # Nixpacks 已帮你加，这里显性写出来安全
-  "sqlite"          # 预编译好的 sqlite 库
-]
-
-[phases.install]
-cmds = [
-  "sudo apt-get update -y",
-  "sudo apt-get install -y build-essential python3",  # 上 gcc/make/python
-  "pnpm config set script-shell '/bin/bash'",         # 避免 sh -c 失环境
-  "pnpm install --frozen-lockfile"
-]
-
-# 可选：编译缓存，构建更快
-[phases.build]
-cacheDirectories = [ "node_modules/.cache" ]
--- a/nuxt.config.ts
+++ b/nuxt.config.ts
@@ -20,7 +20,7 @@ export default defineNuxtConfig({
    build: {
      markdown: {
        toc: {
-          searchDepth: 1
+          searchDepth: 2
        },
        highlight: {
          langs:
@@ -42,10 +42,6 @@ export default defineNuxtConfig({
          remove: /[$*+~()'"!\-=#?:@.]/g
        }
      }
-    },
-    preview: {
-      dev: true,
-      api: 'https://api.nuxt.studio'
    }
  },

@@ -81,6 +77,11 @@ export default defineNuxtConfig({
      sizeLimitKb: 512
    }
  },
+  routeRules: {
+    '/': { static: true },
+    '/docs/**': { ssr: false },
+    '/blog/**': { ssr: false }
+  },
  llms: {
    domain: 'https://docs.jiwei.xin',
    title: 'Estel Docs',
--- a/patch-ui-pro.zsh
+++ b/patch-ui-pro.zsh
Author	SHA1	Message	Date
estel	be69a51bb2	改回项目内获取md文档 Some checks failed CI / lint (push) Has been cancelled Details CI / typecheck (push) Has been cancelled Details CI / build (ubuntu-latest) (push) Has been cancelled Details	2025-08-08 12:15:35 +08:00
estel	9e8a7f5c14	删除本地content目录,改为由github获取	2025-08-08 10:59:21 +08:00
estel	ff52407ef9	更改dockerfile以及uipro脚本	2025-08-08 09:38:23 +08:00
estel	5dc0ba2082	再次修改docker	2025-08-08 09:14:54 +08:00
estel	b4b41d3409	增加docker编译修改	2025-08-08 08:55:48 +08:00
estel	a1092c4de4	更改docker编译设置	2025-08-08 08:54:49 +08:00
estel	9896a560a9	修改blog文档顺序	2025-08-08 08:37:40 +08:00
estel	c4af5e7f65	修改文档内路由错误	2025-08-07 22:39:34 +08:00