未知时光
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>
85 lines
3.2 KiB
Markdown
85 lines
3.2 KiB
Markdown
# 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](./docs/01-内核系统调用.md) | 9 个 syscall 定义(= 内核 syscall 表) |
|
|
| [02-插件模型.md](./docs/02-插件模型.md) | 三层插件 + gRPC + 权限(= 驱动 + unit + D-Bus) |
|
|
| [03-实施路线.md](./docs/03-实施路线.md) | 阶段进度 |
|
|
| [04-项目结构.md](./docs/04-项目结构.md) | 代码目录 + 构建说明 |
|
|
|
|
## 当前状态
|
|
|
|
阶段 1 已完成:内核骨架可运行,9 个 syscall gRPC service + PluginBridge 已注册,测试插件验证全链路通过。默认运行数据写入程序所在目录的 `data/` 文件夹。`plugins/ai_test` 提供手动 AI 验证插件,默认不开启/不自动加载。Release 二进制约 6.1MB。
|
|
|
|
## 手动验证
|
|
|
|
```bash
|
|
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`,未来实现插件自动加载时应默认跳过它。
|