WorkShadow

如影随形，记你所做，懂你想要。

WorkShadow 是一款本地优先的桌面工作日志应用。左侧管理你的日志，右侧用富文本编辑器记录日常的工作、决策、问题与线索。数据保存在你自己的电脑上；若需要 AI 能力（搜索、总结、问答、图片说明等），由你在设置中接入自己的模型服务——内容在你手里，能力由你配置。

相比常见笔记 / 文档工具，WorkShadow 适合什么？

常见场景	WorkShadow 的做法
普通笔记软件「能写难找」	关键词搜索 + 语义检索，用一句话找回几个月前的细节
写日报、周报、邮件、汇报要翻很多文件	工作台 · 日志总结：勾选多篇日志，按你的要求生成各类书面草稿
「当时为什么这么决定？」	工作台 · 日志问答：向自己的历史日志提问，获得更全面的归纳回答
担心工作内容上云、被平台绑定	数据在本地，AI 仅在你配置模型时才联网调用
需要备份与迁移	支持 `.ws` 整包备份与合并导入

WorkShadow 不是替代 Word 或 Notion 的通用文档编辑器，而是面向持续记录、回顾、汇报的工作日志伴侣：写得顺、找得快、总结省力，且你始终掌握数据与模型选择权。

安装版与开发版

安装版（Releases 安装包）与 开发版（npm run tauri dev 或下载开发版安装包）核心功能相同，均免费。安装版额外提供本地模型推理、无限日志总结、智能补全等功能增强（✅ 有 / ❌ 无）：

对比项	开发版	安装版	备注
费用	🆓	🆓
核心功能	✅	✅
数据在本地	✅	✅
更友好、更美观的 UI 交互	❌	✅	界面更精致，日常操作更顺手
本地模型推理	❌	✅	内置本地模型，总结/问答无需自备付费 API
无限日志总结	❌	✅	不限勾选篇数与单篇长度，一次即可总结
支持代码语法块	❌	✅	代码块按编程语言自动语法高亮
支持自定义字体	❌	✅	工具栏为正文选择不同字体
智能补全	❌	✅	本机学习续写建议，不上传日志正文
获取	下载 / 源码启动	下载
适合	开发调试	日常使用

本地模型推理在设备端运行，无需再支付大模型调用费用；其余 AI 能力仍可在设置中自行配置。

主要功能

日志组织与编辑

智能补全（仅 安装版）：编辑时根据你本地已保存的日志，在光标处给出续写建议；数据在本机学习与推断，不上传正文，用得越久、记录越多，建议越贴合你的写法。开发版不包含此功能。
富文本编辑：标题、列表、任务清单、引用、代码块、表格、链接、图片、视频、公式等常用格式一应俱全。
图像复制、拖拽（仅 安装版）：支持从剪贴板粘贴图片，或将图片文件拖入编辑区插入。开发版不包含此功能。
批量操作：多选节点后批量移动或删除，整理大量历史日志更省力。
导入 Markdown：可将已有 .md 文件导入到某条日志中继续编辑。

搜索与理解

关键词搜索：在左侧搜索框输入词语，对日志正文做本地关键词匹配，结果展示多处命中片段，点击即可打开对应日志。
语义搜索：配置嵌入模型后，可用自然语言描述意图进行向量检索，找到「意思相近但措辞不同」的内容；未配置时自动退化为关键词搜索。

工作台（AI 辅助，需自行配置模型）

记忆：存放跨多篇日志仍成立的约定（如 OKR 口径、术语含义、总结侧重），供总结与问答时参考。
日志总结：勾选多篇日志，结合「记忆」与你的写法偏好（关注点、语气、结构等），按需生成日报、周报、月报、邮件、阶段汇报、项目报告等各类书面内容草稿，可直接复制后微调发送。
日志问答：针对你的问题，从全部日志中检索相关片段并归纳作答，比单篇翻阅更全面、连贯，适合回顾决策背景、梳理进展、核对细节；回答会标注参考来源。

设置与数据

界面：浅色 / 深色主题，中 / 英文（可跟随系统），界面缩放可调。
路径：自定义日志落盘目录与临时文件目录；保存时可将正文写入你指定的文件夹。
模型配置：分别配置大语言模型（总结、问答）、多模态模型（图片 / 视频说明）、嵌入模型（语义搜索）；支持连接测试。
快捷键：应用内快捷键与系统级「新建子日志」快捷键可自定义。
数据导入 / 导出：将日志、记忆、设置等打包为 .ws 文件备份，或从备份合并恢复。

如何使用（桌面版）

方式一：安装版

前往 Releases 发布页下载 安装版（WorkShadow_*_x64-setup.exe）。安装完成后从开始菜单或桌面快捷方式启动即可。以下为安装后的日常使用说明。

国内用户也可通过 百度网盘 下载：
https://pan.baidu.com/s/1XhpGp3PBEld2KJj7mkbNMw?pwd=s5ma
提取码：s5ma

1. 首次打开

启动 WorkShadow。
点击右上角设置，建议先完成：
- 基本设置：选择主题、语言、日志保存目录。
- 模型配置（可选）：若要用语义搜索、日志总结、日志问答或图片 AI 说明，填写对应模型的地址、密钥与模型名，并 测试连接。
点击左上角返回回到主界面。

2. 写日志

在左侧选中文件夹或日志；搜索框下方可 新建日志。
在右侧编辑区写作；需要时用工具栏插入表格、图片、链接等。
点击保存（或编辑区焦点下按 Ctrl+S / ⌘+S）：内容写入本地数据库，并按设置导出到日志目录、更新检索索引。

3. 整理与查找

整理：右键节点可新建子节点、重命名、移动、复制、删除；也可拖拽移动；批量操作 可一次处理多个节点。
查找：左侧搜索框输入内容后搜索；配置嵌入模型后，可切换语义模式做自然语言检索。
工作台：点击侧栏 工作台，在「记忆」「日志总结」「日志问答」之间切换使用（总结与问答需已配置大语言模型）。

4. 备份与迁移

在 设置 → 数据 中，将所需内容 导出为 .ws 文件；在新环境 从 .ws 文件导入 即可合并恢复（未勾选导出的类别不会被覆盖）。

方式二：开发版（安装包或源码）

也可在 Releases 发布页下载 开发版（WorkShadow_*_x64-dev-setup.exe）安装使用，无需配置下方开发环境。

若希望从源码启动，适合开发者或希望直接运行仓库代码的用户。需先准备：

Node.js 18 及以上（推荐当前 LTS）
Rust + Cargo（Tauri 桌面壳依赖）
Windows 上还需安装 Visual Studio「使用 C++ 的桌面开发」 工作负载（详见 Tauri 前置条件）

在项目根目录执行：

npm install
npm run tauri dev

第一条命令安装前端依赖；第二条会先启动 Vite 开发服务器（默认 http://localhost:1420），再编译并打开 Tauri 桌面窗口，窗口内直接加载开发地址，改前端代码后通常可热更新，无需每次重新打包。

若 1420 端口已被占用，请先关闭其它占用该端口的进程后再试。

说明：npm run tauri dev 用于本机开发调试，不会生成可分发的安装包。若要打正式安装包，需执行 npm run build 后再 npm run tauri build，产物一般在 src-tauri/target/release/bundle/ 目录。

启动成功后，日常使用与方式一相同，请参照上文方式一中「首次打开」至「备份与迁移」的说明操作。

联系我们

如有问题、建议或合作意向，欢迎通过以下方式联系。应用内也可在 设置 → 关于 查看相同二维码。

管理员微信
_{扫码添加，便于反馈与交流}

微信公众号
_{扫码关注，获取产品动态}

QQ 群
_{扫码加入群聊；群号 1107536375}

电子邮箱：feiyangtech@qq.com

国内托管（AtomGit）

国内用户可通过 AtomGit（GitCode） 访问与本仓库同步的开源托管：

项目在 AtomGit：https://gitcode.com/FutureUniant/WorkShadow

开源与许可

本仓库以 GNU Affero General Public License v3.0（AGPL-3.0） 发布。

你可以自由使用、研究、修改和分发本软件。
若你修改本软件并通过网络提供服务，须向用户提供对应源代码（AGPL 的 copyleft 要求）。
本软件包含的第三方依赖，分别适用其各自的开源许可证。

WorkShadow

WorkShadow

相比常见笔记 / 文档工具，WorkShadow 适合什么？

安装版与开发版