Eclipse Gig Core MCP

Eclipse Gig Core MCP

由 Cyan Eclipse Technologies 提供支持 — https://cetech.ai

Eclipse 零工适配器系列——一份经所有者批准的规范任务简报，会根据每个任务平台实际认可的方式，转化为原生请求、报价轮次、预订或准备资料包。只有在 Eclipse Procure / Agent Wallet 授权范围内才会雇用。它绝不会引导用户绕过平台进行雇用，绝不会虚构不存在的获准操作界面，也绝不会发布未经所有者批准的简报。

创建此项目的原因

各任务平台的运作方式并不相同：Thumbtack 采用线索／请求模式，Airtasker 采用发布和报价模式，TaskRabbit 的合作伙伴界面采用固定价格预订，Fiverr 是零工目录，Upwork 则采用合同／提案模式。不存在通用的“发布”，也不存在通用的“价格”。零工核心是整个系列达成一致的唯一之处：一份由哈希绑定的任务简报、一次将报价规范化为全包总价的处理、一道雇用关卡、一套完成标准，以及一套评价规范。每个平台适配器（首个是针对 Thumbtack 的 Compass）都会以原生形式呈现简报，绝不会抹平各平台的雇用方式。该系列是 Eclipse Procure 人工服务的供给侧。

状态 — 如实标注

v0.1.0，阶段 G0（共享核心，仅夹具与评估）。本地 stdio 传输，仅使用 Python 标准库。**代码中不存在任何实时平台调用，不会执行雇用，不会转移款项，不会提交评价，也未声称获得认证——基准测试待完成。**实时请求／雇用界面属于 G1 阶段的适配器，须通过所有者的合作伙伴访问权限关卡。

任务简报

每项任务对应一个不可变、带版本号的对象：类别 + 服务、范围说明（完成后的标准）、ZIP 区域级位置（确切地址仅在平台自身的雇用后流程中提供——包含精确地址的简报会被拒绝）、时间窗口、一个全包预算上限、照片参考及记录在每条照片记录上的 EXIF 剥离状态、license_required（unknown | no | yes:<type>）、安全与访问说明、预期／禁止使用的平台，以及供适配器提取原生表单答案的详细信息包。

批准会绑定简报的 SHA-256 内容哈希，以及一并获批的各平台变体哈希。批准后任何编辑都会创建新版本并使批准失效——批准绑定的是哈希，而非主观印象。

报价规范化——全包报价，否则不算报价

每份报价都会规范化为一条记录：服务者身份及原样呈现的执照声明（绝不声称其有效）、基础价格、注明承担方的分项费用、平台声明的税费，以及一个 ALL_IN_TOTAL。费用始终作为独立字段保留；比较和预算上限测试只针对全包总价。服务者承担的费用（如 Thumbtack 的线索费）会列明，以解释报价水平，但不会向买家收取，也不计入买家的全包总价。按小时计费的报价为费率 × 所有者批准的小时上限；超出部分须重新审核。

如果平台未公开报价费用，该报价会标记为 UNEXPOSED，并且不得在预算上限约束下雇用。唯一的例外方式是由所有者针对该报价出具书面例外，并记录在批准资料包中；根据所有者提供的费用数字计算全包总价，并注明该计算依据——状态仍为 UNEXPOSED，因为平台从未公开这些费用。

招聘门槛

hire_check 不会执行任何操作；它会根据实时的 Eclipse Procure / Agent Wallet 授权来评估招聘：简报已在当前哈希值下获批、授权存在且未过期、总价不超过授权上限和简报上限、类别与平台在允许列表内、审批阈值（超过阈值时，需要所有者针对此确切报价提供令牌；令牌格式为 approve-quote-<quote_id>）、报价有效期、费用敞口。每项检查，无论 ALLOW 还是 DENY，都会生成回执。

**在 v1 中，人员选择必须由所有者确认，无论是否有授权：**如果授权检查结果为 ALLOW，但没有所有者确认令牌（confirm-person-<quote_id>），则返回 MANDATE_ALLOW_PERSON_PENDING，且 hireable: false。选择一位进入所有者家中的人员，不应仅凭预算规则决定。

完成情况 + 评价

平台标记为已完成并不代表已核实。completion_verify 会逐项检查范围项目（已完成 / 部分完成 / 未完成，并附所有者证明），并将平台状态原样存储在独立字段中；如果平台声称已完成，但所有者未予证明，则会创建 exception 记录——绝不悄悄修改。

review_draft 仅依据核验记录撰写：招聘了什么、核实了什么，以及记录中严格载明的及时性 / 沟通 / 质量。记录中没有质量备注时，草稿完全不会包含任何质量评价。起草时会拒绝带有施压意味的措辞（如“退款，否则……”）。草稿不会自行提交；所有者必须批准确切文本。

工具（10 个）

工具	功能
brief_create	创建任务简报；验证完整性 + ZIP 等级精度；生成版本 1 的哈希值。
brief_update	根据内容更改创建新版本；使任何已有审批失效。
brief_approve	记录所有者对当前确切哈希值 + 变体哈希值的批准。
brief_read	读取简报及其审批有效性。
quote_normalize	将任何报价模式（线索价 / 声明预算 / 固定价 / 按小时计价）统一为报价面值 + 逐项费用 + 总价；可选进行上限测试。
quote_read	读取已标准化的报价；可选重新测试上限。
hire_check	授权门槛：ALLOW / MANDATE_ALLOW_PERSON_PENDING / DENY，附具名原因并生成回执。不执行任何操作。
completion_verify	逐项范围核验记录；平台状态单独记录；不匹配时创建例外。
review_draft	与记录绑定的评价草稿；不包含未经记录的主观评价；拒绝带有施压意味的措辞。
receipt_list	列出仅可追加的回执链并进行验证。

拒绝列表在代码中明确列出：不存在 request_submit、hire_execute、payment_execute、review_submit，也不存在任何会话 / 抓取途径（session_login、cookie_reuse、scrape_*），任何层级均不提供（规范 §8.6）。

运行

python3 server.py            # MCP over stdio, stdlib only, no dependencies
python3 smoke.py             # end-to-end smoke over real stdio (temp state)
python3 -m unittest discover tests
python3 make_icon.py         # regenerate icon-512.png

状态会持久化到服务器旁的 data/state.json（可通过 ECLIPSE_GIG_CORE_STATE 覆盖）。data/ 已加入 gitignore。

路线图（依据规范）

• G0 — 此核心功能 + Compass（Thumbtack）夹具适配器。
• G1 — 在所有者取得 Thumbtack 合作伙伴访问权限后，启用 Compass 实时模式。
• G2 — Airtasker 界面核验冲刺（在确认获准途径之前，Eclipse Tender 仅用于准备工作）。

许可 / 归属

Cyan Eclipse Technologies 的产品。“Powered by Cyan Eclipse Technologies”归属声明随产品一同提供。