快速判断

安装前先看这几项

配置资料: 配置资料部分完整
配置难度: 未知，待补配置
适合新手: 建议具备相关经验
兼容状态: 声明兼容，尚未实测
验证状态: 源码已审阅，未标记运行实测

配置资料部分完整

本站已整理安装目标，但尚未补齐该插件的全部专属配置。完成配置前需要核对固定来源。

仍需核对：插件专属配置项、成功验证结果、首次使用示例、数据清理方法。

功能

这个插件能做什么

通过 DSH Telemetry Seam 把每轮模型、工具、用量、反馈和父子 Session 关系整理成 Langfuse OpenTelemetry Trace 与 Score。

适合谁

需要插件安装、插件管理、插件更新能力的用户。

使用门槛

该插件涉及较高配置难度或敏感权限，不建议在生产工作区直接试装。

准备

安装前准备

本站尚未核验该插件的专属前置条件。请先准备独立 Web Profile、测试工作区，并核对固定来源中的运行时、外部服务和账号要求。

安装

如何安装 dsh-plugin-langfuse

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到: web Profile
DSH 基线: 0.1.1-rc.2
安装来源: GitHub 源码（锁定提交）
固定目标: github:linyp/dsh-plugin-langfuse#42f3e20a1e8a

01
检查 Node.js 与 pnpm
DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：
环境检查
```
node --version && pnpm --version
```
02
安装到 Web Profile
这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。
GitHub 源码（锁定提交）
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add github:linyp/dsh-plugin-langfuse#42f3e20a1e8a
```
03
如遇构建脚本拦截
GitHub 源码插件可能通过 prepare 构建。pnpm 10 及以上会先阻止未授权构建；只把终端明确提示的包名加入该 Profile 的 pnpm-workspace.yaml 中 allowBuilds，审阅脚本后再重复上一步，不要使用全局放行。
04
确认 Bundle 已进入配置
安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 dsh-plugin-langfuse或对应 Bundle 层。
检查配置
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config
```
05
启动并完成最小验证
启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。
启动 DSH Web
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 web
```

卸载与回退

测试不通过时先停止 DSH，再从同一 Profile 移除插件。移除后重新运行配置检查，确认对应 Bundle 层已经消失；插件自己创建的数据和外部账号配置可能需要另行清理。

从 Web Profile 移除

npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web remove dsh-plugin-langfuse

阅读 DSH 插件安装基础指南核对项目 README

配置

插件专属配置

专属配置路径和字段尚未完成核验，请不要根据同类插件猜测参数名。

验证

配置检查与成功结果

本站尚未获得插件专属的验证命令和期望结果。安装后只能确认 Bundle 是否进入组合配置，不能据此宣称插件功能已经运行通过。

使用

第一次使用建议这样验证

以下步骤是根据插件类别提供的安全验证顺序，不是作者仓库的专用命令。具体入口和参数仍以固定提交对应的 README 为准。

确认插件市场或管理入口能够读取当前 Profile
先试装一个低权限插件并检查启用状态
记录更新、停用和卸载后的配置变化

权限

它可能接触哪些数据和能力

使用服务凭据写入本地文件读取本地文件

默认库模式为 DISABLED，但 Bundle 在同时配置 Langfuse Key 后默认切到 FULL；上传模式读取 Canonical Session Telemetry，并使用 Langfuse 项目 Key 向配置的 OTLP Trace/Score 地址发送内容和使用元数据

数据存储：尚未完成独立核验，测试前应确认插件是否写入工作区、用户目录、数据库或外部服务。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

排查

故障排查与数据清理

本站尚未整理插件专属故障模式。遇到问题时先停止 DSH、保存日志、核对固定提交对应的 README，不要反复扩大权限重试。

清理边界待核对：从 Profile 移除插件通常不会自动删除插件创建的数据、外部账号或凭据。

证据

兼容性与审阅记录

兼容性说明

插件版本 0.5.1、MIT，要求 Node.js ^22.19 或 >=24，Cordis peer ^4.0.1，README 面向 DSH 0.1.1-rc.1 Telemetry Seam；本站完成固定提交静态审阅，未在当前 0.1.1-rc.2、Langfuse Cloud/自托管端、长会话、崩溃恢复或大批量遥测下运行

数据流

DSH Canonical Session 事件与部署自定义脱敏流水线 → 本地折叠为 turn/generation/tool/compaction Trace → 携带用户与助手消息、工具参数和结果、压缩摘要、模型/Token/Session 元数据上传 Langfuse；反馈可作为 Score 发送，DISABLED 不构建传输，FEEDBACK_ONLY 在用户提交反馈后回放。

源码审阅结论

已审阅固定提交的 Telemetry 模式、Cordis Patch、内容投影、OTLP 鉴权、Score 队列、错误脱敏、响应和属性限额。插件明确记录完整外发字段，不把 Provider API Key 写入事件，并支持 turnInputMode/cwdMode/toolMetaAllowlist；但 FULL 会上传提示词、回答、工具参数与结果，插件自身不提供秘密脱敏规则，而且安装 Bundle 后只要环境存在 Key 就默认 FULL。涉及源码、个人信息或生产凭据时优先使用 DISABLED/FEEDBACK_ONLY，挂载部署级 redaction listener，核对 Langfuse 区域、保留策略和访问权限后再开启。

来源与维护信息

本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后，请重新核对作者说明。

精确来源: GitHub：linyp/dsh-plugin-langfuse（外部链接，在新标签页打开）
来源登记表: GitHub dsh-plugin Topic（外部链接，在新标签页打开）
来源快照: GitHub Topic 采集记录
固定提交: 42f3e20a1e8a
许可证: MIT
主要语言: TypeScript
中文资料: 有中文审阅摘要

dsh-plugin-langfuse