按初级程序员可读、可维护的目标重写项目文档,并定案三项设计决策。 新增 - docs/client/00-getting-started.md 上手指南:装环境、跑起来、常见报错 - docs/client/00-glossary.md 术语表:Outbox、幂等、不可逆阶段等 - docs/templates/task.md 工单与归档模板 - client/requirements.txt 固定依赖版本 - .gitignore 屏蔽 data/、打包产物和调试产物 设计定案 - 本地库只存已领取任务,不再镜像 Admin 任务池;已完成任务永久保留 - 去掉租约、心跳和状态回查;Admin 接口从 5 个降到 3 个 (本项目人工付款,重复下单只产生未付款订单,由人工审核处理) - 打包采用 PyInstaller one-dir:launcher.exe + app/ + data/,便携模式 文档改进 - 补齐可直接抄的代码模板:Worker 线程、事务写库、幂等键、增量加载、错误提示、路径解析 - 状态机由 ASCII 图改为完整转换表,并补充崩溃恢复规则 - 消除文档与现有代码的冲突,02 新增“现状与目标差异”清单 - 待确认事项一律给出临时默认值,避免阻塞开发 - AGENTS.md 新增“小改动直通”,工单必填项由 8 项压缩到 6 项 说明:Gitea 尚未配置,本次无对应工单号;AGENTS.md §0 的 Gitea 信息待补。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
20 lines
661 B
Plaintext
20 lines
661 B
Plaintext
# Client 运行依赖
|
|
#
|
|
# 安装方法(在 client 目录下执行):
|
|
# C:/Python310/python.exe -m pip install -r requirements.txt
|
|
#
|
|
# 版本必须固定,不要改成不带 == 的写法(发布门禁要求,见 docs/client/06-quality-security.md §10)。
|
|
# 如果 pip 报"找不到该版本",处理办法见 docs/client/00-getting-started.md §2。
|
|
#
|
|
# 只支持 PyQt5。禁止安装 PyQt6 / PySide2 / PySide6,会和 PyQt-Fluent-Widgets 冲突。
|
|
|
|
# 界面
|
|
PyQt5==5.15.11
|
|
PyQt-Fluent-Widgets==1.11.3
|
|
|
|
# 安卓自动化
|
|
uiautomator2==3.2.5
|
|
|
|
# 后续接入 Admin HTTP 接口时再放开(当前只用 Mock,不需要装):
|
|
# requests==2.32.3
|