Files

T

baozaotumao 39fe248f9f feat: 重组为标准 skill 包结构 + 修复 verify.sh bash 3.2 兼容

- 新增 .claude/skills/new-project/SKILL.md（标准 skill 格式）
- install-skill.sh 安装时组装 SKILL.md + verify.sh，单一源无重复
- verify.sh 改用索引数组替代 declare -A，兼容 macOS bash 3.2
- log_pass/log_skip 显式 return 0，避免 set -e 下非 verbose 误退出
- README 改为 skill 优先；补全 copier.yml/scripts/template 入库

2026-06-01 21:19:45 -07:00

3.2 KiB

Raw Blame History

paths

agent/**

Agent LLM 驱动层与 PTY 桥接

厂商无关的 LLM CLI 抽象、PTY 伪终端桥接机制、超时保护与 HTML 拦截检测。

LLM CLI 驱动层（llm/）

厂商无关的抽象。LLMSession 端口定义在 domain/ports.py，本目录只放适配器实现。DAG 节点只依赖端口，不感知具体厂商。

文件	职责
`domain/ports.py`	`LLMSession` 协议（端口，接口定义）
`pty_bridge.py`	共享 PTY 机制（所有 CLI 厂商复用）
`gemini_cli.py`	`GeminiCliSession`：gemini 命令 + prompt 约定 + HTML 提取

扩展新厂商：新增 claude_cli.py 等实现 LLMSession 端口即可，PTY 机制无需重写。

注意：当前只支持 PTY 驱动的交互式 CLI。若未来要接入直接 API 调用（SDK），那是不同机制，应另开 llm/api/ 子目录，不要塞进 PTY 层。

LLMSession 协议（domain/ports.py）

class LLMSession(Protocol):
    async def start(self) -> None: ...                       # 启动 CLI 进程
    async def send(self, text: str) -> None: ...             # 写入用户输入
    async def stream_until(self, predicate) -> str: ...      # 流式读取直到满足条件
    async def close(self) -> None: ...                       # 关闭进程，清理资源

PTY 桥接（pty_bridge.py）

原理

master_fd ──读──► 解析输出 ──► WebSocket 推送
master_fd ──写◄── WebSocket 收到用户输入
slave_fd  ──────► CLI 进程 stdin/stdout（认为自己在真实终端）

关键实现

启动进程：

master_fd, slave_fd = pty.openpty()
proc = await asyncio.create_subprocess_exec(
    'gemini',
    stdin=slave_fd, stdout=slave_fd, stderr=slave_fd,
    env={**os.environ, 'TERM': 'xterm-256color'},
)
os.close(slave_fd)  # 父进程关闭 slave，只用 master

异步读取（事件驱动，非阻塞 fd + add_reader，零线程）：

os.set_blocking(master_fd, False)
loop.add_reader(master_fd, on_pty_readable)   # 详见「并发模型」章节

不要用 thread-per-session 的阻塞 os.read，会话多时线程池会被打爆。

ANSI 转义码过滤（推送前必须清洗，实现在 utils/ansi.py）：

ANSI_ESCAPE = re.compile(r'\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])')
clean_text = ANSI_ESCAPE.sub('', raw_text)

写入用户输入：

os.write(master_fd, (user_text + '\n').encode('utf-8'))

超时保护

每个 DAG 阶段设置独立超时（asyncio.wait_for）：

阶段	超时
phase1_dialog（单轮回答）	60s
phase2_preview（3 张预览）	180s
phase3_generate（完整 HTML）	300s
screenshot	180s

超时后抛 GeminiTimeoutError。

HTML 拦截检测

def detect_html(text: str) -> str | None:
    m = re.search(r'```html\s*([\s\S]+?)```|(<html[\s\S]+?</html>)', text, re.IGNORECASE)
    return (m.group(1) or m.group(2)).strip() if m else None

根据 state.status 决定处理：

"previewing" → 保存 preview_{n}.html，推送 style_preview 事件
"generating" → 保存 slides.html，推送 html_ready，触发后续节点

3.2 KiB Raw Blame History Unescape Escape