workspace

用途：管理研究项目写作/文档一侧的工作，包括按需搭建基础设施、向用户展示渲染结果、保存迭代。研究任务图（规划、执行类型化任务）由 asta-flows 负责。

主要能力：

• 展示渲染成果：本地智能体运行 make preview 并给出 Quarto 打印的 URL；无端口可访问的无头智能体先推送分支，再用 make deployed-url 从 GitHub Pages CI 获取部署 URL。
• 查看变更：asta workspace what-changed <ref>（需 Git 2.30+），在指定 ref 与私有工作树副本中运行 make render，复用 PR 预览的 diff 脚本，仅发布到 .asta/cache/what-changed/；也可后台运行 asta workspace preview --what-changed 并使用其 4849 端口。
• 保存：git add 与 git commit -m "<简洁信息>"；未经用户明确批准不要 git push。无头智能体首次保存用 git push -u origin HEAD:<feature-branch>、gh pr create --fill，随后 make deployed-url；后续保存用 git push、make deployed-url；合并需明确批准后 gh pr merge。
• 按需搭建组件：Quarto 构建工具（始终）、版本工作流桩（始终）、GitHub Pages 部署（无用户可达端口或用户要求时）、Dev container（用户不想装宿主机依赖或需浏览器访问时）。
• 证据支撑：脚手架每次渲染前从 asta-plugins 获取 Quarto 扩展 _extensions/evidence/，用 evidence.yml 存放逐字引文与 cite key，正文中以 [文字]{.ev key="..."} 标记，悬停显示引文与引用。

使用方式：复制 assets 下相应文件（_quarto.yml、Makefile.managed、docs.yml、README.md、devcontainer.json 等），填写占位符，运行 asta workspace sync --require-scripts 与 make check。可选独立 LaTeX 论文支持（make paper、PAPER_DIR 选择目录）。

限制：引文只接受逐字引用，无改写模式；基线仅含已提交文件；比较需逐个运行；是否需证据及引文是否支撑论断属判断，需加载 check-claims 技能；未经批准不得推送或合并；覆盖已有文件前需询问用户。部分细节（如具体版本、收费）资料未提供。