cnhkmcp 2.0.4__py3-none-any.whl → 2.1.1__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/vector_db/_manifest.json

@@ -0,0 +1,326 @@
+{
+  "001_10_Steps_to_Start_on_BRAIN_documentation.json": {
+    "mtime": 1767187226.1783848,
+    "size": 2483
+  },
+  "001_Intermediate_Pack_-_Improve_your_Alpha_2_2_documentation.json": {
+    "mtime": 1767187225.6750722,
+    "size": 9295
+  },
+  "001_Intermediate_Pack_-_Understand_Results_1_2_documentation.json": {
+    "mtime": 1767187225.1160033,
+    "size": 9758
+  },
+  "001_Introduction_to_Alphas_documentation.json": {
+    "mtime": 1767187223.7560995,
+    "size": 11156
+  },
+  "001_Introduction_to_BRAIN_Expression_Language_documentation.json": {
+    "mtime": 1767187224.277528,
+    "size": 4925
+  },
+  "001_WorldQuant_Challenge_documentation.json": {
+    "mtime": 1767187226.6850047,
+    "size": 4605
+  },
+  "001__Read_this_First_-_Starter_Pack_documentation.json": {
+    "mtime": 1767187223.2536645,
+    "size": 31286
+  },
+  "002_How_to_choose_the_Simulation_Settings_documentation.json": {
+    "mtime": 1767187228.2257776,
+    "size": 13775
+  },
+  "002_Simulate_your_first_Alpha_documentation.json": {
+    "mtime": 1767187227.7143147,
+    "size": 8701
+  },
+  "002__Alpha_Examples_for_Beginners_documentation.json": {
+    "mtime": 1767187229.1900375,
+    "size": 10826
+  },
+  "002__Alpha_Examples_for_Bronze_Users_documentation.json": {
+    "mtime": 1767187229.664476,
+    "size": 4795
+  },
+  "002__Alpha_Examples_for_Silver_Users_documentation.json": {
+    "mtime": 1767187230.1425803,
+    "size": 3854
+  },
+  "002__How_BRAIN_works_documentation.json": {
+    "mtime": 1767187228.7194252,
+    "size": 16929
+  },
+  "003_Clear_these_tests_before_submitting_an_Alpha_documentation.json": {
+    "mtime": 1767187231.1392078,
+    "size": 24609
+  },
+  "003_Parameters_in_the_Simulation_results_documentation.json": {
+    "mtime": 1767187231.8167577,
+    "size": 16168
+  },
+  "004_Group_Data_Fields_documentation.json": {
+    "mtime": 1767187234.323853,
+    "size": 4663
+  },
+  "004_How_to_use_the_Data_Explorer_documentation.json": {
+    "mtime": 1767187233.2908292,
+    "size": 6196
+  },
+  "004_Model77_dataset_documentation.json": {
+    "mtime": 1767187234.7999012,
+    "size": 3274
+  },
+  "004_Sentiment1_dataset_documentation.json": {
+    "mtime": 1767187235.2783144,
+    "size": 2058
+  },
+  "004_Understanding_Data_in_BRAIN_Key_Concepts_and_Tips_documentation.json": {
+    "mtime": 1767187232.782544,
+    "size": 9173
+  },
+  "004_Vector_Data_Fields_documentation.json": {
+    "mtime": 1767187233.8419762,
+    "size": 6058
+  },
+  "005_Crowding_Risk-Neutralized_Alphas_documentation.json": {
+    "mtime": 1767187239.4696057,
+    "size": 3404
+  },
+  "005_D0_documentation.json": {
+    "mtime": 1767187237.8772166,
+    "size": 5894
+  },
+  "005_Double_Neutralization_documentation.json": {
+    "mtime": 1767187237.2801647,
+    "size": 3308
+  },
+  "005_Fast_D1_Documentation_documentation.json": {
+    "mtime": 1767187244.849411,
+    "size": 11325
+  },
+  "005_Investability_Constrained_Metrics_documentation.json": {
+    "mtime": 1767187244.361986,
+    "size": 7971
+  },
+  "005_Must-read_posts_How_to_improve_your_Alphas_documentation.json": {
+    "mtime": 1767187236.2457168,
+    "size": 2781
+  },
+  "005_Neutralization_documentation.json": {
+    "mtime": 1767187236.7823203,
+    "size": 8962
+  },
+  "005_RAM_Risk-Neutralized_Alphas_documentation.json": {
+    "mtime": 1767187240.0576506,
+    "size": 4121
+  },
+  "005_Risk_Neutralization_Default_setting_documentation.json": {
+    "mtime": 1767187238.9658227,
+    "size": 3796
+  },
+  "005_Risk_Neutralized_Alphas_documentation.json": {
+    "mtime": 1767187238.4253874,
+    "size": 11617
+  },
+  "005_Statistical_Risk-Neutralized_Alphas_documentation.json": {
+    "mtime": 1767187240.5924916,
+    "size": 5663
+  },
+  "006_EUR_TOP2500_Universe_documentation.json": {
+    "mtime": 1767187247.5703416,
+    "size": 2248
+  },
+  "006_Getting_Started_China_Research_for_Consultants_Gold_documentation.json": {
+    "mtime": 1767187248.0169055,
+    "size": 8247
+  },
+  "006_Getting_started_on_Illiquid_Universes_Gold_documentation.json": {
+    "mtime": 1767187247.1297894,
+    "size": 2224
+  },
+  "006_Getting_started_with_USA_TOPSP500_universe_Gold_documentation.json": {
+    "mtime": 1767187246.6729863,
+    "size": 2681
+  },
+  "006_GLB_TOPDIV3000_Universe_documentation.json": {
+    "mtime": 1767187248.4504318,
+    "size": 2990
+  },
+  "006_Global_Alphas_Gold_documentation.json": {
+    "mtime": 1767187246.0390387,
+    "size": 5531
+  },
+  "006_India_Alphas_documentation.json": {
+    "mtime": 1767187248.8769279,
+    "size": 1845
+  },
+  "007_Consultant_Dos_and_Don_ts_documentation.json": {
+    "mtime": 1767187252.9861574,
+    "size": 6318
+  },
+  "007_Consultant_Features_documentation.json": {
+    "mtime": 1767187251.6508195,
+    "size": 16785
+  },
+  "007_Consultant_Simulation_Features_documentation.json": {
+    "mtime": 1767187251.177272,
+    "size": 7226
+  },
+  "007_Consultant_Submission_Tests_documentation.json": {
+    "mtime": 1767187252.1096609,
+    "size": 17040
+  },
+  "007_Finding_Consultant_Alphas_documentation.json": {
+    "mtime": 1767187250.6579707,
+    "size": 24560
+  },
+  "007_Power_Pool_Alphas_documentation.json": {
+    "mtime": 1767187250.1653683,
+    "size": 6398
+  },
+  "007_Research_Advisory_Program_documentation.json": {
+    "mtime": 1767187253.4177225,
+    "size": 2637
+  },
+  "007_Starting_Guide_for_Research_Consultants_documentation.json": {
+    "mtime": 1767187249.7283993,
+    "size": 3245
+  },
+  "007_Visualization_Tool_documentation.json": {
+    "mtime": 1767187252.5484178,
+    "size": 5744
+  },
+  "007_Your_Advisor_-_Kunqi_Jiang_documentation.json": {
+    "mtime": 1767187253.8533716,
+    "size": 4746
+  },
+  "007__Brain_Genius_documentation.json": {
+    "mtime": 1767187257.3133671,
+    "size": 16460
+  },
+  "007__Single_Dataset_Alphas_documentation.json": {
+    "mtime": 1767187256.8453045,
+    "size": 4113
+  },
+  "008_Advisory_Theme_Calendar_documentation.json": {
+    "mtime": 1767187259.502196,
+    "size": 584
+  },
+  "008_Multiplier_Rules_documentation.json": {
+    "mtime": 1767187258.6333888,
+    "size": 2178
+  },
+  "008_Overview_of_Themes_documentation.json": {
+    "mtime": 1767187258.1852746,
+    "size": 1784
+  },
+  "008_Theme_Calendar_documentation.json": {
+    "mtime": 1767187259.0729353,
+    "size": 8936
+  },
+  "009_Combo_Expression_documentation.json": {
+    "mtime": 1767187261.4117863,
+    "size": 10902
+  },
+  "009_Global_SuperAlphas_documentation.json": {
+    "mtime": 1767187263.181562,
+    "size": 3717
+  },
+  "009_Helpful_Tips_documentation.json": {
+    "mtime": 1767187262.3033876,
+    "size": 3618
+  },
+  "009_Selection_Expression_documentation.json": {
+    "mtime": 1767187260.918844,
+    "size": 47119
+  },
+  "009_SuperAlpha_Operators_documentation.json": {
+    "mtime": 1767187262.748049,
+    "size": 18735
+  },
+  "009_SuperAlpha_Results_documentation.json": {
+    "mtime": 1767187261.8593862,
+    "size": 3838
+  },
+  "009_What_is_a_SuperAlpha_documentation.json": {
+    "mtime": 1767187260.3861206,
+    "size": 13234
+  },
+  "010_BRAIN_API_documentation.json": {
+    "mtime": 1767187264.5490012,
+    "size": 36407
+  },
+  "010_Documentation_for_ACE_API_Library_Gold_documentation.json": {
+    "mtime": 1767187264.9810457,
+    "size": 1660
+  },
+  "010__Understanding_simulation_limits_documentation.json": {
+    "mtime": 1767187264.0576608,
+    "size": 12013
+  },
+  "arithmetic_operators.json": {
+    "mtime": 1767187265.4527013,
+    "size": 5302
+  },
+  "asi_datasets.json": {
+    "mtime": 1767187329.8343418,
+    "size": 241709
+  },
+  "chn_datasets.json": {
+    "mtime": 1767187329.8464715,
+    "size": 112139
+  },
+  "cross_sectional_operators.json": {
+    "mtime": 1767187265.454866,
+    "size": 3393
+  },
+  "eur_datasets.json": {
+    "mtime": 1767187329.8725038,
+    "size": 268981
+  },
+  "glb_datasets.json": {
+    "mtime": 1767187329.8975177,
+    "size": 222049
+  },
+  "group_operators.json": {
+    "mtime": 1767187265.4558804,
+    "size": 4058
+  },
+  "ind_datasets.json": {
+    "mtime": 1767187329.930282,
+    "size": 259819
+  },
+  "logical_operators.json": {
+    "mtime": 1767187265.4568646,
+    "size": 3549
+  },
+  "reduce_operators.json": {
+    "mtime": 1767187265.4588814,
+    "size": 8602
+  },
+  "special_operators.json": {
+    "mtime": 1767188164.9683514,
+    "size": 893
+  },
+  "test.txt": {
+    "mtime": 1767174050.546388,
+    "size": 82
+  },
+  "time_series_operators.json": {
+    "mtime": 1767187265.4623148,
+    "size": 12968
+  },
+  "transformational_operators.json": {
+    "mtime": 1767187265.4623148,
+    "size": 2080
+  },
+  "usa_datasets.json": {
+    "mtime": 1767187329.9605117,
+    "size": 402280
+  },
+  "vector_operators.json": {
+    "mtime": 1767187265.4637623,
+    "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()