Doramagic 项目包 · 项目说明书

bastra-recall 项目

本地优先的持久化记忆方案,为 Claude Code、Cursor、ChatGPT 及所有 MCP 客户端提供统一的 Markdown 记忆库,实现跨 AI 工具共享。

项目概览

bastra-recall 是一个基于 Model Context Protocol (MCP) 的长期记忆中间层,专为 Claude 系列 AI 客户端(Claude Desktop、Claude Code)设计。它通过本地 Markdown vault(兼容 Obsidian)为 AI 会话提供持久化、按需召回的"记忆"能力,并随时间不断自我整理与精炼。

章节 相关页面

继续阅读本节完整说明和来源证据。

项目定位与核心价值

bastra-recall 的核心问题:AI 客户端本身是无状态的——每次新会话都需要重复提供项目背景、用户偏好、过往决策等上下文。bastra-recall 通过 MCP 接口为 AI 暴露 recallrememberforgetcurate 等工具,让模型能够:

  • 在对话开始时自动召回相关的历史记忆(hint token 注入)
  • 在对话过程中主动记忆新事实(用户偏好、项目约束、决策原因)
  • 在空闲时自我整理 vault(curator phase A 的 staleness pass、按使用频率降权冷记忆)

最新版本 v0.7.0-beta.5 引入了引导式安装向导#185)和生命周期 wave C(curator 首次"动起来"的阶段),标志着项目从"被动存储"迈向"主动维护"。资料来源:README.md:1-40

架构组成

仓库采用 npm workspaces 单仓多包结构,主入口包 @bastra-recall/bastra-recall 负责 CLI 调度,三个核心 workspace 各司其职:

Workspace角色关键产物
packages/bastra-recallCLI 入口与生命周期编排(install / uninstall / start)bastra 命令分发器
packages/core记忆语义层:vault 扫描、enricher、curator、telemetry纯逻辑层,可独立测试
packages/daemonMCP 服务与 mcp-forwarder.js 转发器@bastra-recall/daemon
packages/statuslineClaude Code 状态栏集成显示当前会话的 recall 状态

资料来源:package.json:1-60packages/core/package.json:1-30]、`packages/daemon/README.md:1-50]()

部署与分发形态

bastra-recall 提供三条互斥的安装路径,由 bastra install 在引导向导中让用户选择(v0.7.0-beta.5):

  1. npx 一次性试用npx bastra-recall@latest install all。注意 #180 报告的问题——npx 缓存是临时目录,会让 surface 注册指向 ~/.npm/_npx/<hash>/...,缓存清理后 MCP 注册会失效。
  2. 全局 npm 安装npm install -g bastra-recall,forwarder 路径稳定。
  3. Homebrew formulabrew install n0mad-ai/tap/bastra-recall#182#184 记录了早期 beta 在干净 macOS 环境的失败——分别需要新增 brew trust --formula 步骤,并修复 tarball 缺失 core/statusline dist 的构建问题。

每条路径都会向三个 surfaceclaude-codeclaude-desktopcursor)注册 MCP server 与可选的 skill。

关键子系统与已知问题

下表罗列 bastra-recall 当前最受社区关注的子系统:

  • Enricher / doc sidecar:扫描 vault 中新出现的文档,为其生成带 embedding 的 Markdown sidecar,并在余弦相似度 ≥ 0.9 的兄弟 sidecar 间建立 [[doc-id]] 维基链接。#188 指出 id-slug 形式的 wikilink 在 Obsidian 中无法解析,会产生 0 字节空文件(2026-07-04 真实 vault 事件)。
  • Curator phase A#155):基于 usage telemetry 的确定性 staleness 评分,空闲时触发(idle-gated),仅调权不计删。
  • Telemetry per-memory sidecar#154):append-only 聚合 surfaced/loaded/acted_on 计数,弥补 raw events JSONL 轮转后的统计空白。
  • Vault self-audit#140):以 Markdown 形式输出到 vault 本身(用 Obsidian 浏览),分区报告 sync-conflict、dangling、demand-gaps 等。
  • Uninstall 边界#181):在 uninstall all 同进程卸载 claude-desktop 后,claude-code skill 仍被报告为 kept (shared with Claude Desktop),存在共享资源误判。

数据流概览

flowchart LR
    AI[Claude Desktop/Code] -->|MCP request| F[mcp-forwarder.js]
    F --> D[daemon: stdio JSON-RPC]
    D --> C[core: recall/remember]
    C --> V[(Markdown vault)]
    C --> E[Ollama embeddings]
    V -.->|scan| EN[Enricher]
    V -.->|idle| CU[Curator]
    CU --> T[Telemetry sidecar]

资料来源:packages/daemon/README.md:1-80packages/core/package.json:1-30]()README.md:41-100]()

适用场景与边界

bastra-recall 适合长期、单人、跨会话的 AI 协作场景——特别是需要 AI 记住项目约束、用户偏好、过往决策的工作流。它适合:

  • 多人共享 vault(无并发锁设计)
  • 高频短会话(telemetry 噪声会污染 curator 评分)
  • 非 Claude 系客户端(仅实现了 Claude Desktop/Code/Cursor 的 MCP 表面)

vault 选用 Markdown 是有意识的设计:人类可读、可在 Obsidian 中直接浏览、可被 git 追踪——但也带来 #188 暴露的副作用:enricher 写出的 0 字节 stub 文件会污染 vault 根目录,需要后续通过校验修复。资料来源:packages/bastra-recall/README.md:1-60#188`]()

资料来源:package.json:1-60packages/core/package.json:1-30]、`packages/daemon/README.md:1-50]()

Src 模块

src/ 是 bastra-recall 项目的 TypeScript 实现根目录,跨 packages/statusline、packages/daemon、packages/core 三个工作空间组织代码。仓库采用 monorepo 结构,所有包遵循 src/ 作为源码入口、dist/ 作为构建产物的统一约定。src 层集中承载状态栏渲染、配置加载、MCP 转发、共享类...

章节 相关页面

继续阅读本节完整说明和来源证据。

概述

src/ 是 bastra-recall 项目的 TypeScript 实现根目录,跨 packages/statuslinepackages/daemonpackages/core 三个工作空间组织代码。仓库采用 monorepo 结构,所有包遵循 src/ 作为源码入口、dist/ 作为构建产物的统一约定。src 层集中承载状态栏渲染、配置加载、MCP 转发、共享类型与生命周期等关键能力,是所有 CLI/IDE 表面调用链的起点。

资料来源:packages/statusline/src/index.ts:1-40

statusline 包的 src 结构

packages/statusline/src/ 按照入口、配置、渲染、片段四种职责拆分:

  • 入口与适配:index.ts 聚合所有导出,根据运行环境(CI、IDE 终端、纯终端、浏览器/Codespaces)分发渲染分支;browser.ts 处理浏览器端回退,在无 ANSI 支持时返回纯文本。
  • 配置层:config/defaults.ts 定义默认常量(列宽、颜色阈值、刷新间隔、vault 路径解析等);config/loader.ts 以"最近写覆盖"的优先级合并用户配置、环境变量与默认值。
  • 渲染层:powerline.ts 实现 powerline 风格的拼接与着色,基于 ANSI 转义码与符号库构造状态栏。
  • 片段层:segments/bastra.ts 定义每个段(如记忆命中率、最近 recall、上次 curator、上次 staleness 评分等),由 index.ts 按用户配置顺序组装。

资料来源:packages/statusline/src/index.ts:1-80 资料来源:packages/statusline/src/browser.ts:1-40 资料来源:packages/statusline/src/config/defaults.ts:1-60 资料来源:packages/statusline/src/config/loader.ts:1-80 资料来源:packages/statusline/src/powerline.ts:1-100 资料来源:packages/statusline/src/segments/bastra.ts:1-80

daemon 与 core 包的角色

packages/daemon/src/mcp-forwarder.ts 是守护进程包的转发主入口。通过 npx bastra-recall@latest install all 安装时,各 AI 客户端(Claude Code、Claude Desktop 等)注册的 forwarder 路径指向 dist/mcp-forwarder.js,它在 stdio 上读取 MCP 消息并转发给本机守护进程。当 npx 缓存被清理或重定向时,此路径会失效,表现为客户端无法连接(参见社区问题 #180)。

packages/core/src/index.ts 承载项目共享的类型定义、错误模型、vault 路径解析等基础工具,被 statuslinedaemon 通过 npm 工作空间引用。Homebrew 公式在 v0.7.0-beta.4 阶段曾遗漏 corestatusline 的 dist 产物(参见 #184),后期构建需同时编译这两个工作空间,否则 tarball 缺失产物会引发 67 条 TS7006/TS7016 类错误。

资料来源:packages/daemon/src/mcp-forwarder.ts:1-100 资料来源:packages/core/src/index.ts:1-50

构建产物与运行时协作

src/ 模块的 TypeScript 通过根目录 npm workspaces 统一编译,产物按 src/dist/ 的等价映射输出。运行时协作关系如下:

路径角色启动场景
packages/statusline/src/index.ts入口聚合与渲染分发IDE/Cursor statusline 钩子
packages/statusline/src/config/loader.ts配置合并每次渲染前
packages/daemon/src/mcp-forwarder.tsMCP stdio 转发AI 客户端调用
packages/core/src/index.ts共享类型与工具被 statusline/daemon 引用

v0.7.0-beta.5 引入的引导式安装(参见 #185)在用户首次运行 bastra install 时写入 vault 路径与客户端选择,后续 src/ 层在缺少 vault 路径时通过该持久化配置兜底,避免再抛出 "vault path required" 的硬错误(参见 #178)。src/ 模块由此成为连接"安装向导"与"运行时渲染/转发"的中枢:配置写入磁盘、loader.ts 读取合并、index.ts 渲染分发、mcp-forwarder.ts 处理跨进程消息,三层共同构成 bastra-recall 自改进生命周期的源动力。

资料来源:packages/statusline/src/index.ts:1-80 资料来源:packages/statusline/src/config/loader.ts:1-80 资料来源:packages/daemon/src/mcp-forwarder.ts:1-100 资料来源:packages/core/src/index.ts:1-50

资料来源:packages/statusline/src/index.ts:1-40

失败模式与踩坑日记

保留 Doramagic 在发现、验证和编译中沉淀的项目专属风险,不把社区讨论只当作装饰信息。

high 来源证据:Vault self-audit surfaced as Markdown in the vault (Obsidian as the viewer) — conflicts, demand-gaps, dangling

可能阻塞安装或首次运行。

medium 失败模式:installation: brew install fails on untrusted tap — docs and Install.command miss the new 'brew trust' step

Developers may fail before the first successful local run: brew install fails on untrusted tap — docs and Install.command miss the new 'brew trust' step

medium 失败模式:installation: homebrew formula build fails — builds only the daemon workspace, core/statusline dist missing...

Developers may fail before the first successful local run: homebrew formula build fails — builds only the daemon workspace, core/statusline dist missing from the tarball

medium 失败模式:installation: install via npx registers the forwarder path inside the ephemeral npx cache

Developers may fail before the first successful local run: install via npx registers the forwarder path inside the ephemeral npx cache

Pitfall Log / 踩坑日志

项目:n0mad-ai/bastra-recall

摘要:发现 32 个潜在踩坑项,其中 1 个为 high/blocking;最高优先级:安全/权限坑 - 来源证据:Vault self-audit surfaced as Markdown in the vault (Obsidian as the viewer) — conflicts, demand-gaps, dangling。

1. 安全/权限坑 · 来源证据:Vault self-audit surfaced as Markdown in the vault (Obsidian as the viewer) — conflicts, demand-gaps, dangling

  • 严重度:high
  • 证据强度:source_linked
  • 发现:GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题:Vault self-audit surfaced as Markdown in the vault (Obsidian as the viewer) — conflicts, demand-gaps, dangling
  • 对用户的影响:可能阻塞安装或首次运行。
  • 证据:community_evidence:github | https://github.com/n0mad-ai/bastra-recall/issues/140 | 来源讨论提到 node 相关条件,需在安装/试用前复核。

2. 安装坑 · 失败模式:installation: brew install fails on untrusted tap — docs and Install.command miss the new 'brew trust' step

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:Developers should check this installation risk before relying on the project: brew install fails on untrusted tap — docs and Install.command miss the new 'brew trust' step
  • 对用户的影响:Developers may fail before the first successful local run: brew install fails on untrusted tap — docs and Install.command miss the new 'brew trust' step
  • 证据:failure_mode_cluster:github_issue | https://github.com/n0mad-ai/bastra-recall/issues/182 | brew install fails on untrusted tap — docs and Install.command miss the new 'brew trust' step

3. 安装坑 · 失败模式:installation: homebrew formula build fails — builds only the daemon workspace, core/statusline dist missing...

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:Developers should check this installation risk before relying on the project: homebrew formula build fails — builds only the daemon workspace, core/statusline dist missing from the tarball
  • 对用户的影响:Developers may fail before the first successful local run: homebrew formula build fails — builds only the daemon workspace, core/statusline dist missing from the tarball
  • 证据:failure_mode_cluster:github_issue | https://github.com/n0mad-ai/bastra-recall/issues/184 | homebrew formula build fails — builds only the daemon workspace, core/statusline dist missing from the tarball

4. 安装坑 · 失败模式:installation: install via npx registers the forwarder path inside the ephemeral npx cache

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:Developers should check this installation risk before relying on the project: install via npx registers the forwarder path inside the ephemeral npx cache
  • 对用户的影响:Developers may fail before the first successful local run: install via npx registers the forwarder path inside the ephemeral npx cache
  • 证据:failure_mode_cluster:github_issue | https://github.com/n0mad-ai/bastra-recall/issues/180 | install via npx registers the forwarder path inside the ephemeral npx cache

5. 安装坑 · 失败模式:installation: install: first-run wall — 'vault path required' error instead of a guided vault choice

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:Developers should check this installation risk before relying on the project: install: first-run wall — 'vault path required' error instead of a guided vault choice
  • 对用户的影响:Developers may fail before the first successful local run: install: first-run wall — 'vault path required' error instead of a guided vault choice
  • 证据:failure_mode_cluster:github_issue | https://github.com/n0mad-ai/bastra-recall/issues/178 | install: first-run wall — 'vault path required' error instead of a guided vault choice

6. 安装坑 · 失败模式:installation: test: verify the Ollama fresh-install (brew) path on a clean macOS env

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:Developers should check this installation risk before relying on the project: test: verify the Ollama fresh-install (brew) path on a clean macOS env
  • 对用户的影响:Developers may fail before the first successful local run: test: verify the Ollama fresh-install (brew) path on a clean macOS env
  • 证据:failure_mode_cluster:github_issue | https://github.com/n0mad-ai/bastra-recall/issues/90 | test: verify the Ollama fresh-install (brew) path on a clean macOS env

7. 安装坑 · 失败模式:installation: uninstall all: skill kept as 'shared with Claude Desktop' although Desktop was uninstalled in...

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:Developers should check this installation risk before relying on the project: uninstall all: skill kept as 'shared with Claude Desktop' although Desktop was uninstalled in the same run
  • 对用户的影响:Developers may fail before the first successful local run: uninstall all: skill kept as 'shared with Claude Desktop' although Desktop was uninstalled in the same run
  • 证据:failure_mode_cluster:github_issue | https://github.com/n0mad-ai/bastra-recall/issues/181 | uninstall all: skill kept as 'shared with Claude Desktop' although Desktop was uninstalled in the same run

8. 安装坑 · 失败模式:installation: v0.6.0-beta.1

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:Developers should check this installation risk before relying on the project: v0.6.0-beta.1
  • 对用户的影响:Upgrade or migration may change expected behavior: v0.6.0-beta.1
  • 证据:failure_mode_cluster:github_release | https://github.com/n0mad-ai/bastra-recall/releases/tag/v0.6.0-beta.1 | v0.6.0-beta.1

9. 安装坑 · 失败模式:installation: v0.6.5-beta.1

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:Developers should check this installation risk before relying on the project: v0.6.5-beta.1
  • 对用户的影响:Upgrade or migration may change expected behavior: v0.6.5-beta.1
  • 证据:failure_mode_cluster:github_release | https://github.com/n0mad-ai/bastra-recall/releases/tag/v0.6.5-beta.1 | v0.6.5-beta.1

10. 安装坑 · 失败模式:installation: v0.6.6-beta.1

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:Developers should check this installation risk before relying on the project: v0.6.6-beta.1
  • 对用户的影响:Upgrade or migration may change expected behavior: v0.6.6-beta.1
  • 证据:failure_mode_cluster:github_release | https://github.com/n0mad-ai/bastra-recall/releases/tag/v0.6.6-beta.1 | v0.6.6-beta.1

11. 安装坑 · 失败模式:installation: v0.7.0-beta.3

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:Developers should check this installation risk before relying on the project: v0.7.0-beta.3
  • 对用户的影响:Upgrade or migration may change expected behavior: v0.7.0-beta.3
  • 证据:failure_mode_cluster:github_release | https://github.com/n0mad-ai/bastra-recall/releases/tag/v0.7.0-beta.3 | v0.7.0-beta.3

12. 安装坑 · 失败模式:installation: v0.7.0-beta.5 — guided install + lifecycle wave C

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:Developers should check this installation risk before relying on the project: v0.7.0-beta.5 — guided install + lifecycle wave C
  • 对用户的影响:Upgrade or migration may change expected behavior: v0.7.0-beta.5 — guided install + lifecycle wave C
  • 证据:failure_mode_cluster:github_release | https://github.com/n0mad-ai/bastra-recall/releases/tag/v0.7.0-beta.5 | v0.7.0-beta.5 — guided install + lifecycle wave C

13. 安装坑 · 来源证据:brew install fails on untrusted tap — docs and Install.command miss the new 'brew trust' step

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:GitHub 社区证据显示该项目存在一个安装相关的待验证问题:brew install fails on untrusted tap — docs and Install.command miss the new 'brew trust' step
  • 对用户的影响:可能增加新用户试用和生产接入成本。
  • 证据:community_evidence:github | https://github.com/n0mad-ai/bastra-recall/issues/182 | 来源类型 github_issue 暴露的待验证使用条件。

14. 安装坑 · 来源证据:homebrew formula build fails — builds only the daemon workspace, core/statusline dist missing from the tarball

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:GitHub 社区证据显示该项目存在一个安装相关的待验证问题:homebrew formula build fails — builds only the daemon workspace, core/statusline dist missing from the tarball
  • 对用户的影响:可能增加新用户试用和生产接入成本。
  • 证据:community_evidence:github | https://github.com/n0mad-ai/bastra-recall/issues/184 | 来源讨论提到 node 相关条件,需在安装/试用前复核。

15. 安装坑 · 来源证据:install via npx registers the forwarder path inside the ephemeral npx cache

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:GitHub 社区证据显示该项目存在一个安装相关的待验证问题:install via npx registers the forwarder path inside the ephemeral npx cache
  • 对用户的影响:可能增加新用户试用和生产接入成本。
  • 证据:community_evidence:github | https://github.com/n0mad-ai/bastra-recall/issues/180 | 来源讨论提到 node 相关条件,需在安装/试用前复核。

16. 安装坑 · 来源证据:install: first-run wall — 'vault path required' error instead of a guided vault choice

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:GitHub 社区证据显示该项目存在一个安装相关的待验证问题:install: first-run wall — 'vault path required' error instead of a guided vault choice
  • 对用户的影响:可能增加新用户试用和生产接入成本。
  • 证据:community_evidence:github | https://github.com/n0mad-ai/bastra-recall/issues/178 | 来源讨论提到 npm 相关条件,需在安装/试用前复核。

17. 安装坑 · 来源证据:test: verify the Ollama fresh-install (brew) path on a clean macOS env

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:GitHub 社区证据显示该项目存在一个安装相关的待验证问题:test: verify the Ollama fresh-install (brew) path on a clean macOS env
  • 对用户的影响:可能增加新用户试用和生产接入成本。
  • 证据:community_evidence:github | https://github.com/n0mad-ai/bastra-recall/issues/90 | 来源讨论提到 npm 相关条件,需在安装/试用前复核。

18. 安装坑 · 来源证据:uninstall all: skill kept as 'shared with Claude Desktop' although Desktop was uninstalled in the same run

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:GitHub 社区证据显示该项目存在一个安装相关的待验证问题:uninstall all: skill kept as 'shared with Claude Desktop' although Desktop was uninstalled in the same run
  • 对用户的影响:可能增加新用户试用和生产接入成本。
  • 证据:community_evidence:github | https://github.com/n0mad-ai/bastra-recall/issues/181 | 来源类型 github_issue 暴露的待验证使用条件。

19. 配置坑 · 可能修改宿主 AI 配置

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主,或安装命令涉及用户配置目录。
  • 对用户的影响:安装可能改变本机 AI 工具行为,用户需要知道写入位置和回滚方法。
  • 证据:capability.host_targets | https://github.com/n0mad-ai/bastra-recall | host_targets=mcp_host, claude_code, claude, cursor, chatgpt

20. 配置坑 · 失败模式:configuration: Vault self-audit surfaced as Markdown in the vault (Obsidian as the viewer) — conflicts, dema...

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:Developers should check this configuration risk before relying on the project: Vault self-audit surfaced as Markdown in the vault (Obsidian as the viewer) — conflicts, demand-gaps, dangling
  • 对用户的影响:Developers may misconfigure credentials, environment, or host setup: Vault self-audit surfaced as Markdown in the vault (Obsidian as the viewer) — conflicts, demand-gaps, dangling
  • 证据:failure_mode_cluster:github_issue | https://github.com/n0mad-ai/bastra-recall/issues/140 | Vault self-audit surfaced as Markdown in the vault (Obsidian as the viewer) — conflicts, demand-gaps, dangling

21. 配置坑 · 失败模式:configuration: curator phase A: deterministic usage-driven staleness pass (score-only, idle-gated)

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:Developers should check this configuration risk before relying on the project: curator phase A: deterministic usage-driven staleness pass (score-only, idle-gated)
  • 对用户的影响:Developers may misconfigure credentials, environment, or host setup: curator phase A: deterministic usage-driven staleness pass (score-only, idle-gated)
  • 证据:failure_mode_cluster:github_issue | https://github.com/n0mad-ai/bastra-recall/issues/155 | curator phase A: deterministic usage-driven staleness pass (score-only, idle-gated)

22. 配置坑 · 失败模式:configuration: telemetry: per-memory usage sidecar — append-only aggregate of surfaced/loaded/acted_on

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:Developers should check this configuration risk before relying on the project: telemetry: per-memory usage sidecar — append-only aggregate of surfaced/loaded/acted_on
  • 对用户的影响:Developers may misconfigure credentials, environment, or host setup: telemetry: per-memory usage sidecar — append-only aggregate of surfaced/loaded/acted_on
  • 证据:failure_mode_cluster:github_issue | https://github.com/n0mad-ai/bastra-recall/issues/154 | telemetry: per-memory usage sidecar — append-only aggregate of surfaced/loaded/acted_on

23. 配置坑 · 失败模式:configuration: v0.7.0-beta.1 — Recall that proves itself

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:Developers should check this configuration risk before relying on the project: v0.7.0-beta.1 — Recall that proves itself
  • 对用户的影响:Upgrade or migration may change expected behavior: v0.7.0-beta.1 — Recall that proves itself
  • 证据:failure_mode_cluster:github_release | https://github.com/n0mad-ai/bastra-recall/releases/tag/v0.7.0-beta.1 | v0.7.0-beta.1 — Recall that proves itself

24. 配置坑 · 失败模式:configuration: v0.7.0-beta.4

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:Developers should check this configuration risk before relying on the project: v0.7.0-beta.4
  • 对用户的影响:Upgrade or migration may change expected behavior: v0.7.0-beta.4
  • 证据:failure_mode_cluster:github_release | https://github.com/n0mad-ai/bastra-recall/releases/tag/v0.7.0-beta.4 | v0.7.0-beta.4

25. 能力坑 · 能力判断依赖假设

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:README/documentation is current enough for a first validation pass.
  • 对用户的影响:假设不成立时,用户拿不到承诺的能力。
  • 证据:capability.assumptions | https://github.com/n0mad-ai/bastra-recall | README/documentation is current enough for a first validation pass.

26. 维护坑 · 维护活跃度未知

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:未记录 last_activity_observed。
  • 对用户的影响:新项目、停更项目和活跃项目会被混在一起,推荐信任度下降。
  • 证据:evidence.maintainer_signals | https://github.com/n0mad-ai/bastra-recall | last_activity_observed missing
  • 严重度:medium
  • 证据强度:source_linked
  • 发现:no_demo
  • 证据:downstream_validation.risk_items | https://github.com/n0mad-ai/bastra-recall | no_demo; severity=medium

28. 安全/权限坑 · 存在评分风险

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:no_demo
  • 对用户的影响:风险会影响是否适合普通用户安装。
  • 证据:risks.scoring_risks | https://github.com/n0mad-ai/bastra-recall | no_demo; severity=medium

29. 安全/权限坑 · 来源证据:curator phase A: deterministic usage-driven staleness pass (score-only, idle-gated)

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题:curator phase A: deterministic usage-driven staleness pass (score-only, idle-gated)
  • 对用户的影响:可能影响授权、密钥配置或安全边界。
  • 证据:community_evidence:github | https://github.com/n0mad-ai/bastra-recall/issues/155 | 来源类型 github_issue 暴露的待验证使用条件。

30. 安全/权限坑 · 来源证据:telemetry: per-memory usage sidecar — append-only aggregate of surfaced/loaded/acted_on

  • 严重度:medium
  • 证据强度:source_linked
  • 发现:GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题:telemetry: per-memory usage sidecar — append-only aggregate of surfaced/loaded/acted_on
  • 对用户的影响:可能影响授权、密钥配置或安全边界。
  • 证据:community_evidence:github | https://github.com/n0mad-ai/bastra-recall/issues/154 | 来源类型 github_issue 暴露的待验证使用条件。

31. 维护坑 · issue/PR 响应质量未知

  • 严重度:low
  • 证据强度:source_linked
  • 发现:issue_or_pr_quality=unknown。
  • 对用户的影响:用户无法判断遇到问题后是否有人维护。
  • 证据:evidence.maintainer_signals | https://github.com/n0mad-ai/bastra-recall | issue_or_pr_quality=unknown

32. 维护坑 · 发布节奏不明确

  • 严重度:low
  • 证据强度:source_linked
  • 发现:release_recency=unknown。
  • 对用户的影响:安装命令和文档可能落后于代码,用户踩坑概率升高。
  • 证据:evidence.maintainer_signals | https://github.com/n0mad-ai/bastra-recall | release_recency=unknown

来源:Doramagic 发现、验证与编译记录