1.    新增“商务分组维护”（SOI_DealerBusinessGroup）模块
•    完成 BusinessMapping、BusinessRule、BusinessView
•    完成页面全套（List/Create/Edit/View/Query + ascx）
•    新增菜单与相关脚本
•    补齐导出顺序配置（Enums.SetOrder）
2.    新增“医院Segment维护”（SOI_CustomerSegment）模块
•    完成 BusinessMapping、BusinessRule、BusinessView
•    完成页面全套（List/Create/Edit/View/Query + ascx）
•    补齐导出顺序配置（Enums.SetOrder）
3.    医院信息维护接入 Segment 外键
•    SOI_CustomerInfo 新增 FK_SegmentID
•    页面新增 Segment GridPicker
•    实现查看回填、新增保存、编辑保存全流程
4.    医院编号查询接入 Segment 外键
•    SOI_NosodochiumNumberQuery 新增 FK_SegmentID
•    页面新增 Segment GridPicker
•    同步到医院信息功能增加 FK_SegmentID 同步写入
5.    删除保护逻辑
•    SOI_CustomerSegment 删除前增加引用校验：
•    被 SOI_CustomerInfo 或 SOI_NosodochiumNumberQuery 使用时禁止删除并提示
•    SOI_DealerBusinessGroup 删除前增加引用校验：
•    被 SOI_SDDealer 使用时禁止删除并提示
6.    经销商信息接入商务分组
•    SOI_SDDealer 新增 FK_DealerBusinessGroupID
•    经销商维护页新增“商务分组”GridPicker
•    完成加载、保存、查看态处理

## MiniMax AI 项目结构与原理

### 📁 文件结构

```
ForAI/
├── config.py          # 配置文件
├── main.py            # 命令行入口
├── minimax_client.py  # API 客户端封装
├── requirements.txt   # 依赖列表
└── .env.example       # 环境变量示例（已弃用）
```

### 🔧 各文件详解

**1. config.py - 配置管理**
```python
MINIMAX_API_KEY = "sk-cp-..."  # API 密钥（写死）
MINIMAX_BASE_URL = "https://api.minimaxi.com/anthropic"  # API 地址
DEFAULT_MODEL = "image-01"  # 默认模型
MAX_TOKENS = 4096  # 最大生成 token 数
TEMPERATURE = 1.0  # 随机性参数
```
原理：集中管理所有配置，简化其他文件的引用。

**2. minimax_client.py - 核心客户端**

```python
class MiniMaxClient:
    # __init__: 初始化 Anthropic SDK 客户端
    # chat(): 支持流式/非流式文字对话
    # simple_chat(): 简易单轮对话
    # generate_image(): 调用 /v1/image_generation 生成图片
```

原理：
- 使用 `anthropic` 官方 SDK 进行文字对话
- 使用 `requests` 库直接调用图像生成 API（因为 SDK 不支持）

**3. main.py - 命令行入口**

使用 `argparse` 解析命令行参数：
- `-m/--message`: 发送的消息
- `-s/--system`: 系统提示词
- `--stream`: 开启流式输出
- `--image/-i`: 图像生成模式
- `--width/--height`: 像素尺寸
- `--aspect-ratio`: 比例（如 16:9）
- `--n`: 生成数量

### 🔄 工作流程

```
用户输入命令
    ↓
main.py 解析参数
    ↓
创建 MiniMaxClient 实例
    ↓
调用相应方法
    ├── chat() / simple_chat() → 文字对话
    └── generate_image() → 图像生成
    ↓
API 返回响应
    ↓
解析并打印结果
```

### 📡 API 调用原理

**文字对话**（使用 Anthropic SDK）：
```
client.messages.create(
    model="MiniMax-M2.7-highspeed",
    messages=[{"role": "user", "content": "..."}],
    system="你是一个助手"
)
```

**图像生成**（直接调用 REST API）：
```python
requests.post(
    "https://api.minimaxi.com/v1/image_generation",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "model": "image-01",
        "prompt": "...",
        "aspect_ratio": "1:1",
        "n": 1
    }
)
```

### 🔑 核心概念

| 参数 | 作用 |
|------|------|
| `temperature` | 控制输出随机性，1.0 为标准，较低值更确定 |
| `max_tokens` | 限制最大生成长度 |
| `stream` | 是否逐字输出（打字机效果） |
| `prompt_optimizer` | 是否让 AI 优化提示词 |
| `aspect_ratio` | 图像宽高比 |

### 🚀 运行示例

```bash
# 文字对话
python main.py -m "你好"

# 流式对话
python main.py -m "写一个故事" --stream

# 生成图片
python main.py -m "一只猫" --image --width 512 --height 512
```

🧭 一、整体结构（先理解）

服务器（wg0）
  ↓
多个客户端（Peer）
  ↓
每个客户端 = 独立密钥 + 独立IP

🚀 二、首次搭建流程（完整）

1️⃣ 安装 WireGuard（服务器）

sudo apt update
sudo apt install wireguard qrencode -y

2️⃣ 生成服务器密钥

wg genkey | tee /etc/wireguard/server_private.key | wg pubkey > /etc/wireguard/server_public.key

查看：

cat /etc/wireguard/server_public.key

3️⃣ 创建服务器配置

sudo nano /etc/wireguard/wg0.conf

写入👇（替换私钥）：

[Interface]
PrivateKey = 服务器私钥
Address = 10.0.0.1/24
ListenPort = 51820

PostUp = sysctl -w net.ipv4.ip_forward=1
PostUp = iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
PostDown = iptables -t nat -D POSTROUTING -o eth0 -j MASQUERADE

4️⃣ 启动服务器

sudo wg-quick up wg0
sudo systemctl enable wg-quick@wg0

查看状态：

sudo wg

📱 三、添加客户端（标准流程）

1️⃣ 客户端生成密钥（推荐）

👉 手机 / 电脑用 WireGuard 自动生成
或：

wg genkey | tee client_private.key | wg pubkey > client_public.key

2️⃣ 在服务器添加客户端

编辑：

sudo nano /etc/wireguard/wg0.conf

追加：

[Peer]
PublicKey = 客户端公钥
AllowedIPs = 10.0.0.2/32

应用（不用重启）：

sudo wg syncconf wg0 <(wg-quick strip wg0)

3️⃣ 客户端配置

[Interface]
PrivateKey = 客户端私钥
Address = 10.0.0.2/24
DNS = 1.1.1.1

[Peer]
PublicKey = 服务器公钥
Endpoint = 服务器IP:51820
AllowedIPs = 0.0.0.0/0
PersistentKeepalive = 25

4️⃣ （可选）生成二维码

qrencode -t ansiutf8 < client.conf

🔐 四、换 Key（重点！！！）

🧨 场景：服务器私钥泄露 / 想更换

1️⃣ 生成新服务器密钥

wg genkey | tee /etc/wireguard/new_server_private.key | wg pubkey > /etc/wireguard/new_server_public.key

2️⃣ 替换 wg0.conf

sudo nano /etc/wireguard/wg0.conf

改：

PrivateKey = 新私钥

3️⃣ 重启服务（必须）

sudo wg-quick down wg0
sudo wg-quick up wg0

4️⃣ 确认新公钥生效

sudo wg show wg0 public-key

👉 必须等于：

cat /etc/wireguard/new_server_public.key

5️⃣ 更新所有客户端（关键）

每个客户端改：

[Peer]
PublicKey = 新服务器公钥

6️⃣ 客户端重新连接

打开 VPN 即可

🔁 五、完全重置（更安全）

👉 如果怀疑泄露严重：

服务器

wg genkey | tee server_private.key | wg pubkey > server_public.key

每个客户端（全部重建）

wg genkey | tee client_private.key | wg pubkey > client_public.key

更新服务器

[Peer]
PublicKey = 新客户端公钥
AllowedIPs = 新IP

🧪 六、验证是否成功

服务器查看

sudo wg

重点看：

latest handshake: 刚刚

测试网络

客户端：

ping 10.0.0.1

⚡ 七、常用命令速查

查看状态

sudo wg

查看公钥

sudo wg show wg0 public-key

启动/停止

sudo wg-quick up wg0
sudo wg-quick down wg0

热更新配置

sudo wg syncconf wg0 <(wg-quick strip wg0)

🧠 八、关键记忆（超重要）

👉 WireGuard 核心就是：

私钥（身份） + 公钥（认证） + IP（唯一标识）

.\scripts\deploy.ps1 -ServerHost "106.54.42.242" -ServerUser "ubuntu" -ServerComposePath "/home/ubuntu"

Write-Host "正在清理 VSCode 相关文件..." -ForegroundColor Yellow # 停止可能运行的 VSCode 进程 Get-Process "Code" -ErrorAction SilentlyContinue | Stop-Process -Force # 删除文件夹 $paths = @( "$env:APPDATA\Code", "$env:APPDATA\Code - Insiders", "$env:LOCALAPPDATA\Programs\Microsoft VS Code", "$env:LOCALAPPDATA\Programs\VS Code", "$HOME\.vscode" ) foreach ($path in $paths) { if (Test-Path $path) { Remove-Item -Recurse -Force $path Write-Host "已删除: $path" -ForegroundColor Green } } Write-Host "清理完成！" -ForegroundColor Green

在用 uvx 配置 MCP server 时，安装 amap-mcp-server==0.1.11 失败，报错是
The system cannot open the device or file specified (os error -2147024786)，随后触发 MCP error -32000: Connection closed。

uvx 的独立安装/缓存链路在 Windows 上出问题。
机器里同时有两份 uv（pip 版 + standalone 版），导致 uv self update 初始失败。
解决方案总结：
1. 先解决 uv 冲突：卸载 pip 版或确保命中 standalone 版。

卸载 pip 版 uv

新开一个 PowerShell，确认命中的是 standalone

问题总结（可直接记录）：

1. 现象  
本地 `git push` 失败，原因是提交历史里包含了 `DiaryWebsite.Web/logs/` 下超过 100MB 的 `.log` 文件（GitHub 单文件上限 100MB）。

2. 约束  
你已经有很多其他改动并且都 commit 了，不能简单回退提交。

3. 处理思路  
不回退业务改动，只把大日志文件从 Git 历史中移除，并防止未来再次被提交。

4. 关键操作  
- 在 `.gitignore` 中忽略日志文件（如 `DiaryWebsite.Web/logs/*.log`）。  
- 用历史清理工具（`git filter-repo`）删除历史中的日志文件记录。  
- 清理后发现远程 `origin` 丢失（报错：`'origin' does not appear to be a git repository`）。  
- 重新添加远程：`https://github.com/jy02542317/Diary.git`。  
- `git fetch origin --prune` 后，再执行  
  `git push -u origin main --force-with-lease` 成功。

5. 最终结果  
远程 `main` 已成功更新（forced update），仓库恢复可正常 push/pull。

6. 经验与预防  
- 日志、打包产物、大模型文件不要直接进 Git。  
- 通过 `.gitignore` 提前屏蔽 `logs/*.log`。  
- 大文件如需版本管理，使用 Git LFS。  
- 一旦做了历史重写并 force push，需通知协作者同步分支。

```bash
# 1) 先备份一个分支（防止误操作）
git branch backup-before-clean-large-file

# 2) 忽略日志文件
echo DiaryWebsite.Web/logs/*.log >> .gitignore
git add .gitignore
git commit -m "chore: ignore log files"

# 3) 安装历史清理工具（若未安装）
pip install git-filter-repo

# 4) 从历史中移除 logs 下的 .log 文件
git filter-repo --force --path-glob "DiaryWebsite.Web/logs/*.log" --invert-paths

# 5) 重新添加远程（filter-repo 后可能丢失）
git remote add origin https://github.com/jy02542317/Diary.git

# 6) 检查远程是否配置成功
git remote -v
git remote get-url origin

# 7) 拉取远端引用，避免 force-with-lease 的 stale info
git fetch origin --prune

# 8) 强制推送清理后的 main（保留 lease 保护）
git push -u origin main --force-with-lease
```

你这次实际成功推送时的关键输出是：
- `branch 'main' set up to track 'origin/main'.`
- `main -> main (forced update)`

**完整安装过程总结（含踩坑与解决）**

1. 目标  
在 Windows 上全局安装 `k6`，并能在任意目录执行 `k6` 命令。

2. 初始问题  
你一开始执行：
```powershell
winget install k6 --source winget
```
报错：`winget` 无法识别。  
原因：系统虽有“应用安装程序（App Installer）”，但 `winget` 命令入口未生效（PATH/别名/注册问题）。

3. 修复 `winget` 的过程  
你做了这些关键操作：

```powershell
$pkg = Get-AppxPackage Microsoft.DesktopAppInstaller
Add-AppxPackage -DisableDevelopmentMode -Register "$($pkg.InstallLocation)\AppXManifest.xml"
```

中途遇到错误 `0x80073D02`（资源被占用），通过关闭占用程序后重试解决。  
之后又发现：
```powershell
$env:Path -split ';' | Select-String "WindowsApps"
```
为空，说明 `WindowsApps` 不在 PATH。补 PATH 后，`winget --info` 成功，说明 `winget` 已恢复可用。

4. 安装 `k6` 时的问题  
你先用：
```powershell
winget install -e --id k6.k6 --source winget
```
失败“找不到包”。  
原因：包 ID 写错。正确 ID 来自搜索结果：
```powershell
winget search k6 --source winget
```
显示正确 ID 是 `GrafanaLabs.k6`。

5. 正确安装命令  
最终成功安装：
```powershell
winget install -e --id GrafanaLabs.k6 --source winget
```
安装日志显示已下载并安装 MSI 成功。

6. 安装后 `k6` 仍不可识别  
你执行 `k6 version` 仍报找不到命令。  
原因：新安装路径未在当前终端会话生效（常见 PATH 刷新问题）。  
解决方式：
1. 关闭并重新打开 PowerShell 再试。  
2. 若仍不行，定位 `k6.exe` 路径并加入 PATH（通常是 `C:\Program Files\k6`）。

7. 最终结论  
你已经完成了核心安装，当前只差终端会话/PATH 生效这一步。  
最终应达到：
```powershell
k6 version
```
可正常输出版本号，即全局安装成功。

---

**这次最关键的经验**
1. `winget search` 里 `ID` 列才是可安装的精确包名。  
2. “安装成功但命令不可用”通常是 PATH 未刷新，不一定是安装失败。  
3. `App Installer` 显示已安装，不代表 `winget` 一定立即可用，可能还需注册/别名/PATH 修复。

1. 本地构建并打包镜像

cd c:\Users\jeffery\Documents\GitHub\Diary

# 构建镜像
docker build -t diary-website:latest .

# 打包
docker save diary-website:latest -o diary-website.tar

# 加载镜像
docker load -i diary-website.tar

sudo docker stop diary-website
sudo docker rm diary-website

# 启动容器
docker-compose up -d

# 查看状态
docker-compose ps