From 617b0eb56e51de987bb0e85c9e02ec72bb1abb4f Mon Sep 17 00:00:00 2001 From: GeekMr <140129782+WilliamWang1721@users.noreply.github.com> Date: Thu, 24 Sep 2026 23:52:53 +0800 Subject: [PATCH 01/13] docs: add polished static user guide and Pages build --- .github/workflows/docs-site.yml | 58 + .gitignore | 17 + .../docs/site/2026-09-24-static-user-guide.md | 55 + docs/site/README.md | 62 + docs/site/assets/site.css | 1654 +++++++++++++++++ docs/site/assets/site.js | 262 +++ docs/site/build.py | 207 +++ docs/site/check_browser.py | 90 + docs/site/content/index.md | 33 + docs/site/content/installation.md | 89 + docs/site/content/quickstart.md | 81 + docs/site/requirements.txt | 2 + docs/site/site.json | 12 + docs/site/template.html | 56 + docs/site/test_site.py | 96 + 15 files changed, 2774 insertions(+) create mode 100644 .github/workflows/docs-site.yml create mode 100644 architecture/notes/docs/site/2026-09-24-static-user-guide.md create mode 100644 docs/site/README.md create mode 100644 docs/site/assets/site.css create mode 100644 docs/site/assets/site.js create mode 100644 docs/site/build.py create mode 100644 docs/site/check_browser.py create mode 100644 docs/site/content/index.md create mode 100644 docs/site/content/installation.md create mode 100644 docs/site/content/quickstart.md create mode 100644 docs/site/requirements.txt create mode 100644 docs/site/site.json create mode 100644 docs/site/template.html create mode 100644 docs/site/test_site.py diff --git a/.github/workflows/docs-site.yml b/.github/workflows/docs-site.yml new file mode 100644 index 000000000..0cca9b9f2 --- /dev/null +++ b/.github/workflows/docs-site.yml @@ -0,0 +1,58 @@ +name: User documentation +on: + pull_request: + paths: ['docs/site/**', 'docs/screenshots/**', '.github/workflows/docs-site.yml'] + push: + branches: [main, 'docs/**'] + paths: ['docs/site/**', 'docs/screenshots/**', '.github/workflows/docs-site.yml'] + workflow_dispatch: +permissions: + contents: read +concurrency: + group: docs-${{ github.ref }} + cancel-in-progress: true +jobs: + build: + runs-on: ubuntu-24.04 + timeout-minutes: 10 + steps: + - uses: actions/checkout@v4 + with: + persist-credentials: false + - uses: actions/setup-python@v5 + with: + python-version: '3.13' + - name: Install documentation build tools + run: pip install -r docs/site/requirements.txt playwright==1.57.0 + - name: Check links, page structure and search coverage + run: python -m unittest discover -s docs/site -p test_site.py + - name: Build portable static site + env: + DOCS_BASE_URL: ${{ vars.PEBREL_DOCS_BASE_URL }} + run: python docs/site/build.py --base-url "$DOCS_BASE_URL" + - name: Install browser + run: python -m playwright install --with-deps chromium + - name: Check desktop, mobile, keyboard and reduced-motion behavior + run: python docs/site/check_browser.py + - uses: actions/upload-artifact@v4 + if: always() + with: + name: docs-browser-results + path: docs-browser-results/ + if-no-files-found: ignore + - uses: actions/upload-pages-artifact@v4 + with: + path: docs/site/dist + deploy: + if: github.ref == 'refs/heads/main' && github.event_name != 'pull_request' && vars.PEBREL_DOCS_PAGES_ENABLED == 'true' + needs: build + runs-on: ubuntu-24.04 + permissions: + pages: write + id-token: write + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + steps: + - uses: actions/deploy-pages@v4 + id: deployment diff --git a/.gitignore b/.gitignore index f5160ec19..d60654b24 100644 --- a/.gitignore +++ b/.gitignore @@ -213,3 +213,20 @@ NebulaTerminal-*/ # Local agent instructions and persistent workspace memory. /.agents/ + +# Published static user guide: exact reviewed source allowlist. +!/docs/site/ +!/docs/site/assets/ +!/docs/site/content/ +!/docs/site/README.md +!/docs/site/assets/site.css +!/docs/site/assets/site.js +!/docs/site/build.py +!/docs/site/check_browser.py +!/docs/site/content/index.md +!/docs/site/content/installation.md +!/docs/site/content/quickstart.md +!/docs/site/requirements.txt +!/docs/site/site.json +!/docs/site/template.html +!/docs/site/test_site.py diff --git a/architecture/notes/docs/site/2026-09-24-static-user-guide.md b/architecture/notes/docs/site/2026-09-24-static-user-guide.md new file mode 100644 index 000000000..e4d9de00c --- /dev/null +++ b/architecture/notes/docs/site/2026-09-24-static-user-guide.md @@ -0,0 +1,55 @@ +# Static user guide build boundary + +## Status + +Proposed with the documentation-site pull request. + +## Context + +The desktop application needs a navigable user manual that can be reviewed in a +fork, published through repository Pages, and read without a running service. +Desktop builds must not acquire a web-toolchain dependency. + +## Evidence + +- [Builder](../../../../docs/site/build.py) converts reviewed Markdown into HTML. +- [Workflow](../../../../.github/workflows/docs-site.yml) builds independently of Cargo. +- [Checks](../../../../docs/site/test_site.py) cover references and search coverage. +- [Operations](../../../../docs/site/README.md) describes Pages activation. + +## Decision + +Keep the site under `docs/site`, with build-only pinned Markdown and highlighting +libraries. Emit independent HTML pages, relative asset links and a local search +index. Use system fonts and repository-owned application imagery. Production +Pages deployment requires explicit repository opt-in and only runs from `main`. + +## Rejected alternatives + +A client-only application would make basic reading depend on JavaScript. A +hosted search service would add a credential and network dependency. A second +large frontend framework is unnecessary for Markdown, navigation and search. + +## Consequences + +Markdown and navigation remain separately reviewable. Rich HTML is trusted +repository content, not an input format for arbitrary visitors. The build has no +server-side user input and does not affect the desktop runtime. Captured app +images require a separate native environment; browser screenshots verify only +the guide's own interface. + +## Validation + +Local structural tests and the independent browser workflow exercise generated +links, search, copying, theme persistence, mobile navigation and no-script reading. +CI results, rather than the presence of workflow files, establish run status. + +## Supersedes + +None. + +## Revisit when + +Multiple maintained languages or versioned manuals make the current navigation +manifest insufficient, or the small local search index no longer meets users' +needs. Re-evaluate on measured behavior rather than adding services in advance. diff --git a/docs/site/README.md b/docs/site/README.md new file mode 100644 index 000000000..7862dcd9f --- /dev/null +++ b/docs/site/README.md @@ -0,0 +1,62 @@ +# Pebrel user documentation + +A Chinese user guide built from Markdown into standalone HTML, with local search, +keyboard navigation, light/dark themes, copy controls and image zoom. The build +uses existing repository screenshots; it does not redistribute font files or +change the desktop application's dependencies. + +## Build and check + +```sh +python -m pip install -r docs/site/requirements.txt +python docs/site/build.py +python -m unittest discover -s docs/site -p test_site.py +python -m http.server --directory docs/site/dist 8000 +``` + +For the browser smoke check, install `playwright==1.57.0`, run +`python -m playwright install chromium`, then `python docs/site/check_browser.py`. +The check serves the site under `/pebrel/`, exercising project-site path handling. +`CHROMIUM_PATH` optionally selects an existing Chromium executable. + +The generated `dist/` is disposable and ignored. Publish that directory's contents, +not this source directory. Open `index.html` directly for offline reading; browser +clipboard policies may require HTTP(S), in which case select and copy the text. +Search loads a local JavaScript index rather than requiring a backend or CDN. + +## GitHub Pages + +The `User documentation` workflow builds and checks documentation on matching +pull requests and documentation-branch pushes. A PR never deploys the production +site. It publishes a Pages artifact and browser screenshots for review. + +A repository administrator must first choose **Settings → Pages → Source → GitHub +Actions**. Set the repository variable `PEBREL_DOCS_PAGES_ENABLED` to `true` to opt +in to deployment from `main`. Optionally set `PEBREL_DOCS_BASE_URL` to the public +site root, including the repository prefix and trailing slash, such as +`https://kuddev.github.io/pebrel/`, for canonical links and a sitemap. For a custom +domain, supply that domain's root instead. The workflow does not change repository +settings, DNS or domain ownership. + +After the change is merged, the workflow deploys on a matching `main` push; it can +also be run manually from `main`. Fork builds do not deploy unless their owner +separately enables the same opt-in variable and Pages setting. + +## Maintain content + +`site.json` owns navigation, the documented version, the source commit and each +page's evidence paths. Pages live in `content/`. Use Markdown links such as +`[Installation](installation.md)`: the builder resolves them for nested HTML paths. +Use `@ROOT@` for local image paths in rich HTML. Raw HTML is allowed for trusted, +reviewed repository content only; this is not an untrusted Markdown service. + +The build copies images named in `site.json` from `docs/screenshots/` and the +application icon from `extra/logo/nebula.png`. Caption old repository captures as +such. Newly captured application images must state their platform and version; +do not label a mockup or a documentation-page screenshot as an application capture. + +After verifying a feature change, update the relevant page and its evidence. +Keep implementation rationale out of the user guide. Add each new public source +file to the exact `.gitignore` allowlist rather than opening the whole `docs/` +subtree. The build checks that evidence paths exist; existence alone is not proof +that every sentence has been audited. diff --git a/docs/site/assets/site.css b/docs/site/assets/site.css new file mode 100644 index 000000000..f52497940 --- /dev/null +++ b/docs/site/assets/site.css @@ -0,0 +1,1654 @@ +:root { + --bg:#fff; + --soft:#f7f8f6; + --panel:#fafbf9; + --text:#19201c; + --muted:#667069; + --line:#e6e9e5; + --accent:#197452; + --tint:#eaf4ec; + --code:#f5f7f4; + --shadow:0 24px 90px #17231c22; + --header:72px; + --sidebar:260px; + --radius:14px; + --font:-apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC","Microsoft YaHei",sans-serif; +} + +[data-theme=dark] { + --bg:#151816; + --soft:#1d211e; + --panel:#191d1a; + --text:#e6ebe6; + --muted:#a0aaa2; + --line:#303831; + --accent:#89d7a9; + --tint:#25392c; + --code:#1c231e; + --shadow:0 24px 90px #0008; + color-scheme:dark; +} + +* { + box-sizing:border-box; +} + +html { + scroll-behavior:smooth; + scroll-padding-top:100px; +} + +body { + margin:0; + background:var(--bg); + color:var(--text); + font-family:var(--font); + font-size:15px; + line-height:1.7; + -webkit-font-smoothing:antialiased; +} + +a { + color:inherit; + text-decoration:none; +} + +button,input { + font:inherit; +} + +button { + cursor:pointer; +} + +button,a,input,summary { + -webkit-tap-highlight-color:transparent; +} + +button { + color:inherit; +} + +button:disabled { + cursor:wait; + opacity:.65; +} + +a,button { + transition:background .18s,color .18s,border-color .18s,transform .18s; +} + +button:active { + transform:translateY(1px); +} + +:focus-visible { + outline:3px solid var(--accent); + outline-offset:4px; +} + +button svg,.search-heading svg { + width:19px; + height:19px; + fill:none; + stroke:currentColor; + stroke-width:1.6; + stroke-linecap:round; + stroke-linejoin:round; + flex:none; +} + +kbd { + font-family:var(--font); + font-size:11px; + border:1px solid var(--line); + border-radius:5px; + padding:1px 5px; + white-space:nowrap; + background:var(--bg); + box-shadow:0 1px 0 var(--line); +} + +.sr-only { + position:absolute; + width:1px; + height:1px; + overflow:hidden; + clip:rect(0,0,0,0); + white-space:nowrap; +} + +.skip { + position:fixed; + top:-60px; + left:20px; + z-index:100; + padding:10px 20px; + border-radius:8px; + background:var(--text); + color:var(--bg); +} + +.skip:focus { + top:10px; +} + +.reading-progress { + position:fixed; + left:0; + top:0; + height:2px; + background:var(--accent); + width:0; + z-index:51; +} + +.header { + height:var(--header); + position:fixed; + inset:0 0 auto; + z-index:40; + display:flex; + align-items:center; + gap:40px; + padding:0 30px; + border-bottom:1px solid var(--line); + background:color-mix(in srgb,var(--bg) 94%,transparent); + backdrop-filter:blur(14px); +} + +.brand { + display:flex; + align-items:center; + gap:10px; + flex:none; +} + +.brand>span:first-of-type { + font-size:22px; + font-weight:620; + letter-spacing:-.8px; +} + +.brand-divider { + height:20px; + width:1px; + background:var(--line); + margin:0 5px; +} + +.brand-docs { + color:var(--muted); + font-size:14px; +} + +.brand img { + border-radius:7px; +} + +.header-links { + display:flex; + align-items:center; + gap:26px; + font-size:13px; + height:100%; + color:var(--muted); +} + +.header-links a { + height:100%; + display:flex; + align-items:center; + gap:5px; + position:relative; +} + +.header-links a:hover,.header-links .selected { + color:var(--text); +} + +.header-links .selected:after { + content:""; + position:absolute; + height:2px; + background:var(--text); + left:0; + right:0; + bottom:0; +} + +.header-actions { + display:flex; + align-items:center; + gap:10px; + margin-left:auto; +} + +.search-trigger { + height:38px; + width:230px; + display:flex; + align-items:center; + gap:10px; + border:1px solid var(--line); + border-radius:9px; + background:var(--soft); + color:var(--muted); + padding:0 11px; + font-size:12px; + text-align:left; +} + +.search-trigger kbd { + margin-left:auto; +} + +.search-trigger:hover { + border-color:var(--muted); +} + +.icon-button { + border:0; + background:transparent; + display:grid; + place-items:center; + width:40px; + height:40px; + border-radius:9px; + color:var(--muted); +} + +.icon-button:hover { + background:var(--soft); + color:var(--text); +} + +.menu-toggle { + display:none; +} + +.sidebar { + position:fixed; + top:var(--header); + bottom:0; + left:0; + width:var(--sidebar); + padding:29px 18px 20px 25px; + border-right:1px solid var(--line); + overflow:auto; + background:var(--bg); + scrollbar-width:thin; + scrollbar-color:var(--line) transparent; + z-index:30; + display:flex; + flex-direction:column; +} + +.sidebar-home { + display:flex; + justify-content:space-between; + align-items:center; + padding:0 10px 21px; + font-size:13px; + font-weight:600; +} + +.version { + font:11px ui-monospace,SFMono-Regular,monospace; + border:1px solid var(--line); + border-radius:20px; + padding:3px 7px; + color:var(--muted); + font-weight:400; +} + +.nav-group { + margin:3px 0 23px; +} + +.nav-heading { + font-size:11px; + color:var(--muted); + font-weight:600; + padding:4px 11px 8px; + letter-spacing:.045em; +} + +.nav-link { + display:block; + padding:7px 12px; + border-radius:7px; + font-size:13px; + color:var(--muted); + margin:2px 0; + line-height:1.7; +} + +.nav-link:hover { + background:var(--soft); + color:var(--text); +} + +.nav-link.active { + background:var(--tint); + color:var(--accent); + font-weight:550; +} + +.sidebar-bottom { + border-top:1px solid var(--line); + margin:22px 10px 0; + padding-top:17px; + font-size:10px; + color:var(--muted); +} + +.sidebar-bottom>a { + display:block; + margin:8px 0; +} + +.status-dot { + display:inline-block; + width:5px; + height:5px; + background:var(--accent); + border-radius:50%; + margin-right:7px; +} + +.workspace { + margin-left:var(--sidebar); + padding:calc(var(--header) + 38px) 36px 0 52px; + display:grid; + grid-template-columns:minmax(0,800px) 168px; + gap:56px; + justify-content:center; +} + +main { + min-width:0; + outline:none; +} + +main:focus { + outline:none; +} + +.breadcrumb { + display:flex; + gap:12px; + font-size:11px; + color:var(--muted); + margin:0 0 26px; +} + +.breadcrumb a:hover { + color:var(--accent); +} + +.page-heading { + margin-bottom:34px; +} + +.eyebrow { + font-size:11px; + color:var(--accent); + font-weight:600; + letter-spacing:.08em; + margin-bottom:12px; + display:block; +} + +.page-heading h1 { + font-size:38px; + letter-spacing:-1.2px; + line-height:1.28; + margin:0 0 15px; + font-weight:570; +} + +.page-description { + font-size:16px; + color:var(--muted); + line-height:1.85; + max-width:650px; + margin:0; +} + +.page-tools { + display:flex; + gap:14px; + align-items:center; + margin-top:20px; + font-size:11px; + color:var(--muted); +} + +.small-button { + display:inline-flex; + gap:7px; + align-items:center; + background:var(--bg); + border:1px solid var(--line); + padding:5px 11px; + border-radius:7px; + min-height:32px; + font-size:11px; +} + +.small-button:hover { + background:var(--soft); + border-color:var(--muted); +} + +.toc { + position:sticky; + top:calc(var(--header) + 35px); + align-self:start; + font-size:11px; + max-height:calc(100vh - 140px); + overflow:auto; + padding-top:5px; + scrollbar-width:thin; +} + +.toc>span { + display:block; + font-weight:600; + margin:0 0 14px; +} + +.toc nav { + border-left:1px solid var(--line); +} + +.toc a { + display:block; + color:var(--muted); + padding:5px 0 5px 14px; + line-height:1.6; + margin-left:-1px; + border-left:1px solid transparent; +} + +.toc a.level-3 { + padding-left:24px; + font-size:10px; +} + +.toc a:hover { + color:var(--text); +} + +.toc a.active { + border-color:var(--accent); + color:var(--accent); +} + +.back-top { + background:none; + border:0; + color:var(--muted); + font-size:11px; + padding:18px 0; +} + +.back-top:hover { + color:var(--text); +} + +.hero { + position:relative; + background:var(--tint); + border:1px solid color-mix(in srgb,var(--accent) 13%,var(--line)); + border-radius:18px; + padding:38px 36px 34px; + overflow:hidden; + margin:0 0 31px; + isolation:isolate; +} + +.hero .eyebrow { + font-size:10px; + letter-spacing:.15em; +} + +.hero h1 { + font-size:40px; + font-weight:550; + line-height:1.36; + letter-spacing:-1.1px; + margin:15px 0 18px; + max-width:540px; +} + +.hero h1 span { + color:var(--accent); +} + +.hero p { + font-size:14px; + line-height:1.9; + max-width:455px; + color:var(--muted); + margin:0 0 27px; +} + +.hero-art { + position:absolute; + right:-55px; + top:35px; + width:230px; + height:260px; + opacity:.15; + z-index:-1; + transform:rotate(-13deg); + pointer-events:none; +} + +.hero-art i { + position:absolute; + width:210px; + height:142px; + border:1px solid var(--accent); + border-radius:24px; + right:0; + top:20px; +} + +.hero-art i:nth-child(2) { + transform:translate(-20px,38px); +} + +.hero-art i:nth-child(3) { + transform:translate(-40px,76px); +} + +.hero-art:after { + content:">_"; + font:80px ui-monospace,monospace; + position:absolute; + top:5px; + right:100px; + color:var(--accent); +} + +.hero-actions { + display:flex; + align-items:center; + gap:17px; +} + +.button-primary { + background:var(--text); + color:var(--bg)!important; + display:inline-flex; + align-items:center; + gap:28px; + font-size:12px; + font-weight:500; + padding:10px 17px; + border:1px solid var(--text); + border-radius:8px; + min-height:42px; + text-decoration:none!important; +} + +.button-primary:hover { + opacity:.85; + transform:translateY(-1px); +} + +.text-link { + font-size:12px; + color:var(--text)!important; + border:0!important; +} + +.text-link:hover { + text-decoration:underline; +} + +.platform-strip { + display:flex; + align-items:center; + gap:20px; + font-size:11px; + color:var(--muted); + margin:0 0 30px; +} + +.platform-strip>span:first-child { + color:var(--text); + font-weight:500; +} + +.platform-strip small { + font-size:9px; + border:1px solid var(--line); + border-radius:4px; + padding:1px 4px; + margin-left:4px; +} + +.feature-grid { + display:grid; + grid-template-columns:repeat(2,minmax(0,1fr)); + gap:13px; + margin:20px 0 32px; +} + +.feature-card { + border:1px solid var(--line); + border-radius:12px; + padding:23px!important; + display:block; + position:relative; + text-decoration:none!important; + background:var(--bg); + transition:transform .2s,border-color .2s,box-shadow .2s; +} + +.feature-card:hover { + border-color:color-mix(in srgb,var(--accent) 45%,var(--line)); + transform:translateY(-3px); + box-shadow:0 8px 24px #17231c08; +} + +.feature-card .card-symbol { + font:18px ui-monospace,monospace; + color:var(--accent); + display:grid; + place-items:center; + width:35px; + height:35px; + background:var(--soft); + border:1px solid var(--line); + border-radius:9px; + margin-bottom:16px; +} + +.feature-card h3 { + margin:0 0 6px!important; + font-size:15px!important; +} + +.feature-card p { + font-size:12px!important; + color:var(--muted); + line-height:1.75; + margin:0!important; + max-width:240px; +} + +.feature-card .card-arrow { + position:absolute; + right:21px; + top:25px; + color:var(--muted); + font-size:16px; +} + +.feature-card:hover .card-arrow { + color:var(--accent); + transform:translateX(2px); +} + +.prose { + font-size:14px; + line-height:1.95; +} + +.prose h2 { + font-size:24px; + font-weight:560; + letter-spacing:-.5px; + margin:44px 0 16px; + line-height:1.5; + padding-top:3px; + scroll-margin-top:95px; +} + +.prose h3 { + font-size:17px; + font-weight:570; + margin:28px 0 12px; + scroll-margin-top:95px; +} + +.prose h4 { + font-size:15px; + font-weight:600; + margin:22px 0 10px; +} + +.prose p { + margin:14px 0; +} + +.prose a:not(.feature-card):not(.button-primary):not(.text-link):not(.heading-anchor) { + color:var(--accent); + text-decoration:underline; + text-decoration-color:color-mix(in srgb,var(--accent) 40%,transparent); + text-underline-offset:4px; +} + +.prose a:hover { + text-decoration-color:currentColor; +} + +.prose strong { + font-weight:620; +} + +.prose ul,.prose ol { + padding-left:24px; + margin:15px 0; +} + +.prose li { + padding-left:4px; + margin:8px 0; +} + +.prose li::marker { + color:var(--muted); +} + +.prose ol>li::marker { + color:var(--accent); + font-weight:600; +} + +.prose hr { + border:0; + border-top:1px solid var(--line); + margin:36px 0; +} + +.prose :not(pre)>code { + font:12px/1.7 ui-monospace,SFMono-Regular,Consolas,monospace; + color:var(--text); + background:var(--code); + padding:3px 6px; + border:1px solid var(--line); + border-radius:5px; + overflow-wrap:anywhere; +} + +.prose pre { + margin:0; + padding:21px 22px; + overflow:auto; + line-height:1.75; + font-size:12px; + tab-size:2; + scrollbar-width:thin; +} + +.prose pre code { + font-family:ui-monospace,SFMono-Regular,Consolas,monospace; +} + +.code-block { + border:1px solid var(--line); + border-radius:12px; + background:var(--code); + margin:19px 0; + overflow:hidden; +} + +.code-toolbar { + height:37px; + border-bottom:1px solid var(--line); + display:flex; + align-items:center; + justify-content:space-between; + padding:0 10px 0 18px; + font:10px var(--font); + color:var(--muted); + letter-spacing:.02em; +} + +.copy-code { + background:transparent; + border:0; + border-radius:5px; + font-size:10px; + color:var(--muted); + padding:5px 8px; + min-width:66px; + min-height:28px; +} + +.copy-code:hover { + color:var(--text); + background:var(--bg); +} + +.copy-code[data-copied=true] { + color:var(--accent); +} + +.table-wrap { + overflow:auto; + margin:20px 0; + border:1px solid var(--line); + border-radius:10px; + scrollbar-width:thin; +} + +.prose table { + border-collapse:collapse; + width:100%; + font-size:12px; + line-height:1.75; + text-align:left; +} + +.prose th { + font-weight:550; + background:var(--soft); + white-space:nowrap; +} + +.prose th,.prose td { + padding:12px 15px; + border-bottom:1px solid var(--line); + vertical-align:top; +} + +.prose tr:last-child td { + border-bottom:0; +} + +.prose td code { + font-size:11px!important; +} + +.prose td:first-child { + min-width:110px; +} + +.callout,.prose blockquote { + padding:16px 19px; + margin:23px 0; + border:1px solid var(--line); + border-left:3px solid var(--accent); + background:var(--soft); + border-radius:0 9px 9px 0; + font-size:12px; +} + +.callout p,.prose blockquote p { + margin:3px 0; +} + +.callout-title { + display:block; + font-weight:600; + margin:0 0 5px; + color:var(--accent); +} + +.callout.warning { + border-left-color:#ae812f; +} + +.callout.warning .callout-title { + color:#987126; +} + +[data-theme=dark] .callout.warning .callout-title { + color:#e1ba76; +} + +.prose details { + margin:18px 0; + border:1px solid var(--line); + border-radius:10px; + padding:15px 18px; +} + +.prose summary { + cursor:pointer; + font-size:13px; + font-weight:550; +} + +.prose details[open] summary { + margin-bottom:12px; +} + +.heading-anchor { + display:inline-block; + margin-left:9px; + font-size:.68em; + color:var(--muted); + opacity:0; + vertical-align:middle; +} + +.prose h2:hover .heading-anchor,.prose h3:hover .heading-anchor,.heading-anchor:focus-visible { + opacity:1; +} + +.prose figure { + margin:27px 0; +} + +.prose figure img { + display:block; + width:100%; + height:auto; + border-radius:12px; + border:1px solid var(--line); + background:var(--soft); +} + +.prose figure button { + display:block; + width:100%; + padding:0; + border:0; + border-radius:12px; + background:none; + cursor:zoom-in; +} + +.prose figcaption { + font-size:10px; + color:var(--muted); + text-align:center; + line-height:1.7; + margin:10px 0; +} + +.prose .narrow-figure { + max-width:310px; + margin-left:auto; + margin-right:auto; +} + +.platform-tabs { + border:1px solid var(--line); + padding:18px 22px; + border-radius:12px; + margin:22px 0; +} + +.platform-tablist { + display:none; + gap:6px; + border-bottom:1px solid var(--line); + margin:-2px 0 18px; + padding-bottom:12px; +} + +.platform-tablist button { + background:none; + border:0; + border-radius:7px; + padding:7px 13px; + font-size:12px; +} + +.platform-tablist button[aria-selected=true] { + background:var(--tint); + color:var(--accent); +} + +.platform-tablist button:hover { + background:var(--soft); +} + +.js .platform-tablist { + display:flex; +} + +.platform-panel>:first-child { + margin-top:8px; +} + +.source-details { + margin:40px 0 30px; + font-size:11px; + color:var(--muted); + border-top:1px solid var(--line); + padding-top:19px; +} + +.source-details summary { + cursor:pointer; +} + +.source-details ul { + padding-left:18px; +} + +.source-details a { + text-decoration:underline; + text-underline-offset:3px; + overflow-wrap:anywhere; +} + +.page-pagination { + display:grid; + grid-template-columns:1fr 1fr; + gap:15px; + margin:25px 0 35px; +} + +.page-pagination a { + border:1px solid var(--line); + border-radius:10px; + padding:16px 18px; + display:flex; + flex-direction:column; + font-size:13px; +} + +.page-pagination a:last-child { + text-align:right; +} + +.page-pagination a:hover { + background:var(--soft); + border-color:var(--muted); +} + +.page-pagination small { + color:var(--muted); + font-size:10px; + margin-bottom:5px; +} + +.article-footer { + display:flex; + gap:20px; + border-top:1px solid var(--line); + padding:20px 0 34px; + font-size:10px; + color:var(--muted); +} + +.article-footer>span { + margin-right:auto; +} + +.article-footer a:hover { + color:var(--accent); +} + +dialog { + color:var(--text); + border:1px solid var(--line); + background:var(--bg); + box-shadow:var(--shadow); + padding:0; +} + +dialog::backdrop { + background:#10221855; + backdrop-filter:blur(5px); +} + +.search-dialog { + width:min(680px,calc(100vw - 32px)); + border-radius:16px; + margin:15vh auto auto; + max-height:74vh; + overflow:hidden; +} + +.search-dialog[open] { + display:flex; + flex-direction:column; + animation:dialog-in .2s ease-out; +} + +.search-heading { + display:flex; + align-items:center; + gap:13px; + padding:18px 20px; + border-bottom:1px solid var(--line); +} + +.search-heading svg { + color:var(--muted); +} + +.search-heading input { + flex:1; + min-width:0; + border:0; + outline:none; + background:transparent; + color:var(--text); + font-size:15px; +} + +.search-heading input:focus-visible { + outline:0; +} + +.search-heading:focus-within { + box-shadow:inset 0 -2px var(--accent); +} + +.search-status { + font-size:11px; + color:var(--muted); + padding:0 20px; + margin:12px 0 8px; +} + +.search-results { + padding:0 9px 10px; + overflow:auto; + min-height:120px; + max-height:49vh; +} + +.search-result { + display:block; + width:100%; + text-align:left; + border:1px solid transparent; + background:transparent; + color:var(--text); + padding:12px 14px; + border-radius:9px; + margin:2px 0; +} + +.search-result[aria-selected=true],.search-result:hover { + background:var(--soft); + border-color:var(--line); +} + +.search-result strong { + display:block; + font-size:13px; + font-weight:550; +} + +.search-result small { + display:block; + font-size:11px; + color:var(--muted); + line-height:1.7; + margin-top:3px; + overflow:hidden; + text-overflow:ellipsis; +} + +.search-result mark { + background:var(--tint); + color:var(--accent); + border-radius:2px; +} + +.search-footer { + display:flex; + justify-content:space-between; + font-size:10px; + color:var(--muted); + border-top:1px solid var(--line); + padding:12px 20px; +} + +.search-footer kbd { + font-size:9px; + margin-right:4px; +} + +.image-dialog { + width:calc(100vw - 80px); + max-width:1500px; + max-height:92vh; + border-radius:14px; + padding:18px; + overflow:auto; + text-align:right; +} + +.image-dialog img { + display:block; + width:100%; + height:auto; + margin:14px auto 0; +} + +.image-dialog p { + font-size:12px; + text-align:center; + color:var(--muted); +} + +.toast { + position:fixed; + left:50%; + bottom:28px; + transform:translate(-50%,12px); + background:var(--text); + color:var(--bg); + border:1px solid var(--line); + box-shadow:var(--shadow); + padding:10px 19px; + border-radius:10px; + font-size:12px; + opacity:0; + pointer-events:none; + transition:.2s; + z-index:100; + max-width:90vw; +} + +.toast.show { + opacity:1; + transform:translate(-50%,0); +} + +.noscript { + position:fixed; + bottom:0; + left:0; + right:0; + background:var(--soft); + padding:10px; + font-size:12px; + text-align:center; + z-index:50; +} + +@keyframes dialog-in { + from { + opacity:0; + transform:translateY(-10px) scale(.985); + } + to { + opacity:1; + transform:none; + } +} + +@keyframes reveal { + from { + opacity:0; + transform:translateY(12px); + } + to { + opacity:1; + transform:none; + } +} + +.revealed { + animation:reveal .5s ease-out both; +} + +.feature-card:nth-child(2) { + animation-delay:60ms; +} + +.feature-card:nth-child(3) { + animation-delay:100ms; +} + +.feature-card:nth-child(4) { + animation-delay:140ms; +} + +@view-transition { + navigation:auto; +} + +@media(min-width:1700px) { + .workspace { + padding-left:74px; + gap:72px; + grid-template-columns:minmax(0,840px) 190px; + } +} + +@media(max-width:1280px) { + :root { + --sidebar:232px; + } + .header { + padding:0 23px; + gap:30px; + } + .workspace { + padding-left:38px; + padding-right:30px; + gap:30px; + grid-template-columns:minmax(0,800px) 140px; + } + .sidebar { + padding-left:17px; + } + .search-trigger { + width:195px; + } + .hero h1 { + font-size:35px; + } +} + +@media(max-width:1080px) { + .toc { + display:none; + } + .workspace { + grid-template-columns:minmax(0,800px); + padding-left:38px; + padding-right:38px; + } + .header-links { + gap:20px; + } + .hero-art { + right:-95px; + } + .hero h1 { + font-size:37px; + } + .header { + gap:25px; + } + .brand-docs { + display:none; + } + .brand-divider { + display:none; + } +} + +@media(max-width:800px) { + :root { + --header:62px; + --sidebar:272px; + } + .header { + padding:0 17px; + gap:15px; + } + .brand>span:first-of-type { + font-size:20px; + } + .brand img { + width:28px; + height:28px; + } + .header-links { + display:none; + } + .header-actions { + gap:2px; + } + .search-trigger { + width:40px; + padding:0; + display:grid; + place-items:center; + border:0; + background:transparent; + } + .search-trigger span,.search-trigger kbd { + display:none; + } + .menu-toggle { + display:grid; + } + .sidebar { + transform:translateX(-100%); + transition:transform .24s ease; + width:var(--sidebar); + z-index:45; + padding:24px 19px 20px; + visibility:hidden; + } + .sidebar.open { + transform:translateX(0); + visibility:visible; + } + .drawer-backdrop { + position:fixed; + inset:var(--header) 0 0; + background:#10221855; + backdrop-filter:blur(2px); + z-index:44; + } + .workspace { + margin-left:0; + padding:calc(var(--header) + 28px) 24px 0; + display:block; + } + .page-heading h1 { + font-size:31px; + } + .hero { + padding:29px 26px; + border-radius:14px; + } + .hero h1 { + font-size:34px; + } + .hero p { + font-size:13px; + max-width:370px; + } + .hero-art { + right:-110px; + opacity:.12; + } + .breadcrumb { + margin-bottom:22px; + } + .page-description { + font-size:14px; + } + .nav-link { + padding:10px 12px; + min-height:42px; + } + .article-footer { + gap:13px; + flex-wrap:wrap; + } + .article-footer>span { + width:100%; + } + .search-dialog { + margin-top:10vh; + } + .icon-button { + width:42px; + height:42px; + } + .small-button { + min-height:38px; + } + .copy-code { + min-height:32px; + } + .platform-tablist button { + min-height:40px; + } +} + +@media(max-width:480px) { + .workspace { + padding-left:19px; + padding-right:19px; + } + .hero { + padding:26px 23px; + } + .hero h1 { + font-size:29px; + letter-spacing:-.7px; + } + .hero p { + font-size:12px; + } + .hero-actions { + gap:15px; + } + .hero-art { + display:none; + } + .platform-strip { + gap:11px; + font-size:10px; + flex-wrap:wrap; + } + .feature-grid { + gap:11px; + } + .feature-card { + padding:17px!important; + } + .feature-card .card-arrow { + right:14px; + top:21px; + } + .feature-card h3 { + font-size:14px!important; + } + .feature-card p { + font-size:11px!important; + } + .prose { + font-size:13px; + } + .prose h2 { + font-size:21px; + } + .prose pre { + font-size:11px; + padding:17px; + } + .page-tools { + flex-wrap:wrap; + } + .page-pagination { + gap:9px; + } + .page-pagination a { + padding:13px; + font-size:12px; + } + .search-heading { + padding:13px; + } + .search-footer { + padding:11px 13px; + } + .search-footer>span:last-child { + display:none; + } + .image-dialog { + width:calc(100vw - 20px); + padding:10px; + } + .prose th,.prose td { + padding:10px; + } + .platform-tabs { + padding:16px; + } + .page-heading h1 { + font-size:29px; + } +} + +@media(prefers-reduced-motion:reduce) { + html { + scroll-behavior:auto; + } + *,*:before,*:after { + animation:none!important; + transition:none!important; + view-transition-name:none!important; + } + ::view-transition-group(*),::view-transition-old(*),::view-transition-new(*) { + animation:none!important; + } + .feature-card:hover { + transform:none; + } +} + +@media print { + .header,.sidebar,.toc,.page-tools,.page-pagination,.article-footer,.reading-progress,.heading-anchor,dialog,.toast,.back-top,.copy-code,.hero-art { + display:none!important; + } + .workspace { + margin:0; + padding:0; + display:block; + } + body { + font-size:11pt; + background:#fff; + color:#000; + } + .prose { + font-size:10pt; + } + .prose h2,.prose h3 { + break-after:avoid; + } + .code-block,.callout,.prose figure { + break-inside:avoid; + } + .prose pre { + white-space:pre-wrap; + } + .prose a { + color:inherit; + } + .hero { + background:#f5f5f5; + } + .source-details { + display:none; + } + .platform-panel[hidden] { + display:block!important; + } + .platform-tablist { + display:none!important; + } + main { + max-width:100%; + } + .feature-grid { + display:block; + } + .feature-card { + margin-bottom:10px; + } +} + +@media(max-width:800px) { + html:not(.js) .sidebar { + position:relative; + top:auto; + bottom:auto; + transform:none; + visibility:visible; + width:100%; + margin-top:var(--header); + max-height:300px; + border-bottom:1px solid var(--line); + } + html:not(.js) .workspace { + padding-top:28px; + } +} diff --git a/docs/site/assets/site.js b/docs/site/assets/site.js new file mode 100644 index 000000000..40e38ebc6 --- /dev/null +++ b/docs/site/assets/site.js @@ -0,0 +1,262 @@ +(() => { + 'use strict'; + document.documentElement.classList.add('js'); + const root = document.body.dataset.root; + const $ = (selector) => document.querySelector(selector); + const $$ = (selector) => [...document.querySelectorAll(selector)]; + const reducedMotion = matchMedia('(prefers-reduced-motion: reduce)'); + const toast = $('.toast'); + let toastTimer; + function announce(message) { + clearTimeout(toastTimer); + toast.textContent = message; + toast.classList.add('show'); + toastTimer = setTimeout(() => toast.classList.remove('show'), 2600); + } + + const copyTimers = new WeakMap(); + async function copy(text, button) { + try { + await navigator.clipboard.writeText(text); + clearTimeout(copyTimers.get(button)); + const label = button.dataset.label || button.textContent; + button.dataset.label = label; + button.dataset.copied = 'true'; + button.textContent = '✓ 已复制'; + announce('已复制到剪贴板'); + copyTimers.set(button, setTimeout(() => { + button.textContent = label; + delete button.dataset.copied; + }, 1700)); + } catch { + announce('复制未成功,请选中文本手动复制。'); + } + } + $$('.copy-code').forEach(button => button.addEventListener('click', () => { + copy(button.closest('.code-block').querySelector('code').textContent, button); + })); + const copyPage = $('#copy-page'); + copyPage?.addEventListener('click', () => copy( + JSON.parse($('#page-source').textContent), copyPage + )); + $$('.heading-anchor').forEach(link => link.addEventListener('click', async () => { + try { + await navigator.clipboard.writeText(link.href); + announce('已复制本节链接'); + } catch { + announce('已定位本节;可从地址栏复制链接。'); + } + })); + + const themeToggle = $('#theme-toggle'); + function updateThemeLabel() { + const dark = document.documentElement.dataset.theme === 'dark'; + themeToggle.setAttribute('aria-label', dark ? '切换到浅色主题' : '切换到深色主题'); + themeToggle.title = themeToggle.getAttribute('aria-label'); + themeToggle.setAttribute('aria-pressed', String(dark)); + } + updateThemeLabel(); + themeToggle.addEventListener('click', () => { + const theme = document.documentElement.dataset.theme === 'dark' ? 'light' : 'dark'; + document.documentElement.dataset.theme = theme; + try { localStorage.setItem('pebrel-docs-theme', theme); } catch { /* Session only. */ } + updateThemeLabel(); + }); + + const sidebar = $('#sidebar'); + const menu = $('#menu-toggle'); + const backdrop = $('.drawer-backdrop'); + const mobile = matchMedia('(max-width: 800px)'); + function setMenu(open) { + sidebar.classList.toggle('open', open); + backdrop.hidden = !open; + menu.setAttribute('aria-expanded', String(open)); + menu.setAttribute('aria-label', open ? '关闭文档导航' : '打开文档导航'); + document.body.style.overflow = open ? 'hidden' : ''; + sidebar.inert = mobile.matches && !open; + $('.workspace').inert = open; + if (open) sidebar.querySelector('.active, a').focus(); + } + setMenu(false); + menu.addEventListener('click', () => setMenu(!sidebar.classList.contains('open'))); + backdrop.addEventListener('click', () => { setMenu(false); menu.focus(); }); + mobile.addEventListener('change', () => setMenu(false)); + sidebar.querySelector('.active')?.scrollIntoView({ block: 'nearest' }); + + const searchDialog = $('#search-dialog'); + const input = $('#search-input'); + const results = $('#search-results'); + const status = $('.search-status'); + let indexPromise; + let index = []; + let matches = []; + let selected = 0; + let searchOpener; + function loadIndex() { + if (!indexPromise) indexPromise = new Promise((resolve, reject) => { + const script = document.createElement('script'); + script.src = root + 'search-index.js'; + script.onload = () => resolve(window.PEBREL_DOCS_SEARCH); + script.onerror = () => { script.remove(); indexPromise = null; reject(new Error('Search unavailable')); }; + document.head.append(script); + }); + return indexPromise; + } + function highlight(target, text, query) { + if (!query) { target.textContent = text; return; } + const position = text.toLocaleLowerCase().indexOf(query.toLocaleLowerCase()); + if (position < 0) { target.textContent = text; return; } + target.append(document.createTextNode(text.slice(0, position))); + const mark = document.createElement('mark'); + mark.textContent = text.slice(position, position + query.length); + target.append(mark, document.createTextNode(text.slice(position + query.length))); + } + function selectResult(value) { + selected = Math.max(0, Math.min(value, matches.length - 1)); + [...results.children].forEach((element, position) => { + element.setAttribute('aria-selected', String(position === selected)); + }); + const active = results.children[selected]; + if (active) { + input.setAttribute('aria-activedescendant', active.id); + active.scrollIntoView({ block: 'nearest' }); + } else input.removeAttribute('aria-activedescendant'); + } + function renderResults() { + const query = input.value.trim(); + const terms = query.toLocaleLowerCase().split(/\s+/).filter(Boolean); + matches = index.map(item => { + const title = item.title.toLocaleLowerCase(); + const text = (item.title + ' ' + item.text).toLocaleLowerCase(); + const score = terms.every(term => text.includes(term)) + ? terms.reduce((n, term) => n + (title.includes(term) ? 15 : 1), 0) + (title === query.toLocaleLowerCase() ? 50 : 0) + : -1; + return { ...item, score }; + }).filter(item => item.score >= 0).sort((a, b) => b.score - a.score).slice(0, 18); + results.replaceChildren(); + status.textContent = query ? (matches.length ? `找到 ${matches.length}${matches.length === 18 ? '+' : ''} 个相关章节` : '没有找到相关内容。试试“分屏”“SSH”或“字体”。') : '从常用指南开始,或输入功能、设置与操作步骤。'; + matches.forEach((item, position) => { + const row = document.createElement('div'); + row.className = 'search-result'; + row.id = 'search-result-' + position; + row.setAttribute('role', 'option'); + const title = document.createElement('strong'); + highlight(title, item.title, query); + const description = document.createElement('small'); + const matchPosition = query ? item.text.toLocaleLowerCase().indexOf(terms[0]) : 0; + const start = Math.max(0, matchPosition - 28); + highlight(description, (start ? '…' : '') + item.text.slice(start, start + 130), query); + row.append(title, description); + row.addEventListener('click', () => { location.href = root + item.url; }); + row.addEventListener('pointermove', () => selectResult(position)); + results.append(row); + }); + selectResult(0); + } + async function openSearch() { + if (sidebar.classList.contains('open')) setMenu(false); + searchOpener = document.activeElement; + if (!searchDialog.open) searchDialog.showModal(); + input.focus(); + status.textContent = '正在准备本地搜索索引…'; + try { index = await loadIndex(); renderResults(); } + catch { status.textContent = '搜索索引未能加载。请刷新重试,或使用左侧目录。'; } + } + $$('[data-search]').forEach(button => button.addEventListener('click', openSearch)); + $$('[data-close-search]').forEach(button => button.addEventListener('click', () => searchDialog.close())); + searchDialog.addEventListener('close', () => searchOpener?.focus()); + searchDialog.addEventListener('click', event => { if (event.target === searchDialog) searchDialog.close(); }); + input.addEventListener('input', renderResults); + input.addEventListener('keydown', event => { + if (event.key === 'ArrowDown' || event.key === 'ArrowUp') { + event.preventDefault(); selectResult(selected + (event.key === 'ArrowDown' ? 1 : -1)); + } + if (event.key === 'Enter' && matches[selected]) location.href = root + matches[selected].url; + }); + if (!/Mac|iPhone|iPad/.test(navigator.platform)) $$('[data-shortcut]').forEach(kbd => kbd.textContent = 'Ctrl K'); + document.addEventListener('keydown', event => { + const typing = event.target.closest('input,textarea,[contenteditable=true]'); + if (((event.metaKey || event.ctrlKey) && event.key.toLowerCase() === 'k') || (event.key === '/' && !typing && !event.ctrlKey && !event.metaKey)) { + event.preventDefault(); openSearch(); + } + if (event.key === 'Escape' && sidebar.classList.contains('open')) { + setMenu(false); menu.focus(); + } + if (event.key === 'Tab' && sidebar.classList.contains('open')) { + const links = [...sidebar.querySelectorAll('a')]; + if (event.shiftKey && document.activeElement === links[0]) { event.preventDefault(); menu.focus(); } + else if (!event.shiftKey && document.activeElement === links.at(-1)) { event.preventDefault(); menu.focus(); } + else if (document.activeElement === menu) { event.preventDefault(); (event.shiftKey ? links.at(-1) : links[0]).focus(); } + } + }); + + const imageDialog = $('#image-dialog'); + $$('figure img').forEach(image => { + const button = document.createElement('button'); + button.type = 'button'; + button.setAttribute('aria-label', '放大查看:' + image.alt); + image.replaceWith(button); button.append(image); + button.addEventListener('click', () => { + const preview = imageDialog.querySelector('img'); + preview.src = image.currentSrc || image.src; preview.alt = image.alt; + imageDialog.querySelector('p').textContent = image.closest('figure').querySelector('figcaption')?.textContent || image.alt; + imageDialog.showModal(); + }); + }); + $('#close-image').addEventListener('click', () => imageDialog.close()); + imageDialog.addEventListener('click', event => { if (event.target === imageDialog) imageDialog.close(); }); + + $$('.platform-tabs').forEach((group, groupIndex) => { + const tabs = [...group.querySelectorAll('[data-platform]')]; + const panels = [...group.querySelectorAll('.platform-panel')]; + group.querySelector('.platform-tablist').setAttribute('role', 'tablist'); + function choose(position, focus = false) { + tabs.forEach((tab, index) => { + tab.setAttribute('role', 'tab'); tab.id = `platform-${groupIndex}-${index}`; + tab.setAttribute('aria-selected', String(index === position)); tab.tabIndex = index === position ? 0 : -1; + panels[index].hidden = index !== position; + panels[index].id = `platform-panel-${groupIndex}-${index}`; + panels[index].setAttribute('role', 'tabpanel'); panels[index].tabIndex = 0; + panels[index].setAttribute('aria-labelledby', tab.id); tab.setAttribute('aria-controls', panels[index].id); + }); + if (focus) tabs[position].focus(); + } + tabs.forEach((tab, position) => { + tab.addEventListener('click', () => choose(position)); + tab.addEventListener('keydown', event => { + let next; + if (event.key === 'ArrowRight') next = (position + 1) % tabs.length; + if (event.key === 'ArrowLeft') next = (position + tabs.length - 1) % tabs.length; + if (event.key === 'Home') next = 0; + if (event.key === 'End') next = tabs.length - 1; + if (next !== undefined) { event.preventDefault(); choose(next, true); } + }); + }); + choose(0); + }); + + const headings = $$('#article-content h2, #article-content h3'); + const tocLinks = $$('.toc a'); + let scheduled = false; + function onScroll() { + if (scheduled) return; + scheduled = true; + requestAnimationFrame(() => { + const range = document.documentElement.scrollHeight - innerHeight; + $('.reading-progress').style.width = `${range > 0 ? scrollY / range * 100 : 0}%`; + let active = headings[0]?.id; + for (const heading of headings) { if (heading.getBoundingClientRect().top <= 145) active = heading.id; } + tocLinks.forEach(link => link.classList.toggle('active', decodeURIComponent(link.hash.slice(1)) === active)); + scheduled = false; + }); + } + addEventListener('scroll', onScroll, { passive: true }); + onScroll(); + $('.back-top').addEventListener('click', () => { scrollTo({ top: 0, behavior: reducedMotion.matches ? 'instant' : 'smooth' }); $('#main').focus({ preventScroll: true }); }); + if (!reducedMotion.matches) { + const observer = new IntersectionObserver(entries => entries.forEach(entry => { + if (entry.isIntersecting) { entry.target.classList.add('revealed'); observer.unobserve(entry.target); } + }), { threshold: 0.08 }); + $$('.feature-card, .hero, figure').forEach(element => observer.observe(element)); + } +})(); diff --git a/docs/site/build.py b/docs/site/build.py new file mode 100644 index 000000000..be6925512 --- /dev/null +++ b/docs/site/build.py @@ -0,0 +1,207 @@ +#!/usr/bin/env python3 +"""Build Pebrel's Markdown user guide into a portable, server-free HTML site.""" +from __future__ import annotations + +import argparse +import html +import json +import re +import shutil +from pathlib import Path +from string import Template +from urllib.parse import quote +from xml.sax.saxutils import escape as xml_escape + +import mistune +from pygments import highlight +from pygments.formatters import HtmlFormatter +from pygments.lexers import TextLexer, get_lexer_by_name +from pygments.util import ClassNotFound + +HERE = Path(__file__).resolve().parent +REPO = HERE.parent.parent +UPSTREAM = "https://github.com/Kuddev/pebrel" + + +def plain(text: str) -> str: + return re.sub(r"\s+", " ", html.unescape(re.sub(r"<[^>]+>", " ", text))).strip() + + +def page_url(slug: str) -> str: + return "index.html" if slug == "index" else f"{slug}/index.html" + + +class Renderer(mistune.HTMLRenderer): + def __init__(self, root: str): + super().__init__(escape=False) + self.root = root + self.headings: list[tuple[int, str, str]] = [] + self.ids: dict[str, int] = {} + + def heading(self, text: str, level: int, **attrs) -> str: + label = plain(text) + base = re.sub(r"[^\w\-]+", "-", label.lower()).strip("-") or "section" + count = self.ids.get(base, 0) + self.ids[base] = count + 1 + identity = f"{base}-{count}" if count else base + self.headings.append((level, identity, label)) + return (f'{text}' + f'#\n') + + def link(self, text: str, url: str, title=None) -> str: + if not re.match(r"^[a-z]+:|^//|^#", url): + name, sep, fragment = url.partition("#") + if name.endswith(".md"): + url = self.root + page_url(Path(name).stem) + (sep + fragment if sep else "") + return super().link(text, url, title) + + def block_code(self, code: str, info=None) -> str: + language = (info or "text").split()[0] + try: + lexer = get_lexer_by_name(language) + except ClassNotFound: + lexer = TextLexer() + rendered = highlight(code, lexer, HtmlFormatter(nowrap=True)) + return (f'
{html.escape(language)}' + '
' + f'
{rendered}
\n') + + def block_quote(self, text: str) -> str: + match = re.match(r"

\[!(NOTE|TIP|WARNING|IMPORTANT)\]\s*", text) + if match: + kind = match[1] + title = {"NOTE": "说明", "TIP": "使用提示", "WARNING": "注意", "IMPORTANT": "请先确认"}[kind] + text = "

" + text[match.end():] + return (f'

\n') + return super().block_quote(text) + + def table(self, text: str) -> str: + return '
\n' + text + '
\n' + + +def render_markdown(source: str, root: str) -> tuple[str, Renderer]: + renderer = Renderer(root) + markdown = mistune.create_markdown(renderer=renderer, plugins=["table", "strikethrough", "task_lists", "footnotes"]) + return markdown(source.replace("@ROOT@", root)), renderer + + +def navigation(groups: list[dict], active: str, root: str) -> str: + result = [] + for group in groups: + links = [] + for page in group["pages"]: + current = page["slug"] == active + links.append(f'{html.escape(page["title"])}') + result.append(f'') + return "\n".join(result) + + +def home_header() -> str: + return '''
PEBREL / USER GUIDE + +

从一个终端开始。
把工作连成一体。

+

本地命令、远程主机与 AI 工作流,在一个从容的空间里。
从第一次打开,到找到属于你的工作方式。

+
开始使用 下载 Pebrel ↗
+
为你的桌面而来WindowsmacOS PreviewLinux Preview
''' + + +def source_details(page: dict, commit: str) -> str: + sources = page.get("sources", []) + links = "".join(f'
  • {html.escape(path)}
  • ' for path in sources) + return (f'
    内容核对来源 · {commit[:7]}' + f'

    此页依据 Pebrel {html.escape(page.get("version", "1.9.1"))} 的代码与已公开指南编写。不同平台的界面可能略有差异。

    ') + + +def build(destination: Path, base_url: str) -> dict: + config = json.loads((HERE / "site.json").read_text()) + pages = [dict(page, group=group["title"]) for group in config["groups"] for page in group["pages"]] + slugs = [page["slug"] for page in pages] + if len(slugs) != len(set(slugs)): + raise ValueError("Duplicate page slug") + template = Template((HERE / "template.html").read_text()) + destination.mkdir(parents=True, exist_ok=True) + assets = destination / "assets" + shutil.copytree(HERE / "assets", assets, dirs_exist_ok=True) + shutil.copy2(REPO / "extra/logo/nebula.png", assets / "pebrel.png") + screenshot_dir = assets / "screenshots" + screenshot_dir.mkdir(exist_ok=True) + for filename in config["images"]: + shutil.copy2(REPO / "docs/screenshots" / filename, screenshot_dir / filename) + formatter = HtmlFormatter() + (assets / "highlight.css").write_text( + formatter.get_style_defs(".code-block") + '\n' + '[data-theme=dark] .code-block .c,[data-theme=dark] .code-block .c1{color:#a1b4a4}\n' + '[data-theme=dark] .code-block .s,[data-theme=dark] .code-block .s1,[data-theme=dark] .code-block .s2{color:#abdab9}\n' + '[data-theme=dark] .code-block .k,[data-theme=dark] .code-block .nb{color:#94bbee}\n' + '[data-theme=dark] .code-block .nf,[data-theme=dark] .code-block .nv,[data-theme=dark] .code-block .o{color:#dadbbd}\n', encoding="utf-8") + search = [] + total_characters = 0 + all_markdown = [] + for position, page in enumerate(pages): + slug = page["slug"] + root = "./" if slug == "index" else "../" + source = (HERE / "content" / f"{slug}.md").read_text(encoding="utf-8") + for path in page.get("sources", []): + if not (REPO / path.split("#")[0]).is_file(): + raise ValueError(f"{slug}: unknown evidence source {path}") + content, renderer = render_markdown(source, root) + total_characters += len(plain(content)) + header = home_header() if slug == "index" else ( + f'
    {html.escape(page["group"])}' + f'

    {html.escape(page["title"])}

    {html.escape(page["description"])}

    ' + f'
    约 {max(1, len(plain(content)) // 450)} 分钟阅读' + f'' + f'Markdown ↓
    ') + header += '' + toc = "".join(f'{html.escape(label)}' for level, identity, label in renderer.headings if level in (2, 3)) + pagination = [] + for offset, label, arrow in [(-1, "上一篇", "← "), (1, "下一篇", "→ ")]: + neighbor = position + offset + if 0 <= neighbor < len(pages): + target = pages[neighbor] + pagination.append(f'{label}{arrow}{html.escape(target["title"])}') + else: + pagination.append('') + canonical = f'' if base_url else "" + output = template.substitute( + description=html.escape(page["description"]), title=html.escape(page["title"]), canonical=canonical, + root=root, slug=slug, version=config["version"], group=html.escape(page["group"]), + navigation=navigation(config["groups"], slug, root), main_class="home" if slug == "index" else "document", + page_header=header, content=content, source_details=source_details(page, config["source_commit"]), + pagination="".join(pagination), toc=toc, edit_url=f'{UPSTREAM}/edit/main/docs/site/content/{slug}.md') + target = destination / page_url(slug) + target.parent.mkdir(parents=True, exist_ok=True) + target.write_text(output, encoding="utf-8") + (destination / "markdown").mkdir(exist_ok=True) + (destination / "markdown" / f"{slug}.md").write_text(source, encoding="utf-8") + # Each section is independently searchable and links to its own anchor. + parts = re.split(r'(.*?)', content, flags=re.S) + search.append({"title": page["title"], "text": page["description"] + " " + plain(parts[0]), "url": page_url(slug)}) + for i in range(1, len(parts), 2): + identity = re.search(r'id="([^"]+)"', parts[i])[1] + heading = plain(re.sub(r'', '', parts[i], flags=re.S)) + search.append({"title": f'{page["title"]} · {heading}', "text": plain(parts[i + 1]), "url": page_url(slug) + "#" + quote(identity)}) + all_markdown.append(f'# {page["title"]}\n\n{source}') + (destination / "search-index.js").write_text('window.PEBREL_DOCS_SEARCH=' + json.dumps(search, ensure_ascii=False).replace("<", "\\u003c") + ';\n', encoding="utf-8") + (destination / ".nojekyll").touch() + (destination / "llms.txt").write_text('# Pebrel 用户手册\n\n' + '\n'.join(f'- [{page["title"]}]({base_url}markdown/{page["slug"]}.md): {page["description"]}' for page in pages) + '\n', encoding="utf-8") + (destination / "llms-full.txt").write_text('\n\n---\n\n'.join(all_markdown), encoding="utf-8") + (destination / "404.html").write_text(f'未找到页面 · Pebrel
    404 / PEBREL DOCS

    这一页不在这里。

    地址可能已变更。回到文档首页,通过目录或搜索继续查找。

    返回文档首页 →
    ', encoding="utf-8") + if base_url: + (destination / "sitemap.xml").write_text('' + ''.join(f'{xml_escape(base_url + page_url(page["slug"]))}' for page in pages) + '', encoding="utf-8") + stats = {"pages": len(pages), "search_sections": len(search), "text_characters": total_characters, "source_commit": config["source_commit"]} + (destination / "build-info.json").write_text(json.dumps(stats, indent=2) + "\n") + return stats + + +if __name__ == "__main__": + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--output", type=Path, default=HERE / "dist") + parser.add_argument("--base-url", default="", help="Canonical URL, including the repository subpath") + args = parser.parse_args() + url = args.base_url.rstrip("/") + "/" if args.base_url else "" + print(json.dumps(build(args.output.resolve(), url), ensure_ascii=False, indent=2)) diff --git a/docs/site/check_browser.py b/docs/site/check_browser.py new file mode 100644 index 000000000..fdc88ec1c --- /dev/null +++ b/docs/site/check_browser.py @@ -0,0 +1,90 @@ +"""Exercise the built guide under a repository Pages prefix in a real browser.""" +import argparse +import json +import os +import shutil +import tempfile +from functools import partial +from http.server import SimpleHTTPRequestHandler, ThreadingHTTPServer +from pathlib import Path +from threading import Thread + +from playwright.sync_api import sync_playwright, expect + + +class QuietHandler(SimpleHTTPRequestHandler): + def log_message(self, *args): + pass + + +def check(site: Path, output: Path): + output.mkdir(parents=True, exist_ok=True) + with tempfile.TemporaryDirectory() as temporary: + served = Path(temporary) + shutil.copytree(site, served / 'pebrel') + server = ThreadingHTTPServer(('127.0.0.1', 0), partial(QuietHandler, directory=temporary)) + Thread(target=server.serve_forever, daemon=True).start() + base = f'http://127.0.0.1:{server.server_port}/pebrel/' + errors = [] + try: + with sync_playwright() as playwright: + executable = os.environ.get('CHROMIUM_PATH') + browser = playwright.chromium.launch(executable_path=executable) + context = browser.new_context(viewport={'width': 1512, 'height': 1000}, permissions=['clipboard-read', 'clipboard-write']) + page = context.new_page() + page.on('pageerror', lambda error: errors.append(str(error))) + page.goto(base) + expect(page.locator('h1')).to_contain_text('从一个终端开始') + page.wait_for_timeout(650) + page.screenshot(path=str(output / 'docs-desktop.png'), full_page=True) + page.keyboard.press('Control+k') + page.locator('#search-input').fill('分屏') + expect(page.locator('.search-result').first).to_be_visible() + page.keyboard.press('Enter') + expect(page).to_have_url(__import__('re').compile('/pebrel/.*#')) + page.goto(base + 'quickstart/index.html') + page.locator('.copy-code').first.click() + expect(page.locator('.copy-code').first).to_have_attribute('data-copied', 'true') + assert 'echo Hello, Pebrel' in page.evaluate('navigator.clipboard.readText()') + page.locator('#theme-toggle').click() + expect(page.locator('html')).to_have_attribute('data-theme', 'dark') + page.reload() + expect(page.locator('html')).to_have_attribute('data-theme', 'dark') + page.screenshot(path=str(output / 'docs-dark.png'), full_page=True) + page.locator('figure button').first.click() + expect(page.locator('#image-dialog')).to_be_visible() + page.keyboard.press('Escape') + expect(page.locator('#image-dialog')).not_to_be_visible() + page.set_viewport_size({'width': 390, 'height': 844}) + page.goto(base) + page.locator('#theme-toggle').click() + page.wait_for_timeout(650) + assert not page.evaluate('document.documentElement.scrollWidth > innerWidth') + page.screenshot(path=str(output / 'docs-mobile.png'), full_page=True) + page.locator('#menu-toggle').click() + expect(page.locator('#menu-toggle')).to_have_attribute('aria-expanded', 'true') + page.keyboard.press('Escape') + expect(page.locator('#menu-toggle')).to_have_attribute('aria-expanded', 'false') + page.emulate_media(reduced_motion='reduce') + assert page.locator('.hero').evaluate("el => getComputedStyle(el).animationName") == 'none' + nojs = browser.new_context(java_script_enabled=False, viewport={'width': 390, 'height': 844}) + fallback = nojs.new_page() + fallback.goto(base) + expect(fallback.locator('#sidebar')).to_be_visible() + fallback.get_by_role('link', name='快速开始', exact=True).first.click() + expect(fallback.locator('h1')).to_have_text('快速开始') + nojs.close() + browser.close() + finally: + server.shutdown() + server.server_close() + assert not errors, errors + (output / 'browser-result.json').write_text(json.dumps({'passed': True, 'page_errors': errors}, indent=2)) + + +if __name__ == '__main__': + parser = argparse.ArgumentParser() + parser.add_argument('--site', type=Path, default=Path(__file__).parent / 'dist') + parser.add_argument('--output', type=Path, default=Path('docs-browser-results')) + args = parser.parse_args() + check(args.site, args.output) diff --git a/docs/site/content/index.md b/docs/site/content/index.md new file mode 100644 index 000000000..4e0a2671a --- /dev/null +++ b/docs/site/content/index.md @@ -0,0 +1,33 @@ +## 一个工作空间,更多可能 + +不必一次学会所有功能。从熟悉的命令行开始,再逐步加入远程连接、分屏与 AI 工具。 + +
    +›_

    打开第一个终端

    运行命令、创建标签页,把工作安排在并排的窗格里。

    +⇄

    连接你的服务器

    保存 SSH 主机,在终端旁浏览和传输远程文件。

    +✳

    安放 AI 工作流

    运行已有的 AI 命令行工具,关注任务进度,阅读完整回答。

    +◧

    找到适合你的版本

    了解平台支持,选择安装包,平稳迁移已有配置。

    +
    + +## 先认识 Pebrel + +Pebrel 是桌面终端应用。它把本地 Shell、SSH 会话、文件浏览和 AI 命令行工具放在同一个原生窗口中。你仍然使用自己熟悉的命令、开发工具与账户。 + +
    Pebrel 中的顶部标签页与终端工作区
    Pebrel 的终端工作区。图片来自项目已公开的应用截图,外观可能与当前平台或主题不同。点击可放大。
    + +**标签页**用于分开不同工作,**窗格**用于并排查看,**SSH 主机**用于连接远程环境。AI CLI 是你自行安装的命令行工具,不是文档网站提供的在线聊天服务。 + +## 按你现在要做的事开始 + +第一次使用,请先阅读[快速开始](quickstart.md)。需要挑选系统或处理首次启动,请看[安装与平台支持](installation.md)。 + +> [!NOTE] +> 本指南对应 Pebrel **1.9.1** 的上游代码。Linux 与 macOS 仍标为 Preview,部分桌面集成仅在 Windows 提供。请以各页的平台提示为准,而不是假设所有按钮在每个系统都存在。 + +## 如何使用这份指南 + +按左侧目录阅读,或按 Ctrl / ⌘ + K 搜索。搜索在你的浏览器内完成,不会把查询发送给远程搜索服务。 + +每篇指南右侧列出当前页目录。代码示例可以复制;正文可以复制或保存为 Markdown。点击截图可放大;右上角可切换深浅主题。手机上使用右上角菜单打开章节目录。 + +页面底部的“内容核对来源”提供对应代码的位置。通常无需阅读这些技术资料,也能完成正文中的操作。 diff --git a/docs/site/content/installation.md b/docs/site/content/installation.md new file mode 100644 index 000000000..47283efbb --- /dev/null +++ b/docs/site/content/installation.md @@ -0,0 +1,89 @@ +## 选择安装包 + +只从 [Pebrel 官方发布页](https://github.com/Kuddev/pebrel/releases/latest)下载你要安装的版本。文件名中的系统与架构必须和你的机器相符。 + +| 系统 | 架构 | 安装包 | 当前状态 | +| --- | --- | --- | --- | +| Windows 10 1809+ / Windows 11 | x64 | 安装程序 `.exe`、便携 `.zip` | 正式平台 | +| macOS,部署目标 14+ | Apple Silicon / arm64 | `.dmg` | Preview | +| macOS,部署目标 14+ | Intel / x64 | `.dmg` | Preview | +| Linux,glibc 2.35+ | x64 | `.deb`、`.AppImage`、便携 `.tar.gz` | Preview | + +例如,Windows 安装程序的命名形式为 `Pebrel-v<版本>-windows-x64-setup.exe`。macOS 与 Linux 预览包的文件名含 `-preview`。 + +> [!NOTE] +> macOS 的部署目标不等于每个旧系统版本都已完成实机验证;项目的原生 macOS CI 在 macOS 15 上运行。遇到平台问题时,请一并提供系统版本与处理器架构。 + +## Windows + +### 使用安装程序 + +1. 下载对应版本的 `-setup.exe`。 +2. 运行安装程序,按提示完成安装。默认是当前用户安装,通常位于 `%LOCALAPPDATA%\Programs\Pebrel`。 +3. 从开始菜单启动 Pebrel。 + +### 使用便携包 + +完整解压 ZIP 到可写的文件夹,再运行 `pebrel.exe`。不要只取出 EXE;打包目录中的附带文件需要保留。 + +便携版更新时先退出应用,再完整替换程序包。安装版与便携版的更新方式不同;没有安装器标记的便携目录不使用 Windows 安装器自动覆盖。 + +## macOS + +1. 在“关于本机”中确认是 Apple 芯片还是 Intel 处理器。 +2. 下载对应架构的 DMG,打开并把 Pebrel 拖到 **应用程序**。 +3. 从“应用程序”启动,而不是一直从挂载的 DMG 中运行。 + +预览构建采用临时签名,首次启动可能被系统阻止。确认文件来自官方发布页后,前往 **系统设置 → 隐私与安全性**,使用系统提供的 **仍要打开**,然后再次确认。不要关闭系统整体安全检查来绕过来源核验。 + +如果仍无法启动,记录 macOS 版本、芯片类型、下载的完整文件名及错误提示,再提交问题。 + +## Linux + +### Debian / Ubuntu 系列 + +在下载目录打开终端,将文件名替换为你实际下载的 DEB: + +```sh +sudo apt install ./Pebrel-v版本-linux-x64-preview.deb +``` + +### AppImage + +```sh +chmod +x Pebrel-v版本-linux-x64-preview.AppImage +./Pebrel-v版本-linux-x64-preview.AppImage +``` + +若系统缺少 AppImage 所需的运行支持,请按发行版说明配置,或改用 DEB / 便携包;不要把所有启动问题都当作 Pebrel 配置错误。 + +### 便携包 + +解压整个 `.tar.gz`,保留原有目录结构,通过包内的 **`AppRun`** 启动。不要只复制底层可执行文件,否则可能丢失启动器负责配置的运行路径。 + +### 保存 SSH 凭据 + +Linux 上保存凭据需要可用且已解锁的 Secret Service;还需要 `libsecret-tools`。无法访问桌面密钥环时,可以先不保存密码而进行连接,不必把密码写进共享配置文件。 + +## 各平台有什么不同 + +| 能力 | Windows | macOS Preview | Linux Preview | +| --- | --- | --- | --- | +| 终端、分屏、SSH、SFTP、文件与文档界面 | 支持 | 支持 | 支持 | +| 托盘与关闭窗口后后台驻留 | 支持 | 不提供 | 不提供 | +| 全局快速终端热键 | 支持 | 不提供 | 不提供 | +| 自动本地 AI hook 设置 | 支持 | 不提供 | 不提供 | +| 系统通知与系统凭据存储 | 支持 | 支持 | 支持;凭据依赖桌面服务 | +| 应用内安装更新 | 安装版支持 | 应用包更新路径已实现 | 手动安装新包 | + +此表依据 1.9.1 的平台能力与更新安装代码,不把未来计划或未合并的改动算作已支持。 + +## 从旧名称 Nebula 迁移 + +Pebrel 保留对部分旧配置名称的兼容。在新位置没有相应文件时,会尝试迁移旧设置;**已有的新文件不会被覆盖**,旧文件会保留。 + +迁移前退出旧应用并备份设置与 SSH 主机信息。安装新版后,检查字体、主题、默认 Shell 与主机列表是否符合预期,再决定是否删除旧程序。不要在确认迁移成功之前清理旧数据。 + +## 下一步 + +按照[快速开始](quickstart.md)打开终端并创建第一个分屏。若只是想修改外观,先使用设置界面,不需要编写配置文件。 diff --git a/docs/site/content/quickstart.md b/docs/site/content/quickstart.md new file mode 100644 index 000000000..20339b4d6 --- /dev/null +++ b/docs/site/content/quickstart.md @@ -0,0 +1,81 @@ +## 安装并打开 + +1. 前往 [Pebrel 官方发布页](https://github.com/Kuddev/pebrel/releases/latest),选择适合系统与处理器的安装包。 +2. Windows 运行安装程序,或完整解压便携包;macOS 打开 DMG,将 Pebrel 拖入“应用程序”;Linux 使用 DEB、AppImage 或完整便携包。 +3. 启动 Pebrel,先保留默认设置。在终端中输入下面的命令并回车。 + +```sh +echo Hello, Pebrel +``` + +看到 `Hello, Pebrel` 后,你的第一个终端已经可以使用。[安装说明](installation.md)列出了各个平台的要求与首次启动注意事项。 + +> [!TIP] +> Pebrel 是运行命令的窗口,不会自动安装你的开发环境。某个命令提示“找不到”时,先确认相应工具已安装,并且能在系统原有终端中运行。 + +## 建立顺手的工作区 + +### 新建标签页 + +Windows / Linux 按 Ctrl + Shift + T;macOS 按 ⌘ + T。新标签页适合另一个项目,或一项不希望打断当前任务的工作。 + +在终端里用 `cd` 进入你的项目目录。例如,先把下面的路径替换为真实存在的文件夹,再运行: + +```sh +cd "你的项目目录" +``` + +### 并排打开窗格 + +Windows / Linux 按 Ctrl + Shift + D,macOS 按 ⌘ + D,向右分屏。左边运行开发工具,右边执行测试或查看文件。 + +拖动两个窗格之间的分隔线调整宽度。需要专心看一个窗格时,按 Ctrl / ⌘ + Shift + Enter 切换放大,再按一次回到分屏布局。 + +
    多个命令行工具在 Pebrel 的独立分屏中运行
    分屏让各个任务保持独立。项目公开截图;其中的命令行工具需另行安装。
    + +### 找不到某个操作 + +按 Ctrl / ⌘ + Shift + P 打开命令面板。要更换 Shell,使用 Ctrl / ⌘ + K 打开 Shell 选择器。 + +这里是 **Pebrel 应用内的快捷键**。文档网站中的同一组合键用于搜索文档,不会控制桌面应用。 + +## 连接远程主机 + +打开 Pebrel 设置,进入 **SSH**。创建一个主机,填写服务器地址、用户名与端口,按服务器要求选择密码或私钥认证,然后连接。 + +第一次连接前,把显示的主机密钥指纹与服务器管理员提供的指纹核对一致。不要仅为了跳过提示而接受不认识的指纹;已有主机的指纹突然改变时,先确认服务器是否重装或换钥。 + +连接后,你输入的命令在远程机器上执行。远程文件浏览与传输使用 SFTP;远端需允许相应服务。 + +## 使用 AI 命令行工具 + +先按照工具自身的说明安装并登录 Claude Code 或 Codex。在 Pebrel 中进入项目目录,再运行你已安装的工具,例如: + +```sh +claude +``` + +或者: + +```sh +codex +``` + +Pebrel 可以为识别到的 AI CLI 显示活动状态。更精确的状态与回答捕获需要对应的 hook 集成;自动本地 hook 设置目前是 Windows 平台能力。macOS 与 Linux 仍可以正常运行已安装的 CLI,但不要把“能运行”理解为“所有集成都已自动配置”。 + +AI 服务的登录、额度与费用由对应工具和服务提供方管理。关闭或隐藏通知不会代替你批准终端中的请求。 + +## 做两个舒适度调整 + +打开设置:Windows / Linux 使用 Ctrl + ,,macOS 使用 ⌘ + ,。 + +在 **外观** 中选择主题和字体。临时调整终端字号可以使用 Ctrl / ⌘ + + 或 −;按 Ctrl / ⌘ + 0 恢复。 + +再按 Ctrl + Shift + B(macOS 为 ⌘ + B)收起或展开侧边栏,选择适合屏幕的工作空间。 + +## 结束这次工作 + +先保存正在编辑的文件,确认长时间运行的任务是否已完成,再关闭窗格或窗口。 + +> [!IMPORTANT] +> **恢复布局、恢复 AI 对话、保持进程运行是三件不同的事。** Windows 的可选后台驻留可以在关闭窗口后保留运行中的会话;完整退出应用后,普通进程不会因为开启布局恢复而继续运行。其他平台不要依赖关闭窗口后的进程保活。 diff --git a/docs/site/requirements.txt b/docs/site/requirements.txt new file mode 100644 index 000000000..9f922dfb6 --- /dev/null +++ b/docs/site/requirements.txt @@ -0,0 +1,2 @@ +mistune==3.2.1 +Pygments==2.20.0 diff --git a/docs/site/site.json b/docs/site/site.json new file mode 100644 index 000000000..bf447b3a4 --- /dev/null +++ b/docs/site/site.json @@ -0,0 +1,12 @@ +{ + "version": "1.9.1", + "source_commit": "9dc058d12765893553d5fc7a2c37c870c96168b0", + "groups": [ + {"title": "开始使用", "pages": [ + {"slug": "index", "title": "概览", "description": "从一个终端开始,把本地、远程与 AI 工作流连成一体。", "sources": ["README.md", "nebula_app/src/platform/capabilities.rs"]}, + {"slug": "quickstart", "title": "快速开始", "description": "安装 Pebrel,打开第一个终端,建立顺手的工作空间。", "sources": ["INSTALL.md", "nebula_app/src/gpui_shell/workspace/keyboard_bindings.rs"]}, + {"slug": "installation", "title": "安装与平台支持", "description": "为 Windows、macOS 或 Linux 选择合适的安装包。", "sources": ["INSTALL.md", "nebula_app/src/platform/capabilities.rs", "nebula_app/src/platform/update_installation.rs"]} + ]} + ], + "images": ["nebula-top-tabs.png", "split-ai-workflows.png", "nebula-claude-session.png", "native-math-rendering.png", "themes.png", "ai-sidebar.png", "notification-duration.png", "reader-selection-opacity.png", "hero.png"] +} diff --git a/docs/site/template.html b/docs/site/template.html new file mode 100644 index 000000000..80a1eee42 --- /dev/null +++ b/docs/site/template.html @@ -0,0 +1,56 @@ + + + + + + + + + $title · Pebrel 文档 + $canonical + + + + + + + + + +
    + Pebrel文档 + +
    + + + +
    +
    + + +
    +
    + + $page_header +
    $content
    + $source_details + + +
    + +
    + +
    +

    搜索功能、设置或操作步骤。

    +
    + +
    +

    +
    + + + diff --git a/docs/site/test_site.py b/docs/site/test_site.py new file mode 100644 index 000000000..07daf9544 --- /dev/null +++ b/docs/site/test_site.py @@ -0,0 +1,96 @@ +"""Check generated navigation, rich content, and portable asset references.""" +import json +import tempfile +import unittest +from html.parser import HTMLParser +from pathlib import Path +from urllib.parse import unquote, urlsplit + +from build import build, HERE, page_url + + +class Document(HTMLParser): + def __init__(self, source): + super().__init__() + self.ids = set() + self.duplicates = set() + self.references = [] + self.headings = [] + self.images_without_alt = [] + self.remote_runtime = [] + self.feed(source) + + def handle_starttag(self, tag, attrs): + values = dict(attrs) + identity = values.get('id') + if identity in self.ids: + self.duplicates.add(identity) + if identity: + self.ids.add(identity) + if tag == 'h1': + self.headings.append(tag) + if tag == 'img' and 'alt' not in values: + self.images_without_alt.append(values) + for key in ('src', 'href'): + if key in values: + self.references.append(values[key]) + resource = values.get('src') if tag == 'script' else values.get('href') if tag == 'link' and values.get('rel') == 'stylesheet' else '' + if resource and urlsplit(resource).scheme: + self.remote_runtime.append(resource) + + +class SiteTests(unittest.TestCase): + @classmethod + def setUpClass(cls): + cls.temp = tempfile.TemporaryDirectory() + cls.root = Path(cls.temp.name) + cls.report = build(cls.root, 'https://example.org/pebrel/') + cls.documents = { + path.resolve(): Document(path.read_text()) + for path in cls.root.rglob('*.html') + } + + @classmethod + def tearDownClass(cls): + cls.temp.cleanup() + + def test_internal_links_and_fragments(self): + for path, document in self.documents.items(): + for reference in document.references: + url = urlsplit(reference) + if url.scheme or url.netloc: + continue + target = (path.parent / unquote(url.path)).resolve() if url.path else path + if target.is_dir(): + target /= 'index.html' + with self.subTest(page=path.name, link=reference): + self.assertTrue(target.is_relative_to(self.root), 'Link escapes site root') + self.assertTrue(target.is_file(), f'Missing local destination: {target}') + if url.fragment and target in self.documents: + self.assertIn(unquote(url.fragment), self.documents[target].ids) + + def test_page_structure(self): + for path, document in self.documents.items(): + with self.subTest(page=path): + self.assertEqual(len(document.headings), 1) + self.assertFalse(document.duplicates) + self.assertFalse(document.images_without_alt) + self.assertFalse(document.remote_runtime) + self.assertTrue((self.root / '.nojekyll').is_file()) + self.assertFalse(list(self.root.rglob('*.woff*'))) + self.assertFalse(list(self.root.rglob('*.ttf'))) + + def test_search_and_markdown_cover_each_page(self): + config = json.loads((HERE / 'site.json').read_text()) + search = (self.root / 'search-index.js').read_text() + entries = json.loads(search.partition('=')[2].rstrip(';\n')) + for group in config['groups']: + for page in group['pages']: + with self.subTest(page=page['slug']): + self.assertTrue(any(item['url'].split('#')[0] == page_url(page['slug']) for item in entries)) + self.assertTrue((self.root / 'markdown' / (page['slug'] + '.md')).is_file()) + self.assertIn('/pebrel/quickstart/index.html', (self.root / 'sitemap.xml').read_text()) + + +if __name__ == '__main__': + unittest.main() From 5aba1a104a048af126125a39326c4bb64101e43f Mon Sep 17 00:00:00 2001 From: GeekMr <140129782+WilliamWang1721@users.noreply.github.com> Date: Fri, 25 Sep 2026 12:38:43 +0800 Subject: [PATCH 02/13] docs: complete user documentation --- .github/workflows/docs-site.yml | 9 +- .gitignore | 51 ++ .../pebrel-1.9.1-macos-arm64-ci.png | Bin 0 -> 95941 bytes docs/site/README.md | 30 +- docs/site/assets/site.css | 30 +- docs/site/assets/site.js | 2 + docs/site/build.py | 20 +- docs/site/check_browser.py | 10 +- docs/site/content/agent-worktrees.md | 61 ++ docs/site/content/ai-history.md | 50 ++ docs/site/content/ai-start.md | 43 ++ docs/site/content/appearance.md | 35 ++ docs/site/content/backgrounds.md | 38 ++ docs/site/content/broadcast.md | 28 + docs/site/content/clipboard.md | 42 ++ docs/site/content/commands.md | 47 ++ docs/site/content/completions.md | 34 ++ docs/site/content/config-examples.md | 104 ++++ docs/site/content/configuration.md | 71 +++ docs/site/content/documents.md | 43 ++ docs/site/content/files.md | 49 ++ docs/site/content/fonts.md | 41 ++ docs/site/content/git-conflicts.md | 47 ++ docs/site/content/hooks.md | 40 ++ docs/site/content/images.md | 41 ++ docs/site/content/index.md | 53 +- docs/site/content/installation.md | 94 ++- docs/site/content/interaction.md | 49 ++ docs/site/content/keyboard.md | 51 ++ docs/site/content/layouts.md | 38 ++ docs/site/content/markdown-editing.md | 96 +++ docs/site/content/migration.md | 53 ++ docs/site/content/navigation.md | 27 + docs/site/content/network.md | 50 ++ docs/site/content/notifications.md | 35 ++ docs/site/content/palette.md | 30 + docs/site/content/privacy.md | 33 + docs/site/content/quick-terminal.md | 31 + docs/site/content/quickstart.md | 85 ++- docs/site/content/remote-edit.md | 41 ++ docs/site/content/runtime.md | 72 +++ docs/site/content/send-to-chat.md | 35 ++ docs/site/content/sessions.md | 41 ++ docs/site/content/settings.md | 49 ++ docs/site/content/sftp.md | 56 ++ docs/site/content/shells.md | 54 ++ docs/site/content/ssh-auth.md | 47 ++ docs/site/content/ssh-config.md | 54 ++ docs/site/content/ssh-library.md | 48 ++ docs/site/content/ssh-routing.md | 46 ++ docs/site/content/ssh.md | 60 ++ docs/site/content/svn.md | 43 ++ docs/site/content/terminal-basics.md | 52 ++ docs/site/content/themes.md | 49 ++ docs/site/content/troubleshooting.md | 82 +++ docs/site/content/updates.md | 49 ++ docs/site/content/vcs.md | 44 ++ docs/site/content/workspace.md | 53 ++ docs/site/content/wsl.md | 60 ++ docs/site/screenshots.json | 86 +++ docs/site/site.json | 574 +++++++++++++++++- docs/site/test_site.py | 29 +- docs/site/third-party-notices.txt | 27 + 63 files changed, 3285 insertions(+), 157 deletions(-) create mode 100644 docs/screenshots/pebrel-1.9.1-macos-arm64-ci.png create mode 100644 docs/site/content/agent-worktrees.md create mode 100644 docs/site/content/ai-history.md create mode 100644 docs/site/content/ai-start.md create mode 100644 docs/site/content/appearance.md create mode 100644 docs/site/content/backgrounds.md create mode 100644 docs/site/content/broadcast.md create mode 100644 docs/site/content/clipboard.md create mode 100644 docs/site/content/commands.md create mode 100644 docs/site/content/completions.md create mode 100644 docs/site/content/config-examples.md create mode 100644 docs/site/content/configuration.md create mode 100644 docs/site/content/documents.md create mode 100644 docs/site/content/files.md create mode 100644 docs/site/content/fonts.md create mode 100644 docs/site/content/git-conflicts.md create mode 100644 docs/site/content/hooks.md create mode 100644 docs/site/content/images.md create mode 100644 docs/site/content/interaction.md create mode 100644 docs/site/content/keyboard.md create mode 100644 docs/site/content/layouts.md create mode 100644 docs/site/content/markdown-editing.md create mode 100644 docs/site/content/migration.md create mode 100644 docs/site/content/navigation.md create mode 100644 docs/site/content/network.md create mode 100644 docs/site/content/notifications.md create mode 100644 docs/site/content/palette.md create mode 100644 docs/site/content/privacy.md create mode 100644 docs/site/content/quick-terminal.md create mode 100644 docs/site/content/remote-edit.md create mode 100644 docs/site/content/runtime.md create mode 100644 docs/site/content/send-to-chat.md create mode 100644 docs/site/content/sessions.md create mode 100644 docs/site/content/settings.md create mode 100644 docs/site/content/sftp.md create mode 100644 docs/site/content/shells.md create mode 100644 docs/site/content/ssh-auth.md create mode 100644 docs/site/content/ssh-config.md create mode 100644 docs/site/content/ssh-library.md create mode 100644 docs/site/content/ssh-routing.md create mode 100644 docs/site/content/ssh.md create mode 100644 docs/site/content/svn.md create mode 100644 docs/site/content/terminal-basics.md create mode 100644 docs/site/content/themes.md create mode 100644 docs/site/content/troubleshooting.md create mode 100644 docs/site/content/updates.md create mode 100644 docs/site/content/vcs.md create mode 100644 docs/site/content/workspace.md create mode 100644 docs/site/content/wsl.md create mode 100644 docs/site/screenshots.json create mode 100644 docs/site/third-party-notices.txt diff --git a/.github/workflows/docs-site.yml b/.github/workflows/docs-site.yml index 0cca9b9f2..bd739f33c 100644 --- a/.github/workflows/docs-site.yml +++ b/.github/workflows/docs-site.yml @@ -13,6 +13,9 @@ concurrency: cancel-in-progress: true jobs: build: + permissions: + contents: read + pages: read runs-on: ubuntu-24.04 timeout-minutes: 10 steps: @@ -26,9 +29,13 @@ jobs: run: pip install -r docs/site/requirements.txt playwright==1.57.0 - name: Check links, page structure and search coverage run: python -m unittest discover -s docs/site -p test_site.py + - name: Resolve the configured Pages URL + if: github.ref == 'refs/heads/main' && github.event_name != 'pull_request' && vars.PEBREL_DOCS_PAGES_ENABLED == 'true' + id: pages + uses: actions/configure-pages@v5 - name: Build portable static site env: - DOCS_BASE_URL: ${{ vars.PEBREL_DOCS_BASE_URL }} + DOCS_BASE_URL: ${{ vars.PEBREL_DOCS_BASE_URL || steps.pages.outputs.base_url }} run: python docs/site/build.py --base-url "$DOCS_BASE_URL" - name: Install browser run: python -m playwright install --with-deps chromium diff --git a/.gitignore b/.gitignore index d60654b24..3ec55f3b6 100644 --- a/.gitignore +++ b/.gitignore @@ -230,3 +230,54 @@ NebulaTerminal-*/ !/docs/site/site.json !/docs/site/template.html !/docs/site/test_site.py + +!/docs/site/content/workspace.md +!/docs/site/content/shells.md +!/docs/site/content/clipboard.md +!/docs/site/content/completions.md +!/docs/site/content/palette.md +!/docs/site/content/commands.md +!/docs/site/content/navigation.md +!/docs/site/content/keyboard.md +!/docs/site/content/broadcast.md +!/docs/site/content/sessions.md +!/docs/site/content/layouts.md +!/docs/site/content/quick-terminal.md +!/docs/site/content/ssh.md +!/docs/site/content/ssh-library.md +!/docs/site/content/ssh-auth.md +!/docs/site/content/ssh-routing.md +!/docs/site/content/sftp.md +!/docs/site/content/files.md +!/docs/site/content/vcs.md +!/docs/site/content/documents.md +!/docs/site/content/images.md +!/docs/site/content/remote-edit.md +!/docs/site/content/ai-start.md +!/docs/site/content/hooks.md +!/docs/site/content/ai-history.md +!/docs/site/content/send-to-chat.md +!/docs/site/content/appearance.md +!/docs/site/content/themes.md +!/docs/site/content/backgrounds.md +!/docs/site/content/fonts.md +!/docs/site/content/notifications.md +!/docs/site/content/interaction.md +!/docs/site/content/configuration.md +!/docs/site/content/network.md +!/docs/site/content/runtime.md +!/docs/site/content/settings.md +!/docs/site/content/updates.md +!/docs/site/content/migration.md +!/docs/site/content/privacy.md +!/docs/site/content/troubleshooting.md +!/docs/site/screenshots.json +!/docs/site/third-party-notices.txt +!/docs/site/content/terminal-basics.md +!/docs/site/content/wsl.md +!/docs/site/content/ssh-config.md +!/docs/site/content/git-conflicts.md +!/docs/site/content/svn.md +!/docs/site/content/markdown-editing.md +!/docs/site/content/config-examples.md +!/docs/site/content/agent-worktrees.md diff --git a/docs/screenshots/pebrel-1.9.1-macos-arm64-ci.png b/docs/screenshots/pebrel-1.9.1-macos-arm64-ci.png new file mode 100644 index 0000000000000000000000000000000000000000..df72fddb5f8a46bb9e856eced485e0e82999b9e2 GIT binary patch literal 95941 zcmaI71z1#D_Xj+5ml6UJ5+dE*(jeWPBRL@5B?wXqQqtYsT`DczGlY`D5Yjo!H{SRE zzE|)4zHgpqo;h>Q*?X_O_S!3cYwaivH3d9u3TyxXfTyG=s|5g{A}&z?nCOU~_I46H z002APUPeYkNk)cN!_DQTy%P`sP>f1W!O%$@CLP?lotAkX0+`0?!kWgSWjq5Y*W^F= z008O2A%A`aZ*{_^%{NjEl;_^EX>$*}GZi{u_0{qF?;Qx^}EQtjhQ{g3E zp;}LgE&8xQe4~&}if^Vp++HmiRd$R=bW}7brQwR`tKoKSz-t@VtC%ob;j|s5)9+Df z2@PMzPU1cSHD9(mt=S|9TBjK1w>@Uq)#MRR9!=_>P>qXC+j25HvodtvC6acRSmiNg zz)H<}!}{|w9kQUV7a3dGlbJP`R7FxEk3O{5n?9PuYVo!IYjpC~!1tT0@oU-PyEj&x zOJ>i5O26ieUZ(CEE)mr?S#3Taufj{7&oFdzN%=xPe|u(!!qg}H3d;mVP+GE; zpwI%f6JY&K{9`yRCPu;&mO}j9=koDrHaJsHyoboJBR=H`JtI;MMU6)_LIFi!=h2lu zE{~wd%gK8i4$2qVA;P zc;om@<`ruIemDB%XRRwVv3JPNgp*j534l@g1)Z8tN_}*Al*5f8S)`J49W=&D@pZ`d zNR^}gqHf*}cP5J}k=*gN{&^SIeZGC<5MWG$StkLF9xz~%RxbtWuq zRQlIAPr`ejRMPF!&Ju}W3S!cSE9KKoh5wL`Whf>Re4r9F_9f;E#+Md1H@6$NaW_jh zu{J!nA~%Iij#0efKnCW7uS%9Bg`aaEXs2R$z>z@D|vo8o>J#CVh6slzRSMG zJNy&S48gqOvhA_~T~-Z8O{o5Dp_=xkuDbqO(Q5I%21=D>HBoV$mUYj7TwH4UNP2a; z(-`ttLHcE*1-pCItExGpCZiRj4X_CK9{l`(=in5~>8ax><~i*V?WqQh-P7`1@$_x) zZ@2ZxnbEPsrO44!?vSFKnVH6!O#Gn>J^!J)m+?bk*JaveD%ehnFPD;ml916fTy0gD^>?$oP9czYRp>TLJlzD0Pv&S3zxLpu$ zCHV^5ic`*#s{7({pV(aIr@II=r|))s4U4u@qBOi~zTFlBp_KhZ+zEw1Z@vpUy-*m@)P|Y2Cnt`7o*u35B1i^+tylg}zJI=ih zylM{E_uDRR4~~R1s7QsKTz`06t^e43=H}$}*ptUY*`wTpqL6h)W*71!HH&-PY#f@U zE)wkF>Os`;*z@}H+%*5nc`mf!%~PB<94IM%$8Ja6a`{T(A>XC!CCy3^wI4Oxdy4mi z+34AiC;TQ#aCzk^HV8M8Q=3wUpsfqxEisoyM-39sXo7Q)bEwT3*PgApttkZE1ThDx z23gsETJm4w6w1!D8h^GB zXZ$5FeLuw{>5i?R9q2t`SFYfow5O6SSd)1v!cJSo0-_UVfJxm52I2NFqU0oebbX%7 zph#viG&}rtc%Q@w^YqO$2?y&%<)epaQF{%!l|_aJR=`5(y_Ap2-HEus4qJVjU<2~5 z6N7hF?`TW>ldsFGDzdk4w(c7#y3)Ja-Q!l%;~XRAdFJ(M!sZ#Ppe8Q05-zYIbT}R! zWfbL%pxK&DSDD>R#~62p=t<+Lz$RYs4%}3`JD~en@T(YTO8L>$+G+REl0!?A6LbMt zt#9r*^wWn=6Octn^}WTZ%r3!NGn32F()U(txZ1v2-*~7gbq7T>ag19`gf}O6#pneq z$Frao+v{vr#tTMW|0sV(|DvM4q61(AP;^uxwItR#KrOFqyNmWuKkWjf+#1Wueqgir2vzT{xML#H|rlb4*oi<#m~9xNNg zG0L0Qt+ED{fu=87FIFFhGKq+qh`xh6oI^ts{g_zQ$}+*O={_PyXDz&KwgVH`6WwB| zZqBXlzB{nfx*ZpD%#KNS?jP%0DnY5^-rViuCSDx@C()zH5A}ETA=ScWjt5>pB!X7H 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ª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 z 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 { - font:12px/1.7 ui-monospace,SFMono-Regular,Consolas,monospace; + font:13px/1.7 ui-monospace,SFMono-Regular,Consolas,monospace; color:var(--text); background:var(--code); padding:3px 6px; @@ -782,7 +782,7 @@ main:focus { padding:21px 22px; overflow:auto; line-height:1.75; - font-size:12px; + font-size:13px; tab-size:2; scrollbar-width:thin; } @@ -842,7 +842,7 @@ main:focus { .prose table { border-collapse:collapse; width:100%; - font-size:12px; + font-size:13px; line-height:1.75; text-align:left; } @@ -1524,13 +1524,13 @@ dialog::backdrop { font-size:11px!important; } .prose { - font-size:13px; + font-size:15px; } .prose h2 { font-size:21px; } .prose pre { - font-size:11px; + font-size:12px; padding:17px; } .page-tools { @@ -1585,6 +1585,22 @@ dialog::backdrop { } @media print { + html[data-theme] { + --bg:#fff; + --soft:#f7f7f7; + --panel:#fff; + --text:#000; + --muted:#444; + --line:#bbb; + --accent:#111; + --tint:#f7f7f7; + --code:#f5f5f5; + color-scheme:light; + } + .code-block,.code-block code,.code-block code span { + color:#000!important; + background:transparent!important; + } .header,.sidebar,.toc,.page-tools,.page-pagination,.article-footer,.reading-progress,.heading-anchor,dialog,.toast,.back-top,.copy-code,.hero-art { display:none!important; } diff --git a/docs/site/assets/site.js b/docs/site/assets/site.js index 40e38ebc6..61ee57f65 100644 --- a/docs/site/assets/site.js +++ b/docs/site/assets/site.js @@ -93,6 +93,7 @@ let selected = 0; let searchOpener; function loadIndex() { + if (Array.isArray(window.PEBREL_DOCS_SEARCH)) return Promise.resolve(window.PEBREL_DOCS_SEARCH); if (!indexPromise) indexPromise = new Promise((resolve, reject) => { const script = document.createElement('script'); script.src = root + 'search-index.js'; @@ -168,6 +169,7 @@ searchDialog.addEventListener('click', event => { if (event.target === searchDialog) searchDialog.close(); }); input.addEventListener('input', renderResults); input.addEventListener('keydown', event => { + if (event.key === 'Escape') { event.preventDefault(); searchDialog.close(); return; } if (event.key === 'ArrowDown' || event.key === 'ArrowUp') { event.preventDefault(); selectResult(selected + (event.key === 'ArrowDown' ? 1 : -1)); } diff --git a/docs/site/build.py b/docs/site/build.py index be6925512..edc2e490e 100644 --- a/docs/site/build.py +++ b/docs/site/build.py @@ -101,10 +101,9 @@ def navigation(groups: list[dict], active: str, root: str) -> str: def home_header() -> str: - return '''

    PEBREL / USER GUIDE + return '''

    从一个终端开始。
    把工作连成一体。

    -

    本地命令、远程主机与 AI 工作流,在一个从容的空间里。
    从第一次打开,到找到属于你的工作方式。

    为你的桌面而来WindowsmacOS PreviewLinux Preview
    ''' @@ -112,8 +111,8 @@ def home_header() -> str: def source_details(page: dict, commit: str) -> str: sources = page.get("sources", []) links = "".join(f'
  • {html.escape(path)}
  • ' for path in sources) - return (f'
    内容核对来源 · {commit[:7]}' - f'

    此页依据 Pebrel {html.escape(page.get("version", "1.9.1"))} 的代码与已公开指南编写。不同平台的界面可能略有差异。

      {links}
    ') + return (f'
    版本与参考 · {commit[:7]}' + f'

    适用版本:Pebrel {html.escape(page.get("version", "1.9.1"))}。以下链接提供相关设置与功能的参考。

      {links}
    ') def build(destination: Path, base_url: str) -> dict: @@ -124,20 +123,19 @@ def build(destination: Path, base_url: str) -> dict: raise ValueError("Duplicate page slug") template = Template((HERE / "template.html").read_text()) destination.mkdir(parents=True, exist_ok=True) + shutil.copy2(REPO / "LICENSE", destination / "LICENSE") + shutil.copy2(HERE / "third-party-notices.txt", destination / "third-party-notices.txt") assets = destination / "assets" shutil.copytree(HERE / "assets", assets, dirs_exist_ok=True) shutil.copy2(REPO / "extra/logo/nebula.png", assets / "pebrel.png") screenshot_dir = assets / "screenshots" screenshot_dir.mkdir(exist_ok=True) + shutil.copy2(HERE / "screenshots.json", screenshot_dir / "sources.json") for filename in config["images"]: shutil.copy2(REPO / "docs/screenshots" / filename, screenshot_dir / filename) - formatter = HtmlFormatter() - (assets / "highlight.css").write_text( - formatter.get_style_defs(".code-block") + '\n' - '[data-theme=dark] .code-block .c,[data-theme=dark] .code-block .c1{color:#a1b4a4}\n' - '[data-theme=dark] .code-block .s,[data-theme=dark] .code-block .s1,[data-theme=dark] .code-block .s2{color:#abdab9}\n' - '[data-theme=dark] .code-block .k,[data-theme=dark] .code-block .nb{color:#94bbee}\n' - '[data-theme=dark] .code-block .nf,[data-theme=dark] .code-block .nv,[data-theme=dark] .code-block .o{color:#dadbbd}\n', encoding="utf-8") + light_css = HtmlFormatter(style="default", nobackground=True).get_style_defs("[data-theme=light] .code-block") + dark_css = HtmlFormatter(style="github-dark", nobackground=True).get_style_defs("[data-theme=dark] .code-block") + (assets / "highlight.css").write_text(light_css + "\n" + dark_css, encoding="utf-8") search = [] total_characters = 0 all_markdown = [] diff --git a/docs/site/check_browser.py b/docs/site/check_browser.py index fdc88ec1c..bb0d8073a 100644 --- a/docs/site/check_browser.py +++ b/docs/site/check_browser.py @@ -41,7 +41,13 @@ def check(site: Path, output: Path): page.locator('#search-input').fill('分屏') expect(page.locator('.search-result').first).to_be_visible() page.keyboard.press('Enter') - expect(page).to_have_url(__import__('re').compile('/pebrel/.*#')) + # Search may match a complete guide or a section within it. + expect(page).to_have_url(__import__('re').compile(r'/pebrel/[^#?]+/index\.html(?:#.*)?$')) + expect(page.locator('#article-content h2').first).to_be_visible() + page.keyboard.press('Control+k') + page.locator('#search-input').fill('字体') + page.keyboard.press('Escape') + expect(page.locator('#search-dialog')).not_to_be_visible() page.goto(base + 'quickstart/index.html') page.locator('.copy-code').first.click() expect(page.locator('.copy-code').first).to_have_attribute('data-copied', 'true') @@ -50,6 +56,8 @@ def check(site: Path, output: Path): expect(page.locator('html')).to_have_attribute('data-theme', 'dark') page.reload() expect(page.locator('html')).to_have_attribute('data-theme', 'dark') + dark_background = page.locator('.code-block').first.evaluate('el => getComputedStyle(el).backgroundColor') + assert all(int(channel) < 128 for channel in __import__('re').findall(r'\d+', dark_background)[:3]) page.screenshot(path=str(output / 'docs-dark.png'), full_page=True) page.locator('figure button').first.click() expect(page.locator('#image-dialog')).to_be_visible() diff --git a/docs/site/content/agent-worktrees.md b/docs/site/content/agent-worktrees.md new file mode 100644 index 000000000..72b95ace1 --- /dev/null +++ b/docs/site/content/agent-worktrees.md @@ -0,0 +1,61 @@ +## 为并行任务使用不同目录 + +两个 AI 工具同时修改同一目录,可能覆盖对方的文件。Git worktree 可以让它们使用同一仓库的不同工作目录与分支。 + +开始前保存当前文件,在源项目中运行 `git status`。先提交或妥善保存未提交改动,再创建新的工作目录。 + +## 使用 Pebrel 创建命名 Agent + +在本地 Pebrel 终端中运行: + +```sh +pebrel pane list +pebrel ctl describe --pretty +``` + +确认源窗格的 ID、所属窗口及当前运行时支持的 Agent 能力。假设窗口为 `1`、源窗格为 `17`,且 Codex 已安装: + +```sh +pebrel ctl agent-fork --window 1 --source-pane 17 --name docs-review --kind codex --pretty +``` + +把数字换成自己的列表结果。成功后,响应会给出创建的 worktree 和 Agent 信息,终端将在新目录中启动相应工具。 + +默认分支形如 `pebrel/docs-review`,工作目录位于主仓库旁的 `<仓库名>-worktrees/docs-review`。同名分支或目录已经存在时,改用新的任务名称,或先确认旧任务已不再使用。 + +## 核对目录再发任务 + +读取新 Agent: + +```sh +pebrel ctl agent-get --agent docs-review --pretty +``` + +检查返回的目录与分支,再发送一项任务: + +```sh +pebrel agent send docs-review "检查安装文档中的路径示例,列出需要修改的位置" --wait +pebrel agent read docs-review --lines 80 +``` + +任务完成后,进入这个 worktree 查看 `git diff`并运行相关检查。再按项目的 Git 工作流程提交和合并。 + +## 只需要手动建立 worktree + +也可以使用 Git 自带命令。在源仓库目录中运行下面的示例,再新建终端进入新目录: + +```sh +git worktree add ../my-project-docs -b docs/review +``` + +该命令会创建一个新分支和目录。检查成功后,在新终端中进入 `../my-project-docs`,启动已安装的 AI CLI。 + +## SSH 上的项目 + +Pebrel 的本机 Agent worktree 创建入口不替远端 SSH 会话建立工作目录。需要在服务器上隔离任务时,在服务器终端中使用它的 Git 命令,并选择服务器可写路径。 + +## 完成后清理 + +确认所有修改已提交或保存,并退出使用该目录的工具。先运行 `git worktree list`核对目录,再用 `git worktree remove 实际目录`移除不再使用的工作副本。 + +不要直接删除仍有未提交改动的目录。对话分叉只复制会话上下文,需要文件隔离时仍按本页建立 worktree。 diff --git a/docs/site/content/ai-history.md b/docs/site/content/ai-history.md new file mode 100644 index 000000000..b4011ad37 --- /dev/null +++ b/docs/site/content/ai-history.md @@ -0,0 +1,50 @@ +## 找到之前的对话 + +按 **Ctrl+Shift+O**(macOS 为 **⌘⇧O**)打开快速跳转,输入会话标题、项目目录或相关关键字。在历史结果中核对工具类型和目录,再选择要继续的会话。 + +Pebrel 会尝试使用工具的会话记录打开对话。CLI 出现后,确认上下文确实属于原任务,再输入新的问题。 + +当前已有受支持的 Claude Code 与 Codex 恢复流程。其他 CLI 的历史可以通过工具自己的恢复入口打开。 + +## 每次启动时自动接续 + +在 **设置 → 高级 → 会话生命周期**开启: + +- **启动时恢复上次标签**; +- **恢复时接续 AI 对话**。 + +正常退出后重开 Pebrel,检查对应终端是否恢复了原对话。需要原会话记录、有效的身份信息,以及可用的 CLI 安装。 + +## 恢复失败或需要选择会话 + +右键相关终端标签,使用当前可用的 **重试会话恢复**或 **选择要继续的对话…**。 + +先检查项目目录是否仍存在、CLI 是否需要重新登录,以及原工具的历史记录是否还在。记录不足时,可以打开工具自己的历史选择器查找;Pebrel 列表没有显示某条记录,并不意味着工具已经删除它。 + +## 从已有上下文分出新对话 + +在受支持的本地 Claude Code 或 Codex 会话中,右键标签选择 **分叉 AI 会话**。新会话从已有上下文开始,原对话继续保留。 + +这个入口要求 Pebrel 已识别工具和会话身份;SSH、自定义 Profile 或身份信息不完整时可能不显示。需要分叉时,先在受支持的本地 Shell 中建立会话。 + +对话分叉沿用上下文,但不会自动给代码建立独立工作目录。准备并行修改文件时,使用[Git worktree](agent-worktrees.md)。 + +## 使用已知会话 ID + +已经从工具取得有效 ID 时,也可以在相应环境中运行它的恢复命令。将 `SESSION_ID`换成真实值: + +```sh +claude --resume SESSION_ID +``` + +或: + +```sh +codex resume SESSION_ID +``` + +安装的 CLI 版本需要支持相应命令。CLI 报参数错误时,先查看该版本的帮助,而不是反复尝试同一命令。 + +## 备份对话 + +保存 Pebrel 布局或主机列表不会同时备份所有 CLI 的对话正文。换电脑或清理历史前,按工具自己的方式备份会话记录,并保留对应项目目录。 diff --git a/docs/site/content/ai-start.md b/docs/site/content/ai-start.md new file mode 100644 index 000000000..ed857f793 --- /dev/null +++ b/docs/site/content/ai-start.md @@ -0,0 +1,43 @@ +## 在项目目录启动工具 + +先按所用 CLI 的官方说明安装并登录。Claude Code、Codex 等工具分别管理自己的账户与网络连接,Pebrel 提供运行它们的终端。 + +1. 打开本地、WSL 或 SSH 终端。 +2. 用 `cd`进入准备处理的项目。 +3. 输入已安装的工具命令,例如 `claude`或 `codex`。 +4. 按工具提示完成登录和目录信任确认。 +5. 输入第一项任务,例如“介绍这个项目的目录结构,先不要修改文件”。 + +命令找不到时,在同一环境中检查安装。Windows 中安装的 CLI,不会自动变成 WSL 或服务器中的 Linux 程序。 + +
    Pebrel 分屏中运行多个 AI 命令行工具
    为不同任务使用独立窗格,可以同时查看各工具的输出。
    + +## 查看活动状态 + +Pebrel 会给识别到的 AI CLI 显示工具图标和活动状态。运行任务时可以切到其他标签,通过状态提示判断何时需要回来查看。 + +Windows 上可以在 **设置 → Agents**启用支持的集成,以获得更准确的任务事件。配置方式见[Agent 集成](hooks.md)。 + +出现需要权限、回答或确认的提示时,回到来源窗格阅读具体请求。任务回到空闲后,仍应查看工具输出和实际改动,确认结果符合需求。 + +## 将报错或截图加入对话 + +从终端选择报错文字,右键使用 **发送到聊天**,补充问题并选择目标工具。这样无需手动整理全部日志,见[发送到聊天](send-to-chat.md)。 + +工具支持图片输入时,复制截图并在其窗格中粘贴。Pebrel 会保存或上传图片并插入路径,随后按 CLI 的方式提交,见[图片](images.md)。 + +## 阅读较长的回答 + +可以直接在 CLI 中滚动和复制回答。需要按标题阅读长结果时,将回答保存为本地 `.md`文件,再从文件树打开,使用[文档阅读器](documents.md)的目录、代码复制和公式排版。 + +这套方式也适用于暂时没有集成事件的工具:保留原始 Markdown 内容,就能在文档标签中阅读。 + +## 同时处理多个任务 + +为不同任务新建窗格,先进入各自的项目目录,再启动 CLI。需要并行修改同一个 Git 仓库时,用独立 worktree 隔离文件,避免两个工具同时覆盖同一路径,见[隔离 AI 工作目录](agent-worktrees.md)。 + +每项任务结束后,查看版本控制面板中的 diff,运行相应测试,再决定是否提交。 + +## 退出后继续对话 + +用工具自己的退出方式结束会话。之后从[AI 会话历史](ai-history.md)查找;希望启动 Pebrel 时自动接续,可开启 **启动时恢复上次标签**和 **恢复时接续 AI 对话**。 diff --git a/docs/site/content/appearance.md b/docs/site/content/appearance.md new file mode 100644 index 000000000..c027bc5d6 --- /dev/null +++ b/docs/site/content/appearance.md @@ -0,0 +1,35 @@ +## 更换主题 + +打开 **设置 → 外观**,点击 **更换主题**。浏览或搜索主题,选择喜欢的配色,回到终端查看实际效果。 + +希望随系统切换深浅色时,开启 **跟随系统**。希望始终使用固定配色时,关闭它,再选择主题。 + +
    Pebrel 的主题配色示例
    选择主题后,可继续调整终端字体、光标和背景。
    + +## 调整界面大小 + +在 **外观 → 界面**中,**界面字号**用于设置侧栏、按钮和菜单的文字大小,**界面外观**用于选择“标准”或“紧凑”的留白。 + +终端输出太小时,调整 **终端字号**。希望一屏显示更多内容但仍容易阅读,可以先调整终端字号和字体间距,再决定是否缩小整个界面。 + +## 更换应用图标 + +点击 **更换图标**,查看并选择图标配色。图标与主题分别保存,切换终端主题不会强制改变图标。 + +应用内已经改变,但任务栏、Dock 或系统文件管理器仍显示旧图标时,可以退出并重开应用;系统图标缓存的刷新可能较晚。 + +## 更容易看清当前窗格 + +在外观的界面选项中开启非活动窗格调暗,让当前输入位置更明显。使用多个本地和 SSH 窗格时,可以结合[标签颜色与重命名](workspace.md)区分环境。 + +在 **光标**分组中选择条形、下划线、实心框或空心框。关闭 **光标闪烁**后,光标保持常亮。 + +## 标签关闭按钮与界面语言 + +**显示标签关闭按钮**控制标签上的关闭入口。关闭显示后,仍可使用鼠标中键、右键菜单或关闭快捷键。 + +在 **语言**选项中选择界面语言。终端程序的输出由各自的环境设置决定;未翻译的界面文字可能使用英文。 + +## 进一步定制 + +需要改文字颜色、ANSI 调色板或行高,见[创建和导入主题](themes.md)。需要调整中英文字体和连字,见[字体](fonts.md)。使用壁纸、透明度或窗口材质,见[背景](backgrounds.md)。 diff --git a/docs/site/content/backgrounds.md b/docs/site/content/backgrounds.md new file mode 100644 index 000000000..a9f580430 --- /dev/null +++ b/docs/site/content/backgrounds.md @@ -0,0 +1,38 @@ +## 设置一张背景图片 + +1. 打开 **设置 → 外观 → 自定义背景**。 +2. 在 **背景图片**中选择本机图片文件。 +3. 设置 **背景图像拉伸模式**和 **背景图像对齐**。 +4. 调低 **背景图像不透明度**,让文字不被图片干扰。 +5. 回到终端检查普通输出、彩色输出和选区的清晰度。 + +图片默认位于终端文字后方。要将图片延伸到标题栏和侧栏,开启相应的覆盖选项,并阅读确认提示。 + +## 选择铺放方式 + +| 模式 | 效果 | 适合的情况 | +| --- | --- | --- | +| **拉伸** | 铺满区域,可能改变图片比例 | 纹理或不怕变形的图案 | +| **适应** | 保持比例,完整显示,可能留空 | 希望看见整张图片 | +| **填充** | 保持比例铺满,可能裁剪边缘 | 壁纸铺满终端 | +| **原始尺寸** | 不缩放图片 | 按原图尺寸放置 | + +主体被裁掉时,在九个对齐位置中选择顶部、左侧、居中等位置,再调整窗口大小查看结果。 + +## 调整图片与终端透明度 + +**背景图像不透明度**越低,图片越淡。**终端正文不透明度**控制终端背景整体的不透明程度,100% 为完全不透明。 + +两者可以分别调整。例如,希望有一张浅淡壁纸、但不透出桌面,可以降低图片不透明度,同时把终端正文不透明度保持为 100%。设置页本身不会按终端正文透明度变化。 + +## 选择背景模糊 + +在 **外观 → 界面 → 背景模糊**中选择当前平台可用的窗口效果。Mica、Aero 和 Acrylic 等效果依赖 Windows 与系统环境,不同系统不会呈现完全相同的材质。 + +出现闪烁、文字难读或窗口拖动不流畅时,先选择“无”并提高不透明度,再逐项恢复效果。 + +## 更换或移除图片 + +重新选择其他图片可以替换背景;需要回到纯色效果时,点击 **背景图片**行的重置按钮移除图片,再选择主题背景色。 + +图片被移动、所在磁盘未挂载或路径失效时,重新选择可读取的文件。迁移到另一台电脑时,把图片素材单独复制过去,并更新路径。 diff --git a/docs/site/content/broadcast.md b/docs/site/content/broadcast.md new file mode 100644 index 000000000..597cefa88 --- /dev/null +++ b/docs/site/content/broadcast.md @@ -0,0 +1,28 @@ +## 同时向多个窗格输入 + +广播输入适合在多个终端中执行相同的查询,例如同时检查几台测试服务器的系统版本。开启后,同一终端标签页里的多个窗格会接收相同的键盘输入。 + +## 开启广播 + +1. 在一个标签页中建立至少两个终端窗格。 +2. 分别连接需要的主机,或切换到准备操作的目录。 +3. 检查每个窗格都停在可以接收命令的位置。 +4. 点击窗格标题栏中的广播输入按钮。 +5. 先输入一条无副作用的测试命令,例如 `echo broadcast-test`,确认各窗格都收到了它。 + +之后输入的字符和提交操作会同步到该标签的窗格。其他标签页不属于这次广播范围。 + +## 只在一个窗格继续操作 + +再次点击广播按钮,将其关闭。检查广播状态已取消后,再输入只针对一台主机的命令。 + +切换焦点只是更换当前窗格;需要结束同步输入时,应明确关闭广播,而不是只点击另一个窗格。 + +> [!WARNING] +> 广播开启时,输入密码、删除命令或生产环境操作可能同时发送给多个会话。开始单独认证、使用交互式菜单或处理不同环境前,先关闭广播。 + +## 图片粘贴 + +图片粘贴需要为目标环境保存或上传文件,不会按普通文本广播给所有窗格。需要给某个 AI 工具提供图片时,关闭广播,聚焦该工具所在窗格后单独粘贴。 + +广播中的某个程序已经退出或进入其他输入状态时,也先暂停广播,分别整理各窗格,再继续操作。 diff --git a/docs/site/content/clipboard.md b/docs/site/content/clipboard.md new file mode 100644 index 000000000..863c55aed --- /dev/null +++ b/docs/site/content/clipboard.md @@ -0,0 +1,42 @@ +## 选择终端输出 + +拖动鼠标选择一段文字;双击可选择一个词,三击可选择一行。按住 **Shift** 可以扩展已有选区。 + +Vim 等程序可能接管鼠标。需要复制它显示的文字时,按住 **Shift** 再拖动,使用终端自身的选区。 + +## 复制和粘贴文字 + +| 操作 | Windows / Linux | macOS | +| --- | --- | --- | +| 复制选区 | Ctrl+Shift+C | ⌘C | +| 粘贴剪贴板 | Ctrl+V 或 Ctrl+Shift+V | ⌘V | + +Windows / Linux 中,Ctrl+C 在存在选区时也会复制文字;没有选区时,它用于中断正在运行的程序。 + +粘贴前点击目标窗格。准备把命令发到服务器时,先确认焦点确实在对应 SSH 终端。 + +## 选中即复制和右键粘贴 + +打开 **设置 → 交互 → 鼠标与选区**,开启 **选中即复制**。之后鼠标选择结束时会复制选区,右键可以粘贴。需要使用常规右键菜单时,将这项设置关闭。 + +这个选项适合频繁从日志中复制文字;如果经常需要右键选择其他动作,保留默认交互会更方便。 + +## 粘贴多行命令 + +在 **设置 → 交互**开启 **粘贴前确认**。在普通 Shell 中粘贴多行或高风险内容时,检查确认框里的文本,再决定是否继续。 + +确认时留意三个位置:当前主机、当前目录,以及命令是否包含删除、提权或覆盖操作。多行文本送入 Shell 后,换行可能触发执行。 + +全屏程序和使用 bracketed paste 的程序会按各自的粘贴方式处理输入;不要把确认框当成所有应用都必定显示的步骤。 + +## 粘贴图片 + +复制一张图片后,在目标终端执行粘贴。Pebrel 会将图片保存为 PNG,再插入对应文件路径。检查输入区中的路径,按正在使用的工具要求提交。 + +在 WSL 或 SSH 中,路径需要指向该环境可访问的图片。SSH 传图依赖远端连接和传输成功;失败时先处理提示,再重试。图片是否显示为附件缩略图由接收的 CLI 决定。 + +关于图片预览、终端内嵌图像及清理缓存,见[图片](images.md)。 + +## 将输出交给 AI + +选择报错或日志,右键打开 **发送到聊天**,再选择目标 AI 窗格。这样可以直接携带选中的输出继续提问。具体示例见[发送到聊天](send-to-chat.md)。 diff --git a/docs/site/content/commands.md b/docs/site/content/commands.md new file mode 100644 index 000000000..ea43df9eb --- /dev/null +++ b/docs/site/content/commands.md @@ -0,0 +1,47 @@ +## 打开保存命令 + +点击工作区顶栏的**闪电图标**打开命令管理器。先点击准备接收命令的终端窗格,再打开管理器;选中的条目会发送到这个终端。 + +搜索框可以查找命令名称或命令文字。列表同时提供内置条目和你自己保存的条目。 + +## 保存第一条命令 + +例如,把检查 Git 工作区状态的命令保存下来: + +1. 点击 **新增命令**。 +2. **名称**填写“查看项目改动”。 +3. **命令**填写 `git status --short`。 +4. 暂时不勾选 **插入后立即按 Enter 执行**。 +5. 点击 **保存**。 + +回到一个 Git 项目的终端,再次打开管理器并选择这条命令。文字会插入输入区,你可以先检查目录,再按 Enter 执行。 + +## 插入文字,还是立即执行 + +| 使用方式 | 适合的条目 | +| --- | --- | +| 不勾选立即执行 | 需要补充参数、路径或检查后再运行的命令 | +| 勾选 **插入后立即按 Enter 执行** | 不需要补充参数的常用命令 | + +开启立即执行时,选择条目会同时发送回车。多行条目会将各非空行整理后用 `; ` 连接再执行;需要保留原始换行的脚本,请保存成脚本文件,或关闭立即执行后按目标程序的要求处理。 + +> [!WARNING] +> 开启立即执行的命令会在当前终端直接运行。对删除、部署或生产环境命令,建议保留插入后确认的方式。 + +## 用分组整理命令 + +点击 **新建分组**并输入名称,例如“项目开发”或“服务器维护”。打开命令条目的菜单,使用 **移到分组**选择目标分组。 + +进入一个分组后,可以使用 **返回全部命令**查看完整列表。将条目移出分组时选择 **移出分组**。选择 **删除分组,保留其中的命令**只会移除分组,命令仍可在列表中找到。 + +## 修改内置命令 + +内置命令提供 Git、Docker、Python 和常见开发工具的示例。要调整其中的参数,打开条目菜单,选择 **保存副本**,然后编辑自己的副本。 + +内置条目会根据当前终端环境筛选。使用前仍需在这个环境中安装相应工具,例如 Docker 命令需要 Docker 可用。 + +## 编辑和删除 + +从自己的命令条目菜单打开 **编辑命令**,修改名称、内容或执行方式后保存。删除不再使用的条目前,确认选中的是自己的那一条。 + +密码、Token 和临时验证码应在终端或凭据提示中输入,不要长期放进命令条目。迁移命令库时,见[备份与迁移](migration.md)。 diff --git a/docs/site/content/completions.md b/docs/site/content/completions.md new file mode 100644 index 000000000..55956b5d1 --- /dev/null +++ b/docs/site/content/completions.md @@ -0,0 +1,34 @@ +## 打开命令补全 + +在 **设置 → 终端**开启 **启用命令补全**。回到终端,在普通 Shell 提示符处输入命令或路径的开头,查看出现的建议。 + +补全会结合可用的历史记录和路径信息。第一次进入新环境、尚无相关历史时,建议可能较少。 + +## 选择建议的显示方式 + +在同一设置页中找到 **补全样式**: + +| 选项 | 显示方式 | +| --- | --- | +| **行内灰字** | 建议接在已输入内容后面,适合直接续写命令 | +| **弹窗列表** | 在输入附近列出候选项,适合查看不同选择 | + +两种样式使用同一补全功能。可以先试行内灰字;需要更明显的候选提示时,再切换列表样式。 + +## 接受一条建议 + +**补全接受键**可以设置为 **Tab**、**右方向键**或**Tab 或右方向键**。建议出现后,使用所选按键接入建议内容,再检查整条命令,按 Enter 执行。 + +如果你希望保留 Shell 自己的 Tab 补全,可以让 Pebrel 使用右方向键。更改后回到 Shell 提示符处试用,不必关闭整个窗口。 + +## 在不同环境使用 + +本地 Shell、WSL 与 SSH 会话各自使用对应环境的上下文。例如,WSL 项目中的 Linux 路径应在 WSL 窗格里输入,不要拿 Windows 路径来判断补全是否正确。 + +Vim、全屏程序或正在运行的 AI CLI 有自己的按键操作。需要检查 Pebrel 补全时,先退出到普通 Shell 提示符。 + +## 没有出现预期建议 + +先检查 **启用命令补全**是否打开,再确认当前输入位置是 Shell 提示符。输入一次完整命令、执行完成后,再输入相同前缀测试历史建议。 + +路径建议不符合当前目录时,运行 `pwd`(cmd 使用 `cd`)确认目录是否正确。出现两套重复建议时,可以关闭 Pebrel 补全或 Shell 插件中的一套。经常重复使用且不适合依赖历史的长命令,可以存入[保存命令](commands.md)。 diff --git a/docs/site/content/config-examples.md b/docs/site/content/config-examples.md new file mode 100644 index 000000000..c6a212767 --- /dev/null +++ b/docs/site/content/config-examples.md @@ -0,0 +1,104 @@ +## 在已有配置中加入示例 + +以下完整示例可单独用于一份 `pebrel.lua`。已经有配置时,只复制需要的赋值,并放在已有的 `return config`之前,不要重复创建多份配置对象。 + +修改后运行 `pebrel config check`。字段检查通过后,再新建终端验证启动相关设置。 + +## 字体、背景与回滚历史 + +```lua +local pebrel = require 'pebrel' +local config = pebrel.config_builder() + +config.font = { + normal = { family = 'Maple Mono NF CN', style = 'Regular' }, + size = 13.0, +} +config.window = { + opacity = 0.96, + padding = { x = 8, y = 8 }, +} +config.scrolling = { history = 10000 } + +return config +``` + +将字体名称改为当前电脑可用的字体。不透明度范围为 0–1,1 表示完全不透明。GUI 中已有相关偏好时,也检查 **设置 → 外观**是否覆盖了期望效果。 + +## 不同系统选择不同 Shell + +```lua +local pebrel = require 'pebrel' +local config = pebrel.config_builder() + +if pebrel.platform.os == 'windows' then + config.terminal = { + shell = { program = 'pwsh.exe', args = { '-NoLogo' } }, + } +else + config.terminal = { shell = '/bin/bash' } +end + +return config +``` + +该例要求 Windows 已安装 PowerShell 7,其他系统存在 `/bin/bash`。程序路径与参数分开填写;需要选择 WSL 或已识别 Shell 时,日常使用可以直接在 **设置 → 终端**中选择。 + +## 为新终端设置环境变量 + +```lua +local pebrel = require 'pebrel' +local config = pebrel.config_builder() + +config.env = { + EDITOR = 'nvim', + MY_PROJECT_ENV = 'development', +} + +return config +``` + +新建终端后,PowerShell 使用 `$env:MY_PROJECT_ENV`,Bash / Zsh 使用 `echo "$MY_PROJECT_ENV"`检查变量。 + +这些变量适合编辑器和项目标记,不适合写入准备公开分享的密钥或 Token。 + +## 单独保存配色模块 + +在主配置旁建立 `theme.lua`: + +```lua +return { + primary = { + background = '#161616', + foreground = '#e8e8e8', + }, +} +``` + +主文件 `pebrel.lua`: + +```lua +local pebrel = require 'pebrel' +local config = pebrel.config_builder() + +config.colors = require 'theme' + +return config +``` + +保存任一已加载模块后,查看重载结果。模块名不写 `.lua`后缀,文件位置保持在配置可查找的目录里。 + +## 清空 Profile 列表 + +显式空数组使用 `pebrel.array()`: + +```lua +local pebrel = require 'pebrel' +local config = pebrel.config_builder() + +config.profiles = pebrel.array() + +return config +``` + +普通 `{}`表示空对象,不能在需要数组的地方替代空列表。包含条目时,使用连续的 Lua 数组,参见[自定义启动入口](shells.md)。 diff --git a/docs/site/content/configuration.md b/docs/site/content/configuration.md new file mode 100644 index 000000000..bbc7139e4 --- /dev/null +++ b/docs/site/content/configuration.md @@ -0,0 +1,71 @@ +## 创建配置文件 + +主题、通知和 SSH 等常用设置可以直接在界面中完成。需要保存可复用的终端参数、环境变量或 Profile 时,可以创建 Lua 配置。 + +在可运行 Pebrel 命令的终端执行: + +```sh +pebrel config init --language zh-CN +pebrel config check +``` + +第一条生成带中文说明的配置,第二条检查语法与字段。初始化默认不会覆盖已有文件。需要英文说明时使用 `--language en-US`。 + +## 修改一个选项 + +打开生成的 `pebrel.lua`,保留开头的配置创建与结尾的 `return config`。例如: + +```lua +local pebrel = require 'pebrel' +local config = pebrel.config_builder() + +config.scrolling = { history = 10000 } +config.env = { EDITOR = 'nvim' } + +return config +``` + +这个示例设置终端历史行数和默认编辑器环境变量。`EDITOR='nvim'`不会安装程序;使用前仍需安装相应编辑器。 + +保存后再次运行 `pebrel config check`。检查通过,再新建终端查看需要在启动时生效的选项。 + +## 配置文件在哪里 + +标准数据目录为: + +| 系统 | 目录 | +| --- | --- | +| Windows | `%APPDATA%\Pebrel` | +| macOS | `~/Library/Application Support/Pebrel` | +| Linux | `$XDG_CONFIG_HOME/pebrel`,未设置时为 `~/.config/pebrel` | + +初始化时以命令输出的实际路径为准。便携配置、环境变量和显式参数也可能指定其他文件。 + +需要检查特定文件时运行: + +```sh +pebrel config check --config-file /path/to/pebrel.lua +``` + +将路径换成实际位置。这个检查命令不需要打开应用窗口。 + +## 指定另一套配置 + +启动参数 `--config-file`优先于 `PEBREL_CONFIG_FILE`环境变量,再往后才是标准位置的自动查找。使用 **PEBREL_CONFIG_DIR**可以指定独立配置与数据目录,适合隔离测试或便携使用。 + +旧的 `NEBULA_*`变量保留兼容。新旧文件并存时,Pebrel 名称的配置优先;同名配置中,Lua 优先于 TOML,再到旧的 YAML 格式。选中的文件有错误时,修复这份文件即可,不要期待自动换到另一份。 + +## 保存后重新加载 + +有效配置变更会自动重载。重载失败时,正在运行的应用保留上次有效配置;修正提示的行或字段后,再保存一次。 + +Shell、环境变量和回滚容量等启动相关设置,应在新窗格中验证。字体或颜色也可能受到界面偏好的覆盖;同时设置了两处时,先检查界面中是否已有对应覆盖项。 + +## 将配置拆成多个文件 + +主文件可使用 `require`读取旁边的 Lua 模块。例如,把配色放在 `theme.lua`,再在主文件中写 `config.colors = require 'theme'`。模块返回配置表即可;被加载的本地模块也参与重载。 + +更多可复制的例子见[配置示例](config-examples.md)。完整字段与加载规则见仓库的 [Lua 配置参考](https://github.com/Kuddev/pebrel/blob/9dc058d12765893553d5fc7a2c37c870c96168b0/docs/lua-configuration.md)。 + +> [!NOTE] +> Lua 配置会执行本地代码。使用他人提供的配置前,先阅读内容;GUI 的 `pebrel_settings.txt`使用另一套偏好键,不能直接当作 Lua 配置粘贴。 diff --git a/docs/site/content/documents.md b/docs/site/content/documents.md new file mode 100644 index 000000000..acd69fa26 --- /dev/null +++ b/docs/site/content/documents.md @@ -0,0 +1,43 @@ +## 打开 Markdown 文档 + +在[文件树](files.md)中选择 `.md`文件。文档会在标签页中打开,并显示标题、段落、列表、代码和支持的公式排版。 + +阅读视图可以选取和复制文字。需要修改文件时,打开文档工具栏的 **文档操作**(省略号),选择 **源码**。编辑步骤见[编辑 Markdown](markdown-editing.md)。 + +
    Pebrel 文档阅读器显示 Markdown 与数学公式
    Markdown 文档中的公式排版。
    + +## 按目录跳转 + +右侧栏的 **目录**按文档标题组织章节。点击标题可以跳到对应位置;长文档中,可折叠暂时不看的层级。 + +侧栏没有显示时,点击 **展开或收起右侧栏**按钮。文档没有 Markdown 标题时,目录会显示相应的空状态;可以在源码中用 `#`、`##`建立章节。 + +## 专注阅读 + +点击文档工具栏中的 **专注阅读**,为正文留出更多空间;再次使用对应入口退出。这个功能调整阅读布局,不会修改文档内容。 + +在普通代码文件中,类似位置可能显示系统全屏按钮,具体作用以按钮提示为准。 + +## 复制代码 + +将鼠标移到代码块,使用 **复制代码**。复制的是代码文本,不包含 Markdown 外层的反引号围栏。 + +语言选择器可以调整当前代码块的语法高亮,帮助阅读没有写明语言的代码。需要把语言永久写入文档时,在源码中修改代码围栏后面的语言名称并保存。 + +## 复制公式 + +在公式相关菜单中选择 **复制 LaTeX 源码**,可将表达式交给其他数学工具。公式已完整渲染且菜单提供图片复制时,可以选择 **复制公式图片**。 + +无法复制为图片时,先使用 LaTeX 源码,或简化不受支持的语法。关于文档中的公式写法,见[Markdown 编辑](markdown-editing.md)。 + +## 查看文件信息 + +右侧栏切换到 **文件信息**,查看文件类型、大小、修改时间、字符数、行数、编码和保存状态。 + +相关操作提供 **复制文件名**、**复制文件路径**、**在文件管理器中显示**、**用默认应用打开**与 **重新读取文件**。重新读取前先保存或复制仍需要保留的编辑内容。 + +## 远端文档和大文件 + +从 SFTP 打开的远端 Markdown 使用源码编辑,保存会写回原服务器,见[远端编辑](remote-edit.md)。 + +文件超过 **8 MB**或无法完整作为 UTF-8 文本编辑时,会显示只读或截断提示。要查看大文件全部内容,可以使用系统编辑器,或在终端用 `less`等工具按需读取。 diff --git a/docs/site/content/files.md b/docs/site/content/files.md new file mode 100644 index 000000000..ae0f6a5bc --- /dev/null +++ b/docs/site/content/files.md @@ -0,0 +1,49 @@ +## 打开项目文件 + +先在终端进入项目目录,再按 **Ctrl+Shift+F**(macOS 为 **⌘⇧F**)打开文件树。展开文件夹,选择要查看的文件。 + +文本文件可以在编辑器中打开,Markdown 默认以排版后的阅读视图打开。聚焦内置 SSH 会话时,文件面板显示对应的[SFTP 远端文件](sftp.md)。 + +## 跟随终端目录 + +在终端执行 `cd`切换目录后,文件树可使用终端上报的目录。手动浏览过其他位置时,点击 **跟随当前终端并刷新**,或使用按钮提示的 **Alt+R**,回到当前终端目录。 + +读取失败时先看面板里的路径和错误提示。旧目录可能仍显示在面板中,修复路径或权限后再刷新。 + +## 按名称找文件 + +在文件树搜索框输入文件或文件夹名称。按需要切换以下选项: + +| 选项 | 使用场景 | +| --- | --- | +| **区分大小写** | 区分 `README`与 `readme` | +| **全词匹配** | 按完整词匹配,而不是任意部分字符 | +| **使用正则表达式** | 用模式匹配文件名,例如 `\.md$` | + +搜索用于查找名称。要查找文件里面的文字,可以在终端使用已安装的搜索工具,例如: + +```sh +rg "TODO" . +``` + +出现扫描限制或目录权限提示时,先缩小到相关项目目录,再搜索。 + +## 从文件夹新建终端 + +右键目标文件夹,选择 **在此处打开终端**,或使用面板的 **在此新建终端**入口。新终端打开后运行 `pwd`检查位置;cmd 使用 `cd`。 + +WSL 目录会使用适合该环境的路径。需要把文件路径交给 Linux 命令时,使用菜单中的 **复制 Linux 路径**。 + +## 复制路径或使用系统应用 + +文件或目录菜单提供 **复制路径**、**打开**以及在系统文件管理器中显示的入口。要把路径放进命令时,粘贴后检查路径中是否有空格,并按 Shell 需要添加引号。 + +文件不适合用内置编辑器处理时,可以在系统文件管理器中打开,或使用文件信息中的 **用默认应用打开**。 + +## 从项目中忽略或删除文件 + +在 Git 项目里,**加入 .gitignore**可为不需要跟踪的文件添加忽略规则。已经被 Git 跟踪的文件,仍需按 Git 的规则处理;忽略规则不会从历史提交中移除内容。 + +选择 **删除**后,阅读 **移入回收站**确认框,核对文件名和路径。批量处理前先确认没有选错项目目录;操作失败时按系统提示检查权限或回收站支持情况。 + +查看改动和提交文件,见[版本控制](vcs.md)。 diff --git a/docs/site/content/fonts.md b/docs/site/content/fonts.md new file mode 100644 index 000000000..d3e63fe72 --- /dev/null +++ b/docs/site/content/fonts.md @@ -0,0 +1,41 @@ +## 放大终端文字 + +打开 **设置 → 外观 → 终端外观**,调整 **终端字号(Ctrl+滚轮缩放)**。可以使用加减按钮,也可以在终端按 Ctrl+滚轮缩放。 + +键盘缩放使用 **Ctrl++ / Ctrl+-**,macOS 使用 **⌘+ / ⌘-**;**Ctrl+0 / ⌘0**重置缩放。 + +按钮或侧栏文字太小时,调整同页 **界面**分组中的 **界面字号**,它不会改变终端输出大小。 + +## 选择英文终端字体 + +在 **英文终端字体**中打开字体列表,查找已安装的字体。字体组按顺序查找字形:第一项优先,缺少字符时使用后面的字体。 + +选择后查看数字、标点、代码缩进和表格边框。终端使用等宽网格,等宽字体更适合保持这些内容对齐。 + +刚安装的字体没有出现时,重新打开字体列表;仍找不到则重启 Pebrel。使用系统显示的字体族名称,而不是字体文件名。 + +## 单独设置中文字体 + +在 **中文终端字体**输入字体名称。多个候选用逗号分隔,按 **Enter**或离开输入框后生效。留空时使用内置的 Maple Mono NF CN 回退。 + +修改后同时检查中文、英文和全角标点。只有中文缺字时,优先检查中文字体和回退列表,不必更换整个界面主题。 + +## 连字和字符间距 + +**字体连字**可选择 **开启**、**关闭**或 **跟随主题**。字体支持时,`->`、`!=`等字符组合会以连字显示,选项会立即应用到已打开的终端。 + +**字体间距**可选 **紧凑**或 **宽松**,用于调整终端字符的列宽。小字号下字符挤在一起时,可以试用宽松;需要更细的纵向调整时,在[主题编辑器](themes.md)设置行高。 + +## 中文粗体看不清 + +打开 **设置 → 交互**,调整 **中日韩粗体提亮**。它让相关字符通过提亮表现粗体,拉丁字符仍按自身字体处理。使用中英文混排的实际输出检查结果。 + +## Powerline 箭头显示成方框 + +在 **外观 → 终端外观**中开启 **Powerline 提示符**后,字体需要包含 Powerline 字形。出现方框时,改用具备这些字形的字体,或先关闭该选项。 + +**启动欢迎信息**会在新会话通过 fastfetch 显示系统信息。不需要启动摘要时,将它关闭即可;此项与字体设置独立。 + +## 排查错位或模糊 + +先恢复默认字体与字号,再关闭连字、改回纯色背景,逐项恢复自己的设置。仍有问题时,反馈系统缩放比例、字体名称、字号、字体间距模式,以及能看出错位的截图。 diff --git a/docs/site/content/git-conflicts.md b/docs/site/content/git-conflicts.md new file mode 100644 index 000000000..1deb8b7f2 --- /dev/null +++ b/docs/site/content/git-conflicts.md @@ -0,0 +1,47 @@ +## 打开冲突文件 + +Git 合并、拉取或变基后出现冲突时,在版本控制面板的 **合并冲突**区域找到文件,选择 **在三栏合并器中解决**。 + +编辑器会打开三列:左侧 **当前版本**,中间 **合并结果(可编辑)**,右侧 **传入版本**。 + +## 合并需要保留的内容 + +先比较左右两边,然后在中间结果栏整理最终内容。通常需要同时保留双方不同位置的修改,而不是直接选择一整边。 + +冲突标记形如: + +```text +<<<<<<< 当前版本 +这一侧的内容 +======= +另一侧的内容 +>>>>>>> 传入版本 +``` + +保留正确内容后,删除这些标记行。结果中仍有冲突标记时,页面会显示 **仍有冲突标记**,应用按钮不可用。 + +## 采用一侧的完整版本 + +确定整个文件应使用一侧内容时,可以点击该侧的箭头按钮:**用当前版本替换合并结果**,或 **用传入版本替换合并结果**。 + +这会替换中间结果的完整内容,不是只接受光标附近的一小段。操作前留意中间已经手动整理的修改。 + +Git 变基时,两侧版本的角色容易与直觉不同。以实际文件内容和正在执行的 Git 操作为准,不能只根据“当前”两个字决定保留哪边。 + +## 应用并暂存 + +1. 检查中间结果,确认冲突标记已经全部清除。 +2. 点击 **应用并暂存**。 +3. 等待状态显示 **已写回并暂存**。 +4. 返回版本控制面板,检查这个文件不再列为未解决冲突。 +5. 运行项目测试或检查命令,然后完成原来的 Git 操作。 + +“应用并暂存”会保存文件并执行对应的暂存操作,不会自动替你完成整个合并或变基。 + +在终端运行 `git status`查看下一步提示。如果当前正在变基,按 Git 提示执行 `git rebase --continue`;普通合并则按当前仓库状态完成提交。 + +## 需要重新读取时 + +文件被其他工具修改,或冲突状态发生变化时,可以点击 **重新读取冲突阶段**。先复制中间尚未保存的内容,以便比较或恢复。 + +二进制文件和超出合并器文本大小限制的文件,需要使用相应的外部工具处理。某一侧显示“文件不存在”时,还要决定是否保留该文件;删除类冲突应结合 `git status`提示处理。 diff --git a/docs/site/content/hooks.md b/docs/site/content/hooks.md new file mode 100644 index 000000000..bf997a178 --- /dev/null +++ b/docs/site/content/hooks.md @@ -0,0 +1,40 @@ +## 启用常用工具的集成 + +**自动本地 Hook 设置目前在 Windows 提供。** Hook 是工具在开始、结束或需要关注时发出的事件,Pebrel 用它更新对应窗格的活动提示。 + +1. 安装需要使用的 CLI,并启动一次完成初始配置。 +2. 打开 **设置 → Agents**。 +3. 刷新检测结果,找到正在使用的工具。 +4. 启用对应集成;出现需要修复或缺少配置的提示时,按该项提示处理。 +5. 退出并重新启动这个 CLI。 +6. 提交一个短任务,检查状态和来源窗格是否对应。 + +只需开启自己使用的工具,不必把所有检测项都配置一遍。 + +## 支持的设置入口 + +Agent 设置提供 Claude、Codex、OpenCode、Cursor、Kimi、Pi、OhMyPi、Copilot 与 Grok 等入口。不同工具能提供的事件和历史能力不同;Claude Code 与 Codex 的恢复流程见[AI 会话历史](ai-history.md)。 + +
    Pebrel 侧栏显示 AI 终端的图标和状态
    从侧栏查看各终端的活动状态。
    + +## 工具没有被检测到 + +先在准备使用它的终端中运行工具命令。若命令也找不到,修复安装和 PATH;若命令可用,再刷新 Agent 设置。 + +检查安装的是目标 CLI。例如,Cursor 桌面程序的启动命令不一定就是 Cursor Agent CLI。工具刚升级过时,重新启动 Pebrel 和 CLI 可以清除旧的检测与运行状态。 + +## 收不到任务通知 + +先确认 CLI 已在启用集成后重启,再检查 **设置 → 终端 → 提醒**中的通知选项。任务状态能够更新但卡片没有显示时,通常应继续检查通知显示设置,而不是重新安装 CLI。 + +通知时间、点击跳回来源和系统通知见[通知](notifications.md)。 + +## 关闭集成 + +在 **设置 → Agents**关闭该工具的集成,再重启工具。关闭后仍可在终端正常运行 CLI;活动提示会取决于剩余可用的检测信息。 + +## macOS、Linux、WSL 与 SSH + +macOS 和 Linux 可以正常运行已安装的 AI CLI,但不提供 Windows 的同一套本地自动 Hook 设置入口。 + +WSL 和 SSH 中的工具有各自的安装目录和配置。Windows 本地检测通过时,还需在实际运行工具的环境中确认它是否可用;不要在另一台主机的设置目录里寻找本机配置。 diff --git a/docs/site/content/images.md b/docs/site/content/images.md new file mode 100644 index 000000000..c0deaef4e --- /dev/null +++ b/docs/site/content/images.md @@ -0,0 +1,41 @@ +## 预览图片文件 + +从文件树选择图片,可以查看支持格式的预览。常见格式包括 PNG、JPEG、WebP、GIF 和 BMP;超出大小限制或解码失败时,可使用系统默认应用打开。 + +PDF 提供首页缩略图,适合辨认文件。需要翻页、批注或编辑时,使用 PDF 阅读器。Linux 的 PDF 缩略图依赖可用的 `pdftoppm`。 + +## 把剪贴板图片交给命令行工具 + +1. 复制图片本身,例如截图结果,而不是图片文件名。 +2. 点击准备接收图片的终端窗格。 +3. 按 **Ctrl+V / ⌘V**粘贴。 +4. 等待 PNG 保存或远端上传完成。 +5. 检查插入的文件路径,再按工具的要求提交。 + +Pebrel 会生成图片文件并插入路径。AI CLI 是否把路径显示为附件缩略图,取决于它自己的图片输入功能。 + +剪贴板同时包含非空文字时,可能优先粘贴文字。看到意外文本时,先撤回或清空输入,再重新复制图片。 + +## 在 WSL 或 SSH 中粘贴 + +WSL 使用转换后的 Linux 可访问路径。原生 SSH 会话需要先把图片传到远端,再插入远端路径;传输失败时先修复连接或权限。 + +同一张本机图片需要发给不同主机时,分别聚焦对应窗格再粘贴。图片不参与[广播输入](broadcast.md)。 + +## 在终端输出里显示图片 + +前台程序输出 Pebrel 支持的 **OSC 1337**图像协议时,终端可以内嵌显示图片。仅打印一个 `.png`路径不会自动变成图像。 + +需要使用这一方式时,选择能够输出相应协议的命令行工具,并按其说明配置。普通图片浏览优先使用文件预览,不必自己编写转义序列。 + +## Markdown 中的图片 + +本地 Markdown 可以引用可访问的图片,路径相对文档位置。比如 `![截图](images/example.png)`要求文档旁有 `images/example.png`。 + +图片缺失时,先在文件树检查目标文件,不要仅修改显示文字。远端 Markdown 编辑不会自动把所有关联图片下载到本地阅读器。 + +## 清理粘贴产生的文件 + +图片粘贴后,可以从插入的路径找到副本。不再需要时按该位置删除;远端副本需要在服务器上清理。 + +发送前检查截图中是否包含密码、Token 或私人信息。删除本机副本不会撤回已经交给远端服务器或 AI 服务的内容。 diff --git a/docs/site/content/index.md b/docs/site/content/index.md index 4e0a2671a..8bba824c3 100644 --- a/docs/site/content/index.md +++ b/docs/site/content/index.md @@ -1,33 +1,28 @@ -## 一个工作空间,更多可能 - -不必一次学会所有功能。从熟悉的命令行开始,再逐步加入远程连接、分屏与 AI 工具。 +## 开始使用 -## 先认识 Pebrel - -Pebrel 是桌面终端应用。它把本地 Shell、SSH 会话、文件浏览和 AI 命令行工具放在同一个原生窗口中。你仍然使用自己熟悉的命令、开发工具与账户。 - -
    Pebrel 中的顶部标签页与终端工作区
    Pebrel 的终端工作区。图片来自项目已公开的应用截图,外观可能与当前平台或主题不同。点击可放大。
    - -**标签页**用于分开不同工作,**窗格**用于并排查看,**SSH 主机**用于连接远程环境。AI CLI 是你自行安装的命令行工具,不是文档网站提供的在线聊天服务。 - -## 按你现在要做的事开始 - -第一次使用,请先阅读[快速开始](quickstart.md)。需要挑选系统或处理首次启动,请看[安装与平台支持](installation.md)。 - -> [!NOTE] -> 本指南对应 Pebrel **1.9.1** 的上游代码。Linux 与 macOS 仍标为 Preview,部分桌面集成仅在 Windows 提供。请以各页的平台提示为准,而不是假设所有按钮在每个系统都存在。 - -## 如何使用这份指南 - -按左侧目录阅读,或按 Ctrl / ⌘ + K 搜索。搜索在你的浏览器内完成,不会把查询发送给远程搜索服务。 - -每篇指南右侧列出当前页目录。代码示例可以复制;正文可以复制或保存为 Markdown。点击截图可放大;右上角可切换深浅主题。手机上使用右上角菜单打开章节目录。 - -页面底部的“内容核对来源”提供对应代码的位置。通常无需阅读这些技术资料,也能完成正文中的操作。 +## 常用操作 + +| 想完成的操作 | 使用指南 | +| --- | --- | +| 安装 Pebrel,或选择适合电脑的版本 | [安装与平台支持](installation.md) | +| 一边运行服务,一边输入其他命令 | [标签页与分屏](workspace.md) | +| 下次打开时恢复标签和目录 | [会话保存与恢复](sessions.md) | +| 重复使用一组终端布局 | [布局配方](layouts.md) | +| 找到并修改项目文件 | [文件浏览](files.md) · [Markdown 编辑](markdown-editing.md) | +| 查看改动、提交代码和处理冲突 | [Git 提交](vcs.md) · [解决冲突](git-conflicts.md) · [SVN](svn.md) | +| 将文件传到服务器 | [SFTP 文件传输](sftp.md) | +| 重新打开上次的 AI 对话 | [AI 会话历史](ai-history.md) | +| 更改快捷键或通知时间 | [快捷键](keyboard.md) · [通知](notifications.md) | +| 备份设置,或迁移到另一台电脑 | [备份与迁移](migration.md) | +| 处理无法启动、连接或保存的问题 | [故障排查](troubleshooting.md) | + +
    Pebrel 的顶部标签栏与终端工作区
    终端工作区。截图中的主题和窗口装饰可能因平台而不同。
    + +本指南适用于 **Pebrel 1.9.1**。macOS 和 Linux 安装包目前标为 Preview;平台差异见[安装与平台支持](installation.md)。 diff --git a/docs/site/content/installation.md b/docs/site/content/installation.md index 47283efbb..4804ac32a 100644 --- a/docs/site/content/installation.md +++ b/docs/site/content/installation.md @@ -1,89 +1,83 @@ ## 选择安装包 -只从 [Pebrel 官方发布页](https://github.com/Kuddev/pebrel/releases/latest)下载你要安装的版本。文件名中的系统与架构必须和你的机器相符。 +打开 [Pebrel Releases](https://github.com/Kuddev/pebrel/releases)。本指南对应 **1.9.1**,安装包名称包含版本、系统和处理器类型。 -| 系统 | 架构 | 安装包 | 当前状态 | -| --- | --- | --- | --- | -| Windows 10 1809+ / Windows 11 | x64 | 安装程序 `.exe`、便携 `.zip` | 正式平台 | -| macOS,部署目标 14+ | Apple Silicon / arm64 | `.dmg` | Preview | -| macOS,部署目标 14+ | Intel / x64 | `.dmg` | Preview | -| Linux,glibc 2.35+ | x64 | `.deb`、`.AppImage`、便携 `.tar.gz` | Preview | - -例如,Windows 安装程序的命名形式为 `Pebrel-v<版本>-windows-x64-setup.exe`。macOS 与 Linux 预览包的文件名含 `-preview`。 +| 电脑 | 选择的包 | 系统要求 | +| --- | --- | --- | +| Windows,Intel / AMD 64 位处理器 | `windows-x64-setup.exe` 或 `windows-x64.zip` | Windows 10 1809+ / Windows 11 | +| Windows,ARM 处理器 | `windows-arm64.zip` | 使用 ARM64 对应包 | +| Mac,Apple 芯片 | `macos-arm64-preview.dmg` | 构建目标为 macOS 14+ | +| Mac,Intel 处理器 | `macos-x64-preview.dmg` | 构建目标为 macOS 14+ | +| Linux,Intel / AMD 64 位处理器 | `linux-x64-preview.deb`、`.AppImage` 或 `.tar.gz` | glibc 2.35+ | -> [!NOTE] -> macOS 的部署目标不等于每个旧系统版本都已完成实机验证;项目的原生 macOS CI 在 macOS 15 上运行。遇到平台问题时,请一并提供系统版本与处理器架构。 +在 Mac 的 **苹果菜单 → 关于本机** 中可以查看芯片类型。`x64` 指 64 位 Intel / AMD,不是 32 位 x86。macOS 和 Linux 当前提供 Preview 包;macOS 构建目标为 14+,发布 CI 在 macOS 15 上验证。 ## Windows ### 使用安装程序 -1. 下载对应版本的 `-setup.exe`。 -2. 运行安装程序,按提示完成安装。默认是当前用户安装,通常位于 `%LOCALAPPDATA%\Programs\Pebrel`。 -3. 从开始菜单启动 Pebrel。 +1. 下载名称以 `windows-x64-setup.exe` 结尾的文件。 +2. 运行安装程序,按页面提示选择安装位置并完成安装。 +3. 从开始菜单或安装完成后的入口启动 Pebrel。 +4. 看到终端提示符后,输入 `echo Hello, Pebrel` 检查运行情况。 -### 使用便携包 +### 使用便携版 -完整解压 ZIP 到可写的文件夹,再运行 `pebrel.exe`。不要只取出 EXE;打包目录中的附带文件需要保留。 +1. 下载对应架构的 ZIP 文件。 +2. **完整解压**到一个可写目录。 +3. 进入解压后的目录,运行 `pebrel.exe`。 -便携版更新时先退出应用,再完整替换程序包。安装版与便携版的更新方式不同;没有安装器标记的便携目录不使用 Windows 安装器自动覆盖。 +保留与可执行文件一起提供的目录和资源;不要在压缩包预览窗口里直接启动,也不要只复制一个 EXE。需要随身携带配置时,参阅[配置文件](configuration.md)和[备份与迁移](migration.md)。 ## macOS -1. 在“关于本机”中确认是 Apple 芯片还是 Intel 处理器。 -2. 下载对应架构的 DMG,打开并把 Pebrel 拖到 **应用程序**。 -3. 从“应用程序”启动,而不是一直从挂载的 DMG 中运行。 +1. 下载 Apple Silicon(arm64)或 Intel(x64)对应的 DMG。 +2. 打开 DMG,将 **Pebrel** 拖入 **Applications/应用程序**。 +3. 弹出 DMG,然后从“应用程序”启动 Pebrel。 -预览构建采用临时签名,首次启动可能被系统阻止。确认文件来自官方发布页后,前往 **系统设置 → 隐私与安全性**,使用系统提供的 **仍要打开**,然后再次确认。不要关闭系统整体安全检查来绕过来源核验。 +如果系统拦截首次启动,先确认安装包来自项目官方 Release,再打开 **系统设置 → 隐私与安全性 → 仍要打开**,按系统提示确认。无需为此全局关闭 Gatekeeper。 -如果仍无法启动,记录 macOS 版本、芯片类型、下载的完整文件名及错误提示,再提交问题。 +
    Pebrel 1.9.1 在 macOS Apple Silicon 发布 CI 中启动后的真实窗口
    1.9.1 发布 CI 中安装并启动的 macOS 版本。
    ## Linux -### Debian / Ubuntu 系列 +### Debian / Ubuntu 安装包 -在下载目录打开终端,将文件名替换为你实际下载的 DEB: +在下载目录打开终端,执行: ```sh -sudo apt install ./Pebrel-v版本-linux-x64-preview.deb +sudo apt install ./Pebrel-v1.9.1-linux-x64-preview.deb ``` +安装完成后,从应用菜单打开 Pebrel。使用 `apt install` 安装本地 DEB,可同时处理发行版提供的依赖。 + ### AppImage ```sh -chmod +x Pebrel-v版本-linux-x64-preview.AppImage -./Pebrel-v版本-linux-x64-preview.AppImage +chmod +x Pebrel-v1.9.1-linux-x64-preview.AppImage +./Pebrel-v1.9.1-linux-x64-preview.AppImage ``` -若系统缺少 AppImage 所需的运行支持,请按发行版说明配置,或改用 DEB / 便携包;不要把所有启动问题都当作 Pebrel 配置错误。 - -### 便携包 +如果提示缺少 FUSE,请按照你的发行版说明安装兼容组件,或改用 DEB / TAR.GZ 包。 -解压整个 `.tar.gz`,保留原有目录结构,通过包内的 **`AppRun`** 启动。不要只复制底层可执行文件,否则可能丢失启动器负责配置的运行路径。 +### TAR.GZ 便携包 -### 保存 SSH 凭据 +将下载包解压,进入其中的目录后运行 `./AppRun`。保留解压后的完整目录,启动器需要读取随包资源。 -Linux 上保存凭据需要可用且已解锁的 Secret Service;还需要 `libsecret-tools`。无法访问桌面密钥环时,可以先不保存密码而进行连接,不必把密码写进共享配置文件。 +## 平台功能差异 -## 各平台有什么不同 - -| 能力 | Windows | macOS Preview | Linux Preview | +| 功能 | Windows | macOS | Linux | | --- | --- | --- | --- | -| 终端、分屏、SSH、SFTP、文件与文档界面 | 支持 | 支持 | 支持 | -| 托盘与关闭窗口后后台驻留 | 支持 | 不提供 | 不提供 | -| 全局快速终端热键 | 支持 | 不提供 | 不提供 | -| 自动本地 AI hook 设置 | 支持 | 不提供 | 不提供 | -| 系统通知与系统凭据存储 | 支持 | 支持 | 支持;凭据依赖桌面服务 | -| 应用内安装更新 | 安装版支持 | 应用包更新路径已实现 | 手动安装新包 | - -此表依据 1.9.1 的平台能力与更新安装代码,不把未来计划或未合并的改动算作已支持。 - -## 从旧名称 Nebula 迁移 +| 本地终端、标签页、分屏、SSH、SFTP | 支持 | 支持 | 支持 | +| 系统通知 | 支持 | 支持 | 支持,取决于桌面环境 | +| 关窗保留后台会话、托盘、全局快速终端 | 支持 | 暂无 | 暂无 | +| 本地 AI Hook 自动设置 | 支持 | 暂无 | 暂无 | +| 应用内更新安装 | Windows 安装版 | 已有更新安装入口,参见更新页 | 手动更新 | -Pebrel 保留对部分旧配置名称的兼容。在新位置没有相应文件时,会尝试迁移旧设置;**已有的新文件不会被覆盖**,旧文件会保留。 +Linux 保存密码依赖可用且已解锁的系统凭据服务。macOS 使用系统钥匙串。有关认证方式,见[SSH 认证](ssh-auth.md)。 -迁移前退出旧应用并备份设置与 SSH 主机信息。安装新版后,检查字体、主题、默认 Shell 与主机列表是否符合预期,再决定是否删除旧程序。不要在确认迁移成功之前清理旧数据。 +## 已经安装过 Nebula -## 下一步 +Pebrel 是项目更名后的名称。首次运行会尝试迁移旧版配置,保留原文件且不覆盖已有 Pebrel 数据。先备份旧配置,再安装新版本;具体数据位置与迁移步骤见[备份与迁移](migration.md)。 -按照[快速开始](quickstart.md)打开终端并创建第一个分屏。若只是想修改外观,先使用设置界面,不需要编写配置文件。 +无法出现窗口、资源报错或 Shell 启动失败时,见[故障排查](troubleshooting.md)。 diff --git a/docs/site/content/interaction.md b/docs/site/content/interaction.md new file mode 100644 index 000000000..6d5351288 --- /dev/null +++ b/docs/site/content/interaction.md @@ -0,0 +1,49 @@ +## 调整鼠标操作 + +打开 **设置 → 交互 → 鼠标与选区**。 + +**选中即复制**开启后,松开鼠标时自动复制,右键直接粘贴。经常使用右键“发送到聊天”时,可以关闭它,保留常规菜单。 + +**焦点跟随鼠标**开启后,鼠标移到窗格会改变输入焦点。希望明确点击后才切换输入目标时,将它关闭。多个 SSH 窗格并排时,输入前注意焦点位置。 + +**粘贴前确认**用于在普通 Shell 粘贴多行或高风险文本前显示确认。具体规则和快捷键见[剪贴板](clipboard.md)。 + +## 调整侧栏宽度 + +开启 **拖拽调节侧栏宽度**,再拖动侧栏与工作区之间的分隔线。需要固定宽度、防止误拖时,将此项关闭。 + +分隔线无法拖动时,先检查这个开关。终端内的分屏分隔线与侧栏宽度分别调整。 + +## 更改标签页布局 + +在 **标签与窗口**分组中: + +| 设置 | 可选方式 | +| --- | --- | +| **标签栏位置** | 左侧边栏 / 顶部 | +| **标签展开动效** | 滑动 / 立即 | +| **新标签位置** | 当前标签之后 / 列表末尾 | + +需要减少移动效果时,把标签展开动效改为“立即”。新标签位置影响之后新建的标签,不会把已有标签全部重新排序。 + +显示关闭按钮的设置在 **外观**页;关闭显示后仍可使用菜单、中键或快捷键关闭标签。 + +## 再次启动 Pebrel 时打开哪里 + +**新建实例行为**可选择创建新窗口、附加到最近使用的窗口,或附加到此桌面最近使用的窗口。 + +经常从项目目录启动 Pebrel 时,选择附加到已有窗口可以集中管理标签;需要每个项目独立窗口时,选择创建新窗口。 + +关窗后的后台运行、登录自启动和标签恢复在 **设置 → 高级**中配置,见[会话保存与恢复](sessions.md)。 + +## 版本控制与中文粗体 + +**侧栏版本控制**可设为自动检测、仅 Git 或仅 SVN。切换后进入相应项目目录并打开版本控制面板。 + +**中日韩粗体提亮**控制中文等相关字符的粗体呈现方式。需要调整字体本身时,转到 **外观 → 终端外观**。 + +## 恢复默认设置 + +设置页底部选择 **恢复默认设置**,阅读确认范围后继续。此操作恢复设置和快捷键、备份原设置,并保留 SSH 主机、凭据和历史。 + +只需要改回一个选项时,优先调整该项,避免重置其余个性化设置。 diff --git a/docs/site/content/keyboard.md b/docs/site/content/keyboard.md new file mode 100644 index 000000000..8b7f4a459 --- /dev/null +++ b/docs/site/content/keyboard.md @@ -0,0 +1,51 @@ +## 常用操作 + +下表列出默认按键。**⌘**是 Command,**⇧**是 Shift,**⌥**是 Option。已经自定义过快捷键时,以 **设置 → 按键映射**中显示的内容为准。 + +| 操作 | Windows / Linux | macOS | +| --- | --- | --- | +| 新建标签页 | Ctrl+Shift+T | ⌘T | +| 新建窗口 | Ctrl+Shift+E | ⌘N | +| 关闭当前项 | Ctrl+Shift+W | ⌘W | +| 打开设置 | Ctrl+, | ⌘, | +| 显示或隐藏侧栏 | Ctrl+Shift+B | ⌘B | +| 命令面板 | Ctrl+Shift+P | ⌘⇧P | +| Shell 选择器 | Ctrl+K | ⌘K | +| 快速跳转 | Ctrl+Shift+O | ⌘⇧O | +| 文件树 | Ctrl+Shift+F | ⌘⇧F | +| 版本控制面板 | Ctrl+Shift+G | ⌘⇧G | +| 向右分屏 | Ctrl+Shift+D | ⌘D | +| 向下分屏 | Ctrl+Shift+S | ⌘⇧D | +| 放大或还原窗格 | Ctrl+Shift+Enter | ⌘⇧Enter | +| 切换相邻窗格 | Ctrl+Alt+方向键 | ⌘⌥方向键 | +| 下一个 / 上一个标签 | Ctrl+Tab / Ctrl+Shift+Tab | ⌘⇧] / ⌘⇧[ | +| 增大 / 减小终端字号 | Ctrl++ / Ctrl+- | ⌘+ / ⌘- | +| 重置终端字号 | Ctrl+0 | ⌘0 | +| 全屏 | Alt+Enter | ⌘Ctrl+F | + +复制、粘贴和滚动见[剪贴板](clipboard.md)与[终端基础操作](terminal-basics.md)。文档编辑按键见[Markdown 编辑](markdown-editing.md)。 + +## 更改一个快捷键 + +1. 打开 **设置 → 按键映射**。 +2. 找到要更改的动作,进入按键录入状态。 +3. 按下新的组合键,检查界面显示的结果。 +4. 返回工作区,在相应位置测试。 + +录入时按 **Esc**取消;使用界面提示的清除操作或 Backspace 清除当前录入。出现冲突提示时,换一个组合键,或先调整原来占用它的动作。 + +## 同一按键在不同位置的作用 + +快捷键会受当前焦点影响。例如,编辑 Markdown 段落时 **Ctrl+B / ⌘B**用于加粗选区;搜索框里的方向键用于选择结果,而不是移动终端光标。 + +快捷键没有按预期生效时,先点击要操作的终端或文档,再试一次。系统级快捷键也可能先被桌面环境或其他应用接收。 + +## Windows 全局快速终端 + +全局热键可在 Pebrel 不处于前台时使用,配置入口位于按键映射相关设置中。设置后,切换到其他应用试按一次,检查是否成功唤起窗口。 + +热键无法注册时,改用没有被其他应用占用的组合。详细设置见[快速终端与托盘](quick-terminal.md)。 + +## 恢复默认按键 + +设置页底部的 **恢复默认设置**会同时恢复设置与快捷键,并备份原设置;SSH 主机、凭据和历史会保留。需要只改一个动作时,优先调整该项,避免重置其他个性化设置。 diff --git a/docs/site/content/layouts.md b/docs/site/content/layouts.md new file mode 100644 index 000000000..4d21506b9 --- /dev/null +++ b/docs/site/content/layouts.md @@ -0,0 +1,38 @@ +## 保存一套常用排布 + +布局配方适合保存“两个项目标签,每个标签各有两个窗格”这类重复使用的工作环境。 + +1. 打开需要的终端,调整标签名称、目录和分屏大小。 +2. 打开[命令面板](palette.md),搜索“布局”。 +3. 选择 **保存当前窗口布局…**。 +4. 输入 **布局名称**,例如“前后端开发”。 +5. 确认保存范围,点击 **保存布局**。 + +列表会显示保存后的配方,并标出包含多少个标签和分屏。 + +## 选择保存范围 + +**当前标签**只保存当前终端标签的排布,适合一组相关窗格。**当前窗口**保存窗口中的终端布局,适合整个项目环境。当前项不是终端时,“当前标签”范围可能不可选。 + +终端标签的右键菜单也提供 **导出为工作区…**入口。日常重复使用的布局,可以从这里进入相应的工作区保存流程。 + +## 恢复布局 + +1. 打开命令面板,选择 **打开布局配方…**。 +2. 找到保存的布局,点击 **恢复**。 +3. 在新窗口中检查每个终端的目录和连接状态。 +4. 启动项目服务或其他需要的程序。 + +恢复会建立新的终端会话。布局记住的是排布和启动信息,不会复制原来正在运行的进程;例如开发服务器需要在新会话中重新启动。 + +## 更新已有工作安排 + +调整当前窗口后,重新保存为一个容易区分的名称,例如“前后端开发 · 数据库”。确认新配方可以正常恢复后,再删除不用的旧配方。 + +不同电脑上的目录、Shell 和 SSH 凭据可能不同。迁移布局后,先校正这些启动条件,再批量恢复。 + +## 删除布局配方 + +在配方列表选择 **删除**,并在确认框中确认。删除配方不会关闭已经打开的终端,也不会删除项目文件。 + +需要自动恢复最近一次退出前的排布,而不是手动选配方时,开启[启动时恢复上次标签](sessions.md)。 diff --git a/docs/site/content/markdown-editing.md b/docs/site/content/markdown-editing.md new file mode 100644 index 000000000..d6e175e9d --- /dev/null +++ b/docs/site/content/markdown-editing.md @@ -0,0 +1,96 @@ +## 切换到源码并保存 + +1. 从文件树打开本地 Markdown 文件。 +2. 点击工具栏的 **文档操作**(省略号),选择 **源码**;也可以按 `Ctrl+/`(macOS 为 `⌘/`)切换。 +3. 修改文本。文件名附近的未保存标记会反映编辑状态。 +4. 按 **Ctrl+S / ⌘S**,或点击 **保存**。 +5. 再次切换源码选项,查看排版后的结果。 + +Pebrel 1.9.1 的阅读视图用于阅读和选择文字;修改段落、列表与表格时,请在源码中操作。切回阅读视图可以预览尚未保存的编辑,但仍需执行保存才能写入文件。 + +## 标题、强调和链接 + +下面这段可以作为一个简单说明文档: + +```markdown +# 项目说明 + +## 开始使用 + +请先阅读 **安装步骤**,再运行开发服务。 + +需要特别注意的地方可以写成 *斜体*。 + +运行 `npm run dev` 后,打开终端显示的地址。 + +[返回首页](README.md) +``` + +`#`后面保留一个空格。使用 `##`和 `###`划分子章节,右侧目录会根据这些标题更新。 + +## 列表和任务清单 + +```markdown +1. 安装依赖。 +2. 启动服务。 +3. 打开浏览器。 + +- 开发环境 +- 测试环境 + +- [x] 准备配置 +- [ ] 运行测试 +``` + +完成任务时,在源码中将 `[ ]`改为 `[x]`,保存后查看阅读效果。阅读视图中的任务框用于展示完成状态,不作为修改文件的复选框。 + +## 代码块 + +用三条反引号包围代码,在第一行反引号后注明语言。下面的围栏内层是一段完整的 Markdown 示例: + +````markdown +```sh +echo Hello, Pebrel +``` +```` + +阅读时会显示代码排版,并提供复制按钮。常见语言可写 `sh`、`powershell`、`python`、`rust`、`json`或 `lua`。 + +## 表格 + +```markdown +| 环境 | 地址 | 状态 | +| --- | --- | --- | +| 开发 | localhost | 运行中 | +| 测试 | test.example.com | 待检查 | +``` + +每行用 `|`分隔单元格,第二行定义表头分隔线。新增一行时,在源码中按相同列数补一行;需要在单元格显示竖线时,写成 `\|`。 + +## 图片 + +```markdown +![终端工作区截图](images/workspace.png) +``` + +括号内是相对当前 Markdown 文件的图片路径。分享文档时,把被引用的图片目录一起保留。图片无法显示时,检查路径大小写和文件是否存在。 + +## 数学公式 + +行内公式用 `$...$`,独立公式用 `$$`围起: + +```markdown +直角三角形满足 $a^2+b^2=c^2$。 + +$$ +\frac{1}{2}+\frac{1}{3}=\frac{5}{6} +$$ +``` + +切回阅读视图检查排版。复杂 LaTeX 的支持范围以实际渲染为准;不正常的表达式可先缩小成一个简单公式,再逐步添加内容。 + +## 撤销和处理保存冲突 + +在源码编辑状态下,**Ctrl+Z / ⌘Z**撤销,**Ctrl+Shift+Z / ⌘⇧Z**重做。保存使用 **Ctrl+S / ⌘S**。 + +如果其他程序已经修改了文件,保存可能提示冲突。先复制当前编辑内容,再重新读取磁盘版本,比较后合并需要保留的部分。不要直接重读并丢掉尚未保存的文字。 diff --git a/docs/site/content/migration.md b/docs/site/content/migration.md new file mode 100644 index 000000000..b340d8228 --- /dev/null +++ b/docs/site/content/migration.md @@ -0,0 +1,53 @@ +## 找到个人数据目录 + +| 系统 | 标准位置 | +| --- | --- | +| Windows | `%APPDATA%\Pebrel` | +| macOS | `~/Library/Application Support/Pebrel` | +| Linux | `$XDG_CONFIG_HOME/pebrel`,未设置时通常为 `~/.config/pebrel` | + +Windows 可以把路径粘贴到资源管理器地址栏;macOS 可在 Finder 的“前往文件夹”中输入路径。使用 `PEBREL_CONFIG_DIR`时,以指定目录为准。 + +## 备份哪些内容 + +先正常退出 Pebrel,再复制个人数据目录到安全位置。常见文件包括: + +| 内容 | 文件或位置 | +| --- | --- | +| 界面偏好和快捷键 | `pebrel_settings.txt` | +| 保存的常用命令 | `saved_commands.json` | +| 最近会话布局 | `session.json` | +| SSH 配置记录 | `ssh_profiles.json`,及主机库的相关数据 | +| Lua / TOML 终端配置 | 实际加载的 `pebrel.lua`或对应配置文件 | +| 背景、额外字体和主题素材 | 保留使用中的素材及其路径 | + +整目录备份适合自己的恢复用途。需要发给别人或上传仓库时,改为挑选必要的脱敏文件,排除凭据、历史敏感信息及 `runtime.port`等运行时发现文件。 + +## 迁移到另一台电脑 + +1. 在旧电脑退出 Pebrel,备份数据与自定义配置。 +2. 在 SSH 主机库导出 CSV,需要分享或单独迁移的主题使用主题导出。 +3. 在新电脑安装 Pebrel、常用 Shell、字体和 AI CLI。 +4. 放回需要的个人配置,修正旧电脑上的程序和项目路径。 +5. 重新配置系统凭据、私钥位置和需要的账户登录。 +6. 新建终端、连接一台主机,再检查命令库和布局。 + +跨系统迁移时,不要直接沿用另一系统的绝对路径。主题颜色通常可保留,字体、壁纸和 Shell 路径需要在新系统中重新确认。 + +## SSH 密码与私钥 + +CSV 只包含地址、名称和分类信息,不携带密码、私钥或私钥口令。系统凭据库中的内容也不会通过复制应用目录自动迁移。 + +私钥应使用安全方式单独迁移,并保持恰当的访问权限;在新电脑上编辑主机条目,重新选择私钥并测试连接。不要把私钥放进公开仓库或普通分享压缩包。 + +## 从 Nebula 升级 + +Pebrel 会在新位置缺少相应文件时尝试复制旧版数据,保留旧文件,不覆盖已有 Pebrel 数据。首次启动后先检查主题、主机和命令,再清理旧环境。 + +新旧配置同时存在时,检查实际加载的文件。使用 `pebrel config check`可以发现语法问题;配置选择规则见[Lua 配置](configuration.md)。 + +## 还原备份 + +先退出应用并保留当前数据副本,再恢复准备使用的文件。不要恢复旧的运行时控制端口或 Token 文件;让新进程自行建立。 + +恢复后检查目录权限,运行配置检查,再新建终端验证。AI CLI 的对话正文需要按各工具自己的方式备份和恢复,不包含在 Pebrel 的标签布局中。 diff --git a/docs/site/content/navigation.md b/docs/site/content/navigation.md new file mode 100644 index 000000000..c212f8b9d --- /dev/null +++ b/docs/site/content/navigation.md @@ -0,0 +1,27 @@ +## 打开快速跳转 + +按 **Ctrl+Shift+O**(macOS 为 **⌘⇧O**)。输入名称或关键字,使用方向键选中结果,按 Enter 打开;按 Esc 返回工作区。 + +快速跳转把已有终端、常用目录、SSH 主机和支持的 AI 会话历史集中到同一个查找入口。 + +## 找到已经打开的终端 + +输入标签名称或相关关键字,选择已有标签或窗格结果。Pebrel 会切换到它所在的位置,原来运行的程序继续保留。 + +标签很多时,先为重要终端[重命名](workspace.md),例如“测试日志”和“生产只读”,之后就能按名称查找。 + +## 从目录重新开始工作 + +查找已经记录的常用目录,选择对应目录结果打开终端。打开后运行 `pwd` 确认位置,再执行项目命令。 + +这里列出的是 Pebrel 已知的目录。第一次使用一个尚未记录的路径,可以先在终端 `cd` 进入,或从文件树使用 **在此处打开终端**。 + +## 连接主机或继续 AI 对话 + +选择 SSH 主机结果可打开对应连接;认证信息缺失时,按提示补充。主机名称和分组可在[SSH 主机库](ssh-library.md)中整理。 + +选择 AI 历史结果会尝试通过相应 CLI 恢复会话。会话所属环境需要具备可用的工具和记录,具体见[AI 会话历史](ai-history.md)。 + +## 查找文件 + +需要在目录中定位文件时,打开[文件树](files.md)并使用它的搜索框。该搜索筛选文件名称;需要搜索文件内容时,可以在终端使用项目已有的搜索工具,例如 `rg`。 diff --git a/docs/site/content/network.md b/docs/site/content/network.md new file mode 100644 index 000000000..7c0e09dd1 --- /dev/null +++ b/docs/site/content/network.md @@ -0,0 +1,50 @@ +## 设置 Pebrel 的网络代理 + +打开 **设置 → 网络**,在 **代理方式**中选择: + +| 方式 | 作用 | +| --- | --- | +| **不使用代理** | 使用直接连接 | +| **跟随系统** | 使用检测到的系统代理配置 | +| **自定义代理** | 使用自己填写的代理协议与地址 | + +选择自定义代理后,填写代理地址并选择协议。例如,本机 SOCKS5 服务监听 `127.0.0.1:1080`时,选择对应协议并填写这个地址。实际端口以自己的代理软件为准。 + +## 测试当前配置 + +1. 完成代理方式、协议和地址输入。 +2. 点击 **测试网络**。 +3. 查看返回的路线、耗时或错误文字。 +4. 修改后重新测试,确认使用的是新的配置。 + +显示网络连接正常,说明本次测试路线可访问测试目标。某个 SSH 账户或 AI 服务仍有问题时,继续在对应连接或工具中测试。 + +## 让新终端接入系统代理 + +网络页还有独立的 **系统代理**开关。开启后,**新建终端**的 `HTTP_PROXY` / `HTTPS_PROXY`环境变量会接入系统代理。 + +开启后新建一个窗格,再启动需要联网的工具;已经运行的 Shell 和 CLI 不会自动得到重新创建的进程环境。 + +这个开关与上面的网络代理方式分别控制。CLI 也可能使用自己的网络设置,出现问题时同时检查工具配置。 + +## 为某个 SSH 主机覆盖代理 + +编辑 SSH 主机,打开 **高级**页,选择跟随全局、不使用或自定义代理。只有某一台服务器需要直连时,修改该主机即可。 + +带代理认证或跳板的连接,按[代理与跳板](ssh-routing.md)填写。连接规则预览可以帮助确认最终路线。 + +## 在 WSL 或服务器中访问网络 + +工具运行在 WSL 或 SSH 服务器时,网络请求从那个环境发出。尤其是 SSH 服务器上的 `127.0.0.1`指服务器自己,不是你的电脑。 + +先在实际运行工具的环境中检查代理地址和可达性,再启动 CLI。不要把 Windows 上一次成功的测试当作远端服务也已配置完成。 + +## 常见失败 + +**连接被拒绝:**检查代理程序是否运行、协议和端口是否匹配。 + +**超时:**检查当前网络、VPN、代理到目标的路线和防火墙。 + +**某个工具仍无法联网:**新建终端重试,并检查工具自己的代理、证书或账户设置。 + +反馈问题时保留协议、脱敏地址和错误文字,移除代理密码和 Token。 diff --git a/docs/site/content/notifications.md b/docs/site/content/notifications.md new file mode 100644 index 000000000..b4821f71e --- /dev/null +++ b/docs/site/content/notifications.md @@ -0,0 +1,35 @@ +## 开启 AI 消息提示 + +打开 **设置 → 终端 → 提醒**,调整 AI 消息通知开关。任务需要关注时,可以通过通知回到对应窗格查看,而不必一直盯着输出。 + +需要更准确的任务事件时,先完成[Agent 集成](hooks.md)。通知开关控制显示,Agent 集成负责提供支持的活动事件。 + +## 调整通知停留时间 + +在同一分组的通知时长选项中选择:**使用默认值**、**5 秒**、**10 秒**、**30 秒**、**90 秒**或 **直到手动关闭**。 + +使用默认值时,短提示停留 5 秒、消息横幅停留 90 秒,更新通知保留到关闭。更改时长后,新出现或被刷新的应用内卡片使用新设置。 + +
    Pebrel 的应用内通知时长选项
    根据需要选择短暂提示或手动关闭。
    + +## 回到发出通知的终端 + +点击通知中的来源操作,Pebrel 会返回对应窗格。阅读 CLI 里的原始问题,完成确认、授权或补充输入。 + +关闭卡片只会隐藏通知;仍待处理的请求留在终端中。忽略了更新通知,也可以回到 **设置 → 应用**重新查看。 + +## 为什么旧卡片不见了 + +应用内最多保留最近三张卡片。新卡片出现时,较旧的卡片可能被替换,即使选择了手动关闭也一样。 + +需要回看任务内容时,到来源终端或工具历史中查找,不依赖通知卡片作为日志。 + +## 终端铃声 + +**终端铃声**可以选择关闭、闪烁、声音或相应组合,用于响应程序发出的提醒。声音效果受当前平台支持情况影响;需要安静工作时,可优先选择关闭或闪烁。 + +## 系统通知没有出现 + +先确认应用内提示是否正常,再检查系统给 Pebrel 的通知权限、勿扰模式以及 Linux 桌面的通知服务。系统通知的停留时间由操作系统控制,不随应用内卡片时长改变。 + +如果连工具状态都不更新,先检查 CLI 是否已在配置集成后重新启动。 diff --git a/docs/site/content/palette.md b/docs/site/content/palette.md new file mode 100644 index 000000000..2ed7030e4 --- /dev/null +++ b/docs/site/content/palette.md @@ -0,0 +1,30 @@ +## 按名称查找操作 + +按 **Ctrl+Shift+P**(macOS 为 **⌘⇧P**)打开命令面板。在搜索框输入想做的操作,例如“设置”“分屏”或“布局”。 + +使用方向键选择结果,按 **Enter**执行;按 **Esc**关闭面板。暂时不记得快捷键时,可以先从这里查找。 + +## 打开设置或创建布局 + +例如,要保存当前窗口布局: + +1. 打开命令面板,输入“布局”。 +2. 选择 **保存当前窗口布局…**。 +3. 在布局配方中输入名称并保存。 + +下次使用时,在命令面板选择 **打开布局配方…**,再恢复已保存的布局。完整流程见[布局配方](layouts.md)。 + +## 选择合适的查找入口 + +| 需要找到的内容 | 使用的入口 | +| --- | --- | +| 打开设置、切换面板等应用动作 | 命令面板:Ctrl+Shift+P / ⌘⇧P | +| PowerShell、WSL 等启动入口 | Shell 选择器:Ctrl+K / ⌘K | +| 已开的标签、常用目录、SSH 主机和 AI 历史 | 快速跳转:Ctrl+Shift+O / ⌘⇧O | +| 自己保存的命令文字 | 顶栏的闪电图标 | + +命令面板用于执行应用动作。要运行 `git status` 等 Shell 命令,回到终端输入,或从[保存命令](commands.md)插入。 + +## 找不到某个动作 + +先尝试更短的关键字,并确认当前打开的是命令面板。部分动作需要先聚焦一个终端标签;文档标签、没有分屏的标签和不同系统可用的动作可能不同。全局快速终端和托盘设置目前仅在 Windows 提供。 diff --git a/docs/site/content/privacy.md b/docs/site/content/privacy.md new file mode 100644 index 000000000..bc2590c75 --- /dev/null +++ b/docs/site/content/privacy.md @@ -0,0 +1,33 @@ +## 哪些内容保存在本机 + +Pebrel 的界面偏好、命令条目、主机记录和会话布局存放在个人数据目录中。背景图片和本地文档仍位于各自路径;图片粘贴会额外产生 PNG 副本。 + +SSH 密码等保存到对应的系统凭据库。具体目录与备份范围见[备份与迁移](migration.md)。 + +## 内容什么时候会发送出去 + +连接 SSH 时,认证与终端输入发送给目标服务器;SFTP 上传和远端图片粘贴会传输所选文件。使用 **发送到聊天**时,选区与问题会交给所选 AI 窗格。 + +AI CLI 可能再把提示、文件或截图发送到其服务提供方。具体范围由工具的权限、配置和服务决定,发送前检查当前项目、目标主机和授权提示。 + +## 分享配置或截图前 + +移除密码、Token、私钥、带认证的代理地址以及不需要公开的服务器信息。检查保存命令里是否包含凭据,截图中的终端输出是否包含私人数据。 + +分享 SSH 地址与分类时,使用主机库的 CSV 导出;它不包含密码和私钥。分享主题时,检查其中的本机路径是否需要清除。 + +## 本机自动化的控制文件 + +`runtime.port`等发现文件包含本机运行时连接信息和控制凭据。不要提交到仓库、发给其他人或将控制端口转发到公网。 + +使用自动化脚本时,先列出窗格并核对目标,再发送命令。不要让脚本仅根据当前焦点决定修改哪个项目。 + +## 清理不再需要的数据 + +从对应的设置或列表删除不用的命令、主机或布局。图片粘贴产生的本机和远端副本,需要按实际保存位置分别清理。 + +删除本机文件不会撤回已经上传到服务器或交给 AI 服务的内容。工具自己的历史与云端记录,应在该工具或服务中处理。 + +## 文档网站的搜索 + +本网站的全文搜索在浏览器内运行,不向外部搜索服务发送查询。点击 GitHub、下载或其他外部链接时,会进入相应站点,并适用其自身的数据处理方式。 diff --git a/docs/site/content/quick-terminal.md b/docs/site/content/quick-terminal.md new file mode 100644 index 000000000..912c4e858 --- /dev/null +++ b/docs/site/content/quick-terminal.md @@ -0,0 +1,31 @@ +## 设置全局热键 + +**快速终端目前仅在 Windows 提供。** 设置完成后,可以在其他应用中按组合键唤起 Pebrel。 + +1. 打开 **设置 → 按键映射**。 +2. 找到 **快速终端**,录入准备使用的组合键。 +3. 在 **快速终端打开方式**中选择需要的模式。 +4. 切换到其他应用,按一次热键检查唤起效果,再按一次检查隐藏行为。 + +如果提示热键注册失败,换一个没有被系统或其他应用占用的组合。只在 Pebrel 窗口内生效的普通快捷键,不能代替这个全局热键。 + +## 选择打开方式 + +| 模式 | 适合的使用方式 | +| --- | --- | +| **独立窗口** | 随时输入几条短命令,不打断主工作区 | +| **唤起已有窗口** | 回到已经打开的项目和终端 | + +“唤起已有窗口”会召回已有工作区,不会每次都额外创建一个标签页。选择独立窗口后,可以按需要调整它的窗口大小。 + +## 从托盘重新打开窗口 + +打开 **设置 → 高级 → 会话生命周期**,开启 **常驻系统托盘图标**。之后可以从系统托盘中的 Pebrel 入口重新显示窗口。 + +希望关闭窗口后仍保留运行中的任务,请同时开启 **关窗后保留后台会话**。隐藏窗口后,任务会继续输出;从托盘或热键唤回时,可以接着查看。 + +## 完全退出 + +需要结束 Pebrel 时,使用退出应用的操作,而不是仅关闭一个设置为后台保留的窗口。保存文档并结束需要处理的任务后再退出;应用进程结束后,全局热键也不再驻留。 + +macOS 和 Linux 可以通过系统应用切换、新建窗口和普通快捷键操作 Pebrel。会话恢复设置见[会话保存与恢复](sessions.md)。 diff --git a/docs/site/content/quickstart.md b/docs/site/content/quickstart.md index 20339b4d6..2f3e8224a 100644 --- a/docs/site/content/quickstart.md +++ b/docs/site/content/quickstart.md @@ -1,81 +1,68 @@ -## 安装并打开 +## 安装并打开 Pebrel -1. 前往 [Pebrel 官方发布页](https://github.com/Kuddev/pebrel/releases/latest),选择适合系统与处理器的安装包。 -2. Windows 运行安装程序,或完整解压便携包;macOS 打开 DMG,将 Pebrel 拖入“应用程序”;Linux 使用 DEB、AppImage 或完整便携包。 -3. 启动 Pebrel,先保留默认设置。在终端中输入下面的命令并回车。 +从[安装与平台支持](installation.md)选择与你的系统和处理器匹配的安装包。首次打开后,Pebrel 会启动一个终端。看到提示符和闪烁的光标后,就可以输入命令。 + +在终端中输入下面这行内容,再按 **Enter**: ```sh echo Hello, Pebrel ``` -看到 `Hello, Pebrel` 后,你的第一个终端已经可以使用。[安装说明](installation.md)列出了各个平台的要求与首次启动注意事项。 +如果下一行显示 `Hello, Pebrel`,随后出现新的提示符,终端已经可以正常使用。 -> [!TIP] -> Pebrel 是运行命令的窗口,不会自动安装你的开发环境。某个命令提示“找不到”时,先确认相应工具已安装,并且能在系统原有终端中运行。 +## 打开项目目录 -## 建立顺手的工作区 +输入 `cd`,后面跟项目的路径。路径包含空格时,用引号包起来。下面两行任选一行,并把路径改成自己的项目位置。 -### 新建标签页 +**Windows PowerShell:** -Windows / Linux 按 Ctrl + Shift + T;macOS 按 ⌘ + T。新标签页适合另一个项目,或一项不希望打断当前任务的工作。 +```powershell +cd "C:\Projects\my-project" +``` -在终端里用 `cd` 进入你的项目目录。例如,先把下面的路径替换为真实存在的文件夹,再运行: +**macOS、Linux 或 WSL:** ```sh -cd "你的项目目录" +cd ~/Projects/my-project ``` -### 并排打开窗格 - -Windows / Linux 按 Ctrl + Shift + D,macOS 按 ⌘ + D,向右分屏。左边运行开发工具,右边执行测试或查看文件。 - -拖动两个窗格之间的分隔线调整宽度。需要专心看一个窗格时,按 Ctrl / ⌘ + Shift + Enter 切换放大,再按一次回到分屏布局。 - -
    多个命令行工具在 Pebrel 的独立分屏中运行
    分屏让各个任务保持独立。项目公开截图;其中的命令行工具需另行安装。
    - -### 找不到某个操作 - -按 Ctrl / ⌘ + Shift + P 打开命令面板。要更换 Shell,使用 Ctrl / ⌘ + K 打开 Shell 选择器。 +输入 `pwd` 可以查看当前目录。在 Windows 命令提示符(cmd)中,使用不带参数的 `cd` 查看目录。 -这里是 **Pebrel 应用内的快捷键**。文档网站中的同一组合键用于搜索文档,不会控制桌面应用。 +需要切换终端程序时,按 **Ctrl+K**(macOS 为 **⌘K**)打开 Shell 选择器,再选择已安装的 Shell。默认 Shell 和启动目录可以在 **设置 → 终端** 中调整。 -## 连接远程主机 +## 再开一个终端 -打开 Pebrel 设置,进入 **SSH**。创建一个主机,填写服务器地址、用户名与端口,按服务器要求选择密码或私钥认证,然后连接。 +运行开发服务时,原终端可能一直显示日志。另开一个标签页,就能继续输入其他命令。 -第一次连接前,把显示的主机密钥指纹与服务器管理员提供的指纹核对一致。不要仅为了跳过提示而接受不认识的指纹;已有主机的指纹突然改变时,先确认服务器是否重装或换钥。 +| 操作 | Windows / Linux | macOS | +| --- | --- | --- | +| 新建标签页 | Ctrl+Shift+T | ⌘T | +| 向右分屏 | Ctrl+Shift+D | ⌘D | +| 向下分屏 | Ctrl+Shift+S | ⌘⇧D | +| 放大当前窗格,再按一次还原 | Ctrl+Shift+Enter | ⌘⇧Enter | -连接后,你输入的命令在远程机器上执行。远程文件浏览与传输使用 SFTP;远端需允许相应服务。 +点击要使用的窗格后再输入。新建分屏会启动另一个 Shell,你可以在里面切换到其他目录或运行不同程序。 -## 使用 AI 命令行工具 +
    Pebrel 中的终端标签页
    通过标签页切换终端;需要同时查看时,可在一个标签页内分屏。
    -先按照工具自身的说明安装并登录 Claude Code 或 Codex。在 Pebrel 中进入项目目录,再运行你已安装的工具,例如: +## 连接服务器 -```sh -claude -``` - -或者: - -```sh -codex -``` +打开 **设置 → SSH**,选择 **添加 SSH 主机**,填写地址、用户名和认证信息。保存后,从主机列表打开连接。 -Pebrel 可以为识别到的 AI CLI 显示活动状态。更精确的状态与回答捕获需要对应的 hook 集成;自动本地 hook 设置目前是 Windows 平台能力。macOS 与 Linux 仍可以正常运行已安装的 CLI,但不要把“能运行”理解为“所有集成都已自动配置”。 +首次连接会要求确认服务器指纹。与服务器管理员提供的指纹核对一致后,再继续登录。完整示例见[连接第一台 SSH 主机](ssh.md)。 -AI 服务的登录、额度与费用由对应工具和服务提供方管理。关闭或隐藏通知不会代替你批准终端中的请求。 +## 启动 AI 命令行工具 -## 做两个舒适度调整 +已经安装并登录 Claude Code 或 Codex 时,可以直接在项目终端中运行 `claude` 或 `codex`。先试一个范围明确的任务,例如“介绍这个项目的目录结构,先不要修改文件”。 -打开设置:Windows / Linux 使用 Ctrl + ,,macOS 使用 ⌘ + ,。 +Pebrel 会为识别出的工具显示图标和活动状态。如何查看回答、找回历史对话,见[使用 AI 命令行工具](ai-start.md)。 -在 **外观** 中选择主题和字体。临时调整终端字号可以使用 Ctrl / ⌘ + + 或 −;按 Ctrl / ⌘ + 0 恢复。 +## 调整字体和外观 -再按 Ctrl + Shift + B(macOS 为 ⌘ + B)收起或展开侧边栏,选择适合屏幕的工作空间。 +点击窗口中的设置按钮,打开 **外观**。文字太小时,先调整 **终端字号**;侧栏、菜单和按钮的文字则由 **界面字号** 控制。主题、字体和行高的详细设置见[外观](appearance.md)。 -## 结束这次工作 +## 结束工作 -先保存正在编辑的文件,确认长时间运行的任务是否已完成,再关闭窗格或窗口。 +运行中的命令通常可以按 **Ctrl+C** 停止;在 Windows / Linux 中有文字选中时,先点击终端空白处清除选区,再按 Ctrl+C。出现提示符后,输入 `exit` 退出 Shell。 -> [!IMPORTANT] -> **恢复布局、恢复 AI 对话、保持进程运行是三件不同的事。** Windows 的可选后台驻留可以在关闭窗口后保留运行中的会话;完整退出应用后,普通进程不会因为开启布局恢复而继续运行。其他平台不要依赖关闭窗口后的进程保活。 +希望下次打开时恢复标签页和目录,可以在 **设置 → 高级 → 会话生命周期** 开启 **启动时恢复上次标签**。需要在 Windows 关窗后继续运行任务,请另行开启[后台会话保留](sessions.md)。 diff --git a/docs/site/content/remote-edit.md b/docs/site/content/remote-edit.md new file mode 100644 index 000000000..68b562e6c --- /dev/null +++ b/docs/site/content/remote-edit.md @@ -0,0 +1,41 @@ +## 打开远端文本文件 + +建立内置 SSH 连接,进入[SFTP 文件列表](sftp.md),打开要修改的文本文件。编辑器标题包含文件名和目标主机,先确认两者再编辑。 + +远端 Markdown 以源码打开,避免把服务器上的相对资源路径当作本机文件加载。 + +## 保存回服务器 + +1. 修改所需内容。 +2. 点击 **保存**,或按 **Ctrl+S / ⌘S**。 +3. 等待“正在保存”结束,查看保存状态。 +4. 必要时在远端终端中读取文件,确认服务器上的结果。 + +保存目标是打开文件时的原主机和路径。切换到其他 SSH 窗格,不会将这个文件改存到另一台服务器。 + +## 连接断开或权限不足 + +网络断开时,先恢复 SSH 连接;权限不足时,检查当前账户是否可以写入该文件及所在目录。编辑器不会自动提权为管理员账户。 + +错误提示出现后,保留当前编辑内容,再处理问题并保存。重要修改可以先复制到本地文件,防止关闭应用后丢失。 + +## 文件已经被其他人修改 + +保存前检查到服务器文件发生变化时,Pebrel 会报告冲突。此时: + +1. 复制当前尚未保存的内容。 +2. 重新读取远端文件,查看最新版本。 +3. 合并双方需要保留的修改。 +4. 再次保存并检查结果。 + +如果文件由部署程序或其他编辑器自动生成,应先暂停相关修改流程,避免不断覆盖。 + +## 取消读取或保存 + +远端操作进行时,工具栏提供取消入口。点击后等取消状态结束,再开始下一次操作。取消后可以重新读取远端文件,确认服务器上实际保留的版本。 + +## 只读文件 + +超过 **8 MB**的文件可能只预览开头,无法在此保存;非完整 UTF-8 文本也可能只读。此时可以下载后用合适的编辑器处理,或在远端终端使用服务器上的工具。 + +关闭仍有未保存内容的标签时,按提示选择保存、放弃或取消。文件尚未成功保存前,不要只根据终端连接恢复就关闭编辑器。 diff --git a/docs/site/content/runtime.md b/docs/site/content/runtime.md new file mode 100644 index 000000000..d47b45e28 --- /dev/null +++ b/docs/site/content/runtime.md @@ -0,0 +1,72 @@ +## 查看当前终端与运行状态 + +在 Pebrel 的本地终端运行: + +```sh +pebrel env --pretty +pebrel ctl describe --pretty +pebrel pane list +``` + +`env`显示调用环境,`describe`列出当前运行时支持的能力,`pane list`列出可以定位的窗格。后续命令中的窗格 ID,要使用实际列表里的值。 + +命令找不到时,检查当前环境是否为本地 Pebrel 窗格,以及 `PEBREL_CLI`指向的程序。SSH 服务器上不会自动安装本机的 Pebrel CLI。 + +## 读取另一个窗格的输出 + +假设目标窗格 ID 为 `17`,读取最近 80 行: + +```sh +pebrel pane read 17 --lines 80 +``` + +多个窗口中存在相同 ID 时,补充对应的窗口参数。不要固定复用上一次启动中的 ID,关闭并重建窗格后应重新查询。 + +## 发送一条命令 + +确认目标停在普通 Shell 提示符,并位于正确项目目录后,发送: + +```sh +pebrel pane send 17 "git status --short" --wait +``` + +`send`会提交文本并发送回车,`--wait`等待相应状态变化。只想插入文字供人工检查时,使用 `--no-submit`,不要同时加等待执行结束的选项。 + +读取窗格输出确认执行结果。等待结束不等于项目测试成功,成功与否仍由实际命令输出和退出状态判断。 + +## 发送保留换行的文本 + +将文本写入 UTF-8 文件 `task.txt`,然后执行: + +```sh +pebrel pane paste 17 --from-file task.txt --wait +``` + +该方式保留换行,目标需要支持 bracketed paste。文件应是普通文本,输入上限为 32 KiB;不用于发送二进制、控制序列或给远端自动转发本机文件。 + +## 独立运行一个命令 + +需要在目标窗格的已知目录执行非交互命令,同时不改变其 Shell 输入时,可以使用: + +```sh +pebrel pane exec 17 -- git status --short +``` + +`exec`直接启动独立子进程。命令和参数分别传入,管道、重定向和变量展开不会自动作为 Shell 语法执行。需要交互式程序时,仍应在终端会话中运行。 + +## 向 AI 工具分配任务 + +先执行 `pebrel agent list`确认工具名称或稳定 ID,再发送任务。例如,列表中的目标确实名为 `codex`时: + +```sh +pebrel agent send codex "检查当前项目的测试入口,先不要修改文件" --wait +pebrel agent read codex --lines 80 +``` + +自动化应使用列表返回的身份,而不是仅根据窗口焦点猜测目标。命名 Agent 和隔离目录的完整示例见[隔离 AI 工作目录](agent-worktrees.md)。 + +## 超时后如何处理 + +先读取目标状态和最近输出。如果任务已经收到但仍在执行,继续查看或等待;不要立即重复发送同一条任务,以免执行两次。 + +参数和能力相关错误,可以用 `pebrel ctl describe --pretty`检查当前版本,并参阅[运行时控制参考](https://github.com/Kuddev/pebrel/blob/9dc058d12765893553d5fc7a2c37c870c96168b0/docs/runtime-control-api.md)。运行时发现文件包含本机控制凭据,不应公开、同步给他人或转发端口。 diff --git a/docs/site/content/send-to-chat.md b/docs/site/content/send-to-chat.md new file mode 100644 index 000000000..357833bec --- /dev/null +++ b/docs/site/content/send-to-chat.md @@ -0,0 +1,35 @@ +## 把报错交给 AI 分析 + +先在一个窗格中启动 AI CLI,再在产生报错的终端中操作: + +1. 选择需要分析的报错文字。 +2. 右键选区,选择 **发送到聊天**。 +3. 在对话框中检查引用的内容。 +4. 补充问题,例如“请解释这个错误,并指出下一步要检查的文件,先不要修改代码”。 +5. 选择目标 AI 窗格,确认后发送。 + +消息会将选中的文字作为引用,并附上你的问题。回到目标窗格可以继续查看工具的响应。 + +## 只发送相关日志 + +通常保留错误信息、相关命令和附近几行上下文即可。过长的日志可以先缩小选区;缺少上下文时,再补充运行目录、系统或复现步骤。 + +发送前移除密码、访问令牌、私人路径或其他不应分享的信息。目标工具可能把内容交给它所连接的 AI 服务。 + +## 选择正确的目标 + +目标列表显示可接收输入的 AI 窗格,并标出相应工具。远端目标还会显示主机信息,选择之前先核对。 + +目标需要仍在运行,并处于可接受粘贴消息的状态。工具已经退出、被替换或暂时无法接收时,先回到那个终端处理,再重新打开发送对话框。 + +## 没有可用目标 + +检查 AI CLI 是否已启动、是否被 Pebrel 识别,以及当前是否停在等待输入的位置。仍无法使用时,可以先复制整理后的消息,再手动粘贴到工具的输入区。 + +开启 **选中即复制**后,右键行为可能变为粘贴。需要调出常规选区菜单时,在 **设置 → 交互**关闭该选项,见[剪贴板](clipboard.md)。 + +## 把内容发送到远端 + +选择 SSH 上的 AI 窗格时,这段文字会离开本机。确认引用内容允许发送到该服务器,并确认列表中的主机就是预期目标,再提交。 + +需要发送图片而不是日志时,使用[图片粘贴](images.md)。 diff --git a/docs/site/content/sessions.md b/docs/site/content/sessions.md new file mode 100644 index 000000000..df597bf71 --- /dev/null +++ b/docs/site/content/sessions.md @@ -0,0 +1,41 @@ +## 下次打开时恢复标签和目录 + +打开 **设置 → 高级 → 会话生命周期**,开启 **启动时恢复上次标签**。正常退出后再次启动 Pebrel,会按已保存的信息重新建立终端标签、分屏和已知目录。 + +建议先用两个空闲终端测试:分别进入不同目录,正常退出并重开,再运行 `pwd` 检查恢复位置。SSH 标签需要重新连接服务器,缺少认证信息时会再次询问。 + +恢复标签会启动新会话。上次终端里没有保存的屏幕内容和普通程序的内存状态,不会作为整个进程一起恢复。 + +## 关窗后让任务继续运行 + +**此功能仅在 Windows 提供。** + +1. 在 **设置 → 高级 → 会话生命周期**开启 **关窗后保留后台会话**。 +2. 建议同时开启 **常驻系统托盘图标**,方便重新打开窗口。 +3. 运行一个需要持续进行的任务,再关闭窗口。 +4. 通过托盘或快速终端重新唤起 Pebrel,查看原任务的输出。 + +这项设置使应用在关窗后继续驻留。真正退出应用、结束进程、注销或重启电脑会终止本地进程;需要跨重启运行的任务,应使用相应系统服务或任务管理工具。 + +## 接续 AI 对话 + +希望恢复标签时继续之前的 Claude Code 或 Codex 对话,在开启标签恢复后,再开启 **恢复时接续 AI 对话**。 + +恢复需要可用的会话标识、原会话记录和对应 CLI。Pebrel 会尝试用 CLI 的恢复入口接续对话;工具仍可能要求登录或确认工作目录。 + +恢复失败时,右键相关终端标签,使用可用的 **重试会话恢复**或 **选择要继续的对话…**。也可以从[AI 会话历史](ai-history.md)手动选择。 + +## 应该开启哪一项 + +| 你的需要 | 设置 | +| --- | --- | +| 重启应用后重新打开标签、分屏与目录 | 启动时恢复上次标签 | +| Windows 关闭窗口但继续运行本地任务 | 关窗后保留后台会话 | +| 重开时接续受支持的 AI 对话 | 启动时恢复上次标签 + 恢复时接续 AI 对话 | +| 按项目保存几套可重复打开的布局 | 使用[布局配方](layouts.md) | + +## 远端任务需要长时间运行 + +SSH 连接断开时,远端命令是否继续由服务器上的程序和会话管理方式决定。对必须持续运行的远端任务,建议使用服务器上已安装的会话保持工具或系统服务;重新连接后按对应工具的恢复方式继续。 + +关闭 Pebrel 前,仍应保存打开的文档。文档编辑缓冲区的保存提示与终端会话恢复是两套操作。 diff --git a/docs/site/content/settings.md b/docs/site/content/settings.md new file mode 100644 index 000000000..df868798f --- /dev/null +++ b/docs/site/content/settings.md @@ -0,0 +1,49 @@ +## 打开设置并查找选项 + +按 **Ctrl+,**(macOS 为 **⌘,**),或点击工作区的设置按钮。 + +顶部搜索可以查找设置所属的分区。例如输入“通知”进入提醒相关设置,输入“字体”进入外观,输入“恢复”查找会话生命周期。搜索无结果时,试用更短的关键字。 + +## 常用设置在哪里 + +| 需要调整的内容 | 位置 | +| --- | --- | +| 查看版本、检查更新 | **应用 → 版本与更新** | +| 更换主题、应用图标、跟随系统深浅色 | **外观** | +| 中英文字体、终端字号、字符间距、回滚和滚动 | **外观 → 终端外观** | +| 界面字号、语言、密度与透明度 | **外观 → 界面** | +| 壁纸及图片铺放方式 | **外观 → 自定义背景** | +| 默认 Shell、启动目录 | **终端 → 启动** | +| 历史补全样式和接受键 | **终端 → 补全** | +| AI 通知、卡片时长、终端铃声 | **终端 → 提醒** | +| 工具检测与集成 | **Agents** | +| 选中即复制、鼠标焦点、粘贴确认 | **交互 → 鼠标与选区** | +| 标签位置、新实例行为、Git / SVN 显示 | **交互 → 标签与窗口** | +| 修改组合键、Windows 快速终端 | **按键映射** | +| 保存主机、密码与密钥、代理和跳板 | **SSH** | +| 网络代理、测试网络、新终端接入系统代理 | **网络** | +| 登录启动、托盘、后台会话、恢复标签和 AI 对话 | **高级 → 会话生命周期** | + +## 设置什么时候生效 + +开关和选择项通常在操作后保存。文字输入按相应字段提示,通过 Enter、离开输入框或保存按钮提交。 + +有些设置影响新会话:更改默认 Shell、回滚行数或终端代理环境后,新建窗格检查效果。修改 Agent 集成后,重新启动相应 CLI。 + +出现保存失败提示时,按错误信息检查文件或目录权限,不必删除整套配置。 + +## 更改界面语言 + +在 **外观 → 界面 → 语言**选择需要的语言。设置改变 Pebrel 的菜单和说明文字,不改变 Shell 或远端程序输出。个别未翻译项会显示英文。 + +## Windows 登录时启动 + +在 **高级 → 会话生命周期**中开启 **登录时自启动**。希望启动后先在后台待命时,再开启 **静默启动**;启用时会同时启用托盘,可从托盘重新打开窗口。 + +显式打开目录等启动方式可能仍会显示窗口。先测试一次普通启动和托盘唤回,再决定是否保留静默模式。 + +## 找不到平台专有选项 + +托盘、全局快速终端、登录启动和关窗保留后台会话目前是 Windows 集成。macOS 和 Linux 不显示对应选项时,可以按各平台已有的窗口和会话恢复方式使用。 + +修改配置文件、备份偏好和恢复默认设置,分别见[Lua 配置](configuration.md)、[备份迁移](migration.md)和[交互设置](interaction.md)。 diff --git a/docs/site/content/sftp.md b/docs/site/content/sftp.md new file mode 100644 index 000000000..50903893e --- /dev/null +++ b/docs/site/content/sftp.md @@ -0,0 +1,56 @@ +## 打开远端文件列表 + +先建立[内置 SSH 连接](ssh.md),点击对应终端窗格,再打开文件面板。目录加载完成后,选择文件夹进入下一级,使用 **上一级**返回。 + +列表可以跟随终端已知的远端目录。手动浏览其他目录后,点击 **重新跟随**回到终端目录;服务器文件有变化时,点击 **重新读取**刷新。 + +## 上传文件或文件夹 + +1. 在远端列表中进入目标目录。 +2. 点击 **上传文件**或 **上传文件夹**。 +3. 在本机文件选择窗口中选取要上传的内容。 +4. 有同名冲突时,选择处理方式。 +5. 查看传输进度,完成后确认远端列表中的结果。 + +服务器上的目标目录需要写入权限。选择本地文件期间如果切换了目标,Pebrel 可能提示“目标已改变”;此时回到正确的远端目录,重新发起上传。 + +## 下载到本机 + +选中远端文件或文件夹,点击 **下载到本地**,再选择本机保存位置。下载文件夹时会传输其内容,并显示进度。 + +完成后,在本机目标目录检查结果。磁盘空间不足、写入权限或网络断开都可能使传输中止,可以在修复原因后重新发起。 + +## 处理同名项目 + +| 选项 | 结果 | +| --- | --- | +| **覆盖** | 用传入内容替换目标同名文件 | +| **跳过** | 保留目标已有内容,跳过冲突项 | +| **保留两者** | 另取名称保存,让两份内容同时存在 | +| **取消** | 取消这次操作 | + +文件与目录类型冲突时,覆盖可能不可选。重要文件不确定是否应替换时,先使用“保留两者”,再比较两份内容。 + +## 跳过没有变化的文件 + +重复传输目录时,可以勾选 **跳过未变**,减少重复复制。Pebrel 根据文件大小和修改时间判断可跳过项,不逐个计算完整内容的校验和。 + +需要确保重新传输某个同大小、同时间戳的文件时,关闭此选项后再操作。 + +## 远端复制与粘贴 + +1. 在源主机的远端列表中选中文件或目录。 +2. 点击 **复制远端项目**。 +3. 浏览到目标目录;也可以切换到另一条已连接的 SSH 会话。 +4. 点击 **粘贴到当前远端目录**。 +5. 处理冲突并检查完成状态。 + +跨主机复制需要源和目标都可连接,并具备读取、写入权限。这里复制的是所选项目,后续粘贴的目标由当前远端目录决定。 + +## 取消传输 + +传输过程中点击 **取消**。出现“正在取消”时,等待操作结束再开始下一次传输。取消不会撤回此前已经完成的其他文件;重新传输前检查目标目录,选择合适的同名处理方式。 + +## 修改远端文本文件 + +从远端列表打开支持的文本文件,编辑后按 **Ctrl+S / ⌘S**保存回服务器。保存结果与异常处理见[远端文件编辑](remote-edit.md)。 diff --git a/docs/site/content/shells.md b/docs/site/content/shells.md new file mode 100644 index 000000000..6708d7eca --- /dev/null +++ b/docs/site/content/shells.md @@ -0,0 +1,54 @@ +## 为新终端选择 Shell + +按 **Ctrl+K**(macOS 为 **⌘K**)打开 Shell 选择器,选择要启动的终端程序。列表取决于当前电脑已安装的 Shell,以及你配置的启动入口。 + +Windows 可以使用 PowerShell、命令提示符以及已安装的 WSL 发行版。macOS 和 Linux 使用系统中可用的 Shell。选择一个入口后,Pebrel 会为它建立终端会话。 + +## 更改默认 Shell + +1. 打开 **设置 → 终端**。 +2. 在 **默认 Shell**中选择常用的程序。 +3. 新建终端,检查提示符是否来自所选 Shell。 + +已打开的 Shell 会继续运行。更改默认项不会中途替换它们。 + +找不到刚安装的 Shell 时,先确认该程序可以独立启动,再重新打开 Pebrel。便携终端可以通过设置中的终端目录选择入口添加;应选择包含可执行文件的目录,或其上一级安装目录。 + +## 设定启动目录 + +1. 打开 **设置 → 终端 → 启动**,找到 **启动目录**。 +2. 点击当前路径或“继承当前目录”,在文件夹选择窗口中选取项目目录。 +3. 新建终端,检查是否进入所选目录。 + +要取消固定启动目录,点击路径右侧的 **清除**。该项会重新显示“继承当前目录”,新会话可沿用已有终端的已知目录。 + +输入 `pwd` 查看实际目录;cmd 使用 `cd`。如果 Shell 自己的启动脚本也执行了 `cd`,最终目录会受该脚本影响。 + +## 配置带参数的启动入口 + +例如,你希望在选择器中直接启动一个带指定参数的外部程序,可以在 Lua 配置中添加 Profile: + +```lua +local pebrel = require 'pebrel' +local config = pebrel.config_builder() + +config.profiles = { + { + name = 'SSH — 开发服务器', + command = 'ssh', + args = { 'dev@example.com' }, + }, +} + +return config +``` + +把示例地址换成自己的服务器。保存后执行 `pebrel config check` 检查配置,再从 Shell 选择器打开这个入口。 + +该例使用外部 `ssh` 命令。需要 Pebrel 的主机管理、连接测试和 SFTP 文件面板时,使用[内置 SSH 连接](ssh.md)。 + +## Shell 打不开时 + +如果创建标签后立即退出,先从系统终端运行同一程序,检查路径和启动参数。自定义 Profile 中,程序路径放在 `command`,每个参数分别放进 `args`,不要把整条命令和所有参数合成程序名。 + +WSL 发行版入口与 Windows 本地 Shell 的文件路径不同,具体见[使用 WSL](wsl.md)。 diff --git a/docs/site/content/ssh-auth.md b/docs/site/content/ssh-auth.md new file mode 100644 index 000000000..dd4049f07 --- /dev/null +++ b/docs/site/content/ssh-auth.md @@ -0,0 +1,47 @@ +## 使用账户密码 + +编辑主机,在 **基本**页选择 **密码**认证,填写用户名与密码。希望以后自动使用该密码时,勾选保存到系统凭据库的选项,然后保存主机。 + +Windows 使用凭据管理器,macOS 使用钥匙串;Linux 需要可用且已解锁的系统凭据服务。保存失败时,仍可按连接提示临时输入密码。 + +编辑已有连接时,密码框留空会保留已保存的密码。需要移除已存凭据时,使用界面提供的清除操作,不要把留空当成删除。 + +## 使用私钥 + +1. 编辑主机,将认证方式切换为 **密钥**。 +2. 点击 **选择私钥文件**,选取本机私钥。 +3. 有多个身份时,按需要添加其他私钥文件。 +4. 测试连接;出现私钥口令提示时,输入创建该密钥时设置的口令。 + +私钥通常与同名 `.pub`公钥文件成对存在。这里选择的是私钥;公钥应预先由服务器管理员配置到对应账户。 + +没有手动指定密钥时,连接会结合 SSH config 的 `IdentityFile`和常见默认私钥位置查找。使用 agent 的环境中,也需要确认 agent 中确实加载了所需身份。 + +## 使用自动认证 + +选择 **自动**,让连接先尝试可用密钥,再按需要使用密码。服务器只允许公钥认证时,仍需提供被服务器认可的密钥,密码不会代替它。 + +存在多个身份、经常连错账户时,给这个主机显式指定用户名和私钥,比依赖多个默认身份更容易排查。 + +## 验证码和多轮认证 + +服务器使用动态验证码或键盘交互认证时,选择 **交互式**。启动连接后,逐项阅读服务器发来的问题,再输入密码、验证码等内容。 + +验证码有有效期,输入新的验证码;不需要把动态验证码保存到主机库。服务器问题的内容由服务器决定,不一定每次相同。 + +## 查看主机密钥提示 + +账户认证前还可能出现服务器指纹确认。账户密码或私钥用于证明“你是谁”,主机指纹用于确认“连到的是哪台服务器”。首次使用或指纹变化时,都应独立核对。 + +## 认证失败时检查什么 + +| 提示或现象 | 优先检查 | +| --- | --- | +| 密码认证失败 | 用户名、密码、服务器是否允许密码登录 | +| 私钥无法读取 | 选中的是否为私钥、文件是否存在、当前用户的读取权限 | +| 私钥口令错误 | 是否输入了密钥口令,而不是服务器账户密码 | +| 多个身份均被拒绝 | 为该主机显式选择正确私钥,检查服务器授权 | +| 验证码一直失败 | 选择交互式认证,并检查验证码和设备时间 | +| 无法保存密码 | 系统凭据服务是否可用、是否已解锁 | + +换电脑时,主机 CSV 可以携带连接信息,但密码和私钥需要单独配置,见[迁移](migration.md)。 diff --git a/docs/site/content/ssh-config.md b/docs/site/content/ssh-config.md new file mode 100644 index 000000000..026f1ec8e --- /dev/null +++ b/docs/site/content/ssh-config.md @@ -0,0 +1,54 @@ +## 给连接取一个别名 + +SSH config 可以把地址、用户名、端口和密钥路径放在一个有名称的条目里。用户配置通常位于 `~/.ssh/config`;Windows 对应用户目录下的 `.ssh\config`。 + +例如,为开发服务器添加: + +```sshconfig +Host development + HostName example.com + User dev + Port 22 + IdentityFile ~/.ssh/id_ed25519 +``` + +把地址、账户和私钥路径换成自己的信息。`Host development`定义别名,`HostName`才是真正连接的服务器地址。 + +## 在 Pebrel 中使用 + +1. 保存 SSH config 文件。 +2. 打开 **设置 → SSH**。 +3. 使用重新读取入口刷新已发现的主机。 +4. 查找 `development`并启动连接。 +5. 首次连接时核对指纹,再处理认证提示。 + +如果已经另外保存过同一服务器的主机条目,可以给两者设置容易区分的名称,避免误用不同账户。 + +## 通过跳板机连接 + +配置中可以使用一个独立别名描述跳板,例如: + +```sshconfig +Host bastion + HostName bastion.example.com + User gateway + +Host internal-dev + HostName 10.0.0.20 + User dev + ProxyJump bastion +``` + +然后在主机的 **高级**设置中,让跳板策略 **跟随 SSH config**。也可以改为 **指定主机**,为这一条连接单独设置跳板。界面中的连接规则预览可帮助确认实际路线。 + +涉及多个跳板、复杂匹配或其他 OpenSSH 选项时,先查看 Pebrel 的连接预览并测试;并非所有外部 SSH 配置选项都具有相同支持范围。代理与跳板的具体操作见[连接路由](ssh-routing.md)。 + +## 修改后没有生效 + +确认修改的是当前用户的配置文件,保存后重新读取,再新建连接。已经建立的 SSH 会话不会中途切换到新地址或新密钥。 + +在 Pebrel 中保存的主机覆盖项也可能影响连接。检查 **高级**页是否设置为跟随配置,还是显式指定了代理或跳板。 + +## 隐藏或移除别名 + +只是不想在 Pebrel 列表中看到某个别名时,可以隐藏它。想从 SSH 配置本身移除连接,则编辑原文件并删除相应段落,再刷新列表。修改原文件前保留备份,尤其是在其他 SSH 客户端也使用它的情况下。 diff --git a/docs/site/content/ssh-library.md b/docs/site/content/ssh-library.md new file mode 100644 index 000000000..e8342b7ec --- /dev/null +++ b/docs/site/content/ssh-library.md @@ -0,0 +1,48 @@ +## 查找一台主机 + +打开 **设置 → SSH**,在搜索框输入名称、地址、分组、标签或备注。经常使用的主机可以置顶,方便从列表找到。 + +建议用用途命名条目,例如“开发环境”或“日志服务器”;同一地址的不同账户,也可以在名称中写明账户用途。 + +## 编辑连接和分类 + +打开条目的编辑入口,在 **基本**页修改地址、端口、用户名或认证方式。分组、标签和备注用于整理列表,可以填写环境、项目和用途。 + +保存前检查地址与用户名,再使用 **测试连接**确认。如果只想更改列表显示文字,修改 **主机名称**即可,不必改服务器地址。 + +## 使用 SSH config 中的主机 + +Pebrel 可以发现用户 SSH config 文件中的别名。修改配置后,使用列表的重新读取入口刷新。 + +从配置文件发现的主机可以在 Pebrel 列表里隐藏;这不会删除原 SSH config 条目。要重新显示,使用隐藏项的恢复入口。如何编写别名和 IdentityFile,见[使用 SSH config](ssh-config.md)。 + +## 导出主机列表 + +在 SSH 主机库的导出入口选择 CSV 文件位置。导出的连接元数据包含以下列: + +```csv +destination,label,group,tags,notes +dev@example.com,开发服务器,开发环境,linux;test,测试账户 +``` + +CSV 不包含密码、私钥内容或私钥口令。它适合备份地址与分类,或在另一台电脑上重建主机列表。 + +## 批量导入主机 + +1. 先从 Pebrel 导出一份 CSV,保留列名作为模板。 +2. 在副本中填写地址、显示名称及分类信息。 +3. 使用导入入口选择文件。 +4. 查看导入结果,确认新增、跳过或失败的条目。 +5. 为新增主机补充认证信息,再测试连接。 + +已有条目不会被导入文件覆盖;重复项会按导入规则跳过。地址或端口有误时,先修正对应行再导入。文件较大时可以分批处理,并逐批查看结果。 + +包含逗号、引号或换行的字段需要正确的 CSV 引号转义。不要把密码或私钥加进表格;非空的敏感凭据列会被拒绝。 + +## 删除主机 + +选择条目的删除入口,并确认删除提示。如果其他连接正在引用它作为跳板,先调整这些连接的跳板设置。 + +删除主机记录不会删除服务器上的文件。配置文件发现的条目需要永久移除时,应编辑原 SSH config;仅在 Pebrel 隐藏时仍可恢复。 + +换电脑后的凭据处理见[备份与迁移](migration.md)。 diff --git a/docs/site/content/ssh-routing.md b/docs/site/content/ssh-routing.md new file mode 100644 index 000000000..b170c3146 --- /dev/null +++ b/docs/site/content/ssh-routing.md @@ -0,0 +1,46 @@ +## 先确认需要哪种连接方式 + +直接能访问服务器时,保持直连即可。网络只允许通过代理访问外部地址时,设置代理;服务器位于内部网络、必须经过堡垒机时,设置跳板。 + +编辑主机并打开 **高级**页,可以分别配置这两部分。 + +## 使用全局代理 + +1. 在 **设置 → 网络**填写代理类型、地址、端口及必要的认证信息。 +2. 使用网络测试入口检查代理。 +3. 编辑 SSH 主机,打开 **高级**页。 +4. 将代理策略设为 **跟随全局**,保存并测试连接。 + +某台主机不需要代理时,把它的代理策略改为 **不使用**;不必关闭所有连接共用的全局代理。 + +## 为单台主机指定代理 + +在主机的 **高级**页选择自定义代理,填写 SOCKS5 或 HTTP CONNECT 代理的地址和端口。代理要求认证时,再填写用户名和密码。 + +代理端口应在 `1–65535`范围内。填写密码时同时填写用户名;编辑后先用 **测试连接**检查,再保存为日常连接。 + +HTTP CONNECT 代理的认证传输本身不等同于经过 TLS 保护的代理通道。使用不可信网络时,应选择管理员提供的安全接入方式。 + +## 使用跳板机 + +假设目标是内部主机 `10.0.0.20`,需要经过 `gateway@bastion.example.com:22`: + +1. 为目标主机填写它自己的地址、用户名和认证信息。 +2. 在 **高级 → 跳板**中选择 **指定主机**。 +3. 选择已有跳板条目,或填写 `gateway@bastion.example.com:22`。 +4. 查看 **连接规则预览**,确认路线经过跳板再到目标。 +5. 测试连接,按需处理跳板和目标各自的认证提示。 + +已有 SSH config 的 `ProxyJump`设置时,可以选择 **跟随 SSH config**。需要忽略配置里的跳板时,选择 **不使用**。 + +跳板账户和目标服务器账户可能不同,请分别填写。把目标密码填给跳板,不会让后续认证自动成功。 + +## 同时使用代理和跳板 + +代理作用于连接路线的第一段。例如可以先通过代理连接堡垒机,再由堡垒机访问内部服务器。使用连接规则预览检查第一跳,避免代理指向或跳板地址配置反了。 + +## 找出失败的是哪一段 + +先测试代理或堡垒机自身是否可达,再测试目标连接。代理拒绝通常需要检查类型、端口和代理认证;跳板认证失败检查跳板账户;到达跳板后仍超时,检查它到内部目标的网络与防火墙。 + +服务器指纹校验仍需要按提示完成,代理和跳板不会替代身份校验。 diff --git a/docs/site/content/ssh.md b/docs/site/content/ssh.md new file mode 100644 index 000000000..8f6c6315b --- /dev/null +++ b/docs/site/content/ssh.md @@ -0,0 +1,60 @@ +## 准备连接信息 + +向服务器管理员取得主机地址、端口、用户名,以及密码或私钥。首次连接还需要核对服务器指纹。下面以 `dev@example.com`、端口 `22`为例;操作时换成你的实际信息。 + +## 添加主机 + +1. 打开 **设置 → SSH**,选择 **添加 SSH 主机**。 +2. 在 **基本**页填写下列信息。 +3. 选择认证方式并补充相应字段。 +4. 点击 **测试连接**,处理认证提示和服务器身份确认。 +5. 测试成功后点击 **保存**。 + +| 字段 | 示例 | 说明 | +| --- | --- | --- | +| **主机名称** | 开发服务器 | 列表中的显示名称,便于查找 | +| **主机地址** | example.com | 域名或 IP 地址,为必填项 | +| **端口** | 22 | 使用管理员提供的 SSH 端口 | +| **用户名** | dev | 服务器上的账户名 | + +地址也可以包含连接信息,例如 `dev@example.com`或 `ssh://dev@example.com:2222`。为便于检查,首次设置时可以分别填写地址、端口和用户名。 + +## 选择认证方式 + +**密码**:填写账户密码。需要记住密码时,勾选保存到系统凭据库的选项;否则连接时按提示输入。 + +**密钥**:点击 **选择私钥文件**,选择私钥,而不是扩展名为 `.pub`的公钥。私钥设置了口令时,连接过程中还会询问口令。 + +**自动**:先尝试可用密钥,再按需要使用密码。 + +**交互式**:适合服务器要求多轮提问、动态验证码或其他交互认证的情况。问题会在连接过程中逐项显示。 + +完整说明见[密码、密钥与交互认证](ssh-auth.md)。 + +## 确认服务器指纹 + +首次连接时,Pebrel 可能显示服务器的主机密钥指纹。通过管理员、服务器控制台或其他独立可信渠道核对,确认一致后再接受。 + +> [!WARNING] +> 已连接过的服务器突然出现指纹变更时,先停止连接并向管理员确认原因。不要仅为了消除提示而直接接受新指纹。 + +## 打开远端终端 + +保存后,从 SSH 主机列表选择这个条目的连接入口。登录完成并出现远端提示符后,运行: + +```sh +hostname +pwd +``` + +确认显示的是目标服务器和预期目录。需要并排处理本地与远端工作时,可以使用[分屏](workspace.md)。 + +## 浏览服务器文件 + +聚焦这个 SSH 窗格,再打开文件面板。远端文件列表可用于浏览目录、上传、下载和编辑支持的文本文件。完整操作见[SFTP](sftp.md)。 + +## 连接未成功 + +超时先检查网络、VPN、地址和端口;“认证失败”先检查账户及认证方式。需要经过代理或跳板机时,编辑主机并打开 **高级**页,按[代理与跳板](ssh-routing.md)设置。 + +“测试连接”通过后仍无法启动所需程序时,在远端终端检查程序是否已安装、当前账户是否有权限。 diff --git a/docs/site/content/svn.md b/docs/site/content/svn.md new file mode 100644 index 000000000..ab152c183 --- /dev/null +++ b/docs/site/content/svn.md @@ -0,0 +1,43 @@ +## 打开工作副本 + +先用 SVN 客户端检出项目,再在 Pebrel 终端进入这个工作副本。打开 **版本控制面板**,保持 **设置 → 交互 → 侧栏版本控制**为 **自动检测**或 **仅 SVN**。 + +常规 SVN 操作需要可用的 `svn`命令或对应客户端。安装后,重新打开 Pebrel,并在终端运行 `svn --version`检查命令行环境。 + +## 添加并提交文件 + +查看变更列表,把尚未纳入版本控制的新文件添加到 SVN。检查准备提交的文件,填写提交信息后执行提交。 + +SVN 的添加是将新文件纳入版本控制;它不等同于 Git 的暂存区。提交会联系版本库服务器,需要网络和对应账户权限。 + +## 更新工作副本 + +使用更新入口获取服务器上的新修订。更新前检查本地未提交的改动;出现冲突时先处理冲突文件,再继续提交。 + +对已经手动解决的冲突,**解决**操作会保留当前文件内容并标记冲突已解决。点击前先确认文件里已经没有需要处理的冲突内容。 + +## Windows 上使用 TortoiseSVN + +安装 TortoiseSVN 后,Pebrel 的 **更多 SVN 操作**菜单可以打开它的图形界面。例如: + +| 菜单项 | 用途 | +| --- | --- | +| **版本库浏览器** | 查看服务器上的目录和文件 | +| **更新至版本…** | 将工作副本更新到指定修订 | +| **分支 / 标记…** | 创建分支或标记 | +| **切换…** | 切换当前工作副本对应的路径 | +| **合并…** | 打开 SVN 合并流程 | +| **导出…** | 导出不含工作副本管理信息的文件 | +| **修订图** | 查看修订关系 | +| **重定位…** | 更改版本库位置 | +| **属性 / 清理** | 查看属性或处理工作副本维护操作 | + +这些操作会进入外部客户端的对话框,按对话框中的路径、修订和确认步骤完成。安装 TortoiseSVN 后若仍提示不可用,重新启动 Pebrel 再检测。 + +## 对单个文件操作 + +文件行的更多菜单提供 **显示日志**、**责任追溯**、**获得锁定…**、**释放锁定**、**加入忽略列表…**、**重命名…**、**删除**、**编辑冲突**和 **属性**。 + +锁定适合需要独占编辑的文件;修改完成后按团队流程提交并释放锁。删除和重命名会改变工作副本状态,提交前再次检查变更列表。 + +macOS 和 Linux 不提供 TortoiseSVN 的 Windows 图形入口,可以在终端使用 `svn`或系统上的 SVN 客户端完成对应操作。 diff --git a/docs/site/content/terminal-basics.md b/docs/site/content/terminal-basics.md new file mode 100644 index 000000000..f798d7081 --- /dev/null +++ b/docs/site/content/terminal-basics.md @@ -0,0 +1,52 @@ +## 输入命令并查看结果 + +终端提示符后的光标表示 Shell 正在等待输入。输入命令,按 **Enter** 执行;程序结束后,提示符会再次出现。 + +```sh +echo Hello, Pebrel +``` + +如果程序持续显示日志且没有新的提示符,它可能还在运行。可以另开一个[标签页或分屏](workspace.md)执行其他命令。 + +## 查看和切换目录 + +| 操作 | PowerShell / macOS / Linux / WSL | Windows cmd | +| --- | --- | --- | +| 查看当前目录 | `pwd` | `cd` | +| 列出文件 | `ls` | `dir` | +| 返回上一级 | `cd ..` | `cd ..` | +| 进入指定目录 | `cd "路径"` | `cd /d "路径"` | + +命令在当前窗格的目录里运行。切换到另一个窗格后,先查看它的目录;各个 Shell 的目录可以不同。 + +路径中的空格需要用引号包围。例如 PowerShell 中的 `cd "C:\My Projects\demo"`,或 macOS 中的 `cd "$HOME/My Projects/demo"`。 + +## 停止运行中的命令 + +通常按 **Ctrl+C** 可向当前程序发送中断请求。Windows / Linux 有文字选中时,Ctrl+C 会先复制选区;先清除选区再中断。macOS 复制使用 **⌘C**,中断仍使用 **Ctrl+C**。 + +程序可能要求确认退出,或自行处理这次中断。回到提示符后,再输入下一条命令。 + +## 查看之前的输出 + +使用滚轮或触控板向上滚动。普通终端画面还支持: + +| 按键 | 作用 | +| --- | --- | +| Shift+PageUp / Shift+PageDown | 按页查看输出 | +| Shift+Home | 移到保留的历史顶部 | +| Shift+End | 返回输出底部 | + +进入 Vim、less 等全屏程序后,优先使用该程序自己的导航按键。程序接管鼠标时,按住 **Shift** 再用鼠标,可使用终端的选择或滚动操作。 + +## 保留更多历史输出 + +打开 **设置 → 外观 → 终端外观**,调整 **回滚行数**。这个数值控制每个窗格能保留的历史行数;修改后,新建终端窗格使用新设置。增加行数会增加长时间运行时的内存用量。 + +**滚动速度**用于调整鼠标滚轮滚动的行数,修改后立即生效;触控板手势不受该倍率控制。 + +## 当前窗格运行在哪台机器 + +本地 Shell 使用电脑上的文件和程序;WSL 使用所选发行版的环境;SSH 使用远端服务器的环境。需要确认位置时,先查看标签、Shell 类型和当前目录,再运行 `pwd` 或 `hostname`。 + +这一步在复制文件路径、启动 AI 工具和执行修改命令前尤其有用。进一步阅读:[WSL](wsl.md)、[SSH](ssh.md)、[复制与粘贴](clipboard.md)。 diff --git a/docs/site/content/themes.md b/docs/site/content/themes.md new file mode 100644 index 000000000..447b774ae --- /dev/null +++ b/docs/site/content/themes.md @@ -0,0 +1,49 @@ +## 从已有主题创建副本 + +1. 打开 **设置 → 外观 → 更换主题**。 +2. 选择接近目标的主题,从 **作为模板**入口进入 **自定义主题**。 +3. 填写 **主题名称**,例如“我的深色配色”。 +4. 修改需要的颜色或字体,观察旁边的预览。 +5. 点击 **保存并应用**,回到终端检查效果。 + +创建副本不会改动内置模板。只想先收藏这套配色时,点击 **仅保存**,稍后再从自定义主题中选择。 + +## 调整常用设置 + +**常用设置**包含终端背景、文字颜色、强调色、光标颜色、字体、字号、行高和不透明度。 + +例如,文字拥挤时可以略微增加行高;光标不容易看清时,选择与背景有明显差异的光标颜色。预览包含终端、界面和 ANSI 色彩,修改后分别检查这几处。 + +预览中的变化在应用前不会改动当前终端。离开编辑器时如出现未保存提示,可以选择继续编辑,或放弃草稿。 + +## 调整调色板和界面细节 + +展开 **高级设置**,可继续调整 **ANSI 16 色**、选区背景、选区文字、光标文字,以及主题支持的圆角、留缝、阴影和分割线。 + +ANSI 颜色影响命令行程序输出的不同颜色;选区颜色影响鼠标选中的文字。修改后查看一段带颜色的输出和一段选区,确认文字仍清晰。 + +颜色或数值格式不正确时,修正标出的字段再保存。需要回到当前模板的起点时,使用 **重置修改**。 + +## 导入其他终端的配色 + +选择 **导入**并打开主题文件。Pebrel 可以读取自身 JSON 主题,以及当前版本支持的其他静态主题格式。 + +1. 选择文件,等待读取完成。 +2. 一个文件包含多套配色时,在候选主题中选择一项。 +3. 查看 **导入说明**,确认不支持或未映射的字段。 +4. 点击 **作为模板**,将配色载入编辑器。 +5. 检查预览后点击 **保存并应用**,或 **仅保存**。 + +如果某种主题文件不能直接导入,可先整理为 Pebrel 支持的静态配色格式;包含脚本或动态计算的整份配置,也应先转换为纯配色数据。 + +## 导出主题 + +在编辑器选择 **导出**,选择目标格式,查看 **此格式不会保留的设置**,再指定保存位置。 + +保留 Pebrel 的完整主题设置时,使用 **Pebrel**格式。导出到其他终端时,主要保留目标格式能表达的配色,Pebrel 特有的界面设置可能不会保留。 + +## 避免丢失草稿 + +切换模板会替换当前尚未保存的修改。想比较两个方案时,先保存第一个副本,再从另一个模板创建新副本。 + +多个窗口同时编辑主题而出现保存冲突时,先保留当前草稿,再重新读取主题库比较,不要覆盖另一个窗口刚保存的结果。 diff --git a/docs/site/content/troubleshooting.md b/docs/site/content/troubleshooting.md new file mode 100644 index 000000000..3b83918e7 --- /dev/null +++ b/docs/site/content/troubleshooting.md @@ -0,0 +1,82 @@ +## 应用打不开或没有窗口 + +先确认安装包与系统、处理器匹配,并已完整解压。Windows 便携版保留整个目录;macOS 从 Applications 启动,不从 DMG 内直接运行;Linux TAR.GZ 使用包内 `AppRun`。 + +Windows 开启过 **静默启动**或 **关窗后保留后台会话**时,先检查系统托盘。macOS 被系统阻止时,按[首次启动说明](installation.md)处理。 + +仍无法启动时,从系统终端运行对应程序并保留错误输出,不要先删除所有个人数据。 + +## 新终端立即退出 + +先从系统终端运行同一 Shell,确认它本身可以启动。再检查 **设置 → 终端 → 默认 Shell**与启动目录。 + +自定义 Profile 的 `command`只填写程序,参数放在 `args`。WSL 先用 `wsl -d 发行版名称`检查发行版是否可启动。修改后新建标签测试。 + +## 字体缺字、箭头变成方框或列不齐 + +恢复默认终端字体和字号,再检查 **中文终端字体**、**字体间距**与 **字体连字**。Powerline 箭头需要字体提供相应字形。 + +只有背景影响阅读时,先关闭图片和模糊、提高不透明度。详细步骤见[字体](fonts.md)。 + +## SSH 连接超时 + +检查服务器地址、端口、VPN 和本地网络。需要代理或跳板时,编辑主机的 **高级**页,查看连接规则预览。 + +先测试第一跳,再检查跳板到目标的连通性。端口可达后仍认证失败,转到下一项,不必反复更换终端字体或 Shell。 + +## SSH 认证失败或指纹变化 + +核对用户名,确认选择了服务器允许的认证方式。私钥认证选择私钥而非 `.pub`文件,密钥口令与账户密码分开输入;需要验证码时选择交互式认证。 + +指纹变化先向管理员确认,不要直接接受以跳过错误。详见[SSH 认证](ssh-auth.md)。 + +## 文件树没有跟随当前目录 + +先在终端运行 `pwd`(cmd 使用 `cd`)确认位置,再点击 **跟随当前终端并刷新**。手动进入其他目录后,需要通过跟随入口回到终端位置。 + +仍不更新时,检查当前 Shell 的目录上报是否可用。SSH 文件列表使用 **重新跟随**和 **重新读取**。 + +## SFTP 上传或下载失败 + +查看目标路径,检查源文件读取权限、目标写入权限、磁盘空间与 SSH 连接。目标在文件选择期间发生变化时,回到正确目录重新发起传输。 + +有同名冲突时明确选择覆盖、跳过或保留两者。取消之后检查哪些文件已完成,再重新传输,见[SFTP](sftp.md)。 + +## 文档无法编辑或保存 + +本地 Markdown 先使用 **文档操作 → 源码**;阅读视图不能直接编辑段落。超过 8 MB 或非完整 UTF-8 文本可能只读,需要外部编辑器。 + +保存冲突先复制未保存内容,再重新读取并比较。远端保存失败还需检查服务器权限与网络,见[远端编辑](remote-edit.md)。 + +## AI 图标、活动状态或历史缺失 + +先在同一终端检查 CLI 是否可运行。Windows 集成更改后重启 CLI;工具状态异常时刷新 **设置 → Agents**并检查集成结果。 + +历史恢复需要对应工具的会话记录和有效身份。右键标签使用重试或选择会话入口,或在 CLI 自己的历史里查找,见[AI 会话历史](ai-history.md)。 + +## 设置改了却没有效果 + +先确认修改的是正确设置:界面字号与终端字号分开,背景图片不透明度与终端不透明度分开,网络代理与新终端系统代理开关分开。 + +Shell、回滚行数和进程环境需在新建窗格中验证。Lua 配置报错时运行 `pebrel config check`;存在 GUI 覆盖项时检查 **设置**中的当前值。 + +## 更新后还是旧版本 + +完全退出后台实例,检查快捷方式是否仍指向旧目录。便携版应从新解压目录启动,macOS 应从替换后的 Applications 应用启动,再检查 **设置 → 应用**的版本号。 + +## 提交问题反馈 + +打开 **设置 → 应用 → 反馈问题**,提供下面的信息: + +```text +Pebrel 版本: +系统和处理器架构: +安装方式:安装程序 / ZIP / DMG / DEB / AppImage / TAR.GZ +Shell 或远端环境: +操作步骤: +预期结果: +实际结果和错误文字: +是否能稳定重现: +``` + +附上能说明问题的截图或脱敏日志。不要附上密码、Token、私钥或运行时发现文件。涉及主题、字体或缩放时,再补充对应设置。 diff --git a/docs/site/content/updates.md b/docs/site/content/updates.md new file mode 100644 index 000000000..4fa40571f --- /dev/null +++ b/docs/site/content/updates.md @@ -0,0 +1,49 @@ +## 检查是否有新版本 + +打开 **设置 → 应用**,查看当前版本并点击 **检查更新**。发现新版本后,打开更新详情查看下载和安装操作。 + +**自动检查更新**控制后台检查,预下载选项用于提前下载更新包。当前界面中的更新通道显示为 **Stable**。 + +更新前保存文档,并结束或安排好运行中的任务。下载完成后仍需按安装提示继续,重新启动后才能使用新程序。 + +## Windows 安装版 + +使用官方安装程序安装的版本,可以通过更新详情下载并安装。按提示完成安装器流程,然后重新启动 Pebrel。 + +完成后回到 **设置 → 应用**,检查版本号是否已更新。安装正在进行时,不要同时手动替换应用文件。 + +## Windows 便携版 + +便携目录使用手动替换包的方式: + +1. 下载匹配架构的新 ZIP。 +2. 备份配置,并正常退出 Pebrel,包括后台驻留实例。 +3. 将新 ZIP 完整解压到新的目录。 +4. 迁移放在旧程序目录旁的个人配置或素材。 +5. 启动新目录中的 `pebrel.exe`,检查版本和设置。 + +确认新版本正常后,再清理旧程序目录。只替换 EXE 可能遗漏随包资源;ARM64 与 x64 包也不要混用。 + +## macOS + +从 Applications 中运行的可写 Pebrel `.app`可使用受支持的更新安装入口。按更新详情提示保存工作、退出相关运行实例并继续安装。 + +如果提示当前安装位置不支持更新,或安装未成功:下载匹配 Apple Silicon / Intel 的官方 DMG,退出 Pebrel,再将应用拖入 Applications 替换。 + +不要从仍挂载的 DMG 或被系统临时转移的路径直接安装更新。完成后从 Applications 重新启动并检查版本;首次启动的系统确认见[安装](installation.md)。 + +## Linux + +使用与当前安装方式一致的新包。DEB 用户通过包管理器安装新版本;AppImage 用户退出旧进程后运行新的 AppImage;TAR.GZ 用户完整解压新包后使用其中的 `AppRun`。 + +Linux 当前仍需手动完成包替换。更新检查可以帮助发现版本,不会自动代替包管理器更新系统安装。 + +## 更新失败 + +**下载失败:**检查网络代理、磁盘空间和 Release 资产是否可访问。 + +**无法写入应用目录:**检查安装位置与权限,必要时改用官方安装包手动更新。 + +**重开后还是旧版本:**检查启动的是不是旧目录中的快捷方式,以及后台是否仍有旧进程。 + +反馈时提供版本号、系统、架构、安装方式和完整错误文字。升级前的数据保存方法见[备份与迁移](migration.md)。 diff --git a/docs/site/content/vcs.md b/docs/site/content/vcs.md new file mode 100644 index 000000000..1153cc32a --- /dev/null +++ b/docs/site/content/vcs.md @@ -0,0 +1,44 @@ +## 查看项目改动 + +在本地终端进入 Git 仓库,按 **Ctrl+Shift+G**(macOS 为 **⌘⇧G**)打开版本控制面板。面板会显示当前仓库、分支和文件状态。 + +如果显示的不是当前项目,使用 **回到终端当前目录**;执行外部 Git 命令后,点击刷新按钮重新读取状态。 + +在 **设置 → 交互 → 侧栏版本控制**中,可以选择 **自动检测**、**仅 Git**或 **仅 SVN**。 + +## 暂存准备提交的文件 + +1. 查看 **变更**列表,打开文件检查内容。 +2. 对需要提交的文件选择 **暂存**。 +3. 在 **已暂存**列表确认本次提交范围。 +4. 放错文件时,选择 **取消暂存**将它移回未暂存区域。 + +确定所有改动都属于同一任务时,可以使用 **全部暂存**。取消暂存只调整提交范围,不会丢失工作区里的文件修改。 + +## 创建提交 + +在提交信息框输入简短说明,例如“修正安装指南中的目录示例”,点击 **提交**。成功后刷新状态,已提交的改动会从待提交列表中移除,并出现在历史中。 + +提交失败时,阅读错误消息。Git 用户身份未设置、提交钩子失败或冲突未解决,都需要先在当前仓库处理,再重试。 + +## 拉取和推送 + +使用 **拉取**获取远端更新,使用 **推送**发送本地提交。提交到本地仓库后,仍需推送才能让远端看到它。 + +远端认证由当前 Git 环境处理;SSH 主机库保存的登录凭据不一定用于 Git。可以在同一终端运行 `git remote -v`检查远端地址。 + +拉取出现冲突时,转到[解决 Git 冲突](git-conflicts.md),不要反复点击拉取或直接丢弃文件。 + +## 阅读历史和分支线路 + +切换到历史相关视图,查看提交信息及线路。线路显示提交之间的连接关系,便于识别分支和合并。检查某次改动时,先确认仓库路径和当前分支,再查看对应文件。 + +## 丢弃不需要的修改 + +对未提交的改动使用 **丢弃改动**,并在确认框核对范围。它会撤销相应文件的本地修改;需要保留的部分应先复制或提交。 + +“取消暂存”用于暂时不提交,“丢弃改动”用于撤销修改,两者不能互换。 + +## 使用 SVN + +进入 SVN 工作副本后,自动检测模式会切换到相应操作。SVN 使用添加、更新和提交,没有 Git 的暂存区与推送步骤。Windows 上的高级图形操作可交由 TortoiseSVN,见[SVN 工作副本](svn.md)。 diff --git a/docs/site/content/workspace.md b/docs/site/content/workspace.md new file mode 100644 index 000000000..e8593ccea --- /dev/null +++ b/docs/site/content/workspace.md @@ -0,0 +1,53 @@ +## 窗口、标签页和窗格 + +一个 Pebrel 窗口可以容纳多个标签页。终端标签页里又可以分成多个窗格,每个窗格都有自己的 Shell、当前目录和运行中的程序。 + +例如,可以为两个项目分别建立标签页,在每个标签页里分出“运行服务”和“查看日志”两个窗格。切换项目时切换标签页;同时查看输出时使用分屏。 + +## 创建和切换标签页 + +点击新建终端入口,或按 **Ctrl+Shift+T**(macOS 为 **⌘T**)。需要为新终端选择不同 Shell 时,使用 **Ctrl+K / ⌘K** 打开 Shell 选择器。 + +点击标签即可切换。也可以使用 **Ctrl+Tab** 切到下一个标签、**Ctrl+Shift+Tab** 切到上一个标签;macOS 还支持 **⌘⇧] / ⌘⇧[**。 + +在 **设置 → 交互** 中,**标签栏位置**可选择“左侧边栏”或“顶部”,**新标签位置**可选择“当前标签之后”或“列表末尾”。 + +## 创建分屏 + +1. 点击准备拆分的终端窗格。 +2. 右键标签页,选择 **左右分屏**或**上下分屏**。 +3. 新窗格出现后,点击它并运行需要的命令。 + +快捷键:Windows / Linux 使用 **Ctrl+Shift+D** 向右分屏、**Ctrl+Shift+S** 向下分屏;macOS 使用 **⌘D / ⌘⇧D**。 + +拖动分隔线可以改变两个窗格的大小。需要暂时集中看一个窗格时,按 **Ctrl+Shift+Enter / ⌘⇧Enter** 放大当前窗格,再按一次还原布局。 + +## 在窗格之间移动 + +点击窗格可以将输入焦点移过去。使用键盘时,按 **Ctrl+Alt+方向键**(macOS 为 **⌘⌥方向键**)切换到相邻窗格。 + +拖动窗格标题可以调整排布;将标题拖出终端区域,可以把该窗格拆成独立标签。拖动前先辨认窗格标题与分隔线:前者移动窗格,后者调整大小。 + +## 重命名、排序和标色 + +右键标签页打开菜单: + +| 操作 | 用途 | +| --- | --- | +| **重命名** | 输入项目名或用途,例如“API 日志”;也可使用 F2 | +| **向左移动 / 向右移动** | 调整标签顺序;位于边缘时,对应方向不可用 | +| **标签颜色** | 用颜色区分项目或环境;选择清除项可恢复默认 | +| **移到新窗口** | 将这项工作移到单独窗口中 | +| **复制标签** | 用同类启动入口新建会话,并尽量沿用已知工作目录 | + +“复制标签”适合在同一目录再开一个 Shell;原终端里正在运行的命令仍留在原标签中。 + +## 收起侧栏 + +点击侧栏收起按钮,或按 **Ctrl+Shift+B / ⌘B**。打开文件树时使用 **Ctrl+Shift+F / ⌘⇧F**。终端区域需要更多空间时,可以收起不使用的面板。 + +如果经常使用同一套排布,打开命令面板搜索“布局”,将当前标签或窗口保存为[布局配方](layouts.md)。 + +## 关闭终端 + +在 Shell 中输入 `exit`,或使用关闭入口。关闭前先停止仍需处理的命令,并保存文档标签中的修改。有关 Windows 关窗后保留任务、重启后恢复标签的设置,见[会话保存与恢复](sessions.md)。 diff --git a/docs/site/content/wsl.md b/docs/site/content/wsl.md new file mode 100644 index 000000000..213ad91a9 --- /dev/null +++ b/docs/site/content/wsl.md @@ -0,0 +1,60 @@ +## 打开已安装的发行版 + +**此页适用于 Windows 上的 WSL。** 先在 Windows 中安装并完成 WSL 发行版的初始化,再打开 Pebrel。 + +按 **Ctrl+K**打开 Shell 选择器,选择需要的发行版。进入后,运行: + +```sh +pwd +uname -s +``` + +`uname -s` 应显示 `Linux`。需要检查 Windows 已安装哪些发行版时,可以在 PowerShell 中运行: + +```powershell +wsl --list --verbose +``` + +刚安装的发行版没有出现在选择器中时,先用 Windows 的 WSL 入口启动一次,再重新打开 Pebrel。 + +## 进入 Linux 或 Windows 项目 + +Linux 用户目录通常通过 `~`访问。Windows C 盘在常见 WSL 配置下映射到 `/mnt/c`: + +```sh +cd ~/projects/my-project +``` + +或者进入 Windows 上的项目: + +```sh +cd /mnt/c/Projects/my-project +``` + +把路径换成实际目录。项目位于 Linux 文件系统时,优先使用 Linux 路径;需要复制路径给 WSL 命令时,可以使用文件树提供的 **复制 Linux 路径**。 + +## 将 WSL 作为默认终端 + +打开 **设置 → 终端 → 默认 Shell**,选择相应发行版,然后新建标签。需要沿用当前 Linux 目录时,在 **启动目录**右侧点击 **清除**,让该项显示“继承当前目录”。 + +复制已有 WSL 标签也会尽量使用已知工作目录。新标签打开后运行 `pwd`,可以确认目录是否已跟随。 + +## 安装开发工具和 AI CLI + +WSL 有独立的软件环境。需要在 WSL 中运行 Node.js、Python 或 AI CLI 时,在该发行版内安装并登录。Windows 中能运行某个命令,并不代表 WSL 的 Linux PATH 中也有它。 + +把项目文件交给 AI 之前,先在同一个 WSL 窗格中进入项目目录,再启动工具。 + +## 复制图片与使用 Pebrel CLI + +在 WSL 终端粘贴图片时,Pebrel 会插入适合该环境访问的路径。提交给 CLI 前,检查生成的路径是否完整。 + +从 Pebrel 启动的本地窗格会提供 CLI 环境信息,WSL 会转换相关路径。可以运行 `pebrel env --pretty` 检查;没有找到命令时,检查 `PEBREL_CLI` 指向的程序是否可从 WSL 执行。控制命令的使用见[终端自动化](runtime.md)。 + +## 常见问题 + +**打开后立刻退出:**先从 PowerShell 执行 `wsl -d 发行版名称`。如果也失败,先修复发行版本身的启动问题。 + +**命令可以运行,但字体或颜色不同:**WSL Shell 的提示符配置与 Windows Shell 分开,终端字体则仍在 Pebrel 的 **外观**中设置。 + +**文件树目录没有变化:**确认 Shell 能上报当前目录,再使用文件树的跟随和刷新入口。手动浏览过目录后,点击 **跟随当前终端并刷新**恢复跟随。 diff --git a/docs/site/screenshots.json b/docs/site/screenshots.json new file mode 100644 index 000000000..1641b5c06 --- /dev/null +++ b/docs/site/screenshots.json @@ -0,0 +1,86 @@ +{ + "nebula-top-tabs.png": { + "kind": "existing_repository_screenshot", + "source": "https://github.com/Kuddev/pebrel/blob/9dc058d12765893553d5fc7a2c37c870c96168b0/docs/screenshots/nebula-top-tabs.png", + "sha256": "a857a5d055fff00447e1e3ee5e36fc7b3e8618b1c7ab6c5343f26933ebd225d7", + "capture_version": "not established; do not infer from documentation version" + }, + "split-ai-workflows.png": { + "kind": "existing_repository_screenshot", + "source": "https://github.com/Kuddev/pebrel/blob/9dc058d12765893553d5fc7a2c37c870c96168b0/docs/screenshots/split-ai-workflows.png", + "sha256": "2d603eb796af45bd927c8ff9a0c3dcc74ffeb6d9df8ace1b5e7a7d5d0bb1fbfb", + "capture_version": "not established; do not infer from documentation version" + }, + "nebula-claude-session.png": { + "kind": "existing_repository_screenshot", + "source": "https://github.com/Kuddev/pebrel/blob/9dc058d12765893553d5fc7a2c37c870c96168b0/docs/screenshots/nebula-claude-session.png", + "sha256": "aac8e3e610c8d54a145ffe81a238f82415d3eefbe5a472d23b5adfc396352619", + "capture_version": "not established; do not infer from documentation version" + }, + "native-math-rendering.png": { + "kind": "existing_repository_screenshot", + "source": "https://github.com/Kuddev/pebrel/blob/9dc058d12765893553d5fc7a2c37c870c96168b0/docs/screenshots/native-math-rendering.png", + "sha256": "c1b8e356878ebf5fe368873d37f5daa0cca2de7688129f3a05ec28c8637d6e16", + "capture_version": "not established; do not infer from documentation version" + }, + "themes.png": { + "kind": "existing_repository_screenshot", + "source": "https://github.com/Kuddev/pebrel/blob/9dc058d12765893553d5fc7a2c37c870c96168b0/docs/screenshots/themes.png", + "sha256": "f8031403d4da402a8dd9388d72a7e13e3d1e31d3d7424a2a8ec0c4bbf9a04946", + "capture_version": "not established; do not infer from documentation version" + }, + "ai-sidebar.png": { + "kind": "existing_repository_screenshot", + "source": "https://github.com/Kuddev/pebrel/blob/9dc058d12765893553d5fc7a2c37c870c96168b0/docs/screenshots/ai-sidebar.png", + "sha256": "df0916d23dc254b9cbc31238c47606b27466104f800ba53f663674bca4dfc4da", + "capture_version": "not established; do not infer from documentation version" + }, + "notification-duration.png": { + "kind": "existing_repository_screenshot", + "source": "https://github.com/Kuddev/pebrel/blob/9dc058d12765893553d5fc7a2c37c870c96168b0/docs/screenshots/notification-duration.png", + "sha256": "bff479f36adf609b4fae95d79fcf751357cae133af46cdd9afeb1d6235fa4786", + "capture_version": "not established; do not infer from documentation version" + }, + "reader-selection-opacity.png": { + "kind": "existing_repository_screenshot", + "source": "https://github.com/Kuddev/pebrel/blob/9dc058d12765893553d5fc7a2c37c870c96168b0/docs/screenshots/reader-selection-opacity.png", + "sha256": "9264f5cdb5e34a9d1f101cb561cf4a8fcbdd67146199f4e99092e46ea7a9f23a", + "capture_version": "not established; do not infer from documentation version" + }, + "hero.png": { + "kind": "existing_repository_screenshot", + "source": "https://github.com/Kuddev/pebrel/blob/9dc058d12765893553d5fc7a2c37c870c96168b0/docs/screenshots/hero.png", + "sha256": "763d24c1cfe411e6624b77fcfa9dd3da82f5d0c5f4e237f52eada418312ce687", + "capture_version": "not established; do not infer from documentation version" + }, + "pebrel-1.9.1-macos-arm64-ci.png": { + "kind": "official_release_ci_screenshot", + "version": "1.9.1", + "platform": "macOS", + "architecture": "aarch64", + "reported_os_version": "26.6.2", + "source_commit": "e9e83d83a63ca9cc885857439f7f6826c1cbabaf", + "source_tree": "601e9bdf8a43323337f6d768759b262b75a16da2", + "workflow_run": "https://github.com/Kuddev/pebrel/actions/runs/35961098033", + "artifact_id": 10792632932, + "artifact_name": "stable-evidence-macos-aarch64", + "artifact_created_at": "2026-09-24T05:58:38Z", + "artifact_sha256": "7c444586185e180881b5ee0c7b1bfadbd7cfddb72dd27ef0504fbf2973157797", + "original_path": "macos-aarch64-launch-artifacts/installed-app.png", + "sha256": "6f2b2a1b42975020ce53bc37bf85e9529dee97ca12f79f9edfc43825b2d892b9", + "modifications": "none", + "scope": "Visible native application launch with CI test text. Existing upstream run; not newly dispatched for this documentation task.", + "launch_report": { + "status": "passed", + "launch_method": "launchservices", + "commit": "e9e83d83a63ca9cc885857439f7f6826c1cbabaf", + "architecture": "aarch64", + "os_version": "26.6.2", + "quarantine_assessment": "not_tested", + "screenshot": "captured", + "rendered_text": true, + "utf8_locale": true, + "home_cwd": true + } + } +} diff --git a/docs/site/site.json b/docs/site/site.json index bf447b3a4..442698782 100644 --- a/docs/site/site.json +++ b/docs/site/site.json @@ -2,11 +2,573 @@ "version": "1.9.1", "source_commit": "9dc058d12765893553d5fc7a2c37c870c96168b0", "groups": [ - {"title": "开始使用", "pages": [ - {"slug": "index", "title": "概览", "description": "从一个终端开始,把本地、远程与 AI 工作流连成一体。", "sources": ["README.md", "nebula_app/src/platform/capabilities.rs"]}, - {"slug": "quickstart", "title": "快速开始", "description": "安装 Pebrel,打开第一个终端,建立顺手的工作空间。", "sources": ["INSTALL.md", "nebula_app/src/gpui_shell/workspace/keyboard_bindings.rs"]}, - {"slug": "installation", "title": "安装与平台支持", "description": "为 Windows、macOS 或 Linux 选择合适的安装包。", "sources": ["INSTALL.md", "nebula_app/src/platform/capabilities.rs", "nebula_app/src/platform/update_installation.rs"]} - ]} + { + "title": "开始使用", + "pages": [ + { + "slug": "index", + "title": "概览", + "description": "安装 Pebrel,运行命令,连接服务器并管理项目文件。", + "sources": [ + "README.md", + "nebula_app/src/platform/capabilities.rs" + ] + }, + { + "slug": "quickstart", + "title": "快速开始", + "description": "运行第一条命令,再创建标签页、分屏和 SSH 连接。", + "sources": [ + "INSTALL.md", + "nebula_app/src/gpui_shell/workspace/keyboard_bindings.rs" + ] + }, + { + "slug": "installation", + "title": "安装与平台支持", + "description": "选择适合电脑的安装包,完成安装和首次启动。", + "sources": [ + "INSTALL.md", + "nebula_app/src/platform/capabilities.rs", + "nebula_app/src/platform/update_installation.rs" + ] + }, + { + "slug": "workspace", + "title": "标签页与分屏", + "description": "新建、移动和关闭标签页,调整分屏大小与焦点。", + "sources": [ + "nebula_app/src/gpui_shell/workspace/tab_menu.rs", + "nebula_app/src/gpui_shell/workspace/pane_header.rs", + "nebula_app/src/gpui_shell/workspace/keyboard_bindings.rs" + ] + }, + { + "slug": "terminal-basics", + "sources": [ + "nebula_app/src/gpui_shell/terminal/view.rs", + "nebula_app/src/gpui_shell/workspace/keyboard_bindings.rs", + "nebula_app/src/gpui_shell/settings_pane/appearance_advanced.rs" + ], + "title": "运行命令与切换目录", + "description": "查看当前目录、执行命令、停止程序和查找历史输出。" + } + ] + }, + { + "title": "日常终端", + "pages": [ + { + "slug": "shells", + "title": "Shell 与启动目录", + "description": "选择默认 Shell,设定启动目录,添加带参数的启动入口。", + "sources": [ + "nebula_app/src/terminal_profiles.rs", + "nebula_app/src/gpui_shell/settings_pane/shell_picker.rs", + "docs/lua-configuration.md", + "nebula_app/src/gpui_shell/settings_pane.rs" + ] + }, + { + "slug": "wsl", + "sources": [ + "nebula_app/src/shell_detect.rs", + "nebula_app/src/agent_env.rs", + "nebula_app/src/gpui_shell/settings_pane/shell_picker.rs" + ], + "title": "使用 WSL", + "description": "打开已安装的 Linux 发行版,访问项目并运行 Linux 工具。" + }, + { + "slug": "clipboard", + "title": "选择、复制与粘贴", + "description": "复制终端输出,粘贴命令和图片,设置选中即复制。", + "sources": [ + "nebula_app/src/gpui_shell/terminal/view/image_paste.rs", + "nebula_app/src/gpui_shell/settings_pane/setting_help.rs", + "nebula_app/src/gpui_shell/workspace/send_to_chat.rs" + ] + }, + { + "slug": "completions", + "title": "历史与路径补全", + "description": "开启补全,选择建议样式,并设置接受建议的按键。", + "sources": [ + "nebula_app/src/completion_context.rs", + "nebula_app/src/gpui_shell/terminal/completion_viewport.rs", + "nebula_app/src/gpui_shell/settings_pane/setting_help.rs" + ] + }, + { + "slug": "palette", + "title": "命令面板", + "description": "搜索并执行应用操作,快速打开设置或调整工作区。", + "sources": [ + "nebula_app/src/gpui_shell/workspace/palette.rs", + "nebula_app/src/gpui_shell/workspace/keyboard_bindings.rs" + ] + }, + { + "slug": "commands", + "title": "保存常用命令", + "description": "保存、搜索和分组命令,选择插入文字或立即执行。", + "sources": [ + "nebula_app/src/gpui_shell/workspace/command_manager.rs", + "nebula_app/src/gpui_shell/workspace/command_manager/groups.rs", + "nebula_app/src/saved_commands.rs" + ] + }, + { + "slug": "navigation", + "title": "查找与快速跳转", + "description": "切换已打开的标签,跳转目录、主机和 AI 会话。", + "sources": [ + "nebula_app/src/gpui_shell/workspace/quick_jump.rs", + "nebula_app/src/ai_sessions.rs" + ] + }, + { + "slug": "keyboard", + "title": "快捷键速查", + "description": "查找 Windows、macOS 和 Linux 常用快捷键,修改按键映射。", + "sources": [ + "nebula_app/src/gpui_shell/workspace/keyboard_bindings.rs", + "nebula_app/src/gpui_shell/settings_pane/keymap.rs" + ] + } + ] + }, + { + "title": "工作空间", + "pages": [ + { + "slug": "broadcast", + "title": "广播输入", + "description": "选择同一标签中的多个窗格,同时输入命令并退出广播。", + "sources": [ + "nebula_app/src/gpui_shell/workspace/pane_header.rs", + "nebula_app/src/gpui_shell/terminal/view/image_paste.rs" + ] + }, + { + "slug": "sessions", + "title": "保存与恢复会话", + "description": "设置启动时恢复标签和目录,在 Windows 中保留后台会话。", + "sources": [ + "nebula_app/src/gpui_shell/workspace/session_persistence.rs", + "nebula_app/src/gpui_shell/workspace/session_recovery.rs", + "nebula_app/src/gpui_shell/session_restore.rs", + "nebula_app/src/platform/capabilities.rs", + "nebula_app/src/gpui_shell/settings_pane.rs" + ] + }, + { + "slug": "layouts", + "title": "保存与打开布局", + "description": "把常用标签和分屏保存为布局配方,在新窗口中打开。", + "sources": [ + "nebula_app/src/gpui_shell/workspace/recipes/mod.rs" + ] + }, + { + "slug": "quick-terminal", + "title": "快速终端与托盘", + "description": "设置 Windows 全局热键,通过托盘召回终端或退出程序。", + "sources": [ + "nebula_app/src/gpui_shell/workspace/quick_terminal.rs", + "nebula_app/src/gpui_shell/settings_pane/keymap.rs", + "nebula_app/src/platform/capabilities.rs" + ] + } + ] + }, + { + "title": "远程连接", + "pages": [ + { + "slug": "ssh", + "title": "连接 SSH 服务器", + "description": "填写连接信息、测试认证并核对服务器指纹。", + "sources": [ + "nebula_app/src/gpui_shell/ssh_settings.rs", + "nebula_app/src/gpui_shell/ssh_settings/editor.rs", + "nebula_app/src/gpui_shell/workspace/ssh_dialog.rs" + ] + }, + { + "slug": "ssh-library", + "title": "管理 SSH 主机", + "description": "编辑连接,整理分组与标签,导入或导出主机列表。", + "sources": [ + "nebula_app/src/gpui_shell/ssh_settings/library.rs", + "nebula_app/src/gpui_shell/ssh_settings/library/exchange.rs", + "nebula_app/src/ssh_profiles/exchange.rs", + "nebula_app/src/ssh_profiles/organization.rs" + ] + }, + { + "slug": "ssh-auth", + "title": "密码、密钥与认证", + "description": "选择认证方式,使用私钥,并管理保存的登录凭据。", + "sources": [ + "nebula_app/src/ssh_session/lifecycle.rs", + "nebula_app/src/ssh_session/agent.rs", + "nebula_app/src/ssh_credentials.rs", + "nebula_app/src/platform/credentials.rs" + ] + }, + { + "slug": "ssh-config", + "sources": [ + "nebula_app/src/ssh.rs", + "nebula_app/src/ssh_session.rs", + "nebula_app/src/gpui_shell/ssh_settings/library.rs", + "nebula_app/src/ssh_proxy.rs" + ], + "title": "使用 SSH config", + "description": "通过别名连接服务器,读取配置中的用户名、密钥和跳板。" + }, + { + "slug": "ssh-routing", + "title": "代理与跳板机", + "description": "配置直连、代理或单级跳板,检查连接路线。", + "sources": [ + "nebula_app/src/gpui_shell/ssh_settings/advanced.rs", + "nebula_app/src/ssh_profiles/connection.rs", + "nebula_app/src/ssh_session/route.rs", + "nebula_app/src/ssh_proxy.rs" + ] + }, + { + "slug": "sftp", + "title": "SFTP 文件传输", + "description": "上传和下载文件夹,复制远端文件,处理同名文件并查看进度。", + "sources": [ + "nebula_app/src/gpui_shell/workspace/remote_files.rs", + "nebula_app/src/gpui_shell/workspace/remote_files/transfers.rs", + "nebula_app/src/ssh_sftp/transfer.rs", + "nebula_app/src/ssh_sftp/transaction.rs" + ] + } + ] + }, + { + "title": "文件与阅读", + "pages": [ + { + "slug": "files", + "title": "浏览与查找文件", + "description": "打开项目目录,筛选文件,在指定目录新建终端。", + "sources": [ + "nebula_app/src/gpui_shell/workspace/file_tree.rs", + "nebula_app/src/gpui_shell/file_preview.rs", + "nebula_app/src/platform/file_preview.rs" + ] + }, + { + "slug": "vcs", + "title": "查看与提交 Git 改动", + "description": "查看差异、暂存文件、提交改动并与远端同步。", + "sources": [ + "nebula_app/src/gpui_shell/workspace/vcs_panel.rs", + "nebula_app/src/gpui_shell/workspace/vcs_panel/rows.rs", + "nebula_app/src/gpui_shell/workspace/vcs_panel/list_model.rs" + ] + }, + { + "slug": "git-conflicts", + "sources": [ + "nebula_app/src/gpui_shell/code_tab.rs", + "nebula_app/src/gpui_shell/workspace/vcs_panel/rows.rs" + ], + "title": "解决 Git 冲突", + "description": "使用三栏冲突视图整理结果,保存并暂存已解决的文件。" + }, + { + "slug": "svn", + "sources": [ + "nebula_app/src/gpui_shell/workspace/vcs_panel.rs", + "nebula_app/src/display/side_panel/vcs.rs" + ], + "title": "使用 SVN", + "description": "查看 SVN 工作副本的改动,执行更新和提交。" + }, + { + "slug": "documents", + "title": "阅读文档", + "description": "打开 Markdown,使用目录、代码复制和公式预览。", + "sources": [ + "nebula_app/src/gpui_shell/file_editor/mod.rs", + "nebula_app/src/gpui_shell/file_editor/chrome.rs", + "nebula_app/src/gpui_shell/file_editor/code_actions.rs", + "nebula_app/src/gpui_shell/file_editor/tests.rs" + ] + }, + { + "slug": "markdown-editing", + "sources": [ + "nebula_app/src/gpui_shell/file_editor/mod.rs", + "nebula_app/src/gpui_shell/file_editor/chrome.rs", + "nebula_app/src/gpui_shell/file_editor/tests.rs" + ], + "title": "编辑 Markdown", + "description": "切换到源码,编写标题、列表、表格和公式,保存后预览。" + }, + { + "slug": "images", + "title": "查看与粘贴图片", + "description": "预览本地图片和附件,把剪贴板图片传给终端中的工具。", + "sources": [ + "nebula_app/src/platform/file_preview.rs", + "nebula_app/src/gpui_shell/file_preview.rs", + "nebula_app/src/gpui_shell/terminal/view/image_paste.rs", + "README.md" + ] + }, + { + "slug": "remote-edit", + "title": "编辑服务器上的文件", + "description": "从 SFTP 面板打开文本文件,保存修改并处理冲突。", + "sources": [ + "nebula_app/src/ssh_sftp/document.rs", + "nebula_app/src/gpui_shell/file_editor/mod.rs", + "nebula_app/src/gpui_shell/workspace/remote_files.rs" + ] + } + ] + }, + { + "title": "AI 工作流", + "pages": [ + { + "slug": "ai-start", + "title": "使用 AI 命令行工具", + "description": "启动 Claude Code 或 Codex,用标签、分屏和状态提示管理任务。", + "sources": [ + "README.md", + "nebula_app/src/ai_agents.rs", + "nebula_app/src/gpui_shell/workspace/agents.rs", + "nebula_app/src/platform/agent_integrations.rs", + "nebula_app/src/gpui_shell/terminal/view.rs", + "nebula_app/src/gpui_shell/terminal/view/agent_activity.rs" + ] + }, + { + "slug": "hooks", + "title": "配置 Agent 集成", + "description": "检测已安装的工具,配置可用集成并检查状态提示。", + "sources": [ + "nebula_app/src/platform/agent_integrations.rs", + "nebula_app/src/gpui_shell/settings_pane/agents.rs", + "nebula_app/src/ai_hook/win/settings.rs" + ] + }, + { + "slug": "ai-history", + "title": "恢复与分叉 AI 对话", + "description": "查找历史会话,恢复先前对话,或从已有上下文继续新任务。", + "sources": [ + "nebula_app/src/ai_sessions.rs", + "nebula_app/src/gpui_shell/workspace/session_recovery.rs", + "nebula_app/src/gpui_shell/workspace/tab_menu.rs" + ] + }, + { + "slug": "send-to-chat", + "title": "把输出发送给 AI", + "description": "选中终端文字,补充问题,再选择接收内容的 Agent。", + "sources": [ + "nebula_app/src/gpui_shell/workspace/send_to_chat.rs" + ] + }, + { + "slug": "agent-worktrees", + "sources": [ + "docs/runtime-control-api.md", + "nebula_app/src/git_worktree.rs", + "nebula_app/src/gpui_shell/workspace/residency.rs" + ], + "title": "隔离 AI 工作目录", + "description": "为并行任务创建独立 Git worktree,核对目录后分配任务。" + } + ] + }, + { + "title": "个性化", + "pages": [ + { + "slug": "appearance", + "title": "调整应用外观", + "description": "更换主题和图标,选择界面密度、语言与光标样式。", + "sources": [ + "nebula_app/src/gpui_shell/settings_pane/appearance.rs", + "nebula_app/src/gpui_shell/settings_pane/appearance_advanced.rs", + "nebula_app/src/gpui_shell/settings_pane/appearance_picker.rs" + ] + }, + { + "slug": "themes", + "title": "创建和导入主题", + "description": "从模板创建配色,调整颜色,导入或导出主题文件。", + "sources": [ + "nebula_app/src/gpui_shell/settings_pane/theme_editor.rs", + "nebula_app/src/gpui_shell/settings_pane/theme_transfer.rs", + "nebula_app/src/theme_library/formats.rs", + "nebula_app/src/gpui_shell/settings_pane/theme_advanced.rs" + ] + }, + { + "slug": "backgrounds", + "title": "背景图片与透明度", + "description": "选择壁纸、设置铺放方式,并调整图片和终端的不透明度。", + "sources": [ + "nebula_app/src/gpui_shell/settings_pane/appearance_advanced.rs", + "nebula_app/src/gpui_shell/settings_pane/setting_help.rs", + "nebula_app/src/gpui_shell/settings_pane.rs" + ] + }, + { + "slug": "fonts", + "title": "字体、字号与间距", + "description": "设置中英文字体、调整字号和间距,解决对齐与缺字问题。", + "sources": [ + "nebula_app/src/gpui_shell/settings_pane/font_picker.rs", + "nebula_app/src/gpui_shell/settings_pane/appearance.rs", + "nebula_app/src/gpui_shell/settings_pane/appearance_advanced.rs", + "nebula_app/src/gpui_shell/settings_pane/scrolling.rs" + ] + }, + { + "slug": "notifications", + "title": "通知与提醒", + "description": "设置 AI 消息、卡片显示时长和终端铃声。", + "sources": [ + "nebula_app/src/gpui_shell/settings_pane/notifications.rs", + "nebula_app/src/gpui_shell/settings_pane/setting_help.rs", + "README.md", + "nebula_app/src/platform/capabilities.rs" + ] + }, + { + "slug": "interaction", + "title": "鼠标与窗口行为", + "description": "调整复制粘贴、鼠标焦点、标签位置和新实例行为。", + "sources": [ + "nebula_app/src/gpui_shell/settings_pane.rs", + "nebula_app/src/gpui_shell/settings_pane/setting_help.rs", + "nebula_app/src/gpui_shell/settings_pane/navigation.rs" + ] + }, + { + "slug": "configuration", + "title": "使用 Lua 配置", + "description": "创建配置文件,检查语法和字段,修改并重载设置。", + "sources": [ + "docs/lua-configuration.md", + "nebula_app/src/config/mod.rs" + ] + }, + { + "slug": "config-examples", + "sources": [ + "docs/lua-configuration.md", + "nebula_app/src/config/mod.rs" + ], + "title": "常用配置示例", + "description": "复制并调整字体、Shell、环境变量和模块化配色示例。" + }, + { + "slug": "network", + "title": "网络与系统代理", + "description": "设置连接代理、测试网络,并让新终端使用系统代理环境。", + "sources": [ + "nebula_app/src/gpui_shell/network_settings.rs", + "nebula_app/src/update_proxy.rs", + "nebula_app/src/ssh_proxy.rs" + ] + } + ] + }, + { + "title": "参考与帮助", + "pages": [ + { + "slug": "runtime", + "title": "命令行控制与自动化", + "description": "列出窗格、发送文本、读取输出,向指定 Agent 分配任务。", + "sources": [ + "docs/runtime-control-api.md", + "nebula_app/src/runtime_api/cli.rs", + "nebula_app/src/agent_env.rs" + ] + }, + { + "slug": "settings", + "title": "设置索引", + "description": "按需要完成的操作查找设置位置,了解何时需要新建会话。", + "sources": [ + "nebula_app/src/gpui_shell/settings_pane/navigation.rs", + "nebula_app/src/gpui_shell/settings_pane.rs", + "nebula_app/src/platform/capabilities.rs" + ] + }, + { + "slug": "updates", + "title": "更新 Pebrel", + "description": "检查新版本,按照当前平台和安装方式完成升级。", + "sources": [ + "nebula_app/src/gpui_shell/settings_pane/about.rs", + "nebula_app/src/platform/update_installation.rs", + "nebula_app/src/platform/update_installation/macos.rs", + "nebula_app/src/update_download.rs" + ] + }, + { + "slug": "migration", + "title": "备份与迁移", + "description": "备份偏好、主机和命令,将工作环境迁移到另一台电脑。", + "sources": [ + "nebula_app/src/brand.rs", + "docs/lua-configuration.md", + "nebula_app/src/ssh_profiles/exchange.rs", + "nebula_app/src/platform/credentials.rs" + ] + }, + { + "slug": "privacy", + "title": "数据与凭据", + "description": "查看本地数据的用途,管理凭据,检查分享或发送的内容。", + "sources": [ + "nebula_app/src/platform/credentials.rs", + "nebula_app/src/gpui_shell/workspace/send_to_chat.rs", + "nebula_app/src/runtime_api.rs", + "nebula_app/src/ssh_profiles/exchange.rs" + ] + }, + { + "slug": "troubleshooting", + "title": "故障排查", + "description": "处理启动、字体、SSH、文件保存和会话恢复中的常见问题。", + "sources": [ + "INSTALL.md", + "nebula_app/src/gpui_shell/settings_pane/navigation.rs", + "nebula_app/src/platform/capabilities.rs", + "docs/runtime-control-api.md" + ] + } + ] + } ], - "images": ["nebula-top-tabs.png", "split-ai-workflows.png", "nebula-claude-session.png", "native-math-rendering.png", "themes.png", "ai-sidebar.png", "notification-duration.png", "reader-selection-opacity.png", "hero.png"] + "images": [ + "nebula-top-tabs.png", + "split-ai-workflows.png", + "nebula-claude-session.png", + "native-math-rendering.png", + "themes.png", + "ai-sidebar.png", + "notification-duration.png", + "reader-selection-opacity.png", + "hero.png", + "pebrel-1.9.1-macos-arm64-ci.png" + ] } diff --git a/docs/site/test_site.py b/docs/site/test_site.py index 07daf9544..6650c36f3 100644 --- a/docs/site/test_site.py +++ b/docs/site/test_site.py @@ -1,12 +1,13 @@ """Check generated navigation, rich content, and portable asset references.""" import json +import hashlib import tempfile import unittest from html.parser import HTMLParser from pathlib import Path from urllib.parse import unquote, urlsplit -from build import build, HERE, page_url +from build import build, HERE, home_header, page_url class Document(HTMLParser): @@ -69,6 +70,15 @@ def test_internal_links_and_fragments(self): if url.fragment and target in self.documents: self.assertIn(unquote(url.fragment), self.documents[target].ids) + def test_homepage_hero_has_no_eyebrow_or_description(self): + hero = home_header().split('
    ', 1)[0] + self.assertNotIn('eyebrow', hero) + self.assertNotIn(' Date: Fri, 25 Sep 2026 13:23:57 +0800 Subject: [PATCH 03/13] docs: refine navigation and add project guides --- .gitignore | 3 + docs/site/README.md | 2 +- docs/site/assets/site.css | 165 +++++++++++++++++++++++++++--- docs/site/build.py | 25 +++-- docs/site/content/contributing.md | 102 ++++++++++++++++++ docs/site/content/readme.md | 96 +++++++++++++++++ docs/site/site.json | 21 ++++ docs/site/template.html | 4 +- docs/site/test_site.py | 4 +- 9 files changed, 397 insertions(+), 25 deletions(-) create mode 100644 docs/site/content/contributing.md create mode 100644 docs/site/content/readme.md diff --git a/.gitignore b/.gitignore index 3ec55f3b6..cf3fd4c66 100644 --- a/.gitignore +++ b/.gitignore @@ -281,3 +281,6 @@ NebulaTerminal-*/ !/docs/site/content/markdown-editing.md !/docs/site/content/config-examples.md !/docs/site/content/agent-worktrees.md + +!/docs/site/content/readme.md +!/docs/site/content/contributing.md diff --git a/docs/site/README.md b/docs/site/README.md index 86322b09b..f5be9fb8f 100644 --- a/docs/site/README.md +++ b/docs/site/README.md @@ -19,7 +19,7 @@ For the browser smoke check, install `playwright==1.57.0`, run The check serves the site under `/pebrel/`, exercising project-site path handling. `CHROMIUM_PATH` optionally selects an existing Chromium executable. -The manifest currently contains 51 user-facing guides, organized by tasks rather +The manifest currently contains 53 user-facing guides, organized by tasks rather than implementation modules. Source links are pinned to the documented commit. The generated `dist/` is disposable and ignored. Publish that directory's contents, diff --git a/docs/site/assets/site.css b/docs/site/assets/site.css index 4200a80be..787076f5e 100644 --- a/docs/site/assets/site.css +++ b/docs/site/assets/site.css @@ -377,10 +377,20 @@ main:focus { .breadcrumb { display:flex; - gap:12px; + align-items:center; + justify-content:space-between; + gap:18px; font-size:11px; color:var(--muted); margin:0 0 26px; + min-height:34px; +} + +.breadcrumb-path { + display:flex; + align-items:center; + gap:12px; + min-width:0; } .breadcrumb a:hover { @@ -391,15 +401,6 @@ main:focus { margin-bottom:34px; } -.eyebrow { - font-size:11px; - color:var(--accent); - font-weight:600; - letter-spacing:.08em; - margin-bottom:12px; - display:block; -} - .page-heading h1 { font-size:38px; letter-spacing:-1.2px; @@ -418,11 +419,13 @@ main:focus { .page-tools { display:flex; - gap:14px; + gap:12px; align-items:center; - margin-top:20px; + justify-content:flex-end; + margin:0 0 0 auto; font-size:11px; color:var(--muted); + white-space:nowrap; } .small-button { @@ -624,6 +627,20 @@ main:focus { font-weight:500; } +.platform-strip>a { + color:var(--muted); + text-decoration:none; + border-radius:6px; + padding:4px 2px; +} + +.platform-strip>a:hover, +.platform-strip>a:focus-visible { + color:var(--text); + text-decoration:underline; + text-underline-offset:4px; +} + .platform-strip small { font-size:9px; border:1px solid var(--line); @@ -632,6 +649,114 @@ main:focus { margin-left:4px; } +.readme-intro { + border:1px solid var(--line); + border-radius:14px; + padding:24px; + background:linear-gradient(135deg,var(--soft),var(--bg)); + margin:18px 0 24px; +} + +.readme-intro strong { + display:block; + font-size:20px; + line-height:1.5; + margin-bottom:8px; +} + +.readme-intro p { + margin:0!important; + color:var(--muted); +} + +.readme-visual-grid { + display:grid; + grid-template-columns:repeat(2,minmax(0,1fr)); + gap:12px; + margin:18px 0 28px; +} + +.readme-visual-card { + border:1px solid var(--line); + border-radius:12px; + padding:19px; + background:var(--panel); +} + +.readme-visual-card small { + display:block; + color:var(--accent); + font-size:10px; + font-weight:650; + letter-spacing:.06em; + margin-bottom:7px; +} + +.readme-visual-card strong { + display:block; + font-size:15px; + margin-bottom:7px; +} + +.readme-visual-card p { + color:var(--muted); + font-size:13px; + margin:0!important; +} + +.readme-badges { + display:flex; + flex-wrap:wrap; + gap:8px; + margin:14px 0 24px; +} + +.readme-badges span { + border:1px solid var(--line); + background:var(--soft); + border-radius:999px; + padding:6px 10px; + font-size:11px; + color:var(--muted); +} + +.contribution-flow { + display:grid; + grid-template-columns:repeat(4,minmax(0,1fr)); + gap:10px; + margin:18px 0 28px; + counter-reset:contrib-step; +} + +.contribution-flow>div { + border:1px solid var(--line); + border-radius:11px; + padding:16px; + min-width:0; +} + +.contribution-flow>div:before { + counter-increment:contrib-step; + content:counter(contrib-step,decimal-leading-zero); + display:block; + color:var(--accent); + font:600 10px ui-monospace,SFMono-Regular,monospace; + margin-bottom:8px; +} + +.contribution-flow strong { + display:block; + font-size:13px; + margin-bottom:5px; +} + +.contribution-flow span { + display:block; + color:var(--muted); + font-size:11px; + line-height:1.65; +} + .feature-grid { display:grid; grid-template-columns:repeat(2,minmax(0,1fr)); @@ -1507,6 +1632,9 @@ dialog::backdrop { font-size:10px; flex-wrap:wrap; } + .contribution-flow { + grid-template-columns:1fr; + } .feature-grid { gap:11px; } @@ -1533,8 +1661,21 @@ dialog::backdrop { font-size:12px; padding:17px; } + .breadcrumb { + align-items:flex-start; + flex-wrap:wrap; + } .page-tools { + width:100%; flex-wrap:wrap; + justify-content:flex-start; + margin-left:0; + } + .readme-visual-grid { + grid-template-columns:1fr; + } + .contribution-flow { + grid-template-columns:repeat(2,minmax(0,1fr)); } .page-pagination { gap:9px; diff --git a/docs/site/build.py b/docs/site/build.py index edc2e490e..741687e3d 100644 --- a/docs/site/build.py +++ b/docs/site/build.py @@ -101,11 +101,12 @@ def navigation(groups: list[dict], active: str, root: str) -> str: def home_header() -> str: - return '''
    + release = f"{UPSTREAM}/releases/latest" + return f'''

    从一个终端开始。
    把工作连成一体。

    -
    为你的桌面而来WindowsmacOS PreviewLinux Preview
    ''' +''' def source_details(page: dict, commit: str) -> str: @@ -148,12 +149,18 @@ def build(destination: Path, base_url: str) -> dict: raise ValueError(f"{slug}: unknown evidence source {path}") content, renderer = render_markdown(source, root) total_characters += len(plain(content)) - header = home_header() if slug == "index" else ( - f'
    {html.escape(page["group"])}' - f'

    {html.escape(page["title"])}

    {html.escape(page["description"])}

    ' - f'
    约 {max(1, len(plain(content)) // 450)} 分钟阅读' - f'' - f'Markdown ↓
    ') + if slug == "index": + header = home_header() + breadcrumb_tools = "" + else: + reading_minutes = max(1, len(plain(content)) // 450) + header = ( + f'

    {html.escape(page["title"])}

    ' + f'

    {html.escape(page["description"])}

    ') + breadcrumb_tools = ( + f'
    约 {reading_minutes} 分钟阅读' + f'' + f'Markdown ↓
    ') header += '' toc = "".join(f'{html.escape(label)}' for level, identity, label in renderer.headings if level in (2, 3)) pagination = [] @@ -169,7 +176,7 @@ def build(destination: Path, base_url: str) -> dict: description=html.escape(page["description"]), title=html.escape(page["title"]), canonical=canonical, root=root, slug=slug, version=config["version"], group=html.escape(page["group"]), navigation=navigation(config["groups"], slug, root), main_class="home" if slug == "index" else "document", - page_header=header, content=content, source_details=source_details(page, config["source_commit"]), + breadcrumb_tools=breadcrumb_tools, page_header=header, content=content, source_details=source_details(page, config["source_commit"]), pagination="".join(pagination), toc=toc, edit_url=f'{UPSTREAM}/edit/main/docs/site/content/{slug}.md') target = destination / page_url(slug) target.parent.mkdir(parents=True, exist_ok=True) diff --git a/docs/site/content/contributing.md b/docs/site/content/contributing.md new file mode 100644 index 000000000..faed7ff62 --- /dev/null +++ b/docs/site/content/contributing.md @@ -0,0 +1,102 @@ +## 开始前先确认范围 + +贡献不一定从写代码开始。清晰的复现步骤、文档改进、翻译、可访问性反馈和针对性的测试同样有价值。 + +准备修改代码时,先阅读仓库的[贡献指南](https://github.com/Kuddev/pebrel/blob/main/CONTRIBUTING.md)、[架构说明](https://github.com/Kuddev/pebrel/blob/main/docs/architecture.md)和[项目约束](https://github.com/Kuddev/pebrel/blob/main/docs/project-constraints.md)。涉及 UI 文档时,还需要遵循仓库的国际化规则。 + +
    +
    准备Fork 仓库,从目标分支创建独立工作分支。
    +
    修改一次 PR 只解决一个清晰问题,复用已有职责和状态来源。
    +
    验证运行与改动对应的测试、架构检查、格式检查和真实产品检查。
    +
    提交写清用户问题、实际改动、验证结果和仍未验证的范围。
    +
    + +## 准备开发环境 + +1. Fork `Kuddev/pebrel`,从 PR 目标分支创建自己的工作分支。 +2. 按仓库的 [INSTALL.md](https://github.com/Kuddev/pebrel/blob/main/INSTALL.md) 安装当前平台需要的依赖。 +3. 使用 `rust-toolchain.toml` 固定的 Rust 工具链,不要随意切换工具链版本。 +4. 构建实际的 GPUI 产品界面: + +```sh +cargo build --locked -p nebula --bin pebrel --features gpui-shell +``` + +如果只是修文档,应优先运行文档自己的构建与测试,不需要为了文字改动制造无关的产品代码变化。 + +## 保持改动容易审查 + +- 一个 PR 只承担一个概念上的改动;不要顺便重构无关文件。 +- 先说明用户可观察到的问题,以及哪些既有行为必须保持。 +- 共享规则应继续由现有权威模块负责,UI 只适配,不复制第二套状态或持久化逻辑。 +- 有自然测试入口时,为问题增加最小、聚焦的回归验证。 +- 不要通过放宽预算、移除测试、增加跳过参数或扩大忽略范围来让 CI 变绿。 +- 不提交构建输出、本地探针、包含隐私/凭据的截图或临时调查文件。 + +仓库的 PR size 检查会限制过大的源码改动;文档、锁文件和资源与源码预算的计算规则不同。需要大范围重构时,先拆分成可独立审查的步骤。 + +## 本地快速检查 + +架构检查需要 Python 3.11+。把 `` 替换成实际目标分支的基准提交: + +```sh +python3 scripts/check_architecture.py --base +python3 -m unittest scripts.tests.test_architecture_budgets scripts.tests.test_architecture_dependencies scripts.tests.test_architecture_governance +cargo test --manifest-path tools/i18n-contract/Cargo.toml --locked +cargo test -p nebula-settings +cargo test -p nebula --test file_line_budget +cargo fmt --all -- --check +``` + +涉及正式应用行为时,再运行: + +```sh +cargo check -p nebula --bin pebrel --features gpui-shell --tests --locked +``` + +还应运行与你修改区域直接相关的行为测试。无法在当前机器上验证的平台能力,需要在 PR 描述里明确写出,而不是把“能编译”描述成“UI 已验证”。 + +## 修改文档网站 + +文档站源文件位于 `docs/site/`。本地构建: + +```sh +python -m pip install -r docs/site/requirements.txt +python docs/site/build.py +python -m unittest discover -s docs/site -p test_site.py +``` + +新增公开文档源文件时,还要把具体路径加入 `.gitignore` 中的精确 allowlist。不要直接放开整个 `docs/` 目录。 + +文档应从用户任务出发:先告诉用户去哪里、执行什么、看到什么结果,再补限制和背景。不要把源码结构说明写成用户指南。 + +## 提交 Pull Request + +PR 描述至少应包含: + +| 内容 | 应写什么 | +| --- | --- | +| 问题 | 用户实际遇到了什么,或为什么需要这个变化 | +| 改动 | 哪些行为发生变化;哪些关键行为保持不变 | +| 验证 | 实际运行过的命令、测试和平台结果 | +| 缺口 | 没有运行的 UI、平台或打包验证 | +| 风险 | 持久化格式、依赐、线程、公共接口等是否受到影响 | + +早期需要设计反馈时可以先开 Draft;准备合并前再切换 Ready。维护者根据实际 diff、测试结果、平台验证和代码审查决定是否可以合并。 + +## CI 会检查什么 + +Ready PR 会运行完整的原生平台矩阵;Draft 会省略部分较慢的平台任务。核心检查包括架构合同、格式与矩阵规划、源码规模,以及 Linux、Windows 和 macOS 的相应测试/编译任务。 + +来自 fork 的首次贡献可能在 GitHub Actions 中显示等待维护者批准。这是 GitHub 的安全边界,不应通过提高 token 权限或改用不安全触发方式绕过。 + +## 提交前自检 + +- 工作分支基于正确的目标分支。 +- Diff 只包含当前功能需要的文件。 +- 没有提交凭据、个人路径、私密日志或无关截图。 +- 相关测试真实运行过,PR 中没有夸大验证范围。 +- CI 失败时修原因,而不是关闭门禁。 +- 如果改动引入新的架构责任或跨层依赖,已经按仓库要求记录和讨论。 + +完成这些步骤后,PR 会更容易复现、审查和维护。 diff --git a/docs/site/content/readme.md b/docs/site/content/readme.md new file mode 100644 index 000000000..82c8b81ca --- /dev/null +++ b/docs/site/content/readme.md @@ -0,0 +1,96 @@ +
    +GPU 加速终端、SSH 工作区,以及 AI CLI 会话空间。 +

    Pebrel 把本地 Shell、远程主机、文件和 AI 命令行工具集中在同一个原生桌面工作区。这个页面把仓库 README 中最常用的信息重新组织成可以快速浏览的图文说明。

    +
    + +
    Rust 2024GPUIWindows 10 / 11macOS 14+ PreviewLinux glibc 2.35+ PreviewGPL-3.0
    + +## 一个工作区里完成什么 + +
    +
    TERMINAL终端与会话

    用标签页和分屏组织多个 Shell;每个窗格保留自己的工作目录,并可保存常用工作区布局。

    +
    REMOTESSH 与文件

    保存远端主机,通过 SSH 连接服务器,并在终端旁使用 SFTP 上传、下载和整理文件。

    +
    AI CLIAI 命令行工作流

    在独立标签或分屏中运行受支持的 AI CLI,通过活动状态、通知和历史记录跟踪任务。

    +
    READER原生阅读与配置

    阅读 Markdown、公式和本地图片,使用主题、背景、快捷键与 Lua 配置调整工作环境。

    +
    + +
    Pebrel 顶部标签和终端工作区
    用标签页组织多个终端,并在同一个窗口里保持工作上下文。
    + +
    Pebrel 中的多 AI CLI 分屏工作流
    多个命令行任务可以并排运行;每个窗格保持独立输入和输出。
    + +## 平台与下载 + +从[最新发行版](https://github.com/Kuddev/pebrel/releases/latest)选择与你的系统和架构对应的安装包。 + +| 平台 | 当前支持 | 安装包 | +| --- | --- | --- | +| Windows 10 1809+ / 11 | 正式版,x64 | .exe 安装器或 .zip 便携包 | +| macOS 14+ | Preview,Apple Silicon / Intel | .dmg | +| Linux,glibc 2.35+ | Preview,x64 | .AppImage、.deb 或 .tar.gz | + +Windows 还提供系统托盘驻留、全局快速终端热键、本地 AI hook 自动配置和自动更新安装。macOS 与 Linux 的可用能力以[安装与平台支持](installation.md)为准。 + +## 终端与会话 + +- 侧栏或顶部标签管理终端,并可拖拽调整分屏。 +- 每个窗格可以拥有独立工作目录;复制部分远端或子系统标签时会保留已知目录。 +- 支持历史和路径补全、快捷键及集成 Shell 提示。 +- Windows 可选择关窗后继续保留后台会话;应用真正退出后的对话恢复属于另一套机制。 + +要实际配置这些行为,参见[标签页与分屏](workspace.md)、[保存与恢复会话](sessions.md)和[快捷键速查](keyboard.md)。 + +## SSH 与文件 + +Pebrel 可以保存主机、读取 SSH 配置别名,并使用代理或单级跳板。认证可使用密码、私钥及服务器支持的交互流程,首次连接时应核对主机密钥。 + +SFTP 面板用于浏览远端目录、上传与下载文件或文件夹、查看传输进度并取消任务。本地文件浏览、Git 操作和远端文件编辑可以与终端同时进行。 + +
    Pebrel 工作区示例
    终端、文件与远端连接围绕同一工作区组织。
    + +## AI CLI 工作流 + +Pebrel 会识别多种 AI CLI,并在受支持时显示活动状态与更精确的任务提示。通知与来源窗格关联,点击后可以回到对应终端。 + +已捕获的回答可以在阅读器中查看 Markdown、公式、原文和本地图片。向终端粘贴图片时,Pebrel 会把图片保存为文件并把路径交给当前会话;终端内联显示是否可用取决于命令行工具输出的协议和内容。 + +
    Pebrel 中的 AI CLI 会话
    AI CLI 与普通 Shell 一样运行在终端中,同时可使用会话相关的辅助能力。
    + +## 外观、文档与配置 + +Pebrel 提供浅色与深色主题、背景、不透明度、图标和界面语言设置。Markdown 文档可以直接在应用内阅读,数学公式由原生界面排版。 + +
    Pebrel 原生文档与公式排版
    文档阅读器可以显示 Markdown 内容和数学公式。
    + +使用命令行初始化并检查 Lua 配置: + +~~~sh +pebrel config init --language zh-CN +pebrel config check +~~~ + +配置重载失败时会继续使用上一份有效配置。完整字段和示例参见[使用 Lua 配置](configuration.md)与[常用配置示例](config-examples.md)。 + +## 通知 + +在 **设置 → 终端 → 提醒** 中可以选择通知显示时长:保留默认时长、5 / 10 / 30 / 90 秒,或保持常驻。隐藏通知卡片只会关闭显示,不会自动执行确认、拒绝或其他任务操作。 + +## 构建 Pebrel + +安装仓库固定的 Rust 工具链和平台依赖后,README 给出的正式产品构建命令为: + +~~~sh +cargo build --release --locked -p nebula --bin pebrel --features gpui-shell +~~~ + +准备参与开发时,请继续阅读[贡献与开发](contributing.md),按照仓库规定运行相应检查。 + +## 赞助、社区与联系 + +- **赞助**:README 当前感谢 Fluxion AI 对项目的支持。 +- **社区**:可通过项目 README 中列出的社区入口参与讨论。 +- **Discord**:[discord.gg/VFn4rcxmhn](https://discord.gg/VFn4rcxmhn) +- **邮箱**:[fickleheartedkeys@163.com](mailto:fickleheartedkeys@163.com) +- **许可证**:GPL-3.0;第三方版权和许可证声明以仓库内对应文件为准。 + +> [!NOTE] +> 本页是 README 的文档化导览,不替代仓库 README。版本、下载文件和社区入口发生变化时,以仓库当前内容和最新发行版为准。 diff --git a/docs/site/site.json b/docs/site/site.json index 442698782..23ae2ea4b 100644 --- a/docs/site/site.json +++ b/docs/site/site.json @@ -14,6 +14,16 @@ "nebula_app/src/platform/capabilities.rs" ] }, + { + "slug": "readme", + "title": "项目概览", + "description": "用图文方式浏览 README 中的定位、核心能力、平台下载、配置与社区信息。", + "sources": [ + "README.md", + "README.zh-CN.md", + "INSTALL.md" + ] + }, { "slug": "quickstart", "title": "快速开始", @@ -555,6 +565,17 @@ "nebula_app/src/platform/capabilities.rs", "docs/runtime-control-api.md" ] + }, + { + "slug": "contributing", + "title": "贡献与开发", + "description": "准备开发环境,完成本地检查,并按仓库规则提交便于审查的改动。", + "sources": [ + "CONTRIBUTING.md", + "docs/project-constraints.md", + "docs/architecture.md", + "INSTALL.md" + ] } ] } diff --git a/docs/site/template.html b/docs/site/template.html index 80a1eee42..a08517564 100644 --- a/docs/site/template.html +++ b/docs/site/template.html @@ -30,11 +30,11 @@
    - + $page_header
    $content
    $source_details diff --git a/docs/site/test_site.py b/docs/site/test_site.py index 6650c36f3..1cb2926c9 100644 --- a/docs/site/test_site.py +++ b/docs/site/test_site.py @@ -71,13 +71,15 @@ def test_internal_links_and_fragments(self): self.assertIn(unquote(url.fragment), self.documents[target].ids) def test_homepage_hero_has_no_eyebrow_or_description(self): - hero = home_header().split('
    ', 1)[0] + header = home_header() + hero = header.split('', 1)[0] self.assertNotIn('eyebrow', hero) self.assertNotIn(' Date: Mon, 28 Sep 2026 20:18:16 +0800 Subject: [PATCH 04/13] docs: clean static guide output and filenames --- docs/site/build.py | 22 ++++++++++++++++++++++ docs/site/content/contributing.md | 2 +- docs/site/content/installation.md | 18 +++++++++--------- docs/site/test_site.py | 21 +++++++++++++++++++++ 4 files changed, 53 insertions(+), 10 deletions(-) diff --git a/docs/site/build.py b/docs/site/build.py index 741687e3d..5f4a24486 100644 --- a/docs/site/build.py +++ b/docs/site/build.py @@ -123,6 +123,28 @@ def build(destination: Path, base_url: str) -> dict: if len(slugs) != len(set(slugs)): raise ValueError("Duplicate page slug") template = Template((HERE / "template.html").read_text()) + destination = destination.resolve() + screenshots = REPO / "docs" / "screenshots" + if destination != HERE / "dist" and ( + REPO.is_relative_to(destination) + or any( + source == destination + or source.is_relative_to(destination) + or destination.is_relative_to(source) + for source in (HERE, screenshots) + ) + ): + raise ValueError("Output directory overlaps repository sources") + if destination.exists(): + if not destination.is_dir(): + raise ValueError("Output path is not a directory") + generated_site = ( + (destination / "build-info.json").is_file() + and (destination / ".nojekyll").is_file() + ) + if any(destination.iterdir()) and not generated_site: + raise ValueError("Refusing to replace an output directory that is not a generated site") + shutil.rmtree(destination) destination.mkdir(parents=True, exist_ok=True) shutil.copy2(REPO / "LICENSE", destination / "LICENSE") shutil.copy2(HERE / "third-party-notices.txt", destination / "third-party-notices.txt") diff --git a/docs/site/content/contributing.md b/docs/site/content/contributing.md index faed7ff62..3922a9cf6 100644 --- a/docs/site/content/contributing.md +++ b/docs/site/content/contributing.md @@ -80,7 +80,7 @@ PR 描述至少应包含: | 改动 | 哪些行为发生变化;哪些关键行为保持不变 | | 验证 | 实际运行过的命令、测试和平台结果 | | 缺口 | 没有运行的 UI、平台或打包验证 | -| 风险 | 持久化格式、依赐、线程、公共接口等是否受到影响 | +| 风险 | 持久化格式、依赖、线程、公共接口等是否受到影响 | 早期需要设计反馈时可以先开 Draft;准备合并前再切换 Ready。维护者根据实际 diff、测试结果、平台验证和代码审查决定是否可以合并。 diff --git a/docs/site/content/installation.md b/docs/site/content/installation.md index 4804ac32a..f4a001743 100644 --- a/docs/site/content/installation.md +++ b/docs/site/content/installation.md @@ -4,11 +4,11 @@ | 电脑 | 选择的包 | 系统要求 | | --- | --- | --- | -| Windows,Intel / AMD 64 位处理器 | `windows-x64-setup.exe` 或 `windows-x64.zip` | Windows 10 1809+ / Windows 11 | -| Windows,ARM 处理器 | `windows-arm64.zip` | 使用 ARM64 对应包 | -| Mac,Apple 芯片 | `macos-arm64-preview.dmg` | 构建目标为 macOS 14+ | -| Mac,Intel 处理器 | `macos-x64-preview.dmg` | 构建目标为 macOS 14+ | -| Linux,Intel / AMD 64 位处理器 | `linux-x64-preview.deb`、`.AppImage` 或 `.tar.gz` | glibc 2.35+ | +| Windows,Intel / AMD 64 位处理器 | `Pebrel-v1.9.1-windows-x64-setup.exe` 或 `Pebrel-v1.9.1-windows-x64.zip` | Windows 10 1809+ / Windows 11 | +| Windows,ARM 处理器 | `Pebrel-v1.9.1-windows-arm64.zip` | 使用 ARM64 对应包 | +| Mac,Apple 芯片 | `Pebrel-v1.9.1-macos-arm64-preview.dmg` | 构建目标为 macOS 14+ | +| Mac,Intel 处理器 | `Pebrel-v1.9.1-macos-x64-preview.dmg` | 构建目标为 macOS 14+ | +| Linux,Intel / AMD 64 位处理器 | `Pebrel-v1.9.1-linux-x64-preview.deb`、`Pebrel-v1.9.1-linux-x64-preview.AppImage` 或 `Pebrel-v1.9.1-linux-x64-preview.tar.gz` | glibc 2.35+ | 在 Mac 的 **苹果菜单 → 关于本机** 中可以查看芯片类型。`x64` 指 64 位 Intel / AMD,不是 32 位 x86。macOS 和 Linux 当前提供 Preview 包;macOS 构建目标为 14+,发布 CI 在 macOS 15 上验证。 @@ -16,14 +16,14 @@ ### 使用安装程序 -1. 下载名称以 `windows-x64-setup.exe` 结尾的文件。 +1. 下载 `Pebrel-v1.9.1-windows-x64-setup.exe`。 2. 运行安装程序,按页面提示选择安装位置并完成安装。 3. 从开始菜单或安装完成后的入口启动 Pebrel。 4. 看到终端提示符后,输入 `echo Hello, Pebrel` 检查运行情况。 ### 使用便携版 -1. 下载对应架构的 ZIP 文件。 +1. 下载 `Pebrel-v1.9.1-windows-x64.zip` 或 `Pebrel-v1.9.1-windows-arm64.zip`。 2. **完整解压**到一个可写目录。 3. 进入解压后的目录,运行 `pebrel.exe`。 @@ -31,7 +31,7 @@ ## macOS -1. 下载 Apple Silicon(arm64)或 Intel(x64)对应的 DMG。 +1. 下载 Apple Silicon 的 `Pebrel-v1.9.1-macos-arm64-preview.dmg` 或 Intel 的 `Pebrel-v1.9.1-macos-x64-preview.dmg`。 2. 打开 DMG,将 **Pebrel** 拖入 **Applications/应用程序**。 3. 弹出 DMG,然后从“应用程序”启动 Pebrel。 @@ -62,7 +62,7 @@ chmod +x Pebrel-v1.9.1-linux-x64-preview.AppImage ### TAR.GZ 便携包 -将下载包解压,进入其中的目录后运行 `./AppRun`。保留解压后的完整目录,启动器需要读取随包资源。 +解压 `Pebrel-v1.9.1-linux-x64-preview.tar.gz`,进入其中的目录后运行 `./AppRun`。保留解压后的完整目录,启动器需要读取随包资源。 ## 平台功能差异 diff --git a/docs/site/test_site.py b/docs/site/test_site.py index 1cb2926c9..227ebee7c 100644 --- a/docs/site/test_site.py +++ b/docs/site/test_site.py @@ -45,6 +45,11 @@ class SiteTests(unittest.TestCase): def setUpClass(cls): cls.temp = tempfile.TemporaryDirectory() cls.root = Path(cls.temp.name) + cls.stale_page = cls.root / 'obsolete' / 'index.html' + cls.stale_page.parent.mkdir() + cls.stale_page.write_text('stale output') + (cls.root / 'build-info.json').write_text('{}') + (cls.root / '.nojekyll').touch() cls.report = build(cls.root, 'https://example.org/pebrel/') cls.documents = { path.resolve(): Document(path.read_text()) @@ -55,6 +60,22 @@ def setUpClass(cls): def tearDownClass(cls): cls.temp.cleanup() + def test_build_removes_stale_output(self): + self.assertFalse(self.stale_page.exists()) + + def test_build_preserves_unrelated_output(self): + with tempfile.TemporaryDirectory() as temp: + output = Path(temp) + sentinel = output / 'user-data.txt' + sentinel.write_text('keep') + with self.assertRaisesRegex(ValueError, 'not a generated site'): + build(output, '') + self.assertEqual(sentinel.read_text(), 'keep') + + def test_build_does_not_remove_source_directories(self): + with self.assertRaisesRegex(ValueError, 'overlaps repository sources'): + build(HERE, '') + def test_internal_links_and_fragments(self): for path, document in self.documents.items(): for reference in document.references: From d67436a75a795d5c2ca0451d612e4e72091d8ee2 Mon Sep 17 00:00:00 2001 From: GeekMr <140129782+WilliamWang1721@users.noreply.github.com> Date: Mon, 28 Sep 2026 22:24:34 +0800 Subject: [PATCH 05/13] docs: align contributor guide with current CI policy --- docs/site/content/contributing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/site/content/contributing.md b/docs/site/content/contributing.md index 3922a9cf6..44b87f26f 100644 --- a/docs/site/content/contributing.md +++ b/docs/site/content/contributing.md @@ -86,7 +86,7 @@ PR 描述至少应包含: ## CI 会检查什么 -Ready PR 会运行完整的原生平台矩阵;Draft 会省略部分较慢的平台任务。核心检查包括架构合同、格式与矩阵规划、源码规模,以及 Linux、Windows 和 macOS 的相应测试/编译任务。 +Draft 和 Ready PR 都会运行完整的五平台原生测试矩阵及两项 macOS release 编译检查。核心检查还包括架构合同、格式与矩阵规划和源码规模。 来自 fork 的首次贡献可能在 GitHub Actions 中显示等待维护者批准。这是 GitHub 的安全边界,不应通过提高 token 权限或改用不安全触发方式绕过。 From db852a16262e3a222a30568c183748e45473766c Mon Sep 17 00:00:00 2001 From: GeekMr <140129782+WilliamWang1721@users.noreply.github.com> Date: Wed, 30 Sep 2026 20:20:55 +0800 Subject: [PATCH 06/13] fix(docs): follow agent integration module move --- docs/site/site.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/site/site.json b/docs/site/site.json index 23ae2ea4b..b456893ac 100644 --- a/docs/site/site.json +++ b/docs/site/site.json @@ -358,7 +358,7 @@ "README.md", "nebula_app/src/ai_agents.rs", "nebula_app/src/gpui_shell/workspace/agents.rs", - "nebula_app/src/platform/agent_integrations.rs", + "nebula_app/src/ai_hook/integrations.rs", "nebula_app/src/gpui_shell/terminal/view.rs", "nebula_app/src/gpui_shell/terminal/view/agent_activity.rs" ] @@ -368,7 +368,7 @@ "title": "配置 Agent 集成", "description": "检测已安装的工具,配置可用集成并检查状态提示。", "sources": [ - "nebula_app/src/platform/agent_integrations.rs", + "nebula_app/src/ai_hook/integrations.rs", "nebula_app/src/gpui_shell/settings_pane/agents.rs", "nebula_app/src/ai_hook/win/settings.rs" ] From 0bc72eeed195b9a8bc0dc853eda6a26a5c6156ba Mon Sep 17 00:00:00 2001 From: GeekMr <140129782+WilliamWang1721@users.noreply.github.com> Date: Wed, 30 Sep 2026 20:24:23 +0800 Subject: [PATCH 07/13] fix(docs): follow hook settings module move --- docs/site/site.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/site/site.json b/docs/site/site.json index b456893ac..7031e138f 100644 --- a/docs/site/site.json +++ b/docs/site/site.json @@ -370,7 +370,7 @@ "sources": [ "nebula_app/src/ai_hook/integrations.rs", "nebula_app/src/gpui_shell/settings_pane/agents.rs", - "nebula_app/src/ai_hook/win/settings.rs" + "nebula_app/src/ai_hook/local/settings.rs" ] }, { From c84e58b3818706e5fbc12cd7ad3623673245425b Mon Sep 17 00:00:00 2001 From: GeekMr <140129782+WilliamWang1721@users.noreply.github.com> Date: Wed, 30 Sep 2026 20:46:17 +0800 Subject: [PATCH 08/13] docs: describe current path-based native CI coverage --- docs/site/content/contributing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/site/content/contributing.md b/docs/site/content/contributing.md index 44b87f26f..29d267720 100644 --- a/docs/site/content/contributing.md +++ b/docs/site/content/contributing.md @@ -86,7 +86,7 @@ PR 描述至少应包含: ## CI 会检查什么 -Draft 和 Ready PR 都会运行完整的五平台原生测试矩阵及两项 macOS release 编译检查。核心检查还包括架构合同、格式与矩阵规划和源码规模。 +Draft 和 Ready PR 使用相同的验证规划:CI 根据实际改动路径选择需要执行的原生平台测试;纯文档改动不运行原生测试。主分支、定时和发布验证保留五平台完整矩阵。PR 的检查页面会注明各平台是否实际执行,不能把未执行的绿色汇总当作测试覆盖。核心检查还包括架构合同、格式与矩阵规划和源码规模。 来自 fork 的首次贡献可能在 GitHub Actions 中显示等待维护者批准。这是 GitHub 的安全边界,不应通过提高 token 权限或改用不安全触发方式绕过。 From 24ea816055901878c6f8a6238672284e5870d338 Mon Sep 17 00:00:00 2001 From: GeekMr <140129782+WilliamWang1721@users.noreply.github.com> Date: Thu, 1 Oct 2026 00:07:06 +0800 Subject: [PATCH 09/13] docs: cover current completion, encrypted backups and Android pairing --- .gitignore | 3 ++ docs/site/README.md | 13 ++++-- docs/site/build.py | 3 +- docs/site/check_browser.py | 11 ++++++ docs/site/content/backups.md | 68 ++++++++++++++++++++++++++++++++ docs/site/content/completions.md | 58 ++++++++++++++++++--------- docs/site/content/index.md | 6 ++- docs/site/content/migration.md | 2 + docs/site/content/mobile.md | 67 +++++++++++++++++++++++++++++++ docs/site/content/settings.md | 2 +- docs/site/site.json | 53 ++++++++++++++++++++++--- docs/site/test_site.py | 13 +++++- 12 files changed, 266 insertions(+), 33 deletions(-) create mode 100644 docs/site/content/backups.md create mode 100644 docs/site/content/mobile.md diff --git a/.gitignore b/.gitignore index cf3fd4c66..1dd90a2b9 100644 --- a/.gitignore +++ b/.gitignore @@ -284,3 +284,6 @@ NebulaTerminal-*/ !/docs/site/content/readme.md !/docs/site/content/contributing.md + +!/docs/site/content/backups.md +!/docs/site/content/mobile.md diff --git a/docs/site/README.md b/docs/site/README.md index f5be9fb8f..363eac415 100644 --- a/docs/site/README.md +++ b/docs/site/README.md @@ -19,7 +19,7 @@ For the browser smoke check, install `playwright==1.57.0`, run The check serves the site under `/pebrel/`, exercising project-site path handling. `CHROMIUM_PATH` optionally selects an existing Chromium executable. -The manifest currently contains 53 user-facing guides, organized by tasks rather +The manifest currently contains 55 user-facing guides, organized by tasks rather than implementation modules. Source links are pinned to the documented commit. The generated `dist/` is disposable and ignored. Publish that directory's contents, @@ -50,7 +50,11 @@ separately enables the same opt-in variable and Pages setting. ## Maintain content `site.json` owns navigation, the documented version, the source commit and each -page's evidence paths. Pages live in `content/`. Use Markdown links such as +page's evidence paths. A page may override `version` and `source_commit` when +a newer feature has been audited; its displayed version and evidence links then +use that snapshot without relabeling older guides. State the boundary in the page +body too: an audited `main` feature is not a claim of release availability. +Pages live in `content/`. Use Markdown links such as `[Installation](installation.md)`: the builder resolves them for nested HTML paths. Use `@ROOT@` for local image paths in rich HTML. Raw HTML is allowed for trusted, reviewed repository content only; this is not an untrusted Markdown service. @@ -62,8 +66,9 @@ do not label a mockup or a documentation-page screenshot as an application captu After verifying a feature change, update the relevant page and its evidence. Lead with the task, identify the actual menu or shortcut, explain the result, -and place cautions beside the affected operation. Use visible 1.9.1 entry points: retained -implementation code is not by itself evidence of an available UI feature. Keep +and place cautions beside the affected operation. Use visible entry points from +the page's documented snapshot: retained implementation code is not by itself +evidence of an available UI feature. Keep implementation rationale out of the user guide. Add each new public source file to the exact `.gitignore` allowlist rather than opening the whole `docs/` subtree. The build checks that evidence paths exist; existence alone is not proof diff --git a/docs/site/build.py b/docs/site/build.py index 5f4a24486..cae77adc7 100644 --- a/docs/site/build.py +++ b/docs/site/build.py @@ -110,6 +110,7 @@ def home_header() -> str: def source_details(page: dict, commit: str) -> str: + commit = page.get("source_commit", commit) sources = page.get("sources", []) links = "".join(f'
  • {html.escape(path)}
  • ' for path in sources) return (f'
    版本与参考 · {commit[:7]}' @@ -196,7 +197,7 @@ def build(destination: Path, base_url: str) -> dict: canonical = f'' if base_url else "" output = template.substitute( description=html.escape(page["description"]), title=html.escape(page["title"]), canonical=canonical, - root=root, slug=slug, version=config["version"], group=html.escape(page["group"]), + root=root, slug=slug, version=html.escape(page.get("version", config["version"])), group=html.escape(page["group"]), navigation=navigation(config["groups"], slug, root), main_class="home" if slug == "index" else "document", breadcrumb_tools=breadcrumb_tools, page_header=header, content=content, source_details=source_details(page, config["source_commit"]), pagination="".join(pagination), toc=toc, edit_url=f'{UPSTREAM}/edit/main/docs/site/content/{slug}.md') diff --git a/docs/site/check_browser.py b/docs/site/check_browser.py index bb0d8073a..4abca726c 100644 --- a/docs/site/check_browser.py +++ b/docs/site/check_browser.py @@ -73,6 +73,17 @@ def check(site: Path, output: Path): expect(page.locator('#menu-toggle')).to_have_attribute('aria-expanded', 'true') page.keyboard.press('Escape') expect(page.locator('#menu-toggle')).to_have_attribute('aria-expanded', 'false') + manifest = json.loads((Path(__file__).parent / 'site.json').read_text()) + pages = {item['slug']: item for group in manifest['groups'] for item in group['pages']} + for slug in ('completions', 'backups', 'mobile'): + page.goto(base + slug + '/index.html') + expect(page.locator('.article-footer')).to_contain_text(pages[slug]['version']) + page.locator('.source-details summary').click() + expect(page.locator('.source-details a').first).to_have_attribute( + 'href', __import__('re').compile(f"/blob/{pages[slug]['source_commit']}/")) + assert not page.evaluate('document.documentElement.scrollWidth > innerWidth') + page.screenshot(path=str(output / f'docs-{slug}-mobile.png'), full_page=True) + page.goto(base) page.emulate_media(reduced_motion='reduce') assert page.locator('.hero').evaluate("el => getComputedStyle(el).animationName") == 'none' nojs = browser.new_context(java_script_enabled=False, viewport={'width': 390, 'height': 844}) diff --git a/docs/site/content/backups.md b/docs/site/content/backups.md new file mode 100644 index 000000000..de4904cce --- /dev/null +++ b/docs/site/content/backups.md @@ -0,0 +1,68 @@ +> [!NOTE] +> 本页按 2026-09-30 的 `main`(`5ff2f3e`)核对,不代表这些入口已经包含在 1.9.1 安装包中。没有 **设置 → 备份** 时,可使用[备份与迁移](migration.md)中的手动方式。 + +## 先做一份本地加密备份 + +1. 准备一个已有文件夹,例如 U 盘、已挂载的 NAS 或自己的备份目录。 +2. 打开 **设置 → 备份**,在 **备份与恢复** 页面选择 **本地 / 网络目录**,点 **下一步**。 +3. 在 **目录** 中填写路径,或用 **浏览…** 选择文件夹,点 **检查连接并继续**。 +4. 设置至少 8 位的 **备份密码**,在 **再输入一次** 中确认,点 **下一步**。 +5. 勾选需要的内容,点 **完成并开始备份**。只想先保存配置时,选 **完成,稍后备份**。 +6. 等待完成提示,并确认页面出现备份记录;以后使用 **立即备份 → 开始备份** 再生成快照。 + +连接检查只列出已有备份,不写入文件。因此“连接正常”不等于已经成功写入备份,仍需完成第 6 步。 + +**备份密码与存储服务的登录密码是两回事。** Pebrel 只在本次运行的内存中保留备份密码,下次启动后需要重新输入。恢复时必须使用创建那份备份时的密码;忘记密码就无法解开已有备份,请单独妥善保管。 + +## 选择要带走的内容 + +默认推荐外观、终端设置、助手设置、SSH 主机和工作区会话。还可以按需选择同步设置、自定义字体、目录历史和命令历史;每次备份前都能调整,至少选择一项。 + +- **工作区会话**是窗口、标签和分屏布局,不是正在运行的进程或 AI CLI 对话正文 +- **SSH 主机**包含连接配置,不包含 SSH 私钥,也不会复制系统凭据管理器中的密码或 API Key +- **目录历史**可能包含项目路径;**命令历史**可能包含曾经粘贴的令牌,分享或上传前应检查是否真的需要 +- **自定义字体**会增加备份大小;外部项目文件和各 AI CLI 自己的数据仍需另外备份 + +加密并不等于脱敏。自己写进配置或命令中的秘密仍需检查,不要把备份文件和它的密码一起公开。 + +## 导出文件,迁移到另一台电脑 + +在备份页的 **文件** 区域选择 **导出备份文件**,选择内容和保存位置,生成 `.pebrel-backup` 文件。首次配置向导也提供导出入口,因此只做一次离线备份不必配置云存储。 + +把文件安全地复制到新电脑,并准备创建该文件时使用的备份密码。 + +如果新电脑还停在首次配置向导,先按上面的步骤配置一个已有本地文件夹,选择 **完成,稍后备份**。当前界面的导入入口位于配置完成后的页面,不需要为导入额外开通远程存储。 + +## 只恢复需要的部分 + +1. 从已有快照选择恢复,或在 **文件 → 导入备份文件 → 选择文件…** 中打开 `.pebrel-backup`。 +2. 按提示输入该备份的密码并点 **解开**;如果本次运行已有可用密码,可能直接显示内容。 +3. 检查内容清单,只勾选需要恢复的项目,再确认恢复。 +4. 检查外观、主机和配置,新建终端验证 Shell 与路径;跨系统迁移还需修正旧电脑的路径。 + +**恢复会覆盖本机对应的设置,未勾选的内容不变。** 开始前 Pebrel 会把当前相关文件加密保存为恢复点;恢复完成后可在当前设置页面使用 **撤回**。需要撤回时应先执行并确认结果,不要假设关闭设置页或重启后仍保留同一个撤回入口。 + +SSH 私钥、系统凭据、Shell 和 CLI 安装不会由布局备份恢复,需要在新电脑另外准备。完整迁移检查见[备份与迁移](migration.md)。 + +## 使用远程存储 + +存储向导还支持 WebDAV、S3 兼容存储与 SFTP。准备自己的服务地址和权限,按页面要求填写,再检查连接: + +- **WebDAV**:使用已有目录的完整 HTTPS 地址;服务要求应用专用密码时,不要填普通登录密码 +- **S3**:填写服务提供的端点、存储桶、区域和访问凭据 +- **SFTP**:选择已经保存的 SSH 主机和已有远程目录,沿用该主机的认证配置 +- **本地 / 网络目录**:使用已经挂载的目录;选择同步盘时,文件的后续云同步由该同步客户端处理 + +在这个源码版本中,WebDAV / S3 的凭据管理器保存仅在 Windows 实现。macOS / Linux 需要在启动 Pebrel 的环境中提供 `PEBREL_BACKUP_WEBDAV_PASSWORD` 或 `PEBREL_BACKUP_S3_SECRET`,并将界面的存储密码输入留空。不要把实际秘密写进公开脚本或截图;不方便配置启动环境时,先使用本地文件夹或离线导出。 + +存储位置按最近 10 份快照保留,成功上传后会尝试清理更旧的快照;清理失败会显示提示,不等于这次上传失败。需要长期保存的一份应另外导出保管。更改存储位置后,页面只列出新位置中的备份,旧位置的备份不会随切换而删除。 + +## 常见问题 + +| 现象 | 下一步 | +| --- | --- | +| 解不开备份 | 确认使用的是这份备份的加密密码,而不是网盘或 SSH 密码 | +| 检查连接通过但备份失败 | 核对目录写权限、空间及实际错误;只读连接检查不能证明上传成功 | +| 找不到导入按钮 | 首次向导先完成本地目录配置,再到文件区域导入 | +| 新电脑的 SSH 仍无法登录 | 重新配置私钥和系统凭据,检查用户名和服务器授权 | +| 恢复后程序或项目路径失效 | 修正跨电脑、跨系统路径,再新建终端验证 | diff --git a/docs/site/content/completions.md b/docs/site/content/completions.md index 55956b5d1..58b8e05b3 100644 --- a/docs/site/content/completions.md +++ b/docs/site/content/completions.md @@ -1,34 +1,56 @@ +> [!NOTE] +> 本页按 2026-09-30 的 `main`(`5ff2f3e`)核对。旧版 1.9.1 的补全样式和接受键与这里不同;如果界面没有三个模式,先在设置中核对版本,不要照着新界面寻找旧版没有的选项。 + ## 打开命令补全 -在 **设置 → 终端**开启 **启用命令补全**。回到终端,在普通 Shell 提示符处输入命令或路径的开头,查看出现的建议。 +在 **设置 → 终端 → 补全** 开启 **启用命令补全**,再选择 **补齐模式**。回到普通 Shell 提示符,输入命令或路径的开头。切换模式会立即作用于已经打开的终端。 + +候选既可以来自已执行的历史命令,也可以来自当前环境,例如 Git 分支、项目脚本和文件路径。第一次输入命令也可能出现建议,不必先运行一遍;这些补齐不需要请求 AI 服务或安装 Shell 补齐插件。 + +## 选择模式与接受建议 + +| 模式 | 显示方式 | 如何填入 | +| --- | --- | --- | +| **行内补齐** | 建议以灰字接在光标后 | 按 Tab 接受灰字 | +| **列表补齐** | 随输入显示候选列表 | 上下方向键选择,Tab 填入;没有选中项时 Tab 接受第一项 | +| **混合补齐** | 默认显示灰字;Tab 展开列表 | 右方向键接受灰字;列表中用上下方向键选择、Enter 填入 | + +列表打开时可按 Esc 关闭。混合模式的 Tab 用于打开列表或移动选择,不是直接执行命令。 -补全会结合可用的历史记录和路径信息。第一次进入新环境、尚无相关历史时,建议可能较少。 +**接受建议只填入文字,不执行命令。** 检查完整命令、路径和目标主机,再按 Enter 执行。尤其在混合模式里,第一次 Enter 可能只是接受选中的候选,不要连续按键而跳过检查。 -## 选择建议的显示方式 +当前界面由模式决定按键,不再单独提供“补全接受键”选择。需要完全使用 Shell 自己的补全时,关闭 Pebrel 的 **启用命令补全**。 -在同一设置页中找到 **补全样式**: +## 试用不依赖历史的补齐 -| 选项 | 显示方式 | -| --- | --- | -| **行内灰字** | 建议接在已输入内容后面,适合直接续写命令 | -| **弹窗列表** | 在输入附近列出候选项,适合查看不同选择 | +先进入已有的本地项目目录。在命令末尾保留表中的空格,再输入部分名称。下面是输入前缀,不是要求直接执行的完整命令: -两种样式使用同一补全功能。可以先试行内灰字;需要更明显的候选提示时,再切换列表样式。 +| 输入前缀 | 预期候选 | 没有候选时先确认 | +| --- | --- | --- | +| `git switch ` | 当前仓库可用的分支 | 当前目录属于 Git 仓库,且确实有可切换分支 | +| `npm run ` | 项目 `package.json` 中的脚本名 | 最近的项目清单存在有效的 `scripts` | +| `ssh ` | SSH config 中可用的主机别名 | 本机 `~/.ssh/config` 中配置了具体的 Host 名称 | +| `wsl -d ` | 已注册的 WSL 发行版 | 在 Windows 本地 Shell 中输入,且已安装发行版 | +| `cat ` | 当前目录的文件 | 文件存在,当前 Shell 支持该命令;cmd 可使用 `type ` | -## 接受一条建议 +`ssh -F config ` 会使用指定配置文件中的别名;它与 Pebrel 主机库中保存的显示名称不是同一来源。相关设置见 [SSH config](ssh-config.md)。 -**补全接受键**可以设置为 **Tab**、**右方向键**或**Tab 或右方向键**。建议出现后,使用所选按键接入建议内容,再检查整条命令,按 Enter 执行。 +文件名含空格时,接受后检查引号是否覆盖完整路径。不要把候选中存在某个命令理解为已经安装了该程序;例如补齐 npm 脚本不会替你安装 Node.js,也不会运行脚本。 -如果你希望保留 Shell 自己的 Tab 补全,可以让 Pebrel 使用右方向键。更改后回到 Shell 提示符处试用,不必关闭整个窗口。 +## 历史补齐与环境边界 -## 在不同环境使用 +运行一次无副作用的 `echo deployment finished`,等提示符返回后输入 `echo dep`,可以检查历史建议。历史补齐是复用已执行的命令;项目补齐则依据当前仍然存在的候选,已经删除的脚本或分支不会仅因出现过而重新成为有效项目候选。 -本地 Shell、WSL 与 SSH 会话各自使用对应环境的上下文。例如,WSL 项目中的 Linux 路径应在 WSL 窗格里输入,不要拿 Windows 路径来判断补全是否正确。 +本机 Git、项目脚本、SSH 别名和 WSL 发行版发现用于本地 Shell;不要期待它们读取 SSH 服务器或 WSL 项目中的同名文件。WSL、SSH 的路径建议取决于对应会话的目录查询能力,历史也按环境区分,不应拿宿主机路径来判断远端补齐。 -Vim、全屏程序或正在运行的 AI CLI 有自己的按键操作。需要检查 Pebrel 补全时,先退出到普通 Shell 提示符。 +Vim、全屏程序或正在运行的 AI CLI 有自己的按键行为。检查 Pebrel 补齐时,先回到普通 Shell 提示符。 -## 没有出现预期建议 +## 排查没有建议或建议不对 -先检查 **启用命令补全**是否打开,再确认当前输入位置是 Shell 提示符。输入一次完整命令、执行完成后,再输入相同前缀测试历史建议。 +1. 确认 **启用命令补全** 已打开,输入位置确实是 Shell 提示符。 +2. 用 `pwd`(cmd 使用 `cd`)确认当前目录;Git 和脚本候选需要对应项目上下文。 +3. 区分本地、WSL 和 SSH 窗格,按上面的环境边界检查候选来源。 +4. 用 `echo` 示例区分历史补齐问题与项目候选问题。 +5. 出现两套重复建议时,关闭 Pebrel 补齐或 Shell 插件中的一套再比较。 -路径建议不符合当前目录时,运行 `pwd`(cmd 使用 `cd`)确认目录是否正确。出现两套重复建议时,可以关闭 Pebrel 补全或 Shell 插件中的一套。经常重复使用且不适合依赖历史的长命令,可以存入[保存命令](commands.md)。 +反复使用且不适合依赖历史的长命令,可以存入[保存命令](commands.md)。 diff --git a/docs/site/content/index.md b/docs/site/content/index.md index 8bba824c3..bd8920a8c 100644 --- a/docs/site/content/index.md +++ b/docs/site/content/index.md @@ -13,16 +13,18 @@ | --- | --- | | 安装 Pebrel,或选择适合电脑的版本 | [安装与平台支持](installation.md) | | 一边运行服务,一边输入其他命令 | [标签页与分屏](workspace.md) | +| 补齐分支、脚本、主机和历史命令 | [命令补全](completions.md) | | 下次打开时恢复标签和目录 | [会话保存与恢复](sessions.md) | | 重复使用一组终端布局 | [布局配方](layouts.md) | | 找到并修改项目文件 | [文件浏览](files.md) · [Markdown 编辑](markdown-editing.md) | | 查看改动、提交代码和处理冲突 | [Git 提交](vcs.md) · [解决冲突](git-conflicts.md) · [SVN](svn.md) | | 将文件传到服务器 | [SFTP 文件传输](sftp.md) | +| 从 Android 查看电脑终端或发送输入 | [Android 连接电脑](mobile.md) | | 重新打开上次的 AI 对话 | [AI 会话历史](ai-history.md) | | 更改快捷键或通知时间 | [快捷键](keyboard.md) · [通知](notifications.md) | -| 备份设置,或迁移到另一台电脑 | [备份与迁移](migration.md) | +| 备份设置,或迁移到另一台电脑 | [加密备份](backups.md) · [备份与迁移](migration.md) | | 处理无法启动、连接或保存的问题 | [故障排查](troubleshooting.md) |
    Pebrel 的顶部标签栏与终端工作区
    终端工作区。截图中的主题和窗口装饰可能因平台而不同。
    -本指南适用于 **Pebrel 1.9.1**。macOS 和 Linux 安装包目前标为 Preview;平台差异见[安装与平台支持](installation.md)。 +本指南的基础页面适用于 **Pebrel 1.9.1**;[命令补全](completions.md)等已更新页面会在正文和“版本与参考”中单独注明核对的 `main` 日期与提交。`main` 中的功能不代表已发布到你安装的版本。macOS 和 Linux 安装包目前标为 Preview;平台差异见[安装与平台支持](installation.md)。 diff --git a/docs/site/content/migration.md b/docs/site/content/migration.md index b340d8228..08b86415b 100644 --- a/docs/site/content/migration.md +++ b/docs/site/content/migration.md @@ -1,3 +1,5 @@ +新版 `main` 中的 **设置 → 备份** 支持加密快照与选择性恢复,使用步骤和适用范围见[加密备份与恢复](backups.md)。本页保留手动备份与跨电脑迁移的检查步骤。 + ## 找到个人数据目录 | 系统 | 标准位置 | diff --git a/docs/site/content/mobile.md b/docs/site/content/mobile.md new file mode 100644 index 000000000..50753ca34 --- /dev/null +++ b/docs/site/content/mobile.md @@ -0,0 +1,67 @@ +> [!NOTE] +> 本页按 2026-09-30 的 `main`(`5ff2f3e`)核对,面向带有 **手机远程** 设置的桌面版本和匹配的 Android 客户端。它不表示 1.9.1 或任意旧 APK 已支持这些流程;下载内容以[项目发行版](https://github.com/Kuddev/pebrel/releases)实际提供的文件为准。 + +## 准备连接 + +手机可以查看电脑上运行的任务,并在获准后发送终端输入。**命令仍在电脑上执行**:电脑需要保持运行和网络可达,手机不会在断线后接管电脑的进程。 + +先准备已安装的 Android 客户端和电脑上的 Pebrel。下面使用 **局域网 / Tailscale** 连接: + +- 同一 Wi-Fi 或局域网内,两台设备需要能够互相访问 +- 使用 Tailscale 时,两端需要加入可互通的 Tailnet,并选手机可访问的电脑地址 +- 网络隔离、系统防火墙或电脑休眠可能阻止连接;不要为配对把本机运行时控制端口直接公开到互联网 + +当前 Android 项目的最低版本为 Android 8.0(API 26)。这里描述 Android 流程,不代表提供了同样的 iOS 客户端。 + +## 在电脑上开始配对 + +1. 打开 **设置 → 手机远程**,点 **开启并配对手机**。 +2. 选择 **局域网 / Tailscale**。 +3. 在 **网卡** 中选手机可达的地址;**监听端口** 可留空,由程序选择。 +4. 保持配对页面打开,准备扫描二维码或复制配对信息。 + +二维码单次使用,10 分钟后失效。过期或已经用过时,点 **换一个** 生成新的配对信息,不要反复使用旧截图。二维码和完整配对信息都应只交给自己的设备。 + +## 在 Android 上连接电脑 + +打开手机的 **连接电脑**,选择一种方式: + +| 方式 | 操作 | 适用情况 | +| --- | --- | --- | +| **扫码** | 允许相机,扫描电脑上的二维码 | 手机能看到电脑屏幕 | +| **8 位配对码** | 选择同一局域网发现的电脑,输入二维码下方的 8 位数字 | 本地发现已经找到正确电脑 | +| **粘贴** | 电脑点 **复制完整配对信息**,在手机粘贴,再点 **导入并连接** | 不方便使用相机或局域网发现 | + +拒绝相机权限后仍可使用配对码或粘贴。没有发现电脑时,先核对网络与网卡,再尝试扫码或粘贴;不要把 8 位码当作可以跨任意网络寻找电脑的地址,Tailscale 连接也不保证自动发现。 + +## 核对校验码并批准 + +手机显示 **等待电脑批准** 后,在两端核对校验码。只有内容一致、而且确实是自己刚发起的配对,才在电脑点 **批准**;不一致或不认识的请求应点 **拒绝**。 + +8 位配对码用于发起连接,批准时的校验码用于核对这次配对,它们不是同一个用途的码。不要仅因输入过 8 位码就跳过电脑批准。 + +## 从只看改为允许输入 + +首次使用时,**新手机的默认权限** 为 **只看**;如果你曾修改过该默认值,配对后先核对这台手机的实际权限。先在手机查看正确的终端,确认任务和电脑对应。 + +确实需要远程输入时,在电脑 **已配对的手机** 中,把该手机的权限改为 **允许输入**。发送前核对目标终端、当前目录和正在运行的程序;发到普通 Shell 的文字与发到 AI CLI 的文字可能产生不同结果。 + +只看权限并不允许手机发送终端输入。需要收回操作权限时,在电脑改回 **只看**,不必重新配对。 + +## 暂停连接或移除手机 + +- **暂停**:停止监听并断开手机,但保留已经建立的配对 +- **移除**:撤销这台手机的授权,下次连接需要重新配对 + +丢失手机或不再使用该设备时,应在电脑移除它。只退出手机页面不等于撤销电脑上的配对授权。 + +## 连不上时按顺序检查 + +1. 电脑是否正在运行、未休眠,**手机远程** 是否开启而非暂停。 +2. 所选网卡地址是否能从手机访问,网络是否隔离设备。 +3. 二维码是否超过 10 分钟或已经用过;需要时生成新的配对信息。 +4. 电脑是否仍有待批准请求;核对校验码后处理。 +5. 只有输入不可用时,检查这台手机是否仍是 **只看**。 +6. 切换 Wi-Fi 或 Tailscale 地址后,核对实际连接地址;必要时使用新的配对信息。 + +桌面和手机版本差异较大时,先使用匹配版本再排查。与 SSH 服务器建立终端连接是另一种工作流,见[SSH 连接](ssh.md)。 diff --git a/docs/site/content/settings.md b/docs/site/content/settings.md index df868798f..7ef313266 100644 --- a/docs/site/content/settings.md +++ b/docs/site/content/settings.md @@ -14,7 +14,7 @@ | 界面字号、语言、密度与透明度 | **外观 → 界面** | | 壁纸及图片铺放方式 | **外观 → 自定义背景** | | 默认 Shell、启动目录 | **终端 → 启动** | -| 历史补全样式和接受键 | **终端 → 补全** | +| 命令补全(模式和按键见[补全指南](completions.md)) | **终端 → 补全** | | AI 通知、卡片时长、终端铃声 | **终端 → 提醒** | | 工具检测与集成 | **Agents** | | 选中即复制、鼠标焦点、粘贴确认 | **交互 → 鼠标与选区** | diff --git a/docs/site/site.json b/docs/site/site.json index 7031e138f..7a31a5a8f 100644 --- a/docs/site/site.json +++ b/docs/site/site.json @@ -101,13 +101,19 @@ }, { "slug": "completions", - "title": "历史与路径补全", - "description": "开启补全,选择建议样式,并设置接受建议的按键。", + "title": "命令补全与智能候选", + "description": "选择三种补齐模式,补齐 Git 分支、项目脚本、SSH 别名、路径与历史命令。", "sources": [ - "nebula_app/src/completion_context.rs", - "nebula_app/src/gpui_shell/terminal/completion_viewport.rs", - "nebula_app/src/gpui_shell/settings_pane/setting_help.rs" - ] + "nebula_app/src/gpui_shell/settings_pane.rs", + "nebula_app/i18n/zh-CN.json", + "nebula_app/src/gpui_shell/terminal/view/completion.rs", + "nebula_app/src/completion.rs", + "nebula_app/src/completion/connections.rs", + "nebula_app/src/completion/project_scripts.rs", + "nebula-completions/src/semantic/common.rs" + ], + "version": "main(2026-09-30)", + "source_commit": "5ff2f3eea54b9c66e416149e17e823b8d72b1dee" }, { "slug": "palette", @@ -259,6 +265,24 @@ "nebula_app/src/ssh_sftp/transfer.rs", "nebula_app/src/ssh_sftp/transaction.rs" ] + }, + { + "slug": "mobile", + "title": "Android 连接电脑", + "description": "配对自己的手机、核对校验码、选择只看或允许输入,并撤销不用的设备。", + "version": "main(2026-09-30)", + "source_commit": "5ff2f3eea54b9c66e416149e17e823b8d72b1dee", + "sources": [ + "nebula_app/src/gpui_shell/settings_pane/mobile/view.rs", + "nebula_app/src/mobile_connection/preferences.rs", + "nebula_app/i18n/zh-CN.json", + "mobile/android/app/src/main/java/io/github/kuddev/pebrel/mobile/ui/RelayForm.kt", + "mobile/android/app/src/main/java/io/github/kuddev/pebrel/mobile/ui/TerminalScreen.kt", + "mobile/android/app/src/main/res/values-zh-rCN/pairing.xml", + "mobile/android/app/build.gradle.kts", + "mobile/link/src/pairing.rs", + "mobile/link/src/endpoint/host.rs" + ] } ] }, @@ -533,6 +557,23 @@ "nebula_app/src/update_download.rs" ] }, + { + "slug": "backups", + "title": "加密备份与恢复", + "description": "创建加密快照、导出迁移文件、选择恢复内容,检查密码与存储平台限制。", + "version": "main(2026-09-30)", + "source_commit": "5ff2f3eea54b9c66e416149e17e823b8d72b1dee", + "sources": [ + "nebula_app/src/gpui_shell/settings_pane/backup.rs", + "nebula_app/src/gpui_shell/settings_pane/backup/setup.rs", + "nebula_app/src/gpui_shell/settings_pane/backup/view.rs", + "nebula_app/src/gpui_shell/settings_pane/backup/operations.rs", + "nebula_app/src/encrypted_backup.rs", + "nebula_app/src/encrypted_backup/recovery.rs", + "nebula_app/src/backup_remote.rs", + "nebula_app/i18n/zh-CN.json" + ] + }, { "slug": "migration", "title": "备份与迁移", diff --git a/docs/site/test_site.py b/docs/site/test_site.py index 227ebee7c..cb2471e77 100644 --- a/docs/site/test_site.py +++ b/docs/site/test_site.py @@ -7,7 +7,7 @@ from pathlib import Path from urllib.parse import unquote, urlsplit -from build import build, HERE, home_header, page_url +from build import build, HERE, home_header, page_url, source_details class Document(HTMLParser): @@ -102,6 +102,17 @@ def test_homepage_hero_has_no_eyebrow_or_description(self): self.assertIn('installation/index.html', hero) self.assertEqual(header.count('https://github.com/Kuddev/pebrel/releases/latest'), 3) + def test_page_specific_version_and_sources(self): + config = json.loads((HERE / 'site.json').read_text()) + for group in config['groups']: + for page in group['pages']: + with self.subTest(page=page['slug']): + output = (self.root / page_url(page['slug'])).read_text() + commit = page.get('source_commit', config['source_commit']) + self.assertIn(source_details(page, config['source_commit']), output) + self.assertIn(f'/blob/{commit}/', output) + self.assertIn(f"Pebrel {page.get('version', config['version'])} 用户手册", output) + def test_page_structure(self): for path, document in self.documents.items(): with self.subTest(page=path): From cddce85debb51ee2a9a0a81f622ea0c736f9aa1b Mon Sep 17 00:00:00 2001 From: GeekMr <140129782+WilliamWang1721@users.noreply.github.com> Date: Wed, 7 Oct 2026 18:11:31 +0800 Subject: [PATCH 10/13] docs(site): add supported-agents guide, built-in colour themes and 2.1.1 baseline - Add a "supported AI CLI/TUI" guide and rewrite the Agent integration, AI start and history pages from the real settings, menus and CLI entry points. - Derive the site colours from the application's 16 built-in themes at build time (palettes.py) with a header theme picker; simplify the layout. - Re-audit the base pages against the v2.1.1 tag: platform integrations on macOS/Linux, Windows ARM64 installer, release asset names, update channels, settings navigation, and 2.0/2.1 features. Pin the manifest to v2.1.1. --- .gitignore | 2 + .../docs/site/2026-09-24-static-user-guide.md | 25 ++ docs/site/README.md | 23 +- docs/site/assets/site.css | 384 +++++++----------- docs/site/assets/site.js | 54 ++- docs/site/build.py | 16 +- docs/site/check_browser.py | 4 + docs/site/content/agents.md | 116 ++++++ docs/site/content/ai-history.md | 12 +- docs/site/content/ai-start.md | 6 +- docs/site/content/appearance.md | 6 +- docs/site/content/backups.md | 4 +- docs/site/content/clipboard.md | 2 +- docs/site/content/completions.md | 2 +- docs/site/content/contributing.md | 4 + docs/site/content/documents.md | 2 +- docs/site/content/fonts.md | 12 +- docs/site/content/hooks.md | 98 ++++- docs/site/content/index.md | 11 +- docs/site/content/installation.md | 41 +- docs/site/content/interaction.md | 2 +- docs/site/content/keyboard.md | 6 +- docs/site/content/markdown-editing.md | 2 +- docs/site/content/mobile.md | 2 +- docs/site/content/navigation.md | 2 +- docs/site/content/network.md | 2 +- docs/site/content/palette.md | 2 +- docs/site/content/privacy.md | 4 + docs/site/content/quick-terminal.md | 8 +- docs/site/content/quickstart.md | 2 +- docs/site/content/readme.md | 15 +- docs/site/content/runtime.md | 25 +- docs/site/content/sessions.md | 4 +- docs/site/content/settings.md | 14 +- docs/site/content/sftp.md | 2 +- docs/site/content/shells.md | 4 +- docs/site/content/ssh-library.md | 14 +- docs/site/content/themes.md | 2 +- docs/site/content/troubleshooting.md | 4 +- docs/site/content/updates.md | 12 +- docs/site/content/workspace.md | 6 +- docs/site/palettes.py | 182 +++++++++ docs/site/site.json | 38 +- docs/site/template.html | 15 +- docs/site/test_site.py | 20 + 45 files changed, 823 insertions(+), 390 deletions(-) create mode 100644 docs/site/content/agents.md create mode 100644 docs/site/palettes.py diff --git a/.gitignore b/.gitignore index 1dd90a2b9..b2c9bf971 100644 --- a/.gitignore +++ b/.gitignore @@ -222,6 +222,7 @@ NebulaTerminal-*/ !/docs/site/assets/site.css !/docs/site/assets/site.js !/docs/site/build.py +!/docs/site/palettes.py !/docs/site/check_browser.py !/docs/site/content/index.md !/docs/site/content/installation.md @@ -256,6 +257,7 @@ NebulaTerminal-*/ !/docs/site/content/ai-start.md !/docs/site/content/hooks.md !/docs/site/content/ai-history.md +!/docs/site/content/agents.md !/docs/site/content/send-to-chat.md !/docs/site/content/appearance.md !/docs/site/content/themes.md diff --git a/architecture/notes/docs/site/2026-09-24-static-user-guide.md b/architecture/notes/docs/site/2026-09-24-static-user-guide.md index e4d9de00c..d57f78e01 100644 --- a/architecture/notes/docs/site/2026-09-24-static-user-guide.md +++ b/architecture/notes/docs/site/2026-09-24-static-user-guide.md @@ -53,3 +53,28 @@ None. Multiple maintained languages or versioned manuals make the current navigation manifest insufficient, or the small local search index no longer meets users' needs. Re-evaluate on measured behavior rather than adding services in advance. + +## Colour themes (2026-10-07) + +The guide takes its colours from the application's built-in themes instead of a +site-specific palette, so the documentation reads as part of the product and +readers can choose the theme they already use. `docs/site/palettes.py` parses the +catalog from `nebula_settings/src/themes.rs` at build time; the build fails when +that source changes shape. A hand-copied colour table was rejected because it would +drift from the application. A fixed light/dark pair was rejected because the +application ships sixteen themes and a toggle cannot express them. Where a theme's +accent or muted colour is too faint for text, the site darkens or lightens it toward +the theme foreground until it reaches 4.5:1; the application's own colours are +unchanged. The choice is stored in browser storage only. + +## Release baseline (2026-10-07) + +The base pages were re-audited against the `v2.1.1` tag and the manifest now records +that version and commit for every page; the earlier page-level `main` overrides were +removed. The tag, not `main`, is the baseline because the guide describes what readers +can install: `main` carries features that are not in any release. Pages whose behaviour +changed between 1.9.1 and 2.1.1 were updated from the code at the tag (platform +integrations on macOS and Linux, Windows ARM64 installer, release asset names, update +channels, settings navigation) and from the release notes for 2.0.0, 2.1.0 and 2.1.1. +Differences that are only translation refactors were not treated as behaviour changes. + diff --git a/docs/site/README.md b/docs/site/README.md index 363eac415..df1fe393a 100644 --- a/docs/site/README.md +++ b/docs/site/README.md @@ -19,14 +19,35 @@ For the browser smoke check, install `playwright==1.57.0`, run The check serves the site under `/pebrel/`, exercising project-site path handling. `CHROMIUM_PATH` optionally selects an existing Chromium executable. -The manifest currently contains 55 user-facing guides, organized by tasks rather +The manifest currently contains 56 user-facing guides, organized by tasks rather than implementation modules. Source links are pinned to the documented commit. +The documented baseline is the `v2.1.1` release (commit `d574856`). Pages were checked +against that tag, not against later `main`: UI labels, platform availability and file +names such as release assets follow what 2.1.1 shipped. When a later release changes a +page, update that page, its evidence and `site.json` together, or record a page-level +`version` and `source_commit` as described below. + The generated `dist/` is disposable and ignored. Publish that directory's contents, not this source directory. Open `index.html` directly for offline reading; browser clipboard policies may require HTTP(S), in which case select and copy the text. Search loads a local JavaScript index rather than requiring a backend or CDN. +## Colour themes + +The site uses the desktop application's own palettes. `palettes.py` parses the 16 +built-in themes from `nebula_settings/src/themes.rs` (and their names from +`nebula_app/src/display/ui/theme.rs`) at build time and writes `assets/palettes.css` +plus the syntax colours in `assets/highlight.css`. Nothing is copied by hand, so a +theme added or retuned in the application reaches the site on the next build, and the +build fails if the source no longer has the expected shape. + +Readers pick a theme from the palette button in the header. **Follow system** mirrors the +application's default pair, Nord Light and Nord. The choice is stored in the browser +only. Accent, muted and syntax colours are nudged toward the theme's foreground when +they would fall below a 4.5:1 contrast ratio on the page or code surface; the tests +check this for every theme. + ## GitHub Pages The `User documentation` workflow builds and checks documentation on matching diff --git a/docs/site/assets/site.css b/docs/site/assets/site.css index 787076f5e..e13e443da 100644 --- a/docs/site/assets/site.css +++ b/docs/site/assets/site.css @@ -1,32 +1,12 @@ :root { - --bg:#fff; - --soft:#f7f8f6; - --panel:#fafbf9; - --text:#19201c; - --muted:#667069; - --line:#e6e9e5; - --accent:#197452; - --tint:#eaf4ec; - --code:#f5f7f4; - --shadow:0 24px 90px #17231c22; - --header:72px; - --sidebar:260px; - --radius:14px; + --header:60px; + --sidebar:248px; + --radius:8px; --font:-apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC","Microsoft YaHei",sans-serif; } -[data-theme=dark] { - --bg:#151816; - --soft:#1d211e; - --panel:#191d1a; - --text:#e6ebe6; - --muted:#a0aaa2; - --line:#303831; - --accent:#89d7a9; - --tint:#25392c; - --code:#1c231e; - --shadow:0 24px 90px #0008; - color-scheme:dark; +[hidden] { + display:none!important; } * { @@ -133,16 +113,6 @@ kbd { top:10px; } -.reading-progress { - position:fixed; - left:0; - top:0; - height:2px; - background:var(--accent); - width:0; - z-index:51; -} - .header { height:var(--header); position:fixed; @@ -150,11 +120,10 @@ kbd { z-index:40; display:flex; align-items:center; - gap:40px; - padding:0 30px; + gap:32px; + padding:0 24px; border-bottom:1px solid var(--line); - background:color-mix(in srgb,var(--bg) 94%,transparent); - backdrop-filter:blur(14px); + background:var(--panel); } .brand { @@ -170,13 +139,6 @@ kbd { letter-spacing:-.8px; } -.brand-divider { - height:20px; - width:1px; - background:var(--line); - margin:0 5px; -} - .brand-docs { color:var(--muted); font-size:14px; @@ -231,7 +193,7 @@ kbd { align-items:center; gap:10px; border:1px solid var(--line); - border-radius:9px; + border-radius:8px; background:var(--soft); color:var(--muted); padding:0 11px; @@ -254,7 +216,7 @@ kbd { place-items:center; width:40px; height:40px; - border-radius:9px; + border-radius:8px; color:var(--muted); } @@ -276,7 +238,7 @@ kbd { padding:29px 18px 20px 25px; border-right:1px solid var(--line); overflow:auto; - background:var(--bg); + background:var(--panel); scrollbar-width:thin; scrollbar-color:var(--line) transparent; z-index:30; @@ -295,9 +257,9 @@ kbd { .version { font:11px ui-monospace,SFMono-Regular,monospace; - border:1px solid var(--line); border-radius:20px; - padding:3px 7px; + padding:2px 7px; + background:var(--soft); color:var(--muted); font-weight:400; } @@ -311,7 +273,6 @@ kbd { color:var(--muted); font-weight:600; padding:4px 11px 8px; - letter-spacing:.045em; } .nav-link { @@ -402,17 +363,17 @@ main:focus { } .page-heading h1 { - font-size:38px; - letter-spacing:-1.2px; - line-height:1.28; - margin:0 0 15px; - font-weight:570; + font-size:32px; + letter-spacing:-.8px; + line-height:1.3; + margin:0 0 12px; + font-weight:600; } .page-description { - font-size:16px; + font-size:15px; color:var(--muted); - line-height:1.85; + line-height:1.8; max-width:650px; margin:0; } @@ -502,27 +463,15 @@ main:focus { } .hero { - position:relative; - background:var(--tint); - border:1px solid color-mix(in srgb,var(--accent) 13%,var(--line)); - border-radius:18px; - padding:38px 36px 34px; - overflow:hidden; - margin:0 0 31px; - isolation:isolate; -} - -.hero .eyebrow { - font-size:10px; - letter-spacing:.15em; + margin:0 0 28px; } .hero h1 { - font-size:40px; - font-weight:550; - line-height:1.36; - letter-spacing:-1.1px; - margin:15px 0 18px; + font-size:36px; + font-weight:600; + line-height:1.35; + letter-spacing:-.9px; + margin:0 0 22px; max-width:540px; } @@ -530,53 +479,6 @@ main:focus { color:var(--accent); } -.hero p { - font-size:14px; - line-height:1.9; - max-width:455px; - color:var(--muted); - margin:0 0 27px; -} - -.hero-art { - position:absolute; - right:-55px; - top:35px; - width:230px; - height:260px; - opacity:.15; - z-index:-1; - transform:rotate(-13deg); - pointer-events:none; -} - -.hero-art i { - position:absolute; - width:210px; - height:142px; - border:1px solid var(--accent); - border-radius:24px; - right:0; - top:20px; -} - -.hero-art i:nth-child(2) { - transform:translate(-20px,38px); -} - -.hero-art i:nth-child(3) { - transform:translate(-40px,76px); -} - -.hero-art:after { - content:">_"; - font:80px ui-monospace,monospace; - position:absolute; - top:5px; - right:100px; - color:var(--accent); -} - .hero-actions { display:flex; align-items:center; @@ -584,7 +486,7 @@ main:focus { } .button-primary { - background:var(--text); + background:var(--accent); color:var(--bg)!important; display:inline-flex; align-items:center; @@ -592,15 +494,14 @@ main:focus { font-size:12px; font-weight:500; padding:10px 17px; - border:1px solid var(--text); + border:1px solid var(--accent); border-radius:8px; - min-height:42px; + min-height:40px; text-decoration:none!important; } .button-primary:hover { - opacity:.85; - transform:translateY(-1px); + opacity:.88; } .text-link { @@ -650,10 +551,9 @@ main:focus { } .readme-intro { - border:1px solid var(--line); - border-radius:14px; - padding:24px; - background:linear-gradient(135deg,var(--soft),var(--bg)); + border-radius:8px; + padding:20px; + background:var(--soft); margin:18px 0 24px; } @@ -678,7 +578,7 @@ main:focus { .readme-visual-card { border:1px solid var(--line); - border-radius:12px; + border-radius:8px; padding:19px; background:var(--panel); } @@ -730,7 +630,7 @@ main:focus { .contribution-flow>div { border:1px solid var(--line); - border-radius:11px; + border-radius:8px; padding:16px; min-width:0; } @@ -760,38 +660,21 @@ main:focus { .feature-grid { display:grid; grid-template-columns:repeat(2,minmax(0,1fr)); - gap:13px; + gap:12px; margin:20px 0 32px; } .feature-card { border:1px solid var(--line); - border-radius:12px; - padding:23px!important; + border-radius:8px; + padding:18px 20px!important; display:block; - position:relative; text-decoration:none!important; background:var(--bg); - transition:transform .2s,border-color .2s,box-shadow .2s; } .feature-card:hover { - border-color:color-mix(in srgb,var(--accent) 45%,var(--line)); - transform:translateY(-3px); - box-shadow:0 8px 24px #17231c08; -} - -.feature-card .card-symbol { - font:18px ui-monospace,monospace; - color:var(--accent); - display:grid; - place-items:center; - width:35px; - height:35px; - background:var(--soft); - border:1px solid var(--line); - border-radius:9px; - margin-bottom:16px; + border-color:var(--accent); } .feature-card h3 { @@ -807,19 +690,6 @@ main:focus { max-width:240px; } -.feature-card .card-arrow { - position:absolute; - right:21px; - top:25px; - color:var(--muted); - font-size:16px; -} - -.feature-card:hover .card-arrow { - color:var(--accent); - transform:translateX(2px); -} - .prose { font-size:16px; line-height:1.9; @@ -918,7 +788,7 @@ main:focus { .code-block { border:1px solid var(--line); - border-radius:12px; + border-radius:8px; background:var(--code); margin:19px 0; overflow:hidden; @@ -960,7 +830,7 @@ main:focus { overflow:auto; margin:20px 0; border:1px solid var(--line); - border-radius:10px; + border-radius:8px; scrollbar-width:thin; } @@ -973,8 +843,8 @@ main:focus { } .prose th { - font-weight:550; - background:var(--soft); + font-weight:500; + color:var(--muted); white-space:nowrap; } @@ -999,11 +869,10 @@ main:focus { .callout,.prose blockquote { padding:16px 19px; margin:23px 0; - border:1px solid var(--line); border-left:3px solid var(--accent); background:var(--soft); - border-radius:0 9px 9px 0; - font-size:12px; + border-radius:0 6px 6px 0; + font-size:13px; } .callout p,.prose blockquote p { @@ -1018,21 +887,17 @@ main:focus { } .callout.warning { - border-left-color:#ae812f; + border-left-color:var(--yellow); } .callout.warning .callout-title { - color:#987126; -} - -[data-theme=dark] .callout.warning .callout-title { - color:#e1ba76; + color:var(--yellow); } .prose details { margin:18px 0; border:1px solid var(--line); - border-radius:10px; + border-radius:8px; padding:15px 18px; } @@ -1067,7 +932,7 @@ main:focus { display:block; width:100%; height:auto; - border-radius:12px; + border-radius:8px; border:1px solid var(--line); background:var(--soft); } @@ -1077,7 +942,7 @@ main:focus { width:100%; padding:0; border:0; - border-radius:12px; + border-radius:8px; background:none; cursor:zoom-in; } @@ -1099,7 +964,7 @@ main:focus { .platform-tabs { border:1px solid var(--line); padding:18px 22px; - border-radius:12px; + border-radius:8px; margin:22px 0; } @@ -1167,7 +1032,7 @@ main:focus { .page-pagination a { border:1px solid var(--line); - border-radius:10px; + border-radius:8px; padding:16px 18px; display:flex; flex-direction:column; @@ -1210,18 +1075,17 @@ dialog { color:var(--text); border:1px solid var(--line); background:var(--bg); - box-shadow:var(--shadow); + box-shadow:0 12px 40px color-mix(in srgb,#000 20%,transparent); padding:0; } dialog::backdrop { - background:#10221855; - backdrop-filter:blur(5px); + background:color-mix(in srgb,var(--text) 32%,transparent); } .search-dialog { width:min(680px,calc(100vw - 32px)); - border-radius:16px; + border-radius:8px; margin:15vh auto auto; max-height:74vh; overflow:hidden; @@ -1285,7 +1149,7 @@ dialog::backdrop { background:transparent; color:var(--text); padding:12px 14px; - border-radius:9px; + border-radius:8px; margin:2px 0; } @@ -1334,7 +1198,7 @@ dialog::backdrop { width:calc(100vw - 80px); max-width:1500px; max-height:92vh; - border-radius:14px; + border-radius:8px; padding:18px; overflow:auto; text-align:right; @@ -1361,9 +1225,8 @@ dialog::backdrop { background:var(--text); color:var(--bg); border:1px solid var(--line); - box-shadow:var(--shadow); padding:10px 19px; - border-radius:10px; + border-radius:8px; font-size:12px; opacity:0; pointer-events:none; @@ -1400,37 +1263,6 @@ dialog::backdrop { } } -@keyframes reveal { - from { - opacity:0; - transform:translateY(12px); - } - to { - opacity:1; - transform:none; - } -} - -.revealed { - animation:reveal .5s ease-out both; -} - -.feature-card:nth-child(2) { - animation-delay:60ms; -} - -.feature-card:nth-child(3) { - animation-delay:100ms; -} - -.feature-card:nth-child(4) { - animation-delay:140ms; -} - -@view-transition { - navigation:auto; -} - @media(min-width:1700px) { .workspace { padding-left:74px; @@ -1476,9 +1308,6 @@ dialog::backdrop { .header-links { gap:20px; } - .hero-art { - right:-95px; - } .hero h1 { font-size:37px; } @@ -1488,9 +1317,6 @@ dialog::backdrop { .brand-docs { display:none; } - .brand-divider { - display:none; - } } @media(max-width:800px) { @@ -1544,8 +1370,7 @@ dialog::backdrop { .drawer-backdrop { position:fixed; inset:var(--header) 0 0; - background:#10221855; - backdrop-filter:blur(2px); + background:color-mix(in srgb,var(--text) 32%,transparent); z-index:44; } .workspace { @@ -1558,7 +1383,7 @@ dialog::backdrop { } .hero { padding:29px 26px; - border-radius:14px; + border-radius:8px; } .hero h1 { font-size:34px; @@ -1567,10 +1392,6 @@ dialog::backdrop { font-size:13px; max-width:370px; } - .hero-art { - right:-110px; - opacity:.12; - } .breadcrumb { margin-bottom:22px; } @@ -1624,9 +1445,6 @@ dialog::backdrop { .hero-actions { gap:15px; } - .hero-art { - display:none; - } .platform-strip { gap:11px; font-size:10px; @@ -1641,10 +1459,6 @@ dialog::backdrop { .feature-card { padding:17px!important; } - .feature-card .card-arrow { - right:14px; - top:21px; - } .feature-card h3 { font-size:14px!important; } @@ -1742,7 +1556,7 @@ dialog::backdrop { color:#000!important; background:transparent!important; } - .header,.sidebar,.toc,.page-tools,.page-pagination,.article-footer,.reading-progress,.heading-anchor,dialog,.toast,.back-top,.copy-code,.hero-art { + .header,.sidebar,.toc,.page-tools,.page-pagination,.article-footer,.heading-anchor,dialog,.toast,.back-top,.copy-code { display:none!important; } .workspace { @@ -1809,3 +1623,79 @@ dialog::backdrop { padding-top:28px; } } + +.palette-picker { + position:relative; +} + +.palette-menu { + position:absolute; + right:0; + top:calc(100% + 8px); + width:232px; + max-height:min(560px,calc(100vh - var(--header) - 24px)); + overflow:auto; + padding:6px; + border:1px solid var(--line); + border-radius:8px; + background:var(--bg); + box-shadow:0 12px 40px color-mix(in srgb,#000 18%,transparent); + z-index:60; + scrollbar-width:thin; +} + +.palette-group { + display:flex; + flex-direction:column; + margin-top:6px; + padding-top:6px; + border-top:1px solid var(--line); +} + +.palette-group>span { + padding:4px 10px; + font-size:11px; + color:var(--muted); +} + +.palette-menu button { + display:flex; + align-items:center; + gap:10px; + width:100%; + padding:7px 10px; + border:0; + border-radius:6px; + background:transparent; + font-size:13px; + text-align:left; +} + +.palette-menu button:hover, +.palette-menu button:focus-visible { + background:var(--soft); +} + +.palette-menu button[aria-checked=true] { + color:var(--accent); + font-weight:550; +} + +.palette-menu button[aria-checked=true]::after { + content:"✓"; + margin-left:auto; +} + +.swatch { + width:16px; + height:16px; + flex:none; + border:1px solid var(--line); + border-radius:50%; + background:linear-gradient(135deg,var(--a) 50%,var(--b) 50%); +} + +.swatch-system { + --a:#eceff4; + --b:#2e3440; +} diff --git a/docs/site/assets/site.js b/docs/site/assets/site.js index 61ee57f65..fc5e78e63 100644 --- a/docs/site/assets/site.js +++ b/docs/site/assets/site.js @@ -48,20 +48,48 @@ } })); - const themeToggle = $('#theme-toggle'); - function updateThemeLabel() { - const dark = document.documentElement.dataset.theme === 'dark'; - themeToggle.setAttribute('aria-label', dark ? '切换到浅色主题' : '切换到深色主题'); - themeToggle.title = themeToggle.getAttribute('aria-label'); - themeToggle.setAttribute('aria-pressed', String(dark)); + const html = document.documentElement; + const paletteButton = $('#theme-toggle'); + const paletteMenu = $('#palette-menu'); + const paletteOptions = $$('[data-palette-option]'); + const darkPalettes = new Set(paletteOptions.filter(option => option.closest('[aria-label="深色"]')).map(option => option.dataset.paletteOption)); + const systemDark = matchMedia('(prefers-color-scheme: dark)'); + function applyPalette(choice, remember) { + const id = choice === 'system' ? (systemDark.matches ? 'Nord' : 'NordLight') : choice; + html.dataset.palette = id; + html.dataset.theme = darkPalettes.has(id) ? 'dark' : 'light'; + if (choice === 'system') html.dataset.follow = 'system'; else delete html.dataset.follow; + paletteOptions.forEach(option => option.setAttribute('aria-checked', String(option.dataset.paletteOption === choice))); + $('meta[name=theme-color]')?.setAttribute('content', getComputedStyle(html).getPropertyValue('--bg').trim()); + if (remember) { try { localStorage.setItem('pebrel-docs-palette', choice); } catch { /* Session only. */ } } } - updateThemeLabel(); - themeToggle.addEventListener('click', () => { - const theme = document.documentElement.dataset.theme === 'dark' ? 'light' : 'dark'; - document.documentElement.dataset.theme = theme; - try { localStorage.setItem('pebrel-docs-theme', theme); } catch { /* Session only. */ } - updateThemeLabel(); + function currentChoice() { return html.dataset.follow === 'system' ? 'system' : html.dataset.palette; } + function setPaletteMenu(open) { + paletteMenu.hidden = !open; + paletteButton.setAttribute('aria-expanded', String(open)); + if (open) (paletteMenu.querySelector('[aria-checked=true]') || paletteOptions[0]).focus(); + } + applyPalette(currentChoice(), false); + paletteButton.addEventListener('click', () => setPaletteMenu(paletteMenu.hidden)); + paletteOptions.forEach(option => option.addEventListener('click', () => { + applyPalette(option.dataset.paletteOption, true); + setPaletteMenu(false); + paletteButton.focus(); + })); + paletteMenu.addEventListener('keydown', event => { + const index = paletteOptions.indexOf(document.activeElement); + if (event.key === 'ArrowDown' || event.key === 'ArrowUp') { + event.preventDefault(); + paletteOptions[(index + (event.key === 'ArrowDown' ? 1 : -1) + paletteOptions.length) % paletteOptions.length].focus(); + } else if (event.key === 'Escape') { + setPaletteMenu(false); + paletteButton.focus(); + } + }); + document.addEventListener('click', event => { + if (!paletteMenu.hidden && !event.target.closest('.palette-picker')) setPaletteMenu(false); }); + systemDark.addEventListener('change', () => { if (currentChoice() === 'system') applyPalette('system', false); }); const sidebar = $('#sidebar'); const menu = $('#menu-toggle'); @@ -244,8 +272,6 @@ if (scheduled) return; scheduled = true; requestAnimationFrame(() => { - const range = document.documentElement.scrollHeight - innerHeight; - $('.reading-progress').style.width = `${range > 0 ? scrollY / range * 100 : 0}%`; let active = headings[0]?.id; for (const heading of headings) { if (heading.getBoundingClientRect().top <= 145) active = heading.id; } tocLinks.forEach(link => link.classList.toggle('active', decodeURIComponent(link.hash.slice(1)) === active)); diff --git a/docs/site/build.py b/docs/site/build.py index cae77adc7..a298fbd88 100644 --- a/docs/site/build.py +++ b/docs/site/build.py @@ -13,6 +13,7 @@ from xml.sax.saxutils import escape as xml_escape import mistune +import palettes from pygments import highlight from pygments.formatters import HtmlFormatter from pygments.lexers import TextLexer, get_lexer_by_name @@ -21,6 +22,7 @@ HERE = Path(__file__).resolve().parent REPO = HERE.parent.parent UPSTREAM = "https://github.com/Kuddev/pebrel" +SITE_VERSION = json.loads((Path(__file__).resolve().parent / "site.json").read_text(encoding="utf-8"))["version"] def plain(text: str) -> str: @@ -103,7 +105,6 @@ def navigation(groups: list[dict], active: str, root: str) -> str: def home_header() -> str: release = f"{UPSTREAM}/releases/latest" return f'''
    -

    从一个终端开始。
    把工作连成一体。

    ''' @@ -114,7 +115,7 @@ def source_details(page: dict, commit: str) -> str: sources = page.get("sources", []) links = "".join(f'
  • {html.escape(path)}
  • ' for path in sources) return (f'
    版本与参考 · {commit[:7]}' - f'

    适用版本:Pebrel {html.escape(page.get("version", "1.9.1"))}。以下链接提供相关设置与功能的参考。

      {links}
    ') + f'

    适用版本:Pebrel {html.escape(page.get("version", SITE_VERSION))}。以下链接提供相关设置与功能的参考。

      {links}
    ') def build(destination: Path, base_url: str) -> dict: @@ -157,9 +158,10 @@ def build(destination: Path, base_url: str) -> dict: shutil.copy2(HERE / "screenshots.json", screenshot_dir / "sources.json") for filename in config["images"]: shutil.copy2(REPO / "docs/screenshots" / filename, screenshot_dir / filename) - light_css = HtmlFormatter(style="default", nobackground=True).get_style_defs("[data-theme=light] .code-block") - dark_css = HtmlFormatter(style="github-dark", nobackground=True).get_style_defs("[data-theme=dark] .code-block") - (assets / "highlight.css").write_text(light_css + "\n" + dark_css, encoding="utf-8") + themes = palettes.load() + (assets / "palettes.css").write_text(palettes.stylesheet(themes), encoding="utf-8") + (assets / "highlight.css").write_text(palettes.code_stylesheet(), encoding="utf-8") + palette_menu, dark_palettes = palettes.menu(themes), palettes.dark_ids(themes) search = [] total_characters = 0 all_markdown = [] @@ -176,12 +178,11 @@ def build(destination: Path, base_url: str) -> dict: header = home_header() breadcrumb_tools = "" else: - reading_minutes = max(1, len(plain(content)) // 450) header = ( f'

    {html.escape(page["title"])}

    ' f'

    {html.escape(page["description"])}

    ') breadcrumb_tools = ( - f'
    约 {reading_minutes} 分钟阅读' + f'
    ' f'' f'Markdown ↓
    ') header += '' @@ -200,6 +201,7 @@ def build(destination: Path, base_url: str) -> dict: root=root, slug=slug, version=html.escape(page.get("version", config["version"])), group=html.escape(page["group"]), navigation=navigation(config["groups"], slug, root), main_class="home" if slug == "index" else "document", breadcrumb_tools=breadcrumb_tools, page_header=header, content=content, source_details=source_details(page, config["source_commit"]), + palette_menu=palette_menu, dark_palettes=dark_palettes, pagination="".join(pagination), toc=toc, edit_url=f'{UPSTREAM}/edit/main/docs/site/content/{slug}.md') target = destination / page_url(slug) target.parent.mkdir(parents=True, exist_ok=True) diff --git a/docs/site/check_browser.py b/docs/site/check_browser.py index 4abca726c..7f7bc5039 100644 --- a/docs/site/check_browser.py +++ b/docs/site/check_browser.py @@ -53,9 +53,12 @@ def check(site: Path, output: Path): expect(page.locator('.copy-code').first).to_have_attribute('data-copied', 'true') assert 'echo Hello, Pebrel' in page.evaluate('navigator.clipboard.readText()') page.locator('#theme-toggle').click() + page.locator('[data-palette-option="CatppuccinMocha"]').click() expect(page.locator('html')).to_have_attribute('data-theme', 'dark') + expect(page.locator('html')).to_have_attribute('data-palette', 'CatppuccinMocha') page.reload() expect(page.locator('html')).to_have_attribute('data-theme', 'dark') + expect(page.locator('html')).to_have_attribute('data-palette', 'CatppuccinMocha') dark_background = page.locator('.code-block').first.evaluate('el => getComputedStyle(el).backgroundColor') assert all(int(channel) < 128 for channel in __import__('re').findall(r'\d+', dark_background)[:3]) page.screenshot(path=str(output / 'docs-dark.png'), full_page=True) @@ -66,6 +69,7 @@ def check(site: Path, output: Path): page.set_viewport_size({'width': 390, 'height': 844}) page.goto(base) page.locator('#theme-toggle').click() + page.locator('[data-palette-option="Nord"]').click() page.wait_for_timeout(650) assert not page.evaluate('document.documentElement.scrollWidth > innerWidth') page.screenshot(path=str(output / 'docs-mobile.png'), full_page=True) diff --git a/docs/site/content/agents.md b/docs/site/content/agents.md new file mode 100644 index 000000000..eaf7679c3 --- /dev/null +++ b/docs/site/content/agents.md @@ -0,0 +1,116 @@ +> [!NOTE] +> 本页按 Pebrel 2.1.1 核对。支持范围会随版本变化;如果你安装的版本较旧,设置 → Agents 里列出的工具可能比这里少,请以自己版本的界面为准。 + +## Pebrel 如何对待 AI 命令行工具 + +Claude Code、Codex 这类工具本质上是运行在终端里的程序,所以任何 CLI 或 TUI 都能在 Pebrel 里正常使用,不需要先"被支持"。Pebrel 做的是在此之上多走一步:认出你正在运行的是哪一个工具,再给它配上图标、任务状态、通知和对话接续。 + +这些能力分三层,工具支持到哪一层,你能得到的体验就到哪一层: + +| 层级 | 你会得到什么 | 需要你做什么 | +| --- | --- | --- | +| **识别** | Pebrel 认出工具名称,可显示专属图标 | 不需要,直接运行即可 | +| **屏幕识别** | 在识别的基础上,Pebrel 根据终端画面判断工具是在工作,还是在等你确认 | 不需要 | +| **Agent 集成** | 工具自己把"开始、完成、需要你处理"等事件告诉 Pebrel,状态和通知最准确;还能记住会话,用于恢复与分叉 | Claude Code 和 Codex 默认已开启;其他工具在 **设置 → Agents** 里打开一次 | + +Agent 集成最准确,但并不是所有工具都提供可用的事件接口。没有集成的工具,依然可以靠屏幕识别获得不错的状态提示,只是在工具改了界面措辞之后,判断可能暂时不准。 + +## 支持 Agent 集成的工具 + +**设置 → Agents** 页面里列出的就是下面这 9 个工具,在 Windows、macOS 和 Linux 上都可以使用。Claude Code 和 Codex 默认开启,其余的需要自己打开开关;开启后要退出并重新启动对应的工具才会生效,步骤见[配置 Agent 集成](hooks.md)。 + +服务器上的工具也可以使用:通过 Pebrel 的 SSH 连接时,会自动为服务器上的 Claude Code、Codex、OpenCode 和 Pi 配置集成。WSL 里则支持 Claude Code 和 Codex。 + +| 工具 | 启动命令 | 专属图标 | 恢复对话 | 分叉对话 | +| --- | --- | :---: | :---: | :---: | +| Claude Code | `claude` | ✓ | ✓ | ✓ | +| Codex | `codex` | ✓ | ✓ | ✓ | +| OpenCode | `opencode` | ✓ | ✓ | ✓ | +| Cursor Agent | `agent`、`cursor-agent` | — | ✓ | — | +| Kimi Code | `kimi` | ✓ | ✓ | ✓ | +| Pi | `pi` | ✓ | ✓ | ✓ | +| Oh My Pi | `omp` | ✓ | ✓ | ✓ | +| GitHub Copilot | `copilot` | — | ✓ | — | +| Grok | `grok` | ✓ | ✓ | ✓ | + +几点说明: + +- Cursor Agent 的命令是 `agent`,不是 Cursor 桌面编辑器的 `cursor`。只安装了桌面编辑器时,设置里不会把 Cursor Agent 显示为已安装。 +- 没有专属图标的工具会用字体图标代替:Gemini、Cursor Agent 和 GitHub Copilot 各有自己的图案,其余工具显示通用图标。这不影响状态提示。 +- "恢复"指重新打开 Pebrel 后接回原来的对话,或在 [AI 会话历史](ai-history.md) 里重新打开某次对话。"分叉"指从已有对话的上下文开出一个新对话,原对话保持不变。两者都要求 Pebrel 已经知道这次对话的会话标识,而这正是 Agent 集成带来的。 + +## 通过屏幕识别获得状态提示的工具 + +下面这些工具目前没有 Agent 集成入口,但 Pebrel 能认出它们,并根据画面判断工作中或等待确认。 + +| 工具 | 启动命令 | 专属图标 | +| --- | --- | :---: | +| Gemini CLI | `gemini` | — | +| Amp | `amp` | — | +| Antigravity | `agy`、`antigravity` | ✓ | +| Cline | `cline` | — | +| Devin | `devin` | — | +| Droid | `droid` | — | +| Hermes | `hermes` | — | +| Kiro | `kiro`、`kiro-cli` | — | +| Kilo Code | `kilo` | — | +| Qoder | `qodercli` | — | +| Maki | `maki` | — | +| CodeBuddy Code | `codebuddy`、`cbc` | ✓ | + +这一档的工具不在 Pebrel 里恢复或分叉对话。需要接续时,使用工具自己的恢复命令即可,例如 `gemini --resume`。 + +## 目前只做识别的工具 + +下面这些工具能被认出,但暂时没有屏幕识别规则,也没有集成。任务状态提示比较有限,需要你自己回到窗格查看。 + +| 工具 | 启动命令 | 专属图标 | +| --- | --- | :---: | +| Aider | `aider` | — | +| Goose | `goose` | — | +| Auggie | `auggie` | — | +| Vibe | `vibe` | — | +| Qwen Code | `qwen` | — | +| Trae CLI | `trae-cli` | ✓ | + +## 通过 `npx` 等启动器运行也能识别 + +Pebrel 不只看命令的第一个词。通过 `node`、`npx`、`bunx`、`uvx`、`pipx` 等启动器运行的工具,以及在 WSL 里运行的工具,同样会被认出。 + +如果工具没有被认出,先在同一个终端里确认命令能直接运行,再看[配置 Agent 集成](hooks.md)中的排查步骤。 + +## 名单之外的工具 + +不在上面名单里的 CLI 或 TUI,仍然可以在 Pebrel 里正常运行,只是没有专属图标、任务状态和对话接续,终端本身的所有功能不受影响。 + +## 接下来的方向 + +下面是目前的开发方向,不是发布时间的承诺,具体以各版本的发布说明为准: + +- **补齐集成。** 优先为使用广泛、并且官方提供稳定事件接口的工具增加 Agent 集成,让它们从"屏幕识别"升级到最准确的一档。 +- **扩大恢复和分叉的范围。** 只在工具的官方命令经过核对之后才会加入。Pebrel 不会按名字猜测命令,以免把内容输入到错误的位置。 +- **识别更多工具。** 新工具会根据使用情况和启动方式是否稳定来评估。 + +希望支持某个工具,可以在项目的 Issue 里说明工具名称、启动命令和官方文档链接,流程见[参与贡献](contributing.md)。 + +## 常见问题 + +### 状态没有更新,或图标没有出现 + +先确认命令在同一个终端里能直接运行,再刷新 **设置 → Agents**。已经启用集成的工具,重启一次工具后再试。工具刚升级过时,重新启动 Pebrel 和工具可以清掉旧的识别状态。 + +### 在标签上怎么看状态 + +工作中的标签会显示转动的进度标记。工具停下来等你输入或授权时,标签会改为相应的提示。任务完成时,标签先短暂显示对勾,再变成一个小圆点,提醒你回去查看;正在查看的标签不会显示这个小圆点。详见[使用 AI 命令行工具](ai-start.md)。 + +### 通知来自哪个窗格 + +通知会指向发出事件的窗格。多个工具同时运行时,请按窗格上的图标和名称区分,通知方式见[通知](notifications.md)。 + +### 设置里没有我的工具 + +**设置 → Agents** 只列出有 Agent 集成的 9 个工具。其他工具没有开关,但仍会被识别,并显示图标和状态提示。 + +### 恢复或分叉没有出现 + +先看工具是否在上面"支持 Agent 集成"的表里且有 ✓,再检查集成是否已启用并重启过工具。SSH 标签和自定义 Profile 里不会显示分叉入口,详情见[恢复与分叉 AI 对话](ai-history.md)。 diff --git a/docs/site/content/ai-history.md b/docs/site/content/ai-history.md index b4011ad37..1fbd8ccc9 100644 --- a/docs/site/content/ai-history.md +++ b/docs/site/content/ai-history.md @@ -1,10 +1,10 @@ ## 找到之前的对话 -按 **Ctrl+Shift+O**(macOS 为 **⌘⇧O**)打开快速跳转,输入会话标题、项目目录或相关关键字。在历史结果中核对工具类型和目录,再选择要继续的会话。 +按 **Ctrl+Shift+O**(macOS 为 **⌘⇧O**)打开快速跳转,输入会话标题、项目目录或相关关键字。列表按工具分组,同一次对话可能列出两种操作:**恢复**会接回原对话,**分叉**(仅部分工具提供)会从原对话的上下文开出新对话。每一行会显示工具名称、位置和时间,先核对工具类型和目录,再选择。 Pebrel 会尝试使用工具的会话记录打开对话。CLI 出现后,确认上下文确实属于原任务,再输入新的问题。 -当前已有受支持的 Claude Code 与 Codex 恢复流程。其他 CLI 的历史可以通过工具自己的恢复入口打开。 +历史列表会读取 Claude Code 和 Codex 自己保存的会话记录;其他已启用 Agent 集成的工具,会在它们上报会话之后出现在列表里。没有集成的工具,请通过工具自己的恢复入口打开。各工具是否支持恢复与分叉,见[支持的 AI 命令行工具](agents.md)。 ## 每次启动时自动接续 @@ -15,15 +15,19 @@ Pebrel 会尝试使用工具的会话记录打开对话。CLI 出现后,确认 正常退出后重开 Pebrel,检查对应终端是否恢复了原对话。需要原会话记录、有效的身份信息,以及可用的 CLI 安装。 +关闭 Pebrel 时,如果还有 AI 对话没有取得身份信息,会弹出"仍有 AI 会话未能识别,继续关闭?"。选择 **保存已知状态并关闭** 会保存布局和已知的对话;没取得身份的对话,下次打开时可能需要手动选择。刚启动的工具需要一点时间取得身份,等它们启动完成后再关闭,可以避免这个提示。 + +能否自动接回,取决于工具是否在[支持列表](agents.md)里有"恢复对话"的 ✓。 + ## 恢复失败或需要选择会话 -右键相关终端标签,使用当前可用的 **重试会话恢复**或 **选择要继续的对话…**。 +原对话没能接上时,Pebrel 会保留原来的恢复记录,不会丢掉。右键相关终端标签,使用当前可用的 **重试会话恢复** 或 **选择要继续的对话…**。 先检查项目目录是否仍存在、CLI 是否需要重新登录,以及原工具的历史记录是否还在。记录不足时,可以打开工具自己的历史选择器查找;Pebrel 列表没有显示某条记录,并不意味着工具已经删除它。 ## 从已有上下文分出新对话 -在受支持的本地 Claude Code 或 Codex 会话中,右键标签选择 **分叉 AI 会话**。新会话从已有上下文开始,原对话继续保留。 +在受支持的本地会话中,右键标签选择 **分叉 AI 会话**;也可以在历史列表里,对某次旧对话选择 **分叉**。目前 Claude Code、Codex、OpenCode、Kimi Code、Pi、Oh My Pi 和 Grok 可以分叉。新会话从已有上下文开始,原对话继续保留。 这个入口要求 Pebrel 已识别工具和会话身份;SSH、自定义 Profile 或身份信息不完整时可能不显示。需要分叉时,先在受支持的本地 Shell 中建立会话。 diff --git a/docs/site/content/ai-start.md b/docs/site/content/ai-start.md index ed857f793..93194f7b8 100644 --- a/docs/site/content/ai-start.md +++ b/docs/site/content/ai-start.md @@ -1,6 +1,6 @@ ## 在项目目录启动工具 -先按所用 CLI 的官方说明安装并登录。Claude Code、Codex 等工具分别管理自己的账户与网络连接,Pebrel 提供运行它们的终端。 +先按所用 CLI 的官方说明安装并登录。Claude Code、Codex 等工具分别管理自己的账户与网络连接,Pebrel 提供运行它们的终端。Pebrel 目前能识别的工具见[支持的 AI 命令行工具](agents.md)。 1. 打开本地、WSL 或 SSH 终端。 2. 用 `cd`进入准备处理的项目。 @@ -14,9 +14,9 @@ ## 查看活动状态 -Pebrel 会给识别到的 AI CLI 显示工具图标和活动状态。运行任务时可以切到其他标签,通过状态提示判断何时需要回来查看。 +Pebrel 会给识别到的 AI CLI 显示工具图标和活动状态:标签和窗格标题上有工具图标,工作中的标签会转动,任务完成后先显示对勾,再变成小圆点。运行任务时可以切到其他标签,通过状态提示判断何时需要回来查看。 -Windows 上可以在 **设置 → Agents**启用支持的集成,以获得更准确的任务事件。配置方式见[Agent 集成](hooks.md)。 +在 **设置 → Agents** 启用支持的集成,可以获得更准确的任务事件。哪些工具能被识别、各自有哪些功能,见[支持的 AI 命令行工具](agents.md);配置方式见[Agent 集成](hooks.md)。 出现需要权限、回答或确认的提示时,回到来源窗格阅读具体请求。任务回到空闲后,仍应查看工具输出和实际改动,确认结果符合需求。 diff --git a/docs/site/content/appearance.md b/docs/site/content/appearance.md index c027bc5d6..8cb4cc5a0 100644 --- a/docs/site/content/appearance.md +++ b/docs/site/content/appearance.md @@ -2,13 +2,13 @@ 打开 **设置 → 外观**,点击 **更换主题**。浏览或搜索主题,选择喜欢的配色,回到终端查看实际效果。 -希望随系统切换深浅色时,开启 **跟随系统**。希望始终使用固定配色时,关闭它,再选择主题。 +希望随系统切换深浅色时,开启 **跟随系统**,深色使用 Nord,浅色使用 Nord Light。希望始终使用固定配色时,关闭它,再选择主题。主题列表里的 Warm Sand、Slate Light 分别是原来的 Paper 与 Glass Light,旧配置中的名称仍然有效。
    Pebrel 的主题配色示例
    选择主题后,可继续调整终端字体、光标和背景。
    ## 调整界面大小 -在 **外观 → 界面**中,**界面字号**用于设置侧栏、按钮和菜单的文字大小,**界面外观**用于选择“标准”或“紧凑”的留白。 +在 **外观 → 界面**中,**界面字号**用于设置侧栏、按钮和菜单的文字大小,**界面外观**用于选择“标准”或“紧凑”的留白,切换后标题栏、侧栏和顶部标签的间距立即改变。侧栏的分隔线默认就可以拖动调整宽度。 终端输出太小时,调整 **终端字号**。希望一屏显示更多内容但仍容易阅读,可以先调整终端字号和字体间距,再决定是否缩小整个界面。 @@ -22,7 +22,7 @@ 在外观的界面选项中开启非活动窗格调暗,让当前输入位置更明显。使用多个本地和 SSH 窗格时,可以结合[标签颜色与重命名](workspace.md)区分环境。 -在 **光标**分组中选择条形、下划线、实心框或空心框。关闭 **光标闪烁**后,光标保持常亮。 +在 **光标**分组中选择条形、下划线、实心框或空心框。关闭 **光标闪烁**后,光标保持常亮。**平滑光标**可选 **关闭** 或 **平滑(90 ms)**,开启后输入和移动时光标会平滑滑动,大范围跳转仍立即到位,设置立即应用到已打开的终端。 ## 标签关闭按钮与界面语言 diff --git a/docs/site/content/backups.md b/docs/site/content/backups.md index de4904cce..2aa4441f7 100644 --- a/docs/site/content/backups.md +++ b/docs/site/content/backups.md @@ -1,5 +1,5 @@ > [!NOTE] -> 本页按 2026-09-30 的 `main`(`5ff2f3e`)核对,不代表这些入口已经包含在 1.9.1 安装包中。没有 **设置 → 备份** 时,可使用[备份与迁移](migration.md)中的手动方式。 +> 本页按 Pebrel 2.1.1 核对,**设置 → 备份** 从 2.0 起提供。没有这个入口时,先[更新](updates.md)到 2.0 之后的版本,或使用[备份与迁移](migration.md)中的手动方式。 ## 先做一份本地加密备份 @@ -53,7 +53,7 @@ SSH 私钥、系统凭据、Shell 和 CLI 安装不会由布局备份恢复, - **SFTP**:选择已经保存的 SSH 主机和已有远程目录,沿用该主机的认证配置 - **本地 / 网络目录**:使用已经挂载的目录;选择同步盘时,文件的后续云同步由该同步客户端处理 -在这个源码版本中,WebDAV / S3 的凭据管理器保存仅在 Windows 实现。macOS / Linux 需要在启动 Pebrel 的环境中提供 `PEBREL_BACKUP_WEBDAV_PASSWORD` 或 `PEBREL_BACKUP_S3_SECRET`,并将界面的存储密码输入留空。不要把实际秘密写进公开脚本或截图;不方便配置启动环境时,先使用本地文件夹或离线导出。 +WebDAV / S3 的凭据管理器保存目前仅在 Windows 实现。macOS / Linux 需要在启动 Pebrel 的环境中提供 `PEBREL_BACKUP_WEBDAV_PASSWORD` 或 `PEBREL_BACKUP_S3_SECRET`,并将界面的存储密码输入留空。不要把实际秘密写进公开脚本或截图;不方便配置启动环境时,先使用本地文件夹或离线导出。 存储位置按最近 10 份快照保留,成功上传后会尝试清理更旧的快照;清理失败会显示提示,不等于这次上传失败。需要长期保存的一份应另外导出保管。更改存储位置后,页面只列出新位置中的备份,旧位置的备份不会随切换而删除。 diff --git a/docs/site/content/clipboard.md b/docs/site/content/clipboard.md index 863c55aed..6acff324a 100644 --- a/docs/site/content/clipboard.md +++ b/docs/site/content/clipboard.md @@ -17,7 +17,7 @@ Windows / Linux 中,Ctrl+C 在存在选区时也会复制文字;没有选区 ## 选中即复制和右键粘贴 -打开 **设置 → 交互 → 鼠标与选区**,开启 **选中即复制**。之后鼠标选择结束时会复制选区,右键可以粘贴。需要使用常规右键菜单时,将这项设置关闭。 +打开 **设置 → 交互 → 鼠标与选区**,开启 **选中即复制**。之后鼠标选择结束时会复制选区,右键可以粘贴。需要使用常规右键菜单时,将这项设置关闭,右键会打开菜单,里面有复制、粘贴、复制工作目录、左右分屏、上下分屏和关闭此分栏;选中了文字并且有可用的 AI 窗格时,还会出现发送到聊天。无论这项设置是否开启,按住 **Ctrl** 再右键都可以打开这个菜单,同时不影响程序自己接收鼠标事件。 这个选项适合频繁从日志中复制文字;如果经常需要右键选择其他动作,保留默认交互会更方便。 diff --git a/docs/site/content/completions.md b/docs/site/content/completions.md index 58b8e05b3..031a1fc17 100644 --- a/docs/site/content/completions.md +++ b/docs/site/content/completions.md @@ -1,5 +1,5 @@ > [!NOTE] -> 本页按 2026-09-30 的 `main`(`5ff2f3e`)核对。旧版 1.9.1 的补全样式和接受键与这里不同;如果界面没有三个模式,先在设置中核对版本,不要照着新界面寻找旧版没有的选项。 +> 本页按 Pebrel 2.1.1 核对,智能补全从 2.1.0 起提供。1.9.x 的补全样式和接受键与这里不同;如果界面没有三个模式,先在设置中核对版本,不要照着新界面寻找旧版没有的选项。 ## 打开命令补全 diff --git a/docs/site/content/contributing.md b/docs/site/content/contributing.md index 29d267720..812f623b1 100644 --- a/docs/site/content/contributing.md +++ b/docs/site/content/contributing.md @@ -24,6 +24,10 @@ cargo build --locked -p nebula --bin pebrel --features gpui-shell 如果只是修文档,应优先运行文档自己的构建与测试,不需要为了文字改动制造无关的产品代码变化。 +## 不要用于推广 + +PR、Issue 及其评论不能用于广告、商业推广或引流,包括以功能贡献为名加入服务商推广、返利链接或注册优惠。确认属于未经授权的推广后,对应提交会被直接关闭。商业合作和赞助请发邮件到 [fickleheartedkeys@163.com](mailto:fickleheartedkeys@163.com),不要在 PR 或 Issue 里洽谈。完整规则见[贡献指南](https://github.com/Kuddev/pebrel/blob/main/CONTRIBUTING.md#commercial-promotion-policy)。 + ## 保持改动容易审查 - 一个 PR 只承担一个概念上的改动;不要顺便重构无关文件。 diff --git a/docs/site/content/documents.md b/docs/site/content/documents.md index acd69fa26..74bd8544b 100644 --- a/docs/site/content/documents.md +++ b/docs/site/content/documents.md @@ -28,7 +28,7 @@ 在公式相关菜单中选择 **复制 LaTeX 源码**,可将表达式交给其他数学工具。公式已完整渲染且菜单提供图片复制时,可以选择 **复制公式图片**。 -无法复制为图片时,先使用 LaTeX 源码,或简化不受支持的语法。关于文档中的公式写法,见[Markdown 编辑](markdown-editing.md)。 +无法复制为图片时,先使用 LaTeX 源码,或简化不受支持的语法。用鼠标拖选跨过公式的文字时,版面不会跳动,被选中的公式会显示轮廓,复制得到的是它们的 LaTeX 源码。关于文档中的公式写法,见[Markdown 编辑](markdown-editing.md)。 ## 查看文件信息 diff --git a/docs/site/content/fonts.md b/docs/site/content/fonts.md index d3e63fe72..d2df367de 100644 --- a/docs/site/content/fonts.md +++ b/docs/site/content/fonts.md @@ -1,22 +1,24 @@ ## 放大终端文字 -打开 **设置 → 外观 → 终端外观**,调整 **终端字号(Ctrl+滚轮缩放)**。可以使用加减按钮,也可以在终端按 Ctrl+滚轮缩放。 +打开 **设置 → 外观 → 终端外观**,调整 **终端字号(Ctrl+滚轮缩放)**。可以使用加减按钮,也可以直接点击数值输入新的字号,按 **Enter** 或移开焦点生效,按 **Esc** 取消;还可以在终端按 Ctrl+滚轮缩放。 键盘缩放使用 **Ctrl++ / Ctrl+-**,macOS 使用 **⌘+ / ⌘-**;**Ctrl+0 / ⌘0**重置缩放。 -按钮或侧栏文字太小时,调整同页 **界面**分组中的 **界面字号**,它不会改变终端输出大小。 +不希望滚动时误改字号,可以关闭同页的 **Ctrl+滚轮调整字号**。关闭后这个手势被完全忽略,既不改变字号,也不滚动终端;键盘快捷键不受影响。 + +按钮或侧栏文字太小时,调整同页 **界面**分组中的 **界面字号**,它同样可以直接输入数值,不会改变终端输出大小。 ## 选择英文终端字体 -在 **英文终端字体**中打开字体列表,查找已安装的字体。字体组按顺序查找字形:第一项优先,缺少字符时使用后面的字体。 +在 **英文终端字体**一行点击右侧的展开按钮,打开字体列表。列表里可以搜索已安装的字体,点击可用字体旁的 **加入字体组** 把它加入;**当前顺序**里的字体可以上移、下移或移出。字体组按顺序查找字形:标为“主”的第一项优先,缺少字符时使用后面的字体,内置的 Maple Mono 是最后的兜底。 -选择后查看数字、标点、代码缩进和表格边框。终端使用等宽网格,等宽字体更适合保持这些内容对齐。 +选择后查看数字、标点、代码缩进和表格边框。终端使用等宽网格,等宽字体更适合保持这些内容对齐;列表里标有“比例”的是比例字体,不适合终端。 刚安装的字体没有出现时,重新打开字体列表;仍找不到则重启 Pebrel。使用系统显示的字体族名称,而不是字体文件名。 ## 单独设置中文字体 -在 **中文终端字体**输入字体名称。多个候选用逗号分隔,按 **Enter**或离开输入框后生效。留空时使用内置的 Maple Mono NF CN 回退。 +**中文终端字体**与英文字体各自独立保存,同样可以展开带搜索的字体列表,设置自己的字体和回退顺序;也可以直接在输入框写字体名称,多个候选用逗号分隔,按 **Enter**或离开输入框后生效。留空时使用内置的 Maple Mono NF CN 回退。 修改后同时检查中文、英文和全角标点。只有中文缺字时,优先检查中文字体和回退列表,不必更换整个界面主题。 diff --git a/docs/site/content/hooks.md b/docs/site/content/hooks.md index bf997a178..9576c266c 100644 --- a/docs/site/content/hooks.md +++ b/docs/site/content/hooks.md @@ -1,40 +1,94 @@ -## 启用常用工具的集成 +> [!NOTE] +> 本页按 Pebrel 2.1.1 核对。设置页里的"Hook"是各工具对"事件入口"的称呼,本页统一叫"集成"。 -**自动本地 Hook 设置目前在 Windows 提供。** Hook 是工具在开始、结束或需要关注时发出的事件,Pebrel 用它更新对应窗格的活动提示。 +## 先了解默认行为 -1. 安装需要使用的 CLI,并启动一次完成初始配置。 -2. 打开 **设置 → Agents**。 -3. 刷新检测结果,找到正在使用的工具。 -4. 启用对应集成;出现需要修复或缺少配置的提示时,按该项提示处理。 -5. 退出并重新启动这个 CLI。 -6. 提交一个短任务,检查状态和来源窗格是否对应。 +集成让工具在开始、结束或需要你处理时主动告诉 Pebrel,Pebrel 据此更新标签和窗格上的活动提示,并发出通知。它在 Windows、macOS 和 Linux 上都可以使用。 -只需开启自己使用的工具,不必把所有检测项都配置一遍。 +- **Claude Code 和 Codex 默认开启。** 只要它们安装在这台电脑上,Pebrel 会自行在它们的配置里写入集成入口,通常不需要你操作。 +- **其他工具默认关闭。** 需要在 **设置 → Agents** 里自己打开,包括 OpenCode、Cursor Agent、Kimi Code、Pi、Oh My Pi、GitHub Copilot 和 Grok。 +- **集成只在 Pebrel 里起作用。** 在 Pebrel 之外的终端运行同一个工具,不会发生任何变化。 -## 支持的设置入口 +各工具具体支持哪些功能,见[支持的 AI 命令行工具](agents.md)。 -Agent 设置提供 Claude、Codex、OpenCode、Cursor、Kimi、Pi、OhMyPi、Copilot 与 Grok 等入口。不同工具能提供的事件和历史能力不同;Claude Code 与 Codex 的恢复流程见[AI 会话历史](ai-history.md)。 +## 在设置里查看和开关 -
    Pebrel 侧栏显示 AI 终端的图标和状态
    从侧栏查看各终端的活动状态。
    +打开 **设置 → Agents**,页面标题是"编程智能体"。每个工具占一行,从左到右依次是: -## 工具没有被检测到 +- 工具图标和名称; +- Pebrel 找到的程序路径,鼠标停在路径上可以看到完整内容;找不到时显示"未安装"; +- 当前状态; +- 一个开关。 -先在准备使用它的终端中运行工具命令。若命令也找不到,修复安装和 PATH;若命令可用,再刷新 Agent 设置。 +1. 先在终端里启动一次要用的工具,让它完成初始配置。工具还没有创建过配置时,这一行会提示"请先运行一次此工具以创建配置,然后刷新"。 +2. 点击右上角的 **刷新**,重新检测。 +3. 打开这个工具的开关。点击整行也可以切换。 +4. 看到"Hooks 已安装,请重启 agent 使其生效"后,退出并重新启动这个工具。 +5. 提交一个简短任务,检查标签上的状态是否随任务变化。 -检查安装的是目标 CLI。例如,Cursor 桌面程序的启动命令不一定就是 Cursor Agent CLI。工具刚升级过时,重新启动 Pebrel 和 CLI 可以清除旧的检测与运行状态。 +只需要打开自己用的工具。开关灰着无法点击,通常是因为 Pebrel 还没有找到这个工具,或它还没有创建过配置。 -## 收不到任务通知 +### 状态的含义 + +| 状态 | 含义 | 怎么处理 | +| --- | --- | --- | +| Hook 已安装 | 集成已经就绪 | 重启工具后即可使用 | +| Hook 未安装 | 工具已找到,集成处于关闭状态 | 需要时打开开关 | +| Hook 已安装 · 需修复 | 入口还在,但内容与当前版本不一致,例如工具更新时改写过配置 | 关闭再打开一次 | +| 需要检查 | 读取或写入这个工具的配置时出错,原因会显示在这一行 | 看提示,检查配置文件的权限,再刷新 | +| 处理中… | 正在写入或移除 | 稍候 | + +如果提示"缺少 hook 辅助程序,请修复 Pebrel 安装后再启用",说明 Pebrel 自带的辅助程序没有找到,重新安装 Pebrel 即可。 + +## 开启后会改动什么 -先确认 CLI 已在启用集成后重启,再检查 **设置 → 终端 → 提醒**中的通知选项。任务状态能够更新但卡片没有显示时,通常应继续检查通知显示设置,而不是重新安装 CLI。 +Pebrel 只写入属于自己的条目,不会改动你已有的其他配置: -通知时间、点击跳回来源和系统通知见[通知](notifications.md)。 +| 工具 | 修改位置(均在用户目录下) | +| --- | --- | +| Claude Code | `.claude/settings.json`,设置了 `CLAUDE_CONFIG_DIR` 时用该目录 | +| Codex | `.codex/` 下的 `config.toml` 和 `hooks.json` | +| OpenCode | `.config/opencode/plugins/pebrel.js` | +| Pi | `.pi/agent/extensions/pebrel.ts` | +| Oh My Pi | `.omp/agent/extensions/pebrel.ts` | +| Kimi Code | `.kimi-code/config.toml` | +| Cursor Agent | `.cursor/hooks.json` | +| GitHub Copilot | `.copilot/hooks/pebrel.json` | +| Grok | `.grok/hooks/pebrel.json` | + +这些文件属于对应工具自己的配置。开关处于打开状态时,如果工具升级或别的程序改动了它们,Pebrel 会检测到并把自己的条目补回;你主动关闭的工具不会被补回。 + +对于 Claude Code 和 Codex,Pebrel 还会放入一个名为 `pebrel-runtime` 的技能,让它们在对话里直接操作 Pebrel,例如分屏、打开文件或把任务交给另一个窗格里的工具,用法见[命令行控制与自动化](runtime.md)。你修改过的技能文件不会被覆盖。 ## 关闭集成 -在 **设置 → Agents**关闭该工具的集成,再重启工具。关闭后仍可在终端正常运行 CLI;活动提示会取决于剩余可用的检测信息。 +在 **设置 → Agents** 关闭该工具的开关,再重启工具。出现"Hooks 已移除,请重启 agent 使其生效",表示已经移除。关闭后仍可在终端里正常运行这个工具,活动提示会退回到[屏幕识别](agents.md)。 + +想一次移除所有工具的集成,在终端运行: + +```sh +pebrel setup-ai --remove +``` + +它只移除 Pebrel 写入的条目,保留其他集成。不带 `--remove` 再运行一次,会重新为 Claude Code、Codex 以及你在设置里打开过的工具写入集成。 -## macOS、Linux、WSL 与 SSH +## WSL 与 SSH + +**设置 → Agents** 只管理这台电脑上的工具。WSL 和服务器上的工具有各自的配置,由下面的方式处理。 + +- **通过 Pebrel 的 SSH 连接:** 连接时会自动检查服务器,为其中已安装的 Claude Code、Codex、OpenCode 和 Pi 配置集成。这一步失败不会影响你正常使用终端。需要手动处理时运行 `pebrel setup-ai --ssh 主机别名或user@host`;加上 `--remove` 会移除,并记住这台主机不再自动配置。 +- **WSL:** 在 Windows 上打开 WSL 终端时,会为发行版里的 Claude Code 和 Codex 配置集成。手动运行 `pebrel setup-ai --wsl 发行版名称`,需要指定用户时再加 `--wsl-user 用户名`。Codex 可能会要求你在它的 `/hooks` 里确认这些入口。 + +SSH 和 WSL 里的其他工具仍可使用,只是没有集成,状态提示依赖屏幕识别。 + +## 工具没有被检测到 + +先在准备使用它的终端里运行工具命令。命令找不到时,修复安装和 PATH;命令可用,再点 **刷新**。 + +确认安装的是目标 CLI。例如,Cursor 桌面程序的 `cursor` 命令不等于 Cursor Agent CLI,后者的命令是 `agent`。工具刚升级过时,重新启动 Pebrel 和工具可以清除旧的检测与运行状态。 + +## 收不到任务通知 -macOS 和 Linux 可以正常运行已安装的 AI CLI,但不提供 Windows 的同一套本地自动 Hook 设置入口。 +先确认工具已在启用集成后重启,再检查 **设置 → 终端 → 提醒** 里的通知选项。任务状态能更新但卡片没有出现时,通常应继续检查通知显示设置,而不是重新安装工具。 -WSL 和 SSH 中的工具有各自的安装目录和配置。Windows 本地检测通过时,还需在实际运行工具的环境中确认它是否可用;不要在另一台主机的设置目录里寻找本机配置。 +通知时长、点击跳回来源窗格和系统通知见[通知](notifications.md)。 diff --git a/docs/site/content/index.md b/docs/site/content/index.md index bd8920a8c..a648c95f0 100644 --- a/docs/site/content/index.md +++ b/docs/site/content/index.md @@ -1,10 +1,10 @@ ## 开始使用 ## 常用操作 @@ -20,6 +20,7 @@ | 查看改动、提交代码和处理冲突 | [Git 提交](vcs.md) · [解决冲突](git-conflicts.md) · [SVN](svn.md) | | 将文件传到服务器 | [SFTP 文件传输](sftp.md) | | 从 Android 查看电脑终端或发送输入 | [Android 连接电脑](mobile.md) | +| 查看 Pebrel 支持哪些 AI 命令行工具 | [支持的 AI 命令行工具](agents.md) | | 重新打开上次的 AI 对话 | [AI 会话历史](ai-history.md) | | 更改快捷键或通知时间 | [快捷键](keyboard.md) · [通知](notifications.md) | | 备份设置,或迁移到另一台电脑 | [加密备份](backups.md) · [备份与迁移](migration.md) | @@ -27,4 +28,4 @@
    Pebrel 的顶部标签栏与终端工作区
    终端工作区。截图中的主题和窗口装饰可能因平台而不同。
    -本指南的基础页面适用于 **Pebrel 1.9.1**;[命令补全](completions.md)等已更新页面会在正文和“版本与参考”中单独注明核对的 `main` 日期与提交。`main` 中的功能不代表已发布到你安装的版本。macOS 和 Linux 安装包目前标为 Preview;平台差异见[安装与平台支持](installation.md)。 +本指南适用于 **Pebrel 2.1.1**。`main` 中更新的功能不代表已发布到你安装的版本;功能随版本变化时,对应页面会在页首注明版本。macOS 和 Linux 安装包目前标为 Preview;平台差异见[安装与平台支持](installation.md)。 diff --git a/docs/site/content/installation.md b/docs/site/content/installation.md index f4a001743..fbb1f2336 100644 --- a/docs/site/content/installation.md +++ b/docs/site/content/installation.md @@ -1,29 +1,33 @@ ## 选择安装包 -打开 [Pebrel Releases](https://github.com/Kuddev/pebrel/releases)。本指南对应 **1.9.1**,安装包名称包含版本、系统和处理器类型。 +打开 [Pebrel Releases](https://github.com/Kuddev/pebrel/releases)。本指南对应 **2.1.1**,安装包名称包含版本、系统和处理器类型。更新版本的文件名只有版本号不同。 | 电脑 | 选择的包 | 系统要求 | | --- | --- | --- | -| Windows,Intel / AMD 64 位处理器 | `Pebrel-v1.9.1-windows-x64-setup.exe` 或 `Pebrel-v1.9.1-windows-x64.zip` | Windows 10 1809+ / Windows 11 | -| Windows,ARM 处理器 | `Pebrel-v1.9.1-windows-arm64.zip` | 使用 ARM64 对应包 | -| Mac,Apple 芯片 | `Pebrel-v1.9.1-macos-arm64-preview.dmg` | 构建目标为 macOS 14+ | -| Mac,Intel 处理器 | `Pebrel-v1.9.1-macos-x64-preview.dmg` | 构建目标为 macOS 14+ | -| Linux,Intel / AMD 64 位处理器 | `Pebrel-v1.9.1-linux-x64-preview.deb`、`Pebrel-v1.9.1-linux-x64-preview.AppImage` 或 `Pebrel-v1.9.1-linux-x64-preview.tar.gz` | glibc 2.35+ | +| Windows,Intel / AMD 64 位处理器 | `Pebrel-v2.1.1-windows-x64-setup.exe` 或 `Pebrel-v2.1.1-windows-x64.zip` | Windows 10 1809+ / Windows 11 | +| Windows,ARM 处理器 | `Pebrel-v2.1.1-windows-arm64-setup.exe` 或 `Pebrel-v2.1.1-windows-arm64.zip` | Windows 10 1809+ / Windows 11,ARM64 | +| Mac,Apple 芯片 | `Pebrel-v2.1.1-macos-arm64-preview.dmg` | 构建目标为 macOS 14+ | +| Mac,Intel 处理器 | `Pebrel-v2.1.1-macos-x64-preview.dmg` | 构建目标为 macOS 14+ | +| Linux,Intel / AMD 64 位处理器 | `Pebrel-v2.1.1-linux-x64-preview.deb`、`Pebrel-v2.1.1-linux-x64-preview.AppImage` 或 `Pebrel-v2.1.1-linux-x64-preview.tar.gz` | glibc 2.35+ | 在 Mac 的 **苹果菜单 → 关于本机** 中可以查看芯片类型。`x64` 指 64 位 Intel / AMD,不是 32 位 x86。macOS 和 Linux 当前提供 Preview 包;macOS 构建目标为 14+,发布 CI 在 macOS 15 上验证。 +同一页面还有 `Pebrel-v2.1.1-android-universal-preview.apk`,它是手机端,不是桌面安装包,用法见[Android 连接电脑](mobile.md)。`SHA256SUMS` 用来核对下载文件。 + ## Windows ### 使用安装程序 -1. 下载 `Pebrel-v1.9.1-windows-x64-setup.exe`。 +1. 下载 `Pebrel-v2.1.1-windows-x64-setup.exe`。 2. 运行安装程序,按页面提示选择安装位置并完成安装。 3. 从开始菜单或安装完成后的入口启动 Pebrel。 4. 看到终端提示符后,输入 `echo Hello, Pebrel` 检查运行情况。 +ARM 处理器的电脑同样使用安装程序,下载 `Pebrel-v2.1.1-windows-arm64-setup.exe`。 + ### 使用便携版 -1. 下载 `Pebrel-v1.9.1-windows-x64.zip` 或 `Pebrel-v1.9.1-windows-arm64.zip`。 +1. 下载 `Pebrel-v2.1.1-windows-x64.zip` 或 `Pebrel-v2.1.1-windows-arm64.zip`。 2. **完整解压**到一个可写目录。 3. 进入解压后的目录,运行 `pebrel.exe`。 @@ -31,13 +35,13 @@ ## macOS -1. 下载 Apple Silicon 的 `Pebrel-v1.9.1-macos-arm64-preview.dmg` 或 Intel 的 `Pebrel-v1.9.1-macos-x64-preview.dmg`。 +1. 下载 Apple Silicon 的 `Pebrel-v2.1.1-macos-arm64-preview.dmg` 或 Intel 的 `Pebrel-v2.1.1-macos-x64-preview.dmg`。 2. 打开 DMG,将 **Pebrel** 拖入 **Applications/应用程序**。 3. 弹出 DMG,然后从“应用程序”启动 Pebrel。 如果系统拦截首次启动,先确认安装包来自项目官方 Release,再打开 **系统设置 → 隐私与安全性 → 仍要打开**,按系统提示确认。无需为此全局关闭 Gatekeeper。 -
    Pebrel 1.9.1 在 macOS Apple Silicon 发布 CI 中启动后的真实窗口
    1.9.1 发布 CI 中安装并启动的 macOS 版本。
    +
    Pebrel 1.9.1 在 macOS Apple Silicon 发布 CI 中启动后的真实窗口
    来自 1.9.1 发布 CI 的 macOS 启动截图,仅用于说明首次启动的样子;2.1.1 的界面细节以实际安装后的窗口为准。
    ## Linux @@ -46,7 +50,7 @@ 在下载目录打开终端,执行: ```sh -sudo apt install ./Pebrel-v1.9.1-linux-x64-preview.deb +sudo apt install ./Pebrel-v2.1.1-linux-x64-preview.deb ``` 安装完成后,从应用菜单打开 Pebrel。使用 `apt install` 安装本地 DEB,可同时处理发行版提供的依赖。 @@ -54,15 +58,15 @@ sudo apt install ./Pebrel-v1.9.1-linux-x64-preview.deb ### AppImage ```sh -chmod +x Pebrel-v1.9.1-linux-x64-preview.AppImage -./Pebrel-v1.9.1-linux-x64-preview.AppImage +chmod +x Pebrel-v2.1.1-linux-x64-preview.AppImage +./Pebrel-v2.1.1-linux-x64-preview.AppImage ``` 如果提示缺少 FUSE,请按照你的发行版说明安装兼容组件,或改用 DEB / TAR.GZ 包。 ### TAR.GZ 便携包 -解压 `Pebrel-v1.9.1-linux-x64-preview.tar.gz`,进入其中的目录后运行 `./AppRun`。保留解压后的完整目录,启动器需要读取随包资源。 +解压 `Pebrel-v2.1.1-linux-x64-preview.tar.gz`,进入其中的目录后运行 `./AppRun`。保留解压后的完整目录,启动器需要读取随包资源。 ## 平台功能差异 @@ -70,9 +74,12 @@ chmod +x Pebrel-v1.9.1-linux-x64-preview.AppImage | --- | --- | --- | --- | | 本地终端、标签页、分屏、SSH、SFTP | 支持 | 支持 | 支持 | | 系统通知 | 支持 | 支持 | 支持,取决于桌面环境 | -| 关窗保留后台会话、托盘、全局快速终端 | 支持 | 暂无 | 暂无 | -| 本地 AI Hook 自动设置 | 支持 | 暂无 | 暂无 | -| 应用内更新安装 | Windows 安装版 | 已有更新安装入口,参见更新页 | 手动更新 | +| 系统托盘、关窗保留后台会话、登录时启动 | 支持 | 支持 | 支持,托盘需要桌面提供状态通知器 | +| 全局快速终端热键 | 支持 | 支持 | 支持,Wayland 通过桌面门户注册,会按系统流程请求授权 | +| 本地 AI 集成自动设置 | 支持 | 支持 | 支持 | +| 应用内更新安装 | 安装版支持 | 支持,替换应用包 | 不提供,使用包管理器或下载新包 | + +macOS 和 Linux 的这些集成从 2.1 版开始提供,对应的设置项见[设置索引](settings.md)。通过 Scoop 或 Microsoft Store 等渠道安装的 Windows 版本,由原渠道负责更新,见[更新](updates.md)。 Linux 保存密码依赖可用且已解锁的系统凭据服务。macOS 使用系统钥匙串。有关认证方式,见[SSH 认证](ssh-auth.md)。 diff --git a/docs/site/content/interaction.md b/docs/site/content/interaction.md index 6d5351288..aa628bc69 100644 --- a/docs/site/content/interaction.md +++ b/docs/site/content/interaction.md @@ -10,7 +10,7 @@ ## 调整侧栏宽度 -开启 **拖拽调节侧栏宽度**,再拖动侧栏与工作区之间的分隔线。需要固定宽度、防止误拖时,将此项关闭。 +**拖拽调节侧栏宽度** 默认已开启,直接拖动侧栏与工作区之间的分隔线即可。需要固定宽度、防止误拖时,将此项关闭;已经明确关闭过的设置会被保留。 分隔线无法拖动时,先检查这个开关。终端内的分屏分隔线与侧栏宽度分别调整。 diff --git a/docs/site/content/keyboard.md b/docs/site/content/keyboard.md index 8b7f4a459..791ab4cb2 100644 --- a/docs/site/content/keyboard.md +++ b/docs/site/content/keyboard.md @@ -34,15 +34,17 @@ 录入时按 **Esc**取消;使用界面提示的清除操作或 Backspace 清除当前录入。出现冲突提示时,换一个组合键,或先调整原来占用它的动作。 +macOS 上清除一个动作的快捷键时,它对应的 ⌘ 组合也会一并清除,**恢复默认**则两者都恢复。页面下方的只读区还列出了标签页数字切换和确认对话框的按键:确认对话框用 **Enter** 确定、**Esc** 取消。 + ## 同一按键在不同位置的作用 快捷键会受当前焦点影响。例如,编辑 Markdown 段落时 **Ctrl+B / ⌘B**用于加粗选区;搜索框里的方向键用于选择结果,而不是移动终端光标。 快捷键没有按预期生效时,先点击要操作的终端或文档,再试一次。系统级快捷键也可能先被桌面环境或其他应用接收。 -## Windows 全局快速终端 +## 全局快速终端 -全局热键可在 Pebrel 不处于前台时使用,配置入口位于按键映射相关设置中。设置后,切换到其他应用试按一次,检查是否成功唤起窗口。 +全局热键可在 Pebrel 不处于前台时使用,在 Windows、macOS 和 Linux 上都可以设置,配置入口位于按键映射相关设置中。设置后,切换到其他应用试按一次,检查是否成功唤起窗口。 热键无法注册时,改用没有被其他应用占用的组合。详细设置见[快速终端与托盘](quick-terminal.md)。 diff --git a/docs/site/content/markdown-editing.md b/docs/site/content/markdown-editing.md index d6e175e9d..8c50fdd10 100644 --- a/docs/site/content/markdown-editing.md +++ b/docs/site/content/markdown-editing.md @@ -6,7 +6,7 @@ 4. 按 **Ctrl+S / ⌘S**,或点击 **保存**。 5. 再次切换源码选项,查看排版后的结果。 -Pebrel 1.9.1 的阅读视图用于阅读和选择文字;修改段落、列表与表格时,请在源码中操作。切回阅读视图可以预览尚未保存的编辑,但仍需执行保存才能写入文件。 +Pebrel 2.1.1 的阅读视图用于阅读和选择文字;修改段落、列表与表格时,请在源码中操作。切回阅读视图可以预览尚未保存的编辑,但仍需执行保存才能写入文件。 ## 标题、强调和链接 diff --git a/docs/site/content/mobile.md b/docs/site/content/mobile.md index 50753ca34..394f85e2e 100644 --- a/docs/site/content/mobile.md +++ b/docs/site/content/mobile.md @@ -1,5 +1,5 @@ > [!NOTE] -> 本页按 2026-09-30 的 `main`(`5ff2f3e`)核对,面向带有 **手机远程** 设置的桌面版本和匹配的 Android 客户端。它不表示 1.9.1 或任意旧 APK 已支持这些流程;下载内容以[项目发行版](https://github.com/Kuddev/pebrel/releases)实际提供的文件为准。 +> 本页按 Pebrel 2.1.1 核对,面向带有 **手机远程** 设置的桌面版本(2.0 起提供)和匹配的 Android 客户端。2.1.1 的发行版提供 `Pebrel-v2.1.1-android-universal-preview.apk`,下载见[项目发行版](https://github.com/Kuddev/pebrel/releases)。桌面和手机端的版本需要匹配,旧版本不支持这些流程。 ## 准备连接 diff --git a/docs/site/content/navigation.md b/docs/site/content/navigation.md index c212f8b9d..e3243b560 100644 --- a/docs/site/content/navigation.md +++ b/docs/site/content/navigation.md @@ -14,7 +14,7 @@ 查找已经记录的常用目录,选择对应目录结果打开终端。打开后运行 `pwd` 确认位置,再执行项目命令。 -这里列出的是 Pebrel 已知的目录。第一次使用一个尚未记录的路径,可以先在终端 `cd` 进入,或从文件树使用 **在此处打开终端**。 +这里列出的是 Pebrel 已知的目录。本地终端成功启动后,它的起始目录会自动加入这个列表;SSH 连接和 WSL 里的路径不会被当作本机目录记录。第一次使用一个尚未记录的路径,可以先在终端 `cd` 进入,或从文件树使用 **在此处打开终端**。 ## 连接主机或继续 AI 对话 diff --git a/docs/site/content/network.md b/docs/site/content/network.md index 7c0e09dd1..904861435 100644 --- a/docs/site/content/network.md +++ b/docs/site/content/network.md @@ -21,7 +21,7 @@ ## 让新终端接入系统代理 -网络页还有独立的 **系统代理**开关。开启后,**新建终端**的 `HTTP_PROXY` / `HTTPS_PROXY`环境变量会接入系统代理。 +网络页还有独立的 **系统代理**开关,用于 Windows 的新建终端:开启后,新终端会使用当前 Windows 系统代理。如果你已经在 **代理方式** 里选了 **自定义代理** 并填写了地址,新开的终端会直接使用这个地址,不必再打开这个开关。PowerShell 5 和 7 的 HTTP 请求也会使用这个 HTTP 代理。 开启后新建一个窗格,再启动需要联网的工具;已经运行的 Shell 和 CLI 不会自动得到重新创建的进程环境。 diff --git a/docs/site/content/palette.md b/docs/site/content/palette.md index 2ed7030e4..b06618c3d 100644 --- a/docs/site/content/palette.md +++ b/docs/site/content/palette.md @@ -27,4 +27,4 @@ ## 找不到某个动作 -先尝试更短的关键字,并确认当前打开的是命令面板。部分动作需要先聚焦一个终端标签;文档标签、没有分屏的标签和不同系统可用的动作可能不同。全局快速终端和托盘设置目前仅在 Windows 提供。 +先尝试更短的关键字,并确认当前打开的是命令面板。部分动作需要先聚焦一个终端标签;文档标签、没有分屏的标签和不同系统可用的动作可能不同。全局快速终端和托盘设置在 Windows、macOS 和 Linux 上都有,Linux 的托盘需要桌面提供状态通知器。 diff --git a/docs/site/content/privacy.md b/docs/site/content/privacy.md index bc2590c75..7049ebb1f 100644 --- a/docs/site/content/privacy.md +++ b/docs/site/content/privacy.md @@ -10,6 +10,10 @@ SSH 密码等保存到对应的系统凭据库。具体目录与备份范围见[ AI CLI 可能再把提示、文件或截图发送到其服务提供方。具体范围由工具的权限、配置和服务决定,发送前检查当前项目、目标主机和授权提示。 +## 备份与手机远程 + +加密备份先在本机加密,再保存到你选择的位置,存储服务只能看到密文;SSH 私钥以及系统凭据库中的密码和 API Key 不会被包含。手机远程只有在你扫码并批准后才会连接,手机与电脑之间使用端到端加密,自建中转只转发密文,看不到终端内容。详见[加密备份](backups.md)和[Android 连接电脑](mobile.md)。 + ## 分享配置或截图前 移除密码、Token、私钥、带认证的代理地址以及不需要公开的服务器信息。检查保存命令里是否包含凭据,截图中的终端输出是否包含私人数据。 diff --git a/docs/site/content/quick-terminal.md b/docs/site/content/quick-terminal.md index 912c4e858..b9d9eaaea 100644 --- a/docs/site/content/quick-terminal.md +++ b/docs/site/content/quick-terminal.md @@ -1,13 +1,13 @@ ## 设置全局热键 -**快速终端目前仅在 Windows 提供。** 设置完成后,可以在其他应用中按组合键唤起 Pebrel。 +快速终端在 Windows、macOS 和 Linux 上都可以使用。设置完成后,可以在其他应用中按组合键唤起 Pebrel。 1. 打开 **设置 → 按键映射**。 2. 找到 **快速终端**,录入准备使用的组合键。 3. 在 **快速终端打开方式**中选择需要的模式。 4. 切换到其他应用,按一次热键检查唤起效果,再按一次检查隐藏行为。 -如果提示热键注册失败,换一个没有被系统或其他应用占用的组合。只在 Pebrel 窗口内生效的普通快捷键,不能代替这个全局热键。 +如果提示热键注册失败,换一个没有被系统或其他应用占用的组合。Linux 的 Wayland 桌面通过系统的快捷键门户注册热键,首次可能会弹出授权提示,需要在系统弹窗中允许。只在 Pebrel 窗口内生效的普通快捷键,不能代替这个全局热键。 ## 选择打开方式 @@ -20,7 +20,7 @@ ## 从托盘重新打开窗口 -打开 **设置 → 高级 → 会话生命周期**,开启 **常驻系统托盘图标**。之后可以从系统托盘中的 Pebrel 入口重新显示窗口。 +打开 **设置 → 高级 → 会话生命周期**,开启 **常驻系统托盘图标**。之后可以从系统托盘(macOS 为菜单栏)中的 Pebrel 入口重新显示窗口。Linux 的托盘需要桌面环境提供状态通知器,没有它时托盘图标可能不显示。 希望关闭窗口后仍保留运行中的任务,请同时开启 **关窗后保留后台会话**。隐藏窗口后,任务会继续输出;从托盘或热键唤回时,可以接着查看。 @@ -28,4 +28,4 @@ 需要结束 Pebrel 时,使用退出应用的操作,而不是仅关闭一个设置为后台保留的窗口。保存文档并结束需要处理的任务后再退出;应用进程结束后,全局热键也不再驻留。 -macOS 和 Linux 可以通过系统应用切换、新建窗口和普通快捷键操作 Pebrel。会话恢复设置见[会话保存与恢复](sessions.md)。 +会话恢复设置见[会话保存与恢复](sessions.md)。 diff --git a/docs/site/content/quickstart.md b/docs/site/content/quickstart.md index 2f3e8224a..618197c37 100644 --- a/docs/site/content/quickstart.md +++ b/docs/site/content/quickstart.md @@ -65,4 +65,4 @@ Pebrel 会为识别出的工具显示图标和活动状态。如何查看回答 运行中的命令通常可以按 **Ctrl+C** 停止;在 Windows / Linux 中有文字选中时,先点击终端空白处清除选区,再按 Ctrl+C。出现提示符后,输入 `exit` 退出 Shell。 -希望下次打开时恢复标签页和目录,可以在 **设置 → 高级 → 会话生命周期** 开启 **启动时恢复上次标签**。需要在 Windows 关窗后继续运行任务,请另行开启[后台会话保留](sessions.md)。 +希望下次打开时恢复标签页和目录,可以在 **设置 → 高级 → 会话生命周期** 开启 **启动时恢复上次标签**。需要关窗后继续运行任务,请另行开启[后台会话保留](sessions.md)。 diff --git a/docs/site/content/readme.md b/docs/site/content/readme.md index 82c8b81ca..23d38e2b2 100644 --- a/docs/site/content/readme.md +++ b/docs/site/content/readme.md @@ -24,18 +24,19 @@ | 平台 | 当前支持 | 安装包 | | --- | --- | --- | -| Windows 10 1809+ / 11 | 正式版,x64 | .exe 安装器或 .zip 便携包 | +| Windows 10 1809+ / 11 | 正式版,x64 / ARM64 | .exe 安装器或 .zip 便携包 | | macOS 14+ | Preview,Apple Silicon / Intel | .dmg | | Linux,glibc 2.35+ | Preview,x64 | .AppImage、.deb 或 .tar.gz | +| Android 8.0+ | Preview,手机端 | .apk,用于[连接电脑](mobile.md) | -Windows 还提供系统托盘驻留、全局快速终端热键、本地 AI hook 自动配置和自动更新安装。macOS 与 Linux 的可用能力以[安装与平台支持](installation.md)为准。 +Pebrel 2.1 在 Windows、macOS 和 Linux 上都提供系统托盘、全局快速终端热键、登录启动和本地 AI 集成自动配置;Windows 和 macOS 还可以在应用内安装更新,Linux 通过包管理器或新安装包升级。细节见[安装与平台支持](installation.md)。 ## 终端与会话 - 侧栏或顶部标签管理终端,并可拖拽调整分屏。 - 每个窗格可以拥有独立工作目录;复制部分远端或子系统标签时会保留已知目录。 -- 支持历史和路径补全、快捷键及集成 Shell 提示。 -- Windows 可选择关窗后继续保留后台会话;应用真正退出后的对话恢复属于另一套机制。 +- 内置智能补全:从当前 Git 仓库、项目脚本、SSH 配置别名、文件目录获取候选(Windows 还包括已注册的 WSL 发行版),也支持历史补全,见[命令补全](completions.md)。 +- 可选择关窗后继续保留后台会话;应用真正退出后的对话恢复属于另一套机制。 要实际配置这些行为,参见[标签页与分屏](workspace.md)、[保存与恢复会话](sessions.md)和[快捷键速查](keyboard.md)。 @@ -47,9 +48,13 @@ SFTP 面板用于浏览远端目录、上传与下载文件或文件夹、查看
    Pebrel 工作区示例
    终端、文件与远端连接围绕同一工作区组织。
    +## 手机与备份 + +2.0 起,Android 客户端可以连接电脑,查看正在运行的任务、在获准后发送输入并接收提醒,命令仍在电脑上执行,见[Android 连接电脑](mobile.md)。设置、SSH 主机和工作区布局可以先在本机加密,再备份到本地目录、WebDAV、S3 兼容存储或 SSH 主机,见[加密备份](backups.md)。 + ## AI CLI 工作流 -Pebrel 会识别多种 AI CLI,并在受支持时显示活动状态与更精确的任务提示。通知与来源窗格关联,点击后可以回到对应终端。 +Pebrel 会识别多种 AI CLI,并在受支持时显示活动状态与更精确的任务提示,各工具的支持范围见[支持的 AI 命令行工具](agents.md)。通知与来源窗格关联,点击后可以回到对应终端。 已捕获的回答可以在阅读器中查看 Markdown、公式、原文和本地图片。向终端粘贴图片时,Pebrel 会把图片保存为文件并把路径交给当前会话;终端内联显示是否可用取决于命令行工具输出的协议和内容。 diff --git a/docs/site/content/runtime.md b/docs/site/content/runtime.md index d47b45e28..33618cf8b 100644 --- a/docs/site/content/runtime.md +++ b/docs/site/content/runtime.md @@ -65,8 +65,31 @@ pebrel agent read codex --lines 80 自动化应使用列表返回的身份,而不是仅根据窗口焦点猜测目标。命名 Agent 和隔离目录的完整示例见[隔离 AI 工作目录](agent-worktrees.md)。 +## 管理标签页 + +标签页的编号按窗口计算,所以必须指定窗口。编号从 0 开始,以 `pebrel ctl snapshot --pretty` 里的值为准: + +```sh +pebrel tab rename 2 "API 日志" --window 1 +pebrel tab move 2 0 --window 1 +pebrel tab close 2 --window 1 +``` + +`rename` 传入空字符串可以恢复自动标题。`close` 只关闭空闲的标签,里面还有程序在运行时会被拒绝。 + +## 校验和运行本地插件命令 + +2.0 起,`pebrel plugin` 可以在不启动窗口的情况下检查或调用一个本地命令插件包: + +```sh +pebrel plugin check ./my-plugin --pretty +pebrel plugin run ./my-plugin summary --args '{"label":"示例"}' --timeout-ms 3000 +``` + +`check` 只校验插件的清单和入口路径,不执行 Lua。`run` 每次只调用一个已声明的命令,`--timeout-ms` 取值 1 到 30000,默认 3000。命令按需运行,结束后不会留下常驻的插件进程。这个版本支持命令插件,不包含常驻的插件面板。 + ## 超时后如何处理 先读取目标状态和最近输出。如果任务已经收到但仍在执行,继续查看或等待;不要立即重复发送同一条任务,以免执行两次。 -参数和能力相关错误,可以用 `pebrel ctl describe --pretty`检查当前版本,并参阅[运行时控制参考](https://github.com/Kuddev/pebrel/blob/9dc058d12765893553d5fc7a2c37c870c96168b0/docs/runtime-control-api.md)。运行时发现文件包含本机控制凭据,不应公开、同步给他人或转发端口。 +参数和能力相关错误,可以用 `pebrel ctl describe --pretty`检查当前版本,并参阅[运行时控制参考](https://github.com/Kuddev/pebrel/blob/d574856dae42f7a5142045e0b05f3eb43106fa3d/docs/runtime-control-api.md)。运行时发现文件包含本机控制凭据,不应公开、同步给他人或转发端口。 diff --git a/docs/site/content/sessions.md b/docs/site/content/sessions.md index df597bf71..b383d3e99 100644 --- a/docs/site/content/sessions.md +++ b/docs/site/content/sessions.md @@ -8,8 +8,6 @@ ## 关窗后让任务继续运行 -**此功能仅在 Windows 提供。** - 1. 在 **设置 → 高级 → 会话生命周期**开启 **关窗后保留后台会话**。 2. 建议同时开启 **常驻系统托盘图标**,方便重新打开窗口。 3. 运行一个需要持续进行的任务,再关闭窗口。 @@ -30,7 +28,7 @@ | 你的需要 | 设置 | | --- | --- | | 重启应用后重新打开标签、分屏与目录 | 启动时恢复上次标签 | -| Windows 关闭窗口但继续运行本地任务 | 关窗后保留后台会话 | +| 关闭窗口但继续运行本地任务 | 关窗后保留后台会话 | | 重开时接续受支持的 AI 对话 | 启动时恢复上次标签 + 恢复时接续 AI 对话 | | 按项目保存几套可重复打开的布局 | 使用[布局配方](layouts.md) | diff --git a/docs/site/content/settings.md b/docs/site/content/settings.md index 7ef313266..daca3fc09 100644 --- a/docs/site/content/settings.md +++ b/docs/site/content/settings.md @@ -10,18 +10,20 @@ | --- | --- | | 查看版本、检查更新 | **应用 → 版本与更新** | | 更换主题、应用图标、跟随系统深浅色 | **外观** | -| 中英文字体、终端字号、字符间距、回滚和滚动 | **外观 → 终端外观** | +| 中英文字体、终端字号、Ctrl+滚轮缩放、平滑光标、字符间距、回滚和滚动 | **外观 → 终端外观** | | 界面字号、语言、密度与透明度 | **外观 → 界面** | | 壁纸及图片铺放方式 | **外观 → 自定义背景** | -| 默认 Shell、启动目录 | **终端 → 启动** | +| 默认 Shell、启动目录、新终端刷新环境变量(Windows) | **终端 → 启动** | | 命令补全(模式和按键见[补全指南](completions.md)) | **终端 → 补全** | | AI 通知、卡片时长、终端铃声 | **终端 → 提醒** | | 工具检测与集成 | **Agents** | | 选中即复制、鼠标焦点、粘贴确认 | **交互 → 鼠标与选区** | | 标签位置、新实例行为、Git / SVN 显示 | **交互 → 标签与窗口** | -| 修改组合键、Windows 快速终端 | **按键映射** | +| 修改组合键、全局快速终端 | **按键映射** | | 保存主机、密码与密钥、代理和跳板 | **SSH** | -| 网络代理、测试网络、新终端接入系统代理 | **网络** | +| 网络代理、测试网络、新终端接入系统代理(Windows) | **网络** | +| 备份与恢复、导出和导入备份文件 | **备份**([加密备份](backups.md)) | +| 配对手机、管理已配对的手机、自建中转 | **手机远程**([Android 连接电脑](mobile.md)) | | 登录启动、托盘、后台会话、恢复标签和 AI 对话 | **高级 → 会话生命周期** | ## 设置什么时候生效 @@ -36,7 +38,7 @@ 在 **外观 → 界面 → 语言**选择需要的语言。设置改变 Pebrel 的菜单和说明文字,不改变 Shell 或远端程序输出。个别未翻译项会显示英文。 -## Windows 登录时启动 +## 登录时启动 在 **高级 → 会话生命周期**中开启 **登录时自启动**。希望启动后先在后台待命时,再开启 **静默启动**;启用时会同时启用托盘,可从托盘重新打开窗口。 @@ -44,6 +46,6 @@ ## 找不到平台专有选项 -托盘、全局快速终端、登录启动和关窗保留后台会话目前是 Windows 集成。macOS 和 Linux 不显示对应选项时,可以按各平台已有的窗口和会话恢复方式使用。 +托盘、全局快速终端、登录启动和关窗保留后台会话在 Windows、macOS 和 Linux 上都有对应选项。如果你的版本早于 2.1,macOS 和 Linux 可能没有这些选项,先在[更新](updates.md)中升级。 修改配置文件、备份偏好和恢复默认设置,分别见[Lua 配置](configuration.md)、[备份迁移](migration.md)和[交互设置](interaction.md)。 diff --git a/docs/site/content/sftp.md b/docs/site/content/sftp.md index 50903893e..eba66aafc 100644 --- a/docs/site/content/sftp.md +++ b/docs/site/content/sftp.md @@ -29,7 +29,7 @@ | **保留两者** | 另取名称保存,让两份内容同时存在 | | **取消** | 取消这次操作 | -文件与目录类型冲突时,覆盖可能不可选。重要文件不确定是否应替换时,先使用“保留两者”,再比较两份内容。 +选择 **覆盖**、**跳过**、**保留两者** 后对话框会关闭并开始处理;**取消** 关闭对话框,不开始传输。聚焦按钮后可按 Enter 或空格确认。文件与目录类型冲突时,覆盖可能不可选。重要文件不确定是否应替换时,先使用“保留两者”,再比较两份内容。 ## 跳过没有变化的文件 diff --git a/docs/site/content/shells.md b/docs/site/content/shells.md index 6708d7eca..34f09d4a6 100644 --- a/docs/site/content/shells.md +++ b/docs/site/content/shells.md @@ -2,7 +2,7 @@ 按 **Ctrl+K**(macOS 为 **⌘K**)打开 Shell 选择器,选择要启动的终端程序。列表取决于当前电脑已安装的 Shell,以及你配置的启动入口。 -Windows 可以使用 PowerShell、命令提示符以及已安装的 WSL 发行版。macOS 和 Linux 使用系统中可用的 Shell。选择一个入口后,Pebrel 会为它建立终端会话。 +Windows 可以使用 PowerShell、命令提示符以及已安装的 WSL 发行版。macOS 和 Linux 使用系统中可用的 Shell;安装了 Zellij 时,它也会出现在选择器中,包括 Homebrew 等常见位置。选择一个入口后,Pebrel 会为它建立终端会话。 ## 更改默认 Shell @@ -22,6 +22,8 @@ Windows 可以使用 PowerShell、命令提示符以及已安装的 WSL 发行 要取消固定启动目录,点击路径右侧的 **清除**。该项会重新显示“继承当前目录”,新会话可沿用已有终端的已知目录。 +在 Windows 上,同一分组还有 **新建终端时刷新系统环境变量**。开启时,打开终端会读取 Windows 当前的环境设置,刚装好的程序和新改的 PATH 不必重启 Pebrel 就能用;关闭后新终端继承启动 Pebrel 时的环境,包括临时加进去的 PATH。已经打开的终端不受影响。 + 输入 `pwd` 查看实际目录;cmd 使用 `cd`。如果 Shell 自己的启动脚本也执行了 `cd`,最终目录会受该脚本影响。 ## 配置带参数的启动入口 diff --git a/docs/site/content/ssh-library.md b/docs/site/content/ssh-library.md index e8342b7ec..98d8ae6b3 100644 --- a/docs/site/content/ssh-library.md +++ b/docs/site/content/ssh-library.md @@ -1,6 +1,8 @@ ## 查找一台主机 -打开 **设置 → SSH**,在搜索框输入名称、地址、分组、标签或备注。经常使用的主机可以置顶,方便从列表找到。 +打开 **设置 → SSH**,在搜索框输入名称、地址、分组、标签或备注。列表上方可以按 **全部**、**置顶**、**最近** 切换范围,也可以按分组筛选。经常使用的主机在主机行的 **主机操作** 菜单里选择 **置顶**,之后在 **置顶** 范围里就能直接找到。 + +每一行会显示这台主机的登录方式,例如密码、私钥文件名;通过跳板连接的主机会注明“经 某某主机”。 建议用用途命名条目,例如“开发环境”或“日志服务器”;同一地址的不同账户,也可以在名称中写明账户用途。 @@ -10,6 +12,10 @@ 保存前检查地址与用户名,再使用 **测试连接**确认。如果只想更改列表显示文字,修改 **主机名称**即可,不必改服务器地址。 +## 复制一台主机 + +在主机行的 **主机操作** 菜单里选择 **复制**,会立即保存一台连接设置相同的新主机。之后修改副本的地址、凭据、代理或跳板、分组与标签,都不会影响原来的主机。想基于一台现有主机建立类似的连接时,先复制再修改比从头填写更省事。 + ## 使用 SSH config 中的主机 Pebrel 可以发现用户 SSH config 文件中的别名。修改配置后,使用列表的重新读取入口刷新。 @@ -21,10 +27,12 @@ Pebrel 可以发现用户 SSH config 文件中的别名。修改配置后,使 在 SSH 主机库的导出入口选择 CSV 文件位置。导出的连接元数据包含以下列: ```csv -destination,label,group,tags,notes -dev@example.com,开发服务器,开发环境,linux;test,测试账户 +destination,label,group,tags,notes,connect_to +dev@example.com,开发服务器,开发环境,linux;test,测试账户, ``` +`connect_to` 是可选列,用来保存“实际要连接的地址”。普通主机留空即可;[复制](#复制一台主机)出来的主机会在这一列写入它真正连接的地址,导入后仍然连到同一台服务器。 + CSV 不包含密码、私钥内容或私钥口令。它适合备份地址与分类,或在另一台电脑上重建主机列表。 ## 批量导入主机 diff --git a/docs/site/content/themes.md b/docs/site/content/themes.md index 447b774ae..d265dec31 100644 --- a/docs/site/content/themes.md +++ b/docs/site/content/themes.md @@ -10,7 +10,7 @@ ## 调整常用设置 -**常用设置**包含终端背景、文字颜色、强调色、光标颜色、字体、字号、行高和不透明度。 +**常用颜色**包含终端背景、文字颜色、强调色和光标颜色;**字体与显示**包含字体、字号、行高和不透明度。右侧的预览和文字与背景对比度提示会随修改更新。 例如,文字拥挤时可以略微增加行高;光标不容易看清时,选择与背景有明显差异的光标颜色。预览包含终端、界面和 ANSI 色彩,修改后分别检查这几处。 diff --git a/docs/site/content/troubleshooting.md b/docs/site/content/troubleshooting.md index 3b83918e7..9db5ca9fe 100644 --- a/docs/site/content/troubleshooting.md +++ b/docs/site/content/troubleshooting.md @@ -2,7 +2,7 @@ 先确认安装包与系统、处理器匹配,并已完整解压。Windows 便携版保留整个目录;macOS 从 Applications 启动,不从 DMG 内直接运行;Linux TAR.GZ 使用包内 `AppRun`。 -Windows 开启过 **静默启动**或 **关窗后保留后台会话**时,先检查系统托盘。macOS 被系统阻止时,按[首次启动说明](installation.md)处理。 +开启过 **静默启动**或 **关窗后保留后台会话**时,窗口可能只是隐藏了,先检查系统托盘(macOS 为菜单栏)。macOS 被系统阻止时,按[首次启动说明](installation.md)处理。 仍无法启动时,从系统终端运行对应程序并保留错误输出,不要先删除所有个人数据。 @@ -50,7 +50,7 @@ Windows 开启过 **静默启动**或 **关窗后保留后台会话**时,先 ## AI 图标、活动状态或历史缺失 -先在同一终端检查 CLI 是否可运行。Windows 集成更改后重启 CLI;工具状态异常时刷新 **设置 → Agents**并检查集成结果。 +先在同一终端检查 CLI 是否可运行。启用或更改 Agent 集成后重启 CLI;工具状态异常时刷新 **设置 → Agents**并检查集成结果。 历史恢复需要对应工具的会话记录和有效身份。右键标签使用重试或选择会话入口,或在 CLI 自己的历史里查找,见[AI 会话历史](ai-history.md)。 diff --git a/docs/site/content/updates.md b/docs/site/content/updates.md index 4fa40571f..9aad2b10c 100644 --- a/docs/site/content/updates.md +++ b/docs/site/content/updates.md @@ -2,16 +2,24 @@ 打开 **设置 → 应用**,查看当前版本并点击 **检查更新**。发现新版本后,打开更新详情查看下载和安装操作。 -**自动检查更新**控制后台检查,预下载选项用于提前下载更新包。当前界面中的更新通道显示为 **Stable**。 +**自动检查更新**控制后台检查,预下载选项用于提前下载更新包。普通安装显示的更新通道是 **Stable**。 更新前保存文档,并结束或安排好运行中的任务。下载完成后仍需按安装提示继续,重新启动后才能使用新程序。 ## Windows 安装版 -使用官方安装程序安装的版本,可以通过更新详情下载并安装。按提示完成安装器流程,然后重新启动 Pebrel。 +使用官方安装程序安装的版本,可以通过更新详情下载并安装,x64 和 ARM64 都会选择匹配的安装程序。按提示完成安装器流程,然后重新启动 Pebrel。 完成后回到 **设置 → 应用**,检查版本号是否已更新。安装正在进行时,不要同时手动替换应用文件。 +## 由 Scoop 或 Microsoft Store 管理的安装 + +通过 Scoop 或 Windows 应用包安装的 Pebrel,更新由原来的安装渠道负责。在 **设置 → 应用** 里,状态会显示 **由安装渠道管理更新**,**检查更新** 和自动检查、预下载这些选项不再提供,页面会写明该渠道: + +- Scoop 安装:在终端执行 `scoop update pebrel`。 +- 通过 Microsoft Store 安装:打开 Microsoft Store 检查更新。 +- 无法识别来源的安装:回到原来的安装渠道更新;这份副本已停用普通安装器更新。 + ## Windows 便携版 便携目录使用手动替换包的方式: diff --git a/docs/site/content/workspace.md b/docs/site/content/workspace.md index e8593ccea..fafaf3d58 100644 --- a/docs/site/content/workspace.md +++ b/docs/site/content/workspace.md @@ -42,6 +42,10 @@ “复制标签”适合在同一目录再开一个 Shell;原终端里正在运行的命令仍留在原标签中。 +## 给窗格命名 + +双击窗格标题可以为这个窗格命名,例如“日志”或“构建”。按 **Enter** 或点到别处保存,按 **Esc** 取消;清空名称会恢复自动标题。窗格移动或恢复会话后名称仍然保留。把鼠标停在标题上,会看到这些操作提示。 + ## 收起侧栏 点击侧栏收起按钮,或按 **Ctrl+Shift+B / ⌘B**。打开文件树时使用 **Ctrl+Shift+F / ⌘⇧F**。终端区域需要更多空间时,可以收起不使用的面板。 @@ -50,4 +54,4 @@ ## 关闭终端 -在 Shell 中输入 `exit`,或使用关闭入口。关闭前先停止仍需处理的命令,并保存文档标签中的修改。有关 Windows 关窗后保留任务、重启后恢复标签的设置,见[会话保存与恢复](sessions.md)。 +在 Shell 中输入 `exit`,或使用关闭入口。关闭窗格、标签页或窗口时,如果里面还有程序在运行,Pebrel 会先提示“某程序仍在运行,关闭会中止它”,确认后才会关闭。关闭前先停止仍需处理的命令,并保存文档标签中的修改。有关关窗后保留任务、重启后恢复标签的设置,见[会话保存与恢复](sessions.md)。 diff --git a/docs/site/palettes.py b/docs/site/palettes.py new file mode 100644 index 000000000..63e509991 --- /dev/null +++ b/docs/site/palettes.py @@ -0,0 +1,182 @@ +"""Derive the documentation colour themes from the desktop application's built-in themes. + +The palettes are parsed from the application source rather than copied, so a theme added +or retuned in `nebula_settings` reaches the site on the next build. The build fails when +the source no longer has the expected shape instead of silently dropping a theme. +""" +import html +import re +from pathlib import Path + +REPO = Path(__file__).resolve().parents[2] +THEMES_RS = REPO / "nebula_settings/src/themes.rs" +LABELS_RS = REPO / "nebula_app/src/display/ui/theme.rs" + +# Mirrors the application's factory default (Nord) and its light pair when following the system. +DEFAULT_LIGHT = "NordLight" +DEFAULT_DARK = "Nord" + +FIELDS = ("shell", "background", "foreground", "muted", "accent", "selected", "line", + "red", "green", "yellow", "blue", "purple", "cyan") + + +def _bytes(raw: str) -> tuple[int, ...]: + return tuple(int(value.strip(), 0) for value in raw.split(",") if value.strip()) + + +def _hex(channels: tuple[int, ...]) -> str: + return "#" + "".join(f"{channel:02x}" for channel in channels[:3]) + + +def _mix(front: tuple[int, ...], back: tuple[int, ...], amount: float) -> tuple[int, ...]: + return tuple(round(f * amount + b * (1 - amount)) for f, b in zip(front[:3], back[:3])) + + +def luminance(channels: tuple[int, ...]) -> float: + def linear(value: int) -> float: + value /= 255 + return value / 12.92 if value <= 0.03928 else ((value + 0.055) / 1.055) ** 2.4 + red, green, blue = (linear(value) for value in channels[:3]) + return 0.2126 * red + 0.7152 * green + 0.0722 * blue + + +def contrast(first: tuple[int, ...], second: tuple[int, ...]) -> float: + high, low = sorted((luminance(first), luminance(second)), reverse=True) + return (high + 0.05) / (low + 0.05) + + +def load() -> list[dict]: + """Return the selectable built-in themes in the order the application lists them.""" + source = THEMES_RS.read_text(encoding="utf-8") + order = re.search(r"pub const BUILTIN: \[Self; \d+\] = \[(.*?)\];", source, re.S) + if not order: + raise ValueError("themes.rs: BUILTIN catalog not found") + variants = re.findall(r"Self::(\w+)", order.group(1)) + labels_source = LABELS_RS.read_text(encoding="utf-8") + label_block = re.search(r"pub\(crate\) fn label\(self\) -> &'static str \{(.*?)\n \}", labels_source, re.S) + if not label_block: + raise ValueError("theme.rs: label() not found") + labels = dict(re.findall(r'Self::(\w+) => "([^"]+)"', label_block.group(1))) + reviewed = re.search(r"pub const fn reviewed_palette\(self\).*?\n \}\n", source, re.S) + if not reviewed: + raise ValueError("themes.rs: reviewed_palette() not found") + arms = { + name: body + for name, body in re.findall(r"Self::(\w+) => ReviewedPalette \{(.*?)\n \},", reviewed.group(0), re.S) + } + themes = [] + for variant in variants: + if variant not in arms or variant not in labels: + raise ValueError(f"theme {variant}: palette or label missing in the application source") + palette = {} + for field in FIELDS: + found = re.search(rf"\b{field}: \[([^\]]*)\]", arms[variant]) + if not found: + raise ValueError(f"theme {variant}: field {field} missing") + palette[field] = _bytes(found.group(1)) + themes.append({ + "id": variant, "label": labels[variant], "palette": palette, + "light": luminance(palette["background"]) > 0.4, + }) + ids = {theme["id"] for theme in themes} + if DEFAULT_LIGHT not in ids or DEFAULT_DARK not in ids: + raise ValueError("default theme pair is not selectable") + return themes + + +def _over(front: tuple[int, ...], back: tuple[int, ...]) -> tuple[int, ...]: + """Composite a colour that may carry an alpha channel, as the application does.""" + alpha = front[3] / 255 if len(front) > 3 else 1 + return _mix(front, back, alpha) + + +def readable(color: tuple[int, ...], foreground: tuple[int, ...], background: tuple[int, ...]) -> tuple[int, ...]: + """Keep a theme colour for text, nudged toward the foreground only when too faint to read.""" + for step in range(21): + candidate = _mix(foreground, color, step / 20) + if contrast(candidate, background) >= 4.5: + return candidate + return foreground + + +def tokens(theme: dict) -> dict[str, str]: + palette = theme["palette"] + background = palette["background"] + selected = _mix(_over(palette["selected"], background), background, 0.5) + foreground = palette["foreground"] + accent = readable(palette["accent"], foreground, selected) + muted = readable(palette["muted"], foreground, selected) + + def ink(name: str) -> str: + return _hex(readable(palette[name], foreground, selected)) + return { + "bg": _hex(background), + "panel": _hex(palette["shell"]), + "soft": _hex(selected), + "code": _hex(selected), + "tint": _hex(_mix(accent, background, 0.12)), + "text": _hex(palette["foreground"]), + "muted": _hex(muted), + "line": _hex(_over(palette["line"], background)), + "accent": _hex(accent), + "red": ink("red"), "green": ink("green"), "yellow": ink("yellow"), + "blue": ink("blue"), "purple": ink("purple"), "cyan": ink("cyan"), + } + + +def _block(selector: str, theme: dict) -> str: + scheme = "light" if theme["light"] else "dark" + body = "".join(f"--{name}:{value};" for name, value in tokens(theme).items()) + return f"{selector}{{color-scheme:{scheme};{body}}}\n" + + +def stylesheet(themes: list[dict]) -> str: + by_id = {theme["id"]: theme for theme in themes} + css = "/* Generated by palettes.py from the application's built-in themes. */\n" + css += _block(":root", by_id[DEFAULT_LIGHT]) + css += "@media (prefers-color-scheme: dark){\n" + _block(":root:not([data-palette])", by_id[DEFAULT_DARK]) + "}\n" + for theme in themes: + css += _block(f'html[data-palette="{theme["id"]}"]', theme) + return css + + +def code_stylesheet() -> str: + """Syntax colours that follow the active palette instead of two fixed Pygments styles.""" + groups = [ + ("var(--purple)", "k kd kn kp kr kt"), + ("var(--green)", "s s1 s2 sa sb sc sd se sh si sx sr ss"), + ("var(--yellow)", "m mb mf mh mi mo il na"), + ("var(--blue)", "nf nc fm nd ne nt"), + ("var(--cyan)", "nb bp o ow"), + ("var(--red)", "err gd gr"), + ("var(--green)", "gi"), + ] + lines = [] + for color, classes in groups: + selector = ",".join(f".code-block .{name}" for name in classes.split()) + lines.append(f"{selector}{{color:{color}}}") + comments = ",".join(f".code-block .{name}" for name in "c c1 cm cp cs ch cpf".split()) + lines.append(f"{comments}{{color:var(--muted);font-style:italic}}") + lines.append(".code-block .gh,.code-block .gu,.code-block .gs{font-weight:600}") + return "\n".join(lines) + "\n" + + +def dark_ids(themes: list[dict]) -> str: + return ",".join(f"'{theme['id']}'" for theme in themes if not theme["light"]) + + +def menu(themes: list[dict]) -> str: + def item(theme: dict) -> str: + values = tokens(theme) + return ( + f'') + + def group(title: str, light: bool) -> str: + entries = "".join(item(theme) for theme in themes if theme["light"] is light) + return f'
    {title}{entries}
    ' + + system = ('') + return system + group("浅色", True) + group("深色", False) diff --git a/docs/site/site.json b/docs/site/site.json index 7a31a5a8f..3ceaf227f 100644 --- a/docs/site/site.json +++ b/docs/site/site.json @@ -1,6 +1,6 @@ { - "version": "1.9.1", - "source_commit": "9dc058d12765893553d5fc7a2c37c870c96168b0", + "version": "2.1.1", + "source_commit": "d574856dae42f7a5142045e0b05f3eb43106fa3d", "groups": [ { "title": "开始使用", @@ -111,9 +111,7 @@ "nebula_app/src/completion/connections.rs", "nebula_app/src/completion/project_scripts.rs", "nebula-completions/src/semantic/common.rs" - ], - "version": "main(2026-09-30)", - "source_commit": "5ff2f3eea54b9c66e416149e17e823b8d72b1dee" + ] }, { "slug": "palette", @@ -270,8 +268,6 @@ "slug": "mobile", "title": "Android 连接电脑", "description": "配对自己的手机、核对校验码、选择只看或允许输入,并撤销不用的设备。", - "version": "main(2026-09-30)", - "source_commit": "5ff2f3eea54b9c66e416149e17e823b8d72b1dee", "sources": [ "nebula_app/src/gpui_shell/settings_pane/mobile/view.rs", "nebula_app/src/mobile_connection/preferences.rs", @@ -384,7 +380,20 @@ "nebula_app/src/gpui_shell/workspace/agents.rs", "nebula_app/src/ai_hook/integrations.rs", "nebula_app/src/gpui_shell/terminal/view.rs", - "nebula_app/src/gpui_shell/terminal/view/agent_activity.rs" + "nebula_app/src/gpui_shell/terminal/view/agent_activity.rs", + "nebula_app/src/display/program_identity.rs" + ] + }, + { + "slug": "agents", + "title": "支持的 AI 命令行工具", + "description": "查看 Pebrel 能识别哪些 AI CLI 和 TUI,以及每个工具有哪些状态、图标和会话功能。", + "sources": [ + "nebula_app/src/ai_agents.rs", + "nebula_app/src/ai_hook/integrations.rs", + "nebula_app/src/display/program_identity.rs", + "nebula_app/src/agent_detection/_shared.toml", + "nebula_app/src/gpui_shell/settings_pane/agents.rs" ] }, { @@ -394,7 +403,12 @@ "sources": [ "nebula_app/src/ai_hook/integrations.rs", "nebula_app/src/gpui_shell/settings_pane/agents.rs", - "nebula_app/src/ai_hook/local/settings.rs" + "nebula_app/src/ai_hook/local/settings.rs", + "nebula_app/src/platform/capabilities.rs", + "nebula_app/src/cli.rs", + "nebula_app/src/ssh_session/integration.rs", + "nebula_settings/src/agent_hooks.rs", + "nebula_app/src/ai_hook/local/runtime_skills.rs" ] }, { @@ -404,7 +418,9 @@ "sources": [ "nebula_app/src/ai_sessions.rs", "nebula_app/src/gpui_shell/workspace/session_recovery.rs", - "nebula_app/src/gpui_shell/workspace/tab_menu.rs" + "nebula_app/src/gpui_shell/workspace/tab_menu.rs", + "nebula_app/src/ai_agents.rs", + "nebula_app/src/gpui_shell/workspace/agents.rs" ] }, { @@ -561,8 +577,6 @@ "slug": "backups", "title": "加密备份与恢复", "description": "创建加密快照、导出迁移文件、选择恢复内容,检查密码与存储平台限制。", - "version": "main(2026-09-30)", - "source_commit": "5ff2f3eea54b9c66e416149e17e823b8d72b1dee", "sources": [ "nebula_app/src/gpui_shell/settings_pane/backup.rs", "nebula_app/src/gpui_shell/settings_pane/backup/setup.rs", diff --git a/docs/site/template.html b/docs/site/template.html index a08517564..8a5e4558f 100644 --- a/docs/site/template.html +++ b/docs/site/template.html @@ -1,28 +1,31 @@ - + - + $title · Pebrel 文档 $canonical - + + -
    - Pebrel文档 + Pebrel文档
    - +
    + + +
    diff --git a/docs/site/test_site.py b/docs/site/test_site.py index cb2471e77..8ca15f90f 100644 --- a/docs/site/test_site.py +++ b/docs/site/test_site.py @@ -7,6 +7,7 @@ from pathlib import Path from urllib.parse import unquote, urlsplit +import palettes from build import build, HERE, home_header, page_url, source_details @@ -102,6 +103,25 @@ def test_homepage_hero_has_no_eyebrow_or_description(self): self.assertIn('installation/index.html', hero) self.assertEqual(header.count('https://github.com/Kuddev/pebrel/releases/latest'), 3) + def test_every_builtin_theme_is_selectable_and_readable(self): + themes = palettes.load() + catalog = palettes.THEMES_RS.read_text(encoding='utf-8') + declared = __import__('re').search(r'BUILTIN: \[Self; (\d+)\]', catalog).group(1) + self.assertEqual(len(themes), int(declared)) + stylesheet = (self.root / 'assets' / 'palettes.css').read_text() + index = (self.root / 'index.html').read_text() + for theme in themes: + values = {name: tuple(int(value[i:i + 2], 16) for i in (1, 3, 5)) for name, value in palettes.tokens(theme).items()} + with self.subTest(theme=theme['id']): + self.assertIn(f'html[data-palette="{theme["id"]}"]', stylesheet) + self.assertIn(f'data-palette-option="{theme["id"]}"', index) + for surface in ('bg', 'soft'): + for ink in ('text', 'muted', 'accent'): + self.assertGreaterEqual(palettes.contrast(values[ink], values[surface]), 4.5, f'{ink} on {surface}') + for ink in ('red', 'green', 'yellow', 'blue', 'purple', 'cyan'): + self.assertGreaterEqual(palettes.contrast(values[ink], values['code']), 4.5, f'{ink} on code') + self.assertIn('data-palette-option="system"', index) + def test_page_specific_version_and_sources(self): config = json.loads((HERE / 'site.json').read_text()) for group in config['groups']: From 4c8a72459b98a0c88a3784106047ff8793172110 Mon Sep 17 00:00:00 2001 From: GeekMr <140129782+WilliamWang1721@users.noreply.github.com> Date: Wed, 7 Oct 2026 18:18:30 +0800 Subject: [PATCH 11/13] fix(docs-site): suspend transitions while switching the colour theme Changing the palette repaints the page at once, but links and buttons faded over 180 ms, so rounded cards, nav pills and buttons lingered in the old colours against the new background for a moment. Disable transitions for the frames in which the palette changes. --- docs/site/assets/site.css | 8 ++++++++ docs/site/assets/site.js | 2 ++ docs/site/test_site.py | 7 +++++++ 3 files changed, 17 insertions(+) diff --git a/docs/site/assets/site.css b/docs/site/assets/site.css index e13e443da..4429bc56a 100644 --- a/docs/site/assets/site.css +++ b/docs/site/assets/site.css @@ -58,6 +58,14 @@ a,button { transition:background .18s,color .18s,border-color .18s,transform .18s; } +/* A palette change repaints everything at once; per-element fades would leave + rounded cards and pills in the old colours for a moment. */ +html[data-switching] *, +html[data-switching] *::before, +html[data-switching] *::after { + transition:none!important; +} + button:active { transform:translateY(1px); } diff --git a/docs/site/assets/site.js b/docs/site/assets/site.js index fc5e78e63..231936085 100644 --- a/docs/site/assets/site.js +++ b/docs/site/assets/site.js @@ -56,6 +56,8 @@ const systemDark = matchMedia('(prefers-color-scheme: dark)'); function applyPalette(choice, remember) { const id = choice === 'system' ? (systemDark.matches ? 'Nord' : 'NordLight') : choice; + html.dataset.switching = ''; + requestAnimationFrame(() => requestAnimationFrame(() => delete html.dataset.switching)); html.dataset.palette = id; html.dataset.theme = darkPalettes.has(id) ? 'dark' : 'light'; if (choice === 'system') html.dataset.follow = 'system'; else delete html.dataset.follow; diff --git a/docs/site/test_site.py b/docs/site/test_site.py index 8ca15f90f..d33e5047e 100644 --- a/docs/site/test_site.py +++ b/docs/site/test_site.py @@ -122,6 +122,13 @@ def test_every_builtin_theme_is_selectable_and_readable(self): self.assertGreaterEqual(palettes.contrast(values[ink], values['code']), 4.5, f'{ink} on code') self.assertIn('data-palette-option="system"', index) + def test_palette_switch_suspends_transitions(self): + css = (self.root / 'assets' / 'site.css').read_text() + script = (self.root / 'assets' / 'site.js').read_text() + self.assertIn('html[data-switching] *', css) + self.assertIn('transition:none!important', css.split('html[data-switching] *', 1)[1].split('}', 1)[0]) + self.assertIn('html.dataset.switching', script) + def test_page_specific_version_and_sources(self): config = json.loads((HERE / 'site.json').read_text()) for group in config['groups']: From ecc81bc9fac2d0813632e023672d23a21428616a Mon Sep 17 00:00:00 2001 From: GeekMr <140129782+WilliamWang1721@users.noreply.github.com> Date: Wed, 7 Oct 2026 18:37:29 +0800 Subject: [PATCH 12/13] fix(docs-site): read the default version in the browser check The manifest no longer carries a per-page version and source commit, so the browser check must fall back to the site-level values instead of indexing them. --- docs/site/check_browser.py | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/site/check_browser.py b/docs/site/check_browser.py index 7f7bc5039..9387806b4 100644 --- a/docs/site/check_browser.py +++ b/docs/site/check_browser.py @@ -81,10 +81,12 @@ def check(site: Path, output: Path): pages = {item['slug']: item for group in manifest['groups'] for item in group['pages']} for slug in ('completions', 'backups', 'mobile'): page.goto(base + slug + '/index.html') - expect(page.locator('.article-footer')).to_contain_text(pages[slug]['version']) + version = pages[slug].get('version', manifest['version']) + commit = pages[slug].get('source_commit', manifest['source_commit']) + expect(page.locator('.article-footer')).to_contain_text(version) page.locator('.source-details summary').click() expect(page.locator('.source-details a').first).to_have_attribute( - 'href', __import__('re').compile(f"/blob/{pages[slug]['source_commit']}/")) + 'href', __import__('re').compile(f"/blob/{commit}/")) assert not page.evaluate('document.documentElement.scrollWidth > innerWidth') page.screenshot(path=str(output / f'docs-{slug}-mobile.png'), full_page=True) page.goto(base) From 0cfff654e867139e7a650fd1f37e242bdc3101e8 Mon Sep 17 00:00:00 2001 From: WilliamWang1721 <140129782+WilliamWang1721@users.noreply.github.com> Date: Tue, 17 Nov 2026 12:34:57 +0000 Subject: [PATCH 13/13] docs(site): follow the nebula to pebrel crate and directory rename --- docs/site/README.md | 4 +- docs/site/content/contributing.md | 8 +- docs/site/content/readme.md | 2 +- docs/site/palettes.py | 6 +- docs/site/site.json | 344 +++++++++++++++--------------- 5 files changed, 182 insertions(+), 182 deletions(-) diff --git a/docs/site/README.md b/docs/site/README.md index df1fe393a..99d29031e 100644 --- a/docs/site/README.md +++ b/docs/site/README.md @@ -36,8 +36,8 @@ Search loads a local JavaScript index rather than requiring a backend or CDN. ## Colour themes The site uses the desktop application's own palettes. `palettes.py` parses the 16 -built-in themes from `nebula_settings/src/themes.rs` (and their names from -`nebula_app/src/display/ui/theme.rs`) at build time and writes `assets/palettes.css` +built-in themes from `pebrel_settings/src/themes.rs` (and their names from +`pebrel_app/src/display/ui/theme.rs`) at build time and writes `assets/palettes.css` plus the syntax colours in `assets/highlight.css`. Nothing is copied by hand, so a theme added or retuned in the application reaches the site on the next build, and the build fails if the source no longer has the expected shape. diff --git a/docs/site/content/contributing.md b/docs/site/content/contributing.md index 812f623b1..cc2ce29ee 100644 --- a/docs/site/content/contributing.md +++ b/docs/site/content/contributing.md @@ -19,7 +19,7 @@ 4. 构建实际的 GPUI 产品界面: ```sh -cargo build --locked -p nebula --bin pebrel --features gpui-shell +cargo build --locked -p pebrel --bin pebrel --features gpui-shell ``` 如果只是修文档,应优先运行文档自己的构建与测试,不需要为了文字改动制造无关的产品代码变化。 @@ -47,15 +47,15 @@ PR、Issue 及其评论不能用于广告、商业推广或引流,包括以功 python3 scripts/check_architecture.py --base python3 -m unittest scripts.tests.test_architecture_budgets scripts.tests.test_architecture_dependencies scripts.tests.test_architecture_governance cargo test --manifest-path tools/i18n-contract/Cargo.toml --locked -cargo test -p nebula-settings -cargo test -p nebula --test file_line_budget +cargo test -p pebrel-settings +cargo test -p pebrel --test file_line_budget cargo fmt --all -- --check ``` 涉及正式应用行为时,再运行: ```sh -cargo check -p nebula --bin pebrel --features gpui-shell --tests --locked +cargo check -p pebrel --bin pebrel --features gpui-shell --tests --locked ``` 还应运行与你修改区域直接相关的行为测试。无法在当前机器上验证的平台能力,需要在 PR 描述里明确写出,而不是把“能编译”描述成“UI 已验证”。 diff --git a/docs/site/content/readme.md b/docs/site/content/readme.md index 23d38e2b2..51f1c19a3 100644 --- a/docs/site/content/readme.md +++ b/docs/site/content/readme.md @@ -84,7 +84,7 @@ pebrel config check 安装仓库固定的 Rust 工具链和平台依赖后,README 给出的正式产品构建命令为: ~~~sh -cargo build --release --locked -p nebula --bin pebrel --features gpui-shell +cargo build --release --locked -p pebrel --bin pebrel --features gpui-shell ~~~ 准备参与开发时,请继续阅读[贡献与开发](contributing.md),按照仓库规定运行相应检查。 diff --git a/docs/site/palettes.py b/docs/site/palettes.py index 63e509991..192bf023c 100644 --- a/docs/site/palettes.py +++ b/docs/site/palettes.py @@ -1,7 +1,7 @@ """Derive the documentation colour themes from the desktop application's built-in themes. The palettes are parsed from the application source rather than copied, so a theme added -or retuned in `nebula_settings` reaches the site on the next build. The build fails when +or retuned in `pebrel_settings` reaches the site on the next build. The build fails when the source no longer has the expected shape instead of silently dropping a theme. """ import html @@ -9,8 +9,8 @@ from pathlib import Path REPO = Path(__file__).resolve().parents[2] -THEMES_RS = REPO / "nebula_settings/src/themes.rs" -LABELS_RS = REPO / "nebula_app/src/display/ui/theme.rs" +THEMES_RS = REPO / "pebrel_settings/src/themes.rs" +LABELS_RS = REPO / "pebrel_app/src/display/ui/theme.rs" # Mirrors the application's factory default (Nord) and its light pair when following the system. DEFAULT_LIGHT = "NordLight" diff --git a/docs/site/site.json b/docs/site/site.json index 3ceaf227f..aaf856bc9 100644 --- a/docs/site/site.json +++ b/docs/site/site.json @@ -11,7 +11,7 @@ "description": "安装 Pebrel,运行命令,连接服务器并管理项目文件。", "sources": [ "README.md", - "nebula_app/src/platform/capabilities.rs" + "pebrel_app/src/platform/capabilities.rs" ] }, { @@ -30,7 +30,7 @@ "description": "运行第一条命令,再创建标签页、分屏和 SSH 连接。", "sources": [ "INSTALL.md", - "nebula_app/src/gpui_shell/workspace/keyboard_bindings.rs" + "pebrel_app/src/gpui_shell/workspace/keyboard_bindings.rs" ] }, { @@ -39,8 +39,8 @@ "description": "选择适合电脑的安装包,完成安装和首次启动。", "sources": [ "INSTALL.md", - "nebula_app/src/platform/capabilities.rs", - "nebula_app/src/platform/update_installation.rs" + "pebrel_app/src/platform/capabilities.rs", + "pebrel_app/src/platform/update_installation.rs" ] }, { @@ -48,17 +48,17 @@ "title": "标签页与分屏", "description": "新建、移动和关闭标签页,调整分屏大小与焦点。", "sources": [ - "nebula_app/src/gpui_shell/workspace/tab_menu.rs", - "nebula_app/src/gpui_shell/workspace/pane_header.rs", - "nebula_app/src/gpui_shell/workspace/keyboard_bindings.rs" + "pebrel_app/src/gpui_shell/workspace/tab_menu.rs", + "pebrel_app/src/gpui_shell/workspace/pane_header.rs", + "pebrel_app/src/gpui_shell/workspace/keyboard_bindings.rs" ] }, { "slug": "terminal-basics", "sources": [ - "nebula_app/src/gpui_shell/terminal/view.rs", - "nebula_app/src/gpui_shell/workspace/keyboard_bindings.rs", - "nebula_app/src/gpui_shell/settings_pane/appearance_advanced.rs" + "pebrel_app/src/gpui_shell/terminal/view.rs", + "pebrel_app/src/gpui_shell/workspace/keyboard_bindings.rs", + "pebrel_app/src/gpui_shell/settings_pane/appearance_advanced.rs" ], "title": "运行命令与切换目录", "description": "查看当前目录、执行命令、停止程序和查找历史输出。" @@ -73,18 +73,18 @@ "title": "Shell 与启动目录", "description": "选择默认 Shell,设定启动目录,添加带参数的启动入口。", "sources": [ - "nebula_app/src/terminal_profiles.rs", - "nebula_app/src/gpui_shell/settings_pane/shell_picker.rs", + "pebrel_app/src/terminal_profiles.rs", + "pebrel_app/src/gpui_shell/settings_pane/shell_picker.rs", "docs/lua-configuration.md", - "nebula_app/src/gpui_shell/settings_pane.rs" + "pebrel_app/src/gpui_shell/settings_pane.rs" ] }, { "slug": "wsl", "sources": [ - "nebula_app/src/shell_detect.rs", - "nebula_app/src/agent_env.rs", - "nebula_app/src/gpui_shell/settings_pane/shell_picker.rs" + "pebrel_app/src/shell_detect.rs", + "pebrel_app/src/agent_env.rs", + "pebrel_app/src/gpui_shell/settings_pane/shell_picker.rs" ], "title": "使用 WSL", "description": "打开已安装的 Linux 发行版,访问项目并运行 Linux 工具。" @@ -94,9 +94,9 @@ "title": "选择、复制与粘贴", "description": "复制终端输出,粘贴命令和图片,设置选中即复制。", "sources": [ - "nebula_app/src/gpui_shell/terminal/view/image_paste.rs", - "nebula_app/src/gpui_shell/settings_pane/setting_help.rs", - "nebula_app/src/gpui_shell/workspace/send_to_chat.rs" + "pebrel_app/src/gpui_shell/terminal/view/image_paste.rs", + "pebrel_app/src/gpui_shell/settings_pane/setting_help.rs", + "pebrel_app/src/gpui_shell/workspace/send_to_chat.rs" ] }, { @@ -104,12 +104,12 @@ "title": "命令补全与智能候选", "description": "选择三种补齐模式,补齐 Git 分支、项目脚本、SSH 别名、路径与历史命令。", "sources": [ - "nebula_app/src/gpui_shell/settings_pane.rs", - "nebula_app/i18n/zh-CN.json", - "nebula_app/src/gpui_shell/terminal/view/completion.rs", - "nebula_app/src/completion.rs", - "nebula_app/src/completion/connections.rs", - "nebula_app/src/completion/project_scripts.rs", + "pebrel_app/src/gpui_shell/settings_pane.rs", + "pebrel_app/i18n/zh-CN.json", + "pebrel_app/src/gpui_shell/terminal/view/completion.rs", + "pebrel_app/src/completion.rs", + "pebrel_app/src/completion/connections.rs", + "pebrel_app/src/completion/project_scripts.rs", "nebula-completions/src/semantic/common.rs" ] }, @@ -118,8 +118,8 @@ "title": "命令面板", "description": "搜索并执行应用操作,快速打开设置或调整工作区。", "sources": [ - "nebula_app/src/gpui_shell/workspace/palette.rs", - "nebula_app/src/gpui_shell/workspace/keyboard_bindings.rs" + "pebrel_app/src/gpui_shell/workspace/palette.rs", + "pebrel_app/src/gpui_shell/workspace/keyboard_bindings.rs" ] }, { @@ -127,9 +127,9 @@ "title": "保存常用命令", "description": "保存、搜索和分组命令,选择插入文字或立即执行。", "sources": [ - "nebula_app/src/gpui_shell/workspace/command_manager.rs", - "nebula_app/src/gpui_shell/workspace/command_manager/groups.rs", - "nebula_app/src/saved_commands.rs" + "pebrel_app/src/gpui_shell/workspace/command_manager.rs", + "pebrel_app/src/gpui_shell/workspace/command_manager/groups.rs", + "pebrel_app/src/saved_commands.rs" ] }, { @@ -137,8 +137,8 @@ "title": "查找与快速跳转", "description": "切换已打开的标签,跳转目录、主机和 AI 会话。", "sources": [ - "nebula_app/src/gpui_shell/workspace/quick_jump.rs", - "nebula_app/src/ai_sessions.rs" + "pebrel_app/src/gpui_shell/workspace/quick_jump.rs", + "pebrel_app/src/ai_sessions.rs" ] }, { @@ -146,8 +146,8 @@ "title": "快捷键速查", "description": "查找 Windows、macOS 和 Linux 常用快捷键,修改按键映射。", "sources": [ - "nebula_app/src/gpui_shell/workspace/keyboard_bindings.rs", - "nebula_app/src/gpui_shell/settings_pane/keymap.rs" + "pebrel_app/src/gpui_shell/workspace/keyboard_bindings.rs", + "pebrel_app/src/gpui_shell/settings_pane/keymap.rs" ] } ] @@ -160,8 +160,8 @@ "title": "广播输入", "description": "选择同一标签中的多个窗格,同时输入命令并退出广播。", "sources": [ - "nebula_app/src/gpui_shell/workspace/pane_header.rs", - "nebula_app/src/gpui_shell/terminal/view/image_paste.rs" + "pebrel_app/src/gpui_shell/workspace/pane_header.rs", + "pebrel_app/src/gpui_shell/terminal/view/image_paste.rs" ] }, { @@ -169,11 +169,11 @@ "title": "保存与恢复会话", "description": "设置启动时恢复标签和目录,在 Windows 中保留后台会话。", "sources": [ - "nebula_app/src/gpui_shell/workspace/session_persistence.rs", - "nebula_app/src/gpui_shell/workspace/session_recovery.rs", - "nebula_app/src/gpui_shell/session_restore.rs", - "nebula_app/src/platform/capabilities.rs", - "nebula_app/src/gpui_shell/settings_pane.rs" + "pebrel_app/src/gpui_shell/workspace/session_persistence.rs", + "pebrel_app/src/gpui_shell/workspace/session_recovery.rs", + "pebrel_app/src/gpui_shell/session_restore.rs", + "pebrel_app/src/platform/capabilities.rs", + "pebrel_app/src/gpui_shell/settings_pane.rs" ] }, { @@ -181,7 +181,7 @@ "title": "保存与打开布局", "description": "把常用标签和分屏保存为布局配方,在新窗口中打开。", "sources": [ - "nebula_app/src/gpui_shell/workspace/recipes/mod.rs" + "pebrel_app/src/gpui_shell/workspace/recipes/mod.rs" ] }, { @@ -189,9 +189,9 @@ "title": "快速终端与托盘", "description": "设置 Windows 全局热键,通过托盘召回终端或退出程序。", "sources": [ - "nebula_app/src/gpui_shell/workspace/quick_terminal.rs", - "nebula_app/src/gpui_shell/settings_pane/keymap.rs", - "nebula_app/src/platform/capabilities.rs" + "pebrel_app/src/gpui_shell/workspace/quick_terminal.rs", + "pebrel_app/src/gpui_shell/settings_pane/keymap.rs", + "pebrel_app/src/platform/capabilities.rs" ] } ] @@ -204,9 +204,9 @@ "title": "连接 SSH 服务器", "description": "填写连接信息、测试认证并核对服务器指纹。", "sources": [ - "nebula_app/src/gpui_shell/ssh_settings.rs", - "nebula_app/src/gpui_shell/ssh_settings/editor.rs", - "nebula_app/src/gpui_shell/workspace/ssh_dialog.rs" + "pebrel_app/src/gpui_shell/ssh_settings.rs", + "pebrel_app/src/gpui_shell/ssh_settings/editor.rs", + "pebrel_app/src/gpui_shell/workspace/ssh_dialog.rs" ] }, { @@ -214,10 +214,10 @@ "title": "管理 SSH 主机", "description": "编辑连接,整理分组与标签,导入或导出主机列表。", "sources": [ - "nebula_app/src/gpui_shell/ssh_settings/library.rs", - "nebula_app/src/gpui_shell/ssh_settings/library/exchange.rs", - "nebula_app/src/ssh_profiles/exchange.rs", - "nebula_app/src/ssh_profiles/organization.rs" + "pebrel_app/src/gpui_shell/ssh_settings/library.rs", + "pebrel_app/src/gpui_shell/ssh_settings/library/exchange.rs", + "pebrel_app/src/ssh_profiles/exchange.rs", + "pebrel_app/src/ssh_profiles/organization.rs" ] }, { @@ -225,19 +225,19 @@ "title": "密码、密钥与认证", "description": "选择认证方式,使用私钥,并管理保存的登录凭据。", "sources": [ - "nebula_app/src/ssh_session/lifecycle.rs", - "nebula_app/src/ssh_session/agent.rs", - "nebula_app/src/ssh_credentials.rs", - "nebula_app/src/platform/credentials.rs" + "pebrel_app/src/ssh_session/lifecycle.rs", + "pebrel_app/src/ssh_session/agent.rs", + "pebrel_app/src/ssh_credentials.rs", + "pebrel_app/src/platform/credentials.rs" ] }, { "slug": "ssh-config", "sources": [ - "nebula_app/src/ssh.rs", - "nebula_app/src/ssh_session.rs", - "nebula_app/src/gpui_shell/ssh_settings/library.rs", - "nebula_app/src/ssh_proxy.rs" + "pebrel_app/src/ssh.rs", + "pebrel_app/src/ssh_session.rs", + "pebrel_app/src/gpui_shell/ssh_settings/library.rs", + "pebrel_app/src/ssh_proxy.rs" ], "title": "使用 SSH config", "description": "通过别名连接服务器,读取配置中的用户名、密钥和跳板。" @@ -247,10 +247,10 @@ "title": "代理与跳板机", "description": "配置直连、代理或单级跳板,检查连接路线。", "sources": [ - "nebula_app/src/gpui_shell/ssh_settings/advanced.rs", - "nebula_app/src/ssh_profiles/connection.rs", - "nebula_app/src/ssh_session/route.rs", - "nebula_app/src/ssh_proxy.rs" + "pebrel_app/src/gpui_shell/ssh_settings/advanced.rs", + "pebrel_app/src/ssh_profiles/connection.rs", + "pebrel_app/src/ssh_session/route.rs", + "pebrel_app/src/ssh_proxy.rs" ] }, { @@ -258,10 +258,10 @@ "title": "SFTP 文件传输", "description": "上传和下载文件夹,复制远端文件,处理同名文件并查看进度。", "sources": [ - "nebula_app/src/gpui_shell/workspace/remote_files.rs", - "nebula_app/src/gpui_shell/workspace/remote_files/transfers.rs", - "nebula_app/src/ssh_sftp/transfer.rs", - "nebula_app/src/ssh_sftp/transaction.rs" + "pebrel_app/src/gpui_shell/workspace/remote_files.rs", + "pebrel_app/src/gpui_shell/workspace/remote_files/transfers.rs", + "pebrel_app/src/ssh_sftp/transfer.rs", + "pebrel_app/src/ssh_sftp/transaction.rs" ] }, { @@ -269,9 +269,9 @@ "title": "Android 连接电脑", "description": "配对自己的手机、核对校验码、选择只看或允许输入,并撤销不用的设备。", "sources": [ - "nebula_app/src/gpui_shell/settings_pane/mobile/view.rs", - "nebula_app/src/mobile_connection/preferences.rs", - "nebula_app/i18n/zh-CN.json", + "pebrel_app/src/gpui_shell/settings_pane/mobile/view.rs", + "pebrel_app/src/mobile_connection/preferences.rs", + "pebrel_app/i18n/zh-CN.json", "mobile/android/app/src/main/java/io/github/kuddev/pebrel/mobile/ui/RelayForm.kt", "mobile/android/app/src/main/java/io/github/kuddev/pebrel/mobile/ui/TerminalScreen.kt", "mobile/android/app/src/main/res/values-zh-rCN/pairing.xml", @@ -290,9 +290,9 @@ "title": "浏览与查找文件", "description": "打开项目目录,筛选文件,在指定目录新建终端。", "sources": [ - "nebula_app/src/gpui_shell/workspace/file_tree.rs", - "nebula_app/src/gpui_shell/file_preview.rs", - "nebula_app/src/platform/file_preview.rs" + "pebrel_app/src/gpui_shell/workspace/file_tree.rs", + "pebrel_app/src/gpui_shell/file_preview.rs", + "pebrel_app/src/platform/file_preview.rs" ] }, { @@ -300,16 +300,16 @@ "title": "查看与提交 Git 改动", "description": "查看差异、暂存文件、提交改动并与远端同步。", "sources": [ - "nebula_app/src/gpui_shell/workspace/vcs_panel.rs", - "nebula_app/src/gpui_shell/workspace/vcs_panel/rows.rs", - "nebula_app/src/gpui_shell/workspace/vcs_panel/list_model.rs" + "pebrel_app/src/gpui_shell/workspace/vcs_panel.rs", + "pebrel_app/src/gpui_shell/workspace/vcs_panel/rows.rs", + "pebrel_app/src/gpui_shell/workspace/vcs_panel/list_model.rs" ] }, { "slug": "git-conflicts", "sources": [ - "nebula_app/src/gpui_shell/code_tab.rs", - "nebula_app/src/gpui_shell/workspace/vcs_panel/rows.rs" + "pebrel_app/src/gpui_shell/code_tab.rs", + "pebrel_app/src/gpui_shell/workspace/vcs_panel/rows.rs" ], "title": "解决 Git 冲突", "description": "使用三栏冲突视图整理结果,保存并暂存已解决的文件。" @@ -317,8 +317,8 @@ { "slug": "svn", "sources": [ - "nebula_app/src/gpui_shell/workspace/vcs_panel.rs", - "nebula_app/src/display/side_panel/vcs.rs" + "pebrel_app/src/gpui_shell/workspace/vcs_panel.rs", + "pebrel_app/src/display/side_panel/vcs.rs" ], "title": "使用 SVN", "description": "查看 SVN 工作副本的改动,执行更新和提交。" @@ -328,18 +328,18 @@ "title": "阅读文档", "description": "打开 Markdown,使用目录、代码复制和公式预览。", "sources": [ - "nebula_app/src/gpui_shell/file_editor/mod.rs", - "nebula_app/src/gpui_shell/file_editor/chrome.rs", - "nebula_app/src/gpui_shell/file_editor/code_actions.rs", - "nebula_app/src/gpui_shell/file_editor/tests.rs" + "pebrel_app/src/gpui_shell/file_editor/mod.rs", + "pebrel_app/src/gpui_shell/file_editor/chrome.rs", + "pebrel_app/src/gpui_shell/file_editor/code_actions.rs", + "pebrel_app/src/gpui_shell/file_editor/tests.rs" ] }, { "slug": "markdown-editing", "sources": [ - "nebula_app/src/gpui_shell/file_editor/mod.rs", - "nebula_app/src/gpui_shell/file_editor/chrome.rs", - "nebula_app/src/gpui_shell/file_editor/tests.rs" + "pebrel_app/src/gpui_shell/file_editor/mod.rs", + "pebrel_app/src/gpui_shell/file_editor/chrome.rs", + "pebrel_app/src/gpui_shell/file_editor/tests.rs" ], "title": "编辑 Markdown", "description": "切换到源码,编写标题、列表、表格和公式,保存后预览。" @@ -349,9 +349,9 @@ "title": "查看与粘贴图片", "description": "预览本地图片和附件,把剪贴板图片传给终端中的工具。", "sources": [ - "nebula_app/src/platform/file_preview.rs", - "nebula_app/src/gpui_shell/file_preview.rs", - "nebula_app/src/gpui_shell/terminal/view/image_paste.rs", + "pebrel_app/src/platform/file_preview.rs", + "pebrel_app/src/gpui_shell/file_preview.rs", + "pebrel_app/src/gpui_shell/terminal/view/image_paste.rs", "README.md" ] }, @@ -360,9 +360,9 @@ "title": "编辑服务器上的文件", "description": "从 SFTP 面板打开文本文件,保存修改并处理冲突。", "sources": [ - "nebula_app/src/ssh_sftp/document.rs", - "nebula_app/src/gpui_shell/file_editor/mod.rs", - "nebula_app/src/gpui_shell/workspace/remote_files.rs" + "pebrel_app/src/ssh_sftp/document.rs", + "pebrel_app/src/gpui_shell/file_editor/mod.rs", + "pebrel_app/src/gpui_shell/workspace/remote_files.rs" ] } ] @@ -376,12 +376,12 @@ "description": "启动 Claude Code 或 Codex,用标签、分屏和状态提示管理任务。", "sources": [ "README.md", - "nebula_app/src/ai_agents.rs", - "nebula_app/src/gpui_shell/workspace/agents.rs", - "nebula_app/src/ai_hook/integrations.rs", - "nebula_app/src/gpui_shell/terminal/view.rs", - "nebula_app/src/gpui_shell/terminal/view/agent_activity.rs", - "nebula_app/src/display/program_identity.rs" + "pebrel_app/src/ai_agents.rs", + "pebrel_app/src/gpui_shell/workspace/agents.rs", + "pebrel_app/src/ai_hook/integrations.rs", + "pebrel_app/src/gpui_shell/terminal/view.rs", + "pebrel_app/src/gpui_shell/terminal/view/agent_activity.rs", + "pebrel_app/src/display/program_identity.rs" ] }, { @@ -389,11 +389,11 @@ "title": "支持的 AI 命令行工具", "description": "查看 Pebrel 能识别哪些 AI CLI 和 TUI,以及每个工具有哪些状态、图标和会话功能。", "sources": [ - "nebula_app/src/ai_agents.rs", - "nebula_app/src/ai_hook/integrations.rs", - "nebula_app/src/display/program_identity.rs", - "nebula_app/src/agent_detection/_shared.toml", - "nebula_app/src/gpui_shell/settings_pane/agents.rs" + "pebrel_app/src/ai_agents.rs", + "pebrel_app/src/ai_hook/integrations.rs", + "pebrel_app/src/display/program_identity.rs", + "pebrel_app/src/agent_detection/_shared.toml", + "pebrel_app/src/gpui_shell/settings_pane/agents.rs" ] }, { @@ -401,14 +401,14 @@ "title": "配置 Agent 集成", "description": "检测已安装的工具,配置可用集成并检查状态提示。", "sources": [ - "nebula_app/src/ai_hook/integrations.rs", - "nebula_app/src/gpui_shell/settings_pane/agents.rs", - "nebula_app/src/ai_hook/local/settings.rs", - "nebula_app/src/platform/capabilities.rs", - "nebula_app/src/cli.rs", - "nebula_app/src/ssh_session/integration.rs", - "nebula_settings/src/agent_hooks.rs", - "nebula_app/src/ai_hook/local/runtime_skills.rs" + "pebrel_app/src/ai_hook/integrations.rs", + "pebrel_app/src/gpui_shell/settings_pane/agents.rs", + "pebrel_app/src/ai_hook/local/settings.rs", + "pebrel_app/src/platform/capabilities.rs", + "pebrel_app/src/cli.rs", + "pebrel_app/src/ssh_session/integration.rs", + "pebrel_settings/src/agent_hooks.rs", + "pebrel_app/src/ai_hook/local/runtime_skills.rs" ] }, { @@ -416,11 +416,11 @@ "title": "恢复与分叉 AI 对话", "description": "查找历史会话,恢复先前对话,或从已有上下文继续新任务。", "sources": [ - "nebula_app/src/ai_sessions.rs", - "nebula_app/src/gpui_shell/workspace/session_recovery.rs", - "nebula_app/src/gpui_shell/workspace/tab_menu.rs", - "nebula_app/src/ai_agents.rs", - "nebula_app/src/gpui_shell/workspace/agents.rs" + "pebrel_app/src/ai_sessions.rs", + "pebrel_app/src/gpui_shell/workspace/session_recovery.rs", + "pebrel_app/src/gpui_shell/workspace/tab_menu.rs", + "pebrel_app/src/ai_agents.rs", + "pebrel_app/src/gpui_shell/workspace/agents.rs" ] }, { @@ -428,15 +428,15 @@ "title": "把输出发送给 AI", "description": "选中终端文字,补充问题,再选择接收内容的 Agent。", "sources": [ - "nebula_app/src/gpui_shell/workspace/send_to_chat.rs" + "pebrel_app/src/gpui_shell/workspace/send_to_chat.rs" ] }, { "slug": "agent-worktrees", "sources": [ "docs/runtime-control-api.md", - "nebula_app/src/git_worktree.rs", - "nebula_app/src/gpui_shell/workspace/residency.rs" + "pebrel_app/src/git_worktree.rs", + "pebrel_app/src/gpui_shell/workspace/residency.rs" ], "title": "隔离 AI 工作目录", "description": "为并行任务创建独立 Git worktree,核对目录后分配任务。" @@ -451,9 +451,9 @@ "title": "调整应用外观", "description": "更换主题和图标,选择界面密度、语言与光标样式。", "sources": [ - "nebula_app/src/gpui_shell/settings_pane/appearance.rs", - "nebula_app/src/gpui_shell/settings_pane/appearance_advanced.rs", - "nebula_app/src/gpui_shell/settings_pane/appearance_picker.rs" + "pebrel_app/src/gpui_shell/settings_pane/appearance.rs", + "pebrel_app/src/gpui_shell/settings_pane/appearance_advanced.rs", + "pebrel_app/src/gpui_shell/settings_pane/appearance_picker.rs" ] }, { @@ -461,10 +461,10 @@ "title": "创建和导入主题", "description": "从模板创建配色,调整颜色,导入或导出主题文件。", "sources": [ - "nebula_app/src/gpui_shell/settings_pane/theme_editor.rs", - "nebula_app/src/gpui_shell/settings_pane/theme_transfer.rs", - "nebula_app/src/theme_library/formats.rs", - "nebula_app/src/gpui_shell/settings_pane/theme_advanced.rs" + "pebrel_app/src/gpui_shell/settings_pane/theme_editor.rs", + "pebrel_app/src/gpui_shell/settings_pane/theme_transfer.rs", + "pebrel_app/src/theme_library/formats.rs", + "pebrel_app/src/gpui_shell/settings_pane/theme_advanced.rs" ] }, { @@ -472,9 +472,9 @@ "title": "背景图片与透明度", "description": "选择壁纸、设置铺放方式,并调整图片和终端的不透明度。", "sources": [ - "nebula_app/src/gpui_shell/settings_pane/appearance_advanced.rs", - "nebula_app/src/gpui_shell/settings_pane/setting_help.rs", - "nebula_app/src/gpui_shell/settings_pane.rs" + "pebrel_app/src/gpui_shell/settings_pane/appearance_advanced.rs", + "pebrel_app/src/gpui_shell/settings_pane/setting_help.rs", + "pebrel_app/src/gpui_shell/settings_pane.rs" ] }, { @@ -482,10 +482,10 @@ "title": "字体、字号与间距", "description": "设置中英文字体、调整字号和间距,解决对齐与缺字问题。", "sources": [ - "nebula_app/src/gpui_shell/settings_pane/font_picker.rs", - "nebula_app/src/gpui_shell/settings_pane/appearance.rs", - "nebula_app/src/gpui_shell/settings_pane/appearance_advanced.rs", - "nebula_app/src/gpui_shell/settings_pane/scrolling.rs" + "pebrel_app/src/gpui_shell/settings_pane/font_picker.rs", + "pebrel_app/src/gpui_shell/settings_pane/appearance.rs", + "pebrel_app/src/gpui_shell/settings_pane/appearance_advanced.rs", + "pebrel_app/src/gpui_shell/settings_pane/scrolling.rs" ] }, { @@ -493,10 +493,10 @@ "title": "通知与提醒", "description": "设置 AI 消息、卡片显示时长和终端铃声。", "sources": [ - "nebula_app/src/gpui_shell/settings_pane/notifications.rs", - "nebula_app/src/gpui_shell/settings_pane/setting_help.rs", + "pebrel_app/src/gpui_shell/settings_pane/notifications.rs", + "pebrel_app/src/gpui_shell/settings_pane/setting_help.rs", "README.md", - "nebula_app/src/platform/capabilities.rs" + "pebrel_app/src/platform/capabilities.rs" ] }, { @@ -504,9 +504,9 @@ "title": "鼠标与窗口行为", "description": "调整复制粘贴、鼠标焦点、标签位置和新实例行为。", "sources": [ - "nebula_app/src/gpui_shell/settings_pane.rs", - "nebula_app/src/gpui_shell/settings_pane/setting_help.rs", - "nebula_app/src/gpui_shell/settings_pane/navigation.rs" + "pebrel_app/src/gpui_shell/settings_pane.rs", + "pebrel_app/src/gpui_shell/settings_pane/setting_help.rs", + "pebrel_app/src/gpui_shell/settings_pane/navigation.rs" ] }, { @@ -515,14 +515,14 @@ "description": "创建配置文件,检查语法和字段,修改并重载设置。", "sources": [ "docs/lua-configuration.md", - "nebula_app/src/config/mod.rs" + "pebrel_app/src/config/mod.rs" ] }, { "slug": "config-examples", "sources": [ "docs/lua-configuration.md", - "nebula_app/src/config/mod.rs" + "pebrel_app/src/config/mod.rs" ], "title": "常用配置示例", "description": "复制并调整字体、Shell、环境变量和模块化配色示例。" @@ -532,9 +532,9 @@ "title": "网络与系统代理", "description": "设置连接代理、测试网络,并让新终端使用系统代理环境。", "sources": [ - "nebula_app/src/gpui_shell/network_settings.rs", - "nebula_app/src/update_proxy.rs", - "nebula_app/src/ssh_proxy.rs" + "pebrel_app/src/gpui_shell/network_settings.rs", + "pebrel_app/src/update_proxy.rs", + "pebrel_app/src/ssh_proxy.rs" ] } ] @@ -548,8 +548,8 @@ "description": "列出窗格、发送文本、读取输出,向指定 Agent 分配任务。", "sources": [ "docs/runtime-control-api.md", - "nebula_app/src/runtime_api/cli.rs", - "nebula_app/src/agent_env.rs" + "pebrel_app/src/runtime_api/cli.rs", + "pebrel_app/src/agent_env.rs" ] }, { @@ -557,9 +557,9 @@ "title": "设置索引", "description": "按需要完成的操作查找设置位置,了解何时需要新建会话。", "sources": [ - "nebula_app/src/gpui_shell/settings_pane/navigation.rs", - "nebula_app/src/gpui_shell/settings_pane.rs", - "nebula_app/src/platform/capabilities.rs" + "pebrel_app/src/gpui_shell/settings_pane/navigation.rs", + "pebrel_app/src/gpui_shell/settings_pane.rs", + "pebrel_app/src/platform/capabilities.rs" ] }, { @@ -567,10 +567,10 @@ "title": "更新 Pebrel", "description": "检查新版本,按照当前平台和安装方式完成升级。", "sources": [ - "nebula_app/src/gpui_shell/settings_pane/about.rs", - "nebula_app/src/platform/update_installation.rs", - "nebula_app/src/platform/update_installation/macos.rs", - "nebula_app/src/update_download.rs" + "pebrel_app/src/gpui_shell/settings_pane/about.rs", + "pebrel_app/src/platform/update_installation.rs", + "pebrel_app/src/platform/update_installation/macos.rs", + "pebrel_app/src/update_download.rs" ] }, { @@ -578,14 +578,14 @@ "title": "加密备份与恢复", "description": "创建加密快照、导出迁移文件、选择恢复内容,检查密码与存储平台限制。", "sources": [ - "nebula_app/src/gpui_shell/settings_pane/backup.rs", - "nebula_app/src/gpui_shell/settings_pane/backup/setup.rs", - "nebula_app/src/gpui_shell/settings_pane/backup/view.rs", - "nebula_app/src/gpui_shell/settings_pane/backup/operations.rs", - "nebula_app/src/encrypted_backup.rs", - "nebula_app/src/encrypted_backup/recovery.rs", - "nebula_app/src/backup_remote.rs", - "nebula_app/i18n/zh-CN.json" + "pebrel_app/src/gpui_shell/settings_pane/backup.rs", + "pebrel_app/src/gpui_shell/settings_pane/backup/setup.rs", + "pebrel_app/src/gpui_shell/settings_pane/backup/view.rs", + "pebrel_app/src/gpui_shell/settings_pane/backup/operations.rs", + "pebrel_app/src/encrypted_backup.rs", + "pebrel_app/src/encrypted_backup/recovery.rs", + "pebrel_app/src/backup_remote.rs", + "pebrel_app/i18n/zh-CN.json" ] }, { @@ -593,10 +593,10 @@ "title": "备份与迁移", "description": "备份偏好、主机和命令,将工作环境迁移到另一台电脑。", "sources": [ - "nebula_app/src/brand.rs", + "pebrel_app/src/brand.rs", "docs/lua-configuration.md", - "nebula_app/src/ssh_profiles/exchange.rs", - "nebula_app/src/platform/credentials.rs" + "pebrel_app/src/ssh_profiles/exchange.rs", + "pebrel_app/src/platform/credentials.rs" ] }, { @@ -604,10 +604,10 @@ "title": "数据与凭据", "description": "查看本地数据的用途,管理凭据,检查分享或发送的内容。", "sources": [ - "nebula_app/src/platform/credentials.rs", - "nebula_app/src/gpui_shell/workspace/send_to_chat.rs", - "nebula_app/src/runtime_api.rs", - "nebula_app/src/ssh_profiles/exchange.rs" + "pebrel_app/src/platform/credentials.rs", + "pebrel_app/src/gpui_shell/workspace/send_to_chat.rs", + "pebrel_app/src/runtime_api.rs", + "pebrel_app/src/ssh_profiles/exchange.rs" ] }, { @@ -616,8 +616,8 @@ "description": "处理启动、字体、SSH、文件保存和会话恢复中的常见问题。", "sources": [ "INSTALL.md", - "nebula_app/src/gpui_shell/settings_pane/navigation.rs", - "nebula_app/src/platform/capabilities.rs", + "pebrel_app/src/gpui_shell/settings_pane/navigation.rs", + "pebrel_app/src/platform/capabilities.rs", "docs/runtime-control-api.md" ] },