文档
核心概念

LinkCode 的工作原理

LinkCode 在随桌面应用分发的本地 host 进程中运行你的编码智能体,所有客户端——包括远程客户端——都与这个 host 通信。

LinkCode 由两部分组成:真正干活的 host 进程,以及你用来查看和操控它的客户端。理解这个分工,就能理解 LinkCode 今天能做什么、不能做什么。

host

host(即 LinkCode daemon)是运行在你机器上的单个本地进程。它启动并管理你的编码智能体,保存每个线程(与智能体的一段对话)的状态,并与连接上来的每个客户端通信。

桌面应用自带 host 并自动启动它——没有额外要装或要启动的东西。它默认监听 127.0.0.1(你自己的机器)的 19523 端口,端口被占用时向上寻找。客户端从 ~/.linkcode/runtime.json 读取真实端口,而不是假定某个端口,所以通常你无需手动配置连接。

同一份安装同时只运行一个 host。从源码构建的 LinkCode 使用自己的目录和端口区间,可以与已安装的正式版并存而互不干扰。

客户端

客户端就是你实际看到的那个应用。LinkCode 正式分发的客户端是桌面应用,本文档通篇描述的也是它。多个客户端可以同时连接同一个 host,并看到同一份实时线程状态。

登录 LinkCode Cloud 后,侧边栏会多出一个 Remote access 区块,列出你名下当前在线的 host,已登录的桌面应用可以连到其中之一,而不是本地 host。

开发中

浏览器客户端和移动应用已在开发中,但尚未分发——目前都还装不了。

你的代码和数据在哪里

  • 智能体在你的机器上、针对你的本地文件运行,身份就是运行 host 的那个操作系统用户。它们读写文件的过程完全不经过远程服务器。
  • 凭据——API key、provider 账号、你的 Cloud 登录态——保存在 host 上的加密存储里,由你操作系统钥匙串中的密钥解锁。见本地数据
  • LinkCode 不会上传你的代码。host 直接在磁盘上读写文件,不会把工作目录同步到任何地方。
  • LinkCode 的任何功能都不强制要求账号。登录 LinkCode Cloud 会带来账号级能力(远程访问、消息平台),但不改变智能体在哪里运行。

host 在磁盘上保留的完整文件清单以及如何重置,见本地数据

本页目录