GET STARTED
安装 PARENO
当前版本 0.3.0,面向 Obsidian 桌面版。插件仍在迭代,尚未上架 Obsidian Community Plugins,请从 GitHub 源码安装。
系统要求
- Obsidian 桌面版 1.5.0 或更新版本(Windows / macOS / Linux)。
- 至少一种模型来源:本机 Ollama,或已登录的 Codex CLI,或兼容 Chat Completions 的 API。
- 只在开发插件时需要 Node.js 20+;普通使用不需要。
安装步骤
- 打开 GitHub 仓库,选择 Code → Download ZIP 并解压。
- 在你的 Obsidian 库里创建文件夹
.obsidian/plugins/pareno/。 - 把仓库根目录的
main.js、manifest.json、styles.css复制进去。 - 打开 Obsidian → 设置 → 第三方插件,关闭安全模式并启用 PARENO。
- 点击左侧语言图标打开侧栏;在 PARENO 设置里选择模型来源。
升级前请备份旧版插件文件和设置。PARENO 不会删除或迁移旧 Archintera Writing Companion 的文件;两个插件同时启用时可能显示两个侧栏,验证新版后再停用旧插件。
模型选择
| 方式 | 说明 | 适合 |
|---|---|---|
| 本地 · Ollama | 默认。插件连接 http://localhost:11434/v1/chat/completions,内容留在本机。 | 隐私优先、愿意安装本地模型 |
| 云端 · Codex 登录 | 使用电脑上已登录的 codex CLI;不会读取或复制登录令牌。 | 已有 Codex CLI 工作流 |
| 云端 · 兼容 API | 填写 Chat Completions 端点、模型和 API 密钥;费用与订阅分开计算。 | 使用 OpenAI 兼容服务 |
不会从本地模型静默切换到云端。侧栏会显示当前模型与发送范围;全文审校须单独选择并点击开始。
反馈问题
侧栏底部有「反馈问题」入口,也可以在 反馈说明里查看什么会被发送。反馈只包含你填写的文字和版本、平台、模型方式等环境信息。
开发与构建
npm ci
npm run typecheck
npm test
npm run build构建产物是仓库根目录的 main.js。界面测试请使用演示库/演示笔记,不要把未审查的建议直接用于已发表文章。