end

README.txt

@@ -1,9 +1,3 @@
-sqrtools-pre
+v3 正式版出了。
 
-sqrtools 是开始于 2022 年的名字竞技场转换器项目。从 24m03a 开始，新版本将不再主要维护现有 REPL 转换器并以 "名竞算号代码打包" 作为其新的开发目标。
-
-目前，sqrtools 的接口还处于测试阶段。此 repo 会更新一些 API 文档等内容。
-
-请注意，sqrtools 的主要设计应用场合为日常战队管理与自制小工具，其代码未经任何优化，不适合用作测号器。本仓库不包含任何代码和有稳定性保证的可执行文件，请前往 sqrt2802.pages.dev/sqrtools/ 了解最新发布内容。
-
-你可以在 sqrt2802.pages.dev/sqrtools/docs/ 查看本仓库中文档的线上版本。
+github.com/sqrt2802/sqrtools

docs.md

@@ -2,7 +2,7 @@
 
 sqrtools 的接口调用指南。
 
-当前 API 版本：**3**
+当前 API 版本：**4**
 
 ------
 
@@ -31,13 +31,13 @@ sqrtools 的主要功能是名为 `Name` 的 python 类。
 
 id|0|1|2|3|4|5|6|7|8|9|
 :-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:
-技能|火球术|冰冻术|雷击术|地裂术|吸血攻击|投毒|连击|会心一击|瘟疫|生命之轮
+技能|火球|冰冻|雷击|地裂|吸血|投毒|连击|会心|瘟疫|命轮
 **id**|**10**|**11**|**12**|**13**|**14**|**15**|**16**|**17**|**18**|**19**
-技能|狂暴术|魅惑|加速术|减速术|诅咒|治愈魔法|苏生术|净化|铁壁|蓄力
+技能|狂暴|魅惑|加速|减速|诅咒|治愈|苏生|净化|铁壁|蓄力
 **id**|**20**|**21**|**22**|**23**|**24**|**25**|**26**|**27**|**28**|**29**
-技能|聚气|潜行|血祭|分身|幻术|防御|守护|伤害反弹|护身符|护盾
+技能|聚气|潜行|血祭|分身|幻术|防御|守护|反弹|护符|护盾
 **id**|**30**|**31**|**32**|**33**|**34**|**35**|**36**|**37**|**38**|**39**|
-技能|反击|吞噬|召唤亡灵|垂死抗争|隐匿|(空技能)|(空技能)|(空技能)|(空技能)|(空技能)
+技能|反击|吞噬|亡灵|垂死|隐匿|(空技能)|(空技能)|(空技能)|(空技能)|(空技能)
 
 #### Name 类型方法
 
@@ -88,3 +88,11 @@ name.reusable=True
 ```
 
 Reusable 模式允许你重复使用一个 `Name` 变量，但名字加载锁仍然存在，非法操作会被自动阻止。在你对变量载入新的字符串后，名字加载锁会重置。
+
+#### NameDev 扩展类
+
+`NameDev` 是提供给有进阶需求玩家的扩展类型。此类型对外暴露更多的数据属性，并具有适配加成计算的 `namebonus` 和 `calcprops(info)`。`NameDev` 的 `calcprops(info)` 需要一个数组参数 `info`。对于单个号的计算，这一参数应为对应的 `namebase`；计算加成时，可根据需要传入其他名字的相关数值。
+
+与 `Name` 相比，`NameDev` 不受名字加载锁的限制，但非法操作仍会造成未定义的行为或出现错误，请谨慎使用。
+
+`NameDev` 的 `load()`, `calcprops()` 和 `calcskill()` 不会返回任何值。