@agentunion/kite 1.0.7 → 1.3.0

package/CHANGELOG.md

@@ -0,0 +1,208 @@
+# v1.3.0
+
+**发布日期**：2026-03-04
+**上一版本**：v1.2.0
+**版本级别**：minor（架构重构）
+
+---
+
+## 核心变更
+
+本次发布完成 Kite 框架的**核心架构重构**，将原有 `core/` 三模块体系（event_hub、registry、launcher）重组为两个独立顶层模块：
+
+- **`kernel/`** — 合并 Registry + Event Hub，统一 WebSocket JSON-RPC 2.0 接口
+- **`launcher/`** — 从 `core/launcher/` 提升为顶层模块，支持 `-m launcher` 启动
+
+**零共享代码依赖落地**：删除 `core/kite_log.py` 共享日志库，各模块独立实现日志规范，符合跨语言兼容原则。
+
+---
+
+## 变更统计
+
+| 类型 | 数量 | 说明 |
+|------|------|------|
+| 新增 | 17 | `kernel/**` (9), `launcher/**` (8) |
+| 删除 | 28 | `core/**` (25), `extensions/services/*/server.py` (3) |
+| 修改 | 15 | 入口文件、扩展模块适配 |
+
+---
+
+## 关键变更
+
+### 新增模块
+
+**`kernel/`** (9 个文件)
+- 合并 event_hub + registry 为单一基础设施模块
+- 单一 WebSocket 连接处理 RPC 请求和事件推送
+- 内置跨模块 RPC 转发，无需 HTTP 调用
+
+**`launcher/`** (8 个文件)
+- 新增 `logging_setup.py` — 统一日志系统（替代 `core/kite_log.py`）
+- 新增 `count_lines.py` — 代码统计工具
+- 支持 `python -m launcher` 模块化启动
+
+### 删除内容
+
+- **`core/` 目录完全移除** (25 个文件)
+  - `core/event_hub/` → `kernel/`（合并）
+  - `core/registry/` → `kernel/`（合并）
+  - `core/launcher/` → `launcher/`（提升）
+  - `core/kite_log.py` — 共享日志库（违反零依赖原则）
+  - `core/event_hub/bench*.py` — 性能测试工具（移至独立仓库）
+
+- **扩展模块清理** (3 个文件)
+  - 删除 `extensions/services/*/server.py` — 独立 HTTP 服务器（改用 Kernel RPC）
+
+### 入口变更
+
+**`cli.js`** — Python 启动方式改为 `-m launcher`
+```diff
+- [path.join(versionDir, 'main.py'), ...pythonArgs]
++ ['-m', 'launcher', ...pythonArgs]
+```
+
+**`main.py`** — 简化为开发入口（357 行 → 18 行）
+- 旧版：完整启动器逻辑（日志、环境变量、进程管理）
+- 新版：仅运行代码统计 + 启动 launcher 模块
+
+---
+
+## 架构演进
+
+| 版本 | 核心模块 | 通信协议 | 共享代码 | 文件数 |
+|------|---------|---------|---------|--------|
+| v1.1.0 | 3 (event_hub, registry, launcher) | HTTP REST | `core/kite_log.py` | 72 |
+| v1.2.0 | 3 (同上) | HTTP REST | `core/kite_log.py` | 97 |
+| v1.3.0 | 2 (kernel, launcher) | WebSocket RPC | 无 | 87 |
+
+---
+
+## 设计原则
+
+- ✅ **零共享代码依赖** — 删除 `core/kite_log.py`，各模块独立实现
+- ✅ **跨语言兼容** — WebSocket JSON-RPC 2.0 标准协议
+- ✅ **跨平台兼容** — `-m launcher` 启动方式通用
+
+---
+
+## 包信息
+
+- **文件数**：87（-10 vs v1.2.0）
+- **打包大小**：205.7 kB
+- **解压大小**：966.4 kB
+
+---
+
+## 破坏性变更
+
+虽标记为 minor，但包含以下潜在破坏性变更：
+
+1. **目录结构** — `core/**` → `kernel/` + `launcher/`
+2. **Python 入口** — `python main.py` → `python -m launcher`
+3. **通信协议** — HTTP REST → WebSocket RPC
+
+对外 CLI 接口（`kite` 命令）保持兼容，用户无感知。
+# v1.2.0
+
+**发布日期**：2026-03-03
+**上一版本**：v1.1.0
+**版本级别**：minor
+
+## 变更文件
+
+### 新增
+- `extensions/services/web/config.yaml`
+- `extensions/services/web/vendor/__init__.py`
+- `extensions/services/web/vendor/config.py`
+- `extensions/services/web/vendor/bluetooth/__init__.py`
+- `extensions/services/web/vendor/bluetooth/audio.py`
+- `extensions/services/web/vendor/bluetooth/contacts.py`
+- `extensions/services/web/vendor/bluetooth/manager.py`
+- `extensions/services/web/vendor/bluetooth/sms.py`
+- `extensions/services/web/vendor/bluetooth/telephony.py`
+- `extensions/services/web/vendor/conversation/__init__.py`
+- `extensions/services/web/vendor/conversation/asr.py`
+- `extensions/services/web/vendor/conversation/engine.py`
+- `extensions/services/web/vendor/conversation/llm.py`
+- `extensions/services/web/vendor/conversation/mcp_tools.py`
+- `extensions/services/web/vendor/conversation/tts.py`
+- `extensions/services/web/vendor/conversation/vad.py`
+- `extensions/services/web/vendor/storage/__init__.py`
+- `extensions/services/web/vendor/storage/identity.py`
+- `extensions/services/web/vendor/storage/store.py`
+- `extensions/services/web/vendor/task/__init__.py`
+- `extensions/services/web/vendor/task/manager.py`
+- `extensions/services/web/vendor/task/models.py`
+- `extensions/services/web/vendor/task/webhook.py`
+- `extensions/services/web/vendor/tools/__init__.py`
+- `extensions/services/web/vendor/tools/registry.py`
+
+### 删除
+（无）
+
+### 修改
+- `core/event_hub/server.py`
+- `core/launcher/entry.py`
+- `core/launcher/process_manager.py`
+- `extensions/agents/assistant/entry.py`
+- `extensions/agents/assistant/server.py`
+- `extensions/channels/acp_channel/entry.py`
+- `extensions/channels/acp_channel/server.py`
+- `extensions/event_hub_bench/module.md`
+- `extensions/services/backup/entry.py`
+- `extensions/services/backup/server.py`
+- `extensions/services/model_service/entry.py`
+- `extensions/services/model_service/server.py`
+- `extensions/services/watchdog/entry.py`
+- `extensions/services/watchdog/server.py`
+- `extensions/services/web/entry.py`
+- `extensions/services/web/routes/routes_call.py`
+- `extensions/services/web/routes/routes_config.py`
+- `extensions/services/web/routes/routes_contacts.py`
+- `extensions/services/web/routes/routes_devlog.py`
+- `extensions/services/web/routes/routes_phone.py`
+- `extensions/services/web/routes/routes_sms.py`
+- `extensions/services/web/routes/routes_stats.py`
+- `extensions/services/web/routes/routes_voicechat.py`
+- `extensions/services/web/server.py`
+- `main.py`
+
+## 变更摘要
+
+新增 Web 模块的 vendor 子系统，将 bluetooth、conversation、storage、task、tools 等依赖模块内联到 web 服务中，实现 web 模块的独立运行能力。同时更新了各模块的 entry/server 文件和 web routes，适配新的架构调整。
+# v1.1.0
+
+**发布日期**：2026-03-02
+**上一版本**：v1.0.8
+**版本级别**：minor
+
+## 变更文件
+
+### 新增
+- `core/kite_log.py` — 统一日志工具模块
+- `extensions/agents/` — Agent 扩展目录
+- `extensions/channels/` — Channel 扩展目录
+- `extensions/services/backup/` — 备份服务模块
+- `extensions/services/model_service/` — 模型服务模块
+- `extensions/services/web/` — Web 管理服务模块
+
+### 修改
+- `main.py`
+- `core/event_hub/entry.py`
+- `core/event_hub/hub.py`
+- `core/event_hub/server.py`
+- `core/launcher/entry.py`
+- `core/launcher/process_manager.py`
+- `core/registry/entry.py`
+- `core/registry/server.py`
+- `core/registry/store.py`
+- `extensions/event_hub_bench/entry.py`
+- `extensions/event_hub_bench/module.md`
+- `extensions/services/watchdog/entry.py`
+- `extensions/services/watchdog/module.md`
+- `extensions/services/watchdog/monitor.py`
+- `extensions/services/watchdog/server.py`
+
+## 变更摘要
+
+重大功能更新：新增三个扩展类型目录（agents、channels、services），引入统一日志工具 `kite_log.py`，新增 backup、model_service、web 三个服务模块。核心模块（launcher、registry、event_hub）进行了多项优化和增强，包括进程管理改进、事件路由优化、模块生命周期管理完善。打包文件数从 36 个增至 72 个，框架扩展性和功能完整度显著提升。

package/README.md

@@ -0,0 +1,48 @@
+# Kite 框架
+
+跨平台、跨语言的模块化框架。
+
+## 目录结构
+
+```
+Kite/
+├── launcher/          # 启动器（核心模块）
+├── kernel/            # 内核（核心模块）- Registry + Event Hub 合并
+├── extensions/        # 扩展模块
+│   ├── agents/        # AI 代理
+│   ├── channels/      # 通信通道
+│   └── services/      # 服务模块
+├── scripts/           # 工具脚本
+├── docs/              # 文档
+├── tests/             # 测试相关
+│   ├── modules/       # 测试模块
+│   └── test_*.py      # 测试脚本
+├── .dev/              # 开发相关（不提交）
+│   ├── changelogs/    # 变更日志
+│   └── releases/      # 发布备份
+├── data/              # 运行时数据（不提交）
+├── main.py            # 入口文件
+├── cli.js             # CLI 工具
+└── CLAUDE.md          # 项目说明
+```
+
+## 快速开始
+
+```bash
+# 启动 Kite
+python main.py
+
+# 查看代码统计
+python main.py --count-lines
+
+# 查看统计历史
+python scripts/count_lines.py --history
+```
+
+## 核心原则
+
+1. **零共享代码依赖** - 模块间无代码级依赖
+2. **跨平台兼容** - Windows / Linux / macOS
+3. **跨语言兼容** - Python / Node.js / Binary
+
+详细说明见 `CLAUDE.md` 和 `docs/`。

package/cli.js

@@ -155,7 +155,7 @@ const env = {
 const python = process.platform === 'win32' ? 'python' : 'python3';
 const child = spawn(
   python,
-  [path.join(versionDir, 'main.py'), ...pythonArgs],
+  ['-m', 'launcher', ...pythonArgs],
   { cwd: versionDir, env, stdio: 'inherit' }
 );
 

package/extensions/agents/__init__.py

@@ -0,0 +1 @@
+

package/extensions/agents/assistant/__init__.py

@@ -0,0 +1 @@
+

package/extensions/agents/assistant/entry.py

@@ -0,0 +1,329 @@
+"""
+Assistant entry point.
+Reads boot_info from stdin, connects to Kernel via WebSocket JSON-RPC 2.0.
+"""
+
+import asyncio
+import builtins
+import json
+import os
+import re
+import sys
+import threading
+import time
+import traceback
+from datetime import datetime, timezone
+
+
+# ── Safe stdout/stderr: ignore BrokenPipeError after Launcher closes stdio ──
+
+
+# ── Module configuration ──
+MODULE_NAME = "assistant"
+
+
+class _SafeWriter:
+    """Wraps a stream to silently swallow BrokenPipeError on write/flush."""
+    def __init__(self, stream):
+        self._stream = stream
+
+    def write(self, s):
+        try:
+            self._stream.write(s)
+        except (BrokenPipeError, OSError):
+            pass
+
+    def flush(self):
+        try:
+            self._stream.flush()
+        except (BrokenPipeError, OSError):
+            pass
+
+    def __getattr__(self, name):
+        return getattr(self._stream, name)
+
+sys.stdout = _SafeWriter(sys.stdout)
+sys.stderr = _SafeWriter(sys.stderr)
+
+
+# ── Timestamped print + log file writer ──
+# Independent implementation per module (no shared code dependency)
+
+_builtin_print = builtins.print
+_start_ts = time.monotonic()
+_last_ts = time.monotonic()
+_ANSI_RE = re.compile(r"\033\[[0-9;]*m")
+_log_lock = threading.Lock()
+_log_latest_path = None
+_log_daily_path = None
+_log_daily_date = ""
+_log_dir = None
+_crash_log_path = None
+
+def _strip_ansi(s: str) -> str:
+    return _ANSI_RE.sub("", s)
+
+def _resolve_daily_log_path():
+    """Resolve daily log path based on current date."""
+    global _log_daily_path, _log_daily_date
+    if not _log_dir:
+        return
+    today = datetime.now().strftime("%Y-%m-%d")
+    if today == _log_daily_date and _log_daily_path:
+        return
+    month_dir = os.path.join(_log_dir, today[:7])
+    os.makedirs(month_dir, exist_ok=True)
+    _log_daily_path = os.path.join(month_dir, f"{today}.log")
+    _log_daily_date = today
+
+def _write_log(plain_line: str):
+    """Write a plain-text line to both latest.log and daily log."""
+    with _log_lock:
+        if _log_latest_path:
+            try:
+                with open(_log_latest_path, "a", encoding="utf-8") as f:
+                    f.write(plain_line)
+            except Exception:
+                pass
+        _resolve_daily_log_path()
+        if _log_daily_path:
+            try:
+                with open(_log_daily_path, "a", encoding="utf-8") as f:
+                    f.write(plain_line)
+            except Exception:
+                pass
+
+def _write_crash(exc_type, exc_value, exc_tb, thread_name=None, severity="critical", handled=False):
+    """Write crash record to crashes.jsonl + daily crash archive."""
+    record = {
+        "timestamp": datetime.now(timezone.utc).isoformat(),
+        "module": MODULE_NAME,
+        "thread": thread_name or threading.current_thread().name,
+        "exception_type": exc_type.__name__ if exc_type else "Unknown",
+        "exception_message": str(exc_value),
+        "traceback": "".join(traceback.format_exception(exc_type, exc_value, exc_tb)),
+        "severity": severity,
+        "handled": handled,
+        "process_id": os.getpid(),
+        "platform": sys.platform,
+        "runtime_version": f"Python {sys.version.split()[0]}",
+    }
+
+    if exc_tb:
+        tb_entries = traceback.extract_tb(exc_tb)
+        if tb_entries:
+            last = tb_entries[-1]
+            record["context"] = {
+                "function": last.name,
+                "file": os.path.basename(last.filename),
+                "line": last.lineno,
+            }
+
+    line = json.dumps(record, ensure_ascii=False) + "\n"
+
+    if _crash_log_path:
+        try:
+            with open(_crash_log_path, "a", encoding="utf-8") as f:
+                f.write(line)
+        except Exception:
+            pass
+
+    if _log_dir:
+        try:
+            today = datetime.now().strftime("%Y-%m-%d")
+            archive_dir = os.path.join(_log_dir, "crashes", today[:7])
+            os.makedirs(archive_dir, exist_ok=True)
+            archive_path = os.path.join(archive_dir, f"{today}.jsonl")
+            with open(archive_path, "a", encoding="utf-8") as f:
+                f.write(line)
+        except Exception:
+            pass
+
+def _print_crash_summary(exc_type, exc_tb, thread_name=None):
+    """Print crash summary to console (red highlight)."""
+    RED = "\033[91m"
+    RESET = "\033[0m"
+
+    if exc_tb:
+        tb_entries = traceback.extract_tb(exc_tb)
+        if tb_entries:
+            last = tb_entries[-1]
+            location = f"{os.path.basename(last.filename)}:{last.lineno}"
+        else:
+            location = "unknown"
+    else:
+        location = "unknown"
+
+    prefix = f"[{MODULE_NAME}]"
+    if thread_name:
+        _builtin_print(f"{prefix} {RED}线程 {thread_name} 崩溃: "
+                       f"{exc_type.__name__} in {location}{RESET}")
+    else:
+        _builtin_print(f"{prefix} {RED}崩溃: {exc_type.__name__} in {location}{RESET}")
+    if _crash_log_path:
+        _builtin_print(f"{prefix} 崩溃日志: {_crash_log_path}")
+
+def _setup_exception_hooks():
+    """Set up global exception hooks."""
+    _orig_excepthook = sys.excepthook
+
+    def _excepthook(exc_type, exc_value, exc_tb):
+        _write_crash(exc_type, exc_value, exc_tb, severity="critical", handled=False)
+        _print_crash_summary(exc_type, exc_tb)
+        _orig_excepthook(exc_type, exc_value, exc_tb)
+
+    sys.excepthook = _excepthook
+
+    if hasattr(threading, "excepthook"):
+        def _thread_excepthook(args):
+            _write_crash(args.exc_type, args.exc_value, args.exc_traceback,
+                        thread_name=args.thread.name if args.thread else "unknown",
+                        severity="error", handled=False)
+            _print_crash_summary(args.exc_type, args.exc_traceback,
+                                thread_name=args.thread.name if args.thread else None)
+
+        threading.excepthook = _thread_excepthook
+
+def _tprint(*args, **kwargs):
+    """Timestamped print that adds [timestamp] HH:MM:SS.mmm +delta prefix."""
+    global _last_ts
+    now = time.monotonic()
+    elapsed = now - _start_ts
+    delta = now - _last_ts
+    _last_ts = now
+
+    if elapsed < 1:
+        elapsed_str = f"{elapsed * 1000:.0f}ms"
+    elif elapsed < 100:
+        elapsed_str = f"{elapsed:.1f}s"
+    else:
+        elapsed_str = f"{elapsed:.0f}s"
+
+    if delta < 0.001:
+        delta_str = ""
+    elif delta < 1:
+        delta_str = f"+{delta * 1000:.0f}ms"
+    elif delta < 100:
+        delta_str = f"+{delta:.1f}s"
+    else:
+        delta_str = f"+{delta:.0f}s"
+
+    ts = datetime.now().strftime("%H:%M:%S.%f")[:-3]
+
+    _builtin_print(*args, **kwargs)
+
+    if _log_latest_path or _log_daily_path:
+        sep = kwargs.get("sep", " ")
+        end = kwargs.get("end", "\n")
+        text = sep.join(str(a) for a in args)
+        prefix = f"[{elapsed_str:>6}] {ts} {delta_str:>8} "
+        _write_log(prefix + _strip_ansi(text) + end)
+
+builtins.print = _tprint
+
+# Ensure project root is on sys.path (set by main.py or cli.js)
+_project_root = os.environ.get("KITE_PROJECT") or os.path.dirname(os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))))
+if _project_root not in sys.path:
+    sys.path.insert(0, _project_root)
+
+from extensions.agents.assistant.server import AssistantServer
+
+
+def _fmt_elapsed(t0: float) -> str:
+    d = time.monotonic() - t0
+    if d < 1:
+        return f"{d * 1000:.0f}ms"
+    if d < 10:
+        return f"{d:.1f}s"
+    return f"{d:.0f}s"
+
+
+def _read_stdin_kite_message(expected_type: str, timeout: float = 10) -> dict | None:
+    """Read a single kite message of expected type from stdin with timeout."""
+    result = [None]
+
+    def _read():
+        try:
+            line = sys.stdin.readline().strip()
+            if line:
+                msg = json.loads(line)
+                if isinstance(msg, dict) and msg.get("kite") == expected_type:
+                    result[0] = msg
+        except Exception:
+            pass
+
+    t = threading.Thread(target=_read, daemon=True)
+    t.start()
+    t.join(timeout=timeout)
+    return result[0]
+
+
+def main():
+    # Initialize log file paths
+    global _log_dir, _log_latest_path, _crash_log_path
+    module_data = os.environ.get("KITE_MODULE_DATA")
+    if module_data:
+        _log_dir = os.path.join(module_data, "log")
+        os.makedirs(_log_dir, exist_ok=True)
+        suffix = os.environ.get("KITE_INSTANCE_SUFFIX", "")
+
+        _log_latest_path = os.path.join(_log_dir, f"latest{suffix}.log")
+        try:
+            with open(_log_latest_path, "w", encoding="utf-8") as f:
+                pass
+        except Exception:
+            _log_latest_path = None
+
+        _crash_log_path = os.path.join(_log_dir, f"crashes{suffix}.jsonl")
+        try:
+            with open(_crash_log_path, "w", encoding="utf-8") as f:
+                pass
+        except Exception:
+            _crash_log_path = None
+
+        _resolve_daily_log_path()
+
+    _setup_exception_hooks()
+
+    _t0 = time.monotonic()
+
+    # Read boot_info from stdin (only token)
+    token = ""
+    try:
+        line = sys.stdin.readline().strip()
+        if line:
+            boot_info = json.loads(line)
+            token = boot_info.get("token", "")
+    except Exception:
+        pass
+
+    # Read kernel_port: env first (fast path), stdin fallback (parallel start)
+    kernel_port = int(os.environ.get("KITE_KERNEL_PORT", "0"))
+    if not kernel_port:
+        msg = _read_stdin_kite_message("kernel_port", timeout=10)
+        if msg:
+            kernel_port = int(msg.get("kernel_port", 0))
+
+    if not token or not kernel_port:
+        print("[assistant] ERROR: Missing token or kernel_port")
+        sys.exit(1)
+
+    print(f"[assistant] Token received ({len(token)} chars), kernel port: {kernel_port} ({_fmt_elapsed(_t0)})")
+
+    server = AssistantServer(
+        token=token,
+        kernel_port=kernel_port,
+        boot_t0=_t0,
+    )
+
+    print(f"[assistant] Starting ({_fmt_elapsed(_t0)})")
+    try:
+        asyncio.run(server.run())
+    except Exception as e:
+        _write_crash(type(e), e, e.__traceback__, severity="critical", handled=True)
+        _print_crash_summary(type(e), e.__traceback__)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/extensions/agents/assistant/module.md

@@ -0,0 +1,22 @@
+---
+name: assistant
+display_name: Assistant
+version: "1.0"
+type: agent
+state: enabled
+runtime: python
+entry: entry.py
+events:
+  - assistant.test
+subscriptions:
+  - module.started
+  - module.stopped
+  - module.shutdown
+---
+
+# Assistant（AI 助手代理）
+
+AI 助手代理模块，负责对话管理和任务执行。
+
+- 对话管理 — 处理用户对话请求并生成响应
+- 事件通知 — 通过 Kernel 发布助手状态事件