把知识库 clone 到本地(会员)
会员可用 Git 把整个知识库 clone 到本地,用任意编辑器维护后 push 回平台;免费版仍可网页编辑与用 KB API。
开始前
- 付费会员(Git clone / push 为会员专属)
- 本地已装 git
操作步骤
打开“本地编辑”弹窗
顶栏进入知识库(路由 `/kb`),点右上角“本地编辑”。弹窗打开时会自动拉取 Git 信息和你的 Token。
准备鉴权 Token
在“鉴权 Token”下拉选一个 API Token;没有就点“创建 Token”(默认名 git)。Git 走 Basic 认证:用户名随便填,密码用这枚 Token。
带凭据一键克隆
复制“带凭据一键克隆”里的命令在本地执行(形如 `git clone https://用户名:token@…/pt/git/u/用户名.git`)。clone 下来后一级目录是 vault/(长期知识)和 shelf/(草稿 / 待整理)。
编辑后 push 回来
在本地用任意编辑器改完,`git push` 回平台即可。
注意事项
- Git clone / push 是会员专属;免费版可继续用网页编辑和 KB API,单文件上传也有大小上限。
- 带凭据的命令会进 shell 历史,更稳妥的是用不带凭据的地址 + 凭据管理器。
- vault 放长期沉淀,shelf 放临时草稿,和网页里的分区一致。