企业官网建设流程全解析

• 人工智能
• Agent 记忆
• MCP 服务
• CLI
• 知识管理
• 开发工具

iwe 是一个 Markdown 知识图谱工具，内置 LSP、CLI 和 MCP 记忆能力。本文精选 10 个 iwe CLI 日常技巧：从iwe find全文搜索、iwe tree层级浏览，到iwe normalize批量格式化，一篇教程帮你把笔记管理效率拉满。

iwe 的核心理念很简单：把一堆互相链接的 Markdown 文档当作一张知识图谱，用命令行就能搜索、创建、重组和分析它们。装好之后，在一个笔记目录里执行iwe init，会生成.iwe/配置目录，所有技巧都在这个目录里运行。

技巧1：init 初始化项目，一键建立知识图谱

iwe init

• 在任意笔记目录执行即可，自动生成.iwe/config.toml配置
• 后续所有命令（find、normalize、tree）都读取这份配置
• 官方安装与初始化说明见 docs/cli.md

💡 把笔记目录放进 git，配合版本控制使用最安心。

技巧2：find 模糊搜索，快速定位文档

# 按标题和 key 模糊匹配 iwe find --fuzzy authentication # 全文 BM25 检索（搜正文） iwe find --lexical "session token"

为什么强：

• --fuzzy走 SkimMatcherV2 模糊匹配，敲一半也能命中
• --lexical是 BM25 全文检索，自动词干化、去停用词
• 结果按被引用热度排序，越重要的文档越靠前

更多参数（投影、排序、限制条数）见 docs/cli-find.md，CLI 实现位于 crates/iwe/src/main.rs。

技巧3：find --filter，用YAML过滤元数据

# 只查草稿 iwe find --filter 'status: draft' # 组合条件（AND） iwe find --filter '{status: draft, priority: { $gt: 3 }}' # 按修改时间倒序 iwe find --filter 'priority: { $gte: 3, $lte: 7 }' --sort modified_at:-1

frontmatter 里的任何字段（status、tags、priority…）都能参与过滤，多个顶层条件自动取交集。查询语言完整语法参考 docs/query-language.md，过滤逻辑源码见 crates/liwe/src/query/filter.rs。

技巧4：find --matches，全文 grep 带位置

# 全库搜索 TODO/FIXME，输出"文档 › 章节 › 文本" iwe find --matches '(?i)todo|fixme'

一个标志同时完成"筛选文档 + 定位行"两件事，比grep -r更懂 Markdown 结构——每行结果都标注了它所在的章节路径。

技巧5：retrieve 带上下文读取文档

# 单文档 iwe retrieve -k my-document # 文档 + 直接子文档 + 父文档 iwe retrieve -k my-document --expand-includes 1 --expand-included-by 1 # 问题直接当种子：搜相关文档再自动扩展 iwe retrieve --lexical "how does session expiry work" --limit 5

retrieve是 iwe 最有设计感的命令：它不只读一篇文档，而是沿图谱边（包含关系、内联引用）把相关文档一起拉出来，输出自带 frontmatter 元信息。喂给 AI 或批量阅读都极方便，详见 docs/cli-retrieve.md。

技巧6：tree 可视化文档层级

iwe tree # 默认 4 层 iwe tree --depth 2 # 只看主干 iwe tree -k my-doc # 从指定文档出发 iwe tree | grep -i api # 管道过滤

文档以嵌套链接列表呈现，一眼看清谁包含谁。遇到循环引用没有根节点的文档，用-k指定起点即可显示完整环路。输出格式见 docs/cli-tree.md。

技巧7：create 模板化创建文档

# 快速捕获：内置 default 模板 iwe create --template default --var title="Standup notes" # 结构化变量（YAML 保类型） iwe create -t meeting --vars-yaml 'title: Sync attendees: [ada, alan] draft: false'

• 模板在.iwe/config.toml的[templates.*]中定义，支持{{title}}、{{slug}}、{{today}}等变量
• 已有完整文件？直接管道写入：cat draft.md | iwe create projects/overview
• 参数与两种模式（内容/模板）说明见 docs/cli-create.md

技巧8：extract 抽取章节，拆分大文档

# 先看有哪些章节 iwe extract my-document --list # 1: Introduction # 2: Getting Started # 3: Configuration # 按标题抽取（大小写不敏感、支持部分匹配） iwe extract my-document --section "Configuration" # 或按块号（无歧义） iwe extract my-document --block 3

抽取是"移动"而非复制：原位置被替换成指向新文档的包含链接，标题层级自动调整，文档拆分后依然是一个整体。key 冲突时自动追加-1、-2后缀。详见 docs/cli-extract.md。

技巧9：rename 安全改名，全库引用自动更新

# 先预览影响范围 iwe rename user-auth authentication --dry-run # 执行：文件改名 + 更新全库所有指向它的链接 iwe rename user-auth authentication

这是手动mv永远做不到的：rename 会同步改写所有包含链接和内联引用，绝不留下死链，且操作是原子的。移动文档到子目录也走它，例如iwe rename config settings/config。参考 docs/cli-rename.md。

技巧10：normalize 一键批量格式化

# 建议先提交版本，再执行 git add -A && git commit -m "Before normalization" iwe normalize git diff # 审阅改动

一条命令同时修复 7 类格式问题：

关键特性：幂等——跑多次结果一样，已规范的文件不会再变。行为由.iwe/config.toml的[markdown]段控制（如refs_text = "normalize"开启链接标题同步）。完整说明见 docs/cli-normalize.md。

附赠：用 stats 体检你的知识库

iwe stats # 总览 + 各维度统计 iwe stats similarity -t 0.85 # 找近乎重复的文档对

stats会报告文档总数、章节数、引用分布、孤儿文档（无人引用）、被引最多的 Top 10 等，是知识库"断舍离"的最佳帮手。参考 docs/cli-stats.md。

总结

把这 10 个命令组合起来，搜索、阅读、创建、重构、维护就构成了完整的 iwe CLI 日常流。所有命令成功时返回退出码0、失败返回1，天然适合写进脚本；更多细节可查 docs/cli.md 与 docs/cli-workflows.md。

• 人工智能
• Agent 记忆
• MCP 服务
• CLI
• 知识管理
• 开发工具