SUPPORT · START HERE
先把事情解决掉。
安装、启动和命令行问题通常只需要确认一个路径或重新打开终端。下面是最短排查路线;如果仍然卡住,我们会在公开仓库继续帮你。
安装与更新
如果你从 Microsoft Store 安装,Windows 负责安装、签名验证与更新;从开始菜单打开 moeSegFault Scrap。不要把商店包解压后手动运行其中的文件。
GitHub Releases 提供 Windows MSI 以及 macOS、Linux 归档。只从项目发布页取得匹配系统架构的资产;普通升级会保留已有 record。
启动与本地服务
先启动桌面应用,或在新终端运行 scrap --help。scrapd 是按需启动的本地守护进程,不需要你单独安装服务,也不应手动常驻运行。
如果应用未响应,完整退出桌面端后重试。仍然失败时,记录 Scrap 版本、操作系统版本和不含敏感内容的原始错误文字。
scrap --helpscrap scope list数据在哪里
record 数据与运行状态位于当前用户的 ~/.scrap;Windows 通常是 %USERPROFILE%\.scrap。普通升级或卸载不会删除这个目录。
数据库在 ~/.scrap/data/scrap.db,daemon 日志在 ~/.scrap/log/scrap.log。不要把数据库、key-reference 或完整日志上传到 issue。需要彻底移除数据时,请先确认备份,再明确删除 ~/.scrap。
找不到 scrap 命令
商店版本通过应用执行别名(App Execution Alias)提供 scrap.exe,通常由 Windows 映射到 %LOCALAPPDATA%\Microsoft\WindowsApps。安装后请关闭并重新打开终端;仍找不到时,在 Windows“设置 → 应用 → 高级应用设置 → 应用执行别名”中确认 scrap.exe 已启用。无需进入受保护的包目录。
MSI 版本通常安装到 %LOCALAPPDATA%\Scrap,并把该目录加入当前用户 PATH;macOS 与 Linux 的归档安装器通常使用 ~/.scrap/bin。PATH 变化只会在新进程中生效。
where scrapGet-Command scrapcommand -v scrap还没有解决?
带着可复现信息来找我们。
GitHub Issues 是本项目的支持入口。请提供 Scrap 版本、操作系统、安装来源、最短复现步骤、预期行为和已经脱敏的实际结果。
Issues 完全公开。绝对不要粘贴 secret、访问令牌、密码、私钥、record value、数据库、原始日志或个人数据。发布前也请移除用户名、主机名和私有路径。
如果问题本身敏感,请先只提交一条完全脱敏的联系请求,说明版本和问题类别,并请求维护者提供合适的非公开沟通方式;不要在公开 issue 中解释敏感细节。
前往 GitHub Issues