zhoujie
2ba87c8f6e
- 新增 GitHub Issue 模板（Bug 报告、功能请求）和 Pull Request 模板 - 新增 Code of Conduct（贡献者行为准则）和 Security Policy（安全政策） - 新增 CI 工作流（GitHub Actions），包含 ruff 代码检查和导入验证 - 新增开发依赖文件 requirements-dev.txt 📦 build(ci): 配置 GitHub Actions 持续集成 - 在 push 到 main 分支和 pull request 时自动触发 CI - 添加 lint 任务执行 ruff 代码风格检查 - 添加 import-check 任务验证核心服务模块导入 ♻️ refactor(structure): 重构项目目录结构 - 将根目录的 6 个服务模块迁移至 services/ 包 - 更新所有相关文件的导入语句（main.py、ui/、services/） - 根目录仅保留 main.py 作为唯一 Python 入口文件 🔧 chore(config): 调整配置和资源文件路径 - 将 config.json 移至 config/ 目录，更新相关引用 - 将个人头像图片移至 assets/faces/ 目录，更新 .gitignore - 更新 Dockerfile 和 docker-compose.yml 中的配置路径 📝 docs(readme): 完善 README 文档 - 添加项目状态徽章（Python 版本、License、CI） - 更新项目结构图反映实际目录布局 - 修正使用指南中的 Tab 名称和操作路径 - 替换 your-username 占位符为格式提示 🗑️ chore(cleanup): 清理冗余文件 - 删除旧版备份文件、测试脚本、临时记录和运行日志 - 删除散落的个人图片文件（已归档至 assets/faces/）
2.0 KiB
2.0 KiB
Context
项目工作区根目录（f:\3_Personal\AI\xhs_bot\autobot\）随开发过程积累了多个无用文件：旧版备份（main_v1_backup.py）、配置副本（config copy.json）、一次性测试脚本（_test_config_save.py）、临时记录（Todo.md）、运行日志（autobot.log``）以及散落的个人图片（4 张 .png/.jpg`）。
这些文件虽已被 .gitignore 排除出版本控制，但依然存在于工作区，干扰了目录可读性。无需改动任何运行时逻辑。
Goals / Non-Goals
Goals:
- 删除 5 个明确无用的文件
- 将 4 张个人图片归入
assets/faces/目录并更新.gitignore - 完善
.gitignore注释与规则覆盖 - 建立
project-structure规范 spec，为后续维护提供参考
Non-Goals:
- 不将根目录服务文件（
analytics_service.py、llm_service.py等）迁移至services/（涉及 import 改动，留作独立变更） - 不修改任何 Python 业务代码
- 不调整 Docker / CI 配置
Decisions
决策 1：图片归档至 assets/faces/
- 选择
assets/faces/而非直接删除，因为换脸功能可能在 UI 中需要默认头像路径，保留文件可避免破坏演示/教学场景 - 替代方案：直接删除 → 风险是用户文档引用了这些文件路径
决策 2：assets/faces/ 整体纳入 .gitignore
- 个人图片属于隐私敏感数据，不应进入版本控制
- 在
.gitignore中新增assets/faces/规则，并补充注释
决策 3：Todo.md 直接删除而非迁移
- 内容已过时且已有 openspec 任务管理体系替代，迁移意义不大
Risks / Trade-offs
- [风险]
my_face.png等文件路径可能被config.json引用 → 缓解：删除前检查config.json中是否存在相关路径字段；若存在则仅移动不删除，并在config.example.json中更新说明 - [风险]
_autostart.bat/_autostart.vbs与assets/faces/路径无关，但同属根目录非标准文件 → 此次保留，自动启动脚本属于有效使用场景