lx-git 是一套 Git 风格的知识库本地工作流,属于 tencent-lexiang/lexiang-cli 的技能集合。前置条件是 lx CLI 已配置并登录。
用途:将远程知识库克隆到本地目录进行编辑,用类似 Git 的命令管理变更版本,适合多步编辑、批量修改或需要可回滚的变更管理场景;也可浏览本地文件、查看差异和提交历史。
主要能力:lx git 提供核心版本控制,包括 clone、add、commit、status、diff、log、pull、push、reset、revert、remote 等命令,详细参数可用 lx git --help 查看。lx worktree 用于管理多个独立本地工作区,包含 add、list、remove、status、diff、commit、log、push、pull、reset、revert,可用 lx worktree --help 查看参数。
使用方式:所有 lx git 命令需在包含 .lxworktree 的 worktree 目录内执行,没有本地工作区时先运行 lx git clone。clone 的 space_id 可传完整知识库 URL,CLI 会自动提取。push 前必须先 commit,否则会报错,例如先执行 lx git add . 与 lx git commit -m "..."。推送和回退建议先用 --dry-run 预览。.md 文件被视为知识库页面,其他文件按附件处理,push 时自动按文件类型选择创建方式。多步修改应先 clone 建立本地工作区,并在重要节点 commit 以便回滚。
限制与注意事项:本技能不负责在本地直接编辑页面内容,涉及编辑页面应切换到 lx-entry 或 lx-block;只读浏览知识库应切换到 lx-sh。lx git revert 会将远程内容回退到指定 commit,属于直接修改远程的危险操作,必须先 dry-run 预览并确认用户意图。--force 会覆盖远程冲突,也需确认用户意图。纯在线编辑没有版本记录,一旦覆盖无法回滚。关于收费、平台支持范围等资料暂未提供。