ai_co_discuss 0.3.19 → 0.3.22

package/.agents/skills/discuss-participant/SKILL.md

@@ -26,16 +26,16 @@ description: "AI CoDiscuss 的通用参与技能，所有参与者（包括主
 
 1. **不读取或打印凭据内容**，token 不进入提示或房间。每个成员只用自己的凭据，AI 不借用用户身份发言，房主控制凭据不能代替成员署名。（身份与权限由网站按凭据校验。）
 2. **执行失效后不再写入**：暂停、到期或被打断的旧任务保留草稿并结束，不换身份、职责或编号绕过拒绝，也不去掉 `--execution` 改作普通发言。任务文件的 `stopped_executions` 列出你此前被用户停止或跳过的执行：会话里如有它们未完成的工作，不接着做、不为它们补交，只处理本次请求。（失效的执行若还能产生可见结果，用户的打断与暂停就失去意义。）
-3. **写入前定好 `--submission-id`**：同次重试沿用编号和原内容，新内容换新编号；结果不明时先按原编号查询，再按 [写入与恢复](references/writing.md) 处理。（网站靠它去重，换号会产生重复发言。）
+3. **写入前定好 `--submission-id`**：同次重试沿用编号和原内容，新内容换新编号；`message post` 可省略，CLI 按房间、身份、关联与内容生成，用同一份草稿重试即得同一编号；结果不明时先按原编号查询，再按 [写入与恢复](references/writing.md) 处理。（网站靠它去重，换号会产生重复发言。）
 4. **不创建定时任务、不操作其他软件、不发状态回执**（就绪、开始、完成、停止等说明），除非用户要求或出现需要记录的异常；回执不能作为观点、完成或共识的证据。（这些动作有副作用，回执只会淹没真正的回答。）
 
 ## 命令入口与身份
 
 用统一命令 `codiscuss room …`、`codiscuss message …` 等；任务或用户显式指定 CLI 路径时沿用指定入口，未安装时用已核实的 `python 路径/runner/discuss.py …`（统一入口需 Node.js 24+，网站读写需 Python 3.10+）。裸 `codiscuss` 会启动服务，不要单独运行；用法查 `codiscuss --help`，字段以本技能为准，这里没写的才查 `codiscuss schema 具体命令`。下文命令均省略入口前缀。
 
-从实际任务或用户指定值核实站点、房间和身份，不从当前网页或最近聊天猜测：站点用 `--site`、进程 `DISCUSS_URL` 或凭据绑定的站点，房间始终显式指定，写入显式 `--as 本人`。任务标明 `access_env: "DISCUSS_ACCESS_FILE"` 时凭据已由进程绑定，`--access-file FILE` 可省略；否则用任务交付的 `access_file`。项目与 cwd 有值时用于本次获准资料；CLI 路径只定位工具，不把 CLI 仓库当作讨论项目或扩大文件权限。
+从实际任务或用户指定值核实站点、房间和身份，不从当前网页或最近聊天猜测。任务标明 `access_env: "DISCUSS_ACCESS_FILE"` 时凭据已由进程绑定，`--access-file FILE` 可省略；否则用任务交付的 `access_file`。任务凭据已绑定站点、房间、身份与本次执行，命令省略房间、`--as`、`--execution` 和 `--submission-id`，由 CLI 从凭据和内容补齐，例如 `message post --body-file 草稿.md`；下文命令里的 `ROOM`、`--as`、执行编号只在没有绑定凭据（如手动接入未带凭据）时需要填写。项目与 cwd 有值时用于本次获准资料；CLI 路径只定位工具，不把 CLI 仓库当作讨论项目或扩大文件权限。
 
-每次 shell 调用都是一次模型往返，手动会话里还可能要用户逐条确认，所以互不依赖的只读命令放进同一条 shell 命令依次执行。正文想好后，生成提交编号、写草稿、`message post` 放进同一条命令，草稿写成功才提交（失败重试仍用这份草稿和编号）；不同的网站写入各自单独执行并核对结果。
+每次 shell 调用都是一次模型往返，手动会话里还可能要用户逐条确认，所以互不依赖的只读命令放进同一条 shell 命令依次执行。正文想好后，先用当前软件的文件写入工具把正文（和需要的摘要）写成草稿文件，再用一条只含 `codiscuss` 的命令以 `--body-file`（`--summary-file`）提交；失败重试仍用这份草稿。不要用 heredoc、`echo` 重定向或命令行字面量传长文本，也不要在命令里调用函数生成编号（如 `[guid]::NewGuid()`、`$(uuidgen)`）：自动运行时这类组合命令会被权限检查拒绝，文本中的引号（含中文弯引号）还会截断参数。其他写入命令需要编号时直接写一个新的 UUID 字面值。不同的网站写入各自单独执行并核对结果。
 
 ## 阅读
 
@@ -58,6 +58,6 @@ description: "AI CoDiscuss 的通用参与技能，所有参与者（包括主
 
 ## 保存与核验
 
-正文优先 UTF-8 `--body-file`。需要附件时先 `attachment upload ROOM --file FILE --submission-id 上传编号`，再用 `message post --attachment ID` 关联（最多 10 个，单个 20 MiB，须在执行资格结束前上传）。
+正文用 UTF-8 `--body-file`，摘要含引号或较长时用 `--summary-file`。需要附件时先 `attachment upload ROOM --file FILE --submission-id 上传编号`，再用 `message post --attachment ID` 关联（最多 10 个，单个 20 MiB，须在执行资格结束前上传）。
 
 成功须核对服务端返回的持久记录、作者和关联；返回已是持久记录时不再读一遍，缺少所需证据才按编号补读。答案落库后即可结束，不用旧资格继续写入。代发保留真实作者、完整原文及引用关系，摘要归实际撰写者，不把自己的改写冒充对方回答。执行结束不等于整个房间的工作结束。

package/.agents/skills/discuss-participant/references/discussion.md

@@ -29,13 +29,13 @@
 自动任务用本次执行编号保存一次完整回答，例如：
 
 ```sh
-codiscuss message post ROOM --as 本人 --kind chat --execution 执行编号 --body-file draft.md --submission-id 新UUID --access-file FILE
+codiscuss message post ROOM --as 本人 --kind chat --execution 执行编号 --body-file draft.md --access-file FILE
 ```
 
 手动成员用自己的成员凭据和服务端给出的请求编号：
 
 ```sh
-codiscuss message post ROOM --as 本人 --kind chat --request 请求编号 --body-file draft.md --submission-id 新UUID --access-file FILE
+codiscuss message post ROOM --as 本人 --kind chat --request 请求编号 --body-file draft.md --access-file FILE
 ```
 
 需要摘要时一并使用 `--summary` 或 `--summary-file`。成功提交后当前请求即完成；不要再补一条普通 chat 或状态回执。

package/.agents/skills/discuss-participant/references/writing.md

@@ -28,7 +28,7 @@
 
 主持类写入需要本次任务授予主持职责。网页成员代发须保留真实作者、完整原文、关联请求、原答复的链接/引用对应关系及同房间关联，不把自己的改写冒充他人原文。主持人补充的引用附录需明确标注来源与归属，无法取得的出处说明缺失；不把自己的核验结论混进专家原文。
 
-房间、消息和安排创建使用显式 `--submission-id`：新内容生成新编号，同一次提交保留编号、原始资料、身份和关联。**先保存编号与原文，再发请求**，避免中断后无法核对。编号为 8–100 位字母、数字、下划线或连字符，可用 UUID。建房重试对照首次创建资料，不使用后来修改的话题内容替换请求。
+房间、消息和安排创建使用显式 `--submission-id`：新内容生成新编号，同一次提交保留编号、原始资料、身份和关联。**先保存编号与原文，再发请求**，避免中断后无法核对。编号为 8–100 位字母、数字、下划线或连字符，可用 UUID。`message post` 省略编号时由 CLI 按房间、身份、关联与内容生成（`auto-` 开头），草稿文件即原文记录，重试只需用同一份草稿。建房重试对照首次创建资料，不使用后来修改的话题内容替换请求。
 
 长正文优先 UTF-8 文件，`--body-file -` 可读 stdin。当前消息正文上限为 32000 个 Unicode 字符，详细讨论状态上限为 4000 字；以目标站点协议为准。完整回答一次提交并完成安排，不能截断或用第一段冒充完整回答。超过上限时保留完整原文并说明限制，先明确完整材料的留档方式。
 

package/backend/free_room.py

@@ -1107,11 +1107,11 @@ def advance_queues(connection, room_id):
 
     Asked rows stay, so the speaking order can still show who already answered.
     """
-    connection.execute(f"""DELETE FROM free_queue WHERE room_id=? AND NOT {QUEUE_ASKED.format(row="free_queue")}
-        AND NOT EXISTS(SELECT 1 FROM room_members m WHERE m.id=free_queue.member_id AND m.status='active')""", (room_id,))
-    connection.execute(f"""INSERT OR IGNORE INTO member_requests (room_id,member_id,message_id,chain_id,batch_id,purpose,created_by,created_at)
-        SELECT q.room_id,q.member_id,q.message_id,q.message_id,0,'ask','user',? FROM free_queue q
-        WHERE q.room_id=? AND q.id=(SELECT MIN(x.id) FROM free_queue x WHERE x.message_id=q.message_id AND NOT {QUEUE_ASKED.format(row="x")})
+    connection.execute("""DELETE FROM free_queue WHERE id IN (SELECT q.id FROM free_queue_waiting q WHERE q.room_id=?
+        AND NOT EXISTS(SELECT 1 FROM room_members m WHERE m.id=q.member_id AND m.status='active'))""", (room_id,))
+    connection.execute("""INSERT OR IGNORE INTO member_requests (room_id,member_id,message_id,chain_id,batch_id,purpose,created_by,created_at)
+        SELECT q.room_id,q.member_id,q.message_id,q.message_id,0,'ask','user',? FROM free_queue_waiting q
+        WHERE q.id IN (SELECT MIN(id) FROM free_queue_waiting WHERE room_id=? GROUP BY message_id)
         AND NOT EXISTS(SELECT 1 FROM member_requests r WHERE r.message_id=q.message_id AND r.status IN ('pending','delivering'))""",
                        (int(time.time()), room_id))
 
@@ -1142,8 +1142,11 @@ def speaking_order(connection, room):
         target = session["id"]
         items, later, session_plan_state = discussion.session_speaking_order(connection, session)
     else:
-        target = connection.execute("""SELECT MAX(q.message_id) FROM free_queue q LEFT JOIN member_requests r ON r.message_id=q.message_id
-            AND r.member_id=q.member_id WHERE q.room_id=? AND (r.id IS NULL OR r.status IN ('pending','delivering'))""", (room["id"],)).fetchone()[0] or 0
+        target = connection.execute("""SELECT MAX(message_id) FROM (
+            SELECT MAX(message_id) AS message_id FROM free_queue_waiting WHERE room_id=?
+            UNION ALL SELECT MAX(r.message_id) FROM member_requests r WHERE r.room_id=? AND r.status IN ('pending','delivering')
+            AND EXISTS(SELECT 1 FROM free_queue q WHERE q.message_id=r.message_id AND q.member_id=r.member_id))""",
+            (room["id"], room["id"])).fetchone()[0] or 0
         if target:
             kind = "queue"
             for row in connection.execute("""SELECT q.member_id,r.status FROM free_queue q LEFT JOIN member_requests r
@@ -1817,8 +1820,8 @@ def interrupt_member(connection, room_id, member_id, token):
 
 def withdrawals(connection, room_id):
     """The room's taken-back messages by id, so the page keeps them in place while AI readers skip them."""
-    return [dict(row) for row in connection.execute("""SELECT w.message_id,w.kind FROM message_withdrawals w
-        JOIN messages m ON m.id=w.message_id WHERE m.room_id=? ORDER BY w.message_id""", (room_id,))]
+    return [dict(row) for row in connection.execute("""SELECT w.message_id,w.kind FROM message_withdrawal_rooms r
+        JOIN message_withdrawals w ON w.message_id=r.message_id WHERE r.room_id=? ORDER BY r.message_id""", (room_id,))]
 
 
 def owner_message(connection, room_id, message_id):

package/backend/remote_launch.py

@@ -20,6 +20,8 @@ from .admin import AdminError
 from .runtime import begin_write
 
 MACHINE_ONLINE_SECONDS = 30
+# Heartbeats refresh seen_at at most this often (well inside the online window) so frequent polls do not each write a row.
+MACHINE_SEEN_REFRESH_SECONDS = 10
 MACHINE_NAME_MAX = 60
 PROJECT_NAME_MAX = 80
 PROJECTS_MAX = 100
@@ -135,11 +137,15 @@ def machine_sync(connection, machine_id, token, payload, now):
     projects, clients = valid_projects(payload.get("projects")), valid_clients(payload.get("clients"))
     public_key = valid_public_key(payload["public_key"]) if "public_key" in payload else None
     begin_write(connection)
-    connection.execute("UPDATE local_machines SET projects=?, clients=?, seen_at=? WHERE id=?",
-                       (json.dumps(projects, ensure_ascii=False), json.dumps(clients, ensure_ascii=False), now, machine_id))
+    # Unchanged heartbeats write nothing until seen_at is due for a refresh.
+    connection.execute("UPDATE local_machines SET projects=?1, clients=?2, seen_at=?3 WHERE id=?4 "
+                       "AND (projects IS NOT ?1 OR clients IS NOT ?2 OR seen_at<?3-?5)",
+                       (json.dumps(projects, ensure_ascii=False), json.dumps(clients, ensure_ascii=False), now, machine_id,
+                        MACHINE_SEEN_REFRESH_SECONDS))
     if public_key:
         connection.execute("INSERT INTO machine_keys (machine_id,public_key) VALUES (?,?) "
-                           "ON CONFLICT(machine_id) DO UPDATE SET public_key=excluded.public_key", (machine_id, json.dumps(public_key)))
+                           "ON CONFLICT(machine_id) DO UPDATE SET public_key=excluded.public_key "
+                           "WHERE machine_keys.public_key IS NOT excluded.public_key", (machine_id, json.dumps(public_key)))
     rows = connection.execute("SELECT id,request FROM remote_launches WHERE machine_id=? AND status IN ('pending','claimed') ORDER BY created_at",
                               (machine_id,)).fetchall()
     return {"launches": [{"id": row["id"], "request": json.loads(row["request"])} for row in rows]}
@@ -245,7 +251,7 @@ def claim_machine_commands(connection, machine_id, token, now):
     require_machine(connection, machine_id, token)
     begin_write(connection)
     connection.execute("DELETE FROM machine_commands WHERE machine_id=? AND created_at<?", (machine_id, now - COMMAND_TTL_SECONDS))
-    connection.execute("UPDATE local_machines SET seen_at=? WHERE id=?", (now, machine_id))
+    connection.execute("UPDATE local_machines SET seen_at=? WHERE id=? AND seen_at<?", (now, machine_id, now - MACHINE_SEEN_REFRESH_SECONDS))
     rows = connection.execute("SELECT id,request FROM machine_commands WHERE machine_id=? AND status='pending' ORDER BY created_at",
                               (machine_id,)).fetchall()
     for row in rows: