Skip to content

docs: add agent-guided macOS setup - #4

Merged
Alex-ghost599 merged 1 commit into
developfrom
docs--agent-install-guide
Jul 19, 2026
Merged

docs: add agent-guided macOS setup#4
Alex-ghost599 merged 1 commit into
developfrom
docs--agent-install-guide

Conversation

@Alex-ghost599

Copy link
Copy Markdown
Owner

问题

README 原有流程只覆盖源码下载安装,没有把服务端、客户端、逐机 TCC 权限和真人右 Shift 上屏验收串成完整闭环,也没有可直接交给本机 AI agent 的安全安装入口。

改动

  • 扩写 README:环境要求、临时下载目录、Release 清单与固定 SHA 双重校验、新目录策略、uv/模型、固定 127.0.0.1:6016 启动、三项 TCC、逐机真人验收。
  • 新增 docs/agent-macos-install.md,锁定 v2.6.0-macos.2、commit 040e6ff 和脚本 SHA,覆盖预检、安装、失败续接、静态验收、启动、权限、真人验收、隐私与最终报告。
  • README 增加一条可复制中文 prompt,指向公开 develop 文档 URL,明确 agent 与人类责任边界。
  • 增加文档与 Release/安装器一致性测试。

验证

  • uv run pytest -q:52 passed, 1 skipped
  • uv run pytest -q tests/test_agent_install_docs.py:4 passed
  • bash scripts/lint_macos_port.sh
  • git diff --cached --check
  • v2.6.0-macos.2 已从公开资产全新完整安装:77 个冻结依赖、两个固定哈希模型、arm64 App、codesign 均通过
  • 独立 reviewer:EXACT-STAGED PASS,无 P1/P2/P3

风险与后续

agent 文档 URL 在本 PR 合并前按预期返回 404。合并后的发布门禁是该 URL 必须公开返回 HTTP 200;若失败,任务不算完成。每台 Mac 的 TCC 权限与真人物理麦克风上屏仍必须由本机人类完成,文档禁止 agent 用静态或模拟结果替代。

@Alex-ghost599
Alex-ghost599 merged commit 82dd3ea into develop Jul 19, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant