install-putior

用途：在项目或环境中首次安装 putior R 包及其可选依赖，为「注解转流程图」流水线做好准备。适用于准备进行工作流可视化、下游技能（如分析代码库工作流、生成工作流图）需要 putior、或在 R 版本升级、renv 清空后恢复环境。\n\n必要前提：需要可用的 R 环境（>= 4.1.0）。可选：选择从 CRAN（默认）或 GitHub 开发版安装；选择要安装的可选依赖组，包括 MCP（mcptools、ellmer）、交互式（shiny、shinyAce）、日志（logger）、ACP（plumber2）。\n\n使用方式：先用 R.Version()$version.string 确认 R 版本达标；再安装主包，CRAN 用 install.packages("putior")，GitHub 开发版用 remotes::install_github("pjt222/putior")；随后按需安装可选依赖，例如 remotes::install_github("posit-dev/mcptools")、install.packages("ellmer")、install.packages("shiny")、install.packages("shinyAce")、install.packages("logger")、install.packages("plumber2")；最后验证：library(putior) 后检查 put、put_auto、put_diagram、put_generate、put_merge、put_theme 均为函数，并用临时文件测试 put_diagram(put(tmp)) 是否输出以 flowchart 开头的 Mermaid 代码。\n\n限制与常见问题：注解中需用单引号嵌套，如 id:'name'；本地构建 vignette 需在 .Renviron 中设置 RSTUDIO_PANDOC；项目使用 renv 时须改用 renv::install("putior")；从 GitHub 安装 mcptools 可能缺少 GITHUB_PAT 而失败；Linux 系统依赖缺失时需先安装相应库。其他细节以官方资料为准，暂未提供更多信息。