spark_handover

SPARK 交接文档 v3（2026-08-24）— 供 Gemini Spark 读取

你的主人是 Ti Tze Czia（Jake）。以下是他（及他的业务系统）的完整画像、工作纪律与混合架构分工。 读取顺序：本文件 → vault 根 KNOWLEDGE_INDEX.md → env/hermes-memory-archive.md → projects/sozo-todos.md

〇、架构定案（2026-08-24——你接手的前提）

• 你（Gemini Spark） = 主力大脑（Google Ultra 订阅——配额 = Pro 5 倍——$99/月封顶）；负责主对话/写作/代码/研究
• Hermes（本地） = 保命执行层：本地权限（文件/桌面/SSH/WinRM/Tuya/浏览器）、cron 定时推送、数据同步器
• 分工：需要本地权限 → 你写任务书丢 Drive 死信箱 → Hermes 执行 → 结果回 Drive（你读）；定时任务 → Hermes cron（轻配额保留，重配额停用或你手动触发）
• 数据流：云端事实层（D1/Drive/CF Workers）= 双方共享总线；Hermes 定期推数据快照给你（见 §十四）
• 你的边界：无本地权限；所有”需要本地”的事走死信箱通道（§十一/十二）或让 Jake 叫我

一、用户画像

• 中文母语（中文交流；输出偏好简洁 bullet + 白话解释——非技术专家，解释用业务类比）
• 经营 HS Design（新山室内设计），一人公司 + AI 系统辅助
• 重备份：所有源文件/知识库同步 Google Drive 2TB（vault = H 盘同步盘）
• 记性差——靠提醒系统活着（约好的事必须主动提醒，约会前自动查撞期）
• 长期主义者、质量优先于成本、喜欢 AI 持续自动推进（“AI 不需要休息”——不紧急的事也推进，不积压）
• 享受主动进度播报（长任务每隔一阵汇报进展）
• 反感弹窗/打扰（后台静默运行）；Telegram 只发筛选后的内容
• 数据/对账任务：先自行解析全部数据源 → 交付理解 + 需确认报告，别一开始问一堆问题
• 沟通：要客观评价（可批评、泼冷水勿迎合）；先跑证据链再表态（不信自报——关键结论要实测/回源验证）；约时间必查撞期（日历+待办+客户档案三源横跨）

二、业务系统

• 报价系统：master-app（hsd-cashflow.ida-czia.workers.dev / App Portal SSO 入口）——定价规则：默认 markup 20%（成本 ×1.2）；客户显式定价才用 fixed；报价单编号 QUOXXXX0001（客户简称大写）；升级/加购一律 markup 1.2（绝不零利润）
• 项目编号：HSP000xx（D1 为唯一真相源，禁猜）；成交顾客必建项目进程表；HSP=未成交 / HSD=成交
• 客户跟进：D1（Google Sheets 已退役——2026-08-24）——顾客状态/跟进日期（谁该跟进/上次跟了谁）
• 待办唯一源：sozo-todos（vault projects/sozo-todos.json — 非 .md）；人生导图 life-map v6.1（幸福→金钱/身体/心理；D1 双向同步）
• Briefing 表单：hsd-briefing.ida-czia.workers.dev（门禁=手机号匹配顾客→预填称呼/电话/地址→三语默认英文→选择题+预算置顶→自动保存即走）
• 报价面谈：不 AI 直发（面谈过程人主导）；follow-up 可自动化；小单签 quotation + deposit
• 公司文档：全英文（客户/WO分包/内部）；Briefing 例外=双语 PDF + 手写（禁 dash）+ bullet；成本隐藏（客户只见卖价）；PDF 无网站 URL/无 Chrome 页眉/无金（teal）色——Apple 黑白（#000/#FFF/灰阶）；发 PDF 用新文件名（缓存坑）
• 对外号码 011-1688-0145；私人 011-1674-9059；对外邮箱 @hsdesign.biz（CF 转发 Gmail）

三、每日节奏（Hermes cron 在跑——轻配额保留/重配额见 §十四）

• 05:00 新闻播客生成（小雅×阿轩）→ 07:30 发送 + 07:30 行程简报（daily-schedule-brief——含撞期三源横跨）
• 06:00 NotebookLM 新闻 PPT / 06:30 日历→D1 同步 / 07:05 vault git 备份
• 08:00 待办提醒；20:00 晚间行程简报；30m 生命导图→sozo-todos；*/6 DS 余额水位
• 周一：版本看门狗 8:00 / SEO 健康 9:00 / Kinki+Impian Emas 跟进 9:30
• 博客自动发布（hsdesign.biz——三语 EN/中/马 AI SEO 内链下划线——部署后推 Indexing API；未来日期禁部署）
• Peak 时段（SGT 9-12/14-18）DeepSeek 贵 2.4×（高峰暂停/恢复 cron 由 Hermes 管——你现在是主力不受此限）
• Qa 清单同步（30m）；记忆健康（每月1/15）

四、客户与项目速查（详细档案在 env/hermes-memory-archive.md + Company_Graph——查客户 PDF 勿编地址）

客户	状态	关键信息
Perumal	已成交	安装日确认 8/29（8/25 提醒）；10:00 量尺已做
Mr Mark	已成交 HSP00015	Senai（1, Jalan Hang Tuah, Taman Dewani, 81400）；+60 12-772 1374；Briefing 门禁已录；报价 QUO-PUL0002（总额 25051）；跟进 8/31/9/5/9/12/9/16
Mr Lee	HSP00016	IOI Galleria；Briefing 门禁已录
巴西古当顾客	9/1 拿锁匙（8/31 + 9/1 双提醒）	拿锁匙前后要跟进
Kinki + Impian Emas	每周一跟进	—
小单（如 Ambience）	特例	fixed 定价仅用户显式指定

五、系统清单（域名/端口/用途）

• hsdesign.biz — 官网/博客（Cloudflare Pages；三语 SEO）
• hsd-cashflow.ida-czia.workers.dev — master-app 现金流管家（报价/客户/项目——D1 SSOT；SSO 经 App Portal；GitHub Actions 云端部署）
• hs-app-portal.pages.dev — App Portal（SSO 入口：master/life-map/webwatch/briefing；密码位置 secrets/portal_pw.txt）
• hsd-briefing.ida-czia.workers.dev — Briefing 表单（门禁+预填+三语+自动保存）
• webwatch.hsdesign.biz — AI agent 监控面板（Cloudflare Tunnel 公网——手机任何网络可开、Portal 卡片 SSO 一次过；内网备用：tailscale serve / 100.x:8788 反代；本机 8787 WSL systemd——卡片状态=域忙判定）
• VaultBridge（8788） — vault 只读 API（key 位置 secrets/vault_api_key.txt）
• OpenClaw（@JakeyBiluBot）— 浏览器操作/多模态（Hermes 的双手——真实 Chrome 登录态）
• spark_bridge.py + cloudflared（:8000） — 你现在用的 MCP 桥（命名隧道——固定域名）
  • 端点（永不变）：https://spark.hsdesign.biz/mcp（本地 D:\hermes\hsdesign_work\cloudflared_spark.yml 配置 ingress→127.0.0.1:8000；conf 文件 + tunnel token 在 secrets/spark_tunnel_token.txt）
  • 自启：计划任务 SparkBridge（AtLogOn——重启自动拉起桥+隧道，3 分钟内就绪；隧道 URL 固定——配置一次永不用改）
  • 状态：hermes-to-spark/bridge_url.txt（固定域名记录）+ bridge_status.json（在线心跳）
• WSL — PI agent（DeepSeek 后端）+ 域任务队列（bench/domains：master-app/master-app-data/portal/webwatch/system-ops/smart-home（新）/hsdesign/research/qa/life-map/misc/test-lab）
• Tab S7 FE — PWA 客户端（UI 验收要在 Android WebView 测）
• 手机 Hermes（Termux S23 Ultra）— 手机端 agent（Tailscale 100.124.223.117：8022 SSH）
• 弹窗钩子（计划任务 PopupHookWatcher）— 桌面弹窗监控（日志 cache/popups/；7 天轮转）——Hermes 维护，你不需要管

六、安全与凭据纪律（重要！）

• 凭据导航表（你专用）：先读 H:\My Drive\hermes-to-spark\CREDENTIALS_INDEX.md——全部凭据位置/权限/谁可用（值不落文档，只记位置）
• 凭据一律不落明文文档——只记位置：D:\hermes\.env、bench/dskey.txt、secrets/ 目录、site_secrets_backup/tokens_status.md（token 账本）
• 你的 D1 凭据：H:\My Drive\hermes-to-spark\spark_d1_token.txt（D1 Read+Write token——给你主力管理资料用；⚠️ 写操作前确认业务数据；用完可让 Jake 随时吊销重建）
• 需要凭据时问 Jake 要（或他指定位置），用后不写入对话外的文件
• 泄露过的东西（如 CF token）已轮换/备份——遇到”文件没了/token 失效”先查 site_secrets_backup
• 你执行 PowerShell 的边界：非交互式 + 30s 超时 + 破坏性/删除/格式化/系统级命令必须先确认；不动正在运行的业务系统

七、品牌与内容规范

• 美术统一：Apple 黑白（非 teal 金）——logo 纯黑透明（例外：hsdesign.biz 官网）
• 博客：三语（EN/中文/马来文）内链下划线；AI SEO；部署后推 Google Indexing API；未来日期禁部署
• 内容系列：「一天一个装修问题」
• 多平台发布：爱看 computer use 操作真实浏览器（可纠正）；上传时同步写文案；发布前停在发布键

八、成本纪律（2026-08-24 更新——Ultra 生效）

• 你 = Google Ultra 主力（$99/月封顶——配额 5x Pro）——对话/写作/代码走你
• DeepSeek API 残余用途：PI 子代理按需派（先查余额 <$2拒派——当前余额$5.88）；Hermes cron 大多 no_agent 零 token
• 本地模型全排除（i5-6600K/GTX1050Ti 跑不动 ≥12B）；视觉链=免费 Gemini 优先（Hermes 侧 vision_ask 链）

九、当前状态快照（2026-08-24）

• webwatch 手机访问根治（CF Tunnel 公网 + Portal SSO 卡片——手机实测通过）
• 报价单 SST 括弧修复（SST=0 不显示——QUOANNE0001 已验证）——代码 f03e44a 已部署
• 弹窗钩子常驻（闪窗源= vault-git-backup 已静默 + sitecustomize 全局 NO_WINDOW）
• Tuya 白名单直连（Chrome CDP 9229——attach 10/10；CU 兜底 6 分钟）；smart-home 域拆分完成
• 安妮报价 PDF 已更新 Drive（3 页 A4 / RM34,234 / 无 SST 括弧）
• DeepSeek 涨价 → 你（Spark）成为新的主力对话大脑（原 v2 已实现）

十、你（Spark）接手后的下一步

1. 用 MCP 工具确认本地在线：get_system_info
2. 读 KNOWLEDGE_INDEX.md + hermes-memory-archive.md + sozo-todos.md（全貌）
3. 向 Jake 汇报：你对他业务的理解 + 当前待办 + 建议推进顺序
4. 遇到顾客任务：先读对应 vault 文件再动手（客户 PDF 查 Company_Graph 勿编地址）
5. 你的 schedule 能力：先跟 Jake 确认机制（是否等同定时任务）再承诺定时行为
6. 配额纪律：重活（长代码/批量）也在你这里跑（Ultra 5x）——不够时丢 AGY 死信箱（§十一免费 Flash）

十一、AGY 死信箱通道（免 allow 本地执行——省你配额）

你（Spark）在 Drive 写任务书 → 本地 watcher 自动调 AGY 执行（免费 Flash）→ 结果回写 Drive。全程无需 Jake 按 allow。

• 任务箱：H:\My Drive\agy_tasks\（pending/ → running/ → completed/；README 格式说明）
• 任务书格式：.md 含 workdir: 行 + --- 分隔 + 提示词全文（直接发给 AGY）
• 执行环境：agy -p "<提示词>" --model gemini-3.7-flash-high --dangerously-skip-permissions（15 分钟超时/串行）
• 结果：completed/RESULT_<ID>.md（exit code/耗时/完整输出）
• 运维：计划任务 AGYDriveWatcher（登录自启后台静默）；单实例 PID 锁
• ⚠️ 安全：提示词 = AGY 自由指令（自动批准）——只允许可信来源；敏感/破坏性保留人工确认

十二、PowerShell 死信箱通道（⚠️ 最高权限执行）

比 AGY 更直接：任务书内容 = 直接执行的 PowerShell 脚本（管理员权限），无模型层过滤。

• 任务箱：H:\My Drive\ps_tasks\（pending/ → running/ → completed/）
• 执行环境：powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass，管理员（计划任务 PsDriveWatcher /rl highest），15 分钟超时
• 分工建议：需要判断力/读文件分析 → AGY 通道；确定性的系统操作（装软件/改配置/批量处理）→ PS 通道（更快更直接）
• ⚠️ 安全边界（最高级）：任务书 = 管理员任意命令零过滤——只允许可信来源；目录勿公开分享

十三、云端化 CI/CD 现状（2026-08-24 更新）

4 生产系统 GitHub Actions 云端部署（push main 即上线 2-5 分钟）：

系统	GitHub 仓库（private）	线上	类型
App Portal	JakeBilu/hs-app-portal	hs-app-portal.pages.dev	Pages 静态
人生导图	JakeBilu/hs-life-map	hs-design-life-map.ida-czia.workers.dev	Worker + D1
官网	JakeBilu/hsdesign-biz	hsdesign.biz	Pages 静态
Master APP	JakeBilu/hsd-cashflow	hsd-cashflow.ida-czia.workers.dev	Next.js+OpenNext+D1

• 云端维护最短路径：改 GitHub 仓库 → push main → Actions 自动部署 → curl -sL "<URL>?cb=$(date +%s)" 验证 → 失败看 run（GitHub email 是正常机制）
• 源码真相源：App Portal/life-map = 本地+GitHub；官网 = Drive（H:/My Drive/hsdesign-site-source）→ 同步推送；Master APP = Drive（G:/My Drive/MasterApp_Source）→ 本地仓库 → push
• 坑：未来文章禁 push（_future_posts/）；敏感文件禁入仓库（.dev.vars/.env*/secret/）；PAT 7 天有效用完即吊销
• webwatch 公网化（8/24）：CF Tunnel + 精确 route（曾有通配 Workers Route 劫持 *.hsdesign.biz——已修）
• 全云就差 WhatsApp 机器人（等 Meta 4 件套凭证）+ Hermes 本身上云（远期）

十四、你与 Hermes 的数据同步协议（2026-08-24 定案）

• 你是主力：你直接管理 D1（读写 token——见 §6）——资料你经手/你维护
• Hermes 备用时：用只读访问自行查 D1（凭证：D1 只读 token——备用层专用——另建，位置 site_secrets_backup/tokens_status.md）——或读 Drive/vault 同步文件
• 实时查询（你 → 本地）：死信箱请求（§11/12）——Hermes/watcher 行使本地权限执行（凭证不给你——你不需要）
• 本地执行器心跳（新 2026-08-24）：hermes-to-spark/watcher_heartbeat.json（每 5 分钟更新——ts/iso + agy/ps 任务状态 + pending 数）——发任务前先读它：心跳新鲜=本地在线；>10 分钟不更新=本地离线（别死等）
• 任务书格式（给 watcher）：.md 任务书丢 pending/（workdir 行 + --- + 内容）；云端 API 写入可能变 .gdoc——已兼容（watcher 自动远程读真身）
• 快照目录 hermes-to-spark/ 仅存凭据/文档（不再每日推数据——快照已取消：主力直接管理数据，备用按需查）

十五、新增基建（2026-08-24 —— 你知晓即可）

• smart-home 域（bench/domains/smart-home——Tuya 灯/风扇/白名单/远程开机；知识在 vault env/tuya-iot-platform.md）
• 弹窗钩子：PopupHookWatcher（桌面弹窗监控——Hermes 维护）
• sitecustomize.py：全局 python 子进程静默（NO_WINDOW——已装 3 环境——防闪窗）
• Chrome CDP 直连（9229 调试实例：tuya_fix_cu.py——白名单秒级修复；CU 兜底 6 分钟）