本文件是 RaymanAgent 当前 tracked 仓库的功能账本，用于做整仓审查、增强优先级讨论和发布前回归对照。
- CLI 入口仍以
.Rayman/config/command_catalog.tsv为准。 - 用户面说明仍以
.Rayman/README.md与.Rayman/RELEASE_REQUIREMENTS.md为准。 - workflow / capability 面仍以
.github/workflows/*.yml、.github/agents/*.agent.md、.github/skills/*/SKILL.md、.github/prompts/*.prompt.md为准。
stable：默认行为、入口、测试和分发镜像基本一致。drifting：代码、README、workflow、copy/distribution 或契约面存在已知漂移风险。under-tested：功能存在，但高风险路径的 host / contract / release 覆盖不足。platform-opportunity：本地能力可用，但 2026 平台能力可显著增强体验或交付质量。
| Cluster | Public entrypoints | Default behavior | Runtime / host dependencies | Existing coverage | Status |
|---|---|---|---|---|---|
| Setup bootstrap | rayman init, init.sh, init.ps1, init.cmd, setup.ps1 |
初始化工作区、准备 Git、requirements、workflow、context、watch/bootstrap 默认值 | bash, powershell.exe, git, optional gh, optional WSL |
copy-self-check, host-smoke, release-gate, common.workspace.Tests |
stable |
| CLI surface | rayman, rayman.ps1, commands.txt, README commands block |
命令目录驱动 help、README 命令块和 CLI parity | bash, pwsh/powershell.exe |
command_catalog.Tests, verify_cli_parity.ps1, host-smoke |
stable |
| LAN worker / remote debug | rayman.ps1 worker, .vscode/launch.json, worker tasks |
发现共享局域网 Windows worker、绑定 active worker、通过 worker export-package / install-local / sync / debug / upgrade 完成远程执行与 .NET 调试；共享隔离固定为 multi-client staged-only，attached 会显式拒绝 |
Windows work machine, UDP broadcast, HTTP control plane, per-client runtime/session state, VS Code pipe transport | worker Pester coverage, release gate, setup merge | stable |
| Workspace hygiene | setup SCM ignore / tracked-noise block / dist parity | source workspace 默认只忽略本地生成物，external workspace 默认忽略整套 Rayman 资产 | git, .git/info/exclude, .gitignore |
contract_scm_tracked_noise.sh, assert_dist_sync.*, common.workspace.Tests |
stable |
| Cluster | Public entrypoints | Default behavior | Runtime / host dependencies | Existing coverage | Status |
|---|---|---|---|---|---|
| Shared watcher host | win-watch.ps1, watch-auto, watch-stop |
Windows 自动路径收敛到共享 watcher；默认 prompt sync + provider-target network resume 开启，支持 provider unreachable 30 分钟与 high-demand/rate-limit 5 分钟两类自动续接；候选同时覆盖 dispatch/review-loop 和 Codex Desktop 本地 session；attention scan 默认开启并默认监控 VS Code/Codex 窗口；dispatch 只走 codex exec resume --last，desktop 会话优先按 codex resume <session_id> |
Windows host, PowerShell, owner/shared PID bookkeeping, local ~/.codex/sessions |
watch_lifecycle.Tests, network_resume_watch.Tests, vscode_folder_open_bootstrap.Tests, host smoke partial |
stable |
| Quiet alerts | request_attention.ps1, shared win-watch.ps1 attention scan, rayman.ps1 sound-check |
log-first 默认；manual/error 写终端、diag、attention.last.json，默认完成提醒与人工等待提醒都会出声，toast/TTS 保持可选；sound-check 会真实播放 manual/done 两条链路并要求人工确认 |
Windows terminal, optional toast/TTS | common.workspace.Tests, watch_lifecycle.Tests, sound_check.Tests |
stable |
| VS Code / desktop bootstrap | Rayman: Folder Open Bootstrap, user-level rayman-codex-desktop-bootstrap |
VS Code folder-open 仍走 conservative 默认；workspace-register 额外安装用户级 desktop bootstrap，按 ~/.codex/sessions 自动发现已安装 workspace 并拉起 shared watch |
VS Code tasks/settings, Startup folder, owner PID, desktop session files | workspace_register.Tests, watch_lifecycle.Tests, vscode_folder_open_bootstrap.Tests |
under-tested |
| Cluster | Public entrypoints | Default behavior | Runtime / host dependencies | Existing coverage | Status |
|---|---|---|---|---|---|
| Capability registry | rayman.ps1 agent-capabilities, .codex/config.toml managed slices |
OpenAI Docs MCP、Playwright MCP、Rayman WinApp MCP 可选启用；multi-agent 可降级 | Codex runtime, MCP availability, local capability probes | check_agent_contract.ps1, capability report, JSON schemas |
stable |
| Agentic planner pipeline | dispatch, review-loop, .RaymanAgent/agentic/* |
默认 planner_v1 会先写 plan/tool-policy，再把它们收敛成实际 execution contract；review-loop 写 reflection，并以 doc gate + acceptance close 作为成功条件；legacy 仍可回滚 |
local shell, capability registry, delegated Codex optional features, requirements gate | agentic_pipeline.Tests, validate_requirements.sh, first_pass_report.ps1 |
under-tested |
| Context safety / skills trust | rayman.ps1 context-audit, rayman.ps1 skills, context-update, dispatch, review-loop |
context audit 默认在 dispatch/review-loop 里 block，在 context-update 里 warn；skills registry 默认只信任 bundled managed roots，并把审计结果写成 runtime artifacts；registry / audit 无效时 detect_skills fail-closed，不渲染 trusted manifests |
managed prompt assets, AGENTS.md, session handover files, skills registry config, event hooks |
context_audit.Tests, skills_registry.Tests, agentic_pipeline.Tests |
stable |
| Prompt suite evaluation | rayman.ps1 prompts -Action eval, .Rayman/config/prompt_eval_suites.json, .RaymanAgent/agentic/evals.md |
受管 prompt suite 会做 deterministic render/eval，输出 release-review 可见的 pass/fail/drift 报告，不把 hosted optimizer 变成硬依赖 | prompt templates, suite config, runtime artifacts, event hooks | prompt_eval.Tests, CLI parity, agent contract |
stable |
| Prompt / agent assets | .github/agents, .github/skills, .github/prompts, dispatch, review_loop |
capability 资产由 Rayman 管理，路由与 report 需一致；当前 workspace 还可通过 RAYMAN_INTERACTION_MODE 控制多路径/歧义时是先给 plan 还是先执行 |
repo docs + Codex/Copilot consumption | agent_asset_manifest.ps1, check_agent_contract.ps1 |
drifting |
| Model routing and policy | .Rayman/config/model_routing.json, .Rayman/config/codex_agents/*.toml |
review prompts 和 Codex roles 已有默认模型，但 hosted model selection 仍主要靠文档治理 | Hosted platform features, human operator choice | route config tests partial, no single human-readable policy before this change | platform-opportunity |
| Cluster | Public entrypoints | Default behavior | Runtime / host dependencies | Existing coverage | Status |
|---|---|---|---|---|---|
| Playwright readiness | rayman ensure-playwright, rayman.ps1 pwa-test, sandbox/bootstrap helpers |
优先准备 Playwright；WSL/host/sandbox 有 fallback 链路 | Node/npm, Playwright browsers, optional Windows Sandbox | playwright_ready.lib.Tests, host smoke, copy smoke partial |
stable |
| Browser debugging | Playwright MCP + rayman.ps1 pwa-test fallback |
MCP 优先，失败退回本地脚本 | Codex MCP, Playwright runtime | capability report + readiness report | platform-opportunity |
| Windows desktop automation | rayman.ps1 ensure-winapp, rayman.ps1 winapp-test, rayman.ps1 winapp-inspect, WinApp MCP |
保留 WinAppDriver-compatible 本地链路和 MCP 包装 | Windows desktop session, UIA, WinApp backend | winapp_core.Tests, host smoke, JSON schemas |
under-tested |
| Cluster | Public entrypoints | Default behavior | Runtime / host dependencies | Existing coverage | Status |
|---|---|---|---|---|---|
| Release gate | rayman.ps1 release-gate, rayman copy-self-check --strict, release checklist / spotcheck |
强制 requirements、regression guard、dist parity、签名校验、telemetry freshness | Git, signing public key, telemetry index | release_gate.lib.Tests, copy_smoke.ps1, contract lanes |
stable |
| CI lanes | fast-contract / logic-unit / host-smoke / release + nightly | hosted matrix + nightly self-hosted deep smoke | GitHub Actions, Pester, bats, jsonschema | workflows + local lane scripts | stable |
| Provenance / workflow hardening | workflow permissions, reusable workflows, artifact attestations | 当前已分 lane，但 provenance 与 workflow 去重仍主要靠人工治理 | GitHub Actions hosted features | release gate coverage partial, no attestation verify path yet | platform-opportunity |
| Cluster | Public entrypoints | Default behavior | Runtime / host dependencies | Existing coverage | Status |
|---|---|---|---|---|---|
| State / handover | rayman.ps1 state-save, rayman.ps1 state-list, rayman.ps1 state-resume, rayman.ps1 worktree-create, rayman transfer-export, rayman transfer-import |
命名会话承载 handover、精确 stash 恢复、会话级 auto-save；需要强隔离并行时可切到命名 worktree | Git stash, local filesystem, git worktree, runtime reports | CLI parity, state_sessions.Tests, smoke partial |
stable |
| Session recall / rollback UX | rayman.ps1 memory-search, rayman.ps1 rollback, state-save, state-resume |
memory-search 会跨 Agent Memory + saved sessions 做 unified recall；rollback 负责 list/diff/restore session-backed checkpoints，而 snapshot 保留 archive backup 语义 |
SQLite, optional FTS5, git stash/worktree, session artifacts | agent_memory.Tests, state_sessions.Tests, CLI parity |
stable |
| Codex account/session UX | rayman codex |
统一网页登录 / API Key / 设备码登录；alias 维度显示最近原生 session，并叠加当前 workspace 的 saved state 摘要 | Codex CLI native login, alias-scoped CODEX_HOME, local session manifests |
codex_accounts.Tests, state_sessions.Tests, CLI parity partial |
stable |
| Telemetry / event hooks | rules metrics, daily trend, baseline guard, artifact export/index, .Rayman/config/event_hooks.json |
release 继续消费 telemetry bundle；新增 event bus 默认写 .Rayman/runtime/events/*.jsonl，覆盖 context/skills/dispatch/review/memory/session/rollback/prompt-eval |
shell tooling, JSON schema validation, optional webhook sink | telemetry schemas + release gate + targeted Pester | stable |
| Review / enhancement docs | 本功能账本、2026 路线图、model policy | 作为治理面和增强优先级的 tracked 资产，不改变既有 CLI 默认行为 | repo docs only | check_agent_contract.ps1, governance docs tests |
drifting |
- 当前功能面已经覆盖 setup、watch、alerts、agent/capability、browser/winapp、release、telemetry、handover 等主要链路。
- 近期最容易继续漂移的面不是 CLI 本体，而是
.githubcapability 资产、hosted platform 说明、以及.Rayman/.dist与 review docs 的同步。 - 2026 增强优先级见
.Rayman/release/ENHANCEMENT_ROADMAP_2026.md；平台能力边界见.github/model-policy.md。