docs: 更新README.md

This commit is contained in:
luke 2025-06-08 20:06:27 +08:00
parent 5ffc51d60a
commit bdc3455dd9
3 changed files with 40 additions and 9 deletions

View File

@ -1,5 +1,5 @@
<p align="center"> <p align="center">
<img src="doc/README/IMG/IMG_Snow_ICON.png" alt="Snow Icon"> <img src="doc/README/IMG/IMG_Snow_icon_128.svg" alt="Snow Icon">
<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">Snow编程语言</h1> <h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">Snow编程语言</h1>
<p align="center"> <p align="center">
@ -36,7 +36,7 @@ Snow 语言是一个正在发展的编程语言,采用类模块module
Snow 语言受到 LLM 驱动代码生成趋势的启发,强调简单而清晰的语法和严格的类型系统,以帮助人工智能模型更好地理解程序结构。语言使用显式的 `module` 声明来组织代码,用 `function`,`parameter`,`return_type`,`body` 等关键字分隔不同代码块,语法结构固定且易读。此外,Snow 实现了语义分析来检查变量作用域和类型一致性,在编译阶段捕获错误并确保生成的中间代码正确无误。这种自上而下的编译流程,使得代码设计和生成更加模块化,可解释,也有利于调试和优化。 Snow 语言受到 LLM 驱动代码生成趋势的启发,强调简单而清晰的语法和严格的类型系统,以帮助人工智能模型更好地理解程序结构。语言使用显式的 `module` 声明来组织代码,用 `function`,`parameter`,`return_type`,`body` 等关键字分隔不同代码块,语法结构固定且易读。此外,Snow 实现了语义分析来检查变量作用域和类型一致性,在编译阶段捕获错误并确保生成的中间代码正确无误。这种自上而下的编译流程,使得代码设计和生成更加模块化,可解释,也有利于调试和优化。
相关背景: [心路历程](doc/Snow%20心路历程/Snow%20心路历程.md) 相关背景: [心路历程](doc/Snow's-Journey/Snow's-Journey.md)
## 下载Snow发行版 ## 下载Snow发行版
@ -70,7 +70,7 @@ Snow 语言受到 LLM 驱动代码生成趋势的启发,强调简单而清晰的
使用IDEA配置好的运行配置SnowCompiler 使用IDEA配置好的运行配置SnowCompiler
![IMG_运行配置文件_1.png](doc/README/IMG/IMG_%E8%BF%90%E8%A1%8C%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6_1.png) ![IMG_运行配置文件_1.png](doc/README/IMG/IMG_Run-Profile_1.png)
4. **运行成功** 4. **运行成功**
@ -325,6 +325,12 @@ end module
* `io/`:输入输出辅助类(加载指令,文件解析等) * `io/`:输入输出辅助类(加载指令,文件解析等)
* 其他如 `factories/`,`utils/` 等目录包含指令创建和调试工具类 * 其他如 `factories/`,`utils/` 等目录包含指令创建和调试工具类
## 相关文档
[Git 管理规范](doc/Git-Management/Git-Management.md)
## 开发计划 / TODO ## 开发计划 / TODO
* 扩展标准库支持和更多内置模块,如字符串,文件操作等常用功能。 * 扩展标准库支持和更多内置模块,如字符串,文件操作等常用功能。
@ -333,6 +339,6 @@ end module
* 增加更多示例程序试,丰富项目文档和用例。 * 增加更多示例程序试,丰富项目文档和用例。
## 加入我们 ## 加入我们
* 微信: xuxiaolankaka * 微信: `xuxiaolankaka`
* QQ: 1399528359 * QQ: `1399528359`
* E-Mail: luke.k.xu@hotmail.com * E-Mail: `luke.k.xu@hotmail.com`

View File

@ -1,6 +1,31 @@
使用 build——project2tar.ps1 需要在管理员权限下的 PowerShell 输入下面的内容 ### 使用 `build-project2tar.ps1` 脚本
``` 在执行 `build-project2tar.ps1` 脚本之前,您需要确保 PowerShell 的执行策略允许运行脚本。默认情况下PowerShell 可能阻止未签名的脚本执行。因此,您需要设置适当的执行策略。
#### 步骤 1以管理员身份打开 PowerShell
* 在 Windows 系统中,搜索 **PowerShell**,右键点击 **Windows PowerShell**,并选择 **以管理员身份运行**
#### 步骤 2设置 PowerShell 执行策略
为了允许执行 PowerShell 脚本,您需要调整当前用户的执行策略。输入以下命令并按 Enter
```powershell
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
``` ```
Tip:RemoteSigned 表示:本地创建的脚本可以运行,从互联网下载的脚本必须有签名。
#### 解释:
* `-Scope CurrentUser`:此参数指定该执行策略仅对当前用户有效,而不会影响系统范围内的其他用户。
* `-ExecutionPolicy RemoteSigned`:此策略表示:
* 本地创建的脚本可以直接运行。
* 从互联网下载的脚本必须具备有效的数字签名才能运行。没有签名的脚本将无法执行,除非您先解除阻止该脚本。
#### 步骤 3运行 `build-project2tar.ps1` 脚本
设置完成后,您可以在 PowerShell 中运行 `build-project2tar.ps1` 脚本。确保您已经切换到包含该脚本的目录,或提供完整的文件路径来执行它。
```powershell
.\build-project2tar.ps1
```