Blame for 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 输出）可删除，但要先确认是自己生成的。