@forsion/calendar

中文文档
0.1.13发布于 2026/11/16UNLICENSEDES Module零依赖近 30 天下载 5438

Forsion核心日历和任务:快速捕捉,排程,完成反馈和撤销.

中文使用文档

日历和任务

@forsion/calendar 是 Forsion 的核心日历和任务插件。 源寄存器访问是私有的;npm包包含捆绑的渲染器,空间食谱和通知. 需要强化 2.13.8-β.3 或较后 与公共日历记录 API.

  • 日历保存其现有的本土空间身份,保存布局,日历设置和右侧任务列表. 专用任务空间使用相同的任务视图和本地工作空间侧边栏. 迷你使用同样的渲染器.
  • 任务列表( 任务空间, 日历伴侣, Mini) 仅持有任务: 带有日期的批注复选框 , - [ ] … @todo 注行(未排定,主机从2026-11-15起)和有Done一栏的表格行。 没有复选框的日期字条是事件:它们出现在日历上并在那里打开一张卡片,而不是在列表中. 没有普通复选框 @ 留在纸条上.
  • 用 Enter 抓取一个任务并继续打字 。 日期是可选的;“明天3点”等文字提供日期。 没有可写列表,第一个添加在插件的工作文件夹下明确创建了普通数据库. 没有单独的任务数据库格式或并行的任务存储.
  • 补全给出了即时的视觉反馈,短暂的就地暂停和8秒的Undo动作. 本地移动主机请求一个系统勾选一个已接受的补全; 撤销和数据刷新保持安静 。 触摸反馈可以在任务菜单中被关闭. 系统优惠仍然有效。 桌面和浏览器主机不会假装振动.
  • 事件菜单、记录副本/盘片、有条件的撤销/重写和完整的注释/记录副本使用主机的公开 calendar.events API (英语). 字段编辑使用真 ui.mountRecord 编辑。 日历/待办事宜数据来自 databases, (中文(简体) ), noteTasks 财务报告和审定财务报表 calendar;没有使用主机运行时间导入.
  • 主机将 npm 版本钉入 desktop/package.json,种子它穿过 builtinBundles.json分类 CORE_BUNDLE_IDS 并检查 npm 通过现有核心更新器更新。 Android 捆绑相同的 npm 渲染器; 较新相容的已安装版本优先. 这不是一个市场进入.
  • skills/calendar-todos/SKILL.md 船在包裹。 本地代理引擎扫描已安装的插件 skills/ 文件夹,所以 Agent 学习到用户的待办事宜是其日历的行( 默认) human://CALENDAR.db),可能没有日期,并添加和勾选 amadeus_* 日历工具——从不作注释. Cloud会话不装入插件技能;在那里,日历工具定义包含着相同的三个事实.

发展

npm ci
npm run typecheck
npm run check:all-day # Real plugin entry: timed/all-day transitions, remounts, task/date-marker source semantics
npm test            # 先 build,再跑单测(含按宿主装法跑 main.js 的入口测试)
npm run install:dev # 装进 ~/.forsion-dev/plugins/forsion-calendar

全天可见度相对于真实的桌面主机:构建此插件和创世纪桌面,然后运行 GENESIS_DESKTOP_DIR=/absolute/path/to/Forsion-Genesis/desktop npm run check:all-day:gui。 。 。 . 被隔离的固定图包括一个复选箱背后日历并检查定时/全天过渡和重新加载而不编辑用户数据.

列表和日历中的备注项目: 建起此插件和创世纪桌面后, 运行 GENESIS_DESKTOP_DIR=/absolute/path/to/Forsion-Genesis/desktop npm run check:note-items:gui。 。 。 . 单个的定点检查记录了备忘事件, 远离了任务空间、 日历伴奏和 Mini, 而注释任务则留在其中, 源过滤器、 完成撤消、 仅保留日期的 Markdown 更改, 重新装入后事件仍保留在日历上 。 截图和 report.json 默认为 /tmp/forsion-calendar-note-items; 设置 CALENDAR_NOTE_ITEMS_ARTIFACT_DIR 以保留另一跑步。 设定 CALENDAR_PLUGIN_DIR 以0.1.9为基准的预期可见度的放行检查.

QQ / : QQ 创世纪桌面 GENESIS_DESKTOP_DIR=/absolute/path/to/Forsion-Genesis/desktop npm run check:card-placement键。 * 家庭,80%/100%/120% 检查覆盖主窗/独立窗的实际卡片高度、滚动、缩放、分隔线命中,以及切换. 查看 QQ。 截图和 report.json 默认输出到系统临时目录 forsion-calendar-card-placement键。

家: 创世纪 cd desktop && npm run build时 node scripts/todo-dock.check.cjs <那份检出>/desktop --host old|new键。old = 3,4,3,6,6,6,6,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,8,7,7,7,7,7,7,7,7,7,7,7,7,7,8,7,7,7,7,7,7,7,7,7,7,7,7,8,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,8,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,1,7,7,1,7,7,7 addColumn 编号 : chatBoxCapabilities 的宿主 (单位:千美元) v2.13.8-beta.3, (中文(简体) ),new =========================================== (=============== (=================================================================================================== --plugin <旧版目录> 跑负对照,应该挂。。

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * ** * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * **************************************** npm run build, 12. 创世纪 QQ desktop 页:1 npx electron-vite build时 CALENDAR_PLUGIN_DIR=<本检出> node scripts/home-widgets.check.cjs(台架把本检出以 99.0.0 装进临时家目录,免得被随包的旧版顶掉。

npm pack --pack-destination artifacts 准备发布存档 。 发布到npm需要明确批准软件包版本. 正在准备归档或推动特性分支不会发布它 .

版本与发布记录

@forsion/calendar 共发布 15 个版本,首次发布于 2026/10/21;过去 12 个月发布了 15 个版本。

版本发布日期距今
0.1.13latest2026/11/16今天
0.1.122026/11/15今天
0.1.112026/11/132 天前
0.1.102026/11/132 天前
0.1.92026/11/133 天前
0.1.82026/11/087 天前

关于 @forsion/calendar 的常见问题

@forsion/calendar 是什么?

Forsion核心日历和任务:快速捕捉,排程,完成反馈和撤销.

如何安装 @forsion/calendar?

在项目目录运行 npm install @forsion/calendar,或使用 pnpm add / yarn add / bun add。

@forsion/calendar 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/forsion__calendar 是否存在。

@forsion/calendar 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@forsion/calendar 可以商用吗?

@forsion/calendar 使用 UNLICENSED 许可。作者声明为 UNLICENSED,即不授予公开使用许可(与公共领域的 Unlicense 不同)。使用前需获得作者授权。以上为概括,不构成法律意见,请以许可原文为准。

@forsion/calendar 的下载量有多少?

根据 npm 官方下载统计,@forsion/calendar 在 2026/10/16 – 2026/11/14 这 30 天内被下载 5,438 次,日均约 181 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@forsion/calendar 还在维护吗?

最新版本 0.1.13 发布于 2026/11/16(今天);至今共发布 15 个版本,其中过去 12 个月发布了 15 个;首次发布于 2026/10/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。