- README.md：重写功能概述、完整目录结构（routes/services/utils + container）、
  三层架构图、快速开始、部署流程、环境变量表、技能清单、本地开发注意、
  P0/P1 重构记录
- CLAUDE.md：重写为 Claude Code 项目指令，含目录结构、分层约定
  （单例走 container、路径走 utils/paths）、勿改接口模块、异常规范、
  常用命令、6 条避坑、当前 P1 完成状态
- 两份文档均从过时的旧结构更新到 P1-3 重构后的真实架构
Co-Authored-By: Claude <noreply@anthropic.com>

P1-3 架构重构后新增了 routes/、services/ 目录与 container.py、decorators.py 改动，
upload_to_server.py 需同步更新上传清单，否则部署到 5.60 会缺失文件导致服务起不来。
Co-Authored-By: Claude <noreply@anthropic.com>

- server.py 从 1443 行精简到 146 行，改为 create_app() 应用工厂模式
- 新增 container.py 依赖容器：集中单例与 config，解决跨模块全局副作用
  （rebuild_search_index 的单例重置改用 container.reset_search_engine）
- 新增 utils/paths.py：路径常量集中（SCRIPT_DIR/PROJECT_ROOT/RECORDS_DIR 等）
- 新增 utils/audit.py：log_audit 迁入
- 新增 utils/record_utils.py：5 个入库纯函数迁入
- 新增 services/ai_service.py：build_prompt/call_claude_api 等迁入
- 新增 services/record_service.py：rebuild_search_index 迁入
- 新增 routes/ 5 个 Blueprint（auth/troubleshoot/cache/export/submit）
- decorators.py：url_for('login') 适配为 url_for('auth.login')
- API 路径与响应格式严格不变（15 端点验证通过）
- 94 单元测试回归全绿
- 回写 P1 需求/计划文档：P1-3 验收勾选、执行记录与问题记录补全
Co-Authored-By: Claude <noreply@anthropic.com>

- 新建 skill/code/tests/ 目录：conftest.py 注入 web/ 路径与索引副本，
  使 SearchEngine 在本地可实例化（避免 FileNotFoundError）
- test_safety_filter.py（41 用例）：覆盖 check_dangerous / is_allowed_operation
  / check_relevance / extract_query_keywords / filter_output / filter_sensitive_info
  / filter_output_with_sensitive
- test_cache_manager.py（19 用例）：覆盖 get/set/clear_expired/clear_all/get_stats
  /check_and_clean_if_needed，含损坏文件、不可序列化、超限清理边界
- test_search_engine.py（34 用例）：覆盖 tokenize/compute_tf/idf/tfidf/cosine
  及 SearchEngine 实例化/search/项目分类过滤/get_projects/get_categories
- 新增 pytest.ini 配置；requirements.txt 追加 pytest/pytest-cov/pytest-mock
- .gitignore 补充 .coverage、.pytest_cache/ 忽略规则
- 移除误入库的 __pycache__/*.pyc 编译产物
- 核心模块覆盖率：safety_filter 99% / cache_manager 87% / search_engine 85%，均 > 80%
- 回写 P1 需求/计划文档：P1-2 验收勾选、执行记录与问题记录补全
Co-Authored-By: Claude <noreply@anthropic.com>

- 新增 utils/ 工具包：统一日志配置（logger）、错误码定义（error_codes）、API 响应封装（response）
- cache_manager.py：笼统 except Exception 拆分为 FileNotFoundError / JSONDecodeError / OSError 精准处理
- server.py：12 处 print / traceback.print_exc 替换为 logger.error / logger.exception
- server.py：新增网络异常（RequestException）和响应解析异常（KeyError/ValueError）捕获
- deploy/upload_to_server.py：数据源统一到 skill/code/web/，新增 DIRS_TO_UPLOAD 目录递归上传
- 新增 .claude/skills/HANDOFF/ 会话交接技能
- CLAUDE.md 注册 /handoff 技能入口
- Docs/ 新增 P1 级代码质量优化相关 PRD 文档
Co-Authored-By: Claude <noreply@anthropic.com>

- 移除 login.html 底部默认管理员账号密码提示
- 移除 upload_login_auth.py 部署完成后的默认账号打印
- 新增 PRD 需求文档及计划执行文档
Co-Authored-By: Claude <noreply@anthropic.com>

- 创建 .claude/skills/ 目录结构
- 复制 GitCommit、CreateCMD、prd-code、prd-plan 技能
- 添加 CLAUDE.md 项目配置文件
Co-Authored-By: Claude <noreply@anthropic.com>

- P0-1: 移除所有硬编码密码，使用环境变量
- P0-2: 修复 server.py 重复赋值 bug
- P0-3: 消除 deploy/web/ 代码重复
- 新增 .env.example 环境变量模板
- 新增 .gitignore
- 更新 README.md 目录结构说明
- 更新部署脚本从统一源目录复制
Co-Authored-By: Claude <noreply@anthropic.com>

新增 5 个 Claude Code skills 和 Troubleshoot 完整功能：

**Skills 新增：**
- CreateCMD: 在当前目录打开指定数量 CMD 窗口
- git-commit: 代码提交辅助工具（审查、分类、生成 Conventional Commits）
- prd-plan: 解析 PRD 需求文档生成执行计划
- prd-code: 解析执行计划文档生成/更新代码
- Troubleshoot: 问题排查协助（含 600+ 行排查流程、高频场景、已知坑速查表）

**项目文件：**
- 新增 Troubleshoot Web 服务代码（Flask + TF-IDF 搜索 + 安全过滤）
- 新增 PRD 文档集合（需求文档、执行计划、部署报告、用户手册）
- 新增 README.md 项目说明
- 新增 config/deploy 配置和部署脚本
- 删除过时的运维集控脚本
Co-Authored-By: Claude <noreply@anthropic.com>