cc-haha/docs/desktop/index.md
程序员阿江(Relakkes) c2cd615824 docs: rebuild the documentation site around two readers
The site had drifted from the product. Every screenshot predated the
v0.5.0 UI redesign, the reading experience shipped no search and no
syntax highlighting, and a third of the pages were internal process
artefacts — migration task lists addressed to agentic workers, a
release runbook, a proposal marked "historical".

Reorganise around the only two people who read this: someone getting
the desktop app running for the first time, and someone reading the
source. Five sections replace nine — start / desktop / im / cli /
internals — and the pages that served neither reader are gone.

Site rewrite:

- Palette lifted from the desktop app's 「纸·墨·印」 themes, so the
  site and the product read as one thing. Light mirrors 纯白, dark
  mirrors 墨夜, and dark mode exists at all now.
- Fonts are self-hosted. The old @import from Google Fonts is
  unreachable from mainland China, which left every heading in a
  fallback serif; it also only requested weight 600 while the CSS
  asked for 900, so Latin and CJK in the same heading disagreed.
- Docs were shipped as one 968KB manifest downloaded on every page
  view. Split into a 32KB index plus one lazily imported chunk per
  page; the entry bundle is now 101KB gzipped.
- Add search, syntax highlighting, per-route meta with canonical and
  hreflang, a sitemap, and an error boundary. Replace the 44vh
  mobile sidebar with a drawer.
- Image dimensions are read at build time and written into the tag,
  so lazy images reserve their space instead of collapsing.

Screenshots are recaptured from a real v0.5.0 build against a clean
demo project, with tokens, QR codes and paired accounts redacted.
The previous set is deleted rather than kept alongside.

Routes follow file paths, so the restructure would have broken every
inbound link; 37 old paths redirect, in both languages. The PR policy
gate and CODEOWNERS also hardcoded docs/guide/contributing.md.

Verified: check:docs 78 pages / 323 links / 0 problems, check:policy
127 pass. Walked every route at 1440 and 390 in both themes for
overflow, contrast, keyboard reachability and focus management.
2026-07-27 17:32:41 +08:00

45 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: 桌面端功能总览
nav_title: 功能总览
description: 一屏看懂桌面端有哪些能力,以及每个功能该翻哪一篇。
order: 0
---
# 桌面端功能总览
桌面端把「和 Claude 说话」和「看它到底改了什么」放进同一个窗口左边是项目和历史会话中间是对话右边随时能拉出文件、Diff 和网页预览。
这一篇是地图,不是说明书。每个功能只写一句话,想细看点进去。还没装好或还没连上模型,先去[开始使用](../start/index.md)。
## 先认识三块地方
- **左侧边栏**:品牌印章下面是「新建会话」「定时任务」「技能市场」,再往下是搜索条和你的项目、历史会话,最底部是「设置」。边界可以拖动改宽窄。
- **标签栏**:多个会话并排,像浏览器一样切换。右侧四个按钮分别是活动面板、打开项目、打开终端、显示/隐藏工作区。
- **输入框工具栏**:从左到右是附件、权限模式、运行位置、上下文用量环、模型与推理强度,最后是运行按钮。
## 每天都会用到
- [会话、权限与审阅](./sessions.md) — 怎么开一条会话、工具调用卡怎么看、权限弹窗点哪个、改错了怎么撤销。
- [工作区](./workspace.md) — 右侧那块面板已更改文件、Diff 评审、行级评论、独立工作树、内置浏览器。
- [设置速查](./settings.md) — 16 个分栏一栏一段包括主题、语言、代理、终端、MCP、Token 用量。
## 让它替你干更多活
- [子 Agent 与任务拆分](./agents.md) — 什么时候该派 Agent内置 Agent 有哪些,怎么捏一个自己的。
- [技能与技能市场](./skills.md) — 技能是什么、和 Agent 有什么区别、从市场装技能前要看什么。
- [定时任务](./schedule.md) — 让 Claude 每天早上自动跑一遍代码审查。
- [Computer Use](./computer-use.md) — 让它读屏幕、点鼠标、敲键盘,替你操作别的应用。
## 换个设备继续
- [手机 H5 与 IM 接力](./remote.md) — 扫码在手机浏览器里继续同一条会话或者从微信、飞书、Telegram 直接对话。
- [IM 接入](../im/index.md) — 五个平台各自的详细配置步骤。
## 让它顺眼一点
- [桌面宠物](./pets.md) — 一只悬浮在桌面上的小机器人,用动作告诉你任务跑到哪了。默认关闭。
## 想知道它是怎么实现的
上面几篇讲的是「怎么用」。想看架构、想改代码,从[架构总览](../internals/index.md)进,桌面端自己的进程边界在[桌面端架构](../internals/desktop.md)。