dsh-knowledge-graph

DSH PLUGIN记忆与知识

仓库 cwbcheng/dsh-knowledge-graph · npm dsh-knowledge-graph

记忆与知识 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

为 DeepSeek Harness 提供知识图插件:把正文、PDF、图片或会话轨迹用 AI 拆成事实、推论、概念等节点与关系的知识图,并与原文双向定位。

一句话选型结论

按资料字段整理

dsh-knowledge-graph 是记忆与知识类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类记忆与知识 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 1 复刻 0 · 未关闭 issue 0
最近更新 2026-10-11 创建于 2026-08-14
README 167.5 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:cwbcheng/dsh-knowledge-graph
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.0-rc.2 等 9 个,Node.js 要求 >=22.13;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.0-rc.2 等 9 个版本版本不匹配时安装会报错
Node.js 要求>=22.13来自仓库 package.json 的 engines 字段
前置依赖@deepseek-ai/cordis@^4.0.1需要同时安装的同级依赖
npm 包名dsh-knowledge-graph可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-knowledge-graph:DeepSeek Harness 里把资料拆成知识图的 DSH plugin

  • 正文/PDF/图片 AI 拆解成知识图
  • 8 类节点、12 类关系语义契约
  • 知识图与原文双向定位高亮
  • 关系感知分层布局与邻近压缩
  • 《学习观》本体与知识坍缩诊断

适用场景

记忆文件读写

上游标签

aicordis-plugindshdsh-pluginknowledge-baseknowledge-graph

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-10-08): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询
— · 其它检查项
  • L4_0_SANDBOX 沙盒安装判定 方式:沙盒安装执行

风险详情

  • 审查结论 通过
  • 结论说明 vet 静态分析未发现可疑行为,判定为干净(clean)。
  • 风险计数 严重 0 / 高 0 / 中 0
  • 风险详情 未发现严重或警告级问题。

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.0-rc.2 等 9 个),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 需要同时装好同级依赖,漏装会启动失败。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在记忆与知识场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-knowledge-graph当前 L5 · 运行验证通过 低风险 1 0.2.0-rc.2 等 9 个 有
ruflo L3 · 安装规范通过 低风险 7.4 万 未标注 无
OpenViking L3 · 安装规范通过 低风险 3.9 万 未标注 无
WeKnora L4 · 沙盒安装通过 低风险 3.3 万 未标注 有
distilly L4 · 沙盒安装通过 低风险 2.5 万 未标注 有
EverOS L4 · 沙盒安装通过 低风险 1.3 万 未标注 有

仓库档案

记忆与知识
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方cwbcheng仓库 dsh-knowledge-graph · 默认分支 main
分类记忆与知识memory
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue1 / 0 / 0收录时的数值,非实时
创建 / 更新2026-08-14 · 2026-10-11最后推送 2026-10-11
本站收录2026-09-21首次进入本站目录的时间

README 全文

167.5 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-knowledge-graph

中文 | English

DSH(DeepSeek Harness)Cordis 插件:把任意一段资料正文、包含文字 / 图示 / 表格的图片——或一段 AI 会话执行轨迹——用 AI 拆解成一张知识图,并在知识图与原文之间双向定位。

> 贴原文 → AI 异步拆图 → 双向锚点定位。是 NovelStudio「知识图工作台」落地为独立、可复用插件的形态。


它能做什么

  • 后台生成知识图:输入任意正文(章节、技术文档、学习笔记…),后台任务模式调用 LLM,完成后保存知识图。支持最长约 100 万字符的书级正文;documentId 是随机稳定的逻辑文档 UUID,sourceId 是全文 SHA-256 的不可变版本身份,chunkId 绑定 sourceId + batch + paragraph range,因此不同文档/追加版本不会因局部 chunk-0001 重号而覆盖。常驻模式把全文、canonical graph 与无损 checkpoint 保存在 SQLite;刷新后浏览器只凭 documentId/runId 恢复,只有 Host 重启遗留的 running 任务才允许从 checkpoint 续跑,显式 failed/cancelled 任务绝不自动重试。
  • PDF 直接生成知识图:工作台可直接上传不超过 15 MiB 的可搜索 PDF,本地有界解析正文后自动填入资料区并开始生成知识图;文件数据只用于本次解析,不写入浏览器草稿。复杂排版、特殊字体编码可能导致文本不完整;扫描版 PDF 当前不做 OCR,需先转换为可搜索 PDF。
  • 图片直接生成知识图与已有 Markdown 插图解读:工作台可一次上传 1–4 张 PNG / JPEG / WebP / GIF(单张不超过 6 MiB、合计不超过 16 MiB),支持纯文字截图、示意图 / 流程图 / 架构图、统计图、公式和表格,也可同时附带说明文字。Host 把图片交给 DSH attachments.saveImages() 验证并保存,再用多模态模型生成带图片范围的视觉转写;知识抽取器只消费这份转写。对于已导入 Markdown 文件夹且保留附件的知识图,在「解读与核对图片」中可搜索、筛选并勾选任意 1–4 张未解读图片,将转写追加为有来源标记的段落与候选节点,不覆盖原始 Markdown 或旧节点内容。逐图查看原图、转写、识别疑点与全图关联节点;超出当前渲染窗口的节点也可点击定位。结果页保留原图预览与 source.visualSource 回链。视觉转写可把箭头 / 连线、分组 / 包含、对象对应、顺序和具有图例语义的颜色 / 形状编码拆成独立关系单元;无法准确映射到内置 relation 的关系保留为原子 fact / claim,不强套错误边。AI 转写不是原书文字,也不能单凭文字引用证明像素内容正确;新增节点保持待复核,关键文字、数值、表格和连线关系须对照原图。
  • 8 类节点 / 12 类关系:
  • 节点:fact 事实 · claim 主张 · inference 推论 · concept 概念 · definition 定义 · example 例子 · counter_example 反例 · rule 规则。
  • 关系:supports 支持 · example 例子 · counter_example 反例 · defines 定义 · infers 推断 · causes 因果 · is_a 属于 · contains 包含 · driven_by 受驱动于 · not_is 不是 · analogy 类比说明 · aims_at 旨在。
  • 最小语义契约:一个节点只表达一个原子命题;作者的理论/经验概括用 claim 而不是 fact;保留“可能 / 多数 / 通常 / 必须 / 如果”等原文限定;存在更精确关系时不退化成 supports。
  • 解释覆盖复核:首轮抽取通过后,仅在多步机制疑似欠覆盖,或原文明示纠偏/防误推理限定、留待后文回答的信息却未进入图时,执行一次受限复核;它也可恢复被多个核心命题反复引用的稳定概念锚点。调用可选复核器前,系统会先对原文明示且同句已命名的“某方法在明确条件下行不通/失效”原子结论做确定性、只增节点的补漏;相关关系仍必须由关系编织器依据直接原文证据审定,不会因端点同段出现而自动连边。复核通常只能补缺失节点及其必要关系;对于【图示关系】段落,若箭头、连线标签、分组、对应或图例直接证明允许 relation,也可只补两个已有节点之间的遗漏边;该例外仍要求同一条 evidence quote 同时包含 relation 专用显式词、两个端点及兼容方向。复核不能重写已有图,也不会为了连通率补知识。
  • 《学习观》本体知识图(learning-view-v1):第二套抽取本体,不是对既有图的重切。节点类型与关系类型改为于建国《学习观》的本体:知识(concept 概念 / feature 特征 / rule 规律 / discrimination_model 判别模型 / connection_model 联结模型)与学习材料(intension_description 内涵描述 / feature_description 特征描述 / positive_example 正例 / negative_example 负例 / contrast_group 对比例组 / extension_contrast 外延对比 / relation_material 关系材料 / factor_material 因素材料 / property_material 性质材料 / segment_example_group 分段例组 / verification_material 验证材料 / data_or_experience 数据或经验 / memory_material 记忆材料)分开建节点,共 18 类节点 + 21 类关系。每份材料由两个正交坐标刻画:modelKind(判别 / 联结)与 layer(上料 / 下料),从而能诊断知识坍缩——上层丢失、下层丢失、下上错配、判联错配、联结空载、记言代学、言存义空、义存言空、验证复用旧例、缺验证、学习材料当记忆材料。抽取仍然只走 LLM,产出的仍是可存 / 可查 / 可导 / 可增补的知识图;未标注本体的既有文档一律按原来的命题本体处理,行为不变。怎么用:抽取表单右上角的「知识分类方案」选《学习观》即可;默认仍是命题本体,且默认值不作为参数发送,老行为不变。一份文档按它自己被抽取时的本体显示(图上有模式徽章、图例、坐标网格、诊断条与边属性),已存在的老文档仍是命题图,要看《学习观》版本需重新抽取一次;模式只影响新抽取,不会改写文档的本体。边上的属性也来自本体:maps_between 的 role(输入/输出)、contrasts 的正负、compares_* 的 mode(对比/类比)都会拼进边的标签,值标签由本体下发,命题本体不声明属性也就不显示。布局也读本体:分层视图的主干道、卫星吸引与分支道改由该文档 relationTypes 的 family / weight 现算,所以《学习观》知识图按它自己的结构铺开,不会因为关系名不在命题表里而退化成毛线团。规范见 docs/learning-view-ontology.md。
  • 关系感知分层布局:分层模式先对每个无向连通分量独立排层、消除重叠,再把组件矩形紧凑打包,避免无关子图共用全局层级而把直接相连节点拉远;层内排序按关系加权,以主干关系(命题本体为 causes/infers,各本体由 relationTypes[].family = backbone 声明)作为主路径,把卫星关系放成邻近分支,并将方向关系(family = directional)作为有界软邻近偏好。这些关系集合与权重全部来自当前文档的本体,不在客户端写死。多条边共享节点或行间通道时,箭头入口、水平通道和垂直走廊分别分轨,并为密集的水平轨道保留更高的层间通道;相邻关系标签发生碰撞时会在可读距离内确定性错位;极端拥挤且无可用位置时默认隐藏标签芯片,悬停或选中对应关系仍会显示,避免线段、标签及箭头挤在一起。新用户默认使用分层布局,已有本地布局偏好保持不变。
  • 连通分量内的邻近压缩:换行只作为初始位置,不再把折行结果锁成不可跨越的层级。通过有轮数上限、确定性的二维优化,缩短按关系加权的边,同时保留推理顺序、主路径固定列、节点间距和行间布线通道,最后移除空行。垂直走廊按实际障碍区间搜索,不再依赖固定搜索半径。高连接度枢纽和跨分支关系仍可能需要较长的边;这只改变视图,不改写知识图数据和关系。
  • 双向定位:
  • 点击图中节点 → 弹出详情卡片(完整内容 + 原文摘录 + 定位按钮),并平滑滚动高亮到原文对应内容单元;
  • 点击原文内容单元编号或在编号上按 Enter → 图中居中聚焦并闪烁对应节点。大图中若节点不在当前窗口,会按已保存的段落编号读取目标所在分页,沿用每窗节点上限;工作台与轨迹页都支持,无需手动翻页。目标不在关系聚拢结果中时,返回主图窗口定位。定位前核对文档版本与原文摘录,后续选择会取消旧响应;没有对应节点时保留当前图。
  • 图中节点只展示前 4 行(超出以 … 省略),完整内容随时可在详情卡片中查看;
  • 锚点以 AI 直接输出内容单元编号为主(确定性索引,长自然段会按句子边界切分成多个编号单元),quote 精确匹配与 token 重合度兜底;无法回链的节点不猜测偏移,统一进入诊断列表。
  • 图渲染:SVG 画布 + 8 类配色 / 4 种可切换节点布局(图右上角下拉,选择记忆):自由布局(d3-force 开源引擎内嵌零依赖:碰撞防节点重叠、边-节点排斥防箭头穿节点)、环形布局、中心布局(中心枢纽 + BFS 环,边走折线:径向出线 → 外环弧 → 径向进线)、层级布局(边走直角正交折线:行间空通道 + 逐行避障走廊,线段保证不穿节点)/ 关系边带类型标签,且同源边按目标角度扇形弯曲(二次贝塞尔)/ 拖拽平移 / Ctrl+滚轮缩放 / 工具栏 − 100% +(50%–200% 步进 10%)/ 长按节点查看原文摘录 / 键盘可达。
  • 大图浏览性能:普通布局的平移与缩放复用节点及文字;「全部节点」总览按空间索引更新可见区域,可见范围改变时继续复用仍在视口内的节点、文字和完整摘录,只构造新进入的节点,适合画布仍显示全部节点。总览放大到 35% 起显示节点文字与原图预览;节点查找与原文定位覆盖完整图。加载时只统计一次关系度数,供所有节点测量批次复用;统计与文本测量均分批让出执行,保留取消响应。搜索面板关闭或查询为空时不提前规范化全部名称与摘录;首次文本查询只为所选类型的节点建立缓存,后续查询复用,图谱更换后失效。超过 200 节点的文本搜索按 8 ms 预算分批执行,期间显示「正在查找…」;改词、改类型、关闭搜索或更换图谱会取消旧任务,完成当前查询后才显示可定位的结果。继续缩小关键词或类型范围时只检查上次完成的匹配节点;删词、改变关键词或放宽类型时恢复完整搜索范围,取消中的部分结果不会进入候选缓存。切换节点通过相邻关系索引显示相关边;选中同一节点对的任一并行关系都会保持共享线条高亮。连续切换选中时复用显示状态不变的节点外框与完整可访问摘录;更换图谱、布局、来源图片、锚点或审校结果会更新对应内容,缓存仅覆盖当前视口。运行 node scripts/kg-graph-viewport-reuse-benchmark.mjs 1116e2d 可对照 12,000 节点在三种缩放下的跨界拖动、往返、窗口调整和缩放;比较完整节点内容,并报告包含缓存维护的元素创建、摘录读取及 Map 操作数。耗时包含计数开销,不含 DOM 与绘制,不作为 CI 速度门槛。
  • 图片来源查找性能:含图知识图按原图节点编号和视觉转写的段落范围查找来源,原文列表按段落查找插图,不再为每个节点或段落重扫图片清单。重叠转写范围仍采用原清单中第一张图片;跨段表格汇集各段插图,按原清单顺序保留独立来源记录。替换图片说明或转写状态后会刷新标记、插图与详情;段落编号、原文和来源对象保持不变。索引按范围边界及明确的段落引用存储,不展开长转写区间。可运行 node scripts/kg-graph-image-benchmark.mjs [基线提交] 和 node scripts/kg-source-image-performance.mjs [基线提交],分别对比首次场景与原文列表构造的图片记录读取次数和耗时;耗时包含计数器开销,确定性回归检查来源对应及只读性。原文浏览器回归可用 node scripts/kg-verification-ui-fixture.mjs --source-image-performance 启动隔离的 12,000 段 / 200 图样本。
  • 原文跨页定位性能:SQLite 用“无段落编号节点数 + 更早段落节点数”确定目标所在页,通过既有段落索引的两个范围计数;同段第一个节点、NULL 优先、分页上限及版本快照保持一致,不另建索引。运行 node scripts/kg-paragraph-rank-performance.mjs 可与原排名条件对照,--smoke 检查普通分页及随机、同段、稀疏编号数据的一致性。计时只覆盖排名 SQL,不包含窗口读取、诊断、HTTP、视图构造或浏览器绘制。
  • 长原文的窗口关联性能:翻页时按有序段落范围查找节点锚点,避免每个节点从原文第一段开始扫描;段落编号、空白间隙、段尾边界与完整摘录保持一致。「全部节点」也使用同一查找。可运行 node scripts/kg-paragraph-window-benchmark.mjs [基线提交] 对比 12,000 段的四个尾部窗口与全部节点,检查完整视图结果一致性,并分别报告未插入计数器的中位耗时和段落边界读取次数;耗时只涵盖视图建立,不含网络、布局或浏览器绘图。浏览器回归可用 node scripts/kg-verification-ui-fixture.mjs --paragraph-window-lookup 启动隔离样本。
  • 旧引用的关联性能:旧记录没有段落信息且引用无法直接定位时,前缀与后缀匹配先检查最长及最短片段,再按嵌套片段的长度二分查找,避免逐长度重扫原文;仍优先前缀,采用原来的最长命中和首个偏移,准确/规范化匹配及模糊回退不变。词语回退首次沿用原扫描,每段只分词一次;第二次回退将词语集合转换为词语到段落的索引并释放集合,后续按词语更新匹配段落的分数。单段词直接存段号,多段词存段号列表,每次查询清零并复用分数缓冲。直接引用不建立词语集合或索引;重复查询词权重、最小分数和同分采用首段的规则保持一致,状态不跨视图或文档保存。运行 node scripts/kg-legacy-token-benchmark.mjs [基线提交] 对比 12,000 段的 200/800 个旧引用、稀疏词、单条冷启动、前后缀命中和直接引用窗口,核对完整视图一致,分别报告未插入计数器的 5 次中位耗时及分词、匹配和分配次数;计时不含 HTTP、布局或浏览器绘制。单独运行 node --expose-gc scripts/kg-legacy-token-benchmark.mjs [基线提交] --memory-only 可比较第二次评分后的存活词语状态增量,显式 GC 的诊断不代表整页内存或瞬时峰值。node scripts/kg-verification-ui-fixture.mjs --legacy-token-lookup 提供尾部 200 个旧引用的隔离浏览器样本;--legacy-fragment-lookup 混合前缀、后缀及词语回退样本。
  • 引用规范化性能:空白或标点不一致的引用仍按原来的顺序匹配,规范化文本按连续保留片段复制,并保留每个 UTF-16 单位的原文偏移。空白只处理空格、换行、Tab 和全角空格;CR、其他 Unicode 空白、原标点集合及前导/尾随行为保持一致。每个视图最多建立三种原文形式,直接引用跳过规范化,已有段落信息时优先局部匹配。运行 node scripts/kg-anchor-normalization-benchmark.mjs [基线提交] 对比 12,000 段的三种规范化、中文/补充字符、单条/两条/200/800 条旧引用及局部/直接引用,核对完整视图和偏移一致;分别报告五次未插桩中位耗时及原文输出片段、映射单位和逐字符标点查询数,计时不含 HTTP、布局或浏览器绘制。node scripts/kg-verification-ui-fixture.mjs --normalized-anchor-lookup 提供三种规范化混合的浏览器样本。
  • 原文表格预处理性能:没有完整表格或表格超过原有长度上限时,跳过全文代码区域扫描;首次表格定位沿用原查找;第二次需要定位时,只检查一次段落范围是否有序且不重叠,随后用二分查找。单张表格不增加段落检查。异常或无序范围沿用首个重叠段落的旧规则。跨段表格、代码中的字面示例、原文偏移及段落锚点保持一致。运行 node scripts/kg-source-table-performance.mjs [基线提交] 对比 12,000 段、400 张表格及混合代码示例,核对完整分组及解析调用;七次未插桩中位耗时与边界读取/代码扫描计数分开报告。计时不含原生 HTML 解析、分段、HTTP 或 React/DOM 绘制。node scripts/kg-verification-ui-fixture.mjs --source-table-lookup 提供 400 张跨段表格和各 400 个行内/缩进示例的浏览器样本。
  • 轨迹原文关联性能:轨迹页为当前事件清单建立一次范围查找,选中节点或闪烁更新时复用;一个长事件拆成多段时,仍显示原事件类型和序号。替换事件清单时重建,空白间隙及旧记录的段落索引回退保持一致;无序或重叠的导入范围沿用原清单首个匹配。可运行 node scripts/kg-trajectory-event-performance.mjs [基线提交] 对比 12,000 段/事件的首次行构造及四次选中更新,计数器与计时分开,检查完整行内容一致。耗时不含 HTTP、知识图准备或 React/DOM 更新。node scripts/kg-verification-ui-fixture.mjs --trajectory-event-lookup 提供隔离的 12,000 段样本,首个事件跨三段,事件序号独立于段落编号。
  • 验证与质疑知识图:生成图后可以检查它是否忠于原文——
  • ⚡ 规则检查:本地规则即时检查(自环/悬空边、quote 能否在原文定位、段落编号与摘录位置是否一致、类型-关系语义规则、重复/疑似矛盾节点、孤立节点、覆盖统计),0 秒返回问题报告;
  • 🤖 AI 原文核对:异步调用 LLM 逐节点/逐边找茬,所有 issue 必须以原文摘录为证据,标准档还会二次复核过滤误报;
  • 人工闭环:问题按「错误 / 警告 / 建议」列出,点击问题 → 图中相关节点/边按严重度着色高亮并滚动定位原文;每条问题可采纳修复(改动立即应用并写入审计记录)或忽略;面板顶部提供一键修复,批量应用全部可自动修复的问题;修复记录逐条显示旧值 → 新值的具体差异;
  • 主动质疑:节点详情卡可点「质疑此节点」,选中边后出现关系详情卡可点「质疑此关系」,也可在验证面板直接向整张图提问/质疑,AI 给出「图成立 / 质疑成立 / 证据不足 / 超出范围」判定与原文证据;
  • 🔎 外部事实核查原文:把知识图中的 fact/claim/inference/rule/definition/counter_example 节点转为可核查断言,用 Wikipedia 等外部证据裁决原文是否可靠;面板支持粘贴领域规则来源(法条、制度、教材、标准),规则文本与 Wikipedia 证据共同参与裁决;判定为「支持 / 矛盾 / 部分支持 / 证据不足 / 无法核查 / 超出范围」,每条结论绑定证据链接与证据引文(引文必须能在检索结果中定位,编造引文会被自动降级);点击断言可回链图中节点与原文段落;
  • 追加资料后自动标记验证/核查结果过期,可重新验证或核查;轨迹知识图支持同样的全部验证/质疑/外部核查能力。
  • 浮动工作台:窗口可拖动、可调整大小;原文与知识图的宽度比例、结果区高度均可拖拽调整并记忆。
  • 划线拆分:在聊天消息里用鼠标选中任意一段文字,选区上方浮出「生成知识图」按钮,点击即自动打开工作台并拆分所选文字;在结果页原文里划线选中可拆成子图;输入框里选中部分文字也可「拆分所选」。
  • 追加资料(增量合并):已有拆分结果后,输入区主按钮变为「追加资料」——粘贴下一段/下一份资料,AI 只抽取新增内容,并自动与已有图建立跨段关系边(同一概念不重复建节点,直接连线到已有节点);结果原地合并、全文段落统一编号、历史记录原地更新。聊天划线选中文字时也会自动追加到当前图。
  • 历史记录:每次成功拆分自动记录(最多 20 条、同文去重、可单删 / 清空);浏览器只保存 documentId、标题、计数等轻量索引,回看时从 Host/SQLite 重新载入正文与 canonical graph,避免把书级正文复制进 localStorage。
  • 章节过滤与候选审核:结果区按章节筛选图节点和原文段落;候选实体 / 声明面板展示 evidence,可一键标记「待确认 / 已接受 / 已拒绝」,状态通过 Host 同步到 SQLite(动态插件在 Host 会话中保留,失败时回退浏览器 localStorage),并可点击候选回链原文。
  • 知识图使用层:正文图与轨迹图共用「查找与问答」面板,可按关键词、节点类型、章节、grounding / entailment 状态做有界结构化检索,并区分直接命中与关系邻居;「证据问答」只使用服务端加载的 canonical graph 和已认证原文,模型只能引用 Host 预分配的 evidenceId,每个被接纳的回答片段都必须有节点、关系或原文段落证据。点击检索结果或 citation 可回链图与原文;节点即使位于当前 800 节点渲染窗口之外,也会先按 node ID 加载 canonical 子图再定位。
  • 知识图导出:结果工具栏可导出当前渲染图为高清 PNG 图片,也可导出完整 JSON(保留 source、chunk、evidence、验证报告和审计记录)以及节点 CSV、关系 CSV;数据导出的是完整图,不受当前章节筛选影响。轨迹知识图也支持相同导出。
  • 常驻入口:左侧栏底部、设置上方的「知识图」按钮直接打开资料工作台,无需先创建或选择对话;侧栏收起后保留图标入口。对话内的「轨迹知识图」只处理该会话的轨迹,运行卡片内也保留启动条。
  • 轨迹知识图(会话视图标签页):对话区新增第三个标签页「轨迹知识图」(位于 对话 / 轨迹 旁),一键把当前会话的完整执行轨迹(用户消息、工具调用、工具结果、AI 回复)拆成知识图——可视化这个 Agent 查到了什么事实、做出了什么推论、用了什么方法,并在图与轨迹事件之间双向定位(点击节点滚动到对应事件,点击事件在图中聚焦对应节点)。结果按会话持久化到 Host/SQLite;浏览器仅保存 documentId/revision 引用,因此切换标签页或刷新页面后会从已保存的知识图恢复,拆分进行中切走再切回会自动续接轮询;会话继续产生新事件后,可点 追加新事件 只拆解新增部分并在同一 revisioned document 上增量合并(跨事件建立关系边);轨迹事件列与图列的宽度、结果区高度均可拖拽调整并记忆。

新功能怎么用

先从左侧栏的「知识图」打开工作台,生成知识图,或从历史记录打开已保存的图。工作台分为四区,切换时保留草稿、查找结果和正在运行的任务:

  • 阅读知识图:对照原文与图,使用阅读导航,解读和核对图片。展开「阅读书签」可保存浏览位置;导出和知识图状态也在这里。
  • 查找与学习:查找知识、根据原文问答、对照跨书概念、完成学习练习。点击查找结果或引文,会回到阅读区并定位来源。
  • 检查与修正:检查当前窗口或全图、核对变化部分、复核问题并确认修复。章节候选确认和外部事实核查各自折叠。问题行的「查看图文」回到阅读区;节点详情的「质疑此节点」进入问题输入框。
  • 导入资料:输入或追加正文、图片、PDF、Markdown 文件夹。尚未生成图时直接显示输入区。

AI 模型在页头选择,知识分类方案和同时生成批数在「生成设置」中调整。AI 核对进度在各区均可查看;完成后点「查看检查报告」进入检查区。完整用语对照及维护要求见界面文案规范。

联结模型详情的原文定位失败会显示原因。重试、选择另一条引用或切换模型、分支、页签与阅读模式时,清除上次定位的提示;本次仍然失败会显示新的原因。定位恢复不清除模型读取或操作错误,缺失、重复和旧版本引文仍按完整原文与版本校验拒绝定位。

重新读取联结模型期间,切换模型、详情或阅读模式,以及填写新的方向修改,会取消原刷新结果;旧刷新不会清掉新草稿或把错误带到新详情。当前刷新失败仍显示原因,可再次重新读取;放弃原方向草稿仍需明确确认,保存方向仍须预览并确认。

审阅联结模型期间,切换模型、详情、阅读模式或离开「阅读知识图」工作区会取消旧审阅;切走再返回不会恢复旧请求,重复点击只采用最近一次。旧节点窗口读取不会定位原模型、覆盖新问题草稿或把失败带到新详情。当前审阅仍会定位所选模型并填写核对问题,读取失败可重试;填写问题不自动提交 AI 或修改知识图。

联结模型审阅重试时,只清除该审阅先前的失败提示;成功进入「检查与修正」后返回模型,不再显示已恢复的审阅错误。模型详情读取、方向修改和重新读取模型的错误仍单独保留;新一次审阅失败会显示本次提示。

核对方向和确认预览同时显示概念名称与节点编号,避免同名概念混淆。每项方向修改可展开对应映射的完整原文并定位段落;按原关系身份匹配引用,不从名称或列表位置推断方向。预览和取消不写图,明确确认后仍校验预览内容与图谱版本。

重新读取模型的错误也由该操作单独保留:方向预览通过或失败,都不代表此前的读取失败已经恢复,两项失败可以同时显示。只有实际开始重新读取时才清除旧的读取提示;拒绝放弃方向草稿或过时的点击不会清除提示、草稿或待确认的预览。成功重新读取仍按原有确认流程更新模型,方向保存继续要求预览、明确确认和版本校验。

功能 入口与操作 会发生什么
核对变化部分 在「检查与修正」点「核对变化部分」,核对弹窗中可复用批次、待审批次、模型和最低请求数,再确认。 仅复用输入、原文、模型及审校规则依赖均未变化且已保存的历史批次;变化部分重新调用 LLM,本地规则仍检查全图。与「AI 全图原文核对」的全新审校不同。复用不等于免费或零请求,也不会自动采纳修复。需要已保存的 canonical 图和可复用的历史审校批次;没有可复用批次时计划会显示仍需全部审校。
问题组与批量修复 在「检查与修正」的「批量复核问题」中,保留「显示全部问题」可跨组核实当前筛选的下一批;也可按问题类型或原文选择一组。核实后先点「检查冲突与修改」,逐项查看判定及修改前后,最后点「确认保存本批处理」或「确认保存本组处理」。 同组共享图与原文上下文,但每个问题独立核实;批量仅接纳原文逐字支持的安全修复,其他结论留待单独处理。冲突项不会强行写入。保存是一次带版本校验的提交;若此后没有其他图修改,可撤销上一批/组保存,不能覆盖后续编辑。核实会调用所选模型,建议先用小批量。
阅读导航 在结果区点「阅读导航」,按来源章节进入,按「图中概念线索」筛选条目;点条目或「原文 P…」引文定位图与原文,可翻页或跳页。 给大图提供「章节 → 知识条目 → 可核对原文」的阅读路径。「概念线索」和阅读起点是从图派生的候选组织方式,不是作者亲自标出的核心论点;没有可核对引文的条目会明确提示。打开地图不改图、不调用 LLM。
联结模型工作台 在「阅读知识图」点「联结模型」,从全图目录按章节、关键词、概念作用或待核对状态筛选。查看输入、映射与条件、输出,以及规律、例子和原文。方向修改需先预览,再明确确认保存。 使用已有 connection_model、maps_between 及用户确认的可选模型结构。旧模型不会自动转换;未定角色、异常关系和错误示例保持可见,不从节点顺序或名称猜方向。阅读不修改图,保存有版本校验。
独立槽位、分支与配对实例 在模型详情点「核对结构」,分别整理槽位的概念、输入输出角色、单位和时间状态;同一概念可作为多个独立槽位。填写条件、映射、边界的来源身份与引文,按槽位和分支记录情境、状态及推测过程。「下上对照」按分支浏览实例,点击实例状态高亮对应槽位。原有图谱端点可另行展开,差异和异常不会被新槽位遮住。 每项更改须预览修改前后并确认,只更新该模型的 modelStructure,不自动添加关系边。原文引用必须匹配已存来源;用户整理、AI 建议与待核对内容明确区分。配对完整性与分支覆盖不代表规律已验证;映射是结构化文本,不执行公式或推测链。失败、切换与版本变化保留草稿,旧版本不能覆盖新图,删除被引用概念会被阻止。
待补充内容与原文选取 在模型详情点「待补充内容」,查看缺少的输入输出、分支条件、配对状态和来源记录;点击缺口进入对应草稿字段。旧端点可展开已记录的关系引用或端点上下文,「核对原文」按完整引文、来源与文档版本逐字定位;缺少引文时提示先对照原文,保留未知角色。尚无实例绑定时,先明确「补齐输入变量」或「补齐输出变量」,再填写空状态。分支字段可「从原文选取」连续片段,保留限定语与出处,预览后确认保存。 诊断覆盖该模型的全部已记录分支与实例,分页显示;不是正确性或学习掌握度评分。定位上下文不证明关系方向;缺失或重复的完整片段不会近似跳转。分页、刷新、切换模型或草稿及忙碌时,旧定位不移动阅读范围或覆盖当前错误。候选原文包含模型及相关材料上下文,不保证支持所选字段。原文选取不调用 AI、不自动补全或写图;替换现有内容须确认,编辑后旧预览失效。读取和提交均沿用已存段落身份,不因新版全文切分改变引用编号。旧 Host 缺少能力标记时明确禁用诊断与原文选取。
模型比较 在模型详情点「模型比较」,明确选择第二个模型;默认筛选共享概念端点,也可取消筛选搜索全图。并列核对输入、输出、完整联结表述、条件、材料和引文;「查看模型 A/B」打开完整材料,「挑战模型 A/B」进入对应模型的反例练习。原文定位失败可再次点击引文重试,重试清除该定位的旧错误;模型读取错误保留在其自己的读取流程中。 相同概念身份、已记录角色、单位与时间状态是结构比较依据,不是模型等价或矛盾的判定。同名但不同身份的端点单列,未定或重复关系不会被算作完整方向。已整理的条件分支可并排阅读,旧模型显示未结构化;不自动推断适用性,不建立类比边或推测链。
两步推测草稿 在模型详情点「两步推测」,明确选择第二个模型和两个分支,填写全部已知输入、预测、条件及应用过程;按独立槽位选择承接上一步的输出,分别记录含义、单位口径、时间状态与对象范围的核对依据。「检查推测缺口」标明停在哪一步,草稿可导出 JSON。 候选覆盖全图,仅按概念身份与已记录的输出→输入方向筛选,不代表相容、因果或可迁移。缺少任一输入、方向不明、单位或时间状态未定或冲突、错误示例、类型说明及已驳回模型会阻断;上一步有缺口时,其手填输出不能供给下一步。同名异身份不能直接承接,不自动换算、逆推、执行公式或合成概率。完整状态仅说明字段齐备,含义、对象与适用性仍是未独立核验的用户自述;限定语、字段来源与循环风险保留。仅缓存当前标签页的个人草稿,不写正式图谱或长期学习记录;切换第二模型需确认,旧版本保留文字但暂停检查,必须明确对照后换基准。
草稿导回继续编辑 已选择两模型的草稿即使尚未检查或仍有缺口,也可导出 JSON。「导入推测草稿」读取文件后先预览文档、模型、来源版本、情境和槽位数量,再明确确认替换当前文字;兼容已有检查结果导出文件。 文件最多 2 MiB;错误格式、文档或模型身份不匹配、未来版本及缺失模型不覆盖当前草稿。文件中的旧检查结果和模型快照不作为当前依据;只恢复可编辑文字,旧版本仍须明确对照后换基准。读取期间编辑或切换范围会取消过时导入,不自动检查、保存长期学习记录或修改图谱。
情境预测与反例挑战 在联结模型详情点「情境预测」,选择新情境预测或反例挑战。后者先写基准情境与预测,再写只改变的一项、保持不变的条件、改变后的预测和能反驳联结的观察。保存预测后显式展开原文,填写并保存复盘。 学习记录独立于正式图谱,保留当时模型与引文快照,最初预测和已完成复盘不可覆盖;两类练习的历史和标签页草稿分别保存。当前版本按完整引文逐字定位,保留来源、段号和节点身份;切换预测、返回草稿、重读或离开视图后,旧定位不再改变焦点或报错,旧版本引文仍不可跳转。仅改标点或排版的情境变化会被拒绝,是否真正受控、是否构成反例仍未核验;边界外不适用不是边界内被反驳。不会自动打分、声称掌握或修改图谱。常驻 Host 支持持久保存,临时动态 Host 会明确提示持久化不可用。
我的理解 在联结模型详情点「我的理解」,独立填写输入判别、联结规律、输出判别、条件、边界与疑问,对照原文模型后保存;可关联已有预测或复盘,填写修改理由,追加修订版本。 复用学习记录存储,不另建个人图数据库;保留当时模型、字段来源与练习快照,不覆盖正式图谱、旧表述或练习。当前版本引文按完整原文逐字定位,保留来源、段号与节点身份;重读、切换修订记录或离开视图后,旧定位不再改变当前焦点或报错。旧来源版本仍不可跳转。并发修订和图谱版本变化阻止旧草稿直接保存,重读后草稿仍在,须明确对照新基准。无来源或表述不完整仍可作为个人记录,不自动评对错、掌握或新颖性。历史与各类可选练习展示最近 100 条,最多关联 10 条。
渐构靶图 在「阅读知识图」切换「渐构靶图」,从概念、判别模型或联结模型建立个人靶图。上层整理输入内涵、规律与输出内涵,下层配对具体情境、全部输入、推测过程和输出;支持多个必要输入、多例指向同一输出,以及尚无例子指向的陪域取值。 表述、例子和修订独立保存为个人记录,不写正式图谱。预测须先保存再填写对照,保存后不能事后改写;可查看预测时的上层快照。草稿按文档、节点身份及图谱版本隔离,旧版草稿可重新打开但不能覆盖新版。个人判断、资料答案、观察记录和 AI 建议均不是独立核验或掌握证明。详见 渐构靶图。
验证结果记录 打开已保存的预测或反例挑战,记录真实观察、参考资料、公式或规则推导、AI 建议或个人复盘;填写实际条件、比较依据与自述诊断。真实观察须确认已发生并记录日期和时区;原文引用须先显式展开当时对照。「定位结果所引原文」按保存的连续摘录逐字定位,保留节点、来源身份和版本;切结果、重读或编辑草稿后取消此前的定位,当前定位失败仍会显示。结果可追加更正,修订个人理解时冻结关联预测的最近 5 条结果。 复用学习记录,绑定最初预测、来源版本与当时练习版本;所有来源仍未独立核验,不是自动判分、外部证实或掌握证明。个人选择的连续摘录仍限 2000 字,定位不替换为整段资料。更正不计作另一份独立证据;并发更正须明确改用最新基准,保存回应丢失可按同一请求恢复。来源更新后仍可补记旧预测的观察,但不算当前模型的验证,旧引文不能定位到新来源。外部链接不自动读取,AI 不自动调用;每次预测展示最近 100 条结果,有限快照明确标注。新前端连接旧 Host 会阻止结果写入。
模型学习记录 在模型详情点「学习记录」,查看按来源分开的比较计数,按情境预测/反例挑战、来源、比较或诊断环节筛选,逐页打开最初预测和具体结果。 统计完整历史,先折叠更正链再筛选与分页,每格按预测去重;不同来源和多个比较列可能重叠,不合计为独立证据、正确率或掌握分数。一致与不同并存时不选胜者。旧图谱版本与当前版本分开计数,自述未见不证明新情境。列表每页 20 次预测,结果预览最多 5 条;筛选命中的更早结果可直接定位,不受最近 100 条历史窗口限制。
诊断对应材料 在已保存结果点「查看诊断对应材料」,对照输入/输出角色、条件与边界或规律的当时材料,再点「带这次预测修订我的理解」,明确关联后编辑和保存个人修订。 按快照中的角色、材料类型与来源选取,不推断错误原因;尚未展开原文时引用仍隐藏,旧引文无法定位新来源。当前版本按完整引文逐字定位,保留来源、段号和节点身份;切换诊断或结果、重读或关闭材料后,旧定位不再改变焦点或报错。缺失材料明确提示,不自动补公式、调用 AI 或生成正确答案。关联不会替换已有草稿,也不静默保存;仍最多关联 10 次练习。
阅读书签 先调整当前搜索词、筛选、章节、关注节点、关系聚拢、布局或阅读地图,再回到「阅读知识图」展开「阅读书签」,输入名称并点「另存书签」。以后从下拉框选择并点「打开书签」;「更新书签」用当前状态覆盖它。 相当于当前文档的浏览书签,不是待办任务或另一张图。每张图最多保存 20 个;保存的是视图状态,不复制节点或原文。「删除」只删除书签,不删除知识图。图更新后重新打开会核查节点和章节,已失效的位置会清除并提示。
跨书概念档案 在「查找与学习」点「跨书概念档案」,选当前图的概念,查看同名候选或输入关键词点「查找对照概念」。核对各书的来源与原文引文后,勾选「纳入对照」,标注「相关,待辨析 / 不同用法、分歧 / 可能同义」,填写适用条件、时间及说明,再点「保存候选对照」。 保存一个可重开、编辑、删除的对照档案,不合并各书节点;同名只产生候选,不自动判为同义。来源表述是否忠实与现实中是否正确是两件事。来源图变化时档案会标记过期,需重新核对。
学习练习 在「查找与学习」点「学习练习」,选择「概念辨析」「机制解释」或「新情境应用」,阅读带原文定位的题目,填写回答;新情境题还需写一个不能照搬原文的具体场景。选自评后点「保存练习与自评」,可在「学习记录」中复盘。 练习从现有图和可定位引文派生,不是原文,也不自动判对错或证明掌握。缺少依据时对应题型不可用。回答、自评与原文知识图分开保存;图更新后旧练习保留但标为旧版。

验证结果草稿已勾选「已发生的观察」时,即使尚未填写日期,切换反馈来源也须确认清除观察信息。取消时整份草稿保留;确认后沿用来源字段清除规则,结果内容、条件与比较依据仍在。空白草稿或只有保留内容时不额外询问;来源切换不自动保存,自述观察仍未独立核验。

联结模型实例的缺口入口按独立槽位身份聚焦,即使输入、输出或不同对象的槽位使用同一显示名称,也能落到实际缺少的状态;尚未建立绑定时先定位「补齐输入/输出槽位」,补齐后聚焦空值,不填造预测。实例编辑字段旁保留概念、槽位、已记录单位及时间/对象状态,供填写前区分。编辑仍只更新个人结构草稿,条件、来源和证据保留,正式结构写入仍须预览、明确确认与版本校验。

读取验证结果时,缺失或无效的自述诊断会阻止使用这次响应,并提示重新读取;已有草稿、条件、比较依据和更正基准保留。正常响应恢复后可继续,不把缺失诊断自动解释为「仍无法判断」,也不自动保存或核验结果。

联结模型字段、槽位与配对实例的「原文」入口沿用只读接口接受的完整文档标识(最多 4096 字),保留标识中的空白,不截断或替换成其他文档。仍按当前版本和完整引文逐字唯一定位;字段引文上限 2000 字,个人整理与 AI 建议不成为原文入口,定位成功不表示语义已核验。结构保存仍使用原有 160 字文档标识限制、预览、明确确认与版本校验。

模型学习记录只有在摘要和五类来源的必需计数都齐全、且为非负安全整数时才显示统计。缺少计数或计数无效时提示重新读取;不把缺项当作零,也不显示部分统计。完整响应中的零值正常显示,原始预测、结果更正和来源分类保留,统计仍不代表独立证据或模型已掌握。

联结模型目录的关键词也覆盖通过当前 canonical 概念与原文引用校验的已记录条件、规律和边界。新增字段搜索按同一字段内的完整短语筛选,只规范化全角、大小写与空白,保留运算符和箭头,不把 x > 3 与 x < 3 合为同一命中,也不把分散在不同字段或分支的词拼成一个条件。目录保留原文顺序、全图数量和既有章节/概念/角色筛选;响应中的 modelFieldMatches 最多列出 8 个分支/字段位置与声明的来源身份,余量明确,依据是 recorded_text_not_applicability,不代表适用性、正确性或掌握度。来源备注和实例不在这个目录搜索范围内;无效结构仍可按模型身份或标题找到并核对。

联结模型详情及“从原文选取”的上下文按已存原文顺序取前一段和后两段;段落编号不连续时仍保留紧邻的条件、表格与边界,引用继续使用原编号和完整原文。“打开原文”携带完整上下文及来源版本,逐字定位到实际阅读位置;切换选取目标、候选、摘录、分页或重新加载后取消此前的定位,当前失败仍会显示。打开完整原文不改变字段草稿;明确填入的连续摘录仍限 2000 字。找不到的段落身份不猜邻近位置;上下文候选不代表它支持所选字段,填入草稿后仍须预览和确认保存。

联结模型详情和比较中的原文表格仅拼接已存顺序中真正相邻、没有缺段的完整片段;保留表题、表前条件、表后边界与每个片段的原编号定位。定位携带文档、版本和原文片段(最多 2000 字符),按当前原文逐字查找,重复或过时的依据不近似跳转。未展示中间原文时保留片段,不把省略限制的表格冒充完整依据;只呈现单元格文字,不执行资料中的 HTML。

模型、端点、材料、比较页及两步推测的模型引用按当前文档版本逐字定位,保留原编号、节点身份、出处与完整引文(包括超过 2000 字符的模型引用);重新切分的阅读段落不使用原编号作为下标,也不将原文限制在节点所在章节。重复片段、版本变化或缺失的引用会显示错误并保留模型页面与引文。引用节点需要另行加载时,也须通过文档与版本校验,过时的加载结果不改变画布或阅读位置。结构字段及原文上下文按钮的定位长度限制不变。

联结模型原文与节点定位还核对发起动作时的模型、详情页签和比较对象。切换模型、切换比较对象、重新读取、离开详情或关闭模型面板后,尚未完成的旧定位不再改变焦点或阅读位置,也不把旧错误显示到新详情;切走再切回同一对象仍须重新发起定位。同一页面连续定位以最新点击为准,当前请求的真实失败继续显示完整引文与错误。此取消范围只约束阅读定位,不改变结构修改的预览、确认和版本校验。

两步推测还核对明确选定的第二模型、两步分支和草稿来源版本;确认更换第二模型、切换分支或重新读取后,旧引文与结构依据的定位结果不会覆盖当前选择。拒绝更换时保留两个步骤,原定位仍可完成;确认更换仍只清空第二步,第一步与情境保留。原文定位失败后可点击同一引文重试,当前重试会清除自己的旧定位错误,推测检查和模型读取错误独立保留;切换定位范围或离开页面时清除旧定位错误,过期回应不覆盖当前错误。模型尚未读取时,编辑情境或目标会保留读取错误和个人草稿;点击「重新读取两步推测模型」重试,恢复两个模型后再检查,过期读取不会清除当前错误。引文逐字匹配只确认出处,个人填写的输入、推理和预测仍是草稿,不因此成为已验证关系或掌握证明。

两步推测草稿导出失败后可重试;浏览器成功发起下载后清除自己的旧导出错误,仍保留尚未恢复的输入校验、推测检查、模型读取与原文定位错误。导出保留草稿来源版本、两步模型身份、条件及个人文字;已有检查结果仍携带原有的依据与限制,不因导出成为正式关系或掌握证明。

历史恢复、canonical 导出、联结模型目录、阅读地图和关系聚拢按完整 documentId 定位,不截取前缀、不去除首尾空白,也不合并全角或同名标识。这组只读入口的标识上限为 4096 个 JavaScript 字符,仍受各路由原有请求体预算限制;超限或类型错误明确拒绝,找不到完整标识时不会回退到前缀文档或客户端提供的图。候选列表也保留完整文档标识。本轮涉及的图提交、抽取、审校和个人学习记录入口没有扩大文档标识范围,仍限制为 160 字且无首尾空白;不支持的标识拒绝或报告未找到,不能截断后修改另一份文档。长标识文档的个人记录保存、任务视图和图片读取等其他入口尚未扩展,不应把只读恢复成功当作整个编辑流程已支持,也不能外推其他接口的身份契约。

以上视图、档案和练习都要求当前资料已保存为 canonical 文档。结构核对还要求 Host 返回对应版本的能力标记;新前端连接旧 Host 时保留阅读入口,明确提示版本尚未就绪并阻止结构写入,不把仅加载新前端当作完整部署。审校、核实和修复有模型费用或修改风险,先读计划与预览;阅读地图、任务视图、概念档案候选检索和现有图派生练习不需要模型调用。开发者另有审校质量基准和全图发现基准:样本由 Codex 复核,不是独立人工真值。隔离环境曾用 DeepSeek V4.1 Flash 对合成案例和一段公版原文实际运行并保留结果;这些小规模样本不能代表真实书籍的准确率,也不能把模拟预测当作模型成绩。

关系聚拢的文档版本、中心、各层邻接、分页顺序、节点内容和关联边来自同一 SQLite 读取快照。读取期间的更新或删除不会把新内容标成旧版本,也不会因另一份去空白后同名文档的版本而误报冲突;后续查询仍严格核查 expectedRevision,旧版分页不能接到新版图上。方向与层数仅表示已记录边的浏览范围,不认证因果、可逆性、条件成立或模型真伪。

界面一览

原文段落的类型标签旁有 × 按钮,可在确认后删除该段落、该类型在当前节点窗口中的对应节点,以及这些节点的全部关联关系(含跨窗口关系)。原文、其他段落和其他类型的节点保留。修改通过已有版本校验保存到 SQLite,刷新后不会恢复;生成任务进行中不允许此操作。适合手动清理被误识别为知识的目录、署名等内容。

以下为早期图文对照截图,当前工作台入口按上面的四个工作区组织。

┌─────────────────────────────── 浮动工作台 ───────────────────────────────┐
│ ● 知识图工作台                                                [ × ]        │
│ 知识图                                                                      │
│ 当前资料标题                          [AI 模型] [历史记录] [新建知识图]     │
│ [生成设置]                                                                │
│ [阅读知识图] [查找与学习] [检查与修正 · 待处理数] [导入资料]                 │
│ [原文与知识图]                                                             │
│ N 节点 · M 关系 [阅读导航] [阅读书签] [导出]                                 │
│ 原图 N 张 · 未解读 M 张 [打开图片节点] [解读与核对图片]                       │
│ [原文段落…带类型徽标]  ‖  [知识图 SVG…]  [− 100% +]  │ ← 可拖宽竖条         │
│ ─────────────── 可拖高横条 ────────────────           │                    │
└─────────────────────────────────────────────────────────────────────────┘

对话区「轨迹知识图」标签页:

┌────────────────────────── 轨迹 ⇄ 知识图 ──────────────────────────┐
│ 拆解本会话轨迹:用户消息 / 工具调用 / 工具结果 / AI 回复            │
│ 一句话总结:…                                                     │
│ [轨迹事件…带类型徽章]  ‖  [知识图 SVG…]  [− 100% +]  ← 可拖宽竖条  │
│ ──────────── 可拖高横条 ────────────                              │
│ (切换标签页 / 刷新页面后结果自动恢复)                            │
└────────────────────────────────────────────────────────────────────┘

安装

这是一个 DSH 动态 Cordis 插件:一份 Host 代码(Node 进程)+ 一份 Client 代码(浏览器),纯 JS、零依赖、无需构建。通过 DSH Web 界面的 Cordis 插件机制加载,步骤适用于任何 DSH Web 会话。

0. 前置条件

  • 已启动 DSH Web(dsh web);资料工作台不要求已有会话;
  • 环境中已配置 AI 模型提供方(设置 → 模型,或 agentDefaultModel)。插件默认跟随系统当前模型;工作台与「轨迹知识图」顶部均提供模型下拉框,可手动指定拆分、追加、AI 审校、质疑与外部核查使用的模型(选择会保存在浏览器本地);未配置时会给出明确的中文错误提示。图片抽取需要支持 image 输入的多模态模型;模型下拉框会标注已知的「图像 / 仅文本」能力,能力未知的模型允许尝试,但提供方拒绝图片时会以 model_image_unsupported 明确失败。

1. 获取源码

git clone https://github.com/cwbcheng/dsh-knowledge-graph.git
cd dsh-knowledge-graph
文件 作用
src/index.host.js Host 半:异步 AI 拆分任务引擎(图片 admission / 多模态视觉转写、段落编号、分批、schema 校验、typed 诊断、模型路由、会话轨迹序列化)+ 知识图验证/质疑引擎 + canonical 结构化检索与 evidence-ID 证据问答
src/index.client.js Client 半:浮动工作台 UI、图渲染、双向定位、共享检索/证据问答面板、验证与质疑面板、修复应用/审计、历史、宽高调节、轨迹知识图标签页
src/kg-store.mjs SQLite 持久化层:文档、内容块、节点、关系、证据、候选实体/声明、抽取 checkpoint 与大图有界消费查询

2. 安装(二选一)

方式 A:让 Agent 帮你安装(推荐)

在任意会话中把下面这句话发给 Agent(把路径换成你 clone 的位置):

> 请读取 dsh-knowledge-graph 仓库的 src/index.host.js 和 src/index.client.js,把这两个文件定义为 Cordis 插件的 Host 半和 Client 半,然后运行它。

Agent 会依次调用 cordis_define(定义)→ cordis_run(运行),并在界面上弹出运行审批卡片。

方式 B:自己复制源码定义

  1. 在任意会话中发起一次 cordis_define(由 Agent 执行,或按你环境的 Cordis 工具流程操作);
  2. Host 半粘贴 src/index.host.js 的内容,Client 半粘贴 src/index.client.js 的内容;
  3. 注意粘贴的是函数体:去掉文件里的 export default function hostPlugin() { / export default function clientPlugin() { 这一行和文件末尾对应的 },保留中间的 return { ... }; 部分(文件头部注释可保留也可删掉)。

> 不熟悉 cordis_define 工具的话直接用方式 A,Agent 会自动处理好上面的取函数体步骤。

方式 C:常驻安装(推荐,重启不丢)

把本仓库安装为 web profile 的组合插件(与 dsh-hud 相同的社区插件包形态):Host 半走 webServer 路由、Client 半是 __ModuleLoader__ 浏览器模块,随 dsh web 启动自动加载,不需要每次重启后重新定义,也无需审批。

# 1. 在 profile 目录添加依赖与 bundle($DSH_HOME 默认 ~/.dsh)
cd ~/.dsh/profiles/web
#    在 package.json 的 dependencies 中加:
#    "dsh-knowledge-graph": "github:cwbcheng/dsh-knowledge-graph#main"
#    在 package.json 的 dsh.profile.bundles 中加:
#    "dsh-knowledge-graph"
pnpm install

# 2. 重启 dsh web(Ctrl+C 后重新 `dsh web`)

重启后:对话标题右侧出现「知识图」按钮。窗口位置、筛选和历史索引等轻量 UI 状态保存在浏览器 localStorage;正文、图、checkpoint 与 revision 由 Host/SQLite 持久化。

文件 作用(常驻包)
lib/index.js Host 半:任务引擎 + /api/dsh-knowledge-graph 路由(抽取/追加、task status、document-load/canonical 来源成员校验 image-load/document-export、revisioned graph-commit、graph-query、answer-graph、安全 resume-extract、验证/质疑等)+ 自动 SQLite canonical graph / checkpoint 持久化
lib/client.js Client 半:__ModuleLoader__ 浏览器模块(fetch RPC + 手动样式注入)
cordis.patch.yml bundle patch:向组合插入 dsh-knowledge-graph 行

> src/ 与 lib/ 是同一插件的两种部署形态:src/ 供动态插件(方式 A/B)使用,lib/ 供常驻组合(方式 C)使用,逻辑保持一致。

3. 批准运行

定义成功后运行会进入 awaiting approval(等待批准) 状态:

  • 插件面板(左下角 Cordis Plugin 按钮)会自动弹出并高亮待批准的行;
  • 点 ✓(单勾):仅授权本次运行;点 ✓✓(双勾):同时授权该插件后续版本的自动运行(推荐);
  • 批准后插件在浏览器中激活,面板状态变为 running。

4. 验证安装

  • 左侧栏底部、设置上方出现「知识图」按钮,无需打开对话;
  • 点击弹出浮动工作台,粘贴一段正文 → 生成知识图,任务完成后可阅读知识图;
  • 对话区顶部出现第三个标签页「轨迹知识图」(对话 / 轨迹 / 轨迹知识图),点击 → 生成会话知识图,任务完成后可阅读该会话的知识图。

5. SQLite 持久化与 CLI

CLI 使用 Node node:sqlite,要求 Node 22.13+(无需 experimental-sqlite 启动参数)。导入必须用 DSH_KG_DB 或 --db 显式指定目标数据库,包含完整 sourceText,并通过与 Host 相同的确定性验收;导入文件不能自行授予 entailment verified。默认只允许创建新文档,覆盖已有文档必须传 `--expecte

README 较长,此处只展示前 60 KB。完整内容请到仓库查看 ↗。

常见问题

9 问
答案由本站依据条目字段整理,不引用上游原文
dsh-knowledge-graph 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:cwbcheng/dsh-knowledge-graph` 即可。对应的 npm 包名是 `dsh-knowledge-graph`。

dsh-knowledge-graph 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-knowledge-graph 安全吗?

低风险。vet 静态分析未发现可疑行为,判定为干净(clean)。

dsh-knowledge-graph 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-knowledge-graph 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.0-rc.2、0.1.7-rc.2、0.1.6-alpha.2、0.1.6-alpha.1、0.1.5-rc.2、0.1.3-alpha.2、0.1.3-alpha.1、0.1.2-rc.1。版本较多,只列出前 8 个。

dsh-knowledge-graph 需要什么运行环境?

Node.js >=22.13;需要同时安装 @deepseek-ai/cordis@^4.0.1。环境不满足时安装会失败,建议先确认本机版本。

dsh-knowledge-graph 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-knowledge-graph 有哪些功能?

正文/PDF/图片 AI 拆解成知识图、8 类节点、12 类关系语义契约、知识图与原文双向定位高亮、关系感知分层布局与邻近压缩、《学习观》本体与知识坍缩诊断。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

4 条
不同作者的仓库分开列,请确认你要装的是哪一个
记忆与知识
按星标排序,可作替代方案

ruflo

ruflo

L3 · 安装规范通过 7.4 万 星

OpenViking

OpenViking

面向 DeepSeek Harness 的 OpenViking 记忆与上下文插件:pre-step 自动召回与画像注入、会话捕获、`vik

L3 · 安装规范通过 3.9 万 星

WeKnora

WeKnora

把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己

L4 · 沙盒安装通过 3.3 万 星

distilly

distilly

Distilly — Distill how they think into reusable Skills for any Agent o

L4 · 沙盒安装通过 2.5 万 星

EverOS

EverOS

L4 · 沙盒安装通过 1.3 万 星

MemOS

MemOS

L4 · 沙盒安装通过 1.2 万 星

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-10-08。