git clone https://github.com/LucasDevKid9/collab-charter && cd collab-charter

# 会话开始：第一章要求的接收自检（≤3 行）
PYTHONPATH=src python3 -m collab_charter.cli receipt

# 这次该走全量还是快速通道？
PYTHONPATH=src python3 -m collab_charter.cli route "帮我重构这个模块"
# → Route(全量): 安全闸门 → 意图解析 → 认知镜像 → 记忆检索 → 角色协作 → 综合裁决 → 输出 → 反馈回流

# 跑完整管线，看逐站轨迹 + 输出 + 自检结论
PYTHONPATH=src python3 -m collab_charter.cli handle "重构这个模块" --constraint 保持API兼容

# 查任意条款原文（「查来源」用）
PYTHONPATH=src python3 -m collab_charter.cli clause 0.5-R4

# 宪章完整性自检
PYTHONPATH=src python3 -m collab_charter.cli verify

# 知识库摘要（第十一章：词条数 / 断链 / 跨文件同名 / 未验证）
PYTHONPATH=src python3 -m collab_charter.cli kb

# 语义场深挖：加权词条 + 分布权重 + 闸门结论 + 覆盖缺口
PYTHONPATH=src python3 -m collab_charter.cli mine "谷圈 痛包 晒谷" --state 收敛期

# 潜空间语义场：关联网络 / 中心性 / 社群 / 缺口
PYTHONPATH=src python3 -m collab_charter.cli field "谷圈 痛包 晒谷" --state 收敛期

# 符号锚定：多条件权衡交给 z3 硬算（需 pip install z3-solver）
PYTHONPATH=src python3 -m collab_charter.anchor \
  --declare "x:可行性,y:预算充足,z:时间允许,w:风险可控" \
  --constraints "x+y+z+w>=3; Implies(y==0,w==1)" \
  --decisions "做:x+y+z+w>=4; 观望:x+y+z+w==3; 不做:x+y+z+w<3" \
  --rounds "|y==0"

# 治理内核：回放审计账本（每次 handle 自动记录，决策可解释、可复盘）
PYTHONPATH=src python3 -m collab_charter.cli replay --sessions          # 列出审计会话
PYTHONPATH=src python3 -m collab_charter.cli replay <session> --step    # 逐事件回放
PYTHONPATH=src python3 -m collab_charter.cli replay --why <decision_id> # 解释某条决策（为什么拦/放）
PYTHONPATH=src python3 -m collab_charter.cli replay <session> --json    # 机器可读导出

# 宪章编译为策略IR + 风险概览 + 宪章差分（治理内核·P2-10 轻量版）
PYTHONPATH=src python3 -m collab_charter.cli policy --summary           # 风险档概览
PYTHONPATH=src python3 -m collab_charter.cli policy --risk critical     # 只看高危条款
PYTHONPATH=src python3 -m collab_charter.cli policy --diff 另一份.yaml  # 宪章差分（改了什么）
PYTHONPATH=src python3 -m collab_charter.cli policy --json              # 机器可读导出

from collab_charter import Charter, Session
from collab_charter.flows import user_instruction, model_speculation

session = Session(Charter.load())
session.register_tool(ToolSpec("web_search", "联网检索", my_search_fn, {"q": {"type": "string"}}))

session.ask("帮我查一下 z3 的最新技术选型")
session.call_tool("web_search", q="z3 solver 2024")
out = session.handle("顺便评估下迁移成本", constraints=["不能停机"])

print(out.text)         # 输出
print(out.trace)        # 逐站轨迹（「讲思路」时展开）
print(out.explain_failures())  # 自检没通过时说清楚哪里没通过

# 方式 A：显式回流（沉淀整个会话的关键流）
session.reflow()
out = session.handle("再确认一次", constraints=[])

# 方式 B：白名单自动沉淀（命中消息文本或 memory_key 的流自动入库，本次即通过）
out = session.handle("记录一下：先过闸再断言", auto_deposit_keys=("先过闸",))
assert out.selfcheck.passed

from collab_charter.router import PipelineStage

out = session.handle(
    "帮我重构这个模块",
    mirror_fn=lambda flows: "镜像：你的隐含诉求是低风险重构",
    council_fn=lambda flows: real_llm_council(flows),   # 真实三角视角
    stage_hooks={PipelineStage.INTENT: tag_flows},      # 任意站点拦截
)

{
  "mcpServers": {
    "collab-charter": {
      "command": "python3",
      "args": ["/绝对路径/collab-charter/interfaces/mcp_server.py"]
    }
  }
}

PYTHONPATH=tools python3 -m fcslint "古早立绘，半身像，赛璐璐平涂，16-bit indexed color，硬边缘，4:3"

charter/           ① 宪章层   CHARTER.md（人读） · charter.yaml（★单一事实源） · compact.md（精简版）
knowledge/         ② 知识层   lexicon.yaml · styles.yaml · subcultures.yaml（330 条，11.1）
src/collab_charter/ ③ 内核层  flows · gates · router · arbiter · memory · selfcheck · session · cli
                              · lexicon/（知识库四件套） · anchor/（符号求解器）
interfaces/        ④ 接口层   mcp_server.py（零依赖 MCP，14 工具）
tools/             ⑤ 工具层   fcslint/（特征簇诊断） · anchor/solve.py（兼容 shim）
skills/            ⑥ 技能层   using-charter · info-flow-protocol · feature-cluster-syntax
                              · deep-research · authoring-skills
harnesses/         ⑦ 适配层   claude/codex/cursor 清单 · session-start 钩子 · tool-mapping.md
tests/             ⑧ 验证层   368 项测试，含条款↔实现双向追溯
docs/              ANALYSIS · ARCHITECTURE · SEMANTIC-FIELD · TRACEABILITY

python3 -m pytest -q                              # 368 项
python3 -m pytest tests/test_traceability.py -v   # 条款追溯
PYTHONPATH=src python3 -m collab_charter.cli verify