dsh-git-push 2.8.6 → 2.9.1

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 (38) hide show
  1. package/README.md +18 -3
  2. package/assets/minihost.sh +35 -0
  3. package/assets/preview.html +36703 -0
  4. package/assets/start.sh +396 -0
  5. package/assets/tree-sitter/LICENSE +21 -0
  6. package/assets/tree-sitter/README.md +69 -0
  7. package/assets/tree-sitter/VERSIONS.txt +1 -0
  8. package/assets/tree-sitter/tree-sitter-javascript.wasm +0 -0
  9. package/assets/tree-sitter/tree-sitter-python.wasm +0 -0
  10. package/assets/tree-sitter/tree-sitter-typescript.wasm +0 -0
  11. package/assets/tree-sitter/tree-sitter.js +3980 -0
  12. package/assets/tree-sitter/tree-sitter.wasm +0 -0
  13. package/lib/app/apply.js +15 -2
  14. package/lib/app/command-registry.js +1 -1
  15. package/lib/app/handlers/workspace-paths.js +107 -0
  16. package/lib/app/http-handlers.js +19 -2
  17. package/lib/app/inject-text.js +1 -1
  18. package/lib/app/tool-call.js +25 -1
  19. package/lib/ast/code-lines.js +52 -0
  20. package/lib/ast/index.js +1 -1
  21. package/lib/ast/tokenizer.js +7 -2
  22. package/lib/ast/treesitter.js +208 -0
  23. package/lib/audit/audit-file.js +3 -3
  24. package/lib/audit/orchestrate.js +38 -0
  25. package/lib/audit-rules/audit-rules-nodejs.yml +2 -2
  26. package/lib/audit-rules/audit-rules-paths.yml +1 -1
  27. package/lib/audit-rules/audit-rules-performance.yml +7 -3
  28. package/lib/checks/dispatch.js +3 -3
  29. package/lib/checks/regex.js +19 -4
  30. package/lib/core/workspace-paths.js +100 -0
  31. package/lib/rule/registry.js +7 -0
  32. package/lib/self/index.js +1 -1
  33. package/lib/user-requirements.json +2 -1
  34. package/package.json +2 -1
  35. package/scripts/sync-plugin-install.mjs +84 -21
  36. package/scripts/sync-plugin.mjs +14 -9
  37. package/skills/guide/guide-cli-scripts.md +1 -1
  38. package/skills/guide/guide-commit-push.md +33 -0
@@ -0,0 +1,396 @@
1
+ #!/usr/bin/env bash
2
+ # ============================================================
3
+ # dsh-git-push 预览服务器启停脚本(模板源:bench-template/server/lib/preview/start.sh,下发改自用)
4
+ # 用法:
5
+ # ./start.sh start [--port PORT]
6
+ # ./start.sh restart [--port PORT] # 默认命令
7
+ # ./start.sh stop
8
+ # ./start.sh status
9
+ # ./start.sh --port PORT # 兼容旧用法(等价 restart)
10
+ # PID:插件根 / dsh-git-push.pid(见 pid-file-at-project-root)
11
+ # ============================================================
12
+ set -uo pipefail
13
+
14
+ # 脚本落在 assets/;ROOT 上溯到插件根
15
+ ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
16
+ PROJECT_NAME="$(basename "$ROOT")"
17
+ # 预览服务入口:scripts/preview-server.mjs(2026-10-13 合并后单入口;--local/--shot/--direct 均在其内部)
18
+ # 服务工作目录仍取脚本所在目录(assets/),入口用绝对路径调用,与 cwd 无关。
19
+ SERVER_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
20
+ SERVER_ENTRY="$ROOT/scripts/preview-server.mjs"
21
+ PID_FILE="$ROOT/${PROJECT_NAME}.pid"
22
+ LOG_FILE="$SERVER_DIR/preview-server.log"
23
+ DEFAULT_PORT="${DEFAULT_PORT:-30999}"
24
+ LOG_ROTATE_BYTES=$((10 * 1024 * 1024))
25
+ STOP_WAIT_SEC=10
26
+ START_WAIT_SEC="${START_WAIT_SEC:-15}"
27
+
28
+ # ---------- 颜色 ----------
29
+ C_GREEN="" C_YELLOW="" C_RED="" C_DIM="" C_RESET=""
30
+ if [ -t 1 ] && [ -z "${NO_COLOR:-}" ] && [ "${TERM:-}" != "dumb" ]; then
31
+ C_GREEN=$'\033[32m'
32
+ C_YELLOW=$'\033[33m'
33
+ C_RED=$'\033[31m'
34
+ C_DIM=$'\033[2m'
35
+ C_RESET=$'\033[0m'
36
+ fi
37
+ ok() { printf '%s%s%s\n' "$C_GREEN" "$*" "$C_RESET"; }
38
+ warn() { printf '%s%s%s\n' "$C_YELLOW" "$*" "$C_RESET"; }
39
+ err() { printf '%s%s%s\n' "$C_RED" "$*" "$C_RESET"; }
40
+ dim() { printf '%s%s%s\n' "$C_DIM" "$*" "$C_RESET"; }
41
+
42
+ # 历史 PID 位置(迁移兼容)
43
+ legacy_pid_files() {
44
+ printf '%s\n' \
45
+ "$SERVER_DIR/app.pid" \
46
+ "$SERVER_DIR/${PROJECT_NAME}.pid" \
47
+ "/tmp/${PROJECT_NAME}.pid" \
48
+ "/tmp/start-${PROJECT_NAME}.pid"
49
+ }
50
+
51
+ # ---------- Node 定位(独立可搬运,内联不 source)----------
52
+ find_node() {
53
+ local c nvm
54
+ for c in \
55
+ "$ROOT/tool/node/bin/node" \
56
+ /usr/local/bin/node \
57
+ /opt/homebrew/bin/node \
58
+ /opt/node/bin/node \
59
+ /var/packages/Node.js_v24/target/usr/local/bin/node \
60
+ /var/packages/Node.js_v22/target/usr/local/bin/node \
61
+ /var/packages/Node.js_v20/target/usr/local/bin/node \
62
+ /var/packages/DeepSeekHarness-NAS/target/bin/node \
63
+ node; do
64
+ if [ -x "$c" ]; then NODE_BIN="$c"; return 0; fi
65
+ if command -v "$c" >/dev/null 2>&1; then NODE_BIN="$(command -v "$c")"; return 0; fi
66
+ done
67
+ for nvm in "$HOME"/.nvm/versions/node/*/bin/node; do
68
+ if [ -x "$nvm" ]; then NODE_BIN="$nvm"; return 0; fi
69
+ done
70
+ return 1
71
+ }
72
+
73
+ if ! find_node; then
74
+ err "❌ 找不到 node。请安装 Node.js,或把官方二进制解压到 tool/node/"
75
+ exit 1
76
+ fi
77
+ ok "✓ Node: $NODE_BIN ($("$NODE_BIN" -v 2>/dev/null))"
78
+
79
+ file_size() {
80
+ local f="$1"
81
+ [ -f "$f" ] || { echo 0; return; }
82
+ stat -c%s "$f" 2>/dev/null || stat -f%z "$f" 2>/dev/null || wc -c < "$f"
83
+ }
84
+
85
+ human_size() {
86
+ local n="$1"
87
+ if [ "$n" -ge 1048576 ]; then awk -v n="$n" 'BEGIN{printf "%.1fMB", n/1048576}'; else awk -v n="$n" 'BEGIN{printf "%.1fKB", n/1024}'; fi
88
+ }
89
+
90
+ # ---------- token 解析:DSH_PREVIEW_TOKEN env > DSH_HOME 上级 DeepSeekHarness-NAS.log 最新 token ----------
91
+ resolve_token() {
92
+ if [ -n "${DSH_PREVIEW_TOKEN:-}" ]; then printf '%s' "$DSH_PREVIEW_TOKEN"; return 0; fi
93
+ local dsh_home="${DSH_HOME:-}"
94
+ [ -n "$dsh_home" ] || dsh_home="$HOME/.dsh"
95
+ local log_file="$dsh_home/../DeepSeekHarness-NAS.log"
96
+ if [ -f "$log_file" ]; then
97
+ grep -o 'token=[a-zA-Z0-9_-]\{20,\}' "$log_file" 2>/dev/null | tail -n1 | sed 's/^token=//'
98
+ return 0
99
+ fi
100
+ return 0 # 找不到就空,预览服务(scripts/preview-server.mjs)内部还有兜底
101
+ }
102
+
103
+ # ---------- 端口工具 ----------
104
+ port_in_use() {
105
+ local port="$1" out=""
106
+ if command -v ss >/dev/null 2>&1; then
107
+ out="$(ss -tln 2>/dev/null)"
108
+ elif command -v netstat >/dev/null 2>&1; then
109
+ out="$(netstat -tln 2>/dev/null)"
110
+ fi
111
+ [ -n "$out" ] || return 1
112
+ printf '%s\n' "$out" | awk -v p="$port" '
113
+ $4 ~ ("[.:]" p "$") { found = 1; exit }
114
+ END { exit(found ? 0 : 1) }'
115
+ }
116
+
117
+ port_pids() {
118
+ local port="$1" out=""
119
+ if command -v ss >/dev/null 2>&1; then
120
+ out="$(ss -tlnp 2>/dev/null | awk -v p="$port" '$4 ~ ("[.:]" p "$") {print}')"
121
+ elif command -v netstat >/dev/null 2>&1; then
122
+ out="$(netstat -tlnp 2>/dev/null | awk -v p="$port" '$4 ~ ("[.:]" p "$") {print}')"
123
+ fi
124
+ [ -n "$out" ] || return 0
125
+ printf '%s\n' "$out" | grep -o 'pid=[0-9]*' | cut -d= -f2
126
+ printf '%s\n' "$out" | awk '{n=split($NF,a,"/"); if (n>1 && a[1] ~ /^[0-9]+$/) print a[1]}'
127
+ }
128
+
129
+ wait_port_free() {
130
+ local port="$1" timeout="${2:-10}" i=0
131
+ while [ "$i" -lt "$((timeout * 2))" ]; do
132
+ port_in_use "$port" || return 0
133
+ sleep 0.5
134
+ i=$((i + 1))
135
+ done
136
+ return 1
137
+ }
138
+
139
+ listen_line() {
140
+ local port="$1"
141
+ if command -v ss >/dev/null 2>&1; then
142
+ ss -tln 2>/dev/null | awk -v p=":$port" '$0 ~ p {print; exit}'
143
+ elif command -v netstat >/dev/null 2>&1; then
144
+ netstat -tln 2>/dev/null | awk -v p=":$port" '$0 ~ p {print; exit}'
145
+ fi
146
+ }
147
+
148
+ pid_alive() {
149
+ local p="$1"
150
+ [ -n "$p" ] && kill -0 "$p" 2>/dev/null
151
+ }
152
+
153
+ read_pid_file() {
154
+ local f="$1"
155
+ [ -f "$f" ] && [ -s "$f" ] || return 1
156
+ tr -d ' \t\r\n' < "$f"
157
+ }
158
+
159
+ collect_live_pids() {
160
+ # 2026-09-20 修:端口必须随调用方实际端口走(--port 覆盖时查 DEFAULT_PORT 会抓错
161
+ # 别的项目同端口进程 → 误报「已在运行」)。缺省仍用 DEFAULT_PORT 兼容旧调用。
162
+ local f p seen=" " port="${1:-$DEFAULT_PORT}"
163
+ for f in "$PID_FILE" $(legacy_pid_files); do
164
+ p="$(read_pid_file "$f" 2>/dev/null || true)"
165
+ if pid_alive "$p"; then
166
+ case "$seen" in
167
+ *" $p "*) ;;
168
+ *) seen="$seen$p "; printf '%s\n' "$p" ;;
169
+ esac
170
+ fi
171
+ done
172
+ local lp
173
+ lp="$(port_pids "$port")"
174
+ for p in $lp; do
175
+ case "$seen" in
176
+ *" $p "*) ;;
177
+ *) seen="$seen$p "; printf '%s\n' "$p" ;;
178
+ esac
179
+ done
180
+ }
181
+
182
+ rotate_log() {
183
+ [ -f "$LOG_FILE" ] || return 0
184
+ local sz
185
+ sz="$(file_size "$LOG_FILE")"
186
+ [ "$sz" -gt "$LOG_ROTATE_BYTES" ] || return 0
187
+ local ts dest
188
+ ts="$(date +%Y%m%d-%H%M%S)"
189
+ dest="${LOG_FILE}.${ts}"
190
+ mv "$LOG_FILE" "$dest" || return 0
191
+ if command -v gzip >/dev/null 2>&1; then
192
+ gzip -f "$dest" && dest="${dest}.gz"
193
+ fi
194
+ warn "⚠️ 日志超过 10MB,已轮转: $dest ($(human_size "$sz"))"
195
+ }
196
+
197
+ start_server() {
198
+ # --port 覆盖时全局 PORT 已在 main 入口解析(stop/restart/status 同端口语义),
199
+ # 这里保留原内联解析兜底(兼容直接调用函数),但统一用全局 PORT。
200
+ local port_opt=""
201
+ while [ $# -gt 0 ]; do
202
+ case "$1" in
203
+ --port) port_opt="${2:-}"; shift 2 ;;
204
+ *) shift ;;
205
+ esac
206
+ done
207
+ local port="${PORT:-${port_opt:-$DEFAULT_PORT}}"
208
+ local live
209
+ live="$(collect_live_pids "$port" | head -n 1 || true)"
210
+ if [ -n "$live" ]; then
211
+ warn "⚠️ 已在运行 (PID $live, 端口 $port)。如需重启: ./start.sh restart"
212
+ return 1
213
+ fi
214
+ if port_in_use "$port"; then
215
+ warn "⏳ 端口 $port 仍被占用,等待释放(最多 ${START_WAIT_SEC}s)..."
216
+ if ! wait_port_free "$port" "$START_WAIT_SEC"; then
217
+ err "❌ 端口 $port 等待 ${START_WAIT_SEC}s 仍未释放,放弃启动。"
218
+ err " 排查:netstat -tlnp | grep :$port 或换端口: ./start.sh --port <新端口>"
219
+ return 1
220
+ fi
221
+ ok "✓ 端口 $port 已释放"
222
+ fi
223
+ rm -f "$PID_FILE"
224
+ mkdir -p "$SERVER_DIR"
225
+ rotate_log
226
+ local token
227
+ token="$(resolve_token)"
228
+ local cmd=("$NODE_BIN" "$SERVER_ENTRY" --port "$port" --no-open)
229
+ if [ -n "$token" ]; then cmd+=("--token" "$token"); fi
230
+ cd "$SERVER_DIR" || exit 1
231
+ if command -v setsid >/dev/null 2>&1; then
232
+ setsid nohup "${cmd[@]}" >> "$LOG_FILE" 2>&1 < /dev/null &
233
+ else
234
+ nohup "${cmd[@]}" >> "$LOG_FILE" 2>&1 < /dev/null &
235
+ fi
236
+ echo $! > "$PID_FILE"
237
+ local new_pid okflag=0 i
238
+ new_pid="$(cat "$PID_FILE")"
239
+
240
+ for i in $(seq 1 8); do
241
+ sleep 1
242
+ if curl -sf -m 3 "http://127.0.0.1:$port/preview-ping" > /dev/null 2>&1; then
243
+ okflag=1
244
+ break
245
+ fi
246
+ pid_alive "$new_pid" || break
247
+ done
248
+ if [ "$okflag" = 1 ]; then
249
+ ok "✅ 启动成功 PID=$new_pid 端口=$port"
250
+ echo " 页面: http://<本机IP>:$port"
251
+ echo " 日志: $LOG_FILE"
252
+ echo " PID: $PID_FILE"
253
+ else
254
+ err "❌ 启动失败(8 秒内未通过健康检查),最近日志:"
255
+ tail -15 "$LOG_FILE" 2>/dev/null
256
+ return 1
257
+ fi
258
+ }
259
+
260
+ stop_one() {
261
+ local pid="$1"
262
+ warn "⏹ SIGTERM PID=$pid (最多等 ${STOP_WAIT_SEC}s)"
263
+ kill "$pid" 2>/dev/null || true
264
+ local i
265
+ for i in $(seq 1 "$STOP_WAIT_SEC"); do
266
+ if ! pid_alive "$pid"; then
267
+ ok "✓ PID $pid 已在 ${i}s 内退出"
268
+ return 0
269
+ fi
270
+ sleep 1
271
+ done
272
+ if pid_alive "$pid"; then
273
+ warn "⚠️ ${STOP_WAIT_SEC}s 未退出,SIGKILL PID=$pid"
274
+ kill -9 "$pid" 2>/dev/null || true
275
+ sleep 1
276
+ fi
277
+ if pid_alive "$pid"; then
278
+ err "❌ PID $pid 仍在,请检查"
279
+ return 1
280
+ fi
281
+ ok "✓ PID $pid 已强制结束"
282
+ }
283
+
284
+ stop_server() {
285
+ local pids
286
+ pids="$(collect_live_pids "$PORT" || true)"
287
+ if [ -z "$pids" ]; then
288
+ warn "⚠️ 未运行(无有效 PID)"
289
+ rm -f "$PID_FILE"
290
+ local f
291
+ for f in $(legacy_pid_files); do rm -f "$f"; done
292
+ return 0
293
+ fi
294
+ local rc=0
295
+ for p in $pids; do
296
+ stop_one "$p" || rc=1
297
+ done
298
+ rm -f "$PID_FILE"
299
+ local f
300
+ for f in $(legacy_pid_files); do rm -f "$f"; done
301
+ if [ "$rc" = 0 ]; then
302
+ ok "✅ 已停止"
303
+ else
304
+ err "❌ 停止未完成"
305
+ fi
306
+ return "$rc"
307
+ }
308
+
309
+ status_server() {
310
+ local port="${PORT:-$DEFAULT_PORT}"
311
+ echo "======== $PROJECT_NAME 预览服务器 ========"
312
+ echo "根目录: $ROOT"
313
+ echo "PID文件: $PID_FILE$([ -f "$PID_FILE" ] && echo " (存在)" || echo " (无)")"
314
+
315
+ local p
316
+ p="$(read_pid_file "$PID_FILE" 2>/dev/null || true)"
317
+ if pid_alive "$p"; then
318
+ ok "进程: ✓ PID $p"
319
+ ps -o pid=,ppid=,etime=,rss=,stat=,args= -p "$p" 2>/dev/null | while IFS= read -r line; do
320
+ dim " $line"
321
+ done
322
+ elif [ -n "$p" ]; then
323
+ err "进程: ✗ PID 文件有 $p 但进程已退出"
324
+ else
325
+ err "进程: ✗ 未运行"
326
+ fi
327
+
328
+ local lis
329
+ lis="$(listen_line "$port")"
330
+ if [ -n "$lis" ]; then
331
+ ok "监听: ✓ 端口 $port"
332
+ dim " $lis"
333
+ else
334
+ warn "监听: 未发现 :$port"
335
+ fi
336
+
337
+ local curlout code time
338
+ curlout="$(curl -sS -m 5 -o /tmp/${PROJECT_NAME}-status.body -w '%{http_code} %{time_total}' "http://127.0.0.1:$port/preview-ping" 2>/dev/null || echo "000 0")"
339
+ code="${curlout%% *}"
340
+ time="${curlout#* }"
341
+ if [ "$code" = "200" ]; then
342
+ ok "HTTP: ✓ GET /preview-ping $code ${time}s"
343
+ head -c 80 "/tmp/${PROJECT_NAME}-status.body" 2>/dev/null; echo
344
+ else
345
+ err "HTTP: ✗ GET /preview-ping HTTP $code"
346
+ fi
347
+ rm -f "/tmp/${PROJECT_NAME}-status.body"
348
+
349
+ if [ -f "$LOG_FILE" ]; then
350
+ local sz mtime
351
+ sz="$(file_size "$LOG_FILE")"
352
+ mtime="$(date -r "$LOG_FILE" '+%Y-%m-%d %H:%M:%S' 2>/dev/null || stat -c %y "$LOG_FILE" 2>/dev/null | cut -d. -f1)"
353
+ echo "日志: $LOG_FILE $(human_size "$sz") 更新 $mtime"
354
+ echo "-------- 最近 8 行 --------"
355
+ tail -8 "$LOG_FILE" 2>/dev/null
356
+ else
357
+ warn "日志: 尚无 $LOG_FILE"
358
+ fi
359
+ }
360
+
361
+ CMD="${1:-restart}"
362
+ if [ "$CMD" = "--port" ]; then
363
+ CMD="restart"
364
+ elif [ "$CMD" = "start" ] || [ "$CMD" = "stop" ] || [ "$CMD" = "restart" ] || [ "$CMD" = "status" ]; then
365
+ shift
366
+ else
367
+ CMD="restart"
368
+ fi
369
+
370
+ # 全局端口解析(2026-09-20 修):start/restart 带 --port 时,stop/status 必须按同一端口
371
+ # 收集存活进程——否则 restart --port X 会先按默认端口停掉**别的项目**的同端口服务(SIGTERM→SIGKILL 误杀)。
372
+ PORT="${DEFAULT_PORT:-30999}"
373
+ if [ $# -ge 2 ]; then
374
+ for ((i = 1; i <= $#; i++)); do
375
+ if [ "${!i}" = "--port" ] && [ $((i + 1)) -le $# ]; then
376
+ PORT="${@:$((i + 1)):1}"
377
+ break
378
+ fi
379
+ done
380
+ fi
381
+
382
+ case "$CMD" in
383
+ start) start_server "$@" ;;
384
+ stop) stop_server ;;
385
+ restart)
386
+ stop_server
387
+ sleep 1
388
+ start_server "$@"
389
+ ;;
390
+ status) status_server ;;
391
+ *)
392
+ err "❌ 未知命令: $CMD"
393
+ echo "可用命令: start, stop, restart, status"
394
+ exit 1
395
+ ;;
396
+ esac
@@ -0,0 +1,21 @@
1
+ The MIT License (MIT)
2
+
3
+ Copyright (c) 2018-2024 Max Brunsfeld
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,69 @@
1
+ # assets/tree-sitter —— 随包发布的 tree-sitter 运行时与语法(**第三方,MIT**)
2
+
3
+ 本目录是**第三方产物**,不是本项目源码。用途:给审计的「列级/语法级精筛」提供真语法树,
4
+ 与 `lib/ast/*` 的自研 token 级判定形成互补(自研层始终保留为**回退路径**)。
5
+
6
+ ## 内容与来源(钉死版本,勿随手升级)
7
+
8
+ | 文件 | 来源 | 版本 | 大小 | sha256(前 16 位) |
9
+ |---|---|---|---|---|
10
+ | `tree-sitter.js` | npm `web-tree-sitter` | **0.25.10** | 150,999 B | 见 `sha256sum` 现场复核 |
11
+ | `tree-sitter.wasm` | npm `web-tree-sitter` | **0.25.10** | 205,488 B | 同上 |
12
+ | `tree-sitter-javascript.wasm` | npm `tree-sitter-wasms` | 0.1.13 | 647,334 B | `63812b9e275d2685` |
13
+ | `tree-sitter-typescript.wasm` | npm `tree-sitter-wasms` | 0.1.13 | 2,342,690 B | `8515404dceed38e1` |
14
+ | `tree-sitter-python.wasm` | npm `tree-sitter-wasms` | 0.1.13 | 476,105 B | `9056d0fb0c337810` |
15
+ | `LICENSE` | npm `web-tree-sitter` | 0.25.10 | 1,085 B | —— |
16
+
17
+ > ⚠️ **运行时版本不要随手升**:实测 `web-tree-sitter@0.27.1` 与 `tree-sitter-wasms@0.1.13` 的语法
18
+ > **不兼容** —— `Language.load` 会在 `getDylinkMetadata` 处抛出**空消息**的 Error(0.26.0 同样失败 ✗)。
19
+ > 0.25.10 实测可加载同一批语法(`LANGUAGE_VERSION=15`)✓;换版本必须重跑 `lib/ast/treesitter.js` 的冒烟测试。
20
+
21
+ 下载方式(可复现;CDN 直取,不走 npm install):
22
+
23
+ ```bash
24
+ WTS=0.25.10; TSW=0.1.13
25
+ # 注意:0.25.x 的文件名是 tree-sitter.js / tree-sitter.wasm(0.27.x 才是 web-tree-sitter.* ✗ 不兼容)
26
+ curl -sL -o tree-sitter.js "https://cdn.jsdelivr.net/npm/web-tree-sitter@$WTS/tree-sitter.js"
27
+ curl -sL -o tree-sitter.wasm "https://cdn.jsdelivr.net/npm/web-tree-sitter@$WTS/tree-sitter.wasm"
28
+ curl -sL -o LICENSE "https://cdn.jsdelivr.net/npm/web-tree-sitter@$WTS/LICENSE"
29
+ for L in javascript typescript python; do
30
+ curl -sL -o "tree-sitter-$L.wasm" "https://cdn.jsdelivr.net/npm/tree-sitter-wasms@$TSW/out/tree-sitter-$L.wasm"
31
+ done
32
+ ```
33
+
34
+ ## 落库校验(每次改动本目录都要复核)
35
+
36
+ ```bash
37
+ # ① 必须是真 wasm(魔数 \0asm)——曾把 CDN 的 404 错误页当 wasm 存进来过 ✗
38
+ for f in *.wasm; do printf '%s %s\n' "$(head -c4 "$f" | od -An -c | tr -d ' \n')" "$f"; done
39
+ # ② 与上表 sha256 对照
40
+ sha256sum *.wasm *.js
41
+ ```
42
+
43
+ ## 许可与合规
44
+
45
+ - `web-tree-sitter`(含 `web-tree-sitter.js` / `web-tree-sitter.wasm`):**MIT**,许可证原文见同目录 `LICENSE`。
46
+ - 语法包 `tree-sitter-wasms` 内各语法由对应上游语法项目构建(各语法多为 MIT/Apache-2.0);
47
+ 本目录只随包分发**预编译 wasm**,不改动其内容。
48
+ - 分发要求:保留 `LICENSE` 与来源说明(本文件即是)✓
49
+
50
+ ## 语言集合口径(与审计规则包对齐)
51
+
52
+ **加载哪些语言 = `lib/audit-rules/` 里存在哪些「语言规则包」**(**空占位包也算** ✓):
53
+
54
+ ```
55
+ 有规则的:nodejs(js/ts) · frontend(js/ts/css/html) · java · python
56
+ 空占位包:cpp · go · php · rust · swift
57
+ ```
58
+
59
+ 当前试点已落 **javascript / typescript / python** 三个;
60
+ 其余(java/go/rust/cpp/php/swift)按同一口径后续补入(每个约 0.3~2.3MB,**体积是主要代价** ✗)。
61
+
62
+ ## 与自研层的关系(重要)
63
+
64
+ ```
65
+ 优先:能加载到语法 wasm ⇒ 用语法树确认「命中的那一处是不是真的语法节点」(如 string_fragment / comment ⇒ 不是代码)
66
+ 回退:加载失败 / 无对应语法 / 超预算 ⇒ 退回 lib/ast/code-lines.js 的 token 级(行级 + 列级)判定
67
+ 铁律:**新增规则字段必须同时登记 lib/rule/registry.js 的 withRuleScope 补丁点** ✗
68
+ —— 否则会出现「单元测试通过、生产路径静默失效」(2026-10-15 实测踩到)
69
+ ```
@@ -0,0 +1 @@
1
+ 版本留档: web-tree-sitter@0.25.10 · tree-sitter-wasms@0.1.13