shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 开发与工程无需 API Key

本地第二大脑

本地优先的个人知识库：默认 OpenVINO 模式在本机完成索引、带来源检索问答与记忆蒸馏

person作者: dthzlxhubModelScope
download下载资源包

Local Second Brain（本地第二大脑）Skill Guide

个人知识底座：index 收资料 → query 带来源作答 → distill 蒸馏成「索引行 + 主题卡片」。默认后端为纯本地 OpenVINO；除非操作者显式选择 remote-dev，不会进行任何远程模型调用。

Usage

Windows:       scripts\run.ps1 <command> [argument]
macOS / Linux: scripts/run.sh  <command> [argument]

两个启动器接同一套命令与退出码，下表以 Windows 写法示例（POSIX 把 scripts\run.ps1 换成 scripts/run.sh、把 Windows 路径换成 POSIX 路径即可）。

Examples:

| Intent | Command | | --- | --- | | 索引一个目录的笔记/文档 | scripts\run.ps1 index D:\notes | | 从自己的资料里找答案 | scripts\run.ps1 query "上次关于 OpenVINO 量化我记了什么" | | 把已索引资料蒸馏成记忆卡片 | scripts\run.ps1 distill | | 查看索引与引擎状态 | scripts\run.ps1 status | | 停止常驻服务 | scripts\run.ps1 shutdown | | 模型下载超时后续跑 | scripts\run.ps1 --continue |

Important:

  • scripts\run.ps1 (Windows) / scripts/run.sh (macOS, Linux) is the only supported interface — do not call other scripts directly.
  • 默认 openvino 首次调用会下载模型（embedding + LLM，均为 INT4 量化）；若超时，用同一启动器加 --continue 续跑。
  • On non-supported hardware the skill prints an error and exits with code 1.
  • 默认 openvino 路径绝不回退到远程服务；远程开发模式也只使用本地索引命中的材料作为生成上下文。

Interpreting the reply

  • query 输出两段：【答案】（本地 LLM 归纳作答；mock 引擎为抽取式占位）与 【来源】（文件路径:起始行-结束行 来源锚，逐条可核验；来源锚由系统在答案后拼装，不进入模型语境）。
  • 所有拒答统一以「未找到相关内容」开头：检索无匹配直接拒答；检索有邻近资料但生成的答案未通过接地校验（答案中的数字/专名/字母数字串须出现在检索回的原文里，未接地比例超阈值即拒答，退化/占位符输出同样拒答）时替换为标准拒答句并保留最接近来源供核验。接地门可用 BRAIN_GROUNDING_GATE=0 整体关闭，BRAIN_GROUNDING_THRESHOLD 调整阈值（默认 0.5）。
  • index/distill/status 输出 JSON 摘要（索引文档数、卡片数、数据目录等）。
  • 蒸馏产物写入数据目录 cards/：每文档一张主题卡 + 汇总 INDEX_LINES.md（一行 hook 索引）。

Failure handling

  • exit 0 成功；exit 1 参数/硬件/初始化错误；exit 2 本地服务通信失败（可重跑，client 会自动重启服务）；exit 3 模型下载中（用 --continue）。
  • 服务端异常会置 state=error 并把完整 traceback 写入日志目录（~/.openvino/log/）。

Environment

  • 引擎默认 openvino（真实本地模型）。SECOND_BRAIN_ENGINE=mock 切到零下载的静态引擎，供 CI 与冒烟测试使用。
  • SECOND_BRAIN_LLM_DIR / SECOND_BRAIN_EMBEDDING_DIR 指定模型目录，覆盖 info.json 默认选型（低算力机器可换更小的 LLM）；SECOND_BRAIN_DEVICE 选 CPU/GPU/NPU。
  • <skill root>/.env（KEY=VALUE，每行一条，不随作品包发布）可为单台机器覆盖上面这些变量；OPENVINO_SKILL_PYTHON 指向已装好 OpenVINO 的解释器时跳过托管 venv，避免重复安装依赖。
  • 可选开发后端必须显式设 SECOND_BRAIN_ENGINE=remote-dev，并在同一台机器的 <skill root>/.env 中配置 SECOND_BRAIN_REMOTE_ENDPOINT、SECOND_BRAIN_REMOTE_MODEL；非回环端点还要求 SECOND_BRAIN_REMOTE_API_KEY。不要把 .env 纳入作品包或版本控制。远程模式会把本地检索命中的片段发送到所配置端点，不能用于要求资料不出机的场景。

What this skill does NOT do

  • 不联网检索；索引之外的内容一律回答「未找到」。默认 openvino 完全离线，只有显式选择 remote-dev 才调用配置的模型端点。
  • 不自动监控文件变化（重跑 index 才会更新）；不做定时任务。
  • 不处理图片/PDF OCR（当前只收 .md/.txt；OCR 属于 roadmap）。