kbase-cli 0.1.0__py3-none-any.whl

kbase/infra/storage.py

@@ -0,0 +1,17 @@
+import os
+from pathlib import Path
+
+
+def kbase_home() -> Path:
+    home = os.getenv("KBASE_HOME")
+    if home:
+        return Path(home).expanduser()
+    return Path.home() / ".kbase"
+
+
+def config_path() -> Path:
+    return kbase_home() / "config.toml"
+
+
+def kb_dir(name: str) -> Path:
+    return kbase_home() / "kbs" / name

kbase_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: kbase-cli
+Version: 0.1.0
+Summary: A minimal Typer-based CLI for kbase.
+Requires-Python: >=3.10
+Requires-Dist: pydantic
+Requires-Dist: raganything-mineru-cloud==1.2.10.post1
+Requires-Dist: tomli-w>=1.2.0
+Requires-Dist: tomli; python_version < '3.11'
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# kbase
+
+最小可安装的 `Typer` 命令行项目骨架。
+
+## 安装
+
+```bash
+# 方式 1：同步项目依赖（含开发依赖）
+uv sync --extra dev
+
+# 方式 2：可编辑安装
+uv pip install -e ".[dev]"
+```
+
+## 开发
+
+```bash
+uv run pytest tests/test_cli_help.py -q
+```
+
+## 使用
+
+```bash
+kbase --help
+kbase version
+```
+
+## 文档
+
+- `docs/打包与交付（kbase-cli）.md`：打包交付给他人使用的完整流程（含依赖安装、.env、检查点）
+- `docs/发布到PyPI（kbase-cli）.md`：发布到 PyPI 的标准流程（对齐 `scripts/build.*` 与 `scripts/publish_pypi.*`）
+
+## 最小化适配（mineru-cloud 默认）
+
+当前默认解析器为 `mineru-cloud`，保持现有 CLI 体验不变，仍使用：
+
+- `kbase kb create/use/list`
+- `kbase add file/dir`
+- `kbase ask`
+
+### 最小环境变量（推荐）
+
+```bash
+# 必填：MinerU Cloud
+export MINERU_API_TOKEN="your_mineru_token"
+
+# 必填：LLM
+export LLM_API_KEY="your_llm_key"
+export LLM_BASE_URL="https://your-openai-compatible-base-url/v1"
+export LLM_MODEL="gpt-4o-mini"
+export VISION_MODEL="gpt-4o-mini"
+
+# Embedding（默认在线）
+export EMBED_PROVIDER="online"
+export EMBED_MODEL="text-embedding-3-large"
+export EMBED_DIM="3072"
+export EMBED_BASE_URL="$LLM_BASE_URL"
+export EMBED_API_KEY="$LLM_API_KEY"
+```
+
+可选：本地 Ollama `bge-m3`
+
+```bash
+export EMBED_PROVIDER="ollama"
+export EMBED_BASE_URL="http://localhost:11434/v1"
+export EMBED_MODEL="bge-m3"
+export EMBED_DIM="1024"
+export EMBED_API_KEY="ollama"
+```
+
+### 端到端命令示例
+
+```bash
+# 1) 初始化
+uv run kbase init
+
+# 2) 创建并切换知识库
+uv run kbase kb create mykb --use
+
+# 3) 入库目录（支持 pdf/doc/docx/ppt/pptx/图片）
+uv run kbase add dir "/Users/you/Desktop/test-docs" --recursive
+
+# 4) 提问
+uv run kbase ask "请总结这个目录里的核心结论"
+```
+
+## 新增诊断与可观测命令
+
+### 查看生效配置（脱敏）
+
+```bash
+uv run kbase config show
+```
+
+输出会脱敏展示 `LLM_API_KEY` / `MINERU_API_TOKEN` / `EMBED_API_KEY`，用于排查配置是否生效。
+
+### 查看知识库状态（增强）
+
+```bash
+uv run kbase status
+```
+
+`status` 现在会展示：
+
+- `docs`：文档数量
+- `chunks`：总块数
+- `doc_status_success/failed/pending`：处理状态分布
+- `parse_cache_entries`：解析缓存条目
+- `storage_files`：存储文件数
+- `last_updated`：最近更新时间

kbase_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,26 @@
+kbase/__init__.py,sha256=4t_crzhrLum--oyowUMxtjBTzUtWp7oRTF22ewEvJG4,49
+kbase/cli.py,sha256=0GPla3ZUNeJ2PiEEMiHHclQ7b8VFj40e4UE8Lk1o6Ns,826
+kbase/commands/__init__.py,sha256=ecIxnpks6aFqTn9yB7i5J7Jchs2eypW0-LJN4RImidA,78
+kbase/commands/add_cmd.py,sha256=lavtUQEBki3kG9QmijoeQgVZFPU2O7SKdqV8-ClpFXk,3589
+kbase/commands/ask_cmd.py,sha256=-v6AwB4_9YWDAMUN4kgEEXhV3iCDIQXPqaPrlUyBS0U,1978
+kbase/commands/config_cmd.py,sha256=cnBPC6I89FgNi1NE0hq00p4AewNd-czw7Ktv9M53LlY,2287
+kbase/commands/doctor_cmd.py,sha256=X-d9SlQ9LKYYfTEzoVj-Q0NiGpdU9A_eZKNnX6H_Drc,5778
+kbase/commands/init_cmd.py,sha256=9qwHjNRyoQ0MUpSmGXuFqQB2NcQL7QLBzfbSOoCeang,370
+kbase/commands/kb_cmd.py,sha256=qHeyvms556T_gbLE9XDuBkEwizO8vglfRPwEJb18fao,2064
+kbase/commands/status_cmd.py,sha256=BP2RQVy_CMDTU2wLTZXFvy1N0kWhE5WIrYPmY2lkfsk,3609
+kbase/config/__init__.py,sha256=DhEf0ZvcicC3WlU7W6Smocn2YVBV46Rab9EElQIPNXU,125
+kbase/config/loader.py,sha256=1pfK7Q7MG6XJc6lZ2-CelqHsSdy9wa2r-wKdwHb7NIg,1270
+kbase/config/model.py,sha256=MG8m2xSVY9t7AhwoosPKM3YpccspboYK-DOYMWlyNKE,304
+kbase/domain/__init__.py,sha256=f-I8yYOK_P5hEJddDnaWGKyZtCzjBUtwBjEDtZcxeX4,133
+kbase/domain/ingest_service.py,sha256=_PvC6O71ZL3ppPnmCt-p5abNKCtXO6TZC5TYsNOdGGs,921
+kbase/domain/kb_manager.py,sha256=QH1-U3ing5XFu1rJYJYAQTUjNZIQqrLJW0ek2lizpf4,1823
+kbase/domain/kb_validator.py,sha256=-mxx-leaktheBicika17fm8iK17gxyBiVmorZHPMTmw,1009
+kbase/domain/query_service.py,sha256=snihpx4ISMI-5hlo7lW9vIK64hEFKsZTH6yQ6zcivBU,432
+kbase/infra/__init__.py,sha256=ROIqhJZN1uq0sBdhGO-fNn1jGN6aT0tfGEyl7xZ2rbE,115
+kbase/infra/model_builders.py,sha256=tZGvCOVc6BPRbq-dFuV24qe3Hc0PlUGQ9z3zSzg5vbE,5026
+kbase/infra/rag_adapter.py,sha256=oFeUNOIz68tjQ_O7ItQ0JG1YTg2WTuhNX8O8gLYzRiU,16668
+kbase/infra/storage.py,sha256=JTZ_E2lS679OBVit7oL6eaz_rNmMA1BLZKhP8P3pIGw,325
+kbase_cli-0.1.0.dist-info/METADATA,sha256=e7kz9c-lKLTyAtdsOnK3E3iMsfMF3K7e43wjVps5cLs,2807
+kbase_cli-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+kbase_cli-0.1.0.dist-info/entry_points.txt,sha256=SLAXOlxv-W8e7TcslCXgBfAuMcz7lTB1PwN0et4sIUE,40
+kbase_cli-0.1.0.dist-info/RECORD,,

kbase_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

kbase_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+kbase = kbase.cli:app