跳到正文
Motux Build
手册目录

适用于已发布的模块化版本。
功能核对：2026-09-13

下载完整手册 .md
使用手册

独立能力模块

按需安装工作方法，在兼容范围内单独更新。

5 项说明

首模块：joint-delivery 0.1.0

独立文件大小 10,032 字节。下载后向 Agent 提供这一完整校验值，再明确安装范围；启用是下一步选择。

下载独立模块 JSON

SHA-25674cc7fe23150a9adf2839861dce7637963120b62d17101cd6c2f1ab37ab36a75

当前采用精确校验值导入；签名模块网络目录尚未上线。

检查与安装独立模块

增加一份经过校验的工作方法。

能帮你完成什么

模块有自己的 ID、版本、内容校验值和基础组件要求。首次使用模块机制需要 Core 1.0.98 / Manager 0.1.29 或兼容新版；之后兼容的模块内容可以单独安装或更新。模块只有声明式 Markdown、JSON、TXT 资源，不运行安装脚本或 Hook。

使用前

项目已明确采用有效的 user 或完整 local 安装；Node 已可用。disabled、undecided、conflict 不直接进入安装。

怎么使用

  1. 点名模块、版本和来源，让 Manager 先 check；本地审阅包必须提供完整 SHA-256。
  2. 确认安装范围：local 保存在项目内，user 存储供用户级项目选择。
  3. 校验大小、身份、资源和兼容性通过后安装；安装完成再决定是否在项目启用。

试着这样对 Agent 说

请检查 joint-delivery 0.1.0 的已发布模块包是否与当前 Build 兼容。先说明安装范围、来源和 SHA-256，确认具体包后再安装。

如何判断完成

  • 安装得到不可变的模块内容身份和状态。
  • 其他模块、基础插件和项目文档不会因这次安装被替换。

适用边界

  • 当前公开首模块使用下载后指定精确 SHA-256 的导入方式。
  • 签名网络模块目录尚未上线；未签名 candidate 不能作为可信安装目录。

启用、固定版本与停用

决定哪个项目实际使用已安装模块。

能帮你完成什么

模块安装与项目选择分开。follow 会在后续新任务中使用存储的当前版本；固定版本会同时指定版本与 SHA-256。停用仅改变当前项目选择，保留模块包和已经生成的计划、验收资料。

使用前

模块已经安装并校验通过，当前项目采用有效安装范围。

怎么使用

  1. 确认要启用的模块及当前版本。
  2. 选择跟随更新或固定精确版本，再写入当前项目选择。
  3. 让 Manager resolve 验证；不需要时明确停用该项目的模块。

试着这样对 Agent 说

在当前项目启用已经安装的 joint-delivery。先显示版本和校验值，我希望固定这一个版本；不要替其他项目启用。

如何判断完成

  • CAPABILITIES.json 只改变被选择模块的记录。
  • 已安装但未启用的模块不会被 Core 当作当前任务输入。

适用边界

  • 已开始的任务保留自己的模块内容身份，不因 follow 更新在中途换成新内容。
  • 禁用后旧任务不能继续解析这个已被禁用的模块，需明确恢复选择。

单独更新与回退模块

更新所选内容，保留其他模块和已有任务。

能帮你完成什么

Manager 为每个模块保留不可变内容、current 和 previous 记录。升级只替换选中模块的当前身份；旧任务仍可以核验自己保存的版本。回退交换该模块 current/previous，并保留两份内容。

使用前

模块已安装；要更新的包有明确身份且与当前底座兼容；回退需要有效 previous。

怎么使用

  1. 先 inspect/check，查看当前、目标和完整性。
  2. 明确只更新这个模块，验证后再应用。
  3. 出现问题时请求回退并检查项目是否固定版本；必要时单独调整项目选择。

试着这样对 Agent 说

检查 joint-delivery 的已安装版本和我提供的新包。若兼容，请只更新这个模块，保留其他模块和已有任务的版本；完成后说明回退入口。

如何判断完成

  • 只有该模块记录变化，基础 Plugin 无需因为兼容内容更新而重新安装。
  • 可以查看升级前后身份，并说明固定选择是否仍指向旧版。

适用边界

  • 回退存储不会偷偷改写项目的固定版本选择。
  • 资源被修改、缺失或兼容性不满足时会阻断更新。

处理中断与锁冲突

在不猜测原始状态的前提下恢复模块事务。

能帮你完成什么

普通 recover 根据记录验证旧状态或新状态，完成可以明确判断的中断事务。锁被活跃进程持有时等待或停止；异常锁维护需要先停止所有相关写入者，核对准确所有者，再执行明确的离线操作。

使用前

存在真实中断或锁错误。保留原始状态和错误信息，不先删除目录。

怎么使用

  1. 让 Agent 只读 inspect 和 locks，定位模块、事务和锁。
  2. 有完整且可验证的事务记录时，按 Manager recover 处理。
  3. 所有者缺失、记录损坏或状态模糊时，停止写入并人工检查；仅在明确离线维护条件后使用 recover-locks。

试着这样对 Agent 说

模块更新中断了。请先只读检查事务和锁，说明是否仍有写入者。不要直接删锁或模块目录，只对可以验证的中断事务提出恢复步骤。

如何判断完成

  • 得到可恢复、仍在使用或需要人工检查的明确判断。
  • 恢复完成后重新核验内容和状态。

适用边界

  • 不承诺任意崩溃点都自动恢复；不支持跨主机共享文件系统锁。

联合开发统筹模块

把多个项目连成一个可联合验收的业务流程。

能帮你完成什么

joint-delivery 0.1.0 是首个独立模块。prepare 负责共同目标、项目边界、事实归属、接口和依赖；coordinate 负责拆任务、交接和变更影响；verify 负责按版本组合验证整条链路。它提供指南与模板，不连接仓库或自动替你调度其他项目。

使用前

已安装并在当前统筹项目启用 joint-delivery；知道涉及的项目、共同目标和资料归属。

怎么使用

  1. 准备：列出各项目负责的事实、接口版本、共同样例、依赖与验收负责人，形成联合计划。
  2. 协调：给提供者和消费者明确任务合同、完成证据及交接；接口变化时列出受影响项目。
  3. 联合验收：固定参与版本，从头走成功、拒绝、重复请求、超时和恢复，记录真实证据。

试着这样对 Agent 说

使用 joint-delivery 的 prepare 阶段。我们的申请系统、审批系统、展示系统要完成同一条流程，请整理共同目标、事实归属、接口样例、依赖和联合验收计划。

如何判断完成

  • joint-plan、task-handoff、joint-acceptance 模板帮助记录计划、交接和验收。
  • 例如审批成功但展示仍是旧状态，应判定联合验收未通过。

适用边界

  • 示例是“申请 → 审批 → 展示”，不是已部署的示范系统。
  • 三个项目各自测试通过，不能代替端到端联合验证。
  • 后续明确需要 coordinate 或 verify 时才加载该阶段。