Initial source archive
这个提交存在于:
当前提交
7c4910fb71
共有 5 个文件被更改,包括 299 次插入 和 0 次删除
2
__init__.py
普通文件
2
__init__.py
普通文件
|
|
@ -0,0 +1,2 @@
|
|||
"""AstrBot development handoff plugin."""
|
||||
|
||||
13
_conf_schema.json
普通文件
13
_conf_schema.json
普通文件
|
|
@ -0,0 +1,13 @@
|
|||
{
|
||||
"socket_path": {
|
||||
"description": "交接控制器 Unix Socket",
|
||||
"type": "string",
|
||||
"default": "/run/dev-handoff/controller.sock"
|
||||
},
|
||||
"enable_llm_tools": {
|
||||
"description": "为管理员提供结构化交接工具",
|
||||
"type": "bool",
|
||||
"default": true
|
||||
}
|
||||
}
|
||||
|
||||
57
client.py
普通文件
57
client.py
普通文件
|
|
@ -0,0 +1,57 @@
|
|||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import os
|
||||
import stat
|
||||
from typing import Any
|
||||
|
||||
import aiohttp
|
||||
|
||||
|
||||
class HandoffClientError(RuntimeError):
|
||||
pass
|
||||
|
||||
|
||||
class HandoffClient:
|
||||
def __init__(self, socket_path: str):
|
||||
self.socket_path = socket_path
|
||||
self._session: aiohttp.ClientSession | None = None
|
||||
|
||||
async def open(self) -> None:
|
||||
if self._session is None or self._session.closed:
|
||||
connector = aiohttp.UnixConnector(path=self.socket_path)
|
||||
self._session = aiohttp.ClientSession(connector=connector, timeout=aiohttp.ClientTimeout(total=30))
|
||||
|
||||
async def close(self) -> None:
|
||||
if self._session and not self._session.closed:
|
||||
await self._session.close()
|
||||
|
||||
def _check_socket(self) -> None:
|
||||
try:
|
||||
mode = os.stat(self.socket_path).st_mode
|
||||
except OSError:
|
||||
raise HandoffClientError("交接控制器尚未启动") from None
|
||||
if not stat.S_ISSOCK(mode):
|
||||
raise HandoffClientError("交接控制器路径不是 Socket")
|
||||
|
||||
async def request(self, method: str, path: str, body: dict[str, Any] | None = None) -> dict[str, Any]:
|
||||
if not path.startswith("/") or "://" in path or ".." in path:
|
||||
raise HandoffClientError("无效控制器路径")
|
||||
self._check_socket()
|
||||
await self.open()
|
||||
assert self._session is not None
|
||||
try:
|
||||
async with self._session.request(method, "http://localhost" + path, json=body) as response:
|
||||
raw = await response.content.read(512 * 1024 + 1)
|
||||
if len(raw) > 512 * 1024:
|
||||
raise HandoffClientError("控制器响应过大")
|
||||
payload = json.loads(raw.decode("utf-8")) if raw else {}
|
||||
if response.status >= 400 or payload.get("ok") is False:
|
||||
raise HandoffClientError(str(payload.get("message") or "交接控制器拒绝请求")[:500])
|
||||
return payload
|
||||
except HandoffClientError:
|
||||
raise
|
||||
except (aiohttp.ClientError, OSError, TimeoutError, UnicodeDecodeError, json.JSONDecodeError):
|
||||
await self.close()
|
||||
raise HandoffClientError("无法连接交接控制器") from None
|
||||
|
||||
221
main.py
普通文件
221
main.py
普通文件
|
|
@ -0,0 +1,221 @@
|
|||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import re
|
||||
from typing import Any
|
||||
from urllib.parse import quote
|
||||
|
||||
from astrbot.api import AstrBotConfig, logger
|
||||
from astrbot.api.event import AstrMessageEvent, filter
|
||||
from astrbot.api.star import Context, Star, register
|
||||
|
||||
from .client import HandoffClient, HandoffClientError
|
||||
|
||||
|
||||
TOOLS = {"dev_handoff_projects", "dev_handoff_machines", "dev_handoff_tasks", "dev_handoff_status", "dev_handoff_plan"}
|
||||
ID_RE = re.compile(r"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$")
|
||||
|
||||
|
||||
@register("astrbot_plugin_dev_handoff", "Dev Handoff", "桌面 Codex 与 VM Codex 双向开发交接", "0.3.0")
|
||||
class DevHandoffPlugin(Star):
|
||||
def __init__(self, context: Context, config: AstrBotConfig):
|
||||
super().__init__(context)
|
||||
self.context = context
|
||||
self.client = HandoffClient(str(config.get("socket_path") or "/run/dev-handoff/controller.sock"))
|
||||
self.enable_llm_tools = bool(config.get("enable_llm_tools", True))
|
||||
|
||||
async def initialize(self):
|
||||
await self.client.open()
|
||||
logger.info("Dev Handoff 插件已初始化")
|
||||
|
||||
async def terminate(self):
|
||||
await self.client.close()
|
||||
|
||||
def _admin(self, event: AstrMessageEvent) -> bool:
|
||||
try:
|
||||
cfg = self.context.get_config(event.unified_msg_origin)
|
||||
return str(event.get_sender_id()) in {str(item) for item in cfg.get("admins_id", [])}
|
||||
except Exception:
|
||||
return False
|
||||
|
||||
@staticmethod
|
||||
def _id(value: str) -> str:
|
||||
value = str(value or "").strip()
|
||||
if not ID_RE.fullmatch(value):
|
||||
raise ValueError("ID 格式无效")
|
||||
return value
|
||||
|
||||
async def _call(self, method: str, path: str, body: dict[str, Any] | None = None) -> dict[str, Any]:
|
||||
try:
|
||||
return await self.client.request(method, path, body)
|
||||
except (HandoffClientError, ValueError) as exc:
|
||||
return {"ok": False, "message": str(exc)}
|
||||
|
||||
@staticmethod
|
||||
def _render(payload: dict[str, Any]) -> str:
|
||||
if not payload.get("ok", False):
|
||||
return "⚠️ " + str(payload.get("message") or "操作失败")
|
||||
lines = [str(payload.get("message") or "开发交接状态")]
|
||||
for key in ("task_id", "handoff_id", "state", "owner_machine_id", "current_epoch", "current_head_sha", "branch_name", "workspace_path"):
|
||||
if payload.get(key) is not None:
|
||||
lines.append(f"{key}: {payload[key]}")
|
||||
for group in ("projects", "tasks", "history", "events", "alerts", "jobs"):
|
||||
for item in payload.get(group, []):
|
||||
if group == "projects":
|
||||
lines.append(f"- {item.get('id')}:{item.get('name')}({item.get('repo')})")
|
||||
elif group == "tasks":
|
||||
lines.append(f"- {item.get('id')}:{item.get('title')}|{item.get('state')}|{item.get('owner_machine_id')}|e{item.get('current_epoch')}")
|
||||
elif group == "events":
|
||||
lines.append(f"- #{item.get('seq')} {item.get('created_at')} {item.get('action')} {item.get('subject_type')}={item.get('subject_id')}")
|
||||
elif group == "alerts":
|
||||
lines.append(f"- [{item.get('severity')}] {item.get('kind')} {item.get('subject_id')}:{item.get('last_error') or item.get('title') or ''}")
|
||||
elif group == "jobs":
|
||||
lines.append(f"- {item.get('id')} {item.get('state')} task={item.get('task_id')} machine={item.get('machine_id')} attempts={item.get('attempts')}")
|
||||
else:
|
||||
lines.append(f"- {item.get('created_at')} {item.get('action')} by {item.get('actor')}")
|
||||
task = payload.get("task")
|
||||
if isinstance(task, dict):
|
||||
lines.extend([
|
||||
f"项目:{task.get('project_id')}", f"任务:{task.get('id')} {task.get('title')}",
|
||||
f"当前开发端:{task.get('owner_machine_id')}", f"阶段:e{task.get('current_epoch')} {task.get('state')}",
|
||||
f"远端检查点:{task.get('current_head_sha')}",
|
||||
])
|
||||
return "\n".join(lines[:80])
|
||||
|
||||
@filter.on_llm_request()
|
||||
async def on_llm_request(self, event: AstrMessageEvent, request):
|
||||
if self.enable_llm_tools and self._admin(event):
|
||||
return
|
||||
tool_set = getattr(request, "func_tool", None)
|
||||
if tool_set:
|
||||
for name in TOOLS:
|
||||
try:
|
||||
tool_set.remove_tool(name)
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
@filter.command_group("dev")
|
||||
def dev(self):
|
||||
pass
|
||||
|
||||
@dev.command("projects")
|
||||
async def projects(self, event: AstrMessageEvent):
|
||||
yield event.plain_result(self._render(await self._call("GET", "/v1/projects")))
|
||||
|
||||
@dev.command("tasks")
|
||||
async def tasks(self, event: AstrMessageEvent, project_id: str = ""):
|
||||
suffix = f"?project_id={quote(self._id(project_id))}" if project_id else ""
|
||||
yield event.plain_result(self._render(await self._call("GET", "/v1/tasks" + suffix)))
|
||||
|
||||
@dev.command("status")
|
||||
async def status(self, event: AstrMessageEvent, task_id: str):
|
||||
yield event.plain_result(self._render(await self._call("GET", f"/v1/tasks/{quote(self._id(task_id))}")))
|
||||
|
||||
@dev.command("history")
|
||||
async def history(self, event: AstrMessageEvent, task_id: str):
|
||||
yield event.plain_result(self._render(await self._call("GET", f"/v1/tasks/{quote(self._id(task_id))}/history")))
|
||||
|
||||
@dev.command("events")
|
||||
async def events(self, event: AstrMessageEvent, after_seq: int = 0, limit: int = 30):
|
||||
after_seq = max(0, int(after_seq))
|
||||
limit = max(1, min(int(limit), 100))
|
||||
yield event.plain_result(self._render(await self._call("GET", f"/v1/events?after_seq={after_seq}&limit={limit}")))
|
||||
|
||||
@dev.command("alerts")
|
||||
async def alerts(self, event: AstrMessageEvent):
|
||||
yield event.plain_result(self._render(await self._call("GET", "/v1/alerts")))
|
||||
|
||||
@dev.command("cleanup")
|
||||
async def cleanup(self, event: AstrMessageEvent):
|
||||
yield event.plain_result(self._render(await self._call("GET", "/v1/cleanup")))
|
||||
|
||||
def _button_gateway(self) -> Any | None:
|
||||
"""BUTTON_GATEWAY_WIRED: shared button plugin, absent is a normal (text-only) state."""
|
||||
meta = self.context.get_registered_star("astrbot_plugin_button_gateway")
|
||||
return getattr(meta, "star_cls", None) if meta else None
|
||||
|
||||
async def on_button(self, action: str, payload: dict[str, Any], identity: dict[str, str]) -> tuple[bool, str]:
|
||||
"""Button gateway callback for handoff confirmation."""
|
||||
handoff_id = str(payload.get("handoff_id") or "")
|
||||
if action == "cancel":
|
||||
return True, f"已取消。交接 {handoff_id} 未确认,计划仍在,可稍后用 /dev approve 处理。"
|
||||
expected_sha = str(payload.get("expected_sha") or "")
|
||||
if not handoff_id or not expected_sha:
|
||||
return False, "缺少交接信息,请重新生成计划。"
|
||||
result = await self._call(
|
||||
"POST",
|
||||
f"/v1/handoffs/{quote(handoff_id)}/approve",
|
||||
{"expected_sha": expected_sha, "actor": str(identity.get("user_id") or "button")},
|
||||
)
|
||||
return bool(result.get("ok")), self._render(result)
|
||||
|
||||
@filter.permission_type(filter.PermissionType.ADMIN)
|
||||
@dev.command("handoff")
|
||||
async def handoff(self, event: AstrMessageEvent, task_id: str, to_machine_id: str):
|
||||
if not self._admin(event):
|
||||
yield event.plain_result("⚠️ 仅管理员可生成交接计划")
|
||||
return
|
||||
payload = await self._call("POST", f"/v1/tasks/{quote(self._id(task_id))}/handoff-plan", {"to_machine_id": self._id(to_machine_id), "actor": str(event.get_sender_id())})
|
||||
text = self._render(payload)
|
||||
handoff_id = str(payload.get("handoff_id") or "")
|
||||
expected_sha = str(payload.get("expected_sha") or "")
|
||||
gateway = self._button_gateway()
|
||||
if payload.get("ok") and handoff_id and expected_sha and gateway is not None:
|
||||
sent = await gateway.send_buttons(
|
||||
event,
|
||||
(
|
||||
f"# 交接计划已生成\n"
|
||||
f"任务:`{task_id}`\n"
|
||||
f"目标:`{to_machine_id}`\n"
|
||||
f"Commit:`{expected_sha[:12]}…`\n"
|
||||
f"交接号:`{handoff_id}`\n\n"
|
||||
"确认后来源端执行段会被冻结,目标端才能接手。"
|
||||
),
|
||||
[
|
||||
{"label": "确认交接", "action": "approve", "style": 1},
|
||||
{"label": "取消", "action": "cancel", "style": 0},
|
||||
],
|
||||
owner="astrbot_plugin_dev_handoff",
|
||||
handler="on_button",
|
||||
payload={"handoff_id": handoff_id, "expected_sha": expected_sha, "task_id": task_id},
|
||||
allowed_user_id=str(event.get_sender_id()),
|
||||
ttl_seconds=900,
|
||||
)
|
||||
if sent:
|
||||
yield event.plain_result(text + "\n\n已发送确认按钮。")
|
||||
return
|
||||
yield event.plain_result(text)
|
||||
|
||||
@filter.permission_type(filter.PermissionType.ADMIN)
|
||||
@dev.command("approve")
|
||||
async def approve(self, event: AstrMessageEvent, handoff_id: str, expected_sha: str):
|
||||
payload = await self._call("POST", f"/v1/handoffs/{quote(self._id(handoff_id))}/approve", {"expected_sha": expected_sha, "actor": str(event.get_sender_id())})
|
||||
yield event.plain_result(self._render(payload))
|
||||
|
||||
@filter.llm_tool(name="dev_handoff_projects")
|
||||
async def tool_projects(self, event: AstrMessageEvent) -> str:
|
||||
"""列出受控开发项目及其仓库与默认分支。"""
|
||||
return json.dumps(await self._call("GET", "/v1/projects"), ensure_ascii=False)
|
||||
|
||||
@filter.llm_tool(name="dev_handoff_machines")
|
||||
async def tool_machines(self, event: AstrMessageEvent) -> str:
|
||||
"""列出可接受交接的机器。capabilities.agent 标明该机器跑的编码 Agent:codex 或 claude。生成交接计划前用它确认 to_machine_id。"""
|
||||
return json.dumps(await self._call("GET", "/v1/machines"), ensure_ascii=False)
|
||||
|
||||
@filter.llm_tool(name="dev_handoff_tasks")
|
||||
async def tool_tasks(self, event: AstrMessageEvent, project_id: str = "") -> str:
|
||||
"""列出受控开发任务。project_id 可选。"""
|
||||
suffix = f"?project_id={quote(self._id(project_id))}" if project_id else ""
|
||||
return json.dumps(await self._call("GET", "/v1/tasks" + suffix), ensure_ascii=False)
|
||||
|
||||
@filter.llm_tool(name="dev_handoff_status")
|
||||
async def tool_status(self, event: AstrMessageEvent, task_id: str) -> str:
|
||||
"""读取一个开发任务、执行段和交接历史。"""
|
||||
return json.dumps(await self._call("GET", f"/v1/tasks/{quote(self._id(task_id))}"), ensure_ascii=False)
|
||||
|
||||
@filter.llm_tool(name="dev_handoff_plan")
|
||||
async def tool_handoff(self, event: AstrMessageEvent, task_id: str, to_machine_id: str) -> str:
|
||||
"""仅生成交接计划;不会创建工作区或开始编码。"""
|
||||
if not self._admin(event):
|
||||
return json.dumps({"ok": False, "message": "仅管理员可生成交接计划"}, ensure_ascii=False)
|
||||
return json.dumps(await self._call("POST", f"/v1/tasks/{quote(self._id(task_id))}/handoff-plan", {"to_machine_id": self._id(to_machine_id), "actor": str(event.get_sender_id())}), ensure_ascii=False)
|
||||
6
metadata.yaml
普通文件
6
metadata.yaml
普通文件
|
|
@ -0,0 +1,6 @@
|
|||
name: astrbot_plugin_dev_handoff
|
||||
display_name: Development Handoff
|
||||
desc: 桌面 Codex 与 VM Codex 的任务事实源和安全交接入口
|
||||
version: 0.3.0
|
||||
author: local
|
||||
repo: local/astrbot-ops-suite
|
||||
正在加载…
添加表格
在新工单中引用