TALOS for Obsidian

把 Obsidian Vault 变成可观察、可治理、可执行的个人 AI 工作台。

TALOS 是一个桌面端 Obsidian 原生插件。它把散落在 Vault 里的任务、项目、知识、收件箱、健康记录和发布状态汇总为一个实时控制台，并把多智能体对话、审批治理和「屈原」实时语音放进同一套工作流。

源码许可：个人用户可免费用于非商业目的，包括学习、使用、修改和在同一许可下非商业分享；公司内部使用、客户交付、收费服务、托管、转售、白标及其他商业用途必须事先取得书面授权。本项目属于 Source Available（源码开放），不是 OSI 定义的 Open Source。

界面预览

以下为 v0.4.22 在「超级大脑」Vault 中的真实运行界面。点击图片可查看原始尺寸。

首页 · 身份、灵魂与六器官	数据画像 · 知识图谱
屈原语音 · TALOS Ball	AI 对话 · 多智能体工作台
资料工作台 · 收件与分诊	统一设置 · 界面与主题

产品全景

工作区	你可以做什么
首页	系统体检、今日处理、数据画像三视图：身份/灵魂/记忆/安全等六器官状态、收件队列逐条归位、知识图谱与结构缺口。
工作台	资料、项目与任务、系统与记忆三段式工作台，承载收件分诊、知识库、输出队列、项目场景、任务与待决策、健康、能力与身份入口。
语音助手	屈原语音（Qwen Realtime）、AI 对话（多智能体原生会话）与嵌入式 DeepSeek Harness。
系统总览	查看全库资料分布、活跃热力图、收件积压年龄与系统健康趋势。
统一设置	配置界面与主题、库与数据、对话与模型、语音服务、系统维护与诊断。

核心能力

• 实时 Vault 控制台：基于 Obsidian ItemView 原生渲染；打开即统计，文件变化后事件驱动刷新。
• 首页三视图：系统体检、今日处理、数据画像共用同一份实时数据；六器官状态、收件逐条归位与知识图谱在同一入口切换。
• 行动与治理：将焦点、待办、审批、偏好候选、发布门和健康信号放在同一个决策面板中。
• 多智能体工作台：支持 Claude、Codex、OhMyPi、本机登录态和兼容 Anthropic/OpenAI 协议的 Direct API Provider；提供会话恢复、分叉、压缩、附件、工具调用、diff、MCP、Skills 和子智能体界面。
• DeepSeek Harness：在控制台内打开隔离的 Harness 工作区，保留项目与多会话导航，并由插件管理本地进程和健康状态。
• 屈原 Qwen Realtime 语音：支持语音唤醒、持续监听、实时转写、音频回复、文本只读查询和 TALOS Ball 状态舞台。
• 只读语音工具：语音可查询 Vault 状态、统计和进度；不会暴露写库或命令执行工具。只有明确说出「联网搜索」或「上网查」时，才会发送当前问题进行联网检索。
• 八套视觉主题：Aurora、Nebula、Animal Island、数据流、柔光浮雕、Bauhaus（几何现代主义）、Executive Brief、Paper；可选择只应用于控制台或同步到整个 Vault。
• 安全默认值：API 密钥只写入 Obsidian SecretStorage；审计记录脱敏；缺少可验证 OS 沙箱时，写入型 Execute 会失败关闭。
• 无损升级：迁移按 schema 分步执行；首次启动可补齐缺失的 TALOS 基线人格与注册文件，但不会覆盖已有内容。

平台状态

v0.4.22 使用同一套跨平台代码，但不同系统的安全能力并不伪装成完全一致。

平台	当前状态	AI 执行边界
macOS	主要支持平台	本机 Claude / Codex / OhMyPi 可在可验证的 macOS Seatbelt 沙箱内运行；沙箱不可用时 Execute 失败关闭。
Windows 10/11 x64	自 v0.4.1 起加入部署与兼容支持	推荐使用 SecretStorage 中配置的 Direct API Provider；当前为 Plan-only，不会启动本机 CLI 或执行工具。.cmd / .bat 仅用于安全发现，路径包含 shell 元字符时拒绝启动。
其他桌面系统	非当前交付重点	没有可验证 OS 沙箱时，本机智能体 Execute 失败关闭。

目标硬件

• macOS：Apple M1 Air、8 GB 内存、SSD 或更高配置。
• Windows：4 核 x64 CPU、8 GB 内存、SSD，性能目标对齐 M1 Air 级别设备。
• Obsidian ≥ 1.11.4。

当前自动化回归、构建和跨平台边界测试已通过；M1 Air 与对应 Windows 真机的长会话、语音和大库性能矩阵仍在持续验收。因此以上是支持目标，不是尚未完成真机矩阵前的性能保证。

发布状态说明

本仓库的插件版本发布不改变 TALOS 2.x 的统一产品发布权威。当前统一产品门仍为 formal_release_allowed=false；只有 G1–G7 全部通过并取得单独授权后，才能宣称 TALOS 产品正式放行。PUB-W 属于内容发布工作流，不是产品发布门，也不能替代 G1–G7。

安装

TALOS 对个人非商业用途开放源码，不进入 Obsidian 社区插件商店。请从本仓库 Releases 安装。商业使用须先取得书面授权；完整边界见 LICENSE。v0.4.22 已嵌入 TalosBall 0.3.0。

按系统下载安装包

操作系统	安装包名称
macOS	TALOS-v0.4.22-macOS.zip
Windows 10/11 x64	TALOS-v0.4.22-Windows.zip

两个压缩包使用同一套 v0.4.22 插件载荷，文件名用于帮助用户选择对应系统的安装入口。

1. 从最新 Release 下载与你的操作系统对应的 ZIP。
2. 解压后将其中的 talos 文件夹放到 <你的 Vault>/.obsidian/plugins/。
3. 重启 Obsidian，打开「设置 → 社区插件」，启用 TALOS。
4. 进入「TALOS 设置 → 智能体与模型」，配置本机运行时或把 API 密钥保存到 SecretStorage，并选择 Provider 与模型。

手动安装（macOS / Windows）

把 Release 中的以下文件放入 <你的 Vault>/.obsidian/plugins/talos/：

• main.js
• claude-sdk.cjs（Claude 运行时按需加载）
• manifest.json
• styles.css
• LICENSE
• THIRD-PARTY-NOTICES.md
• THIRD-PARTY-LICENSES.txt
• MaShanZheng-Regular.ttf
• MaShanZheng-OFL.txt
• TALOS-Favicon-64-v1.png

升级前建议备份 Vault。覆盖插件文件时不要删除或替换 data.json、.talos/ 和已有的人格、身份文件。

快速上手

1. 点击 Obsidian 左侧栏的 TALOS 图标，打开统一控制台。
2. 在「首页 → 系统体检」确认身份、灵魂、记忆、安全与系统健康；在「今日处理」逐条归位收件；在「数据画像」查看知识图谱与结构缺口。
3. 在「工作台」按资料、项目与任务、系统与记忆三个入口处理收件、知识、输出、项目、任务、健康、能力与身份。
4. 在「语音助手」打开屈原语音或 AI 对话；Windows 用户优先选择 Direct API 的 Plan 模式。
5. 在「系统总览」检查资料分布、活跃热力图、收件积压与健康趋势。
6. 在「设置」选择主题、映射目录，并决定是否把 TALOS 主题同步到整个 Vault。

安全与隐私

• 云端 API 密钥、Token 和语音长期凭据只保存在 Obsidian SecretStorage，不写入普通插件配置。
• 本机 CLI 使用现有登录态，SecretStorage 值不会进入模型上下文、日志、诊断报告或发布包。
• Direct API 通道只提供文本规划，不暴露本机工具。
• 本机执行必须通过 OS 级沙箱；无法验证隔离时拒绝 Execute。
• 文件写入受 Vault 边界、受保护路径、审批策略和审计记录共同约束。
• 实时语音只注册有限的只读 Vault 工具；联网搜索需要明确口令。

更完整的执行链路见 docs/multi-channel-execution.md，升级与回滚验收见 docs/qa/wp7-upgrade-rollback.md。

开发与验证

npm install
npm test
npm run typecheck
npm run lint
npm run licenses:check
npm run build

生产构建会执行许可证审计、TypeScript 检查、样式合并和 esbuild 打包。任何分发包必须包含安装章节列出的 10 个文件。

源码结构

• src/main.ts：插件生命周期、命令与装配；语音工具、诊断、Provider 等拆在 src/plugin/。
• src/view.ts：控制台 ItemView、经典导航与 Lens 入口；业务页面拆在 src/ui/pages/，图表在 src/ui/charts/，审批与外壳在 src/ui/view-*.ts。
• src/ui/：首页三视图、工作台三段式、设置页、Lens 与通用页面组件。
• src/agent-workbench/：多智能体会话、运行时适配、审批、安全、存储和原生 UI。
• src/harness/：DeepSeek Harness 嵌入、进程管理和健康检查。
• src/quyuan/：人格、Qwen Realtime 语音、只读工具和 TALOS Ball 舞台。
• src/ai/：Provider 门面、Direct API、隐私出库审计与上下文检索。
• src/data/：全库统计、导航、项目与发布状态采集。
• tests/：跨平台、安全、迁移、语音、Provider 和 UI 契约回归。

许可

Copyright © 2026 外脑玩家 Haaper. 源码对个人非商业用途开放；商业使用须事先获得书面授权。

• LICENSE：TALOS 自有材料采用 TALOS Personal Use Source License 1.0。个人非商业使用、学习、修改及按同一许可非商业分享无需付费；任何商业使用必须事先取得书面授权。该许可属于 Source Available，不是 OSI 批准的开源许可证。

• 商业授权联系：微信 wadeonly；邮箱 [email protected]。

• THIRD-PARTY-NOTICES.md：第三方组件、视觉参考和商业条款摘要。

• THIRD-PARTY-LICENSES.txt：由 lockfile 自动生成的生产依赖许可证包。

• MaShanZheng-Regular.ttf / MaShanZheng-OFL.txt：屈原标题字体及 SIL OFL 1.1 许可证。

• TALOS Ball：语音中心视觉使用 TalosBall 0.3.0；Plugin 保留语音状态适配与生命周期集成，几何、32 态和动效遵循固定等价基线；来源与发布门见 TALOS Ball provenance。

完整变更记录见 CHANGELOG.md。