v1.9.0 代码质量与交互优化

代码质量与交互优化

去冗余与静态检查

• 三后端统一失败报告（fail()）；项目路径助手 _project_dir；前端 projUrl 助手（32 处 URL 拼接归一）
• 移除未使用导入/变量；pyproject.toml 固化 ruff 质量规则，ruff check src tests 全绿

交互优化

• 概览「合规与维护」改为折叠块（默认收起 + 状态徽标「合规 ✓ / 待整改 N 项」）
• 终端类型按项目记忆；返回 AI 栏目时状态正确显示「已连接」；抽屉全屏切换自动重适配终端尺寸

修复

• 设置保存不再把默认菜单冻结成快照（仅保存与默认不同的自定义模板）；「AI 日志」不再强制锁定为独立栏目

质量

• 全量 230 个测试通过，覆盖率 80.50%（门槛 80%）

v1.3.1

• 技术栈文档（TECHSTACK.md）：软件项目新增「技术栈」Tab，解析项目根目录 TECHSTACK.md 的概览表格与核心功能小节（实现逻辑/技术手段）卡片展示，支持在线编辑、模板生成与「AI 撰写」一键下发
• 新软件项目预设自动生成 TECHSTACK.md 模板；合规检查新增必需项与 create_techstack 一键修复；CLI 新增 techstack 子命令（--init/--force）
• 内置 agent 教学：系统提示词与项目契约新增 TECHSTACK.md 撰写规范（通读源码→归纳概览+核心功能，只写真实内容）；软件类快捷指令新增「撰写/更新技术栈」
• 已为本地 7 个真实软件项目现场撰写 TECHSTACK.md（番茄钟/浮窗工具/座位表排列/webp转pdf/AgentFloat/GinyScreen/ProjectDock）
• 测试 160 个通过，覆盖率 83.32%（门槛 80%）

ProjectDock v1.3.0

ProjectDock v1.3.0

🛠 修复：安装图标未生效

• 根因：build_setup.py 重新构建 release exe 时未传 --icon，Setup 安装包内的 exe 一直使用 PyInstaller 默认图标
• 已补全 --icon，安装后程序 / 快捷方式图标为新「版本卡片」；已重建安装包并替换本机安装

💬 总控台 AI 助手对话

• 总控台新增「AI 助手对话」卡片：下拉切换任意项目的 agent、切换 AI 后端、清空记录
• 每项目独立会话历史，切换项目不串消息

🎯 Agent grill 选择 UI

• agent 需要用户拍板时在回复中输出 pdchoice JSON 卡片，前端渲染为可点击选项
• 点击选项自动把选择结果发回 agent 继续任务，无需复制粘贴

🧠 会话历史上下文

• /api/agent/run 支持 history，自动携带最近 12 轮对话作为前情提要
• 多轮追问 / 确认 / 决策可无缝延续

📊 批量下指令实时进度

• 逐项目显示运行状态条 + 可展开的流式输出，像 AI 管理菜单一样实时回显

⛶ 全屏对话（软件内）

• 抽屉右上角 ⤢ 一键全屏展开整个抽屉
• 总控台对话卡片 ⤢ 全屏占据主工作区，自动隐藏侧栏 / 工具栏

🧪 质量

• 151 个测试通过，覆盖率 83.45%（门槛 80%）

📦 安装包

• ProjectDock_Setup_v1.3.0.exe（自动更新链路将下载此安装包并静默升级）

ProjectDock v1.2.0

ProjectDock v1.2.0

✨ 全新极简图标

• 以「版本卡片」为创意：靛紫渐变 + 三张错位卡片叠放，构图整体左上微调
• 全套替换：exe 程序图标 / Setup 安装包图标 / 侧栏 logo

🐙 GitHub 仓库管理

• README 正确渲染：表格 / 列表 / 引用块 / 徽章链接 / 相对图片（自动修正为 raw 地址）/ 内嵌 HTML（白名单过滤防 XSS）
• README 与仓库信息跟随实际默认分支（default_branch）

💬 AI 输入坞

• 输入栏悬浮于面板下 1/3 毛玻璃浮层，消息区独立滚动
• 快捷指令按项目类型分类折叠（Git 与版本 / 构建与发布 / 文档 / 质量 / AI 协作），随类型切换

🏠 首页展示

• 图格 / 列表视图切换
• 排序方式：置顶优先 / 最近更新 / 创建时间 / 名称 / 类型
• 置顶项目独立「📌 置顶」分区展示，偏好本地持久化

🧪 质量

• 149 个测试通过，覆盖率 83.32%（门槛 80%）
• headless Chrome E2E 19/19，0 JS 错误

📦 安装包

• ProjectDock_Setup_v1.2.0.exe（自动更新链路将下载此安装包并静默升级）

ProjectDock v1.1.0

ProjectDock v1.1.0

GitHub 远程仓库管理 + 项目信息编辑 + AI 菜单升级 + 日志增强

新增

• 🐙 GitHub 远程仓库管理：设置内登录 GitHub（优先 gh 命令行，或粘贴 PAT 令牌）；软件/网站等类型新增「GitHub 仓库」Tab，内嵌查看远程仓库信息、README（自动渲染并修正相对图片）、最近提交、发行版；支持一键创建仓库并推送、手动设置 origin、在浏览器打开仓库
• ✏️ 项目信息编辑：概览页「编辑信息」，可随时修改项目名称（自动重命名文件夹并保留编号前缀）、类型、描述；置顶/图标状态保留
• 💬 AI 悬浮输入坞：输入栏悬浮于面板下 1/3 位置的毛玻璃浮层，内置 10 条软件类 / 5 条文稿类快捷指令，点击一键填入
• 📋 AI 日志增强：日志条目显示来源（应用内/外部 Agent）、备份、Git 变更明细（HEAD/分支/变更数），详情可展开；总控台活动列表每条带项目名标签，点击直达项目

质量

• 测试 149 个通过，覆盖率 83.36%（门槛 80%）
• headless Chrome E2E 9/9 通过，0 JS 错误
• Setup 静默安装冒烟通过：health=1.1.0、GitHub 登录态、前端加载正常

安装

下载 ProjectDock_Setup_v1.1.0.exe 安装即可（%LOCALAPPDATA%\Programs\ProjectDock，无需管理员）。
已有 v1.0.x 用户：软件内「设置 → 软件更新」会自动检查并下载本安装包。

ProjectDock v1.0.0 正式版

ProjectDock v1.0.0 正式版

本地项目文件管理器 · iOS 风格 UI · AI 项目文件夹管理

新增

• 项目置顶：卡片 📌 一键置顶/取消，置顶项目排序优先并高亮边框，概览页同步操作，状态持久化
• 图标生成管线：按类型渐变配色 + 12 种几何符号一键生成 iOS 风图标；也支持上传自定义 PNG/JPEG/WebP/GIF（≤8MB）
• 全量合规化：本地软件项目完成 README / VERSION / CHANGELOG / git init / 构建产物归档，重复构建仅保留归档副本
• 详细美观 README：徽章头部、特性总览、安装 / 快速上手 / AI 协作 / 管理规范 / FAQ，配真实主界面截图
• 自动更新链路正式激活：GitHub Releases 检查 → Setup 下载 → 静默安装

修复（自 v0.5.1 累积）

• 并发 500（SQLite 跨线程）导致首次打开版本读取失败、GinyVoC/ProjectDock 构建产物读不出来
• AI agent 只介绍项目不执行任务：管理上下文经 --append-system-prompt 注入 + 「直接执行」指令
• 切换项目偶发显示别的项目信息：抽屉序号守卫丢弃过期响应
• 版本构建 Tab 分段折叠（默认折叠）+ 全部展开/折叠 + 动画
• 产物列表去重（同版本 dist/installer、根 installer/build 同名同大小只列一次）

质量

• 测试 140 个通过，覆盖率 86.80%（门槛 80%）
• headless Chrome E2E 14 项全过，0 JS 错误
• Setup 静默安装冒烟通过：health=1.0.0、更新检查正常、前端加载正常

安装

下载 ProjectDock_Setup_v1.0.0.exe 安装即可（安装到 %LOCALAPPDATA%\Programs\ProjectDock，无需管理员）。
已有 v0.5.x 用户：软件内「设置 → 软件更新」会自动检查并下载本安装包。

v0.5.1

v0.5.1 更新内容（并发修复 + AI 上下文注入 + 版本折叠 + 产物去重）

修复

• 首次打开项目偶发「版本信息读取失败」：SQLite 连接跨线程共用导致随机 500，全部 DB 操作加全局锁串行化
• GinyVoC / ProjectDock 版本构建读不出产物：同根因（并发 500），修复后产物正常渲染，并做同名同大小去重
• AI agent 布置任务后只介绍项目不执行：管理上下文改经 --append-system-prompt 注入系统提示词，消息只留用户任务 + 「直接执行」指令
• 切换项目偶发显示别的项目信息：抽屉序号守卫，旧请求响应直接丢弃

Added

• 版本与构建 Tab 分段折叠（当前版本/更新日志/构建产物/构建脚本），默认折叠 + 全部展开/折叠 + 动画
• 版本信息加载失败显示「重新加载」按钮
• 新增《管理逻辑与 AI 协作报告》03_管理逻辑与AI协作报告.md

质量

• 测试 137 个通过，覆盖率 85.45%（门槛 80%）

安装包

• ProjectDock_Setup_v0.5.1.exe（本 Release 资产，自动更新将下载此安装包）

v0.5.0

v0.5.0 更新内容（图标 + 备份管理 + AI 对话升级 + 产物扫描归档）

Added

• 全新 iOS 风格图标：蓝靛紫渐变圆角方块 + 玻璃高光 + Dock 托盘 + 4 枚彩色应用块；接入 debug/exe 构建、Setup 安装包与 Web favicon/侧栏
• 备份管理面板（每个项目概览页）：立即备份 / 备份列表 / 一键恢复（恢复前自动再备份）/ 删除备份；备份存 versions/backups/
• AI 对话 Markdown 渲染 + agent 活动状态条（正在思考/备份/调 CLI/汇总）+ 文本可选中复制 + 回复一键复制
• AI 任务解读：明确「整理版本归档 ≠ 改 CHANGELOG」，只有明确要求发布才走完整发布流程
• 构建产物扫描升级：识别 dist/installer/build 与 versions/*/dist|installer，合规一键归档带版本号产物，重复文件保留原地不删除
• 数据操作：本地 7 个软件项目全部合规化并归档散落产物

修复

• 切换项目不再弹出控制台（subprocess 补 creationflags）；抽屉序号守卫，旧项目结果不再覆盖新项目显示
• AI 日志同秒排序；config APP_VERSION 与 VERSION 同步；update/github/contract 缺失 os 导入导致更新检查 500

质量

• 测试 135 个通过，覆盖率 84.88%（门槛 80%）

安装包

• ProjectDock_Setup_v0.5.0.exe（本 Release 资产，自动更新将下载此安装包）

v0.4.0

v0.4.0 更新内容（自动更新 + Setup 安装包）

Added

• 自动更新链路：检查 GitHub Releases -> 下载 Setup 安装包 -> 静默安装，全链路打通
• 设置面板新增「软件更新」：显示当前版本、一键检查更新、发现新版本展示更新说明并下载安装；启动时自动静默检查并提示
• 更新仓库可配置（Settings.update_repo，默认 GinyvaXu/ProjectDock）；检查用 gh CLI（含私有仓库），失败回退 GitHub API（带 gh 令牌鉴权）
• 新端点：GET /api/update/check、POST /api/update/download、POST /api/update/install
• Setup 安装包构建：build_setup.py（PyInstaller windowed + Inno Setup 6 编译），安装到 %LOCALAPPDATA%/Programs/ProjectDock（无需管理员），CloseApplications=force 自动关闭旧进程，创建桌面/开始菜单快捷方式，安装后可选择立即运行

修复

• gh release view 不再传字面 "latest" 参数（gh 会把它当 tag 名），改为默认取最新 Release；API 兜底带 gh 令牌，私有仓库也能检查

质量

• 测试 126 个通过，覆盖率 85.30%（门槛 80%）

安装包

• ProjectDock_Setup_v0.4.0.exe（本 Release 资产，自动更新将下载此安装包）