Add files via upload

docs/README.md

@@ -1,68 +1,85 @@
 # CyberStrikeAI Documentation
 
-Documentation is split by language:
+[中文](#中文文档) | [English](#english-documentation)
 
-- [中文文档](zh-CN/)
-- [English docs](en-US/)
+CyberStrikeAI documentation is organized by user journey. Start with deployment, then move to the topic that matches your task.
 
 ## 中文文档
 
-- [部署指南](zh-CN/deployment.md)
-- [运维 Runbooks](zh-CN/runbooks.md)
-- [配置画像](zh-CN/configuration-profiles.md)
-- [安全加固指南](zh-CN/security-hardening.md)
-- [API Recipes](zh-CN/api-recipes.md)
-- [贡献规范](zh-CN/contributing-guide.md)
-- [配置参考](zh-CN/configuration.md)
-- [安全模型](zh-CN/security-model.md)
-- [RBAC 权限管理](zh-CN/rbac.md)
+### 按目标开始
+
+- **快速体验**：[部署指南](zh-CN/deployment.md) → [配置参考](zh-CN/configuration.md) → [排错指南](zh-CN/troubleshooting.md)
+- **生产部署**：[配置画像](zh-CN/configuration-profiles.md) → [安全加固](zh-CN/security-hardening.md) → [运维 Runbooks](zh-CN/runbooks.md) → [审计与监控](zh-CN/audit-and-monitoring.md)
+- **接入与自动化**：[API 参考](zh-CN/api-reference.md) → [API Recipes](zh-CN/api-recipes.md) → [MCP 联邦](zh-CN/mcp-federation.md)
+- **参与开发**：[开发者指南](zh-CN/developer-guide.md) → [测试指南](zh-CN/testing.md) → [贡献规范](zh-CN/contributing-guide.md)
+
+### 核心概念与编排
+
 - [架构说明](zh-CN/architecture.md)
-- [API 参考](zh-CN/api-reference.md)
-- [排错指南](zh-CN/troubleshooting.md)
-- [审计与监控](zh-CN/audit-and-monitoring.md)
-- [知识库](zh-CN/knowledge-base.md)
-- [C2 使用说明](zh-CN/c2.md)
-- [WebShell 管理](zh-CN/webshell.md)
-- [MCP 联邦](zh-CN/mcp-federation.md)
+- [安全模型](zh-CN/security-model.md)
 - [Agent 与角色](zh-CN/agent-and-role-guide.md)
 - [Skills 指南](zh-CN/skills-guide.md)
-- [插件开发](zh-CN/plugin-development.md)
-- [发布流程](zh-CN/release-process.md)
-- [测试指南](zh-CN/testing.md)
-- [图编排使用说明](zh-CN/workflow-graph.md)
+- [Eino 多代理](zh-CN/MULTI_AGENT_EINO.md)
+- [图编排](zh-CN/workflow-graph.md)
 - [人机协同最佳实践](zh-CN/hitl-best-practices.md)
-- [机器人使用说明](zh-CN/robot.md)
+
+### 功能指南
+
+- [知识库](zh-CN/knowledge-base.md)
+- [RBAC 权限管理](zh-CN/rbac.md)
+- [机器人接入](zh-CN/robot.md)
 - [视觉分析](zh-CN/VISION.md)
-- [前端国际化方案](zh-CN/frontend-i18n.md)
-- [Eino 多代理改造说明](zh-CN/MULTI_AGENT_EINO.md)
+- [WebShell 管理](zh-CN/webshell.md)
+- [C2 使用说明](zh-CN/c2.md)
 
-## English Docs
+### 开发与发布
+
+- [开发者指南](zh-CN/developer-guide.md)
+- [插件开发](zh-CN/plugin-development.md)
+- [前端国际化](zh-CN/frontend-i18n.md)
+- [测试指南](zh-CN/testing.md)
+- [贡献规范](zh-CN/contributing-guide.md)
+- [发布流程](zh-CN/release-process.md)
+
+## English Documentation
+
+### Choose a path
+
+- **Try locally**: [Deployment](en-US/deployment.md) → [Configuration](en-US/configuration.md) → [Troubleshooting](en-US/troubleshooting.md)
+- **Run in production**: [Configuration Profiles](en-US/configuration-profiles.md) → [Security Hardening](en-US/security-hardening.md) → [Runbooks](en-US/runbooks.md) → [Audit and Monitoring](en-US/audit-and-monitoring.md)
+- **Integrate and automate**: [API Reference](en-US/api-reference.md) → [API Recipes](en-US/api-recipes.md) → [MCP Federation](en-US/mcp-federation.md)
+- **Contribute code**: [Developer Guide](en-US/developer-guide.md) → [Testing](en-US/testing.md) → [Contributing](en-US/contributing-guide.md)
+
+### Concepts and orchestration
 
-- [Deployment Guide](en-US/deployment.md)
-- [Runbooks](en-US/runbooks.md)
-- [Configuration Profiles](en-US/configuration-profiles.md)
-- [Security Hardening](en-US/security-hardening.md)
-- [API Recipes](en-US/api-recipes.md)
-- [Contributing Guide](en-US/contributing-guide.md)
-- [Configuration Reference](en-US/configuration.md)
-- [Security Model](en-US/security-model.md)
-- [RBAC Administration](en-US/rbac.md)
 - [Architecture](en-US/architecture.md)
-- [API Reference](en-US/api-reference.md)
-- [Troubleshooting](en-US/troubleshooting.md)
-- [Audit and Monitoring](en-US/audit-and-monitoring.md)
-- [Knowledge Base](en-US/knowledge-base.md)
-- [C2 Guide](en-US/c2.md)
-- [WebShell Management](en-US/webshell.md)
-- [MCP Federation](en-US/mcp-federation.md)
-- [Agent and Role Guide](en-US/agent-and-role-guide.md)
-- [Skills Guide](en-US/skills-guide.md)
-- [Plugin Development](en-US/plugin-development.md)
-- [Release Process](en-US/release-process.md)
-- [Testing Guide](en-US/testing.md)
-- [Graph Orchestration Guide](en-US/workflow-graph.md)
+- [Security Model](en-US/security-model.md)
+- [Agents and Roles](en-US/agent-and-role-guide.md)
+- [Skills](en-US/skills-guide.md)
+- [Eino Multi-Agent](en-US/MULTI_AGENT_EINO.md)
+- [Graph Orchestration](en-US/workflow-graph.md)
 - [HITL Best Practices](en-US/hitl-best-practices.md)
-- [Robot / Chatbot Guide](en-US/robot.md)
+
+### Feature guides
+
+- [Knowledge Base](en-US/knowledge-base.md)
+- [RBAC Administration](en-US/rbac.md)
+- [Robot / Chatbot](en-US/robot.md)
 - [Vision Analysis](en-US/VISION.md)
+- [WebShell Management](en-US/webshell.md)
+- [C2 Guide](en-US/c2.md)
+
+### Development and release
+
+- [Developer Guide](en-US/developer-guide.md)
+- [Plugin Development](en-US/plugin-development.md)
 - [Frontend i18n](en-US/frontend-i18n.md)
-- [Eino Multi-Agent Notes](en-US/MULTI_AGENT_EINO.md)
+- [Testing](en-US/testing.md)
+- [Contributing](en-US/contributing-guide.md)
+- [Release Process](en-US/release-process.md)
+
+## Documentation conventions
+
+- Commands assume the repository root unless stated otherwise.
+- Examples use placeholders; never commit real credentials or target systems without explicit authorization.
+- Runtime behavior and configuration defaults are authoritative in `config.example.yaml` and the source code. If a document differs, report it as documentation drift.