Bug 清单

（`commit 1d6a90d`）：
- 从 `requirements.txt` 移除 `passlib[bcrypt]`，改用 `bcrypt>=4.0.0`
- `security.py` 使用 `bcrypt.hashpw()` / `bcrypt.checkpw()` 替代 `pwd_context.hash()` / `pwd_context.verify()`

（`commit 1d6a90d` `fix: Windows 本地 PostgreSQL 开发与 bcrypt 兼容`）：
1. `config.py` 启动时设置 `os.environ.setdefault("PGCLIENTENCODING", "UTF8")`
2. `session.py` 连接参数添加 `client_encoding="utf8"` + `connect_timeout=10`
3. `alembic/env.py` 同样添加 `client_encoding` 和 `PGCLIENTENCODING`
4. Settings 同时从 `_SERVER_ROOT / .env` 和 `_REPO_ROOT / .env` 查找

SQL 统计条件改为 `page_path LIKE '/products%'`

从 Flyway SQL 重新执行建表语句重建。

（`f7f2343`）：删除独立 server 块，改用 sed 将鲜知 location 注入到现有的 listen 80 server 块内。

1. `Dockerfile.cpu` 改为 `FROM python:3.12-slim`（与本机缓存一致）
2. 新增 `docker-compose.offline.yml` — 离线 Compose（`pull_policy=never`）
3. 新增 `docker-compose.redis-only.yml` — 仅启动 Redis
4. 新增 `scripts/start-dev-local.ps1` — 一键本地开发启动脚本
5. README 添加「方案 B2（推荐 Docker 用户，零构建）」说明

1. 新增 `docker-compose.prebuilt.yml` — 使用本机已有 `python:3.12-slim` 镜像，`pull_policy=never`，零构建启动
2. README 添加「方案 B2（推荐 Docker 用户，零构建）」说明
3. 确认本机已有 `python:3.12-slim` 和 `redis:7-alpine`

改用 `DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")`

for f in (title, fix_command, detect_command): value = sanitize_pii(value)  # 消除绕过

UPDATE <t> SET <c> = replace(<c>, 'htt<server>', 'http://<server>') WHERE <c> ~ 'htt<server>';

docker restart <nginx-container>   # 或 nginx -s reload（需 nginx 能重新解析）

grep -rn '@Cacheable' --include='*.java' | grep -iE 'page|Page<'  # 排查同类地雷

根因未定位，采用**工程隔离**（非修复）：`scripts/test_ci.py` 把根套件改为**每个测试文件一个独立进程**（一次崩溃只废掉一个文件而不是整轮）、每个进程加超时（默认 300s，超时按失败处理并 kill）、对原生崩溃码 `0xC0000005` 自动重试并在汇总里**显式打印 FLAKY**（不静默吞掉）。

```bash
# 修复前：串行 ~55-60% 处整轮崩溃（约 40% 概率）
python -m pytest tests -q
# 修复后：每文件独立进程 + 超时 + 崩溃重试 + FLAKY 显式报告
python scripts/test_ci.py --suite root
```

def _scan_and_renew(...):
    from .alerts import check_and_alert  # 补上局部导入
    ...
# 更好的做法：把 import 移到模块顶层

（v1.1.0）：集成真实 `omnitruth-chain-hash::ChainHasher`（SHA-256(prev_hash \|\| event_bytes) + Ed25519 签名）和 `omnitruth-merkle::MerkleTree`（批量默克尔根哈希聚合）到 vendor/ 目录下。

python3 - <<'EOF'
import re
p='/etc/default/<svc>'
out=[]
for ln in open(p,encoding='utf-8').read().split('\n'):
    ln=ln.rstrip('\r')
    m=re.match(r'^([A-Za-z_][A-Za-z0-9_]*)=(.*?)(\s+#.*)$', ln)
    if m: out += ['%s=%s' % (m.group(1), m.group(2).strip()), m.group(3).strip()]
    else: out.append(ln)
open(p,'w',encoding='utf-8').write('\n'.join(out))
EOF
systemctl daemon-reload && systemctl restart <svc>

vite.config.ts 条件化插件加载后重建

# 用 PROMPT_COMMAND 替代 trap ERR
__dbug_on_prompt() {
  local __ec=$?
  [ "$__ec" -eq 0 ] && return 0
  [ -n "${DBUG_HOOK_OFF:-}" ] && return 0
  local __raw; __raw="$(HISTTIMEFORMAT= builtin history 1 2>/dev/null)"
  if [[ "$__raw" =~ ^[[:space:]]*[0-9]+[[:space:]]+(.*)$ ]]; then __cmd="${BASH_REMATCH[1]}"; fi
  ...
}
PROMPT_COMMAND="__dbug_on_prompt${PROMPT_COMMAND:+;$PROMPT_COMMAND}"

（已在 `build_windows.bat` 和 `README_build.md` 中修复）：
1. `build_windows.bat` 使用 `setlocal EnableDelayedExpansion` 和 `!UNITY_EXE!` 延迟展开
2. 移除注释行中的 `%UNITY_EXE%` 引用（注释中的百分号也会被解析）
3. 在 README_build.md 故障排查中明确说明此问题及 `set UN=` 解法
4. 推荐优先使用 `build_windows.ps1`（PowerShell 无此问题）

调整 `project.py` 中 `ProjectMember` 类定义位置，确保在 `__init__.py` 导入前类已定义。同时在热重载后 `Ctrl+C` 停止并重新启动即可临时解决。

（`commit 1d6a90d`）：
1. 新增 `scripts/setup_local_db.ps1` — 一键检测本机 PostgreSQL 18 服务状态、建库、写入 `.env`
2. 新增 `docs/LOCAL_DEV_WINDOWS.md` — Windows 本地开发排错完整指南
3. 更新 `.env.example` — 默认 `DATABASE_URL` 指向本机 PostgreSQL（免 Docker 模式）
4. 更新 `README.md` — 增加"方式 A：本机 PostgreSQL"和"方式 B：Docker"双路径说明

1. `start-api-only.ps1` 自动检测 8000 端口占用情况，被占用则切换到 8001
2. `verify-stack.ps1` 自动检测 ai_mirror 实际运行端口
3. README 添加 `--port 8001` 说明和「一键启动」小节
4. `start-dev-local.ps1` 添加 Docker 未启动时的 graceful fallback

（`commit 1d6a90d`）：
- 默认 `database_url` 改为 `postgresql+psycopg2://postgres@localhost:5432/chemindra`
- `.env.example` 相应更新，并添加注释说明 Docker 用户如何切换回 `chemindra`
- `scripts/setup_local_db.ps1` 自动写入正确的 Windows 本地连接串

- 修正 `share.py` 中路径计算，改为 `backend/static/shares/`
- 确认 FastAPI `StaticFiles` 挂载与写入路径一致
- 新增 `test_share_create_and_view` 测试用例覆盖

`sudo bash deploy/kill-mysql-app-locks.sh`
- Step 1：`docker compose stop backend` + `docker rm -f app-backend`（停止连接来源）
- Step 2：`SELECT innodb_trx` 列出所有活跃事务
- Step 3：逐一 `KILL <trx_mysql_thread_id>` 所有 innodb_trx 中的线程
- Step 4：`KILL <id>` 所有 processlist 中涉及 `app_db` / `flyway_schema_history` 的连接（排除 Daemon）
- Step 5：若仍有残留事务 → `docker compose restart mysql` 强制重启
- Step 6：重启后验证 `innodb_trx` 事务数为 0

`docker compose build --no-cache frontend`

python -c "p='<script.ps1>';d=open(p,'rb').read();open(p,'wb').write(b'\\xef\\xbb\\xbf'+d) if not d.startswith(b'\\xef\\xbb\\xbf') else None"

JDBC URL 强制 `characterEncoding=UTF-8` + `connectionCollation=utf8mb4_unicode_ci` + sessionVariables

（`038a5df`）：将所有 `Write-Host` 消息改为纯 ASCII 英文，避免 UTF-8 解析错误。

**提交**：`1aeb5d9`

```xml
<!-- pom.xml 添加 -->
<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
```

错误消息改为纯英文：
- `"参数校验失败"` → `"validation failed"`
- `"服务器内部错误"` → `"internal server error"`
- `"用户名或密码错误"` → `"invalid username or password"`
- `"用户不存在或已禁用"` → `"user not found or disabled"`

改用 PowerShell `[System.IO.File]::WriteAllText` 或 Node.js `fs.writeFileSync` 替代 create_file 工具写入。

三类处置并全部验证：(1) 可逆部分（段 GBK 字节数为 3 的倍数）批量反解；(2) 不可逆部分（PUA/被吞字符）用**锚点重建** —— 按 ASCII 字段锚点定位后替换为按上下文推断的中文，被吞的闭合引号自动补回；能反向校验的一律校验（借方科目先猜 `银行存款`，用前缀解码得到 `应收账` 后纠正为 **应收账款**）；(3) 有合法扁平同名实现的 4 个影子副本**直接复制扁平文件为权威内容**，不做推断。另补 wxml 缺失的 `<`。最后补 CI 门禁防复发。

```python
# 不可逆乱码的判据（按可靠性）
PUA = r'[\ue000-\uf8ff]'      # ① 私用区占位符
'€' in s and 中文字数 >= 2     # ② € 夹在中文里（UTF-8 被 CP936 误解的产物）
r'[\u2e80-\u9fff]\?'           # ③ 中文后紧跟半角 ?（后随字符被吞）
s.encode('gbk')                # ④ 长度为 3 的倍数 → 可 decode('utf-8') 还原
        

# PowerShell/.NET
$evaluator = [System.Text.RegularExpressions.MatchEvaluator] { param($m) $replacement }
$new = [regex]::Replace($content, $pattern, $evaluator)
# 或转义
$escaped = $replacement -replace '\$', '$$'

（`950734b`）：将参数名 `$Host` 改为 `$SshHost`，同步更新所有调用点。