PersonalDataHub

通过 PersonalDataHub 访问控制网关，访问来自 Gmail、GitHub 及其他来源的个人数据。数据所有者控制代理可查看的内容、可见字段、需脱敏的数据，以及允许执行的操作。

工具

personal_data_pull

从指定数据源拉取数据。数据将根据所有者的访问控制策略进行过滤与脱敏。

参数：

• source（必需）—— 数据源（例如："gmail"、"github"）
• purpose（必需）—— 获取该数据的原因（用于审计日志）
• type（可选）—— 数据类型（例如："email"、"issue"）
• query（可选）—— 使用源系统原生语法的搜索查询（例如："is:unread from:alice"）
• limit（可选）—— 返回结果的最大数量

示例：

拉取我最近关于 Q4 报告的未读邮件。

personal_data_propose

提出一个外发操作（例如：草拟一封邮件）。该操作将进入待审队列，由数据所有者审核并批准——在获得批准前，操作不会实际执行。

参数：

• source（必需）—— 目标服务（例如："gmail"）
• action_type（必需）—— 操作类型（例如："draft_email"、"send_email"、"reply_email"）
• to（必需）—— 收件人邮箱地址
• subject（必需）—— 邮件主题
• body（必需）—— 邮件正文
• purpose（必需）—— 提出该操作的原因（用于审计日志）
• in_reply_to（可选）—— 用于邮件线程的消息 ID

示例：

草拟一封回复 Alice 关于 Q4 报告邮件的信件，感谢她提供相关数据。

直接 API 回退方案

若上述工具不可用，您可通过 HTTP 直接调用 PersonalDataHub API。

凭证：读取 ~/.pdh/credentials.json 文件以获取 hubUrl 和 apiKey。

拉取数据：

curl -X POST /app/v1/pull 
  -H "Authorization: Bearer " 
  -H "Content-Type: application/json" 
  -d '{"source": "gmail", "purpose": "reason for pulling data"}'

提出操作：

curl -X POST /app/v1/propose 
  -H "Authorization: Bearer " 
  -H "Content-Type: application/json" 
  -d '{"source": "gmail", "action_type": "draft_email", "action_data": {"to": "...", "subject": "...", "body": "..."}, "purpose": "reason for action"}'

故障排查

若调用失败，请检查 PersonalDataHub 服务是否正在运行：

curl /health

若服务未运行，请定位并启动它：

# 查看 PersonalDataHub 的安装路径
cat ~/.pdh/credentials.json   # 查看 hubDir 字段
# 启动服务
cd  && node dist/index.js

安装配置

安装钩子（install hook）会自动完成 PersonalDataHub 的初始化：

1. 安装依赖、构建项目、初始化数据库
2. 生成 API 密钥，并保存至 ~/.pdh/credentials.json
3. 在后台启动服务

安装完成后，请访问 http://localhost:3000，通过 OAuth 连接 Gmail / GitHub。

Agent 会自动从 ~/.pdh/credentials.json 中读取凭证——无需手动配置。

Gmail 查询语法

• is:unread —— 未读邮件
• from:alice —— 来自 Alice 的邮件
• newer_than:7d —— 过去 7 天内的邮件
• subject:report —— 主题中包含 “report” 的邮件
• 组合使用：is:unread from:alice newer_than:7d

重要说明

• 数据经过过滤：所有者控制您可见的字段。部分字段可能缺失或已被脱敏。
• 操作需经审批：所有外发操作（如发送邮件、创建草稿）均先进入待审队列，必须经所有者批准后方可执行。
• 全程可审计：每次数据拉取（pull）和操作提议（propose）均记录日志，并附带您提供的 purpose 字符串。