v1.7.2 · AI 整理推倒重做（终端对话式）

Changed

• AI 整理推倒重做（v2）：废弃后台 headless 跑 claude -p 的弹窗式三段流程（报错黑盒、干等一两分钟、一锤子提案不可用），改为一键在内嵌终端拉起交互式 Claude Code / Codex 对话整理。FanBox 负责备料——把整理偏好、最近整理历史、工作约定写成 ~/.fanbox/organize-brief.md，agent 读完先摊方案、用户在终端对话里确认调整后才动手；每批移动照旧写 ~/.fanbox/organize-log/ 回滚日志（撤销在对话里说一声即可）；删除提议须逐条点头、进废纸篓不直接 rm；收尾把这次学到的用户偏好沉淀进 ~/.fanbox/organize-prefs.md，越用越懂你

Fixed

• 终端按钮在激活态「隐身」：两条 CSS 规则打架，激活时文字/图标被改回强调色、和强调色背景同色——删掉遗留的覆盖规则
• 侧栏滚动时灵时卡：整栏被设为窗口拖拽区（#6），而 Electron 拖拽区收不到滚轮事件，鼠标停在标题/缝隙上就滚不动——回退侧栏整体拖窗，拖窗用品牌区和顶栏

v1.7.1 · 终端体验三修

Added

• 终端里的 http(s) 链接可直接点击，在系统浏览器打开

Fixed

• 终端路径识别改为「宽进严出」：凡含斜杠的 token 都收为候选（.claude/skills/… 点开头路径、写作/01-xx 中文相对路径从此都能点），先 stat 验证、验证得到才划下划线（含行尾空格扩展，结果按会话目录缓存）——中文散文里的「分发/产品演示——……」不再整句被当成可点路径；验证接口不可用时宁可不划线
• 完成提醒误报：agent 只是阶段性收工、底部还挂着后台任务（「1 shell, 1 monitor still running」等）时，不再弹「任务完成」通知和提示音——圆点照常变空闲，等后台任务跑完、agent 真正收工再报

v1.7.0 · AI 整理 / English support / 定名 FanBox

Added

• AI 整理（#2）：「AI 提案、人批准、FanBox 执行」三段式——AI 只看元数据出建议（不读内容不碰文件），每条建议带理由逐条勾选，执行写回滚日志、一键整体撤销（日志留 30 天）。引擎可选 Claude Code / Codex，整理策略提示词可编辑可恢复默认。入口：空白处/文件夹右键「AI 整理…」
• 英文支持（i18n）：默认跟随系统语言，侧栏左下角可手动切换并记住。集中式翻译层（326 词条 + 73 条插值规则），界面、菜单、系统对话框全覆盖；文件名、预览正文、编辑器、终端等用户内容不受影响
• 空白处右键弹「新建文件夹 / 新建文件」菜单（#7），双击入口保留
• 按住侧栏空白可拖动窗口（#6）

Changed

• 产品正式定名 FanBox，去掉「翻箱」中文名：应用名、菜单、品牌区、dmg 文件名统一（安装新版后请手动删除旧的「翻箱 FanBox.app」）
• README 改为中英双语单文件
• 自动更新检测提频：周期 12 小时 → 2 小时，窗口重新聚焦补查一次（30 分钟节流）——发版当天老版本不再要等满周期才知道有新版

⚠️ 本版起应用更名为 FanBox（原「翻箱 FanBox」）。安装后请手动删除 /Applications 里旧的「翻箱 FanBox.app」，避免两个版本并存。

v1.6.0 · 项目记忆 / 截图直通车 / 发版向导

Added

• 截图直通车：监听系统截屏落盘（识别截屏命名习惯），新截图右下角浮出直通卡——「→ 终端」喂给 agent、「收进素材」移入当前文件夹 素材/、「标注」圈重点再发，不理它 45 秒自己走。从此告别 NSIRD 临时路径拖拽
• 发版向导：node 项目的状态条出现「发版」——版本号（预填 patch+1）、发布说明（预填 CHANGELOG 的 Unreleased 段）、打包/推送/GitHub Release 可勾选，确认后整条命令序列在内嵌终端开跑，每步可见可拦
• 项目记忆：状态条「项目记忆」打开当前文件夹的 agent 会话考古——历史会话列表（首条消息当标题）、每次会话改过的文件（点击直达）、触发过的 skill，「▶ 续上」一键在内嵌终端 claude --resume / codex resume 接上当时的上下文。数据源本地会话日志，按文件 (size, mtime) 缓存增量解析
• 底部状态条：文件区底缘小字常驻当前文件夹基础信息（N 项 · 文件夹/文件数 · 文件合计大小）
• 磁盘占用透视：状态条「占用透视」/ 右键文件夹进入，du 口径的真实占用条形榜，目录可下钻、可回上级，解「电脑空间又满了」
• 压缩包预览（#3）：zip/jar/tar/tgz/gz 在预览面板列出内容清单和单项大小，全用系统自带工具（unzip/bsdtar/gzip），保持零依赖
• 透明图棋盘格（#1）：缩略图、预览大图、灯箱给图片垫棋盘格底，白色/透明 PNG 一眼可辨

Fixed

• 透明 PNG/GIF/WebP 缩略图被拍成白底：sips 一律出 jpeg 丢了透明通道，带透明可能的格式改出 png

v1.5.2 · 顶栏防挤压

Changed

• 顶栏防挤压整修：右侧操作区不再参与收缩（挤压压力交给可滚动的面包屑），图标在任何宽度下不变形
• 「变更」「最近」改为纯图标按钮（悬停有提示）；「变更」数字徽标改成小圆点，有变更才亮，不再频繁跳数
• 「终端」按钮强调色突出：强调色描边 + 浅底，悬停/激活整体填充
• 顶栏窄时分级隐藏低频控件（缩略图大小 → 隐藏文件开关 → 视图切换/「最近」→ 排序），用 ResizeObserver 观测顶栏自身宽度而非视口——侧栏占宽且可折叠，按视口算会把最重要的终端按钮先裁掉

v1.5.1 · 限额显示与废纸篓修复

Fixed

• 打包版 Claude Code 官方限额（5h 窗口 / 周配额）一直不显示：App 从 Finder/Dock 启动时没有 shell 的代理环境变量，内置 curl 直连 api.anthropic.com 被 403 地域拦截。现在没有代理变量时自动读 macOS 系统代理（scutil --proxy，Clash 等都会写入）兜底
• macOS 移入废纸篓必败（含 Skills 面板的卸载）：AppleScript 的 POSIX file 缺 as alias 强转，Finder 报 -1728

Changed

• Agent 用量面板的 Claude Code 区块：限额进度条优先展示，三格本地 token 用量（近5h / 今日 / 本周）完整保留在下方，不再压缩成一行小字

v1.5.0 · Skills 透视

Added

「Skills 透视」面板（侧栏左下角入口）：本机所有 agent skills 的统一视图——谁在干活、谁在吃灰、谁在静默失效。

• 聚合五类来源：~/.claude/skills、最近 agent 项目的 .claude/skills、Claude 插件、~/.codex/skills、~/.agents/skills，跨端同名 skill 标「N 处副本」
• 触发统计：解析 Claude Code 会话日志（模型自动触发 + 用户手动 / 调用）和 Codex rollout（按会话去重），45 天触发次数 + 最后触发时间，一眼分出活跃和吃灰
• 健康检查：description 超 1536 字符截断线（后段触发词模型看不见）、缺 frontmatter、缺 SKILL.md、zip 等残留物，红黄绿标注 + 「仅看问题」过滤
• Context 预算条：全局常驻的描述总量 vs 预算估算线，超限红色警示（超出部分会被静默丢弃）
• 启停开关：停用 = 移入 _disabled/ 子目录（立即对模型不可见、不删文件、可逆）。不用官方 skillOverrides——该配置在用户级有已知失效 bug（claude-code#50631）。软链接型 skill 先解析绝对目标再迁移，避免相对链接断链
• ▶ 终端调用 + 拖拽：skill 行拖进内嵌终端（或点详情按钮），按会话里跑的 agent 自动注入 /skill-name（Claude Code）或 $skill-name（Codex）
• 卸载：移到系统废纸篓，随时可恢复

v1.4.3

Added

• 侧栏目录树：快速入口、收藏的文件夹项带展开箭头，逐级懒加载子文件夹（只列文件夹），点行仍是跳转
• 侧栏「Agent 项目」：替代原「最近打开」，自动扫 Claude Code / Codex 本机会话日志，列出最近 30 天被 coding agent 处理过的项目文件夹（agent 圆点 + 活跃时间），点击直达项目目录

Changed

• 网格缩略图三档整体缩小约 30%（列宽 96/140/190 → 68/98/132），同屏可见文件数翻倍
• Agent 用量面板的 Claude Code 改为官方限额口径：从 Keychain 读 Claude Code 的 OAuth 凭证查官方接口，显示和 /usage 同源的「5h 窗口 / 周配额」百分比与重置时间；本地 token 统计降为辅注，拿不到官方数据时自动回退。该请求是翻箱唯一出网请求，只发往 api.anthropic.com（经系统 curl，自动继承代理环境）

Fixed

• Agent 用量面板展开后收不起来：样式表缺通用 .hidden 规则，折叠类不生效
• Codex 用量严重失真：读的是上次会话的限额快照，窗口重置后旧百分比仍在显示——快照过了重置时间即归零并标注「窗口已重置」
• 桌面 app 暖色皮肤丢失文件区纸纹纹理：浏览器版纹理从 body 透出，桌面版被 vibrancy 配套的不透明底色盖住，单独补回

v1.4.2

Added

• 侧栏底部「Agent 用量」面板：读本机会话日志展示 Claude Code（近5h/今日/本周 token）与 Codex（5h 窗口、周配额官方百分比 + 重置时间），不用开着两个 CLI 也能看；可开合、开着时每分钟自动刷新
• 菜单「检查更新…」：手动检查新版本，结果用系统对话框反馈（发现新版/已最新/检查失败）
• 文件区空白处双击弹出「新建文件夹/新建文件」菜单

Changed

• Claude Code / Codex 启动按钮行为统一：当前标签是空闲 shell 就地启动，正跑着任务（含已开启的 agent）则新开标签，不再往运行中的程序里打字
• 移除文件区顶部工具行（快速筛选框、文件计数、新建按钮），文件区上下空间更紧凑
• 滚动条改为细圆角胶囊样式（带透明边距），hover 色跟随主题，不再是写死的深色粗条

Fixed

• 终端标签的中文目录名显示为 \xe8\xa7\x86 转义乱码、双击定位失效：GUI 启动的 app 没有 UTF-8 locale，lsof 把中文按字节转义——调 lsof 时显式给 locale 并加解码兜底
• 自动更新检测失效：GitHub API 在代理共享出口 IP 下经常被限流（403）后静默放弃 12 小时——失败时退回解析 releases 页重定向（不占 API 配额），并 10 分钟后重试；渲染层启动时主动补拉一次，不再因为加载慢错过主进程的推送

翻箱 FanBox v1.4.1

终端区一轮体验修复，外加一处安全加固。装新版后才有后续的更新提醒。

终端体验

• 启动不再窄成 80 列：冷启动恢复终端后，内嵌终端的真实列宽会立刻对齐窗口，不用再手动拖窗口
• 「任务完成」提醒不再乱响：打字、界面重绘不再被误判成 agent 干活；停在「等你确认」的界面会单独提示「等待你确认」，和真完成区分开；agent 思考间隙也不会误报收工
• 中文输入法切换不再双写：composition 中按 CapsLock 切中英，不再落下「yao dayaoda」这种重复（采上游官方修复）
• 多项目认得清：终端标签标题实时跟随它所在目录，图标按项目染身份色，面包屑有同色配对点；双击标签即把文件区跳到该终端目录
• 一键 Claude：终端工具栏的 Claude 图标改为「新开一个标签」并以 claude --dangerously-skip-permissions 启动，不打扰当前会话
• 滚动不再偶发卡住：切回标签或滚轮到底时自动修复，不用再靠调整大小恢复
• 点终端里的文件名更稳：找不到时会回扫终端历史，定位 agent 早前打印过的完整路径，跨项目也能开对

安全

• POST 写接口（写文件 / 重命名 / 移废纸篓 / 用 App 打开）新增 Origin 校验，挡住恶意网页借本机服务偷改文件的 CSRF

---

🤖 自动化验收 16 项断言全过（Playwright 驱动真 Electron）