开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 11 条记录。
2026-11-07
安全修复:归档校验放行会删本地、物理删除、远端命令注入三处 P0
- P0 校验放行(会真丢数据):
(v?.remote ?? 0) >= (v?.local ?? 0) / 100 * 99,verify 返回 nil(ssh 超时/路径不存在/无输出)时是0 >= 0判通过;整数除法又让 <100KB 的项阈值恒为 0。配合「传完删本地」,一次超时就能把没传上去的文件删掉。改为 nil 一律判失败,容差max(1%, 4KB)浮点比。 - P0 物理删除:
removeItem+try?不可恢复且失败无声。改trashItem,失败写日志并保留文件。 - P0 命令注入:
remotePathExpr双引号包路径,双引号内$(...)照样展开,目录名填/tmp/$(rm -rf ~)即远端任意命令执行(实测可复现)。改单引号 +"$HOME"/'剩余'。同类三处一并修:rsync 远端目标未转义(含空格会把文件传到别处且不报错)、tar 管道-C "路径"、Windows 校验的 powershell(PS 与远端 shell 两层)。 - P1 管道阻塞:AI 服务拿到密码就拆了 readabilityHandler,Pipe 没人读,输出满 64KB 阻塞在 write(),「AI 用着用着不回话」——与 0.2.2 归档假卡住同病。改为持续读 + 打码 + 2MB 滚动。
- P1 密码入日志:启动横幅
Password cw_xxx落在 644 文件里。改落盘前打码 + chmod 600,历史日志已抹。 - P1 tar 停止无效:sshErr 无人读会死锁,且整段没 track()。改轮询可中断,两个 stderr 都读走。
- 新增
--security-test:六项断言全绿(注入不执行、字面量落盘、空格与单引号、~ 展开、日志打码、日志 600),退出码可进 CI。 - 提交
c3f78d6已推 Gitee。
- P0 校验放行(会真丢数据):
2026-11-03
设计对齐基线 + docs 文档集:tokens.json 数值基准、21 项漂移闸门、五份产品/开发文档
- 背景:mac 与 Windows 版本不一致,先对齐设计再出文档。旧手绘稿(archive/)与实现早已分叉,照它写 Windows 端会错上加错。
- 设计对齐做成可执行的:
design/tokens.jsonv3.0.0 —— 唯一数值基准,从 SwiftUI 源码逐条量出(卡片 18/14、环 172/16、行 7/12、字号 17/13/10、阈值 0.80/0.92),含明暗两套色值与 pt→DIP 换算后的 Windows 建议值(mac 13pt 行标题 ≠ Win 13 DIP,直接抄会小一圈)。tools/design-build/check-tokens.py—— 21 项漂移闸门,令牌 vs 源码字面量逐条比,对不上非零退出。开发中逮到自己 6 处正则锚点写错(lineWidth 抓到卡片描边、胶囊内边距抢了行内边距、阈值抓错分支),说明这闸门有真用。- docs/ 新增五份(531 行):README(阅读顺序 + 与 spec/ 分工)、product.md(四屏规格、判定体系、AI 边界、必须一致/允许不同)、architecture.md(模块接口照源码签名、M0-M6)、design-system.md(Avalonia 明暗主题资源字典可直接粘)、parity-checklist.md(发版前逐条勾)。
- 纠偏一处:mac 实现的 AI 判定是 AIDecision 三值(可以删/可以迁/必须留)+ 待复核徽标(confidence<0.6),规范层六 verdict 是映射关系而非 UI 六标签。
- 提交
8caa272已推 Gitee。Windows 端第一动作仍是StorageMate.Bench复现 PoC 四数字。
设计稿换代:design/index.html 改为 mac 真机稿,手绘旧稿归档
design/index.html换成以真机实拍为准的 mac 稿(原design/mac-v1.html),八张截图暗/亮可切,374 KB 单文件离线可看。- 旧手绘稿移入
design/archive/:v2-handdrawn.html+tokens-v2-handdrawn.json,更早的 v1 备份一并收进去;design 顶层不再有会误导的旧文件。 - 稿内「上一版设计稿」那段原本写着
design/index.html,替换后会指向自己,已改成归档路径。 tools/design-build/build.py输出改为design/index.html;重跑一遍 md5 与替换前一致(365673ef58119a61e232ec7c78a032ee),说明产物可复现,不是手工拼的。- 提交
2709d5c已推 Gitee。
2026-11-02
mac 界面设计稿 v1:以真实实现为准重出,八张真机实拍
- 为什么要重做:
design/index.html+tokens.jsonv2 是按设想手绘的,跟真机已经分叉 —— 颜色写死(纸面 #3B82F6 / #070A0F)而实现全用系统语义色;行高写 48 而实现约 58;窗口写 1216×768 而实现最小 1000×680。而真实版本反而更好用。改为以实现为准重出。 - 怎么做:不给应用截图加任何后门,只加两个自检开关 ——
SnapshotProbe把 windowNumber / 尺寸 / 强制外观写到文件,再用screencapture -l <id>直取窗口图层(比 -R 算坐标稳,窗口被遮挡也截得到)。八张图(4 屏 × 暗/亮)全部无手绘、无补画。 - 踩到的坑:
open -n --args在 macOS 26 只把 argv[0] 传进去,后面全丢(实测 argv 只有一个元素)⇒ 参数改走defaults write;windowResizability默认的 automatic 把窗口上限压到内容理想尺寸(恒 1082×692、拖不动)⇒ 改.contentMinSize;只设window.appearance时标题栏仍是系统色(深色机上截浅色得到一条黑标题栏)⇒NSApp.appearance也得设。 - 产出:
design/mac-v1.html,374 KB 单文件,8 张 webp 内嵌(共 256 KB),离线可看。含四屏实拍(可切暗/亮)、设计令牌(从 SwiftUI 源码量出来的)、六大组件规格、设计→代码对照、Avalonia 移植六处差异、五条已知不足。 - 可复现:
tools/design-build/shot.sh(截图)+build.py(压 webp 内嵌)+mac-v1.template.html(模板)已入库,下一次改稿重跑两条命令就行。 - 顺带两处实现改进:窗口现在可以拉大(原本拖不动);非概览页首次进入会自己扫一次(原本直接进清理页是空列表)。这两条对用户可见,下一个版本(0.2.3)需要带上。
- 为什么要重做:
Windows 端立项依据入库:不用等 MFT,并行 NtQueryDirectoryFile 首扫已达标
- 验证目标:Windows 上能不能不用 MFT,只靠
NtQueryDirectoryFile就把 50 万文件枚举压到 10 秒内。 - 实测
(本机路径)全盘(148~158 万文件,两轮):baseline51.6s(外推 50 万 16.3s,不达标);ntquery单线程 12.1s(4.0s);ntquery-par同层并行 16 线程 5.7s(1.9s);mft顺序扫 2.1s(0.7s)。 - 结论:不用等 MFT。瓶颈是 syscall 数量而非磁盘 I/O ——
FILE_ID_BOTH_DIR_INFORMATION内联 size,省掉 158 万次 per-file stat。首扫走并行NtQueryDirectoryFile,MFT 留给后续增量。 - 踩掉三个坑:① 只有
STATUS_NO_MORE_FILES才算读完,在STATUS_SUCCESS就 break 会让大目录静默漏计数(少 13,624 个文件,零报错);②winioctl.h与 MS-FSCC 对USN_RECORD_V2的定义差 8 字节(少了TimeStamp),照头文件写就整体错位、并报错;③ 三种策略文件数天然不同,junction 重复统计与 WinSxS 硬链接让基线与 MFT 各偏 2~6 万,产品上必须先定义「按目录项还是按 inode」。 - 文档已入库:
spec/windows.md(.NET 8 + Avalonia 11,四层 sln,枚举契约用同步批量回调而非IAsyncEnumerable);spec/decisions/0001-windows-enumerator.md(ADR,含对 PoC 的三处修正 —— 外推偏乐观、增量必须缓存直接子项聚合、USN 不带 size)。ADR 里那句错解释(把TimeStamp说成SecurityId)已在源头改掉,避免后来者照错。 - PoC 代码在
poc/FileScanBench/,后续 Windows 端第一动作是把四个数字在StorageMate.Bench里复现。
- 验证目标:Windows 上能不能不用 MFT,只靠
mac 0.2.2 发版:归档假卡住、清理被拒、聚合项误删整目录三个问题一起修
- 归档假卡住:
Process.standardOutput = Pipe()挂上却没人读,rsync--progress写满 64KB 管道后阻塞在write(),界面永远停在「传输中」。lsof证据:1 PIPE ... 65536。改成统一runRsync,stdout / stderr 两条管道同时读,stderr 只收错误。 - 进度回跳:openrsync 是逐文件报百分比(每传完一个小文件回 100%),改成按
to-chk=剩余/总数与已传字节/总字节算,并强制单调递增;归档中按钮变「停止」,可中途取消。 - 清理失败:
(本机路径)这类目录带 ACLgroup:everyone deny delete,trashItem必报 513 / -5000。改为整体移废纸篓失败就清空内容、保留目录;部分成功不再整体判失败,失败原因逐条写进日志。 - 误删整目录:下载目录的「安装包」聚合项之前拿
(本机路径)本身当路径,trashItem会把整个下载目录送进废纸篓。ScanItem加payload,聚合项只删真实安装包。 - 口径不一致:首屏「可清理」按已勾选统计,跟卡片对不上,改
cleanableSizeText。 - 发版:DMG 1.9 MB,通用二进制(
x86_64 arm64挂载复核过),MD5378603adbb5aa67b613f21463c4ddda1;latest-mac.json与官网下载入口同步 0.2.2,线上回下校验一致。
- 归档假卡住:
2026-10-19
两处体验修复:测试按钮卡死 + 每次编译重弹权限
① 存储目标的「测试」按钮原本同步 SSH 探测,阻塞主线程十几秒看起来像没反应 → 改 Task.detached 异步,行内显示「检测中… → ✓ 连接正常,剩余 206G」。
② 反复弹权限的根因是 ad-hoc 签名的 designated requirement 是 cdhash,每次重编都变,TCC 视为新程序 → build.sh 改为自动匹配 Apple Development 证书,DR 稳定。
结论:本机开发用免费 Apple ID 就够,99 美元账号买的是别人机器上的信任(Developer ID + 公证),分发前再买。
WorkBuddy 基座接入的四个坑(都已定位)
① CLI -p 模式必崩:SetupGalileo → Config.startPull 里 setProxy instanceof 报错,只能走 --serve。
② --version 能跑是假阳性,不代表链路通——曾据此误判「CLI 可用但模型不回应」。
③ 所有请求必须带 x-codebuddy-request: 1,否则 403。
④ ACP 的 initialize SSE 流不能断开,一断就 Server not initialized;session/new 不收 model 字段。
另:⛔ 绝不能设 CODEBUDDY_BASE_URL(三个域名全 405),不设反而成功。
AI 接入收敛为双后端,A+B+C 三种方式全支持
A(主流):用户机器上已装 WorkBuddy → 起 CLI --serve 走 ACP JSON-RPC over SSE,零额外密钥,直接吃用户已有积分。
B(主流):企业网关 → CODEBUDDY_API_KEY=ck_... 走同一套基座,agent 层鉴权免登录。
C(兜底):BYOK 第三方 HTTP(豆包 / DeepSeek / OpenAI / 本地 Ollama)。
代码上把原 .cli 后端整段删掉——它和 acp 功能重复,两套 tab 让用户困惑。
产品核心重申:不做 CleanMyMac 第二,卖的是判断力
传统清理软件把判断写死在代码里(路径白名单 / 大小 / mtime),猜错就误删。
定调:核心是「判断力」,跨机归档只是它执行「迁移」这个决定的方式之一。
因此 AI 不是可选装饰,而是主链路;证据采集必须足够厚,让模型能回答「这个目录是什么、还有没有价值」。
首版跑通:扫描 → 证据 → 判断 → 清理闭环
一天内从零到可运行(4721 行 Swift,Swift Package 直编,不依赖 Xcode 工程)。
链路:ScanEngine 按体积 + mtime 粗筛出真正占地方的几十个目录 → EvidenceCollector 采集目录树、README 摘要、git 最后一次提交、文件类型分布、缓存占比 → AIBridge 交给模型 → 返回 {decision, title, reason, confidence} → 用户拍板。
清理一律走废纸篓,支持「放回原处」还原;AI 只出建议,不执行任何删除动作。