@felan-ai/下册
便携式本地第一记忆合同,马克当文物政策,验证, 以及Felan主机的Pi扩展行为.
软件包根需要核心 felan.runtime@1, (中文(简体) ), felan.models@1,以及
felan.sessions@1 服务。 它拥有当地商店,项目协调,
检查站恢复、梦想、保留和 /memory 命令.
守护进程通过它每个代理目录共享一个内存协调员 届会。 已装入的根会话, 主机提供工人和运行时间 寿命可以驱动处理。 读者会话和有限的主机可以记住 - 读者不记录检查站. 处理工作由事件驱动,有针对性地进行复原复试和编剧再检查 而不是一个投票监视器。 文件与原子 存储操作使用范围 运行时; 模型选择使用认证 模型外观. 受限制的梦想会 和生命周期的结算 会议。 缺少工人或终身能力使加工无法进行,而不是 开设独立无轨工人.
@felan-ai/ext-memory/daemon 导出默认守护进程提供者,并
createMemoryDaemonProvider(options?)它规定 felan.memory.scheduler@1, (中文(简体) ),
需求 felan.host.maintenance@1,可选择使用 felan.host.models@1。 。 。 .
提供者与扩展的协调员分享,并保持一个持续
每个已发现的工程附件, 因此未完成的工作可以运行, 没有装入
届会。 它在两秒内会合协调器状态并重新扫描
每十分钟一次 没有主机模型, 它跟踪项目, 但禁用调度 .
计时器 status() 返回每个被跟踪的工程根及其内存状态.
主机可以提供 a runtime 实例或实例 () => AgentRuntime 工厂呼叫
启动时, 额外 projects,以及项目对会 selector。 。 。 .
明确项目根解每活化一次. discover 默认为 true· ;
准备吧 false 只跟踪 projects 不列出存储的项目目录.
对于共享团队记忆,通过团队工作空间在 projects, (中文(简体) ), discover: false, (中文(简体) ),
和返回的选择器 { kind: 'all' }。默认情况下,会话列表包括
cwd 解决同一项目,包括 git 子目录.
检查点和历史记录显示使用宿主的全部授权库存.
附件使用主机允许的模型范围,并在重新扫描时刷新.
主机排出 立即停止 排出每个持续附件.
和解解开提供者并释放其
协调员的参考资料,而不结束其他会议的附件.
运河布局仍然 <agentDir>/memory/v1/projects/<projectKey> 财务报告和审定财务报表
保留日记 <agentDir>/sessions/memory一会 .memory
目录为非授权投影. 现有检查站和文物
不被此更改迁移或重置.
保留工人编成一个记忆类的Pi期刊;运行时将其条目附加到 保存的文件并在记录结果之前冲出它们。 延期 不使用 Pi 的本地文件系统持久性 .
materializeMemorySessionCheckpoint 读取以修订为主的、平分的会话
具有原始身份和完整日记的历史,包括废弃的
树枝。 缺少历史、订正漂移和证据变化仍然明确
失败,而不是空置成功的预测.
状态、历史视图和命令反馈使用 pi.ui客户可以提供
内存历史提示,但它得到的通用元素和行动与
其他客户. /memory open 在启动前询问合格的主机控制台
文件系统查看器。 无法获取的演示文稿不会阻止检查站的捕捉.
内存是一个 Markdown wiki 包含 summary.md, (中文(简体) ), index.md主题
下页 pages/. 概述只是取向:实质性索赔
应遵循相关领域和主题页面的索引并引用其路径
财务报告和审定财务报表 Sources 会话标识 。 主机对每个项目进行非授权复制
root会话并保留在客户存储库外的cononial存储.
Markdown链接是普通的不可信内容,从不制作文物
无效。 出版物验证执行 文物形状和版本,安全
和唯一路径,需要快速文件、资源限制、页面出处,以及
可选源片段允许列表; 链接目标和导航质量
最佳内容关注。 对供应问题敏感的消费者可以使用
mode: 'read'安全地执行固定的Markdown文件,
独一无二的路径,但将出处缺陷视为非致命和供应空的
当两个快速文件都不存在时,摘要/索引默认值。 出版物征集者
可禁用来源检查 requireSources 并限制引用
sourceSessionIds。 。 。 .
扩展附件 :
会话开始 。 后来的提供者调用复用该会话语境,而不是
在每个信件上插入新信件 context 活动。 如果收缩或树
导航从活动分支中删除消息,扩展恢复
一个副本。 信件被排除在检查站证据之外,所以内存不能
学习自己的注射快感.
当用户明确要求记住、忘记或改变记忆时,会话 即时请求代理商留下简洁的,归属的内存注释而不是 要求立即更新证据 后作梦者取出原作 用户授权请求作为直接证据; 助理注释只是指针 对这一要求.
扩展的协调员梦想着做一个一次性的无头派
页 次 .dreaming/input 财务报告和审定财务报表 .memory 目录. 梦中人
使用读取/列表/grep/edit/write文件工具外加删除范围化工具
阶段中单个非索引马克下页 .memory/pages它没有
普通扩展,技能,寄存器访问,或 shell 执行. Grep 可以吗
仅发射 rg 超过已分阶段输入和wiki文件;任意命令仍然被拒绝。 它回来了
在编辑了 Markdown 工艺品之后, 才进行总结。 扩展验证
,并公布文件系统输出;失败或被取消的工作仍有待完成.
带有可选运行时间分类器的可移植扩展组毗连
将证据切入提供者大小块并询问每个条目是否需要
检查或是完全短暂的噪音。 模型服务提供
分类器;每个会话的扩展阶段只读检查和噪音,以及
写一个剪切的已上演路径地图。 对于只检查文本的记录,主机
工读器 inspect.txt 视图,带有会话/条目标识、角色、,
工具名称和完整文本。 混合区块或未支持区块留在原区内
检查JSONL 而不是默默地缩短。 工人看风景
如果有,否则JSONL的来源,
可能 grep 噪声用于上下文, 组织 wiki, 并保存原始条目 ID
和来源。 原始笔录仍在制作中,可供
核查或全面审计后退。 超规模或不确定的项目
检查; 缺少或无法使用的分类使用原始全审计
工作流程。 Triage不决定最终维基保留或即时放置.
分类器按会话排列问题 canEvaluate 能力;
超大小的条目、缺失的答案和交互式用户答案仍然安全
检查。 工人核对所有证据
和会话,独立审核前维基,并使用介质思维.
它从
根会话配置的模型范围, 偏爱它的提供者和模型
家庭,没有升级;没有合格模型时,证据仍未确定
已提供。 带有分类符的笔录摘录可能会留下
本地进程; 已识别的证书模式被编辑, 但未知
秘密可能会留下.
它不实行单独的转折、工具调用或每个文件I/O预算;它唯一的
执行故障安全 是一个一小时的墙上时间超时。 主机可以通过可重播
async JSONL 线源到 materializeMemoryInputDelta 以验证检查站
分出分出分出,并形成一个定型的,被修改的可见分出分出三角洲. 差异
线条发出完整的当前分支 。 输出限制拒绝超大小
而不是切换 JSONL 记录。 会话提供者提供完整的日记;扩展阶段成功
预测。 大型源会话
文件不只因其总大小而被拒绝。 无法设置的检查站
实现被删除并被记住 state.json所以它没有被重审
在重新启动后; 运行将补足其批次的下一个待定检查站.
记忆计划保持了维基稀疏. 它优先考虑持久用户授权 事实、偏好、决定、更正和未编码的理由陈述 未经核实的发现、事件和运行时间或外部系统 观察。 它不映射寄存器的来源,文档,配置, 测试、常规任务状态、原始工具输出或重复摘要。 仓库 只有掌握了有用的理由、事件和事实,才保留事实 错配,或未记录在 仓库。 每个梦想运行 审计完整的 现有wiki 并删除 不合格、陈旧、重复、重叠或不必要的内容;有效来源 单凭引文并不能提出值得保留的索赔.
发展
资料来源: packages/ext-memory 内 https://github.com/felan-ai/felan 页面存档备份,存于互联网档案馆。 。 。 .
pnpm --filter @felan-ai/ext-memory build
pnpm --filter @felan-ai/ext-memory type-check
pnpm --filter @felan-ai/ext-memory test
一揽子边界和要求
软件包拥有记忆政策和生命周期行为. 运行时供应商拥有
文件系统/进程访问,模型提供者拥有证书和允许模式
课程提供方拥有工人录用和课程
一辈子 软件包需要兼容 @felan-ai/agent-core 对等并有
没有应用程序, TUI, Supabase 或云运行时依赖.
内存和笔录内容是不信任的参考数据,不能覆盖 系统、开发者、用户、授权或工具安全规则.
相关文件
归属
马克下沉的记忆计划 和梦想政策 改自费兰 文件系统-模拟执行。 剩下的包代码是原始的 Felan 项目代码。 见 通知 财务报告和审定财务报表 自由主义。 。 。 .