TJUClaw 更新日志

图片附件可以正常预览了 #

修复迁入资料库的图片原件无法显示的问题，手机和电脑都可以直接查看。

• 打开图片附件就能查看：修复网页安全策略错误拦截图片预览的问题。有效图片不需要重新上传或重新导入。
• 加载失败会明确提示：不再只显示破图图标；原件仍可下载，不会把错误提示写入文件。

本次发布更新网页端。原生客户端的对应策略也已修正源码，已安装的旧客户端仍需等待后续安装包更新；本次不代表新的原生安装包已经发布。未上传或已经损坏的原件无法凭空恢复。

待办框勾选后不再向下移动 #

修复笔记编辑器中待办框的勾选位置，保持文字和列表对齐。

• 勾选或取消待办时，方框不再向下移动；嵌套待办也保持原来的位置。
• 保留空格键切换和快捷键撤销，不改写任务文字或列表结构。

迁入云端的 Obsidian 笔记可以互相跳转了 #

双链、相对笔记链接和原目录里的图片恢复兼容，编辑与阅读模式都可使用，无需重新导入。

• 笔记之间直接跳转：支持 Obsidian 双链、链接别名、相对 Markdown 链接和小标题定位。可以点击、触屏轻点或用键盘打开，跳转仍留在工作区，也能回到上一篇笔记。代码里的链接示例不会被改写。
• 图片按原目录加载：图片嵌入和相对图片路径会结合当前笔记所在的目录解析，支持中文、空格和编码后的文件名；图片嵌入指定的宽度也会保留。同名附件无法明确区分时，不再随意显示另一张图片。
• 目录加载完整后会自动更新：先显示本机缓存、随后读到完整云端目录时，笔记里的图片会重新匹配。图片加载失败只显示提示，不会把提示文字写进笔记正文。
• 小标题定位更稳定：连续点击大纲时，旧跳转不会再抢回滚动位置；跳到文末时，大纲也会正确标出最后一节。

本次更新修复链接解析和显示，不需要重新导入，也不会批量改写原笔记。没有迁入云端的附件仍需补齐；Obsidian 块引用定位和整篇笔记嵌入暂未支持。

点左上角的知识库名称切换知识库 #

左上角的知识库菜单现在列出你所有的知识库，点一下就能切换，也可以直接新建一个。

• 点侧栏左上角的知识库名称，菜单顶部会列出你的全部知识库，当前的打着勾；点另一个就切换过去，页面会重新打开到那个知识库。
• 选择会被记住：下次打开 TJUClaw，仍然是你上次选的知识库。
• 菜单里可以直接“新建知识库”，建好后自动打开。
• 原来的重命名、导出、导入和删除，现在归在“当前知识库”下面，只作用于正在打开的这一个。

说明：每个知识库在每台设备上都有自己的工作区口令。第一次在某台设备上切换到一个知识库时，会先请你为它设置口令。

维护记录 #

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

• 条目很多的知识库现在能正常打开：网速慢时加载笔记和文件列表的等待上限从 15 秒放宽到 1 分钟，之前这类知识库在网页和桌面端可能一直加载不出来。几千条的知识库第一次打开可能需要十几秒；命令行工具 tjuclaw 拉取列表时会压缩传输，快得多。
• 超长笔记（接近 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 秒：之前回复要等工作区保存和笔记同步完成才送达，现在回答一结束就显示，保存和同步在后台继续。