Paperclip 的反馈投票数据保存在哪里如何用 CLI 查看和导出本地投票记录【免费下载链接】paperclipThe open-source app everyone uses to manage agents at work项目地址: https://gitcode.com/GitHub_Trending/papercl/paperclip你在 Paperclip 里对 agent 的回复点了Helpful赞或Needs work踩之后可能想知道这些投票到底存在哪里能不能在终端里快速看一份汇总能不能把全部投票连同上下文快照打包导出来备份或交给分析流程。本文基于 docs/feedback-voting.md 和 doc/CLI.md给出数据存储位置 → CLI 查看 → CLI 导出这条可核对的路径。前提是你有一个正在运行的本地 Paperclip 实例以及可用的paperclipaiCLI仓库内用pnpm paperclipai脚本或已安装的npx paperclipai/paperclipai。投票数据保存在哪里每次投票都会在本地 Paperclip 数据库中产生两条记录全部随你的运行实例保存在本机除非你显式选择分享否则不会离开你的机器记录内容Vote投票你的投票方向up/down、可选的原因文本、分享偏好、consent 版本、时间戳Trace bundle跟踪包完整上下文快照被投票的评论/文档修订文本、issue 标题、agent 信息、你的投票与原因——足以孤立理解这条反馈物理位置上本地 Paperclip 数据位于选定的实例根目录下。PAPERCLIP_HOME默认~/.paperclip决定主目录PAPERCLIP_INSTANCE_ID决定实例内嵌 PostgreSQL 数据就在实例根目录的db/下见 doc/CLI.md 的 Local Storage Defaults 一节~/.paperclip/ # PAPERCLIP_HOME └── instances/ └── default/ # 实例根目录 ├── db/ # 内嵌 PostgreSQL 数据 └── ...投票本身没有独立的投票表文件可以直接 cat而是通过 CLI 和 API 从数据库读取。每条投票还有一个导出状态决定它是否会被上传状态含义local_only仅本地保存未标记分享pending已标记分享等待立即上传尝试sent已成功传输failed传输失败如后端不可达后台 flush worker 后续重试无论状态如何本地数据库始终保留完整的投票与 trace 数据。标记为 keep local 的投票永远不会进入导出队列。用 CLI 查看本地投票记录快速报告最直接的方式是终端报告命令# 仓库内开发脚本形式 pnpm paperclipai feedback report # 已安装 CLI paperclipai feedback report报告是带颜色的汇总票数统计、每条 trace 的详情含原因以及导出状态。如果没有任何投票报告会显示No feedback traces found.。常用变体# 指向另一个 server 或公司 npx paperclipai feedback report --api-base http://127.0.0.1:3000 --company-id company-id # 在报告中包含原始 payload 转储 pnpm paperclipai feedback report --payloads其中company-id替换为你公司的实际 ID。若不传--company-idCLI 会依次使用PAPERCLIP_COMPANY_ID环境变量或 CLI context 默认值可用npx paperclipai context set --api-base ... --company-id id配置见 docs/cli/overview.md。通过 API 端点核对单条数据CLI 报告之外可以直接用 API 查看便于脚本化核对。以下端点都需要 board-user 权限本地开发环境自动满足。注意 docs/feedback-voting.md 的示例使用127.0.0.1:3102端口而文档其他位置给出的默认服务器端口是3100见 docs/deploy/environment-variables.md请替换为你实例实际的 api-base# 列出某个 issue 的全部投票 curl http://127.0.0.1:3102/api/issues/issueId/feedback-votes # 列出某个 issue 的 trace bundles含完整 payload curl http://127.0.0.1:3102/api/issues/issueId/feedback-traces?includePayloadtrue # 列出全公司的 trace curl http://127.0.0.1:3102/api/companies/companyId/feedback-traces?includePayloadtrue # 获取单条 trace 记录 curl http://127.0.0.1:3102/api/feedback-traces/traceId # 获取一条 trace 的完整导出 bundle curl http://127.0.0.1:3102/api/feedback-traces/traceId/bundletrace 端点支持的查询参数参数取值说明voteup、down按投票方向过滤statuslocal_only、pending、sent、failed按导出状态过滤targetTypeissue_comment、issue_document_revision按被投票对象类型过滤sharedOnlytrue只看用户选择分享的投票includePayloadtrue包含完整上下文快照from/toISO 日期日期范围过滤另外doc/CLI.md 列出了按 ID 直接取单条记录的形式适合自动化导出流程npx paperclipai feedback trace trace-id npx paperclipai feedback bundle trace-id按 issue 查看投票也有专门命令npx paperclipai issue feedback:votes issue-id用 CLI 导出本地投票记录导出到文件 zippnpm paperclipai feedback export默认导出为全量会创建一个带时间戳的目录和一个同名 zip。文档给出的目录结构示例如下目录名为文档示例实际按运行时间生成feedback-export-20260331T120000Z/ index.json # 清单含汇总统计 votes/ PAP-123-a1b2c3d4.json # 投票元数据每条投票一个文件 traces/ PAP-123-e5f6g7h8.json # Paperclip feedback envelope每条 trace 一个文件 full-traces/ PAP-123-e5f6g7h8/ bundle.json # 该 trace 的完整导出清单 ...raw adapter files # 可用时的 codex / claude / opencode 会话原始文件 feedback-export-20260331T120000Z.ziptraces/保留 Paperclip envelopefull-traces/包含更丰富的逐条 bundle 以及可恢复的 adapter 原生文件。指定自定义服务器与输出目录npx paperclipai feedback export --api-base http://127.0.0.1:3000 --company-id company-id --out ./my-export两个执行层面的注意点输出目录必须不存在或为空已存在非空目录会直接报错不会覆盖旧导出导出只读取本地数据库并写入--out指定位置不修改数据库本身。验证导出结果导出完成后命令会打印一段Paperclip Feedback Export摘要列出公司 ID、输出目录、zip 路径以及 thumbs up / thumbs down / with reason / unique issues 计数和文件数量。进一步的核对方式打开导出目录中的index.json它是清单文件包含exportedAt、serverUrl、companyId、汇总统计以及files下 votes/traces/fullTraces/zip 的完整文件列表打开traces/中任意文件查看上下文快照。文档示例值为示例不是固定预期{ id: trace-uuid, vote: down, issueIdentifier: PAP-123, issueTitle: Fix login timeout, targetType: issue_comment, targetSummary: { label: Comment, excerpt: The first 80 chars of the comment that was voted on... }, payloadSnapshot: { vote: { value: down, reason: Did not address the root cause }, target: { body: Full text of the agent comment... }, issue: { identifier: PAP-123, title: Fix login timeout } } }打开full-traces/issue-trace/bundle.json可以看到扩展的导出元数据capture notes、adapter 类型、完整性元数据、写入的原始文件清单。bundle.json.files[]中每个条目把捕获的文件内容放在contents字段里而不是只有路径文本产物以 UTF-8 存储二进制产物用 base64 加encoding标记。内置本地 adapter 会直接导出原生会话文件例如codex_local的adapter/codex/session.jsonl、claude_local的adapter/claude/session.jsonl含 sidecar 与debug.txt若存在、opencode_local的adapter/opencode/session.json等。限制与边界分享偏好按公司保存首次投票时由 consent 对话框选择 Keep local 或 Share this vote之后可随时在反馈设置中更改标记分享的 trace 会尝试立即上传到 Telemetry Backend未配置后端 URL 时回退到https://telemetry.paperclip.ing失败会进入failed状态等待重试。上传的是投票时刻的快照如果底层 adapter 会话文件之后继续增长本地重新生成的 bundle 可能比已上传快照更大已分享对象在远端对象存储中的 key 为确定性模式feedback-traces/companyId/YYYY/MM/DD/exportId-or-traceId.json便于核对上传结果端口提示再次说明本文 curl 示例沿用了 docs/feedback-voting.md 原文的3102若你的实例按默认端口运行请把 host:port 替换为实际 api-base。完成一次feedback report确认计数与状态、再跑一次feedback export核对index.json与实际文件就是这条数据从产生、查看到导出的完整闭环验证。【免费下载链接】paperclipThe open-source app everyone uses to manage agents at work项目地址: https://gitcode.com/GitHub_Trending/papercl/paperclip创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考