2.4 KiB
受管工具与文件快照模板
本模板使用 ARTEMIS 2.4.5 新增的 artemis.plugins.sdk，最低宿主版本为 2.4.5。复制模板后使用该版本或更新版本的 ARTEMIS Python；正式的 2.4.4 包不提供这些接口。模板随源码和 Skill 分发，尚未发布到市场。纯文件写入可用相邻 evidence-demo，本模板用于需要外部工具或已批准文件输入的插件。
复制整个目录，使用 ARTEMIS 自己的 Python：
<ARTEMIS_PYTHON> -B test_contract.py
测试只在临时目录创建样例和休眠进程，验证 SDK 的文件替换、超时、取消、后代回收、输出上限，以及真实 stdio MCP 调用、错误输入拒绝和宿主附件回读。结果分为 SDK 自测与本模板离线契约，不证明改写后的插件、设备或业务通过。
扩展时保持固定 argv 和工作目录。先用 snapshot_file(path, approved_sha256) 得到不可变 bytes，再将 snapshot.data 或 snapshot.chunks() 交给实际消费者；不要重新打开原路径。默认内存输入上限 64 MiB，按明确需求选择上限；超大固件需要另外实现有等价保护的流式存储，并单独验证。
await run_process(argv, cwd=..., timeout=..., input_data=...) 不执行 shell、不重试，返回原始退出码与 stdout/stderr。标准输入最多 64 MiB，stdout/stderr 共用默认 4 MiB 上限。它在正常退出、超时、取消、输出超限时回收后代；Windows 先将等待启动的引导进程加入 Job Object，再运行工具。POSIX 使用独立会话；这些是生命周期管理，不是恶意程序沙箱，不能托管主动逃离进程组的程序。
宿主负责整个 MCP 调用的期限；插件负责内部操作和子进程。内部超时先发生时，插件必须在返回前完成回收。取消会在回收后传播，不能吞掉 CancelledError 后声称完成。ManagedProcessError.error_code 稳定且不回显命令，may_have_started 决定能否声明尚未执行；process_cleanup_unconfirmed 必须按未知处理。命令输出可能包含敏感数据，按业务白名单转换后再返回。
本工具只处理已有任务文件，不提供观察或任意命令能力。保留模板 LICENSE、SOURCE.md，并补充新增代码、协议、资料与依赖的来源和业务回归。在副本中执行 check_plugin.py --prepare-market 生成全部未验证的市场记录；本模板自身的离线通过不能填作真实业务验收。