HeurAMS-Core/README.md

HeurAMS-Core

自包含、可移植、高性能的 HeurAMS 通用类型化内核, 使用受限制的 TypeScript 实现, 用于取代旧版 Python 内核并直接用于多前端平台.

项目写的是哪种 TypeScript?

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

• 兼容, 但不是 标准 TypeScript: 禁用 any、eval、Proxy、动态属性等
• 兼容, 但不是 HarmonyOS ArkTS: 不依赖 HarmonyOS UI 扩展, 不依赖 ohos 平台 API
• 兼容, 但不是 Node.JS: 不依赖其提供的专有 API
• 兼容, 但不使用 npm: 不依赖任何外部包管理器
• 不兼容, 且不是 AssemblyScript: 依赖动态数组与闭包, 动态分配

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

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

为什么使用 lisp 扩展?

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

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

• 声明式配置: 所有扩展规则与策略均以数据形式表达, 而非命令式代码, 天然适合描述调度策略
• 统一数据模型: 内核直接解释 lisp 扩展, 避免了复杂的 API 绑定和类型转换开销
• 安全隔离: lisp 描述表达式, 而不包含可执行代码, 可防止代码注入攻击
• 跨平台一致: lisp 解释器易于实现, 在所有目标平台上都有原生支持, 以便保持行为一致性

项目会取代 Python 版本吗?

会取代的部分:

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

不会取代的部分:

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