site_name: Agentero 文档
site_description: Agentero 本地优先 Agent 科研工作台文档
repo_url: https://github.com/poco-ai/agentero
repo_name: poco-ai/agentero
edit_uri: edit/main/docs/
theme:
name: material
language: zh
logo: assets/agentero-app-icon.svg
palette:
scheme: default
primary: black
accent: grey
features:
- navigation.instant
- navigation.tabs
- navigation.tabs.sticky
- navigation.tracking
- navigation.top
- search.suggest
- search.highlight
nav:
- 首页: index.md
- 架构总览: architecture.md
- 教程:
- 快速上手: usage/index.md
- 安装与首次使用: usage/getting-started.md
- 导入和管理论文: usage/import-papers.md
- 阅读、标注与整理: usage/read-and-organize.md
- 接入 Agent: usage/agents.md
- 接入 GenericAgent ACP: usage/genericagent-acp.md
- 用 MCP 连接外部 Agent: usage/mcp.md
- 移动端: usage/mobile.md
- 使用 Zotero Connector: usage/zotero.md
- 打开远程 Vault: usage/remote-vault.md
- 前端:
- 概览: frontend/index.md
- 工作台壳: frontend/shell.md
- Dockview 工作区: frontend/workspace.md
- 文件树: frontend/vault-tree.md
- 论文库 Library: frontend/library.md
- 入库 UI: frontend/paper-import.md
- Markdown 编辑: frontend/markdown.md
- PDF 阅读与划词: frontend/pdf.md
- PDF 版面分析（实验）: frontend/pdf-layout-analysis.md
- 网页论文阅读与划词: frontend/web-view.md
- Agent 面板: frontend/agent.md
- 移动端: frontend/mobile.md
- 双链 UI: frontend/wiki.md
- 命令面板: frontend/command-palette.md
- 翻译: frontend/translate.md
- 设置与主题: frontend/settings.md
- 新手引导: frontend/onboarding.md
- 组件约定: frontend/components.md
- 后端:
- 概览: backend/index.md
- 数据模型: backend/data-model.md
- Catalog: backend/catalog.md
- Vault FS: backend/vault.md
- 论文入库: backend/paper-import.md
- Identifier Lookup: backend/identifier-lookup.md
- 学术搜索 API 一览: backend/academic-search-apis.md
- 参考文献解析: backend/citation-parsing.md
- Skill 导入: backend/skill-import.md
- Zotero Connector: backend/connector.md
- MCP Server: backend/mcp.md
- 双链索引: backend/wiki.md
- Agent Host: backend/agent.md
- 远程 Vault: backend/remote.md
- 搜索: backend/search.md
- 设置: backend/settings.md
- 使用记录: backend/usage.md
- 翻译: backend/translate.md
- 运行日志: backend/logging.md
- Vault Doctor: backend/doctor.md
- 遥测: backend/telemetry.md
- 内置模型服务: backend/builtin-provider.md
- 云同步（S3 / WebDAV / Git）: backend/sync.md
- CLI: backend/cli.md
- API 全表: backend/api.md
- 开发草稿:
- 概览: development/index.md
- Word 引用集成: development/zotero-word-integration.md
- 标注 CLI 路线 (#170): development/mark-cli-roadmap.md
- 标注惰性定位: development/mark-locate-lazy.md
- 标注即时定位: development/mark-locate-eager.md
- 广场 Plaza: development/plaza.md
- 广场订阅（Feeds）— MVP: development/plaza-feeds.md
- 使用记录总结 (#239): development/usage-analytics.md
- 生命周期事件系统（Lifecycle Events）: development/lifecycle-events.md
- 云同步设计草稿: development/cloud-sync-s3.md
- A2A 本机与远端协作: development/A2A.md
- 面板 resize 性能调研（同类项目做法）: development/resize-performance-research.md
- Agent DX（CLI / MCP / Skill）: development/agent-dx.md
- Crate 拆分路线图: development/crate-split-roadmap.md
- Import 学术 API 抽象层: development/import-api-abstraction.md
- Rust 端架构重构计划: development/rust-arch-refactor.md
- 知乎开放平台集成: development/zhihu.md
- 测试:
- 概览: test/index.md
- 发布流程: test/release.md
- iOS TestFlight: test/ios-testflight.md
- 发布前 Checklist: test/release-checklist.md
- Bug 修复记录:
- DeepSeek 正文落入 Thinking: bug_fix/deepseek-thinking-body.md
- ACP 会话恢复 ID 错误: bug_fix/acp-session-resume-id.md
- 输入法组字 Enter 误发送: bug_fix/ime-composition-enter-submit.md
- 普通编辑触发全部 Wiki 嵌入闪烁: bug_fix/wiki-embed-unrelated-refresh.md
- 标题双链稳定性: bug_fix/wikilink-heading-reference-stability.md
- 拖动 Dockview 分隔条时 PDF 卡顿: bug_fix/dockview-sash-pdf-resize-jank.md
- Markdown 长文阅读卡顿: bug_fix/markdown-read-jank-offscreen-blocks.md
- 笔记滚动条拖动卡顿（TOC observer 每 scroll 重建）: bug_fix/toc-scroll-observer-rebuild.md
- PDF 切换视觉截图与后台 ONNX: bug_fix/pdf-switch-visual-crop-layout-onnx.md
- 远端 ACP PATH / SSH: bug_fix/remote-acp-path-ssh.md
- 远程 Vault 文件树懒加载: bug_fix/remote-vault-tree-lazy.md
- macOS 签名与公证: bug_fix/macos-signing.md
- Gemini 登录弹窗循环: bug_fix/gemini-login-browser-loop.md
- 导入 NOTES 摘要 MT 超时: bug_fix/import-abstract-mt-timeout.md
- CLI 导入后论文标题不刷新: bug_fix/cli-import-library-refresh.md
- Codex 历史恢复误用 session id: bug_fix/codex-history-runtime-session-id.md
- 导入 PDF 无法生成 PAPER.md: bug_fix/local-pdf-parse-missing-pdfium.md
- 组织目录被识别成单篇论文: bug_fix/paper-folder-marker-conflict.md
- 论文导入超时: bug_fix/paper-import-timeout.md
- 远程 Vault 无法新建文件: bug_fix/remote-create-folder-exists.md
- 远程删除后 list 报 NoSuchFile: bug_fix/remote-delete-list-nosuchfile.md
- 缩放时待办 checkbox 错位: bug_fix/todo-checkbox-scale-align.md
- Agent 引用来源外部链接在应用内弹出空标签页: bug_fix/agent-external-source-blank-window.md
- Cool Papers decode_entities 切中文 panic + 广场每次新建连接: bug_fix/coolpapers-entity-utf8-panic.md
- 版面解析任务一直排队（JobCenter 槽位泄漏）: bug_fix/layout-analyze-job-slot-leak.md
- 期刊 / venue 取不全（#399）: bug_fix/publication-venue-api.md
- 导入第三方 Skill 报「description is too long」（#355）: bug_fix/skill-import-description-length.md
- Windows 启动与问题诊断弹出黑色控制台窗口: bug_fix/windows-console-window-flash.md
- "Windows 安装 Skill 反复弹出 gh.exe 控制台窗口（#741）": bug_fix/windows-skill-import-gh-console-flash.md
- "笔记正文 < 比较符截断后续内容（#533）": bug_fix/note-markdown-stray-less-than.md
- "笔记正文花括号截断后续内容（MDX 表达式）": bug_fix/note-markdown-mdx-brace-truncation.md
- "macOS 首次精读弹出 Music / iCloud / 文件夹权限（#570）": bug_fix/macos-tcc-folder-prompts.md
- "ACP 历史回放被 No response requested 占位": bug_fix/acp-replay-no-response-requested.md
- Agent Composer 首次语音输入被吞: bug_fix/agent-composer-voice-input-first-token.md
- Agent 历史会话恢复加载反馈: bug_fix/agent-history-session-shimmer.md
- "Agent 消息公式 < 被截断（#584）": bug_fix/agent-message-math-less-than.md
- CLI 导入修复残缺论文单元: bug_fix/cli-import-repairs-incomplete-paper.md
- Windows ACP 终端 Hermes MSYS2 挂死: bug_fix/hermes-terminal-pending-msys2-hang.md
- 任务 runner panic 导致并发槽泄漏: bug_fix/job-runner-panic-slot-leak.md
- macOS 主窗口可无限缩小: bug_fix/macos-window-min-size-config-merge.md
- PDF 内部链接跳转后返回原位置: bug_fix/pdf-citation-jump-back.md
- PDF 引用跳转后被拉回第 1 页: bug_fix/pdf-citation-page-restore-race.md
- PDF 重新编译后仍显示旧版本: bug_fix/pdf-disk-refresh-after-compile.md
- PDF 布局翻译取消后覆盖新任务: bug_fix/pdf-layout-translation-cancellation-race.md
- "Windows PDF 翻页随机跳到首尾页（#539）": bug_fix/pdf-windows-scroll-endpoint-jump.md
- "Windows PDF 滚动跳回已保存位置（#427）": bug_fix/pdf-windows-scroll-restore-jump.md
- Pi ACP 未使用 Vault 工作目录: bug_fix/pi-acp-vault-cwd.md
- "Settings 切换语言不立即生效（#437）": bug_fix/settings-locale-no-immediate-switch.md
- 左侧文件树偶发黑屏: bug_fix/vault-sidebar-blank-until-scroll.md
- 左侧栏收起后文件树跳回顶部: bug_fix/vault-sidebar-jump-to-top.md
markdown_extensions:
- admonition
- tables
- toc:
permalink: true
- fenced_code
- codehilite
plugins:
- search
strict: true