ops-onehit 1.0.2__py3-none-any.whl

ops_onehit/__init__.py

@@ -0,0 +1,73 @@
+"""ops-onehit · 端到端 AI SRE / Ops Agent.
+
+本包是项目根包。
+子模块:
+    agents  — LangGraph 节点(Phase 2)
+    tools   — 系统工具封装(Phase 2)
+    llm     — LLM 客户端(Ollama / LiteLLM)
+    core    — 配置与基础服务
+    data    — 持久化(SQLite)
+
+T7.5 性能优化: ``__version__`` 直接导出;重模块(rag / multimodal / rbac /
+kg / agent / api)走 :pep:`562` 模块级 ``__getattr__`` lazy import,
+避免 ``import ops_onehit`` 触发 chromadb / sentence-transformers / VLM /
+Whisper / FastAPI 等重依赖。``from ops_onehit.rag import ChromaRAGStore``
+这种子模块访问仍然走正常导入;只有顶层属性才走 lazy 路径。
+"""
+
+from __future__ import annotations
+
+__version__ = "1.0.2"
+
+# T7.5:重模块的 lazy import 映射。
+# ``from ops_onehit import ChromaRAGStore`` 这种顶层属性访问会触发
+# :func:`__getattr__` 并在首次使用时真正 import 对应子模块。后续访问
+# 会命中 ``sys.modules`` 缓存,O(1) 查表无开销。
+_LAZY_EXPORTS: dict[str, str] = {
+    # RAG (T6.5+)
+    "ChromaRAGStore": "ops_onehit.rag.store",
+    "ChromaRAGStoreUnavailable": "ops_onehit.rag.store",
+    "KnowledgeStore": "ops_onehit.rag.store",
+    "InMemoryRAGStore": "ops_onehit.rag.store",
+    "SearchResult": "ops_onehit.rag.store",
+    # Embeddings
+    "MockEmbeddingProvider": "ops_onehit.rag.embeddings",
+    "SentenceTransformerProvider": "ops_onehit.rag.embeddings",
+    "BgeEmbeddingProvider": "ops_onehit.rag.embeddings",
+    # Multimodal (T5.6)
+    "Qwen2VLProcessor": "ops_onehit.multimodal.vlm_real",
+    "FasterWhisperProcessor": "ops_onehit.multimodal.whisper_real",
+    "MultimodalRouter": "ops_onehit.multimodal.router",
+    # KG (T7.2)
+    "KnowledgeGraph": "ops_onehit.kg.graph",
+    # RBAC (T7.4)
+    "UserStore": "ops_onehit.rbac.store",
+    # Agent
+    "ReActAgent": "ops_onehit.agent.react",
+}
+
+
+def __getattr__(name: str) -> object:
+    """PEP 562 lazy attribute access for heavy submodules.
+
+    只有在 ``_LAZY_EXPORTS`` 里的名字才会触发 lazy import;其他属性走
+    Python 默认 ``AttributeError``。这样 ``ops_onehit.__version__`` 等
+    轻量属性仍然 O(1),而重模块按需加载。
+    """
+    module_name = _LAZY_EXPORTS.get(name)
+    if module_name is None:
+        raise AttributeError(f"module 'ops_onehit' has no attribute {name!r}")
+    import importlib
+
+    module = importlib.import_module(module_name)
+    value = getattr(module, name)
+    globals()[name] = value  # cache for subsequent lookups
+    return value
+
+
+def __dir__() -> list[str]:
+    """让 dir(ops_onehit) 能看到 lazy 导出名,IDE 自动补全友好。"""
+    return sorted(set(globals().keys()) | _LAZY_EXPORTS.keys())
+
+
+__all__ = ["__version__", *_LAZY_EXPORTS.keys()]

ops_onehit/__main__.py

@@ -0,0 +1,19 @@
+"""T7.5: ``python -m ops_onehit --help`` 入口。
+
+让 ``python -m ops_onehit`` 和 ``ops-onehit`` 脚本入口行为一致(都调
+:func:`ops_onehit.main.cli_main`)。这个文件是 T7.5 性能优化时新增的,
+T7.3 之前没有 — 当时只有 ``pyproject.toml [project.scripts]`` 的
+``ops-onehit`` 命令,没有 ``-m`` 入口。
+
+冷启动路径:Python 解释器 → ``__main__.py`` 顶层 0 import → 调
+:func:`cli_main` → :func:`main` → lazy import 业务模块。``--help`` 不
+触发任何业务 import,~400ms 完成。
+"""
+
+from __future__ import annotations
+
+from ops_onehit.main import cli_main
+
+if __name__ == "__main__":
+    cli_main()
+    raise SystemExit(0)

ops_onehit/admin/__init__.py

@@ -0,0 +1,27 @@
+"""C2.8 — Admin 控制台服务层 (User / Org / Role / Token / Audit 管理)。
+
+4 维度产品原则(可商业化 / 准确 / 高效 / 交互友好):
+
+- :class:`AdminService` 集中所有 admin 业务逻辑,API / CLI / Vue 共用
+- 全部写操作自动落 :class:`AuditLogger` 留痕(可商业化合规要求)
+- 分页 / 过滤 / 搜索 内置(高效)
+- :class:`AdminError` / :class:`PermissionDeniedError` 提供友好错误信息
+
+模块清单:
+
+- :mod:`ops_onehit.admin.service` — AdminService 业务封装
+- :mod:`ops_onehit.admin.cli`     — ``ops-onehit admin`` 子命令
+- :mod:`ops_onehit.api.admin`     — FastAPI router(15+ 端点)
+"""
+
+from __future__ import annotations
+
+__all__: list[str] = [
+    "AdminError",
+    "AdminService",
+    "DashboardKPI",
+    "NotFoundError",
+    "PermissionDeniedError",
+    "TokenStatus",
+    "ValidationError",
+]