软鉴SoftMemo
浏览软件目录

Open Knowledge Format (OKF) 是厂商中立的知识表示规范，以 Markdown 文件和 YAML 元数据组织知识，供人和 AI 读取。仓库附带从 BigQuery 元数据及网页生成知识包的参考代理，以及交互式图谱查看器；这些工具是概念验证实现，核心价值在于知识格式，而非成品笔记应用。

适合希望用 Git 共同维护组织知识的团队 · 需要整理 BigQuery 数据集说明的开发者 · 需要向同事展示概念关系的数据团队

亮点

  1. 知识不绑定特定平台

    以 Markdown 与 YAML 保存知识，不限定使用的 Agent、框架或模型供应商。

  2. 知识也能走代码评审

    知识包可纳入 Git，通过逐行差异、提交追溯与拉取请求维护内容。

  3. 来源与时效可查询

    v0.2 将来源、生成与确认信息及过期状态写入元数据，供消费端判断可信度。

  4. 附带生成与浏览示例

    仓库以概念验证 Agent 和图谱查看器，演示知识包从生成到消费的流程。

功能说明

知识包组织

  1. 结构与正文分工

    元数据承载可查询、筛选的字段，正文保存说明、模式与示例查询。

  2. 分层导航与互链

    自动生成的索引支持逐层浏览，Markdown 链接表达跨概念关系。

  3. 扩展知识字段

    少量必填键维持互操作，同时允许添加额外元数据与正文段落。

参考生成流程

  1. 提取数据集知识

    参考 Agent 先读取 BigQuery 元数据，为源中声明的概念生成文档。

  2. 网页补充上下文

    从指定种子网页出发，补充现有概念或建立独立参考文档，也可跳过。

  3. 限制抓取范围

    工具强制执行网页数量上限及可配置的同域允许列表，约束网页遍历。

图谱浏览

  1. 导出交互页面

    将知识包生成为单个 HTML 文件，无需查看端后端；图谱库与渲染库从 CDN 加载。

  2. 查看概念与引用

    图谱以类型区分节点，详情展示元数据、正文及反向引用。

  3. 搜索筛选图谱

    按标题、概念标识或标签搜索，按类型筛选，并切换图谱布局。

适合场景

  1. 希望用 Git 共同维护组织知识的团队

    可把知识更新纳入已有的评审与追溯流程，同时让人和 Agent 使用同一套文件。

  2. 需要整理 BigQuery 数据集说明的开发者

    参考 Agent 可先从元数据生成概念文档，再按需引入官方文档等网页上下文。

  3. 需要向同事展示概念关系的数据团队

    可导出交互式图谱页面，让接收者搜索概念、查看正文并追踪引用关系。

取舍

选它的理由

  • 知识维护可沿用 Git 审阅流程知识包是目录中的文本文件，可通过拉取请求、逐行差异和 blame 追踪修改，适合团队共同维护知识。
  • 来源、确认与时效可写入元数据v0.2 用 sources、generated、verified、status 和 stale_after 等字段描述出处、生产与确认信息及新鲜度，便于消费方判断知识是否值得采用。
  • 目录导航与知识关系可以同时表达自动生成的 index.md 支持逐层浏览，普通 Markdown 链接则表达跨目录关系，无需一次把整个知识包放入上下文。
  • 知识图谱可导出为单个 HTML 文件查看端无需安装或后端，可在现代浏览器中浏览图谱、查看正文与反向引用，并按标题、概念 ID、标签搜索。

先想清楚

  • 不适合将它直接当作成熟的成品知识管理应用

使用须知

  • 附带代理与查看器是概念验证实现仓库以格式规范为核心，代理和可视化工具用于演示知识包的生产与消费，不应按成熟的一体化知识管理应用选型。
  • 运行参考代理需要 Python 3.11 或更高版本构建文件明确规定最低 Python 版本，README 提供的是创建虚拟环境并从源码安装的流程。
  • 参考生成流程需要云服务凭据并涉及查询计费BigQuery 需要身份凭据与计费项目，即使查询公开数据集也会向调用方项目计费；Gemini 需配置 API 密钥或 Vertex AI。
  • 生成的查看器仍需从 CDN 加载前端依赖知识包内容嵌入 HTML，但 Cytoscape.js 与 marked 从 CDN 加载，不能仅凭单文件交付就视为完全离线可用。

同分类软件

查看全部

更多「笔记知识」软件

软鉴 SoftMemo

AI 整理的软件知识库

AI 整理软件资料、版本动态、更新通知、订阅权益与对比分析，沉淀可复用的工具知识。

进入软鉴浏览软件目录
访问网站