cc-switch OpenClaw Workspace 与 Daily Memory 实战指南九个工作区文件与日期日志的完整管理【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch本篇基于 cc-switch 官方文档 3.5 Workspace Files Daily Memory 展开讲解 Workspace 面板中九类 OpenClaw 工作区 Markdown 文件的编辑、状态识别与保存机制以及 Daily Memory 日期日志系统的列表、创建、全文搜索与删除流程。读完本文你既能熟练使用这两个功能完成日常配置与记忆维护也能顺着前端组件与 Tauri 命令追溯到~/.openclaw/workspace/目录下的实际读写实现。一、功能定位Workspace 面板只服务于 OpenClawWorkspace 面板是 cc-switch 面向 OpenClaw 应用提供的文件管理与每日记忆Daily Memory功能入口。当应用切换器选中 OpenClaw 时导航栏会出现 Workspace 按钮点击后主区域渲染 WorkspaceFilesPanel 组件这一路由关系在 App.tsx 的case workspace分支中定义第 1082 行附近。需要注意的适用前提该功能只出现在 OpenClaw 上下文中其他应用Claude Code、Codex 等不会显示 Workspace 入口Workspace 管理的是~/.openclaw/workspace/下的Markdown 文件体系Agents 定义、人格、身份等与同目录下openclaw.json中由 openclaw_config.rs 管理的供应商/模型 JSON 配置是两套独立的体系互不覆盖。面板顶部还显示目录路径~/.openclaw/workspace/点击它会调用open_workspace_directory命令在系统文件管理器中打开该目录目录不存在时先自动创建方便你直接用外部编辑器操作同一批文件。二、Workspace Files九个工作区文件2.1 存储位置与路径解析所有工作区文件统一存放在~/.openclaw/workspace/下。后端路径由 openclaw_config.rs 的get_openclaw_dir()解析默认取~/.openclaw若用户在设置中配置了openclaw_config_dir覆盖项见 settings.rs 第 426 行附近的openclaw_config_dir字段则以覆盖目录为准。Workspace 各命令再在其后拼接workspace及memory子目录。2.2 受管文件清单与白名单校验cc-switch 管理 9 个工作区文件每个文件有明确职责前端在 WorkspaceFilesPanel.tsx 的WORKSPACE_FILES常量中注册了文件名与图标文件用途AGENTS.mdAgents 定义与配置SOUL.md系统灵魂/人格设定USER.md用户画像信息IDENTITY.md身份与角色定义TOOLS.md可用工具配置MEMORY.md系统记忆HEARTBEAT.md心跳Heartbeat配置BOOTSTRAP.md引导Bootstrap序列BOOT.md启动配置这 9 个文件名并非仅在前端硬编码后端 commands/workspace.rs 第 1020 行定义了ALLOWED_FILES白名单validate_filename()会对每次读写请求做校验非白名单文件名会直接报Invalid workspace filename错误。这是一种典型的防御性设计——前端即使被篡改传入任意路径命令层也会拒绝访问workspace/之外的文件。2.3 文件状态指示每个文件卡片右侧有一个状态图标绿色对勾文件已存在于磁盘空心圆文件尚不存在首次保存时创建。从源码结构看状态判定并非后端提供专门的“是否存在”命令而是面板在挂载时对 9 个文件并发调用read_workspace_file见checkFileExistence()第 6073 行该命令对不存在的文件返回None前端收到null据此渲染空心圆编辑器关闭后会重新探测一次保证刚保存创建的文件图标立即变为绿色对勾。2.4 编辑与保存延迟创建 原子写入编辑流程与文档一致三步完成点击任意文件卡片打开全屏 Markdown 编辑器WorkspaceFileEditor.tsx基于MarkdownEditor组件支持跟随暗色主题修改内容点击Save将内容写入磁盘。保存动作对应 Tauri 命令write_workspace_file其后端实现commands/workspace.rs 第 327340 行有两个值得注意的行为目录自动创建写入前会create_dir_all确保workspace/目录存在因此首次保存时文件连同目录一起被创建编辑器中的内容不会因“文件不存在”而丢失原子写入实际落盘走 config.rs 第 318329 行的write_text_file/atomic_write——先把内容写入同目录下的临时文件文件名含进程 ID、时间戳与计数器以防冲突再 rename 替换目标文件避免半写状态损坏原有配置。三、Daily Memory按日期组织的记忆日志Daily Memory 是一个日期组织的日志系统存储在~/.openclaw/workspace/memory/目录。在 Workspace Files 网格中点击Daily Memory卡片即可打开该面板DailyMemoryPanel.tsx。3.1 文件列表日期、大小与预览面板以倒序最新日期在前展示所有每日记忆文件每条记录显示日期由文件名解析例如2026-04-01.md→2026-04-01文件大小按 B/KB/MB 格式化显示预览文件开头的内容片段。后端list_daily_memory_filescommands/workspace.rs 第 60115 行只扫描memory/下的.md普通文件预览取文件前 200 个字符最后按文件名降序排序——由于文件名即YYYY-MM-DD.md字典序倒序天然等价于日期倒序。若目录不存在则返回空列表。3.2 创建今日笔记延迟持久化点击Create Today按钮按本机日期生成文件名YYYY-MM-DD.md前端getTodayFilename()用本地时区拼接两位补零若当日笔记已存在直接打开编辑若不存在则以空内容打开编辑器此时磁盘上还没有任何文件——只有点击Save后write_daily_memory_file才会创建memory/目录并落盘。这种“延迟创建”策略避免了误点按钮产生一堆空文件。3.3 全文搜索在 Daily Memory 面板中按Cmd/CtrlF或点击搜索图标打开搜索栏输入关键词前端以300ms 防抖handleSearchChange中的 debounce 定时器调用search_daily_memory_files结果列表对每个命中文件显示每文件匹配次数徽标仅统计正文匹配命中行附近约 120 个字符的上下文片段文件日期与大小。按Esc关闭搜索并清空状态。从后端实现第 193285 行可以看到几个精确行为值得在排障时参考搜索不区分大小写同时匹配正文与日期字段——搜索2026-04可以命中2026-04-01.md这类按日期命名的文件即使正文没有该字符串此时match_count为 0片段退化为文件开头 120 字符片段截取围绕第一次正文命中展开前 50 字符 后 70 字符并用floor_char_boundary/ceil_char_boundary两个辅助函数保证截取点落在合法 UTF-8 字符边界上多字节字符不会被截断查询为空字符串时直接返回空结果。3.4 编辑与删除编辑点击任意文件条目进入全屏 Markdown 编辑器保存调用write_daily_memory_file同样是原子写入且memory/目录不存在时自动创建删除悬停条目点击删除图标弹出确认对话框删除不可恢复。后端delete_daily_memory_file是幂等的——文件不存在时直接返回成功若删除的正是当前正在编辑的文件前端会自动退回列表并刷新。3.5 文件名安全校验所有 Daily Memory 读写删操作都会先经过validate_daily_memory_filename()文件名必须严格匹配正则^\d{4}-\d{2}-\d{2}\.md$否则报Expected: YYYY-MM-DD.md。配合memory/前缀拼接路径确保操作被限定在日期命名的日志文件范围内与第 2.2 节工作区文件的白名单机制互为呼应。四、前后端调用链速览为方便进一步阅读源码Workspace 功能涉及的全部 Tauri 命令与前端 API 对应关系前端封装见 workspace.tsTauri 命令作用涉及目录read_workspace_file读取工作区文件不存在返回 nullworkspace/write_workspace_file原子写入工作区文件自动建目录workspace/list_daily_memory_files列出日期日志日期/大小/预览倒序workspace/memory/read_daily_memory_file读取指定日期日志workspace/memory/write_daily_memory_file原子写入日期日志workspace/memory/delete_daily_memory_file删除日期日志幂等workspace/memory/search_daily_memory_files大小写不敏感全文搜索返回片段与计数workspace/memory/open_workspace_directory在系统文件管理器打开workspace/或memory/两者对应的后端实现集中在 commands/workspace.rs基础原子写入能力来自 config.rs前端 UI 组件位于 components/workspace/ 目录WorkspaceFilesPanel.tsx、WorkspaceFileEditor.tsx、DailyMemoryPanel.tsx。五、小结cc-switch 的 Workspace 功能把 OpenClaw 的九类工作区 Markdown 文件与memory/日期日志收进统一的图形化管理界面九文件白名单 日期正则双重校验保证了路径安全延迟创建 原子写入保证了保存过程的可靠性而 300ms 防抖的大小写不敏感全文搜索含日期匹配、UTF-8 边界安全的上下文片段则让历史记忆可被快速定位。所有数据始终落在~/.openclaw/workspace/下你随时可以通过面板上的路径链接切到系统文件管理器用任意外部工具做同样的维护。【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 cc-switch OpenClaw Workspace 与 Daily Memory 实战指南：九个工作区文件与日期日志的完整管理
cc-switch OpenClaw Workspace 与 Daily Memory 实战指南九个工作区文件与日期日志的完整管理【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch本篇基于 cc-switch 官方文档 3.5 Workspace Files Daily Memory 展开讲解 Workspace 面板中九类 OpenClaw 工作区 Markdown 文件的编辑、状态识别与保存机制以及 Daily Memory 日期日志系统的列表、创建、全文搜索与删除流程。读完本文你既能熟练使用这两个功能完成日常配置与记忆维护也能顺着前端组件与 Tauri 命令追溯到~/.openclaw/workspace/目录下的实际读写实现。一、功能定位Workspace 面板只服务于 OpenClawWorkspace 面板是 cc-switch 面向 OpenClaw 应用提供的文件管理与每日记忆Daily Memory功能入口。当应用切换器选中 OpenClaw 时导航栏会出现 Workspace 按钮点击后主区域渲染 WorkspaceFilesPanel 组件这一路由关系在 App.tsx 的case workspace分支中定义第 1082 行附近。需要注意的适用前提该功能只出现在 OpenClaw 上下文中其他应用Claude Code、Codex 等不会显示 Workspace 入口Workspace 管理的是~/.openclaw/workspace/下的Markdown 文件体系Agents 定义、人格、身份等与同目录下openclaw.json中由 openclaw_config.rs 管理的供应商/模型 JSON 配置是两套独立的体系互不覆盖。面板顶部还显示目录路径~/.openclaw/workspace/点击它会调用open_workspace_directory命令在系统文件管理器中打开该目录目录不存在时先自动创建方便你直接用外部编辑器操作同一批文件。二、Workspace Files九个工作区文件2.1 存储位置与路径解析所有工作区文件统一存放在~/.openclaw/workspace/下。后端路径由 openclaw_config.rs 的get_openclaw_dir()解析默认取~/.openclaw若用户在设置中配置了openclaw_config_dir覆盖项见 settings.rs 第 426 行附近的openclaw_config_dir字段则以覆盖目录为准。Workspace 各命令再在其后拼接workspace及memory子目录。2.2 受管文件清单与白名单校验cc-switch 管理 9 个工作区文件每个文件有明确职责前端在 WorkspaceFilesPanel.tsx 的WORKSPACE_FILES常量中注册了文件名与图标文件用途AGENTS.mdAgents 定义与配置SOUL.md系统灵魂/人格设定USER.md用户画像信息IDENTITY.md身份与角色定义TOOLS.md可用工具配置MEMORY.md系统记忆HEARTBEAT.md心跳Heartbeat配置BOOTSTRAP.md引导Bootstrap序列BOOT.md启动配置这 9 个文件名并非仅在前端硬编码后端 commands/workspace.rs 第 1020 行定义了ALLOWED_FILES白名单validate_filename()会对每次读写请求做校验非白名单文件名会直接报Invalid workspace filename错误。这是一种典型的防御性设计——前端即使被篡改传入任意路径命令层也会拒绝访问workspace/之外的文件。2.3 文件状态指示每个文件卡片右侧有一个状态图标绿色对勾文件已存在于磁盘空心圆文件尚不存在首次保存时创建。从源码结构看状态判定并非后端提供专门的“是否存在”命令而是面板在挂载时对 9 个文件并发调用read_workspace_file见checkFileExistence()第 6073 行该命令对不存在的文件返回None前端收到null据此渲染空心圆编辑器关闭后会重新探测一次保证刚保存创建的文件图标立即变为绿色对勾。2.4 编辑与保存延迟创建 原子写入编辑流程与文档一致三步完成点击任意文件卡片打开全屏 Markdown 编辑器WorkspaceFileEditor.tsx基于MarkdownEditor组件支持跟随暗色主题修改内容点击Save将内容写入磁盘。保存动作对应 Tauri 命令write_workspace_file其后端实现commands/workspace.rs 第 327340 行有两个值得注意的行为目录自动创建写入前会create_dir_all确保workspace/目录存在因此首次保存时文件连同目录一起被创建编辑器中的内容不会因“文件不存在”而丢失原子写入实际落盘走 config.rs 第 318329 行的write_text_file/atomic_write——先把内容写入同目录下的临时文件文件名含进程 ID、时间戳与计数器以防冲突再 rename 替换目标文件避免半写状态损坏原有配置。三、Daily Memory按日期组织的记忆日志Daily Memory 是一个日期组织的日志系统存储在~/.openclaw/workspace/memory/目录。在 Workspace Files 网格中点击Daily Memory卡片即可打开该面板DailyMemoryPanel.tsx。3.1 文件列表日期、大小与预览面板以倒序最新日期在前展示所有每日记忆文件每条记录显示日期由文件名解析例如2026-04-01.md→2026-04-01文件大小按 B/KB/MB 格式化显示预览文件开头的内容片段。后端list_daily_memory_filescommands/workspace.rs 第 60115 行只扫描memory/下的.md普通文件预览取文件前 200 个字符最后按文件名降序排序——由于文件名即YYYY-MM-DD.md字典序倒序天然等价于日期倒序。若目录不存在则返回空列表。3.2 创建今日笔记延迟持久化点击Create Today按钮按本机日期生成文件名YYYY-MM-DD.md前端getTodayFilename()用本地时区拼接两位补零若当日笔记已存在直接打开编辑若不存在则以空内容打开编辑器此时磁盘上还没有任何文件——只有点击Save后write_daily_memory_file才会创建memory/目录并落盘。这种“延迟创建”策略避免了误点按钮产生一堆空文件。3.3 全文搜索在 Daily Memory 面板中按Cmd/CtrlF或点击搜索图标打开搜索栏输入关键词前端以300ms 防抖handleSearchChange中的 debounce 定时器调用search_daily_memory_files结果列表对每个命中文件显示每文件匹配次数徽标仅统计正文匹配命中行附近约 120 个字符的上下文片段文件日期与大小。按Esc关闭搜索并清空状态。从后端实现第 193285 行可以看到几个精确行为值得在排障时参考搜索不区分大小写同时匹配正文与日期字段——搜索2026-04可以命中2026-04-01.md这类按日期命名的文件即使正文没有该字符串此时match_count为 0片段退化为文件开头 120 字符片段截取围绕第一次正文命中展开前 50 字符 后 70 字符并用floor_char_boundary/ceil_char_boundary两个辅助函数保证截取点落在合法 UTF-8 字符边界上多字节字符不会被截断查询为空字符串时直接返回空结果。3.4 编辑与删除编辑点击任意文件条目进入全屏 Markdown 编辑器保存调用write_daily_memory_file同样是原子写入且memory/目录不存在时自动创建删除悬停条目点击删除图标弹出确认对话框删除不可恢复。后端delete_daily_memory_file是幂等的——文件不存在时直接返回成功若删除的正是当前正在编辑的文件前端会自动退回列表并刷新。3.5 文件名安全校验所有 Daily Memory 读写删操作都会先经过validate_daily_memory_filename()文件名必须严格匹配正则^\d{4}-\d{2}-\d{2}\.md$否则报Expected: YYYY-MM-DD.md。配合memory/前缀拼接路径确保操作被限定在日期命名的日志文件范围内与第 2.2 节工作区文件的白名单机制互为呼应。四、前后端调用链速览为方便进一步阅读源码Workspace 功能涉及的全部 Tauri 命令与前端 API 对应关系前端封装见 workspace.tsTauri 命令作用涉及目录read_workspace_file读取工作区文件不存在返回 nullworkspace/write_workspace_file原子写入工作区文件自动建目录workspace/list_daily_memory_files列出日期日志日期/大小/预览倒序workspace/memory/read_daily_memory_file读取指定日期日志workspace/memory/write_daily_memory_file原子写入日期日志workspace/memory/delete_daily_memory_file删除日期日志幂等workspace/memory/search_daily_memory_files大小写不敏感全文搜索返回片段与计数workspace/memory/open_workspace_directory在系统文件管理器打开workspace/或memory/两者对应的后端实现集中在 commands/workspace.rs基础原子写入能力来自 config.rs前端 UI 组件位于 components/workspace/ 目录WorkspaceFilesPanel.tsx、WorkspaceFileEditor.tsx、DailyMemoryPanel.tsx。五、小结cc-switch 的 Workspace 功能把 OpenClaw 的九类工作区 Markdown 文件与memory/日期日志收进统一的图形化管理界面九文件白名单 日期正则双重校验保证了路径安全延迟创建 原子写入保证了保存过程的可靠性而 300ms 防抖的大小写不敏感全文搜索含日期匹配、UTF-8 边界安全的上下文片段则让历史记忆可被快速定位。所有数据始终落在~/.openclaw/workspace/下你随时可以通过面板上的路径链接切到系统文件管理器用任意外部工具做同样的维护。【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考