patent-map

1# 专利地图
2 
3## 用途
4 
5把已经解读入库的案例摊成五种图（语义地形），给代理师找相近案子、看申请人重叠和文内引证。本包只读 vault、起本地页。空白点只表示「库里没读到」。
6 
7## 何时用
8 
9须用户点名（专利地图 / 案例地图 / `/专利地图` / `/patent-map`）。解读继续只入库。
10 
11## 输入
12 
13已有解读入库的 vault（与解读同一份：`PATENT_READER_OBSIDIAN_VAULT` 或 `~/.patent-disclosure-skill/obsidian_vault.txt`）。取数优先扫 `Research/Patents/**/*_解读_*.md`。若本机 `obsidian` CLI 可用且库已打开，用 `obsidian vaults` / `base:query` 核对，不替代磁盘扫描。
14 
15## 步骤
16 
171. **`Read`** `prompts/guardrails.md` → `intake.md`
182. 确认库路径
193. 启动：
20 
21```bash
22python skills/patent-map/tools/serve_map.py
23```
24 
25stdout 机读前缀：`MAP_URL:` / `MAP_PORT:` / `MAP_VAULT:` / `MAP_SOURCE:` / `MAP_CACHE:` / `MAP_MODEL:`。端口由系统随机分配（`127.0.0.1:0`）。对话里把 URL 发给用户。
26 
27地形图按解读短文向量摊开。加载名 `BAAI/bge-small-zh-v1.5`，磁盘只装 **Qdrant ONNX**（见 `prompts/guardrails.md` 取数）。数据与模型默认目录：`{Documents}/patent-disclosure-skill/patent-map/`（与 oa 同级）。未装 `fastembed` 时图仍能开，地形退回 IPC 簇。
28 
29可选：
30 
31```bash
32pip install -r skills/patent-map/tools/requirements.txt
33python skills/patent-map/tools/ensure_model.py
34```
35 
36单独拷走本包时：`python tools/serve_map.py`。
37 
38## 护栏
39 
40- 细则 `prompts/guardrails.md`。地图脚本只用本包 `tools/`；解读笔记直接读 vault 文件。
41 
42## 产出物
43 
44本机页面 URL（`MAP_URL`）。索引与模型在 `{Documents}/patent-disclosure-skill/patent-map/`。本包**不设**「交付后请确认」。