# Agim 文档导航

本页用于快速定位文档。  
建议先看根目录 `README.md` / `README.zh-CN.md`，再按角色进入对应模块。

**后端清单以 [`agents.md`](./agents.md) 为唯一权威来源**；架构文只解释立场，避免再维护第二份 inventory。  
历史计划 / 旧 CR / 分析快照一律在 [`archive/`](./archive/README.md)，**不再作为现行实施指南**。

## 入门

- [`../README.md`](../README.md) / [`../README.zh-CN.md`](../README.zh-CN.md)：项目概览与快速开始（首次运行 `agim` 打开 `/setup` 向导）
- [`first-run-setup.md`](./first-run-setup.md)：首次引导判定、`/setup` 向导、跳过与 onboarding API
- [`agents.md`](./agents.md)：支持的 Agent 后端、安装入口、模型切换与工具能力
- [`deployment.md`](./deployment.md)：部署与上线清单
- [`naming.md`](./naming.md)：命名术语表（Agim Agent / `agim` / A2A / tenants）
- [`migration-naming-v2.md`](./migration-naming-v2.md)：Naming v2 新老迁移指引
- [`llm-backends.md`](./llm-backends.md)：Agim Agent 大模型 API 配置与排障（含 SSRF / 私网 hatch；§6.1 任务派发速查）
- [`agim-agent-context-budget.md`](./agim-agent-context-budget.md)：上下文预算（L1/L2 / compact / 指标）

## 架构

- [`architecture/current.md`](./architecture/current.md)：**现行**组合根 / 域模块地图、数据流、文件预算与扩展配方（架构首页）
- [`architecture-bridge-and-agim-agent.md`](./architecture-bridge-and-agim-agent.md)：桥接 + Agim Agent 产品立场（旧名 `architecture-bridge-and-native.md` 仅作跳转）
- [`architecture/subagent.md`](./architecture/subagent.md)：**现行设计** — Subagent 概念、与 A2A/handoff 边界、同族 role/backend、拆解原则、**子代理代审免卡**
- [`architecture/cli-subagent-dispatch.md`](./architecture/cli-subagent-dispatch.md)：**现行设计** — sticky CLI 派 `call_agent(s)`；**Loop 仍仅 Agim**
- [`architecture/agent-profiles.md`](./architecture/agent-profiles.md)：**现行设计** — 非 Agim CLI 派工能力画像 + §2.4 任务派发速查（Settings→LLM 下拉；`llmRoles.finance`/`cheap`）
- [`architecture/focus.md`](./architecture/focus.md)：**现行设计** — Focus：聚焦注入 / on / off（废弃 `/goal`）
- [`architecture/loop-engineering.md`](./architecture/loop-engineering.md)：**现行设计** — Loop Engineering L3（对焦→派工→验收；父侧 `ask_user`；结案浮窗；门禁仅 depth=0；Portal 底栏 docks；Tasks Loop 审计）
- [`architecture/goal-residue.md`](./architecture/goal-residue.md)：Goal → Focus/Loop 残留盘点（UI/工具链已退役）
- [`architecture/retirement-candidates.md`](./architecture/retirement-candidates.md)：退役清单（已落地 Goal/Hot/ACP + 下一波候选）
- [`architecture/orchestration-roadmap.md`](./architecture/orchestration-roadmap.md)：**现行计划** — Subagent → 并行 → Loop（A/B/C：R1–R5+门禁与 B5 CLI 父派工已齐，R6 为 `/cron` `loop:` 最小刀；派工见 agent-profiles）
- [`architecture/agent-cwd-and-memory.md`](./architecture/agent-cwd-and-memory.md)：工作目录与记忆隔离（已实施）
- [`architecture/reminders.md`](./architecture/reminders.md)：提醒与主动通知链路
- [`endpoint-contracts.md`](./endpoint-contracts.md)：Web 路由清单与 SPA API 合同维护
- [`session-model.md`](./session-model.md)：会话模型与恢复（含 Web Chat、Agim Agent quarantine）

## 安全

- [`security-hardening.md`](./security-hardening.md)：安全基线与防护项（AUTO_APPROVE 默认关、URL 守卫、角色 ACL、非受信 IM 清单）
- 交叉：[`coding-standards.md`](./coding-standards.md) 中的安全默认表；[`deployment.md`](./deployment.md) §5 / §10

## 运维

- [`runbook.md`](./runbook.md)：高频运维操作
- [`bridge-server-deploy.md`](./bridge-server-deploy.md)：在 `https://dev.myfund.work` 上打开生产桥接（只轮询）
- [`bridge-caller-access.md`](./bridge-caller-access.md)：外部调用方只轮询接入生产桥接
- [`desktop-regression.md`](./desktop-regression.md)：合入后桌面全功能回归（mock LLM）
- [`release.md`](./release.md)：npm 发版（Auto Version Bump → `workflow_call` / 手动 `workflow_dispatch`）
- [`messenger-capability-matrix.md`](./messenger-capability-matrix.md)：各 IM 的 HITL / 附件 / 网关能力差异
- [`discord-setup.md`](./discord-setup.md)：Discord 接入（需 `AGIM_ENABLE_GLOBAL_IM=1`）
- [`im-workspaces-guide.md`](./im-workspaces-guide.md)：IM 工作区使用指南
- [`keyring-integration.md`](./keyring-integration.md)：keyring/dbus 集成（高级）
- [`viewer-modes.md`](./viewer-modes.md)：长内容 viewer 模式
- [`macos-shell.md`](./macos-shell.md)：macOS 桌面壳（WKWebView；主机 + `agim_session`）

## 能力专题

- [`skills.md`](./skills.md)：Skills 机制（内置 38 = Agim 12 + ECC 精选 26）
- [`portal-composer.md`](./portal-composer.md)：Portal（`/m/chat`）输入框 `/`·`@`、状态栏「替我审批」、chip、小精灵、Loop 底栏 docks、输入性能与附件预览
- [`goals.md`](./goals.md)：`/goal` 现行实现（**已废弃设计** → Focus）
- [`ask-user.md`](./ask-user.md)：结构化提问（ask_user）
- [`memory-and-vector.md`](./memory-and-vector.md)：长期记忆与向量召回

## 规范

- [`coding-standards.md`](./coding-standards.md)：编码 / 测试 / 文档 / 发版约定
- [`agent-integration-sop.md`](./agent-integration-sop.md)：新增 agent 接入 SOP
- [`tech-debt.md`](./tech-debt.md)：历史债 / 死开关 / 文档债盘点

## ADR

- [`adr/`](./adr/)：架构决策记录（0001–0005）

## 归档

历史背景、计划 stub、旧 CR、分析快照与 UI 原型：见 [`archive/README.md`](./archive/README.md)。

近期已关闭的 CR 清单（含 #219/#220 收口状态与残留 backlog）：  
[`archive/code-review-2026-07-21-main.md`](./archive/code-review-2026-07-21-main.md)。

2026-08-15 可用性 / 易用性 / 稳定性审查落地：  
[`archive/code-review-2026-08-15.md`](./archive/code-review-2026-08-15.md)。

## 版本变更

- [`../CHANGELOG.md`](../CHANGELOG.md)：唯一版本变更来源