1
# 依赖：uv pip install openai python-dotenv
2
import os
3
from openai import OpenAI
4
from dotenv import load_dotenv
5

6
load_dotenv()  # 从 .env 读密钥，避免写死在代码里
7

8
client = OpenAI(
9
    api_key=os.getenv("DEEPSEEK_API_KEY"),
10
    base_url="https://api.deepseek.com",   # 兼容 OpenAI 格式，只差这一行
11
)
12

13
def ask(prompt: str, system: str = "你是专业的中文内容助手") -> str:
14
    resp = client.chat.completions.create(
15
        model="deepseek-flash",            # 旧名 deepseek-v4-flash 仍可路由
16
        messages=[
17
            {"role": "system", "content": system},
18
            {"role": "user", "content": prompt},
19
        ],
20
        temperature=0.7,
21
        stream=False,
22
    )
23
    u = resp.usage
24
    print(f"本次用量 - 输入 {u.prompt_tokens} / 输出 {u.completion_tokens}")
25
    return resp.choices[0].message.content
26

27
if __name__ == "__main__":
28
    print(ask("用三句话说明什么是 API。"))

1
# 调用侧：一份可直接粘贴的熔断装饰器
2
import json, time, pathlib
3

4
BUDGET = {"max_calls_per_day": 200, "max_retries": 3, "max_tokens": 8192}
5
LEDGER = pathlib.Path.home() / ".guide" / "usage.json"
6
LEDGER.parent.mkdir(exist_ok=True)
7

8
def _load():
9
    if LEDGER.exists():
10
        return json.loads(LEDGER.read_text())
11
    return {"date": time.strftime("%Y-%m-%d"), "calls": 0}
12

13
def guard(fn):
14
    def wrap(*a, **kw):
15
        led = _load()
16
        today = time.strftime("%Y-%m-%d")
17
        if led.get("date") != today:                 # 跨天归零
18
            led = {"date": today, "calls": 0}
19
        if led["calls"] >= BUDGET["max_calls_per_day"]:
20
            raise RuntimeError("已达当日调用上限，熔断退出")   # 不再重试
21
        led["calls"] += 1
22
        LEDGER.write_text(json.dumps(led))
23
        return fn(*a, **kw)
24
    return wrap

1
# 退避重试 + 降级链：主模型失败就退到便宜模型，再失败就落盘人工处理
2
import random, time
3

4
CHAIN = ["claude-opus-5", "deepseek-v4.1-flash"]   # 主 → 备；按你的成本梯度排
5

6
RETRYABLE = (429, 408, 500, 502, 503)
7

8
def call_with_fallback(prompt, client):
9
    for model in CHAIN:
10
        for attempt in range(4):
11
            try:
12
                return client.chat(model=model, prompt=prompt, max_tokens=4096)
13
            except ApiError as e:
14
                if e.status not in RETRYABLE:
15
                    break                    # 不可重试：直接换下一个模型
16
                time.sleep((2 ** attempt) + random.random())   # 抖动，避免同时重试
17
    raise RuntimeError("降级链全部失败，转人工处理")

1
# 1. 新建 LaunchAgent 配置（一个任务一个文件）
2
nano ~/Library/LaunchAgents/com.opc.daily.plist
3
# 关键字段：
4
#   Label                 唯一标识，如 com.opc.daily
5
#   ProgramArguments      要执行的命令，路径必须写绝对路径
6
#   StartCalendarInterval  定时规则（Hour / Minute）
7
#   StandardOutPath / StandardErrorPath   日志文件，出问题先看这里
8

9
# 2. 加载并立即生效
10
launchctl load ~/Library/LaunchAgents/com.opc.daily.plist
11

12
# 3. 确认已注册
13
launchctl list | grep opc
14

15
# 4. 改了配置后重新加载
16
launchctl unload ~/Library/LaunchAgents/com.opc.daily.plist
17
launchctl load ~/Library/LaunchAgents/com.opc.daily.plist