PARENO并言 · ARCHINTERA
GET STARTED

安装 PARENO

当前版本 0.8.0，面向 Obsidian 桌面版。插件仍在迭代，尚未上架 Obsidian Community Plugins；推荐通过 BRAT 安装和更新。

系统要求

  • Obsidian 桌面版 1.5.0 或更新版本（Windows / macOS / Linux）。
  • 至少一种模型来源：本机 Ollama，或已登录的 Codex CLI，或兼容 Chat Completions 的 API。
  • 只在开发插件时需要 Node.js 20+；普通使用不需要。

通过 BRAT 安装（推荐，可更新）

  1. 在 Obsidian → 设置 → 第三方插件 → 浏览，安装 BRAT（Obsidian42 - BRAT）。
  2. 命令面板运行 BRAT: Add a beta plugin for testing，输入 Jorgut/pareno。
  3. BRAT 会安装最新 GitHub Release；以后在 BRAT 里检查更新，点一下即可升级。

已有手动安装的 PARENO 时，BRAT 会接管同一个 .obsidian/plugins/pareno/ 目录；升级前建议备份旧文件和设置。

手动安装

  1. 打开 GitHub 仓库，选择 Code → Download ZIP 并解压。
  2. 在你的 Obsidian 库里创建文件夹 .obsidian/plugins/pareno/。
  3. 把仓库根目录的 main.js、manifest.json、styles.css 复制进去。
  4. 打开 Obsidian → 设置 → 第三方插件，关闭安全模式并启用 PARENO。
  5. 点击左侧语言图标打开侧栏；在 PARENO 设置里选择模型来源。

升级前请备份旧版插件文件和设置。PARENO 不会删除或迁移旧 Archintera Writing Companion 的文件；两个插件同时启用时可能显示两个侧栏，验证新版后再停用旧插件。

模型选择

方式说明适合
Ollama · 本机 / 云端本机模型连接 http://localhost:11434/v1/chat/completions，内容留在本机；云端模型从 ollama.com 目录选择，使用免费额度时需要 API 密钥，请求发送到 ollama.com。隐私优先，或想用免费云端大模型
本机 Agent · Codex / Claude Code / Cursor Agent / OpenCode自动检测本机已安装的 CLI 并显示版本，使用其已有登录；可在设置里修改每个 CLI 的路径。文本会发送到对应 Agent 的云服务。已有其中某个 Agent 的订阅或登录
云端 · 兼容 API填写 Chat Completions 端点、模型和 API 密钥；费用与订阅分开计算。使用 OpenAI 兼容服务

不会从本地模型静默切换到云端。侧栏会显示当前模型与发送范围；全文审校须单独选择并点击开始。

反馈问题

侧栏底部有「反馈问题」入口，也可以在 反馈说明里查看什么会被发送。反馈只包含你填写的文字和版本、平台、模型方式等环境信息。

开发与构建

npm ci
npm run typecheck
npm test
npm run build

构建产物是仓库根目录的 main.js。界面测试请使用演示库/演示笔记，不要把未审查的建议直接用于已发表文章。