Decision Log — 2026-08-06-10(6-10日)

2026-08-12 从 decision-log.md 按月份拆分（>40KB 维护规则）——内容与原文一致。索引: decision-log

2026-08-10 Vault 清理执行（主人批准）

决定：执行 VAULT_CLEANUP_REPORT.md 全部建议（🔴删除 + 🟡合并 + 🟢归档 + 死链修复）。
依据：974 文件扫描分析（12.9KB 报告）+ 主人明确批准；每步先 read 确认再动。
结果：957 文件/248 目录；删 18 / 合并 4 组 / 移动 28 / 新建 agents/hermes.md 枢纽页 + archive/ + scripts/；5 份索引 283 链接 0 死链。
关键原则：合并保留被索引版（文件 ID 不变，外部引用不断）；归档只移不删；.git/.obsidian 核心配置不动。
遗留：4-5 月 daily 系列整体归档为条件性建议，未执行（如需可再执行）。

Decision Log — Important Decisions & Rationale

Why we chose certain approaches — May 2026

2026-08-10（23:19）: 展示视频用 Windows 版 ffmpeg（winget 已装 8.1），脚本自动探测+路径转换

Decision: 展示视频管线统一用 Windows 版 ffmpeg 8.1（winget 安装，gyan.dev full build，位于 C:\Users\Sozo\AppData\Local\Microsoft\WinGet\Links\）；脚本 make_showcase_video.py 自动探测（PATH → where.exe → WinGet Links → D:\tools\ffmpeg → C:\ffmpeg），并对 Windows exe 自动做路径转换（/mnt/d/... → D:\...；非 /mnt 输入/输出自动临时复制/重定位）。不装 WSL 版（无免密 sudo，apt 不可非交互执行）。

Context: WSL 无 ffmpeg、sudo -n 失败；Windows 侧 winget 早已装好 ffmpeg 8.1。实测 Windows exe 无法打开 /mnt/d/...（Permission denied），必须传 D:\...；/tmp 等非 /mnt 路径同样不可读（临时复制到 /mnt 下解决）。

What changed: 路线图 #2 交付：脚本 + 示例视频（16s 1080p）+ 报告 prime_setup/system-fix/SHOWCASE_VIDEO_REPORT.md；效果与全项验证通过（Ken Burns/转场/淡入淡出/音频/可复现性）。今后”图片→视频”类任务直接复用该脚本与路径转换模式。

2026-08-06（下午）: 多平台视频发布定版 — 小红书/抖音禁 CDP + 先传后发批量策略

Decision: ① 小红书 + 中国版抖音：安全审查高 → 禁止 CDP，只用 computer use（视觉/AX 树）操作；其余平台（YouTube/FB/IG/TikTok/X）CDP 优先、卡关转 computer use（Window MCP 主力 + UI-TARS-7B 兜底）。② 批量发布策略（用户定案）：先把视频上传到所有平台（上传耗时），再逐个填文案/设置，最后统一发布；上传等待期间写文案。③ 文案基于视频真实内容：ffmpeg 提取音频 → whisper base 转写 → 痛点提炼 → 中/英/中英混合三版按平台语言放（抖音/小红书=中文；FB/IG/YouTube=中英；X=英文）。④ 用户带教 computer use 模式：用户逐步指导（文案框 triple click 或 ctrl+a 全选、scroll 滚到用户可见位置、坐标实时获取），明确要求「把经验继承下来」→ 沉淀进 skill。

Context: 用户 15:31 发起 Day 8「马劳装修」视频 7 平台发布（YouTube/FB/IG/TikTok/抖音/小红书/X），先帮 agent 登录所有平台（新增中国版抖音），并问 agent 有没有读视频能力（whisper 确认有，回答用户问题）。实测发布 6/7 成功；抖音点发布后「正在发布」无限转不跳转（从草稿发布会卡死）→ 刷新（Reload site? 确认）+ 重新上传，后台自动监控（D:\hermes\hsdesign_work\douyin_publish_state.json，40 分钟超时）。FB 曾误入 Sozo Design Page（≠ HS Design），用户纠正：右上角头像 → Switch to HS Design。

What changed: Day 8 视频（225MB/2:02「没有空监工但是要装修怎么办？」）7 平台发布：YouTube（Public）/FB（HS Design Page Reel）/X（@Jake_Tzeczia 221/280 字符）/TikTok/IG（9:16，23 posts）/小红书（published=true）确认成功，抖音重传中；实测平台限制：小红书标题≤20字 + hashtag≤5、抖音标题≤30字 + hashtag≤5、IG 桌面版上传后切 9:16；skill multi-platform-publish 全面更新（抖音/小红书流程 + 10 条实战教训）；MultiPlatformPublishing_Graph 更新账号 handles；同场新增顾客 Mr Lee（Kulai，+60 12-771 6623）入 Master 主档行 16 + reminder 8/8 & 8/9 10:00。

2026-08-06（早上）: blog 扩写全自动方案定案 + 子代理批量执行模式（并发 3 / 600s 超时接手）

Decision: 剩余 35 篇薄 blog 全部由 Hermes 子代理并行扩写（不用 Gemini 免费方案）：每批 3 篇（delegate_task 并发上限 3，超出自动排队），统一扩写标准 reference 文件 + 每篇自包含 prompt；子代理只扩写不做别的；600s 超时的由主代理直接接手文件收尾（如 condo-cost：EN 1028 / 中 1319 / BM 1003，结构完整、质量高，接受）。用户拍板理由：DeepSeek 缓存命中率 95-98%，实际成本远低于预估（约 RM10-15），且质量可控、内链/三语结构不丢。

Context: 用户 07:28 问剩余 blog 文案优化怎么做：方案 A = Hermes 全自动（~87 万 token，RM10-15，40 分钟）；方案 B = 写 prompt 打包文件让 Gemini 免费做（多轮往返、质量参差、不懂内链/三语规则）。用户选 A。

What changed: 40/40 blog 扩写完成（EN 700-1546 / 中 668-1780 / BM 469-1077，真实 JB 数据）+ 部署 + 同步 Drive + Indexing API 40/40。经验：子代理超时后文件通常已完成大部分，主代理检查结构（p/div/span 配对）后可直接收尾，不重跑。

Related: 2026-08-06 Website_Architecture

2026-08-06（早上）: Purchase List 集成进工程排期 + 顾客/承包商双版本设计

Decision: ① 集成方式：Purchase List 做进 master app 工程排期模块（新增「购买清单」tab，工种与设置之间），不做独立页面——物品可关联排期工段（水盆→#8 木工「橱柜动工前定款式留孔洞」、灯→#9 电工「石膏做好后买」、卫浴配件→#11「最后才买」）。② audience 双版本：同一界面 filter 选「顾客版/承包商版」，export PDF 按当前版本输出；顾客版无价格栏（用户常叫顾客自己去买、不知道价）、灰字 description 即备注（不另加栏位）；承包商版含价格。大部分 item 属顾客版。③ 照片：有照片显示照片（base64 上传），无照片显示分类 SVG 占位（互相替代，非两个字段）。④ PDF 风格：不自己 reportlab 重排——用 app 现有服务端 HTML→浏览器打印的品牌模板（Garamond/teal/HS 头/@page 页码）。

Context: 用户 07:53 提出 purchase list 想法（水盆/灯/油漆/卫浴配件按工程阶段买）；08:00 补照片 + SVG 占位 + export PDF；09:02 补厨房用具/洁具分类；09:17 补 audience 双版本 + 无价格栏 + 灰字备注；09:23 纠正 agent「不需要重新排版，app 本来就有预览/导出 PDF 功能」→ 改用 app 原模板。分类定案 11 种（灯光/厨房电器/厨房用具/洁具/水盆水槽/油漆/卫浴配件/五金/地板/台面/其他）。

What changed: Prisma PurchaseItem + D1 表（20 tables）+ /api/purchase CRUD + 购买清单 tab + 品牌 PDF route /api/pdf/purchase/[projectId]?audience=；部署 90ab4747 / fe3c7325；HSD00001（proj_10 Kenari High Break Snooker）6 项测试数据。同批新待办：Agreement 合同模板（SG/JB，重保护公司）、Progress Claim 请款模板、工程排期 export PDF（后做，含免责声明）。

2026-08-06（凌晨）: hsdesign.biz 首次访问自动检测浏览器语言（三语自动适配上线）

Decision: hsdesign.biz 主站加「首次访问自动检测浏览器语言」：detectBrowserLang()（navigator.language 以 zh 开头→中文、ms 开头→马来文、其余→英文），初始化为 localStorage.getItem('hsLang') || detectBrowserLang() —— 用户手动选过语言则尊重用户选择（不覆盖）。全站 57 个页面统一（index + portfolio/blog/faq + project 页 + pSEO 页）。

Context: 用户问主站三语能否按顾客习惯自动显示（间接提升成交率）。实测查明：三语（EN/中文/BM）齐全但纯手动按钮切换（localStorage hsLang，URL 不变），服务端不检测 Accept-Language，首次访问一律英文。用户批准加浏览器语言检测。客观边界：浏览器语言 ≠ 国籍/种族（无登录展示站的极限），日后可再加首次弹语言选择。

What changed: index.html 部署 2f0b0161；批量 56 文件加 detectBrowserLang 后部署 82c7cb85；已实测 zh-CN/zh-TW→zh、ms-MY→ms、en/fr→en，CSS html[lang] 切换生效。教训：站点源码真相源 = Drive H:\My Drive\hsdesign-site-source\，改代码必须改 Drive 源（deploy_staging 会被 deploy.sh 先删后复制覆盖）——已记入 skill hs-design-landing + Website_Architecture.md。

2026-08-06（凌晨）: 不换动态网页（静态 SSG 对 organic search 零劣势）+ SEO 内容优化 round 1 + backlink 渠道取舍 + H: 盘失效走 Drive API

Decision: ① 维持静态 SSG，不换 Next.js/React 动态——Googlebot 已能完整渲染 JS，动静对 organic search 基本无差；静态 PageSpeed 反而更高（无 JS 渲染负担）；动态唯一优势 = 省维护，而站点是内容型（博客/项目/报价），build_portfolio.py 改数据源一键重建，维护成本可控。除非「每次改语言/导航要动所有文件」烦到受不了，否则不换。② Blog 图片用现有 project 真实照片，不用 AI 生图（E-E-A-T 信任度；Gemini 生图仅适合示意图）。③ backlink 渠道取舍：Instagram bio ✅ 已挂；YouTube 需用户手动加（Agent API 无权限，用户 2 分钟操作）；TikTok 用户加；小红书不加（平台限流，禁止引流外站——用户明令）；Google Business 已挂 ✅；FB 装修群不加（链接 nofollow + 广告风险）；Reddit r/malaysia / Lowyat 仅真人参与（反 AI 推广严，AI 发帖必封号）；目录站机会 Houzz MY / HomeReno；合作互链候选 Kel Photography、Buildsmart。④ Google Drive 挂载（H: 盘）失效时改用 Drive API 直传回真相源（blog 文件夹 id 11cg0vfuv5LEJnx2jtJtVAu21LD0p_bYv）——子代理自动回退写 D:\hermes\hsdesign_work\ 本地副本，主会话用 API 对比 hash 只传改动文件（40 个），数据零丢失。

Context: 用户问「有必要换动态网页吗？目的是 organic search」（8/5 22:13 主会话）；随后要求全面审计 blog/project 文案质量 + backlink（用已装的 AI SEO audit skill）。审计先误报「40 篇 blog 内链=0」，用户质疑后查明是检测 bug（漏统计 xxx.html 纯相对路径）——实际每篇平均 36 个内链，无需改。执行中 01:02 H: 盘（Google Drive 挂载）失效（GoogleDriveFS.exe 在跑但盘符消失），5 个子代理扩写中途改写本地副本，2 个 600s 超时但实际完成 3 篇；另 2 篇未完成由主会话直接扩写补齐。

What changed: 32 篇 title 压缩 ≤60（品牌后缀「| HS Design JB」）；5 篇薄 blog 三语扩写至每语 700-1100 词（真实 JB 数据：MBJB/MBIP 许可费、RM 成本区间、LPT/CIDB、雨季、50% 定金惯例）；18 project 页 strong→h4（162 处，不动 build_portfolio.py 模板）；40 blog hero 图（342 张真实照片按主题匹配）；sitemap lastmod 92 URL 更新 8/5；Indexing API 推 5 篇扩写（URL_UPDATED 5/5 成功，service account D:\hermes\secrets\hsdesign-seo-service-account.json）；全部改动经 Drive API 同步回真相源 + 线上部署验证通过（部署 2 轮：51 文件 + 40 blog 图/5 扩写）。待办：Follow up 顾客 KK（HomeReno/House & Why 公司文档 + 提升白领）已入 8/6。

2026-08-06（上午-下午）: computer use 视觉方案定版（Window MCP 主力 + UI-TARS-7B 兜底；Qwen2.5-VL 弃用）+ 模板不可擅改规则 + 排期 PDF 必须原生甘特图

Decision: ① 电脑操控/视觉分层定版：Window MCP（AX 树）＝主力（秒级、像素级精确坐标，真实 FB 测试全精准命中）、UI-TARS-7B 兜底（GUI 操作备用，4.68GB 需共享内存 31-68s/图）、Gemini 作基准；Qwen2.5-VL 弃用（用户两次用千问都宕机）。② 模板规则：任何模板（PDF/报价单等）不可擅自修改——除非修 bug 或用户明确要求优化，否则一律用原始功能。③ 工程排期 export PDF 必须含原生甘特图（用户反馈纯文字表格版不合格，甘特图才是核心）。④ 顾客版 Purchase List 不显示价格栏（3 处移除）。

Context: 用户看视频博主介绍 MiniMax 开源模型后想白嫖免费高质量视觉理解（顺带试视频生成），引发本地视觉模型选型：Qwen2.5-VL-3B 描述 17 张 project thumbnail 全对（除第 1 张 camera 特写），但 UI 理解弱且两次使用都宕机；UI-TARS-2B 4-9s/图但误判 Google Play；UI-TARS-7B 31-68s/图比 2B 准但仍把现金流管家说成「我的收藏夹」。用户 09:35 纠正 agent 擅自改 PDF 模板的行为，立下模板规则；14:06 看排期 PDF 只有文字没有甘特图后要求改版。真实 Facebook 发布测试（上传 2 照片 + 文案 + 停在发布键）：Window MCP 全精准，7B 15s 分析后点错照片。

What changed: Ollama 清理后只剩 ui-tars-2b（D:\OllamaModels 6.1GB→1.5GB，释放 4.6GB）；qwen2.5vl:3b + 3 个 embedding 模型删除；adaptive-effort 插件禁用；Ollama 改无窗口后台运行（用户不喜欢弹窗）；排期 export PDF 改版为只留原生甘特图；Purchase List 顾客版去价格栏 + 10 类 SVG 图标 + PDF 照片嵌入；多平台发布 CDP 环境备好（YouTube Studio 已登录 / FB / IG 待确认；Chrome profile TZE CZIA + Jake Ti；FB 双账号已登录）。

2026-08-06（晚上）: 平台操控工具优先级定稿（CDP → Window MCP → computer use；旧「抖音/小红书禁 CDP」约定作废）+ 抖音验证码流程定案

Decision: ① 平台操控优先级（全平台统一，含抖音/小红书）：CDP 第一 → Window MCP 第二 → computer use 第三；视觉 Window MCP 第一 → Gemini 3.6 Flash 第二。旧约定「小红书 + 中国版抖音安全检查高 → 禁止 CDP，只用 computer use」正式作废。② 抖音验证码 = 小问题不是封号：遇到验证码弹窗 → AI 点「获取验证码」+ 聚焦输入框 → 直接告诉用户「给我验证码」→ 用户发码 → 秒输入秒验证一次过（验证码 ~60s 过期，过期重发）。

Context: 8/6 18:19-18:46 抖音 Day 8 视频发布最后一关：上传 3 次失败后破案（「重新上传」按钮 = 上传失败状态而非完成，误判 4 次点发布无反应）→ 修复后发布弹验证码（「为确保是本人操作抖音账号」）→ computer_use 点「获取验证码」（SOM 元素 237）→ 用户发码 292336 → 输入框是 Spinner 不支持 set_value、坐标映射偏左 110px、Drive 通知弹窗拦截点击、码 60s 过期 → 重发 943192 秒输入秒验证 → 18:46 发布成功跳内容管理页。用户 18:47 总结：验证码拦截可控、不会封号，因此以后所有平台都以 CDP 优先（此前担心抖音/小红书 CDP 会被检测封号才定「禁 CDP」，实测证明担心多余）。

What changed: 抖音 Day 8 视频发布成功 → 7/7 全平台发布完成；记忆 + skills/publish-video/multi-platform-publish.md + MultiPlatformPublishing_Graph 全部更新（工具优先级、验证码流程、上传状态机、教训 10→14 条）；同日 DeepSeek V4 PRO 22 美仙费用溯源：adaptive-effort 插件 curator 任务调 deepseek-v4-pro 47 次（8/1×1 + 8/4×32 + 8/6×14），config 禁用后 11:20 起零调用——非 OpenClaw/主对话/视觉。

2026-08-07（凌晨）: 三机舰队建成 — sleep 代替 shutdown + 局域网 WOL 死路改 RTC/智能插座 + 算力池分配写死

Decision: ① 睡眠(S3)代替关机（用户定稿，三机通用）——睡眠减少硬件磨损（内存供电、SSD 停读写、风扇不转），比频繁开关机更保护硬件；远程流程依赖睡眠状态（WoWLAN 唤醒）。② 局域网 WOL 在这套网络是死路——TP-Link Deco mesh 无线→有线方向把 WOL 端口全挡（广播 + 单播 UDP 9/7 三层验证 0 包，Deco 无 AP 隔离选项，固件层行为）；S5 关机唤醒必须有线网卡（WiFi 关机断电）。③ 远程开机改走：MSI = WoWLAN 睡眠唤醒（免网线，实测 20s）；IDA = Power On By RTC 定时开机（零成本，待用户设 BIOS）+ 智能插座兜底（Tuya ~RM20，配合已设 Restore AC Power Loss = Power On）。④ 算力分配写死进 skill remote-task-offload + 记忆三层保险（记忆指针每轮注入 / skill 描述触发词 / 行为规则「做重活前先问目标机在线吗」）；Hermes 插件无会话自动加载 skill 机制，插件不是答案。

Context: 用户深夜要求远程开关 IDA PC → WOL 多次失败后带教排查（Windows 侧全对、ASUS 7 系主板无 ErP、APM 只有四项）；用户提出双机 GPU 算力池构想 → 查明 IDA 的 GT 640（Fermi CC 2.1）太老，改定位 CPU 任务卸载机；MSI 卡机根因实锤（过热→PCIe 失稳：Kernel-Power 41 ×4 + WHEA 17）；MSI 睡眠唤醒成功后 IDA 唤醒三层验证（广播/单播/Tailscale 单播通但睡眠后不可用）锁定 mesh 固件层隔离。

What changed: IDA 任务卸载机（WinRM+Tailscale 自启 + SMB \\100.103.118.9\share + whisper + ffmpeg，局域网 IP 更正 .110）；MSI 远程可控（Tailscale 100.107.39.23 + remotesvc 账户 + 5985 全放行）且 WoWLAN 睡眠唤醒验证通过；双机 Ollama 算力池上线（MSI GPU 49.2 tok/s + IDA CPU 7.9 tok/s + MSI qwen2.5-vl:3b 视觉 + vision_msi.py）；MSI 降温 99% 限频止血；IDA BIOS 设 Restore AC Power Loss=Power On + Wake on LAN S5（RTC 待设）；新图谱 Fleet_Graph + vault skill 摘要 + 记忆三层保险；platforms/Credentials/AIProjects_Graph/Company_Graph 图谱目录全部更新。

2026-08-07（上午）: WoWLAN 结论修正 — MSI 真睡眠 WiFi WOL 不可用（假阳性证伪）+ IDA 免登录远程控制验证通过 + RTC 落地

Decision: ① 修正 8/6 凌晨「WoWLAN 睡眠唤醒实测成功」结论——那是假阳性：当时 MSI 根本没真睡（只是屏幕关，5985 本来就 OPEN），WOL「碰巧成功」。严格复测（真 S3：5985 断 + 灯灭后发 magic packet ×5）全部失败 → MSI 的 WiFi WOL 在真睡眠状态不可用（疑 GL62M BIOS 不给 WiFi 槽 S3 供电，Intel 3168）；MSI 可靠远程唤醒只剩 插网线 WOL（有线网卡 S3/S5 均支持）或智能插座。② MSI 混合睡眠补关（昨晚只关了 IDA，漏了 MSI）——以后 MSI 睡眠 = 真 S3，灯变橙/呼吸灯可作睡眠判据。③ IDA 免登录远程控制验证通过：WinRM 规则 Domain/Private/Public 全放行 + Tailscale 服务 Automatic 已就位 → 睡眠唤醒锁屏状态与冷启动后均 5985 OPEN；之前「未登录连不上」= 冷启动服务未起、探测太早 → IDA 开机无需登录即可远程控制。④ IDA Power On By RTC 已设：Date(days)=0（=每天） + 08:00 → 每天自动开机方案落地（零成本）。⑤ NBFC 风扇控制放弃：1.6.3 已装但官方 183 个配置无任何 MSI 机型 → 不支持，需逆向 EC；维持 Fn+F7 手动。

Context: 用户早上发现 MSI 电源灯无色、散热口无风，怀疑昨晚过热关机 → 排查确认虚惊（00:44:09 开机后连续运行 8.1h，00:17 关机事件 = agent 自己 WOL 测试；降温措施生效）。随后用户完成 IDA RTC 设置、问「未登录能否远程控制」→ 触发决定性实验（睡眠→锁屏不登录→探测通过；冷重启→探测通过）。用户对 MSI 再次做 sleep→WOL 复测 → ×5 失败，推翻凌晨结论。

What changed: Fleet_Graph + msi-laptop + daily 全部更正（WoWLAN ❌、混合睡眠已关、RTC ✅ 已设、免登录可连、NBFC 死路）；NBFC 1.6.3 装在 MSI C:\Program Files (x86)\NoteBook FanControl\（保留无害）；待办更新（MSI 网卡唤醒设置核查、有线 WOL 变必选、智能插座、白天监控待确认）。

2026-08-07（上午-中午）: MSI 风扇远程控制 = 硬件封闭定案 + 文件通道 SMB→HTTP 直传 + Drive 挂载零传输约定

Decision: ① MSI（GL62M）风扇远程控制 = 硬件封闭，永久放弃：已穷尽全部路径——ec-probe 裸寄存器（0x32/0x98/0xF4）写无效（EC 固件忽略）、GhostDeck 源码揭示 MSI EC 走 WMI（MSI_ACPI 类 + Set_Data）但老机型无此类、NBFC 183 配置 + GhostDeck 145 机型均无 GL62 → 只认 Fn+F7 物理键，不再重复研究。② 文件通道从 SMB 改为 HTTP 直传：SMB error 67 反复（445 TCP 通但协商失败，mesh/Tailscale 协议层）→ 定型 push_file.py ida|msi <文件>（Sozo 起 HTTP 服务 → 目标机下载），落点 IDA D:\share\、MSI C:\share\；skill remote-task-offload 已同步。③ Drive 文件零传输约定（用户要求）：三机都挂 Google Drive，业务文件直接引用各机挂载路径（IDA 业务盘 = I:\我的云端硬盘，H: 是大学账户），不占空间重传。

Context: 用户测试双机算力（whisper 转写 + MSI 视觉）时 SMB 反复 error 67 → agent 连续排查（445 通、服务正常、共享名正确仍失败）后当机立断改 HTTP；随后用户指出「三台电脑都挂了 Google Drive，视频本来就在里面，不用传」→ 查明三机挂载路径；用户质疑算力池「鸡肋」→ 引出 swarm/crowd render 概念 → 当天 Blender 三机并行渲染跑通（见 daily）。

What changed: push_file.py 工具定型 + 落点路径记录；三机 Drive 挂载对照表入 Fleet_Graph；llama.cpp 分布式推理部署启动（MSI CUDA llama-server + IDA ggml-rpc-server + qwen2.5-7B Q4 下载中）；Blender 5.2.0 三机并行渲染跑通（帧分片：IDA 1-3 CPU / MSI 4-6 GPU / Sozo 7-8 GPU；8 帧动画 + 拼图完成；单张效果图 = Cycles Border Render 分块方案已分发）；踩坑记录：schtasks 不可靠（末帧缺失、MSI 需 SYSTEM 账户）→ 前台渲染最稳，Blender 5.2 必须 Windows 路径。

2026-08-07（深夜）: BQ 正式引入报价流程 + Master APP BQ 模块（两种模式）+ 部署根因链锁定

Decision: ① BQ（Bill of Quantity）是报价流程的正式环节——quotation 之后出 BQ 给 contractor/subcon 竞标，不是「去价的 quotation」：quotation item 是打包卖点（Lumsum 为主），BQ 必须拆到可测量单元（Unit + Qty + 规格），价格列留空让 contractor 填 rate 再比价；BQ = Cost Breakdown 的专业版。② BQ 两种模式：①成本版（自己检查/给 subcon 看，含成本）②竞标版（外部 contractor，价格留空）——Master APP 首版只做了竞标版，调整计划：保留成本字段 + 「显示成本列」开关 + PDF 双模式 ?mode=internal/对外版。③ 正式 BQ 一律英文品牌模板（HS Design 绿金 + logo），中文版仅顾客要求时出（高先生是例外）。④ 部署教训（写进 skill opennext-cloudflare-deploy 坑 0b/0c）：Prisma client 生成 65 行 stub = schema validation error 的静默 fallback（本次根因 = Schedule 模型缺 3 个反向 relation）；@opennextjs/cloudflare 必须静态 import（cloudflare/init.js 的 getCloudflareContext）否则 opennext 不打进产物 → 运行时 import 失败静默 fallback createLocalClient → workerd 里 e2 is not a function；版本必须精确锁定（next 15.5.22 + opennext 1.17.3 + esbuild 0.21.5，本次 npm 漂移到 15.5.23/1.20.2）；先本地 wrangler dev 验证通过再部署。

Context: 用户让 agent 为高先生（HSD00010）出 BQ 给其 contractor 竞标 → 中英双语 PDF 交付后，用户点破 BQ 的实用价值（quotation 之后给 contractor 的正式量单，初代 = subcon 中文清单）并拍板在 Master APP 报价单编辑器挂「生成 BQ」功能；开发完成后部署线上全 500 → 回滚安全 → 连续 1 小时逆向 Prisma stub/版本漂移/wasm/import 链，最终锁定 @opennextjs/cloudflare chunk 缺失为唯一卡点。用户同时要求 study 行业文档体系（VO/Progress Claim/Retention/WO+LA+PC/Back Charge/PO-DO 初步评估见 daily）。

What changed: Master APP 新增 BQ 模块代码全部完成（D1 表 BQ+BQItem 已建、/api/bqs API、报价单编辑器 BQPanel、/api/pdf/bq 英文品牌 PDF），部署未完成（线上已回滚、系统稳定）；D1 建表成功（BQ + BQItem 各 10 条写入验证）；Prisma schema 修复（Schedule 补 3 个反向 relation，validate 0 错误 + 555 行完整 client）；高先生 BQ 中英 PDF 已存 HSD00010/Quotation/；8/8 09:00 提醒发平面图原图已设；skill opennext-cloudflare-deploy 坑 0b/0c + hsdesign-quotation-system 流程已更新。

2026-08-08（上午）: BQ 部署终获成功 — GitHub research 突破 + 一键部署脚本（长期主义落地）

Decision: ① research 优先（用户 06:45 建议「GitHub 没人遇过吗？去 research」）：prisma/prisma #28657 确认 workerd 禁止运行时动态编译 wasm（WebAssembly.Module(bytes) 直接崩）→ 必须静态 import .wasm + wrangler CompiledWasm 规则预编译。② 回 8/6 原配置（Prisma 6.19.3 + engineType=client + driverAdapters）：Schedule 反向 relation 修复后原配置本来就能用（563 行完整实现、getCurrentBinaryTarget=0 无 fs.readdir）——不 patch minified Prisma（每次 generate 都要 patch、升级必崩 = 一次性方案），而是**「生成即用」版本组合锁死 + 一键脚本化**（用户长期主义原则 07:11 明示：拒绝一次性方案）。③ compilerWasm 内置用 fs.readFileSync（workerd 崩）→ patch 改 globalThis 读取 + engineType=client 自带裸 wasm query_compiler_bg.wasm。④ db.bQ Prisma 命名陷阱：模型名 BQ → 客户端属性是 db.bQ（大写 Q），route.ts 写错导致 /api/bqs 500。⑤ 一键部署脚本 build_deploy.sh（部署+自动验证+失败回滚）为长期资产；修两个脚本 bug：--outdir 无效参数被管道吞退出码（「看似成功」实际没上）+ verify 用假域名。

Context: 8/7 深夜 BQ 部署失败回滚后，第 4-6 轮鏖战：stub→wasm→import 链逐层打通但最后卡 Prisma client 加载器选型（edge.js 版禁 adapter；Gr 类走 fs.readdir 在 workerd 无实现）。用户建议 research 后 30 分钟找到 #28657 + 8/6 原配置洞察，07:19 本地全链打通（HTTP 200），07:28 线上部署成功。

What changed: ✅ BQ 正式上线：线上 API 全 200（quotations/bqs/bills/projects）；Mr Chen QUOAUS0001 实测成功（BQ-QUOAUS0001 生成、6 项完整拷贝、PDF 正常）；真域名 hsd-cashflow.ida-czia.workers.dev（pages.dev 是配置假值）；build_deploy.sh 一键部署落地；根因链完整写进 skill opennext-cloudflare-deploy（坑 0b/0c/0d）；部署坑速查补 7-9（见 CashflowApp_Graph）。待办：BQ 成本版 v2（双模式）未实施；Mr Chen 的 BQ 等用户安排。

2026-08-08（上午）: Briefing Form 上线 + 语言策略定版 + Agreement→Receipt/Progress Claim 调整

Decision: ① Briefing Form（顾客需求访谈表）= 10 section / 49 字段行业标准设计（A 项目档案→J 服务期望；Key Collection Date、预算区间、风格评分、宠物、大型器械承重坑、祈祷室/风水、硬性日期、转介绍来源全收录）；1:1 upsert（同项目重复保存=更新，未填字段保留原值）；PDF 品牌模板导出。新顾客建档流程定型：用户报名字/电话/想做的事 → agent 自动查在案/建项目 + 填 briefing form。② 语言策略（用户拍板，长期偏好）：Quotation / Invoice 保持英文；Briefing Form 中英双语（客户理解用）；PDF 中文问号 = 字体缺失 → 字体栈加微软雅黑。③ PDF 一律 --no-pdf-header-footer（用户不喜欢 footer 出现网页/文件路径）。④ Mr Chen 不签 Agreement（签 quotation + 定金即可）→ 改做 Receipt 收据（收 deposit 后给）+ Progress Claim 请款单（收进度款用）+ 更新报价表（移除「移橱」项）。⑤ 唯一真相源 = D1 数据库（life-map 等以 D1 为准，更新资料以唯一真相源为准）。⑥ 公司 SOP 化：行业文档（VO/Progress Claim/Retention 等）做完整模板/SOP，不靠 AI memory 每次现规划（质量稳定）；submit claim 给顾客 vs 给分包商 = 两个场景都要。

Context: 用户 08:19 要 BQ+Briefing PDF 参考 + 待办编号化（17 项清单，用户回号码报状态）；08:42 Anne Lew（+65 8927 3152，Pandan，两房式）建 HSD00011 + Briefing；08:48 问思维导图 SSOT；08:49 要求 Briefing 双语；09:00 要求行业文档初步判定 + 公司 SOP 化；09:12 Agreement 纯英文 + 无页眉页脚；09:15 补充 Mr Chen 不签 Agreement。

What changed: Briefing Form 模块上线（页面 /briefings/[projectId] + POST /api/briefings upsert + /api/pdf/briefing PDF，测试数据已清理）；Anne Lew Briefing 双语 PDF 交付（Briefing_Anne_Lew_BI.pdf）；待办 17 项编号清单建立 + 用户状态回报（3/4/6/7/10/11/13 完成，5 今天下午 3 点见顾客，12 需再 follow up，17 已试失败；巴西古当口头成交未进 deposit 不算成交）；Agreement 纯英文版完成（36/36 处）+ 部署中；Receipt/Progress Claim 开发中；/api/pdf/agreement/[projectId] route 修 {id} 解构 bug 后 HTTP 200。待办：Receipt + Progress Claim 实现；Mr Chen 报价表移除「移橱」项（找不到单独项目，待用户确认）；行业文档体系详细 study；IDA RTC 08:00 首测仍未确认。

2026-08-08（中午）: PDF 全系列统一（teal/纯英文基准）+ 数据编码根因 + Receipt/PC/VO/Checklist 上线 + Mr Chen 超额处理 + Pulai Flora 成交

Decision: ① PDF 格式统一基准 = quotation 模板（teal doc-title，非金色——用户 09:41 指出后来新做的 PDF 有金色右上角、旧 quotation 没有，要求检查所有 PDF 专业性与一致性）→ 8 个 PDF 全统一：纯英文（客户 PDF 一律去中文，马来西亚本地才专业）、无网站/URL 页脚（--no-pdf-header-footer）、页边距 12-16mm、标题字号 30-36px。② PDF 中文问号根因 = 数据编码损坏，不是字体：模板中文一直正常（微软雅黑已嵌入），乱码是数据值——curl 传中文被 Windows 编码搞坏（存进去即乱码）。长期规则：写中文数据一律用 Python（强制 UTF-8）传输，不用 curl。③ Receipt 收据 + Progress Claim 屋主版上线（Mr Chen 不签 Agreement 的配套）：Receipt 显示已收金额大字 + 尚欠余额 + 签名盖章栏；PC 基于 Invoice 模型（stageLabel/percent/amount/balance）。④ 行业文档三件套（VO 变更单 / Progress Claim 总包版 / Site Checklist）上线：VO 用 ?add=/?subtract= 参数自动算调整后合同总额；总包版含 WO 工单号 + 保留金 10% + 证据附件 + 总包签收栏。⑤ VO 不是新页面：只是 PDF 生成 URL，不动现有页面（用户 10:42 明确要求别重复造功能）。⑥ Mr Chen 超额 RM807 处理：agent 先前「催补差额」是错的——更新后合同 15% 定金 RM1,593 vs 实付 RM2,400 → 超额 RM807 记入 D1 备注作抵扣，不催收（用户点破「顾客没完全跟住」场景：以实收为准、差额抵扣）。⑦ 待办文件并发写冲突：OpenClaw 用 task 格式重写导致 title 全空 + 已完成滞留 active → 统一 task 格式修复（多 agent 共享文件需约定 schema）。

Context: 09:16 后用户连发多条：报价单删第 4 项大衣橱 + PDF 去中文 + 检查格式一致性；高先生 BQ 更新（第 3 项 6→5、总面积 440）；Mr Chen 进 RM2,400（含已删衣橱的超额）；警察顾客 Feature Wall 报价加入待办；Anne Briefing 问号；12:11 Pulai Flora（Mr Perumal）成交——5% discount（RM702）→ 合同 RM13,338，60% 定金应付 RM8,003，实收现金 RM6,800，尚欠 RM1,203（待用户确认）⛔ 更正（12:27）：实际实收 RM8,003（60% 整）——6,800 为 agent 记错，INV-2026-011 → paid、余额 RM0，详见「2026-08-08（下午）」条目。

What changed: ✅ Receipt + Progress Claim 屋主版上线（Version 5966d02b，示例 PDF 无 URL 页脚）；✅ QUOAUS0001 更新（6→5 项，RM16,500→RM10,620，衣橱 RM5,880 移除，BQ 同步）；⚠️ PUT 字段名事故（price→0 数据破坏 → 备份全不通 → BQ 数据 + fixed 模式重建，成本列丢失待补——教训：PUT 前先查 API 期望字段）；✅ 8 个 PDF 全统一（teal/纯英文/无页脚）；✅ 高先生 BQ v2（BQ_MrGao_Window_Door_v2.pdf）；✅ Mr Chen 收款（INV-2026-010 paid，Receipt_MrChen_Deposit2400.pdf，超额 807 备注抵扣）；✅ VO/总包版 Claim/Checklist 三件套上线（Version 0353a512，全 200，又批量修 [projectId]+{id} 解构坑）；✅ Anne Lew Briefing v4 干净版（Python UTF-8 重写数据）；✅ Pulai Flora 成交记录（INV-2026-011 partial→paid，due 8/31 缓冲期；⛔ 12:27 更正：实收 RM8,003 全款，6,800 为记错，Receipt_PulaiFlora_8003.pdf）；✅ 待办文件修复（active 10 + completed 17）。待办：Pulai Flora RM1,203 确认；Receipt 按钮（master app 发票页一键生成）待用户拍板；警察 Feature Wall 报价；高先生下午补尺寸；Mr Chen 报价成本列补录。

2026-08-08（下午）: Official Receipt 马来西亚合规升级（金额大写 + 公司印章）+ 收款流程定版 + 地址 SSOT 确认

Decision: ① Official Receipt 对照 LHDN 惯例补齐：金额大写（Ringgit Malaysia: … ONLY，防篡改）+ 公司印章图（HS DESIGN 圆形印章，去背景透明 PNG 15KB，放 public/ 静态资源，自动盖在签名栏下方）+ 修 Received From 空白（route include 补 project.customer，以后收据自动带客户名）。② 客户 PDF 绝不出现内部信息：remark 不得写 discount 等内部草稿（用户 14:47 点破，已清理为「Confirmation deposit - QUO-PUL0001 (60% of contract sum)」）。③ 收款流程定版（用户 14:01 确认）：小单 Quotation 签名 + 拍照 = 合同，不需要 Agreement；每阶段 = 「请款 Invoice → 收款 → Official Receipt」两件套；deposit 不需要 Progress Claim（签约预付款 ≠ 施工进度），第二笔进度/尾款才需要。④ 地址 SSOT = D1 project 表（不是 quotation）：quotation 只是当初填地址的参考来源；4 个项目完整地址已从 quotation 批量同步进 D1，route 回滚「quotation 优先」逻辑，PDF 一律读 D1。⑤ Profit 检查教训：5% discount（RM702）吃掉 Perumal 利润的 1/3（16.7% → 12.3%）——以后给 discount 前先算 margin。

Context: 12:27 用户点破 Pulai Flora 实收是 RM8,003（60% 整）非 6,800 → 全链更正（INV-2026-011 paid、余额 0）；12:47 用户要求设 8/12（周三）15:30 Eco Cascadia（Echo）见顾客提醒（和朋友去，提供平面图+3D 图画图服务；cron 提前 1 小时 14:30 提醒）；12:54 用户要求研讨业务流程（文档链/排期表/请款时机，深聊待续）；13:14 用户问两场成交 profit（Perumal 成本 RM11,700 → 实际利润 RM1,638；Mr Chen 成本丢失待补 5 项）；14:02 用户问 Receipt 是否符合马来西亚规范；14:22 用户发公司印章图；14:32 用户发现收据 site 只有「Skudai」简写 → 指出 quotation 有完整地址 → 14:37 用户要求以 quotation 更新 SSOT → 14:42 用户纠正 SSOT = D1 不是 quotation → 回滚。

What changed: Receipt 模板升级部署（印章 public/ 200 + 金额大写 + 客户名 + 地址）→ Receipt_PulaiFlora_FINAL4.pdf（Perumal 完整地址 33, Jalan Flora 3/6, Taman Pulai Flora, 81300 Skudai, Johor）；4 项目地址同步 D1；Eco Cascadia 提醒 cron + 待办 🔥high due 8/12；Profit 分析（Perumal RM1,638 / 12.3%，Mr Chen 待补成本）。待办：① Quotation 是否更新为 RM13,338（加 5% discount 行，全文件金额一致）待用户拍板 ② Mr Chen 5 项成本价待补 ③ 业务流程深聊（排期表）待续 ④ Receipt 按钮（发票页一键生成）待拍板。

2026-08-08（深夜）: PDF 根因定案 — Telegram 同名快取 → 重发必须换新档名

Decision: Anne PDF 用户仍看到旧版（问号+footer）的根因不是网页未更新——线上 HTML 三证通过（hsdesign.biz=0 ✅、微软雅黑 ✅、中文标签 ✅）；真正根因 = Telegram 同名文件快取旧版（同名 PDF 重发时 Telegram 缓存旧档）。今后重发 PDF 一律换新档名（v3 已实行：新档名发送，附同名快取说明）。

Context: 8/8 深夜用户回报 briefing PDF 仍有问号+footer；线上 verify 通过（grep briefing_check.html）→ 诊断根因 → Chrome headless 渲染线上 URL（BASE=hsd-cashflow.ida-czia.workers.dev，BID=cmsjnhjfm00005k10h7mgifz7）生成 v3 → 新档名发送。

What changed: ✅ Anne v3 PDF（新档名，无网站+中文字体嵌入）已发，待用户最终确认。规则：重发 PDF 必须换新档名（Telegram 同名快取），不可同档名覆盖重发。

2026-08-09（凌晨）: IDA PC WinRM 远程关机 — 执行链定版

Decision: 用 WinRM 远程关 IDA PC（用户 00:23 要求），实测成功。执行链定版：

Python 解释器：必须用系统 Python 3.11 /c/Users/Sozo/AppData/Local/Programs/Python/Python311/python.exe（pywinrm 仅装于此；默认 python 3.11.15 无 winrm 模块）
路径规则：先 cd /d/hermes/hsdesign_work 再以相对路径调 winrm_cmd.py（git-bash 把 D:\... 绝对路径转成 D:\\d\\... 会炸）
凭据：IDA 密码硬编码在 D:\hermes\hsdesign_work\winrm_cmd.py（PASS 常量）；skill winrm-remote-control 引用的 env/winrm-ida-pc.md 原本不存在 → 已补建（只存指针）

Context: 一次尝试默认 python（无 winrm 模块）→ 二次尝试绝对路径（MSYS 路径坑）→ 三次 cd + 相对路径成功（status 0）→ ping 验证 100% loss 确认离线。

What changed: ✅ IDA PC 已关机（8/9 00:25）；env/winrm-ida-pc.md 新建；Credentials_Graph 凭据位置更新（原写「用户持有/会话提供」已过时）。开机走 WOL。

2026-08-09（中午）: 成交升级 SOP 全链定版（D1 编号 + 云端夹 + PDF 三处同步）+ 知识沉淀原则（vault 图谱 > agent memory）

Decision: ① 成交升级必须三处同步：收 deposit 成交后 ①master app D1 项目编号 HSP→HSD + status→won，②Google Drive 云端项目夹改名（{编号} {客户} @ {地点}），③PDF（收据自动带 HSD；报价单头部新增 Project Ref 字段）——三处编号必须一致。执行顺序关键：先释放被误占编号（Anne 占 HSD00011 先释放）再升级，否则 unique 冲突。② 报价单 PDF 增加 Project Ref（读 quotation.project.projectNo，route include project 已有）——行业惯例，追账/沟通方便。③ 知识沉淀原则（用户 12:36 定版）：所有知识进 Obsidian vault 图谱体系（Company_Graph 等），agent memory 只存临时指针——memory 定期整理会降质，vault 图谱是「找不到东西时」的第一去处。④ 供应商建议：master app 加「供应商/合作方」模块（不塞客户表；字段：名称/电话/合作模式/备注）——Busway Curtain Design 为首个案例（15% commission 或自定义 markup），待用户拍板。

Context: 12:14 用户指出 Mr Chen（Austin）和 Perumal（Pulai Flora）成交后编号还在 HSP——高先生那次升级了但没固化成流程 → 本次补齐并发现：Anne Lew 误占 HSD00011、高先生重复记录（HSP012/cmsg5463b 孤儿）、报价单无项目编号字段、云端文件夹未改名。12:30 用户给出 HS Design 跨 PC 路径（Sozo G:\Other computers\msi\Jay Ti\Work\HS Design；IDA H:\其他计算机\msi\Jay Ti\Work\HS Design）→ 补进 Company_Graph。12:36 用户纠正「应补到 obsidian vault 对应位置，而不是 agent 记忆」。12:40 新增供应商 Busway Curtain Design（窗帘，referral program：15% commission 或自定义价格，012-8567 987）。

What changed: ✅ Mr Chen→HSD00011、Perumal→HSD00012（D1 + 云端夹同步改名）、Anne 释放→HSP00010 + 云端夹补建；✅ 报价单 Project Ref 上线（部署 Version fbcbc84e）；✅ skill hsdesign-cashflow-system 补「成交升级 SOP 5 步 + 云端夹同步规则」；✅ Company_Graph 补跨 PC 挂载路径 + 项目夹命名规则；✅ 记忆精简为指针（按用户原则）。待办：高先生重复记录清理；Busway 供应商模块（master app）待拍板；「材料对比 PDF」流程是否存 skill 待用户确认；Perumal 新报价（10 项 scope 已列）等 light box 深度/门尺寸/单价。

2026-08-10（凌晨）: Ambience 零 markup 定版 + Buildsmart 双向关系 + bullet 输出铁律 + 签名盖章 8 模板统一

Decision: ① Ambience 新报价 markup = 0（本钱变卖价）——用户明确不赚 28%（subcon 愿意分一点钱）；水泥工部分按 subcon 要求 split item 逐项列价（不写 lumsum），明细记入 D1 唯一真相源（BQ/成本），不存表面：封排水孔 2300 include rorobin、垫高地面与洗衣间齐平 2200、冷气排水延伸 100、加长洗手盆 150、洗衣机分支 1200；「洗手盆旁混凝土砌贴砖台面边缘」只属主人房浴室 IEM（第一项移除）。② Buildsmart 双向关系定版：Buildsmart 既是拉电分包商（应付 RM11,516.25 / BILL-2026-001）又是客户——HS Design 是它的设计分包商；客户 = subcon 本身而非最终业主（Supplier + Customer 双档案并存，同 Afiq/Sky Lark 模式）；SOP 新增「subcon 给的设计分包项目」子类。③ 输出格式铁律：所有 note / 需求一律 bullet point（用户 8/10 明确指示，JSON 平铺人类难读），briefing PDF 模板级实现 bulletItems()。④ 客户文档签名盖章统一：8 个 PDF 模板（quotation/invoice/agreement/checklist/progress-claim×2/vo/bq）补「Authorised Signature & Company Stamp + company-chop」左下角区（以 receipt 为基准），之后生成任何文档自动带。⑤ 模板缺字段先查数据：Mr Chen site 地址缺失根因 = D1 数据缺失（vault 8/6 有记录 2A Jalan Austin Heights 1/9），不是模板 bug——先查 D1 + vault 再动模板。⑥ 排期约束入 D1（schedule_constraints.sql）：Mr Chen 量尺后两周内完工；Perumal 8/12 量尺、顾客 8/20-28 旅行、8/29+ 安装。⑦ 排期页 Application error 调查策略：生产版错误 UI 被吞 → 线上注入 window.addEventListener('error'/'unhandledrejection') 捕获真实堆栈（已得 1,708 chars 待分析）；放弃 git-bash wrangler dev（libuv 崩溃）。

Context: 8/9 22:34 用户澄清坏账是 Jeffley（RM1,860），Jeffrey 是之前顾客 Chai Fun Lip（应收 RM15,000）——两个人；23:51-00:47 警察概念提案 v2→v4（P3 Entrance Wall A/B、footer 地址修正 24-1 Rosmerah，Desa Tebrau 0 残留）——地址错因 = 助手凭记忆编造，Company_Graph 已加「🏢 公司信息区 + 勿编地址!」警告；00:02 用户发现报价左下角地址完全不相关；00:08-00:09 Master APP 应付账单「?」乱码 + 排期页 application error；00:20-00:28 新增 Buildsmart 两个设计分包项目（HSP00011 Eco Cascadia / HSP00012 Rini Homes，各 RM2,750 = 2 平面图@150 + 7 3D@350），用户指出建夹未按 template（含子项目）复制 → SOP 强化；00:47 IDA PC 关机 + 算力扩容澄清（TTS 在线 edge 不需要 IDA；Blender/Whisper/转码/Ollama 待启用）；02:02 用户发现 Perumal 电话写成 WhatsApp（+60 13-245 6718 入 D1）+ serial 6050 split item 显示问题；02:28-02:33 Annie（HSP00010 Pandan）briefing 需求表入档 + dash 修复；02:46 Mr Chen 两周完工 + deposit official receipt；02:52 Ambience 格栅门淘宝比价待办 + Polilora 排期对象纠正（已成交 = QUO-PUL0001 楼梯屏风 5 项 RM13,338，非 10 项翻新）+ 签名盖章缺失检查。

What changed: Briefing 模板 dash 修复 + bullet 渲染上线（Briefing-AnneLew-Pandan-v2.pdf 3 页）；8 模板签名盖章统一部署（验证 Quotation-Chen-MountAustin-v1.pdf Signature: True）；Mr Chen 地址补 D1 + Official Receipt REC-INV2026010-MVGY0M v2（remark 清理内部文案「Deposit 15% of RM10,620」→ 干净描述）；QUO-AMB0002 生成（RM18,600，Masonry split 明细，待格栅门定价）；cust_buildsmart 建档 + HSP00011/12 挂靠 + 云端夹创建；待办新增（Rini Homes 报价可立即出 / Eco Cascadia 等 8/12 见面 / Ambience 格栅门比价）。未决：排期页 Application error（堆栈待分析）、Buildsmart「?」乱码、Perumal 电话 D1 更新确认。

2026-08-10（中午）: Prime Agent 协作模式定版（互补非竞争 + 3 步验证 + 配额校准实验）+ P0 安全事件处置（hsdesign.biz 泄露 CF Token）

Decision: ① Prime vs Hermes = 互补非竞争（用户 11:33 定版）：Prime 强在效率（自主深度、便宜——大活 $0.07-0.14），Hermes 强在记忆（最佳个人助理）+ 生态（Telegram/cron/MCP）+ 验证；分工 = 大活外包 Prime → Hermes 验收 + 部署 + 沉淀采纳。② C 优先原则：先给 Prime 补「眼睛/触手」（OpenClaw 浏览器桥接 + daemon 中途插入），才有能力做好 A（每晚知识沉淀定时 job）和 B（优化任务）。③ 严谨验证标准（用户 11:53）：Prime 每条发现必须 3 步验证——查源码对应位置 → 线上实测复现 → 三档判定（✅属实/⚠️部分正确/❌误报），宁杀错不放过（它被截断前未完成自我验证 = 中间产物，不可轻信）。④ 配额校准实验（用户 11:55 设计）：用不限配额的大任务观察自然消耗（turns/tokens/阶段），产出校准表定未来配额 sweet spot。⑤ Prime 沉淀机制澄清：Prime 自身自动沉淀（harness 技能自动保存），只有「同步进共享知识库 vault」需要定时 job。⑥ 🚨 部署安全检查铁律：部署目录严禁混入 .env/deploy 脚本/源码备份；deploy.sh 内置敏感文件拦截（deploy.cmd/deploy.bat/temp_repo/.wrangler/service_account.json/.env），命中即中止部署。

Context: 10:59 Prime 沉淀管线测试通过（决策文件+daily 追加+tree_signature.py 22 断言+SKILL.md， $0.04/40 t u r n s ）； 11 : 33 用户提议 P r im e 借 O p e n C l a w C L I （ W S L 可调、 b r o w ser 命令面完整）解决浏览器短板； 11 : 38 确认 d a e m o n 在跑但 0 sess i o n ，前台任务无法中途插入（用户不愿重启） \to 以后用 d a e m o n 会话启动 + ‘ p r im e - a g e n t se n d ‘ 中途转向； 11 : 43 任务 A （ ma s t er a pp 审查） 38/25 t u r n s 截断但 r e g r ess i o n_{t} es t s . p y 28/28 全绿； 11 : 55 派大任务（ h s d es i g n . bi z 全站审查） \to 113 t u r n s /$ 0.1374 完成 SITE_REVIEW_REPORT.md；12:08 Prime 发现线上 /.env、/deploy.cmd、/temp_repo/_worker.js 公开可下载（有效 CF API Token），Hermes 验证 100% 属实——部署目录+Drive 真相源混入敏感文件致泄露（354 个 .py 脚本+备份目录也公开，P1）。

What changed: ① 敏感文件移出部署目录（备份 D:\hermes\hsdesign_work\site_secrets_backup\）+ Drive 真相源清理（H:\My Drive\hsdesign-site-source）② deploy.sh 安全检查升级并重新部署 ✅（cache-bust 验证全部真实 404；先前 200 = CDN 缓存旧响应，4h 自然过期）③ purge 失败因 token 仅 Pages 权限（无 Zone 权限）——不影响 ④ regression_tests.py（28/28）成为 master app 部署前回归工具；SITE_REVIEW_REPORT.md（22KB 7 维度）待逐条复核 ⑤ prime-life-map-optimizations skill 采纳进 Hermes 技能库。🔴 用户必须做：吊销泄露的 Cloudflare API Token（cfat_nGPv… 开头）→ 之后 Hermes 更新 deploy.sh token。待办：C 浏览器桥接实装（gateway token 调试）、daemon 常驻 session、每晚沉淀定时 job、Prime 报告逐条复核。

2026-08-10（下午）: Master App 安全审查 6/6 全部验证属实（P0 XSS 链 / P1 BQ notIn 误删 / P1 全 API 无鉴权），修复方案待拍板

Decision: 修复方案已备好（logoPath 白名单 + BQ 空列表保护 + 简单 API-Key 鉴权，改动小风险低）——待用户拍板「现在修」还是「派给 Prime 练手」；已定部分 = Prime 做发现、Hermes 做验证+汇总为最佳组合（第二次实证，零误报）。

Context: 12:16 补报告任务 exit 124 超时截断（Prime 报告总写不完），转录保留全部发现；12:19 Hermes 逐条验证 6/6 全部属实：① P0 存储型 XSS 链（settings PUT 无鉴权 + logoPath 未转义 → 9 个 PDF route 插值，源码逐行确认）② P1 BQ PATCH notIn（incomingIds 空 → deleteMany 删光全部明细，数据破坏）③ P1 全 API 无鉴权（无 middleware.ts）④ 🟡 超收显示 receivedTotal 虚高 ⑤ 🟡 PDF text/html 设计如此 ⑥ 🟢 金额大写 cents 风格非 bug。报告：D:\hermes\hsdesign_work\prime_setup\master-review\REVIEW_REPORT.md。

What changed: ✅ 审查报告交付（零误报）；✅ CashflowApp_Graph 补「安全审查结果」区块。待办：用户拍板修复方案（XSS/BQ/鉴权修复）；吊销泄露的 CF API Token（cfat_nGPv…，见中午条目）；排期页 Application error 堆栈分析。

2026-08-10（晚）: 双子任务双盲流水线定版 + 驾驶模式上限发现 + 域 session 机制（Prime 协作模式 v2）

Decision: ① 双盲流水线 = 标准流程：中等以上任务默认「实施 session（带记忆）→ 盲审 session（无记忆·独立审查员）→ Hermes 综合验收/部署」；盲审不给实施报告，只给目标+文件清单（用户 17:14 纠正：daemon 修复「自己修自己」= 偏见风险最高，最该双盲）。② 域 session 机制：--session-dir 分域（master-app / life-map / website / system-fix）+ sessions/blind（每次新 session 不延续，永远陌生视角）；同域不能并发（写坏 JSONL），不同域可并行。③ 驾驶模式测上限：无上限跑（9999 turns / 2M tokens）+ Hermes 当司机每 10-15 分钟查 JSONL（进度/死循环/随时 kill 或 prime-agent send 转向）；Prime 真实上限 = maxContinuations 3/3（autonomous 续跑保险丝，不是 turns）——续跑需外部 send 喂消息。④ 派活铁律：有任务尽量派 Prime（小任务且低风险才自己来）；Hermes = 理解需求/派活/验收/部署/沉淀/进度播报（每 15-20 分钟报里程碑）。⑤ 记忆分层：Hermes memory 只留架构/方向/偏好，technical 细节全外包 Prime。⑥ 安全修复闭环：XSS/BQ/超收 3 项由 Prime 修 + Hermes 独立验证（Python 精确重测排除 bash 转义假象）→ 已部署上线。

Context: 15:20 用户提出「两个 Prime 防已知偏见」→ 采纳更省的「session 隔离盲审」（一个 agent 两种 session）；16:10-16:46 批次 1 双子任务实证成功（实施 5 条 🔴 优化 → 盲审抓到 P0×2+P1×2 → Hermes 修 7 处 → 部署 28/28 全绿）——双盲有效性第一次实证；16:04 驾驶模式 129 turns/$0.19 完成且自主 refine×1+compaction×1（自己沉淀技能）；17:12-17:38 daemon 修复（ELOCKED = proper-lockfile 旧 supervisor 刷新锁 + PRIME_AGENT_INTERNAL_DAEMON_WORKER=1 env 继承坑 → HOST 半残模式），修复后 send 端到端可用；17:59 PC 蓝屏重启 → catch-up 重派任务（-c 延续不丢记忆）+ 修自启动 lnk（旧 venv 路径 D:\hermes-agent\venv-py313 → 实际 D:\hermes\hermes-agent\venv）+ 新增 OpenClawGateway.vbs 静默自启动。

What changed: master app 批次 1 上线（收据入口/逾期筛选/地址填充/余额聚合/一键发票 + 盲审修复 7 处）+ Briefing 侧边栏入口上线 + 安全修复上线（logo 白名单 11 PDF route + BQ guard）；HSP00013 Mr Lee @ Kulai 项目夹（Template 完整结构）+ 建夹 SOP 强化（复制 Template 非简化版）；Mr Lee D1 客户补建（双写教训：Sheets 主档 + D1 必须双写）；VO-HSD00011-VO-001 草稿（Aluminium 移除 + Wardrobe L2130mm 加回）；Austin VO 需求（防水板 15mm×2 + swing door + 2735mm 板）；Mr Chen 三层记录（D1 project.remark + K10 + vault）；Vault daily 2026-08-10 已追加第二十三场。

2026-08-10: WhatsApp Business API 调研完成（只调研未实施，待用户决策）

Decision: 推荐 Meta Cloud API 直连（官方、免费托管、按条付费）作为主方案：月 500–2,000 条 → RM 43–173/月（2026-10-01 起 service 消息收费口径）。号码用新买 prepaid SIM 专号（RM 10–30，现有个人号码注册 API 须先注销个人绑定）。启动顺序：阶段 0 免费测试模式验证 → 阶段 1 企业验证（SSM）+ 真实号码 → 阶段 2 utility 模板自动化（报价/完工/收款通知）→ 阶段 3 webhook 跟进闭环 → 阶段 4 营销/LLM 客服。暂不引入 BSP 月费方案（Twilio $0.005/条无月费可作省心备选；360dialog €49/月对低量不划算）。

Context: 能力升级路线图 #4（装修业务顾客沟通自动化——跟进/报价送达/标签管理）。调研范围：Meta Cloud API vs On-Premises（2025-10-23 已停用出局）、BSP（Twilio/360dialog/Vonage）、非官方库（whatsapp-web.js 封号高风险不推荐）；马来西亚官方费率 Marketing $0.086/ 条 \approx R M 0.35 、 U t i l i t y / A u t h$ 0.014/条≈RM0.057（2026-07-01 生效，小量无折扣）；合规：MCMC 无专门 OTT 许可，但 PDPA 2024 修正案（2025-01 生效）要求 opt-in/DPO/泄露通知/最高罚 RM1M。

What changed: 报告 master-review/WHATSAPP_RESEARCH.md（20.4 KB，10 节）；关键发现：Hermes agent 已内置官方 Cloud API 集成（hermes whatsapp-cloud 向导 + 91 KB 适配器 + 20+ 测试，.env 未启用）→ 实施零开发，填 6 凭证 + cloudflared 隧道即可。路线图 #4 状态 → 🔄 调研已交付待用户决策。未注册/未付费/未实施。

Related: 能力升级路线图 2026-08-10

2026-08-10（补充调研）: WhatsApp 内置 AI（Meta Business Agent）vs Cloud API 对比结论

Decision: 内置 AI（Business App 版 Meta Business Agent）当前免费”够用”但覆盖不了主动跟进/报价 PDF/数据同步/批量消息 4 类核心工作流 → 保留 Cloud API 立项（原决策不变）；内置 AI 继续零成本跑”应答层”直到 Meta One 商业定价公布。新增认知：内置 AI 与 Cloud API 是同一品牌两条产品线，非替代关系；API 版 Agent（Agent Platform）2026-08-01 起已按 token 计费（$2/1M tokens ≈ 4–5 美分/条，不含 72h 免费窗口）。

Context: 能力升级路线图 #4 补充（主人反馈”内置 AI 够用，是否还需 API”）。官方确认：Meta Business Agent 2026-06-03 全球发布（含马来）；App 版能力=自然对话/产品推荐/预约/线索收集/转人工，Knowledge=文档/图片/示例回复/从对话学习；触发规则 4 选项（全部被动）；免费限额内免费，超额需 Meta One 订阅或等刷新，“coming months” 全面转付费。App 硬限制：不能主动发消息（仅模板消息可，App 无此能力）、广播 ≤256 且需对方保存号码、无 webhook、记录只在手机、知识管理仅主设备。

What changed: 报告 master-review/WHATSAPP_BUILTIN_AI_VS_API.md（21.7 KB，10 节：结论速览/两案详解/15 维度对比表/成本对比/主人场景匹配/升级检查清单/三阶段路径/时间线警示/数据来源/待决项）。成本结论：月 1,000 条 AI 回复，内置 AI RM0（限额内）→官方 Agent RM164–205 →自研 Claude RM139–425；主动模板消息 RM0.057/条（工具类）≈ 很便宜。10-01 起 service 消息按条计费，10 月前上线 API 可最大化免费窗口。未注册/未付费/未实施。

2026-08-10 · WhatsApp 实施准备启动（主人批准）

决策：主人批准启动 WhatsApp Cloud API 实施准备；出实施蓝图（不注册不实施，注册是主人动作）。
蓝图结论（master-review/WHATSAPP_IMPLEMENTATION_BLUEPRINT.md）：
- 架构：双轨——Hermes 管 24h 窗口内对话（现成零开发）；master app Worker 管模板跟进发送（因 Hermes 适配器 Phase 5 模板消息未实现，源码核实）。
- 跟进规则：每周 1 次；回复→3 天后；未回→明天重试 ×5 → 转人工；高意向信号→转人工+通知主人；wa_handoff 开关保证不抢话。
- 成本：50-200 顾客每周跟进 RM 12–50/月 + 10-01 后对话回复 RM 34 ≈ 总计 RM 47–84/月（直连为 BSP 的 1/3-1/10）。
- 注册 9 步（主人）：新 SIM → 开发者账号 → 应用 → WABA/测试模式 → SSM 企业验证 → 号码注册 → 凭证+向导 → cloudflared+webhook → 永久 token。
待主人确认 3 项：模板语言（中/马/双语）、跟进频率默认（周 1 次+5 次停）、高意向默认动作（Hermes 答报价 vs 仅通知）。

HS Knowledge Vault

探索

2026-08-06-10

Decision Log — 2026-08-06-10(6-10日)

2026-08-10 Vault 清理执行（主人批准）

Decision Log — Important Decisions & Rationale

2026-08-10（23:19）: 展示视频用 Windows 版 ffmpeg（winget 已装 8.1），脚本自动探测+路径转换

2026-08-06（下午）: 多平台视频发布定版 — 小红书/抖音禁 CDP + 先传后发批量策略

2026-08-06（早上）: blog 扩写全自动方案定案 + 子代理批量执行模式（并发 3 / 600s 超时接手）

2026-08-06（早上）: Purchase List 集成进工程排期 + 顾客/承包商双版本设计

2026-08-06（凌晨）: hsdesign.biz 首次访问自动检测浏览器语言（三语自动适配上线）

2026-08-06（凌晨）: 不换动态网页（静态 SSG 对 organic search 零劣势）+ SEO 内容优化 round 1 + backlink 渠道取舍 + H: 盘失效走 Drive API

2026-08-06（上午-下午）: computer use 视觉方案定版（Window MCP 主力 + UI-TARS-7B 兜底；Qwen2.5-VL 弃用）+ 模板不可擅改规则 + 排期 PDF 必须原生甘特图

2026-08-06（晚上）: 平台操控工具优先级定稿（CDP → Window MCP → computer use；旧「抖音/小红书禁 CDP」约定作废）+ 抖音验证码流程定案

2026-08-07（凌晨）: 三机舰队建成 — sleep 代替 shutdown + 局域网 WOL 死路改 RTC/智能插座 + 算力池分配写死

2026-08-07（上午）: WoWLAN 结论修正 — MSI 真睡眠 WiFi WOL 不可用（假阳性证伪）+ IDA 免登录远程控制验证通过 + RTC 落地

2026-08-07（上午-中午）: MSI 风扇远程控制 = 硬件封闭定案 + 文件通道 SMB→HTTP 直传 + Drive 挂载零传输约定

2026-08-07（深夜）: BQ 正式引入报价流程 + Master APP BQ 模块（两种模式）+ 部署根因链锁定

2026-08-08（上午）: BQ 部署终获成功 — GitHub research 突破 + 一键部署脚本（长期主义落地）

2026-08-08（上午）: Briefing Form 上线 + 语言策略定版 + Agreement→Receipt/Progress Claim 调整

2026-08-08（中午）: PDF 全系列统一（teal/纯英文基准）+ 数据编码根因 + Receipt/PC/VO/Checklist 上线 + Mr Chen 超额处理 + Pulai Flora 成交

2026-08-08（下午）: Official Receipt 马来西亚合规升级（金额大写 + 公司印章）+ 收款流程定版 + 地址 SSOT 确认

2026-08-08（深夜）: PDF 根因定案 — Telegram 同名快取 → 重发必须换新档名

2026-08-09（凌晨）: IDA PC WinRM 远程关机 — 执行链定版

2026-08-09（中午）: 成交升级 SOP 全链定版（D1 编号 + 云端夹 + PDF 三处同步）+ 知识沉淀原则（vault 图谱 > agent memory）

2026-08-10（凌晨）: Ambience 零 markup 定版 + Buildsmart 双向关系 + bullet 输出铁律 + 签名盖章 8 模板统一

2026-08-10（中午）: Prime Agent 协作模式定版（互补非竞争 + 3 步验证 + 配额校准实验）+ P0 安全事件处置（hsdesign.biz 泄露 CF Token）

2026-08-10（下午）: Master App 安全审查 6/6 全部验证属实（P0 XSS 链 / P1 BQ notIn 误删 / P1 全 API 无鉴权），修复方案待拍板

2026-08-10（晚）: 双子任务双盲流水线定版 + 驾驶模式上限发现 + 域 session 机制（Prime 协作模式 v2）

2026-08-10: WhatsApp Business API 调研完成（只调研未实施，待用户决策）

2026-08-10（补充调研）: WhatsApp 内置 AI（Meta Business Agent）vs Cloud API 对比结论

2026-08-10 · WhatsApp 实施准备启动（主人批准）

关系图谱

目录

反向链接

HS Knowledge Vault

探索

2026-08-06-10

Decision Log — 2026-08-06-10(6-10日)

2026-08-10 Vault 清理执行（主人批准）

Decision Log — Important Decisions & Rationale

2026-08-10（23:19）: 展示视频用 Windows 版 ffmpeg（winget 已装 8.1），脚本自动探测+路径转换

2026-08-06（下午）: 多平台视频发布定版 — 小红书/抖音禁 CDP + 先传后发批量策略

2026-08-06（早上）: blog 扩写全自动方案定案 + 子代理批量执行模式（并发 3 / 600s 超时接手）

2026-08-06（早上）: Purchase List 集成进工程排期 + 顾客/承包商双版本设计

2026-08-06（凌晨）: hsdesign.biz 首次访问自动检测浏览器语言（三语自动适配上线）

2026-08-06（凌晨）: 不换动态网页（静态 SSG 对 organic search 零劣势）+ SEO 内容优化 round 1 + backlink 渠道取舍 + H: 盘失效走 Drive API

2026-08-06（上午-下午）: computer use 视觉方案定版（Window MCP 主力 + UI-TARS-7B 兜底；Qwen2.5-VL 弃用）+ 模板不可擅改规则 + 排期 PDF 必须原生甘特图

2026-08-06（晚上）: 平台操控工具优先级定稿（CDP → Window MCP → computer use；旧「抖音/小红书禁 CDP」约定作废）+ 抖音验证码流程定案

2026-08-07（凌晨）: 三机舰队建成 — sleep 代替 shutdown + 局域网 WOL 死路改 RTC/智能插座 + 算力池分配写死

2026-08-07（上午）: WoWLAN 结论修正 — MSI 真睡眠 WiFi WOL 不可用（假阳性证伪）+ IDA 免登录远程控制验证通过 + RTC 落地

2026-08-07（上午-中午）: MSI 风扇远程控制 = 硬件封闭定案 + 文件通道 SMB→HTTP 直传 + Drive 挂载零传输约定

2026-08-07（深夜）: BQ 正式引入报价流程 + Master APP BQ 模块（两种模式）+ 部署根因链锁定

2026-08-08（上午）: BQ 部署终获成功 — GitHub research 突破 + 一键部署脚本（长期主义落地）

2026-08-08（上午）: Briefing Form 上线 + 语言策略定版 + Agreement→Receipt/Progress Claim 调整

2026-08-08（中午）: PDF 全系列统一（teal/纯英文基准）+ 数据编码根因 + Receipt/PC/VO/Checklist 上线 + Mr Chen 超额处理 + Pulai Flora 成交

2026-08-08（下午）: Official Receipt 马来西亚合规升级（金额大写 + 公司印章）+ 收款流程定版 + 地址 SSOT 确认

2026-08-08（深夜）: PDF 根因定案 — Telegram 同名快取 → 重发必须换新档名

2026-08-09（凌晨）: IDA PC WinRM 远程关机 — 执行链定版

2026-08-09（中午）: 成交升级 SOP 全链定版（D1 编号 + 云端夹 + PDF 三处同步）+ 知识沉淀原则（vault 图谱 > agent memory）

Related: 2026-08-09 Company_Graph CashflowApp_Graph Quotation_System johor-curtain-suppliers

2026-08-10（凌晨）: Ambience 零 markup 定版 + Buildsmart 双向关系 + bullet 输出铁律 + 签名盖章 8 模板统一

2026-08-10（中午）: Prime Agent 协作模式定版（互补非竞争 + 3 步验证 + 配额校准实验）+ P0 安全事件处置（hsdesign.biz 泄露 CF Token）

2026-08-10（下午）: Master App 安全审查 6/6 全部验证属实（P0 XSS 链 / P1 BQ notIn 误删 / P1 全 API 无鉴权），修复方案待拍板

2026-08-10（晚）: 双子任务双盲流水线定版 + 驾驶模式上限发现 + 域 session 机制（Prime 协作模式 v2）

2026-08-10: WhatsApp Business API 调研完成（只调研未实施，待用户决策）

2026-08-10（补充调研）: WhatsApp 内置 AI（Meta Business Agent）vs Cloud API 对比结论

2026-08-10 · WhatsApp 实施准备启动（主人批准）

关系图谱

目录

反向链接