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

首页专区 Skill 文章专题 AI工具学习编程手册

Seko AI短剧一键生成成片 updream 一键生成高质量推广成片 Laper 剧本策划到成片协作 AniShort AI短剧协同制作平台

PHP MySQL jquery HTML CSS

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

推荐的配置后路径：