Merge pull request #1038 from flashcatcloud/docs/style-pass

docs: 按阮一峰中文规范与 Google 英文指南修订全站文风

Author: debidong

en/ai-sre.mdx

@@ -11,11 +11,11 @@ sidebarTitle: AI SRE
 
 ## What is AI SRE?
 
-Flashduty AI SRE is a conversational, autonomous SRE Agent platform. You issue instructions in natural language, and it plans the steps on its own, queries metrics and logs, runs commands, calls external tools (MCP), delegates subtasks when needed, and ends with a conclusion backed by its investigation.
+Flashduty AI SRE is a conversational, autonomous SRE Agent platform. You give instructions in natural language. It plans the steps, queries metrics and logs, runs commands, calls external tools (MCP), and delegates subtasks when needed. It ends with a conclusion backed by its investigation.
 
-It is not a question-and-answer chatbot but a **hands-on troubleshooter**, integrated deeply with Flashduty incident response: when an incident triggers or a war room opens, you can spin up a session in one click so the Agent enters the investigation with full incident context — chat in the console, or just **@-mention it in your IM group** (Slack / Feishu / DingTalk / WeCom).
+It's a **hands-on troubleshooter** built into Flashduty incident response. When an incident triggers or a war room opens, start a session in one click, and the Agent investigates with full incident context. Chat with it in the console, or **@-mention it in your IM group** (Slack / Feishu / DingTalk / WeCom).
 
-## Core Capabilities
+## Core capabilities
 
 <CardGroup cols={2}>
   <Card title="Chat to troubleshoot" icon="comments">
@@ -32,7 +32,7 @@ It is not a question-and-answer chatbot but a **hands-on troubleshooter**, integ
   </Card>
 </CardGroup>
 
-## Typical Scenarios
+## Typical scenarios
 
 <CardGroup cols={2}>
   <Card title="Conversational troubleshooting" icon="comments">
@@ -53,7 +53,7 @@ It is not a question-and-answer chatbot but a **hands-on troubleshooter**, integ
 
 AI SRE must be activated in the console and is billed on actual usage in credits. Production changes, restarts, rollbacks, and external notifications all require your confirmation before they execute. For activation, billing rules, and subscription requirements, see [Activation and billing](/en/ai-sre/overview#activation-and-billing).
 
-## Get Started
+## Get started
 
 <CardGroup cols={2}>
   <Card title="Product overview" icon="rocket" href="/en/ai-sre/overview">

en/ai-sre/agents.mdx

@@ -11,7 +11,7 @@ sidebarTitle: Artifacts
 
 An artifact is a file AI SRE produces in a session with the `present_files` tool and then publishes to the artifact gallery. There are two publish paths, and they accept different types:
 
-- **The agent's `publish_artifact` tool**: publishes HTML / Markdown documents only (`.html` `.htm` `.md` `.markdown`) — a self-contained report or page, most typically the operational insight report generated by typing `/insight` in a session. Every other type is rejected with `unsupported_format`.
+- **The agent's `publish_artifact` tool**: publishes HTML / Markdown documents only (`.html` `.htm` `.md` `.markdown`). Each one is a self-contained report or page. The most common example is the operational insight report that `/insight` generates in a session. Every other type is rejected with `unsupported_format`.
 - **The "Publish to artifact gallery" button next to a `present_files` file in the console** (see [Creating an artifact](#creating-an-artifact) below): publishes the wider set of types:
 
    <Accordion title="View publishable file types">
@@ -29,23 +29,23 @@ An artifact is a file AI SRE produces in a session with the `present_files` tool
 
 Files outside the table above don't show a "Publish to artifact gallery" button in the session.
 
-A published artifact initially inherits its source session's scope: artifacts from a personal session belong to their creator ("Personal"); artifacts from a session bound to a team belong to that team and can be shared with other account members. Users with edit permission can change the scope later.
+A published artifact initially inherits its source session's scope: artifacts from a personal session belong to their creator ("Personal"). Artifacts from a session bound to a team belong to that team and can be shared with other account members. Users with edit permission can change the scope later.
 
 Entry point: **AI SRE → Artifacts** in the left navigation.
 
 <Note>
-You can't upload files to the artifact gallery directly: every artifact is produced and published by the agent in a session, and **New artifact** also takes you to a session to do this. The gallery is for browsing, searching, and managing published artifacts.
+You can't upload files to the artifact gallery directly. The agent produces and publishes every artifact in a session, and **New artifact** also opens a session for this. The gallery is for browsing, searching, and managing published artifacts.
 </Note>
 
-## List Page
+## List page
 
 - **Search and filter**: search by title; filter by scope (**All / Personal / Team**). Choosing "Team" lets you pick specific teams; picking none means all teams visible to you.
-- **Views**: switch between card view (default) and list view at the top right; your choice is saved in the browser. List view shows the name, scope (team name, or the creator for personal artifacts), source conversation (click to jump; "Conversation deleted" if it no longer exists), created and updated times, a pin button, and actions.
+- **Views**: switch between card view (default) and list view at the top right; your choice is saved in the browser. List view shows the name, scope (team name, or the creator for personal artifacts), source conversation (click to jump. "Conversation deleted" if it no longer exists), created and updated times, a pin button, and actions.
 - **Sorting**: sort by created or updated time; the default is **updated time, newest first**. Whatever the sort, the artifacts you pinned always come first (most recently pinned first).
 - **Paging**: 12 / 24 / 48 per page, 24 by default.
-- **Shareable URL**: scope, search term, sorting, and page are kept in the page URL, so copying it shares or bookmarks the filtered list, and returning from a detail page lands you where you were.
+- **Shareable URL**: the page URL keeps the scope, search term, sorting, and page. Copy it to share or bookmark the filtered list. When you return from a detail page, you land where you were.
 
-Cards show a content thumbnail (a static preview for HTML, Markdown, images, and plain text; an empty frame for PDFs and other types), a type icon, the title, the edited time (hover for the exact time), the scope, and whether a public link is on and whether it is pinned.
+Each card shows a content thumbnail, a type icon, the title, the edited time, and the scope. It also shows whether a public link is on and whether the artifact is pinned. The thumbnail is a static preview for HTML, Markdown, images, and plain text, and an empty frame for PDFs and other types. Hover over the edited time to see the exact time.
 
 ### Pinning
 
@@ -61,7 +61,7 @@ Click **New artifact** at the top right to open a chat with a prefilled draft pr
 If a session has already produced the file, click "Publish to artifact gallery" next to it instead — it's faster than starting a new conversation.
 </Tip>
 
-## Card Actions
+## Card actions
 
 The "More actions" menu on each card offers:
 
@@ -74,7 +74,7 @@ The "More actions" menu on each card offers:
 | Change scope | Requires edit permission; choose Personal or an accessible team. Only the creator can change it back to Personal |
 | Delete | Requires edit permission and confirmation. Removes the artifact from the gallery only; the source session and the file itself are kept |
 
-## Detail Page
+## Detail page
 
 The top of the detail page offers:
 
@@ -161,7 +161,7 @@ Any one of the following lets you rename, change the scope of, or delete an arti
 
 Without edit permission you can only pin, copy the link, and download.
 
-## Related Pages
+## Related pages
 
 <CardGroup cols={2}>
   <Card title="Console Chat" icon="comments" href="/en/ai-sre/sessions">