重构你的思维

English | 中文 | 日本語 | Türkçe

-w ~/SiYuan ``` ### 可用命令 | 分类 | 命令 | |------|------| | 笔记本与文档 | `notebook`、`document`、`dailynote` — 增删改查、每日笔记 | | 内容 | `block`、`attr`、`outline` — 块读写、自定义属性、大纲 | | 元数据 | `tag`、`bookmark`、`template` — 标签、书签、模板片段 | | 查询 | `search`、`sql` — 全文、语义、资源文件内容、SQL 查询 | | 引用 | `ref` — 反向链接和提及 | | 导入导出 | `export`、`import`、`inbox` — Markdown、HTML、preview、Word、.sy.zip、Data、云端收集箱 | | 数据管理 | `repo`、`history`、`sync` — 快照、历史、云端同步 | | 工具 | `asset`、`file` — 资源与文件系统 | | 数据库 | `database` — 属性视图管理 | | 伺服 | `serve` — 启动内核 HTTP 服务 | | 工作空间与系统 | `workspace`、`system` — 列出、查看、系统信息 | 运行 `siyuan --help` 查看完整命令树。使用 `-f json`（默认 `-f table`）获得适合脚本处理的输出。大多数写命令还支持 `--dry-run`，可预览将要发生的改动而不实际执行。 ### 安装 CLI 可执行文件为 `<安装目录>/resources/kernel/SiYuan-Kernel`，可通过 `siyuan` 命令调用。 - **Windows**：安装程序自动将内核目录加入 `PATH`，可直接使用 `siyuan`。微软商店版运行在 MSIX 沙箱中，无法自动修改 `PATH`；可部署一个 `siyuan.cmd` 转发器（一次性，商店版更新后依然有效）： ```powershell # 仅适用于微软商店版 —— 在 PowerShell 中运行一次 $shimDir = "$env:LOCALAPPDATA\Microsoft\WindowsApps" # 该目录默认已在 PATH 中 @( '@echo off' 'setlocal' 'set "ROOT="' 'for /f "delims=" %%i in (''powershell -NoProfile -Command "(Get-AppxPackage *SiYuan*).InstallLocation"'') do set "ROOT=%%i"' 'if not defined ROOT goto :noshim' '"%ROOT%\app\resources\kernel\SiYuan-Kernel.exe" %*' 'exit /b %ERRORLEVEL%' ':noshim' '1>&2 echo siyuan: 未找到微软商店版' 'exit /b 1' ) | Set-Content "$shimDir\siyuan.cmd" ``` 卸载商店版时如需清理：`Remove-Item "$env:LOCALAPPDATA\Microsoft\WindowsApps\siyuan.cmd"`。 - **macOS**：安装后创建软链接： ```bash ln -s /Applications/SiYuan.app/Contents/Resources/kernel/SiYuan-Kernel /usr/local/bin/siyuan ``` - **Linux**：安装后创建软链接： ```bash ln -s <安装目录>/resources/kernel/SiYuan-Kernel /usr/local/bin/siyuan ``` ## 🏘️ 社区 - [中文讨论区](https://ld246.com/domain/siyuan) - [用户社区汇总](https://ld246.com/article/1640266171309) - [Awesome SiYuan](https://github.com/siyuan-note/awesome) ## 🛠️ 开发指南 见：[开发指南](https://github.com/siyuan-note/siyuan/blob/master/.github/CONTRIBUTING.zh-CN.md)。 ## ❓ 常见问题和解答 ### 思源是如何存储数据的？ 数据保存在工作空间文件夹下，在工作空间 data 文件夹下： - `assets` 用于保存所有插入的资源文件 - `emojis` 用于保存自定义图标表情图片 - `snippets` 用于保存代码片段 - `storage` 用于保存查询条件、布局和闪卡数据等 - `templates` 用于保存模板片段 - `widgets` 用于保存挂件 - `plugins` 用于保存插件 - `public` 用于保存公开的数据 - 其余文件夹就是用户自己创建的笔记本文件夹，笔记本文件夹下 `.sy` 后缀的文件用于保存文档数据，数据格式为 JSON ### 支持通过第三方同步盘进行数据同步吗？ 不支持通过第三方同步盘进行数据同步，否则可能会导致数据损坏。 虽然不支持第三方同步盘，但是支持对接第三方云端存储（会员特权）。 另外，也可以考虑手动导出导入 Data 实现数据同步： - 桌面端：设置 - 导出 - 导出 Data / 导入 Data - 移动端：右侧栏 - 关于 - 导出 Data / 导入 Data ### 思源是开源的吗？ 思源笔记是完全开源的，欢迎参与贡献： - [界面和内核](https://github.com/siyuan-note/siyuan) - [Android 端](https://github.com/siyuan-note/siyuan-android) - [iOS 端](https://github.com/siyuan-note/siyuan-ios) - [鸿蒙端](https://github.com/siyuan-note/siyuan-harmony) - [Chrome 剪藏扩展](https://github.com/siyuan-note/siyuan-chrome) 更多细节请参考[开发指南](https://github.com/siyuan-note/siyuan/blob/master/.github/CONTRIBUTING.zh-CN.md)。 ### 如何升级到新版本？ - 如果是通过应用商店安装的，请通过应用商店更新 - 如果是桌面端通过安装包安装的，可打开 设置 - 关于 - 自动下载更新安装包 选项，这样思源会自动下载最新版安装包并提示安装 - 如果是通过手动安装包安装的，请再次下载安装包安装 可在 设置 - 关于 - 当前版本 中 检查更新，也可以通过关注[官方下载](https://b3log.org/siyuan/download.html)或者 [GitHub Releases](https://github.com/siyuan-note/siyuan/releases) 来获取新版本。 **注意**：切勿将工作空间放置于安装目录下，因为更新版本会清空安装目录下的所有文件 ### 有的块（比如在列表项中的段落块）找不到块标怎么办？ 在列表项下的第一个子块是省略块标的。可以将光标移到这个块中，然后通过 Ctrl+/ 触发它的块标菜单。 ### 数据仓库密钥遗失怎么办？ - 如果之前在多个设备上正确初始化过数据仓库密钥的话，那么该密钥在所有设备上都是相同的，可以在 设置 - 关于 - 数据仓库密钥 - 复制密钥字符串 找回 - 如果之前没有正确配置（比如多个设备上密钥不一致）或者所有设备均不可用，已经无法获得密钥字符串，则可通过如下步骤重置密钥： 1. 手动备份好数据，可通过 导出 Data 或者直接在文件系统上复制 工作空间/data/ 文件夹 2. 设置 - 关于 - 数据仓库密钥 - 重置数据仓库 3. 重新初始化数据仓库密钥，在一台设备上初始化密钥以后，其他设备导入密钥 4. 云端使用新的同步目录，旧的同步目录已经无法使用，可以删除 5. 已有的云端快照已经无法使用，可以删除 ### 使用需要付费吗？ 大部分功能是免费的，即使是在商业环境下使用。 会员特权需要付费后才能使用，请参考[定价](https://b3log.org/siyuan/pricing.html)。 如果你没有会员特权需求但又想支持开发，欢迎进行捐赠：[靠爱发电 - 链滴](https://ld246.com/sponsor) ## 🙏 鸣谢 思源的诞生离不开众多的开源项目和贡献者，请参考项目源代码 kernel/go.mod、app/package.json 和项目首页。 思源的成长离不开用户的反馈和宣传推广，感谢所有人对思源的帮助 ❤️ ### 贡献者列表 欢迎加入我们，一起为思源贡献代码。