系列文档 · 第 29 min

第 2 集 - 创建 CLI 工作区

正文

这一集会安装已经发布的 CLI，并创建一个能让你校验内容的本地工作区。结束时，你会得到普通文件和一个可用索引，但不会生成公开网站。

开始以前准备一个 macOS 或 Linux 终端，确保能使用 git、可以联网，并有权限写入 ~/.local/bin。
安装器会生成三个等价命令：silan、svk 和 silan-viking。本系列使用 silan。
一、安装curl -fsSL https://raw.githubusercontent.com/Qingbolan/Silan-Context-System/main/engine/install.sh | sh
silan --version如果找不到 silan，打开一个新终端，让更新后的 PATH 生效。如果不希望把远程脚本直接交给 shell，可以先在仓库中检查 engine/install.sh，再从本地运行。
二、创建工作区mkdir my-research-site
cd my-research-site
silan init命令会创建：
content/              你编写的 Markdown/TOML 与媒体文件
content/SCHEMA.md     本地内容规则
silan-viking.toml     工作区配置它还会为内容源初始化 Git 并生成示例。SQLite 数据库从这些文件生成，可以随时重建。
三、校验起点silan content lint
silan index sync
silan guidecontent lint 报告内容和关系问题；
index sync 从 content/ 重建本地数据库；
guide 根据当前工作区说明下一步。
示例工作区可能报告非致命的缺失信息。只有当汇总显示 0 fatal 且 index sync 成功时，才继续下一步。
预期结果现在以下三条命令应能正常运行：
silan config
silan content tree
silan guide先不要配置 Docker、服务器或 MCP。第 3 集只需要你现在已经拥有的本地工作区。
从源码运行的桌面工作台可视化桌面工作台能编辑和审阅同一份内容，但目前需要完整 Silan Viking 源码仓库。silan init 不会安装它，本指南也不依赖它。

新建的外部工作区继续使用 CLI 和任意 Markdown 编辑器。独立打包的桌面应用仍在完善上手流程。