DesktopConsole
DesktopConsole 是一款面向个人长期使用的 Windows 常驻桌面助手。当前版本采用 Attention Spine 形态:在所选显示器上运行少量安静的桌面磁贴,通过图标、卡片和完全展开三种尺寸承载日程、当前关注、事项与信息监控。
当前为本地观察版本 1.0.1,本地主干转入长期使用与缺陷维护;验收与后续范围见本地稳定版与维护边界。QQ 保持冻结,云端、设备、模型为独立扩展。
当前默认界面已经不再使用旧版 24 列网格仪表盘。旧磁贴、任务和插件代码暂时作为兼容基础保留,但不属于当前默认产品入口。当前能力与维护范围见当前项目边界。
当前桌面入口
| 入口 |
功能 |
| 图标磁贴 |
显示当前注意力状态;点击放大到卡片 |
| 卡片磁贴 |
优先显示标记的进行中事项;当前关注无标记时显示时钟;其他情况显示日程或短暂提示 |
| 完全展开 → 日程 |
下一项、提醒、最多 8 项近期安排;详细管理进入独立设置窗口 |
| 完全展开 → 当前关注 |
同一事项集合的只读优先视图;默认展示前 3 项、其余排队,管理入口统一在事项页 |
| 完全展开 → 事项 |
记录、编辑、优先级、计划时间、分页搜索、筛选、批量处理与删除恢复 |
| 完全展开 → 信息 |
聚合状态、主题摘要、兴趣反馈、忽略和转为事项 |
| 右上角设置 |
主题、提醒开关和两个经过校验的快捷目标 |
| 系统托盘 → 设置与来源 |
未来 60 项日程管理、日程来源、提醒、快捷入口、信息来源、本机接入和中继配置 |
| 系统托盘 |
显示器、置顶、常驻设置、备份与恢复、日志、运行模式、同步和退出 |
默认快捷键:
Ctrl+Shift+D:显示或隐藏桌面磁贴。
Ctrl+Shift+Space:打开助手入口;可在底层设置中改为允许列表内的组合。
Escape:关闭当前编辑/设置层,或逐级缩小磁贴。
Ctrl+Enter:从图标放大到卡片,或从卡片放大到完全展开。
已实现的核心能力
日程
- 读取配置后的旧版
.xls 时间表,并与本地日历事件合并。
- 计算下一项、正在进行、冲突和未来安排。
- 每个发生项可编辑标题、时间、地点、相关人员和本次备注。
- 同一导入内容或循环事件共享统一备注。
- 修改以本地覆盖形式保存,不回写源文件;支持隐藏、恢复和恢复本次原始内容。
- 从日程页或托盘打开“设置与来源 → 日程管理”,按日期浏览未来最多 60 项及隐藏项。
- 可从“设置与来源”创建、编辑和删除单次或周期日程;周期日程的统一说明由每次发生共享。
事项与提醒
- 快速记录内容会进入可管理的事项列表。
- 支持备注、0–100 综合优先级、计划时间、完成、恢复和删除。
- 全量搜索与每页 20 条分页,按状态和时间筛选,支持批量完成/恢复/删除。
- 已删除记录可以恢复或确认永久清理;2000 条上限不自动淘汰历史,满额明确拒绝新增。
- 当前关注只读展示事项的优先级、进行中状态与排队列表。新增、编辑、完成、删除统一在事项页;关注数量(默认 3 项,可选 1–5 项)和进行中标记也在事项页管理。变更会同步重排,不自动标记进行中。
- 日程与全部待处理事项生成持久化、去重的本地提醒,不受常驻 500 条快照限制。
- 支持静默时段、稍后提醒、标记已处理和有限执行动作;稍后提醒使用设置中的默认时长。
- 计划时间是到期提醒点,不自动创建日程。删除事项同时影响当前关注;处理单条提醒不会删除来源。完整含义见当前版本语义与收口。
信息聚合
- 按白名单来源轮询最近历史,并对本地消息去重、保留和聚类。
- 使用关键词、来源优先级、活跃度和用户反馈计算兴趣度。
- 当前摘要为本地抽取式
extractive-v1;尚未接入模型生成式摘要。
- 真实 QQ 数据源默认不启用,未配置时不会主动登录或联网采集。QQ 后续开发与实机接入目前暂停。
- 当前轮询仅读取最近历史;保存游标不代表完整回补。信息页“尝试于”表示最近轮询尝试时间,不能等同于最后成功时间。
桌面常驻与恢复
- 单实例、多显示器、边缘锚定、隐藏网格吸附和 DIP 缩放适配。
- 异常退出识别、渲染进程限次恢复、唤醒刷新、轮转日志和最近 7 份本地备份。
- 备份包含日程、事项与磁贴偏好;恢复先校验和备份当前数据,再重启应用,失败或中断会回退。
云端与设备扩展底座
display-safe-v1 今日简报、Ubuntu/Docker 中继、SQLite 版本保留。
- 逐设备只读凭据、到期/重签/吊销和 320×240 离线参考客户端。
- 默认关闭、有变化才上传、支持网络/电源门控和退避的自动同步。
云端与设备底座保留为独立扩展,真实部署不属于本地稳定版验收。设备当前只能读取适合显示的简报,不能反向执行桌面操作。
快速开始
环境
- Windows 10/11 x64
- 从源码开发或构建时需要 Node.js
>=22.12.0 和 npm;打包版无需另装 Node.js
- 读取旧版
.xls 时需要 Microsoft ACE OLEDB 16
使用本地稳定版
构建完成后,运行 release/local-stable/DesktopConsole-Setup-1.0.1-x64.exe 安装,或运行 release/local-stable/win-unpacked/DesktopConsole.exe 使用免安装版。升级前先在托盘创建备份并正常退出旧实例;两个版本共用默认数据目录,启动新包不会替换已运行的旧实例。
当前采用未签名的本地手动安装与更新。安装包不随 Git 源码提交;可按下述命令构建,或从成功的 Windows CI 运行下载构件。QQ、云端、设备和模型接入均不是本地使用的前置条件。
启动与停止
日常双击仓库根目录的 Start-DesktopConsole.cmd 启动、Stop-DesktopConsole.cmd 正常退出。也可以在项目目录执行:
双击启动时,命令窗口会短暂出现,启动完成后自动关闭,应用继续独立驻留;从已有终端启动时,命令会立即返回,之后可关闭终端。停止命令通过单实例请求正常退出。关闭磁贴窗口只会收起到托盘,托盘的“退出”同样可以结束程序。
首次使用需要先安装或运行 npm run pack:stable 生成程序。修改应用源码后先停止,再重新打包并启动;日常启动不编译源码。仅更新启动脚本无需重新打包,但要先停止旧实例再启动,让新启动方式生效。
仓库名称为 DesktopConsole,npm 包标识为 desktop-console。既有个人数据仍位于 %APPDATA%/桌面小组件面板/,改名不迁移数据。仓库内容与历史身份的审核范围见仓库隐私与命名。
从源码开发
npm ci
Copy-Item config/personal.example.json config/personal.local.json
npm run dev
个人配置文件已被 Git 忽略。未准备真实信息源时,可以保持 QQ 与信息聚合关闭。npm run dev 是需要保留终端的热更新开发模式;构建后可用 npm run preview 在前台调试 Electron。日常常驻使用上方的独立启动入口。
验证与构建
npm test
npm run verify:desktop
npm run dist:stable
npm run verify:package
npm test:编译主进程、独立检查渲染器 TypeScript,并运行服务与安全测试。
npm run build:执行两套 TypeScript 检查并生成渲染器生产构建。
npm run verify:desktop:生产构建与隔离 Electron 界面、IPC、恢复及生命周期回归。
npm run pack:stable / npm run dist:stable:在 release/local-stable/ 生成免安装目录或 NSIS 安装包。本地打包命令显式关闭 Release 发布,CI 只保留工作流构件。
npm run verify:package:检查实际 ASAR、安全开关及打包程序的事项写入和正常退出,需要先生成稳定版免安装目录或安装包。
npm run verify:launcher:在本机 Windows 验证 CMD / npm 启动不附着控制台、控制台宿主退出后应用仍运行,以及正常停止;使用隔离合成数据,需要已有打包程序。
- Windows CI执行服务测试、原生回归、打包与生产包回归,保留 14 天验证报告和安装包构件,不自动发布版本。启动器控制台回归单独在本机执行。
2026-09-05 本机 1.0.1 验收:116 项测试、16 项 Electron 回归、4 项生产包检查、5 项独立启动器回归通过,原失败的提醒用例在 UTC 与 Asia/Shanghai 下分别通过。覆盖与限制见观察版本验证记录;远端结果以对应提交的 GitHub Actions 记录为准。
npm start / npm stop 与两个 CMD 脚本共用同一启动器。程序查找顺序为 release/local-stable/win-unpacked/DesktopConsole.exe、旧 release/win-unpacked/、当前用户的默认安装位置;停止通过单实例 --shutdown 请求完成,不强杀进程。
配置
从系统托盘打开“设置与来源”,无需直接编辑 JSON 即可配置:
- 导入时间表、第一周日期、时区和时间段;
- NapCat、AstrBot 和个人模式的本地路径与健康检查;
- 信息来源白名单、关键词、轮询和保留上限;
- Ubuntu 中继地址、写入令牌和自动同步策略。
各来源默认关闭;“检查连接”只执行只读诊断,不会启动 QQ、切换运行模式或保存草稿。保存后相关服务会按已启用的配置热重载。开发者仍可复制 config/personal.example.json 作为初始配置或环境级覆盖。
数据位置
为兼容既有安装,Electron 内部应用名仍为“桌面小组件面板”。默认用户数据位于:
%APPDATA%/桌面小组件面板/
├── runtime-settings.json
├── runtime-session.json
├── assistant-tile-state.json
├── personal-config.json
├── logs/
├── backups/
└── panel-data/
├── agenda/
│ ├── customizations.json
│ ├── manual-events.json
│ └── sources/
├── assistant-actions/
├── assistant-control/
├── information-aggregation/
├── assistant-brief-relay-state.json
└── widgets/
可从系统托盘的“运行维护”创建备份、选择备份恢复,以及打开数据、备份和日志目录。完整恢复范围、外部配置优先级与升级方法见本地稳定版与维护边界。备份可能包含私人日程、来源标识和本地配置,只应保存在受信任设备。
架构
Electron 主进程
├── 桌面窗口、托盘、快捷键和运行恢复
├── 日程、事项、提醒和信息聚合服务
├── QQ 本地运行模式与受限执行
├── 今日简报、中继、自动同步和设备凭据
└── 统一 IPC 来源与参数校验
│ contextBridge
▼
React 渲染器
├── Attention Spine
│ ├── ScheduleTile
│ ├── ActionsPanel
│ ├── MonitoringPanel
│ ├── FocusPanel
│ └── AgendaItemEditor
└── Settings & Sources
├── 来源与只读连接诊断
├── 未来日程管理与逐项编辑
└── 人工单次/周期日程来源
渲染器启用 sandbox、contextIsolation 和 webSecurity;生产资源通过受控自定义协议加载。窗口创建、跨源导航、WebView 和权限请求均被拒绝。外部 URL、文件目标、进程路径和 IPC 输入由主进程重新校验。
当前边界
本地日程、事项、当前关注、提醒、常驻和数据恢复构成本地主干,1.0.0 后以缺陷与兼容性维护为主。QQ 继续冻结;真实云端部署、实体设备、模型、签名与自动更新需独立启动。旧网格和磁贴保留兼容代码,不继续扩建旧入口。
QQ 后续开发边界记录干净接口和未解决的权限、回滚、补读问题;本次没有改变其冻结状态或宣称完成只读安全验收。安装包采用本地手动交付,历史 0.6.0 包不代表当前源码;已有运行实例须正常退出后再切换新包。
文档
当前范围以维护边界和版本语义为准;历史阶段文档用于追溯设计与实现,不作为待开发路线。
许可证
MIT