远程知识库KNOWLEDGE-BASE-REMOTE

你的资料,你的边界。

把资料交给 AI,
把出处留在手边。

用一个轻量技能,连接 NAS 中获准开放的资料。让 AI 按需检索、阅读片段,回答时保留可以核对的原文出处。

只读访问 · 独立凭据 · 路径、行号与版本引用

技能已开放安装真实知识正文待接入;访问凭据由管理员另行提供。
01 认识这个技能

让 AI 查资料,
也知道答案从哪里来。

适合核对笔记、查阅项目文档,或引用 NAS 中已获授权的文字资料。先检索相关文档,再读取需要的段落,最后把出处带回回答。

支持 UTF-8 的 Markdown、TXT、RST。使用关键词包含匹配,不提供向量搜索、PDF 解析或 OCR。

02 安装到你的 Hermes

从这里,
连接你的资料。

在外部电脑的 Hermes CLI 中执行。客户端需要 Python 3.10+,不需要额外的第三方 Python 包。

打开 SKILL.md
Hermes CLI
hermes skills install https://skillknow.dl.3q.hair/skills/knowledge-base-remote/SKILL.md
安全扫描通过后再安装

安装只获取技能文件和客户端。读取 NAS 正文仍需配置连接与独立凭据。

03 安装之后

三步,把连接准备好。

完整配置说明
  1. 01

    填写服务地址

    在技能目录创建 client-config.json。地址只填域名根部,不加 /api。

    client-config.json
    {
      "base_url": "https://skillknow.dl.3q.hair",
      "timeout_seconds": 15
    }
  2. 02

    单独保存读取凭据

    从管理员取得凭据,保存在仅自己可读的本地私有文件中。客户端通过 --token-file 指定这个文件。

    不要把 Token 写进配置、聊天、URL 或公开分发包。网页不收集凭据。

  3. 03

    确认就绪,再开始查资料

    先运行 doctor,确认认证通过、有可读正文;再读入口规则,执行检索和按版本阅读。

    查看连接检查命令
    python "<skill-dir>/scripts/kb_client.py" --token-file "<private-token-file>" doctor

    把两处占位路径替换为实际位置。Windows 可用 py -3,Linux/macOS 可用 python3。

一次有依据的查询

doctor → manifest → search → read → citation

按版本读到原文后,在回答中保留文档路径、行号和版本。库未就绪时停止查询,不编造资料。

04 常见问题

开始之前,
你可能还想知道。

现在可以直接查询正文吗?

技能下载与公网安装已可用。当前真实正文尚未接入,正式读取凭据也需管理员另行提供。健康检查成功只证明服务存活,不能证明正文可查。

安装会下载整个知识库吗?

不会。安装包只有技能说明、接口文档、配置示例和客户端脚本。连接后根据权限按需读取片段;不把 NAS 正文作为安装内容下载。

哪些资料会交给模型服务商?

正文保存在 NAS。外部 AI 在回答时读取的片段,可能被发送给你使用的模型服务商。开放范围应与资料的分享边界一致。

这个技能能修改 NAS 文件吗?

不能。接口只提供状态、目录、检索和阅读,不提供上传、写入、删除或系统管理端点。读取范围由服务端的授权设置约束。

其他 AI 工具也能用吗?

页面上的一行安装命令适用于 Hermes。客户端脚本使用 Python 标准库,其他工具需要自己读取技能说明、配置凭据并调用脚本;不能保证所有客户端都能直接安装这个 URL。