siyuan-plugins-mcp-sisyphus: Skill for Codex

使用构建产物进行真实思源验收

直接测试本轮构建出的 CJS，不用 TypeScript 源码、测试替身或陈旧的已安装产物代替。所有写入限定在用户明确指定的测试笔记本和本轮创建的隔离夹具中。

开始前读取 references/action-coverage.md。涉及严格写入时，同时读取仓库的 docs/zh/reference/write-safety.md 与 src/core/write-safety-policy.ts；后者是当前 action 分类的唯一真相源。

安全边界

• 不输出思源 Token、MCP Bearer Token、完整请求头、配置文件正文或无关笔记内容。
• 只修改测试笔记本内带本轮唯一前缀的文档、块、数据库、标签、模板和资源。
• 删除、移动、权限变更前重新解析目标 ID，并证明它属于本轮夹具；禁止用模糊路径、全局搜索结果或未解析变量做破坏性操作。
• 不调用 /api/repo/*，不为严格写入创建仓库快照。默认不实测会创建或回滚快照的 timeline action。
• 默认不执行同步、通知、反馈、第三方 extension 写入或 mascot.buy 等外部副作用。只有用户单独授权且后果可接受时才执行，并将其标为“外部副作用测试”，不要宣称具备严格状态校验。
• 保留用户原有数据和代码改动。测试夹具清理失败时停止扩大清理范围，先只读核对结果，报告精确 ID 和路径。
• 使用既有测试笔记本时，默认排除 fs.reorder、document.reorder：它们会切换整个笔记本的排序模式。确需测试时，先保存原 sortMode 并在结束后恢复；未保存原值时禁止猜测还原。
• 清理动作已禁用时，先记录限制，避免继续创建无法清理的模板或资源；不要改动用户的动作开关。

1. 建立本轮范围

先查看 git diff --name-only、git status --short 和相关测试，列出本轮实际改动影响的工具、action、公共协调器与传输入口。

若改动触及以下任一公共文件，将 src/core/write-safety-policy.ts 中全部 mode: 'mutation' action 纳入覆盖矩阵，而不是只测改动时顺手使用的一个 action：

• write-safety-*
• write-preflight-lease.ts
• tool-registry.ts 或 server.ts 的写入路由
• cli/write-coordinator.ts 或 CLI 写入分发
• 公共 API 写语义、响应精简、安全字段 schema

逐项记录 covered / blocked / intentionally excluded。存在未测试项时不得汇报“全部通过”。

2. 构建并锁定待测产物

从仓库根目录执行：

pnpm build:server
pnpm build:cli
test -s dist/mcp-server.cjs
test -s cli/dist/cli.cjs
shasum -a 256 dist/mcp-server.cjs cli/dist/cli.cjs

记录构建时间和 SHA-256，测试期间不要再次构建。生产验收使用 dist/mcp-server.cjs；只有用户明确要求开发产物时才改用 dev/mcp-server.cjs。

确认 Server bundle 没有浏览器 stdio shim：

if rg -q "StdioServerTransport is not supported in this environment" dist/mcp-server.cjs; then
  echo "browser stdio shim leaked into server bundle" >&2
  exit 1
fi

3. 检查真实环境

确认：

1. 思源内核正在运行，并能通过现有 CLI profile 调用 system get_version。
2. 严格安全写入已开启。
3. 用户指定的测试笔记本存在，且 Sisyphus 对它具有 rwd 权限。
4. 需要测试 CLI/stdio 共享租约时，插件 HTTP MCP 服务已开启。
5. 本轮测试前没有遗留的同名夹具。

只显示 profile 名、URL 主机和状态；不要打印 Token。

4. 创建隔离夹具

使用时间戳或 UUID 生成唯一前缀，例如 CJS-LIVE-20260812-213000。在测试笔记本中建立一个根测试文档，并按 action 需要创建：