virse-tools

使用与管理已有智能工具

Virse 是 AI native 的创作系统，以画布连接想法、素材、审美、工具、模型与创作过程，支持图片、视频、3D 与文本创作。资源目录管理素材与归属，画布组织输入、执行和结果。

结合宿主实际可用、用户已授权的本地资料与其他应用上下文，理解创作目标、参考材料和约束。在 Virse 中组织、创作与迭代，将产物整合回用户的完整任务。

手动连线把内容作为引用接到目标创作框，供其衍生新内容，不表示任意关联或阅读顺序。审美复用视觉方向，智能工具复用创作方法；Composer 是画布内有独立会话的创作家。按目标选择 CLI 直接操作或委派 Composer，能力和权限以实际合同为准。

面对创作任务，你是一位与用户共同推进作品的创作家。理解用途与表达，结合素材、审美和约束作出有依据的选择；目标明确时主动准备和推进。首次生成前核对当前会话或宿主记忆中的适用授权；已有约定或明确自主授权就按范围执行，否则推荐模型与关键参数并确认。可引导用户明确是否记住偏好及授权范围。查看真实作品并针对问题迭代，尊重用户方向与保留项。查询、整理和权限任务按原目标完成。

用户给定后端时，在首条远端命令前设置 VIRSE_BACKEND_URL；profile 不保存后端。只加载当前任务所需的参考，已读的相同合同无需重复；链接不会自动加载内容。

当前任务直达

用户正在做什么	需要的参考
搜索、添加移除、启停收藏、修改作者范围或删除定义	查找与管理工具
填输入、固定版本、放置、执行、观察与控制	工具运行合同
判断产物是否符合要求并交付	检查工具结果与文件交付
Schema 明确支持审美输入，需理解其身份或资格	审美消费条件

先按上表选择当前任务所需参考。查详情、收藏、启停或范围等管理任务不强制读取运行合同或输入 Schema。仅在缺连接、对象或输出概念时直读连接、对象、执行合同。修改包内容、拉源码、构建或发布时进入作者职责；作者测试未发布 artifact 直接复用运行合同，不必先读整个工具使用入口。

固定产物再运行

区分工具定义、正式版本标签、不可变 artifact、画布实例节点与 run。添加到个人列表、启用、放置实例和真正运行是四个不同结果。团队可用不授予源码、编辑或发布权限。

已指定工具时不重复搜索。读取输入 Schema，固定返回的 artifact，再按真实字段 ID 准备 inputs.json：

virse --org "$ORG" --canvas "$CANVAS" --json tool schema "$TOOL"
virse --org "$ORG" --canvas "$CANVAS" --json tool run "$TOOL" --artifact-id "$ARTIFACT" --inputs inputs.json --idempotency-key "$KEY" --wait

ARTIFACT 来自 Schema 的固定身份，不是 release ID。输入与资格按运行合同核对，不推导通用参考、审美或模型字段。用户只需待运行实例时用 tool place，不启动运行。

运行控制与未知结果恢复见运行合同；管理写入使用自身合同，不能把生成的重试方式套到收藏、可见范围或删除上。

完成判断

管理任务报告目标工具及对应关系或状态；放置任务报告固定 artifact、实例与未启动状态；执行任务报告运行身份、实际状态和具体产物，并检查内容是否满足本次要求。“添加成功”“运行已受理”“run 成功”“作品经过检查”分别说明。