VergeCommon

VergeCommon

如果保护自然也能成为一个开源项目呢？

了解 VergeCommon：为守护共享家园的人们打造的开放工具。

组织本地保护项目，记录工作，并共同决策。从树篱和小树林到更广阔的景观，社区应当能够检查、调整和改进自己所依赖的工具。

**早期合作试点。**共享网站已上线，提供浏览器账户、私人合作社和范围限定的 Agent 访问权限。仓库还包含可自托管的账户／存储运行时以及原生参与功能源代码。我们诚邀你与我们一起构建和测试。目前尚未证明真实合作伙伴的采用情况和已验证的环境影响。有关已上线和仍待完善的内容，请参阅当前状态和服务覆盖范围。

找到你的第一个贡献机会

你能带来什么	从这里开始
本地保护经验	使用合成记录完成一项活动，并报告第一个让人困惑的步骤。
实地或研究经验	查看监测工作流，找出缺失的证据或不确定之处。
设计或无障碍技能	使用键盘或窄屏尝试规划器，并报告可复现的障碍。
开发技能	在本地运行项目，并从贡献者指南中选择一项范围明确的任务。

快速入门 · 贡献指南 · 路线图 · 试点检查清单 · 发布工具包和发布门槛

探索项目

网站 · 保护网络 · 成员工作区 · 账户和设备访问 · 参与贡献

vergecommon.com 是规范的服务地址。**要了解当前已上线、已验证和仍待完善的内容，请阅读 STATUS.md。**已部署的服务包含发布基础功能（PR #2），以及对话操作和社交登录功能（PR #3）。带日期的部署凭据和评审记录位于 docs/history/。合作社和项目发布均为自愿选择；成员记录和私人土地证据仍受服务端访问规则保护。

启动自己的社区

要使用可自托管的应用，请使用 Node 24.19.0，并按照单服务器运维指南操作。该应用包含浏览器账户、SQLite、私人证据文件、设备令牌、托管式 MCP、部署配置以及备份／恢复流程。请先构建并测试一个隔离的本地实例，再将其发布。

仍可通过 Node.js 22.13+ 运行 npm run launch，使用原有的 Cloudflare/Sites 开发流程。该流程的身份验证仅用于开发，不要将此开发服务器公开。在任一工作流中，请创建合作社并按照 开始清单操作。有关区域设置，请参阅全球范围的采用。

Viridis 开放共益项目的一部分

VergeCommon 是五个相互构建的开放项目之一。每个项目单独使用都很有价值；它们共同将一片土地从地图带到经验证的结果。

项目	功能	地址
Dendritic Forest Management（DFM）	从现有道路和水道出发，检查规划采伐时保留的森林是否仍保持连通。MIT。	hdfm-framework · dendriticforest.com
VergeCommon	让邻居运营本地保护合作社：提供私密制图、逐地块征求同意、收集证据并共同决策。在其林地项目中运行 DFM。AGPL-3.0。	verge-common · vergecommon.com
Global Soil Intelligence Project（GSIP）	构建开放的土壤光谱参考库，支持通过手机和 Web 采集数据。代码采用 MIT 许可，数据采用 ODbL 许可。	gsip
ViridisOS	将经验证的结果转化为可重新计算的保护模块和证书，供任何人核验。Apache-2.0。	viridisos
Viridis Research	支撑这些方法的公开、经机器核验的研究记录。CC BY 4.0。	viridis-research

它们的关联方式：DFM 找出廊道的走向。廊道几乎总会跨越产权边界，因此 VergeCommon 为沿线邻居提供私密空间，方便他们组织起来并表达同意。GSIP 为同一片土地补充土壤证据。ViridisOS 让任何人都能重新计算所声称的结果，而 Viridis Research 则保存这些核验所依据的证明。Viridis Conservation（viridisconservation.com）为希望获得协助的团队提供付费的数据准备、评估和支持服务。

用其中某个项目构建了什么？添加徽章并在议题中告诉我们，这样我们就可以添加回链：

[![Part of the Viridis open commons](https://img.shields.io/badge/Viridis-open%20commons-2e7d32)](https://github.com/jdhart81/hdfm-framework#part-of-the-viridis-open-commons)

Agent 和 MCP

想了解 VergeCommon 的 Agent 可以从 llms.txt（源文件：public/llms.txt）和 AGENTS.md 开始；其中说明了如何帮助他人创办合作社以及如何参与贡献。

MCP 服务在可自托管的运行环境中支持本地 stdio 和经身份验证的 Streamable HTTP，端点为 /mcp。本地 stdio 提供公开发现功能以及假设性的汇集／分配草案。拥有 mcp:read 权限的托管令牌还可以读取所有者获准访问的工作区；mcp:write 则增加了范围受限的项目、成员更新、任务和 RSVP 命令。应用令牌和 MCP 令牌的权限范围彼此独立。

五个公开的发现和规划工具无需账户即可通过托管端点使用（但有速率限制）。对于私密合作社工具，请从 /account 创建个人 Agent 令牌，将其保存在客户端的密钥设置中，并在使用完毕后撤销。私密访问需要支持 bearer 认证；目前尚未实现 OAuth。Agent 无法批准法律／财务记录、提升会员权限、发行抵用额度、执行付款或发布公开更新。线上端点于 2026 年 9 月 19 日通过了初始化、私密读取、范围受限的写入以及拒绝财务命令的验收检查。

在你的 Agent 中试用

这五个公开工具无需账号或令牌。在 Claude Code 中：

claude mcp add --transport http vergecommon https://vergecommon.com/mcp

其他接受 JSON 配置的 MCP 客户端，可以将其添加为无需设置请求头的远程 Streamable HTTP 服务（字段名称因客户端而异；有些称类型为 streamable-http，有些只需要 url）：

{
  "mcpServers": {
    "vergecommon": {
      "type": "http",
      "url": "https://vergecommon.com/mcp"
    }
  }
}

可直接粘贴使用的提示词，无需令牌：

1. VergeCommon 无需账号能为我做什么？有没有值得我了解的公开保护合作社？
2. 向我展示 VergeCommon 关于保护合作社如何汇集工作并分享收入的示例，并用通俗易懂的话解释。
3. 使用 VergeCommon，将示例汇集草稿中的成员份额改为 50%、30% 和 20%，生态储备设为 30%，然后重新计算。每位成员的示例份额是多少？

限制：没有令牌时，你只能使用五个公开工具（vergecommon_capabilities、list_public_coops、get_public_coop、example_pooling_draft、prepare_pooling_draft），每个客户端每分钟限 60 次请求，所有客户端总计每分钟限 600 次。私有合作社工具需要个人 Agent 令牌；你可以在账号页面创建该令牌，并在 Authorization: Bearer 请求头中发送。

已实现的功能

• 可见的在线浏览器工作区每 30 秒刷新一次，不会丢弃已挂载的草稿；权限感知型审核提醒涵盖监测和财务记录。

• 管家职责和财务收据补充成员付款收据，具备独立审核、精确分配核对及绑定到项目的证据。这些记录不会转账。

• 在 Discussion 中提供引导式合作社操作，涵盖私密测绘、同意、证据、合作伙伴参与、协议、治理和外部收据，并提供适配角色的选项和保留草稿。对话操作。

• 单服务器 Node 运行时，使用持久化 SQLite 和私密证据文件，并提供经过身份验证的网关、用户名／密码账户、恢复码、账户导出／关闭以及可撤销的设备／Agent 令牌。

• 基于边界的面积估算、重叠筛查、经过审核的地块专属同意、限定范围的协议覆盖、过期记录检测，以及撤回／撤销历史。资源池保护措施。

• iPhone/iPad 源码，用于经过身份验证的成员工作区、成员帖子、明确提交田野草稿，以及主动提交照片／PDF／文本证据。受保护且绑定账户的队列会在连接中断时保留精确的重试请求。公开发现和受保护的离线日志仍可使用；签名、设备验收和 Apple 分发是独立的发布步骤。

• 可导出的影像任务和独立的 NDVI 筛查工作进程，并支持经过验证的结果导入和人工审核。工作进程说明。

• 私密的版本化 GeoJSON 边界、独立审核、明确的外部搜索同意、Copernicus Sentinel-2 目录发现，以及经过审核的实地观测。请参阅监测。

• 成员社区公告板，支持共享活动、考虑容量的报名、私密日历下载、项目讨论和管家审核。

• 六步合作社引导式设置、本地组织发现链接，以及由组织自行填报的资料。

• 一次性私密邀请，支持过期、撤销，以及在访问记录前由管家审批。

• 国家／地区和记账货币设置、正确的货币最小单位，以及公顷／英亩／平方米数据录入。

• 基于快照的碳路径评估，附带方法论参考和独立人工审核。

• 成员提出并投票决定政策前，提供完整的支出预览。

• 已登录且持久化的合作社工作区，支持管家／成员角色和成员资格申请。

• 自愿加入的合作社／项目发现、一般区域搜索、可分享链接、动态和审核。

• 项目、分配的保护行动、完成记录，以及私密地块／同意信息录入。

• 私密协议提交，支持独立审核和外部执行的文书引用。

• 私密 PDF／图像／文本上传、SHA-256 文件摘要、证据提交和独立审核；支持精确重试、取消、过期和持久化清理。

• 合作伙伴代表邀请、接受、提交自身权限证据、由合作社独立审核及撤回。这不会授予额外权限，也不会独立验证组织。

• 粗略容量警告，以及用于经授权安全操作的有限储备；普通新增操作会在达到硬性上限前暂停。

• 版本化分配章程提案，包含冻结的选民名单、成员投票、法定人数和计票结果。

• 外部法律授权、信贷序列化持有、结算、分配、付款收据和注销记录。

• 双人审核、整数分币分配、每个合作社的数量上限、重复引用以及关联的审计历史。

• 限定范围的 JSON 导出、移除成员、成员退出以及工作区归档。

• 独立的假设性 /coop/ 计算器和设备本地的 /demo/ 管家规划工具。

系统不会执行的操作

Verge Common 不会成立法律合作社、执行或登记契约、认证生态测量结果、发行或转让登记信用额度、发起销售、发送付款，也不会独立验证银行或登记机构的收据。这些操作由获授权的人员和外部机构执行。系统会存储相关支持记录和审核决定。

合作社筹备和运营记录工作流已实现；但尚未直接集成登记机构和支付服务提供商。reviewed 收据表示另一位管理员记录了审核，并不表示银行或登记机构已独立向软件验证该收据。请参阅 OPERATIONS.md 和 COOPERATIVE_SYSTEM.md。

本地开发

若要在本地运行可自托管的生产构建，请使用 Node 24.19.0：

npm ci
npm run build:selfhost
VERGE_DATA_DIR=/tmp/vergecommon-local-data npm run start:selfhost

打开打印出的环回地址并注册本地账户。请妥善保管恢复码。数据路径会持久保存；合成验收测试请使用专用的空路径。有关规范源站、反向代理、持久卷和生产设置，请遵循运维指南。

若要使用原有的 Cloudflare/Sites 开发工作流，请使用 Node.js 22.13+ 和 npm。此开发专用登录服务必须保持在本地运行：

npm ci
npm run db:migrate:local
npm run dev

打开打印出的本地 URL 并选择 Sign in。本地数据和文件保存在被忽略的 .wrangler/ 目录下。默认本地身份是开发测试数据，并非生产账户。

验证

如需查看包含预期输出的确切命令（包括使用开放的 DFM 引擎复现的林地廊道检查），请参阅快速入门。如需引用 VergeCommon，请使用 CITATION.cff。

npm test
npm run typecheck
npm run lint
npm run build:selfhost

在本地自托管生产构建使用专用合成数据运行时：

VERGE_TEST_ORIGIN=http://127.0.0.1:3100 python3 tests/selfhost_acceptance.py

此项检查涵盖独立账户、邀请和访问边界、版本冲突与重试、证据存储、令牌范围与撤销、托管 MCP 以及账户关闭。运行器默认使用本地服务；若要在规范生产服务上使用私有合成测试数据，必须明确选择启用。请查看功能验收和部署收据，了解实际结果。

在原有 Cloudflare 开发服务器运行时，执行其 HTTP 持久性和并发检查：

python3 tests/http_integration.py

本地测试使用合成记录，并会归档其工作区。另行授权的生产验收运行也使用了私有合成记录，归档了工作区，并关闭了测试登录账户。

托管与身份验证

两种运行路径共用相同的路由、SQL 架构、合作社状态传输和领域命令：

• 自托管 Node： npm run build:selfhost 会为捆绑网关构建共用应用。SQLite 适配器取代 D1，私有本地证据存储取代 R2。单个应用进程在 Caddy 后运行；内部应用监听器仅限回环访问。浏览器账户使用加盐的 scrypt 密码哈希和安全会话 Cookie。带过期时间的设备/Agent 令牌以哈希形式存储，在每次请求时检查，并且可撤销。写入 Cookie 必须使用规范来源；经过验证的 bearer 客户端使用自身权限范围，不会复制浏览器 Cookie。
• Cloudflare/Sites： npm run build 保留 Worker、D1 和 R2 部署。Sites 分发器提供经过身份验证的身份，并移除调用方身份标头。.openai/hosting.json 保留原始托管项目 ID；分支必须使用各自的项目和存储绑定。

两种路径都会在私有 API 中强制执行合作社成员资格和角色。切勿暴露内部应用监听器，也不要信任调用方提供的身份标头。自托管账户使用用户名和一次性恢复代码，不提供电子邮件验证、电子邮件重置、多重身份验证或 OAuth 提供商。请妥善保存恢复代码。更改/恢复密码会撤销之前的会话和令牌。参见安全、架构和运营指南。

自托管适配器会以事务方式应用现有的初始 SQL 迁移。它不会自动从现有 Sites 部署复制数据或身份信息。请保留已部署的迁移历史，并在备份后演练任何后续架构或记录迁移。

数据边界与运行限制

公开资料仅显示明确公开的项目摘要/更新、概括性地区和活跃成员数。协议、土地引用和证据仅限提交者和管理人员查看。成员可以查看合作社治理和财务记录；不会收集付款银行账户详情。文件以附件形式下载。请查看隐私政策。

自托管运行时支持单个应用进程和单个本地 SQLite 数据库；它不是复制式/高可用部署。每日本地备份已启用，暂存环境和生产环境的恢复验证均已通过，且已将一份匹配的初始生产归档复制到主机之外。具体恢复结果请参阅部署回执。定期加密异地备份计划和恢复密钥保管仍需由运营方配置。每个合作社都是一个原子化版本控制聚合，应用硬限制为 750 KB、500 条成员记录和 5,000 条审计事件。在下一个候选版本中，普通增长会在达到 650 KB 或 4,500 条审计事件时暂停，为经授权的安全操作预留有限空间；私有容量横幅会向成员发出警告。文件存储限制为每个合作社 200 个文件，每个文件 4 MB。在初始合作社伙伴阶段，这种架构优先保证正确性；在更大规模部署前，必须采用规范化的事件/记录存储。跨合作社或跨安装的登记声明仍需由外部登记机构执行权威的重复项/保管权检查。

使命与可持续性

该平台不从信用额度销售中抽取任何比例。经合作社批准的管理和资金分配仍属于合作社资金。可选的托管运营/支持服务或可为维护提供资金；本版本不承诺提供付费服务或带来任何财务结果。

该仓库包含干净的公开系统。独立的私有研究、证明候选版本、生产记录和私有试点源代码未作为批量版本发布。我们不声称获得任何正式或生态认证。

Viridis 开源共享体系的一部分

正在规划道路或溪流附近的管理工作？DFM 会提供保留方案，供合作社共同审阅；GSIP 则会补充土壤观测数据。目前，两者之间的衔接仍需手动完成。

本项目是 Viridis 一组互联开源工具中的一员。每个工具都可独立使用；合起来，它们覆盖从实地证据到经核验决策的完整流程。

保护共享体系

• VergeCommon（本仓库）：面向社区保护合作社，提供基于知情同意的土地制图、实地证据和集体决策
• Dendritic Forest Management (DFM)：比较道路和水道周边的森林保留方案，并提供可追溯的输入和可移植报告
• Global Soil Intelligence Project (GSIP)：贡献土壤观测数据，并浏览标明明确不确定性的开放土壤地图

可验证科学

• Viridis Canon：用于生态决策的 Lean 4 数学，经机器核验，每项结果均有 DOI
• ViridisOS：用于 DOI 支持的决策模块和可重新计算结果的开放参考运行时
• Viridis Research：每晚更新的公开研究记录，每项主张均标明核验器实际检查的内容
• ProofLens：在阅读证明之前，先了解 Lean 语句的含义

Agent 工具

• Viridis Agent Fleet：核心确定性且可审计的开源 MCP Agent
• EnergyAI MCP：为 AI Agent 提供能源规划估算和激励措施来源

在 Viridis 主页浏览所有项目。如果这个项目对你有帮助，点个星标能让更多人发现它。

许可证

原创代码和原创工作流模板：仅限 GNU AGPL v3.0。请参阅 LICENSE、NOTICE 和 THIRD_PARTY_NOTICES.md。依赖项代码保留各自的许可证。欢迎分叉；请勿借助 Verge Common 这一名称暗示我们为分叉项目背书。

共享服务和原生应用

网站和原生客户端使用本仓库的合作社服务。请参阅架构和旧版协调说明及 iPhone/iPad 构建状态。原生应用已实现公共发现、个人设备身份验证、成员帖子、带受保护的显式重试功能的私密讨论回复，以及显式提交实地观测数据，均基于 https://vergecommon.com 实现。高级治理、邀请、制图和财务工作流请使用网站。实体设备验收、签名和 TestFlight/App Store 分发仍是发布要求；源代码实现并不代表已发布移动版本。

v0.9.0 中的参与流程

分享一个公开项目、活动或进展页面，并附带社交媒体预览和二维码。接收者可在登录前预览活动目的，申请管理员批准后返回同一活动。记录实际出席情况和已完成的工作，交由另一位管理员审核，然后预览并发布公开结果，或撤回该结果。具体的会议说明、边界、成员姓名和文件均保持私密。

在合作社内打开 Care & participation，即可分配有日期或周期性的养护和扰动响应任务、提交佐证、审核完成情况、启用可选的浏览器提醒，并查看管理员的参与者报告。使用该报告前，请正确标记测试账号；匿名访客和因果关系意义上的病毒式传播均不会纳入统计。请参阅服务覆盖范围、隐私政策和运营人员恢复说明。