← Back to home@Ersith

akasha-book

阿卡夏之书（Akasha Book）— an auditable external memory layer for LLM agents: six purpose-typed stores, supersession chain, bi-temporality, write gating, DSH plugins, paper included.

Stars
0
Language
JavaScript
Created
Oct 7, 2026
Updated
Oct 15, 2026
MCPMemory
GitHub repo

Introduction

阿卡夏之书（Akasha）· 可审计外置记忆层

面向语言模型智能体的可审计外置记忆层（模型无关、文件式、零依赖 Node）。 论文（设计、实现与初步运营报告 v0.5）：paper/akasha-paper-20261007.md。

这是什么（摘自论文）

语言模型智能体存在结构性「记忆赤字」：权重内的记忆不可审计、不可更正；提示内的记忆随会话消亡；而全量日志又会因「读写成本倒挂」而膨胀。阿卡夏之书把记忆当作一个需要治理的工程对象：

  • 六库分工：canon（稳定知识）/ mirror（叙事镜像）/ orphan（零权重孤案）/ pricing（行为定价）/ lexicon（情绪词表）/ frontier（文献基石）——按用途切分，各自带复核周期；
  • 可审计的演化：append-only + 修订链（supersedes，永不改原文）+ 双时态（事件时间 × 记录时间）+ 写入门控——「何时发生 / 何时记下 / 何时被改」三问皆可回答；
  • 分层强制力：软协议 → 机检（check / 门控）→ 审计与定价；来源态四标签（学过 / 接触过 / 记得·库内 / 搜到）；排序钉子「无据的确定 ≪ 有据的不确定」；
  • 离线巩固：睡眠（追加式蒸馏）+ 会话层（单会话记忆：段抽取 / 结论优先检索 / 弧线树导航 / 循环观测（dry 干跑，只观测不干预））；
  • 姿态：换模型不换大脑——全部资产（数据 + 工具面 + 钩子 + 纪律文本）都在模型之外。

完整的记忆架构：三套系统，各管一域（阿卡夏并不独自完整）

阿卡夏之书不是一套自足的记忆系统。它只覆盖长期记忆三类中的一类；只部署它，得到的是一个「守纪律但不了解你和你的项目」的智能体。我们实际运行的组合是三套互补系统：

系统管什么它负责回答形态
阿卡夏之书（本仓）「我」我凭什么这么判断？我犯过什么错？这条结论多可信、何时该复核？六库 append-only + 修订链 + 来源态四标签 + 行为定价
OpenViking「人」用户偏好什么、在意什么？这件事最初怎么谈的？他在别的项目里怎么说的？viking:// 虚拟文件系统（记忆 / 实体 / 事件 / 偏好 / 技能 / 资源）
Hindsight「仓」这个代码库为什么长成这样？当初决定了什么、还有什么没做？仓库级知识页（git 历史 + 会话 + 摄取文档）+ 检索 / 反思 / 捕获工具

为什么必须是三件（互补，不是重复）

  • 缺阿卡夏 → 判断与教训无处沉淀：没有来源态、没有修订链、没有定价，「改口」无法追溯；
  • 缺OpenViking → 不知道「人」：偏好当通用解、源头讨论丢失，跨项目事实每次重新问；
  • 缺Hindsight → 不知道「仓」：架构沿革与在办事项无从查，已经定过的问题被反复重开。

三者如何协作

  • 五源路由：模型内记忆 → skill → 阿卡夏 → 并存记忆层（OpenViking / Hindsight）→ 网页；查了什么、结果如何一律留痕。
  • 写回按归属：说「记住这个」时先判归属再落库——偏好 / 身份 / 跨项目 → OpenViking；架构 / 约定 / 决策 / 在办 → Hindsight；判断 / 教训 / 纪律 / 定价 / 观测 → 阿卡夏。
  • 不复制、靠引用：三者各自 append-only，交叉引用走 ID / URI，不搬运原文（避免三份"真相"互相冲突）。

接入方式（本仓视角）：阿卡夏＝本仓核心 + 五个 DSH 插件（见下节）；OpenViking / Hindsight ＝ DSH 侧的 MCP 与插件接入（例如 mcp__openviking__* 工具面、@vectorize-io/hindsight-coding-agents）。本仓不捆绑、也不代替它们——本节声明的是架构依赖关系：只用本仓，记忆层是不完整的。

边界（诚实）：阿卡夏的强项是「可审计的自我治理」；它天然不知道你的偏好与你的仓库沿革。把偏好硬塞进 canon、把架构决策塞进 orphan 都会污染其权威域——「三套分工」是设计前提，不是可选装饰。

目录

  • core/ —— 核心库（零依赖 Node）：CLI / MCP server / 自检 / 数据规范 / 软协议。从这里开始 → core/README.md
  • plugins/ —— DeepSeek Harness（DSH）宿主插件五件：
    • @akasha-book/gate：写入门控 + 纪律注入（渲染时读库）
    • @akasha-book/hooks：事件记录 + 输出审计（usage / output-audit 观测线）
    • @akasha-book/sleep：调度与注入条子（睡眠摘要 / 库脉搏 / 回查提示 / 唤醒条）
    • @akasha-book/session：会话层调度（增量索引 / 压缩事件行 / 节奏条）+ 循环观测 P0
    • @akasha-book/mcp：MCP 注册桥
  • paper/ —— 论文 v0.5（设计、实现与初步运营报告）
  • docs/INSTALL.md —— 安装与配置（含五插件所需配置、验收四条、以及我们踩过的坑：配置别只写在包内 patch）
  • docs/observation-metrics.md —— 观察口径与方法（C1/C3 基线期→观察期；六指标定义写死、判定先注册、负结果入库）
  • docs/c1-c3-schedule.md —— C1/C3 设计计划（待评审）：动作前坑提示 + 断言前事实把关；含触发逻辑、落点、开关与验收、6 个待评审问题
  • docs/ab-task-battery.md —— A/B 任务电池与执行清单（20 题、双臂、盲评评分表、成本与闸门）
  • docs/recall-preventability-test-plan.md —— 可预防性整体测试计划（三档证据表 / 盲化判定 / 阈值由代价推导）
  • docs/ab-experiment-design.md —— 开/关对照实验设计（H1–H5 判决变量、双臂交替、盲评、负结果也入库）
  • docs/observation-ledger.md —— 观察台账（基线快照 / 漏召率复盘 / 候选池五项评估 / A1·A2·arousal·rank 的判据）
  • docs/upstream-contracts.md —— 对 DSH 的耦合点（消息形状 / 工具定义 / 装载 / 观测线）与「升级宿主时的固定检查动作」
  • deps.md —— 依赖标注（平台 / 插件 / npm）
  • CHECKS.md —— 发布前隐私与安全扫描记录（四轮 + 维护同步复扫）

30 秒跑通（只需 Node）

cd core
node init-example.mjs      # 初始化示例库（六库中性示例 + frontier 文献基石）
node test.mjs              # 137 项自检（示例库口径；全绿 = 可交付）
node akasha.mjs brief 修订  # 主题简报（跨六库取料，带来源态与时间坐标）
node akasha.mjs lookup 信任 # 检索
node akasha.mjs mirror match 虚构 危险   # 镜像结构匹配
node akasha.mjs session loopwatch        # 循环观测（dry 干跑）汇总
node mcp.mjs               # MCP stdio server（18 工具）

DSH 插件安装（可选）

  1. 从 npm 安装（推荐）：npm i @akasha-book/gate（其余四件：@akasha-book/hooks / @akasha-book/sleep / @akasha-book/session / @akasha-book/mcp），或在 DSH 插件管理器里直接用包名安装；

  2. 或取 Release 附件里的五个 *.tgz，用 DSH 插件管理器安装；或从源码自行打包：cd plugins/akasha-gate && npm pack（其余四件同法；零依赖，产物即 tgz）；

  3. 配置：默认值均指向 ~/.akasha（家目录，运行时计算）；会话层的 sessionsRoot 指向你的宿主会话档案目录——细节见各插件 README.md 与 cordis.patch.yml。

  4. 上架状态（DSH-Store）：五件均按 DSH-Store 契约完成整改——dsh.compatibility.dshReleases 三版窗口（0.2.0-rc.2 / 0.2.1-alpha.1 / 0.2.1-alpha.2）逐版本声明，且三版各跑过一次性 Profile 的装-启-卸验收（证据在各自 EVIDENCE.json）；五件均已提交上架申请。其中两件为满足其硬边界做过实质改造：sleep 把唤醒条消息改为插件本地构造（原先动态加载宿主 dsh-llm，被其静态扫描判为扫描面不完整）；mcp 改为自带 stdio 客户端的自注册桥（原先的 Bundle Patch 需为官方 MCP 客户端添加配置行，触发 SUBMISSION_PATCH_PROTECTED）。这两处耦合与「升级宿主时的检查动作」登记在 docs/upstream-contracts.md。

状态与边界（诚实）

  • 测试期：六库数据面与插件处于「冻结 → 受控解冻」治理周期（论文 §5.3），接口可能随测试修正；当前核心自检 137/137（示例库口径；另有 zstd 用例在 Node <22.15 上 SKIP）、五件插件自检全绿。
  • 本项目不捆绑任何模型与凭据；插件默认不采集网络数据。
  • 循环观测为 dry 观测——不干预、不注入；干预版本待数据积累与逐条裁定。

License

MIT（见 LICENSE）。