MintOS 0.1.1__py3-none-any.whl

mintos-0.1.1.dist-info/METADATA

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: MintOS
+Version: 0.1.1
+Summary: Mind OS or Money OS
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/tkorays/MOS
+Project-URL: Issues, https://github.com/tkorays/MOS/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: python-dotenv>=1.2.1
+Requires-Dist: loguru
+Requires-Dist: pydantic-settings
+Requires-Dist: pydantic
+Requires-Dist: requests>=2.32.0
+Requires-Dist: click>=8.4.1
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: mcp>=1.28.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+
+# MOS
+
+MOS 是一个基于 Python 的插件化框架，提供核心基础设施和插件管理能力。
+
+## 核心特性
+
+- **插件架构**：基于 Python entry_points 的标准插件机制
+- **依赖隔离**：每个插件独立管理依赖，主仓库只包含核心框架
+- **灵活安装**：插件可通过 pip 安装，支持从 Git、PyPI 或本地安装
+
+## 可用插件
+
+MOS 通过插件扩展功能，目前已有的插件：
+
+| 插件 | 功能 | 安装方式 |
+|------|------|----------|
+| **mos-quant** | 量化交易框架，支持数据采集、回测、实盘交易 | `pip install mos-quant` |
+| **mos-wiki** | 知识库管理系统，支持 Markdown 知识库管理 | `pip install mos-wiki` |
+| **mos-agent** | 智能体系统，支持 LLM Agent 开发 | `pip install mos-agent` |
+
+## 快速开始
+
+```bash
+# 安装核心框架
+pip install mos
+
+# 安装插件（从 GitHub）
+pip install git+https://github.com/yourname/mos_quant.git
+pip install git+https://github.com/yourname/mos_wiki.git
+pip install git+https://github.com/yourname/mos_agent.git
+
+# 查看已加载插件
+mos plugin list
+```

mintos-0.1.1.dist-info/RECORD

@@ -0,0 +1,28 @@
+mos/__init__.py,sha256=qKlfXlBbeex2PhIWuyLo4vst8I-53KBCWXAjXnkOq9w,39
+mos/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mos/cli/config.py,sha256=McS6hdiRLGKl9d86YtLGblND1b1d9vGdfPBRhvzDnN8,7149
+mos/cli/init.py,sha256=cKaTjfIhobiWLyGucdVCzj0ZmsJhsQ1VRgPRA6Me0WY,6652
+mos/cli/mcp.py,sha256=Jq-KUy01pBz2itynmqp7bh33TNJg5RXBAcXCeyr85S4,271
+mos/cli/mos.py,sha256=HRFVReZSrOTRGy_-4tYjMJaX0YJAdhiSS3KMD0anI34,1171
+mos/cli/plugin.py,sha256=7w0ygOduG_Hjx0bB2wtYRs5vywiR5Yy_pqt6Ae7yDBk,4066
+mos/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mos/core/baseconfig.py,sha256=2O8IfPsexoyq9OZDMzn6C_0d_xQMxShk9bsmOJRbrhA,7477
+mos/core/config.py,sha256=oTwl7vqkVTXzyHvhkmvYANk72ehpY0GI7jADc3Kr_Go,4302
+mos/core/logging.py,sha256=VIU1OoG4q_3Rsffz_mAjuE8jKHlABMEcR02o2i719MU,1231
+mos/core/mcp.py,sha256=2KXhUHchw5CyBS119NETvkWc6EKLkdMpZv-nV9-meps,89
+mos/core/plugin.py,sha256=GcL7BgFwLFFVAhgIcdoHkC0D4SVMK4QvOex9aPhnPBA,28457
+mos/core/resource.py,sha256=rQwQ5gFdPLuHNV_aPEjhWqKdcWyjjsU-oDc5Jr6ecRo,1117
+mos/core/dataflow/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mos/core/dataflow/flat_json_model.py,sha256=Wga71tEu3Uk1gAcRxIeB2Hp3v9NyUj0jqSbyv6z-fts,5512
+mos/core/dataflow/types.py,sha256=Dyr91NzxOSCjKaVjgFoNyQEWp10952ecTMDa7Leq6Og,3123
+mos/core/grafana/__init__.py,sha256=5VsssC6P27gEK7eUTDOUBUV6lVCZct5T6BidAglKLHs,850
+mos/core/grafana/manage.py,sha256=jSNQrjZZOeP-5A4Ai13bt-lPrE43jJXP938ZtCa8vFo,15497
+mos/core/influxdb/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mos/core/influxdb/v3.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mos/core/llm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mos/core/llm/openai_compatible_api.py,sha256=QkH54H4GxD3E7S6Q3SVHGP9jkZTmCXxJHUgJedud07g,18689
+mintos-0.1.1.dist-info/METADATA,sha256=dV1k3E8nr7oCeRVgHyhduzHzJpoh6NZL7ucO_Y7KWgo,1862
+mintos-0.1.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+mintos-0.1.1.dist-info/entry_points.txt,sha256=m13wVRUum4BygNy_kmo4wm_IVGlpAb1R7lQTvU5buyg,40
+mintos-0.1.1.dist-info/top_level.txt,sha256=yHW4Fvt1SB0qOfsMARJMTbafOyckDeaxTpCNRLIGA4k,4
+mintos-0.1.1.dist-info/RECORD,,

mintos-0.1.1.dist-info/WHEEL

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

mintos-0.1.1.dist-info/entry_points.txt

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

mintos-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+mos

mos/__init__.py

@@ -0,0 +1,3 @@
+"""MintOS"""
+
+__version__ = "0.1.1"

mos/cli/config.py

@@ -0,0 +1,222 @@
+import json
+from typing import Any, Callable
+
+import click
+from pydantic import ValidationError
+
+from mos.core.config import get_config, reload_config
+from mos.core.plugin import get_registry
+from mos.core.logging import get_logger
+
+logger = get_logger(__name__)
+
+
+@click.group()
+def config():
+    """配置管理命令"""
+    pass
+
+
+def _get_config_funcs(config_type: str) -> tuple[Callable, Callable]:
+    """根据配置类型获取对应的配置管理函数
+
+    Args:
+        config_type: 配置类型，'main' 表示主配置，其他为插件名称
+
+    Returns:
+        (get_config_func, reload_config_func)
+    """
+    if config_type == "main":
+        return get_config, reload_config
+
+    registry = get_registry()
+    get_func = registry.get_config_func(config_type)
+    reload_func = registry.get_reload_func(config_type)
+
+    if get_func is None or reload_func is None:
+        raise click.ClickException(f"未知的配置类型: '{config_type}'。可用类型: main, {', '.join(registry.list_names())}")
+
+    return get_func, reload_func
+
+
+def _format_value(value):
+    """格式化配置值为可读字符串"""
+    value_type = type(value)
+
+    if value_type is bool:
+        return "true" if value else "false"
+    elif value_type in (list, tuple):
+        return ", ".join(str(item) for item in value)
+    else:
+        return str(value)
+
+
+def _print_config_tree(data, prefix=""):
+    """递归打印配置树"""
+    data_type = type(data)
+
+    if data_type is not dict:
+        click.echo(f"{prefix}{data}")
+        return
+
+    for key, value in data.items():
+        value_type = type(value)
+
+        if value is None:
+            click.echo(f"{prefix}{key}: null")
+        elif value_type is dict:
+            click.echo(f"{prefix}{key}:")
+            _print_config_tree(value, prefix + "  ")
+        else:
+            display_value = _format_value(value)
+            click.echo(f"{prefix}{key}: {display_value}")
+
+
+def _coerce_cli_value(value: str) -> Any:
+    """根据 CLI 字符串字面量推断 Python 标量（true/false/int/float/JSON/str）。"""
+    if value.startswith("~"):
+        return value
+    lowered = value.lower()
+    if lowered == "true":
+        return True
+    if lowered == "false":
+        return False
+    if value.isdigit():
+        return int(value)
+    try:
+        return float(value)
+    except ValueError:
+        if value.startswith("[") or value.startswith("{"):
+            return json.loads(value)
+        return value
+
+
+@click.command()
+@click.option('--type', 'config_type', default='main', help='配置类型：main(主配置) 或插件名称(如 quant, wiki)')
+def list(config_type: str):
+    """列出所有配置项
+
+    示例:
+      mos config list                    # 列出主配置
+      mos config list --type quant       # 列出 quant 插件配置
+      mos config list --type wiki        # 列出 wiki 插件配置
+    """
+    try:
+        get_config_func, _ = _get_config_funcs(config_type)
+        config_obj = get_config_func()
+        config_dict = config_obj.model_dump()
+        config_file = config_obj.config_file_path
+
+        click.echo(f"当前配置 ({config_type}):\n")
+        click.echo(f"配置文件: {config_file}")
+        click.echo(f"配置文件存在: {config_file.exists()}")
+        click.echo()
+
+        _print_config_tree(config_dict)
+
+        click.echo()
+        click.echo("提示: 使用 'mos config set <key> <value> --type <type>' 修改配置")
+
+    except Exception as e:
+        logger.error(f"列出配置失败: {e}")
+        raise click.ClickException(f"列出配置失败: {e}")
+
+
+@click.command()
+@click.argument("key")
+@click.argument("value")
+@click.option('--type', 'config_type', default='main', help='配置类型：main(主配置) 或插件名称(如 quant, wiki)')
+def set(key, value, config_type: str):
+    """设置配置项
+
+    示例:
+      mos config set log.level DEBUG
+      mos config set debug true --type main
+      mos config set database.path ~/.mos/custom_data/ --type quant
+      mos config set mini_qmt.path D:\\QMT --type quant
+    """
+    try:
+        get_config_func, reload_config_func = _get_config_funcs(config_type)
+        keys = key.split(".")
+        if not keys or not all(keys):
+            raise click.ClickException(f"无效的 key: {key!r}")
+
+        # 用当前 Config 作为基线，把 CLI 改的字段 deep-merge 进去。
+        # pydantic 在 model_validate 阶段会做类型转换（str→int/bool/...）。
+        current = get_config_func()
+        override: dict[str, Any] = {}
+        cursor: dict[str, Any] = override
+        for k in keys[:-1]:
+            cursor[k] = {}
+            cursor = cursor[k]
+        cursor[keys[-1]] = _coerce_cli_value(value)
+
+        try:
+            new_cfg = current.update(**override)
+        except ValidationError as e:
+            raise click.ClickException(f"配置项 {key!r} 校验失败: {e}")
+
+        target = new_cfg.save()
+        reload_config_func()
+
+        click.echo(f"[OK] 已设置 {config_type}.{key} = {value}")
+        click.echo(f"  配置文件: {target}")
+        click.echo()
+        click.echo("提示: 某些配置可能需要重启应用才能生效")
+
+    except click.ClickException:
+        raise
+    except Exception as e:
+        logger.error(f"设置配置失败: {e}")
+        raise click.ClickException(f"设置配置失败: {e}")
+
+
+@click.command()
+@click.argument("key")
+@click.option('--type', 'config_type', default='main', help='配置类型：main(主配置) 或插件名称(如 quant, wiki)')
+def get(key, config_type: str):
+    """获取指定配置项的值
+
+    示例:
+      mos config get log.level
+      mos config get debug --type main
+      mos config get database.path --type quant
+    """
+    try:
+        get_config_func, _ = _get_config_funcs(config_type)
+        config_obj = get_config_func()
+        value = config_obj.get(*key.split("."))
+
+        if value is None:
+            click.echo(f"配置项 '{config_type}.{key}' 不存在")
+            return
+
+        click.echo(f"{config_type}.{key} = {value}")
+
+    except Exception as e:
+        logger.error(f"获取配置失败: {e}")
+        raise click.ClickException(f"获取配置失败: {e}")
+
+
+@click.command()
+@click.option('--type', 'config_type', default='main', help='配置类型：main(主配置) 或插件名称(如 quant, wiki)')
+def types(config_type: str):
+    """列出所有可用的配置类型"""
+    registry = get_registry()
+    plugin_names = registry.list_names()
+
+    click.echo("可用的配置类型:")
+    click.echo("  main - MOS 主配置 (log, llm, debug)")
+    for name in plugin_names:
+        click.echo(f"  {name} - {name} 插件配置")
+
+    click.echo()
+    click.echo("示例:")
+    click.echo("  mos config list --type main")
+    click.echo("  mos config list --type quant")
+
+
+config.add_command(list)
+config.add_command(set)
+config.add_command(get)
+config.add_command(types)

mos/cli/init.py

@@ -0,0 +1,229 @@
+import click
+from pathlib import Path
+import json
+from typing import Optional
+from mos.core.config import get_config
+from mos.core.logging import get_logger
+from mos.core.plugin import get_registry
+
+logger = get_logger(__name__)
+
+
+def _get_mos_dir():
+    """获取 MOS 根目录"""
+    return Path.home() / ".mos"
+
+
+def _init_config_file(force=False):
+    """初始化配置文件"""
+    config_file = _get_mos_dir() / "config.json"
+
+    if config_file.exists():
+        if force:
+            config_file.unlink()
+            click.echo(f"  ⚠ 已删除旧配置文件: {config_file}")
+        else:
+            click.echo(f"  [OK] 配置文件已存在: {config_file}")
+            return False
+
+    config = get_config()
+    config_dict = config.model_dump()
+
+    config_file.parent.mkdir(parents=True, exist_ok=True)
+    with open(config_file, 'w', encoding='utf-8') as f:
+        json.dump(config_dict, f, indent=2, ensure_ascii=False)
+
+    click.echo(f"  [OK] 已创建配置文件: {config_file}")
+    return True
+
+
+def _init_log_dir():
+    """初始化日志目录"""
+    log_dir = _get_mos_dir() / "logs"
+
+    if log_dir.exists():
+        click.echo(f"  [OK] 日志目录已存在: {log_dir}")
+        return False
+
+    log_dir.mkdir(parents=True, exist_ok=True)
+    click.echo(f"  [OK] 已创建日志目录: {log_dir}")
+    return True
+
+
+def _init_cache_dir():
+    """初始化缓存目录"""
+    cache_dir = _get_mos_dir() / "cache"
+
+    if cache_dir.exists():
+        click.echo(f"  [OK] 缓存目录已存在: {cache_dir}")
+        return False
+
+    cache_dir.mkdir(parents=True, exist_ok=True)
+    click.echo(f"  [OK] 已创建缓存目录: {cache_dir}")
+    return True
+
+
+def _init_plugin_dir():
+    """初始化插件目录。
+
+    使用 ``Config.plugin.plugin_path`` 作为根目录；首次安装的
+    external 插件（通过 ``mos plugin install``）会被 ``git clone``
+    到该目录下。
+    """
+    config = get_config()
+    plugin_dir = Path(config.plugin.get_expanded_path())
+
+    if plugin_dir.exists():
+        click.echo(f"  [OK] 插件目录已存在: {plugin_dir}")
+        return False
+
+    plugin_dir.mkdir(parents=True, exist_ok=True)
+    click.echo(f"  [OK] 已创建插件目录: {plugin_dir}")
+    return True
+
+
+def _init_core(force=False):
+    """初始化 MOS 核心框架。"""
+    click.echo()
+    click.echo("=" * 60)
+    click.echo("MOS 核心框架初始化")
+    click.echo("=" * 60)
+    click.echo()
+
+    mos_dir = _get_mos_dir()
+    click.echo(f"MOS 根目录: {mos_dir}")
+    click.echo()
+
+    if not mos_dir.exists():
+        click.echo("创建 MOS 根目录...")
+        mos_dir.mkdir(parents=True, exist_ok=True)
+        click.echo(f"  [OK] 已创建: {mos_dir}")
+    else:
+        click.echo(f"  [OK] MOS 根目录已存在: {mos_dir}")
+
+    click.echo()
+    click.echo("初始化配置文件...")
+    _init_config_file(force)
+
+    click.echo()
+    click.echo("初始化日志目录...")
+    _init_log_dir()
+
+    click.echo()
+    click.echo("初始化缓存目录...")
+    _init_cache_dir()
+
+    click.echo()
+    click.echo("初始化插件目录...")
+    _init_plugin_dir()
+
+
+def _init_plugin(plugin_name: str, force: bool = False):
+    """初始化单个插件。"""
+    registry = get_registry()
+    plugin = registry.get(plugin_name)
+
+    if plugin is None:
+        click.echo(f"  [ERROR] 插件 '{plugin_name}' 未加载或未安装")
+        return False
+
+    if plugin.init is None:
+        click.echo(f"  [SKIP] 插件 '{plugin_name}' 没有初始化函数")
+        return False
+
+    click.echo()
+    click.echo("=" * 60)
+    click.echo(f"初始化插件: {plugin_name}")
+    click.echo("=" * 60)
+    click.echo()
+
+    try:
+        plugin.init(force)
+        click.echo()
+        click.echo(f"[OK] 插件 '{plugin_name}' 初始化完成")
+        return True
+    except Exception as e:
+        logger.error(f"Plugin {plugin_name} init failed: {e}")
+        click.echo(f"  [ERROR] 插件 '{plugin_name}' 初始化失败: {e}")
+        return False
+
+
+def _init_all_plugins(force: bool = False):
+    """初始化所有已加载的插件。"""
+    registry = get_registry()
+    plugins = registry.all()
+
+    if not plugins:
+        click.echo("  [INFO] 没有已加载的插件")
+        return
+
+    click.echo()
+    click.echo("=" * 60)
+    click.echo("初始化所有插件")
+    click.echo("=" * 60)
+    click.echo()
+
+    initialized_count = 0
+    skipped_count = 0
+
+    for plugin in plugins:
+        if plugin.init is None:
+            click.echo(f"  [SKIP] 插件 '{plugin.name}' 没有初始化函数")
+            skipped_count += 1
+            continue
+
+        click.echo(f"初始化插件: {plugin.name}")
+        try:
+            plugin.init(force)
+            click.echo(f"  [OK] 插件 '{plugin.name}' 初始化完成")
+            initialized_count += 1
+        except Exception as e:
+            logger.error(f"Plugin {plugin.name} init failed: {e}")
+            click.echo(f"  [ERROR] 插件 '{plugin.name}' 初始化失败: {e}")
+
+    click.echo()
+    click.echo(f"初始化完成: {initialized_count} 个插件, {skipped_count} 个跳过")
+
+
+@click.command()
+@click.option('--force', '-f', is_flag=True, help='强制重新初始化（覆盖现有配置）')
+@click.option('--plugin', '-p', 'plugin_name', help='初始化指定插件')
+@click.option('--all', 'init_all', is_flag=True, help='初始化所有已加载的插件')
+def init(force: bool, plugin_name: Optional[str], init_all: bool):
+    """初始化 MOS 配置和环境
+
+    首次使用或重新配置时运行此命令。
+    将创建必要的配置文件和目录结构。
+
+    使用方式：
+        mos init              # 初始化核心框架
+        mos init -p quant     # 初始化 quant 插件
+        mos init --all        # 初始化所有插件
+        mos init -f           # 强制重新初始化
+    """
+    # 如果指定了插件，只初始化插件
+    if plugin_name:
+        _init_plugin(plugin_name, force)
+        return
+
+    # 如果指定了 --all，初始化所有插件
+    if init_all:
+        _init_core(force)
+        _init_all_plugins(force)
+        return
+
+    # 默认只初始化核心框架
+    _init_core(force)
+
+    click.echo()
+    click.echo("=" * 60)
+    click.echo("[OK] 初始化完成！")
+    click.echo("=" * 60)
+    click.echo()
+    click.echo("接下来你可以：")
+    click.echo("  1. 使用 'mos config list' 查看配置")
+    click.echo("  2. 使用 'mos config set <key> <value>' 修改配置")
+    click.echo("  3. 使用 'mos init -p <plugin>' 初始化插件")
+    click.echo()
+    click.echo("更多信息请参考项目文档")
+    click.echo()

mos/cli/mcp.py

@@ -0,0 +1,13 @@
+import click
+from mos.core.logging import get_logger
+
+logger = get_logger(__name__)
+
+@click.command()
+def mcp():
+    """
+    MCP命令
+    """
+    from mos.core.mcp import mcp
+    logger.info("MCP server running...")
+    mcp.run(transport="streamable-http")

mos/cli/mos.py

@@ -0,0 +1,43 @@
+import click
+
+from mos.core.logging import setup_logging
+from mos.core.config import get_config
+from mos.core.plugin import load_entry_point_plugins
+from mos.cli.config import config
+from mos.cli.init import init
+from mos.cli.plugin import plugin as plugin_cmd
+from mos.cli.mcp import mcp
+
+
+@click.group()
+@click.version_option()
+def cli():
+    setup_logging()
+
+
+cli.add_command(config)
+cli.add_command(init)
+cli.add_command(plugin_cmd)
+cli.add_command(mcp)
+
+
+cfg = get_config()
+disabled_plugins = list(cfg.plugin.disabled_plugins)
+
+# Load all plugins via entry_points (pip-installed packages)
+ep_results = load_entry_point_plugins(disabled_plugins)
+for r in ep_results:
+    if r.status == "loaded" and r.definition is not None:
+        cmd = r.definition.command
+        if cmd.name and cmd.name not in cli.commands:
+            cli.add_command(cmd)
+        if r.name != cmd.name and r.name not in cli.commands:
+            cli.add_command(cmd, name=r.name)
+        # Register MCP tools if plugin supports it
+        if r.definition.register_mcp:
+            from mos.core.mcp import mcp
+            r.definition.register_mcp(mcp)
+
+
+if __name__ == "__main__":
+    cli()