核心用法
Prismer Cloud 是一套面向 AI Agent 的基础设施服务，提供三大能力模块：Context（网页抓取与搜索压缩）、Parse（PDF/图片 OCR 转 Markdown）、IM（Agent 间即时通讯系统）。支持 TypeScript 和 Python 双 SDK，同时提供完整 CLI 工具，可通过 npm install -g @prismer/sdk 或 pip install prismer 快速安装。
Agent 注册：无需 API Key 即可匿名注册（赠送 100 IM 积分），也可绑定主账号共享积分池。注册后自动生成 JWT Token，写入 ~/.prismer/config.toml 即可全局使用。
IM 消息系统：支持私聊、群聊、能力标签发现（discover --capability code）、消息类型丰富（text/markdown/code/tool_call/file/image）。需注意 无 Webhook 推送，必须通过轮询（cron）或 WebSocket/SSE 实时连接获取消息。
Context 压缩：采用 HQCC（高质量压缩内容）技术，网页内容经 LLM 压缩后缓存，命中缓存免费，未命中约 1 积分/页。
Parse 文档解析：Fast 模式 2 积分/页（清晰文本），Hi-res 模式 5 积分/页（扫描件/手写），支持异步大文件处理。
显著优点
1. 零门槛 Agent 化：匿名注册无需信用卡或 API Key，5 分钟即可将现有脚本转变为可被发现、可对话的 Agent。
2. Agent 原生设计：消息协议内建 tool_call/tool_result 类型，支持 Agent 间工具调用链；discover 机制实现去中心化 Agent 发现。
3. 成本可控：缓存优先策略（cache_first）大幅降低重复抓取成本；IM 发消息仅 0.001 积分，适合高频通知场景。
4. 多语言 SDK：TypeScript 与 Python API 完全对称，团队异构技术栈可无缝接入。
5. 灵活的实时性选择：既支持简单 cron 轮询（1-15 分钟可调），也提供 WebSocket 真实时通道。
潜在缺点与局限性
1. 无原生推送：必须自行搭建轮询逻辑（文档提供 Clawdbot 和 crontab 示例），对不熟悉运维的用户有一定门槛；WebSocket 虽提供真实时但仅 SDK 支持，无 CLI 等价命令。
2. 积分系统依赖：匿名注册仅 100 积分起步，Context 和 Parse 消耗较快，生产环境需绑定付费账户或频繁充值。
3. 生态锁定：Agent 发现、通讯协议均为 Prismer 私有实现，与其他 MCP/Agent 标准（如 Anthropic MCP、OpenAI Assistants）互不兼容，迁移成本高。
4. 文档 OCR 无本地回退：Parse 完全依赖云端，敏感文档存在合规顾虑，且大文件异步处理需自行轮询状态。
5. 消息历史管理简单：仅支持基础的分页查询（-n 50），无搜索、归档、导出等高级功能。
适合人群
- 多 Agent 系统开发者：需要让多个 AI Agent 相互发现、协作、调用工具的研发团队。
- 快速原型验证者：希望不申请 API Key、不绑卡即可测试 Agent 通讯能力的个人开发者。
- Clawdbot 生态用户：已使用 Clawdbot 托管 Agent，可直接复用文档中的 cron 模板。
- 轻量级自动化场景：需要 Agent 定期抓取网页、解析文档并推送结果到 IM 的工作流（如舆情监控、研报摘要）。
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 凭证泄露 | Token 写入本地 toml 文件，若权限设置不当（默认未加密）易被读取 | 设置 `~/.prismer` 目录为 700 权限，容器环境使用 Secret 挂载 |
| 轮询过载 | 高频轮询（每分钟）可能导致 IP 被限流或积分意外消耗 | 合理设置 cron 间隔，生产环境优先使用 WebSocket |
| 依赖服务中断 | Prismer Cloud 为第三方 SaaS，存在不可用风险 | 实现指数退避重试，关键场景准备降级方案 |
| 数据隐私 | 网页内容和文档上传至云端处理，敏感信息可能留存 | 评估数据分级，高敏感场景改用本地 OCR 和爬虫方案 |
| 积分耗尽导致服务中断 | 匿名账户积分有限，耗尽后 IM/Context/Parse 均不可用 | 监控 `prismer im credits`，设置余额告警阈值 |