📖 拾光 Markspace 使用指南
极简书签管理器 — 收集你的光
快速开始
登录
打开页面后输入账号和密码登录。默认账号 admin，默认密码 admin。建议登录后点击侧边栏头像，选择「账号设置」修改密码。
自定义头像
点击侧边栏头像区域，打开头像选择器。可从 32 个图标（人物、动物、科技、爱好）中选择，并自定义背景颜色。头像会同步保存到服务器。
忘记密码？
前往 Cloudflare Dashboard，打开 D1 数据库（markspace-wk-v2-db）的 Console，执行以下 SQL 即可将账号和密码重置为默认值（账号 admin，密码 admin）：
DELETE FROM settings WHERE key IN ('password_hash','username_hash','username','token_version');
执行后用默认账号密码登录，然后在「账号设置」中修改。
添加第一个书签
- 点击右下角的 + 悬浮按钮，或按快捷键 Alt + N
- 在弹出窗口中输入网址（URL），标题和描述会自动获取
- 选择分类，点击保存
书签管理 Skill
下载 Markspace Skill，配合 Claude Code、OpenClaw 使用，让 AI 直接管理你的书签。
下载 Skill书签管理
添加书签
- 点击 + 按钮或按 Alt + N
- 填写 URL、标题、描述，选择分类
- 可添加标签（Tags）方便检索
编辑 & 删除
右键点击书签卡片打开菜单（移动端点击卡片右上角的 按钮），可进行以下操作：
- 编辑 — 修改书签信息
- 收藏 — 标记为收藏
- 智能填充 — AI 自动获取标题和描述
- 刷新图标 — 重新获取网站图标
- 删除 — 删除该书签
拖拽排序
拖拽书签卡片可以调整书签在分类内的排列顺序（PC 端支持）。
复制链接
点击书签卡片底部的 复制按钮，一键复制书签 URL。
分类管理
创建分类
点击侧边栏分类标题旁的 + 按钮。输入名称，选择图标和颜色。
自定义图标 & 颜色
创建或编辑分类时，可以从 50 个图标中选择，并自定义颜色。右键分类名称可进行编辑和删除。
排序
拖拽分类左侧的图标即可调整顺序（PC 端支持）。
收藏功能
右键点击书签卡片，在菜单中选择「收藏」即可标记该书签。再次右键选择「取消收藏」即可移除。收藏的书签会出现在侧边栏「收藏」分类中，右键「收藏」分类可选择「全部取消收藏」。
搜索
- 按 Ctrl + K 或点击搜索框聚焦
- 实时过滤 — 输入关键词即刻筛选匹配的书签
- 搜索范围：标题、描述、URL、标签
- 输入
#数字可按书签 ID 精确查找 - 匹配关键词会高亮显示
- 搜索框右侧显示匹配数量
批量操作
- 点击顶部工具栏的 按钮进入批量模式
- 点击书签卡片进行多选（选中的卡片会高亮）
- 在底部操作栏选择：批量删除、移动到分类、添加/移除标签
- 完成后再次点击 退出批量模式
导入 / 导出
导出
在设置中点击「导出」，将所有书签和分类数据导出为 JSON 文件（gzip 压缩传输）。
导入
在设置中点击「导入」，选择之前导出的 JSON 文件即可。导入采用自动合并模式 — 保留现有数据，将新数据追加进来，重复的书签会自动跳过。
AI 智能填充
配置 AI Provider
- 进入「设置」→「AI 配置」
- 选择 AI 服务商（支持 DeepSeek、OpenAI、智谱、MiniMax、硅基流动、Gemini、Anthropic、自定义）
- 填入 API Key（密钥使用 AES-256-GCM 加密存储）
- 保存配置
使用方式
添加或编辑书签时，在弹窗底部点击「智能填充」按钮；也可以右键书签卡片选择「智能填充」。AI 将自动获取网页内容，生成标题和描述（自动翻译为中文）。
键盘快捷键
| 快捷键 | 功能 |
|---|---|
| Ctrl + K | 聚焦搜索框 |
| Alt + N | 新建书签 |
| Ctrl + Enter | 保存书签（弹窗内） |
| Esc | 关闭弹窗 / 退出批量模式 |
主题切换
点击右上角的主题切换按钮（ / ）在两种主题之间切换：
- Notion 深色 — 默认主题，深色调
- 浅色 — Notion 风格暖色调
两种主题循环切换，偏好保存在本地。
API Token
在左侧边栏点击「API Token」按钮，创建第三方访问令牌，用于 AI 工具（如 Claude Code、OpenClaw）直接管理书签。
使用方式
在请求头中携带 Token：
Authorization: Bearer msk_your_token_here
支持的操作
- 书签 CRUD（增删改查）
- 分类 CRUD
- 搜索书签
- 批量操作
- 导入 / 导出