memsuOS 使用示例

这些示例复用 memsuOS 的正式 runner，不在示例目录里另造一套 Agent 编排逻辑。

本页列出的命令只使用 mock 或确定性的本地机制，不需要 API key，也不会执行网络、shell、Git、数据库或仓库外文件写入。真实模型配置请参阅根目录 README。

1. 一次运行常用安全示例

在仓库根目录执行：

.\examples\run-safe-samples.ps1

也可以指定 Python 和输出根目录：

.\examples\run-safe-samples.ps1 `
  -Python .\.venv\Scripts\python.exe `
  -OutRoot .memsuos\examples

脚本会在一个带时间戳的目录中生成：

.memsuos/examples/<timestamp>/
  open-org/
    open-org-session.jsonl
    open-org-session-summary.json
    open-org-session-report.md
    input-goal.md
  organization-patterns/
    parallel-org-eval-summary.json
    parallel-org-eval-report.md
    roundtable_meeting/
    parliament_vote/
    self_organizing_discussion/
  supervision/
    supervision-loop.jsonl
    supervision-summary.json
    supervision-report.md
  swarm/
    swarm-run.jsonl
    swarm-summary.json
    swarm-report.md
  eacn/
    eacn-run.jsonl
    eacn-summary.json
    eacn-report.md

.memsuos/ 已被 Git 忽略。

2. 使用目标文件启动开放组织

示例目标位于 goals/release-readiness-review.md：

python -B scripts/run_open_org_session.py `
  --goal-file examples/goals/release-readiness-review.md `
  --provider mock `
  --runtime local `
  --out-dir .memsuos/examples/release-review `
  --max-artifacts 1

完成后应优先检查：

.memsuos/examples/release-review/open-org-session-summary.json
.memsuos/examples/release-review/open-org-session-report.md
.memsuos/examples/release-review/open-org-session.jsonl

零退出码不代表真实模型成功。使用 API 或 CLI provider 时，还应确认 artifact 不是 ModelFailureObservation。

3. 观察 autostart 治理路径

下面的命令只允许本地 simulation，不授予工具调用、策略修改、任意文件、remote 或其他外部副作用：

python -B scripts/run_open_org_session.py `
  --goal "提出一个只读研究组织，并说明启动理由和参与者" `
  --provider mock `
  --runtime local `
  --out-dir .memsuos/examples/autostart-observation `
  --max-artifacts 1 `
  --allow-autostart `
  --autostart-consensus-max-rounds 1

mock 只用于验证安全路径，不等于真实多模型会议。单轮结果应描述为 observation，而不是已经收敛的 consensus。

4. 圆桌、议会表决与自组织讨论

运行三种内置的组织形式观察探针：

python -B scripts/run_parallel_org_eval.py `
  --tasks roundtable_meeting,parliament_vote,self_organizing_discussion `
  --proposer mock `
  --critic mock `
  --context mock `
  --runtime local `
  --out-dir .memsuos/examples/organization-patterns `
  --max-artifacts 1 `
  --max-parallel 1

只运行圆桌样例：

python -B scripts/run_parallel_org_eval.py `
  --tasks roundtable_meeting `
  --proposer mock `
  --critic mock `
  --context mock `
  --runtime local `
  --out-dir .memsuos/examples/roundtable `
  --max-artifacts 1 `
  --max-parallel 1

这些任务通过 reference deliberation runner 观察 proposer、critic 和 context-holder 的产物、治理与 runtime 结果。roundtable、parliament 和这些参考角色都只是评测脚手架；模型仍可提出完全不同的组织形态。

5. 监督模式

运行一个两轮 reference supervision loop：

python -B scripts/run_supervision_loop.py `
  --task "让一个工作 Agent 制定只读发布审计清单，由监督者检查遗漏、越权和过度控制风险" `
  --provider mock `
  --rounds 2 `
  --runtime local `
  --out-dir .memsuos/examples/supervision `
  --max-artifacts 1

输出包括：

supervision-loop.jsonl
supervision-summary.json
supervision-report.md

worker、supervisor、critic 和 context-holder 是监督压力与漂移观察用的参考角色。监督结论仍是 advisory signal，不能绕过 GovernanceActionSpec 和 AuthorizationDecision。

如需运行仓库内置的完整监督任务集：

python -B scripts/run_supervision_loop.py `
  --task-set supervision `
  --provider mock `
  --rounds 2 `
  --runtime local `
  --out-dir .memsuos/examples/supervision-task-set `
  --max-artifacts 1

6. 分别运行本地 swarm 与 EACN-lite

python -B scripts/run_local_swarm.py `
  --goal "比较三个只读发布审计方案，并保留少数意见" `
  --out-dir .memsuos/examples/swarm

python -B scripts/run_local_eacn.py `
  --goal "为一个只读研究任务匹配能力并解释裁决结果" `
  --out-dir .memsuos/examples/eacn

这些机制产生可审计的本地 ledger、summary 和 report；它们不代表生产级分布式执行。

7. 打开 replay 和 Organization Observatory

将 ledger 路径替换为任意 open-org 示例产物：

python -B scripts/serve_interaction_replay.py `
  .memsuos/examples/release-review/open-org-session.jsonl `
  --ui-version v2 `
  --open

可访问：

http://127.0.0.1:8765/
http://127.0.0.1:8765/v2
http://127.0.0.1:8765/v2/flow

8. 在 Codex App 中调用

仓库已经附带可安装的 Codex App marketplace、memsuOS 插件和 Fusion 插件。安装方式见根目录 README.md。

可以直接复制 codex-app-prompts.md 中的提示词开始使用。

FilesExpand file tree

README.md

Latest commit

History