内容
# Fieldy 连接到 OpenClaw
一款连接 [Fieldy 3](https://www.fieldy.ai/) AI 可穿戴设备到您桌面的 Windows 桌面应用程序（WPF / .NET 8）：离线搜索对话和记录，任务/演讲者配置文件/模板/可分享管理，以及本地 [MCP](https://modelcontextprotocol.io/) 桥接器，直接将您的 Fieldy 数据插入 OpenClaw 或 Claude Code。
Fieldy 挂坠仅与手机（蓝牙）配对 — 该应用程序从不与硬件通信，它通过公共云 API 连接到您的 Fieldy **账户**。
## 功能
### 核心
- **4 步设置向导**：API 密钥连接，可选的本地 webhook 和/或 MCP 服务器激活，初始同步带有进度条。
- **离线全文搜索**（SQLite FTS5）跨标题，摘要，内容和关键词 — Fieldy 的 API 没有服务器端搜索，所有内容都在本地索引。
- **对话**：列表，详情视图，导出（Markdown / 纯文本 / JSON）。
- **任务**：状态过滤列表，创建，变更状态，删除 — 带有视觉高亮显示数天未触及的任务（“任务过期”）。
- **演讲者配置文件**：完整的 CRUD（名称 + 颜色）。 *Fieldy 的 API 无法将配置文件附加到特定的记录片段 — 此功能在此故意缺失。*
- **记忆模板**：完整的 CRUD，带有章节子编辑器。
- **可分享内容**：每个对话创建/撤销分享链接。
- **后台同步** 每 2 分钟 + 系统托盘图标（状态，手动同步，快速重新打开）。
- **本地 webhook 接收器**（`http://localhost:{port}/webhook/`）用于 Fieldy 推送的新对话的实时传递。
- **本地 MCP 服务器**（`FieldyToOpenClaw.Mcp.exe`）向 MCP 客户端（OpenClaw，Claude Code）公开您的数据，无需每次调用都绕道到云。
### 多动症 — 工作记忆和外部结构
- **放弃承诺检测器**：扫描对话内容中的口头承诺（“我明天会发送过来”），并提供一键将其转换为任务的功能。
- **欢迎回来桥接器**：在 2 小时以上的缺席后，返回时会出现“发生了什么”的回顾。
- **过渡提示**：在长时间沉默或检测到位置变化时发出温和的通知。
- **过期任务**：任务 pending 一段时间后，会以其年龄为视觉显示。
### 工作 — 跟进和回忆
- **跟进自动驾驶员**（AI）：从对话的摘要/内容/引用中草拟跟进电子邮件。
- **关系雷达**：按最近一次交谈的时间排序的联系人视图。
- **每周摘要**（AI）：过去 7 天的回顾（对话，已完成/待处理的任务）。
- **项目聚类**：本地按共享关键词/演讲者/位置对对话进行分组，无需手动标记。
### 跨领域
- **询问你的当天**（AI）：在你的记录上进行自然语言查询，并附有引文回到源对话（本地 RAG）。
- **情绪日记**（AI）：每个对话的压力/中立/积极标签，带有随时间推移的可浏览历史。
标记为 **（AI）** 的功能需要在 **设置** 中配置 Anthropic API 密钥（通过 DPAPI 加密存储，绝不硬编码在代码中）。如果没有密钥，它们只会被隐藏 — 应用程序的其他部分正常工作。
## 架构
```
FieldyToOpenClaw.sln
src/
FieldyToOpenClaw.Core/ 共享库：API 客户端，SQLite+FTS5 缓存，
同步，安全（API 密钥通过 DPAPI），导出，webhook
FieldyToOpenClaw/ WPF 应用程序（向导，屏幕，托盘图标）
FieldyToOpenClaw.Mcp/ MCP 服务器（独立控制台进程，stdio）
tests/
FieldyToOpenClaw.Tests/ xUnit 测试（速率限制器，缓存/FTS5，webhook 解析）
```
MCP 服务器是一个独立于 WPF 应用程序的进程（MCP 客户端通过 stdio 启动它）；两者共享同一个 SQLite 缓存文件（WAL 模式），允许多个并发读取而不会发生争用。
## 要求
- Windows 10/11
- [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0)
- 具有已安装的移动应用程序的 Fieldy 账户
## 构建
```powershell
dotnet build FieldyToOpenClaw.sln
```
## 运行应用程序
```powershell
dotnet run --project src\FieldyToOpenClaw
```
在首次启动时，向导会引导您完成：
1. **API 密钥** — 在 Fieldy 移动应用程序中：*设置 → 开发者设置 → 复制 API 密钥*（以 `sk-fieldy-` 开头）。
2. **集成** — 根据需要启用本地 webhook 和/或 MCP 服务器。
3. **初始同步** — 选择回溯窗口（默认为 30 天）。
## 连接 OpenClaw / Claude Code (MCP)
1. 发布 MCP 服务器为独立可执行文件：
```powershell
dotnet publish src\FieldyToOpenClaw.Mcp -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -o dist\mcp
```
2. 将 `dist\mcp\` 的内容复制到 `%LOCALAPPDATA%\FieldyToOpenClaw\mcp\`。
3. 在应用程序中，在向导的 **集成** 步骤（或在 **设置** 中），单击 **“复制 MCP 配置”** — 生成的 JSON 代码段指向该位置的 `FieldyToOpenClaw.Mcp.exe`。
4. 将配置粘贴到您的 MCP 客户端，例如对于 Claude Code：
```powershell
claude mcp add-json fieldy-to-openclaw '{"command":"C:\\Users\\<you>\\AppData\\Local\\FieldyToOpenClaw\\mcp\\FieldyToOpenClaw.Mcp.exe","args":[]}'
```
公开的工具：`search_conversations`，`get_conversation`，`list_recent_conversations`，`list_transcripts_in_range`，`list_tasks` — 所有这些都来自本地缓存，每个请求无需网络调用。
## 测试
```powershell
dotnet test tests\FieldyToOpenClaw.Tests
```
## 已知限制（按设计）
- 没有与挂坠的蓝牙配对 — 仅限账户连接。
- 无法为特定的记录片段分配演讲者配置文件 — Fieldy 的公共 API 不将此作为写入操作公开。
- Fieldy 的 webhook 文档很少；负载解析故意宽容（绝不会因意外形状而崩溃，原始负载记录到 `webhook_log`）。
## 待办事项
全局快速搜索 + 快捷键，浅色/深色主题，静态缓存加密，`webhook_log` 查看器。
