qingj01/agent-zhihu/secondme-reference
Claude Code and agent skill by qingj01/agent-zhihu
Trust tier 3
- community
Source check pending
Checking that the SKILL.md file is still in the repository.
SecondMe API 技术参考文档,供开发时查阅
Install
npx vskill@latest install qingj01/agent-zhihu/secondme-referenceSKILL.md
SecondMe API 技术参考
本文档包含 SecondMe API 的完整技术参考信息,供开发时查阅。
API 基础 URL
OAuth2 授权 URL
OAuth2 流程
Token 有效期
| Token 类型 | 前缀 | 有效期 | |
|---|---|---|---|
| 授权码 | lba_ac_ | 5 分钟 | |
| Access Token | lba_at_ | 2 小时 | |
| Refresh Token | lba_rt_ | 30 天 |
权限列表(Scopes)
| 权限 | 说明 | |
|---|---|---|
user.info | 用户基础信息 | |
user.info.shades | 用户兴趣标签 | |
user.info.softmemory | 用户软记忆 | |
note.add | 添加笔记 | |
chat | 聊天功能 | |
chat | 结构化动作判断(Act) |
API 响应格式与处理
重要:所有 SecondMe API 响应都遵循统一格式:
前端代码必须正确提取数据:
各 API 的数据路径
以下路径均为上游 SecondMe API 路径,完整 URL ={base_url}/api/secondme{path}其中base_url来自state.api.base_url(默认https://app.mindos.com/gate/lab)
| 上游 API 路径 | 数据路径 | 类型 | |
|---|---|---|---|
/api/secondme/user/info | result.data | object(含 email, name, avatarUrl, route 等字段) | |
/api/secondme/user/shades | result.data.shades | array | |
/api/secondme/user/softmemory | result.data.list | array | |
/api/secondme/chat/session/list | result.data.sessions | array | |
/api/secondme/chat/session/messages | result.data.messages | array | |
/api/secondme/act/stream | SSE 流式 JSON(需拼接 delta) | SSE stream | |
/api/secondme/note/add | result.data.noteId | number |
Act API(结构化动作判断)
Act API 是独立于 Chat API 的接口,约束模型仅输出合法 JSON 对象,适用于情感分析、意图分类等结构化决策场景。权限使用 chat scope。
端点(上游 API)
请求参数
| 参数 | 类型 | 必需 | 说明 | |
|---|---|---|---|---|
| message | string | 是 | 用户消息内容 | |
| actionControl | string | 是 | 动作控制说明(20-8000 字符),定义 JSON 结构与判断规则 | |
| appId | string | 否 | 应用 ID | |
| sessionId | string | 否 | 会话 ID,不提供则自动生成 | |
| systemPrompt | string | 否 | 系统提示词,仅新会话首次有效 |
actionControl 示例
响应格式(SSE)
前端处理示例
Chat vs Act 使用场景
| 场景 | 使用 API | 原因 | |
|---|---|---|---|
| 自由对话 | /chat/stream | 返回自然语言文本 | |
| 情感/意图判断 | /act/stream | 返回结构化 JSON | |
| 是/否决策 | /act/stream | 返回 {"result": boolean} | |
| 多分类判断 | /act/stream | 返回 {"category": "..."} | |
| 内容生成 | /chat/stream | 需要长文本输出 |
开发注意事项
State 参数
直接忽略 `state` 参数验证。 在回调处理时不需要验证 state,直接处理授权码即可。
CSS @import 规则顺序
重要: 在 CSS 文件中,@import 语句必须放在文件的最开头(只能在 @charset 和 @layer 之后)。如果在其他 CSS 规则之后使用 @import,会导致解析错误。
官方文档链接
| 文档 | 地址 | |
|---|---|---|
| 快速入门 | https://develop-docs.second.me/zh/docs | |
| 认证概述 | https://develop-docs.second.me/zh/docs/authentication | |
| OAuth2 指南 | https://develop-docs.second.me/zh/docs/authentication/oauth2 | |
| SecondMe API 参考 | https://develop-docs.second.me/zh/docs/api-reference/secondme | |
| OAuth2 API 参考 | https://develop-docs.second.me/zh/docs/api-reference/oauth | |
| 错误码参考 | https://develop-docs.second.me/zh/docs/errors |
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/secondme-reference/SKILL.md
Popularity
- Repository stars
- 87
- Repository forks
- 9
- 7-day trend score
- 0
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/qingj01/agent-zhihu/secondme-reference)