核心功能
Clawdbot Workspace Template Review 是一款面向 Clawdbot 用户的配置同步诊断工具，专用于解决版本升级后的配置漂移问题。其核心流程为：定位官方模板目录 → 逐文件对比工作区配置 → 输出差异报告 → 建议补全方案。
显著优点
- 精准定位：支持 npm/pnpm 全局安装与源码运行两种部署模式，自动解析 Clawdbot 根目录
- 智能过滤：自动忽略 frontmatter、引导区块等噪音，聚焦实质配置差异
- 结构化输出：采用"文件路径-缺失区块-操作建议"三段式报告，便于批量决策
- 非侵入式：仅读取对比，不主动修改用户配置，风险可控
潜在局限
- 依赖文件系统访问：需具备读取 Clawdbot 安装目录及工作区的权限
- 模板路径硬编码：假设模板位于
docs/reference/templates/，若官方目录结构调整将失效 - 无自动合并：仅输出差异清单，执行补全需人工确认
- 版本匹配盲区：无法检测模板本身是否为用户期望的版本（如用户刻意降级）
适合人群
- 刚完成 Clawdbot 升级且不确定配置兼容性的用户
- 维护多个工作区、需批量稽核配置一致性的团队
- 从旧版本迁移至新版本的跨版本升级场景
常规风险
- 权限不足：若 Clawdbot 以 root 安装而普通用户运行，可能无法读取模板
- 路径误判：自定义安装路径或符号链接可能导致模板定位失败
- 误判有效差异：用户故意删减的区块可能被标记为"缺失"，需人工甄别
使用建议
建议在重大版本升级后例行运行，结合 diff -u 输出进行代码审查式确认，避免盲目合并。