单个知识库最多 10000 条、单篇笔记最长 20 万字；Obsidian 的图片嵌入能直接显示；tjuclaw 可以把一个文件夹整个导入成新知识库。
-
容量放大：一个知识库最多可以放 10000 条笔记、文件和文件夹（之前是 1000），单篇笔记最长 20 万字（之前是 2 万字）。
-
大库也流畅：条目很多的知识库打开时，侧栏的文件夹默认收起，展开时只显示需要的部分；几千条的库也能秒开。
-
Obsidian 图片：笔记里的 ![[图片.png]]、![[图片.png|300]] 和相对路径的  会直接显示知识库里对应的图片，编辑和阅读模式都可以。
-
一个文件夹导入成新知识库：tjuclaw init "我的笔记" ~/vault 后运行 tjuclaw push -C ~/vault。推送会显示进度，个别文件被拒绝时继续推送其余部分并在最后列出；中途断开后重新运行，只会推送剩下的部分，不会重复。CLI 需要更新到 0.1.5（tjuclaw update）。
-
慢速网络上传：网速较慢时上传大文件，不会再在 15 秒后被中断。
已知限制：单个文件仍然最大 8 MB，更大的文件需要拆分或放在其他地方；超过 20 万字的 Markdown 会作为文件保存，可以下载，但不能在线编辑。
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 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 没有写入权限，需要重新运行安装命令或用管理员权限执行。
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 里直接打开终端。
怎么用
-
在电脑上更新 TJUClaw CLI（Windows 和 Linux 桌面客户端 0.1.1 起内置支持远程终端的版本），开放远程终端并保持连接：
tjuclaw workspace allow terminal.open
tjuclaw connect
workspace allow 会替换整个许可列表，如果之前开放过其他能力（例如 pi.prompt），请一并写上。
-
打开“工作”侧栏，在电脑那一行点终端按钮；或者在项目的菜单里选“在终端中打开”，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 服务入口；修复手机上侧栏按钮偶尔点不开和输入框盖住侧栏的问题。
知识库管理：点击侧栏顶部的知识库名称，会打开它自己的菜单（手机上从底部弹出），不再跳到设置页。
- 重命名：直接在菜单里修改名称。
- 导出为 ZIP：笔记导出为 Markdown 文件，上传的文件保留原样，文件夹结构不变。富文本文档导出为 Markdown 时会保留标题、列表和段落，部分格式可能丢失。
- 导入：可以选择 Markdown、文本文件或 ZIP 压缩包；压缩包里的文件夹会按原样建立，Markdown 和文本成为笔记，其他文件作为附件上传。空文件和超过 8 MB 的文件会跳过，一次最多导入 400 个文件。
- 删除知识库：需要输入知识库名称确认；删除会永久移除其中的全部笔记、文件和会话，建议先导出备份。
- 知识库设置仍可以从菜单进入。
侧栏：
- “应用”里新增“插件”和“MCP 服务”，打开独立的扩展面板，在插件和 MCP 之间切换；不再需要先进设置。
- “小工具”从侧栏移除。课表、GPA、自习室等校园小工具现在是一个内置插件，在“插件”里点“打开校园小工具”进入。
手机修复：
- 左上角的侧栏按钮偶尔点了没反应：原因是从屏幕边缘拉出侧栏的感应区盖住了按钮的左半边。现在感应区从顶栏下方开始，按钮总能点到。
- 新建笔记主页底部的提问输入框原来会盖在打开的侧栏上，现在侧栏在最上层。
手机侧栏可以用手指拖动开合；知识图谱可以缩放、平移和查找；设置页重新设计并且不再需要加载；手机上的菜单和面板弹出更顺滑。
手机侧栏：
- 滑出和收起更流畅：动画只交给显卡做位移，不再一边播放脚本动画一边播放样式动画。
- 可以直接用手指拖：在侧栏或旁边的阴影上向左划可以收起，从屏幕左边缘向右划可以拉出。侧栏跟着手指走，松手时按拖动距离和速度决定开合，划得不够会弹回原位。
- 从侧栏打开设置或知识图谱时，侧栏会自动收起，不再挡在后面。
知识图谱：
- 布局重新计算：链接越多的笔记越大，相关的笔记会聚在一起。
- 可以缩放和移动：电脑上滚轮或触控板缩放，拖动画布平移，双击放大；手机上双指缩放、单指拖动。右下角有放大、缩小和适应窗口按钮。
- 鼠标移到一篇笔记上（或用键盘聚焦）会点亮它和直接相连的笔记，其余变淡；顶部可以按标题查找笔记并自动居中。
- 节点可以拖动调整位置；手机上全屏显示。
- 一次最多显示 120 篇笔记（之前是 48 篇）。
设置：
- 打开工作区后，设置、搜索和知识图谱会在空闲时预先加载，点开不再出现“正在加载设置”。
- 重新设计：设置项按组放在圆角卡片里；多选一改为一条分段选择器，开关类设置改为开关；标题和说明层次更清楚。
- 手机上是全屏页面：先列出各个分类，点进去查看，左上角返回。打开时不会自动弹出键盘。
菜单和面板：
- 右键菜单在电脑上从点击处轻轻弹出；手机上的操作菜单和标签页列表从底部滑入。
- 在手机上可以按住这两个面板顶部的横条往下拉来关闭。
已知限制：拖动手势目前只在自动化测试中验证过，还需要更多真机确认；iPhone 上从屏幕左边缘划可能会先触发浏览器自带的返回手势。
第一个 0.1 版本：Agent 可以接入 MCP 服务和技能，会话过程实时可见，界面更流畅，桌面端和安卓安装包同步更新。
TJUClaw 升到 0.1。网页端已经是这个版本；桌面端会提示更新，安卓安装包需要重新下载；macOS 安装包暂不提供。
这一版主要包括：
- Agent 可以接入外部工具：在设置的“MCP 服务”里添加 DeepWiki、Context7、Exa 网页搜索、高德地图、GitHub，或任何公网的 MCP 地址。
- Agent 技能：在设置的“插件”里启用考前复习、实验报告、参考文献格式、文献精读、课程项目调试、英文写作润色，遇到相符的任务时 Agent 会先读取做法。
- 会话：回合进行中实时显示思考、工具调用和回复，修改笔记的步骤标出改了多少字；会话可以重命名和删除。
- 更流畅：整个界面都交给 React 编译器优化，状态变化时只重画用到它的部分；长会话里离屏幕远的消息不参与重绘。
- 打开网站直接是登录页；网页端和桌面端会自己发现新版本，并列出更新内容。
- 手机：笔记主页底部可以直接提问；键盘、返回键和搜索面板做了修正。
已知限制：
- 手机键盘弹出时的显示已在安卓 Chrome 上确认（浅色和深色）；iPhone 和添加到主屏幕的应用还需要更多确认，遇到问题欢迎反馈。
- 安卓安装包暂时没有应用内更新。
- 连接本机或云端完整系统环境的“系统工作空间”还没有开放。