dsh-hdfs
DeepSeek Harness (dsh) 插件：通过 Rust napi-rs 原生插件以及 Web 客户端和代理工具，浏览和操作 HDFS 集群（HA / Kerberos）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:awol2005ex3/dsh-hdfs#e9458f2a38a870b374d26749c7e096132cc0ef1c
Hdfs 以 dsh-hdfs 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness (dsh) 插件：在 dsh 里浏览与操作 HDFS。Rust (napi-rs + hdfs-native) 直连集群，支持 HA 多 Namenode 与 Kerberos，带 Web 浏览面板与 agent 工具。
/api/hdfs/* RPC 路由 + hdfs agent 工具hdfs-native 0.11 封装，纯 Rust Kerberos（keytab → TGT → ccache）| 分类 | 端点（agent 工具 hdfs 的 endpoint 同名） |
|---|---|
| 连接 | version clusters ping kerberosLogin kerberosStatus |
| 浏览 | list status read findSpecialDirs |
| 写入 | write upload download mkdirs createEmpty rename |
| 管理 | delete chmod getAcl modifyAcl removeAcl |
npm install # 安装依赖（含 @napi-rs/cli）
npm run build:native # cargo 编 Rust → lib/native/*.node（约 1~2 分钟）
npm run build # tsc 编 TS + 包浏览器 bundle
npm run check # 三层冒烟：native / plugin / rpc
Windows 上 cargo/napi 需要能正常起子进程的环境（沙箱内会被拦）。 若
.node正被 dsh 宿主占用导致copyArtifact失败：先cargo build --release单独编译，再重启宿主（见AGENTS.md「已知坑」）。
npx @deepseek-ai/dsh plugin --profile web add .
# 然后重启宿主（插件集在启动时扫描）
配置载体是 profile 的 cordis.patch.yml（也可在「设置 → 插件 → HDFS」里改，volatile 热更新）：
- id: hdfs
config:
clusters: '[{"id":"prod","url":"hdfs://nameservice1","extraConfig":"{\"dfs.nameservices\":\"nameservice1\",\"dfs.namenode.rpc-address.nameservice1.nn1\":\"nn1-host:8020\",\"dfs.namenode.rpc-address.nameservice1.nn2\":\"nn2-host:8020\",\"dfs.ha.namenodes.nameservice1\":\"nn1,nn2\",\"dfs.namenode.kerberos.principal\":\"hdfs@REALM\",\"dfs.namenode.keytab.file\":\"/path/hdfs.keytab\"}"}]'
defaultCluster: prod
clusters 是 JSON 数组字符串，每项 {id, url, extraConfig}；extraConfig 是 Hadoop 配置的 JSON 字符串。url 必须是 hdfs:// 开头；HA 场景填逻辑名（hdfs://nameservice1），地址与 namenode 清单由 extraConfig 提供。cluster 参数时用 defaultCluster（留空取第一个）。| 场景 | 用户名来源 |
|---|---|
extraConfig 里有 dfs.namenode.kerberos.principal + dfs.namenode.keytab.file | principal 的 @ 前缀（hdfs@REALM → hdfs） |
| 否则 | 环境变量 HADOOP_USER_NAME → HADOOP_USERNAME → HDFS_USERNAME |
配置里没有 user 字段，这是刻意设计。
会话里直接让模型操作，例如：
列出 HDFS 根目录 → hdfs {endpoint:"list", args:{path:"/"}}
读一个文件的前 64KB → hdfs {endpoint:"read", args:{path:"/tmp/a.csv", maxBytes:65536}}
找全集群的 .Trash 目录 → hdfs {endpoint:"findSpecialDirs", args:{patterns:[".Trash","staging"]}}
Kerberos 登录 → hdfs {endpoint:"kerberosLogin"}
settings.plugins.tab 插槽）；面板功能：集群下拉、路径面包屑、目录表格（权限/属主/大小/时间）、文本预览、目录汇总开关、Kerberos 登录与状态、集群 JSON 编辑与校验。
kerberosLogin（面板按钮或工具端点）：纯 Rust kinit-kt 用 keytab 取 TGT，写入
%USERPROFILE%\dsh_hdfs_ccache 并设置进程级 KRB5CCNAME。hdfs-native 经 libloading 调用系统 GSS 库：
libgssapi_krb5.so.2（MIT Kerberos / Heimdal）gssapi_krb5.dll（MIT KFW），放在 .node 同目录或系统路径即可GSSAPI error: ... GSS_S_BAD_MECH ...KRB5CCNAME 若被其他工具设成 API:krb5cc 这类非文件型值，本插件会忽略它并改用固定文件路径
（API: 型 ccache hdfs-native 解析不了）。connection.fetch 的 exact 路由不绕过 /api 的信任栅栏。.e2e-cluster.local.json 已 gitignore）。delete 带 trash:true）。仓库结构、已知坑与验证矩阵见 AGENTS.md。
rust/ Rust napi 封装（hdfs-native）
src/ TS：宿主半 index/rpc/tool/settings + 浏览器半 client
scripts/ wrap-client（bundle 外壳）+ 三层冒烟 + 真实集群 e2e
lib/ 构建产物（gitignore）
Apache-2.0