未知时光
e75cfc6812
- docs/01: sync all syscall signatures with proto (missing params, invented callback params, stream semantics, return types) - docs/02: mark unimplemented features (FFI system plugins, topo sort, lifecycle CLI, watchdog); clarify plugin.yaml is not parsed by the kernel - registration goes through gRPC PluginBridge.Register; correct permission model and session_id descriptions - docs/03: check off implemented stage 3 items (Hermes adapter, Claude Code plugin) - docs/04: data/ actual location, add Cargo.toml to plugin trees, note __init__.py is hand-maintained - README: status line now reflects actual progress Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Agentsd
AI Agent 的 init 系统 + 内核。对标 Linux 内核 + systemd。
状态:阶段 1(内核骨架)已完成,阶段 2/3 部分完成。详见 docs/03-实施路线.md
对标
| Linux | Agentsd | 说明 |
|---|---|---|
| 内核 syscall 表 | 9 个 syscall 接口 | 进程与硬件之间的抽象层 |
| 设备驱动 (.ko) | 系统插件 | 实现 syscall(如 alsa = audio 驱动) |
| systemd unit | 插件(basic / standard) | 声明依赖、由 init 管理生命周期 |
| systemd(PID 1) | agentsd 进程 | 启动排序、依赖解析、看门狗、日志 |
| D-Bus | gRPC over TCP(后续切 UDS/Named Pipe) | 进程间通信总线 |
| /dev | syscall 接口 | 插件访问能力的统一入口 |
| cgroup / seccomp | 权限白名单 | 访问控制 |
架构
标准插件 ← 对标 systemd 管理的应用服务(nginx、docker...)
基础插件 ← 对标 systemd 管理的基础服务(udevd、resolved...)
系统插件 ← 对标 Linux 内核模块 / 设备驱动(.ko)
───────────────────────────────────────
agentsd ← 对标 Linux 内核 + systemd(PID 1)
9 个系统调用
| # | syscall | Linux 类比 |
|---|---|---|
| 1 | Display | write(stdout) / framebuffer |
| 2 | Audio | /dev/snd (ALSA) |
| 3 | FS | open / read / write / stat / inotify |
| 4 | Memory | mmap / shmem(面向结构化数据) |
| 5 | Network | socket / connect / send / recv |
| 6 | Process | fork / exec / wait / kill |
| 7 | Timer | timer_create / timerfd |
| 8 | HID | /dev/input + /dev/fb |
| 9 | Input | read(stdin) / evdev |
三种插件
| 类型 | Linux 类比 | 通信 | 依赖 |
|---|---|---|---|
| 系统插件 | 内核模块 / 驱动 | FFI | 无 |
| 基础插件 | 基础 daemon | gRPC/TCP(后续 UDS/Named Pipe) | 只 syscall |
| 标准插件 | 应用服务 | gRPC/TCP(后续 UDS/Named Pipe) | syscall + 其他插件 |
agentsd 作为 PID 1 的职责
| 职责 | systemd 对标 |
|---|---|
| 启动排序 | unit ordering (After/Before) |
| 看门狗 | Restart=always |
| 依赖解析 | Requires / Wants |
| 日志收集 | journald |
| 资源控制 | cgroup + seccomp |
| 状态查询 | systemctl status |
| 热更新 | systemctl reload |
文档
| 文档 | 内容 |
|---|---|
| 01-内核系统调用.md | 9 个 syscall 定义(= 内核 syscall 表) |
| 02-插件模型.md | 三层插件 + gRPC + 权限(= 驱动 + unit + D-Bus) |
| 03-实施路线.md | 阶段进度 |
| 04-项目结构.md | 代码目录 + 构建说明 |
当前状态
阶段 1 已完成:内核骨架可运行,9 个 syscall gRPC service + PluginBridge 已注册,测试插件验证全链路通过。默认运行数据写入程序所在目录的 data/ 文件夹。plugins/ai_test 提供手动 AI 验证插件,默认不开启/不自动加载。Release 二进制约 6.1MB。
手动验证
cargo build --release
RUST_LOG=agentsd=info ./target/release/agentsd.exe
cargo run -p agentsd-plugin-ai-test
plugins/ai_test/plugin.yaml 中设置了 enabled: false 和 autoload: false,未来实现插件自动加载时应默认跳过它。