TJUClaw 更新日志

维护记录 #

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

• 云端沙箱的运行镜像现在常驻在所有可运行会话的节点上：之前有一台节点没有缓存当前镜像，落在它上面的新会话要先下载约 5 秒。
• 云端沙箱开始记录每次对话排队等待的原因（同一账号的笔记读写、工作区准备等操作需要依次进行），用于定位“发出消息后几秒才开始回答”的问题。记录中不包含账号、会话或笔记内容。

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

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

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

怎么用

1. 在电脑上更新 TJUClaw CLI，开放远程终端并保持连接：

   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 上从屏幕左边缘划可能会先触发浏览器自带的返回手势。

TJUClaw 0.1 #

第一个 0.1 版本：Agent 可以接入 MCP 服务和技能，会话过程实时可见，界面更流畅，桌面端和安卓安装包同步更新。

TJUClaw 升到 0.1。网页端已经是这个版本；桌面端会提示更新，安卓安装包需要重新下载；macOS 安装包暂不提供。

这一版主要包括：

• Agent 可以接入外部工具：在设置的“MCP 服务”里添加 DeepWiki、Context7、Exa 网页搜索、高德地图、GitHub，或任何公网的 MCP 地址。
• Agent 技能：在设置的“插件”里启用考前复习、实验报告、参考文献格式、文献精读、课程项目调试、英文写作润色，遇到相符的任务时 Agent 会先读取做法。
• 会话：回合进行中实时显示思考、工具调用和回复，修改笔记的步骤标出改了多少字；会话可以重命名和删除。
• 更流畅：整个界面都交给 React 编译器优化，状态变化时只重画用到它的部分；长会话里离屏幕远的消息不参与重绘。
• 打开网站直接是登录页；网页端和桌面端会自己发现新版本，并列出更新内容。
• 手机：笔记主页底部可以直接提问；键盘、返回键和搜索面板做了修正。

已知限制：

• 手机键盘弹出时的显示已在安卓 Chrome 上确认（浅色和深色）；iPhone 和添加到主屏幕的应用还需要更多确认，遇到问题欢迎反馈。
• 安卓安装包暂时没有应用内更新。
• 连接本机或云端完整系统环境的“系统工作空间”还没有开放。

插件：为 Agent 启用技能 #

设置的“插件”里可以启用六个经过审核的技能，Agent 遇到相符的任务时会先读取技能里的做法再动手。

设置的“插件”一栏新增了技能。技能是写好的做事方法，启用后，Agent 遇到相符的任务会先读取它的步骤和要求再动手，会话步骤里会显示“读取技能「实验报告」”这样的一步。没用上的技能不会影响对话。

首批六个技能：

• 考前复习：结合考试安排、课表空闲和你的课程笔记排复习计划，提炼重点，出自测题。
• 实验报告：按目的、原理、步骤、数据处理、误差分析和结论整理，不会编造测量数据。
• 参考文献格式：按 GB/T 7714—2015 整理和核对参考文献，缺的信息会标出来而不是猜。
• 文献精读：按固定结构写读书笔记，作者的结论和自己的评价分开写。
• 课程项目调试：先在沙箱里复现，再定位、最小修改、用测试验证。
• 英文写作润色：保持原意修改，并列出主要修改和原因。

已知限制：目前只有这六个技能，暂不支持安装第三方插件或运行插件代码。

接入 MCP 服务，让 Agent 用上外部工具 #

设置里新增“MCP 服务”，可以从精选目录或按地址接入远程 MCP 服务，Agent 在对话中按需调用它们的工具。

设置里新增了“MCP 服务”一栏。接入后，Agent 会在对话里按需调用这些服务的工具，每次调用都会显示在会话步骤里，标成“服务 · 工具”。

精选目录：首批有五个服务。DeepWiki 用来读懂 GitHub 上的开源项目，Context7 用来查编程库的最新文档，Exa 用来搜索网页和读取页面，这三个不填密钥也能用。高德地图可以搜索地点、规划路线和查天气，需要高德开放平台的 Web 服务 Key；GitHub 可以浏览仓库、管理 Issue 和 Pull Request，需要你自己的个人访问令牌，能做什么取决于令牌的权限。

自定义服务：也可以填写任何公网 HTTPS 的 MCP 地址（Streamable HTTP），并按服务要求选择不填密钥、Bearer 令牌、自定义请求头或 URL 参数。添加后可以随时检查连接、查看它提供的工具、暂停或移除。

密钥：保存在服务器上，只用于访问对应的服务，不会显示在浏览器里，也不会写进笔记或进入沙箱。

已知限制：还不支持需要 OAuth 登录的服务和旧版 SSE 端点；每个账号最多接入 12 个服务，每个服务最多提供 40 个工具。技能插件见同日的另一条更新。

更新提醒列出真正的新内容 #

网页端“新版本已就绪”提示里的更新内容改为来自更新日志，不再每次都显示同样几行。

之前网页端的更新提示读的是随网页一起发布的一份固定摘要。网页端每次部署的版本号相同，这份摘要又没有每次更新，所以最近几次更新提示的内容都一模一样，和实际改动对不上。

现在提示里列出的是更新日志中你还没在提示里看到过的条目，最新的在前，最多四条。点“刷新”后这些条目算作已看过，下一次更新不会再列出来。每天的维护记录只涉及用户看不到的后台改动，不会出现在提示里。

已知限制：每条更新日志在改动上线后才发布，所以刚部署完时提示里可能还没有这次的条目，下一次更新时会补上。桌面安装包的更新提示仍然显示随版本发布的摘要。

刷新后编辑笔记可以正常保存 #

修复网页端刷新后直接编辑上次打开的笔记时提示“保存失败”的问题。

刷新网页或重新打开应用后，上次打开的笔记会先从本机缓存显示出来。此前如果这时直接编辑这篇笔记，保存会在发出请求之前就失败，界面提示“保存失败”和“尚未保存”，Git 同步状态也随之停住。现在这篇笔记可以像其他笔记一样正常保存。

如果本机缓存的是旧版本，而服务器上已有更新的内容，保存时仍会提示冲突，不会覆盖服务器上的版本。

之前因此没能保存的内容还留在编辑器里。刷新前请先复制一份；更新后点“重试保存”即可。