create-yeow 0.4.1 → 0.4.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/package.json +1 -1
  2. package/templates/default/.yeow/assets/yeow-runtime-0.2.0.jar +0 -0
  3. package/templates/default/sitemap.md +7 -5
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-yeow",
3
- "version": "0.4.1",
3
+ "version": "0.4.3",
4
4
  "description": "Scaffold a Yeow plugin project",
5
5
  "type": "module",
6
6
  "bin": {
package/templates/default/sitemap.md CHANGED
@@ -20,14 +20,14 @@
20
20
  | 进阶 · 调度器与任务 | `https://yexin.wiki/yeow/v1/advanced/scheduler` | 三级优先级调度器（时间片预算/自动降级/空闲自旋）、任务配置（TaskOptions）、异步 vs 同步、手动分片、调度器设计（队列/降级算法/空队自旋） |
21
21
  | 进阶 · 事件与回调 | `https://yexin.wiki/yeow/v1/advanced/events` | 事件桥（EventBridge）：并发/串行、事件数据、处理器操作与模式选择、事件重入死锁 |
22
22
  | 进阶 · 生命周期与热重载 | `https://yexin.wiki/yeow/v1/advanced/lifecycle` | onInit/onLoad/onUnload、统一回调系统、热重载（强杀机制：原生中断 + 实体重建）、生产 /yeow reload/unload |
23
- | 进阶 · 环境能力与通道 | `https://yexin.wiki/yeow/v1/advanced/channels` | $_send/$send 封装、各消息通道说明（运行时配置指向 /operations） |
23
+ | 进阶 · 环境能力与通道 | `https://yexin.wiki/yeow/v1/advanced/channels` | $send 封装（底层桥 $_send 为内部实现，闭包持有不外露）、各消息通道说明（运行时配置指向 /operations） |
24
24
  | 进阶 · 服务机制 | `https://yexin.wiki/yeow/v1/advanced/service` | Plugin Service（插件间通信）与 Native Service（原生扩展）的机制（API 用法见 /api/service） |
25
25
  | 关于 Yeow | `https://yexin.wiki/yeow/v1/advanced/about` | 关于 Yeow |
26
26
  | 编写依赖包 | `https://yexin.wiki/yeow/v1/package-author` | 将共享逻辑与资源封装为 npm 依赖包：assets 命名空间、依赖项识别、构建自动处理（多副本共存/权限合并/native 清单） |
27
27
  | 封装 Service 的依赖包 | `https://yexin.wiki/yeow/v1/package-service` | 依赖包中封装 Service 的三种类型：SDK 调用封装 / JS 服务（全局唯一+降级）/ 原生服务（子进程），与"JS 门面 + 原生引擎"组合模式 |
28
28
  | 路线图 | `https://yexin.wiki/yeow/v1/todo` | v1 方向性规划：API/事件覆盖、调试工具、Folia 支持；Worker API 已实现 |
29
29
  | 索引（README） | `https://yexin.wiki/yeow/v1/` | 文档首页：快速上手命令、为什么用 Yeow（工程化/线程分离/平台无关/原生扩展）、对比表、文档与工具链索引 |
30
- | 更新日志 | `https://yexin.wiki/yeow/v1/changelog` | 按日期的更新记录（2026-08-11 起） |
30
+ | 更新日志 | `https://yexin.wiki/yeow/v1/changelog` | 按日期的更新记录（2026-08-08 起） |
31
31
 
32
32
  ## API 参考（/v1/api/）
33
33
 
@@ -55,12 +55,13 @@
55
55
  | Command | `https://yexin.wiki/yeow/v1/api/command` | 命令注册 + Tab 补全（含 yeow-command 重载式命令 Command.create 与模式化参数） |
56
56
  | ItemStack | `https://yexin.wiki/yeow/v1/api/item` | 物品纯数据描述符：type/amount/meta（显示名/附魔/耐久/染色/药水/头颅/属性修饰符）；构造工具（create/clone/equals）；值语义（快照，不绑定真实物品） |
57
57
  | Service | `https://yexin.wiki/yeow/v1/api/service` | 插件间服务（registerService/request/subscribe/publish）与原生服务（registerNativeService，spawn 子进程 + TCP 通信） |
58
- | HTTP | `https://yexin.wiki/yeow/v1/api/http` | 底层 HTTP 客户端：request（异步）/requestSync（同步阻塞）/fetch |
58
+ | HTTP | `https://yexin.wiki/yeow/v1/api/http` | 底层 HTTP 客户端：`request`（异步，请求/响应体二进制与 fs 同语义、encoding/timeout 可选）、全局 `fetch`（text/json 按需解码 + base64/bytes） |
59
59
  | HTTP Server | `https://yexin.wiki/yeow/v1/api/http-server` | 高层 `createServer`（yeow-server）：洋葱中间件、路由、mount/mountAssets 静态挂载、二进制响应（Uint8Array/encoding）、返回对象自动 JSON、资源包下载闭环 |
60
60
  | Worker | `https://yexin.wiki/yeow/v1/api/worker` | 虚拟插件（独立线程）：createWorker（仅注册）/load/unload/reload、双向 postMessage、Worker 侧 onMessage/postMessage；共享数据目录/权限、禁嵌套、/yeow 不覆盖 |
61
61
  | FS | `https://yexin.wiki/yeow/v1/api/fs` | 文件系统：plugin/server/outer 三级（路径安全）、读写/追加/二进制、目录操作、systemPaths、path 工具 |
62
62
  | Assets | `https://yexin.wiki/yeow/v1/api/assets` | 打包资源：`getAssetsPath`（yeow-dev，构建期注入命名空间）+ 读取/解压（单文件与目录） |
63
63
  | PDC | `https://yexin.wiki/yeow/v1/api/pdc` | 持久数据容器：JSON 自动序列化、全量读取、插件命名空间（跨插件不冲突）、Player/Block 实例方法 |
64
+ | Util | `https://yexin.wiki/yeow/v1/api/util` | 数据工具：gzip 压缩/解压、UTF-8 ↔ 字节转换（含分块流式 Gzip） |
64
65
  | Log | `https://yexin.wiki/yeow/v1/api/log` | 日志：`log`/`Logger`/`console`（自动插件名前缀） |
65
66
  | Text | `https://yexin.wiki/yeow/v1/api/text` | 文本与 MiniMessage：标记语法、转义规则（真实换行 vs 字面 `\n`）、Message 对象（可翻译组件 {key,args,text}） |
66
67
 
@@ -79,7 +80,7 @@
79
80
 
80
81
  | 页面 | URL | 摘要 |
81
82
  | --------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
82
- | 通道总览 | `https://yexin.wiki/yeow/v1/specifications/message/` | 全部通道索引（task/timer/fs/http/assets/lifecycle/log/env/debug/service/worker）+ 通用通道说明 |
83
+ | 通道总览 | `https://yexin.wiki/yeow/v1/specifications/message/` | 全部通道索引（task/timer/fs/http/assets/lifecycle/log/env/debug/service/util/worker）+ 通用通道说明 |
83
84
  | Task | `https://yexin.wiki/yeow/v1/specifications/message/task` | task 通道：游戏任务请求/响应格式、同步 vs 异步（cb）、错误格式 |
84
85
  | Timer | `https://yexin.wiki/yeow/v1/specifications/message/timer` | 定时器通道：timeout/interval 消息格式 |
85
86
  | FS | `https://yexin.wiki/yeow/v1/specifications/message/fs` | fs 通道：plugin/server/outer 三级、各操作（读写/删除/列出/base64/systemPaths）请求格式与路径规则 |
@@ -89,6 +90,7 @@
89
90
  | Log | `https://yexin.wiki/yeow/v1/specifications/message/log` | log 通道：日志消息格式 |
90
91
  | Lifecycle | `https://yexin.wiki/yeow/v1/specifications/message/lifecycle` | lifecycle 通道：unloadDone 确认、gc-collect 资源回收 |
91
92
  | Debug | `https://yexin.wiki/yeow/v1/specifications/message/debug` | debug 通道：reportError 错误上报、ping-pong 心跳 |
93
+ | Util | `https://yexin.wiki/yeow/v1/specifications/message/util` | util 通道：gzip 压缩/解压（一次性与流式分块）、UTF-8 ↔ 字节转换（encode.utf8/decode.utf8） |
92
94
  | Worker | `https://yexin.wiki/yeow/v1/specifications/message/worker` | worker 通道：create（仅注册）/load/unload/post/reload/postToMain 消息格式、生命周期、origin 错误字段、约束（禁嵌套/共享数据与权限） |
93
95
 
94
96
  ### 任务类型（/v1/specifications/task/）
@@ -126,6 +128,6 @@
126
128
  开始：概览 · 快速开始 · CLI 参考 · 构建与分发 · 运行时警告 · 路线图 · 站点地图
127
129
  进阶（默认折叠）：关于 Yeow · 进阶索引（架构/调度器/事件/生命周期/通道/服务/运维与安全）
128
130
  依赖包开发：编写依赖包
129
- API 参考：索引 → 玩家与服务器(Player/Server/Env) · 世界与方块(World/Chunk/Location/Block/Material) · 实体(Entity/Potion/Particle) · 交互界面(Inventory/BossBar/Scoreboard/Advancement/Recipe) · 事件与命令(Event/Command) · 物品(ItemStack) · 服务与网络(Service/HTTP/HTTP Server) · 多线程(Worker) · 文件与数据(FS/Assets/PDC) · 文本(Text) · 日志(Log)
131
+ API 参考：索引 → 玩家与服务器(Player/Server/Env) · 世界与方块(World/Chunk/Location/Block/Material) · 实体(Entity/Potion/Particle) · 交互界面(Inventory/BossBar/Scoreboard/Advancement/Recipe) · 事件与命令(Event/Command) · 物品(ItemStack) · 服务与网络(Service/HTTP/HTTP Server) · 多线程(Worker) · 文件与数据(FS/Assets/PDC/Util) · 文本(Text) · 日志(Log)
130
132
  平台规范：规范总览 → 消息通道 · 任务类型 · 事件 · 运行时 · 原生服务 · 适配器
131
133
  ```