CensorScope × dsh 插件
本目录包含三个随 dsh 预装的插件(不修改 dsh 源码,只做 profile 级插件安装):
| 包 | 版本 | 作用 | 装入 profile |
|---|---|---|---|
censorscope-host | 0.1.1 | main 角色:单 trace track-add(trace-id 复用;单次调用同步拿到终态或错误) + per-call cache writer + /censorscope/call 路由;worker 角色:注入 DSH_CENSORSCOPE_CALL_ID + call-start/end span(真实起止时刻) | web + headless |
agentcensor-session-proxy | 0.1.1 | web 每会话 headless worker(agentcensor 拓扑)+ CENSORSCOPE_SESSION_ID;停止按钮 = 协议级取消(worker 内原生 agent.cancel);审批 / ask_user_question 交互桥(worker→host→浏览器→回注,控制面不写会话数据) | web |
censorscope-ui | 0.1.0 | 浏览器会话「CensorScope」Tab(替换原生轨迹视图) | web |
一键安装(推荐)
插件变更必须 bump 版本并重新打包后才能生效(安装器按版本号刷新),请一律通过脚本安装:
bash
export DSH_HOME=/path/to/dsh/home # 必填,脚本本身不设置
./scripts/install-censorscope.sh all # host(web+headless) + agentcensor-session-proxy(web) + ui(web)模式说明:
all:安装/刷新全部三个插件。host:只装censorscope-host(web+headless)与agentcensor-session-proxy(web),不装censorscope-ui。
其它要点:
- 脚本幂等:版本未变时输出
installed并跳过;版本变化时自动npm pack并用dsh plugin --profile <p> add刷新。 - 默认
npm缓存不可用(如沙箱/无默认 pnpm store)时,可显式指定:bashexport PNPM_STORE_DIR=<writable-dir> PNPM_CACHE_DIR=<writable-dir> NPM_CACHE_DIR=<writable-dir> - 安装与 censorscoped/daemon 无关:装完插件后重启 dsh web 即生效;改动 eBPF 采集/daemon 侧仍需自行重建 daemon 并重启 censorscoped。
- 手动打包(等价于脚本内动作):bash
cd plugins/<pkg> && npm pack --pack-destination . --cache <工作区 .cache/npm>
文档捉虫