资料保存在本机；通过 SSH、DNS、TLS 和服务商 API 读取实际状态，通过你配置的模型进行有来源的问答。喜欢知屿的话，欢迎 Star 本项目、提交 Issue 或贡献改进。
社区友链 · LINUX DO · 真诚、友善、团结、专业。
最新版本：1.17.3
- Windows 原生终端：SSH 终端改为原生控件，直接嵌在终端页里；多个主机用标签切换，离开页面或关闭到托盘时保留会话并心跳保活。修复中文输入法候选框跑到屏幕左上角、高缩放下终端四角露出方块的问题。
- 终端工具栏：常用命令（点击只插入，按回车才执行）、清屏、字号增减、锁定滚动、复制粘贴和专注模式；光标默认闪烁竖线，可在「设置 → 终端」改为方块或下划线。
具体调整与验证范围见 1.17.3 发布说明。
1.17.2
- Windows 原生在线安装器：新增轻量独立入口，使用知屿自己的安装界面和动画；联网下载完整程序，校验大小与 SHA256 后安装。可以选择目录、桌面快捷方式、安装范围和开机自启；全新安装优先 D 盘，升级沿用原位置。仍提供离线安装包与便携版，应用内更新保持使用离线包。
- 安装偏好与权限：开机自启默认关闭，卸载时移除本程序的自启项；需要提升权限时由 Windows 显示系统授权窗口。当前版本未签名，下载请核对校验文件。
具体调整与验证范围见 1.17.2 发布说明。
1.17.1
- 网页版安全加固：网页版放在公网上，端口扫描或直接输入网址就能找到登录页，这一版把入口守紧：可选的两步验证（TOTP，附 8 个一次性恢复码）、来源限制（
ZHIYU_ALLOWED_NETS，名单外的连接直接断开）、更严的登录限流、登录设备与登录记录（可随时退出可疑设备，新地址登录推送到手机）、一键自动 HTTPS（docker-compose.https.yml + Caddy，知屿不直接暴露端口）。部署清单、威胁模型和做不到的事见 WEB.md 的「安全加固」。
- 修复网页版登录页多显示「设置口令」「再次输入密码」两项的问题。
- 同步设置里新增「看动画」按钮，直接打开配对与同步协议的逐步动画。
具体调整见 1.17.1 发布说明。
1.17.0
- 桌面版与网页版同步：在网页版「设置 → 同步」生成一次性配对码，桌面版填入地址和配对码即可配对；之后自动同步资产与文档，两边都能改，冲突时两份都保留。配对用 PAKE，之后每次同步用设备密钥互相认证并加密，即使网页版没有 HTTPS 也不怕中间人；服务器被还原成旧备份时桌面版会拒绝同步；设备可随时撤销。密钥库同步默认关闭，开启后只传密文。协议与威胁模型见 SYNC.md。
- 端口与 Docker 容器监控：服务器详情新增「端口与容器」，通过 SSH 只读查看监听端口（对外 / 内网 / 仅本机）和容器状态、健康检查、重启次数、CPU 与内存；容器反复重启、异常退出、内存不足时有系统通知和手机推送。
- 服务绑定端口与域名：服务资产可绑定运行在哪台主机的哪个端口 / 容器、对外用哪个域名，状态由最近一次采集自动决定，关系图里自动连上主机与域名。
具体调整见 1.17.0 发布说明。
1.16.2
- 修复桌面版启动报错：1.16.0 与 1.16.1 的安装包漏装了一个依赖，安装后启动即提示找不到
@noble/hashes。直接下载 1.16.2 覆盖安装即可，资料不受影响；网页版不受影响。
具体调整见 1.16.2 发布说明。
1.16.1
- 网页版升级后旧页面自动恢复：换了新镜像后，已经打开的标签页进入某些页面不再报错，会自动刷新一次载入新版本；仍失败时显示「知屿已更新」和刷新按钮。
具体调整见 1.16.1 发布说明。
1.16.0
- 网页版全新布局：顶部悬浮导航条取代左侧栏，首页是宽屏仪表盘——上方是这台服务器的实时状态，下面是资产、待处理、近期续费与每日活动；手机上有整屏菜单和底部快捷栏。桌面版布局不变。
- 主机监控：网页版直接显示部署它的 VPS 的 CPU、内存、磁盘、负载、网络与磁盘读写曲线、进程和容器配额，每 5 秒刷新；
docker-compose.yml 已带上只读挂载 /proc:/host/proc。
- 桌面版功能搬上网页：SSH 终端与 SFTP、主机采集、Cloudflare 直连与 DNS、AI 助手、用量记录、邮箱收发、图床都由服务器完成；SSH 与邮箱密码在浏览器里解密后随请求发送，服务器不保存。
- 网页版个人资料与账号：可以改名字、头像和网页登录密码，二次验证码在浏览器里生成，「关于知屿」可以检查新版本。
具体调整见 1.16.0 发布说明。
1.15.0
- 域名页直连 Cloudflare：粘贴 API Token，自动读取账户下的全部域名，预览到期时间、自动续费和 NS，勾选导入；已导入的域名在表格里一键进入 DNS 管理。
- 按类型显示的列表：服务器看 CPU、内存、磁盘，AI 订阅看额度与续费日，域名看注册商与 NS，证书、邮箱、密钥、服务也各有自己的列；到期列带剩余天数。
- 连接可编辑、可移除：域名页的 Cloudflare 连接卡片支持改名、换 Token、移除；重复连接同一账号会被拦下，同名域名导入时并入已有资产，不再出现两份。
- 更快：表格视图不再计算关系图数据；Cloudflare 的注册信息与其他资源并行读取；进入域名页自动同步一次（10 分钟内不重复）。
具体调整见 1.15.0 发布说明。
1.14.0
- 服务器采集开关：每台服务器卡片上都有「采集」开关。本机连不上（没有代理、只在内网）的主机关掉后不再连接、不再告警，资料照常保留。
- 网页版提醒推送：服务器每小时检查续费与备忘提醒，推送到 Telegram、微信或企业微信，浏览器关着也能收到。
- 网页版 Docker 镜像：
ghcr.io/songwo/zhiyu-web，下载一个 docker-compose.yml 就能部署，支持 amd64 与 arm64。
- 修复：网页版用
http://局域网地址 打开时新建文档报错、自建节点白屏（#4）。
具体调整见 1.14.0 发布说明。
1.13.0
- 备忘提醒与倒计时：自己写事项和日期（宽带、车险、证件、还款……），可按周、月、年重复，大号倒计时显示还剩几天；完成后自动顺延到下一期。到期前多少天提醒可以调整。
- 提醒推送到手机：续费与备忘提醒可以经 Telegram、Server酱 / 微信、企业微信或 WxPusher 推送，只发名称和天数。
- 自托管网页版：
docker compose up -d 部署在自己的服务器上，家里和公司用浏览器打开同一份资料，公司电脑不用安装；整站登录保护，密码类资料在浏览器里加密后才上传。与桌面版备份互通，见 网页版部署说明。
具体调整见 1.13.0 发布说明。
1.12.2
- 全新 2 分钟宣传片：产品主页的宣传片重制为代码动画，每一帧都由代码画出，原创配乐 120 BPM 卡点，小蟹带你从资产总览一路看到 AI 助手、加密备份和便携版。本版没有应用功能变化。
具体调整见 1.12.2 发布说明。
1.12.1
- 新建资产窗口直达自定义类型：「新建资产」里新增醒目的「自定义资产」分区，一键新建类型或用已建类型添加资产；
Ctrl K 也可以搜「自定义」新建类型。
具体调整见 1.12.1 发布说明。
1.12.0
- 自定义资产类型：自己定义类型名称、图标和字段（文本、链接、日期、数字），记录家用 NAS、游戏账号、设备保修等清单之外的东西；仍然支持费用、到期日、续费日历、标签、关联、备份和 AI 助手。
- 按类型筛选：服务资产页新增类型筛选与「管理类型」；删除类型不会删除资产。
具体调整见 1.12.0 发布说明。
1.11.0
- AI 助手的下一步：每个回答下方都有可点的下一步，继续追问或直接打开续费日历、页面与资产；首屏提问按「巡检与处理 / 续费与费用 / 资料整理」分组，数字取自你的资料。
- 从发现问题到改好：AI 发现缺少费用、到期日或运维文档时，直接生成可审阅的资产修改或新文档（可关联资产），确认后才写入；新增续费与费用工具，回答续费顺序与合计金额。
- 续费一键顺延：时间线、续费日历和首页近期续费可「已续费」，到期日按月付或年付顺延一期，可撤销。
- 处处可问 AI：续费页「让 AI 规划」、资产详情「问 AI」、首页待处理「让 AI 逐项分析」。
具体调整见 1.11.0 发布说明。
1.10.0
- 首页快速开始：五步清单按已有资料自动打勾，带新用户依次用上续费日历、文档、关联与标签；「近期续费」列出未来 14 天要处理的事项。
- 常用订阅模板：ChatGPT、Claude、Cursor、Cloudflare、Vercel、iCloud、Netflix、Spotify 等，一键预填金额、周期与下次续费日，个人订阅也能一起管。
- 键盘快捷键与命令面板操作：按
? 查看全部快捷键；Ctrl K 新增「操作」分组，可直接切换主题、打开订阅模板、续费日历和系统设置。
- 使用指南与 2 分钟宣传片：产品主页新增可搜索的使用指南，宣传片按 1.9 新界面重录，完整展示详情页、续费日历、用量与快速上手。
具体调整见 1.10.0 发布说明。
1.9.0
- 全新标志与界面细节：书页成屿的透明新标志；默认窗口更紧凑，标题字号收小；收起的侧栏图标居中，放不下时渐隐提示还有更多。
- 资产详情与系统设置改为页面：点资产卡片在主内容区打开详情，左列资产与指标、右列关联与凭据；头像菜单里的「系统设置」也是页面，右上角的设置弹窗所有分页同一尺寸。
- 续费日历：费用与续费页新增月视图，列出到期日并按月付、年付推算后续续费日，点日期查看当天事项。
- 更有层次的表格与用量：表格视图改为白卡与对称的悬停高亮；用量图表按指标配色、柱子依次长出；来源卡片显示连接状态与失败原因，订阅账号额度取不到时会说明原因而不是一片空白。
具体调整见 1.9.0 发布说明。已有资料沿用原数据目录，可在「设置 → 关于知屿」直接更新。
界面一览
| 资产详情与关联 | 续费日历 |
|---|
| |
| 用量记录 | 文档阅读 |
| |
| 表格视图 | 深色模式 |
| |
| 快速上手与订阅模板 | 密钥库 |
| |
界面截图使用独立演示数据，不含私人账号和资产。宣传片见 产品主页，从安装到每个功能的用法见 使用指南。
安装与首次使用
- 在 GitHub Releases 下载当前正式版
Zhiyu-1.17.1-setup.exe，适用于 Windows x64；不想安装可下载便携版 Zhiyu-1.17.1-portable-x64.zip。
- 运行安装程序，选择安装位置。当前安装包未做代码签名，请核对发布者、下载地址和 Release 中的 SHA256 校验文件。
- 首次启动可选择「使用 Linux.do 登录」绑定主身份，也可直接使用默认工作区名称。创建 10 至 256 位本地主密码并再次确认，头像可稍后设置；Linux.do 登录不代替主密码，也不能找回主密码。
- 已有密钥库的用户确认工作区名称及原主密码即可继续，升级不会自动删除资产或演示记录。
- 添加资产，然后在「设置 → 模型与知识库」配置模型或连接 AI 服务账号。
不想安装？Releases 同时提供 Windows 便携版 Zhiyu-x.y.z-portable-x64.zip：解压即用，资料保存在程序旁的 data 文件夹，详见 使用教程 · 便携版。
安装软件无需 Node.js。正式安装包面向 Windows x64；macOS 的源码构建与未签名 CI 测试程序见 macOS 构建说明，不等同于已签名、公证的正式发行版。Linux 有构建配置，发布验证范围以 Release 记录为准。
网页版（自托管）
不想在公司电脑上安装，又想在家和公司都能用？把知屿部署在自己的服务器上：
mkdir zhiyu && cd zhiyu
curl -fsSLO https://raw.githubusercontent.com/Songwo/zhiyu/main/docker-compose.yml
docker compose up -d
docker compose logs zhiyu # 找「设置口令」，打开 http://服务器:8848 创建账号
镜像为 ghcr.io/songwo/zhiyu-web（amd64 / arm64），升级用 docker compose pull && docker compose up -d。资料存在你的服务器上，整站登录保护；密钥库在浏览器里用主密码解密，服务器只保存密文。续费与备忘提醒可以由服务器推送到手机。网页版有自己的顶部导航与仪表盘首页，「主机监控」显示这台服务器的 CPU、内存、磁盘与网络；SSH 终端、主机采集、Cloudflare、AI 助手和邮箱收发由服务器执行，浏览器插件配对、浏览器密码迁移和 OAuth 网页登录仍只在桌面版。放到公网的防护——自动 HTTPS 的 docker-compose.https.yml、两步验证（TOTP）与恢复码、来源 IP 限制、登录限流、登录设备管理和异常登录推送——见 网页版部署说明 的「安全加固」，反向代理与备份互通也在其中。桌面版还可以与网页版加密同步，见下一节。
桌面版与网页版同步
网页版部署好之后，桌面版可以和它保持一致：两边都能改，合并后一致。
上图每个循环展示一次配对和同步；打开可逐步播放的完整动画，每一步都有「为什么安全」和「旁观者能看到什么」。
- 登录网页版，在「设置 → 同步」点「生成配对码」（5 分钟有效，只能用一次）。
- 在桌面版「设置 → 同步」填入网页版地址和配对码。只需配对一次，之后每 2 分钟和每次修改后自动同步。
- 在桌面版里选择同步资产与关联、文档；密钥库默认不同步，开启后只传 AES-256-GCM 密文，服务器看不到明文。
| 关心的问题 | 怎么处理 |
|---|
| 配对码被偷看或猜测 | 50 位随机、一次性、5 分钟有效；PAKE 使抓包后无法离线穷举；桌面端先证明，错 3 次作废 |
| 网页版没有 HTTPS | 每次同步先用固定的设备密钥与服务器密钥互相认证，再用临时密钥协商 AES-256-GCM，纯 http 下也不怕中间人 |
| 重放、篡改、冒充服务器 | 递增计数器、GCM 认证、固定的服务器公钥分别拒绝 |
| 服务器被还原成旧备份 | 序号倒退，桌面版拒绝同步并提示，确认后才重新对照 |
| 两边同时编辑 | 三方合并；文档冲突另存副本；一边删除一边修改时保留修改 |
| 丢了设备 | 网页版「已配对的设备」里一键撤销，立即生效 |
Cloudflare Token、模型 API Key 等系统加密保存的凭据永远不参与同步。协议是自研的组合（构件均为标准算法和通用库），没有经过第三方审计；设计、威胁模型和已知限制见 SYNC.md。
功能概览
| 功能 | 实际能力 |
|---|
| 主机 | SSH 终端、CPU/内存/磁盘采样、最近 30 天指标历史、SFTP；仅手动或按所选周期采集 |
| 端口与容器 | 通过 SSH 只读查看监听端口和 Docker 容器（状态、健康检查、重启次数、CPU 与内存），容器出问题时系统通知与手机推送 |
| 服务资产 | Cloudflare Workers、个人博客、自建邮箱及其他服务的台账，可绑定主机、端口、容器与域名，状态由采集自动决定 |
| 同步 | 与自己服务器上的网页版加密同步资产与文档（密钥库可选、只传密文），三方合并、设备可撤销，见 SYNC.md |
| 域名与证书 | WHOIS、DNS 查询、TLS 证书检查、到期提示 |
| 主身份 | Linux.do 登录与绑定，展示平台资料，可选昵称／头像同步，保存本人公开帖子；独立于资产密钥库 |
| 网站账号 | 登录网址、用户名、密码与 TOTP 动态验证码，凭据独立加密保存 |
| 浏览器插件 | Chrome / Edge 密码 CSV 迁移、同站账号建议与选择填写、一次确认加密保存、网页文档快照 |
| 邮箱 | 文件夹收纳、IMAP 阅读与搜索、安全 HTML / Markdown 排版、头像、附件、SMTP 写信及加密草稿 |
| 号码台账 | 号码、服务商、到期记录与 AI 订阅绑定；到期状态基于手填日期，不自动连接号码平台 |
| 图文文档 | Markdown 批量导入、全局拖入、源码编辑与 GFM 预览、阅读导航、图片与资产关联、本机账号提取 |
| 节点与用量 | 3x-ui / 机场额度与节点摘要、v2rayN 本机保存及实时统计、组织 API Token 与订阅额度快照，分口径展示 |
| 凭据库 | scrypt 派生密钥、AES-256-GCM 加密，支持分组收纳、锁定和修改主密码 |
| 资产组织 | 标签、搜索、卡片、排序分页表格、真实资产／文档关系图、本机关联建议与确认保存 |
| 提醒 | 托盘、系统通知、ICS 日历导出；可选 Telegram、Server酱、企业微信群或 WxPusher 邮件数量提醒 |
| 模型问答 | OpenAI 兼容接口、流式回答、取消与重试、来源引用、文档／账号元信息／关联修改建议，经确认后写入 |
| 本地知识库 | TXT/Markdown 导入、中文检索、本地 BM25、可选本机 Embedding 混合检索 |
| AI 账号 | OpenAI、Claude、Grok、Gemini 网页授权，自动关联订阅、加密保存令牌，按来源显示分类额度及刷新状态 |
| 界面 | 中英文、跟随系统主题、浅色/深色、主题化下拉菜单、个人头像和资产图片、减少动态效果、Markdown 表格和代码块 |
| 性能与存储 | 检索索引复用、文档列表与用量快照缓存、自动采集结果复用、邮件会话缓存、图片授权延续、「设置 → 存储」管理 |
AI 服务如何连接
模型调用：选择 OpenAI、Grok、Gemini、DeepSeek、通义千问、火山方舟等 API 预设，或者填写自定义 Base URL。输入该服务的 API Key 和准确模型名，保存后读取模型列表并测试连接。支持已有的 https://znck.zle.ee/v1 兼容服务。
订阅账号：进入「AI 订阅 → 添加资产 → 订阅账号」，选择服务商并点击「网页登录授权」。等待授权时直接显示「回调链接或授权码」输入框。OpenAI、Grok、Gemini 通常通过本机回调返回；没有自动返回时，在输入框中提交本次登录产生的完整回调链接。Claude 可以粘贴完整回调链接或网页给出的 code#state。界面分别显示等待回调、验证授权和同步额度；自动回调已处理时无需再粘贴。登录成功后自动关联订阅并查询一次用量，后续在详情中刷新。模型设置中也保留授权入口。密码由你在服务商网页输入，知屿不读取浏览器 Cookie。
这两种连接使用不同凭据。订阅 OAuth 目前用于账号信息和额度查询，不会自动替换问答的 API Key，也不承诺把 ChatGPT、Claude 或 Google One 订阅转换成通用 API 余额。详细范围见 AI 服务账号文档。
| 服务商 | 当前额度来源 |
|---|
| OpenAI / ChatGPT | Codex 主要窗口、次要窗口、代码审查及接口返回的附加额度、积分 |
| Anthropic / Claude | Claude OAuth 返回的共享窗口及模型用量 |
| xAI / Grok | Grok CLI 周额度、产品额度及月度账单 |
| Google / Gemini | Gemini CLI / Code Assist 模型额度及接口返回的积分 |
这些接口不提供各家网页订阅的全部功能权益。详情中可查看额度来源、已用比例、接口提供的数量和重置时间，并打开官网核对权益。字段缺失、查询失败和上次查询结果会分别展示；权限拒绝、登录失效、请求过频等错误不会显示成零用量。
「本机已保存授权」与额度同步结果分别显示。额度查询返回 HTTP 403，表示本次请求遭拒，不能仅凭状态码确定具体原因，也不表示还缺少登录回调。已过期、取消或完成的旧回调链接不能用于新登录；需要重新授权时，应从应用发起新的登录流程。
令牌有效期、额度重置时间和订阅到期时间含义不同，软件不会相互推算。真实账号登录受账户资格、地区、网络与上游接口变化影响；协议测试不等于每个真实账号都已验收。
头像与资产图片
在「设置 → 个人资料」上传或更换头像后点击「保存」。在资产的新增或编辑表单中可上传图片，保存后用于卡片展示；已通过授权添加的 AI 订阅也可在编辑时补充图片。点击移除图标并保存，可恢复默认显示。
绑定 Linux.do 主身份后可选择同步平台昵称或头像，默认保留本机值。同步只改变显示来源，不删除原有自定义资料；实际手动修改某一项会关闭该项同步，保存未改变的值不会关闭同步。
邮箱列表或阅读器中的账号头像可直接打开「邮箱头像与分组」，一次修改图片和归属。阅读邮件时点击发件人头像，可为该地址保存本地图片，每个邮箱最多 32 个；没有图片时显示首字母。应用不会自动向外部头像服务查询邮箱地址。发件人头像及对应地址随邮箱资产保存，不属于加密凭据。
支持本地 PNG、JPEG、WebP，单文件不超过 8 MiB；原图最长边不超过 8192 像素、总像素不超过 2400 万。应用在本机将头像缩至最长边 256 像素、资产图缩至 512 像素，并重编码为 PNG，每张保存的图片不超过 1 MiB。个人头像保存在本机。文档与资产封面可选启用图床，图片将上传到用户配置的服务并保存 HTTPS 地址；图床 Key 由系统安全存储加密保存。未启用图床时仍使用本地图片。
本地 RAG 与 Agent
flowchart LR
A[资产白名单元信息] --> C[本机检索索引]
B[导入的 TXT / Markdown] --> C
Q[用户问题] --> C
C --> D[命中片段与来源]
D --> E[用户配置的远端模型]
E --> F[检索与查询工具]
F --> C
E --> G[流式 Markdown 回答]
E --> H[生成修改建议]
H --> I[用户审阅并确认]
I --> J[校验资料版本后写入本机]
默认执行本机全文检索。开启向量模式后，可连接本机 OpenAI 兼容 Embedding 服务；向量地址仅允许回环地址。Agent 可以检索知识、读取资产元信息、统计资产、定位凭据入口。询问某个账号的密码时，模型只得到资产详情的位置；点击「打开凭据位置」并在本机解锁后查看，模型不会读取加密库中的密码，也不能据位置引用判断密码是否已保存。
可以直接问「我有哪些邮箱分组」「工作邮箱里有哪些账号」。Agent 通过本地分组目录和账号工具查询空组、未分组及账号归属，结果区分别名和演示记录。这里的分组是知屿里的账号收纳文件夹，与邮件服务器上的收件箱、已发送等 IMAP 目录不同；查询分组不需要开启实时邮箱许可。改名或移动账号后，下一次问答会读取更新后的记录。
查询实时邮件数量时，在发送前勾选「本次允许查询邮箱」。该许可只对本次问答生效；邮箱服务在本机从已解锁的密钥库读取凭据，直接连接已保存的 IMAP 服务器，模型只收到收件箱数量、未读数量、新增数量和检查时间，不接触邮件标题或正文。Agent 不执行 SSH 命令、不发送推送。服务器错误、缺少配置或流中断均显示实际错误，不使用规则答案伪装模型响应。
需要修改资料时，勾选「本次生成修改建议」，审阅修改前后内容和依据，再点击「确认应用这项修改」。可以直接要求重命名指定文档，标题修改无需正文许可；正文局部替换需同时允许读取正文，当前支持同一个文本节点内唯一匹配的片段，保留其余格式。缺少所需权限时，回答下方提供本次授权卡，点击后继续原问题，无需重复输入；权限仅本次有效。账号仅支持名称和标签，用户名、网址、密码需在本机账号面板编辑。关联建议可连接两项资产或将文档绑定到资产；建议不会自动执行，资料变化、建议过期或软件重启后需重新生成。错误回答可使用当前模型配置和当前勾选权限重试；鉴权错误仍需填写有效的服务地址、模型与 API Key。
主身份与本人帖子
在首次设置或「设置 → 个人资料 → Linux.do 主身份」点击「使用 Linux.do 登录」，通过系统浏览器完成官方授权，预览资料后确认绑定。普通用户无需填写应用密钥；平台未返回的邮箱、等级显示未提供，不按用户名推测。登录仅用于身份绑定，不上传本机资产，也不解锁资产密钥库。
个人资料里的「我的帖子」可加载本人公开主题与回复，选择后读取全文并保存为新文档，保留来源；缓存复用 15 分钟。论坛权限或网络阻止读取时会逐项显示失败并支持重试，不把摘要当作全文，不读取私信或受限内容。主身份不是密钥库账号资产，新文档不会自动创建指向不存在账号的关联。
退出登录保留身份资料、同步偏好和已保存文档，清除本机登录凭据与帖子缓存；刷新或读帖需要重新登录。旧版从密钥库导入的身份资产继续保留。统一登录服务已验证公网健康检查与登录发起入口；真实账号的授权与资料同步仍待实际用户验证。步骤与边界见 主身份与个人资料。
网站账号与邮件提醒
文档中的明确账号字段和 Markdown 表格可通过「提取账号」在本机识别，逐项编辑、勾选、确认后加密保存并关联来源。提取不会删除原文里的敏感副本。账号详情还可保存网站的 TOTP 密钥，查看倒计时并复制动态验证码。操作与限制见 使用教程。
邮箱页默认显示「工作邮箱」「生活邮箱」「未分组」等文件夹，进入文件夹才展开账号。支持自定义名称、颜色、批量移动邮箱，也可按分组名称搜索；删除文件夹只解除归属，不删除账号或邮件。
点击邮箱可打开邮件工作台，支持 IMAP 文件夹、每页 30 封、主题或发件人搜索、未读筛选、正文查看、显式标记已读及附件下载。写信支持 SMTP TLS / STARTTLS、抄送、密送、回复、文本转发、附件和发送前确认；草稿加密保存在本机主密码库。详细配置及限制见 邮件工作台教程。邮件正文只在用户主动查看时读取，不进入 Agent 或本地 RAG 索引。
0.6.0 增加安全 HTML 排版、纯文本的 Markdown / GFM 展示及「原文」切换，邮件列表和正文加载时显示骨架屏。正文远程图片默认拦截，点击「加载本封图片」后才请求图片服务器；这可能向发件方泄露 IP 地址和阅读时间。0.9.0 起授权按邮件记忆（最多 500 封），重开同一封邮件不再询问，可在「设置 → 存储」清除；邮件正文与附件在本会话内缓存，重复查看不再重复下载，锁库即清。符合限制的 CID 内嵌图片直接在本机展示，不需要外部请求。
在「密钥」中新建资产，类型选择「网站账号 / 密码」，即可保存站点名称、登录地址、用户名和密码。也可以用「智能粘贴」填入网站网址，自动识别站点并移除网址中的嵌入凭据、查询参数和片段。账号信息保存在加密库中，普通名称、提示、标签和说明仍是资产元信息。保存后在详情的「关联资产」选择注册邮箱，下次可以从网站记录直接找到对应邮箱。
邮箱详情中的「检查新邮件」连接已保存的 IMAP TLS 服务器，读取数量和可获得的容量。首次检查只建立基线，未读数量不等于新增数量；不下载标题、正文或附件。旧邮箱记录可在详情补充 IMAP 服务器、TLS 端口及加密账号凭据。
「设置 → 邮件推送」支持 Telegram、Server酱 / 微信、企业微信群机器人和 WxPusher。凭据由用户自行配置，不内置共享 Token。推送默认关闭，开启后只有桌面应用运行、密钥库解锁且出现新增邮件时才发送数量提醒，首次检查不推送历史邮件。通知只包含新增数量、相关邮箱未读数量和检查时间，不包含邮箱地址、标题、正文或密码。个人微信通过 Server酱或 WxPusher 接收，不提供个人微信账号自动登录或直接控制。
在「密钥库 → 浏览器密码」可与 Chrome / Edge 通过官方 CSV 双向迁移。先预览新增、完全重复、冲突和无效记录，再确认加密导入；同站不同账号分别保存，同账号的密码冲突默认跳过，不覆盖已有记录。导出的 CSV 含明文密码，只用于浏览器密码管理器导入，完成后应删除文件。
配套插件通过一次性配对码连接桌面端。登录页自动建议与当前协议、域名、端口匹配的账号，选择后填写可见登录框，由你核对并提交。「登录时自动采集」默认开启：提交登录表单后，点击页面或插件里的保存按钮即可直接加密保存，无需在桌面重复录入；同账号同密码去重，不同密码保留独立版本。密码通过认证的本机连接传输，不放进网址，配对令牌不进入网页；锁库、撤销连接或退出后需重新配对。
插件可分别关闭登录采集、账号建议和文档提示，不读取浏览器原生密码库、Cookie 或历史记录。填写只支持 HTTPS 与本机开发页，不向隐藏字段、注册/改密表单、iframe 或第三方 OAuth 流程填写。支持的文档页会提示保存，点击后只读取已加载的可见文字与来源链接；不下载未加载的原生文档或持续同步线上编辑。旧插件的桌面待确认队列继续兼容。安装、权限与排错见 浏览器助手教程。
列表顶部的「批量整理」支持搜索、多选、添加或移除标签，以及将所选资产关联到同一资产。详情页可搜索并多选关联；关系图开启「连接资产」后可拖动端点连线，已有关系会去重。
数据与隐私
- 本机名称与头像可自行维护，也可选择显示已绑定 Linux.do 的资料。资产元信息、聊天记录、导入文档和指标文件保存在本机，默认没有整体加密。
- 网站与邮箱登录凭据、SSH 凭据、AI 账号 OAuth 令牌、旧版 Linux.do 身份配置与令牌、TOTP 密钥和邮件推送凭据存放在主密码保护的
vault.enc 中。模型 API Key 由操作系统安全存储加密，保护方式与主密码库不同。
- Linux.do 主身份资料、登录服务凭据、同步偏好、缓存头像和帖子使用系统安全存储加密，独立保存为
main-identity.enc，不依赖资产密钥库解锁。共享应用密钥只在登录服务器保存，主身份登录不提供资产云同步或主密码找回。
- 只有你自己配对了自己服务器上的网页版之后，资产与文档才会同步到那台服务器；密钥库默认不同步，开启后只传密文。同步协议、威胁模型和已知限制见 SYNC.md。
- 问题、近期对话及检索命中片段会发送给所选模型服务。导入的文档可能被引用，请勿导入密码或私钥。
- 锁定密钥库会保护凭据读取，但不会隐藏全部资产、聊天记录，也不会自动停用操作系统加密保存的模型 API Key 或退出主身份。
- 文档和模型回答中的 Markdown 不执行原始 HTML、不自动加载远程图片；邮件 HTML 在本机净化后展示静态排版，正文外部图片需逐封主动加载。外链只允许 HTTP/HTTPS。
- JSON 资产导出不包含凭据库。完整备份、迁移和主密码遗失处理见 安全与备份。
开发与验证
需要 Node.js 22.13+、npm，以及可下载依赖的网络环境。本机用量索引使用 Node 内置 SQLite，正式安装包已包含所需运行时。
npm test 会启动真实 Chromium 跑浏览器扩展测试，首次使用前需安装一次（约 200 MB，装入用户目录）：
npx playwright install chromium
# 官方源较慢时可用国内镜像：
PLAYWRIGHT_DOWNLOAD_HOST=https://cdn.npmmirror.com/binaries/playwright npx playwright install chromium
npm ci
npm run desktop
桌面开发命令启动 Vite 与 Electron。只预览网页界面时运行 npm run dev；网页不具备桌面的 SSH、本地文件与密钥库能力。
npm run typecheck
npm run lint
npm run i18n:check
npm test
npm run desktop:build
node scripts/agent-integration.mjs
node scripts/ai-subscription-integration.mjs
node scripts/website-account-integration.mjs
node scripts/mail-client-integration.mjs
# 开发预览运行时，可执行文档交互回归（隔离数据与图床样本）
node scripts/documents-usability-integration.mjs
node scripts/main-identity-ui-integration.mjs
npm run build
集成测试使用隔离数据目录和本机协议测试服务，不读取日常账号。发布构建：
npm run desktop:dist -- --win --x64 --publish never
安装包输出到 release/v版本号/，本版为 release/v1.17.3/。npm run desktop:online 在离线包完成后生成原生在线安装器，npm run extension:build 生成配套浏览器扩展目录。打包排除后端测试文件；日常资产、私钥和登录令牌不属于构建输入。发布流程及验证要求见 发布说明，本版变化见 v1.17.3 发布说明。原生终端需单独编译时运行 npm run terminal:build。
项目结构
| 目录 | 内容 |
|---|
electron/main.mjs、preload.cjs | 桌面窗口、白名单 IPC 与原生能力 |
electron/services/ | SSH、凭据库、RAG、Agent、OAuth 服务与单元测试 |
selfhost/ | 网页版服务器：登录、同步主机、主机监控与桌面能力桥 |
services/identity-login/ | 独立部署的主身份登录服务与配置说明 |
site/ | 产品主页、使用指南与同步协议动画 |
src/components/ | 资产工作台、首次设置、问答、设置等 React 界面 |
src/lib/ | 状态、桥接类型、国际化与界面业务逻辑 |
scripts/ | 构建、验证、截图和开发辅助工具 |
docs/ | 使用教程、产品介绍、AI 接入、安全与发布指南 |
社区与交流
知屿认可并支持 LINUX DO 社区倡导的「真诚、友善、团结、专业」。欢迎佬友交流账号、订阅和服务器的管理经验，也欢迎通过 GitHub Issues 反馈使用问题和改进建议。
社区友链：LINUX DO。社区开源推广的声明与发帖要求见 新推广方式：开源推广；友链表示对社区的认可，不代表官方认证或合作背书。
开源许可
知屿自有源码采用 MIT License，允许在保留版权与许可声明的前提下使用、修改、分发和商用。依赖和随仓库分发的第三方内容保留各自的许可证与版权声明。
已知边界
SSH 指标采集面向提供 /proc 的 Linux 主机。WHOIS 可能因注册局限制无法返回到期日。AI 订阅 OAuth 使用供应商公开客户端及兼容接口，可能因供应商调整失效；账号连接失败会显示错误，不会读取其他应用已有登录数据补救。Gemini 额度查询要求账号已经开通 Code Assist 并能返回项目。服务商订阅结束日期目前没有统一可查询来源，软件不会据令牌有效期推算订阅到期。
问题反馈请提交 GitHub Issue，包含版本、操作步骤与去除敏感信息后的错误。不要提交 API Key、Token、主密码或完整个人数据文件。
Star 趋势
点击图表可查看交互式 Star 增长曲线，数据由 Star History 更新。
