Data Integrity Audit

在执行任何数据修改操作前，必须执行以下流程。

触发条件

当用户提出以下类型的需求时强制触发：

• "把XX改成XX"
• "XX数据不对，改一下"
• "修正XX"
• "更新XX数据"
• 任何涉及修改数值/名称/时间/排名/状态的请求
• 关于公司/产品信息的核实请求

标准工作流程

Step 1：确认修改意图

用两条原则确认：

1. 以用户确认为准。如果用户说"改成XX"，以他说的为准，不做推断。
2. 问清楚范围。"只改这一个文件还是所有文件？"

如果用户没有明确说"全改"，默认全改。但先确认。

Step 2：全库扫描旧数据

使用Node.js脚本或grep搜索所有出现该数据的地方：

const fs = require('fs');

function scan(dir, pattern, callback) {
  const items = fs.readdirSync(dir);
  items.forEach(item => {
    const fp = dir + '/' + item;
    try {
      const stat = fs.statSync(fp);
      if (stat.isDirectory()) {
        // 跳过 node_modules, .git, .openclaw 等
        if (!item.startsWith('.') && item !== 'node_modules') scan(fp, pattern, callback);
      } else if (/\.(md|html|js|py|json|yaml|yml|txt|docx?|xlsx?)$/i.test(item)) {
        if (!/\.(xlsx?|docx)$/i.test(item)) {
          const c = fs.readFileSync(fp, 'utf8');
          let idx = -1;
          while ((idx = c.indexOf(pattern, idx + 1)) !== -1) {
            callback(fp, idx, c.substring(Math.max(0, idx-20), idx + pattern.length + 30));
          }
        }
      }
    } catch(e) {}
  });
}

scan('WORKSPACE_PATH', 'TARGET_DATA', (f, i, ctx) => {
  console.log(f.replace('WORKSPACE_PATH', ''), '@', i, ':', ctx);
});

搜索范围必须包括：

• MEMORY.md
• memory/ 目录所有日常记录
• 培训课程/ 目录所有HTML和MD
• 02_projects/ 目录所有文档
• reports/ 目录
• 知识库综合文件
• 所有HTML生成文件

Step 3：比对公开数据平台

当涉及公司公开数据（名称、数量、排名、评级等），必须比对以下平台确认最新性：

时间线规则：

• 收集每一条数据的"发布时间"或"数据截止时间"
• 以最新的时间戳为准
• 如果用户说"以我修改的为准"，无条件服从用户
• 如果官网和用户数据冲突，优先用户数据，并在备注中标注"用户确认"

Step 4：一次性全量修正

不要只改一个地方。用全局替换脚本一次性改所有文件：

const fs = require('fs');

function replaceAll(dir, oldStr, newStr) {
  let count = 0;
  const items = fs.readdirSync(dir);
  items.forEach(item => {
    const fp = dir + '/' + item;
    try {
      const stat = fs.statSync(fp);
      if (stat.isDirectory()) {
        if (!item.startsWith('.') && item !== 'node_modules') count += replaceAll(fp, oldStr, newStr);
      } else if (/\.(md|html|js|txt|json|yaml)$/i.test(item)) {
        const c = fs.readFileSync(fp, 'utf8');
        const nc = c.split(oldStr).join(newStr);
        if (nc !== c) { fs.writeFileSync(fp, nc); count++; }
      }
    } catch(e) {}
    return count;
  });
}

Step 5：验证无残留

修正后再次搜索旧数据关键词，确认结果为零：

const count = fs.readdirSync(workspace, {recursive:true})
  .filter(f => /\.(md|html|js|txt)$/i.test(f))
  .reduce((sum, f) => {
    const c = fs.readFileSync(f, 'utf8');
    return sum + (c.split('OLD_PATTERN').length - 1);
  }, 0);
console.log('残留数量:', count);

Step 6：更新记忆文件

将修改记录写入当天的 memory/YYYY-MM-DD.md：

• 什么数据被修改了
• 修改了哪些文件（数量）
• 新旧值的对比
• 为什么修改

Step 7：清理临时脚本

# 清理以 _ 开头的零时Node.js/Python脚本
Remove-Item *_*.js, *_*.py

常见错误模式（避免！）

脚本模板

scripts/scan_and_replace.js - 全库搜索+替换一体化工具。用法：

node scripts/scan_and_replace.js OLD_STRING NEW_STRING