sdaduanbilei/cc-haha
1
0
Fork 0
mirror of https://github.com/NanmiCoder/cc-haha synced 2026-07-31 16:33:34 +08:00
Code Issues Packages Projects Releases Wiki Activity
cc-haha/docs/desktop/settings.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

8.2 KiB
Raw Blame History

title nav_title description order
设置速查 设置 16 个设置分栏，每栏能配什么、什么时候需要动它。 6

设置速查

点侧边栏最底部的「设置」打开。左边 16 个分栏，顺序固定。这一篇按这个顺序过一遍，说清每栏能配什么、什么时候才需要动它。

服务商

管理模型接入。支持 Claude 官方、ChatGPT 官方、Grok 官方三种账号登录（不需要 API 密钥），也支持填 API 密钥接入任意 Anthropic / OpenAI 兼容的服务商。

第一次用必须来这里，之后基本不用动。详细步骤见连接模型服务。

通用

最常动的一栏，配的都是「用起来顺不顺手」的东西。

设置 → 通用：配色主题、语言、输出风格、默认权限

  • 配色主题 — 六套：纯白（默认）、纸墨、经典暖色、青瓷、墨夜、墨夜蓝。另有「跟随系统」开关，打开后可以分别指定浅色模式和深色模式各用哪一套。
  • 语言 — 界面显示语言。
  • 回复语言 — 让 Claude 始终用某种语言回复，和界面语言分开设。
  • 输出风格 — 默认 / 解释型 / 学习型。「解释型」会额外讲清实现选择和代码库里的模式，「学习型」会让你自己动手写一小段。改完对正在跑的会话不生效，新建会话才用新风格。
  • 默认会话权限 — 新建会话时用哪一档权限模式。每条会话里还能单独改。
  • 推理强度 与 思考模式 — 新会话的默认思考档位。关掉思考模式后，DeepSeek 这类需要显式非思考参数的模型会收到对应设置。
  • 消息发送方式 — Enter 发送（Shift+Enter 换行），或 Ctrl/Cmd+Enter 发送。
  • 系统通知 — 授权确认、回复完成、定时任务结果走系统通知中心。开启时会请求系统权限。
  • 网络 — 三选一：直连（明确绕过系统代理）、系统代理（按目标地址动态遵循系统规则）、手动代理（填 http://user:password@127.0.0.1:7890 这样的地址）。下面还有「AI 请求超时」，默认值不够用时可以加大到 1800 秒。应用自身的更新下载走另一套代理设置，在「关于」里。
  • WebSearch — 联网搜索走哪条路。自动模式会对 Claude 模型优先用原生 WebSearch，失败或换成非 Claude 模型时再用 Tavily / Brave，这两个需要你自己填 API Key。
  • 自动做梦 — 后台定期整理和压缩记忆文件。默认关闭，因为它会额外消耗 token。
  • 界面缩放 — 整体放大缩小，也可以用 ⌘+ / ⌘- 快捷键，⌘0 回到 100%。
  • 数据存储位置 — 低频高级设置。默认用系统目录 ~/.claude，也可以改成你指定的绝对路径。切换后会话记录、技能、MCP、插件、服务商配置全部从新目录读取，需要重启应用生效，两个目录之间不会自动合并或迁移。

同一条会话在「墨夜」深色主题下的样子

H5 访问

在手机浏览器里继续同一条会话。默认关闭。见手机 H5 与 IM 接力。

IM 接入

从微信、钉钉、WhatsApp、Telegram、飞书直接和 Claude 对话，并管理配对用户。见手机 H5 与 IM 接力和IM 接入。

终端

内嵌一个真实的宿主机 Shell，用来装插件、技能、MCP 这类需要命令行的东西。桌面端已经内置 claude-haha 命令，文档里写 claude <参数> 的地方都可以换成 claude-haha <参数>。

Windows 用户可以在这里指定启动 Shell（系统默认 / PowerShell 7 / Windows PowerShell / 命令提示符 / 自定义可执行文件），以及一个 Bash 路径——工具调用 grep、sed 这类 Unix 命令时会用到，通常指向 Git Bash。

MCP

添加外部工具和数据源。支持 STDIO、Streamable HTTP、SSE 三种传输方式，配置范围和 CLI 保持一致：

  • 项目私有 — 只对你生效，但绑定到某一个项目。
  • 项目共享 — 写进项目的 .mcp.json，团队成员共享。
  • 全局用户 — 写进你的全局配置，所有项目生效。

顶部三个数字是服务总数、当前已连接、需要处理。STDIO 类型的命令会直接在你的机器上运行，Node、Python、Bun 这些运行时需要你自己装好并保证在 PATH 里。

Agents

浏览已安装的 Agent，创建自己的。见子 Agent 与任务拆分。

技能

本机所有可用技能，按来源分组，可以直接读技能的正文和源码。见技能与技能市场。

记忆

查看和编辑 Claude 为每个项目写的 Markdown 记忆文件。左边选项目，中间选文件，右边编辑或预览渲染结果。这些文件在 ~/.claude/projects/<project>/memory/，CLI 运行时会加载它们。

会话里也能直接用 /memory 跳到这里。想知道记忆是怎么写入和召回的，看记忆系统。

插件

插件把技能、Agent、Hook、MCP 服务打包在一起。这里能看已安装插件、健康状态和它们各自暴露了哪些能力，支持启用、禁用、更新、卸载，也能多选批量操作。

启用或禁用之后要点一次「应用变更」，才会把插件变更重新应用到当前运行时。

宠物

一只悬浮在桌面上的小机器人。默认关闭。见桌面宠物。

Computer Use

让 Claude 读屏幕、点鼠标、敲键盘。装好运行环境并授予系统权限之前用不了。见Computer Use。

Token 用量

设置 → Token 用量：热力图与统计卡

基于本机 Claude Code 会话记录统计出来的用量看板，全部在本地算，不上传。

  • 顶部是累计 Token 数、峰值、最长任务时长、连续活跃天数。
  • 中间是热力图，可以切每日 / 每周 / 累计三种口径，点某一天看当天的会话数、Token、消息和工具调用。
  • 下面是活动洞察：活跃率、最常用模型、用过哪些技能、新增与缓存命中的 Token 比例、估算成本。估算成本不含未定价的模型，界面上会写明跳过了几个。

Trace

记录每条会话的模型请求链路——请求、响应、状态事件、耗时都留档，用来排查卡住、失败和异常等待。开关不在这一栏：要先在 设置 → 通用 里打开「收集 Agent Trace」，这一栏才会有数据。

开启后新会话会把精简记录写到本机 traces 目录。已有记录在关掉之后仍然能看，只是不再写新的。Trace 列表支持搜索、筛选（全部 / LLM / 工具 / 错误）、单独在新窗口打开，也能删除某个会话的 Trace 而不影响聊天记录。

诊断

出问题时来这里。记录服务端和 CLI 的启动、服务商、会话运行错误。

  • 顶部是日志大小、事件数、24 小时内的警告数、保留策略。
  • 「最近事件」列出具体错误，每条带事件 ID，可以单独复制。
  • 导出诊断包 / 复制错误摘要 / 复制 Issue 报告 — 提 issue 时用后两个，格式已经整理好。
  • Doctor — 检查用户和当前项目的配置状态，只读不修改，给出健康 / 未配置 / 缺失 / 无效的清单。会话里输入 /doctor 也能直接打开。
  • 重置安全 UI 状态 — 只清标签页、主题、缩放这几个可再生的界面键。聊天历史、模型配置、技能、MCP、IM 和 OAuth 始终受保护，不会被它碰到。
  • 本地索引 — 显示 SQLite 派生索引的状态和大小，可以重建。重建只影响索引，不删源对话。

:::info Issue 报告和导出包会尽力脱敏，省略聊天内容、文件内容、完整环境变量和 API 密钥。分享前还是自己扫一眼，看有没有内网域名、用户名或路径。 :::

关于

版本号、更新日志、GitHub 仓库、反馈入口。

「应用更新」会检查 GitHub Releases，下载后自动重启安装。更新下载走的是独立的代理设置，和 设置 → 通用 里的网络设置互不影响——公司网络下更新卡住时，来这里配「高级更新代理」。