Ayou-Claw/flowctx-dsh

README excerpt

flowctx-dsh 面向 DeepSeek Harness 的本地优先上下文引擎。当前任务保留原文，临近历史可逆压缩，更早历史折叠为工程师交接笔记，关键材料始终可恢复。 核心能力 · 为什么需要它 · 三档记忆模型 · 集成架构 · 评测 · 安装 · 配置 · 适用场景 · 流程演示 [!TIP] 核心理念 ：flowctx-dsh 不把上下文视为「装满即截断」的缓冲区，而是将一次 AI 编程会话看作一段有纵深的工作记忆—— 越近的信息越清晰，越远的信息越凝练，但均不被真正遗忘 。 flowctx-dsh 在 dsh-compaction-basic 之上做加性扩展：完整继承其压力检测、范围选择、KV-cache 重放、事务管理与溢出恢复能力，仅将「通用摘要」替换为面向软件工程的交接笔记，并新增三项能力。 所有扩展均可逐项开关；全部关闭时，其行为等同于仅调整了摘要风格的 dsh-compaction-basic 。 核心能力 flowctx-dsh 提供四项能力，覆盖「工具结果返回 → 历史折叠 → 主动取回 → 工作记忆」的完整链路： 能力 Hook / 触发点 作用 默认 :-: : : 1 工程师交接笔记摘要 agent/pre-step （替换提示词） 摘要输出 6 段式交接笔记，专节保留失败路径与逐字标识符，而非通用叙述 ✅ 开 2 分层 DAG 摘要 agent/pre-step （另挂一条） 历史后台 fire-and-forget 折叠成分层 summary nodes（leaf 折叠 + condense 逐级压缩），不阻塞关键路径 ✅ 开 3 可逆工具结果投影 tools/post-execute 超阈值 tool result 结构化压缩，原文按 hash 存入 CompressionStore，可 byte-exact 取回 ✅ 开 4 可编辑工作记忆 flowctx scratch 工具 模型自维护的 块，注入进入 LLM 的消息流 ⚪ 关 配套工具 flowctx retrieve ：按 hash 取回被投影压缩的原文，或按 node id 取回指定层级的交接笔记。 展开查看：各项能力的设计要点 1 · 工程师交接笔记摘要 通用摘要倾向于保留「成功方向」，对已排除的路线一笔带过，易导致 Agent 重走弯路；session id、commit hash、函数名、文件路径等也常被改写为自然语言，引用时出错。交接笔记以固定 6 段结构对这些信息 分节保留 （详见交接笔记格式）。 2 · 分层 DAG 摘要（后台异步） 与 DSH 原生 Layer 2 的 同步 压缩不同： agent/pre-step 仅执行一次纯函数规划，真正的摘要 LLM 调用在关键路径之外异步执行，不阻塞当前步骤。同一会话若在摘要过程中再次触发，旧任务将由…

Category