@twinsearth/dsh-2xray 0.3.1 → 0.3.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.3.3 — 2026-10-29
+
+### 健康检查与发布
+
+- 新增鉴权端点 `GET /api/xray/healthz`：返回 `v0.3.3`、运行状态与路由接管状态。
+- Release 增加公开静态资产 `healthz.json`（`version: v0.3.3`），供部署流水线探针使用。
+- 包含 0.3.1 的端口护栏与 geodata 降级修复（0.3.2 未单独发布）。
+
 ## 0.3.1 — 2026-10-29
 
 ### 修复

package/README.md

@@ -334,6 +334,11 @@ v0.2.0 提供两个入口，互不替代：
 
 维护者用 `tools/build-core-packages.mjs` 从官方 zip 生成平台包；`.github/workflows/core-packages.yml` 会在具备 `NPM_TOKEN` secret 时自动下载、校验并发布各平台包。
 
+## 健康检查
+
+- 进程内（需 DSH 会话鉴权）：`GET /api/xray/healthz` → `{ "ok": true, "version": "v0.3.3", ... }`
+- 发布物（公开、静态）：Release 资产 `healthz.json`，`version` 与 tag 一致，可用于部署流水线的健康探针。
+
 ## 更新
 
 设置页 2Xray 里有三个入口：

package/index.js

@@ -233,6 +233,25 @@ export function apply(ctx, rawConfig) {
             }),
           'dsh-2xray: update api',
         )
+        child.effect(
+          () =>
+            child.connection.fetch.register({
+              path: '/api/xray/healthz',
+              methods: ['GET'],
+              fetch: () => {
+                const snapshot = supervisor.snapshot()
+                return Response.json({
+                  ok: true,
+                  service: 'dsh-2xray',
+                  version: `v${updateState.current}`,
+                  state: snapshot.state,
+                  ready: snapshot.state === 'ready',
+                  routeInstalled: snapshot.route?.installed === true,
+                })
+              },
+            }),
+          'dsh-2xray: healthz api',
+        )
       } catch (error) {
         logger.warn(`状态 API 注册失败：${String(error)}`)
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@twinsearth/dsh-2xray",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "private": false,
   "description": "DSH-2Xray: supervises xray-core and routes DSH process-wide HTTP(S) traffic through its local inbound, with optional multi-node gRPC control plane",
   "type": "module",