docs-search 1.0.0__py3-none-any.whl

docs_search/__init__.py

@@ -0,0 +1,25 @@
+"""docs_search: 零依赖本地文档搜索引擎（SQLite 索引，CLI + Web UI）"""
+
+__version__ = "1.0.0"
+
+from .core import (  # noqa: F401
+    ENV_DB_PATH,
+    ENV_DOCS_DIR,
+    MAX_UPLOAD_BYTES,
+    build_db,
+    dedupe_target,
+    ensure_index,
+    files_hash,
+    get_conn,
+    load_meta,
+    meta_path,
+    need_reindex,
+    rebuild_index,
+    resolve_db_path,
+    resolve_docs_dir,
+    sanitize_filename,
+    save_meta,
+    scan_docs,
+    scan_meta,
+    win_utf8,
+)

docs_search/cli.py

@@ -0,0 +1,231 @@
+"""docs-search: 本地文档搜索引擎（零依赖，SQLite，毫秒级检索）
+
+用法:
+  python scripts/docs-search.py index [--dir 目录]
+  python scripts/docs-search.py search "关键词" [--dir 目录]
+  python scripts/docs-search.py list [--dir 目录]
+  python scripts/docs-search.py show <path> [--dir 目录]
+  python scripts/docs-search.py status [--dir 目录]
+  python scripts/docs-search.py upload <file.md> [--dir 目录]  # 上传（复制）文档
+
+路径规则（不绑定任何本地路径）:
+  文档目录: --dir > 环境变量 DOCS_SEARCH_DIR > ./docs
+  索引库:   ~/.docs-search/<目录哈希>/index.db（按目录隔离，多库并存）
+
+跨平台: Windows / macOS / Linux
+"""
+
+import argparse
+import subprocess
+import sys
+from pathlib import Path
+
+from .core import (
+    MAX_UPLOAD_BYTES,
+    dedupe_target,
+    ensure_index,
+    get_conn,
+    load_meta,
+    resolve_db_path,
+    resolve_docs_dir,
+    sanitize_filename,
+    win_utf8,
+)
+
+# 短命令别名
+ALIAS = {"i": "index", "s": "search", "st": "status", "l": "list", "sh": "show", "u": "upload"}
+
+
+def _paths(args):
+    docs_dir = resolve_docs_dir(getattr(args, "dir", None))
+    db_path = resolve_db_path(docs_dir, getattr(args, "db", None))
+    return docs_dir, db_path
+
+
+def cmd_index(args):
+    win_utf8()
+    docs_dir, db_path = _paths(args)
+    from .core import rebuild_index
+
+    n, dt = rebuild_index(docs_dir, db_path)
+    print(f"indexed {n} docs in {dt:.0f}ms")
+    print(f"  docs: {docs_dir}")
+    print(f"  db:   {db_path}")
+
+
+def cmd_search(args):
+    win_utf8()
+    docs_dir, db_path = _paths(args)
+    import time
+
+    t0 = time.time()
+    n, rebuilt = ensure_index(docs_dir, db_path)
+    if rebuilt:
+        print(f"[auto] reindexed {n} docs")
+    c = get_conn(db_path)
+    q = args.query.strip()
+    keywords = q.split()
+    if not keywords:
+        print('no results for ""')
+        return
+    conditions, params = [], []
+    for kw in keywords:
+        conditions.append("(title LIKE ? OR body LIKE ?)")
+        params.extend([f"%{kw}%", f"%{kw}%"])
+    sql = f"SELECT path, cat, title, body FROM docs WHERE {' AND '.join(conditions)} LIMIT ?"
+    params.append(args.limit)
+    rows = c.execute(sql, params).fetchall()
+    c.close()
+    dt = (time.time() - t0) * 1000
+    if not rows:
+        print(f'no results for "{q}"')
+        return
+    print(f'"{q}" -> {len(rows)} results ({dt:.0f}ms)\n')
+    for path, cat, title, body in rows:
+        print(f"[{path}] {title}")
+        print(f"  {body[:120].replace(chr(10), ' ')}...")
+        print()
+
+
+def cmd_list(args):
+    win_utf8()
+    _docs_dir, db_path = _paths(args)
+    c = get_conn(db_path)
+    rows = c.execute("SELECT cat, path, title, size FROM docs ORDER BY cat, title").fetchall()
+    c.close()
+    if not rows:
+        print("empty")
+        return
+    print(f"total: {len(rows)} docs\n")
+    cur = None
+    for cat, path, title, size in rows:
+        if cat != cur:
+            cur = cat
+            print(f"\n### {cat}/")
+        print(f"  . {path} -- {title} ({size // 1024}KB)")
+
+
+def cmd_show(args):
+    win_utf8()
+    _docs_dir, db_path = _paths(args)
+    c = get_conn(db_path)
+    row = c.execute("SELECT title, body, size FROM docs WHERE path=?", (args.path,)).fetchone()
+    c.close()
+    if not row:
+        print(f"not found: {args.path}")
+        return
+    title, body, size = row
+    print(f"\n{title} [{args.path}] ({size // 1024}KB)\n{body[:2000]}")
+    if len(body) > 2000:
+        print(f"\n...(total {len(body) // 1024}KB)")
+    print()
+
+
+def cmd_status(args):
+    win_utf8()
+    docs_dir, db_path = _paths(args)
+    from .core import need_reindex
+
+    meta = load_meta(db_path)
+    if not db_path.exists():
+        print(f"docs: {docs_dir}")
+        print("no index yet. run: docs-search index")
+        return
+    c = get_conn(db_path)
+    count = c.execute("SELECT COUNT(*) FROM docs").fetchone()[0]
+    c.close()
+    stale = need_reindex(meta, db_path, docs_dir)
+    print(f"docs:    {docs_dir}")
+    print(f"db:      {db_path}")
+    print(f"records: {count}")
+    if meta:
+        print(f"updated: {meta.get('updated', '?')}")
+        print(f"stale:   {'yes (search will auto-reindex)' if stale else 'no'}")
+
+
+def cmd_upload(args):
+    """把一个 .md 文件复制到文档库 uploads/ 并重建索引"""
+    win_utf8()
+    docs_dir, db_path = _paths(args)
+    src = Path(args.file).expanduser().resolve()
+    if not src.exists():
+        print(f"not found: {src}")
+        sys.exit(1)
+    if src.stat().st_size > MAX_UPLOAD_BYTES:
+        print(f"too large (max {MAX_UPLOAD_BYTES // 1024 // 1024}MB): {src.name}")
+        sys.exit(1)
+    name = sanitize_filename(src.name)
+    if not name:
+        print(f"invalid filename: {src.name}")
+        sys.exit(1)
+    target = dedupe_target(docs_dir, name)
+    if not target:
+        print("upload failed: cannot allocate target name")
+        sys.exit(1)
+    target.write_bytes(src.read_bytes())
+    from .core import rebuild_index
+
+    n, dt = rebuild_index(docs_dir, db_path)
+    print(f"uploaded: {target.name} -> uploads/{target.name}")
+    print(f"reindexed {n} docs in {dt:.0f}ms")
+
+
+def cmd_open(args):
+    win_utf8()
+    docs_dir, _ = _paths(args)
+    p = docs_dir / args.path.replace("\\", "/")
+    if not p.exists():
+        print(f"not found: {args.path}")
+        return
+    if sys.platform == "win32":
+        subprocess.Popen(["start", "/B", "", str(p)], shell=True, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+    elif sys.platform == "darwin":
+        subprocess.Popen(["open", str(p)], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+    else:
+        subprocess.Popen(["xdg-open", str(p)], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+
+
+def main():
+    p = argparse.ArgumentParser(prog="docs-search", description="docs-search: 本地文档搜索引擎（零依赖）")
+    sub = p.add_subparsers(dest="cmd")
+
+    def add(name, aliases, help_text):
+        sp = sub.add_parser(name, aliases=aliases, help=help_text)
+        sp.add_argument("--dir", default=None, help="文档根目录（默认 ./docs 或 $DOCS_SEARCH_DIR）")
+        sp.add_argument("--db", default=None, help="索引库路径（默认 ~/.docs-search/<目录哈希>/index.db）")
+        return sp
+
+    add("index", ["i"], "重建索引")
+    sp_search = add("search", ["s"], "搜索文档")
+    sp_search.add_argument("query", help="搜索关键词（多关键词 AND）")
+    sp_search.add_argument("--limit", "-n", type=int, default=8, help="结果条数（默认 8）")
+    add("list", ["l"], "列出所有文档")
+    sp_show = add("show", ["sh"], "显示文档内容")
+    sp_show.add_argument("path", help="文档相对路径（如 infra/mcp.md）")
+    add("status", ["st"], "查看索引状态")
+    sp_up = add("upload", ["u"], "上传（复制）.md 文档到 uploads/ 并重建索引")
+    sp_up.add_argument("file", help="要上传的 .md 文件路径")
+    sp_open = add("open", ["o"], "用系统默认程序打开文档")
+    sp_open.add_argument("path", help="文档相对路径")
+
+    a = p.parse_args()
+    if not a.cmd:
+        p.print_help()
+        return
+    fn = {
+        "index": cmd_index,
+        "search": cmd_search,
+        "list": cmd_list,
+        "show": cmd_show,
+        "status": cmd_status,
+        "upload": cmd_upload,
+        "open": cmd_open,
+    }.get(ALIAS.get(a.cmd, a.cmd))
+    if fn:
+        fn(a)
+    else:
+        p.print_help()
+
+
+if __name__ == "__main__":
+    main()

docs_search/core.py

@@ -0,0 +1,215 @@
+"""docs_search.core: docs-search 共享核心模块（CLI 与 Web 共用，零第三方依赖）
+
+路径解析规则（不绑定任何本地/个人路径）:
+  文档目录:  --dir 参数 > 环境变量 DOCS_SEARCH_DIR > ./docs（当前工作目录下）
+  索引库:    --db 参数 > 环境变量 DOCS_SEARCH_DB > ~/.docs-search/<目录哈希>/index.db
+             按文档目录哈希隔离，多个文档库可并存互不干扰。
+"""
+
+import hashlib
+import json
+import os
+import sqlite3
+import sys
+import time
+from datetime import datetime
+from pathlib import Path
+
+ENV_DOCS_DIR = "DOCS_SEARCH_DIR"
+ENV_DB_PATH = "DOCS_SEARCH_DB"
+DEFAULT_DOCS_DIRNAME = "docs"
+MAX_UPLOAD_BYTES = 10 * 1024 * 1024  # 上传体积上限 10MB
+
+
+def win_utf8():
+    """Windows 控制台 GBK 兼容: 强制 UTF-8 输出"""
+    if sys.platform == "win32":
+        os.environ.setdefault("PYTHONIOENCODING", "utf-8")
+        import io
+
+        try:
+            sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8", errors="replace")
+            sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding="utf-8", errors="replace")
+        except Exception:  # noqa: BLE001, S110 -- 控制台包装失败时静默降级
+            pass
+
+
+def resolve_docs_dir(explicit=None):
+    """解析文档根目录: --dir > DOCS_SEARCH_DIR > ./docs"""
+    if explicit:
+        p = Path(explicit).expanduser()
+    elif os.environ.get(ENV_DOCS_DIR):
+        p = Path(os.environ[ENV_DOCS_DIR]).expanduser()
+    else:
+        p = Path.cwd() / DEFAULT_DOCS_DIRNAME
+    return p.resolve()
+
+
+def resolve_db_path(docs_dir, explicit=None):
+    """解析索引库路径: --db > DOCS_SEARCH_DB > ~/.docs-search/<hash>/index.db"""
+    if explicit:
+        return Path(explicit).expanduser().resolve()
+    if os.environ.get(ENV_DB_PATH):
+        return Path(os.environ[ENV_DB_PATH]).expanduser().resolve()
+    key = hashlib.sha1(str(docs_dir).replace("\\", "/").lower().encode("utf-8")).hexdigest()[:12]
+    return Path.home() / ".docs-search" / key / "index.db"
+
+
+def meta_path(db_path):
+    return db_path.with_name("index.meta.json")
+
+
+# ============================================================
+# 扫描与索引
+# ============================================================
+def scan_meta(docs_dir):
+    """扫描文档目录元信息（不读内容，用于快速变更检测）: [(rel, size, mtime, cat)]"""
+    out = []
+    if not docs_dir.exists():
+        return out
+    for root, _, files in os.walk(docs_dir):
+        for f in files:
+            if not f.lower().endswith(".md"):
+                continue
+            p = Path(root) / f
+            rel = str(p.relative_to(docs_dir)).replace("\\", "/")
+            try:
+                st = p.stat()
+                out.append((rel, st.st_size, int(st.st_mtime), rel.split("/")[0]))
+            except OSError:
+                pass
+    return out
+
+
+def scan_docs(docs_dir):
+    """扫描并读取文档内容: [(rel, cat, title, body, size, mtime)]"""
+    out = []
+    if not docs_dir.exists():
+        return out
+    for root, _, files in os.walk(docs_dir):
+        for f in files:
+            if not f.lower().endswith(".md"):
+                continue
+            p = Path(root) / f
+            rel = str(p.relative_to(docs_dir)).replace("\\", "/")
+            try:
+                txt = p.read_text(encoding="utf-8")
+                lines = txt.split("\n")
+                title = next((l[2:].strip() for l in lines if l.startswith("# ")), f)
+                bs = next(
+                    (i for i, l in enumerate(lines) if l and not l.startswith("#") and not l.startswith(">")),
+                    len(lines),
+                )
+                body = "\n".join(lines[bs:]).strip()
+                st = p.stat()
+                out.append((rel, rel.split("/")[0], title, body, st.st_size, int(st.st_mtime)))
+            except (OSError, UnicodeDecodeError):
+                pass  # 跳过不可读/非 UTF-8 文件
+    return out
+
+
+def files_hash(entries):
+    """按 (rel, mtime, size) 计算目录指纹，不读内容"""
+    h = hashlib.sha256()
+    for rel, size, mtime, _cat in sorted(entries, key=lambda x: x[0]):
+        h.update(f"{rel}:{mtime}:{size}".encode())
+    return h.hexdigest()[:16]
+
+
+def build_db(db_path):
+    """重建数据库表（幂等：DROP IF EXISTS，不依赖删除文件，DB 被占用时也能重建）"""
+    db_path.parent.mkdir(parents=True, exist_ok=True)
+    c = sqlite3.connect(str(db_path))
+    c.execute("DROP TABLE IF EXISTS docs")
+    c.execute("CREATE TABLE docs(path TEXT PRIMARY KEY, cat TEXT, title TEXT, body TEXT, size INT, mtime INT)")
+    c.execute("CREATE INDEX idx_cat ON docs(cat)")
+    c.execute("CREATE INDEX idx_title ON docs(title)")
+    c.commit()
+    return c
+
+
+def get_conn(db_path):
+    db_path.parent.mkdir(parents=True, exist_ok=True)
+    c = sqlite3.connect(str(db_path))
+    c.execute("SELECT 1")
+    return c
+
+
+def load_meta(db_path):
+    try:
+        return json.loads(meta_path(db_path).read_text(encoding="utf-8"))
+    except Exception:  # noqa: BLE001 -- 元数据损坏时按无元数据处理
+        return {}
+
+
+def save_meta(db_path, meta):
+    meta_path(db_path).write_text(json.dumps(meta, ensure_ascii=False, indent=2), encoding="utf-8")
+
+
+def need_reindex(meta, db_path, docs_dir):
+    """需要重建: 无元数据 / 库文件丢失 / 目录指纹变化"""
+    if not meta:
+        return True
+    if not db_path.exists():
+        return True
+    return files_hash(scan_meta(docs_dir)) != meta.get("hash", "")
+
+
+def rebuild_index(docs_dir, db_path):
+    """全量重建索引，返回 (文档数, 耗时ms)。DB 被占用时抛出带提示的 RuntimeError"""
+    t0 = time.time()
+    try:
+        files = scan_docs(docs_dir)
+        c = build_db(db_path)
+        c.executemany("INSERT INTO docs VALUES(?,?,?,?,?,?)", files)
+        c.commit()
+        c.close()
+    except sqlite3.OperationalError as e:
+        raise RuntimeError(f"索引库被占用，无法重建（是否有其他 docs-search 进程正在使用？）: {e}") from e
+    meta = {
+        "hash": files_hash(scan_meta(docs_dir)),
+        "count": len(files),
+        "updated": datetime.now().astimezone().isoformat(),
+    }
+    save_meta(db_path, meta)
+    return len(files), (time.time() - t0) * 1000
+
+
+def ensure_index(docs_dir, db_path):
+    """确保索引存在且最新，返回 (文档数, 是否发生重建)"""
+    meta = load_meta(db_path)
+    if need_reindex(meta, db_path, docs_dir):
+        n, _ = rebuild_index(docs_dir, db_path)
+        return n, True
+    return meta.get("count", 0), False
+
+
+# ============================================================
+# 上传文件名安全化
+# ============================================================
+def sanitize_filename(name):
+    """清洗上传文件名: 仅保留basename、去除危险字符、必须 .md 结尾。非法返回 None"""
+    import re
+
+    name = (name or "").strip()
+    name = name.replace("\\", "/")
+    name = name.split("/")[-1]  # 仅取 basename，防路径穿越
+    name = re.sub(r'[\\/:*?"<>|\x00-\x1f]', "_", name).strip(". ")
+    if not name or not name.lower().endswith(".md") or len(name) > 200:
+        return None
+    return name
+
+
+def dedupe_target(docs_dir, name):
+    """在 docs_dir/uploads/ 下生成不重名的目标路径"""
+    updir = docs_dir / "uploads"
+    updir.mkdir(parents=True, exist_ok=True)
+    target = updir / name
+    if not target.exists():
+        return target
+    stem, ext = os.path.splitext(name)
+    for i in range(1, 1000):
+        cand = updir / f"{stem}-{i}{ext}"
+        if not cand.exists():
+            return cand
+    return None

docs_search/web.py

@@ -0,0 +1,450 @@
+"""docs-search-web: 文档搜索 Web UI（零依赖，含上传接口）
+
+用法:
+  python scripts/docs-search-web.py [文档目录]              # 启动并打开浏览器
+  python scripts/docs-search-web.py --no-browser           # 不打开浏览器
+  python scripts/docs-search-web.py --port 8080 --host 0.0.0.0
+
+路径规则（不绑定任何本地路径）:
+  文档目录: 命令行 [目录] > 环境变量 DOCS_SEARCH_DIR > ./docs
+  索引库:   ~/.docs-search/<目录哈希>/index.db（按目录隔离）
+
+API:
+  GET  /api/stats                    # 统计 {count, updated, categories}
+  GET  /api/search?q=关键词&cat=     # 搜索
+  GET  /api/list?cat=                # 列出文档
+  GET  /api/show?path=xxx            # 文档内容
+  POST /api/upload?filename=x.md     # 上传文档（raw body = 文件内容，UTF-8）
+  POST /api/delete?path=uploads/x.md # 删除 uploads/ 下已上传文档
+
+安全: 默认仅监听 127.0.0.1；上传仅限 .md、单文件 ≤10MB、文件名已消毒。
+"""
+
+import argparse
+import json
+import sys
+import urllib.parse
+from http.server import BaseHTTPRequestHandler, HTTPServer
+
+from .core import (
+    MAX_UPLOAD_BYTES,
+    dedupe_target,
+    ensure_index,
+    get_conn,
+    load_meta,
+    resolve_db_path,
+    resolve_docs_dir,
+    sanitize_filename,
+    win_utf8,
+)
+
+DEFAULT_PORT = 8765
+
+# ============================================================
+# HTML 界面
+# ============================================================
+HTML_TEMPLATE = """<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>docs-search</title>
+<style>
+* { margin: 0; padding: 0; box-sizing: border-box; }
+body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; background: #f5f5f5; color: #333; }
+.container { max-width: 900px; margin: 0 auto; padding: 20px; }
+h1 { text-align: center; margin-bottom: 20px; color: #1a1a1a; }
+.search-box { display: flex; gap: 10px; margin-bottom: 20px; }
+.search-box input { flex: 1; padding: 12px 16px; border: 2px solid #ddd; border-radius: 8px; font-size: 16px; outline: none; }
+.search-box input:focus { border-color: #4a90d9; }
+.search-box button { padding: 12px 24px; background: #4a90d9; color: white; border: none; border-radius: 8px; font-size: 16px; cursor: pointer; }
+.search-box button:hover { background: #357abd; }
+.btn-upload { padding: 12px 18px; background: #34a853; color: white; border: none; border-radius: 8px; font-size: 16px; cursor: pointer; }
+.btn-upload:hover { background: #2d9248; }
+.btn-upload.dragover { outline: 3px dashed #34a853; outline-offset: 2px; }
+.stats { text-align: center; color: #666; margin-bottom: 15px; font-size: 14px; }
+.result-item { background: white; border-radius: 8px; padding: 16px; margin-bottom: 12px; box-shadow: 0 1px 3px rgba(0,0,0,0.1); }
+.result-item:hover { box-shadow: 0 2px 8px rgba(0,0,0,0.15); }
+.result-title { font-size: 16px; font-weight: 600; color: #1a73e8; margin-bottom: 6px; }
+.result-path { font-size: 13px; color: #666; margin-bottom: 8px; }
+.result-snippet { font-size: 14px; color: #444; line-height: 1.5; }
+.result-cat { display: inline-block; padding: 2px 8px; background: #e8f0fe; color: #1a73e8; border-radius: 4px; font-size: 12px; margin-right: 8px; }
+.btn-del { float: right; padding: 4px 12px; background: #fff; color: #d93025; border: 1px solid #d93025; border-radius: 6px; font-size: 12px; cursor: pointer; }
+.btn-del:hover { background: #d93025; color: white; }
+.loading { text-align: center; padding: 40px; color: #666; }
+.error { text-align: center; padding: 20px; color: #d32f2f; }
+.empty { text-align: center; padding: 40px; color: #999; }
+.cat-list { display: flex; flex-wrap: wrap; gap: 8px; margin-bottom: 20px; justify-content: center; }
+.cat-btn { padding: 6px 14px; background: white; border: 1px solid #ddd; border-radius: 20px; font-size: 13px; cursor: pointer; transition: all 0.2s; }
+.cat-btn:hover, .cat-btn.active { background: #4a90d9; color: white; border-color: #4a90d9; }
+#toast { position: fixed; bottom: 24px; left: 50%; transform: translateX(-50%); background: #333; color: white; padding: 10px 20px; border-radius: 8px; font-size: 14px; display: none; z-index: 9; }
+#content-area { margin-top: 20px; }
+#content-area pre { background: #f8f9fa; padding: 16px; border-radius: 8px; overflow-x: auto; font-size: 14px; line-height: 1.6; white-space: pre-wrap; word-break: break-word; }
+.back-btn { display: inline-block; margin-bottom: 15px; padding: 8px 16px; background: #eee; border: none; border-radius: 6px; cursor: pointer; font-size: 14px; }
+.back-btn:hover { background: #ddd; }
+</style>
+</head>
+<body>
+<div class="container">
+  <h1>📚 docs-search</h1>
+  <div class="search-box">
+    <input type="text" id="search-input" placeholder="输入关键词搜索..." autocomplete="off">
+    <button onclick="doSearch()">搜索</button>
+    <button class="btn-upload" id="upload-btn" title="上传 .md 文档（也可拖拽到本按钮）">⬆ 上传</button>
+    <input type="file" id="file-input" accept=".md" multiple hidden>
+  </div>
+  <div class="stats" id="stats"></div>
+  <div class="cat-list" id="cat-list"></div>
+  <div id="content-area">
+    <div class="empty">输入关键词开始搜索，或选择分类浏览</div>
+  </div>
+</div>
+<div id="toast"></div>
+<script>
+let currentCat = '';
+
+const $ = id => document.getElementById(id);
+const escHtml = s => (s||'').replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
+
+function toast(msg, ms=2500) {
+  const t = $('toast');
+  t.textContent = msg;
+  t.style.display = 'block';
+  clearTimeout(t._timer);
+  t._timer = setTimeout(() => t.style.display = 'none', ms);
+}
+
+$('search-input').addEventListener('keypress', e => { if (e.key === 'Enter') doSearch(); });
+
+// ---- 上传（点击选择 / 拖拽 .md 文件）----
+const upBtn = $('upload-btn');
+upBtn.addEventListener('click', () => $('file-input').click());
+['dragover', 'dragenter'].forEach(ev => upBtn.addEventListener(ev, e => { e.preventDefault(); upBtn.classList.add('dragover'); }));
+['dragleave', 'drop'].forEach(ev => upBtn.addEventListener(ev, e => { e.preventDefault(); upBtn.classList.remove('dragover'); }));
+upBtn.addEventListener('drop', e => uploadFiles([...e.dataTransfer.files]));
+$('file-input').addEventListener('change', e => uploadFiles([...e.target.files]));
+
+async function uploadFiles(files) {
+  const mds = files.filter(f => f.name.toLowerCase().endsWith('.md'));
+  if (!mds.length) { toast('请选择 .md 文件'); return; }
+  for (const f of mds) {
+    if (f.size > 10 * 1024 * 1024) { toast(`跳过（超过 10MB）: ${f.name}`); continue; }
+    try {
+      const text = await f.text();
+      const r = await fetch('/api/upload?filename=' + encodeURIComponent(f.name),
+                            { method: 'POST', body: text });
+      const data = await r.json();
+      if (data.error) { toast(`上传失败: ${escHtml(data.error)}`); return; }
+      toast(`已上传: ${data.path}（索引 ${data.count} 篇）`);
+    } catch (e) { toast('上传失败: ' + escHtml(e.message)); return; }
+  }
+  $('file-input').value = '';
+  loadCategories();
+  if (currentCat) filterCat(currentCat);
+}
+
+// ---- 统计与分类 ----
+async function loadCategories() {
+  try {
+    const r = await fetch('/api/stats');
+    const data = await r.json();
+    $('stats').textContent = `共 ${data.count} 个文档 | 最后更新: ${data.updated}`;
+    const cats = [...new Set(data.categories || [])].sort();
+    const list = $('cat-list');
+    list.innerHTML = `<button class="cat-btn ${currentCat === '' ? 'active' : ''}" data-cat="">全部</button>`;
+    cats.forEach(c => {
+      list.innerHTML += `<button class="cat-btn ${currentCat === c ? 'active' : ''}" data-cat="${escHtml(c)}">${escHtml(c)}</button>`;
+    });
+  } catch (e) { $('stats').textContent = '加载失败'; }
+}
+
+// ---- 搜索 ----
+async function doSearch() {
+  const q = $('search-input').value.trim();
+  if (!q) return;
+  const area = $('content-area');
+  area.innerHTML = '<div class="loading">搜索中...</div>';
+  try {
+    const r = await fetch('/api/search?q=' + encodeURIComponent(q) + '&cat=' + encodeURIComponent(currentCat));
+    const data = await r.json();
+    if (data.error) { area.innerHTML = '<div class="error">' + escHtml(data.error) + '</div>'; return; }
+    if (!data.results.length) { area.innerHTML = '<div class="empty">未找到相关文档</div>'; return; }
+    let html = '<div class="stats">' + data.results.length + ' 条结果</div>';
+    data.results.forEach(d => {
+      html += `<div class="result-item">
+        ${d.path.startsWith('uploads/') ? `<button class="btn-del" data-del="${escHtml(d.path)}">删除</button>` : ''}
+        <div class="result-title">${escHtml(d.title)}</div>
+        <div class="result-path"><span class="result-cat">${escHtml(d.cat)}</span>${escHtml(d.path)}</div>
+        <div class="result-snippet">${escHtml(d.snippet)}...</div>
+      </div>`;
+    });
+    area.innerHTML = html;
+  } catch (e) { area.innerHTML = '<div class="error">搜索失败: ' + escHtml(e.message) + '</div>'; }
+}
+
+// ---- 分类浏览 ----
+async function filterCat(cat) {
+  currentCat = cat;
+  document.querySelectorAll('.cat-btn').forEach(b => b.classList.toggle('active', b.dataset.cat === cat));
+  const area = $('content-area');
+  area.innerHTML = '<div class="loading">加载中...</div>';
+  try {
+    const r = await fetch('/api/list?cat=' + encodeURIComponent(cat));
+    const data = await r.json();
+    if (data.error) { area.innerHTML = '<div class="error">' + escHtml(data.error) + '</div>'; return; }
+    let html = '<div class="stats">' + data.docs.length + ' 个文档</div>';
+    data.docs.forEach(d => {
+      html += `<div class="result-item">
+        ${d.path.startsWith('uploads/') ? `<button class="btn-del" data-del="${escHtml(d.path)}">删除</button>` : ''}
+        <div class="result-title" style="cursor:pointer" data-doc="${escHtml(d.path)}">${escHtml(d.title)}</div>
+        <div class="result-path"><span class="result-cat">${escHtml(d.cat)}</span>${escHtml(d.path)} (${(d.size/1024).toFixed(1)}KB)</div>
+      </div>`;
+    });
+    area.innerHTML = html;
+  } catch (e) { area.innerHTML = '<div class="error">加载失败</div>'; }
+}
+
+// ---- 文档详情 ----
+async function showDoc(path) {
+  const area = $('content-area');
+  area.innerHTML = '<div class="loading">加载中...</div>';
+  try {
+    const r = await fetch('/api/show?' + new URLSearchParams({ path }));
+    const data = await r.json();
+    if (data.error) { area.innerHTML = '<div class="error">' + escHtml(data.error) + '</div>'; return; }
+    area.innerHTML = `<button class="back-btn" data-back="1">← 返回</button>
+      <div class="result-item">
+        ${data.path.startsWith('uploads/') ? `<button class="btn-del" data-del="${escHtml(data.path)}">删除</button>` : ''}
+        <div class="result-title">${escHtml(data.title)}</div>
+        <div class="result-path"><span class="result-cat">${escHtml(data.cat)}</span>${escHtml(data.path)} (${(data.size/1024).toFixed(1)}KB)</div>
+        <pre>${escHtml(data.body)}</pre>
+      </div>`;
+  } catch (e) { area.innerHTML = '<div class="error">加载失败</div>'; }
+}
+
+async function deleteDoc(path) {
+  if (!confirm('删除 ' + path + ' ?')) return;
+  try {
+    const r = await fetch('/api/delete?path=' + encodeURIComponent(path), { method: 'POST' });
+    const data = await r.json();
+    if (data.error) { toast('删除失败: ' + escHtml(data.error)); return; }
+    toast(`已删除: ${path}（索引 ${data.count} 篇）`);
+    loadCategories();
+    filterCat(currentCat);
+  } catch (e) { toast('删除失败: ' + escHtml(e.message)); }
+}
+
+// ---- 事件委托（避免内联 onclick 与转义问题）----
+document.addEventListener('click', e => {
+  const del = e.target.closest('[data-del]');
+  if (del) { deleteDoc(del.dataset.del); return; }
+  const doc = e.target.closest('[data-doc]');
+  if (doc) { showDoc(doc.dataset.doc); return; }
+  const cat = e.target.closest('[data-cat]');
+  if (cat) { filterCat(cat.dataset.cat); return; }
+  if (e.target.closest('[data-back]')) { filterCat(currentCat); }
+});
+
+loadCategories();
+</script>
+</body>
+</html>
+"""
+
+
+class DocsSearchServer(HTTPServer):
+    # Windows 下 SO_REUSEADDR 允许多进程重复 bind 同一端口，必须禁用
+    allow_reuse_address = sys.platform != "win32"
+
+
+def make_handler(docs_dir, db_path):
+    class Handler(BaseHTTPRequestHandler):
+        def log_message(self, fmt, *args):
+            pass  # 静默访问日志
+
+        # ---------- GET ----------
+        def do_GET(self):
+            parsed = urllib.parse.urlsplit(self.path)
+            if parsed.path in ("/", "/index.html"):
+                self._send(200, "text/html; charset=utf-8", HTML_TEMPLATE.encode("utf-8"))
+            elif parsed.path.startswith("/api/"):
+                self._api_get(parsed.path, urllib.parse.parse_qs(parsed.query))
+            else:
+                self._send(404, "text/plain; charset=utf-8", b"not found")
+
+        def _api_get(self, path, params):
+            if path == "/api/stats":
+                n, _ = ensure_index(docs_dir, db_path)
+                meta = load_meta(db_path)
+                cats = set()
+                try:
+                    c = get_conn(db_path)
+                    for row in c.execute("SELECT DISTINCT cat FROM docs"):
+                        cats.add(row[0])
+                    c.close()
+                except Exception:  # noqa: BLE001, S110 -- 库不可用时分类列表降级为空
+                    pass
+                self._json(200, {"count": n, "updated": meta.get("updated", "?"), "categories": sorted(cats)})
+
+            elif path == "/api/search":
+                q = params.get("q", [""])[0].strip()
+                cat = params.get("cat", [""])[0]
+                if not q:
+                    self._json(200, {"error": "请输入关键词"})
+                    return
+                ensure_index(docs_dir, db_path)
+                c = get_conn(db_path)
+                conditions, pargs = [], []
+                for kw in q.split():
+                    conditions.append("(title LIKE ? OR body LIKE ?)")
+                    pargs.extend([f"%{kw}%", f"%{kw}%"])
+                sql = f"SELECT path, cat, title, body FROM docs WHERE {' AND '.join(conditions)} LIMIT 20"
+                if cat:
+                    sql += " AND cat = ?"
+                    pargs.append(cat)
+                rows = c.execute(sql, pargs).fetchall()
+                c.close()
+                results = [
+                    {"path": p, "cat": c, "title": t, "snippet": b[:150].replace("\n", " ")} for p, c, t, b in rows
+                ]
+                self._json(200, {"results": results})
+
+            elif path == "/api/list":
+                ensure_index(docs_dir, db_path)
+                cat = params.get("cat", [""])[0]
+                c = get_conn(db_path)
+                if cat:
+                    rows = c.execute("SELECT path, title, size FROM docs WHERE cat=? ORDER BY title", (cat,)).fetchall()
+                else:
+                    rows = c.execute("SELECT path, title, size FROM docs ORDER BY cat, title").fetchall()
+                c.close()
+                self._json(200, {"docs": [{"path": r[0], "title": r[1], "size": r[2]} for r in rows]})
+
+            elif path == "/api/show":
+                ensure_index(docs_dir, db_path)
+                p = params.get("path", [""])[0]
+                c = get_conn(db_path)
+                row = c.execute("SELECT title, body, size, cat FROM docs WHERE path=?", (p,)).fetchone()
+                c.close()
+                if not row:
+                    self._json(200, {"error": "文档不存在"})
+                    return
+                self._json(200, {"title": row[0], "body": row[1], "size": row[2], "cat": row[3], "path": p})
+            else:
+                self._send(404, "text/plain; charset=utf-8", b"not found")
+
+        # ---------- POST ----------
+        def do_POST(self):
+            parsed = urllib.parse.urlsplit(self.path)
+            params = urllib.parse.parse_qs(parsed.query)
+            if parsed.path == "/api/upload":
+                self._api_upload(params)
+            elif parsed.path == "/api/delete":
+                self._api_delete(params)
+            else:
+                self._send(404, "text/plain; charset=utf-8", b"not found")
+
+        def _read_body(self):
+            try:
+                length = int(self.headers.get("Content-Length", 0))
+            except ValueError:
+                return None, (411, {"error": "missing Content-Length"})
+            if length <= 0:
+                return None, (400, {"error": "empty body"})
+            if length > MAX_UPLOAD_BYTES:
+                return None, (413, {"error": f"文件过大（上限 {MAX_UPLOAD_BYTES // 1024 // 1024}MB）"})
+            return self.rfile.read(length), None
+
+        def _api_upload(self, params):
+            filename = sanitize_filename(params.get("filename", [""])[0])
+            if not filename:
+                self._json(400, {"error": "文件名非法（仅支持 .md，且不含路径部分）"})
+                return
+            body, err = self._read_body()
+            if err:
+                self._json(err[0], err[1])
+                return
+            try:
+                body.decode("utf-8")
+            except UnicodeDecodeError:
+                self._json(400, {"error": "文件必须是 UTF-8 文本"})
+                return
+            target = dedupe_target(docs_dir, filename)
+            if not target:
+                self._json(500, {"error": "无法分配目标文件名"})
+                return
+            target.write_bytes(body)
+            n, _ = ensure_index(docs_dir, db_path)
+            self._json(200, {"ok": True, "path": f"uploads/{target.name}", "count": n})
+
+        def _api_delete(self, params):
+            rel = params.get("path", [""])[0].replace("\\", "/")
+            uploads_root = (docs_dir / "uploads").resolve()
+            target = (docs_dir / rel).resolve()
+            # 仅允许删除 uploads/ 下的文件，且防路径穿越
+            if uploads_root not in target.parents or target == uploads_root:
+                self._json(403, {"error": "仅允许删除 uploads/ 下的文档"})
+                return
+            if not target.exists():
+                self._json(404, {"error": "文档不存在"})
+                return
+            try:
+                target.unlink()
+            except OSError as e:
+                self._json(500, {"error": f"删除失败: {e}"})
+                return
+            n, _ = ensure_index(docs_dir, db_path)
+            self._json(200, {"ok": True, "deleted": rel, "count": n})
+
+        # ---------- 输出 ----------
+        def _send(self, code, ctype, body):
+            self.send_response(code)
+            self.send_header("Content-Type", ctype)
+            self.send_header("Content-Length", str(len(body)))
+            self.send_header("Access-Control-Allow-Origin", "*")
+            self.end_headers()
+            self.wfile.write(body)
+
+        def _json(self, code, data):
+            self._send(code, "application/json; charset=utf-8", json.dumps(data, ensure_ascii=False).encode("utf-8"))
+
+    return Handler
+
+
+def main():
+    win_utf8()
+    parser = argparse.ArgumentParser(description="docs-search-web: 文档搜索 Web UI（含上传接口）")
+    parser.add_argument("dir", nargs="?", default=None, help="文档根目录（默认 ./docs 或 $DOCS_SEARCH_DIR）")
+    parser.add_argument("--host", default="127.0.0.1", help="监听地址（默认 127.0.0.1，勿暴露公网）")
+    parser.add_argument("--port", "-p", type=int, default=DEFAULT_PORT, help=f"端口（默认 {DEFAULT_PORT}）")
+    parser.add_argument("--no-browser", action="store_true", help="不自动打开浏览器")
+    args = parser.parse_args()
+
+    docs_dir = resolve_docs_dir(args.dir)
+    db_path = resolve_db_path(docs_dir)
+    if not docs_dir.exists():
+        print(f"错误: 文档目录不存在: {docs_dir}")
+        print(f"请指定目录参数，或设置环境变量 {('DOCS_SEARCH_DIR')}")
+        sys.exit(1)
+
+    print(f"文档目录: {docs_dir}")
+    n, updated = ensure_index(docs_dir, db_path)
+    print(f"索引就绪: {n} 个文档{'（已重建）' if updated else ''}")
+
+    server = DocsSearchServer((args.host, args.port), make_handler(docs_dir, db_path))
+    url = f"http://{'127.0.0.1' if args.host in ('0.0.0.0', '') else args.host}:{args.port}"
+    print(f"服务已启动: {url}")
+    print("按 Ctrl+C 停止")
+    if not args.no_browser:
+        import webbrowser
+
+        webbrowser.open(f"http://127.0.0.1:{args.port}")
+    try:
+        server.serve_forever()
+    except KeyboardInterrupt:
+        print("\n已停止")
+        server.shutdown()
+
+
+if __name__ == "__main__":
+    main()

docs_search-1.0.0.dist-info/METADATA

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: docs-search
+Version: 1.0.0
+Summary: Zero-dependency local document search engine — SQLite index, millisecond retrieval, CLI + Web UI with upload
+Author: ninjasin-labs
+License: MIT License
+        
+        Copyright (c) 2026 ninjasin-labs
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/ninjasln-labs/docs-search
+Project-URL: Repository, https://github.com/ninjasln-labs/docs-search
+Project-URL: Issues, https://github.com/ninjasln-labs/docs-search/issues
+Keywords: search,sqlite,markdown,docs,cli
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Text Processing :: Indexing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: test
+Requires-Dist: pytest>=8; extra == "test"
+Requires-Dist: ruff>=0.6; extra == "test"
+Dynamic: license-file
+
+# docs-search
+
+零依赖的本地文档搜索引擎。纯 Python 标准库，SQLite 索引，毫秒级检索。
+
+A zero-dependency local document search engine. Pure Python stdlib, SQLite index, millisecond-level retrieval.
+
+## 特性 / Features
+
+- **零依赖** — 纯 Python 标准库（3.10+），无需 pip install
+- **快** — SQLite FTS 索引，检索 < 50ms
+- **自动索引** — 搜索前自动检测文件变更并增量重建
+- **Web UI** — 内置搜索界面 + 拖拽上传 .md 文档
+- **多库隔离** — 不同文档目录各自独立索引，可并存
+- **不绑定路径** — 文档目录由参数/环境变量指定，不写死任何本地路径
+- **跨平台** — Windows / macOS / Linux
+
+## 快速开始 / Quick Start
+
+```bash
+# 1. 索引一个文档目录（默认 ./docs，也可用 --dir 指定）
+python scripts/docs-search.py index --dir /path/to/your/docs
+
+# 2. 搜索
+python scripts/docs-search.py search "关键词" --dir /path/to/your/docs
+
+# 3. 启动 Web UI（含上传接口）
+python scripts/docs-search-web.py /path/to/your/docs
+# 访问 http://127.0.0.1:8765
+```
+
+## 路径解析规则
+
+| 目标 | 优先级 |
+|------|--------|
+| 文档目录 | `--dir` 参数 > 环境变量 `DOCS_SEARCH_DIR` > `./docs` |
+| 索引库 | `--db` 参数（CLI）> 环境变量 `DOCS_SEARCH_DB` > `~/.docs-search/<目录哈希>/index.db` |
+
+索引库按文档目录哈希隔离——多个文档目录可以各自拥有独立索引，互不干扰。
+
+## CLI
+
+```bash
+python scripts/docs-search.py index    [--dir DIR]   # 重建索引
+python scripts/docs-search.py search "关键词" [--dir DIR] [-n 8]  # 多关键词 AND 搜索
+python scripts/docs-search.py list     [--dir DIR]   # 列出所有文档
+python scripts/docs-search.py show <path> [--dir DIR] # 显示文档内容
+python scripts/docs-search.py status   [--dir DIR]   # 查看索引状态
+python scripts/docs-search.py upload <file.md> [--dir DIR]  # 复制 .md 到文档库 uploads/ 并重建索引
+python scripts/docs-search.py open <path> [--dir DIR]  # 用系统默认程序打开
+```
+
+Windows 下可用 `scripts/docs-search.bat`。
+
+## Web API
+
+启动：`python scripts/docs-search-web.py [DIR] [--port 8765] [--host 127.0.0.1] [--no-browser]`
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| GET  | `/api/stats` | 统计信息 `{count, updated, categories}` |
+| GET  | `/api/search?q=关键词&cat=` | 搜索（多关键词 AND） |
+| GET  | `/api/list?cat=` | 列出文档 |
+| GET  | `/api/show?path=x.md` | 文档内容 |
+| POST | `/api/upload?filename=x.md` | 上传文档（raw body = UTF-8 文本） |
+| POST | `/api/delete?path=uploads/x.md` | 删除 `uploads/` 下已上传文档 |
+
+上传示例：
+
+```bash
+curl -X POST "http://127.0.0.1:8765/api/upload?filename=notes.md" \
+     --data-binary @notes.md
+```
+
+上传的文件存入 `<文档目录>/uploads/` 并自动进入索引；同名自动加 `-1`、`-2` 后缀。
+
+## 安全说明 / Security
+
+- 服务默认仅监听 `127.0.0.1`，**请勿用 `--host 0.0.0.0` 暴露到公网**（接口无鉴权）
+- 上传仅接受 `.md` 文件、单文件 ≤ 10MB、文件名经过消毒（防路径穿越）
+- 删除接口仅允许操作 `uploads/` 目录内的文件
+
+## 开发 / Development
+
+```bash
+pip install -r requirements.lock -e .   # 可编辑安装 + 锁定的开发工具链
+python scripts/verify.py        # 验证链单源：ruff + pytest（单元 + CLI E2E + Web API）
+ruff check src/ tests/ scripts/  # lint
+git config core.hooksPath .githooks  # 启用 pre-commit 验证链
+```
+
+工程结构见 [DEVELOPMENT.md](DEVELOPMENT.md)，贡献规范见 [CONTRIBUTING.md](CONTRIBUTING.md)，AI 协作纪律见 [AGENTS.md](AGENTS.md)。English docs: [README.en.md](README.en.md)
+
+## 许可证 / License
+
+MIT — 见 [LICENSE](LICENSE)

docs_search-1.0.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+docs_search/__init__.py,sha256=jjUNiw2OnZ7tcftThY2zkKHDySipXT7Jh3iJvxTgG6g,477
+docs_search/cli.py,sha256=0pgdZng8ra9fwfiEejA4ETozJWfFQatASOcfiJh8EiU,7470
+docs_search/core.py,sha256=WtTAFsP6rdu6CcduUJ1wbXMUL3py8I9H0FCC34zZL50,7650
+docs_search/web.py,sha256=VPtfXDYqXzTyZoq7pVqnNe-GpOVUiys1MOySiIoFHbg,20921
+docs_search-1.0.0.dist-info/licenses/LICENSE,sha256=jUW20QNnh58muu3QgW63w0OalWUsyHq19pDEiWZU98Q,1070
+docs_search-1.0.0.dist-info/METADATA,sha256=I5fOjSEcI8USDscc9olUDZpe9-e_hIeZSjRIgiutOz4,6282
+docs_search-1.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+docs_search-1.0.0.dist-info/entry_points.txt,sha256=WpDSCPM2Bzi9yhiqeYMZJ_tAnqYURqPhTGyoUUGnvbE,92
+docs_search-1.0.0.dist-info/top_level.txt,sha256=dceiiLHpugfmmczs4wS95Dl1dfq_CAWi7c9q-yezgB0,12
+docs_search-1.0.0.dist-info/RECORD,,

docs_search-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

docs_search-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+docs-search = docs_search.cli:main
+docs-search-web = docs_search.web:main

docs_search-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ninjasin-labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

docs_search-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+docs_search