# @forsion/calendar 中文文档

规范地址：https://npmcn.com/package/%40forsion/calendar/

版本：0\.1\.13
npm 元数据更新时间：2026-11-15T17:19:39.705Z
中文译文更新时间：2026-11-15T09:41:18.970Z
软件包许可：UNLICENSED

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40forsion/calendar
原文对照：https://npmcn.com/package/%40forsion/calendar/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：532 kB，11 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-10-21T15:24:15.944Z
- 最新版本发布：2026-11-15T17:19:39.547Z
- 近 30 天下载量：5438（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

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

## 安装

```sh
npm install @forsion/calendar
```

也可以使用：`pnpm add @forsion/calendar`、`yarn add @forsion/calendar`、`bun add @forsion/calendar`

## README

# 日历和任务

`@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会话不装入插件技能;在那里,日历工具定义包含着相同的三个事实.

## 发展

```bash
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 是什么？

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 和提交记录判断。