Files
douyin_guaji-main/douyin/utils/param_usage_tracer.py
T
CodexandClaude Sonnet 4.5 96fdc96f24 refactor(cleanup): 移除剩余死代码模块
- 删除 douyin/utils/douyin_text_utils.py 及其测试
- 移除 performance_tracker.py 中未使用的 track_function 方法
- 移除 param_usage_tracer.py 中未使用的 stop_tracing / is_enabled
- 清理 bin/run_cli.py 和 tests/test_imports.py 中的残留引用

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-05-23 21:58:41 +08:00

125 lines
3.6 KiB
Python

"""全局参数/调用跟踪器(可选启用)。
启用方式:在运行前设置环境变量 `PARAM_TRACK_ALL=1`,然后在入口处调用 `start_tracing()`。
该跟踪器使用 `sys.settrace` 捕获函数调用事件,仅记录位于项目根目录下的文件中的函数调用,避免跟踪第三方库。
记录格式与 `param_usage_tracker` 兼容,写入 `state/param_usage.json`(逐行 JSON)。
"""
from __future__ import annotations
import os
import sys
import threading
import time
import inspect
from typing import Any, Dict
try:
from douyin.core.path_config import get_project_root
except Exception:
def get_project_root() -> str:
return os.path.abspath(
os.path.join(os.path.dirname(__file__), os.pardir, os.pardir)
)
try:
# reuse internal writer for consistent format
from douyin.utils import param_usage_tracker as _tracker
except Exception:
_tracker = None
_lock = threading.Lock()
_state = {"enabled": False}
_project_root = os.path.abspath(get_project_root())
def _in_project(filename: str) -> bool:
try:
fn = os.path.abspath(filename)
return fn.startswith(_project_root)
except Exception:
return False
def _safe_short_repr(v: Any, limit: int = 300) -> str:
try:
s = repr(v)
if len(s) > limit:
return s[:limit] + "..."
return s
except Exception:
return "<unrepresentable>"
def _tracefunc(frame, event, arg):
if event != "call":
return _tracefunc
try:
code = frame.f_code
filename = code.co_filename
if not _in_project(filename):
return _tracefunc
func_name = code.co_name
lineno = frame.f_lineno
# 获取参数及其值
try:
arginfo = inspect.getargvalues(frame)
params = {}
for n in arginfo.args:
if n in arginfo.locals:
params[n] = _safe_short_repr(arginfo.locals.get(n))
if arginfo.varargs and arginfo.varargs in arginfo.locals:
params["*" + arginfo.varargs] = _safe_short_repr(
arginfo.locals.get(arginfo.varargs)
)
if arginfo.keywords and arginfo.keywords in arginfo.locals:
params["**" + arginfo.keywords] = _safe_short_repr(
arginfo.locals.get(arginfo.keywords)
)
except Exception:
params = {"_args": "<inspect-failed>"}
entry: Dict[str, Any] = {
"ts": time.time(),
"type": "call",
"func_name": func_name,
"def_file": filename,
"def_line": getattr(code, "co_firstlineno", None),
"call_file": (
frame.f_back.f_code.co_filename if frame.f_back is not None else None
),
"call_line": frame.f_back.f_lineno if frame.f_back is not None else None,
"params": params,
}
# 写入记录
if _tracker is not None and hasattr(_tracker, "_write_ndjson"):
try:
with _lock:
_tracker._write_ndjson(entry)
except Exception:
# 忽略写入错误
pass
except Exception:
# tracing must never raise
pass
return _tracefunc
def start_tracing() -> None:
"""开启全局跟踪(幂等)"""
if _state.get("enabled"):
return
try:
sys.settrace(_tracefunc)
_state["enabled"] = True
except Exception:
_state["enabled"] = False
__all__ = ["start_tracing"]