Fulcra Context_办公效率 skill-PHP中文网

Fulcra Context

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

访问用户授权的 Fulcra 上下文数据，包括生物特征、睡眠、活动、日历、位置以及 Fulcra 指标目录，通过托管的 MCP 服务...

Fulcra 上下文 : Fulcra 给代理商一个用户拥有的进入、存储和理性的地方, 超越现实环境: 生物鉴别学、睡眠、活动、日历、位置、自定义流、文件、偏好

功能概述

Fulcra 上下文 : Fulcra 给代理商一个用户拥有的进入、存储和理性的地方, 超越现实环境: 生物鉴别学、睡眠、活动、日历、位置、自定义流、文件、偏好是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

核心要点

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

Fulcra 上下文

Fulcra 为智能体提供一个由用户完全拥有、用于访问、存储和推理真实世界上下文的数据空间：包括生物特征数据、睡眠数据、活动数据、日历、位置、自定义数据流、文件、偏好设置，以及共享的智能体协作成果。

对于首次使用的用户，可将 Fulcra 描述为面向智能体的“便携式记忆与上下文基础设施”。它使智能体能够连接到随用户本地存储的数据，识别两次执行循环之间发生的变化，协调任务，并在不同智能体平台间无缝交接工作——而无需将上下文锁定在某一次聊天会话或某一台设备中。

本 ClawHub 技能采用“文档优先”（docs-first）设计原则。它不随附可执行的辅助脚本、安装钩子、后台任务、转录处理器、天气增强模块、导出工具或任意 CLI 封装器。请直接使用 Fulcra 托管的 MCP 服务器或 Fulcra CLI，并确保每一次数据读取均严格限定于用户当前请求的范围之内。

当智能体需要创建标注定义或向 Fulcra 回写经用户批准的事件时，请配合使用 fulcra-annotations 技能。

智能体接入策略

在请求安装工具、身份认证或读取数据之前，先用简短说明介绍 Fulcra 的核心能力。
保持交互节奏流畅。针对用户的运行环境，优先推荐最安全且具备对应能力的路径，而非一上来就罗列所有实现细节。
优先验证“最小可行价值”，而非追求全面覆盖：先确认账户有效性，再核实哪些数据已存在，最后仅读取最小但相关的数据切片。
表达方式应自然、具体、贴近对话场景，同时尊重用户偏好的格式与语气风格。
绝不可为追求速度而牺牲用户授权或隐私保护。“惊艳时刻”（wow moment）应源于对真实上下文的可控访问，而非原始数据的无差别暴露。

隐私边界

读取 Fulcra 数据前，必须事先征得用户明确许可。
仅读取当前回答所必需的具体指标或时间窗口内的数据。
禁止打印、记录、粘贴或转发任何认证密钥、认证文件、原始私有记录，或直接的能力访问 URL。
除非用户明确批准该次披露，否则不得在公开渠道（如群聊、论坛、演示文稿）中分享真实的日历、位置、笔记、转录文本或任何可识别个人身份的上下文信息。
本技能禁止运行转录处理、第三方增强、原始数据导出或广义库文件工作流。
若用户请求生成持久化文件、导出内容、仪表板或公开示例，请先确认目标位置与数据保留计划。公开制品（public artifacts）应优先采用合成数据（synthetic fixtures）。

初始化配置

采用分阶段引导式配置流程：连接智能体 → 验证数据可用性 → 推荐下一能力。

第一阶段：选择连接路径

根据智能体能力选择 Fulcra 接入面：

支持 Shell/Python 且具备外网访问能力：首选通过 uv tool run fulcra-api ... 调用 Fulcra CLI。
Python 库可用：当工作流需更丰富的本地代码控制能力时，直接使用 fulcra_api 包。
仅支持原始 HTTP 请求且无 Shell 环境：使用直连 REST API，配合 Auth0 设备码（device-flow）认证及 API 认证头（auth headers）。
MCP-only 或受限环境：使用托管的 MCP 连接器，仅支持受控的只读侧上下文接入。

在解释清楚所推荐路径之前，不得安装工具、启动认证流程或索取宽泛权限。

第二阶段：CLI 预检与身份认证

当具备 Shell 访问能力和外网连接时，CLI 是首选的首次运行路径。

首先验证 uv 是否已安装：

uv --version

若 uv 缺失，请先向用户申请明确许可，再依据 Astral 官方安装文档（按用户操作系统）进行安装；切勿自行猜测并执行安装命令。

使用 Fulcra CLI 实现可重复的自动化操作：

uv tool run fulcra-api --help

Fulcra 平台迭代迅速。在依赖具体命令名称前，请先运行 uv tool run fulcra-api --help；在依赖认证选项前，请先运行 uv tool run fulcra-api auth login --help；如需了解 API 结构，请查阅 https://api.fulcradynamics.com/openapi.json。

Fulcra GitHub 主干（main）分支可能包含尚未发布至正式 uv tool run fulcra-api 包中的 CLI 功能。请将主干变更视为观察信号（watch signals），而非用户操作指南——直至 CLI 内置帮助（live CLI help）实际确认该选项或命令已就绪。

检查用户是否已完成认证：

uv tool run fulcra-api user-info

若在聊天会话或远程智能体环境中需完成认证，请使用非阻塞式设备码流程：

uv tool run fulcra-api auth login --get-auth-url

仅向目标用户展示网页认证 URL 和用户码（user code）。设备码（device code）须严格保密，仅用于后续命令。待用户确认已在浏览器中完成认证流程后，以较短超时完成最终认证：

uv tool run fulcra-api auth login --device-code  --poll-timeout=5

认证安全规范：

检查认证状态或启动登录前，必须事先征得用户许可。
仅向目标用户共享短期有效的设备 URL 和用户码。
严禁共享任何密钥类 CLI 响应、设备码、认证密钥或认证文件。
通过无副作用的身份校验完成认证完成确认：

uv tool run fulcra-api user-info

Fulcra 账户可通过 CLI 创建，并永久免费享有 5 GB 存储空间。希望接入手机采集的生物特征、位置、日历等上下文数据的用户，可安装 Context iOS 应用，使用同一账户登录，并将数据同步至该存储空间。

若 CLI 认证因环境无外网连接而立即失败，请停止尝试绕过网络限制，转而采用 MCP 路径。

第三阶段：推荐首个实用工作流

完成认证后，不应止步于“配置完成”。请提供一段简明的推荐路径：

连接或确认某一数据源，使 Fulcra 具备可供读取的真实世界上下文。
运行 data-updates 进行新鲜度预检，使智能体掌握上一次执行循环以来的数据变动情况。
使用最小相关读取命令，验证真实上下文响应是否有效。
对于持续性工作，推荐配套技能以支持智能体团队协作、记忆/知识管理、追踪或标注写入。

托管 MCP 服务器

当智能体运行环境为 MCP-only 或无法安全运行 CLI 时，请使用 Fulcra 托管的 MCP 服务器：

https://mcp.fulcradynamics.com/mcp

Claude Desktop 设置示例：

{
  "mcpServers": {
    "fulcra_context": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.fulcradynamics.com/mcp"]
    }
  }
}

本地 stdio 服务器选项：

{
  "mcpServers": {
    "fulcra_context": {
      "command": "uvx",
      "args": ["fulcra-context-mcp"]
    }
  }
}

开源 MCP 服务器地址：https://github.com/fulcradynamics/fulcra-context-mcp

MCP 限制

MCP 认证材料 ≠ Fulcra API 认证材料。托管 MCP 服务器使用其独立的 OAuth 发行方（issuer）与受众（audience）；请勿将 MCP 认证材料复用于 api.fulcradynamics.com。MCP 对本技能而言仅为只读侧上下文通道，不提供文件或标注写入路径。

最新版 fulcra-context-mcp 源码支持跨服务重启持久化 OAuth 会话记录；但客户端仍须做好准备：若 MCP 会话已过期、被撤销，或来自旧版本部署，则需重新认证。请勿承诺“永久会话”；遇到 401 或认证失败时，应重启托管 MCP 的 OAuth 流程。

允许的只读工作流

以下为受控的只读命令模板。若 CLI 版本存在差异，请参考 uv tool run fulcra-api --help 获取准确帮助。

指标目录

uv tool run fulcra-api catalog

用于发现当前可用的数据类型。除非用户明确要求全面清单，否则不得查询全部指标。

实时 OpenAPI 接口亦提供带版本控制的目录/模式读取端点：

GET /data/v1/catalog/{data_type}/{api_version}
GET /data/v1/catalog/{data_type}/{api_version}/schema

仅在核对当前 OpenAPI 文档后方可使用。当工作流需在读写记录前精确获知特定数据类型/版本的 schema 时，这些端点非常有用。在 uv tool run fulcra-api --help 明确显示对应命令前，请勿假设已发布的 CLI 提供了对这些端点的一等支持（first-class command）。

在批量查询前判断数据是否存在，可优先使用 API 中提供的数据可用性与数据源发现接口：/data/v1alpha1/data_available 和 /data/v1alpha1/data_sources。

请将 /data/v1alpha1/insight 视为 Alpha/派生数据。在基于其构建稳定工作流前，请务必检查其当前 schema。

数据更新

uv tool run fulcra-api data-updates "1 day"
uv tool run fulcra-api data-updates "2026-07-01T00:00:00Z" "2026-07-02T00:00:00Z"

在大规模拉取前，使用 data-updates 作为增量新鲜度预检。它将报告指定时间窗口内哪些数据类型有新记录被处理、哪些 Fulcra 文件发生了变更。利用该摘要，选择最小化的后续读取操作，例如 get-records、metric-time-series、sleep-stages、calendar-events、apple-workouts、位置类命令，或文件 stat/download 命令。

data-updates 本身并非原始记录。请勿仅凭更新计数推断健康、日历、位置或文件内容等事实，亦不可将其用作标注写入成功的证明。应拉取相关记录，并通过具体的读取接口进行验证。

近期心率数据

uv tool run fulcra-api get-records HeartRate "2 hours"

汇总统计值或突出显著模式。除非用户明确要求，否则避免直接输出原始采样点。

对于分组指标数据，若任务匹配，优先使用 CLI 提供的时间序列（time-series）接口：

uv tool run fulcra-api metric-time-series --help

睡眠上下文

uv tool run fulcra-api sleep-stages "12 hours"
uv tool run fulcra-api sleep-cycles "1 week"

利用睡眠上下文调整简报内容或恢复建议。当数据缺失或陈旧时，须明确指出。

活动与训练

uv tool run fulcra-api apple-workouts "1 week"

分析范围应严格限定于用户实际提出的活动、恢复或日程安排类问题。

日历

uv tool run fulcra-api calendar-events "1 day"

在群聊、公开制品或共享报告中使用日历数据前，须获得用户明确许可。日历条目可能包含姓名、地点、与会者、备注及会议链接等敏感信息。

位置

uv tool run fulcra-api location-at-time "2026-05-05T12:00:00Z"

仅在请求上下文确实需要时才使用位置信息。本技能禁止将坐标或地点历史发送至任何第三方服务。

文件库边界

实时 OpenAPI 接口包含面向文件工作流的最近变更端点：

GET /input/v1/file/recent_changes
GET /input/v1/file_upload/recent_changes

请将这些端点视作 data-updates：它们是新鲜度与发现信号，而非文件内容本身，亦不能证明语义含义。可借助它们判断是否值得执行窄范围的 file stat、file list 或显式下载操作。除非用户明确要求执行该文件工作流并批准了目标位置，否则不得下载或暴露任何私有文件。

接入（Ingest）边界

本技能为只读导向，不支持写入记录。实时 OpenAPI 接口提供了类型化接入路径 POST /ingest/v1/record/{data_type} 及通用接入路径。对于经用户批准的写入操作，请使用 fulcra-annotations 或专用写入技能；在自定义代码中使用类型化接入前，请务必验证当前 OpenAPI schema。

偏好设置边界

请勿将 /user/v1alpha1/preferences 用作通用智能体记忆或设置存储。该端点是 Portal/Context UI 状态文档，行为为整文档扁平化替换（flat whole-document replace）。智能体/用户偏好设置应使用文件 + 标注的方式管理。

授权检查点

在执行以下任一工作流前，须提出明确的是/否问题：

在共享聊天中访问日历或位置数据；
写入包含原始 Fulcra 记录的本地文件；
基于私有数据生成截图或图表；
将 Fulcra 数据与外部服务结合；
在当前会话之外保留数据；
或将任何结果发布至用户私有工作区以外的环境。

对于公开示例、演示、截图、视频、测试及文档，请一律使用合成数据，除非用户明确批准将真实数据用于该特定制品。

配套技能

fulcra-context：读取 Fulcra 上下文，并分析经用户授权的健康、活动、日历、位置及目录数据。
fulcra-annotations：创建标注定义并记录经用户批准的事件。定义与标签可通过 CLI/库接口获取；时间线记录目前仍依赖接入（ingest）机制，待 record 命令落地后将支持直接操作。
fulcra-agent-teams：协调共享任务、智能体交接及团队可见的工作。
fulcra-memory：在 Fulcra 中记录高层级知识、进展及持久化智能体上下文。
fulcra-tracking：定义自定义数据流及智能体可见性指标。

按需从 ClawHub 安装配套技能：

Install the fulcra-annotations skill from ClawHub
Install the fulcra-agent-teams skill from ClawHub
Install the fulcra-memory skill from ClawHub
Install the fulcra-tracking skill from ClawHub

推荐的配置后路径：