ETAF

ETAF 是构建在独立 Ebox 布局与渲染引擎之上的小型文本应用框架。

完整的公共模型是：

Component(props, Scope) → View → Renderer → Ebox Node → Emacs buffer

所有可见结构都使用一种形式：

(name :property value ... child ...)

子节点中唯一的计算桥接是 expr :value；属性值则是普通 Elisp 表达式。

(etaf-view
 (column
  (text :font-weight 'bold "Hello")
  (text
   :color "#687386"
   (expr :value (if ready "Ready" "Waiting")))))

定义 Component：

(etaf-define-component status-label (&key label)
  "Render a status label."
  :view
  (text :font-weight 'bold (expr :value label)))

(etaf-mount
 "*etaf-demo*"
 (etaf-view (status-label :label "Connected")))

etaf-view 是唯一的公共 View 构造入口。结构 form 不使用 quote；quote 仍然是普通 Elisp 数据语法，例如 'bold。普通 Elisp 返回 View 时，必须在 expr 中显式使用 (etaf-view ...) 构造它。

性能记录面板

ETAF 提供一个独立、按需加载、与具体应用无关的性能记录器。它消费 Runtime 公共 observer 报告，不使用 advice 或私有跨包探针。Event、Action、mount、flush 和 unmount 等 Runtime operation 会自动记录；同一 operation 内的 Ebox、TP、Data、 Resource 和 SQLite 等 provider 阶段按 sequence 关联到同一条记录。

(require 'etaf-performance)
;; 在已挂载 ETAF Runtime 的 buffer 中：
(etaf-performance-mode 1)
;; 正常操作任意已挂载的 ETAF 应用。
(etaf-performance-show)

交互采集时先执行 M-x etaf-performance-clear，复现一组操作后，在面板按 c（或执行 M-x etaf-performance-copy-report）即可把完整报告复制到剪贴板；按 w（或执行 M-x etaf-performance-export）可保存为 .eld 文件。报告包含 Emacs/显示环境、电源来源、低功耗模式、native JIT 状态、系统负载、分组 p50/p95/max、每次 operation、GC 增量和有序 provider 阶段；面板 header 也显示同一环境信息，避免把整机降频误判成某个包的热点。

*ETAF Performance* 面板会显示 operation ID、generation 变化、总耗时、GC 增量，以及 flat provider 阶段的顺序和各自耗时。provider 阶段可能重叠，因此不会伪装成 exclusive/self 时间。记录数量由 etaf-performance-max-records 限制；关闭 mode 只会解除当前 Runtime 的 observer，不修改任何函数。 etaf-performance-summary 会按需计算 operation 的 p50/p95/max， etaf-performance-operation-stage-summary 则按 provider category 汇总单次 operation 的 flat 阶段。etaf-performance-records 返回 operation/stage 的防御性快照，调用方修改返回值不会改写已保留的历史。

没有内置公共边界的任意操作，可以使用 etaf-performance-call-operation 或 etaf-performance-with-operation 包裹；它们直接委托同一个 Runtime operation 边界，不建立第二套计时器。

可执行示例

examples/ 目录包含三个只依赖 core 的最佳实践应用：保留式状态与 Action、Data Controller 所有权，以及 Resource 错误/清理 lifecycle。make check 会编译它们，并通过已挂载的公开事件路径驱动交互。

(add-to-list 'load-path "/path/to/github/etaf/examples")
(require 'etaf-counter-example)
(etaf-counter-example-open)

文档

独立包

包	职责
`etaf-ui`	官方 Component 目录：Button、Checkbox、Label、Panel 和 DataGrid。
`etaf-sqlite`	具体 SQLite Data Source；Data Controller 仍属于 ETAF core。
`etaf-playground`	ETAF 示例；只有请求官方目录示例时才加载 UI 包。
`ebox-playground`	只使用 Ebox 的布局示例，与 ETAF 独立。

没有单独需要安装的 etaf-data：Data 是 ETAF 核心能力。也没有笼统的 etaf-adapters 包：其他数据库、服务、文件或 ORM 应使用明确名称的具体 Data Source 包实现同一契约。

加载与验证

先安装 ECSS 0.1.0 与 TP 2.0.0，再安装 Ebox 3.0.0，最后安装 ETAF 0.2.1。 ETAF 会直接声明 TP 依赖，因为 Host final-accept authority 使用 TP transaction contract。渲染要求 Ebox framework SPI v2；provider 缺失、格式错误或不兼容时， ETAF 会在 bootstrap 阶段 fail closed。

ETAF 为当前 Emacs 进程 snapshot 一个不可变的 v2 render port。按依赖顺序升级时，也接受 Ebox 过渡期的 TP 双能力 manifest，因为其中包含所需的 v2 协议；ETAF 不会调用已经退役的 v1 capability。

开发时先把同级 Ebox 检出目录加入 load-path：

(add-to-list 'load-path "/path/to/github/ebox")
(add-to-list 'load-path "/path/to/github/etaf")
(require 'etaf)

运行完整本地门禁：

make check EMACS=/Applications/Emacs.app/Contents/MacOS/Emacs

核心门禁会编译实现、运行 core/Data/Resource 测试，并检查文档和 API 边界。还应在同级 etaf-ui、etaf-sqlite、etaf-playground 和 ebox-playground 仓库分别运行 make check；它们都不会被 core facade 自动加载。

5.8 KiB Raw Blame History Unescape Escape

ETAF

性能记录面板

可执行示例

文档

独立包

加载与验证

5.8 KiB

Raw Blame History