长期记忆档案（速查版）

目录

1. 全局原则
2. 核心规范文件索引
3. 用户与渠道速查
4. 关键路径
5. 文件写入策略
6. 旅游攻略系统
7. 网页抓取工作流
8. 定时任务系统
9. 技术栈与默认能力
10. 更新日志

一、全局原则

1.1 输出与风格

• 回复语言：中文
• 回复风格：冷静、理性、有用；少空话，直接解决问题
• 用户偏好格式：emoji 丰富、消息推送优先 Markdown（可用表格、分隔线）

1.2 本地优先

• 浏览器自动化优先 xbrowser
• MCP 场景先走 mcporter

1.3 记忆使用规则

二、核心规范文件索引

三、用户与渠道速查

3.1 用户偏好

• 格式风格：emoji 丰富
• 前端工作流：ui-ux-pro-max 负责规划 → frontend-design 负责视觉规范（配色+字体+动效方向）→ Node.js builder 负责代码拼接
• 消息推送格式：Markdown
• 旅游攻略发送规则：QQ 文字版必须一次性发送全部内容，禁止分段发送

3.2 渠道身份

四、关键路径

4.1 工作区结构

C:\Users\Administrator\.qclaw\
├── workspace\
│   ├── 01_系统配置\          # 系统配置文件
│   ├── 02_定时任务\          # 定时任务脚本
│   ├── 03_文档资料\          # 模板/规范文件
│   ├── 04_脚本工具\          # 工具脚本
│   ├── 05_提取数据\          # 采集数据
│   ├── memory\              # 每日记忆日志 + LanceDB
│   ├── sessions\            # 会话存储
│   ├── skills\              # 自定义技能
│   └── tmp\                 # 临时文件
├── cron\jobs.json           # cron 注册表
└── openclaw.json            # 主配置

4.2 发布目录

五、文件写入策略（强制）

5.1 总则

• 最终目标文本文件：必须遵守 qclaw-text-file 规则
• write 工具：只允许写临时文件，不直接写最终文本目标文件
• Windows 下要注意编码、BOM、CRLF/LF

5.2 已知高风险点

5.3 通用执行方案

5.4 禁止事项

• 不要用 write 直接写大型最终 HTML
• 不要在 PowerShell 里内联长段 Python/Node 代码
• 不要在失败后手工补残缺文件，应整文件重写

六、旅游攻略系统

6.1 系统状态

• 状态：已定型、自动运行
• 推送时间：每天 07:00
• 推送渠道：QQ

6.2 四季目的地库（当季推荐）

6.3 发布信息

• HTML 发布目录：C:\IISWork\Sm\wwwroot\travel\
• 访问链接模板：http://sm.xxxxxxxxx.cn/travel/travel-{地名拼音}.html
• 文件命名规则：不能含中文；如北京 → travel-beijing.html

6.5 双产物工作流

用户请求
  ↓
读取 travel_qq_template.md
  ↓
生成 QQ 文字版（10模块）攻略
  ↓
发送到 QQ（必须一次性发送全部内容，禁止分段）
  ↓
用户是否说"转"
  ├─ 否：结束
  └─ 是：进入 HTML 版
          ↓
          同时读取 travel_html_template.md + visual_standards_executable.md
          ↓
          【第一层】ui-ux-pro-max：规划信息架构与模块顺序
          ↓
          【第二层】frontend-design：确定视觉风格与配色方案
          ↓
          【第三层】Node.js builder：拼接代码、注入特效、写入文件
          ↓
          返回访问链接

三层分工定义

frontend-design 与 visual_standards_executable.md 关系：

• frontend-design 是通用设计能力，输出视觉规范建议（不输出代码）
• visual_standards_executable.md 是旅游攻略专用执行手册，定义固化特效池、配色库、随机规则
• 旅游攻略场景下：frontend-design 只提供视觉方向建议，具体配色从50套固化库选，特效从115个固化池随机抽
• 非旅游场景：frontend-design 可直接输出完整 HTML/CSS/JS，不受 visual_standards 限制

关键规则：

1. ui-ux-pro-max 不输出代码，只输出结构规划
2. frontend-design 不输出完整HTML，只输出视觉层规范（CSS变量、配色、字体、关键帧）
3. Node.js builder 负责所有代码拼接，按结构规划组装模块，按视觉规范应用样式，按特效规范注入P0/P1/P2

6.6 HTML 版执行规则

1. QQ 版与 HTML 版完全独立
2. HTML 版必须同时遵循：
• travel_html_template.md（内容结构）
• visual_standards_executable.md（视觉特效）
3. 内容完整性优先：17个业务模块必须齐全，视觉服务于内容，不做"好看空壳"
4. 三层工作流固定：
• 第一层 ui-ux-pro-max：输出结构规划（模块清单+顺序）
• 第二层 frontend-design：输出视觉规范（配色+字体+动效方向）
• 第三层 Node.js builder：拼接代码、注入特效、写入文件
5. 写入 HTML 时默认使用 Node.js builder
6. 含大量 emoji / 大段内联 CSS / JS / Canvas 时，直接 Node.js 起步
7. 仅当 builder 脚本接近上限时，才拆成多段 .cjs
8. 图片本地化（强制）：HTML 版所有图片特效统一从 C:\IISWork\Sm\wwwroot\travel\img\ 取本地图片，禁止从 web 爬取图片
9. P2 安全规则（强制）：P2 Canvas 特效允许使用 position:fixed，但必须同时设置 pointer-events:none；禁止不带 pointer-events:none 的 fixed 定位

七、网页抓取工作流

7.1 标准链路

Step 1: online-search → 发现数据源 URL（无需展示）
        ↓
Step 2: Scrapling Fetcher.get(url) → 采集文字内容
        ↓ 失败或强反爬
Step 3: StealthyFetcher(real_chrome=True) → JS 渲染 + 懒加载图片
        ↓
Step 4: 提取正文与图片

7.2 工具选型

7.3 关键规则

• 马蜂窝必须用 wait_until='domcontentloaded'
• 文字内容：从网页抓取正文文本
• 图片内容：HTML 页面图片统一用本地库 C:\IISWork\Sm\wwwroot\travel\img\，不从 web 爬取图片
• 抓取脚本与最终 HTML 写入脚本不要混成一个超长文件
• 所有抓取请求超时 = 10 秒（10000 毫秒）
• 同一 URL 最多重试 3 次，失败则跳过

九、技术栈与默认能力

旅游 HTML 实现工作流：

• ui-ux-pro-max：结构规划（模块顺序+交互逻辑）
• frontend-design：视觉规范（配色+字体+动效方向）
• Node.js builder：代码拼接（模块组装+特效注入+文件写入）

十、更新日志