提交问题
Bug 报告与功能建议
在 GitHub 上开 Issue：
github.com/Xavierhuang/LingCode/issues
请附上：macOS 版本、LingCode 版本、复现步骤，以及任何错误信息。
文档
README 与指南
查看 README 了解安装与使用。技能指南 介绍斜杠命令。
产品概览与下载：LingCode 首页。完整 功能 页（Mac 与 iPad）。多 Claude Code 会话 与 iPad 远程控制。
讨论
提问与社区
GitHub Discussions 用于提问、讨论想法、分享经验。
FAQ
详细、教育性的答案，覆盖人们在试用 LingCode 前后实际会问的问题。跳转至 入门 · 隐私与数据 · 工作保护 · Agent 能看到和做什么 · 本地模型与离线 · LingCode 对比 · 故障排查。
入门
如何配置 API Key？
首次启动时 LingCode 会提示你选供应商并粘贴 Key。也可以随时在 设置（⌘,）里进入 AI 与供应商。支持 Anthropic、OpenAI、DeepSeek、Gemini、Kimi（全球版或中国版）、Qwen——或本地 Ollama 端点（离线零成本）。
Key 存在 macOS Keychain，由 OS 在静态加密。若启用 iCloud Keychain，会通过 Apple 的端到端加密通道自动同步到你的其他 Mac。LingCode 从不把 Key 写成明文，也从不经我们的服务器中转——它们从 Keychain 直接通过 HTTPS 到达供应商 API。
LingCode 免费吗？可以商用吗？
都可以。LingCode 应用免费下载使用，商用、工作、接客户、生产环境都允许。没有 Pro 付费档、没有席位授权、没有"仅限开源项目"限制。
你向 AI 供应商直接付费（你自己的 Anthropic、OpenAI 或 Gemini 账单），或者用本地 Ollama 零成本。我们不抽成、不对 API 调用加价、不缓存你的 Prompt 再卖。这和 Cursor $20/月订阅模型结构不同——LingCode 免费是因为我们的商业模式不依赖一个 AI 代理层。
系统要求？
系统：macOS 15（Sequoia）或更新。CPU：Apple Silicon（M1 及以上）或 Intel。硬盘：应用本身约 120 MB，本地模型会额外占用（Qwen 2.5 Coder 32B 量化后约 20 GB；更小的模型 4–10 GB）。内存：云端使用 8 GB 起够用，16 GB 舒适，想跑 30B+ 本地模型建议 32 GB+。
Apple Silicon 不需要 Rosetta——LingCode 是完全原生 ARM64。应用已由 Developer ID 签名并公证，Gatekeeper 直接放行。
隐私与数据
我的代码会发到 LingCode 的服务器吗？
不会。LingCode 直连供应商：Prompt 和文件片段从你的 Mac 直接经 TLS 到达 Anthropic、OpenAI、Gemini 或你的本地 Ollama 端点。没有 LingCode 代理，没有中间缓存，没有 embedding 服务器，也没有遥测。
你可以自己验证：使用 Agent 时打开活动监视器的网络标签，或者在终端跑 nettop -J bytes_in,bytes_out -p LingCode。每一个向外的 TLS 连接都指向具名的供应商 API（api.anthropic.com、api.openai.com、generativelanguage.googleapis.com 等），不会指向任何 LingCode 拥有的域名。
这是一个架构选择。因为我们不跑代理，所以也没有可被入侵、被传唤、或把你 Prompt 写到日志里的基础设施。你的代码只穿越你自己选的网络（你的 ISP → 供应商）。
你们会用我的代码或 Prompt 训练模型吗？
不会。LingCode 没有训练流水线、没有数据集收集，也没有任何分析。我们看不到你的 Prompt，因为它们从不经过我们的服务器。
你的 Prompt 适用的隐私条款是供应商的条款。Anthropic 默认不对 API 输入训练。OpenAI 默认也不对 API 输入训练（与 ChatGPT 消费端不同）。Gemini API 有自己的策略。大多数供应商提供企业或零留存模式——在它们的控制台里配置，LingCode 会自动使用，因为我们调用的就是那些 API。
想要真正的零数据留存：用 Ollama + 本地模型。Prompt 永远留在你 Mac 上，一个网络包都不发出去。
我的 API Key 存在哪里？
存在 macOS Keychain，由 OS 静态加密，只有 LingCode 能访问。我们从不把 Key 写成明文、从不经我们云同步、也从不记录。
若启用 iCloud Keychain，Key 通过 Apple 的端到端加密通道同步到你的其他 Mac——LingCode 不参与该同步。这是像 Cursor 这样的 Electron 编辑器做不到的具体事项之一：Keychain 是原生 macOS 框架，需要链接 Security 框架，Electron 应用不能。
LingCode 收集什么遥测？
零。没有分析、没有使用 ping、没有 feature flag 回调、没有崩溃遥测、没有 A/B 实验。应用不会发起任何网络请求，除了：(a) 你配置的 AI 供应商 API，(b) 公证更新源。
工作保护——Agent 搞坏东西怎么办？
Agent 把我的 project.pbxproj 或 Info.plist 搞坏了怎么办？
什么都不会丢。Agent 向项目关键文件（project.pbxproj、Info.plist、build.gradle、AndroidManifest.xml、*.entitlements、*.xcscheme）写入一字节之前，LingCode 把原始文件带时间戳复制到 ~/Library/Application Support/LingCode/WorkProtection/。
三种方式打开恢复面板，挑合你节奏的用：
- 键盘快捷键：⌃⌘R，应用内任意位置可用。可在 设置 → 键盘快捷键 里重映射。
- 菜单：视图 → 工作保护恢复…
- 工具栏按钮：标注 "Recover" 的盾牌图标。默认不在工具栏上以免挤满——右键点击工具栏 → 自定义工具栏…，把它拖进去即可，拖入后跨启动保留。
三种方式都能把面板以 Sheet 形式弹出，显示所有带时间戳的快照、每个快照的预览，以及单独的还原按钮。因为快照与 git 无关，即使 Agent 编辑前你没有提交，也能救回来。
如何撤销 Agent 做的多文件重构？
使用语义化时间回溯撤销。LingCode 为 AI 操作维护独立撤销栈，与编辑器逐击键撤销分开。在聊天面板按 Cmd-Z 一步回退整个 Agent 操作（哪怕它跨 40 个文件）。
实际后果：Agent 完成后你可以继续打字，还能只回退 Agent 的改动而不丢失你自己的编辑。普通编辑器撤销是按击键顺序回滚，会丢你的工作。语义撤销以 Agent 操作为单位，与你的光标位置无关。
能让 Agent 做高风险实验而不动我的主分支吗？
可以——worktree 隔离。在聊天里说"为这个做一个 worktree，在里面试 Swift 6 并发迁移"，LingCode 会：
- 从你当前分支创建一个独立的 git worktree
- 在那个 worktree 里工作——所有编辑都发生在磁盘上的另一个目录
- 在 worktree 里跑测试、构建、验证
- 结束时给你汇总报告
你的主检出毫发无损。你可以选择合并到当前分支、保留分支以便之后审阅，或丢弃——全部一键完成。
Agent 能看到和做什么
Agent 真的能看到我的实时构建错误吗？
能——而且是结构化数据，不是爬取的 stdout。LingCode 的 Agent 把 BuildLogService 当作进程内 Swift 方法调用。它读当前构建日志里带文件路径和行号的错误、警告、诊断对象，直接来自构建系统。
问"上次构建为什么失败？"Agent 读的是实际错误列表，并指向出问题的代码。不用复制 stdout 到聊天，也不用说"把错误发我我帮你看"。Agent 已经有了。
这为什么重要：基于 Electron 的 Agent（Cursor、Continue）只能 spawn("xcodebuild …") 再用正则解析 stdout。这会丢掉结构化错误码、去掉文件路径、落后实时日志、并且在 Apple 改变输出格式时崩掉。进程内访问让 Agent 和 IDE 看到同样的视图。
Agent 真的能驱动调试器吗？
能。LLDB 作为一等工具暴露给 Agent，支持断点、单步、变量检查、REPL 求值。Android 也一样——通过 JDWP 支持的 Kotlin 调试器。
有用的 Prompt 模式：
- "在崩溃的地方设一个断点并跑到那儿。"
- "单步进入下一个调用，告诉我
self.user是什么。" - "这个渲染不对时，把视图层级打出来。"
- "附加到模拟器进程，在
NSException上中断。"
Agent 设断点、跑应用、停在帧上、读变量、在一次聊天里汇报。这是云端 Agent IDE 做不到的，因为调试器会话住在一个它碰不到的原生 UI 里。
当我说"ship 到 TestFlight"时，实际发生了什么？
六个真实步骤，全是原生工具调用：
- 检测活跃 Scheme、Target 和 Bundle ID
- 归档：
xcodebuild archive，目标 Generic iOS Device - 从 macOS Keychain 读取团队 ID 和签名身份
- 如需要，重新签名归档
- 通过
xcrun altool上传到 App Store Connect - 轮询处理状态，Apple 接受构建时汇报
如果哪一步失败，Agent 会给出具体诊断：缺失配置文件、过期签名身份、被拒二进制、构建错误。你可以让 Agent 修它能修的（"重新生成配置文件重试"），它就做。
本地模型与离线
可以离线跑本地模型吗？
可以。LingCode 自带 Ollama 集成。从设置装好 Ollama（如未安装我们可以帮你装），选一个本地模型（Qwen 2.5 Coder、Llama 3、Mistral、CodeLlama、DeepSeek），每一个 AI 功能——聊天、Agent、编辑、记忆、Skills、规则——都跑在 localhost:11434，零网络流量。
使用场景：飞机上、没信号的火车、SCIF、不能把代码带出房间的客户现场、气隔网络、隐私敏感项目。离线时 IDE 不会丢功能——编辑、Git、LSP、构建、调试、测试本来就不靠网络。
Cursor 做不到这个——而且不是 Roadmap 问题。它的 Tab 补全是它服务器上的专有微调模型。它的代码库索引在它的基础设施里。拔掉网线，Cursor 的大部分价值主张就停止工作了。
哪些本地模型写代码最好？
2026 年的粗略指引，Swift / Kotlin / 通用编码：
- Qwen 2.5 Coder 32B——目前最强的开源代码模型。在某些任务上接近 GPT-4 级。量化后约 20 GB RAM。32 GB+ 统一内存的 M 芯片 Mac 推荐。
- Llama 3.1 70B——强力通用模型，需 40 GB+ RAM。适合推理密集任务。
- CodeLlama 34B——较旧但可靠，20 GB。
- DeepSeek Coder 33B——写代码强，20 GB。
- Qwen 2.5 Coder 7B——快，能在 16 GB Mac 上跑，质量明显低于 32B 但日常编辑可接受。
对于 Agent 工作流（工具使用、结构化输出、多步推理），大模型明显更好——推荐 32B+。小模型能聊天，但处理复杂工具编排吃力。
LingCode 对比其他工具
LingCode 和 Cursor 有什么区别？
四个结构性区别，详见 为什么不是 Cursor：
- 信任。LingCode 在 AI 编辑前对关键文件做快照，什么都不是单向的。Cursor 没有编辑前快照、没有针对多文件的语义撤销。
- IDE 感知。LingCode Agent 进程内直接调用原生服务（
BuildLogService、LLDB、SimulatorController）。Cursor Agent shell-out 抓 stdout。 - 无代理。LingCode 用你的 Key 直连 AI 供应商。Cursor 把所有 AI 流量经它的服务器路由，$20/月。
- 本地模型。LingCode 通过 Ollama 全离线。Cursor 的核心功能（Tab、Agent、索引）都需要它的云。
此外：LingCode 是原生 SwiftUI Mac 应用，内置 iOS 模拟器、Android 模拟器、LLDB、Keychain 签名。Cursor 是 Electron 的 VS Code fork，iOS / Android 能力基本没有。
我还需要安装 Xcode 吗？
你需要 Xcode 工具链（SDK、模拟器运行时、签名基础设施、命令行工具），但日常工作不需要打开 Xcode.app。LingCode 封装 xcodebuild、simctl、xcrun、altool 和 LLDB，并提供原生的目的地选择器、签名面板、Scheme 编辑器和调试器 UI。
很多切过来的开发者就把 Xcode 留着当运行时依赖——Xcode.app 的 UI 基本不再打开。
我还需要安装 Android Studio 吗？
不需要。LingCode 直接与 Android SDK 命令行工具（gradle、adb、emulator、avdmanager）交互——只需独立的 Android SDK，不需要 Android Studio IDE。Gradle 构建、AVD 管理、APK/AAB 输出、logcat 流、Kotlin 调试都在 LingCode 内完成。
故障排查
为什么跑不了终端命令？
LingCode 的终端默认使用登录 Shell（/bin/zsh -l），继承你 Profile 的 PATH。如果某命令在 Terminal.app 里能跑但在 LingCode 里不行，几乎都是 PATH 缺失。
修复：
- 在 LingCode 终端跑
echo $PATH对比 Terminal.app - 如果 Homebrew 路径缺失（Apple Silicon 是
/opt/homebrew/bin，Intel 是/usr/local/bin），把eval "$(/opt/homebrew/bin/brew shellenv)"加到~/.zprofile - 重启终端标签
如何从手机控制 Claude Code？
见 远程控制指南——SSH + Tailscale + tmux：
- Tailscale 给你的 Mac 一个稳定的私有 IP，任何网络可达，不用端口转发
- 从 LingCode iPad / iPhone 应用 SSH 到 Mac 的 Tailscale IP
- Mac 上 tmux 跑一个持久的
claude会话，随时接入、断开
结果：从任何地方——床上、咖啡馆、机场——完整掌控聊天，没有云中转，没有暴露端口。