cnhkmcp 2.1.3__py3-none-any.whl → 2.1.4__py3-none-any.whl

cnhkmcp/untracked/AI/321/206/320/261/320/234/321/211/320/255/320/262/321/206/320/237/320/242/321/204/342/225/227/342/225/242/requirements.txt

@@ -0,0 +1,7 @@
+openai
+Pillow
+fastembed>=0.3.6
+chromadb>=0.5.11
+watchdog
+pypdf
+python-docx

cnhkmcp/untracked/AI/321/206/320/261/320/234/321/211/320/255/320/262/321/206/320/237/320/242/321/204/342/225/227/342/225/242/run.bat

@@ -0,0 +1,3 @@
+@echo off
+python main.py
+pause

cnhkmcp/untracked/AI/321/206/320/261/320/234/321/211/320/255/320/262/321/206/320/237/320/242/321/204/342/225/227/342/225/242/vector_db/_manifest.json

@@ -0,0 +1,302 @@
+{
+  "001_10_Steps_to_Start_on_BRAIN_documentation.json": {
+    "mtime": 1767205657.3113902,
+    "size": 2483
+  },
+  "001_Intermediate_Pack_-_Improve_your_Alpha_2_2_documentation.json": {
+    "mtime": 1767205656.9802248,
+    "size": 9295
+  },
+  "001_Intermediate_Pack_-_Understand_Results_1_2_documentation.json": {
+    "mtime": 1767205656.584933,
+    "size": 9758
+  },
+  "001_Introduction_to_Alphas_documentation.json": {
+    "mtime": 1767205655.9214056,
+    "size": 11156
+  },
+  "001_Introduction_to_BRAIN_Expression_Language_documentation.json": {
+    "mtime": 1767205656.2119222,
+    "size": 4925
+  },
+  "001_WorldQuant_Challenge_documentation.json": {
+    "mtime": 1767205657.651904,
+    "size": 4605
+  },
+  "001__Read_this_First_-_Starter_Pack_documentation.json": {
+    "mtime": 1767205655.607875,
+    "size": 31286
+  },
+  "002_How_to_choose_the_Simulation_Settings_documentation.json": {
+    "mtime": 1767205658.687592,
+    "size": 13775
+  },
+  "002_Simulate_your_first_Alpha_documentation.json": {
+    "mtime": 1767205658.3287065,
+    "size": 8701
+  },
+  "002__Alpha_Examples_for_Beginners_documentation.json": {
+    "mtime": 1767205659.4102447,
+    "size": 10826
+  },
+  "002__Alpha_Examples_for_Bronze_Users_documentation.json": {
+    "mtime": 1767205659.7409737,
+    "size": 4795
+  },
+  "002__Alpha_Examples_for_Silver_Users_documentation.json": {
+    "mtime": 1767205660.0698695,
+    "size": 3854
+  },
+  "002__How_BRAIN_works_documentation.json": {
+    "mtime": 1767205659.0631225,
+    "size": 16929
+  },
+  "003_Clear_these_tests_before_submitting_an_Alpha_documentation.json": {
+    "mtime": 1767205660.7332313,
+    "size": 24609
+  },
+  "003_Parameters_in_the_Simulation_results_documentation.json": {
+    "mtime": 1767205661.1079519,
+    "size": 16168
+  },
+  "004_Group_Data_Fields_documentation.json": {
+    "mtime": 1767205662.790159,
+    "size": 4663
+  },
+  "004_How_to_use_the_Data_Explorer_documentation.json": {
+    "mtime": 1767205662.1967475,
+    "size": 6196
+  },
+  "004_Model77_dataset_documentation.json": {
+    "mtime": 1767205663.0996022,
+    "size": 3274
+  },
+  "004_Sentiment1_dataset_documentation.json": {
+    "mtime": 1767205663.436493,
+    "size": 2058
+  },
+  "004_Understanding_Data_in_BRAIN_Key_Concepts_and_Tips_documentation.json": {
+    "mtime": 1767205661.830939,
+    "size": 9173
+  },
+  "004_Vector_Data_Fields_documentation.json": {
+    "mtime": 1767205662.482697,
+    "size": 6058
+  },
+  "005_Crowding_Risk-Neutralized_Alphas_documentation.json": {
+    "mtime": 1767205666.6135564,
+    "size": 3404
+  },
+  "005_D0_documentation.json": {
+    "mtime": 1767205665.3834035,
+    "size": 5894
+  },
+  "005_Double_Neutralization_documentation.json": {
+    "mtime": 1767205665.0453224,
+    "size": 3308
+  },
+  "005_Fast_D1_Documentation_documentation.json": {
+    "mtime": 1767205668.092214,
+    "size": 11325
+  },
+  "005_Investability_Constrained_Metrics_documentation.json": {
+    "mtime": 1767205667.7071521,
+    "size": 7971
+  },
+  "005_Must-read_posts_How_to_improve_your_Alphas_documentation.json": {
+    "mtime": 1767205664.22182,
+    "size": 2781
+  },
+  "005_Neutralization_documentation.json": {
+    "mtime": 1767205664.6446226,
+    "size": 8962
+  },
+  "005_RAM_Risk-Neutralized_Alphas_documentation.json": {
+    "mtime": 1767205666.9769416,
+    "size": 4121
+  },
+  "005_Risk_Neutralization_Default_setting_documentation.json": {
+    "mtime": 1767205666.256811,
+    "size": 3796
+  },
+  "005_Risk_Neutralized_Alphas_documentation.json": {
+    "mtime": 1767205665.7260354,
+    "size": 11617
+  },
+  "005_Statistical_Risk-Neutralized_Alphas_documentation.json": {
+    "mtime": 1767205667.3264325,
+    "size": 5663
+  },
+  "006_EUR_TOP2500_Universe_documentation.json": {
+    "mtime": 1767205669.7011774,
+    "size": 2248
+  },
+  "006_Getting_Started_China_Research_for_Consultants_Gold_documentation.json": {
+    "mtime": 1767205670.0584345,
+    "size": 8247
+  },
+  "006_Getting_started_on_Illiquid_Universes_Gold_documentation.json": {
+    "mtime": 1767205669.39144,
+    "size": 2224
+  },
+  "006_Getting_started_with_USA_TOPSP500_universe_Gold_documentation.json": {
+    "mtime": 1767205669.0832088,
+    "size": 2681
+  },
+  "006_GLB_TOPDIV3000_Universe_documentation.json": {
+    "mtime": 1767205670.398031,
+    "size": 2990
+  },
+  "006_Global_Alphas_Gold_documentation.json": {
+    "mtime": 1767205668.80443,
+    "size": 5531
+  },
+  "006_India_Alphas_documentation.json": {
+    "mtime": 1767205670.7715836,
+    "size": 1845
+  },
+  "007_Consultant_Dos_and_Don_ts_documentation.json": {
+    "mtime": 1767205676.2029963,
+    "size": 6318
+  },
+  "007_Consultant_Features_documentation.json": {
+    "mtime": 1767205673.3801267,
+    "size": 16785
+  },
+  "007_Consultant_Simulation_Features_documentation.json": {
+    "mtime": 1767205673.0209067,
+    "size": 7226
+  },
+  "007_Consultant_Submission_Tests_documentation.json": {
+    "mtime": 1767205673.745088,
+    "size": 17040
+  },
+  "007_Finding_Consultant_Alphas_documentation.json": {
+    "mtime": 1767205672.251832,
+    "size": 24560
+  },
+  "007_Power_Pool_Alphas_documentation.json": {
+    "mtime": 1767205671.878901,
+    "size": 6398
+  },
+  "007_Research_Advisory_Program_documentation.json": {
+    "mtime": 1767205676.5531626,
+    "size": 2637
+  },
+  "007_Starting_Guide_for_Research_Consultants_documentation.json": {
+    "mtime": 1767205671.4752853,
+    "size": 3245
+  },
+  "007_Visualization_Tool_documentation.json": {
+    "mtime": 1767205674.119551,
+    "size": 5744
+  },
+  "007_Your_Advisor_-_Kunqi_Jiang_documentation.json": {
+    "mtime": 1767205676.9000566,
+    "size": 4746
+  },
+  "007__Brain_Genius_documentation.json": {
+    "mtime": 1767205677.6026185,
+    "size": 16460
+  },
+  "007__Single_Dataset_Alphas_documentation.json": {
+    "mtime": 1767205677.241985,
+    "size": 4113
+  },
+  "008_Advisory_Theme_Calendar_documentation.json": {
+    "mtime": 1767205679.3681905,
+    "size": 584
+  },
+  "008_Multiplier_Rules_documentation.json": {
+    "mtime": 1767205678.6744087,
+    "size": 2178
+  },
+  "008_Overview_of_Themes_documentation.json": {
+    "mtime": 1767205678.3109314,
+    "size": 1784
+  },
+  "008_Theme_Calendar_documentation.json": {
+    "mtime": 1767205679.021326,
+    "size": 8936
+  },
+  "009_Combo_Expression_documentation.json": {
+    "mtime": 1767205681.154851,
+    "size": 10902
+  },
+  "009_Global_SuperAlphas_documentation.json": {
+    "mtime": 1767205682.4950798,
+    "size": 3717
+  },
+  "009_Helpful_Tips_documentation.json": {
+    "mtime": 1767205681.8373532,
+    "size": 3618
+  },
+  "009_Selection_Expression_documentation.json": {
+    "mtime": 1767205680.810195,
+    "size": 47119
+  },
+  "009_SuperAlpha_Operators_documentation.json": {
+    "mtime": 1767205682.1679401,
+    "size": 18735
+  },
+  "009_SuperAlpha_Results_documentation.json": {
+    "mtime": 1767205681.500101,
+    "size": 3838
+  },
+  "009_What_is_a_SuperAlpha_documentation.json": {
+    "mtime": 1767205680.1058033,
+    "size": 13234
+  },
+  "010_BRAIN_API_documentation.json": {
+    "mtime": 1767205683.554062,
+    "size": 36407
+  },
+  "010_Documentation_for_ACE_API_Library_Gold_documentation.json": {
+    "mtime": 1767205683.8682556,
+    "size": 1660
+  },
+  "010__Understanding_simulation_limits_documentation.json": {
+    "mtime": 1767205683.1834643,
+    "size": 12013
+  },
+  "arithmetic_operators.json": {
+    "mtime": 1767205684.2544255,
+    "size": 5302
+  },
+  "cross_sectional_operators.json": {
+    "mtime": 1767205684.2554393,
+    "size": 3393
+  },
+  "group_operators.json": {
+    "mtime": 1767205684.2564406,
+    "size": 4058
+  },
+  "logical_operators.json": {
+    "mtime": 1767205684.2584274,
+    "size": 3549
+  },
+  "reduce_operators.json": {
+    "mtime": 1767205684.2594502,
+    "size": 8602
+  },
+  "special_operators.json": {
+    "mtime": 1767205684.2606597,
+    "size": 891
+  },
+  "test.txt": {
+    "mtime": 1767174050.546388,
+    "size": 82
+  },
+  "time_series_operators.json": {
+    "mtime": 1767205684.2626643,
+    "size": 12968
+  },
+  "transformational_operators.json": {
+    "mtime": 1767205684.2626643,
+    "size": 2080
+  },
+  "vector_operators.json": {
+    "mtime": 1767205684.2636645,
+    "size": 997
+  }
+}

cnhkmcp/untracked/AI/321/206/320/261/320/234/321/211/320/255/320/262/321/206/320/237/320/242/321/204/342/225/227/342/225/242/vector_db/_meta.json

@@ -0,0 +1 @@
+{"model": "jinaai/jina-embeddings-v2-base-zh", "embed_dim": 768, "chroma_version": "1.4.0"}

cnhkmcp/untracked/AI/321/206/320/261/320/234/321/211/320/255/320/262/321/206/320/237/320/242/321/204/342/225/227/342/225/242//321/211/320/266/320/246/321/206/320/274/320/261/321/210/342/224/220/320/240/321/210/320/261/320/234/321/206/320/231/320/243/321/205/342/225/235/320/220/321/206/320/230/320/241.py

@@ -0,0 +1,265 @@
+"""
+首次运行初始化脚本
+- 创建桌面快捷方式指向 main.py，用 Python 运行，图标为 icon.png
+- 检查 knowledge 文件夹文件数量
+- 如果 <= 3，提示用户建立知识库，并自动运行 process_knowledge_base.py
+"""
+
+import os
+import sys
+import subprocess
+import shutil
+import json
+import platform
+import urllib.parse
+import urllib.request
+from pathlib import Path
+
+# 获取脚本所在目录（项目根目录）
+PROJECT_DIR = os.path.dirname(os.path.abspath(__file__))
+MAIN_SCRIPT = os.path.join(PROJECT_DIR, "main.py")
+ICON_ICO = os.path.join(PROJECT_DIR, "icon.ico")
+ICON_PNG = os.path.join(PROJECT_DIR, "icon.png")
+KNOWLEDGE_DIR = os.path.join(PROJECT_DIR, "knowledge")
+PROCESS_SCRIPT = os.path.join(PROJECT_DIR, "process_knowledge_base.py")
+CONFIG_PATH = os.path.join(PROJECT_DIR, "config.json")
+
+
+def load_config():
+    if not os.path.exists(CONFIG_PATH):
+        return {}
+    try:
+        with open(CONFIG_PATH, "r", encoding="utf-8") as f:
+            return json.load(f) or {}
+    except Exception as exc:
+        print(f"✗ 读取 config.json 失败：{exc}")
+        return {}
+
+
+def save_config(cfg):
+    try:
+        with open(CONFIG_PATH, "w", encoding="utf-8") as f:
+            json.dump(cfg, f, ensure_ascii=False, indent=4)
+        print(f"✓ 配置已写入：{CONFIG_PATH}")
+    except Exception as exc:
+        print(f"✗ 写入 config.json 失败：{exc}")
+
+
+def check_network_reachable(url="https://www.google.com/generate_204", timeout_ms=2000):
+    """Check connectivity via ping + lightweight HTTPS GET. Returns True if either succeeds."""
+    parsed = urllib.parse.urlparse(url)
+    host = parsed.hostname or "google.com"
+    is_windows = platform.system().lower().startswith("win")
+    if is_windows:
+        cmd = ["ping", "-n", "1", "-w", str(timeout_ms), host]
+    else:
+        cmd = ["ping", "-c", "1", "-W", str(int(timeout_ms / 1000)), host]
+
+    try:
+        result = subprocess.run(cmd, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+        if result.returncode == 0:
+            return True
+    except Exception as exc:
+        print(f"✗ 无法执行 ping：{exc}")
+
+    # Fallback: HTTPS request (respects proxy envs)
+    try:
+        with urllib.request.urlopen(url, timeout=timeout_ms / 1000.0) as resp:
+            return 200 <= getattr(resp, "status", 200) < 400
+    except Exception as exc:
+        print(f"✗ HTTPS 连通性检测失败：{exc}")
+        return False
+
+
+def prompt_config_if_needed():
+    cfg = load_config()
+
+    defaults = {
+        "base_url": cfg.get("base_url") or "https://api.moonshot.cn/v1",
+        "model": cfg.get("model") or "kimi-latest",
+    }
+
+    if not cfg.get("system_prompt"):
+        cfg["system_prompt"] = (
+            "You are a WorldQuant BRAIN platform expert and Consultant. "
+            "Your goal is to assist users with Alpha development, BRAIN API usage, and maximizing consultant income."
+        )
+
+    def ask(field, label, default_value=None, allow_empty=False):
+        current = str(cfg.get(field, "")).strip()
+        prompt = f"请输入 {label}" + (f" [默认: {current or default_value}]" if (current or default_value) else "") + ": "
+        value = input(prompt).strip()
+        if not value:
+            value = current if current else (default_value if default_value is not None else "")
+        if value or allow_empty:
+            cfg[field] = value
+        return value
+
+    api_key = ask("api_key", "API Key")
+    base_url = ask("base_url", "Base URL", defaults["base_url"], allow_empty=True)
+    model = ask("model", "模型名称", defaults["model"], allow_empty=True)
+
+    if api_key:
+        save_config(cfg)
+        return True
+
+    print("✗ 配置文件中的 api_key 为空，请填写后再运行本脚本。")
+    return False
+
+
+def is_api_key_configured():
+    """Check config; if api_key missing/empty, prompt user to fill and persist."""
+    cfg = load_config()
+
+    api_key = str(cfg.get("api_key", "")).strip()
+    if api_key:
+        return True
+
+    print("✗ 当前 config.json 中 api_key 为空。")
+    return prompt_config_if_needed()
+
+def create_desktop_shortcut():
+    """创建桌面快捷方式"""
+    try:
+        import win32com.client
+        
+        desktop = os.path.expanduser("~\\Desktop")
+        shortcut_path = os.path.join(desktop, "BRAIN顾问助手.lnk")
+        
+        # 获取 Python 可执行文件路径
+        python_exe = sys.executable
+        
+        # 创建 shortcut
+        shell = win32com.client.Dispatch("WScript.Shell")
+        shortcut = shell.CreateShortcut(shortcut_path)
+        shortcut.TargetPath = python_exe
+        shortcut.Arguments = f'"{MAIN_SCRIPT}"'
+        shortcut.WorkingDirectory = PROJECT_DIR
+        
+        # 设置图标：优先使用 .ico（Windows 标准格式），再试 .png
+        icon_found = False
+        if os.path.exists(ICON_ICO):
+            # .ico 文件：使用 "路径,0" 格式
+            shortcut.IconLocation = f"{ICON_ICO},0"
+            icon_found = True
+            print(f"  使用图标：{ICON_ICO}")
+        elif os.path.exists(ICON_PNG):
+            # .png 文件：也需要 "路径,0" 格式
+            shortcut.IconLocation = f"{ICON_PNG},0"
+            icon_found = True
+            print(f"  使用图标：{ICON_PNG}")
+        else:
+            # 使用 Python 可执行文件的图标作为默认
+            shortcut.IconLocation = f"{python_exe},0"
+            print(f"  使用默认图标（Python 图标）")
+        
+        shortcut.Description = "BRAIN 顾问助手 - AI 驱动的交互工具"
+        shortcut.save()
+        
+        print(f"✓ 桌面快捷方式已创建：{shortcut_path}")
+        return True
+    except ImportError:
+        print("⚠ pywin32 未安装，尝试使用备选方案创建快捷方式...")
+        try:
+            # 备选方案：使用 Windows API
+            create_shortcut_via_batch(desktop, shortcut_path, python_exe)
+            return True
+        except Exception as e:
+            print(f"✗ 创建快捷方式失败：{e}")
+            print(f"  请手动创建快捷方式，目标为：{python_exe} \"{MAIN_SCRIPT}\"")
+            return False
+    except Exception as e:
+        print(f"✗ 创建快捷方式失败：{e}")
+        return False
+
+def check_knowledge_base():
+    """检查 knowledge 文件夹中的文件数量"""
+    if not os.path.exists(KNOWLEDGE_DIR):
+        os.makedirs(KNOWLEDGE_DIR)
+        print(f"✓ 创建 knowledge 文件夹：{KNOWLEDGE_DIR}")
+        return 0
+    
+    # 只计算文件，不计算目录
+    files = [f for f in os.listdir(KNOWLEDGE_DIR) if os.path.isfile(os.path.join(KNOWLEDGE_DIR, f))]
+    file_count = len(files)
+    print(f"知识库文件数量：{file_count}")
+    
+    if files:
+        print(f"  已有文件：{', '.join(files)}")
+    
+    return file_count
+
+def run_process_knowledge_base():
+    """运行 process_knowledge_base.py 建立知识库"""
+    if not os.path.exists(PROCESS_SCRIPT):
+        print(f"✗ 找不到 {PROCESS_SCRIPT}")
+        return False
+    
+    print(f"\n正在运行知识库初始化脚本...")
+    print(f"命令：{sys.executable} \"{PROCESS_SCRIPT}\"")
+    
+    try:
+        subprocess.run([sys.executable, PROCESS_SCRIPT], cwd=PROJECT_DIR)
+        print("✓ 知识库初始化完成")
+        return True
+    except Exception as e:
+        print(f"✗ 运行 process_knowledge_base.py 失败：{e}")
+        return False
+
+def main():
+    print("=" * 60)
+    print("BRAIN 顾问助手 - 首次运行初始化")
+    print("=" * 60)
+    print()
+
+    # 0. 检查 api_key 是否已配置，未配置则直接退出
+    if not is_api_key_configured():
+        input("按 Enter 键退出...")
+        return
+
+    # 0.1 检查网络（ping + HTTPS），以确认代理已开启
+    print("[网络检查] 正在测试到 https://www.google.com 的连通性...")
+    if not check_network_reachable("https://www.google.com/generate_204"):
+        print("✗ 无法连通 google.com，请确认代理已开启，然后重新运行本脚本。")
+        input("按 Enter 键退出...")
+        return
+    print("✓ 网络检查通过")
+    
+    # 1. 创建桌面快捷方式
+    print("[1/2] 创建桌面快捷方式...")
+    shortcut_ok = create_desktop_shortcut()
+    print()
+    
+    # 2. 检查知识库
+    print("[2/2] 检查本地知识库...")
+    file_count = check_knowledge_base()
+    print()
+    
+    if file_count <= 3:
+        print("⚠ 知识库文件较少（<= 3 个）")
+        print("建议建立本地知识库以增强 AI 回答效果")
+        print()
+        
+        response = input("是否现在运行知识库初始化脚本？(y/n) [默认: y]: ").strip().lower()
+        if response != 'n':
+            run_process_knowledge_base()
+    else:
+        print(f"✓ 知识库已初始化（包含 {file_count} 个文件）")
+    
+    print()
+    print("=" * 60)
+    print("初始化完成！")
+    print("=" * 60)
+    print()
+    
+    if shortcut_ok:
+        print("📌 你现在可以从桌面快捷方式启动应用")
+        print(f"   或者运行：{sys.executable} \"{MAIN_SCRIPT}\"")
+    else:
+        print(f"请运行：{sys.executable} \"{MAIN_SCRIPT}\"")
+    print()
+    
+    input("按 Enter 键退出...")
+
+if __name__ == "__main__":
+    main()

cnhkmcp/untracked/APP/.gitignore

@@ -0,0 +1,32 @@
+# Custom templates directory (user-specific data)
+custom_templates/
+
+# Python cache
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+*.so
+
+# Virtual environment
+venv/
+env/
+.env
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+# Temporary files
+*.tmp
+*.temp