AIClaw

AIClaw 记忆写入流程为：先在目标旁临时目录写入临时文件，再次检查快照，然后将新文件重命名到位，最后清理临时目录。

AIClaw 记忆保存采用乐观并发控制：编辑器携带最初读到的内容快照，宿主写入前比对当前内容，不一致则保存失败并提示刷新，界面保留草稿。

AIClaw 的 Memory 页面展示两类记忆：全局记忆通常位于 ~/.aiclaw/memory.md，工作区记忆位于工作目录下的 .aiclaw/memory.md。

AIClaw 记忆文件单文档保存上限为 32 KiB（按 UTF-8 字节计算），与桌面内核的记忆加载上限一致。

AIClaw 宿主在写入记忆前会拒绝符号链接形式的记忆文件，并拒绝空字符和超限内容。

在 AIClaw 的 Memory 页面保存记忆只更新磁盘文件，不会直接重建当前对话的系统提示词；记忆在打开或恢复会话时加载。

AIClaw 公开的文件系统测试覆盖了缺失文件、读取错误、文本保留、UTF-8 容量、冲突、空文件保存和受保护路径；符号链接测试在 Windows 上被显式跳过。

AIClaw 的 MemoryView 组件区分“文件不存在”和“读取失败”：缺失的记忆文件可通过编辑创建，读取错误则显示为错误而非空记忆。

在 AIClaw 的记忆编辑器中，条目边界规则为：以连字符或星号开头的行启动一个新条目，后续行归入该条目，这是文本分组而非完整的 Markdown 文档模型。

AIClaw 的 Memory 编辑写入路径由主进程解析：全局路径从应用配置解析，工作区路径从归属的非归档会话解析工作目录后拼接固定记忆路径；渲染进程不选择任意目标文件名。

对已有 ZIP 用户，迁移到安装器版本需要手动下载 setup 可执行文件并安装，旧解压目录不会被自动删除。

安装器替换应用文件，但设置、聊天记录、全局应用数据和记忆保持原有的用户数据位置，安装器不会将其移入程序文件夹。

AIClaw 的更新器拒绝从开发模式安装；仅有 ZIP 的 release 会回退到之前的“下载并打开文件夹”行为。

当校验和条目缺失或摘要不匹配时，AIClaw 不会打开安装器，且应用保持运行。

AIClaw 的更新器不会传递静默安装标志，其“成功”定义为安装器已启动而非安装已完成。

AIClaw 当前安装器没有 Authenticode 签名，因此 Windows 可能显示未知发布者警告。

AIClaw 的 smoke 测试脚本在 Windows runner 上安装到含空格的临时路径，检查应用文件，修改程序文件为过期 fixture 后重装验证替换，并在两个用户数据位置放置哨兵文件检查安装、重装和卸载后的数据保留。

AIClaw 的 SHA256SUMS.txt 格式为每行“摘要 + 两个空格 + 文件名”，源自 GNU coreutils 的 sha256sum 工具。

AIClaw v3.7.15 的更新流程包含四个步骤：检查 GitHub 最新 Release、下载 Windows 安装器到临时目录、下载 SHA256SUMS.txt 并比对摘要、请求 Windows 打开安装器并退出应用。

AIClaw 的校验和比对只验证下载文件与 release 提供的摘要一致，不独立证明发布者身份，真正的信任锚点是发布渠道（GitHub Release 页面）本身。