HeurAMS-Core/README.md

HeurAMS-Core

自包含、可移植、可扩展、高性能的间隔重复调度程序内核, 使用受限制的 TypeScript 实现, 用于取代旧版 Python 内核并直接用于多前端平台.

项目写的是哪种 TypeScript?

具体地说, 是 ArkTS 风格约束的 TypeScript 严格子集方言, 具体地说, 它:

• 兼容, 但不是 标准 TypeScript: 禁用 any、eval、Proxy、动态属性等
• 兼容, 但不是 ArkTS, Node.JS 或任何一种运行时方言: 不依赖平台专有的接口, 亦不依赖任何外部包管理器

它是 TypeScript 的一个严格且可静态分析的子集, 目标是:

• 高性能: 对象形状固定, 类型稳定, 利于 JIT/AOT 优化
• 类型安全: 禁用所有绕过类型系统的逃逸舱口
• 运行时安全: 禁用所有运行时代码解释注入与执行操作, 如 eval
• 零依赖移植: 通过依赖注入抽象平台 API, 并内置 (vendor) 或实现所有所需第三方库
• 多平台支持: 拥有编译后在 Flutter, ArkTS, Qt, Python (micro-javascript) 及任何支持 ECMAScript 2020+ 的环境中嵌入并运行的能力

为什么使用 lisp 扩展?

这个想法来源于 emacs 的设计: 数据驱动扩展核心功能

不同于传统的插件系统或 "猴子补丁" 式脚本绑定, 我们采用 lisp 方言及 S-表达式作为克制且优雅的算法调度器扩展接口, 它带来了如下好处:

• 声明式配置: 所有扩展规则与策略均以数据形式表达, 而非命令式代码, 天然适合描述调度策略
• 安全隔离: lisp 调用内核 API 以描述调度策略与算法, 不包含可执行代码, 可防止代码注入攻击
• 轻量一致: lisp 解释器易于实现且开销轻量, 避免了复杂的 API 绑定和类型转换开销, 可在所有平台保持行为一致性
• 用户友好: 无需构造内核内部数据结构, 可使用数学语言便捷地描述任意算法

项目会取代 Python 版本吗?

会取代的部分:

• 在内核上, TypeScript 版本会完全取代 Python 版本
• 未来, 以及当下的客户端实现 (基本用户界面, KiriMemo, ArkMemo, HeurStudio, 以及可能的 Web 端等) 都将基于 HeurAMS-Core, 而不是 Python 版本内核
• eval 字符串 API 规范将变成更安全的格式实现, 而 Python 版内核将被完全弃用

不会取代的部分:

• Python 的 Textual TUI 前端不会被 TypeScript 重写: Textual 是优秀的 TUI 框架, 届时 Python 版本将变成一个 Textual 前端, 并兼容此前的 HeurAMS TUI 版本