agentic-stack 运维完全指南doctor 审计、安全升级与 TUI 管理面板让你从容驾驭 AI 基础设施【免费下载链接】agentic-stackOne brain, many harnesses. Portable .agent/ folder (memory skills protocols) that plugs into Claude Code, Cursor, Windsurf, OpenCode, OpenClaw, Hermes, or DIY Python — and keeps its knowledge when you switch.项目地址: https://gitcode.com/gh_mirrors/ag/agentic-stackagentic-stack 是一款「一个大脑多套外壳」的 AI 代理基础设施可移植的.agent/文件夹记忆 技能 协议可以插入 Claude Code、Cursor、Windsurf、OpenCode、Copilot CLI 等十多种编码代理外壳harness。装好之后真正的挑战才刚开始——运维如何确认接线完好doctor 审计、如何安全地刷新框架代码upgrade 安全升级、如何用 TUI 管理面板一站式查看项目健康状态。本指南面向新手带你用三条核心命令从容驾驭这套 AI 基础设施。为什么要给 AI 基础设施做运维和传统软件一样AI 代理系统也会腐化你手动改了CLAUDE.md却删掉了某个 hook 脚本——适配器表面还在实际已断线brew upgrade之后项目里的.agent/基础设施还是旧版本行为与新文档对不上同一个仓库里装了多个外壳谁还活着、谁已经失效全凭记忆。agentic-stack 为此内置了三件套doctor 只读审计、upgrade 安全升级、TUI 管理面板dashboard / manage / status 三种形态。一键体检doctor 只读审计在任意已安装项目根目录执行agentic-stack doctor它会读取.agent/install.json逐个核对每个已装适配器追踪的文件是否仍然存在、符号链接是否悬空、OpenClaw 注册是否有效并对每个适配器给出green / yellow / red三色结论。全部绿或黄时退出码为 0出现任何红色则为 1——非常适合放进 CI 或定时任务。实现见 harness_manager/doctor.py。绿黄红三色信号怎么读颜色含义典型原因✅ green接线完好追踪文件齐全、链接正常⚠️ yellow需要处理但未损坏待粘贴的 merge 片段、JSON 可读性问题、孤儿 hook 文件❌ red适配器已断线追踪文件被删、skills_link悬空或指向别处、.agent/AGENTS.md缺失一个贴心的细节doctor默认只读、绝不改动任何文件。它甚至能审计 Claude Code 的 hook 接线.claude/settings.json里引用的.agent/harness/hooks/*.py是否都存在、有没有被 settings 遗忘的孤儿 hook 文件。老项目v0.9 之前安装如何登记如果你从旧版本升级而来、项目里没有install.jsondoctor会通过文件系统信号如.cursor/rules/agentic-stack.mdc、.pi/extensions/memory-hook.ts探测出已装适配器并先询问你是否登记经你确认后才写入——这是官方的迁移路径./install.sh doctor # 探测并询问是否登记旧安装拒绝也不会写入任何内容。这样status/doctor/remove后续都能看见你的旧安装不会留下孤儿文件。安全升级upgrade 先预览再落地brew upgrade只更新了 agentic-stack 本体项目里的.agent/骨架代码需要单独刷新。官方推荐的节奏是先 dry-run再落地agentic-stack upgrade --dry-run # 只列出将会变更的文件不落盘 agentic-stack upgrade --yes # 确认后刷新哪些会被更新哪些绝不碰upgrade只刷新骨架所有的基础设施逻辑见 harness_manager/upgrade.pyharness/**下的 hook 脚本、顶层memory/*.py、tools/*.py技能索引_index.md以及新增的技能目录已存在的目录一律跳过新增的 loop 契约与loop-*种子技能。而以下内容永不被覆盖CLAUDE.md、.claude/settings.json、personal / semantic / episodic / working 各层记忆、候选教训、你已有的技能目录。换句话说升级只动公版骨架你的记忆与偏好原封不动。两个安全阀值得注意不带--yes的交互式运行会二次确认而在非 TTY 环境如 CI下没有确认参数时它直接报错拒绝执行防止意外写盘。若技能清单_manifest.jsonl与SKILL.md出现漂移还有修复命令agentic-stack sync-manifestTUI 管理面板一屏掌控健康、记忆与技能命令行的动词适合脚本人更适合面板。agentic-stack 提供三种 TUI 形态全部在 harness_manager/ 中实现dashboard项目健康总览agentic-stack dashboard打开交互式仪表盘harness_manager/dashboard_tui.py按分区浏览Overview / Adapters项目概况与各适配器的绿黄红状态Verify逐外壳核对 memory、skills、recall、reflect、permissions 五类引用是否就位Memory / Team Brain候选教训计数staged / graduated / rejected、团队记忆文件Skills / Instances / Loops技能清单、运行时实例、循环契约健康度。manage菜单式增删审计agentic-stack manage持久菜单循环harness_manager/manage_tui.py顶部 header 常驻显示项目路径、大脑统计与每个适配器的实时状态色块下方菜单支持——Add an adapter多选追加外壳自动拒绝覆盖 v0.9 前的未登记旧安装Remove an adapter多选移除每个适配器在删除前单独确认Run doctor (audit) / Show status在面板内直接体检Reconfigure preferences重跑 onboarding 向导更新PREFERENCES.md。误按 Ctrl-C 不会退出按两次才真正离开动作可被安全取消。status一张屏的极简视图agentic-stack status想要最少干扰harness_manager/status.py 打印的静态视图包含项目路径、大脑统计技能数、episodic 行数、教训数、版本与更新时间、已装适配器列表以及最近一次 loop 运行状态。适合贴进日报或快速自检。常用运维命令速查表场景命令说明只读体检agentic-stack doctor绿黄红审计退出码可接 CI一屏状态agentic-stack status适配器 大脑统计交互面板agentic-stack dashboard健康 / verify / 记忆 / 技能分区菜单管理agentic-stack manage增删壳、审计、重配偏好预览升级agentic-stack upgrade --dry-run只列出将变更的文件安全刷新agentic-stack upgrade --yes不碰记忆与个人配置修复技能索引agentic-stack sync-manifest重建_manifest.jsonl本地 Web 看板betaagentic-stack mission-control浏览器监控Ctrl-C 关闭写在最后agentic-stack 的设计哲学很明确让运维可预期——doctor 只读不改、upgrade 先预览后落地且永不触碰记忆、TUI 破坏性操作逐层确认。把doctor放进你的例行检查、upgrade --dry-run养成升级前习惯再配一个dashboard随时瞄一眼你的 AI 基础设施就从装完即黑盒变成了状态尽在掌握。更多命令细节可查阅 docs/getting-started.md 与 CHANGELOG.md。【免费下载链接】agentic-stackOne brain, many harnesses. Portable .agent/ folder (memory skills protocols) that plugs into Claude Code, Cursor, Windsurf, OpenCode, OpenClaw, Hermes, or DIY Python — and keeps its knowledge when you switch.项目地址: https://gitcode.com/gh_mirrors/ag/agentic-stack创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考