用户入口
复制给 Agent，就能开始安装
AgentParty 是底层框架。普通用户不用读脚本，直接获得 OS 边界、安装步骤、preflight 和下一步。
10:38:00 AM
多 Agent 协作的底层协议
AgentParty
Installable protocol · TriParty pack · Evidence gate
用户不用读命令
直接复制给 Agent
直接复制给 Agent
Agent 在本机安装
并回报检查结果
并回报检查结果
不会把未完成说成完成
本机可安装
把多 Agent 协作变成可安装、可审计、可复用的工作框架
官方三方包
TriParty
Codex + Claude + Gemini。只有 review、cross-audit、merge、release gate 都通过，才写 true_triparty_ready。
飞书协作包
Claude Code + Feishu Claw
用于飞书文档和 Claw transcript 后验收。它是 2-agent pack，不声称 true tri-party。
底层框架 + 两个产品化产物
先把框架立住，再把产品包做实
AgentParty 解决“同一个 skill 到不同 agent 会折损”的问题；TriParty 是官方三方包；Claw 包服务飞书协作。结论必须靠证据，不靠口头完成。
01 · 底层
AgentParty
定义 agent 如何协作、审计、产出证据
协议层只规定 Agent、Capability、Role、Artifact、Audit、Gate 和 RunState；模型品牌只是配置。
02 · 产品包
Pack
把协议封成可安装、可复用的组合
TriParty 是 Codex + Claude + Gemini 的官方三方包；Claude Code + Feishu Claw 是飞书协作的 2-agent 包。
03 · 证据
Gate
probe 成功不等于 review 完成
preflight、review、cross-audit、merge、release gate 都要留下文件证据；partial 不能写成 complete。
Productized
TriParty
Codex + Claude + Gemini，默认三方套件
适合复杂方案、代码/设计/研究发布前复核。只有通过三方证据和 release gate，才声明 true_triparty_ready。
Scaffold
Claude Code + Feishu Claw
飞书文档和 Claw transcript 协作入口
Claude Code 生成 kit、guide 和复核要求；Claw 提供 transcript、飞书链接和操作摘要。它是 AgentParty 子集，不声称 true tri-party。
方案
重要决定
先过三方复核
让 Codex 看落地、Claude 看逻辑、Gemini 补外部视角，再合并结论。
内容
选题发布
留下判断依据
从标题、受众、论点到发布检查，都能变成可复盘的 evidence。
飞书
Claw 协作
文档操作可验收
用 kit 和 evidence bundle 记录 Claw 做了什么、Claude 怎么复核。
边界
失败也清楚
partial 就标 partial
缺认证、缺模型、缺 cross-audit 时，页面和 CLI 都不能包装成完成。
复制给 Agent
最推荐的用法：复制一段委托话术给你的 AI agent，让它在本机安装并回报结果。
当前 TriParty 推荐在 macOS、Linux、Windows WSL2 中安装。Windows 用户可以从 PowerShell 复制一条 WSL2 bootstrap 入口，但真实安装仍在 WSL2/Linux 中执行，不把 native PowerShell 写成已完成。 macOS 可按当前流程 Linux 可按当前流程 Windows WSL2 当前路径 PowerShell 启动 WSL2
Windows 怎么装
当前推荐 WSL2。PowerShell 提供一条 bootstrap 入口，把用户带到 WSL2 安装路径；PowerShell 原生执行仍未完备。
推荐路径
用 WSL2
Windows 用户先进入 Ubuntu，再按 Linux 路径安装 TriParty。
查看 WSL2 命令
wsl --install -d Ubuntu
wsl
git clone \
https://github.com/r-design-j/tri-party-framework.git
cd tri-party-framework
scripts/agentparty.sh quickstart --pack triparty --target-os auto
一键入口
PowerShell 启动 WSL2
复制一条命令给 Windows 用户；它会 dry-run 或通过 WSL2 执行安装，不在 PowerShell 里直接跑 triparty。
查看 PowerShell 命令
.\scripts\agentparty-windows-wsl2-bootstrap.ps1
.\scripts\agentparty-windows-wsl2-bootstrap.ps1 -Execute
页面原则
少说路线
未完成能力只留边界提示，不把 bootstrap 写成 native PowerShell parity。
用户只需要记住：Windows 从 PowerShell 入口进入 WSL2。
AI 时代入口
复制给 Agent
普通用户只需要复制这段委托，让本机 agent 安装 TriParty 并回报检查结果。
查看完整委托
请在这台机器上安装 TriParty。
目标仓库：https://github.com/r-design-j/tri-party-framework
执行要求：
先判断系统环境：macOS / Linux / Windows WSL2 可按当前流程执行；Windows 原生 PowerShell/CMD 目前只做环境准备和检查，不要硬跑 bash 脚本，请引导进入 WSL2 或等待 PowerShell 原生 AgentParty CLI 路线完成。
1. clone 仓库并进入目录。
2. 补齐必要脚本权限。
3. 运行项目自检。
4. 安装全局发现规则和 TriParty 命令。
5. 运行 TriParty preflight 验证。
6. 如果缺少 Claude Code、Gemini CLI、认证或权限，请明确报告缺失项；不要把 partial run / 未完成协作说成 true tri-party / 完整三方。
完成后告诉我本机安装路径和 preflight 结果。
终端命令
让 Agent 执行
给能运行 shell 的 agent 使用。普通用户不需要逐行读命令。
查看完整命令
# 适用 macOS / Linux / Windows WSL2；PowerShell 原生路线仍在 AgentParty 通用层中。
git clone https://github.com/r-design-j/tri-party-framework.git
cd tri-party-framework
chmod +x scripts/*.sh adapters/http/triparty_http_adapter.py adapters/mcp/triparty_mcp_adapter.py
scripts/triparty-lint.sh
scripts/agentparty.sh install --pack triparty --target-os auto
scripts/agentparty.sh install --pack triparty --target-os auto --execute
triparty preflight
飞书协作包
复制 Claw 包
用于 Claude Code + 飞书小龙虾 Claw。它是 2-agent 包，只做 evidence 后验收。
查看完整 Claw 委托
请按 AgentParty 的 Claude Code + Feishu Claw 产品包处理这个任务。
目标：<任务>
要求：
1. Claude Code 先输出任务拆解、风险、需要 Claw 执行的飞书动作。
2. 把 Claw 要执行的动作写成可复制指令。
3. Claw 执行后，把飞书链接、操作摘要和 transcript 填入 AgentParty evidence bundle；可用 evidence-fill 设置链接和复制本地证据文件。
4. Claude Code 读取 transcript，检查是否满足任务 brief。
5. 如果缺权限、缺链接、缺 transcript 或结果不一致，标记 partial，不要声称完整完成。
6. 这是 2-agent AgentParty pack，不要声称 true tri-party，不要写 true_triparty_ready=true。
7. 最终只允许输出 pack_ready、partial、blocked 或 scoped。
会发生 01
拉取项目
Agent 会从 GitHub 拉取 TriParty，并在本机建立一个可重复使用的框架目录。
你不需要手动下载 ZIP，也不需要逐条复制命令。
会发生 02
写入规则
Agent 会安装全局发现规则，让之后的新会话也能找到 TriParty，不需要每次重新解释。
Claude Code 会有 `/triparty` 和 `/tp`，Codex 可用 `triparty` 命令。
会发生 03
回报结果
Agent 会运行安装检查，并告诉你是否可用；如果缺少 Claude、Gemini 或登录认证，它会明确报出来。
重点是知道“装好了没有”，而不是让用户自己猜。
给 Agent / 高级用户
高级工具与排查台
普通用户通常不需要读这里。安装失败、需要验证 TriParty 产品包是否真的完成、或开发者接入 AgentParty 通用层时，再展开这些工具。
展开
给 Agent / 高级用户
高级工具与排查台
普通用户通常不需要读这里。安装失败、需要验证 TriParty 产品包是否真的完成、或开发者接入 AgentParty 通用层时，再展开这些工具。
安装后检查
如果 Agent 回报失败，可以把运行状态文件粘到这里，确认是完成协作、未完成协作，还是登录/环境问题。
只生成命令，不执行模型
本页只读 TriParty 的 `state.json` 并生成可复制命令；真实执行请回到 Codex、Claude Code、Gemini CLI、CLI/Python/HTTP/MCP adapter。未来 AgentParty state 会作为通用层扩展。
模块 01
状态检查
给 Agent 和高级用户看的核验区：只读运行状态，不把未完成协作说成完成。
当前基线
运行状态文件
merged_ready协作阶段
true是否完成
0错误数
等待运行状态文件。页面只读结果，不自行把未完成协作升级为完成协作。
命令 01
检查本机
scripts/triparty.sh preflight
命令 02
发起协作
scripts/triparty.sh run '<task>'
命令 03
发布前检查
scripts/triparty.sh release-gate docs/framework/runs/review-YYYYMMDD-HHMMSS
命令 04
恢复上下文
scripts/triparty.sh continuity bootstrap
命令 05
生成 Claw Kit
scripts/agentparty.sh kit --pack claude-code-feishu-claw --task '<task>' --out claw-kit
命令 06
生成 Claw 证据包
scripts/agentparty.sh evidence-template --pack claude-code-feishu-claw --run-dir '<run-dir>' --out claw-evidence
命令 07
导入 Claw Bundle
scripts/agentparty.sh evidence --pack claude-code-feishu-claw --bundle claw-evidence/agentparty-claw-evidence.json
命令 08
验证 Pack 状态
scripts/agentparty.sh validate-run --run-dir '<run-dir>'
命令 09
下一步指南
scripts/agentparty.sh guide --pack claude-code-feishu-claw --run-dir '<run-dir>'
命令 10
查看产品包
scripts/agentparty.sh info --pack claude-code-feishu-claw
命令 11
产品化上手
scripts/agentparty.sh onboard --pack triparty --target-os auto
命令 12
快速上手
scripts/agentparty.sh quickstart --pack triparty --target-os auto
命令 13
安装预检
scripts/agentparty.sh install --pack triparty --target-os auto
命令 14
执行安装
scripts/agentparty.sh install --pack triparty --target-os auto --execute
命令 15
生成安装计划
scripts/agentparty.sh install-plan --pack triparty --target-os auto
命令 16
Windows WSL2 入口
.\scripts\agentparty-windows-wsl2-bootstrap.ps1 -Execute
命令 17
发布自检
scripts/agentparty.sh release-check --full
命令 18
生成发布包
scripts/agentparty.sh package --out dist/agentparty-release --archive
命令 19
卸载预检
scripts/uninstall-triparty-global-bootstrap.sh --dry-run
命令 20
PowerShell 卸载预检
.\scripts\uninstall-triparty-global-bootstrap.ps1 -DryRun
UI 前置
0 / 6 已完成
等待 checklist 状态。
可信证据
这些内容不是给普通用户必读，而是说明 AgentParty 的证据链原则如何在 TriParty 产品包中落地，并判断“完成 / 未完成 / 失败原因”。
案例 01已实现
state view
status可视化状态检查
案例 02已实现
gate view
gate ready发布门禁解释
案例 03已实现
route view
error map失败恢复路由
案例 04下一步
api view
API只读接入边界
证据详情
这里解释每个高级工具解决什么问题、为什么不能只靠聊天结论判断安装成功。
案例 01 · 已实现
运行状态检查
把一次协作运行的结果变成可读、可检查、可解释的页面。
真实问题
用户或 agent 看到一堆运行文件时，容易把“部分完成”误读成“已经完成”。
怎么修
只读取核心状态字段。页面负责解释，不自己发明成功标准。
发生了什么
点击“加载完成样例”或“加载未完成样例”，页面会改写状态卡片和底部提示。
结果
它不是纯说明文字，而是能解析运行状态的前端检查器。
约束
它不会直接读取本机文件，也不会直接调用模型；这样避免把浏览器页面变成未经审计的执行入口。
下一步
冻结运行状态格式后，可以把粘贴输入升级为本地只读加载，仍然不直接执行 agent。
案例 02 · 已实现
发布前检查
把发布前判断变成可解释界面：为什么能发、为什么不能发、缺哪一方证据。
真实问题
“能不能发布”不能靠聊天结论，必须依赖文件证据、hash 和完成标记。
怎么修
页面把发布前命令、状态摘要和“未完成协作”的阻断语放在同一视图里。
发生了什么
完成样例会显示可支持发布声明；未完成样例会明确写出不能升级为完整协作。
结果
产品化价值在于降低判断成本，而不是绕过真正的发布前检查。
约束
页面不会把单方输出包装成三方完成。缺证据时必须阻断。
下一步
补全 artifact SHA256、sanitizer_version、retry/timeout 的可视字段，让门禁解释更完整。
案例 03 · 已实现
失败恢复
把最常见的 TriParty 失败变成中文恢复路线，而不是让用户在 stderr 和日志里猜。
真实问题
登录认证、运行噪声、文件不一致、未完成协作是不同问题，混在一起会导致错误修复路径。
怎么修
排查工具提供错误码下拉选择，输出对应中文解释和下一条命令。
发生了什么
选择错误码后，页面会立即给出认证检查、环境检查、发布前检查或重跑建议。
结果
这是可体验功能，不是纯文档。它让新用户知道下一步该回到哪个真实执行面。
约束
恢复建议不会自动执行，避免误触发模型、网络或文件写入。
下一步
把映射表从内联 JS 抽到稳定 JSON，并由 regression 覆盖错误码文案。
案例 04 · 待接入
开发接入
真正的产品化不是让网页直接变 agent，而是让 UI 清楚展示本地执行层的边界。
真实问题
如果网页看起来像能一键调用三模型，用户会误以为浏览器就是执行层，反而破坏可信边界。
怎么修
UI 只展示约定、复制请求、解释返回。真实调用仍在本机执行层。
发生了什么
当前页面已经把接入清单写清楚：冻结状态字段、补样例、只读接入本地服务。
结果
它能承接产品化演示和外部接入沟通，但不越权承诺浏览器端能完成三方运行。
约束
本地服务默认只在本机运行，不能被 UI 文案包装成公网 SaaS。
下一步
补 `ui-scope.md`、`surface-binding.yaml` 或等价文档，再接入只读 API。
排查工具
给 agent 和高级用户使用：生成命令、解释失败原因、确认下一步。
任务命令生成器
scripts/triparty.sh run '检查 TriParty 是否安装成功，并说明下一步该做什么。'
失败恢复路由
先运行 `scripts/triparty-gemini-auth-doctor.sh`。如果仍是 interactive-auth-required，先在 Gemini CLI 完成登录，再重新跑 `scripts/triparty.sh preflight`。
开发者接入
- 新增 AgentParty 底层说明，同时保留 TriParty 作为官方三方产品包。
- 新增 Claude Code + Feishu Claw 产品包脚手架，作为 2-agent AgentParty pack。
- 新增产品包注册表，区分 true tri-party 与 pack-ready / partial / blocked。
- 冻结运行状态字段，避免 UI 猜测协议。
- 补齐完成、未完成、认证失败、文件不一致等样例。
- 把当前静态页面接入本地只读服务，不直接调用模型。
- 公开访问地址：https://r-design-j.github.io/tri-party-framework/
- 保留 TriParty 作为产品名；把 AgentParty 标为母框架 / 通用协议层。