runweft-kit

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Runweft Kit

让用户通过对话完成操作，你负责 CLI 与验证；用户只在自己的浏览器处理身份保存、选择空间和确认连接。复用既有安装与连接，不从头重建环境。

Enable users to complete operations through conversation. You are responsible for the CLI and verification, while users only handle identity storage, space selection, and connection confirmation in their own browsers. Reuse existing installations and connections; do not rebuild the environment from scratch.

先选择路径

Choose the path first

安装、首次连接、增加执行机：读 onboarding.md。
配置机器/runtime、Agent、仓库、个人选择：读 configuration.md。
委派、等待、续接、停止、审批、附件与代码：读 delegation.md。
排错、升级、卸载、当前附件与成果留存：读 maintenance.md。

完整卸载先按 maintenance.md 核对版本与预览，不打开业务数据。其他操作先执行

runweft --version

、

runweft --json config show

、

runweft hub connect status

，了解实际版本、数据根、Hub 和保存的空间；没有程序时先安装。通过

--help

核对版本差异，不编造命令。CLI 全局

--home <目录>

、

--space <UUID>

、

--identity-file <文件>

、

--json

放在子命令前；示例中的尖括号均替换为真实返回值。

Installing, making the first connection, or adding an execution machine: read onboarding.md.
Configuring machines/runtimes, Agents, repositories, and personal selections: read configuration.md.
Delegating, waiting, resuming, stopping, approving, and handling attachments and code: read delegation.md.
Troubleshooting, upgrading, uninstalling, and managing current attachments and artifact retention: read maintenance.md.

For a complete uninstall, first verify the version and preview the operation according to maintenance.md, and do not open business data. For other operations, first run

runweft --version

runweft --json config show

, and

runweft hub connect status

to determine the actual version, data root, Hub, and saved space. If the program is not installed, install it first. Use

--help

to check for version differences; do not invent commands. The global CLI options

--home <directory>

--space <UUID>

--identity-file <file>

, and

--json

must be placed before the subcommand. Replace all angle-bracket placeholders in the examples with actual returned values.

不可省略的边界

Boundaries that must not be omitted

委派必须连接明确 Hub；
```
mode local
```
只是托管本机 Hub，不是离线 Agent/YAML 模式。本机 Hub 同样使用独立身份与空间权限。
不索要、读取或打印身份备份、机器凭据、原生模型凭据。凭据不放入 prompt、日志、URL 或命令参数；Web→CLI 使用
```
hub connect begin/complete
```
加密交接。只展示无秘密的核对码/确认链接。身份失效时要求用户选择原身份，不自动创建新身份。
仅在用户授权范围内修改全局安装/MCP、资源共享、服务或数据。保留其他 MCP、hooks、原生配置和已有会话。不擅自调整模型登录、权限模式或执行机器上的信任设置。
用户明确要求完整卸载 Runweft 时，先用
```
runweft --home <目录> uninstall
```
预览核对范围，再直接执行
```
runweft --home <目录> uninstall --yes
```
，无备份地移除该 home 的全部数据、当前程序、自身 MCP/hook 和已确认的 Skill，并保留其他软件配置、模型凭据、原生会话和用户项目。
机器、runtime、Agent 是三个对象；Agent 是 Hub 中的定义，不是当前主宿主。使用完整 UUID，不按名称猜测或创建仓库 YAML。管理员治理不等于能读他人私有内容。
```
spawn
```
接受不代表执行成功。未知结果先查询原请求/任务，保留原 request ID 与参数；不得盲目重发、清历史或更换身份绕过不确定状态。
受管子 agent 禁用 Runweft MCP，拒绝 CLI/MCP 递归委派；不要绕过。主宿主退出后不后台唤醒或恢复旧父会话。
不自动 push、合入成果、删除 worktree 或释放唯一结果副本。分享 runtime 是原生账户执行能力，不是 OS 沙箱。

Delegation requires a connection to an explicit Hub.
```
mode local
```
only hosts a local Hub; it is not an offline Agent/YAML mode. A local Hub also uses an independent identity and space permissions.
Do not request, read, or print identity backups, machine credentials, or native model credentials. Credentials must not be placed in prompts, logs, URLs, or command arguments. Web→CLI uses the encrypted
```
hub connect begin/complete
```
handoff. Only display secret-free verification codes or confirmation links. If an identity expires, ask the user to select the original identity; do not automatically create a new one.
Modify global installations/MCP, resource sharing, services, or data only within the scope authorized by the user. Preserve other MCP integrations, hooks, native configurations, and existing sessions. Do not modify model login, permission modes, or trust settings on execution machines without authorization.
When the user explicitly requests a complete Runweft uninstall, first preview the scope with
```
runweft --home <directory> uninstall
```
, then directly execute
```
runweft --home <directory> uninstall --yes
```
. This removes all data under that home directory, the current program, Runweft's own MCP/hook, and the confirmed Skill without creating a backup, while preserving other software configurations, model credentials, native sessions, and user projects.
Machines, runtimes, and Agents are three distinct objects. An Agent is a definition in the Hub, not the current primary host. Use full UUIDs; do not guess identifiers from names or create repository YAML. Administrative governance does not grant permission to read other users' private content.
Acceptance by
```
spawn
```
does not mean execution succeeded. For an unknown outcome, first query the original request/task and retain the original request ID and parameters. Do not blindly resend the request, clear history, or switch identities to bypass an uncertain state.
Managed sub-agents disable Runweft MCP and reject recursive CLI/MCP delegation; do not bypass these restrictions. After the primary host exits, do not wake it in the background or restore an old parent session.
Do not automatically push or merge artifacts, delete worktrees, or release the only copy of a result. Sharing a runtime is a native account execution capability, not an OS sandbox.

交付给用户

Deliver to the user

简要报告实际 Hub、空间、资源 ID、已完成操作与真实验证结果，提供无秘密的

/hub

链接。分别说明“工具已发现 / MCP 握手 / 原生实际调用 / 模型完成 / 成果可用”，不要互相代替。遇到外部条件缺失，给出具体失败阶段和所需条件，不把仍能自动完成的本地检查交回用户。

Briefly report the actual Hub, space, resource IDs, completed operations, and real verification results, and provide a secret-free

/hub

link. Clearly distinguish “tool discovered / MCP handshake / native invocation performed / model completed / artifact usable”; do not treat one as evidence of another. When an external condition is missing, identify the exact failure stage and required conditions. Do not return local checks to the user when those checks can still be completed automatically.