@qcqx/lattice-cli

Lattice 的命令行入口。负责将 @qcqx/lattice-core 提供的领域能力封装为用户可直接调用的 CLI 命令。

安装/更新

npm install -g @qcqx/lattice-cli

安装后可通过 lattice 或 ltc 调用。

快速开始

使用 init 命令进行初始化，更新 @qcqx/lattice-cli 后也需要执行 init

ltc init

✔ 请输入你的用户名：
# ......
✔ 检测到 embedding 模型已安装，是否重新下载并预热？ Yes
✓ Lattice重新初始化完成！

任意agent，/ 搜索 start，执行命令，开始一个新任务

ai会自动进入lattice工作流，管理任务、项目、生命周期

1. 查看当前项目的上下文（规范、最近任务）
2. 搜索当前或者其它项目有无做过类似的任务，并查看这些任务的prd、进度，项目关系、规范等
3. 判断是否有现有进行中的类似任务
4. 判断是否应该为子任务

完成任务后，/ 搜索 archive 命令进行归档，若有可沉淀的规范，ai会进行提醒

命令概览

| 命令 | 说明 | |---|---| | lattice init | 初始化 AI 客户端集成（Cursor / Claude Code / Qoder / Trae 等） | | lattice link | 注册当前目录为 Lattice 项目 | | lattice unlink | 取消注册当前项目 | | lattice scan | 扫描目录树发现可注册项目 | | lattice project | 项目管理（list / info / relation 等） | | lattice task | 任务管理（create / start / checkpoint / complete / archive 等） | | lattice spec | 规范管理（list / show / template / conflicts 等） | | lattice context | 聚合并输出当前项目上下文 | | lattice status | 当前项目状态概览 | | lattice search | 语义 + 全文混合搜索 | | lattice config | 查看和修改配置 | | lattice rag | RAG 索引管理（status / update / rebuild） | | lattice sync | 模板仓库同步 | | lattice doctor | 数据健康检查与自动修复 | | lattice trash | 垃圾桶管理（list / restore / purge） | | lattice user | 用户管理 |

详细参数说明见 packages/core/public/templates/skills/command-reference.md。

架构定位

• CLI 不承载领域逻辑，仅负责参数解析、交互确认和格式化输出。
• 所有业务能力均来自 @qcqx/lattice-core。
• 所有可执行命令默认接受 --force 选项，AI 调用时跳过交互确认。

开发

# 构建
pnpm --filter @qcqx/lattice-cli build

# 类型检查
pnpm --filter @qcqx/lattice-cli check-types

License

MIT