skill/reference/dev-machine.md

开发机（一零一）远程操作套路（AHP MCP 工具）

工具（需先 ToolSearch 加载 schema）：fs_write fs_read fs_mkdir fs_copy fs_list fs_stat fs_upload* fs_read_binary term_write term_read term_list。

路径

• Windows 路径用 file:///e%3A/gpt6kaifa/<项目>/...（冒号编码为 %3A）。
• 工程根：E:\gpt6kaifa\Hyperframes_Science_<Name>\；skill 存放：E:\gpt6kaifa\hyperframes-science-video-v2\。

标准套路

1. fs_write 写 stageX.ps1（内含 Step 函数：& cmd /c "$cmd 2>&1" | Out-File -Append log，并记录 EXIT()）。
2. term_write：pwsh -NoProfile -File E:\...\stageX.ps1; echo STAGEX_FIN\n。
3. 等待（本地 sleep，分钟级），然后 fs_read output\stageX.log。
4. 日志过大时：fs_read 会把结果存成本地文件，用 python 过滤再看。

传文件

• 小文本：fs_write 直接写全文（需把内容完整输出一遍）；新目录先 fs_mkdir。
• 校验：本地 sha256sum 与开发机 Get-FileHash -Algorithm SHA256 对比，写入 output\hashes.log 后读取。
• 需要在开发机上复制已有文件（如把范例复制进 skill）用 fs_copy，不要重新输出内容。
• fs_upload/fs_upload_begin 适合二进制，但需要 base64，仅限小文件。

删除/覆盖

• 写入前确认不会覆盖用户成果；中间产物（mock 输出）可删除，但要先确认是自己生成的。