ai_co_discuss 0.2.74 → 0.2.76

package/docs/workflow.md

@@ -1,157 +1,93 @@
-# 讨论工作流
+# 使用指南
 
-网站保存共享记录，主持人负责判断与安排，各 AI 在自己的软件或用户配置的 API 中形成意见。软件参与者由 Skill 定义协作规则、CLI 执行单次读写；API 参与者由本机程序提供房间工具，保留相同的阶段、独立观点、原文、身份与执行边界。程序唤醒可混用两种入口，API 专家和主持人仅使用房间上下文。
+[English](en/workflow.md) | 简体中文
 
-## 选择推进方式
+本文介绍房间里的协作方式。安装与接入见 [安装与接入](runner.md)。
 
-- **讨论（全自动）**：主持人与专家都由本机服务唤醒（CLI / App / API）。本机软件与权限配置完成后明确启动，可按轮次、总时长上限或手动停止结束。主持创建正式安排即结束本步；专家自行回答，程序再续接原主持。自动任务不另建原生定时。项目及 cwd 可选，分别属于本机接入配置。本地专家可单独选“手动接入”：成员记录带 `adapter: manual`，不被唤醒，凭自己的成员凭证提交安排内的回答，接入程序不派发它的事件，回答保存后照常续接主持人；主持人必须由本机唤醒。手动专家若运行在 Claude Code 或 Codex 中，任一带凭据的 CLI 调用（首条通常是 `room view`）都会附带该会话的 `CLAUDE_CODE_SESSION_ID` / `CODEX_THREAD_ID`（Codex 桌面应用会话转为 `codex`，其余转为 `codex_cli`），本机服务核对本机存在该会话后自动把它转为托管（`access=runner`、借用会话），之后每轮照常唤醒；服务没有 Claude 配置、找不到会话或其他软件的手动专家仍停在手动。手动专家不回答时讨论停在该安排，由用户取消安排（主持人被唤醒重新安排），或受轮次与总时长上限约束，没有单独的自动超时。模式在手动与全自动间切换时，带 `adapter: manual` 的专家保持手动（转为托管后不再带此标记）。网页 AI 会打断自动推进，只进入自由协作。
-- **开启 / 结束讨论**：讨论是自由协作房间里可临时开启的推进手段，不再是另一种房间。房主在右侧成员栏点“开启讨论”（目标、轮次与总时长上限，需一位由本机唤醒的 AI 主持人），房间变为讨论状态，由主持人安排成员轮流发言；到限、收束或点“结束”后房间回到自由协作，成员、历史与结论全部保留，之后还可再次开启（计数与计时重置）。开启与结束由房主凭据调用 `POST discussion {action: start|end}`。
-- **自由协作**：你或 AI 主持人点名一位或多位成员，各自在原会话处理请求；没有讨论安排和轮次。每位成员单独选择本机唤醒、手动接入或网页代发，见下方 [自由协作房间](#自由协作房间)。
-- **手动接入**：自由协作成员的一种接入方式。本地成员持自己的凭据文件自行读写，可由人工或软件原生定时触发；网页成员只能阅读房间，回答需转交代发；网页 AI 从其服务器读取阅读链接，本机网站对它不可达，此时由用户粘贴材料。只有这两种成员时建房无需本机接入服务。复制参与指令、下载凭据文件或复制凭证文本都不代表已经送达、接入或唤醒。
+## 核心概念
 
-讨论中随时可以直接提问：在输入框 @ 一位或多位在场成员（含主持人），网站为每位被点名者建一条“直接提问”请求，立即唤醒，任何阶段（含暂停、收束）都可用；它不占发言安排、不计轮次与时长上限，也不改变讨论进度，回答保存为普通发言（chat）并带请求状态徽标。成员正在处理讨论安排时，它的直接提问排队等安排结束，反之同理，同一会话不并发续接；讨论运行中 @ 主持人时不另建请求（主持人本来就会处理用户留言）。手动成员可用 `--request` 关联请求回答，网页成员由你代发。
-
-讨论运行中可在进度看板邀请专家（经本机服务配置后加入；Codex CLI / App、Claude 可填写已有会话 ID，续接这个带有自己上下文的原会话，标注为借用会话），或从成员菜单让专家暂离、请回或移除。暂离会取消它当前与排队中的安排，保留位置与会话，不计入之后的轮次；请回换发新凭证、续接原会话。邀请保留已有安排，新专家排在已有安排之后；暂离、请回或移除不暂停讨论，但排队中的安排作废，由主持人重新安排；主持人本身不能暂离或移除，更换主持人仍会暂停；正在发言（有进行中安排）的专家须先暂停讨论才能暂离或移除。已保存的观点属于讨论记录，不能删除；需要纠正时请主持人追问或让该专家补充一条。故障只暂停并保留原因，不静默换软件、身份或创建第二个会话。
-
-邀请弹窗与新建房间使用同一种角色卡片（同宽、正反面等高）：可一次选多位 AI（每个平台一张卡片，已在场的平台以新实例加入），在卡片正面切换“程序启动 / 手动启动”，点“邀请”后先加入程序启动的成员、再加入手动启动的成员（各自保持选择顺序），避免尚未注册的手动成员堵住自动成员；遇到第一个失败即停止并保留未处理的卡片。手动成员加入后弹窗列出它们的复制按钮和实时注册状态。手动启动卡片没有设置项，不翻面，正面直接写已实测的接管差异：Codex 的消息可实时送入已开窗口；agy 的后台发言写入同一会话、已开窗口需重启才显示；Claude Code 的后台接管会让会话分叉、原窗口看不到。已有本轮发言安排时，新邀请的自动专家立即排在队列末尾，手动专家在自己完成注册后才排入（未注册前不排入，避免队列停在它身上）；保留当前发言和原有相对顺序、问题；重复邀请请求不重复排队。暂停或尚无安排时，由主持人在继续推进时将新专家安排在本轮尚未发言的原专家之后；进入收束后不再追加安排。邀请不会启动或恢复讨论，也不会清除待处理的用户留言。
-
-邀请手动专家后，弹窗提供“复制启动指令”；复制成功后自动关闭，复制失败则保留弹窗并显示错误，方便重试。关闭后仍可在参与者列表中再次复制，不另设“稍后再复制”按钮。复制只交付指令，不改变发言顺序。轮到手动专家时，输入框上方也提供该按钮，复制成功后显示勾号与“已复制”，2 秒后恢复。
-
-手动专家的“注册”：专家须在自己的会话里执行 `member register`，网站才把它记为已注册；会话 ID 由 CLI 自动采集，不由专家填写。进度看板中该专家显示“待注册”（警示色，并提示把启动指令交给它的会话），注册后显示“已注册”，轮到与发言后沿用排队、发言中、本轮已发言等状态。存在待注册的手动成员时，输入框上方持续提示并提供复制启动指令，直到它注册；换发新凭证（请回）后需重新注册。只有已注册且上报了 Claude Code / Codex 会话的专家才会被本机服务接管。注册不改变发言顺序。
+| 概念 | 说明 |
+| --- | --- |
+| 房间 | 共享的协作空间，保存消息、观点、分歧与结论 |
+| 成员 | 房间里的 AI 实例；同一平台可有多个实例（如 `Claude`、`Claude-评审`），各有会话与模型 |
+| 主持人 | 一位由本机唤醒的 AI，接收未点名的消息并分派，可兼任专家 |
+| 用户 | 房间所有者与需求方，可随时 `@` 任何成员 |
 
 ## 自由协作房间
 
-成员回答下的执行报告列出请求编号、耗时、终态与工作区观察文件；失败或取消的报告保留在原请求下。报告展示最近 100 次执行；“未提供自动改动检测”表示非 Git 目录或未上报，不能据此判断没有文件变化。
-
-回答摘要在自由协作与讨论中都按需填写：较长的回答附一两句结论，简短回答不写。
-
-自由协作房间从同一角色库选择一位或多位成员。用户是需求方而不是主持人：只要有能自行发言的成员（本机唤醒或手动接入），房间就始终有一位 AI 主持人，默认是第一位本机唤醒的成员，可点皇冠或在成员菜单中更换；主持人不能直接卸任，离开或被移出时由下一位成员接任（旧主持人尚未处理的未点名消息一并交给新主持人；更换主持人时同理，已开始处理的不移交），原先由用户主持的旧房间在下一条消息时自动指定。只有一位成员时，每条消息都交给它；有多位时，你的消息默认发给主持人；在正文中 `@成员` 才让其他成员发言（代码和引用中的 @ 不算，输入框中会生效的 @ 显示为蓝色），被点名的成员各自处理，主持人也可以 @ 其他成员派活。输入框下方的备注行显示这条消息会发给谁。只有网页 AI 成员时没有主持人，未点名的消息只作留言。输入 `@` 后，输入框上方弹出在场成员菜单，继续输入可筛选；用方向键与 Enter / Tab 或点击补全，Esc 关闭。选择只修改草稿。输入框 Enter 发送、Shift + Enter 换行；发送按钮始终用于发言，无正文或附件时禁用，成员处理中也不切换为停止按钮。自动成员空闲时，服务把它名下所有未处理的消息打包成一次执行交给原会话；执行期间再发的消息排队，下一次一起投递。手动成员自行读取自己的请求，在线成员由用户转交。成员按时间顺序处理，后面的消息可以修正前面的。
-
-运行中可在右侧成员栏邀请 AI（沿用本机软件配置和本房间工作目录），也可让成员离开、请回或移除。自动成员的项目文件权限默认只读；需要它修改项目时，在邀请前选择“项目文件可写”，权限只应用于这位成员；App 与手动成员的文件权限由其软件设置，API 与网页成员不访问项目文件。填写已有会话 ID 时续接该原会话，不新建。离开会立即停止它的工作；请回时换发新凭证并续接它原来的会话。邀请时可选“手动接入”：成员不会被自动唤醒，而是得到一份私有凭据文件，由你在它的会话中按参与技能读写。自由协作房间里，手动成员执行 `member register` 之前视为不存在：不能被点名，不收请求，不进“全体各自回应”和智能调度候选；注册后与其他成员一样可被点名，其 CLI 上报会话后本机服务按软件转为托管（Claude Code、Codex、agy），此后与自动成员无异；转托管时本机服务为该成员生成新凭证并由网站替换，浏览器生成的原凭证随即失效（本机不保存原凭证）。绑定你正在使用的会话的成员会标注“借用会话”：它工作时不要在原窗口继续操作。
-
-输入 `@全体成员`（或 `@all`）等同于点名当前所有可点名成员（含主持人，不含未注册的手动成员），主持人不汇总。同时回答还是依次回答由智能调度判断：后发言的成员需要看到前面的回答（接龙、轮流补充或反驳、逐个评审）且置信度 ≥ 0.7 时依次回答，其余情况、未开启智能调度或判断失败时同时回答；主持人不由本机唤醒时直接同时回答。判断期间消息下显示“智能调度分析中”，结果记为一行“智能调度”决策。依次回答按房间的发言顺序逐个进行，前一位的请求结束（完成、失败或取消）后下一位才收到请求；轮到时已离开的成员被跳过。手动输入 `@全体依次`（或 `@all-seq`）可不经判断直接依次回答。成员不止一位时 @ 菜单第一项为 `@全体成员`。
-
-右栏“发言顺序”在自由协作与讨论中显示同一份顺序：已发言（✓）、正在发言、待发言依次编号；不在本次依次回答或本轮未安排的成员（含讨论主持人）列在分隔线下、不编号，离开的成员列在最后。房主把鼠标移到待发言成员上时序号变为把手，拖动（Esc 取消）或聚焦后用上下方向键调整顺序，松手即生效，已发言和正在发言者不动；拖动途中顺序被他人改动时本次拖动作废并提示重新调整：`@全体依次` 进行中时调整其余排队成员，讨论中只调整本轮排队的安排（各自的问题随之移动）；主持人一次排到后续轮次时，后续轮次折叠为“后续已排 N 轮”，只读不可拖，主持人通常会在每轮结束后重新安排；没有排队时，自由协作中拖动设置房间默认顺序，之后的 `@全体依次` 按它排列，开启讨论后主持人读取的专家状态也按它列出。默认顺序未设置时为主持人在前、其余按加入顺序。
+- **点名**：`@成员` 后，它在自己的原会话中处理并回复，多位可并行。
+- **未点名的消息**：交给主持人分派；只有一位成员时直接交给它。
+- **主持人派活**：主持人点名一位成员时，该成员直接回复你；点名多位时，都完成后主持人再汇总。
+- **全体回答**：`@全体成员` 请所有成员各自回答，`@全体依次` 按发言顺序逐个回答。
+- **停止与重发**：成员菜单可停止当前执行；失败的执行可一键重发。
 
-可以把一位本机成员设为主持人。之后没有点名的消息交给主持人分配；主持人在回答中点名成员派活，只点名一位成员时，其回答直接面向用户，主持人不再被唤醒；点名多位成员时，都结束后主持人再被唤醒一次，继续汇总或安排下一步。派出的成员全部失败时不再唤醒主持人；同一条消息引出的 AI 请求最多 8 次，用完即停，成员栏会提示，发一条新消息即重新开始。
+普通成员之间的 `@` 只是引用，不会唤醒对方。多位成员共享同一项目目录时不加锁，由你划分文件；两位成员同时改动同一文件时，成员栏会提示可能的冲突。
 
-普通成员回答中的 `@成员` 或结构化 `to` 只保存为“建议请 X 回应”，不自动唤醒；正文里的代码与引用不算建议。房主可在原回答下点击“转为请求”，网站记录一条用户确认，建立新任务链，并把请求关联到原回答。重复点击或重试返回同一条请求，已完成、失败或取消的请求也不会重新派发；目标成员离开后不能转换。自动、手动和在线成员沿用各自的接入方式。
+## 开启讨论
 
-在线 AI 以“网页代发”成员加入：点名后，在成员栏复制阅读通知交给它；拿到回答后，在输入框选择“代发”该成员并粘贴原文，记录保留它为作者、你为提交者，并关闭它的待处理请求。
+在成员栏点“开启讨论”，或建房时勾选“创建后开启讨论”：
 
-新建房间时可在“智能调度”下添加一个决策模型（可选，需本机服务，TypeSafe Jev 或 OpenAI Decisions 二选一，按次计费）。开启后，没点名的消息先由决策模型判断（通常约 1 秒），主持人等结果出来才启动；消息明确在对某位成员说（叫了名字、追问其回答、补充其正在处理的消息，置信度 ≥ 0.7）就直接改由该成员回答；要求全体各自回应（如“都出来打个招呼”）就同时请所有成员各答一次，主持人不再汇总；只是“好的”“谢谢”就不唤醒任何成员（这两种置信度须 ≥ 0.85）；拿不准或需要分工协调时仍由主持人处理。每次判断都在该消息下留一行“智能调度”记录，可点 👍 / 👎 评价这次判断是否合适。自动改派失败时退回为 60 秒内可手动采纳的建议。目前只能在建房时开启。开启智能调度只需连接本机服务，成员可以全是手动接入或网页成员：本机服务仍登记该房间并运行决策；被推荐的手动或网页成员与其他成员一样，采纳后在成员栏出现待处理请求，由你或其自行处理（网页成员需你复制通知并代发）。
+1. 填写讨论目标，设置轮次与时长上限（网页默认 3 轮、不限时长）。
+2. 主持人拆题并安排成员轮流发言；成员先独立提出观点，再回应彼此的论证。
+3. 到达上限、主持人宣布目标完成或你点“结束”后，房间回到自由协作，记录与结论保留，之后可以再次开启。
 
-需要深入讨论时，在成员栏点“开启讨论”（或建房时勾选“创建后开启讨论”）：在弹窗里填目标、轮次和时长等上限，由本机唤醒的主持人安排成员轮流发言。到限、结束或用户点“回到自由协作”后，房间继续自由协作，成员、历史与结论保留，可再次开启；不再另建讨论房间。
+讨论中可以随时 `@` 任何成员提问，不占轮次。你的留言交给主持人处理，不打断正在发言的专家；需要立即生效时，在进度看板点“跳过”当前发言。
 
-多位成员共享同一个工作目录时不加锁，由你划分各自负责的文件。成员栏会提示“可能的改动冲突”：两位成员在重叠时段都改动了同一文件时列出文件名。提示依据执行前后的 Git 工作区对比，无法确定修改者，未出现提示也不代表没有覆盖；非 Git 目录不提供提示。
+### 点名追问与智能衔接
 
-页面在每条消息上标出请求状态（待投递、处理中、已回复、已停止、失败）。本机服务离线时请求停在“待投递”，不显示为已唤醒。在右侧成员菜单点「停止」会作废该成员当前执行和尚未投递的消息，迟到的回答会被拒绝；之后重新发消息即可；失败的执行报告上有“重发”，会把原消息（点名的请求带上 @成员）填回输入框，由你确认后发送。归档房间会同时作废它尚未完成的执行与排队请求。一次执行失败只影响这次请求，房间继续可用。
+新建讨论时可开启“点名追问”：每轮结束后，主持人给每位专家写针对性的追问。关闭时（默认），专家读完上一轮回答后直接互相回应，主持人只负责引导方向。
 
-两种房间的用户写入均须房间控制凭据，未持有凭据的浏览器只能阅读。手动成员的创建、邀请和请回直接在网站完成，并交付各自私有凭据文件；在线成员只交付阅读指令。自动成员需要本机服务；线上网站通过 `codiscuss local connect` 连接后可启动本机 AI，AI 仍在你的电脑上运行。
+### 讨论上限
 
-## 点名追问与智能衔接
-
-新建讨论时可选“点名追问”，默认关闭；之前创建的房间视为开启，保持原有方式。
-
-- **开启**：每轮结束后主持人读完回答，给每位专家写针对性的追问。
-- **关闭**：首轮仍由主持人拆题出题；之后专家统一按“先读上一轮回答、回应不同意或需补充的观点、可 @ 彼此提问”发言，主持人用自己的主持说明引导方向。同时开启“智能调度”时，每轮结束由决策模型判断：还有分歧就自动开下一轮（先请最需要回应的专家，不是上一轮最后发言者），可以收束、跑偏或卡住才唤醒主持人。决策模型每次只安排一位发言人，那位答完后再判断下一位（含点“跳过”、邀请或成员变动后队列为空的情况）；手动接入的专家不由它安排。自动开轮受轮次与时长上限约束，到限照常交给主持人处理。
-
-## 讨论上限
-
-准备或暂停阶段可配置以下参数；活动讨论需先暂停再修改，保存参数不重置计时或历史轮次。
-
-| 参数 | 范围与作用 |
+| 参数 | 说明 |
 | --- | --- |
-| 轮次上限 | 0–100；0 或留空不预设；全部配置专家各完成一次观点才计一轮 |
-| 讨论总时长 | 0–1440 分钟；0 或留空不预设；从首次进入讨论阶段或创建安排开始，只统计进行中时间：暂停（含执行失败后）、准备与收束期间不计入用时，也不消耗总时长 |
-| 单次 AI 执行 | 默认不限，0 表示不限，或设置 1–60 分钟；仅自动模式，从实际进入执行起算，超时暂停，不自动重试 |
-| 达到上限后 | 讨论结束，房间回到自由协作；不自动宣布达成共识 |
-
-网页新建默认 3 轮、不限时长、单次执行不限时；到限一律结束讨论。新建表单分别显示轮次和时长上限，点击数值才展开滚轮；鼠标滚轮逐格切换，停止滚动即停住，鼠标或手指在屏幕上拖动则保留松手惯性。选择即时生效，点击外部即可收起，无需确认。时长收起时显示小时及剩余分钟，展开后分为小时、分钟两列，按 1 小时、1 分钟选择；轻点各列中间数字可直接输入，启用时长上限后范围为 1–1440 分钟，24 小时时分钟固定为 0。拖动松手后先按阻尼减速，再按预计停止位置吸附；系统“减少动画”下仍保留拖动惯性，只去掉数字的三维翻转。两项各自提供“不限”，关闭“不限”恢复此前数值，首次启用时长上限为 1 小时，互不改动；下方实时说明哪个上限先到便触发所选动作。未传参数的 CLI 建房默认轮次、总时长与单次执行不限；旧房间保留已有设置。全自动支持不限总时长：按轮次上限或手动停止结束，重启不自动添加时长上限；主动设置的单次 AI 执行超时和租约仍有效。CLI 可额外指定未来 24 小时内的运行截止，但不能延长话题已设的截止。
-
-“主持”及“接入”显示配置、已用/剩余时间、已完成轮次和到限状态。新专家安排及观点由服务端拒绝越界，原提交的幂等重试和用户留言保留。自动程序定期调用到限处理；手动主持每次原生检查时执行 `room limits ROOM --check --as 本人`，也可由用户点击界面中的检查按钮。仅打开页面不触发写入或启动 AI。新建的讨论房间由程序按“专家观点数 ÷ 在场专家数”统计轮次（`limits.segment_rounds`），与主持人的发言计划结构和花名册是否被排满无关；达到 `round_cap`（初始为 `max_rounds`）即到限，取消排队安排。此前创建的房间没有轮次预算记录，沿用按花名册逐轮统计的旧口径，不做迁移。网页的轮次显示（右上角进度、看板、对话缩略图的轮次分组）使用同一口径：房间视图的 `round_groups` 每满“在场专家数”条观点成一轮，重新开始或追加轮数时在新计数起点另起一轮；只统计最近一次讨论从开启（`session.started_message_id` 之后）到结束（`ended_message_id`）之间的消息，编号从 1 开始，讨论之外的自由协作消息不分轮；`rounds` 仍按“每位专家各发言一次”生成，只用于安排与花名册（`turn roster`、邀请补齐位置）。旧房间的 `round_groups` 与 `rounds` 相同。
-
-到限后程序结束讨论：取消未完成安排、撤销旧自动执行（运行换代并停止），阶段记为 `concluded`，房间回到自由协作，与用户点“结束”相同；主持人不自行总结，`stop_reason` 保留到限原因。目标提前完成时由主持人 `room limits --done` 通知程序，效果与到限相同（原因记为 `goal_done`）；主持人在无阻碍项时直接 `room update --phase concluded` 也同样回到自由协作。讨论结束后，中间区在讨论最后一条消息之后显示结束卡，写明结束原因与目标是否完成；卡上的“继续讨论”沿用讨论目标、按新填的轮次与时长上限再次开启讨论（计数与计时重置），也可在成员栏重新“开启讨论”；需要总结时直接请主持人写一份。讨论结束（到限、宣布完成、收束或点“结束”）时，讨论期间尚未被主持人回应的用户留言——`held_since` 起、主持人最后一条消息之后、且未点名任何人的——按自由协作规则补交给主持人（只有一位成员时交给它），不用重发。页面到限提示不代表外部手动软件已停止。升级前已因到限或目标完成而暂停的讨论，看板只提供“结束”。
-
-升级前已收束、仍未回到自由协作的讨论可重启：用户指定新的轮次与总时长上限，计数起点和计时重置，历史与原结论保留，随后按暂停状态重新启动。已收束的页面展示结束状态，不再显示活动倒计时或后来才触发的到限警告。
-
-## 角色与参与方式
-
-| 角色 | 责任 |
-| --- | --- |
-| 用户 | 提出目标、约束、决策偏好；可留言、参与或担任主持人 |
-| 主持人 | 明确问题、接入专家、决定下一安排、维护主持简报与状态、保留分歧并收束 |
-| 本地专家（cli） | 自主读取材料、提交自己安排的回答；管理自己创建的原生定时任务 |
-| 在线专家（online） | 从可访问链接按需阅读，在原聊天形成回答；主持人或用户保留真实原文后代发 |
-
-主持人可以兼任专家。自己的观点用 `opinion` 并关联自己的正式安排，主持说明和共识总结用 `moderation`；不能把个人意见直接写成共识。参与者身份为用户与 AI 实例：平台（Codex、Claude、Gemini、DeepSeek、Qwen、Grok）相当于类型，房间里的参与者是它的实例，名称为平台名或“平台名-后缀”（如 `Claude-评审`，后缀 1–16 个字母、数字、下划线或汉字）。同一平台的多个实例各有会话、模型和思考强度，名称在同房间唯一；在角色卡片库中再次选择同一平台即新增一个实例。本机默认软件配置按平台保存，实例的模型与强度只用于本场。
-
-## 从议题到结论
-
-1. **准备**：确定目标、背景、约束、参与者和停止边界。区别讨论截止、必要回答等待边界与各端任务运行上限。主持人建房后回读资料，再交付接入文本。网页新建只填写话题名称与用户原文，目标、背景与边界由主持人首次接手时补全，已有内容不覆盖。
-2. **独立初始观点**：必要专家先基于相同目标与材料提出自己的见解；提交前不读他人观点和主持结论。已受到影响应如实说明。串行安排不等于技术盲评。
-3. **深入讨论**：阅读彼此观点，围绕影响选择的争点追加论证、修正判断或提出 @ 追问。主持人在每轮内按相关程度决定先后，每位专家各回应一次；不连续安排刚发言的专家，新一轮也不先安排上一轮最后发言者，仅在需要其本人澄清刚发表内容时例外。
-4. **必要复核**：对拟定结论核对原意、条件和未决影响。解释某人的话受到质疑时，请原作者澄清；另一人赞同不能代替原作者确认。不要求所有议题都多做一轮复核。
-5. **收束**：将共识总结作为独立主持消息留档，保留分歧、未确认事项及下一步。更新共享状态和阶段，核验本次任务停止；达到时限不等于问题已解决。
-
-阶段值为 `preparing`、`initial`、`discussing`、`paused`、`concluded`。讨论阶段由主持人结合目标决定；配置的到限处理可以暂停，收束完成仍需主持人确认。一轮指参与专家各完成一次完整观点，同轮补充只计一次；主持说明和用户留言不推进轮次。
-
-## 正式安排
-
-同一时刻只能有一个未完成安排（整轮中排队的安排不计）。没有发言权：专家的观点自动绑定到自己当前未完成的安排（`--turn` 可省略，带了必须与之相符），保存完整回答后安排为 `answered`，整轮仍有排队且无用户新操作时自动接力，否则交回主持人。消息与安排状态在同一事务中保存。
-
-AI 不借用用户身份发言；用户本人留言不受安排限制，话题暂停或收束时仍可留言（如 @主持人 提问），已存档房间除外。@ 和回复只是内容关联，不自动创建安排；讨论中点名成员的直接提问见上文。
-
-### 整轮安排与用户介入
-
-主持人可以一次排好本轮顺序：先 `turn roster` 申请最新专家状态（在场专家、本轮待发言者 `waiting` 与 `revision`），再 `turn create --plan-file … --roster <revision>`。多项计划未带 revision 返回 400，名单已变化（有人加入、暂离或发言）返回 409，漏掉 `waiting` 中的专家返回 400 并列出名字；全自动讨论中尚未注册的手动专家（`unregistered`）不在 `waiting` 中，`turn create` / `turn continue` 排入它们返回 400 并列出名字，它们注册后才自动加入本轮队列；主持人本人不需要排入，API 主持人的 `arrange_turns` 由接入程序自动取最新 revision。第一项立即生效，其余为 `queued`。专家保存回答后，网站在同一事务中把下一位排队专家的安排转为当前；末位答完才交回主持人。接力不发通知，需要逐个转交的在线专家不放进整轮。
-
-用户留言或修改目标、背景、边界、焦点会记为待主持人处理（`held_since`），不打断正在发言的专家；该专家保存回答后交回主持人而不接力。主持人执行期间新到的用户留言，不会因主持人创建或继续安排而清除，下一位专家答完后仍交回主持人处理；网页在这些留言上标注“待主持人处理”。要立即生效，用户在进度看板点「跳过」：用户代该专家保存一条“本次发言已被用户跳过”的观点（计为本轮已发言、对话中保留卡片），本次执行随之完成；因有待处理留言，交回主持人，排队安排保留。主持人处理后用 `turn continue` 按原计划继续，或直接创建新安排，剩余排队改为 `skipped`。建房时开启“智能调度”的讨论，留言由决策模型先判断：有把握是“仅补充信息”就按原计划继续，是在问某位专家就先请该专家回应，其余情况才交回主持人；每次判断都在对话中留一行“智能调度”记录。暂停保留当前与排队安排，点“重启”由原专家继续；若要跳过当前安排，可点“跳过”，保存跳过发言后恢复讨论，按原计划交给下一位（无排队则交回主持人）；邀请只排在本轮队尾，提前结束、到限处理、收束、更换主持人或专家暂离、请回、移除才会作废全部排队安排。
-
-在线专家由主持人以自身操作者身份、指定原专家代发。正常推进不超时夺取；到限会结束讨论，取消未完成安排并撤销旧自动执行。
-
-## 按需读取与表达
-
-先读房间概要和当前安排，再按问题读取背景、共享状态或指定原文。独立阶段遵守阅读边界；深入阶段补读与问题相关的他人观点。增量读取以实际读过的编号为起点，每次最多 20 条，按 `next_after` 继续，不直接跳到房间 `latest_id`。
-
-回答较长时附简述，通常一两句，说明本次主张、变化或分歧；详细论据、适用条件、数字、验证和引用放在正文，不能用摘要代替原文。代发保留真实作者和完整引用关系，主持人另写的摘要注明实际摘要作者。
-
-观点应直接回答当前问题，以证据支持判断；有依据时坚持，也可以说明理由后修正。分歧区分事实、假设、标准和偏好，分别查证、比较或交给决策者。外部引用、估计与实测分开，未核验数字不能因多人赞同变成事实。
+| 轮次上限 | 每位专家各完成一次观点计一轮 |
+| 总时长 | 只统计进行中的时间，暂停期间不计 |
+| 单次 AI 执行 | 单次执行超时即暂停 |
 
-## 通知与持续检查
+到限后讨论结束；到限不代表已经达成共识。
 
-`turn create` 保存安排；自动运行中同时保存待接入事件，但不直接操作软件。`turn prompt` 只生成转交文本，`turn mark-notified` 只记录已经发生的送达。复制按钮、工具调用发起和任务创建都不证明对方已收到或已运行。本地 CLI 专家可以自行发现 `pending` 安排，无需伪造通知状态。
+## 智能调度
 
-在线专家由主持人操作时，发送前记录实际聊天、问题和安排。发送结果不明先检查正确聊天是否出现问题/回答，不换编号或重发绕过。完整回答生成后才原文留档；引用面板中的链接需随原文保存，补充附录注明由主持人提取。
+建房时可在“智能调度”下添加一个决策模型（TypeSafe Jev；OpenAI Decisions 为实验性），用你自己的密钥按次计费。开启后，常规分派由决策模型判断，不必每次唤醒主持人：
 
-手动接入后的持续讨论可使用各软件的原生定时功能。默认参考周期为主持人 30 秒、专家 60 秒；长调研可放宽到 3–5 分钟，工具不支持时选择最接近且更长的周期并报告实际值。每次必须有有限运行上限；定时提示保存静态约定和入口，动态进度每次从网站恢复。全自动事件模式不使用此定时流程。
+- 未点名的消息：明确对某位成员说时直接交给他，或请全体回答、无需回应；其余仍交给主持人。
+- `@全体成员`：判断应同时回答还是依次回答。
+- 讨论中：用户插话后继续原有安排，轮次之间选出下一位发言人。
 
-主持人无新回答时仍需检查是否有尚未执行的下一安排；专家无自己的安排时安静结束本次检查。无变化不产生状态消息，不为每次检查重建任务。自己的任务到期只代表自身停止参与，不代表整场讨论结束。
+决策模型只在把握足够时执行，否则交回主持人。每次判断都会显示在对话中，可以评价。开启后，房间标题与最近消息会发送给所选供应商。
 
-## 状态保存与中断恢复
+## 成员管理
 
-- `host_brief`：面向用户的主持简报，说明已有判断、争点和下一步，最多 1600 个 Unicode 字符。
-- `state_text`：详细共享状态，保存依据、已处理编号、下一步及其执行情况，最多 4000 字符。
-- `state_until`：主持人实际已读材料截止编号，不证明后续安排、通知或清理已经完成。
+在右侧成员栏可以：
 
-关键判断、安排或阶段发生变化时保存并回读；纯等待不重复写。执行下一动作前记录“拟做、未执行”，成功后保存真实结果。恢复时对照服务端：动作已发生只补记录，未发生才执行。状态保存失败先核对并恢复，不继续联系新专家。
+- **邀请**成员。Codex 与 Claude 可以填写已有会话 ID，带着原会话的上下文加入；讨论中新邀请的专家排在本轮队尾。
+- **暂离、请回或移除**成员，讨论不会因此暂停。
+- **更换主持人**：点成员卡片上的皇冠。讨论中更换会暂停讨论。
+- **调整发言顺序**：拖动右栏“发言顺序”中待发言的成员。
 
-房间、消息、安排创建使用稳定 `submission_id`。请求结果不明先精确查询，再决定是否沿用原编号与原文重试；查询失败不等于未写入。浏览器送达去重独立于网站提交去重，详见 [CLI 故障处理](cli.md#写入核对与错误处理)。
+项目文件权限按成员设置，默认只读。
 
-## 暂停与结束
+## 手动接入与网页 AI
 
-用户叫停、房间暂停/收束或达到约定上限时，先停止新增安排和联系专家，停用并核验自己创建的任务。正常完成或约定限时交付时，依次取消剩余安排、发表共识总结、保存状态并设为 `concluded`。
+- **手动接入**：成员不被自动唤醒，凭自己的凭据文件读写，由你或软件的定时功能触发。成员须先在自己的会话中执行 `codiscuss member register` 才算到场。
+- **网页 AI**：在线聊天产品只能阅读房间。在成员栏复制阅读通知交给它，再在输入框选择“代发”粘贴它的回答。网页 AI 访问不到本机地址。
 
-明确暂停或主持任务到期而仍需讨论时设为 `paused`，保留原阶段、原因和下一步。写入故障阻碍收束时同样先暂停，保留未执行事项。
+讨论的主持人必须由本机唤醒；网页 AI 只参与自由协作。
 
-各专家负责停止自己的任务，主持人不能替其他端宣称停止。恢复暂停话题须用户明确继续；迟到回答先保留，恢复后判断适用性。
+## 技能
 
-**没有运行回执。** 启动、停止、阅读、等待和已提交回答都不再另发消息，也不能再写 `kind=receipt`（旧房间里已有的回执仍可查看和筛选）；任务是否停止以各端实际任务核验为准，影响协作的异常直接用主持说明或用户留言说明。
+AI 按随包分发的技能参与房间，`codiscuss setup` 会为选定的软件自动安装：
 
-具体执行约束以仓库 [参与技能](../.agents/skills/discuss-participant/SKILL.md) 和 [主持技能](../.agents/skills/discuss-host/SKILL.md) 为准，站点字段与限制通过 `room protocol` 获取。
+| 技能 | 使用者 | 作用 |
+| --- | --- | --- |
+| [discuss-participant](../.agents/skills/discuss-participant/SKILL.md) | 所有成员 | 阅读、发言与可靠写入 |
+| [discuss-host](../.agents/skills/discuss-host/SKILL.md) | 主持人（同时调用参与技能） | 安排发言、保存进度与收束 |
+| [discuss-report](../.agents/skills/discuss-report/SKILL.md) | 报告整理者 | 把已有讨论整理为带原文引用的报告 |
 
-## 备份与讨论报告
+在 Codex 中用 `$discuss-host` 调用；其他软件没有自动发现时，直接要求它读取对应的 `SKILL.md`。
 
-用户可从网页“备份当前讨论”下载服务器已保存的完整房间快照与原文。备份不改变讨论阶段，也不代替任务停止核验。
+## 附件与导出
 
-需要将讨论整理为独立成果时，使用 [讨论归档技能](../.agents/skills/discuss-report/SKILL.md)，明确来源范围和本地输出目录。报告按主题解释建议如何形成，保留异议、修订与原文链接；讨论建议和用户已采纳的决定分别记录。网页备份负责保存数据，报告负责综合分析，两者均不自动执行后续建议。
+- **附件**：每条消息最多 10 个，单个最多 20 MiB，图片与 PDF 可在站内预览。上传不代表 AI 已读取。
+- **导出与导入**：房间菜单的“导出对话”下载原始数据与附件；在另一个站点“导入房间…”即可得到可继续使用的副本。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai_co_discuss",
-  "version": "0.2.74",
+  "version": "0.2.76",
   "bin": {
     "codiscuss": "runner/codiscuss.mjs"
   },

package/runner/discussion_launch.mjs

@@ -73,7 +73,8 @@ conversation 还须 current_session_id，当前会话接手首个主持任务。
 `;
 
 // Windows PowerShell 5.1 ships WinForms. A background process cannot take the foreground, so the owner must be
-// shown (off-screen) as a topmost window; the dialog it owns then stays above the browser that asked for it.
+// shown (transparent) as a topmost window; the dialog it owns then stays above the browser that asked for it.
+// Keep the owner on-screen because the Common Item Dialog positions itself relative to its owner.
 // windowsHide turns the process's first Show into a hide, so the owner is shown a second time to really appear.
 // Under the local service the whole process chain has no console and no foreground rights: Windows then silently ignores
 // SetWindowPos(HWND_TOPMOST) on the dialog (it returns success). So once the dialog exists, a timer in its message loop
@@ -104,16 +105,72 @@ const PICKER_RAISE_SOURCE = [
   '  }',
   '}',
 ].join(' ');
+// Use the Common Item Dialog: unlike Framework WinForms, it has an editable address bar.
+// COM declarations retain the native vtable order through the last method used.
+const FOLDER_PICKER_SOURCE = `
+public static class FolderPicker {
+  const uint FOS_PICKFOLDERS = 0x20, FOS_FORCEFILESYSTEM = 0x40, FOS_PATHMUSTEXIST = 0x800;
+  const uint SIGDN_FILESYSPATH = 0x80058000;
+  const int CANCELLED = unchecked((int)0x800704C7);
+  [ComImport, Guid("42F85136-DB7E-439C-85F1-E4075D135FC8"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+  interface IFileDialog {
+    [PreserveSig] int Show(IntPtr owner);
+    void SetFileTypes(uint count, IntPtr filters);
+    void SetFileTypeIndex(uint index);
+    void GetFileTypeIndex(out uint index);
+    void Advise(IntPtr events, out uint cookie);
+    void Unadvise(uint cookie);
+    void SetOptions(uint options);
+    void GetOptions(out uint options);
+    void SetDefaultFolder(IShellItem folder);
+    void SetFolder(IShellItem folder);
+    void GetFolder(out IShellItem folder);
+    void GetCurrentSelection(out IShellItem item);
+    void SetFileName([MarshalAs(UnmanagedType.LPWStr)] string name);
+    void GetFileName([MarshalAs(UnmanagedType.LPWStr)] out string name);
+    void SetTitle([MarshalAs(UnmanagedType.LPWStr)] string title);
+    void SetOkButtonLabel([MarshalAs(UnmanagedType.LPWStr)] string label);
+    void SetFileNameLabel([MarshalAs(UnmanagedType.LPWStr)] string label);
+    void GetResult(out IShellItem item);
+  }
+  [ComImport, Guid("43826D1E-E718-42EE-BC55-A1E261C37BFE"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+  interface IShellItem {
+    void BindToHandler(IntPtr context, ref Guid handler, ref Guid iid, out IntPtr result);
+    void GetParent(out IShellItem parent);
+    void GetDisplayName(uint format, [MarshalAs(UnmanagedType.LPWStr)] out string name);
+  }
+  /// <summary>Choose an existing filesystem folder, or return null when cancelled.</summary>
+  public static string Show(IntPtr owner) {
+    var dialog = (IFileDialog)Activator.CreateInstance(Type.GetTypeFromCLSID(new Guid("DC1C5A9C-E88A-4DDE-A5A1-60F82A20AEF7")));
+    IShellItem item = null;
+    try {
+      uint options;
+      dialog.GetOptions(out options);
+      dialog.SetOptions(options | FOS_PICKFOLDERS | FOS_FORCEFILESYSTEM | FOS_PATHMUSTEXIST);
+      dialog.SetTitle("选择项目目录");
+      int result = dialog.Show(owner);
+      if (result == CANCELLED) return null;
+      Marshal.ThrowExceptionForHR(result);
+      dialog.GetResult(out item);
+      string path;
+      item.GetDisplayName(SIGDN_FILESYSPATH, out path);
+      return path;
+    } finally {
+      if (item != null) Marshal.ReleaseComObject(item);
+      Marshal.ReleaseComObject(dialog);
+    }
+  }
+}
+`;
 const WINDOWS_PICKER = [
+  '$ErrorActionPreference = "Stop"',
   'Add-Type -AssemblyName System.Windows.Forms',
   '[Console]::OutputEncoding = [Text.Encoding]::UTF8',
-  '$owner = New-Object System.Windows.Forms.Form -Property @{ TopMost = $true; ShowInTaskbar = $false; FormBorderStyle = "None"; StartPosition = "Manual"; Location = New-Object System.Drawing.Point(-32000, -32000); Size = New-Object System.Drawing.Size(1, 1) }',
-  `Add-Type -TypeDefinition '${PICKER_RAISE_SOURCE}'`,
+  '$owner = New-Object System.Windows.Forms.Form -Property @{ TopMost = $true; Opacity = 0; ShowInTaskbar = $false; FormBorderStyle = "None"; StartPosition = "CenterScreen"; Size = New-Object System.Drawing.Size(1, 1) }',
+  `Add-Type -TypeDefinition '${PICKER_RAISE_SOURCE} ${FOLDER_PICKER_SOURCE}'`,
   '$owner.Show(); $owner.Hide(); $owner.Show(); $owner.Activate()',
   '$timer = New-Object System.Windows.Forms.Timer -Property @{ Interval = 150 }; $timer.Add_Tick({ if ([PickerRaise]::OwnedBy($owner.Handle)) { $timer.Stop() } }); $timer.Start()',
-  '$dialog = New-Object System.Windows.Forms.FolderBrowserDialog -Property @{ Description = "选择项目目录"; ShowNewFolderButton = $true }',
-  'if ($dialog.ShowDialog($owner) -eq "OK") { $dialog.SelectedPath }',
-  '$owner.Close()',
+  'try { [FolderPicker]::Show($owner.Handle) } finally { $timer.Stop(); $timer.Dispose(); $owner.Close(); $owner.Dispose() }',
 ].join('; ');
 const PICKERS = {
   win32: ['powershell.exe', ['-NoProfile', '-STA', '-Command', WINDOWS_PICKER]],

package/runner/free_runner.mjs

@@ -87,7 +87,7 @@ export function free_task_files(config, member, execution, binding) {
     skills: [join(config.project, '.agents/skills/discuss-participant/SKILL.md')], cli, subcommands: TASK_SUBCOMMANDS,
     ...(bound_access ? { access_env: 'DISCUSS_ACCESS_FILE' } : { access_file: access_path }),
     instructions: `${discussion ? '讨论房间：用户直接向你提问（' + messages + '）。这不是你的发言安排，不要领取发言权、不要安排他人，也不改变讨论进度，只回答这个提问。' : '自由协作房间：用户点名了你（' + messages + '）。'}${access_rule}先用 ${cli} message list ${config.room} --after ${execution.read_until}${access_arg} 读取新消息，按时间顺序处理，后面的消息可能修正前面的，以最新指令为准。${host_rule}完成后用 ${cli} message post ${config.room} --as ${member.name} --kind chat --execution ${execution.id} --body-file 草稿 --submission-id 新UUID${access_arg} 提交一次回答。提交被拒绝说明本次执行已被打断或过期：保留草稿并结束，不要去掉 --execution 改作普通发言。草稿只写入 draft_directory；${project_rule}不读取或打印凭据内容，不建定时任务。` });
-  const prompt = `用户在${discussion ? '讨论' : '自由协作'}房间点名了你（${member.name}），对应消息 ${messages}。请先读取任务文件：${task_path}，按其中说明读取新消息、完成请求，并用 ${cli} message post 带 --execution ${execution.id} 提交一次回答后结束。命令只用任务内 subcommands 列出的 ${cli} 子命令；${project_rule}不读取凭据内容。`;
+  const prompt = `用户在${discussion ? '讨论' : '自由协作'}房间点名了你（${member.name}），对应消息 ${messages}。请先读取任务文件：${task_path}，按其中说明读取新消息、完成请求，并用 ${cli} message post 带 --execution ${execution.id} 提交一次回答后结束。命令只用任务内 subcommands 列出的 ${cli} 子命令，列目录、搜索或读取文件用软件自带的文件工具，不用 shell 命令；${project_rule}不读取凭据内容。`;
   return { id, participant: member.name, directory: config.directory, draft_directory,
     skills_directory: join(config.project, '.agents', 'skills'), access_path, prompt };
 }
@@ -134,7 +134,8 @@ export class FreeRoomRunner {
     this.routing = new Set();
     this.children = new Set();
     this.members = new Map();
-    this.exited = new Set();
+    // Execution id -> why its session ended on its own, such as a command refused in unattended mode ('' when unknown).
+    this.exited = new Map();
     this.snapshots = new Map();
     // Execution id -> { phase, at, sent_phase, sent_at, notes, next_seq }: what the member's software last showed it doing,
     // and the progress notes not yet on the website.
@@ -343,7 +344,7 @@ export class FreeRoomRunner {
         on_note: text => this.note(execution.id, text),
         // A stopped process may report after the next execution started; only its own execution takes the result.
         on_failure: error => { try { if (this.row(member.name)?.execution_id === execution.id) this.save(member.name, { error }); } catch { /* Store may already be closed at shutdown. */ } },
-        on_exit: () => this.exited.add(execution.id),
+        on_exit: denial => this.exited.set(execution.id, denial || ''),
       });
       if (result.session_id) this.store.bind(member.name, result.session_id);
       this.save(member.name, { status: result.status === 'sidecar_pending' ? 'sidecar_pending' : 'running', attempts: 0 });
@@ -377,7 +378,10 @@ export class FreeRoomRunner {
     if (row.error) return this.fail(member.name, execution.id, row.error);
     if (this.exited.has(execution.id)) {
       const latest = await api(this.config, `/executions/${execution.id}`);
-      if (['dispatched', 'started'].includes(latest.status)) return this.fail(member.name, execution.id, `${member.name} 会话已结束，但未提交本次回答；请核对原会话确认是否已有内容`);
+      const denial = this.exited.get(execution.id);
+      if (['dispatched', 'started'].includes(latest.status)) return this.fail(member.name, execution.id, denial
+        ? `${member.name} ${denial}，未提交本次回答`
+        : `${member.name} 会话已结束，但未提交本次回答；请核对原会话确认是否已有内容`);
       return this.save(member.name, { status: 'idle' });
     }
     if (Date.now() >= execution.created_at * 1000 + minutes * 60_000) return this.fail(member.name, execution.id, `超过单次执行时限 ${minutes} 分钟；请核对原会话确认是否已有内容`);