$ cat ~/map/pi-share-hf.md

pi-share-hf

收集、脱敏并发布 Pi 会话记录到 Hugging Face 数据集。

officialtools✓ 10月16日

npm install -g pi-share-hf

## 速览

Pi 作者官方出品的流水线工具：把一个 OSS 项目的 pi 会话发布到 Hugging Face 数据集——收集、脱敏、TruffleHog 扫描、LLM 审查，只上传通过全部检查的会话。

## 要点

• $增量式六阶段流水线：收集单个项目变更与新增的会话、从 env 文件和 --secret 输入中脱敏已知密钥、按 --deny 模式拒绝会话、用 TruffleHog 扫描脱敏输出、跑 LLM 审查，最后只上传通过全部检查的会话。
• $确定性脱敏只替换精确的密钥值（来自 --env-file，默认 ~/.zshrc，以及可重复的 --secret 文件/字面量）；TruffleHog 随后扫描脱敏输出，任何发现——verified、unverified 或 unknown——都会自动拦截该会话。
• $LLM 审查读取项目上下文文件与脱敏会话的纯文本转录，回答 about_project、shareable、missed_sensitive_data 三个问题；审查结果落在 .pi/hf-sessions/review/，更换 provider、模型或 thinking 档位会改变审查缓存键。
• $.pi/hf-sessions/ 工作区保存状态，重复运行只处理有变化的部分；pi-share-hf init 把项目目录映射到个人或 --organization 命名空间下的 Hugging Face 数据集仓库，同一工作区可在多台机器上使用。
• $命令集：init、collect、review、reject、list --uploadable、grep（只在可上传集合内搜索）、upload（支持 --dry-run）；upload 使用内置的 TypeScript Hugging Face 客户端，认证走 HF_TOKEN 或 ~/.cache/huggingface/token。

## 常见问题

## 参考链接

• README ↗
• Pi 会话格式文档 ↗
• TruffleHog ↗

最后更新: 2026年8月31日