开放知识图谱 TorRient/dsh-okf

DSH OKF 插件（dsh-okf）

一个可直接用于生产环境的 DeepSeek Harness (DSH) 插件，实现 Open Knowledge Format (OKF v0.2) 标准。

OKF 不用无结构的文本块，也不用概率性嵌入——这两者会让智能体产生幻觉。它把复杂系统建模成可验证、确定性的知识图谱：由 Markdown 文档组成，带严格的 YAML frontmatter、反向链接、新鲜度追踪和审计记录。

功能

- 6 个 DSH 智能体工具：
- okf_init：初始化符合 OKF v0.2 标准的 bundle（index.md、log.md、起始概念）。
- okf_validate：确定性 linter，检查 frontmatter、必填的 type、断链、孤立概念和过期状态。
- okf_search：按关键词、类型、标签或验证状态搜索概念。
- okf_concept_read：读取概念 frontmatter、Markdown 正文，以及计算出的入站反向链接。
- okf_concept_write：创建或更新概念文件，校验 frontmatter，并自动在 log.md 中记录审计日志。
- okf_visualize：导出交互式力导向 HTML 图谱（viz.html），由 Cytoscape.js 驱动。

- 交互式 Web UI 与 REST API：
- GET /api/okf/view：全屏浏览器可视化界面，支持搜索、分类过滤、布局切换和检查器侧边栏。
- GET /api/okf/graph：Cytoscape 兼容的 JSON 图谱（节点、边、反向链接、元数据）。
- GET /api/okf/status：当前工作区的健康度与合规性统计。

- DSH 系统提示词与技能集成：
- 内置 DSH 技能，位于 skills/okf/SKILL.md。
- 向 DSH 智能体上下文注入运行时指引，让智能体自动采用 OKF 实践。

在 DeepSeek Harness 中安装

方式 1：命令行安装（推荐）

运行 dsh plugin add 命令，直接从 GitHub 安装到你的配置档：

dsh plugin --profile web add github:TorRient/dsh-okf

这条命令会自动：
- 下载 dsh-okf 并链接到配置档的 node_modules/。
- 把 dsh-okf 注册进当前配置档的 bundle 列表（dsh.profile.bundles）。
- 挂载 6 个 OKF 智能体工具、Web 可视化路由，以及内置的 OKF 智能体技能。

方式 2：本地链接（用于开发）

1. 把包软链接或链接到你的 DSH 配置档（~/.dsh/profiles/web/node_modules/）： ln -s /path/to/dsh-okf ~/.dsh/profiles/web/node_modules/dsh-okf

2. 在 DSH 配置档清单（~/.dsh/profiles/web/package.json）中注册 bundle： {
"dsh": {
"profile": {
"bundles": [
"...",
"dsh-okf"
]
}
}
}

或者直接把条目加进 ~/.dsh/cordis.patch.yml：
- insert:
- id: okf
name: 'dsh-okf'
- id: okf-skill-filesystem
name: '@deepseek-ai/dsh-skill-filesystem'
config:
providerName: okf-plugin
includeDefaultRoots: falsejs
bundledSkillDir: !!js process.getBuiltinModule('node:path').join(process.getBuiltinModule('node:path').dirname(process.getBuiltinModule('node:module').createRequire(baseUrl).resolve('dsh-okf/package.json')), 'skills')

OKF 包结构 text my-knowledge-base/ ├── index.md # Bundle root manifest & table of contents ├── log.md # Append-only revision changelog └── concepts/ # Domain, Architecture, API, and Schema concepts ├── architecture.md └── payment-service.md

概念元数据示例 markdown

type: Architecture
title: Payment Gateway
description: "Processes credit card transactions and settlements."
status: verified
stale_after: "2026-12-31"
tags:
- payments
- billing
sources:
- "https://internal.wiki/pay-v2"

Payment Gateway

Payment Gateway communicates with Auth Service.

测试

运行内置测试套件：bash
node --test test/*/.test.js

包含 22 个自动化测试，覆盖解析器、序列化器、包扫描器、一致性校验器、智能体工具、Web 路由和 Cordis 生命周期。

许可证

MIT