Skip to content

feat(context): 层级项目指令、长期记忆与恢复点浏览 #106

Closed

Description

@Qiyuanqiii

Parent: #98

问题概述 / Summary

项目已有安全的上下文压缩、来源标记和 narrowing-only .prayu 配置,但缺少按目录作用域发现项目指令、用户/项目长期记忆、会话分支以及 Checkpoint/Fork/Resume 浏览体验。需要建立可解释、可删除、不会授权提权的长期上下文模型。

优先级 / Priority

P1。可与 P0 工具运行时并行,恢复点 UI 与 Workspace Checkpoint 最终对接。

当前基线 / Current baseline

  • 上下文管理器支持有界压缩、来源/信任标记和 Run 快照。
  • feat(config): narrowing-only 的 .prayu 项目级配置 #54 已交付只能缩小权限的 .prayu 项目级结构化配置。
  • 尚无类似 AGENTS.md、CLAUDE.md 或 rules 目录的层级发现、目录作用域、冲突解释和生效视图。
  • 没有用户/项目记忆生命周期、branch-aware session tree 或可视化 Fork/Resume/Checkpoint 浏览。
  • 仓库文档属于不可信内容,不能覆盖系统/用户指令或授权能力。

范围 / Scope

  • 定义 project-instruction discovery:支持明确文件名/目录、向上继承、最近目录优先、作用域边界、大小/深度限制、ignore 和稳定 fingerprint。
  • 建立固定优先级:系统/用户 > 运行时安全策略 > Run 显式选择 > 项目指令 >普通文件/工具输出;冲突和被忽略内容可解释。
  • 每段指令保存来源 path、content hash、scope、加载时间、trust 和适用文件;Run 创建时固化快照,运行中漂移需显式刷新。
  • 项目指令只能影响工作习惯、格式和验证建议,不能启用工具、网络、Secret、Debug、Plugin/Hook 或改变 Go Policy。
  • 提供显式 user/project memory:创建、查看、编辑、禁用、删除、保留期限、来源和引用;默认不从对话/文件静默提炼长期记忆。
  • 将 compaction summary、关键决策、Artifact、checkpoint 和 Git branch 组成可浏览 session tree,支持从节点 Resume/Fork。
  • Fork 继承明确列出的上下文/配置快照,不继承过期 capability、审批、进程、terminal lease 或网络授权。
  • Desktop 提供“为何生效”、冲突/过期提示、记忆管理、恢复点和分支比较;CLI/OpenAPI 提供等价导出。

非目标 / Non-goals

  • 不执行项目指令中的 Shell、Hook、Plugin、MCP 或安装步骤。
  • 不自动兼容其他 Harness 的所有私有语义,也不把其配置视为可信。
  • 不把 Secret、完整聊天、终端输入或敏感文件默认保存为长期记忆。
  • 不用长期记忆绕过上下文预算、数据保留或用户删除。
  • 不在本 Issue 实现 Workspace 文件内容恢复引擎。

涉及目录 / Affected directories

  • internal/contextmgr/
  • internal/projectconfig/
  • internal/application/
  • internal/domain/
  • internal/workspace/
  • internal/store/
  • internal/events/
  • internal/policy/
  • internal/httpapi/
  • cmd/
  • web/src/
  • docs/

依赖 / Dependencies

  • 层级指令与长期记忆可独立交付;恢复点/Fork UI 最终消费“可逆编辑、Checkpoint/Rewind”定义的 Workspace checkpoint。
  • 必须复用 feat(config): narrowing-only 的 .prayu 项目级配置 #54 的配置来源、narrowing-only 合并和 Run fingerprint,不另建可提权配置层。

验收条件 / Acceptance criteria

  • 嵌套目录项目对同一文件得到确定性指令集合、顺序、scope、hash 和“为何生效”解释。
  • 项目指令无法启用工具/网络/Secret/Debug/Plugin,恶意 Prompt 与路径逃逸测试 fail closed。
  • Run 固化指令快照;文件变更不会静默改变正在运行的任务,刷新有 diff 与确认。
  • user/project memory 只能显式写入,支持 provenance、编辑、禁用、删除、retention 和导出。
  • Secret/credential/终端输入和敏感路径有检测与拒绝/脱敏,不进入默认长期记忆。
  • compaction、Resume 和 Fork 保存决策来源且不复活过期权限、进程或审批。
  • Desktop 可浏览 session tree、恢复点、branch、记忆和配置来源,并解释冲突/过期状态。
  • Windows/Linux 路径、大小写、symlink、深层目录、并发修改、重启和数据迁移测试通过。
  • OpenAPI/CLI、威胁模型、数据删除说明和双语文档完成。

安全边界 / Security boundaries

“长期存在”不代表“更高优先级”。所有项目指令和记忆始终低于系统、用户与 Go 安全策略,并且不能成为授权来源。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent-runtimeAgent orchestration, memory, and extensionsenhancementNew feature or requestgoPull requests that update go codehelp wantedExtra attention is neededjavascriptPull requests that update javascript codesecuritySecurity boundary or high-risk capability高难度

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions