// dev-logs
记录每日 AI 开发进程与项目迭代。内容由本地脚本自动扫描各项目的开发日志同步而来， 涵盖跨境电商质检小程序、飞书多维表同步工具等实战项目。
共 25 条记录 · 最近更新 2026-07-10
需求描述 v4.1.3修复后API下载仍报错"[WinError 3] 系统找不到指定的路径: ''"，且任务编辑面板中看不到保存路径选择入口。深入排查发现两个关键bug： 1. 保存路径控件和文件命名设置LabelFrame都grid在row=6，后者覆盖了前者的显示位置 2. save_path为空字符串时task.get("save_path", DEFAULT_SAVE_PATH)返回空字
需求描述 v4.1.2修复了凭据加载问题后，运行API方式任务仍报错"不支持的报表类型: FBA补货建议"。深入排查发现3个关键bug： 1. report_type保存的是中文名"FBA补货建议"，但API下载器期望的是report_id"fba_replenishment_advice" 2. "ERP账号"标签不随导出方式变化，API方式仍显示"ERP账号"而非"API凭据" 3. API方
需求描述 运行API方式下载任务时报错"API凭据未配置（缺少app_id或app_secret）"。根因是任务编辑界面的凭据下拉框只加载 platform="lingxing" 的网页凭据，领星API凭据（platform="lingxing_api"）根本不会出现在下拉框中。用户选择"API方式"导出时只能选到网页凭据，执行器从网页凭据中读取 app_id/app_secret 必然为空。AP
需求描述 Task 5+6 数据一致性验证：同一时间点分别用领星API方式和网页自动化方式下载"补货建议"和"本地库存"两个报表，对比字段标题（列名）和核心数据值。首次对比发现字段映射表（v2.0）中大量API字段名对应的Excel列名与网页版实际导出的Excel列名不一致，需根据网页版实际列名修正字段映射表，确保API下载的报表字段标题与网页自动化/人工导出的完全一致。 验证方法 1. API阶
需求描述 1. 领星ERP报表下载方式升级：原有下载依赖Playwright网页自动化，速度慢、资源占用高、字段选择受限。领星开放API提供更高效、更稳定的数据获取方式，且支持客户端自定义字段选择和排序 2. 【关键补全】网页自动化下载后写入飞书：当前ERP报表任务编辑界面虽有"导出后自动写入飞书多维表"勾选框和"目标凭据"下拉框，但执行器 _write_to_feishu 方法只是占位代码（在e
需求描述 凭据管理里的账号、多维表Token实际的文字内容没有随列宽变化而变化。 根因分析 refresh_credentials 方法在填充 account 和 table_token 列时，使用了固定字符数截断： app_id[:15] + "..." — 固定截前15字符 table_token[:15] + "..." — 固定截前15字符 api_key[:15] + "..." — 固
需求描述 1. 窗口位置持久化未完全实现：拖动窗口到不同位置并关闭后，重新打开大部分时候固定出现在中间略下位置，底部被任务栏遮挡 2. 需要一份含软件界面图片的软件介绍文档，用于放到个人网站作为项目展示 根因分析（窗口位置问题） v4.0.16的窗口位置管理存在三个问题： 1. 任务栏高度假设不准确：硬编码 taskbar_h=48，但实际任务栏高度可能为40~56px不等（取决于用户设置），导致
需求描述 软件每次启动时需要从最后一次关闭时的位置启动；默认启动位置需要在1920×1080分辨率下严格居中——左右居中（软件最左侧与最右侧距屏幕边缘像素相等）、上下居中（减去任务栏高度后，距屏幕最上面与最下面距离相等）。 根因分析 v4.0.9的默认位置计算存在两个问题： 1. 垂直居中偏差：sh = sh_full - taskbar_h - safe_margin 多扣了20px安全间距，且
需求描述 ERP报表导出板块需要增加右键菜单，与"数据同步任务"板块的右键菜单一致。 改动文件清单 | 文件 | 改动内容 | |------|----------| | tabs/erp_report_tab.py | Treeview绑定 <Button-3> 右键事件；创建 context_menu（▶ 执行 / ✏ 编辑 / 🗑 删除 三项+分隔符）；新增 _show_context_m
需求描述 1. 当前看不到右侧边缘了，整体宽度排版请再略微缩减几个像素，参考左侧列字段距离容器左侧的宽度 2. ERP保存路径列路径信息显示有问题（前面用…了），需改为向左对齐，右侧无法显示的区域改为…显示 3. 执行日志板块来源选择列表只有"ERP导出"，实际日志明细包含"ERP导出"、"领星ERP"两种来源，需优化 根因分析 1. 右侧看不到边缘：v4.0.13列宽总和815px，实测Tree
需求描述 1. 几个板块右边还是有一小片空白区域，需准确分析容器宽度与列宽总和，务必确保两边不留空白 2. ERP报表导出板块增加"保存路径"字段显示，减小任务名称列的宽度 根因分析 v4.0.12基于估算将列宽总和设为760px，但实际通过Tkinter实测（855px主窗口下Treeview.winfo_width()）发现： 主窗口855px → Notebook 855px → tab_p
需求描述 1. 每个板块每列的默认列宽总和需贴近容器边缘，不能留出一大片空白区域让用户拉 2. 平台、类型、同步模式、运行模式、状态、报表类型、导出方式、周期等固定文字列宽度设置适当即可（基于系统内置固定文字宽度） 3. 其他支持用户输入的列宽适当分配调大一些 4. 最终保证每个板块所有字段列宽总和贴近容器宽度，左右两边不留空白 5. 右上角"授权信息"按钮文字修改为"软件激活" 设计分析 主窗口
需求描述 1. 数据同步任务板块的状态列默认宽度无法正常显示"就绪"文字 2. ERP报表导出各个默认列宽相当离谱，默认只能显示两列的样子 3. 虽然可以人工拖动修改列宽并保存，但新用户第一眼看到列宽显示不正常会觉得产品很次 4. 要求深入分析根因，调用UI设计技能彻底解决 根因分析 经检查 config/ui_layout.json，发现保存了用户拖动产生的不合理窄值： sync_tasks.s
需求描述 1. ERP编辑窗体右侧白色区域依旧存在，需分析根因并修复 2. tooltip对路径类信息不能完整显示，需加大最大宽度 3. 同步任务、ERP导出任务执行后需保持勾选状态 4. 每次运行程序时ERP任务状态恢复"就绪"（当前仍显示上次运行的"完成"/"失败"） 5. 数据同步任务status列默认宽度与同步模式/运行模式一致，folder列默认宽度调小 根因分析 1. ERP窗体底色不
需求描述 1. 凭据管理、数据同步任务、ERP报表导出等所有列表区域设计固定宽度规则，长文本列超出显示省略，增加鼠标悬停显示全部信息 2. 支持人工拖动列宽调整，关闭软件时自动保存列宽和窗口位置，下次打开恢复 3. ERP报表任务状态：就绪黑色、运行中蓝色、完成绿色（与数据同步任务一致） 4. ERP编辑导出任务窗体右侧白色底色与左侧灰色不统一，缩减窗体宽度至灰底区域 改动文件清单 | 文件 |
需求描述 1. 数据同步任务状态列显示较窄，"执行中"文字可能显示不全，需调宽 2. ERP报表导出任务执行中标蓝色，与数据同步任务颜色状态一致 3. ERP执行完成后的弹窗增加"打开下载文件夹"按钮，打开对应任务的报表保存文件夹路径；多任务同时执行时只打开第一个成功任务的路径 4. 调整"编辑导出任务"各按钮、选择框元素排版，相同元素位置排版清晰整体统一 改动文件清单 | 文件 | 改动内容 |
需求描述 用户反馈所有弹窗在点击打开时都会在屏幕左上角闪烁一下，然后再移动到屏幕中间，影响体验。 根因分析 tk.Toplevel 创建时窗口立即在默认位置(0,0)左上角显示，随后 update_idletasks() 触发渲染让窗口在左上角可见，最后 geometry() 才将窗口移动到屏幕中间——用户就看到"左上角闪烁一下再移动"的现象。 修复方案 创建 Toplevel 后立即 withd
需求描述 用户反馈 v4.0.5 的 UI 按钮宽度修复仍未到位，存在三个具体问题： 1. 凭据管理按钮太宽，"断开全部链接"超出默认主窗体宽度 2. ERP报表导出"编辑导出任务"窗口无法完整显示"导出名称管理"按钮 3. 导出名称管理弹窗"关闭"按钮被砍一半，灰色背景色与前景白色不统一 根因深度分析 | 根因 | 说明 | 教训 | |------|------|------| | 只见树木不
需求描述 用户要求加一条高优先级用户级规则：所有项目涉及UI界面改动时，必须检查按钮、框体是否能正常显示，桌面端以1920*1080分辨率调试为主。并全面检查当前项目代码进行UI优化。 改动文件清单 | 文件 | 改动内容 | |------|----------| | tabs/sync_tasks_tab.py | 浏览文件夹(8→12)、4个配对按钮(8→10)、执行选中(12→14)、停止
需求描述 设计新方案支持导出名称的修改、删除，UI按钮控件做调整美化。 改动文件清单 | 文件 | 改动内容 | |------|----------| | tabs/erp_report_tab.py | 新增 _show_export_name_manager() 管理弹窗；新增 _save_export_name()、_delete_export_name()、_update_export_
从云端项目对话打包产物下载至本地 D:\AI Project Files\qc-miniapp 读取并理解全部 44 个文件内容（9页面 + 2组件 + 3工具 + 5云函数 + 配置文件） 项目为 uni-app + Vue 3 微信小程序，面向跨境电商质检场景 微信 AppID: wx623ade24ed95155a
需求描述 v4.0.2 的字段指纹对比验证逻辑误判：页面实际已切换但指纹对比判断为未刷新，导致重试和强制触发change。 根因分析 _get_field_fingerprint() 用 .el-checkbox, .vxe-checkbox 搜索整个 .el-dialog，采集到非字段区复选框（隐藏0库存、包含表头等），这些选项不变导致指纹相同误判。 改动文件清单 | 文件 | 改动内容 | |
需求描述 1. 数据同步任务支持多选勾选执行，重新设计GUI界面按钮排版 2. 修复ERP报表导出"补货建议报表"类型BUG：选择"补货_飞书导出ASIN"时实际下载字段被"test导出名称"模板覆盖 改动文件清单 | 文件 | 改动内容 | |------|----------| | tabs/sync_tasks_tab.py | 新增多选复选框列、表头全选、三按钮方案(新建+执行选中+停止)
需求描述 1. 运行飞书数据同步任务时闪退（NaTType does not support strftime）和 URLFieldConvFail 错误码1254068 2. 按飞书官方文档通用错误码优化日志 3. 优化日志分隔：同一任务不同文件间明显分隔，不同任务间更明显分隔 改动文件清单 | 文件 | 改动内容 | |------|----------| | core/executor.py
历史开发日志已归档至 docs/archive/ 目录，包含： UPDATE_LOG_v2.1.5.md ~ UPDATE_LOG_v2.1.11.md：v2.1系列更新日志 gui_bug_fix_plan_v2.1.5.md ~ gui_bug_fix_plan_v2.1.7.md：GUI bug修复计划 gui_optimization_plan_v2.1.8.md：GUI优化计划 gui_