# 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 绑定和类型转换开销, 可在所有平台保持行为一致性
- 用户友好: lisp 语法极其简单, 用户无需构造内核内部数据结构便可使用数学语言便捷地描述任意算法

## 项目会取代 Python 版本吗?

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

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