用 Claude API 搭建本地助手：命令行、历史存储与 Web 界面

import json, os, tempfile
from pathlib import Path

def validate_history(data):
    if not isinstance(data, list):
        raise ValueError("history_must_be_list")
    for item in data:
        if (not isinstance(item, dict) or set(item) != {"role","content"}
            or item["role"] not in {"user","assistant"}
            or not isinstance(item["content"], str)):
            raise ValueError("invalid_text_history")
    return data

def save_history(path, messages):
    payload = json.dumps(validate_history(messages), ensure_ascii=False)
    path = Path(path)
    path.parent.mkdir(parents=True, exist_ok=True)
    temp_name = None
    try:
        with tempfile.NamedTemporaryFile(mode="w", encoding="utf-8", dir=path.parent,
                                         delete=False) as handle:
            temp_name = handle.name
            handle.write(payload)
            handle.flush()
            os.fsync(handle.fileno())
        os.replace(temp_name, path)
    finally:
        if temp_name and os.path.exists(temp_name):
            os.unlink(temp_name)

def load_history(path):
    path = Path(path)
    return validate_history(json.loads(path.read_text(encoding="utf-8"))) if path.exists() else []

document.querySelector("button").addEventListener("click", async () => {
  const output = document.querySelector("pre");
  output.textContent = "正在处理…";
  try {
    const response = await fetch("/chat", {
      method: "POST", headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ text: document.querySelector("input").value })
    });
    if (!response.ok) throw new Error("request_failed");
    const data = await response.json();
    output.textContent = data.text + (data.stop_reason === "end_turn" ? "" : "\n[未确认完整]");
  } catch { output.textContent = "请求未完成，请检查后端状态。"; }
});