open-field

这是什么

OpenField 不是「AI 聊天助手」，也不是又一个笔记软件。它被设计为可以背着走遍中国的田野作业系统：走进工厂、村庄、市场与作坊，与各行各业的人交谈，并以证据级的严谨性和学术诚信保存他们所说的每一句话。

它是研究者的四件套：

AI 是同事，不是先知。 所有 AI 输出都是等待研究者确认的提案（P1 阶段刻意不接 AI）；AI 增强田野工作，绝不替代人在现场的判断、共情与在场本身。

当原则与开发速度冲突时，原则优先——所有架构决策均以 PRINCIPLES.md（项目宪法）为准绳。

当前状态

P1（能出门干活）开发中。桌面端服务层与完整工作台界面均有单元测试与 E2E 覆盖（含演示数据全流程）；移动端与 AI 能力尚未开始。

30 秒上手：pnpm install && cd apps/desktop && pnpm dev，创建资料库后到「总览」点「载入演示数据」即可体验全部功能（详细操作见 docs/工程/使用手册.md）。

五层架构

┌─────────────────────────────────────────────────────────┐
│  L5 输出层   学术引用 · 加密备份 · （P3）REFI-QDA 导出      │ ← 引用/备份已实现
├─────────────────────────────────────────────────────────┤
│  L4 分析层   （P3）AI 编码提案 · 三角验证 · 反身性提醒      │ ← 每日日志草稿已实现
├─────────────────────────────────────────────────────────┤
│  L3 沉淀层   （P2）四维索引知识库 · 引荐链图谱             │ ← 结构化登记已实现
├─────────────────────────────────────────────────────────┤
│  L2 取证层   哈希链 · 只读封存 · 可信时间 · append-only 日志 │ ← 已实现（核心壁垒）
├─────────────────────────────────────────────────────────┤
│  L1 采集层   Inbox 导入 · 事件/访谈登记 · （Plan 3）手机端  │ ← 桌面导入流已实现
└─────────────────────────────────────────────────────────┘

P1 的关键决策（详见架构规格）：

• 导入模式，不重造录音机：手机录音 / 拍照经 iCloud 自然回流，桌面端的价值是证据链登记与结构化；
• 双端分工：桌面全功能端 + 手机轻薄端，iCloud 只搬密文与已同意材料；
• P1 无 AI：外部转写文本作为一等公民导入，核心验证目标是证据链 + 数据模型跑通真实田野。

已实现能力

证据链格式

entry_hash = SHA-256(seq | prev_hash | ts | actor | action | payload_hash)

seq          全链单调递增，首条 prev_hash 为 64 个 '0'
action       INGEST_ARTIFACT · CREATE_EVENT · CREATE_ENCOUNTER · CREATE_PARTICIPANT
             · CONSENT_RECORDED · CONSENT_WITHDRAW · CREATE_MEMO · MEMO_CONFIRM
             · EXPORT · TIME_SYNC
             · PURGE_SUBJECT（只记录删除事实与范围，不含已删内容）

任何对历史记录的篡改都会导致后续所有 entry_hash 校验失败；verify:run 重放全链即可检出。

数据模型

README 六实体全保留，P1 新增三个：

快速开始

# 环境要求：Node ≥ 22，pnpm 11
corepack enable
pnpm install

pnpm test          # 全部单元 / 集成测试
pnpm typecheck     # TypeScript 严格模式检查

cd apps/desktop
pnpm dev           # 启动桌面应用
pnpm e2e           # Playwright Electron 冒烟：建库 → 登记 → 导入 → 引用

首次启动先输入口令（≥ 8 字符）创建资料库，口令丢失无找回。想先看功能：创建后到「总览 → 演示数据」点「载入演示数据」，一套示例田野（含滚雪球引荐链、已签发引用、待办收件）即可体验全部功能，内容可编辑（apps/desktop/src/main/services/mock-data.ts）。

数据目录默认位于系统用户数据目录（Electron userData），开发与测试可用 --openfield-home=<path> 显式指定：

<home>/
├─ vault.db        # SQLCipher 加密资料库
├─ originals/      # 原始件只读封存 originals/<artifactId>/v1.<ext>
├─ inbox/          # 导入暂存（监听目录，可指向 iCloud 同步目录）
├─ quarantine/     # 畸形 bundle 隔离区
└─ backups/        # OFBK1 加密备份输出

仓库结构

open-field/
├─ packages/core/          # @openfield/core：zod 数据模型、哈希链、RefId、bundle 协议（无 UI 依赖）
├─ packages/knowledge/     # @openfield/knowledge：田野方法论内容管道（docs 两套知识库 → 预生成 HTML / manifest / 场景卡，dist 入库）
├─ apps/desktop/           # @openfield/desktop：Electron 主进程服务层 + 工作台 renderer（六视图）
├─ apps/web/               # @openfield/web：方法论知识库 Web App（React + HashRouter，仅知识内容，无资料库功能）
├─ docs/                   # 全部文档入口见 docs/README.md
│  ├─ 工程/                # 架构 / 威胁模型 / 使用手册 / 伦理自查
│  ├─ 研究/                # 行动总纲 / 田野落点 / 路书
│  ├─ 田野方法/            # 田野调查方法论语料库（12 章 + 术语表 + 参考文献）
│  ├─ 社会学田野/          # 社会学田野知识库（15 章 + 实践指南）
│  └─ 规格与计划/          # 架构规格与实现计划（A 系列偏离记录）
├─ gtm/                    # Go-To-Market 计划（ICP / 定位 / 渠道 / 发布阶段 / 指标）
├─ website/                # 项目官网单页（已发布至 Meoo CDN）
├─ PRINCIPLES.md           # 项目宪法
└─ CONTRIBUTING.md · SECURITY.md · CHANGELOG.md · CITATION.cff · LICENSE

路线图

P1 的铁律：先用自己的真实田野验证。 OpenField 的质量只能来自维护者背着它跑完第一个省——这是倡导而非门槛（见 PRINCIPLES §5 创始人田野法则）。

文档地图

两条核心设计张力

1. 敏感数据的物理安全：走遍全国意味着设备丢失/检查风险。整库 SQLCipher 加密、真名映射仅存桌面 vault、原始件哈希封存，这些比任何 AI 功能优先级都高。
2. 「取证」与「信任」的张力：过于正式的存证流程会让受访者紧张、说真话的意愿下降。设计上对研究者严谨、对受访者无感——同意流程像聊天一样自然，哈希固化在后台静默完成。

贡献

任何涉及数据处理、AI 集成或用户可见文案的 PR，必须通过伦理自查清单并对照 PRINCIPLES 第 2 节逐条检查。绝不提交真实田野数据——测试夹具只允许合成数据。详见 CONTRIBUTING.md。

许可证与引用

OpenField 以 MIT 许可证发布。在论文中引用请使用 CITATION.cff 元数据。

"The field is where theory meets reality. OpenField exists to make sure reality keeps its receipts."

「田野是理论遇见现实的地方。OpenField 的使命，是让现实留下可查证的回执。」