first

2026-07-12 21:26:08 +08:00
commit 9dd41afd48
502 changed files with 129901 additions and 0 deletions
@@ -0,0 +1,83 @@
+#!/bin/bash
+# 共享配置：被 install.sh / hook-session-start.sh / cache.sh / delete-helper.sh 等引用
+# 微信公众号提取工具的 Git 仓库地址
+WECHAT_TOOL_URL="git+https://github.com/jackwener/wechat-article-to-markdown.git"
+
+# Python 命令检测：Windows 默认安装为 python.exe，不存在 python3 命令
+# （Microsoft Store 的 python3 是安装提示 stub，运行会失败）
+_python_version_check='import sys; sys.exit(0 if sys.version_info >= (3, 8) else 1)'
+
+_python_cmd_is_valid() {
+  local candidate="$1"
+
+  command -v "$candidate" >/dev/null 2>&1 && "$candidate" -c "$_python_version_check" >/dev/null 2>&1
+}
+
+_detect_python_cmd() {
+  # 要求 Python 3.8+（见 README Windows 小节与下方错误消息）
+  if _python_cmd_is_valid python3; then
+    echo "python3"
+  elif _python_cmd_is_valid python; then
+    echo "python"
+  else
+    echo ""
+  fi
+}
+
+require_python_cmd() {
+  local detected_cmd
+
+  if [ "${PYTHON_CMD_READY:-0}" = "1" ]; then
+    return 0
+  fi
+
+  if [ -n "${PYTHON_CMD:-}" ] && _python_cmd_is_valid "$PYTHON_CMD"; then
+    export PYTHON_CMD
+    PYTHON_CMD_READY=1
+    return 0
+  fi
+
+  detected_cmd="$(_detect_python_cmd)"
+  if [ -z "$detected_cmd" ]; then
+    echo "[llm-wiki] 错误：找不到可用的 Python 3，请先安装 Python 3.8+ 并加入 PATH" >&2
+    return 1
+  fi
+
+  PYTHON_CMD="$detected_cmd"
+  export PYTHON_CMD
+  PYTHON_CMD_READY=1
+}
+
+# 统一 Python 子进程 stdout/stderr 编码为 UTF-8
+# Windows 中文环境下 Python 无 TTY 时 sys.stdout.encoding 默认 gbk (cp936)，
+# 会导致 Agent 通过 subprocess 读取的 JSON / 输出出现乱码 (issue #16)
+export PYTHONIOENCODING="${PYTHONIOENCODING:-utf-8}"
+
+# 输出指定工具的跨平台安装提示，缩进 2 空格便于嵌套在 ERROR 消息下；
+# 输出走 stderr，与 ERROR 消息保持同一通道。
+print_install_hint() {
+  local tool="$1"
+  case "$tool" in
+    jq)
+      echo "  macOS:        brew install jq" >&2
+      echo "  Linux/WSL:    sudo apt-get install jq   (Debian/Ubuntu)" >&2
+      echo "                sudo dnf install jq       (RHEL/Fedora)" >&2
+      echo "  Windows:      winget install jqlang.jq  (or choco install jq)" >&2
+      ;;
+    node)
+      echo "  macOS:        brew install node" >&2
+      echo "  Linux/WSL:    sudo apt-get install nodejs npm" >&2
+      echo "  Windows:      winget install OpenJS.NodeJS  (or choco install nodejs)" >&2
+      ;;
+    uv)
+      echo "  macOS/Linux:  curl -LsSf https://astral.sh/uv/install.sh | sh    (official)" >&2
+      echo "                brew install uv                                    (alternative)" >&2
+      echo "  Windows:      powershell -c \"irm https://astral.sh/uv/install.ps1 | iex\"   (official)" >&2
+      echo "                winget install --id=astral-sh.uv -e                (alternative)" >&2
+      ;;
+    *)
+      echo "  unknown tool: $tool" >&2
+      return 1
+      ;;
+  esac
+}