README file from
Githubpixel-blue Workspace
A pixel-blue visual workspace for Obsidian that brings notes, projects, tasks, daily notes, ideas, and knowledge workflows into one dashboard.
Highlights
- Expandable multi-level navigation with persistent custom items
- Project dashboards with manually maintained progress and recent schedules
- Filterable, sortable note property tables with inline property editing
- Daily-note quick capture, read-only preview, and native Obsidian editing
- Full-vault Boolean search with BM25-style keyword weighting
- Native Obsidian Markdown editing from every file entry
- Optional OpenAI, Claude, and secure gateway integrations
- A pixel-blue light and dark skin that pairs with the official pixel-blue theme
- No telemetry, advertising, or background data collection
Installation
After the plugin is approved for the Obsidian Community directory:
- Open Settings → Community plugins in Obsidian.
- Select Browse and search for pixel-blue Workspace.
- Select Install, then Enable.
- Use the ribbon icon or run Open Visual Workspace from the command palette.
Before approval, developers can install the three files from the latest GitHub
Release into .obsidian/plugins/pixel-blue-workspace/ for testing.
中文说明
把 Obsidian 中分散的笔记、项目、任务和日期聚合成一个可视化工作台。
当前已实现
- 可展开、可右键维护并持久化的多层导航
- 工作台、项目档案、多维表、每日笔记、知识中心、知识库、灵感收集和笔记榨汁机页面
- 笔记数、进行中项目、未完成任务、完成率总览
- 项目进度、Markdown 任务清单和近期排期
- 项目阶段和总进度由用户通过可视化滑块手工维护;关联任务只用于展示,不会擅自修改进度
- 项目档案提供识别预览,可查看自动识别依据并把任意笔记手动指定为项目主页
- 新增计划及现有任务都可以从下拉框选择或更换所属项目
- 可新增笔记、添加字段、筛选、排序并直接编辑属性的笔记属性表
- 基于
✅ YYYY-MM-DD真实完成日期的最近 28 天任务完成记录 - 每日笔记快速记录、只读预览和 Obsidian 原生编辑
- 所有笔记入口统一打开 Obsidian 原生 Markdown 编辑器,不重新序列化正文
- 可隐藏 AI 右侧栏,以及 OpenAI、Claude、安全网关和 Windows 开发用本机 Codex 设置
- API 密钥使用 Obsidian SecretStorage,不写入 Markdown 或普通插件数据
- 笔记榨汁机:Raw 原料生成结构化 Review,人工确认平台/内容分类后进入知识库
- Review 支持正文级差异审阅:对照原料相近片段、标记增删,并逐段采用或暂不采用
- 灵感收集可直接粘贴文字或截图,自动保存附件并生成 pixel-blue 方格纸瀑布流卡片
- 从真实 Vault 目录读取知识、灵感和榨汁队列
- 全库布尔精确查询与 BM25 风格关键词加权搜索
- pixel-blue 浅色/深色外观、方格纸和便利贴纹理
- 可选“全局美化模式”,把 pixel-blue 延伸到 Obsidian 侧栏、标签页、编辑区和弹窗
- 设置中可自定义主要文字、辅助文字以及待处理/进行中/完成/逾期状态色
- 顶部常用操作使用放大像素图标与可见文字标签
- 自动适配 Obsidian 明暗主题与窄屏
数据约定
项目笔记使用如下属性:
---
type: project
status: doing
progress: 65
due: 2026-08-15
area: 工作
stages:
- id: research
name: 调研
progress: 100
- id: execution
name: 执行
progress: 30
tags: [project]
---
插件会从项目区的“进行中 / 已完成”目录自动识别直接项目笔记,也支持 type: project、project: true 或项目标签。“识别预览”会列出识别依据,未识别笔记可手动设为项目主页。项目进度通过工作台中的滑块或阶段编辑器手工维护;保存时会同步更新 progress 与 status。
任务支持普通 Markdown 任务;在末尾加入日期即可进入排期:
- [ ] 完成首页原型 📅 2026-07-25
- [x] 整理需求 due: 2026-07-20 ✅ 2026-07-22
- [ ] 提交测试版 📅 2026-07-28 project:: [[官网改版]]
使用“新增计划”时可以选择所属项目,任务卡片也能随时更换归属;带有 project:: [[项目名]] 的计划会关联并显示到对应项目,但不会自动修改手工进度。
安装
插件通过 Obsidian 社区审核后,可在任意电脑上直接安装:
- 打开 Obsidian → 设置 → 社区插件。
- 关闭受限模式,选择 浏览。
- 搜索 pixel-blue Workspace,选择 安装,然后选择 启用。
- 点击左侧工作台图标,或从命令面板运行“打开可视化工作台”。
在社区版本正式发布前,开发者可从 GitHub Release 下载 main.js、manifest.json
和 styles.css,放入 Vault 的 .obsidian/plugins/pixel-blue-workspace/ 目录进行测试。
开发
- 在本目录运行
npm install。 - 运行
npm run build,生成main.js。 - 把
manifest.json、main.js、styles.css复制到 Vault 的.obsidian/plugins/pixel-blue-workspace/。 - 在 Obsidian 的“第三方插件”中启用 pixel-blue Workspace。
- 点击左侧的工作台图标,或从命令面板运行“打开可视化工作台”。
如需美化整个 Obsidian,请进入插件设置,开启“全局美化模式”。该模式默认关闭; 关闭开关或卸载插件后,Obsidian 会立即恢复原有主题。
AI 功能需要 Obsidian 1.11.4 或更高版本。打开插件设置中的“AI 与右侧栏”,选择提供商、模型并安全保存密钥后,可使用“测试连接”验证。
仓库中的本机 Codex 桥接只用于 Windows 开发环境,不包含在社区商店发布包中,也不是 Mac 官方安装版的开箱功能。跨设备使用 AI 时请选择 OpenAI、Claude 或自定义安全网关。
网络与隐私披露
- 插件不包含遥测、广告或后台数据收集。
- AI 功能默认关闭;只有用户主动启用并发起请求时才访问网络。
- OpenAI、Anthropic 或自定义网关模式会把聊天输入,以及用户明确允许的当前笔记上下文,发送到设置中的接口地址。
- 笔记榨汁机只在用户点击处理时,把所选 Raw 原料发送到当前 AI 提供商。
- API 密钥和桥接令牌保存在 Obsidian SecretStorage,不写入 Markdown、普通插件
data.json或公开发布包。 - 仓库中的开发用本机桥接默认只监听
127.0.0.1,并要求设备本地生成的桥接令牌。
主题开发
主题已经与功能样式隔离:
src/styles/base.css 固定字号、间距和安全回退
src/styles/components.css 工作台组件与响应式布局
src/themes/obsidian.css 跟随 Obsidian 的原生主题
src/themes/pixel-sky.css pixel-blue 视觉主题
src/themes/global-pixel-sky.css 可选的 Obsidian 全局 pixel-blue 外观
src/theme-manager.ts 主题与图标包切换
src/global-theme.ts 全局主题挂载与卸载清理
styles.css 构建时自动生成,请勿直接编辑
- 修改视觉主题时只编辑
src/themes/,不会改动数据读取和功能代码。 - 修改组件排版时编辑
src/styles/components.css。 - 运行
npm run build:styles可单独重新生成styles.css。 - 工作台主题默认只作用于
.vw-root;只有用户主动开启“全局美化模式”时, 才会通过body.vw-global-theme扩展到 Obsidian,其关闭与卸载流程会清理全部挂载状态。
下一步建议
- 属性表分组、关系字段与保存视图
- AI 语义检索、标签关系与关联图谱
- 关键词索引持久化与单文件增量更新
- 项目阶段模板与日历 / 甘特图视图