Назад към всички

workspace-indexer

// 自动维护 workspace 目录索引。

$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly

Workspace Indexer

自动维护 workspace 目录索引。

触发条件

  • 用户说"更新 workspace 索引"
  • 定期维护(建议在 HEARTBEAT.md 中配置每天检查一次)

工作流程

1. 搜索记忆

首先使用 memory_search 搜索每个目录的相关记忆,了解目录用途和历史。

2. 扫描目录

使用 exec 工具扫描 workspace 目录结构。

3. 智能递归

  • 容器目录(projects/、research/、skills/):进入查看子目录
  • 项目根目录(包含 .git、package.json、README 等标志文件):停止递归,直接索引
  • 普通目录:直接索引

4. 收集信息

对每个目录:

  • 读取 README 或注释(如果有)
  • 检查是否有运行中的服务或容器
  • 不要深入分析项目内部文件

5. 生成索引

写入 WORKSPACE_INDEX.md,格式参考以下示例:


  • skills/my-custom-skill/
  • 自定义技能,用于处理特定任务。包含 SKILL.md 和相关脚本。相关记忆:2026-01-15.md,搜索关键词:custom skill

  • projects/web-app/
  • Web 应用项目,使用 Node.js + React 构建。当前运行中,端口 3000。相关记忆:2026-02-01.md,搜索关键词:web app project

  • research/experiment-a/
  • 实验性项目,用于测试新技术方案。包含 Docker 容器,容器 ID abc123,端口 8080。相关记忆:2026-02-10.md,搜索关键词:experiment a

  • old-project/
  • 旧项目目录,已不再使用。包含 .git 仓库(50MB),总大小 200MB。状态:待清理

  • memory/
  • 每日记忆目录,按日期存储原始对话日志(YYYY-MM-DD.md 格式)。MEMORY.md 是从这些日志中提炼的长期记忆

  • tmp/
  • 临时文件目录,存放测试脚本和临时数据

注意事项

  • 只索引目录级别,不深入项目内部
  • 描述要详细但精炼,包含:用途、运行状态、相关记忆文件、搜索关键词
  • 标记废弃或待清理的项目

定期维护

建议在 HEARTBEAT.md 添加每天检查任务:

## Workspace 索引维护
每天检查 workspace 目录变化,如有新增或变更则更新索引