From 87fd7285c17a09bc3ec38f2a02aa180d8c5d53e0 Mon Sep 17 00:00:00 2001
From: Cea <61349137+ceastld@users.noreply.github.com>
Date: Thu, 1 Oct 2026 07:18:12 -0700
Subject: [PATCH 1/2] =?UTF-8?q?feat(docs):=20=E4=BC=98=E5=8C=96=E9=A6=96?=
=?UTF-8?q?=E9=A1=B5=E5=85=A5=E5=8F=A3=E4=B8=8E=E7=9B=AE=E5=BD=95=E5=8D=A1?=
=?UTF-8?q?=E7=89=87=E9=98=85=E8=AF=BB=E4=BD=93=E9=AA=8C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/index.md | 94 +++---
docs/v2/_category_.json | 1 +
docs/v2/features/_category_.json | 6 +-
docs/v2/features/index.md | 48 +++
docs/v2/index.md | 76 ++---
docs/v2/xaction/index.md | 10 +-
docusaurus.config.ts | 9 +-
src/components/RelatedDocs/styles.module.css | 176 +++--------
.../XActionLanding/styles.module.css | 16 +-
src/css/custom.css | 291 +++++++-----------
src/theme/DocCard/index.tsx | 193 +++---------
11 files changed, 341 insertions(+), 579 deletions(-)
create mode 100644 docs/v2/features/index.md
diff --git a/docs/index.md b/docs/index.md
index 90de855..8fcc0cd 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -6,63 +6,55 @@ description: Quicker V2 使用说明：安装、面板、组合动作教程、
sidebar_position: 1
quickerDocKey: docs/home
comments: false
+hide_title: true
+hide_table_of_contents: true
---
+
+
# Quicker 文档
-:::caution[Preview · 仅专业版]
-当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](./important-notice.md)。
-:::
+
从第一次运行动作，到把重复操作变成自己的工具。
+
+Quicker 是 Windows 上的效率工具。你可以从面板运行动作，也可以用快捷键、鼠标手势等方式随时调用。
+
+
-Quicker 是 Windows 上的效率工具：把重复操作做成**动作**，用面板、快捷键或触发规则随时运行。
+**V2 目前为 Preview 体验版，仅面向专业版用户。** 免费版数据迁移仍在开发，免费账号目前无法登录 2.0。体验前请阅读 [使用限制与回退说明](./important-notice.md)，不建议替换无法中断的 1.x 关键环境。
-V2 把动作内容和它出现的位置分开，组合动作用模块拼步骤，参数、变量和调试都按当前程序定义来写。
+
## 从这里开始
-| 你想… | 去这篇 |
-| --- | --- |
-| 体验前先看限制 | [体验前必读](./important-notice.md) |
-| 第一次打开 Quicker | [开始使用](./v2/getting-started.md) |
-| 安装或确认系统要求 | [安装 Quicker V2](./v2/install/windows.md) |
-| 自己写一个动作 | [怎样学会组合动作](./v2/xaction/guides/how-to-learn.md) |
-| 从 1.x 升级 | [从 V1 迁移](./v2/migration/from-v1.md) |
-| 截图、标注、贴图 | [截图 Pro](./v2/features/screenshot/capture-pro.md) |
-| 面板、场景、分组 | [动作面板（新面板）](./v2/features/action-panel/index.md) |
-| 查某个步骤的参数 | [组合动作模块参考](./v2/xaction/modules) |
-| 现在能用哪些 AI | [AI 与 Agent 现状](./v2/features/ai-and-agent.md) |
-| 连接设计、建模或办公软件 | [软件连接与 Bridge](./v2/features/software-connections/index.md) |
-| 运行出问题 | [常见问题](./v2/troubleshooting.md) |
-
-## 组合动作三条动手课
-
-跟着做一遍，就能理解步骤、变量和分支：
-
-1. [弹出一条提示](./v2/xaction/guides/helloworld.md)
-2. [把选中文字变成大写](./v2/xaction/guides/selected-text.md)
-3. [选中文字就搜索](./v2/xaction/guides/search-selected.md)
-
-
+
+
+## 常用内容
+
+
+
+
+
+[浏览全部功能](/v2/features) · [安装与系统要求](./v2/install/windows.md) · [常见问题](./v2/troubleshooting.md) · [更新记录](/release-notes)
+
+
+
+## 跟着做一个组合动作
+
+
+ - 01弹出一条提示认识动作编辑器和步骤
+ - 02把选中文字变成大写用变量传递和处理文本
+ - 03选中文字就搜索加入条件，打开搜索网址
+
+
+
+
+# 功能使用
+
+
按你想做的事情，找到对应的使用说明。
+
+第一次使用，建议先看 [开始使用 Quicker V2](../getting-started.md)。
+
+## 运行动作与整理面板
+
+
+
+## 截图与日常工具
+
+
+
+## 账号、文件与软件连接
+
+
+
+
+
# Quicker V2
-:::caution[Preview · 仅专业版]
-当前 V2 是 **Preview 体验版**，仅面向专业版用户。免费版数据迁移仍在开发，免费账号目前无法登录 2.0。不建议用它替换无法中断的 1.x 关键环境。体验前请先读 [体验前必读](/important-notice)。
-:::
-
-V2 重做了数据存储、同步、动作模型和主面板。动作内容和它出现的位置分开，组合动作用模块拼步骤。
-
-| 你想… | 去这篇 |
-| --- | --- |
-| 第一次打开 | [开始使用](./getting-started.md) |
-| 下载安装 | [安装 Quicker V2](./install/windows.md) |
-| 从 1.x 过来 | [从 V1 迁移](./migration/from-v1.md) |
-| 相对 1.x 改了什么 | [V2 重要变化](./what's-new/index.md) |
-| 面板、触发、截图、账号 | [功能使用](/v2/features) |
-| 自己写组合动作 | [组合动作](/v2/xaction) |
-| 连接设计、建模或办公软件 | [软件连接与 Bridge](./features/software-connections/index.md) |
-| 运行出问题 | [常见问题](./troubleshooting.md) |
-
-安装包只从 [https://getquicker.net/V2](https://getquicker.net/V2) 下载。`https://getquicker.net/Download` 目前提供的是 1.x，不要从那里装 V2。
-
-
+
安装、使用和编写动作，都从这里开始。
+
+
+
+**V2 目前为 Preview 体验版，仅面向专业版用户。** 免费版数据迁移仍在开发，免费账号目前无法登录 2.0。体验前请阅读 [使用限制与回退说明](/important-notice)，不建议替换无法中断的 1.x 关键环境。
+
+
+
+## 安装与入门
+
+
+
+安装包请从 [Quicker V2 官网](https://getquicker.net/V2) 下载；官网 `/Download` 页面目前提供的是 1.x。
+
+## 继续探索
+
+
+
+
1 && "theme-doc-card__cover--mosaic",
- shown.length === 2 && "theme-doc-card__cover--two",
- )}
- >
- {shown.map((src) => (
-
- ))}
-
- {blurb ?
{blurb}
: null}
- {chips.length > 0 ? (
-
- {chips.map((hint) => (
- - {hint}
- ))}
-
- ) : null}
-
-
- {title.slice(0, 1)}
-
-
- );
+import React, {type ReactNode} from 'react';
+import clsx from 'clsx';
+import Link from '@docusaurus/Link';
+import {findFirstSidebarItemLink} from '@docusaurus/plugin-content-docs/client';
+import {useDocCardDescriptionCategoryItemsPlural} from '@docusaurus/theme-common/internal';
+import {ThemeClassNames} from '@docusaurus/theme-common';
+import type {Props} from '@theme/DocCard';
+import type {PropSidebarItemCategory, PropSidebarItemLink} from '@docusaurus/plugin-content-docs';
+import {lookupDocGallery, useDocGallery} from '@site/src/data/docGallery';
+
+function isUsefulDescription(text: string | undefined, title: string): boolean {
+ const value = (text ?? '').trim();
+ return Boolean(value && value !== title &&
+ !/的 Quicker 2\.0 使用说明\.?$/.test(value) &&
+ !(/模块参考/.test(value) && /参数表由/.test(value)));
}
-function GalleryCard({
- href,
- title,
- description,
- className,
-}: {
- href: string;
- title: string;
- description?: string;
- className?: string;
-}): ReactNode {
- const gallery = lookupDocGallery(useDocGallery(), href);
- const covers = gallery?.covers ?? [];
- const text = gallery?.description
- ? gallery.description
- : description && !isBoilerplateDescription(description, title)
- ? description
- : undefined;
+function DirectoryCard({item}: {item: PropSidebarItemLink | PropSidebarItemCategory}): ReactNode {
+ const gallery = useDocGallery();
+ const categoryItemsPlural = useDocCardDescriptionCategoryItemsPlural();
+ const href = item.type === 'link' ? item.href : item.href ?? findFirstSidebarItemLink(item);
+ if (!href) return null;
+ const description = lookupDocGallery(gallery, href)?.description ?? item.description;
return (
-
-
-
-
- {title}
+
+
+
+ {item.label}
- {text ? (
-
- {text}
-
- ) : null}
+
→
+ {description}
+
+ ) : null}
+ {item.type === 'category' ? (
+
{categoryItemsPlural(item.items.length)}
+ ) : null}
);
}
-function CardCategory({item}: {item: PropSidebarItemCategory}): ReactNode {
- const href = resolveHref(item);
- const categoryItemsPlural = useDocCardDescriptionCategoryItemsPlural();
- if (!href) return null;
- return (
-
- );
-}
-
-function CardLink({item}: {item: PropSidebarItemLink}): ReactNode {
- return (
-
- );
-}
-
+/** 目录只显示标题和说明，避免把正文、章节标签或截图拼成封面。 */
export default function DocCard({item}: Props): ReactNode {
- switch (item.type) {
- case "link":
- return
;
- case "category":
- return
;
- default:
- throw new Error(`unknown item type ${JSON.stringify(item)}`);
- }
+ if (item.type !== 'link' && item.type !== 'category') return null;
+ return
;
}
From f0365ba0d8880e5fa25f753874c068b46b454da5 Mon Sep 17 00:00:00 2001
From: Cea <61349137+ceastld@users.noreply.github.com>
Date: Thu, 1 Oct 2026 07:26:43 -0700
Subject: [PATCH 2/2] =?UTF-8?q?fix(docs):=20=E8=AF=86=E5=88=AB=E5=AF=BC?=
=?UTF-8?q?=E8=88=AA=E5=8D=A1=E7=89=87=E7=9A=84=E8=BD=AF=E4=BB=B6=E8=BF=9E?=
=?UTF-8?q?=E6=8E=A5=E5=85=A5=E5=8F=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
tools/bridge-docs/check.mjs | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/tools/bridge-docs/check.mjs b/tools/bridge-docs/check.mjs
index 82cd96c..ad71633 100644
--- a/tools/bridge-docs/check.mjs
+++ b/tools/bridge-docs/check.mjs
@@ -84,7 +84,10 @@ export function check() {
} else assert.equal(bridge.componentId, `quicker.bridge.${bridge.connectionId}`);
}
assert.ok(!catalog.modules.some((module) => module.key === 'sys:test'));
- for (const home of ['docs/index.md', 'docs/v2/index.md']) assert.ok(read(home).includes('software-connections/index.md'));
+ // 首页也可通过 RelatedDocs 卡片使用稳定的站内路由。
+ for (const home of ['docs/index.md', 'docs/v2/index.md']) {
+ assert.match(read(home), /software-connections\/index\.md|\/v2\/features\/software-connections\/?(?=['")])/, `${home} 缺少软件连接入口`);
+ }
for (const name of ['index', 'install-and-manage', 'command-tool', 'troubleshooting']) read(`docs/v2/features/software-connections/${name}.md`);
return bridges.length;
}