Files
Hermit/docs/parliament.md
T
WHCandCursor e610d70c30 fix: interactive Realm password, recoverable worker budget (0.9.15)
Prompt for Realm password when CST_REALM_PASSWORD is unset; map worker
request-gate exhaustion to a clear budget error with partial progress;
hard-skip identical tool failures after 3 tries. Add docs/parliament.md.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-29 10:53:36 +08:00

2.0 KiB
Raw Blame History

Parliament(议会)快速上手

密码串派生 Realm → 登录夺主席 → 常驻服务同步上下文。同一时刻只有一个主席;换项目清空全部议会上下文。

一次性初始化

# 交互输入密码,或事先 export CST_REALM_PASSWORD=…
cst-agent --realm-password-init

磁盘只存 salt + 公钥,不存私钥。

日常:登录即夺主席

export CST_INSTANCE_ID=laptop-a   # 可选;默认 chair-local
cst-agent --login --realm-label "thinkpad"
# 也可:CST_REALM_PASSWORD=… cst-agent --login

效果:

  1. 用密码解锁 Realm,本机成为唯一主席(上一主席被交接)
  2. 写入本地登录票(24h)
  3. 拉起后台议会服务(发现 + 按 revision 同步 parliament.context)

查看状态:

cst-agent   # 进入 TUI 后 /status
# 或 CLI
cst-agent --service-stop   # 停服务

密码 Realm 开启后,直接打开 agent 会要求登录(TTY 下可当场输入密码)。

协作模式

settings.json 里 "collaboration": "parliament"(或环境变量 CST_COLLABORATION=parliament)时:

  • 提示词不再鼓动 task / worker_start
  • 本机用工具直接干活;跨设备靠 Realm peer 席位,而不是进程内子 agent

密码 Realm 存在时也会按议会模式注入 Environment(chair / 共享 context / 设备席位)。

换项目(清场)

cst-agent --new-project my-app

清空共享上下文、撤销主席与登录票,并停止本机服务。Realm 密钥保留。

Docker 冒烟

bash scripts/docker_parliament_test.sh

Alpine 内构建,chair↔member 握手。

相关标志

标志 作用
--realm-password-init 创建密码 Realm
--login 登录 + 夺主席 + 启服务
--service / --service-fg 仅启服务
--service-stop 停服务
--new-project ID 清场换项目
--peer-port N 登录/服务用的 TCP 端口(默认 9100)
--instance ID 实例 id(也可用 CST_INSTANCE_ID)