文档
核心概念

LinkCode 的工作原理

LinkCode 在你机器上的本地 host 进程中运行你的编码智能体,桌面应用作为客户端连接到它。

LinkCode 有两个运转的部分:一个完成实际工作的 host(即 LinkCode daemon)进程,以及一个你用来查看和控制它的客户端。理解这种拆分,就能理解 LinkCode 今天能做什么、不能做什么的大部分内容。

host

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

host 只在 127.0.0.1(你自己的机器)上监听,默认端口为 19523。它从不绑定到网络可达的地址。如果该端口已被其他程序占用,host 会向上寻找下一个空闲端口。每个客户端——今天就只有桌面应用——都连接到这个本地地址来读取和驱动你的线程。

桌面应用会自动连接到 host:它会查找在 ~/.linkcode/runtime.json 中通告的正在运行的 host(该文件记录它实际绑定的端口),如果没有任何通告,则回退到默认端口。通常你无需手动配置连接。

让 host 跑起来

v0 目前 host 暂无安装包——你需要从源码仓库的克隆运行它。当前的设置步骤见快速上手

客户端

客户端就是你实际看到的应用。**桌面端是 LinkCode 今天唯一分发的客户端。**本文档通篇描述的都是它。

开发中

一个基于浏览器的客户端和一个移动应用正在开发中,但尚未分发——今天这两者你都无法安装或使用。通过 LinkCode Cloud 远程访问你的 host(例如从一部不在同一台机器上的手机)同样在开发中。今天没有任何受支持的方式能让你从浏览器或手机使用 LinkCode。

多个客户端可以同时接入同一个 host,它们都能看到同样的实时线程状态——这是更多客户端发布后的设计目标,目前还不必据此做规划。

你的代码和数据存放在哪里

  • 智能体运行在你的机器上,针对你的本地文件,以运行 host 的同一个操作系统用户身份执行。它们读取或编辑文件的过程完全不经过远程服务器。
  • 如果你为某个智能体配置了 API key,它会存储在一个本地文件——~/.linkcode/config.json——中,只有你的用户账户能读取。
  • LinkCode 不会上传你的代码。host 直接在磁盘上读写文件;它不会把你的工作目录同步到任何地方。
  • 今天 LinkCode 中没有任何功能需要账户。桌面应用的 LinkCode Cloud 登录正在开发中,且仅涉及账户身份——没有任何 LinkCode Cloud 功能会改变你的代码或智能体流量的去向。

host 在磁盘上保存的完整文件列表以及如何重置它们,见本地数据

本页目录