把 AI 工具链当成产品来做，而不是一堆脚本

交互层   Web / 桌面 / IDE 插件
编排层   模板 · Agent 步骤 · 人工确认点
接入层   Gateway（鉴权/路由/日志/预算）
能力层   云模型 · 本地模型 · 检索 · 文件

{
  "id": "release-checklist",
  "title": "发版前检查",
  "inputs": ["repo_path", "version"],
  "steps": [
    {
      "type": "shell",
      "run": "git -C {{repo_path}} status --porcelain"
    },
    {
      "type": "llm",
      "model": "auto",
      "prompt": "根据以下 git status，列出发版风险（中文要点）：\n{{shell_0}}"
    },
    {
      "type": "human_confirm",
      "message": "确认风险可接受后再继续打 tag？"
    }
  ]
}

# run_template.py
from __future__ import annotations
import json, subprocess, sys
from pathlib import Path
from openai import OpenAI

client = OpenAI(base_url="http://127.0.0.1:4000/v1", api_key="sk-local")

def render(s: str, ctx: dict) -> str:
    for k, v in ctx.items():
        s = s.replace("{{" + k + "}}", str(v))
    return s

def run(path: str, inputs: dict) -> None:
    tpl = json.loads(Path(path).read_text())
    ctx = dict(inputs)
    for i, step in enumerate(tpl["steps"]):
        if step["type"] == "shell":
            cmd = render(step["run"], ctx)
            out = subprocess.check_output(cmd, shell=True, text=True)
            ctx[f"shell_{i}"] = out
            print(out)
        elif step["type"] == "llm":
            prompt = render(step["prompt"], ctx)
            r = client.chat.completions.create(
                model=step.get("model", "auto"),
                messages=[{"role": "user", "content": prompt}],
            )
            text = r.choices[0].message.content or ""
            ctx[f"llm_{i}"] = text
            print(text)
        elif step["type"] == "human_confirm":
            ans = input(step["message"] + " [y/N] ").strip().lower()
            if ans != "y":
                sys.exit("aborted by human")
        else:
            raise ValueError(step["type"])

if __name__ == "__main__":
    run(sys.argv[1], {"repo_path": sys.argv[2], "version": sys.argv[3]})

python run_template.py release-checklist.json /srv/tiancheng-notes v1.2.0

# 所有客户端同一套
from openai import OpenAI
client = OpenAI(base_url="https://api.outsider-studio.cloud/v1", api_key="sk-xxx")