Doramagic.ai
English

Doramagic 项目包 · 项目说明书

remnic 项目

面向用户感知智能体的开源记忆与上下文方案：支持范围化记忆、来源溯源、检索质量评估、修正、边界控制、评测以及 MCP/HTTP 访问。

项目概览

remnic 是一个面向 AI 代理（agent）的记忆与上下文管理框架，目标是在多种宿主（host）环境之间提供可移植、可检索、可治理的记忆层。最新发布版本为 v9.3.644（截至社区记录），仓库采用 monorepo 结构，通过多个子包分别承载核心能力与平台集成。资料来源：[package.json]()

章节 相关页面

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

章节 记忆存储与共享上下文

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

章节 检索与召回路由

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

章节 Memory Boxes 与 Trace Weaver

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

项目定位

remnic 是一个面向 AI 代理（agent）的记忆与上下文管理框架，目标是在多种宿主（host）环境之间提供可移植、可检索、可治理的记忆层。最新发布版本为 v9.3.644（截至社区记录），仓库采用 monorepo 结构，通过多个子包分别承载核心能力与平台集成。资料来源：package.json

项目的核心抽象是「以 Markdown + YAML 形式持久化的记忆文件」。在 memory-extension/shared-instructions.ts 中明确将记忆划分为 fact、preference、decision、entity、skill、correction、question、observation、summary 等类型，并规定通过 front-matter 的 type 字段决定其语义角色。资料来源：packages/remnic-core/src/memory-extension/shared-instructions.ts

整体架构

remnic 由「核心包 + 平台插件 + 评测体系」三层组成。核心包 @remnic/core 提供存储、检索、共享上下文、可穿戴设备桥接、连接器（GitHub 等）等基础能力；上层通过 plugin-openclaw、plugin-pi、memory-extension/codex-publisher 等模块把同一份记忆层桥接到不同的宿主代理中；@remnic/bench 则为上述能力提供基准测试覆盖。资料来源：packages/remnic-core/src/memory-extension/codex-publisher.ts、packages/plugin-openclaw/src/public-artifacts.ts、packages/bench/src/registry.ts

flowchart LR
  Hosts[宿主代理: OpenClaw / Pi / Codex]
  Ext[memory-extension publisher]
  Core[remnic-core]
  Stores[(facts/ entities/ skills/<br/>corrections/ observations/)]
  Wear[wearables/]
  Conn[connectors: GitHub]
  MCP[access-mcp tools]
  Bench[bench registry]
  Hosts --> Ext
  Ext --> Core
  Core --> Stores
  Core --> Wear
  Core --> Conn
  Core --> MCP
  Core --> Bench

主要功能模块

记忆存储与共享上下文

remnic-core 的 storage.ts 负责把 EntityFile 等结构化数据序列化为带 front-matter 的 Markdown，并保留与旧版 summary / facts 字段的解析兼容性。资料来源：packages/remnic-core/src/storage.ts。shared-context/manager.ts 则承担多代理间的「交叉信号」汇总：分析多个 agent 的产出与反馈后产出 Cross-Signals 报告，并支持语义增强器（semantic enhancer）的失败开放（fail-open）降级。资料来源：packages/remnic-core/src/shared-context/manager.ts

检索与召回路由

核心检索能力由若干互补模块组成：explicit-cue-recall.ts 基于显式关键词构建引用片段；event-order-recall.ts 维护按时间顺序的实体/事件索引；response-guidance-recall.ts 通过意图正则（如 diy_shelf_summary、calculus_derivative_walkthrough 等）匹配专项召回策略。MCP 层 access-mcp.ts 将这些召回能力以 engram.recall、engram.recall_explain 等工具形式暴露给宿主代理。资料来源：packages/remnic-core/src/explicit-cue-recall.ts、packages/remnic-core/src/event-order-recall.ts、packages/remnic-core/src/response-guidance-recall.ts、packages/remnic-core/src/access-mcp.ts

Memory Boxes 与 Trace Weaver

boxes.ts 引入 REMem 风格的「记忆盒」与「Trace Weaver」机制：每当新记忆落入 open box 时记录目标与使用工具，当话题漂移（topic_shift）、时间间隔超过 boxTimeGapMs 或累积达到 boxMaxMemories 时触发 SealReason 封盒；同时通过 TraceIndex 在 traceWeaverLookbackDays 窗口内反向关联 trace。资料来源：packages/remnic-core/src/boxes.ts

平台桥接与公共产物

plugin-openclaw/src/public-artifacts.ts 实现了「memory-wiki bridge mode」：仅枚举 facts/、entities/、corrections/、artifacts/ 与 profile.md 等安全目录作为公共产物；显式排除 state/、questions/、transcripts/、archive/、buffers/、tokens/ 等私有运行时状态，并在扫描时通过 realpath 阻断 symlink 越界以及「白名单目录被符号链接重定向到私有目录」的攻击面。资料来源：packages/plugin-openclaw/src/public-artifacts.ts

可穿戴设备与外部连接器

wearables/day-store.ts 将每日对话转写为 <memoryDir>/wearables/<source>/<YYYY-MM-DD>.md，刻意放在记忆扫描根之外但位于 QMD 集合根之内，兼顾「不进入召回但仍可全文检索」的需求。资料来源：packages/remnic-core/src/wearables/day-store.ts。connectors/live/github.ts 则把 issue 评论、discussion 等转换为 ConnectorDocument，并通过 advancePageUrl 处理 GitHub 1-based 的分页推进。资料来源：packages/remnic-core/src/connectors/live/github.ts

近期社区关注点

社区近期的修复集中在四个方向：1) 记忆刷新与 LCM 摘要路由——修复了 FallbackLlmClient 在 OAuth 鉴权下拒绝 openai 等 provider 的问题（issue #1478）以及 LCM 摘要绕过 taskModelChain 回退到 gateway 默认模型链的问题（issue #1473）；2) 平台集成——修复 Windows 下 QMD 探测因 spawn 缺少 shell:true 全部失败的问题（issue #1476）以及 Pi 插件中 post-await 访问陈旧 ctx 导致的扩展崩溃（issue #1481）；3) 召回顺序——为兼容 DeepSeek V4 Flash 等前缀缓存，plugin-pi 的 context hook 改为 append 而非 prepend 注入召回内容（issue #1479）；4) 定时任务——engram-day-summary cron 增加了模型配置 reconcile（issue #1474）以及可配置时区（issue #1475）。资料来源：community context issues #1473/#1474/#1475/#1476/#1478/#1479/#1481

See Also

来源：https://github.com/joshuaswarren/remnic / 项目说明书

Lib 模块

Remnic 项目是一个面向 AI Agent 的"记忆层"中间件。其代码主体位于 packages/remnic-core/src/（核心库）以及若干配套包（CLI、bench、plugin-）之中。这里所称的 Lib 模块 泛指 remnic-core 包中那些以库函数形式对外提供能力、不直接绑定到某个 CLI 命令或 HTTP 路由的纯逻辑层模块：包括类型定义、存储序...

章节 相关页面

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

1. 模块定位与总体架构

Remnic 项目是一个面向 AI Agent 的"记忆层"中间件。其代码主体位于 packages/remnic-core/src/（核心库）以及若干配套包（CLI、bench、plugin-*）之中。这里所称的 Lib 模块 泛指 remnic-core 包中那些以库函数形式对外提供能力、不直接绑定到某个 CLI 命令或 HTTP 路由的纯逻辑层模块：包括类型定义、存储序列化、多种召回（recall）策略、知识图谱、MCP 接入面、外部连接器、共享上下文协调以及可穿戴设备/记忆盒/分类法等子系统。它们被上层 plugin、CLI、dashboard 复用，共同支撑"事实提取 → 存储 → 检索 → 上下文注入"的主链路。

资料来源：packages/remnic-core/src/types.ts:1-60 资料来源：packages/remnic-core/src/storage.ts:1-40

flowchart LR
  A[Agent / Plugin] --> B[access-mcp.ts<br/>MCP 工具入口]
  A --> C[recall 策略<br/>explicit-cue / event-order / response-guidance]
  C --> D[storage.ts<br/>实体/事实序列化]
  C --> E[native-knowledge.ts<br/>Obsidian / 工作区]
  B --> F[connectors/live/github.ts]
  B --> G[plugin-openclaw public-artifacts]
  D --> H[(磁盘记忆库)]
  E --> H
  F --> I[(外部服务)]
  G --> J[(OpenClaw workspace)]
  C -.cross signals.-> K[shared-context/manager.ts]
  L[wearables/day-store.ts] --> H
  M[taxonomy/resolver-doc-generator.ts] --> H
  N[memory-extension/codex-publisher.ts] --> O[Codex 扩展]

2. 核心数据模型与配置

types.ts 集中维护了整个 Remnic 的运行时配置结构（PluginConfig）。它覆盖了从摘要重要性阈值、主题抽取、transcript 留存策略、检查点（checkpoint）、压缩重置（compaction reset）、到 OpenClaw 工具/命令开关等近百项开关。配置项按"功能子系统"分组（summarization*、transcript*、checkpoint*、openclaw*、recall* 等），并通过 activeRecallAgents、respectBundledActiveMemoryToggle 等布尔项控制是否真正启用。

关键设计点：

  • 细粒度开关：每个子系统都有独立的 enable flag 与若干调节参数（如 summarizationImportanceThreshold、topicExtractionTopN），便于在不动代码的前提下微调行为。
  • 保留兼容字段：transcriptSkipChannelTypes 等数组字段允许在保留 transcript 功能的同时排除某些 channel（如 cron）。
  • 运行时生效：这些字段在 plugin 启动时被读取并物化为内存中的行为参数，运行时修改需要重启或显式 reconcile（参见 issue #1474 中关于 day-summary cron 启动时未 reconcile 的讨论）。

资料来源：packages/remnic-core/src/types.ts:1-60

3. 存储与序列化

storage.ts 提供实体（EntityFile）的 markdown 序列化/反序列化能力。其核心思想是"compiled-truth + timeline"：在写出时根据 entitySchemas 对 structuredSections 排序、对 facts 做归一化，并通过 digest 字段记录最近一次合成的内容指纹，从而在保留旧版 summary/facts 字段可解析性的同时支持增量更新。

boxes.ts 实现"记忆盒（Memory Box）"机制——一组与某个高层任务目标（goal）、所用工具（toolsUsed）和结局（outcome）绑定的内存条目集合，并维护 TraceIndex 用于跨盒的回溯关联。盒的封口（seal）可由主题切换、时间间隔、容量上限或外部 flush 触发。

资料来源：packages/remnic-core/src/storage.ts:1-80 资料来源：packages/remnic-core/src/boxes.ts:1-60

4. 召回（Recall）策略族

Lib 模块将召回拆成多个相互独立、可组合的策略：

模块策略
explicit-cue-recall.ts基于查询中显式线索词与停用词集合进行证据项检索
event-order-recall.ts通过正则词典匹配事件时序意图，抑制不相关模式（如 therapy、collaboration）
response-guidance-recall.ts通过多组正则联合判别用户意图（数学导数、DIY 工程、户外运动等）
native-knowledge.ts将 Obsidian 笔记、OpenClaw 工作区同步状态按"块（chunk）"切片并建立别名/反向链接索引

这些策略并非互斥调用，而是按阶段拼接：先做 cue 检索得到证据项，再由 event-order 与 response-guidance 决定是否抑制或重排序，最后由 native-knowledge 提供底层语料。access-mcp.ts 暴露的工具（engram.recall、engram.recall_explain、engram.set_coding_context 等）即建立在这些策略之上，并支持按 cwd/projectTag 解析项目命名空间、按 asOf 做历史时间锁存、按 tags 做记忆过滤。

资料来源：packages/remnic-core/src/explicit-cue-recall.ts:1-60 资料来源：packages/remnic-core/src/event-order-recall.ts:1-40 资料来源：packages/remnic-core/src/response-guidance-recall.ts:1-50 资料来源：packages/remnic-core/src/access-mcp.ts:1-60 资料来源：packages/remnic-core/src/native-knowledge.ts:1-60

5. 外部连接与共享上下文

  • GitHub 连接器（connectors/live/github.ts）：把 discussions/comments 转成统一的 ConnectorDocument，并在分页失败时通过 advancePageUrl 安全地递增 page 参数（解析失败直接返回空串避免死循环）。
  • OpenClaw 公共产物（plugin-openclaw/src/public-artifacts.ts）：枚举记忆目录中可对外暴露的"白名单"子目录（facts/、entities/、corrections/、artifacts/、profile.md），显式排除 state/、questions/、transcripts/、archive/、buffers、tokens/ 等私有路径；并通过 realpath 校验防止符号链接逃逸到非白名单目录。
  • 共享上下文管理器（shared-context/manager.ts）：每日生成 Cross-Signals 报告，统计源输出、反馈条目、approved/rejected 决策、可选的语义增强器（semantic enhancer）状态，并写出 JSON + Markdown 两种产物。
  • 可穿戴设备日存储（wearables/day-store.ts）：把单源单日 transcript 写到 <memoryDir>/wearables/<source>/<YYYY-MM-DD>.md，刻意放在记忆扫描根目录之外（避免被当记忆召回），同时落在 QMD 收集根目录之内（保证全文检索可用），并用正文哈希做幂等。
  • Codex 记忆扩展发布器（memory-extension/codex-publisher.ts）：渲染 instructions.md、原子写入（temp + rename），并在 Phase-2 沙箱中强制只读文件系统访问。
  • 分类法决策树生成器（taxonomy/resolver-doc-generator.ts）：根据 Taxonomy.categories 的优先级顺序生成 RESOLVER.md，引导用户把新知识分门别类归档。

资料来源：packages/remnic-core/src/connectors/live/github.ts:1-50 资料来源：packages/plugin-openclaw/src/public-artifacts.ts:1-80 资料来源：packages/remnic-core/src/shared-context/manager.ts:1-60 资料来源：packages/remnic-core/src/wearables/day-store.ts:1-40 资料来源：packages/remnic-core/src/memory-extension/codex-publisher.ts:1-60 资料来源：packages/remnic-core/src/taxonomy/resolver-doc-generator.ts:1-40

6. 常见失败模式与近期修复

围绕 Lib 模块，社区曾报告并已修复（含 v9.3.639 – v9.3.644）：

  • LCM 摘要绕过 taskModelChain（#1473）：_fastGatewayLlm 走 FallbackLlmClient 时未应用 taskModelChain，已在 #1482 中修正，让 LCM 路由经过插件级任务模型链。
  • OAuth-only provider 被拒绝（#1478）：运行时未解析 OAuth 凭据即拒绝 openai/gpt-5.4 等模型；同期合并 #1482。
  • Day summary cron 启动未 reconcile（#1474）：与 hourly summary cron 不一致，已通过 #1482 补齐。
  • flush-plan 幻觉路径（#1483）：v9.3.641 修复生命周期处理、v9.3.640 收紧 prompt 约束。
  • Pi 插件 stale ctx（#1481）：v9.3.640 (#1485) 强化上下文处理并改为 append recall，对 prefix-cached provider（如 DeepSeek）友好（#1479）。
  • Windows QMD probe 失败（#1476）：launchProcess() 缺 shell:true，v9.3.640 (#1486) 已修复。
  • Day summary 时区硬编码（#1475）：目前仍跟随服务器 Intl.DateTimeFormat().resolvedOptions().timeZone，未配置化。

7. See Also

资料来源：packages/remnic-core/src/types.ts:1-60

Src 模块

remnic 是一个面向 AI 编程代理（agent）的分层记忆与上下文管理系统，其源码以 monorepo 形式组织在 packages/ 目录下。核心代码位于 packages/remnic-core/src/，由多个职责单一、互相协作的子系统组成，分别负责记忆存取、检索、连接器集成、共享上下文与扩展发布等能力。

章节 相关页面

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

章节 1. 记忆存取层（Memory Storage & Public Artifacts）

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

章节 2. 检索与上下文层（Recall & Context Assembly）

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

章节 3. 访问接口层（Access Layer）

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

概述与项目定位

remnic 是一个面向 AI 编程代理（agent）的分层记忆与上下文管理系统，其源码以 monorepo 形式组织在 packages/ 目录下。核心代码位于 packages/remnic-core/src/，由多个职责单一、互相协作的子系统组成，分别负责记忆存取、检索、连接器集成、共享上下文与扩展发布等能力。

在 packages/remnic-core/src/types.ts 中定义了贯穿整个系统的配置与状态类型（如 compactionResetEnabled、flushOnResetEnabled、sessionTogglesEnabled、activeRecallEnabled 等），为各子系统提供统一的配置契约。资料来源：packages/remnic-core/src/types.ts

社区近期讨论集中在若干热点：记忆刷新（flush plan）路径校验、LCM（无损上下文管理）模型路由、Windows 下的 QMD 启动、Pi 插件的会话上下文处理以及每日摘要 cron 任务的协调机制。这些问题均可在 packages/remnic-core/src/ 与 packages/plugin-openclaw/src/ 等源码中定位到对应实现。

核心子系统划分

remnic-core/src 按照职责划分为以下主要子系统：

1. 记忆存取层（Memory Storage & Public Artifacts）

记忆以 Markdown + YAML frontmatter 形式持久化。实体文件（entity）的序列化由 storage.ts 中的 serializeEntityFile() 负责，使用 compiled-truth + timeline 格式并兼容旧的 summary/facts 字段。资料来源：packages/remnic-core/src/storage.ts

为避免私有运行时数据被错误暴露为公共工件，public-artifacts.ts 显式枚举了仅允许暴露的目录（facts/、entities/、corrections/、artifacts/、profile.md），并阻止通过符号链接将 state/ 等私有目录伪装为公共目录。资料来源：packages/plugin-openclaw/src/public-artifacts.ts

2. 检索与上下文层（Recall & Context Assembly）

系统提供多种召回路径：

召回路径关键文件用途
Explicit Cue Recallexplicit-cue-recall.ts基于显式提示词与停用词过滤的内容词项召回
Event Order Recallevent-order-recall.ts通过领域关键词正则匹配识别事件顺序意图
Response Guidance Recallresponse-guidance-recall.ts推断数学、技术项目等响应指导意图
Native Knowledgenative-knowledge.ts加载 Obsidian 笔记、OpenClaw 工作区同步等原生知识

资料来源：packages/remnic-core/src/explicit-cue-recall.ts、packages/remnic-core/src/event-order-recall.ts、packages/remnic-core/src/response-guidance-recall.ts、packages/remnic-core/src/native-knowledge.ts

3. 访问接口层（Access Layer）

通过 access-mcp.ts（Model Context Protocol 工具）、access-service.ts（核心访问服务接口）与 HTTP/CLI 接入对外暴露能力。engram.recall、engram.observe、engram.set_coding_context 等工具支持 cwd/projectTag 字段以路由到项目级命名空间，并区分 _SCOPED（真正解析命名空间）与 _IGNORED（仅为兼容 MCP 客户端自动注入而接受）。资料来源：packages/remnic-core/src/access-mcp.ts、packages/remnic-core/src/access-service.ts

4. 连接器与共享上下文（Connectors & Shared Context）

GitHub 连接器（connectors/live/github.ts）将评论与讨论转化为 ConnectorDocument，使用分页 URL 推进函数 advancePageUrl() 抓取完整线程。资料来源：packages/remnic-core/src/connectors/live/github.ts

shared-context/manager.ts 协调跨信号（cross-signals）整合，生成每日共享上下文报告（含主题、风险、潜在晋升项）并以原子写入方式落盘。资料来源：packages/remnic-core/src/shared-context/manager.ts

5. 记忆盒与轨迹编织（Memory Boxes & Trace Weaver）

boxes.ts 实现了 REMem 启发的"记忆盒"机制，用于按主题/时间窗口聚类记忆条目，并维护 TraceIndex 索引以支持跨会话的轨迹回溯。盒的关闭由 topic_shift、time_gap、max_memories、forced、flush 等 SealReason 触发。资料来源：packages/remnic-core/src/boxes.ts

6. 记忆扩展与基准测试（Memory Extension & Bench）

memory-extension/codex-publisher.ts 将 Remnic 记忆扩展发布到目标环境（含沙箱规则），shared-instructions.ts 提供跨主机的可复用 Markdown 片段（如 REMNIC_SEMANTIC_OVERVIEW）。bench/src/registry.ts 集中注册各类基准（如 enrichmentFidelity、entityConsolidation、codingRecall 等），remnic-cli/src/bench-args.test.ts 则覆盖 CLI 参数解析测试。资料来源：packages/remnic-core/src/memory-extension/codex-publisher.ts、packages/remnic-core/src/memory-extension/shared-instructions.ts、packages/bench/src/registry.ts、packages/remnic-cli/src/bench-args.test.ts

模块协作流程

下图展示了从外部请求到记忆召回与持久化协作的关键路径：

flowchart LR
    A[MCP/HTTP/CLI 客户端] --> B[access-mcp/access-service]
    B --> C{engram.recall}
    C --> D[explicit-cue-recall]
    C --> E[native-knowledge]
    C --> F[connectors/github]
    D --> G[boxes 索引]
    E --> G
    G --> H[storage 序列化]
    H --> I[(Markdown + YAML)]
    J[Codex/Pi/OpenClaw 插件] --> K[public-artifacts 过滤]
    K --> L[记忆写入]

近期热点与源码映射

社区报告的问题大多可在源码中定位：

  • #1483 flush plan 路径幻觉：public-artifacts.ts 通过 PUBLIC_DIRS 显式枚举合法目录并校验符号链接，是缓解该类问题的核心防线。资料来源：packages/plugin-openclaw/src/public-artifacts.ts
  • #1473/#1478 LCM 路由与 OAuth 提供方：通过 access-mcp.ts 中的 taskModelChain 与 FallbackLlmClient 解析路径修复。
  • #1476 Windows QMD 启动：launchProcess() 在 Windows 路径下需要 shell:true；与 connectors/live/ 中的子进程调用相关。
  • #1475/#1474 每日摘要 cron：shared-context/manager.ts 中的 curateDaily() 协调每日报告生成，与 ensureDaySummaryCron() 的协调机制密切相关。

See Also

  • Remnic 召回系统
  • OpenClaw 插件集成
  • 记忆盒与轨迹编织
  • MCP 工具接口

资料来源：packages/remnic-core/src/explicit-cue-recall.ts、packages/remnic-core/src/event-order-recall.ts、packages/remnic-core/src/response-guidance-recall.ts、packages/remnic-core/src/native-knowledge.ts

失败模式与踩坑日记

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

high 失败模式：security_permissions: FallbackLlmClient rejects OAuth-only providers (openai) before runtime auth resolution

Developers may expose sensitive permissions or credentials: FallbackLlmClient rejects OAuth-only providers (openai) before runtime auth resolution

high 失败模式：security_permissions: [Windows] QMD probe fails: launchProcess() uses bare spawn() without shell:true — all qmd lau...

Developers may expose sensitive permissions or credentials: [Windows] QMD probe fails: launchProcess() uses bare spawn() without shell:true — all qmd launch forms (sh/.cmd/JS) error

medium 失败模式：installation: plugin-pi: stale ctx error after session replacement/reload (post-await ctx access in event +...

Developers may fail before the first successful local run: plugin-pi: stale ctx error after session replacement/reload (post-await ctx access in event + command handlers)

medium 来源证据：Day Summary cron job does not reconcile model config on plugin startup

可能增加新用户试用和生产接入成本。

Pitfall Log / 踩坑日志

项目：joshuaswarren/remnic

摘要：发现 29 个潜在踩坑项，其中 2 个为 high/blocking；最高优先级：安全/权限坑 - 失败模式：security_permissions: FallbackLlmClient rejects OAuth-only providers (openai) before runtime auth resolution。

1. 安全/权限坑 · 失败模式：security_permissions: FallbackLlmClient rejects OAuth-only providers (openai) before runtime auth resolution

  • 严重度：high
  • 证据强度：source_linked
  • 发现：Developers should check this security_permissions risk before relying on the project: FallbackLlmClient rejects OAuth-only providers (openai) before runtime auth resolution
  • 对用户的影响：Developers may expose sensitive permissions or credentials: FallbackLlmClient rejects OAuth-only providers (openai) before runtime auth resolution
  • 证据：failure_mode_cluster:github_issue | https://github.com/joshuaswarren/remnic/issues/1478 | FallbackLlmClient rejects OAuth-only providers (openai) before runtime auth resolution

2. 安全/权限坑 · 失败模式：security_permissions: [Windows] QMD probe fails: launchProcess() uses bare spawn() without shell:true — all qmd lau...

  • 严重度：high
  • 证据强度：source_linked
  • 发现：Developers should check this security_permissions risk before relying on the project: [Windows] QMD probe fails: launchProcess() uses bare spawn() without shell:true — all qmd launch forms (sh/.cmd/JS) error
  • 对用户的影响：Developers may expose sensitive permissions or credentials: [Windows] QMD probe fails: launchProcess() uses bare spawn() without shell:true — all qmd launch forms (sh/.cmd/JS) error
  • 证据：failure_mode_cluster:github_issue | https://github.com/joshuaswarren/remnic/issues/1476 | [Windows] QMD probe fails: launchProcess() uses bare spawn() without shell:true — all qmd launch forms (sh/.cmd/JS) error

3. 安装坑 · 失败模式：installation: plugin-pi: stale ctx error after session replacement/reload (post-await ctx access in event +...

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this installation risk before relying on the project: plugin-pi: stale ctx error after session replacement/reload (post-await ctx access in event + command handlers)
  • 对用户的影响：Developers may fail before the first successful local run: plugin-pi: stale ctx error after session replacement/reload (post-await ctx access in event + command handlers)
  • 证据：failure_mode_cluster:github_issue | https://github.com/joshuaswarren/remnic/issues/1481 | plugin-pi: stale ctx error after session replacement/reload (post-await ctx access in event + command handlers)

4. 安装坑 · 来源证据：Day Summary cron job does not reconcile model config on plugin startup

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Day Summary cron job does not reconcile model config on plugin startup
  • 对用户的影响：可能增加新用户试用和生产接入成本。
  • 证据：community_evidence:github | https://github.com/joshuaswarren/remnic/issues/1474 | 来源类型 github_issue 暴露的待验证使用条件。

5. 安装坑 · 来源证据：[Windows] QMD probe fails: launchProcess() uses bare spawn() without shell:true — all qmd launch forms (sh/.cmd/JS) err…

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：[Windows] QMD probe fails: launchProcess() uses bare spawn() without shell:true — all qmd launch forms (sh/.cmd/JS) error
  • 对用户的影响：可能增加新用户试用和生产接入成本。
  • 证据：community_evidence:github | https://github.com/joshuaswarren/remnic/issues/1476 | 来源讨论提到 node 相关条件，需在安装/试用前复核。

6. 安装坑 · 来源证据：plugin-pi: stale ctx error after session replacement/reload (post-await ctx access in event + command handlers)

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：plugin-pi: stale ctx error after session replacement/reload (post-await ctx access in event + command handlers)
  • 对用户的影响：可能增加新用户试用和生产接入成本。
  • 证据：community_evidence:github | https://github.com/joshuaswarren/remnic/issues/1481 | 来源讨论提到 node 相关条件，需在安装/试用前复核。

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

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

8. 配置坑 · 失败模式：configuration: Day Summary cron job does not reconcile model config on plugin startup

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this configuration risk before relying on the project: Day Summary cron job does not reconcile model config on plugin startup
  • 对用户的影响：Developers may misconfigure credentials, environment, or host setup: Day Summary cron job does not reconcile model config on plugin startup
  • 证据：failure_mode_cluster:github_issue | https://github.com/joshuaswarren/remnic/issues/1474 | Day Summary cron job does not reconcile model config on plugin startup

9. 配置坑 · 失败模式：configuration: Day Summary cron timezone is not configurable (uses server timezone)

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this configuration risk before relying on the project: Day Summary cron timezone is not configurable (uses server timezone)
  • 对用户的影响：Developers may misconfigure credentials, environment, or host setup: Day Summary cron timezone is not configurable (uses server timezone)
  • 证据：failure_mode_cluster:github_issue | https://github.com/joshuaswarren/remnic/issues/1475 | Day Summary cron timezone is not configurable (uses server timezone)

10. 配置坑 · 失败模式：configuration: Flush plan: models hallucinate 'memory-candidates/' paths and flush-plan.md grows indefinitely

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this configuration risk before relying on the project: Flush plan: models hallucinate 'memory-candidates/' paths and flush-plan.md grows indefinitely
  • 对用户的影响：Developers may misconfigure credentials, environment, or host setup: Flush plan: models hallucinate 'memory-candidates/' paths and flush-plan.md grows indefinitely
  • 证据：failure_mode_cluster:github_issue | https://github.com/joshuaswarren/remnic/issues/1483 | Flush plan: models hallucinate 'memory-candidates/' paths and flush-plan.md grows indefinitely

11. 配置坑 · 失败模式：configuration: LCM summarizer bypasses taskModelChain, falls back to gateway default model chain

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this configuration risk before relying on the project: LCM summarizer bypasses taskModelChain, falls back to gateway default model chain
  • 对用户的影响：Developers may misconfigure credentials, environment, or host setup: LCM summarizer bypasses taskModelChain, falls back to gateway default model chain
  • 证据：failure_mode_cluster:github_issue | https://github.com/joshuaswarren/remnic/issues/1473 | LCM summarizer bypasses taskModelChain, falls back to gateway default model chain

12. 配置坑 · 失败模式：configuration: v9.3.639

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this configuration risk before relying on the project: v9.3.639
  • 对用户的影响：Upgrade or migration may change expected behavior: v9.3.639
  • 证据：failure_mode_cluster:github_release | https://github.com/joshuaswarren/remnic/releases/tag/v9.3.639 | v9.3.639

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

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

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

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

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

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

17. 安全/权限坑 · 来源证据：FallbackLlmClient rejects OAuth-only providers (openai) before runtime auth resolution

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：FallbackLlmClient rejects OAuth-only providers (openai) before runtime auth resolution
  • 对用户的影响：可能影响授权、密钥配置或安全边界。
  • 证据：community_evidence:github | https://github.com/joshuaswarren/remnic/issues/1478 | 来源类型 github_issue 暴露的待验证使用条件。

18. 安全/权限坑 · 来源证据：Flush plan: models hallucinate 'memory-candidates/' paths and flush-plan.md grows indefinitely

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：Flush plan: models hallucinate 'memory-candidates/' paths and flush-plan.md grows indefinitely
  • 对用户的影响：可能影响授权、密钥配置或安全边界。
  • 证据：community_evidence:github | https://github.com/joshuaswarren/remnic/issues/1483 | 来源讨论提到 node 相关条件，需在安装/试用前复核。

19. 安全/权限坑 · 来源证据：LCM summarizer bypasses taskModelChain, falls back to gateway default model chain

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：LCM summarizer bypasses taskModelChain, falls back to gateway default model chain
  • 对用户的影响：可能影响授权、密钥配置或安全边界。
  • 证据：community_evidence:github | https://github.com/joshuaswarren/remnic/issues/1473 | 来源类型 github_issue 暴露的待验证使用条件。

20. 能力坑 · 失败模式：capability: Make context recall append instead of prepend

  • 严重度：low
  • 证据强度：source_linked
  • 发现：Developers should check this capability risk before relying on the project: Make context recall append instead of prepend
  • 对用户的影响：Developers may hit a documented source-backed failure mode: Make context recall append instead of prepend
  • 证据：failure_mode_cluster:github_issue | https://github.com/joshuaswarren/remnic/issues/1479 | Make context recall append instead of prepend

21. 运行坑 · 失败模式：performance: v9.3.643

  • 严重度：low
  • 证据强度：source_linked
  • 发现：Developers should check this performance risk before relying on the project: v9.3.643
  • 对用户的影响：Upgrade or migration may change expected behavior: v9.3.643
  • 证据：failure_mode_cluster:github_release | https://github.com/joshuaswarren/remnic/releases/tag/v9.3.643 | v9.3.643

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

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

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

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

24. 维护坑 · 失败模式：maintenance: v9.3.636

  • 严重度：low
  • 证据强度：source_linked
  • 发现：Developers should check this maintenance risk before relying on the project: v9.3.636
  • 对用户的影响：Upgrade or migration may change expected behavior: v9.3.636
  • 证据：failure_mode_cluster:github_release | https://github.com/joshuaswarren/remnic/releases/tag/v9.3.636 | v9.3.636

25. 维护坑 · 失败模式：maintenance: v9.3.637

  • 严重度：low
  • 证据强度：source_linked
  • 发现：Developers should check this maintenance risk before relying on the project: v9.3.637
  • 对用户的影响：Upgrade or migration may change expected behavior: v9.3.637
  • 证据：failure_mode_cluster:github_release | https://github.com/joshuaswarren/remnic/releases/tag/v9.3.637 | v9.3.637

26. 维护坑 · 失败模式：maintenance: v9.3.638

  • 严重度：low
  • 证据强度：source_linked
  • 发现：Developers should check this maintenance risk before relying on the project: v9.3.638
  • 对用户的影响：Upgrade or migration may change expected behavior: v9.3.638
  • 证据：failure_mode_cluster:github_release | https://github.com/joshuaswarren/remnic/releases/tag/v9.3.638 | v9.3.638

27. 维护坑 · 失败模式：maintenance: v9.3.640

  • 严重度：low
  • 证据强度：source_linked
  • 发现：Developers should check this maintenance risk before relying on the project: v9.3.640
  • 对用户的影响：Upgrade or migration may change expected behavior: v9.3.640
  • 证据：failure_mode_cluster:github_release | https://github.com/joshuaswarren/remnic/releases/tag/v9.3.640 | v9.3.640

28. 维护坑 · 失败模式：maintenance: v9.3.641

  • 严重度：low
  • 证据强度：source_linked
  • 发现：Developers should check this maintenance risk before relying on the project: v9.3.641
  • 对用户的影响：Upgrade or migration may change expected behavior: v9.3.641
  • 证据：failure_mode_cluster:github_release | https://github.com/joshuaswarren/remnic/releases/tag/v9.3.641 | v9.3.641

29. 维护坑 · 失败模式：maintenance: v9.3.642

  • 严重度：low
  • 证据强度：source_linked
  • 发现：Developers should check this maintenance risk before relying on the project: v9.3.642
  • 对用户的影响：Upgrade or migration may change expected behavior: v9.3.642
  • 证据：failure_mode_cluster:github_release | https://github.com/joshuaswarren/remnic/releases/tag/v9.3.642 | v9.3.642

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