TJUClaw 更新日志

维护记录 #

10 月 5 日的知识库加载维护。

• 条目很多的知识库现在能正常打开：笔记和文件列表改为压缩传输（几千条的列表从约 2.5 MB 降到约 0.4 MB），网速慢时加载列表的等待上限也从 15 秒放宽到 1 分钟。之前这类知识库在网页和桌面端可能一直加载不出来。
• 超长笔记（接近 20 万字的中文）现在可以正常保存，之前会提示存储不可用。

大型笔记库可以整个搬进来了 #

单个知识库最多 10000 条、单篇笔记最长 20 万字；Obsidian 的图片嵌入能直接显示；tjuclaw 可以把一个文件夹整个导入成新知识库。

• 容量放大：一个知识库最多可以放 10000 条笔记、文件和文件夹（之前是 1000），单篇笔记最长 20 万字（之前是 2 万字）。

• 大库也流畅：条目很多的知识库打开时，侧栏的文件夹默认收起，展开时只显示需要的部分；几千条的库也能秒开。

• Obsidian 图片：笔记里的 ![[图片.png]]、![[图片.png|300]] 和相对路径的 ![](assets/图片.png) 会直接显示知识库里对应的图片，编辑和阅读模式都可以。

• 一个文件夹导入成新知识库：tjuclaw init "我的笔记" ~/vault 后运行 tjuclaw push -C ~/vault。推送会显示进度，个别文件被拒绝时继续推送其余部分并在最后列出；中途断开后重新运行，只会推送剩下的部分，不会重复。CLI 需要更新到 0.1.5（tjuclaw update）。

• 慢速网络上传：网速较慢时上传大文件，不会再在 15 秒后被中断。

已知限制：单个文件仍然最大 8 MB，更大的文件需要拆分或放在其他地方；超过 20 万字的 Markdown 会作为文件保存，可以下载，但不能在线编辑。

用 tjuclaw 像 git 一样读写知识库，表格可以预览了 #

CLI 可以登录账号，把知识库克隆到本地编辑再推送回去，其他 Agent 也能这样操作；xlsx 表格可以在线预览，内容能被搜索和 Agent 读取。

命令行登录

运行 tjuclaw login，终端会显示一个链接和验证码；在已登录的浏览器里打开链接、核对验证码后点“允许”，CLI 就登录好了。

• 这个登录只能读写你的知识库：笔记、文件夹和文件。它不能查看模型密钥、MCP 设置和对话，也不能删除整个知识库。
• 在“设置 › 账户 › 命令行登录”里可以看到每台登录过的设备，随时吊销。登录一年后自动过期。
• 没有浏览器的服务器或自动化任务，可以把令牌放进环境变量 TJUCLAW_TOKEN 使用。

像 git 一样操作知识库

tjuclaw clone "课程笔记" notes
cd notes
# 用任何编辑器修改、新增、移动或删除文件
tjuclaw status
tjuclaw diff
tjuclaw push

• 文件夹是目录，笔记是 Markdown 文件，附件保持原样；新建的 .md 会成为笔记，其他文件会作为附件上传。
• tjuclaw pull 拉取在网页、手机或智能体里做的修改。
• 每次推送都会带上修改时所基于的版本：如果这期间别处改过同一条笔记，不会被覆盖，而是提示冲突；远端版本会保存在 .tjuclaw/conflicts 里，合并后运行 tjuclaw resolve 再推送。
• 删除文件夹时，只有它在知识库里也已经清空才会删除，不会误删只存在于网页上的内容。
• Claude Code、Codex 等其他 Agent 可以按 技能说明 用同样的方式读写你的知识库。

表格

• 上传的 .xlsx 现在可以直接在线预览，按工作表切换，带行号和列标。
• 表格里的文字会被提取出来：搜索能找到，TJUClaw 的智能体也能读到表格内容。

已知限制

• 富文本笔记在本地显示为 Markdown，只能阅读；在本地修改它不会被推送。
• 表格预览显示公式的计算结果，不显示公式和格式；只预览前 1000 行、100 列。
• 单个文件最大 8 MB。
• CLI 需要更新到 0.1.2：运行 tjuclaw update。

tjuclaw update：一条命令升级 CLI #

TJUClaw CLI 升到 0.1.1，与客户端使用同一条版本线，并可以用 tjuclaw update 自行升级。

• 自行升级：运行 tjuclaw update，它会下载本平台的最新版，按发布的 SHA256 校验后原地替换；只想看看有没有新版，运行 tjuclaw update --check。
• 启动时提示：tjuclaw connect 启动时如果发现新版本，会在终端提示一行，不会自动替换正在运行的程序。
• 不会降级：只在线上版本比本机新时才更新。
• 桌面客户端内置的 tjuclaw 不受影响：它随桌面客户端一起更新，tjuclaw update 会提示你更新客户端，而不会替换它。
• 版本号对齐：CLI 从 0.0.30 直接升到 0.1.1，之后和客户端使用同一条版本线。
• 远程终端更稳：终端空闲时的等待改得更短（约 10 秒一次），长时间没有输出也不会被网络边缘断开。

已知限制：装在需要管理员权限的目录（例如 /usr/local/bin）时，tjuclaw update 没有写入权限，需要重新运行安装命令或用管理员权限执行。

一条命令安装 TJUClaw CLI #

macOS、Linux 与 Windows 现在可以用一条命令安装 tjuclaw，把自己的电脑连到 TJUClaw。

把电脑连到 TJUClaw、在网页和手机上打开它的终端，需要先装好 TJUClaw CLI（tjuclaw）。现在不用自己编译了，一条命令即可：

macOS 与 Linux：

curl -fsSL https://tjuclaw-release.zaixi.dev/cli/install.sh | sh

Windows，在 PowerShell 中：

irm https://tjuclaw-release.zaixi.dev/cli/install.ps1 | iex

说明

• 支持 x64 与 arm64（包括 Apple 芯片的 Mac），共六个平台。
• 脚本会先用发布的 SHA256 校验下载内容，不一致就停止，不会替换已有文件。
• 默认装到 ~/.local/bin；Windows 装到 %LOCALAPPDATA%\Programs\tjuclaw 并加入你的用户 PATH，不需要管理员权限。
• 再次运行同一条命令即可升级；可以用 TJUCLAW_VERSION 指定版本、TJUCLAW_INSTALL_DIR 指定目录。
• 下载由我们自己的下载站提供，国内访问不依赖 GitHub。
• 装好后运行 tjuclaw workspace init 和 tjuclaw connect，具体步骤见 CLI 工作空间说明。

已知限制

• Windows 上的远程终端仍是简化模式：命令可以运行，但没有输入回显、行编辑和全屏程序。
• 暂不支持 32 位系统。

维护记录 #

10 月 4 日的云端沙箱维护。

• 云端沙箱的运行镜像现在常驻在所有可运行会话的节点上：之前有一台节点没有缓存当前镜像，落在它上面的新会话要先下载约 5 秒。
• 云端沙箱开始记录每次对话排队等待的原因（同一账号的笔记读写、工作区准备等操作需要依次进行），用于定位“发出消息后几秒才开始回答”的问题。记录中不包含账号、会话或笔记内容。
• 云端沙箱的每个会话现在可以短时使用最多 2 个 CPU 核（之前是半核）：智能体每轮启动时的准备工作受限于半核，比实际需要慢约 8 倍，这是“发出消息后要等几秒才开始回答”的主要原因之一。
• 云端智能体回答完后不再让你多等约 2 秒：之前回复要等工作区保存和笔记同步完成才送达，现在回答一结束就显示，保存和同步在后台继续。

远程终端：在网页和手机上打开电脑的终端 #

连接到账号的电脑现在可以直接在 TJUClaw 里打开终端，并在项目目录中启动。

0.1.5 “远程开发”的第一块拼图：你连到账号的电脑，现在可以在 TJUClaw 里直接打开终端。

怎么用

1. 在电脑上更新 TJUClaw CLI（Windows 和 Linux 桌面客户端 0.1.1 起内置支持远程终端的版本），开放远程终端并保持连接：

   tjuclaw workspace allow terminal.open
   tjuclaw connect
   

   workspace allow 会替换整个许可列表，如果之前开放过其他能力（例如 pi.prompt），请一并写上。

2. 打开“工作”侧栏，在电脑那一行点终端按钮；或者在项目的菜单里选“在终端中打开”，shell 会直接在项目文件夹里启动。

你会看到

• 终端停靠在页面下方，可以拖动调整高度、收起，或开多个标签；一边和 Agent 对话一边看命令输出。
• 手机上终端占满屏幕，底部多一排 Esc、Tab、Ctrl 和方向键，弥补手机键盘缺的按键。
• 网络断开时会自动重连，输出不丢、不重复；进程退出时显示退出码。

安全与限制

• 只有电脑主人在本机开放了 terminal.open 才能打开终端，每次打开都会重新检查；撤销后新终端立即被拒绝。
• shell 只在 workspace init 选定的根目录内启动，但启动后拥有你本机账号的全部权限，请只在自己信任的电脑上开放。
• 电脑不需要开放任何入站端口：终端经 TJUClaw 服务器中转，服务器只在内存中保留最近 1 MB 输出，不写入磁盘。服务器更新时正在运行的终端会结束。
• 每台电脑最多同时开 4 个终端，闲置 30 分钟自动关闭。
• Windows 暂为简化模式：命令可以运行，但没有输入回显、行编辑和 vim 这类全屏程序。Linux 和 macOS 是完整的终端。

“工作”侧栏：主机、项目与文件夹 #

“工作”侧栏改为按主机、项目文件夹和自建文件夹整理对话，可以新建项目、移动对话，并公布 0.1.5 的目标。

侧栏的“工作”现在像文件树一样整理对话：

• 最上面是主机：“云端沙箱”始终在这里；以后连接到账号的电脑也会作为主机出现，并显示是否在线。
• 每台主机下面是它的项目文件夹，项目里是在其中进行的对话；不属于任何项目的对话直接列在主机下。
• 下面是自己建的文件夹，用来整理对话。
• 主机行右侧可以新建项目或新建对话；在项目上点“+”开始的对话会自动放进这个项目。电脑上的项目需要填写文件夹路径，云端项目不需要。
• 对话的“…”菜单里新增“移动到…”，可以放到任意主机、项目或文件夹。项目和文件夹可以重命名和删除，删除后其中的对话会保留。

已知限制：目前项目只用于整理对话。让 Agent 真正在电脑上的项目文件夹里工作，要等连接电脑的功能开放，这是 0.1.5 的第一个里程碑；云端项目暂时也还没有各自独立的工作目录。

另外，文档站首页公布了 0.1.5 的目标：强大的远程开发能力，最终由 TJUClaw 在自己的仓库里完成一次真实改动来验收。

知识库管理、侧栏插件与 MCP 入口 #

点击知识库名称可以直接重命名、导出、导入和删除知识库；侧栏新增插件和 MCP 服务入口；修复手机上侧栏按钮偶尔点不开和输入框盖住侧栏的问题。

知识库管理：点击侧栏顶部的知识库名称，会打开它自己的菜单（手机上从底部弹出），不再跳到设置页。

• 重命名：直接在菜单里修改名称。
• 导出为 ZIP：笔记导出为 Markdown 文件，上传的文件保留原样，文件夹结构不变。富文本文档导出为 Markdown 时会保留标题、列表和段落，部分格式可能丢失。
• 导入：可以选择 Markdown、文本文件或 ZIP 压缩包；压缩包里的文件夹会按原样建立，Markdown 和文本成为笔记，其他文件作为附件上传。空文件和超过 8 MB 的文件会跳过，一次最多导入 400 个文件。
• 删除知识库：需要输入知识库名称确认；删除会永久移除其中的全部笔记、文件和会话，建议先导出备份。
• 知识库设置仍可以从菜单进入。

侧栏：

• “应用”里新增“插件”和“MCP 服务”，打开独立的扩展面板，在插件和 MCP 之间切换；不再需要先进设置。
• “小工具”从侧栏移除。课表、GPA、自习室等校园小工具现在是一个内置插件，在“插件”里点“打开校园小工具”进入。

手机修复：

• 左上角的侧栏按钮偶尔点了没反应：原因是从屏幕边缘拉出侧栏的感应区盖住了按钮的左半边。现在感应区从顶栏下方开始，按钮总能点到。
• 新建笔记主页底部的提问输入框原来会盖在打开的侧栏上，现在侧栏在最上层。

侧栏跟手、图谱可缩放、设置即点即开 #

手机侧栏可以用手指拖动开合；知识图谱可以缩放、平移和查找；设置页重新设计并且不再需要加载；手机上的菜单和面板弹出更顺滑。

手机侧栏：

• 滑出和收起更流畅：动画只交给显卡做位移，不再一边播放脚本动画一边播放样式动画。
• 可以直接用手指拖：在侧栏或旁边的阴影上向左划可以收起，从屏幕左边缘向右划可以拉出。侧栏跟着手指走，松手时按拖动距离和速度决定开合，划得不够会弹回原位。
• 从侧栏打开设置或知识图谱时，侧栏会自动收起，不再挡在后面。

知识图谱：

• 布局重新计算：链接越多的笔记越大，相关的笔记会聚在一起。
• 可以缩放和移动：电脑上滚轮或触控板缩放，拖动画布平移，双击放大；手机上双指缩放、单指拖动。右下角有放大、缩小和适应窗口按钮。
• 鼠标移到一篇笔记上（或用键盘聚焦）会点亮它和直接相连的笔记，其余变淡；顶部可以按标题查找笔记并自动居中。
• 节点可以拖动调整位置；手机上全屏显示。
• 一次最多显示 120 篇笔记（之前是 48 篇）。

设置：

• 打开工作区后，设置、搜索和知识图谱会在空闲时预先加载，点开不再出现“正在加载设置”。
• 重新设计：设置项按组放在圆角卡片里；多选一改为一条分段选择器，开关类设置改为开关；标题和说明层次更清楚。
• 手机上是全屏页面：先列出各个分类，点进去查看，左上角返回。打开时不会自动弹出键盘。

菜单和面板：

• 右键菜单在电脑上从点击处轻轻弹出；手机上的操作菜单和标签页列表从底部滑入。
• 在手机上可以按住这两个面板顶部的横条往下拉来关闭。

已知限制：拖动手势目前只在自动化测试中验证过，还需要更多真机确认；iPhone 上从屏幕左边缘划可能会先触发浏览器自带的返回手势。