证据图谱模拟 plilian/flock

🐦 Flock

证据进来，可能性出去。

一个多宿主 AI 智能体插件，用于有来源依据的知识图谱、证据审计和合成社会模拟。

安装 · 工作原理 · 英文文档 · 日本語 · 简体中文 · Español · 隐私 · 许可

Flock 帮你探索一个问题：把问题扎在来源材料里，画出真正重要的关系，再模拟一个合成社群会怎么回应。原生插件包支持 Codex、Claude Code、Gemini CLI、Qwen Code 和 DeepSeek Harness。每个宿主当前活跃的模型会话负责推理；Flock 把图谱和运行历史存进你选的工作区。

Flock 本身不需要 Flock API key、Zep key 或 Flock 账号。模型访问权仍归你选的宿主：每位用户各自登录或配置该宿主，宿主的的数据政策、套餐和用量限制照常生效；某些宿主配置可能还需要自己的服务商凭据。DeepSeek Harness 支持针对的是它的开发者预览版插件宿主，不是 DeepSeek 的聊天网站或 API。

Flock 的插件工作流和网站支持英文、日文、简体中文（zh-CN）和西班牙文。在任何受支持的宿主里，它都会跟随用户的语言来生成回复、研究问题、合成智能体内容、证据评审和报告。命令、schema 键、ID 和固定枚举值保持不变。在网站导航里选语言，或打开对应的本地化安装指南、日本語、简体中文或 español。

模拟是一场结构化的思想实验。它不是投票，不是关于真人的证据，也不是预测。

Flock 能做什么

| 工作流 | 产出什么 |
| 有来源依据的图谱 | 一套本体、带引用的实体，以及带类型的关系，都存在项目自有的 SQLite 图谱里。 |
| 证据审计 | 引用覆盖率检查，外加宿主模型评审，看引文是否准确、有无矛盾、假设和遗漏的视角。 |
| 合成人群 | 与图谱实体绑定的不同智能体配置档，假设与证据分开标注。 |
| 社会模拟 | 按轮次进行的类 Reddit 或类 Twitter 讨论，记录动作、反应和时间线。 |
| Scenario Lab | 基线对照实验，共用同一份合成名册，独立重复，中位数/范围对比，外加可交互回放。 |
| 交互式运行视图 | 自包含的本地 HTML 快照，支持回合回放、交互图、智能体配置档，以及可搜索的事件流。 |
| 报告与后续追问 | Markdown 报告、活动统计、图谱问题，以及明确标注为合成智能体的访谈。 |

工作原理

flowchart LR
A[Your source files] --> B[Active host model extracts evidence]
B --> C[Candidate graph JSON]
C --> D[Flock validates and stores]
D --> E[Active host model builds synthetic profiles]
E --> F[Round-based social simulation]
F --> G[Timeline and report]
H[Your active host session] <--> B
H <--> E
H <--> F
H <--> G
D --> I[(SQLite in .flock/)]
F --> I

提取、配置档设计、智能体行动、叙事分析，都由活动宿主在你的会话里完成。Flock 的 Python 辅助程序负责校验并存储图谱/运行数据；它只用标准库，不发起网络调用，也不调用模型。没有单独的 Web 应用需要启动。

每条图谱记录都带证据状态：observed、inferred、assumption 或 unclassified。审计先检查引用结构，再请活动宿主复核来源含义。Scenario Lab 让每个变体都从相同的配置档和空事件流开始；它的重复范围只描述所配置的合成运行，不代表现实世界的概率。

作为插件安装

所有集成都使用该产品中可用的宿主模型。Flock 的包直接从 GitHub 安装；目前尚未上架厂商目录。Flock 不收集也不转发登录凭据。需要 Python 3.11+，以及工作区/终端访问权限。

Codex

codex plugin marketplace add plilian/flock
codex plugin add flock@flock

Claude Code

claude plugin marketplace add plilian/flock
claude plugin install flock@flock

Gemini CLI

gemini extensions install https://github.com/plilian/flock

Qwen Code

qwen extensions install https://github.com/plilian/flock

DeepSeek Harness

DeepSeek Harness 是独立的开发者预览版插件宿主。克隆仓库，再把它的 bundle 安装到 Harness 配置档：

git clone https://github.com/plilian/flock.git
cd flock
dsh plugin --profile web add ./plugins/deepseek-harness

这套集成面向 DeepSeek Harness，不是 DeepSeek 聊天网站或 API。Harness 的模型访问遵循它自己的服务商配置，可能需要额外设置。

在你选定的宿主里打开项目工作区，让它的智能体使用 Flock，例如：

Use Flock to initialize a project named “Transit study” in this workspace.
每个 Flock 项目用一个工作区文件夹。工作区里的 .flock/ 数据库保存它的图和模拟历史。让智能体构建或更新图、准备合成人群、运行场景、查看交互式时间线，或者生成报告。运行视图保存为 .flock/runs/<run_id>/visualization.html，直接在浏览器里打开，不需要服务器。参见安装与工作流指南。

图和模拟引擎

Flock 用自己的 SQLite 图存储替换了 Zep。实体保留稳定的 ID、带类型的属性和来源引用。导入前，关系会对照这些实体和引用做校验。

模拟时，当前宿主模型每轮为每个合成智能体提出一个动作。Flock 检查平台动作 schema，并按顺序记录这一轮。内置交互引擎支持：

- 类 Reddit： 发帖、评论、投票、加入社区。
- 类 Twitter： 发帖、回复、点赞、转发、关注。
- 分析： 智能体活动计数、互动总量、事件时间线，以及宿主模型撰写的报告。

Flock 把图和模拟机制放在自己的代码里。它不依赖 Zep 账号，也不依赖 MiroFish 服务。

隐私与数据

- 选定的宿主用自己的账号、服务商和数据政策处理源摘录和提示词。分享敏感源材料前，先检查宿主的设置。
- Flock 辅助程序本身不发起网络请求，也不访问宿主凭据。
- 项目数据存放在该用户所选工作区的 .flock/ 下：SQLite 数据库、暂存文件、证据审计文件、场景实验、模拟记录、报告，以及自包含的 HTML 可视化。没有任何 Flock 托管的服务会收到这些数据。
- 仓库的 .gitignore 排除了 .flock/；辅助程序会在 .flock/ 内添加一条忽略规则，供其他 Git 工作区使用。
- 源文件留在用户放置的位置。图只存源元数据和简短引用，不存完整文档副本。

仓库结构

plugins/flock/ Codex plugin package
plugin.json Plugin identity and install metadata
skills/flock/SKILL.md Shared Flock workflow
skills/flock/references/ Graph schema and simulation guide
skills/flock/scripts/flock.py Model-free graph, run store, and view generator
skills/flock/scripts/visualizer_template.html Offline interactive run view
skills/flock/scripts/experiment_visualizer_template.html Offline Scenario Lab comparison view
plugins/claude/ Claude Code plugin package
plugins/deepseek-harness/ DeepSeek Harness bundle (developer preview)
skills/flock/ Gemini CLI and Qwen Code skill package
gemini-extension.json Gemini CLI extension manifest
qwen-extension.json Qwen Code extension manifest
.claude-plugin/marketplace.json Claude Code marketplace
.agents/plugins/marketplace.json Codex marketplace
site/ 公开落地页与安装文档

开发

直接从检出目录运行辅助脚本： bash
python plugins/flock/skills/flock/scripts/flock.py --help

导入或启动之前，先校验工作区图或仿真规格： bash
python plugins/flock/skills/flock/scripts/flock.py --workspace . graph validate --input .flock/staging/graph.json
python plugins/flock/skills/flock/scripts/flock.py --workspace . graph audit
python plugins/flock/skills/flock/scripts/flock.py --workspace . simulation validate --spec .flock/staging/run.json
python plugins/flock/skills/flock/scripts/flock.py --workspace . simulation visualize --id <run_id>
python plugins/flock/skills/flock/scripts/flock.py --workspace . scenario validate --spec .flock/staging/experiment.json
python plugins/flock/skills/flock/scripts/flock.py --workspace . scenario create --spec .flock/staging/experiment.json
python plugins/flock/skills/flock/scripts/flock.py --workspace . scenario compare --id <experiment_id>
python plugins/flock/skills/flock/scripts/flock.py --workspace . scenario visualize --id <experiment_id>
python plugins/flock/skills/flock/scripts/flock.py --workspace . scenario save-report --id <experiment_id> --input .flock/staging/report.md

辅助脚本刻意不依赖模型。新增的依赖 AI 的步骤应放进宿主机的 Flock 技能工作流；不要添加 API-key 设置，也不要直接调用服务商。

许可与署名

Flock 以 GNU Affero General Public License v3.0 发布；见 LICENSE。它是 MiroFish 的衍生作品，独立维护且经过大幅修改。Flock 用原生智能体宿主插件和工作区本地 SQLite 图，取代了早期的 Web 应用交付方式与 Zep 支撑的图工作流。署名与项目沿革记录在 ATTRIBUTION.md。Flock 与原维护者无隶属关系，也未获其背书。

如果你把修改过的 Flock 版本通过网络提供给用户使用，AGPL-3.0 要求你向这些用户提供对应的源代码。第三方组件仍受各自许可约束。

Ask better questions about what could happen.

Install Flock · Browse the code