| 1 | import type { DocsTrustDict } from "../types"; |
| 2 | |
| 3 | /** 「了解哪些数据会离开本机」页的简体中文词典；与 `en/docs-trust.ts` 逐段对应。 */ |
| 4 | export const docsTrust: DocsTrustDict = { |
| 5 | metaTitle: "了解哪些数据会离开本机 · Codewhale 文档", |
| 6 | metaDescription: |
| 7 | "哪些内容留在本地、模型提供商会收到什么、用量统计发送什么以及如何关闭、审计日志在哪里，以及如何报告安全漏洞。", |
| 8 | bodyClassName: "text-ink-soft leading-[1.9] tracking-wide", |
| 9 | title: "了解哪些数据会离开本机", |
| 10 | lede: |
| 11 | "Codewhale 在你的电脑上运行，只与你选择的模型提供商通信。这一页按目前的实际实现，列出数据分别去了哪里、匿名用量统计包含什么，以及如何关闭它。", |
| 12 | sections: [ |
| 13 | { |
| 14 | id: "boundaries", |
| 15 | title: "你的工作内容去了哪里", |
| 16 | blocks: [ |
| 17 | { |
| 18 | rows: [ |
| 19 | ["留在本机", "运行时、你的工作区、会话历史、快照和审计日志。"], |
| 20 | ["发给你的提供商", "每个回合所需的上下文——你的消息、Codewhale 为这一回合读取的文件和工具结果——直接发给你选定的提供商，中间没有 Codewhale 中转。"], |
| 21 | ["完全留在本地", "使用本地模型（Ollama、vLLM、SGLang）时，推理完全不离开你的机器。"], |
| 22 | ["无需账户", "在本地安装和运行 Codewhale 不需要 Codewhale 账户。"], |
| 23 | ["Plan 模式", "不能修改文件，也不能运行 shell 命令。但它被允许进行的资料查询仍可能访问外部服务。"], |
| 24 | ], |
| 25 | }, |
| 26 | { |
| 27 | p: "你添加的工具可能把数据发到别处：MCP 服务器、网页搜索或钩子都以你的权限运行，能访问到它们能访问的一切。只添加你信任的工具。", |
| 28 | }, |
| 29 | ], |
| 30 | }, |
| 31 | { |
| 32 | id: "telemetry", |
| 33 | title: "了解用量统计会发送什么", |
| 34 | blocks: [ |
| 35 | { |
| 36 | p: "Codewhale 默认开启匿名用量统计，并在你第一次启动时明确告知，写明处理方是 Codewhale 和 PostHog。它具体包含：", |
| 37 | }, |
| 38 | { |
| 39 | rows: [ |
| 40 | ["从不发送", "提示词、回复、代码、diff、文件内容、文件名/仓库名/分支名、路径、模型 id、MCP 服务器名称、API 密钥或令牌、错误信息文本、按键记录，以及任何按回合或按工具的时间线。"], |
| 41 | ["开启时发送", "版本与平台类别、会话时长与结果、以固定类别统计的功能与错误计数，以及一个每 90 天更换一次的随机安装 id。"], |
| 42 | ["发往哪里", "`https://telemetry.codewhale.net/v1/telemetry`，一个第一方服务，源码就在仓库中。它不存储 IP 地址、国家或位置，不保留请求日志，数据保存三个月。"], |
| 43 | ["PostHog", "只有在服务运营方另行配置后，才会转发给 PostHog；转发的字段完全相同，不会多出任何内容。"], |
| 44 | ], |
| 45 | }, |
| 46 | ], |
| 47 | }, |
| 48 | { |
| 49 | id: "turn-off", |
| 50 | title: "关闭用量统计", |
| 51 | blocks: [ |
| 52 | { |
| 53 | code: `codewhale config set telemetry false # stop, and erase the local id and buffer |
| 54 | CODEWHALE_TELEMETRY=0 codewhale # stop for this process, erase nothing`, |
| 55 | lang: "终端", |
| 56 | }, |
| 57 | { |
| 58 | p: "配置项是持久的选择：之后的版本都会沿用，命令行参数或环境变量也无法把它重新打开。你也可以在 `/settings` 中切换。关闭后，保存在你机器上的数据会被删除；已经发送的记录只与刚被删除的那个随机 id 关联，并会在三个月后过期。", |
| 59 | }, |
| 60 | { |
| 61 | p: "想确切看到会发送什么、但又不真的发送，可以在 `~/.codewhale/config.toml` 中设置 `telemetry_endpoint = \"\"`。此后每一批数据都会逐字节写入本机的 `$CODEWHALE_HOME/telemetry/dryrun.jsonl`，不会建立任何网络连接。", |
| 62 | }, |
| 63 | ], |
| 64 | }, |
| 65 | { |
| 66 | id: "audit", |
| 67 | title: "查看本地审计日志", |
| 68 | blocks: [ |
| 69 | { |
| 70 | p: "凭据、审批和提权相关的事件会追加写入 `$CODEWHALE_HOME/audit.log`（默认是 `~/.codewhale/audit.log`）。写入是尽力而为的：写入失败时会记录失败，而不是隐瞒。这份日志从不离开你的机器。", |
| 71 | }, |
| 72 | ], |
| 73 | }, |
| 74 | { |
| 75 | id: "report", |
| 76 | title: "报告安全漏洞", |
| 77 | blocks: [ |
| 78 | { |
| 79 | p: "请把安全问题发送到下方邮箱，不要公开提交 issue。请附上你的 Codewhale 版本（`codewhale --version`），如有复现步骤也请一并提供。", |
| 80 | }, |
| 81 | ], |
| 82 | }, |
| 83 | ], |
| 84 | next: [ |
| 85 | { |
| 86 | href: "/docs/sandbox", |
| 87 | label: "限制命令的访问范围", |
| 88 | note: "各平台上操作系统沙箱实际限制了什么。", |
| 89 | }, |
| 90 | { |
| 91 | href: "/docs/modes", |
| 92 | label: "设置模式与审批", |
| 93 | note: "决定 Codewhale 不经询问可以做什么。", |
| 94 | }, |
| 95 | { |
| 96 | href: "/docs/auth", |
| 97 | label: "连接模型提供商", |
| 98 | note: "选择由谁接收你的回合内容——或者用本地模型让它留在本机。", |
| 99 | }, |
| 100 | ], |
| 101 | sourceNote: |
| 102 | "来源文档：docs/public-surface-facts.json（trust）、docs/TELEMETRY.md、docs/SANDBOX.md · 修改时同步更新 docs-map.ts。", |
| 103 | }; |
| 104 |