Mshir0/context-graph-deepseek-harness

README 摘要

Context Graph for DeepSeek Harness 面向 AI Coding Agent 的工程上下文管理插件。它直接加载到 DeepSeek Harness 的对话界面，在对话与轨迹旁提供 Context Graph 视图，并在模型请求前编译、审计和注入与当前任务相关的工程上下文。 它不是独立软件，不启动额外网页，也不替换 Harness 的模型客户端。 解决什么问题 AI Coding Agent 通常同时面对三类信息：当前任务、项目记忆和源码依赖。全部发送会浪费上下文预算，只发送当前一句话又容易遗漏接口约束。 Context Graph 把这些信息拆成可追溯的节点和关系： 特性 语义功能图 - 用功能、任务、需求、约束、决策、问题和备注描述“系统做什么”。 - 功能节点可以映射到多个实现文件，支持合并、拆分和手动调整。 - 语义视图默认隐藏 import、call 等实现细节，避免功能图被代码关系污染。 实现与依赖图 - 扫描 Python、C 和 C++ 模块、符号、调用、继承、接口和项目内依赖。 - 支持增量扫描、变更检测、调用方/被调用方查询和接口提取。 - 自动关系只在源码证据足够明确时生成；不猜测宏展开、重载歧义或外部符号。 C/C++ 解析 支持以下扩展名，无需安装 clang： 可提取： - 项目内 include 关系 - 类和结构体 - 函数定义与声明 - 唯一可确认的函数调用 - 继承关系 源文件和头文件使用独立模块 ID，避免同名文件冲突。无法唯一确认的关系会保留为未知，不会自动写入错误依赖。 上下文编译与防火墙 - 从任务或功能目标开始，只选择相关的结构化上下文和少量实现文件。 - 支持单轮预算、相关实现文件数量、语义关联层数、临时包含/排除和上下文复用。 - 在 agent/pre-step 编译 Context Snapshot，在最终 llm/stream 请求边界执行消息、快照、工具和 token 审计。 - FORCE INCLUDE 、 FORCE EXCLUDE 和用户确认的 MANUAL 关系优先于自动分析。 - 普通对话无法推断目标时使用空的 context.none 快照，不会因为图谱暂时不可用吞掉用户输入。 原生 Harness 界面 - Context Graph 作为 Harness 对话区域的原生视图标签。 - 支持中文、明暗主题、节点拖动、画布平移、缩放、自动排布和属性编辑。 - 右下角输入框可直接发送普通对话；“上下文”按钮用于创建持久任务、选择任务类型和调整本会话注入策略。 - Context Preview 显示包含项、排除项、来源、原因、token 统计和最终审计结果。 环境要求 - DeepSeek Harness 0.1.0-rc.6 或更新的 0.1.x - Node…

分类