设置说明

入口：主窗口或 托盘 → 设置。顶栏可搜索设置项（约 300 条，覆盖下面每一页），按名字直接跳转。下面按 现网左侧导航 逐组说明。

导航总览

设置窗口左侧共 11 组 26 页，对不上名字时以应用里显示的为准：

通用

界面：首选语言（9 种）、主题（见 主题）、主题色/背景色/文字颜色/圆角/字体、恢复默认；开机自启动、关窗最小化到托盘；主窗口显示片段数量；搜索窗口欢迎语与默认宽度、插件窗口默认高度；用户体验改进计划；启动性能（预热截屏窗口、预热搜索窗口、启动时重建剪贴板搜索索引、后台统计、定期清理临时文件）；自定义 CSS。

编辑器：代码编辑器的字号、行高、Tab、字体、编辑器主题、自动换行（开 / 关 / 按列 / 有界）、行号、空白字符、光标样式与闪烁、自定义扩展名映射、自定义主题颜色、自定义语言；富文本编辑器的字号、行高、字体、粘贴时自动转换 Markdown。

图床：截图与富文本的上传目标。支持 11 种服务（sm.ms、GitHub、S3 兼容、阿里云 OSS、七牛、腾讯 COS、UPYUN、Imgur、WebDAV、本地目录、SFTP），每种有自己的凭据字段与默认图床设置。

展开

键盘：展开总闸；触发键与触发键列表、保留触发键、匹配左→右/右→左、大小写自适应、词边界、展开提示音、播放声音、多光标跳转；FillIn 与 FillIn 窗口位置（居中 / 光标）；内联搜索及其位置、最大宽度/高度、内联搜索前缀。

片段：片段相关的全局快捷键，见 快捷键。

语音：语音输入总闸；按住说话热键、麦克风授权；识别渠道（OpenAI Whisper / Groq / 硅基流动 SenseVoice / 智谱 GLM-ASR / 阶跃星辰 / OpenRouter / ZenMux / 自定义，可填端点、Key、模型、语言并测试连接）；说完之后是听写还是展开片段；本机识别引擎（Qwen3 0.6B、Sherpa，含模型下载与镜像、识别语种、空闲保活）；准确度自检（录音、换渠道识别、词表偏置、计算准确率）。

截屏

画面：取色器（默认颜色格式）；边框宽度、遮罩颜色、锚点与描边；窗口自动检测、重叠窗口选择、忽略进程名单、界面元素检测、双击选区进编辑器、子窗口最小宽高；贴图窗口置顶；GIF 录制（分辨率、帧率、质量、最大帧数、鼠标显示与点击高亮、倒计时）；图像质量；手动 / 快速 / 自动保存的目录与文件名模板。

OCR：识别引擎（自动 / PaddleOCR）、模型（Server / Mobile）、运行设备（CPU / GPU）、下载模型与打开目录；结果展示方式（Pin / 插入前台 / 复制 / 模态）。

截屏快捷键：区域、全屏、延迟、应用、滚动截屏与 GIF 录制的全局快捷键。

滚动截图免费每日 3 次；OCR 10 次；GIF 免费 15 秒 + 水印。

剪贴板

基础：启用剪贴板监听；粘贴方式（单击 / 双击）、窗口位置（记住上次 / 屏幕中央 / 跟随鼠标）、选中后保留原剪贴板内容、窗口置顶；复制/粘贴时去除格式、重复内容自动置顶、忽略大于指定大小；历史保留天数、最大条数、清理过期记录、删除历史记录。

窗口

窗口：切换主窗口、切换搜索窗口、切换剪贴板窗口三组全局快捷键。与 片段、截屏快捷键分列，走同一套处理。

AI

模型：默认使用的提供商；逐提供商启用与配置 API 密钥、Base URL、Azure Deployment Name、模型，可拉取模型列表并选默认。

技能：自定义 Prompt 上下文；技能列表（名称、类型、响应格式、提供商、排序、置顶、是否使用 CodeExpander MCP 工具、提示词）。

MCP：应用内对话工具的 AI 工具（MCP）总开关；CodeExpander 作为 MCP 服务端（见 MCP 服务端）。

插件

插件后端：启用 HTTP（常驻）模式、空闲超时、最大常驻后端数、PATH 前缀；运行中的后端列表（刷新 / 停止）。

NPM 发布：npm 访问令牌；从 npm 发现插件；发布表单（选择插件、版本升级类型、包名、发布）。

资料库

同步：第三方存储（GitHub / Gitee 登录或私人令牌；WebDAV 的服务器地址、文件夹、用户名、密码）；自动完整同步与间隔；测试连接、同步到本地、冲突解决（保留本地 / 保留远程 / 合并）；GitHub API 地址与 GitLab 地址。CE Cloud 已迁到 授权。见 同步。

备份：本地自动备份开关、备份内容（仅片段 / 剪贴板全部 / 仅收藏）、备份目录、间隔、最大保留、立即备份。见 本地自动备份。

导入导出：导出 JSON（可选内容）；导入 JSON 或 TextExpander 导出，可选合并或覆盖。分享包见 深链。

存储：当前库身份；片段库 / 截图 / 日志 / 临时目录的位置与打开目录；导出排查日志、复制诊断信息、刷新占用；危险操作里的清空数据与重置应用（重置保留机器 ID 与许可字段）。

开发者

本地接口：启用本地 API、端口、打开 OpenAPI 文档。见 本地 REST API。

运行时：自定义脚本解释器（名称、可执行文件路径与检测、执行模式、执行参数、文件扩展名、测试、从预置添加）。Pro。

授权

单机终身：机器 ID 与激活码、激活与解绑；设备槽位列表（当前设备、解绑、24 小时冷却）；可选绑定微信（验证码、使用微信登录、绑定到当前激活码）；Pro 会员权限。见 激活。

CE Cloud 订阅：订阅状态（个人云同步 / 团队席位与到期）与 CE Cloud 权益；面板里可登录/退出、立即同步、打开网页库、同步我的片段、共享分组、查看设备列表与上次同步时间。见 登录与网页库。

帮助

版本更新：当前版本与检查更新（商店包可能隐藏更新入口）。

常见问题：应用内 FAQ。

技术支持：官方支持频道、联系邮箱，以及是否愿意帮助推广。

使用统计不在设置里，见 统计与检索。没有浏览器扩展设置页（产品没有 Chrome 扩展）。

快捷键

设置 → 快捷键 分三组：窗口、片段、截图（分别对应上面的 窗口、展开 → 片段、截屏 → 截屏快捷键）。与按钮、托盘走同一套处理。

• 窗口：切换主窗口、打开搜索窗、切换剪贴板窗口。搜索窗默认快捷键因平台而异，以设置页显示为准。
• 片段：从剪贴板创建、新建片段、编辑上次展开的片段、再次展开上次内容。每个文件还可绑独立全局热键，适合极高频的几条（Pro）。
• 截图：区域 / 全屏 / 窗口 / 滚动 / 开始或停止 GIF。macOS 区域默认常为 ⌘⇧A。见 截图。

每组都能「重置为默认快捷键」。FillIn 窗：Cmd/Ctrl+Enter 确认。搜索窗：Enter 插入，Esc 关闭。展开总闸见 暂停展开。

主题

设置 → 通用 → 界面 里选一套主题，不是「浅色 / 深色 / 跟随系统」三选一。可选：鎏金、水墨、朱砂、青瓷、靛蓝、大西洋、静谧、插画、深色，以及自定义。自定义可以调主色、背景色、文字颜色、圆角、字体（部分能力要 Pro），改坏了可恢复默认。网页库用同一套配色，也是三栏。见 网页库。

系统托盘

应用常驻托盘。关闭主窗口可 最小化到托盘（设置 → 通用 → 界面），不等于退出。菜单通常包括：打开主窗口、各类截图与 GIF、剪贴板、启用/禁用展开、检查更新（商店渠道可能隐藏）、导出日志。截图进行中托盘可发开始/结束录制。展开总闸与暂停展开是同一开关。

深链

已经安装桌面应用时，别人可以发你一条 codeexpander:// 链接。点开后应用会接住。

没有浏览器扩展。网页登录怎么走，见 登录。

本地 REST API

自己写了个小脚本，想列出本机片段：打开 设置 → 开发者 → 本地接口，打开开关并记下端口。页面上会给出本机地址，浏览器里可以打开接口说明。这份接口 只在这台电脑上 能访问，不会暴露到网上。用来读片段；改库请继续用应用，或走 MCP。和 MCP 是两套服务，端口分开设。

MCP 服务端

想在 Cursor 里让 AI 按规范生成一条片段：打开 设置 → AI → MCP，启用后复制配置片段，贴进 Cursor 或 Claude Desktop。服务 只在这台电脑上 运行。能做的事以应用里的说明为准，常见是查片段、截图、识别文字、插入。搜索窗 AI 助手 也可以打开「使用 MCP 工具」。用它建好的插件会出现在插件列表里。对话用法见 AI。

代码高亮语言列表见 语言支持。