只监听本机
服务绑定在 loopback 地址，默认不接受局域网或公网设备直接连接。
Local-first Open Platform
让外部工具安全调用你的闪念数据。
闪念开放平台运行在桌面端本机，只监听 loopback 地址，通过一次性令牌和权限范围把 CLI、MCP、DeepSeek Harness、个人 Agent 接到你的本地数据。
- 默认地址
- 127.0.0.1:48173
- 首批能力
- notes / themes / todos
- 授权方式
- Bearer Token
Shanion Desktop
Open Platform running locally
CLI
MCP
Harness
POST /v1/tools/todos.create/invoke
Authorization: Bearer shn_op_...
{
"title": "跟进会议结论",
"reminderAt": 1720000000000
}Security Model
外部能力和内部能力分开，授权也要可理解。
开放平台只暴露稳定的公开协议，不复用 App 内部功能接口；用户可以随时创建、复制、查看前缀和撤销令牌。
令牌只显示一次
完整 Token 创建后只展示一次，本地只保存不可逆哈希，丢失后撤销重建。
按能力授权
已落地能力才会显示为当前可用；未落地的权限会显示为暂未开放，不会被默认授出。
Quick Start
三步接入本机闪念。
适合先在本机验证 CLI、MCP 或个人 Agent 的读写场景。
- 在闪念桌面端开启开放平台 设置 → 开放平台 → 启动本机服务，确认 Base URL。
- 创建访问令牌 新建令牌，选择需要的读取或写入权限，复制 Token。
- 从外部工具调用 把 Base URL 和 Token 填入 SDK、CLI 或 MCP 配置。
CLI 示例
export SHANION_TOKEN="shn_op_..."
node packages/cli/bin/shanion-open.js invoke notes.search \
--input '{"query":"上海","limit":10}'Capabilities
能力从公开 DTO 开始。
平台查询、闪念、主题和待办已经有专用外部契约；更多领域会在契约稳定后开放。
工具
权限
状态
说明
platform.capabilities
任意有效 Token
可用
读取开放平台能力和权限要求。
platform.permissions
任意有效 Token
可用
解释当前 Token 能调用哪些能力。
notes.list
notes:read
可用
按创建时间倒序读取未删除闪念。
notes.search
notes:read
可用
按关键词搜索未删除闪念正文。
notes.get / notes.create / notes.update / notes.delete / notes.move
notes:read / notes:write / themes:read
可用
读取单条闪念，或创建、编辑、软删除、移动闪念。
themes.list / themes.get / themes.create / themes.update / themes.delete
themes:read / themes:write
可用
读取主题，或创建、重命名、软删除主题子树。
todos.list / todos.create / todos.get / todos.update / todos.delete
todos:read / todos:write
可用
读取待办，或创建、更新状态/提醒、软删除待办。
contacts / audio
对应 scope
暂未开放
协议保留，等待专用外部契约落地。
Developer Surface
开放平台仓库只放外部生态层。
底层能力定义统一放在 Open Platform capability 层；SDK、CLI、MCP 和 Harness 插件只做宿主协议封装。
Protocol
共享端点、scope 和工具调用路径。
@shanion/open-platform-protocol
JavaScript SDK
封装本机 API 请求、错误解析、loopback 校验和能力便捷调用。
@shanion/open-platform-js-sdk
Capabilities
定义公开能力契约、输入归一化和工具调用边界。
@shanion/open-platform-capabilities
CLI
用于本机调试、快速检查健康状态和调用工具。
@shanion/open-platform-cli
MCP Server
把 MCP tools 映射到 Shanion Open Platform tools。
@shanion/open-platform-mcp-server
DeepSeek Harness
把底层 Open Platform 能力注册成 Harness 原生工具。
@shanion/harness-plugin