a-local-memory

English | 中文

状态：设计阶段（spec v1）——见仓库内 docs/superpowers/specs/2026-08-02-a-local-memory-design.md

独立的知识中枢 + 代码关系编排器。对外暴露单一 MCP 入口，让 AI 编码代理（Codex、Claude Code）在写代码时能精准检索团队沉淀的 markdown 知识与代码关系。

目标

• 知识不丢失：知识文档跟消费项目走，随代码一起版本化、同 PR 审查。
• 自动进化：解析、索引、保鲜、健康检查全自动；内容仍由人工收录。
• 精准检索：基于 MCP 的两级检索 + 委托 LSP / codegraph 的符号级关系查询。
• 省 Token：默认只返回元数据卡片，正文按需拉取。

工作原理（概览）

• 消费项目在 docs/knowledge/ 维护知识（可用 .a-local-memory.yaml 配置，支持 glob 匹配）。
• hub 注册项目（projects.yaml），把 markdown 索引进 SQLite（并导出 index.json），提供统一 MCP 入口。
• doctor 检查子 MCP（LSP / codegraph）健康状态、列出不符合规范的文档，并驱动无头 executor 自动修复闭环。

安装

npm install -g a-local-memory

会安装两个命令：alm（索引 CLI）和 alm-mcp（MCP server）。

用法（M1）

npm install
npm run build
echo 'projects:
  - id: my-service
    root: ../my-service' > projects.yaml
node dist/cli.js rebuild   # 索引所有注册项目并导出 index.json
node dist/cli.js status    # 查看各项目/分支文档数

知识存放在各消费项目的 docs/knowledge/（可用 .a-local-memory.yaml 覆盖，支持 glob）。 全局安装后，直接在任意工作目录运行 alm rebuild / alm status 即可。

MCP（M2）

npm run build
node dist/mcp/server.js   # stdio MCP server

工具：knowledge_search（元数据卡片）、read_section（按需正文）、projects（注册项目）。 全局安装后，server 命令就是 alm-mcp。

Codex：写入 ~/.codex/config.toml：

[mcp_servers.a-local-memory]
command = "alm-mcp"

Claude Code：写入 .mcp.json：

{
  "mcpServers": {
    "a-local-memory": {
      "command": "alm-mcp"
    }
  }
}

状态

设计阶段。M1–M5 实施里程碑见仓库内 docs/superpowers/specs/2026-08-02-a-local-memory-design.md。