# Natasha
**Repository Path**: lanicon_admin/Natasha
## Basic Information
- **Project Name**: Natasha
- **Description**: 基于 Roslyn 的 C# 动态程序集构建库，该库允许开发者在运行时使用 C# 代码构建域 / 程序集 / 类 / 结构体 / 枚举 / 接口 / 方法等，使得程序在运行的时候可以增加新的模块及功能。Natasha 集成了域管理/插件管理，可以实现域隔离，域卸载，热拔插等功能。 该库遵循完整的编译流程，提供完整的错误提示， 可自动添加引用，完善的数据结构构建模板让开发者只专注于程序集脚本的编写，兼容 stanadard2.0 / netcoreapp3.0+, 跨平台，统一、简便的链式 API。 且我们会尽快修复您的问题及回复您的 issue.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 4
- **Forks**: 0
- **Created**: 2021-03-29
- **Last Updated**: 2024-11-30
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
中文 |
English
你们的反馈是我的动力，文档还有很多不足之处；
当你看完文档之后仍然不知道如何实现你的需求，您可以查看 FAQ 或者在issue中提出你的需求。
# Natasha
[](https://github.com/dotnetcore)
[](https://www.nuget.org/packages/DotNetCore.Natasha.CSharp.All)
[](https://gitter.im/dotnetcore/Natasha?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
[](https://996.icu/#/zh_CN)
[](https://github.com/dotnetcore/Natasha/blob/master/LICENSE)
基于 [Roslyn](https://github.com/dotnet/roslyn) 的 C# 动态程序集构建库，该库允许开发者在运行时使用 C# 代码构建域 / 程序集 / 类 / 结构体 / 枚举 / 接口 / 方法等，使得程序在运行的时候可以增加新的模块及功能。Natasha 集成了域管理/插件管理，可以实现域隔离，域卸载，热拔插等功能。 该库遵循完整的编译流程，提供完整的错误提示， 可自动添加引用，完善的数据结构构建模板让开发者只专注于程序集脚本的编写，兼容 netcoreapp2.0+ / netcoreapp3.0+, 跨平台，统一、简便的链式 API。 且我们会尽快修复您的问题及回复您的 [issue](https://github.com/dotnetcore/Natasha/issues/new).
[更多的动图展示](https://github.com/dotnetcore/Natasha/blob/master/docs/zh/gif.md)
### 类库信息(Library Info)
[](https://github.com/dotnetcore/Natasha/releases)  [](https://github.com/dotnetcore/Natasha/commits/master) [](https://codecov.io/gh/dotnetcore/Natasha)
| Script | .NET Env | Document |
| ------ | -------- | -------- |
|  |    | [](https://natasha.dotnetcore.xyz/) |
| CI Platform | Build Server | Master Build |
|--------- |--------- |---------|
| Github || [](https://github.com/dotnetcore/Natasha/actions) |
| Azure | | [](https://dev.azure.com/NightMoonStudio/Natasha/_build/latest?definitionId=3&branchName=master)|
| Azure | |[](https://dev.azure.com/NightMoonStudio/Natasha/_build/latest?definitionId=3&branchName=master)|
| Azure || [](https://dev.azure.com/NightMoonStudio/Natasha/_build/latest?definitionId=3&branchName=master)|
### 使用方法(User Api)：
| 顺序 | 操作行为 | 操作内容 | 说明 |
|-- |-------- |--------------| --------|
| 1 | 引类库 | DotNetCore.Natasha.CSharp.All | 该页面提供最新版操作，[旧版详见](https://github.com/dotnetcore/Natasha/tree/v3.0+final) |
| 2 | 初始化 | NatashaInitializer.InitializeAndPreheating(); / Initialize(); | 预热会慢一点，后面编译就快了，也可以只初始化不预热 |
| 3 | 写代码 | 使用说明 [https://natasha.dotnetcore.xyz/](https://natasha.dotnetcore.xyz/) | 可联系作者: 1648107003@qq.com 或 [查看FAQ](https://github.com/dotnetcore/Natasha/blob/master/docs/FAQ.md) 或 [提出问题](https://github.com/dotnetcore/Natasha/issues/new) |
### 发布日志
- 2019年发布日志 [[已归档]](https://github.com/dotnetcore/Natasha/blob/master/docs/zh/update/2019.md)
- 2020年发布日志 [[已归档]](https://github.com/dotnetcore/Natasha/blob/master/docs/zh/update/2020.md)
- 2021年发布日志 [[进行中]](https://github.com/dotnetcore/Natasha/blob/master/docs/zh/update/2021.md)
### 生态周边
| 项目名称 | 项目地址 | 项目简介 |
|------------- |-----------| --------|
| NatashaPad | [Github](https://github.com/night-moon-studio/NatashaPad) | 由 Roslyn 和 Natasha 支持的另一种dotnet调试工具，如 LinqPad 和 dotnet fiddle。 |
| Leo | [Github](https://github.com/night-moon-studio/NCaller) | 基于 Natasha 和 查找树算法的高速反射类，可以操作对象的属性以及字段。 |
| DeepClone | [Github](https://github.com/night-moon-studio/DeepClone) | 由 Natasha 的高性能深度克隆库。 |
| BTFindTreee | [Github](https:https://github.com/dotnet-lab/BTFindTreee) | 快速查找算法的构建，包括哈希二分查找，字串模糊查找，字串归并精确查找。 |
| Papper | [Github](https:https://github.com/dotnet-lab/Papper) | 对语法树解析库，主要目标时服务于 SG(Source Generator)技术。 |
| RuntimeToDynamic | [Github](https://github.com/night-moon-studio/RuntimeToDynamic) | 将运行时数据压入到动态代理类中，以方便其他动态构建时对其进行复用。|
| DynamicDictionary | [Github](https://github.com/night-moon-studio/DynamicCache) | 高速动态缓存，在只读并发场景中提供超高性能的数据查找功能。|
| Aries | [Github](https://github.com/night-moon-studio/Aries) | 对 FreeSql 的高度封装，提供高性能、直观的 外联 / 乐观锁 / CURD 操作。|
### 开发计划
#### 2.0+ 计划
- [ ] 编写英文文档，以后将以英文文档为主
- [x] 调研 .NET6 中性能优化的新特性
- [ ] 完善 UT 测试
- [ ] 挣钱, 生存下来
#### 周边项目计划
- [ ] BTF 算法
- [ ] 每周定时跑算法随机测试程序
- [x] 持续评估 `span` 序列比较方法 及 指针转换比较 的性能
- [ ] 评估 Trie 及变种 与 BTF 算法的性能差距
- [ ] 元数据
- [ ] 优化性能
- [x] 精确解析
- [x] 持续评估封装架构的设计方案
- [ ] 改造 [Leo](https://github.com/night-moon-studio/Leo)
- [x] 持续优化性能
- [x] 私有支持
- [ ] 评估是否支持 AOP
- [x] 评估 [Leo](https://github.com/night-moon-studio/Leo) 代理方式 和 [DynmaicDictionary](https://github.com/night-moon-studio/DynmaicDictionary) 代理方式 在 R2D 模板下的异同及抽象
- [x] 优化静态自动机代码
- [x] 使用委托指针优化性能
- [ ] 依赖还原库
- [ ] NET 模块
- [ ] NUGET 模块
- [ ] FOLDER SCAN 模块
- [ ] 跨平台 模块
- [ ] 定制语法/语法糖 to Natasha
- [ ] 持续评估 Natasha 在灵活授权模型上的应用
- [ ] 持续搜集反编译的需求
- [ ] 调研 JAVA to C#
- [ ] 调研 GO to C#
- [ ] 考虑要不要调研 PHP to C#
- [ ] 谁能来帮我一起搞，帮我点上左边的小对号？
> 欢迎大家提交PR
### 性能测试
- [x] **动态初始化性能测试（对照组： emit, origin）**
- [x] **内存及CPU监测截图**
### 赞助：
#### 捐助明细
- ****天下 10元
- 文航 5元
- TonyQu 10元
---------------------
## License
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fdotnetcore%2FNatasha?ref=badge_large)