Skip to content

docs: explain offline MSG and reliable local agent collaboration - #240

Merged
LIghtJUNction merged 1 commit into
mainfrom
docs/offline-agent-collaboration
Oct 12, 2026
Merged

LIghtJUNction merged 1 commit into
mainfrom
docs/offline-agent-collaboration

Conversation

@LIghtJUNction

Copy link
Copy Markdown
Contributor

更新内容

说明 MSG 不仅用于连接网站,也可作为同机受信任 Agent 的本地离线邮箱。

  • 新增 docs/OFFLINE_COLLABORATION.md:独立本地目录、两个终端的任务/接收确认/结果交接、持续监听与恢复、固定版本产物引用、消息重试与去重、数据保护及远程切换。
  • 更新中英文 README 和 PRODUCT,介绍离线用途与本地协作方式;文档导航增加直接入口。
  • 更新 msg-entry 技能:用户明确选择离线模式时先核对本机 CLI,不要求联网或注册。不改变现有项目协作渠道要求,也不自动把失败的远程操作降级到本地。

明确边界

本地邮箱、远程私有邮箱和本机运行 msgd 是三种不同用法。本地/远程不会自动同步或互相替代。#worker 是路由标签,不是独立身份或权限隔离。MSG 不启动 Agent、不认领任务、不锁定源码、不合并代码。游标只记录输出位置,不证明任务已执行;执行工具仍需保存待办与完成结果。

示例采用新的独立目录,移除该进程继承的 MSG_SERVER,不接触生产身份。消息正文中的任务字段仅为团队约定,不是新增协议或 CLI 参数。

核对与验证

实现核对基于 main f0249a6d742f8674f5aeb6285494e6342fbdee1f,阅读了 CLI 分派、本地 SQLite 邮箱、监听游标、客户端账号选择与路径检查。

  • 修改前的五份原文与 Git blob SHA 一致;仅修改六份 Markdown 文档。
  • 新指南的 9 个 shell 代码块通过 Bash 语法检查。
  • 12 条示例命令通过提取的现有 CLI 参数定义检查;4 份 JSON 示例解析通过。
  • 20 个新增相对链接与已核对的仓库目标路径对应。
  • git diff --check 通过;差异为 +315 / -10。
  • 已核对提交与基线比较,仅包含上述六份文档。

未运行完整客户端或端到端测试。 当前执行环境为 Python 3.13,项目源码要求 Python 3.15。参数检查不等于真实运行验证;本次没有服务器发布、生产通信或部署验收。

提交:7dda1591d9e0dd2908df1644bd1bd5801ad4a6db。不修改 Rust 迁移分支。

Copilot AI balanced review requested due to automatic review settings October 12, 2026 22:29

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for security reviews. Please try again later.

@LIghtJUNction
LIghtJUNction merged commit 459f3f7 into main Oct 12, 2026
11 of 15 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants