Markon
↓下载

简体中文

English
日本語

简体中文

English
日本語

主题

数据与隐私 ​

Markon 的阅读、渲染、搜索、Git 与审阅状态默认都在本机完成。AI Chat 是唯一会把工作区内容发给外部 Provider 的可选能力。

数据落点 ​

数据默认位置或行为
设置、salt、工作区列表、Provider 配置~/.markon/settings.json
批注、Viewed 状态、Chat threads/messages~/.markon/annotation.sqlite
运行中服务元数据与控制套接字位置~/.markon/server.lock
服务日志~/.markon/logs/markond.log，2 MiB × 当前文件与 3 份备份
主题、面板位置、diff 折叠等纯 UI 偏好当前浏览器存储

可用 MARKON_SQLITE_PATH=/path/to/annotation.sqlite 或桌面设置覆盖数据库路径。

SQLite 是审阅状态的唯一权威 ​

批注与 Viewed 状态不再写入浏览器 LocalStorage：

  • 浏览器操作通过同源 document-state API 写入 SQLite；
  • 未授权时页面保持只读，不会静默降级到另一份本地副本；
  • 开启 Shared 只增加协作者读写与 WebSocket 广播，不切换数据库；
  • 关闭 Shared 不搬移或删除数据。

批注按文件绝对路径关联，Viewed 也以文件路径为 key；Chat 以稳定 workspace id 关联。因此移动文件会改变审阅数据的关联，而仅升级版本或重启服务不应改变它。

AI Chat 会发送什么 ​

只有同时满足以下条件才会产生 Provider 请求：

  1. 在全局设置中配置 Anthropic 或 OpenAI-compatible Provider；
  2. 为当前工作区开启 Chat；
  3. 用户发送消息。

请求可能包含：

  • 用户问题；
  • 当前文档路径；
  • 用户附加的文字选区；
  • @ 引用文件内容；
  • AI 调用 read_file、list_dir、glob、grep 读取的结果；
  • 当前 thread 的历史消息。

渲染、搜索、批注、Viewed、Live 与 Git 不会因此上传。API key 以明文保存在 settings.json，应像其它开发凭据一样保护；不要把该文件提交到仓库或同步到公共位置。

开启 Edit 后，AI 还可以提出 edit_file 精确替换。提案先显示 old/new diff，必须由用户 Apply；应用前重新检查源文件漂移，应用后可尝试 Undo。该工具不能新建、移动、删除文件，也不能执行命令或访问网络。

浏览器权限 ​

  • 未开启 Shared 时，个人批注/Viewed 只对管理员会话开放。
  • 开启 Shared 后，已通过门禁的协作者读写同一 SQLite 数据集。
  • Chat 与 Edit 也必须由工作区开关显式启用。
  • 管理与结构性写操作仍要求管理员会话。

loopback 地址本身不授予管理员身份。详情见访问与权限。

备份 ​

先关闭服务，再复制两个权威文件：

bash
markon shutdown
mkdir -p ~/.markon/backup-manual
cp ~/.markon/settings.json ~/.markon/annotation.sqlite ~/.markon/backup-manual/

冷态备份能保证 settings、数据库与 workspace id salt 属于同一时点。恢复时也应先停服务。

卸载桌面应用或 cargo uninstall 不会自动删除 ~/.markon。

清理已关闭工作区的数据 ​

解除注册不会立刻删除审阅历史。先查看统计：

bash
markon cleanup

命令会统计不属于当前注册工作区的：

  • annotations 与涉及的文件数；
  • Viewed 文件状态；
  • Chat threads 与 messages；
  • 估算 payload 字节数。

确认后才删除；自动化可用 markon cleanup --yes。对于单文件工作区，只有该固定文件被视为 active，父目录中的其它数据不会因目录边界而被错误保留。

WARNING

Cleanup 是不可逆的数据删除。先备份数据库，并确认需要保留的目录已重新注册为工作区。

对公网暴露前 ​

协作者访问码是应用层门禁，不提供链路加密。公网部署至少应：

  • 在反向代理终止 TLS；
  • 登记精确 --entry 或 --trusted-host；
  • 视场景增加网关层认证；
  • 只为需要的工作区开启 Edit、Chat 与 Shared；
  • 保护 settings.json 与数据库文件权限。

配置示例见反向代理。